entangle-ui 0.6.3 → 0.8.0

package/dist/types/components/editor/TransformControl/TransformControl.types.d.ts

@@ -0,0 +1,153 @@
+import { LiteralUnion, Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+
+/**
+ * 3D vector with x/y/z components, used for position, rotation (Euler
+ * degrees) and scale.
+ */
+interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Coordinate space identifiers for the position/rotation rows. The default
+ * options are `'local' | 'world' | 'parent'`, but the prop accepts any
+ * string so consumers can supply their own (e.g. `'camera'`, `'screen'`).
+ */
+type CoordinateSpace = LiteralUnion<'local' | 'world' | 'parent'>;
+/**
+ * Aggregate transform value covering the three subgroups rendered by
+ * `TransformControl`. Rotation is expressed in Euler degrees.
+ */
+interface TransformValue {
+    position: Vec3;
+    rotation: Vec3;
+    scale: Vec3;
+}
+/**
+ * Configuration for the per-subgroup `show` flag. Omitted keys default to
+ * `true`. When both `position` and `rotation` are hidden the
+ * coordinate-space row is hidden too.
+ */
+interface TransformShowConfig {
+    position?: boolean;
+    rotation?: boolean;
+    scale?: boolean;
+}
+/**
+ * Display labels used for each row and for the coordinate-space dropdown.
+ */
+interface TransformLabelsConfig {
+    position?: string;
+    rotation?: string;
+    scale?: string;
+    /** Label for the coordinate-space `Select`. @default `'Space'` */
+    coordinateSpace?: string;
+}
+/**
+ * Per-subgroup precision (decimal places) forwarded to each row's
+ * `VectorInput.precision`.
+ */
+interface TransformPrecisionConfig {
+    position?: number;
+    rotation?: number;
+    scale?: number;
+}
+/**
+ * Per-subgroup step values forwarded to each row's `VectorInput.step`.
+ */
+interface TransformStepConfig {
+    position?: number;
+    rotation?: number;
+    scale?: number;
+}
+/**
+ * Per-subgroup unit suffix forwarded to each row's `VectorInput.unit`.
+ */
+interface TransformUnitsConfig {
+    position?: string;
+    rotation?: string;
+    scale?: string;
+}
+/**
+ * Coordinate-space option as accepted by the `coordinateSpaceOptions`
+ * prop — the same shape used by `Select`.
+ */
+interface CoordinateSpaceOption {
+    value: string;
+    label: string;
+}
+interface TransformControlBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Current transform value (controlled). */
+    value?: TransformValue;
+    /** Default transform value (uncontrolled). */
+    defaultValue?: TransformValue;
+    /**
+     * Called when any axis of any subgroup changes. The full
+     * `TransformValue` is reported every time — even though only one of
+     * the three subgroups was edited.
+     */
+    onChange?: (next: TransformValue) => void;
+    /** Coordinate space for position / rotation (controlled). */
+    coordinateSpace?: CoordinateSpace;
+    /** Default coordinate space (uncontrolled). @default `'local'` */
+    defaultCoordinateSpace?: CoordinateSpace;
+    /** Called when the coordinate-space dropdown changes. */
+    onCoordinateSpaceChange?: (next: CoordinateSpace) => void;
+    /**
+     * Available coordinate-space options. When omitted, defaults to the
+     * three built-in choices: `local`, `world`, `parent`.
+     */
+    coordinateSpaceOptions?: CoordinateSpaceOption[];
+    /**
+     * Whether the scale axes are linked (uniform scale) — controlled.
+     * When linked, editing any axis sets all three to the same value.
+     */
+    linkedScale?: boolean;
+    /** Default linked-scale state (uncontrolled). @default `true` */
+    defaultLinkedScale?: boolean;
+    /** Called when the link-scale toggle is clicked. */
+    onLinkedScaleChange?: (linked: boolean) => void;
+    /**
+     * Which subgroups to show. By default all three are visible. Hiding
+     * both `position` and `rotation` also hides the coordinate-space row.
+     */
+    show?: TransformShowConfig;
+    /**
+     * Display labels for each subgroup and for the coordinate-space
+     * select. Defaults: `'Position'`, `'Rotation'`, `'Scale'`, `'Space'`.
+     */
+    labels?: TransformLabelsConfig;
+    /**
+     * Number formatting per row, forwarded to each `VectorInput.precision`.
+     * Defaults: `{ position: 3, rotation: 1, scale: 3 }`.
+     */
+    precision?: TransformPrecisionConfig;
+    /**
+     * Step values per row, forwarded to each `VectorInput.step`.
+     * Defaults: `{ position: 0.1, rotation: 1, scale: 0.01 }`.
+     */
+    step?: TransformStepConfig;
+    /**
+     * Units appended to each axis input.
+     * Defaults: `{ position: 'm', rotation: '°', scale: '' }`.
+     */
+    units?: TransformUnitsConfig;
+    /**
+     * Size for the underlying `VectorInput` and `Select` controls.
+     * @default `'sm'`
+     */
+    size?: Size;
+    /** Disable all interactions. */
+    disabled?: boolean;
+    /**
+     * When `true`, render a reset button next to each row that resets that
+     * row's value (position/rotation → `(0,0,0)`, scale → `(1,1,1)`).
+     * @default `false`
+     */
+    showReset?: boolean;
+}
+type TransformControlProps = Prettify<TransformControlBaseProps>;
+
+export type { CoordinateSpace, CoordinateSpaceOption, TransformControlBaseProps, TransformControlProps, TransformLabelsConfig, TransformPrecisionConfig, TransformShowConfig, TransformStepConfig, TransformUnitsConfig, TransformValue, Vec3 };

