@pibit.ai/cure-design-system 0.4.0 → 0.5.2

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

@@ -0,0 +1,168 @@
+import { applyTableUndoSnapshot as f, captureTableUndoSnapshot as h } from "../tableUndoRedo.js";
+const A = /* @__PURE__ */ new Set(["left", "center", "right"]), w = /* @__PURE__ */ new Set(["small", "medium", "large", "xl"]);
+function l(o) {
+  return typeof o == "object" && o !== null && !Array.isArray(o);
+}
+function u(o) {
+  return (o ?? []).filter((n) => n.field !== "" && n.direction !== "").map((n) => ({ field: n.field, direction: n.direction }));
+}
+function g(o) {
+  return (o ?? []).map((n) => ({ ...n }));
+}
+function y(o) {
+  const n = {};
+  if (!o) return n;
+  for (const [r, e] of Object.entries(o))
+    A.has(e) && (n[r] = e);
+  return n;
+}
+function c(o) {
+  return Object.fromEntries(
+    Object.entries(o).sort(([n], [r]) => n.localeCompare(r))
+  );
+}
+function C(o) {
+  if (!l(o)) return {};
+  const n = {};
+  for (const [r, e] of Object.entries(o))
+    (e === "left" || e === "center" || e === "right") && (n[r] = e);
+  return n;
+}
+function t(o) {
+  return typeof o == "number" && Number.isFinite(o) ? o : void 0;
+}
+function S(o) {
+  return typeof o == "string" && w.has(o) ? o : void 0;
+}
+function p(o) {
+  return l(o) ? { ...o } : {};
+}
+function H(o) {
+  return {
+    sorts: [],
+    filterConditions: [],
+    hiddenColumns: [],
+    columnOrder: o ? [...o] : void 0,
+    columnAlignments: {},
+    groupBy: null,
+    showSummary: !1,
+    summaryAggregations: {},
+    rowHeight: "small"
+  };
+}
+function z(o) {
+  var d, a;
+  const n = h(o), r = {};
+  (d = n.columnAlignments) == null || d.forEach((i, m) => {
+    r[m] = i;
+  });
+  const e = {};
+  return (a = n.summaryAggregations) == null || a.forEach((i, m) => {
+    e[m] = i;
+  }), {
+    sorts: u(n.sorts),
+    filterConditions: g(n.filterConditions),
+    hiddenColumns: [...n.hiddenColumns ?? []].sort(),
+    columnOrder: n.columnOrder ? [...n.columnOrder] : void 0,
+    columnAlignments: r,
+    groupBy: n.groupBy ?? null,
+    showSummary: n.showSummary ?? !1,
+    summaryAggregations: e,
+    rowHeight: n.rowHeight ?? "small",
+    zoom: o.zoom
+  };
+}
+function s(o) {
+  return {
+    sorts: u(o.sorts),
+    filterConditions: g(o.filterConditions),
+    hiddenColumns: [...o.hiddenColumns ?? []].sort(),
+    columnOrder: o.columnOrder ? [...o.columnOrder] : void 0,
+    columnAlignments: c(y(o.columnAlignments)),
+    groupBy: o.groupBy ?? null,
+    showSummary: !!o.showSummary,
+    summaryAggregations: c(o.summaryAggregations ?? {}),
+    rowHeight: o.rowHeight ?? "small",
+    zoom: o.zoom,
+    layout_key: o.layout_key
+  };
+}
+function _(o, n) {
+  const r = s(o), e = s(n);
+  return JSON.stringify({
+    sorts: r.sorts,
+    filterConditions: r.filterConditions,
+    hiddenColumns: r.hiddenColumns,
+    columnOrder: r.columnOrder,
+    columnAlignments: r.columnAlignments,
+    groupBy: r.groupBy,
+    showSummary: r.showSummary,
+    summaryAggregations: r.summaryAggregations,
+    rowHeight: r.rowHeight,
+    zoom: r.zoom
+  }) !== JSON.stringify({
+    sorts: e.sorts,
+    filterConditions: e.filterConditions,
+    hiddenColumns: e.hiddenColumns,
+    columnOrder: e.columnOrder,
+    columnAlignments: e.columnAlignments,
+    groupBy: e.groupBy,
+    showSummary: e.showSummary,
+    summaryAggregations: e.summaryAggregations,
+    rowHeight: e.rowHeight,
+    zoom: e.zoom
+  });
+}
+function O(o) {
+  const n = y(o.columnAlignments);
+  return {
+    hiddenColumns: new Set(o.hiddenColumns ?? []),
+    columnOrder: o.columnOrder ? [...o.columnOrder] : void 0,
+    columnAlignments: new Map(Object.entries(n)),
+    groupBy: o.groupBy ?? null,
+    showSummary: o.showSummary ?? !1,
+    summaryAggregations: o.summaryAggregations ? new Map(Object.entries(o.summaryAggregations)) : /* @__PURE__ */ new Map(),
+    rowHeight: o.rowHeight ?? "small",
+    sorts: u(o.sorts),
+    filterConditions: g(o.filterConditions)
+  };
+}
+function k(o, n) {
+  f(O(o), n), o.zoom != null && n.onZoomChange && n.onZoomChange(o.zoom);
+}
+function b(o) {
+  const n = o, r = l(n.snapshot) ? n.snapshot : n, e = t(r.zoom) ?? t(r.Zoom) ?? t(n.zoom) ?? t(n.Zoom);
+  return s({
+    layout_key: typeof r.layout_key == "string" ? r.layout_key : typeof n.layout_key == "string" ? n.layout_key : void 0,
+    sorts: Array.isArray(r.sorts) ? r.sorts : [],
+    filterConditions: Array.isArray(r.filterConditions) ? r.filterConditions : [],
+    hiddenColumns: Array.isArray(r.hiddenColumns) ? r.hiddenColumns : [],
+    columnOrder: Array.isArray(r.columnOrder) ? r.columnOrder : void 0,
+    columnAlignments: C(r.columnAlignments),
+    groupBy: r.groupBy === void 0 ? null : r.groupBy,
+    showSummary: !!r.showSummary,
+    summaryAggregations: p(r.summaryAggregations),
+    rowHeight: S(r.rowHeight),
+    zoom: e
+  });
+}
+function T(o) {
+  const n = b(o), r = o.kind === "shared" ? "shared" : "owned";
+  return {
+    ...n,
+    id: String(o.id ?? ""),
+    name: String(o.name ?? "Untitled view"),
+    kind: r,
+    owner_id: typeof o.owner_id == "string" ? o.owner_id : void 0,
+    shared_with: Array.isArray(o.shared_with) ? o.shared_with : void 0
+  };
+}
+export {
+  k as applyTableViewSnapshot,
+  H as getInitialTableViewSnapshot,
+  _ as isTableViewDirty,
+  s as normalizeTableViewSnapshot,
+  T as parseTableSavedViewRecord,
+  b as snapshotFromViewRecord,
+  z as toTableViewSnapshot
+};

