gg-wf-scripts 2.5.0 → 2.8.0

package/dist/form-action-engine.js

@@ -0,0 +1,156 @@
+import { formActionRegistry } from "./form-actions.js";
+import { populateFields } from "./helpers/dom.js";
+import { runHandler } from "./helpers/run-handler.js";
+import { runWithLoading } from "./helpers/run-with-loading.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");
+    });
+    const escaped = CSS.escape(name);
+    form
+        .querySelectorAll(`[gg-form-field-error="${escaped}"]`)
+        .forEach((el) => {
+        el.textContent = "";
+    });
+}
+function clearFormErrors(form) {
+    form.querySelectorAll("[gg-form-field-invalid]").forEach((el) => {
+        el.removeAttribute("gg-form-field-invalid");
+    });
+    form.querySelectorAll("[gg-form-field-error]").forEach((el) => {
+        el.textContent = "";
+    });
+    form.querySelectorAll("[gg-form-error]").forEach((el) => {
+        el.textContent = "";
+    });
+    form.querySelectorAll("[gg-form-error-list]").forEach((list) => {
+        const template = list.querySelector("[gg-list-template]");
+        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("gg-form-field-invalid", "true");
+        });
+        const escaped = CSS.escape(name);
+        form
+            .querySelectorAll(`[gg-form-field-error="${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]");
+        if (!template) {
+            console.warn("[gg-form-error-list] no [gg-list-template] inside list:", list);
+            return;
+        }
+        fieldErrors.forEach((record) => {
+            const clone = template.cloneNode(true);
+            clone.removeAttribute("gg-list-template");
+            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("[gg-form-error]").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("gg-form-field-invalid")) {
+            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({
+            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.");
+            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`);
+            }
+        }
+    }
+    document
+        .querySelectorAll("form[gg-form-action]")
+        .forEach(bindFieldClearOnInput);
+    document.addEventListener("submit", (e) => {
+        const form = e.target;
+        if (form instanceof HTMLFormElement &&
+            form.hasAttribute("gg-form-action")) {
+            bindFieldClearOnInput(form);
+            handleSubmit(form, e);
+        }
+    });
+}
+//# 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,22 @@
+export type FormFieldError = {
+    name: string;
+    message: string;
+};
+export type FormActionResult = {
+    ok: boolean;
+    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;

package/dist/form-actions.js

@@ -0,0 +1,15 @@
+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;
+}
+//# 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":"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"}

package/dist/form-visibility.d.ts

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

package/dist/form-visibility.js

@@ -0,0 +1,108 @@
+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 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;
+        }
+        return null;
+    }
+    return first.value.trim();
+}
+function matchesAny(scope, conditions) {
+    return conditions.some(({ name, value }) => getFieldValue(scope, name) === value);
+}
+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);
+            return;
+        }
+        if (!scopeTargets.has(scope))
+            scopeTargets.set(scope, []);
+        scopeTargets.get(scope).push(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);
+            }
+            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

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

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/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

package/dist/helpers/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/helpers/path.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,GAAY,EAAE,IAAY;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAClD,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC;QAClC,OAAQ,GAA+B,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC,EAAE,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/helpers/run-handler.d.ts

@@ -0,0 +1,22 @@
+type RunHandlerOptions = {
+    prefix: string;
+    id: string;
+    fields: Record<string, unknown>;
+    debug: boolean;
+};
+export type RunHandlerResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Run a registered handler with debug logging and errors-as-values.
+ *
+ * Catches throws so engine code can branch on a result instead of try/catch.
+ * On success, returns { ok: true, value } where value is whatever the handler
+ * returned. On throw, returns { ok: false, error } and logs the error.
+ */
+export declare function runHandler<T>({ prefix, id, fields, debug }: RunHandlerOptions, fn: () => Promise<T> | T): Promise<RunHandlerResult<T>>;
+export {};

package/dist/helpers/run-handler.js

