@skdx/react 0.26.0

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

@@ -0,0 +1,35 @@
+import * as React from 'react';
+import type { NavigationMenuContextValue, NavigationMenuProps } from './types.cjs';
+export declare const NavigationMenuRootProvider: {
+    (props: NavigationMenuContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useNavigationMenuContext: (consumerName: string) => NavigationMenuContextValue;
+/**
+ * Root of a hover/click-driven navigation menu: owns which item's content is
+ * open and hands hover-intent timers down to `NavigationMenuItem` /
+ * `NavigationMenuTrigger` / `NavigationMenuContent` via context. Renders a
+ * `<nav>` labelled `"Main"` by default (override via `aria-label`).
+ *
+ * Opening a trigger is delayed by `delayDuration` on first hover, but once
+ * one item is open, moving to a sibling trigger within `skipDelayDuration`
+ * of closing switches instantly. Works controlled (`value` +
+ * `onValueChange`) or uncontrolled (`defaultValue`).
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenu>
+ *   <NavigationMenuList>
+ *     <NavigationMenuItem value="products">
+ *       <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *       <NavigationMenuContent>
+ *         <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ *       </NavigationMenuContent>
+ *     </NavigationMenuItem>
+ *   </NavigationMenuList>
+ *   <NavigationMenuIndicator />
+ * </NavigationMenu>
+ * ```
+ */
+export declare const NavigationMenu: React.ForwardRefExoticComponent<Omit<NavigationMenuProps, "ref"> & React.RefAttributes<HTMLElement>>;

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

@@ -0,0 +1,35 @@
+import * as React from 'react';
+import type { NavigationMenuContextValue, NavigationMenuProps } from './types.js';
+export declare const NavigationMenuRootProvider: {
+    (props: NavigationMenuContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useNavigationMenuContext: (consumerName: string) => NavigationMenuContextValue;
+/**
+ * Root of a hover/click-driven navigation menu: owns which item's content is
+ * open and hands hover-intent timers down to `NavigationMenuItem` /
+ * `NavigationMenuTrigger` / `NavigationMenuContent` via context. Renders a
+ * `<nav>` labelled `"Main"` by default (override via `aria-label`).
+ *
+ * Opening a trigger is delayed by `delayDuration` on first hover, but once
+ * one item is open, moving to a sibling trigger within `skipDelayDuration`
+ * of closing switches instantly. Works controlled (`value` +
+ * `onValueChange`) or uncontrolled (`defaultValue`).
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenu>
+ *   <NavigationMenuList>
+ *     <NavigationMenuItem value="products">
+ *       <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *       <NavigationMenuContent>
+ *         <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ *       </NavigationMenuContent>
+ *     </NavigationMenuItem>
+ *   </NavigationMenuList>
+ *   <NavigationMenuIndicator />
+ * </NavigationMenu>
+ * ```
+ */
+export declare const NavigationMenu: React.ForwardRefExoticComponent<Omit<NavigationMenuProps, "ref"> & React.RefAttributes<HTMLElement>>;

package/dist/navigation-menu/NavigationMenu.js

@@ -0,0 +1 @@
+import*as a from"react";import{createSafeContext as B}from"../utils/createContext.js";import{skdxPart as z}from"../utils/part.js";import{Primitive as A}from"../utils/primitive.js";import{useControllableState as G}from"../utils/useControllableState.js";import{jsx as w}from"react/jsx-runtime";var _=150,[F,g]=B("NavigationMenu"),U=a.forwardRef(({value:n,defaultValue:e,onValueChange:o,delayDuration:t=200,skipDelayDuration:i=300,...u},l)=>{let r=a.useRef(!0),c=a.useRef(0),s=a.useRef(0),R=a.useRef(0),[h="",m]=G({prop:n,defaultProp:e??"",onChange:v=>{window.clearTimeout(R.current),v?r.current=!1:R.current=window.setTimeout(()=>{r.current=!0},i),o?.(v)}});a.useEffect(()=>()=>{window.clearTimeout(c.current),window.clearTimeout(s.current),window.clearTimeout(R.current)},[]);let S=a.useCallback(v=>{window.clearTimeout(s.current),window.clearTimeout(c.current),r.current?c.current=window.setTimeout(()=>m(v),t):m(v)},[m,t]),P=a.useCallback(()=>{window.clearTimeout(c.current),window.clearTimeout(s.current),s.current=window.setTimeout(()=>m(""),_)},[m]),K=a.useCallback(()=>{window.clearTimeout(s.current)},[]),O=a.useCallback(v=>{window.clearTimeout(c.current),window.clearTimeout(s.current),m(v)},[m]),V=a.useCallback(()=>{window.clearTimeout(c.current),window.clearTimeout(s.current),m("")},[m]);return w(F,{value:h,onTriggerEnter:S,onTriggerLeave:P,onContentEnter:K,onContentLeave:P,onItemSelect:O,onClose:V,children:w(A.nav,{"aria-label":u["aria-label"]??"Main",...u,...z("navigation-menu","root",u.className),ref:l})})});U.displayName="NavigationMenu";import*as T from"react";import{skdxPart as Y}from"../utils/part.js";import{composeEventHandlers as q,Primitive as J}from"../utils/primitive.js";import{useRovingFocus as Q}from"../utils/useRovingFocus.js";import{jsx as X}from"react/jsx-runtime";var W="[data-skdx-nav-trigger]",y=T.forwardRef(({loop:n=!0,...e},o)=>{let t=Q({orientation:"horizontal",loop:n,itemSelector:W});return X(J.ul,{"data-orientation":"horizontal",...e,...Y("navigation-menu","list",e.className),ref:o,onKeyDown:q(e.onKeyDown,t)})});y.displayName="NavigationMenuList";import*as d from"react";import{createSafeContext as Z}from"../utils/createContext.js";import{skdxPart as $}from"../utils/part.js";import{Primitive as j}from"../utils/primitive.js";import{jsx as I}from"react/jsx-runtime";var[ee,p]=Z("NavigationMenuItem"),x=d.forwardRef(({value:n,...e},o)=>{let t=d.useId(),i=d.useId();return I(ee,{value:n,triggerId:t,contentId:i,children:I(j.li,{...e,...$("navigation-menu","item",e.className),ref:o})})});x.displayName="NavigationMenuItem";import*as M from"react";import{skdxPart as te}from"../utils/part.js";import{composeEventHandlers as N,Primitive as ne}from"../utils/primitive.js";import{jsx as oe}from"react/jsx-runtime";var L=M.forwardRef((n,e)=>{let o=g("NavigationMenuTrigger"),t=p("NavigationMenuTrigger"),i=o.value===t.value,u=M.useRef(!1),l=()=>{i&&!u.current?o.onClose():o.onItemSelect(t.value)};return oe(ne.button,{type:"button",id:t.triggerId,"aria-expanded":i,"aria-controls":t.contentId,"data-skdx-nav-trigger":"","data-state":i?"open":"closed",...n,...te("navigation-menu","trigger",n.className),ref:e,onPointerEnter:N(n.onPointerEnter,r=>{r.pointerType!=="touch"&&(u.current=!0,o.onTriggerEnter(t.value))}),onPointerLeave:N(n.onPointerLeave,r=>{r.pointerType!=="touch"&&(u.current=!1,o.onTriggerLeave())}),onClick:N(n.onClick,l),onKeyDown:N(n.onKeyDown,r=>{r.key==="Escape"?(o.onClose(),r.currentTarget.focus()):[" ","Enter"].includes(r.key)&&(r.preventDefault(),l())})})});L.displayName="NavigationMenuTrigger";import*as f from"react";import{useComposedRefs as ie}from"../utils/composeRefs.js";import{skdxPart as ae}from"../utils/part.js";import{composeEventHandlers as C,Primitive as re}from"../utils/primitive.js";import{useDismiss as ue}from"../utils/useDismiss.js";import{jsx as se}from"react/jsx-runtime";var E=f.forwardRef(({forceMount:n,...e},o)=>{let t=g("NavigationMenuContent"),i=p("NavigationMenuContent"),u=t.value===i.value,l=f.useRef(null),r=ie(o,l),c=f.useMemo(()=>({get current(){return typeof document>"u"?null:document.getElementById(i.triggerId)}}),[i.triggerId]);return ue({enabled:u,onPointerDownOutside:t.onClose},[l,c]),n||u?se(re.div,{role:"region",id:i.contentId,"aria-labelledby":i.triggerId,"data-state":u?"open":"closed",...e,...ae("navigation-menu","content",e.className),ref:r,onPointerEnter:C(e.onPointerEnter,t.onContentEnter),onPointerLeave:C(e.onPointerLeave,t.onContentLeave),onKeyDown:C(e.onKeyDown,s=>{s.key==="Escape"&&(t.onClose(),document.getElementById(i.triggerId)?.focus())})}):null});E.displayName="NavigationMenuContent";import*as k from"react";import{skdxPart as me}from"../utils/part.js";import{composeEventHandlers as ce,Primitive as ge}from"../utils/primitive.js";import{jsx as le}from"react/jsx-runtime";var b=k.forwardRef(({active:n,...e},o)=>{let t=g("NavigationMenuLink");return le(ge.a,{"data-skdx-nav-trigger":"","data-active":n?"":void 0,"aria-current":n?"page":void 0,...e,...me("navigation-menu","link",e.className),ref:o,onClick:ce(e.onClick,t.onClose)})});b.displayName="NavigationMenuLink";import*as D from"react";import{skdxPart as ve}from"../utils/part.js";import{Primitive as fe}from"../utils/primitive.js";import{jsx as de}from"react/jsx-runtime";var H=D.forwardRef(({forceMount:n,...e},o)=>{let i=g("NavigationMenuIndicator").value!=="";return n||i?de(fe.div,{"data-state":i?"visible":"hidden",...e,...ve("navigation-menu","indicator",e.className),ref:o}):null});H.displayName="NavigationMenuIndicator";export{U as NavigationMenu,E as NavigationMenuContent,H as NavigationMenuIndicator,x as NavigationMenuItem,b as NavigationMenuLink,y as NavigationMenuList,F as NavigationMenuRootProvider,L as NavigationMenuTrigger,g as useNavigationMenuContext};

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

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import type { NavigationMenuContentProps } from './types.cjs';
+/**
+ * Content panel revealed by a {@link NavigationMenuTrigger}: renders a
+ * `<div role="region">` labelled by the trigger's `id`, with `data-state` of
+ * `"open"` or `"closed"`, unmounted (unless `forceMount`) while closed.
+ * Pointer-enter cancels the root's close timer, pointer-leave restarts it,
+ * and Escape closes the menu and refocuses the trigger. Also dismisses on
+ * outside pointerdown / outside focus.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuContent>
+ *   <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ * </NavigationMenuContent>
+ * ```
+ */
+export declare const NavigationMenuContent: React.ForwardRefExoticComponent<Omit<NavigationMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import type { NavigationMenuContentProps } from './types.js';
+/**
+ * Content panel revealed by a {@link NavigationMenuTrigger}: renders a
+ * `<div role="region">` labelled by the trigger's `id`, with `data-state` of
+ * `"open"` or `"closed"`, unmounted (unless `forceMount`) while closed.
+ * Pointer-enter cancels the root's close timer, pointer-leave restarts it,
+ * and Escape closes the menu and refocuses the trigger. Also dismisses on
+ * outside pointerdown / outside focus.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuContent>
+ *   <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ * </NavigationMenuContent>
+ * ```
+ */
+export declare const NavigationMenuContent: React.ForwardRefExoticComponent<Omit<NavigationMenuContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { NavigationMenuIndicatorProps } from './types.cjs';
+/**
+ * Optional visual pointer (e.g. an arrow/caret) tracking whether any menu
+ * item is open: renders a `<div>` with `data-state` of `"visible"` or
+ * `"hidden"`, unmounted (unless `forceMount`) while no item is open. Sizing
+ * and positioning it under the active trigger is left to your CSS.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuList>...</NavigationMenuList>
+ * <NavigationMenuIndicator />
+ * ```
+ */
+export declare const NavigationMenuIndicator: React.ForwardRefExoticComponent<Omit<NavigationMenuIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { NavigationMenuIndicatorProps } from './types.js';
+/**
+ * Optional visual pointer (e.g. an arrow/caret) tracking whether any menu
+ * item is open: renders a `<div>` with `data-state` of `"visible"` or
+ * `"hidden"`, unmounted (unless `forceMount`) while no item is open. Sizing
+ * and positioning it under the active trigger is left to your CSS.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuList>...</NavigationMenuList>
+ * <NavigationMenuIndicator />
+ * ```
+ */
+export declare const NavigationMenuIndicator: React.ForwardRefExoticComponent<Omit<NavigationMenuIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,22 @@
+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;
+/**
+ * A single `<li>` entry in the menu: generates the `id`s that link its
+ * `NavigationMenuTrigger` and `NavigationMenuContent` together and provides
+ * `value` to them via context.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuItem value="products">
+ *   <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *   <NavigationMenuContent>...</NavigationMenuContent>
+ * </NavigationMenuItem>
+ * ```
+ */
+export declare const NavigationMenuItem: React.ForwardRefExoticComponent<Omit<NavigationMenuItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;

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

@@ -0,0 +1,22 @@
+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;
+/**
+ * A single `<li>` entry in the menu: generates the `id`s that link its
+ * `NavigationMenuTrigger` and `NavigationMenuContent` together and provides
+ * `value` to them via context.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuItem value="products">
+ *   <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *   <NavigationMenuContent>...</NavigationMenuContent>
+ * </NavigationMenuItem>
+ * ```
+ */
+export declare const NavigationMenuItem: React.ForwardRefExoticComponent<Omit<NavigationMenuItemProps, "ref"> & React.RefAttributes<HTMLLIElement>>;

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

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { NavigationMenuLinkProps } from './types.cjs';
+/**
+ * A plain navigable `<a>` usable both inside a `NavigationMenuList` item
+ * (marked `data-skdx-nav-trigger` so it joins roving focus) and inside a
+ * `NavigationMenuContent` panel. When `active`, sets `data-active` and
+ * `aria-current="page"`. Clicking it closes the open menu.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ * ```
+ */
+export declare const NavigationMenuLink: React.ForwardRefExoticComponent<Omit<NavigationMenuLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;

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

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { NavigationMenuLinkProps } from './types.js';
+/**
+ * A plain navigable `<a>` usable both inside a `NavigationMenuList` item
+ * (marked `data-skdx-nav-trigger` so it joins roving focus) and inside a
+ * `NavigationMenuContent` panel. When `active`, sets `data-active` and
+ * `aria-current="page"`. Clicking it closes the open menu.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuLink href="/products/a">Product A</NavigationMenuLink>
+ * ```
+ */
+export declare const NavigationMenuLink: React.ForwardRefExoticComponent<Omit<NavigationMenuLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NavigationMenuListProps } from './types.cjs';
+/**
+ * `<ul data-orientation="horizontal">` container for
+ * {@link NavigationMenuItem}s. Provides roving-focus arrow-key navigation
+ * (Left/Right) across items marked `data-skdx-nav-trigger`, wrapping by
+ * default.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuList>
+ *   <NavigationMenuItem value="products">
+ *     <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *     <NavigationMenuContent>...</NavigationMenuContent>
+ *   </NavigationMenuItem>
+ * </NavigationMenuList>
+ * ```
+ */
+export declare const NavigationMenuList: React.ForwardRefExoticComponent<Omit<NavigationMenuListProps, "ref"> & React.RefAttributes<HTMLUListElement>>;

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NavigationMenuListProps } from './types.js';
+/**
+ * `<ul data-orientation="horizontal">` container for
+ * {@link NavigationMenuItem}s. Provides roving-focus arrow-key navigation
+ * (Left/Right) across items marked `data-skdx-nav-trigger`, wrapping by
+ * default.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuList>
+ *   <NavigationMenuItem value="products">
+ *     <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ *     <NavigationMenuContent>...</NavigationMenuContent>
+ *   </NavigationMenuItem>
+ * </NavigationMenuList>
+ * ```
+ */
+export declare const NavigationMenuList: React.ForwardRefExoticComponent<Omit<NavigationMenuListProps, "ref"> & React.RefAttributes<HTMLUListElement>>;

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NavigationMenuTriggerProps } from './types.cjs';
+/**
+ * Button that opens its item's {@link NavigationMenuContent}: renders a
+ * `<button type="button">` marked `data-skdx-nav-trigger` (for the list's
+ * roving focus), with `aria-expanded`, `aria-controls` pointing at the
+ * content, and `data-state` of `"open"` or `"closed"`. Non-touch
+ * pointer-enter/leave start the root's open/close hover timers; click or
+ * Enter/Space opens the item, and closes it again when it was not a hover that
+ * opened it — so touch and keyboard users can dismiss it, while a mouse click
+ * following its own hover does not immediately undo itself. Escape closes and
+ * refocuses the trigger.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ * ```
+ */
+export declare const NavigationMenuTrigger: React.ForwardRefExoticComponent<Omit<NavigationMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NavigationMenuTriggerProps } from './types.js';
+/**
+ * Button that opens its item's {@link NavigationMenuContent}: renders a
+ * `<button type="button">` marked `data-skdx-nav-trigger` (for the list's
+ * roving focus), with `aria-expanded`, `aria-controls` pointing at the
+ * content, and `data-state` of `"open"` or `"closed"`. Non-touch
+ * pointer-enter/leave start the root's open/close hover timers; click or
+ * Enter/Space opens the item, and closes it again when it was not a hover that
+ * opened it — so touch and keyboard users can dismiss it, while a mouse click
+ * following its own hover does not immediately undo itself. Escape closes and
+ * refocuses the trigger.
+ *
+ * @example
+ * ```tsx
+ * <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+ * ```
+ */
+export declare const NavigationMenuTrigger: React.ForwardRefExoticComponent<Omit<NavigationMenuTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;

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

