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

package/dist/wire.d.cts

@@ -1,5 +1,5 @@
-import { $ as CaretDraftSchema, $c as StandardFont, $r as FormEffectsResult, $t as CircleDraftSchema, A as FileAttachmentWireDraftSchema, Aa as AttachmentDeleteResult, Ai as FormFieldOption, Ar as SearchSnippet, Bc as CaretIntent, Bi as FormFieldRef, Bs as PageBoxes, D as FileAttachmentDTOSchema, Di as FormFieldDTO, Dn as HighlightPatchSchema, Dr as SearchRequest, Dt as LinePatchSchema, En as HighlightDraftSchema, Er as SearchQuery, Et as LineDraftSchema, F as StampDTOSchema, Fn as RedactionApplyScope, G as TextDTOSchema, Gc as LineEnding, Gi as AnnotationDeleteResult, Gn as PageDeleteResult, Go as PageState, Gr as FormFieldUpdateResult, Ho as AnnotationAppearanceRenderOptions, I as StampWireDraftSchema, Ic as AnnotationBorderStyle, Io as AnnotationAppearanceImageOptions, Ja as AttachmentFileInfo, Jc as PdfRectDifferences, Jn as PageRotateInput, Jr as FormSetValueResult, Jt as SquarePatchSchema, K as TextDraftSchema, Kc as LineEndings, Ki as AnnotationMoveResult, Kn as PageDeleteInput, Kr as FormImportResult, Kt as SquareDTOSchema, L as StampWirePatchSchema, Lc as AnnotationFlags, Li as ToggleFieldWidget, Ln as PageFlattenInput, Lt as PolygonDTOSchema, Mc as RevisionToken, Mn as MetadataUpdateResult, Mt as PolylineDraftSchema, No as PdfSaveMode, Nt as PolylinePatchSchema, O as FileAttachmentIconSchema, Or as SearchSlice, P as ResourceRefSchema, Pn as RedactionApplyResult, Po as CachePins, Q as CaretDTOSchema, Qn as PageMoveInput, Qo as PageImageOptions, Qt as CircleDTOSchema, Ro as AnnotationAppearanceManifest, Rt as PolygonDraftSchema, Sc as DocCapability, Tn as HighlightDTOSchema, To as SerializedEngineError, Tt as LineDTOSchema, Uc as FreeTextIntent, Uo as AnnotationAppearancesQuery, Ur as FormFieldCreateResult, Us as MetadataPatch, Vc as Color, Vi as FormWidgetRef, Vs as PageLayout, W as NoteIconSchema, Wc as InkIntent, Wi as AnnotationCreateResult, Wn as PageInsertResult, Wr as FormFieldDeleteResult, Xa as EmbeddedFileItem, Xi as AppearanceOutcome, Xn as PageMoveResult, Xr as FormEffect, Yr as FormWidgetLinkResult, Za as EmbeddedFileRef, Zn as PageStructureCache, _ as UnsupportedPatchSchema, _i as FormKind, _t as LinkDraftSchema, a as AnnotationDTOSchema, aa as CacheDelta, ai as FormFieldPatch, al as LinePoints, at as FreeTextDraftSchema, bi as WidgetAppearanceSchema, bl as PdfPageActions, bn as UnderlineDraftSchema, bo as AnnotationStableId, bs as PageTextSnapshot, bt as PdfLinkTargetSchema, cl as PdfRect, cn as StrikeoutDraftSchema, da as ManifestPage, di as FormFieldDraft, dt as InkDraftSchema, el as StrikeoutIntent, en as CirclePatchSchema, et as CaretPatchSchema, f as KIND_BY_SUBTYPE, fa as LayerScopePlane, fi as FormFieldOptionInput, fl as DocumentActionsSnapshot, ft as InkPatchSchema, g as UnsupportedDraftSchema, gi as WidgetPlacement, gt as LinkDTOSchema, h as UnsupportedDTOSchema, hl as PdfActionTree, hn as SquigglyPatchSchema, ia as RefetchReason, it as FreeTextDTOSchema, j as WireAttachmentFileSchema, ja as AttachmentsCache, jc as AnnotationRef, jt as PolylineDTOSchema, k as FileAttachmentPatchSchema, ka as AttachmentCreateResult, kc as PdfBits, ki as FormFieldFlags, kr as SearchSliceBudget, ll as PdfRotation, ln as StrikeoutPatchSchema, ml as PdfActionNode, mn as SquigglyDraftSchema, n as AnnotationListSnapshotAllPages, ni as FormFieldValue, nl as CalloutLine, oa as MutationMeta, ol as PdfPoint, os as PageRenderOptions, ot as FreeTextPatchSchema, pa as LayerScopes, pn as SquigglyDTOSchema, ps as PageGeometrySnapshot, q as TextPatchSchema, qi as AnnotationUpdateResult, qn as PageRotateResult, qr as FormRepairResult, qt as SquareDraftSchema, r as ANNOTATION_KINDS, ra as AnnotationListMutationMeta, rl as InkList, s as AnnotationDraftSchema, sl as PdfQuad, sn as StrikeoutDTOSchema, ss as PageRenderQuery, t as AnnotationListPageSnapshot, ti as FormDataFormat, tl as TextAlignment, ts as PageNetworkRenderFormat, u as AnnotationPatchSchema, ua as DocumentManifest, ul as PdfSize, ut as InkDTOSchema, vi as FormSnapshot, vl as PdfAnnotationActions, vt as LinkPatchSchema, wr as SearchMatch, xl as DocumentMetadata, xn as UnderlinePatchSchema, xt as PdfLinkTargetWritableSchema, yl as PdfFieldActions, yn as UnderlineDTOSchema, yt as PdfDestinationSchema, zc as BlendMode, zi as FormValueEntry, zn as PageFlattenResult, zs as PageListSnapshot, zt as PolygonPatchSchema } from "./AnnotationListSnapshot-DDxHpJQU.cjs";
-import { c as DocumentSecurityState, f as PdfPermissionInfo } from "./DocumentSecurityService-BV4_YXkU.cjs";
+import { $ as CaretDraftSchema, $c as Color, $i as FormFieldRef, $n as PageNameResult, $r as FormImportResult, $s as PageLayout, $t as CircleDraftSchema, A as FileAttachmentWireDraftSchema, Ai as FormKind, Bi as FormFieldDTO, Bl as DocumentMetadata, Bn as PageDeleteResult, Ca as ManifestPage, D as FileAttachmentDTOSchema, Dl as PdfActionTargetRef, Dn as HighlightPatchSchema, Dt as LinePatchSchema, El as PdfActionNode, En as HighlightDraftSchema, Et as LineDraftSchema, F as StampDTOSchema, Fn as RedactionApplyScope, Fr as SearchSlice, G as TextDTOSchema, Gc as AnnotationRef, Gn as AnnotationFlattenInput, Go as PdfSaveMode, Ha as AttachmentDeleteResult, Hi as FormFieldFlags, Hn as PageRotateResult, I as StampWireDraftSchema, Ic as DocCapability, Ir as SearchSliceBudget, Jc as AnnotationBorderStyle, Jn as PageFlattenInput, Jo as AnnotationAppearanceImageOptions, Jt as SquarePatchSchema, K as TextDraftSchema, Kc as RevisionToken, Ko as CachePins, Kt as SquareDTOSchema, L as StampWirePatchSchema, Ll as PdfDestination, Lo as SerializedEngineError, Lr as SearchSnippet, Lt as PolygonDTOSchema, Mn as MetadataUpdateResult, Mo as AnnotationStableId, Ms as PageTextSnapshot, Mt as PolylineDraftSchema, Ni as WidgetAppearanceSchema, Nr as SearchQuery, Nt as PolylinePatchSchema, O as FileAttachmentIconSchema, Ol as PdfActionTree, P as ResourceRefSchema, Pn as RedactionApplyResult, Pr as SearchRequest, Q as CaretDTOSchema, Qc as CaretIntent, Qi as FormValueEntry, Qr as FormFieldUpdateResult, Qs as PageBoxes, Qt as CircleDTOSchema, Rt as PolygonDraftSchema, Sa as DocumentManifest, Sl as PdfSize, Ta as LayerScopes, Ti as FormFieldOptionInput, Tn as HighlightDTOSchema, Ts as PageGeometrySnapshot, Tt as LineDTOSchema, Ua as AttachmentsCache, Uc as PdfBits, Ui as FormFieldOption, Un as PageRotateInput, Va as AttachmentCreateResult, Vn as PageDeleteInput, W as NoteIconSchema, Wn as AnnotationAppearanceExportInput, Xi as ToggleFieldWidget, Xn as PageFlattenResult, Xo as AnnotationAppearanceManifest, Xr as FormFieldCreateResult, Yc as AnnotationFlags, Zc as BlendMode, Zr as FormFieldDeleteResult, Zs as PageListSnapshot, _ as UnsupportedPatchSchema, _a as RefetchReason, _l as LinePoints, _t as LinkDraftSchema, a as AnnotationDTOSchema, aa as AnnotationMoveResult, ar as PageMoveInput, at as FreeTextDraftSchema, bl as PdfRect, bn as UnderlineDraftSchema, bt as PdfLinkTargetWritableSchema, cn as StrikeoutDraftSchema, co as EmbeddedFileItem, di as FormSubmissionReceiptSchema, dl as StandardFont, dt as InkDraftSchema, ea as FormWidgetRef, ei as FormRepairResult, en as CirclePatchSchema, er as PageNameInput, es as AnnotationAppearanceRenderOptions, et as CaretPatchSchema, f as KIND_BY_SUBTYPE, fl as StrikeoutIntent, ft as InkPatchSchema, g as UnsupportedDraftSchema, ga as AnnotationListMutationMeta, gt as LinkDTOSchema, h as UnsupportedDTOSchema, hi as FormFieldValue, hl as InkList, hn as SquigglyPatchSchema, ia as AnnotationDeleteResult, il as LineEndings, ir as PageStructureCache, it as FreeTextDTOSchema, j as WireAttachmentFileSchema, ji as FormSnapshot, jr as SearchMatch, jt as PolylineDTOSchema, k as FileAttachmentPatchSchema, ki as WidgetPlacement, kl as PdfActionType, la as AppearanceOutcome, li as FormSubmissionEntrySchema, ln as StrikeoutPatchSchema, lo as EmbeddedFileRef, mi as FormDataFormat, ml as CalloutLine, mn as SquigglyDraftSchema, n as AnnotationListSnapshotAllPages, ni as FormWidgetLinkResult, nl as InkIntent, oa as AnnotationUpdateResult, oi as FormEffectsResult, ol as PdfRectDifferences, oo as AttachmentFileInfo, ot as FreeTextPatchSchema, pi as FormSubmissionRequestSchema, pl as TextAlignment, pn as SquigglyDTOSchema, ps as PageNetworkRenderFormat, q as TextPatchSchema, qn as AnnotationFlattenResult, qt as SquareDraftSchema, r as ANNOTATION_KINDS, ra as AnnotationCreateResult, rc as MetadataPatch, ri as FormEffect, rl as LineEnding, rr as PageMoveResult, rs as PageState, s as AnnotationDraftSchema, sn as StrikeoutDTOSchema, t as AnnotationListPageSnapshot, tc as NamedPageEntry, ti as FormSetValueResult, tl as FreeTextIntent, tr as PageRemoveNameInput, ts as AnnotationAppearancesQuery, u as AnnotationPatchSchema, us as PageImageOptions, ut as InkDTOSchema, va as CacheDelta, vi as FormFieldPatch, vl as PdfPoint, vs as PageRenderOptions, vt as LinkPatchSchema, wa as LayerScopePlane, wi as FormFieldDraft, wl as DocumentActionsSnapshot, xl as PdfRotation, xn as UnderlinePatchSchema, xt as PdfDestinationSchema, ya as MutationMeta, yl as PdfQuad, yn as UnderlineDTOSchema, ys as PageRenderQuery, yt as PdfLinkTargetSchema, zn as PageInsertResult, zt as PolygonPatchSchema } from "./AnnotationListSnapshot-x6tKulNV.cjs";
+import { c as DocumentSecurityState, f as PdfPermissionInfo } from "./DocumentSecurityService-CK0pejAK.cjs";
 import { z } from "zod";
 //#region src/geometry/schemas.d.ts
 declare const PdfPointSchema: z.ZodType<PdfPoint>;
