gg-wf-scripts 2.8.0 → 4.0.0

package/README.md

@@ -88,22 +88,27 @@ Display data from your queries in the DOM.
 
 #### Passing data to web components / React
 
-For elements that manage their own DOM (custom elements wrapping React, Lit, etc.), use `gg-data-key` to receive a JSON-serialized value as a `gg-data-value` attribute. The component listens for attribute changes and updates its own state.
+For elements that manage their own DOM (custom elements wrapping React, Lit, etc.), pull the record from the container's `__ggRecord` property after each query run. Every `gg-data`, `gg-data-form`, and cloned `gg-data-list` row exposes the record this way, and the engine dispatches a `gg-data-ready` CustomEvent on the same element with `detail.record` once it's set.
 
 ```html
-<div gg-data="post_form">
-  <!-- record.schools is e.g. [{ id, name }, ...] -->
-  <my-select gg-data-key="schools"></my-select>
-</div>
+<form gg-data-form="post_form">
+  <input name="title" />
+  <my-select name="school_id"></my-select>
+</form>
 ```
 
-After the query runs, the engine resolves the dot-path against the record and writes the result:
-
-```html
-<my-select gg-data-key="schools" gg-data-value='[{"id":1,"name":"Acme"}]'></my-select>
+```js
+// Inside <my-select> — read the parent record once it's ready.
+const form = host.closest("form");
+form.addEventListener("gg-data-ready", (e) => {
+  const record = e.detail.record;
+  // hydrate from record[host.getAttribute("name")] or whatever path makes sense
+});
+// Already populated? Read it directly:
+if (form.__ggRecord) hydrate(form.__ggRecord);
 ```
 
-The lookup pierces shadow roots, so the marker can live inside a component's shadow DOM. Leaving `gg-data-key=""` passes the entire record. Note: if the component renders after the query runs, it won't be found — re-run the query (e.g. via `gg-data-on`) once the component has mounted, or have the component pull from `host.__ggRecord` on connect.
+The event bubbles, so each form/container's events are scoped to that subtree — listeners attached to one form never fire for another. From inside a shadow root, walk out via `getRootNode().host` before calling `closest("form")`.
 
 #### Re-running on URL changes
 

package/dist/action-engine.d.ts

@@ -1,3 +1,2 @@
-export declare function initActionEngine(context: unknown, { debug }?: {
-    debug?: boolean;
-}): void;
+import type { ActionEngineDeps } from "./engine-deps.js";
+export declare function initActionEngine<TContext>(deps: ActionEngineDeps<TContext>): () => void;

package/dist/action-engine.js

@@ -1,9 +1,9 @@
-import { actionRegistry } from "./actions.js";
+import { ATTR, SEL } from "./attrs.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");
+    const attr = el.getAttribute(ATTR.actionData);
     if (!attr)
         return {};
     const data = {};
@@ -26,53 +26,72 @@ function findRecord(el) {
     }
     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({
+async function handleAction(el, deps) {
+    if (el.hasAttribute(ATTR.loading))
+        return;
+    const id = el.getAttribute(ATTR.action);
+    if (!id)
+        return;
+    const action = deps.actions[id];
+    if (!action) {
+        console.warn(`[gg-action] no action registered for "${id}"`);
+        deps.emitError({
             prefix: "[gg-action]",
             id,
-            fields: { trigger: el, data, params: Object.fromEntries(params) },
-            debug,
-        }, () => action(context, data, params)));
-        if (!result.ok)
+            error: "no action registered",
+            fields: { trigger: el },
+        });
+        return;
+    }
+    if (el.hasAttribute(ATTR.confirm)) {
+        const text = el.getAttribute(ATTR.confirmText) || "Are you sure?";
+        if (!window.confirm(text))
             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 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: deps.debug,
+        emitError: deps.emitError,
+    }, () => action(deps.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");
+        deps.emitError({
+            prefix: "[gg-action]",
+            id,
+            error: failure.error ?? "unknown error",
+            fields: { trigger: el, data },
+        });
+    }
+}
+export function initActionEngine(deps) {
+    const onClick = (e) => {
         const target = e.target;
         if (!(target instanceof Element))
             return;
-        const trigger = target.closest("[gg-action]");
+        const trigger = target.closest(SEL.action);
         if (trigger)
-            handleAction(trigger);
-    });
-    document.addEventListener("gg:shadow:click", (e) => {
+            handleAction(trigger, deps);
+    };
+    const onShadowClick = (e) => {
         const detail = e.detail;
-        const trigger = detail?.target?.closest?.("[gg-action]");
+        const trigger = detail?.target?.closest?.(SEL.action);
         if (trigger)
-            handleAction(trigger);
-    });
+            handleAction(trigger, deps);
+    };
+    document.addEventListener("click", onClick);
+    document.addEventListener("gg:shadow:click", onShadowClick);
+    return () => {
+        document.removeEventListener("click", onClick);
+        document.removeEventListener("gg:shadow:click", onShadowClick);
+    };
 }
 //# sourceMappingURL=action-engine.js.map

package/dist/action-engine.js.map

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

package/dist/actions.d.ts

@@ -2,13 +2,4 @@ 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;
+export type Action<TContext = unknown, TData extends Record<string, unknown> = Record<string, unknown>> = (context: TContext, data: TData, params: URLSearchParams) => Promise<ActionResult | void> | ActionResult | void;

package/dist/actions.js

@@ -1,12 +1,2 @@
-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;
-}
+export {};
 //# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/attrs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Single source of truth for every gg-* attribute the library reads or writes.
+ * Engines should reference these constants instead of inline string literals so
+ * the attribute vocabulary stays discoverable and renameable.
+ */
+export declare const ATTR: {
+    readonly action: "gg-action";
+    readonly actionData: "gg-action-data";
+    readonly formAction: "gg-form-action";
+    readonly data: "gg-data";
+    readonly dataList: "gg-data-list";
+    readonly dataForm: "gg-data-form";
+    readonly dataOn: "gg-data-on";
+    readonly field: "gg-field";
+    readonly listTemplate: "gg-list-template";
+    readonly formFieldError: "gg-form-field-error";
+    readonly formFieldInvalid: "gg-form-field-invalid";
+    readonly formError: "gg-form-error";
+    readonly formErrorList: "gg-form-error-list";
+    readonly formScope: "gg-form-scope";
+    readonly switchState: "gg-switch-state";
+    readonly switchField: "gg-switch-field";
+    readonly switchQuery: "gg-switch-query";
+    readonly case: "gg-case";
+    readonly visibleWhen: "gg-visible-when";
+    readonly queryBind: "gg-query-bind";
+    readonly queryDebounce: "gg-query-debounce";
+    readonly querySet: "gg-query-set";
+    readonly queryRemove: "gg-query-remove";
+    readonly loading: "gg-loading";
+    readonly confirm: "gg-confirm";
+    readonly confirmText: "gg-confirm-text";
+    readonly auth: "gg-auth";
+    readonly role: "gg-role";
+};
+export declare const SEL: {
+    readonly action: "[gg-action]";
+    readonly formAction: "form[gg-form-action]";
+    readonly data: "[gg-data]";
+    readonly dataList: "[gg-data-list]";
+    readonly dataForm: "[gg-data-form]";
+    readonly dataAny: "[gg-data], [gg-data-list], [gg-data-form]";
+    readonly dataAnyOn: "[gg-data][gg-data-on], [gg-data-list][gg-data-on], [gg-data-form][gg-data-on]";
+    readonly field: "[gg-field]";
+    readonly listTemplate: "[gg-list-template]";
+    readonly switchState: "[gg-switch-state]";
+    readonly switchField: "[gg-switch-field]";
+    readonly switchQuery: "[gg-switch-query]";
+    readonly visibleWhen: "[gg-visible-when]";
+    readonly queryBind: "[gg-query-bind]";
+    readonly formScopeOrForm: "[gg-form-scope], form";
+    readonly formFieldInvalid: "[gg-form-field-invalid]";
+    readonly formFieldError: "[gg-form-field-error]";
+    readonly formError: "[gg-form-error]";
+    readonly formErrorList: "[gg-form-error-list]";
+};

package/dist/attrs.js

@@ -0,0 +1,64 @@
+/**
+ * Single source of truth for every gg-* attribute the library reads or writes.
+ * Engines should reference these constants instead of inline string literals so
+ * the attribute vocabulary stays discoverable and renameable.
+ */
+export const ATTR = {
+    // Actions
+    action: "gg-action",
+    actionData: "gg-action-data",
+    formAction: "gg-form-action",
+    // Data binding
+    data: "gg-data",
+    dataList: "gg-data-list",
+    dataForm: "gg-data-form",
+    dataOn: "gg-data-on",
+    field: "gg-field",
+    listTemplate: "gg-list-template",
+    // Form errors
+    formFieldError: "gg-form-field-error",
+    formFieldInvalid: "gg-form-field-invalid",
+    formError: "gg-form-error",
+    formErrorList: "gg-form-error-list",
+    formScope: "gg-form-scope",
+    // Switcher
+    switchState: "gg-switch-state",
+    switchField: "gg-switch-field",
+    switchQuery: "gg-switch-query",
+    case: "gg-case",
+    // Visibility
+    visibleWhen: "gg-visible-when",
+    // URL params
+    queryBind: "gg-query-bind",
+    queryDebounce: "gg-query-debounce",
+    querySet: "gg-query-set",
+    queryRemove: "gg-query-remove",
+    // Status
+    loading: "gg-loading",
+    confirm: "gg-confirm",
+    confirmText: "gg-confirm-text",
+    auth: "gg-auth",
+    role: "gg-role",
+};
+export const SEL = {
+    action: `[${ATTR.action}]`,
+    formAction: `form[${ATTR.formAction}]`,
+    data: `[${ATTR.data}]`,
+    dataList: `[${ATTR.dataList}]`,
+    dataForm: `[${ATTR.dataForm}]`,
+    dataAny: `[${ATTR.data}], [${ATTR.dataList}], [${ATTR.dataForm}]`,
+    dataAnyOn: `[${ATTR.data}][${ATTR.dataOn}], [${ATTR.dataList}][${ATTR.dataOn}], [${ATTR.dataForm}][${ATTR.dataOn}]`,
+    field: `[${ATTR.field}]`,
+    listTemplate: `[${ATTR.listTemplate}]`,
+    switchState: `[${ATTR.switchState}]`,
+    switchField: `[${ATTR.switchField}]`,
+    switchQuery: `[${ATTR.switchQuery}]`,
+    visibleWhen: `[${ATTR.visibleWhen}]`,
+    queryBind: `[${ATTR.queryBind}]`,
+    formScopeOrForm: `[${ATTR.formScope}], form`,
+    formFieldInvalid: `[${ATTR.formFieldInvalid}]`,
+    formFieldError: `[${ATTR.formFieldError}]`,
+    formError: `[${ATTR.formError}]`,
+    formErrorList: `[${ATTR.formErrorList}]`,
+};
+//# sourceMappingURL=attrs.js.map

package/dist/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../src/attrs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,UAAU;IACV,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;IAE5B,eAAe;IACf,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,UAAU;IACjB,YAAY,EAAE,kBAAkB;IAEhC,cAAc;IACd,cAAc,EAAE,qBAAqB;IACrC,gBAAgB,EAAE,uBAAuB;IACzC,SAAS,EAAE,eAAe;IAC1B,aAAa,EAAE,oBAAoB;IACnC,SAAS,EAAE,eAAe;IAE1B,WAAW;IACX,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,iBAAiB;IAC9B,IAAI,EAAE,SAAS;IAEf,aAAa;IACb,WAAW,EAAE,iBAAiB;IAE9B,aAAa;IACb,SAAS,EAAE,eAAe;IAC1B,aAAa,EAAE,mBAAmB;IAClC,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,iBAAiB;IAE9B,SAAS;IACT,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,WAAW,EAAE,iBAAiB;IAC9B,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG;IAC1B,UAAU,EAAE,QAAQ,IAAI,CAAC,UAAU,GAAG;IACtC,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG;IACtB,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG;IAC9B,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG;IAC9B,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,GAAG;IACjE,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,GAAG;IACnH,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,GAAG;IACxB,YAAY,EAAE,IAAI,IAAI,CAAC,YAAY,GAAG;IACtC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,GAAG;IACpC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,GAAG;IACpC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,GAAG;IACpC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,GAAG;IACpC,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,GAAG;IAChC,eAAe,EAAE,IAAI,IAAI,CAAC,SAAS,SAAS;IAC5C,gBAAgB,EAAE,IAAI,IAAI,CAAC,gBAAgB,GAAG;IAC9C,cAAc,EAAE,IAAI,IAAI,CAAC,cAAc,GAAG;IAC1C,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,GAAG;IAChC,aAAa,EAAE,IAAI,IAAI,CAAC,aAAa,GAAG;CAChC,CAAC"}

package/dist/auth.d.ts

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

package/dist/auth.js

@@ -1,20 +1,21 @@
+import { ATTR } from "./attrs.js";
 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");
+            body.setAttribute(ATTR.auth, "false");
+            body.removeAttribute(ATTR.role);
             return;
         }
-        body.setAttribute("gg-auth", "true");
+        body.setAttribute(ATTR.auth, "true");
         if (roleQuery) {
             const role = await roleQuery(context, userId);
             if (role) {
-                body.setAttribute("gg-role", role);
+                body.setAttribute(ATTR.role, role);
             }
             else {
-                body.removeAttribute("gg-role");
+                body.removeAttribute(ATTR.role);
             }
         }
     }

package/dist/auth.js.map

@@ -1 +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"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAWlC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAiB,EACjB,IAA2B;IAE3B,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,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,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,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,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

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

package/dist/bridges.js

@@ -1,33 +1,43 @@
+import { ATTR, SEL } from "./attrs.js";
 import { setSwitchState } from "./helpers/dom.js";
 import { onQueryChanged } from "./query-params.js";
+import { onElement } from "./dom-observer.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) => {
+    const unsubscribeQuery = onQueryChanged((key, value) => {
         document
-            .querySelectorAll(`[gg-switch-query="${CSS.escape(key)}"]`)
+            .querySelectorAll(`[${ATTR.switchQuery}="${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");
+    // Apply current URL state to every [gg-switch-query] element on the page,
+    // including any inserted later via Webflow IX or CMS templates.
+    const unbindSwitch = onElement(SEL.switchQuery, (el) => {
+        const key = el.getAttribute(ATTR.switchQuery);
         if (!key)
             return;
+        const params = new URLSearchParams(window.location.search);
         setSwitchState(el, params.get(key));
     });
     // ---- webflow:emit → Webflow IX ----
