@pibit.ai/cure-design-system 0.3.35 → 0.3.40

package/dist/patterns/table/toolbar/TableToolbar.js

@@ -1,32 +1,32 @@
-import { jsx as o, jsxs as p } from "react/jsx-runtime";
-import { useMemo as D, isValidElement as L, cloneElement as M, useRef as A, useState as I, useEffect as K, useLayoutEffect as O } from "react";
-import { FlipBackward as W, FlipForward as j, ChevronSelectorVertical as F, DotsHorizontal as P } from "@untitledui/icons";
-import { cx as N } from "../../../utils/cn.js";
-import { AlignDropdown as H } from "./AlignDropdown.js";
-import { GroupByDropdown as T } from "./GroupByDropdown.js";
-import { HideFieldsDropdown as G } from "./HideFieldsDropdown.js";
-import { RowHeightDropdown as _ } from "./RowHeightDropdown.js";
-import { ShowSummaryDropdown as B } from "./ShowSummaryDropdown.js";
-import { resolveColumnLabel as V } from "./tableToolbarHelpers.js";
-import { useUndoRedoShortcuts as $ } from "./useUndoRedoShortcuts.js";
-import { ExpandableSearchInput as q } from "../../../primitives/select/ExpandableSearchInput.js";
-import { Button as y } from "../../../primitives/button/button.js";
+import { jsx as n, jsxs as p } from "react/jsx-runtime";
+import { useMemo as S, isValidElement as M, cloneElement as k, useRef as I, useState as O, useEffect as W, useLayoutEffect as U } from "react";
+import { FlipBackward as j, FlipForward as F, ChevronSelectorVertical as P, DotsHorizontal as H } from "@untitledui/icons";
+import { cx as A } from "../../../utils/cn.js";
+import { AlignDropdown as T } from "./AlignDropdown.js";
+import { GroupByDropdown as G } from "./GroupByDropdown.js";
+import { HideFieldsDropdown as _ } from "./HideFieldsDropdown.js";
+import { RowHeightDropdown as B } from "./RowHeightDropdown.js";
+import { ShowSummaryDropdown as V } from "./ShowSummaryDropdown.js";
+import { resolveColumnLabel as $ } from "./tableToolbarHelpers.js";
+import { useUndoRedoShortcuts as q } from "./useUndoRedoShortcuts.js";
+import { ExpandableSearchInput as E } from "../../../primitives/select/ExpandableSearchInput.js";
+import { Button as D } from "../../../primitives/button/button.js";
 import { Dropdown as x } from "../../../primitives/dropdown/dropdown.js";
