@embedpdf/plugin-actions 3.0.0-next.11 → 3.0.0-next.12

package/dist/contract/host.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"host.cjs","names":["PublicActionsToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/** Host-typed actions token and registration protocol for sibling plugins. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { ActionsToken as PublicActionsToken } from './types';\nimport type { ActionsHostCapability } from './types';\n\nexport const ActionsToken = PublicActionsToken as CapabilityToken<ActionsHostCapability>;\nexport type {\n  ActionExecutor,\n  ActionExecutorResult,\n  ActionsHostCapability,\n  ActionSubmitRequest,\n  AnnotCommitEntry,\n  AnnotCommitResult,\n  AnnotCommitSink,\n  FormCommitSink,\n  PageStateReport,\n  ScriptSurfaceResult,\n  SubmitIntent,\n  SubmitResolver,\n} from './types';\n"],"mappings":";;AAMA,MAAa,8CAAeA,CAAAA,CAAAA"}
+{"version":3,"file":"host.cjs","names":["PublicActionsToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/** Host-typed actions token and registration protocol for sibling plugins. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { ActionsToken as PublicActionsToken } from './types';\nimport type { ActionsHostCapability } from './types';\n\nexport const ActionsToken = PublicActionsToken as CapabilityToken<ActionsHostCapability>;\nexport type {\n  ActionExecutor,\n  ActionExecutorResult,\n  ActionsHostCapability,\n  ActionSubmitRequest,\n  AnnotCommitEntry,\n  AnnotCommitResult,\n  AnnotCommitSink,\n  DetachedScriptRealm,\n  FormCommitSink,\n  PageStateReport,\n  ScriptCommitSurface,\n  ScriptRealmKind,\n  ScriptRealmPort,\n  ScriptRealmTarget,\n  ScriptSurfaceResult,\n  SubmitIntent,\n  SubmitResolver,\n} from './types';\n"],"mappings":";;AAMA,MAAa,8CAAeA,CAAAA,CAAAA"}

package/dist/contract/host.d.cts

@@ -1,7 +1,7 @@
-import { C as ActionsHostCapability, D as AnnotCommitEntry, F as SubmitIntent, I as SubmitResolver, M as PageStateReport, O as AnnotCommitResult, P as ScriptSurfaceResult, a as ActionExecutor, g as ActionSubmitRequest, j as FormCommitSink, k as AnnotCommitSink, o as ActionExecutorResult } from "../types-DRQReAuO.cjs";
+import { A as DetachedScriptRealm, B as SubmitIntent, C as ActionsHostCapability, D as AnnotCommitEntry, F as ScriptCommitSurface, I as ScriptRealmKind, L as ScriptRealmPort, M as FormCommitSink, N as PageStateReport, O as AnnotCommitResult, R as ScriptRealmTarget, V as SubmitResolver, a as ActionExecutor, g as ActionSubmitRequest, k as AnnotCommitSink, o as ActionExecutorResult, z as ScriptSurfaceResult } from "../types-D-DoiESj.cjs";
 import { CapabilityToken } from "@embedpdf/core";
 //#region src/host-contract.d.ts
 declare const ActionsToken: CapabilityToken<ActionsHostCapability>;
 //#endregion
-export { type ActionExecutor, type ActionExecutorResult, type ActionSubmitRequest, type ActionsHostCapability, ActionsToken, type AnnotCommitEntry, type AnnotCommitResult, type AnnotCommitSink, type FormCommitSink, type PageStateReport, type ScriptSurfaceResult, type SubmitIntent, type SubmitResolver };
+export { type ActionExecutor, type ActionExecutorResult, type ActionSubmitRequest, type ActionsHostCapability, ActionsToken, type AnnotCommitEntry, type AnnotCommitResult, type AnnotCommitSink, type DetachedScriptRealm, type FormCommitSink, type PageStateReport, type ScriptCommitSurface, type ScriptRealmKind, type ScriptRealmPort, type ScriptRealmTarget, type ScriptSurfaceResult, type SubmitIntent, type SubmitResolver };
 //# sourceMappingURL=host.d.cts.map

package/dist/contract/host.d.ts