@@ -630,6 +630,12 @@ declare const PageBoxesSchema: z.ZodType<PageBoxes>;
  */
 declare const PageLayoutSchema: z.ZodType<PageLayout>;
 declare const PageFlattenResultSchema: z.ZodType<PageFlattenResult>;
+/** See `AnnotationFlattenResult`. */
+declare const AnnotationFlattenResultSchema: z.ZodType<AnnotationFlattenResult>;
+/** `annotations.flatten` input — see `AnnotationFlattenInput`. */
+declare const AnnotationFlattenInputSchema: z.ZodType<AnnotationFlattenInput>;
+/** `annotations.exportAppearance` input — see `AnnotationAppearanceExportInput`. */
+declare const AnnotationAppearanceExportInputSchema: z.ZodType<AnnotationAppearanceExportInput>;
 declare const PageFlattenInputSchema: z.ZodType<PageFlattenInput>;
 declare const RedactionApplyScopeSchema: z.ZodType<RedactionApplyScope>;
 declare const RedactionApplyResultSchema: z.ZodType<RedactionApplyResult>;
@@ -638,7 +644,13 @@ declare const RedactionApplyResultSchema: z.ZodType<RedactionApplyResult>;
  * `pageObjectNumber` everywhere except the per-element `index`, which is
  * display order and intentionally not an identity. Carries geometry only.
  */
