entangle-ui 0.2.0 → 0.3.0

package/dist/types/components/primitives/Button/Button.d.ts

@@ -0,0 +1,392 @@
+import React from 'react';
+import { Theme } from '../../../theme/types.js';
+import { Prettify } from '../../../types/utilities.js';
+import { Size, Variant, BaseComponent } from '../../../types/common.js';
+
+/**
+ * Button sizes optimized for editor interfaces
+ */
+type ButtonSize = Size;
+/**
+ * Visual variants for the button
+ */
+type ButtonVariant = Variant;
+/**
+ * Base props for the Button component
+ */
+interface ButtonBaseProps extends BaseComponent<HTMLButtonElement> {
+    /**
+     * Button content — text, icons, or other React elements
+     * @example "Save", <><SaveIcon /> Save</>
+     */
+    children?: React.ReactNode;
+    /**
+     * Size variant optimized for editor interfaces
+     * - `sm`: 20px height, compact for toolbars
+     * - `md`: 24px height, standard for panels
+     * - `lg`: 32px height, prominent actions
+     * @default "md"
+     */
+    size?: ButtonSize;
+    /**
+     * Visual variant of the button
+     * - `default`: Transparent with border, fills on hover
+     * - `ghost`: No border, subtle hover state
+     * - `filled`: Solid background with accent color
+     * @default "default"
+     */
+    variant?: ButtonVariant;
+    /**
+     * Whether the button is disabled
+     * When true, button becomes non-interactive with reduced opacity
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Loading state — shows spinner and disables interaction
+     * Use for async operations like saving, loading data
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Icon element to display before text
+     * Should be 16x16px for optimal appearance
+     * @example <SaveIcon />, <PlayIcon />
+     */
+    icon?: React.ReactNode;
+    /**
+     * Whether the button should take the full width of the container
+     * Useful for form actions and modal buttons
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Click event handler
+     * Called when button is clicked (not when disabled/loading)
+     */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+}
+/**
+ * Props for the Button component with prettified type for better IntelliSense
+ */
+type ButtonProps = Prettify<ButtonBaseProps>;
+/**
+ * Versatile button component for editor interfaces.
+ *
+ * Supports multiple variants, sizes, and states. Optimized for professional
+ * editor interfaces with compact dimensions and precise interactions.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <Button variant="default" size="md">Save</Button>
+ *
+ * // With icon and loading state
+ * <Button
+ *   icon={<SaveIcon />}
+ *   loading={isSaving}
+ *   onClick={handleSave}
+ * >
+ *   Save Project
+ * </Button>
+ *
+ * // Full width button
+ * <Button variant="filled" fullWidth>
+ *   Confirm
+ * </Button>
+ * ```
+ */
+declare const Button: React.NamedExoticComponent<{
+    children?: React.ReactNode;
+    size?: ButtonSize | undefined;
+    variant?: ButtonVariant | undefined;
+    disabled?: boolean | undefined;
+    loading?: boolean | undefined;
+    icon?: React.ReactNode;
+    fullWidth?: boolean | undefined;
+    onClick?: ((event: React.MouseEvent<HTMLButtonElement>) => void) | undefined;
+    id?: string | undefined | undefined;
+    className?: string | undefined | undefined;
+    testId?: string | undefined;
+    style?: React.CSSProperties | undefined;
+    css?: React.CSSProperties | ((theme: Theme) => React.CSSProperties) | undefined;
+    ref?: React.Ref<HTMLButtonElement> | undefined;
+    defaultChecked?: boolean | undefined | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined | undefined;
+    suppressHydrationWarning?: boolean | undefined | undefined;
+    accessKey?: string | undefined | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
+    autoFocus?: boolean | undefined | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined | undefined;
+    dir?: string | undefined | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    hidden?: boolean | undefined | undefined;
+    lang?: string | undefined | undefined;
+    nonce?: string | undefined | undefined;
+    slot?: string | undefined | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    tabIndex?: number | undefined | undefined;
+    title?: string | undefined | undefined;
+    translate?: "yes" | "no" | undefined | undefined;
+    radioGroup?: string | undefined | undefined;
+    role?: React.AriaRole | undefined;
+    about?: string | undefined | undefined;
+    content?: string | undefined | undefined;
+    datatype?: string | undefined | undefined;
+    inlist?: any;
+    prefix?: string | undefined | undefined;
+    property?: string | undefined | undefined;
+    rel?: string | undefined | undefined;
+    resource?: string | undefined | undefined;
+    rev?: string | undefined | undefined;
+    typeof?: string | undefined | undefined;
+    vocab?: string | undefined | undefined;
+    autoCorrect?: string | undefined | undefined;
+    autoSave?: string | undefined | undefined;
+    color?: string | undefined | undefined;
+    itemProp?: string | undefined | undefined;
+    itemScope?: boolean | undefined | undefined;
+    itemType?: string | undefined | undefined;
+    itemID?: string | undefined | undefined;
+    itemRef?: string | undefined | undefined;
+    results?: number | undefined | undefined;
+    security?: string | undefined | undefined;
+    unselectable?: "on" | "off" | undefined | undefined;
+    popover?: "" | "auto" | "manual" | undefined | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined | undefined;
+    popoverTarget?: string | undefined | undefined;
+    inert?: boolean | undefined | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
+    is?: string | undefined | undefined;
+    exportparts?: string | undefined | undefined;
+    part?: string | undefined | undefined;
+    "aria-activedescendant"?: string | undefined | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
+    "aria-braillelabel"?: string | undefined | undefined;
+    "aria-brailleroledescription"?: string | undefined | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-colcount"?: number | undefined | undefined;
+    "aria-colindex"?: number | undefined | undefined;
+    "aria-colindextext"?: string | undefined | undefined;
+    "aria-colspan"?: number | undefined | undefined;
+    "aria-controls"?: string | undefined | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+    "aria-describedby"?: string | undefined | undefined;
+    "aria-description"?: string | undefined | undefined;
+    "aria-details"?: string | undefined | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
+    "aria-errormessage"?: string | undefined | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
+    "aria-keyshortcuts"?: string | undefined | undefined;
+    "aria-label"?: string | undefined | undefined;
+    "aria-labelledby"?: string | undefined | undefined;
+    "aria-level"?: number | undefined | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
+    "aria-owns"?: string | undefined | undefined;
+    "aria-placeholder"?: string | undefined | undefined;
+    "aria-posinset"?: number | undefined | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined | undefined;
+    "aria-rowcount"?: number | undefined | undefined;
+    "aria-rowindex"?: number | undefined | undefined;
+    "aria-rowindextext"?: string | undefined | undefined;
+    "aria-rowspan"?: number | undefined | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
+    "aria-valuemax"?: number | undefined | undefined;
+    "aria-valuemin"?: number | undefined | undefined;
+    "aria-valuenow"?: number | undefined | undefined;
+    "aria-valuetext"?: string | undefined | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined | undefined;
+    onCopy?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLButtonElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLButtonElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLButtonElement> | undefined;
+    onChange?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onChangeCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLButtonElement> | undefined;
+    onBeforeInputCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInput?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInputCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onReset?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onResetCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onSubmit?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onSubmitCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInvalid?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onInvalidCapture?: React.FormEventHandler<HTMLButtonElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLButtonElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLButtonElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLButtonElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLButtonElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLButtonElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLButtonElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onScrollEnd?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onScrollEndCapture?: React.UIEventHandler<HTMLButtonElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLButtonElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLButtonElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLButtonElement> | undefined;
+    onToggle?: React.ToggleEventHandler<HTMLButtonElement> | undefined;
+    onBeforeToggle?: React.ToggleEventHandler<HTMLButtonElement> | undefined;
+    onTransitionCancel?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionCancelCapture?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionRun?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionRunCapture?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionStart?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+    onTransitionStartCapture?: React.TransitionEventHandler<HTMLButtonElement> | undefined;
+}>;
+
+export { Button };
+export type { ButtonBaseProps, ButtonProps, ButtonSize, ButtonVariant };