package/dist/patterns/table/toolbar/tableViewSnapshot.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tableViewSnapshot.test.d.ts.map

package/dist/patterns/table/toolbar/tableViewSnapshot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableViewSnapshot.test.d.ts","sourceRoot":"","sources":["../../../../src/patterns/table/toolbar/tableViewSnapshot.test.ts"],"names":[],"mappings":""}

package/dist/patterns/table/toolbar/tableViewTypes.d.ts

@@ -0,0 +1,75 @@
+import { LegacyFilterCondition, LegacySort } from './legacyToolbarTypes';
+import { RowHeightOption } from './RowHeightDropdown';
+import { AggregationType, CellAlignment } from './tableToolbarHelpers';
+/** Synthetic, non-persisted item used to restore the initial table state. */
+export declare const DEFAULT_TABLE_VIEW_ID = "default";
+export type TableViewKind = "default" | "owned" | "shared";
+/** Which dirty chrome the toolbar should render. Computed by the consumer. */
+export type TableViewDirtyAction = "none" | "save" | "update";
+/**
+ * JSON-serializable toolbar snapshot stored on a saved view.
+ * Matches the flattened view payload (sorts / filters / hide / …) used by
+ * submission-overview table views. Search is intentionally omitted.
+ */
+export type TableViewSnapshot = {
+    layout_key?: string;
+    sorts?: LegacySort[];
+    filterConditions?: LegacyFilterCondition[];
+    hiddenColumns?: string[];
+    columnOrder?: string[];
+    columnAlignments?: Record<string, CellAlignment>;
+    groupBy?: string | null;
+    showSummary?: boolean;
+    summaryAggregations?: Record<string, AggregationType>;
+    rowHeight?: RowHeightOption;
+    /** Serialized as `Zoom` on some payloads. */
+    zoom?: number;
+};
+export type TableViewSharee = {
+    id: string;
+    kind: "user" | "team";
+    name?: string;
+};
+export type TableSavedViewRecord = TableViewSnapshot & {
+    id: string;
+    name: string;
+    kind: "owned" | "shared";
+    owner_id?: string;
+    shared_with?: TableViewSharee[];
+};
+export type TableViewsByTableName = Record<string, {
+    views: TableSavedViewRecord[];
+}>;
+export type TableViewListItem = {
+    id: string;
+    name: string;
+    kind: TableViewKind;
+    isDefault?: boolean;
+};
+export type TableViewsConfig = {
+    items: TableViewListItem[];
+    /** Undefined when the table is showing its unsaved, initial state. */
+    selectedId?: string;
+    dirtyAction: TableViewDirtyAction;
+    onSelect: (id: string) => void;
+    /** Restores the consumer-managed, unsaved initial table state. It is never persisted. */
+    onSelectInitial?: () => void;
+    /** Whether the consumer has made the virtual System View its default. */
+    initialViewIsDefault?: boolean;
+    initialViewLabel?: string;
+    onSaveClick: () => void;
+    onRevertClick?: () => void;
+    onUpdateClick?: () => void;
+    onRename?: (id: string) => void;
+    onShare?: (id: string) => void;
+    onMakeDefault?: (id: string) => void;
+    onDelete?: (id: string) => void;
+};
+export type SaveTableViewRequest = TableViewSnapshot & {
+    layout_key: string;
+    tableName: string;
+    name: string;
+    shareUserIds: string[];
+    shareTeamIds: string[];
+};
+//# sourceMappingURL=tableViewTypes.d.ts.map

