gg-wf-scripts 2.8.0 → 3.0.0

package/dist/form-action-engine.js

@@ -1,35 +1,33 @@
-import { formActionRegistry } from "./form-actions.js";
+import { ATTR, SEL } from "./attrs.js";
 import { populateFields } from "./helpers/dom.js";
+import { findInputs } from "./helpers/form-field.js";
 import { runHandler } from "./helpers/run-handler.js";
 import { runWithLoading } from "./helpers/run-with-loading.js";
+import { onElement } from "./dom-observer.js";
 import { getParams } from "./query-params.js";
-function findInputs(form, name) {
-    const escaped = CSS.escape(name);
-    return form.querySelectorAll(`input[name="${escaped}"], select[name="${escaped}"], textarea[name="${escaped}"]`);
-}
 function clearFieldError(form, name) {
     findInputs(form, name).forEach((el) => {
-        el.removeAttribute("gg-form-field-invalid");
+        el.removeAttribute(ATTR.formFieldInvalid);
     });
     const escaped = CSS.escape(name);
     form
-        .querySelectorAll(`[gg-form-field-error="${escaped}"]`)
+        .querySelectorAll(`[${ATTR.formFieldError}="${escaped}"]`)
         .forEach((el) => {
         el.textContent = "";
     });
 }
 function clearFormErrors(form) {
-    form.querySelectorAll("[gg-form-field-invalid]").forEach((el) => {
-        el.removeAttribute("gg-form-field-invalid");
+    form.querySelectorAll(SEL.formFieldInvalid).forEach((el) => {
+        el.removeAttribute(ATTR.formFieldInvalid);
     });
-    form.querySelectorAll("[gg-form-field-error]").forEach((el) => {
+    form.querySelectorAll(SEL.formFieldError).forEach((el) => {
         el.textContent = "";
     });
-    form.querySelectorAll("[gg-form-error]").forEach((el) => {
+    form.querySelectorAll(SEL.formError).forEach((el) => {
         el.textContent = "";
     });
-    form.querySelectorAll("[gg-form-error-list]").forEach((list) => {
-        const template = list.querySelector("[gg-list-template]");
+    form.querySelectorAll(SEL.formErrorList).forEach((list) => {
+        const template = list.querySelector(SEL.listTemplate);
         Array.from(list.children).forEach((child) => {
             if (child !== template)
                 child.remove();
@@ -41,26 +39,26 @@ function applyFieldErrors(form, fieldErrors) {
         if (!name)
             return;
         findInputs(form, name).forEach((el) => {
-            el.setAttribute("gg-form-field-invalid", "true");
+            el.setAttribute(ATTR.formFieldInvalid, "true");
         });
         const escaped = CSS.escape(name);
         form
-            .querySelectorAll(`[gg-form-field-error="${escaped}"]`)
+            .querySelectorAll(`[${ATTR.formFieldError}="${escaped}"]`)
             .forEach((el) => {
             el.textContent = message ?? "";
         });
     });
 }
 function applyErrorList(form, fieldErrors) {
-    form.querySelectorAll("[gg-form-error-list]").forEach((list) => {
-        const template = list.querySelector("[gg-list-template]");
+    form.querySelectorAll(SEL.formErrorList).forEach((list) => {
+        const template = list.querySelector(SEL.listTemplate);
         if (!template) {
-            console.warn("[gg-form-error-list] no [gg-list-template] inside list:", list);
+            console.warn(`[${ATTR.formErrorList}] no [${ATTR.listTemplate}] inside list:`, list);
             return;
         }
         fieldErrors.forEach((record) => {
             const clone = template.cloneNode(true);
-            clone.removeAttribute("gg-list-template");
+            clone.removeAttribute(ATTR.listTemplate);
             clone.style.display = "";
             populateFields(clone, record);
             list.appendChild(clone);
@@ -71,7 +69,7 @@ function applyFormError(form, error) {
     if (error == null)
         return;
     const message = typeof error === "string" ? error : String(error);
-    form.querySelectorAll("[gg-form-error]").forEach((el) => {
+    form.querySelectorAll(SEL.formError).forEach((el) => {
         el.textContent = message;
     });
 }
@@ -86,71 +84,90 @@ function bindFieldClearOnInput(form) {
         const name = target.getAttribute("name");
         if (!name)
             return;
-        if (target.hasAttribute("gg-form-field-invalid")) {
+        if (target.hasAttribute(ATTR.formFieldInvalid)) {
             clearFieldError(form, name);
         }
     });
 }
-export function initFormActionEngine(context, { debug = false } = {}) {
-    async function handleSubmit(form, event) {
-        const id = form.getAttribute("gg-form-action");
-        if (!id)
-            return;
-        const action = formActionRegistry[id];
-        if (!action) {
-            console.warn(`[gg-form-action] no form action registered for "${id}"`);
-            return;
-        }
-        event.preventDefault();
-        if (form.hasAttribute("gg-loading"))
-            return;
-        if (form.hasAttribute("gg-confirm")) {
-            const text = form.getAttribute("gg-confirm-text") || "Are you sure?";
-            if (!window.confirm(text))
-                return;
-        }
-        clearFormErrors(form);
-        const formData = new FormData(form);
-        const params = getParams();
-        const submitControls = form.querySelectorAll('button[type="submit"], button:not([type]), input[type="submit"]');
-        const handlerResult = await runWithLoading([form, ...submitControls], () => runHandler({
+async function handleSubmit(form, event, deps) {
+    const id = form.getAttribute(ATTR.formAction);
+    if (!id)
+        return;
+    const action = deps.formActions[id];
+    if (!action) {
+        console.warn(`[gg-form-action] no form action registered for "${id}"`);
+        deps.emitError({
             prefix: "[gg-form-action]",
             id,
-            fields: {
-                form,
-                formData: Object.fromEntries(formData),
-                params: Object.fromEntries(params),
-            },
-            debug,
-        }, () => action(context, formData, params)));
-        if (!handlerResult.ok) {
-            applyFormError(form, "Something went wrong. Please try again.");
+            error: "no form action registered",
+            fields: { form },
+        });
+        return;
+    }
+    event.preventDefault();
+    if (form.hasAttribute(ATTR.loading))
+        return;
+    if (form.hasAttribute(ATTR.confirm)) {
+        const text = form.getAttribute(ATTR.confirmText) || "Are you sure?";
+        if (!window.confirm(text))
             return;
+    }
+    clearFormErrors(form);
+    const formData = new FormData(form);
+    const params = getParams();
+    const submitControls = form.querySelectorAll('button[type="submit"], button:not([type]), input[type="submit"]');
+    const handlerResult = await runWithLoading([form, ...submitControls], () => runHandler({
+        prefix: "[gg-form-action]",
+        id,
+        fields: {
+            form,
+            formData: Object.fromEntries(formData),
+            params: Object.fromEntries(params),
+        },
+        debug: deps.debug,
+        emitError: deps.emitError,
+    }, () => action(deps.context, formData, params)));
+    if (!handlerResult.ok) {
+        applyFormError(form, "Something went wrong. Please try again.");
+        return;
+    }
+    const result = handlerResult.value;
+    if (result && result.ok === false) {
+        const failure = result;
+        const fieldErrors = Array.isArray(failure.field_errors)
+            ? failure.field_errors
+            : [];
+        applyFieldErrors(form, fieldErrors);
+        applyErrorList(form, fieldErrors);
+        applyFormError(form, failure.error);
+        if (!fieldErrors.length && failure.error == null) {
+            console.warn(`[gg-form-action] "${id}" returned ok:false with no error or field_errors`);
         }
-        const result = handlerResult.value;
-        if (result && result.ok === false) {
-            const failure = result;
-            const fieldErrors = Array.isArray(failure.field_errors)
-                ? failure.field_errors
-                : [];
-            applyFieldErrors(form, fieldErrors);
-            applyErrorList(form, fieldErrors);
-            applyFormError(form, failure.error);
-            if (!fieldErrors.length && failure.error == null) {
-                console.warn(`[gg-form-action] "${id}" returned ok:false with no error or field_errors`);
-            }
-        }
+        deps.emitError({
+            prefix: "[gg-form-action]",
+            id,
+            error: failure.error ?? "validation",
+            fields: { form, fieldErrors },
+        });
     }
-    document
-        .querySelectorAll("form[gg-form-action]")
-        .forEach(bindFieldClearOnInput);
-    document.addEventListener("submit", (e) => {
+}
+export function initFormActionEngine(deps) {
+    const unbind = onElement(SEL.formAction, (el) => {
+        if (el instanceof HTMLFormElement)
+            bindFieldClearOnInput(el);
+    });
+    const onSubmit = (e) => {
         const form = e.target;
         if (form instanceof HTMLFormElement &&
-            form.hasAttribute("gg-form-action")) {
+            form.hasAttribute(ATTR.formAction)) {
             bindFieldClearOnInput(form);
-            handleSubmit(form, e);
+            handleSubmit(form, e, deps);
         }
-    });
+    };
+    document.addEventListener("submit", onSubmit);
+    return () => {
+        unbind();
+        document.removeEventListener("submit", onSubmit);
+    };
 }
 //# sourceMappingURL=form-action-engine.js.map

package/dist/form-action-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-action-engine.js","sourceRoot":"","sources":["../src/form-action-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-action-engine.js","sourceRoot":"","sources":["../src/form-action-engine.ts"],"names":[],"mappings":"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"}

package/dist/form-actions.d.ts

@@ -7,16 +7,4 @@ export type FormActionResult = {
     error?: unknown;
     field_errors?: FormFieldError[];
 };
-export type FormAction = (context: unknown, formData: FormData, params: URLSearchParams) => Promise<FormActionResult | void> | FormActionResult | void;
-export declare const formActionRegistry: Record<string, FormAction>;
-/**
- * Register a form action triggered by submitting a form with gg-form-action="<id>".
- *
- * Receives the context object passed to init(), a FormData snapshot of the submitted form,
- * and a URLSearchParams snapshot of the current URL query string. Return:
- * - { ok: true } on success
- * - { ok: false, field_errors: [{ name, message }, ...] } for validation errors
- * - { ok: false, error: "..." } for a single form-level error
- * - Both field_errors and error may be present together.
- */
-export declare function registerFormAction(id: string, fn: FormAction): void;
+export type FormAction<TContext = unknown> = (context: TContext, formData: FormData, params: URLSearchParams) => Promise<FormActionResult | void> | FormActionResult | void;

package/dist/form-actions.js

@@ -1,15 +1,2 @@
-export const formActionRegistry = {};
-/**
- * Register a form action triggered by submitting a form with gg-form-action="<id>".
- *
- * Receives the context object passed to init(), a FormData snapshot of the submitted form,
- * and a URLSearchParams snapshot of the current URL query string. Return:
- * - { ok: true } on success
- * - { ok: false, field_errors: [{ name, message }, ...] } for validation errors
- * - { ok: false, error: "..." } for a single form-level error
- * - Both field_errors and error may be present together.
- */
-export function registerFormAction(id, fn) {
-    formActionRegistry[id] = fn;
-}
+export {};
 //# sourceMappingURL=form-actions.js.map

package/dist/form-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-actions.js","sourceRoot":"","sources":["../src/form-actions.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,kBAAkB,GAA+B,EAAE,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,EAAc;IAC3D,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"form-actions.js","sourceRoot":"","sources":["../src/form-actions.ts"],"names":[],"mappings":""}

package/dist/form-visibility.d.ts

@@ -1 +1 @@
-export declare function initFormVisibility(): void;
+export declare function initFormVisibility(): () => void;

package/dist/form-visibility.js

@@ -1,3 +1,6 @@
+import { ATTR, SEL } from "./attrs.js";
+import { readField } from "./helpers/form-field.js";
+import { onElement } from "./dom-observer.js";
 const TRANSITION_MS = 200;
 function parseConditions(attr) {
     return attr
@@ -8,101 +11,99 @@ function parseConditions(attr) {
     })
         .filter((p) => p.name && p.value);
 }
-function getFieldValue(scope, name) {
-    const escaped = CSS.escape(name);
-    const inputs = scope.querySelectorAll(`input[name="${escaped}"], select[name="${escaped}"], textarea[name="${escaped}"]`);
-    if (!inputs.length)
-        return null;
-    const first = inputs[0];
-    const type = (first.getAttribute("type") || "").toLowerCase();
-    if (type === "radio" || type === "checkbox") {
-        for (const input of inputs) {
-            if (input instanceof HTMLInputElement && input.checked)
-                return input.value;
+function matchesAny(scope, conditions) {
+    return conditions.some(({ name, value }) => readField(scope, name) === value);
+}
+const bindings = new WeakMap();
+function setupVisibility(el) {
+    if (bindings.has(el))
+        return;
+    const attr = el.getAttribute(ATTR.visibleWhen);
+    if (!attr)
+        return;
+    const scope = el.closest(SEL.formScopeOrForm);
+    if (!scope) {
+        console.warn(`[${ATTR.visibleWhen}] element is not inside a <form> or [${ATTR.formScope}]:`, el);
+        return;
+    }
+    const conditions = parseConditions(attr);
+    el.style.transition = "none";
+    el.style.opacity = "0";
+    el.style.display = "none";
+    el.style.pointerEvents = "none";
+    el.setAttribute("inert", "");
+    el.setAttribute("aria-hidden", "true");
+    let lastState = false;
+    let hideTimer;
+    function show() {
+        if (hideTimer !== undefined) {
+            clearTimeout(hideTimer);
+            hideTimer = undefined;
         }
-        return null;
+        el.removeAttribute("inert");
+        el.removeAttribute("aria-hidden");
+        el.style.display = "";
+        el.style.pointerEvents = "";
+        requestAnimationFrame(() => {
+            el.style.opacity = "1";
+        });
     }
-    return first.value.trim();
-}
-function matchesAny(scope, conditions) {
-    return conditions.some(({ name, value }) => getFieldValue(scope, name) === value);
+    function hide() {
+        el.style.opacity = "0";
+        el.style.pointerEvents = "none";
+        el.setAttribute("inert", "");
+        el.setAttribute("aria-hidden", "true");
+        hideTimer = setTimeout(() => {
+            el.style.display = "none";
+            hideTimer = undefined;
+        }, TRANSITION_MS);
+    }
+    function evaluate() {
+        const shouldShow = matchesAny(scope, conditions);
+        if (shouldShow === lastState)
+            return;
+        lastState = shouldShow;
+        if (shouldShow)
+            show();
+        else
+            hide();
+    }
+    scope.addEventListener("change", evaluate);
+    scope.addEventListener("input", evaluate);
+    requestAnimationFrame(() => {
+        el.style.transition = `opacity ${TRANSITION_MS}ms ease`;
+        evaluate();
+    });
+    bindings.set(el, {
+        el,
+        scope,
+        conditions,
+        evaluate,
+        cleanup: () => {
+            scope.removeEventListener("change", evaluate);
+            scope.removeEventListener("input", evaluate);
+            if (hideTimer !== undefined)
+                clearTimeout(hideTimer);
+        },
+    });
 }
 export function initFormVisibility() {
-    // Group all [gg-visible-when] elements by their nearest scope —
-    // either an explicit [gg-form-scope] or a <form>.
-    const scopeTargets = new Map();
-    document.querySelectorAll("[gg-visible-when]").forEach((el) => {
-        if (!Boolean(el.getAttribute("gg-visible-when"))) {
-            return;
-        }
-        const scope = el.closest("[gg-form-scope], form");
-        if (!scope) {
-            console.warn("[gg-visible-when] element is not inside a <form> or [gg-form-scope]:", el);
+    const tracked = [];
+    const unbind = onElement(SEL.visibleWhen, (el) => {
+        if (!(el instanceof HTMLElement))
             return;
-        }
-        if (!scopeTargets.has(scope))
-            scopeTargets.set(scope, []);
-        scopeTargets.get(scope).push(el);
+        tracked.push(el);
+        setupVisibility(el);
     });
-    scopeTargets.forEach((targets, scope) => {
-        const conditions = new WeakMap();
-        const lastState = new WeakMap();
-        const hideTimers = new WeakMap();
-        targets.forEach((el) => {
-            conditions.set(el, parseConditions(el.getAttribute("gg-visible-when") ?? ""));
-            el.style.transition = "none";
-            el.style.opacity = "0";
-            el.style.display = "none";
-            el.style.pointerEvents = "none";
-            el.setAttribute("inert", "");
-            el.setAttribute("aria-hidden", "true");
-            lastState.set(el, false);
-        });
-        function show(el) {
-            const pending = hideTimers.get(el);
-            if (pending) {
-                clearTimeout(pending);
-                hideTimers.delete(el);
+    return () => {
+        unbind();
+        tracked.forEach((el) => {
+            const b = bindings.get(el);
+            if (b) {
+                b.cleanup();
+                bindings.delete(el);
             }
-            el.removeAttribute("inert");
-            el.removeAttribute("aria-hidden");
-            el.style.display = "";
-            el.style.pointerEvents = "";
-            requestAnimationFrame(() => {
-                el.style.opacity = "1";
-            });
-        }
-        function hide(el) {
-            el.style.opacity = "0";
-            el.style.pointerEvents = "none";
-            el.setAttribute("inert", "");
-            el.setAttribute("aria-hidden", "true");
-            const t = setTimeout(() => {
-                el.style.display = "none";
-                hideTimers.delete(el);
-            }, TRANSITION_MS);
-            hideTimers.set(el, t);
-        }
-        function evaluate() {
-            targets.forEach((el) => {
-                const shouldShow = matchesAny(scope, conditions.get(el) ?? []);
-                if (shouldShow === lastState.get(el))
-                    return;
-                lastState.set(el, shouldShow);
-                if (shouldShow)
-                    show(el);
-                else
-                    hide(el);
-            });
-        }
-        requestAnimationFrame(() => {
-            targets.forEach((el) => {
-                el.style.transition = `opacity ${TRANSITION_MS}ms ease`;
-            });
-            evaluate();
         });
-        scope.addEventListener("change", evaluate);
-        scope.addEventListener("input", evaluate);
-    });
+    };
 }
 //# sourceMappingURL=form-visibility.js.map

package/dist/form-visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-visibility.js","sourceRoot":"","sources":["../src/form-visibility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-visibility.js","sourceRoot":"","sources":["../src/form-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,aAAa,GAAG,GAAG,CAAC;AAI1B,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAa,EAAE;QACvB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB,EAAE,UAAuB;IAC5D,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,CACtD,CAAC;AACJ,CAAC;AAUD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAwB,CAAC;AAErD,SAAS,eAAe,CAAC,EAAe;IACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO;IAE7B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,IAAI,IAAI,CAAC,WAAW,wCAAwC,IAAI,CAAC,SAAS,IAAI,EAC9E,EAAE,CACH,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEzC,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC;IAC7B,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;IACvB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;IAChC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7B,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAEvC,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,SAAoD,CAAC;IAEzD,SAAS,IAAI;QACX,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5B,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;QAClC,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;QAC5B,qBAAqB,CAAC,GAAG,EAAE;YACzB,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,IAAI;QACX,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,EAAE,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;QAChC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7B,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACvC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;YAC1B,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC,EAAE,aAAa,CAAC,CAAC;IACpB,CAAC;IAED,SAAS,QAAQ;QACf,MAAM,UAAU,GAAG,UAAU,CAAC,KAAM,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,UAAU,KAAK,SAAS;YAAE,OAAO;QACrC,SAAS,GAAG,UAAU,CAAC;QACvB,IAAI,UAAU;YAAE,IAAI,EAAE,CAAC;;YAClB,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE1C,qBAAqB,CAAC,GAAG,EAAE;QACzB,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,WAAW,aAAa,SAAS,CAAC;QACxD,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE;QACf,EAAE;QACF,KAAK;QACL,UAAU;QACV,QAAQ;QACR,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC9C,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7C,IAAI,SAAS,KAAK,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACvD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE;QAC/C,IAAI,CAAC,CAAC,EAAE,YAAY,WAAW,CAAC;YAAE,OAAO;QACzC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,eAAe,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3B,IAAI,CAAC,EAAE,CAAC;gBACN,CAAC,CAAC,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/helpers/form-field.d.ts

@@ -0,0 +1,19 @@
+export type FieldInput = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+/**
+ * Find every named input/select/textarea matching `name` within `scope`.
+ * Used by the data engine, form-action engine, and form-visibility — anywhere
+ * we need to read or write a form field by its `name` attribute.
+ */
+export declare function findInputs(scope: ParentNode, name: string): FieldInput[];
+/**
+ * Read the current value of a named field. For radio/checkbox groups, returns
+ * the value of the checked input (or null if none checked). Returns null when
+ * no matching input exists. Trimmed for text-like inputs.
+ */
+export declare function readField(scope: ParentNode, name: string): string | null;
+/**
+ * Write a value into every input matching `name`, dispatching input/change so
+ * downstream listeners (visibility, query-bind) react. Skipped when value is
+ * null/undefined, so callers can pass `getPath(record, name)` directly.
+ */
+export declare function writeField(scope: ParentNode, name: string, value: unknown): void;

package/dist/helpers/form-field.js

@@ -0,0 +1,58 @@
+/**
+ * Find every named input/select/textarea matching `name` within `scope`.
+ * Used by the data engine, form-action engine, and form-visibility — anywhere
+ * we need to read or write a form field by its `name` attribute.
+ */
+export function findInputs(scope, name) {
+    const escaped = CSS.escape(name);
+    return Array.from(scope.querySelectorAll(`input[name="${escaped}"], select[name="${escaped}"], textarea[name="${escaped}"]`));
+}
+/**
+ * Read the current value of a named field. For radio/checkbox groups, returns
+ * the value of the checked input (or null if none checked). Returns null when
+ * no matching input exists. Trimmed for text-like inputs.
+ */
+export function readField(scope, name) {
+    const inputs = findInputs(scope, name);
+    if (!inputs.length)
+        return null;
+    const first = inputs[0];
+    const type = (first.getAttribute("type") || "").toLowerCase();
+    if (type === "radio" || type === "checkbox") {
+        for (const input of inputs) {
+            if (input instanceof HTMLInputElement && input.checked) {
+                return input.value;
+            }
+        }
+        return null;
+    }
+    return first.value.trim();
+}
+/**
+ * Write a value into every input matching `name`, dispatching input/change so
+ * downstream listeners (visibility, query-bind) react. Skipped when value is
+ * null/undefined, so callers can pass `getPath(record, name)` directly.
+ */
+export function writeField(scope, name, value) {
+    if (value == null)
+        return;
+    findInputs(scope, name).forEach((el) => {
+        if (el instanceof HTMLInputElement) {
+            if (el.type === "checkbox") {
+                el.checked = Boolean(value);
+            }
+            else if (el.type === "radio") {
+                el.checked = String(el.value) === String(value);
+            }
+            else {
+                el.value = String(value);
+            }
+        }
+        else {
+            el.value = String(value);
+        }
+        el.dispatchEvent(new Event("input", { bubbles: true }));
+        el.dispatchEvent(new Event("change", { bubbles: true }));
+    });
+}
+//# sourceMappingURL=form-field.js.map

package/dist/helpers/form-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field.js","sourceRoot":"","sources":["../../src/helpers/form-field.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,IAAY;IACxD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CACf,KAAK,CAAC,gBAAgB,CACpB,eAAe,OAAO,oBAAoB,OAAO,sBAAsB,OAAO,IAAI,CACnF,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,IAAY;IACvD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,YAAY,gBAAgB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,KAAK,CAAC,KAAK,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,KAAiB,EACjB,IAAY,EACZ,KAAc;IAEd,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO;IAC1B,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACrC,IAAI,EAAE,YAAY,gBAAgB,EAAE,CAAC;YACnC,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC3B,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;iBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC/B,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC"}