package/dist/types/components/primitives/Checkbox/Checkbox.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CheckboxProps } from './Checkbox.types.js';
+
+/**
+ * Checkbox component for boolean selection in settings panels,
+ * property inspectors, and form interfaces.
+ *
+ * Supports controlled/uncontrolled modes, indeterminate state,
+ * label positioning, sizes, variants, and error states.
+ *
+ * @example
+ * ```tsx
+ * <Checkbox label="Enable shadows" />
+ * <Checkbox checked={value} onChange={setValue} label="Auto-save" />
+ * <Checkbox indeterminate label="Select all" />
+ * ```
+ */
+declare const Checkbox: React.FC<CheckboxProps>;
+
+export { Checkbox };

package/dist/types/components/primitives/Checkbox/Checkbox.types.d.ts

@@ -0,0 +1,156 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+
+/**
+ * Checkbox size using standard library sizing.
+ */
+type CheckboxSize = Size;
+/**
+ * Checkbox visual variant.
+ */
+type CheckboxVariant = 'default' | 'filled';
+interface CheckboxBaseProps extends Omit<BaseComponent<HTMLButtonElement>, 'onChange'> {
+    /**
+     * Whether the checkbox is checked (controlled)
+     */
+    checked?: boolean;
+    /**
+     * Default checked state (uncontrolled)
+     * @default false
+     */
+    defaultChecked?: boolean;
+    /**
+     * Whether the checkbox is in an indeterminate state.
+     * Used for "select all" patterns when some items are checked.
+     * Takes visual precedence over checked state.
+     * @default false
+     */
+    indeterminate?: boolean;
+    /**
+     * Checkbox label text displayed next to the control
+     */
+    label?: string;
+    /**
+     * Position of the label relative to the checkbox
+     * @default "right"
+     */
+    labelPosition?: 'left' | 'right';
+    /**
+     * Checkbox size
+     * - `sm`: 14px box, compact for dense UIs
+     * - `md`: 16px box, standard for forms
+     * - `lg`: 20px box, prominent settings
+     * @default "md"
+     */
+    size?: CheckboxSize;
+    /**
+     * Visual variant
+     * - `default`: Border-only when unchecked, filled when checked
+     * - `filled`: Subtle background when unchecked, accent when checked
+     * @default "default"
+     */
+    variant?: CheckboxVariant;
+    /**
+     * Whether the checkbox is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the checkbox is required
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Whether the checkbox has an error state
+     * @default false
+     */
+    error?: boolean;
+    /**
+     * Helper text displayed below the checkbox
+     */
+    helperText?: string;
+    /**
+     * Error message displayed when error is true
+     */
+    errorMessage?: string;
+    /**
+     * Value attribute for use in CheckboxGroup
+     */
+    value?: string;
+    /**
+     * Name attribute for form submission
+     */
+    name?: string;
+    /**
+     * Change event handler
+     * @param checked - The new checked state
+     */
+    onChange?: (checked: boolean) => void;
+}
+type CheckboxProps = Prettify<CheckboxBaseProps>;
+interface CheckboxGroupBaseProps extends Omit<BaseComponent, 'onChange'> {
+    /**
+     * Currently selected values (controlled)
+     */
+    value?: string[];
+    /**
+     * Default selected values (uncontrolled)
+     */
+    defaultValue?: string[];
+    /**
+     * Group label
+     */
+    label?: string;
+    /**
+     * Layout direction
+     * @default "column"
+     */
+    direction?: 'row' | 'column';
+    /**
+     * Gap between checkboxes using theme spacing multiplier
+     * @default 2
+     */
+    gap?: number;
+    /**
+     * Whether all checkboxes in the group are disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Size applied to all checkboxes in the group.
+     * Individual checkbox size overrides this.
+     * @default "md"
+     */
+    size?: CheckboxSize;
+    /**
+     * Helper text for the group
+     */
+    helperText?: string;
+    /**
+     * Error state for the group
+     * @default false
+     */
+    error?: boolean;
+    /**
+     * Error message for the group
+     */
+    errorMessage?: string;
+    /**
+     * Whether the group is required
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Checkbox elements to render
+     */
+    children: React.ReactNode;
+    /**
+     * Change event handler
+     * @param value - Array of selected checkbox values
+     */
+    onChange?: (value: string[]) => void;
+}
+type CheckboxGroupProps = Prettify<CheckboxGroupBaseProps>;
+
+export type { CheckboxBaseProps, CheckboxGroupBaseProps, CheckboxGroupProps, CheckboxProps, CheckboxSize, CheckboxVariant };

