@crispy-seed/data-table 0.10.5 → 0.11.1

package/dist/index.d.ts

@@ -57,18 +57,22 @@ interface ToolbarFilter {
 }
 
 /**
- * Live-review fix (Attio/GRC parity): the ColumnCalc footer's own aggregation set --
- * three apply to every column, six more to numeric ones, one more to non-numeric ones.
- * Distinct from crisp's own `ColumnCalc` (`countEmpty`/`countFilled`/`percentEmpty`/
- * `percentFilled` + sum/average/min/max + "none") -- crisp's own set was read for the
- * MENU/trigger interaction (`column-calc.tsx`'s own doc comment), not copied op-for-op;
- * this table's contract is the ten named directly in DATATABLE-ATTIO-SPEC.md/the GRC
- * feature contract: count / empty / not-empty everywhere, sum / average / median / min
- * / max / range on a numeric column, count-unique on a non-numeric one. The styled
- * layer picks which extra set to offer off the column's own cell type (`column-calc.tsx`'s
- * `ColumnCalcCell`).
+ * Attio-parity follow-up (bring the discovery doc's PARTIAL #7 to full parity, on top
+ * of the earlier GRC live-review fix): the ColumnCalc footer's own aggregation set --
+ * six apply to every column, six more to numeric ones, one more to non-numeric ones.
+ * The six universal ops are `count` (GRC's own addition, kept) plus Attio's measured
+ * four -- `empty`/`notEmpty` labelled "Count empty"/"Count filled", `percentEmpty` /
+ * `percentFilled` -- plus `none`, which is Attio's own menu entry for "no calculation",
+ * not a conditionally-appended "Clear" item: it renders nothing (`computeColumnCalc`
+ * returns `null` for it) and, unlike `setColumnCalcOp(key, undefined)`, is a real,
+ * explicit, controllable op value so it overrides a column's `summaryDefaultOp`
+ * instead of falling back to it. Numeric columns still additionally get sum / average
+ * / median / min / max / range (GRC's set, not in Attio's own measured menu but kept --
+ * this table's contract, not a straight port); non-numeric columns still get
+ * count-unique. The styled layer picks which extra set to offer off the column's own
+ * cell type (`column-calc.tsx`'s `ColumnCalcCell`).
  */
-type DataTableCalcOp = "count" | "empty" | "notEmpty" | "sum" | "average" | "median" | "min" | "max" | "range" | "countUnique";
+type DataTableCalcOp = "count" | "empty" | "notEmpty" | "percentEmpty" | "percentFilled" | "none" | "sum" | "average" | "median" | "min" | "max" | "range" | "countUnique";
 
 /** Everything a saved view actually captures -- deliberately the same five controlled
  *  props `useDataTableColumns` + the toolbar sort/filter hooks already expose, so
@@ -114,6 +118,15 @@ interface UseDataTableViewsProps {
     storageKey?: string;
 }
 
+/** The context a consumer's `cellContextMenuItems` render slot gets -- everything it
+ *  needs to build its own `MenuItem`s (which row/column this menu opened for, the raw
+ *  value already read off `getColumnValue`) without re-deriving any of it itself. */
+interface DataTableCellContextMenuContext<TRow> {
+    row: TRow;
+    column: DataTableColumn<TRow>;
+    value: unknown;
+}
+
 type DataTableCellType = "text" | "entity" | "url" | "email" | "tags" | "status" | "number" | "currency" | "date" | "datetime" | "rating" | "checkbox" | "chip" | "chip-list";
 
 /** A `select`/`reference`/`actor` editor's own choice list -- `value`/`label` are
@@ -185,8 +198,11 @@ interface DataTableColumn<TRow> {
      * 절대 스크롤되어 사라지지 않도록 오른쪽 끝에 고정합니다 -- 이 플래그가 있는 열은 테이블
      * 전체의 `stickyLast`를 켜지 않아도 자동으로 그 고정 + 왼쪽 스크롤 그림자
      * (`stickyProps`/`stickyLast`가 이미 구현한 것과 동일한 메커니즘, `data-sticky-edge-end`
-     * / `data-scrolled-end`)를 받습니다. 열 목록의 마지막 열이어야 합니다 -- `stickyLast`
-     * 자체가 이미 "마지막으로 보이는 열"만 고정하는 규칙이기 때문입니다.
+     * / `data-scrolled-end`)를 받습니다. `stickyLast`는 이 플래그가 붙은 열을 직접 찾아
+     * 고정합니다 (`column-layout.ts`의 `useEffectiveColumns`) -- 더 이상 "마지막으로 보이는
+     * 열"이어야만 한다는 제약이 없습니다. 내부적으로도 `reconcileColumnOrder`(react-headless의
+     * `dom.ts`)가 이 열을 항상 맨 끝에 유지하므로, 마운트 이후 추가된 새 열이 이 열보다 뒤로
+     * 붙어 고정 셀 뒤에 가려지는 일도 없습니다.
      */
     actions?: boolean;
     /**
@@ -320,6 +336,17 @@ interface DataTableProps<TRow extends {
     /** 전체 선택 체크박스가 일부만 선택됐을 때(indeterminate) 표시할 아이콘입니다.
      *  생략하면 karrot의 minus 아이콘을 씁니다. */
     selectionIndeterminateIcon?: react.ReactNode;
