@embedpdf/engine-core 3.0.0-next.1 → 3.0.0-next.11

package/dist/{schemas-B_1VyFsm.cjs → schemas-CS5iPpX5.cjs}

@@ -1,4 +1,4 @@
-const require_subtype = require("./subtype-qejjVr6h.cjs");
+const require_PageInsertBlankInput = require("./PageInsertBlankInput-CzShuSJI.cjs");
 let zod = require("zod");
 //#region src/geometry/schemas.ts
 /**
@@ -44,34 +44,139 @@ const PdfRotationSchema = zod.z.union([
 	zod.z.literal(270)
 ]);
 //#endregion
-//#region src/dto/PdfAction.schema.ts
-const PdfActionTypeSchema = zod.z.enum([
-	"unknown",
-	"goto",
-	"goto-remote",
-	"goto-embedded",
-	"launch",
-	"thread",
-	"uri",
-	"sound",
-	"movie",
-	"hide",
-	"named",
-	"submit-form",
-	"reset-form",
-	"import-data",
-	"javascript",
-	"set-ocg-state",
-	"rendition",
-	"transition",
-	"goto-3d-view"
+//#region src/dto/PdfDestination.schema.ts
+const pageObjectNumber = zod.z.number().int().positive();
+/** Spec-nullable axis value: absent and `null` both mean "retain current". */
+const axis = zod.z.number().nullable().optional();
+/**
+* Runtime schema for {@link PdfDestination}. Lives beside its DTO in `dto/`
+* so every destination-shaped surface (link targets, action-node payloads,
+* the document `openDestination`) shares one schema without an import cycle
+* through the annotation tree.
+*/
+const PdfDestinationSchema = zod.z.discriminatedUnion("kind", [
+	zod.z.object({
+		kind: zod.z.literal("xyz"),
+		pageObjectNumber,
+		left: axis,
+		top: axis,
+		zoom: axis
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fit"),
+		pageObjectNumber
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitH"),
+		pageObjectNumber,
+		top: axis
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitV"),
+		pageObjectNumber,
+		left: axis
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitR"),
+		pageObjectNumber,
+		left: zod.z.number(),
+		bottom: zod.z.number(),
+		right: zod.z.number(),
+		top: zod.z.number()
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitB"),
+		pageObjectNumber
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitBH"),
+		pageObjectNumber,
+		top: axis
+	}),
+	zod.z.object({
+		kind: zod.z.literal("fitBV"),
+		pageObjectNumber,
+		left: axis
+	})
 ]);
