@skdx/react 0.27.0 → 0.29.0

package/dist/speed-dial/types.d.cts

@@ -1,168 +1,202 @@
 import type * as React from 'react';
+import type { PassThroughProps } from '../utils/passThrough.cjs';
 import type { PopperContentProps } from '../utils/popper.cjs';
 import type { PortalProps } from '../utils/portal.cjs';
 import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
 import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.cjs';
-/**
- * Which way the actions fan out from the trigger. Physical, not logical: a
- * speed dial is anchored to a corner of the viewport, and the corner does not
- * move under `dir="rtl"` — only the arrow keys that walk the fan do, which
- * `SpeedDialContent` resolves for itself.
- */
+/** Which way actions fan out from trigger (physical, not logical direction). */
 export type SpeedDialDirection = 'up' | 'down' | 'left' | 'right';
-/** @internal Shared state distributed from {@link SpeedDial} to its parts via context. Not part of the public API. */
+/** @internal Route that opened the fan; hover skips focus-move on pointer-enter. */
+export type SpeedDialOpenReason = 'pointer' | 'hover' | 'keyboard' | 'programmatic';
+/** @internal Shared state distributed from {@link SpeedDial} to its parts via context. */
 export interface SpeedDialContextValue {
     triggerRef: React.RefObject<HTMLButtonElement | null>;
     contentRef: React.RefObject<HTMLDivElement | null>;
     contentId: string;
+    /** Trigger id pointed to by Content `aria-labelledby` for inherited naming. */
+    triggerId: string;
     open: boolean;
-    /** Whether the content should be in the DOM — stays true through an exit animation after `open` goes false. */
-    mounted: boolean;
+    /** Whether content is in DOM (stays true through exit animation). */
     direction: SpeedDialDirection;
     disabled: boolean;
     openOnHover: boolean;
-    /** Guarded setter: a disabled speed dial never opens, whichever path asked. */
-    onOpenChange: (open: boolean) => void;
-    /** Pointer entered the trigger or the content — cancels any pending hover close. */
+    /** How fan was last asked to open; ref so effect can read it without re-rendering. */
+    openReason: React.RefObject<SpeedDialOpenReason>;
+    /** Guarded setter; disabled dial never opens. */
+    onOpenChange: (open: boolean, reason?: SpeedDialOpenReason) => void;
     onPointerEnter: () => void;
-    /** Pointer left the trigger or the content — schedules the hover close. */
+    /** Opens fan after `hoverOpenDelay` when `openOnHover` is set. */
+    onHoverOpen: () => void;
     onPointerLeave: () => void;
 }
-/** @internal Wires a {@link SpeedDialItemLabel} to the `aria-labelledby` of its {@link SpeedDialItem}. Not part of the public API. */
+/** @internal Wires a {@link SpeedDialItemLabel} to the `aria-labelledby` of its {@link SpeedDialItem}. */
 export interface SpeedDialItemContextValue {
     labelId: string | undefined;
     setLabelId: (id: string | undefined) => void;
 }