@@ -0,0 +1,8 @@
+export * from './NavigationMenu.cjs';
+export { NavigationMenuList } from './NavigationMenuList.cjs';
+export { NavigationMenuItem } from './NavigationMenuItem.cjs';
+export { NavigationMenuTrigger } from './NavigationMenuTrigger.cjs';
+export { NavigationMenuContent } from './NavigationMenuContent.cjs';
+export { NavigationMenuLink } from './NavigationMenuLink.cjs';
+export { NavigationMenuIndicator } from './NavigationMenuIndicator.cjs';
+export type { NavigationMenuProps, NavigationMenuListProps, NavigationMenuItemProps, NavigationMenuTriggerProps, NavigationMenuContentProps, NavigationMenuLinkProps, NavigationMenuIndicatorProps, } from './types.cjs';

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

@@ -0,0 +1,8 @@
+export * from './NavigationMenu.js';
+export { NavigationMenuList } from './NavigationMenuList.js';
+export { NavigationMenuItem } from './NavigationMenuItem.js';
+export { NavigationMenuTrigger } from './NavigationMenuTrigger.js';
+export { NavigationMenuContent } from './NavigationMenuContent.js';
+export { NavigationMenuLink } from './NavigationMenuLink.js';
+export { NavigationMenuIndicator } from './NavigationMenuIndicator.js';
+export type { NavigationMenuProps, NavigationMenuListProps, NavigationMenuItemProps, NavigationMenuTriggerProps, NavigationMenuContentProps, NavigationMenuLinkProps, NavigationMenuIndicatorProps, } from './types.js';

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

