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

package/dist/schemas-CFQGvWiu.js

@@ -1,3243 +0,0 @@
-import { f as PdfAnnotationSubtypeCode, m as EngineErrorCode, n as validNumberFormat, o as charMapViolation } from "./format-Bbphf4zR.js";
-import { z } from "zod";
-//#region src/geometry/schemas.ts
-/**
-* Zod schemas for engine PDF-document geometry. Exported from `wire.ts` ONLY
-* (never from `shared.ts`/`runtime`) so the zod-free runtime stays zod-free.
-*/
-const PdfPointSchema = z.object({
-	x: z.number(),
-	y: z.number()
-});
-const LinePointsSchema = z.object({
-	start: PdfPointSchema,
-	end: PdfPointSchema
-});
-/** `/CL` callout leader line — two points (straight) or three (knee-jointed). */
-const CalloutLineSchema = z.union([z.tuple([PdfPointSchema, PdfPointSchema]), z.tuple([
-	PdfPointSchema,
-	PdfPointSchema,
-	PdfPointSchema
-])]);
-/** `/InkList` — an array of strokes, each an array of points. */
-const InkListSchema = z.array(z.array(PdfPointSchema));
-const PdfRectSchema = z.object({
-	left: z.number(),
-	bottom: z.number(),
-	right: z.number(),
-	top: z.number()
-});
-const PdfSizeSchema = z.object({
-	width: z.number().nonnegative(),
-	height: z.number().nonnegative()
-});
-const PdfQuadSchema = z.object({
-	p1: PdfPointSchema,
-	p2: PdfPointSchema,
-	p3: PdfPointSchema,
-	p4: PdfPointSchema
-});
-const PdfRotationSchema = z.union([
-	z.literal(0),
-	z.literal(90),
-	z.literal(180),
-	z.literal(270)
-]);
-//#endregion
-//#region src/dto/PdfDestination.schema.ts
-const pageObjectNumber = z.number().int().positive();
-/** Spec-nullable axis value: absent and `null` both mean "retain current". */
-const axis = 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 = z.discriminatedUnion("kind", [
-	z.object({
-		kind: z.literal("xyz"),
-		pageObjectNumber,
-		left: axis,
-		top: axis,
-		zoom: axis
-	}),
-	z.object({
-		kind: z.literal("fit"),
-		pageObjectNumber
-	}),
-	z.object({
-		kind: z.literal("fitH"),
-		pageObjectNumber,
-		top: axis
-	}),
-	z.object({
-		kind: z.literal("fitV"),
-		pageObjectNumber,
-		left: axis
-	}),
-	z.object({
-		kind: z.literal("fitR"),
-		pageObjectNumber,
-		left: z.number(),
-		bottom: z.number(),
-		right: z.number(),
-		top: z.number()
-	}),
-	z.object({
-		kind: z.literal("fitB"),
-		pageObjectNumber
-	}),
-	z.object({
-		kind: z.literal("fitBH"),
-		pageObjectNumber,
-		top: axis
-	}),
-	z.object({
-		kind: z.literal("fitBV"),
-		pageObjectNumber,
-		left: axis
-	})
-]);
-//#endregion
-//#region src/dto/PdfAction.schema.ts
-const PdfActionTargetRefSchema = z.discriminatedUnion("kind", [z.object({
-	kind: z.literal("name"),
-	name: z.string()
-}), z.object({
-	kind: z.literal("objectNumber"),
-	objectNumber: 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: z.string(),
-	next: z.array(z.lazy(() => PdfActionNodeSchema))
-};
-const arm = (type, shape = {}) => z.object({
-	type: z.literal(type),
-	...nodeCommon,
-	...shape
-});
-const SubmitFormFlagsSchema = z.object({
-	raw: z.number().int().nonnegative(),
-	exclude: z.boolean(),
-	includeNoValueFields: z.boolean(),
-	format: z.enum([
-		"fdf",
-		"html",
-		"xfdf",
-		"pdf"
-	]),
-	method: z.enum(["post", "get"]),
-	submitCoordinates: z.boolean(),
-	includeAppendSaves: z.boolean(),
-	includeAnnotations: z.boolean(),
-	canonicalFormat: z.boolean(),
-	exclNonUserAnnots: z.boolean(),
-	exclFKey: z.boolean(),
-	embedForm: z.boolean()
-});
-const PDF_ACTION_NODE_ARMS = [
-	arm("javascript", { script: z.string() }),
-	arm("goto", { destination: PdfDestinationSchema }),
-	arm("uri", {
-		uri: z.string(),
-		isMap: z.boolean()
-	}),
-	arm("named", { name: z.string() }),
-	arm("hide", {
-		targets: z.array(PdfActionTargetRefSchema),
-		hide: z.boolean()
-	}),
-	arm("reset-form", {
-		fields: z.array(PdfActionTargetRefSchema).nullable(),
-		exclude: z.boolean()
-	}),
-	arm("goto-remote", { filePath: z.string() }),
-	arm("goto-embedded", { filePath: z.string() }),
-	arm("launch", { filePath: z.string() }),
-	arm("rendition", { script: z.string().optional() }),
-	arm("submit-form", { payload: z.object({
-		url: z.string(),
-		fields: z.array(PdfActionTargetRefSchema).nullable(),
-		flags: SubmitFormFlagsSchema,
-		charSet: 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 = z.lazy(() => z.discriminatedUnion("type", [...PDF_ACTION_NODE_ARMS]));
-/** The `/S` vocabulary, derived from the union arms so it cannot drift. */
-const PdfActionTypeSchema = z.enum(PDF_ACTION_NODE_ARMS.map((option) => option.shape.type.value));
-const PdfActionTreeSchema = z.object({
-	root: PdfActionNodeSchema.nullable(),
-	incomplete: z.boolean(),
-	warningFlags: z.number().int().nonnegative(),
-	warnings: z.array(z.enum([
-		"cycle-dropped",
-		"malformed-next",
-		"incomplete",
-		"payload-dropped"
-	]))
-});
-const PdfFieldActionsSchema = z.object({
-	keystroke: PdfActionTreeSchema.optional(),
-	format: PdfActionTreeSchema.optional(),
-	validate: PdfActionTreeSchema.optional(),
-	calculate: PdfActionTreeSchema.optional()
-});
-const PdfPageActionsSchema = z.object({
-	open: PdfActionTreeSchema.optional(),
-	close: PdfActionTreeSchema.optional()
-});
-const PdfAnnotationActionsSchema = z.object({
-	activate: PdfActionTreeSchema.optional(),
-	cursorEnter: PdfActionTreeSchema.optional(),
-	cursorExit: PdfActionTreeSchema.optional(),
-	mouseDown: PdfActionTreeSchema.optional(),
-	mouseUp: PdfActionTreeSchema.optional(),
-	focus: PdfActionTreeSchema.optional(),
-	blur: PdfActionTreeSchema.optional(),
-	pageOpen: PdfActionTreeSchema.optional(),
-	pageClose: PdfActionTreeSchema.optional(),
-	pageVisible: PdfActionTreeSchema.optional(),
-	pageInvisible: PdfActionTreeSchema.optional()
-});
-const DocumentActionsSnapshotSchema = z.object({
-	nameTreeScripts: z.array(z.object({
-		name: z.string(),
-		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: 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`. */
-const PointSchema = PdfPointSchema;
-/** @deprecated Use `PdfRectSchema` from `../geometry/schemas`. */
-const RectSchema = PdfRectSchema;
-const ColorSchema = z.object({
-	r: z.number().int().min(0).max(255),
-	g: z.number().int().min(0).max(255),
-	b: z.number().int().min(0).max(255)
-});
-const AnnotationBorderStyleSchema = z.enum([
-	"solid",
-	"dashed",
-	"beveled",
-	"inset"
-]);
-const PdfRectDifferencesSchema = z.object({
-	left: z.number().nonnegative(),
-	top: z.number().nonnegative(),
-	right: z.number().nonnegative(),
-	bottom: z.number().nonnegative()
-});
-const LineEndingSchema = z.enum([
-	"none",
-	"square",
-	"circle",
-	"diamond",
-	"open-arrow",
-	"closed-arrow",
-	"butt",
-	"r-open-arrow",
-	"r-closed-arrow",
-	"slash"
-]);
-const LineEndingsSchema = z.object({
-	start: LineEndingSchema,
-	end: LineEndingSchema
-});
-const StandardFontSchema = z.enum([
-	"courier",
-	"courier-bold",
-	"courier-bold-oblique",
-	"courier-oblique",
-	"helvetica",
-	"helvetica-bold",
-	"helvetica-bold-oblique",
-	"helvetica-oblique",
-	"times-roman",
-	"times-bold",
-	"times-bold-italic",
-	"times-italic",
-	"symbol",
-	"zapf-dingbats"
-]);
-const TextAlignmentSchema = z.enum([
-	"left",
-	"center",
-	"right"
-]);
-const FreeTextIntentSchema = z.enum(["free-text", "free-text-callout"]);
-const CaretIntentSchema = z.literal("replace");
-const StrikeoutIntentSchema = z.literal("strikeout-text-edit");
-const InkIntentSchema = z.literal("ink-highlight");
-const BlendModeSchema = z.enum([
-	"normal",
-	"multiply",
-	"screen",
-	"overlay",
-	"darken",
-	"lighten",
-	"color-dodge",
-	"color-burn",
-	"hard-light",
-	"soft-light",
-	"difference",
-	"exclusion",
-	"hue",
-	"saturation",
-	"color",
-	"luminosity"
-]);
-const AnnotationFlagsSchema = z.object({
-	invisible: z.boolean(),
-	hidden: z.boolean(),
-	print: z.boolean(),
-	noZoom: z.boolean(),
-	noRotate: z.boolean(),
-	noView: z.boolean(),
-	readOnly: z.boolean(),
-	locked: z.boolean(),
-	toggleNoView: z.boolean(),
-	lockedContents: z.boolean()
-});
-/**
-* Partial flag set authorable on a Draft or Patch — every key optional so
-* callers set only the bits they care about. The engine merges these onto
-* the annotation's current `/F` bitset.
-*/
-const AnnotationFlagsPartialSchema = z.object({
-	invisible: z.boolean(),
-	hidden: z.boolean(),
-	print: z.boolean(),
-	noZoom: z.boolean(),
-	noRotate: z.boolean(),
-	noView: z.boolean(),
-	readOnly: z.boolean(),
-	locked: z.boolean(),
-	toggleNoView: z.boolean(),
-	lockedContents: z.boolean()
-}).partial();
-const AnnotationStableIdSchema = z.discriminatedUnion("kind", [z.object({
-	kind: z.literal("objectNumber"),
-	value: z.number().int().nonnegative()
-}), z.object({
-	kind: z.literal("nm"),
-	value: z.string()
-})]);
-const RevisionTokenSchema = z.object({
-	docSessionId: z.string(),
-	pageObjectNumber: z.number().int().positive(),
-	generation: z.number().int().nonnegative()
-});
-const AnnotationRefSchema = z.discriminatedUnion("kind", [
-	z.object({
-		kind: z.literal("objectNumber"),
-		pageObjectNumber: z.number().int().positive(),
-		annotObjectNumber: z.number().int().positive()
-	}),
-	z.object({
-		kind: z.literal("nm"),
-		pageObjectNumber: z.number().int().positive(),
-		nm: z.string()
-	}),
-	z.object({
-		kind: z.literal("index"),
-		pageObjectNumber: z.number().int().positive(),
-		index: z.number().int().nonnegative(),
-		revision: RevisionTokenSchema
-	})
-]);
-/**
-* Shared object literal for every per-subtype DTO schema. Each kind's
-* `dto.schema.ts` extends this with its own `subtype` literal and
-* subtype-specific fields. Note that we do NOT include `subtype` here —
-* each kind sets its own literal so `z.discriminatedUnion('subtype', ...)`
-* works at the catalog level.
-*/
-const AnnotationBaseShape = {
-	ref: AnnotationRefSchema,
-	pageObjectNumber: z.number().int().positive(),
-	index: z.number().int().nonnegative(),
-	identityQuality: z.enum(["durable", "weak"]),
-	nm: z.string().nullable(),
-	flags: AnnotationFlagsSchema,
-	rect: PdfRectSchema,
-	contents: z.string().nullable(),
-	subject: z.string().nullable(),
-	author: z.string().nullable(),
-	created: z.string().datetime().nullable(),
-	modified: z.string().datetime().nullable(),
-	blendMode: BlendModeSchema,
-	inReplyTo: AnnotationRefSchema.nullable(),
-	replyType: z.enum(["reply", "group"]).nullable(),
-	userId: z.string().optional(),
-	groupId: z.string().optional(),
-	createdBy: z.string().optional(),
-	updatedBy: z.string().optional(),
-	actions: PdfAnnotationActionsSchema.optional()
-};
-/**
-* Annotation-wide fields shared by every Draft. Per-kind draft schemas
-* spread this alongside their family-specific shape.
-*
-* Authorial identity (/T, /EMBD_Metadata UserID/GroupID) is set by the
-* server from the caller's JWT identity — see the AnnotationDraftBase
-* docstring.
-*/
-const AnnotationDraftBaseShape = {
-	contents: z.string().nullable().optional(),
-	subject: z.string().nullable().optional(),
-	blendMode: BlendModeSchema.optional(),
-	nm: z.string().optional(),
-	flags: AnnotationFlagsPartialSchema.optional(),
-	inReplyTo: AnnotationRefSchema.optional(),
-	replyType: z.enum(["reply", "group"]).optional()
-};
-/**
-* Annotation-wide fields shared by every Patch. `nm` is monotonic per
-* annotation; clients target an existing annotation via AnnotationRef
-* instead of renaming.
-*
-* `groupId` is the only identity-shaped field on a patch — it
-* represents organizational ownership, and reassignment runs through
-* `checkSetGroup`. See AnnotationPatchBase for the full immutability
-* rules.
-*/
-const AnnotationPatchBaseShape = {
-	contents: z.string().nullable().optional(),
-	subject: z.string().nullable().optional(),
-	blendMode: BlendModeSchema.optional(),
-	groupId: z.string().min(1).optional(),
-	flags: AnnotationFlagsPartialSchema.optional(),
-	inReplyTo: AnnotationRefSchema.nullable().optional(),
-	replyType: z.enum(["reply", "group"]).optional()
-};
-//#endregion
-//#region src/annotation/kinds/style.shared.ts
-const ColorStyleDTOShape = {
-	color: ColorSchema,
-	opacity: z.number().min(0).max(1)
-};
-const ColorStyleDraftShape = {
-	color: ColorSchema.optional(),
-	opacity: z.number().min(0).max(1).optional()
-};
-const ColorStylePatchShape = ColorStyleDraftShape;
-const GeometryStyleDTOShape = {
-	...ColorStyleDTOShape,
-	strokeWidth: z.number().nonnegative(),
-	borderStyle: AnnotationBorderStyleSchema,
-	dashArray: z.array(z.number().nonnegative()).optional()
-};
-const GeometryStyleDraftShape = {
-	...ColorStyleDraftShape,
-	strokeWidth: z.number().nonnegative().optional(),
-	borderStyle: AnnotationBorderStyleSchema.optional(),
-	dashArray: z.array(z.number().nonnegative()).optional()
-};
-const GeometryStylePatchShape = GeometryStyleDraftShape;
-const FilledStyleDTOShape = {
-	...GeometryStyleDTOShape,
-	interiorColor: ColorSchema.nullable()
-};
-const FilledStyleDraftShape = {
-	...GeometryStyleDraftShape,
-	interiorColor: ColorSchema.nullable().optional()
-};
-const FilledStylePatchShape = FilledStyleDraftShape;
-//#endregion
-//#region src/annotation/kinds/caret/schema.ts
-const CaretDTOSchema = z.object({
-	...AnnotationBaseShape,
-	...ColorStyleDTOShape,
-	intent: CaretIntentSchema.nullable(),
-	rectDifferences: PdfRectDifferencesSchema.nullable(),
-	rotation: z.number().optional(),
-	unrotatedRect: PdfRectSchema.optional(),
-	subtype: z.literal("caret")
-});
-const CaretDraftSchema = z.object({
-	...ColorStyleDraftShape,
-	...AnnotationDraftBaseShape,
-	intent: CaretIntentSchema.optional(),
-	rect: PdfRectSchema,
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("caret")
-});
-const CaretPatchSchema = z.object({
-	...ColorStylePatchShape,
-	...AnnotationPatchBaseShape,
-	intent: CaretIntentSchema.optional(),
-	rect: PdfRectSchema.optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("caret")
-});
-//#endregion
-//#region src/annotation/kinds/caret/index.ts
-const CaretKind = {
-	subtype: "caret",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.CARET,
-	dtoSchema: CaretDTOSchema,
-	draftSchema: CaretDraftSchema,
-	patchSchema: CaretPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/shape.shared.ts
-const ShapeDTOShape = {
-	...AnnotationBaseShape,
-	...FilledStyleDTOShape,
-	cloudyIntensity: z.number().positive().nullable(),
-	rectDifferences: PdfRectDifferencesSchema.nullable(),
-	rotation: z.number().optional(),
-	unrotatedRect: PdfRectSchema.optional()
-};
-const ShapeDraftShape = {
-	...FilledStyleDraftShape,
-	rect: PdfRectSchema,
-	cloudyIntensity: z.number().positive().nullable().optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional()
-};
-const ShapePatchShape = {
-	...FilledStylePatchShape,
-	rect: PdfRectSchema.optional(),
-	cloudyIntensity: z.number().positive().nullable().optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional()
-};
-//#endregion
-//#region src/annotation/kinds/circle/schema.ts
-const CircleDTOSchema = z.object({
-	...ShapeDTOShape,
-	subtype: z.literal("circle")
-});
-const CircleDraftSchema = z.object({
-	...ShapeDraftShape,
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("circle")
-});
-const CirclePatchSchema = z.object({
-	...ShapePatchShape,
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("circle")
-});
-//#endregion
-//#region src/annotation/kinds/circle/index.ts
-const CircleKind = {
-	subtype: "circle",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.CIRCLE,
-	dtoSchema: CircleDTOSchema,
-	draftSchema: CircleDraftSchema,
-	patchSchema: CirclePatchSchema
-};
-//#endregion
-//#region src/dto/Attachment.schema.ts
-/**
-* Wire schemas for the attachment read vocabulary (see `Attachment.ts`).
-* The write-side `AttachmentFileSource` carries inline bytes and never
-* appears on the wire — its post-normalization form is the kind-owned
-* `WireAttachmentFile` (see `annotation/kinds/file-attachment/schema.ts`).
-*/
-const AttachmentFileInfoSchema = z.object({
-	name: z.string(),
-	mimeType: z.string().optional(),
-	description: z.string().optional(),
-	size: z.number().int().nonnegative().optional(),
-	checksum: z.string().optional(),
-	creationDate: z.string().optional()
-});
-const EmbeddedFileRefSchema = z.object({
-	kind: z.literal("key"),
-	key: z.string().min(1)
-});
-const EmbeddedFileItemSchema = z.object({
-	key: z.string(),
-	name: z.string(),
-	mimeType: z.string().optional(),
-	description: z.string().optional(),
-	size: z.number().int().nonnegative().optional(),
-	checksum: z.string().optional(),
-	creationDate: z.string().optional(),
-	index: z.number().int().nonnegative()
-});
-//#endregion
-//#region src/annotation/kinds/file-attachment/schema.ts
-const FileAttachmentIconSchema = z.enum([
-	"push-pin",
-	"paperclip",
-	"graph",
-	"tag"
-]);
-/** Post-normalization form of the attached file: metadata + resource ref. */
-const WireAttachmentFileSchema = z.object({
-	resource: z.string().min(1),
-	name: z.string().min(1),
-	mimeType: z.string().optional(),
-	description: z.string().optional()
-});
-const FileAttachmentDTOSchema = z.object({
-	...AnnotationBaseShape,
-	...ColorStyleDTOShape,
-	icon: FileAttachmentIconSchema,
-	file: AttachmentFileInfoSchema,
-	subtype: z.literal("file-attachment")
-});
-const FileAttachmentWireDraftSchema = z.object({
-	...ColorStyleDraftShape,
-	...AnnotationDraftBaseShape,
-	rect: PdfRectSchema,
-	file: WireAttachmentFileSchema,
-	icon: FileAttachmentIconSchema.optional(),
-	subtype: z.literal("file-attachment")
-});
-const FileAttachmentPatchSchema = z.object({
-	...ColorStylePatchShape,
-	...AnnotationPatchBaseShape,
-	rect: PdfRectSchema.optional(),
-	icon: FileAttachmentIconSchema.optional(),
-	subtype: z.literal("file-attachment")
-});
-//#endregion
-//#region src/annotation/kinds/file-attachment/index.ts
-/**
-* WIRE-typed like `StampKind`: the draft schema validates the
-* post-normalization form (`file` as metadata + resource ref). The
-* authoring `FileAttachmentDraft` (inline bytes) is swapped into the
-* public `AnnotationDraft` union in `kinds/index.ts`. The patch carries
-* no binary (`file` is create-only), so its authoring and wire forms are
-* the same type.
-*/
-const FileAttachmentKind = {
-	subtype: "file-attachment",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.FILEATTACHMENT,
-	dtoSchema: FileAttachmentDTOSchema,
-	draftSchema: FileAttachmentWireDraftSchema,
-	patchSchema: FileAttachmentPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/free-text/schema.ts
-/** Authoring `fontFamily`: a standard font name OR a registered font `key`.
-*  Any non-empty string is accepted; the writer resolves which it is (and a
-*  key that was never registered fails loud there). The read-back DTO keeps the
-*  narrower {@link StandardFontSchema}. */
-const FreeTextFontSchema = z.string().min(1);
-const HexColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/);
-const RichTextRunStyleShape = {
-	family: z.string().min(1),
-	weight: z.number().int().min(100).max(900),
-	italic: z.boolean(),
-	size: z.number().nonnegative(),
-	color: HexColorSchema,
-	decoration: z.array(z.enum([
-		"underline",
-		"line-through",
-		"word"
-	])),
-	script: z.enum([
-		"normal",
-		"sub",
-		"super"
-	]),
-	letterSpacing: z.number(),
-	horizontalScale: z.number().positive(),
-	unknown: z.string().optional()
-};
-const RichTextParagraphPropsShape = {
-	align: z.enum([
-		"left",
-		"center",
-		"right",
-		"justify"
-	]),
-	dir: z.enum(["ltr", "rtl"]),
-	lineHeight: z.number().positive().optional(),
-	margins: z.object({
-		top: z.number(),
-		bottom: z.number(),
-		left: z.number(),
-		right: z.number()
-	}).optional(),
-	textIndent: z.number().optional(),
-	unknown: z.string().optional()
-};
-const RichTextRunStyleDeltaSchema = z.object(RichTextRunStyleShape).partial();
-const RichTextParagraphSchema = z.object({
-	...RichTextParagraphPropsShape,
-	runs: z.array(z.object({
-		text: z.string(),
-		style: RichTextRunStyleDeltaSchema.optional()
-	}))
-}).partial({
-	align: true,
-	dir: true
-});
-const RichTextDocumentSchema = z.object({
-	body: z.object({
-		...RichTextRunStyleShape,
-		...RichTextParagraphPropsShape
-	}),
-	paragraphs: z.array(RichTextParagraphSchema)
-});
-const RichTextDocumentInputSchema = z.object({
-	body: z.object({
-		...RichTextRunStyleShape,
-		...RichTextParagraphPropsShape
-	}).partial().optional(),
-	paragraphs: z.array(RichTextParagraphSchema)
-});
-const FreeTextDTOSchema = z.object({
-	...AnnotationBaseShape,
-	intent: FreeTextIntentSchema,
-	fontFamily: FreeTextFontSchema,
-	fontSize: z.number().positive(),
-	textAlign: TextAlignmentSchema,
-	richText: RichTextDocumentSchema,
-	color: ColorSchema,
-	fontColor: ColorSchema.optional(),
-	interiorColor: ColorSchema.nullable(),
-	opacity: z.number().min(0).max(1),
-	strokeWidth: z.number().nonnegative(),
-	borderStyle: AnnotationBorderStyleSchema,
-	dashArray: z.array(z.number().nonnegative()).optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable(),
-	calloutLine: CalloutLineSchema.optional(),
-	lineEnding: LineEndingSchema.optional(),
-	rotation: z.number().optional(),
-	unrotatedRect: PdfRectSchema.optional(),
-	subtype: z.literal("free-text")
-});
-const FreeTextDraftSchema = z.object({
-	...AnnotationDraftBaseShape,
-	intent: FreeTextIntentSchema,
-	fontFamily: FreeTextFontSchema,
-	fontSize: z.number().positive(),
-	textAlign: TextAlignmentSchema,
-	richText: RichTextDocumentInputSchema.optional(),
-	rect: PdfRectSchema,
-	color: ColorSchema.optional(),
-	fontColor: ColorSchema.optional(),
-	interiorColor: ColorSchema.nullable().optional(),
-	opacity: z.number().min(0).max(1).optional(),
-	strokeWidth: z.number().nonnegative().optional(),
-	borderStyle: AnnotationBorderStyleSchema.optional(),
-	dashArray: z.array(z.number().nonnegative()).optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	calloutLine: CalloutLineSchema.optional(),
-	lineEnding: LineEndingSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("free-text")
-});
-const FreeTextPatchSchema = z.object({
-	...AnnotationPatchBaseShape,
-	intent: FreeTextIntentSchema.optional(),
-	fontFamily: FreeTextFontSchema.optional(),
-	fontSize: z.number().positive().optional(),
-	textAlign: TextAlignmentSchema.optional(),
-	richText: RichTextDocumentInputSchema.optional(),
-	rect: PdfRectSchema.optional(),
-	color: ColorSchema.optional(),
-	fontColor: ColorSchema.optional(),
-	interiorColor: ColorSchema.nullable().optional(),
-	opacity: z.number().min(0).max(1).optional(),
-	strokeWidth: z.number().nonnegative().optional(),
-	borderStyle: AnnotationBorderStyleSchema.optional(),
-	dashArray: z.array(z.number().nonnegative()).optional(),
-	rectDifferences: PdfRectDifferencesSchema.nullable().optional(),
-	calloutLine: CalloutLineSchema.optional(),
-	lineEnding: LineEndingSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("free-text")
-});
-//#endregion
-//#region src/annotation/kinds/free-text/index.ts
-const FreeTextKind = {
-	subtype: "free-text",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.FREETEXT,
-	dtoSchema: FreeTextDTOSchema,
-	draftSchema: FreeTextDraftSchema,
-	patchSchema: FreeTextPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/text-markup.shared.ts
-const TextMarkupDTOShape = {
-	...AnnotationBaseShape,
-	...ColorStyleDTOShape,
-	quadPoints: z.array(PdfQuadSchema)
-};
-const TextMarkupDraftShape = {
-	...ColorStyleDraftShape,
-	quadPoints: z.array(PdfQuadSchema)
-};
-const TextMarkupPatchShape = {
-	...ColorStylePatchShape,
-	quadPoints: z.array(PdfQuadSchema).optional()
-};
-//#endregion
-//#region src/annotation/kinds/highlight/schema.ts
-const HighlightDTOSchema = z.object({
-	...TextMarkupDTOShape,
-	subtype: z.literal("highlight")
-});
-const HighlightDraftSchema = z.object({
-	...TextMarkupDraftShape,
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("highlight")
-});
-const HighlightPatchSchema = z.object({
-	...TextMarkupPatchShape,
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("highlight")
-});
-//#endregion
-//#region src/annotation/kinds/highlight/index.ts
-const HighlightKind = {
-	subtype: "highlight",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.HIGHLIGHT,
-	dtoSchema: HighlightDTOSchema,
-	draftSchema: HighlightDraftSchema,
-	patchSchema: HighlightPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/ink/schema.ts
-const InkDTOSchema = z.object({
-	...AnnotationBaseShape,
-	...GeometryStyleDTOShape,
-	intent: InkIntentSchema.nullable(),
-	inkList: InkListSchema,
-	rotation: z.number().optional(),
-	subtype: z.literal("ink")
-});
-const InkDraftSchema = z.object({
-	...GeometryStyleDraftShape,
-	...AnnotationDraftBaseShape,
-	intent: InkIntentSchema.optional(),
-	inkList: InkListSchema,
-	rect: PdfRectSchema,
-	rotation: z.number().nullable().optional(),
-	subtype: z.literal("ink")
-});
-const InkPatchSchema = z.object({
-	...GeometryStylePatchShape,
-	...AnnotationPatchBaseShape,
-	intent: InkIntentSchema.optional(),
-	inkList: InkListSchema.optional(),
-	rect: PdfRectSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	subtype: z.literal("ink")
-});
-//#endregion
-//#region src/annotation/kinds/ink/index.ts
-const InkKind = {
-	subtype: "ink",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.INK,
-	dtoSchema: InkDTOSchema,
-	draftSchema: InkDraftSchema,
-	patchSchema: InkPatchSchema
-};
-//#endregion
-//#region src/dto/Measure.schema.ts
-const float = z.number().finite().refine((n) => Number.isFinite(Math.fround(n)), "Outside PDF float range");
-const point = z.object({
-	x: float,
-	y: float
-}).strict();
-const positive = float.refine((n) => Math.fround(n) > 0, "Must be positive in PDF float precision");
-const PdfNumberFormatSchema = z.object({
-	unit: z.string(),
-	conversion: float.optional(),
-	fraction: z.enum([
-		"decimal",
-		"fraction",
-		"round",
-		"truncate"
-	]).optional(),
-	precision: z.number().int().optional(),
-	fixed: z.boolean().optional(),
-	thousands: z.string().optional(),
-	decimal: z.string().optional(),
-	prefixSpacing: z.string().optional(),
-	suffixSpacing: z.string().optional(),
-	labelPosition: z.enum(["suffix", "prefix"]).optional()
-});
-const PdfMeasureSchema = z.object({
-	subtype: z.literal("RL"),
-	ratio: z.string().optional(),
-	x: z.array(PdfNumberFormatSchema),
-	y: z.array(PdfNumberFormatSchema).optional(),
-	distance: z.array(PdfNumberFormatSchema),
-	area: z.array(PdfNumberFormatSchema),
-	angle: z.array(PdfNumberFormatSchema).optional(),
-	slope: z.array(PdfNumberFormatSchema).optional(),
-	origin: point.optional(),
-	cyx: float.optional()
-});
-const writableFormat = PdfNumberFormatSchema.extend({
-	conversion: positive,
-	precision: z.number().int().min(1).max(2147483647).optional()
-}).refine(validNumberFormat, "Invalid number format precision");
-const PdfMeasureWriteSchema = PdfMeasureSchema.extend({
-	x: z.array(writableFormat),
-	y: z.array(writableFormat).optional(),
-	distance: z.array(writableFormat),
-	area: z.array(writableFormat),
-	angle: z.array(writableFormat).optional(),
-	slope: z.array(writableFormat).optional(),
-	cyx: positive.optional()
-});
-const geoMeasure = z.object({ subtype: z.literal("GEO") });
-const unknownMeasure = z.object({ subtype: z.literal("unknown") });
-const PdfForeignMeasureSchema = z.union([geoMeasure, unknownMeasure]);
-const PageScaleInputSchema = z.object({ measure: PdfMeasureWriteSchema.nullable() });
-const PdfMeasurementSchema = z.discriminatedUnion("subtype", [
-	PdfMeasureSchema,
-	geoMeasure,
-	unknownMeasure
-]);
-const PageMeasurementViewportSchema = z.object({
-	bbox: PdfRectSchema,
-	name: z.string().optional(),
-	measure: PdfMeasurementSchema.optional(),
-	owned: z.boolean()
-});
-const LineIntentSchema = z.enum(["LineArrow", "LineDimension"]);
-const PolygonIntentSchema = z.enum(["PolygonCloud", "PolygonDimension"]);
-const PolylineIntentSchema = z.literal("PolyLineDimension");
-const offset = z.object({
-	along: float,
-	perpendicular: float
-}).strict();
-const LineDimensionCaptionSchema = z.object({
-	enabled: z.boolean(),
-	position: z.enum(["inline", "top"]).optional(),
-	offset: offset.optional()
-}).strict();
-const ShapeDimensionCaptionSchema = z.object({
-	enabled: z.boolean(),
-	center: point.optional()
-}).strict();
-const LineCaptionPatchSchema = z.object({
-	enabled: z.boolean().optional(),
-	position: z.enum(["inline", "top"]).nullable().optional(),
-	offset: offset.nullable().optional()
-}).strict();
-const ShapeCaptionPatchSchema = z.object({
-	enabled: z.boolean().optional(),
-	center: point.nullable().optional()
-}).strict();
-const LineLeaderSchema = z.object({
-	length: float,
-	extension: float.refine((n) => n >= 0).optional(),
-	offset: float.refine((n) => n >= 0).optional()
-}).strict();
-//#endregion
-//#region src/annotation/kinds/line/schema.ts
-const LineDTOSchema = z.object({
-	intent: LineIntentSchema.optional(),
-	measure: PdfMeasurementSchema.optional(),
-	caption: LineDimensionCaptionSchema.optional(),
-	leader: LineLeaderSchema.optional(),
-	...AnnotationBaseShape,
-	...FilledStyleDTOShape,
-	linePoints: LinePointsSchema,
-	lineEndings: LineEndingsSchema,
-	rotation: z.number().optional(),
-	subtype: z.literal("line")
-});
-const LineDraftSchema = z.object({
-	intent: LineIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: LineDimensionCaptionSchema.nullable().optional(),
-	leader: LineLeaderSchema.nullable().optional(),
-	...FilledStyleDraftShape,
-	...AnnotationDraftBaseShape,
-	linePoints: LinePointsSchema,
-	rect: PdfRectSchema,
-	lineEndings: LineEndingsSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	subtype: z.literal("line")
-});
-const LinePatchSchema = z.object({
-	intent: LineIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: LineCaptionPatchSchema.nullable().optional(),
-	leader: LineLeaderSchema.nullable().optional(),
-	...FilledStylePatchShape,
-	...AnnotationPatchBaseShape,
-	linePoints: LinePointsSchema.optional(),
-	rect: PdfRectSchema.optional(),
-	lineEndings: LineEndingsSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	subtype: z.literal("line")
-});
-//#endregion
-//#region src/annotation/kinds/line/index.ts
-const LineKind = {
-	subtype: "line",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.LINE,
-	dtoSchema: LineDTOSchema,
-	draftSchema: LineDraftSchema,
-	patchSchema: LinePatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/link/schema.ts
-const GotoTargetSchema = z.object({
-	kind: z.literal("goto"),
-	destination: PdfDestinationSchema
-});
-const UriTargetSchema = z.object({
-	kind: z.literal("uri"),
-	uri: z.string()
-});
-const PdfLinkTargetSchema = z.discriminatedUnion("kind", [
-	GotoTargetSchema,
-	UriTargetSchema,
-	z.object({
-		kind: z.literal("goto-remote"),
-		file: z.string()
-	}),
-	z.object({
-		kind: z.literal("launch"),
-		path: z.string()
-	}),
-	z.object({ kind: z.literal("javascript") }),
-	z.object({
-		kind: z.literal("named"),
-		name: z.string()
-	}),
-	z.object({ kind: z.literal("unsupported") })
-]);
-/** Drafts/patches only author `goto`/`uri` — see {@link PdfLinkTargetWritable}. */
-const PdfLinkTargetWritableSchema = z.discriminatedUnion("kind", [GotoTargetSchema, UriTargetSchema]);
-const LinkDTOSchema = z.object({
-	...AnnotationBaseShape,
-	subtype: z.literal("link"),
-	target: PdfLinkTargetSchema.nullable()
-});
-const LinkDraftSchema = z.object({
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("link"),
-	rect: PdfRectSchema,
-	target: PdfLinkTargetWritableSchema.nullable()
-});
-const LinkPatchSchema = z.object({
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("link"),
-	rect: PdfRectSchema.optional(),
-	target: PdfLinkTargetWritableSchema.nullable().optional()
-});
-//#endregion
-//#region src/annotation/kinds/link/index.ts
-const LinkKind = {
-	subtype: "link",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.LINK,
-	dtoSchema: LinkDTOSchema,
-	draftSchema: LinkDraftSchema,
-	patchSchema: LinkPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/vertex.shared.ts
-const VertexDTOShape = {
-	...AnnotationBaseShape,
-	...FilledStyleDTOShape,
-	vertices: z.array(PdfPointSchema),
-	rotation: z.number().optional()
-};
-const VertexDraftShape = {
-	...FilledStyleDraftShape,
-	vertices: z.array(PdfPointSchema),
-	rect: PdfRectSchema,
-	rotation: z.number().nullable().optional()
-};
-const VertexPatchShape = {
-	...FilledStylePatchShape,
-	vertices: z.array(PdfPointSchema).optional(),
-	rect: PdfRectSchema.optional(),
-	rotation: z.number().nullable().optional()
-};
-//#endregion
-//#region src/annotation/kinds/polygon/schema.ts
-const PolygonDTOSchema = z.object({
-	intent: PolygonIntentSchema.optional(),
-	measure: PdfMeasurementSchema.optional(),
-	caption: ShapeDimensionCaptionSchema.optional(),
-	...VertexDTOShape,
-	vertices: z.array(PdfPointSchema).min(3),
-	cloudyIntensity: z.number().positive().nullable(),
-	subtype: z.literal("polygon")
-});
-const PolygonDraftSchema = z.object({
-	intent: PolygonIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: ShapeDimensionCaptionSchema.nullable().optional(),
-	...VertexDraftShape,
-	...AnnotationDraftBaseShape,
-	vertices: z.array(PdfPointSchema).min(3),
-	cloudyIntensity: z.number().positive().nullable().optional(),
-	subtype: z.literal("polygon")
-});
-const PolygonPatchSchema = z.object({
-	intent: PolygonIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: ShapeCaptionPatchSchema.nullable().optional(),
-	...VertexPatchShape,
-	...AnnotationPatchBaseShape,
-	vertices: z.array(PdfPointSchema).min(3).optional(),
-	cloudyIntensity: z.number().positive().nullable().optional(),
-	subtype: z.literal("polygon")
-});
-//#endregion
-//#region src/annotation/kinds/polygon/index.ts
-const PolygonKind = {
-	subtype: "polygon",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.POLYGON,
-	dtoSchema: PolygonDTOSchema,
-	draftSchema: PolygonDraftSchema,
-	patchSchema: PolygonPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/polyline/schema.ts
-const PolylineDTOSchema = z.object({
-	intent: PolylineIntentSchema.optional(),
-	measure: PdfMeasurementSchema.optional(),
-	caption: ShapeDimensionCaptionSchema.optional(),
-	...VertexDTOShape,
-	vertices: z.array(PdfPointSchema).min(2),
-	lineEndings: LineEndingsSchema,
-	subtype: z.literal("polyline")
-});
-const PolylineDraftSchema = z.object({
-	intent: PolylineIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: ShapeDimensionCaptionSchema.nullable().optional(),
-	...VertexDraftShape,
-	...AnnotationDraftBaseShape,
-	vertices: z.array(PdfPointSchema).min(2),
-	lineEndings: LineEndingsSchema.optional(),
-	subtype: z.literal("polyline")
-});
-const PolylinePatchSchema = z.object({
-	intent: PolylineIntentSchema.nullable().optional(),
-	measure: PdfMeasureWriteSchema.nullable().optional(),
-	caption: ShapeCaptionPatchSchema.nullable().optional(),
-	...VertexPatchShape,
-	...AnnotationPatchBaseShape,
-	vertices: z.array(PdfPointSchema).min(2).optional(),
-	lineEndings: LineEndingsSchema.optional(),
-	subtype: z.literal("polyline")
-});
-//#endregion
-//#region src/annotation/kinds/polyline/index.ts
-const PolylineKind = {
-	subtype: "polyline",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.POLYLINE,
-	dtoSchema: PolylineDTOSchema,
-	draftSchema: PolylineDraftSchema,
-	patchSchema: PolylinePatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/redact/schema.ts
-/** Authoring `fontFamily`: a standard font name OR a registered font `key`.
-*  Any non-empty string is accepted; the writer resolves which it is (and a
-*  key that was never registered fails loud there). The read-back DTO keeps
-*  the narrower {@link StandardFontSchema}. */
-const RedactFontSchema = z.string().min(1);
-/** `/DA` size — unlike free text, `0` is meaningful for a redaction label:
-*  auto-fit to the region. */
-const RedactFontSizeSchema = z.number().nonnegative();
-const RedactDTOSchema = z.object({
-	...AnnotationBaseShape,
-	quadPoints: z.array(PdfQuadSchema),
-	color: ColorSchema,
-	opacity: z.number().min(0).max(1),
-	interiorColor: ColorSchema.nullable(),
-	overlayText: z.string().nullable(),
-	repeat: z.boolean(),
-	fontFamily: StandardFontSchema,
-	fontSize: RedactFontSizeSchema,
-	fontColor: ColorSchema,
-	textAlign: TextAlignmentSchema,
-	subtype: z.literal("redact")
-});
-const RedactDraftSchema = z.object({
-	...AnnotationDraftBaseShape,
-	rect: PdfRectSchema,
-	quadPoints: z.array(PdfQuadSchema).optional(),
-	color: ColorSchema.optional(),
-	opacity: z.number().min(0).max(1).optional(),
-	interiorColor: ColorSchema.nullable().optional(),
-	overlayText: z.string().optional(),
-	repeat: z.boolean().optional(),
-	fontFamily: RedactFontSchema.optional(),
-	fontSize: RedactFontSizeSchema.optional(),
-	fontColor: ColorSchema.optional(),
-	textAlign: TextAlignmentSchema.optional(),
-	subtype: z.literal("redact")
-});
-const RedactPatchSchema = z.object({
-	...AnnotationPatchBaseShape,
-	rect: PdfRectSchema.optional(),
-	quadPoints: z.array(PdfQuadSchema).optional(),
-	color: ColorSchema.optional(),
-	opacity: z.number().min(0).max(1).optional(),
-	interiorColor: ColorSchema.nullable().optional(),
-	overlayText: z.string().nullable().optional(),
-	repeat: z.boolean().optional(),
-	fontFamily: RedactFontSchema.optional(),
-	fontSize: RedactFontSizeSchema.optional(),
-	fontColor: ColorSchema.optional(),
-	textAlign: TextAlignmentSchema.optional(),
-	subtype: z.literal("redact")
-});
-//#endregion
-//#region src/annotation/kinds/redact/index.ts
-const RedactKind = {
-	subtype: "redact",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.REDACT,
-	dtoSchema: RedactDTOSchema,
-	draftSchema: RedactDraftSchema,
-	patchSchema: RedactPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/square/schema.ts
-const SquareDTOSchema = z.object({
-	...ShapeDTOShape,
-	subtype: z.literal("square")
-});
-const SquareDraftSchema = z.object({
-	...ShapeDraftShape,
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("square")
-});
-const SquarePatchSchema = z.object({
-	...ShapePatchShape,
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("square")
-});
-//#endregion
-//#region src/annotation/kinds/square/index.ts
-const SquareKind = {
-	subtype: "square",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.SQUARE,
-	dtoSchema: SquareDTOSchema,
-	draftSchema: SquareDraftSchema,
-	patchSchema: SquarePatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/squiggly/schema.ts
-const SquigglyDTOSchema = z.object({
-	...TextMarkupDTOShape,
-	subtype: z.literal("squiggly")
-});
-const SquigglyDraftSchema = z.object({
-	...TextMarkupDraftShape,
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("squiggly")
-});
-const SquigglyPatchSchema = z.object({
-	...TextMarkupPatchShape,
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("squiggly")
-});
-//#endregion
-//#region src/annotation/kinds/squiggly/index.ts
-const SquigglyKind = {
-	subtype: "squiggly",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.SQUIGGLY,
-	dtoSchema: SquigglyDTOSchema,
-	draftSchema: SquigglyDraftSchema,
-	patchSchema: SquigglyPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/stamp/schema.ts
-/**
-* Schemas validate the WIRE forms. The authoring types (`StampDraft`,
-* `StampPatch`) carry inline `BinarySource` bytes and are normalized to
-* these shapes before validation — see `annotation/normalize.ts`.
-*/
-const ResourceRefSchema = z.object({ resource: z.string().min(1) });
-const StampFitSchema = z.enum([
-	"contain",
-	"cover",
-	"fill"
-]);
-const StampDTOSchema = z.object({
-	...AnnotationBaseShape,
-	name: z.string().nullable(),
-	rotation: z.number().optional(),
-	unrotatedRect: PdfRectSchema.optional(),
-	subtype: z.literal("stamp")
-});
-const StampWireDraftSchema = z.object({
-	...AnnotationDraftBaseShape,
-	rect: PdfRectSchema,
-	source: ResourceRefSchema,
-	name: z.string().min(1).optional(),
-	fit: StampFitSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("stamp")
-});
-const StampWirePatchSchema = z.object({
-	...AnnotationPatchBaseShape,
-	rect: PdfRectSchema.optional(),
-	source: ResourceRefSchema.optional(),
-	name: z.string().min(1).nullable().optional(),
-	fit: StampFitSchema.optional(),
-	rotation: z.number().nullable().optional(),
-	unrotatedRect: PdfRectSchema.nullable().optional(),
-	subtype: z.literal("stamp")
-});
-//#endregion
-//#region src/annotation/kinds/stamp/index.ts
-/**
-* The kind module is WIRE-typed (schemas validate the post-normalization
-* form). The authoring types with inline bytes (`StampDraft`, `StampPatch`)
-* are swapped into the public `AnnotationDraft`/`AnnotationPatch` unions in
-* `kinds/index.ts`; `annotation/normalize.ts` bridges the two.
-*/
-const StampKind = {
-	subtype: "stamp",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.STAMP,
-	dtoSchema: StampDTOSchema,
-	draftSchema: StampWireDraftSchema,
-	patchSchema: StampWirePatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/strikeout/schema.ts
-const StrikeoutDTOSchema = z.object({
-	...TextMarkupDTOShape,
-	intent: StrikeoutIntentSchema.nullable(),
-	subtype: z.literal("strikeout")
-});
-const StrikeoutDraftSchema = z.object({
-	...TextMarkupDraftShape,
-	...AnnotationDraftBaseShape,
-	intent: StrikeoutIntentSchema.optional(),
-	subtype: z.literal("strikeout")
-});
-const StrikeoutPatchSchema = z.object({
-	...TextMarkupPatchShape,
-	...AnnotationPatchBaseShape,
-	intent: StrikeoutIntentSchema.optional(),
-	subtype: z.literal("strikeout")
-});
-//#endregion
-//#region src/annotation/kinds/strikeout/index.ts
-const StrikeoutKind = {
-	subtype: "strikeout",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.STRIKEOUT,
-	dtoSchema: StrikeoutDTOSchema,
-	draftSchema: StrikeoutDraftSchema,
-	patchSchema: StrikeoutPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/text/schema.ts
-const NoteIconSchema = z.enum([
-	"comment",
-	"key",
-	"note",
-	"help",
-	"new-paragraph",
-	"paragraph",
-	"insert"
-]);
-const TextDTOSchema = z.object({
-	...AnnotationBaseShape,
-	...ColorStyleDTOShape,
-	icon: NoteIconSchema,
-	state: z.string().nullable(),
-	stateModel: z.string().nullable(),
-	subtype: z.literal("text")
-});
-const TextDraftSchema = z.object({
-	...ColorStyleDraftShape,
-	...AnnotationDraftBaseShape,
-	rect: PdfRectSchema,
-	icon: NoteIconSchema.optional(),
-	state: z.string().min(1).optional(),
-	stateModel: z.string().min(1).optional(),
-	subtype: z.literal("text")
-});
-const TextPatchSchema = z.object({
-	...ColorStylePatchShape,
-	...AnnotationPatchBaseShape,
-	rect: PdfRectSchema.optional(),
-	icon: NoteIconSchema.optional(),
-	state: z.string().min(1).nullable().optional(),
-	stateModel: z.string().min(1).nullable().optional(),
-	subtype: z.literal("text")
-});
-//#endregion
-//#region src/annotation/kinds/text/index.ts
-const TextKind = {
-	subtype: "text",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.TEXT,
-	dtoSchema: TextDTOSchema,
-	draftSchema: TextDraftSchema,
-	patchSchema: TextPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/underline/schema.ts
-const UnderlineDTOSchema = z.object({
-	...TextMarkupDTOShape,
-	subtype: z.literal("underline")
-});
-const UnderlineDraftSchema = z.object({
-	...TextMarkupDraftShape,
-	...AnnotationDraftBaseShape,
-	subtype: z.literal("underline")
-});
-const UnderlinePatchSchema = z.object({
-	...TextMarkupPatchShape,
-	...AnnotationPatchBaseShape,
-	subtype: z.literal("underline")
-});
-//#endregion
-//#region src/annotation/kinds/underline/index.ts
-const UnderlineKind = {
-	subtype: "underline",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.UNDERLINE,
-	dtoSchema: UnderlineDTOSchema,
-	draftSchema: UnderlineDraftSchema,
-	patchSchema: UnderlinePatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/unsupported/schema.ts
-const UnsupportedDTOSchema = z.object({
-	...AnnotationBaseShape,
-	subtype: z.literal("unsupported"),
-	rawSubtypeCode: z.number().int(),
-	rawSubtypeName: z.string().nullable()
-});
-const UnsupportedDraftSchema = z.never();
-const UnsupportedPatchSchema = z.never();
-//#endregion
-//#region src/annotation/kinds/unsupported/index.ts
-const UnsupportedKind = {
-	subtype: "unsupported",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.UNKNOWN,
-	dtoSchema: UnsupportedDTOSchema,
-	draftSchema: UnsupportedDraftSchema,
-	patchSchema: UnsupportedPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/widget.shared.ts
-const WidgetStyleDTOShape = {
-	color: ColorSchema.nullable(),
-	interiorColor: ColorSchema.nullable(),
-	strokeWidth: z.number().nonnegative(),
-	borderStyle: AnnotationBorderStyleSchema,
-	fontFamily: StandardFontSchema.optional(),
-	fontSize: z.number().nonnegative().optional(),
-	fontColor: ColorSchema.optional(),
-	textAlign: TextAlignmentSchema
-};
-const WidgetStyleDraftShape = {
-	color: ColorSchema.nullable().optional(),
-	interiorColor: ColorSchema.nullable().optional(),
-	strokeWidth: z.number().nonnegative().optional(),
-	borderStyle: AnnotationBorderStyleSchema.optional(),
-	fontFamily: StandardFontSchema.optional(),
-	fontSize: z.number().nonnegative().optional(),
-	fontColor: ColorSchema.optional(),
-	textAlign: TextAlignmentSchema.optional()
-};
-const WidgetStylePatchShape = WidgetStyleDraftShape;
-const WidgetAppearanceSchema = z.object(WidgetStyleDraftShape);
-//#endregion
-//#region src/annotation/kinds/widget/schema.ts
-const WidgetDTOSchema = z.object({
-	...AnnotationBaseShape,
-	...WidgetStyleDTOShape,
-	subtype: z.literal("widget"),
-	fieldObjectNumber: z.number().int().nonnegative(),
-	fieldFamily: z.enum([
-		"text",
-		"checkbox",
-		"radio",
-		"combobox",
-		"listbox",
-		"pushbutton",
-		"signature",
-		"unknown"
-	])
-});
-const WidgetDraftSchema = z.object({
-	...AnnotationDraftBaseShape,
-	...WidgetStyleDraftShape,
-	subtype: z.literal("widget"),
-	rect: PdfRectSchema
-});
-const WidgetPatchSchema = z.object({
-	...AnnotationPatchBaseShape,
-	...WidgetStylePatchShape,
-	subtype: z.literal("widget"),
-	rect: PdfRectSchema.optional()
-});
-//#endregion
-//#region src/annotation/kinds/widget/index.ts
-const WidgetKind = {
-	subtype: "widget",
-	pdfSubtypeCode: PdfAnnotationSubtypeCode.WIDGET,
-	dtoSchema: WidgetDTOSchema,
-	draftSchema: WidgetDraftSchema,
-	patchSchema: WidgetPatchSchema
-};
-//#endregion
-//#region src/annotation/kinds/index.ts
-/**
-* The closed-world catalog of currently-implemented annotation kinds.
-*
-* Adding a new subtype is one folder under `kinds/<name>/` exporting the
-* five files (dto, draft, patch, schema, index) and one entry in this
-* tuple. The discriminated unions and zod discriminator below regenerate
-* automatically; no other file in the package needs to change.
-*
-* Every subtype the engine has not yet wired up rides on
-* `UnsupportedKind`. The wire format is stable: when a per-subtype reader
-* lands later, the engine starts emitting the dedicated DTO instead of
-* `unsupported`, and existing clients widen their handling without a
-* version bump.
-*/
-const ANNOTATION_KINDS = [
-	HighlightKind,
-	UnderlineKind,
-	SquigglyKind,
-	StrikeoutKind,
-	CircleKind,
-	SquareKind,
-	PolygonKind,
-	PolylineKind,
-	LineKind,
-	LinkKind,
-	InkKind,
-	FreeTextKind,
-	CaretKind,
-	TextKind,
-	StampKind,
-	FileAttachmentKind,
-	WidgetKind,
-	RedactKind,
-	UnsupportedKind
-];
-/**
-* Lookup helper for the engine's reader catalog and identity resolver.
-* O(1) by `subtype` literal at runtime.
-*/
-const KIND_BY_SUBTYPE = Object.freeze(Object.fromEntries(ANNOTATION_KINDS.map((kind) => [kind.subtype, kind])));
-/**
-* Runtime zod schema for the discriminated union. The cast unwinds the
-* generic schema map into the specific tuple form `discriminatedUnion`
-* needs. Servers and cloud clients use this to validate every annotation
-* payload on the wire.
-*/
-const AnnotationDTOSchema = z.discriminatedUnion("subtype", [
-	HighlightKind.dtoSchema,
-	UnderlineKind.dtoSchema,
-	SquigglyKind.dtoSchema,
-	StrikeoutKind.dtoSchema,
-	CircleKind.dtoSchema,
-	SquareKind.dtoSchema,
-	PolygonKind.dtoSchema,
-	PolylineKind.dtoSchema,
-	LineKind.dtoSchema,
-	LinkKind.dtoSchema,
-	InkKind.dtoSchema,
-	FreeTextKind.dtoSchema,
-	CaretKind.dtoSchema,
-	TextKind.dtoSchema,
-	StampKind.dtoSchema,
-	FileAttachmentKind.dtoSchema,
-	WidgetKind.dtoSchema,
-	RedactKind.dtoSchema,
-	UnsupportedKind.dtoSchema
-]);
-/**
-* Validates the WIRE draft form (post-normalization) — binary-carrying
-* kinds appear here with `{ resource }` refs, never inline bytes.
-*/
-const AnnotationDraftSchema = z.discriminatedUnion("subtype", [
-	HighlightKind.draftSchema,
-	UnderlineKind.draftSchema,
-	SquigglyKind.draftSchema,
-	StrikeoutKind.draftSchema,
-	CircleKind.draftSchema,
-	SquareKind.draftSchema,
-	PolygonKind.draftSchema,
-	PolylineKind.draftSchema,
-	LineKind.draftSchema,
-	LinkKind.draftSchema,
-	InkKind.draftSchema,
-	FreeTextKind.draftSchema,
-	CaretKind.draftSchema,
-	TextKind.draftSchema,
-	StampKind.draftSchema,
-	FileAttachmentKind.draftSchema,
-	WidgetKind.draftSchema,
-	RedactKind.draftSchema
-]);
-/** Validates the WIRE patch form (post-normalization). */
-const AnnotationPatchSchema = z.discriminatedUnion("subtype", [
-	HighlightKind.patchSchema,
-	UnderlineKind.patchSchema,
-	SquigglyKind.patchSchema,
-	StrikeoutKind.patchSchema,
-	CircleKind.patchSchema,
-	SquareKind.patchSchema,
-	PolygonKind.patchSchema,
-	PolylineKind.patchSchema,
-	LineKind.patchSchema,
-	LinkKind.patchSchema,
-	InkKind.patchSchema,
-	FreeTextKind.patchSchema,
-	CaretKind.patchSchema,
-	TextKind.patchSchema,
-	StampKind.patchSchema,
-	FileAttachmentKind.patchSchema,
-	WidgetKind.patchSchema,
-	RedactKind.patchSchema
-]);
-//#endregion
-//#region src/forms/schema.ts
-const FormFieldRefSchema = z.discriminatedUnion("kind", [z.object({
-	kind: z.literal("objectNumber"),
-	fieldObjectNumber: z.number().int().positive()
-}), z.object({
-	kind: z.literal("fqn"),
-	name: z.string().min(1)
-})]);
-const FormWidgetRefShape = {
-	annotObjectNumber: z.number().int().nonnegative(),
-	pageObjectNumber: z.number().int().nonnegative()
-};
-const FormWidgetRefSchema = z.object(FormWidgetRefShape);
-const FormFieldFlagsSchema = z.object({
-	readOnly: z.boolean(),
-	required: z.boolean(),
-	noExport: z.boolean(),
-	raw: z.number().int().nonnegative()
-});
-const ToggleFieldWidgetSchema = z.object({
-	...FormWidgetRefShape,
-	onState: z.string(),
-	exportValue: z.string(),
-	checked: z.boolean()
-});
-const FormFieldOptionSchema = z.object({
-	label: z.string(),
-	value: z.string(),
-	selected: z.boolean()
-});
-const FormValueEntrySchema = z.discriminatedUnion("kind", [
-	z.object({ kind: z.literal("none") }),
-	z.object({
-		kind: z.literal("scalar"),
-		value: z.string()
-	}),
-	z.object({
-		kind: z.literal("array"),
-		values: z.array(z.string())
-	}),
-	z.object({ kind: z.literal("unsupported") })
-]);
-const FormFieldBaseShape = {
-	ref: FormFieldRefSchema,
-	fieldObjectNumber: z.number().int().nonnegative(),
-	name: z.string(),
-	origin: z.enum(["acroform", "recovered"]),
-	flags: FormFieldFlagsSchema,
-	alternateName: z.string().nullable(),
-	mappingName: z.string().nullable(),
-	valueEntry: FormValueEntrySchema,
-	defaultValueEntry: FormValueEntrySchema,
-	actions: PdfFieldActionsSchema.optional(),
-	widgets: z.array(FormWidgetRefSchema)
-};
-const FormFieldDTOSchema = z.discriminatedUnion("family", [
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("text"),
-		value: z.string(),
-		defaultValue: z.string(),
-		maxLength: z.number().int().positive().nullable(),
-		multiline: z.boolean(),
-		password: z.boolean(),
-		comb: z.boolean()
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("checkbox"),
-		checked: z.boolean(),
-		exportValue: z.string(),
-		widgets: z.array(ToggleFieldWidgetSchema)
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("radio"),
-		value: z.string(),
-		radiosInUnison: z.boolean(),
-		noToggleToOff: z.boolean(),
-		widgets: z.array(ToggleFieldWidgetSchema)
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("combobox"),
-		value: z.string(),
-		defaultValue: z.string(),
-		edit: z.boolean(),
-		options: z.array(FormFieldOptionSchema)
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("listbox"),
-		selectedValues: z.array(z.string()),
-		multiSelect: z.boolean(),
-		options: z.array(FormFieldOptionSchema)
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("pushbutton")
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("signature")
-	}),
-	z.object({
-		...FormFieldBaseShape,
-		family: z.literal("unknown"),
-		rawValue: z.string()
-	})
-]);
-const FormKindSchema = z.enum([
-	"none",
-	"acroform",
-	"xfa"
-]);
-const FormSnapshotSchema = z.object({
-	formKind: FormKindSchema,
-	needsAppearances: z.boolean(),
-	fields: z.array(FormFieldDTOSchema),
-	calculationOrder: z.array(FormFieldRefSchema.nullable())
-});
-const FormFieldValueSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("text"),
-		value: z.string()
-	}),
-	z.object({
-		type: z.literal("toggle"),
-		state: z.string().nullable()
-	}),
-	z.object({
-		type: z.literal("choice"),
-		values: z.array(z.string())
-	})
-]);
-const FormDataFormatSchema = z.enum(["fdf", "xfdf"]);
-const WidgetPlacementSchema = z.object({
-	pageObjectNumber: z.number().int().positive(),
-	rect: PdfRectSchema,
-	onState: z.string().min(1).optional(),
-	appearance: WidgetAppearanceSchema.optional()
-});
-const FormFieldOptionInputSchema = z.object({
-	label: z.string(),
-	value: z.string()
-});
-const FormFieldDraftBaseShape = {
-	name: z.string().min(1),
-	readOnly: z.boolean().optional(),
-	required: z.boolean().optional(),
-	noExport: z.boolean().optional(),
-	alternateName: z.string().optional(),
-	mappingName: z.string().optional()
-};
-const FormFieldDraftSchema = z.discriminatedUnion("family", [
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("text"),
-		defaultValue: z.string().optional(),
-		maxLength: z.number().int().positive().optional(),
-		multiline: z.boolean().optional(),
-		password: z.boolean().optional(),
-		comb: z.boolean().optional(),
-		widget: WidgetPlacementSchema.optional()
-	}),
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("checkbox"),
-		widget: WidgetPlacementSchema.optional()
-	}),
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("radio"),
-		radiosInUnison: z.boolean().optional(),
-		noToggleToOff: z.boolean().optional(),
-		widgets: z.array(WidgetPlacementSchema).optional()
-	}),
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("combobox"),
-		edit: z.boolean().optional(),
-		options: z.array(FormFieldOptionInputSchema).optional(),
-		defaultValue: z.string().optional(),
-		widget: WidgetPlacementSchema.optional()
-	}),
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("listbox"),
-		multiSelect: z.boolean().optional(),
-		options: z.array(FormFieldOptionInputSchema).optional(),
-		widget: WidgetPlacementSchema.optional()
-	}),
-	z.object({
-		...FormFieldDraftBaseShape,
-		family: z.literal("signature"),
-		widget: WidgetPlacementSchema.optional()
-	})
-]);
-const FormFieldPatchBaseShape = {
-	name: z.string().min(1).optional(),
-	readOnly: z.boolean().optional(),
-	required: z.boolean().optional(),
-	noExport: z.boolean().optional(),
-	alternateName: z.string().nullable().optional(),
-	mappingName: z.string().nullable().optional()
-};
-const FormFieldPatchSchema = z.discriminatedUnion("family", [
-	z.object({
-		...FormFieldPatchBaseShape,
-		family: z.literal("text"),
-		defaultValue: z.string().nullable().optional(),
-		maxLength: z.number().int().positive().nullable().optional(),
-		multiline: z.boolean().optional(),
-		password: z.boolean().optional(),
-		comb: z.boolean().optional()
-	}),
-	z.object({
-		...FormFieldPatchBaseShape,
-		family: z.literal("checkbox")
-	}),
-	z.object({
-		...FormFieldPatchBaseShape,
-		family: z.literal("radio"),
-		radiosInUnison: z.boolean().optional(),
-		noToggleToOff: z.boolean().optional()
-	}),
-	z.object({
-		...FormFieldPatchBaseShape,
-		family: z.literal("combobox"),
-		edit: z.boolean().optional(),
-		defaultValue: z.string().nullable().optional(),
-		options: z.array(FormFieldOptionInputSchema).optional()
-	}),
-	z.object({
-		...FormFieldPatchBaseShape,
-		family: z.literal("listbox"),
-		multiSelect: z.boolean().optional(),
-		options: z.array(FormFieldOptionInputSchema).optional()
-	})
-]);
-//#endregion
-//#region src/wire/schemas.ts
-const DocumentMetadataSchema = z.object({
-	title: z.string().nullable(),
-	author: z.string().nullable(),
-	subject: z.string().nullable(),
-	keywords: z.string().nullable(),
-	producer: z.string().nullable(),
-	creator: z.string().nullable(),
-	created: z.string().datetime().nullable(),
-	modified: z.string().datetime().nullable(),
-	trapped: z.enum([
-		"true",
-		"false",
-		"unknown"
-	]),
-	custom: z.record(z.string(), z.string())
-});
-/**
-* Three-state metadata patch. Mirrors annotation patch semantics:
-* `undefined` leaves a field, `null` clears it, a value sets it. `custom`
-* is a per-key three-state map (string set / null clear / absent leave).
-*/
-const MetadataPatchSchema = z.object({
-	title: z.string().nullable().optional(),
-	author: z.string().nullable().optional(),
-	subject: z.string().nullable().optional(),
-	keywords: z.string().nullable().optional(),
-	producer: z.string().nullable().optional(),
-	creator: z.string().nullable().optional(),
-	created: z.string().datetime().nullable().optional(),
-	modified: z.string().datetime().nullable().optional(),
-	trapped: z.enum([
-		"true",
-		"false",
-		"unknown"
-	]).optional(),
-	custom: z.record(z.string(), z.string().nullable()).optional()
-}).strict();
-const OpenDocumentResponseSchema = z.object({ id: z.string() });
-/**
-* Wire shape of `GET /v1/docs/:docId/head`. Mirrors the server-side
-* `DocumentHead` interface; the schema is the source of truth so
-* older SDKs talking to newer servers degrade gracefully (extra
-* fields are accepted and ignored).
-*
-* `docVersion` is the single monotonic integer per doc; it bumps on
-* ANY mutation that could change the manifest's content (page list,
-* per-page content, per-page annotations, per-page weak-flag), which
-* makes `/manifest@docVersion=N` fully content-addressed and cache-friendly.
-* Phase 4 hard-codes it to `1`; Phase 5's mutation handler is what
-* actually bumps it.
-*/
-const DocumentHeadSchema = z.object({
-	id: z.string(),
-	baseSha: z.string(),
-	storageSizeBytes: z.number().int().nonnegative(),
-	docVersion: z.number().int().positive(),
-	state: z.enum([
-		"pending",
-		"ready",
-		"failed",
-		"deleting"
-	]),
-	encryption: z.object({
-		state: z.enum([
-			"unknown",
-			"none",
-			"encrypted",
-			"unsupported"
-		]),
-		requiresPassword: z.boolean().nullable()
-	}),
-	permissions: z.object({
-		known: z.boolean(),
-		bits: z.number().int().nonnegative().nullable(),
-		allAllowed: z.boolean().nullable(),
-		openedAs: z.enum([
-			"none",
-			"user",
-			"owner"
-		]).nullable(),
-		securityHandlerRevision: z.number().int().nullable(),
-		canUpgradeToOwner: z.boolean()
-	}),
-	access: z.object({
-		required: z.boolean(),
-		reasons: z.array(z.enum([
-			"password",
-			"cdn",
-			"permissions-unknown"
-		])),
-		endpoint: z.string().optional()
-	})
-});
-const AccessRequestSchema = z.object({
-	/** 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: z.string().min(1).optional(),
-	layerName: z.string().min(1).optional(),
-	password: z.string().optional(),
-	passwordGrant: z.string().optional(),
-	mode: z.enum(["any", "owner"]).optional()
-});
-/**
-* Typed boolean view of the PDF user-access permission word. Names
-* mirror the `PdfBits` shape in @embedpdf/engine-core/auth/scope; ISO
-* bit numbers (3, 4, 5, 6, 9, 10, 11, 12).
-*/
-const PdfBitsObjectSchema = z.object({
-	bit3: z.boolean(),
-	bit4: z.boolean(),
-	bit5: z.boolean(),
-	bit6: z.boolean(),
-	bit9: z.boolean(),
-	bit10: z.boolean(),
-	bit11: z.boolean(),
-	bit12: z.boolean()
-});
-/**
-* Capability-shaped advisory for the client UI. Mirrors
-* `PdfPermissionAdvisory` in @embedpdf/engine-core/runtime; one
-* boolean per UI badge.
-*/
-const PdfPermissionAdvisoryObjectSchema = z.object({
-	canPrint: z.boolean(),
-	canPrintHigh: z.boolean(),
-	canCopy: z.boolean(),
-	canAnnotate: z.boolean(),
-	canFillForms: z.boolean(),
-	canModifyForms: z.boolean(),
-	canModifyPages: z.boolean(),
-	canAssemble: z.boolean()
-});
-const PdfPermissionInfoSchema = z.object({
-	known: z.boolean(),
-	allAllowed: z.boolean().nullable(),
-	bits: z.number().int().nonnegative().nullable(),
-	openedAs: z.enum([
-		"none",
-		"user",
-		"owner"
-	]).nullable(),
-	securityHandlerRevision: z.number().int().nullable(),
-	flags: PdfBitsObjectSchema.optional(),
-	advisory: PdfPermissionAdvisoryObjectSchema.optional()
-}).nullable();
-const DocumentSecurityStateSchema = z.object({
-	encryption: z.object({
-		state: z.enum([
-			"unknown",
-			"none",
-			"encrypted",
-			"unsupported"
-		]),
-		requiresPassword: z.boolean().nullable()
-	}),
-	permissions: z.object({
-		known: z.boolean(),
-		bits: z.number().int().nonnegative().nullable(),
-		allAllowed: z.boolean().nullable(),
-		openedAs: z.enum([
-			"none",
-			"user",
-			"owner"
-		]).nullable(),
-		securityHandlerRevision: z.number().int().nullable(),
-		canUpgradeToOwner: z.boolean()
-	}),
-	access: z.object({
-		required: z.boolean(),
-		reasons: z.array(z.enum([
-			"password",
-			"cdn",
-			"permissions-unknown"
-		])),
-		endpoint: z.string().optional()
-	})
-});
-const AccessResponseSchema = z.object({
-	security: DocumentSecurityStateSchema,
-	cdn: z.object({
-		adapter: z.enum([
-			"none",
-			"cloudfront",
-			"cloud-cdn",
-			"bunny",
-			"azure-fd",
-			"custom-hmac"
-		]),
-		expiresAt: z.number().int().positive(),
-		cache: z.object({
-			scope: z.enum(["browser-private", "edge-shared"]),
-			immutableVersionedReads: z.boolean()
-		}),
-		baseUrlOverrides: z.record(z.string(), z.string()).nullable(),
-		authHeader: z.object({
-			name: z.string(),
-			value: z.string()
-		}).nullable(),
-		signedQueryParams: z.record(z.string(), z.string()).nullable(),
-		signedCookies: z.array(z.object({
-			name: z.string(),
-			value: z.string(),
-			domain: z.string().optional(),
-			path: z.string().optional(),
-			expires: z.number().int().optional()
-		})).nullable(),
-		signedPathPolicies: z.array(z.object({
-			pathPrefix: z.string(),
-			queryParams: z.record(z.string(), z.string())
-		})).nullable()
-	}),
-	passwordGrant: z.string().nullable(),
-	pdfPermissions: PdfPermissionInfoSchema,
-	scope: z.array(z.string()),
-	/**
-	* Concrete capability set granted to this caller after expanding
-	* `pdf.permissions` and applying resolver implication rules. Client
-	* UI should drive feature visibility off this, not off raw `scope`.
-	* Always present in /access responses (server populates from
-	* `expandRawScope`). Sorted alphabetically for stable change
-	* detection.
-	*/
-	effectiveScope: z.array(z.string()),
-	identity: z.object({
-		user_id: z.string().optional(),
-		group_id: z.string().optional(),
-		groups: z.array(z.string()).optional(),
-		display_name: z.string().optional()
-	}),
-	originPasswordPolicy: z.object({ mode: z.enum([
-		"not-needed",
-		"client-retry",
-		"server-session"
-	]) }),
-	expiresAt: z.number().int().positive(),
-	/**
-	* The deployment's render lattice — the canonical parameter points the
-	* server treats as durable, CDN-shared artifacts. Lives HERE and never in
-	* the manifest: manifests are version-pinned immutable objects; the
-	* lattice is mutable deployment policy. The SDK exposes it (and a pure
-	* `snap` helper) but NEVER conforms requests implicitly — the same render
-	* call must not return different pixels on local vs cloud. When
-	* `enforced` is true the server rejects off-lattice render tokens with
-	* 400; when false, off-lattice renders are computed but not persisted.
-	* Absent on older servers → treat as unenforced/unknown.
-	*/
-	renderPolicy: z.object({
-		/**
-		* Full-page renders quantize on `viewport.width` — the bounded
-		* quantity is OUTPUT PIXELS, never zoom (PDF page space is
-		* effectively unbounded, so a scale lattice bounds artifact count
-		* but not size).
-		*/
-		fullPage: z.object({ widths: z.array(z.number().int().positive()) }),
-		/**
-		* RESERVED for deep-zoom tile support: scale-based pyramid ×
-		* fixed tile size, constant per-job cost. Absent until the tiling
-		* plugin ships.
-		*/
-		tiles: z.object({
-			tileSizes: z.array(z.number().int().positive()),
-			scales: z.array(z.number().positive())
-		}).optional(),
-		/**
-		* Annotation-appearance lattice — SCALE-based (appearances are sized
-		* by `rect × scale` and must track the page's effective render scale
-		* for crisp composites).
-		*/
-		appearances: z.object({ scales: z.array(z.number().positive()) }).optional(),
-		/** Worker-side output budget for degenerate page geometry. */
-		maxRenderPixels: z.number().int().positive().optional(),
-		formats: z.array(z.enum(["webp", "png"])),
-		background: z.enum(["white"]),
-		enforced: z.boolean()
-	}).optional()
-});
-const PdfSaveModeSchema = z.enum(["incremental", "rewrite"]);
-const engineErrorCodeValues = Object.values(EngineErrorCode);
-const EngineErrorPayloadSchema = z.object({
-	name: z.literal("EngineError"),
-	code: z.enum(engineErrorCodeValues),
-	message: z.string(),
-	details: z.record(z.string(), z.unknown()).optional()
-});
-const WeakAnnotationStateSchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("unknown") }), z.object({
-	kind: z.literal("known"),
-	hasAnyWeakAnnotations: z.boolean()
-})]);
-const PageStateSchema = z.object({
-	pageObjectNumber: z.number().int().positive(),
-	revision: RevisionTokenSchema,
-	weakAnnotationState: WeakAnnotationStateSchema
-});
-const CachePinsSchema = z.object({
-	contentVersion: z.number().int().positive(),
-	annotationVersion: z.number().int().positive()
-});
-/**
-* Plane scopes are DERIVED from the version counters at every emission
-* point (layer manifests, mutation cache envelopes, SSE rows), never stored.
-* Additive/optional both ways: old clients ignore it, old servers omit it
-* (consumers treat absence as all-'layer' — never wrong, only unshared).
-*/
-const LayerScopeValueSchema = z.enum(["base", "layer"]);
-const LayerScopesSchema = z.object({
-	content: LayerScopeValueSchema,
-	annotations: LayerScopeValueSchema,
-	layout: LayerScopeValueSchema,
-	attachments: LayerScopeValueSchema,
-	metadata: LayerScopeValueSchema,
-	actions: LayerScopeValueSchema
-});
-/**
-* Per-page envelope inside `DocumentManifest`. Carries the full
-* `PageState` plus the cache-busting integers the SDK embeds in
-* leaf URLs (`/pages/:pon/text@contentVersion=N`, `/pages/:pon/annotations@annotationVersion=N`).
-*
-* `contentVersion` bumps when the page's content stream changes
-* (text, page reorder doesn't, the pon is durable). `annotationVersion`
-* bumps when /Annots gains/loses entries or when a tracked annotation
-* mutates. `hasWeakAnnotations` is hoisted from `PageState` so the
-* SDK can decide whether to display a "stale-on-reorder" badge
-* without re-fetching the page.
-*
-* Phase 4 hard-codes all three to (1, 1, false); Phase 5's
-* `layer_pages` table drives the real values.
-*/
-const ManifestPageSchema = z.object({
-	state: PageStateSchema,
-	cache: CachePinsSchema
-}).superRefine((page, ctx) => {
-	if (page.state.weakAnnotationState.kind !== "known") ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		path: ["state", "weakAnnotationState"],
-		message: "manifest pages must have a known weak annotation state"
-	});
-});
-/**
-* Wire shape of `GET /v1/docs/:docId/manifest@docVersion=N`. Content-addressed
-* by `docVersion`; safe to cache with `Cache-Control: public,
-* max-age=31536000, immutable`.
-*/
-const DocumentManifestSchema = z.object({
-	docVersion: z.number().int().positive(),
-	layoutVersion: z.number().int().positive(),
-	metadataVersion: z.number().int().positive(),
-	actionsVersion: z.number().int().positive().default(1),
-	attachmentsVersion: z.number().int().positive().default(1),
-	annotationsVersion: z.number().int().positive().default(1),
-	auditHead: z.number().int().nonnegative(),
-	baseSha: z.string(),
-	layerVersion: z.number().int().nonnegative().default(0),
-	working: z.boolean().default(false),
-	baseByteLength: z.number().int().nonnegative().default(0),
-	scopes: LayerScopesSchema.optional(),
-	pages: z.array(ManifestPageSchema)
-});
-const AnnotationListPageSnapshotSchema = z.object({
-	pageState: PageStateSchema,
-	annotations: z.array(AnnotationDTOSchema)
-});
-const AnnotationListSnapshotAllPagesSchema = z.object({
-	pages: z.array(AnnotationListPageSnapshotSchema),
-	auditHead: z.number().int().nonnegative().optional()
-});
-/**
-* 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 = z.object({
-	text: z.string(),
-	charCount: z.number().int().nonnegative(),
-	charMap: z.array(z.tuple([z.number().int().nonnegative(), z.number().int().nonnegative()])).optional()
-}).superRefine((snapshot, ctx) => {
-	const violation = charMapViolation(snapshot.charCount, snapshot.text.length, snapshot.charMap);
-	if (violation !== null) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		path: ["charMap"],
-		message: violation
-	});
-});
-const PageGeometryGlyphSchema = z.object({
-	looseBox: PdfRectSchema,
-	flags: z.number().int().nonnegative(),
-	tightBox: PdfRectSchema.optional()
-});
-const RotatedGeometryGlyphSchema = z.object({
-	looseQuad: PdfQuadSchema,
-	flags: z.number().int().nonnegative(),
-	tightQuad: PdfQuadSchema.optional()
-});
-const UprightGeometryRunSchema = z.object({
-	rect: PdfRectSchema,
-	charStart: z.number().int().nonnegative(),
-	glyphs: z.array(PageGeometryGlyphSchema),
-	fontSize: z.number().optional()
-});
-const RotatedGeometryRunSchema = z.object({
-	rect: PdfRectSchema,
-	charStart: z.number().int().nonnegative(),
-	glyphs: z.array(RotatedGeometryGlyphSchema),
-	rotation: z.number(),
-	ascentFlip: z.boolean(),
-	fontSize: z.number().optional()
-});
-const PageGeometryRunSchema = z.union([RotatedGeometryRunSchema, UprightGeometryRunSchema]);
-const PageGeometrySnapshotSchema = z.object({ runs: z.array(PageGeometryRunSchema) });
-/**
-* Search wire shapes: the request body of the layer search route and the
-* `search.query` worker/route result. The server re-validates the query
-* semantics (`validateSearchQuery`: regex dialect + flag combos) after
-* parse — the schema only checks structure.
-*/
-const SearchQuerySchema = z.object({
-	text: z.string(),
-	regex: z.boolean().optional(),
-	matchCase: z.boolean().optional(),
-	wholeWord: z.boolean().optional(),
-	matchDiacritics: z.boolean().optional(),
-	ignoreWhitespace: z.boolean().optional()
-});
-const SearchModeSchema = z.enum(["rects", "full"]);
-const SearchRequestSchema = z.object({
-	query: SearchQuerySchema,
-	mode: SearchModeSchema.optional(),
-	cursor: z.string().optional(),
-	startPage: z.number().int().positive().optional(),
-	skip: z.number().int().nonnegative().optional(),
-	budget: z.object({
-		maxMatches: z.number().int().positive().optional(),
-		maxPages: z.number().int().positive().optional()
-	}).optional()
-});
-const SearchSnippetSchema = z.object({
-	text: z.string(),
-	matchStart: z.number().int().nonnegative(),
-	matchLength: z.number().int().positive()
-});
-const PdfTextSegmentSchema = z.object({
-	quad: PdfQuadSchema,
-	rect: PdfRectSchema,
-	advance: z.union([z.literal(1), z.literal(-1)])
-});
-const SearchMatchSchema = z.object({
-	pageObjectNumber: z.number().int().positive(),
-	charStart: z.number().int().nonnegative(),
-	charCount: z.number().int().positive(),
-	segments: z.array(PdfTextSegmentSchema),
-	snippet: SearchSnippetSchema.optional()
-});
-const SearchSliceSchema = z.object({
-	matches: z.array(SearchMatchSchema),
-	nextCursor: z.string().nullable(),
-	scannedPages: z.number().int().nonnegative(),
-	totalPages: z.number().int().nonnegative()
-});
-const PageNetworkRenderFormatSchema = z.enum(["png", "webp"]);
-/**
-* Wire schema for the cloud render endpoints, applied to the **nested**
-* shape produced by `unflatten(...)` of the parsed token or query string.
-*
-* Adding a new render option is one change here (a new field plus any
-* cross-field rule in `superRefine`) plus one entry in
-* `RenderTokenSchema.fields`. The token codec, flatten/unflatten helpers,
-* route handlers, and SDK URL builder are all generic and pick the new
-* field up automatically.
-*
-* Coercion: token fields and query strings both arrive as strings, so every
-* scalar uses `z.coerce.*`. Discriminated unions on `viewport.kind` and
-* `target.kind` enforce viewport / rect coherence by construction — no
-* superRefine for "fields must appear together" rules.
-*/
-const RenderViewportSchema = z.discriminatedUnion("kind", [z.object({
-	kind: z.literal("width"),
-	width: z.coerce.number().positive().finite()
-}).strict(), z.object({
-	kind: z.literal("scale"),
-	scale: z.coerce.number().positive().finite().optional()
-}).strict()]);
-const RenderTargetSchema = z.discriminatedUnion("kind", [z.object({ kind: z.literal("page") }).strict(), z.object({
-	kind: z.literal("rect"),
-	rect: z.object({
-		left: z.coerce.number().finite(),
-		bottom: z.coerce.number().finite(),
-		right: z.coerce.number().finite(),
-		top: z.coerce.number().finite()
-	}).strict()
-}).strict()]);
-const RenderRotationSchema = z.preprocess((raw) => raw === void 0 ? void 0 : Number(raw), z.number().refine((n) => n === 0 || n === 90 || n === 180 || n === 270, { message: "render rotation must be 0, 90, 180, or 270" }));
-const RenderBackgroundSchema = z.enum(["white", "transparent"]);
-const RenderQualitySchema = z.coerce.number().int().min(1).max(100);
-/**
-* Token/path rule: annotatedness is PATH-expressed —
-* the render FAMILY the route belongs to — never token/query-expressed.
-* Each family therefore gets its own query schema, built from one shared
-* base:
-*
-*   - the annotation-free family (`…/render/pages/`) has NO
-*     `annotationVersion` field at all — `.strict()` rejects it as an
-*     unrecognized key, so the illegal combination is unrepresentable;
-*   - the annotated family (`…/render/annotated/pages/`) REQUIRES
-*     `annotationVersion` on versioned requests — its artifact depends on
-*     the `annotations` plane, so the pin must be in the cache key.
-*
-* Both transforms stamp `includeAnnotations` onto the parsed SDK options
-* from the family, so downstream consumers (worker options, classify) are
-* family-blind.
-*/
-function buildPageRenderQuerySchema(annotated) {
-	return z.object({
-		contentVersion: z.coerce.number().int().positive().optional(),
-		...annotated ? { annotationVersion: z.coerce.number().int().positive().optional() } : {},
-		format: PageNetworkRenderFormatSchema.optional(),
-		viewport: RenderViewportSchema.optional(),
-		target: RenderTargetSchema.optional(),
-		rotation: RenderRotationSchema.optional(),
-		background: RenderBackgroundSchema.optional(),
-		quality: RenderQualitySchema.optional()
-	}).strict().superRefine((v, ctx) => {
-		const pins = v;
-		if (pins.contentVersion !== void 0 && v.format === void 0) ctx.addIssue({
-			code: z.ZodIssueCode.custom,
-			path: ["format"],
-			message: "versioned render requires format"
-		});
-		if (annotated && pins.annotationVersion !== void 0 && pins.contentVersion === void 0) ctx.addIssue({
-			code: z.ZodIssueCode.custom,
-			path: ["annotationVersion"],
-			message: "annotationVersion requires contentVersion"
-		});
-		if (annotated && pins.contentVersion !== void 0 && pins.annotationVersion === void 0) ctx.addIssue({
-			code: z.ZodIssueCode.custom,
-			path: ["annotationVersion"],
-			message: "versioned annotated render requires annotationVersion"
-		});
-	}).transform((v) => {
-		const pins = v;
-		return {
-			options: {
-				...v.target ? { target: v.target } : {},
-				...v.viewport ? { viewport: v.viewport } : {},
-				...v.rotation !== void 0 ? { rotation: v.rotation } : {},
-				...v.background !== void 0 ? { background: v.background } : {},
-				...v.quality !== void 0 ? { quality: v.quality } : {},
-				...v.format !== void 0 ? { format: v.format } : {},
-				includeAnnotations: annotated
-			},
-			...pins.contentVersion !== void 0 ? { contentVersion: pins.contentVersion } : {},
-			...pins.annotationVersion !== void 0 ? { annotationVersion: pins.annotationVersion } : {}
-		};
-	});
-}
-/** Query/token schema for the annotation-free render family (`page-render`). */
-const PageRenderQuerySchema = buildPageRenderQuerySchema(false);
-/** Query/token schema for the annotated render family (`page-render-annotated`). */
-const PageRenderAnnotatedQuerySchema = buildPageRenderQuerySchema(true);
-/**
-* Query/token schema for the batch annotation-appearance render endpoint.
-* Mirrors `PageRenderQuerySchema` but without page target/viewport/background
-* or `includeAnnotations` (appearances are always annotation-derived), and
-* keyed by `annotationVersion` only — appearance bitmaps do not depend on
-* page base content, so `contentVersion` is not part of the cache key. The
-* endpoint renders the Normal appearance only.
-*/
-const AnnotationAppearancesQuerySchema = z.object({
-	annotationVersion: z.coerce.number().int().positive().optional(),
-	format: PageNetworkRenderFormatSchema.optional(),
-	rotation: RenderRotationSchema.optional(),
-	scale: z.coerce.number().positive().finite().optional(),
-	quality: RenderQualitySchema.optional()
-}).strict().superRefine((v, ctx) => {
-	if (v.annotationVersion !== void 0 && v.format === void 0) ctx.addIssue({
-		code: z.ZodIssueCode.custom,
-		path: ["format"],
-		message: "versioned appearance render requires format"
-	});
-}).transform((v) => {
-	return {
-		options: {
-			...v.rotation !== void 0 ? { rotation: v.rotation } : {},
-			...v.scale !== void 0 ? { scale: v.scale } : {},
-			...v.quality !== void 0 ? { quality: v.quality } : {},
-			...v.format !== void 0 ? { format: v.format } : {}
-		},
-		...v.annotationVersion !== void 0 ? { annotationVersion: v.annotationVersion } : {}
-	};
-});
-/**
-* The JSON manifest part of the appearance `multipart/form-data` response.
-* Wire-stable; the cloud client validates the parsed `manifest` part against
-* this before reconstructing image handles from the binary parts.
-*/
-const AnnotationAppearanceManifestSchema = z.object({
-	pageState: PageStateSchema,
-	appearances: z.array(z.object({
-		part: z.string().min(1),
-		ref: AnnotationRefSchema,
-		mode: z.enum([
-			"normal",
-			"rollover",
-			"down"
-		]),
-		rect: PdfRectSchema,
-		width: z.number().int().positive(),
-		height: z.number().int().positive(),
-		format: PageNetworkRenderFormatSchema,
-		contentType: z.string().min(1)
-	}))
-});
-/**
-* Reasons a mutation tells the client its old snapshot is stale. Wire-stable;
-* extend with care (forward-compat clients accept only known values).
-*/
-const RefetchReasonSchema = z.enum([
-	"weakRefsInvalidated",
-	"externalChange",
-	"pageRebuilt"
-]);
-const CacheDeltaSchema = z.object({
-	previousDocVersion: z.number().int().positive(),
-	docVersion: z.number().int().positive(),
-	annotationsVersion: z.number().int().positive().optional(),
-	layerVersion: z.number().int().nonnegative().optional(),
-	working: z.boolean().optional(),
-	pages: z.array(z.object({
-		pageObjectNumber: z.number().int().positive(),
-		cache: CachePinsSchema
-	}))
-});
-const MutationMetaSchema = z.object({
-	affectedPages: z.array(PageStateSchema),
-	cacheDelta: CacheDeltaSchema.nullable()
-});
-/**
-* Per-page side-effect envelope every annotation mutation returns. Mirrors
-* `AnnotationListMutationMeta`. The `shouldRefetch` field is `null` when the
-* client's existing index-based references remain valid; non-null only when
-* the engine knows for sure the snapshot is stale.
-*/
-const AnnotationListMutationMetaSchema = z.object({
-	affectedPages: z.array(PageStateSchema),
-	cacheDelta: CacheDeltaSchema.nullable(),
-	changed: z.array(AnnotationStableIdSchema),
-	weakRefsInvalidated: z.boolean(),
-	shouldRefetch: z.object({ reason: RefetchReasonSchema }).nullable()
-});
-const AnnotationCreateResultSchema = z.object({
-	created: AnnotationDTOSchema,
-	meta: AnnotationListMutationMetaSchema
-});
-/** The engine's `/AP` verdict riding every update result (see engine-core
-*  `annotation/appearance.ts`). `changed` drives client raster invalidation. */
-const AppearanceOutcomeSchema = z.object({
-	action: z.enum([
-		"preserved",
-		"regenerated",
-		"generation-unavailable"
-	]),
-	changed: z.boolean()
-});
-const AnnotationUpdateResultSchema = z.object({
-	updated: AnnotationDTOSchema,
-	appearance: AppearanceOutcomeSchema,
-	meta: AnnotationListMutationMetaSchema
-});
-/**
-* `deleted` is nullable: a weak annotation (no /NM, no indirect object
-* number) has no durable id to report after removal. Cloud server and local
-* worker both emit `null` in that case so callers don't have to special-case
-* a sentinel.
-*/
-const AnnotationDeleteResultSchema = z.object({
-	deleted: AnnotationStableIdSchema.nullable(),
-	meta: AnnotationListMutationMetaSchema
-});
-/**
-* Batch annotation move (contiguous-block, symmetric with `pages.move`).
-* `moved` is in caller order; each `moved[i]` lives at index `toIndex + i`
-* after the move. ONE structural envelope per batch.
-*/
-const AnnotationMoveResultSchema = z.object({
-	moved: z.array(AnnotationDTOSchema),
-	meta: AnnotationListMutationMetaSchema
-});
-const FormSetValueResultSchema = z.object({
-	field: FormFieldDTOSchema,
-	changedWidgets: z.array(FormWidgetRefSchema),
-	meta: MutationMetaSchema
-});
-const FormEffectSchema = z.discriminatedUnion("kind", [
-	z.object({
-		kind: z.literal("setValue"),
-		ref: FormFieldRefSchema,
-		value: FormFieldValueSchema
-	}),
-	z.object({
-		kind: z.literal("setDisplay"),
-		ref: FormFieldRefSchema,
-		display: z.enum([
-			"visible",
-			"hidden",
-			"noPrint",
-			"noView"
-		])
-	}),
-	z.object({
-		kind: z.literal("setAppearanceText"),
-		ref: FormFieldRefSchema,
-		text: z.string()
-	}),
-	z.object({
-		kind: z.literal("reset"),
-		refs: z.array(FormFieldRefSchema)
-	})
-]);
-const FormEffectsResultSchema = z.object({
-	results: z.array(z.object({
-		index: z.number().int().nonnegative(),
-		status: z.enum([
-			"applied",
-			"unchanged",
-			"rejected",
-			"failed",
-			"skipped"
-		]),
-		fields: z.array(FormFieldDTOSchema),
-		changedWidgets: z.array(FormWidgetRefSchema),
-		error: EngineErrorPayloadSchema.optional()
-	})),
-	changedWidgets: z.array(FormWidgetRefSchema),
-	meta: MutationMetaSchema.nullable()
-});
-const FormImportResultSchema = z.object({
-	fieldsTotal: z.number().int().nonnegative(),
-	fieldsApplied: z.number().int().nonnegative(),
-	fieldsSkipped: z.number().int().nonnegative(),
-	widgetsChanged: z.number().int().nonnegative(),
-	snapshot: FormSnapshotSchema,
-	meta: MutationMetaSchema
-});
-const FormFieldCreateResultSchema = z.object({
-	field: FormFieldDTOSchema,
-	meta: MutationMetaSchema
-});
-const FormFieldUpdateResultSchema = z.object({
-	field: FormFieldDTOSchema,
-	meta: MutationMetaSchema
-});
-const FormFieldDeleteResultSchema = z.object({
-	deletedFieldObjectNumber: z.number().int().positive(),
-	removedWidgets: z.array(FormWidgetRefSchema),
-	meta: MutationMetaSchema
-});
-const FormWidgetLinkResultSchema = z.object({
-	field: FormFieldDTOSchema,
-	meta: MutationMetaSchema
-});
-const FormRepairResultSchema = z.object({
-	acroformCreated: z.boolean(),
-	fieldsLinked: z.number().int().nonnegative(),
-	widgetsLinked: z.number().int().nonnegative(),
-	fieldsUnrepairable: z.number().int().nonnegative(),
-	appearancesBaked: z.number().int().nonnegative(),
-	needAppearancesCleared: z.boolean(),
-	meta: MutationMetaSchema
-});
-const PageBoxesSchema = z.object({
-	media: PdfRectSchema,
-	crop: PdfRectSchema,
-	bleed: PdfRectSchema.optional(),
-	trim: PdfRectSchema.optional(),
-	art: PdfRectSchema.optional()
-});
-/**
-* Pure geometry for one page (`pages.list()` element). No annotation
-* liveness — that lives on annotation reads and the manifest.
-*/
-const PageLayoutSchema = z.object({
-	index: z.number().int().nonnegative(),
-	pageObjectNumber: z.number().int().positive(),
-	label: z.string().nullable(),
-	size: PdfSizeSchema,
-	rotation: PdfRotationSchema,
-	userUnit: z.number().positive(),
-	boxes: PageBoxesSchema,
-	actions: PdfPageActionsSchema.optional()
-});
-const PageFlattenResultSchema = z.object({
-	pageObjectNumbers: z.array(z.number().int().positive()),
-	usage: z.enum(["display", "print"]),
-	results: z.array(z.object({
-		pageObjectNumber: z.number().int().positive(),
-		status: z.enum([
-			"applied",
-			"unchanged",
-			"failed",
-			"skipped"
-		]),
-		error: EngineErrorPayloadSchema.optional()
-	})),
-	meta: MutationMetaSchema.nullable()
-});
-/** See `AnnotationFlattenResult`. */
-const AnnotationFlattenResultSchema = z.object({
-	pageObjectNumber: z.number().int().positive(),
-	usage: z.enum(["display", "print"]),
-	results: z.array(z.object({
-		ref: AnnotationRefSchema,
-		status: z.enum(["applied", "skipped"])
-	})),
-	meta: MutationMetaSchema.nullable()
-});
-/** `annotations.flatten` input — see `AnnotationFlattenInput`. */
-const AnnotationFlattenInputSchema = z.object({
-	refs: z.array(AnnotationRefSchema).min(1),
-	usage: z.enum(["display", "print"])
-});
-/** `annotations.exportAppearance` input — see `AnnotationAppearanceExportInput`. */
-const AnnotationAppearanceExportInputSchema = z.object({ refs: z.array(AnnotationRefSchema).min(1) });
-const PageFlattenInputSchema = z.object({
-	pageObjectNumbers: z.array(z.number().int().positive()),
-	usage: z.enum(["display", "print"])
-});
-const RedactionApplyScopeSchema = z.discriminatedUnion("kind", [z.object({
-	kind: z.literal("pages"),
-	pageObjectNumbers: z.array(z.number().int().positive())
-}), z.object({
-	kind: z.literal("annotations"),
-	refs: z.array(AnnotationRefSchema)
-})]);
-const RedactionApplyResultSchema = z.object({
-	scope: RedactionApplyScopeSchema,
-	results: z.array(z.object({
-		pageObjectNumber: z.number().int().positive(),
-		status: z.enum([
-			"applied",
-			"unchanged",
-			"failed",
-			"skipped"
-		]),
-		removedAnnotationCount: z.number().int().nonnegative(),
-		error: EngineErrorPayloadSchema.optional()
-	})),
-	removedAnnotationCount: z.number().int().nonnegative(),
-	meta: MutationMetaSchema.nullable()
-});
-/**
-* Snapshot of every page in display order. Pages are addressed by
-* `pageObjectNumber` everywhere except the per-element `index`, which is
-* display order and intentionally not an identity. Carries geometry only.
-*/
-/** See `NamedPageEntry`: decoded key + what it resolves to. */
-const NamedPageEntrySchema = z.object({
-	name: z.string(),
-	target: z.discriminatedUnion("kind", [
-		z.object({
-			kind: z.literal("page"),
-			pageObjectNumber: z.number().int().positive()
-		}),
-		z.object({
-			kind: z.literal("template"),
-			objectNumber: z.number().int().positive()
-		}),
-		z.object({ kind: z.literal("dangling") })
-	])
-});
-const PageListSnapshotSchema = z.object({
-	pageCount: z.number().int().nonnegative(),
-	pages: z.array(PageLayoutSchema),
-	namedPages: z.array(NamedPageEntrySchema).optional()
-});
-/** `pages.setName` input — see `PageNameInput`. */
-const PageNameInputSchema = z.object({
-	name: z.string().min(1),
-	pageObjectNumber: z.number().int().positive(),
-	replace: z.string().min(1).optional()
-});
-/** `pages.removeName` input — see `PageRemoveNameInput`. */
-const PageRemoveNameInputSchema = z.object({ name: z.string().min(1) });
-/**
-* Page reorder input. Pages are always addressed by `pageObjectNumber`;
-* `destIndex` is the insertion point in the post-removal index space.
-*/
-const PageMoveInputSchema = z.object({
-	pageObjectNumbers: z.array(z.number().int().positive()),
-	destIndex: z.number().int().nonnegative()
-});
-/**
-* Coherence pins shared by every page-STRUCTURE result (move/rotate/delete) —
-* see `PageStructureCache`. Nullable at each use site (local engines).
-*/
-const PageStructureCacheSchema = z.object({
-	previousDocVersion: z.number().int().nonnegative(),
-	docVersion: z.number().int().positive(),
-	layoutVersion: z.number().int().positive()
-});
-/**
-* Page reorder result. No revision is bumped (no doc-level revision exists,
-* and per-page revisions intentionally survive a page reorder). The full
-* post-move order is returned so callers can swap their snapshot directly.
-*/
-const PageMoveResultSchema = z.object({
-	layout: PageListSnapshotSchema,
-	cache: PageStructureCacheSchema.nullable()
-});
-/** Named-page mutation result — layout-shaped, see `PageNameResult`. */
-const PageNameResultSchema = z.object({
-	layout: PageListSnapshotSchema,
-	cache: PageStructureCacheSchema.nullable()
-});
-/**
-* Page rotate input. ABSOLUTE rotation (idempotent — see `PageRotateInput`),
-* one value applied to every listed page.
-*/
-const PageRotateInputSchema = z.object({
-	pageObjectNumbers: z.array(z.number().int().positive()),
-	rotation: PdfRotationSchema
-});
-/**
-* Page rotate result. Rotation is presentation metadata over normalized
-* content: nothing per-page invalidates; the new `layout` carries the
-* rotation values (see `PageRotateResult`).
-*/
-const PageRotateResultSchema = z.object({
-	layout: PageListSnapshotSchema,
-	cache: PageStructureCacheSchema.nullable()
-});
-/** Page delete input. Deleting every page is rejected server/worker-side. */
-const PageDeleteInputSchema = z.object({ pageObjectNumbers: z.array(z.number().int().positive()) });
-/**
-* Page delete result. Deleted PONs are retired (never recycled); surviving
-* pages keep identity + revisions (see `PageDeleteResult`).
-*/
-const PageDeleteResultSchema = z.object({
-	layout: PageListSnapshotSchema,
-	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 = z.object({ destIndex: 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 = z.object({
-	size: z.object({
-		width: z.number().positive().finite(),
-		height: z.number().positive().finite()
-	}),
-	count: z.number().int().min(1).max(100).optional(),
-	destIndex: z.number().int().nonnegative().optional()
-});
-/** Page extract input: the pages to export, in the order they should appear. */
-const PageExtractInputSchema = z.object({ pageObjectNumbers: z.array(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 = z.object({
-	insertedPageObjectNumbers: z.array(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`
-* and `metadataVersion`. `cache` is `null` for local engines.
-*/
-const AttachmentsCacheSchema = z.object({
-	previousDocVersion: z.number().int().nonnegative(),
-	docVersion: z.number().int().positive(),
-	attachmentsVersion: z.number().int().positive()
-});
-const AttachmentCreateResultSchema = z.object({
-	created: EmbeddedFileItemSchema,
-	cache: AttachmentsCacheSchema.nullable()
-});
-const AttachmentDeleteResultSchema = z.object({
-	deleted: EmbeddedFileRefSchema,
-	cache: AttachmentsCacheSchema.nullable()
-});
-const MetadataUpdateResultSchema = z.object({
-	metadata: DocumentMetadataSchema,
-	cache: z.object({
-		previousDocVersion: z.number().int().nonnegative(),
-		docVersion: z.number().int().positive(),
-		metadataVersion: z.number().int().positive()
-	}).nullable()
-});
-const WeakAnnotationSessionResponseSchema = z.object({
-	sessionId: z.string().min(1),
-	expiresAt: z.number().int().positive(),
-	heartbeatIntervalMs: z.number().int().positive(),
-	pageObjectNumbers: z.array(z.number().int().positive())
-});
-const WeakAnnotationSessionPagesRequestSchema = z.object({ pageObjectNumbers: z.array(z.number().int().positive()).transform((pages) => [...new Set(pages)]) });
-const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-/** Standard base64 (padded). Dependency-free: no Buffer, runs in browsers too. */
-function toBase64(bytes) {
-	let out = "";
-	for (let i = 0; i < bytes.length; i += 3) {
-		const b0 = bytes[i];
-		const b1 = bytes[i + 1];
-		const b2 = bytes[i + 2];
-		out += BASE64_ALPHABET[b0 >> 2];
-		out += BASE64_ALPHABET[(b0 & 3) << 4 | (b1 ?? 0) >> 4];
-		out += b1 === void 0 ? "=" : BASE64_ALPHABET[(b1 & 15) << 2 | (b2 ?? 0) >> 6];
-		out += b2 === void 0 ? "=" : BASE64_ALPHABET[b2 & 63];
-	}
-	return out;
-}
-function fromBase64(encoded) {
-	let end = encoded.length;
-	while (end > 0 && encoded[end - 1] === "=") end -= 1;
-	const clean = encoded.slice(0, end);
-	if (clean.length % 4 === 1 || /[^A-Za-z0-9+/]/.test(clean)) throw new Error("malformed base64");
-	const bytes = [];
-	let buffer = 0;
-	let bits = 0;
-	for (const ch of clean) {
-		buffer = buffer << 6 | BASE64_ALPHABET.indexOf(ch);
-		bits += 6;
-		if (bits >= 8) {
-			bits -= 8;
-			bytes.push(buffer >> bits & 255);
-		}
-	}
-	return Uint8Array.from(bytes);
-}
-const Base64Schema = z.string().regex(/^[A-Za-z0-9+/]*={0,2}$/, "base64");
-const DocumentVersionRefSchema = z.object({
-	baseSha256: z.string().regex(/^[0-9a-f]{64}$/),
-	editsVersion: z.number().int().nonnegative()
-});
-const ByteRangeSchema = z.tuple([
-	z.number().int().nonnegative(),
-	z.number().int().nonnegative(),
-	z.number().int().nonnegative(),
-	z.number().int().nonnegative()
-]);
-/** `SignaturePrepared` with the digest as base64. */
-const SignaturePreparedWireSchema = z.object({
-	signingId: z.string().min(1),
-	digest: Base64Schema,
-	algorithm: z.enum([
-		"sha256",
-		"sha384",
-		"sha512"
-	]),
-	byteRange: ByteRangeSchema,
-	contentsSize: z.number().int().positive(),
-	subFilter: z.string(),
-	expectedVersion: DocumentVersionRefSchema,
-	expiresAt: z.string().nullable()
-});
-function encodePrepared(prepared) {
-	return {
-		...prepared,
-		digest: toBase64(prepared.digest)
-	};
-}
-function decodePrepared(wire) {
-	return {
-		...wire,
-		digest: fromBase64(wire.digest),
-		subFilter: wire.subFilter
-	};
-}
-/** The JSON body of a completion: the CMS as base64 beside the fence. */
-const SignatureCompleteBodySchema = z.object({
-	cms: Base64Schema.refine((v) => v.length > 0, "cms is required"),
-	expectedVersion: DocumentVersionRefSchema
-});
-const DocMdpPermissionSchema = z.union([
-	z.literal(1),
-	z.literal(2),
-	z.literal(3)
-]);
-const ModificationLevelSchema = z.enum([
-	"none",
-	"lta",
-	"fill",
-	"annotate"
-]);
-const DigestAlgorithmSchema = z.enum([
-	"sha1",
-	"sha256",
-	"sha384",
-	"sha512"
-]);
-const FieldLockSpecSchema = z.object({
-	action: z.enum([
-		"all",
-		"include",
-		"exclude"
-	]),
-	fields: z.array(z.string()),
-	permission: DocMdpPermissionSchema.optional()
-});
-const SignatureSeedValueSchema = z.object({
-	requiredFlags: z.number().int(),
-	presentFlags: z.number().int(),
-	version: z.number().int().nullable(),
-	mdp: z.union([
-		z.literal(0),
-		z.literal(1),
-		z.literal(2),
-		z.literal(3)
-	]).nullable(),
-	filter: z.string().nullable(),
-	subFilters: z.array(z.string()),
-	digestMethods: z.array(z.string()),
-	reasons: z.array(z.string()),
-	unsupportedRequired: z.boolean()
-});
-const SignatureDTOSchema = z.object({
-	index: z.number().int().nonnegative(),
-	field: FormFieldRefSchema,
-	fieldName: z.string(),
-	widget: FormWidgetRefSchema.nullable(),
-	signed: z.boolean(),
-	kind: z.enum(["signature", "timestamp"]),
-	filter: z.string().nullable(),
-	subFilter: z.string().nullable(),
-	byteRange: ByteRangeSchema.nullable(),
-	contentsSize: z.number().int().nonnegative(),
-	coverage: z.enum([
-		"whole-revision",
-		"partial",
-		"malformed"
-	]).nullable(),
-	revisionIndex: z.number().int().nonnegative().nullable(),
-	signer: z.object({
-		name: z.string().nullable(),
-		reason: z.string().nullable(),
-		location: z.string().nullable(),
-		contactInfo: z.string().nullable(),
-		claimedTime: z.string().nullable()
-	}),
-	docMdp: DocMdpPermissionSchema.nullable(),
-	catalogCertification: z.boolean(),
-	fieldMdp: FieldLockSpecSchema.nullable(),
-	lock: FieldLockSpecSchema.nullable(),
-	seedValue: SignatureSeedValueSchema.nullable()
-});
-const DocumentProtectionSchema = z.object({
-	enforced: ModificationLevelSchema.nullable(),
-	judged: ModificationLevelSchema.nullable(),
-	certification: z.object({
-		signatureIndex: z.number().int().nonnegative(),
-		permission: DocMdpPermissionSchema
-	}).nullable(),
-	fieldLocks: z.array(z.object({
-		signatureIndex: z.number().int().nonnegative(),
-		source: z.enum(["fieldmdp", "lock"]),
-		spec: FieldLockSpecSchema
-	})),
-	policyVersion: z.number().int()
-});
-const PdfRevisionSchema = z.object({
-	index: z.number().int().nonnegative(),
-	end: z.number().int().nonnegative(),
-	xrefOffset: z.number().int().nonnegative(),
-	signatureIndex: z.number().int().nonnegative().nullable()
-});
-const SignatureSnapshotSchema = z.object({
-	chainValid: z.boolean(),
-	revisions: z.array(PdfRevisionSchema),
-	signatures: z.array(SignatureDTOSchema),
-	protection: DocumentProtectionSchema
-});
-const BaseVersionInfoSchema = z.object({
-	sha256: z.string().regex(/^[0-9a-f]{64}$/),
-	byteLength: z.number().int().nonnegative()
-});
-const SignatureCompleteResultSchema = z.object({
-	status: z.enum(["completed", "already-completed"]),
-	signature: SignatureDTOSchema,
-	version: BaseVersionInfoSchema,
-	previous: DocumentVersionRefSchema,
-	protection: DocumentProtectionSchema,
-	meta: MutationMetaSchema
-});
-const SignatureAbortResultSchema = z.object({ status: z.enum([
-	"aborted",
-	"already-completed",
-	"unknown"
-]) });
-const ChangeFindingSchema = z.object({
-	rule: z.string(),
-	verdict: z.enum([
-		"permitted",
-		"forbidden",
-		"incomplete"
-	]),
-	objectNumber: z.number().int().nonnegative(),
-	edge: z.string().optional(),
-	detail: z.string().optional()
-});
-const AnalysisDetailSchema = z.enum(["summary", "full"]);
-/** The analysis: one verdict (`current`) with its findings, the restrictions it was judged under, and facts about the revisions in between. */
-const ChangeAnalysisSchema = z.object({
-	mode: z.enum(["authoritative", "exploratory"]),
-	policyVersion: z.number().int(),
-	basis: z.object({
-		version: BaseVersionInfoSchema,
-		editsVersion: z.number().int().nonnegative(),
-		source: z.enum(["persisted", "working-copy"])
-	}),
-	since: z.object({
-		revisionIndex: z.number().int().nonnegative(),
-		signatureIndex: z.number().int().nonnegative().nullable()
-	}),
-	until: z.object({ revisionIndex: z.number().int().nonnegative() }),
-	restrictions: z.array(z.object({
-		signatureIndex: z.number().int().nonnegative(),
-		revisionIndex: z.number().int().nonnegative(),
-		source: z.enum([
-			"docmdp",
-			"fieldmdp",
-			"lock"
-		]),
-		own: z.boolean(),
-		permission: z.union([
-			z.literal(1),
-			z.literal(2),
-			z.literal(3)
-		]).optional(),
-		fields: z.unknown().optional()
-	})),
-	current: z.object({
-		verdict: z.enum([
-			"unchanged",
-			"permitted",
-			"forbidden",
-			"indeterminate"
-		]),
-		complete: z.boolean(),
-		primary: ChangeFindingSchema.optional(),
-		findings: z.array(ChangeFindingSchema),
-		method: z.enum(["net-state", "net-state+replay"])
-	}),
-	later: z.object({
-		revisionCount: z.number().int().nonnegative(),
-		undoneObjectNumbers: z.array(z.number().int().nonnegative())
-	}),
-	/** Equals `current.verdict`. */
-	verdict: z.enum([
-		"unchanged",
-		"permitted",
-		"forbidden",
-		"indeterminate"
-	]),
-	/** The step DTOs are large and evolving; carried verbatim. */
-	steps: z.array(z.unknown())
-});
-const SignatureAttributionSchema = z.object({
-	name: z.string().optional(),
-	reason: z.string().optional(),
-	location: z.string().optional(),
-	contactInfo: z.string().optional()
-});
-/** The JSON part of a visual signature fill (multipart envelope): which resource part holds the PDF, and its page. */
-const SignatureAppearanceBodySchema = z.object({
-	resource: z.string().min(1),
-	pageIndex: z.number().int().nonnegative().optional()
-});
-/**
-* The JSON part of a prepare (multipart envelope): `SignaturePrepareInput`
-* with the appearance artwork referenced by its resource part instead of
-* inline bytes.
-*/
-const SignaturePrepareBodySchema = z.object({
-	field: FormFieldRefSchema,
-	kind: z.enum(["signature", "timestamp"]).optional(),
-	subFilter: z.enum(["adbe.pkcs7.detached", "ETSI.CAdES.detached"]).optional(),
-	digest: z.enum([
-		"sha256",
-		"sha384",
-		"sha512"
-	]).optional(),
-	contentsSize: z.number().int().positive().optional(),
-	attribution: SignatureAttributionSchema.optional(),
-	/** @deprecated the pre-rename spelling of `attribution`; servers read either. */
-	signer: SignatureAttributionSchema.optional(),
-	signingTime: z.string().optional(),
-	certify: z.object({ permission: DocMdpPermissionSchema }).optional(),
-	lock: FieldLockSpecSchema.optional(),
-	appearance: z.object({
-		resource: z.string().min(1),
-		pageIndex: z.number().int().nonnegative().optional()
-	}).optional()
-});
-const optionalIndex = z.coerce.number().int().nonnegative().optional();
-/** Layer analysis query (the current form): exactly one `since.*`; the working copy is the end. */
-const LayerAnalysisQuerySchema = z.object({
-	"since.signature": optionalIndex,
-	"since.revision": optionalIndex,
-	level: ModificationLevelSchema.optional(),
-	detail: AnalysisDetailSchema.optional()
-}).refine((q) => q["since.signature"] === void 0 !== (q["since.revision"] === void 0), { message: "exactly one of since.signature / since.revision is required" });
-/** Version analysis query: as the layer's, plus `until` (a revision index; default the last). */
-const VersionAnalysisQuerySchema = z.object({
-	"since.signature": optionalIndex,
-	"since.revision": optionalIndex,
-	until: optionalIndex,
-	level: ModificationLevelSchema.optional(),
-	detail: AnalysisDetailSchema.optional(),
-	/** The judging policy version the caller expects — a cache key, not an input (version responses are immutable). */
-	policy: optionalIndex
-}).refine((q) => q["since.signature"] === void 0 !== (q["since.revision"] === void 0), { message: "exactly one of since.signature / since.revision is required" });
-function analyzeInputFromQuery(query, until) {
-	return {
-		since: query["since.signature"] !== void 0 ? { signatureIndex: query["since.signature"] } : { revisionIndex: query["since.revision"] ?? 0 },
-		...until !== void 0 ? { until } : {},
-		...query.level !== void 0 ? { exploratoryLevel: query.level } : {},
-		...query.detail !== void 0 ? { detail: query.detail } : {}
-	};
-}
-/** One row of the document's version catalog. */
-const DocumentVersionSchema = z.object({
-	sha256: z.string().regex(/^[0-9a-f]{64}$/),
-	byteLength: z.number().int().nonnegative(),
-	number: z.number().int().positive(),
-	parentSha256: z.string().nullable(),
-	producer: z.enum(["upload", "signature"]),
-	signingId: z.string().nullable(),
-	createdAt: z.number().int()
-});
-const DocumentVersionsSchema = z.object({
-	/** `documents.base_sha`: the version every layer is over, or behind. */
-	head: z.string().regex(/^[0-9a-f]{64}$/),
-	/** Oldest first. */
-	versions: z.array(DocumentVersionSchema)
-});
-const PageScaleResultSchema = z.object({
-	pageObjectNumber: z.number().int().positive(),
-	meta: MutationMetaSchema
-});
-//#endregion
-export { PageBoxesSchema as $, PdfLinkTargetWritableSchema as $n, InkIntentSchema as $r, FormDataFormatSchema as $t, DocumentVersionRefSchema as A, StrikeoutDTOSchema as An, FileAttachmentWireDraftSchema as Ar, SearchMatchSchema as At, FormImportResultSchema as B, SquareDTOSchema as Bn, CaretPatchSchema as Br, SignatureDTOSchema as Bt, ChangeAnalysisSchema as C, PdfQuadSchema as Ci, UnderlineDTOSchema as Cn, HighlightPatchSchema as Cr, PageStructureCacheSchema as Ct, DocumentMetadataSchema as D, TextDTOSchema as Dn, FileAttachmentDTOSchema as Dr, RedactionApplyResultSchema as Dt, DocumentManifestSchema as E, PdfSizeSchema as Ei, NoteIconSchema as En, FreeTextPatchSchema as Er, PdfSaveModeSchema as Et, FormEffectSchema as F, StampWireDraftSchema as Fn, CircleDTOSchema as Fr, SearchSnippetSchema as Ft, LayerScopesSchema as G, PolylinePatchSchema as Gn, AnnotationFlagsSchema as Gr, VersionAnalysisQuerySchema as Gt, FormSetValueResultSchema as H, SquarePatchSchema as Hn, AnnotationBorderStyleSchema as Hr, SignaturePreparedWireSchema as Ht, FormEffectsResultSchema as I, StampWirePatchSchema as In, CircleDraftSchema as Ir, SignatureAbortResultSchema as It, MetadataUpdateResultSchema as J, PolygonPatchSchema as Jn, AnnotationStableIdSchema as Jr, analyzeInputFromQuery as Jt, ManifestPageSchema as K, PolygonDTOSchema as Kn, AnnotationPatchBaseShape as Kr, WeakAnnotationSessionPagesRequestSchema as Kt, FormFieldCreateResultSchema as L, SquigglyDTOSchema as Ln, CirclePatchSchema as Lr, SignatureAppearanceBodySchema as Lt, DocumentVersionsSchema as M, StrikeoutPatchSchema as Mn, AttachmentFileInfoSchema as Mr, SearchQuerySchema as Mt, EngineErrorPayloadSchema as N, ResourceRefSchema as Nn, EmbeddedFileItemSchema as Nr, SearchRequestSchema as Nt, DocumentProtectionSchema as O, TextDraftSchema as On, FileAttachmentIconSchema as Or, RedactionApplyScopeSchema as Ot, FieldLockSpecSchema as P, StampDTOSchema as Pn, EmbeddedFileRefSchema as Pr, SearchSliceSchema as Pt, OpenDocumentResponseSchema as Q, PdfLinkTargetSchema as Qn, FreeTextIntentSchema as Qr, toBase64 as Qt, FormFieldDeleteResultSchema as R, SquigglyDraftSchema as Rn, CaretDTOSchema as Rr, SignatureCompleteBodySchema as Rt, CachePinsSchema as S, PdfPointSchema as Si, UnsupportedPatchSchema as Sn, HighlightDraftSchema as Sr, PageStateSchema as St, DocumentHeadSchema as T, PdfRotationSchema as Ti, UnderlinePatchSchema as Tn, FreeTextDraftSchema as Tr, PdfRevisionSchema as Tt, FormWidgetLinkResultSchema as U, PolylineDTOSchema as Un, AnnotationDraftBaseShape as Ur, SignatureSeedValueSchema as Ut, FormRepairResultSchema as V, SquareDraftSchema as Vn, AnnotationBaseShape as Vr, SignaturePrepareBodySchema as Vt, LayerAnalysisQuerySchema as W, PolylineDraftSchema as Wn, AnnotationFlagsPartialSchema as Wr, SignatureSnapshotSchema as Wt, MutationMetaSchema as X, LinkDraftSchema as Xn, CaretIntentSchema as Xr, encodePrepared as Xt, ModificationLevelSchema as Y, LinkDTOSchema as Yn, BlendModeSchema as Yr, decodePrepared as Yt, NamedPageEntrySchema as Z, LinkPatchSchema as Zn, ColorSchema as Zr, fromBase64 as Zt, AttachmentDeleteResultSchema as _, PdfPageActionsSchema as _i, AnnotationPatchSchema as _n, ShapeDimensionCaptionSchema as _r, PageRenderAnnotatedQuerySchema as _t, AnnotationAppearancesQuerySchema as a, RevisionTokenSchema as ai, FormFieldPatchSchema as an, LineIntentSchema as ar, PageGeometrySnapshotSchema as at, ByteRangeSchema as b, InkListSchema as bi, UnsupportedDTOSchema as bn, InkPatchSchema as br, PageRotateResultSchema as bt, AnnotationFlattenInputSchema as c, TextAlignmentSchema as ci, FormKindSchema as cn, PageScaleInputSchema as cr, PageInsertResultSchema as ct, AnnotationListPageSnapshotSchema as d, PdfActionTargetRefSchema as di, FormWidgetRefSchema as dn, PdfMeasureWriteSchema as dr, PageMoveInputSchema as dt, LineEndingSchema as ei, FormFieldDTOSchema as en, LineDTOSchema as er, PageDeleteInputSchema as et, AnnotationListSnapshotAllPagesSchema as f, PdfActionTreeSchema as fi, ToggleFieldWidgetSchema as fn, PdfMeasurementSchema as fr, PageMoveResultSchema as ft, AttachmentCreateResultSchema as g, PdfFieldActionsSchema as gi, AnnotationDraftSchema as gn, ShapeCaptionPatchSchema as gr, PageRemoveNameInputSchema as gt, AppearanceOutcomeSchema as h, PdfAnnotationActionsSchema as hi, AnnotationDTOSchema as hn, PolylineIntentSchema as hr, PageNetworkRenderFormatSchema as ht, AnnotationAppearanceManifestSchema as i, RectSchema as ii, FormFieldOptionSchema as in, LineDimensionCaptionSchema as ir, PageFlattenResultSchema as it, DocumentVersionSchema as j, StrikeoutDraftSchema as jn, WireAttachmentFileSchema as jr, SearchModeSchema as jt, DocumentSecurityStateSchema as k, TextPatchSchema as kn, FileAttachmentPatchSchema as kr, RefetchReasonSchema as kt, AnnotationFlattenResultSchema as l, DocumentActionsSnapshotSchema as li, FormSnapshotSchema as ln, PdfForeignMeasureSchema as lr, PageLayoutSchema as lt, AnnotationUpdateResultSchema as m, PdfActionWireComponents as mi, ANNOTATION_KINDS as mn, PolygonIntentSchema as mr, PageNameResultSchema as mt, AccessResponseSchema as n, PdfRectDifferencesSchema as ni, FormFieldFlagsSchema as nn, LinePatchSchema as nr, PageExtractInputSchema as nt, AnnotationCreateResultSchema as o, StandardFontSchema as oi, FormFieldRefSchema as on, LineLeaderSchema as or, PageInsertBlankInputSchema as ot, AnnotationMoveResultSchema as p, PdfActionTypeSchema as pi, WidgetPlacementSchema as pn, PdfNumberFormatSchema as pr, PageNameInputSchema as pt, MetadataPatchSchema as q, PolygonDraftSchema as qn, AnnotationRefSchema as qr, WeakAnnotationSessionResponseSchema as qt, AnnotationAppearanceExportInputSchema as r, PointSchema as ri, FormFieldOptionInputSchema as rn, LineCaptionPatchSchema as rr, PageFlattenInputSchema as rt, AnnotationDeleteResultSchema as s, StrikeoutIntentSchema as si, FormFieldValueSchema as sn, PageMeasurementViewportSchema as sr, PageInsertInputSchema as st, AccessRequestSchema as t, LineEndingsSchema as ti, FormFieldDraftSchema as tn, LineDraftSchema as tr, PageDeleteResultSchema as tt, AnnotationListMutationMetaSchema as u, PdfActionNodeSchema as ui, FormValueEntrySchema as un, PdfMeasureSchema as ur, PageListSnapshotSchema as ut, AttachmentsCacheSchema as v, PdfDestinationSchema as vi, KIND_BY_SUBTYPE as vn, InkDTOSchema as vr, PageRenderQuerySchema as vt, DigestAlgorithmSchema as w, PdfRectSchema as wi, UnderlineDraftSchema as wn, FreeTextDTOSchema as wr, PageTextSnapshotSchema as wt, CacheDeltaSchema as x, LinePointsSchema as xi, UnsupportedDraftSchema as xn, HighlightDTOSchema as xr, PageScaleResultSchema as xt, BaseVersionInfoSchema as y, CalloutLineSchema as yi, WidgetAppearanceSchema as yn, InkDraftSchema as yr, PageRotateInputSchema as yt, FormFieldUpdateResultSchema as z, SquigglyPatchSchema as zn, CaretDraftSchema as zr, SignatureCompleteResultSchema as zt };
-
-//# sourceMappingURL=schemas-CFQGvWiu.js.map