@cocoar/vue-page-builder 2.19.0 → 3.0.0

package/dist/BuilderElementCodeDialog-DXGNzleE.js

@@ -0,0 +1,64 @@
+import { t as e } from "./_plugin-vue_export-helper-BTgDAbhb.js";
+import { c as t, o as n } from "./pageCode-echPQdna.js";
+import { n as r, t as i } from "./pageCodeAuthoring-C8grEAUf.js";
+import { computed as a, createElementBlock as o, createElementVNode as s, createTextVNode as c, createVNode as l, defineComponent as u, openBlock as d, ref as f, toDisplayString as p, unref as m, withCtx as h } from "vue";
+import { CoarButton as g } from "@cocoar/vue-ui";
+import { CoarScriptEditor as _ } from "@cocoar/vue-script-editor";
+//#region src/builder/BuilderElementCodeDialog.vue?vue&type=script&setup=true&lang.ts
+var v = { class: "pb-element-code-dialog" }, y = { class: "pb-element-code-dialog__meta" }, b = { class: "pb-element-code-dialog__editor" }, x = /* @__PURE__ */ e(/* @__PURE__ */ u({
+	__name: "BuilderElementCodeDialog",
+	props: {
+		schema: {},
+		node: {},
+		source: {},
+		stateCode: {},
+		config: {},
+		hostLibs: {},
+		close: { type: Function }
+	},
+	setup(e) {
+		let u = e, x = f(n(u.source)), S = a(() => i(t(u.stateCode), u.node)), C = a(() => [...r(u.schema, u.node, u.config), ...u.hostLibs ?? []]);
+		return (t, n) => (d(), o("div", v, [
+			s("div", y, [s("div", null, [n[3] ||= s("span", null, "Element", -1), s("strong", null, p(e.node.name) + " · " + p(e.node.type), 1)]), n[4] ||= s("div", null, [s("span", null, "Mutable target"), s("code", null, "element")], -1)]),
+			s("div", b, [l(m(_), {
+				modelValue: x.value,
+				"onUpdate:modelValue": n[0] ||= (e) => x.value = e,
+				language: "javascript",
+				"script-mode": !0,
+				preamble: S.value,
+				"extra-libs": C.value,
+				height: "clamp(360px, 58vh, 620px)",
+				placeholder: "defineElement({ compute, actions })"
+			}, null, 8, [
+				"modelValue",
+				"preamble",
+				"extra-libs"
+			])]),
+			n[7] ||= s("p", { class: "pb-element-code-dialog__hint" }, [
+				c(" Locked lines belong to the PageBuilder and cannot be renamed or deleted. Edit only the "),
+				s("code", null, "compute"),
+				c(" and "),
+				s("code", null, "click"),
+				c(" bodies between them. Configuration and runtime inputs are separated: "),
+				s("code", null, "element.*"),
+				c(" is only this element, shared inputs live on "),
+				s("code", null, "page.*"),
+				c(", and the event payload lives on "),
+				s("code", null, "action.payload"),
+				c(". ")
+			], -1),
+			s("footer", null, [l(m(g), {
+				variant: "secondary",
+				onClick: n[1] ||= (t) => e.close()
+			}, {
+				default: h(() => [...n[5] ||= [c("Cancel", -1)]]),
+				_: 1
+			}), l(m(g), { onClick: n[2] ||= (t) => e.close(x.value) }, {
+				default: h(() => [...n[6] ||= [c("Apply element code", -1)]]),
+				_: 1
+			})])
+		]));
+	}
+}), [["__scopeId", "data-v-037d2ed2"]]);
+//#endregion
+export { x as default };

package/dist/BuilderExpressionDialog-yIfwYgXD.js