package/dist/patterns/table/toolbar/tableViewTypes.d.ts.map

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

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

@@ -0,0 +1,4 @@
+const t = "default";
+export {
+  t as DEFAULT_TABLE_VIEW_ID
+};

package/dist/patterns/table/toolbar/useUndoRedoShortcuts.d.ts

@@ -0,0 +1,9 @@
+export declare function useUndoRedoShortcuts(options: {
+    enabled?: boolean;
+    canUndo: boolean;
+    canRedo: boolean;
+    onUndo: () => void;
+    onRedo: () => void;
+    isDisabled?: boolean;
+}): void;
+//# sourceMappingURL=useUndoRedoShortcuts.d.ts.map

package/dist/patterns/table/toolbar/useUndoRedoShortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUndoRedoShortcuts.d.ts","sourceRoot":"","sources":["../../../../src/patterns/table/toolbar/useUndoRedoShortcuts.ts"],"names":[],"mappings":"AAUA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CA6BP"}

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

@@ -0,0 +1,21 @@
+import { useEffect as l } from "react";
+function y(t) {
+  if (!(t instanceof HTMLElement)) return !1;
+  const o = t.tagName;
+  return !!(o === "INPUT" || o === "TEXTAREA" || o === "SELECT" || t.isContentEditable);
+}
+function m(t) {
+  const { enabled: o = !0, canUndo: r, canRedo: s, onUndo: i, onRedo: a, isDisabled: u = !1 } = t;
+  l(() => {
+    if (!o || u) return;
+    const d = (e) => {
+      if (y(e.target) || !(e.metaKey || e.ctrlKey) || e.altKey) return;
+      const n = e.key.toLowerCase(), f = n === "z" && !e.shiftKey, c = n === "z" && e.shiftKey || n === "y";
+      f && r ? (e.preventDefault(), e.stopPropagation(), i()) : c && s && (e.preventDefault(), e.stopPropagation(), a());
+    };
+    return window.addEventListener("keydown", d, { capture: !0 }), () => window.removeEventListener("keydown", d, { capture: !0 });
+  }, [o, u, r, s, i, a]);
+}
+export {
+  m as useUndoRedoShortcuts
+};

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

