@crispy-seed/data-table 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -256,6 +256,16 @@ interface DataTableColumn<TRow> {
      * 옵션의 문자열 그 자체입니다). 생략하면 `value`(또는 `row[key]`)를 그대로 씁니다.
      */
     editValue?: (row: TRow) => string | number | boolean;
+    /**
+     * `type: "entity"` 열에서만 쓰입니다 (your-moon/crisp#601 이식). 행에 마우스를
+     * 올리거나 키보드 포커스를 받으면 셀 오른쪽 끝에 "미리보기 열기" 아이콘이
+     * 나타납니다 -- crisp가 측정한 것과 동일한 20px 고스트 버튼(`radius.sm`,
+     * 평상시 muted, hover에서 진해짐). 생략하면 아이콘이 렌더링되지 않습니다
+     * (기본값). `type`이 다르면 무시됩니다.
+     */
+    onOpenPreview?: (row: TRow) => void;
+    /** `onOpenPreview` 아이콘의 aria-label입니다. @default "Open preview" */
+    openPreviewLabel?: string;
 }
 interface DataTableProps<TRow extends {
     id: string;
@@ -505,5 +515,215 @@ declare namespace DataTableViewsControl {
     var displayName: string;
 }
 
-export { DataTable, DataTableViewsControl };
-export type { DataTableColumn, DataTableColumnKind, DataTableProps, DataTableView, DataTableViewState, DataTableViewsControlProps, ToolbarFilter, ToolbarFilterOp, ToolbarSort, ToolbarSortDirection };
+type ResizablePanelSide = "left" | "right";
+
+type ResizablePanelHandleVariant = "panel" | "column";
+type ResizablePanelProps = Omit<react.ComponentPropsWithoutRef<"div">, "children" | "onResize"> & {
+    /** Which edge of its container the panel is anchored to. @default "left" */
+    side?: ResizablePanelSide;
+    /** Controlled width, in px. */
+    width?: number;
+    /** Initial width, in px, when uncontrolled. @default 280 */
+    defaultSize?: number;
+    /** Fires with the next width on every drag move, and once more with the
+     *  final, CSS-clamped width once a drag ends. */
+    onWidthChange?: (width: number) => void;
+    /** `min-width` in px. @default 200 */
+    min?: number;
+    /**
+     * `max-width` -- a px number, or a raw CSS expression for callers that
+     * need a real clamp, e.g. `max="min(60%, 100% - 350px)"`. Constraints are
+     * never re-applied in JS: the handler writes the unclamped drag width, and
+     * the browser's own `min-width`/`max-width` resolve the rendered size.
+     */
+    max?: number | string;
+    /**
+     * Layout model: "docked" (default) reserves flow width and sits in-line
+     * with a hairline border; "floating" takes the panel out of flow
+     * (`position: fixed`, an 8px gutter, r10, the measured floating shadow).
+     */
+    floating?: boolean;
+    /** Resize-handle geometry -- "panel" (default) or "column" (table edges). */
+    handleVariant?: ResizablePanelHandleVariant;
+    /**
+     * Renders the drag handle. `false` gives a fixed-width, non-interactive
+     * panel (e.g. `RecordPreview`'s own `resizable={false}` default) -- not part
+     * of crisp's own API, added here so a consumer built ON this primitive
+     * (like `RecordPreview`) can opt out of dragging entirely without crisp's
+     * duplicate resize-handle implementation. @default true
+     */
+    resizable?: boolean;
+    /**
+     * Persist width as a percentage of the container under this key (a `%`,
+     * not px, so the panel keeps its proportion on resize). Only applies when
+     * `width` is uncontrolled.
+     */
+    storageKey?: string;
+    className?: string;
+    children?: react.ReactNode;
+};
+/**
+ * An adjustable-panel primitive: a spacer that reserves layout width plus a
+ * panel that overlays it, so the panel can move between docked (in-flow) and
+ * floating (`position: fixed`, an overlay) without a reflow glitch. Drag the
+ * edge handle to resize; constraints are CSS `min-width`/`max-width`, never
+ * re-clamped in JS. Ported from your-moon/crisp's `ResizablePanel`
+ * (`components/resizablepanel/`); state/drag behavior lives in
+ * `useResizablePanel` (`@seed-design/react-resizable-panel`), this component
+ * owns the DOM + recipe classes on top of it.
+ */
+declare const ResizablePanel: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "onResize"> & {
+    /** Which edge of its container the panel is anchored to. @default "left" */
+    side?: ResizablePanelSide;
+    /** Controlled width, in px. */
+    width?: number;
+    /** Initial width, in px, when uncontrolled. @default 280 */
+    defaultSize?: number;
+    /** Fires with the next width on every drag move, and once more with the
+     *  final, CSS-clamped width once a drag ends. */
+    onWidthChange?: (width: number) => void;
+    /** `min-width` in px. @default 200 */
+    min?: number;
+    /**
+     * `max-width` -- a px number, or a raw CSS expression for callers that
+     * need a real clamp, e.g. `max="min(60%, 100% - 350px)"`. Constraints are
+     * never re-applied in JS: the handler writes the unclamped drag width, and
+     * the browser's own `min-width`/`max-width` resolve the rendered size.
+     */
+    max?: number | string;
+    /**
+     * Layout model: "docked" (default) reserves flow width and sits in-line
+     * with a hairline border; "floating" takes the panel out of flow
+     * (`position: fixed`, an 8px gutter, r10, the measured floating shadow).
+     */
+    floating?: boolean;
+    /** Resize-handle geometry -- "panel" (default) or "column" (table edges). */
+    handleVariant?: ResizablePanelHandleVariant;
+    /**
+     * Renders the drag handle. `false` gives a fixed-width, non-interactive
+     * panel (e.g. `RecordPreview`'s own `resizable={false}` default) -- not part
+     * of crisp's own API, added here so a consumer built ON this primitive
+     * (like `RecordPreview`) can opt out of dragging entirely without crisp's
+     * duplicate resize-handle implementation. @default true
+     */
+    resizable?: boolean;
+    /**
+     * Persist width as a percentage of the container under this key (a `%`,
+     * not px, so the panel keeps its proportion on resize). Only applies when
+     * `width` is uncontrolled.
+     */
+    storageKey?: string;
+    className?: string;
+    children?: react.ReactNode;
+} & react.RefAttributes<HTMLDivElement>>;
+
+/** One Highlights card -- label, value and an optional icon, laid out the way
+ *  Attio's own peek panel lays its own out (your-moon/crisp#448, measured
+ *  live): a 2-column grid, no card chrome, a muted label row with a
+ *  trailing icon, a filled-colour value below it. */
+type RecordPreviewHighlight = {
+    key: string;
+    label: string;
+    value: react.ReactNode;
+    icon?: react.ComponentType<{
+        size?: number;
+    }>;
+};
+/** One collapsed section below Activity (your-moon/crisp#413) -- Attio's own
+ *  peek shows Emails/Notes/Tasks this way, each a label + a count, expanding
+ *  into the consumer's own content when clicked. Omitting `content` renders
+ *  the row but not as a button, matching the live DOM measured on an empty
+ *  section: no chevron, no click handler, nothing to expand into yet. */
+type RecordPreviewSection = {
+    key: string;
+    label: string;
+    count: number;
+    content?: react.ReactNode;
+};
+/** The record this panel previews. Only `name` is read directly here --
+ *  everything else the panel shows comes from `highlights`/`activity`/
+ *  `sections`, the consumer's own data. Unlike crisp's own `RecordPanel`
+ *  (which reads `Row` from `product/recordpage/column`), this port has no
+ *  such type to depend on -- crispy-seed has no RecordPage -- so this stays
+ *  a minimal, consumer-extendable shape. */
+type RecordPreviewRecord = {
+    name?: string;
+    [key: string]: unknown;
+};
+type RecordPreviewProps = Omit<react.ComponentPropsWithoutRef<"div">, "children" | "title" | "onResize"> & {
+    /** Whether the panel is mounted/visible. */
+    open: boolean;
+    onClose: () => void;
+    /** Label for the close control. */
+    closeLabel?: string;
+    /**
+     * A toolbar row above the panel's own identity header (your-moon/crisp#601,
+     * measured live on app.attio.com's peek): Close, then Previous/Next on the
+     * left, an "Open record" icon on the right. Close always renders
+     * (`onClose` is required); Previous/Next/Open record each render only when
+     * given a handler.
+     */
+    onOpenRecord?: () => void;
+    openRecordLabel?: string;
+    onPrevious?: () => void;
+    previousRecordLabel?: string;
+    onNext?: () => void;
+    nextRecordLabel?: string;
+    /** "2 of 37 in All Companies" (your-moon/crisp#413) -- a single
+     *  pre-formatted string; omit for no counter at all. */
+    counterLabel?: react.ReactNode;
+    /**
+     * Lets a person drag the panel wider or narrower from its own left edge --
+     * this port reuses `ResizablePanel`'s own handle (`side="right"`, whose
+     * handle sits at the panel's inline-start/left edge, the same physical
+     * position crisp's own hand-rolled resize strip measured). Uncontrolled by
+     * default; pass `width`/`onWidthChange` together to own it instead.
+     * @default false
+     */
+    resizable?: boolean;
+    width?: number;
+    defaultWidth?: number;
+    onWidthChange?: (width: number) => void;
+    minWidth?: number;
+    maxWidth?: number;
+    /** The panel's heading, and so its accessible name. Defaults to `record.name`. */
+    title?: react.ReactNode;
+    /** Avatar image URL beside the title. Omit for an initials tile built from
+     *  `record.name`'s first character. */
+    avatar?: string;
+    /** The record to show; renders nothing when `open` is false or `record`
+     *  is null. */
+    record: RecordPreviewRecord | null;
+    /** Heading above the highlight cards (default "Highlights"). Omit the
+     *  whole section by omitting `highlights`. */
+    highlightsLabel?: react.ReactNode;
+    highlights?: RecordPreviewHighlight[];
+    /** Heading above the activity feed (default "Activity"). */
+    activityLabel?: react.ReactNode;
+    viewAllActivityLabel?: react.ReactNode;
+    onViewAllActivity?: () => void;
+    activity?: react.ReactNode;
+    /** Collapsed sections below Activity (your-moon/crisp#413). Omit for no
+     *  sections at all. */
+    sections?: RecordPreviewSection[];
+    /** Rendered below the panel's content, e.g. an Edit button. */
+    footer?: react.ReactNode;
+    className?: string;
+};
+/**
+ * Right-side record peek panel -- Attio's own peek shows a Highlights card
+ * area and an Activity feed (measured live). Ported from your-moon/crisp's
+ * `RecordPanel` (`product/recordpanel/`), built ON `ResizablePanel`
+ * (`side="right" floating`) rather than crisp's own duplicate absolute-
+ * positioning/slide-in/resize-handle implementation -- the outer shell (the
+ * `@starting-style` slide-in, the floating elevation, the drag handle
+ * itself) all come from that primitive; this component only renders the
+ * CONTENT inside it.
+ */
+declare function RecordPreview({ open, record, onClose, className, closeLabel, onOpenRecord, openRecordLabel, onPrevious, previousRecordLabel, onNext, nextRecordLabel, title, avatar, highlightsLabel, highlights, counterLabel, resizable, width, defaultWidth, onWidthChange, minWidth, maxWidth, activityLabel, viewAllActivityLabel, onViewAllActivity, activity, sections, footer, ...rest }: RecordPreviewProps): react_jsx_runtime.JSX.Element | null;
+declare namespace RecordPreview {
+    var displayName: string;
+}
+
+export { DataTable, DataTableViewsControl, RecordPreview, ResizablePanel };
+export type { DataTableColumn, DataTableColumnKind, DataTableProps, DataTableView, DataTableViewState, DataTableViewsControlProps, RecordPreviewHighlight, RecordPreviewProps, RecordPreviewRecord, RecordPreviewSection, ResizablePanelHandleVariant, ResizablePanelProps, ResizablePanelSide, ToolbarFilter, ToolbarFilterOp, ToolbarSort, ToolbarSortDirection };