+    /**
+     * 행이 하나 이상 선택되면 테이블 하단 중앙에 뜨는 벌크 액션 바(Attio 스타일 floating
+     * pill, gap #4)에 넣을 소비자 액션입니다. 현재 선택된 행 id 목록을 받는 render prop --
+     * 이 컴포넌트는 바의 크롬("N selected" + 지우기 버튼)만 제공하고, 실제 액션 버튼(Add
+     * to list, Send email, …)은 항상 소비자 자신의 것입니다 (`toolbarActions`와 같은
+     * "크롬 vs 소비자 콘텐츠" 분리). 생략하면 바는 크롬만 보여줍니다. `selectable`이 꺼져
+     * 있으면 무시됩니다(선택 자체가 없으므로).
+     */
+    bulkActions?: (selectedIds: string[]) => react.ReactNode;
+    /** 벌크 액션 바의 지우기(x) 버튼 접근성 이름입니다. @default "Clear selection" */
+    clearSelectionLabel?: string;
     /** 제어할 검색어입니다. */
     query?: string;
     /** 비제어 방식으로 사용할 때의 초기 검색어입니다. */
@@ -429,6 +456,24 @@ interface DataTableProps<TRow extends {
      * 커밋됩니다.
      */
     onEdit?: (id: string, key: string, value: string) => Promise<void> | void;
+    /**
+     * Attio parity (attio-column-features-full.md gap #1) -- right-click any body cell
+     * to open a menu: Copy (any cell, built-in -- `navigator.clipboard.writeText` of the
+     * cell's own display text), Clear value/Paste (editable cells only, see
+     * `cell-context-menu.tsx`'s own `isClearableEditableCell`/`isSimpleEditableCell` for
+     * exactly which shapes qualify), and View edit history (only when
+     * `onViewEditHistory` is passed). @default true
+     */
+    cellContextMenu?: boolean;
+    /** Shown as "View edit history" in the cell context menu, only when passed -- the
+     *  consumer owns whatever history UI opens (a drawer, a modal, …); this component
+     *  only fires the callback with the row and the column's key. */
+    onViewEditHistory?: (row: TRow, columnKey: string) => void;
+    /** Extra `MenuItem`s appended to the end of every cell's right-click menu (e.g. a
+     *  consumer's own "Assign to…") -- rendered inside the SAME `MenuScrollArea` the
+     *  built-in items are, so a `<MenuItem>` from this package's own `Menu` export
+     *  composes the way `column-menu.tsx`'s own items do. */
+    cellContextMenuItems?: (ctx: DataTableCellContextMenuContext<TRow>) => react.ReactNode;
     /** 행을 클릭할 수 있게 하는 호버 표시입니다 (crisp의 3%/4% 포그라운드 틴트). 커서
      *  모양은 `onRowClick`이 있는지에 따로 달려 있습니다 -- 이 값과 독립적으로 켤 수
      *  있습니다(crisp의 두 prop, `interactive`/`onRowClick`도 서로 독립적입니다). */
@@ -527,6 +572,28 @@ declare namespace DataTableViewsControl {
     var displayName: string;
 }
 
+interface DataTableBulkBarProps {
+    /** The clear ("x") button's accessible name. @default "Clear selection" */
+    clearLabel?: string;
+    /**
+     * The consumer's own bulk-action buttons, as a render prop receiving the current
+     * selected row ids -- e.g. `<DataTableBulkBar>{(ids) => <ActionButton
+     * onClick={() => addToList(ids)}>Add to list</ActionButton>}</DataTableBulkBar>`.
+     * Omit for just the bar's own chrome ("N selected" + clear).
+     */
+    children?: (selectedIds: string[]) => react.ReactNode;
+}
+/**
+ * The floating bulk-action pill (gap #4) -- renders nothing while no row is selected
+ * (reads `selectedIds` off the table-wide context itself, so a consumer doesn't have
+ * to gate this on `selectable`/`selectedIds` on their own). Composed as the LAST
+ * child of the table's own root (`DataTable.tsx`), which is `position: relative` for
+ * exactly this reason -- see `data-table.ts`'s own `bulkBar` slot comment for why its
+ * geometry borrows `contextual-floating-button`'s already-measured vars rather than a
+ * guessed literal.
+ */
+declare function DataTableBulkBar({ clearLabel, children, }: DataTableBulkBarProps): react_jsx_runtime.JSX.Element | null;
+
 type ResizablePanelSide = "left" | "right";
 
 type ResizablePanelHandleVariant = "panel" | "column";
@@ -917,5 +984,5 @@ declare namespace RecordPreview {
     var displayName: string;
 }
 
-export { DataTable, DataTableViewsControl, RecordPreview, ResizablePanel };
-export type { DataTableColumn, DataTableColumnKind, DataTableProps, DataTableView, DataTableViewState, DataTableViewsControlProps, RecordPreviewHighlight, RecordPreviewProps, RecordPreviewRecord, RecordPreviewSection, RecordPreviewTab, ResizablePanelHandleVariant, ResizablePanelProps, ResizablePanelSide, ToolbarFilter, ToolbarFilterOp, ToolbarSort, ToolbarSortDirection };
+export { DataTable, DataTableBulkBar, DataTableViewsControl, RecordPreview, ResizablePanel };
+export type { DataTableBulkBarProps, DataTableCellContextMenuContext, DataTableColumn, DataTableColumnKind, DataTableProps, DataTableView, DataTableViewState, DataTableViewsControlProps, RecordPreviewHighlight, RecordPreviewProps, RecordPreviewRecord, RecordPreviewSection, RecordPreviewTab, ResizablePanelHandleVariant, ResizablePanelProps, ResizablePanelSide, ToolbarFilter, ToolbarFilterOp, ToolbarSort, ToolbarSortDirection };