@intentic/fileq 1.317.0 → 1.319.0

package/src/testing.ts

@@ -331,3 +331,290 @@ export const gzipBytes = (name: string, content: Uint8Array | string): Uint8Arra
 /** A 1×1 PNG (no EXIF — dimensions are what image derivation reads off it). */
 export const pngBytes = (): Uint8Array =>
     Uint8Array.from(Buffer.from("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==", "base64"));
+
+/* ---- documents to check: small OOXML and PDF files with one known defect each, built from their parts ---------- */
+
+const EMU = 914_400;
+const NS_P = 'xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"';
+const REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+
+export interface FixtureRel {
+    readonly type: string;
+    readonly target: string;
+    readonly external?: boolean;
+}
+
+const relsXml = (rels: Readonly<Record<string, FixtureRel>>): string =>
+    `<?xml version="1.0" encoding="UTF-8"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">${Object.entries(rels)
+        .map(([id, rel]) => `<Relationship Id="${id}" Type="${REL_TYPE}/${rel.type}" Target="${xmlEscape(rel.target)}"${rel.external === true ? ' TargetMode="External"' : ""}/>`)
+        .join("")}</Relationships>`;
+
+/** Where a shape sits, in inches from the slide's top left. */
+export interface Frame {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+
+const xfrm = (frame: Frame, tag = "a:xfrm"): string =>
+    `<${tag}><a:off x="${Math.round(frame.x * EMU)}" y="${Math.round(frame.y * EMU)}"/><a:ext cx="${Math.round(frame.w * EMU)}" cy="${Math.round(frame.h * EMU)}"/></${tag}>`;
+
+export interface TextBoxOptions {
+    /** Point size of every run; unset inherits (18 pt for a plain text box). */
+    readonly size?: number;
+    /** A placeholder of this type (and idx); a placeholder with no frame inherits its layout's. */
+    readonly ph?: { readonly type?: string; readonly idx?: number };
+    readonly autofit?: "shrink" | "grow";
+}
+
+let drawingId = 10;
+
+/** A text shape: one paragraph per line; `frame` undefined leaves the geometry to the layout (placeholders only). */
+export const textBox = (name: string, frame: Frame | undefined, lines: readonly string[], options: TextBoxOptions = {}): string => {
+    drawingId += 1;
+    const ph = options.ph === undefined ? "" : `<p:ph${options.ph.type === undefined ? "" : ` type="${options.ph.type}"`}${options.ph.idx === undefined ? "" : ` idx="${options.ph.idx}"`}/>`;
+    const fit = options.autofit === "shrink" ? "<a:normAutofit/>" : options.autofit === "grow" ? "<a:spAutoFit/>" : "";
+    const size = options.size === undefined ? "" : ` sz="${options.size * 100}"`;
+    const paragraphs = lines.length === 0 ? "<a:p/>" : lines.map((line) => `<a:p><a:r><a:rPr lang="en-US"${size}/><a:t>${xmlEscape(line)}</a:t></a:r></a:p>`).join("");
+    return `<p:sp><p:nvSpPr><p:cNvPr id="${drawingId}" name="${xmlEscape(name)}"/><p:cNvSpPr/><p:nvPr>${ph}</p:nvPr></p:nvSpPr><p:spPr>${frame === undefined ? "" : xfrm(frame)}</p:spPr><p:txBody><a:bodyPr wrap="square">${fit}</a:bodyPr><a:lstStyle/>${paragraphs}</p:txBody></p:sp>`;
+};
+
+/** A picture drawing its image from relationship `rId`, optionally cropped (fractions of 100000 per side). */
+export const pictureFrame = (name: string, frame: Frame, rId: string, crop?: { readonly l?: number; readonly r?: number; readonly t?: number; readonly b?: number }): string => {
+    drawingId += 1;
+    const src = crop === undefined ? "" : `<a:srcRect l="${crop.l ?? 0}" r="${crop.r ?? 0}" t="${crop.t ?? 0}" b="${crop.b ?? 0}"/>`;
+    return `<p:pic><p:nvPicPr><p:cNvPr id="${drawingId}" name="${xmlEscape(name)}"/><p:cNvPicPr/><p:nvPr/></p:nvPicPr><p:blipFill><a:blip r:embed="${rId}"/>${src}<a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr>${xfrm(frame)}<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></p:spPr></p:pic>`;
+};
+
+/** A table frame with one row per entry, each row `height` inches tall and its cells in `size`-point text. */
+export const tableFrame = (name: string, frame: Frame, rows: readonly (readonly string[])[], height: number, size = 18): string => {
+    drawingId += 1;
+    const columns = Math.max(1, ...rows.map((row) => row.length));
+    const columnWidth = Math.round((frame.w * EMU) / columns);
+    const cells = (row: readonly string[]): string =>
+        row.map((cell) => `<a:tc><a:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r><a:rPr lang="en-US" sz="${size * 100}"/><a:t>${xmlEscape(cell)}</a:t></a:r></a:p></a:txBody><a:tcPr/></a:tc>`).join("");
+    return `<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="${drawingId}" name="${xmlEscape(name)}"/><p:cNvGraphicFramePr/><p:nvPr/></p:nvGraphicFramePr>${xfrm(frame, "p:xfrm")}<a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table"><a:tbl><a:tblGrid>${Array.from({ length: columns }, () => `<a:gridCol w="${columnWidth}"/>`).join("")}</a:tblGrid>${rows.map((row) => `<a:tr h="${Math.round(height * EMU)}">${cells(row)}</a:tr>`).join("")}</a:tbl></a:graphicData></a:graphic></p:graphicFrame>`;
+};
+
+export interface DeckSlide {
+    /** The spTree's drawings, as XML (textBox, pictureFrame, tableFrame, or by hand). */
+    readonly drawings: readonly string[];
+    /** Relationships beyond the layout, which every slide gets as rId1. */
+    readonly rels?: Readonly<Record<string, FixtureRel>>;
+    readonly hidden?: boolean;
+    /** The part's file number, when a test needs parts numbered out of deck order. */
+    readonly partNumber?: number;
+}
+
+export interface DeckOptions {
+    readonly slides: readonly DeckSlide[];
+    /** Media parts by name under ppt/media/. */
+    readonly media?: Readonly<Record<string, Uint8Array>>;
+    /** Slide size in inches; 13.333 × 7.5 (16:9) by default. */
+    readonly width?: number;
+    readonly height?: number;
+    /** Leave png out of [Content_Types].xml, the damage a hand-zipped deck carries. */
+    readonly untypedMedia?: boolean;
+}
+
+// A master with a title and a body placeholder and the text styles they inherit (44 pt titles, 28 pt body), and one
+// "Title and Content" layout whose placeholders carry no frame of their own, so a slide's geometry comes from the master.
+const MASTER = `<?xml version="1.0" encoding="UTF-8"?>
+<p:sldMaster ${NS_P}><p:cSld><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr/>
+<p:sp><p:nvSpPr><p:cNvPr id="2" name="Title Placeholder 1"/><p:cNvSpPr/><p:nvPr><p:ph type="title"/></p:nvPr></p:nvSpPr><p:spPr>${xfrm({ x: 0.92, y: 0.4, w: 11.5, h: 1.45 })}</p:spPr><p:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>Click to edit Master title style</a:t></a:r></a:p></p:txBody></p:sp>
+<p:sp><p:nvSpPr><p:cNvPr id="3" name="Text Placeholder 2"/><p:cNvSpPr/><p:nvPr><p:ph type="body" idx="1"/></p:nvPr></p:nvSpPr><p:spPr>${xfrm({ x: 0.92, y: 2, w: 11.5, h: 4.75 })}</p:spPr><p:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>Click to edit Master text styles</a:t></a:r></a:p></p:txBody></p:sp>
+</p:spTree></p:cSld><p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/><p:sldLayoutIdLst><p:sldLayoutId id="2147483649" r:id="rId1"/></p:sldLayoutIdLst>
+<p:txStyles><p:titleStyle><a:lvl1pPr><a:defRPr sz="4400"/></a:lvl1pPr></p:titleStyle><p:bodyStyle><a:lvl1pPr><a:defRPr sz="2800"/></a:lvl1pPr><a:lvl2pPr><a:defRPr sz="2400"/></a:lvl2pPr></p:bodyStyle><p:otherStyle/></p:txStyles></p:sldMaster>`;
+
+const LAYOUT = `<?xml version="1.0" encoding="UTF-8"?>
+<p:sldLayout ${NS_P} type="obj"><p:cSld name="Title and Content"><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr/>
+<p:sp><p:nvSpPr><p:cNvPr id="2" name="Title 1"/><p:cNvSpPr/><p:nvPr><p:ph type="title"/></p:nvPr></p:nvSpPr><p:spPr/><p:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>Click to edit Master title style</a:t></a:r></a:p></p:txBody></p:sp>
+<p:sp><p:nvSpPr><p:cNvPr id="3" name="Content Placeholder 2"/><p:cNvSpPr/><p:nvPr><p:ph idx="1"/></p:nvPr></p:nvSpPr><p:spPr/><p:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>Click to edit Master text styles</a:t></a:r></a:p></p:txBody></p:sp>
+</p:spTree></p:cSld></p:sldLayout>`;
+
+/** A PowerPoint deck with a real slide list, master and layout, one slide part per entry of `slides`. */
+export const deckBytes = (options: DeckOptions): Uint8Array => {
+    const width = Math.round((options.width ?? 13.333) * EMU);
+    const height = Math.round((options.height ?? 7.5) * EMU);
+    const numbers = options.slides.map((slide, index) => slide.partNumber ?? index + 1);
+    const types = [
+        '<Override PartName="/ppt/presentation.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml"/>',
+        '<Override PartName="/ppt/slideMasters/slideMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml"/>',
+        '<Override PartName="/ppt/slideLayouts/slideLayout1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml"/>',
+        ...numbers.map((number) => `<Override PartName="/ppt/slides/slide${number}.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/>`),
+        options.untypedMedia === true ? "" : '<Default Extension="png" ContentType="image/png"/>',
+    ].join("");
+    const files = new Map<string, Uint8Array>([
+        ["[Content_Types].xml", strToU8(CONTENT_TYPES(types))],
+        ["_rels/.rels", strToU8(RELS("ppt/presentation.xml"))],
+        ["ppt/presentation.xml", strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<p:presentation ${NS_P}><p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst><p:sldIdLst>${numbers.map((number, index) => `<p:sldId id="${256 + index}" r:id="rId${number + 1}"/>`).join("")}</p:sldIdLst><p:sldSz cx="${width}" cy="${height}"/><p:notesSz cx="6858000" cy="9144000"/></p:presentation>`,
+        )],
+        ["ppt/_rels/presentation.xml.rels", strToU8(
+            relsXml({
+                rId1: { type: "slideMaster", target: "slideMasters/slideMaster1.xml" },
+                ...Object.fromEntries(numbers.map((number) => [`rId${number + 1}`, { type: "slide", target: `slides/slide${number}.xml` }])),
+            }),
+        )],
+        ["ppt/slideMasters/slideMaster1.xml", strToU8(MASTER)],
+        ["ppt/slideMasters/_rels/slideMaster1.xml.rels", strToU8(relsXml({ rId1: { type: "slideLayout", target: "../slideLayouts/slideLayout1.xml" } }))],
+        ["ppt/slideLayouts/slideLayout1.xml", strToU8(LAYOUT)],
+        ["ppt/slideLayouts/_rels/slideLayout1.xml.rels", strToU8(relsXml({ rId1: { type: "slideMaster", target: "../slideMasters/slideMaster1.xml" } }))],
+    ]);
+    options.slides.forEach((slide, index) => {
+        const number = numbers[index] ?? index + 1;
+        files.set(`ppt/slides/slide${number}.xml`, strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<p:sld ${NS_P}${slide.hidden === true ? ' show="0"' : ""}><p:cSld><p:spTree><p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr/>${slide.drawings.join("")}</p:spTree></p:cSld></p:sld>`,
+            ),
+        );
+        files.set(`ppt/slides/_rels/slide${number}.xml.rels`, strToU8(relsXml({ rId1: { type: "slideLayout", target: "../slideLayouts/slideLayout1.xml" }, ...slide.rels })));
+    });
+    for (const [name, bytes] of Object.entries(options.media ?? {})) {
+        files.set(`ppt/media/${name}`, bytes);
+    }
+    return zipSync(Object.fromEntries(files));
+};
+
+/** A PNG header claiming `width` × `height` pixels: all an aspect-ratio check reads of it. */
+export const pngOfSize = (width: number, height: number): Uint8Array => {
+    const png = pngBytes().slice();
+    const view = new DataView(png.buffer, png.byteOffset, png.byteLength);
+    view.setUint32(16, width);
+    view.setUint32(20, height);
+    return png;
+};
+
+const NS_W = 'xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:pic="http://schemas.openxmlformats.org/drawingml/2006/picture"';
+
+/** A paragraph: plain, or in a style by id. */
+export const para = (text: string, style?: string): string =>
+    `<w:p>${style === undefined ? "" : `<w:pPr><w:pStyle w:val="${style}"/></w:pPr>`}${text === "" ? "" : `<w:r><w:t xml:space="preserve">${xmlEscape(text)}</w:t></w:r>`}</w:p>`;
+
+/** An inline picture `width` inches wide drawing relationship `rId`, in a paragraph of its own. */
+export const inlinePicture = (rId: string, width: number, height: number): string =>
+    `<w:p><w:r><w:drawing><wp:inline><wp:extent cx="${Math.round(width * EMU)}" cy="${Math.round(height * EMU)}"/><wp:docPr id="1" name="Picture 1"/><a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture"><pic:pic><pic:blipFill><a:blip r:embed="${rId}"/></pic:blipFill></pic:pic></a:graphicData></a:graphic></wp:inline></w:drawing></w:r></w:p>`;
+
+/** A complex field: begin, instruction, separate, the saved result (none when undefined), end. */
+export const field = (instruction: string, result: string | undefined): string =>
+    `<w:p><w:r><w:fldChar w:fldCharType="begin"/></w:r><w:r><w:instrText xml:space="preserve"> ${xmlEscape(instruction)} </w:instrText></w:r>${result === undefined ? "" : `<w:r><w:fldChar w:fldCharType="separate"/></w:r><w:r><w:t>${xmlEscape(result)}</w:t></w:r>`}<w:r><w:fldChar w:fldCharType="end"/></w:r></w:p>`;
+
+export interface WordOptions {
+    /** The body's paragraphs and tables, as XML (para, field, inlinePicture, or by hand). */
+    readonly body: readonly string[];
+    readonly rels?: Readonly<Record<string, FixtureRel>>;
+    readonly media?: Readonly<Record<string, Uint8Array>>;
+    /** Comment texts, written as word/comments.xml. */
+    readonly comments?: readonly string[];
+}
+
+// Heading styles under ids that are not their names, the way a localised Word template writes them: the check must
+// read the style's name, not guess from its id.
+const STYLES = `<?xml version="1.0" encoding="UTF-8"?>
+<w:styles xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"><w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/></w:style><w:style w:type="paragraph" w:styleId="berschrift1"><w:name w:val="heading 1"/><w:basedOn w:val="Normal"/></w:style><w:style w:type="paragraph" w:styleId="berschrift2"><w:name w:val="heading 2"/><w:basedOn w:val="Normal"/></w:style><w:style w:type="paragraph" w:styleId="Callout"><w:name w:val="Callout"/><w:basedOn w:val="berschrift2"/></w:style></w:styles>`;
+
+/** A Word document with styles (headings under localised ids), a letter-size section, and optional comments and media. */
+export const wordBytes = (options: WordOptions): Uint8Array => {
+    const commentRels = options.comments === undefined ? {} : { rIdComments: { type: "comments", target: "comments.xml" } };
+    const files = new Map<string, Uint8Array>([
+        ["[Content_Types].xml", strToU8(
+            CONTENT_TYPES(
+                [
+                    '<Default Extension="png" ContentType="image/png"/>',
+                    '<Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>',
+                    '<Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/>',
+                    options.comments === undefined ? "" : '<Override PartName="/word/comments.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml"/>',
+                ].join(""),
+            ),
+        )],
+        ["_rels/.rels", strToU8(RELS("word/document.xml"))],
+        ["word/styles.xml", strToU8(STYLES)],
+        ["word/document.xml", strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<w:document ${NS_W}><w:body>${options.body.join("")}<w:sectPr><w:pgSz w:w="12240" w:h="15840"/><w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" w:gutter="0"/></w:sectPr></w:body></w:document>`,
+        )],
+    ]);
+    if (options.comments !== undefined) {
+        files.set("word/comments.xml", strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<w:comments xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">${options.comments.map((text, index) => `<w:comment w:id="${index}" w:author="Reviewer"><w:p><w:r><w:t>${xmlEscape(text)}</w:t></w:r></w:p></w:comment>`).join("")}</w:comments>`,
+            ),
+        );
+    }
+    files.set("word/_rels/document.xml.rels", strToU8(relsXml({ rIdStyles: { type: "styles", target: "styles.xml" }, ...options.rels, ...commentRels })));
+    for (const [name, bytes] of Object.entries(options.media ?? {})) {
+        files.set(`word/media/${name}`, bytes);
+    }
+    return zipSync(Object.fromEntries(files));
+};
+
+export interface SheetFixture {
+    readonly name: string;
+    /** The sheetData's rows, as XML: `<row r="1"><c r="A1"><v>1</v></c></row>`. */
+    readonly rows: string;
+}
+
+/** An Excel workbook, one worksheet per entry, with optional defined names and calculation settings. */
+export const workbookBytes = (sheets: readonly SheetFixture[], options: { readonly definedNames?: string; readonly calcPr?: string } = {}): Uint8Array => {
+    const files = new Map<string, Uint8Array>([
+        ["[Content_Types].xml", strToU8(
+            CONTENT_TYPES(
+                [
+                    '<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>',
+                    ...sheets.map((_, index) => `<Override PartName="/xl/worksheets/sheet${index + 1}.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>`),
+                ].join(""),
+            ),
+        )],
+        ["_rels/.rels", strToU8(RELS("xl/workbook.xml"))],
+        ["xl/workbook.xml", strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><sheets>${sheets.map((sheet, index) => `<sheet name="${xmlEscape(sheet.name)}" sheetId="${index + 1}" r:id="rId${index + 1}"/>`).join("")}</sheets>${options.definedNames === undefined ? "" : `<definedNames>${options.definedNames}</definedNames>`}${options.calcPr ?? ""}</workbook>`,
+        )],
+        ["xl/_rels/workbook.xml.rels", strToU8(relsXml(Object.fromEntries(sheets.map((_, index) => [`rId${index + 1}`, { type: "worksheet", target: `worksheets/sheet${index + 1}.xml` }]))))],
+    ]);
+    sheets.forEach((sheet, index) => {
+        files.set(`xl/worksheets/sheet${index + 1}.xml`, strToU8(
+            `<?xml version="1.0" encoding="UTF-8"?>
+<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"><sheetData>${sheet.rows}</sheetData></worksheet>`,
+            ),
+        );
+    });
+    return zipSync(Object.fromEntries(files));
+};
+
+export interface PdfPageFixture {
+    /** The page's content stream, e.g. `BT /F1 12 Tf 72 720 Td (Hello) Tj ET`; empty draws nothing. */
+    readonly content: string;
+    /** The BaseFont /F1 names; Helvetica (one of the fourteen every reader has) by default. */
+    readonly font?: string;
+    /** Extra page dictionary entries, e.g. `/Annots [...]`. */
+    readonly extra?: string;
+    /** Width and height in points; US Letter by default. */
+    readonly size?: readonly [number, number];
+}
+
+/** A PDF with one page per entry, honest xref offsets, and no font embedded (a font the reader lacks is substituted). */
+export const pdfPagesBytes = (pages: readonly PdfPageFixture[]): Uint8Array => {
+    const objects: string[] = ["", ""];
+    const add = (body: string): number => objects.push(body);
+    const kids = pages.map((page) => {
+        const font = add(`<< /Type /Font /Subtype /${page.font === undefined ? "Type1" : "TrueType"} /BaseFont /${page.font ?? "Helvetica"} >>`);
+        const content = add(`<< /Length ${page.content.length} >>\nstream\n${page.content}\nendstream`);
+        const [width, height] = page.size ?? [612, 792];
+        return add(`<< /Type /Page /Parent 2 0 R /MediaBox [0 0 ${width} ${height}] /Contents ${content} 0 R /Resources << /Font << /F1 ${font} 0 R >> >> ${page.extra ?? ""} >>`);
+    });
+    objects[0] = "<< /Type /Catalog /Pages 2 0 R >>";
+    objects[1] = `<< /Type /Pages /Kids [${kids.map((kid) => `${kid} 0 R`).join(" ")}] /Count ${kids.length} >>`;
+    let out = "%PDF-1.4\n";
+    const offsets = objects.map((body, index) => {
+        const offset = out.length;
+        out += `${index + 1} 0 obj\n${body}\nendobj\n`;
+        return offset;
+    });
+    const xref = out.length;
+    out += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n${offsets.map((offset) => `${String(offset).padStart(10, "0")} 00000 n `).join("\n")}\ntrailer\n<< /Size ${objects.length + 1} /Root 1 0 R >>\nstartxref\n${xref}\n%%EOF\n`;
+    return strToU8(out);
+};

package/dist/commands/sweep.command.d.ts

@@ -1,3 +0,0 @@
-import { type CommandContext } from "@stricli/core";
-export declare const sweepCommand: import("@stricli/core").Command<CommandContext>;
-//# sourceMappingURL=sweep.command.d.ts.map

package/dist/commands/sweep.command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sweep.command.d.ts","sourceRoot":"","sources":["../../src/commands/sweep.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAUlE,eAAO,MAAM,YAAY,iDAoCvB,CAAC"}

package/dist/commands/sweep.command.js

@@ -1,41 +0,0 @@
-import { buildCommand } from "@stricli/core";
-import { sweep } from "../lib/sweep.js";
-import { workspaceRoot } from "../lib/env.js";
-import { outcomeLine } from "./derive.command.js";
-export const sweepCommand = buildCommand({
-    docs: { brief: "Converge every derivable workspace file's sidecar; prune shadows of deleted files" },
-    parameters: {
-        flags: {
-            json: { kind: "boolean", default: false, brief: "Machine-readable summary on stdout" },
-            quiet: { kind: "boolean", default: false, brief: "Totals only, no per-file lines" },
-        },
-        positional: { kind: "tuple", parameters: [] },
-    },
-    async func(flags) {
-        const root = workspaceRoot();
-        if (root === undefined) {
-            this.process.stdout.write("fileq: sweep needs a workspace (WORKSPACE_ROOT is not set)\n");
-            process.exitCode = 2;
-            return;
-        }
-        const result = await sweep(root, (outcome) => {
-            if (!flags.quiet && !flags.json && outcome.kind !== "fresh") {
-                this.process.stdout.write(`${outcomeLine(outcome)}\n`);
-            }
-        });
-        const counts = { derived: 0, fresh: 0, removed: 0, skipped: 0 };
-        for (const outcome of result.outcomes) {
-            counts[outcome.kind] += 1;
-        }
-        if (flags.json) {
-            this.process.stdout.write(`${JSON.stringify({ ...counts, pruned: result.pruned.length })}\n`);
-        }
-        else {
-            for (const relPath of result.pruned) {
-                this.process.stdout.write(`pruned ${relPath} (source gone)\n`);
-            }
-            this.process.stdout.write(`sweep: ${counts.derived} derived, ${counts.fresh} fresh, ${counts.removed + result.pruned.length} removed, ${counts.skipped} skipped\n`);
-        }
-    },
-});
-//# sourceMappingURL=sweep.command.js.map

package/dist/commands/sweep.command.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sweep.command.js","sourceRoot":"","sources":["../../src/commands/sweep.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOlD,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;IACrC,IAAI,EAAE,EAAE,KAAK,EAAE,mFAAmF,EAAE;IACpG,UAAU,EAAE;QACR,KAAK,EAAE;YACH,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE;YACtF,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gCAAgC,EAAE;SACtF;QACD,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;KAChD;IACD,KAAK,CAAC,IAAI,CAAuB,KAAiB;QAC9C,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAC1F,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE;YACzC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC1D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAChE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAClG,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,kBAAkB,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACrB,UAAU,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,aAAa,MAAM,CAAC,OAAO,YAAY,CAC3I,CAAC;QACN,CAAC;IACL,CAAC;CACJ,CAAC,CAAC"}

package/dist/lib/flags.d.ts

@@ -1,2 +0,0 @@
-export declare const numberParser: (raw: string) => number;
-//# sourceMappingURL=flags.d.ts.map

package/dist/lib/flags.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/lib/flags.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAM1C,CAAC"}

package/dist/lib/flags.js

@@ -1,8 +0,0 @@
-export const numberParser = (raw) => {
-    const value = Number(raw);
-    if (!Number.isFinite(value) || value < 0) {
-        throw new Error(`expected a non-negative number, got "${raw}"`);
-    }
-    return value;
-};
-//# sourceMappingURL=flags.js.map

package/dist/lib/flags.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/lib/flags.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC"}

package/dist/lib/sweep.d.ts

@@ -1,7 +0,0 @@
-import { type Outcome } from "./derive.js";
-export interface SweepResult {
-    readonly outcomes: Outcome[];
-    readonly pruned: string[];
-}
-export declare const sweep: (workspaceRoot: string, onOutcome?: (outcome: Outcome) => void) => Promise<SweepResult>;
-//# sourceMappingURL=sweep.d.ts.map

package/dist/lib/sweep.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sweep.d.ts","sourceRoot":"","sources":["../../src/lib/sweep.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAyC1D,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAE7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,KAAK,kBAAyB,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAAG,OAAO,CAAC,WAAW,CAoB9G,CAAC"}

package/dist/lib/sweep.js

@@ -1,56 +0,0 @@
-import { readdir, stat } from "node:fs/promises";
-import { join } from "node:path";
-import { IGNORED_DIRS, isAgentWorktreePath, REFERENCE_DIR } from "@intentic/workspace-ignore";
-import { STATE_DIR } from "@intentic/constants";
-import { ensureSidecar } from "./derive.js";
-import { isCandidatePath } from "./formats.js";
-import { DERIVED_DIR, removeSidecar } from "./sidecar.js";
-const skipDir = (relPath, name, childRel) => IGNORED_DIRS.has(name) || name === STATE_DIR || (relPath === "" && name === REFERENCE_DIR) || isAgentWorktreePath(childRel);
-const walk = async (root, relPath, found) => {
-    const entries = await readdir(join(root, relPath), { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-        const childRel = relPath === "" ? entry.name : `${relPath}/${entry.name}`;
-        if (entry.isDirectory()) {
-            if (!skipDir(relPath, entry.name, childRel)) {
-                await walk(root, childRel, found);
-            }
-        }
-        else if (entry.isFile() && isCandidatePath(entry.name)) {
-            found.push(childRel);
-        }
-    }
-};
-const walkSidecars = async (root, relPath, found) => {
-    const entries = await readdir(join(root, DERIVED_DIR, relPath), { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-        const childRel = relPath === "" ? entry.name : `${relPath}/${entry.name}`;
-        if (entry.isDirectory()) {
-            await walkSidecars(root, childRel, found);
-        }
-        else if (entry.isFile() && entry.name.endsWith(".md")) {
-            found.push(childRel.slice(0, -3));
-        }
-    }
-};
-export const sweep = async (workspaceRoot, onOutcome) => {
-    const candidates = [];
-    await walk(workspaceRoot, "", candidates);
-    const outcomes = [];
-    for (const relPath of candidates) {
-        const outcome = await ensureSidecar(workspaceRoot, join(workspaceRoot, relPath));
-        outcomes.push(outcome);
-        onOutcome?.(outcome);
-    }
-    const shadowed = [];
-    await walkSidecars(workspaceRoot, "", shadowed);
-    const alive = new Set(candidates);
-    const pruned = [];
-    for (const relPath of shadowed) {
-        if (!alive.has(relPath) && (await stat(join(workspaceRoot, relPath)).catch(() => undefined)) === undefined) {
-            await removeSidecar(workspaceRoot, relPath);
-            pruned.push(relPath);
-        }
-    }
-    return { outcomes, pruned };
-};
-//# sourceMappingURL=sweep.js.map

package/dist/lib/sweep.js.map

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

package/dist/version.d.ts

@@ -1,2 +0,0 @@
-export declare const version: string;
-//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,EAAE,MAA2F,CAAC"}

package/dist/version.js

@@ -1,3 +0,0 @@
-import { createRequire } from "node:module";
-export const version = createRequire(import.meta.url)("../package.json").version;
-//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,CAAC,MAAM,OAAO,GAAY,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC"}

package/src/commands/sweep.command.ts

@@ -1,48 +0,0 @@
-/* `fileq sweep`: the whole workspace converged in one pass — every derivable file shadowed, every orphaned shadow pruned. */
-import { buildCommand, type CommandContext } from "@stricli/core";
-import { sweep } from "../lib/sweep.js";
-import { workspaceRoot } from "../lib/env.js";
-import { outcomeLine } from "./derive.command.js";
-
-interface SweepFlags {
-    readonly json: boolean;
-    readonly quiet: boolean;
-}
-
-export const sweepCommand = buildCommand({
-    docs: { brief: "Converge every derivable workspace file's sidecar; prune shadows of deleted files" },
-    parameters: {
-        flags: {
-            json: { kind: "boolean", default: false, brief: "Machine-readable summary on stdout" },
-            quiet: { kind: "boolean", default: false, brief: "Totals only, no per-file lines" },
-        },
-        positional: { kind: "tuple", parameters: [] },
-    },
-    async func(this: CommandContext, flags: SweepFlags) {
-        const root = workspaceRoot();
-        if (root === undefined) {
-            this.process.stdout.write("fileq: sweep needs a workspace (WORKSPACE_ROOT is not set)\n");
-            process.exitCode = 2;
-            return;
-        }
-        const result = await sweep(root, (outcome) => {
-            if (!flags.quiet && !flags.json && outcome.kind !== "fresh") {
-                this.process.stdout.write(`${outcomeLine(outcome)}\n`);
-            }
-        });
-        const counts = { derived: 0, fresh: 0, removed: 0, skipped: 0 };
-        for (const outcome of result.outcomes) {
-            counts[outcome.kind] += 1;
-        }
-        if (flags.json) {
-            this.process.stdout.write(`${JSON.stringify({ ...counts, pruned: result.pruned.length })}\n`);
-        } else {
-            for (const relPath of result.pruned) {
-                this.process.stdout.write(`pruned ${relPath} (source gone)\n`);
-            }
-            this.process.stdout.write(
-                `sweep: ${counts.derived} derived, ${counts.fresh} fresh, ${counts.removed + result.pruned.length} removed, ${counts.skipped} skipped\n`,
-            );
-        }
-    },
-});

package/src/lib/sweep.ts

@@ -1,72 +0,0 @@
-import { readdir, stat } from "node:fs/promises";
-import { join } from "node:path";
-import { IGNORED_DIRS, isAgentWorktreePath, REFERENCE_DIR } from "@intentic/workspace-ignore";
-import { STATE_DIR } from "@intentic/constants";
-import { ensureSidecar, type Outcome } from "./derive.js";
-import { isCandidatePath } from "./formats.js";
-import { DERIVED_DIR, removeSidecar } from "./sidecar.js";
-
-// Whole-workspace pass: converges every derivable file and removes every orphaned shadow, making the sidecar tree a
-// statement about the workspace as it is now, not as the watcher's incremental view has it.
-// Sequential on purpose, since it shares the box with the agent it's shadowing; parallel parses would cost that
-// argument.
-// Skips what the daemon's watcher skips (machine subtrees, the state dir, the reference shelf), so the two never
-// disagree about what's workspace.
-
-const skipDir = (relPath: string, name: string, childRel: string): boolean =>
-    IGNORED_DIRS.has(name) || name === STATE_DIR || (relPath === "" && name === REFERENCE_DIR) || isAgentWorktreePath(childRel);
-
-const walk = async (root: string, relPath: string, found: string[]): Promise<void> => {
-    const entries = await readdir(join(root, relPath), { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-        const childRel = relPath === "" ? entry.name : `${relPath}/${entry.name}`;
-        if (entry.isDirectory()) {
-            if (!skipDir(relPath, entry.name, childRel)) {
-                await walk(root, childRel, found);
-            }
-        } else if (entry.isFile() && isCandidatePath(entry.name)) {
-            found.push(childRel);
-        }
-    }
-};
-
-// Shadow tree's own walk, for orphan pruning: every `<rel>.md` under derived/ names the source it shadows.
-const walkSidecars = async (root: string, relPath: string, found: string[]): Promise<void> => {
-    const entries = await readdir(join(root, DERIVED_DIR, relPath), { withFileTypes: true }).catch(() => []);
-    for (const entry of entries) {
-        const childRel = relPath === "" ? entry.name : `${relPath}/${entry.name}`;
-        if (entry.isDirectory()) {
-            await walkSidecars(root, childRel, found);
-        } else if (entry.isFile() && entry.name.endsWith(".md")) {
-            found.push(childRel.slice(0, -3));
-        }
-    }
-};
-
-export interface SweepResult {
-    readonly outcomes: Outcome[];
-    /** Sources of shadows whose file vanished since they were derived, removed by this sweep. */
-    readonly pruned: string[];
-}
-
-export const sweep = async (workspaceRoot: string, onOutcome?: (outcome: Outcome) => void): Promise<SweepResult> => {
-    const candidates: string[] = [];
-    await walk(workspaceRoot, "", candidates);
-    const outcomes: Outcome[] = [];
-    for (const relPath of candidates) {
-        const outcome = await ensureSidecar(workspaceRoot, join(workspaceRoot, relPath));
-        outcomes.push(outcome);
-        onOutcome?.(outcome);
-    }
-    const shadowed: string[] = [];
-    await walkSidecars(workspaceRoot, "", shadowed);
-    const alive = new Set(candidates);
-    const pruned: string[] = [];
-    for (const relPath of shadowed) {
-        if (!alive.has(relPath) && (await stat(join(workspaceRoot, relPath)).catch(() => undefined)) === undefined) {
-            await removeSidecar(workspaceRoot, relPath);
-            pruned.push(relPath);
-        }
-    }
-    return { outcomes, pruned };
-};