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

package/dist/{Engine-D3868xIU.d.cts → Engine--0XF0UAK.d.cts}

@@ -1,5 +1,5 @@
-import { $i as AnnotationUpdateResult, $r as FormEffectsResult, Dr as SearchRequest, Fa as AttachmentDeleteResult, Fn as RedactionApplyScope, Fo as FontKey, Gn as PageDeleteResult, Gr as FormFieldUpdateResult, Ho as AnnotationAppearanceImagesResult, Hr as FormDataExport, Ic as AnnotationRef, Io as FontSpec, Jr as FormSetValueResult, Js as MetadataPatch, Ki as FormFieldRef, Kr as FormImportResult, Mn as MetadataUpdateResult, Ni as FormFieldDTO, Or as SearchSlice, Pa as AttachmentCreateResult, Pn as RedactionApplyResult, Po as FontHandle, Qi as AnnotationMoveResult, Ro as PdfSaveMode, Ts as PageTextSnapshot, Un as PageInsertBlankSpec, Ur as FormFieldCreateResult, Vn as PageFlattenUsage, Vo as AnnotationAppearanceImageOptions, Wn as PageInsertResult, Wr as FormFieldDeleteResult, Ws as PageListSnapshot, Xi as AnnotationCreateResult, Xn as PageMoveResult, Xr as FormEffect, Yo as AnnotationAppearancesResult, Yr as FormWidgetLinkResult, Ys as OpenInput, Za as AttachmentContent, Zi as AnnotationDeleteResult, _i as FormFieldDraft, ai as FormSubmissionRequest, ci as FormFieldValue, di as FormFieldPatch, ds as PageRenderOptions, eo as AttachmentFileSource, fl as PdfRotation, hl as DocumentActionsSnapshot, jl as DocumentMetadata, kl as PageObjectNumber, l as AnnotationPatch, ms as PageRenderViewport, n as AnnotationListSnapshotAllPages, nc as OpenOptions, no as EmbeddedFileRef, o as AnnotationDraft, qi as FormWidgetRef, qn as PageRotateResult, qo as AnnotationAppearanceRenderOptions, qr as FormRepairResult, ri as FormSubmissionReceipt, rs as PageImageOptions, si as FormDataFormat, ss as PageRaster, t as AnnotationListPageSnapshot, to as EmbeddedFileItem, ts as PageImageHandle, vs as PageGeometrySnapshot, wi as FormSnapshot, zn as PageFlattenResult } from "./AnnotationListSnapshot-C1U3XUxP.cjs";
-import { g as AbortablePromise, s as DocumentSecurityService } from "./DocumentSecurityService-6rhztZlz.cjs";
+import { $i as FormFieldRef, $n as PageNameResult, $r as FormImportResult, Bi as FormFieldDTO, Bl as DocumentMetadata, Bn as PageDeleteResult, Fn as RedactionApplyScope, Fr as SearchSlice, Gc as AnnotationRef, Go as PdfSaveMode, Ha as AttachmentDeleteResult, Hn as PageRotateResult, Ho as FontKey, Jo as AnnotationAppearanceImageOptions, Mn as MetadataUpdateResult, Ms as PageTextSnapshot, Pn as RedactionApplyResult, Pr as SearchRequest, Qn as PageFlattenUsage, Qr as FormFieldUpdateResult, Rl as PageObjectNumber, Rn as PageInsertBlankSpec, Ts as PageGeometrySnapshot, Uo as FontSpec, Va as AttachmentCreateResult, Vo as FontHandle, Xn as PageFlattenResult, Xr as FormFieldCreateResult, Yo as AnnotationAppearanceImagesResult, Yr as FormDataExport, Zr as FormFieldDeleteResult, Zs as PageListSnapshot, aa as AnnotationMoveResult, co as EmbeddedFileItem, cs as PageImageHandle, dc as OpenOptions, ea as FormWidgetRef, ei as FormRepairResult, er as PageNameInput, es as AnnotationAppearanceRenderOptions, fi as FormSubmissionRequest, hi as FormFieldValue, ia as AnnotationDeleteResult, ic as OpenInput, io as AttachmentContent, ji as FormSnapshot, l as AnnotationPatch, lo as EmbeddedFileRef, mi as FormDataFormat, ms as PageRaster, n as AnnotationListSnapshotAllPages, ni as FormWidgetLinkResult, ns as AnnotationAppearancesResult, o as AnnotationDraft, oa as AnnotationUpdateResult, oi as FormEffectsResult, qn as AnnotationFlattenResult, ra as AnnotationCreateResult, rc as MetadataPatch, ri as FormEffect, rr as PageMoveResult, so as AttachmentFileSource, t as AnnotationListPageSnapshot, ti as FormSetValueResult, tr as PageRemoveNameInput, ui as FormSubmissionReceipt, us as PageImageOptions, vi as FormFieldPatch, vs as PageRenderOptions, wi as FormFieldDraft, wl as DocumentActionsSnapshot, xl as PdfRotation, xs as PageRenderViewport, zn as PageInsertResult } from "./AnnotationListSnapshot-x6tKulNV.cjs";
+import { g as AbortablePromise, s as DocumentSecurityService } from "./DocumentSecurityService-CK0pejAK.cjs";
 //#region src/engine/DocumentActionsService.d.ts
 /** Lazy, catalog-owned PDF action read. This API extracts; it never executes. */
 interface DocumentActionsService {
@@ -262,6 +262,25 @@ interface DocumentPagesService {
    * recycled; surviving pages keep their identity and revisions.
    */
   delete(pageObjectNumbers: PageObjectNumber[]): AbortablePromise<PageDeleteResult>;
+  /**
+   * Register `name` → page in the catalog's `/Names /Pages` tree (create,
+   * or replace what an existing key points at); with `replace`, drop that
+   * other key in the same job (rename). Named pages are LAYOUT — read them
+   * back from `list().namedPages` — so this is a page-structure mutation:
+   * `docVersion` + `layoutVersion` advance, per-page pins do not. Gated like
+   * `move` (`doc.pages.assemble`). Optional while transports ship;
+   * feature-detect with `pages.setName !== undefined`.
+   *
+   * Rejects with `InvalidArg` for an empty name and `NotFound` for a page
+   * that is not in the page tree (hidden templates included).
+   */
+  setName?(input: PageNameInput): AbortablePromise<PageNameResult>;
+  /**
+   * Remove one `/Names /Pages` registration; the page itself is untouched.
+   * `NotFound` when no registration has that decoded key. Page DELETION
+   * removes registrations by itself — callers never need to pair the two.
+   */
+  removeName?(input: PageRemoveNameInput): AbortablePromise<PageNameResult>;
   /**
    * Paint eligible annotation appearances into page content and remove only
    * those annotations that were painted. This changes content and annotation
@@ -539,6 +558,30 @@ interface PageAnnotationsService {
    *                space, in `[0, count - refs.length]`.
    */
   move(refs: AnnotationRef[], toIndex: number): AbortablePromise<AnnotationMoveResult>;
+  /**
+   * Flatten the given annotations of THIS page into its content —
+   * `pages.flatten` for a chosen set. Painted annotations are removed from
+   * the page; ones that are ineligible (hidden for `usage`, Popups, no
+   * usable appearance) stay and report `skipped`, so a caller can say
+   * "2 of 3 flattened". A content + annotation MUTATION of this page: its
+   * content and annotation pins advance, layout does not; a
+   * `annotations.flattened` event is published when anything was applied.
+   * Gated like `pages.flatten` (`doc.pages.modify` + `doc.annotate.modify`).
+   * `InvalidArg` for a ref on another page; `NotFound` for an unknown ref.
+   * Optional while transports ship — feature-detect.
+   */
+  flatten?(refs: AnnotationRef[], usage?: PageFlattenUsage): AbortablePromise<AnnotationFlattenResult>;
+  /**
+   * Flatten the normal appearances of the given annotations of this page
+   * into a NEW single-page PDF sized to their union `/Rect` — vector,
+   * positions preserved, exactly as this page shows them. The same plan as
+   * `flatten` aimed at a fresh page; the source document is untouched. A
+   * derived READ that egresses content, so it is gated by `doc.download`
+   * like `pages.extract`. All-or-nothing: `InvalidArg` when any ref is not
+   * on this page, hidden, or has no appearance (a stamp silently missing a
+   * part would be worse than an error). Optional — feature-detect.
+   */
+  exportAppearance?(refs: AnnotationRef[]): AbortablePromise<Uint8Array>;
 }
 //#endregion
 //#region src/engine/PageGeometryService.d.ts
@@ -745,6 +788,9 @@ type DocumentEvent = ({
   pageObjectNumber: PageObjectNumber;
   origin: EventOrigin;
 } & AnnotationMoveResult) | ({
+  type: 'annotations.flattened';
+  origin: EventOrigin;
+} & AnnotationFlattenResult) | ({
   type: 'pages.moved';
   /** Locally: the moved block. Remotely the audit row only records the
    *  outcome, so this is the full new order — consumers should read
@@ -769,6 +815,13 @@ type DocumentEvent = ({
   destIndex?: number;
   origin: EventOrigin;
 } & PageInsertResult) | ({
+  type: 'pages.named';
+  /** The decoded key that was registered, renamed, or removed. */
+  name: string;
+  /** The page it now points at; `null` when the registration was removed. */
+  pageObjectNumber: PageObjectNumber | null;
+  origin: EventOrigin;
+} & PageNameResult) | ({
   type: 'attachment.created';
   origin: EventOrigin;
 } & AttachmentCreateResult) | ({
@@ -1053,4 +1106,4 @@ interface Engine {
 type EngineFactory = () => Engine;
 //#endregion
 export { DocumentPagesService as A, CONTINUOUS_RENDER_POLICY as C, snapFullPageViewport as D, snapAppearanceScale as E, WeakAnnotationEditSession as F, DocumentActionsService as I, FormRepairOptions as M, DocumentAttachmentsService as N, snapTileScale as O, DocumentAnnotationsService as P, DocumentSearchService as S, EngineRenderPolicy as T, PageTextService as _, DocumentHandle as a, PageAnnotationsService as b, DocumentEventInit as c, PageHandle as d, PieceInfoService as f, PieceInfoSnapshot as g, PieceInfoPatchValue as h, DocumentCapabilities as i, DocumentFormsService as j, DocumentRedactionService as k, DocumentEventType as l, PieceInfoPatch as m, EngineFactory as n, DocumentEventStream as o, PieceInfoEntry as p, FontService as r, DocumentEvent as s, Engine as t, EventOrigin as u, PageRenderService as v, DocumentRenderService as w, MetadataService as x, PageGeometryService as y };
-//# sourceMappingURL=Engine-D3868xIU.d.cts.map
+//# sourceMappingURL=Engine--0XF0UAK.d.cts.map

package/dist/{Engine-CWnAKccD.d.ts → Engine-Ds0ytbl6.d.ts}

@@ -1,5 +1,5 @@
-import { $i as AnnotationUpdateResult, $r as FormEffectsResult, Dr as SearchRequest, Fa as AttachmentDeleteResult, Fn as RedactionApplyScope, Fo as FontKey, Gn as PageDeleteResult, Gr as FormFieldUpdateResult, Ho as AnnotationAppearanceImagesResult, Hr as FormDataExport, Ic as AnnotationRef, Io as FontSpec, Jr as FormSetValueResult, Js as MetadataPatch, Ki as FormFieldRef, Kr as FormImportResult, Mn as MetadataUpdateResult, Ni as FormFieldDTO, Or as SearchSlice, Pa as AttachmentCreateResult, Pn as RedactionApplyResult, Po as FontHandle, Qi as AnnotationMoveResult, Ro as PdfSaveMode, Ts as PageTextSnapshot, Un as PageInsertBlankSpec, Ur as FormFieldCreateResult, Vn as PageFlattenUsage, Vo as AnnotationAppearanceImageOptions, Wn as PageInsertResult, Wr as FormFieldDeleteResult, Ws as PageListSnapshot, Xi as AnnotationCreateResult, Xn as PageMoveResult, Xr as FormEffect, Yo as AnnotationAppearancesResult, Yr as FormWidgetLinkResult, Ys as OpenInput, Za as AttachmentContent, Zi as AnnotationDeleteResult, _i as FormFieldDraft, ai as FormSubmissionRequest, ci as FormFieldValue, di as FormFieldPatch, ds as PageRenderOptions, eo as AttachmentFileSource, fl as PdfRotation, hl as DocumentActionsSnapshot, jl as DocumentMetadata, kl as PageObjectNumber, l as AnnotationPatch, ms as PageRenderViewport, n as AnnotationListSnapshotAllPages, nc as OpenOptions, no as EmbeddedFileRef, o as AnnotationDraft, qi as FormWidgetRef, qn as PageRotateResult, qo as AnnotationAppearanceRenderOptions, qr as FormRepairResult, ri as FormSubmissionReceipt, rs as PageImageOptions, si as FormDataFormat, ss as PageRaster, t as AnnotationListPageSnapshot, to as EmbeddedFileItem, ts as PageImageHandle, vs as PageGeometrySnapshot, wi as FormSnapshot, zn as PageFlattenResult } from "./AnnotationListSnapshot-C1U3XUxP.js";
-import { g as AbortablePromise, s as DocumentSecurityService } from "./DocumentSecurityService-7nL9aY75.js";
+import { $i as FormFieldRef, $n as PageNameResult, $r as FormImportResult, Bi as FormFieldDTO, Bl as DocumentMetadata, Bn as PageDeleteResult, Fn as RedactionApplyScope, Fr as SearchSlice, Gc as AnnotationRef, Go as PdfSaveMode, Ha as AttachmentDeleteResult, Hn as PageRotateResult, Ho as FontKey, Jo as AnnotationAppearanceImageOptions, Mn as MetadataUpdateResult, Ms as PageTextSnapshot, Pn as RedactionApplyResult, Pr as SearchRequest, Qn as PageFlattenUsage, Qr as FormFieldUpdateResult, Rl as PageObjectNumber, Rn as PageInsertBlankSpec, Ts as PageGeometrySnapshot, Uo as FontSpec, Va as AttachmentCreateResult, Vo as FontHandle, Xn as PageFlattenResult, Xr as FormFieldCreateResult, Yo as AnnotationAppearanceImagesResult, Yr as FormDataExport, Zr as FormFieldDeleteResult, Zs as PageListSnapshot, aa as AnnotationMoveResult, co as EmbeddedFileItem, cs as PageImageHandle, dc as OpenOptions, ea as FormWidgetRef, ei as FormRepairResult, er as PageNameInput, es as AnnotationAppearanceRenderOptions, fi as FormSubmissionRequest, hi as FormFieldValue, ia as AnnotationDeleteResult, ic as OpenInput, io as AttachmentContent, ji as FormSnapshot, l as AnnotationPatch, lo as EmbeddedFileRef, mi as FormDataFormat, ms as PageRaster, n as AnnotationListSnapshotAllPages, ni as FormWidgetLinkResult, ns as AnnotationAppearancesResult, o as AnnotationDraft, oa as AnnotationUpdateResult, oi as FormEffectsResult, qn as AnnotationFlattenResult, ra as AnnotationCreateResult, rc as MetadataPatch, ri as FormEffect, rr as PageMoveResult, so as AttachmentFileSource, t as AnnotationListPageSnapshot, ti as FormSetValueResult, tr as PageRemoveNameInput, ui as FormSubmissionReceipt, us as PageImageOptions, vi as FormFieldPatch, vs as PageRenderOptions, wi as FormFieldDraft, wl as DocumentActionsSnapshot, xl as PdfRotation, xs as PageRenderViewport, zn as PageInsertResult } from "./AnnotationListSnapshot-x6tKulNV.js";
+import { g as AbortablePromise, s as DocumentSecurityService } from "./DocumentSecurityService-9MawYxP-.js";
 //#region src/engine/DocumentActionsService.d.ts
 /** Lazy, catalog-owned PDF action read. This API extracts; it never executes. */
 interface DocumentActionsService {
@@ -262,6 +262,25 @@ interface DocumentPagesService {
    * recycled; surviving pages keep their identity and revisions.
    */
   delete(pageObjectNumbers: PageObjectNumber[]): AbortablePromise<PageDeleteResult>;
+  /**
+   * Register `name` → page in the catalog's `/Names /Pages` tree (create,
+   * or replace what an existing key points at); with `replace`, drop that
+   * other key in the same job (rename). Named pages are LAYOUT — read them
+   * back from `list().namedPages` — so this is a page-structure mutation:
+   * `docVersion` + `layoutVersion` advance, per-page pins do not. Gated like
+   * `move` (`doc.pages.assemble`). Optional while transports ship;
+   * feature-detect with `pages.setName !== undefined`.
+   *
+   * Rejects with `InvalidArg` for an empty name and `NotFound` for a page
+   * that is not in the page tree (hidden templates included).
+   */
+  setName?(input: PageNameInput): AbortablePromise<PageNameResult>;
+  /**
+   * Remove one `/Names /Pages` registration; the page itself is untouched.
+   * `NotFound` when no registration has that decoded key. Page DELETION
+   * removes registrations by itself — callers never need to pair the two.
+   */
+  removeName?(input: PageRemoveNameInput): AbortablePromise<PageNameResult>;
   /**
    * Paint eligible annotation appearances into page content and remove only
    * those annotations that were painted. This changes content and annotation
@@ -539,6 +558,30 @@ interface PageAnnotationsService {
    *                space, in `[0, count - refs.length]`.
    */
   move(refs: AnnotationRef[], toIndex: number): AbortablePromise<AnnotationMoveResult>;
+  /**
+   * Flatten the given annotations of THIS page into its content —
+   * `pages.flatten` for a chosen set. Painted annotations are removed from
+   * the page; ones that are ineligible (hidden for `usage`, Popups, no
+   * usable appearance) stay and report `skipped`, so a caller can say
+   * "2 of 3 flattened". A content + annotation MUTATION of this page: its
+   * content and annotation pins advance, layout does not; a
+   * `annotations.flattened` event is published when anything was applied.
+   * Gated like `pages.flatten` (`doc.pages.modify` + `doc.annotate.modify`).
+   * `InvalidArg` for a ref on another page; `NotFound` for an unknown ref.
+   * Optional while transports ship — feature-detect.
+   */
+  flatten?(refs: AnnotationRef[], usage?: PageFlattenUsage): AbortablePromise<AnnotationFlattenResult>;
+  /**
+   * Flatten the normal appearances of the given annotations of this page
+   * into a NEW single-page PDF sized to their union `/Rect` — vector,
+   * positions preserved, exactly as this page shows them. The same plan as
+   * `flatten` aimed at a fresh page; the source document is untouched. A
+   * derived READ that egresses content, so it is gated by `doc.download`
+   * like `pages.extract`. All-or-nothing: `InvalidArg` when any ref is not
+   * on this page, hidden, or has no appearance (a stamp silently missing a
+   * part would be worse than an error). Optional — feature-detect.
+   */
+  exportAppearance?(refs: AnnotationRef[]): AbortablePromise<Uint8Array>;
 }
 //#endregion
 //#region src/engine/PageGeometryService.d.ts
@@ -745,6 +788,9 @@ type DocumentEvent = ({
   pageObjectNumber: PageObjectNumber;
   origin: EventOrigin;
 } & AnnotationMoveResult) | ({
+  type: 'annotations.flattened';
+  origin: EventOrigin;
+} & AnnotationFlattenResult) | ({
   type: 'pages.moved';
   /** Locally: the moved block. Remotely the audit row only records the
    *  outcome, so this is the full new order — consumers should read
@@ -769,6 +815,13 @@ type DocumentEvent = ({
   destIndex?: number;
   origin: EventOrigin;
 } & PageInsertResult) | ({
+  type: 'pages.named';
+  /** The decoded key that was registered, renamed, or removed. */
+  name: string;
+  /** The page it now points at; `null` when the registration was removed. */
+  pageObjectNumber: PageObjectNumber | null;
+  origin: EventOrigin;
+} & PageNameResult) | ({
   type: 'attachment.created';
   origin: EventOrigin;
 } & AttachmentCreateResult) | ({
@@ -1053,4 +1106,4 @@ interface Engine {
 type EngineFactory = () => Engine;
 //#endregion
 export { DocumentPagesService as A, CONTINUOUS_RENDER_POLICY as C, snapFullPageViewport as D, snapAppearanceScale as E, WeakAnnotationEditSession as F, DocumentActionsService as I, FormRepairOptions as M, DocumentAttachmentsService as N, snapTileScale as O, DocumentAnnotationsService as P, DocumentSearchService as S, EngineRenderPolicy as T, PageTextService as _, DocumentHandle as a, PageAnnotationsService as b, DocumentEventInit as c, PageHandle as d, PieceInfoService as f, PieceInfoSnapshot as g, PieceInfoPatchValue as h, DocumentCapabilities as i, DocumentFormsService as j, DocumentRedactionService as k, DocumentEventType as l, PieceInfoPatch as m, EngineFactory as n, DocumentEventStream as o, PieceInfoEntry as p, FontService as r, DocumentEvent as s, Engine as t, EventOrigin as u, PageRenderService as v, DocumentRenderService as w, MetadataService as x, PageGeometryService as y };
-//# sourceMappingURL=Engine-CWnAKccD.d.ts.map
+//# sourceMappingURL=Engine-Ds0ytbl6.d.ts.map

package/dist/{builders-Do6_4KnS.cjs → builders-8Hl1AYNU.cjs}

@@ -139,19 +139,25 @@ function isBlob(value) {
 	return typeof Blob !== "undefined" && value instanceof Blob;
 }
 /**
-* Detach a Uint8Array view into a standalone ArrayBuffer without copying
-* when the view already spans its whole buffer.
+* Copy a Uint8Array view into a fresh, exactly-sized ArrayBuffer the call
+* owns. Always copies — even when the view spans its whole buffer — because
+* the result may be transferred to a worker (detaching it), and the view is
+* the caller's. Returning `view.buffer` here would let one transfer zero
+* the caller's bytes (a stamp library's Uint8Array became single-use).
+* Callers wanting a zero-copy hand-off need an explicit "give" form, as
+* `pages.insert` has for bare ArrayBuffers; `BinarySource` has none.
 */
-function toStandaloneArrayBuffer(view) {
-	if (view.byteOffset === 0 && view.buffer instanceof ArrayBuffer && view.byteLength === view.buffer.byteLength) return view.buffer;
-	return view.slice().buffer;
+function toOwnedArrayBuffer(view) {
+	const copy = new ArrayBuffer(view.byteLength);
+	new Uint8Array(copy).set(view);
+	return copy;
 }
 /**
 * Resolve any accepted `BinarySource` form into a `WireResource`.
 * Async because Blob bytes can only be read asynchronously.
 */
 async function resolveBinarySource(source) {
-	if (source instanceof Uint8Array) return { bytes: toStandaloneArrayBuffer(source) };
+	if (source instanceof Uint8Array) return { bytes: toOwnedArrayBuffer(source) };
 	if (isBlob(source)) {
 		const blobName = blobFileName(source);
 		return {
@@ -162,7 +168,7 @@ async function resolveBinarySource(source) {
 	}
 	const { data, mimeType, name } = source;
 	const inner = data instanceof Uint8Array ? {
-		bytes: toStandaloneArrayBuffer(data),
+		bytes: toOwnedArrayBuffer(data),
 		mimeType: void 0,
 		name: void 0
 	} : {
@@ -2089,4 +2095,4 @@ Object.defineProperty(exports, "wordBefore", {
 	}
 });
 
-//# sourceMappingURL=builders-Do6_4KnS.cjs.map
+//# sourceMappingURL=builders-8Hl1AYNU.cjs.map