@@ -0,0 +1,61 @@
+import { t as e } from "./_plugin-vue_export-helper-BTgDAbhb.js";
+import { i as t, n, t as r } from "./expressionAuthoring-7iAyadA3.js";
+import { computed as i, createElementBlock as a, createElementVNode as o, createTextVNode as s, createVNode as c, defineComponent as l, openBlock as u, ref as d, toDisplayString as f, unref as p, withCtx as m } from "vue";
+import { CoarButton as h } from "@cocoar/vue-ui";
+import { CoarScriptEditor as g } from "@cocoar/vue-script-editor";
+//#region src/builder/BuilderExpressionDialog.vue?vue&type=script&setup=true&lang.ts
+var _ = { class: "pb-expression-dialog" }, v = { class: "pb-expression-dialog__meta" }, y = { class: "pb-expression-dialog__editor" }, b = /* @__PURE__ */ e(/* @__PURE__ */ l({
+	__name: "BuilderExpressionDialog",
+	props: {
+		nodeId: {},
+		target: {},
+		expression: {},
+		config: {},
+		close: { type: Function }
+	},
+	setup(e) {
+		let l = e, b = d(l.expression), x = i(() => t(l.config)), S = i(() => n(l.target));
+		return (t, n) => (u(), a("div", _, [
+			o("div", v, [o("div", null, [n[3] ||= o("span", null, "Property", -1), o("strong", null, f(e.nodeId) + " · " + f(e.target), 1)]), o("div", null, [n[4] ||= o("span", null, "Result", -1), o("code", null, f(S.value), 1)])]),
+			o("div", y, [c(p(g), {
+				modelValue: b.value,
+				"onUpdate:modelValue": n[0] ||= (e) => b.value = e,
+				language: "javascript",
+				"script-mode": !0,
+				preamble: p(r),
+				"extra-libs": x.value,
+				height: "clamp(320px, 52vh, 520px)",
+				placeholder: "Enter a JavaScript expression…"
+			}, null, 8, [
+				"modelValue",
+				"preamble",
+				"extra-libs"
+			])]),
+			n[7] ||= o("p", { class: "pb-expression-dialog__hint" }, [
+				s(" Available: "),
+				o("code", null, "fields"),
+				s(", "),
+				o("code", null, "form"),
+				s(", "),
+				o("code", null, "context"),
+				s(", "),
+				o("code", null, "resources"),
+				s(", "),
+				o("code", null, "viewport"),
+				s(". IntelliSense shows the fields and context allowed by this page's host configuration. ")
+			], -1),
+			o("footer", null, [c(p(h), {
+				variant: "secondary",
+				onClick: n[1] ||= (t) => e.close()
+			}, {
+				default: m(() => [...n[5] ||= [s("Cancel", -1)]]),
+				_: 1
+			}), c(p(h), { onClick: n[2] ||= (t) => e.close(b.value) }, {
+				default: m(() => [...n[6] ||= [s("Apply expression", -1)]]),
+				_: 1
+			})])
+		]));
+	}
+}), [["__scopeId", "data-v-463025ca"]]);
+//#endregion
+export { b as default };

package/dist/BuilderLogicPanel-C9urz5Cd.js

@@ -0,0 +1,68 @@
+import { t as e } from "./_plugin-vue_export-helper-BTgDAbhb.js";
+import { a as t, l as n, t as r } from "./builderContext-B3rX2dxZ.js";
+import { c as i } from "./pageCode-echPQdna.js";
+import { a } from "./pageCodeAuthoring-C8grEAUf.js";
+import { computed as o, createCommentVNode as s, createElementBlock as c, createElementVNode as l, createTextVNode as u, createVNode as d, defineComponent as f, inject as p, openBlock as m, ref as h, unref as g, watch as _, withCtx as v } from "vue";
+import { CoarButton as y } from "@cocoar/vue-ui";
+import { CoarScriptEditor as b } from "@cocoar/vue-script-editor";
+//#region src/builder/BuilderLogicPanel.vue?vue&type=script&setup=true&lang.ts
+var x = { class: "pb-page-code" }, S = { class: "pb-page-code__toolbar" }, C = { class: "pb-page-code__actions" }, w = {
+	key: 0,
+	class: "pb-page-code__dirty"
+}, T = { class: "pb-page-code__editor" }, E = /* @__PURE__ */ e(/* @__PURE__ */ f({
+	__name: "BuilderLogicPanel",
+	setup(e) {
+		let f = p(r), E = p(t), D = p(n), O = o(() => i(f.schema.value.stateCode)), k = h(O.value), A = o(() => k.value !== O.value), j = o(() => [...a(E.value), ...D?.value ?? []]);
+		_(O, (e) => {
+			A.value || (k.value = e);
+		});
+		function M() {
+			f.patch([], { stateCode: k.value });
+		}
+		function N() {
+			k.value = O.value;
+		}
+		return (e, t) => (m(), c("section", x, [
+			l("header", S, [t[3] ||= l("div", null, [l("strong", null, "Page State"), l("span", null, "Customer-authored shared state for this page and all of its element scripts.")], -1), l("div", C, [
+				A.value ? (m(), c("span", w, "Unsaved changes")) : s("", !0),
+				d(g(y), {
+					size: "s",
+					variant: "secondary",
+					disabled: !A.value,
+					onClick: N
+				}, {
+					default: v(() => [...t[1] ||= [u("Revert", -1)]]),
+					_: 1
+				}, 8, ["disabled"]),
+				d(g(y), {
+					size: "s",
+					disabled: !A.value,
+					onClick: M
+				}, {
+					default: v(() => [...t[2] ||= [u("Apply state", -1)]]),
+					_: 1
+				}, 8, ["disabled"])
+			])]),
+			l("div", T, [d(g(b), {
+				modelValue: k.value,
+				"onUpdate:modelValue": t[0] ||= (e) => k.value = e,
+				language: "javascript",
+				"script-mode": !0,
+				"extra-libs": j.value,
+				height: "100%",
+				placeholder: "definePageState({ ... })"
+			}, null, 8, ["modelValue", "extra-libs"])]),
+			t[4] ||= l("footer", null, [l("span", null, [
+				u("The locked "),
+				l("code", null, "definePageState"),
+				u(" frame belongs to the Builder; only its object body is editable.")
+			]), l("span", null, [
+				u("Element actions may mutate "),
+				l("code", null, "state"),
+				u("; dependent element scripts update reactively.")
+			])], -1)
+		]));
+	}
+}), [["__scopeId", "data-v-d2484ca8"]]);
+//#endregion
+export { E as default };

