@embedpdf/plugin-form 3.0.0-next.11 → 3.0.0-next.13

package/dist/contract/host.d.cts

@@ -1,2 +1,2 @@
-import { a as FormHostCapability, l as FormToken } from "../types-Blr4QQM5.cjs";
+import { a as FormHostCapability, c as FormToken } from "../types-Bpc32Qmx.cjs";
 export { type FormHostCapability, FormToken };

package/dist/contract/host.d.ts

@@ -1,2 +1,2 @@
-import { a as FormHostCapability, l as FormToken } from "../types-BlXdnNRf.js";
+import { a as FormHostCapability, c as FormToken } from "../types-DRirhZKr.js";
 export { type FormHostCapability, FormToken };

package/dist/contract.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"contract.cjs","names":["FormHostToken"],"sources":["../src/contract.ts"],"sourcesContent":["/** Public form capability protocol without the form engine implementation. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { FormToken as FormHostToken } from './types';\nimport type { FormCapability } from './types';\n\nexport const FormToken = FormHostToken as unknown as CapabilityToken<FormCapability>;\nexport type {\n  Box,\n  FieldKey,\n  FillItem,\n  FormAction,\n  FormCapability,\n  FormCommitResult,\n  FormCommitStatus,\n  FormPluginOptions,\n  FormScriptingOptions,\n  FormState,\n  FormUiEffect,\n  PlacedField,\n  PlaceFieldInput,\n  WidgetActivationResult,\n} from './types';\nexport type { FormFieldDTO, FormFieldPatch, WidgetAppearance } from '@embedpdf/engine-core/runtime';\n"],"mappings":";;AAMA,MAAa,0CAAYA,CAAAA,CAAAA"}
+{"version":3,"file":"contract.cjs","names":["FormHostToken"],"sources":["../src/contract.ts"],"sourcesContent":["/** Public form capability protocol without the form engine implementation. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { FormToken as FormHostToken } from './types';\nimport type { FormCapability } from './types';\n\nexport const FormToken = FormHostToken as unknown as CapabilityToken<FormCapability>;\nexport type {\n  Box,\n  FieldKey,\n  FillItem,\n  FormAction,\n  FormCapability,\n  FormCommitResult,\n  FormCommitStatus,\n  FormPluginOptions,\n  FormState,\n  FormUiEffect,\n  PlacedField,\n  PlaceFieldInput,\n  WidgetActivationResult,\n  WidgetHit,\n} from './types';\nexport type {\n  FormFieldDTO,\n  FormFieldPatch,\n  FormFieldRef,\n  WidgetAppearance,\n} from '@embedpdf/engine-core/runtime';\n"],"mappings":";;AAMA,MAAa,0CAAYA,CAAAA,CAAAA"}

package/dist/contract.d.cts

@@ -1,8 +1,8 @@
-import { c as FormState, d as PlaceFieldInput, f as PlacedField, g as FieldKey, h as Box, i as FormCommitStatus, m as FillItem, n as FormCapability, o as FormPluginOptions, p as WidgetActivationResult, r as FormCommitResult, s as FormScriptingOptions, t as FormAction, u as FormUiEffect } from "./types-Blr4QQM5.cjs";
+import { _ as FillItem, b as WidgetHit, d as PlacedField, f as WidgetActivationResult, i as FormCommitStatus, l as FormUiEffect, n as FormCapability, o as FormPluginOptions, r as FormCommitResult, s as FormState, t as FormAction, u as PlaceFieldInput, v as Box, y as FieldKey } from "./types-Bpc32Qmx.cjs";
 import { CapabilityToken } from "@embedpdf/core";
-import { FormFieldDTO, FormFieldPatch, WidgetAppearance } from "@embedpdf/engine-core/runtime";
+import { FormFieldDTO, FormFieldPatch, FormFieldRef, WidgetAppearance } from "@embedpdf/engine-core/runtime";
 //#region src/contract.d.ts
 declare const FormToken: CapabilityToken<FormCapability>;
 //#endregion
-export { type Box, type FieldKey, type FillItem, type FormAction, type FormCapability, type FormCommitResult, type FormCommitStatus, type FormFieldDTO, type FormFieldPatch, type FormPluginOptions, type FormScriptingOptions, type FormState, FormToken, type FormUiEffect, type PlaceFieldInput, type PlacedField, type WidgetActivationResult, type WidgetAppearance };
+export { type Box, type FieldKey, type FillItem, type FormAction, type FormCapability, type FormCommitResult, type FormCommitStatus, type FormFieldDTO, type FormFieldPatch, type FormFieldRef, type FormPluginOptions, type FormState, FormToken, type FormUiEffect, type PlaceFieldInput, type PlacedField, type WidgetActivationResult, type WidgetAppearance, type WidgetHit };
 //# sourceMappingURL=contract.d.cts.map

package/dist/contract.d.ts

