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

package/dist/wire.js

@@ -1,5 +1,8 @@
-import { n as checkCapability, t as checkAnyCapability } from "./resolver-inAVzsWt.js";
-import { $ as PageBoxesSchema, $n as PdfLinkTargetWritableSchema, $r as InkIntentSchema, $t as FormDataFormatSchema, A as DocumentVersionRefSchema, An as StrikeoutDTOSchema, Ar as FileAttachmentWireDraftSchema, At as SearchMatchSchema, B as FormImportResultSchema, Bn as SquareDTOSchema, Br as CaretPatchSchema, Bt as SignatureDTOSchema, C as ChangeAnalysisSchema, Ci as PdfQuadSchema, Cn as UnderlineDTOSchema, Cr as HighlightPatchSchema, Ct as PageStructureCacheSchema, D as DocumentMetadataSchema, Dn as TextDTOSchema, Dr as FileAttachmentDTOSchema, Dt as RedactionApplyResultSchema, E as DocumentManifestSchema, Ei as PdfSizeSchema, En as NoteIconSchema, Er as FreeTextPatchSchema, Et as PdfSaveModeSchema, F as FormEffectSchema, Fn as StampWireDraftSchema, Fr as CircleDTOSchema, Ft as SearchSnippetSchema, G as LayerScopesSchema, Gn as PolylinePatchSchema, Gr as AnnotationFlagsSchema, Gt as VersionAnalysisQuerySchema, H as FormSetValueResultSchema, Hn as SquarePatchSchema, Hr as AnnotationBorderStyleSchema, Ht as SignaturePreparedWireSchema, I as FormEffectsResultSchema, In as StampWirePatchSchema, Ir as CircleDraftSchema, It as SignatureAbortResultSchema, J as MetadataUpdateResultSchema, Jn as PolygonPatchSchema, Jr as AnnotationStableIdSchema, Jt as analyzeInputFromQuery, K as ManifestPageSchema, Kn as PolygonDTOSchema, Kr as AnnotationPatchBaseShape, Kt as WeakAnnotationSessionPagesRequestSchema, L as FormFieldCreateResultSchema, Ln as SquigglyDTOSchema, Lr as CirclePatchSchema, Lt as SignatureAppearanceBodySchema, M as DocumentVersionsSchema, Mn as StrikeoutPatchSchema, Mr as AttachmentFileInfoSchema, Mt as SearchQuerySchema, N as EngineErrorPayloadSchema, Nn as ResourceRefSchema, Nr as EmbeddedFileItemSchema, Nt as SearchRequestSchema, O as DocumentProtectionSchema, On as TextDraftSchema, Or as FileAttachmentIconSchema, Ot as RedactionApplyScopeSchema, P as FieldLockSpecSchema, Pn as StampDTOSchema, Pr as EmbeddedFileRefSchema, Pt as SearchSliceSchema, Q as OpenDocumentResponseSchema, Qn as PdfLinkTargetSchema, Qr as FreeTextIntentSchema, Qt as toBase64, R as FormFieldDeleteResultSchema, Rn as SquigglyDraftSchema, Rr as CaretDTOSchema, Rt as SignatureCompleteBodySchema, S as CachePinsSchema, Si as PdfPointSchema, Sn as UnsupportedPatchSchema, Sr as HighlightDraftSchema, St as PageStateSchema, T as DocumentHeadSchema, Ti as PdfRotationSchema, Tn as UnderlinePatchSchema, Tr as FreeTextDraftSchema, Tt as PdfRevisionSchema, U as FormWidgetLinkResultSchema, Un as PolylineDTOSchema, Ur as AnnotationDraftBaseShape, Ut as SignatureSeedValueSchema, V as FormRepairResultSchema, Vn as SquareDraftSchema, Vr as AnnotationBaseShape, Vt as SignaturePrepareBodySchema, W as LayerAnalysisQuerySchema, Wn as PolylineDraftSchema, Wr as AnnotationFlagsPartialSchema, Wt as SignatureSnapshotSchema, X as MutationMetaSchema, Xn as LinkDraftSchema, Xr as CaretIntentSchema, Xt as encodePrepared, Y as ModificationLevelSchema, Yn as LinkDTOSchema, Yr as BlendModeSchema, Yt as decodePrepared, Z as NamedPageEntrySchema, Zn as LinkPatchSchema, Zr as ColorSchema, Zt as fromBase64, _ as AttachmentDeleteResultSchema, _i as PdfPageActionsSchema, _n as AnnotationPatchSchema, _r as ShapeDimensionCaptionSchema, _t as PageRenderAnnotatedQuerySchema, a as AnnotationAppearancesQuerySchema, ai as RevisionTokenSchema, an as FormFieldPatchSchema, ar as LineIntentSchema, at as PageGeometrySnapshotSchema, b as ByteRangeSchema, bi as InkListSchema, bn as UnsupportedDTOSchema, br as InkPatchSchema, bt as PageRotateResultSchema, c as AnnotationFlattenInputSchema, ci as TextAlignmentSchema, cn as FormKindSchema, cr as PageScaleInputSchema, ct as PageInsertResultSchema, d as AnnotationListPageSnapshotSchema, di as PdfActionTargetRefSchema, dn as FormWidgetRefSchema, dr as PdfMeasureWriteSchema, dt as PageMoveInputSchema, ei as LineEndingSchema, en as FormFieldDTOSchema, er as LineDTOSchema, et as PageDeleteInputSchema, f as AnnotationListSnapshotAllPagesSchema, fi as PdfActionTreeSchema, fn as ToggleFieldWidgetSchema, fr as PdfMeasurementSchema, ft as PageMoveResultSchema, g as AttachmentCreateResultSchema, gi as PdfFieldActionsSchema, gn as AnnotationDraftSchema, gr as ShapeCaptionPatchSchema, gt as PageRemoveNameInputSchema, h as AppearanceOutcomeSchema, hi as PdfAnnotationActionsSchema, hn as AnnotationDTOSchema, hr as PolylineIntentSchema, ht as PageNetworkRenderFormatSchema, i as AnnotationAppearanceManifestSchema, ii as RectSchema, in as FormFieldOptionSchema, ir as LineDimensionCaptionSchema, it as PageFlattenResultSchema, j as DocumentVersionSchema, jn as StrikeoutDraftSchema, jr as WireAttachmentFileSchema, jt as SearchModeSchema, k as DocumentSecurityStateSchema, kn as TextPatchSchema, kr as FileAttachmentPatchSchema, kt as RefetchReasonSchema, l as AnnotationFlattenResultSchema, li as DocumentActionsSnapshotSchema, ln as FormSnapshotSchema, lr as PdfForeignMeasureSchema, lt as PageLayoutSchema, m as AnnotationUpdateResultSchema, mi as PdfActionWireComponents, mn as ANNOTATION_KINDS, mr as PolygonIntentSchema, mt as PageNameResultSchema, n as AccessResponseSchema, ni as PdfRectDifferencesSchema, nn as FormFieldFlagsSchema, nr as LinePatchSchema, nt as PageExtractInputSchema, o as AnnotationCreateResultSchema, oi as StandardFontSchema, on as FormFieldRefSchema, or as LineLeaderSchema, ot as PageInsertBlankInputSchema, p as AnnotationMoveResultSchema, pi as PdfActionTypeSchema, pn as WidgetPlacementSchema, pr as PdfNumberFormatSchema, pt as PageNameInputSchema, q as MetadataPatchSchema, qn as PolygonDraftSchema, qr as AnnotationRefSchema, qt as WeakAnnotationSessionResponseSchema, r as AnnotationAppearanceExportInputSchema, ri as PointSchema, rn as FormFieldOptionInputSchema, rr as LineCaptionPatchSchema, rt as PageFlattenInputSchema, s as AnnotationDeleteResultSchema, si as StrikeoutIntentSchema, sn as FormFieldValueSchema, sr as PageMeasurementViewportSchema, st as PageInsertInputSchema, t as AccessRequestSchema, ti as LineEndingsSchema, tn as FormFieldDraftSchema, tr as LineDraftSchema, tt as PageDeleteResultSchema, u as AnnotationListMutationMetaSchema, ui as PdfActionNodeSchema, un as FormValueEntrySchema, ur as PdfMeasureSchema, ut as PageListSnapshotSchema, v as AttachmentsCacheSchema, vi as PdfDestinationSchema, vn as KIND_BY_SUBTYPE, vr as InkDTOSchema, vt as PageRenderQuerySchema, w as DigestAlgorithmSchema, wi as PdfRectSchema, wn as UnderlineDraftSchema, wr as FreeTextDTOSchema, wt as PageTextSnapshotSchema, x as CacheDeltaSchema, xi as LinePointsSchema, xn as UnsupportedDraftSchema, xr as HighlightDTOSchema, xt as PageScaleResultSchema, y as BaseVersionInfoSchema, yi as CalloutLineSchema, yn as WidgetAppearanceSchema, yr as InkDraftSchema, yt as PageRotateInputSchema, z as FormFieldUpdateResultSchema, zn as SquigglyPatchSchema, zr as CaretDraftSchema, zt as SignatureCompleteResultSchema } from "./schemas-CFQGvWiu.js";
+import { f as toPageRef, i as encodeFieldRefKey, r as decodeFieldRefKey, u as encodePageKey } from "./format-Dgg428Kb.js";
+import { D as decodeAnnotKey, O as encodeAnnotKey, r as checkCapability, t as checkAnyCapability } from "./resolver-CzxmD9Ck.js";
+import { c as toBase64, s as fromBase64, u as appearanceModesOf } from "./charmap-Cprti1ta.js";
+import { $ as PolylineDTOSchema, $t as PolylineIntentSchema, A as UnderlineDTOSchema, An as LineEndingSchema, At as FileResourceKeysSchema, B as StampDTOSchema, Bn as CalloutLineSchema, Bt as LineCaptionPatchSchema, Cn as BlendModeSchema, Ct as FileAttachmentIconSchema, D as UnsupportedDTOSchema, Dn as FreeTextIntentSchema, Dt as WireAttachmentFileSchema, E as FormFieldRefSchema, En as DrawnBorderStyleSchema, Et as AttachmentSchema, F as TextPatchSchema, Fn as StrikeoutIntentSchema, Ft as CircleDraftSchema, G as SquigglyDraftSchema, Gn as PageQuadSchema, Gt as PageMeasurementViewportSchema, H as StampPatchSchema, Hn as LinePointsSchema, Ht as LineIntentSchema, I as NoteIconSchema, In as TextAlignmentSchema, It as CirclePatchSchema, J as SquareDraftSchema, Jn as PdfRectSchema, Jt as PdfMeasureSchema, K as SquigglyPatchSchema, Kn as PdfPointSchema, Kt as PageScaleInputSchema, L as StrikeoutDTOSchema, Ln as VerticalAlignmentSchema, Lt as CaretDTOSchema, M as UnderlinePatchSchema, Mn as PointSchema, Mt as ResourceKeySchema, N as TextDTOSchema, Nn as RectSchema, Nt as SourceResourceKeysSchema, O as UnsupportedDraftSchema, On as FreeTextIntentWriteSchema, Ot as AnnotationResourceKeysSchema, P as TextDraftSchema, Pn as StandardFontSchema, Pt as CircleDTOSchema, Q as PopupPatchSchema, Qt as PolygonIntentSchema, R as StrikeoutDraftSchema, Rn as WidgetBorderStyleSchema, Rt as CaretDraftSchema, S as WidgetAppearanceSchema, Sn as AnnotationRefSchema, St as FileAttachmentPatchSchema, T as WidgetPatchSchema, Tn as ColorSchema, Tt as AttachmentRefSchema, U as StampFitSchema, Un as PageBoxSchema, Ut as LineLeaderSchema, V as StampDraftSchema, Vn as InkListSchema, Vt as LineDimensionCaptionSchema, W as SquigglyDTOSchema, Wn as PagePointSchema, Wt as PageMeasurementViewportListSchema, X as PopupDTOSchema, Xn as PdfSizeSchema, Xt as PdfMeasurementSchema, Y as SquarePatchSchema, Yn as PdfRotationSchema, Yt as PdfMeasureWriteSchema, Z as PopupDraftSchema, Zn as PageRefSchema, Zt as PdfNumberFormatSchema, _ as AnnotationSchema, _n as WidgetActionsPatchSchema, _t as FreeTextDTOSchema, a as FormFieldPatchSchema, an as FieldActionsPatchSchema, at as LinkDTOSchema, b as annotationPatchSchemaOf, bn as PdfDestinationSchema, bt as FileAttachmentDTOSchema, c as FormKindSchema, cn as PdfActionNodeSchema, ct as LineDTOSchema, d as FormWidgetSchema, dn as PdfActionTypeSchema, dt as InkDTOSchema, en as ShapeCaptionPatchSchema, et as PolylineDraftSchema, f as ToggleFieldWidgetSchema, fn as PdfActionWireComponents, ft as InkDraftSchema, g as AnnotationPatchSchema, gn as PdfPageActionsSchema, gt as HighlightPatchSchema, h as AnnotationDraftSchema, hn as PdfFieldActionsSchema, ht as HighlightDraftSchema, i as FormFieldOptionSchema, in as DocumentActionsSnapshotSchema, it as PolygonPatchSchema, j as UnderlineDraftSchema, jn as LineEndingsSchema, jt as ImageResourceKeysSchema, k as UnsupportedPatchSchema, kn as InkIntentSchema, kt as AppearanceResourceKeysSchema, l as FormSnapshotSchema, ln as PdfActionTargetRefSchema, lt as LineDraftSchema, m as ANNOTATION_KINDS, mn as PdfAnnotationActionsSchema, mt as HighlightDTOSchema, n as FormFieldDraftSchema, nn as DateInputSchema, nt as PolygonDTOSchema, o as FormFieldValueSchema, on as FieldScriptWriteSchema, ot as LinkDraftSchema, p as WidgetPlacementSchema, pn as PdfActionWriteSchema, pt as InkPatchSchema, q as SquareDTOSchema, qn as PdfQuadSchema, qt as PdfForeignMeasureSchema, r as FormFieldOptionInputSchema, rn as IsoDateTimeSchema, rt as PolygonDraftSchema, sn as FileWidgetActionsPatchSchema, st as LinkPatchSchema, t as FormFieldDTOSchema, tn as ShapeDimensionCaptionSchema, tt as PolylinePatchSchema, u as FormValueEntrySchema, un as PdfActionTreeSchema, ut as LinePatchSchema, vn as PdfLinkTargetSchema, vt as FreeTextDraftSchema, w as WidgetDTOSchema, wn as CaretIntentSchema, wt as AttachmentFileInfoSchema, xn as AnnotationBorderStyleSchema, xt as FileAttachmentDraftSchema, y as KIND_BY_SUBTYPE, yn as PdfLinkTargetWritableSchema, yt as FreeTextPatchSchema, z as StrikeoutPatchSchema, zn as WidgetCheckStyleSchema, zt as CaretPatchSchema } from "./schema-DzlUNk38.js";
+import { $ as FormExportRequestSchema, $t as PageRenderQuerySchemas, A as CacheDeltaSchema, An as pageRenderFamilyOf, At as MutationMetaSchema, B as DocumentProtectionSchema, Bt as PageFlattenInputSchema, C as AttachmentCreateResultSchema, Cn as SignatureSnapshotSchema, Ct as IdentitySchema, D as BaseVersionInfoSchema, Dn as decodePrepared, Dt as MetadataPatchSchema, E as AttachmentMutationMetaSchema, En as analyzeInputFromQuery, Et as ManifestPageSchema, F as CustomMetadataUpdateResultSchema, Ft as OpenDocumentResponseSchema, G as DocumentWireComponents, Gt as PageInsertResultSchema, H as DocumentVersionRefSchema, Ht as PageGeometrySnapshotSchema, I as DigestAlgorithmSchema, It as PageBoxesSchema, J as EngineErrorPayloadSchema, Jt as PageNameInputSchema, K as EditSessionAccessSchema, Kt as PageLayoutSchema, L as DocumentHeadSchema, Lt as PageDeleteInputSchema, M as ChangeAnalysisSchema, Mt as ObjectNumberRangeSchema, N as CustomMetadataPatchSchema, Nt as ObjectNumberReservationRequestSchema, O as BundleLimitsSchema, On as encodePrepared, Ot as MetadataUpdateResultSchema, P as CustomMetadataSchema, Pt as ObjectNumberReservationResponseSchema, Q as FormCalculationsReorderResultSchema, Qt as PageRemoveNameInputSchema, R as DocumentManifestSchema, Rt as PageDeleteResultSchema, S as AppearanceOutcomeSchema, Sn as SignatureSeedValueSchema, St as FormWireComponents, T as AttachmentListSchema, Tn as WidgetAppearancesQuerySchema, Tt as LayerScopesSchema, U as DocumentVersionSchema, Ut as PageInsertBlankInputSchema, V as DocumentSecurityStateSchema, Vt as PageFlattenResultSchema, W as DocumentVersionsSchema, Wt as PageInsertInputSchema, X as FieldPositionSchema, Xt as PageNetworkRenderFormatSchema, Y as FieldLockSpecSchema, Yt as PageNameResultSchema, Z as FormCalculationsReorderBodySchema, Zt as PagePositionSchema, _ as AnnotationReorderBodySchema, _n as SignatureCompleteBodySchema, _t as FormWidgetRestoreResultSchema, a as AnnotationAppearancesQuerySchema, an as PageTextSnapshotSchema, at as FormImportOptionsSchema, b as AnnotationWireComponents, bn as SignaturePrepareBodySchema, bt as FormWidgetsReorderBodySchema, c as AnnotationExportSelectionSchema, cn as RedactionApplyResultSchema, ct as FormRepairResultSchema, d as AnnotationImportBodySchema, dn as SearchQuerySchema, dt as FormSetValueResultSchema, en as PageReorderInputSchema, et as FormExportSelectionSchema, f as AnnotationImportOptionsSchema, fn as SearchRequestSchema, ft as FormValuesImportBodySchema, g as AnnotationPositionSchema, gn as SignatureCancelResultSchema, gt as FormWidgetLinkResultSchema, h as AnnotationListSchema, hn as SignatureAppearanceBodySchema, ht as FormWidgetDeleteResultSchema, i as AnnotationAppearanceExportInputSchema, in as PageScaleResultSchema, it as FormImportBodySchema, j as CachePinsSchema, jt as NamedPageEntrySchema, k as ByteRangeSchema, kn as PAGE_RENDER_FAMILIES, kt as ModificationLevelSchema, l as AnnotationFlattenInputSchema, ln as RedactionApplyScopeSchema, lt as FormResetBodySchema, m as AnnotationListMutationMetaSchema, mn as SearchSnippetSchema, mt as FormValuesImportResultSchema, n as AccessResponseSchema, nn as PageRotateInputSchema, nt as FormFieldDeleteResultSchema, o as AnnotationCreateResultSchema, on as PdfRevisionSchema, ot as FormImportResultSchema, p as AnnotationImportResultSchema, pn as SearchSliceSchema, pt as FormValuesImportOptionsSchema, q as EditSessionStatusSchema, qt as PageListSnapshotSchema, r as AnnotationAppearanceBatchSchema, rn as PageRotateResultSchema, rt as FormFieldUpdateResultSchema, s as AnnotationDeleteResultSchema, sn as PdfSaveModeSchema, st as FormMutationMetaSchema, t as AccessRequestSchema, tn as PageReorderResultSchema, tt as FormFieldCreateResultSchema, u as AnnotationFlattenResultSchema, un as SearchMatchSchema, ut as FormResetResultSchema, v as AnnotationReorderResultSchema, vn as SignatureCompleteResultSchema, vt as FormWidgetUpdateBodySchema, w as AttachmentDeleteResultSchema, wn as VersionAnalysisQuerySchema, wt as LayerAnalysisQuerySchema, x as AnnotationsExportRequestSchema, xn as SignaturePreparedWireSchema, xt as FormWidgetsReorderResultSchema, y as AnnotationUpdateResultSchema, yn as SignatureDTOSchema, yt as FormWidgetUpdateResultSchema, z as DocumentMetadataSchema, zt as PageExtractInputSchema } from "./schemas-D6xOGjqg.js";
 import { z } from "zod";
 //#region src/forms/submission.ts
 const FormSubmissionEntrySchema = z.object({
@@ -29,11 +32,11 @@ const FormSubmissionRequestSchema = z.object({
 		"hover",
 		"lifecycle"
 	]),
-	clientTimeMs: z.number().finite()
+	sentAt: IsoDateTimeSchema
 });
 const FormSubmissionReceiptSchema = z.object({
 	submissionId: z.string().min(1),
-	receivedAt: z.string().min(1)
+	receivedAt: IsoDateTimeSchema
 });
 //#endregion
 //#region src/wire/token.ts