@@ -0,0 +1,90 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. Not part of the public API. */
+export interface NavigationMenuContextValue {
+    value: string;
+    onTriggerEnter: (itemValue: string) => void;
+    onTriggerLeave: () => void;
+    onContentEnter: () => void;
+    onContentLeave: () => void;
+    onItemSelect: (itemValue: string) => void;
+    onClose: () => void;
+}
+/** Props for the {@link NavigationMenu} root. */
+export interface NavigationMenuProps extends PrimitivePropsWithRef<'nav'> {
+    /**
+     * Value of the currently open item, for controlled usage. Pair with `onValueChange`.
+     * @default undefined — uncontrolled, tracks its own open item internally.
+     */
+    value?: string;
+    /**
+     * Initially open item's value, for uncontrolled usage.
+     * @default undefined — no item open initially.
+     */
+    defaultValue?: string;
+    /**
+     * Fires with the new value whenever the open item changes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * Delay before hovering a trigger opens its content (ms).
+     * @default 200
+     */
+    delayDuration?: number;
+    /**
+     * Window after closing during which re-hovering a sibling trigger opens instantly (ms).
+     * @default 300
+     */
+    skipDelayDuration?: number;
+}
+/** Props for {@link NavigationMenuList}, the roving-focus container for `NavigationMenuItem`s. */
+export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
+    /**
+     * Whether arrow-key navigation wraps from the last trigger back to the first
+     * (and vice versa).
+     * @default true
+     */
+    loop?: boolean;
+}
+/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. Not part of the public API. */
+export interface NavigationMenuItemContextValue {
+    value: string;
+    triggerId: string;
+    contentId: string;
+}
+/** Props for a single {@link NavigationMenuItem}. */
+export interface NavigationMenuItemProps extends PrimitivePropsWithRef<'li'> {
+    /** Unique identifier matched against the root's open `value`. */
+    value: string;
+}
+/** Props for {@link NavigationMenuTrigger}, the hoverable/clickable button that opens an item's content. */
+export interface NavigationMenuTriggerProps extends PrimitivePropsWithRef<'button'> {
+}
+/** 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.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link NavigationMenuLink}, a plain navigable item within the menu (list item or content panel). */
+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;
+}
+/** 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.
+     * @default false
+     */
+    forceMount?: boolean;
+}

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

