gg-wf-scripts 2.5.0 → 3.0.0

package/dist/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../src/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEtE,SAAS,SAAS;IAChB,IAAI,OAAO,KAAK,KAAK,WAAW;QAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,UAAU;IACjB,IAAI,OAAO,KAAK,KAAK,WAAW;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,CAAC;AACd,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB;IAC5B,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,UAAU,EAAE,CAAC;QACf,iBAAiB,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,WAAW,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,UAAU,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5E,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;IACf,CAAC;SAAM,CAAC;QACN,WAAW,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,GAAG,KAAK,OAAO;YAAE,OAAO;QAC5B,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IACxD,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,YAAY,iBAAiB,CAAC;YAAE,OAAO;QACnD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;YAAE,OAAO;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC5C,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI;YACrB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK;YACtB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG;YACpB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,OAAO;YAAE,qBAAqB,EAAE,CAAC;IACvC,CAAC,CAAC;IACF,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,CAAC,CAAQ,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,YAAY,iBAAiB,CAAC;YAAE,OAAO;QACnD,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,qBAAqB,EAAE,CAAC;IAC1B,CAAC,CAAC;IACF,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE9C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAErD,eAAe,EAAE,CAAC;IAElB,OAAO,GAAG,EAAE;QACV,WAAW,EAAE,CAAC;QACd,QAAQ,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAC3D,QAAQ,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QAC7D,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC"}

package/dist/dom-observer.d.ts

@@ -0,0 +1,4 @@
+type ElementHandler = (el: Element) => void;
+export declare function onElement(selector: string, handler: ElementHandler): () => void;
+export declare function startDomObserver(): () => void;
+export {};

package/dist/dom-observer.js

