@mirror-physics/fractal-ui 0.2.0-next.78 → 0.2.0-next.80

package/dist/index.d.cts

@@ -4,7 +4,7 @@ import { ClassValue } from 'clsx';
 export { ColumnEditor, ColumnEditorItem, ColumnEditorProps } from './column-editor.cjs';
 
 /** Shared density scale for single-line controls and their labels. */
-type ControlSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+type ControlSize = 'sm' | 'md' | 'lg' | 'xl';
 
 type ButtonType = 'primary' | 'secondary' | 'ghost' | 'danger';
 type ButtonSize = ControlSize;
@@ -16,7 +16,7 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     controlSize?: ControlSize;
     /** Backward-compatible alias for controlSize. */
     buttonSize?: ButtonSize;
-    /** Color theme — maps to the design system's color scales. */
+    /** Explicit primary color preset. Omit to inherit the application's primary tokens. */
     color?: ButtonColor;
     /** Icon element. */
     icon?: React.ReactNode;
@@ -107,6 +107,8 @@ declare const PromptGrid: React.ForwardRefExoticComponent<PromptGridProps & Reac
 interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
     /** Visual density; native `size` still controls the character-width hint. */
     controlSize?: ControlSize;
+    /** Persistent title that floats into the border on focus or when filled. Search uses it only as an accessible name. */
+    fieldLabel?: string;
 }
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 
@@ -288,9 +290,18 @@ interface DropdownItem {
 }
 interface DropdownProps {
     items: DropdownItem[];
-    selectedValue: string;
-    onSelect: (value: string) => void;
+    selectedValue?: string;
+    onSelect?: (value: string) => void;
+    /** Checkbox-style options that remain open after selection. */
+    multiple?: boolean;
+    selectedValues?: string[];
+    onSelectionChange?: (values: string[]) => void;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    emptyMessage?: string;
     triggerLabel?: string;
+    /** Floating field title. Empty selectedValue is the unfilled state. */
+    fieldLabel?: string;
     direction?: 'up' | 'down' | 'left' | 'right';
     /** Preferred alignment; shifted as needed to stay inside visible bounds. */
     align?: 'left' | 'right';
@@ -318,7 +329,7 @@ interface DropdownProps {
     closeOnSelect?: boolean;
     disabled?: boolean;
 }
-declare function Dropdown({ items, selectedValue, onSelect, triggerLabel, direction, align, maxHeight, collisionPadding, triggerOrientation, triggerContent, label, iconOnly, noChevron, size: sizeAlias, controlSize, triggerId, triggerVariant, className, triggerClassName, panelClassName, closeOnSelect, disabled, }: DropdownProps): React.JSX.Element | null;
+declare function Dropdown({ items, selectedValue, onSelect, multiple, selectedValues, onSelectionChange, searchable, searchPlaceholder, emptyMessage, triggerLabel, fieldLabel, direction, align, maxHeight, collisionPadding, triggerOrientation, triggerContent, label, iconOnly, noChevron, size: sizeAlias, controlSize, triggerId, triggerVariant, className, triggerClassName, panelClassName, closeOnSelect, disabled, }: DropdownProps): React.JSX.Element | null;
 
 type LinkTheme = 'default' | 'muted' | 'accent';
 type LinkSize = 'sm' | 'md' | 'lg';
@@ -634,6 +645,10 @@ interface SidePanelProps {
 declare function SidePanel({ open, onClose, title, description, children, footer, size, loading, loadingLabel, className }: SidePanelProps): React.ReactPortal | null;
 
 interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** Persistent title: starts on the first line, floats into the border on focus or when filled. */
+    fieldLabel?: string;
+    /** Prose uses the input font; source preserves the existing monospace treatment. */
+    textStyle?: 'prose' | 'source';
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { ClassValue } from 'clsx';
 export { ColumnEditor, ColumnEditorItem, ColumnEditorProps } from './column-editor.js';
 
 /** Shared density scale for single-line controls and their labels. */
-type ControlSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+type ControlSize = 'sm' | 'md' | 'lg' | 'xl';
 
 type ButtonType = 'primary' | 'secondary' | 'ghost' | 'danger';
 type ButtonSize = ControlSize;
@@ -16,7 +16,7 @@ interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     controlSize?: ControlSize;
     /** Backward-compatible alias for controlSize. */
     buttonSize?: ButtonSize;
-    /** Color theme — maps to the design system's color scales. */
+    /** Explicit primary color preset. Omit to inherit the application's primary tokens. */
     color?: ButtonColor;
     /** Icon element. */
     icon?: React.ReactNode;
@@ -107,6 +107,8 @@ declare const PromptGrid: React.ForwardRefExoticComponent<PromptGridProps & Reac
 interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
     /** Visual density; native `size` still controls the character-width hint. */
     controlSize?: ControlSize;
+    /** Persistent title that floats into the border on focus or when filled. Search uses it only as an accessible name. */
+    fieldLabel?: string;
 }
 declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 
@@ -288,9 +290,18 @@ interface DropdownItem {
 }
 interface DropdownProps {
     items: DropdownItem[];
-    selectedValue: string;
-    onSelect: (value: string) => void;
+    selectedValue?: string;
+    onSelect?: (value: string) => void;
+    /** Checkbox-style options that remain open after selection. */
+    multiple?: boolean;
+    selectedValues?: string[];
+    onSelectionChange?: (values: string[]) => void;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    emptyMessage?: string;
     triggerLabel?: string;
+    /** Floating field title. Empty selectedValue is the unfilled state. */
+    fieldLabel?: string;
     direction?: 'up' | 'down' | 'left' | 'right';
     /** Preferred alignment; shifted as needed to stay inside visible bounds. */
     align?: 'left' | 'right';
@@ -318,7 +329,7 @@ interface DropdownProps {
     closeOnSelect?: boolean;
     disabled?: boolean;
 }
-declare function Dropdown({ items, selectedValue, onSelect, triggerLabel, direction, align, maxHeight, collisionPadding, triggerOrientation, triggerContent, label, iconOnly, noChevron, size: sizeAlias, controlSize, triggerId, triggerVariant, className, triggerClassName, panelClassName, closeOnSelect, disabled, }: DropdownProps): React.JSX.Element | null;
+declare function Dropdown({ items, selectedValue, onSelect, multiple, selectedValues, onSelectionChange, searchable, searchPlaceholder, emptyMessage, triggerLabel, fieldLabel, direction, align, maxHeight, collisionPadding, triggerOrientation, triggerContent, label, iconOnly, noChevron, size: sizeAlias, controlSize, triggerId, triggerVariant, className, triggerClassName, panelClassName, closeOnSelect, disabled, }: DropdownProps): React.JSX.Element | null;
 
 type LinkTheme = 'default' | 'muted' | 'accent';
 type LinkSize = 'sm' | 'md' | 'lg';
@@ -634,6 +645,10 @@ interface SidePanelProps {
 declare function SidePanel({ open, onClose, title, description, children, footer, size, loading, loadingLabel, className }: SidePanelProps): React.ReactPortal | null;
 
 interface TextareaProps extends React.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** Persistent title: starts on the first line, floats into the border on focus or when filled. */
+    fieldLabel?: string;
+    /** Prose uses the input font; source preserves the existing monospace treatment. */
+    textStyle?: 'prose' | 'source';
 }
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;