@ponchia/ui 0.9.0 → 0.11.0

package/behaviors/modal.js

@@ -1,373 +0,0 @@
-import {
-  hasDom,
-  resolveHost,
-  noop,
-  bindOnce,
-  byIdInHost,
-  collectHosts,
-  focusInto,
-  closestSafe,
-} from './internal.js';
-
-const states = new WeakMap();
-
-const snapshotAttrs = (el, names) => {
-  const attrs = {};
-  for (const name of names) {
-    attrs[name] = {
-      had: el.hasAttribute(name),
-      value: el.getAttribute(name),
-    };
-  }
-  return attrs;
-};
-
-const restoreAttrs = (el, attrs) => {
-  for (const [name, state] of Object.entries(attrs)) {
-    if (state.had) el.setAttribute(name, state.value);
-    else el.removeAttribute(name);
-  }
-};
-
-function modalState(doc) {
-  let state = states.get(doc);
-  if (state) return state;
-  state = {
-    doc,
-    records: new Set(),
-    byModal: new Map(),
-    ownedInert: new Set(),
-    pendingOverlays: new Set(),
-    observer: null,
-    observing: false,
-    sequence: 0,
-    scheduled: false,
-    top: null,
-  };
-  states.set(doc, state);
-  return state;
-}
-
-function isEffectivelyActive(record, state) {
-  if (!record.active || !record.modal.isConnected) return false;
-  for (let node = record.modal.parentElement; node; node = node.parentElement) {
-    const ancestor = state.byModal.get(node);
-    if (ancestor && (!ancestor.active || !ancestor.modal.isConnected)) return false;
-  }
-  return true;
-}
-
-function activeTop(state) {
-  let top = null;
-  for (const record of state.records) {
-    if (!isEffectivelyActive(record, state)) continue;
-    if (!top || top.modal.contains(record.modal)) {
-      top = record;
-      continue;
-    }
-    if (!record.modal.contains(top.modal) && record.openedAt > top.openedAt) top = record;
-  }
-  return top;
-}
-
-function popoverIsOpen(panel, state) {
-  if (state.pendingOverlays.has(panel) || panel.classList.contains('is-open')) return true;
-  try {
-    return panel.matches(':popover-open');
-  } catch {
-    return false;
-  }
-}
-
-function modalOwnsPopover(modal, panel) {
-  if (modal.contains(panel)) return true;
-  if (!panel.id) return false;
-  return collectHosts(modal, '[data-bronto-popover]').some(
-    (trigger) => trigger.getAttribute('data-bronto-popover') === panel.id,
-  );
-}
-
-function liveRoots(state, top) {
-  const roots = new Set([top.modal]);
-  for (const trigger of collectHosts(top.modal, '[data-bronto-popover]')) {
-    const panel = byIdInHost(top.modal, trigger.getAttribute('data-bronto-popover'));
-    if (panel && popoverIsOpen(panel, state)) roots.add(panel);
-  }
-  for (const panel of state.pendingOverlays) {
-    if (modalOwnsPopover(top.modal, panel)) roots.add(panel);
-  }
-  return roots;
-}
-
-function desiredInert(state, top) {
-  const body = state.doc.body;
-  if (!body || !top) return new Set();
-  const roots = liveRoots(state, top);
-  const livePath = new Set([body]);
-  for (const root of roots) {
-    for (let node = root; node && node !== body; node = node.parentElement) {
-      livePath.add(node);
-    }
-  }
-
-  const desired = new Set();
-  for (const parent of livePath) {
-    if (roots.has(parent)) continue;
-    for (const child of parent.children || []) {
-      if (!livePath.has(child)) desired.add(child);
-    }
-  }
-  return desired;
-}
-
-function reconcileInert(state) {
-  const previousTop = state.top;
-  const nextTop = activeTop(state);
-  const desired = desiredInert(state, nextTop);
-
-  for (const element of [...state.ownedInert]) {
-    if (desired.has(element)) {
-      if (!element.inert) element.inert = true;
-      continue;
-    }
-    element.inert = false;
-    state.ownedInert.delete(element);
-  }
-  for (const element of desired) {
-    if (state.ownedInert.has(element) || element.inert) continue;
-    element.inert = true;
-    state.ownedInert.add(element);
-  }
-  state.top = nextTop;
-  return { previousTop, nextTop };
-}
-
-function scheduleReconcile(state) {
-  if (state.scheduled) return;
-  state.scheduled = true;
-  queueMicrotask(() => {
-    state.scheduled = false;
-    reconcileInert(state);
-  });
-}
-
-function ensureDocumentObserver(state) {
-  if (state.observing) return;
-  state.observing = true;
-  const view = state.doc.defaultView;
-  const Observer = view?.MutationObserver;
-  if (Observer && state.doc.body) {
-    state.observer = new Observer((mutations) => {
-      const relevant = mutations.some(
-        (mutation) =>
-          mutation.type === 'childList' || mutation.target.matches?.('.ui-popover, [popover]'),
-      );
-      if (relevant && state.top) scheduleReconcile(state);
-    });
-    state.observer.observe(state.doc.body, {
-      attributes: true,
-      attributeFilter: ['class'],
-      childList: true,
-      subtree: true,
-    });
-  }
-
-  state.onBeforeToggle = (event) => {
-    const panel = event.target;
-    if (!panel?.matches?.('[popover]')) return;
-    if (event.newState === 'open') state.pendingOverlays.add(panel);
-    else state.pendingOverlays.delete(panel);
-    reconcileInert(state);
-  };
-  state.onToggle = (event) => {
-    state.pendingOverlays.delete(event.target);
-    scheduleReconcile(state);
-  };
-  state.doc.addEventListener('beforetoggle', state.onBeforeToggle, true);
-  state.doc.addEventListener('toggle', state.onToggle, true);
-}
-
-function releaseDocumentState(state) {
-  if (state.records.size) return;
-  state.observer?.disconnect();
-  state.observer = null;
-  state.observing = false;
-  state.doc.removeEventListener('beforetoggle', state.onBeforeToggle, true);
-  state.doc.removeEventListener('toggle', state.onToggle, true);
-  state.pendingOverlays.clear();
-  reconcileInert(state);
-  states.delete(state.doc);
-}
-
-function restoreAfterClose(record, nextTop) {
-  const back = record.opener;
-  record.opener = null;
-  if (nextTop) {
-    if (back?.isConnected && nextTop.modal.contains(back)) back.focus?.();
-    else focusInto(nextTop.modal);
-    return;
-  }
-  if (back?.isConnected && typeof back.focus === 'function') back.focus();
-}
-
-function syncRecord(record) {
-  const { modal, state } = record;
-  const nextActive = modal.classList.contains('is-open');
-  if (nextActive === record.active) {
-    if (!record.isNativeDialog) modal.hidden = !nextActive;
-    scheduleReconcile(state);
-    return;
-  }
-
-  const oldTop = state.top ?? activeTop(state);
-  record.active = nextActive;
-  if (nextActive) {
-    record.opener = state.doc.activeElement;
-    record.openedAt = ++state.sequence;
-    if (!record.isNativeDialog) modal.hidden = false;
-    const { nextTop } = reconcileInert(state);
-    if (nextTop && (nextTop === record || modal.contains(nextTop.modal))) {
-      focusInto(nextTop.modal);
-    }
-    return;
-  }
-
-  if (!record.isNativeDialog) modal.hidden = true;
-  const closedOwnedTop = oldTop && (oldTop === record || modal.contains(oldTop.modal));
-  const { nextTop } = reconcileInert(state);
-  if (closedOwnedTop) restoreAfterClose(record, nextTop);
-  else record.opener = null;
-}
-
-function unregisterRecord(record) {
-  const { state, modal } = record;
-  const oldTop = state.top ?? activeTop(state);
-  const removedOwnedTop = oldTop && (oldTop === record || modal.contains(oldTop.modal));
-  record.active = false;
-  state.records.delete(record);
-  state.byModal.delete(modal);
-  const { nextTop } = reconcileInert(state);
-  if (removedOwnedTop) restoreAfterClose(record, nextTop);
-  else record.opener = null;
-  releaseDocumentState(state);
-}
-
-function targetIsOwnedPopover(target, modal, state) {
-  const panel = closestSafe(target, '.ui-popover, [popover]');
-  return Boolean(panel && popoverIsOpen(panel, state) && modalOwnsPopover(modal, panel));
-}
-
-/**
- * @typedef {object} ModalCloseDetail
- * @property {'escape'} reason What asked the modal to close (currently only Escape).
- */
-
-/**
- * Focus management for the **controlled, non-`<dialog>` modal** — the
- * `.ui-modal.is-open` path a portal/React overlay uses when it genuinely can't
- * be a native `<dialog>`. The native `<dialog>` path gets a focus trap, Escape,
- * and the top layer for free (use `initDialog`); this supplies the equivalent
- * for the `.is-open` path, which otherwise leaves focus management to the
- * consumer.
- *
- * Mark the overlay `[data-bronto-modal]` (opt-in). On bind it gives the modal a
- * `role="dialog"` + `aria-modal="true"` (unless the author set a role) and
- * dev-warns when it has no accessible name. While open, a document-level stack
- * reconciler keeps only the top controlled modal interactive, marks the rest of
- * the page `inert`, admits an open popover owned by the top modal even when the
- * panel is portaled elsewhere, and applies the trap to background nodes added
- * after open. Nested and sibling portal modals therefore share one ownership
- * model instead of independently inverting each other's `inert` state.
- *
- * Bronto owns focus only: the **consumer still owns open/close state** (the
- * `is-open` class). Escape dispatches a cancelable `bronto:modal:close`
- * ({@link ModalCloseDetail}) on the modal so the consumer can drop `is-open` in
- * response; the behavior never changes visibility itself. Closing a parent
- * modal temporarily suspends any still-`is-open` controlled descendants; they
- * resume at the top of the stack if the parent reopens.
- *
- * SSR-safe, idempotent per modal; returns a cleanup function.
- *
- * @deprecated Use a native `<dialog>` with `initDialog()`. This controlled
- * non-dialog path remains compatible in 0.7 and is scheduled for removal no
- * earlier than 0.8 because no real consumer adopted it.
- *
- * @param {import('./internal.js').DelegateOpts} [opts]
- * @returns {import('./internal.js').Cleanup}
- */
-export function initModal({ root } = {}) {
-  if (!hasDom()) return noop;
-  const host = resolveHost(root);
-  if (!host) return noop;
-  const modals = collectHosts(host, '[data-bronto-modal]');
-  const cleanups = [];
-
-  for (const modal of modals) {
-    const doc = modal.ownerDocument;
-    if (!doc) continue;
-    const view = doc.defaultView;
-    cleanups.push(
-      bindOnce(modal, 'modal', () => {
-        const attrs = snapshotAttrs(modal, ['role', 'aria-modal', 'tabindex', 'hidden']);
-        const state = modalState(doc);
-        const record = {
-          active: modal.classList.contains('is-open'),
-          isNativeDialog: modal.localName === 'dialog',
-          modal,
-          openedAt: 0,
-          opener: null,
-          state,
-        };
-
-        if (!modal.hasAttribute('role')) modal.setAttribute('role', 'dialog');
-        if (!modal.hasAttribute('aria-modal')) modal.setAttribute('aria-modal', 'true');
-        const named =
-          modal.hasAttribute('aria-label') ||
-          modal.hasAttribute('aria-labelledby') ||
-          modal.hasAttribute('title');
-        if (!named && typeof console !== 'undefined') {
-          console.warn(
-            `[bronto] initModal(): a [data-bronto-modal] has no accessible name — add aria-label or aria-labelledby so it is announced as a named dialog.`,
-          );
-        }
-
-        if (record.active) {
-          record.opener = doc.activeElement;
-          record.openedAt = ++state.sequence;
-        }
-        if (!record.isNativeDialog) modal.hidden = !record.active;
-        state.records.add(record);
-        state.byModal.set(modal, record);
-        ensureDocumentObserver(state);
-        reconcileInert(state);
-        if (state.top === record) focusInto(modal);
-
-        const Observer = view?.MutationObserver;
-        const observer = Observer ? new Observer(() => syncRecord(record)) : null;
-        observer?.observe(modal, { attributes: true, attributeFilter: ['class'] });
-        const onKey = (event) => {
-          if (event.key !== 'Escape' || state.top !== record) return;
-          if (targetIsOwnedPopover(event.target, modal, state)) return;
-          const ModalCloseEvent = view?.CustomEvent ?? CustomEvent;
-          modal.dispatchEvent(
-            new ModalCloseEvent('bronto:modal:close', {
-              detail: { reason: 'escape' },
-              bubbles: true,
-              cancelable: true,
-            }),
-          );
-        };
-        doc.addEventListener('keydown', onKey, true);
-
-        return () => {
-          observer?.disconnect();
-          doc.removeEventListener('keydown', onKey, true);
-          unregisterRecord(record);
-          restoreAttrs(modal, attrs);
-        };
-      }),
-    );
-  }
-
-  return () => cleanups.forEach((fn) => fn());
-}

