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

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

@@ -10,7 +10,8 @@ export { TOOLBAR_ICONS } from './toolbar-icons';
 export type { TableColumnSchema, TableColumnMenuSchema, TableColumnValueType } from './types';
 export { TableToolbar, pickCoreToolbarProps, registerToolbarExtensions, getToolbarExtensions, RowHeightDropdown, HideFieldsDropdown, AlignDropdown, GroupByDropdown, ShowSummaryDropdown, SummaryFooterRow, ColumnHeaderMenu, RowActionsMenu, BulkActionBar, applyHideAndReorder, getDefaultAlignmentForType, getEffectiveAlignment, alignmentClass, getAggregationsForType, computeAggregation, groupRows, resolveColumnLabel, resolveSummaryDisplayValueType, ROW_HEIGHT_CLASS, AGGREGATION_LABELS, } from './toolbar';
 export type { SearchToolConfig, SortToolConfig, FilterToolConfig, RowHeightToolConfig, HideFieldsToolConfig, AlignToolConfig, GroupByToolConfig, SummaryToolConfig, UndoRedoToolConfig, ToolbarExtensionComponents, LegacySortToolConfig, LegacyFilterToolConfig, RowHeightOption, SummaryFooterRowProps, ColumnMenuAction, ColumnMenuCapabilities, RowActionsConfig, CellAlignment, AggregationType, AggregationOption, RowGroup, } from './toolbar';
-export { GridNavProvider, useGridKeyboardNavigation, isWithinCellEditor, findGridCell, focusGridCell, getGridNeighbor, getGridTabNeighbor, type GridNavDirection, type GridNeighbor, type GridNavValue, } from './useGridKeyboardNavigation';
+export { GridNavProvider, useGridKeyboardNavigation, isWithinCellEditor, findGridCell, focusGridCell, getGridNeighbor, getGridTabNeighbor, type FocusGridCellOptions, type GridNavDirection, type GridNeighbor, type GridNavValue, } from './useGridKeyboardNavigation';
+export { CELL_SCROLL_PADDING_PX, computeCellScrollDelta, getAxisScrollParent, getScrollportRect, measureStickyInsets, scrollGridCellIntoView, type CellScrollDelta, type EdgeRect, type GridScrollDirection, type StickyInsets, } from './scrollCellIntoView';
 export { TableUndoRedoProvider, useTableUndoRedo, useTableUndoRedoScope, MAX_HISTORY, wrapColumnHeaderActionWithUndoRedo, wrapEditChromeWithUndoRedo, wrapRowActionsWithUndoRedo, wrapSummaryFooterWithUndoRedo, wrapToolbarWithUndoRedo, type TableUndoRedoRegistration, type TableUndoRedoScopeApi, type TableUndoRedoState, type TableUndoSnapshot, } from './useTableUndoRedo';
 export { useIntegrateTableUndoRedo, type IntegrateTableUndoRedoOptions, type IntegrateTableUndoRedoResult, } from './integrateTableUndoRedo';
 export { applyTableUndoSnapshot, captureTableUndoSnapshot, } from './tableUndoRedo';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,YAAY,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,2BAA2B,EAC3B,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,8BAA8B,EAC9B,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,kCAAkC,EAClC,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,+BAA+B,GACrC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,48 @@
