@skdx/react 0.28.0 → 0.29.0

package/dist/floating-panel/types.d.cts

@@ -13,18 +13,11 @@ export interface FloatingPanelSize {
     width: number;
     height: number;
 }
-/**
- * Panel window state. `default`: uses position/size; `maximized`: fills boundary;
- * `minimized`: collapses to header height. Only `default` is draggable/resizable.
- */
+/** Panel window state: `default` uses position/size, `maximized` fills the boundary, `minimized` collapses to header height; only `default` is draggable/resizable. */
 export type FloatingPanelStage = 'default' | 'minimized' | 'maximized';
 /** Which edge or corner a {@link FloatingPanelResizeTrigger} pulls. */
 export type FloatingPanelResizeDirection = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
-/**
- * Gesture type for release announcements: `'move'` (header drag) or `'resize'` (edge/corner pull).
- * Announced once per gesture settlement (not per frame).
- * @internal
- */
+/** @internal Gesture type for release announcements: `'move'` (header drag) or `'resize'` (edge/corner pull). */
 export type FloatingPanelGesture = 'move' | 'resize';
 /** Shared state distributed from {@link FloatingPanel} to its parts via context. @internal */
 export interface FloatingPanelContextValue {
@@ -66,21 +59,17 @@ export interface FloatingPanelContextValue {
  */
 export interface FloatingPanelProps extends PassThroughProps {
     /**
-     * The panel's body, rendered inside the derived `FloatingPanelContent` below
-     * the derived header. Never inspected — the anatomy is always derived.
+     * The panel's body, rendered inside the derived `FloatingPanelContent` below the derived header.
      * @default undefined — an empty panel body.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
-     * The panel's heading, rendered as the derived title inside the derived
-     * header. Omitting it derives no title at all and withholds Content's
-     * `aria-labelledby` with it, so name a title-less panel with `aria-label`.
+     * The panel's heading, rendered as the derived title inside the derived header.
      * @default undefined — no title renders.
      */
-    title?: string;
+    title?: string | undefined;
     /**
-     * Window controls (stage triggers). The `label` is provided, not derived from stage name
-     * (avoids baking English into headless library).
+     * Window controls (stage triggers); each supplies its own visible `label`.
      * @default []
      */
     stages?: ReadonlyArray<{
@@ -88,146 +77,127 @@ export interface FloatingPanelProps extends PassThroughProps {
         stage: FloatingPanelStage;
         /** The control's visible text, and its accessible name. */
         label: string;
-    }>;
+    }> | undefined;
     /**
-     * Whether the derived header renders a close button. `false` withholds it,
-     * for a panel whose only exit is your own control or a programmatic close.
+     * Whether the derived header renders a close button.
      * @default true
      */
-    dismissible?: boolean;
+    dismissible?: boolean | undefined;
     /**
      * Whether the panel is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the panel is initially open, for uncontrolled usage.
      * @default false — the panel is closed until the trigger is pressed.
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the panel opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires once animation settles (settled counterpart to `onOpenChange`).
-     * Only on open transition; drag/resize have their own settled callbacks.
+     * Fires once the open/close animation settles, the settled counterpart to `onOpenChange`.
      * @default undefined
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
     /**
-     * The panel's top-left corner, for controlled usage. Pair with `onPositionChange`
-     * or the panel will refuse to move.
+     * The panel's top-left corner, for controlled usage; pair with `onPositionChange` or it refuses to move.
      * @default undefined — uncontrolled, tracks its own position internally.
      */
-    position?: FloatingPanelPosition;
+    position?: FloatingPanelPosition | undefined;
     /**
      * Where the panel starts, for uncontrolled usage.
      * @default { x: 0, y: 0 } — the top-left corner of the boundary.
      */
-    defaultPosition?: FloatingPanelPosition;
+    defaultPosition?: FloatingPanelPosition | undefined;
     /**
-     * Fires with the clamped position on every drag frame and every arrow-key
-     * nudge — not once per gesture. Throttle it yourself if the work is expensive.
+     * Fires with the clamped position on every drag frame and arrow-key nudge, not once per gesture.
      * @default undefined — no-op if omitted.
      */
-    onPositionChange?: (position: FloatingPanelPosition) => void;
+    onPositionChange?: ((position: FloatingPanelPosition) => void) | undefined;
     /**
-     * Fires once when drag/arrow-key gesture settles (position to persist).
-     * Also fires after resize, since pulling west/north edge relocates origin.
+     * Fires once when a drag/arrow-key gesture settles, and after resize too since west/north grips relocate the origin.
      * @default undefined
      */
-    onPositionCommit?: (position: FloatingPanelPosition) => void;
+    onPositionCommit?: ((position: FloatingPanelPosition) => void) | undefined;
     /**
-     * The panel's box, for controlled usage. Pair with `onSizeChange` or the
-     * panel will refuse to resize.
+     * The panel's box, for controlled usage; pair with `onSizeChange` or it refuses to resize.
      * @default undefined — uncontrolled, tracks its own size internally.
      */
-    size?: FloatingPanelSize;
+    size?: FloatingPanelSize | undefined;
     /**
      * The panel's starting box, for uncontrolled usage.
      * @default { width: 320, height: 240 }
      */
-    defaultSize?: FloatingPanelSize;
+    defaultSize?: FloatingPanelSize | undefined;
     /**
-     * Fires with the clamped size on every resize frame and every arrow-key
-     * nudge — not once per gesture.
+     * Fires with the clamped size on every resize frame and arrow-key nudge, not once per gesture.
      * @default undefined — no-op if omitted.
      */
-    onSizeChange?: (size: FloatingPanelSize) => void;
+    onSizeChange?: ((size: FloatingPanelSize) => void) | undefined;
     /**
-     * Fires once when resize gesture settles (size to persist).
-     * Move never fires it.
+     * Fires once when a resize gesture settles; a move alone never fires it.
      * @default undefined
      */
-    onSizeCommit?: (size: FloatingPanelSize) => void;
+    onSizeCommit?: ((size: FloatingPanelSize) => void) | undefined;
     /**
-     * Smallest box the panel can be resized to. Every resize is clamped to it,
-     * so a consumer never has to defend against a zero-height panel.
+     * Smallest box the panel can be resized to; every resize is clamped to it.
      * @default { width: 160, height: 120 }
      */
-    minSize?: FloatingPanelSize;
+    minSize?: FloatingPanelSize | undefined;
     /**
      * Largest box the panel can be resized to.
      * @default { width: Infinity, height: Infinity } — only the boundary limits growth.
      */
-    maxSize?: FloatingPanelSize;
+    maxSize?: FloatingPanelSize | undefined;
     /**
-     * Element the panel may not be dragged or resized out of. Position is
-     * measured from this element's top-left corner, so it must be the panel's
-     * containing block for the published geometry to line up.
+     * Element the panel may not be dragged or resized out of; position is measured from its top-left corner.
      * @default undefined — the viewport constrains the panel instead.
      */
-    boundary?: React.RefObject<HTMLElement | null>;
+    boundary?: React.RefObject<HTMLElement | null> | undefined;
     /**
      * The panel's window state, for controlled usage. Pair with `onStageChange`.
      * @default undefined — uncontrolled, tracks its own stage internally.
      */
-    stage?: FloatingPanelStage;
+    stage?: FloatingPanelStage | undefined;
     /**
      * The panel's starting window state, for uncontrolled usage.
      * @default 'default' — the panel uses its own position and size.
      */
-    defaultStage?: FloatingPanelStage;
+    defaultStage?: FloatingPanelStage | undefined;
     /**
      * Fires with the new stage whenever a {@link FloatingPanelStageTrigger} is pressed.
      * @default undefined — no-op if omitted.
      */
-    onStageChange?: (stage: FloatingPanelStage) => void;
+    onStageChange?: ((stage: FloatingPanelStage) => void) | undefined;
     /**
-     * Whether the header can move the panel. `false` leaves the header focusable
-     * only if you make it so, and drops its `move` cursor.
+     * Whether the header can move the panel; `false` drops its `move` cursor.
      * @default true
      */
-    draggable?: boolean;
+    draggable?: boolean | undefined;
     /**
-     * Whether resize triggers do anything. `false` makes every
-     * {@link FloatingPanelResizeTrigger} inert and non-focusable, so a fixed-size
-     * panel can still render its grips for visual symmetry.
+     * Whether resize triggers do anything; `false` makes every {@link FloatingPanelResizeTrigger} inert and non-focusable.
      * @default true
      */
-    resizable?: boolean;
+    resizable?: boolean | undefined;
     /**
-     * How far one arrow key moves or resizes the panel, in pixels. Shift+arrow
-     * uses ten times this.
+     * How far one arrow key moves or resizes the panel, in pixels; Shift+arrow uses ten times this.
      * @default 10
      */
-    step?: number;
+    step?: number | undefined;
     /**
-     * Freezes the panel's geometry: drag, resize, and stage changes are all
-     * refused and their triggers leave the tab order. Opening and closing still
-     * work — a disabled panel is inert, not unreachable.
+     * Freezes the panel's geometry: drag, resize and stage changes are refused and their triggers leave the tab order.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
-     * Words the polite live-region message announced once per drag or resize, on
-     * release. The numbers are already rounded to whole CSS pixels. Return `''`
-     * to announce nothing.
+     * Words the polite live-region message announced once per drag or resize, on release; return `''` to announce nothing.
      * @default undefined — the built-in English wording ("Panel moved to 40, 25").
      */
-    getGestureAnnouncement?: (gesture: FloatingPanelGesture, detail: FloatingPanelGeometry) => string;
+    getGestureAnnouncement?: ((gesture: FloatingPanelGesture, detail: FloatingPanelGeometry) => string) | undefined;
 }
 /** The panel's geometry at the moment a gesture ended, handed to {@link FloatingPanelProps.getGestureAnnouncement}. */
 export interface FloatingPanelGeometry {
@@ -242,42 +212,38 @@ export interface FloatingPanelTriggerProps extends PrimitivePropsWithRef<'button
 /** Props for {@link FloatingPanelPortal}, which teleports the panel to `document.body`. */
 export interface FloatingPanelPortalProps extends PortalProps {
     /**
-     * Render the portal even while the panel is closed, instead of unmounting
-     * it. Not needed for CSS exit animations — the portal already outlives the
-     * close until `FloatingPanelContent`'s animation ends.
+     * Render the portal even while the panel is closed, instead of unmounting it.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
 /** Props for {@link FloatingPanelContent}, the movable surface itself. */
 export interface FloatingPanelContentProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this panel mounted even while closed. Useful for animation libraries
-     * that drive the exit themselves instead of via CSS.
+     * Keep this panel mounted even while closed, for animation libraries that drive the exit themselves.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
      * Fires when Escape is pressed while the panel is open. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
      * Fires on pointer-down outside the panel and its trigger. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves outside panel and trigger (cancelable, unlike `focusin`).
-     * Non-modal panels don't auto-close on this event.
+     * Fires when focus moves outside the panel and trigger; non-modal panels don't auto-close on it.
      * @default undefined
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
      * Fires for pointer-down or focus outside, before specific handlers. One `preventDefault()` vetoes either.
      * @default undefined
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
 }
 /** Props for {@link FloatingPanelHeader}, the drag handle. */
 export interface FloatingPanelHeaderProps extends PrimitivePropsWithRef<'div'> {
@@ -290,18 +256,11 @@ export interface FloatingPanelCloseTriggerProps extends PrimitivePropsWithRef<'b
 }
 /** Props for {@link FloatingPanelResizeTrigger}, one edge or corner grip. */
 export interface FloatingPanelResizeTriggerProps extends PrimitivePropsWithRef<'div'> {
-    /**
-     * Which edge or corner this grip pulls. Corners move two edges at once.
-     * There is no default — a grip that does not say what it resizes cannot resize anything.
-     */
+    /** Which edge or corner this grip pulls; corners move two edges at once. */
     direction: FloatingPanelResizeDirection;
 }
 /** Props for {@link FloatingPanelStageTrigger}, a minimize/maximize/restore button. */
 export interface FloatingPanelStageTriggerProps extends PrimitivePropsWithRef<'button'> {
-    /**
-     * The stage this button switches to. Pressing it while the panel is already
-     * in that stage restores `'default'`, which is what makes one button a
-     * minimize *and* a restore.
-     */
+    /** The stage this button switches to; pressing it while already in that stage restores `'default'`. */
     stage: FloatingPanelStage;
 }

package/dist/floating-panel/types.d.ts

@@ -13,18 +13,11 @@ export interface FloatingPanelSize {
     width: number;
     height: number;
 }
-/**
- * Panel window state. `default`: uses position/size; `maximized`: fills boundary;
- * `minimized`: collapses to header height. Only `default` is draggable/resizable.
- */
+/** Panel window state: `default` uses position/size, `maximized` fills the boundary, `minimized` collapses to header height; only `default` is draggable/resizable. */
 export type FloatingPanelStage = 'default' | 'minimized' | 'maximized';
 /** Which edge or corner a {@link FloatingPanelResizeTrigger} pulls. */
 export type FloatingPanelResizeDirection = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
-/**
- * Gesture type for release announcements: `'move'` (header drag) or `'resize'` (edge/corner pull).
- * Announced once per gesture settlement (not per frame).
- * @internal
- */
+/** @internal Gesture type for release announcements: `'move'` (header drag) or `'resize'` (edge/corner pull). */
 export type FloatingPanelGesture = 'move' | 'resize';
 /** Shared state distributed from {@link FloatingPanel} to its parts via context. @internal */
 export interface FloatingPanelContextValue {
@@ -66,21 +59,17 @@ export interface FloatingPanelContextValue {
  */
 export interface FloatingPanelProps extends PassThroughProps {
     /**
-     * The panel's body, rendered inside the derived `FloatingPanelContent` below
-     * the derived header. Never inspected — the anatomy is always derived.
+     * The panel's body, rendered inside the derived `FloatingPanelContent` below the derived header.
      * @default undefined — an empty panel body.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
-     * The panel's heading, rendered as the derived title inside the derived
-     * header. Omitting it derives no title at all and withholds Content's
-     * `aria-labelledby` with it, so name a title-less panel with `aria-label`.
+     * The panel's heading, rendered as the derived title inside the derived header.
      * @default undefined — no title renders.
      */
-    title?: string;
+    title?: string | undefined;
     /**
-     * Window controls (stage triggers). The `label` is provided, not derived from stage name
-     * (avoids baking English into headless library).
+     * Window controls (stage triggers); each supplies its own visible `label`.
      * @default []
      */
     stages?: ReadonlyArray<{
@@ -88,146 +77,127 @@ export interface FloatingPanelProps extends PassThroughProps {
         stage: FloatingPanelStage;
         /** The control's visible text, and its accessible name. */
         label: string;
-    }>;
+    }> | undefined;
     /**
-     * Whether the derived header renders a close button. `false` withholds it,
-     * for a panel whose only exit is your own control or a programmatic close.
+     * Whether the derived header renders a close button.
      * @default true
      */
-    dismissible?: boolean;
+    dismissible?: boolean | undefined;
     /**
      * Whether the panel is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the panel is initially open, for uncontrolled usage.
      * @default false — the panel is closed until the trigger is pressed.
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the panel opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires once animation settles (settled counterpart to `onOpenChange`).
-     * Only on open transition; drag/resize have their own settled callbacks.
+     * Fires once the open/close animation settles, the settled counterpart to `onOpenChange`.
      * @default undefined
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
     /**
-     * The panel's top-left corner, for controlled usage. Pair with `onPositionChange`
-     * or the panel will refuse to move.
+     * The panel's top-left corner, for controlled usage; pair with `onPositionChange` or it refuses to move.
      * @default undefined — uncontrolled, tracks its own position internally.
      */
-    position?: FloatingPanelPosition;
+    position?: FloatingPanelPosition | undefined;
     /**
      * Where the panel starts, for uncontrolled usage.
      * @default { x: 0, y: 0 } — the top-left corner of the boundary.
      */
-    defaultPosition?: FloatingPanelPosition;
+    defaultPosition?: FloatingPanelPosition | undefined;
     /**
-     * Fires with the clamped position on every drag frame and every arrow-key
-     * nudge — not once per gesture. Throttle it yourself if the work is expensive.
+     * Fires with the clamped position on every drag frame and arrow-key nudge, not once per gesture.
      * @default undefined — no-op if omitted.
      */
-    onPositionChange?: (position: FloatingPanelPosition) => void;
+    onPositionChange?: ((position: FloatingPanelPosition) => void) | undefined;
     /**
-     * Fires once when drag/arrow-key gesture settles (position to persist).
-     * Also fires after resize, since pulling west/north edge relocates origin.
+     * Fires once when a drag/arrow-key gesture settles, and after resize too since west/north grips relocate the origin.
      * @default undefined
      */
-    onPositionCommit?: (position: FloatingPanelPosition) => void;
+    onPositionCommit?: ((position: FloatingPanelPosition) => void) | undefined;
     /**
-     * The panel's box, for controlled usage. Pair with `onSizeChange` or the
-     * panel will refuse to resize.
+     * The panel's box, for controlled usage; pair with `onSizeChange` or it refuses to resize.
      * @default undefined — uncontrolled, tracks its own size internally.
      */
-    size?: FloatingPanelSize;
+    size?: FloatingPanelSize | undefined;
     /**
      * The panel's starting box, for uncontrolled usage.
      * @default { width: 320, height: 240 }
      */
-    defaultSize?: FloatingPanelSize;
+    defaultSize?: FloatingPanelSize | undefined;
     /**
-     * Fires with the clamped size on every resize frame and every arrow-key
-     * nudge — not once per gesture.
+     * Fires with the clamped size on every resize frame and arrow-key nudge, not once per gesture.
      * @default undefined — no-op if omitted.
      */
-    onSizeChange?: (size: FloatingPanelSize) => void;
+    onSizeChange?: ((size: FloatingPanelSize) => void) | undefined;
     /**
-     * Fires once when resize gesture settles (size to persist).
-     * Move never fires it.
+     * Fires once when a resize gesture settles; a move alone never fires it.
      * @default undefined
      */
-    onSizeCommit?: (size: FloatingPanelSize) => void;
+    onSizeCommit?: ((size: FloatingPanelSize) => void) | undefined;
     /**
-     * Smallest box the panel can be resized to. Every resize is clamped to it,
-     * so a consumer never has to defend against a zero-height panel.
+     * Smallest box the panel can be resized to; every resize is clamped to it.
      * @default { width: 160, height: 120 }
      */
-    minSize?: FloatingPanelSize;
+    minSize?: FloatingPanelSize | undefined;
     /**
      * Largest box the panel can be resized to.
      * @default { width: Infinity, height: Infinity } — only the boundary limits growth.
      */
-    maxSize?: FloatingPanelSize;
+    maxSize?: FloatingPanelSize | undefined;
     /**
-     * Element the panel may not be dragged or resized out of. Position is
-     * measured from this element's top-left corner, so it must be the panel's
-     * containing block for the published geometry to line up.
+     * Element the panel may not be dragged or resized out of; position is measured from its top-left corner.
      * @default undefined — the viewport constrains the panel instead.
      */
-    boundary?: React.RefObject<HTMLElement | null>;
+    boundary?: React.RefObject<HTMLElement | null> | undefined;
     /**
      * The panel's window state, for controlled usage. Pair with `onStageChange`.
      * @default undefined — uncontrolled, tracks its own stage internally.
      */
-    stage?: FloatingPanelStage;
+    stage?: FloatingPanelStage | undefined;
     /**
      * The panel's starting window state, for uncontrolled usage.
      * @default 'default' — the panel uses its own position and size.
      */
-    defaultStage?: FloatingPanelStage;
+    defaultStage?: FloatingPanelStage | undefined;
     /**
      * Fires with the new stage whenever a {@link FloatingPanelStageTrigger} is pressed.
      * @default undefined — no-op if omitted.
      */
-    onStageChange?: (stage: FloatingPanelStage) => void;
+    onStageChange?: ((stage: FloatingPanelStage) => void) | undefined;
     /**
-     * Whether the header can move the panel. `false` leaves the header focusable
-     * only if you make it so, and drops its `move` cursor.
+     * Whether the header can move the panel; `false` drops its `move` cursor.
      * @default true
      */
-    draggable?: boolean;
+    draggable?: boolean | undefined;
     /**
-     * Whether resize triggers do anything. `false` makes every
-     * {@link FloatingPanelResizeTrigger} inert and non-focusable, so a fixed-size
-     * panel can still render its grips for visual symmetry.
+     * Whether resize triggers do anything; `false` makes every {@link FloatingPanelResizeTrigger} inert and non-focusable.
      * @default true
      */
-    resizable?: boolean;
+    resizable?: boolean | undefined;
     /**
-     * How far one arrow key moves or resizes the panel, in pixels. Shift+arrow
-     * uses ten times this.
+     * How far one arrow key moves or resizes the panel, in pixels; Shift+arrow uses ten times this.
      * @default 10
      */
-    step?: number;
+    step?: number | undefined;
     /**
-     * Freezes the panel's geometry: drag, resize, and stage changes are all
-     * refused and their triggers leave the tab order. Opening and closing still
-     * work — a disabled panel is inert, not unreachable.
+     * Freezes the panel's geometry: drag, resize and stage changes are refused and their triggers leave the tab order.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
     /**
-     * Words the polite live-region message announced once per drag or resize, on
-     * release. The numbers are already rounded to whole CSS pixels. Return `''`
-     * to announce nothing.
+     * Words the polite live-region message announced once per drag or resize, on release; return `''` to announce nothing.
      * @default undefined — the built-in English wording ("Panel moved to 40, 25").
      */
-    getGestureAnnouncement?: (gesture: FloatingPanelGesture, detail: FloatingPanelGeometry) => string;
+    getGestureAnnouncement?: ((gesture: FloatingPanelGesture, detail: FloatingPanelGeometry) => string) | undefined;
 }
 /** The panel's geometry at the moment a gesture ended, handed to {@link FloatingPanelProps.getGestureAnnouncement}. */
 export interface FloatingPanelGeometry {
@@ -242,42 +212,38 @@ export interface FloatingPanelTriggerProps extends PrimitivePropsWithRef<'button
 /** Props for {@link FloatingPanelPortal}, which teleports the panel to `document.body`. */
 export interface FloatingPanelPortalProps extends PortalProps {
     /**
-     * Render the portal even while the panel is closed, instead of unmounting
-     * it. Not needed for CSS exit animations — the portal already outlives the
-     * close until `FloatingPanelContent`'s animation ends.
+     * Render the portal even while the panel is closed, instead of unmounting it.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
 /** Props for {@link FloatingPanelContent}, the movable surface itself. */
 export interface FloatingPanelContentProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this panel mounted even while closed. Useful for animation libraries
-     * that drive the exit themselves instead of via CSS.
+     * Keep this panel mounted even while closed, for animation libraries that drive the exit themselves.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
      * Fires when Escape is pressed while the panel is open. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    onEscapeKeyDown?: ((event: KeyboardEvent) => void) | undefined;
     /**
      * Fires on pointer-down outside the panel and its trigger. Call `event.preventDefault()` to stop it from closing.
      * @default undefined — no-op if omitted.
      */
-    onPointerDownOutside?: (event: PointerEvent) => void;
+    onPointerDownOutside?: ((event: PointerEvent) => void) | undefined;
     /**
-     * Fires when focus moves outside panel and trigger (cancelable, unlike `focusin`).
-     * Non-modal panels don't auto-close on this event.
+     * Fires when focus moves outside the panel and trigger; non-modal panels don't auto-close on it.
      * @default undefined
      */
-    onFocusOutside?: (event: FocusOutsideEvent) => void;
+    onFocusOutside?: ((event: FocusOutsideEvent) => void) | undefined;
     /**
      * Fires for pointer-down or focus outside, before specific handlers. One `preventDefault()` vetoes either.
      * @default undefined
      */
-    onInteractOutside?: (event: InteractOutsideEvent) => void;
+    onInteractOutside?: ((event: InteractOutsideEvent) => void) | undefined;
 }
 /** Props for {@link FloatingPanelHeader}, the drag handle. */
 export interface FloatingPanelHeaderProps extends PrimitivePropsWithRef<'div'> {
@@ -290,18 +256,11 @@ export interface FloatingPanelCloseTriggerProps extends PrimitivePropsWithRef<'b
 }
 /** Props for {@link FloatingPanelResizeTrigger}, one edge or corner grip. */
 export interface FloatingPanelResizeTriggerProps extends PrimitivePropsWithRef<'div'> {
-    /**
-     * Which edge or corner this grip pulls. Corners move two edges at once.
-     * There is no default — a grip that does not say what it resizes cannot resize anything.
-     */
+    /** Which edge or corner this grip pulls; corners move two edges at once. */
     direction: FloatingPanelResizeDirection;
 }
 /** Props for {@link FloatingPanelStageTrigger}, a minimize/maximize/restore button. */
 export interface FloatingPanelStageTriggerProps extends PrimitivePropsWithRef<'button'> {
-    /**
-     * The stage this button switches to. Pressing it while the panel is already
-     * in that stage restores `'default'`, which is what makes one button a
-     * minimize *and* a restore.
-     */
+    /** The stage this button switches to; pressing it while already in that stage restores `'default'`. */
     stage: FloatingPanelStage;
 }