@acronis-platform/ui-react 3.0.0 → 4.1.0

package/dist/hooks/use-table-url-state.js

@@ -1,115 +1,106 @@
-import * as u from "react";
-const y = {
-  page: "tbl_page",
-  size: "tbl_size",
-  sort: "tbl_sort",
-  filter: "tbl_filter"
+import * as e from "react";
+//#region src/hooks/use-table-url-state.ts
+var t = {
+	page: "tbl_page",
+	size: "tbl_size",
+	sort: "tbl_sort",
+	filter: "tbl_filter"
 };
-function b(e, r) {
-  return typeof e == "function" ? e(r) : e;
+function n(e, t) {
+	return typeof e == "function" ? e(t) : e;
 }
-function z(e, {
-  defaultPageSize: r = 10,
-  paramKeys: i
-} = {}) {
-  const a = i ?? y, o = new URLSearchParams(e), t = Number(o.get(a.page)), s = Number.isFinite(t) && t >= 1 ? Math.floor(t) - 1 : 0, c = Number(o.get(a.size)), S = Number.isFinite(c) && c >= 1 ? Math.floor(c) : r, g = o.get(a.sort), m = /* @__PURE__ */ new Map();
-  if (g)
-    for (const l of g.split(",")) {
-      const f = l.indexOf(":");
-      if (f === -1) continue;
-      const p = l.slice(0, f), h = l.slice(f + 1);
-      !p || h !== "asc" && h !== "desc" || m.set(p, { id: p, desc: h === "desc" });
-    }
-  const n = Array.from(m.values()), d = o.get(a.filter), w = d ? d.split(",").map((l) => {
-    const f = l.indexOf(":");
-    if (f === -1) return null;
-    const p = l.slice(0, f);
-    if (!p) return null;
-    try {
-      return { id: p, value: decodeURIComponent(l.slice(f + 1)) };
-    } catch {
-      return null;
-    }
-  }).filter((l) => l !== null) : [];
-  return { pagination: { pageIndex: s, pageSize: S }, sorting: n, columnFilters: w };
+function r(e, { defaultPageSize: n = 10, paramKeys: r } = {}) {
+	let i = r ?? t, a = new URLSearchParams(e), o = Number(a.get(i.page)), s = Number.isFinite(o) && o >= 1 ? Math.floor(o) - 1 : 0, c = Number(a.get(i.size)), l = Number.isFinite(c) && c >= 1 ? Math.floor(c) : n, u = a.get(i.sort), d = /* @__PURE__ */ new Map();
+	if (u) for (let e of u.split(",")) {
+		let t = e.indexOf(":");
+		if (t === -1) continue;
+		let n = e.slice(0, t), r = e.slice(t + 1);
+		!n || r !== "asc" && r !== "desc" || d.set(n, {
+			id: n,
+			desc: r === "desc"
+		});
+	}
+	let f = Array.from(d.values()), p = a.get(i.filter), m = p ? p.split(",").map((e) => {
+		let t = e.indexOf(":");
+		if (t === -1) return null;
+		let n = e.slice(0, t);
+		if (!n) return null;
+		try {
+			return {
+				id: n,
+				value: decodeURIComponent(e.slice(t + 1))
+			};
+		} catch {
+			return null;
+		}
+	}).filter((e) => e !== null) : [];
+	return {
+		pagination: {
+			pageIndex: s,
+			pageSize: l
+		},
+		sorting: f,
+		columnFilters: m
+	};
 }
-function P(e, r, {
-  defaultPageSize: i = 10,
-  paramKeys: a
-} = {}) {
-  const o = a ?? y, t = new URLSearchParams(r);
-  for (const s of Object.values(o)) t.delete(s);
-  return e.pagination.pageIndex > 0 && t.set(o.page, String(e.pagination.pageIndex + 1)), e.pagination.pageSize !== i && t.set(o.size, String(e.pagination.pageSize)), e.sorting.length > 0 && t.set(
-    o.sort,
-    e.sorting.map((s) => `${s.id}:${s.desc ? "desc" : "asc"}`).join(",")
-  ), e.columnFilters.length > 0 && t.set(
-    o.filter,
-    e.columnFilters.map((s) => `${s.id}:${encodeURIComponent(s.value)}`).join(",")
-  ), t.toString();
+function i(e, n, { defaultPageSize: r = 10, paramKeys: i } = {}) {
+	let a = i ?? t, o = new URLSearchParams(n);
+	for (let e of Object.values(a)) o.delete(e);
+	return e.pagination.pageIndex > 0 && o.set(a.page, String(e.pagination.pageIndex + 1)), e.pagination.pageSize !== r && o.set(a.size, String(e.pagination.pageSize)), e.sorting.length > 0 && o.set(a.sort, e.sorting.map((e) => `${e.id}:${e.desc ? "desc" : "asc"}`).join(",")), e.columnFilters.length > 0 && o.set(a.filter, e.columnFilters.map((e) => `${e.id}:${encodeURIComponent(e.value)}`).join(",")), o.toString();
 }
-function R(e, r) {
-  const i = typeof window < "u" ? window.location.search : "";
-  return z(i, { defaultPageSize: e, paramKeys: r });
+function a(e, t) {
+	return r(typeof window < "u" ? window.location.search : "", {
+		defaultPageSize: e,
+		paramKeys: t
+	});
 }
-function U(e = {}) {
-  const { defaultPageSize: r = 10 } = e, i = u.useMemo(
-    () => ({ ...y, ...e.paramKeys }),
-    [e.paramKeys]
-  ), [a, o] = u.useState(
-    () => R(r, i)
-  ), t = u.useRef(a);
-  t.current = a;
-  const s = u.useRef(!1);
-  u.useEffect(() => {
-    if (typeof window > "u") return;
-    const n = () => {
-      o(R(r, i));
-    };
-    return window.addEventListener("popstate", n), () => window.removeEventListener("popstate", n);
-  }, [r, i]);
-  const c = u.useCallback(
-    (n) => {
-      if (t.current = n, o(n), typeof window > "u") return;
-      const d = P(n, window.location.search, {
-        defaultPageSize: r,
-        paramKeys: i
-      }), w = `${window.location.pathname}${d ? `?${d}` : ""}${window.location.hash}`;
-      s.current ? window.history.replaceState(null, "", w) : (window.history.pushState(null, "", w), s.current = !0, queueMicrotask(() => {
-        s.current = !1;
-      }));
-    },
-    [r, i]
-  ), S = u.useCallback(
-    (n) => {
-      c({
-        ...t.current,
-        pagination: b(n, t.current.pagination)
-      });
-    },
-    [c]
-  ), g = u.useCallback(
-    (n) => {
-      c({
-        ...t.current,
-        sorting: b(n, t.current.sorting)
-      });
-    },
-    [c]
-  ), m = u.useCallback(
-    (n) => {
-      c({
-        ...t.current,
-        columnFilters: b(n, t.current.columnFilters)
-      });
-    },
-    [c]
-  );
-  return { state: a, setPagination: S, setSorting: g, setColumnFilters: m };
+function o(r = {}) {
+	let { defaultPageSize: o = 10 } = r, s = e.useMemo(() => ({
+		...t,
+		...r.paramKeys
+	}), [r.paramKeys]), [c, l] = e.useState(() => a(o, s)), u = e.useRef(c);
+	u.current = c;
+	let d = e.useRef(!1);
+	e.useEffect(() => {
+		if (typeof window > "u") return;
+		let e = () => {
+			l(a(o, s));
+		};
+		return window.addEventListener("popstate", e), () => window.removeEventListener("popstate", e);
+	}, [o, s]);
+	let f = e.useCallback((e) => {
+		if (u.current = e, l(e), typeof window > "u") return;
+		let t = i(e, window.location.search, {
+			defaultPageSize: o,
+			paramKeys: s
+		}), n = `${window.location.pathname}${t ? `?${t}` : ""}${window.location.hash}`;
+		d.current ? window.history.replaceState(null, "", n) : (window.history.pushState(null, "", n), d.current = !0, queueMicrotask(() => {
+			d.current = !1;
+		}));
+	}, [o, s]);
+	return {
+		state: c,
+		setPagination: e.useCallback((e) => {
+			f({
+				...u.current,
+				pagination: n(e, u.current.pagination)
+			});
+		}, [f]),
+		setSorting: e.useCallback((e) => {
+			f({
+				...u.current,
+				sorting: n(e, u.current.sorting)
+			});
+		}, [f]),
+		setColumnFilters: e.useCallback((e) => {
+			f({
+				...u.current,
+				columnFilters: n(e, u.current.columnFilters)
+			});
+		}, [f])
+	};
 }
-export {
-  y as DEFAULT_TABLE_URL_PARAM_KEYS,
-  z as parseTableUrlState,
-  P as serializeTableUrlState,
-  U as useTableUrlState
-};
-//# sourceMappingURL=use-table-url-state.js.map
+//#endregion
+export { t as DEFAULT_TABLE_URL_PARAM_KEYS, r as parseTableUrlState, i as serializeTableUrlState, o as useTableUrlState };
+
+//# sourceMappingURL=use-table-url-state.js.map

package/dist/hooks/use-table-url-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-table-url-state.js","sources":["../../src/hooks/use-table-url-state.ts"],"sourcesContent":["import * as React from 'react';\n\nexport interface TablePaginationState {\n  /** Zero-based page index. */\n  pageIndex: number;\n  /** Rows per page. */\n  pageSize: number;\n}\n\nexport interface TableSortingState {\n  /** Column id. */\n  id: string;\n  /** `true` for descending. */\n  desc: boolean;\n}\n\nexport interface TableColumnFilterState {\n  /** Column id. */\n  id: string;\n  /** Filter value (string-encoded in the URL). */\n  value: string;\n}\n\n/**\n * Controlled table state. The three fields mirror TanStack's `PaginationState`,\n * `SortingState`, and `ColumnFiltersState` shapes (filter value narrowed to\n * `string`) so they can wire straight into `onPaginationChange` /\n * `onSortingChange` / `onColumnFiltersChange`.\n */\nexport interface TableUrlState {\n  pagination: TablePaginationState;\n  sorting: TableSortingState[];\n  columnFilters: TableColumnFilterState[];\n}\n\n/** Query-string keys. Namespaced (`tbl_*`) to avoid collisions with Storybook's\n * own `path`/`args`/`globals` params on a shared preview-iframe URL. */\nexport interface TableUrlParamKeys {\n  page: string;\n  size: string;\n  sort: string;\n  filter: string;\n}\n\nexport const DEFAULT_TABLE_URL_PARAM_KEYS: TableUrlParamKeys = {\n  page: 'tbl_page',\n  size: 'tbl_size',\n  sort: 'tbl_sort',\n  filter: 'tbl_filter',\n};\n\nexport interface UseTableUrlStateOptions {\n  /** Default page size; omitted from the URL when the size matches it. */\n  defaultPageSize?: number;\n  /** Override the namespaced query-string keys. */\n  paramKeys?: Partial<TableUrlParamKeys>;\n}\n\nexport type TableUrlUpdater<T> = T | ((old: T) => T);\n\nexport interface UseTableUrlStateResult {\n  state: TableUrlState;\n  /** Accepts a value or updater — shaped for TanStack's `onPaginationChange`. */\n  setPagination: (updater: TableUrlUpdater<TablePaginationState>) => void;\n  /** Accepts a value or updater — shaped for TanStack's `onSortingChange`. */\n  setSorting: (updater: TableUrlUpdater<TableSortingState[]>) => void;\n  /** Accepts a value or updater — shaped for TanStack's `onColumnFiltersChange`. */\n  setColumnFilters: (\n    updater: TableUrlUpdater<TableColumnFilterState[]>\n  ) => void;\n}\n\nfunction applyUpdater<T>(updater: TableUrlUpdater<T>, old: T): T {\n  return typeof updater === 'function'\n    ? (updater as (old: T) => T)(old)\n    : updater;\n}\n\n/**\n * Parses table state out of a query string. Pure — safe to reuse for seeding a\n * story or an SSR default. `search` may include or omit the leading `?`.\n *\n * Encoding: `tbl_page` is 1-based; `tbl_sort` is `id:asc|desc` pairs joined by\n * `,`; `tbl_filter` is `id:<encoded-value>` pairs joined by `,` (the value is\n * `encodeURIComponent`-escaped so it may contain `:`/`,`). Column ids must not\n * contain `:` or `,`.\n */\nexport function parseTableUrlState(\n  search: string,\n  {\n    defaultPageSize = 10,\n    paramKeys,\n  }: { defaultPageSize?: number; paramKeys?: TableUrlParamKeys } = {}\n): TableUrlState {\n  const keys = paramKeys ?? DEFAULT_TABLE_URL_PARAM_KEYS;\n  const params = new URLSearchParams(search);\n\n  const rawPage = Number(params.get(keys.page));\n  const pageIndex =\n    Number.isFinite(rawPage) && rawPage >= 1 ? Math.floor(rawPage) - 1 : 0;\n\n  const rawSize = Number(params.get(keys.size));\n  const pageSize =\n    Number.isFinite(rawSize) && rawSize >= 1 ? Math.floor(rawSize) : defaultPageSize;\n\n  const sortParam = params.get(keys.sort);\n  const sortingById = new Map<string, TableSortingState>();\n  if (sortParam) {\n    for (const pair of sortParam.split(',')) {\n      const separator = pair.indexOf(':');\n      if (separator === -1) continue;\n      const id = pair.slice(0, separator);\n      const dir = pair.slice(separator + 1);\n      if (!id || (dir !== 'asc' && dir !== 'desc')) continue;\n      // Last occurrence wins on a duplicate id — matches URLSearchParams'\n      // own semantics for a repeated key.\n      sortingById.set(id, { id, desc: dir === 'desc' });\n    }\n  }\n  const sorting: TableSortingState[] = Array.from(sortingById.values());\n\n  const filterParam = params.get(keys.filter);\n  const columnFilters: TableColumnFilterState[] = filterParam\n    ? filterParam\n        .split(',')\n        .map((pair) => {\n          const separator = pair.indexOf(':');\n          if (separator === -1) return null;\n          const id = pair.slice(0, separator);\n          if (!id) return null;\n          try {\n            return { id, value: decodeURIComponent(pair.slice(separator + 1)) };\n          } catch {\n            return null;\n          }\n        })\n        .filter((entry): entry is TableColumnFilterState => entry !== null)\n    : [];\n\n  return { pagination: { pageIndex, pageSize }, sorting, columnFilters };\n}\n\n/**\n * Serializes table state onto a query string, preserving any foreign params\n * already present in `search` (e.g. Storybook's `path`/`args`/`globals`).\n * Returns the query string without a leading `?` (empty string when no params).\n */\nexport function serializeTableUrlState(\n  state: TableUrlState,\n  search: string,\n  {\n    defaultPageSize = 10,\n    paramKeys,\n  }: { defaultPageSize?: number; paramKeys?: TableUrlParamKeys } = {}\n): string {\n  const keys = paramKeys ?? DEFAULT_TABLE_URL_PARAM_KEYS;\n  const params = new URLSearchParams(search);\n\n  // Clear our namespaced keys before rewriting so a cleared field drops out.\n  for (const key of Object.values(keys)) params.delete(key);\n\n  if (state.pagination.pageIndex > 0) {\n    params.set(keys.page, String(state.pagination.pageIndex + 1));\n  }\n  if (state.pagination.pageSize !== defaultPageSize) {\n    params.set(keys.size, String(state.pagination.pageSize));\n  }\n  if (state.sorting.length > 0) {\n    params.set(\n      keys.sort,\n      state.sorting\n        .map((entry) => `${entry.id}:${entry.desc ? 'desc' : 'asc'}`)\n        .join(',')\n    );\n  }\n  if (state.columnFilters.length > 0) {\n    params.set(\n      keys.filter,\n      state.columnFilters\n        .map((entry) => `${entry.id}:${encodeURIComponent(entry.value)}`)\n        .join(',')\n    );\n  }\n\n  return params.toString();\n}\n\nfunction readCurrentState(\n  defaultPageSize: number,\n  paramKeys: TableUrlParamKeys\n): TableUrlState {\n  const search = typeof window !== 'undefined' ? window.location.search : '';\n  return parseTableUrlState(search, { defaultPageSize, paramKeys });\n}\n\n/**\n * Router-agnostic hook that syncs controlled table state (pagination / sorting\n * / column filters) to and from the URL query string via `history.pushState` +\n * `popstate`. Depends only on `window.location` / `window.history`, so it works\n * with any router (or none). Query keys are namespaced (`tbl_*`) so they never\n * collide with other params on the same URL. Reads initial state from the URL,\n * so a bookmarked link restores the table's view.\n */\nexport function useTableUrlState(\n  options: UseTableUrlStateOptions = {}\n): UseTableUrlStateResult {\n  const { defaultPageSize = 10 } = options;\n  const paramKeys = React.useMemo<TableUrlParamKeys>(\n    () => ({ ...DEFAULT_TABLE_URL_PARAM_KEYS, ...options.paramKeys }),\n    [options.paramKeys]\n  );\n\n  const [state, setState] = React.useState<TableUrlState>(() =>\n    readCurrentState(defaultPageSize, paramKeys)\n  );\n\n  // Keep a ref of the latest state so `popstate` and the setters can compute\n  // the next URL/state without re-subscribing on every change.\n  const stateRef = React.useRef(state);\n  stateRef.current = state;\n\n  // Coalesce multiple setters called synchronously in the same handler (e.g. a\n  // filter change that also resets the page) into a single history entry: the\n  // first commit in a tick pushes, later ones in the same tick replace. The\n  // flag clears on a microtask so the next distinct user action pushes again.\n  const hasPushedThisTickRef = React.useRef(false);\n\n  React.useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const onPopState = () => {\n      setState(readCurrentState(defaultPageSize, paramKeys));\n    };\n    window.addEventListener('popstate', onPopState);\n    return () => window.removeEventListener('popstate', onPopState);\n  }, [defaultPageSize, paramKeys]);\n\n  const commit = React.useCallback(\n    (next: TableUrlState) => {\n      // Refresh the ref here, not just in the render body — two setters\n      // called synchronously in the same handler (before React re-renders)\n      // must see each other's updates, not the pre-batch snapshot.\n      stateRef.current = next;\n      setState(next);\n      if (typeof window === 'undefined') return;\n      const query = serializeTableUrlState(next, window.location.search, {\n        defaultPageSize,\n        paramKeys,\n      });\n      const url = `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`;\n      if (hasPushedThisTickRef.current) {\n        window.history.replaceState(null, '', url);\n      } else {\n        window.history.pushState(null, '', url);\n        hasPushedThisTickRef.current = true;\n        queueMicrotask(() => {\n          hasPushedThisTickRef.current = false;\n        });\n      }\n    },\n    [defaultPageSize, paramKeys]\n  );\n\n  const setPagination = React.useCallback(\n    (updater: TableUrlUpdater<TablePaginationState>) => {\n      commit({\n        ...stateRef.current,\n        pagination: applyUpdater(updater, stateRef.current.pagination),\n      });\n    },\n    [commit]\n  );\n\n  const setSorting = React.useCallback(\n    (updater: TableUrlUpdater<TableSortingState[]>) => {\n      commit({\n        ...stateRef.current,\n        sorting: applyUpdater(updater, stateRef.current.sorting),\n      });\n    },\n    [commit]\n  );\n\n  const setColumnFilters = React.useCallback(\n    (updater: TableUrlUpdater<TableColumnFilterState[]>) => {\n      commit({\n        ...stateRef.current,\n        columnFilters: applyUpdater(updater, stateRef.current.columnFilters),\n      });\n    },\n    [commit]\n  );\n\n  return { state, setPagination, setSorting, setColumnFilters };\n}\n"],"names":["DEFAULT_TABLE_URL_PARAM_KEYS","applyUpdater","updater","old","parseTableUrlState","search","defaultPageSize","paramKeys","keys","params","rawPage","pageIndex","rawSize","pageSize","sortParam","sortingById","pair","separator","id","dir","sorting","filterParam","columnFilters","entry","serializeTableUrlState","state","key","readCurrentState","useTableUrlState","options","React","setState","stateRef","hasPushedThisTickRef","onPopState","commit","next","query","url","setPagination","setSorting","setColumnFilters"],"mappings":";AA4CO,MAAMA,IAAkD;AAAA,EAC7D,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AACV;AAuBA,SAASC,EAAgBC,GAA6BC,GAAW;AAC/D,SAAO,OAAOD,KAAY,aACrBA,EAA0BC,CAAG,IAC9BD;AACN;AAWO,SAASE,EACdC,GACA;AAAA,EACE,iBAAAC,IAAkB;AAAA,EAClB,WAAAC;AACF,IAAiE,IAClD;AACf,QAAMC,IAAOD,KAAaP,GACpBS,IAAS,IAAI,gBAAgBJ,CAAM,GAEnCK,IAAU,OAAOD,EAAO,IAAID,EAAK,IAAI,CAAC,GACtCG,IACJ,OAAO,SAASD,CAAO,KAAKA,KAAW,IAAI,KAAK,MAAMA,CAAO,IAAI,IAAI,GAEjEE,IAAU,OAAOH,EAAO,IAAID,EAAK,IAAI,CAAC,GACtCK,IACJ,OAAO,SAASD,CAAO,KAAKA,KAAW,IAAI,KAAK,MAAMA,CAAO,IAAIN,GAE7DQ,IAAYL,EAAO,IAAID,EAAK,IAAI,GAChCO,wBAAkB,IAAA;AACxB,MAAID;AACF,eAAWE,KAAQF,EAAU,MAAM,GAAG,GAAG;AACvC,YAAMG,IAAYD,EAAK,QAAQ,GAAG;AAClC,UAAIC,MAAc,GAAI;AACtB,YAAMC,IAAKF,EAAK,MAAM,GAAGC,CAAS,GAC5BE,IAAMH,EAAK,MAAMC,IAAY,CAAC;AACpC,MAAI,CAACC,KAAOC,MAAQ,SAASA,MAAQ,UAGrCJ,EAAY,IAAIG,GAAI,EAAE,IAAAA,GAAI,MAAMC,MAAQ,QAAQ;AAAA,IAClD;AAEF,QAAMC,IAA+B,MAAM,KAAKL,EAAY,QAAQ,GAE9DM,IAAcZ,EAAO,IAAID,EAAK,MAAM,GACpCc,IAA0CD,IAC5CA,EACG,MAAM,GAAG,EACT,IAAI,CAACL,MAAS;AACb,UAAMC,IAAYD,EAAK,QAAQ,GAAG;AAClC,QAAIC,MAAc,GAAI,QAAO;AAC7B,UAAMC,IAAKF,EAAK,MAAM,GAAGC,CAAS;AAClC,QAAI,CAACC,EAAI,QAAO;AAChB,QAAI;AACF,aAAO,EAAE,IAAAA,GAAI,OAAO,mBAAmBF,EAAK,MAAMC,IAAY,CAAC,CAAC,EAAA;AAAA,IAClE,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,CAAC,EACA,OAAO,CAACM,MAA2CA,MAAU,IAAI,IACpE,CAAA;AAEJ,SAAO,EAAE,YAAY,EAAE,WAAAZ,GAAW,UAAAE,EAAA,GAAY,SAAAO,GAAS,eAAAE,EAAA;AACzD;AAOO,SAASE,EACdC,GACApB,GACA;AAAA,EACE,iBAAAC,IAAkB;AAAA,EAClB,WAAAC;AACF,IAAiE,IACzD;AACR,QAAMC,IAAOD,KAAaP,GACpBS,IAAS,IAAI,gBAAgBJ,CAAM;AAGzC,aAAWqB,KAAO,OAAO,OAAOlB,CAAI,EAAG,CAAAC,EAAO,OAAOiB,CAAG;AAExD,SAAID,EAAM,WAAW,YAAY,KAC/BhB,EAAO,IAAID,EAAK,MAAM,OAAOiB,EAAM,WAAW,YAAY,CAAC,CAAC,GAE1DA,EAAM,WAAW,aAAanB,KAChCG,EAAO,IAAID,EAAK,MAAM,OAAOiB,EAAM,WAAW,QAAQ,CAAC,GAErDA,EAAM,QAAQ,SAAS,KACzBhB,EAAO;AAAA,IACLD,EAAK;AAAA,IACLiB,EAAM,QACH,IAAI,CAACF,MAAU,GAAGA,EAAM,EAAE,IAAIA,EAAM,OAAO,SAAS,KAAK,EAAE,EAC3D,KAAK,GAAG;AAAA,EAAA,GAGXE,EAAM,cAAc,SAAS,KAC/BhB,EAAO;AAAA,IACLD,EAAK;AAAA,IACLiB,EAAM,cACH,IAAI,CAACF,MAAU,GAAGA,EAAM,EAAE,IAAI,mBAAmBA,EAAM,KAAK,CAAC,EAAE,EAC/D,KAAK,GAAG;AAAA,EAAA,GAIRd,EAAO,SAAA;AAChB;AAEA,SAASkB,EACPrB,GACAC,GACe;AACf,QAAMF,IAAS,OAAO,SAAW,MAAc,OAAO,SAAS,SAAS;AACxE,SAAOD,EAAmBC,GAAQ,EAAE,iBAAAC,GAAiB,WAAAC,GAAW;AAClE;AAUO,SAASqB,EACdC,IAAmC,IACX;AACxB,QAAM,EAAE,iBAAAvB,IAAkB,GAAA,IAAOuB,GAC3BtB,IAAYuB,EAAM;AAAA,IACtB,OAAO,EAAE,GAAG9B,GAA8B,GAAG6B,EAAQ,UAAA;AAAA,IACrD,CAACA,EAAQ,SAAS;AAAA,EAAA,GAGd,CAACJ,GAAOM,CAAQ,IAAID,EAAM;AAAA,IAAwB,MACtDH,EAAiBrB,GAAiBC,CAAS;AAAA,EAAA,GAKvCyB,IAAWF,EAAM,OAAOL,CAAK;AACnC,EAAAO,EAAS,UAAUP;AAMnB,QAAMQ,IAAuBH,EAAM,OAAO,EAAK;AAE/C,EAAAA,EAAM,UAAU,MAAM;AACpB,QAAI,OAAO,SAAW,IAAa;AACnC,UAAMI,IAAa,MAAM;AACvB,MAAAH,EAASJ,EAAiBrB,GAAiBC,CAAS,CAAC;AAAA,IACvD;AACA,kBAAO,iBAAiB,YAAY2B,CAAU,GACvC,MAAM,OAAO,oBAAoB,YAAYA,CAAU;AAAA,EAChE,GAAG,CAAC5B,GAAiBC,CAAS,CAAC;AAE/B,QAAM4B,IAASL,EAAM;AAAA,IACnB,CAACM,MAAwB;AAMvB,UAFAJ,EAAS,UAAUI,GACnBL,EAASK,CAAI,GACT,OAAO,SAAW,IAAa;AACnC,YAAMC,IAAQb,EAAuBY,GAAM,OAAO,SAAS,QAAQ;AAAA,QACjE,iBAAA9B;AAAA,QACA,WAAAC;AAAA,MAAA,CACD,GACK+B,IAAM,GAAG,OAAO,SAAS,QAAQ,GAAGD,IAAQ,IAAIA,CAAK,KAAK,EAAE,GAAG,OAAO,SAAS,IAAI;AACzF,MAAIJ,EAAqB,UACvB,OAAO,QAAQ,aAAa,MAAM,IAAIK,CAAG,KAEzC,OAAO,QAAQ,UAAU,MAAM,IAAIA,CAAG,GACtCL,EAAqB,UAAU,IAC/B,eAAe,MAAM;AACnB,QAAAA,EAAqB,UAAU;AAAA,MACjC,CAAC;AAAA,IAEL;AAAA,IACA,CAAC3B,GAAiBC,CAAS;AAAA,EAAA,GAGvBgC,IAAgBT,EAAM;AAAA,IAC1B,CAAC5B,MAAmD;AAClD,MAAAiC,EAAO;AAAA,QACL,GAAGH,EAAS;AAAA,QACZ,YAAY/B,EAAaC,GAAS8B,EAAS,QAAQ,UAAU;AAAA,MAAA,CAC9D;AAAA,IACH;AAAA,IACA,CAACG,CAAM;AAAA,EAAA,GAGHK,IAAaV,EAAM;AAAA,IACvB,CAAC5B,MAAkD;AACjD,MAAAiC,EAAO;AAAA,QACL,GAAGH,EAAS;AAAA,QACZ,SAAS/B,EAAaC,GAAS8B,EAAS,QAAQ,OAAO;AAAA,MAAA,CACxD;AAAA,IACH;AAAA,IACA,CAACG,CAAM;AAAA,EAAA,GAGHM,IAAmBX,EAAM;AAAA,IAC7B,CAAC5B,MAAuD;AACtD,MAAAiC,EAAO;AAAA,QACL,GAAGH,EAAS;AAAA,QACZ,eAAe/B,EAAaC,GAAS8B,EAAS,QAAQ,aAAa;AAAA,MAAA,CACpE;AAAA,IACH;AAAA,IACA,CAACG,CAAM;AAAA,EAAA;AAGT,SAAO,EAAE,OAAAV,GAAO,eAAAc,GAAe,YAAAC,GAAY,kBAAAC,EAAA;AAC7C;"}
+{"version":3,"file":"use-table-url-state.js","names":[],"sources":["../../src/hooks/use-table-url-state.ts"],"sourcesContent":["import * as React from 'react';\n\nexport interface TablePaginationState {\n  /** Zero-based page index. */\n  pageIndex: number;\n  /** Rows per page. */\n  pageSize: number;\n}\n\nexport interface TableSortingState {\n  /** Column id. */\n  id: string;\n  /** `true` for descending. */\n  desc: boolean;\n}\n\nexport interface TableColumnFilterState {\n  /** Column id. */\n  id: string;\n  /** Filter value (string-encoded in the URL). */\n  value: string;\n}\n\n/**\n * Controlled table state. The three fields mirror TanStack's `PaginationState`,\n * `SortingState`, and `ColumnFiltersState` shapes (filter value narrowed to\n * `string`) so they can wire straight into `onPaginationChange` /\n * `onSortingChange` / `onColumnFiltersChange`.\n */\nexport interface TableUrlState {\n  pagination: TablePaginationState;\n  sorting: TableSortingState[];\n  columnFilters: TableColumnFilterState[];\n}\n\n/** Query-string keys. Namespaced (`tbl_*`) to avoid collisions with Storybook's\n * own `path`/`args`/`globals` params on a shared preview-iframe URL. */\nexport interface TableUrlParamKeys {\n  page: string;\n  size: string;\n  sort: string;\n  filter: string;\n}\n\nexport const DEFAULT_TABLE_URL_PARAM_KEYS: TableUrlParamKeys = {\n  page: 'tbl_page',\n  size: 'tbl_size',\n  sort: 'tbl_sort',\n  filter: 'tbl_filter',\n};\n\nexport interface UseTableUrlStateOptions {\n  /** Default page size; omitted from the URL when the size matches it. */\n  defaultPageSize?: number;\n  /** Override the namespaced query-string keys. */\n  paramKeys?: Partial<TableUrlParamKeys>;\n}\n\nexport type TableUrlUpdater<T> = T | ((old: T) => T);\n\nexport interface UseTableUrlStateResult {\n  state: TableUrlState;\n  /** Accepts a value or updater — shaped for TanStack's `onPaginationChange`. */\n  setPagination: (updater: TableUrlUpdater<TablePaginationState>) => void;\n  /** Accepts a value or updater — shaped for TanStack's `onSortingChange`. */\n  setSorting: (updater: TableUrlUpdater<TableSortingState[]>) => void;\n  /** Accepts a value or updater — shaped for TanStack's `onColumnFiltersChange`. */\n  setColumnFilters: (\n    updater: TableUrlUpdater<TableColumnFilterState[]>\n  ) => void;\n}\n\nfunction applyUpdater<T>(updater: TableUrlUpdater<T>, old: T): T {\n  return typeof updater === 'function'\n    ? (updater as (old: T) => T)(old)\n    : updater;\n}\n\n/**\n * Parses table state out of a query string. Pure — safe to reuse for seeding a\n * story or an SSR default. `search` may include or omit the leading `?`.\n *\n * Encoding: `tbl_page` is 1-based; `tbl_sort` is `id:asc|desc` pairs joined by\n * `,`; `tbl_filter` is `id:<encoded-value>` pairs joined by `,` (the value is\n * `encodeURIComponent`-escaped so it may contain `:`/`,`). Column ids must not\n * contain `:` or `,`.\n */\nexport function parseTableUrlState(\n  search: string,\n  {\n    defaultPageSize = 10,\n    paramKeys,\n  }: { defaultPageSize?: number; paramKeys?: TableUrlParamKeys } = {}\n): TableUrlState {\n  const keys = paramKeys ?? DEFAULT_TABLE_URL_PARAM_KEYS;\n  const params = new URLSearchParams(search);\n\n  const rawPage = Number(params.get(keys.page));\n  const pageIndex =\n    Number.isFinite(rawPage) && rawPage >= 1 ? Math.floor(rawPage) - 1 : 0;\n\n  const rawSize = Number(params.get(keys.size));\n  const pageSize =\n    Number.isFinite(rawSize) && rawSize >= 1 ? Math.floor(rawSize) : defaultPageSize;\n\n  const sortParam = params.get(keys.sort);\n  const sortingById = new Map<string, TableSortingState>();\n  if (sortParam) {\n    for (const pair of sortParam.split(',')) {\n      const separator = pair.indexOf(':');\n      if (separator === -1) continue;\n      const id = pair.slice(0, separator);\n      const dir = pair.slice(separator + 1);\n      if (!id || (dir !== 'asc' && dir !== 'desc')) continue;\n      // Last occurrence wins on a duplicate id — matches URLSearchParams'\n      // own semantics for a repeated key.\n      sortingById.set(id, { id, desc: dir === 'desc' });\n    }\n  }\n  const sorting: TableSortingState[] = Array.from(sortingById.values());\n\n  const filterParam = params.get(keys.filter);\n  const columnFilters: TableColumnFilterState[] = filterParam\n    ? filterParam\n        .split(',')\n        .map((pair) => {\n          const separator = pair.indexOf(':');\n          if (separator === -1) return null;\n          const id = pair.slice(0, separator);\n          if (!id) return null;\n          try {\n            return { id, value: decodeURIComponent(pair.slice(separator + 1)) };\n          } catch {\n            return null;\n          }\n        })\n        .filter((entry): entry is TableColumnFilterState => entry !== null)\n    : [];\n\n  return { pagination: { pageIndex, pageSize }, sorting, columnFilters };\n}\n\n/**\n * Serializes table state onto a query string, preserving any foreign params\n * already present in `search` (e.g. Storybook's `path`/`args`/`globals`).\n * Returns the query string without a leading `?` (empty string when no params).\n */\nexport function serializeTableUrlState(\n  state: TableUrlState,\n  search: string,\n  {\n    defaultPageSize = 10,\n    paramKeys,\n  }: { defaultPageSize?: number; paramKeys?: TableUrlParamKeys } = {}\n): string {\n  const keys = paramKeys ?? DEFAULT_TABLE_URL_PARAM_KEYS;\n  const params = new URLSearchParams(search);\n\n  // Clear our namespaced keys before rewriting so a cleared field drops out.\n  for (const key of Object.values(keys)) params.delete(key);\n\n  if (state.pagination.pageIndex > 0) {\n    params.set(keys.page, String(state.pagination.pageIndex + 1));\n  }\n  if (state.pagination.pageSize !== defaultPageSize) {\n    params.set(keys.size, String(state.pagination.pageSize));\n  }\n  if (state.sorting.length > 0) {\n    params.set(\n      keys.sort,\n      state.sorting\n        .map((entry) => `${entry.id}:${entry.desc ? 'desc' : 'asc'}`)\n        .join(',')\n    );\n  }\n  if (state.columnFilters.length > 0) {\n    params.set(\n      keys.filter,\n      state.columnFilters\n        .map((entry) => `${entry.id}:${encodeURIComponent(entry.value)}`)\n        .join(',')\n    );\n  }\n\n  return params.toString();\n}\n\nfunction readCurrentState(\n  defaultPageSize: number,\n  paramKeys: TableUrlParamKeys\n): TableUrlState {\n  const search = typeof window !== 'undefined' ? window.location.search : '';\n  return parseTableUrlState(search, { defaultPageSize, paramKeys });\n}\n\n/**\n * Router-agnostic hook that syncs controlled table state (pagination / sorting\n * / column filters) to and from the URL query string via `history.pushState` +\n * `popstate`. Depends only on `window.location` / `window.history`, so it works\n * with any router (or none). Query keys are namespaced (`tbl_*`) so they never\n * collide with other params on the same URL. Reads initial state from the URL,\n * so a bookmarked link restores the table's view.\n */\nexport function useTableUrlState(\n  options: UseTableUrlStateOptions = {}\n): UseTableUrlStateResult {\n  const { defaultPageSize = 10 } = options;\n  const paramKeys = React.useMemo<TableUrlParamKeys>(\n    () => ({ ...DEFAULT_TABLE_URL_PARAM_KEYS, ...options.paramKeys }),\n    [options.paramKeys]\n  );\n\n  const [state, setState] = React.useState<TableUrlState>(() =>\n    readCurrentState(defaultPageSize, paramKeys)\n  );\n\n  // Keep a ref of the latest state so `popstate` and the setters can compute\n  // the next URL/state without re-subscribing on every change.\n  const stateRef = React.useRef(state);\n  stateRef.current = state;\n\n  // Coalesce multiple setters called synchronously in the same handler (e.g. a\n  // filter change that also resets the page) into a single history entry: the\n  // first commit in a tick pushes, later ones in the same tick replace. The\n  // flag clears on a microtask so the next distinct user action pushes again.\n  const hasPushedThisTickRef = React.useRef(false);\n\n  React.useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const onPopState = () => {\n      setState(readCurrentState(defaultPageSize, paramKeys));\n    };\n    window.addEventListener('popstate', onPopState);\n    return () => window.removeEventListener('popstate', onPopState);\n  }, [defaultPageSize, paramKeys]);\n\n  const commit = React.useCallback(\n    (next: TableUrlState) => {\n      // Refresh the ref here, not just in the render body — two setters\n      // called synchronously in the same handler (before React re-renders)\n      // must see each other's updates, not the pre-batch snapshot.\n      stateRef.current = next;\n      setState(next);\n      if (typeof window === 'undefined') return;\n      const query = serializeTableUrlState(next, window.location.search, {\n        defaultPageSize,\n        paramKeys,\n      });\n      const url = `${window.location.pathname}${query ? `?${query}` : ''}${window.location.hash}`;\n      if (hasPushedThisTickRef.current) {\n        window.history.replaceState(null, '', url);\n      } else {\n        window.history.pushState(null, '', url);\n        hasPushedThisTickRef.current = true;\n        queueMicrotask(() => {\n          hasPushedThisTickRef.current = false;\n        });\n      }\n    },\n    [defaultPageSize, paramKeys]\n  );\n\n  const setPagination = React.useCallback(\n    (updater: TableUrlUpdater<TablePaginationState>) => {\n      commit({\n        ...stateRef.current,\n        pagination: applyUpdater(updater, stateRef.current.pagination),\n      });\n    },\n    [commit]\n  );\n\n  const setSorting = React.useCallback(\n    (updater: TableUrlUpdater<TableSortingState[]>) => {\n      commit({\n        ...stateRef.current,\n        sorting: applyUpdater(updater, stateRef.current.sorting),\n      });\n    },\n    [commit]\n  );\n\n  const setColumnFilters = React.useCallback(\n    (updater: TableUrlUpdater<TableColumnFilterState[]>) => {\n      commit({\n        ...stateRef.current,\n        columnFilters: applyUpdater(updater, stateRef.current.columnFilters),\n      });\n    },\n    [commit]\n  );\n\n  return { state, setPagination, setSorting, setColumnFilters };\n}\n"],"mappings":"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"}

package/dist/hooks/use-wizard.js

@@ -0,0 +1,61 @@
+import * as e from "react";
+//#region src/hooks/use-wizard.ts
+var t = {
+	completed: {
+		avatarColor: "green",
+		avatarClassName: "[box-shadow:none]"
+	},
+	current: {
+		avatarColor: "blue",
+		avatarClassName: "[box-shadow:none] text-[var(--ui-stepper-item-current-label-color)]"
+	},
+	future: {
+		avatarColor: "gray",
+		avatarClassName: "[box-shadow:none] text-[var(--ui-stepper-item-future-label-color)]"
+	}
+};
+function n(e, t) {
+	return Math.min(Math.max(e, 0), t - 1);
+}
+function r(e, t) {
+	if (typeof t == "number") return Number.isNaN(t) ? null : n(Math.trunc(t), e.length);
+	let r = e.findIndex((e) => e.id === t);
+	return r === -1 ? null : r;
+}
+function i({ steps: i, initialStep: a = 0 }) {
+	if (i.length === 0) throw Error("useWizard: `steps` must not be empty.");
+	let o = i.length, [s, c] = e.useState(() => r(i, a) ?? 0), l = n(s, o), u = e.useCallback(() => {
+		c((e) => n(n(e, o) + 1, o));
+	}, [o]), d = e.useCallback(() => {
+		c((e) => n(n(e, o) - 1, o));
+	}, [o]), f = e.useCallback((e) => {
+		let t = r(i, e);
+		t !== null && c(t);
+	}, [i]);
+	return {
+		steps: e.useMemo(() => i.map((e, n) => {
+			let r = n < l ? "completed" : n === l ? "current" : "future";
+			return {
+				...e,
+				index: n,
+				stepNumber: n + 1,
+				variant: r,
+				...t[r]
+			};
+		}), [i, l]),
+		currentIndex: l,
+		currentStepNumber: l + 1,
+		stepCount: o,
+		currentStepLabel: i[l].label,
+		nextStepLabel: i[l + 1]?.label,
+		isFirstStep: l === 0,
+		isLastStep: l === o - 1,
+		goToNextStep: u,
+		goToPreviousStep: d,
+		goToStep: f
+	};
+}
+//#endregion
+export { i as useWizard };
+
+//# sourceMappingURL=use-wizard.js.map

package/dist/hooks/use-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-wizard.js","names":[],"sources":["../../src/hooks/use-wizard.ts"],"sourcesContent":["import * as React from 'react';\n\nexport interface WizardStep {\n  /** Stable identifier; `goToStep` and `initialStep` accept it as a string. */\n  id: string;\n  /** Step label, rendered by `StepperItem` and the `Stepper` summary. */\n  label: string;\n}\n\nexport type WizardStepAvatarColor = 'blue' | 'green' | 'gray';\n\nexport type WizardStepVariant = 'completed' | 'current' | 'future';\n\n/**\n * A step enriched with everything a `StepperItem` needs. Intersects `TStep`, so\n * any extra fields the consumer put on their own step objects survive.\n */\nexport type WizardStepState<TStep extends WizardStep = WizardStep> = TStep & {\n  /** Zero-based position in `steps`. */\n  index: number;\n  /** One-based position, for the avatar's displayed number. */\n  stepNumber: number;\n  /** `StepperItem`'s `variant`, derived from the position vs. `currentIndex`. */\n  variant: WizardStepVariant;\n  /** `Avatar`'s `color` for this step's variant. */\n  avatarColor: WizardStepAvatarColor;\n  /** Classes to merge onto this step's `Avatar`. */\n  avatarClassName: string;\n};\n\nexport interface UseWizardOptions<TStep extends WizardStep = WizardStep> {\n  /** The flow's steps, in order. Must not be empty. */\n  steps: TStep[];\n  /**\n   * Where the flow starts — a zero-based index or a step `id`. A numeric\n   * index is truncated toward zero and clamped into range; `NaN` and an id\n   * that matches no step fall back to the first step. A seed, not a\n   * controlled input: later changes are ignored.\n   */\n  initialStep?: number | string;\n}\n\nexport interface UseWizardResult<TStep extends WizardStep = WizardStep> {\n  /** `steps` with per-step `variant`/avatar presentation derived. */\n  steps: WizardStepState<TStep>[];\n  /**\n   * Zero-based index of the active step. Always a valid index into `steps`:\n   * if `steps` shrinks so that the stored index is past the end, the\n   * effective index clamps to `steps.length - 1`.\n   */\n  currentIndex: number;\n  /** One-based number of the active step, for `Stepper`'s `currentStep`. */\n  currentStepNumber: number;\n  /** Total number of steps, for `Stepper`'s `totalSteps`. */\n  stepCount: number;\n  /** The active step's label, for `Stepper`'s `current`. */\n  currentStepLabel: string;\n  /** The following step's label, or `undefined` on the last step. */\n  nextStepLabel: string | undefined;\n  isFirstStep: boolean;\n  isLastStep: boolean;\n  /** Advance one step; no-op on the last step (never wraps). */\n  goToNextStep: () => void;\n  /** Go back one step; no-op on the first step (never wraps). */\n  goToPreviousStep: () => void;\n  /**\n   * Jump to a zero-based index or a step `id`. A numeric index is truncated\n   * toward zero (`1.5` → `1`) and clamped into range; `NaN` is a no-op. An\n   * id that matches no step is a no-op; on duplicate ids the first wins.\n   */\n  goToStep: (target: number | string) => void;\n}\n\nconst AVATAR_BY_VARIANT: Record<\n  WizardStepVariant,\n  { avatarColor: WizardStepAvatarColor; avatarClassName: string }\n> = {\n  completed: { avatarColor: 'green', avatarClassName: '[box-shadow:none]' },\n  current: {\n    avatarColor: 'blue',\n    avatarClassName:\n      '[box-shadow:none] text-[var(--ui-stepper-item-current-label-color)]',\n  },\n  future: {\n    avatarColor: 'gray',\n    avatarClassName:\n      '[box-shadow:none] text-[var(--ui-stepper-item-future-label-color)]',\n  },\n};\n\nfunction clampIndex(index: number, stepCount: number): number {\n  return Math.min(Math.max(index, 0), stepCount - 1);\n}\n\n// Numbers are truncated toward zero and clamped into range; `NaN` and ids that\n// match nothing resolve to `null`, which callers treat as a no-op.\nfunction resolveStepIndex(\n  steps: readonly WizardStep[],\n  target: number | string\n): number | null {\n  if (typeof target === 'number') {\n    if (Number.isNaN(target)) return null;\n    return clampIndex(Math.trunc(target), steps.length);\n  }\n  const index = steps.findIndex((step) => step.id === target);\n  return index === -1 ? null : index;\n}\n\n/**\n * Headless step state for a `Wizard`'s `Stepper` (the `Wizard` components\n * themselves stay presentational and own no state). Returns the `Stepper`\n * summary props plus a per-step `variant` + avatar presentation, and the\n * navigation callbacks a consumer wires to its Back/Next buttons.\n *\n * Opt-in: a consumer that already owns its step state can keep driving\n * `Stepper`/`StepperItem` by hand.\n *\n * `steps` may be a live, per-render value. The active index is stored as\n * state but re-clamped against the *current* `steps.length` on every read,\n * so a `steps` array that shrinks past the active index resolves to the last\n * remaining step instead of reading past the end.\n */\nexport function useWizard<TStep extends WizardStep = WizardStep>({\n  steps,\n  initialStep = 0,\n}: UseWizardOptions<TStep>): UseWizardResult<TStep> {\n  if (steps.length === 0) {\n    throw new Error('useWizard: `steps` must not be empty.');\n  }\n\n  const stepCount = steps.length;\n\n  const [storedIndex, setCurrentIndex] = React.useState(\n    () => resolveStepIndex(steps, initialStep) ?? 0\n  );\n\n  // `storedIndex` can outlive the step it pointed at, so every read goes\n  // through the clamp rather than trusting the stored value.\n  const currentIndex = clampIndex(storedIndex, stepCount);\n\n  // Both step relative to the *clamped* current index, so a `steps` array that\n  // shrank does not leave the stored value skipping steps on the way back.\n  const goToNextStep = React.useCallback(() => {\n    setCurrentIndex((current) =>\n      clampIndex(clampIndex(current, stepCount) + 1, stepCount)\n    );\n  }, [stepCount]);\n\n  const goToPreviousStep = React.useCallback(() => {\n    setCurrentIndex((current) =>\n      clampIndex(clampIndex(current, stepCount) - 1, stepCount)\n    );\n  }, [stepCount]);\n\n  const goToStep = React.useCallback(\n    (target: number | string) => {\n      const index = resolveStepIndex(steps, target);\n      if (index === null) return;\n      setCurrentIndex(index);\n    },\n    [steps]\n  );\n\n  const derivedSteps = React.useMemo(\n    () =>\n      steps.map((step, index) => {\n        const variant: WizardStepVariant =\n          index < currentIndex\n            ? 'completed'\n            : index === currentIndex\n              ? 'current'\n              : 'future';\n        return {\n          ...step,\n          index,\n          stepNumber: index + 1,\n          variant,\n          ...AVATAR_BY_VARIANT[variant],\n        };\n      }),\n    [steps, currentIndex]\n  );\n\n  return {\n    steps: derivedSteps,\n    currentIndex,\n    currentStepNumber: currentIndex + 1,\n    stepCount,\n    currentStepLabel: steps[currentIndex].label,\n    nextStepLabel: steps[currentIndex + 1]?.label,\n    isFirstStep: currentIndex === 0,\n    isLastStep: currentIndex === stepCount - 1,\n    goToNextStep,\n    goToPreviousStep,\n    goToStep,\n  };\n}\n"],"mappings":";;AAyEA,IAAM,IAGF;CACF,WAAW;EAAE,aAAa;EAAS,iBAAiB;CAAoB;CACxE,SAAS;EACP,aAAa;EACb,iBACE;CACJ;CACA,QAAQ;EACN,aAAa;EACb,iBACE;CACJ;AACF;AAEA,SAAS,EAAW,GAAe,GAA2B;CAC5D,OAAO,KAAK,IAAI,KAAK,IAAI,GAAO,CAAC,GAAG,IAAY,CAAC;AACnD;AAIA,SAAS,EACP,GACA,GACe;CACf,IAAI,OAAO,KAAW,UAEpB,OADI,OAAO,MAAM,CAAM,IAAU,OAC1B,EAAW,KAAK,MAAM,CAAM,GAAG,EAAM,MAAM;CAEpD,IAAM,IAAQ,EAAM,WAAW,MAAS,EAAK,OAAO,CAAM;CAC1D,OAAO,MAAU,KAAK,OAAO;AAC/B;AAgBA,SAAgB,EAAiD,EAC/D,UACA,iBAAc,KACoC;CAClD,IAAI,EAAM,WAAW,GACnB,MAAU,MAAM,uCAAuC;CAGzD,IAAM,IAAY,EAAM,QAElB,CAAC,GAAa,KAAmB,EAAM,eACrC,EAAiB,GAAO,CAAW,KAAK,CAChD,GAIM,IAAe,EAAW,GAAa,CAAS,GAIhD,IAAe,EAAM,kBAAkB;EAC3C,GAAiB,MACf,EAAW,EAAW,GAAS,CAAS,IAAI,GAAG,CAAS,CAC1D;CACF,GAAG,CAAC,CAAS,CAAC,GAER,IAAmB,EAAM,kBAAkB;EAC/C,GAAiB,MACf,EAAW,EAAW,GAAS,CAAS,IAAI,GAAG,CAAS,CAC1D;CACF,GAAG,CAAC,CAAS,CAAC,GAER,IAAW,EAAM,aACpB,MAA4B;EAC3B,IAAM,IAAQ,EAAiB,GAAO,CAAM;EACxC,MAAU,QACd,EAAgB,CAAK;CACvB,GACA,CAAC,CAAK,CACR;CAsBA,OAAO;EACL,OArBmB,EAAM,cAEvB,EAAM,KAAK,GAAM,MAAU;GACzB,IAAM,IACJ,IAAQ,IACJ,cACA,MAAU,IACR,YACA;GACR,OAAO;IACL,GAAG;IACH;IACA,YAAY,IAAQ;IACpB;IACA,GAAG,EAAkB;GACvB;EACF,CAAC,GACH,CAAC,GAAO,CAAY,CAIb;EACP;EACA,mBAAmB,IAAe;EAClC;EACA,kBAAkB,EAAM,EAAa,CAAC;EACtC,eAAe,EAAM,IAAe,EAAE,EAAE;EACxC,aAAa,MAAiB;EAC9B,YAAY,MAAiB,IAAY;EACzC;EACA;EACA;CACF;AACF"}