+
+
${token} generated PDF page content.
`).join(""); + data.sections.profiles.title = "Sidebar"; + data.sections.profiles.items = [ + { + id: "sidebar-profile", + hidden: false, + icon: "github-logo", + iconColor: "", + network: "SIDEBAR TOKEN", + username: "authored-page-one", + website: { url: "", label: "", inlineLink: false }, + }, + ]; + data.sections.experience.title = "Experience"; + data.sections.experience.items = [ + { + id: "manual-continuation", + hidden: false, + company: "MANUAL FULL WIDTH TOKEN", + position: "Independent authored page", + location: "", + period: "", + website: { url: "", label: "", inlineLink: false }, + description: "Second authored page content.
", + roles: [], + }, + ]; + data.metadata.template = "azurill"; + data.metadata.typography.body.fontFamily = "Helvetica"; + data.metadata.typography.heading.fontFamily = "Helvetica"; + data.metadata.layout.pages = [ + { fullWidth: false, main: ["summary"], sidebar: ["profiles"] }, + { fullWidth: true, main: ["experience"], sidebar: [] }, + ]; + + return { data, overflowTokens }; +}; + const readPhysicalPages = async (document: ParsedPdf) => { const pages = []; for (let pageNumber = 1; pageNumber <= document.numPages; pageNumber += 1) { @@ -129,4 +177,36 @@ describe("semantic pagination bindings", () => { expect(pages.every(({ width }) => Math.abs(width - 612) < 0.1)).toBe(true); expect(Math.abs((heading?.transform[3] ?? 0) - 9)).toBeGreaterThan(0.1); }); + + it("keeps Azurill overflow lossless while preserving a manual full-width authored continuation", async () => { + const { data, overflowTokens } = azurillAuthoredOverflowFixture(); + const authoredPagesBeforeRender = structuredClone(data.metadata.layout.pages); + const document = await parsePdf(await renderPdf(data, "azurill")); + const pages = await readPhysicalPages(document); + const renderedText = pages.map(({ text }) => text).join(" "); + const overflowPageIndexes = overflowTokens.map((token) => pages.findIndex(({ text }) => text.includes(token))); + const manualPageIndex = pages.findIndex(({ text }) => text.includes("MANUAL FULL WIDTH TOKEN")); + const firstOverflowToken = overflowTokens[0]; + if (!firstOverflowToken) throw new Error("Expected an overflow fixture token."); + const firstOverflowItem = pages.flatMap(({ items }) => items).find(({ str }) => str.includes(firstOverflowToken)); + const manualContinuationItem = pages[manualPageIndex]?.items.find(({ str }) => str === "MANUAL FULL WIDTH TOKEN"); + + expect(document.numPages).toBeGreaterThan(authoredPagesBeforeRender.length); + for (const token of overflowTokens) { + expect(renderedText.split(token)).toHaveLength(2); + } + expect(renderedText).toContain("SIDEBAR TOKEN"); + expect(renderedText).toContain("MANUAL FULL WIDTH TOKEN"); + expect(overflowPageIndexes).not.toContain(-1); + expect(manualPageIndex).toBeGreaterThan(Math.max(...overflowPageIndexes)); + expect(manualContinuationItem?.transform[4]).toBeLessThan( + firstOverflowItem?.transform[4] ?? Number.NEGATIVE_INFINITY, + ); + expect(data.metadata.layout.pages).toEqual(authoredPagesBeforeRender); + expect(data.metadata.layout.pages[1]).toEqual({ + fullWidth: true, + main: ["experience"], + sidebar: [], + }); + }); }); diff --git a/tests/e2e/specs/authored-page-guidance.spec.ts b/tests/e2e/specs/authored-page-guidance.spec.ts new file mode 100644 index 000000000..0920e093b --- /dev/null +++ b/tests/e2e/specs/authored-page-guidance.spec.ts @@ -0,0 +1,13 @@ +import { createSampleResumeFromDashboard, openSidebarSection } from "../fixtures/resume"; +import { expect, test } from "../fixtures/test"; + +test("explains authored pages and automatic PDF overflow in Layout", async ({ authPage: page }, testInfo) => { + await createSampleResumeFromDashboard(page, testInfo); + await openSidebarSection(page, "Layout"); + + const guidance = page.getByRole("note", { name: "Authored pages and PDF overflow" }); + await expect(guidance).toBeVisible(); + await expect(guidance).toContainText("overflow pages are not saved or editable separately"); + await expect(guidance).toContainText("Move to → New Page"); + await expect(guidance).toContainText("Full Width"); +});