entangle-ui 0.6.3 → 0.8.0

package/dist/types/components/navigation/Breadcrumbs/Breadcrumbs.d.ts

@@ -0,0 +1,311 @@
+import { BreadcrumbsSize } from './Breadcrumbs.types.js';
+import React from 'react';
+
+/**
+ * Breadcrumb navigation for hierarchical paths.
+ *
+ * Use Breadcrumbs for file paths, nested categories, editor hierarchy depth,
+ * or parent-route navigation. Mark the current page explicitly with
+ * `isCurrent`.
+ *
+ * @example
+ * ```tsx
+ * <Breadcrumbs>
+ *   <BreadcrumbItem href="/">Home</BreadcrumbItem>
+ *   <BreadcrumbItem href="/components">Components</BreadcrumbItem>
+ *   <BreadcrumbItem isCurrent>Button</BreadcrumbItem>
+ * </Breadcrumbs>
+ * ```
+ */
+declare const Breadcrumbs: React.NamedExoticComponent<{
+    separator?: React.ReactNode;
+    maxItems?: number | undefined;
+    itemsBeforeCollapse?: number | undefined;
+    itemsAfterCollapse?: number | undefined;
+    expandable?: boolean | undefined;
+    size?: BreadcrumbsSize | undefined;
+    children: React.ReactNode;
+    id?: string | undefined | undefined;
+    className?: string | undefined | undefined;
+    testId?: string | undefined;
+    style?: React.CSSProperties | undefined;
+    ref?: React.Ref<HTMLElement> | 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" | "hint" | 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<HTMLElement> | undefined;
+    onCopyCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCut?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCutCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onPaste?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onPasteCapture?: React.ClipboardEventHandler<HTMLElement> | undefined;
+    onCompositionEnd?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionEndCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStart?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStartCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdate?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdateCapture?: React.CompositionEventHandler<HTMLElement> | undefined;
+    onFocus?: React.FocusEventHandler<HTMLElement> | undefined;
+    onFocusCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+    onBlur?: React.FocusEventHandler<HTMLElement> | undefined;
+    onBlurCapture?: React.FocusEventHandler<HTMLElement> | undefined;
+    onChange?: React.ChangeEventHandler<HTMLElement, Element> | undefined;
+    onChangeCapture?: React.ChangeEventHandler<HTMLElement, Element> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLElement> | undefined;
+    onBeforeInputCapture?: React.InputEventHandler<HTMLElement> | undefined;
+    onInput?: React.InputEventHandler<HTMLElement> | undefined;
+    onInputCapture?: React.InputEventHandler<HTMLElement> | undefined;
+    onReset?: React.ReactEventHandler<HTMLElement> | undefined;
+    onResetCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSubmit?: React.SubmitEventHandler<HTMLElement> | undefined;
+    onSubmitCapture?: React.SubmitEventHandler<HTMLElement> | undefined;
+    onInvalid?: React.ReactEventHandler<HTMLElement> | undefined;
+    onInvalidCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoad?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onError?: React.ReactEventHandler<HTMLElement> | undefined;
+    onErrorCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onKeyDown?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyDownCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPress?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPressCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUp?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUpCapture?: React.KeyboardEventHandler<HTMLElement> | undefined;
+    onAbort?: React.ReactEventHandler<HTMLElement> | undefined;
+    onAbortCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThrough?: React.ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThroughCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onDurationChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onDurationChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEmptied?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEmptiedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEncrypted?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEncryptedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEnded?: React.ReactEventHandler<HTMLElement> | undefined;
+    onEndedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedData?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedDataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadata?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadataCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadStart?: React.ReactEventHandler<HTMLElement> | undefined;
+    onLoadStartCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPause?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPauseCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlay?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlayCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlaying?: React.ReactEventHandler<HTMLElement> | undefined;
+    onPlayingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onProgress?: React.ReactEventHandler<HTMLElement> | undefined;
+    onProgressCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onRateChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onRateChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeeked?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeekedCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeeking?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSeekingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onStalled?: React.ReactEventHandler<HTMLElement> | undefined;
+    onStalledCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSuspend?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSuspendCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdate?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdateCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChange?: React.ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChangeCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onWaiting?: React.ReactEventHandler<HTMLElement> | undefined;
+    onWaitingCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onAuxClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onAuxClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onContextMenu?: React.MouseEventHandler<HTMLElement> | undefined;
+    onContextMenuCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClick?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClickCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onDrag?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnd?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEndCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnter?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragEnterCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragExit?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragExitCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragLeave?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragLeaveCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragOver?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragOverCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragStart?: React.DragEventHandler<HTMLElement> | undefined;
+    onDragStartCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onDrop?: React.DragEventHandler<HTMLElement> | undefined;
+    onDropCapture?: React.DragEventHandler<HTMLElement> | undefined;
+    onMouseDown?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseDownCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseEnter?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseLeave?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseMove?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseMoveCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOut?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOutCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOver?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseOverCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseUp?: React.MouseEventHandler<HTMLElement> | undefined;
+    onMouseUpCapture?: React.MouseEventHandler<HTMLElement> | undefined;
+    onSelect?: React.ReactEventHandler<HTMLElement> | undefined;
+    onSelectCapture?: React.ReactEventHandler<HTMLElement> | undefined;
+    onTouchCancel?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchCancelCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchEnd?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchEndCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchMove?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchMoveCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchStart?: React.TouchEventHandler<HTMLElement> | undefined;
+    onTouchStartCapture?: React.TouchEventHandler<HTMLElement> | undefined;
+    onPointerDown?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerDownCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerMove?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerMoveCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerUp?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerUpCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancel?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancelCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerEnter?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerLeave?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOver?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOverCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOut?: React.PointerEventHandler<HTMLElement> | undefined;
+    onPointerOutCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCaptureCapture?: React.PointerEventHandler<HTMLElement> | undefined;
+    onScroll?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollCapture?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollEnd?: React.UIEventHandler<HTMLElement> | undefined;
+    onScrollEndCapture?: React.UIEventHandler<HTMLElement> | undefined;
+    onWheel?: React.WheelEventHandler<HTMLElement> | undefined;
+    onWheelCapture?: React.WheelEventHandler<HTMLElement> | undefined;
+    onAnimationStart?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationStartCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEnd?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEndCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIteration?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIterationCapture?: React.AnimationEventHandler<HTMLElement> | undefined;
+    onToggle?: React.ToggleEventHandler<HTMLElement> | undefined;
+    onBeforeToggle?: React.ToggleEventHandler<HTMLElement> | undefined;
+    onTransitionCancel?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionCancelCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEnd?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEndCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRun?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRunCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStart?: React.TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStartCapture?: React.TransitionEventHandler<HTMLElement> | undefined;
+}>;
+
+export { Breadcrumbs };

