@embedpdf/engine-core 3.0.0-next.12 → 3.0.0-next.14

package/dist/conformance.d.cts

@@ -1,5 +1,5 @@
-import { An as HighlightDraft, Bl as DocumentMetadata, Ps as CharMapAnchor, _l as LinePoints, bl as PdfRect, hl as InkList, n as AnnotationListSnapshotAllPages, t as AnnotationListPageSnapshot, vl as PdfPoint } from "./AnnotationListSnapshot-x6tKulNV.cjs";
-import { t as Engine } from "./Engine--0XF0UAK.cjs";
+import { An as HighlightDraft, Bd as PdfPoint, Hd as PdfRect, Ld as InkList, cf as DocumentMetadata, n as AnnotationListSnapshotAllPages, t as AnnotationListPageSnapshot, xl as CharMapAnchor, zd as LinePoints } from "./AnnotationListSnapshot-D9R5n2Kf.cjs";
+import { t as Engine } from "./Engine-FNaAEjfb.cjs";
 //#region src/conformance/runMetadataConformance.d.ts
 interface ConformanceTestRunner {
   describe(name: string, fn: () => void): void;
@@ -54,6 +54,10 @@ interface ConformanceOptions {
  */
 declare function runMetadataConformance(runner: ConformanceTestRunner, opts: ConformanceOptions): void;
 //#endregion
+//#region src/conformance/runMeasurementConformance.d.ts
+/** Shared numerical, persistence and calibration contract for local and HTTP engines. */
+declare function runMeasurementConformance(runner: ConformanceTestRunner, opts: ConformanceOptions): void;
+//#endregion
 //#region src/conformance/runAnnotationReadConformance.d.ts
 /**
  * Expected per-fixture annotation knowledge. The harness asserts against
@@ -697,5 +701,72 @@ declare function runSearchConformance(runner: ConformanceTestRunner, opts: Searc
 declare function diffAnnotationListSnapshot(a: AnnotationListPageSnapshot, b: AnnotationListPageSnapshot): string[];
 declare function diffAnnotationListSnapshotAll(a: AnnotationListSnapshotAllPages, b: AnnotationListSnapshotAllPages): string[];
 //#endregion
-export { type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationConformanceOptions, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationReadConformanceFixture, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type FormConformanceFixtures, type FormConformanceOptions, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageTextConformanceFixture, type PageTextConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, TEXT_DIVERGENCE_CASES, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationFlattenConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMetadataConformance, runNamedPagesConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runTextDivergenceConformance };
+//#region src/conformance/runSignatureConformance.d.ts
+interface SignatureConformanceFixtures {
+  /** A form with no signature fields at all. */
+  unsignedForm: ConformanceFixture;
+  /**
+   * Three revisions: the original, an approval signature sealing revision
+   * 1, and a form fill plus a second approval signature sealing revision
+   * 2. Both signatures have whole-revision coverage; `textField` is the
+   * filled text field.
+   */
+  twoApprovals: ConformanceFixture & {
+    fieldNames: [string, string];
+    textField: string;
+  };
+  /** Two revisions: a certification signature with permission 2 sealing revision 1. */
+  certified: ConformanceFixture & {
+    fieldName: string;
+  };
+  /** Two revisions: one approval signature whose FieldMDP includes `lockedField`. */
+  fieldMdp: ConformanceFixture & {
+    fieldName: string;
+    lockedField: string;
+  };
+  /** Three chained revisions, two signatures whose ranges are well-formed but seal no revision. */
+  partialChain: ConformanceFixture;
+  /** One unsigned signature field (with a widget) and one text field, nothing signed. */
+  unsignedSigField: ConformanceFixture & {
+    fieldName: string;
+    textField: string;
+  };
+  /** Any single-page PDF, used as signature artwork. */
+  artwork: ConformanceFixture;
+}
+interface SignatureConformanceOptions {
+  label: string;
+  makeEngine: () => Promise<Engine> | Engine;
+  /**
+   * An engine constructed with `signedDocumentPolicy: 'permit'`; the
+   * suite proves the protection it lifts. Omit where the engine has no
+   * such option.
+   */
+  makePermitEngine?: () => Promise<Engine> | Engine;
+  /** `layerBytes` opens each fixture as an immutable base with a fresh layer on top. */
+  openKind: 'bytes' | 'layerBytes' | 'id';
+  fixtures: SignatureConformanceFixtures;
+}
+/**
+ * Digital signatures, read side. The service is OPTIONAL on the contract
+ * (`downloadLayer?` pattern) — the suite runs only where the engine
+ * provides it.
+ *
+ * Invariants:
+ *   1. Byte facts describe the LOADED bytes: a revision is a byte prefix,
+ *      a whole-revision signature seals exactly one, the digest over its
+ *      `/ByteRange` is what the file's bytes hash to, and an unsaved edit
+ *      changes none of it.
+ *   2. Protection is derived from the signatures in the file and applied
+ *      as document-derived capabilities: a certification with permission 2
+ *      takes page assembly and annotation writes away, a FieldMDP freezes
+ *      the fields it names, a rewrite save is refused. Under
+ *      `signedDocumentPolicy: 'permit'` none of that applies and the
+ *      analysis is unchanged.
+ *   3. The same answers come from a plain session and from a layer
+ *      session over the same bytes.
+ */
+declare function runSignatureConformance(runner: ConformanceTestRunner, opts: SignatureConformanceOptions): void;
+//#endregion
+export { type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationConformanceOptions, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationReadConformanceFixture, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type FormConformanceFixtures, type FormConformanceOptions, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageTextConformanceFixture, type PageTextConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationFlattenConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance };
 //# sourceMappingURL=conformance.d.cts.map

package/dist/conformance.d.ts

@@ -1,5 +1,5 @@
-import { An as HighlightDraft, Bl as DocumentMetadata, Ps as CharMapAnchor, _l as LinePoints, bl as PdfRect, hl as InkList, n as AnnotationListSnapshotAllPages, t as AnnotationListPageSnapshot, vl as PdfPoint } from "./AnnotationListSnapshot-x6tKulNV.js";
-import { t as Engine } from "./Engine-Ds0ytbl6.js";
+import { An as HighlightDraft, Bd as PdfPoint, Hd as PdfRect, Ld as InkList, cf as DocumentMetadata, n as AnnotationListSnapshotAllPages, t as AnnotationListPageSnapshot, xl as CharMapAnchor, zd as LinePoints } from "./AnnotationListSnapshot-D9R5n2Kf.js";
+import { t as Engine } from "./Engine-EWWHhEIi.js";
 //#region src/conformance/runMetadataConformance.d.ts
 interface ConformanceTestRunner {
   describe(name: string, fn: () => void): void;
@@ -54,6 +54,10 @@ interface ConformanceOptions {
  */
 declare function runMetadataConformance(runner: ConformanceTestRunner, opts: ConformanceOptions): void;
 //#endregion
+//#region src/conformance/runMeasurementConformance.d.ts
+/** Shared numerical, persistence and calibration contract for local and HTTP engines. */
+declare function runMeasurementConformance(runner: ConformanceTestRunner, opts: ConformanceOptions): void;
+//#endregion
 //#region src/conformance/runAnnotationReadConformance.d.ts
 /**
  * Expected per-fixture annotation knowledge. The harness asserts against
@@ -697,5 +701,72 @@ declare function runSearchConformance(runner: ConformanceTestRunner, opts: Searc
 declare function diffAnnotationListSnapshot(a: AnnotationListPageSnapshot, b: AnnotationListPageSnapshot): string[];
 declare function diffAnnotationListSnapshotAll(a: AnnotationListSnapshotAllPages, b: AnnotationListSnapshotAllPages): string[];
 //#endregion
-export { type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationConformanceOptions, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationReadConformanceFixture, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type FormConformanceFixtures, type FormConformanceOptions, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageTextConformanceFixture, type PageTextConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, TEXT_DIVERGENCE_CASES, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationFlattenConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMetadataConformance, runNamedPagesConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runTextDivergenceConformance };
+//#region src/conformance/runSignatureConformance.d.ts
+interface SignatureConformanceFixtures {
+  /** A form with no signature fields at all. */
+  unsignedForm: ConformanceFixture;
+  /**
+   * Three revisions: the original, an approval signature sealing revision
+   * 1, and a form fill plus a second approval signature sealing revision
+   * 2. Both signatures have whole-revision coverage; `textField` is the
+   * filled text field.
+   */
+  twoApprovals: ConformanceFixture & {
+    fieldNames: [string, string];
+    textField: string;
+  };
+  /** Two revisions: a certification signature with permission 2 sealing revision 1. */
+  certified: ConformanceFixture & {
+    fieldName: string;
+  };
+  /** Two revisions: one approval signature whose FieldMDP includes `lockedField`. */
+  fieldMdp: ConformanceFixture & {
+    fieldName: string;
+    lockedField: string;
+  };
+  /** Three chained revisions, two signatures whose ranges are well-formed but seal no revision. */
+  partialChain: ConformanceFixture;
+  /** One unsigned signature field (with a widget) and one text field, nothing signed. */
+  unsignedSigField: ConformanceFixture & {
+    fieldName: string;
+    textField: string;
+  };
+  /** Any single-page PDF, used as signature artwork. */
+  artwork: ConformanceFixture;
+}
+interface SignatureConformanceOptions {
+  label: string;
+  makeEngine: () => Promise<Engine> | Engine;
+  /**
+   * An engine constructed with `signedDocumentPolicy: 'permit'`; the
+   * suite proves the protection it lifts. Omit where the engine has no
+   * such option.
+   */
+  makePermitEngine?: () => Promise<Engine> | Engine;
+  /** `layerBytes` opens each fixture as an immutable base with a fresh layer on top. */
+  openKind: 'bytes' | 'layerBytes' | 'id';
+  fixtures: SignatureConformanceFixtures;
+}
+/**
+ * Digital signatures, read side. The service is OPTIONAL on the contract
+ * (`downloadLayer?` pattern) — the suite runs only where the engine
+ * provides it.
+ *
+ * Invariants:
+ *   1. Byte facts describe the LOADED bytes: a revision is a byte prefix,
+ *      a whole-revision signature seals exactly one, the digest over its
+ *      `/ByteRange` is what the file's bytes hash to, and an unsaved edit
+ *      changes none of it.
+ *   2. Protection is derived from the signatures in the file and applied
+ *      as document-derived capabilities: a certification with permission 2
+ *      takes page assembly and annotation writes away, a FieldMDP freezes
+ *      the fields it names, a rewrite save is refused. Under
+ *      `signedDocumentPolicy: 'permit'` none of that applies and the
+ *      analysis is unchanged.
+ *   3. The same answers come from a plain session and from a layer
+ *      session over the same bytes.
+ */
+declare function runSignatureConformance(runner: ConformanceTestRunner, opts: SignatureConformanceOptions): void;
+//#endregion
+export { type ActionsConformanceFixtures, type ActionsConformanceOptions, type AnnotationAppearanceConformanceFixture, type AnnotationAppearanceConformanceOptions, type AnnotationConformanceOptions, type AnnotationMutationConformanceFixture, type AnnotationMutationConformanceOptions, type AnnotationReadConformanceFixture, type ConformanceExpect, type ConformanceFixture, type ConformanceOptions, type ConformanceTestRunner, type FormConformanceFixtures, type FormConformanceOptions, type PageGeometryOrientationFixture, type PageGeometryOrientationOptions, type PageReorderConformanceFixture, type PageReorderConformanceOptions, type PageTextConformanceFixture, type PageTextConformanceOptions, type SearchConformanceFixture, type SearchConformanceOptions, type SignatureConformanceFixtures, type SignatureConformanceOptions, TEXT_DIVERGENCE_CASES, type TextDivergenceCase, type TextDivergenceConformanceFixture, type TextDivergenceConformanceOptions, diffAnnotationListSnapshot, diffAnnotationListSnapshotAll, runActionsConformance, runAnnotationAppearanceConformance, runAnnotationAppearanceExportConformance, runAnnotationFlattenConformance, runAnnotationMutationConformance, runAnnotationReadConformance, runAttachmentConformance, runDocumentEventsConformance, runFormConformance, runMeasurementConformance, runMetadataConformance, runNamedPagesConformance, runPageDeleteConformance, runPageExtractConformance, runPageFlattenConformance, runPageGeometryOrientationConformance, runPageInsertBlankConformance, runPageInsertConformance, runPageReorderConformance, runPageRotateConformance, runPageTextConformance, runPieceInfoConformance, runRedactionApplyConformance, runSearchConformance, runSignatureConformance, runTextDivergenceConformance };
 //# sourceMappingURL=conformance.d.ts.map