-const PdfActionNodeSchema = zod.z.lazy(() => zod.z.object({
-	type: PdfActionTypeSchema,
+//#endregion
+//#region src/dto/PdfAction.schema.ts
+const PdfActionTargetRefSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
+	kind: zod.z.literal("name"),
+	name: zod.z.string()
+}), zod.z.object({
+	kind: zod.z.literal("objectNumber"),
+	objectNumber: zod.z.number().int().positive()
+})]);
+/** Fields every node arm repeats — zod 3's discriminatedUnion needs plain
+*  object options, so the recursion (`next`) lives inline per arm and the
+*  whole union sits behind one `z.lazy`. */
+const nodeCommon = {
 	subtype: zod.z.string(),
-	script: zod.z.string().optional(),
-	next: zod.z.array(PdfActionNodeSchema)
-}));
+	next: zod.z.array(zod.z.lazy(() => PdfActionNodeSchema))
+};
+const arm = (type, shape = {}) => zod.z.object({
+	type: zod.z.literal(type),
+	...nodeCommon,
+	...shape
+});
+const SubmitFormFlagsSchema = zod.z.object({
+	raw: zod.z.number().int().nonnegative(),
+	exclude: zod.z.boolean(),
+	includeNoValueFields: zod.z.boolean(),
+	format: zod.z.enum([
+		"fdf",
+		"html",
+		"xfdf",
+		"pdf"
+	]),
+	method: zod.z.enum(["post", "get"]),
+	submitCoordinates: zod.z.boolean(),
+	includeAppendSaves: zod.z.boolean(),
+	includeAnnotations: zod.z.boolean(),
+	canonicalFormat: zod.z.boolean(),
+	exclNonUserAnnots: zod.z.boolean(),
+	exclFKey: zod.z.boolean(),
+	embedForm: zod.z.boolean()
+});
+const PDF_ACTION_NODE_ARMS = [
+	arm("javascript", { script: zod.z.string() }),
+	arm("goto", { destination: PdfDestinationSchema }),
+	arm("uri", {
+		uri: zod.z.string(),
+		isMap: zod.z.boolean()
+	}),
+	arm("named", { name: zod.z.string() }),
+	arm("hide", {
+		targets: zod.z.array(PdfActionTargetRefSchema),
+		hide: zod.z.boolean()
+	}),
+	arm("reset-form", {
+		fields: zod.z.array(PdfActionTargetRefSchema).nullable(),
+		exclude: zod.z.boolean()
+	}),
+	arm("goto-remote", { filePath: zod.z.string() }),
+	arm("goto-embedded", { filePath: zod.z.string() }),
+	arm("launch", { filePath: zod.z.string() }),
+	arm("rendition", { script: zod.z.string().optional() }),
+	arm("submit-form", { payload: zod.z.object({
+		url: zod.z.string(),
+		fields: zod.z.array(PdfActionTargetRefSchema).nullable(),
+		flags: SubmitFormFlagsSchema,
+		charSet: zod.z.string().optional()
+	}).optional() }),
+	arm("thread"),
+	arm("sound"),
+	arm("movie"),
+	arm("import-data"),
+	arm("set-ocg-state"),
+	arm("transition"),
+	arm("goto-3d-view"),
+	arm("unknown")
+];
+const PdfActionNodeSchema = zod.z.lazy(() => zod.z.discriminatedUnion("type", [...PDF_ACTION_NODE_ARMS]));
+/** The `/S` vocabulary, derived from the union arms so it cannot drift. */
+const PdfActionTypeSchema = zod.z.enum(PDF_ACTION_NODE_ARMS.map((option) => option.shape.type.value));
 const PdfActionTreeSchema = zod.z.object({
 	root: PdfActionNodeSchema.nullable(),
 	incomplete: zod.z.boolean(),
@@ -79,7 +184,8 @@ const PdfActionTreeSchema = zod.z.object({
 	warnings: zod.z.array(zod.z.enum([
 		"cycle-dropped",
 		"malformed-next",
-		"incomplete"
+		"incomplete",
+		"payload-dropped"
 	]))
 });
 const PdfFieldActionsSchema = zod.z.object({
@@ -111,12 +217,34 @@ const DocumentActionsSnapshotSchema = zod.z.object({
 		action: PdfActionTreeSchema
 	})),
 	openAction: PdfActionTreeSchema.nullable(),
+	openDestination: PdfDestinationSchema.nullable().default(null),
 	willClose: PdfActionTreeSchema.optional(),
 	willSave: PdfActionTreeSchema.optional(),
 	didSave: PdfActionTreeSchema.optional(),
 	willPrint: PdfActionTreeSchema.optional(),
 	didPrint: PdfActionTreeSchema.optional()
+}).superRefine((snapshot, context) => {
+	if (snapshot.openAction !== null && (snapshot.openDestination ?? null) !== null) context.addIssue({
+		code: zod.z.ZodIssueCode.custom,
+		message: "openAction and openDestination are mutually exclusive",
+		path: ["openDestination"]
+	});
 });
+/**
+* Stable public component names for generators that project the action wire
+* model into OpenAPI or another schema format. Keep reusable boundaries here;
+* individual action arms remain owned by `PdfActionNodeSchema`.
+*/
+const PdfActionWireComponents = {
+	PdfActionTargetRef: PdfActionTargetRefSchema,
+	PdfDestination: PdfDestinationSchema,
+	PdfActionNode: PdfActionNodeSchema,
+	PdfActionTree: PdfActionTreeSchema,
+	PdfFieldActions: PdfFieldActionsSchema,
+	PdfPageActions: PdfPageActionsSchema,
+	PdfAnnotationActions: PdfAnnotationActionsSchema,
+	DocumentActionsSnapshot: DocumentActionsSnapshotSchema
+};
 //#endregion
 //#region src/annotation/base.schema.ts
 /** @deprecated Use `PdfPointSchema` from `../geometry/schemas`. */
@@ -274,6 +402,7 @@ const AnnotationBaseShape = {
 	flags: AnnotationFlagsSchema,
 	rect: PdfRectSchema,
 	contents: zod.z.string().nullable(),
+	subject: zod.z.string().nullable(),
 	author: zod.z.string().nullable(),
 	created: zod.z.string().datetime().nullable(),
 	modified: zod.z.string().datetime().nullable(),
@@ -296,6 +425,7 @@ const AnnotationBaseShape = {
 */
 const AnnotationDraftBaseShape = {
 	contents: zod.z.string().nullable().optional(),
+	subject: zod.z.string().nullable().optional(),
 	blendMode: BlendModeSchema.optional(),
 	nm: zod.z.string().optional(),
 	flags: AnnotationFlagsPartialSchema.optional(),
@@ -314,6 +444,7 @@ const AnnotationDraftBaseShape = {
 */
 const AnnotationPatchBaseShape = {
 	contents: zod.z.string().nullable().optional(),
+	subject: zod.z.string().nullable().optional(),
 	blendMode: BlendModeSchema.optional(),
 	groupId: zod.z.string().min(1).optional(),
 	flags: AnnotationFlagsPartialSchema.optional(),
@@ -360,6 +491,8 @@ const CaretDTOSchema = zod.z.object({
 	...ColorStyleDTOShape,
 	intent: CaretIntentSchema.nullable(),
 	rectDifferences: PdfRectDifferencesSchema.nullable(),
+	rotation: zod.z.number().optional(),
+	unrotatedRect: PdfRectSchema.optional(),
 	subtype: zod.z.literal("caret")
 });
 const CaretDraftSchema = zod.z.object({
@@ -368,6 +501,8 @@ const CaretDraftSchema = zod.z.object({
 	intent: CaretIntentSchema.optional(),
 	rect: PdfRectSchema,
 	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
+	rotation: zod.z.number().nullable().optional(),
+	unrotatedRect: PdfRectSchema.nullable().optional(),
 	subtype: zod.z.literal("caret")
 });
 const CaretPatchSchema = zod.z.object({
@@ -376,13 +511,15 @@ const CaretPatchSchema = zod.z.object({
 	intent: CaretIntentSchema.optional(),
 	rect: PdfRectSchema.optional(),
 	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
+	rotation: zod.z.number().nullable().optional(),
+	unrotatedRect: PdfRectSchema.nullable().optional(),
 	subtype: zod.z.literal("caret")
 });
 //#endregion
 //#region src/annotation/kinds/caret/index.ts
 const CaretKind = {
 	subtype: "caret",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.CARET,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.CARET,
 	dtoSchema: CaretDTOSchema,
 	draftSchema: CaretDraftSchema,
 	patchSchema: CaretPatchSchema
@@ -433,7 +570,7 @@ const CirclePatchSchema = zod.z.object({
 //#region src/annotation/kinds/circle/index.ts
 const CircleKind = {
 	subtype: "circle",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.CIRCLE,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.CIRCLE,
 	dtoSchema: CircleDTOSchema,
 	draftSchema: CircleDraftSchema,
 	patchSchema: CirclePatchSchema
@@ -517,7 +654,7 @@ const FileAttachmentPatchSchema = zod.z.object({
 */
 const FileAttachmentKind = {
 	subtype: "file-attachment",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.FILEATTACHMENT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.FILEATTACHMENT,
 	dtoSchema: FileAttachmentDTOSchema,
 	draftSchema: FileAttachmentWireDraftSchema,
 	patchSchema: FileAttachmentPatchSchema
@@ -595,7 +732,7 @@ const FreeTextPatchSchema = zod.z.object({
 //#region src/annotation/kinds/free-text/index.ts
 const FreeTextKind = {
 	subtype: "free-text",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.FREETEXT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.FREETEXT,
 	dtoSchema: FreeTextDTOSchema,
 	draftSchema: FreeTextDraftSchema,
 	patchSchema: FreeTextPatchSchema
@@ -635,7 +772,7 @@ const HighlightPatchSchema = zod.z.object({
 //#region src/annotation/kinds/highlight/index.ts
 const HighlightKind = {
 	subtype: "highlight",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.HIGHLIGHT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.HIGHLIGHT,
 	dtoSchema: HighlightDTOSchema,
 	draftSchema: HighlightDraftSchema,
 	patchSchema: HighlightPatchSchema
@@ -672,7 +809,7 @@ const InkPatchSchema = zod.z.object({
 //#region src/annotation/kinds/ink/index.ts
 const InkKind = {
 	subtype: "ink",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.INK,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.INK,
 	dtoSchema: InkDTOSchema,
 	draftSchema: InkDraftSchema,
 	patchSchema: InkPatchSchema
@@ -709,65 +846,13 @@ const LinePatchSchema = zod.z.object({
 //#region src/annotation/kinds/line/index.ts
 const LineKind = {
 	subtype: "line",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.LINE,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.LINE,
 	dtoSchema: LineDTOSchema,
 	draftSchema: LineDraftSchema,
 	patchSchema: LinePatchSchema
 };
 //#endregion
 //#region src/annotation/kinds/link/schema.ts
-const pageObjectNumber = zod.z.number().int().positive();
-/** Spec-nullable axis value: absent and `null` both mean "retain current". */
-const axis = zod.z.number().nullable().optional();
-/**
-* Runtime schema for {@link PdfDestination}. Lives with the link kind (its
-* first wire consumer); the outline/bookmark port reuses it from here.
-*/
-const PdfDestinationSchema = zod.z.discriminatedUnion("kind", [
-	zod.z.object({
-		kind: zod.z.literal("xyz"),
-		pageObjectNumber,
-		left: axis,
-		top: axis,
-		zoom: axis
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fit"),
-		pageObjectNumber
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitH"),
-		pageObjectNumber,
-		top: axis
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitV"),
-		pageObjectNumber,
-		left: axis
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitR"),
-		pageObjectNumber,
-		left: zod.z.number(),
-		bottom: zod.z.number(),
-		right: zod.z.number(),
-		top: zod.z.number()
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitB"),
-		pageObjectNumber
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitBH"),
-		pageObjectNumber,
-		top: axis
-	}),
-	zod.z.object({
-		kind: zod.z.literal("fitBV"),
-		pageObjectNumber,
-		left: axis
-	})
-]);
 const GotoTargetSchema = zod.z.object({
 	kind: zod.z.literal("goto"),
 	destination: PdfDestinationSchema
@@ -817,7 +902,7 @@ const LinkPatchSchema = zod.z.object({
 //#region src/annotation/kinds/link/index.ts
 const LinkKind = {
 	subtype: "link",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.LINK,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.LINK,
 	dtoSchema: LinkDTOSchema,
 	draftSchema: LinkDraftSchema,
 	patchSchema: LinkPatchSchema
@@ -868,7 +953,7 @@ const PolygonPatchSchema = zod.z.object({
 //#region src/annotation/kinds/polygon/index.ts
 const PolygonKind = {
 	subtype: "polygon",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.POLYGON,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.POLYGON,
 	dtoSchema: PolygonDTOSchema,
 	draftSchema: PolygonDraftSchema,
 	patchSchema: PolygonPatchSchema
@@ -899,7 +984,7 @@ const PolylinePatchSchema = zod.z.object({
 //#region src/annotation/kinds/polyline/index.ts
 const PolylineKind = {
 	subtype: "polyline",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.POLYLINE,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.POLYLINE,
 	dtoSchema: PolylineDTOSchema,
 	draftSchema: PolylineDraftSchema,
 	patchSchema: PolylinePatchSchema
@@ -962,7 +1047,7 @@ const RedactPatchSchema = zod.z.object({
 //#region src/annotation/kinds/redact/index.ts
 const RedactKind = {
 	subtype: "redact",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.REDACT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.REDACT,
 	dtoSchema: RedactDTOSchema,
 	draftSchema: RedactDraftSchema,
 	patchSchema: RedactPatchSchema
@@ -987,7 +1072,7 @@ const SquarePatchSchema = zod.z.object({
 //#region src/annotation/kinds/square/index.ts
 const SquareKind = {
 	subtype: "square",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.SQUARE,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.SQUARE,
 	dtoSchema: SquareDTOSchema,
 	draftSchema: SquareDraftSchema,
 	patchSchema: SquarePatchSchema
@@ -1012,7 +1097,7 @@ const SquigglyPatchSchema = zod.z.object({
 //#region src/annotation/kinds/squiggly/index.ts
 const SquigglyKind = {
 	subtype: "squiggly",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.SQUIGGLY,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.SQUIGGLY,
 	dtoSchema: SquigglyDTOSchema,
 	draftSchema: SquigglyDraftSchema,
 	patchSchema: SquigglyPatchSchema
@@ -1067,7 +1152,7 @@ const StampWirePatchSchema = zod.z.object({
 */
 const StampKind = {
 	subtype: "stamp",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.STAMP,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.STAMP,
 	dtoSchema: StampDTOSchema,
 	draftSchema: StampWireDraftSchema,
 	patchSchema: StampWirePatchSchema
@@ -1095,7 +1180,7 @@ const StrikeoutPatchSchema = zod.z.object({
 //#region src/annotation/kinds/strikeout/index.ts
 const StrikeoutKind = {
 	subtype: "strikeout",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.STRIKEOUT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.STRIKEOUT,
 	dtoSchema: StrikeoutDTOSchema,
 	draftSchema: StrikeoutDraftSchema,
 	patchSchema: StrikeoutPatchSchema
@@ -1115,6 +1200,8 @@ const TextDTOSchema = zod.z.object({
 	...AnnotationBaseShape,
 	...ColorStyleDTOShape,
 	icon: NoteIconSchema,
+	state: zod.z.string().nullable(),
+	stateModel: zod.z.string().nullable(),
 	subtype: zod.z.literal("text")
 });
 const TextDraftSchema = zod.z.object({
@@ -1122,6 +1209,8 @@ const TextDraftSchema = zod.z.object({
 	...AnnotationDraftBaseShape,
 	rect: PdfRectSchema,
 	icon: NoteIconSchema.optional(),
+	state: zod.z.string().min(1).optional(),
+	stateModel: zod.z.string().min(1).optional(),
 	subtype: zod.z.literal("text")
 });
 const TextPatchSchema = zod.z.object({
@@ -1129,13 +1218,15 @@ const TextPatchSchema = zod.z.object({
 	...AnnotationPatchBaseShape,
 	rect: PdfRectSchema.optional(),
 	icon: NoteIconSchema.optional(),
+	state: zod.z.string().min(1).nullable().optional(),
+	stateModel: zod.z.string().min(1).nullable().optional(),
 	subtype: zod.z.literal("text")
 });
 //#endregion
 //#region src/annotation/kinds/text/index.ts
 const TextKind = {
 	subtype: "text",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.TEXT,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.TEXT,
 	dtoSchema: TextDTOSchema,
 	draftSchema: TextDraftSchema,
 	patchSchema: TextPatchSchema
@@ -1160,7 +1251,7 @@ const UnderlinePatchSchema = zod.z.object({
 //#region src/annotation/kinds/underline/index.ts
 const UnderlineKind = {
 	subtype: "underline",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.UNDERLINE,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.UNDERLINE,
 	dtoSchema: UnderlineDTOSchema,
 	draftSchema: UnderlineDraftSchema,
 	patchSchema: UnderlinePatchSchema
@@ -1179,7 +1270,7 @@ const UnsupportedPatchSchema = zod.z.never();
 //#region src/annotation/kinds/unsupported/index.ts
 const UnsupportedKind = {
 	subtype: "unsupported",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.UNKNOWN,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.UNKNOWN,
 	dtoSchema: UnsupportedDTOSchema,
 	draftSchema: UnsupportedDraftSchema,
 	patchSchema: UnsupportedPatchSchema
@@ -1242,7 +1333,7 @@ const WidgetPatchSchema = zod.z.object({
 //#region src/annotation/kinds/widget/index.ts
 const WidgetKind = {
 	subtype: "widget",
-	pdfSubtypeCode: require_subtype.PdfAnnotationSubtypeCode.WIDGET,
+	pdfSubtypeCode: require_PageInsertBlankInput.PdfAnnotationSubtypeCode.WIDGET,
 	dtoSchema: WidgetDTOSchema,
 	draftSchema: WidgetDraftSchema,
 	patchSchema: WidgetPatchSchema
@@ -1693,7 +1784,10 @@ const DocumentHeadSchema = zod.z.object({
 	})
 });
 const AccessRequestSchema = zod.z.object({
-	docId: zod.z.string().min(1),
+	/** Deprecated: identity now rides the PATH
+	*  (`/v1/docs/:docId/layers/:layerName/access`). Kept optional for the
+	*  legacy `/v1/access` alias, which requires `docId` in the body. */
+	docId: zod.z.string().min(1).optional(),
 	layerName: zod.z.string().min(1).optional(),
 	password: zod.z.string().optional(),
 	passwordGrant: zod.z.string().optional(),
@@ -1874,7 +1968,7 @@ const AccessResponseSchema = zod.z.object({
 	}).optional()
 });
 const PdfSaveModeSchema = zod.z.enum(["incremental", "rewrite"]);
-const engineErrorCodeValues = Object.values(require_subtype.EngineErrorCode);
+const engineErrorCodeValues = Object.values(require_PageInsertBlankInput.EngineErrorCode);
 const EngineErrorPayloadSchema = zod.z.object({
 	name: zod.z.literal("EngineError"),
 	code: zod.z.enum(engineErrorCodeValues),
@@ -1945,6 +2039,7 @@ const DocumentManifestSchema = zod.z.object({
 	metadataVersion: zod.z.number().int().positive(),
 	actionsVersion: zod.z.number().int().positive().default(1),
 	attachmentsVersion: zod.z.number().int().positive().default(1),
+	annotationsVersion: zod.z.number().int().positive().default(1),
 	auditHead: zod.z.number().int().nonnegative(),
 	baseSha: zod.z.string(),
 	scopes: LayerScopesSchema.optional(),
@@ -1954,29 +2049,55 @@ const AnnotationListPageSnapshotSchema = zod.z.object({
 	pageState: PageStateSchema,
 	annotations: zod.z.array(AnnotationDTOSchema)
 });
-const AnnotationListSnapshotAllPagesSchema = zod.z.object({ pages: zod.z.array(AnnotationListPageSnapshotSchema) });
+const AnnotationListSnapshotAllPagesSchema = zod.z.object({
+	pages: zod.z.array(AnnotationListPageSnapshotSchema),
+	auditHead: zod.z.number().int().nonnegative().optional()
+});
 /**
-* Wire shape of `GET /v1/docs/:docId/pages/:pon/text@contentVersion=N` and the
-* `pages.text` worker result. Carries the same `pageState` envelope
-* every page-scoped read returns, plus the full plain-text extraction
-* in display order and PDFium's char-count (which may exceed
-* `text.length / 1` when astral-plane characters are present).
+* Wire shape of `GET …/text/pages/:pon/data@<contentVersion>` and the
+* `pages.text` worker result: the UTF-16-faithful extraction, the CHARACTER
+* space size (`charCount` — the space geometry runs tile; NOT `text.length`),
+* and the optional character→text anchor map. Malformed maps are rejected
+* here with the shared `charMapViolation` invariants — absent/empty map
+* REQUIRES `charCount === text.length` (identity).
 */
 const PageTextSnapshotSchema = zod.z.object({
 	text: zod.z.string(),
-	charCount: zod.z.number().int().nonnegative()
+	charCount: zod.z.number().int().nonnegative(),
+	charMap: zod.z.array(zod.z.tuple([zod.z.number().int().nonnegative(), zod.z.number().int().nonnegative()])).optional()
+}).superRefine((snapshot, ctx) => {
+	const violation = require_PageInsertBlankInput.charMapViolation(snapshot.charCount, snapshot.text.length, snapshot.charMap);
+	if (violation !== null) ctx.addIssue({
+		code: zod.z.ZodIssueCode.custom,
+		path: ["charMap"],
+		message: violation
+	});
 });
 const PageGeometryGlyphSchema = zod.z.object({
 	looseBox: PdfRectSchema,
 	flags: zod.z.number().int().nonnegative(),
 	tightBox: PdfRectSchema.optional()
 });
-const PageGeometryRunSchema = zod.z.object({
+const RotatedGeometryGlyphSchema = zod.z.object({
+	looseQuad: PdfQuadSchema,
+	flags: zod.z.number().int().nonnegative(),
+	tightQuad: PdfQuadSchema.optional()
+});
+const UprightGeometryRunSchema = zod.z.object({
 	rect: PdfRectSchema,
 	charStart: zod.z.number().int().nonnegative(),
 	glyphs: zod.z.array(PageGeometryGlyphSchema),
 	fontSize: zod.z.number().optional()
 });
+const RotatedGeometryRunSchema = zod.z.object({
+	rect: PdfRectSchema,
+	charStart: zod.z.number().int().nonnegative(),
+	glyphs: zod.z.array(RotatedGeometryGlyphSchema),
+	rotation: zod.z.number(),
+	ascentFlip: zod.z.boolean(),
+	fontSize: zod.z.number().optional()
+});
+const PageGeometryRunSchema = zod.z.union([RotatedGeometryRunSchema, UprightGeometryRunSchema]);
 const PageGeometrySnapshotSchema = zod.z.object({ runs: zod.z.array(PageGeometryRunSchema) });
 /**
 * Search wire shapes: the request body of the layer search route and the
@@ -2008,11 +2129,16 @@ const SearchSnippetSchema = zod.z.object({
 	matchStart: zod.z.number().int().nonnegative(),
 	matchLength: zod.z.number().int().positive()
 });
+const PdfTextSegmentSchema = zod.z.object({
+	quad: PdfQuadSchema,
+	rect: PdfRectSchema,
+	advance: zod.z.union([zod.z.literal(1), zod.z.literal(-1)])
+});
 const SearchMatchSchema = zod.z.object({
 	pageObjectNumber: zod.z.number().int().positive(),
 	charStart: zod.z.number().int().nonnegative(),
 	charCount: zod.z.number().int().positive(),
-	rects: zod.z.array(PdfRectSchema),
+	segments: zod.z.array(PdfTextSegmentSchema),
 	snippet: SearchSnippetSchema.optional()
 });
 const SearchSliceSchema = zod.z.object({
@@ -2186,6 +2312,7 @@ const RefetchReasonSchema = zod.z.enum([
 const CacheDeltaSchema = zod.z.object({
 	previousDocVersion: zod.z.number().int().positive(),
 	docVersion: zod.z.number().int().positive(),
+	annotationsVersion: zod.z.number().int().positive().optional(),
 	pages: zod.z.array(zod.z.object({
 		pageObjectNumber: zod.z.number().int().positive(),
 		cache: CachePinsSchema
@@ -2454,6 +2581,37 @@ const PageDeleteResultSchema = zod.z.object({
 	cache: PageStructureCacheSchema.nullable()
 });
 /**
+* Page insert (bytes) input — the JSON `body` part of the multipart
+* mutation envelope; the PDF itself rides the `resource:source` part.
+* `destIndex` omitted → append.
+*/
+const PageInsertInputSchema = zod.z.object({ destIndex: zod.z.number().int().nonnegative().optional() });
+/**
+* Blank-page insert input — plain JSON, pages.insert minus the bytes.
+* `size` is in PDF points (un-rotated); `count` shares the contract cap
+* with the worker so a request the schema accepts cannot then fail the
+* worker's own guard.
+*/
+const PageInsertBlankInputSchema = zod.z.object({
+	size: zod.z.object({
+		width: zod.z.number().positive().finite(),
+		height: zod.z.number().positive().finite()
+	}),
+	count: zod.z.number().int().min(1).max(100).optional(),
+	destIndex: zod.z.number().int().nonnegative().optional()
+});
+/** Page extract input: the pages to export, in the order they should appear. */
+const PageExtractInputSchema = zod.z.object({ pageObjectNumbers: zod.z.array(zod.z.number().int().positive()).min(1) });
+/**
+* Page insert result — shared by bytes-insert and blank-insert: the fresh
+* PONs in insertion order plus the full new layout (see `PageInsertResult`).
+*/
+const PageInsertResultSchema = zod.z.object({
+	insertedPageObjectNumbers: zod.z.array(zod.z.number().int().positive()),
+	layout: PageListSnapshotSchema,
+	cache: PageStructureCacheSchema.nullable()
+});
+/**
 * Metadata write result. The Info dict is rewritten in place, so the
 * result returns the re-read `metadata` plus cloud coherence pins. No
 * `layoutVersion` is touched — a metadata edit bumps only `docVersion`
@@ -3124,6 +3282,12 @@ Object.defineProperty(exports, "PageDeleteResultSchema", {
 		return PageDeleteResultSchema;
 	}
 });
+Object.defineProperty(exports, "PageExtractInputSchema", {
+	enumerable: true,
+	get: function() {
+		return PageExtractInputSchema;
+	}
+});
 Object.defineProperty(exports, "PageFlattenInputSchema", {
 	enumerable: true,
 	get: function() {
@@ -3142,6 +3306,24 @@ Object.defineProperty(exports, "PageGeometrySnapshotSchema", {
 		return PageGeometrySnapshotSchema;
 	}
 });
+Object.defineProperty(exports, "PageInsertBlankInputSchema", {
+	enumerable: true,
+	get: function() {
+		return PageInsertBlankInputSchema;
+	}
+});
+Object.defineProperty(exports, "PageInsertInputSchema", {
+	enumerable: true,
+	get: function() {
+		return PageInsertInputSchema;
+	}
+});
+Object.defineProperty(exports, "PageInsertResultSchema", {
+	enumerable: true,
+	get: function() {
+		return PageInsertResultSchema;
+	}
+});
 Object.defineProperty(exports, "PageLayoutSchema", {
 	enumerable: true,
 	get: function() {
@@ -3220,6 +3402,12 @@ Object.defineProperty(exports, "PdfActionNodeSchema", {
 		return PdfActionNodeSchema;
 	}
 });
+Object.defineProperty(exports, "PdfActionTargetRefSchema", {
+	enumerable: true,
+	get: function() {
+		return PdfActionTargetRefSchema;
+	}
+});
 Object.defineProperty(exports, "PdfActionTreeSchema", {
 	enumerable: true,
 	get: function() {
@@ -3232,6 +3420,12 @@ Object.defineProperty(exports, "PdfActionTypeSchema", {
 		return PdfActionTypeSchema;
 	}
 });
+Object.defineProperty(exports, "PdfActionWireComponents", {
+	enumerable: true,
+	get: function() {
+		return PdfActionWireComponents;
+	}
+});
 Object.defineProperty(exports, "PdfAnnotationActionsSchema", {
 	enumerable: true,
 	get: function() {
@@ -3605,4 +3799,4 @@ Object.defineProperty(exports, "WireAttachmentFileSchema", {
 	}
 });
 
-//# sourceMappingURL=schemas-B_1VyFsm.cjs.map
+//# sourceMappingURL=schemas-CS5iPpX5.cjs.map