@embedpdf/react 3.0.0-next.1 → 3.0.0-next.10

package/dist/AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.ts

@@ -1,2593 +0,0 @@
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/typeAliases.d.cts
-type Primitive = string | number | symbol | bigint | boolean | null | undefined;
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/util.d.cts
-declare namespace util {
-  type AssertEqual<T, U> = (<V>() => V extends T ? 1 : 2) extends (<V>() => V extends U ? 1 : 2) ? true : false;
-  export type isAny<T> = 0 extends 1 & T ? true : false;
-  export const assertEqual: <A, B>(_: AssertEqual<A, B>) => void;
-  export function assertIs<T>(_arg: T): void;
-  export function assertNever(_x: never): never;
-  export type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
-  export type OmitKeys<T, K extends string> = Pick<T, Exclude<keyof T, K>>;
-  export type MakePartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-  export type Exactly<T, X> = T & Record<Exclude<keyof X, keyof T>, never>;
-  export type InexactPartial<T> = { [k in keyof T]?: T[k] | undefined; };
-  export const arrayToEnum: <T extends string, U extends [T, ...T[]]>(items: U) => { [k in U[number]]: k; };
-  export const getValidEnumValues: (obj: any) => any[];
-  export const objectValues: (obj: any) => any[];
-  export const objectKeys: ObjectConstructor["keys"];
-  export const find: <T>(arr: T[], checker: (arg: T) => any) => T | undefined;
-  export type identity<T> = objectUtil.identity<T>;
-  export type flatten<T> = objectUtil.flatten<T>;
-  export type noUndefined<T> = T extends undefined ? never : T;
-  export const isInteger: NumberConstructor["isInteger"];
-  export function joinValues<T extends any[]>(array: T, separator?: string): string;
-  export const jsonStringifyReplacer: (_: string, value: any) => any;
-  export {};
-}
-declare namespace objectUtil {
-  export type MergeShapes<U, V> = keyof U & keyof V extends never ? U & V : { [k in Exclude<keyof U, keyof V>]: U[k]; } & V;
-  type optionalKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? k : never; }[keyof T];
-  type requiredKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? never : k; }[keyof T];
-  export type addQuestionMarks<T extends object, _O = any> = { [K in requiredKeys<T>]: T[K]; } & { [K in optionalKeys<T>]?: T[K]; } & { [k in keyof T]?: unknown; };
-  export type identity<T> = T;
-  export type flatten<T> = identity<{ [k in keyof T]: T[k]; }>;
-  export type noNeverKeys<T> = { [k in keyof T]: [T[k]] extends [never] ? never : k; }[keyof T];
-  export type noNever<T> = identity<{ [k in noNeverKeys<T>]: k extends keyof T ? T[k] : never; }>;
-  export const mergeShapes: <U, T>(first: U, second: T) => T & U;
-  export type extendShape<A extends object, B extends object> = keyof A & keyof B extends never ? A & B : { [K in keyof A as K extends keyof B ? never : K]: A[K]; } & { [K in keyof B]: B[K]; };
-  export {};
-}
-declare const ZodParsedType: {
-  string: "string";
-  nan: "nan";
-  number: "number";
-  integer: "integer";
-  float: "float";
-  boolean: "boolean";
-  date: "date";
-  bigint: "bigint";
-  symbol: "symbol";
-  function: "function";
-  undefined: "undefined";
-  null: "null";
-  array: "array";
-  object: "object";
-  unknown: "unknown";
-  promise: "promise";
-  void: "void";
-  never: "never";
-  map: "map";
-  set: "set";
-};
-type ZodParsedType = keyof typeof ZodParsedType;
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/ZodError.d.cts
-type allKeys<T> = T extends any ? keyof T : never;
-type typeToFlattenedError<T, U = string> = {
-  formErrors: U[];
-  fieldErrors: { [P in allKeys<T>]?: U[]; };
-};
-declare const ZodIssueCode: {
-  invalid_type: "invalid_type";
-  invalid_literal: "invalid_literal";
-  custom: "custom";
-  invalid_union: "invalid_union";
-  invalid_union_discriminator: "invalid_union_discriminator";
-  invalid_enum_value: "invalid_enum_value";
-  unrecognized_keys: "unrecognized_keys";
-  invalid_arguments: "invalid_arguments";
-  invalid_return_type: "invalid_return_type";
-  invalid_date: "invalid_date";
-  invalid_string: "invalid_string";
-  too_small: "too_small";
-  too_big: "too_big";
-  invalid_intersection_types: "invalid_intersection_types";
-  not_multiple_of: "not_multiple_of";
-  not_finite: "not_finite";
-};
-type ZodIssueCode = keyof typeof ZodIssueCode;
-type ZodIssueBase = {
-  path: (string | number)[];
-  message?: string | undefined;
-};
-interface ZodInvalidTypeIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_type;
-  expected: ZodParsedType;
-  received: ZodParsedType;
-}
-interface ZodInvalidLiteralIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_literal;
-  expected: unknown;
-  received: unknown;
-}
-interface ZodUnrecognizedKeysIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.unrecognized_keys;
-  keys: string[];
-}
-interface ZodInvalidUnionIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_union;
-  unionErrors: ZodError[];
-}
-interface ZodInvalidUnionDiscriminatorIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_union_discriminator;
-  options: Primitive[];
-}
-interface ZodInvalidEnumValueIssue extends ZodIssueBase {
-  received: string | number;
-  code: typeof ZodIssueCode.invalid_enum_value;
-  options: (string | number)[];
-}
-interface ZodInvalidArgumentsIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_arguments;
-  argumentsError: ZodError;
-}
-interface ZodInvalidReturnTypeIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_return_type;
-  returnTypeError: ZodError;
-}
-interface ZodInvalidDateIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_date;
-}
-type StringValidation = "email" | "url" | "emoji" | "uuid" | "nanoid" | "regex" | "cuid" | "cuid2" | "ulid" | "datetime" | "date" | "time" | "duration" | "ip" | "cidr" | "base64" | "jwt" | "base64url" | {
-  includes: string;
-  position?: number | undefined;
-} | {
-  startsWith: string;
-} | {
-  endsWith: string;
-};
-interface ZodInvalidStringIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_string;
-  validation: StringValidation;
-}
-interface ZodTooSmallIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.too_small;
-  minimum: number | bigint;
-  inclusive: boolean;
-  exact?: boolean;
-  type: "array" | "string" | "number" | "set" | "date" | "bigint";
-}
-interface ZodTooBigIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.too_big;
-  maximum: number | bigint;
-  inclusive: boolean;
-  exact?: boolean;
-  type: "array" | "string" | "number" | "set" | "date" | "bigint";
-}
-interface ZodInvalidIntersectionTypesIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.invalid_intersection_types;
-}
-interface ZodNotMultipleOfIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.not_multiple_of;
-  multipleOf: number | bigint;
-}
-interface ZodNotFiniteIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.not_finite;
-}
-interface ZodCustomIssue extends ZodIssueBase {
-  code: typeof ZodIssueCode.custom;
-  params?: {
-    [k: string]: any;
-  };
-}
-type ZodIssueOptionalMessage = ZodInvalidTypeIssue | ZodInvalidLiteralIssue | ZodUnrecognizedKeysIssue | ZodInvalidUnionIssue | ZodInvalidUnionDiscriminatorIssue | ZodInvalidEnumValueIssue | ZodInvalidArgumentsIssue | ZodInvalidReturnTypeIssue | ZodInvalidDateIssue | ZodInvalidStringIssue | ZodTooSmallIssue | ZodTooBigIssue | ZodInvalidIntersectionTypesIssue | ZodNotMultipleOfIssue | ZodNotFiniteIssue | ZodCustomIssue;
-type ZodIssue = ZodIssueOptionalMessage & {
-  fatal?: boolean | undefined;
-  message: string;
-};
-type recursiveZodFormattedError<T> = T extends [any, ...any[]] ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : T extends any[] ? {
-  [k: number]: ZodFormattedError<T[number]>;
-} : T extends object ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : unknown;
-type ZodFormattedError<T, U = string> = {
-  _errors: U[];
-} & recursiveZodFormattedError<NonNullable<T>>;
-declare class ZodError<T = any> extends Error {
-  issues: ZodIssue[];
-  get errors(): ZodIssue[];
-  constructor(issues: ZodIssue[]);
-  format(): ZodFormattedError<T>;
-  format<U>(mapper: (issue: ZodIssue) => U): ZodFormattedError<T, U>;
-  static create: (issues: ZodIssue[]) => ZodError<any>;
-  static assert(value: unknown): asserts value is ZodError;
-  toString(): string;
-  get message(): string;
-  get isEmpty(): boolean;
-  addIssue: (sub: ZodIssue) => void;
-  addIssues: (subs?: ZodIssue[]) => void;
-  flatten(): typeToFlattenedError<T>;
-  flatten<U>(mapper?: (issue: ZodIssue) => U): typeToFlattenedError<T, U>;
-  get formErrors(): typeToFlattenedError<T, string>;
-}
-type stripPath<T extends object> = T extends any ? util.OmitKeys<T, "path"> : never;
-type IssueData = stripPath<ZodIssueOptionalMessage> & {
-  path?: (string | number)[];
-  fatal?: boolean | undefined;
-};
-type ErrorMapCtx = {
-  defaultError: string;
-  data: any;
-};
-type ZodErrorMap = (issue: ZodIssueOptionalMessage, _ctx: ErrorMapCtx) => {
-  message: string;
-};
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.d.cts
-type ParseParams = {
-  path: (string | number)[];
-  errorMap: ZodErrorMap;
-  async: boolean;
-};
-type ParsePathComponent = string | number;
-type ParsePath = ParsePathComponent[];
-interface ParseContext {
-  readonly common: {
-    readonly issues: ZodIssue[];
-    readonly contextualErrorMap?: ZodErrorMap | undefined;
-    readonly async: boolean;
-  };
-  readonly path: ParsePath;
-  readonly schemaErrorMap?: ZodErrorMap | undefined;
-  readonly parent: ParseContext | null;
-  readonly data: any;
-  readonly parsedType: ZodParsedType;
-}
-type ParseInput = {
-  data: any;
-  path: (string | number)[];
-  parent: ParseContext;
-};
-declare class ParseStatus {
-  value: "aborted" | "dirty" | "valid";
-  dirty(): void;
-  abort(): void;
-  static mergeArray(status: ParseStatus, results: SyncParseReturnType<any>[]): SyncParseReturnType;
-  static mergeObjectAsync(status: ParseStatus, pairs: {
-    key: ParseReturnType<any>;
-    value: ParseReturnType<any>;
-  }[]): Promise<SyncParseReturnType<any>>;
-  static mergeObjectSync(status: ParseStatus, pairs: {
-    key: SyncParseReturnType<any>;
-    value: SyncParseReturnType<any>;
-    alwaysSet?: boolean;
-  }[]): SyncParseReturnType;
-}
-type INVALID = {
-  status: "aborted";
-};
-declare const INVALID: INVALID;
-type DIRTY<T> = {
-  status: "dirty";
-  value: T;
-};
-declare const DIRTY: <T>(value: T) => DIRTY<T>;
-type OK<T> = {
-  status: "valid";
-  value: T;
-};
-declare const OK: <T>(value: T) => OK<T>;
-type SyncParseReturnType<T = any> = OK<T> | DIRTY<T> | INVALID;
-type AsyncParseReturnType<T> = Promise<SyncParseReturnType<T>>;
-type ParseReturnType<T> = SyncParseReturnType<T> | AsyncParseReturnType<T>;
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/errorUtil.d.cts
-declare namespace errorUtil {
-  type ErrMessage = string | {
-    message?: string | undefined;
-  };
-  const errToObj: (message?: ErrMessage) => {
-    message?: string | undefined;
-  };
-  const toString: (message?: ErrMessage) => string | undefined;
-}
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/standard-schema.d.cts
-/**
- * The Standard Schema interface.
- */
-type StandardSchemaV1<Input = unknown, Output = Input> = {
-  /**
-   * The Standard Schema properties.
-   */
-  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
-};
-declare namespace StandardSchemaV1 {
-  /**
-   * The Standard Schema properties interface.
-   */
-  export interface Props<Input = unknown, Output = Input> {
-    /**
-     * The version number of the standard.
-     */
-    readonly version: 1;
-    /**
-     * The vendor name of the schema library.
-     */
-    readonly vendor: string;
-    /**
-     * Validates unknown input values.
-     */
-    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-    /**
-     * Inferred types associated with the schema.
-     */
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  /**
-   * The result interface of the validate function.
-   */
-  export type Result<Output> = SuccessResult<Output> | FailureResult;
-  /**
-   * The result interface if validation succeeds.
-   */
-  export interface SuccessResult<Output> {
-    /**
-     * The typed output value.
-     */
-    readonly value: Output;
-    /**
-     * The non-existent issues.
-     */
-    readonly issues?: undefined;
-  }
-  /**
-   * The result interface if validation fails.
-   */
-  export interface FailureResult {
-    /**
-     * The issues of failed validation.
-     */
-    readonly issues: ReadonlyArray<Issue>;
-  }
-  /**
-   * The issue interface of the failure output.
-   */
-  export interface Issue {
-    /**
-     * The error message of the issue.
-     */
-    readonly message: string;
-    /**
-     * The path of the issue, if any.
-     */
-    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-  }
-  /**
-   * The path segment interface of the issue.
-   */
-  export interface PathSegment {
-    /**
-     * The key representing a path segment.
-     */
-    readonly key: PropertyKey;
-  }
-  /**
-   * The Standard Schema types interface.
-   */
-  export interface Types<Input = unknown, Output = Input> {
-    /**
-     * The input type of the schema.
-     */
-    readonly input: Input;
-    /**
-     * The output type of the schema.
-     */
-    readonly output: Output;
-  }
-  /**
-   * Infers the input type of a Standard Schema.
-   */
-  export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
-  /**
-   * Infers the output type of a Standard Schema.
-   */
-  export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
-  export {};
-}
-//#endregion
-//#region ../../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.d.cts
-interface RefinementCtx {
-  addIssue: (arg: IssueData) => void;
-  path: (string | number)[];
-}
-type ZodTypeAny = ZodType<any, any, any>;
-type input<T extends ZodType<any, any, any>> = T["_input"];
-type output<T extends ZodType<any, any, any>> = T["_output"];
-type CustomErrorParams = Partial<util.Omit<ZodCustomIssue, "code">>;
-interface ZodTypeDef {
-  errorMap?: ZodErrorMap | undefined;
-  description?: string | undefined;
-}
-type RawCreateParams = {
-  errorMap?: ZodErrorMap | undefined;
-  invalid_type_error?: string | undefined;
-  required_error?: string | undefined;
-  message?: string | undefined;
-  description?: string | undefined;
-} | undefined;
-type SafeParseSuccess<Output> = {
-  success: true;
-  data: Output;
-  error?: never;
-};
-type SafeParseError<Input> = {
-  success: false;
-  error: ZodError<Input>;
-  data?: never;
-};
-type SafeParseReturnType<Input, Output> = SafeParseSuccess<Output> | SafeParseError<Input>;
-declare abstract class ZodType<Output = any, Def extends ZodTypeDef = ZodTypeDef, Input = Output> {
-  readonly _type: Output;
-  readonly _output: Output;
-  readonly _input: Input;
-  readonly _def: Def;
-  get description(): string | undefined;
-  "~standard": StandardSchemaV1.Props<Input, Output>;
-  abstract _parse(input: ParseInput): ParseReturnType<Output>;
-  _getType(input: ParseInput): string;
-  _getOrReturnCtx(input: ParseInput, ctx?: ParseContext | undefined): ParseContext;
-  _processInputParams(input: ParseInput): {
-    status: ParseStatus;
-    ctx: ParseContext;
-  };
-  _parseSync(input: ParseInput): SyncParseReturnType<Output>;
-  _parseAsync(input: ParseInput): AsyncParseReturnType<Output>;
-  parse(data: unknown, params?: util.InexactPartial<ParseParams>): Output;
-  safeParse(data: unknown, params?: util.InexactPartial<ParseParams>): SafeParseReturnType<Input, Output>;
-  "~validate"(data: unknown): StandardSchemaV1.Result<Output> | Promise<StandardSchemaV1.Result<Output>>;
-  parseAsync(data: unknown, params?: util.InexactPartial<ParseParams>): Promise<Output>;
-  safeParseAsync(data: unknown, params?: util.InexactPartial<ParseParams>): Promise<SafeParseReturnType<Input, Output>>;
-  /** Alias of safeParseAsync */
-  spa: (data: unknown, params?: util.InexactPartial<ParseParams>) => Promise<SafeParseReturnType<Input, Output>>;
-  refine<RefinedOutput extends Output>(check: (arg: Output) => arg is RefinedOutput, message?: string | CustomErrorParams | ((arg: Output) => CustomErrorParams)): ZodEffects<this, RefinedOutput, Input>;
-  refine(check: (arg: Output) => unknown | Promise<unknown>, message?: string | CustomErrorParams | ((arg: Output) => CustomErrorParams)): ZodEffects<this, Output, Input>;
-  refinement<RefinedOutput extends Output>(check: (arg: Output) => arg is RefinedOutput, refinementData: IssueData | ((arg: Output, ctx: RefinementCtx) => IssueData)): ZodEffects<this, RefinedOutput, Input>;
-  refinement(check: (arg: Output) => boolean, refinementData: IssueData | ((arg: Output, ctx: RefinementCtx) => IssueData)): ZodEffects<this, Output, Input>;
-  _refinement(refinement: RefinementEffect<Output>["refinement"]): ZodEffects<this, Output, Input>;
-  superRefine<RefinedOutput extends Output>(refinement: (arg: Output, ctx: RefinementCtx) => arg is RefinedOutput): ZodEffects<this, RefinedOutput, Input>;
-  superRefine(refinement: (arg: Output, ctx: RefinementCtx) => void): ZodEffects<this, Output, Input>;
-  superRefine(refinement: (arg: Output, ctx: RefinementCtx) => Promise<void>): ZodEffects<this, Output, Input>;
-  constructor(def: Def);
-  optional(): ZodOptional<this>;
-  nullable(): ZodNullable<this>;
-  nullish(): ZodOptional<ZodNullable<this>>;
-  array(): ZodArray<this>;
-  promise(): ZodPromise<this>;
-  or<T extends ZodTypeAny>(option: T): ZodUnion<[this, T]>;
-  and<T extends ZodTypeAny>(incoming: T): ZodIntersection<this, T>;
-  transform<NewOut>(transform: (arg: Output, ctx: RefinementCtx) => NewOut | Promise<NewOut>): ZodEffects<this, NewOut>;
-  default(def: util.noUndefined<Input>): ZodDefault<this>;
-  default(def: () => util.noUndefined<Input>): ZodDefault<this>;
-  brand<B extends string | number | symbol>(brand?: B): ZodBranded<this, B>;
-  catch(def: Output): ZodCatch<this>;
-  catch(def: (ctx: {
-    error: ZodError;
-    input: Input;
-  }) => Output): ZodCatch<this>;
-  describe(description: string): this;
-  pipe<T extends ZodTypeAny>(target: T): ZodPipeline<this, T>;
-  readonly(): ZodReadonly<this>;
-  isOptional(): boolean;
-  isNullable(): boolean;
-}
-interface ZodArrayDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  type: T;
-  typeName: ZodFirstPartyTypeKind.ZodArray;
-  exactLength: {
-    value: number;
-    message?: string | undefined;
-  } | null;
-  minLength: {
-    value: number;
-    message?: string | undefined;
-  } | null;
-  maxLength: {
-    value: number;
-    message?: string | undefined;
-  } | null;
-}
-type ArrayCardinality = "many" | "atleastone";
-type arrayOutputType<T extends ZodTypeAny, Cardinality extends ArrayCardinality = "many"> = Cardinality extends "atleastone" ? [T["_output"], ...T["_output"][]] : T["_output"][];
-declare class ZodArray<T extends ZodTypeAny, Cardinality extends ArrayCardinality = "many"> extends ZodType<arrayOutputType<T, Cardinality>, ZodArrayDef<T>, Cardinality extends "atleastone" ? [T["_input"], ...T["_input"][]] : T["_input"][]> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  get element(): T;
-  min(minLength: number, message?: errorUtil.ErrMessage): this;
-  max(maxLength: number, message?: errorUtil.ErrMessage): this;
-  length(len: number, message?: errorUtil.ErrMessage): this;
-  nonempty(message?: errorUtil.ErrMessage): ZodArray<T, "atleastone">;
-  static create: <El extends ZodTypeAny>(schema: El, params?: RawCreateParams) => ZodArray<El>;
-}
-type ZodUnionOptions = Readonly<[ZodTypeAny, ...ZodTypeAny[]]>;
-interface ZodUnionDef<T extends ZodUnionOptions = Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>> extends ZodTypeDef {
-  options: T;
-  typeName: ZodFirstPartyTypeKind.ZodUnion;
-}
-declare class ZodUnion<T extends ZodUnionOptions> extends ZodType<T[number]["_output"], ZodUnionDef<T>, T[number]["_input"]> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  get options(): T;
-  static create: <Options extends Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>>(types: Options, params?: RawCreateParams) => ZodUnion<Options>;
-}
-interface ZodIntersectionDef<T extends ZodTypeAny = ZodTypeAny, U extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  left: T;
-  right: U;
-  typeName: ZodFirstPartyTypeKind.ZodIntersection;
-}
-declare class ZodIntersection<T extends ZodTypeAny, U extends ZodTypeAny> extends ZodType<T["_output"] & U["_output"], ZodIntersectionDef<T, U>, T["_input"] & U["_input"]> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  static create: <TSchema extends ZodTypeAny, USchema extends ZodTypeAny>(left: TSchema, right: USchema, params?: RawCreateParams) => ZodIntersection<TSchema, USchema>;
-}
-interface ZodPromiseDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  type: T;
-  typeName: ZodFirstPartyTypeKind.ZodPromise;
-}
-declare class ZodPromise<T extends ZodTypeAny> extends ZodType<Promise<T["_output"]>, ZodPromiseDef<T>, Promise<T["_input"]>> {
-  unwrap(): T;
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  static create: <Inner extends ZodTypeAny>(schema: Inner, params?: RawCreateParams) => ZodPromise<Inner>;
-}
-type RefinementEffect<T> = {
-  type: "refinement";
-  refinement: (arg: T, ctx: RefinementCtx) => any;
-};
-type TransformEffect<T> = {
-  type: "transform";
-  transform: (arg: T, ctx: RefinementCtx) => any;
-};
-type PreprocessEffect<T> = {
-  type: "preprocess";
-  transform: (arg: T, ctx: RefinementCtx) => any;
-};
-type Effect<T> = RefinementEffect<T> | TransformEffect<T> | PreprocessEffect<T>;
-interface ZodEffectsDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  schema: T;
-  typeName: ZodFirstPartyTypeKind.ZodEffects;
-  effect: Effect<any>;
-}
-declare class ZodEffects<T extends ZodTypeAny, Output = output<T>, Input = input<T>> extends ZodType<Output, ZodEffectsDef<T>, Input> {
-  innerType(): T;
-  sourceType(): T;
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  static create: <I extends ZodTypeAny>(schema: I, effect: Effect<I["_output"]>, params?: RawCreateParams) => ZodEffects<I, I["_output"]>;
-  static createWithPreprocess: <I extends ZodTypeAny>(preprocess: (arg: unknown, ctx: RefinementCtx) => unknown, schema: I, params?: RawCreateParams) => ZodEffects<I, I["_output"], unknown>;
-}
-interface ZodOptionalDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  innerType: T;
-  typeName: ZodFirstPartyTypeKind.ZodOptional;
-}
-declare class ZodOptional<T extends ZodTypeAny> extends ZodType<T["_output"] | undefined, ZodOptionalDef<T>, T["_input"] | undefined> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  unwrap(): T;
-  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodOptional<Inner>;
-}
-interface ZodNullableDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  innerType: T;
-  typeName: ZodFirstPartyTypeKind.ZodNullable;
-}
-declare class ZodNullable<T extends ZodTypeAny> extends ZodType<T["_output"] | null, ZodNullableDef<T>, T["_input"] | null> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  unwrap(): T;
-  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodNullable<Inner>;
-}
-interface ZodDefaultDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  innerType: T;
-  defaultValue: () => util.noUndefined<T["_input"]>;
-  typeName: ZodFirstPartyTypeKind.ZodDefault;
-}
-declare class ZodDefault<T extends ZodTypeAny> extends ZodType<util.noUndefined<T["_output"]>, ZodDefaultDef<T>, T["_input"] | undefined> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  removeDefault(): T;
-  static create: <Inner extends ZodTypeAny>(type: Inner, params: RawCreateParams & {
-    default: Inner["_input"] | (() => util.noUndefined<Inner["_input"]>);
-  }) => ZodDefault<Inner>;
-}
-interface ZodCatchDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  innerType: T;
-  catchValue: (ctx: {
-    error: ZodError;
-    input: unknown;
-  }) => T["_input"];
-  typeName: ZodFirstPartyTypeKind.ZodCatch;
-}
-declare class ZodCatch<T extends ZodTypeAny> extends ZodType<T["_output"], ZodCatchDef<T>, unknown> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  removeCatch(): T;
-  static create: <Inner extends ZodTypeAny>(type: Inner, params: RawCreateParams & {
-    catch: Inner["_output"] | (() => Inner["_output"]);
-  }) => ZodCatch<Inner>;
-}
-interface ZodBrandedDef<T extends ZodTypeAny> extends ZodTypeDef {
-  type: T;
-  typeName: ZodFirstPartyTypeKind.ZodBranded;
-}
-declare const BRAND: unique symbol;
-type BRAND<T extends string | number | symbol> = {
-  [BRAND]: { [k in T]: true; };
-};
-declare class ZodBranded<T extends ZodTypeAny, B extends string | number | symbol> extends ZodType<T["_output"] & BRAND<B>, ZodBrandedDef<T>, T["_input"]> {
-  _parse(input: ParseInput): ParseReturnType<any>;
-  unwrap(): T;
-}
-interface ZodPipelineDef<A extends ZodTypeAny, B extends ZodTypeAny> extends ZodTypeDef {
-  in: A;
-  out: B;
-  typeName: ZodFirstPartyTypeKind.ZodPipeline;
-}
-declare class ZodPipeline<A extends ZodTypeAny, B extends ZodTypeAny> extends ZodType<B["_output"], ZodPipelineDef<A, B>, A["_input"]> {
-  _parse(input: ParseInput): ParseReturnType<any>;
-  static create<ASchema extends ZodTypeAny, BSchema extends ZodTypeAny>(a: ASchema, b: BSchema): ZodPipeline<ASchema, BSchema>;
-}
-type BuiltIn = (((...args: any[]) => any) | (new (...args: any[]) => any)) | {
-  readonly [Symbol.toStringTag]: string;
-} | Date | Error | Generator | Promise<unknown> | RegExp;
-type MakeReadonly<T> = T extends Map<infer K, infer V> ? ReadonlyMap<K, V> : T extends Set<infer V> ? ReadonlySet<V> : T extends [infer Head, ...infer Tail] ? readonly [Head, ...Tail] : T extends Array<infer V> ? ReadonlyArray<V> : T extends BuiltIn ? T : Readonly<T>;
-interface ZodReadonlyDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
-  innerType: T;
-  typeName: ZodFirstPartyTypeKind.ZodReadonly;
-}
-declare class ZodReadonly<T extends ZodTypeAny> extends ZodType<MakeReadonly<T["_output"]>, ZodReadonlyDef<T>, MakeReadonly<T["_input"]>> {
-  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
-  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodReadonly<Inner>;
-  unwrap(): T;
-}
-declare enum ZodFirstPartyTypeKind {
-  ZodString = "ZodString",
-  ZodNumber = "ZodNumber",
-  ZodNaN = "ZodNaN",
-  ZodBigInt = "ZodBigInt",
-  ZodBoolean = "ZodBoolean",
-  ZodDate = "ZodDate",
-  ZodSymbol = "ZodSymbol",
-  ZodUndefined = "ZodUndefined",
-  ZodNull = "ZodNull",
-  ZodAny = "ZodAny",
-  ZodUnknown = "ZodUnknown",
-  ZodNever = "ZodNever",
-  ZodVoid = "ZodVoid",
-  ZodArray = "ZodArray",
-  ZodObject = "ZodObject",
-  ZodUnion = "ZodUnion",
-  ZodDiscriminatedUnion = "ZodDiscriminatedUnion",
-  ZodIntersection = "ZodIntersection",
-  ZodTuple = "ZodTuple",
-  ZodRecord = "ZodRecord",
-  ZodMap = "ZodMap",
-  ZodSet = "ZodSet",
-  ZodFunction = "ZodFunction",
-  ZodLazy = "ZodLazy",
-  ZodLiteral = "ZodLiteral",
-  ZodEnum = "ZodEnum",
-  ZodEffects = "ZodEffects",
-  ZodNativeEnum = "ZodNativeEnum",
-  ZodOptional = "ZodOptional",
-  ZodNullable = "ZodNullable",
-  ZodDefault = "ZodDefault",
-  ZodCatch = "ZodCatch",
-  ZodPromise = "ZodPromise",
-  ZodBranded = "ZodBranded",
-  ZodPipeline = "ZodPipeline",
-  ZodReadonly = "ZodReadonly"
-}
-//#endregion
-//#region ../../engine/core/dist/AnnotationListSnapshot-W0RCsyDE.d.ts
-//#endregion
-//#region src/dto/PdfAction.d.ts
-/** Normalized values of an action dictionary's `/S` name. */
-type PdfActionType = 'unknown' | 'goto' | 'goto-remote' | 'goto-embedded' | 'launch' | 'thread' | 'uri' | 'sound' | 'movie' | 'hide' | 'named' | 'submit-form' | 'reset-form' | 'import-data' | 'javascript' | 'set-ocg-state' | 'rendition' | 'transition' | 'goto-3d-view';
-/** One detached node in a normalized PDF action tree. */
-interface PdfActionNode {
-  type: PdfActionType;
-  /** Raw `/S` name, retained for unknown and future action types. */
-  subtype: string;
-  /** Decoded `/JS` source for JavaScript and Rendition actions. */
-  script?: string;
-  /** Normalized `/Next` children in PDF order. */
-  next: PdfActionNode[];
-}
-type PdfActionWarning = 'cycle-dropped' | 'malformed-next' | 'incomplete';
-/**
- * One extracted action root plus the native reader's safety verdict.
- * Consumers must never execute a tree whose `incomplete` flag is true.
- */
-interface PdfActionTree {
-  /** Null when the model was valid but its root exceeded a safety bound. */
-  root: PdfActionNode | null;
-  incomplete: boolean;
-  /** Raw native bits, retained so newer warnings survive older SDKs. */
-  warningFlags: number;
-  warnings: PdfActionWarning[];
-}
-interface PdfFieldActions {
-  keystroke?: PdfActionTree;
-  format?: PdfActionTree;
-  validate?: PdfActionTree;
-  calculate?: PdfActionTree;
-}
-interface PdfAnnotationActions {
-  activate?: PdfActionTree;
-  cursorEnter?: PdfActionTree;
-  cursorExit?: PdfActionTree;
-  mouseDown?: PdfActionTree;
-  mouseUp?: PdfActionTree;
-  focus?: PdfActionTree;
-  blur?: PdfActionTree;
-  pageOpen?: PdfActionTree;
-  pageClose?: PdfActionTree;
-  pageVisible?: PdfActionTree;
-  pageInvisible?: PdfActionTree;
-}
-//#endregion
-//#region src/geometry/primitives.d.ts
-/**
- * Canonical PDF-document geometry primitives.
- *
- * These are the ONE geometry vocabulary the engine API speaks. They are
- * PDF user space:
- *   - y-UP (origin at the page box's bottom-left; `top > bottom`)
- *   - edges, not x/y/width/height
- *   - page-box origin preserved (NOT origin-normalized)
- *   - browser-free (no DOM, no device pixels) and portable to Rust/Swift/Kotlin
- *
- * They are the only geometry ever sent as engine wire data. Viewer-local
- * geometry (content/view/screen space, y-down, x/y/width/height) lives in the
- * v3 viewer layer and is always produced from these by an EXPLICIT transform.
- *
- * No dependency on PDFium or any browser/Node surface: this is the lingua
- * franca between local engine, cloud engine, and server.
- */
-/** A point in PDF user space (y-up). */
-interface PdfPoint {
-  x: number;
-  y: number;
-}
-/**
- * A rectangle in PDF user space, expressed as edges (y-up, so `top > bottom`
- * and `right > left` once normalized). Page-box origin is preserved, so
- * `left`/`bottom` may be non-zero or negative.
- */
-interface PdfRect {
-  left: number;
-  bottom: number;
-  right: number;
-  top: number;
-}
-/**
- * The two endpoints of a line annotation's `/L` entry, in PDF user space
- * (y-up). `start` is `[x1 y1]` and `end` is `[x2 y2]`.
- */
-interface LinePoints {
-  start: PdfPoint;
-  end: PdfPoint;
-}
-/**
- * A single ink stroke — one continuous pen path, as the ordered point list
- * of an `/InkList` sub-array. Coordinates are PDF user space, y-up.
- */
-type InkStroke = PdfPoint[];
-/**
- * An ink annotation's `/InkList` — an array of strokes (each a point path).
- * Mirrors the PDF structure: `/InkList [ [x1 y1 x2 y2 ...] [ ... ] ]`.
- */
-type InkList = InkStroke[];
-/**
- * A free-text callout annotation's `/CL` leader line, in PDF user space
- * (y-up). Two points draw a straight leader (`[knee->end]` collapses to
- * `[start, end]`); three points draw a knee-jointed leader
- * (`[start, knee, end]`). The last point is the end that touches the text
- * box; the first is the point being called out.
- */
-type CalloutLine = readonly [PdfPoint, PdfPoint] | readonly [PdfPoint, PdfPoint, PdfPoint];
-/**
- * A /QuadPoints quad. The four points are POSITIONAL, in PDFium
- * `FS_QUADPOINTSF` order (PDF 32000 §12.5.6.10): `p1 p2 p3 p4`. Coordinates
- * are PDF user space, y-up.
- *
- * This type asserts NO corner semantics. Quads can be rotated or skewed
- * (e.g. text markup over rotated text), and PDF producers disagree on corner
- * order — so naming corners `topLeft`/... on the wire would be a false
- * guarantee. Derive named corners with `pdfQuadCorners` (valid only for
- * axis-aligned quads) or get the enclosing box with `pdfQuadBounds`.
- */
-interface PdfQuad {
-  p1: PdfPoint;
-  p2: PdfPoint;
-  p3: PdfPoint;
-  p4: PdfPoint;
-}
-/**
- * sRGB color. Components are 0..255 integers. Engines normalize PDFium's
- * device color space into sRGB at read time.
- *
- * Colour carries NO alpha: annotation transparency is a separate concern
- * stored in `/CA` and surfaced as the `opacity` style field, so there is a
- * single source of truth for transparency. See `ColorStyleFields.opacity`.
- */
-interface Color {
-  r: number;
-  g: number;
-  b: number;
-}
-/**
- * /LE entries (line endings). Maps PDFium FPDFAnnot_GetLineEndings codes
- * onto the spec names. We use kebab-case so the wire format is stable
- * across language ports.
- */
-type LineEnding = 'none' | 'square' | 'circle' | 'diamond' | 'open-arrow' | 'closed-arrow' | 'butt' | 'r-open-arrow' | 'r-closed-arrow' | 'slash';
-/**
- * The `/LE` pair carried by line and polyline annotations: the ending
- * drawn at the start point and the ending drawn at the end point.
- */
-interface LineEndings {
-  start: LineEnding;
-  end: LineEnding;
-}
-/**
- * The 14 standard PDF fonts a free-text annotation's `/DA` can name. We use
- * kebab-case so the wire format is stable across language ports; the engine
- * maps these onto PDFium's `FPDF_STANDARD_FONT` integer codes at write time.
- */
-type StandardFont = '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';
-/**
- * Font selector for a free-text annotation: either one of the 14 PDF
- * {@link StandardFont} names, or the `key` of a font registered through
- * `engine.fonts` (local/WASM engine only).
- *
- * The `(string & {})` arm keeps the standard-font literals auto-completing
- * while still accepting any registered key. Because the standard names are
- * matched first at write time, those 14 names are reserved: don't register a
- * custom font under a key like `'helvetica'`.
- */
-type FreeTextFont = StandardFont | (string & {});
-/**
- * Horizontal text alignment (`/Q`) for free-text annotations. Maps onto the
- * ISO 32000 §12.7.3.3 quadding codes 0/1/2 at write time.
- */
-type TextAlignment = 'left' | 'center' | 'right';
-/**
- * Free-text `/IT` intent. `free-text` is a plain text box; `free-text-callout`
- * adds a `/CL` leader line pointing at the called-out region.
- */
-type FreeTextIntent = 'free-text' | 'free-text-callout';
-/** Caret `/IT` intent used by an Acrobat-compatible replace-text edit. */
-type CaretIntent = 'replace';
-/** Strikeout `/IT` intent used by the subordinate part of a replace-text edit. */
-type StrikeoutIntent = 'strikeout-text-edit';
-/** Ink `/IT` intent used by an Acrobat-compatible freehand highlighter. */
-type InkIntent = 'ink-highlight';
-/**
- * Effective blend mode of an annotation's normal appearance stream (`/AP /N`).
- * Values use CSS-compatible kebab-case so the wire vocabulary is portable; the
- * engine maps them onto PDFium's `FPDF_BLENDMODE` integer codes.
- */
-type BlendMode = 'normal' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten' | 'color-dodge' | 'color-burn' | 'hard-light' | 'soft-light' | 'difference' | 'exclusion' | 'hue' | 'saturation' | 'color' | 'luminosity';
-/**
- * Border/line style for shape annotations — the `/BS /S` (border style)
- * subset PDFium can author. Maps onto the ISO 32000 §8.4.3.3 border style
- * names. Cloudy borders are a SEPARATE concern (`/BE` border effect),
- * surfaced as `cloudyIntensity` on the shape DTO, not as a border style.
- *
- * kebab-/lower-case so the wire format is stable across language ports;
- * the engine maps these onto PDFium's integer codes at write time.
- */
-type AnnotationBorderStyle = 'solid' | 'dashed' | 'beveled' | 'inset';
-/**
- * `/RD` (rectangle differences) for shape annotations — the four margins,
- * in PDF points, between the annotation `/Rect` and the geometry actually
- * drawn inside it. Used so a thick/cloudy border has room to render
- * without being clipped by the `/Rect`. y-up PDF user space, so each value
- * is a non-negative inset from the corresponding `/Rect` edge.
- */
-interface PdfRectDifferences {
-  left: number;
-  top: number;
-  right: number;
-  bottom: number;
-}
-/**
- * The `/RT` (reply type) relationship an annotation declares toward the
- * annotation its `/IRT` points at (ISO 32000 §12.5.6.2). Wire-stable
- * kebab/lower-case strings; the engine maps these onto PDFium's
- * `FPDF_ANNOT_REPLY_TYPE` integer codes at read/write time.
- *
- *   'reply' -> `/R`     a comment-thread reply (the ISO default when
- *                       `/IRT` is present but `/RT` is absent).
- *   'group' -> `/Group` a subordinate part of one logical annotation
- *                       group (e.g. the Caret of a text-edit pair).
- */
-type AnnotationReplyType = 'reply' | 'group';
-/**
- * Bitset wrapper for the `/F` (Annotation Flags) PDF entry. We expose each
- * bit as its own boolean so callers don't have to know the bit positions.
- */
-interface AnnotationFlags {
-  invisible: boolean;
-  hidden: boolean;
-  print: boolean;
-  noZoom: boolean;
-  noRotate: boolean;
-  noView: boolean;
-  readOnly: boolean;
-  locked: boolean;
-  toggleNoView: boolean;
-  lockedContents: boolean;
-}
-//#endregion
-//#region src/identity/PageObjectNumber.d.ts
-/**
- * PDF indirect object number for a page.
- *
- * Resolved via the PDFium runtime helper `EPDFPage_GetObjectNumber(pagePtr)`.
- * Always > 0 for well-formed PDFs. This replaces the v2 page index as the
- * primary addressing key. The page index is kept on `PageHandle` as display
- * metadata only, because it can shift when pages are inserted, deleted, or
- * reordered while a session is open.
- */
-type PageObjectNumber = number;
-//#endregion
-//#region src/revision/RevisionToken.d.ts
-/**
- * Opaque token a client must hand back when addressing an annotation by
- * `(pageObjectNumber, index)`. The engine validates strict equality against
- * its own `RevisionStore`; mismatches throw `EngineError(InvalidReference)`.
- *
- * Bleed-over prevention: `docSessionId` ties a token to one open session,
- * so a token minted before close-and-reopen is rejected by the new session.
- */
-interface RevisionToken {
-  docSessionId: string;
-  pageObjectNumber: PageObjectNumber;
-  generation: number;
-}
-//#endregion
-//#region src/identity/AnnotationRef.d.ts
-/**
- * The discriminated union the engine accepts to address an annotation.
- *
- * The resolution order in `AnnotationIdentityResolver` is:
- *   1. `objectNumber` -> `EPDFPage_GetAnnotByObjectNumber(pagePtr, n)`
- *   2. `nm`           -> `EPDFPage_GetAnnotByName(pagePtr, nm)`
- *   3. `index`        -> validate `revision` against `RevisionStore`, then
- *                        `EPDFPage_GetAnnotRaw(docPtr, pageIndex, index)`
- *
- * The `index` form is the strict escape hatch for legacy / direct-object
- * annotations. It must carry a fresh `RevisionToken`, which the engine
- * checks against the per-page generation counter on every dereference.
- * Stale tokens fail with `EngineError(InvalidReference)` instead of silently
- * pointing at the wrong annotation.
- */
-type AnnotationRef = {
-  kind: 'objectNumber';
-  pageObjectNumber: PageObjectNumber;
-  annotObjectNumber: number;
-} | {
-  kind: 'nm';
-  pageObjectNumber: PageObjectNumber;
-  nm: string;
-} | {
-  kind: 'index';
-  pageObjectNumber: PageObjectNumber;
-  index: number;
-  revision: RevisionToken;
-};
-//#endregion
-//#region src/annotation/draft-base.d.ts
-/**
- * Generic fields every annotation Draft carries. These are not specific
- * to any subtype family; they map to PDF dictionary entries that exist
- * on every annotation per ISO 32000 §12.5.2 and may be authored at
- * create time.
- *
- * `nm` is here (and not in AnnotationPatchBase) because /NM seeds the
- * stable identity of a new annotation; it cannot be changed afterwards
- * without changing which annotation is being targeted.
- *
- * Authorial identity (/T author display, /EMBD_Metadata UserID and
- * GroupID) is set by the server from the caller's JWT identity at
- * creation — the worker writes /T from the caller's `display_name`
- * claim and /EMBD_Metadata from the caller's `user_id` / `group_id`
- * claims. The `doc.annotate.create` capability is the gate.
- */
-interface AnnotationDraftBase {
-  contents?: string | null;
-  /** Blend mode to bake into the normal appearance. Omit for the subtype default. */
-  blendMode?: BlendMode;
-  /** Optional /NM the caller wants to assign on creation. */
-  nm?: string;
-  /**
-   * Optional `/F` (Annotation Flags) to set on creation. Only the keys
-   * provided are set; omitted keys default to `false` (the dict starts at
-   * 0). E.g. `{ print: true }` or `{ readOnly: true, hidden: true }`.
-   */
-  flags?: Partial<AnnotationFlags>;
-  /**
-   * Link this new annotation to an existing parent via `/IRT`. The parent
-   * must be on the SAME page as this draft — the engine throws
-   * `InvalidArg` otherwise (ISO 32000 §12.5.6.2). Resolving + writing the
-   * link promotes a weak/direct parent to an indirect object; the
-   * parent's strengthened stable id is reported in the create result's
-   * `meta.changed`, and the read-back DTO's `inReplyTo` carries its
-   * durable ref.
-   */
-  inReplyTo?: AnnotationRef;
-  /**
-   * `/RT` to write when {@link inReplyTo} is set. Defaults to `'reply'`
-   * (the ISO default) when omitted. Ignored when `inReplyTo` is absent.
-   */
-  replyType?: AnnotationReplyType;
-}
-//#endregion
-//#region src/identity/AnnotationIdentityQuality.d.ts
-/**
- * Classification used by clients to decide whether they can hold long-lived
- * references to an annotation.
- *
- * `durable`  - the annotation has a stable wire id (PDF indirect object
- *              number, or `/NM`). References survive structural mutations.
- * `weak`     - the annotation has no stable wire id; the only handle is
- *              `(pageObjectNumber, index, revision)`. Index can shift after
- *              any structural mutation on the same page; the engine encodes
- *              that fact in `AnnotationListMutationMeta.weakRefsInvalidated`.
- */
-type AnnotationIdentityQuality = 'durable' | 'weak';
-//#endregion
-//#region src/annotation/base.d.ts
-/**
- * Identity + provenance shell every annotation DTO extends.
- *
- * No subtype-specific fields. Each subtype's DTO under `annotation/kinds/`
- * extends this with exactly the fields it needs and the `subtype` literal
- * discriminator. This shell never grows when a new subtype lands.
- */
-interface AnnotationBase {
-  ref: AnnotationRef;
-  pageObjectNumber: PageObjectNumber;
-  /** Display order inside the page; 0-based. */
-  index: number;
-  identityQuality: AnnotationIdentityQuality;
-  /** /NM if present, exposed read-only. The engine never auto-stamps it. */
-  nm: string | null;
-  flags: AnnotationFlags;
-  rect: PdfRect;
-  /** /Contents text. */
-  contents: string | null;
-  /** /T author. */
-  author: string | null;
-  /** ISO 8601 from /CreationDate. */
-  created: string | null;
-  /** ISO 8601 from /M. */
-  modified: string | null;
-  /** Effective blend mode used by the normal appearance stream (`/AP /N`). */
-  blendMode: BlendMode;
-  /**
-   * `/IRT` ("in reply to"), resolved to the parent annotation's
-   * {@link AnnotationRef}, or `null` when this is a top-level annotation.
-   *
-   * The parent is always on the same page (ISO 32000 §12.5.6.2 requires
-   * it) and is always an indirect object — `/IRT` is an indirect
-   * reference — so the resolved ref is durable (`objectNumber`, or `nm`
-   * if the parent carries `/NM`). The engine never auto-stamps the parent
-   * on read; it only reports the identity PDFium already exposes.
-   *
-   * Relationships are NOT nested into the DTO: a reply / group member is
-   * itself a first-class annotation in the flat page list. Use
-   * `buildThreads()` to compose this flat edge into primary + replies +
-   * groupedParts for a comments sidebar.
-   */
-  inReplyTo: AnnotationRef | null;
-  /**
-   * `/RT` (reply type) — how this annotation relates to its `/IRT`
-   * parent. `null` exactly when {@link inReplyTo} is `null`. When `/IRT`
-   * is present but `/RT` is absent, the engine normalizes it to `'reply'`
-   * (the ISO 32000 §12.5.6.2 default).
-   */
-  replyType: AnnotationReplyType | null;
-  /**
-   * EmbedPDF-namespaced /EMBD_Metadata fields, when present on the
-   * annotation. These are written by the cloud annotation pipeline (and
-   * by engine-local when an identity is supplied at open time) so the
-   * client can resolve collab semantics and author display.
-   *
-   * Absence means either:
-   *   - the annotation was created before EMBD_Metadata was wired up,
-   *   - it was created by a non-cloud writer (Acrobat, Foxit, etc.),
-   *   - or the writer ran without an actor (anonymous test fixtures).
-   *
-   * Collab filters in the resolver treat absent userId/groupId as
-   * not-self / not-in-group — i.e. deny — so unstamped annotations are
-   * invisible to per-record collab rules. They are still visible to
-   * `view:all` style reads, since reads aren't filtered (per the v1
-   * spec).
-   */
-  userId?: string;
-  groupId?: string;
-  createdBy?: string;
-  updatedBy?: string;
-  /** `/A` and annotation `/AA`, available for every annotation subtype. */
-  actions?: PdfAnnotationActions;
-}
-//#endregion
-//#region src/annotation/patch-base.d.ts
-/**
- * Generic fields every annotation Patch carries.
- *
- * Three-state semantics on string|null fields:
- *   undefined -> don't touch
- *   null      -> clear the field
- *   "..."     -> set to this value
- *
- * Authorial identity is immutable after create:
- *
- *   - `/EMBD_Metadata/UserID` and `/CreatedBy` are bound at creation
- *     and cannot be patched. `/EMBD_Metadata/UpdatedBy` is refreshed by
- *     the server from the caller's identity on every update.
- *   - `/T` (the standard PDF "author" display field) is bound at
- *     creation from the caller's JWT `display_name` and cannot be
- *     patched. Acrobat and other viewers display /T as "author", so
- *     allowing edits would let any caller with update authority
- *     rewrite who appears to have authored the annotation.
- *
- * `groupId` IS patchable — organizational ownership (which team an
- * annotation belongs to) can legitimately change with reorgs /
- * handoffs. Reassignment runs `checkSetGroup` against the caller's
- * scope.
- */
-interface AnnotationPatchBase {
-  contents?: string | null;
-  /** New appearance blend mode. Omit to preserve the current effective mode. */
-  blendMode?: BlendMode;
-  /**
-   * Reassign the annotation's `/EMBD_Metadata/GroupID`.
-   *
-   * When supplied and differs from the annotation's current GroupID,
-   * the route runs `checkSetGroup` against the caller's scope; 403 if
-   * denied. `groupId` does not support a `null` clear-form — group
-   * attribution is either present or absent, and the only mutation is
-   * "reassign to a different group."
-   */
-  groupId?: string;
-  /**
-   * Update the `/F` (Annotation Flags). Only the keys provided are
-   * changed; omitted keys preserve their current value. E.g.
-   * `{ hidden: true }` hides without touching `print`.
-   */
-  flags?: Partial<AnnotationFlags>;
-  /**
-   * Re-target or clear the `/IRT` link, three-state:
-   *   undefined -> leave the link untouched
-   *   null      -> clear `/IRT` (and `/RT`); becomes top-level
-   *   ref       -> set/relink to this parent (must be on the same page;
-   *                `InvalidArg` otherwise). Setting a link promotes a
-   *                weak/direct parent to indirect — its strengthened
-   *                stable id is reported in `meta.changed`.
-   */
-  inReplyTo?: AnnotationRef | null;
-  /**
-   * Change `/RT` without re-linking. Applies to the current `/IRT`
-   * parent; ignored if the annotation has no link and `inReplyTo` is not
-   * being set in the same patch.
-   */
-  replyType?: AnnotationReplyType;
-}
-//#endregion
-//#region src/annotation/subtype.d.ts
-/**
- * Closed-world string catalog of annotation subtypes the v3 wire format knows
- * about. The TypeScript discriminated union `AnnotationDTO` is keyed on this
- * literal type. PDFium's integer subtype code is mapped onto these strings
- * by the reader registry.
- *
- * `unsupported` is the forward-compat fallback for any PDF subtype that
- * the engine has not implemented a reader for yet. Unknown subtypes never
- * silently disappear from the wire — they round-trip as
- * `{ subtype: 'unsupported', rawSubtypeCode }`.
- */
-declare const ANNOTATION_SUBTYPES: readonly ["text", "link", "free-text", "line", "square", "circle", "polygon", "polyline", "highlight", "underline", "squiggly", "strikeout", "stamp", "caret", "ink", "popup", "file-attachment", "redact", "widget", "unsupported"];
-type AnnotationSubtype = (typeof ANNOTATION_SUBTYPES)[number];
-/** What replaces a `BinarySource` field in the wire form of a draft/patch. */
-interface ResourceRef {
-  resource: string;
-}
-//#endregion
-//#region src/dto/Attachment.d.ts
-/**
- * One vocabulary for "a file living inside a PDF" — shared by the
- * file-attachment annotation kind and the document-level EmbeddedFiles
- * service, on both the write and read sides:
- *
- *   write  -> {@link AttachmentFileSource}: the shared metadata fields plus
- *             inline `data` bytes (the [[BinarySource]] rule — bytes are a
- *             call argument, never engine state).
- *   read   -> {@link AttachmentFileInfo}: the same metadata fields plus
- *             engine-derived facts (size, checksum, creationDate) and never
- *             the bytes — listings stay cheap; bytes leave the engine only
- *             through an explicit download call.
- *
- * A file has exactly two possible homes: the document catalog's
- * `/EmbeddedFiles` name tree (addressed by {@link EmbeddedFileItem.index}),
- * and a FileAttachment annotation's `/FS` (addressed by the annotation ref).
- */
-/** Metadata fields shared by the write and read forms. */
-interface AttachmentFileBase {
-  /** File name — `/UF` (and `/F`) on the filespec. */
-  name: string;
-  /** MIME type — `/Subtype` of the embedded file stream. */
-  mimeType?: string;
-  /** Human-readable description — `/Desc` on the filespec. */
-  description?: string;
-}
-/** Read-side projection of an embedded file stream (`/EF` + `/Params`). */
-interface AttachmentFileInfo extends AttachmentFileBase {
-  /** `/Params /Size` — decoded size in bytes. */
-  size?: number;
-  /** `/Params /CheckSum` — MD5 of the decoded bytes, lowercase hex. */
-  checksum?: string;
-  /** `/Params /CreationDate` — PDF date string. */
-  creationDate?: string;
-}
-//#endregion
-//#region src/annotation/kinds/style.shared.d.ts
-/**
- * Composable styling layers shared by every annotation family, named after
- * the PDF entries they map onto so the v3 wire vocabulary matches ISO 32000:
- *
- *   ColorStyleFields    -> `/C` (color) + `/CA` (opacity)        — universal
- *   GeometryStyleFields -> + `/BS` (border style / width / dash) — geometric
- *   FilledStyleFields   -> + `/IC` (interior color)              — filled shapes
- *
- * There is exactly one `/C` in the spec ("Color") and one `/IC` ("Interior
- * Color") — there is no "stroke color" — so every family that carries `/C`
- * exposes the same `color` field. This is what lets a multi-select "change
- * colour" operate uniformly across text-markup, lines, and shapes.
- *
- * Composition by family:
- *   - text-markup (highlight/underline/squiggly/strikeout) -> ColorStyleFields
- *   - ink                                                   -> GeometryStyleFields
- *   - square/circle/polygon/polyline/line                  -> FilledStyleFields
- */
-interface ColorStyleFields {
-  /** `/C` color. Stroke colour for geometric kinds; highlight colour for markup. */
-  color: Color;
-  /** `/CA` constant opacity, 0..1. */
-  opacity: number;
-}
-interface ColorStyleDraftFields {
-  color?: Color;
-  opacity?: number;
-}
-type ColorStylePatchFields = ColorStyleDraftFields;
-interface GeometryStyleFields extends ColorStyleFields {
-  /** `/BS /W` border width, in PDF points. */
-  strokeWidth: number;
-  /** `/BS /S` border style. */
-  borderStyle: AnnotationBorderStyle;
-  /** `/BS /D` dash pattern. Only meaningful when `borderStyle === 'dashed'`. */
-  dashArray?: number[];
-}
-interface GeometryStyleDraftFields extends ColorStyleDraftFields {
-  strokeWidth?: number;
-  borderStyle?: AnnotationBorderStyle;
-  dashArray?: number[];
-}
-type GeometryStylePatchFields = GeometryStyleDraftFields;
-interface FilledStyleFields extends GeometryStyleFields {
-  /** `/IC` interior (fill) color. `null` when the annotation has no fill. */
-  interiorColor: Color | null;
-}
-interface FilledStyleDraftFields extends GeometryStyleDraftFields {
-  interiorColor?: Color | null;
-}
-type FilledStylePatchFields = FilledStyleDraftFields;
-//#endregion
-//#region src/annotation/kinds/file-attachment/draft.d.ts
-/** `/Name` icon of a file attachment annotation — ISO 32000 §12.5.6.15. */
-type FileAttachmentIcon = 'push-pin' | 'paperclip' | 'graph' | 'tag';
-/**
- * Wire form of the attached file: the metadata half of
- * {@link AttachmentFileSource} stays in the JSON body (so the single Zod
- * schema validates it on client, worker, and server) while the bytes
- * travel out-of-band under the referenced resource key.
- */
-interface WireAttachmentFile {
-  resource: string;
-  name: string;
-  mimeType?: string;
-  description?: string;
-}
-/** Wire form of {@link FileAttachmentDraft} — pure JSON. */
-interface FileAttachmentWireDraft extends AnnotationDraftBase, ColorStyleDraftFields {
-  subtype: 'file-attachment';
-  rect: PdfRect;
-  file: WireAttachmentFile;
-  icon?: FileAttachmentIcon;
-}
-//#endregion
-//#region src/annotation/registry.d.ts
-/**
- * One module per PDF annotation subtype. A kind module is the single source
- * of truth for that subtype: DTO type, draft type, patch type, and the zod
- * schemas for each. The catalog union types and runtime schemas are derived
- * from `AnnotationKinds` so adding a subtype is one folder, never a
- * type-system refactor.
- */
-interface AnnotationKindModule<S extends AnnotationSubtype, DTO extends AnnotationBase & {
-  subtype: S;
-}, Draft, Patch> {
-  readonly subtype: S;
-  /**
-   * The PDFium subtype code(s) this module handles. Most kinds claim a single
-   * code; text-markup kinds map a single PDFium code each (HIGHLIGHT,
-   * UNDERLINE, SQUIGGLY, STRIKEOUT) but share an internal reader.
-   */
-  readonly pdfSubtypeCode: number;
-  readonly dtoSchema: ZodType<DTO>;
-  readonly draftSchema: ZodType<Draft>;
-  readonly patchSchema: ZodType<Patch>;
-}
-//#endregion
-//#region src/dto/PdfDestination.d.ts
-/**
- * An explicit PDF destination (ISO 32000-1 §12.3.2.2): a page, a location,
- * and a magnification. Produced by outlines/bookmarks, link annotations,
- * `/OpenAction`, and GoTo actions; named destinations resolve to one of
- * these through the catalog's `/Dests` dictionary or name tree — the
- * ENGINE does that resolution, so the viewer only ever sees this explicit
- * form.
- *
- * Coordinates are PDF user space (y-up, points, absolute — NOT
- * crop-relative). `null` means "retain the current value" (the spec's
- * meaning for null array entries); a `/XYZ` zoom of `0` is equivalent to
- * null. The `fitB*` kinds refer to the page's content BOUNDING box rather
- * than the crop box.
- *
- * Viewers translate these onto the stage's reveal primitive — see
- * `destinationToReveal` in `@embedpdf/plugin-stage`.
- */
-type PdfDestination = {
-  kind: 'xyz';
-  pageObjectNumber: PageObjectNumber;
-  left?: number | null;
-  top?: number | null;
-  zoom?: number | null;
-} | {
-  kind: 'fit';
-  pageObjectNumber: PageObjectNumber;
-} | {
-  kind: 'fitH';
-  pageObjectNumber: PageObjectNumber;
-  top?: number | null;
-} | {
-  kind: 'fitV';
-  pageObjectNumber: PageObjectNumber;
-  left?: number | null;
-} | {
-  kind: 'fitR';
-  pageObjectNumber: PageObjectNumber;
-  left: number;
-  bottom: number;
-  right: number;
-  top: number;
-} | {
-  kind: 'fitB';
-  pageObjectNumber: PageObjectNumber;
-} | {
-  kind: 'fitBH';
-  pageObjectNumber: PageObjectNumber;
-  top?: number | null;
-} | {
-  kind: 'fitBV';
-  pageObjectNumber: PageObjectNumber;
-  left?: number | null;
-};
-//#endregion
-//#region src/dto/PdfLinkTarget.d.ts
-/**
- * Where a link annotation points, NORMALIZED. A link may carry either a
- * direct `/Dest` or an `/A` action (ISO 32000-1 §12.5.6.5); to a viewer a
- * `/Dest` and a `/A GoTo` are the same intent, so the engine collapses both
- * onto the `goto` arm — clients never see the raw two-shape split (the v2
- * `target.action.destination` double-wrap). Named destinations are resolved
- * to explicit ones engine-side, the same rule {@link PdfDestination}
- * documents.
- *
- * Arm names follow the `PdfActionType` vocabulary (`goto`, `uri`,
- * `goto-remote`, `launch`, `javascript`) so the two action-shaped surfaces
- * never drift.
- *
- * `goto-remote`, `launch`, and `javascript` are READ-ONLY in v1: the
- * engine reports them so a client can display/inspect (or, for
- * `javascript`, hand the link to the scripting orchestrator), but never
- * follows or executes them here, and refuses to write them (see
- * {@link PdfLinkTargetWritable}). `javascript` deliberately carries NO
- * script payload — the text already rides the base
- * `actions.activate` model, which is the scripting plane's single home
- * for action scripts. `unsupported` preserves round-trip for action
- * types the reader doesn't model.
- */
-type PdfLinkTarget = {
-  kind: 'goto';
-  destination: PdfDestination;
-} | {
-  kind: 'uri';
-  uri: string;
-} | {
-  kind: 'goto-remote';
-  file: string;
-} | {
-  kind: 'launch';
-  path: string;
-} | {
-  kind: 'javascript';
-} |
-/** `/S /Named` — a viewer verb (`NextPage`, `PrevPage`, `FirstPage`,
- *  `LastPage`, …). Read-only in v1; common in TOC/nav links. */
-{
-  kind: 'named';
-  name: string;
-} | {
-  kind: 'unsupported';
-};
-/**
- * The subset of {@link PdfLinkTarget} that drafts/patches may author:
- * in-document destinations and URIs. Keeping `goto-remote`/`launch` out of
- * the WRITE surface is deliberate (executable-shaped actions are a security
- * liability the viewer never needs to author), and `unsupported` carries
- * nothing to write.
- */
-type PdfLinkTargetWritable = Extract<PdfLinkTarget, {
-  kind: 'goto' | 'uri';
-}>;
-//#endregion
-//#region src/identity/FormFieldRef.d.ts
-/**
- * How callers address a logical form field.
- *
- * - `objectNumber` — the indirect object number of the field dictionary.
- *   ISO 32000 guarantees every real AcroForm field dictionary is an
- *   indirect object, and the layer runtime never renumbers (frozen base +
- *   incremental deltas), so this is the durable identity for the lifetime
- *   of a document. Preferred for all engine calls.
- * - `fqn` — the fully qualified field name ("billing.name"). The portable,
- *   semantic identity used by interchange formats (FDF/XFDF) and analytics;
- *   survives document rewrites but is only as unique as the producer made
- *   it. The engine resolves it against the reconciled field tree.
- */
-type FormFieldRef = {
-  kind: 'objectNumber';
-  fieldObjectNumber: number;
-} | {
-  kind: 'fqn';
-  name: string;
-};
-/** A widget annotation of a field, as the forms subsystem sees it. */
-interface FormWidgetRef {
-  /**
-   * Indirect object number of the widget annotation — the join key to the
-   * annotation subsystem's `objectNumber` refs. `0` when the widget is
-   * stored as a direct object (spec-violating; cannot be addressed).
-   */
-  annotObjectNumber: number;
-  /**
-   * Object number of the page whose /Annots array references the widget.
-   * `0` when the widget is not reachable from any page ("unplaced").
-   */
-  pageObjectNumber: PageObjectNumber;
-}
-//#endregion
-//#region src/forms/value-entry.d.ts
-/** Lossless shape of a field's effective PDF `/V` or `/DV` object. */
-type FormValueEntry = {
-  kind: 'none';
-} | {
-  kind: 'scalar';
-  value: string;
-} | {
-  kind: 'array';
-  values: string[];
-} | {
-  kind: 'unsupported';
-};
-//#endregion
-//#region src/forms/field.d.ts
-/**
- * The field family — the discriminant of {@link FormFieldDTO}. Narrowing on
- * it reveals exactly the members that are meaningful for that family, the
- * same way annotation DTOs narrow on `subtype`.
- */
-type FormFieldFamily = 'text' | 'checkbox' | 'radio' | 'combobox' | 'listbox' | 'pushbutton' | 'signature' | 'unknown';
-/**
- * Where the field was found.
- *
- * - `acroform` — reachable from the /AcroForm /Fields tree, as the spec
- *   requires.
- * - `recovered` — only reachable through a page's /Annots array (a common
- *   producer bug). The engine reconciles these on every read so they work
- *   like any other field, but other PDF processors will not see them until
- *   {@link DocumentFormsService.repair} makes the fix durable.
- */
-type FormFieldOrigin = 'acroform' | 'recovered';
-/**
- * The /Ff flags every field family shares. Family-specific flags (comb,
- * multi-select, radios-in-unison, ...) live as plain booleans on the
- * family DTOs where they are always meaningful.
- */
-interface FormFieldFlags {
-  /**
-   * The user must not change the value. The engine's write transactions
-   * still accept programmatic writes to read-only fields (calculated
-   * fields are read-only yet script-written); enforcing fill policy is
-   * the application's job.
-   */
-  readOnly: boolean;
-  required: boolean;
-  noExport: boolean;
-  /** The raw /Ff integer, for anything not surfaced. */
-  raw: number;
-}
-/**
- * A widget of a toggle (checkbox/radio) field. Toggle widgets always carry
- * their appearance-state machinery — no nullable fields to probe.
- */
-interface ToggleFieldWidget extends FormWidgetRef {
-  /**
-   * The widget's appearance state name (the non-"Off" key of its /AP /N
-   * dictionary) — the token toggle writes address widgets by.
-   */
-  onState: string;
-  /**
-   * The widget's export value (/Opt entry when present, else the
-   * on-state). The identity FDF/XFDF carry.
-   */
-  exportValue: string;
-  /** Whether this widget is currently checked. */
-  checked: boolean;
-}
-/** One option of a choice (combo/list box) field. */
-interface FormFieldOption {
-  /** Display label shown to the user. */
-  label: string;
-  /** Export value used by /V, interchange, and `FormFieldValue.choice`. */
-  value: string;
-  /** Whether the option is currently selected. */
-  selected: boolean;
-}
-/**
- * The trunk every field family shares: identity, provenance, universal
- * flags, and widget placement. A logical field is the document-scoped
- * record that holds the value; its widgets are page-scoped views — join
- * them to the annotation subsystem via `annotObjectNumber`.
- */
-interface FormFieldBase {
-  /** Durable ref (`objectNumber` whenever the field dictionary is indirect). */
-  ref: FormFieldRef;
-  /** Field dictionary object number; `0` for direct (spec-violating) dicts. */
-  fieldObjectNumber: number;
-  /** Fully qualified name, e.g. `"billing.name"`. */
-  name: string;
-  family: FormFieldFamily;
-  origin: FormFieldOrigin;
-  flags: FormFieldFlags;
-  /** /TU — the accessible tooltip / alternate name. */
-  alternateName: string | null;
-  /** /TM — the export mapping name. */
-  mappingName: string | null;
-  /** Exact effective `/V` object shape; family conveniences below are derived. */
-  valueEntry: FormValueEntry;
-  /** Exact effective `/DV` object shape, including absent and malformed values. */
-  defaultValueEntry: FormValueEntry;
-  /** Effective inherited field `/AA` actions. */
-  actions?: PdfFieldActions;
-  /** The field's widget annotations, in control order. May be empty ("unplaced"). */
-  widgets: FormWidgetRef[];
-}
-/** A text field. Write with `{ type: 'text', value }`. */
-interface TextFieldDTO extends FormFieldBase {
-  family: 'text';
-  value: string;
-  /** /DV — restored by `reset()`. */
-  defaultValue: string;
-  /** /MaxLen; `null` when unlimited. Longer writes are truncated to this length. */
-  maxLength: number | null;
-  multiline: boolean;
-  password: boolean;
-  /** Fixed character cells; meaningful with `maxLength`. */
-  comb: boolean;
-}
-/** A checkbox. Write with `{ type: 'toggle', state: onState | null }`. */
-interface CheckboxFieldDTO extends FormFieldBase {
-  family: 'checkbox';
-  checked: boolean;
-  /** The export value reported while checked ("Off" is never exported). */
-  exportValue: string;
-  widgets: ToggleFieldWidget[];
-}
-/** A radio group: ONE field, N widgets. Write with `{ type: 'toggle', state }`. */
-interface RadioFieldDTO extends FormFieldBase {
-  family: 'radio';
-  /** The checked widget's export value, or `"Off"` when the group is clear. */
-  value: string;
-  /** Widgets sharing an export value check together. */
-  radiosInUnison: boolean;
-  /** The group cannot be cleared once a choice is made. */
-  noToggleToOff: boolean;
-  widgets: ToggleFieldWidget[];
-}
-/** A combo box (dropdown). Write with `{ type: 'choice', values: [v] }`. */
-interface ComboBoxFieldDTO extends FormFieldBase {
-  family: 'combobox';
-  /** An option export value — or free text when `edit` is set. */
-  value: string;
-  /** /DV — restored by `reset()`. */
-  defaultValue: string;
-  /** Free text is allowed in addition to the options. */
-  edit: boolean;
-  options: FormFieldOption[];
-}
-/** A list box. Write with `{ type: 'choice', values }`. */
-interface ListBoxFieldDTO extends FormFieldBase {
-  family: 'listbox';
-  /** Selected option export values, in option order. */
-  selectedValues: string[];
-  /** Whether several options may be selected at once. */
-  multiSelect: boolean;
-  options: FormFieldOption[];
-}
-/** A push button: pure trigger, holds no value. Never written or exported. */
-interface PushButtonFieldDTO extends FormFieldBase {
-  family: 'pushbutton';
-}
-/**
- * A signature field. Identity and placement only for now — the engine
- * never writes signature values; signing is a future capability.
- */
-interface SignatureFieldDTO extends FormFieldBase {
-  family: 'signature';
-}
-/**
- * Forward-compat placeholder for field types the engine does not model,
- * mirroring the `unsupported` annotation kind. Round-trips safely.
- */
-interface UnknownFieldDTO extends FormFieldBase {
-  family: 'unknown';
-  /** The raw /V value as text, for diagnostics. */
-  rawValue: string;
-}
-/**
- * A logical form field. Discriminated on `family`:
- *
- * ```ts
- * if (field.family === 'listbox') {
- *   field.selectedValues; // string[]
- * }
- * ```
- */
-type FormFieldDTO = TextFieldDTO | CheckboxFieldDTO | RadioFieldDTO | ComboBoxFieldDTO | ListBoxFieldDTO | PushButtonFieldDTO | SignatureFieldDTO | UnknownFieldDTO;
-//#endregion
-//#region src/annotation/kinds/widget.shared.d.ts
-/**
- * Widget-plane styling, using the same vocabulary as the sibling kinds
- * (`color` strokes the border, `interiorColor` fills, `strokeWidth` is the
- * border width — the free-text/shape convention) mapped onto the widget
- * dictionaries: /MK for colors, /BS for the border, /DA for the text
- * defaults, /Q for alignment.
- *
- * These fields are shared VERBATIM with `doc.forms` authoring: a
- * `WidgetPlacement.appearance` in `createField` is exactly
- * {@link WidgetAppearance}, and one writer applies both underneath.
- */
-interface WidgetStyleFields {
-  /** `/MK /BC` — border colour. `null` when the widget draws no border colour. */
-  color: Color | null;
-  /** `/MK /BG` — background. `null` = transparent (no entry). */
-  interiorColor: Color | null;
-  /** `/BS /W` — border width. */
-  strokeWidth: number;
-  /** `/BS /S` — border style. */
-  borderStyle: AnnotationBorderStyle;
-  /** `/DA` font. Absent when the widget has no default appearance. */
-  fontFamily?: StandardFont;
-  /** `/DA` size; `0` = auto-size. */
-  fontSize?: number;
-  /** `/DA` colour. */
-  fontColor?: Color;
-  /** `/Q`. */
-  textAlign: TextAlignment;
-}
-interface WidgetStyleDraftFields {
-  /** `/MK /BC`. `null` = write no border colour. */
-  color?: Color | null;
-  /** `/MK /BG`. `null` = transparent. */
-  interiorColor?: Color | null;
-  strokeWidth?: number;
-  borderStyle?: AnnotationBorderStyle;
-  fontFamily?: StandardFont;
-  /** `0` = auto-size. */
-  fontSize?: number;
-  fontColor?: Color;
-  textAlign?: TextAlignment;
-}
-/** Patch fields are the draft fields; `null` clears the colour entries. */
-type WidgetStylePatchFields = WidgetStyleDraftFields;
-//#endregion
-//#region src/forms/snapshot.d.ts
-/**
- * What kind of interactive form the document declares.
- *
- * - `none` — no /AcroForm dictionary. Recovered fields may still exist
- *   (see {@link FormFieldOrigin}); `repair()` can bootstrap the dictionary.
- * - `acroform` — a standard AcroForm.
- * - `xfa` — the /AcroForm carries an /XFA entry. The engine serves the
- *   AcroForm shell read-only and never executes XFA.
- */
-type FormKind = 'none' | 'acroform' | 'xfa';
-/**
- * The document's complete form state at one instant: the reconciled field
- * tree flattened to terminal fields with fully qualified names.
- *
- * Snapshots are detached and immutable — any mutation (a value write, an
- * annotation edit, a page operation) makes previously returned snapshots
- * stale. Re-read after mutating; the engine caches the underlying model
- * per document version, so repeated reads between mutations are cheap.
- */
-interface FormSnapshot {
-  formKind: FormKind;
-  /**
-   * Whether the /AcroForm sets /NeedAppearances (viewer-generated widget
-   * appearances). The engine bakes appearances on every write regardless;
-   * `repair({ bakeAppearances: true })` can clear the flag document-wide.
-   */
-  needsAppearances: boolean;
-  fields: FormFieldDTO[];
-  /** `/AcroForm /CO` order; null preserves each malformed/unresolved slot. */
-  calculationOrder: Array<FormFieldRef | null>;
-}
-//#endregion
-//#region src/search/types.d.ts
-/**
- * What to search for — THE one shape, engine → wire → plugin state →
- * search box. One flat object; the flags define behavior per mode instead
- * of the mode changing the shape:
- *
- * | flag              | literal          | regex                          |
- * |-------------------|------------------|--------------------------------|
- * | `matchCase`       | fold case        | `i` flag                       |
- * | `wholeWord`       | boundary check   | pattern is `\b(?:…)\b`-wrapped |
- * | `matchDiacritics` | mark fold        | REJECTED (`InvalidArg`)        |
- *
- * Literal queries match over FOLDED text; regex queries run the portable
- * dialect against the RAW page text — which is why `matchDiacritics`
- * cannot apply to them (diacritic folding is a property of the folded
- * text plane). Validate with `validateSearchQuery` for early UI feedback;
- * engines re-validate and reject with `EngineErrorCode.InvalidArg`.
- */
-interface SearchQuery {
-  /**
-   * The literal text — or, when `regex`, a pattern in the portable
-   * search-regex dialect: JavaScript `u`-mode syntax MINUS backreferences
-   * and lookaround, so every valid pattern also runs on RE2 (the
-   * server-side engine).
-   */
-  text: string;
-  /** Interpret `text` as a regex pattern. Default false (literal). */
-  regex?: boolean;
-  /** Exact-case matching. Default false (case-folded / `i` semantics). */
-  matchCase?: boolean;
-  /** Only match at word boundaries (letters/digits end the word). */
-  wholeWord?: boolean;
-  /**
-   * Treat diacritics as significant ("café" ≠ "cafe"). Default false —
-   * marks are stripped on both sides, which is what viewers ship.
-   * LITERAL ONLY: combined with `regex` the query is rejected.
-   */
-  matchDiacritics?: boolean;
-}
-//#endregion
-//#region src/annotation/kinds/text-markup.shared.d.ts
-/**
- * Text-markup family-specific fields. The four text-markup subtypes
- * (highlight/underline/squiggly/strikeout) share their wire shape per
- * ISO 32000 12.5.6.10: the universal {@link ColorStyleFields} (`/C` color +
- * `/CA` opacity) plus one or more `quadPoints` quads.
- *
- * This file ONLY carries fields that are unique to the text-markup
- * family. Annotation-wide author-metadata (`contents`, `author`, `nm`)
- * lives on `AnnotationDraftBase` / `AnnotationPatchBase`. Each kind's
- * draft/patch type composes the two: family fields + base fields +
- * own `subtype` literal.
- */
-interface TextMarkupAnnotationFields extends ColorStyleFields {
-  quadPoints: PdfQuad[];
-}
-interface TextMarkupDraftFields extends ColorStyleDraftFields {
-  quadPoints: PdfQuad[];
-}
-interface TextMarkupPatchFields extends ColorStylePatchFields {
-  quadPoints?: PdfQuad[];
-}
-/** Glue type used by each kind file to construct its concrete DTO. */
-type TextMarkupDTO<S extends string> = AnnotationBase & {
-  subtype: S;
-} & TextMarkupAnnotationFields;
-//#endregion
-//#region src/annotation/kinds/highlight/draft.d.ts
-interface HighlightDraft extends AnnotationDraftBase, TextMarkupDraftFields {
-  subtype: 'highlight';
-}
-//#endregion
-//#region src/annotation/kinds/highlight/dto.d.ts
-type HighlightAnnotationDTO = TextMarkupDTO<'highlight'>;
-//#endregion
-//#region src/annotation/kinds/highlight/patch.d.ts
-interface HighlightPatch extends AnnotationPatchBase, TextMarkupPatchFields {
-  subtype: 'highlight';
-}
-//#endregion
-//#region src/annotation/kinds/underline/draft.d.ts
-interface UnderlineDraft extends AnnotationDraftBase, TextMarkupDraftFields {
-  subtype: 'underline';
-}
-//#endregion
-//#region src/annotation/kinds/underline/dto.d.ts
-type UnderlineAnnotationDTO = TextMarkupDTO<'underline'>;
-//#endregion
-//#region src/annotation/kinds/underline/patch.d.ts
-interface UnderlinePatch extends AnnotationPatchBase, TextMarkupPatchFields {
-  subtype: 'underline';
-}
-//#endregion
-//#region src/annotation/kinds/squiggly/draft.d.ts
-interface SquigglyDraft extends AnnotationDraftBase, TextMarkupDraftFields {
-  subtype: 'squiggly';
-}
-//#endregion
-//#region src/annotation/kinds/squiggly/dto.d.ts
-type SquigglyAnnotationDTO = TextMarkupDTO<'squiggly'>;
-//#endregion
-//#region src/annotation/kinds/squiggly/patch.d.ts
-interface SquigglyPatch extends AnnotationPatchBase, TextMarkupPatchFields {
-  subtype: 'squiggly';
-}
-//#endregion
-//#region src/annotation/kinds/strikeout/draft.d.ts
-interface StrikeoutDraft extends AnnotationDraftBase, TextMarkupDraftFields {
-  subtype: 'strikeout';
-  intent?: StrikeoutIntent;
-}
-//#endregion
-//#region src/annotation/kinds/strikeout/dto.d.ts
-type StrikeoutAnnotationDTO = TextMarkupDTO<'strikeout'> & {
-  /** Normalized `/IT`; null for an ordinary standalone strikeout. */
-  intent: StrikeoutIntent | null;
-};
-//#endregion
-//#region src/annotation/kinds/strikeout/patch.d.ts
-interface StrikeoutPatch extends AnnotationPatchBase, TextMarkupPatchFields {
-  subtype: 'strikeout';
-  intent?: StrikeoutIntent;
-}
-//#endregion
-//#region src/annotation/kinds/shape.shared.d.ts
-/**
- * Shape-family-specific fields. The two shape subtypes (circle/square)
- * share their wire shape per ISO 32000 §12.5.6.8: they are `/Rect`-based
- * outlines with the common stroke/fill styling ({@link FilledStyleFields}),
- * an optional cloudy border effect (`/BE`), and optional rectangle
- * differences (`/RD`).
- *
- * Unlike the text-markup family (which derives `/Rect` from `quadPoints`),
- * shapes carry `/Rect` as their primary geometry — so the Draft requires
- * `rect` explicitly while the DTO inherits it from `AnnotationBase`.
- */
-/**
- * Rotation fields shared by the rotatable box families (shapes + free-text).
- * `rotation` is degrees in PDF convention (the v3 plugin converts its
- * content-space clockwise angle at the boundary); `unrotatedRect` is the
- * logical (pre-rotation) box. Together they drive PDFium's `/EMBD_Metadata`
- * AP rotation (`/Matrix` + `/BBox`); `/Rect` stays the rotated visual AABB.
- */
-interface ShapeAnnotationFields extends FilledStyleFields {
-  /** `/BE` cloudy border intensity; `null` when the border carries no effect. */
-  cloudyIntensity: number | null;
-  /** `/RD` rectangle differences (inset of drawn geometry from `/Rect`); `null` when absent. */
-  rectDifferences: PdfRectDifferences | null;
-  /** `/EMBD_Metadata/Rotation` — degrees, normalized `[0,360)`. */
-  rotation?: number;
-  /** `/EMBD_Metadata/UnrotatedRect` — the logical box (required when rotation != 0). */
-  unrotatedRect?: PdfRect;
-}
-interface ShapeDraftFields extends FilledStyleDraftFields {
-  /** `/Rect` geometry — required for shapes (they are not derived from quads). */
-  rect: PdfRect;
-  cloudyIntensity?: number | null;
-  rectDifferences?: PdfRectDifferences | null;
-  rotation?: number | null;
-  unrotatedRect?: PdfRect | null;
-}
-interface ShapePatchFields extends FilledStylePatchFields {
-  rect?: PdfRect;
-  /** Tri-state (as `interiorColor`): omitted preserves, a value sets, `null` removes `/BE`. */
-  cloudyIntensity?: number | null;
-  /** Tri-state: omitted preserves, a value sets, `null` removes `/RD`. */
-  rectDifferences?: PdfRectDifferences | null;
-  /** Tri-state: omitted preserves, `null`/`0` flattens, a value sets (needs the box). */
-  rotation?: number | null;
-  /** Tri-state: omitted preserves, `null` removes, a value sets. */
-  unrotatedRect?: PdfRect | null;
-}
-/** Glue type used by each shape kind file to construct its concrete DTO. */
-type ShapeDTO<S extends string> = AnnotationBase & {
-  subtype: S;
-} & ShapeAnnotationFields;
-//#endregion
-//#region src/annotation/kinds/circle/draft.d.ts
-interface CircleDraft extends AnnotationDraftBase, ShapeDraftFields {
-  subtype: 'circle';
-}
-//#endregion
-//#region src/annotation/kinds/circle/dto.d.ts
-type CircleAnnotationDTO = ShapeDTO<'circle'>;
-//#endregion
-//#region src/annotation/kinds/circle/patch.d.ts
-interface CirclePatch extends AnnotationPatchBase, ShapePatchFields {
-  subtype: 'circle';
-}
-//#endregion
-//#region src/annotation/kinds/square/draft.d.ts
-interface SquareDraft extends AnnotationDraftBase, ShapeDraftFields {
-  subtype: 'square';
-}
-//#endregion
-//#region src/annotation/kinds/square/dto.d.ts
-type SquareAnnotationDTO = ShapeDTO<'square'>;
-//#endregion
-//#region src/annotation/kinds/square/patch.d.ts
-interface SquarePatch extends AnnotationPatchBase, ShapePatchFields {
-  subtype: 'square';
-}
-//#endregion
-//#region src/annotation/kinds/vertex.shared.d.ts
-/**
- * Vertex-family-specific fields. The two vertex subtypes (polygon/polyline)
- * carry their geometry as a `/Vertices` point list (ISO 32000 §12.5.6.9)
- * plus the common stroke/fill styling ({@link FilledStyleFields}). Polygon
- * layers a cloudy border (`/BE`) on top; polyline layers line endings
- * (`/LE`); each kind file adds those. (Polygon does not use `/RD` — its
- * geometry is fully described by `/Vertices` + `/Rect`, so `/RD` is for the
- * shape family only.)
- *
- * Like shapes, the engine takes an explicit `/Rect` on the Draft (the v3
- * plugin owns the bounding-box + rotation math, so the engine stays a
- * faithful persistence layer); the DTO inherits `rect` from
- * `AnnotationBase`.
- */
-interface VertexAnnotationFields extends FilledStyleFields {
-  /** `/Vertices` — the ordered point list (PDF user space, y-up). */
-  vertices: PdfPoint[];
-  /**
-   * `/EMBD_Metadata/Rotation` — ADVISORY rotation (degrees, PDF convention). The
-   * vertices are already rotated (they ARE the portable visual); this scalar
-   * just records the applied angle so EmbedPDF can show an oriented selection
-   * box and offer reset. It carries NO `unrotatedRect`, so it is inert for AP
-   * (PDFium ignores a lone `Rotation`).
-   */
-  rotation?: number;
-}
-interface VertexDraftFields extends FilledStyleDraftFields {
-  /** `/Vertices` geometry — required (vertex annotations are not derived). */
-  vertices: PdfPoint[];
-  /** `/Rect` bounding box — required (computed by the caller/plugin). */
-  rect: PdfRect;
-  /** Advisory rotation (deg). See {@link VertexAnnotationFields.rotation}. */
-  rotation?: number | null;
-}
-interface VertexPatchFields extends FilledStylePatchFields {
-  vertices?: PdfPoint[];
-  rect?: PdfRect;
-  /** Tri-state: omitted preserves, `null`/`0` clears the advisory scalar. */
-  rotation?: number | null;
-}
-/** Glue type used by each vertex kind file to construct its concrete DTO. */
-type VertexDTO<S extends string> = AnnotationBase & {
-  subtype: S;
-} & VertexAnnotationFields;
-//#endregion
-//#region src/annotation/kinds/polygon/draft.d.ts
-interface PolygonDraft extends AnnotationDraftBase, VertexDraftFields {
-  subtype: 'polygon';
-  cloudyIntensity?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/polygon/dto.d.ts
-type PolygonAnnotationDTO = VertexDTO<'polygon'> & {
-  /** `/BE` cloudy border intensity; `null` when the border carries no effect. */
-  cloudyIntensity: number | null;
-};
-//#endregion
-//#region src/annotation/kinds/polygon/patch.d.ts
-interface PolygonPatch extends AnnotationPatchBase, VertexPatchFields {
-  subtype: 'polygon';
-  /** Tri-state (as `interiorColor`): omitted preserves, a value sets, `null` removes `/BE`. */
-  cloudyIntensity?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/polyline/draft.d.ts
-interface PolylineDraft extends AnnotationDraftBase, VertexDraftFields {
-  subtype: 'polyline';
-  lineEndings?: LineEndings;
-}
-//#endregion
-//#region src/annotation/kinds/polyline/dto.d.ts
-type PolylineAnnotationDTO = VertexDTO<'polyline'> & {
-  lineEndings: LineEndings;
-};
-//#endregion
-//#region src/annotation/kinds/polyline/patch.d.ts
-interface PolylinePatch extends AnnotationPatchBase, VertexPatchFields {
-  subtype: 'polyline';
-  lineEndings?: LineEndings;
-}
-//#endregion
-//#region src/annotation/kinds/line/draft.d.ts
-interface LineDraft extends AnnotationDraftBase, FilledStyleDraftFields {
-  subtype: 'line';
-  /** `/L` the two endpoints — required. */
-  linePoints: LinePoints;
-  /** `/Rect` bounding box — required (computed by the caller/plugin). */
-  rect: PdfRect;
-  lineEndings?: LineEndings;
-  /** Advisory rotation (deg). */
-  rotation?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/line/dto.d.ts
-type LineAnnotationDTO = AnnotationBase & {
-  subtype: 'line';
-  /** `/L` the two endpoints of the line. */
-  linePoints: LinePoints;
-  /** `/LE` the start/end line endings. */
-  lineEndings: LineEndings;
-  /** `/EMBD_Metadata/Rotation` — advisory rotation (deg); the endpoints are
-   *  already rotated. No `unrotatedRect`, so it is inert for AP. */
-  rotation?: number;
-} & FilledStyleFields;
-//#endregion
-//#region src/annotation/kinds/line/patch.d.ts
-interface LinePatch extends AnnotationPatchBase, FilledStylePatchFields {
-  subtype: 'line';
-  linePoints?: LinePoints;
-  rect?: PdfRect;
-  lineEndings?: LineEndings;
-  rotation?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/link/draft.d.ts
-/**
- * Creates a link annotation. `target: null` is allowed — the authoring flow
- * is create-then-edit (drag the rect first, set the destination/URI from the
- * selection editor) — and only `goto`/`uri` targets are writable (see
- * {@link PdfLinkTargetWritable}).
- *
- * To group the link to another annotation (v2's attached links), pass the
- * base draft's `inReplyTo` + `replyType: 'group'` — relationship writing is
- * kind-agnostic.
- */
-interface LinkDraft extends AnnotationDraftBase {
-  subtype: 'link';
-  /** `/Rect` — required; a link IS its hit rectangle. */
-  rect: PdfRect;
-  target: PdfLinkTargetWritable | null;
-}
-//#endregion
-//#region src/annotation/kinds/link/dto.d.ts
-/**
- * Link annotation (`/Subtype /Link`): an invisible hit rectangle over page
- * content that navigates somewhere. The DTO carries the NORMALIZED target
- * (see {@link PdfLinkTarget} — `/Dest` and `/A GoTo` both read as `goto`)
- * plus the base shell; links draw nothing of their own in v1 (any visible
- * border a PDF specifies still renders through the page raster).
- *
- * Links ride the base relationship fields like every kind: a link grouped
- * to another annotation (the Apryse/v2 "attached link" pattern) reads as
- * `inReplyTo` + `replyType: 'group'`.
- */
-interface LinkAnnotationDTO extends AnnotationBase {
-  subtype: 'link';
-  /** `null` = a dead link (no `/A`, no `/Dest`) — legal PDF, reported as-is. */
-  target: PdfLinkTarget | null;
-}
-//#endregion
-//#region src/annotation/kinds/link/patch.d.ts
-/**
- * Move (`rect`) and retarget a link. `target` is three-state: `undefined`
- * leaves it, a value REPLACES the `/A` action (any stray direct `/Dest`
- * is stripped — the spec forbids both), and `null` CLEARS the target
- * entirely (`/A` and `/Dest` both removed → a dead link). Only
- * `goto`/`uri` targets are writable.
- */
-interface LinkPatch extends AnnotationPatchBase {
-  subtype: 'link';
-  rect?: PdfRect;
-  target?: PdfLinkTargetWritable | null;
-}
-//#endregion
-//#region src/annotation/kinds/ink/draft.d.ts
-interface InkDraft extends AnnotationDraftBase, GeometryStyleDraftFields {
-  subtype: 'ink';
-  intent?: InkIntent;
-  /** `/InkList` — required (the freehand strokes). */
-  inkList: InkList;
-  /** `/Rect` bounding box — required (computed by the caller/plugin). */
-  rect: PdfRect;
-  /** Advisory rotation (deg). */
-  rotation?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/ink/dto.d.ts
-type InkAnnotationDTO = AnnotationBase & {
-  subtype: 'ink';
-  /** Normalized `/IT`; null for ordinary pen ink. */
-  intent: InkIntent | null;
-  /** `/InkList` — the freehand pen strokes (array of point paths). */
-  inkList: InkList;
-  /** `/EMBD_Metadata/Rotation` — advisory rotation (deg); strokes are already
-   *  rotated. No `unrotatedRect`, so it is inert for AP. */
-  rotation?: number;
-} & GeometryStyleFields;
-//#endregion
-//#region src/annotation/kinds/ink/patch.d.ts
-interface InkPatch extends AnnotationPatchBase, GeometryStylePatchFields {
-  subtype: 'ink';
-  intent?: InkIntent;
-  inkList?: InkList;
-  rect?: PdfRect;
-  rotation?: number | null;
-}
-//#endregion
-//#region src/annotation/kinds/free-text/draft.d.ts
-interface FreeTextDraft extends AnnotationDraftBase {
-  subtype: 'free-text';
-  /** `/IT` intent — required (selects plain text box vs callout). */
-  intent: FreeTextIntent;
-  /**
-   * A PDF standard font name, or the `key` of a font registered through
-   * `engine.fonts`. A registered key makes the `/DA` reference that runtime
-   * font and embeds a per-annotation glyph subset on save (local engine only).
-   */
-  fontFamily: FreeTextFont;
-  fontSize: number;
-  textAlign: TextAlignment;
-  /** `/Rect` bounding box — required (computed by the caller/plugin). */
-  rect: PdfRect;
-  /** `/DA` colour (border + default text). */
-  color?: Color;
-  /** Text colour override (`TextColor`). Omit to let text follow `color`. */
-  fontColor?: Color;
-  /** `/C` box background. `null`/omitted = transparent. */
-  interiorColor?: Color | null;
-  opacity?: number;
-  strokeWidth?: number;
-  borderStyle?: AnnotationBorderStyle;
-  dashArray?: number[];
-  rectDifferences?: PdfRectDifferences | null;
-  calloutLine?: CalloutLine;
-  lineEnding?: LineEnding;
-  rotation?: number | null;
-  unrotatedRect?: PdfRect | null;
-}
-//#endregion
-//#region src/annotation/kinds/free-text/dto.d.ts
-/**
- * FreeText (and Callout) annotation. One kind covers both: a plain text box
- * (`intent: 'free-text'`) and a callout (`intent: 'free-text-callout'`) which
- * adds a `/CL` leader line.
- *
- * Color model (see the kind docs): `color` is the `/DA` colour — it paints the
- * border and, by default, the text. `fontColor` (optional) overrides just the
- * text via the `TextColor` channel. `interiorColor` is the `/C` box background
- * (`null` when transparent).
- */
-type FreeTextAnnotationDTO = AnnotationBase & {
-  subtype: 'free-text';
-  /** `/IT` intent. */
-  intent: FreeTextIntent;
-  /** `/DA` font. */
-  fontFamily: StandardFont;
-  /** `/DA` font size, in points. */
-  fontSize: number;
-  /** `/Q` horizontal text alignment. */
-  textAlign: TextAlignment;
-  /** `/DA` colour: the border colour and the default text colour. */
-  color: Color;
-  /** Text colour override (`TextColor`). Absent when the text follows `color`. */
-  fontColor?: Color;
-  /** `/C` box background. `null` when the box is transparent. */
-  interiorColor: Color | null;
-  /** `/CA` constant opacity, 0..1. */
-  opacity: number;
-  /** `/BS /W` border width, in points. */
-  strokeWidth: number;
-  /** `/BS /S` border style. */
-  borderStyle: AnnotationBorderStyle;
-  /** `/BS /D` dash pattern. Only meaningful when `borderStyle === 'dashed'`. */
-  dashArray?: number[];
-  /** `/RD` inset of the drawn box from `/Rect`; `null` when absent. */
-  rectDifferences: PdfRectDifferences | null;
-  /** `/CL` leader line (2 or 3 points). */
-  calloutLine?: CalloutLine;
-  /** `/LE` ending drawn at the called-out end of the leader line. */
-  lineEnding?: LineEnding;
-  /** `/EMBD_Metadata/Rotation` — degrees, normalized `[0,360)`. */
-  rotation?: number;
-  /** `/EMBD_Metadata/UnrotatedRect` — the logical box (required when rotation != 0). */
-  unrotatedRect?: PdfRect;
-};
-//#endregion
-//#region src/annotation/kinds/free-text/patch.d.ts
-interface FreeTextPatch extends AnnotationPatchBase {
-  subtype: 'free-text';
-  intent?: FreeTextIntent;
-  /** A PDF standard font name or a registered font `key`. See `FreeTextDraft`. */
-  fontFamily?: FreeTextFont;
-  fontSize?: number;
-  textAlign?: TextAlignment;
-  rect?: PdfRect;
-  color?: Color;
-  fontColor?: Color;
-  interiorColor?: Color | null;
-  opacity?: number;
-  strokeWidth?: number;
-  borderStyle?: AnnotationBorderStyle;
-  dashArray?: number[];
-  /** Tri-state: omitted preserves, a value sets, `null` removes `/RD`. */
-  rectDifferences?: PdfRectDifferences | null;
-  calloutLine?: CalloutLine;
-  lineEnding?: LineEnding;
-  /** Tri-state: omitted preserves, `null`/`0` flattens, a value sets (needs the box). */
-  rotation?: number | null;
-  /** Tri-state: omitted preserves, `null` removes, a value sets. */
-  unrotatedRect?: PdfRect | null;
-}
-//#endregion
-//#region src/annotation/kinds/caret/draft.d.ts
-interface CaretDraft extends AnnotationDraftBase, ColorStyleDraftFields {
-  subtype: 'caret';
-  /** `/IT /Replace` for the primary of a replace-text pair. */
-  intent?: CaretIntent;
-  /** `/Rect` bounding box — required (computed by the caller/plugin). */
-  rect: PdfRect;
-  /** `/RD` inset of the drawn caret from `/Rect`. */
-  rectDifferences?: PdfRectDifferences | null;
-}
-//#endregion
-//#region src/annotation/kinds/caret/dto.d.ts
-/**
- * Caret annotation — a visual marker for a proposed text insertion or edit
- * point. It carries no geometry of its own beyond `/Rect`: just a `/C` color,
- * `/CA` opacity, and an optional `/RD` inset of the drawn symbol from `/Rect`.
- */
-type CaretAnnotationDTO = AnnotationBase & ColorStyleFields & {
-  subtype: 'caret';
-  /** Normalized `/IT`; null for an ordinary caret without a text-edit intent. */
-  intent: CaretIntent | null;
-  /** `/RD` inset of the drawn caret from `/Rect`; `null` when absent. */
-  rectDifferences: PdfRectDifferences | null;
-};
-//#endregion
-//#region src/annotation/kinds/caret/patch.d.ts
-interface CaretPatch extends AnnotationPatchBase, ColorStylePatchFields {
-  subtype: 'caret';
-  intent?: CaretIntent;
-  rect?: PdfRect;
-  /** Tri-state: omitted preserves, a value sets, `null` removes `/RD`. */
-  rectDifferences?: PdfRectDifferences | null;
-}
-//#endregion
-//#region src/annotation/kinds/text/draft.d.ts
-/**
- * `/Name` icon of a text (sticky-note) annotation — ISO 32000 §12.5.6.4.
- * The appearance generator currently draws one note glyph for every icon;
- * the name still round-trips so other viewers can render their own set.
- */
-type NoteIcon = 'comment' | 'key' | 'note' | 'help' | 'new-paragraph' | 'paragraph' | 'insert';
-/**
- * Text annotation ("sticky note", `/Subtype /Text`). The generated
- * appearance is a fixed 20×20 icon anchored at the `/Rect`'s bottom-left
- * corner, filled with `color` (`/C`, default yellow) and outlined with a
- * luminance-contrast stroke. Note tools typically also set
- * `flags: { print: true, noZoom: true, noRotate: true }`.
- */
-interface TextDraft extends AnnotationDraftBase, ColorStyleDraftFields {
-  subtype: 'text';
-  /** `/Rect` — the icon renders 20×20 from this rect's bottom-left corner. */
-  rect: PdfRect;
-  /** `/Name` icon. Default `'note'` (the ISO 32000 default). */
-  icon?: NoteIcon;
-}
-//#endregion
-//#region src/annotation/kinds/text/dto.d.ts
-/**
- * Text annotation ("sticky note") — an icon-sized comment marker whose
- * conversation text lives in the base `contents` (and replies via
- * `inReplyTo`). Popup state (`/Popup`, `/Open`) is presentation-layer and
- * deliberately not modeled here.
- */
-type TextAnnotationDTO = AnnotationBase & ColorStyleFields & {
-  subtype: 'text';
-  /** `/Name` icon; an absent `/Name` reads as `'note'` (the ISO default). */
-  icon: NoteIcon;
-};
-//#endregion
-//#region src/annotation/kinds/text/patch.d.ts
-interface TextPatch extends AnnotationPatchBase, ColorStylePatchFields {
-  subtype: 'text';
-  rect?: PdfRect;
-  icon?: NoteIcon;
-}
-//#endregion
-//#region src/annotation/kinds/stamp/draft.d.ts
-/**
- * How the stamp's content is scaled into `/Rect` (CSS `object-fit`
- * vocabulary; maps onto the native `EPDF_STAMP_FIT` policies):
- * `'contain'` preserves aspect and stays fully visible, `'cover'`
- * preserves aspect and fills the box (may crop), `'fill'` stretches.
- */
-type StampFit = 'contain' | 'cover' | 'fill';
-/**
- * Wire form of {@link StampDraft}: pure JSON, validated by the single Zod
- * schema on client, worker, and server. The `source` bytes travel
- * out-of-band under the referenced resource key.
- */
-interface StampWireDraft extends AnnotationDraftBase {
-  subtype: 'stamp';
-  rect: PdfRect;
-  source: ResourceRef;
-  name?: string;
-  fit?: StampFit;
-  rotation?: number | null;
-  unrotatedRect?: PdfRect | null;
-}
-//#endregion
-//#region src/annotation/kinds/stamp/dto.d.ts
-/**
- * Stamp annotation (`/Subtype /Stamp`, ISO 32000 §12.5.6.12).
- *
- * The DTO carries no binary fields: the stamp's visual content lives in its
- * `/AP` appearance stream inside the document, and is displayed via
- * `renderAppearanceImages()` like every other baked appearance.
- */
-type StampAnnotationDTO = AnnotationBase & {
-  subtype: 'stamp';
-  /** `/Name` — advisory stamp label ('Approved', 'Draft', …). */
-  name: string | null;
-  /** Rotation (deg) from `/EMBD_Metadata`. */
-  rotation?: number;
-  /** Pre-rotation `/Rect` from `/EMBD_Metadata` (present with `rotation`). */
-  unrotatedRect?: PdfRect;
-};
-/** Wire form of {@link StampPatch} — see {@link StampWireDraft} for the rules. */
-interface StampWirePatch extends AnnotationPatchBase {
-  subtype: 'stamp';
-  rect?: PdfRect;
-  source?: ResourceRef;
-  name?: string;
-  fit?: StampFit;
-  rotation?: number | null;
-  unrotatedRect?: PdfRect | null;
-}
-//#endregion
-//#region src/annotation/kinds/file-attachment/dto.d.ts
-/**
- * FileAttachment annotation. The DTO carries the attached file's METADATA
- * only — bytes never ride a listing. Download them explicitly via
- * `PageAnnotationsService.downloadFile(ref)`.
- */
-type FileAttachmentAnnotationDTO = AnnotationBase & ColorStyleFields & {
-  subtype: 'file-attachment';
-  /** `/Name` icon; an absent `/Name` reads as `'push-pin'` (the ISO default). */
-  icon: FileAttachmentIcon;
-  /** Metadata of the attached file (`/FS` filespec projection). */
-  file: AttachmentFileInfo;
-};
-//#endregion
-//#region src/annotation/kinds/file-attachment/patch.d.ts
-/**
- * The attached `file` is deliberately NOT patchable — bytes enter once at
- * create; replacing a file is a new attachment (delete + create). Only
- * the icon presentation and base fields can change.
- */
-interface FileAttachmentPatch extends AnnotationPatchBase, ColorStylePatchFields {
-  subtype: 'file-attachment';
-  rect?: PdfRect;
-  icon?: FileAttachmentIcon;
-}
-//#endregion
-//#region src/annotation/kinds/widget/draft.d.ts
-/**
- * Creates an INERT widget annotation — placed and styled, but not yet a
- * form control. Adoption (`doc.forms.attachWidget`, or inline placement in
- * `doc.forms.createField`) is what binds it to a field and bakes the
- * family-correct appearance.
- */
-interface WidgetDraft extends AnnotationDraftBase, WidgetStyleDraftFields {
-  subtype: 'widget';
-  /** `/Rect` — required; widgets are box-placed. */
-  rect: PdfRect;
-}
-//#endregion
-//#region src/annotation/kinds/widget/dto.d.ts
-/**
- * A form widget annotation: the page-scoped VIEW of a logical form field.
- * The value, options, and field semantics live on `doc.forms`; this DTO
- * carries the widget plane only — geometry, appearance, and the join key.
- *
- * Widgets are readable and patchable like every kind, and creatable as
- * INERT annotations (no field). Adoption by a field — and deletion while
- * adopted — go through `doc.forms` (`attachWidget` / `deleteField`), which
- * own the field-tree bookkeeping.
- */
-interface WidgetAnnotationDTO extends AnnotationBase, WidgetStyleFields {
-  subtype: 'widget';
-  /**
-   * Object number of the owning field's dictionary, or `0` when the
-   * widget is unattached (inert). Join key to `FormFieldDTO.ref` /
-   * `FormFieldWidget.annotObjectNumber` on the forms side.
-   */
-  fieldObjectNumber: number;
-  /**
-   * The owning field's family when attached — what kind of control this
-   * widget renders. `'unknown'` for inert widgets (no field yet). Client
-   * kind tables key per-family editing surfaces (a radio widget has no
-   * font) off this without consulting the forms snapshot.
-   */
-  fieldFamily: FormFieldFamily;
-}
-//#endregion
-//#region src/annotation/kinds/widget/patch.d.ts
-/**
- * Move (`rect`) and restyle a widget through the annotation plane — the
- * same path every other kind uses. When the widget is attached to a field
- * the engine re-bakes the family-correct appearance after the patch.
- */
-interface WidgetPatch extends AnnotationPatchBase, WidgetStylePatchFields {
-  subtype: 'widget';
-  rect?: PdfRect;
-}
-//#endregion
-//#region src/annotation/kinds/redact/draft.d.ts
-interface RedactDraft extends AnnotationDraftBase {
-  subtype: 'redact';
-  /**
-   * `/Rect` bounding box — required (for a text redaction, the caller
-   * computes it as the quads' bounds).
-   */
-  rect: PdfRect;
-  /** `/QuadPoints`. Omit (or send empty) for an area redaction. */
-  quadPoints?: PdfQuad[];
-  /** `/C` marking-stage outline colour. */
-  color?: Color;
-  /** `/CA` marking-stage opacity. The applied overlay always paints opaque. */
-  opacity?: number;
-  /** `/IC` fill painted after apply. `null`/omitted = region left transparent. */
-  interiorColor?: Color | null;
-  /**
-   * `/OverlayText`. When set, the writer also emits a `/DA` (ISO requires
-   * one alongside `/OverlayText`), defaulting any omitted triple member.
-   */
-  overlayText?: string;
-  /** `/Repeat` — tile the label to fill the region. */
-  repeat?: boolean;
-  /**
-   * `/DA` font: a PDF standard font name, or the `key` of a font registered
-   * through `engine.fonts` (embeds a per-annotation glyph subset on save —
-   * local engine only). See `FreeTextDraft`.
-   */
-  fontFamily?: FreeTextFont;
-  /** `/DA` font size, in points. `0` = auto-fit the label to the region. */
-  fontSize?: number;
-  /** `/DA` colour: the label text colour. */
-  fontColor?: Color;
-  /** `/Q` label alignment. */
-  textAlign?: TextAlignment;
-}
-//#endregion
-//#region src/annotation/kinds/redact/dto.d.ts
-/**
- * Redaction annotation (`/Redact`, ISO 32000-2 12.5.6.23). The annotation is
- * the non-destructive MARKING stage: it declares what should be removed and
- * what the region must look like afterwards. The destructive APPLY is a
- * separate document operation, not an annotation mutation.
- *
- * Color model: `color` is `/C` — the marking-stage outline (the universal
- * `/C` field every family shares). `interiorColor` is `/IC` — the fill
- * painted where content was removed once the redaction is applied (`null` =
- * region left transparent, the ISO default).
- *
- * Label model: `overlayText` (`/OverlayText`) is drawn over the applied
- * region, styled by the `/DA` triple (`fontFamily`/`fontSize`/`fontColor`)
- * and `/Q` (`textAlign`); `repeat` (`/Repeat`) tiles it to fill the region.
- * A pre-baked `/RO` overlay stream, when present in a file, takes precedence
- * over all of these at apply time — it is an appearance artifact and is not
- * surfaced on the DTO.
- */
-type RedactAnnotationDTO = AnnotationBase & ColorStyleFields & {
-  subtype: 'redact';
-  /**
-   * `/QuadPoints` — the regions of a text redaction. Empty for an area
-   * redaction, where `/Rect` itself is the removal region (ISO 32000-2).
-   */
-  quadPoints: PdfQuad[];
-  /** `/IC` fill painted after apply. `null` when the region stays transparent. */
-  interiorColor: Color | null;
-  /** `/OverlayText` label. `null` when the redaction has no label. */
-  overlayText: string | null;
-  /** `/Repeat` — tile the label to fill the region. */
-  repeat: boolean;
-  /** `/DA` font. */
-  fontFamily: StandardFont;
-  /** `/DA` font size, in points. `0` = auto-fit the label to the region. */
-  fontSize: number;
-  /** `/DA` colour: the label text colour. */
-  fontColor: Color;
-  /** `/Q` label alignment. */
-  textAlign: TextAlignment;
-};
-//#endregion
-//#region src/annotation/kinds/redact/patch.d.ts
-interface RedactPatch extends AnnotationPatchBase {
-  subtype: 'redact';
-  rect?: PdfRect;
-  quadPoints?: PdfQuad[];
-  color?: Color;
-  opacity?: number;
-  interiorColor?: Color | null;
-  /** `/OverlayText`. `null` clears the label. */
-  overlayText?: string | null;
-  repeat?: boolean;
-  /**
-   * `/DA` triple. Because `/DA` packs font, size, and colour into one string,
-   * send the full triple (`fontFamily` + `fontSize` + `fontColor`) together
-   * when changing any of them — same rule as `FreeTextPatch`.
-   */
-  fontFamily?: FreeTextFont;
-  fontSize?: number;
-  fontColor?: Color;
-  textAlign?: TextAlignment;
-}
-//#endregion
-//#region src/annotation/kinds/unsupported/dto.d.ts
-/**
- * Forward-compat fallback. Emitted whenever the engine encounters a
- * subtype it doesn't (yet) have a dedicated reader for. The wire format
- * is stable: when a per-subtype reader lands later, the engine starts
- * producing the dedicated DTO without breaking older clients.
- */
-interface UnsupportedAnnotationDTO extends AnnotationBase {
-  subtype: 'unsupported';
-  /** PDFium's `FPDFAnnot_GetSubtype` integer code for diagnostics. */
-  rawSubtypeCode: number;
-  /** Best-effort string subtype name from the PDF dict, when readable. */
-  rawSubtypeName: string | null;
-}
-//#endregion
-//#region src/annotation/kinds/index.d.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.
- */
-declare const ANNOTATION_KINDS: readonly [AnnotationKindModule<"highlight", HighlightAnnotationDTO, HighlightDraft, HighlightPatch>, AnnotationKindModule<"underline", UnderlineAnnotationDTO, UnderlineDraft, UnderlinePatch>, AnnotationKindModule<"squiggly", SquigglyAnnotationDTO, SquigglyDraft, SquigglyPatch>, AnnotationKindModule<"strikeout", StrikeoutAnnotationDTO, StrikeoutDraft, StrikeoutPatch>, AnnotationKindModule<"circle", CircleAnnotationDTO, CircleDraft, CirclePatch>, AnnotationKindModule<"square", SquareAnnotationDTO, SquareDraft, SquarePatch>, AnnotationKindModule<"polygon", PolygonAnnotationDTO, PolygonDraft, PolygonPatch>, AnnotationKindModule<"polyline", PolylineAnnotationDTO, PolylineDraft, PolylinePatch>, AnnotationKindModule<"line", LineAnnotationDTO, LineDraft, LinePatch>, AnnotationKindModule<"link", LinkAnnotationDTO, LinkDraft, LinkPatch>, AnnotationKindModule<"ink", InkAnnotationDTO, InkDraft, InkPatch>, AnnotationKindModule<"free-text", FreeTextAnnotationDTO, FreeTextDraft, FreeTextPatch>, AnnotationKindModule<"caret", CaretAnnotationDTO, CaretDraft, CaretPatch>, AnnotationKindModule<"text", TextAnnotationDTO, TextDraft, TextPatch>, AnnotationKindModule<"stamp", StampAnnotationDTO, StampWireDraft, StampWirePatch>, AnnotationKindModule<"file-attachment", FileAttachmentAnnotationDTO, FileAttachmentWireDraft, FileAttachmentPatch>, AnnotationKindModule<"widget", WidgetAnnotationDTO, WidgetDraft, WidgetPatch>, AnnotationKindModule<"redact", RedactAnnotationDTO, RedactDraft, RedactPatch>, AnnotationKindModule<"unsupported", UnsupportedAnnotationDTO, never, never>];
-type AnnotationKind = (typeof ANNOTATION_KINDS)[number];
-type DTOFromKind<K> = K extends AnnotationKindModule<infer _S, infer D, infer _Dr, infer _Pa> ? D : never;
-/** Discriminated union over `subtype`, derived from the registry. */
-type AnnotationDTO = DTOFromKind<AnnotationKind>;
-//#endregion
-export { FormSnapshot as n, SearchQuery as r, AnnotationDTO as t };
-//# sourceMappingURL=AnnotationListSnapshot-W0RCsyDE-dWna4TTJ.d.ts.map