package/qwik/index.d.ts

@@ -1,48 +0,0 @@
-/** Generic escape hatch. NOTE for Qwik: prefer the specific `use*` hooks
- *  below — they inline a statically-imported behavior so the optimizer can
- *  serialize the task. Passing a runtime function here is only safe when it
- *  is itself optimizer-visible (a module import).
- *  @template {DelegateOpts} [T=DelegateOpts]
- *  @param {(opts?: T) => Cleanup | void} init
- *  @param {BrontoBindingOptsResolver<T>} [opts]
- *  @returns {void} */
-export function useBrontoBehavior<T extends DelegateOpts = import("../behaviors/internal.js").DelegateOpts>(init: (opts?: T) => Cleanup | void, opts?: BrontoBindingOptsResolver<T>): void;
-export function useThemeToggle(opts?: BrontoBindingOptsResolver<ThemeStorageOpts & DelegateOpts>): void;
-export function useDismissible(opts?: BrontoBindingOptsResolver): void;
-export function useDisabledGuard(opts?: BrontoBindingOptsResolver): void;
-export function useDisclosure(opts?: BrontoBindingOptsResolver): void;
-export function useMenu(opts?: BrontoBindingOptsResolver): void;
-export function useFormValidation(opts?: BrontoBindingOptsResolver): void;
-export function useCombobox(opts?: BrontoBindingOptsResolver): void;
-export function usePopover(opts?: BrontoBindingOptsResolver): void;
-export function useTableSort(opts?: BrontoBindingOptsResolver): void;
-export function useTabs(opts?: BrontoBindingOptsResolver): void;
-export function useDialog(opts?: BrontoBindingOptsResolver): void;
-export function useModal(opts?: BrontoBindingOptsResolver): void;
-export function useCarousel(opts?: BrontoBindingOptsResolver): void;
-export function useDotGlyph(opts?: BrontoBindingOptsResolver): void;
-export function useLegend(opts?: BrontoBindingOptsResolver): void;
-export function useConnectors(opts?: BrontoBindingOptsResolver): void;
-export function useSpotlight(opts?: BrontoBindingOptsResolver): void;
-export function useCrosshair(opts?: BrontoBindingOptsResolver): void;
-export function useCommand(opts?: BrontoBindingOptsResolver): void;
-export function useSources(opts?: BrontoBindingOptsResolver): void;
-export function useSplitter(opts?: BrontoBindingOptsResolver): void;
-export function useToast(): (message: string, opts?: ToastOpts) => Cleanup;
-export { applyStoredTheme };
-export type Cleanup = import("../behaviors/index.js").Cleanup;
-export type DelegateOpts = import("../behaviors/index.js").DelegateOpts;
-export type ThemeStorageOpts = import("../behaviors/index.js").ThemeStorageOpts;
-export type ToastOpts = import("../behaviors/index.js").ToastOpts;
-export type BrontoBindingRoot = Document | Element | {
-    value: Document | Element | null | undefined;
-} | {
-    current: Document | Element | null | undefined;
-} | (() => Document | Element | null | undefined) | null | undefined;
-export type BrontoBindingOpts<T extends DelegateOpts = import("../behaviors/internal.js").DelegateOpts> = Omit<T, "root"> & {
-    root?: BrontoBindingRoot;
-};
-export type BrontoBindingOptsResolver<T extends DelegateOpts = import("../behaviors/internal.js").DelegateOpts> = BrontoBindingOpts<T> | (() => BrontoBindingOpts<T> | null | undefined) | null | undefined;
-import { applyStoredTheme } from '../behaviors/index.js';
-export { cls, ui, cx } from "../classes/index.js";
-//# sourceMappingURL=index.d.ts.map