package/dist/BuilderPageRootCodeDialog-CQsg_ozW.js

@@ -0,0 +1,61 @@
+import { t as e } from "./_plugin-vue_export-helper-BTgDAbhb.js";
+import { c as t, s as n } from "./pageCode-echPQdna.js";
+import { i as r, r as i } from "./pageCodeAuthoring-C8grEAUf.js";
+import { computed as a, createElementBlock as o, createElementVNode as s, createTextVNode as c, createVNode as l, defineComponent as u, openBlock as d, ref as f, unref as p, withCtx as m } from "vue";
+import { CoarButton as h } from "@cocoar/vue-ui";
+import { CoarScriptEditor as g } from "@cocoar/vue-script-editor";
+//#region src/builder/BuilderPageRootCodeDialog.vue?vue&type=script&setup=true&lang.ts
+var _ = { class: "pb-page-root-code-dialog" }, v = { class: "pb-page-root-code-dialog__editor" }, y = /* @__PURE__ */ e(/* @__PURE__ */ u({
+	__name: "BuilderPageRootCodeDialog",
+	props: {
+		schema: {},
+		source: {},
+		stateCode: {},
+		config: {},
+		hostLibs: {},
+		close: { type: Function }
+	},
+	setup(e) {
+		let u = e, y = f(n(u.source)), b = a(() => i(t(u.stateCode))), x = a(() => [...r(u.schema, u.config), ...u.hostLibs ?? []]);
+		return (t, n) => (d(), o("div", _, [
+			n[5] ||= s("div", { class: "pb-page-root-code-dialog__meta" }, [s("div", null, [s("span", null, "Element"), s("strong", null, "Page Root")]), s("div", null, [s("span", null, "Mutable target"), s("code", null, "page")])], -1),
+			s("div", v, [l(p(g), {
+				modelValue: y.value,
+				"onUpdate:modelValue": n[0] ||= (e) => y.value = e,
+				language: "javascript",
+				"script-mode": !0,
+				preamble: b.value,
+				"extra-libs": x.value,
+				height: "clamp(360px, 58vh, 620px)",
+				placeholder: "definePageRoot({ compute })"
+			}, null, 8, [
+				"modelValue",
+				"preamble",
+				"extra-libs"
+			])]),
+			n[6] ||= s("p", { class: "pb-page-root-code-dialog__hint" }, [
+				c(" Page Root Code can configure only "),
+				s("code", null, "page.style"),
+				c(", "),
+				s("code", null, "page.responsive"),
+				c(", and "),
+				s("code", null, "page.enterSubmits"),
+				c(". The tree, element types, names, and children remain owned by the visual builder. Reactive inputs are available on "),
+				s("code", null, "runtime.*"),
+				c(". ")
+			], -1),
+			s("footer", null, [l(p(h), {
+				variant: "secondary",
+				onClick: n[1] ||= (t) => e.close()
+			}, {
+				default: m(() => [...n[3] ||= [c("Cancel", -1)]]),
+				_: 1
+			}), l(p(h), { onClick: n[2] ||= (t) => e.close(y.value) }, {
+				default: m(() => [...n[4] ||= [c("Apply Page Code", -1)]]),
+				_: 1
+			})])
+		]));
+	}
+}), [["__scopeId", "data-v-f361c916"]]);
+//#endregion
+export { y as default };

