@techzyapp/ui-library 1.0.30 → 1.0.32

package/dist/theme/ConfigProvider.d.ts

@@ -171,6 +171,31 @@ export interface HeaderMenuItem {
     /** Tint, e.g. `'error'` for a destructive item. Default: inherit. */
     color?: ThemeColor;
 }
+/**
+ * An app action button in the shell header — rendered as an `IconButton` in the same style as the built-in
+ * header controls (with a `Tooltip` and an optional count / dot badge), left of them. On narrow screens
+ * (`xs`) the actions move into the account menu (when there is one).
+ */
+export interface HeaderAction {
+    /** Icon on the button (`IconName`). */
+    icon: IconName;
+    /** Accessible name + tooltip text (and the item label once it moves into the account menu). */
+    label: string;
+    /** Runs on click. */
+    onClick?: () => void;
+    /** Router path to navigate to on click (instead of / as well as `onClick`). */
+    to?: string;
+    /** Count / text badge pinned to the button (e.g. unread notifications). A numeric `0` is hidden. */
+    badge?: number | string;
+    /** A plain indicator dot instead of a count. */
+    dot?: boolean;
+    /** Badge / dot tint. Defaults to `error`. */
+    badgeColor?: ThemeColor;
+    /** Icon tint. Defaults to the header controls' tint (`accent`). */
+    color?: ThemeColor;
+    /** Renders the button disabled. */
+    disabled?: boolean;
+}
 /**
  * `RootLayout` header configuration — the shell's top-bar controls. Set it once app-wide in
  * `config.header`, or per shell via the `RootLayout` `header` prop (the prop wins, merged over config).
@@ -211,6 +236,18 @@ export interface HeaderConfig {
      * prop's `menu` array **replaces** the config's — arrays don't concatenate.)
      */
     menu?: HeaderMenuItem[];
+    /**
+     * App action buttons, left of the built-in controls (theme / language / settings / account), in order —
+     * styled like them, each with a tooltip and an optional badge. On `xs` they move into the account menu
+     * (above the `menu` items) when `onLogout` is set; otherwise they stay in the header. Like `menu`, a
+     * `header` prop's `actions` **replaces** the config's.
+     */
+    actions?: HeaderAction[];
+    /**
+     * Free-form header content for what `actions` can't express — a text `Button` ("New Order"), a `Dropdown`,
+     * an environment `Chip`. Rendered left of `actions`; hidden on `xs` (the header has no room there).
+     */
+    extra?: ReactNode;
 }
 /**
  * UI-language config for the admin panel's **own** static strings (labels, placeholders, aria-labels).
@@ -271,6 +308,22 @@ export interface Config {
      * `header` prop is merged over this (the prop wins), so a specific shell can override.
      */
     header?: HeaderConfig;