@@ -1,7 +1,7 @@
-import { C as ActionsHostCapability, D as AnnotCommitEntry, F as SubmitIntent, I as SubmitResolver, M as PageStateReport, O as AnnotCommitResult, P as ScriptSurfaceResult, a as ActionExecutor, g as ActionSubmitRequest, j as FormCommitSink, k as AnnotCommitSink, o as ActionExecutorResult } from "../types-DRQReAuO.js";
+import { A as DetachedScriptRealm, B as SubmitIntent, C as ActionsHostCapability, D as AnnotCommitEntry, F as ScriptCommitSurface, I as ScriptRealmKind, L as ScriptRealmPort, M as FormCommitSink, N as PageStateReport, O as AnnotCommitResult, R as ScriptRealmTarget, V as SubmitResolver, a as ActionExecutor, g as ActionSubmitRequest, k as AnnotCommitSink, o as ActionExecutorResult, z as ScriptSurfaceResult } from "../types-D-DoiESj.js";
 import { CapabilityToken } from "@embedpdf/core";
 //#region src/host-contract.d.ts
 declare const ActionsToken: CapabilityToken<ActionsHostCapability>;
 //#endregion
-export { type ActionExecutor, type ActionExecutorResult, type ActionSubmitRequest, type ActionsHostCapability, ActionsToken, type AnnotCommitEntry, type AnnotCommitResult, type AnnotCommitSink, type FormCommitSink, type PageStateReport, type ScriptSurfaceResult, type SubmitIntent, type SubmitResolver };
+export { type ActionExecutor, type ActionExecutorResult, type ActionSubmitRequest, type ActionsHostCapability, ActionsToken, type AnnotCommitEntry, type AnnotCommitResult, type AnnotCommitSink, type DetachedScriptRealm, type FormCommitSink, type PageStateReport, type ScriptCommitSurface, type ScriptRealmKind, type ScriptRealmPort, type ScriptRealmTarget, type ScriptSurfaceResult, type SubmitIntent, type SubmitResolver };
 //# sourceMappingURL=host.d.ts.map

package/dist/contract/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":["PublicActionsToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/** Host-typed actions token and registration protocol for sibling plugins. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { ActionsToken as PublicActionsToken } from './types';\nimport type { ActionsHostCapability } from './types';\n\nexport const ActionsToken = PublicActionsToken as CapabilityToken<ActionsHostCapability>;\nexport type {\n  ActionExecutor,\n  ActionExecutorResult,\n  ActionsHostCapability,\n  ActionSubmitRequest,\n  AnnotCommitEntry,\n  AnnotCommitResult,\n  AnnotCommitSink,\n  FormCommitSink,\n  PageStateReport,\n  ScriptSurfaceResult,\n  SubmitIntent,\n  SubmitResolver,\n} from './types';\n"],"mappings":";;AAMA,MAAa,eAAeA"}
+{"version":3,"file":"host.js","names":["PublicActionsToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/** Host-typed actions token and registration protocol for sibling plugins. */\nimport type { CapabilityToken } from '@embedpdf/core';\n\nimport { ActionsToken as PublicActionsToken } from './types';\nimport type { ActionsHostCapability } from './types';\n\nexport const ActionsToken = PublicActionsToken as CapabilityToken<ActionsHostCapability>;\nexport type {\n  ActionExecutor,\n  ActionExecutorResult,\n  ActionsHostCapability,\n  ActionSubmitRequest,\n  AnnotCommitEntry,\n  AnnotCommitResult,\n  AnnotCommitSink,\n  DetachedScriptRealm,\n  FormCommitSink,\n  PageStateReport,\n  ScriptCommitSurface,\n  ScriptRealmKind,\n  ScriptRealmPort,\n  ScriptRealmTarget,\n  ScriptSurfaceResult,\n  SubmitIntent,\n  SubmitResolver,\n} from './types';\n"],"mappings":";;AAMA,MAAa,eAAeA"}

package/dist/{contract-Cl-f3d61.d.ts → contract-COk-w3Fo.d.ts}