package/dist/types/components/primitives/Checkbox/CheckboxGroup.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import { CheckboxGroupProps } from './Checkbox.types.js';
+
+/**
+ * Groups multiple Checkbox components with shared state management.
+ *
+ * Manages a `string[]` value, propagates `disabled` and `size` to children
+ * via React Context. Supports controlled and uncontrolled modes.
+ *
+ * @example
+ * ```tsx
+ * <CheckboxGroup
+ *   label="Render passes"
+ *   value={selected}
+ *   onChange={setSelected}
+ * >
+ *   <Checkbox value="diffuse" label="Diffuse" />
+ *   <Checkbox value="specular" label="Specular" />
+ *   <Checkbox value="shadow" label="Shadow" />
+ * </CheckboxGroup>
+ * ```
+ */
+declare const CheckboxGroup: React.FC<CheckboxGroupProps>;
+
+export { CheckboxGroup };

package/dist/types/components/primitives/Collapsible/Collapsible.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { CollapsibleProps } from './Collapsible.types.js';
+
+declare const Collapsible: React.FC<CollapsibleProps>;
+
+export { Collapsible };

package/dist/types/components/primitives/Collapsible/Collapsible.types.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+
+type CollapsibleSize = Size;
+interface CollapsibleBaseProps extends Omit<BaseComponent, 'onChange'> {
+    /** Content shown in the collapsible header/trigger */
+    trigger: React.ReactNode;
+    /** Whether expanded (controlled) */
+    open?: boolean;
+    /** Default expanded state (uncontrolled) @default false */
+    defaultOpen?: boolean;
+    /** Size @default "sm" */
+    size?: CollapsibleSize;
+    /** Custom indicator icon, or null to hide the indicator @default built-in chevron */
+    indicator?: React.ReactNode | null;
+    /** Whether disabled @default false */
+    disabled?: boolean;
+    /** Keep content in DOM when collapsed @default false */
+    keepMounted?: boolean;
+    /** Callback when open state changes */
+    onChange?: (open: boolean) => void;
+    /** Content to render when expanded */
+    children: React.ReactNode;
+}
+type CollapsibleProps = Prettify<CollapsibleBaseProps>;
+
+export type { CollapsibleBaseProps, CollapsibleProps, CollapsibleSize };

