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

package/dist/controller-Sr5M_8G8.js

@@ -0,0 +1,497 @@
+import { DEFAULT_SCRIPT_BUDGET, javaScriptProgramFromActionTree, scriptFieldsFromSnapshot } from "@embedpdf/core-acrojs";
+//#region src/scripting/overlay.ts
+const refKey = (ref) => ref.kind === "objectNumber" ? `obj:${ref.objectNumber}` : `fqn:${ref.name}`;
+const sameRef = (left, right) => refKey(left) === refKey(right);
+const cloneValue = (value) => Array.isArray(value) ? [...value] : value;
+const sameValue = (left, right) => Array.isArray(left) && Array.isArray(right) ? left.length === right.length && left.every((value, index) => value === right[index]) : left === right;
+function cloneFields(fields) {
+	return fields.map((field) => ({
+		...field,
+		ref: { ...field.ref },
+		value: cloneValue(field.value),
+		defaultValue: cloneValue(field.defaultValue),
+		...field.options ? { options: field.options.map((option) => ({ ...option })) } : {}
+	}));
+}
+function fieldByRef(fields, ref) {
+	return fields.find((field) => sameRef(field.ref, ref));
+}
+/** The field a ref names: by its own ref, or by full name for `toFieldRef(name)`. */
+function snapshotField(snapshot, ref) {
+	return snapshot.fields.find((field) => sameRef(field.ref, ref) || ref.kind === "fqn" && field.name === ref.name);
+}
+/** A written value as scripts see it: a toggle's export value (`'Off'` when clear). */
+function scriptValueFromFormValue(field, value) {
+	switch (field.family) {
+		case "text":
+		case "combobox":
+			if ("value" in value) return value.value ?? "";
+			break;
+		case "radio":
+			if ("value" in value) return value.value ?? "Off";
+			break;
+		case "checkbox":
+			if ("value" in value) return value.value ?? "Off";
+			if ("checked" in value) {
+				if (!value.checked) return "Off";
+				const first = field.exportValues?.[0];
+				if (first === void 0) throw new Error(`Form field '${field.name}' has no widget to check`);
+				return first;
+			}
+			break;
+		case "listbox":
+			if ("selectedValues" in value) return [...value.selectedValues];
+			break;
+	}
+	throw new Error(`Form field '${field.name}' (${field.family}) does not take this value`);
+}
+/** A script value as the engine writes it, or null for a family that holds none. */
+function formValueFromScriptValue(field) {
+	const value = field.value;
+	switch (field.family) {
+		case "text": return { value: String(value ?? "") };
+		case "checkbox":
+		case "radio": return { value: value === null || String(value) === "Off" ? null : String(value) };
+		case "combobox": {
+			const selected = Array.isArray(value) ? value[0] : value;
+			const text = selected === null || selected === void 0 ? "" : String(selected);
+			return { value: text === "" ? null : text };
+		}
+		case "listbox":
+			if (Array.isArray(value)) return { selectedValues: [...value] };
+			return { selectedValues: value === null || value === "" ? [] : [String(value)] };
+		default: return null;
+	}
+}
+function applyEffects(overlay, effects) {
+	for (const effect of effects) {
+		if (effect.kind === "reset") {
+			for (const ref of effect.refs) {
+				const field = fieldByRef(overlay.fields, ref);
+				if (!field) continue;
+				field.value = cloneValue(field.defaultValue);
+				overlay.resetKeys.add(refKey(ref));
+			}
+			continue;
+		}
+		const field = fieldByRef(overlay.fields, effect.ref);
+		if (!field) continue;
+		const key = refKey(effect.ref);
+		if (effect.kind === "setValue") {
+			field.value = scriptValueFromFormValue(field, effect.value);
+			overlay.resetKeys.delete(key);
+		} else if (effect.kind === "setDisplay") field.display = effect.display;
+		else overlay.appearances.set(key, {
+			ref: effect.ref,
+			text: effect.text
+		});
+	}
+}
+function canonicalEffects(overlay) {
+	const effects = [];
+	const resets = [];
+	for (const field of overlay.fields) {
+		const original = fieldByRef(overlay.original, field.ref);
+		if (!original) continue;
+		if (!sameValue(original.value, field.value)) {
+			const key = refKey(field.ref);
+			if (overlay.resetKeys.has(key) && sameValue(field.value, field.defaultValue)) resets.push(field.ref);
+			else {
+				const value = formValueFromScriptValue(field);
+				if (value) effects.push({
+					kind: "setValue",
+					ref: field.ref,
+					value
+				});
+			}
+		}
+		if (original.display !== field.display) effects.push({
+			kind: "setDisplay",
+			ref: field.ref,
+			display: field.display
+		});
+	}
+	if (resets.length > 0) effects.unshift({
+		kind: "reset",
+		refs: resets
+	});
+	effects.push(...Array.from(overlay.appearances.values(), ({ ref, text }) => ({
+		kind: "setAppearanceText",
+		ref,
+		text
+	})));
+	return effects;
+}
+//#endregion
+//#region src/scripting/results.ts
+function scriptError(message) {
+	return {
+		kind: "invalid-output",
+		message
+	};
+}
+function utf8Length(value) {
+	let length = 0;
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code < 128) length += 1;
+		else if (code < 2048) length += 2;
+		else if (code >= 55296 && code <= 56319 && index + 1 < value.length) {
+			length += 4;
+			index += 1;
+		} else length += 3;
+	}
+	return length;
+}
+function pageNumberFor(meta, field) {
+	const placed = field.widgets.find((widget) => widget.page !== null)?.page;
+	if (!meta || !placed) return 0;
+	const index = meta.pages.findIndex((page) => page.ref.objectNumber === placed.objectNumber);
+	return Math.max(0, index);
+}
+//#endregion
+//#region src/scripting/controller.ts
+var FormScriptingController = class {
+	constructor(options) {
+		this.options = options;
+		this.disposed = false;
+		this.transactionBudget = options.budget;
+	}
+	/** The realm belongs to its owner (the actions plugin, or the caller that
+	*  minted a detached one) — this only fences further transactions. */
+	dispose() {
+		this.disposed = true;
+	}
+	/**
+	* One realm transaction: `body` runs its scripts and writes what they changed before the
+	* next transaction starts, so that one reads the form with it.
+	*/
+	transaction(body) {
+		if (this.disposed) return Promise.reject(/* @__PURE__ */ new Error("Form scripting controller is disposed"));
+		return this.options.transaction((txn) => body({
+			commit: (form, ref, value) => this.run(txn, form, ref, value),
+			activate: (form, ref, action) => this.run(txn, form, ref, void 0, action),
+			recalculate: (form) => this.run(txn, form, void 0)
+		}));
+	}
+	/**
+	* Load the realm before the first write needs it: the scripts' engine starts, and the
+	* document's open scripts run, their effects kept for the first write as without warming.
+	* Nothing is written.
+	*/
+	async warm(form) {
+		if (this.disposed) return;
+		const budget = this.transactionBudget ?? DEFAULT_SCRIPT_BUDGET;
+		await this.options.transaction((txn) => txn.run("", {
+			fields: scriptFieldsFromSnapshot(form),
+			event: { kind: "name-tree-boot" }
+		}, budget));
+	}
+	/** {@link FormScripts.commit} in a transaction of its own. */
+	commit(form, ref, value) {
+		return this.transaction((scripts) => scripts.commit(form, ref, value));
+	}
+	/** {@link FormScripts.activate} in a transaction of its own. */
+	activate(form, ref, action) {
+		return this.transaction((scripts) => scripts.activate(form, ref, action));
+	}
+	/** {@link FormScripts.recalculate} in a transaction of its own. */
+	recalculate(form) {
+		return this.transaction((scripts) => scripts.recalculate(form));
+	}
+	async run(txn, snapshot, refInput, proposed, activation) {
+		const asked = refInput ?? snapshot.calculationOrder.find((candidate) => candidate !== null && snapshotField(snapshot, candidate) !== void 0) ?? snapshot.fields[0]?.ref;
+		if (!asked) return {
+			status: "accepted",
+			effects: [],
+			bootEffects: [],
+			uiEffects: [],
+			diagnostics: []
+		};
+		const target = snapshotField(snapshot, asked);
+		if (!target) return this.failed([], [], scriptError(`Form field '${refKey(asked)}' no longer exists`));
+		const ref = target.ref;
+		const original = scriptFieldsFromSnapshot(snapshot);
+		const overlay = {
+			original,
+			fields: cloneFields(original),
+			resetKeys: /* @__PURE__ */ new Set(),
+			appearances: /* @__PURE__ */ new Map()
+		};
+		const targetInput = fieldByRef(overlay.fields, ref);
+		if (!targetInput) return this.failed([], [], scriptError(`Form field '${refKey(ref)}' has no script view`));
+		const hasProposedValue = proposed !== void 0;
+		let proposedValue = cloneValue(targetInput.value);
+		if (proposed) try {
+			proposedValue = scriptValueFromFormValue(targetInput, proposed);
+		} catch (error) {
+			return this.failed([], [], scriptError(error instanceof Error ? error.message : String(error)));
+		}
+		const uiEffects = [];
+		const diagnostics = [];
+		const pageNumber = pageNumberFor(this.options.document(), target);
+		const budget = this.transactionBudget ?? DEFAULT_SCRIPT_BUDGET;
+		let executionMs = 0;
+		let aggregateOutputSize = 0;
+		const consume = (output, phase) => {
+			aggregateOutputSize += utf8Length(JSON.stringify(output));
+			uiEffects.push(...output.uiEffects.map((effect) => ({
+				...effect,
+				phase
+			})));
+			diagnostics.push(...output.diagnostics);
+			if (aggregateOutputSize > budget.maxOutputBytes) return {
+				kind: "budget",
+				message: `Form script transaction output exceeded ${budget.maxOutputBytes} bytes`
+			};
+			return output.error ?? null;
+		};
+		const remainingBudget = () => {
+			const remaining = budget.maxExecutionMs - executionMs;
+			return remaining <= 0 ? null : {
+				...budget,
+				maxExecutionMs: remaining
+			};
+		};
+		const world = (fields, event) => ({
+			fields,
+			pageNumber,
+			event
+		});
+		const run = async (source, input) => {
+			const remaining = remainingBudget();
+			if (!remaining) return { error: {
+				kind: "budget",
+				message: "Form script transaction timed out"
+			} };
+			let output;
+			try {
+				const startedAt = Date.now();
+				output = await txn.run(source, input, remaining);
+				executionMs += Date.now() - startedAt;
+			} catch (error) {
+				return { error: scriptError(error instanceof Error ? error.message : String(error)) };
+			}
+			const error = consume(output, "user");
+			return error ? { error } : { output };
+		};
+		{
+			let boot = null;
+			try {
+				boot = await txn.boot(world(overlay.fields, { kind: "name-tree-boot" }), budget);
+			} catch (error) {
+				diagnostics.push({
+					code: "script-error",
+					message: `Document boot script failed (continuing without it): ${error instanceof Error ? error.message : String(error)}`
+				});
+			}
+			if (boot) {
+				const bootError = consume(boot, "boot");
+				if (!bootError) applyEffects(overlay, boot.formEffects);
+				else diagnostics.push({
+					code: "script-error",
+					message: `Document boot script failed (continuing without it): ${bootError.message}`
+				});
+			}
+		}
+		const bootEffects = canonicalEffects(overlay);
+		if (activation) {
+			let program;
+			try {
+				program = javaScriptProgramFromActionTree(activation);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const activated = await run(program, world(overlay.fields, {
+					kind: "widget-activate",
+					target: ref,
+					source: ref,
+					value: targetInput.value
+				}));
+				if (activated.error) return this.failed(uiEffects, diagnostics, activated.error);
+				applyEffects(overlay, activated.output.formEffects);
+			}
+		}
+		if (!activation && hasProposedValue && target.actions?.keystroke && target.family === "text") {
+			let program;
+			try {
+				program = javaScriptProgramFromActionTree(target.actions.keystroke);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const oldValue = String(targetInput.value ?? "");
+				const typing = await run(program, world(overlay.fields, {
+					kind: "field-keystroke",
+					target: ref,
+					source: ref,
+					value: oldValue,
+					change: String(proposedValue ?? ""),
+					selStart: 0,
+					selEnd: oldValue.length,
+					willCommit: false
+				}));
+				if (typing.error && typing.error.kind !== "exception") return this.failed(uiEffects, diagnostics, typing.error);
+				if (typing.error) diagnostics.push({
+					code: "script-error",
+					message: `Keystroke script failed (kept the typed value): ${typing.error.message}`
+				});
+				else {
+					if (!typing.output.event.rc) return this.rejected(bootEffects, uiEffects, diagnostics);
+					applyEffects(overlay, typing.output.formEffects);
+					const event = typing.output.event;
+					const base = String(event.value ?? "");
+					proposedValue = base.slice(0, event.selStart) + event.change + base.slice(Math.max(event.selStart, event.selEnd));
+				}
+				const commit = await run(program, world(overlay.fields, {
+					kind: "field-keystroke",
+					target: ref,
+					source: ref,
+					value: proposedValue,
+					change: "",
+					selStart: 0,
+					selEnd: 0,
+					willCommit: true
+				}));
+				if (commit.error && commit.error.kind !== "exception") return this.failed(uiEffects, diagnostics, commit.error);
+				if (commit.error) diagnostics.push({
+					code: "script-error",
+					message: `Keystroke commit script failed (kept the typed value): ${commit.error.message}`
+				});
+				else {
+					if (!commit.output.event.rc) return this.rejected(bootEffects, uiEffects, diagnostics);
+					applyEffects(overlay, commit.output.formEffects);
+					proposedValue = cloneValue(commit.output.event.value);
+				}
+			}
+		}
+		if (!activation && hasProposedValue) {
+			targetInput.value = cloneValue(proposedValue);
+			overlay.resetKeys.delete(refKey(ref));
+		}
+		if (!activation && hasProposedValue && target.actions?.validate) {
+			let program;
+			try {
+				program = javaScriptProgramFromActionTree(target.actions.validate);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (program) {
+				const validation = await run(program, world(overlay.fields, {
+					kind: "field-validate",
+					target: ref,
+					source: ref,
+					value: proposedValue,
+					willCommit: true
+				}));
+				if (validation.error && validation.error.kind !== "exception") return this.failed(uiEffects, diagnostics, validation.error);
+				if (validation.error) diagnostics.push({
+					code: "script-error",
+					message: `Validate script failed (accepted the value): ${validation.error.message}`
+				});
+				else {
+					if (!validation.output.event.rc) return this.rejected(bootEffects, uiEffects, diagnostics);
+					targetInput.value = cloneValue(validation.output.event.value);
+					applyEffects(overlay, validation.output.formEffects);
+				}
+			}
+		}
+		const formatRefs = !activation && hasProposedValue ? [ref] : [];
+		for (const calculationRef of activation ? [] : snapshot.calculationOrder) {
+			if (!calculationRef) continue;
+			const calculated = snapshotField(snapshot, calculationRef);
+			const tree = calculated?.actions?.calculate;
+			if (!calculated || !tree) continue;
+			let program;
+			try {
+				program = javaScriptProgramFromActionTree(tree);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			const calculatedInput = fieldByRef(overlay.fields, calculationRef);
+			if (program && calculatedInput) {
+				const calculation = await run(program, world(overlay.fields, {
+					kind: "field-calculate",
+					target: calculationRef,
+					...hasProposedValue ? { source: ref } : {},
+					value: calculatedInput.value
+				}));
+				if (calculation.error && calculation.error.kind !== "exception") return this.failed(uiEffects, diagnostics, calculation.error);
+				if (calculation.error) diagnostics.push({
+					code: "script-error",
+					message: `Calculate script failed (field left unchanged): ${calculation.error.message}`
+				});
+				else applyEffects(overlay, calculation.output.formEffects);
+			}
+			if (!formatRefs.some((candidate) => sameRef(candidate, calculationRef))) formatRefs.push(calculationRef);
+		}
+		for (const formatRef of formatRefs) {
+			const field = snapshotField(snapshot, formatRef);
+			const tree = field?.actions?.format;
+			const overlayField = fieldByRef(overlay.fields, formatRef);
+			if (!field || !tree || !overlayField) continue;
+			let program;
+			try {
+				program = javaScriptProgramFromActionTree(tree);
+			} catch (error) {
+				return this.failed(uiEffects, diagnostics, scriptError(error instanceof Error ? error.message : String(error)));
+			}
+			if (!program) continue;
+			const format = await run(program, world(overlay.fields, {
+				kind: "field-format",
+				target: formatRef,
+				...hasProposedValue ? { source: ref } : {},
+				value: overlayField.value
+			}));
+			if (format.error && format.error.kind !== "exception") return this.failed(uiEffects, diagnostics, format.error);
+			if (format.error) {
+				diagnostics.push({
+					code: "script-error",
+					message: `Format script failed (kept the raw value): ${format.error.message}`
+				});
+				continue;
+			}
+			applyEffects(overlay, format.output.formEffects);
+		}
+		const effects = canonicalEffects(overlay);
+		if (effects.length + uiEffects.length > budget.maxEffects) return this.failed(uiEffects, diagnostics, {
+			kind: "budget",
+			message: `Form script transaction exceeded ${budget.maxEffects} effects`
+		});
+		return {
+			status: "accepted",
+			effects,
+			bootEffects,
+			uiEffects,
+			diagnostics
+		};
+	}
+	failed(uiEffects, diagnostics, error) {
+		return {
+			status: "failed",
+			effects: [],
+			bootEffects: [],
+			uiEffects,
+			diagnostics,
+			error
+		};
+	}
+	/** The value is refused; the open scripts' effects are still written. */
+	rejected(bootEffects, uiEffects, diagnostics) {
+		return {
+			status: "rejected",
+			effects: [],
+			bootEffects,
+			uiEffects,
+			diagnostics
+		};
+	}
+};
+function createFormScriptingController(options) {
+	return new FormScriptingController(options);
+}
+//#endregion
+export { createFormScriptingController as n, scriptError as r, FormScriptingController as t };
+
+//# sourceMappingURL=controller-Sr5M_8G8.js.map

package/dist/controller-Sr5M_8G8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-Sr5M_8G8.js","names":[],"sources":["../src/scripting/overlay.ts","../src/scripting/results.ts","../src/scripting/controller.ts"],"sourcesContent":["/**\n * The transaction overlay: a working copy of the script field view that\n * every pass mutates, and the canonical effect list diffed from it at the\n * end (values, display, appearance text; resets folded back to one effect).\n */\nimport type { ScriptFieldInput, ScriptValue } from '@embedpdf/core-acrojs';\nimport type {\n  FormEffect,\n  FormFieldDTO,\n  FormFieldRef,\n  FormFieldValue,\n  FormSnapshot,\n} from '@embedpdf/engine-core/runtime';\n\nexport interface Overlay {\n  original: ScriptFieldInput[];\n  fields: ScriptFieldInput[];\n  resetKeys: Set<string>;\n  appearances: Map<string, { ref: FormFieldRef; text: string }>;\n}\n\nexport const refKey = (ref: FormFieldRef): string =>\n  ref.kind === 'objectNumber' ? `obj:${ref.objectNumber}` : `fqn:${ref.name}`;\n\nexport const sameRef = (left: FormFieldRef, right: FormFieldRef): boolean =>\n  refKey(left) === refKey(right);\n\nexport const cloneValue = (value: ScriptValue): ScriptValue =>\n  Array.isArray(value) ? [...value] : value;\n\nexport const sameValue = (left: ScriptValue, right: ScriptValue): boolean =>\n  Array.isArray(left) && Array.isArray(right)\n    ? left.length === right.length && left.every((value, index) => value === right[index])\n    : left === right;\n\nexport function cloneFields(fields: ScriptFieldInput[]): ScriptFieldInput[] {\n  return fields.map((field) => ({\n    ...field,\n    ref: { ...field.ref },\n    value: cloneValue(field.value),\n    defaultValue: cloneValue(field.defaultValue),\n    ...(field.options ? { options: field.options.map((option) => ({ ...option })) } : {}),\n  }));\n}\n\nexport function fieldByRef<T extends { ref: FormFieldRef }>(\n  fields: T[],\n  ref: FormFieldRef,\n): T | undefined {\n  return fields.find((field) => sameRef(field.ref, ref));\n}\n\n/** The field a ref names: by its own ref, or by full name for `toFieldRef(name)`. */\nexport function snapshotField(snapshot: FormSnapshot, ref: FormFieldRef): FormFieldDTO | undefined {\n  return snapshot.fields.find(\n    (field) => sameRef(field.ref, ref) || (ref.kind === 'fqn' && field.name === ref.name),\n  );\n}\n\n/** A written value as scripts see it: a toggle's export value (`'Off'` when clear). */\nexport function scriptValueFromFormValue(\n  field: ScriptFieldInput,\n  value: FormFieldValue,\n): ScriptValue {\n  switch (field.family) {\n    case 'text':\n    case 'combobox':\n      if ('value' in value) return value.value ?? '';\n      break;\n    case 'radio':\n      if ('value' in value) return value.value ?? 'Off';\n      break;\n    case 'checkbox':\n      if ('value' in value) return value.value ?? 'Off';\n      if ('checked' in value) {\n        if (!value.checked) return 'Off';\n        const first = field.exportValues?.[0];\n        if (first === undefined)\n          throw new Error(`Form field '${field.name}' has no widget to check`);\n        return first;\n      }\n      break;\n    case 'listbox':\n      if ('selectedValues' in value) return [...value.selectedValues];\n      break;\n  }\n  throw new Error(`Form field '${field.name}' (${field.family}) does not take this value`);\n}\n\n/** A script value as the engine writes it, or null for a family that holds none. */\nexport function formValueFromScriptValue(field: ScriptFieldInput): FormFieldValue | null {\n  const value = field.value;\n  switch (field.family) {\n    case 'text':\n      return { value: String(value ?? '') };\n    case 'checkbox':\n    case 'radio':\n      return { value: value === null || String(value) === 'Off' ? null : String(value) };\n    case 'combobox': {\n      const selected = Array.isArray(value) ? value[0] : value;\n      const text = selected === null || selected === undefined ? '' : String(selected);\n      return { value: text === '' ? null : text };\n    }\n    case 'listbox':\n      if (Array.isArray(value)) return { selectedValues: [...value] };\n      return { selectedValues: value === null || value === '' ? [] : [String(value)] };\n    default:\n      return null;\n  }\n}\n\nexport function applyEffects(overlay: Overlay, effects: FormEffect[]): void {\n  for (const effect of effects) {\n    if (effect.kind === 'reset') {\n      for (const ref of effect.refs) {\n        const field = fieldByRef(overlay.fields, ref);\n        if (!field) continue;\n        field.value = cloneValue(field.defaultValue);\n        overlay.resetKeys.add(refKey(ref));\n      }\n      continue;\n    }\n\n    const field = fieldByRef(overlay.fields, effect.ref);\n    if (!field) continue;\n    const key = refKey(effect.ref);\n    if (effect.kind === 'setValue') {\n      field.value = scriptValueFromFormValue(field, effect.value);\n      overlay.resetKeys.delete(key);\n    } else if (effect.kind === 'setDisplay') {\n      field.display = effect.display;\n    } else {\n      overlay.appearances.set(key, { ref: effect.ref, text: effect.text });\n    }\n  }\n}\n\nexport function canonicalEffects(overlay: Overlay): FormEffect[] {\n  const effects: FormEffect[] = [];\n  const resets: FormFieldRef[] = [];\n  for (const field of overlay.fields) {\n    const original = fieldByRef(overlay.original, field.ref);\n    if (!original) continue;\n    if (!sameValue(original.value, field.value)) {\n      const key = refKey(field.ref);\n      if (overlay.resetKeys.has(key) && sameValue(field.value, field.defaultValue)) {\n        resets.push(field.ref);\n      } else {\n        const value = formValueFromScriptValue(field);\n        if (value) effects.push({ kind: 'setValue', ref: field.ref, value });\n      }\n    }\n    if (original.display !== field.display) {\n      effects.push({ kind: 'setDisplay', ref: field.ref, display: field.display });\n    }\n  }\n  if (resets.length > 0) effects.unshift({ kind: 'reset', refs: resets });\n  effects.push(\n    ...Array.from(overlay.appearances.values(), ({ ref, text }) => ({\n      kind: 'setAppearanceText' as const,\n      ref,\n      text,\n    })),\n  );\n  return effects;\n}\n","/** Result shaping for the scripting transaction: errors, budgets, page numbers. */\nimport type { DocumentMeta } from '@embedpdf/core';\nimport type { ScriptExecutionError } from '@embedpdf/core-acrojs';\nimport type { FormFieldDTO } from '@embedpdf/engine-core/runtime';\n\nexport function scriptError(message: string): ScriptExecutionError {\n  return { kind: 'invalid-output', message };\n}\n\nexport function utf8Length(value: string): number {\n  let length = 0;\n  for (let index = 0; index < value.length; index += 1) {\n    const code = value.charCodeAt(index);\n    if (code < 0x80) length += 1;\n    else if (code < 0x800) length += 2;\n    else if (code >= 0xd800 && code <= 0xdbff && index + 1 < value.length) {\n      length += 4;\n      index += 1;\n    } else length += 3;\n  }\n  return length;\n}\n\nexport function pageNumberFor(\n  meta: Pick<DocumentMeta, 'pages'> | null,\n  field: FormFieldDTO,\n): number {\n  const placed = field.widgets.find((widget) => widget.page !== null)?.page;\n  if (!meta || !placed) return 0;\n  const index = meta.pages.findIndex((page) => page.ref.objectNumber === placed.objectNumber);\n  return Math.max(0, index);\n}\n","/**\n * The K/V/C/F passes: keystroke, validate, calculate and format scripts over\n * one working copy of the form (`overlay.ts`), inside one realm transaction.\n * The controller reads the form it is given and returns what the scripts\n * changed. Writing it is the caller's, inside the same transaction\n * (`transaction`), so the next transaction reads the form with it.\n */\nimport type { DocumentMeta } from '@embedpdf/core';\nimport {\n  DEFAULT_SCRIPT_BUDGET,\n  javaScriptProgramFromActionTree,\n  scriptFieldsFromSnapshot,\n  type ScriptBudget,\n  type ScriptDiagnostic,\n  type ScriptExecutionError,\n  type ScriptFieldInput,\n  type ScriptOutput,\n  type ScriptTransaction,\n  type ScriptValue,\n  type ScriptWorldInput,\n} from '@embedpdf/core-acrojs';\nimport type {\n  FormEffect,\n  FormFieldRef,\n  FormFieldValue,\n  FormSnapshot,\n  PdfActionTree,\n} from '@embedpdf/engine-core/runtime';\n\nimport type { FormUiEffect } from '../contract';\nimport {\n  applyEffects,\n  canonicalEffects,\n  cloneFields,\n  cloneValue,\n  fieldByRef,\n  refKey,\n  sameRef,\n  scriptValueFromFormValue,\n  snapshotField,\n  type Overlay,\n} from './overlay';\nimport { pageNumberFor, scriptError, utf8Length } from './results';\n\n/**\n * The controller never owns a realm. It rides a realm port — this document's\n * own (the actions plugin's per-document host) or a detached one minted by\n * the actions plugin for a document that is not displayed (stamp's\n * asset documents). Either way the owner disposes the realm; `dispose()`\n * here only fences further transactions.\n */\nexport interface FormScriptingControllerOptions {\n  /** What the scripts read of the document: its name, page count and pages. */\n  document(): Pick<DocumentMeta, 'name' | 'pageCount' | 'pages'> | null;\n  /** The realm's transaction port ({@link ScriptTransaction}): the realm runs one at a time. */\n  transaction<T>(body: (txn: ScriptTransaction) => Promise<T>): Promise<T>;\n  /** The transaction aggregate (output bytes, wall-clock across passes);\n   *  the realm owner hands over the same budget its runs enforce. */\n  budget?: ScriptBudget;\n}\n\n/** What the form's scripts made of one write, before anything is written. */\nexport interface FormScriptResult {\n  /**\n   * `accepted`: write `effects`. `rejected`: a keystroke or validate script refused the value,\n   * so only `bootEffects` are written. `failed`: the transaction broke (a budget, a script that\n   * couldn't run), so nothing is.\n   */\n  readonly status: 'accepted' | 'rejected' | 'failed';\n  /** What the scripts changed in the form, in the order to write it (`formEffectOps`). */\n  readonly effects: FormEffect[];\n  /** What the document's open scripts changed: written even when the value is refused. */\n  readonly bootEffects: FormEffect[];\n  readonly uiEffects: FormUiEffect[];\n  readonly diagnostics: ScriptDiagnostic[];\n  readonly error?: ScriptExecutionError;\n}\n\n/** The scripts one transaction can run, each against the form it is given. */\nexport interface FormScripts {\n  /**\n   * A field's new value through its keystroke and validate scripts, then the calculations and\n   * the formats. `form` is the form without the value.\n   */\n  commit(form: FormSnapshot, ref: FormFieldRef, value: FormFieldValue): Promise<FormScriptResult>;\n  /** One widget's activation action (`/A`, with `/Next`). Only its scripts run here. */\n  activate(\n    form: FormSnapshot,\n    ref: FormFieldRef,\n    action: PdfActionTree<unknown>,\n  ): Promise<FormScriptResult>;\n  /** The document's open scripts (once per realm) and the calculations, without a field change. */\n  recalculate(form: FormSnapshot): Promise<FormScriptResult>;\n}\n\nexport class FormScriptingController {\n  private disposed = false;\n  private readonly transactionBudget: ScriptBudget | undefined;\n\n  constructor(private readonly options: FormScriptingControllerOptions) {\n    this.transactionBudget = options.budget;\n  }\n\n  /** The realm belongs to its owner (the actions plugin, or the caller that\n   *  minted a detached one) — this only fences further transactions. */\n  dispose(): void {\n    this.disposed = true;\n  }\n\n  /**\n   * One realm transaction: `body` runs its scripts and writes what they changed before the\n   * next transaction starts, so that one reads the form with it.\n   */\n  transaction<T>(body: (scripts: FormScripts) => Promise<T>): Promise<T> {\n    if (this.disposed) return Promise.reject(new Error('Form scripting controller is disposed'));\n    return this.options.transaction((txn) =>\n      body({\n        commit: (form, ref, value) => this.run(txn, form, ref, value),\n        activate: (form, ref, action) => this.run(txn, form, ref, undefined, action),\n        recalculate: (form) => this.run(txn, form, undefined),\n      }),\n    );\n  }\n\n  /**\n   * Load the realm before the first write needs it: the scripts' engine starts, and the\n   * document's open scripts run, their effects kept for the first write as without warming.\n   * Nothing is written.\n   */\n  async warm(form: FormSnapshot): Promise<void> {\n    if (this.disposed) return;\n    const budget = this.transactionBudget ?? DEFAULT_SCRIPT_BUDGET;\n    await this.options.transaction((txn) =>\n      txn.run(\n        '',\n        { fields: scriptFieldsFromSnapshot(form), event: { kind: 'name-tree-boot' } },\n        budget,\n      ),\n    );\n  }\n\n  /** {@link FormScripts.commit} in a transaction of its own. */\n  commit(form: FormSnapshot, ref: FormFieldRef, value: FormFieldValue): Promise<FormScriptResult> {\n    return this.transaction((scripts) => scripts.commit(form, ref, value));\n  }\n\n  /** {@link FormScripts.activate} in a transaction of its own. */\n  activate(\n    form: FormSnapshot,\n    ref: FormFieldRef,\n    action: PdfActionTree<unknown>,\n  ): Promise<FormScriptResult> {\n    return this.transaction((scripts) => scripts.activate(form, ref, action));\n  }\n\n  /** {@link FormScripts.recalculate} in a transaction of its own. */\n  recalculate(form: FormSnapshot): Promise<FormScriptResult> {\n    return this.transaction((scripts) => scripts.recalculate(form));\n  }\n\n  private async run(\n    txn: ScriptTransaction,\n    snapshot: FormSnapshot,\n    refInput: FormFieldRef | undefined,\n    proposed?: FormFieldValue,\n    activation?: PdfActionTree<unknown>,\n  ): Promise<FormScriptResult> {\n    // Recalculate's anchor resolves here (first live /CO field, else the\n    // first field); a zero-field document is an honest no-op.\n    const asked =\n      refInput ??\n      snapshot.calculationOrder.find(\n        (candidate): candidate is FormFieldRef =>\n          candidate !== null && snapshotField(snapshot, candidate) !== undefined,\n      ) ??\n      snapshot.fields[0]?.ref;\n    if (!asked) {\n      return { status: 'accepted', effects: [], bootEffects: [], uiEffects: [], diagnostics: [] };\n    }\n    const target = snapshotField(snapshot, asked);\n    if (!target) {\n      return this.failed([], [], scriptError(`Form field '${refKey(asked)}' no longer exists`));\n    }\n    // The scripts know the field by its own ref, whichever ref asked for it.\n    const ref = target.ref;\n\n    const original = scriptFieldsFromSnapshot(snapshot);\n    const overlay: Overlay = {\n      original,\n      fields: cloneFields(original),\n      resetKeys: new Set(),\n      appearances: new Map(),\n    };\n    const targetInput = fieldByRef(overlay.fields, ref);\n    if (!targetInput) {\n      return this.failed([], [], scriptError(`Form field '${refKey(ref)}' has no script view`));\n    }\n\n    const hasProposedValue = proposed !== undefined;\n    let proposedValue: ScriptValue = cloneValue(targetInput.value);\n    if (proposed) {\n      try {\n        proposedValue = scriptValueFromFormValue(targetInput, proposed);\n      } catch (error) {\n        return this.failed(\n          [],\n          [],\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n    }\n\n    const uiEffects: FormUiEffect[] = [];\n    const diagnostics: ScriptDiagnostic[] = [];\n    const meta = this.options.document();\n    // Document/identity/environment are host-owned now; the world carries the\n    // per-field current page for `this.pageNum`.\n    const pageNumber = pageNumberFor(meta, target);\n    const budget = this.transactionBudget ?? DEFAULT_SCRIPT_BUDGET;\n    let executionMs = 0;\n    let aggregateOutputSize = 0;\n\n    const consume = (\n      output: ScriptOutput,\n      phase: FormUiEffect['phase'],\n    ): ScriptExecutionError | null => {\n      aggregateOutputSize += utf8Length(JSON.stringify(output));\n      // Tag every UI request with who asked — embedders suppress boot-phase\n      // nags (Adobe's version-check alert) but show user-phase validation.\n      uiEffects.push(...output.uiEffects.map((effect) => ({ ...effect, phase })));\n      diagnostics.push(...output.diagnostics);\n      if (aggregateOutputSize > budget.maxOutputBytes) {\n        return {\n          kind: 'budget',\n          message: `Form script transaction output exceeded ${budget.maxOutputBytes} bytes`,\n        };\n      }\n      return output.error ?? null;\n    };\n    const remainingBudget = (): ScriptBudget | null => {\n      const remaining = budget.maxExecutionMs - executionMs;\n      return remaining <= 0 ? null : { ...budget, maxExecutionMs: remaining };\n    };\n    const world = (\n      fields: ScriptFieldInput[],\n      event: ScriptWorldInput['event'],\n    ): ScriptWorldInput => ({\n      fields,\n      pageNumber,\n      event,\n    });\n    const run = async (\n      source: string,\n      input: ScriptWorldInput,\n    ): Promise<{ output?: ScriptOutput; error?: ScriptExecutionError }> => {\n      const remaining = remainingBudget();\n      if (!remaining) {\n        return { error: { kind: 'budget', message: 'Form script transaction timed out' } };\n      }\n      let output: ScriptOutput;\n      try {\n        const startedAt = Date.now();\n        output = await txn.run(source, input, remaining);\n        executionMs += Date.now() - startedAt;\n      } catch (error) {\n        return {\n          error: scriptError(error instanceof Error ? error.message : String(error)),\n        };\n      }\n      const error = consume(output, 'user');\n      return error ? { error } : { output };\n    };\n\n    {\n      // Boot runs once per realm (host-owned latch) and can only ever\n      // degrade, never brick — a failure surfaces a diagnostic and this\n      // transaction continues from pristine state.\n      let boot: ScriptOutput | null = null;\n      try {\n        boot = await txn.boot(world(overlay.fields, { kind: 'name-tree-boot' }), budget);\n      } catch (error) {\n        diagnostics.push({\n          code: 'script-error',\n          message: `Document boot script failed (continuing without it): ${error instanceof Error ? error.message : String(error)}`,\n        });\n      }\n      if (boot) {\n        const bootError = consume(boot, 'boot');\n        if (!bootError) applyEffects(overlay, boot.formEffects);\n        else {\n          diagnostics.push({\n            code: 'script-error',\n            message: `Document boot script failed (continuing without it): ${bootError.message}`,\n          });\n        }\n      }\n    }\n\n    const bootEffects = canonicalEffects(overlay);\n\n    if (activation) {\n      let program: string;\n      try {\n        program = javaScriptProgramFromActionTree(activation);\n      } catch (error) {\n        return this.failed(\n          uiEffects,\n          diagnostics,\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n      if (program) {\n        const activated = await run(\n          program,\n          world(overlay.fields, {\n            kind: 'widget-activate',\n            target: ref,\n            source: ref,\n            value: targetInput.value,\n          }),\n        );\n        if (activated.error) return this.failed(uiEffects, diagnostics, activated.error);\n        applyEffects(overlay, activated.output!.formEffects);\n      }\n    }\n\n    if (!activation && hasProposedValue && target.actions?.keystroke && target.family === 'text') {\n      let program: string;\n      try {\n        program = javaScriptProgramFromActionTree(target.actions.keystroke);\n      } catch (error) {\n        return this.failed(\n          uiEffects,\n          diagnostics,\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n      if (program) {\n        // Acrobat fires per-typing keystroke events plus one final commit\n        // event. This pipeline compresses typing into one paste-shaped\n        // replacement (Acrobat's own paste contract: the whole string rides\n        // `event.change`, willCommit=false) so transform/filter scripts run,\n        // then fires the Acrobat-faithful willCommit pass (the full value on\n        // `event.value`, empty `change`) so AF* and commit validators see\n        // what Adobe's library expects.\n        const oldValue = String(targetInput.value ?? '');\n        const typing = await run(\n          program,\n          world(overlay.fields, {\n            kind: 'field-keystroke',\n            target: ref,\n            source: ref,\n            value: oldValue,\n            change: String(proposedValue ?? ''),\n            selStart: 0,\n            selEnd: oldValue.length,\n            willCommit: false,\n          }),\n        );\n        if (typing.error && typing.error.kind !== 'exception') {\n          return this.failed(uiEffects, diagnostics, typing.error);\n        }\n        if (typing.error) {\n          // Fault ladder: an exception is not a rejection. Keep the typed\n          // value, surface a diagnostic, and let the transaction continue.\n          diagnostics.push({\n            code: 'script-error',\n            message: `Keystroke script failed (kept the typed value): ${typing.error.message}`,\n          });\n        } else {\n          if (!typing.output!.event.rc) {\n            return this.rejected(bootEffects, uiEffects, diagnostics);\n          }\n          applyEffects(overlay, typing.output!.formEffects);\n          const event = typing.output!.event;\n          const base = String(event.value ?? '');\n          proposedValue =\n            base.slice(0, event.selStart) +\n            event.change +\n            base.slice(Math.max(event.selStart, event.selEnd));\n        }\n        const commit = await run(\n          program,\n          world(overlay.fields, {\n            kind: 'field-keystroke',\n            target: ref,\n            source: ref,\n            value: proposedValue,\n            change: '',\n            selStart: 0,\n            selEnd: 0,\n            willCommit: true,\n          }),\n        );\n        if (commit.error && commit.error.kind !== 'exception') {\n          return this.failed(uiEffects, diagnostics, commit.error);\n        }\n        if (commit.error) {\n          diagnostics.push({\n            code: 'script-error',\n            message: `Keystroke commit script failed (kept the typed value): ${commit.error.message}`,\n          });\n        } else {\n          if (!commit.output!.event.rc) {\n            return this.rejected(bootEffects, uiEffects, diagnostics);\n          }\n          applyEffects(overlay, commit.output!.formEffects);\n          proposedValue = cloneValue(commit.output!.event.value);\n        }\n      }\n    }\n\n    if (!activation && hasProposedValue) {\n      targetInput.value = cloneValue(proposedValue);\n      overlay.resetKeys.delete(refKey(ref));\n    }\n\n    if (!activation && hasProposedValue && target.actions?.validate) {\n      let program: string;\n      try {\n        program = javaScriptProgramFromActionTree(target.actions.validate);\n      } catch (error) {\n        return this.failed(\n          uiEffects,\n          diagnostics,\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n      if (program) {\n        const validation = await run(\n          program,\n          world(overlay.fields, {\n            kind: 'field-validate',\n            target: ref,\n            source: ref,\n            value: proposedValue,\n            willCommit: true,\n          }),\n        );\n        if (validation.error && validation.error.kind !== 'exception') {\n          return this.failed(uiEffects, diagnostics, validation.error);\n        }\n        if (validation.error) {\n          // Fault ladder: a broken validator must not reject the value.\n          diagnostics.push({\n            code: 'script-error',\n            message: `Validate script failed (accepted the value): ${validation.error.message}`,\n          });\n        } else {\n          if (!validation.output!.event.rc) {\n            return this.rejected(bootEffects, uiEffects, diagnostics);\n          }\n          targetInput.value = cloneValue(validation.output!.event.value);\n          applyEffects(overlay, validation.output!.formEffects);\n        }\n      }\n    }\n\n    const formatRefs: FormFieldRef[] = !activation && hasProposedValue ? [ref] : [];\n    for (const calculationRef of activation ? [] : snapshot.calculationOrder) {\n      if (!calculationRef) continue;\n      const calculated = snapshotField(snapshot, calculationRef);\n      const tree = calculated?.actions?.calculate;\n      if (!calculated || !tree) continue;\n      let program: string;\n      try {\n        program = javaScriptProgramFromActionTree(tree);\n      } catch (error) {\n        return this.failed(\n          uiEffects,\n          diagnostics,\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n      const calculatedInput = fieldByRef(overlay.fields, calculationRef);\n      if (program && calculatedInput) {\n        const calculation = await run(\n          program,\n          world(overlay.fields, {\n            kind: 'field-calculate',\n            target: calculationRef,\n            ...(hasProposedValue ? { source: ref } : {}),\n            value: calculatedInput.value,\n          }),\n        );\n        if (calculation.error && calculation.error.kind !== 'exception') {\n          return this.failed(uiEffects, diagnostics, calculation.error);\n        }\n        if (calculation.error) {\n          // Fault ladder: this field's calculation is skipped; the /CO chain continues.\n          diagnostics.push({\n            code: 'script-error',\n            message: `Calculate script failed (field left unchanged): ${calculation.error.message}`,\n          });\n        } else {\n          applyEffects(overlay, calculation.output!.formEffects);\n        }\n      }\n      if (!formatRefs.some((candidate) => sameRef(candidate, calculationRef))) {\n        formatRefs.push(calculationRef);\n      }\n    }\n\n    for (const formatRef of formatRefs) {\n      const field = snapshotField(snapshot, formatRef);\n      const tree = field?.actions?.format;\n      const overlayField = fieldByRef(overlay.fields, formatRef);\n      if (!field || !tree || !overlayField) continue;\n      let program: string;\n      try {\n        program = javaScriptProgramFromActionTree(tree);\n      } catch (error) {\n        return this.failed(\n          uiEffects,\n          diagnostics,\n          scriptError(error instanceof Error ? error.message : String(error)),\n        );\n      }\n      if (!program) continue;\n      const format = await run(\n        program,\n        world(overlay.fields, {\n          kind: 'field-format',\n          target: formatRef,\n          ...(hasProposedValue ? { source: ref } : {}),\n          value: overlayField.value,\n        }),\n      );\n      if (format.error && format.error.kind !== 'exception') {\n        return this.failed(uiEffects, diagnostics, format.error);\n      }\n      if (format.error) {\n        // Fault ladder: formatting is cosmetic — skip it, keep the raw value.\n        diagnostics.push({\n          code: 'script-error',\n          message: `Format script failed (kept the raw value): ${format.error.message}`,\n        });\n        continue;\n      }\n      applyEffects(overlay, format.output!.formEffects);\n    }\n\n    const effects = canonicalEffects(overlay);\n    if (effects.length + uiEffects.length > budget.maxEffects) {\n      return this.failed(uiEffects, diagnostics, {\n        kind: 'budget',\n        message: `Form script transaction exceeded ${budget.maxEffects} effects`,\n      });\n    }\n    return { status: 'accepted', effects, bootEffects, uiEffects, diagnostics };\n  }\n\n  private failed(\n    uiEffects: FormUiEffect[],\n    diagnostics: ScriptDiagnostic[],\n    error: ScriptExecutionError,\n  ): FormScriptResult {\n    return { status: 'failed', effects: [], bootEffects: [], uiEffects, diagnostics, error };\n  }\n\n  /** The value is refused; the open scripts' effects are still written. */\n  private rejected(\n    bootEffects: FormEffect[],\n    uiEffects: FormUiEffect[],\n    diagnostics: ScriptDiagnostic[],\n  ): FormScriptResult {\n    return { status: 'rejected', effects: [], bootEffects, uiEffects, diagnostics };\n  }\n}\n\nexport function createFormScriptingController(\n  options: FormScriptingControllerOptions,\n): FormScriptingController {\n  return new FormScriptingController(options);\n}\n"],"mappings":"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"}

package/dist/host-contract-1epLfK1S.d.cts

@@ -0,0 +1,87 @@
+import { N as FormSetValueResult, Y as Box, Z as ShownWidget, a as FormCommitResult, i as FormCapability } from "./contract-D-yQxw3H.cjs";
+import "@embedpdf/core";
+import { AnnotationRef, FormEffect, FormFieldDTO, FormFieldRef, PageRef, PdfActionTargetRef, WidgetAnnotation } from "@embedpdf/engine-core/runtime";
+import { ActionContext, ActionDiagnostic, ActionOrigin, ActionSubmitRequest, PdfAnnotationEventKind, SubmitIntent } from "@embedpdf/plugin-actions/contract";
+import { TextEditorLayout, TextEditorLayout as TextEditorLayout$1 } from "@embedpdf/core-form";
+import { FormCommitSinkResult } from "@embedpdf/plugin-actions/contract/host";
+import { AppearancePicture } from "@embedpdf/plugin-render/contract/host";
+import { SceneNode } from "@embedpdf/core-annotation";
+//#region src/services/looks.d.ts
+/** A widget as the painter draws it: its scene on the page (its text carries the faces it needs). */
+interface WidgetPainting {
+  readonly scene: readonly SceneNode[];
+}
+//#endregion
+//#region src/host-contract.d.ts
+/**
+ * The host lens: members for the framework layers and sibling plugins (the
+ * widget event feed, the text being typed, and the actions plugin's
+ * executors and sinks). Application code uses the public capability.
+ */
+interface FormHostCapability extends FormCapability {
+  /** Load a page's widgets (one annotation read per page), so `listWidgets(page)` has them. */
+  ensureLoaded(page: PageRef): Promise<void>;
+  /**
+   * The widgets a page shows, in the order the page draws them, each with the appearance state it
+   * shows and whether its look is `pending` (the view's isn't the confirmed one yet); hidden ones
+   * are left out. The form layer paints their pictures from it, and the painter's drawing
+   * (`getWidgetPainting`) for a pending one or one whose picture is older than its look. In design
+   * mode, while the widgets are lent to the annotation plugin, none: the annotation layer draws
+   * them.
+   */
+  listShownWidgets(page: PageRef): readonly ShownWidget[];
+  /**
+   * What a page's widget pictures depend on: its widgets at their picture
+   * versions (`5@2|6@7`). Load the pictures again when it changes, or when
+   * the appearance scale does. A checkbox that only switches its state
+   * doesn't move it.
+   */
+  getAppearanceEpoch(page: PageRef): string;
+  /**
+   * Every picture of a page's widgets, at rest, in every state, each with the
+   * picture version of its widget (`ShownWidget.pictureVersion`), through the
+   * render plugin; none without it. The form layer and design mode share them.
+   */
+  renderAppearances(page: PageRef, scale: number, signal?: AbortSignal): Promise<readonly AppearancePicture[]>;
+  /**
+   * What the widget looks like as the view has it, drawn by the painter (`@embedpdf/core-form`): its
+   * scene in page space, its text in the engine's own faces (each glyphs node carries the program
+   * to mount). The same object while nothing it shows changes; `null` for a widget the painter
+   * doesn't draw (a signature).
+   */
+  getWidgetPainting(widget: AnnotationRef): WidgetPainting | null;
+  /**
+   * Where a text field's editor shows `text` (what is typed in it), so it sits where the engine
+   * will draw it: the face, the size the engine draws at (a fitted size resolved for `text`),
+   * the text's box inside the widget's, one line's height and a comb's spacing, in page points.
+   * `null` for a widget that isn't a text field's.
+   */
+  getTextEditorLayout(widget: AnnotationRef, text: string): TextEditorLayout | null;
+  /** The page box in page space, for keeping a placement on the page; `null` for a page that isn't there. */
+  getPageBox(page: PageRef): Box | null;
+  /** Send a widget's pointer or focus event to the actions plugin, which runs its `/AA` actions. */
+  notifyWidgetEvent(field: FormFieldRef, widget: AnnotationRef, event: PdfAnnotationEventKind): void;
+  /** Run a ResetForm action: reset the fields it names (or all but them), then recalculate. */
+  resetFormAction(fields: PdfActionTargetRef[] | null, exclude: boolean, origin?: ActionOrigin): Promise<FormCommitResult>;
+  /** The fields a SubmitForm action sends: the form as the user sees it, once every fill on its way is answered. */
+  resolveSubmitDataset(intent: SubmitIntent, actionContext: ActionContext, diagnose: (diagnostic: ActionDiagnostic) => void): Promise<ActionSubmitRequest>;
+  /**
+   * Write what a document script changed in the fields, with the calculations a value causes,
+   * as one change: shown at once, sent once the script's transaction ends. Never rejects; a
+   * change it can't stage reports why, and the engine's refusal comes through the change queue.
+   */
+  commitScriptFormEffects(effects: FormEffect[]): Promise<FormCommitSinkResult>;
+  /**
+   * The text someone is typing in a field, before it's written (write/typing.ts): a keystroke
+   * calls `draftText`, blur or Enter `commitDraftText` (the field's scripts run then), Escape
+   * `discardDraftText`. A download writes a draft first, like Acrobat commits the field being
+   * edited before it saves. `commitDraftText` resolves `null` when there's nothing to write.
+   */
+  draftText(field: FormFieldRef, text: string): void;
+  commitDraftText(field: FormFieldRef): Promise<FormSetValueResult | null>;
+  discardDraftText(field: FormFieldRef): void;
+}
+declare const FormToken: import("@embedpdf/core").CapabilityToken<FormHostCapability>;
+//#endregion
+export { WidgetPainting as i, FormToken as n, TextEditorLayout$1 as r, FormHostCapability as t };
+//# sourceMappingURL=host-contract-1epLfK1S.d.cts.map