@petrarca/sonnet-ui 0.4.1 → 0.5.0

package/dist/index.d.ts

@@ -50,6 +50,49 @@ interface ButtonProps$1 extends React$1.ButtonHTMLAttributes<HTMLButtonElement>,
 }
 declare const Button: React$1.ForwardRefExoticComponent<ButtonProps$1 & React$1.RefAttributes<HTMLButtonElement>>;
 
+/**
+ * IconButton -- a compact, square icon-only button with an accessible label
+ * and a tooltip. The house standard for inline affordances (rename, delete,
+ * edit) and small toolbar actions across the Sonnet apps.
+ *
+ * - `variant` defaults to "ghost" (borderless, for inline/hover-reveal rows).
+ *   Use "outline" for standalone toolbar buttons.
+ * - `tone="destructive"` tints the hover state red (e.g. delete).
+ * - The `label` is both the tooltip text and the aria-label, so the button is
+ *   always accessible without visible text.
+ * - Do not size the icon yourself: the underlying Button forces child SVGs to
+ *   `size-4` (16px), so pass a bare `<Icon />` (no h-/w- class).
+ * - `revealOnHover` applies the house row-action convention: the button is
+ *   hidden at rest and revealed when the row is hovered or the button is
+ *   keyboard-focused; a disabled action stays faintly visible (opacity-30)
+ *   rather than hidden. The row must set the `group/row` class for this.
+ *
+ * Usage:
+ *   <IconButton label="Delete" tone="destructive" onClick={...}>
+ *     <Trash2 />
+ *   </IconButton>
+ *
+ *   // row-action (parent row has className="... group/row"):
+ *   <IconButton label="Edit" revealOnHover onClick={...}><Pencil /></IconButton>
+ */
+interface IconButtonProps extends Omit<ButtonProps$1, "size" | "children" | "aria-label"> {
+    /** Tooltip text and accessible label. */
+    label: string;
+    /** The icon to render. */
+    children: React$1.ReactNode;
+    /** Hover tone. "destructive" tints hover red. Default "default". */
+    tone?: "default" | "destructive";
+    /** Tooltip side. */
+    tooltipSide?: "top" | "right" | "bottom" | "left";
+    /**
+     * Row-action reveal: hidden at rest, shown on row hover (`group/row`) or
+     * keyboard focus. Disabled buttons stay at opacity-30 instead of hidden, so
+     * the affordance reads as "present but unavailable". Default false.
+     */
+    revealOnHover?: boolean;
+}
+declare const IconButton: React$1.ForwardRefExoticComponent<IconButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
 declare const Card: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 declare const CardTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
@@ -413,6 +456,12 @@ interface TabsListProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrim
 declare const TabsList: React$1.ForwardRefExoticComponent<TabsListProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const TabsTrigger: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const TabsContent: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * TabsSeparator -- a thin, non-interactive vertical divider placed inside a
+ * TabsList to visually group related triggers (e.g. preview tabs vs. source
+ * tabs). Presentational only; not part of the roving-tabindex order.
+ */
+declare const TabsSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 
 declare const Textarea: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref"> & React$1.RefAttributes<HTMLTextAreaElement>>;
 