@@ -0,0 +1,90 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. Not part of the public API. */
+export interface NavigationMenuContextValue {
+    value: string;
+    onTriggerEnter: (itemValue: string) => void;
+    onTriggerLeave: () => void;
+    onContentEnter: () => void;
+    onContentLeave: () => void;
+    onItemSelect: (itemValue: string) => void;
+    onClose: () => void;
+}
+/** Props for the {@link NavigationMenu} root. */
+export interface NavigationMenuProps extends PrimitivePropsWithRef<'nav'> {
+    /**
+     * Value of the currently open item, for controlled usage. Pair with `onValueChange`.
+     * @default undefined — uncontrolled, tracks its own open item internally.
+     */
+    value?: string;
+    /**
+     * Initially open item's value, for uncontrolled usage.
+     * @default undefined — no item open initially.
+     */
+    defaultValue?: string;
+    /**
+     * Fires with the new value whenever the open item changes, controlled or not.
+     * @default undefined — no-op if omitted.
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * Delay before hovering a trigger opens its content (ms).
+     * @default 200
+     */
+    delayDuration?: number;
+    /**
+     * Window after closing during which re-hovering a sibling trigger opens instantly (ms).
+     * @default 300
+     */
+    skipDelayDuration?: number;
+}
+/** Props for {@link NavigationMenuList}, the roving-focus container for `NavigationMenuItem`s. */
+export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {
+    /**
+     * Whether arrow-key navigation wraps from the last trigger back to the first
+     * (and vice versa).
+     * @default true
+     */
+    loop?: boolean;
+}
+/** @internal Per-item identifiers distributed from {@link NavigationMenuItem} to its descendants via context. Not part of the public API. */
+export interface NavigationMenuItemContextValue {
+    value: string;
+    triggerId: string;
+    contentId: string;
+}
+/** Props for a single {@link NavigationMenuItem}. */
+export interface NavigationMenuItemProps extends PrimitivePropsWithRef<'li'> {
+    /** Unique identifier matched against the root's open `value`. */
+    value: string;
+}
+/** Props for {@link NavigationMenuTrigger}, the hoverable/clickable button that opens an item's content. */
+export interface NavigationMenuTriggerProps extends PrimitivePropsWithRef<'button'> {
+}
+/** 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.
+     * @default false
+     */
+    forceMount?: boolean;
+}
+/** Props for {@link NavigationMenuLink}, a plain navigable item within the menu (list item or content panel). */
+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;
+}
+/** 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.
+     * @default false
+     */
+    forceMount?: boolean;
+}

