postext 0.3.10 → 0.3.12

package/dist/__tests__/chapterTitles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chapterTitles.test.d.ts.map

package/dist/__tests__/chapterTitles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapterTitles.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/chapterTitles.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/chapterTitles.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect } from 'vitest';
+import { computeChapterTitles } from '../pipeline/placeholders';
+function h1(pageIndex, text) {
+    return {
+        id: `h1-${pageIndex}`,
+        type: 'heading',
+        bbox: { x: 0, y: 0, width: 0, height: 0 },
+        lines: [
+            {
+                text,
+                bbox: { x: 0, y: 0, width: 0, height: 0 },
+                baseline: 0,
+                hyphenated: false,
+            },
+        ],
+        pageIndex,
+        columnIndex: 0,
+        dirty: false,
+        snappedToGrid: false,
+        fontString: '',
+        color: '',
+        textAlign: 'left',
+        headingLevel: 1,
+    };
+}
+describe('computeChapterTitles', () => {
+    it('assigns the most recent H1 title to each page', () => {
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        expect(computeChapterTitles(blocks, 5)).toEqual([
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 2',
+            'Chapter 2',
+        ]);
+    });
+    it('leaves blank parity page before a new chapter with the previous title when `pages` is not provided', () => {
+        // Chapter 2 forced onto an odd page; blank even padding on page 2.
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        // Without pages, legacy behavior: blank page 2 gets Chapter 1.
+        expect(computeChapterTitles(blocks, 4)).toEqual([
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 2',
+        ]);
+    });
+    it('attributes a blank parity page preceding a new chapter to the upcoming title', () => {
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        const pages = [
+            { blankForParity: false },
+            { blankForParity: false },
+            { blankForParity: true }, // padding inserted to push Chapter 2 onto page 3 (odd).
+            { blankForParity: false },
+        ];
+        expect(computeChapterTitles(blocks, 4, pages)).toEqual([
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 2', // <-- now belongs to the upcoming chapter
+            'Chapter 2',
+        ]);
+    });
+    it('walks back over multiple blank parity pages', () => {
+        const blocks = [h1(0, 'Chapter 1'), h1(4, 'Chapter 2')];
+        const pages = [
+            { blankForParity: false },
+            { blankForParity: false },
+            { blankForParity: true },
+            { blankForParity: true },
+            { blankForParity: false },
+        ];
+        const out = computeChapterTitles(blocks, 5, pages);
+        expect(out[2]).toBe('Chapter 2');
+        expect(out[3]).toBe('Chapter 2');
+        expect(out[4]).toBe('Chapter 2');
+    });
+    it('blankForForce pages stay with the previous chapter and stop the walk', () => {
+        // Scenario: chapter 1 ends on page 1 (odd). Chapter 2 uses
+        // `always-odd`, so the placement inserts a mandatory blank separator
+        // on page 2 (blankForForce — belongs to chapter 1), then parity
+        // padding on page 3 (blankForParity — belongs to chapter 2), then
+        // the H1 lands on page 4... but page 4 is even. Let's re-shift:
+        // end on page 0 odd → force blank page 1 (Ch1) → parity blank page 2
+        // (Ch2, because page 2 is even and we want odd) → H1 page 3 odd.
+        // Wait, that's still not quite right — after force blank on page 1
+        // (even), we need to reach odd. Page 2 is odd naturally, so we land
+        // there; page 2 becomes H1 directly. That skips the parity blank.
+        // Let's use a scenario that actually exercises both flags:
+        //   Ch1 H1 on page 0, content ends at page 1.
+        //   Ch2 `always-odd`: force blank at page 2 (Ch1), then page 3 is
+        //   odd so H1 lands at page 3.
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        const pages = [
+            { blankForParity: false, blankForForce: false },
+            { blankForParity: false, blankForForce: false },
+            { blankForParity: false, blankForForce: true }, // mandatory separator — Ch1.
+            { blankForParity: false, blankForForce: false },
+        ];
+        expect(computeChapterTitles(blocks, 4, pages)).toEqual([
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 1', // force-blank stays with Ch1.
+            'Chapter 2',
+        ]);
+    });
+    it('blankForForce followed by blankForParity: force stays with prev, parity goes with next', () => {
+        // Ch2 `always-odd`, previous ends on odd page 0:
+        //   page 1 = blankForForce (Ch1 separator)
+        //   page 2 = blankForParity (Ch2 — page 2 is even, parity needs odd)
+        //   page 3 = H1 Ch2 (odd ✓)
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        const pages = [
+            { blankForParity: false, blankForForce: false },
+            { blankForParity: false, blankForForce: true },
+            { blankForParity: true, blankForForce: false },
+            { blankForParity: false, blankForForce: false },
+        ];
+        expect(computeChapterTitles(blocks, 4, pages)).toEqual([
+            'Chapter 1',
+            'Chapter 1', // force-blank — prev.
+            'Chapter 2', // parity-blank — next.
+            'Chapter 2',
+        ]);
+    });
+    it('does not overwrite non-blank pages that carry the previous chapter', () => {
+        const blocks = [h1(0, 'Chapter 1'), h1(3, 'Chapter 2')];
+        const pages = [
+            { blankForParity: false },
+            { blankForParity: false },
+            { blankForParity: false }, // real content from chapter 1
+            { blankForParity: false },
+        ];
+        expect(computeChapterTitles(blocks, 4, pages)).toEqual([
+            'Chapter 1',
+            'Chapter 1',
+            'Chapter 1', // stays with chapter 1 — it's real content, not padding.
+            'Chapter 2',
+        ]);
+    });
+});
+//# sourceMappingURL=chapterTitles.test.js.map

