@iamsaroj/smart-ui 0.2.0

package/dist/components/tooltip.d.ts

@@ -0,0 +1,7 @@
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
+declare const TooltipProvider: ({ delay, ...props }: TooltipPrimitive.Provider.Props) => import("react/jsx-runtime").JSX.Element;
+declare const Tooltip: ({ ...props }: TooltipPrimitive.Root.Props) => import("react/jsx-runtime").JSX.Element;
+declare const TooltipTrigger: ({ ...props }: TooltipPrimitive.Trigger.Props) => import("react/jsx-runtime").JSX.Element;
+declare const TooltipContent: ({ className, side, sideOffset, align, alignOffset, children, ...props }: TooltipPrimitive.Popup.Props & Pick<TooltipPrimitive.Positioner.Props, "align" | "alignOffset" | "side" | "sideOffset">) => import("react/jsx-runtime").JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/components/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../src/components/tooltip.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAIpE,QAAA,MAAM,eAAe,GAAI,qBAGtB,gBAAgB,CAAC,QAAQ,CAAC,KAAK,4CAMjC,CAAA;AAED,QAAA,MAAM,OAAO,GAAI,cAAc,gBAAgB,CAAC,IAAI,CAAC,KAAK,4CAEzD,CAAA;AAED,QAAA,MAAM,cAAc,GAAI,cAAc,gBAAgB,CAAC,OAAO,CAAC,KAAK,4CAEnE,CAAA;AAED,QAAA,MAAM,cAAc,GAAI,yEAQrB,gBAAgB,CAAC,KAAK,CAAC,KAAK,GAC7B,IAAI,CACF,gBAAgB,CAAC,UAAU,CAAC,KAAK,EACjC,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAChD,4CAsBF,CAAA;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA"}

package/dist/components/tooltip.js

@@ -0,0 +1,10 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+const TooltipProvider = ({ delay = 0, ...props }) => (_jsx(TooltipPrimitive.Provider, { "data-slot": "tooltip-provider", delay: delay, ...props }));
+const Tooltip = ({ ...props }) => (_jsx(TooltipPrimitive.Root, { "data-slot": "tooltip", ...props }));
+const TooltipTrigger = ({ ...props }) => (_jsx(TooltipPrimitive.Trigger, { "data-slot": "tooltip-trigger", ...props }));
+const TooltipContent = ({ className, side = "top", sideOffset = 4, align = "center", alignOffset = 0, children, ...props }) => (_jsx(TooltipPrimitive.Portal, { children: _jsx(TooltipPrimitive.Positioner, { align: align, alignOffset: alignOffset, side: side, sideOffset: sideOffset, className: "isolate z-50", children: _jsxs(TooltipPrimitive.Popup, { "data-slot": "tooltip-content", className: cn("z-50 inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background has-data-[slot=kbd]:pr-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-50 **:data-[slot=kbd]:rounded-sm data-[state=delayed-open]:animate-in data-[state=delayed-open]:fade-in-0 data-[state=delayed-open]:zoom-in-95 data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95", className), ...props, children: [children, _jsx(TooltipPrimitive.Arrow, { className: "z-50 size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground data-[side=bottom]:top-1 data-[side=inline-end]:top-1/2! data-[side=inline-end]:-left-1 data-[side=inline-end]:-translate-y-1/2 data-[side=inline-start]:top-1/2! data-[side=inline-start]:-right-1 data-[side=inline-start]:-translate-y-1/2 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" })] }) }) }));
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };
+//# sourceMappingURL=tooltip.js.map