package/dist/number-field/NumberField.cjs

@@ -0,0 +1 @@
+"use strict";var ue=Object.create;var I=Object.defineProperty;var de=Object.getOwnPropertyDescriptor;var se=Object.getOwnPropertyNames;var ce=Object.getPrototypeOf,fe=Object.prototype.hasOwnProperty;var pe=(t,o)=>{for(var e in o)I(t,e,{get:o[e],enumerable:!0})},Y=(t,o,e,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of se(o))!fe.call(t,r)&&r!==e&&I(t,r,{get:()=>o[r],enumerable:!(i=de(o,r))||i.enumerable});return t};var C=(t,o,e)=>(e=t!=null?ue(ce(t)):{},Y(o||!t||!t.__esModule?I(e,"default",{value:t,enumerable:!0}):e,t)),be=t=>Y(I({},"__esModule",{value:!0}),t);var Pe={};pe(Pe,{NumberField:()=>X,NumberFieldDecrement:()=>h,NumberFieldIncrement:()=>M,NumberFieldInput:()=>L,NumberFieldProvider:()=>W,useNumberFieldContext:()=>b});module.exports=be(Pe);var f=C(require("react"),1),g=require("../utils/clamp.cjs"),q=require("../utils/createContext.cjs"),E=require("../utils/formControl.cjs"),z=require("../utils/hiddenInput.cjs"),G=require("../utils/part.cjs"),J=require("../utils/primitive.cjs"),Q=require("../utils/useControllableState.cjs"),x=require("react/jsx-runtime"),[W,b]=(0,q.createSafeContext)("NumberField"),X=f.forwardRef(({value:t,defaultValue:o=0,onValueChange:e,min:i=-1/0,max:r=1/0,step:a=1,disabled:l=!1,invalid:m=!1,readOnly:p=!1,formatOptions:T,locale:n,name:d,...s},R)=>{let c=f.useRef(null),B=f.useRef(null),[F=0,H]=(0,Q.useControllableState)({prop:t,defaultProp:(0,g.clamp)(o,i,r),onChange:e}),D=f.useCallback(O=>H((0,g.clamp)(O,i,r)),[H,i,r]),ie=f.useCallback(O=>{let A=me=>{let w=String(me);if(w.includes("e")||w.includes("E"))return null;let _=w.indexOf(".");return _===-1?0:w.length-_-1},U=F+O*a,S=A(F),K=A(a),le=S===null||K===null?U:Number(U.toFixed(Math.min(Math.max(S,K),15)));D(le)},[F,a,D]);return(0,E.useFormValidityHandle)(R,c,B),(0,E.useFormReset)(c,()=>D(o)),(0,x.jsxs)(W,{value:F,min:i,max:r,step:a,disabled:l,invalid:m,readOnly:p,formatOptions:T,locale:n,setValue:D,setValueUnclamped:H,stepBy:ie,children:[(0,x.jsx)(J.Primitive.div,{"data-disabled":l?"":void 0,"data-invalid":m?"":void 0,"data-readonly":p?"":void 0,...s,...(0,G.skdxPart)("number-field","root",s.className),ref:c}),d&&(0,x.jsx)(z.HiddenInput,{ref:B,type:"text",name:d,value:String(F),disabled:l})]})});X.displayName="NumberField";var v=C(require("react"),1),Z=require("../utils/clamp.cjs"),k=require("../utils/numberFormat.cjs"),$=require("../utils/part.cjs"),P=require("../utils/primitive.cjs");var j=require("react/jsx-runtime"),L=v.forwardRef((t,o)=>{let e=b("NumberFieldInput"),{locale:i,formatOptions:r}=e,a=n=>(0,k.formatNumberValue)(n,i,r),l=n=>(0,k.parseNumberValue)(n,i,r),[m,p]=v.useState(()=>a(e.value));v.useEffect(()=>{p(n=>l(n)===e.value?n:a(e.value))},[e.value]);let T=i||r?a(e.value):void 0;return(0,j.jsx)(P.Primitive.input,{type:"text",inputMode:"numeric",role:"spinbutton","aria-valuenow":e.value,"aria-valuetext":T,"aria-valuemin":Number.isFinite(e.min)?e.min:void 0,"aria-valuemax":Number.isFinite(e.max)?e.max:void 0,disabled:e.disabled,readOnly:e.readOnly,"aria-invalid":e.invalid?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,...t,value:m,...(0,$.skdxPart)("number-field","input",t.className),ref:o,onChange:(0,P.composeEventHandlers)(t.onChange,n=>{let d=n.target.value;if(p(d),d.trim()==="")return;let s=l(d);Number.isNaN(s)||e.setValueUnclamped(s)}),onBlur:(0,P.composeEventHandlers)(t.onBlur,()=>{let n=l(m);Number.isNaN(n)?p(a(e.value)):(e.setValue(n),p(a((0,Z.clamp)(n,e.min,e.max))))}),onKeyDown:(0,P.composeEventHandlers)(t.onKeyDown,n=>{if(e.disabled||e.readOnly)return;let{min:d,max:s,setValue:R,stepBy:c}=e;n.key==="ArrowUp"?(n.preventDefault(),c(1)):n.key==="ArrowDown"?(n.preventDefault(),c(-1)):n.key==="PageUp"?(n.preventDefault(),c(10)):n.key==="PageDown"?(n.preventDefault(),c(-10)):n.key==="Home"&&Number.isFinite(d)?(n.preventDefault(),R(d)):n.key==="End"&&Number.isFinite(s)&&(n.preventDefault(),R(s))})})});L.displayName="NumberFieldInput";var u=C(require("react"),1),ee=require("../utils/part.cjs"),N=require("../utils/primitive.cjs"),te=require("../utils/useCallbackRef.cjs");var re=require("react/jsx-runtime"),Ne=400,ye=80;function V(t,o){let e=u.useRef(0),i=u.useRef(0),r=(0,te.useCallbackRef)(t),a=u.useCallback(()=>{window.clearTimeout(e.current),window.clearInterval(i.current)},[]),l=u.useCallback(()=>{o||(r(),e.current=window.setTimeout(()=>{i.current=window.setInterval(()=>r(),ye)},Ne))},[o,r]);return u.useEffect(()=>(o&&a(),a),[o,a]),{start:l,stop:a}}var M=u.forwardRef((t,o)=>{let e=b("NumberFieldIncrement"),i=e.value>=e.max,r=e.disabled||i||t.disabled||!1,a=e.readOnly&&!r,{start:l,stop:m}=V(()=>e.stepBy(1),r||a);return(0,re.jsx)(N.Primitive.button,{type:"button","aria-label":"Increment","aria-disabled":a?!0:void 0,disabled:r,"data-disabled":r?"":void 0,...t,...(0,ee.skdxPart)("number-field","increment",t.className),ref:o,onPointerDown:(0,N.composeEventHandlers)(t.onPointerDown,l),onPointerUp:(0,N.composeEventHandlers)(t.onPointerUp,m),onPointerLeave:(0,N.composeEventHandlers)(t.onPointerLeave,m),onPointerCancel:(0,N.composeEventHandlers)(t.onPointerCancel,m)})});M.displayName="NumberFieldIncrement";var ne=C(require("react"),1),oe=require("../utils/part.cjs"),y=require("../utils/primitive.cjs");var ae=require("react/jsx-runtime"),h=ne.forwardRef((t,o)=>{let e=b("NumberFieldDecrement"),i=e.value<=e.min,r=e.disabled||i||t.disabled||!1,a=e.readOnly&&!r,{start:l,stop:m}=V(()=>e.stepBy(-1),r||a);return(0,ae.jsx)(y.Primitive.button,{type:"button","aria-label":"Decrement","aria-disabled":a?!0:void 0,disabled:r,"data-disabled":r?"":void 0,...t,...(0,oe.skdxPart)("number-field","decrement",t.className),ref:o,onPointerDown:(0,y.composeEventHandlers)(t.onPointerDown,l),onPointerUp:(0,y.composeEventHandlers)(t.onPointerUp,m),onPointerLeave:(0,y.composeEventHandlers)(t.onPointerLeave,m),onPointerCancel:(0,y.composeEventHandlers)(t.onPointerCancel,m)})});h.displayName="NumberFieldDecrement";0&&(module.exports={NumberField,NumberFieldDecrement,NumberFieldIncrement,NumberFieldInput,NumberFieldProvider,useNumberFieldContext});

