gg-wf-scripts 2.5.0 → 2.8.0

package/README.md

@@ -318,6 +318,39 @@ app.addAction("delete_post", async ({ sb }, { id }) => {
 });
 ```
 
+### Loading states
+
+While an action, query, or form action is in flight, the engine sets `gg-loading="true"` on the relevant element so you can style spinners, skeletons, or disabled visuals purely in CSS.
+
+| Trigger | Where `gg-loading` is set | Disabled? |
+|---|---|---|
+| `gg-action` | The trigger element itself | Native `disabled` is set if it's a `<button>` or `<input>` |
+| `gg-data` / `gg-data-list` / `gg-data-form` | The container | n/a (not click-triggered) |
+| `gg-form-action` | The `<form>` and every submit control inside it (`button[type="submit"]`, untyped `<button>`, `input[type="submit"]`) | Submit controls get native `disabled` |
+
+Re-clicks on a loading `gg-action` and re-submits on a loading `gg-form-action` are ignored. The attribute is removed in a `finally` block, so it's cleared even if the handler throws.
+
+Style with CSS:
+
+```css
+[gg-loading] { opacity: 0.6; pointer-events: none; }
+[gg-loading]::after { content: " ⟳"; }
+```
+
+### Confirm prompts
+
+Add `gg-confirm` to a `gg-action` trigger or `gg-form-action` form to require a `window.confirm` dialog before the handler runs. If the user cancels, the action is skipped (and form submission is prevented). Customize the prompt text with `gg-confirm-text`; if omitted it defaults to `"Are you sure?"`.
+
+```html
+<button gg-action="delete_post" gg-confirm gg-confirm-text="Delete this post?">
+  Delete
+</button>
+
+<form gg-form-action="wipe_account" gg-confirm gg-confirm-text="This cannot be undone. Continue?">
+  ...
+</form>
+```
+
 ## Config
 
 ### `init(options)`

package/dist/action-engine.d.ts

@@ -0,0 +1,3 @@
+export declare function initActionEngine(context: unknown, { debug }?: {
+    debug?: boolean;
+}): void;

package/dist/action-engine.js

@@ -0,0 +1,78 @@
+import { actionRegistry } from "./actions.js";
+import { runHandler } from "./helpers/run-handler.js";
+import { runWithLoading } from "./helpers/run-with-loading.js";
+import { getParams } from "./query-params.js";
+function parseActionData(el) {
+    const attr = el.getAttribute("gg-action-data");
+    if (!attr)
+        return {};
+    const data = {};
+    attr
+        .split(",")
+        .filter(Boolean)
+        .forEach((pair) => {
+        const [key, value] = pair.split(":");
+        if (key?.trim())
+            data[key.trim()] = value?.trim() ?? "";
+    });
+    return data;
+}
+function findRecord(el) {
+    let node = el.parentElement;
+    while (node) {
+        if (node.__ggRecord)
+            return node.__ggRecord;
+        node = node.parentElement;
+    }
+    return null;
+}
+export function initActionEngine(context, { debug = false } = {}) {
+    async function handleAction(el) {
+        if (el.hasAttribute("gg-loading"))
+            return;
+        const id = el.getAttribute("gg-action");
+        if (!id)
+            return;
+        const action = actionRegistry[id];
+        if (!action) {
+            console.warn(`[gg-action] no action registered for "${id}"`);
+            return;
+        }
+        if (el.hasAttribute("gg-confirm")) {
+            const text = el.getAttribute("gg-confirm-text") || "Are you sure?";
+            if (!window.confirm(text))
+                return;
+        }
+        const record = findRecord(el);
+        const explicit = parseActionData(el);
+        const data = record ? { ...record, ...explicit } : explicit;
+        const params = getParams();
+        const result = await runWithLoading([el], () => runHandler({
+            prefix: "[gg-action]",
+            id,
+            fields: { trigger: el, data, params: Object.fromEntries(params) },
+            debug,
+        }, () => action(context, data, params)));
+        if (!result.ok)
+            return;
+        if (result.value && result.value.ok === false) {
+            const failure = result.value;
+            console.warn(`[gg-action] "${id}" failed:`, failure.error ?? "unknown error");
+        }
+    }
+    document.addEventListener("click", (e) => {
+        const target = e.target;
+        if (!(target instanceof Element))
+            return;
+        const trigger = target.closest("[gg-action]");
+        if (trigger)
+            handleAction(trigger);
+    });
+    document.addEventListener("gg:shadow:click", (e) => {
+        const detail = e.detail;
+        const trigger = detail?.target?.closest?.("[gg-action]");
+        if (trigger)
+            handleAction(trigger);
+    });
+}
+//# sourceMappingURL=action-engine.js.map

package/dist/action-engine.js.map

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

package/dist/actions.d.ts

@@ -0,0 +1,14 @@
+export type ActionResult = {
+    ok: boolean;
+    error?: unknown;
+};
+export type Action = (context: unknown, data: Record<string, unknown>, params: URLSearchParams) => Promise<ActionResult | void> | ActionResult | void;
+export declare const actionRegistry: Record<string, Action>;
+/**
+ * Register an action triggered by gg-action="<id>" on click.
+ *
+ * Receives the context object passed to init(), a data object (merged from the nearest
+ * gg-data record and any explicit gg-action-data attribute), and a URLSearchParams
+ * snapshot of the current URL query string. Return { ok: true } or { ok: false, error }.
+ */
+export declare function registerAction(id: string, fn: Action): void;

package/dist/actions.js

@@ -0,0 +1,12 @@
+export const actionRegistry = {};
+/**
+ * Register an action triggered by gg-action="<id>" on click.
+ *
+ * Receives the context object passed to init(), a data object (merged from the nearest
+ * gg-data record and any explicit gg-action-data attribute), and a URLSearchParams
+ * snapshot of the current URL query string. Return { ok: true } or { ok: false, error }.
+ */
+export function registerAction(id, fn) {
+    actionRegistry[id] = fn;
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,cAAc,GAA2B,EAAE,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,EAAU;IACnD,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+export type AuthAdapter = {
+    getUser: () => string | null | Promise<string | null>;
+    onChange?: (cb: (userId: string | null) => void) => void;
+    roleQuery?: (context: unknown, userId: string) => Promise<string | null> | string | null;
+};
+export declare function initAuth(context: unknown, auth: AuthAdapter): Promise<void>;

package/dist/auth.js

@@ -0,0 +1,27 @@
+export async function initAuth(context, auth) {
+    const { getUser, onChange, roleQuery } = auth;
+    async function applyAuthAttrs(userId) {
+        const body = document.body;
+        if (!userId) {
+            body.setAttribute("gg-auth", "false");
+            body.removeAttribute("gg-role");
+            return;
+        }
+        body.setAttribute("gg-auth", "true");
+        if (roleQuery) {
+            const role = await roleQuery(context, userId);
+            if (role) {
+                body.setAttribute("gg-role", role);
+            }
+            else {
+                body.removeAttribute("gg-role");
+            }
+        }
+    }
+    const userId = await getUser();
+    applyAuthAttrs(userId ?? null);
+    if (onChange) {
+        onChange((userId) => applyAuthAttrs(userId ?? null));
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAgB,EAChB,IAAiB;IAEjB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAE9C,KAAK,UAAU,cAAc,CAAC,MAAqB;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9C,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;IAC/B,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IAE/B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/bridges.d.ts

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

package/dist/bridges.js

@@ -0,0 +1,33 @@
+import { setSwitchState } from "./helpers/dom.js";
+import { onQueryChanged } from "./query-params.js";
+export function initBridges() {
+    // ---- gg-switch-query: URL params → gg-switch-state ----
+    // On any URL param change, mirror its value onto matching
+    // [gg-switch-query="<key>"] elements' gg-switch-state.
+    onQueryChanged((key, value) => {
+        document
+            .querySelectorAll(`[gg-switch-query="${CSS.escape(key)}"]`)
+            .forEach((el) => setSwitchState(el, value));
+    });
+    // Initial-load pass: read current URL params and set state for every
+    // [gg-switch-query] on the page, so we don't flash before the first change.
+    const params = new URLSearchParams(window.location.search);
+    document.querySelectorAll("[gg-switch-query]").forEach((el) => {
+        const key = el.getAttribute("gg-switch-query");
+        if (!key)
+            return;
+        setSwitchState(el, params.get(key));
+    });
+    // ---- webflow:emit → Webflow IX ----
+    window.addEventListener("load", () => {
+        Webflow.push(() => {
+            const wfIx = Webflow.require("ix3");
+            document.addEventListener("webflow:emit", (e) => {
+                const detail = e.detail;
+                if (detail?.event)
+                    wfIx.emit(detail.event);
+            });
+        });
+    });
+}
+//# sourceMappingURL=bridges.js.map

package/dist/bridges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridges.js","sourceRoot":"","sources":["../src/bridges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,UAAU,WAAW;IACzB,0DAA0D;IAC1D,0DAA0D;IAC1D,uDAAuD;IACvD,cAAc,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5B,QAAQ;aACL,gBAAgB,CAAC,qBAAqB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;aAC1D,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,qEAAqE;IACrE,4EAA4E;IAC5E,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QAC5D,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;QACnC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YAChB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,QAAQ,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;gBAC9C,MAAM,MAAM,GAAI,CAAoC,CAAC,MAAM,CAAC;gBAC5D,IAAI,MAAM,EAAE,KAAK;oBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/data-engine.d.ts

@@ -0,0 +1,3 @@
+export declare function initDataEngine(context: unknown, { debug }?: {
+    debug?: boolean;
+}): void;

package/dist/data-engine.js

@@ -0,0 +1,158 @@
+import { getPath } from "./helpers/path.js";
+import { populateFields, setSwitchState, applySwitchState, } from "./helpers/dom.js";
+import { runHandler } from "./helpers/run-handler.js";
+import { runWithLoading } from "./helpers/run-with-loading.js";
+import { queryRegistry } from "./queries.js";
+import { onQueryChanged, getParams } from "./query-params.js";
+function applySwitchFields(root, record) {
+    root.querySelectorAll("[gg-switch-field]").forEach((el) => {
+        const path = el.getAttribute("gg-switch-field");
+        if (!path)
+            return;
+        const value = getPath(record, path);
+        setSwitchState(el, value);
+        applySwitchState(el);
+    });
+}
+function queryDeep(root, selector) {
+    const results = [...root.querySelectorAll(selector)];
+    root.querySelectorAll("*").forEach((el) => {
+        if (el.shadowRoot)
+            results.push(...queryDeep(el.shadowRoot, selector));
+    });
+    return results;
+}
+function applyDataValues(root, record) {
+    queryDeep(root, "[gg-data-key]").forEach((el) => {
+        const path = el.getAttribute("gg-data-key");
+        const value = path ? getPath(record, path) : record;
+        if (value === undefined)
+            return;
+        el.setAttribute("gg-data-value", JSON.stringify(value));
+    });
+}
+function populateFormFields(root, record) {
+    root
+        .querySelectorAll("input[name], select[name], textarea[name]")
+        .forEach((el) => {
+        const name = el.getAttribute("name");
+        if (!name)
+            return;
+        const value = getPath(record, name);
+        if (value == null)
+            return;
+        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 }));
+    });
+}
+export function initDataEngine(context, { debug = false } = {}) {
+    async function runQuery(container) {
+        const isList = container.hasAttribute("gg-data-list");
+        const isForm = container.hasAttribute("gg-data-form");
+        const id = container.getAttribute(isList ? "gg-data-list" : isForm ? "gg-data-form" : "gg-data");
+        if (!id)
+            return;
+        const query = queryRegistry[id];
+        if (!query) {
+            console.warn(`[gg-data] no query registered for "${id}"`);
+            return;
+        }
+        const params = getParams();
+        const handlerResult = await runWithLoading([container], () => runHandler({
+            prefix: "[gg-data]",
+            id,
+            fields: { container, params: Object.fromEntries(params) },
+            debug,
+        }, () => query(context, params)));
+        if (!handlerResult.ok)
+            return;
+        const result = handlerResult.value;
+        if (result === undefined)
+            return;
+        if (isList) {
+            if (!Array.isArray(result)) {
+                console.warn(`[gg-data-list] query "${id}" did not return an array`);
+                return;
+            }
+            const template = container.querySelector("[gg-list-template]");
+            if (!template) {
+                console.warn(`[gg-data-list] no [gg-list-template] inside "${id}"`);
+                return;
+            }
+            Array.from(container.children).forEach((child) => {
+                if (child !== template)
+                    child.remove();
+            });
+            result.forEach((record) => {
+                const clone = template.cloneNode(true);
+                clone.removeAttribute("gg-list-template");
+                clone.setAttribute("gg-query-set", `modal:view,id:${record.id}`);
+                clone.style.display = "flex";
+                if (record?.id != null)
+                    clone.id = String(record.id);
+                clone.__ggRecord = record;
+                populateFields(clone, record);
+                applySwitchFields(clone, record);
+                applyDataValues(clone, record);
+                container.appendChild(clone);
+            });
+        }
+        else if (isForm) {
+            if (Array.isArray(result)) {
+                console.warn(`[gg-data-form] query "${id}" returned an array; expected a single record`);
+                return;
+            }
+            if (!result)
+                return;
+            const record = result;
+            container.__ggRecord = record;
+            populateFormFields(container, record);
+            applyDataValues(container, record);
+        }
+        else {
+            if (Array.isArray(result)) {
+                console.warn(`[gg-data] query "${id}" returned an array; use gg-data-list instead`);
+                return;
+            }
+            if (!result)
+                return;
+            const record = result;
+            container.__ggRecord = record;
+            populateFields(container, record);
+            applySwitchFields(container, record);
+            applyDataValues(container, record);
+        }
+    }
+    // Run all data containers on load
+    document
+        .querySelectorAll("[gg-data], [gg-data-list], [gg-data-form]")
+        .forEach(runQuery);
+    // Re-run queries when matching URL params change
+    onQueryChanged((key) => {
+        document
+            .querySelectorAll("[gg-data][gg-data-on], [gg-data-list][gg-data-on], [gg-data-form][gg-data-on]")
+            .forEach((c) => {
+            const attr = c.getAttribute("gg-data-on");
+            if (!attr)
+                return;
+            const keys = attr.split(",").map((s) => s.trim());
+            if (keys.includes(key))
+                runQuery(c);
+        });
+    });
+}
+//# sourceMappingURL=data-engine.js.map

package/dist/data-engine.js.map

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

package/dist/dialog.d.ts

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

package/dist/dialog.js

@@ -0,0 +1,89 @@
+import { removeQueryParams, onQueryChanged } from "./query-params.js";
+function stopLenis() {
+    if (typeof lenis !== "undefined")
+        lenis.stop();
+}
+function startLenis() {
+    if (typeof lenis !== "undefined")
+        lenis.start();
+}
+function openDialog() {
+    const dialog = document.querySelector("dialog");
+    if (!dialog)
+        return;
+    dialog.removeAttribute("aria-hidden");
+    dialog.removeAttribute("inert");
+    dialog.showModal();
+    stopLenis();
+}
+function closeDialog() {
+    const dialog = document.querySelector("dialog");
+    if (!dialog)
+        return;
+    dialog.setAttribute("aria-hidden", "true");
+    dialog.setAttribute("inert", "");
+    dialog.close();
+    startLenis();
+}
+function dismissViaUrlOrDirect() {
+    const modalParam = new URLSearchParams(window.location.search).get("modal");
+    if (modalParam) {
+        removeQueryParams(["modal", "id"]);
+    }
+    else {
+        closeDialog();
+    }
+}
+function syncDialogToUrl() {
+    const modalParam = new URLSearchParams(window.location.search).get("modal");
+    if (modalParam) {
+        openDialog();
+    }
+    else {
+        closeDialog();
+    }
+}
+export function initDialog() {
+    // Subscribe to query param changes — open/close when "modal" changes
+    onQueryChanged((key, value) => {
+        if (key !== "modal")
+            return;
+        if (value) {
+            openDialog();
+        }
+        else {
+            closeDialog();
+        }
+    });
+    // Inbound events from external code
+    document.addEventListener("gg:dialog:open", openDialog);
+    document.addEventListener("gg:dialog:close", closeDialog);
+    // Backdrop click
+    document.addEventListener("click", (e) => {
+        const target = e.target;
+        if (!(target instanceof HTMLDialogElement))
+            return;
+        if (!target.matches("dialog[open]"))
+            return;
+        const rect = target.getBoundingClientRect();
+        const outside = e.clientX < rect.left ||
+            e.clientX > rect.right ||
+            e.clientY < rect.top ||
+            e.clientY > rect.bottom;
+        if (outside)
+            dismissViaUrlOrDirect();
+    });
+    // Escape key — preempt the default close so the URL stays source of truth
+    document.addEventListener("cancel", (e) => {
+        const target = e.target;
+        if (!(target instanceof HTMLDialogElement))
+            return;
+        e.preventDefault();
+        dismissViaUrlOrDirect();
+    });
+    // Back button
+    window.addEventListener("popstate", syncDialogToUrl);
+    // Initial load
+    syncDialogToUrl();
+}
+//# sourceMappingURL=dialog.js.map

package/dist/dialog.js.map

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

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

@@ -0,0 +1,3 @@
+export declare function initFormActionEngine(context: unknown, { debug }?: {
+    debug?: boolean;
+}): void;