gg-wf-scripts 2.8.0 → 4.0.0

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

@@ -1,8 +1,10 @@
+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;
@@ -16,7 +18,9 @@ export type RunHandlerResult<T> = {
  *
  * 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.
+ * 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 }: RunHandlerOptions, fn: () => Promise<T> | T): Promise<RunHandlerResult<T>>;
+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

@@ -3,9 +3,11 @@
  *
  * 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.
+ * 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 }, fn) {
+export async function runHandler({ prefix, id, fields, debug, emitError }, fn) {
     if (debug) {
         console.groupCollapsed(`${prefix} "${id}"`);
         for (const [key, value] of Object.entries(fields)) {
@@ -23,6 +25,7 @@ export async function runHandler({ prefix, id, fields, debug }, fn) {
     }
     catch (error) {
         console.error(`${prefix} "${id}" threw:`, error);
+        emitError?.({ prefix, id, error, fields });
         return { ok: false, error };
     }
     finally {

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

@@ -1 +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"}
+{"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/index.d.ts

@@ -1,37 +1,69 @@
-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 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";
-export { setSwitchState, applySwitchState, populateFields, setQueryParams, removeQueryParams };
+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 InitOptions = {
+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?: unknown;
+    context?: TContext;
     /**
      * Auth adapter. If omitted, gg-auth/gg-role attrs are never set.
      */
-    auth?: AuthAdapter;
+    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({ context, auth, debug }?: InitOptions): {
-    addQuery: typeof registerQuery;
-    addAction: typeof registerAction;
-    addFormAction: typeof registerFormAction;
-    start(): void;
-};
+export declare function init<TContext = unknown>({ context, auth, debug }?: InitOptions<TContext>): App<TContext>;

package/dist/index.js

@@ -1,7 +1,3 @@
-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";
@@ -11,28 +7,53 @@ 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 };
+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 } = {}) {
-    return {
-        addQuery: registerQuery,
-        addAction: registerAction,
-        addFormAction: registerFormAction,
+    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);
-                initSwitchEngine();
-                initQueryParams();
-                initDialog();
-                initBridges();
-                initFormVisibility();
-                initDataEngine(context, { debug });
-                initActionEngine(context, { debug });
-                initFormActionEngine(context, { debug });
+                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);
@@ -41,6 +62,11 @@ export function init({ context = {}, auth, debug = false } = {}) {
                 run();
             }
         },
+        dispose() {
+            cleanups.forEach((c) => c());
+            cleanups = [];
+        },
     };
+    return app;
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,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;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAwC,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAuE5C;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,EAAE,OAAO,GAAG,EAAc,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,KAA4B,EAAE;IAE7E,MAAM,OAAO,GAAoC,EAAE,CAAC;IACpD,MAAM,OAAO,GAAqC,EAAE,CAAC;IACrD,MAAM,WAAW,GAAyC,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,IAAI,QAAQ,GAAsB,EAAE,CAAC;IAErC,MAAM,GAAG,GAAkB;QACzB,OAAO;QACP,KAAK;QACL,OAAO;QACP,OAAO;QACP,WAAW;QACX,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YACnB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAqB,CAAC;QACtC,CAAC;QACD,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAsB,CAAC;QACvC,CAAC;QACD,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YACxB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;QACjD,KAAK;YACH,SAAS,GAAG;gBACV,MAAM,IAAI,GAAG;oBACX,OAAO;oBACP,KAAK;oBACL,SAAS,EAAE,CAAC,KAAmB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;iBACzD,CAAC;gBAEF,IAAI,IAAI;oBAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;gBACpD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;gBACtD,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAChE,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;QACD,OAAO;YACL,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7B,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/queries.d.ts

@@ -1,10 +1 @@
-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;
+export type Query<TContext = unknown, TResult = unknown> = (context: TContext, params: URLSearchParams) => Promise<TResult> | TResult;

package/dist/queries.js

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

package/dist/queries.js.map

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

package/dist/query-params.d.ts

@@ -15,5 +15,5 @@ export declare function setQueryParams(params: Array<{
  * Remove one or more URL query params and notify subscribers.
  */
 export declare function removeQueryParams(keys: string[]): void;
-export declare function initQueryParams(): void;
+export declare function initQueryParams(): () => void;
 export {};

package/dist/query-params.js

@@ -1,3 +1,5 @@
+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.
@@ -38,9 +40,9 @@ export function removeQueryParams(keys) {
 function handleQueryClick(target) {
     if (!target)
         return;
-    const setTrigger = target.closest("[gg-query-set]");
+    const setTrigger = target.closest(`[${ATTR.querySet}]`);
     if (setTrigger) {
-        const attr = setTrigger.getAttribute("gg-query-set") ?? "";
+        const attr = setTrigger.getAttribute(ATTR.querySet) ?? "";
         const params = attr
             .split(",")
             .filter(Boolean)
@@ -53,9 +55,9 @@ function handleQueryClick(target) {
             setQueryParams(params);
         return;
     }
-    const removeTrigger = target.closest("[gg-query-remove]");
+    const removeTrigger = target.closest(`[${ATTR.queryRemove}]`);
     if (removeTrigger) {
-        const attr = removeTrigger.getAttribute("gg-query-remove") ?? "";
+        const attr = removeTrigger.getAttribute(ATTR.queryRemove) ?? "";
         const keys = attr
             .split(",")
             .map((k) => k.trim())
@@ -66,30 +68,39 @@ function handleQueryClick(target) {
     }
 }
 export function initQueryParams() {
-    document.addEventListener("click", (e) => {
+    const onClick = (e) => {
         handleQueryClick(e.target instanceof Element ? e.target : null);
-    });
-    // Shadow-root click forwarder — shadow DOM swallows bubbling, so anything
-    // inside a shadow tree dispatches `gg:shadow:click` with the real target.
-    document.addEventListener("gg:shadow:click", (e) => {
+    };
+    const onShadowClick = (e) => {
         const detail = e.detail;
         handleQueryClick(detail?.target ?? null);
-    });
-    initQueryBindings();
+    };
+    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("gg-query-bind");
+    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) {
-    const key = el.getAttribute("gg-query-bind");
+    if (boundInputs.has(el))
+        return;
+    const key = el.getAttribute(ATTR.queryBind);
     if (!key)
         return;
-    const debounceMs = parseInt(el.getAttribute("gg-query-debounce") ?? "0", 10) || 0;
+    boundInputs.add(el);
+    const debounceMs = parseInt(el.getAttribute(ATTR.queryDebounce) ?? "0", 10) || 0;
     syncBindInputFromUrl(el);
     let timer;
     let suppress = false;
@@ -128,15 +139,22 @@ function setupQueryBindInput(el) {
     });
 }
 function initQueryBindings() {
-    document
-        .querySelectorAll("[gg-query-bind]")
-        .forEach(setupQueryBindInput);
-    // Back/forward navigation doesn't fire pushState notifications, so
-    // re-sync all bound inputs from the URL on popstate.
-    window.addEventListener("popstate", () => {
+    const unbind = onElement(SEL.queryBind, (el) => {
+        if (el instanceof HTMLInputElement ||
+            el instanceof HTMLTextAreaElement ||
+            el instanceof HTMLSelectElement) {
+            setupQueryBindInput(el);
+        }
+    });
+    const onPopstate = () => {
         document
-            .querySelectorAll("[gg-query-bind]")
+            .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

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

package/dist/switch-engine.d.ts

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

package/dist/switch-engine.js

@@ -1,21 +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.
-    new MutationObserver((mutations) => {
+    const observer = new MutationObserver((mutations) => {
         mutations.forEach((m) => {
-            if (m.attributeName === "gg-switch-state" && m.target instanceof Element) {
+            if (m.attributeName === ATTR.switchState &&
+                m.target instanceof Element) {
                 applySwitchState(m.target);
             }
         });
-    }).observe(document.body, {
+    });
+    observer.observe(document.body, {
         attributes: true,
-        attributeFilter: ["gg-switch-state"],
+        attributeFilter: [ATTR.switchState],
         subtree: true,
     });
-    // Apply initial state for any elements that already have gg-switch-state
-    // set at load time, so we don't flash all children before the first mutation.
-    document
-        .querySelectorAll("[gg-switch-state]")
-        .forEach(applySwitchState);
+    // 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

@@ -1 +1 @@
-{"version":3,"file":"switch-engine.js","sourceRoot":"","sources":["../src/switch-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,gBAAgB;IAC9B,4DAA4D;IAC5D,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;QACjC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,aAAa,KAAK,iBAAiB,IAAI,CAAC,CAAC,MAAM,YAAY,OAAO,EAAE,CAAC;gBACzE,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;QACxB,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,CAAC,iBAAiB,CAAC;QACpC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,yEAAyE;IACzE,8EAA8E;IAC9E,QAAQ;SACL,gBAAgB,CAAC,mBAAmB,CAAC;SACrC,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAC/B,CAAC"}
+{"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,6 @@
 {
 	"name": "gg-wf-scripts",
-	"version": "2.8.0",
+	"version": "4.0.0",
 	"type": "module",
 	"exports": {
 		".": {
@@ -15,10 +15,15 @@
 		"clean": "rimraf dist",
 		"build": "npm run clean && tsc",
 		"typecheck": "tsc --noEmit",
-		"prepublishOnly": "npm run build"
+		"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"
+		"typescript": "^6.0.3",
+		"vitepress": "^1.6.4",
+		"vitepress-plugin-llms": "^1.12.1"
 	}
 }