gg-wf-scripts 2.5.0 → 3.0.0

package/src/index.js

@@ -1,60 +0,0 @@
-import { registerQuery } from "./queries.js";
-import { registerAction } from "./actions.js";
-import { registerFormAction } from "./form-actions.js";
-import { setSwitchState, applySwitchState, populateFields } from "./helpers/dom.js";
-import { setQueryParams, removeQueryParams, initQueryParams } from "./query-params.js";
-import { initAuth } from "./auth.js";
-import { initSwitchEngine } from "./switch-engine.js";
-import { initDialog } from "./dialog.js";
-import { initBridges } from "./bridges.js";
-import { initFormVisibility } from "./form-visibility.js";
-import { initDataEngine } from "./data-engine.js";
-import { initActionEngine } from "./action-engine.js";
-import { initFormActionEngine } from "./form-action-engine.js";
-
-export { setSwitchState, applySwitchState, populateFields, setQueryParams, removeQueryParams };
-export { getPath } from "./helpers/path.js";
-
-/**
- * Create a gg-scripts app instance.
- *
- * @param {object} [options]
- * @param {object} [options.context] - Arbitrary object passed to every query and action.
- *   Put backend clients (Supabase, fetch wrappers, etc.) or anything else your queries need on it.
- * @param {object} [options.auth] - Auth adapter. If omitted, gg-auth/gg-role attrs are never set.
- * @param {() => (string|null) | Promise<string|null>} options.auth.getUser
- *   Returns the current user id, or null when signed out.
- * @param {(cb: (userId: string|null) => void) => void} [options.auth.onChange]
- *   Subscribe to auth changes. Called with the new user id (or null) whenever it changes.
- * @param {(context: object, userId: string) => Promise<string|null>} [options.auth.roleQuery]
- *   Returns the user's role string for gg-role gating. If omitted, gg-role is never set.
- * @param {boolean} [options.debug=false] - When true, every query and action is logged to the
- *   console with its trigger/container, data, result, and duration.
- * @returns {{ addQuery: function, addAction: function, start: function }}
- */
-export function init({ context = {}, auth, debug = false } = {}) {
-  return {
-    addQuery: registerQuery,
-    addAction: registerAction,
-    addFormAction: registerFormAction,
-    start() {
-      function run() {
-        if (auth) initAuth(context, auth);
-        initSwitchEngine();
-        initQueryParams();
-        initDialog();
-        initBridges();
-        initFormVisibility();
-        initDataEngine(context, { debug });
-        initActionEngine(context, { debug });
-        initFormActionEngine(context, { debug });
-      }
-
-      if (document.readyState === "loading") {
-        document.addEventListener("DOMContentLoaded", run);
-      } else {
-        run();
-      }
-    },
-  };
-}

package/src/queries.js

@@ -1,14 +0,0 @@
-export const queryRegistry = {};
-
-/**
- * Register a data query for use with gg-data, gg-data-form, or gg-data-list.
- *
- * @param {string} id - The query identifier, referenced by gg-data="<id>" in markup.
- * @param {(context: object, params: URLSearchParams) => Promise<object|object[]|null>} fn
- *   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;
-}

package/src/query-params.js

@@ -1,144 +0,0 @@
-const subscribers = [];
-
-/**
- * Snapshot of the current URL query string as a URLSearchParams instance.
- */
-export function getParams() {
-  return new URL(window.location).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.
- *
- * @param {Array<{key: string, value: string}>} params - Key/value pairs to set.
- */
-export function setQueryParams(params) {
-  const url = new URL(window.location);
-  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.
- *
- * @param {string[]} keys - Param keys to remove.
- */
-export function removeQueryParams(keys) {
-  const url = new URL(window.location);
-  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) {
-  const setTrigger = target.closest("[gg-query-set]");
-  if (setTrigger) {
-    const params = setTrigger
-      .getAttribute("gg-query-set")
-      .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("[gg-query-remove]");
-  if (removeTrigger) {
-    const keys = removeTrigger
-      .getAttribute("gg-query-remove")
-      .split(",")
-      .map((k) => k.trim())
-      .filter(Boolean);
-    if (keys.length) removeQueryParams(keys);
-    return;
-  }
-}
-
-export function initQueryParams() {
-  document.addEventListener("click", (e) => handleQueryClick(e.target));
-
-  // 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) =>
-    handleQueryClick(e.detail.target),
-  );
-
-  initQueryBindings();
-}
-
-// ---- gg-query-bind: input/textarea/select <-> URL param ----
-
-function syncBindInputFromUrl(el) {
-  const key = el.getAttribute("gg-query-bind");
-  if (!key) return;
-  const value = new URL(window.location).searchParams.get(key) ?? "";
-  if (el.value !== value) el.value = value;
-}
-
-function setupQueryBindInput(el) {
-  const key = el.getAttribute("gg-query-bind");
-  if (!key) return;
-  const debounceMs = parseInt(el.getAttribute("gg-query-debounce") ?? "0", 10) || 0;
-
-  syncBindInputFromUrl(el);
-
-  let timer;
-  let suppress = false;
-  el.addEventListener("input", () => {
-    if (suppress) return;
-    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() {
-  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", () => {
-    document.querySelectorAll("[gg-query-bind]").forEach(syncBindInputFromUrl);
-  });
-}

package/src/switch-engine.js

@@ -1,22 +0,0 @@
-import { applySwitchState } from "./helpers/dom.js";
-
-export function initSwitchEngine() {
-  // Re-apply whenever gg-switch-state changes on any element.
-  new MutationObserver((mutations) => {
-    mutations.forEach((m) => {
-      if (m.attributeName === "gg-switch-state") {
-        applySwitchState(m.target);
-      }
-    });
-  }).observe(document.body, {
-    attributes: true,
-    attributeFilter: ["gg-switch-state"],
-    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);
-}