package/dist/__tests__/chapterTitles.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapterTitles.test.js","sourceRoot":"","sources":["../../src/__tests__/chapterTitles.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/directives.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=directives.test.d.ts.map

package/dist/__tests__/directives.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/directives.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/directives.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown, parseDirectiveAttrs } from '../parse/blockParser';
+describe('parseDirectiveAttrs', () => {
+    it('parses double-quoted values', () => {
+        expect(parseDirectiveAttrs('format="decimal"')).toEqual({ format: 'decimal' });
+    });
+    it('parses single-quoted values', () => {
+        expect(parseDirectiveAttrs("format='lower-roman'")).toEqual({ format: 'lower-roman' });
+    });
+    it('parses bare values', () => {
+        expect(parseDirectiveAttrs('startAt=1')).toEqual({ startAt: '1' });
+    });
+    it('parses multiple attributes', () => {
+        expect(parseDirectiveAttrs('format="decimal" startAt=17')).toEqual({
+            format: 'decimal',
+            startAt: '17',
+        });
+    });
+    it('parses bare flag as empty string', () => {
+        const out = parseDirectiveAttrs('flag');
+        expect(out.flag).toBe('');
+    });
+});
+describe('parseMarkdown directives', () => {
+    it('recognizes :::pagebreak', () => {
+        const blocks = parseMarkdown(':::pagebreak\n');
+        expect(blocks).toHaveLength(1);
+        expect(blocks[0].type).toBe('directive');
+        expect(blocks[0].directiveName).toBe('pagebreak');
+        expect(blocks[0].directiveAttrs).toEqual({});
+    });
+    it('recognizes :::pagebreak{parity="odd"}', () => {
+        const blocks = parseMarkdown(':::pagebreak{parity="odd"}\n');
+        expect(blocks[0].directiveName).toBe('pagebreak');
+        expect(blocks[0].directiveAttrs).toEqual({ parity: 'odd' });
+    });
+    it('recognizes :::numbering{format="decimal" startAt=1}', () => {
+        const blocks = parseMarkdown(':::numbering{format="decimal" startAt=1}\n');
+        expect(blocks[0].directiveName).toBe('numbering');
+        expect(blocks[0].directiveAttrs).toEqual({ format: 'decimal', startAt: '1' });
+    });
+    it('unknown directive name falls through to paragraph', () => {
+        const blocks = parseMarkdown(':::nosuch\n');
+        expect(blocks).toHaveLength(1);
+        expect(blocks[0].type).toBe('paragraph');
+    });
+    it('directive surrounded by content', () => {
+        const md = 'Before\n\n:::pagebreak\n\nAfter\n';
+        const blocks = parseMarkdown(md);
+        expect(blocks.map((b) => b.type)).toEqual(['paragraph', 'directive', 'paragraph']);
+    });
+});
+//# sourceMappingURL=directives.test.js.map

