entangle-ui 0.2.0 → 0.3.0

package/dist/types/components/layout/PanelSurface/PanelSurface.types.d.ts

@@ -0,0 +1,64 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { Size, BaseComponent } from '../../../types/common.js';
+
+type PanelSurfaceSize = Size;
+interface PanelSurfaceBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'children'> {
+    /**
+     * Panel content. Typically PanelSurface.Header + PanelSurface.Body (+ optional Footer).
+     */
+    children?: React.ReactNode;
+    /**
+     * Visual density for header/footer chrome.
+     * @default "md"
+     */
+    size?: PanelSurfaceSize;
+    /**
+     * Whether to show a border around the panel.
+     * @default true
+     */
+    bordered?: boolean;
+    /**
+     * Optional panel background. Supports solid colors and gradients.
+     * @example "linear-gradient(180deg, #2f3442 0%, #1b202a 100%)"
+     */
+    background?: string;
+}
+type PanelSurfaceProps = Prettify<PanelSurfaceBaseProps>;
+interface PanelSurfaceHeaderBaseProps extends BaseComponent<HTMLDivElement> {
+    /**
+     * Header content (title/label section).
+     */
+    children?: React.ReactNode;
+    /**
+     * Optional actions shown on the right side of the header.
+     */
+    actions?: React.ReactNode;
+}
+type PanelSurfaceHeaderProps = Prettify<PanelSurfaceHeaderBaseProps>;
+interface PanelSurfaceBodyBaseProps extends BaseComponent<HTMLDivElement> {
+    /**
+     * Main panel content.
+     */
+    children?: React.ReactNode;
+    /**
+     * Enables automatic scrolling for body content.
+     * @default false
+     */
+    scroll?: boolean;
+    /**
+     * Body padding. Number values are treated as px.
+     * @default 0
+     */
+    padding?: number | string;
+}
+type PanelSurfaceBodyProps = Prettify<PanelSurfaceBodyBaseProps>;
+interface PanelSurfaceFooterBaseProps extends BaseComponent<HTMLDivElement> {
+    /**
+     * Footer content.
+     */
+    children?: React.ReactNode;
+}
+type PanelSurfaceFooterProps = Prettify<PanelSurfaceFooterBaseProps>;
+
+export type { PanelSurfaceBaseProps, PanelSurfaceBodyBaseProps, PanelSurfaceBodyProps, PanelSurfaceFooterBaseProps, PanelSurfaceFooterProps, PanelSurfaceHeaderBaseProps, PanelSurfaceHeaderProps, PanelSurfaceProps, PanelSurfaceSize };

package/dist/types/components/layout/ScrollArea/ScrollArea.d.ts

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

package/dist/types/components/layout/ScrollArea/ScrollArea.types.d.ts

@@ -0,0 +1,93 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent } from '../../../types/common.js';
+
+/**
+ * Which axes can scroll.
+ */
+type ScrollAreaDirection = 'vertical' | 'horizontal' | 'both';
+/**
+ * Scrollbar visibility behavior.
+ * - `auto`: Show on scroll/hover, hide after idle timeout
+ * - `always`: Always visible
+ * - `hover`: Show only when hovering the scroll area
+ * - `never`: Hide scrollbars entirely (still scrollable via wheel/touch)
+ */
+type ScrollbarVisibility = 'auto' | 'always' | 'hover' | 'never';
+interface ScrollAreaBaseProps extends BaseComponent {
+    /**
+     * Scrollable content
+     */
+    children: React.ReactNode;
+    /**
+     * Scroll direction
+     * @default "vertical"
+     */
+    direction?: ScrollAreaDirection;
+    /**
+     * Scrollbar visibility behavior
+     * @default "auto"
+     */
+    scrollbarVisibility?: ScrollbarVisibility;
+    /**
+     * Delay in ms before scrollbar auto-hides
+     * Only applies when scrollbarVisibility is "auto"
+     * @default 1000
+     */
+    hideDelay?: number;
+    /**
+     * Scrollbar width in pixels
+     * @default 6
+     */
+    scrollbarWidth?: number;
+    /**
+     * Minimum scrollbar thumb length in pixels
+     * @default 30
+     */
+    minThumbLength?: number;
+    /**
+     * Padding between scrollbar and content edge in pixels
+     * @default 2
+     */
+    scrollbarPadding?: number;
+    /**
+     * Whether to show fade masks at scroll boundaries
+     * @default false
+     */
+    fadeMask?: boolean;
+    /**
+     * Height of the fade mask gradient in pixels
+     * @default 24
+     */
+    fadeMaskHeight?: number;
+    /**
+     * Maximum height of the scroll area
+     */
+    maxHeight?: number | string;
+    /**
+     * Maximum width of the scroll area
+     */
+    maxWidth?: number | string;
+    /**
+     * When true, the scroll area fills its parent container
+     * by setting width/height to 100%. Useful inside flex/grid layouts
+     * where the parent controls the size.
+     * @default false
+     */
+    autoFill?: boolean;
+    /**
+     * Callback when scroll position changes
+     */
+    onScroll?: (event: React.UIEvent<HTMLDivElement>) => void;
+    /**
+     * Callback when scroll reaches top edge
+     */
+    onScrollTop?: () => void;
+    /**
+     * Callback when scroll reaches bottom edge
+     */
+    onScrollBottom?: () => void;
+}
+type ScrollAreaProps = Prettify<ScrollAreaBaseProps>;
+
+export type { ScrollAreaBaseProps, ScrollAreaDirection, ScrollAreaProps, ScrollbarVisibility };