+/**
+ * Keeps the active/focus cell fully visible while a range is being selected.
+ *
+ * The browser's implicit scroll from `element.focus()` is not enough here: it targets the inner
+ * focus wrapper (so cell padding and the 2px range border stay clipped) and it ignores sticky
+ * overlays, parking the cell underneath the sticky header or a sticky first/last column.
+ */
+export type GridScrollDirection = "up" | "down" | "left" | "right";
+/** Gap kept between the cell and the visible edge so the range border is never flush/clipped. */
+export declare const CELL_SCROLL_PADDING_PX = 4;
+/** Widths/heights of the sticky overlays covering each edge of a scrollport. */
+export type StickyInsets = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type EdgeRect = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+};
+export type CellScrollDelta = {
+    dx: number;
+    dy: number;
+};
+export declare const NO_STICKY_INSETS: StickyInsets;
+/** Nearest ancestor (self included) that actually scrolls on `axis`, else the page scroller. */
+export declare const getAxisScrollParent: (start: HTMLElement | null, axis: "x" | "y") => HTMLElement | null;
+/** Visible box of a scroller: the page scroller's box is the viewport, not its full content. */
+export declare const getScrollportRect: (scroller: HTMLElement) => EdgeRect;
+/**
+ * How far sticky chrome (header row, sticky columns) intrudes on each edge of `port`.
+ *
+ * A sticky element only counts while it is actually parked against that edge — once it has
+ * scrolled away with its scrollport it covers nothing, and the clamped arithmetic returns 0.
+ */
+export declare const measureStickyInsets: (port: EdgeRect, cell: HTMLElement) => StickyInsets;
+/** Scroll deltas that bring the whole cell inside `port` minus its sticky overlays. */
+export declare const computeCellScrollDelta: (cell: EdgeRect, port: EdgeRect, insets?: StickyInsets, dir?: GridScrollDirection | null, padding?: number) => CellScrollDelta;
+export declare const scrollGridCellIntoView: (cell: HTMLElement | null, options?: {
+    dir?: GridScrollDirection | null;
+    padding?: number;
+}) => void;
+//# sourceMappingURL=scrollCellIntoView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollCellIntoView.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/scrollCellIntoView.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,eAAO,MAAM,gBAAgB,EAAE,YAK9B,CAAC;AA6BF,gGAAgG;AAChG,eAAO,MAAM,mBAAmB,GAC9B,OAAO,WAAW,GAAG,IAAI,EACzB,MAAM,GAAG,GAAG,GAAG,KACd,WAAW,GAAG,IAchB,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,GAAI,UAAU,WAAW,KAAG,QAOzD,CAAC;AAUF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,QAAQ,EACd,MAAM,WAAW,KAChB,YA2CF,CAAC;AAgCF,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,GACjC,MAAM,QAAQ,EACd,MAAM,QAAQ,EACd,SAAQ,YAA+B,EACvC,MAAK,mBAAmB,GAAG,IAAW,EACtC,UAAS,MAA+B,KACvC,eAiBD,CAAC;AAUH,eAAO,MAAM,sBAAsB,GACjC,MAAM,WAAW,GAAG,IAAI,EACxB,UAAS;IAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,KACnE,IAyCF,CAAC"}

package/dist/patterns/table/scrollCellIntoView.js

