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

package/dist/wire.cjs

@@ -1,6 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_resolver = require("./resolver-CYVNV4hn.cjs");
-const require_schemas = require("./schemas-D0g6tKa9.cjs");
+const require_format = require("./format-Bp3QFSH1.cjs");
+const require_resolver = require("./resolver-D2OCtE8F.cjs");
+const require_charmap = require("./charmap-aYlefQP9.cjs");
+const require_schema = require("./schema-C-gU4vj7.cjs");
+const require_schemas = require("./schemas-Berf1swF.cjs");
 let zod = require("zod");
 //#region src/forms/submission.ts
 const FormSubmissionEntrySchema = zod.z.object({
@@ -30,11 +33,11 @@ const FormSubmissionRequestSchema = zod.z.object({
 		"hover",
 		"lifecycle"
 	]),
-	clientTimeMs: zod.z.number().finite()
+	sentAt: require_schema.IsoDateTimeSchema
 });
 const FormSubmissionReceiptSchema = zod.z.object({
 	submissionId: zod.z.string().min(1),
-	receivedAt: zod.z.string().min(1)
+	receivedAt: require_schema.IsoDateTimeSchema
 });
 //#endregion
 //#region src/wire/token.ts
@@ -115,6 +118,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"] };
 /**
@@ -141,12 +168,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: [
@@ -157,13 +185,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
 };
@@ -174,22 +203,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
@@ -197,18 +226,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
 };
@@ -266,6 +317,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, require_resolver.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) => require_format.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" ? require_resolver.decodeAnnotKey(require_format.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(require_format.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) => require_format.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" ? require_format.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 });
@@ -285,7 +425,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.
 */
@@ -302,18 +442,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, {
@@ -325,17 +471,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 } : {},
@@ -344,16 +490,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 } : {}
 		} } : {}
 	};
 };
@@ -407,7 +553,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
@@ -419,28 +565,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}
 *
