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

package/dist/{LocalEngine-DFoBm4B3.d.cts → LocalEngine-DBt2-GWF.d.ts}

@@ -1,5 +1,5 @@
-import { $c as FormMutationMeta, $f as DownloadOptions, $h as SignatureCompleteResult, $l as PageFlattenResult, $n as PageDeleteResult, Aa as FormFieldValue, Bh as BaseVersionInfo, Bl as AnnotationImportResult, Bu as AttachmentContent, Dl as WidgetPatch, Gl as FormFieldCreateOptions, Gn as RedactionApplyResult, Gu as AttachmentRef, Hl as AnnotationCreateOptions, Ho as SearchSlice, I_ as DocumentActionsSnapshot, Jf as FontHandle, Jl as WriteOptions, Jm as CustomMetadata, Kl as FormWidgetAddOptions, Kn as RedactionApplyScope, Ko as TextLayout, Mc as AttachmentDeleteResult, Md as AnnotationResourceRole, Mi as FormSubmissionReceipt, Ng as PageBox, Np as TextRange, P_ as AbortablePromise, Pa as FormFieldPatch, Pi as FormSubmissionRequest, Qc as FormFieldUpdateResult, Qh as SignatureCompleteInput, Qn as PageInsertResult, Qp as PageRenderImage, Rc as FormImportOptions, Sa as CustomMetadataUpdateResult, To as WidgetPlacement, Uc as FormValuesImportOptions, Ul as AnnotationUpdateOptions, Up as PageImageOptions, Uu as AttachmentFileSource, Vh as DigestAlgorithm, Vm as PageListSnapshot, Vo as SearchRequest, Wc as FormValuesImportResult, Wl as FlattenWriteOptions, Wu as AttachmentList, Xc as FormFieldCreateResult, Xf as FontKey, Xh as SignatureAppearanceInput, Xm as OpenInput, Yc as FormCalculationsReorderResult, Yg as PdfRotation, Ym as MetadataPatch, Zc as FormFieldDeleteResult, Zf as FontSpec, Zg as FormFieldRef, Zh as SignatureCancelResult, Zi as Change, Zn as PageInsertBlankSpec, _a as PagePosition, _g as FormFieldDTO, _v as DocumentMetadata, ah as OpenOptions, al as FormWidgetRestoreResult, ap as AnnotationAppearanceImageOptions, au as AnnotationUpdateResult, bs as AnnotationDraft, bv as IsoDateTime, cg as SignatureSnapshot, cl as FormWidgetsReorderResult, cr as PageNameInput, dp as AnnotationAppearancesResult, ef as ObjectNumberPool, el as FormRepairResult, em as PageRenderOptions, fg as MutationMeta, fl as FormExportSelection, gl as FormSnapshot, gu as AnnotationExportSelection, ha as FieldPosition, hd as PdfMeasure, hi as ChangeAnalysis, hn as PageScaleResult, hu as AnnotationListMutationMeta, ig as SignaturePrepared, il as FormWidgetLinkResult, im as PageRenderViewport, iu as AnnotationReorderResult, jc as AttachmentCreateResult, lp as AnnotationAppearanceRenderOptions, lr as PageRemoveNameInput, ma as AnnotationPosition, n as AnnotationListOptions, na as ChangeResult, nl as FormSetValueResult, nm as PageRenderRaster, nu as AnnotationCreateResult, o_ as AnnotationRef, op as AnnotationAppearanceImagesResult, or as AnnotationFlattenResult, pa as MetadataUpdateResult, pd as PageMeasurementViewportList, pi as AnalyzeInput, ql as PageInsertBlankOptions, qm as CustomMetadataPatch, rg as SignaturePrepareInput, rl as FormWidgetDeleteResult, ru as AnnotationDeleteResult, sl as FormWidgetUpdateResult, sr as PageNameResult, t as AnnotationList, tl as FormResetResult, tr as PageRotateResult, tu as PageFlattenUsage, ur as PageReorderResult, uv as PageRef, vl as FormBundle, vo as FormFieldDraft, vs as Annotation, vu as AnnotationBundle, wl as WidgetAnnotation, wp as PageTextSnapshot, xs as AnnotationPatch, zc as FormImportResult, zl as AnnotationImportOptions } from "./AnnotationList-CkijRHet.cjs";
-import { c as DocumentSecurityService } from "./DocumentSecurityService-e6vp2de8.cjs";
+import { $g as MutationMeta, $l as AnnotationImportResult, $u as AttachmentRef, Ah as OutlineItemRef, Ba as FormFieldValue, Bd as AnnotationResourceRole, Bg as SignatureCompleteResult, Bl as WidgetPatch, Bo as WidgetPlacement, Ca as AnnotationPosition, Cd as PdfMeasure, Cu as AnnotationExportSelection, Cv as DocumentActionsSnapshot, Da as PagePosition, Dg as BaseVersionInfo, Ea as OutlinePosition, Ei as FormSubmissionReceipt, Fs as AnnotationDraft, Gg as SignaturePrepared, Gi as Change, Gn as RedactionApplyResult, I_ as PdfRotation, Is as AnnotationPatch, Kc as AttachmentRestoreResult, Kh as OpenOptions, Kn as RedactionApplyScope, Kp as TextRange, Lg as SignatureAppearanceInput, Lh as OpenInput, Ll as WidgetAnnotation, Lp as PageTextSnapshot, Ma as CustomMetadataUpdateResult, Mm as PageFlattenResult, No as FormFieldDraft, Ns as Annotation, Og as DigestAlgorithm, Oh as OutlineItemDraft, Oi as FormSubmissionRequest, Pm as PageFlattenUsage, Qc as FormImportResult, Ql as AnnotationImportOptions, Qu as AttachmentList, R_ as FormFieldRef, Rg as SignatureCancelResult, Sa as MetadataUpdateResult, Su as AnnotationListMutationMeta, Th as DocumentOutline, Tl as FormExportSelection, Tp as PageExtractOptions, Tu as AnnotationBundle, Uc as AttachmentCreateResult, Wa as FormFieldPatch, Wc as AttachmentDeleteResult, Wg as SignaturePrepareInput, Xi as ChangeResult, Yg as SignatureSnapshot, Zc as FormImportOptions, Zu as AttachmentFileSource, Zv as PageRef, _l as FormWidgetLinkResult, _p as AnnotationAppearanceRenderOptions, ap as FontSpec, au as FormWidgetAddOptions, b_ as PageBox, ba as OutlineUpdateResult, bh as CustomMetadata, bl as FormWidgetUpdateResult, bm as PageRenderViewport, ca as PageRestoreResult, cf as ObjectNumberPool, cl as FormCalculationsReorderResult, dl as FormFieldUpdateResult, du as AnnotationReorderResult, fa as PageInsertBlankSpec, fl as FormMutationMeta, fu as AnnotationUpdateResult, ga as OutlineMoveResult, gl as FormWidgetDeleteResult, gm as PageRenderOptions, ha as OutlineDeleteResult, hl as FormSetValueResult, hn as PageScaleResult, i_ as FormFieldDTO, im as PageImageOptions, ip as FontKey, ir as PageRemoveNameInput, iu as FormFieldCreateOptions, iy as DocumentMetadata, jl as FormBundle, kh as OutlineItemPatch, kl as FormSnapshot, la as PageReorderResult, li as ChangeAnalysis, ll as FormFieldCreateResult, lu as AnnotationCreateResult, ma as OutlineCreateResult, ml as FormResetResult, mm as PageRenderImage, mp as AnnotationAppearanceImagesResult, n as AnnotationListOptions, nl as FormValuesImportOptions, np as FontHandle, nr as PageNameResult, ns as SearchRequest, nu as AnnotationUpdateOptions, ou as PageInsertBlankOptions, pa as PageDeleteResult, ph as PageListSnapshot, pl as FormRepairResult, pp as AnnotationAppearanceImageOptions, q_ as AnnotationRef, rl as FormValuesImportResult, rr as PageNameInput, rs as SearchSlice, ru as FlattenWriteOptions, sa as PageRotateResult, si as AnalyzeInput, sp as DownloadOptions, ss as TextLayout, su as WriteOptions, sy as IsoDateTime, t as AnnotationList, tr as AnnotationFlattenResult, tu as AnnotationCreateOptions, ua as PageInsertResult, ul as FormFieldDeleteResult, uu as AnnotationDeleteResult, vl as FormWidgetRestoreResult, vm as PageRenderRaster, wa as FieldPosition, xd as PageMeasurementViewportList, xh as MetadataPatch, xl as FormWidgetsReorderResult, xv as AbortablePromise, ya as OutlineRestoreResult, yh as CustomMetadataPatch, yp as AnnotationAppearancesResult, zg as SignatureCompleteInput } from "./AnnotationList-DcyhF2kU.js";
+import { c as DocumentSecurityService } from "./DocumentSecurityService-YJV9df8P.js";
 //#region src/engine/DocumentActionsService.d.ts
 /** Lazy, catalog-owned PDF action read. This API extracts; it never executes. */
 interface DocumentActionsService {
@@ -50,18 +50,24 @@ interface DocumentAnnotationsService {
  * construction (see the ref's doc comment). `list()` returns metadata only;
  * bytes leave the engine exclusively through {@link download}. The
  * annotation-level counterpart is
- * `PageAnnotationsService.downloadResource(ref, 'file')`.
+ * `PageAnnotationsService.downloadResource(ref, 'file')`, which answers the
+ * same way: the bytes, the name and type being what the listing says.
+ *
+ * `create` and `delete` are each one op of a change (`attachments.create`,
+ * `attachments.delete`): their `opId` undoes them, and an undo of a delete
+ * brings the same file back (`attachments.restored`).
  */
 interface DocumentAttachmentsService {
   /** Snapshot of the `/EmbeddedFiles` name tree, in tree (key-sorted) order. */
   list(): AbortablePromise<AttachmentList>;
   /**
-   * Decode and return one embedded file's bytes plus the metadata needed
-   * to hand it to a user (name, mime type). Throws
-   * `EngineError(NotFound)` when no entry has the ref's key and
-   * `EngineError(InvalidArg)` when the entry has no embedded file stream.
+   * Decode and return one embedded file's bytes. Throws
+   * `EngineError(NotFound)` when no entry has the ref's key,
+   * `EngineError(InvalidArg)` when the entry has no embedded file stream,
+   * and `EngineError(PayloadTooLarge)` when the file decodes to more than
+   * `ATTACHMENT_LIMITS.decodedBytes` on an engine that holds it in memory.
    */
-  download(ref: AttachmentRef): AbortablePromise<AttachmentContent>;
+  download(ref: AttachmentRef): AbortablePromise<Uint8Array>;
   /**
    * Create an embedded file in the name tree. The file's `name` becomes
    * the tree key (`/UF` = `/F` = key); a duplicate key rejects with
@@ -276,6 +282,39 @@ interface DocumentFormsService {
   repair(options?: FormRepairOptions): AbortablePromise<FormRepairResult>;
 }
 //#endregion
+//#region src/engine/DocumentOutlineService.d.ts
+/** Where `create` puts a new item, and the name it gets. */
+interface OutlineCreateOptions extends WriteOptions {
+  /** The item it goes under; the top level when left out or `null`. */
+  parent?: OutlineItemRef | null;
+  /** Its place among `parent`'s children; the end when left out. */
+  position?: OutlinePosition;
+  /** Its object number, taken from `doc.objectNumbers`; the engine picks one when left out. */
+  objectNumber?: number;
+}
+/**
+ * The document's outline (`/Root /Outlines`, the bookmarks). Reading it is
+ * part of opening the document (`doc.open`); writing takes
+ * `doc.outline.modify`. Each write is a one-op change: the same op, checks
+ * and undo as `doc.apply`, its events `outline.*`.
+ */
+interface DocumentOutlineService {
+  /** Every item, depth first. */
+  get(): AbortablePromise<DocumentOutline>;
+  /** A new item; `'outline.create'` in a change. */
+  create(data: OutlineItemDraft, options?: OutlineCreateOptions): AbortablePromise<OutlineCreateResult>;
+  /** Change the fields `patch` names; `'outline.update'` in a change. */
+  update(ref: OutlineItemRef, patch: OutlineItemPatch, options?: WriteOptions): AbortablePromise<OutlineUpdateResult>;
+  /**
+   * Move items, each with the items under it, under `parent` (`null`: the
+   * top level) at `position` among its children; `'outline.move'` in a
+   * change.
+   */
+  move(refs: readonly OutlineItemRef[], parent: OutlineItemRef | null, position: OutlinePosition, options?: WriteOptions): AbortablePromise<OutlineMoveResult>;
+  /** Delete an item and the items under it; `'outline.delete'` in a change. */
+  delete(ref: OutlineItemRef, options?: WriteOptions): AbortablePromise<OutlineDeleteResult>;
+}
+//#endregion
 //#region src/engine/DocumentPagesService.d.ts
 /**
  * Document-scoped page service exposed via `DocumentHandle.pages`.
@@ -289,6 +328,10 @@ interface DocumentFormsService {
  * number) everywhere except `list()`, which exposes display order through
  * `PageLayout.index`. Structure verbs never change the names of the
  * annotations on surviving pages.
+ *
+ * Each structure verb is a one-op change through `doc.apply` (`pageVerbs`):
+ * its `opId` undoes it, and an undo of a delete brings the same pages back
+ * (`pages.restored`).
  */
 interface DocumentPagesService {
   /**
@@ -352,17 +395,25 @@ interface DocumentPagesService {
    * resource. Gated by `doc.download` (it egresses content), not
    * `doc.pages.assemble`.
    *
+   * With `flatten`, the copy is the pages as they draw for its `usage`: the
+   * annotations and form fields painted in, nothing interactive left, layers
+   * in their state for `usage` (`{ usage: 'print' }` is a print copy). It
+   * takes `doc.download` or `doc.download.flattened`, and paints only what
+   * the caller may read; `includeAnnotations` and `includeFormFields` choose
+   * what it paints, and are refused without `flatten`. The copy keeps the
+   * document's title.
+   *
    * Required-parity, delivered: the local engine runs it in the worker,
    * the cloud engine as POST /pages/extract.
    */
-  extract(pages: PageRef[]): AbortablePromise<Uint8Array>;
+  extract(pages: PageRef[], options?: PageExtractOptions): AbortablePromise<Uint8Array>;
   /**
    * Insert every page of a standalone PDF (`bytes`) at `position`
    * (default `'end'`). The pages are copied in; the inserted copies get
    * fresh object numbers, returned in insertion order. Bytes are a call
    * argument (the same law as annotation binaries): the local engine
-   * transfers them to its worker, the cloud engine ships them as a
-   * multipart mutation (POST /pages/insert).
+   * transfers them to its worker, the cloud engine ships them as a part of
+   * its change request.
    *
    * Required-parity, delivered — a cloud viewer must be able to add pages,
    * so this is a mandatory member: any engine implements it or is not a
@@ -373,9 +424,9 @@ interface DocumentPagesService {
    * Create `spec.count` (default 1) blank pages of `spec.size` (PDF points)
    * at `position` (default `'end'`). The blank-page sibling of `insert`:
    * same gate (`doc.pages.assemble`), same result shape, same
-   * `pages.inserted` event — it is a separate verb because its wire is pure
-   * parameters where `insert`'s is a binary payload (cloud: JSON
-   * POST /pages/insert-blank). Every pre-existing page keeps its identity.
+   * `pages.inserted` event — it is a separate verb because it takes pure
+   * parameters where `insert` takes a binary payload. Every pre-existing
+   * page keeps its identity.
    * Mandatory, like `insert`.
    *
    * `options.objectNumbers` names the new pages, one number per page in
@@ -944,7 +995,12 @@ type DocumentEvent = ({
 } & PageDeleteResult) | ({
   type: 'pages.inserted';
   origin: EventOrigin;
-} & PageInsertResult) | ({
+} & PageInsertResult) |
+/** An undo brought deleted pages back, or a redo brought inserted pages back. */
+({
+  type: 'pages.restored';
+  origin: EventOrigin;
+} & PageRestoreResult) | ({
   type: 'pages.named';
   /** The decoded key that was registered, renamed, or removed. */
   name: string;
@@ -959,13 +1015,39 @@ type DocumentEvent = ({
   origin: EventOrigin;
   /** What was deleted (see `deletedAttachmentOf`). */
   deleted: AttachmentRef | null;
-} & AttachmentDeleteResult) | ({
+} & AttachmentDeleteResult) |
+/** An undo brought a deleted file back, under the key it had. */
+({
+  type: 'attachments.restored';
+  origin: EventOrigin;
+} & AttachmentRestoreResult) | ({
   type: 'metadata.updated';
   origin: EventOrigin;
 } & MetadataUpdateResult) | ({
   type: 'metadata.customUpdated';
   origin: EventOrigin;
 } & CustomMetadataUpdateResult) | ({
+  type: 'outline.created';
+  origin: EventOrigin;
+} & OutlineCreateResult) | ({
+  type: 'outline.updated';
+  origin: EventOrigin;
+} & OutlineUpdateResult) | ({
+  type: 'outline.moved';
+  origin: EventOrigin;
+} & OutlineMoveResult) | ({
+  type: 'outline.deleted';
+  origin: EventOrigin;
+  /** What was deleted: the item first, then the items under it (see `deletedOutlineItemsOf`). */
+  deleted: OutlineItemRef[];
+} & OutlineDeleteResult) | ({
+  /**
+   * An undo brought deleted outline items back: the same items, under the
+   * refs they had, at the place the item had among its parent's children.
+   */
+  type: 'outline.restored';
+  origin: EventOrigin;
+} & OutlineRestoreResult) | ({
   type: 'forms.valueSet';
   origin: EventOrigin;
 } & FormSetValueResult) | ({
@@ -1173,6 +1255,8 @@ interface DocumentHandle {
   readonly attachments: DocumentAttachmentsService;
   /** The document's interactive form (AcroForm): fields, values, interchange. */
   readonly forms: DocumentFormsService;
+  /** The document's outline (`/Root /Outlines`, the bookmarks): its items, read and written. */
+  readonly outline: DocumentOutlineService;
   /** Document text search: budgeted, cursor-resumable slices. */
   readonly search: DocumentSearchService;
   /**
@@ -1561,5 +1645,5 @@ interface LocalEngine extends Engine {
 /** Whether `engine` is the local engine, with its fonts and `warmup()`. */
 declare function isLocalEngine(engine: Engine): engine is LocalEngine;
 //#endregion
-export { FormRepairOptions as $, PageHandle as A, CustomMetadataService as B, DocumentEventStream as C, DocumentEventOf as D, DocumentEventInit as E, LocalPageFormsService as F, EngineRenderPolicy as G, DocumentSearchService as H, PageFormsService as I, snapFullPageViewport as J, appearanceLatticeScale as K, LocalPageAnnotationsService as L, PageTextService as M, LocalPageRenderService as N, DocumentEventType as O, PageRenderService as P, DocumentFormsService as Q, PageAnnotationsService as R, WorkingSetPage as S, DocumentEvent as T, CONTINUOUS_RENDER_POLICY as U, DocumentSignaturesService as V, DocumentRenderService as W, DocumentRedactionService as X, snapTileScale as Y, DocumentPagesService as Z, Engine as _, LocalPageHandle as a, CallFacts as b, PieceInfoService as c, PieceInfoPatch as d, DocumentAttachmentsService as et, PieceInfoPatchValue as f, FontService as g, FontEmbeddingPolicy as h, isLocalDocument as i, PageMeasureService as j, EventOrigin as k, PieceInfoUpdateResult as l, DocumentFontSettings as m, isLocalEngine as n, DocumentActionsService as nt, isLocalPage as o, PieceInfoSnapshot as p, snapAppearanceScale as q, LocalDocumentHandle as r, PieceInfoDeleteResult as s, LocalEngine as t, DocumentAnnotationsService as tt, PieceInfoEntry as u, EngineFactory as v, subscribeToType as w, CallPriority as x, DocumentHandle as y, MetadataService as z };
-//# sourceMappingURL=LocalEngine-DFoBm4B3.d.cts.map
+export { OutlineCreateOptions as $, PageHandle as A, CustomMetadataService as B, DocumentEventStream as C, DocumentEventOf as D, DocumentEventInit as E, LocalPageFormsService as F, EngineRenderPolicy as G, DocumentSearchService as H, PageFormsService as I, snapFullPageViewport as J, appearanceLatticeScale as K, LocalPageAnnotationsService as L, PageTextService as M, LocalPageRenderService as N, DocumentEventType as O, PageRenderService as P, DocumentOutlineService as Q, PageAnnotationsService as R, WorkingSetPage as S, DocumentEvent as T, CONTINUOUS_RENDER_POLICY as U, DocumentSignaturesService as V, DocumentRenderService as W, DocumentRedactionService as X, snapTileScale as Y, DocumentPagesService as Z, Engine as _, LocalPageHandle as a, CallFacts as b, PieceInfoService as c, PieceInfoPatch as d, DocumentFormsService as et, PieceInfoPatchValue as f, FontService as g, FontEmbeddingPolicy as h, isLocalDocument as i, DocumentActionsService as it, PageMeasureService as j, EventOrigin as k, PieceInfoUpdateResult as l, DocumentFontSettings as m, isLocalEngine as n, DocumentAttachmentsService as nt, isLocalPage as o, PieceInfoSnapshot as p, snapAppearanceScale as q, LocalDocumentHandle as r, DocumentAnnotationsService as rt, PieceInfoDeleteResult as s, LocalEngine as t, FormRepairOptions as tt, PieceInfoEntry as u, EngineFactory as v, subscribeToType as w, CallPriority as x, DocumentHandle as y, MetadataService as z };
+//# sourceMappingURL=LocalEngine-DBt2-GWF.d.ts.map

package/dist/{LocalEngine-DPriFujS.d.ts → LocalEngine-IA9zh3Jh.d.cts}

@@ -1,5 +1,5 @@
-import { $c as FormMutationMeta, $f as DownloadOptions, $h as SignatureCompleteResult, $l as PageFlattenResult, $n as PageDeleteResult, Aa as FormFieldValue, Bh as BaseVersionInfo, Bl as AnnotationImportResult, Bu as AttachmentContent, Dl as WidgetPatch, Gl as FormFieldCreateOptions, Gn as RedactionApplyResult, Gu as AttachmentRef, Hl as AnnotationCreateOptions, Ho as SearchSlice, I_ as DocumentActionsSnapshot, Jf as FontHandle, Jl as WriteOptions, Jm as CustomMetadata, Kl as FormWidgetAddOptions, Kn as RedactionApplyScope, Ko as TextLayout, Mc as AttachmentDeleteResult, Md as AnnotationResourceRole, Mi as FormSubmissionReceipt, Ng as PageBox, Np as TextRange, P_ as AbortablePromise, Pa as FormFieldPatch, Pi as FormSubmissionRequest, Qc as FormFieldUpdateResult, Qh as SignatureCompleteInput, Qn as PageInsertResult, Qp as PageRenderImage, Rc as FormImportOptions, Sa as CustomMetadataUpdateResult, To as WidgetPlacement, Uc as FormValuesImportOptions, Ul as AnnotationUpdateOptions, Up as PageImageOptions, Uu as AttachmentFileSource, Vh as DigestAlgorithm, Vm as PageListSnapshot, Vo as SearchRequest, Wc as FormValuesImportResult, Wl as FlattenWriteOptions, Wu as AttachmentList, Xc as FormFieldCreateResult, Xf as FontKey, Xh as SignatureAppearanceInput, Xm as OpenInput, Yc as FormCalculationsReorderResult, Yg as PdfRotation, Ym as MetadataPatch, Zc as FormFieldDeleteResult, Zf as FontSpec, Zg as FormFieldRef, Zh as SignatureCancelResult, Zi as Change, Zn as PageInsertBlankSpec, _a as PagePosition, _g as FormFieldDTO, _v as DocumentMetadata, ah as OpenOptions, al as FormWidgetRestoreResult, ap as AnnotationAppearanceImageOptions, au as AnnotationUpdateResult, bs as AnnotationDraft, bv as IsoDateTime, cg as SignatureSnapshot, cl as FormWidgetsReorderResult, cr as PageNameInput, dp as AnnotationAppearancesResult, ef as ObjectNumberPool, el as FormRepairResult, em as PageRenderOptions, fg as MutationMeta, fl as FormExportSelection, gl as FormSnapshot, gu as AnnotationExportSelection, ha as FieldPosition, hd as PdfMeasure, hi as ChangeAnalysis, hn as PageScaleResult, hu as AnnotationListMutationMeta, ig as SignaturePrepared, il as FormWidgetLinkResult, im as PageRenderViewport, iu as AnnotationReorderResult, jc as AttachmentCreateResult, lp as AnnotationAppearanceRenderOptions, lr as PageRemoveNameInput, ma as AnnotationPosition, n as AnnotationListOptions, na as ChangeResult, nl as FormSetValueResult, nm as PageRenderRaster, nu as AnnotationCreateResult, o_ as AnnotationRef, op as AnnotationAppearanceImagesResult, or as AnnotationFlattenResult, pa as MetadataUpdateResult, pd as PageMeasurementViewportList, pi as AnalyzeInput, ql as PageInsertBlankOptions, qm as CustomMetadataPatch, rg as SignaturePrepareInput, rl as FormWidgetDeleteResult, ru as AnnotationDeleteResult, sl as FormWidgetUpdateResult, sr as PageNameResult, t as AnnotationList, tl as FormResetResult, tr as PageRotateResult, tu as PageFlattenUsage, ur as PageReorderResult, uv as PageRef, vl as FormBundle, vo as FormFieldDraft, vs as Annotation, vu as AnnotationBundle, wl as WidgetAnnotation, wp as PageTextSnapshot, xs as AnnotationPatch, zc as FormImportResult, zl as AnnotationImportOptions } from "./AnnotationList-CkijRHet.js";
-import { c as DocumentSecurityService } from "./DocumentSecurityService-CU1M6Q7m.js";
+import { $g as MutationMeta, $l as AnnotationImportResult, $u as AttachmentRef, Ah as OutlineItemRef, Ba as FormFieldValue, Bd as AnnotationResourceRole, Bg as SignatureCompleteResult, Bl as WidgetPatch, Bo as WidgetPlacement, Ca as AnnotationPosition, Cd as PdfMeasure, Cu as AnnotationExportSelection, Cv as DocumentActionsSnapshot, Da as PagePosition, Dg as BaseVersionInfo, Ea as OutlinePosition, Ei as FormSubmissionReceipt, Fs as AnnotationDraft, Gg as SignaturePrepared, Gi as Change, Gn as RedactionApplyResult, I_ as PdfRotation, Is as AnnotationPatch, Kc as AttachmentRestoreResult, Kh as OpenOptions, Kn as RedactionApplyScope, Kp as TextRange, Lg as SignatureAppearanceInput, Lh as OpenInput, Ll as WidgetAnnotation, Lp as PageTextSnapshot, Ma as CustomMetadataUpdateResult, Mm as PageFlattenResult, No as FormFieldDraft, Ns as Annotation, Og as DigestAlgorithm, Oh as OutlineItemDraft, Oi as FormSubmissionRequest, Pm as PageFlattenUsage, Qc as FormImportResult, Ql as AnnotationImportOptions, Qu as AttachmentList, R_ as FormFieldRef, Rg as SignatureCancelResult, Sa as MetadataUpdateResult, Su as AnnotationListMutationMeta, Th as DocumentOutline, Tl as FormExportSelection, Tp as PageExtractOptions, Tu as AnnotationBundle, Uc as AttachmentCreateResult, Wa as FormFieldPatch, Wc as AttachmentDeleteResult, Wg as SignaturePrepareInput, Xi as ChangeResult, Yg as SignatureSnapshot, Zc as FormImportOptions, Zu as AttachmentFileSource, Zv as PageRef, _l as FormWidgetLinkResult, _p as AnnotationAppearanceRenderOptions, ap as FontSpec, au as FormWidgetAddOptions, b_ as PageBox, ba as OutlineUpdateResult, bh as CustomMetadata, bl as FormWidgetUpdateResult, bm as PageRenderViewport, ca as PageRestoreResult, cf as ObjectNumberPool, cl as FormCalculationsReorderResult, dl as FormFieldUpdateResult, du as AnnotationReorderResult, fa as PageInsertBlankSpec, fl as FormMutationMeta, fu as AnnotationUpdateResult, ga as OutlineMoveResult, gl as FormWidgetDeleteResult, gm as PageRenderOptions, ha as OutlineDeleteResult, hl as FormSetValueResult, hn as PageScaleResult, i_ as FormFieldDTO, im as PageImageOptions, ip as FontKey, ir as PageRemoveNameInput, iu as FormFieldCreateOptions, iy as DocumentMetadata, jl as FormBundle, kh as OutlineItemPatch, kl as FormSnapshot, la as PageReorderResult, li as ChangeAnalysis, ll as FormFieldCreateResult, lu as AnnotationCreateResult, ma as OutlineCreateResult, ml as FormResetResult, mm as PageRenderImage, mp as AnnotationAppearanceImagesResult, n as AnnotationListOptions, nl as FormValuesImportOptions, np as FontHandle, nr as PageNameResult, ns as SearchRequest, nu as AnnotationUpdateOptions, ou as PageInsertBlankOptions, pa as PageDeleteResult, ph as PageListSnapshot, pl as FormRepairResult, pp as AnnotationAppearanceImageOptions, q_ as AnnotationRef, rl as FormValuesImportResult, rr as PageNameInput, rs as SearchSlice, ru as FlattenWriteOptions, sa as PageRotateResult, si as AnalyzeInput, sp as DownloadOptions, ss as TextLayout, su as WriteOptions, sy as IsoDateTime, t as AnnotationList, tr as AnnotationFlattenResult, tu as AnnotationCreateOptions, ua as PageInsertResult, ul as FormFieldDeleteResult, uu as AnnotationDeleteResult, vl as FormWidgetRestoreResult, vm as PageRenderRaster, wa as FieldPosition, xd as PageMeasurementViewportList, xh as MetadataPatch, xl as FormWidgetsReorderResult, xv as AbortablePromise, ya as OutlineRestoreResult, yh as CustomMetadataPatch, yp as AnnotationAppearancesResult, zg as SignatureCompleteInput } from "./AnnotationList-DcyhF2kU.cjs";
+import { c as DocumentSecurityService } from "./DocumentSecurityService-D2zA4NKi.cjs";
 //#region src/engine/DocumentActionsService.d.ts
 /** Lazy, catalog-owned PDF action read. This API extracts; it never executes. */
 interface DocumentActionsService {
@@ -50,18 +50,24 @@ interface DocumentAnnotationsService {
  * construction (see the ref's doc comment). `list()` returns metadata only;
  * bytes leave the engine exclusively through {@link download}. The
  * annotation-level counterpart is
- * `PageAnnotationsService.downloadResource(ref, 'file')`.
+ * `PageAnnotationsService.downloadResource(ref, 'file')`, which answers the
+ * same way: the bytes, the name and type being what the listing says.
+ *
+ * `create` and `delete` are each one op of a change (`attachments.create`,
+ * `attachments.delete`): their `opId` undoes them, and an undo of a delete
+ * brings the same file back (`attachments.restored`).
  */
 interface DocumentAttachmentsService {
   /** Snapshot of the `/EmbeddedFiles` name tree, in tree (key-sorted) order. */
   list(): AbortablePromise<AttachmentList>;
   /**
-   * Decode and return one embedded file's bytes plus the metadata needed
-   * to hand it to a user (name, mime type). Throws
-   * `EngineError(NotFound)` when no entry has the ref's key and
-   * `EngineError(InvalidArg)` when the entry has no embedded file stream.
+   * Decode and return one embedded file's bytes. Throws
+   * `EngineError(NotFound)` when no entry has the ref's key,
+   * `EngineError(InvalidArg)` when the entry has no embedded file stream,
+   * and `EngineError(PayloadTooLarge)` when the file decodes to more than
+   * `ATTACHMENT_LIMITS.decodedBytes` on an engine that holds it in memory.
    */
-  download(ref: AttachmentRef): AbortablePromise<AttachmentContent>;
+  download(ref: AttachmentRef): AbortablePromise<Uint8Array>;
   /**
    * Create an embedded file in the name tree. The file's `name` becomes
    * the tree key (`/UF` = `/F` = key); a duplicate key rejects with
@@ -276,6 +282,39 @@ interface DocumentFormsService {
   repair(options?: FormRepairOptions): AbortablePromise<FormRepairResult>;
 }
 //#endregion
+//#region src/engine/DocumentOutlineService.d.ts
+/** Where `create` puts a new item, and the name it gets. */
+interface OutlineCreateOptions extends WriteOptions {
+  /** The item it goes under; the top level when left out or `null`. */
+  parent?: OutlineItemRef | null;
+  /** Its place among `parent`'s children; the end when left out. */
+  position?: OutlinePosition;
+  /** Its object number, taken from `doc.objectNumbers`; the engine picks one when left out. */
+  objectNumber?: number;
+}
+/**
+ * The document's outline (`/Root /Outlines`, the bookmarks). Reading it is
+ * part of opening the document (`doc.open`); writing takes
+ * `doc.outline.modify`. Each write is a one-op change: the same op, checks
+ * and undo as `doc.apply`, its events `outline.*`.
+ */
+interface DocumentOutlineService {
+  /** Every item, depth first. */
+  get(): AbortablePromise<DocumentOutline>;
+  /** A new item; `'outline.create'` in a change. */
+  create(data: OutlineItemDraft, options?: OutlineCreateOptions): AbortablePromise<OutlineCreateResult>;
+  /** Change the fields `patch` names; `'outline.update'` in a change. */
+  update(ref: OutlineItemRef, patch: OutlineItemPatch, options?: WriteOptions): AbortablePromise<OutlineUpdateResult>;
+  /**
+   * Move items, each with the items under it, under `parent` (`null`: the
+   * top level) at `position` among its children; `'outline.move'` in a
+   * change.
+   */
+  move(refs: readonly OutlineItemRef[], parent: OutlineItemRef | null, position: OutlinePosition, options?: WriteOptions): AbortablePromise<OutlineMoveResult>;
+  /** Delete an item and the items under it; `'outline.delete'` in a change. */
+  delete(ref: OutlineItemRef, options?: WriteOptions): AbortablePromise<OutlineDeleteResult>;
+}
+//#endregion
 //#region src/engine/DocumentPagesService.d.ts
 /**
  * Document-scoped page service exposed via `DocumentHandle.pages`.
@@ -289,6 +328,10 @@ interface DocumentFormsService {
  * number) everywhere except `list()`, which exposes display order through
  * `PageLayout.index`. Structure verbs never change the names of the
  * annotations on surviving pages.
+ *
+ * Each structure verb is a one-op change through `doc.apply` (`pageVerbs`):
+ * its `opId` undoes it, and an undo of a delete brings the same pages back
+ * (`pages.restored`).
  */
 interface DocumentPagesService {
   /**
@@ -352,17 +395,25 @@ interface DocumentPagesService {
    * resource. Gated by `doc.download` (it egresses content), not
    * `doc.pages.assemble`.
    *
+   * With `flatten`, the copy is the pages as they draw for its `usage`: the
+   * annotations and form fields painted in, nothing interactive left, layers
+   * in their state for `usage` (`{ usage: 'print' }` is a print copy). It
+   * takes `doc.download` or `doc.download.flattened`, and paints only what
+   * the caller may read; `includeAnnotations` and `includeFormFields` choose
+   * what it paints, and are refused without `flatten`. The copy keeps the
+   * document's title.
+   *
    * Required-parity, delivered: the local engine runs it in the worker,
    * the cloud engine as POST /pages/extract.
    */
-  extract(pages: PageRef[]): AbortablePromise<Uint8Array>;
+  extract(pages: PageRef[], options?: PageExtractOptions): AbortablePromise<Uint8Array>;
   /**
    * Insert every page of a standalone PDF (`bytes`) at `position`
    * (default `'end'`). The pages are copied in; the inserted copies get
    * fresh object numbers, returned in insertion order. Bytes are a call
    * argument (the same law as annotation binaries): the local engine
-   * transfers them to its worker, the cloud engine ships them as a
-   * multipart mutation (POST /pages/insert).
+   * transfers them to its worker, the cloud engine ships them as a part of
+   * its change request.
    *
    * Required-parity, delivered — a cloud viewer must be able to add pages,
    * so this is a mandatory member: any engine implements it or is not a
@@ -373,9 +424,9 @@ interface DocumentPagesService {
    * Create `spec.count` (default 1) blank pages of `spec.size` (PDF points)
    * at `position` (default `'end'`). The blank-page sibling of `insert`:
    * same gate (`doc.pages.assemble`), same result shape, same
-   * `pages.inserted` event — it is a separate verb because its wire is pure
-   * parameters where `insert`'s is a binary payload (cloud: JSON
-   * POST /pages/insert-blank). Every pre-existing page keeps its identity.
+   * `pages.inserted` event — it is a separate verb because it takes pure
+   * parameters where `insert` takes a binary payload. Every pre-existing
+   * page keeps its identity.
    * Mandatory, like `insert`.
    *
    * `options.objectNumbers` names the new pages, one number per page in
@@ -944,7 +995,12 @@ type DocumentEvent = ({
 } & PageDeleteResult) | ({
   type: 'pages.inserted';
   origin: EventOrigin;
-} & PageInsertResult) | ({
+} & PageInsertResult) |
+/** An undo brought deleted pages back, or a redo brought inserted pages back. */
+({
+  type: 'pages.restored';
+  origin: EventOrigin;
+} & PageRestoreResult) | ({
   type: 'pages.named';
   /** The decoded key that was registered, renamed, or removed. */
   name: string;
@@ -959,13 +1015,39 @@ type DocumentEvent = ({
   origin: EventOrigin;
   /** What was deleted (see `deletedAttachmentOf`). */
   deleted: AttachmentRef | null;
-} & AttachmentDeleteResult) | ({
+} & AttachmentDeleteResult) |
+/** An undo brought a deleted file back, under the key it had. */
+({
+  type: 'attachments.restored';
+  origin: EventOrigin;
+} & AttachmentRestoreResult) | ({
   type: 'metadata.updated';
   origin: EventOrigin;
 } & MetadataUpdateResult) | ({
   type: 'metadata.customUpdated';
   origin: EventOrigin;
 } & CustomMetadataUpdateResult) | ({
+  type: 'outline.created';
+  origin: EventOrigin;
+} & OutlineCreateResult) | ({
+  type: 'outline.updated';
+  origin: EventOrigin;
+} & OutlineUpdateResult) | ({
+  type: 'outline.moved';
+  origin: EventOrigin;
+} & OutlineMoveResult) | ({
+  type: 'outline.deleted';
+  origin: EventOrigin;
+  /** What was deleted: the item first, then the items under it (see `deletedOutlineItemsOf`). */
+  deleted: OutlineItemRef[];
+} & OutlineDeleteResult) | ({
+  /**
+   * An undo brought deleted outline items back: the same items, under the
+   * refs they had, at the place the item had among its parent's children.
+   */
+  type: 'outline.restored';
+  origin: EventOrigin;
+} & OutlineRestoreResult) | ({
   type: 'forms.valueSet';
   origin: EventOrigin;
 } & FormSetValueResult) | ({
@@ -1173,6 +1255,8 @@ interface DocumentHandle {
   readonly attachments: DocumentAttachmentsService;
   /** The document's interactive form (AcroForm): fields, values, interchange. */
   readonly forms: DocumentFormsService;
+  /** The document's outline (`/Root /Outlines`, the bookmarks): its items, read and written. */
+  readonly outline: DocumentOutlineService;
   /** Document text search: budgeted, cursor-resumable slices. */
   readonly search: DocumentSearchService;
   /**
@@ -1561,5 +1645,5 @@ interface LocalEngine extends Engine {
 /** Whether `engine` is the local engine, with its fonts and `warmup()`. */
 declare function isLocalEngine(engine: Engine): engine is LocalEngine;
 //#endregion
-export { FormRepairOptions as $, PageHandle as A, CustomMetadataService as B, DocumentEventStream as C, DocumentEventOf as D, DocumentEventInit as E, LocalPageFormsService as F, EngineRenderPolicy as G, DocumentSearchService as H, PageFormsService as I, snapFullPageViewport as J, appearanceLatticeScale as K, LocalPageAnnotationsService as L, PageTextService as M, LocalPageRenderService as N, DocumentEventType as O, PageRenderService as P, DocumentFormsService as Q, PageAnnotationsService as R, WorkingSetPage as S, DocumentEvent as T, CONTINUOUS_RENDER_POLICY as U, DocumentSignaturesService as V, DocumentRenderService as W, DocumentRedactionService as X, snapTileScale as Y, DocumentPagesService as Z, Engine as _, LocalPageHandle as a, CallFacts as b, PieceInfoService as c, PieceInfoPatch as d, DocumentAttachmentsService as et, PieceInfoPatchValue as f, FontService as g, FontEmbeddingPolicy as h, isLocalDocument as i, PageMeasureService as j, EventOrigin as k, PieceInfoUpdateResult as l, DocumentFontSettings as m, isLocalEngine as n, DocumentActionsService as nt, isLocalPage as o, PieceInfoSnapshot as p, snapAppearanceScale as q, LocalDocumentHandle as r, PieceInfoDeleteResult as s, LocalEngine as t, DocumentAnnotationsService as tt, PieceInfoEntry as u, EngineFactory as v, subscribeToType as w, CallPriority as x, DocumentHandle as y, MetadataService as z };
-//# sourceMappingURL=LocalEngine-DPriFujS.d.ts.map
+export { OutlineCreateOptions as $, PageHandle as A, CustomMetadataService as B, DocumentEventStream as C, DocumentEventOf as D, DocumentEventInit as E, LocalPageFormsService as F, EngineRenderPolicy as G, DocumentSearchService as H, PageFormsService as I, snapFullPageViewport as J, appearanceLatticeScale as K, LocalPageAnnotationsService as L, PageTextService as M, LocalPageRenderService as N, DocumentEventType as O, PageRenderService as P, DocumentOutlineService as Q, PageAnnotationsService as R, WorkingSetPage as S, DocumentEvent as T, CONTINUOUS_RENDER_POLICY as U, DocumentSignaturesService as V, DocumentRenderService as W, DocumentRedactionService as X, snapTileScale as Y, DocumentPagesService as Z, Engine as _, LocalPageHandle as a, CallFacts as b, PieceInfoService as c, PieceInfoPatch as d, DocumentFormsService as et, PieceInfoPatchValue as f, FontService as g, FontEmbeddingPolicy as h, isLocalDocument as i, DocumentActionsService as it, PageMeasureService as j, EventOrigin as k, PieceInfoUpdateResult as l, DocumentFontSettings as m, isLocalEngine as n, DocumentAttachmentsService as nt, isLocalPage as o, PieceInfoSnapshot as p, snapAppearanceScale as q, LocalDocumentHandle as r, DocumentAnnotationsService as rt, PieceInfoDeleteResult as s, LocalEngine as t, FormRepairOptions as tt, PieceInfoEntry as u, EngineFactory as v, subscribeToType as w, CallPriority as x, DocumentHandle as y, MetadataService as z };
+//# sourceMappingURL=LocalEngine-IA9zh3Jh.d.cts.map