package/dist/number-field/NumberField.d.cts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import type { NumberFieldContextValue, NumberFieldProps } from './types.cjs';
+export declare const NumberFieldProvider: {
+    (props: NumberFieldContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useNumberFieldContext: (consumerName: string) => NumberFieldContextValue;
+/**
+ * Root of a numeric stepper input: owns the clamped value and hands it down
+ * to `NumberFieldInput` / `NumberFieldIncrement` / `NumberFieldDecrement` via
+ * context. Renders a plain `<div data-disabled data-invalid data-readonly>`
+ * — layout is entirely up to your CSS.
+ *
+ * Works controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ * Every committed value is clamped to `[min, max]`.
+ *
+ * With a `name` a visually-hidden native input submits the committed number as
+ * `String(value)` — never the formatted display text — a form reset restores
+ * `defaultValue`, and the ref carries `checkValidity()`/`reportValidity()`.
+ * The value is always clamped and can never be empty, so both always pass.
+ *
+ * @example
+ * ```tsx
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export declare const NumberField: React.ForwardRefExoticComponent<Omit<NumberFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/number-field/NumberField.d.ts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import type { NumberFieldContextValue, NumberFieldProps } from './types.js';
+export declare const NumberFieldProvider: {
+    (props: NumberFieldContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useNumberFieldContext: (consumerName: string) => NumberFieldContextValue;
+/**
+ * Root of a numeric stepper input: owns the clamped value and hands it down
+ * to `NumberFieldInput` / `NumberFieldIncrement` / `NumberFieldDecrement` via
+ * context. Renders a plain `<div data-disabled data-invalid data-readonly>`
+ * — layout is entirely up to your CSS.
+ *
+ * Works controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ * Every committed value is clamped to `[min, max]`.
+ *
+ * With a `name` a visually-hidden native input submits the committed number as
+ * `String(value)` — never the formatted display text — a form reset restores
+ * `defaultValue`, and the ref carries `checkValidity()`/`reportValidity()`.
+ * The value is always clamped and can never be empty, so both always pass.
+ *
+ * @example
+ * ```tsx
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export declare const NumberField: React.ForwardRefExoticComponent<Omit<NumberFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/number-field/NumberField.js

@@ -0,0 +1 @@
+import*as f from"react";import{clamp as V}from"../utils/clamp.js";import{createSafeContext as Y}from"../utils/createContext.js";import{useFormReset as q,useFormValidityHandle as z}from"../utils/formControl.js";import{HiddenInput as G}from"../utils/hiddenInput.js";import{skdxPart as J}from"../utils/part.js";import{Primitive as Q}from"../utils/primitive.js";import{useControllableState as W}from"../utils/useControllableState.js";import{jsx as M,jsxs as $}from"react/jsx-runtime";var[X,b]=Y("NumberField"),Z=f.forwardRef(({value:r,defaultValue:i=0,onValueChange:e,min:a=-1/0,max:n=1/0,step:o=1,disabled:l=!1,invalid:m=!1,readOnly:p=!1,formatOptions:D,locale:t,name:d,...s},P)=>{let c=f.useRef(null),k=f.useRef(null),[y=0,w]=W({prop:r,defaultProp:V(i,a,n),onChange:e}),v=f.useCallback(I=>w(V(I,a,n)),[w,a,n]),S=f.useCallback(I=>{let T=_=>{let F=String(_);if(F.includes("e")||F.includes("E"))return null;let L=F.indexOf(".");return L===-1?0:F.length-L-1},H=y+I*o,O=T(y),g=T(o),K=O===null||g===null?H:Number(H.toFixed(Math.min(Math.max(O,g),15)));v(K)},[y,o,v]);return z(P,c,k),q(c,()=>v(i)),$(X,{value:y,min:a,max:n,step:o,disabled:l,invalid:m,readOnly:p,formatOptions:D,locale:t,setValue:v,setValueUnclamped:w,stepBy:S,children:[M(Q.div,{"data-disabled":l?"":void 0,"data-invalid":m?"":void 0,"data-readonly":p?"":void 0,...s,...J("number-field","root",s.className),ref:c}),d&&M(G,{ref:k,type:"text",name:d,value:String(y),disabled:l})]})});Z.displayName="NumberField";import*as N from"react";import{clamp as j}from"../utils/clamp.js";import{formatNumberValue as ee,parseNumberValue as te}from"../utils/numberFormat.js";import{skdxPart as re}from"../utils/part.js";import{composeEventHandlers as C,Primitive as ne}from"../utils/primitive.js";import{jsx as oe}from"react/jsx-runtime";var h=N.forwardRef((r,i)=>{let e=b("NumberFieldInput"),{locale:a,formatOptions:n}=e,o=t=>ee(t,a,n),l=t=>te(t,a,n),[m,p]=N.useState(()=>o(e.value));N.useEffect(()=>{p(t=>l(t)===e.value?t:o(e.value))},[e.value]);let D=a||n?o(e.value):void 0;return oe(ne.input,{type:"text",inputMode:"numeric",role:"spinbutton","aria-valuenow":e.value,"aria-valuetext":D,"aria-valuemin":Number.isFinite(e.min)?e.min:void 0,"aria-valuemax":Number.isFinite(e.max)?e.max:void 0,disabled:e.disabled,readOnly:e.readOnly,"aria-invalid":e.invalid?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"data-invalid":e.invalid?"":void 0,"data-readonly":e.readOnly?"":void 0,...r,value:m,...re("number-field","input",r.className),ref:i,onChange:C(r.onChange,t=>{let d=t.target.value;if(p(d),d.trim()==="")return;let s=l(d);Number.isNaN(s)||e.setValueUnclamped(s)}),onBlur:C(r.onBlur,()=>{let t=l(m);Number.isNaN(t)?p(o(e.value)):(e.setValue(t),p(o(j(t,e.min,e.max))))}),onKeyDown:C(r.onKeyDown,t=>{if(e.disabled||e.readOnly)return;let{min:d,max:s,setValue:P,stepBy:c}=e;t.key==="ArrowUp"?(t.preventDefault(),c(1)):t.key==="ArrowDown"?(t.preventDefault(),c(-1)):t.key==="PageUp"?(t.preventDefault(),c(10)):t.key==="PageDown"?(t.preventDefault(),c(-10)):t.key==="Home"&&Number.isFinite(d)?(t.preventDefault(),P(d)):t.key==="End"&&Number.isFinite(s)&&(t.preventDefault(),P(s))})})});h.displayName="NumberFieldInput";import*as u from"react";import{skdxPart as ae}from"../utils/part.js";import{composeEventHandlers as x,Primitive as ie}from"../utils/primitive.js";import{useCallbackRef as le}from"../utils/useCallbackRef.js";import{jsx as de}from"react/jsx-runtime";var me=400,ue=80;function E(r,i){let e=u.useRef(0),a=u.useRef(0),n=le(r),o=u.useCallback(()=>{window.clearTimeout(e.current),window.clearInterval(a.current)},[]),l=u.useCallback(()=>{i||(n(),e.current=window.setTimeout(()=>{a.current=window.setInterval(()=>n(),ue)},me))},[i,n]);return u.useEffect(()=>(i&&o(),o),[i,o]),{start:l,stop:o}}var B=u.forwardRef((r,i)=>{let e=b("NumberFieldIncrement"),a=e.value>=e.max,n=e.disabled||a||r.disabled||!1,o=e.readOnly&&!n,{start:l,stop:m}=E(()=>e.stepBy(1),n||o);return de(ie.button,{type:"button","aria-label":"Increment","aria-disabled":o?!0:void 0,disabled:n,"data-disabled":n?"":void 0,...r,...ae("number-field","increment",r.className),ref:i,onPointerDown:x(r.onPointerDown,l),onPointerUp:x(r.onPointerUp,m),onPointerLeave:x(r.onPointerLeave,m),onPointerCancel:x(r.onPointerCancel,m)})});B.displayName="NumberFieldIncrement";import*as A from"react";import{skdxPart as se}from"../utils/part.js";import{composeEventHandlers as R,Primitive as ce}from"../utils/primitive.js";import{jsx as fe}from"react/jsx-runtime";var U=A.forwardRef((r,i)=>{let e=b("NumberFieldDecrement"),a=e.value<=e.min,n=e.disabled||a||r.disabled||!1,o=e.readOnly&&!n,{start:l,stop:m}=E(()=>e.stepBy(-1),n||o);return fe(ce.button,{type:"button","aria-label":"Decrement","aria-disabled":o?!0:void 0,disabled:n,"data-disabled":n?"":void 0,...r,...se("number-field","decrement",r.className),ref:i,onPointerDown:R(r.onPointerDown,l),onPointerUp:R(r.onPointerUp,m),onPointerLeave:R(r.onPointerLeave,m),onPointerCancel:R(r.onPointerCancel,m)})});U.displayName="NumberFieldDecrement";export{Z as NumberField,U as NumberFieldDecrement,B as NumberFieldIncrement,h as NumberFieldInput,X as NumberFieldProvider,b as useNumberFieldContext};

package/dist/number-field/NumberFieldDecrement.d.cts

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import type { NumberFieldDecrementProps } from './types.cjs';
+/**
+ * A button that lowers a {@link NumberField}'s value by one `step`. Disabled
+ * (with `data-disabled`) once the value reaches `min` or the field itself is
+ * disabled. While the field is read-only, the button stays focusable but
+ * becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding it down (pointer) repeats the decrement after an initial delay,
+ * then at a fixed interval, until released.
+ *
+ * @example
+ * ```tsx
+ * <NumberField>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ * </NumberField>
+ * ```
+ */
+export declare const NumberFieldDecrement: React.ForwardRefExoticComponent<Omit<NumberFieldDecrementProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;