package/dist/types/components/feedback/Alert/Alert.d.ts

@@ -0,0 +1,340 @@
+import { AlertVariant, AlertAppearance } from './Alert.types.js';
+import React from 'react';
+import { AlertTitle } from './AlertTitle.js';
+import { AlertDescription } from './AlertDescription.js';
+import { AlertActions } from './AlertActions.js';
+
+/**
+ * Persistent inline alert / callout.
+ *
+ * Use for non-transient status messages tied to the surrounding UI — read-only
+ * notices, expired credentials, unsaved-changes banners, etc. For transient
+ * confirmations like "File saved", reach for `useToast` instead.
+ *
+ * Compound API: pair with `<Alert.Title>`, `<Alert.Description>`, and
+ * `<Alert.Actions>` for richer layouts. The same components are also
+ * available as standalone named exports (`AlertTitle`, `AlertDescription`,
+ * `AlertActions`).
+ *
+ * Accessibility: roles are derived from the variant — `alert` for
+ * `error`/`warning`, `status` for `info`/`success`, `region` for `neutral`.
+ * The component never auto-focuses; inline alerts shouldn't grab focus.
+ *
+ * @example
+ * ```tsx
+ * <Alert variant="warning" title="Read-only mode">
+ *   Switch to edit mode to make changes.
+ * </Alert>
+ *
+ * <Alert variant="error" onClose={() => setOpen(false)}>
+ *   <Alert.Title>Couldn't reach the server</Alert.Title>
+ *   <Alert.Description>The request timed out.</Alert.Description>
+ *   <Alert.Actions align="right">
+ *     <Button onClick={retry}>Retry</Button>
+ *   </Alert.Actions>
+ * </Alert>
+ * ```
+ */
+declare const AlertImpl: React.NamedExoticComponent<{
+    variant?: AlertVariant | undefined;
+    appearance?: AlertAppearance | undefined;
+    icon?: React.ReactNode;
+    onClose?: (() => void) | undefined;
+    title?: React.ReactNode;
+    children?: React.ReactNode;
+    popover?: "" | "auto" | "manual" | "hint" | undefined | undefined;
+    id?: string | undefined | undefined;
+    className?: string | undefined | undefined;
+    testId?: string | undefined;
+    style?: React.CSSProperties | undefined;
+    ref?: React.Ref<HTMLDivElement> | 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;
+    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;
+    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.ChangeEventHandler<HTMLDivElement, Element> | undefined;
+    onChangeCapture?: React.ChangeEventHandler<HTMLDivElement, Element> | undefined;
+    onBeforeInput?: React.InputEventHandler<HTMLDivElement> | undefined;
+    onBeforeInputCapture?: React.InputEventHandler<HTMLDivElement> | undefined;
+    onInput?: React.InputEventHandler<HTMLDivElement> | undefined;
+    onInputCapture?: React.InputEventHandler<HTMLDivElement> | undefined;
+    onReset?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onResetCapture?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onSubmit?: React.SubmitEventHandler<HTMLDivElement> | undefined;
+    onSubmitCapture?: React.SubmitEventHandler<HTMLDivElement> | undefined;
+    onInvalid?: React.ReactEventHandler<HTMLDivElement> | undefined;
+    onInvalidCapture?: React.ReactEventHandler<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;
+}>;
+/**
+ * Public API: `Alert` with attached compound members.
+ *
+ * `React.memo` returns an exotic component that doesn't accept arbitrary
+ * static fields with proper typing — we expose the compound members through
+ * a typed wrapper.
+ */
+type AlertCompound = typeof AlertImpl & {
+    Title: typeof AlertTitle;
+    Description: typeof AlertDescription;
+    Actions: typeof AlertActions;
+};
+declare const Alert: AlertCompound;
+
+export { Alert };

