@l3mpire/ui 3.3.0 → 3.5.1

package/dist/index.d.mts

@@ -1,9 +1,11 @@
 import { ClassValue } from 'clsx';
 import * as React from 'react';
-import * as _l3mpire_icons from '@l3mpire/icons';
-import { IconDefinition } from '@l3mpire/icons';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
+import * as _l3mpire_icons from '@l3mpire/icons';
+import { IconDefinition } from '@l3mpire/icons';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import * as ToastPrimitive from '@radix-ui/react-toast';
@@ -14,13 +16,450 @@ import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ColumnDef, SortingState, OnChangeFn, ColumnFiltersState, PaginationState, RowSelectionState, VisibilityState, ColumnOrderState, ColumnPinningState, Table as Table$1 } from '@tanstack/react-table';
 export { ColumnDef, ColumnFiltersState, RowSelectionState, SortingState, flexRender } from '@tanstack/react-table';
-import * as PopoverPrimitive from '@radix-ui/react-popover';
 
 declare function cn(...inputs: ClassValue[]): string;
 
+declare const TAG_PALETTE: readonly ["indigo", "rose", "lime", "violet", "cyan", "orange", "emerald", "fuchsia", "amber", "slate"];
+type TagColorName = (typeof TAG_PALETTE)[number];
+interface TagColor {
+    name: TagColorName;
+    bg: string;
+    text: string;
+    border: string;
+}
+declare function tagColorAt(index: number): TagColor;
+declare function tagColorFor(value: string, list: readonly string[]): TagColor;
+
+type AICellState = {
+    status: "pending";
+} | {
+    status: "running";
+} | {
+    status: "done";
+    value: string;
+    citations?: string[];
+} | {
+    status: "error";
+    message: string;
+};
+declare const AI_RUNNING_VERBS: readonly ["Thinking", "Researching", "Generating", "Extracting", "Analyzing"];
+type AIRunningVerb = (typeof AI_RUNNING_VERBS)[number];
+declare function pickRunningVerb(seed?: string): AIRunningVerb;
+interface AICellProps extends React.HTMLAttributes<HTMLSpanElement> {
+    state: AICellState | undefined;
+    /** Stable per-cell seed so the running verb is consistent across re-renders. */
+    seed?: string;
+}
+/**
+ * AICell renders the four states (pending → running → done | error) inside a
+ * single stable <span> shell. Children swap in place — no unmount between
+ * states — which is why there is no perceptible blank frame between running
+ * and done. Error has its own shell because it is not wrapped in a tooltip.
+ */
+declare const AICell: React.ForwardRefExoticComponent<AICellProps & React.RefAttributes<HTMLSpanElement>>;
+
+declare const badgeVariants: (props?: ({
+    variant?: "solid" | "light" | "outlined" | null | undefined;
+    type?: "primary" | "success" | "critical" | "warning" | "neutral" | null | undefined;
+    tone?: "indigo" | "rose" | "lime" | "violet" | "cyan" | "orange" | "emerald" | "fuchsia" | "amber" | "slate" | "teal" | "sky" | "purple" | "pink" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "type">, VariantProps<typeof badgeVariants> {
+    icon?: IconDefinition;
+}
+declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+interface AIBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "type"> {
+    /** Hide the leading stars icon. */
+    iconHidden?: boolean;
+    /** Override the default `lg` size to match a denser cell row. */
+    size?: BadgeProps["size"];
+}
+/**
+ * Marker that flags a value or column as AI-driven. Renders as a regular
+ * `<Badge variant="light" type="primary" size="lg" />` (same grammar as
+ * `StatusCell`) with the stars glyph as a leading icon.
+ */
+declare const AIBadge: React.ForwardRefExoticComponent<AIBadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+interface AIColumnHeaderBarProps extends React.HTMLAttributes<HTMLDivElement> {
+    label: string;
+    /** Fires when the user clicks the "run on all rows" button. */
+    onRun?: () => void;
+    /** Localized tooltip for the run button. */
+    runLabel?: string;
+}
+/**
+ * Header bar tailored for AI columns. The Play button only appears when the
+ * header is hovered (use the `group/aih` named group, scoped to this bar).
+ */
+declare const AIColumnHeaderBar: React.ForwardRefExoticComponent<AIColumnHeaderBarProps & React.RefAttributes<HTMLDivElement>>;
+
+interface AISuggestionDotProps extends Omit<React.HTMLAttributes<HTMLButtonElement>, "onClick"> {
+    /** Short explanation surfaced inside the popover. */
+    reason?: string;
+    /** Current value the AI wants to replace (left side of the arrow). */
+    from?: React.ReactNode;
+    /** Suggested value (right side of the arrow). */
+    to: React.ReactNode;
+    onApply: () => void;
+    onDismiss: () => void;
+    /** Popover anchoring side. Defaults to bottom. */
+    side?: "top" | "right" | "bottom" | "left";
+    /** Localized labels. */
+    title?: string;
+    applyLabel?: string;
+    dismissLabel?: string;
+}
+/**
+ * A pulsing violet dot anchored next to a cell value. Clicking it opens a
+ * popover with the AI's suggestion plus Apply / Dismiss actions.
+ */
+declare const AISuggestionDot: React.ForwardRefExoticComponent<AISuggestionDotProps & React.RefAttributes<HTMLButtonElement>>;
+
+type AIColumnOutputFormat = "text" | "number" | "boolean" | "select" | "date";
+interface AIColumnConfig {
+    name: string;
+    prompt: string;
+    outputFormat: AIColumnOutputFormat;
+    /** Optional consumer-defined slots (model, sources, timeframe…). */
+    extras?: Record<string, unknown>;
+}
+interface AIColumnSidePanelProps {
+    /** Controlled open state. If omitted, behaves uncontrolled via trigger. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Initial config when creating or editing an existing column. */
+    initialConfig?: Partial<AIColumnConfig>;
+    /** Fired with the assembled config when the user saves. */
+    onSave: (config: AIColumnConfig) => void;
+    /** Optional trigger that opens the side panel (uncontrolled mode). */
+    trigger?: React.ReactNode;
+    /** Render slot for model picker, sources, timeframe etc. */
+    extrasSlot?: (extras: AIColumnConfig["extras"], setExtras: (next: AIColumnConfig["extras"]) => void) => React.ReactNode;
+    /** Submit label. Defaults to "Save". */
+    saveLabel?: string;
+    /** Title of the panel. Defaults to "AI column". */
+    title?: string;
+}
+/**
+ * Side panel scaffold for creating or editing an AI column. The shell
+ * (header, body sections, footer) is opinionated; product-specific
+ * controls (model picker, sources picker, timeframe) plug in through
+ * `extrasSlot`.
+ */
+declare function AIColumnSidePanel({ open, onOpenChange, initialConfig, onSave, trigger, extrasSlot, saveLabel, title, }: AIColumnSidePanelProps): react_jsx_runtime.JSX.Element;
+declare namespace AIColumnSidePanel {
+    var displayName: string;
+}
+
+interface HoverCardProps {
+    /** Delay in ms before the card opens after the trigger is hovered. */
+    openDelay?: number;
+    /** Delay in ms before the card closes after the pointer leaves. */
+    closeDelay?: number;
+    /** Controlled open state. If provided, the component is controlled. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    children: React.ReactNode;
+}
+declare function HoverCard({ openDelay, closeDelay, open: controlledOpen, onOpenChange, children, }: HoverCardProps): react_jsx_runtime.JSX.Element;
+interface HoverCardTriggerProps extends React.HTMLAttributes<HTMLElement> {
+    asChild?: boolean;
+    children: React.ReactNode;
+}
+declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardTriggerProps & React.RefAttributes<HTMLElement>>;
+interface HoverCardContentProps extends React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> {
+}
+declare const HoverCardContent: React.ForwardRefExoticComponent<HoverCardContentProps & React.RefAttributes<HTMLDivElement>>;
+
+interface RowQuickAction {
+    icon: IconDefinition;
+    label: string;
+    onClick: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Optional href if the action navigates. */
+    href?: string;
+}
+interface RowQuickActionsProps extends React.HTMLAttributes<HTMLDivElement> {
+    actions: RowQuickAction[];
+    /**
+     * Named hover group to listen to. Defaults to the unnamed group, so the
+     * actions appear when ANY ancestor `group` is hovered. Use a named group
+     * like `"co"` when the row contains nested groups that should not trigger
+     * each other.
+     */
+    group?: string;
+    size?: "sm" | "md";
+}
+/**
+ * A row of icon-only buttons that fade in when the parent row is hovered.
+ * Stops propagation on each button so clicking an action does not trigger
+ * the row's own click handler.
+ */
+declare const RowQuickActions: React.ForwardRefExoticComponent<RowQuickActionsProps & React.RefAttributes<HTMLDivElement>>;
+
+interface EntityCellProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Leading visual. Pass an <Avatar /> or any custom logo / icon.
+     */
+    avatar: React.ReactNode;
+    name: string;
+    /** Optional second line under the name. */
+    subtitle?: string;
+    /**
+     * Status icon, sync indicator, or any small marker rendered after the
+     * name on the same line.
+     */
+    badge?: React.ReactNode;
+    /**
+     * When provided, the name becomes hoverable and opens this content in a
+     * <HoverCard /> with the default delays (350 ms / 120 ms).
+     */
+    hoverCard?: React.ReactNode;
+    /**
+     * Quick actions rendered on the right edge of the cell, only visible when
+     * the row is hovered. The cell sets up a named `co` group so consumers
+     * can nest other hover groups without collisions.
+     */
+    quickActions?: RowQuickAction[];
+    /**
+     * Click handler attached to the name span. Stops propagation so the
+     * caller can also wire a row-level click without conflict.
+     */
+    onNameClick?: (e: React.MouseEvent<HTMLSpanElement>) => void;
+}
+/**
+ * Rich entity cell — avatar + name + optional badge / hover card / quick
+ * actions. Distinct from <AvatarCell /> which stays minimal; use EntityCell
+ * when you need any of the optional slots.
+ */
+declare const EntityCell: React.ForwardRefExoticComponent<EntityCellProps & React.RefAttributes<HTMLDivElement>>;
+
+interface StatusOption {
+    id: string;
+    label: string;
+    /** Badge variant + type/tone to render the pill. */
+    variant?: BadgeProps["variant"];
+    type?: BadgeProps["type"];
+    tone?: BadgeProps["tone"];
+}
+interface StatusPickerCellProps {
+    /** Currently selected option. */
+    current: StatusOption | null;
+    options: StatusOption[];
+    onChange: (id: string) => void;
+    /** When provided, an "Add status" row is rendered at the bottom. */
+    onAddOption?: (label: string) => void;
+    /** When provided, each option row exposes a rename button on hover. */
+    onRenameOption?: (id: string, label: string) => void;
+    /** When provided, a "Sync with CRM" row is rendered at the very bottom. */
+    onSync?: () => void;
+    /** Trigger style. `cell` matches a table cell; `compact` matches inline use. */
+    triggerStyle?: "cell" | "compact";
+    /** Placeholder when no option is selected. */
+    placeholder?: string;
+}
+declare function StatusPickerCell({ current, options, onChange, onAddOption, onRenameOption, onSync, triggerStyle, placeholder, }: StatusPickerCellProps): react_jsx_runtime.JSX.Element;
+declare namespace StatusPickerCell {
+    var displayName: string;
+}
+
+/**
+ * Structural subset of TanStack Table's Column instance. Listing the methods
+ * we need by hand keeps the DS independent from a specific tanstack-table
+ * version while staying assignable from `column: Column<TData>`.
+ */
+interface HeaderColumnApi {
+    getCanSort: () => boolean;
+    getIsSorted: () => "asc" | "desc" | false;
+    toggleSorting: (desc?: boolean) => void;
+    getCanPin: () => boolean;
+    getIsPinned: () => "left" | "right" | false;
+    pin: (side: "left" | "right" | false) => void;
+    getCanHide: () => boolean;
+    toggleVisibility: (visible?: boolean) => void;
+}
+interface ColumnHeaderMenuProps {
+    column: HeaderColumnApi;
+    title: string;
+    /**
+     * Built-in (system) columns cannot be renamed, duplicated, edited or
+     * deleted. Items remain visible but greyed and surface a tooltip
+     * explaining why.
+     */
+    editable: boolean;
+    /** Fires when the user commits a rename via blur or Enter. */
+    onRename?: (name: string) => void;
+    onEdit?: () => void;
+    onDuplicate?: () => void;
+    onDelete?: () => void;
+    /** Tooltip text shown on greyed mutation items. */
+    builtinReason?: string;
+    /** Header content rendered inside the trigger (icon, label…). */
+    children: React.ReactNode;
+}
+declare function ColumnHeaderMenu({ column, title, editable, onRename, onEdit, onDuplicate, onDelete, builtinReason, children, }: ColumnHeaderMenuProps): react_jsx_runtime.JSX.Element;
+declare namespace ColumnHeaderMenu {
+    var displayName: string;
+}
+
+type ColumnKind = "db" | "field" | "score" | "ai";
+interface ColumnTypeBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "type"> {
+    kind: ColumnKind;
+    size?: BadgeProps["size"];
+}
+/**
+ * Small tag identifying the kind of a column inside the column manager.
+ * Maps to existing Badge tones — no new tokens required.
+ */
+declare const ColumnTypeBadge: React.ForwardRefExoticComponent<ColumnTypeBadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+interface ScoreBadgeProps {
+    score: number;
+    matched: number;
+    total: number;
+    size?: BadgeProps["size"];
+    className?: string;
+}
+/**
+ * Displays the result of a score rule evaluation: a colored Badge for the
+ * sign (positive=success, negative=critical, zero=neutral) plus a small
+ * "matched/total" counter on its right.
+ */
+declare const ScoreBadge: React.FC<ScoreBadgeProps>;
+
+interface ColumnManagerItem {
+    id: string;
+    name: string;
+    kind: ColumnKind;
+    /** Whether the column is visible in the current view. */
+    visible: boolean;
+    /** Optional icon rendered before the name (overrides the kind default). */
+    icon?: IconDefinition;
+}
+type AddColumnKind = Exclude<ColumnKind, "db">;
+interface ColumnManagerPopoverProps {
+    items: ColumnManagerItem[];
+    onToggleVisible: (id: string, visible: boolean) => void;
+    /** Deletion is only offered for `kind !== "db"`. */
+    onDelete?: (id: string) => void;
+    /** When provided, the "Add column" section renders the three cards. */
+    onAdd?: (kind: AddColumnKind) => void;
+    /** Trigger element. Receives `onClick` via Radix Anchor. */
+    trigger?: React.ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare function ColumnManagerPopover({ items, onToggleVisible, onDelete, onAdd, trigger, open, onOpenChange, }: ColumnManagerPopoverProps): react_jsx_runtime.JSX.Element;
+declare namespace ColumnManagerPopover {
+    var displayName: string;
+}
+declare function ColumnManagerTrigger(): react_jsx_runtime.JSX.Element;
+
+type FieldType = "text" | "number" | "date" | "select";
+interface FieldColumn {
+    id: string;
+    kind: "field";
+    name: string;
+    fieldType: FieldType;
+    /** Required when fieldType === "select". */
+    options?: string[];
+    createdAt: number;
+}
+type ScoreOperator = "is" | "is_not" | "contains" | "gte" | "lte" | "gt" | "lt" | "eq";
+interface ScoreRule {
+    id: string;
+    /** ID of the field being tested. */
+    fieldId: string;
+    operator: ScoreOperator;
+    value: string | number;
+    /** Points (positive or negative). */
+    weight: number;
+}
+interface ScoreColumn {
+    id: string;
+    kind: "score";
+    name: string;
+    rules: ScoreRule[];
+    createdAt: number;
+}
+interface DbColumn {
+    id: string;
+    kind: "db";
+    name: string;
+}
+interface AIColumnRef {
+    id: string;
+    kind: "ai";
+    name: string;
+}
+/** Union of every column kind that can appear in the column manager. */
+type BrowsableColumn = DbColumn | FieldColumn | ScoreColumn | AIColumnRef;
+declare const SCORE_OPERATORS_BY_TYPE: Record<FieldType, ScoreOperator[]>;
+declare const SCORE_OPERATOR_LABELS: Record<ScoreOperator, string>;
+interface ScoreResult {
+    score: number;
+    matched: number;
+    total: number;
+}
+/**
+ * Compute the score for a row against the rules of a ScoreColumn.
+ * Returns the sum of weights for every matching rule plus a matched/total
+ * counter for display.
+ */
+declare function computeScore(row: Record<string, unknown>, scoreColumn: ScoreColumn): ScoreResult;
+
+interface CreateFieldColumnPanelProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    initial?: Partial<Pick<FieldColumn, "name" | "fieldType" | "options">>;
+    onSave: (column: Omit<FieldColumn, "id" | "createdAt" | "kind">) => void;
+    trigger?: React.ReactNode;
+    title?: string;
+    saveLabel?: string;
+}
+/**
+ * Side panel to create or edit a user-defined Field column (text, number,
+ * date, or single select).
+ */
+declare function CreateFieldColumnPanel({ open, onOpenChange, initial, onSave, trigger, title, saveLabel, }: CreateFieldColumnPanelProps): react_jsx_runtime.JSX.Element;
+
+/** Field descriptor used to populate the field picker in each rule. */
+interface ScorableField {
+    id: string;
+    name: string;
+    fieldType: FieldType;
+    /** For "select" type, the list of allowed values shown in the value picker. */
+    options?: string[];
+}
+interface ScorePreviewRow {
+    id: string;
+    /** Optional leading visual (avatar, icon…). */
+    visual?: React.ReactNode;
+    name: string;
+    /** Map of field id → value, used to evaluate the rules. */
+    values: Record<string, unknown>;
+}
+interface CreateScoreColumnPanelProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    initial?: Partial<Pick<ScoreColumn, "name" | "rules">>;
+    fields: ScorableField[];
+    /** Optional preview rows (typically the first 5 rows of the table). */
+    preview?: ScorePreviewRow[];
+    onSave: (column: Pick<ScoreColumn, "name" | "rules">) => void;
+    trigger?: React.ReactNode;
+    title?: string;
+    saveLabel?: string;
+}
+declare function CreateScoreColumnPanel({ open, onOpenChange, initial, fields, preview, onSave, trigger, title, saveLabel, }: CreateScoreColumnPanelProps): react_jsx_runtime.JSX.Element;
+declare namespace CreateScoreColumnPanel {
+    var displayName: string;
+}
+
 interface BrowserTabItemProps extends React.HTMLAttributes<HTMLDivElement> {
     icon?: IconDefinition;
     label: string;
@@ -82,15 +521,27 @@ interface BulkActionProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "ch
     onClear?: () => void;
     /** Label shown next to the count. Defaults to "selected". */
     countLabel?: string;
-    /** Override the Clear button label. Defaults to "Clear". */
+    /**
+     * Label for the right-side close button. Shown as a hover tooltip and used
+     * as its `aria-label`. Defaults to "Clear".
+     */
     clearLabel?: string;
     /** Action items rendered on the right side. Overflow collapses into a "more" menu. */
     actions: BulkActionItem[];
     /**
-     * When true (default), the bar sticks to the bottom of its scroll container.
-     * Set to false if you position it manually.
+     * @deprecated Prefer `position`. `true` maps to `"sticky"`, `false` to `"static"`.
+     * Kept for backward compatibility; ignored if `position` is set explicitly.
      */
     sticky?: boolean;
+    /**
+     * Where to anchor the bar.
+     * - `"sticky"` (default) — sticks to the bottom of its scroll container.
+     * - `"static"` — flows inline; position it manually.
+     * - `"floating-top"` — pill centred above the parent (the parent must be
+     *   `position: relative`), slides in from the bottom. Use it to float the
+     *   bar just above a pagination footer.
+     */
+    position?: "sticky" | "static" | "floating-top";
 }
 declare const BulkAction: React.ForwardRefExoticComponent<BulkActionProps & React.RefAttributes<HTMLDivElement>>;
 
@@ -182,7 +633,7 @@ interface EmojiPickerPopoverProps extends CommonEmojiPickerProps {
 declare const EmojiPickerPopover: React.ForwardRefExoticComponent<EmojiPickerPopoverProps & React.RefAttributes<HTMLButtonElement>>;
 
 declare const linkVariants: (props?: ({
-    intent?: "success" | "warning" | "neutral" | "alert" | "brand" | null | undefined;
+    intent?: "alert" | "success" | "warning" | "neutral" | "brand" | null | undefined;
     size?: "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>, VariantProps<typeof linkVariants> {
@@ -201,7 +652,7 @@ interface InputLabelProps extends React.ComponentPropsWithoutRef<typeof LabelPri
 declare const InputLabel: React.ForwardRefExoticComponent<InputLabelProps & React.RefAttributes<HTMLLabelElement>>;
 
 declare const infoMessageVariants: (props?: ({
-    type?: "success" | "warning" | "alert" | "info" | "empty" | null | undefined;
+    type?: "alert" | "success" | "warning" | "info" | "ai" | "empty" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface InfoMessageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">, VariantProps<typeof infoMessageVariants> {
     title: React.ReactNode;
@@ -216,7 +667,7 @@ interface InfoMessageProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "t
 declare const InfoMessage: React.ForwardRefExoticComponent<InfoMessageProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const toastVariants: (props?: ({
-    type?: "success" | "warning" | "alert" | "info" | null | undefined;
+    type?: "alert" | "success" | "warning" | "info" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ToastProps extends Omit<React.ComponentPropsWithoutRef<typeof ToastPrimitive.Root>, "title" | "type">, VariantProps<typeof toastVariants> {
     title: React.ReactNode;
@@ -264,17 +715,6 @@ interface AvatarProps extends React.ComponentPropsWithoutRef<typeof AvatarPrimit
 }
 declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLSpanElement>>;
 
-declare const badgeVariants: (props?: ({
-    variant?: "solid" | "light" | "outlined" | null | undefined;
-    type?: "primary" | "success" | "critical" | "warning" | "neutral" | null | undefined;
-    tone?: "indigo" | "rose" | "lime" | "violet" | "cyan" | "orange" | "emerald" | "fuchsia" | "amber" | "slate" | null | undefined;
-    size?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "type">, VariantProps<typeof badgeVariants> {
-    icon?: IconDefinition;
-}
-declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
-
 interface CheckboxProps extends React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> {
     label?: string;
 }
@@ -364,7 +804,7 @@ interface SidebarHeadingItemProps extends React.HTMLAttributes<HTMLDivElement> {
 declare const SidebarHeadingItem: React.ForwardRefExoticComponent<SidebarHeadingItemProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const sidebarItemVariants: (props?: ({
-    state?: "default" | "hover" | "active" | null | undefined;
+    state?: "default" | "active" | "hover" | null | undefined;
     type?: "default" | "collapsed" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SidebarItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "type">, VariantProps<typeof sidebarItemVariants> {
@@ -419,7 +859,7 @@ declare const TabContent: React.ForwardRefExoticComponent<TabContentProps & Reac
 
 declare const tagVariants: (props?: ({
     variant?: "neutral" | "brand" | null | undefined;
-    tone?: "indigo" | "rose" | "lime" | "violet" | "cyan" | "orange" | "emerald" | "fuchsia" | "amber" | "slate" | null | undefined;
+    tone?: "indigo" | "rose" | "lime" | "violet" | "cyan" | "orange" | "emerald" | "fuchsia" | "amber" | "slate" | "teal" | "sky" | "purple" | "pink" | null | undefined;
     size?: "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface TagProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "type">, VariantProps<typeof tagVariants> {
@@ -495,7 +935,7 @@ declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & Re
 
 declare const typographyVariants: (props?: ({
     variant?: "xs" | "sm" | "md" | "lg" | "h2" | "h3" | "h1" | null | undefined;
-    weight?: "bold" | "medium" | "regular" | "semibold" | null | undefined;
+    weight?: "solid" | "medium" | "regular" | "semibold" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface TypographyProps extends React.HTMLAttributes<HTMLElement>, VariantProps<typeof typographyVariants> {
     as?: React.ElementType;
@@ -610,6 +1050,11 @@ interface AvatarCellProps {
     name: string;
     subtitle?: string;
     src?: string;
+    /**
+     * Avatar shape. `"rounded"` (circle) for people, `"squared"` for companies.
+     * @default "rounded"
+     */
+    shape?: "rounded" | "squared";
     className?: string;
 }
 declare const AvatarCell: React.FC<AvatarCellProps>;
@@ -769,6 +1214,18 @@ interface DataTableProps<TData, TValue> {
     emptyMessage?: React.ReactNode;
     /** Add border-top to the header (useful in full-width / no container layouts) */
     bordered?: boolean;
+    /**
+     * Who owns the horizontal scroll container.
+     * - `self` (default) — Table wraps in `<div class="overflow-auto">`.
+     * - `parent` — no wrapping scroll container; parent must scroll. Required
+     *   when sticky column pinning has to compose with a page-level scroll.
+     */
+    scrollContainer?: "self" | "parent";
+    /**
+     * Render slot mounted as a `<th>` at the right end of the header row.
+     * Useful for hosting a custom column manager next to the headers.
+     */
+    columnManagerSlot?: React.ReactNode;
 }
 declare module "@tanstack/react-table" {
     interface ColumnMeta<TData extends unknown, TValue> {
@@ -779,7 +1236,7 @@ declare module "@tanstack/react-table" {
     }
 }
 type FilterOperator = "contains" | "does_not_contain" | "is" | "is_not" | "starts_with" | "ends_with" | "is_empty" | "is_not_empty" | "equals" | "not_equals" | "greater_than" | "less_than" | "greater_than_or_equal" | "less_than_or_equal" | "between" | "is_before" | "is_after" | "is_between" | "is_any_of" | "is_none_of";
-declare function DataTableInner<TData, TValue>({ columns, data, enableSorting, enableFiltering, enablePagination, enableRowSelection, enableColumnVisibility, enableColumnPinning, enableColumnResizing, enableColumnDrag, enableTableSettings, lockedColumnIds, tableSettingsTitle, sorting: sortingProp, onSortingChange, columnFilters: columnFiltersProp, onColumnFiltersChange, pagination: paginationProp, onPaginationChange, rowSelection: rowSelectionProp, onRowSelectionChange, columnVisibility: columnVisibilityProp, onColumnVisibilityChange, columnOrder: columnOrderProp, onColumnOrderChange, columnPinning: columnPinningProp, onColumnPinningChange, children, className, emptyState, emptyMessage, bordered, }: DataTableProps<TData, TValue>): react_jsx_runtime.JSX.Element;
+declare function DataTableInner<TData, TValue>({ columns, data, enableSorting, enableFiltering, enablePagination, enableRowSelection, enableColumnVisibility, enableColumnPinning, enableColumnResizing, enableColumnDrag, enableTableSettings, lockedColumnIds, tableSettingsTitle, sorting: sortingProp, onSortingChange, columnFilters: columnFiltersProp, onColumnFiltersChange, pagination: paginationProp, onPaginationChange, rowSelection: rowSelectionProp, onRowSelectionChange, columnVisibility: columnVisibilityProp, onColumnVisibilityChange, columnOrder: columnOrderProp, onColumnOrderChange, columnPinning: columnPinningProp, onColumnPinningChange, children, className, emptyState, emptyMessage, bordered, scrollContainer, columnManagerSlot, }: DataTableProps<TData, TValue>): react_jsx_runtime.JSX.Element;
 interface DataTablePaginationProps<TData> {
     table: Table$1<TData>;
     pageSizeOptions?: number[];
@@ -790,7 +1247,20 @@ declare const DataTable: typeof DataTableInner & {
     displayName: string;
 };
 
-declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & React.RefAttributes<HTMLTableElement>>;
+type TableScrollContainer = "self" | "parent";
+interface TableProps extends React.HTMLAttributes<HTMLTableElement> {
+    /**
+     * Who owns the horizontal scroll container.
+     * - `self` (default) — Table wraps in `<div class="overflow-auto">`. Good
+     *   for sectioned layouts but breaks sticky column pinning against a page
+     *   scroll.
+     * - `parent` — no wrapping scroll container. The parent layout must
+     *   provide scrolling. Required for sticky column pinning to work against
+     *   the page or a sticky body scroll.
+     */
+    scrollContainer?: TableScrollContainer;
+}
+declare const Table: React.ForwardRefExoticComponent<TableProps & React.RefAttributes<HTMLTableElement>>;
 declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
 declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
 declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
@@ -809,7 +1279,7 @@ interface SidePanelContentProps extends React.ComponentPropsWithoutRef<typeof Di
 declare const SidePanelContent: React.ForwardRefExoticComponent<SidePanelContentProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const filterChipSegmentVariants: (props?: ({
-    type?: "property" | "button" | "value" | "operator" | "placeholder" | null | undefined;
+    type?: "button" | "property" | "operator" | "value" | "placeholder" | null | undefined;
     hasBorder?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface FilterChipSegmentProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "type">, VariantProps<typeof filterChipSegmentVariants> {
@@ -1252,4 +1722,4 @@ declare const DatePickerTrigger: React.ForwardRefExoticComponent<PopoverPrimitiv
 declare const DatePickerPopover: React.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare function getDefaultSuggestions(referenceDate?: Date): DatePickerSuggestion[];
 
-export { AdvancedChip, type AdvancedChipProps, AdvancedPopover, type AdvancedPopoverProps, AdvancedRow, type AdvancedRowProps, Avatar, AvatarCell, type AvatarCellProps, type AvatarProps, Badge, type BadgeProps, type BooleanOperator, BrowserTab, BrowserTabItem, type BrowserTabItemProps, type BrowserTabProps, BulkAction, type BulkActionItem, type BulkActionProps, Button, ButtonCell, type ButtonCellProps, type ButtonProps, Checkbox, type CheckboxProps, ChipInput, type ChipInputProps, DEFAULT_OPERATOR_BY_TYPE, DataTable, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableSettingsModal, type DataTableSettingsModalProps, type DataType, DateCell, type DateCellProps, type DateOperator, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerFooter, type DatePickerFooterProps, type DatePickerMode, DatePickerPanel, type DatePickerPanelProps, DatePickerPopover, type DatePickerProps, DatePickerRoot, DatePickerSelects, type DatePickerSelectsProps, type DatePickerSuggestion, DatePickerSuggestions, type DatePickerSuggestionsProps, DatePickerTrigger, type DateRange, Dialog, type DialogProps, DropdownMenu, DropdownMenuClear, type DropdownMenuClearProps, DropdownMenuContent, DropdownMenuHeading, type DropdownMenuHeadingProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuList, type DropdownMenuListProps, type DropdownMenuProps, DropdownMenuRadixItem, type DropdownMenuRadixItemProps, DropdownMenuRoot, DropdownMenuTrigger, EditableCell, type EditableCellProps, EmailCell, type EmailCellProps, EmojiPicker, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSelection, EmptyState, type EmptyStateProps, type EnumOperator, FilterBar, FilterBarButton, type FilterBarButtonProps, FilterBarLeft, type FilterBarLeftProps, type FilterBarMode, type FilterBarProps, FilterBarRight, type FilterBarRightProps, FilterChip, type FilterChipProps, FilterChipSegment, type FilterChipSegmentProps, type FilterCondition, FilterEditor, type FilterEditorProps, type FilterOperator, type FilterState, FilterSystem, type FilterSystemProps, type FilterValue, InfoMessage, type InfoMessageProps, InputLabel, type InputLabelProps, InteractiveFilterChip, type InteractiveFilterChipProps, KebabMenu, type KebabMenuProps, Link, LinkCell, type LinkCellProps, type LinkProps, Modal, ModalBody, ModalClose, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalOverlay, ModalTitle, ModalTrigger, NumberCell, type NumberCellProps, NumberInput, type NumberInputProps, type NumberOperator, OPERATORS_BY_TYPE, OperatorList, type OperatorListProps, OperatorSelector, type OperatorSelectorProps, type OperatorType, type Product, ProductLogo, type ProductLogoProps, type PropertyDefinition, PropertySelector, type PropertySelectorProps, RadioCard, RadioCardGroup, type RadioCardGroupProps, type RadioCardProps, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RelationOperator, RowActions, type RowActionsProps, SaveViewButton, type SaveViewButtonProps, SearchBar, type SearchBarProps, Select, type SelectProps, SidePanel, SidePanelClose, SidePanelContent, type SidePanelContentProps, SidePanelTrigger, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarHeader, SidebarHeadingItem, type SidebarHeadingItemProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, SortButton, type SortButtonProps, type SortField, StatusCell, type StatusCellProps, SummaryChip, type SummaryChipProps, Switch, SwitchCard, type SwitchCardProps, type SwitchProps, TabContent, type TabContentProps, TabList, type TabListProps, TabTrigger, type TabTriggerProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, type TabsProps, Tag, type TagProps, type TagsOperator, TextArea, type TextAreaProps, TextCell, type TextCellProps, TextInput, type TextInputProps, type TextOperator, Toast, type ToastProps, ToastProvider, ToastViewport, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, TruncatedText, type TruncatedTextProps, Typography, type TypographyProps, UserMenu, UserMenuInfoRow, type UserMenuInfoRowProps, type UserMenuProps, UserMenuSection, type UserMenuSectionProps, ValueInput, type ValueInputProps, avatarVariants, badgeVariants, buttonVariants, chipInputVariants, cn, createFilterWithDefaults, emptyStateVariants, filterChipSegmentVariants, getDefaultOperator, getDefaultSuggestions, getValueInputType, infoMessageVariants, isNoValueOperator, linkVariants, modalVariants, productLogoVariants, searchBarVariants, selectVariants, sidebarItemVariants, tagVariants, textInputVariants, toastVariants, tooltipContentVariants, typographyVariants, useFilterBarMode, useSidebarContext };
+export { AIBadge, type AIBadgeProps, AICell, type AICellProps, type AICellState, type AIColumnConfig, AIColumnHeaderBar, type AIColumnHeaderBarProps, type AIColumnOutputFormat, type AIColumnRef, AIColumnSidePanel, type AIColumnSidePanelProps, type AIRunningVerb, AISuggestionDot, type AISuggestionDotProps, AI_RUNNING_VERBS, type AddColumnKind, AdvancedChip, type AdvancedChipProps, AdvancedPopover, type AdvancedPopoverProps, AdvancedRow, type AdvancedRowProps, Avatar, AvatarCell, type AvatarCellProps, type AvatarProps, Badge, type BadgeProps, type BooleanOperator, type BrowsableColumn, BrowserTab, BrowserTabItem, type BrowserTabItemProps, type BrowserTabProps, BulkAction, type BulkActionItem, type BulkActionProps, Button, ButtonCell, type ButtonCellProps, type ButtonProps, Checkbox, type CheckboxProps, ChipInput, type ChipInputProps, ColumnHeaderMenu, type ColumnHeaderMenuProps, type ColumnKind, type ColumnManagerItem, ColumnManagerPopover, type ColumnManagerPopoverProps, ColumnManagerTrigger, ColumnTypeBadge, type ColumnTypeBadgeProps, CreateFieldColumnPanel, type CreateFieldColumnPanelProps, CreateScoreColumnPanel, type CreateScoreColumnPanelProps, DEFAULT_OPERATOR_BY_TYPE, DataTable, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableSettingsModal, type DataTableSettingsModalProps, type DataType, DateCell, type DateCellProps, type DateOperator, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerFooter, type DatePickerFooterProps, type DatePickerMode, DatePickerPanel, type DatePickerPanelProps, DatePickerPopover, type DatePickerProps, DatePickerRoot, DatePickerSelects, type DatePickerSelectsProps, type DatePickerSuggestion, DatePickerSuggestions, type DatePickerSuggestionsProps, DatePickerTrigger, type DateRange, type DbColumn, Dialog, type DialogProps, DropdownMenu, DropdownMenuClear, type DropdownMenuClearProps, DropdownMenuContent, DropdownMenuHeading, type DropdownMenuHeadingProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuList, type DropdownMenuListProps, type DropdownMenuProps, DropdownMenuRadixItem, type DropdownMenuRadixItemProps, DropdownMenuRoot, DropdownMenuTrigger, EditableCell, type EditableCellProps, EmailCell, type EmailCellProps, EmojiPicker, type EmojiPickerLocale, EmojiPickerPopover, type EmojiPickerPopoverProps, type EmojiPickerProps, type EmojiSelection, EmptyState, type EmptyStateProps, EntityCell, type EntityCellProps, type EnumOperator, type FieldColumn, type FieldType, FilterBar, FilterBarButton, type FilterBarButtonProps, FilterBarLeft, type FilterBarLeftProps, type FilterBarMode, type FilterBarProps, FilterBarRight, type FilterBarRightProps, FilterChip, type FilterChipProps, FilterChipSegment, type FilterChipSegmentProps, type FilterCondition, FilterEditor, type FilterEditorProps, type FilterOperator, type FilterState, FilterSystem, type FilterSystemProps, type FilterValue, type HeaderColumnApi, HoverCard, HoverCardContent, type HoverCardContentProps, type HoverCardProps, HoverCardTrigger, type HoverCardTriggerProps, InfoMessage, type InfoMessageProps, InputLabel, type InputLabelProps, InteractiveFilterChip, type InteractiveFilterChipProps, KebabMenu, type KebabMenuProps, Link, LinkCell, type LinkCellProps, type LinkProps, Modal, ModalBody, ModalClose, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalOverlay, ModalTitle, ModalTrigger, NumberCell, type NumberCellProps, NumberInput, type NumberInputProps, type NumberOperator, OPERATORS_BY_TYPE, OperatorList, type OperatorListProps, OperatorSelector, type OperatorSelectorProps, type OperatorType, type Product, ProductLogo, type ProductLogoProps, type PropertyDefinition, PropertySelector, type PropertySelectorProps, RadioCard, RadioCardGroup, type RadioCardGroupProps, type RadioCardProps, RadioGroup, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RelationOperator, RowActions, type RowActionsProps, type RowQuickAction, RowQuickActions, type RowQuickActionsProps, SCORE_OPERATORS_BY_TYPE, SCORE_OPERATOR_LABELS, SaveViewButton, type SaveViewButtonProps, type ScorableField, ScoreBadge, type ScoreBadgeProps, type ScoreColumn, type ScoreOperator, type ScorePreviewRow, type ScoreResult, type ScoreRule, SearchBar, type SearchBarProps, Select, type SelectProps, SidePanel, SidePanelClose, SidePanelContent, type SidePanelContentProps, SidePanelTrigger, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarHeader, SidebarHeadingItem, type SidebarHeadingItemProps, SidebarItem, type SidebarItemProps, type SidebarProps, SidebarSection, type SidebarSectionProps, SortButton, type SortButtonProps, type SortField, StatusCell, type StatusCellProps, type StatusOption, StatusPickerCell, type StatusPickerCellProps, SummaryChip, type SummaryChipProps, Switch, SwitchCard, type SwitchCardProps, type SwitchProps, TAG_PALETTE, TabContent, type TabContentProps, TabList, type TabListProps, TabTrigger, type TabTriggerProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableProps, TableRow, type TableScrollContainer, Tabs, type TabsProps, Tag, type TagColor, type TagColorName, type TagProps, type TagsOperator, TextArea, type TextAreaProps, TextCell, type TextCellProps, TextInput, type TextInputProps, type TextOperator, Toast, type ToastProps, ToastProvider, ToastViewport, Tooltip, TooltipContent, type TooltipContentProps, TooltipProvider, TooltipTrigger, TruncatedText, type TruncatedTextProps, Typography, type TypographyProps, UserMenu, UserMenuInfoRow, type UserMenuInfoRowProps, type UserMenuProps, UserMenuSection, type UserMenuSectionProps, ValueInput, type ValueInputProps, avatarVariants, badgeVariants, buttonVariants, chipInputVariants, cn, computeScore, createFilterWithDefaults, emptyStateVariants, filterChipSegmentVariants, getDefaultOperator, getDefaultSuggestions, getValueInputType, infoMessageVariants, isNoValueOperator, linkVariants, modalVariants, pickRunningVerb, productLogoVariants, searchBarVariants, selectVariants, sidebarItemVariants, tagColorAt, tagColorFor, tagVariants, textInputVariants, toastVariants, tooltipContentVariants, typographyVariants, useFilterBarMode, useSidebarContext };