package/dist/types/components/navigation/Breadcrumbs/Breadcrumbs.types.d.ts

@@ -0,0 +1,89 @@
+import React from 'react';
+import { BaseComponent, Size } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+
+type BreadcrumbsSize = Size;
+interface BreadcrumbsBaseProps extends BaseComponent<HTMLElement> {
+    /**
+     * Custom separator. Can be a string or any ReactNode.
+     * @default <ArrowRightIcon size="sm" decorative />
+     */
+    separator?: React.ReactNode;
+    /**
+     * Maximum number of items to show before collapsing the middle into an ellipsis.
+     * `0` or `undefined` never collapses.
+     * @default 0
+     */
+    maxItems?: number;
+    /**
+     * Number of items to keep visible at the start when collapsing.
+     * @default 1
+     */
+    itemsBeforeCollapse?: number;
+    /**
+     * Number of items to keep visible at the end when collapsing.
+     * @default 2
+     */
+    itemsAfterCollapse?: number;
+    /**
+     * Render the ellipsis as a clickable button that expands to show all items.
+     * @default true
+     */
+    expandable?: boolean;
+    /**
+     * Size applied to all items.
+     * @default "sm"
+     */
+    size?: BreadcrumbsSize;
+    /**
+     * Children, typically BreadcrumbItem components with optional custom
+     * BreadcrumbSeparator components between them.
+     */
+    children: React.ReactNode;
+}
+type BreadcrumbsProps = Prettify<BreadcrumbsBaseProps>;
+interface BreadcrumbItemBaseProps extends BaseComponent<HTMLElement> {
+    /**
+     * Render as a link with this href.
+     */
+    href?: string;
+    /**
+     * Click handler, useful for SPA routing.
+     */
+    onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+    /**
+     * Marks this item as the current page.
+     * @default false
+     */
+    isCurrent?: boolean;
+    /**
+     * Optional icon rendered before the label.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Truncate a string label when it exceeds this many characters.
+     */
+    maxLength?: number;
+    /**
+     * Breadcrumb label.
+     */
+    children: React.ReactNode;
+}
+type BreadcrumbItemProps = Prettify<BreadcrumbItemBaseProps>;
+interface BreadcrumbSeparatorBaseProps extends BaseComponent<HTMLElement> {
+    children?: React.ReactNode;
+}
+type BreadcrumbSeparatorProps = Prettify<BreadcrumbSeparatorBaseProps>;
+interface BreadcrumbEllipsisBaseProps extends BaseComponent<HTMLElement> {
+    /**
+     * Click handler used when the collapsed items can be expanded.
+     */
+    onClick?: () => void;
+    /**
+     * Tooltip content describing the collapsed breadcrumb labels.
+     */
+    tooltip?: React.ReactNode;
+}
+type BreadcrumbEllipsisProps = Prettify<BreadcrumbEllipsisBaseProps>;
+
+export type { BreadcrumbEllipsisBaseProps, BreadcrumbEllipsisProps, BreadcrumbItemBaseProps, BreadcrumbItemProps, BreadcrumbSeparatorBaseProps, BreadcrumbSeparatorProps, BreadcrumbsBaseProps, BreadcrumbsProps, BreadcrumbsSize };