package/qwik/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.js"],"names":[],"mappings":"AAuHA;;;;;;;sBAOsB;AACtB,kCAJ8B,CAAC,SAAhB,YAAa,0DAChB,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,SAC5B,yBAAyB,CAAC,CAAC,CAAC,GAC1B,IAAI,CAIjB;AAGM,sCADK,yBAAyB,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAmB,IAAI,CAGhC;AAEtD,sCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,wCADK,yBAAyB,GAAmB,IAAI,CAGG;AAExD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,yCADK,yBAAyB,GAAmB,IAAI,CAGI;AAEzD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,+BADK,yBAAyB,GAAmB,IAAI,CAGN;AAE/C,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,gCADK,yBAAyB,GAAmB,IAAI,CAGL;AAEhD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAEnD,iCADK,yBAAyB,GAAmB,IAAI,CAGJ;AAEjD,qCADK,yBAAyB,GAAmB,IAAI,CAGA;AAErD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,oCADK,yBAAyB,GAAmB,IAAI,CAGD;AAEpD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,kCADK,yBAAyB,GAAmB,IAAI,CAGH;AAElD,mCADK,yBAAyB,GAAmB,IAAI,CAGF;AAInD,4BADO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,KAAK,OAAO,CACzB;;sBA5LtB,OAAO,uBAAuB,EAAE,OAAO;2BACvC,OAAO,uBAAuB,EAAE,YAAY;+BAC5C,OAAO,uBAAuB,EAAE,gBAAgB;wBAChD,OAAO,uBAAuB,EAAE,SAAS;gCAEzC,QAAQ,GACd,OAAO,GACP;IAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAClD,CAAC,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,GAC7C,IAAI,GACJ,SAAS;8BAIa,CAAC,SAAhB,YAAa,sDACd,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE;sCAI9B,CAAC,SAAhB,YAAa,sDACd,iBAAiB,CAAC,CAAC,CAAC,GAC1B,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,IAAI,GACJ,SAAS;iCA2BT,uBAAuB"}