package/dist/types/components/layout/Spacer/Spacer.d.ts

@@ -0,0 +1,329 @@
+import React from 'react';
+import { Theme } from '../../../theme/types.js';
+
+/**
+ * A flexible spacer component that expands to fill available space.
+ *
+ * Perfect for pushing elements apart in flex layouts (Stack, Flex components).
+ * By default, it grows to fill available space. Can also be used with fixed size.
+ *
+ * @example
+ * ```tsx
+ * // Auto-expanding spacer (pushes elements apart)
+ * <Stack direction="row">
+ *   <Button>Left</Button>
+ *   <Spacer />
+ *   <Button>Right</Button>
+ * </Stack>
+ *
+ * // Fixed size spacer
+ * <Stack direction="column">
+ *   <Title>Header</Title>
+ *   <Spacer size="2rem" />
+ *   <Content>Body</Content>
+ * </Stack>
+ *
+ * // Multiple spacers for even distribution
+ * <Flex direction="row">
+ *   <Logo />
+ *   <Spacer />
+ *   <Navigation />
+ *   <Spacer />
+ *   <UserMenu />
+ * </Flex>
+ *
+ * // Numeric size
+ * <Stack>
+ *   <Item />
+ *   <Spacer size={20} />
+ *   <Item />
+ * </Stack>
+ * ```
+ */
+declare const Spacer: React.NamedExoticComponent<{
+    size?: string | number | undefined | undefined;
+    css?: React.CSSProperties | ((theme: Theme) => React.CSSProperties) | 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;
+    className?: string | 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;
+    id?: string | undefined | undefined;
+    lang?: string | undefined | undefined;
+    nonce?: string | undefined | undefined;
+    slot?: string | undefined | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    style?: React.CSSProperties | 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<HTMLDivElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLDivElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLDivElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLDivElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLDivElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLDivElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLDivElement> | undefined;
+    onChange?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onChangeCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLDivElement> | undefined;
+    onBeforeInputCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onInput?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onInputCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onReset?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onResetCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onSubmit?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onSubmitCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onInvalid?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onInvalidCapture?: React.FormEventHandler<HTMLDivElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLDivElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLDivElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLDivElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLDivElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLDivElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLDivElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLDivElement> | undefined;
+    onScrollEnd?: React.UIEventHandler<HTMLDivElement> | undefined;
+    onScrollEndCapture?: React.UIEventHandler<HTMLDivElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLDivElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLDivElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLDivElement> | undefined;
+    onToggle?: React.ToggleEventHandler<HTMLDivElement> | undefined;
+    onBeforeToggle?: React.ToggleEventHandler<HTMLDivElement> | undefined;
+    onTransitionCancel?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionCancelCapture?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionRun?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionRunCapture?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionStart?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    onTransitionStartCapture?: React.TransitionEventHandler<HTMLDivElement> | undefined;
+    testId?: string | undefined;
+    ref?: React.Ref<HTMLDivElement> | undefined;
+}>;
+
+export { Spacer };