@@ -1,4 +1,4 @@
-import { _ as ActionTrigger, p as ActionSource, v as ActionTriggerResult } from "./types-DRQReAuO.js";
+import { _ as ActionTrigger, p as ActionSource, v as ActionTriggerResult } from "./types-D-DoiESj.js";
 import { AnnotationRef, FormSubmissionEntry, PageObjectNumber } from "@embedpdf/engine-core/runtime";
 //#region src/hover-pump.d.ts
 /** One hoverable target, as a feed sees it. `events` lets a feed that KNOWS
@@ -47,4 +47,4 @@ declare function createHoverPump(dispatch: (trigger: ActionTrigger) => Promise<A
 declare const submitEntriesToUrlEncoded: (entries: FormSubmissionEntry[]) => string;
 //#endregion
 export { createHoverPump as i, HoverPump as n, HoverTarget as r, submitEntriesToUrlEncoded as t };
-//# sourceMappingURL=contract-Cl-f3d61.d.ts.map
+//# sourceMappingURL=contract-COk-w3Fo.d.ts.map

package/dist/{contract-KaJQWh67.d.cts → contract-Os5y4NaD.d.cts}

@@ -1,4 +1,4 @@
-import { _ as ActionTrigger, p as ActionSource, v as ActionTriggerResult } from "./types-DRQReAuO.cjs";
+import { _ as ActionTrigger, p as ActionSource, v as ActionTriggerResult } from "./types-D-DoiESj.cjs";
 import { AnnotationRef, FormSubmissionEntry, PageObjectNumber } from "@embedpdf/engine-core/runtime";
 //#region src/hover-pump.d.ts
 /** One hoverable target, as a feed sees it. `events` lets a feed that KNOWS
@@ -47,4 +47,4 @@ declare function createHoverPump(dispatch: (trigger: ActionTrigger) => Promise<A
 declare const submitEntriesToUrlEncoded: (entries: FormSubmissionEntry[]) => string;
 //#endregion
 export { createHoverPump as i, HoverPump as n, HoverTarget as r, submitEntriesToUrlEncoded as t };
-//# sourceMappingURL=contract-KaJQWh67.d.cts.map
+//# sourceMappingURL=contract-Os5y4NaD.d.cts.map

package/dist/contract.d.cts

@@ -1,3 +1,3 @@
-import { A as DocumentTriggerEvent, E as ActionsToken, F as SubmitIntent, L as originOf, N as PdfAnnotationEventKind, S as ActionsCapability, _ as ActionTrigger, b as ActionUiContext, c as ActionNodeStatus, d as ActionPolicyDecision, f as ActionPolicyRow, g as ActionSubmitRequest, h as ActionSubmitHandler, i as ActionDispatchResult, l as ActionOrigin, m as ActionStepResult, n as ActionDiagnostic, p as ActionSource, r as ActionDispatchEvent, s as ActionNodeResult, t as ActionContext, u as ActionPolicy, v as ActionTriggerResult, w as ActionsPluginConfig, y as ActionUiAdapter } from "./types-DRQReAuO.cjs";
-import { i as createHoverPump, n as HoverPump, r as HoverTarget, t as submitEntriesToUrlEncoded } from "./contract-KaJQWh67.cjs";
+import { B as SubmitIntent, E as ActionsToken, H as originOf, P as PdfAnnotationEventKind, S as ActionsCapability, _ as ActionTrigger, b as ActionUiContext, c as ActionNodeStatus, d as ActionPolicyDecision, f as ActionPolicyRow, g as ActionSubmitRequest, h as ActionSubmitHandler, i as ActionDispatchResult, j as DocumentTriggerEvent, l as ActionOrigin, m as ActionStepResult, n as ActionDiagnostic, p as ActionSource, r as ActionDispatchEvent, s as ActionNodeResult, t as ActionContext, u as ActionPolicy, v as ActionTriggerResult, w as ActionsPluginConfig, y as ActionUiAdapter } from "./types-D-DoiESj.cjs";
+import { i as createHoverPump, n as HoverPump, r as HoverTarget, t as submitEntriesToUrlEncoded } from "./contract-Os5y4NaD.cjs";
 export { type ActionContext, type ActionDiagnostic, type ActionDispatchEvent, type ActionDispatchResult, type ActionNodeResult, type ActionNodeStatus, type ActionOrigin, type ActionPolicy, type ActionPolicyDecision, type ActionPolicyRow, type ActionSource, type ActionStepResult, type ActionSubmitHandler, type ActionSubmitRequest, type ActionTrigger, type ActionTriggerResult, type ActionUiAdapter, type ActionUiContext, type ActionsCapability, type ActionsPluginConfig, ActionsToken, type DocumentTriggerEvent, type HoverPump, type HoverTarget, type PdfAnnotationEventKind, type SubmitIntent, createHoverPump, originOf, submitEntriesToUrlEncoded };

package/dist/contract.d.ts

@@ -1,3 +1,3 @@
-import { A as DocumentTriggerEvent, E as ActionsToken, F as SubmitIntent, L as originOf, N as PdfAnnotationEventKind, S as ActionsCapability, _ as ActionTrigger, b as ActionUiContext, c as ActionNodeStatus, d as ActionPolicyDecision, f as ActionPolicyRow, g as ActionSubmitRequest, h as ActionSubmitHandler, i as ActionDispatchResult, l as ActionOrigin, m as ActionStepResult, n as ActionDiagnostic, p as ActionSource, r as ActionDispatchEvent, s as ActionNodeResult, t as ActionContext, u as ActionPolicy, v as ActionTriggerResult, w as ActionsPluginConfig, y as ActionUiAdapter } from "./types-DRQReAuO.js";
-import { i as createHoverPump, n as HoverPump, r as HoverTarget, t as submitEntriesToUrlEncoded } from "./contract-Cl-f3d61.js";
+import { B as SubmitIntent, E as ActionsToken, H as originOf, P as PdfAnnotationEventKind, S as ActionsCapability, _ as ActionTrigger, b as ActionUiContext, c as ActionNodeStatus, d as ActionPolicyDecision, f as ActionPolicyRow, g as ActionSubmitRequest, h as ActionSubmitHandler, i as ActionDispatchResult, j as DocumentTriggerEvent, l as ActionOrigin, m as ActionStepResult, n as ActionDiagnostic, p as ActionSource, r as ActionDispatchEvent, s as ActionNodeResult, t as ActionContext, u as ActionPolicy, v as ActionTriggerResult, w as ActionsPluginConfig, y as ActionUiAdapter } from "./types-D-DoiESj.js";
+import { i as createHoverPump, n as HoverPump, r as HoverTarget, t as submitEntriesToUrlEncoded } from "./contract-COk-w3Fo.js";
 export { type ActionContext, type ActionDiagnostic, type ActionDispatchEvent, type ActionDispatchResult, type ActionNodeResult, type ActionNodeStatus, type ActionOrigin, type ActionPolicy, type ActionPolicyDecision, type ActionPolicyRow, type ActionSource, type ActionStepResult, type ActionSubmitHandler, type ActionSubmitRequest, type ActionTrigger, type ActionTriggerResult, type ActionUiAdapter, type ActionUiContext, type ActionsCapability, type ActionsPluginConfig, ActionsToken, type DocumentTriggerEvent, type HoverPump, type HoverTarget, type PdfAnnotationEventKind, type SubmitIntent, createHoverPump, originOf, submitEntriesToUrlEncoded };

package/dist/index.cjs

@@ -3,6 +3,38 @@ const require_types = require("./types-BXJLAKXi.cjs");
 const require_contract = require("./contract-C1K3H4RP.cjs");
 let _embedpdf_core = require("@embedpdf/core");
 let _embedpdf_core_acrojs = require("@embedpdf/core-acrojs");
+//#region src/script-environment.ts
+function createScriptRealmFactory(js, identityDoc) {
+	const sandboxFactory = js.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox()));
+	const budget = js.budget ?? _embedpdf_core_acrojs.DEFAULT_SCRIPT_BUDGET;
+	return {
+		budget,
+		realmFor: (target) => (0, _embedpdf_core_acrojs.createScriptHost)({
+			sandboxFactory,
+			document: () => {
+				const meta = target.document();
+				return {
+					id: target.doc.id,
+					fileName: js.fileName?.() ?? meta?.name ?? "document.pdf",
+					pageCount: meta?.pageCount ?? 0,
+					pageNumber: 0
+				};
+			},
+			identity: () => (0, _embedpdf_core_acrojs.resolveScriptIdentity)(identityDoc, js.identity),
+			environment: (sequence) => {
+				const nowMs = js.now?.() ?? Date.now();
+				return {
+					nowMs,
+					utcOffsetMinutes: js.utcOffsetMinutes?.() ?? -new Date(nowMs).getTimezoneOffset(),
+					randomSeed: js.randomSeed?.() ?? (0, _embedpdf_core_acrojs.seedFrom)(target.doc.id, sequence)
+				};
+			},
+			bootSources: target.bootSources,
+			budget
+		})
+	};
+}
+//#endregion
 //#region src/capability.ts
 const ALLOW_ALL = {
 	user: "allow",
@@ -226,35 +258,13 @@ function createActionsCapability(ctx, config = {}) {
 		};
 	};
 	const js = config.javascript;
-	const scriptHost = js?.enabled && ctx.doc ? (0, _embedpdf_core_acrojs.createScriptHost)({
-		sandboxFactory: js.sandboxFactory ?? (() => import("@embedpdf/core-js-sandbox").then(({ createQuickJsSandbox }) => createQuickJsSandbox())),
-		document: () => {
-			const meta = ctx.document();
-			return {
-				id: ctx.documentId ?? "document",
-				fileName: js.fileName?.() ?? meta?.name ?? "document.pdf",
-				pageCount: meta?.pageCount ?? 0,
-				pageNumber: 0
-			};
-		},
-		identity: () => ctx.doc ? (0, _embedpdf_core_acrojs.resolveScriptIdentity)(ctx.doc, js.identity) : {
-			name: "",
-			loginName: "",
-			corporation: "",
-			email: ""
-		},
-		environment: (sequence) => {
-			const nowMs = js.now?.() ?? Date.now();
-			return {
-				nowMs,
-				utcOffsetMinutes: js.utcOffsetMinutes?.() ?? -new Date(nowMs).getTimezoneOffset(),
-				randomSeed: js.randomSeed?.() ?? (0, _embedpdf_core_acrojs.seedFrom)(ctx.documentId ?? "document", sequence)
-			};
-		},
+	const realms = js?.enabled && ctx.doc ? createScriptRealmFactory(js, ctx.doc) : null;
+	const scriptHost = realms && ctx.doc ? realms.realmFor({
+		doc: ctx.doc,
+		document: () => ctx.document(),
 		bootSources: async () => {
 			return ((await readDocumentActions())?.nameTreeScripts ?? []).map(({ action }) => (0, _embedpdf_core_acrojs.javaScriptProgramFromActionTree)(action));
-		},
-		...js.budget ? { budget: js.budget } : {}
+		}
 	}) : null;
 	if (scriptHost) ctx.cleanup(() => scriptHost.dispose());
 	const surfaceScriptResult = (result) => {
@@ -263,6 +273,13 @@ function createActionsCapability(ctx, config = {}) {
 			phase: result.phase
 		};
 		for (const effect of result.uiEffects) {
+			if (result.realm === "detached" && effect.kind !== "alert") {
+				scriptDiagnosticHook.emit({
+					code: "ui-effect-suppressed",
+					message: `script ${effect.kind} request from a detached realm suppressed: no document surface`
+				});
+				continue;
+			}
 			if (effect.kind === "submitForm") {
 				performSubmit(intentOfSubmitEffect(effect), {
 					origin: result.origin,
@@ -303,6 +320,23 @@ function createActionsCapability(ctx, config = {}) {
 		for (const diagnostic of result.diagnostics) scriptDiagnosticHook.emit(diagnostic);
 		if (result.error) scriptErrorHook.emit(result.error);
 	};
+	/** A K/V/C/F commit surfaces as up to two results: the boot phase (only
+	*  when it produced effects) and the user phase (always — it carries the
+	*  diagnostics and the error). */
+	const surfaceScriptCommit = (commit, context) => {
+		for (const phase of ["boot", "user"]) {
+			const uiEffects = commit.uiEffects.filter((effect) => effect.phase === phase);
+			if (uiEffects.length === 0 && phase === "boot") continue;
+			surfaceScriptResult({
+				uiEffects,
+				diagnostics: phase === "user" ? commit.diagnostics : [],
+				...phase === "user" && commit.error ? { error: commit.error } : {},
+				origin: context.origin,
+				phase,
+				realm: context.realm
+			});
+		}
+	};
 	/** Script `doc.submitForm(...)` → the one normalized intent. Script field
 	*  names are include-mode by definition (Acrobat's aFields). */
 	const intentOfSubmitEffect = (effect) => {
@@ -499,7 +533,8 @@ function createActionsCapability(ctx, config = {}) {
 						diagnostics: boot.diagnostics,
 						...boot.error ? { error: boot.error } : {},
 						origin: actionCtx.origin,
-						phase: "boot"
+						phase: "boot",
+						realm: "document"
 					});
 					if (boot.formEffects.length || boot.annotEffects.length) built = await scriptWorldFor(pon);
 				}
@@ -512,7 +547,8 @@ function createActionsCapability(ctx, config = {}) {
 					diagnostics: output.diagnostics,
 					...output.error ? { error: output.error } : {},
 					origin: actionCtx.origin,
-					phase: "user"
+					phase: "user",
+					realm: "document"
 				});
 				if (output.error) return {
 					status: "failed",
@@ -1336,8 +1372,22 @@ function createActionsCapability(ctx, config = {}) {
 				if (formCommitSink === sink) formCommitSink = null;
 			};
 		},
-		...scriptHost ? { scriptTransaction: (body) => scriptHost.transaction(body) } : {},
+		...scriptHost && realms ? {
+			scriptRealm: {
+				transaction: (body) => scriptHost.transaction(body),
+				budget: realms.budget
+			},
+			createDetachedScriptRealm: (target) => {
+				const host = realms.realmFor(target);
+				return {
+					transaction: (body) => host.transaction(body),
+					budget: realms.budget,
+					dispose: () => host.dispose()
+				};
+			}
+		} : {},
 		surfaceScriptResult,
+		surfaceScriptCommit,
 		reportPageState,
 		registerSubmitResolver: (resolver) => {
 			submitResolver = resolver;