package/dist/types/components/navigation/SegmentedControl/SegmentedControl.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import { SegmentedControlProps } from './SegmentedControl.types.js';
+
+/**
+ * SegmentedControl — toolbar-density mutually exclusive selector.
+ *
+ * Use when you have 2-5 mutually exclusive states without separate panels
+ * (viewport mode, list/grid toggle, alignment). For content panels use Tabs;
+ * for form-style selection use RadioGroup.
+ *
+ * Compound API: pair `SegmentedControl` with `SegmentedControlItem`.
+ *
+ * @example
+ * ```tsx
+ * <SegmentedControl defaultValue="day">
+ *   <SegmentedControlItem value="day">Day</SegmentedControlItem>
+ *   <SegmentedControlItem value="week">Week</SegmentedControlItem>
+ *   <SegmentedControlItem value="month">Month</SegmentedControlItem>
+ * </SegmentedControl>
+ * ```
+ */
+declare const SegmentedControl: React.FC<SegmentedControlProps>;
+
+export { SegmentedControl };

package/dist/types/components/navigation/SegmentedControl/SegmentedControl.types.d.ts

@@ -0,0 +1,85 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+
+type SegmentedControlSize = Size;
+type SegmentedControlOrientation = 'horizontal' | 'vertical';
+/**
+ * Visual variants for SegmentedControl.
+ * - `subtle`: container has secondary background, selected segment lifts to surface
+ * - `solid`: filled accent for selected segment, muted for others
+ * - `outline`: bordered container, selected segment marked with accent edge
+ */
+type SegmentedControlVariant = 'subtle' | 'solid' | 'outline';
+interface SegmentedControlBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'onChange'> {
+    /** Currently selected value (controlled) */
+    value?: string;
+    /** Default selected value (uncontrolled) */
+    defaultValue?: string;
+    /**
+     * Size.
+     * - `sm`: 20px height (toolbar density)
+     * - `md`: 24px height (default)
+     * - `lg`: 32px height
+     * @default "md"
+     */
+    size?: SegmentedControlSize;
+    /**
+     * Layout direction.
+     * @default "horizontal"
+     */
+    orientation?: SegmentedControlOrientation;
+    /**
+     * Visual style.
+     * @default "subtle"
+     */
+    variant?: SegmentedControlVariant;
+    /**
+     * Stretch the control to fill the parent container's width (horizontal)
+     * or height (vertical). Each segment grows equally.
+     * @default false
+     */
+    fullWidth?: boolean;
+    /**
+     * Whether the control is disabled in its entirety.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Change handler — fires when a different segment is selected. */
+    onChange?: (value: string) => void;
+    /**
+     * Children — typically `SegmentedControlItem` components.
+     */
+    children: React.ReactNode;
+    /**
+     * Optional aria-label for the control as a whole.
+     * @default "Segmented control"
+     */
+    'aria-label'?: string;
+}
+type SegmentedControlProps = Prettify<SegmentedControlBaseProps>;
+interface SegmentedControlItemBaseProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'value' | 'children'> {
+    /** Unique value for this segment. */
+    value: string;
+    /**
+     * Visible label. Optional when `icon` is provided (for icon-only segments).
+     */
+    children?: React.ReactNode;
+    /** Optional icon, rendered before the label. */
+    icon?: React.ReactNode;
+    /**
+     * Tooltip shown on hover. Especially useful for icon-only segments.
+     */
+    tooltip?: React.ReactNode;
+    /**
+     * Disable just this segment.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Test identifier for automated testing. */
+    testId?: string;
+    ref?: React.Ref<HTMLButtonElement>;
+}
+type SegmentedControlItemProps = Prettify<SegmentedControlItemBaseProps>;
+
+export type { SegmentedControlBaseProps, SegmentedControlItemBaseProps, SegmentedControlItemProps, SegmentedControlOrientation, SegmentedControlProps, SegmentedControlSize, SegmentedControlVariant };

package/dist/types/components/navigation/SegmentedControl/SegmentedControlItem.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { SegmentedControlItemProps } from './SegmentedControl.types.js';
+
+/**
+ * Individual segment inside a `SegmentedControl`.
+ *
+ * Supports text, icon-only, or icon + label segments. Pair icon-only
+ * segments with a `tooltip` so the action remains discoverable.
+ */
+declare const SegmentedControlItem: React.FC<SegmentedControlItemProps>;
+
+export { SegmentedControlItem };

package/dist/types/components/navigation/Tabs/Tabs.types.d.ts

@@ -48,6 +48,16 @@ interface TabsBaseProps extends Omit<BaseComponent, 'onChange'> {
      * @default true
      */
     pillsFrame?: boolean;
+    /**
+     * When true, every `TabPanel` stays mounted even when its tab is not
+     * active. Individual panels can still opt out by passing
+     * `keepMounted={false}` explicitly.
+     *
+     * Use this for tabs that host stateful UIs (terminals, code editors,
+     * media previews) where unmount/remount would destroy session state.
+     * @default false
+     */
+    keepMounted?: boolean;
     /**
      * Children: TabList + TabPanel components
      */