+/** See `NamedPageEntry`: decoded key + what it resolves to. */
+declare const NamedPageEntrySchema: z.ZodType<NamedPageEntry>;
 declare const PageListSnapshotSchema: z.ZodType<PageListSnapshot>;
+/** `pages.setName` input — see `PageNameInput`. */
+declare const PageNameInputSchema: z.ZodType<PageNameInput>;
+/** `pages.removeName` input — see `PageRemoveNameInput`. */
+declare const PageRemoveNameInputSchema: z.ZodType<PageRemoveNameInput>;
 /**
  * Page reorder input. Pages are always addressed by `pageObjectNumber`;
  * `destIndex` is the insertion point in the post-removal index space.
@@ -655,6 +667,8 @@ declare const PageStructureCacheSchema: z.ZodType<PageStructureCache>;
  * post-move order is returned so callers can swap their snapshot directly.
  */
 declare const PageMoveResultSchema: z.ZodType<PageMoveResult>;
+/** Named-page mutation result — layout-shaped, see `PageNameResult`. */
+declare const PageNameResultSchema: z.ZodType<PageNameResult>;
 /**
  * Page rotate input. ABSOLUTE rotation (idempotent — see `PageRotateInput`),
  * one value applied to every listed page.
@@ -741,13 +755,150 @@ declare const WeakAnnotationSessionPagesRequestSchema: z.ZodObject<{
 type WeakAnnotationSessionPagesRequest = z.infer<typeof WeakAnnotationSessionPagesRequestSchema>;
 //#endregion
 //#region src/dto/PdfAction.schema.d.ts
-declare const PdfActionTypeSchema: z.ZodEnum<["unknown", "goto", "goto-remote", "goto-embedded", "launch", "thread", "uri", "sound", "movie", "hide", "named", "submit-form", "reset-form", "import-data", "javascript", "set-ocg-state", "rendition", "transition", "goto-3d-view"]>;
+declare const PdfActionTargetRefSchema: z.ZodType<PdfActionTargetRef>;
 declare const PdfActionNodeSchema: z.ZodType<PdfActionNode>;
+/** The `/S` vocabulary, derived from the union arms so it cannot drift. */
+declare const PdfActionTypeSchema: z.ZodType<PdfActionType>;
 declare const PdfActionTreeSchema: z.ZodType<PdfActionTree>;