package/dist/types/components/layout/SplitPane/SplitPane.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { SplitPaneProps } from './SplitPane.types.js';
+
+/**
+ * A resizable split-pane layout component.
+ *
+ * Divides space between two or more child panels with draggable dividers.
+ * Supports horizontal and vertical directions, controlled and uncontrolled
+ * modes, collapsible panels, and keyboard-accessible dividers.
+ *
+ * @example
+ * ```tsx
+ * <SplitPane direction="horizontal">
+ *   <SplitPanePanel>Left</SplitPanePanel>
+ *   <SplitPanePanel>Right</SplitPanePanel>
+ * </SplitPane>
+ * ```
+ */
+declare const SplitPane: React.FC<SplitPaneProps>;
+
+export { SplitPane };

package/dist/types/components/layout/SplitPane/SplitPane.types.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import { BaseComponent } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+
+/**
+ * Split direction.
+ * - `horizontal`: panels side by side (divider is a vertical bar)
+ * - `vertical`: panels stacked (divider is a horizontal bar)
+ */
+type SplitDirection = 'horizontal' | 'vertical';
+/**
+ * Panel size - number for pixels, string for CSS values (e.g. "30%").
+ */
+type PanelSize = number | string;
+/**
+ * Configuration for a single panel.
+ */
+interface PanelConfig {
+    /** Initial size in pixels or CSS value (e.g. "30%") */
+    defaultSize?: PanelSize;
+    /** Minimum size in pixels */
+    minSize?: number;
+    /** Maximum size in pixels */
+    maxSize?: number;
+    /**
+     * Whether this panel can collapse to zero width/height
+     * @default false
+     */
+    collapsible?: boolean;
+    /**
+     * Size threshold below which the panel snaps to collapsed.
+     * Only used when collapsible is true.
+     * @default minSize / 2
+     */
+    collapseThreshold?: number;
+}
+interface SplitPaneBaseProps extends BaseComponent {
+    /**
+     * Split direction
+     * - `horizontal`: panes side by side (divider is vertical bar)
+     * - `vertical`: panes stacked (divider is horizontal bar)
+     * @default "horizontal"
+     */
+    direction?: SplitDirection;
+    /**
+     * Panel size configuration array.
+     * Must match the number of SplitPanePanel children.
+     * If not provided, panels split equally.
+     */
+    panels?: PanelConfig[];
+    /**
+     * Controlled panel sizes in pixels.
+     * Array of current sizes for each panel.
+     */
+    sizes?: number[];
+    /**
+     * Divider width/height in pixels
+     * @default 4
+     */
+    dividerSize?: number;
+    /**
+     * SplitPanePanel children (minimum 2)
+     */
+    children: React.ReactNode;
+    /**
+     * Callback when panel sizes change during drag
+     * @param sizes - Array of panel sizes in pixels
+     */
+    onResize?: (sizes: number[]) => void;
+    /**
+     * Callback when resize ends (drag released)
+     * Use for persisting layout to storage.
+     */
+    onResizeEnd?: (sizes: number[]) => void;
+    /**
+     * Callback when a panel collapses or expands
+     */
+    onCollapseChange?: (panelIndex: number, collapsed: boolean) => void;
+}
+type SplitPaneProps = Prettify<SplitPaneBaseProps>;
+interface SplitPanePanelBaseProps extends BaseComponent {
+    /** Panel content */
+    children?: React.ReactNode;
+}
+type SplitPanePanelProps = Prettify<SplitPanePanelBaseProps>;
+
+export type { PanelConfig, PanelSize, SplitDirection, SplitPanePanelProps, SplitPaneProps };

package/dist/types/components/layout/SplitPane/SplitPanePanel.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { SplitPanePanelProps } from './SplitPane.types.js';
+
+/**
+ * A panel within a SplitPane layout.
+ *
+ * Simple wrapper that renders its children with `overflow: auto`.
+ * The parent SplitPane manages its sizing.
+ *
+ * @example
+ * ```tsx
+ * <SplitPane>
+ *   <SplitPanePanel>Left content</SplitPanePanel>
+ *   <SplitPanePanel>Right content</SplitPanePanel>
+ * </SplitPane>
+ * ```
+ */
+declare const SplitPanePanel: React.FC<SplitPanePanelProps>;
+
+export { SplitPanePanel };