@@ -1,7 +1,11 @@
 import { ReactNode } from 'react';
 import { TablePaginationConfig } from './TablePagination';
-import { AlignToolConfig, GroupByToolConfig, HideFieldsToolConfig, RowHeightToolConfig, SearchToolConfig, SummaryToolConfig, CellAlignment, ColumnMenuAction, ColumnMenuCapabilities, RowActionsConfig, RowGroup, SummaryFooterRowProps } from './toolbar';
+import { UndoRedoToolConfig } from './toolbar/TableToolbar';
+import { TableViewsConfig } from './toolbar/tableViewTypes';
 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';
 /** Value type used for alignment defaults and aggregation eligibility. */
 export type TableColumnValueType = "string" | "number" | "currency" | "date" | "percentage" | "decimal_percentage" | "array" | "link";
 /**
@@ -31,6 +35,60 @@ 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.
+ * Text grows gradually as the user zooms out (14px just below 100%, up to 18px
+ * at 60%) and then holds at 18px, so 51% / 20% / 10% cannot inflate glyphs past
+ * what fits in a compact row. At 100% and above, authored font sizes are preserved.
+ *
+ * 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. The last chosen zoom is remembered across remounts
+ * (for example entering edit mode) using an explicit `persistKey`.
+ * The zoom menu always offers Actual Size at 100% (when that value is inside the configured
+ * range) and Fit Whole Table, which remasures after the first snap so a single click
+ * reaches the largest allowed slider stop that actually fits.
+ */
+export type TableZoomConfig = {
+    /** Initial zoom percentage. Defaults to 100. */
+    defaultZoom?: number;
+    /**
+     * Controlled zoom percentage. Pair with `onZoomChange`. When omitted, the table keeps
+     * the value internally and restores it after remount via `persistKey`.
+     */
+    value?: number;
+    /** Fired whenever the user changes zoom (slider, Actual Size, or Fit Whole Table). */
+    onZoomChange?: (zoom: number) => void;
+    /**
+     * Stable id used to remember this table's zoom across remounts (for example edit mode).
+     * Use a different key for every independently zoomable table.
+     */
+    persistKey?: string;
+    /**
+     * 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;
@@ -44,6 +102,12 @@ export type TableWrapperToolbarConfig = {
     sortContent?: ReactNode;
     /** Consumer-rendered filter UI. Required for filter popover content when `filter` is configured. */
     filterContent?: ReactNode;
+    /** Consumer-owned undo/redo state — renders toolbar buttons and keyboard shortcuts when provided. */
+    undoRedo?: UndoRedoToolConfig;
+    /**
+     * Saved-view chrome. Consumer owns list/dirty/API; TableWrapper only forwards this to TableToolbar.
+     */
+    views?: TableViewsConfig;
 };
 /** Controlled selection value for TableWrapper (`"all"` = every row in the current body). */
 export type TableWrapperSelectedKeys = "all" | ReadonlySet<string>;