@@ -0,0 +1,47 @@
+/**
+ * Shared MutationObserver. Engines call `onElement(selector, handler)` to be
+ * notified when a matching element is present at start time **or** later
+ * inserted into the DOM (Webflow IX, CMS templates, custom elements). One
+ * observer for the whole library — not one per engine.
+ *
+ * `start()` returns the global teardown; `onElement()` returns a per-handler
+ * teardown so engines can clean up their own subscriptions in dispose().
+ */
+const subscriptions = [];
+let observer = null;
+export function onElement(selector, handler) {
+    const sub = { selector, handler };
+    subscriptions.push(sub);
+    document.querySelectorAll(selector).forEach(handler);
+    return () => {
+        const idx = subscriptions.indexOf(sub);
+        if (idx >= 0)
+            subscriptions.splice(idx, 1);
+    };
+}
+export function startDomObserver() {
+    if (observer)
+        return () => { };
+    observer = new MutationObserver((mutations) => {
+        for (const m of mutations) {
+            m.addedNodes.forEach((node) => {
+                if (!(node instanceof Element))
+                    return;
+                for (const sub of subscriptions) {
+                    if (node.matches(sub.selector))
+                        sub.handler(node);
+                    node
+                        .querySelectorAll(sub.selector)
+                        .forEach((el) => sub.handler(el));
+                }
+            });
+        }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    return () => {
+        observer?.disconnect();
+        observer = null;
+        subscriptions.length = 0;
+    };
+}
+//# sourceMappingURL=dom-observer.js.map

package/dist/dom-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-observer.js","sourceRoot":"","sources":["../src/dom-observer.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,MAAM,aAAa,GAAmB,EAAE,CAAC;AACzC,IAAI,QAAQ,GAA4B,IAAI,CAAC;AAE7C,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,OAAuB;IAEvB,MAAM,GAAG,GAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAChD,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,GAAG,IAAI,CAAC;YAAE,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,QAAQ;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC9B,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;QAC5C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC5B,IAAI,CAAC,CAAC,IAAI,YAAY,OAAO,CAAC;oBAAE,OAAO;gBACvC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;oBAChC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;wBAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAClD,IAAI;yBACD,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;yBAC9B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,GAAG,EAAE;QACV,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,QAAQ,GAAG,IAAI,CAAC;QAChB,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/dist/engine-deps.d.ts

@@ -0,0 +1,23 @@
+import type { GgErrorEvent } from "./errors.js";
+import type { Query } from "./queries.js";
+import type { Action } from "./actions.js";
+import type { FormAction } from "./form-actions.js";
+/**
+ * The minimum surface every engine needs. Engines should depend on this (or a
+ * superset) instead of the full `App<TContext>` so they're easier to test and
+ * the dependency graph stays explicit.
+ */
+export type EngineCore<TContext> = {
+    context: TContext;
+    debug: boolean;
+    emitError: (event: GgErrorEvent) => void;
+};
+export type DataEngineDeps<TContext> = EngineCore<TContext> & {
+    queries: Record<string, Query<TContext>>;
+};
+export type ActionEngineDeps<TContext> = EngineCore<TContext> & {
+    actions: Record<string, Action<TContext>>;
+};
+export type FormActionEngineDeps<TContext> = EngineCore<TContext> & {
+    formActions: Record<string, FormAction<TContext>>;
+};

package/dist/engine-deps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=engine-deps.js.map

package/dist/engine-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-deps.js","sourceRoot":"","sources":["../src/engine-deps.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Emitted whenever a registered query, action, or form action throws — and
+ * for non-throwing failure modes the engines detect (missing handler, wrong
+ * return shape). Subscribe via `app.onError(handler)` to forward to Sentry,
+ * Datadog, or any other error tracker.
+ */
+export type GgErrorEvent = {
+    /** Engine label, e.g. "[gg-action]", "[gg-data]", "[gg-form-action]". */
+    prefix: string;
+    /** Handler id (the value of the gg-action / gg-data / gg-form-action attr). */
+    id: string;
+    /** The thrown error or a string describing the non-throw failure. */
+    error: unknown;
+    /** Engine-specific context: trigger element, form, params, etc. */
+    fields?: Record<string, unknown>;
+};
+export type ErrorHandler = (event: GgErrorEvent) => void;
+/**
+ * Internal helper that owns the subscriber list. Lives on the App instance.
+ */
+export declare function createErrorBus(): {
+    subscribe: (handler: ErrorHandler) => () => void;
+    emit: (event: GgErrorEvent) => void;
+    clear: () => void;
+};

package/dist/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Internal helper that owns the subscriber list. Lives on the App instance.
+ */
+export function createErrorBus() {
+    const handlers = [];
+    return {
+        subscribe(handler) {
+            handlers.push(handler);
+            return () => {
+                const idx = handlers.indexOf(handler);
+                if (idx >= 0)
+                    handlers.splice(idx, 1);
+            };
+        },
+        emit(event) {
+            handlers.forEach((h) => {
+                try {
+                    h(event);
+                }
+                catch (err) {
+                    console.error("[gg] onError handler threw:", err);
+                }
+            });
+        },
+        clear() {
+            handlers.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,UAAU,cAAc;IAK5B,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,OAAO;QACL,SAAS,CAAC,OAAO;YACf,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,OAAO,GAAG,EAAE;gBACV,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACtC,IAAI,GAAG,IAAI,CAAC;oBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK;YACR,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrB,IAAI,CAAC;oBACH,CAAC,CAAC,KAAK,CAAC,CAAC;gBACX,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/form-action-engine.d.ts

@@ -0,0 +1,2 @@
+import type { FormActionEngineDeps } from "./engine-deps.js";
+export declare function initFormActionEngine<TContext>(deps: FormActionEngineDeps<TContext>): () => void;

package/dist/form-action-engine.js

@@ -0,0 +1,173 @@
+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 clearFieldError(form, name) {
+    findInputs(form, name).forEach((el) => {
+        el.removeAttribute(ATTR.formFieldInvalid);
+    });
+    const escaped = CSS.escape(name);
+    form
+        .querySelectorAll(`[${ATTR.formFieldError}="${escaped}"]`)
+        .forEach((el) => {
+        el.textContent = "";
+    });
+}
+function clearFormErrors(form) {
+    form.querySelectorAll(SEL.formFieldInvalid).forEach((el) => {
+        el.removeAttribute(ATTR.formFieldInvalid);
+    });
+    form.querySelectorAll(SEL.formFieldError).forEach((el) => {
+        el.textContent = "";
+    });
+    form.querySelectorAll(SEL.formError).forEach((el) => {
+        el.textContent = "";
+    });
+    form.querySelectorAll(SEL.formErrorList).forEach((list) => {
+        const template = list.querySelector(SEL.listTemplate);
+        Array.from(list.children).forEach((child) => {
+            if (child !== template)
+                child.remove();
+        });
+    });
+}
+function applyFieldErrors(form, fieldErrors) {
+    fieldErrors.forEach(({ name, message }) => {
+        if (!name)
+            return;
+        findInputs(form, name).forEach((el) => {
+            el.setAttribute(ATTR.formFieldInvalid, "true");
+        });
+        const escaped = CSS.escape(name);
+        form
+            .querySelectorAll(`[${ATTR.formFieldError}="${escaped}"]`)
+            .forEach((el) => {
+            el.textContent = message ?? "";
+        });
+    });
+}
+function applyErrorList(form, fieldErrors) {
+    form.querySelectorAll(SEL.formErrorList).forEach((list) => {
+        const template = list.querySelector(SEL.listTemplate);
+        if (!template) {
+            console.warn(`[${ATTR.formErrorList}] no [${ATTR.listTemplate}] inside list:`, list);
+            return;
+        }
+        fieldErrors.forEach((record) => {
+            const clone = template.cloneNode(true);
+            clone.removeAttribute(ATTR.listTemplate);
+            clone.style.display = "";
+            populateFields(clone, record);
+            list.appendChild(clone);
+        });
+    });
+}
+function applyFormError(form, error) {
+    if (error == null)
+        return;
+    const message = typeof error === "string" ? error : String(error);
+    form.querySelectorAll(SEL.formError).forEach((el) => {
+        el.textContent = message;
+    });
+}
+function bindFieldClearOnInput(form) {
+    if (form.__ggFormErrorBound)
+        return;
+    form.__ggFormErrorBound = true;
+    form.addEventListener("input", (e) => {
+        const target = e.target;
+        if (!(target instanceof Element))
+            return;
+        const name = target.getAttribute("name");
+        if (!name)
+            return;
+        if (target.hasAttribute(ATTR.formFieldInvalid)) {
+            clearFieldError(form, name);
+        }
+    });
+}
+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,
+            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`);
+        }
+        deps.emitError({
+            prefix: "[gg-form-action]",
+            id,
+            error: failure.error ?? "validation",
+            fields: { form, fieldErrors },
+        });
+    }
+}
+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(ATTR.formAction)) {
+            bindFieldClearOnInput(form);
+            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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+export type FormFieldError = {
+    name: string;
+    message: string;
+};
+export type FormActionResult = {
+    ok: boolean;
+    error?: unknown;
+    field_errors?: FormFieldError[];
+};
+export type FormAction<TContext = unknown> = (context: TContext, formData: FormData, params: URLSearchParams) => Promise<FormActionResult | void> | FormActionResult | void;

package/dist/form-actions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=form-actions.js.map

package/dist/form-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-actions.js","sourceRoot":"","sources":["../src/form-actions.ts"],"names":[],"mappings":""}

package/dist/form-visibility.d.ts

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

package/dist/form-visibility.js

@@ -0,0 +1,109 @@
+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
+        .split(",")
+        .map((pair) => {
+        const [name, value] = pair.split(":");
+        return { name: name?.trim() ?? "", value: value?.trim() ?? "" };
+    })
+        .filter((p) => p.name && p.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;
+        }
+        el.removeAttribute("inert");
+        el.removeAttribute("aria-hidden");
+        el.style.display = "";
+        el.style.pointerEvents = "";
+        requestAnimationFrame(() => {
+            el.style.opacity = "1";
+        });
+    }
+    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() {
+    const tracked = [];
+    const unbind = onElement(SEL.visibleWhen, (el) => {
+        if (!(el instanceof HTMLElement))
+            return;
+        tracked.push(el);
+        setupVisibility(el);
+    });
+    return () => {
+        unbind();
+        tracked.forEach((el) => {
+            const b = bindings.get(el);
+            if (b) {
+                b.cleanup();
+                bindings.delete(el);
+            }
+        });
+    };
+}
+//# sourceMappingURL=form-visibility.js.map

package/dist/form-visibility.js.map

@@ -0,0 +1 @@
+{"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/dom.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Set textContent on every [gg-field] descendant of `root` to the value
+ * at that field's dot-path on `record`. Null / missing values are left
+ * as-is (keeps whatever the markup's default content was).
+ */
+export declare function populateFields(root: Element, record: unknown): void;
+/**
+ * Write a normalized switch state onto an element.
+ * null / undefined become "" so gg-case="" can serve as the empty/default.
+ */
+export declare function setSwitchState(el: Element, value: unknown): void;
+/**
+ * Show the [gg-case] child whose value matches the container's current
+ * gg-switch-state; hide the rest with display:none.
+ */
+export declare function applySwitchState(container: Element): void;

package/dist/helpers/dom.js

@@ -0,0 +1,39 @@
+import { getPath } from "./path.js";
+/**
+ * Set textContent on every [gg-field] descendant of `root` to the value
+ * at that field's dot-path on `record`. Null / missing values are left
+ * as-is (keeps whatever the markup's default content was).
+ */
+export function populateFields(root, record) {
+    root.querySelectorAll("[gg-field]").forEach((el) => {
+        const path = el.getAttribute("gg-field");
+        if (!path)
+            return;
+        const value = getPath(record, path);
+        if (value != null)
+            el.textContent = String(value);
+    });
+}
+/**
+ * Write a normalized switch state onto an element.
+ * null / undefined become "" so gg-case="" can serve as the empty/default.
+ */
+export function setSwitchState(el, value) {
+    el.setAttribute("gg-switch-state", value == null ? "" : String(value));
+}
+/**
+ * Show the [gg-case] child whose value matches the container's current
+ * gg-switch-state; hide the rest with display:none.
+ */
+export function applySwitchState(container) {
+    const state = container.getAttribute("gg-switch-state") ?? "";
+    Array.from(container.children).forEach((child) => {
+        if (!(child instanceof HTMLElement))
+            return;
+        if (!child.hasAttribute("gg-case"))
+            return;
+        const match = child.getAttribute("gg-case") === state;
+        child.style.display = match ? "" : "none";
+    });
+}
+//# sourceMappingURL=dom.js.map

package/dist/helpers/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../src/helpers/dom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,MAAe;IAC3D,IAAI,CAAC,gBAAgB,CAAc,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK,IAAI,IAAI;YAAE,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAW,EAAE,KAAc;IACxD,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IAC9D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,OAAO;QAC5C,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC;YAAE,OAAO;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC;QACtD,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,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"}

package/dist/helpers/path.d.ts

@@ -0,0 +1,2 @@
+/** Resolve a dot-path on an object, e.g. getPath(row, "school.name"). */
+export declare function getPath(obj: unknown, path: string): unknown;

package/dist/helpers/path.js

@@ -0,0 +1,9 @@
+/** Resolve a dot-path on an object, e.g. getPath(row, "school.name"). */
+export function getPath(obj, path) {
+    return path.split(".").reduce((acc, key) => {
+        if (acc == null)
+            return undefined;
+        return acc[key];
+    }, obj);
+}
+//# sourceMappingURL=path.js.map