@skdx/react 0.28.0 → 0.29.0

package/dist/navigation-menu/NavigationMenuAnatomy.d.ts

@@ -1,13 +1,7 @@
 import type * as React from 'react';
 import type { NavigationMenuItem as NavigationMenuItemData } from './types.js';
-/**
- * The anatomy a {@link NavigationMenu} draws from `items`: the list, one
- * `NavigationMenuItem` per entry holding either a `NavigationMenuLink` or a `NavigationMenuTrigger` plus a `NavigationMenuContent`
- * panel of links, and the `NavigationMenuIndicator` beside the list.
- *
- * @internal
- */
+/** @internal The anatomy a {@link NavigationMenu} draws from `items`: the list, one `NavigationMenuItem` per entry, and the `NavigationMenuIndicator`. */
 export declare const NavigationMenuAnatomy: ({ items, renderItem, }: {
-    items?: NavigationMenuItemData[];
-    renderItem?: (item: NavigationMenuItemData) => React.ReactNode;
+    items?: NavigationMenuItemData[] | undefined;
+    renderItem?: ((item: NavigationMenuItemData) => React.ReactNode) | undefined;
 }) => React.JSX.Element;

package/dist/navigation-menu/NavigationMenuContent.d.cts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { NavigationMenuContentProps } from './types.cjs';
 /**
- * Content panel revealed by a {@link NavigationMenuTrigger}: renders `<div role="region">`
- * labelled by trigger's `id`, with `data-state="open" | "closed"`, unmounted while closed (unless `forceMount`).
- * Pointer-enter cancels root's close timer; pointer-leave restarts it. Escape closes menu and
- * refocuses trigger through shared dismiss layer (works with focus anywhere on page; only topmost
- * layer consumes key). Also dismisses on outside pointerdown and focus moving outside trigger/panel.
+ * Content panel revealed by a {@link NavigationMenuTrigger}, rendered as `<div role="region">` labelled by the trigger's `id` and unmounted while closed unless `forceMount`.
  *
  * @example
  * ```tsx
@@ -14,4 +10,7 @@ import type { NavigationMenuContentProps } from './types.cjs';
  * </NavigationMenuContent>
  * ```
  */