package/dist/components/tooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.js","sourceRoot":"","sources":["../../src/components/tooltip.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,EAAE,EAAE,MAAM,8BAA8B,CAAA;AAEjD,MAAM,eAAe,GAAG,CAAC,EACvB,KAAK,GAAG,CAAC,EACT,GAAG,KAAK,EACwB,EAAE,EAAE,CAAC,CACrC,KAAC,gBAAgB,CAAC,QAAQ,iBACd,kBAAkB,EAC5B,KAAK,EAAE,KAAK,KACR,KAAK,GACT,CACH,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,EAA+B,EAAE,EAAE,CAAC,CAC7D,KAAC,gBAAgB,CAAC,IAAI,iBAAW,SAAS,KAAK,KAAK,GAAI,CACzD,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,EAAE,GAAG,KAAK,EAAkC,EAAE,EAAE,CAAC,CACvE,KAAC,gBAAgB,CAAC,OAAO,iBAAW,iBAAiB,KAAK,KAAK,GAAI,CACpE,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,EACtB,SAAS,EACT,IAAI,GAAG,KAAK,EACZ,UAAU,GAAG,CAAC,EACd,KAAK,GAAG,QAAQ,EAChB,WAAW,GAAG,CAAC,EACf,QAAQ,EACR,GAAG,KAAK,EAKP,EAAE,EAAE,CAAC,CACN,KAAC,gBAAgB,CAAC,MAAM,cACtB,KAAC,gBAAgB,CAAC,UAAU,IAC1B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,UAAU,EACtB,SAAS,EAAC,cAAc,YAExB,MAAC,gBAAgB,CAAC,KAAK,iBACX,iBAAiB,EAC3B,SAAS,EAAE,EAAE,CACX,iwBAAiwB,EACjwB,SAAS,CACV,KACG,KAAK,aAER,QAAQ,EACT,KAAC,gBAAgB,CAAC,KAAK,IAAC,SAAS,EAAC,0hBAA0hB,GAAG,IACxiB,GACG,GACN,CAC3B,CAAA;AAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA"}

package/dist/data-grid/action-column-cell.d.ts

@@ -0,0 +1,41 @@
+import { type ReactElement } from "react";
+import type { ICellRendererParams } from "ag-grid-community";
+import type { DataGridColumn } from "./grid-internals";
+import { type GridActionColumnOptions } from "./action-column";
+/**
+ * Bridge between the grid component and the mounted action cells: cells read
+ * the latest options through it and subscribe to be re-rendered whenever the
+ * `actionColumn` prop changes identity (see `useGridActionColumn`).
+ */
+export interface GridActionColumnStore<TRow> {
+    /** Reads the *latest* options (ref-backed) so callbacks are never stale. */
+    getOptions: () => GridActionColumnOptions<TRow>;
+    /** Monotonic change counter — the `useSyncExternalStore` snapshot. */
+    getVersion: () => number;
+    /** Register for change notifications; returns the unsubscribe. */
+    subscribe: (listener: () => void) => () => void;
+}
+/** Extra cellRendererParams `buildActionColumnDef` wires into the renderer. */
+export interface GridActionCellParams<TRow> {
+    actionColumnStore: GridActionColumnStore<TRow>;
+}
+declare const GridActionCellInner: <TRow>(props: ICellRendererParams<TRow> & GridActionCellParams<TRow>) => ReactElement | null;
+/**
+ * Memoized action-cell renderer. AG Grid re-renders it only on
+ * `refreshCells({ force: true })` or row-data changes, keeping the column
+ * cheap across thousands of virtualized rows.
+ */
+export declare const GridActionCell: typeof GridActionCellInner;
+/**
+ * Build the injected action ColDef. The structural options (pin, width, label
+ * mode, header, exportability) are baked in; the per-row behavior flows through
+ * the `store` so the returned object can stay referentially stable (see
+ * `useGridActionColumn`).
+ *
+ * The column opts out of everything a utility column must not do: sort,
+ * filter, edit, resize (by default), move, hide, header menu, grouping /
+ * pivot / aggregation, and (by default) export.
+ */
+export declare const buildActionColumnDef: <TRow>(options: GridActionColumnOptions<TRow>, store: GridActionColumnStore<TRow>) => DataGridColumn<TRow>;
+export {};
+//# sourceMappingURL=action-column-cell.d.ts.map

package/dist/data-grid/action-column-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-column-cell.d.ts","sourceRoot":"","sources":["../../src/data-grid/action-column-cell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAQL,KAAK,uBAAuB,EAG7B,MAAM,iBAAiB,CAAA;AAqFxB;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,IAAI;IACzC,4EAA4E;IAC5E,UAAU,EAAE,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAA;IAC/C,sEAAsE;IACtE,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,kEAAkE;IAClE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB,CAAC,IAAI;IACxC,iBAAiB,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAA;CAC/C;AAED,QAAA,MAAM,mBAAmB,GAAI,IAAI,EAC/B,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAC5D,YAAY,GAAG,IAiCjB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAEtB,OAAO,mBAAmB,CAAA;AAE/B;;;;;;;;;GASG;AAEH,eAAO,MAAM,oBAAoB,GAAI,IAAI,EACvC,SAAS,uBAAuB,CAAC,IAAI,CAAC,EACtC,OAAO,qBAAqB,CAAC,IAAI,CAAC,KACjC,cAAc,CAAC,IAAI,CA8CrB,CAAA"}