@@ -0,0 +1,33 @@
+/**
+ * Run a registered handler with debug logging and errors-as-values.
+ *
+ * Catches throws so engine code can branch on a result instead of try/catch.
+ * On success, returns { ok: true, value } where value is whatever the handler
+ * returned. On throw, returns { ok: false, error } and logs the error.
+ */
+export async function runHandler({ prefix, id, fields, debug }, fn) {
+    if (debug) {
+        console.groupCollapsed(`${prefix} "${id}"`);
+        for (const [key, value] of Object.entries(fields)) {
+            console.log(`${key}:`, value);
+        }
+    }
+    const startedAt = debug ? performance.now() : 0;
+    try {
+        const value = await fn();
+        if (debug) {
+            const ms = (performance.now() - startedAt).toFixed(1);
+            console.log(`result (${ms}ms):`, value);
+        }
+        return { ok: true, value };
+    }
+    catch (error) {
+        console.error(`${prefix} "${id}" threw:`, error);
+        return { ok: false, error };
+    }
+    finally {
+        if (debug)
+            console.groupEnd();
+    }
+}
+//# sourceMappingURL=run-handler.js.map

package/dist/helpers/run-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handler.js","sourceRoot":"","sources":["../../src/helpers/run-handler.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAqB,EAChD,EAAwB;IAExB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,EAAE,CAAC;QACzB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/helpers/run-with-loading.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Set gg-loading="true" on each element while fn runs, clearing it (in a
+ * finally block) when fn resolves or throws. Form controls (button, input)
+ * also get native `disabled` toggled.
+ */
+export declare function runWithLoading<T>(elements: Iterable<Element>, fn: () => Promise<T> | T): Promise<T>;

package/dist/helpers/run-with-loading.js

@@ -0,0 +1,28 @@
+/**
+ * Set gg-loading="true" on each element while fn runs, clearing it (in a
+ * finally block) when fn resolves or throws. Form controls (button, input)
+ * also get native `disabled` toggled.
+ */
+export async function runWithLoading(elements, fn) {
+    const targets = [...elements];
+    targets.forEach(applyLoading);
+    try {
+        return await fn();
+    }
+    finally {
+        targets.forEach(clearLoading);
+    }
+}
+function applyLoading(el) {
+    el.setAttribute("gg-loading", "true");
+    if (el instanceof HTMLButtonElement || el instanceof HTMLInputElement) {
+        el.disabled = true;
+    }
+}
+function clearLoading(el) {
+    el.removeAttribute("gg-loading");
+    if (el instanceof HTMLButtonElement || el instanceof HTMLInputElement) {
+        el.disabled = false;
+    }
+}
+//# sourceMappingURL=run-with-loading.js.map

package/dist/helpers/run-with-loading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-with-loading.js","sourceRoot":"","sources":["../../src/helpers/run-with-loading.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAA2B,EAC3B,EAAwB;IAExB,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC9B,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAAW;IAC/B,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,EAAE,YAAY,iBAAiB,IAAI,EAAE,YAAY,gBAAgB,EAAE,CAAC;QACtE,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,EAAW;IAC/B,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IACjC,IAAI,EAAE,YAAY,iBAAiB,IAAI,EAAE,YAAY,gBAAgB,EAAE,CAAC;QACtE,EAAE,CAAC,QAAQ,GAAG,KAAK,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { registerQuery } from "./queries.js";
+import { registerAction } from "./actions.js";
+import { registerFormAction } from "./form-actions.js";
+import { setSwitchState, applySwitchState, populateFields } from "./helpers/dom.js";
+import { setQueryParams, removeQueryParams } from "./query-params.js";
+import { type AuthAdapter } from "./auth.js";
+export { setSwitchState, applySwitchState, populateFields, setQueryParams, removeQueryParams };
+export { getPath } from "./helpers/path.js";
+export type { AuthAdapter } from "./auth.js";
+export type { Query } from "./queries.js";
+export type { Action, ActionResult } from "./actions.js";
+export type { FormAction, FormActionResult, FormFieldError } from "./form-actions.js";
+export type InitOptions = {
+    /**
+     * Arbitrary object passed to every query and action. Put backend clients
+     * (Supabase, fetch wrappers, etc.) or anything else your queries need on it.
+     */
+    context?: unknown;
+    /**
+     * Auth adapter. If omitted, gg-auth/gg-role attrs are never set.
+     */
+    auth?: AuthAdapter;
+    /**
+     * When true, every query and action is logged to the console with its
+     * trigger/container, data, result, and duration.
+     */
+    debug?: boolean;
+};
+/**
+ * Create a gg-scripts app instance.
+ */
+export declare function init({ context, auth, debug }?: InitOptions): {
+    addQuery: typeof registerQuery;
+    addAction: typeof registerAction;
+    addFormAction: typeof registerFormAction;
+    start(): void;
+};