-export declare const NavigationMenuContent: React.ForwardRefExoticComponent<Omit<NavigationMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const NavigationMenuContent: {
+    ({ forceMount, ref: forwardedRef, ...props }: NavigationMenuContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuContent.d.ts

@@ -1,11 +1,7 @@
 import * as React from 'react';
 import type { NavigationMenuContentProps } from './types.js';
 /**
- * Content panel revealed by a {@link NavigationMenuTrigger}: renders `<div role="region">`
- * labelled by trigger's `id`, with `data-state="open" | "closed"`, unmounted while closed (unless `forceMount`).
- * Pointer-enter cancels root's close timer; pointer-leave restarts it. Escape closes menu and
- * refocuses trigger through shared dismiss layer (works with focus anywhere on page; only topmost
- * layer consumes key). Also dismisses on outside pointerdown and focus moving outside trigger/panel.
+ * Content panel revealed by a {@link NavigationMenuTrigger}, rendered as `<div role="region">` labelled by the trigger's `id` and unmounted while closed unless `forceMount`.
  *
  * @example
  * ```tsx
@@ -14,4 +10,7 @@ import type { NavigationMenuContentProps } from './types.js';
  * </NavigationMenuContent>
  * ```
  */
-export declare const NavigationMenuContent: React.ForwardRefExoticComponent<Omit<NavigationMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const NavigationMenuContent: {
+    ({ forceMount, ref: forwardedRef, ...props }: NavigationMenuContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuIndicator.d.cts

@@ -1,9 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuIndicatorProps } from './types.cjs';
 /**
- * Optional visual pointer tracking whether any menu item is open. Renders a
- * `<div>` with `data-state` (`visible` or `hidden`), unmounted unless `forceMount`.
- * Sizing and positioning is left to CSS.
+ * Optional visual pointer tracking whether any menu item is open, rendered as a `<div>` with `data-state` and CSS-driven sizing and positioning.
  *
  * @example
  * ```tsx
@@ -11,4 +9,7 @@ import type { NavigationMenuIndicatorProps } from './types.cjs';
  * <NavigationMenuIndicator />
  * ```
  */
-export declare const NavigationMenuIndicator: React.ForwardRefExoticComponent<Omit<NavigationMenuIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const NavigationMenuIndicator: {
+    ({ forceMount, ref: forwardedRef, ...props }: NavigationMenuIndicatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuIndicator.d.ts

@@ -1,9 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuIndicatorProps } from './types.js';
 /**
- * Optional visual pointer tracking whether any menu item is open. Renders a
- * `<div>` with `data-state` (`visible` or `hidden`), unmounted unless `forceMount`.
- * Sizing and positioning is left to CSS.
+ * Optional visual pointer tracking whether any menu item is open, rendered as a `<div>` with `data-state` and CSS-driven sizing and positioning.
  *
  * @example
  * ```tsx
@@ -11,4 +9,7 @@ import type { NavigationMenuIndicatorProps } from './types.js';
  * <NavigationMenuIndicator />
  * ```
  */
-export declare const NavigationMenuIndicator: React.ForwardRefExoticComponent<Omit<NavigationMenuIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const NavigationMenuIndicator: {
+    ({ forceMount, ref: forwardedRef, ...props }: NavigationMenuIndicatorProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuItem.d.cts

@@ -1,11 +1,8 @@
 import * as React from 'react';
 import type { NavigationMenuItemContextValue, NavigationMenuItemProps } from './types.cjs';
-export declare const NavigationMenuItemProvider: {
-    (props: NavigationMenuItemContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useNavigationMenuItemContext: (consumerName: string) => NavigationMenuItemContextValue;
+export declare const NavigationMenuItemProvider: React.FC<NavigationMenuItemContextValue & {
+    children: React.ReactNode;
+}>, useNavigationMenuItemContext: (consumerName: string) => NavigationMenuItemContextValue;
 /**
  * A single `<li>` entry in the menu that generates `id`s linking its trigger
  * and content, and provides `value` via context.
@@ -18,4 +15,7 @@ export declare const NavigationMenuItemProvider: {
  * </NavigationMenuItem>
  * ```
  */
-export declare const NavigationMenuItem: React.ForwardRefExoticComponent<Omit<NavigationMenuItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;
+export declare const NavigationMenuItem: {
+    ({ value, ref: forwardedRef, ...props }: NavigationMenuItemProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuItem.d.ts

@@ -1,11 +1,8 @@
 import * as React from 'react';
 import type { NavigationMenuItemContextValue, NavigationMenuItemProps } from './types.js';
-export declare const NavigationMenuItemProvider: {
-    (props: NavigationMenuItemContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, useNavigationMenuItemContext: (consumerName: string) => NavigationMenuItemContextValue;
+export declare const NavigationMenuItemProvider: React.FC<NavigationMenuItemContextValue & {
+    children: React.ReactNode;
+}>, useNavigationMenuItemContext: (consumerName: string) => NavigationMenuItemContextValue;
 /**
  * A single `<li>` entry in the menu that generates `id`s linking its trigger
  * and content, and provides `value` via context.
@@ -18,4 +15,7 @@ export declare const NavigationMenuItemProvider: {
  * </NavigationMenuItem>
  * ```
  */
-export declare const NavigationMenuItem: React.ForwardRefExoticComponent<Omit<NavigationMenuItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;
+export declare const NavigationMenuItem: {
+    ({ value, ref: forwardedRef, ...props }: NavigationMenuItemProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuLink.d.cts

@@ -1,13 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuLinkProps } from './types.cjs';
 /**
- * Plain navigable `<a>` for use in `NavigationMenuList` (joins roving focus)
- * or `NavigationMenuContent`. When `active`, sets `data-active` and
- * `aria-current="page"`. Closes menu on click unless root disables it.
+ * Plain navigable `<a>` for use in `NavigationMenuList` or `NavigationMenuContent`, setting `data-active`/`aria-current` when `active` and closing the menu on click unless disabled.
  *
  * @example
  * ```tsx
  * <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
  * ```
  */
-export declare const NavigationMenuLink: React.ForwardRefExoticComponent<Omit<NavigationMenuLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+export declare const NavigationMenuLink: {
+    ({ active, ref: forwardedRef, ...props }: NavigationMenuLinkProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuLink.d.ts

@@ -1,13 +1,14 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuLinkProps } from './types.js';
 /**
- * Plain navigable `<a>` for use in `NavigationMenuList` (joins roving focus)
- * or `NavigationMenuContent`. When `active`, sets `data-active` and
- * `aria-current="page"`. Closes menu on click unless root disables it.
+ * Plain navigable `<a>` for use in `NavigationMenuList` or `NavigationMenuContent`, setting `data-active`/`aria-current` when `active` and closing the menu on click unless disabled.
  *
  * @example
  * ```tsx
  * <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
  * ```
  */
-export declare const NavigationMenuLink: React.ForwardRefExoticComponent<Omit<NavigationMenuLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+export declare const NavigationMenuLink: {
+    ({ active, ref: forwardedRef, ...props }: NavigationMenuLinkProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuList.d.cts

@@ -1,14 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuListProps } from './types.cjs';
 /**
- * `<ul data-orientation="…">` container for {@link NavigationMenuItem}s.
- * Provides roving-focus arrow-key navigation across the top-level items marked
- * `data-skdx-nav-trigger`, wrapping by default. Links rendered inside an open
- * {@link NavigationMenuContent} are deliberately not part of that ring.
- *
- * The axis comes from the root's `orientation` prop: Left/Right when
- * horizontal, Up/Down when vertical. Arrow keys that do not match the axis are
- * left alone, so a vertical menu does not swallow Left/Right.
+ * `<ul data-orientation="…">` container for {@link NavigationMenuItem}s, providing roving-focus arrow-key navigation across top-level items.
  *
  * @example
  * ```tsx
@@ -20,4 +13,7 @@ import type { NavigationMenuListProps } from './types.cjs';
  * </NavigationMenuList>
  * ```
  */
-export declare const NavigationMenuList: React.ForwardRefExoticComponent<Omit<NavigationMenuListProps, "ref"> & React.RefAttributes<HTMLUListElement>>;
+export declare const NavigationMenuList: {
+    ({ loop, ref: forwardedRef, ...props }: NavigationMenuListProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuList.d.ts

@@ -1,14 +1,7 @@
-import * as React from 'react';
+import type * as React from 'react';
 import type { NavigationMenuListProps } from './types.js';
 /**
- * `<ul data-orientation="…">` container for {@link NavigationMenuItem}s.
- * Provides roving-focus arrow-key navigation across the top-level items marked
- * `data-skdx-nav-trigger`, wrapping by default. Links rendered inside an open
- * {@link NavigationMenuContent} are deliberately not part of that ring.
- *
- * The axis comes from the root's `orientation` prop: Left/Right when
- * horizontal, Up/Down when vertical. Arrow keys that do not match the axis are
- * left alone, so a vertical menu does not swallow Left/Right.
+ * `<ul data-orientation="…">` container for {@link NavigationMenuItem}s, providing roving-focus arrow-key navigation across top-level items.
  *
  * @example
  * ```tsx
@@ -20,4 +13,7 @@ import type { NavigationMenuListProps } from './types.js';
  * </NavigationMenuList>
  * ```
  */
-export declare const NavigationMenuList: React.ForwardRefExoticComponent<Omit<NavigationMenuListProps, "ref"> & React.RefAttributes<HTMLUListElement>>;
+export declare const NavigationMenuList: {
+    ({ loop, ref: forwardedRef, ...props }: NavigationMenuListProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuTrigger.d.cts

@@ -1,18 +1,14 @@
 import * as React from 'react';
 import type { NavigationMenuTriggerProps } from './types.cjs';
 /**
- * Button that opens its item's {@link NavigationMenuContent}: renders a `<button>` marked
- * `data-skdx-nav-trigger` with `aria-expanded`, `aria-controls`, and `data-state="open" | "closed"`.
- * Non-touch pointer-enter/leave start hover timers; click or Enter/Space opens, closes when not hover-opened
- * (so touch/keyboard users can dismiss, mouse click after hover doesn't undo itself).
- * Escape closes and refocuses the trigger.
- *
- * In horizontal menu, ArrowDown on *open* trigger moves focus to first tabbable in content panel
- * (keyboard route in, Escape is route out). Vertical menu leaves key to list's top-level ring ("next entry").
+ * Button that opens its item's {@link NavigationMenuContent}, rendered as a `<button data-skdx-nav-trigger>` with `aria-expanded`/`aria-controls` reflecting open state.
  *
  * @example
  * ```tsx
  * <NavigationMenuTrigger>Products</NavigationMenuTrigger>
  * ```
  */
-export declare const NavigationMenuTrigger: React.ForwardRefExoticComponent<Omit<NavigationMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const NavigationMenuTrigger: {
+    ({ ref: forwardedRef, ...props }: NavigationMenuTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/NavigationMenuTrigger.d.ts

@@ -1,18 +1,14 @@
 import * as React from 'react';
 import type { NavigationMenuTriggerProps } from './types.js';
 /**
- * Button that opens its item's {@link NavigationMenuContent}: renders a `<button>` marked
- * `data-skdx-nav-trigger` with `aria-expanded`, `aria-controls`, and `data-state="open" | "closed"`.
- * Non-touch pointer-enter/leave start hover timers; click or Enter/Space opens, closes when not hover-opened
- * (so touch/keyboard users can dismiss, mouse click after hover doesn't undo itself).
- * Escape closes and refocuses the trigger.
- *
- * In horizontal menu, ArrowDown on *open* trigger moves focus to first tabbable in content panel
- * (keyboard route in, Escape is route out). Vertical menu leaves key to list's top-level ring ("next entry").
+ * Button that opens its item's {@link NavigationMenuContent}, rendered as a `<button data-skdx-nav-trigger>` with `aria-expanded`/`aria-controls` reflecting open state.
  *
  * @example
  * ```tsx
  * <NavigationMenuTrigger>Products</NavigationMenuTrigger>
  * ```
  */
-export declare const NavigationMenuTrigger: React.ForwardRefExoticComponent<Omit<NavigationMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export declare const NavigationMenuTrigger: {
+    ({ ref: forwardedRef, ...props }: NavigationMenuTriggerProps): React.ReactNode;
+    displayName: string;
+};

package/dist/navigation-menu/types.d.cts

@@ -13,12 +13,12 @@ export type NavigationMenuItem = {
      * Marks the link as the current page — `aria-current="page"` and `data-active`.
      * @default false
      */
-    active?: boolean;
+    active?: boolean | undefined;
     /**
      * Identifier matched against the root's open `value`.
      * @default undefined — the entry's index in `items`, as a string.
      */
-    value?: string;
+    value?: string | undefined;
 } | {
     /** Text rendered inside the derived `NavigationMenuTrigger`. */
     label: string;
@@ -26,7 +26,7 @@ export type NavigationMenuItem = {
      * Identifier matched against the root's open `value`.
      * @default undefined — the entry's index in `items`, as a string.
      */
-    value?: string;
+    value?: string | undefined;
     /** The links the derived panel holds. */
     items: {
         /** Text rendered inside the derived `NavigationMenuLink`. */
@@ -37,10 +37,10 @@ export type NavigationMenuItem = {
          * Marks the link as the current page — `aria-current="page"` and `data-active`.
          * @default false
          */
-        active?: boolean;
+        active?: boolean | undefined;
     }[];
 };
-/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. Not part of the public API. */
+/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. */
 export interface NavigationMenuContextValue {
     /** Value of the open item, or `null` when nothing is open. */
     value: string | null;
@@ -55,68 +55,65 @@ export interface NavigationMenuContextValue {
     /** What a Link's click does — closes the menu, or nothing when `closeOnSelect` is false. */
     onLinkSelect: () => void;
 }
-/**
- * Props for the {@link NavigationMenu} root. `defaultValue` redeclared to accept
- * `null` (closed sentinel), which `HTMLAttributes` does not support.
- */
+/** Props for the {@link NavigationMenu} root, with `defaultValue` redeclared to accept `null` as the closed sentinel. */
 export interface NavigationMenuProps extends Omit<PrimitivePropsWithRef<'nav'>, 'defaultValue'> {
     /**
      * The menu's entries, rendered into a derived list. Ignored when `children`
      * is given, which switches to full manual composition.
      * @default undefined — an empty menu.
      */
-    items?: NavigationMenuItem[];
+    items?: NavigationMenuItem[] | undefined;
     /**
      * Render override for entry bodies (panel contents or link text). Called once
      * per entry, never for nested links. Library owns roles, ids, href, aria-current.
      * @default undefined — the panel's links, or the entry's `label`, is rendered.
      */
-    renderItem?: (item: NavigationMenuItem) => React.ReactNode;
+    renderItem?: ((item: NavigationMenuItem) => React.ReactNode) | undefined;
     /**
      * Axis the menu runs along; sets `data-orientation`, switches arrow keys, keys
      * layout. Use `'vertical'` for sidebars, footers, or mobile.
      * @default 'horizontal'
      */
-    orientation?: 'horizontal' | 'vertical';
+    orientation?: 'horizontal' | 'vertical' | undefined;
     /**
      * Currently open item value (controlled). Pair with `onValueChange`; `null`
      * means nothing is open. Use `null` not `''` to avoid ambiguity.
      * @default undefined — uncontrolled, tracks its own open item internally.
      */
-    value?: string | null;
+    value?: string | null | undefined;
     /**
      * Initially open item's value, for uncontrolled usage. `null` starts closed.
      * @default null — no item open initially.
      */
-    defaultValue?: string | null;
+    defaultValue?: string | null | undefined;
     /**
      * Fires with the new value whenever the open item changes, controlled or
      * not, and with `null` when everything closes.
      * @default undefined — no-op if omitted.
      */
-    onValueChange?: (value: string | null) => void;
+    onValueChange?: ((value: string | null) => void) | undefined;
     /**
      * Delay before hovering a trigger opens its content (ms).
      * @default 200
      */
-    delayDuration?: number;
+    delayDuration?: number | undefined;
     /**
      * Window after closing during which re-hovering a sibling trigger opens instantly (ms).
      * @default 300
      */
-    skipDelayDuration?: number;
+    skipDelayDuration?: number | undefined;
     /**
      * Grace period after pointer leaves trigger or panel (ms). Accommodates layout
      * gaps; too short closes panels while pointer travels between boxes.
      * @default 150
      */
-    closeDelayDuration?: number;
+    closeDelayDuration?: number | undefined;
     /**
      * Whether activating a link closes the open panel. `false` keeps it open
      * during route transitions. No menu event fires; link click is the event.
      * @default true
      */
-    closeOnSelect?: boolean;
+    closeOnSelect?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuList}, the roving-focus container for `NavigationMenuItem`s. */
 export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
@@ -125,9 +122,9 @@ export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
      * (and vice versa).
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
 }
-/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. Not part of the public API. */
+/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. */
 export interface NavigationMenuItemContextValue {
     value: string;
     triggerId: string;
@@ -144,12 +141,10 @@ export interface NavigationMenuTriggerProps extends PrimitivePropsWithRef<'butto
 /** Props for {@link NavigationMenuContent}, the panel revealed by a trigger. */
 export interface NavigationMenuContentProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this panel mounted even while inactive, instead of unmounting it.
-     * Useful for animation libraries that need the outgoing panel present in
-     * the DOM during an exit transition.
+     * Keeps this panel mounted even while inactive, instead of unmounting it, for animation libraries needing the outgoing content present.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuLink}, a plain navigable item within the menu (list item or content panel). */
 export interface NavigationMenuLinkProps extends PrimitivePropsWithRef<'a'> {
@@ -157,15 +152,13 @@ export interface NavigationMenuLinkProps extends PrimitivePropsWithRef<'a'> {
      * Marks this link as representing the current page (sets `data-active` and `aria-current="page"`).
      * @default false
      */
-    active?: boolean;
+    active?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuIndicator}, a visual pointer that tracks the active trigger. */
 export interface NavigationMenuIndicatorProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this indicator mounted even while no item is open, instead of
-     * unmounting it. Useful for animation libraries that need it present in
-     * the DOM during an exit transition.
+     * Keeps this indicator mounted even while no item is open, instead of unmounting it, for animation libraries needing it present.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }

package/dist/navigation-menu/types.d.ts

@@ -13,12 +13,12 @@ export type NavigationMenuItem = {
      * Marks the link as the current page — `aria-current="page"` and `data-active`.
      * @default false
      */
-    active?: boolean;
+    active?: boolean | undefined;
     /**
      * Identifier matched against the root's open `value`.
      * @default undefined — the entry's index in `items`, as a string.
      */
-    value?: string;
+    value?: string | undefined;
 } | {
     /** Text rendered inside the derived `NavigationMenuTrigger`. */
     label: string;
@@ -26,7 +26,7 @@ export type NavigationMenuItem = {
      * Identifier matched against the root's open `value`.
      * @default undefined — the entry's index in `items`, as a string.
      */
-    value?: string;
+    value?: string | undefined;
     /** The links the derived panel holds. */
     items: {
         /** Text rendered inside the derived `NavigationMenuLink`. */
@@ -37,10 +37,10 @@ export type NavigationMenuItem = {
          * Marks the link as the current page — `aria-current="page"` and `data-active`.
          * @default false
          */
-        active?: boolean;
+        active?: boolean | undefined;
     }[];
 };
-/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. Not part of the public API. */
+/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. */
 export interface NavigationMenuContextValue {
     /** Value of the open item, or `null` when nothing is open. */
     value: string | null;
@@ -55,68 +55,65 @@ export interface NavigationMenuContextValue {
     /** What a Link's click does — closes the menu, or nothing when `closeOnSelect` is false. */
     onLinkSelect: () => void;
 }
-/**
- * Props for the {@link NavigationMenu} root. `defaultValue` redeclared to accept
- * `null` (closed sentinel), which `HTMLAttributes` does not support.
- */
+/** Props for the {@link NavigationMenu} root, with `defaultValue` redeclared to accept `null` as the closed sentinel. */
 export interface NavigationMenuProps extends Omit<PrimitivePropsWithRef<'nav'>, 'defaultValue'> {
     /**
      * The menu's entries, rendered into a derived list. Ignored when `children`
      * is given, which switches to full manual composition.
      * @default undefined — an empty menu.
      */
-    items?: NavigationMenuItem[];
+    items?: NavigationMenuItem[] | undefined;
     /**
      * Render override for entry bodies (panel contents or link text). Called once
      * per entry, never for nested links. Library owns roles, ids, href, aria-current.
      * @default undefined — the panel's links, or the entry's `label`, is rendered.
      */
-    renderItem?: (item: NavigationMenuItem) => React.ReactNode;
+    renderItem?: ((item: NavigationMenuItem) => React.ReactNode) | undefined;
     /**
      * Axis the menu runs along; sets `data-orientation`, switches arrow keys, keys
      * layout. Use `'vertical'` for sidebars, footers, or mobile.
      * @default 'horizontal'
      */
-    orientation?: 'horizontal' | 'vertical';
+    orientation?: 'horizontal' | 'vertical' | undefined;
     /**
      * Currently open item value (controlled). Pair with `onValueChange`; `null`
      * means nothing is open. Use `null` not `''` to avoid ambiguity.
      * @default undefined — uncontrolled, tracks its own open item internally.
      */
-    value?: string | null;
+    value?: string | null | undefined;
     /**
      * Initially open item's value, for uncontrolled usage. `null` starts closed.
      * @default null — no item open initially.
      */
-    defaultValue?: string | null;
+    defaultValue?: string | null | undefined;
     /**
      * Fires with the new value whenever the open item changes, controlled or
      * not, and with `null` when everything closes.
      * @default undefined — no-op if omitted.
      */
-    onValueChange?: (value: string | null) => void;
+    onValueChange?: ((value: string | null) => void) | undefined;
     /**
      * Delay before hovering a trigger opens its content (ms).
      * @default 200
      */
-    delayDuration?: number;
+    delayDuration?: number | undefined;
     /**
      * Window after closing during which re-hovering a sibling trigger opens instantly (ms).
      * @default 300
      */
-    skipDelayDuration?: number;
+    skipDelayDuration?: number | undefined;
     /**
      * Grace period after pointer leaves trigger or panel (ms). Accommodates layout
      * gaps; too short closes panels while pointer travels between boxes.
      * @default 150
      */
-    closeDelayDuration?: number;
+    closeDelayDuration?: number | undefined;
     /**
      * Whether activating a link closes the open panel. `false` keeps it open
      * during route transitions. No menu event fires; link click is the event.
      * @default true
      */
-    closeOnSelect?: boolean;
+    closeOnSelect?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuList}, the roving-focus container for `NavigationMenuItem`s. */
 export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
@@ -125,9 +122,9 @@ export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
      * (and vice versa).
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
 }
-/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. Not part of the public API. */
+/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. */
 export interface NavigationMenuItemContextValue {
     value: string;
     triggerId: string;
@@ -144,12 +141,10 @@ export interface NavigationMenuTriggerProps extends PrimitivePropsWithRef<'butto
 /** Props for {@link NavigationMenuContent}, the panel revealed by a trigger. */
 export interface NavigationMenuContentProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this panel mounted even while inactive, instead of unmounting it.
-     * Useful for animation libraries that need the outgoing panel present in
-     * the DOM during an exit transition.
+     * Keeps this panel mounted even while inactive, instead of unmounting it, for animation libraries needing the outgoing content present.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuLink}, a plain navigable item within the menu (list item or content panel). */
 export interface NavigationMenuLinkProps extends PrimitivePropsWithRef<'a'> {
@@ -157,15 +152,13 @@ export interface NavigationMenuLinkProps extends PrimitivePropsWithRef<'a'> {
      * Marks this link as representing the current page (sets `data-active` and `aria-current="page"`).
      * @default false
      */
-    active?: boolean;
+    active?: boolean | undefined;
 }
 /** Props for {@link NavigationMenuIndicator}, a visual pointer that tracks the active trigger. */
 export interface NavigationMenuIndicatorProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Keep this indicator mounted even while no item is open, instead of
-     * unmounting it. Useful for animation libraries that need it present in
-     * the DOM during an exit transition.
+     * Keeps this indicator mounted even while no item is open, instead of unmounting it, for animation libraries needing it present.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
 }