@@ -114,6 +117,30 @@ const AnnotationTokenSchema = { fields: ["annotationVersion"] };
 /** Doc-level bulk annotations listing pin (plural, vs the per-page
 *  `annotationVersion` token above). */
 const AnnotationsAllTokenSchema = { fields: ["annotationsVersion"] };
+/** The form (`form@`): its fields, widget rows and calculation order. */
+const FormTokenSchema = { fields: ["formsVersion"] };
+/**
+* `doc.annotations.export` leaf: the annotation and layout pins (the bundle
+* carries each page's position and box, which only the layout pin covers)
+* and the selection, canonical so one selection is one URL.
+*/
+const AnnotationsExportTokenSchema = {
+	fields: [
+		"annotationsVersion",
+		"include",
+		"layoutVersion",
+		"selection"
+	],
+	maxLength: 4096
+};
+const FormExportTokenSchema = {
+	fields: [
+		"formsVersion",
+		"layoutVersion",
+		"selection"
+	],
+	maxLength: 4096
+};
 const ActionsTokenSchema = { fields: ["actionsVersion"] };
 const AttachmentsTokenSchema = { fields: ["attachmentsVersion"] };
 /**
@@ -140,12 +167,13 @@ const DownloadTokenSchema = {
 * dotted path here and a matching branch in `PageImageOptionsWireSchema`.
 * No encoder/decoder code changes.
 *
-* `includeAnnotations` is deliberately NOT a token field: annotatedness
-* changes the artifact's plane-dependency
-* set, so it is expressed by the path FAMILY (`…/render/pages/` vs
-* `…/render/annotated/pages/`), never inside the token. `annotationVersion`
-* belongs to the annotated family's tokens only — each family's query
-* schema enforces its own pin grammar.
+* What a picture draws (`includeAnnotations`, `includeFormFields`) is not a
+* token field: it's the picture's family, which is its path
+* (`PAGE_RENDER_FAMILIES`). Each family needs its own rights and depends on
+* its own planes, and a CDN grant is a path prefix. The pins are: every
+* family's `contentVersion`, and `annotationVersion` and `widgetVersion` in
+* the families that draw annotations and form fields; each family's query
+* schema refuses the others.
 */
 const RenderTokenSchema = {
 	fields: [
@@ -156,13 +184,14 @@ const RenderTokenSchema = {
 		"quality",
 		"rotation",
 		"target.kind",
-		"target.rect.bottom",
-		"target.rect.left",
-		"target.rect.right",
-		"target.rect.top",
+		"target.rect.height",
+		"target.rect.width",
+		"target.rect.x",
+		"target.rect.y",
 		"viewport.kind",
 		"viewport.scale",
-		"viewport.width"
+		"viewport.width",
+		"widgetVersion"
 	],
 	maxLength: 512
 };
@@ -173,22 +202,22 @@ const RenderTokenSchema = {
 * charset excludes free text), and the resume position. Canonical by
 * construction: the codec sorts fields and the encoder omits every
 * default, so equal searches produce byte-equal tokens — the property CDN
-* cache hits live on. Mode is NOT a field; it is the endpoint (separate
+* cache hits live on. Mode is not a field; it is the endpoint (separate
 * permission tiers must never share cache entries).
 */
 const SearchTokenSchema = {
 	fields: [
 		"epoch",
 		"format",
+		"from",
 		"ignoreWhitespace",
+		"limitMatches",
+		"limitPages",
 		"matchCase",
 		"matchDiacritics",
-		"maxMatches",
-		"maxPages",
 		"q",
 		"regex",
 		"skip",
-		"startPage",
 		"wholeWord"
 	],
 	maxLength: 2048
@@ -196,18 +225,40 @@ const SearchTokenSchema = {
 /**
 * Token for the batch annotation-appearance render endpoint. Narrower than
 * the page render token: appearance bitmaps are sized per annotation `/Rect`
-* so there is no target/viewport — only a uniform `scale` and page
-* `rotation`. Keyed by `annotationVersion` only (appearances do not depend on
-* page base content). The cloud endpoint renders the Normal appearance only,
-* so `modes` is intentionally absent here (it is a worker/local-only option).
+* so there is no target — only the page's `viewport` and `rotation`. Keyed by
+* `annotationVersion` only (appearances do not depend on page base content).
+* `modes` is present only when a request asks for fewer than every mode, as
+* one value (`normal-down`, in the engine's mode order), so one request for
+* every mode is one URL.
 */
 const AnnotationAppearancesRenderTokenSchema = {
 	fields: [
 		"annotationVersion",
 		"format",
+		"modes",
+		"quality",
+		"rotation",
+		"viewport.kind",
+		"viewport.scale",
+		"viewport.width"
+	],
+	maxLength: 256
+};
+/**
+* Token for a page's widget images (`form/pages/{p}/appearances@`): the
+* annotation appearance token's options, keyed by the page's
+* `widgetVersion`.
+*/
+const WidgetAppearancesRenderTokenSchema = {
+	fields: [
+		"format",
+		"modes",
 		"quality",
 		"rotation",
-		"scale"
+		"viewport.kind",
+		"viewport.scale",
+		"viewport.width",
+		"widgetVersion"
 	],
 	maxLength: 256
 };
@@ -265,6 +316,95 @@ const encodeAnnotationToken = (annotationVersion) => encodeToken(AnnotationToken
 const decodeAnnotationToken = (raw) => decodePositiveInteger(decodeToken(AnnotationTokenSchema, raw).annotationVersion, "annotationVersion");
 const encodeAnnotationsAllToken = (annotationsVersion) => encodeToken(AnnotationsAllTokenSchema, { annotationsVersion });
 const decodeAnnotationsAllToken = (raw) => decodePositiveInteger(decodeToken(AnnotationsAllTokenSchema, raw).annotationsVersion, "annotationsVersion");
+const encodeFormToken = (formsVersion) => encodeToken(FormTokenSchema, { formsVersion });
+const decodeFormToken = (raw) => decodePositiveInteger(decodeToken(FormTokenSchema, raw).formsVersion, "formsVersion");
+const encodeAnnotationsExportToken = (token) => {
+	const { selection } = token;
+	const wire = {};
+	if (selection.pages) wire.p = [...new Set(selection.pages.map((page) => page.objectNumber))].sort((left, right) => left - right);
+	if (selection.refs) {
+		const refs = /* @__PURE__ */ new Map();
+		for (const ref of selection.refs) {
+			const entry = [ref.page.objectNumber, encodeAnnotKey(ref)];
+			refs.set(JSON.stringify(entry), entry);
+		}
+		wire.r = [...refs.keys()].sort().map((key) => refs.get(key));
+	}
+	return encodeToken(AnnotationsExportTokenSchema, {
+		annotationsVersion: token.annotationsVersion,
+		layoutVersion: token.layoutVersion,
+		include: selection.include === "references" ? "references" : void 0,
+		selection: wire.p || wire.r ? encodeTokenText(JSON.stringify(wire)) : void 0
+	});
+};
+const decodeAnnotationsExportToken = (raw) => {
+	const query = decodeToken(AnnotationsExportTokenSchema, raw);
+	const selection = {};
+	if (query.include !== void 0) {
+		if (query.include !== "references") throw new Error(`unknown include "${query.include}"`);
+		selection.include = "references";
+	}
+	if (query.selection !== void 0) {
+		const wire = JSON.parse(decodeTokenText(query.selection));
+		const isNumber = (value) => Number.isInteger(value) && value > 0;
+		if (typeof wire !== "object" || wire === null) throw new Error("malformed export selection");
+		if (wire.p !== void 0) {
+			if (!Array.isArray(wire.p) || !wire.p.every(isNumber)) throw new Error("malformed export pages");
+			selection.pages = wire.p.map((pageObjectNumber) => toPageRef(pageObjectNumber));
+		}
+		if (wire.r !== void 0) {
+			if (!Array.isArray(wire.r)) throw new Error("malformed export refs");
+			selection.refs = wire.r.map((entry) => {
+				if (!Array.isArray(entry) || entry.length !== 2 || !isNumber(entry[0])) throw new Error("malformed export ref");
+				const ref = typeof entry[1] === "string" ? decodeAnnotKey(toPageRef(entry[0]), entry[1]) : null;
+				if (!ref) throw new Error("malformed export ref");
+				return ref;
+			});
+		}
+	}
+	return {
+		annotationsVersion: decodePositiveInteger(query.annotationsVersion, "annotationsVersion"),
+		layoutVersion: decodePositiveInteger(query.layoutVersion, "layoutVersion"),
+		selection
+	};
+};
+const encodeFormExportToken = (token) => {
+	const { selection } = token;
+	const wire = {};
+	if (selection.pages) wire.p = [...new Set(selection.pages.map((page) => page.objectNumber))].sort((left, right) => left - right);
+	if (selection.fields) wire.f = [...new Set(selection.fields.map(encodeFieldRefKey))].sort();
+	return encodeToken(FormExportTokenSchema, {
+		formsVersion: token.formsVersion,
+		layoutVersion: token.layoutVersion,
+		selection: wire.p || wire.f ? encodeTokenText(JSON.stringify(wire)) : void 0
+	});
+};
+const decodeFormExportToken = (raw) => {
+	const query = decodeToken(FormExportTokenSchema, raw);
+	const selection = {};
+	if (query.selection !== void 0) {
+		const wire = JSON.parse(decodeTokenText(query.selection));
+		if (typeof wire !== "object" || wire === null) throw new Error("malformed export selection");
+		if (wire.p !== void 0) {
+			const isNumber = (value) => Number.isInteger(value) && value > 0;
+			if (!Array.isArray(wire.p) || !wire.p.every(isNumber)) throw new Error("malformed export pages");
+			selection.pages = wire.p.map((pageObjectNumber) => toPageRef(pageObjectNumber));
+		}
+		if (wire.f !== void 0) {
+			if (!Array.isArray(wire.f)) throw new Error("malformed export fields");
+			selection.fields = wire.f.map((key) => {
+				const ref = typeof key === "string" ? decodeFieldRefKey(key) : null;
+				if (!ref) throw new Error("malformed export field");
+				return ref;
+			});
+		}
+	}
+	return {
+		formsVersion: decodePositiveInteger(query.formsVersion, "formsVersion"),
+		layoutVersion: decodePositiveInteger(query.layoutVersion, "layoutVersion"),
+		selection
+	};
+};
 const encodeActionsToken = (actionsVersion) => encodeToken(ActionsTokenSchema, { actionsVersion });
 const decodeActionsToken = (raw) => decodePositiveInteger(decodeToken(ActionsTokenSchema, raw).actionsVersion, "actionsVersion");
 const encodeAttachmentsToken = (attachmentsVersion) => encodeToken(AttachmentsTokenSchema, { attachmentsVersion });
@@ -284,7 +424,7 @@ const decodeDownloadToken = (raw) => {
 * Encode a render token from a flat wire-shape input. The input is the
 * output of `flatten(...)` over an SDK `PageImageOptions`-shaped object plus
 * cache versions. Semantic invariants (viewport-kind XOR fields, per-family
-* pin grammar — annotatedness itself is PATH-expressed, never a token key —
+* pin grammar — annotatedness itself is path-expressed, never a token key —
 * target rect coherence) live in the per-family render query schemas —
 * running them here would duplicate the spec.
 */
@@ -301,18 +441,24 @@ const decodeRenderToken = (raw) => decodeToken(RenderTokenSchema, raw);
 * plus cache versions). Semantic validation lives in
 * `AnnotationAppearancesQuerySchema`.
 */
+/** `modes` as one token value: the modes in engine order, joined by `-`. */
+const encodeAppearanceModes = (modes) => modes.join("-");
 const encodeAnnotationAppearancesRenderToken = (input) => encodeToken(AnnotationAppearancesRenderTokenSchema, input);
 /** Decode an annotation-appearance render token to a flat field map. */
 const decodeAnnotationAppearancesRenderToken = (raw) => decodeToken(AnnotationAppearancesRenderTokenSchema, raw);
+/** Encode a widget-appearance render token, the annotation one's twin keyed by `widgetVersion`. */
+const encodeWidgetAppearancesRenderToken = (input) => encodeToken(WidgetAppearancesRenderTokenSchema, input);
+/** Decode a widget-appearance render token to a flat field map. */
+const decodeWidgetAppearancesRenderToken = (raw) => decodeToken(WidgetAppearancesRenderTokenSchema, raw);
 /**
-* The search RESULT representation this client speaks — part of the token
+* The search result representation this client speaks — part of the token
 * (and therefore the versioned URL), so a response-shape change can never
 * serve a stale CDN body to a newer client: new tokens are new cache keys,
-* and old tokens fail decode on new servers. Deliberately ALWAYS encoded —
+* and old tokens fail decode on new servers. Deliberately always encoded —
 * an exception to the omit-defaults rule, because its entire job is to
 * change the token bytes when the format changes.
 */
-const SEARCH_RESULT_FORMAT = "segments1";
+const SEARCH_RESULT_FORMAT = "ranges1";
 const encodeSearchToken = (input) => {
 	const q = input.query;
 	return encodeToken(SearchTokenSchema, {
@@ -324,17 +470,17 @@ const encodeSearchToken = (input) => {
 		matchDiacritics: q.matchDiacritics ? true : void 0,
 		wholeWord: q.wholeWord ? true : void 0,
 		ignoreWhitespace: q.ignoreWhitespace ? true : void 0,
-		startPage: input.startPage,
+		from: input.from,
 		skip: input.skip > 0 ? input.skip : void 0,
-		maxPages: input.budget?.maxPages,
-		maxMatches: input.budget?.maxMatches
+		limitPages: input.limit?.pages,
+		limitMatches: input.limit?.matches
 	});
 };
 const decodeSearchToken = (raw) => {
 	const t = decodeToken(SearchTokenSchema, raw);
 	if (t.epoch === void 0) throw new Error("search token is missing \"epoch\"");
 	if (t.q === void 0) throw new Error("search token is missing \"q\"");
-	if (t.format !== "segments1") throw new Error(`search token has unsupported result format "${t.format ?? "legacy"}" (expected "${SEARCH_RESULT_FORMAT}")`);
+	if (t.format !== "ranges1") throw new Error(`search token has unsupported result format "${t.format ?? "legacy"}" (expected "${SEARCH_RESULT_FORMAT}")`);
 	const query = {
 		text: decodeTokenText(t.q),
 		...t.regex === "true" ? { regex: true } : {},
@@ -343,16 +489,16 @@ const decodeSearchToken = (raw) => {
 		...t.wholeWord === "true" ? { wholeWord: true } : {},
 		...t.ignoreWhitespace === "true" ? { ignoreWhitespace: true } : {}
 	};
-	const maxPages = t.maxPages === void 0 ? void 0 : decodePositiveInteger(t.maxPages, "maxPages");
-	const maxMatches = t.maxMatches === void 0 ? void 0 : decodePositiveInteger(t.maxMatches, "maxMatches");
+	const pages = t.limitPages === void 0 ? void 0 : decodePositiveInteger(t.limitPages, "limitPages");
+	const matches = t.limitMatches === void 0 ? void 0 : decodePositiveInteger(t.limitMatches, "limitMatches");
 	return {
 		epoch: t.epoch,
 		query,
-		...t.startPage === void 0 ? {} : { startPage: decodePositiveInteger(t.startPage, "startPage") },
+		...t.from === void 0 ? {} : { from: decodePositiveInteger(t.from, "from") },
 		skip: t.skip === void 0 ? 0 : decodePositiveInteger(t.skip, "skip"),
-		...maxPages !== void 0 || maxMatches !== void 0 ? { budget: {
-			...maxPages !== void 0 ? { maxPages } : {},
-			...maxMatches !== void 0 ? { maxMatches } : {}
+		...pages !== void 0 || matches !== void 0 ? { limit: {
+			...matches !== void 0 ? { matches } : {},
+			...pages !== void 0 ? { pages } : {}
 		} } : {}
 	};
 };
@@ -406,7 +552,7 @@ function decodePdfSaveMode(raw) {
 * Single source of truth for cloud HTTP paths. Both @cloudpdf/engine and
 * @cloudpdf/server import these so they cannot drift.
 *
-* **URL layout convention (paths v2)**
+* **URL layout convention**
 *
 * Each resource type lives at its own distinct path prefix. This
 * lets prefix-matching CDNs (Bunny, Cloud CDN, Azure FD) enforce
@@ -418,28 +564,39 @@ function decodePdfSaveMode(raw) {
 *   /v1/docs/{id}                                       — doc root
 *   /v1/docs/{id}/manifest@{ver}                        — doc-level read
 *   /v1/docs/{id}/render/pages/{N}/data@{ver}                — render is its own prefix
+*   /v1/docs/{id}/render/{annotations,fields,all}/pages/{N}/data@{ver} — and each picture family
 *   /v1/docs/{id}/text/pages/{N}/data@{ver}                  — text is its own prefix
 *   /v1/docs/{id}/geometry/pages/{N}/data@{ver}              — geometry is its own prefix
 *   /v1/docs/{id}/layers/{L}/manifest@{ver}
 *   /v1/docs/{id}/layers/{L}/metadata@{ver}
+*   /v1/docs/{id}/layers/{L}/metadata/custom@{ver}                — the Info dict's own keys
 *   /v1/docs/{id}/layers/{L}/render/pages/{N}/data@{ver}
 *   /v1/docs/{id}/layers/{L}/text/pages/{N}/data@{ver}
 *   /v1/docs/{id}/layers/{L}/geometry/pages/{N}/data@{ver}
 *   /v1/docs/{id}/layers/{L}/annotations/pages/{N}/items@{ver}    — collection (read)
 *   /v1/docs/{id}/layers/{L}/annotations/pages/{N}/items          — collection (create)
 *   /v1/docs/{id}/layers/{L}/annotations/pages/{N}/items/{key}    — member
-*   /v1/docs/{id}/layers/{L}/annotations/pages/{N}/items/move     — batch reorder
-*   /v1/docs/{id}/layers/{L}/pages/move                           — batch page reorder
+*   /v1/docs/{id}/layers/{L}/annotations/pages/{N}/items/reorder  — stacking order
+*   /v1/docs/{id}/layers/{L}/pages/reorder                        — page order
 *   /v1/docs/{id}/layers/{L}/pages/rotate                         — batch absolute rotation
 *   /v1/docs/{id}/layers/{L}/pages/delete                         — batch page delete
-*   /v1/docs/{id}/layers/{L}/form                                 — reconciled snapshot (read)
+*   /v1/docs/{id}/form@{ver}                                      — the form: fields + widget rows (read)
+*   /v1/docs/{id}/form/pages/{N}/appearances@{ver}                — a page's widget images (read)
+*   /v1/docs/{id}/layers/{L}/form@{ver}
+*   /v1/docs/{id}/layers/{L}/form/pages/{N}/appearances@{ver}
+*   /v1/docs/{id}/layers/{L}/form                                 — the form, current (read)
+*   /v1/docs/{id}/layers/{L}/form/widgets/{N}/{key}               — a widget's place and look (patch)
+*   /v1/docs/{id}/layers/{L}/form/widgets/{N}/reorder             — the widgets' stacking order
 *   /v1/docs/{id}/layers/{L}/form/fields                          — field collection (create)
 *   /v1/docs/{id}/layers/{L}/form/fields/{key}                    — field member (read/patch/delete)
 *   /v1/docs/{id}/layers/{L}/form/fields/{key}/value              — value write (fill)
 *   /v1/docs/{id}/layers/{L}/form/fields/{key}/reset              — reset to /DV (fill)
 *   /v1/docs/{id}/layers/{L}/form/fields/{key}/widgets            — adopt a widget (attach)
 *   /v1/docs/{id}/layers/{L}/form/fields/{key}/widgets/detach     — release a widget
-*   /v1/docs/{id}/layers/{L}/form/data                            — FDF/XFDF export (GET) / import (POST)
+*   /v1/docs/{id}/layers/{L}/form/export@{token}                  — form bundle export (GET)
+*   /v1/docs/{id}/layers/{L}/form/export                          — form bundle export by body (POST)
+*   /v1/docs/{id}/layers/{L}/form/import                          — design import (multipart POST)
+*   /v1/docs/{id}/layers/{L}/form/import-values                   — values import (multipart POST)
 *   /v1/docs/{id}/layers/{L}/form/repair                          — durable reconciliation
 *   /v1/docs/{id}/layers/{L}/download@{ver}
 *
@@ -456,16 +613,21 @@ const wirePaths = {
 	* against the token like every layer route — the grant is
 	* layer-scoped in substance: CDN coverage, scopes, and the client's
 	* binding all carry the layer). Path-addressed so the affinity tier —
-	* the `X-CloudPDF-Doc` header derivation AND the chart's uri-mode
+	* the `X-CloudPDF-Doc` header derivation and the chart's uri-mode
 	* regex — pins the session bootstrap to the document's pod from the
 	* very first request. Default-layer callers spell `layers/default/`,
 	* same as every other layer route.
 	*/
 	access: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/access`,
-	/** Deprecated alias (docId in the BODY) — served for one prerelease
+	/** Deprecated alias (docId in the body) — served for one prerelease
 	*  cycle so pre-rename clients keep working; remove after. */
 	accessLegacy: "/v1/access",
 	/**
+	* POST `{ count }`: hand the caller's editing session `count` more object
+	* numbers at once (at most 1,000), for a large paste.
+	*/
+	objectNumbers: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/object-numbers`,
+	/**
 	* GET: open the document referenced by the doc-scoped JWT and
 	* return its `DocumentHead`. The server materialises the base
 	* PDF into its file cache and binds it to a worker the first
@@ -503,9 +665,9 @@ const wirePaths = {
 	*/
 	layerLayout: (docId, layerName, layoutVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/layout@${encodeLayoutToken(layoutVersion)}`,
 	/**
-	* Immutable BASE page-geometry list (plane-scope model): the shared-URL
+	* Immutable base page-geometry list (plane-scope model): the shared-URL
 	* variant a layout-inheriting layer resolves at — every visitor's page
-	* list is ONE CDN object served from the base worker session.
+	* list is one CDN object served from the base worker session.
 	*/
 	docLayout: (docId, layoutVersion) => `/v1/docs/${encodeURIComponent(docId)}/layout@${encodeLayoutToken(layoutVersion)}`,
 	layerLayoutCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/layout`,
@@ -519,12 +681,21 @@ const wirePaths = {
 	*/
 	layerMetadata: (docId, layerName, metadataVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata@${encodeMetadataToken(metadataVersion)}`,
 	layerMetadataCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata`,
-	/** Immutable BASE metadata (plane-scope model): the shared-URL variant a
+	/** Immutable base metadata (plane-scope model): the shared-URL variant a
 	*  metadata-inheriting layer resolves at. */
 	docMetadata: (docId, metadataVersion) => `/v1/docs/${encodeURIComponent(docId)}/metadata@${encodeMetadataToken(metadataVersion)}`,
+	/**
+	* GET: the Info dict's custom keys for the layer at a specific
+	* `metadataVersion` — the same version pointer as `layerMetadata`, since
+	* both halves live in one dict. Content-addressed like it.
+	*/
+	layerCustomMetadata: (docId, layerName, metadataVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata/custom@${encodeMetadataToken(metadataVersion)}`,
+	layerCustomMetadataCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata/custom`,
+	/** Immutable base custom keys: the shared-URL twin of `layerCustomMetadata`. */
+	docCustomMetadata: (docId, metadataVersion) => `/v1/docs/${encodeURIComponent(docId)}/metadata/custom@${encodeMetadataToken(metadataVersion)}`,
 	/** Immutable catalog-owned actions, independently pinned in the manifest. */
 	layerActions: (docId, layerName, actionsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/actions@${encodeActionsToken(actionsVersion)}`,
-	/** Immutable BASE catalog actions (plane-scope model): the shared-URL
+	/** Immutable base catalog actions (plane-scope model): the shared-URL
 	*  variant an actions-inheriting layer resolves at. */
 	docActions: (docId, actionsVersion) => `/v1/docs/${encodeURIComponent(docId)}/actions@${encodeActionsToken(actionsVersion)}`,
 	/** Immutable layer signature snapshot (base signatures + the layer's fields + protection). */
@@ -538,7 +709,7 @@ const wirePaths = {
 	/** POST (JSON): install the CMS and publish the sealed bytes as the next base version. */
 	layerSignatureComplete: (docId, layerName, signingId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/signatures/${encodeURIComponent(signingId)}/complete`,
 	/** DELETE: discard a pending signing. */
-	layerSignatureAbort: (docId, layerName, signingId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/signatures/${encodeURIComponent(signingId)}`,
+	layerSignatureCancel: (docId, layerName, signingId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/signatures/${encodeURIComponent(signingId)}`,
 	/** The document's base versions, oldest first (grows; never cached). */
 	docVersions: (docId) => `/v1/docs/${encodeURIComponent(docId)}/versions`,
 	/** Immutable: the signature snapshot of one base version. */
@@ -557,13 +728,15 @@ const wirePaths = {
 	layerFormFieldSignatureAppearance: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}/signature-appearance`,
 	/** POST: rewrite the document Info dict for the layer (metadata edit). */
 	layerMetadataUpdate: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata`,
+	/** POST: set and remove the Info dict's custom keys for the layer. */
+	layerCustomMetadataUpdate: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/metadata/custom`,
 	/**
-	* Immutable BASE /EmbeddedFiles listing: the shared-URL variant an
+	* Immutable base /EmbeddedFiles listing: the shared-URL variant an
 	* attachments-undiverged layer resolves at — every visitor's sidebar list
-	* is ONE CDN object served from the base worker session.
+	* is one CDN object served from the base worker session.
 	*/
 	docAttachments: (docId, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/attachments@${encodeAttachmentsToken(attachmentsVersion)}`,
-	/** Immutable BASE decoded bytes of one embedded file (twin of
+	/** Immutable base decoded bytes of one embedded file (twin of
 	*  `layerAttachmentFile` — same capability tier split). */
 	docAttachmentFile: (docId, key, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/attachment-files/${encodeTokenText(key)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
 	/** Immutable /EmbeddedFiles listing, pinned by `attachmentsVersion`. */
@@ -580,14 +753,14 @@ const wirePaths = {
 	*/
 	layerAttachmentFile: (docId, layerName, key, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachment-files/${encodeTokenText(key)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
 	/** Immutable decoded bytes of a FileAttachment annotation's embedded file. */
-	layerAnnotationFile: (docId, layerName, pageObjectNumber, annotKey, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachment-files/pages/${pageObjectNumber}/items/${encodeURIComponent(annotKey)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
+	layerAnnotationFile: (docId, layerName, page, annotKey, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachment-files/pages/${encodeURIComponent(encodePageKey(page))}/items/${encodeURIComponent(annotKey)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
 	/**
-	* Immutable BASE bytes of a FileAttachment annotation's embedded file
+	* Immutable base bytes of a FileAttachment annotation's embedded file
 	* (plane-scope model). Depends on the `annotations` plane (the annotation
-	* exists in this view) AND the `attachments` plane (the pin); the origin
+	* exists in this view) and the `attachments` plane (the pin); the origin
 	* guard requires both inherited.
 	*/
-	docAnnotationFile: (docId, pageObjectNumber, annotKey, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/attachment-files/pages/${pageObjectNumber}/items/${encodeURIComponent(annotKey)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
+	docAnnotationFile: (docId, page, annotKey, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/attachment-files/pages/${encodeURIComponent(encodePageKey(page))}/items/${encodeURIComponent(annotKey)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
 	/**
 	* GET: full plain-text extraction for a single page at a specific
 	* `contentVersion`. Content-addressed; CDN may cache forever.
@@ -595,55 +768,60 @@ const wirePaths = {
 	* retry walks `/head` → `/manifest@docVersion=N` to learn the new
 	* `contentVersion`.
 	*/
-	docPageText: (docId, pageObjectNumber, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/text/pages/${pageObjectNumber}/data@${encodeContentToken(contentVersion)}`,
-	layerPageText: (docId, layerName, pageObjectNumber, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${pageObjectNumber}/data@${encodeContentToken(contentVersion)}`,
-	layerPageTextCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${pageObjectNumber}/data`,
-	docPageGeometry: (docId, pageObjectNumber, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${pageObjectNumber}/data@${encodeContentToken(contentVersion)}`,
-	docPageGeometryCurrent: (docId, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${pageObjectNumber}/data`,
-	docPageRender: (docId, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/render/pages/${pageObjectNumber}/data@${encodeRenderToken(token)}`,
-	docPageRenderCurrent: (docId, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/render/pages/${pageObjectNumber}/data`,
+	docPageText: (docId, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/text/pages/${encodeURIComponent(encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageText: (docId, layerName, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${encodeURIComponent(encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageTextCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${encodeURIComponent(encodePageKey(page))}/data`,
+	docPageGeometry: (docId, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${encodeURIComponent(encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	docPageGeometryCurrent: (docId, page) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${encodeURIComponent(encodePageKey(page))}/data`,
 	/**
-	* Immutable BASE annotated render (plane-scope model). Its OWN path family,
-	* not a token flag under `/render/pages/`: an annotated render depends on
-	* `content + annotations`, an annotation-free one on `content` alone, and
-	* edge grants are prefix-scoped — the prefix law says a path's prefix must
-	* identify its full plane-dependency set. Annotatedness is therefore
-	* PATH-ONLY (the token/path law): the wire token has no
-	* `includeAnnotations` key at all; the annotated family's token carries
-	* `annotationVersion`, the free family's cannot.
+	* A page picture of one family (`PAGE_RENDER_FAMILIES`). The family is a
+	* path of its own, never a token field: each depends on its own planes and
+	* needs its own rights, and an edge grant sees only prefixes. Its token
+	* carries the family's pins.
 	*/
-	docPageRenderAnnotated: (docId, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/render/annotated/pages/${pageObjectNumber}/data@${encodeRenderToken(token)}`,
-	layerPageGeometry: (docId, layerName, pageObjectNumber, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${pageObjectNumber}/data@${encodeContentToken(contentVersion)}`,
-	layerPageGeometryCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${pageObjectNumber}/data`,
-	layerPageRender: (docId, layerName, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/render/pages/${pageObjectNumber}/data@${encodeRenderToken(token)}`,
-	layerPageRenderCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/render/pages/${pageObjectNumber}/data`,
-	/** Layer twin of `docPageRenderAnnotated` — the grammar is uniform:
-	*  annotatedness is path-only at BOTH tiers. */
-	layerPageRenderAnnotated: (docId, layerName, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/render/annotated/pages/${pageObjectNumber}/data@${encodeRenderToken(token)}`,
-	layerPageRenderAnnotatedCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/render/annotated/pages/${pageObjectNumber}/data`,
+	docPageRender: (docId, family, page, token) => `/v1/docs/${encodeURIComponent(docId)}/${PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	docPageRenderCurrent: (docId, family, page) => `/v1/docs/${encodeURIComponent(docId)}/${PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(encodePageKey(page))}/data`,
+	layerPageGeometry: (docId, layerName, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${encodeURIComponent(encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageGeometryCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${encodeURIComponent(encodePageKey(page))}/data`,
+	layerPageRender: (docId, layerName, family, page, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	layerPageRenderCurrent: (docId, layerName, family, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(encodePageKey(page))}/data`,
 	/**
-	* Immutable BASE annotation list for a single page (plane-scope model):
+	* Immutable base annotation list for a single page (plane-scope model):
 	* the shared-URL variant an annotations-inheriting layer resolves at — a
-	* base's own annotations (weak-identity ones included) are simply visible
-	* through every pristine layer, so 1,000 visitors' sidebars are ONE CDN
+	* base's own annotations (inline ones included) are simply visible
+	* through every pristine layer, so 1,000 visitors' sidebars are one CDN
 	* object served from the base worker session.
 	*/
-	docPageAnnotations: (docId, pageObjectNumber, annotationVersion) => `/v1/docs/${encodeURIComponent(docId)}/annotations/pages/${pageObjectNumber}/items@${encodeAnnotationToken(annotationVersion)}`,
-	/** Immutable BASE whole-document annotation listing (bulk hydration). */
+	docPageAnnotations: (docId, page, annotationVersion) => `/v1/docs/${encodeURIComponent(docId)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items@${encodeAnnotationToken(annotationVersion)}`,
+	/** Immutable base whole-document annotation listing (bulk hydration). */
 	docAnnotationsAll: (docId, annotationsVersion) => `/v1/docs/${encodeURIComponent(docId)}/annotations/items@${encodeAnnotationsAllToken(annotationsVersion)}`,
-	/** Immutable BASE appearance batch (twin of
+	/** Immutable base appearance batch (twin of
 	*  `layerPageAnnotationAppearances` — same `annotations` plane gate). */
-	docPageAnnotationAppearances: (docId, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/annotations/pages/${pageObjectNumber}/appearances@${encodeAnnotationAppearancesRenderToken(token)}`,
+	docPageAnnotationAppearances: (docId, page, token) => `/v1/docs/${encodeURIComponent(docId)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/appearances@${encodeAnnotationAppearancesRenderToken(token)}`,
 	/**
 	* GET: full annotation list for a single page at a specific
 	* `annotationVersion`. Same cache-control rules and 404-retry
 	* semantics as `docPageText`. The `items` suffix is the
 	* collection name — see file-level docstring.
 	*/
-	layerPageAnnotations: (docId, layerName, pageObjectNumber, annotationVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items@${encodeAnnotationToken(annotationVersion)}`,
-	/** Immutable LAYER whole-document annotation listing (bulk hydration). */
+	layerPageAnnotations: (docId, layerName, page, annotationVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items@${encodeAnnotationToken(annotationVersion)}`,
+	/** Immutable base annotation export: a bundle as multipart, needing
+	*  `doc.annotate.read` and `doc.download`. */
+	docAnnotationsExport: (docId, token) => `/v1/docs/${encodeURIComponent(docId)}/annotations/export@${encodeAnnotationsExportToken(token)}`,
+	/** Immutable layer annotation export (twin of `docAnnotationsExport`). */
+	layerAnnotationsExport: (docId, layerName, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/export@${encodeAnnotationsExportToken(token)}`,
+	/**
+	* A layer annotation export whose selection a URL can't carry (position
+	* refs, long ref lists): a POST of the pins and the selection, not cached.
+	*/
+	layerAnnotationsExportRequest: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/export`,
+	/** A layer's changes: user actions, each its ops in one transaction, or an undo (`doc.apply`). */
+	layerChanges: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/changes`,
+	/** A bundle's annotations, created in the layer as one change (`doc.annotations.import`). */
+	layerAnnotationsImport: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/import`,
+	/** Immutable layer whole-document annotation listing (bulk hydration). */
 	layerAnnotationsAll: (docId, layerName, annotationsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/items@${encodeAnnotationsAllToken(annotationsVersion)}`,
-	layerPageAnnotationsCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items`,
+	layerPageAnnotationsCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items`,
 	/**
 	* GET: batch-rendered annotation appearance bitmaps for a single page as a
 	* `multipart/form-data` body. Sibling collection of `items` under the same
@@ -654,28 +832,52 @@ const wirePaths = {
 	* Content-addressed via the appearance render token (`annotationVersion`
 	* plus render options like scale/format); CDN may cache forever. Appearance
 	* pixels depend only on the annotation `/AP` stream, so `contentVersion` is
-	* deliberately NOT part of the key.
+	* deliberately not part of the key.
 	*/
-	layerPageAnnotationAppearances: (docId, layerName, pageObjectNumber, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/appearances@${encodeAnnotationAppearancesRenderToken(token)}`,
-	layerPageAnnotationAppearancesCurrent: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/appearances`,
-	layerPageAnnotationsCreate: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items`,
-	layerAnnotationByKey: (docId, layerName, pageObjectNumber, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items/${encodeURIComponent(key)}`,
-	layerPageAnnotationsMove: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items/move`,
+	layerPageAnnotationAppearances: (docId, layerName, page, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/appearances@${encodeAnnotationAppearancesRenderToken(token)}`,
+	layerPageAnnotationAppearancesCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/appearances`,
+	layerPageAnnotationsCreate: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items`,
+	layerAnnotationByKey: (docId, layerName, page, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items/${encodeURIComponent(key)}`,
+	/** GET: an annotation's `appearance` resource, its drawing as a one-page
+	*  PDF — a derived read (application/pdf, no-store), gated like pages/extract. */
+	layerAnnotationAppearanceResource: (docId, layerName, page, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items/${encodeURIComponent(key)}/resources/appearance`,
+	layerPageAnnotationsReorder: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items/reorder`,
 	/** POST: flatten a chosen set of the page's annotations into its content
 	*  (a content + annotation mutation of that page). */
-	layerPageAnnotationsFlatten: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items/flatten`,
+	layerPageAnnotationsFlatten: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items/flatten`,
 	/** POST: the chosen annotations' appearances as one single-page PDF — a
 	*  derived read (application/pdf, no-store), gated like pages/extract. */
-	layerPageAnnotationsAppearance: (docId, layerName, pageObjectNumber) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${pageObjectNumber}/items/appearance`,
+	layerPageAnnotationsAppearance: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(encodePageKey(page))}/items/appearance`,
+	/**
+	* Immutable base form: the fields, every widget row, the calculation
+	* order (`doc.forms.list()`), at the document's `formsVersion`. Needs
+	* `doc.forms.read`, under its own prefix, so the CDN signs it apart from
+	* the annotations.
+	*/
+	docForm: (docId, formsVersion) => `/v1/docs/${encodeURIComponent(docId)}/form@${encodeFormToken(formsVersion)}`,
+	/** Immutable layer form (twin of `docForm`). */
+	layerForm: (docId, layerName, formsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form@${encodeFormToken(formsVersion)}`,
+	/** GET: the layer's form as it is now — for API callers, served `no-store`. */
+	layerFormCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form`,
+	/**
+	* Immutable base batch of a page's widget images, every mode and state, as
+	* `multipart/form-data` (`page.forms.renderAppearances()`), keyed by the
+	* page's `widgetVersion`.
+	*/
+	docPageFormAppearances: (docId, page, token) => `/v1/docs/${encodeURIComponent(docId)}/form/pages/${encodeURIComponent(encodePageKey(page))}/appearances@${encodeWidgetAppearancesRenderToken(token)}`,
+	/** Immutable layer twin of `docPageFormAppearances`. */
+	layerPageFormAppearances: (docId, layerName, page, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/pages/${encodeURIComponent(encodePageKey(page))}/appearances@${encodeWidgetAppearancesRenderToken(token)}`,
+	layerPageFormAppearancesCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/pages/${encodeURIComponent(encodePageKey(page))}/appearances`,
 	/**
-	* GET: the reconciled form snapshot (field tree + widget joins) for the
-	* layer's CURRENT state. Forms are document-scoped (one AcroForm per
-	* document), so there is no per-page collection and — unlike annotations —
-	* no content-addressed `@version` variant: the snapshot is always served
-	* `no-store`. Mutation results carry the per-page `cacheDelta` that keeps
-	* annotation/render caches coherent when widget appearances change.
+	* PATCH: a widget's place and look (`doc.forms.updateWidget`). `key` is
+	* the widget's annotation key. Not under `form/pages/`, which the CDN
+	* signs for reads.
 	*/
-	layerForm: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form`,
+	/** POST: the form's calculation order (`doc.forms.reorderCalculations`). */
+	layerFormCalculationsReorder: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/calculations/reorder`,
+	/** POST: the stacking order of a page's widgets (`doc.forms.reorderWidgets`). */
+	layerFormWidgetsReorder: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/widgets/${encodeURIComponent(encodePageKey(page))}/reorder`,
+	layerFormWidget: (docId, layerName, page, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/widgets/${encodeURIComponent(encodePageKey(page))}/${encodeURIComponent(key)}`,
 	/** POST: create a field (optionally with styled widget placements). */
 	layerFormFields: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields`,
 	/**
@@ -686,9 +888,9 @@ const wirePaths = {
 	layerFormFieldByKey: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}`,
 	/** POST: replace the field's value (`{ value: FormFieldValue }`). */
 	layerFormFieldValue: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}/value`,
-	/** POST: reset the field to /DV (or clear). Empty body. */
-	layerFormFieldReset: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}/reset`,
-	/** POST: adopt an inert widget annotation (`{ widget, onState? }`). */
+	/** POST: reset fields to /DV (or clear): `{ refs? }`, the whole form without `refs`. */
+	layerFormReset: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/reset`,
+	/** POST: add a widget to the field, the body its placement (`WidgetPlacement`). */
 	layerFormFieldWidgets: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}/widgets`,
 	/**
 	* POST: release a widget back to the inert annotation plane
@@ -697,18 +899,21 @@ const wirePaths = {
 	* one codec instead of inventing a second composite key syntax.
 	*/
 	layerFormFieldWidgetsDetach: (docId, layerName, fieldKey) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/fields/${encodeURIComponent(fieldKey)}/widgets/detach`,
-	/**
-	* GET: serialized form data (`?format=fdf|xfdf`, default `xfdf`).
-	* POST: import an FDF/XFDF payload (raw bytes body; format sniffed
-	* server-side unless `?format=` pins it).
-	*/
-	layerFormData: (docId, layerName, format) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/data${format ? `?format=${format}` : ""}`,
+	/** Immutable base form export: a bundle as multipart, needing `doc.forms.read` and `doc.download`. */
+	docFormExport: (docId, token) => `/v1/docs/${encodeURIComponent(docId)}/form/export@${encodeFormExportToken(token)}`,
+	/** Immutable layer form export (twin of `docFormExport`). */
+	layerFormExport: (docId, layerName, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/export@${encodeFormExportToken(token)}`,
+	/** A layer form export whose selection a URL can't carry: a POST of the pins and the selection, not cached. */
+	layerFormExportRequest: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/export`,
+	/** A bundle's design, created in the layer as one change (`doc.forms.import`). */
+	layerFormImport: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/import`,
+	/** A bundle's values, written in the layer as one change (`doc.forms.importValues`). */
+	layerFormImportValues: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/import-values`,
 	/** POST: durable reconciliation (`{ bakeAppearances? }`). */
 	layerFormRepair: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/repair`,
-	layerFormEffects: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/effects`,
 	/**
 	* GET: one budgeted search slice, versioned form. The token
-	* (`encodeSearchToken`) IS the cache key: content epoch + query +
+	* (`encodeSearchToken`) is the cache key: content epoch + query +
 	* position. Immutable; CDN may cache forever. Mode is the path — rects
 	* and full are separate resources so permission tiers never share
 	* cache entries (`'rects'` needs `doc.text.search`; `'full'` also
@@ -718,17 +923,17 @@ const wirePaths = {
 	layerSearchFull: (docId, layerName, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/search/full/data@${token}`,
 	/**
 	* GET: unversioned form — same fields as flat query params (`q` as
-	* plain text), served from the CURRENT content, always `no-store`.
+	* plain text), served from the current content, always `no-store`.
 	* The debug/simple-client variant; the SDK uses the versioned form.
 	*/
 	layerSearchRectsCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/search/rects/data`,
 	layerSearchFullCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/search/full/data`,
-	layerPageViewports: (docId, layerName, pon) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/${pon}/viewports`,
-	layerPageScale: (docId, layerName, pon) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/${pon}/scale`,
-	layerPagesMove: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/move`,
+	layerPageViewports: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/${encodeURIComponent(encodePageKey(page))}/viewports`,
+	layerPageScale: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/${encodeURIComponent(encodePageKey(page))}/scale`,
+	layerPagesReorder: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/reorder`,
 	layerPagesRotate: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/rotate`,
 	layerPagesDelete: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/delete`,
-	/** POST: register/rename a `/Names /Pages` entry — a page-STRUCTURE
+	/** POST: register/rename a `/Names /Pages` entry — a page-structure
 	*  mutation (docVersion + layoutVersion advance; reads ride `/layout`). */
 	layerPagesNames: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/names`,
 	/** POST: remove a `/Names /Pages` entry (the page stays). */
@@ -736,14 +941,14 @@ const wirePaths = {
 	layerPagesFlatten: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/flatten`,
 	/**
 	* POST (multipart mutation envelope): copy every page of the `source`
-	* resource part (a standalone PDF) in at the body's `destIndex`.
+	* resource part (a standalone PDF) in at the body's `toIndex`.
 	*/
 	layerPagesInsert: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/insert`,
 	/** POST (plain JSON): create blank pages — pages.insert minus the bytes. */
 	layerPagesInsertBlank: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/insert-blank`,
 	/**
 	* POST (plain JSON → `application/pdf` bytes): export the listed pages,
-	* in caller order, as a standalone PDF. A READ over the current layer
+	* in caller order, as a standalone PDF. A read over the current layer
 	* state (gated like /download), so it is a POST only for its body —
 	* nothing mutates and no event is published.
 	*/
@@ -753,15 +958,6 @@ const wirePaths = {
 	layerDownload: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/download`,
 	layerDownloadVersioned: (docId, layerName, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/download@${encodeDownloadToken(token)}`,
 	/**
-	* Weak-annotation-sessions: pluralized in v2 so the collection
-	* lives at `/weak-annotation-sessions` and members at
-	* `/weak-annotation-sessions/{sessionId}` — REST-conventional.
-	*/
-	layerWeakAnnotationSession: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/weak-annotation-sessions`,
-	layerWeakAnnotationSessionHeartbeat: (docId, layerName, sessionId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/weak-annotation-sessions/${encodeURIComponent(sessionId)}/heartbeat`,
-	layerWeakAnnotationSessionPages: (docId, layerName, sessionId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/weak-annotation-sessions/${encodeURIComponent(sessionId)}/pages`,
-	layerWeakAnnotationSessionRelease: (docId, layerName, sessionId) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/weak-annotation-sessions/${encodeURIComponent(sessionId)}`,
-	/**
 	* POST: pre-warm the doc cache + worker open before any user
 	* request lands. Body is `{ docId }`. Doc-scoped token required.
 	*/
@@ -780,22 +976,30 @@ function analysisQueryString(query) {
 const wireTemplates = {
 	docHead: "/v1/docs/:docId/head",
 	layerManifest: "/v1/docs/:docId/layers/:layerName/manifest",
+	layerChanges: "/v1/docs/:docId/layers/:layerName/changes",
 	layerMetadata: "/v1/docs/:docId/layers/:layerName/metadata",
-	layerRenderPage: "/v1/docs/:docId/layers/:layerName/render/pages/:pon/data",
-	layerTextPage: "/v1/docs/:docId/layers/:layerName/text/pages/:pon/data",
+	layerCustomMetadata: "/v1/docs/:docId/layers/:layerName/metadata/custom",
+	layerRenderPage: "/v1/docs/:docId/layers/:layerName/render/pages/:pageKey/data",
+	layerTextPage: "/v1/docs/:docId/layers/:layerName/text/pages/:pageKey/data",
 	layerAnnotationItemsAll: "/v1/docs/:docId/layers/:layerName/annotations/items",
-	layerAnnotationItems: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items",
-	layerAnnotationItem: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey",
-	layerAnnotationItemsFlatten: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/flatten",
-	layerAnnotationItemsAppearance: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/appearance",
+	layerAnnotationItems: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items",
+	layerAnnotationItem: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/:annotKey",
+	layerAnnotationItemsReorder: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/reorder",
+	layerAnnotationItemsFlatten: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/flatten",
+	layerAnnotationItemsAppearance: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/appearance",
+	layerAnnotationItemAppearanceResource: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/:annotKey/resources/appearance",
 	layerForm: "/v1/docs/:docId/layers/:layerName/form",
+	layerFormWidget: "/v1/docs/:docId/layers/:layerName/form/widgets/:pageKey/:annotKey",
+	layerFormWidgetsReorder: "/v1/docs/:docId/layers/:layerName/form/widgets/:pageKey/reorder",
+	layerFormCalculationsReorder: "/v1/docs/:docId/layers/:layerName/form/calculations/reorder",
 	layerFormFieldValue: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/value",
-	layerFormFieldReset: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/reset",
+	layerFormReset: "/v1/docs/:docId/layers/:layerName/form/reset",
 	layerFormFieldSignatureAppearance: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/signature-appearance",
-	layerFormData: "/v1/docs/:docId/layers/:layerName/form/data",
-	layerPageViewports: "/v1/docs/:docId/layers/:layerName/pages/:pon/viewports",
-	layerPageScale: "/v1/docs/:docId/layers/:layerName/pages/:pon/scale",
-	layerPagesMove: "/v1/docs/:docId/layers/:layerName/pages/move",
+	layerFormImport: "/v1/docs/:docId/layers/:layerName/form/import",
+	layerFormImportValues: "/v1/docs/:docId/layers/:layerName/form/import-values",
+	layerPageViewports: "/v1/docs/:docId/layers/:layerName/pages/:pageKey/viewports",
+	layerPageScale: "/v1/docs/:docId/layers/:layerName/pages/:pageKey/scale",
+	layerPagesReorder: "/v1/docs/:docId/layers/:layerName/pages/reorder",
 	layerPagesRotate: "/v1/docs/:docId/layers/:layerName/pages/rotate",
 	layerPagesDelete: "/v1/docs/:docId/layers/:layerName/pages/delete",
 	layerPagesNames: "/v1/docs/:docId/layers/:layerName/pages/names",
@@ -810,7 +1014,7 @@ const wireTemplates = {
 	layerSignaturesAnalysis: "/v1/docs/:docId/layers/:layerName/signatures/analysis",
 	layerSignaturesPrepare: "/v1/docs/:docId/layers/:layerName/signatures/prepare",
 	layerSignatureComplete: "/v1/docs/:docId/layers/:layerName/signatures/:signingId/complete",
-	layerSignatureAbort: "/v1/docs/:docId/layers/:layerName/signatures/:signingId",
+	layerSignatureCancel: "/v1/docs/:docId/layers/:layerName/signatures/:signingId",
 	docVersions: "/v1/docs/:docId/versions",
 	docVersionSignatures: "/v1/docs/:docId/versions/signatures/:sha",
 	docVersionSignatureContents: "/v1/docs/:docId/versions/signatures/:sha/:fieldKey/contents",
@@ -821,8 +1025,45 @@ const wireTemplates = {
 };
 //#endregion
 //#region src/wire/resources.ts
+/** A page picture of one family, at the document's shared path. */
+function pageRenderResource(family) {
+	const { resource, path, needs } = PAGE_RENDER_FAMILIES[family];
+	return {
+		id: resource,
+		pathPattern: `/v1/docs/{docId}/${path}/*/data@*`,
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/${path}/*/data@*`,
+		pathPrefix: `/v1/docs/{docId}/${path}/`,
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/${path}/`,
+		requirement: requirementOf(needs),
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	};
+}
+/** A page picture of one family, at a layer's path. */
+function layerPageRenderResource(family) {
+	const { layerResource, path, needs } = PAGE_RENDER_FAMILIES[family];
+	return {
+		id: layerResource,
+		pathPattern: `/v1/docs/{docId}/layers/{layerName}/${path}/*/data@*`,
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/${path}/*/data@*`,
+		pathPrefix: `/v1/docs/{docId}/layers/{layerName}/${path}/`,
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/${path}/`,
+		requirement: requirementOf(needs),
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	};
+}
+function requirementOf(needs) {
+	return needs.length === 1 ? {
+		kind: "single",
+		capability: needs[0]
+	} : {
+		kind: "all",
+		capabilities: needs
+	};
+}
 /**
-* URL layout (paths v2): each resource type lives at a distinct path
+* URL layout: each resource type lives at a distinct path
 * prefix so prefix-matching CDNs (Bunny, Cloud CDN, Azure FD) can
 * enforce per-resource scope at the edge. See wire/paths.ts for the
 * full shape and rationale.
@@ -867,32 +1108,10 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
-	"page-render": {
-		id: "page-render",
-		pathPattern: "/v1/docs/{docId}/render/pages/*/data@*",
-		resolvePathPattern: (docId) => `/v1/docs/${docId}/render/pages/*/data@*`,
-		pathPrefix: "/v1/docs/{docId}/render/pages/",
-		resolvePathPrefix: (docId) => `/v1/docs/${docId}/render/pages/`,
-		requirement: {
-			kind: "single",
-			capability: "doc.render"
-		},
-		routeKind: "versioned-read",
-		cdnCacheable: true
-	},
-	"page-render-annotated": {
-		id: "page-render-annotated",
-		pathPattern: "/v1/docs/{docId}/render/annotated/pages/*/data@*",
-		resolvePathPattern: (docId) => `/v1/docs/${docId}/render/annotated/pages/*/data@*`,
-		pathPrefix: "/v1/docs/{docId}/render/annotated/pages/",
-		resolvePathPrefix: (docId) => `/v1/docs/${docId}/render/annotated/pages/`,
-		requirement: {
-			kind: "single",
-			capability: "doc.render"
-		},
-		routeKind: "versioned-read",
-		cdnCacheable: true
-	},
+	"page-render": pageRenderResource("pages"),
+	"page-render-annotations": pageRenderResource("annotations"),
+	"page-render-fields": pageRenderResource("fields"),
+	"page-render-all": pageRenderResource("all"),
 	"page-annotations": {
 		id: "page-annotations",
 		pathPattern: "/v1/docs/{docId}/annotations/pages/*/items@*",
@@ -919,6 +1138,58 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"annotations-export": {
+		id: "annotations-export",
+		pathPattern: "/v1/docs/{docId}/annotations/export@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/annotations/export@*`,
+		pathPrefix: "/v1/docs/{docId}/annotations/export@",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/annotations/export@`,
+		requirement: {
+			kind: "all",
+			capabilities: ["doc.annotate.read", "doc.download"]
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
+	"form-export": {
+		id: "form-export",
+		pathPattern: "/v1/docs/{docId}/form/export@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/form/export@*`,
+		pathPrefix: "/v1/docs/{docId}/form/export@",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/form/export@`,
+		requirement: {
+			kind: "all",
+			capabilities: ["doc.forms.read", "doc.download"]
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
+	form: {
+		id: "form",
+		pathPattern: "/v1/docs/{docId}/form@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/form@*`,
+		pathPrefix: "/v1/docs/{docId}/form@",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/form@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.forms.read"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
+	"page-form": {
+		id: "page-form",
+		pathPattern: "/v1/docs/{docId}/form/pages/*/appearances@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/form/pages/*/appearances@*`,
+		pathPrefix: "/v1/docs/{docId}/form/pages/",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/form/pages/`,
+		requirement: {
+			kind: "single",
+			capability: "doc.forms.read"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	layout: {
 		id: "layout",
 		pathPattern: "/v1/docs/{docId}/layout@*",
@@ -945,6 +1216,19 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"metadata-custom": {
+		id: "metadata-custom",
+		pathPattern: "/v1/docs/{docId}/metadata/custom@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/metadata/custom@*`,
+		pathPrefix: "/v1/docs/{docId}/metadata/custom@",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/metadata/custom@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.open"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	actions: {
 		id: "actions",
 		pathPattern: "/v1/docs/{docId}/actions@*",
@@ -984,6 +1268,19 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"layer-metadata-custom": {
+		id: "layer-metadata-custom",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/metadata/custom@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/metadata/custom@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/metadata/custom@",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/metadata/custom@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.open"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	"layer-actions": {
 		id: "layer-actions",
 		pathPattern: "/v1/docs/{docId}/layers/{layerName}/actions@*",
@@ -1049,32 +1346,10 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
-	"layer-page-render": {
-		id: "layer-page-render",
-		pathPattern: "/v1/docs/{docId}/layers/{layerName}/render/pages/*/data@*",
-		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/render/pages/*/data@*`,
-		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/render/pages/",
-		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/render/pages/`,
-		requirement: {
-			kind: "single",
-			capability: "doc.render"
-		},
-		routeKind: "versioned-read",
-		cdnCacheable: true
-	},
-	"layer-page-render-annotated": {
-		id: "layer-page-render-annotated",
-		pathPattern: "/v1/docs/{docId}/layers/{layerName}/render/annotated/pages/*/data@*",
-		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/render/annotated/pages/*/data@*`,
-		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/render/annotated/pages/",
-		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/render/annotated/pages/`,
-		requirement: {
-			kind: "single",
-			capability: "doc.render"
-		},
-		routeKind: "versioned-read",
-		cdnCacheable: true
-	},
+	"layer-page-render": layerPageRenderResource("pages"),
+	"layer-page-render-annotations": layerPageRenderResource("annotations"),
+	"layer-page-render-fields": layerPageRenderResource("fields"),
+	"layer-page-render-all": layerPageRenderResource("all"),
 	"page-text": {
 		id: "page-text",
 		pathPattern: "/v1/docs/{docId}/text/pages/*/data@*",
@@ -1166,6 +1441,19 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"layer-annotations-export": {
+		id: "layer-annotations-export",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/annotations/export@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/annotations/export@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/annotations/export@",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/annotations/export@`,
+		requirement: {
+			kind: "all",
+			capabilities: ["doc.annotate.read", "doc.download"]
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	"layer-annotations-all": {
 		id: "layer-annotations-all",
 		pathPattern: "/v1/docs/{docId}/layers/{layerName}/annotations/items@*",
@@ -1179,6 +1467,45 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"layer-form-export": {
+		id: "layer-form-export",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/form/export@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form/export@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/form/export@",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form/export@`,
+		requirement: {
+			kind: "all",
+			capabilities: ["doc.forms.read", "doc.download"]
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
+	"layer-form": {
+		id: "layer-form",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/form@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/form@",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.forms.read"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
+	"layer-page-form": {
+		id: "layer-page-form",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/form/pages/*/appearances@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form/pages/*/appearances@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/form/pages/",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/form/pages/`,
+		requirement: {
+			kind: "single",
+			capability: "doc.forms.read"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	"download-current": {
 		id: "download-current",
 		pathPattern: "/v1/docs/{docId}/layers/{layerName}/download",
@@ -1325,15 +1652,14 @@ function checkResourceAccess(resourceId, rawScope, pdfBits) {
 * `requirement` at the origin route, but the CDN never gets a
 * credential for them.
 *
-* The URL restructure (paths v2) guarantees each cacheable resource
-* type has a distinct prefix, so prefix-matching adapters get
-* per-resource scope enforcement at the edge — a Bunny token signed
-* at `/v1/docs/{id}/render/pages/` can only authorize render bytes,
-* never text or annotations.
+* The URL layout gives each cacheable resource type a distinct prefix,
+* so prefix-matching adapters get per-resource scope enforcement at the
+* edge — a Bunny token signed at `/v1/docs/{id}/render/pages/` can only
+* authorize render bytes, never text or annotations.
 */
 /**
-* Plane map: the planes each DOC-LEVEL shared resource depends on. A
-* layer token's edge credential covers a resource's prefix iff EVERY listed
+* Plane map: the planes each doc-level shared resource depends on. A
+* layer token's edge credential covers a resource's prefix iff every listed
 * plane is inherited (`'base'`) in the caller's scopes — the same condition
 * the origin guard enforces (origin is the truth; this grant is the
 * TTL-bounded optimization). Resources absent from this map (head, manifest,
@@ -1348,14 +1674,20 @@ function checkResourceAccess(resourceId, rawScope, pdfBits) {
 * as every edge grant.
 */
 const RESOURCE_PLANES = {
-	"page-render": ["content"],
+	"page-render": PAGE_RENDER_FAMILIES.pages.planes,
+	"page-render-annotations": PAGE_RENDER_FAMILIES.annotations.planes,
+	"page-render-fields": PAGE_RENDER_FAMILIES.fields.planes,
+	"page-render-all": PAGE_RENDER_FAMILIES.all.planes,
 	"page-text": ["content"],
 	"page-geometry": ["content"],
-	"page-render-annotated": ["content", "annotations"],
 	"page-annotations": ["annotations"],
 	"annotations-all": ["annotations"],
+	form: ["forms"],
+	"page-form": ["forms"],
+	"annotations-export": ["annotations", "layout"],
 	layout: ["layout"],
 	metadata: ["metadata"],
+	"metadata-custom": ["metadata"],
 	actions: ["actions"],
 	attachments: ["attachments"],
 	"attachment-files": ["attachments"]
@@ -1385,11 +1717,11 @@ function cdnCoverageForScope(rawScope, pdfBits, context) {
 * effects to attach. Used by both:
 *   - the @cloudpdf/engine HttpClient (to actually route requests through
 *     the CDN edge when an /access response says it can)
-*   - the smoke/diagnostic inspector (to PREVIEW what the SDK would do
+*   - the smoke/diagnostic inspector (to preview what the SDK would do
 *     for a given path, with no network)
 *
 * Keeping this in engine-core means cloud-side request routing and
-* server-side test fixtures use the SAME algorithm. If a regression
+* server-side test fixtures use the same algorithm. If a regression
 * sneaks in, both ends break together.
 *
 * Selection rules
@@ -1403,7 +1735,7 @@ function cdnCoverageForScope(rawScope, pdfBits, context) {
 *      origin — that's how scope narrowing works at the edge: the
 *      server only emits overrides for resources the caller's scope
 *      grants.
-*   3. Find the LONGEST-matching `signedPathPolicies` entry (its
+*   3. Find the longest-matching `signedPathPolicies` entry (its
 *      `pathPrefix` is a prefix of the request path). Append its
 *      `queryParams`. No match falls back to `signedQueryParams` if
 *      the adapter emitted a global token.
@@ -1464,8 +1796,8 @@ function applyCdnAccess(input) {
 * is a (longest) prefix of `path`. Returns null when no resource
 * matches — admin routes, /access, /warm fall into this bucket.
 *
-* Each cacheable resource has a DISTINCT prefix (paths v2 invariant),
-* so longest-match is deterministic.
+* Each cacheable resource has a distinct prefix, so longest-match is
+* deterministic.
 */
 function resolveResourceIdForPath(path, docId, layerName) {
 	let best = null;
@@ -1547,33 +1879,22 @@ function unflatten(flat) {
 /**
 * Project image render options plus cache versions into the flat wire shape
 * the render token encoder consumes. The output is a generic dotted-key map
-* (`viewport.kind`, `target.rect.left`, …) — the schema and codec never need
+* (`viewport.kind`, `target.rect.x`, …) — the schema and codec never need
 * to know about specific option fields. Adding a new render option means
 * extending `PageImageOptions`, the render query schemas, and
 * `RenderTokenSchema.fields`; this function does not change.
 *
-* Token/path rule: tokens carry VERSION PINS and RENDER
-* PARAMETERS; anything that changes the artifact's plane-dependency set is
-* PATH-expressed. Annotatedness changes the planes (`content` vs
-* `content + annotations`), so the wire map never carries
-* `includeAnnotations` — the caller picks the path FAMILY
-* (`…/render/pages/` vs `…/render/annotated/pages/`) and passes
-* `annotationVersion` iff it chose the annotated one. Contradictory states
-* are unrepresentable; each family's query schema enforces its own pin
-* grammar structurally.
-*
-* Semantic validation (viewport-kind invariants, per-family pin presence,
-* rect coherence) lives in `PageRenderQuerySchema` /
-* `PageRenderAnnotatedQuerySchema` and runs when the resulting URL is
-* decoded server-side. Round-tripping (flatten → encode → decode →
-* unflatten → schema parse) recovers the original SDK options.
+* What the picture draws is never in the token: the caller picks the
+* family's path (`PAGE_RENDER_FAMILIES`) and passes that family's pins.
+* Each family's query schema checks its own pins when the URL is decoded
+* server-side. Round-tripping (flatten → encode → decode → unflatten →
+* schema parse) recovers the original SDK options.
 */
 function renderImageOptionsToWire(options, versions) {
-	const { includeAnnotations: _pathExpressed, ...wireOptions } = options;
+	const { includeAnnotations: _inThePath, includeFormFields: _alsoInThePath, ...wireOptions } = options;
 	return flatten({
 		...wireOptions,
-		contentVersion: versions.contentVersion,
-		...versions.annotationVersion !== void 0 ? { annotationVersion: versions.annotationVersion } : {}
+		...versions
 	});
 }
 /**
@@ -1584,17 +1905,18 @@ function renderImageOptionsToToken(options, versions) {
 	return encodeRenderToken(renderImageOptionsToWire(options, versions));
 }
 /**
-* Re-attach `includeAnnotations` onto the worker-side `PageRenderOptions`
-* shape. Pure shape transform; consumed by the server route after
-* `PageRenderQuerySchema` has produced the SDK-shaped options.
+* The worker-side `PageRenderOptions` of a parsed picture request: the
+* render options, and what its family draws (stamped by the family's query
+* schema). Pure shape transform; image encoding stays out.
 */
-function pageRenderOptionsFromImageOptions(options, includeAnnotations) {
+function pageRenderOptionsFromImageOptions(options) {
 	return {
 		...options.target ? { target: options.target } : {},
 		...options.viewport ? { viewport: options.viewport } : {},
 		...options.rotation !== void 0 ? { rotation: options.rotation } : {},
 		...options.background !== void 0 ? { background: options.background } : {},
-		includeAnnotations
+		includeAnnotations: options.includeAnnotations ?? false,
+		includeFormFields: options.includeFormFields ?? false
 	};
 }
 /**
@@ -1603,15 +1925,33 @@ function pageRenderOptionsFromImageOptions(options, includeAnnotations) {
 * Mirrors {@link renderImageOptionsToWire}.
 */
 function annotationAppearancesImageOptionsToWire(options, versions) {
-	return flatten({
-		...options,
-		annotationVersion: versions.annotationVersion
-	});
+	return appearancesToWire(options, { annotationVersion: versions.annotationVersion });
 }
 /** Convenience: build the full encoded appearance render token in one call. */
 function annotationAppearancesImageOptionsToToken(options, versions) {
 	return encodeAnnotationAppearancesRenderToken(annotationAppearancesImageOptionsToWire(options, versions));
 }
+/** The widget twin of {@link annotationAppearancesImageOptionsToWire}. */
+function widgetAppearancesImageOptionsToWire(options, versions) {
+	return appearancesToWire(options, { widgetVersion: versions.widgetVersion });
+}
+/** The widget twin of {@link annotationAppearancesImageOptionsToToken}. */
+function widgetAppearancesImageOptionsToToken(options, versions) {
+	return encodeWidgetAppearancesRenderToken(widgetAppearancesImageOptionsToWire(options, versions));
+}
+/**
+* Appearance options and a pin, flat. `modes` only when it asks for fewer
+* than every mode, as one value, so every request for all of them is one URL.
+*/
+function appearancesToWire(options, pin) {
+	const { modes, ...rest } = options;
+	const asked = appearanceModesOf(modes);
+	return flatten({
+		...rest,
+		...asked ? { modes: encodeAppearanceModes(asked) } : {},
+		...pin
+	});
+}
 /**
 * Strip image-encoding fields, leaving the worker-side
 * `AnnotationAppearanceRenderOptions`. Pure shape transform consumed by the
@@ -1620,12 +1960,251 @@ function annotationAppearancesImageOptionsToToken(options, versions) {
 */
 function annotationRenderOptionsFromImageOptions(options) {
 	return {
-		...options.scale !== void 0 ? { scale: options.scale } : {},
+		...options.viewport ? { viewport: options.viewport } : {},
 		...options.rotation !== void 0 ? { rotation: options.rotation } : {},
 		...options.modes ? { modes: options.modes } : {}
 	};
 }
 //#endregion
-export { ANNOTATION_KINDS, AccessRequestSchema, AccessResponseSchema, ActionsTokenSchema, AnnotationAppearanceExportInputSchema, AnnotationAppearanceManifestSchema, AnnotationAppearancesQuerySchema, AnnotationAppearancesRenderTokenSchema, AnnotationBaseShape, AnnotationBorderStyleSchema, AnnotationCreateResultSchema, AnnotationDTOSchema, AnnotationDeleteResultSchema, AnnotationDraftBaseShape, AnnotationDraftSchema, AnnotationFlagsPartialSchema, AnnotationFlagsSchema, AnnotationFlattenInputSchema, AnnotationFlattenResultSchema, AnnotationListMutationMetaSchema, AnnotationListPageSnapshotSchema, AnnotationListSnapshotAllPagesSchema, AnnotationMoveResultSchema, AnnotationPatchBaseShape, AnnotationPatchSchema, AnnotationRefSchema, AnnotationStableIdSchema, AnnotationTokenSchema, AnnotationUpdateResultSchema, AppearanceOutcomeSchema, AttachmentCreateResultSchema, AttachmentDeleteResultSchema, AttachmentFileInfoSchema, AttachmentsCacheSchema, BaseVersionInfoSchema, BlendModeSchema, ByteRangeSchema, CacheDeltaSchema, CachePinsSchema, CalloutLineSchema, CaretDTOSchema, CaretDraftSchema, CaretIntentSchema, CaretPatchSchema, ChangeAnalysisSchema, CircleDTOSchema, CircleDraftSchema, CirclePatchSchema, ColorSchema, ContentTokenSchema, DEFAULT_LAYER_NAME, DOC_RESOURCES, DigestAlgorithmSchema, DocTokenSchema, DocumentActionsSnapshotSchema, DocumentHeadSchema, DocumentManifestSchema, DocumentMetadataSchema, DocumentProtectionSchema, DocumentSecurityStateSchema, DocumentVersionRefSchema, DocumentVersionSchema, DocumentVersionsSchema, EmbeddedFileItemSchema, EmbeddedFileRefSchema, EngineErrorPayloadSchema, FieldLockSpecSchema, 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, LayerAnalysisQuerySchema, LayerScopesSchema, LayoutTokenSchema, LineCaptionPatchSchema, LineDTOSchema, LineDimensionCaptionSchema, LineDraftSchema, LineEndingSchema, LineEndingsSchema, LineIntentSchema, LineLeaderSchema, LinePatchSchema, LinePointsSchema, LinkDTOSchema, LinkDraftSchema, LinkPatchSchema, ManifestPageSchema, MetadataPatchSchema, MetadataTokenSchema, MetadataUpdateResultSchema, ModificationLevelSchema, MutationMetaSchema, NamedPageEntrySchema, NoteIconSchema, OpenDocumentResponseSchema, PageBoxesSchema, PageDeleteInputSchema, PageDeleteResultSchema, PageExtractInputSchema, PageFlattenInputSchema, PageFlattenResultSchema, PageGeometrySnapshotSchema, PageInsertBlankInputSchema, PageInsertInputSchema, PageInsertResultSchema, PageLayoutSchema, PageListSnapshotSchema, PageMeasurementViewportSchema, PageMoveInputSchema, PageMoveResultSchema, PageNameInputSchema, PageNameResultSchema, PageNetworkRenderFormatSchema, PageRemoveNameInputSchema, PageRenderAnnotatedQuerySchema, PageRenderQuerySchema, PageRotateInputSchema, PageRotateResultSchema, PageScaleInputSchema, PageScaleResultSchema, PageStateSchema, PageStructureCacheSchema, PageTextSnapshotSchema, PdfActionNodeSchema, PdfActionTargetRefSchema, PdfActionTreeSchema, PdfActionTypeSchema, PdfActionWireComponents, PdfAnnotationActionsSchema, PdfDestinationSchema, PdfFieldActionsSchema, PdfForeignMeasureSchema, PdfLinkTargetSchema, PdfLinkTargetWritableSchema, PdfMeasureSchema, PdfMeasureWriteSchema, PdfMeasurementSchema, PdfNumberFormatSchema, PdfPageActionsSchema, PdfPointSchema, PdfQuadSchema, PdfRectDifferencesSchema, PdfRectSchema, PdfRevisionSchema, PdfRotationSchema, PdfSaveModeSchema, PdfSizeSchema, PointSchema, PolygonDTOSchema, PolygonDraftSchema, PolygonIntentSchema, PolygonPatchSchema, PolylineDTOSchema, PolylineDraftSchema, PolylineIntentSchema, PolylinePatchSchema, RectSchema, RedactionApplyResultSchema, RedactionApplyScopeSchema, RefetchReasonSchema, RenderTokenSchema, ResourceRefSchema, RevisionTokenSchema, SEARCH_RESULT_FORMAT, SearchMatchSchema, SearchModeSchema, SearchQuerySchema, SearchRequestSchema, SearchSliceSchema, SearchSnippetSchema, SearchTokenSchema, ShapeCaptionPatchSchema, ShapeDimensionCaptionSchema, SignatureAbortResultSchema, SignatureAppearanceBodySchema, SignatureCompleteBodySchema, SignatureCompleteResultSchema, SignatureDTOSchema, SignaturePrepareBodySchema, SignaturePreparedWireSchema, SignatureSeedValueSchema, SignatureSnapshotSchema, SquareDTOSchema, SquareDraftSchema, SquarePatchSchema, SquigglyDTOSchema, SquigglyDraftSchema, SquigglyPatchSchema, StampDTOSchema, StampWireDraftSchema, StampWirePatchSchema, StandardFontSchema, StrikeoutDTOSchema, StrikeoutDraftSchema, StrikeoutIntentSchema, StrikeoutPatchSchema, TextAlignmentSchema, TextDTOSchema, TextDraftSchema, TextPatchSchema, ToggleFieldWidgetSchema, UnderlineDTOSchema, UnderlineDraftSchema, UnderlinePatchSchema, UnsupportedDTOSchema, UnsupportedDraftSchema, UnsupportedPatchSchema, VersionAnalysisQuerySchema, WeakAnnotationSessionPagesRequestSchema, WeakAnnotationSessionResponseSchema, WidgetAppearanceSchema, WidgetPlacementSchema, WireAttachmentFileSchema, analysisQueryString, analyzeInputFromQuery, annotationAppearancesImageOptionsToToken, annotationAppearancesImageOptionsToWire, annotationRenderOptionsFromImageOptions, applyCdnAccess, cdnCoverageForScope, checkResourceAccess, decodeActionsToken, decodeAnalysisToken, decodeAnnotationAppearancesRenderToken, decodeAnnotationToken, decodeAnnotationsAllToken, decodeAttachmentsToken, decodeContentToken, decodeDocToken, decodeDownloadToken, decodeLayoutToken, decodeMetadataToken, decodePrepared, decodeRenderToken, decodeSearchToken, decodeToken, decodeTokenText, encodeActionsToken, encodeAnalysisToken, encodeAnnotationAppearancesRenderToken, encodeAnnotationToken, encodeAnnotationsAllToken, encodeAttachmentsToken, encodeContentToken, encodeDocToken, encodeDownloadToken, encodeLayoutToken, encodeMetadataToken, encodePrepared, encodeRenderToken, encodeSearchToken, encodeToken, encodeTokenText, flatten, fromBase64, pageRenderOptionsFromImageOptions, renderImageOptionsToToken, renderImageOptionsToWire, resolveResourceIdForPath, toBase64, unflatten, wirePaths, wireTemplates };
+//#region src/wire/changeSchemas.ts
+/**
+* `POST /v1/docs/{docId}/layers/{layerName}/changes`: a request's changes and
+* their answers. A change's bytes (a stamp's drawing, an attached file, a
+* signature's artwork) travel as multipart parts beside the JSON
+* (`resource:{key}`), which names them by key where the change takes them.
+*/
+/** An op's id for its change: 1 to 255 visible ASCII characters, as `opId` always is. */
+const OpIdSchema = z.string().regex(/^[\x21-\x7e]{1,255}$/);
+const FormFieldDisplaySchema = z.enum([
+	"visible",
+	"hidden",
+	"noPrint",
+	"noView"
+]);
+/** One op of a change, as the request sends it. */
+const ChangeOpWireSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("annotations.create"),
+		page: PageRefSchema,
+		data: AnnotationDraftSchema,
+		objectNumber: z.number().int().positive().optional(),
+		resources: AnnotationResourceKeysSchema.optional()
+	}),
+	z.object({
+		type: z.literal("annotations.update"),
+		ref: AnnotationRefSchema,
+		patch: AnnotationPatchSchema,
+		resources: AnnotationResourceKeysSchema.optional(),
+		expect: AnnotationPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("annotations.delete"),
+		ref: AnnotationRefSchema,
+		expect: AnnotationPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("annotations.reorder"),
+		page: PageRefSchema,
+		refs: z.array(AnnotationRefSchema).min(1),
+		position: AnnotationPositionSchema
+	}),
+	z.object({
+		type: z.literal("forms.setValue"),
+		field: FormFieldRefSchema,
+		value: FormFieldValueSchema,
+		expect: FormFieldValueSchema.optional()
+	}),
+	z.object({
+		type: z.literal("forms.setDisplay"),
+		field: FormFieldRefSchema,
+		display: FormFieldDisplaySchema
+	}),
+	z.object({
+		type: z.literal("forms.setAppearanceText"),
+		field: FormFieldRefSchema,
+		text: z.string()
+	}),
+	z.object({
+		type: z.literal("forms.reset"),
+		fields: z.array(FormFieldRefSchema).optional()
+	}),
+	z.object({
+		type: z.literal("forms.create"),
+		draft: FormFieldDraftSchema,
+		objectNumber: z.number().int().positive().optional(),
+		widgetObjectNumbers: z.array(z.number().int().positive()).optional()
+	}),
+	z.object({
+		type: z.literal("forms.update"),
+		field: FormFieldRefSchema,
+		patch: FormFieldPatchSchema,
+		expect: FormFieldPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("forms.delete"),
+		field: FormFieldRefSchema,
+		expect: FormFieldPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("forms.addWidget"),
+		field: FormFieldRefSchema,
+		placement: WidgetPlacementSchema,
+		objectNumber: z.number().int().positive().optional(),
+		splitObjectNumber: z.number().int().positive().optional()
+	}),
+	z.object({
+		type: z.literal("forms.removeWidget"),
+		field: FormFieldRefSchema,
+		widget: AnnotationRefSchema
+	}),
+	z.object({
+		type: z.literal("forms.deleteWidget"),
+		widget: AnnotationRefSchema,
+		expect: WidgetPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("forms.reorderCalculations"),
+		fields: z.array(FormFieldRefSchema).min(1),
+		position: FieldPositionSchema
+	}),
+	z.object({
+		type: z.literal("forms.reorderWidgets"),
+		page: PageRefSchema,
+		widgets: z.array(AnnotationRefSchema).min(1),
+		position: AnnotationPositionSchema
+	}),
+	z.object({
+		type: z.literal("forms.updateWidget"),
+		widget: AnnotationRefSchema,
+		patch: WidgetPatchSchema,
+		expect: WidgetPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("forms.setSignatureAppearance"),
+		field: FormFieldRefSchema,
+		/** The one-page PDF drawn in, as the key of its multipart part. */
+		resources: AppearanceResourceKeysSchema
+	}),
+	z.object({
+		type: z.literal("metadata.update"),
+		patch: MetadataPatchSchema,
+		expect: MetadataPatchSchema.optional()
+	}),
+	z.object({
+		type: z.literal("metadata.updateCustom"),
+		patch: CustomMetadataPatchSchema
+	})
+]);
+/**
+* One change of a request: its `ops`, or `undoOf`, the undo of an earlier
+* change. One object with exactly one of the two, so the wire has no untagged
+* union (the API reference labels variants by a discriminating literal).
+*/
+const ChangeEntryWireSchema = z.object({
+	opId: OpIdSchema,
+	ops: z.array(ChangeOpWireSchema).optional(),
+	undoOf: OpIdSchema.optional()
+}).strict().refine((entry) => entry.ops === void 0 !== (entry.undoOf === void 0), { message: "exactly one of ops or undoOf" });
+/** What a request may hold. */
+const CHANGE_REQUEST_LIMITS = {
+	/** Changes per request. */
+	changes: 64,
+	/** Ops per change. */
+	ops: 512
+};
+/** A `POST …/changes` body: the changes, applied in order, each on its own. */
+const ChangeRequestSchema = z.object({ changes: z.array(ChangeEntryWireSchema).min(1).max(CHANGE_REQUEST_LIMITS.changes) });
+/** What an item can be: an op's type, or a restore (only in an undo). */
+const ChangeItemTypeSchema = z.enum([
+	...ChangeOpWireSchema.options.map((op) => op.shape.type.value),
+	"annotations.restore",
+	"forms.restore"
+]);
+/** What an undo left alone, by name. */
+const SkippedFieldsSchema = z.array(z.string()).optional();
+/** An item of `type`: its verb's result, after the type and what else the item adds. */
+function itemOf(type, result, extra = {}) {
+	return z.object({
+		type: z.literal(type),
+		...extra
+	}).merge(result);
+}
+/**
+* One item of a change's result: what one op did, or that an undo left it
+* alone (`skipped`). Every item names itself by `type`.
+*/
+const ChangeItemSchema = z.union([
+	z.object({
+		type: z.literal("skipped"),
+		/** The item it would have been. */
+		op: ChangeItemTypeSchema,
+		meta: MutationMetaSchema
+	}),
+	itemOf("annotations.create", AnnotationCreateResultSchema, { page: PageRefSchema }),
+	itemOf("annotations.update", AnnotationUpdateResultSchema, {
+		page: PageRefSchema,
+		skipped: SkippedFieldsSchema
+	}),
+	itemOf("annotations.delete", AnnotationDeleteResultSchema, { page: PageRefSchema }),
+	itemOf("annotations.reorder", AnnotationReorderResultSchema, { page: PageRefSchema }),
+	z.object({
+		type: z.literal("annotations.restore"),
+		page: PageRefSchema,
+		annotations: z.array(AnnotationSchema),
+		meta: AnnotationListMutationMetaSchema
+	}),
+	itemOf("forms.setValue", FormSetValueResultSchema),
+	itemOf("forms.setDisplay", FormFieldUpdateResultSchema),
+	itemOf("forms.setAppearanceText", FormFieldUpdateResultSchema),
+	itemOf("forms.reset", FormResetResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("forms.create", FormFieldCreateResultSchema),
+	itemOf("forms.update", FormFieldUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("forms.delete", FormFieldDeleteResultSchema),
+	z.object({
+		type: z.literal("forms.restore"),
+		field: FormFieldDTOSchema,
+		widgets: z.array(WidgetDTOSchema),
+		meta: FormMutationMetaSchema
+	}),
+	itemOf("forms.setSignatureAppearance", FormFieldUpdateResultSchema),
+	itemOf("forms.addWidget", FormWidgetLinkResultSchema),
+	itemOf("forms.removeWidget", FormWidgetLinkResultSchema),
+	itemOf("forms.deleteWidget", FormWidgetDeleteResultSchema),
+	itemOf("forms.restoreWidget", FormWidgetRestoreResultSchema),
+	itemOf("forms.reorderWidgets", FormWidgetsReorderResultSchema),
+	itemOf("forms.reorderCalculations", FormCalculationsReorderResultSchema),
+	itemOf("forms.updateWidget", FormWidgetUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("metadata.update", MetadataUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("metadata.updateCustom", CustomMetadataUpdateResultSchema, { skipped: SkippedFieldsSchema })
+]);
+/** What a change did: one item per op (per step of an undo), and its meta. */
+const ChangeResultSchema = z.object({
+	items: z.array(ChangeItemSchema),
+	meta: MutationMetaSchema
+});
+/** One change's answer: applied with its result, or refused with the error. */
+const ChangeAnswerSchema = z.discriminatedUnion("status", [z.object({
+	opId: z.string(),
+	status: z.literal("applied"),
+	result: ChangeResultSchema
+}), z.object({
+	opId: z.string(),
+	status: z.literal("refused"),
+	error: EngineErrorPayloadSchema
+})]);
+/** A `POST …/changes` response: one answer per change, in order. */
+const ChangeResponseSchema = z.object({ changes: z.array(ChangeAnswerSchema) });
+/**
+* Stable public component names for the change wire model, so an OpenAPI
+* projection names an op, an item and a result once, like
+* `AnnotationWireComponents`.
+*/
+const ChangeWireComponents = {
+	ChangeOp: ChangeOpWireSchema,
+	ChangeItem: ChangeItemSchema,
+	ChangeResult: ChangeResultSchema
+};
+//#endregion
+export { ANNOTATION_KINDS, AccessRequestSchema, AccessResponseSchema, ActionsTokenSchema, AnnotationAppearanceBatchSchema, AnnotationAppearanceExportInputSchema, AnnotationAppearancesQuerySchema, AnnotationAppearancesRenderTokenSchema, AnnotationBorderStyleSchema, AnnotationCreateResultSchema, AnnotationDeleteResultSchema, AnnotationDraftSchema, AnnotationExportSelectionSchema, AnnotationFlattenInputSchema, AnnotationFlattenResultSchema, AnnotationImportBodySchema, AnnotationImportOptionsSchema, AnnotationImportResultSchema, AnnotationListMutationMetaSchema, AnnotationListSchema, AnnotationPatchSchema, AnnotationPositionSchema, AnnotationRefSchema, AnnotationReorderBodySchema, AnnotationReorderResultSchema, AnnotationResourceKeysSchema, AnnotationSchema, AnnotationTokenSchema, AnnotationUpdateResultSchema, AnnotationWireComponents, AnnotationsExportRequestSchema, AppearanceOutcomeSchema, AppearanceResourceKeysSchema, AttachmentCreateResultSchema, AttachmentDeleteResultSchema, AttachmentFileInfoSchema, AttachmentListSchema, AttachmentMutationMetaSchema, AttachmentRefSchema, AttachmentSchema, BaseVersionInfoSchema, BlendModeSchema, BundleLimitsSchema, ByteRangeSchema, CHANGE_REQUEST_LIMITS, CacheDeltaSchema, CachePinsSchema, CalloutLineSchema, CaretDTOSchema, CaretDraftSchema, CaretIntentSchema, CaretPatchSchema, ChangeAnalysisSchema, ChangeAnswerSchema, ChangeEntryWireSchema, ChangeItemSchema, ChangeOpWireSchema, ChangeRequestSchema, ChangeResponseSchema, ChangeResultSchema, ChangeWireComponents, CircleDTOSchema, CircleDraftSchema, CirclePatchSchema, ColorSchema, ContentTokenSchema, CustomMetadataPatchSchema, CustomMetadataSchema, CustomMetadataUpdateResultSchema, DEFAULT_LAYER_NAME, DOC_RESOURCES, DateInputSchema, DigestAlgorithmSchema, DocTokenSchema, DocumentActionsSnapshotSchema, DocumentHeadSchema, DocumentManifestSchema, DocumentMetadataSchema, DocumentProtectionSchema, DocumentSecurityStateSchema, DocumentVersionRefSchema, DocumentVersionSchema, DocumentVersionsSchema, DocumentWireComponents, DrawnBorderStyleSchema, EditSessionAccessSchema, EditSessionStatusSchema, EngineErrorPayloadSchema, FieldActionsPatchSchema, FieldLockSpecSchema, FieldPositionSchema, FieldScriptWriteSchema, FileAttachmentDTOSchema, FileAttachmentDraftSchema, FileAttachmentIconSchema, FileAttachmentPatchSchema, FileResourceKeysSchema, FileWidgetActionsPatchSchema, FormCalculationsReorderBodySchema, FormCalculationsReorderResultSchema, FormExportRequestSchema, FormExportSelectionSchema, FormFieldCreateResultSchema, FormFieldDTOSchema, FormFieldDeleteResultSchema, FormFieldDraftSchema, FormFieldOptionInputSchema, FormFieldOptionSchema, FormFieldPatchSchema, FormFieldRefSchema, FormFieldUpdateResultSchema, FormFieldValueSchema, FormImportBodySchema, FormImportOptionsSchema, FormImportResultSchema, FormKindSchema, FormMutationMetaSchema, FormRepairResultSchema, FormResetBodySchema, FormResetResultSchema, FormSetValueResultSchema, FormSnapshotSchema, FormSubmissionEntrySchema, FormSubmissionReceiptSchema, FormSubmissionRequestSchema, FormTokenSchema, FormValueEntrySchema, FormValuesImportBodySchema, FormValuesImportOptionsSchema, FormValuesImportResultSchema, FormWidgetDeleteResultSchema, FormWidgetLinkResultSchema, FormWidgetRestoreResultSchema, FormWidgetSchema, FormWidgetUpdateBodySchema, FormWidgetUpdateResultSchema, FormWidgetsReorderBodySchema, FormWidgetsReorderResultSchema, FormWireComponents, FreeTextDTOSchema, FreeTextDraftSchema, FreeTextIntentSchema, FreeTextIntentWriteSchema, FreeTextPatchSchema, HighlightDTOSchema, HighlightDraftSchema, HighlightPatchSchema, IdentitySchema, ImageResourceKeysSchema, InkDTOSchema, InkDraftSchema, InkIntentSchema, InkListSchema, InkPatchSchema, IsoDateTimeSchema, KIND_BY_SUBTYPE, LayerAnalysisQuerySchema, LayerScopesSchema, LayoutTokenSchema, LineCaptionPatchSchema, LineDTOSchema, LineDimensionCaptionSchema, LineDraftSchema, LineEndingSchema, LineEndingsSchema, LineIntentSchema, LineLeaderSchema, LinePatchSchema, LinePointsSchema, LinkDTOSchema, LinkDraftSchema, LinkPatchSchema, ManifestPageSchema, MetadataPatchSchema, MetadataTokenSchema, MetadataUpdateResultSchema, ModificationLevelSchema, MutationMetaSchema, NamedPageEntrySchema, NoteIconSchema, ObjectNumberRangeSchema, ObjectNumberReservationRequestSchema, ObjectNumberReservationResponseSchema, OpenDocumentResponseSchema, PAGE_RENDER_FAMILIES, PageBoxSchema, PageBoxesSchema, PageDeleteInputSchema, PageDeleteResultSchema, PageExtractInputSchema, PageFlattenInputSchema, PageFlattenResultSchema, PageGeometrySnapshotSchema, PageInsertBlankInputSchema, PageInsertInputSchema, PageInsertResultSchema, PageLayoutSchema, PageListSnapshotSchema, PageMeasurementViewportListSchema, PageMeasurementViewportSchema, PageNameInputSchema, PageNameResultSchema, PageNetworkRenderFormatSchema, PagePointSchema, PagePositionSchema, PageQuadSchema, PageRefSchema, PageRemoveNameInputSchema, PageRenderQuerySchemas, PageReorderInputSchema, PageReorderResultSchema, PageRotateInputSchema, PageRotateResultSchema, PageScaleInputSchema, PageScaleResultSchema, PageTextSnapshotSchema, PdfActionNodeSchema, PdfActionTargetRefSchema, PdfActionTreeSchema, PdfActionTypeSchema, PdfActionWireComponents, PdfActionWriteSchema, PdfAnnotationActionsSchema, PdfDestinationSchema, PdfFieldActionsSchema, PdfForeignMeasureSchema, PdfLinkTargetSchema, PdfLinkTargetWritableSchema, PdfMeasureSchema, PdfMeasureWriteSchema, PdfMeasurementSchema, PdfNumberFormatSchema, PdfPageActionsSchema, PdfPointSchema, PdfQuadSchema, PdfRectSchema, PdfRevisionSchema, PdfRotationSchema, PdfSaveModeSchema, PdfSizeSchema, PointSchema, PolygonDTOSchema, PolygonDraftSchema, PolygonIntentSchema, PolygonPatchSchema, PolylineDTOSchema, PolylineDraftSchema, PolylineIntentSchema, PolylinePatchSchema, PopupDTOSchema, PopupDraftSchema, PopupPatchSchema, RectSchema, RedactionApplyResultSchema, RedactionApplyScopeSchema, RenderTokenSchema, ResourceKeySchema, SEARCH_RESULT_FORMAT, SearchMatchSchema, SearchQuerySchema, SearchRequestSchema, SearchSliceSchema, SearchSnippetSchema, SearchTokenSchema, ShapeCaptionPatchSchema, ShapeDimensionCaptionSchema, SignatureAppearanceBodySchema, SignatureCancelResultSchema, SignatureCompleteBodySchema, SignatureCompleteResultSchema, SignatureDTOSchema, SignaturePrepareBodySchema, SignaturePreparedWireSchema, SignatureSeedValueSchema, SignatureSnapshotSchema, SourceResourceKeysSchema, SquareDTOSchema, SquareDraftSchema, SquarePatchSchema, SquigglyDTOSchema, SquigglyDraftSchema, SquigglyPatchSchema, StampDTOSchema, StampDraftSchema, StampFitSchema, StampPatchSchema, StandardFontSchema, StrikeoutDTOSchema, StrikeoutDraftSchema, StrikeoutIntentSchema, StrikeoutPatchSchema, TextAlignmentSchema, TextDTOSchema, TextDraftSchema, TextPatchSchema, ToggleFieldWidgetSchema, UnderlineDTOSchema, UnderlineDraftSchema, UnderlinePatchSchema, UnsupportedDTOSchema, UnsupportedDraftSchema, UnsupportedPatchSchema, VersionAnalysisQuerySchema, VerticalAlignmentSchema, WidgetActionsPatchSchema, WidgetAppearanceSchema, WidgetAppearancesQuerySchema, WidgetAppearancesRenderTokenSchema, WidgetBorderStyleSchema, WidgetCheckStyleSchema, WidgetDTOSchema, WidgetPatchSchema, WidgetPlacementSchema, WireAttachmentFileSchema, analysisQueryString, analyzeInputFromQuery, annotationAppearancesImageOptionsToToken, annotationAppearancesImageOptionsToWire, annotationPatchSchemaOf, annotationRenderOptionsFromImageOptions, applyCdnAccess, cdnCoverageForScope, checkResourceAccess, decodeActionsToken, decodeAnalysisToken, decodeAnnotationAppearancesRenderToken, decodeAnnotationToken, decodeAnnotationsAllToken, decodeAnnotationsExportToken, decodeAttachmentsToken, decodeContentToken, decodeDocToken, decodeDownloadToken, decodeFormExportToken, decodeFormToken, decodeLayoutToken, decodeMetadataToken, decodePrepared, decodeRenderToken, decodeSearchToken, decodeToken, decodeTokenText, decodeWidgetAppearancesRenderToken, encodeActionsToken, encodeAnalysisToken, encodeAnnotationAppearancesRenderToken, encodeAnnotationToken, encodeAnnotationsAllToken, encodeAnnotationsExportToken, encodeAppearanceModes, encodeAttachmentsToken, encodeContentToken, encodeDocToken, encodeDownloadToken, encodeFormExportToken, encodeFormToken, encodeLayoutToken, encodeMetadataToken, encodePrepared, encodeRenderToken, encodeSearchToken, encodeToken, encodeTokenText, encodeWidgetAppearancesRenderToken, flatten, fromBase64, pageRenderFamilyOf, pageRenderOptionsFromImageOptions, renderImageOptionsToToken, renderImageOptionsToWire, resolveResourceIdForPath, toBase64, unflatten, widgetAppearancesImageOptionsToToken, widgetAppearancesImageOptionsToWire, wirePaths, wireTemplates };
 
 //# sourceMappingURL=wire.js.map