@embedpdf/plugin-form 3.0.0-next.14 → 3.0.0-next.15

package/dist/types-DRirhZKr.d.ts

@@ -1,309 +0,0 @@
-import { ActionContext, ActionDiagnostic, ActionOrigin, ActionSubmitRequest, ActionTriggerResult, PdfAnnotationEventKind, SubmitIntent } from "@embedpdf/plugin-actions/contract";
-import { AnnotationPropsPatch, ClickCreate } from "@embedpdf/plugin-annotation/contract";
-import { AnnotationRef, FormDataExport, FormDataFormat, FormEffect, FormEffectsResult, FormFieldDTO, FormFieldFamily, FormFieldOption, FormFieldPatch, FormFieldRef, FormFieldValue, FormImportResult, FormRepairOptions, FormRepairResult, FormSetValueResult, FormSnapshot, PdfActionTargetRef, WidgetAppearance } from "@embedpdf/engine-core/runtime";
-import { ScriptDiagnostic, ScriptExecutionError, ScriptUiEffect } from "@embedpdf/core-acrojs";
-//#region src/core/model.d.ts
-/** A content-space box (top-left origin, y-down, PDF points). */
-interface Box {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-/** Stable client key for a field: object number when durable, else FQN. */
-type FieldKey = string;
-declare const fieldKeyOf: (field: {
-  fieldObjectNumber: number;
-  name: string;
-}) => FieldKey;
-interface Model {
-  /** Engine truth; replaced wholesale on refresh, patched on write-backs. */
-  snapshot: FormSnapshot | null;
-  /** fieldKey → index into snapshot.fields. */
-  byKey: Record<FieldKey, number>;
-  /** annotObjectNumber → index into snapshot.fields (widget → field join). */
-  byWidget: Record<number, number>;
-  /** Fields with an in-flight engine write (disables their controls). */
-  writing: Record<FieldKey, true>;
-  /**
-   * Widget geometry per page: annotObjectNumber → content-space box. Fed by
-   * the shell from the WIDGET plane (one annotations read per page); value
-   * writes never move widgets, so this survives snapshot refreshes and is
-   * only cleared on structural form events.
-   */
-  geom: Record<number, Record<number, Box> | undefined>;
-  /** Bumped on every change — cheap equality for memoized projections. */
-  seq: number;
-}
-/** A widget hit: the annotation under the point and the field it belongs to. */
-interface WidgetHit {
-  annotObjectNumber: number;
-  field: FormFieldDTO;
-  /** The widget's content-space box. */
-  box: Box;
-}
-//#endregion
-//#region src/core/fill-items.d.ts
-interface FillItemBase {
-  key: FieldKey;
-  /** Widget identity — joins to the annotation plane. */
-  annotObjectNumber: number;
-  box: Box;
-  /** Read-only field or write in flight: render, don't accept input. */
-  disabled: boolean;
-  /** Accessible name: /TU when present, else the fully qualified name. */
-  label: string;
-}
-type FillItem = FillItemBase & ({
-  control: 'text';
-  value: string;
-  multiline: boolean;
-  password: boolean;
-  maxLength: number | null;
-  comb: boolean;
-} | {
-  control: 'toggle';
-  kind: 'checkbox' | 'radio';
-  checked: boolean;
-  onState: string;
-} | {
-  control: 'choice';
-  kind: 'combo' | 'list';
-  edit: boolean;
-  multi: boolean;
-  options: FormFieldOption[];
-  selected: string[];
-} | {
-  control: 'button';
-} |
-/**
- * A signature field's widget. `signed` = it carries a `/V` (a signature
- * dictionary): the field is final and its appearance sealed — the
- * control inspects rather than signs. Unsigned: "sign here" — the
- * signing act itself belongs to the signature plugin.
- */
-{
-  control: 'signature';
-  signed: boolean;
-});
-//#endregion
-//#region src/tools.d.ts
-/** The families the palette can author (push buttons are not authorable). */
-type AuthorableFormFamily = Exclude<FormFieldFamily, 'pushbutton' | 'unknown'>;
-interface FormToolDef {
-  id: string;
-  /** The field family `placeField` commits (the FORM plane's vocabulary). */
-  family: AuthorableFormFamily;
-  /** The client kind the ANNOTATION registry routes on (props panel).
-   *  Not a PDF subtype — every widget is PDF `widget`; this is the view. */
-  visualKind: 'widget-text' | 'widget-choice' | 'widget-toggle' | 'widget-box';
-  /** What a bare click places (box policies only — fields are boxes). */
-  clickCreate: Extract<ClickCreate, {
-    width: number;
-  }>;
-  /** Seed drawing defaults: a placed field is VISIBLE (white box, gray
-   *  border) and restylable per tool through the shared style panel. */
-  defaults: AnnotationPropsPatch;
-  cursor: string;
-}
-declare const FORM_TOOLS: readonly FormToolDef[];
-declare const FORM_TOOL_BY_ID: ReadonlyMap<string, FormToolDef>;
-//#endregion
-//#region src/types.d.ts
-interface FormState {
-  model: Model;
-}
-/** The scripting switch moved to `actionsPlugin({ javascript })` (D8). */
-interface FormPluginOptions {}
-type FormCommitStatus = 'applied' | 'unchanged' | 'rejected' | 'failed';
-interface FormCommitResult {
-  status: FormCommitStatus;
-  scripted: boolean;
-  effectsResult: FormEffectsResult | null;
-  uiEffects: FormUiEffect[];
-  diagnostics: ScriptDiagnostic[];
-  error?: ScriptExecutionError;
-}
-/**
- * One DOM-free UI request produced by the curated Acrobat scripting surface.
- * `phase` says WHO asked: `'boot'` = a document-open script (Adobe's
- * version-check boilerplate lives here — embedders typically suppress these
- * nags), `'user'` = a script triggered by the user's own interaction (a
- * validation alert — show it).
- */
-type FormUiEffect = ScriptUiEffect & {
-  /** WHO asked, script-model axis: `'boot'` = a name-tree/document-open boot
-   *  script, `'user'` = a runtime script. */
-  phase: 'boot' | 'user';
-  /**
-   * The dispatch-origin axis (present when the script ran inside an action
-   * dispatch): a lifecycle `/OpenAction` script is NOT a name-tree boot
-   * script — the two axes are deliberately separate. Providers use this for
-   * the default visibility matrix (suppress lifecycle alerts, block
-   * non-user print); embedder handlers receive it and may decide otherwise.
-   */
-  origin?: ActionOrigin;
-};
-/** Input for {@link FormCapability.placeField}. */
-interface PlaceFieldInput {
-  family: AuthorableFormFamily;
-  pageObjectNumber: number;
-  /** Content-space LOGICAL field box (no visual padding semantics). */
-  box: Box;
-  /** Widget styling in the engine vocabulary (`WidgetAppearance`). Convert a
-   *  tool's flat CSS defaults with `widgetAppearanceFromProps` from
-   *  `@embedpdf/plugin-annotation`. Omitted → the engine's bare defaults. */
-  appearance?: WidgetAppearance;
-}
-/** What {@link FormCapability.placeField} created. */
-interface PlacedField {
-  field: FormFieldDTO;
-  /** The widget placed on the requested page (join key to the annotation
-   *  plane for auto-selection), or null when the engine reported none. */
-  widget: FormFieldDTO['widgets'][number] | null;
-}
-type FormAction = {
-  type: 'SET_MODEL';
-  model: Model;
-};
-/**
- * The form plugin's public capability: the FIELD plane. Widgets stay
- * annotations (geometry/appearance live there); this surface owns values,
- * interchange, and the fill-mode projection.
- */
-interface FormCapability {
-  /** The current reconciled form state (null until the first load lands). */
-  snapshot(): FormSnapshot | null;
-  /** Re-read the form from the engine (imports/repair/remote bursts). */
-  refresh(): Promise<void>;
-  /** Fill controls for one page — content-space, framework-agnostic. */
-  fillItems(pageObjectNumber: number): FillItem[];
-  /**
-   * The fill control for ONE widget, by annotation object number — the join
-   * the annotation-plane render layer uses (its RenderItem carries the live
-   * box, so this item's `box` is advisory). Reference-stable per model change.
-   * Null until the snapshot lands, or for families with no fill control.
-   */
-  fillItem(annotObjectNumber: number): FillItem | null;
-  /** Make sure a page's widget geometry is loaded (idempotent, lazy). */
-  ensureGeom(pageObjectNumber: number): void;
-  field(key: FieldKey): FormFieldDTO | null;
-  fieldForWidget(annotObjectNumber: number): FormFieldDTO | null;
-  /**
-   * The widget under a content-space point on a page (any family), with
-   * its field — the hit test a sibling plugin runs on a pointer sample
-   * before deciding what a click means (a mark dropped over a signature
-   * field). The model's own geometry answers when it is loaded; until then
-   * the annotation plane's live boxes do, so the first click on a page
-   * already resolves. The smallest containing widget wins.
-   */
-  widgetAt(pageObjectNumber: number, point: {
-    x: number;
-    y: number;
-  }): WidgetHit | null;
-  /** Commit a text value (call on blur/Enter — keystrokes stay local). */
-  setText(key: FieldKey, value: string): Promise<void>;
-  /** Toggle a checkbox/radio widget by its on-state; null clears the group. */
-  toggle(key: FieldKey, onState: string | null): Promise<void>;
-  /** Select choice options by export value. */
-  choose(key: FieldKey, values: string[]): Promise<void>;
-  /** Commit one originating-client value transaction, including K/V/C/F scripts when enabled. */
-  commitValue(ref: FormFieldRef, value: FormFieldValue): Promise<FormCommitResult>;
-  /**
-   * Execute one widget's `/A` activation. With the actions plugin installed
-   * the FULL tree is delegated to its dispatcher (Hide/ResetForm buttons work
-   * even with scripting off) — `kind: 'dispatched'`; without it, today's
-   * scripting-transaction path runs — `kind: 'form'`.
-   */
-  activateWidget(key: FieldKey, annotationRef: AnnotationRef): Promise<WidgetActivationResult>;
-  /**
-   * Report one widget DOM event (pointer enter/leave, down/up, focus/blur).
-   * With the actions plugin present the matching `/AA` tree dispatches
-   * (hover rides the shared coalescing pump; `/A` shadows `/AA U` per ISO
-   * Table 197); without it — or without a tree — this is a cheap no-op.
-   * Fire-and-forget by design: results surface via the actions events.
-   */
-  notifyWidgetEvent(key: FieldKey, ref: AnnotationRef, event: PdfAnnotationEventKind): void;
-  /** Restore a field to its /DV default. */
-  reset(key: FieldKey): Promise<void>;
-  /** Raw engine passthrough for anything the sugar above doesn't cover. */
-  setValue(ref: FormFieldRef, value: FormFieldValue): Promise<FormSetValueResult>;
-  exportData(format?: FormDataFormat): Promise<FormDataExport>;
-  importData(data: Uint8Array | ArrayBuffer, format?: FormDataFormat): Promise<FormImportResult>;
-  repair(options?: FormRepairOptions): Promise<FormRepairResult>;
-  /**
-   * Create a field of `family` with one styled widget at a content-space box
-   * — the palette tools' commit, and the programmatic authoring entry (works
-   * with NO annotation plugin: a pure `doc.forms` call). The box is clamped
-   * to the page; sizing policy (click default vs drag rect) is the caller's.
-   * The field gets a deterministic auto-name (`text_1`, …; rename in the
-   * field panel). Resolves AFTER the annotation plane (when present) has
-   * re-read the page, so the returned widget is immediately selectable.
-   */
-  placeField(input: PlaceFieldInput): Promise<PlacedField>;
-  /** The page's content box (`{0,0,w,h}`) — page-bound placement math. */
-  pageBox(pageObjectNumber: number): Box | null;
-  /** Field-plane properties: name, required, options, default value. */
-  updateField(key: FieldKey, patch: FormFieldPatch): Promise<void>;
-  /** Delete the field and every widget of it (cascades on the page). */
-  deleteField(key: FieldKey): Promise<void>;
-  /** Unlink one widget: it stays as an inert annotation, the field survives. */
-  detachWidget(key: FieldKey, annotObjectNumber: number): Promise<void>;
-  /**
-   * The twins (permissions.md): would the family's verbs succeed now for
-   * this session? `canRead` — the form model hydrates at all (false = the
-   * hydration gate left it empty by right); `canFill` — value writes
-   * (`setText`/`toggle`/`choose`/`reset`; also fused into every
-   * `FillItem.disabled`); `canDesign` — the field-design family
-   * (`placeField`/`updateField`/`deleteField`/`detachWidget`).
-   */
-  canRead(): boolean;
-  canFill(): boolean;
-  canDesign(): boolean;
-}
-/** What one widget activation did — which world handled it (see
- *  {@link FormCapability.activateWidget}). Both framework call sites ignore
- *  the value today; chrome that cares can discriminate on `kind`. */
-type WidgetActivationResult = {
-  kind: 'form';
-  result: FormCommitResult;
-} | {
-  kind: 'dispatched';
-  result: ActionTriggerResult;
-};
-/**
- * HOST lens — plugin-to-plugin only (the actions plugin's interim
- * `javascript` / `reset-form` executors). Import the token from
- * `@embedpdf/plugin-form/contract/host`, never from application code.
- */
-interface FormHostCapability extends FormCapability {
-  /**
-   * Execute one ResetForm action: resolve targets against the live snapshot
-   * with the shared ISO selection (`null` = every field; a parent NAME
-   * selects its descendants too; `exclude` = complement; a resolution
-   * yielding zero refs never reaches the engine), reset as ONE engine
-   * batch, refresh, then recalculate when scripting is enabled (Acrobat's
-   * behaviour). `origin` (default `'user'`) is preserved through
-   * recalculation surfacing — a lifecycle ResetForm's alerts stay lifecycle.
-   */
-  resetFormAction(fields: PdfActionTargetRef[] | null, exclude: boolean, origin?: ActionOrigin): Promise<FormCommitResult>;
-  /**
-   * The submit dataset resolver (Phase 4, D7): fresh engine read + the pure
-   * ISO builder (`field-selection.ts`). Registered with the actions plugin
-   * as THE resolver for both action-node and script submits.
-   */
-  resolveSubmitDataset(intent: SubmitIntent, ctx: ActionContext, diagnose: (diagnostic: ActionDiagnostic) => void): Promise<ActionSubmitRequest>;
-  /** The form DOCUMENT-commit sink (D3): engine `applyEffects` + snapshot
-   *  reconciliation. Sink contract: never throws, never enqueues, never
-   *  touches the script host — callable under a held host transaction. */
-  commitScriptFormEffects(effects: FormEffect[]): Promise<FormEffectsResult>;
-}
-/**
- * The form capability token. Typed to the full {@link FormHostCapability}
- * here (the package internals + the `/internal` entry use this view). The
- * package root re-exports the SAME token narrowed to {@link FormCapability}.
- */
-declare const FormToken: import("@embedpdf/core").CapabilityToken<FormHostCapability>;
-//#endregion
-export { FillItem as _, FormHostCapability as a, WidgetHit as b, FormToken as c, PlacedField as d, WidgetActivationResult as f, FormToolDef as g, FORM_TOOL_BY_ID as h, FormCommitStatus as i, FormUiEffect as l, FORM_TOOLS as m, FormCapability as n, FormPluginOptions as o, AuthorableFormFamily as p, FormCommitResult as r, FormState as s, FormAction as t, PlaceFieldInput as u, Box as v, fieldKeyOf as x, FieldKey as y };
-//# sourceMappingURL=types-DRirhZKr.d.ts.map

package/dist/types-DkQmmcTG.js

@@ -1,12 +0,0 @@
-import { createCapabilityToken } from "@embedpdf/core";
-//#region src/types.ts
-/**
-* The form capability token. Typed to the full {@link FormHostCapability}
-* here (the package internals + the `/internal` entry use this view). The
-* package root re-exports the SAME token narrowed to {@link FormCapability}.
-*/
-const FormToken = createCapabilityToken("form");
-//#endregion
-export { FormToken as t };
-
-//# sourceMappingURL=types-DkQmmcTG.js.map

package/dist/types-DkQmmcTG.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-DkQmmcTG.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type {\n  AnnotationRef,\n  FormDataExport,\n  FormDataFormat,\n  FormFieldDTO,\n  FormFieldFamily,\n  FormFieldPatch,\n  FormFieldRef,\n  FormFieldValue,\n  FormImportResult,\n  FormRepairOptions,\n  FormRepairResult,\n  FormSetValueResult,\n  FormEffect,\n  FormEffectsResult,\n  FormSnapshot,\n  PdfActionTargetRef,\n  WidgetAppearance,\n} from '@embedpdf/engine-core/runtime';\nimport type {\n  ActionContext,\n  ActionDiagnostic,\n  ActionOrigin,\n  ActionSubmitRequest,\n  ActionTriggerResult,\n  PdfAnnotationEventKind,\n  SubmitIntent,\n} from '@embedpdf/plugin-actions/contract';\nimport type { ScriptDiagnostic, ScriptExecutionError, ScriptUiEffect } from '@embedpdf/core-acrojs';\nimport { createCapabilityToken } from '@embedpdf/core';\n\nimport type { FillItem } from './core/fill-items';\nimport type { Box, FieldKey, Model, WidgetHit } from './core/model';\nimport type { AuthorableFormFamily } from './tools';\n\nexport interface FormState {\n  model: Model;\n}\n\n/** The scripting switch moved to `actionsPlugin({ javascript })` (D8). */\nexport interface FormPluginOptions {}\n\nexport type FormCommitStatus = 'applied' | 'unchanged' | 'rejected' | 'failed';\n\nexport interface FormCommitResult {\n  status: FormCommitStatus;\n  scripted: boolean;\n  effectsResult: FormEffectsResult | null;\n  uiEffects: FormUiEffect[];\n  diagnostics: ScriptDiagnostic[];\n  error?: ScriptExecutionError;\n}\n\n/**\n * One DOM-free UI request produced by the curated Acrobat scripting surface.\n * `phase` says WHO asked: `'boot'` = a document-open script (Adobe's\n * version-check boilerplate lives here — embedders typically suppress these\n * nags), `'user'` = a script triggered by the user's own interaction (a\n * validation alert — show it).\n */\nexport type FormUiEffect = ScriptUiEffect & {\n  /** WHO asked, script-model axis: `'boot'` = a name-tree/document-open boot\n   *  script, `'user'` = a runtime script. */\n  phase: 'boot' | 'user';\n  /**\n   * The dispatch-origin axis (present when the script ran inside an action\n   * dispatch): a lifecycle `/OpenAction` script is NOT a name-tree boot\n   * script — the two axes are deliberately separate. Providers use this for\n   * the default visibility matrix (suppress lifecycle alerts, block\n   * non-user print); embedder handlers receive it and may decide otherwise.\n   */\n  origin?: ActionOrigin;\n};\n\n/** Input for {@link FormCapability.placeField}. */\nexport interface PlaceFieldInput {\n  family: AuthorableFormFamily;\n  pageObjectNumber: number;\n  /** Content-space LOGICAL field box (no visual padding semantics). */\n  box: Box;\n  /** Widget styling in the engine vocabulary (`WidgetAppearance`). Convert a\n   *  tool's flat CSS defaults with `widgetAppearanceFromProps` from\n   *  `@embedpdf/plugin-annotation`. Omitted → the engine's bare defaults. */\n  appearance?: WidgetAppearance;\n}\n\n/** What {@link FormCapability.placeField} created. */\nexport interface PlacedField {\n  field: FormFieldDTO;\n  /** The widget placed on the requested page (join key to the annotation\n   *  plane for auto-selection), or null when the engine reported none. */\n  widget: FormFieldDTO['widgets'][number] | null;\n}\n\nexport type FormAction = { type: 'SET_MODEL'; model: Model };\n\n/**\n * The form plugin's public capability: the FIELD plane. Widgets stay\n * annotations (geometry/appearance live there); this surface owns values,\n * interchange, and the fill-mode projection.\n */\nexport interface FormCapability {\n  /** The current reconciled form state (null until the first load lands). */\n  snapshot(): FormSnapshot | null;\n  /** Re-read the form from the engine (imports/repair/remote bursts). */\n  refresh(): Promise<void>;\n\n  /** Fill controls for one page — content-space, framework-agnostic. */\n  fillItems(pageObjectNumber: number): FillItem[];\n  /**\n   * The fill control for ONE widget, by annotation object number — the join\n   * the annotation-plane render layer uses (its RenderItem carries the live\n   * box, so this item's `box` is advisory). Reference-stable per model change.\n   * Null until the snapshot lands, or for families with no fill control.\n   */\n  fillItem(annotObjectNumber: number): FillItem | null;\n  /** Make sure a page's widget geometry is loaded (idempotent, lazy). */\n  ensureGeom(pageObjectNumber: number): void;\n\n  field(key: FieldKey): FormFieldDTO | null;\n  fieldForWidget(annotObjectNumber: number): FormFieldDTO | null;\n  /**\n   * The widget under a content-space point on a page (any family), with\n   * its field — the hit test a sibling plugin runs on a pointer sample\n   * before deciding what a click means (a mark dropped over a signature\n   * field). The model's own geometry answers when it is loaded; until then\n   * the annotation plane's live boxes do, so the first click on a page\n   * already resolves. The smallest containing widget wins.\n   */\n  widgetAt(pageObjectNumber: number, point: { x: number; y: number }): WidgetHit | null;\n\n  /** Commit a text value (call on blur/Enter — keystrokes stay local). */\n  setText(key: FieldKey, value: string): Promise<void>;\n  /** Toggle a checkbox/radio widget by its on-state; null clears the group. */\n  toggle(key: FieldKey, onState: string | null): Promise<void>;\n  /** Select choice options by export value. */\n  choose(key: FieldKey, values: string[]): Promise<void>;\n  /** Commit one originating-client value transaction, including K/V/C/F scripts when enabled. */\n  commitValue(ref: FormFieldRef, value: FormFieldValue): Promise<FormCommitResult>;\n  /**\n   * Execute one widget's `/A` activation. With the actions plugin installed\n   * the FULL tree is delegated to its dispatcher (Hide/ResetForm buttons work\n   * even with scripting off) — `kind: 'dispatched'`; without it, today's\n   * scripting-transaction path runs — `kind: 'form'`.\n   */\n  activateWidget(key: FieldKey, annotationRef: AnnotationRef): Promise<WidgetActivationResult>;\n  /**\n   * Report one widget DOM event (pointer enter/leave, down/up, focus/blur).\n   * With the actions plugin present the matching `/AA` tree dispatches\n   * (hover rides the shared coalescing pump; `/A` shadows `/AA U` per ISO\n   * Table 197); without it — or without a tree — this is a cheap no-op.\n   * Fire-and-forget by design: results surface via the actions events.\n   */\n  notifyWidgetEvent(key: FieldKey, ref: AnnotationRef, event: PdfAnnotationEventKind): void;\n  /** Restore a field to its /DV default. */\n  reset(key: FieldKey): Promise<void>;\n  /** Raw engine passthrough for anything the sugar above doesn't cover. */\n  setValue(ref: FormFieldRef, value: FormFieldValue): Promise<FormSetValueResult>;\n\n  exportData(format?: FormDataFormat): Promise<FormDataExport>;\n  importData(data: Uint8Array | ArrayBuffer, format?: FormDataFormat): Promise<FormImportResult>;\n  repair(options?: FormRepairOptions): Promise<FormRepairResult>;\n\n  // ── design mode (doc.forms.modify) ─────────────────────────────────────\n  /**\n   * Create a field of `family` with one styled widget at a content-space box\n   * — the palette tools' commit, and the programmatic authoring entry (works\n   * with NO annotation plugin: a pure `doc.forms` call). The box is clamped\n   * to the page; sizing policy (click default vs drag rect) is the caller's.\n   * The field gets a deterministic auto-name (`text_1`, …; rename in the\n   * field panel). Resolves AFTER the annotation plane (when present) has\n   * re-read the page, so the returned widget is immediately selectable.\n   */\n  placeField(input: PlaceFieldInput): Promise<PlacedField>;\n  /** The page's content box (`{0,0,w,h}`) — page-bound placement math. */\n  pageBox(pageObjectNumber: number): Box | null;\n  /** Field-plane properties: name, required, options, default value. */\n  updateField(key: FieldKey, patch: FormFieldPatch): Promise<void>;\n  /** Delete the field and every widget of it (cascades on the page). */\n  deleteField(key: FieldKey): Promise<void>;\n  /** Unlink one widget: it stays as an inert annotation, the field survives. */\n  detachWidget(key: FieldKey, annotObjectNumber: number): Promise<void>;\n\n  /**\n   * The twins (permissions.md): would the family's verbs succeed now for\n   * this session? `canRead` — the form model hydrates at all (false = the\n   * hydration gate left it empty by right); `canFill` — value writes\n   * (`setText`/`toggle`/`choose`/`reset`; also fused into every\n   * `FillItem.disabled`); `canDesign` — the field-design family\n   * (`placeField`/`updateField`/`deleteField`/`detachWidget`).\n   */\n  canRead(): boolean;\n  canFill(): boolean;\n  canDesign(): boolean;\n}\n\n/** What one widget activation did — which world handled it (see\n *  {@link FormCapability.activateWidget}). Both framework call sites ignore\n *  the value today; chrome that cares can discriminate on `kind`. */\nexport type WidgetActivationResult =\n  | { kind: 'form'; result: FormCommitResult }\n  | { kind: 'dispatched'; result: ActionTriggerResult };\n\n/**\n * HOST lens — plugin-to-plugin only (the actions plugin's interim\n * `javascript` / `reset-form` executors). Import the token from\n * `@embedpdf/plugin-form/contract/host`, never from application code.\n */\nexport interface FormHostCapability extends FormCapability {\n  /**\n   * Execute one ResetForm action: resolve targets against the live snapshot\n   * with the shared ISO selection (`null` = every field; a parent NAME\n   * selects its descendants too; `exclude` = complement; a resolution\n   * yielding zero refs never reaches the engine), reset as ONE engine\n   * batch, refresh, then recalculate when scripting is enabled (Acrobat's\n   * behaviour). `origin` (default `'user'`) is preserved through\n   * recalculation surfacing — a lifecycle ResetForm's alerts stay lifecycle.\n   */\n  resetFormAction(\n    fields: PdfActionTargetRef[] | null,\n    exclude: boolean,\n    origin?: ActionOrigin,\n  ): Promise<FormCommitResult>;\n  /**\n   * The submit dataset resolver (Phase 4, D7): fresh engine read + the pure\n   * ISO builder (`field-selection.ts`). Registered with the actions plugin\n   * as THE resolver for both action-node and script submits.\n   */\n  resolveSubmitDataset(\n    intent: SubmitIntent,\n    ctx: ActionContext,\n    diagnose: (diagnostic: ActionDiagnostic) => void,\n  ): Promise<ActionSubmitRequest>;\n  /** The form DOCUMENT-commit sink (D3): engine `applyEffects` + snapshot\n   *  reconciliation. Sink contract: never throws, never enqueues, never\n   *  touches the script host — callable under a held host transaction. */\n  commitScriptFormEffects(effects: FormEffect[]): Promise<FormEffectsResult>;\n}\n\n/**\n * The form capability token. Typed to the full {@link FormHostCapability}\n * here (the package internals + the `/internal` entry use this view). The\n * package root re-exports the SAME token narrowed to {@link FormCapability}.\n */\nexport const FormToken = createCapabilityToken<FormHostCapability>('form');\n\nexport type { FillItem } from './core/fill-items';\nexport type { Box, FieldKey, WidgetHit } from './core/model';\n"],"mappings":";;;;;;;AAoPA,MAAa,YAAY,sBAA0C,MAAM"}