@@ -68,6 +132,7 @@ export type ColumnConfig = {
     sticky?: "left" | "right";
     stickyOffset?: number;
     allowsSorting?: boolean;
+    width?: string;
     maxWidth?: string;
     minWidth?: string;
     headClassName?: string;
@@ -79,6 +144,7 @@ export type TableWrapperProps = {
     columns: ColumnConfig[];
     renderRowCell: (key: string, val: any, item: any) => ReactNode;
     onRowClick?: (item: any) => void;
+    onRowHover?: (item: any, isHovered: boolean) => void;
     arialabel?: string;
     size?: "sm" | "md" | "xs";
     allowDefaultRowClass?: boolean;
@@ -108,6 +174,8 @@ export type TableWrapperProps = {
     showEditActions?: boolean;
     searchCollapsible?: boolean;
     disableExtendedTools?: boolean;
+    /** When false, the toolbar shows only Sort, Filter, Hide Fields, Align, and Zoom. */
+    isEditMode?: boolean;
     isEditable?: boolean;
     rowHeightClass?: string;
     groupedData?: RowGroup<Record<string, unknown>>[];
@@ -130,6 +198,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;
@@ -137,5 +207,32 @@ export type TableWrapperProps = {
         sourceIndex: number | null;
     }) => void;
     renderColumnHeaderMenuExtraItems?: (column: TableColumnMenuSchema) => ReactNode;
+    /**
+     * Controlled Excel-style rectangular cell selection. Opt-in: pass both
+     * `cellSelection` and `onCellSelectionChange` (typically only in edit mode).
+     * When set, enables drag / Shift+click / Shift+arrow range selection and
+     * Cmd/Ctrl+C·V hooks via `onCopyCells` / `onPasteCells`.
+     */
+    cellSelection?: TableCellSelection | null;
+    onCellSelectionChange?: (selection: TableCellSelection | null) => void;
+    /** Fired on copy when a cell range is selected (not while editing a cell). */
+    onCopyCells?: (payload: {
+        selection: TableCellSelection;
+        rect: TableCellRangeRect;
+        event: ClipboardEvent;
+    }) => void;
+    /** Fired on paste when a cell range is selected (not while editing a cell). */
+    onPasteCells?: (payload: {
+        selection: TableCellSelection;
+        rect: TableCellRangeRect;
+        text: string;
+        event: ClipboardEvent;
+    }) => void;
+    /** Fired on Delete/Backspace when a cell range is selected (not while editing a cell). */
+    onClearCells?: (payload: {
+        selection: TableCellSelection;
+        rect: TableCellRangeRect;
+        event: KeyboardEvent;
+    }) => void;
 };
 //# sourceMappingURL=types.d.ts.map

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/useFitTableToViewport.d.ts

@@ -0,0 +1,15 @@
+import { Dispatch, RefObject, SetStateAction } from 'react';
+type ZoomRange = {
+    minZoom: number;
+    maxZoom: number;
+    step: number;
+};
+/** Applies Fit Whole Table until the measured painted table fits its scroll viewport. */
+export declare const useFitTableToViewport: ({ containerRef, zoomConfig, zoomPercent, setZoomPercent, }: {
+    containerRef: RefObject<HTMLElement | null>;
+    zoomConfig: ZoomRange | null;
+    zoomPercent: number;
+    setZoomPercent: Dispatch<SetStateAction<number>>;
+}) => () => void;
+export {};
+//# sourceMappingURL=useFitTableToViewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFitTableToViewport.d.ts","sourceRoot":"","sources":["../../../src/patterns/table/useFitTableToViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,OAAO,CAAC;AAGf,KAAK,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,GAAI,4DAKnC;IACD,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,UAAU,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CAClD,eAmDA,CAAC"}

package/dist/patterns/table/useFitTableToViewport.js

@@ -0,0 +1,47 @@
+import { useRef as d, useCallback as b, useLayoutEffect as p } from "react";
+import { computeFitTableZoom as a, SCROLL_EPSILON_PX as h } from "./tableZoomLayout.js";
+const x = ({
+  containerRef: l,
+  zoomConfig: e,
+  zoomPercent: u,
+  setZoomPercent: i
+}) => {
+  const s = d(!1), n = b(() => {
+    const t = l.current, r = t == null ? void 0 : t.querySelector("table");
+    !t || !r || !e || (s.current = !0, i(
+      a(
+        t.clientWidth,
+        r.getBoundingClientRect().width,
+        u,
+        e.minZoom,
+        e.maxZoom,
+        e.step
+      )
+    ));
+  }, [l, i, e, u]);
+  return p(() => {
+    if (!s.current || !e) return;
+    const t = l.current, r = t == null ? void 0 : t.querySelector("table");
+    if (!t || !r) return;
+    if (r.getBoundingClientRect().width <= t.clientWidth + h) {
+      s.current = !1;
+      return;
+    }
+    const c = a(
+      t.clientWidth,
+      r.getBoundingClientRect().width,
+      u,
+      e.minZoom,
+      e.maxZoom,
+      e.step
+    );
+    if (c >= u) {
+      s.current = !1;
+      return;
+    }
+    i(c);
+  }, [l, i, e, u]), n;
+};
+export {
+  x as useFitTableToViewport
+};

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