@@ -0,0 +1,122 @@
+const R = 4, L = {
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+}, u = 1, S = /(auto|scroll|overlay)/, C = (t) => ({
+  top: t.top,
+  right: t.right,
+  bottom: t.bottom,
+  left: t.left,
+  width: t.width,
+  height: t.height
+}), b = (t, n) => {
+  const o = getComputedStyle(t), e = n === "x" ? o.overflowX : o.overflowY;
+  return S.test(e) ? n === "x" ? t.scrollWidth > t.clientWidth + u : t.scrollHeight > t.clientHeight + u : !1;
+}, p = (t) => t === document.scrollingElement || t === document.documentElement || t === document.body, g = (t, n) => {
+  let o = t;
+  for (; o; ) {
+    if (b(o, n)) return o;
+    o = o.parentElement;
+  }
+  const e = document.scrollingElement;
+  return e && (n === "x" ? e.scrollWidth > e.clientWidth + u : e.scrollHeight > e.clientHeight + u) ? e : null;
+}, a = (t) => {
+  if (p(t)) {
+    const n = window.innerWidth, o = window.innerHeight;
+    return { top: 0, right: n, bottom: o, left: 0, width: n, height: o };
+  }
+  return C(t.getBoundingClientRect());
+}, f = (t, n) => {
+  const o = getComputedStyle(t);
+  return o.position !== "sticky" ? !1 : n === "x" ? o.left !== "auto" || o.right !== "auto" : o.top !== "auto" || o.bottom !== "auto";
+}, m = (t, n) => {
+  var l;
+  const o = { ...L }, e = n.closest("table"), s = e == null ? void 0 : e.querySelector(":scope > thead");
+  if (s && f(s, "y")) {
+    const i = s.getBoundingClientRect();
+    i.top <= t.top + u && (o.top = Math.max(0, Math.min(i.bottom - t.top, t.height)));
+  }
+  const r = e == null ? void 0 : e.querySelector(":scope > tfoot");
+  if (r && f(r, "y")) {
+    const i = r.getBoundingClientRect();
+    i.bottom >= t.bottom - u && (o.bottom = Math.max(
+      0,
+      Math.min(t.bottom - i.top, t.height)
+    ));
+  }
+  const h = ((l = n.closest("tr")) == null ? void 0 : l.children) ?? [];
+  for (const i of Array.from(h)) {
+    if (!(i instanceof HTMLElement) || i === n || !f(i, "x")) continue;
+    const c = i.getBoundingClientRect();
+    c.left <= t.left + u ? o.left = Math.max(
+      o.left,
+      Math.min(c.right - t.left, t.width)
+    ) : c.right >= t.right - u && (o.right = Math.max(
+      o.right,
+      Math.min(t.right - c.left, t.width)
+    ));
+  }
+  return o;
+}, d = (t, n, o, e, s, r) => {
+  const h = e - o;
+  if (h <= 0) return 0;
+  const l = t < o - u ? t - r - o : 0, i = n > e + u ? n + r - e : 0;
+  return n - t > h ? s === "start" ? l : s === "end" ? i : n <= o || t >= e ? l || i : 0 : l !== 0 ? l : i;
+}, y = (t, n, o = L, e = null, s = 4) => ({
+  dx: d(
+    t.left,
+    t.right,
+    n.left + o.left,
+    n.right - o.right,
+    e === "left" ? "start" : e === "right" ? "end" : null,
+    s
+  ),
+  dy: d(
+    t.top,
+    t.bottom,
+    n.top + o.top,
+    n.bottom - o.bottom,
+    e === "up" ? "start" : e === "down" ? "end" : null,
+    s
+  )
+}), x = (t) => {
+  var n;
+  return ((n = t.closest("table")) == null ? void 0 : n.parentElement) ?? t.parentElement;
+}, _ = (t, n = {}) => {
+  if (!t || typeof document > "u") return;
+  const { dir: o = null, padding: e = 4 } = n, s = x(t);
+  if (!s) return;
+  const r = f(t, "x") ? null : g(s, "x"), h = f(t, "y") ? null : g(s, "y");
+  if (!r && !h) return;
+  const l = C(t.getBoundingClientRect());
+  if (r) {
+    const i = a(r), { dx: c } = y(
+      l,
+      i,
+      m(i, t),
+      o,
+      e
+    );
+    c !== 0 && (r.scrollLeft += c);
+  }
+  if (h) {
+    const i = a(h), { dy: c } = y(
+      l,
+      i,
+      m(i, t),
+      o,
+      e
+    );
+    c !== 0 && (h.scrollTop += c);
+  }
+};
+export {
+  R as CELL_SCROLL_PADDING_PX,
+  L as NO_STICKY_INSETS,
+  y as computeCellScrollDelta,
+  g as getAxisScrollParent,
+  a as getScrollportRect,
+  m as measureStickyInsets,
+  _ as scrollGridCellIntoView
+};

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
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pibit.ai/cure-design-system",
-  "version": "0.3.35",
+  "version": "0.3.37",
   "description": "CURE Design System - React component library",
   "author": "Pibit",
   "license": "MIT",