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

package/dist/wire.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_format = require("./format-Bp3QFSH1.cjs");
-const require_resolver = require("./resolver-D2OCtE8F.cjs");
+const require_resolver = require("./resolver-BWSWSF6R.cjs");
 const require_charmap = require("./charmap-aYlefQP9.cjs");
-const require_schema = require("./schema-C-gU4vj7.cjs");
-const require_schemas = require("./schemas-Berf1swF.cjs");
+const require_schema = require("./schema-miH6tWQC.cjs");
+const require_schemas = require("./schemas-DljJR9ut.cjs");
 let zod = require("zod");
 //#region src/forms/submission.ts
 const FormSubmissionEntrySchema = zod.z.object({
@@ -145,6 +145,11 @@ const FormExportTokenSchema = {
 const ActionsTokenSchema = { fields: ["actionsVersion"] };
 const AttachmentsTokenSchema = { fields: ["attachmentsVersion"] };
 /**
+* The outline leaf: its own pin and the layout pin. The outline is read in
+* page space, so a page delete or a box change moves what it reads.
+*/
+const OutlineTokenSchema = { fields: ["layoutVersion", "outlineVersion"] };
+/**
 * Layer signature analysis: the working copy judged against the base,
 * pinned by `docVersion`; `since.signature` XOR `since.revision`; `level`
 * only in exploratory mode.
@@ -408,6 +413,17 @@ const decodeFormExportToken = (raw) => {
 };
 const encodeActionsToken = (actionsVersion) => encodeToken(ActionsTokenSchema, { actionsVersion });
 const decodeActionsToken = (raw) => decodePositiveInteger(decodeToken(ActionsTokenSchema, raw).actionsVersion, "actionsVersion");
+const encodeOutlineToken = (token) => encodeToken(OutlineTokenSchema, {
+	layoutVersion: token.layoutVersion,
+	outlineVersion: token.outlineVersion
+});
+const decodeOutlineToken = (raw) => {
+	const query = decodeToken(OutlineTokenSchema, raw);
+	return {
+		outlineVersion: decodePositiveInteger(query.outlineVersion, "outlineVersion"),
+		layoutVersion: decodePositiveInteger(query.layoutVersion, "layoutVersion")
+	};
+};
 const encodeAttachmentsToken = (attachmentsVersion) => encodeToken(AttachmentsTokenSchema, { attachmentsVersion });
 const decodeAttachmentsToken = (raw) => decodePositiveInteger(decodeToken(AttachmentsTokenSchema, raw).attachmentsVersion, "attachmentsVersion");
 const encodeDownloadToken = (input) => encodeToken(DownloadTokenSchema, {
@@ -566,6 +582,7 @@ function decodePdfSaveMode(raw) {
 *   /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}/render/{print,print-high}/…/pages/{N}/data@{ver}  — and each print tier of each
 *   /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}
@@ -578,9 +595,6 @@ function decodePdfSaveMode(raw) {
 *   /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/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}/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}
@@ -694,6 +708,15 @@ const wirePaths = {
 	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)}`,
+	/**
+	* GET: the layer's outline at its `outlineVersion` and `layoutVersion`
+	* (the outline is read in page space). Content-addressed: a stale pin 404s
+	* and the client refreshes its manifest.
+	*/
+	layerOutline: (docId, layerName, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/outline@${encodeOutlineToken(token)}`,
+	layerOutlineCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/outline`,
+	/** Immutable base outline: the shared-URL twin an outline-inheriting layer resolves at. */
+	docOutline: (docId, token) => `/v1/docs/${encodeURIComponent(docId)}/outline@${encodeOutlineToken(token)}`,
 	/** 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
@@ -742,10 +765,6 @@ const wirePaths = {
 	docAttachmentFile: (docId, key, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/attachment-files/${encodeTokenText(key)}/data@${encodeAttachmentsToken(attachmentsVersion)}`,
 	/** Immutable /EmbeddedFiles listing, pinned by `attachmentsVersion`. */
 	layerAttachments: (docId, layerName, attachmentsVersion) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachments@${encodeAttachmentsToken(attachmentsVersion)}`,
-	/** POST: create a document-level embedded file (multipart mutation envelope). */
-	layerAttachmentsCollection: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachments`,
-	/** DELETE: remove a document-level embedded file by name-tree key. */
-	layerAttachmentItem: (docId, layerName, key) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/attachments/${encodeTokenText(key)}`,
 	/**
 	* Immutable decoded bytes of one document-level embedded file. Lives
 	* under its own `attachment-files` prefix — a stronger capability tier
@@ -782,10 +801,20 @@ const wirePaths = {
 	*/
 	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`,
+	/**
+	* A print picture (`PAGE_PRINT_FAMILIES`): a family printed at a tier. The
+	* tier is a right, so it is in the path like the family; the token carries
+	* the family's pins and the image format, nothing that sizes the picture.
+	*/
+	docPagePrint: (docId, tier, family, page, token) => `/v1/docs/${encodeURIComponent(docId)}/${require_schemas.PAGE_PRINT_FAMILIES[tier][family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	docPagePrintCurrent: (docId, tier, family, page) => `/v1/docs/${encodeURIComponent(docId)}/${require_schemas.PAGE_PRINT_FAMILIES[tier][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`,
+	/** Layer twin of `docPagePrint`. */
+	layerPagePrint: (docId, layerName, tier, family, page, token) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${require_schemas.PAGE_PRINT_FAMILIES[tier][family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data@${encodeRenderToken(token)}`,
+	layerPagePrintCurrent: (docId, layerName, tier, family, page) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/${require_schemas.PAGE_PRINT_FAMILIES[tier][family].path}/${encodeURIComponent(require_format.encodePageKey(page))}/data`,
 	/**
 	* Immutable base annotation list for a single page (plane-scope model):
 	* the shared-URL variant an annotations-inheriting layer resolves at — a
@@ -931,9 +960,6 @@ const wirePaths = {
 	layerSearchFullCurrent: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/search/full/data`,
 	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
 	*  mutation (docVersion + layoutVersion advance; reads ride `/layout`). */
 	layerPagesNames: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/names`,
@@ -941,13 +967,6 @@ const wirePaths = {
 	layerPagesNamesDelete: (docId, layerName) => `/v1/docs/${encodeURIComponent(docId)}/layers/${encodeURIComponent(layerName)}/pages/names/delete`,
 	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 `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
 	* state (gated like /download), so it is a POST only for its body —
@@ -980,6 +999,9 @@ const wireTemplates = {
 	layerChanges: "/v1/docs/:docId/layers/:layerName/changes",
 	layerMetadata: "/v1/docs/:docId/layers/:layerName/metadata",
 	layerCustomMetadata: "/v1/docs/:docId/layers/:layerName/metadata/custom",
+	layerOutline: "/v1/docs/:docId/layers/:layerName/outline",
+	layerAttachments: "/v1/docs/:docId/layers/:layerName/attachments",
+	layerAttachmentFile: "/v1/docs/:docId/layers/:layerName/attachment-files/:fileKey/data",
 	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",
@@ -989,6 +1011,7 @@ const wireTemplates = {
 	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",
+	layerAnnotationItemFileResource: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pageKey/items/:annotKey/resources/file",
 	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",
@@ -1000,14 +1023,9 @@ const wireTemplates = {
 	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",
 	layerPagesNamesDelete: "/v1/docs/:docId/layers/:layerName/pages/names/delete",
 	layerPagesFlatten: "/v1/docs/:docId/layers/:layerName/pages/flatten",
-	layerPagesInsert: "/v1/docs/:docId/layers/:layerName/pages/insert",
-	layerPagesInsertBlank: "/v1/docs/:docId/layers/:layerName/pages/insert-blank",
 	layerPagesExtract: "/v1/docs/:docId/layers/:layerName/pages/extract",
 	layerRedactionsApply: "/v1/docs/:docId/layers/:layerName/redactions/apply",
 	layerDownload: "/v1/docs/:docId/layers/:layerName/download",
@@ -1027,8 +1045,8 @@ 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];
+function pageRenderResource(picture) {
+	const { resource, path, needs } = picture;
 	return {
 		id: resource,
 		pathPattern: `/v1/docs/{docId}/${path}/*/data@*`,
@@ -1041,8 +1059,8 @@ function pageRenderResource(family) {
 	};
 }
 /** A page picture of one family, at a layer's path. */
-function layerPageRenderResource(family) {
-	const { layerResource, path, needs } = require_schemas.PAGE_RENDER_FAMILIES[family];
+function layerPageRenderResource(picture) {
+	const { layerResource, path, needs } = picture;
 	return {
 		id: layerResource,
 		pathPattern: `/v1/docs/{docId}/layers/{layerName}/${path}/*/data@*`,
@@ -1109,10 +1127,18 @@ const DOC_RESOURCES = {
 		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-render": pageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.pages),
+	"page-render-annotations": pageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.annotations),
+	"page-render-fields": pageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.fields),
+	"page-render-all": pageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.all),
+	"page-print": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.pages),
+	"page-print-annotations": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.annotations),
+	"page-print-fields": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.fields),
+	"page-print-all": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.all),
+	"page-print-high": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].pages),
+	"page-print-high-annotations": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].annotations),
+	"page-print-high-fields": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].fields),
+	"page-print-high-all": pageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].all),
 	"page-annotations": {
 		id: "page-annotations",
 		pathPattern: "/v1/docs/{docId}/annotations/pages/*/items@*",
@@ -1308,6 +1334,19 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	outline: {
+		id: "outline",
+		pathPattern: "/v1/docs/{docId}/outline@*",
+		resolvePathPattern: (docId) => `/v1/docs/${docId}/outline@*`,
+		pathPrefix: "/v1/docs/{docId}/outline@",
+		resolvePathPrefix: (docId) => `/v1/docs/${docId}/outline@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.open"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	"attachment-files": {
 		id: "attachment-files",
 		pathPattern: "/v1/docs/{docId}/attachment-files/*",
@@ -1334,6 +1373,19 @@ const DOC_RESOURCES = {
 		routeKind: "versioned-read",
 		cdnCacheable: true
 	},
+	"layer-outline": {
+		id: "layer-outline",
+		pathPattern: "/v1/docs/{docId}/layers/{layerName}/outline@*",
+		resolvePathPattern: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/outline@*`,
+		pathPrefix: "/v1/docs/{docId}/layers/{layerName}/outline@",
+		resolvePathPrefix: (docId, layerName = "default") => `/v1/docs/${docId}/layers/${layerName}/outline@`,
+		requirement: {
+			kind: "single",
+			capability: "doc.open"
+		},
+		routeKind: "versioned-read",
+		cdnCacheable: true
+	},
 	"layer-attachment-files": {
 		id: "layer-attachment-files",
 		pathPattern: "/v1/docs/{docId}/layers/{layerName}/attachment-files/*",
@@ -1347,10 +1399,18 @@ const DOC_RESOURCES = {
 		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"),
+	"layer-page-render": layerPageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.pages),
+	"layer-page-render-annotations": layerPageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.annotations),
+	"layer-page-render-fields": layerPageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.fields),
+	"layer-page-render-all": layerPageRenderResource(require_schemas.PAGE_RENDER_FAMILIES.all),
+	"layer-page-print": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.pages),
+	"layer-page-print-annotations": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.annotations),
+	"layer-page-print-fields": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.fields),
+	"layer-page-print-all": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES.print.all),
+	"layer-page-print-high": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].pages),
+	"layer-page-print-high-annotations": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].annotations),
+	"layer-page-print-high-fields": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].fields),
+	"layer-page-print-high-all": layerPageRenderResource(require_schemas.PAGE_PRINT_FAMILIES["print-high"].all),
 	"page-text": {
 		id: "page-text",
 		pathPattern: "/v1/docs/{docId}/text/pages/*/data@*",
@@ -1675,10 +1735,7 @@ function checkResourceAccess(resourceId, rawScope, pdfBits) {
 * as every edge grant.
 */
 const RESOURCE_PLANES = {
-	"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,
+	...Object.fromEntries(require_schemas.PAGE_PICTURES.map((picture) => [picture.resource, picture.planes])),
 	"page-text": ["content"],
 	"page-geometry": ["content"],
 	"page-annotations": ["annotations"],
@@ -1691,7 +1748,8 @@ const RESOURCE_PLANES = {
 	"metadata-custom": ["metadata"],
 	actions: ["actions"],
 	attachments: ["attachments"],
-	"attachment-files": ["attachments"]
+	"attachment-files": ["attachments"],
+	outline: ["outline", "layout"]
 };
 function cdnCoverageForScope(rawScope, pdfBits, context) {
 	const out = [];
@@ -1885,16 +1943,19 @@ function unflatten(flat) {
 * extending `PageImageOptions`, the render query schemas, and
 * `RenderTokenSchema.fields`; this function does not change.
 *
-* 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.
+* What the picture draws, and whether and at which DPI it prints, is never
+* in the token: the caller picks the picture's path (`PAGE_RENDER_FAMILIES`,
+* `PAGE_PRINT_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: _inThePath, includeFormFields: _alsoInThePath, ...wireOptions } = options;
+	const { includeAnnotations: _inThePath, includeFormFields: _alsoInThePath, usage, viewport, ...wireOptions } = options;
+	const sized = usage === "print" || viewport === void 0 ? {} : { viewport };
 	return flatten({
 		...wireOptions,
+		...sized,
 		...versions
 	});
 }
@@ -1907,8 +1968,9 @@ function renderImageOptionsToToken(options, versions) {
 }
 /**
 * 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.
+* render options, and what its family draws and whether it prints (stamped
+* by the picture's query schema). Pure shape transform; image encoding stays
+* out.
 */
 function pageRenderOptionsFromImageOptions(options) {
 	return {
@@ -1917,7 +1979,8 @@ function pageRenderOptionsFromImageOptions(options) {
 		...options.rotation !== void 0 ? { rotation: options.rotation } : {},
 		...options.background !== void 0 ? { background: options.background } : {},
 		includeAnnotations: options.includeAnnotations ?? false,
-		includeFormFields: options.includeFormFields ?? false
+		includeFormFields: options.includeFormFields ?? false,
+		...options.usage !== void 0 ? { usage: options.usage } : {}
 	};
 }
 /**
@@ -1971,8 +2034,9 @@ function annotationRenderOptionsFromImageOptions(options) {
 /**
 * `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.
+* signature's artwork, a PDF whose pages come in) 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}$/);
@@ -2094,6 +2158,66 @@ const ChangeOpWireSchema = zod.z.discriminatedUnion("type", [
 	zod.z.object({
 		type: zod.z.literal("metadata.updateCustom"),
 		patch: require_schemas.CustomMetadataPatchSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("outline.create"),
+		parent: require_schemas.OutlineItemRefSchema.nullable(),
+		position: require_schemas.OutlinePositionSchema.optional(),
+		data: require_schemas.OutlineItemDraftSchema,
+		objectNumber: zod.z.number().int().positive().optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("outline.update"),
+		ref: require_schemas.OutlineItemRefSchema,
+		patch: require_schemas.OutlineItemPatchSchema,
+		expect: require_schemas.OutlineItemPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("outline.move"),
+		refs: zod.z.array(require_schemas.OutlineItemRefSchema).min(1),
+		parent: require_schemas.OutlineItemRefSchema.nullable(),
+		position: require_schemas.OutlinePositionSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("outline.delete"),
+		ref: require_schemas.OutlineItemRefSchema,
+		expect: require_schemas.OutlineItemPatchSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("pages.rotate"),
+		pages: zod.z.array(require_schema.PageRefSchema).min(1),
+		rotation: require_schema.PdfRotationSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("pages.reorder"),
+		pages: zod.z.array(require_schema.PageRefSchema).min(1),
+		position: require_schemas.PagePositionSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("pages.delete"),
+		pages: zod.z.array(require_schema.PageRefSchema).min(1)
+	}),
+	zod.z.object({
+		type: zod.z.literal("pages.insertBlank"),
+		spec: require_schemas.PageInsertBlankSpecSchema,
+		position: require_schemas.PagePositionSchema.optional(),
+		objectNumbers: zod.z.array(zod.z.number().int().positive()).optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("pages.insert"),
+		/** The PDF whose pages come in, as the key of its multipart part. */
+		resources: require_schema.SourceResourceKeysSchema,
+		position: require_schemas.PagePositionSchema.optional()
+	}),
+	zod.z.object({
+		type: zod.z.literal("attachments.create"),
+		file: require_schema.AttachmentFileBaseSchema,
+		/** The file's bytes, as the key of their multipart part. */
+		resources: require_schema.FileResourceKeysSchema
+	}),
+	zod.z.object({
+		type: zod.z.literal("attachments.delete"),
+		ref: require_schema.AttachmentRefSchema
 	})
 ]);
 /**
@@ -2119,7 +2243,11 @@ const ChangeRequestSchema = zod.z.object({ changes: zod.z.array(ChangeEntryWireS
 const ChangeItemTypeSchema = zod.z.enum([
 	...ChangeOpWireSchema.options.map((op) => op.shape.type.value),
 	"annotations.restore",
-	"forms.restore"
+	"forms.restore",
+	"forms.restoreWidget",
+	"outline.restore",
+	"pages.restore",
+	"attachments.restore"
 ]);
 /** What an undo left alone, by name. */
 const SkippedFieldsSchema = zod.z.array(zod.z.string()).optional();
@@ -2176,7 +2304,24 @@ const ChangeItemSchema = zod.z.union([
 	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 })
+	itemOf("metadata.updateCustom", require_schemas.CustomMetadataUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("outline.create", require_schemas.OutlineCreateResultSchema),
+	itemOf("outline.update", require_schemas.OutlineUpdateResultSchema, { skipped: SkippedFieldsSchema }),
+	itemOf("outline.move", require_schemas.OutlineMoveResultSchema),
+	itemOf("outline.delete", require_schemas.OutlineDeleteResultSchema),
+	itemOf("outline.restore", require_schemas.OutlineRestoreResultSchema),
+	itemOf("pages.rotate", require_schemas.PageRotateResultSchema, {
+		pages: zod.z.array(require_schema.PageRefSchema),
+		rotation: require_schema.PdfRotationSchema
+	}),
+	itemOf("pages.reorder", require_schemas.PageReorderResultSchema),
+	itemOf("pages.delete", require_schemas.PageDeleteResultSchema, { pages: zod.z.array(require_schema.PageRefSchema) }),
+	itemOf("pages.insertBlank", require_schemas.PageInsertResultSchema),
+	itemOf("pages.insert", require_schemas.PageInsertResultSchema),
+	itemOf("pages.restore", require_schemas.PageRestoreResultSchema),
+	itemOf("attachments.create", require_schemas.AttachmentCreateResultSchema),
+	itemOf("attachments.delete", require_schemas.AttachmentDeleteResultSchema),
+	itemOf("attachments.restore", require_schemas.AttachmentRestoreResultSchema)
 ]);
 /** What a change did: one item per op (per step of an undo), and its meta. */
 const ChangeResultSchema = zod.z.object({
@@ -2241,11 +2386,14 @@ exports.AppearanceOutcomeSchema = require_schemas.AppearanceOutcomeSchema;
 exports.AppearanceResourceKeysSchema = require_schema.AppearanceResourceKeysSchema;
 exports.AttachmentCreateResultSchema = require_schemas.AttachmentCreateResultSchema;
 exports.AttachmentDeleteResultSchema = require_schemas.AttachmentDeleteResultSchema;
+exports.AttachmentFileBaseSchema = require_schema.AttachmentFileBaseSchema;
 exports.AttachmentFileInfoSchema = require_schema.AttachmentFileInfoSchema;
 exports.AttachmentListSchema = require_schemas.AttachmentListSchema;
 exports.AttachmentMutationMetaSchema = require_schemas.AttachmentMutationMetaSchema;
 exports.AttachmentRefSchema = require_schema.AttachmentRefSchema;
+exports.AttachmentRestoreResultSchema = require_schemas.AttachmentRestoreResultSchema;
 exports.AttachmentSchema = require_schema.AttachmentSchema;
+exports.AttachmentWireComponents = require_schemas.AttachmentWireComponents;
 exports.BaseVersionInfoSchema = require_schemas.BaseVersionInfoSchema;
 exports.BlendModeSchema = require_schema.BlendModeSchema;
 exports.BundleLimitsSchema = require_schemas.BundleLimitsSchema;
@@ -2284,6 +2432,7 @@ exports.DocumentActionsSnapshotSchema = require_schema.DocumentActionsSnapshotSc
 exports.DocumentHeadSchema = require_schemas.DocumentHeadSchema;
 exports.DocumentManifestSchema = require_schemas.DocumentManifestSchema;
 exports.DocumentMetadataSchema = require_schemas.DocumentMetadataSchema;
+exports.DocumentOutlineSchema = require_schemas.DocumentOutlineSchema;
 exports.DocumentProtectionSchema = require_schemas.DocumentProtectionSchema;
 exports.DocumentSecurityStateSchema = require_schemas.DocumentSecurityStateSchema;
 exports.DocumentVersionRefSchema = require_schemas.DocumentVersionRefSchema;
@@ -2390,17 +2539,31 @@ exports.ObjectNumberRangeSchema = require_schemas.ObjectNumberRangeSchema;
 exports.ObjectNumberReservationRequestSchema = require_schemas.ObjectNumberReservationRequestSchema;
 exports.ObjectNumberReservationResponseSchema = require_schemas.ObjectNumberReservationResponseSchema;
 exports.OpenDocumentResponseSchema = require_schemas.OpenDocumentResponseSchema;
+exports.OutlineCreateResultSchema = require_schemas.OutlineCreateResultSchema;
+exports.OutlineDeleteResultSchema = require_schemas.OutlineDeleteResultSchema;
+exports.OutlineItemDraftSchema = require_schemas.OutlineItemDraftSchema;
+exports.OutlineItemPatchSchema = require_schemas.OutlineItemPatchSchema;
+exports.OutlineItemRefSchema = require_schemas.OutlineItemRefSchema;
+exports.OutlineItemSchema = require_schemas.OutlineItemSchema;
+exports.OutlineMoveResultSchema = require_schemas.OutlineMoveResultSchema;
+exports.OutlineMutationMetaSchema = require_schemas.OutlineMutationMetaSchema;
+exports.OutlineOrderSchema = require_schemas.OutlineOrderSchema;
+exports.OutlinePositionSchema = require_schemas.OutlinePositionSchema;
+exports.OutlineRestoreResultSchema = require_schemas.OutlineRestoreResultSchema;
+exports.OutlineUpdateResultSchema = require_schemas.OutlineUpdateResultSchema;
+exports.OutlineWireComponents = require_schemas.OutlineWireComponents;
+exports.PAGE_PICTURES = require_schemas.PAGE_PICTURES;
+exports.PAGE_PRINT_FAMILIES = require_schemas.PAGE_PRINT_FAMILIES;
+exports.PAGE_PRINT_TIERS = require_schemas.PAGE_PRINT_TIERS;
 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;
 exports.PageExtractInputSchema = require_schemas.PageExtractInputSchema;
 exports.PageFlattenInputSchema = require_schemas.PageFlattenInputSchema;
 exports.PageFlattenResultSchema = require_schemas.PageFlattenResultSchema;
 exports.PageGeometrySnapshotSchema = require_schemas.PageGeometrySnapshotSchema;
-exports.PageInsertBlankInputSchema = require_schemas.PageInsertBlankInputSchema;
-exports.PageInsertInputSchema = require_schemas.PageInsertInputSchema;
+exports.PageInsertBlankSpecSchema = require_schemas.PageInsertBlankSpecSchema;
 exports.PageInsertResultSchema = require_schemas.PageInsertResultSchema;
 exports.PageLayoutSchema = require_schemas.PageLayoutSchema;
 exports.PageListSnapshotSchema = require_schemas.PageListSnapshotSchema;
@@ -2411,13 +2574,13 @@ exports.PageNameResultSchema = require_schemas.PageNameResultSchema;
 exports.PageNetworkRenderFormatSchema = require_schemas.PageNetworkRenderFormatSchema;
 exports.PagePointSchema = require_schema.PagePointSchema;
 exports.PagePositionSchema = require_schemas.PagePositionSchema;
+exports.PagePrintQuerySchemas = require_schemas.PagePrintQuerySchemas;
 exports.PageQuadSchema = require_schema.PageQuadSchema;
 exports.PageRefSchema = require_schema.PageRefSchema;
 exports.PageRemoveNameInputSchema = require_schemas.PageRemoveNameInputSchema;
 exports.PageRenderQuerySchemas = require_schemas.PageRenderQuerySchemas;
-exports.PageReorderInputSchema = require_schemas.PageReorderInputSchema;
 exports.PageReorderResultSchema = require_schemas.PageReorderResultSchema;
-exports.PageRotateInputSchema = require_schemas.PageRotateInputSchema;
+exports.PageRestoreResultSchema = require_schemas.PageRestoreResultSchema;
 exports.PageRotateResultSchema = require_schemas.PageRotateResultSchema;
 exports.PageScaleInputSchema = require_schema.PageScaleInputSchema;
 exports.PageScaleResultSchema = require_schemas.PageScaleResultSchema;
@@ -2543,6 +2706,7 @@ exports.decodeFormExportToken = decodeFormExportToken;
 exports.decodeFormToken = decodeFormToken;
 exports.decodeLayoutToken = decodeLayoutToken;
 exports.decodeMetadataToken = decodeMetadataToken;
+exports.decodeOutlineToken = decodeOutlineToken;
 exports.decodePrepared = require_schemas.decodePrepared;
 exports.decodeRenderToken = decodeRenderToken;
 exports.decodeSearchToken = decodeSearchToken;
@@ -2564,6 +2728,7 @@ exports.encodeFormExportToken = encodeFormExportToken;
 exports.encodeFormToken = encodeFormToken;
 exports.encodeLayoutToken = encodeLayoutToken;
 exports.encodeMetadataToken = encodeMetadataToken;
+exports.encodeOutlineToken = encodeOutlineToken;
 exports.encodePrepared = require_schemas.encodePrepared;
 exports.encodeRenderToken = encodeRenderToken;
 exports.encodeSearchToken = encodeSearchToken;
@@ -2572,6 +2737,9 @@ exports.encodeTokenText = encodeTokenText;
 exports.encodeWidgetAppearancesRenderToken = encodeWidgetAppearancesRenderToken;
 exports.flatten = flatten;
 exports.fromBase64 = require_charmap.fromBase64;
+exports.pagePictureOf = require_schemas.pagePictureOf;
+exports.pagePictureQuerySchema = require_schemas.pagePictureQuerySchema;
+exports.pagePrintTierOf = require_schemas.pagePrintTierOf;
 exports.pageRenderFamilyOf = require_schemas.pageRenderFamilyOf;
 exports.pageRenderOptionsFromImageOptions = pageRenderOptionsFromImageOptions;
 exports.renderImageOptionsToToken = renderImageOptionsToToken;