package/dist/data-grid/action-column-cell.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { memo, useState, useSyncExternalStore } from "react";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { ActionButton } from "@iamsaroj/smart-ui/smart-components/buttons";
+import { SmartConfirmDialog } from "@iamsaroj/smart-ui/smart-components/smart-confirm-dialog";
+import { ACTION_COLUMN_ID, resolveActionAriaLabel, resolveActionColumnWidth, resolveActionTooltip, resolveActiveActions, resolveConfirmOptions, resolveRowValue, } from "./action-column";
+/**
+ * One Edit/Delete button for one row: resolves the per-row visible / disabled /
+ * loading flags, applies the destructive treatment for delete, and routes the
+ * click through an optional {@link SmartConfirmDialog}.
+ */
+const GridActionButton = ({ kind, config, row, showLabel, }) => {
+    const [confirmOpen, setConfirmOpen] = useState(false);
+    const visible = resolveRowValue(config.visible, row, true);
+    if (!visible)
+        return null;
+    const disabled = resolveRowValue(config.disabled, row, false);
+    const loading = resolveRowValue(config.loading, row, false);
+    const confirm = resolveConfirmOptions(kind, config.confirm);
+    const tooltip = resolveActionTooltip(kind, config.tooltip);
+    const fire = () => config.onClick?.(row);
+    const handleClick = () => {
+        // The button is disabled while loading, but guard anyway so a queued
+        // event can never double-fire the action.
+        if (loading || disabled)
+            return;
+        if (confirm)
+            setConfirmOpen(true);
+        else
+            fire();
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(ActionButton, { action: kind, iconOnly: !showLabel, size: "sm", variant: "ghost", className: cn(kind === "delete" &&
+                    "text-destructive hover:bg-destructive/10 hover:text-destructive"), loading: loading, 
+                // Icon-only: spinner replaces the icon inside the same fixed-size
+                // button, so the row height never changes while deleting.
+                loadingText: showLabel ? undefined : "", disabled: disabled, tooltip: tooltip === false ? false : tooltip, "aria-label": resolveActionAriaLabel(kind, config.tooltip), onClick: handleClick }), confirm ? (_jsx(SmartConfirmDialog, { open: confirmOpen, onOpenChange: setConfirmOpen, title: confirm.title, description: confirm.description, confirmLabel: confirm.confirmLabel, cancelLabel: confirm.cancelLabel, variant: kind === "delete" ? "destructive" : "default", onConfirm: fire })) : null] }));
+};
+const GridActionCellInner = (props) => {
+    const { actionColumnStore } = props;
+    // Re-render whenever the grid's `actionColumn` prop changes — this is what
+    // makes row-external state (deletingId, permissions, …) show up without the
+    // consumer touching row data or AG Grid's refresh APIs.
+    useSyncExternalStore(actionColumnStore.subscribe, actionColumnStore.getVersion, actionColumnStore.getVersion);
+    const row = props.data;
+    // Infinite row model: placeholder rows have no data yet.
+    if (row == null)
+        return null;
+    const options = actionColumnStore.getOptions();
+    const actions = resolveActiveActions(options);
+    if (actions.length === 0)
+        return null;
+    const showLabel = options.showLabel ?? false;
+    return (_jsx("div", { className: "flex h-full items-center gap-1", children: actions.map(({ kind, config }) => (_jsx(GridActionButton, { kind: kind, config: config, row: row, showLabel: showLabel }, kind))) }));
+};
+/**
+ * Memoized action-cell renderer. AG Grid re-renders it only on
+ * `refreshCells({ force: true })` or row-data changes, keeping the column
+ * cheap across thousands of virtualized rows.
+ */
+export const GridActionCell = memo(GridActionCellInner);
+/**
+ * Build the injected action ColDef. The structural options (pin, width, label
+ * mode, header, exportability) are baked in; the per-row behavior flows through
+ * the `store` so the returned object can stay referentially stable (see
+ * `useGridActionColumn`).
+ *
+ * The column opts out of everything a utility column must not do: sort,
+ * filter, edit, resize (by default), move, hide, header menu, grouping /
+ * pivot / aggregation, and (by default) export.
+ */
+// eslint-disable-next-line react-refresh/only-export-components
+export const buildActionColumnDef = (options, store) => {
+    const pinned = options.pinned ?? "left";
+    const resizable = options.resizable ?? false;
+    const width = resolveActionColumnWidth(resolveActiveActions(options).length, options.showLabel ?? false, options.width);
+    return {
+        colId: ACTION_COLUMN_ID,
+        headerName: options.headerName ?? "Actions",
+        // `pinned` is a *stateful* attribute: on a columnDefs update, `undefined`
+        // means "keep the current state", so unpinning must be an explicit null.
+        pinned: pinned === false ? null : pinned,
+        lockPinned: true,
+        lockPosition: pinned === "left" ? "left" : pinned === "right" ? "right" : undefined,
+        lockVisible: true,
+        suppressMovable: true,
+        sortable: false,
+        filter: false,
+        floatingFilter: false,
+        editable: false,
+        resizable,
+        suppressHeaderMenuButton: true,
+        suppressHeaderFilterButton: true,
+        suppressAutoSize: true,
+        suppressColumnsToolPanel: true,
+        enableRowGroup: false,
+        enablePivot: false,
+        enableValue: false,
+        // `flex: 0` opts this column out of defaultColDef's `flex: 1`; the
+        // min/max pair pins the width (defaultColDef.minWidth is 120, wider than
+        // the icon-only column, so it must be overridden here).
+        flex: 0,
+        width,
+        minWidth: width,
+        maxWidth: resizable ? undefined : width,
+        cellClass: "smart-grid-action-cell",
+        cellRenderer: GridActionCell,
+        cellRendererParams: {
+            actionColumnStore: store,
+        },
+        // Read by both grids' export paths (CSV + XLSX) via `isExportSuppressed`.
+        context: { suppressExport: options.exportable !== true },
+    };
+};
+//# sourceMappingURL=action-column-cell.js.map