@@ -1,8 +1,8 @@
-import { c as FormState, d as PlaceFieldInput, f as PlacedField, g as FieldKey, h as Box, i as FormCommitStatus, m as FillItem, n as FormCapability, o as FormPluginOptions, p as WidgetActivationResult, r as FormCommitResult, s as FormScriptingOptions, t as FormAction, u as FormUiEffect } from "./types-BlXdnNRf.js";
+import { _ as FillItem, b as WidgetHit, d as PlacedField, f as WidgetActivationResult, i as FormCommitStatus, l as FormUiEffect, n as FormCapability, o as FormPluginOptions, r as FormCommitResult, s as FormState, t as FormAction, u as PlaceFieldInput, v as Box, y as FieldKey } from "./types-DRirhZKr.js";
 import { CapabilityToken } from "@embedpdf/core";
-import { FormFieldDTO, FormFieldPatch, WidgetAppearance } from "@embedpdf/engine-core/runtime";
+import { FormFieldDTO, FormFieldPatch, FormFieldRef, WidgetAppearance } from "@embedpdf/engine-core/runtime";
 //#region src/contract.d.ts
 declare const FormToken: CapabilityToken<FormCapability>;
 //#endregion
-export { type Box, type FieldKey, type FillItem, type FormAction, type FormCapability, type FormCommitResult, type FormCommitStatus, type FormFieldDTO, type FormFieldPatch, type FormPluginOptions, type FormScriptingOptions, type FormState, FormToken, type FormUiEffect, type PlaceFieldInput, type PlacedField, type WidgetActivationResult, type WidgetAppearance };
+export { type Box, type FieldKey, type FillItem, type FormAction, type FormCapability, type FormCommitResult, type FormCommitStatus, type FormFieldDTO, type FormFieldPatch, type FormFieldRef, type FormPluginOptions, type FormState, FormToken, type FormUiEffect, type PlaceFieldInput, type PlacedField, type WidgetActivationResult, type WidgetAppearance, type WidgetHit };
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","names":["FormHostToken"],"sources":["../src/contract.ts"],"sourcesContent":["/** Public form capability protocol without the form engine implementation. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { FormToken as FormHostToken } from './types';\nimport type { FormCapability } from './types';\n\nexport const FormToken = FormHostToken as unknown as CapabilityToken<FormCapability>;\nexport type {\n  Box,\n  FieldKey,\n  FillItem,\n  FormAction,\n  FormCapability,\n  FormCommitResult,\n  FormCommitStatus,\n  FormPluginOptions,\n  FormScriptingOptions,\n  FormState,\n  FormUiEffect,\n  PlacedField,\n  PlaceFieldInput,\n  WidgetActivationResult,\n} from './types';\nexport type { FormFieldDTO, FormFieldPatch, WidgetAppearance } from '@embedpdf/engine-core/runtime';\n"],"mappings":";;AAMA,MAAa,YAAYA"}
+{"version":3,"file":"contract.js","names":["FormHostToken"],"sources":["../src/contract.ts"],"sourcesContent":["/** Public form capability protocol without the form engine implementation. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { FormToken as FormHostToken } from './types';\nimport type { FormCapability } from './types';\n\nexport const FormToken = FormHostToken as unknown as CapabilityToken<FormCapability>;\nexport type {\n  Box,\n  FieldKey,\n  FillItem,\n  FormAction,\n  FormCapability,\n  FormCommitResult,\n  FormCommitStatus,\n  FormPluginOptions,\n  FormState,\n  FormUiEffect,\n  PlacedField,\n  PlaceFieldInput,\n  WidgetActivationResult,\n  WidgetHit,\n} from './types';\nexport type {\n  FormFieldDTO,\n  FormFieldPatch,\n  FormFieldRef,\n  WidgetAppearance,\n} from '@embedpdf/engine-core/runtime';\n"],"mappings":";;AAMA,MAAa,YAAYA"}

package/dist/index.cjs

@@ -198,6 +198,29 @@ const fieldForWidget = (model, annotObjectNumber) => {
 	const i = model.byWidget[annotObjectNumber];
 	return i === void 0 ? null : model.snapshot?.fields[i] ?? null;
 };
+const contains = (b, p) => p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;
+/**
+* The widget under a content-space point, from the model's loaded geometry
+* for that page (null when the page's geometry has not arrived, or nothing
+* is there). Nested widgets resolve to the smallest containing box.
+*/
+const widgetAt = (model, pageObjectNumber, point) => {
+	const geom = model.geom[pageObjectNumber];
+	if (!geom) return null;
+	let best = null;
+	for (const [key, box] of Object.entries(geom)) {
+		if (!contains(box, point)) continue;
+		const annotObjectNumber = Number(key);
+		const field = fieldForWidget(model, annotObjectNumber);
+		if (!field) continue;
+		if (!best || box.width * box.height < best.box.width * best.box.height) best = {
+			annotObjectNumber,
+			field,
+			box
+		};
+	}
+	return best;
+};
 //#endregion
 //#region src/core/fill-items.ts
 const ZERO_BOX = {
@@ -211,7 +234,7 @@ const ZERO_BOX = {
 * caller: the page projection reads the model's widget geometry; a consumer
 * that already owns a live box (the annotation plane's RenderItem) passes it —
 * or nothing, when only the semantics matter. Null for families with no fill
-* control (signature/unknown: rendered by the annotation plane only).
+* control (unknown: rendered by the annotation plane only).
 */
 function projectWidget(model, field, annotObjectNumber, box = ZERO_BOX) {
 	const key = fieldKeyOf(field);
@@ -274,6 +297,11 @@ function projectWidget(model, field, annotObjectNumber, box = ZERO_BOX) {
 			...base,
 			control: "button"
 		};
+		case "signature": return {
+			...base,
+			control: "signature",
+			signed: field.valueEntry.kind !== "none"
+		};
 		default: return null;
 	}
 }
@@ -355,28 +383,21 @@ function createFormCapability(ctx, options = {}) {
 	};
 	const enqueueMutation = createSerialMutationQueue();
 	const actionsHost = ctx.tryGet(_embedpdf_plugin_actions_contract_host.ActionsToken);
-	const scriptPort = actionsHost?.scriptTransaction?.bind(actionsHost) ?? null;
-	const scripting = scriptPort && ctx.doc ? require_scripting.createFormScriptingController({
+	const realm = actionsHost?.scriptRealm ?? null;
+	const scripting = realm && ctx.doc ? require_scripting.createFormScriptingController({
 		doc: ctx.doc,
 		document: () => ctx.document(),
-		transaction: scriptPort
+		transaction: realm.transaction.bind(realm),
+		budget: realm.budget
 	}) : null;
 	if (scripting) ctx.cleanup(() => scripting.dispose());
 	/** Every script surface (UI effects, diagnostics, errors) flows through
 	*  the actions plugin's ONE port — origin/phase attached (D9). */
 	const surfaceViaActions = (result, origin) => {
-		if (!actionsHost) return;
-		for (const phase of ["boot", "user"]) {
-			const uiEffects = result.uiEffects.filter((effect) => effect.phase === phase);
-			if (uiEffects.length === 0 && phase === "boot") continue;
-			actionsHost.surfaceScriptResult({
-				uiEffects,
-				diagnostics: phase === "user" ? result.diagnostics : [],
-				...phase === "user" && result.error ? { error: result.error } : {},
-				origin,
-				phase
-			});
-		}
+		actionsHost?.surfaceScriptCommit(result, {
+			origin,
+			realm: "document"
+		});
 	};
 	const can = (cap) => ctx.doc?.security.allows(cap) ?? false;
 	let refreshPromise = null;
@@ -421,6 +442,26 @@ function createFormCapability(ctx, options = {}) {
 			geomLoading.delete(pon);
 		});
 	};
+	const widgetAt$1 = (pon, point) => {
+		const m = model();
+		ensureGeom(pon);
+		if (m.geom[pon]) return widgetAt(m, pon, point);
+		if (!annotationHost) return null;
+		let best = null;
+		for (const item of annotationHost.pageItems(pon)) {
+			if (!item.subtype.startsWith("widget") || item.ref?.kind !== "objectNumber") continue;
+			const box = item.box;
+			if (!(point.x >= box.x && point.x <= box.x + box.width && point.y >= box.y && point.y <= box.y + box.height)) continue;
+			const field = fieldForWidget(m, item.ref.annotObjectNumber);
+			if (!field) continue;
+			if (!best || box.width * box.height < best.box.width * best.box.height) best = {
+				annotObjectNumber: item.ref.annotObjectNumber,
+				field,
+				box
+			};
+		}
+		return best;
+	};
 	const fuseFill = (item, fillable) => item === null || fillable || item.disabled ? item : {
 		...item,
 		disabled: true
@@ -769,6 +810,7 @@ function createFormCapability(ctx, options = {}) {
 		ensureGeom,
 		field: (key) => fieldByKey(model(), key),
 		fieldForWidget: (annotObjectNumber) => fieldForWidget(model(), annotObjectNumber),
+		widgetAt: widgetAt$1,
 		setText: (key, value) => write(key, {
 			type: "text",
 			value
@@ -987,6 +1029,10 @@ function registerFormEffects(ctx) {
 			refresh();
 			return;
 		}
+		if (event.type === "document.versioned" || event.type === "signature.completed") {
+			refresh();
+			return;
+		}
 		if (!event.type.startsWith("form.") || !("origin" in event)) return;
 		const structural = STRUCTURAL.has(event.type);
 		if (event.origin.kind !== "remote" && !structural) return;
@@ -1071,6 +1117,17 @@ const FORM_TOOLS = [
 			fontSize: 12
 		},
 		cursor: "crosshair"
+	},
+	{
+		id: "form-signature",
+		family: "signature",
+		visualKind: "widget-box",
+		clickCreate: {
+			width: 160,
+			height: 48
+		},
+		defaults: FIELD_CHROME,
+		cursor: "crosshair"
 	}
 ];
 const FORM_TOOL_BY_ID = new Map(FORM_TOOLS.map((t) => [t.id, t]));