-/** Props for the {@link SpeedDial} root. */
-export interface SpeedDialProps {
+/** Entry in {@link SpeedDial}'s fan, rendered as `SpeedDialItem`. */
+export interface SpeedDialAction {
+    /** Visible text rendered as `SpeedDialItemLabel` and accessible name. */
+    label: string;
     /**
-     * The trigger and portal — the fan's own DOM (content, items) is rendered
-     * by {@link SpeedDialPortal} elsewhere.
-     * @default undefined — renders nothing if omitted.
+     * Icon rendered before label.
+     * @default undefined — text-only.
      */
-    children?: React.ReactNode;
+    icon?: React.ReactNode | undefined;
     /**
-     * Whether the actions are revealed, for controlled usage. Pair with `onOpenChange`.
-     * @default undefined — uncontrolled, tracks its own open state internally.
+     * Called on click / Enter / Space before dial's `onSelect`.
+     * @default undefined — no-op.
      */
-    open?: boolean;
+    onSelect?: (() => void) | undefined;
     /**
-     * Whether the actions are revealed initially, for uncontrolled usage.
-     * @default false — the dial starts collapsed to just its trigger.
+     * Excludes action from navigation and selection (keeps slot so others don't shuffle).
+     * @default false
+     */
+    disabled?: boolean | undefined;
+}
+/** Props for {@link SpeedDial}. Pass-through attributes land on derived `SpeedDialContent`. */
+export interface SpeedDialProps extends PassThroughProps {
+    /**
+     * Floating action button (merged onto element via `asChild`, needs accessible name).
+     * @default undefined — no trigger.
      */
-    defaultOpen?: boolean;
+    trigger?: React.ReactElement | undefined;
     /**
-     * Fires with the new open state whenever the dial opens or closes, controlled or not.
-     * @default undefined — no-op if omitted.
+     * Fan entries; one item per entry with label built from `label`.
+     * @default undefined — empty fan.
      */
-    onOpenChange?: (open: boolean) => void;
+    actions?: ReadonlyArray<SpeedDialAction> | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `SpeedDialContent`'s enter or exit animation ends, or as soon as it
-     * has settled when the content declares no animation. Use it for work that
-     * must not race the transition; use `onOpenChange` for work that must not
-     * wait for it.
-     * @default undefined — no-op if omitted.
+     * Fires with activated action and index (entry's `onSelect` fires first).
+     * @default undefined — no-op.
+     */
+    onSelect?: ((action: SpeedDialAction, index: number) => void) | undefined;
+    /**
+     * Scrim behind fan; doesn't make dial modal (focus not trapped, scrim clicks normal).
+     * @default false
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    overlay?: boolean | undefined;
     /**
-     * Which way the actions fan out from the trigger. Decides the side the
-     * content is positioned on, the axis the arrow keys walk, and the
-     * `data-direction` attribute the stagger CSS reads.
-     * @default 'up' — the usual bottom-right floating action button, whose actions can only go upward.
+     * Whether actions are revealed for controlled usage; pair with `onOpenChange`.
+     * @default undefined — uncontrolled.
      */
-    direction?: SpeedDialDirection;
+    open?: boolean | undefined;
     /**
-     * Also open on pointer-enter of the trigger, not only on click. The dial
-     * still opens on click and keyboard either way; this only adds the hover
-     * path, which touch pointers never take.
-     * @default false — hover reveals nothing, so a pointer merely crossing the button cannot fire actions by accident.
+     * Initial reveal state for uncontrolled usage.
+     * @default false — starts collapsed.
      */
-    openOnHover?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
-     * Milliseconds the dial stays open after the pointer leaves the trigger or
-     * the content. The gap between the trigger and the first action is dead
-     * space the pointer has to cross, so closing on the first `pointerleave`
-     * would snap the menu shut mid-travel; re-entering either element within
-     * this window cancels the pending close. Only consulted when `openOnHover`
-     * is set.
-     * @default 300 — long enough to cross a normal trigger-to-item gap, short enough not to feel stuck open.
+     * Fires with new open state when dial opens or closes.
+     * @default undefined — no-op.
      */
-    hoverCloseDelay?: number;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Blocks the dial from opening by any route — click, hover, or keyboard —
-     * and marks the trigger natively disabled.
+     * Fires once open-state change finishes on screen (after animation ends).
+     * @default undefined — no-op.
+     */
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * Which way actions fan out; decides positioning axis and `data-direction`.
+     * @default 'up'
+     */
+    direction?: SpeedDialDirection | undefined;
+    /**
+     * Also open on pointer-enter (click and keyboard still work either way).
      * @default false
      */
-    disabled?: boolean;
+    openOnHover?: boolean | undefined;
+    /**
+     * Milliseconds dial stays open after pointer leaves (lets pointer cross gap to item without closing).
+     * @default 300
+     */
+    hoverCloseDelay?: number | undefined;
+    /**
+     * Milliseconds pointer must rest before fan opens with `openOnHover`.
+     * @default 0
+     */
+    hoverOpenDelay?: number | undefined;
+    /**
+     * Blocks opening and disables trigger; also closes if already open.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Size rung the skin scales the dial by, fed to the derived Trigger and Items.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialTrigger}, the floating action button that reveals the actions and anchors their position. */
+/** Props for {@link SpeedDialTrigger}, the floating action button revealing actions. */
 export interface SpeedDialTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Size rung the skin scales the trigger by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialPortal}, which teleports the actions to `document.body`. */
+/** Props for {@link SpeedDialPortal}, teleports actions to `document.body`. */
 export interface SpeedDialPortalProps extends PortalProps {
     /**
-     * Render the portal even while the dial is closed, instead of unmounting
-     * it. Only needed to keep the content in the DOM permanently — an exit
-     * animation is already waited out without this.
+     * Keep portal mounted while dial closed (only needed for permanent DOM presence).
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
-/**
- * Props for {@link SpeedDialContent}, the fanned-out action list. Extends the
- * shared popper positioning props (`align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`, `collisionBoundary`) — but not
- * `side`, which the root's `direction` owns.
- */
+/** Props for {@link SpeedDialOverlay}}, optional scrim; opt-in by rendering. */
+export interface SpeedDialOverlayProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link SpeedDialContent}}, the fanned action list (extends popper positioning, except `side` is owned by `direction`). */
 export interface SpeedDialContentProps extends Omit<PopperContentProps, 'side'> {
     /**
-     * Keep the actions mounted even while the dial is closed. Only needed to
-     * keep them in the DOM permanently — an exit animation is already waited
-     * out without this.
+     * Keep actions mounted while dial closed (only needed for permanent DOM presence).
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
-     * Whether arrow-key navigation wraps from the last action back to the first (and vice versa).
+     * Whether arrow-key navigation wraps from last to first action.
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
     /**
-     * Fires when Escape is pressed while the dial is open. Call `event.preventDefault()` to stop it from closing.
-     * @default undefined — no-op if omitted.
+     * Fires on Escape (call `preventDefault()` to stay open).
+     * @default undefined — no-op.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
-     * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the dial from closing.
-     * @default undefined — no-op if omitted.
+     * Fires on pointer-down outside (call `preventDefault()` to stay open).
+     * @default undefined — no-op.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the dial from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
-     * @default undefined — no-op if omitted.
+     * Fires on focus outside (receives cancelable stand-in with `focusin` as detail).
+     * @default undefined — no-op.
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
-     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
-     * @default undefined — no-op if omitted.
+     * Fires for any outside interaction before specific handler; one `preventDefault()` vetoes either way.
+     * @default undefined — no-op.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
 }
-/** Props for a single {@link SpeedDialItem}, one action in the fan. */
+/** Props for {@link SpeedDialItem}, one action in the fan. */
 export interface SpeedDialItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'onSelect'> {
     /**
-     * Excludes the action from arrow-key navigation and blocks selection. It
-     * keeps its slot in the fan, so the actions around it do not shuffle.
+     * Excludes action from navigation and selection (keeps slot so others don't shuffle).
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
+    /**
+     * Called on click / Enter / Space (call `preventDefault()` to keep dial open).
+     * @default undefined — no-op.
+     */
+    onSelect?: ((event: Event) => void) | undefined;
     /**
-     * Called when the action is activated by click, Enter, or Space. `event.preventDefault()` keeps the dial open.
-     * @default undefined — no-op if omitted.
+     * Size rung the skin scales this action by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
      */
-    onSelect?: (event: Event) => void;
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialItemLabel}, the visible text naming its {@link SpeedDialItem}. */
+/** Props for {@link SpeedDialItemLabel}, visible text naming the item. */
 export interface SpeedDialItemLabelProps extends PrimitivePropsWithRef<'span'> {
 }

package/dist/speed-dial/types.d.ts

@@ -1,168 +1,202 @@
 import type * as React from 'react';
+import type { PassThroughProps } from '../utils/passThrough.js';
 import type { PopperContentProps } from '../utils/popper.js';
 import type { PortalProps } from '../utils/portal.js';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
 import type { FocusOutsideEvent, InteractOutsideEvent } from '../utils/useDismiss.js';
-/**
- * Which way the actions fan out from the trigger. Physical, not logical: a
- * speed dial is anchored to a corner of the viewport, and the corner does not
- * move under `dir="rtl"` — only the arrow keys that walk the fan do, which
- * `SpeedDialContent` resolves for itself.
- */
+/** Which way actions fan out from trigger (physical, not logical direction). */
 export type SpeedDialDirection = 'up' | 'down' | 'left' | 'right';
-/** @internal Shared state distributed from {@link SpeedDial} to its parts via context. Not part of the public API. */
+/** @internal Route that opened the fan; hover skips focus-move on pointer-enter. */
+export type SpeedDialOpenReason = 'pointer' | 'hover' | 'keyboard' | 'programmatic';
+/** @internal Shared state distributed from {@link SpeedDial} to its parts via context. */
 export interface SpeedDialContextValue {
     triggerRef: React.RefObject<HTMLButtonElement | null>;
     contentRef: React.RefObject<HTMLDivElement | null>;
     contentId: string;
+    /** Trigger id pointed to by Content `aria-labelledby` for inherited naming. */
+    triggerId: string;
     open: boolean;
-    /** Whether the content should be in the DOM — stays true through an exit animation after `open` goes false. */
-    mounted: boolean;
+    /** Whether content is in DOM (stays true through exit animation). */
     direction: SpeedDialDirection;
     disabled: boolean;
     openOnHover: boolean;
-    /** Guarded setter: a disabled speed dial never opens, whichever path asked. */
-    onOpenChange: (open: boolean) => void;
-    /** Pointer entered the trigger or the content — cancels any pending hover close. */
+    /** How fan was last asked to open; ref so effect can read it without re-rendering. */
+    openReason: React.RefObject<SpeedDialOpenReason>;
+    /** Guarded setter; disabled dial never opens. */
+    onOpenChange: (open: boolean, reason?: SpeedDialOpenReason) => void;
     onPointerEnter: () => void;
-    /** Pointer left the trigger or the content — schedules the hover close. */
+    /** Opens fan after `hoverOpenDelay` when `openOnHover` is set. */
+    onHoverOpen: () => void;
     onPointerLeave: () => void;
 }
-/** @internal Wires a {@link SpeedDialItemLabel} to the `aria-labelledby` of its {@link SpeedDialItem}. Not part of the public API. */
+/** @internal Wires a {@link SpeedDialItemLabel} to the `aria-labelledby` of its {@link SpeedDialItem}. */
 export interface SpeedDialItemContextValue {
     labelId: string | undefined;
     setLabelId: (id: string | undefined) => void;
 }
-/** Props for the {@link SpeedDial} root. */
-export interface SpeedDialProps {
+/** Entry in {@link SpeedDial}'s fan, rendered as `SpeedDialItem`. */
+export interface SpeedDialAction {
+    /** Visible text rendered as `SpeedDialItemLabel` and accessible name. */
+    label: string;
     /**
-     * The trigger and portal — the fan's own DOM (content, items) is rendered
-     * by {@link SpeedDialPortal} elsewhere.
-     * @default undefined — renders nothing if omitted.
+     * Icon rendered before label.
+     * @default undefined — text-only.
      */
-    children?: React.ReactNode;
+    icon?: React.ReactNode | undefined;
     /**
-     * Whether the actions are revealed, for controlled usage. Pair with `onOpenChange`.
-     * @default undefined — uncontrolled, tracks its own open state internally.
+     * Called on click / Enter / Space before dial's `onSelect`.
+     * @default undefined — no-op.
      */
-    open?: boolean;
+    onSelect?: (() => void) | undefined;
     /**
-     * Whether the actions are revealed initially, for uncontrolled usage.
-     * @default false — the dial starts collapsed to just its trigger.
+     * Excludes action from navigation and selection (keeps slot so others don't shuffle).
+     * @default false
+     */
+    disabled?: boolean | undefined;
+}
+/** Props for {@link SpeedDial}. Pass-through attributes land on derived `SpeedDialContent`. */
+export interface SpeedDialProps extends PassThroughProps {
+    /**
+     * Floating action button (merged onto element via `asChild`, needs accessible name).
+     * @default undefined — no trigger.
      */
-    defaultOpen?: boolean;
+    trigger?: React.ReactElement | undefined;
     /**
-     * Fires with the new open state whenever the dial opens or closes, controlled or not.
-     * @default undefined — no-op if omitted.
+     * Fan entries; one item per entry with label built from `label`.
+     * @default undefined — empty fan.
      */
-    onOpenChange?: (open: boolean) => void;
+    actions?: ReadonlyArray<SpeedDialAction> | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `SpeedDialContent`'s enter or exit animation ends, or as soon as it
-     * has settled when the content declares no animation. Use it for work that
-     * must not race the transition; use `onOpenChange` for work that must not
-     * wait for it.
-     * @default undefined — no-op if omitted.
+     * Fires with activated action and index (entry's `onSelect` fires first).
+     * @default undefined — no-op.
+     */
+    onSelect?: ((action: SpeedDialAction, index: number) => void) | undefined;
+    /**
+     * Scrim behind fan; doesn't make dial modal (focus not trapped, scrim clicks normal).
+     * @default false
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    overlay?: boolean | undefined;
     /**
-     * Which way the actions fan out from the trigger. Decides the side the
-     * content is positioned on, the axis the arrow keys walk, and the
-     * `data-direction` attribute the stagger CSS reads.
-     * @default 'up' — the usual bottom-right floating action button, whose actions can only go upward.
+     * Whether actions are revealed for controlled usage; pair with `onOpenChange`.
+     * @default undefined — uncontrolled.
      */
-    direction?: SpeedDialDirection;
+    open?: boolean | undefined;
     /**
-     * Also open on pointer-enter of the trigger, not only on click. The dial
-     * still opens on click and keyboard either way; this only adds the hover
-     * path, which touch pointers never take.
-     * @default false — hover reveals nothing, so a pointer merely crossing the button cannot fire actions by accident.
+     * Initial reveal state for uncontrolled usage.
+     * @default false — starts collapsed.
      */
-    openOnHover?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
-     * Milliseconds the dial stays open after the pointer leaves the trigger or
-     * the content. The gap between the trigger and the first action is dead
-     * space the pointer has to cross, so closing on the first `pointerleave`
-     * would snap the menu shut mid-travel; re-entering either element within
-     * this window cancels the pending close. Only consulted when `openOnHover`
-     * is set.
-     * @default 300 — long enough to cross a normal trigger-to-item gap, short enough not to feel stuck open.
+     * Fires with new open state when dial opens or closes.
+     * @default undefined — no-op.
      */
-    hoverCloseDelay?: number;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Blocks the dial from opening by any route — click, hover, or keyboard —
-     * and marks the trigger natively disabled.
+     * Fires once open-state change finishes on screen (after animation ends).
+     * @default undefined — no-op.
+     */
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
+    /**
+     * Which way actions fan out; decides positioning axis and `data-direction`.
+     * @default 'up'
+     */
+    direction?: SpeedDialDirection | undefined;
+    /**
+     * Also open on pointer-enter (click and keyboard still work either way).
      * @default false
      */
-    disabled?: boolean;
+    openOnHover?: boolean | undefined;
+    /**
+     * Milliseconds dial stays open after pointer leaves (lets pointer cross gap to item without closing).
+     * @default 300
+     */
+    hoverCloseDelay?: number | undefined;
+    /**
+     * Milliseconds pointer must rest before fan opens with `openOnHover`.
+     * @default 0
+     */
+    hoverOpenDelay?: number | undefined;
+    /**
+     * Blocks opening and disables trigger; also closes if already open.
+     * @default false
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Size rung the skin scales the dial by, fed to the derived Trigger and Items.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialTrigger}, the floating action button that reveals the actions and anchors their position. */
+/** Props for {@link SpeedDialTrigger}, the floating action button revealing actions. */
 export interface SpeedDialTriggerProps extends PrimitivePropsWithRef<'button'> {
+    /**
+     * Size rung the skin scales the trigger by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialPortal}, which teleports the actions to `document.body`. */
+/** Props for {@link SpeedDialPortal}, teleports actions to `document.body`. */
 export interface SpeedDialPortalProps extends PortalProps {
     /**
-     * Render the portal even while the dial is closed, instead of unmounting
-     * it. Only needed to keep the content in the DOM permanently — an exit
-     * animation is already waited out without this.
+     * Keep portal mounted while dial closed (only needed for permanent DOM presence).
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
-/**
- * Props for {@link SpeedDialContent}, the fanned-out action list. Extends the
- * shared popper positioning props (`align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`, `collisionBoundary`) — but not
- * `side`, which the root's `direction` owns.
- */
+/** Props for {@link SpeedDialOverlay}}, optional scrim; opt-in by rendering. */
+export interface SpeedDialOverlayProps extends PrimitivePropsWithRef<'div'> {
+}
+/** Props for {@link SpeedDialContent}}, the fanned action list (extends popper positioning, except `side` is owned by `direction`). */
 export interface SpeedDialContentProps extends Omit<PopperContentProps, 'side'> {
     /**
-     * Keep the actions mounted even while the dial is closed. Only needed to
-     * keep them in the DOM permanently — an exit animation is already waited
-     * out without this.
+     * Keep actions mounted while dial closed (only needed for permanent DOM presence).
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
-     * Whether arrow-key navigation wraps from the last action back to the first (and vice versa).
+     * Whether arrow-key navigation wraps from last to first action.
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
     /**
-     * Fires when Escape is pressed while the dial is open. Call `event.preventDefault()` to stop it from closing.
-     * @default undefined — no-op if omitted.
+     * Fires on Escape (call `preventDefault()` to stay open).
+     * @default undefined — no-op.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
-     * Fires on pointer-down outside the content. Call `event.preventDefault()` to stop the dial from closing.
-     * @default undefined — no-op if omitted.
+     * Fires on pointer-down outside (call `preventDefault()` to stay open).
+     * @default undefined — no-op.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves to an element outside the content. Call `event.preventDefault()` to stop the dial from closing. Receives a cancelable stand-in carrying the original `focusin` as its `detail`, since `focusin` itself cannot be canceled.
-     * @default undefined — no-op if omitted.
+     * Fires on focus outside (receives cancelable stand-in with `focusin` as detail).
+     * @default undefined — no-op.
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
-     * Fires for either kind of outside interaction — pointer-down or focus — immediately before the specific handler above and with the same event, so one `event.preventDefault()` here vetoes the dismissal whichever way it was triggered.
-     * @default undefined — no-op if omitted.
+     * Fires for any outside interaction before specific handler; one `preventDefault()` vetoes either way.
+     * @default undefined — no-op.
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
 }
-/** Props for a single {@link SpeedDialItem}, one action in the fan. */
+/** Props for {@link SpeedDialItem}, one action in the fan. */
 export interface SpeedDialItemProps extends Omit<PrimitivePropsWithRef<'div'>, 'onSelect'> {
     /**
-     * Excludes the action from arrow-key navigation and blocks selection. It
-     * keeps its slot in the fan, so the actions around it do not shuffle.
+     * Excludes action from navigation and selection (keeps slot so others don't shuffle).
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
+    /**
+     * Called on click / Enter / Space (call `preventDefault()` to keep dial open).
+     * @default undefined — no-op.
+     */
+    onSelect?: ((event: Event) => void) | undefined;
     /**
-     * Called when the action is activated by click, Enter, or Space. `event.preventDefault()` keeps the dial open.
-     * @default undefined — no-op if omitted.
+     * Size rung the skin scales this action by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
      */
-    onSelect?: (event: Event) => void;
+    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
 }
-/** Props for {@link SpeedDialItemLabel}, the visible text naming its {@link SpeedDialItem}. */
+/** Props for {@link SpeedDialItemLabel}, visible text naming the item. */
 export interface SpeedDialItemLabelProps extends PrimitivePropsWithRef<'span'> {
 }

package/dist/spinner/Spinner.cjs

@@ -1 +1,2 @@
-"use strict";var d=Object.create;var t=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var y=Object.getPrototypeOf,S=Object.prototype.hasOwnProperty;var c=(r,e)=>{for(var i in e)t(r,i,{get:e[i],enumerable:!0})},a=(r,e,i,p)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of P(e))!S.call(r,o)&&o!==i&&t(r,o,{get:()=>e[o],enumerable:!(p=v(e,o))||p.enumerable});return r};var x=(r,e,i)=>(i=r!=null?d(y(r)):{},a(e||!r||!r.__esModule?t(i,"default",{value:r,enumerable:!0}):i,r)),R=r=>a(t({},"__esModule",{value:!0}),r);var L={};c(L,{Spinner:()=>f});module.exports=R(L);var m=x(require("react"),1),n=require("../utils/part.cjs"),s=require("../utils/primitive.cjs"),l=require("react/jsx-runtime"),f=m.forwardRef(({label:r="Loading",children:e,...i},p)=>(0,l.jsx)(s.Primitive.div,{role:"status","aria-live":"polite","aria-label":r,...i,...(0,n.skdxPart)("spinner","root",i.className),ref:p,children:e}));f.displayName="Spinner";0&&(module.exports={Spinner});
+'use client';
+"use strict";var o=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var P=(i,e)=>{for(var t in e)o(i,t,{get:e[t],enumerable:!0})},v=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of u(e))!c.call(i,r)&&r!==t&&o(i,r,{get:()=>e[r],enumerable:!(n=y(e,r))||n.enumerable});return i};var S=i=>v(o({},"__esModule",{value:!0}),i);var b={};P(b,{Spinner:()=>s});module.exports=S(b);var p=require("../utils/appearance.cjs"),l=require("../utils/part.cjs"),m=require("../utils/primitive.cjs"),d=require("../utils/visuallyHidden.cjs"),a=require("react/jsx-runtime"),s=({label:i="Loading",children:e,ref:t,size:n,...r})=>{let f=r["aria-label"]??(r["aria-labelledby"]!=null?void 0:i||void 0);return(0,a.jsx)(m.Primitive.div,{...r,...(0,p.appearanceAttrs)({size:n},r),...(0,l.skdxPart)("spinner","root",r.className),ref:t,role:"status","aria-live":"polite","aria-label":f,children:r.asChild?e:(0,a.jsxs)(a.Fragment,{children:[i?(0,a.jsx)(d.VisuallyHidden,{...(0,l.skdxPart)("spinner","label"),children:i}):null,e]})})};s.displayName="Spinner";0&&(module.exports={Spinner});