-declare const PdfFieldActionsSchema: z.ZodType<PdfFieldActions>;
-declare const PdfPageActionsSchema: z.ZodType<PdfPageActions>;
-declare const PdfAnnotationActionsSchema: z.ZodType<PdfAnnotationActions>;
+declare const PdfFieldActionsSchema: z.ZodObject<{
+  keystroke: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  format: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  validate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  calculate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+}, "strip", z.ZodTypeAny, {
+  keystroke?: PdfActionTree | undefined;
+  format?: PdfActionTree | undefined;
+  validate?: PdfActionTree | undefined;
+  calculate?: PdfActionTree | undefined;
+}, {
+  keystroke?: PdfActionTree | undefined;
+  format?: PdfActionTree | undefined;
+  validate?: PdfActionTree | undefined;
+  calculate?: PdfActionTree | undefined;
+}>;
+declare const PdfPageActionsSchema: z.ZodObject<{
+  open: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  close: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+}, "strip", z.ZodTypeAny, {
+  open?: PdfActionTree | undefined;
+  close?: PdfActionTree | undefined;
+}, {
+  open?: PdfActionTree | undefined;
+  close?: PdfActionTree | undefined;
+}>;
+declare const PdfAnnotationActionsSchema: z.ZodObject<{
+  activate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  cursorEnter: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  cursorExit: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  mouseDown: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  mouseUp: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  focus: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  blur: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  pageOpen: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  pageClose: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  pageVisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  pageInvisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+}, "strip", z.ZodTypeAny, {
+  activate?: PdfActionTree | undefined;
+  cursorEnter?: PdfActionTree | undefined;
+  cursorExit?: PdfActionTree | undefined;
+  mouseDown?: PdfActionTree | undefined;
+  mouseUp?: PdfActionTree | undefined;
+  focus?: PdfActionTree | undefined;
+  blur?: PdfActionTree | undefined;
+  pageOpen?: PdfActionTree | undefined;
+  pageClose?: PdfActionTree | undefined;
+  pageVisible?: PdfActionTree | undefined;
+  pageInvisible?: PdfActionTree | undefined;
+}, {
+  activate?: PdfActionTree | undefined;
+  cursorEnter?: PdfActionTree | undefined;
+  cursorExit?: PdfActionTree | undefined;
+  mouseDown?: PdfActionTree | undefined;
+  mouseUp?: PdfActionTree | undefined;
+  focus?: PdfActionTree | undefined;
+  blur?: PdfActionTree | undefined;
+  pageOpen?: PdfActionTree | undefined;
+  pageClose?: PdfActionTree | undefined;
+  pageVisible?: PdfActionTree | undefined;
+  pageInvisible?: PdfActionTree | undefined;
+}>;
 declare const DocumentActionsSnapshotSchema: z.ZodType<DocumentActionsSnapshot>;
+/**
+ * Stable public component names for generators that project the action wire
+ * model into OpenAPI or another schema format. Keep reusable boundaries here;
+ * individual action arms remain owned by `PdfActionNodeSchema`.
+ */
+declare const PdfActionWireComponents: {
+  readonly PdfActionTargetRef: z.ZodType<PdfActionTargetRef, z.ZodTypeDef, PdfActionTargetRef>;
+  readonly PdfDestination: z.ZodType<PdfDestination, z.ZodTypeDef, PdfDestination>;
+  readonly PdfActionNode: z.ZodType<PdfActionNode, z.ZodTypeDef, PdfActionNode>;
+  readonly PdfActionTree: z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>;
+  readonly PdfFieldActions: z.ZodObject<{
+    keystroke: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    format: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    validate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    calculate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  }, "strip", z.ZodTypeAny, {
+    keystroke?: PdfActionTree | undefined;
+    format?: PdfActionTree | undefined;
+    validate?: PdfActionTree | undefined;
+    calculate?: PdfActionTree | undefined;
+  }, {
+    keystroke?: PdfActionTree | undefined;
+    format?: PdfActionTree | undefined;
+    validate?: PdfActionTree | undefined;
+    calculate?: PdfActionTree | undefined;
+  }>;
+  readonly PdfPageActions: z.ZodObject<{
+    open: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    close: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  }, "strip", z.ZodTypeAny, {
+    open?: PdfActionTree | undefined;
+    close?: PdfActionTree | undefined;
+  }, {
+    open?: PdfActionTree | undefined;
+    close?: PdfActionTree | undefined;
+  }>;
+  readonly PdfAnnotationActions: z.ZodObject<{
+    activate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    cursorEnter: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    cursorExit: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    mouseDown: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    mouseUp: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    focus: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    blur: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageOpen: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageClose: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageVisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageInvisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  }, "strip", z.ZodTypeAny, {
+    activate?: PdfActionTree | undefined;
+    cursorEnter?: PdfActionTree | undefined;
+    cursorExit?: PdfActionTree | undefined;
+    mouseDown?: PdfActionTree | undefined;
+    mouseUp?: PdfActionTree | undefined;
+    focus?: PdfActionTree | undefined;
+    blur?: PdfActionTree | undefined;
+    pageOpen?: PdfActionTree | undefined;
+    pageClose?: PdfActionTree | undefined;
+    pageVisible?: PdfActionTree | undefined;
+    pageInvisible?: PdfActionTree | undefined;
+  }, {
+    activate?: PdfActionTree | undefined;
+    cursorEnter?: PdfActionTree | undefined;
+    cursorExit?: PdfActionTree | undefined;
+    mouseDown?: PdfActionTree | undefined;
+    mouseUp?: PdfActionTree | undefined;
+    focus?: PdfActionTree | undefined;
+    blur?: PdfActionTree | undefined;
+    pageOpen?: PdfActionTree | undefined;
+    pageClose?: PdfActionTree | undefined;
+    pageVisible?: PdfActionTree | undefined;
+    pageInvisible?: PdfActionTree | undefined;
+  }>;
+  readonly DocumentActionsSnapshot: z.ZodType<DocumentActionsSnapshot, z.ZodTypeDef, DocumentActionsSnapshot>;
+};
 //#endregion
 //#region src/forms/schema.d.ts
 declare const FormFieldRefSchema: z.ZodType<FormFieldRef>;