package/dist/types/components/feedback/Alert/Alert.types.d.ts

@@ -0,0 +1,82 @@
+import React from 'react';
+import { BaseComponent } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+
+/**
+ * Semantic intent of an alert.
+ *
+ * - `info`     — neutral information (default)
+ * - `success`  — positive confirmation
+ * - `warning`  — caution / attention required
+ * - `error`    — destructive / blocking issue
+ * - `neutral`  — passive status banner without coloring
+ */
+type AlertVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
+/**
+ * Visual treatment of an alert.
+ *
+ * - `subtle`   — tinted background (default; recommended for inline alerts)
+ * - `solid`    — filled accent background; high attention, use sparingly
+ * - `outline`  — bordered, transparent background; low visual weight
+ */
+type AlertAppearance = 'subtle' | 'solid' | 'outline';
+interface AlertBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'title'> {
+    /**
+     * Semantic intent. Drives color and the default icon.
+     * @default "info"
+     */
+    variant?: AlertVariant;
+    /**
+     * Visual treatment.
+     * @default "subtle"
+     */
+    appearance?: AlertAppearance;
+    /**
+     * Show an icon at the start.
+     *
+     * - `true` (default) renders the variant's default icon
+     * - `false` hides the icon column entirely
+     * - any `ReactNode` overrides the default icon
+     *
+     * Default-icon mapping: info → `InfoIcon`, success → `CheckIcon`,
+     * warning → `WarningIcon`, error → `ErrorIcon`, neutral → none.
+     * @default true
+     */
+    icon?: React.ReactNode | false;
+    /**
+     * When provided, renders a close button in the top-right corner
+     * and calls this handler when it's clicked.
+     */
+    onClose?: () => void;
+    /**
+     * Optional title — convenience prop equivalent to wrapping with `<Alert.Title>`.
+     * If both `title` and `<Alert.Title>` children are used, both render
+     * (don't do this; pick one).
+     */
+    title?: React.ReactNode;
+    /**
+     * Children — typically `Alert.Title` / `Alert.Description` / `Alert.Actions`.
+     * Plain string content is also fine (treated as description).
+     */
+    children?: React.ReactNode;
+}
+type AlertProps = Prettify<AlertBaseProps>;
+interface AlertTitleBaseProps extends BaseComponent<HTMLDivElement> {
+    children: React.ReactNode;
+}
+type AlertTitleProps = Prettify<AlertTitleBaseProps>;
+interface AlertDescriptionBaseProps extends BaseComponent<HTMLDivElement> {
+    children: React.ReactNode;
+}
+type AlertDescriptionProps = Prettify<AlertDescriptionBaseProps>;
+interface AlertActionsBaseProps extends BaseComponent<HTMLDivElement> {
+    /**
+     * Horizontal alignment of action buttons.
+     * @default "left"
+     */
+    align?: 'left' | 'right' | 'space-between';
+    children: React.ReactNode;
+}
+type AlertActionsProps = Prettify<AlertActionsBaseProps>;
+
+export type { AlertActionsBaseProps, AlertActionsProps, AlertAppearance, AlertBaseProps, AlertDescriptionBaseProps, AlertDescriptionProps, AlertProps, AlertTitleBaseProps, AlertTitleProps, AlertVariant };