package/dist/CoarPageBuilder.vue.d.ts

@@ -1,4 +1,13 @@
-import { PageNode, PageConfig } from './schema';
+import { CoarTheme, CoarThemeMode } from '@cocoar/vue-ui';
+import { PageNode, PageConfig, RuntimeExpressionValues, PageCompositionReference } from './schema';
+import { CoarScriptEditorExtraLib } from '@cocoar/vue-script-editor';
+import { PageCodeRuntimeValues } from './pageCode';
+import { PageRuntimeHost } from './runtime/PageRuntimeHost';
+import { AuthoringFinding } from './builder/useAuthoringFindings';
+import { PageBuilderAuthoringMode } from './builder/builderContext';
+import { ActionHandler, ActionValues } from './context';
+import { PageCompositionRepository } from './compositions';
+import { PageCompositionManagement } from './builder/usePageCompositions';
 type __VLS_Props = {
     /**
      * Security/allowlist config. The SAME config must also be passed to
@@ -6,16 +15,77 @@ type __VLS_Props = {
      * authoring (palette + add-child menu) and at render time (security boundary).
      */
     config?: PageConfig;
+    /** Safe sample context used only by the embedded preview; never persisted. */
+    previewContext?: Record<string, unknown>;
+    /**
+     * Field values the embedded preview starts from, merged OVER the schema's
+     * own `defaultValue`s exactly as at runtime. This is the edit-form case —
+     * and the case where the host computes a default the author did not write,
+     * such as a per-tenant "remember me" setting. Without it the preview can
+     * only ever show an empty form.
+     */
+    previewInitialValues?: ActionValues;
+    previewLocale?: string;
+    /** Host-owned theme applied only to the embedded renderer canvas. */
+    previewTheme?: CoarTheme;
+    /** Preview colour mode. `auto` follows the surrounding application/OS mode. */
+    previewThemeMode?: CoarThemeMode;
+    previewActions?: Record<string, ActionHandler>;
+    previewFallbackSchema?: PageNode;
+    /** Sandbox results used by the embedded preview; source code is never evaluated by the builder itself. */
+    previewExpressionValues?: RuntimeExpressionValues;
+    /** Code-driven mode keeps the inspector structural and makes Page Code authoritative. */
+    authoringMode?: PageBuilderAuthoringMode;
+    /** @deprecated The Builder now owns its preview runtime. */
+    previewPageCodeValues?: PageCodeRuntimeValues;
+    /** @deprecated Used only as a fallback for actions unknown to the Builder runtime. */
+    previewOnAction?: (id: string, values: ActionValues) => void | Promise<unknown>;
+    /** Application-owned capability host reused by the Builder's isolated preview session. */
+    previewRuntimeHost?: PageRuntimeHost;
+    previewRuntimePageId?: string;
+    previewRuntimeTenantId?: string;
+    /** Host capability declarations merged into Monaco IntelliSense. */
+    pageCodeExtraLibs?: CoarScriptEditorExtraLib[];
+    /** Optional host-owned persistence boundary for reusable, versioned subtrees. */
+    compositionRepository?: PageCompositionRepository;
+    /** `consume` keeps definition creation/publication in a separate host-owned editor. */
+    compositionManagement?: PageCompositionManagement;
 };
 type __VLS_PublicProps = {
     modelValue?: PageNode;
 } & __VLS_Props;
 declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: PageNode) => any;