package/dist/data-grid/action-column-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-column-cell.js","sourceRoot":"","sources":["../../src/data-grid/action-column-cell.tsx"],"names":[],"mappings":"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"}

package/dist/data-grid/action-column.d.ts

@@ -0,0 +1,144 @@
+import type { ReactNode } from "react";
+/**
+ * Types and pure logic behind the grids' `actionColumn` prop — the config-driven
+ * Edit/Delete column shared by {@link SmartGrid} and {@link SmartServerGrid}.
+ * Everything here is renderer-free and unit-tested in `action-column.test.ts`;
+ * the cell renderer and ColDef builder live in `action-column-cell.tsx`, the
+ * React wiring in `use-action-column.ts`.
+ */
+/** Stable `colId` of the injected action column. */
+export declare const ACTION_COLUMN_ID = "smart-actions";
+/** The built-in row actions, rendered in this order. */
+export type GridActionKind = "edit" | "delete";
+export declare const GRID_ACTION_KINDS: readonly GridActionKind[];
+/** A static value or a per-row resolver. */
+export type GridActionRowValue<TRow, V> = V | ((row: TRow) => V);
+/** Confirmation dialog copy; unset fields fall back to per-action defaults. */
+export interface GridActionConfirmOptions {
+    /** Headline question. @default "Delete this row?" (delete) */
+    title?: string;
+    /** Supporting text explaining the consequences. */
+    description?: ReactNode;
+    /** Confirm button label. @default the action label */
+    confirmLabel?: string;
+    /** Cancel button label. @default "Cancel" */
+    cancelLabel?: string;
+}
+/** Configuration for one row action (Edit or Delete). */
+export interface GridRowActionConfig<TRow> {
+    /** Static on/off switch for the action. @default true */
+    enabled?: boolean;
+    /** Show/hide the button — statically or per row. @default true */
+    visible?: GridActionRowValue<TRow, boolean>;
+    /** Disable the button (kept visible) — statically or per row. @default false */
+    disabled?: GridActionRowValue<TRow, boolean>;
+    /**
+     * Per-row loading state: shows a spinner, disables the button and swallows
+     * further clicks — only for the rows the resolver matches. Row height is
+     * unaffected (the spinner replaces the icon inside a fixed-size button).
+     */
+    loading?: GridActionRowValue<TRow, boolean>;
+    /**
+     * Tooltip content. `true`/omitted uses the default ("Edit row" / "Delete
+     * row"), `false` disables it, a string replaces it. Also used as the
+     * button's `aria-label` in icon-only mode.
+     */
+    tooltip?: boolean | string;
+    /**
+     * Ask for confirmation before firing `onClick`. `true` uses the per-action
+     * default copy; pass {@link GridActionConfirmOptions} to customize it.
+     */
+    confirm?: boolean | GridActionConfirmOptions;
+    /** Fired with the row (after confirmation, when `confirm` is set). */
+    onClick?: (row: TRow) => void;
+}
+/**
+ * One action as accepted by the `actions` prop: `false` hides it, `true`
+ * enables it with defaults, an object configures it.
+ */
+export type GridRowActionProp<TRow> = boolean | GridRowActionConfig<TRow>;
+export interface GridActionColumnActions<TRow> {
+    edit?: GridRowActionProp<TRow>;
+    delete?: GridRowActionProp<TRow>;
+}
+/** Where the action column is pinned. `false` = a regular scrolling column. */
+export type GridActionColumnPin = "left" | "right" | false;
+/** The grids' `actionColumn` prop. */
+export interface GridActionColumnOptions<TRow> {
+    /** Master switch — `false` removes the column entirely. @default true */
+    enabled?: boolean;
+    /** Pin side; pinned columns stay visible while scrolling. @default "left" */
+    pinned?: GridActionColumnPin;
+    /** Fixed width in px. Omit to auto-size from the button count. */
+    width?: number;
+    /** Render "Edit"/"Delete" labels next to the icons. @default false */
+    showLabel?: boolean;
+    /** Include the column in CSV/Excel exports. @default false */
+    exportable?: boolean;
+    /** Let the user resize the column. @default false */
+    resizable?: boolean;
+    /** Header text. @default "Actions" */
+    headerName?: string;
+    /** The row actions. Omitting both (or hiding both) removes the column. */
+    actions?: GridActionColumnActions<TRow>;
+}
+/** An action that survived static filtering, ready for the cell renderer. */
+export interface ResolvedGridAction<TRow> {
+    kind: GridActionKind;
+    config: GridRowActionConfig<TRow>;
+}
+/**
+ * Collapse the `boolean | config` action prop into a config, or `null` when the
+ * action is statically off (`false`, `enabled: false`, or `visible: false` as a
+ * literal). Function `visible` predicates stay — they are per-row decisions.
+ */
+export declare const normalizeRowAction: <TRow>(input: GridRowActionProp<TRow> | undefined) => GridRowActionConfig<TRow> | null;
+/**
+ * The actions that can render for at least one row, in display order
+ * (edit, delete). An empty result means the column should not render at all
+ * (see the auto-hide contract in {@link isActionColumnEnabled}).
+ */
+export declare const resolveActiveActions: <TRow>(options: GridActionColumnOptions<TRow>) => ResolvedGridAction<TRow>[];
+/**
+ * Auto-hide contract: the column exists only when it is enabled *and* at least
+ * one action is statically visible. (Per-row `visible` functions count as
+ * potentially visible — they can only be judged row by row.)
+ */
+export declare const isActionColumnEnabled: <TRow>(options: GridActionColumnOptions<TRow> | undefined) => options is GridActionColumnOptions<TRow>;
+/** Evaluate a {@link GridActionRowValue} against a row. */
+export declare const resolveRowValue: <TRow, V>(value: GridActionRowValue<TRow, V> | undefined, row: TRow, fallback: V) => V;
+/**
+ * Tooltip/aria-label for an action: `false` disables it, a string overrides it,
+ * anything else falls back to "Edit row" / "Delete row".
+ */
+export declare const resolveActionTooltip: (kind: GridActionKind, tooltip: boolean | string | undefined) => string | false;
+/** Accessible name for the button — never disabled, even when tooltip is. */
+export declare const resolveActionAriaLabel: (kind: GridActionKind, tooltip: boolean | string | undefined) => string;
+export interface ResolvedConfirmOptions {
+    title: string;
+    description: ReactNode;
+    confirmLabel: string;
+    cancelLabel: string;
+}
+/** Merge user confirm options over the per-action defaults; `null` = no confirm. */
+export declare const resolveConfirmOptions: (kind: GridActionKind, confirm: boolean | GridActionConfirmOptions | undefined) => ResolvedConfirmOptions | null;
+/**
+ * Width for the action column: an explicit `width` wins; otherwise size from
+ * the button count, clamped to 80–120px icon-only (per the design spec) or up
+ * to 200px with labels.
+ */
+export declare const resolveActionColumnWidth: (actionCount: number, showLabel: boolean, width?: number) => number;
+/**
+ * Memo key over the *structural* fields of the options — the ones baked into
+ * the ColDef. Per-row callbacks/predicates are deliberately excluded: they are
+ * read through a ref at render time, so changing them must not recreate the
+ * column (which would reset AG Grid column state).
+ */
+export declare const actionColumnSignature: <TRow>(options: GridActionColumnOptions<TRow> | undefined) => string;
+/**
+ * `true` when a ColDef `context` carries the export opt-out set by
+ * `buildActionColumnDef` (`exportable: false`, the default). Checked by both
+ * grids' CSV/XLSX export paths.
+ */
+export declare const isExportSuppressed: (context: unknown) => boolean;
+//# sourceMappingURL=action-column.d.ts.map

