@embedpdf/engine-core 3.0.0-next.15 → 3.0.0-next.16

package/dist/conformance.d.cts

@@ -1,5 +1,5 @@
-import { E_ as Identity, Ep as CharMapAnchor, Jg as PdfRect, Nd as AnnotationResources, Ng as PageBox, Pg as PagePoint, Wm as PageTabOrder, Yg as PdfRotation, _t as LineDraft, _v as DocumentMetadata, bs as AnnotationDraft, dn as HighlightDraft, nt as InkDraft, t as AnnotationList } from "./AnnotationList-CkijRHet.cjs";
-import { _ as Engine, t as LocalEngine, y as DocumentHandle } from "./LocalEngine-DFoBm4B3.cjs";
+import { F_ as PdfRect, Fs as AnnotationDraft, I_ as PdfRotation, Vd as AnnotationResources, _t as LineDraft, b_ as PageBox, dn as HighlightDraft, gh as PageTabOrder, iy as DocumentMetadata, nt as InkDraft, pv as Identity, t as AnnotationList, x_ as PagePoint, zp as CharMapAnchor } from "./AnnotationList-DcyhF2kU.cjs";
+import { _ as Engine, t as LocalEngine, y as DocumentHandle } from "./LocalEngine-IA9zh3Jh.cjs";
 //#region src/conformance/runMetadataConformance.d.ts
 interface ConformanceTestRunner {
   describe(name: string, fn: () => void): void;
@@ -564,6 +564,59 @@ interface PageRenderConformanceOptions {
  */
 declare function runPageRenderConformance(runner: ConformanceTestRunner, opts: PageRenderConformanceOptions): void;
 //#endregion
+//#region src/conformance/runPrintRenderConformance.d.ts
+/**
+ * A 200 × 200 page with one black 40 × 40 square for each print rule, and an
+ * A0 page (2384 × 3370) with nothing on it:
+ *
+ * - a layer that only prints, and one only shown on screen (`/Usage`
+ *   `/PrintState` and `/ViewState`, as Acrobat's watermarks write them);
+ * - four squares: one that only prints (`noView` + `print`), one only on
+ *   screen (no `print`), one on both (`print`), one on neither (`hidden`);
+ * - two form fields: a push button only on screen (Acrobat's "Visible but
+ *   doesn't print") and a text field that only prints ("Hidden but
+ *   printable").
+ */
+declare const PRINT_RULES_PDF: Uint8Array<ArrayBufferLike>;
+/** The rights each case opens with: everything, no print, print but not high. */
+declare const PRINT_SCOPES: {
+  readonly everything: readonly ["*"];
+  readonly screen: readonly ["doc.open", "doc.render", "doc.annotate.read", "doc.forms.read"];
+  readonly print: readonly ["doc.open", "doc.render", "doc.annotate.read", "doc.forms.read", "doc.print"];
+};
+interface PrintRenderConformanceOptions {
+  label: string;
+  /** Build a fresh engine for this suite. The suite tears it down at the end. */
+  makeEngine: () => Promise<Engine> | Engine;
+  /** Open a fresh copy of {@link PRINT_RULES_PDF} with `scope`. */
+  open: (engine: Engine, scope: readonly string[]) => Promise<DocumentHandle>;
+}
+/**
+ * Print pictures on both engines (`usage: 'print'` with a `dpi` viewport).
+ * A print picture follows
+ * the print rules where a screen picture follows the screen's: layers by
+ * their print state, annotations and form fields by their `print` flag,
+ * `noView` ones included, `hidden` ones never. It is the whole page at its
+ * DPI, never more pixels than the page fitted to A4 or Letter needs, and its
+ * transform is `pageTransform`'s. It needs `doc.print`, and 300 DPI
+ * `doc.print.high`; options that don't fit a print picture are refused.
+ */
+declare function runPrintRenderConformance(runner: ConformanceTestRunner, opts: PrintRenderConformanceOptions): void;
+/**
+ * The print copy on both engines: `pages.extract(pages, { flatten })` makes
+ * the pages as they draw for `flatten.usage`, so a print copy, printed, shows
+ * what a print picture of the page shows (layers by their print state,
+ * annotations and fields by their `print` flag), with nothing interactive
+ * left. `includeAnnotations` and `includeFormFields` choose what it paints,
+ * with a page picture's defaults; they take `flatten`. A flattened copy needs
+ * `doc.download` or `doc.download.flattened`, a plain one `doc.download`.
+ */
+interface PrintCopyConformanceOptions extends PrintRenderConformanceOptions {
+  /** Open `bytes`, a copy the engine made, with every right. */
+  openCopy: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+}
+declare function runPrintCopyConformance(runner: ConformanceTestRunner, opts: PrintCopyConformanceOptions): void;
+//#endregion
 //#region src/conformance/pageSpaceFixtures.d.ts
 /**
  * Small PDFs whose page boxes are odd in every way ISO 32000 allows, and in
@@ -859,17 +912,17 @@ declare function runPageExtractConformance(runner: ConformanceTestRunner, opts:
  * Attachment conformance suite. Fixture requirement: a document whose
  * `/EmbeddedFiles` name tree contains at least one embedded file.
  *
- * Both attachment surfaces are optional on the contract (the
- * `downloadLayer?` pattern), probed independently and skipped cleanly:
- *   - `doc.attachments?` — document-level EmbeddedFiles (list/download)
- *   - `page.annotations.downloadResource(ref, 'file')` — annotation-level file bytes
+ * Both homes of a file: `doc.attachments` (the `/EmbeddedFiles` name tree)
+ * and a file-attachment annotation's `file` resource
+ * (`page.annotations.downloadResource(ref, 'file')`). Both downloads answer
+ * the bytes; the name and type are what the listing says.
  *
  * Invariants:
  *   1. `list()` reflects the name tree: positional indices, non-empty
  *      names, and repeated calls agree (a read).
- *   2. `download(index)` round-trips the listed metadata and returns
- *      exactly `size` decoded bytes when the fixture declares one.
- *   3. Unknown indices reject with an `EngineError`.
+ *   2. `download(ref)` returns exactly `size` decoded bytes when the
+ *      fixture declares one.
+ *   3. Unknown keys reject with an `EngineError`.
  *   4. A created file-attachment annotation round-trips its file:
  *      metadata inline on the DTO (never bytes), bytes byte-identical
  *      as its `file` resource.
@@ -968,6 +1021,48 @@ declare function runChangeConformance(runner: ConformanceTestRunner, opts: Chang
 /** A PDF file of `objects`, numbered from 1, with its cross-reference table. */
 declare function pdfOf(objects: readonly string[]): Uint8Array;
 //#endregion
+//#region src/conformance/runOutlineConformance.d.ts
+/**
+ * Two pages of 300 × 300 and an outline, five items showing when it opens:
+ *
+ * - A (6), open: to page 3 at (20, 280) in the file; its child A1 (10) fits page 4.
+ * - B (7): red and bold, a URI action.
+ * - C (8), closed: the named destination `chapter-two` (page 4, `/FitH` 250);
+ *   its child C1 (11) goes nowhere.
+ * - D (9): a JavaScript action.
+ */
+declare const OUTLINE_FIXTURE_PDF: Uint8Array<ArrayBufferLike>;
+/**
+ * An outline a write never made: One (4) and Two (5), whose `/Next` comes
+ * back to One, and after One a direct item no one can name.
+ */
+declare const BROKEN_OUTLINE_FIXTURE_PDF: Uint8Array<ArrayBufferLike>;
+interface OutlineConformanceOptions {
+  label: string;
+  makeEngine: () => Promise<Engine> | Engine;
+  /** Open `bytes`, one of the fixtures here, fresh for each call, with write access. */
+  open: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+  /** Open `bytes` with the rights to open and read it only (`doc.open`, `doc.render`). */
+  openReadOnly: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+}
+/**
+ * The document's outline (`doc.outline`), the same on every engine:
+ *
+ * - A read lists every item depth first, with its parent, its target read the
+ *   way a link's is (in page space, a named destination resolved), its `/A`
+ *   tree, its colour and style, and whether it opens.
+ * - Writes name items by object number and places by neighbour; moves keep
+ *   subtrees and numbers; deletes take the items under an item with it, and
+ *   an undo brings the same items back.
+ * - Each write publishes its `outline.*` event; without `doc.outline.modify`
+ *   every write is refused and reading still works.
+ * - A target reads the same however the file stores it: written into the
+ *   item or shared, named in the `/Names` tree or the old `/Dests`, a page
+ *   by index. A new target or an undo never changes an action an item shares.
+ * - A broken outline reads what it can and says `incomplete`.
+ */
+declare function runOutlineConformance(runner: ConformanceTestRunner, opts: OutlineConformanceOptions): void;
+//#endregion
 //#region src/conformance/runPermissionConformance.d.ts
 /**
  * The two read families, through three tokens: one that may do everything,
@@ -1527,5 +1622,5 @@ interface FieldGroupsConformanceOptions {
 }
 declare function runFieldGroupsConformance(runner: ConformanceTestRunner, opts: FieldGroupsConformanceOptions): void;
 //#endregion
-export { APPEARANCE_STATES_FIXTURE_PDF, type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationAttributionConformanceOptions, type AnnotationConformanceOptions, type AnnotationDeclarationConformanceOptions, type AnnotationDeclarationFixture, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationPredictionConformanceOptions, type AnnotationReadConformanceFixture, type AnnotationResourceConformanceOptions, type AnnotationResourceFixture, type AnnotationRotationConformanceOptions, type AnnotationRotationFixture, type AnnotationTransferConformanceOptions, type AppearanceStatesConformanceOptions, type AttributionSession, BARE_PAGE_FIXTURE_PDF, CHANGE_FIXTURE_PDF, COLOR_FIXTURE_PDF, CROP_OFFSET_PDF, type ChangeConformanceOptions, type ColorConformanceOptions, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type Creatable, DRAWING_FIXTURE_PDF, type DateConformanceOptions, type DrawingDetailsConformanceOptions, type DrawingDetailsFixture, FIELD_GROUPS_PDF, FIELD_GROUP_TOKENS, type FieldGroupToken, type FieldGroupsConformanceOptions, type FormAttributionConformanceOptions, type FormConformanceFixtures, type FormConformanceOptions, type FormPredictionConformanceOptions, type FormScriptConformanceOptions, type FormTransferConformanceOptions, OBJECT_NUMBER_FIXTURE_PDF, type ObjectNumberConformanceOptions, PAGE_SPACE_FIXTURES, PERMISSION_TOKENS, PREDICTION_FIXTURE_PDF, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageRenderConformanceOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageSpaceConformanceOptions, type PageSpaceFixture, type PageSpaceFixturePage, type PageTextConformanceFixture, type PageTextConformanceOptions, type PermissionConformanceOptions, type PermissionToken, type PieceInfoConformanceOptions, type RedactionApplyConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, TURNED_FIELDS_PDF, TWO_PAGES_PDF, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, WIDGET_FINDING_CASES, type WidgetFindingCase, type WidgetFindingCaseName, type WidgetFindingConformanceOptions, type WidgetRotationConformanceOptions, annotationReadDriftOf, creatables, diffAnnotationList, iconRect, pdfOf, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationAttributionConformance, runAnnotationDeclarationConformance, runAnnotationExportConformance, runAnnotationFlattenConformance, runAnnotationImportConformance, runAnnotationMutationConformance, runAnnotationPredictionConformance, runAnnotationReadConformance, runAnnotationResourceConformance, runAnnotationRotationConformance, runAnnotationTransferConformance, runAppearanceStatesConformance, runAttachmentConformance, runChangeConformance, runColorConformance, runDateConformance, runDocumentEventsConformance, runDrawingDetailsConformance, runFieldGroupsConformance, runFormAttributionConformance, runFormConformance, runFormPredictionConformance, runFormScriptConformance, runFormTransferConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runObjectNumberConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageRenderConformance, runPageReorderConformance, runPageRotateConformance, runPageSpaceConformance, runPageTextConformance, runPermissionConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance, runWidgetFindingConformance, runWidgetRotationConformance };
+export { APPEARANCE_STATES_FIXTURE_PDF, type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationAttributionConformanceOptions, type AnnotationConformanceOptions, type AnnotationDeclarationConformanceOptions, type AnnotationDeclarationFixture, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationPredictionConformanceOptions, type AnnotationReadConformanceFixture, type AnnotationResourceConformanceOptions, type AnnotationResourceFixture, type AnnotationRotationConformanceOptions, type AnnotationRotationFixture, type AnnotationTransferConformanceOptions, type AppearanceStatesConformanceOptions, type AttributionSession, BARE_PAGE_FIXTURE_PDF, BROKEN_OUTLINE_FIXTURE_PDF, CHANGE_FIXTURE_PDF, COLOR_FIXTURE_PDF, CROP_OFFSET_PDF, type ChangeConformanceOptions, type ColorConformanceOptions, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type Creatable, DRAWING_FIXTURE_PDF, type DateConformanceOptions, type DrawingDetailsConformanceOptions, type DrawingDetailsFixture, FIELD_GROUPS_PDF, FIELD_GROUP_TOKENS, type FieldGroupToken, type FieldGroupsConformanceOptions, type FormAttributionConformanceOptions, type FormConformanceFixtures, type FormConformanceOptions, type FormPredictionConformanceOptions, type FormScriptConformanceOptions, type FormTransferConformanceOptions, OBJECT_NUMBER_FIXTURE_PDF, OUTLINE_FIXTURE_PDF, type ObjectNumberConformanceOptions, type OutlineConformanceOptions, PAGE_SPACE_FIXTURES, PERMISSION_TOKENS, PREDICTION_FIXTURE_PDF, PRINT_RULES_PDF, PRINT_SCOPES, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageRenderConformanceOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageSpaceConformanceOptions, type PageSpaceFixture, type PageSpaceFixturePage, type PageTextConformanceFixture, type PageTextConformanceOptions, type PermissionConformanceOptions, type PermissionToken, type PieceInfoConformanceOptions, type PrintCopyConformanceOptions, type PrintRenderConformanceOptions, type RedactionApplyConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, TURNED_FIELDS_PDF, TWO_PAGES_PDF, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, WIDGET_FINDING_CASES, type WidgetFindingCase, type WidgetFindingCaseName, type WidgetFindingConformanceOptions, type WidgetRotationConformanceOptions, annotationReadDriftOf, creatables, diffAnnotationList, iconRect, pdfOf, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationAttributionConformance, runAnnotationDeclarationConformance, runAnnotationExportConformance, runAnnotationFlattenConformance, runAnnotationImportConformance, runAnnotationMutationConformance, runAnnotationPredictionConformance, runAnnotationReadConformance, runAnnotationResourceConformance, runAnnotationRotationConformance, runAnnotationTransferConformance, runAppearanceStatesConformance, runAttachmentConformance, runChangeConformance, runColorConformance, runDateConformance, runDocumentEventsConformance, runDrawingDetailsConformance, runFieldGroupsConformance, runFormAttributionConformance, runFormConformance, runFormPredictionConformance, runFormScriptConformance, runFormTransferConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runObjectNumberConformance, runOutlineConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageRenderConformance, runPageReorderConformance, runPageRotateConformance, runPageSpaceConformance, runPageTextConformance, runPermissionConformance, runPieceInfoConformance, runPrintCopyConformance, runPrintRenderConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance, runWidgetFindingConformance, runWidgetRotationConformance };
 //# sourceMappingURL=conformance.d.cts.map

package/dist/conformance.d.ts

@@ -1,5 +1,5 @@
-import { E_ as Identity, Ep as CharMapAnchor, Jg as PdfRect, Nd as AnnotationResources, Ng as PageBox, Pg as PagePoint, Wm as PageTabOrder, Yg as PdfRotation, _t as LineDraft, _v as DocumentMetadata, bs as AnnotationDraft, dn as HighlightDraft, nt as InkDraft, t as AnnotationList } from "./AnnotationList-CkijRHet.js";
-import { _ as Engine, t as LocalEngine, y as DocumentHandle } from "./LocalEngine-DPriFujS.js";
+import { F_ as PdfRect, Fs as AnnotationDraft, I_ as PdfRotation, Vd as AnnotationResources, _t as LineDraft, b_ as PageBox, dn as HighlightDraft, gh as PageTabOrder, iy as DocumentMetadata, nt as InkDraft, pv as Identity, t as AnnotationList, x_ as PagePoint, zp as CharMapAnchor } from "./AnnotationList-DcyhF2kU.js";
+import { _ as Engine, t as LocalEngine, y as DocumentHandle } from "./LocalEngine-DBt2-GWF.js";
 //#region src/conformance/runMetadataConformance.d.ts
 interface ConformanceTestRunner {
   describe(name: string, fn: () => void): void;
@@ -564,6 +564,59 @@ interface PageRenderConformanceOptions {
  */
 declare function runPageRenderConformance(runner: ConformanceTestRunner, opts: PageRenderConformanceOptions): void;
 //#endregion
+//#region src/conformance/runPrintRenderConformance.d.ts
+/**
+ * A 200 × 200 page with one black 40 × 40 square for each print rule, and an
+ * A0 page (2384 × 3370) with nothing on it:
+ *
+ * - a layer that only prints, and one only shown on screen (`/Usage`
+ *   `/PrintState` and `/ViewState`, as Acrobat's watermarks write them);
+ * - four squares: one that only prints (`noView` + `print`), one only on
+ *   screen (no `print`), one on both (`print`), one on neither (`hidden`);
+ * - two form fields: a push button only on screen (Acrobat's "Visible but
+ *   doesn't print") and a text field that only prints ("Hidden but
+ *   printable").
+ */
+declare const PRINT_RULES_PDF: Uint8Array<ArrayBufferLike>;
+/** The rights each case opens with: everything, no print, print but not high. */
+declare const PRINT_SCOPES: {
+  readonly everything: readonly ["*"];
+  readonly screen: readonly ["doc.open", "doc.render", "doc.annotate.read", "doc.forms.read"];
+  readonly print: readonly ["doc.open", "doc.render", "doc.annotate.read", "doc.forms.read", "doc.print"];
+};
+interface PrintRenderConformanceOptions {
+  label: string;
+  /** Build a fresh engine for this suite. The suite tears it down at the end. */
+  makeEngine: () => Promise<Engine> | Engine;
+  /** Open a fresh copy of {@link PRINT_RULES_PDF} with `scope`. */
+  open: (engine: Engine, scope: readonly string[]) => Promise<DocumentHandle>;
+}
+/**
+ * Print pictures on both engines (`usage: 'print'` with a `dpi` viewport).
+ * A print picture follows
+ * the print rules where a screen picture follows the screen's: layers by
+ * their print state, annotations and form fields by their `print` flag,
+ * `noView` ones included, `hidden` ones never. It is the whole page at its
+ * DPI, never more pixels than the page fitted to A4 or Letter needs, and its
+ * transform is `pageTransform`'s. It needs `doc.print`, and 300 DPI
+ * `doc.print.high`; options that don't fit a print picture are refused.
+ */
+declare function runPrintRenderConformance(runner: ConformanceTestRunner, opts: PrintRenderConformanceOptions): void;
+/**
+ * The print copy on both engines: `pages.extract(pages, { flatten })` makes
+ * the pages as they draw for `flatten.usage`, so a print copy, printed, shows
+ * what a print picture of the page shows (layers by their print state,
+ * annotations and fields by their `print` flag), with nothing interactive
+ * left. `includeAnnotations` and `includeFormFields` choose what it paints,
+ * with a page picture's defaults; they take `flatten`. A flattened copy needs
+ * `doc.download` or `doc.download.flattened`, a plain one `doc.download`.
+ */
+interface PrintCopyConformanceOptions extends PrintRenderConformanceOptions {
+  /** Open `bytes`, a copy the engine made, with every right. */
+  openCopy: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+}
+declare function runPrintCopyConformance(runner: ConformanceTestRunner, opts: PrintCopyConformanceOptions): void;
+//#endregion
 //#region src/conformance/pageSpaceFixtures.d.ts
 /**
  * Small PDFs whose page boxes are odd in every way ISO 32000 allows, and in
@@ -859,17 +912,17 @@ declare function runPageExtractConformance(runner: ConformanceTestRunner, opts:
  * Attachment conformance suite. Fixture requirement: a document whose
  * `/EmbeddedFiles` name tree contains at least one embedded file.
  *
- * Both attachment surfaces are optional on the contract (the
- * `downloadLayer?` pattern), probed independently and skipped cleanly:
- *   - `doc.attachments?` — document-level EmbeddedFiles (list/download)
- *   - `page.annotations.downloadResource(ref, 'file')` — annotation-level file bytes
+ * Both homes of a file: `doc.attachments` (the `/EmbeddedFiles` name tree)
+ * and a file-attachment annotation's `file` resource
+ * (`page.annotations.downloadResource(ref, 'file')`). Both downloads answer
+ * the bytes; the name and type are what the listing says.
  *
  * Invariants:
  *   1. `list()` reflects the name tree: positional indices, non-empty
  *      names, and repeated calls agree (a read).
- *   2. `download(index)` round-trips the listed metadata and returns
- *      exactly `size` decoded bytes when the fixture declares one.
- *   3. Unknown indices reject with an `EngineError`.
+ *   2. `download(ref)` returns exactly `size` decoded bytes when the
+ *      fixture declares one.
+ *   3. Unknown keys reject with an `EngineError`.
  *   4. A created file-attachment annotation round-trips its file:
  *      metadata inline on the DTO (never bytes), bytes byte-identical
  *      as its `file` resource.
@@ -968,6 +1021,48 @@ declare function runChangeConformance(runner: ConformanceTestRunner, opts: Chang
 /** A PDF file of `objects`, numbered from 1, with its cross-reference table. */
 declare function pdfOf(objects: readonly string[]): Uint8Array;
 //#endregion
+//#region src/conformance/runOutlineConformance.d.ts
+/**
+ * Two pages of 300 × 300 and an outline, five items showing when it opens:
+ *
+ * - A (6), open: to page 3 at (20, 280) in the file; its child A1 (10) fits page 4.
+ * - B (7): red and bold, a URI action.
+ * - C (8), closed: the named destination `chapter-two` (page 4, `/FitH` 250);
+ *   its child C1 (11) goes nowhere.
+ * - D (9): a JavaScript action.
+ */
+declare const OUTLINE_FIXTURE_PDF: Uint8Array<ArrayBufferLike>;
+/**
+ * An outline a write never made: One (4) and Two (5), whose `/Next` comes
+ * back to One, and after One a direct item no one can name.
+ */
+declare const BROKEN_OUTLINE_FIXTURE_PDF: Uint8Array<ArrayBufferLike>;
+interface OutlineConformanceOptions {
+  label: string;
+  makeEngine: () => Promise<Engine> | Engine;
+  /** Open `bytes`, one of the fixtures here, fresh for each call, with write access. */
+  open: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+  /** Open `bytes` with the rights to open and read it only (`doc.open`, `doc.render`). */
+  openReadOnly: (engine: Engine, bytes: Uint8Array) => Promise<DocumentHandle>;
+}
+/**
+ * The document's outline (`doc.outline`), the same on every engine:
+ *
+ * - A read lists every item depth first, with its parent, its target read the
+ *   way a link's is (in page space, a named destination resolved), its `/A`
+ *   tree, its colour and style, and whether it opens.
+ * - Writes name items by object number and places by neighbour; moves keep
+ *   subtrees and numbers; deletes take the items under an item with it, and
+ *   an undo brings the same items back.
+ * - Each write publishes its `outline.*` event; without `doc.outline.modify`
+ *   every write is refused and reading still works.
+ * - A target reads the same however the file stores it: written into the
+ *   item or shared, named in the `/Names` tree or the old `/Dests`, a page
+ *   by index. A new target or an undo never changes an action an item shares.
+ * - A broken outline reads what it can and says `incomplete`.
+ */
+declare function runOutlineConformance(runner: ConformanceTestRunner, opts: OutlineConformanceOptions): void;
+//#endregion
 //#region src/conformance/runPermissionConformance.d.ts
 /**
  * The two read families, through three tokens: one that may do everything,
@@ -1527,5 +1622,5 @@ interface FieldGroupsConformanceOptions {
 }
 declare function runFieldGroupsConformance(runner: ConformanceTestRunner, opts: FieldGroupsConformanceOptions): void;
 //#endregion
-export { APPEARANCE_STATES_FIXTURE_PDF, type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationAttributionConformanceOptions, type AnnotationConformanceOptions, type AnnotationDeclarationConformanceOptions, type AnnotationDeclarationFixture, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationPredictionConformanceOptions, type AnnotationReadConformanceFixture, type AnnotationResourceConformanceOptions, type AnnotationResourceFixture, type AnnotationRotationConformanceOptions, type AnnotationRotationFixture, type AnnotationTransferConformanceOptions, type AppearanceStatesConformanceOptions, type AttributionSession, BARE_PAGE_FIXTURE_PDF, CHANGE_FIXTURE_PDF, COLOR_FIXTURE_PDF, CROP_OFFSET_PDF, type ChangeConformanceOptions, type ColorConformanceOptions, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type Creatable, DRAWING_FIXTURE_PDF, type DateConformanceOptions, type DrawingDetailsConformanceOptions, type DrawingDetailsFixture, FIELD_GROUPS_PDF, FIELD_GROUP_TOKENS, type FieldGroupToken, type FieldGroupsConformanceOptions, type FormAttributionConformanceOptions, type FormConformanceFixtures, type FormConformanceOptions, type FormPredictionConformanceOptions, type FormScriptConformanceOptions, type FormTransferConformanceOptions, OBJECT_NUMBER_FIXTURE_PDF, type ObjectNumberConformanceOptions, PAGE_SPACE_FIXTURES, PERMISSION_TOKENS, PREDICTION_FIXTURE_PDF, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageRenderConformanceOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageSpaceConformanceOptions, type PageSpaceFixture, type PageSpaceFixturePage, type PageTextConformanceFixture, type PageTextConformanceOptions, type PermissionConformanceOptions, type PermissionToken, type PieceInfoConformanceOptions, type RedactionApplyConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, TURNED_FIELDS_PDF, TWO_PAGES_PDF, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, WIDGET_FINDING_CASES, type WidgetFindingCase, type WidgetFindingCaseName, type WidgetFindingConformanceOptions, type WidgetRotationConformanceOptions, annotationReadDriftOf, creatables, diffAnnotationList, iconRect, pdfOf, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationAttributionConformance, runAnnotationDeclarationConformance, runAnnotationExportConformance, runAnnotationFlattenConformance, runAnnotationImportConformance, runAnnotationMutationConformance, runAnnotationPredictionConformance, runAnnotationReadConformance, runAnnotationResourceConformance, runAnnotationRotationConformance, runAnnotationTransferConformance, runAppearanceStatesConformance, runAttachmentConformance, runChangeConformance, runColorConformance, runDateConformance, runDocumentEventsConformance, runDrawingDetailsConformance, runFieldGroupsConformance, runFormAttributionConformance, runFormConformance, runFormPredictionConformance, runFormScriptConformance, runFormTransferConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runObjectNumberConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageRenderConformance, runPageReorderConformance, runPageRotateConformance, runPageSpaceConformance, runPageTextConformance, runPermissionConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance, runWidgetFindingConformance, runWidgetRotationConformance };
+export { APPEARANCE_STATES_FIXTURE_PDF, type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationAttributionConformanceOptions, type AnnotationConformanceOptions, type AnnotationDeclarationConformanceOptions, type AnnotationDeclarationFixture, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationPredictionConformanceOptions, type AnnotationReadConformanceFixture, type AnnotationResourceConformanceOptions, type AnnotationResourceFixture, type AnnotationRotationConformanceOptions, type AnnotationRotationFixture, type AnnotationTransferConformanceOptions, type AppearanceStatesConformanceOptions, type AttributionSession, BARE_PAGE_FIXTURE_PDF, BROKEN_OUTLINE_FIXTURE_PDF, CHANGE_FIXTURE_PDF, COLOR_FIXTURE_PDF, CROP_OFFSET_PDF, type ChangeConformanceOptions, type ColorConformanceOptions, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type Creatable, DRAWING_FIXTURE_PDF, type DateConformanceOptions, type DrawingDetailsConformanceOptions, type DrawingDetailsFixture, FIELD_GROUPS_PDF, FIELD_GROUP_TOKENS, type FieldGroupToken, type FieldGroupsConformanceOptions, type FormAttributionConformanceOptions, type FormConformanceFixtures, type FormConformanceOptions, type FormPredictionConformanceOptions, type FormScriptConformanceOptions, type FormTransferConformanceOptions, OBJECT_NUMBER_FIXTURE_PDF, OUTLINE_FIXTURE_PDF, type ObjectNumberConformanceOptions, type OutlineConformanceOptions, PAGE_SPACE_FIXTURES, PERMISSION_TOKENS, PREDICTION_FIXTURE_PDF, PRINT_RULES_PDF, PRINT_SCOPES, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageRenderConformanceOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageSpaceConformanceOptions, type PageSpaceFixture, type PageSpaceFixturePage, type PageTextConformanceFixture, type PageTextConformanceOptions, type PermissionConformanceOptions, type PermissionToken, type PieceInfoConformanceOptions, type PrintCopyConformanceOptions, type PrintRenderConformanceOptions, type RedactionApplyConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, TURNED_FIELDS_PDF, TWO_PAGES_PDF, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, WIDGET_FINDING_CASES, type WidgetFindingCase, type WidgetFindingCaseName, type WidgetFindingConformanceOptions, type WidgetRotationConformanceOptions, annotationReadDriftOf, creatables, diffAnnotationList, iconRect, pdfOf, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationAttributionConformance, runAnnotationDeclarationConformance, runAnnotationExportConformance, runAnnotationFlattenConformance, runAnnotationImportConformance, runAnnotationMutationConformance, runAnnotationPredictionConformance, runAnnotationReadConformance, runAnnotationResourceConformance, runAnnotationRotationConformance, runAnnotationTransferConformance, runAppearanceStatesConformance, runAttachmentConformance, runChangeConformance, runColorConformance, runDateConformance, runDocumentEventsConformance, runDrawingDetailsConformance, runFieldGroupsConformance, runFormAttributionConformance, runFormConformance, runFormPredictionConformance, runFormScriptConformance, runFormTransferConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runObjectNumberConformance, runOutlineConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageRenderConformance, runPageReorderConformance, runPageRotateConformance, runPageSpaceConformance, runPageTextConformance, runPermissionConformance, runPieceInfoConformance, runPrintCopyConformance, runPrintRenderConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance, runWidgetFindingConformance, runWidgetRotationConformance };
 //# sourceMappingURL=conformance.d.ts.map