-import { Icon as E } from "../../../primitives/icon/icon.js";
-function J(e, i) {
-  return L(e) ? M(e, {
+import { Icon as J } from "../../../primitives/icon/icon.js";
+function Q(e, i) {
+  return M(e) ? k(e, {
     onApply: i.onApply,
     onClear: i.onClear,
     clearAllSorts: i.onClear
   }) : e;
 }
-function Q(e, i) {
-  return L(e) ? M(e, {
+function X(e, i) {
+  return M(e) ? k(e, {
     onApply: i.onApply,
     onClearAll: i.onClearAll
   }) : e;
 }
-const X = ({ config: e }) => ($({
+const Y = ({ config: e }) => (q({
   enabled: e.shortcut ?? !0,
   canUndo: e.canUndo,
   canRedo: e.canRedo,
@@ -34,31 +34,31 @@ const X = ({ config: e }) => ($({
   onRedo: e.onRedo,
   isDisabled: e.isDisabled
 }), /* @__PURE__ */ p("div", { className: "flex items-center gap-2", children: [
-  /* @__PURE__ */ o(
-    y,
+  /* @__PURE__ */ n(
+    D,
     {
       size: "xs",
       color: "secondary",
-      iconLeading: /* @__PURE__ */ o(W, { size: 16 }),
+      iconLeading: /* @__PURE__ */ n(j, { size: 16 }),
       "aria-label": "Undo",
       title: "Undo",
       isDisabled: e.isDisabled || !e.canUndo,
       onClick: e.onUndo
     }
   ),
-  /* @__PURE__ */ o(
-    y,
+  /* @__PURE__ */ n(
+    D,
     {
       size: "xs",
       color: "secondary",
-      iconLeading: /* @__PURE__ */ o(j, { size: 16 }),
+      iconLeading: /* @__PURE__ */ n(F, { size: 16 }),
       "aria-label": "Redo",
       title: "Redo",
       isDisabled: e.isDisabled || !e.canRedo,
       onClick: e.onRedo
     }
   )
-] })), Y = ({ config: e, content: i }) => {
+] })), Z = ({ config: e, content: i }) => {
   const l = e.sorts.some((r) => r.field !== "" && r.direction !== "");
   return /* @__PURE__ */ p(
     x.Root,
@@ -69,45 +69,45 @@ const X = ({ config: e }) => ($({
       },
       children: [
         /* @__PURE__ */ p(
-          y,
+          D,
           {
             size: "xs",
             color: "secondary",
-            iconLeading: /* @__PURE__ */ o(F, { size: 12 }),
-            className: N(
+            iconLeading: /* @__PURE__ */ n(P, { size: 12 }),
+            className: A(
               l && "ring-1 ring-brand-600 bg-brand-primary text-brand-600 hover:bg-brand-primary hover:text-brand-600"
             ),
             children: [
               "Sort",
-              l && /* @__PURE__ */ o("span", { className: "ml-1 text-xs font-semibold text-brand-600", children: e.sorts.length })
+              l && /* @__PURE__ */ n("span", { className: "ml-1 text-xs font-semibold text-brand-600", children: e.sorts.length })
             ]
           }
         ),
-        /* @__PURE__ */ o(x.Popover, { className: "w-auto min-w-[300px]", children: i })
+        /* @__PURE__ */ n(x.Popover, { className: "w-auto min-w-[300px]", children: i })
       ]
     }
   );
-}, Z = ({ config: e, content: i }) => {
+}, ee = ({ config: e, content: i }) => {
   const l = e.meaningfulConditionsCount > 0;
   return /* @__PURE__ */ p(x.Root, { isOpen: e.isOpen, onOpenChange: e.onOpenChange, children: [
     /* @__PURE__ */ p(
-      y,
+      D,
       {
         size: "xs",
         color: "secondary",
-        iconLeading: /* @__PURE__ */ o(E, { name: "FilterLines", size: 12 }),
-        className: N(
+        iconLeading: /* @__PURE__ */ n(J, { name: "FilterLines", size: 12 }),
+        className: A(
           l && "ring-1 ring-brand-600 bg-brand-primary text-brand-600 hover:bg-brand-primary hover:text-brand-600"
         ),
         children: [
           "Filter",
-          l && /* @__PURE__ */ o("span", { className: "ml-1 text-xs font-semibold text-brand-600", children: e.meaningfulConditionsCount })
+          l && /* @__PURE__ */ n("span", { className: "ml-1 text-xs font-semibold text-brand-600", children: e.meaningfulConditionsCount })
         ]
       }
     ),
-    /* @__PURE__ */ o(x.Popover, { className: "w-auto min-w-[300px]", children: i })
+    /* @__PURE__ */ n(x.Popover, { className: "w-auto min-w-[300px]", children: i })
   ] });
-}, be = ({
+}, we = ({
   className: e,
   fallbackTitle: i,
   undoRedo: l,
@@ -119,122 +119,124 @@ const X = ({ config: e }) => ($({
   align: h,
   groupBy: m,
   summary: g,
-  trailing: z,
-  searchCollapsible: R,
-  disableExtendedTools: n = !1,
-  sortContent: s,
-  filterContent: a
+  beforeSearch: z,
+  trailing: y,
+  searchCollapsible: o,
+  disableExtendedTools: s = !1,
+  sortContent: a,
+  filterContent: d
 }) => {
-  const d = D(
-    () => r && s ? J(s, r) : s,
-    [r, s]
-  ), b = D(
-    () => t && a ? Q(a, t) : a,
-    [t, a]
-  ), S = D(() => {
+  const b = S(
+    () => r && a ? Q(a, r) : a,
+    [r, a]
+  ), w = S(
+    () => t && d ? X(d, t) : d,
+    [t, d]
+  ), N = S(() => {
     const c = [];
-    if (l && c.push({ id: "undo-redo", node: /* @__PURE__ */ o(X, { config: l }) }), r && d) {
-      const w = r.sorts.some((f) => f.field !== "" && f.direction !== "");
+    if (l && c.push({ id: "undo-redo", node: /* @__PURE__ */ n(Y, { config: l }) }), r && b) {
+      const f = r.sorts.some((R) => R.field !== "" && R.direction !== "");
       c.push({
         id: "sort",
-        widthKey: w ? String(r.sorts.length) : "",
-        node: /* @__PURE__ */ o(Y, { config: r, content: d })
+        widthKey: f ? String(r.sorts.length) : "",
+        node: /* @__PURE__ */ n(Z, { config: r, content: b })
       });
     }
-    if (t && b && c.push({
+    if (t && w && c.push({
       id: "filter",
       widthKey: t.meaningfulConditionsCount > 0 ? String(t.meaningfulConditionsCount) : "",
-      node: /* @__PURE__ */ o(Z, { config: t, content: b })
+      node: /* @__PURE__ */ n(ee, { config: t, content: w })
     }), C && c.push({
       id: "row-height",
-      node: /* @__PURE__ */ o(_, { ...C, isDisabled: n })
+      node: /* @__PURE__ */ n(B, { ...C, isDisabled: s })
     }), v && c.push({
       id: "hide-fields",
       widthKey: v.hiddenColumns.size > 0 ? String(v.hiddenColumns.size) : "",
-      node: /* @__PURE__ */ o(G, { ...v, isDisabled: n })
-    }), h && c.push({ id: "align", node: /* @__PURE__ */ o(H, { ...h, isDisabled: n }) }), m) {
-      const w = m.value ? m.schema.find((k) => k.value === m.value) : void 0, f = w ? V(w, m.labelMeta) : "";
+      node: /* @__PURE__ */ n(_, { ...v, isDisabled: s })
+    }), h && c.push({ id: "align", node: /* @__PURE__ */ n(T, { ...h, isDisabled: s }) }), m) {
+      const f = m.value ? m.schema.find((K) => K.value === m.value) : void 0, R = f ? $(f, m.labelMeta) : "";
       c.push({
         id: "group-by",
-        widthKey: f,
-        node: /* @__PURE__ */ o(T, { ...m, isDisabled: n })
+        widthKey: R,
+        node: /* @__PURE__ */ n(G, { ...m, isDisabled: s })
       });
     }
     return g && c.push({
       id: "summary",
-      node: /* @__PURE__ */ o(B, { ...g, isDisabled: n })
+      node: /* @__PURE__ */ n(V, { ...g, isDisabled: s })
     }), c;
   }, [
     l,
     r,
-    d,
-    t,
     b,
+    t,
+    w,
     C,
     v,
     h,
     m,
     g,
-    n
+    s
   ]);
-  return /* @__PURE__ */ p("div", { className: N("flex justify-between items-center gap-2", e), children: [
-    S.length > 0 ? /* @__PURE__ */ o(ne, { items: S }) : i ? /* @__PURE__ */ o("h4", { className: "text-sm font-normal text-secondary", children: i }) : /* @__PURE__ */ o("div", {}),
+  return /* @__PURE__ */ p("div", { className: A("flex justify-between items-center gap-2", e), children: [
+    N.length > 0 ? /* @__PURE__ */ n(oe, { items: N }) : i ? /* @__PURE__ */ n("h4", { className: "text-sm font-normal text-secondary", children: i }) : /* @__PURE__ */ n("div", {}),
     /* @__PURE__ */ p("div", { className: "flex items-center gap-2 shrink-0", children: [
-      u && /* @__PURE__ */ o(
-        q,
+      z,
+      u && /* @__PURE__ */ n(
+        E,
         {
           size: "sm",
           placeholder: "Search",
           value: u.value,
           onChange: u.onChange,
-          collapsible: R,
-          isDisabled: n,
+          collapsible: o,
+          isDisabled: s,
           shortcut: u.shortcut
         }
       ),
-      z
+      y
     ] })
   ] });
-}, ee = 40, U = 8, ne = ({ items: e }) => {
-  const i = A(null), l = A(/* @__PURE__ */ new Map()), [r, t] = I(() => /* @__PURE__ */ new Map()), [u, C] = I(null), v = D(() => e.map((n) => `${n.id}:${n.widthKey ?? ""}`).join("|"), [e]);
-  K(() => {
+}, ne = 40, L = 8, oe = ({ items: e }) => {
+  const i = I(null), l = I(/* @__PURE__ */ new Map()), [r, t] = O(() => /* @__PURE__ */ new Map()), [u, C] = O(null), v = S(() => e.map((o) => `${o.id}:${o.widthKey ?? ""}`).join("|"), [e]);
+  W(() => {
     t(/* @__PURE__ */ new Map());
-  }, [v]), O(() => {
+  }, [v]), U(() => {
     if (r.size === e.length) return;
-    const n = /* @__PURE__ */ new Map();
+    const o = /* @__PURE__ */ new Map();
     for (const s of e) {
       const a = l.current.get(s.id);
-      a && n.set(s.id, a.getBoundingClientRect().width);
+      a && o.set(s.id, a.getBoundingClientRect().width);
     }
-    n.size === e.length && t(n);
-  }, [e, r]), O(() => {
-    const n = i.current;
-    if (!n) return;
+    o.size === e.length && t(o);
+  }, [e, r]), U(() => {
+    const o = i.current;
+    if (!o) return;
     const s = () => {
       i.current && C(i.current.clientWidth);
     };
     s();
     const a = new ResizeObserver(s);
-    return a.observe(n), () => a.disconnect();
+    return a.observe(o), () => a.disconnect();
   }, []);
-  const h = r.size === e.length, { visibleIds: m, overflowIds: g } = D(() => {
+  const h = r.size === e.length, { visibleIds: m, overflowIds: g } = S(() => {
     if (!h || u == null)
       return {
         visibleIds: new Set(e.map((d) => d.id)),
         overflowIds: /* @__PURE__ */ new Set()
       };
-    let n = 0;
+    let o = 0;
     const s = /* @__PURE__ */ new Set(), a = /* @__PURE__ */ new Set();
     for (let d = 0; d < e.length; d++) {
-      const b = e[d].id, S = r.get(b) ?? 0, w = e.length - d - 1 > 0 ? ee + U : 0;
-      if (n + S + w > u) {
+      const b = e[d].id, w = r.get(b) ?? 0, c = e.length - d - 1 > 0 ? ne + L : 0;
+      if (o + w + c > u) {
         for (let f = d; f < e.length; f++) a.add(e[f].id);
         break;
       }
-      n += S + U, s.add(b);
+      o += w + L, s.add(b);
     }
     return { visibleIds: s, overflowIds: a };
-  }, [e, r, u, h]), z = e.filter((n) => m.has(n.id)), R = e.filter((n) => g.has(n.id));
+  }, [e, r, u, h]), z = e.filter((o) => m.has(o.id)), y = e.filter((o) => g.has(o.id));
   return /* @__PURE__ */ p(
     "div",
     {
@@ -242,36 +244,36 @@ const X = ({ config: e }) => ($({
       className: "flex items-center gap-2 min-w-0 flex-1 overflow-hidden",
       style: h ? void 0 : { visibility: "hidden" },
       children: [
-        (h ? z : e).map((n) => /* @__PURE__ */ o(
+        (h ? z : e).map((o) => /* @__PURE__ */ n(
           "div",
           {
             ref: (s) => {
-              l.current.set(n.id, s);
+              l.current.set(o.id, s);
             },
             className: "shrink-0",
-            children: n.node
+            children: o.node
           },
-          n.id
+          o.id
         )),
-        h && R.length > 0 && /* @__PURE__ */ p(x.Root, { children: [
-          /* @__PURE__ */ o(
-            y,
+        h && y.length > 0 && /* @__PURE__ */ p(x.Root, { children: [
+          /* @__PURE__ */ n(
+            D,
             {
               size: "xs",
               color: "secondary",
-              iconLeading: /* @__PURE__ */ o(P, { size: 16 }),
+              iconLeading: /* @__PURE__ */ n(H, { size: 16 }),
               "aria-label": "More tools",
               title: "More tools",
               className: "shrink-0"
             }
           ),
-          /* @__PURE__ */ o(x.Popover, { className: "w-auto", children: /* @__PURE__ */ o("div", { className: "flex flex-col items-stretch gap-2 p-2 min-w-[180px]", children: R.map((n) => /* @__PURE__ */ o("div", { className: "[&>*]:w-full", children: n.node }, n.id)) }) })
+          /* @__PURE__ */ n(x.Popover, { className: "w-auto", children: /* @__PURE__ */ n("div", { className: "flex flex-col items-stretch gap-2 p-2 min-w-[180px]", children: y.map((o) => /* @__PURE__ */ n("div", { className: "[&>*]:w-full", children: o.node }, o.id)) }) })
         ] })
       ]
     }
   );
 };
-function we(e) {
+function xe(e) {
   return {
     sort: e.sort,
     filter: e.filter,
@@ -279,6 +281,6 @@ function we(e) {
   };
 }
 export {
-  be as TableToolbar,
-  we as pickCoreToolbarProps
+  we as TableToolbar,
+  xe as pickCoreToolbarProps
 };

package/dist/patterns/table/types.d.ts

@@ -4,7 +4,7 @@ import { UndoRedoToolConfig } from './toolbar/TableToolbar';
 import { LegacyFilterToolConfig, LegacySortToolConfig } from './toolbar/legacyToolbarTypes';
 import { AlignToolConfig, GroupByToolConfig, HideFieldsToolConfig, RowHeightToolConfig, SearchToolConfig, SummaryToolConfig, CellAlignment, ColumnMenuAction, ColumnMenuCapabilities, RowActionsConfig, RowGroup, SummaryFooterRowProps } from './toolbar';
 import { TableCellRangeRect, TableCellSelection } from './cellRangeSelection';
-export type { TableCellCoord, TableCellRangeRect, TableCellSelection } from './cellRangeSelection';
+export type { TableCellCoord, TableCellRangeRect, TableCellSelection, } from './cellRangeSelection';
 /** Value type used for alignment defaults and aggregation eligibility. */
 export type TableColumnValueType = "string" | "number" | "currency" | "date" | "percentage" | "decimal_percentage" | "array" | "link";
 /**
@@ -34,6 +34,41 @@ export interface TableColumnMenuSchema {
 }
 /** Alias for `TablePaginationConfig` — matches platform-ui `TableWrapperPaginationConfig`. */
 export type TableWrapperPaginationConfig = TablePaginationConfig;
+/**
+ * Opt-in Excel-style zoom for horizontally wide tables. Values are percentages, and the
+ * zoom scales the whole grid — text, padding, row heights and column widths together —
+ * so lowering it fits more columns in the available width at a smaller size.
+ *
+ * Zooming out never paints the grid narrower than its container: the columns shrink while
+ * the grid still overflows, then hold once it exactly fills, so the table is never left
+ * with dead space to its right.
+ *
+ * Requires CSS `zoom` (Chrome 128+, Safari, Firefox 126+). On an engine without it the
+ * table falls back to its unzoomed layout and the control is not rendered, so there is no
+ * dead slider — but there is also no zoom.
+ *
+ * The object may be a fresh literal on every render; `TableWrapper` keys its internal
+ * config off the four values below, not the object identity, so an inline literal will not
+ * reset a zoom level the user has set.
+ */
+export type TableZoomConfig = {
+    /** Initial zoom percentage. Defaults to 100. */
+    defaultZoom?: number;
+    /**
+     * Lowest allowed zoom percentage. Defaults to 60, and is the real limit — zooming out
+     * past the point where the grid fits is allowed, so on a table that already fills its
+     * container the columns keep shrinking and the right edge pulls in from the container.
+     */
+    minZoom?: number;
+    /** Highest allowed zoom percentage. Defaults to 120. */
+    maxZoom?: number;
+    /**
+     * Increment the slider snaps to, in percentage points. Defaults to 10. Steps are measured
+     * from `minZoom`, so a step that divides the range keeps the readout on round numbers.
+     * Set to 1 for continuous dragging.
+     */
+    step?: number;
+};
 export type TableWrapperToolbarConfig = {
     sort?: LegacySortToolConfig;
     filter?: LegacyFilterToolConfig;
@@ -137,6 +172,8 @@ export type TableWrapperProps = {
     labelMeta?: unknown;
     toolbarSlot?: ReactNode;
     fillWidth?: boolean;
+    /** Enables compact column zoom controls and calculated column widths. */
+    zoom?: TableZoomConfig;
     rowActions?: RowActionsConfig;
     onCellActivate?: (info: {
         rowId: string;

package/dist/patterns/table/types.d.ts.map

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

package/dist/patterns/table/useGridKeyboardNavigation.d.ts

@@ -1,5 +1,9 @@
 import { ReactNode, RefObject } from 'react';
 export type GridNavDirection = "up" | "down" | "left" | "right";
+/** Options for moving grid focus; `dir` lets the scroll align the edge being travelled toward. */
+export type FocusGridCellOptions = {
+    dir?: GridNavDirection | null;
+};
 export interface GridNeighbor {
     rowId: string;
     columnKey: string;
@@ -9,7 +13,7 @@ export interface GridNeighbor {
 export interface GridNavValue {
     getNeighbor: (rowId: string, columnKey: string, dir: GridNavDirection) => GridNeighbor | null;
     getTabNeighbor: (rowId: string, columnKey: string, forward: boolean) => GridNeighbor | null;
-    focusCell: (rowId: string, columnKey: string) => boolean;
+    focusCell: (rowId: string, columnKey: string, options?: FocusGridCellOptions) => boolean;
     selectCell: (rowId: string, columnKey: string, sourceIndex?: number | null) => void;
     setEditingCell: (cell: {
         rowId: string;
@@ -21,8 +25,15 @@ export declare const isWithinCellEditor: (target: EventTarget | null) => boolean
 export declare const findGridCell: (container: HTMLElement | null, rowId: string, columnKey: string) => HTMLElement | null;
 export declare const getGridNeighbor: (container: HTMLElement | null, rowIds: readonly string[], columnKeys: readonly string[], rowId: string, columnKey: string, dir: GridNavDirection) => GridNeighbor | null;
 export declare const getGridTabNeighbor: (container: HTMLElement | null, rowIds: readonly string[], columnKeys: readonly string[], rowId: string, columnKey: string, forward: boolean) => GridNeighbor | null;
-export declare const focusGridCellElement: (cell: HTMLElement | null) => boolean;
-export declare const focusGridCell: (container: HTMLElement | null, rowId: string, columnKey: string) => boolean;
+/**
+ * Focus a cell and bring it fully into view.
+ *
+ * The implicit scroll from `focus()` is suppressed: it targets the inner focus wrapper and ignores
+ * sticky chrome, so it leaves the cell's padding and range border clipped. `scrollGridCellIntoView`
+ * scrolls the `<td>` itself, accounting for the sticky header and sticky columns.
+ */
+export declare const focusGridCellElement: (cell: HTMLElement | null, options?: FocusGridCellOptions) => boolean;
+export declare const focusGridCell: (container: HTMLElement | null, rowId: string, columnKey: string, options?: FocusGridCellOptions) => boolean;
 export declare const GridNavProvider: ({ rowIds, columnKeys, containerRef, onSelectCell, onEditingCellChange, children, }: {
     rowIds: string[];
     columnKeys: string[];

package/dist/patterns/table/useGridKeyboardNavigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGridKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/useGridKeyboardNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAExG,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,KAAK,YAAY,GAAG,IAAI,CAAC;IAC9F,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,YAAY,GAAG,IAAI,CAAC;IAC5F,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACpF,cAAc,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;CAC7E;AAOD,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,GAAI,QAAQ,WAAW,GAAG,IAAI,KAAG,OAO/D,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,WAAW,WAAW,GAAG,IAAI,EAC7B,OAAO,MAAM,EACb,WAAW,MAAM,KAChB,WAAW,GAAG,IAAqF,CAAC;AA4BvG,eAAO,MAAM,eAAe,GAC1B,WAAW,WAAW,GAAG,IAAI,EAC7B,QAAQ,SAAS,MAAM,EAAE,EACzB,YAAY,SAAS,MAAM,EAAE,EAC7B,OAAO,MAAM,EACb,WAAW,MAAM,EACjB,KAAK,gBAAgB,KACpB,YAAY,GAAG,IAajB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,WAAW,WAAW,GAAG,IAAI,EAC7B,QAAQ,SAAS,MAAM,EAAE,EACzB,YAAY,SAAS,MAAM,EAAE,EAC7B,OAAO,MAAM,EACb,WAAW,MAAM,EACjB,SAAS,OAAO,KACf,YAAY,GAAG,IAgBjB,CAAC;AAKF,eAAO,MAAM,oBAAoB,GAAI,MAAM,WAAW,GAAG,IAAI,KAAG,OAK/D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,WAAW,WAAW,GAAG,IAAI,EAAE,OAAO,MAAM,EAAE,WAAW,MAAM,KAAG,OAC/B,CAAC;AAElE,eAAO,MAAM,eAAe,GAAI,oFAO7B;IACD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACtF,mBAAmB,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACjF,QAAQ,EAAE,SAAS,CAAC;CACrB,4CA8BA,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAO,YAAY,GAAG,IAAkC,CAAC"}
+{"version":3,"file":"useGridKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/useGridKeyboardNavigation.tsx"],"names":[],"mappings":"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"}

package/dist/patterns/table/useGridKeyboardNavigation.js

@@ -1,65 +1,66 @@
 import { jsx as C } from "react/jsx-runtime";
-import { useContext as h, useCallback as g, useMemo as p, createContext as G } from "react";
-const x = G(null), S = (e, t) => `[data-grid-cell][data-grid-row-id="${CSS.escape(e)}"][data-grid-col-key="${CSS.escape(t)}"]`, q = (e) => e instanceof HTMLElement ? !!(e.closest('[contenteditable]:not([contenteditable="false"])') || e.closest("input, textarea, select") || e.closest('[role="textbox"]')) : !1, b = (e, t, r) => (e == null ? void 0 : e.querySelector(S(t, r))) ?? null, N = (e, t, r, u, c) => {
-  if (u < 0 || u >= t.length || c < 0 || c >= r.length) return null;
-  const s = t[u], i = r[c], l = b(e, s, i);
-  if (!l) return null;
-  const n = l.getAttribute("data-grid-source-index"), o = n != null && n !== "" ? Number(n) : NaN;
+import { useContext as p, useCallback as g, useMemo as h, createContext as G } from "react";
+import { scrollGridCellIntoView as S } from "./scrollCellIntoView.js";
+const x = G(null), v = (e, r) => `[data-grid-cell][data-grid-row-id="${CSS.escape(e)}"][data-grid-col-key="${CSS.escape(r)}"]`, M = (e) => e instanceof HTMLElement ? !!(e.closest('[contenteditable]:not([contenteditable="false"])') || e.closest("input, textarea, select") || e.closest('[role="textbox"]')) : !1, b = (e, r, t) => (e == null ? void 0 : e.querySelector(v(r, t))) ?? null, N = (e, r, t, l, c) => {
+  if (l < 0 || l >= r.length || c < 0 || c >= t.length) return null;
+  const s = r[l], u = t[c], i = b(e, s, u);
+  if (!i) return null;
+  const n = i.getAttribute("data-grid-source-index"), o = n != null && n !== "" ? Number(n) : NaN;
   return {
     rowId: s,
-    columnKey: i,
+    columnKey: u,
     sourceIndex: Number.isNaN(o) ? null : o,
-    element: l
+    element: i
   };
-}, v = (e, t, r, u, c, s) => {
-  const i = t.indexOf(u), l = r.indexOf(c);
-  if (i === -1 || l === -1) return null;
-  let n = i, o = l;
-  return s === "up" ? n -= 1 : s === "down" ? n += 1 : s === "left" ? o -= 1 : s === "right" && (o += 1), N(e, t, r, n, o);
-}, m = (e, t, r, u, c, s) => {
-  const i = t.indexOf(u), l = r.indexOf(c);
-  if (i === -1 || l === -1) return null;
-  let n = i, o = l + (s ? 1 : -1);
-  return o >= r.length ? (o = 0, n += 1) : o < 0 && (o = r.length - 1, n -= 1), N(e, t, r, n, o);
-}, I = (e) => (e == null ? void 0 : e.querySelector("[data-grid-focus]")) ?? e, O = (e) => {
-  const t = I(e);
-  return !t || typeof t.focus != "function" ? !1 : (t.focus(), !0);
-}, T = (e, t, r) => O(b(e, t, r)), M = ({
+}, m = (e, r, t, l, c, s) => {
+  const u = r.indexOf(l), i = t.indexOf(c);
+  if (u === -1 || i === -1) return null;
+  let n = u, o = i;
+  return s === "up" ? n -= 1 : s === "down" ? n += 1 : s === "left" ? o -= 1 : s === "right" && (o += 1), N(e, r, t, n, o);
+}, I = (e, r, t, l, c, s) => {
+  const u = r.indexOf(l), i = t.indexOf(c);
+  if (u === -1 || i === -1) return null;
+  let n = u, o = i + (s ? 1 : -1);
+  return o >= t.length ? (o = 0, n += 1) : o < 0 && (o = t.length - 1, n -= 1), N(e, r, t, n, o);
+}, O = (e) => (e == null ? void 0 : e.querySelector("[data-grid-focus]")) ?? e, T = (e, r = {}) => {
+  const t = O(e);
+  return !t || typeof t.focus != "function" ? !1 : (t.focus({ preventScroll: !0 }), S(e, { dir: r.dir ?? null }), !0);
+}, E = (e, r, t, l = {}) => T(b(e, r, t), l), P = ({
   rowIds: e,
-  columnKeys: t,
-  containerRef: r,
-  onSelectCell: u,
+  columnKeys: r,
+  containerRef: t,
+  onSelectCell: l,
   onEditingCellChange: c,
   children: s
 }) => {
-  const i = g(
-    (d, f, a) => v(r.current, e, t, d, f, a),
-    [r, e, t]
-  ), l = g(
-    (d, f, a) => m(r.current, e, t, d, f, a),
-    [r, e, t]
+  const u = g(
+    (d, f, a) => m(t.current, e, r, d, f, a),
+    [t, e, r]
+  ), i = g(
+    (d, f, a) => I(t.current, e, r, d, f, a),
+    [t, e, r]
   ), n = g(
-    (d, f) => T(r.current, d, f),
-    [r]
-  ), o = p(
+    (d, f, a) => E(t.current, d, f, a),
+    [t]
+  ), o = h(
     () => ({
-      getNeighbor: i,
-      getTabNeighbor: l,
+      getNeighbor: u,
+      getTabNeighbor: i,
       focusCell: n,
-      selectCell: u,
+      selectCell: l,
       setEditingCell: c
     }),
-    [i, l, n, u, c]
+    [u, i, n, l, c]
   );
   return /* @__PURE__ */ C(x.Provider, { value: o, children: s });
-}, P = () => h(x);
+}, $ = () => p(x);
 export {
-  M as GridNavProvider,
+  P as GridNavProvider,
   b as findGridCell,
-  T as focusGridCell,
-  O as focusGridCellElement,
-  v as getGridNeighbor,
-  m as getGridTabNeighbor,
-  q as isWithinCellEditor,
-  P as useGridKeyboardNavigation
+  E as focusGridCell,
+  T as focusGridCellElement,
+  m as getGridNeighbor,
+  I as getGridTabNeighbor,
+  M as isWithinCellEditor,
+  $ as useGridKeyboardNavigation
 };