@@ -457,16 +614,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
@@ -504,9 +666,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`,
@@ -520,12 +682,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). */
@@ -539,7 +710,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. */
@@ -558,13 +729,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`. */
@@ -581,14 +754,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(require_format.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(require_format.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.
@@ -596,55 +769,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(require_format.encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageText: (docId, layerName, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageTextCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/text/pages/${encodeURIComponent(require_format.encodePageKey(page))}/data`,
+	docPageGeometry: (docId, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	docPageGeometryCurrent: (docId, page) => `/v1/docs/${encodeURIComponent(docId)}/geometry/pages/${encodeURIComponent(require_format.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)}/${require_schemas.PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	docPageRenderCurrent: (docId, family, page) => `/v1/docs/${encodeURIComponent(docId)}/${require_schemas.PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data`,
+	layerPageGeometry: (docId, layerName, page, contentVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeContentToken(contentVersion)}`,
+	layerPageGeometryCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/geometry/pages/${encodeURIComponent(require_format.encodePageKey(page))}/data`,
+	layerPageRender: (docId, layerName, family, page, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${require_schemas.PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	layerPageRenderCurrent: (docId, layerName, family, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${require_schemas.PAGE_RENDER_FAMILIES[family].path}/${encodeURIComponent(require_format.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(require_format.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(require_format.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(require_format.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(require_format.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
@@ -655,28 +833,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(require_format.encodePageKey(page))}/appearances@${encodeAnnotationAppearancesRenderToken(token)}`,
+	layerPageAnnotationAppearancesCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(require_format.encodePageKey(page))}/appearances`,
+	layerPageAnnotationsCreate: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(require_format.encodePageKey(page))}/items`,
+	layerAnnotationByKey: (docId, layerName, page, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(require_format.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(require_format.encodePageKey(page))}/items/${encodeURIComponent(key)}/resources/appearance`,
+	layerPageAnnotationsReorder: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/annotations/pages/${encodeURIComponent(require_format.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(require_format.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(require_format.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(require_format.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(require_format.encodePageKey(page))}/appearances@${encodeWidgetAppearancesRenderToken(token)}`,
+	layerPageFormAppearancesCurrent: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/pages/${encodeURIComponent(require_format.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(require_format.encodePageKey(page))}/reorder`,
+	layerFormWidget: (docId, layerName, page, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/form/widgets/${encodeURIComponent(require_format.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`,
 	/**
@@ -687,9 +889,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
@@ -698,18 +900,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
@@ -719,17 +924,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(require_format.encodePageKey(page))}/viewports`,
+	layerPageScale: (docId, layerName, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/${encodeURIComponent(require_format.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). */
@@ -737,14 +942,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.
 	*/
@@ -754,15 +959,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.
 	*/
@@ -781,22 +977,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",
@@ -811,7 +1015,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",
@@ -822,8 +1026,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 } = require_schemas.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 } = require_schemas.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.
@@ -868,32 +1109,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@*",
@@ -920,6 +1139,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@*",
@@ -946,6 +1217,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@*",
@@ -985,6 +1269,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@*",
@@ -1050,32 +1347,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@*",
@@ -1167,6 +1442,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@*",
@@ -1180,6 +1468,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",
@@ -1326,15 +1653,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,
@@ -1349,14 +1675,20 @@ function checkResourceAccess(resourceId, rawScope, pdfBits) {
 * as every edge grant.
 */
 const RESOURCE_PLANES = {
-	"page-render": ["content"],
+	"page-render": require_schemas.PAGE_RENDER_FAMILIES.pages.planes,
+	"page-render-annotations": require_schemas.PAGE_RENDER_FAMILIES.annotations.planes,
+	"page-render-fields": require_schemas.PAGE_RENDER_FAMILIES.fields.planes,
+	"page-render-all": require_schemas.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"]
@@ -1386,11 +1718,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
@@ -1404,7 +1736,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.
@@ -1465,8 +1797,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;
@@ -1548,33 +1880,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
 	});
 }
 /**
@@ -1585,17 +1906,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
 	};
 }
 /**
@@ -1604,15 +1926,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 = require_charmap.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
@@ -1621,67 +1961,326 @@ 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
-exports.ANNOTATION_KINDS = require_schemas.ANNOTATION_KINDS;
+//#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 = zod.z.string().regex(/^[\x21-\x7e]{1,255}$/);
+const FormFieldDisplaySchema = zod.z.enum([
+	"visible",
+	"hidden",
+	"noPrint",
+	"noView"
+]);
+/** One op of a change, as the request sends it. */
+const ChangeOpWireSchema = zod.z.discriminatedUnion("type", [
+	zod.z.object({
+		type: zod.z.literal("annotations.create"),
+		page: require_schema.PageRefSchema,
+		data: require_schema.AnnotationDraftSchema,
+		objectNumber: zod.z.number().int().positive().optional(),
+		resources: require_schema.AnnotationResourceKeysSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("annotations.update"),
+		ref: require_schema.AnnotationRefSchema,
+		patch: require_schema.AnnotationPatchSchema,
+		resources: require_schema.AnnotationResourceKeysSchema.optional(),
+		expect: require_schema.AnnotationPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("annotations.delete"),
+		ref: require_schema.AnnotationRefSchema,
+		expect: require_schema.AnnotationPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("annotations.reorder"),
+		page: require_schema.PageRefSchema,
+		refs: zod.z.array(require_schema.AnnotationRefSchema).min(1),
+		position: require_schemas.AnnotationPositionSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.setValue"),
+		field: require_schema.FormFieldRefSchema,
+		value: require_schema.FormFieldValueSchema,
+		expect: require_schema.FormFieldValueSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.setDisplay"),
+		field: require_schema.FormFieldRefSchema,
+		display: FormFieldDisplaySchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.setAppearanceText"),
+		field: require_schema.FormFieldRefSchema,
+		text: zod.z.string()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.reset"),
+		fields: zod.z.array(require_schema.FormFieldRefSchema).optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.create"),
+		draft: require_schema.FormFieldDraftSchema,
+		objectNumber: zod.z.number().int().positive().optional(),
+		widgetObjectNumbers: zod.z.array(zod.z.number().int().positive()).optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.update"),
+		field: require_schema.FormFieldRefSchema,
+		patch: require_schema.FormFieldPatchSchema,
+		expect: require_schema.FormFieldPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.delete"),
+		field: require_schema.FormFieldRefSchema,
+		expect: require_schema.FormFieldPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.addWidget"),
+		field: require_schema.FormFieldRefSchema,
+		placement: require_schema.WidgetPlacementSchema,
+		objectNumber: zod.z.number().int().positive().optional(),
+		splitObjectNumber: zod.z.number().int().positive().optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.removeWidget"),
+		field: require_schema.FormFieldRefSchema,
+		widget: require_schema.AnnotationRefSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.deleteWidget"),
+		widget: require_schema.AnnotationRefSchema,
+		expect: require_schema.WidgetPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.reorderCalculations"),
+		fields: zod.z.array(require_schema.FormFieldRefSchema).min(1),
+		position: require_schemas.FieldPositionSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.reorderWidgets"),
+		page: require_schema.PageRefSchema,
+		widgets: zod.z.array(require_schema.AnnotationRefSchema).min(1),
+		position: require_schemas.AnnotationPositionSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.updateWidget"),
+		widget: require_schema.AnnotationRefSchema,
+		patch: require_schema.WidgetPatchSchema,
+		expect: require_schema.WidgetPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("forms.setSignatureAppearance"),
+		field: require_schema.FormFieldRefSchema,
+		/** The one-page PDF drawn in, as the key of its multipart part. */
+		resources: require_schema.AppearanceResourceKeysSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("metadata.update"),
+		patch: require_schemas.MetadataPatchSchema,
+		expect: require_schemas.MetadataPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("metadata.updateCustom"),
+		patch: require_schemas.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 = zod.z.object({
+	opId: OpIdSchema,
+	ops: zod.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 = zod.z.object({ changes: zod.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 = zod.z.enum([
+	...ChangeOpWireSchema.options.map((op) => op.shape.type.value),
+	"annotations.restore",
+	"forms.restore"
+]);
+/** What an undo left alone, by name. */
+const SkippedFieldsSchema = zod.z.array(zod.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 zod.z.object({
+		type: zod.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 = zod.z.union([
+	zod.z.object({
+		type: zod.z.literal("skipped"),
+		/** The item it would have been. */
+		op: ChangeItemTypeSchema,
+		meta: require_schemas.MutationMetaSchema
+	}),
+	itemOf("annotations.create", require_schemas.AnnotationCreateResultSchema, { page: require_schema.PageRefSchema }),
+	itemOf("annotations.update", require_schemas.AnnotationUpdateResultSchema, {
+		page: require_schema.PageRefSchema,
+		skipped: SkippedFieldsSchema
+	}),
+	itemOf("annotations.delete", require_schemas.AnnotationDeleteResultSchema, { page: require_schema.PageRefSchema }),
+	itemOf("annotations.reorder", require_schemas.AnnotationReorderResultSchema, { page: require_schema.PageRefSchema }),
+	zod.z.object({
+		type: zod.z.literal("annotations.restore"),
+		page: require_schema.PageRefSchema,
+		annotations: zod.z.array(require_schema.AnnotationSchema),
+		meta: require_schemas.AnnotationListMutationMetaSchema
+	}),
+	itemOf("forms.setValue", require_schemas.FormSetValueResultSchema),
+	itemOf("forms.setDisplay", require_schemas.FormFieldUpdateResultSchema),
+	itemOf("forms.setAppearanceText", require_schemas.FormFieldUpdateResultSchema),
+	itemOf("forms.reset", require_schemas.FormResetResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("forms.create", require_schemas.FormFieldCreateResultSchema),
+	itemOf("forms.update", require_schemas.FormFieldUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("forms.delete", require_schemas.FormFieldDeleteResultSchema),
+	zod.z.object({
+		type: zod.z.literal("forms.restore"),
+		field: require_schema.FormFieldDTOSchema,
+		widgets: zod.z.array(require_schema.WidgetDTOSchema),
+		meta: require_schemas.FormMutationMetaSchema
+	}),
+	itemOf("forms.setSignatureAppearance", require_schemas.FormFieldUpdateResultSchema),
+	itemOf("forms.addWidget", require_schemas.FormWidgetLinkResultSchema),
+	itemOf("forms.removeWidget", require_schemas.FormWidgetLinkResultSchema),
+	itemOf("forms.deleteWidget", require_schemas.FormWidgetDeleteResultSchema),
+	itemOf("forms.restoreWidget", require_schemas.FormWidgetRestoreResultSchema),
+	itemOf("forms.reorderWidgets", require_schemas.FormWidgetsReorderResultSchema),
+	itemOf("forms.reorderCalculations", require_schemas.FormCalculationsReorderResultSchema),
+	itemOf("forms.updateWidget", require_schemas.FormWidgetUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("metadata.update", require_schemas.MetadataUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("metadata.updateCustom", require_schemas.CustomMetadataUpdateResultSchema, { skipped: SkippedFieldsSchema })
+]);
+/** What a change did: one item per op (per step of an undo), and its meta. */
+const ChangeResultSchema = zod.z.object({
+	items: zod.z.array(ChangeItemSchema),
+	meta: require_schemas.MutationMetaSchema
+});
+/** One change's answer: applied with its result, or refused with the error. */
+const ChangeAnswerSchema = zod.z.discriminatedUnion("status", [zod.z.object({
+	opId: zod.z.string(),
+	status: zod.z.literal("applied"),
+	result: ChangeResultSchema
+}), zod.z.object({
+	opId: zod.z.string(),
+	status: zod.z.literal("refused"),
+	error: require_schemas.EngineErrorPayloadSchema
+})]);
+/** A `POST …/changes` response: one answer per change, in order. */
+const ChangeResponseSchema = zod.z.object({ changes: zod.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
+exports.ANNOTATION_KINDS = require_schema.ANNOTATION_KINDS;
 exports.AccessRequestSchema = require_schemas.AccessRequestSchema;
 exports.AccessResponseSchema = require_schemas.AccessResponseSchema;
 exports.ActionsTokenSchema = ActionsTokenSchema;
+exports.AnnotationAppearanceBatchSchema = require_schemas.AnnotationAppearanceBatchSchema;
 exports.AnnotationAppearanceExportInputSchema = require_schemas.AnnotationAppearanceExportInputSchema;
-exports.AnnotationAppearanceManifestSchema = require_schemas.AnnotationAppearanceManifestSchema;
 exports.AnnotationAppearancesQuerySchema = require_schemas.AnnotationAppearancesQuerySchema;
 exports.AnnotationAppearancesRenderTokenSchema = AnnotationAppearancesRenderTokenSchema;
-exports.AnnotationBaseShape = require_schemas.AnnotationBaseShape;
-exports.AnnotationBorderStyleSchema = require_schemas.AnnotationBorderStyleSchema;
+exports.AnnotationBorderStyleSchema = require_schema.AnnotationBorderStyleSchema;
 exports.AnnotationCreateResultSchema = require_schemas.AnnotationCreateResultSchema;
-exports.AnnotationDTOSchema = require_schemas.AnnotationDTOSchema;
 exports.AnnotationDeleteResultSchema = require_schemas.AnnotationDeleteResultSchema;
-exports.AnnotationDraftBaseShape = require_schemas.AnnotationDraftBaseShape;
-exports.AnnotationDraftSchema = require_schemas.AnnotationDraftSchema;
-exports.AnnotationFlagsPartialSchema = require_schemas.AnnotationFlagsPartialSchema;
-exports.AnnotationFlagsSchema = require_schemas.AnnotationFlagsSchema;
+exports.AnnotationDraftSchema = require_schema.AnnotationDraftSchema;
+exports.AnnotationExportSelectionSchema = require_schemas.AnnotationExportSelectionSchema;
 exports.AnnotationFlattenInputSchema = require_schemas.AnnotationFlattenInputSchema;
 exports.AnnotationFlattenResultSchema = require_schemas.AnnotationFlattenResultSchema;
+exports.AnnotationImportBodySchema = require_schemas.AnnotationImportBodySchema;
+exports.AnnotationImportOptionsSchema = require_schemas.AnnotationImportOptionsSchema;
+exports.AnnotationImportResultSchema = require_schemas.AnnotationImportResultSchema;
 exports.AnnotationListMutationMetaSchema = require_schemas.AnnotationListMutationMetaSchema;
-exports.AnnotationListPageSnapshotSchema = require_schemas.AnnotationListPageSnapshotSchema;
-exports.AnnotationListSnapshotAllPagesSchema = require_schemas.AnnotationListSnapshotAllPagesSchema;
-exports.AnnotationMoveResultSchema = require_schemas.AnnotationMoveResultSchema;
-exports.AnnotationPatchBaseShape = require_schemas.AnnotationPatchBaseShape;
-exports.AnnotationPatchSchema = require_schemas.AnnotationPatchSchema;
-exports.AnnotationRefSchema = require_schemas.AnnotationRefSchema;
-exports.AnnotationStableIdSchema = require_schemas.AnnotationStableIdSchema;
+exports.AnnotationListSchema = require_schemas.AnnotationListSchema;
+exports.AnnotationPatchSchema = require_schema.AnnotationPatchSchema;
+exports.AnnotationPositionSchema = require_schemas.AnnotationPositionSchema;
+exports.AnnotationRefSchema = require_schema.AnnotationRefSchema;
+exports.AnnotationReorderBodySchema = require_schemas.AnnotationReorderBodySchema;
+exports.AnnotationReorderResultSchema = require_schemas.AnnotationReorderResultSchema;
+exports.AnnotationResourceKeysSchema = require_schema.AnnotationResourceKeysSchema;
+exports.AnnotationSchema = require_schema.AnnotationSchema;
 exports.AnnotationTokenSchema = AnnotationTokenSchema;
 exports.AnnotationUpdateResultSchema = require_schemas.AnnotationUpdateResultSchema;
+exports.AnnotationWireComponents = require_schemas.AnnotationWireComponents;
+exports.AnnotationsExportRequestSchema = require_schemas.AnnotationsExportRequestSchema;
 exports.AppearanceOutcomeSchema = require_schemas.AppearanceOutcomeSchema;
+exports.AppearanceResourceKeysSchema = require_schema.AppearanceResourceKeysSchema;
 exports.AttachmentCreateResultSchema = require_schemas.AttachmentCreateResultSchema;
 exports.AttachmentDeleteResultSchema = require_schemas.AttachmentDeleteResultSchema;
-exports.AttachmentFileInfoSchema = require_schemas.AttachmentFileInfoSchema;
-exports.AttachmentsCacheSchema = require_schemas.AttachmentsCacheSchema;
+exports.AttachmentFileInfoSchema = require_schema.AttachmentFileInfoSchema;
+exports.AttachmentListSchema = require_schemas.AttachmentListSchema;
+exports.AttachmentMutationMetaSchema = require_schemas.AttachmentMutationMetaSchema;
+exports.AttachmentRefSchema = require_schema.AttachmentRefSchema;
+exports.AttachmentSchema = require_schema.AttachmentSchema;
 exports.BaseVersionInfoSchema = require_schemas.BaseVersionInfoSchema;
-exports.BlendModeSchema = require_schemas.BlendModeSchema;
+exports.BlendModeSchema = require_schema.BlendModeSchema;
+exports.BundleLimitsSchema = require_schemas.BundleLimitsSchema;
 exports.ByteRangeSchema = require_schemas.ByteRangeSchema;
+exports.CHANGE_REQUEST_LIMITS = CHANGE_REQUEST_LIMITS;
 exports.CacheDeltaSchema = require_schemas.CacheDeltaSchema;
 exports.CachePinsSchema = require_schemas.CachePinsSchema;
-exports.CalloutLineSchema = require_schemas.CalloutLineSchema;
-exports.CaretDTOSchema = require_schemas.CaretDTOSchema;
-exports.CaretDraftSchema = require_schemas.CaretDraftSchema;
-exports.CaretIntentSchema = require_schemas.CaretIntentSchema;
-exports.CaretPatchSchema = require_schemas.CaretPatchSchema;
+exports.CalloutLineSchema = require_schema.CalloutLineSchema;
+exports.CaretDTOSchema = require_schema.CaretDTOSchema;
+exports.CaretDraftSchema = require_schema.CaretDraftSchema;
+exports.CaretIntentSchema = require_schema.CaretIntentSchema;
+exports.CaretPatchSchema = require_schema.CaretPatchSchema;
 exports.ChangeAnalysisSchema = require_schemas.ChangeAnalysisSchema;
-exports.CircleDTOSchema = require_schemas.CircleDTOSchema;
-exports.CircleDraftSchema = require_schemas.CircleDraftSchema;
-exports.CirclePatchSchema = require_schemas.CirclePatchSchema;
-exports.ColorSchema = require_schemas.ColorSchema;
+exports.ChangeAnswerSchema = ChangeAnswerSchema;
+exports.ChangeEntryWireSchema = ChangeEntryWireSchema;
+exports.ChangeItemSchema = ChangeItemSchema;
+exports.ChangeOpWireSchema = ChangeOpWireSchema;
+exports.ChangeRequestSchema = ChangeRequestSchema;
+exports.ChangeResponseSchema = ChangeResponseSchema;
+exports.ChangeResultSchema = ChangeResultSchema;
+exports.ChangeWireComponents = ChangeWireComponents;
+exports.CircleDTOSchema = require_schema.CircleDTOSchema;
+exports.CircleDraftSchema = require_schema.CircleDraftSchema;
+exports.CirclePatchSchema = require_schema.CirclePatchSchema;
+exports.ColorSchema = require_schema.ColorSchema;
 exports.ContentTokenSchema = ContentTokenSchema;
+exports.CustomMetadataPatchSchema = require_schemas.CustomMetadataPatchSchema;
+exports.CustomMetadataSchema = require_schemas.CustomMetadataSchema;
+exports.CustomMetadataUpdateResultSchema = require_schemas.CustomMetadataUpdateResultSchema;
 exports.DEFAULT_LAYER_NAME = DEFAULT_LAYER_NAME;
 exports.DOC_RESOURCES = DOC_RESOURCES;
+exports.DateInputSchema = require_schema.DateInputSchema;
 exports.DigestAlgorithmSchema = require_schemas.DigestAlgorithmSchema;
 exports.DocTokenSchema = DocTokenSchema;
-exports.DocumentActionsSnapshotSchema = require_schemas.DocumentActionsSnapshotSchema;
+exports.DocumentActionsSnapshotSchema = require_schema.DocumentActionsSnapshotSchema;
 exports.DocumentHeadSchema = require_schemas.DocumentHeadSchema;
 exports.DocumentManifestSchema = require_schemas.DocumentManifestSchema;
 exports.DocumentMetadataSchema = require_schemas.DocumentMetadataSchema;
@@ -1690,68 +2289,95 @@ exports.DocumentSecurityStateSchema = require_schemas.DocumentSecurityStateSchem
 exports.DocumentVersionRefSchema = require_schemas.DocumentVersionRefSchema;
 exports.DocumentVersionSchema = require_schemas.DocumentVersionSchema;
 exports.DocumentVersionsSchema = require_schemas.DocumentVersionsSchema;
-exports.EmbeddedFileItemSchema = require_schemas.EmbeddedFileItemSchema;
-exports.EmbeddedFileRefSchema = require_schemas.EmbeddedFileRefSchema;
+exports.DocumentWireComponents = require_schemas.DocumentWireComponents;
+exports.DrawnBorderStyleSchema = require_schema.DrawnBorderStyleSchema;
+exports.EditSessionAccessSchema = require_schemas.EditSessionAccessSchema;
+exports.EditSessionStatusSchema = require_schemas.EditSessionStatusSchema;
 exports.EngineErrorPayloadSchema = require_schemas.EngineErrorPayloadSchema;
+exports.FieldActionsPatchSchema = require_schema.FieldActionsPatchSchema;
 exports.FieldLockSpecSchema = require_schemas.FieldLockSpecSchema;
-exports.FileAttachmentDTOSchema = require_schemas.FileAttachmentDTOSchema;
-exports.FileAttachmentIconSchema = require_schemas.FileAttachmentIconSchema;
-exports.FileAttachmentPatchSchema = require_schemas.FileAttachmentPatchSchema;
-exports.FileAttachmentWireDraftSchema = require_schemas.FileAttachmentWireDraftSchema;
-exports.FormDataFormatSchema = require_schemas.FormDataFormatSchema;
-exports.FormEffectSchema = require_schemas.FormEffectSchema;
-exports.FormEffectsResultSchema = require_schemas.FormEffectsResultSchema;
+exports.FieldPositionSchema = require_schemas.FieldPositionSchema;
+exports.FieldScriptWriteSchema = require_schema.FieldScriptWriteSchema;
+exports.FileAttachmentDTOSchema = require_schema.FileAttachmentDTOSchema;
+exports.FileAttachmentDraftSchema = require_schema.FileAttachmentDraftSchema;
+exports.FileAttachmentIconSchema = require_schema.FileAttachmentIconSchema;
+exports.FileAttachmentPatchSchema = require_schema.FileAttachmentPatchSchema;
+exports.FileResourceKeysSchema = require_schema.FileResourceKeysSchema;
+exports.FileWidgetActionsPatchSchema = require_schema.FileWidgetActionsPatchSchema;
+exports.FormCalculationsReorderBodySchema = require_schemas.FormCalculationsReorderBodySchema;
+exports.FormCalculationsReorderResultSchema = require_schemas.FormCalculationsReorderResultSchema;
+exports.FormExportRequestSchema = require_schemas.FormExportRequestSchema;
+exports.FormExportSelectionSchema = require_schemas.FormExportSelectionSchema;
 exports.FormFieldCreateResultSchema = require_schemas.FormFieldCreateResultSchema;
-exports.FormFieldDTOSchema = require_schemas.FormFieldDTOSchema;
+exports.FormFieldDTOSchema = require_schema.FormFieldDTOSchema;
 exports.FormFieldDeleteResultSchema = require_schemas.FormFieldDeleteResultSchema;
-exports.FormFieldDraftSchema = require_schemas.FormFieldDraftSchema;
-exports.FormFieldFlagsSchema = require_schemas.FormFieldFlagsSchema;
-exports.FormFieldOptionInputSchema = require_schemas.FormFieldOptionInputSchema;
-exports.FormFieldOptionSchema = require_schemas.FormFieldOptionSchema;
-exports.FormFieldPatchSchema = require_schemas.FormFieldPatchSchema;
-exports.FormFieldRefSchema = require_schemas.FormFieldRefSchema;
+exports.FormFieldDraftSchema = require_schema.FormFieldDraftSchema;
+exports.FormFieldOptionInputSchema = require_schema.FormFieldOptionInputSchema;
+exports.FormFieldOptionSchema = require_schema.FormFieldOptionSchema;
+exports.FormFieldPatchSchema = require_schema.FormFieldPatchSchema;
+exports.FormFieldRefSchema = require_schema.FormFieldRefSchema;
 exports.FormFieldUpdateResultSchema = require_schemas.FormFieldUpdateResultSchema;
-exports.FormFieldValueSchema = require_schemas.FormFieldValueSchema;
+exports.FormFieldValueSchema = require_schema.FormFieldValueSchema;
+exports.FormImportBodySchema = require_schemas.FormImportBodySchema;
+exports.FormImportOptionsSchema = require_schemas.FormImportOptionsSchema;
 exports.FormImportResultSchema = require_schemas.FormImportResultSchema;
-exports.FormKindSchema = require_schemas.FormKindSchema;
+exports.FormKindSchema = require_schema.FormKindSchema;
+exports.FormMutationMetaSchema = require_schemas.FormMutationMetaSchema;
 exports.FormRepairResultSchema = require_schemas.FormRepairResultSchema;
+exports.FormResetBodySchema = require_schemas.FormResetBodySchema;
+exports.FormResetResultSchema = require_schemas.FormResetResultSchema;
 exports.FormSetValueResultSchema = require_schemas.FormSetValueResultSchema;
-exports.FormSnapshotSchema = require_schemas.FormSnapshotSchema;
+exports.FormSnapshotSchema = require_schema.FormSnapshotSchema;
 exports.FormSubmissionEntrySchema = FormSubmissionEntrySchema;
 exports.FormSubmissionReceiptSchema = FormSubmissionReceiptSchema;
 exports.FormSubmissionRequestSchema = FormSubmissionRequestSchema;
-exports.FormValueEntrySchema = require_schemas.FormValueEntrySchema;
+exports.FormTokenSchema = FormTokenSchema;
+exports.FormValueEntrySchema = require_schema.FormValueEntrySchema;
+exports.FormValuesImportBodySchema = require_schemas.FormValuesImportBodySchema;
+exports.FormValuesImportOptionsSchema = require_schemas.FormValuesImportOptionsSchema;
+exports.FormValuesImportResultSchema = require_schemas.FormValuesImportResultSchema;
+exports.FormWidgetDeleteResultSchema = require_schemas.FormWidgetDeleteResultSchema;
 exports.FormWidgetLinkResultSchema = require_schemas.FormWidgetLinkResultSchema;
-exports.FormWidgetRefSchema = require_schemas.FormWidgetRefSchema;
-exports.FreeTextDTOSchema = require_schemas.FreeTextDTOSchema;
-exports.FreeTextDraftSchema = require_schemas.FreeTextDraftSchema;
-exports.FreeTextIntentSchema = require_schemas.FreeTextIntentSchema;
-exports.FreeTextPatchSchema = require_schemas.FreeTextPatchSchema;
-exports.HighlightDTOSchema = require_schemas.HighlightDTOSchema;
-exports.HighlightDraftSchema = require_schemas.HighlightDraftSchema;
-exports.HighlightPatchSchema = require_schemas.HighlightPatchSchema;
-exports.InkDTOSchema = require_schemas.InkDTOSchema;
-exports.InkDraftSchema = require_schemas.InkDraftSchema;
-exports.InkIntentSchema = require_schemas.InkIntentSchema;
-exports.InkListSchema = require_schemas.InkListSchema;
-exports.InkPatchSchema = require_schemas.InkPatchSchema;
-exports.KIND_BY_SUBTYPE = require_schemas.KIND_BY_SUBTYPE;
+exports.FormWidgetRestoreResultSchema = require_schemas.FormWidgetRestoreResultSchema;
+exports.FormWidgetSchema = require_schema.FormWidgetSchema;
+exports.FormWidgetUpdateBodySchema = require_schemas.FormWidgetUpdateBodySchema;
+exports.FormWidgetUpdateResultSchema = require_schemas.FormWidgetUpdateResultSchema;
+exports.FormWidgetsReorderBodySchema = require_schemas.FormWidgetsReorderBodySchema;
+exports.FormWidgetsReorderResultSchema = require_schemas.FormWidgetsReorderResultSchema;
+exports.FormWireComponents = require_schemas.FormWireComponents;
+exports.FreeTextDTOSchema = require_schema.FreeTextDTOSchema;
+exports.FreeTextDraftSchema = require_schema.FreeTextDraftSchema;
+exports.FreeTextIntentSchema = require_schema.FreeTextIntentSchema;
+exports.FreeTextIntentWriteSchema = require_schema.FreeTextIntentWriteSchema;
+exports.FreeTextPatchSchema = require_schema.FreeTextPatchSchema;
+exports.HighlightDTOSchema = require_schema.HighlightDTOSchema;
+exports.HighlightDraftSchema = require_schema.HighlightDraftSchema;
+exports.HighlightPatchSchema = require_schema.HighlightPatchSchema;
+exports.IdentitySchema = require_schemas.IdentitySchema;
+exports.ImageResourceKeysSchema = require_schema.ImageResourceKeysSchema;
+exports.InkDTOSchema = require_schema.InkDTOSchema;
+exports.InkDraftSchema = require_schema.InkDraftSchema;
+exports.InkIntentSchema = require_schema.InkIntentSchema;
+exports.InkListSchema = require_schema.InkListSchema;
+exports.InkPatchSchema = require_schema.InkPatchSchema;
+exports.IsoDateTimeSchema = require_schema.IsoDateTimeSchema;
+exports.KIND_BY_SUBTYPE = require_schema.KIND_BY_SUBTYPE;
 exports.LayerAnalysisQuerySchema = require_schemas.LayerAnalysisQuerySchema;
 exports.LayerScopesSchema = require_schemas.LayerScopesSchema;
 exports.LayoutTokenSchema = LayoutTokenSchema;
-exports.LineCaptionPatchSchema = require_schemas.LineCaptionPatchSchema;
-exports.LineDTOSchema = require_schemas.LineDTOSchema;
-exports.LineDimensionCaptionSchema = require_schemas.LineDimensionCaptionSchema;
-exports.LineDraftSchema = require_schemas.LineDraftSchema;
-exports.LineEndingSchema = require_schemas.LineEndingSchema;
-exports.LineEndingsSchema = require_schemas.LineEndingsSchema;
-exports.LineIntentSchema = require_schemas.LineIntentSchema;
-exports.LineLeaderSchema = require_schemas.LineLeaderSchema;
-exports.LinePatchSchema = require_schemas.LinePatchSchema;
-exports.LinePointsSchema = require_schemas.LinePointsSchema;
-exports.LinkDTOSchema = require_schemas.LinkDTOSchema;
-exports.LinkDraftSchema = require_schemas.LinkDraftSchema;
-exports.LinkPatchSchema = require_schemas.LinkPatchSchema;
+exports.LineCaptionPatchSchema = require_schema.LineCaptionPatchSchema;
+exports.LineDTOSchema = require_schema.LineDTOSchema;
+exports.LineDimensionCaptionSchema = require_schema.LineDimensionCaptionSchema;
+exports.LineDraftSchema = require_schema.LineDraftSchema;
+exports.LineEndingSchema = require_schema.LineEndingSchema;
+exports.LineEndingsSchema = require_schema.LineEndingsSchema;
+exports.LineIntentSchema = require_schema.LineIntentSchema;
+exports.LineLeaderSchema = require_schema.LineLeaderSchema;
+exports.LinePatchSchema = require_schema.LinePatchSchema;
+exports.LinePointsSchema = require_schema.LinePointsSchema;
+exports.LinkDTOSchema = require_schema.LinkDTOSchema;
+exports.LinkDraftSchema = require_schema.LinkDraftSchema;
+exports.LinkPatchSchema = require_schema.LinkPatchSchema;
 exports.ManifestPageSchema = require_schemas.ManifestPageSchema;
 exports.MetadataPatchSchema = require_schemas.MetadataPatchSchema;
 exports.MetadataTokenSchema = MetadataTokenSchema;
@@ -1759,8 +2385,13 @@ exports.MetadataUpdateResultSchema = require_schemas.MetadataUpdateResultSchema;
 exports.ModificationLevelSchema = require_schemas.ModificationLevelSchema;
 exports.MutationMetaSchema = require_schemas.MutationMetaSchema;
 exports.NamedPageEntrySchema = require_schemas.NamedPageEntrySchema;
-exports.NoteIconSchema = require_schemas.NoteIconSchema;
+exports.NoteIconSchema = require_schema.NoteIconSchema;
+exports.ObjectNumberRangeSchema = require_schemas.ObjectNumberRangeSchema;
+exports.ObjectNumberReservationRequestSchema = require_schemas.ObjectNumberReservationRequestSchema;
+exports.ObjectNumberReservationResponseSchema = require_schemas.ObjectNumberReservationResponseSchema;
 exports.OpenDocumentResponseSchema = require_schemas.OpenDocumentResponseSchema;
+exports.PAGE_RENDER_FAMILIES = require_schemas.PAGE_RENDER_FAMILIES;
+exports.PageBoxSchema = require_schema.PageBoxSchema;
 exports.PageBoxesSchema = require_schemas.PageBoxesSchema;
 exports.PageDeleteInputSchema = require_schemas.PageDeleteInputSchema;
 exports.PageDeleteResultSchema = require_schemas.PageDeleteResultSchema;
@@ -1773,74 +2404,76 @@ exports.PageInsertInputSchema = require_schemas.PageInsertInputSchema;
 exports.PageInsertResultSchema = require_schemas.PageInsertResultSchema;
 exports.PageLayoutSchema = require_schemas.PageLayoutSchema;
 exports.PageListSnapshotSchema = require_schemas.PageListSnapshotSchema;
-exports.PageMeasurementViewportSchema = require_schemas.PageMeasurementViewportSchema;
-exports.PageMoveInputSchema = require_schemas.PageMoveInputSchema;
-exports.PageMoveResultSchema = require_schemas.PageMoveResultSchema;
+exports.PageMeasurementViewportListSchema = require_schema.PageMeasurementViewportListSchema;
+exports.PageMeasurementViewportSchema = require_schema.PageMeasurementViewportSchema;
 exports.PageNameInputSchema = require_schemas.PageNameInputSchema;
 exports.PageNameResultSchema = require_schemas.PageNameResultSchema;
 exports.PageNetworkRenderFormatSchema = require_schemas.PageNetworkRenderFormatSchema;
+exports.PagePointSchema = require_schema.PagePointSchema;
+exports.PagePositionSchema = require_schemas.PagePositionSchema;
+exports.PageQuadSchema = require_schema.PageQuadSchema;
+exports.PageRefSchema = require_schema.PageRefSchema;
 exports.PageRemoveNameInputSchema = require_schemas.PageRemoveNameInputSchema;
-exports.PageRenderAnnotatedQuerySchema = require_schemas.PageRenderAnnotatedQuerySchema;
-exports.PageRenderQuerySchema = require_schemas.PageRenderQuerySchema;
+exports.PageRenderQuerySchemas = require_schemas.PageRenderQuerySchemas;
+exports.PageReorderInputSchema = require_schemas.PageReorderInputSchema;
+exports.PageReorderResultSchema = require_schemas.PageReorderResultSchema;
 exports.PageRotateInputSchema = require_schemas.PageRotateInputSchema;
 exports.PageRotateResultSchema = require_schemas.PageRotateResultSchema;
-exports.PageScaleInputSchema = require_schemas.PageScaleInputSchema;
+exports.PageScaleInputSchema = require_schema.PageScaleInputSchema;
 exports.PageScaleResultSchema = require_schemas.PageScaleResultSchema;
-exports.PageStateSchema = require_schemas.PageStateSchema;
-exports.PageStructureCacheSchema = require_schemas.PageStructureCacheSchema;
 exports.PageTextSnapshotSchema = require_schemas.PageTextSnapshotSchema;
-exports.PdfActionNodeSchema = require_schemas.PdfActionNodeSchema;
-exports.PdfActionTargetRefSchema = require_schemas.PdfActionTargetRefSchema;
-exports.PdfActionTreeSchema = require_schemas.PdfActionTreeSchema;
-exports.PdfActionTypeSchema = require_schemas.PdfActionTypeSchema;
-exports.PdfActionWireComponents = require_schemas.PdfActionWireComponents;
-exports.PdfAnnotationActionsSchema = require_schemas.PdfAnnotationActionsSchema;
-exports.PdfDestinationSchema = require_schemas.PdfDestinationSchema;
-exports.PdfFieldActionsSchema = require_schemas.PdfFieldActionsSchema;
-exports.PdfForeignMeasureSchema = require_schemas.PdfForeignMeasureSchema;
-exports.PdfLinkTargetSchema = require_schemas.PdfLinkTargetSchema;
-exports.PdfLinkTargetWritableSchema = require_schemas.PdfLinkTargetWritableSchema;
-exports.PdfMeasureSchema = require_schemas.PdfMeasureSchema;
-exports.PdfMeasureWriteSchema = require_schemas.PdfMeasureWriteSchema;
-exports.PdfMeasurementSchema = require_schemas.PdfMeasurementSchema;
-exports.PdfNumberFormatSchema = require_schemas.PdfNumberFormatSchema;
-exports.PdfPageActionsSchema = require_schemas.PdfPageActionsSchema;
-exports.PdfPointSchema = require_schemas.PdfPointSchema;
-exports.PdfQuadSchema = require_schemas.PdfQuadSchema;
-exports.PdfRectDifferencesSchema = require_schemas.PdfRectDifferencesSchema;
-exports.PdfRectSchema = require_schemas.PdfRectSchema;
+exports.PdfActionNodeSchema = require_schema.PdfActionNodeSchema;
+exports.PdfActionTargetRefSchema = require_schema.PdfActionTargetRefSchema;
+exports.PdfActionTreeSchema = require_schema.PdfActionTreeSchema;
+exports.PdfActionTypeSchema = require_schema.PdfActionTypeSchema;
+exports.PdfActionWireComponents = require_schema.PdfActionWireComponents;
+exports.PdfActionWriteSchema = require_schema.PdfActionWriteSchema;
+exports.PdfAnnotationActionsSchema = require_schema.PdfAnnotationActionsSchema;
+exports.PdfDestinationSchema = require_schema.PdfDestinationSchema;
+exports.PdfFieldActionsSchema = require_schema.PdfFieldActionsSchema;
+exports.PdfForeignMeasureSchema = require_schema.PdfForeignMeasureSchema;
+exports.PdfLinkTargetSchema = require_schema.PdfLinkTargetSchema;
+exports.PdfLinkTargetWritableSchema = require_schema.PdfLinkTargetWritableSchema;
+exports.PdfMeasureSchema = require_schema.PdfMeasureSchema;
+exports.PdfMeasureWriteSchema = require_schema.PdfMeasureWriteSchema;
+exports.PdfMeasurementSchema = require_schema.PdfMeasurementSchema;
+exports.PdfNumberFormatSchema = require_schema.PdfNumberFormatSchema;
+exports.PdfPageActionsSchema = require_schema.PdfPageActionsSchema;
+exports.PdfPointSchema = require_schema.PdfPointSchema;
+exports.PdfQuadSchema = require_schema.PdfQuadSchema;
+exports.PdfRectSchema = require_schema.PdfRectSchema;
 exports.PdfRevisionSchema = require_schemas.PdfRevisionSchema;
-exports.PdfRotationSchema = require_schemas.PdfRotationSchema;
+exports.PdfRotationSchema = require_schema.PdfRotationSchema;
 exports.PdfSaveModeSchema = require_schemas.PdfSaveModeSchema;
-exports.PdfSizeSchema = require_schemas.PdfSizeSchema;
-exports.PointSchema = require_schemas.PointSchema;
-exports.PolygonDTOSchema = require_schemas.PolygonDTOSchema;
-exports.PolygonDraftSchema = require_schemas.PolygonDraftSchema;
-exports.PolygonIntentSchema = require_schemas.PolygonIntentSchema;
-exports.PolygonPatchSchema = require_schemas.PolygonPatchSchema;
-exports.PolylineDTOSchema = require_schemas.PolylineDTOSchema;
-exports.PolylineDraftSchema = require_schemas.PolylineDraftSchema;
-exports.PolylineIntentSchema = require_schemas.PolylineIntentSchema;
-exports.PolylinePatchSchema = require_schemas.PolylinePatchSchema;
-exports.RectSchema = require_schemas.RectSchema;
+exports.PdfSizeSchema = require_schema.PdfSizeSchema;
+exports.PointSchema = require_schema.PointSchema;
+exports.PolygonDTOSchema = require_schema.PolygonDTOSchema;
+exports.PolygonDraftSchema = require_schema.PolygonDraftSchema;
+exports.PolygonIntentSchema = require_schema.PolygonIntentSchema;
+exports.PolygonPatchSchema = require_schema.PolygonPatchSchema;
+exports.PolylineDTOSchema = require_schema.PolylineDTOSchema;
+exports.PolylineDraftSchema = require_schema.PolylineDraftSchema;
+exports.PolylineIntentSchema = require_schema.PolylineIntentSchema;
+exports.PolylinePatchSchema = require_schema.PolylinePatchSchema;
+exports.PopupDTOSchema = require_schema.PopupDTOSchema;
+exports.PopupDraftSchema = require_schema.PopupDraftSchema;
+exports.PopupPatchSchema = require_schema.PopupPatchSchema;
+exports.RectSchema = require_schema.RectSchema;
 exports.RedactionApplyResultSchema = require_schemas.RedactionApplyResultSchema;
 exports.RedactionApplyScopeSchema = require_schemas.RedactionApplyScopeSchema;
-exports.RefetchReasonSchema = require_schemas.RefetchReasonSchema;
 exports.RenderTokenSchema = RenderTokenSchema;
-exports.ResourceRefSchema = require_schemas.ResourceRefSchema;
-exports.RevisionTokenSchema = require_schemas.RevisionTokenSchema;
+exports.ResourceKeySchema = require_schema.ResourceKeySchema;
 exports.SEARCH_RESULT_FORMAT = SEARCH_RESULT_FORMAT;
 exports.SearchMatchSchema = require_schemas.SearchMatchSchema;
-exports.SearchModeSchema = require_schemas.SearchModeSchema;
 exports.SearchQuerySchema = require_schemas.SearchQuerySchema;
 exports.SearchRequestSchema = require_schemas.SearchRequestSchema;
 exports.SearchSliceSchema = require_schemas.SearchSliceSchema;
 exports.SearchSnippetSchema = require_schemas.SearchSnippetSchema;
 exports.SearchTokenSchema = SearchTokenSchema;
-exports.ShapeCaptionPatchSchema = require_schemas.ShapeCaptionPatchSchema;
-exports.ShapeDimensionCaptionSchema = require_schemas.ShapeDimensionCaptionSchema;
-exports.SignatureAbortResultSchema = require_schemas.SignatureAbortResultSchema;
+exports.ShapeCaptionPatchSchema = require_schema.ShapeCaptionPatchSchema;
+exports.ShapeDimensionCaptionSchema = require_schema.ShapeDimensionCaptionSchema;
 exports.SignatureAppearanceBodySchema = require_schemas.SignatureAppearanceBodySchema;
+exports.SignatureCancelResultSchema = require_schemas.SignatureCancelResultSchema;
 exports.SignatureCompleteBodySchema = require_schemas.SignatureCompleteBodySchema;
 exports.SignatureCompleteResultSchema = require_schemas.SignatureCompleteResultSchema;
 exports.SignatureDTOSchema = require_schemas.SignatureDTOSchema;
@@ -1848,41 +2481,50 @@ exports.SignaturePrepareBodySchema = require_schemas.SignaturePrepareBodySchema;
 exports.SignaturePreparedWireSchema = require_schemas.SignaturePreparedWireSchema;
 exports.SignatureSeedValueSchema = require_schemas.SignatureSeedValueSchema;
 exports.SignatureSnapshotSchema = require_schemas.SignatureSnapshotSchema;
-exports.SquareDTOSchema = require_schemas.SquareDTOSchema;
-exports.SquareDraftSchema = require_schemas.SquareDraftSchema;
-exports.SquarePatchSchema = require_schemas.SquarePatchSchema;
-exports.SquigglyDTOSchema = require_schemas.SquigglyDTOSchema;
-exports.SquigglyDraftSchema = require_schemas.SquigglyDraftSchema;
-exports.SquigglyPatchSchema = require_schemas.SquigglyPatchSchema;
-exports.StampDTOSchema = require_schemas.StampDTOSchema;
-exports.StampWireDraftSchema = require_schemas.StampWireDraftSchema;
-exports.StampWirePatchSchema = require_schemas.StampWirePatchSchema;
-exports.StandardFontSchema = require_schemas.StandardFontSchema;
-exports.StrikeoutDTOSchema = require_schemas.StrikeoutDTOSchema;
-exports.StrikeoutDraftSchema = require_schemas.StrikeoutDraftSchema;
-exports.StrikeoutIntentSchema = require_schemas.StrikeoutIntentSchema;
-exports.StrikeoutPatchSchema = require_schemas.StrikeoutPatchSchema;
-exports.TextAlignmentSchema = require_schemas.TextAlignmentSchema;
-exports.TextDTOSchema = require_schemas.TextDTOSchema;
-exports.TextDraftSchema = require_schemas.TextDraftSchema;
-exports.TextPatchSchema = require_schemas.TextPatchSchema;
-exports.ToggleFieldWidgetSchema = require_schemas.ToggleFieldWidgetSchema;
-exports.UnderlineDTOSchema = require_schemas.UnderlineDTOSchema;
-exports.UnderlineDraftSchema = require_schemas.UnderlineDraftSchema;
-exports.UnderlinePatchSchema = require_schemas.UnderlinePatchSchema;
-exports.UnsupportedDTOSchema = require_schemas.UnsupportedDTOSchema;
-exports.UnsupportedDraftSchema = require_schemas.UnsupportedDraftSchema;
-exports.UnsupportedPatchSchema = require_schemas.UnsupportedPatchSchema;
+exports.SourceResourceKeysSchema = require_schema.SourceResourceKeysSchema;
+exports.SquareDTOSchema = require_schema.SquareDTOSchema;
+exports.SquareDraftSchema = require_schema.SquareDraftSchema;
+exports.SquarePatchSchema = require_schema.SquarePatchSchema;
+exports.SquigglyDTOSchema = require_schema.SquigglyDTOSchema;
+exports.SquigglyDraftSchema = require_schema.SquigglyDraftSchema;
+exports.SquigglyPatchSchema = require_schema.SquigglyPatchSchema;
+exports.StampDTOSchema = require_schema.StampDTOSchema;
+exports.StampDraftSchema = require_schema.StampDraftSchema;
+exports.StampFitSchema = require_schema.StampFitSchema;
+exports.StampPatchSchema = require_schema.StampPatchSchema;
+exports.StandardFontSchema = require_schema.StandardFontSchema;
+exports.StrikeoutDTOSchema = require_schema.StrikeoutDTOSchema;
+exports.StrikeoutDraftSchema = require_schema.StrikeoutDraftSchema;
+exports.StrikeoutIntentSchema = require_schema.StrikeoutIntentSchema;
+exports.StrikeoutPatchSchema = require_schema.StrikeoutPatchSchema;
+exports.TextAlignmentSchema = require_schema.TextAlignmentSchema;
+exports.TextDTOSchema = require_schema.TextDTOSchema;
+exports.TextDraftSchema = require_schema.TextDraftSchema;
+exports.TextPatchSchema = require_schema.TextPatchSchema;
+exports.ToggleFieldWidgetSchema = require_schema.ToggleFieldWidgetSchema;
+exports.UnderlineDTOSchema = require_schema.UnderlineDTOSchema;
+exports.UnderlineDraftSchema = require_schema.UnderlineDraftSchema;
+exports.UnderlinePatchSchema = require_schema.UnderlinePatchSchema;
+exports.UnsupportedDTOSchema = require_schema.UnsupportedDTOSchema;
+exports.UnsupportedDraftSchema = require_schema.UnsupportedDraftSchema;
+exports.UnsupportedPatchSchema = require_schema.UnsupportedPatchSchema;
 exports.VersionAnalysisQuerySchema = require_schemas.VersionAnalysisQuerySchema;
-exports.WeakAnnotationSessionPagesRequestSchema = require_schemas.WeakAnnotationSessionPagesRequestSchema;
-exports.WeakAnnotationSessionResponseSchema = require_schemas.WeakAnnotationSessionResponseSchema;
-exports.WidgetAppearanceSchema = require_schemas.WidgetAppearanceSchema;
-exports.WidgetPlacementSchema = require_schemas.WidgetPlacementSchema;
-exports.WireAttachmentFileSchema = require_schemas.WireAttachmentFileSchema;
+exports.VerticalAlignmentSchema = require_schema.VerticalAlignmentSchema;
+exports.WidgetActionsPatchSchema = require_schema.WidgetActionsPatchSchema;
+exports.WidgetAppearanceSchema = require_schema.WidgetAppearanceSchema;
+exports.WidgetAppearancesQuerySchema = require_schemas.WidgetAppearancesQuerySchema;
+exports.WidgetAppearancesRenderTokenSchema = WidgetAppearancesRenderTokenSchema;
+exports.WidgetBorderStyleSchema = require_schema.WidgetBorderStyleSchema;
+exports.WidgetCheckStyleSchema = require_schema.WidgetCheckStyleSchema;
+exports.WidgetDTOSchema = require_schema.WidgetDTOSchema;
+exports.WidgetPatchSchema = require_schema.WidgetPatchSchema;
+exports.WidgetPlacementSchema = require_schema.WidgetPlacementSchema;
+exports.WireAttachmentFileSchema = require_schema.WireAttachmentFileSchema;
 exports.analysisQueryString = analysisQueryString;
 exports.analyzeInputFromQuery = require_schemas.analyzeInputFromQuery;
 exports.annotationAppearancesImageOptionsToToken = annotationAppearancesImageOptionsToToken;
 exports.annotationAppearancesImageOptionsToWire = annotationAppearancesImageOptionsToWire;
+exports.annotationPatchSchemaOf = require_schema.annotationPatchSchemaOf;
 exports.annotationRenderOptionsFromImageOptions = annotationRenderOptionsFromImageOptions;
 exports.applyCdnAccess = applyCdnAccess;
 exports.cdnCoverageForScope = cdnCoverageForScope;
@@ -1892,10 +2534,13 @@ exports.decodeAnalysisToken = decodeAnalysisToken;
 exports.decodeAnnotationAppearancesRenderToken = decodeAnnotationAppearancesRenderToken;
 exports.decodeAnnotationToken = decodeAnnotationToken;
 exports.decodeAnnotationsAllToken = decodeAnnotationsAllToken;
+exports.decodeAnnotationsExportToken = decodeAnnotationsExportToken;
 exports.decodeAttachmentsToken = decodeAttachmentsToken;
 exports.decodeContentToken = decodeContentToken;
 exports.decodeDocToken = decodeDocToken;
 exports.decodeDownloadToken = decodeDownloadToken;
+exports.decodeFormExportToken = decodeFormExportToken;
+exports.decodeFormToken = decodeFormToken;
 exports.decodeLayoutToken = decodeLayoutToken;
 exports.decodeMetadataToken = decodeMetadataToken;
 exports.decodePrepared = require_schemas.decodePrepared;
@@ -1903,15 +2548,20 @@ exports.decodeRenderToken = decodeRenderToken;
 exports.decodeSearchToken = decodeSearchToken;
 exports.decodeToken = decodeToken;
 exports.decodeTokenText = decodeTokenText;
+exports.decodeWidgetAppearancesRenderToken = decodeWidgetAppearancesRenderToken;
 exports.encodeActionsToken = encodeActionsToken;
 exports.encodeAnalysisToken = encodeAnalysisToken;
 exports.encodeAnnotationAppearancesRenderToken = encodeAnnotationAppearancesRenderToken;
 exports.encodeAnnotationToken = encodeAnnotationToken;
 exports.encodeAnnotationsAllToken = encodeAnnotationsAllToken;
+exports.encodeAnnotationsExportToken = encodeAnnotationsExportToken;
+exports.encodeAppearanceModes = encodeAppearanceModes;
 exports.encodeAttachmentsToken = encodeAttachmentsToken;
 exports.encodeContentToken = encodeContentToken;
 exports.encodeDocToken = encodeDocToken;
 exports.encodeDownloadToken = encodeDownloadToken;
+exports.encodeFormExportToken = encodeFormExportToken;
+exports.encodeFormToken = encodeFormToken;
 exports.encodeLayoutToken = encodeLayoutToken;
 exports.encodeMetadataToken = encodeMetadataToken;
 exports.encodePrepared = require_schemas.encodePrepared;
@@ -1919,14 +2569,18 @@ exports.encodeRenderToken = encodeRenderToken;
 exports.encodeSearchToken = encodeSearchToken;
 exports.encodeToken = encodeToken;
 exports.encodeTokenText = encodeTokenText;
+exports.encodeWidgetAppearancesRenderToken = encodeWidgetAppearancesRenderToken;
 exports.flatten = flatten;
-exports.fromBase64 = require_schemas.fromBase64;
+exports.fromBase64 = require_charmap.fromBase64;
+exports.pageRenderFamilyOf = require_schemas.pageRenderFamilyOf;
 exports.pageRenderOptionsFromImageOptions = pageRenderOptionsFromImageOptions;
 exports.renderImageOptionsToToken = renderImageOptionsToToken;
 exports.renderImageOptionsToWire = renderImageOptionsToWire;
 exports.resolveResourceIdForPath = resolveResourceIdForPath;
-exports.toBase64 = require_schemas.toBase64;
+exports.toBase64 = require_charmap.toBase64;
 exports.unflatten = unflatten;
+exports.widgetAppearancesImageOptionsToToken = widgetAppearancesImageOptionsToToken;
+exports.widgetAppearancesImageOptionsToWire = widgetAppearancesImageOptionsToWire;
 exports.wirePaths = wirePaths;
 exports.wireTemplates = wireTemplates;