-    window.addEventListener("load", () => {
+    let wfHandler = null;
+    const onLoad = () => {
         Webflow.push(() => {
             const wfIx = Webflow.require("ix3");
-            document.addEventListener("webflow:emit", (e) => {
+            wfHandler = (e) => {
                 const detail = e.detail;
                 if (detail?.event)
                     wfIx.emit(detail.event);
-            });
+            };
+            document.addEventListener("webflow:emit", wfHandler);
         });
-    });
+    };
+    window.addEventListener("load", onLoad);
+    return () => {
+        unsubscribeQuery();
+        unbindSwitch();
+        window.removeEventListener("load", onLoad);
+        if (wfHandler)
+            document.removeEventListener("webflow:emit", wfHandler);
+    };
 }
 //# sourceMappingURL=bridges.js.map

package/dist/bridges.js.map

@@ -1 +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"}
+{"version":3,"file":"bridges.js","sourceRoot":"","sources":["../src/bridges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,WAAW;IACzB,0DAA0D;IAC1D,MAAM,gBAAgB,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACrD,QAAQ;aACL,gBAAgB,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;aAC9D,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3D,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,IAAI,SAAS,GAAgC,IAAI,CAAC;IAClD,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YAChB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,SAAS,GAAG,CAAC,CAAQ,EAAE,EAAE;gBACvB,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;YACF,QAAQ,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,OAAO,GAAG,EAAE;QACV,gBAAgB,EAAE,CAAC;QACnB,YAAY,EAAE,CAAC;QACf,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,SAAS;YAAE,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC"}

package/dist/data-engine.d.ts

@@ -1,3 +1,2 @@
-export declare function initDataEngine(context: unknown, { debug }?: {
-    debug?: boolean;
-}): void;
+import type { DataEngineDeps } from "./engine-deps.js";
+export declare function initDataEngine<TContext>(deps: DataEngineDeps<TContext>): () => void;