@@ -1050,6 +1201,12 @@ declare const wirePaths: {
   readonly layerPageAnnotationsCreate: (docId: string, layerName: string, pageObjectNumber: number) => string;
   readonly layerAnnotationByKey: (docId: string, layerName: string, pageObjectNumber: number, key: string) => string;
   readonly layerPageAnnotationsMove: (docId: string, layerName: string, pageObjectNumber: number) => string;
+  /** POST: flatten a chosen set of the page's annotations into its content
+   *  (a content + annotation mutation of that page). */
+  readonly layerPageAnnotationsFlatten: (docId: string, layerName: string, pageObjectNumber: number) => string;
+  /** POST: the chosen annotations' appearances as one single-page PDF — a
+   *  derived read (application/pdf, no-store), gated like pages/extract. */
+  readonly layerPageAnnotationsAppearance: (docId: string, layerName: string, pageObjectNumber: number) => string;
   /**
    * GET: the reconciled form snapshot (field tree + widget joins) for the
    * layer's CURRENT state. Forms are document-scoped (one AcroForm per
@@ -1109,6 +1266,11 @@ declare const wirePaths: {
   readonly layerPagesMove: (docId: string, layerName: string) => string;
   readonly layerPagesRotate: (docId: string, layerName: string) => string;
   readonly layerPagesDelete: (docId: string, layerName: string) => string;
+  /** POST: register/rename a `/Names /Pages` entry — a page-STRUCTURE
+   *  mutation (docVersion + layoutVersion advance; reads ride `/layout`). */
+  readonly layerPagesNames: (docId: string, layerName: string) => string;
+  /** POST: remove a `/Names /Pages` entry (the page stays). */
+  readonly layerPagesNamesDelete: (docId: string, layerName: string) => string;
   readonly layerPagesFlatten: (docId: string, layerName: string) => string;
   /**
    * POST (multipart mutation envelope): copy every page of the `source`
@@ -1161,6 +1323,8 @@ declare const wireTemplates: {
   readonly layerAnnotationItemsAll: "/v1/docs/:docId/layers/:layerName/annotations/items";
   readonly layerAnnotationItems: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items";
   readonly layerAnnotationItem: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey";
+  readonly layerAnnotationItemsFlatten: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/flatten";
+  readonly layerAnnotationItemsAppearance: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/appearance";
   readonly layerForm: "/v1/docs/:docId/layers/:layerName/form";
   readonly layerFormFieldValue: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/value";
   readonly layerFormFieldReset: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/reset";
@@ -1168,6 +1332,8 @@ declare const wireTemplates: {
   readonly layerPagesMove: "/v1/docs/:docId/layers/:layerName/pages/move";
   readonly layerPagesRotate: "/v1/docs/:docId/layers/:layerName/pages/rotate";
   readonly layerPagesDelete: "/v1/docs/:docId/layers/:layerName/pages/delete";
+  readonly layerPagesNames: "/v1/docs/:docId/layers/:layerName/pages/names";
+  readonly layerPagesNamesDelete: "/v1/docs/:docId/layers/:layerName/pages/names/delete";
   readonly layerPagesFlatten: "/v1/docs/:docId/layers/:layerName/pages/flatten";
   readonly layerPagesInsert: "/v1/docs/:docId/layers/:layerName/pages/insert";
   readonly layerPagesInsertBlank: "/v1/docs/:docId/layers/:layerName/pages/insert-blank";
@@ -1604,7 +1770,43 @@ declare const AnnotationBaseShape: {
   readonly groupId: z.ZodOptional<z.ZodString>;
   readonly createdBy: z.ZodOptional<z.ZodString>;
   readonly updatedBy: z.ZodOptional<z.ZodString>;
-  readonly actions: z.ZodOptional<z.ZodType<PdfAnnotationActions, z.ZodTypeDef, PdfAnnotationActions>>;
+  readonly actions: z.ZodOptional<z.ZodObject<{
+    activate: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    cursorEnter: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    cursorExit: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    mouseDown: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    mouseUp: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    focus: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    blur: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageOpen: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageClose: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageVisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+    pageInvisible: z.ZodOptional<z.ZodType<PdfActionTree, z.ZodTypeDef, PdfActionTree>>;
+  }, "strip", z.ZodTypeAny, {
+    activate?: PdfActionTree | undefined;
+    cursorEnter?: PdfActionTree | undefined;
+    cursorExit?: PdfActionTree | undefined;
+    mouseDown?: PdfActionTree | undefined;
+    mouseUp?: PdfActionTree | undefined;
+    focus?: PdfActionTree | undefined;
+    blur?: PdfActionTree | undefined;
+    pageOpen?: PdfActionTree | undefined;
+    pageClose?: PdfActionTree | undefined;
+    pageVisible?: PdfActionTree | undefined;
+    pageInvisible?: PdfActionTree | undefined;
+  }, {
+    activate?: PdfActionTree | undefined;
+    cursorEnter?: PdfActionTree | undefined;
+    cursorExit?: PdfActionTree | undefined;
+    mouseDown?: PdfActionTree | undefined;
+    mouseUp?: PdfActionTree | undefined;
+    focus?: PdfActionTree | undefined;
+    blur?: PdfActionTree | undefined;
+    pageOpen?: PdfActionTree | undefined;
+    pageClose?: PdfActionTree | undefined;
+    pageVisible?: PdfActionTree | undefined;
+    pageInvisible?: PdfActionTree | undefined;
+  }>>;
 };
 /**
  * Annotation-wide fields shared by every Draft. Per-kind draft schemas
@@ -1654,5 +1856,5 @@ declare const AttachmentFileInfoSchema: z.ZodType<AttachmentFileInfo>;
 declare const EmbeddedFileRefSchema: z.ZodType<EmbeddedFileRef>;
 declare const EmbeddedFileItemSchema: z.ZodType<EmbeddedFileItem>;
 //#endregion
-export { ANNOTATION_KINDS, type AccessRequest, AccessRequestSchema, type AccessResponse, AccessResponseSchema, ActionsTokenSchema, AnnotationAppearanceManifestSchema, AnnotationAppearancesQuerySchema, AnnotationAppearancesRenderTokenSchema, AnnotationBaseShape, AnnotationBorderStyleSchema, AnnotationCreateResultSchema, AnnotationDTOSchema, AnnotationDeleteResultSchema, AnnotationDraftBaseShape, AnnotationDraftSchema, AnnotationFlagsPartialSchema, AnnotationFlagsSchema, AnnotationListMutationMetaSchema, AnnotationListPageSnapshotSchema, AnnotationListSnapshotAllPagesSchema, AnnotationMoveResultSchema, AnnotationPatchBaseShape, AnnotationPatchSchema, AnnotationRefSchema, type AnnotationRenderVersion, AnnotationStableIdSchema, AnnotationTokenSchema, AnnotationUpdateResultSchema, AppearanceOutcomeSchema, type ApplyCdnAccessInput, type ApplyCdnAccessResult, AttachmentCreateResultSchema, AttachmentDeleteResultSchema, AttachmentFileInfoSchema, AttachmentsCacheSchema, BlendModeSchema, type CacheDelta, CacheDeltaSchema, CachePinsSchema, CalloutLineSchema, type CapabilityRequirement, CaretDTOSchema, CaretDraftSchema, CaretIntentSchema, CaretPatchSchema, type CdnAccessInfoForApply, type CdnCoverageEntry, CircleDTOSchema, CircleDraftSchema, CirclePatchSchema, ColorSchema, ContentTokenSchema, DEFAULT_LAYER_NAME, DOC_RESOURCES, type DocResourceDescriptor, type DocResourceId, DocTokenSchema, DocumentActionsSnapshotSchema, type DocumentHead, DocumentHeadSchema, type DocumentManifest, DocumentManifestSchema, DocumentMetadataSchema, DocumentSecurityStateSchema, type DownloadToken, EmbeddedFileItemSchema, EmbeddedFileRefSchema, EngineErrorPayloadSchema, FileAttachmentDTOSchema, FileAttachmentIconSchema, FileAttachmentPatchSchema, FileAttachmentWireDraftSchema, FormDataFormatSchema, FormEffectSchema, FormEffectsResultSchema, FormFieldCreateResultSchema, FormFieldDTOSchema, FormFieldDeleteResultSchema, FormFieldDraftSchema, FormFieldFlagsSchema, FormFieldOptionInputSchema, FormFieldOptionSchema, FormFieldPatchSchema, FormFieldRefSchema, FormFieldUpdateResultSchema, FormFieldValueSchema, FormImportResultSchema, FormKindSchema, FormRepairResultSchema, FormSetValueResultSchema, FormSnapshotSchema, FormValueEntrySchema, FormWidgetLinkResultSchema, FormWidgetRefSchema, FreeTextDTOSchema, FreeTextDraftSchema, FreeTextIntentSchema, FreeTextPatchSchema, HighlightDTOSchema, HighlightDraftSchema, HighlightPatchSchema, InkDTOSchema, InkDraftSchema, InkIntentSchema, InkListSchema, InkPatchSchema, KIND_BY_SUBTYPE, type LayerScopePlane, type LayerScopes, LayerScopesSchema, LayoutTokenSchema, LineDTOSchema, LineDraftSchema, LineEndingSchema, LineEndingsSchema, LinePatchSchema, LinePointsSchema, LinkDTOSchema, LinkDraftSchema, LinkPatchSchema, type ManifestPage, ManifestPageSchema, MetadataPatchSchema, MetadataTokenSchema, MetadataUpdateResultSchema, type MutationMeta, MutationMetaSchema, NoteIconSchema, type OpenDocumentResponse, OpenDocumentResponseSchema, PageBoxesSchema, PageDeleteInputSchema, PageDeleteResultSchema, PageExtractInputSchema, PageFlattenInputSchema, PageFlattenResultSchema, PageGeometrySnapshotSchema, PageInsertBlankInputSchema, PageInsertInputSchema, PageInsertResultSchema, PageLayoutSchema, PageListSnapshotSchema, PageMoveInputSchema, PageMoveResultSchema, PageNetworkRenderFormatSchema, PageRenderAnnotatedQuerySchema, PageRenderQuerySchema, PageRotateInputSchema, PageRotateResultSchema, PageStateSchema, PageStructureCacheSchema, PageTextSnapshotSchema, PdfActionNodeSchema, PdfActionTreeSchema, PdfActionTypeSchema, PdfAnnotationActionsSchema, PdfDestinationSchema, PdfFieldActionsSchema, PdfLinkTargetSchema, PdfLinkTargetWritableSchema, PdfPageActionsSchema, PdfPointSchema, PdfQuadSchema, PdfRectDifferencesSchema, PdfRectSchema, PdfRotationSchema, PdfSaveModeSchema, PdfSizeSchema, PointSchema, PolygonDTOSchema, PolygonDraftSchema, PolygonPatchSchema, PolylineDTOSchema, PolylineDraftSchema, PolylinePatchSchema, RectSchema, RedactionApplyResultSchema, RedactionApplyScopeSchema, RefetchReasonSchema, type RenderPolicy, RenderTokenSchema, type RenderVersions, ResourceRefSchema, RevisionTokenSchema, type RouteKind, SEARCH_RESULT_FORMAT, SearchMatchSchema, SearchModeSchema, SearchQuerySchema, SearchRequestSchema, SearchSliceSchema, SearchSnippetSchema, type SearchToken, SearchTokenSchema, SquareDTOSchema, SquareDraftSchema, SquarePatchSchema, SquigglyDTOSchema, SquigglyDraftSchema, SquigglyPatchSchema, StampDTOSchema, StampWireDraftSchema, StampWirePatchSchema, StandardFontSchema, StrikeoutDTOSchema, StrikeoutDraftSchema, StrikeoutIntentSchema, StrikeoutPatchSchema, TextAlignmentSchema, TextDTOSchema, TextDraftSchema, TextPatchSchema, ToggleFieldWidgetSchema, type TokenInput, type TokenQuery, type TokenScalar, type TokenSchema, UnderlineDTOSchema, UnderlineDraftSchema, UnderlinePatchSchema, UnsupportedDTOSchema, UnsupportedDraftSchema, UnsupportedPatchSchema, type WeakAnnotationSessionPagesRequest, WeakAnnotationSessionPagesRequestSchema, type WeakAnnotationSessionResponse, WeakAnnotationSessionResponseSchema, WidgetAppearanceSchema, WidgetPlacementSchema, WireAttachmentFileSchema, type WireFlat, type WireScalar, annotationAppearancesImageOptionsToToken, annotationAppearancesImageOptionsToWire, annotationRenderOptionsFromImageOptions, applyCdnAccess, cdnCoverageForScope, checkResourceAccess, decodeActionsToken, decodeAnnotationAppearancesRenderToken, decodeAnnotationToken, decodeAnnotationsAllToken, decodeAttachmentsToken, decodeContentToken, decodeDocToken, decodeDownloadToken, decodeLayoutToken, decodeMetadataToken, decodeRenderToken, decodeSearchToken, decodeToken, decodeTokenText, encodeActionsToken, encodeAnnotationAppearancesRenderToken, encodeAnnotationToken, encodeAnnotationsAllToken, encodeAttachmentsToken, encodeContentToken, encodeDocToken, encodeDownloadToken, encodeLayoutToken, encodeMetadataToken, encodeRenderToken, encodeSearchToken, encodeToken, encodeTokenText, flatten, pageRenderOptionsFromImageOptions, renderImageOptionsToToken, renderImageOptionsToWire, resolveResourceIdForPath, unflatten, wirePaths, wireTemplates };
+export { ANNOTATION_KINDS, type AccessRequest, AccessRequestSchema, type AccessResponse, AccessResponseSchema, ActionsTokenSchema, AnnotationAppearanceExportInputSchema, AnnotationAppearanceManifestSchema, AnnotationAppearancesQuerySchema, AnnotationAppearancesRenderTokenSchema, AnnotationBaseShape, AnnotationBorderStyleSchema, AnnotationCreateResultSchema, AnnotationDTOSchema, AnnotationDeleteResultSchema, AnnotationDraftBaseShape, AnnotationDraftSchema, AnnotationFlagsPartialSchema, AnnotationFlagsSchema, AnnotationFlattenInputSchema, AnnotationFlattenResultSchema, AnnotationListMutationMetaSchema, AnnotationListPageSnapshotSchema, AnnotationListSnapshotAllPagesSchema, AnnotationMoveResultSchema, AnnotationPatchBaseShape, AnnotationPatchSchema, AnnotationRefSchema, type AnnotationRenderVersion, AnnotationStableIdSchema, AnnotationTokenSchema, AnnotationUpdateResultSchema, AppearanceOutcomeSchema, type ApplyCdnAccessInput, type ApplyCdnAccessResult, AttachmentCreateResultSchema, AttachmentDeleteResultSchema, AttachmentFileInfoSchema, AttachmentsCacheSchema, BlendModeSchema, type CacheDelta, CacheDeltaSchema, CachePinsSchema, CalloutLineSchema, type CapabilityRequirement, CaretDTOSchema, CaretDraftSchema, CaretIntentSchema, CaretPatchSchema, type CdnAccessInfoForApply, type CdnCoverageEntry, CircleDTOSchema, CircleDraftSchema, CirclePatchSchema, ColorSchema, ContentTokenSchema, DEFAULT_LAYER_NAME, DOC_RESOURCES, type DocResourceDescriptor, type DocResourceId, DocTokenSchema, DocumentActionsSnapshotSchema, type DocumentHead, DocumentHeadSchema, type DocumentManifest, DocumentManifestSchema, DocumentMetadataSchema, DocumentSecurityStateSchema, type DownloadToken, EmbeddedFileItemSchema, EmbeddedFileRefSchema, EngineErrorPayloadSchema, FileAttachmentDTOSchema, FileAttachmentIconSchema, FileAttachmentPatchSchema, FileAttachmentWireDraftSchema, FormDataFormatSchema, FormEffectSchema, FormEffectsResultSchema, FormFieldCreateResultSchema, FormFieldDTOSchema, FormFieldDeleteResultSchema, FormFieldDraftSchema, FormFieldFlagsSchema, FormFieldOptionInputSchema, FormFieldOptionSchema, FormFieldPatchSchema, FormFieldRefSchema, FormFieldUpdateResultSchema, FormFieldValueSchema, FormImportResultSchema, FormKindSchema, FormRepairResultSchema, FormSetValueResultSchema, FormSnapshotSchema, FormSubmissionEntrySchema, FormSubmissionReceiptSchema, FormSubmissionRequestSchema, FormValueEntrySchema, FormWidgetLinkResultSchema, FormWidgetRefSchema, FreeTextDTOSchema, FreeTextDraftSchema, FreeTextIntentSchema, FreeTextPatchSchema, HighlightDTOSchema, HighlightDraftSchema, HighlightPatchSchema, InkDTOSchema, InkDraftSchema, InkIntentSchema, InkListSchema, InkPatchSchema, KIND_BY_SUBTYPE, type LayerScopePlane, type LayerScopes, LayerScopesSchema, LayoutTokenSchema, LineDTOSchema, LineDraftSchema, LineEndingSchema, LineEndingsSchema, LinePatchSchema, LinePointsSchema, LinkDTOSchema, LinkDraftSchema, LinkPatchSchema, type ManifestPage, ManifestPageSchema, MetadataPatchSchema, MetadataTokenSchema, MetadataUpdateResultSchema, type MutationMeta, MutationMetaSchema, NamedPageEntrySchema, NoteIconSchema, type OpenDocumentResponse, OpenDocumentResponseSchema, PageBoxesSchema, PageDeleteInputSchema, PageDeleteResultSchema, PageExtractInputSchema, PageFlattenInputSchema, PageFlattenResultSchema, PageGeometrySnapshotSchema, PageInsertBlankInputSchema, PageInsertInputSchema, PageInsertResultSchema, PageLayoutSchema, PageListSnapshotSchema, PageMoveInputSchema, PageMoveResultSchema, PageNameInputSchema, PageNameResultSchema, PageNetworkRenderFormatSchema, PageRemoveNameInputSchema, PageRenderAnnotatedQuerySchema, PageRenderQuerySchema, PageRotateInputSchema, PageRotateResultSchema, PageStateSchema, PageStructureCacheSchema, PageTextSnapshotSchema, PdfActionNodeSchema, PdfActionTargetRefSchema, PdfActionTreeSchema, PdfActionTypeSchema, PdfActionWireComponents, PdfAnnotationActionsSchema, PdfDestinationSchema, PdfFieldActionsSchema, PdfLinkTargetSchema, PdfLinkTargetWritableSchema, PdfPageActionsSchema, PdfPointSchema, PdfQuadSchema, PdfRectDifferencesSchema, PdfRectSchema, PdfRotationSchema, PdfSaveModeSchema, PdfSizeSchema, PointSchema, PolygonDTOSchema, PolygonDraftSchema, PolygonPatchSchema, PolylineDTOSchema, PolylineDraftSchema, PolylinePatchSchema, RectSchema, RedactionApplyResultSchema, RedactionApplyScopeSchema, RefetchReasonSchema, type RenderPolicy, RenderTokenSchema, type RenderVersions, ResourceRefSchema, RevisionTokenSchema, type RouteKind, SEARCH_RESULT_FORMAT, SearchMatchSchema, SearchModeSchema, SearchQuerySchema, SearchRequestSchema, SearchSliceSchema, SearchSnippetSchema, type SearchToken, SearchTokenSchema, SquareDTOSchema, SquareDraftSchema, SquarePatchSchema, SquigglyDTOSchema, SquigglyDraftSchema, SquigglyPatchSchema, StampDTOSchema, StampWireDraftSchema, StampWirePatchSchema, StandardFontSchema, StrikeoutDTOSchema, StrikeoutDraftSchema, StrikeoutIntentSchema, StrikeoutPatchSchema, TextAlignmentSchema, TextDTOSchema, TextDraftSchema, TextPatchSchema, ToggleFieldWidgetSchema, type TokenInput, type TokenQuery, type TokenScalar, type TokenSchema, UnderlineDTOSchema, UnderlineDraftSchema, UnderlinePatchSchema, UnsupportedDTOSchema, UnsupportedDraftSchema, UnsupportedPatchSchema, type WeakAnnotationSessionPagesRequest, WeakAnnotationSessionPagesRequestSchema, type WeakAnnotationSessionResponse, WeakAnnotationSessionResponseSchema, WidgetAppearanceSchema, WidgetPlacementSchema, WireAttachmentFileSchema, type WireFlat, type WireScalar, annotationAppearancesImageOptionsToToken, annotationAppearancesImageOptionsToWire, annotationRenderOptionsFromImageOptions, applyCdnAccess, cdnCoverageForScope, checkResourceAccess, decodeActionsToken, decodeAnnotationAppearancesRenderToken, decodeAnnotationToken, decodeAnnotationsAllToken, decodeAttachmentsToken, decodeContentToken, decodeDocToken, decodeDownloadToken, decodeLayoutToken, decodeMetadataToken, decodeRenderToken, decodeSearchToken, decodeToken, decodeTokenText, encodeActionsToken, encodeAnnotationAppearancesRenderToken, encodeAnnotationToken, encodeAnnotationsAllToken, encodeAttachmentsToken, encodeContentToken, encodeDocToken, encodeDownloadToken, encodeLayoutToken, encodeMetadataToken, encodeRenderToken, encodeSearchToken, encodeToken, encodeTokenText, flatten, pageRenderOptionsFromImageOptions, renderImageOptionsToToken, renderImageOptionsToWire, resolveResourceIdForPath, unflatten, wirePaths, wireTemplates };
 //# sourceMappingURL=wire.d.cts.map