+    /** Google Maps settings for `LocationPicker` (the API key etc.), app-wide. See `MapsConfig`. */
+    maps?: MapsConfig;
+}
+/**
+ * Google Maps settings, app-wide — read by `LocationPicker` (its own `apiKey` / `mapId` props win). The key is the
+ * app's **browser** key (restrict it by HTTP referrer in the Google Cloud console); the Maps JavaScript API is
+ * loaded on demand the first time a map renders, so a panel that never shows one never loads it.
+ */
+export interface MapsConfig {
+    /** The Google Maps JavaScript API key. */
+    apiKey?: string;
+    /**
+     * A Map ID (Google Cloud → Map Management). Optional — with one the pin is an `AdvancedMarkerElement` and the
+     * map uses its cloud style; without it a classic marker + the library's light / dark styling are used.
+     */
+    mapId?: string;
 }
 interface ThemeContextValue {
     mode: ThemeMode;
@@ -295,6 +348,8 @@ interface ThemeContextValue {
     tableQuery: TableQueryConfig;
     /** App-wide `RootLayout` header config (`config.header` ?? `{}`); the `RootLayout` prop merges over it. */
     header: HeaderConfig;
+    /** App-wide Google Maps settings (`config.maps` ?? `{}`). */
+    maps: MapsConfig;
     /** Whether the shell header sticks to the top on scroll (fixed) vs scrolls away (static). Persisted. */
     headerSticky: boolean;
     /** Set + persist the header sticky/static preference (overrides `config.header.sticky`). */
@@ -307,6 +362,17 @@ interface ThemeContextValue {
     shape: ThemeShape;
     /** Set + persist the corner shape (overrides `config.theme.shape`). */
     setShape: (shape: ThemeShape) => void;
+    /**
+     * `true` while any appearance preference differs from the app's configured default — the mode, either
+     * mode's accent, the font, the header sticky choice or the shape. Drives the Settings drawer's Reset.
+     */
+    hasCustomPreferences: boolean;
+    /**
+     * Reset every appearance preference to the app's configured default (`config.theme.mode` / `fontFamily` /
+     * `shape`, `config.header.sticky`, no accent override) and forget the saved choices, so the configured
+     * defaults apply again on the next visit. The UI language is not touched (it isn't an appearance setting).
+     */
+    resetPreferences: () => void;
     /** Active UI language code (drives `t`). Persisted; seeded from `config.i18n.language` (default English). */
     language: string;
     /** Set + persist the active UI language (must be one of `languages`). */
@@ -408,4 +474,8 @@ export declare function useTableQueryConfig(): TableQueryConfig;
  * a specific shell can override the app-wide defaults.
  */
 export declare function useHeaderConfig(): HeaderConfig;
+/** The app-wide Google Maps settings (`config.maps`; `{}` when unset / outside a provider). */
+export declare function useMapsConfig(): MapsConfig;
+/** The active light / dark mode — lenient (`'light'` outside a provider), for components that only read it. */
+export declare function useColorMode(): ThemeMode;
 export {};

package/dist/theme/index.d.cts

@@ -2,6 +2,6 @@ export { applyTheme } from './applyTheme';
 export type { ThemePalette, ThemeColor } from './applyTheme';
 export { BREAKPOINTS, BREAKPOINT_ORDER, breakpointQuery, resolveResponsive } from './breakpoints';
 export type { Breakpoint, Responsive } from './breakpoints';
-export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
-export type { Config, ThemeConfig, ThemeColors, ThemeMode, ThemeShape, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, HeaderMenuItem, I18nConfig, } from './ConfigProvider';
+export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useMapsConfig, useColorMode, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
+export type { Config, ThemeConfig, ThemeColors, ThemeMode, ThemeShape, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, HeaderMenuItem, HeaderAction, MapsConfig, I18nConfig, } from './ConfigProvider';
 export type { Messages, MessageKey, MessageCatalog, MessageOverrides, Translator, AppMessages, AppTranslator, } from '../i18n/messages';

package/dist/theme/index.d.ts

@@ -2,6 +2,6 @@ export { applyTheme } from './applyTheme';
 export type { ThemePalette, ThemeColor } from './applyTheme';
 export { BREAKPOINTS, BREAKPOINT_ORDER, breakpointQuery, resolveResponsive } from './breakpoints';
 export type { Breakpoint, Responsive } from './breakpoints';
-export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
-export type { Config, ThemeConfig, ThemeColors, ThemeMode, ThemeShape, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, HeaderMenuItem, I18nConfig, } from './ConfigProvider';
+export { ConfigProvider, useTheme, useLocales, useTranslationsNamespace, useTabsQueryKey, useNestedTabQueryKey, useStepQueryKey, useTableQueryConfig, useHeaderConfig, useMapsConfig, useColorMode, useT, useTranslations, useLanguage, DEFAULT_TABS_QUERY_KEY, DEFAULT_NESTED_TAB_QUERY_KEY, DEFAULT_STEP_QUERY_KEY, DEFAULT_FONT_FAMILY, } from './ConfigProvider';
+export type { Config, ThemeConfig, ThemeColors, ThemeMode, ThemeShape, ConfigProviderProps, LocaleConfig, KeysConfig, TableConfig, TableQueryConfig, HeaderConfig, HeaderUser, HeaderMenuItem, HeaderAction, MapsConfig, I18nConfig, } from './ConfigProvider';
 export type { Messages, MessageKey, MessageCatalog, MessageOverrides, Translator, AppMessages, AppTranslator, } from '../i18n/messages';

package/dist/useClearUrlOnUnmount-Cg7v2y5B.cjs

@@ -0,0 +1,2 @@
+"use strict";const r=require("react"),o=new Map;function c(e,u,t){const n=r.useRef(u);n.current=u;const a=r.useRef(t);a.current=t;const i=r.useRef(null);r.useEffect(()=>{typeof window<"u"&&(i.current=window.location.pathname)}),r.useEffect(()=>{if(!(!e||typeof window>"u"))return o.set(e,(o.get(e)??0)+1),()=>{if(o.set(e,(o.get(e)??1)-1),!n.current)return;const s=i.current;window.setTimeout(()=>{(o.get(e)??0)>0||window.location.pathname===s&&a.current()},0)}},[e])}function f(e,u=window.history.state){const t=new URLSearchParams(window.location.search);if(!t.has(e))return!1;t.delete(e);const n=t.toString();return window.history.replaceState(u,"",`${window.location.pathname}${n?`?${n}`:""}${window.location.hash}`),!0}exports.removeQueryParam=f;exports.useClearUrlOnUnmount=c;
+//# sourceMappingURL=useClearUrlOnUnmount-Cg7v2y5B.cjs.map

package/dist/useClearUrlOnUnmount-Cg7v2y5B.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClearUrlOnUnmount-Cg7v2y5B.cjs","sources":["../src/hooks/useClearUrlOnUnmount.ts"],"sourcesContent":["import { useEffect, useRef } from 'react'\n\n/** Live owners per param — a param is only cleared once nothing mounted uses it any more. */\nconst owners = new Map<string, number>()\n\n/**\n * Internal: run `clear` when the component unmounts **while the page it was on is still showing** — the\n * shared \"remove my URL param on unmount\" rule behind `Tabs`, `Stepper` and `useQueryModal` (`clearUrlOnUnmount`).\n *\n * - Same pathname (a tab switch, a closing modal / sheet, a conditional render) → `clear()` runs.\n * - Another pathname (the user navigated away) → nothing: the URL already belongs to the next page. The\n *   pathname compared is the one of the component's latest render, so one inside a layout that survives\n *   child-route changes still clears on the page it's actually on.\n * - Deferred one tick, and skipped while **any** mounted component still uses the same param — so\n *   StrictMode's simulated unmount → remount never wipes a deep-linked param, and a replacement that mounts\n *   in the same commit (the new nested `Tabs` in the panel you switched to, a second `useQueryModal` on the\n *   same key) keeps it.\n *\n * `key` scopes the effect (the cleanup is armed only while there is a key; a key change re-arms it).\n * `enabled` is read at unmount time, so flipping it never clears a live component's param.\n */\nexport function useClearUrlOnUnmount(\n  key: string | undefined,\n  enabled: boolean,\n  clear: () => void,\n): void {\n  const enabledRef = useRef(enabled)\n  enabledRef.current = enabled\n  const clearRef = useRef(clear)\n  clearRef.current = clear\n  // the pathname as of the latest render — a component in a layout that stays mounted across child routes\n  // re-renders on the new path, while one torn down BY a navigation last rendered on the old one\n  const pathRef = useRef<string | null>(null)\n  useEffect(() => {\n    if (typeof window !== 'undefined') pathRef.current = window.location.pathname\n  })\n\n  useEffect(() => {\n    if (!key || typeof window === 'undefined') return\n    owners.set(key, (owners.get(key) ?? 0) + 1)\n    return () => {\n      owners.set(key, (owners.get(key) ?? 1) - 1)\n      if (!enabledRef.current) return\n      const path = pathRef.current\n      window.setTimeout(() => {\n        if ((owners.get(key) ?? 0) > 0) return // still (or again) in use\n        if (window.location.pathname !== path) return\n        clearRef.current()\n      }, 0)\n    }\n  }, [key])\n}\n\n/** Remove `key` from the current URL query with `replaceState` (path, other params and hash kept). */\nexport function removeQueryParam(key: string, state: unknown = window.history.state): boolean {\n  const params = new URLSearchParams(window.location.search)\n  if (!params.has(key)) return false\n  params.delete(key)\n  const query = params.toString()\n  window.history.replaceState(\n    state,\n    '',\n    `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`,\n  )\n  return true\n}\n"],"names":["owners","useClearUrlOnUnmount","key","enabled","clear","enabledRef","useRef","clearRef","pathRef","useEffect","path","removeQueryParam","state","params","query"],"mappings":"sCAGMA,MAAa,IAkBZ,SAASC,EACdC,EACAC,EACAC,EACM,CACN,MAAMC,EAAaC,EAAAA,OAAOH,CAAO,EACjCE,EAAW,QAAUF,EACrB,MAAMI,EAAWD,EAAAA,OAAOF,CAAK,EAC7BG,EAAS,QAAUH,EAGnB,MAAMI,EAAUF,EAAAA,OAAsB,IAAI,EAC1CG,EAAAA,UAAU,IAAM,CACV,OAAO,OAAW,MAAaD,EAAQ,QAAU,OAAO,SAAS,SACvE,CAAC,EAEDC,EAAAA,UAAU,IAAM,CACd,GAAI,GAACP,GAAO,OAAO,OAAW,KAC9B,OAAAF,EAAO,IAAIE,GAAMF,EAAO,IAAIE,CAAG,GAAK,GAAK,CAAC,EACnC,IAAM,CAEX,GADAF,EAAO,IAAIE,GAAMF,EAAO,IAAIE,CAAG,GAAK,GAAK,CAAC,EACtC,CAACG,EAAW,QAAS,OACzB,MAAMK,EAAOF,EAAQ,QACrB,OAAO,WAAW,IAAM,EACjBR,EAAO,IAAIE,CAAG,GAAK,GAAK,GACzB,OAAO,SAAS,WAAaQ,GACjCH,EAAS,QAAA,CACX,EAAG,CAAC,CACN,CACF,EAAG,CAACL,CAAG,CAAC,CACV,CAGO,SAASS,EAAiBT,EAAaU,EAAiB,OAAO,QAAQ,MAAgB,CAC5F,MAAMC,EAAS,IAAI,gBAAgB,OAAO,SAAS,MAAM,EACzD,GAAI,CAACA,EAAO,IAAIX,CAAG,EAAG,MAAO,GAC7BW,EAAO,OAAOX,CAAG,EACjB,MAAMY,EAAQD,EAAO,SAAA,EACrB,cAAO,QAAQ,aACbD,EACA,GACA,GAAG,OAAO,SAAS,QAAQ,GAAGE,EAAQ,IAAIA,CAAK,GAAK,EAAE,GAAG,OAAO,SAAS,IAAI,EAAA,EAExE,EACT"}

package/dist/useClearUrlOnUnmount-DOeh6CUN.js

@@ -0,0 +1,37 @@
+import { useRef as a, useEffect as s } from "react";
+const r = /* @__PURE__ */ new Map();
+function f(t, o, n) {
+  const e = a(o);
+  e.current = o;
+  const i = a(n);
+  i.current = n;
+  const u = a(null);
+  s(() => {
+    typeof window < "u" && (u.current = window.location.pathname);
+  }), s(() => {
+    if (!(!t || typeof window > "u"))
+      return r.set(t, (r.get(t) ?? 0) + 1), () => {
+        if (r.set(t, (r.get(t) ?? 1) - 1), !e.current) return;
+        const c = u.current;
+        window.setTimeout(() => {
+          (r.get(t) ?? 0) > 0 || window.location.pathname === c && i.current();
+        }, 0);
+      };
+  }, [t]);
+}
+function d(t, o = window.history.state) {
+  const n = new URLSearchParams(window.location.search);
+  if (!n.has(t)) return !1;
+  n.delete(t);
+  const e = n.toString();
+  return window.history.replaceState(
+    o,
+    "",
+    `${window.location.pathname}${e ? `?${e}` : ""}${window.location.hash}`
+  ), !0;
+}
+export {
+  d as r,
+  f as u
+};
+//# sourceMappingURL=useClearUrlOnUnmount-DOeh6CUN.js.map

package/dist/useClearUrlOnUnmount-DOeh6CUN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClearUrlOnUnmount-DOeh6CUN.js","sources":["../src/hooks/useClearUrlOnUnmount.ts"],"sourcesContent":["import { useEffect, useRef } from 'react'\n\n/** Live owners per param — a param is only cleared once nothing mounted uses it any more. */\nconst owners = new Map<string, number>()\n\n/**\n * Internal: run `clear` when the component unmounts **while the page it was on is still showing** — the\n * shared \"remove my URL param on unmount\" rule behind `Tabs`, `Stepper` and `useQueryModal` (`clearUrlOnUnmount`).\n *\n * - Same pathname (a tab switch, a closing modal / sheet, a conditional render) → `clear()` runs.\n * - Another pathname (the user navigated away) → nothing: the URL already belongs to the next page. The\n *   pathname compared is the one of the component's latest render, so one inside a layout that survives\n *   child-route changes still clears on the page it's actually on.\n * - Deferred one tick, and skipped while **any** mounted component still uses the same param — so\n *   StrictMode's simulated unmount → remount never wipes a deep-linked param, and a replacement that mounts\n *   in the same commit (the new nested `Tabs` in the panel you switched to, a second `useQueryModal` on the\n *   same key) keeps it.\n *\n * `key` scopes the effect (the cleanup is armed only while there is a key; a key change re-arms it).\n * `enabled` is read at unmount time, so flipping it never clears a live component's param.\n */\nexport function useClearUrlOnUnmount(\n  key: string | undefined,\n  enabled: boolean,\n  clear: () => void,\n): void {\n  const enabledRef = useRef(enabled)\n  enabledRef.current = enabled\n  const clearRef = useRef(clear)\n  clearRef.current = clear\n  // the pathname as of the latest render — a component in a layout that stays mounted across child routes\n  // re-renders on the new path, while one torn down BY a navigation last rendered on the old one\n  const pathRef = useRef<string | null>(null)\n  useEffect(() => {\n    if (typeof window !== 'undefined') pathRef.current = window.location.pathname\n  })\n\n  useEffect(() => {\n    if (!key || typeof window === 'undefined') return\n    owners.set(key, (owners.get(key) ?? 0) + 1)\n    return () => {\n      owners.set(key, (owners.get(key) ?? 1) - 1)\n      if (!enabledRef.current) return\n      const path = pathRef.current\n      window.setTimeout(() => {\n        if ((owners.get(key) ?? 0) > 0) return // still (or again) in use\n        if (window.location.pathname !== path) return\n        clearRef.current()\n      }, 0)\n    }\n  }, [key])\n}\n\n/** Remove `key` from the current URL query with `replaceState` (path, other params and hash kept). */\nexport function removeQueryParam(key: string, state: unknown = window.history.state): boolean {\n  const params = new URLSearchParams(window.location.search)\n  if (!params.has(key)) return false\n  params.delete(key)\n  const query = params.toString()\n  window.history.replaceState(\n    state,\n    '',\n    `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`,\n  )\n  return true\n}\n"],"names":["owners","useClearUrlOnUnmount","key","enabled","clear","enabledRef","useRef","clearRef","pathRef","useEffect","path","removeQueryParam","state","params","query"],"mappings":";AAGA,MAAMA,wBAAa,IAAA;AAkBZ,SAASC,EACdC,GACAC,GACAC,GACM;AACN,QAAMC,IAAaC,EAAOH,CAAO;AACjC,EAAAE,EAAW,UAAUF;AACrB,QAAMI,IAAWD,EAAOF,CAAK;AAC7B,EAAAG,EAAS,UAAUH;AAGnB,QAAMI,IAAUF,EAAsB,IAAI;AAC1C,EAAAG,EAAU,MAAM;AACd,IAAI,OAAO,SAAW,QAAaD,EAAQ,UAAU,OAAO,SAAS;AAAA,EACvE,CAAC,GAEDC,EAAU,MAAM;AACd,QAAI,GAACP,KAAO,OAAO,SAAW;AAC9B,aAAAF,EAAO,IAAIE,IAAMF,EAAO,IAAIE,CAAG,KAAK,KAAK,CAAC,GACnC,MAAM;AAEX,YADAF,EAAO,IAAIE,IAAMF,EAAO,IAAIE,CAAG,KAAK,KAAK,CAAC,GACtC,CAACG,EAAW,QAAS;AACzB,cAAMK,IAAOF,EAAQ;AACrB,eAAO,WAAW,MAAM;AACtB,WAAKR,EAAO,IAAIE,CAAG,KAAK,KAAK,KACzB,OAAO,SAAS,aAAaQ,KACjCH,EAAS,QAAA;AAAA,QACX,GAAG,CAAC;AAAA,MACN;AAAA,EACF,GAAG,CAACL,CAAG,CAAC;AACV;AAGO,SAASS,EAAiBT,GAAaU,IAAiB,OAAO,QAAQ,OAAgB;AAC5F,QAAMC,IAAS,IAAI,gBAAgB,OAAO,SAAS,MAAM;AACzD,MAAI,CAACA,EAAO,IAAIX,CAAG,EAAG,QAAO;AAC7B,EAAAW,EAAO,OAAOX,CAAG;AACjB,QAAMY,IAAQD,EAAO,SAAA;AACrB,gBAAO,QAAQ;AAAA,IACbD;AAAA,IACA;AAAA,IACA,GAAG,OAAO,SAAS,QAAQ,GAAGE,IAAQ,IAAIA,CAAK,KAAK,EAAE,GAAG,OAAO,SAAS,IAAI;AAAA,EAAA,GAExE;AACT;"}

package/dist/useForm-CGbJ44Gp.js

@@ -0,0 +1,194 @@
+import { useState as h, useCallback as l, useSyncExternalStore as A, useRef as $, useMemo as q } from "react";
+import { u as D, r as j } from "./useClearUrlOnUnmount-DOeh6CUN.js";
+function Z(t = !1) {
+  const [s, e] = h(t), n = l(() => e(!0), []), i = l(() => e(!1), []), r = l(() => e((c) => !c), []);
+  return { isOpen: s, open: n, close: i, toggle: r };
+}
+function k() {
+  const [t, s] = h(null), e = l((n) => s(n), []);
+  return {
+    query: t ? t.query : null,
+    state: t,
+    props: (n) => {
+      var i, r;
+      return {
+        manualPagination: !0,
+        data: ((i = n.data) == null ? void 0 : i.items) ?? [],
+        rowCount: ((r = n.data) == null ? void 0 : r.totalCount) ?? 0,
+        loading: !!n.isFetching,
+        onChange: e
+      };
+    }
+  };
+}
+const L = "tz:querymodal", v = "__tzQueryModal", x = Math.random().toString(36).slice(2), U = /* @__PURE__ */ new Set(), z = "1", Y = (t) => typeof window > "u" ? null : new URLSearchParams(window.location.search).get(t), G = (t) => (window.addEventListener("popstate", t), window.addEventListener(L, t), () => {
+  window.removeEventListener("popstate", t), window.removeEventListener(L, t);
+});
+function b(t, s, e) {
+  const n = t.toString(), i = `${window.location.pathname}${n ? `?${n}` : ""}${window.location.hash}`;
+  window.history[s === "push" ? "pushState" : "replaceState"](e, "", i), window.dispatchEvent(new Event(L));
+}
+const B = (t) => `${x}:${t}`, K = (t, s) => t != null && typeof t == "object" && t[v] === B(s), P = (t) => {
+  if (t == null || typeof t != "object" || !(v in t)) return t;
+  const s = { ...t };
+  return delete s[v], s;
+};
+function tt(t, s = {}) {
+  const { push: e = !0, clearUrlOnUnmount: n = !0 } = s, i = A(
+    G,
+    () => Y(t),
+    () => null
+  ), r = l(
+    (a = z) => {
+      if (typeof window > "u") return;
+      const u = new URLSearchParams(window.location.search), f = u.get(t);
+      f !== a && (u.set(t, a), f == null && e ? b(u, "push", {
+        ...window.history.state ?? {},
+        [v]: B(t)
+      }) : b(u, "replace", window.history.state));
+    },
+    [t, e]
+  ), c = l(() => {
+    if (typeof window > "u" || U.has(t)) return;
+    const a = new URLSearchParams(window.location.search);
+    if (a.has(t)) {
+      if (K(window.history.state, t)) {
+        U.add(t);
+        const u = () => {
+          window.removeEventListener("popstate", u), U.delete(t);
+          const f = new URLSearchParams(window.location.search);
+          f.has(t) && (f.delete(t), b(f, "replace", P(window.history.state)));
+        };
+        window.addEventListener("popstate", u), window.history.back();
+        return;
+      }
+      a.delete(t), b(a, "replace", P(window.history.state));
+    }
+  }, [t]);
+  return D(t, n, () => {
+    j(t, P(window.history.state)) && window.dispatchEvent(new Event(L));
+  }), { isOpen: i != null, value: i, open: r, close: c };
+}
+function H(t, s) {
+  let e = null, n = Number.POSITIVE_INFINITY;
+  for (const i of s) {
+    const r = typeof CSS < "u" && CSS.escape ? CSS.escape(i) : i, c = t.querySelector(`[name="${r}"]`);
+    if (!c) continue;
+    const a = c.getBoundingClientRect().top;
+    a < n && (n = a, e = c);
+  }
+  e && (typeof e.scrollIntoView == "function" && e.scrollIntoView({ behavior: "smooth", block: "center" }), e.focus({ preventScroll: !0 }));
+}
+function J(t, s) {
+  const e = t.safeParse(s);
+  if (e.success) return {};
+  const n = {};
+  for (const i of e.error.issues) {
+    const r = String(i.path[0] ?? "_form");
+    r in n || (n[r] = i.message);
+  }
+  return n;
+}
+function et({
+  schema: t,
+  defaultValues: s,
+  onSubmit: e,
+  mode: n = "blurThenLive",
+  scrollToError: i = !0
+}) {
+  const [r, c] = h(s), a = $(s), [u, f] = h({}), [g, R] = h(!1), [C, I] = h(0), [O, V] = h(!1), y = $(!1), m = q(() => J(t, r), [t, r]), _ = Object.keys(m).length === 0, T = l(
+    (o) => n === "change" ? !0 : n === "submit" ? g : g || u[o] === !0,
+    [n, g, u]
+  ), S = l((o, w) => {
+    c((d) => ({ ...d, [o]: w }));
+  }, []), F = l(
+    (o) => {
+      const w = r[o];
+      return {
+        name: o,
+        value: w == null ? "" : String(w),
+        onChange: (d) => S(o, d.target.value),
+        onBlur: () => {
+          f((d) => d[o] ? d : { ...d, [o]: !0 });
+        },
+        error: T(o) && !!m[o],
+        helperText: T(o) ? m[o] : void 0
+      };
+    },
+    [r, m, T, S, n]
+  ), E = l((o) => {
+    c(o ?? a.current), f({}), R(!1), I(0);
+  }, []), M = l(
+    (o) => {
+      if (o == null || o.preventDefault(), y.current) return;
+      R(!0), I((p) => p + 1);
+      const w = t.safeParse(r);
+      if (!w.success) {
+        const p = o == null ? void 0 : o.currentTarget;
+        if (i && p instanceof Element) {
+          const N = w.error.issues.map((Q) => String(Q.path[0] ?? "")).filter(Boolean);
+          H(p, N);
+        }
+        return;
+      }
+      const d = e == null ? void 0 : e(w.data, { reset: E, setValue: S, setValues: c });
+      if (d instanceof Promise) {
+        y.current = !0, V(!0);
+        const p = () => {
+          y.current = !1, V(!1);
+        };
+        d.then(p, p);
+      }
+    },
+    [t, r, e, E, S, i]
+  );
+  return q(
+    () => ({
+      /** Current form values. */
+      values: r,
+      /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */
+      errors: m,
+      /** Which fields have been blurred. */
+      touched: u,
+      /** True when the whole form passes the schema. */
+      isValid: _,
+      /** True once a submit has been attempted. */
+      isSubmitted: g,
+      /** Number of submit attempts (increments on every `handleSubmit`). */
+      submitCount: C,
+      /** True while an async `onSubmit` is in flight. */
+      isSubmitting: O,
+      /** Spread onto a `<TextField />`: wires value/onChange/onBlur and shows the field's error. */
+      field: F,
+      /** Imperatively set one field's value. */
+      setValue: S,
+      /** Replace all values. */
+      setValues: c,
+      /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */
+      reset: E,
+      /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */
+      handleSubmit: M
+    }),
+    [
+      r,
+      m,
+      u,
+      _,
+      g,
+      C,
+      O,
+      F,
+      S,
+      c,
+      E,
+      M
+    ]
+  );
+}
+export {
+  et as a,
+  tt as b,
+  k as c,
+  Z as u
+};
+//# sourceMappingURL=useForm-CGbJ44Gp.js.map

package/dist/useForm-CGbJ44Gp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm-CGbJ44Gp.js","sources":["../src/hooks/useDisclosure.ts","../src/hooks/useTableQuery.ts","../src/hooks/useQueryModal.ts","../src/form/useForm.ts"],"sourcesContent":["import { useCallback, useState } from 'react'\n\nexport interface UseDisclosureReturn {\n  isOpen: boolean\n  open: () => void\n  close: () => void\n  toggle: () => void\n}\n\nexport function useDisclosure(initial = false): UseDisclosureReturn {\n  const [isOpen, setIsOpen] = useState(initial)\n  const open = useCallback(() => setIsOpen(true), [])\n  const close = useCallback(() => setIsOpen(false), [])\n  const toggle = useCallback(() => setIsOpen((v) => !v), [])\n  return { isOpen, open, close, toggle }\n}\n","import { useCallback, useState } from 'react'\nimport type { TableChangeState } from '../components/Table'\n\n/** A page of rows + the total the server counted (after filters, before paging). */\nexport interface TablePage<T> {\n  items: T[]\n  totalCount: number\n}\n\n/**\n * The slice of a data-fetching result a server-driven table needs — matches TanStack Query's\n * `useQuery` result (`data`, `isFetching`), SWR's (`data`, `isValidating` → pass it as `isFetching`), or\n * any hand-rolled state.\n */\nexport interface TableQueryResult<T> {\n  data?: TablePage<T> | null\n  /** A request is in flight (the first load or a refetch). */\n  isFetching?: boolean\n}\n\nexport interface UseTableQueryReturn {\n  /**\n   * The request's query string the table built from its page / size / search / sort / filters (via the\n   * app's `config.table.query` mapping + the table's `queryMapping`) — `null` until the table has reported\n   * its first state. Put it in the query key and gate the request on it: `enabled: query !== null`.\n   */\n  query: string | null\n  /** The full state from the table's last `onChange` (page, size, search, sort, filters, params). */\n  state: TableChangeState | null\n  /**\n   * The server-mode `<Table>` props for a fetch result — spread them on: `manualPagination`, `data`,\n   * `rowCount`, `loading` and `onChange`.\n   */\n  props: <T>(result: TableQueryResult<T>) => {\n    manualPagination: true\n    data: T[]\n    rowCount: number\n    loading: boolean\n    onChange: (state: TableChangeState) => void\n  }\n}\n\n/**\n * Removes the boilerplate from a **server-driven `<Table>`**: it holds the request query string the table\n * builds on every change, and maps a fetch result back onto the table's server-mode props. The fetch stays\n * yours (TanStack Query, SWR, …) — call it at the top level with `query`:\n *\n * ```tsx\n * const table = useTableQuery()\n * const users = useQuery({\n *   queryKey: ['users', table.query],\n *   queryFn: () => api.users(table.query!), // → { items, totalCount }\n *   enabled: table.query !== null, // wait for the table's first state — no unparameterised request\n *   placeholderData: (previous) => previous, // keep the old page on screen while the next loads\n * })\n * <Table {...table.props(users)} columns={columns} searchable getRowId={(u) => u.id} />\n * ```\n *\n * `totalCount` must be the **server's** total (never `items.length`), or the pager shows a single page.\n */\nexport function useTableQuery(): UseTableQueryReturn {\n  const [state, setState] = useState<TableChangeState | null>(null)\n  const onChange = useCallback((next: TableChangeState) => setState(next), [])\n  return {\n    query: state ? state.query : null,\n    state,\n    props: <T>(result: TableQueryResult<T>) => ({\n      manualPagination: true as const,\n      data: result.data?.items ?? [],\n      rowCount: result.data?.totalCount ?? 0,\n      loading: Boolean(result.isFetching),\n      onChange,\n    }),\n  }\n}\n","import { useCallback, useSyncExternalStore } from 'react'\nimport { removeQueryParam, useClearUrlOnUnmount } from './useClearUrlOnUnmount'\n\n/** Fired after every `useQueryModal` URL write, so other instances watching the same key re-read the URL. */\nconst QUERY_EVENT = 'tz:querymodal'\n/** Marker stored in `history.state` on the entry an `open()` pushed — lets `close()` step Back over it. */\nconst STATE_MARKER = '__tzQueryModal'\n\n/**\n * Identifies THIS document's pushes. `history.state` survives a reload, but the entry before a pushed one then\n * belongs to the discarded document — stepping Back into it would be a full page load, so a marker from another\n * document is treated like no marker (close just drops the param).\n */\nconst DOCUMENT_ID = Math.random().toString(36).slice(2)\n/** Keys whose `close()` has stepped Back and is waiting for the popstate — a second close is a no-op. */\nconst closing = new Set<string>()\n\n/** The value an `open()` without an argument writes (`?create=1`). */\nconst FLAG_VALUE = '1'\n\nexport interface UseQueryModalOptions {\n  /**\n   * Push a browser-history entry when the modal opens, so **Back closes it** (instead of leaving the page).\n   * Defaults to `true`; `false` replaces the current entry instead (no history step).\n   */\n  push?: boolean\n  /**\n   * Remove the param when the component using the hook unmounts **on the same page** (the pathname it was\n   * opened on is still showing) — so a modal that goes away with its page section doesn't leave a stale\n   * `?customer=…` behind. After a navigation to another pathname nothing is touched. Defaults to `true`.\n   */\n  clearUrlOnUnmount?: boolean\n}\n\nexport interface UseQueryModalReturn {\n  /** Whether the param is in the URL — pass it as the modal's `open`. */\n  isOpen: boolean\n  /** The param's value (e.g. the record id from `open(id)`), or `null` while closed. `'1'` for `open()`. */\n  value: string | null\n  /** Open: write `?<key>=<value>` (value defaults to `'1'`). Re-opening with another value swaps it in place. */\n  open: (value?: string) => void\n  /** Close: step Back over the entry `open()` pushed, else remove the param (e.g. after a shared link). */\n  close: () => void\n}\n\nconst readParam = (key: string): string | null =>\n  typeof window === 'undefined' ? null : new URLSearchParams(window.location.search).get(key)\n\nconst subscribe = (onChange: () => void) => {\n  window.addEventListener('popstate', onChange)\n  window.addEventListener(QUERY_EVENT, onChange)\n  return () => {\n    window.removeEventListener('popstate', onChange)\n    window.removeEventListener(QUERY_EVENT, onChange)\n  }\n}\n\n/** Write `params` into the current URL (keeping the path + hash), via push or replace, then notify. */\nfunction writeUrl(params: URLSearchParams, mode: 'push' | 'replace', state: unknown) {\n  const query = params.toString()\n  const url = `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`\n  window.history[mode === 'push' ? 'pushState' : 'replaceState'](state, '', url)\n  window.dispatchEvent(new Event(QUERY_EVENT))\n}\n\nconst markerFor = (key: string) => `${DOCUMENT_ID}:${key}`\nconst markedFor = (state: unknown, key: string) =>\n  state != null &&\n  typeof state === 'object' &&\n  (state as Record<string, unknown>)[STATE_MARKER] === markerFor(key)\n\nconst withoutMarker = (state: unknown) => {\n  if (state == null || typeof state !== 'object' || !(STATE_MARKER in state)) return state\n  const rest = { ...(state as Record<string, unknown>) }\n  delete rest[STATE_MARKER]\n  return rest\n}\n\n/**\n * A modal / drawer / dialog whose **open state lives in the URL query** — `?customer=242a…` — so the page can\n * be shared or reloaded, or opened in a new tab, with the modal already open (and showing the right record).\n * Pair it with any overlay: `<Modal open={m.isOpen} onClose={m.close}>…{m.value}</Modal>`. Opening pushes a\n * history entry (Back closes the modal); closing steps back over it, or just removes the param when the modal\n * was opened from a link. Other params (`?tab=…`, a `Table`'s page / size) and the hash are kept; every\n * instance using the same `key` stays in sync. Purely opt-in — a plain `Modal` is unaffected.\n *\n * ```tsx\n * const sheet = useQueryModal('customer')\n * <Button onClick={() => sheet.open(row.id)}>View</Button>\n * <Modal open={sheet.isOpen} onClose={sheet.close} placement=\"right\" title=\"Customer\">\n *   {sheet.value && <CustomerDetails id={sheet.value} />}\n * </Modal>\n * ```\n */\nexport function useQueryModal(\n  key: string,\n  options: UseQueryModalOptions = {},\n): UseQueryModalReturn {\n  const { push = true, clearUrlOnUnmount = true } = options\n  const value = useSyncExternalStore(\n    subscribe,\n    () => readParam(key),\n    () => null,\n  )\n\n  const open = useCallback(\n    (next: string = FLAG_VALUE) => {\n      if (typeof window === 'undefined') return\n      const params = new URLSearchParams(window.location.search)\n      const current = params.get(key)\n      if (current === next) return\n      params.set(key, next)\n      // already open (another record): swap in place; otherwise a new entry (Back closes) unless push=false\n      if (current == null && push) {\n        writeUrl(params, 'push', {\n          ...((window.history.state as object | null) ?? {}),\n          [STATE_MARKER]: markerFor(key),\n        })\n      } else {\n        writeUrl(params, 'replace', window.history.state)\n      }\n    },\n    [key, push],\n  )\n\n  const close = useCallback(() => {\n    if (typeof window === 'undefined' || closing.has(key)) return\n    const params = new URLSearchParams(window.location.search)\n    if (!params.has(key)) return\n    // we pushed this entry (in this document) → step Back over it (the popstate re-reads the URL); else (a\n    // shared link, a reload, push=false) there is nothing of ours to go back to — just drop the param\n    if (markedFor(window.history.state, key)) {\n      // …and if the entry we land on still carries the param (something inside the modal — e.g. its own\n      // Tabs — pushed further entries), drop it there, so Close always closes. `closing` makes a second\n      // close() before the popstate a no-op (it would step Back twice and leave the page).\n      closing.add(key)\n      const settle = () => {\n        window.removeEventListener('popstate', settle)\n        closing.delete(key)\n        const landed = new URLSearchParams(window.location.search)\n        if (!landed.has(key)) return\n        landed.delete(key)\n        writeUrl(landed, 'replace', withoutMarker(window.history.state))\n      }\n      window.addEventListener('popstate', settle)\n      window.history.back()\n      return\n    }\n    params.delete(key)\n    writeUrl(params, 'replace', withoutMarker(window.history.state))\n  }, [key])\n\n  // unmount on the same page → drop the param (the shared rule; deferred so StrictMode keeps a deep link)\n  useClearUrlOnUnmount(key, clearUrlOnUnmount, () => {\n    if (removeQueryParam(key, withoutMarker(window.history.state))) {\n      window.dispatchEvent(new Event(QUERY_EVENT))\n    }\n  })\n\n  return { isOpen: value != null, value, open, close }\n}\n","import {\n  useCallback,\n  useMemo,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type Dispatch,\n  type FocusEvent,\n  type SetStateAction,\n  type SyntheticEvent,\n} from 'react'\nimport type { TypeOf, ZodType } from 'zod'\n\n/**\n * When validation errors start showing for a field:\n * - `blurThenLive` (default) — after the field is blurred (or the form is submitted), then live on every change.\n * - `change` — from the very first keystroke.\n * - `submit` — only after a submit attempt.\n */\nexport type FormValidationMode = 'blurThenLive' | 'change' | 'submit'\n\nexport interface UseFormOptions<S extends ZodType> {\n  /** Zod schema describing the whole form. Field names match the schema's top-level keys. */\n  schema: S\n  /** Initial values — the controlled source of truth for every field. */\n  defaultValues: TypeOf<S>\n  /**\n   * Called with the parsed (schema-validated) values when a submit passes validation. The second\n   * argument carries helpers — e.g. `reset` to clear the form on success: `(values, { reset }) => {…}`.\n   */\n  onSubmit?: (values: TypeOf<S>, helpers: FormHelpers<TypeOf<S>>) => void | Promise<void>\n  /** When errors begin to show per field. Defaults to `blurThenLive`. */\n  mode?: FormValidationMode\n  /**\n   * On a failed submit, smooth-scroll to (and focus) the first invalid field — the one that sits\n   * **highest** on the page. Needs the submit event's form element (works with `<Form>` or any\n   * `<form onSubmit={form.handleSubmit}>`). Defaults to `true`.\n   */\n  scrollToError?: boolean\n}\n\n/** Helpers handed to `onSubmit` (Formik-style), so you can clear or tweak the form on success. */\nexport interface FormHelpers<Values> {\n  /** Reset to `defaultValues` (or the given values), clearing touched/submitted state. */\n  reset: (next?: Values) => void\n  /** Set one field's value. */\n  setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void\n  /** Replace all values. */\n  setValues: Dispatch<SetStateAction<Values>>\n}\n\n/** Props returned by `field(name)` — spread directly onto a `<TextField />`. */\nexport interface FieldProps {\n  name: string\n  value: string\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void\n  error: boolean\n  helperText?: string\n}\n\n/** Everything `useForm` returns — also the value carried by `<Form>`'s context. */\nexport interface FormApi<Values> {\n  /** Current form values. */\n  values: Values\n  /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */\n  errors: Record<string, string>\n  /** Which fields have been blurred. */\n  touched: Record<string, boolean>\n  /** True when the whole form passes the schema. */\n  isValid: boolean\n  /** True once a submit has been attempted. */\n  isSubmitted: boolean\n  /** Number of submit attempts (increments on every `handleSubmit`) — watch it to react to each submit. */\n  submitCount: number\n  /** True while an async `onSubmit` is in flight. */\n  isSubmitting: boolean\n  /** Spread onto a `<TextField />` (or let `<Form>` + a `name` prop wire it for you). */\n  field: (name: keyof Values & string) => FieldProps\n  /** Imperatively set one field's value. */\n  setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void\n  /** Replace all values. */\n  setValues: Dispatch<SetStateAction<Values>>\n  /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */\n  reset: (next?: Values) => void\n  /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */\n  handleSubmit: (event?: SyntheticEvent) => void\n}\n\n/**\n * Smooth-scroll to (and focus) the highest invalid field inside `scope`, matched by its `name`\n * attribute. \"Highest\" = smallest viewport `top`, so it lands on the first red field regardless of\n * DOM vs. visual order. No-op if none of the names resolve to an element.\n */\nfunction scrollToFirstError(scope: Element, names: string[]) {\n  let target: HTMLElement | null = null\n  let top = Number.POSITIVE_INFINITY\n  for (const name of names) {\n    const selector = typeof CSS !== 'undefined' && CSS.escape ? CSS.escape(name) : name\n    const el = scope.querySelector<HTMLElement>(`[name=\"${selector}\"]`)\n    if (!el) continue\n    const elTop = el.getBoundingClientRect().top\n    if (elTop < top) {\n      top = elTop\n      target = el\n    }\n  }\n  if (!target) return\n  if (typeof target.scrollIntoView === 'function') {\n    target.scrollIntoView({ behavior: 'smooth', block: 'center' })\n  }\n  target.focus({ preventScroll: true })\n}\n\n/** Runs the schema and reduces Zod issues to a `{ field: firstMessage }` map. */\nfunction collectErrors(schema: ZodType, values: unknown): Record<string, string> {\n  const result = schema.safeParse(values)\n  if (result.success) return {}\n  const errors: Record<string, string> = {}\n  for (const issue of result.error.issues) {\n    // path-less issues (a root `.refine()` / `.superRefine()`, e.g. password-confirm) land under a\n    // reserved `_form` key so `isValid` reflects them and the message is surfaceable — instead of\n    // being silently dropped (which made the form look valid while submit no-op'd).\n    const key = String(issue.path[0] ?? '_form')\n    if (!(key in errors)) errors[key] = issue.message // keep the first issue per field\n  }\n  return errors\n}\n\n/**\n * A tiny, Zod-powered form helper — the dependency-light alternative to bundling Formik in\n * every app. Give it a schema and initial values; spread `field(name)` onto a `<TextField />`\n * and it wires up `value`/`onChange`/`onBlur` and surfaces the field's validation error as\n * `error` + `helperText`. Validation follows `mode` (default: validate on blur, then live).\n * `handleSubmit` validates the whole form and calls `onSubmit` with the parsed values only when valid.\n */\nexport function useForm<S extends ZodType>({\n  schema,\n  defaultValues,\n  onSubmit,\n  mode = 'blurThenLive',\n  scrollToError = true,\n}: UseFormOptions<S>): FormApi<TypeOf<S>> {\n  type Values = TypeOf<S>\n\n  const [values, setValues] = useState<Values>(defaultValues)\n  // hold the initial values in a first-render ref so `reset`'s identity doesn't churn when the caller\n  // passes an inline `defaultValues` literal (a fresh object every render)\n  const defaultValuesRef = useRef(defaultValues)\n  const [touched, setTouched] = useState<Record<string, boolean>>({})\n  const [submitted, setSubmitted] = useState(false)\n  const [submitCount, setSubmitCount] = useState(0)\n  const [isSubmitting, setIsSubmitting] = useState(false)\n  // synchronous re-entrancy guard — blocks a double-click before the `isSubmitting` re-render lands\n  const submittingRef = useRef(false)\n\n  const errors = useMemo(() => collectErrors(schema, values), [schema, values])\n  const isValid = Object.keys(errors).length === 0\n\n  /** Whether a field's error should currently be visible, per the chosen mode. */\n  const isShown = useCallback(\n    (name: string) => {\n      if (mode === 'change') return true\n      if (mode === 'submit') return submitted\n      return submitted || touched[name] === true // blurThenLive\n    },\n    [mode, submitted, touched],\n  )\n\n  const setValue = useCallback(<K extends keyof Values & string>(name: K, value: Values[K]) => {\n    setValues((prev) => ({ ...prev, [name]: value }))\n  }, [])\n\n  const field = useCallback(\n    (name: keyof Values & string): FieldProps => {\n      const raw = values[name]\n      return {\n        name,\n        value: raw == null ? '' : String(raw),\n        onChange: (event) => setValue(name, event.target.value as Values[typeof name]),\n        onBlur: () => {\n          // always record touched (so `FormApi.touched` is accurate in every mode); when a field's\n          // error becomes *visible* is governed separately by `isShown`/`mode`\n          setTouched((prev) => (prev[name] ? prev : { ...prev, [name]: true }))\n        },\n        error: isShown(name) && Boolean(errors[name]),\n        helperText: isShown(name) ? errors[name] : undefined,\n      }\n    },\n    [values, errors, isShown, setValue, mode],\n  )\n\n  const reset = useCallback((next?: Values) => {\n    setValues(next ?? defaultValuesRef.current)\n    setTouched({})\n    setSubmitted(false)\n    setSubmitCount(0)\n  }, [])\n\n  const handleSubmit = useCallback(\n    (event?: SyntheticEvent) => {\n      event?.preventDefault()\n      if (submittingRef.current) return // ignore re-entrant submits while an async onSubmit is in flight\n      setSubmitted(true)\n      setSubmitCount((c) => c + 1)\n\n      const result = schema.safeParse(values)\n      if (!result.success) {\n        // errors are derived + now shown (submitted); jump to the first red field if we have the form\n        const scope = event?.currentTarget\n        if (scrollToError && scope instanceof Element) {\n          const names = result.error.issues\n            .map((issue) => String(issue.path[0] ?? ''))\n            .filter(Boolean)\n          scrollToFirstError(scope, names)\n        }\n        return\n      }\n\n      const outcome = onSubmit?.(result.data as Values, { reset, setValue, setValues })\n      if (outcome instanceof Promise) {\n        submittingRef.current = true\n        setIsSubmitting(true)\n        const done = () => {\n          submittingRef.current = false\n          setIsSubmitting(false)\n        }\n        // clear on resolve OR reject — `.then(done, done)` also marks the rejection handled\n        // (a bare `.finally` would re-throw into a discarded chain → unhandled promise rejection)\n        outcome.then(done, done)\n      }\n    },\n    [schema, values, onSubmit, reset, setValue, scrollToError],\n  )\n\n  // memoized so `<Form>` (which feeds this straight into context) doesn't re-render every bound field\n  // on each render of the form-owning component — only when a real piece of state/identity changes\n  return useMemo(\n    () => ({\n      /** Current form values. */\n      values,\n      /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */\n      errors,\n      /** Which fields have been blurred. */\n      touched,\n      /** True when the whole form passes the schema. */\n      isValid,\n      /** True once a submit has been attempted. */\n      isSubmitted: submitted,\n      /** Number of submit attempts (increments on every `handleSubmit`). */\n      submitCount,\n      /** True while an async `onSubmit` is in flight. */\n      isSubmitting,\n      /** Spread onto a `<TextField />`: wires value/onChange/onBlur and shows the field's error. */\n      field,\n      /** Imperatively set one field's value. */\n      setValue,\n      /** Replace all values. */\n      setValues,\n      /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */\n      reset,\n      /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */\n      handleSubmit,\n    }),\n    [\n      values,\n      errors,\n      touched,\n      isValid,\n      submitted,\n      submitCount,\n      isSubmitting,\n      field,\n      setValue,\n      setValues,\n      reset,\n      handleSubmit,\n    ],\n  )\n}\n"],"names":["useDisclosure","initial","isOpen","setIsOpen","useState","open","useCallback","close","toggle","v","useTableQuery","state","setState","onChange","next","result","_a","_b","QUERY_EVENT","STATE_MARKER","DOCUMENT_ID","closing","FLAG_VALUE","readParam","key","subscribe","writeUrl","params","mode","query","url","markerFor","markedFor","withoutMarker","rest","useQueryModal","options","push","clearUrlOnUnmount","value","useSyncExternalStore","current","settle","landed","useClearUrlOnUnmount","removeQueryParam","scrollToFirstError","scope","names","target","top","name","selector","el","elTop","collectErrors","schema","values","errors","issue","useForm","defaultValues","onSubmit","scrollToError","setValues","defaultValuesRef","useRef","touched","setTouched","submitted","setSubmitted","submitCount","setSubmitCount","isSubmitting","setIsSubmitting","submittingRef","useMemo","isValid","isShown","setValue","prev","field","raw","event","reset","handleSubmit","c","outcome","done"],"mappings":"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"}

package/dist/useForm-CSw6r1n1.cjs

@@ -0,0 +1,2 @@
+"use strict";const s=require("react"),_=require("./useClearUrlOnUnmount-Cg7v2y5B.cjs");function B(e=!1){const[u,t]=s.useState(e),n=s.useCallback(()=>t(!0),[]),a=s.useCallback(()=>t(!1),[]),r=s.useCallback(()=>t(c=>!c),[]);return{isOpen:u,open:n,close:a,toggle:r}}function D(){const[e,u]=s.useState(null),t=s.useCallback(n=>u(n),[]);return{query:e?e.query:null,state:e,props:n=>{var a,r;return{manualPagination:!0,data:((a=n.data)==null?void 0:a.items)??[],rowCount:((r=n.data)==null?void 0:r.totalCount)??0,loading:!!n.isFetching,onChange:t}}}}const C="tz:querymodal",E="__tzQueryModal",N=Math.random().toString(36).slice(2),L=new Set,A="1",j=e=>typeof window>"u"?null:new URLSearchParams(window.location.search).get(e),k=e=>(window.addEventListener("popstate",e),window.addEventListener(C,e),()=>{window.removeEventListener("popstate",e),window.removeEventListener(C,e)});function g(e,u,t){const n=e.toString(),a=`${window.location.pathname}${n?`?${n}`:""}${window.location.hash}`;window.history[u==="push"?"pushState":"replaceState"](t,"",a),window.dispatchEvent(new Event(C))}const q=e=>`${N}:${e}`,z=(e,u)=>e!=null&&typeof e=="object"&&e[E]===q(u),T=e=>{if(e==null||typeof e!="object"||!(E in e))return e;const u={...e};return delete u[E],u};function Y(e,u={}){const{push:t=!0,clearUrlOnUnmount:n=!0}=u,a=s.useSyncExternalStore(k,()=>j(e),()=>null),r=s.useCallback((l=A)=>{if(typeof window>"u")return;const i=new URLSearchParams(window.location.search),f=i.get(e);f!==l&&(i.set(e,l),f==null&&t?g(i,"push",{...window.history.state??{},[E]:q(e)}):g(i,"replace",window.history.state))},[e,t]),c=s.useCallback(()=>{if(typeof window>"u"||L.has(e))return;const l=new URLSearchParams(window.location.search);if(l.has(e)){if(z(window.history.state,e)){L.add(e);const i=()=>{window.removeEventListener("popstate",i),L.delete(e);const f=new URLSearchParams(window.location.search);f.has(e)&&(f.delete(e),g(f,"replace",T(window.history.state)))};window.addEventListener("popstate",i),window.history.back();return}l.delete(e),g(l,"replace",T(window.history.state))}},[e]);return _.useClearUrlOnUnmount(e,n,()=>{_.removeQueryParam(e,T(window.history.state))&&window.dispatchEvent(new Event(C))}),{isOpen:a!=null,value:a,open:r,close:c}}function x(e,u){let t=null,n=Number.POSITIVE_INFINITY;for(const a of u){const r=typeof CSS<"u"&&CSS.escape?CSS.escape(a):a,c=e.querySelector(`[name="${r}"]`);if(!c)continue;const l=c.getBoundingClientRect().top;l<n&&(n=l,t=c)}t&&(typeof t.scrollIntoView=="function"&&t.scrollIntoView({behavior:"smooth",block:"center"}),t.focus({preventScroll:!0}))}function G(e,u){const t=e.safeParse(u);if(t.success)return{};const n={};for(const a of t.error.issues){const r=String(a.path[0]??"_form");r in n||(n[r]=a.message)}return n}function K({schema:e,defaultValues:u,onSubmit:t,mode:n="blurThenLive",scrollToError:a=!0}){const[r,c]=s.useState(u),l=s.useRef(u),[i,f]=s.useState({}),[b,v]=s.useState(!1),[R,P]=s.useState(0),[I,M]=s.useState(!1),y=s.useRef(!1),h=s.useMemo(()=>G(e,r),[e,r]),O=Object.keys(h).length===0,U=s.useCallback(o=>n==="change"?!0:n==="submit"?b:b||i[o]===!0,[n,b,i]),S=s.useCallback((o,w)=>{c(d=>({...d,[o]:w}))},[]),F=s.useCallback(o=>{const w=r[o];return{name:o,value:w==null?"":String(w),onChange:d=>S(o,d.target.value),onBlur:()=>{f(d=>d[o]?d:{...d,[o]:!0})},error:U(o)&&!!h[o],helperText:U(o)?h[o]:void 0}},[r,h,U,S,n]),m=s.useCallback(o=>{c(o??l.current),f({}),v(!1),P(0)},[]),V=s.useCallback(o=>{if(o==null||o.preventDefault(),y.current)return;v(!0),P(p=>p+1);const w=e.safeParse(r);if(!w.success){const p=o==null?void 0:o.currentTarget;if(a&&p instanceof Element){const Q=w.error.issues.map($=>String($.path[0]??"")).filter(Boolean);x(p,Q)}return}const d=t==null?void 0:t(w.data,{reset:m,setValue:S,setValues:c});if(d instanceof Promise){y.current=!0,M(!0);const p=()=>{y.current=!1,M(!1)};d.then(p,p)}},[e,r,t,m,S,a]);return s.useMemo(()=>({values:r,errors:h,touched:i,isValid:O,isSubmitted:b,submitCount:R,isSubmitting:I,field:F,setValue:S,setValues:c,reset:m,handleSubmit:V}),[r,h,i,O,b,R,I,F,S,c,m,V])}exports.useDisclosure=B;exports.useForm=K;exports.useQueryModal=Y;exports.useTableQuery=D;
+//# sourceMappingURL=useForm-CSw6r1n1.cjs.map

package/dist/useForm-CSw6r1n1.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForm-CSw6r1n1.cjs","sources":["../src/hooks/useDisclosure.ts","../src/hooks/useTableQuery.ts","../src/hooks/useQueryModal.ts","../src/form/useForm.ts"],"sourcesContent":["import { useCallback, useState } from 'react'\n\nexport interface UseDisclosureReturn {\n  isOpen: boolean\n  open: () => void\n  close: () => void\n  toggle: () => void\n}\n\nexport function useDisclosure(initial = false): UseDisclosureReturn {\n  const [isOpen, setIsOpen] = useState(initial)\n  const open = useCallback(() => setIsOpen(true), [])\n  const close = useCallback(() => setIsOpen(false), [])\n  const toggle = useCallback(() => setIsOpen((v) => !v), [])\n  return { isOpen, open, close, toggle }\n}\n","import { useCallback, useState } from 'react'\nimport type { TableChangeState } from '../components/Table'\n\n/** A page of rows + the total the server counted (after filters, before paging). */\nexport interface TablePage<T> {\n  items: T[]\n  totalCount: number\n}\n\n/**\n * The slice of a data-fetching result a server-driven table needs — matches TanStack Query's\n * `useQuery` result (`data`, `isFetching`), SWR's (`data`, `isValidating` → pass it as `isFetching`), or\n * any hand-rolled state.\n */\nexport interface TableQueryResult<T> {\n  data?: TablePage<T> | null\n  /** A request is in flight (the first load or a refetch). */\n  isFetching?: boolean\n}\n\nexport interface UseTableQueryReturn {\n  /**\n   * The request's query string the table built from its page / size / search / sort / filters (via the\n   * app's `config.table.query` mapping + the table's `queryMapping`) — `null` until the table has reported\n   * its first state. Put it in the query key and gate the request on it: `enabled: query !== null`.\n   */\n  query: string | null\n  /** The full state from the table's last `onChange` (page, size, search, sort, filters, params). */\n  state: TableChangeState | null\n  /**\n   * The server-mode `<Table>` props for a fetch result — spread them on: `manualPagination`, `data`,\n   * `rowCount`, `loading` and `onChange`.\n   */\n  props: <T>(result: TableQueryResult<T>) => {\n    manualPagination: true\n    data: T[]\n    rowCount: number\n    loading: boolean\n    onChange: (state: TableChangeState) => void\n  }\n}\n\n/**\n * Removes the boilerplate from a **server-driven `<Table>`**: it holds the request query string the table\n * builds on every change, and maps a fetch result back onto the table's server-mode props. The fetch stays\n * yours (TanStack Query, SWR, …) — call it at the top level with `query`:\n *\n * ```tsx\n * const table = useTableQuery()\n * const users = useQuery({\n *   queryKey: ['users', table.query],\n *   queryFn: () => api.users(table.query!), // → { items, totalCount }\n *   enabled: table.query !== null, // wait for the table's first state — no unparameterised request\n *   placeholderData: (previous) => previous, // keep the old page on screen while the next loads\n * })\n * <Table {...table.props(users)} columns={columns} searchable getRowId={(u) => u.id} />\n * ```\n *\n * `totalCount` must be the **server's** total (never `items.length`), or the pager shows a single page.\n */\nexport function useTableQuery(): UseTableQueryReturn {\n  const [state, setState] = useState<TableChangeState | null>(null)\n  const onChange = useCallback((next: TableChangeState) => setState(next), [])\n  return {\n    query: state ? state.query : null,\n    state,\n    props: <T>(result: TableQueryResult<T>) => ({\n      manualPagination: true as const,\n      data: result.data?.items ?? [],\n      rowCount: result.data?.totalCount ?? 0,\n      loading: Boolean(result.isFetching),\n      onChange,\n    }),\n  }\n}\n","import { useCallback, useSyncExternalStore } from 'react'\nimport { removeQueryParam, useClearUrlOnUnmount } from './useClearUrlOnUnmount'\n\n/** Fired after every `useQueryModal` URL write, so other instances watching the same key re-read the URL. */\nconst QUERY_EVENT = 'tz:querymodal'\n/** Marker stored in `history.state` on the entry an `open()` pushed — lets `close()` step Back over it. */\nconst STATE_MARKER = '__tzQueryModal'\n\n/**\n * Identifies THIS document's pushes. `history.state` survives a reload, but the entry before a pushed one then\n * belongs to the discarded document — stepping Back into it would be a full page load, so a marker from another\n * document is treated like no marker (close just drops the param).\n */\nconst DOCUMENT_ID = Math.random().toString(36).slice(2)\n/** Keys whose `close()` has stepped Back and is waiting for the popstate — a second close is a no-op. */\nconst closing = new Set<string>()\n\n/** The value an `open()` without an argument writes (`?create=1`). */\nconst FLAG_VALUE = '1'\n\nexport interface UseQueryModalOptions {\n  /**\n   * Push a browser-history entry when the modal opens, so **Back closes it** (instead of leaving the page).\n   * Defaults to `true`; `false` replaces the current entry instead (no history step).\n   */\n  push?: boolean\n  /**\n   * Remove the param when the component using the hook unmounts **on the same page** (the pathname it was\n   * opened on is still showing) — so a modal that goes away with its page section doesn't leave a stale\n   * `?customer=…` behind. After a navigation to another pathname nothing is touched. Defaults to `true`.\n   */\n  clearUrlOnUnmount?: boolean\n}\n\nexport interface UseQueryModalReturn {\n  /** Whether the param is in the URL — pass it as the modal's `open`. */\n  isOpen: boolean\n  /** The param's value (e.g. the record id from `open(id)`), or `null` while closed. `'1'` for `open()`. */\n  value: string | null\n  /** Open: write `?<key>=<value>` (value defaults to `'1'`). Re-opening with another value swaps it in place. */\n  open: (value?: string) => void\n  /** Close: step Back over the entry `open()` pushed, else remove the param (e.g. after a shared link). */\n  close: () => void\n}\n\nconst readParam = (key: string): string | null =>\n  typeof window === 'undefined' ? null : new URLSearchParams(window.location.search).get(key)\n\nconst subscribe = (onChange: () => void) => {\n  window.addEventListener('popstate', onChange)\n  window.addEventListener(QUERY_EVENT, onChange)\n  return () => {\n    window.removeEventListener('popstate', onChange)\n    window.removeEventListener(QUERY_EVENT, onChange)\n  }\n}\n\n/** Write `params` into the current URL (keeping the path + hash), via push or replace, then notify. */\nfunction writeUrl(params: URLSearchParams, mode: 'push' | 'replace', state: unknown) {\n  const query = params.toString()\n  const url = `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`\n  window.history[mode === 'push' ? 'pushState' : 'replaceState'](state, '', url)\n  window.dispatchEvent(new Event(QUERY_EVENT))\n}\n\nconst markerFor = (key: string) => `${DOCUMENT_ID}:${key}`\nconst markedFor = (state: unknown, key: string) =>\n  state != null &&\n  typeof state === 'object' &&\n  (state as Record<string, unknown>)[STATE_MARKER] === markerFor(key)\n\nconst withoutMarker = (state: unknown) => {\n  if (state == null || typeof state !== 'object' || !(STATE_MARKER in state)) return state\n  const rest = { ...(state as Record<string, unknown>) }\n  delete rest[STATE_MARKER]\n  return rest\n}\n\n/**\n * A modal / drawer / dialog whose **open state lives in the URL query** — `?customer=242a…` — so the page can\n * be shared or reloaded, or opened in a new tab, with the modal already open (and showing the right record).\n * Pair it with any overlay: `<Modal open={m.isOpen} onClose={m.close}>…{m.value}</Modal>`. Opening pushes a\n * history entry (Back closes the modal); closing steps back over it, or just removes the param when the modal\n * was opened from a link. Other params (`?tab=…`, a `Table`'s page / size) and the hash are kept; every\n * instance using the same `key` stays in sync. Purely opt-in — a plain `Modal` is unaffected.\n *\n * ```tsx\n * const sheet = useQueryModal('customer')\n * <Button onClick={() => sheet.open(row.id)}>View</Button>\n * <Modal open={sheet.isOpen} onClose={sheet.close} placement=\"right\" title=\"Customer\">\n *   {sheet.value && <CustomerDetails id={sheet.value} />}\n * </Modal>\n * ```\n */\nexport function useQueryModal(\n  key: string,\n  options: UseQueryModalOptions = {},\n): UseQueryModalReturn {\n  const { push = true, clearUrlOnUnmount = true } = options\n  const value = useSyncExternalStore(\n    subscribe,\n    () => readParam(key),\n    () => null,\n  )\n\n  const open = useCallback(\n    (next: string = FLAG_VALUE) => {\n      if (typeof window === 'undefined') return\n      const params = new URLSearchParams(window.location.search)\n      const current = params.get(key)\n      if (current === next) return\n      params.set(key, next)\n      // already open (another record): swap in place; otherwise a new entry (Back closes) unless push=false\n      if (current == null && push) {\n        writeUrl(params, 'push', {\n          ...((window.history.state as object | null) ?? {}),\n          [STATE_MARKER]: markerFor(key),\n        })\n      } else {\n        writeUrl(params, 'replace', window.history.state)\n      }\n    },\n    [key, push],\n  )\n\n  const close = useCallback(() => {\n    if (typeof window === 'undefined' || closing.has(key)) return\n    const params = new URLSearchParams(window.location.search)\n    if (!params.has(key)) return\n    // we pushed this entry (in this document) → step Back over it (the popstate re-reads the URL); else (a\n    // shared link, a reload, push=false) there is nothing of ours to go back to — just drop the param\n    if (markedFor(window.history.state, key)) {\n      // …and if the entry we land on still carries the param (something inside the modal — e.g. its own\n      // Tabs — pushed further entries), drop it there, so Close always closes. `closing` makes a second\n      // close() before the popstate a no-op (it would step Back twice and leave the page).\n      closing.add(key)\n      const settle = () => {\n        window.removeEventListener('popstate', settle)\n        closing.delete(key)\n        const landed = new URLSearchParams(window.location.search)\n        if (!landed.has(key)) return\n        landed.delete(key)\n        writeUrl(landed, 'replace', withoutMarker(window.history.state))\n      }\n      window.addEventListener('popstate', settle)\n      window.history.back()\n      return\n    }\n    params.delete(key)\n    writeUrl(params, 'replace', withoutMarker(window.history.state))\n  }, [key])\n\n  // unmount on the same page → drop the param (the shared rule; deferred so StrictMode keeps a deep link)\n  useClearUrlOnUnmount(key, clearUrlOnUnmount, () => {\n    if (removeQueryParam(key, withoutMarker(window.history.state))) {\n      window.dispatchEvent(new Event(QUERY_EVENT))\n    }\n  })\n\n  return { isOpen: value != null, value, open, close }\n}\n","import {\n  useCallback,\n  useMemo,\n  useRef,\n  useState,\n  type ChangeEvent,\n  type Dispatch,\n  type FocusEvent,\n  type SetStateAction,\n  type SyntheticEvent,\n} from 'react'\nimport type { TypeOf, ZodType } from 'zod'\n\n/**\n * When validation errors start showing for a field:\n * - `blurThenLive` (default) — after the field is blurred (or the form is submitted), then live on every change.\n * - `change` — from the very first keystroke.\n * - `submit` — only after a submit attempt.\n */\nexport type FormValidationMode = 'blurThenLive' | 'change' | 'submit'\n\nexport interface UseFormOptions<S extends ZodType> {\n  /** Zod schema describing the whole form. Field names match the schema's top-level keys. */\n  schema: S\n  /** Initial values — the controlled source of truth for every field. */\n  defaultValues: TypeOf<S>\n  /**\n   * Called with the parsed (schema-validated) values when a submit passes validation. The second\n   * argument carries helpers — e.g. `reset` to clear the form on success: `(values, { reset }) => {…}`.\n   */\n  onSubmit?: (values: TypeOf<S>, helpers: FormHelpers<TypeOf<S>>) => void | Promise<void>\n  /** When errors begin to show per field. Defaults to `blurThenLive`. */\n  mode?: FormValidationMode\n  /**\n   * On a failed submit, smooth-scroll to (and focus) the first invalid field — the one that sits\n   * **highest** on the page. Needs the submit event's form element (works with `<Form>` or any\n   * `<form onSubmit={form.handleSubmit}>`). Defaults to `true`.\n   */\n  scrollToError?: boolean\n}\n\n/** Helpers handed to `onSubmit` (Formik-style), so you can clear or tweak the form on success. */\nexport interface FormHelpers<Values> {\n  /** Reset to `defaultValues` (or the given values), clearing touched/submitted state. */\n  reset: (next?: Values) => void\n  /** Set one field's value. */\n  setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void\n  /** Replace all values. */\n  setValues: Dispatch<SetStateAction<Values>>\n}\n\n/** Props returned by `field(name)` — spread directly onto a `<TextField />`. */\nexport interface FieldProps {\n  name: string\n  value: string\n  onChange: (event: ChangeEvent<HTMLInputElement>) => void\n  onBlur: (event: FocusEvent<HTMLInputElement>) => void\n  error: boolean\n  helperText?: string\n}\n\n/** Everything `useForm` returns — also the value carried by `<Form>`'s context. */\nexport interface FormApi<Values> {\n  /** Current form values. */\n  values: Values\n  /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */\n  errors: Record<string, string>\n  /** Which fields have been blurred. */\n  touched: Record<string, boolean>\n  /** True when the whole form passes the schema. */\n  isValid: boolean\n  /** True once a submit has been attempted. */\n  isSubmitted: boolean\n  /** Number of submit attempts (increments on every `handleSubmit`) — watch it to react to each submit. */\n  submitCount: number\n  /** True while an async `onSubmit` is in flight. */\n  isSubmitting: boolean\n  /** Spread onto a `<TextField />` (or let `<Form>` + a `name` prop wire it for you). */\n  field: (name: keyof Values & string) => FieldProps\n  /** Imperatively set one field's value. */\n  setValue: <K extends keyof Values & string>(name: K, value: Values[K]) => void\n  /** Replace all values. */\n  setValues: Dispatch<SetStateAction<Values>>\n  /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */\n  reset: (next?: Values) => void\n  /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */\n  handleSubmit: (event?: SyntheticEvent) => void\n}\n\n/**\n * Smooth-scroll to (and focus) the highest invalid field inside `scope`, matched by its `name`\n * attribute. \"Highest\" = smallest viewport `top`, so it lands on the first red field regardless of\n * DOM vs. visual order. No-op if none of the names resolve to an element.\n */\nfunction scrollToFirstError(scope: Element, names: string[]) {\n  let target: HTMLElement | null = null\n  let top = Number.POSITIVE_INFINITY\n  for (const name of names) {\n    const selector = typeof CSS !== 'undefined' && CSS.escape ? CSS.escape(name) : name\n    const el = scope.querySelector<HTMLElement>(`[name=\"${selector}\"]`)\n    if (!el) continue\n    const elTop = el.getBoundingClientRect().top\n    if (elTop < top) {\n      top = elTop\n      target = el\n    }\n  }\n  if (!target) return\n  if (typeof target.scrollIntoView === 'function') {\n    target.scrollIntoView({ behavior: 'smooth', block: 'center' })\n  }\n  target.focus({ preventScroll: true })\n}\n\n/** Runs the schema and reduces Zod issues to a `{ field: firstMessage }` map. */\nfunction collectErrors(schema: ZodType, values: unknown): Record<string, string> {\n  const result = schema.safeParse(values)\n  if (result.success) return {}\n  const errors: Record<string, string> = {}\n  for (const issue of result.error.issues) {\n    // path-less issues (a root `.refine()` / `.superRefine()`, e.g. password-confirm) land under a\n    // reserved `_form` key so `isValid` reflects them and the message is surfaceable — instead of\n    // being silently dropped (which made the form look valid while submit no-op'd).\n    const key = String(issue.path[0] ?? '_form')\n    if (!(key in errors)) errors[key] = issue.message // keep the first issue per field\n  }\n  return errors\n}\n\n/**\n * A tiny, Zod-powered form helper — the dependency-light alternative to bundling Formik in\n * every app. Give it a schema and initial values; spread `field(name)` onto a `<TextField />`\n * and it wires up `value`/`onChange`/`onBlur` and surfaces the field's validation error as\n * `error` + `helperText`. Validation follows `mode` (default: validate on blur, then live).\n * `handleSubmit` validates the whole form and calls `onSubmit` with the parsed values only when valid.\n */\nexport function useForm<S extends ZodType>({\n  schema,\n  defaultValues,\n  onSubmit,\n  mode = 'blurThenLive',\n  scrollToError = true,\n}: UseFormOptions<S>): FormApi<TypeOf<S>> {\n  type Values = TypeOf<S>\n\n  const [values, setValues] = useState<Values>(defaultValues)\n  // hold the initial values in a first-render ref so `reset`'s identity doesn't churn when the caller\n  // passes an inline `defaultValues` literal (a fresh object every render)\n  const defaultValuesRef = useRef(defaultValues)\n  const [touched, setTouched] = useState<Record<string, boolean>>({})\n  const [submitted, setSubmitted] = useState(false)\n  const [submitCount, setSubmitCount] = useState(0)\n  const [isSubmitting, setIsSubmitting] = useState(false)\n  // synchronous re-entrancy guard — blocks a double-click before the `isSubmitting` re-render lands\n  const submittingRef = useRef(false)\n\n  const errors = useMemo(() => collectErrors(schema, values), [schema, values])\n  const isValid = Object.keys(errors).length === 0\n\n  /** Whether a field's error should currently be visible, per the chosen mode. */\n  const isShown = useCallback(\n    (name: string) => {\n      if (mode === 'change') return true\n      if (mode === 'submit') return submitted\n      return submitted || touched[name] === true // blurThenLive\n    },\n    [mode, submitted, touched],\n  )\n\n  const setValue = useCallback(<K extends keyof Values & string>(name: K, value: Values[K]) => {\n    setValues((prev) => ({ ...prev, [name]: value }))\n  }, [])\n\n  const field = useCallback(\n    (name: keyof Values & string): FieldProps => {\n      const raw = values[name]\n      return {\n        name,\n        value: raw == null ? '' : String(raw),\n        onChange: (event) => setValue(name, event.target.value as Values[typeof name]),\n        onBlur: () => {\n          // always record touched (so `FormApi.touched` is accurate in every mode); when a field's\n          // error becomes *visible* is governed separately by `isShown`/`mode`\n          setTouched((prev) => (prev[name] ? prev : { ...prev, [name]: true }))\n        },\n        error: isShown(name) && Boolean(errors[name]),\n        helperText: isShown(name) ? errors[name] : undefined,\n      }\n    },\n    [values, errors, isShown, setValue, mode],\n  )\n\n  const reset = useCallback((next?: Values) => {\n    setValues(next ?? defaultValuesRef.current)\n    setTouched({})\n    setSubmitted(false)\n    setSubmitCount(0)\n  }, [])\n\n  const handleSubmit = useCallback(\n    (event?: SyntheticEvent) => {\n      event?.preventDefault()\n      if (submittingRef.current) return // ignore re-entrant submits while an async onSubmit is in flight\n      setSubmitted(true)\n      setSubmitCount((c) => c + 1)\n\n      const result = schema.safeParse(values)\n      if (!result.success) {\n        // errors are derived + now shown (submitted); jump to the first red field if we have the form\n        const scope = event?.currentTarget\n        if (scrollToError && scope instanceof Element) {\n          const names = result.error.issues\n            .map((issue) => String(issue.path[0] ?? ''))\n            .filter(Boolean)\n          scrollToFirstError(scope, names)\n        }\n        return\n      }\n\n      const outcome = onSubmit?.(result.data as Values, { reset, setValue, setValues })\n      if (outcome instanceof Promise) {\n        submittingRef.current = true\n        setIsSubmitting(true)\n        const done = () => {\n          submittingRef.current = false\n          setIsSubmitting(false)\n        }\n        // clear on resolve OR reject — `.then(done, done)` also marks the rejection handled\n        // (a bare `.finally` would re-throw into a discarded chain → unhandled promise rejection)\n        outcome.then(done, done)\n      }\n    },\n    [schema, values, onSubmit, reset, setValue, scrollToError],\n  )\n\n  // memoized so `<Form>` (which feeds this straight into context) doesn't re-render every bound field\n  // on each render of the form-owning component — only when a real piece of state/identity changes\n  return useMemo(\n    () => ({\n      /** Current form values. */\n      values,\n      /** `{ field: firstErrorMessage }` for every invalid field (regardless of visibility). */\n      errors,\n      /** Which fields have been blurred. */\n      touched,\n      /** True when the whole form passes the schema. */\n      isValid,\n      /** True once a submit has been attempted. */\n      isSubmitted: submitted,\n      /** Number of submit attempts (increments on every `handleSubmit`). */\n      submitCount,\n      /** True while an async `onSubmit` is in flight. */\n      isSubmitting,\n      /** Spread onto a `<TextField />`: wires value/onChange/onBlur and shows the field's error. */\n      field,\n      /** Imperatively set one field's value. */\n      setValue,\n      /** Replace all values. */\n      setValues,\n      /** Reset to `defaultValues` (or the given values) and clear touched/submitted state. */\n      reset,\n      /** Form `onSubmit` handler — validates, then calls `onSubmit` with parsed values when valid. */\n      handleSubmit,\n    }),\n    [\n      values,\n      errors,\n      touched,\n      isValid,\n      submitted,\n      submitCount,\n      isSubmitting,\n      field,\n      setValue,\n      setValues,\n      reset,\n      handleSubmit,\n    ],\n  )\n}\n"],"names":["useDisclosure","initial","isOpen","setIsOpen","useState","open","useCallback","close","toggle","v","useTableQuery","state","setState","onChange","next","result","_a","_b","QUERY_EVENT","STATE_MARKER","DOCUMENT_ID","closing","FLAG_VALUE","readParam","key","subscribe","writeUrl","params","mode","query","url","markerFor","markedFor","withoutMarker","rest","useQueryModal","options","push","clearUrlOnUnmount","value","useSyncExternalStore","current","settle","landed","useClearUrlOnUnmount","removeQueryParam","scrollToFirstError","scope","names","target","top","name","selector","el","elTop","collectErrors","schema","values","errors","issue","useForm","defaultValues","onSubmit","scrollToError","setValues","defaultValuesRef","useRef","touched","setTouched","submitted","setSubmitted","submitCount","setSubmitCount","isSubmitting","setIsSubmitting","submittingRef","useMemo","isValid","isShown","setValue","prev","field","raw","event","reset","handleSubmit","c","outcome","done"],"mappings":"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"}

package/dist/useOptionMenu-8hjCTNL4.cjs

@@ -0,0 +1,2 @@
+"use strict";const c=require("react/jsx-runtime"),Q=require("clsx"),W=require("./FloatingPanel-tGCG2nhA.cjs"),$=require("./Icon-BUP5_kRs.cjs"),U=require("./List-DOsh6w-d.cjs"),V=require("./ListItem-CUeIBhOF.cjs"),G=require("./Loader-CqRaCdzF.cjs"),C=require("./Typography-B6ASPrzT.cjs"),J=require("./ConfigProvider-CzAQf_d_.cjs"),l=require("react"),X="_popover_rf9kn_3",Y="_search_rf9kn_11",Z="_searchIcon_rf9kn_20",B="_searchInput_rf9kn_24",ee="_listbox_rf9kn_40",te="_active_rf9kn_48",re="_noOptions_rf9kn_52",se="_loading_rf9kn_58",oe="_group_rf9kn_68",ne="_groupLabel_rf9kn_80",ae="_trailing_rf9kn_86",h={popover:X,search:Y,searchIcon:Z,searchInput:B,listbox:ee,active:te,noOptions:re,loading:se,group:oe,groupLabel:ne,trailing:ae};function ie({menu:t,anchorRef:m,size:g,searchPlaceholder:_,loading:O=!1,loadingText:E,noOptionsText:d,showSelectedTick:x=!0,multiselectable:M=!1,labelledBy:j,ariaLabel:N,onSearchKeyDown:R,className:y}){const r=J.useT(),L=_??r("common.search"),{filteredOptions:I,highlightedIndex:q}=t,f=({opt:o,index:p})=>{const n=t.isSelected(o),u=n&&x;return c.jsx(V.ListItem,{id:t.optionId(p),role:"option",tabIndex:-1,"aria-selected":n,"aria-current":void 0,clickable:!0,selected:n,disabled:o.disabled,icon:o.icon,className:Q.clsx(p===q&&h.active),trailing:o.trailing!=null||u?c.jsxs("span",{className:h.trailing,children:[o.trailing,u&&c.jsx($.Icon,{name:"TickCircle",size:"sm"})]}):void 0,onMouseEnter:()=>!o.disabled&&t.setHighlightedIndex(p),onMouseDown:a=>a.preventDefault(),onClick:()=>t.pick(o),children:o.label},o.value)},b=o=>{if(!o.some(n=>n.opt.group!=null))return o.map(f);const p=[];for(const n of o){const u=p[p.length-1];u&&u.group===n.opt.group?u.rows.push(n):p.push({group:n.opt.group,rows:[n]})}return p.map((n,u)=>{if(n.group==null)return n.rows.map(f);const a=`${t.listboxId}-group-${u}`;return c.jsxs("div",{role:"group","aria-labelledby":a,className:h.group,children:[c.jsx(C.Typography,{as:"div",id:a,role:"presentation",variant:"caption",color:"muted",uppercase:!0,className:h.groupLabel,children:n.group}),n.rows.map(f)]},`group-${u}`)})};return c.jsxs(W.FloatingPanel,{ref:t.popoverRef,open:t.open,triggerRef:m,onClose:t.closeMenu,matchTriggerWidth:!0,className:Q.clsx(h.popover,y),children:[t.searchable&&c.jsxs("div",{className:h.search,children:[c.jsx($.Icon,{name:"SearchNormal",size:"sm",className:h.searchIcon,"aria-hidden":"true"}),c.jsx("input",{ref:t.searchInputRef,className:h.searchInput,type:"text",role:"combobox","aria-expanded":"true","aria-controls":t.listboxId,"aria-activedescendant":t.activeId,"aria-autocomplete":"list","aria-label":L,placeholder:L,value:t.searchQuery,spellCheck:!1,autoComplete:"off",onChange:o=>t.setSearchQuery(o.target.value),onKeyDown:R??t.handleKeyDown})]}),c.jsx(U.List,{role:"listbox",id:t.listboxId,"aria-labelledby":j,"aria-label":j?void 0:N,"aria-multiselectable":M||void 0,size:g,className:h.listbox,onMouseLeave:()=>t.setHighlightedIndex(-1),children:O?c.jsxs("div",{className:h.loading,children:[c.jsx(G.Loader,{size:"sm"}),c.jsx(C.Typography,{as:"span",variant:"bodySmall",color:"muted",children:E??r("common.loading")})]}):I.length===0?c.jsx("div",{className:h.noOptions,children:c.jsx(C.Typography,{as:"span",variant:"bodySmall",color:"muted",children:d==null?r("select.noOptions"):typeof d=="function"?d(t.searchQuery):d})}):b(I.map((o,p)=>({opt:o,index:p})))})]})}function ce(t){if(!t.some(g=>g.group!=null))return t;const m=new Map;for(const g of t){const _=m.get(g.group);_?_.push(g):m.set(g.group,[g])}return[...m.values()].flat()}function le({idBase:t,options:m,isSelected:g,onPick:_,closeOnPick:O=!0,highlightSelected:E=!0,searchable:d=!1,onSearchChange:x,disabled:M=!1,focusRef:j,onClose:N}){const R=`${t}-listbox`,y=l.useCallback(e=>`${t}-opt-${e}`,[t]),[r,L]=l.useState(!1),[I,q]=l.useState(""),[f,b]=l.useState(-1),o=l.useRef(null),p=l.useRef(null),n=l.useRef({buffer:"",timer:0}),u=l.useRef(N);u.current=N;const a=l.useMemo(()=>{const e=I.trim().toLowerCase(),s=!d||x||!e?m:m.filter(i=>{var k;return i.label.toLowerCase().includes(e)||((k=i.keywords)==null?void 0:k.some(F=>F.toLowerCase().includes(e)))});return ce(s)},[d,x,I,m]),v=l.useCallback((e,s)=>{let i=e;for(;i>=0&&i<a.length;){if(!a[i].disabled)return i;i+=s}return-1},[a]),D=l.useCallback(e=>{var s,i;L(!1),q(""),window.clearTimeout(n.current.timer),n.current.buffer="",(s=u.current)==null||s.call(u),e&&((i=j.current)==null||i.focus())},[j]);l.useEffect(()=>{if(!r)return;const e=E?a.findIndex(g):-1;b(e>=0&&!a[e].disabled?e:v(0,1)),d&&requestAnimationFrame(()=>{var s;return(s=o.current)==null?void 0:s.focus()})},[r]),l.useEffect(()=>{var e,s;!r||f<0||(s=(e=document.getElementById(y(f)))==null?void 0:e.scrollIntoView)==null||s.call(e,{block:"nearest"})},[r,f,y]),l.useEffect(()=>{r&&d&&b(v(0,1))},[I]),l.useEffect(()=>{r&&b(e=>e<a.length?e:v(0,1))},[a.length]);const w=()=>{M||L(!0)},H=()=>r?D(!1):w(),P=e=>{q(e),x==null||x(e)},T=e=>{!e||e.disabled||(_(e),O&&D(!0))},K=e=>{b(s=>{const i=s<0?e>0?0:a.length-1:s+e,k=v(i,e);return k===-1?s:k})},S=e=>{const s=n.current;window.clearTimeout(s.timer),s.buffer+=e.toLowerCase(),s.timer=window.setTimeout(()=>s.buffer="",500);const i=a.findIndex(k=>!k.disabled&&k.label.toLowerCase().startsWith(s.buffer));i>=0&&b(i)},z=e=>{if(!M)switch(e.key){case"ArrowDown":e.preventDefault(),r?K(1):w();break;case"ArrowUp":e.preventDefault(),r?K(-1):w();break;case"Enter":e.preventDefault(),r?T(a[f]):w();break;case" ":r?d||(e.preventDefault(),T(a[f])):(e.preventDefault(),w());break;case"Escape":r&&(e.preventDefault(),e.stopPropagation(),D(!0));break;case"Tab":r&&D(!0);break;case"Home":r&&(e.preventDefault(),b(v(0,1)));break;case"End":r&&(e.preventDefault(),b(v(a.length-1,-1)));break;default:!d&&r&&e.key.length===1&&!e.metaKey&&!e.ctrlKey&&!e.altKey&&S(e.key)}},A=r&&f>=0?y(f):void 0;return{open:r,openMenu:w,closeMenu:D,toggleMenu:H,searchable:d,searchQuery:I,setSearchQuery:P,filteredOptions:a,highlightedIndex:f,setHighlightedIndex:b,isSelected:g,pick:T,handleKeyDown:z,listboxId:R,optionId:y,activeId:A,searchInputRef:o,popoverRef:p}}exports.OptionMenu=ie;exports.useOptionMenu=le;
+//# sourceMappingURL=useOptionMenu-8hjCTNL4.cjs.map