package/dist/data-grid/action-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-column.d.ts","sourceRoot":"","sources":["../../src/data-grid/action-column.ts"],"names":[],"mappings":"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"}

package/dist/data-grid/action-column.js

@@ -0,0 +1,156 @@
+/**
+ * Types and pure logic behind the grids' `actionColumn` prop — the config-driven
+ * Edit/Delete column shared by {@link SmartGrid} and {@link SmartServerGrid}.
+ * Everything here is renderer-free and unit-tested in `action-column.test.ts`;
+ * the cell renderer and ColDef builder live in `action-column-cell.tsx`, the
+ * React wiring in `use-action-column.ts`.
+ */
+/** Stable `colId` of the injected action column. */
+export const ACTION_COLUMN_ID = "smart-actions";
+export const GRID_ACTION_KINDS = ["edit", "delete"];
+/* ------------------------------ normalization ------------------------------ */
+/**
+ * Collapse the `boolean | config` action prop into a config, or `null` when the
+ * action is statically off (`false`, `enabled: false`, or `visible: false` as a
+ * literal). Function `visible` predicates stay — they are per-row decisions.
+ */
+export const normalizeRowAction = (input) => {
+    if (input === undefined || input === false)
+        return null;
+    if (input === true)
+        return {};
+    if (input.enabled === false)
+        return null;
+    if (input.visible === false)
+        return null;
+    return input;
+};
+/**
+ * The actions that can render for at least one row, in display order
+ * (edit, delete). An empty result means the column should not render at all
+ * (see the auto-hide contract in {@link isActionColumnEnabled}).
+ */
+export const resolveActiveActions = (options) => {
+    const active = [];
+    for (const kind of GRID_ACTION_KINDS) {
+        const config = normalizeRowAction(options.actions?.[kind]);
+        if (config)
+            active.push({ kind, config });
+    }
+    return active;
+};
+/**
+ * Auto-hide contract: the column exists only when it is enabled *and* at least
+ * one action is statically visible. (Per-row `visible` functions count as
+ * potentially visible — they can only be judged row by row.)
+ */
+export const isActionColumnEnabled = (options) => options !== undefined &&
+    options.enabled !== false &&
+    resolveActiveActions(options).length > 0;
+/* ------------------------------- row resolvers ----------------------------- */
+/** Evaluate a {@link GridActionRowValue} against a row. */
+export const resolveRowValue = (value, row, fallback) => {
+    if (value === undefined)
+        return fallback;
+    if (typeof value === "function")
+        return value(row);
+    return value;
+};
+/* --------------------------------- defaults -------------------------------- */
+const ACTION_TOOLTIPS = {
+    edit: "Edit row",
+    delete: "Delete row",
+};
+/**
+ * Tooltip/aria-label for an action: `false` disables it, a string overrides it,
+ * anything else falls back to "Edit row" / "Delete row".
+ */
+export const resolveActionTooltip = (kind, tooltip) => {
+    if (tooltip === false)
+        return false;
+    if (typeof tooltip === "string")
+        return tooltip;
+    return ACTION_TOOLTIPS[kind];
+};
+/** Accessible name for the button — never disabled, even when tooltip is. */
+export const resolveActionAriaLabel = (kind, tooltip) => typeof tooltip === "string" && tooltip.length > 0
+    ? tooltip
+    : ACTION_TOOLTIPS[kind];
+const CONFIRM_DEFAULTS = {
+    edit: {
+        title: "Edit this row?",
+        description: "You are about to edit this row.",
+        confirmLabel: "Edit",
+        cancelLabel: "Cancel",
+    },
+    delete: {
+        title: "Delete this row?",
+        description: "This action cannot be undone.",
+        confirmLabel: "Delete",
+        cancelLabel: "Cancel",
+    },
+};
+/** Merge user confirm options over the per-action defaults; `null` = no confirm. */
+export const resolveConfirmOptions = (kind, confirm) => {
+    if (confirm === undefined || confirm === false)
+        return null;
+    const overrides = confirm === true ? {} : confirm;
+    const defaults = CONFIRM_DEFAULTS[kind];
+    return {
+        title: overrides.title ?? defaults.title,
+        description: overrides.description ?? defaults.description,
+        confirmLabel: overrides.confirmLabel ?? defaults.confirmLabel,
+        cancelLabel: overrides.cancelLabel ?? defaults.cancelLabel,
+    };
+};
+/* ---------------------------------- width ---------------------------------- */
+// Horizontal budget per button: icon-only buttons are 24px (`icon-sm`) plus the
+// 4px flex gap; labeled buttons add the text. CHROME covers the cell padding.
+const ICON_BUTTON_SPAN = 28;
+const LABEL_BUTTON_SPAN = 78;
+const CELL_CHROME = 30;
+/**
+ * Width for the action column: an explicit `width` wins; otherwise size from
+ * the button count, clamped to 80–120px icon-only (per the design spec) or up
+ * to 200px with labels.
+ */
+export const resolveActionColumnWidth = (actionCount, showLabel, width) => {
+    if (width !== undefined)
+        return width;
+    const span = showLabel ? LABEL_BUTTON_SPAN : ICON_BUTTON_SPAN;
+    const auto = CELL_CHROME + actionCount * span;
+    return Math.min(Math.max(auto, 80), showLabel ? 200 : 120);
+};
+/* -------------------------------- signature -------------------------------- */
+/**
+ * Memo key over the *structural* fields of the options — the ones baked into
+ * the ColDef. Per-row callbacks/predicates are deliberately excluded: they are
+ * read through a ref at render time, so changing them must not recreate the
+ * column (which would reset AG Grid column state).
+ */
+export const actionColumnSignature = (options) => {
+    if (!isActionColumnEnabled(options))
+        return "off";
+    const kinds = resolveActiveActions(options)
+        .map((action) => action.kind)
+        .join("+");
+    return [
+        kinds,
+        String(options.pinned ?? "left"),
+        String(options.width ?? "auto"),
+        options.showLabel ? "label" : "icon",
+        options.exportable ? "exportable" : "no-export",
+        options.resizable ? "resizable" : "fixed",
+        options.headerName ?? "Actions",
+    ].join("|");
+};
+/* --------------------------------- export ---------------------------------- */
+/**
+ * `true` when a ColDef `context` carries the export opt-out set by
+ * `buildActionColumnDef` (`exportable: false`, the default). Checked by both
+ * grids' CSV/XLSX export paths.
+ */
+export const isExportSuppressed = (context) => typeof context === "object" &&
+    context !== null &&
+    context.suppressExport === true;
+//# sourceMappingURL=action-column.js.map