@@ -623,6 +672,23 @@ declare function createRenderer<TRow = Record<string, unknown>>(render: (row: TR
  * Extractable to @petrarca/sonnet-ui.
  */
 
+/** How a row's detail (onRowClick) is opened. */
+type RowActivation = "click" | "double-click";
+/**
+ * Props of EntityTable that can be defaulted app-wide via SonnetConfigProvider.
+ * Behavioral, non-data props only.
+ */
+interface EntityTableConfigurable {
+    rowActivation: RowActivation;
+    showChevron: boolean;
+}
+declare module "@petrarca/sonnet-core" {
+    interface SonnetComponentDefaults {
+        EntityTable?: {
+            defaultProps?: Partial<EntityTableConfigurable>;
+        };
+    }
+}
 /** Declarative row action rendered as a button in a trailing "Actions" column. */
 interface RowAction<TRow> {
     label: string;
@@ -646,6 +712,30 @@ interface EntityTableProps<TRow extends RowData> {
     isFiltered?: boolean;
     emptyMessage?: string;
     onRowClick?: (row: TRow) => void;
+    /**
+     * How onRowClick (open detail) is triggered. Resolved against app-wide
+     * config (SonnetConfigProvider) then the built-in default "click".
+     *
+     *   "click"        -- single-click on a row opens detail (default,
+     *                     preserves existing behavior). The chevron is a
+     *                     non-interactive affordance.
+     *   "double-click" -- single-click sets the active row (and fires
+     *                     onActiveRowChange); double-click, or clicking the
+     *                     trailing chevron button, opens detail.
+     */
+    rowActivation?: RowActivation;
+    /**
+     * Fired when the active (single-selected) row changes. Only meaningful when
+     * rowActivation is "double-click" and selectionMode is off. null when the
+     * active row is cleared.
+     */
+    onActiveRowChange?: (row: TRow | null) => void;
+    /**
+     * Whether to show the trailing chevron column. Resolved against app-wide
+     * config then a built-in default of "show when onRowClick is set". In
+     * "double-click" mode the chevron is an interactive button that opens detail.
+     */
+    showChevron?: boolean;
     selectionMode?: boolean;
     onSelectionChange?: (selectedRows: TRow[]) => void;
     pagination?: PaginationState;
@@ -655,22 +745,29 @@ interface EntityTableProps<TRow extends RowData> {
 declare function EntityTable<TRow extends RowData>(props: EntityTableProps<TRow>): React__default.ReactElement;
 
 /**
- * PropertyList — read-only display of a record's properties as a stacked list.
+ * PropertyList — read-only display of a record's properties.
  *
- * Layout matches the established graph node/edge cards: an uppercase muted key
- * label above each value, values rendered by {@link PropertyValue}. Optional
- * per-property schema refines value rendering (schema is NOT required).
+ * Two layout modes:
+ * - `"inline"` (default) — horizontal two-column grid, key left / value right.
+ * - `"stacked"` — key label above each value.
+ *
+ * Values rendered by {@link PropertyValue}. Optional per-property schema
+ * refines value rendering (schema is NOT required).
  *
  * Shared by the graph view's node/edge cards and the table inspector so all
  * property displays look identical.
  */
 
+/** Layout mode for the property list. */
+type PropertyListLayout = "inline" | "stacked";
 interface PropertyListProps {
     /** Property name -> value. */
     properties: Record<string, unknown>;
     /** Optional property name -> schema, to refine value rendering. */
     propertySchemas?: Record<string, JsonSchemaProperty>;
-    /** Show a "PROPERTIES" section header. Default false. */
+    /** Layout mode. Default "inline" (horizontal key-value grid). */
+    layout?: PropertyListLayout;
+    /** Show a "Properties" section header. Default false. */
     showHeader?: boolean;
     /** Click value to copy it to the clipboard. Default true. */
     copyable?: boolean;
@@ -678,7 +775,7 @@ interface PropertyListProps {
     emptyLabel?: string;
     className?: string;
 }
-declare function PropertyList({ properties, propertySchemas, showHeader, copyable, emptyLabel, className, }: PropertyListProps): React__default.ReactElement;
+declare function PropertyList({ properties, propertySchemas, layout, showHeader, copyable, emptyLabel, className, }: PropertyListProps): React__default.ReactElement;
 
 /**
  * PropertyValue — read-only, type-aware rendering of a single property value.
@@ -737,6 +834,13 @@ interface EntitySelectProps {
     minChars?: number;
     /** Currently selected value (controlled). */
     value?: string | null;
+    /**
+     * The option for the current value, supplying its label. Use when the
+     * selected value is set before any options have loaded (e.g. an edit form
+     * in typeahead/explicit mode) so the trigger can render the label without
+     * fetching the full list. Must match `value`; ignored otherwise.
+     */
+    selectedOption?: EntityOption | null;
     /** Called when the selection changes. */
     onChange?: (value: string | null) => void;
     /** Called when the selection changes, passing the full option (value + label). */
@@ -753,6 +857,12 @@ interface EntitySelectProps {
     emptyMessage?: string;
     /** Whether the field is required (shows asterisk). */
     required?: boolean;
+    /**
+     * Show a clear (X) affordance that resets the selection to null when a value
+     * is set. Use for optional entity references (e.g. an assignment that can be
+     * removed). Ignored when required or disabled.
+     */
+    clearable?: boolean;
     /** Whether the select is disabled. */
     disabled?: boolean;
     /** Description text below the label. */
@@ -1080,4 +1190,4 @@ type Props = {
  */
 declare function ClipboardMenu({ onAddItem }: Props): react_jsx_runtime.JSX.Element;
 
-export { Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, CELL_RENDERERS, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellRenderer, type CellRendererProps, Checkbox, ClipboardButton, ClipboardItemComponent as ClipboardItem, ClipboardMenu, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntitySelect, type EntitySelectProps, EntityTable, type EntityTableProps, EntityTree, type EntityTreeHandle, type EntityTreeProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, Popover, PopoverContent, PopoverTrigger, PropertyList, type PropertyListProps, PropertyValue, type PropertyValueProps, ResizeHandle, type ResizeHandleProps, type ResolvedColumn, type RowAction, ScrollArea, ScrollBar, SearchInput, type SearchMode, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, SimpleGroup, SimpleStack, SimpleTooltip, Skeleton, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, type StepperProps, StepperSeparator, StepperTitle, StepperTrigger, type TableUiSchema, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewHandle, type TreeViewProps, badgeVariants, buttonVariants, createRenderer, useStore as useStepper };
+export { Alert, AlertDescription, AlertTitle, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Button, CELL_RENDERERS, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellRenderer, type CellRendererProps, Checkbox, ClipboardButton, ClipboardItemComponent as ClipboardItem, ClipboardMenu, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntitySelect, type EntitySelectProps, EntityTable, type EntityTableProps, EntityTree, type EntityTreeHandle, type EntityTreeProps, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, Label, Popover, PopoverContent, PopoverTrigger, PropertyList, type PropertyListLayout, type PropertyListProps, PropertyValue, type PropertyValueProps, ResizeHandle, type ResizeHandleProps, type ResolvedColumn, type RowAction, ScrollArea, ScrollBar, SearchInput, type SearchMode, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, SimpleGroup, SimpleStack, SimpleTooltip, Skeleton, Spinner, Stepper, StepperContent, StepperDescription, StepperIndicator, StepperItem, StepperList, StepperNext, StepperPrev, type StepperProps, StepperSeparator, StepperTitle, StepperTrigger, type TableUiSchema, Tabs, TabsContent, TabsList, TabsSeparator, TabsTrigger, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type TreeNode, TreeView, type TreeViewHandle, type TreeViewProps, badgeVariants, buttonVariants, createRenderer, useStore as useStepper };