gg-wf-scripts 2.5.0 → 3.0.0

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,26 @@
+import type { GgErrorEvent } from "../errors.js";
+type RunHandlerOptions = {
+    prefix: string;
+    id: string;
+    fields: Record<string, unknown>;
+    debug: boolean;
+    emitError?: (event: GgErrorEvent) => void;
+};
+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 }, logs the error, and emits
+ * a GgErrorEvent so consumers subscribed via app.onError() can ship it to
+ * their error tracker.
+ */
+export declare function runHandler<T>({ prefix, id, fields, debug, emitError }: RunHandlerOptions, fn: () => Promise<T> | T): Promise<RunHandlerResult<T>>;
+export {};

package/dist/helpers/run-handler.js

@@ -0,0 +1,36 @@
+/**
+ * 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 }, logs the error, and emits
+ * a GgErrorEvent so consumers subscribed via app.onError() can ship it to
+ * their error tracker.
+ */
+export async function runHandler({ prefix, id, fields, debug, emitError }, 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);
+        emitError?.({ prefix, id, error, fields });
+        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":"AAcA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAqB,EAC3D,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,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3C,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,69 @@
+import type { Query } from "./queries.js";
+import type { Action } from "./actions.js";
+import type { FormAction } from "./form-actions.js";
+import { setQueryParams, removeQueryParams } from "./query-params.js";
+import { type AuthAdapter } from "./auth.js";
+import { type ErrorHandler } from "./errors.js";
+export { 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 { GgErrorEvent, ErrorHandler } from "./errors.js";
+export type InitOptions<TContext = unknown> = {
+    /**
+     * Arbitrary object passed to every query and action. Put backend clients
+     * (Supabase, fetch wrappers, etc.) or anything else your queries need on it.
+     */
+    context?: TContext;
+    /**
+     * Auth adapter. If omitted, gg-auth/gg-role attrs are never set.
+     */
+    auth?: AuthAdapter<TContext>;
+    /**
+     * When true, every query and action is logged to the console with its
+     * trigger/container, data, result, and duration.
+     */
+    debug?: boolean;
+};
+export type App<TContext = unknown> = {
+    context: TContext;
+    debug: boolean;
+    queries: Record<string, Query<TContext>>;
+    actions: Record<string, Action<TContext>>;
+    formActions: Record<string, FormAction<TContext>>;
+    /**
+     * Register a query. Optionally pin the result type at the call site:
+     * `app.addQuery<User[]>("users.list", ...)` for autocomplete on the
+     * handler's return value.
+     */
+    addQuery: <TResult = unknown>(id: string, fn: Query<TContext, TResult>) => void;
+    /**
+     * Register an action. Optionally pin the data shape:
+     * `app.addAction<{ id: string }>("posts.delete", ...)`.
+     */
+    addAction: <TData extends Record<string, unknown> = Record<string, unknown>>(id: string, fn: Action<TContext, TData>) => void;
+    addFormAction: (id: string, fn: FormAction<TContext>) => void;
+    /**
+     * Subscribe to errors from any registered handler — including thrown
+     * exceptions, missing-handler lookups, and `{ ok: false }` returns. Useful
+     * for shipping errors to Sentry or similar. Returns an unsubscribe fn.
+     */
+    onError: (handler: ErrorHandler) => () => void;
+    /**
+     * Mount all engines. Idempotent only in the sense that calling start()
+     * twice without dispose() will double-bind listeners — don't do that.
+     */
+    start: () => void;
+    /**
+     * Detach every listener and observer the library installed. Call from
+     * SPA route changes, HMR teardown, or test cleanup. Handler registrations
+     * are kept so you can call start() again on the same App.
+     */
+    dispose: () => void;
+};
+/**
+ * Create a gg-scripts app instance.
+ */
+export declare function init<TContext = unknown>({ context, auth, debug }?: InitOptions<TContext>): App<TContext>;

package/dist/index.js

@@ -0,0 +1,72 @@
+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";
+import { startDomObserver } from "./dom-observer.js";
+import { createErrorBus } from "./errors.js";
+export { setQueryParams, removeQueryParams };
+export { getPath } from "./helpers/path.js";
+/**
+ * Create a gg-scripts app instance.
+ */
+export function init({ context = {}, auth, debug = false } = {}) {
+    const queries = {};
+    const actions = {};
+    const formActions = {};
+    const errorBus = createErrorBus();
+    let cleanups = [];
+    const app = {
+        context,
+        debug,
+        queries,
+        actions,
+        formActions,
+        addQuery: (id, fn) => {
+            queries[id] = fn;
+        },
+        addAction: (id, fn) => {
+            actions[id] = fn;
+        },
+        addFormAction: (id, fn) => {
+            formActions[id] = fn;
+        },
+        onError: (handler) => errorBus.subscribe(handler),
+        start() {
+            function run() {
+                const core = {
+                    context,
+                    debug,
+                    emitError: (event) => errorBus.emit(event),
+                };
+                if (auth)
+                    initAuth(context, auth);
+                cleanups.push(startDomObserver());
+                cleanups.push(initSwitchEngine());
+                cleanups.push(initQueryParams());
+                cleanups.push(initDialog());
+                cleanups.push(initBridges());
+                cleanups.push(initFormVisibility());
+                cleanups.push(initDataEngine({ ...core, queries }));
+                cleanups.push(initActionEngine({ ...core, actions }));
+                cleanups.push(initFormActionEngine({ ...core, formActions }));
+            }
+            if (document.readyState === "loading") {
+                document.addEventListener("DOMContentLoaded", run);
+            }
+            else {
+                run();
+            }
+        },
+        dispose() {
+            cleanups.forEach((c) => c());
+            cleanups = [];
+        },
+    };
+    return app;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/queries.d.ts

@@ -0,0 +1 @@
+export type Query<TContext = unknown, TResult = unknown> = (context: TContext, params: URLSearchParams) => Promise<TResult> | TResult;

package/dist/queries.js

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

package/dist/queries.js.map

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

package/dist/query-params.d.ts

@@ -0,0 +1,19 @@
+type QueryChangeCallback = (key: string, value: string | null) => void;
+/**
+ * Snapshot of the current URL query string as a URLSearchParams instance.
+ */
+export declare function getParams(): URLSearchParams;
+export declare function onQueryChanged(callback: QueryChangeCallback): () => void;
+/**
+ * Set one or more URL query params and notify subscribers.
+ */
+export declare function setQueryParams(params: Array<{
+    key: string;
+    value: string;
+}>): void;
+/**
+ * Remove one or more URL query params and notify subscribers.
+ */
+export declare function removeQueryParams(keys: string[]): void;
+export declare function initQueryParams(): () => void;
+export {};

package/dist/query-params.js

@@ -0,0 +1,160 @@
+import { ATTR, SEL } from "./attrs.js";
+import { onElement } from "./dom-observer.js";
+const subscribers = [];
+/**
+ * Snapshot of the current URL query string as a URLSearchParams instance.
+ */
+export function getParams() {
+    return new URL(window.location.href).searchParams;
+}
+export function onQueryChanged(callback) {
+    subscribers.push(callback);
+    return () => {
+        const idx = subscribers.indexOf(callback);
+        if (idx >= 0)
+            subscribers.splice(idx, 1);
+    };
+}
+function notify(key, value) {
+    subscribers.forEach((cb) => cb(key, value));
+}
+/**
+ * Set one or more URL query params and notify subscribers.
+ */
+export function setQueryParams(params) {
+    const url = new URL(window.location.href);
+    params.forEach(({ key, value }) => url.searchParams.set(key, value));
+    history.pushState({}, "", url);
+    params.forEach(({ key, value }) => notify(key, value));
+}
+/**
+ * Remove one or more URL query params and notify subscribers.
+ */
+export function removeQueryParams(keys) {
+    const url = new URL(window.location.href);
+    keys.forEach((key) => url.searchParams.delete(key));
+    history.pushState({}, "", url);
+    keys.forEach((key) => notify(key, null));
+}
+// ---- click delegation for gg-query-set / gg-query-remove ----
+function handleQueryClick(target) {
+    if (!target)
+        return;
+    const setTrigger = target.closest(`[${ATTR.querySet}]`);
+    if (setTrigger) {
+        const attr = setTrigger.getAttribute(ATTR.querySet) ?? "";
+        const params = attr
+            .split(",")
+            .filter(Boolean)
+            .map((pair) => {
+            const [key, value] = pair.split(":");
+            return { key: key?.trim() ?? "", value: value?.trim() ?? "" };
+        })
+            .filter((p) => p.key && p.value);
+        if (params.length)
+            setQueryParams(params);
+        return;
+    }
+    const removeTrigger = target.closest(`[${ATTR.queryRemove}]`);
+    if (removeTrigger) {
+        const attr = removeTrigger.getAttribute(ATTR.queryRemove) ?? "";
+        const keys = attr
+            .split(",")
+            .map((k) => k.trim())
+            .filter(Boolean);
+        if (keys.length)
+            removeQueryParams(keys);
+        return;
+    }
+}
+export function initQueryParams() {
+    const onClick = (e) => {
+        handleQueryClick(e.target instanceof Element ? e.target : null);
+    };
+    const onShadowClick = (e) => {
+        const detail = e.detail;
+        handleQueryClick(detail?.target ?? null);
+    };
+    document.addEventListener("click", onClick);
+    document.addEventListener("gg:shadow:click", onShadowClick);
+    const unbindBindings = initQueryBindings();
+    return () => {
+        document.removeEventListener("click", onClick);
+        document.removeEventListener("gg:shadow:click", onShadowClick);
+        unbindBindings();
+    };
+}
+function syncBindInputFromUrl(el) {
+    const key = el.getAttribute(ATTR.queryBind);
+    if (!key)
+        return;
+    const value = new URL(window.location.href).searchParams.get(key) ?? "";
+    if (el.value !== value)
+        el.value = value;
+}
+const boundInputs = new WeakSet();
+function setupQueryBindInput(el) {
+    if (boundInputs.has(el))
+        return;
+    const key = el.getAttribute(ATTR.queryBind);
+    if (!key)
+        return;
+    boundInputs.add(el);
+    const debounceMs = parseInt(el.getAttribute(ATTR.queryDebounce) ?? "0", 10) || 0;
+    syncBindInputFromUrl(el);
+    let timer;
+    let suppress = false;
+    el.addEventListener("input", () => {
+        if (suppress)
+            return;
+        if (timer !== undefined)
+            clearTimeout(timer);
+        const fire = () => {
+            const value = el.value;
+            if (value === "") {
+                removeQueryParams([key]);
+            }
+            else {
+                setQueryParams([{ key, value }]);
+            }
+        };
+        if (debounceMs > 0) {
+            timer = setTimeout(fire, debounceMs);
+        }
+        else {
+            fire();
+        }
+    });
+    // When the URL changes from elsewhere (back button, programmatic), mirror
+    // it into the input without re-firing the input listener.
+    onQueryChanged((changedKey, value) => {
+        if (changedKey !== key)
+            return;
+        const next = value ?? "";
+        if (el.value === next)
+            return;
+        suppress = true;
+        el.value = next;
+        suppress = false;
+    });
+}
+function initQueryBindings() {
+    const unbind = onElement(SEL.queryBind, (el) => {
+        if (el instanceof HTMLInputElement ||
+            el instanceof HTMLTextAreaElement ||
+            el instanceof HTMLSelectElement) {
+            setupQueryBindInput(el);
+        }
+    });
+    const onPopstate = () => {
+        document
+            .querySelectorAll(SEL.queryBind)
+            .forEach(syncBindInputFromUrl);
+    };
+    window.addEventListener("popstate", onPopstate);
+    return () => {
+        unbind();
+        window.removeEventListener("popstate", onPopstate);
+    };
+}
+//# sourceMappingURL=query-params.js.map

package/dist/query-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-params.js","sourceRoot":"","sources":["../src/query-params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,MAAM,WAAW,GAA0B,EAAE,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA6B;IAC1D,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC;YAAE,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,GAAW,EAAE,KAAoB;IAC/C,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA6C;IAE7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,gEAAgE;AAEhE,SAAS,gBAAgB,CAAC,MAAsB;IAC9C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI;aAChB,KAAK,CAAC,GAAG,CAAC;aACV,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QAChE,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM;YAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IAC9D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI;aACd,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,MAAM;YAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,CAAC,CAAQ,EAAE,EAAE;QAC3B,gBAAgB,CAAC,CAAC,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,CAAQ,EAAE,EAAE;QACjC,MAAM,MAAM,GAAI,CAAsC,CAAC,MAAM,CAAC;QAC9D,gBAAgB,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;IAE5D,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;QAC/D,cAAc,EAAE,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAMD,SAAS,oBAAoB,CAAC,EAAiB;IAC7C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,EAAE,CAAC,KAAK,KAAK,KAAK;QAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;AAC3C,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,OAAO,EAAiB,CAAC;AAEjD,SAAS,mBAAmB,CAAC,EAAiB;IAC5C,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO;IAChC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpB,MAAM,UAAU,GACd,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEhE,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAEzB,IAAI,KAAgD,CAAC;IACrD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;QAChC,IAAI,QAAQ;YAAE,OAAO;QACrB,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;YACvB,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBACjB,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;QACF,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,0DAA0D;IAC1D,cAAc,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QACnC,IAAI,UAAU,KAAK,GAAG;YAAE,OAAO;QAC/B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAC9B,QAAQ,GAAG,IAAI,CAAC;QAChB,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC;QAChB,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE;QAC7C,IACE,EAAE,YAAY,gBAAgB;YAC9B,EAAE,YAAY,mBAAmB;YACjC,EAAE,YAAY,iBAAiB,EAC/B,CAAC;YACD,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,QAAQ;aACL,gBAAgB,CAAgB,GAAG,CAAC,SAAS,CAAC;aAC9C,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAEhD,OAAO,GAAG,EAAE;QACV,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

package/dist/switch-engine.d.ts

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

package/dist/switch-engine.js

@@ -0,0 +1,28 @@
+import { ATTR, SEL } from "./attrs.js";
+import { applySwitchState } from "./helpers/dom.js";
+import { onElement } from "./dom-observer.js";
+export function initSwitchEngine() {
+    // Re-apply whenever gg-switch-state changes on any element.
+    const observer = new MutationObserver((mutations) => {
+        mutations.forEach((m) => {
+            if (m.attributeName === ATTR.switchState &&
+                m.target instanceof Element) {
+                applySwitchState(m.target);
+            }
+        });
+    });
+    observer.observe(document.body, {
+        attributes: true,
+        attributeFilter: [ATTR.switchState],
+        subtree: true,
+    });
+    // Initial pass for elements present at start AND any inserted later — the
+    // mutation observer above only fires on attribute *changes*, so freshly
+    // inserted nodes need an explicit apply.
+    const unbind = onElement(SEL.switchState, applySwitchState);
+    return () => {
+        observer.disconnect();
+        unbind();
+    };
+}
+//# sourceMappingURL=switch-engine.js.map

package/dist/switch-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-engine.js","sourceRoot":"","sources":["../src/switch-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,gBAAgB;IAC9B,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;QAClD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,IACE,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,WAAW;gBACpC,CAAC,CAAC,MAAM,YAAY,OAAO,EAC3B,CAAC;gBACD,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC9B,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;QACnC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,0EAA0E;IAC1E,wEAAwE;IACxE,yCAAyC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAE5D,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,29 @@
 {
 	"name": "gg-wf-scripts",
-	"version": "2.5.0",
+	"version": "3.0.0",
 	"type": "module",
-	"exports": "./src/index.js"
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"clean": "rimraf dist",
+		"build": "npm run clean && tsc",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "npm run build",
+		"docs:dev": "vitepress dev docs",
+		"docs:build": "vitepress build docs",
+		"docs:preview": "vitepress preview docs"
+	},
+	"devDependencies": {
+		"rimraf": "^6.1.3",
+		"typescript": "^6.0.3",
+		"vitepress": "^1.6.4",
+		"vitepress-plugin-llms": "^1.12.1"
+	}
 }

package/src/action-engine.js

@@ -1,64 +0,0 @@
-import { actionRegistry } from "./actions.js";
-import { withDebugLog } from "./helpers/log.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) {
-    const id = el.getAttribute("gg-action");
-    const action = actionRegistry[id];
-    if (!action) {
-      console.warn(`[gg-action] no action registered for "${id}"`);
-      return;
-    }
-
-    const record = findRecord(el);
-    const explicit = parseActionData(el);
-    const data = record ? { ...record, ...explicit } : explicit;
-    const params = getParams();
-
-    const result = await withDebugLog(
-      "[gg-action]",
-      id,
-      { trigger: el, data, params: Object.fromEntries(params) },
-      debug,
-      () => action(context, data, params),
-    );
-
-    if (result?.ok === false) {
-      console.warn(`[gg-action] "${id}" failed:`, result.error ?? "unknown error");
-    }
-  }
-
-  document.addEventListener("click", (e) => {
-    const trigger = e.target.closest("[gg-action]");
-    if (trigger) handleAction(trigger);
-  });
-
-  document.addEventListener("gg:shadow:click", (e) => {
-    const trigger = e.detail.target.closest("[gg-action]");
-    if (trigger) handleAction(trigger);
-  });
-}

package/src/actions.js

@@ -1,14 +0,0 @@
-export const actionRegistry = {};
-
-/**
- * Register an action triggered by gg-action="<id>" on click.
- *
- * @param {string} id - The action identifier, referenced by gg-action="<id>" in markup.
- * @param {(context: object, data: object, params: URLSearchParams) => Promise<{ok: boolean, error?: any}>} fn
- *   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;
-}

package/src/auth.js

@@ -1,28 +0,0 @@
-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));
-  }
-}