+    "preview-values": (values: ActionValues) => any;
+    "preview-runtime": (scope: {
+        fields: ActionValues;
+        form: {
+            valid: boolean;
+            dirty: boolean;
+            validating: boolean;
+            submitting: boolean;
+        };
+    }) => any;
+    "open-composition": (reference: PageCompositionReference) => any;
+    findings: (findings: AuthoringFinding[]) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: PageNode) => any) | undefined;
+    "onPreview-values"?: ((values: ActionValues) => any) | undefined;
+    "onPreview-runtime"?: ((scope: {
+        fields: ActionValues;
+        form: {
+            valid: boolean;
+            dirty: boolean;
+            validating: boolean;
+            submitting: boolean;
+        };
+    }) => any) | undefined;
+    "onOpen-composition"?: ((reference: PageCompositionReference) => any) | undefined;
+    onFindings?: ((findings: AuthoringFinding[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;
+    previewViewportRef: HTMLDivElement;
+    previewFrameRef: HTMLDivElement;
 }, HTMLDivElement>;
 export default _default;
 //# sourceMappingURL=CoarPageBuilder.vue.d.ts.map

package/dist/CoarPageBuilder.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarPageBuilder.vue.d.ts","sourceRoot":"","sources":["../src/CoarPageBuilder.vue"],"names":[],"mappings":"AA8yBA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAqBrD,KAAK,WAAW,GAAG;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB,CAAC;AAyPF,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,WAAW,CAAC;;;;;;;;AA4hBhB,wBASG"}
+{"version":3,"file":"CoarPageBuilder.vue.d.ts","sourceRoot":"","sources":["../src/CoarPageBuilder.vue"],"names":[],"mappings":"AA6yCA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAsE,KAAK,QAAQ,EAAqB,KAAK,UAAU,EAAE,KAAK,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAC9M,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIjE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAO7F,OAAO,EAYL,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAQlC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAoCpG,KAAK,WAAW,GAAG;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,YAAY,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,aAAa,CAAA;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC9C,qBAAqB,CAAC,EAAE,QAAQ,CAAA;IAChC,0GAA0G;IAC1G,uBAAuB,CAAC,EAAE,uBAAuB,CAAA;IACjD,yFAAyF;IACzF,aAAa,CAAC,EAAE,wBAAwB,CAAA;IACxC,4DAA4D;IAC5D,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,sFAAsF;IACtF,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/E,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,eAAe,CAAA;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,wBAAwB,EAAE,CAAA;IAC9C,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;IACjD,uFAAuF;IACvF,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;CAClD,CAAC;AAkgBF,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,WAAW,CAAC;;;;;gBAjkBJ,YAAY;cACd;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE;;;;;;;;gBAD1E,YAAY;cACd;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE;;;;;;;;;AAu+CtF,wBASG"}

package/dist/CoarPageRenderer.vue.d.ts

@@ -1,8 +1,11 @@
-import { PageNode, PageConfig } from './schema';
+import { PageNode, PageConfig, RuntimeExpressionValues } from './schema';
 import { ActionHandler, ActionValues, CustomValidator } from './context';
+import { PageCodeRuntimeValues } from './pageCode';
 type __VLS_Props = {
     schema: PageNode;
     actions?: Record<string, ActionHandler>;
+    /** Optional dynamic action dispatcher (for Page Code action ids). */
+    onAction?: (id: string, values: ActionValues) => void | Promise<unknown>;
     /**
      * Developer-only: async or complex cross-field validation that cannot be
      * expressed declaratively. Returns fieldName → error message.
@@ -24,6 +27,18 @@ type __VLS_Props = {
      * schema change.
      */
     initialValues?: ActionValues;
+    /** Deterministic container width override, primarily for builder previews and tests. */
+    viewportWidth?: number;
+    /** Host-owned, typed runtime data. Only paths declared in config.contextFields are readable. */
+    runtimeContext?: Record<string, unknown>;
+    /** Active locale used to resolve LocalizedValue props. */
+    locale?: string;
+    /** Host-owned built-in document used when the customized document violates its contract. */
+    fallbackSchema?: PageNode;
+    /** Data-only results produced by a host-owned sandbox runtime. */
+    expressionValues?: RuntimeExpressionValues;
+    /** One atomic, data-only Page Code result produced by the host sandbox. */
+    pageCodeValues?: PageCodeRuntimeValues;
 };
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -45,12 +60,32 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     isDirty: import('vue').ComputedRef<boolean>;
     /** Quiet validation state — true when every declarative rule passes. */
     isFormValid: import('vue').ComputedRef<boolean>;
+    /** True while an invalid customization is replaced by fallbackSchema. */
+    usingFallback: import('vue').ComputedRef<boolean>;
     /** Back to the initial state: schema defaults + initialValues; touched/errors/banner cleared. */
     reset: () => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:values": (values: ActionValues) => any;
+    "runtime-change": (scope: {
+        fields: ActionValues;
+        form: {
+            valid: boolean;
+            dirty: boolean;
+            validating: boolean;
+            submitting: boolean;
+        };
+    }) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:values"?: ((values: ActionValues) => any) | undefined;
+    "onRuntime-change"?: ((scope: {
+        fields: ActionValues;
+        form: {
+            valid: boolean;
+            dirty: boolean;
+            validating: boolean;
+            submitting: boolean;
+        };
+    }) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootEl: HTMLDivElement;
 }, HTMLDivElement>;

package/dist/CoarPageRenderer.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CoarPageRenderer.vue.d.ts","sourceRoot":"","sources":["../src/CoarPageRenderer.vue"],"names":[],"mappings":"AAuqBA,OAAO,KAAK,EAA2B,QAAQ,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAC;AAS5F,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EAErB,MAAM,WAAW,CAAC;AAKnB,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,YAAY,CAAA;CAC7B,CAAC;AAumBF,iBAAS,cAAc;WA+DT,OAAO,IAA6B;;;;YAXhB,GAAG;;;;;;EAgBpC;AAeD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;IA1GnB,yFAAyF;;IAEzF,0DAA0D;;IAE1D,wEAAwE;;IAExE,iGAAiG;;;;;;;;kBA8GjG,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}
+{"version":3,"file":"CoarPageRenderer.vue.d.ts","sourceRoot":"","sources":["../src/CoarPageRenderer.vue"],"names":[],"mappings":"AAu1BA,OAAO,KAAK,EAA2B,QAAQ,EAAE,UAAU,EAA4B,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAUjI,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EAErB,MAAM,WAAW,CAAC;AAQnB,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG7E,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACvC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACxE;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,wFAAwF;IACxF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gGAAgG;IAChG,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,cAAc,CAAC,EAAE,QAAQ,CAAA;IACzB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;IAC1C,2EAA2E;IAC3E,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACvC,CAAC;AAwvBF,iBAAS,cAAc;WA+DT,OAAO,IAA6B;;;;YAXhB,GAAG;;;;;;EAgBpC;AAgBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;IA/GnB,yFAAyF;;IAEzF,0DAA0D;;IAE1D,wEAAwE;;IAExE,yEAAyE;;IAEzE,iGAAiG;;;;;gBA1tBvF,YAAY;cACd;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE;;;;;gBAD1E,YAAY;cACd;YAAE,KAAK,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE;;;;kBA00BpF,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAQpG,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC"}

package/dist/PageNode.vue.d.ts

@@ -1,8 +1,16 @@
-import { PageNode } from './schema';
+import { PageNode, RepeatSelection } from './schema';
 declare const _default: import('vue').DefineComponent<{
     node: PageNode;
+    item?: unknown;
+    itemIndex?: number;
+    allowedItemPaths?: ReadonlySet<string>;
+    repeatSelection?: RepeatSelection;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
     node: PageNode;
+    item?: unknown;
+    itemIndex?: number;
+    allowedItemPaths?: ReadonlySet<string>;
+    repeatSelection?: RepeatSelection;
 }> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;
 //# sourceMappingURL=PageNode.vue.d.ts.map

package/dist/PageNode.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageNode.vue.d.ts","sourceRoot":"","sources":["../src/PageNode.vue"],"names":[],"mappings":"AAiJA,OAAO,EAAsC,KAAK,QAAQ,EAAkB,MAAM,UAAU,CAAC;;UAsBlE,QAAQ;;UAAR,QAAQ;;AAHnC,wBAiMK"}
+{"version":3,"file":"PageNode.vue.d.ts","sourceRoot":"","sources":["../src/PageNode.vue"],"names":[],"mappings":"AAwNA,OAAO,EAAsC,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAkB,MAAM,UAAU,CAAC;;UAwB3G,QAAQ;WACP,OAAO;gBACF,MAAM;uBACC,WAAW,CAAC,MAAM,CAAC;sBACpB,eAAe;;UAJ3B,QAAQ;WACP,OAAO;gBACF,MAAM;uBACC,WAAW,CAAC,MAAM,CAAC;sBACpB,eAAe;;AARnC,wBA2PK"}

package/dist/VisualMarkupInspector-CmAOc-CH.js

@@ -0,0 +1,54 @@
+import { t as e } from "./_plugin-vue_export-helper-BTgDAbhb.js";
+import { a as t } from "./builderContext-B3rX2dxZ.js";
+import { t as n } from "./visualDocument-DKjWBfpW.js";
+import { Fragment as r, computed as i, createBlock as a, createCommentVNode as o, createElementBlock as s, createElementVNode as c, createVNode as l, defineComponent as u, inject as d, openBlock as f, renderList as p, toDisplayString as m, unref as h, withCtx as g } from "vue";
+import { CoarFormField as _, CoarNotice as v } from "@cocoar/vue-ui";
+import { CoarScriptEditor as y } from "@cocoar/vue-script-editor";
+//#region src/elements/visual-markup/VisualMarkupInspector.vue?vue&type=script&setup=true&lang.ts
+var b = { class: "pb-visual-errors" }, x = /* @__PURE__ */ e(/* @__PURE__ */ u({
+	__name: "VisualMarkupInspector",
+	props: {
+		node: {},
+		patch: { type: Function }
+	},
+	setup(e) {
+		let u = e, x = d(t), S = i(() => n(u.node.props.html ?? "", u.node.props.css ?? "", x?.value?.visualMarkup));
+		return (t, n) => (f(), s(r, null, [
+			S.value.ok ? o("", !0) : (f(), a(h(v), {
+				key: 0,
+				variant: "error"
+			}, {
+				default: g(() => [c("ul", b, [(f(!0), s(r, null, p(S.value.errors, (e) => (f(), s("li", { key: e }, m(e), 1))), 128))])]),
+				_: 1
+			})),
+			l(h(_), {
+				label: "Decorative HTML / inline SVG",
+				hint: "Scripts, links, forms, event handlers and external resources are rejected."
+			}, {
+				default: g(() => [l(h(y), {
+					language: "html",
+					"model-value": e.node.props.html ?? "",
+					height: "240px",
+					minimap: !1,
+					"onUpdate:modelValue": n[0] ||= (t) => e.patch({ props: { html: t } })
+				}, null, 8, ["model-value"])]),
+				_: 1
+			}),
+			l(h(_), {
+				label: "Iframe-local CSS",
+				hint: "Supports keyframes, media queries, custom properties and reduced motion."
+			}, {
+				default: g(() => [l(h(y), {
+					language: "css",
+					"model-value": e.node.props.css ?? "",
+					height: "240px",
+					minimap: !1,
+					"onUpdate:modelValue": n[1] ||= (t) => e.patch({ props: { css: t } })
+				}, null, 8, ["model-value"])]),
+				_: 1
+			})
+		], 64));
+	}
+}), [["__scopeId", "data-v-7e11a49f"]]);
+//#endregion
+export { x as default };

package/dist/_plugin-vue_export-helper-BTgDAbhb.js

@@ -0,0 +1,8 @@
+//#region \0plugin-vue:export-helper
+var e = (e, t) => {
+	let n = e.__vccOpts || e;
+	for (let [e, r] of t) n[e] = r;
+	return n;
+};
+//#endregion
+export { e as t };

package/dist/actionValues.d.ts

@@ -0,0 +1,21 @@
+import { ActionValues } from './context';
+import { ActionProps } from './schema';
+/** True when a value can cross the persisted Page JSON boundary without coercion. */
+export declare function isJsonSafeActionValue(value: unknown, depth?: number, ancestors?: Set<object>): boolean;
+export declare function isSafeActionValueField(field: unknown): field is string;
+/** Keys addressable through the flat `actionValues.<key>` binding target. */
+export declare function isBindableActionValueField(field: unknown): field is string;
+export declare function isJsonSafeActionValues(value: unknown): value is Record<string, unknown>;
+/**
+ * Resolves the optional per-element action arguments. The single dynamic
+ * value is deliberately applied last, so it can override a static entry with
+ * the same key. Invalid/non-JSON runtime values never reach the host handler.
+ */
+export declare function actionValuesFromProps(props: ActionProps): ActionValues;
+/**
+ * Final handler payload. Explicit per-action values win collisions with form
+ * fields because they are the trigger-specific arguments authored for this
+ * exact action. The returned object is a new top-level payload snapshot.
+ */
+export declare function mergeActionValues(formValues: ActionValues, actionValues?: ActionValues): ActionValues;
+//# sourceMappingURL=actionValues.d.ts.map

package/dist/actionValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionValues.d.ts","sourceRoot":"","sources":["../src/actionValues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAW3C,qFAAqF;AACrF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,SAAI,EACT,SAAS,cAAoB,GAC5B,OAAO,CAcT;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEtE;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvF;AAYD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAatE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,YAAY,CAErG"}