package/qwik/index.js

@@ -1,227 +0,0 @@
-/**
- * @ponchia/ui/qwik — thin Qwik bindings over @ponchia/ui/behaviors.
- *
- * The CSS is the framework; these are *optional* hooks that wrap the SSR-safe
- * vanilla `init*` behaviors in Qwik's client lifecycle. Thin adapters, not a
- * component library (architecture ADR). `@builder.io/qwik` is an optional peer
- * dependency.
- *
- * Qwik is resumable: nothing runs until needed, and our behaviors are exactly
- * the kind of "enhance on the client" glue that fits — they `useVisibleTask$`
- * (run when the owning component first becomes visible) and register cleanup,
- * so a server-rendered page stays zero-JS until interaction. Each hook inlines
- * its specific behavior so the Qwik optimizer can resolve the import inside the
- * extracted task segment.
- *
- *   import { component$ } from '@builder.io/qwik';
- *   import { useDialog, useToast } from '@ponchia/ui/qwik';
- *   export default component$(() => {
- *     useDialog();                 // wires every .ui-modal under document
- *     const toast = useToast();
- *     return <button onClick$={() => toast('Saved', { tone: 'success' })}>Save</button>;
- *   });
- *
- * Scope a behavior to a subtree by passing a Qwik signal:
- *   const root = useSignal();
- *   useDialog({ root });           // <section ref={root}> … </section>
- *
- * @deprecated Import the framework-agnostic behavior initializers directly.
- * This adapter remains compatible in 0.7 and is scheduled for removal no
- * earlier than 0.8 because no real consumer adopted it.
- *
- * @typedef {import('../behaviors/index.js').Cleanup} Cleanup
- * @typedef {import('../behaviors/index.js').DelegateOpts} DelegateOpts
- * @typedef {import('../behaviors/index.js').ThemeStorageOpts} ThemeStorageOpts
- * @typedef {import('../behaviors/index.js').ToastOpts} ToastOpts
- *
- * @typedef {Document
- *   | Element
- *   | { value: Document | Element | null | undefined }
- *   | { current: Document | Element | null | undefined }
- *   | (() => Document | Element | null | undefined)
- *   | null
- *   | undefined} BrontoBindingRoot
- */
-
-/**
- * @template {DelegateOpts} [T=DelegateOpts]
- * @typedef {Omit<T, 'root'> & { root?: BrontoBindingRoot }} BrontoBindingOpts
- */
-
-/**
- * @template {DelegateOpts} [T=DelegateOpts]
- * @typedef {BrontoBindingOpts<T>
- *   | (() => BrontoBindingOpts<T> | null | undefined)
- *   | null
- *   | undefined} BrontoBindingOptsResolver
- */
-import { useVisibleTask$ } from '@builder.io/qwik';
-import {
-  applyStoredTheme,
-  initThemeToggle,
-  dismissible,
-  initDisabledGuard,
-  initDisclosure,
-  initMenu,
-  initFormValidation,
-  initCombobox,
-  initPopover,
-  initTableSort,
-  initTabs,
-  initDialog,
-  initModal,
-  initCarousel,
-  initDotGlyph,
-  initLegend,
-  initConnectors,
-  initSpotlight,
-  initCrosshair,
-  initCommand,
-  initSources,
-  initSplitter,
-  toast,
-} from '../behaviors/index.js';
-
-function resolveMaybe(v) {
-  return typeof v === 'function' ? v() : v;
-}
-
-function resolveRoot(root) {
-  const value = resolveMaybe(root);
-  if (value && typeof value === 'object') {
-    if ('value' in value) return value.value; // Qwik signal (useSignal)
-    if ('current' in value) return value.current; // generic ref shape
-  }
-  return value;
-}
-
-function resolveOpts(opts) {
-  const value = resolveMaybe(opts);
-  if (!value || typeof value !== 'object') return undefined;
-  // No `root` key → no scope requested; leave root out so the behavior
-  // delegates from `document`. A `root` key that resolves falsy means a scope
-  // WAS requested but the ref is not ready: emit `root: null` so the behavior
-  // no-ops instead of hijacking the whole document.
-  if (!('root' in value)) return { ...value };
-  const root = resolveRoot(value.root);
-  return { ...value, root: root || null };
-}
-
-/** Run a delegated behavior on visible and register its cleanup on dispose.
- *  `init` and `opts` are resolved inside the visible task, so a Qwik-signal
- *  root is read after the element is assigned and tracked for later changes.
- *  Shared, non-QRL, so the optimizer keeps the captured behavior import inside
- *  the task segment. */
-function start(init, opts, ctx) {
-  const cleanup = init(ctx.track(() => resolveOpts(opts)));
-  if (typeof cleanup === 'function') ctx.cleanup(cleanup);
-}
-
-/** Generic escape hatch. NOTE for Qwik: prefer the specific `use*` hooks
- *  below — they inline a statically-imported behavior so the optimizer can
- *  serialize the task. Passing a runtime function here is only safe when it
- *  is itself optimizer-visible (a module import).
- *  @template {DelegateOpts} [T=DelegateOpts]
- *  @param {(opts?: T) => Cleanup | void} init
- *  @param {BrontoBindingOptsResolver<T>} [opts]
- *  @returns {void} */
-export function useBrontoBehavior(init, opts) {
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(init, opts, ctx));
-}
-
-/** @param {BrontoBindingOptsResolver<ThemeStorageOpts & DelegateOpts>} [opts] @returns {void} */
-export const useThemeToggle = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initThemeToggle, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useDismissible = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(dismissible, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useDisabledGuard = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initDisabledGuard, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useDisclosure = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initDisclosure, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useMenu = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initMenu, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useFormValidation = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initFormValidation, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useCombobox = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initCombobox, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const usePopover = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initPopover, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useTableSort = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initTableSort, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useTabs = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initTabs, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useDialog = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initDialog, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useModal = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initModal, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useCarousel = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initCarousel, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useDotGlyph = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initDotGlyph, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useLegend = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initLegend, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useConnectors = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initConnectors, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useSpotlight = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initSpotlight, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useCrosshair = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initCrosshair, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useCommand = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initCommand, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useSources = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initSources, opts, ctx));
-/** @param {BrontoBindingOptsResolver} [opts] @returns {void} */
-export const useSplitter = (opts) =>
-  // eslint-disable-next-line qwik/no-use-visible-task -- intentional delegated DOM glue + cleanup
-  useVisibleTask$((ctx) => start(initSplitter, opts, ctx));
-
-/** The `toast()` imperative (no lifecycle of its own).
- *  @returns {(message: string, opts?: ToastOpts) => Cleanup} */
-export const useToast = () => toast;
-
-// No-flash theme application must run before paint — do it in an inline head
-// script, not on visible. Re-exported for manual/SSR-bootstrap use.
-export { applyStoredTheme };
-
-// Convenience: the framework-agnostic class contract, re-exported.
-export { cls, ui, cx } from '../classes/index.js';