package/dist/types/components/primitives/Icon/Icon.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import { LiteralUnion, Prettify } from '../../../types/utilities.js';
+import { Size } from '../../../types/common.js';
+import { Theme } from '../../../theme/types.js';
+
+type IconSize = Size;
+type IconColor = LiteralUnion<'primary' | 'secondary' | 'muted' | 'accent' | 'success' | 'warning' | 'error'>;
+interface IconBaseProps {
+    children: React.ReactNode;
+    size?: IconSize;
+    color?: IconColor;
+    className?: string;
+    title?: string;
+    decorative?: boolean;
+    /**
+     * Custom CSS styles included in styled-components
+     * Can be an object of CSS properties or a function that receives theme and returns CSS properties
+     */
+    css?: React.CSSProperties | ((theme: Theme) => React.CSSProperties) | undefined;
+    /**
+     * Test identifier for automated testing
+     */
+    testId?: string;
+    ref?: React.Ref<SVGSVGElement>;
+}
+type IconProps = Prettify<IconBaseProps>;
+declare const Icon: React.NamedExoticComponent<{
+    children: React.ReactNode;
+    size?: IconSize | undefined;
+    color?: IconColor | undefined;
+    className?: string | undefined;
+    title?: string | undefined;
+    decorative?: boolean | undefined;
+    css?: React.CSSProperties | ((theme: Theme) => React.CSSProperties) | undefined;
+    testId?: string | undefined;
+    ref?: React.Ref<SVGSVGElement> | undefined;
+}>;
+
+export { Icon };
+export type { IconBaseProps, IconColor, IconProps, IconSize };