package/dist/data-grid/action-column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-column.js","sourceRoot":"","sources":["../../src/data-grid/action-column.ts"],"names":[],"mappings":"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"}

package/dist/data-grid/create-page-fetcher.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { type ServerFetchParams, type ServerFetchResult } from "./pagination";
+/**
+ * A `fetchRows` implementation for {@link SmartServerGrid}: takes the
+ * normalized grid request plus an abort signal and resolves to a block of rows
+ * and the total count. An optional third argument carries per-call query params
+ * (e.g. a demo `simulateError` toggle) merged on top of the built query.
+ */
+export type PageFetcher<TItem> = (params: ServerFetchParams, signal: AbortSignal, extraParams?: Record<string, string>) => Promise<ServerFetchResult<TItem>>;
+export interface CreatePageFetcherOptions<TItem> {
+    /** Endpoint to fetch from. The built query string is appended after `?`. */
+    url: string;
+    /**
+     * Zod schema for a single row. The response is validated against
+     * `pageSchema(itemSchema)` (the Spring Data `Page<T>` envelope) so malformed
+     * responses fail loudly instead of silently rendering garbage.
+     */
+    itemSchema: z.ZodType<TItem>;
+    /**
+     * Serialize grid params into a query string (without the leading `?`).
+     * Defaults to {@link buildSpringQuery} (the Spring Data dialect). Override to
+     * speak a different backend contract.
+     */
+    buildQuery?: (params: ServerFetchParams) => string;
+    /**
+     * Turn a non-OK response into the error thrown to the grid. Receives the
+     * `Response` so callers can read a status-specific message. Defaults to
+     * `Error("Server error: <status>")`.
+     */
+    mapError?: (response: Response) => Error;
+    /**
+     * Injected `fetch` implementation. Defaults to the global `fetch`. Provided so
+     * this module stays testable (fake transport) and usable outside the browser
+     * (SSR / node with a polyfill) without reaching for the global.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Build a validated `fetchRows` adapter for {@link SmartServerGrid}: it
+ * serializes normalized grid params to a query string, calls `url`, checks the
+ * HTTP status, and validates the response against the Spring Data `Page<T>`
+ * envelope before returning `{ rows, total }`.
+ *
+ * Every server-grid page shares this fetch → status-check → Zod-parse pipeline,
+ * so it lives here once instead of being re-hand-rolled per page.
+ *
+ * @example
+ * ```ts
+ * const fetchUsers = createPageFetcher({
+ *   url: "/api/users",
+ *   itemSchema: userRowSchema,
+ * })
+ * // <SmartServerGrid fetchRows={fetchUsers} … />
+ * ```
+ */
+export declare const createPageFetcher: <TItem>({ url, itemSchema, buildQuery, mapError, fetchImpl, }: CreatePageFetcherOptions<TItem>) => PageFetcher<TItem>;
+//# sourceMappingURL=create-page-fetcher.d.ts.map

package/dist/data-grid/create-page-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-page-fetcher.d.ts","sourceRoot":"","sources":["../../src/data-grid/create-page-fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAA;AAErB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,IAAI,CAC/B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAA;AAEtC,MAAM,WAAW,wBAAwB,CAAC,KAAK;IAC7C,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,MAAM,CAAA;IAClD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,KAAK,CAAA;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AASD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,EAAE,uDAMtC,wBAAwB,CAAC,KAAK,CAAC,KAAG,WAAW,CAAC,KAAK,CAWrD,CAAA"}

package/dist/data-grid/create-page-fetcher.js

@@ -0,0 +1,41 @@
+import { pageSchema, buildSpringQuery, } from "./pagination";
+const mergeQuery = (query, extra) => {
+    if (!extra)
+        return query;
+    const sp = new URLSearchParams(query);
+    for (const [key, value] of Object.entries(extra))
+        sp.set(key, value);
+    return sp.toString();
+};
+/**
+ * Build a validated `fetchRows` adapter for {@link SmartServerGrid}: it
+ * serializes normalized grid params to a query string, calls `url`, checks the
+ * HTTP status, and validates the response against the Spring Data `Page<T>`
+ * envelope before returning `{ rows, total }`.
+ *
+ * Every server-grid page shares this fetch → status-check → Zod-parse pipeline,
+ * so it lives here once instead of being re-hand-rolled per page.
+ *
+ * @example
+ * ```ts
+ * const fetchUsers = createPageFetcher({
+ *   url: "/api/users",
+ *   itemSchema: userRowSchema,
+ * })
+ * // <SmartServerGrid fetchRows={fetchUsers} … />
+ * ```
+ */
+export const createPageFetcher = ({ url, itemSchema, buildQuery = buildSpringQuery, mapError = (response) => new Error(`Server error: ${response.status}`), fetchImpl, }) => {
+    const envelope = pageSchema(itemSchema);
+    return async (params, signal, extraParams) => {
+        const doFetch = fetchImpl ?? fetch;
+        const query = mergeQuery(buildQuery(params), extraParams);
+        const response = await doFetch(`${url}?${query}`, { signal });
+        if (!response.ok)
+            throw mapError(response);
+        const data = await response.json();
+        const page = envelope.parse(data);
+        return { rows: page.content, total: page.totalElements };
+    };
+};
+//# sourceMappingURL=create-page-fetcher.js.map

package/dist/data-grid/create-page-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-page-fetcher.js","sourceRoot":"","sources":["../../src/data-grid/create-page-fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,cAAc,CAAA;AA2CrB,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAA8B,EAAU,EAAE;IAC3E,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IACxB,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAA;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpE,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAA;AACtB,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAQ,EACvC,GAAG,EACH,UAAU,EACV,UAAU,GAAG,gBAAgB,EAC7B,QAAQ,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,EAAE,CAAC,EACtE,SAAS,GACuB,EAAsB,EAAE;IACxD,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,SAAS,IAAI,KAAK,CAAA;QAClC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7D,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACjC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,CAAA;IAC1D,CAAC,CAAA;AACH,CAAC,CAAA"}