package/dist/__tests__/directives.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.test.js","sourceRoot":"","sources":["../../src/__tests__/directives.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/exports.test.js

@@ -32,6 +32,7 @@ describe("package exports", () => {
             "extractFrontmatter",
             "DEFAULT_PAGE_CONFIG",
             "DEFAULT_CUT_LINES",
+            "DEFAULT_PAGE_NUMBERING",
             "PAGE_SIZE_PRESETS",
             "resolvePageConfig",
             "DEFAULT_LAYOUT_CONFIG",
@@ -78,8 +79,23 @@ describe("package exports", () => {
             "DEFAULT_PDF_GENERATION_CONFIG",
             "resolvePdfGenerationConfig",
             "stripPdfGenerationDefaults",
+            "DEFAULT_HEADER_FOOTER_SLOT",
+            "DEFAULT_HEADER_SLOT",
+            "DEFAULT_FOOTER_SLOT",
+            "DEFAULT_TEXT_ELEMENT",
+            "DEFAULT_RULE_ELEMENT",
+            "resolveHeaderFooterConfig",
+            "stripHeaderFooterDefaults",
+            "resolvePlaceholders",
+            "computeChapterTitles",
+            "collectPlaceholderNames",
+            "isKnownPlaceholder",
+            "isMetadataPlaceholder",
             "parseMarkdownWithIssues",
             "MATH_PLACEHOLDER",
+            "buildPageLabels",
+            "collectPageLabelRuns",
+            "formatNumeral",
             "initMathEngine",
             "isMathReady",
             "onMathReady",

package/dist/__tests__/exports.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.test.js","sourceRoot":"","sources":["../../src/__tests__/exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAEpC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YAC3B,cAAc;YACd,eAAe;YACf,qBAAqB;YACrB,gBAAgB;YAChB,YAAY;YACZ,oBAAoB;YACpB,cAAc;YACd,qBAAqB;YACrB,eAAe;YACf,iBAAiB;YACjB,cAAc;YACd,kBAAkB;YAClB,mBAAmB;YACnB,gBAAgB;YAChB,uBAAuB;YACvB,wBAAwB;YACxB,oBAAoB;YACpB,wBAAwB;YACxB,eAAe;YACf,sBAAsB;YACtB,eAAe;YACf,oBAAoB;YACpB,qBAAqB;YACrB,mBAAmB;YACnB,mBAAmB;YACnB,mBAAmB;YACnB,uBAAuB;YACvB,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;YACrB,0BAA0B;YAC1B,4BAA4B;YAC5B,uBAAuB;YACvB,uBAAuB;YACvB,kBAAkB;YAClB,yBAAyB;YACzB,uBAAuB;YACvB,uBAAuB;YACvB,gCAAgC;YAChC,6BAA6B;YAC7B,6BAA6B;YAC7B,8BAA8B;YAC9B,2BAA2B;YAC3B,2BAA2B;YAC3B,qBAAqB;YACrB,mBAAmB;YACnB,mBAAmB;YACnB,iBAAiB;YACjB,aAAa;YACb,mBAAmB;YACnB,sBAAsB;YACtB,8BAA8B;YAC9B,uBAAuB;YACvB,oBAAoB;YACpB,uBAAuB;YACvB,yBAAyB;YACzB,wBAAwB;YACxB,0BAA0B;YAC1B,uBAAuB;YACvB,mBAAmB;YACnB,qBAAqB;YACrB,sBAAsB;YACtB,oBAAoB;YACpB,oBAAoB;YACpB,4BAA4B;YAC5B,yBAAyB;YACzB,yBAAyB;YACzB,+BAA+B;YAC/B,4BAA4B;YAC5B,4BAA4B;YAC5B,yBAAyB;YACzB,kBAAkB;YAClB,gBAAgB;YAChB,aAAa;YACb,aAAa;YACb,YAAY;YACZ,mBAAmB;YACnB,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"exports.test.js","sourceRoot":"","sources":["../../src/__tests__/exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAEpC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,CAAC,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YAC3B,cAAc;YACd,eAAe;YACf,qBAAqB;YACrB,gBAAgB;YAChB,YAAY;YACZ,oBAAoB;YACpB,cAAc;YACd,qBAAqB;YACrB,eAAe;YACf,iBAAiB;YACjB,cAAc;YACd,kBAAkB;YAClB,mBAAmB;YACnB,gBAAgB;YAChB,uBAAuB;YACvB,wBAAwB;YACxB,oBAAoB;YACpB,wBAAwB;YACxB,eAAe;YACf,sBAAsB;YACtB,eAAe;YACf,oBAAoB;YACpB,qBAAqB;YACrB,mBAAmB;YACnB,wBAAwB;YACxB,mBAAmB;YACnB,mBAAmB;YACnB,uBAAuB;YACvB,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;YACrB,0BAA0B;YAC1B,4BAA4B;YAC5B,uBAAuB;YACvB,uBAAuB;YACvB,kBAAkB;YAClB,yBAAyB;YACzB,uBAAuB;YACvB,uBAAuB;YACvB,gCAAgC;YAChC,6BAA6B;YAC7B,6BAA6B;YAC7B,8BAA8B;YAC9B,2BAA2B;YAC3B,2BAA2B;YAC3B,qBAAqB;YACrB,mBAAmB;YACnB,mBAAmB;YACnB,iBAAiB;YACjB,aAAa;YACb,mBAAmB;YACnB,sBAAsB;YACtB,8BAA8B;YAC9B,uBAAuB;YACvB,oBAAoB;YACpB,uBAAuB;YACvB,yBAAyB;YACzB,wBAAwB;YACxB,0BAA0B;YAC1B,uBAAuB;YACvB,mBAAmB;YACnB,qBAAqB;YACrB,sBAAsB;YACtB,oBAAoB;YACpB,oBAAoB;YACpB,4BAA4B;YAC5B,yBAAyB;YACzB,yBAAyB;YACzB,+BAA+B;YAC/B,4BAA4B;YAC5B,4BAA4B;YAC5B,4BAA4B;YAC5B,qBAAqB;YACrB,qBAAqB;YACrB,sBAAsB;YACtB,sBAAsB;YACtB,2BAA2B;YAC3B,2BAA2B;YAC3B,qBAAqB;YACrB,sBAAsB;YACtB,yBAAyB;YACzB,oBAAoB;YACpB,uBAAuB;YACvB,yBAAyB;YACzB,kBAAkB;YAClB,iBAAiB;YACjB,sBAAsB;YACtB,eAAe;YACf,gBAAgB;YAChB,aAAa;YACb,aAAa;YACb,YAAY;YACZ,mBAAmB;YACnB,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/numbering-page.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=numbering-page.test.d.ts.map

package/dist/__tests__/numbering-page.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-page.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/numbering-page.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/numbering-page.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect } from 'vitest';
+import { buildPageLabels, collectPageLabelRuns } from '../numbering';
+describe('buildPageLabels', () => {
+    it('single decimal segment', () => {
+        const labels = buildPageLabels(3, [
+            { startPageIndex: 0, format: 'decimal', startAt: 1 },
+        ]);
+        expect(labels.map((l) => l.label)).toEqual(['1', '2', '3']);
+        expect(labels.every((l) => l.format === 'decimal')).toBe(true);
+        expect(labels[0].value).toBe(1);
+        expect(labels[2].value).toBe(3);
+    });
+    it('roman front matter then decimal chapters from 1', () => {
+        const labels = buildPageLabels(6, [
+            { startPageIndex: 0, format: 'lower-roman', startAt: 1 },
+            { startPageIndex: 4, format: 'decimal', startAt: 1 },
+        ]);
+        expect(labels.map((l) => l.label)).toEqual(['i', 'ii', 'iii', 'iv', '1', '2']);
+        expect(labels[3].format).toBe('lower-roman');
+        expect(labels[4].format).toBe('decimal');
+    });
+    it('format-only switch continues the counter', () => {
+        const labels = buildPageLabels(4, [
+            { startPageIndex: 0, format: 'decimal', startAt: 1 },
+            { startPageIndex: 2, format: 'upper-roman' },
+        ]);
+        // Counter carries over: 1, 2, then III, IV.
+        expect(labels.map((l) => l.label)).toEqual(['1', '2', 'III', 'IV']);
+    });
+    it('startAt-only switch resets value but keeps format', () => {
+        const labels = buildPageLabels(4, [
+            { startPageIndex: 0, format: 'decimal', startAt: 1 },
+            { startPageIndex: 2, startAt: 17 },
+        ]);
+        expect(labels.map((l) => l.label)).toEqual(['1', '2', '17', '18']);
+    });
+    it('alpha overflow past Z uses bijective labels', () => {
+        const labels = buildPageLabels(28, [
+            { startPageIndex: 0, format: 'upper-alpha', startAt: 1 },
+        ]);
+        expect(labels[0].label).toBe('A');
+        expect(labels[25].label).toBe('Z');
+        expect(labels[26].label).toBe('AA');
+        expect(labels[27].label).toBe('AB');
+    });
+    it('empty document returns empty array', () => {
+        expect(buildPageLabels(0, [])).toEqual([]);
+    });
+    it('falls back to decimal from 1 when no segment given', () => {
+        const labels = buildPageLabels(3, []);
+        expect(labels.map((l) => l.label)).toEqual(['1', '2', '3']);
+    });
+});
+describe('collectPageLabelRuns', () => {
+    it('groups contiguous decimal pages into one run', () => {
+        const labels = buildPageLabels(4, [
+            { startPageIndex: 0, format: 'decimal', startAt: 1 },
+        ]);
+        const runs = collectPageLabelRuns(labels);
+        expect(runs).toHaveLength(1);
+        expect(runs[0].startPageIndex).toBe(0);
+        expect(runs[0].endPageIndex).toBe(3);
+        expect(runs[0].startAt).toBe(1);
+        expect(runs[0].maxValue).toBe(4);
+    });
+    it('splits runs on format change', () => {
+        const labels = buildPageLabels(6, [
+            { startPageIndex: 0, format: 'lower-roman', startAt: 1 },
+            { startPageIndex: 4, format: 'decimal', startAt: 1 },
+        ]);
+        const runs = collectPageLabelRuns(labels);
+        expect(runs).toHaveLength(2);
+        expect(runs[0].format).toBe('lower-roman');
+        expect(runs[0].endPageIndex).toBe(3);
+        expect(runs[1].format).toBe('decimal');
+        expect(runs[1].startAt).toBe(1);
+    });
+    it('splits runs on counter reset', () => {
+        const labels = buildPageLabels(4, [
+            { startPageIndex: 0, format: 'decimal', startAt: 1 },
+            { startPageIndex: 2, startAt: 17 },
+        ]);
+        const runs = collectPageLabelRuns(labels);
+        expect(runs).toHaveLength(2);
+        expect(runs[1].startAt).toBe(17);
+    });
+    it('alpha run past Z tracks maxValue for PDF overflow detection', () => {
+        const labels = buildPageLabels(28, [
+            { startPageIndex: 0, format: 'upper-alpha', startAt: 1 },
+        ]);
+        const runs = collectPageLabelRuns(labels);
+        expect(runs).toHaveLength(1);
+        expect(runs[0].maxValue).toBe(28);
+    });
+});
+//# sourceMappingURL=numbering-page.test.js.map

package/dist/__tests__/numbering-page.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbering-page.test.js","sourceRoot":"","sources":["../../src/__tests__/numbering-page.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/placementParity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=placementParity.test.d.ts.map

package/dist/__tests__/placementParity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placementParity.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/placementParity.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/placementParity.test.js

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { enforcePageParity, createPageWithColumns, } from '../pipeline/placement';
+import { resolveAllConfig } from '../pipeline/config';
+import { createVDTDocument } from '../vdt';
+function makeDoc() {
+    const resolved = resolveAllConfig();
+    const doc = createVDTDocument(resolved, 12);
+    const pageWidthPx = 500;
+    const pageHeightPx = 700;
+    const contentArea = { x: 40, y: 40, width: pageWidthPx - 80, height: pageHeightPx - 80 };
+    const first = createPageWithColumns(0, resolved, contentArea, pageWidthPx, pageHeightPx);
+    doc.pages.push(first);
+    return { doc, resolved, contentArea };
+}
+describe('enforcePageParity — document start exception', () => {
+    it('skips parity enforcement when the first page is still empty', () => {
+        const { doc, resolved, contentArea } = makeDoc();
+        const cursor = { pageIndex: 0, columnIndex: 0 };
+        // Even though page 1 is odd, the user asked for "always-odd" — which
+        // normally would insert a mandatory blank separator. At document
+        // start we skip the whole thing.
+        enforcePageParity(doc, cursor, resolved, contentArea, 500, 700, 'always-odd');
+        expect(doc.pages).toHaveLength(1);
+        expect(doc.pages[0].blankForForce).toBeFalsy();
+        expect(doc.pages[0].blankForParity).toBeFalsy();
+        expect(cursor.pageIndex).toBe(0);
+    });
+    it('skips `even` parity padding when document is still empty on page 0', () => {
+        const { doc, resolved, contentArea } = makeDoc();
+        const cursor = { pageIndex: 0, columnIndex: 0 };
+        // Page 0 is odd. Without the guard, `even` parity would insert a blank.
+        enforcePageParity(doc, cursor, resolved, contentArea, 500, 700, 'even');
+        expect(doc.pages).toHaveLength(1);
+        expect(doc.pages[0].blankForParity).toBeFalsy();
+    });
+    it('enforces parity normally once the first page has content', () => {
+        const { doc, resolved, contentArea } = makeDoc();
+        // Simulate a block already placed on page 0.
+        doc.pages[0].columns[0].blocks.push({
+            id: 'dummy',
+            type: 'paragraph',
+            bbox: { x: 0, y: 0, width: 0, height: 0 },
+            lines: [],
+            pageIndex: 0,
+            columnIndex: 0,
+            dirty: false,
+            snappedToGrid: false,
+            fontString: '',
+            color: '',
+            textAlign: 'left',
+        });
+        const cursor = { pageIndex: 0, columnIndex: 0 };
+        // Page 1 is odd, so `even` parity must pad with a blank → advance to page 2.
+        enforcePageParity(doc, cursor, resolved, contentArea, 500, 700, 'even');
+        expect(doc.pages).toHaveLength(2);
+        expect(doc.pages[0].blankForParity).toBe(true);
+        expect(cursor.pageIndex).toBe(1);
+    });
+});
+//# sourceMappingURL=placementParity.test.js.map

package/dist/__tests__/placementParity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placementParity.test.js","sourceRoot":"","sources":["../../src/__tests__/placementParity.test.ts"],"names":[],"mappings":"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"}

package/dist/canvas-backend/headerFooter.d.ts

@@ -0,0 +1,3 @@
+import type { VDTHeaderFooterSlot } from '../vdt';
+export declare function renderHeaderFooterSlot(ctx: CanvasRenderingContext2D, slot: VDTHeaderFooterSlot): void;
+//# sourceMappingURL=headerFooter.d.ts.map

package/dist/canvas-backend/headerFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerFooter.d.ts","sourceRoot":"","sources":["../../src/canvas-backend/headerFooter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAA0C,MAAM,QAAQ,CAAC;AAqB1F,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,mBAAmB,GACxB,IAAI,CAKN"}

package/dist/canvas-backend/headerFooter.js

@@ -0,0 +1,23 @@
+function renderTextBlock(ctx, block) {
+    ctx.save();
+    ctx.fillStyle = block.color;
+    ctx.font = block.fontString;
+    ctx.textBaseline = 'alphabetic';
+    ctx.fillText(block.text, block.bbox.x, block.baseline);
+    ctx.restore();
+}
+function renderRuleBlock(ctx, block) {
+    ctx.save();
+    ctx.fillStyle = block.color;
+    ctx.fillRect(block.bbox.x, block.bbox.y, block.bbox.width, block.thicknessPx);
+    ctx.restore();
+}
+export function renderHeaderFooterSlot(ctx, slot) {
+    for (const block of slot.blocks) {
+        if (block.kind === 'text')
+            renderTextBlock(ctx, block);
+        else
+            renderRuleBlock(ctx, block);
+    }
+}
+//# sourceMappingURL=headerFooter.js.map

package/dist/canvas-backend/headerFooter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerFooter.js","sourceRoot":"","sources":["../../src/canvas-backend/headerFooter.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe,CACtB,GAA6B,EAC7B,KAA+B;IAE/B,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5B,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;IAC5B,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;IAChC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,GAAG,CAAC,OAAO,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,GAA6B,EAAE,KAAmB;IACzE,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9E,GAAG,CAAC,OAAO,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,GAA6B,EAC7B,IAAyB;IAEzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;;YAClD,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/canvas-backend/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas-backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAkFN;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAI7E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAEpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/canvas-backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAMnD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAqFN;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,iBAAiB,CAI7E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAEpE"}

package/dist/canvas-backend/index.js

@@ -1,6 +1,7 @@
 import { dimensionToPx } from '../units';
 import { renderBaselineGrid, renderColumnRule, renderCutLines, computeContentArea } from './decorations';
 import { renderBlock } from './blockRender';
+import { renderHeaderFooterSlot } from './headerFooter';
 export function renderPageToCanvas(page, doc, canvas, options) {
     canvas.width = Math.round(page.width);
     canvas.height = Math.round(page.height);
@@ -50,6 +51,10 @@ export function renderPageToCanvas(page, doc, canvas, options) {
         }
         ctx.restore();
     }
+    if (page.header)
+        renderHeaderFooterSlot(ctx, page.header);
+    if (page.footer)
+        renderHeaderFooterSlot(ctx, page.footer);
     if (options?.pageNegative) {
         ctx.filter = 'none';
     }

package/dist/canvas-backend/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canvas-backend/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/canvas-backend/index.ts"],"names":[],"mappings":"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"}

package/dist/defaults/headerFooter.d.ts

@@ -0,0 +1,22 @@
+import type { HeaderFooterSlot, ResolvedHeaderFooterSlot, ResolvedHeaderFooterTextElement, ResolvedHeaderFooterRuleElement } from '../types';
+export type HeaderFooterSlotKind = 'header' | 'footer';
+export declare const DEFAULT_HEADER_FOOTER_SLOT: ResolvedHeaderFooterSlot;
+export declare const DEFAULT_TEXT_ELEMENT: ResolvedHeaderFooterTextElement;
+export declare const DEFAULT_RULE_ELEMENT: ResolvedHeaderFooterRuleElement;
+/** Built-in default header: book title (right, odd) + chapter title (left,
+ *  even) + full-width rule. Applied when `config.header` is `undefined`. */
+export declare const DEFAULT_HEADER_SLOT: ResolvedHeaderFooterSlot;
+/** Built-in default footer: centered page number on every page. Applied when
+ *  `config.footer` is `undefined`. */
+export declare const DEFAULT_FOOTER_SLOT: ResolvedHeaderFooterSlot;
+/** Resolve a header/footer slot. When `slot` is `undefined`, returns the
+ *  built-in default for `kind`. An explicit empty slot (`{ elements: [] }`)
+ *  stays empty — the user opted out of the default. */
+export declare function resolveHeaderFooterConfig(slot: HeaderFooterSlot | undefined, kind?: HeaderFooterSlotKind): ResolvedHeaderFooterSlot;
+/** Strip defaults from a header/footer slot. Returns `undefined` when the
+ *  slot matches the built-in default for `kind` (so persisted configs omit
+ *  it); otherwise returns the slot with per-element field defaults stripped.
+ *  An explicit empty slot is preserved — the user opted out and we must not
+ *  conflate that with "use the default". */
+export declare function stripHeaderFooterDefaults(slot: HeaderFooterSlot | undefined, kind?: HeaderFooterSlotKind): HeaderFooterSlot | undefined;
+//# sourceMappingURL=headerFooter.d.ts.map

package/dist/defaults/headerFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerFooter.d.ts","sourceRoot":"","sources":["../../src/defaults/headerFooter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EAKxB,+BAA+B,EAC/B,+BAA+B,EAGhC,MAAM,UAAU,CAAC;AAGlB,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AASvD,eAAO,MAAM,0BAA0B,EAAE,wBAExC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,+BAYlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,+BASlC,CAAC;AAEF;4EAC4E;AAC5E,eAAO,MAAM,mBAAmB,EAAE,wBAuCjC,CAAC;AAEF;sCACsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,wBAgBjC,CAAC;AA+DF;;uDAEuD;AACvD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,wBAAwB,CAK1B;AA0FD;;;;4CAI4C;AAC5C,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,IAAI,GAAE,oBAA+B,GACpC,gBAAgB,GAAG,SAAS,CAO9B"}