package/dist/index.js

@@ -0,0 +1,46 @@
+import { registerQuery } from "./queries.js";
+import { registerAction } from "./actions.js";
+import { registerFormAction } from "./form-actions.js";
+import { setSwitchState, applySwitchState, populateFields } from "./helpers/dom.js";
+import { setQueryParams, removeQueryParams, initQueryParams } from "./query-params.js";
+import { initAuth } from "./auth.js";
+import { initSwitchEngine } from "./switch-engine.js";
+import { initDialog } from "./dialog.js";
+import { initBridges } from "./bridges.js";
+import { initFormVisibility } from "./form-visibility.js";
+import { initDataEngine } from "./data-engine.js";
+import { initActionEngine } from "./action-engine.js";
+import { initFormActionEngine } from "./form-action-engine.js";
+export { setSwitchState, applySwitchState, populateFields, setQueryParams, removeQueryParams };
+export { getPath } from "./helpers/path.js";
+/**
+ * Create a gg-scripts app instance.
+ */
+export function init({ context = {}, auth, debug = false } = {}) {
+    return {
+        addQuery: registerQuery,
+        addAction: registerAction,
+        addFormAction: registerFormAction,
+        start() {
+            function run() {
+                if (auth)
+                    initAuth(context, auth);
+                initSwitchEngine();
+                initQueryParams();
+                initDialog();
+                initBridges();
+                initFormVisibility();
+                initDataEngine(context, { debug });
+                initActionEngine(context, { debug });
+                initFormActionEngine(context, { debug });
+            }
+            if (document.readyState === "loading") {
+                document.addEventListener("DOMContentLoaded", run);
+            }
+            else {
+                run();
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAoB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAuB5C;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,KAAkB,EAAE;IAC1E,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,SAAS,EAAE,cAAc;QACzB,aAAa,EAAE,kBAAkB;QACjC,KAAK;YACH,SAAS,GAAG;gBACV,IAAI,IAAI;oBAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAClC,gBAAgB,EAAE,CAAC;gBACnB,eAAe,EAAE,CAAC;gBAClB,UAAU,EAAE,CAAC;gBACb,WAAW,EAAE,CAAC;gBACd,kBAAkB,EAAE,CAAC;gBACrB,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnC,gBAAgB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACrC,oBAAoB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACtC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,GAAG,EAAE,CAAC;YACR,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/queries.d.ts

@@ -0,0 +1,10 @@
+export type Query = (context: unknown, params: URLSearchParams) => Promise<unknown> | unknown;
+export declare const queryRegistry: Record<string, Query>;
+/**
+ * Register a data query for use with gg-data, gg-data-form, or gg-data-list.
+ *
+ * Receives the context object passed to init() and a URLSearchParams snapshot of the
+ * current URL query string. Return a single object (or null) for gg-data/gg-data-form,
+ * or an array for gg-data-list.
+ */
+export declare function registerQuery(id: string, fn: Query): void;

package/dist/queries.js

@@ -0,0 +1,12 @@
+export const queryRegistry = {};
+/**
+ * Register a data query for use with gg-data, gg-data-form, or gg-data-list.
+ *
+ * Receives the context object passed to init() and a URLSearchParams snapshot of the
+ * current URL query string. Return a single object (or null) for gg-data/gg-data-form,
+ * or an array for gg-data-list.
+ */
+export function registerQuery(id, fn) {
+    queryRegistry[id] = fn;
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../src/queries.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,aAAa,GAA0B,EAAE,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,EAAS;IACjD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC"}