@skdx/react 0.26.0 → 0.28.0

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

@@ -1,31 +1,100 @@
+import type * as React from 'react';
 import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/**
+ * One entry of {@link NavigationMenuProps.items}: a plain link, or a trigger
+ * whose panel holds a list of links. Narrow with `'items' in item`.
+ */
+export type NavigationMenuItem = {
+    /** Text rendered inside the derived `NavigationMenuLink`. */
+    label: string;
+    /** Destination of the derived `NavigationMenuLink`. */
+    href: string;
+    /**
+     * Marks the link as the current page — `aria-current="page"` and `data-active`.
+     * @default false
+     */
+    active?: boolean;
+    /**
+     * Identifier matched against the root's open `value`.
+     * @default undefined — the entry's index in `items`, as a string.
+     */
+    value?: string;
+} | {
+    /** Text rendered inside the derived `NavigationMenuTrigger`. */
+    label: string;
+    /**
+     * Identifier matched against the root's open `value`.
+     * @default undefined — the entry's index in `items`, as a string.
+     */
+    value?: string;
+    /** The links the derived panel holds. */
+    items: {
+        /** Text rendered inside the derived `NavigationMenuLink`. */
+        label: string;
+        /** Destination of the derived `NavigationMenuLink`. */
+        href: string;
+        /**
+         * Marks the link as the current page — `aria-current="page"` and `data-active`.
+         * @default false
+         */
+        active?: boolean;
+    }[];
+};
 /** @internal Shared state distributed from {@link NavigationMenu} to its parts via context. Not part of the public API. */
 export interface NavigationMenuContextValue {
-    value: string;
+    /** Value of the open item, or `null` when nothing is open. */
+    value: string | null;
+    /** Axis the list lays out and arrow-keys travel along. Set on the root. */
+    orientation: 'horizontal' | 'vertical';
     onTriggerEnter: (itemValue: string) => void;
     onTriggerLeave: () => void;
     onContentEnter: () => void;
     onContentLeave: () => void;
     onItemSelect: (itemValue: string) => void;
     onClose: () => void;
+    /** What a Link's click does — closes the menu, or nothing when `closeOnSelect` is false. */
+    onLinkSelect: () => void;
 }
-/** Props for the {@link NavigationMenu} root. */
-export interface NavigationMenuProps extends PrimitivePropsWithRef<'nav'> {
+/**
+ * Props for the {@link NavigationMenu} root. `defaultValue` redeclared to accept
+ * `null` (closed sentinel), which `HTMLAttributes` does not support.
+ */
+export interface NavigationMenuProps extends Omit<PrimitivePropsWithRef<'nav'>, 'defaultValue'> {
     /**
-     * Value of the currently open item, for controlled usage. Pair with `onValueChange`.
+     * 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[];
+    /**
+     * 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;
+    /**
+     * 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';
+    /**
+     * 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;
+    value?: string | null;
     /**
-     * Initially open item's value, for uncontrolled usage.
-     * @default undefined — no item open initially.
+     * Initially open item's value, for uncontrolled usage. `null` starts closed.
+     * @default null — no item open initially.
      */
-    defaultValue?: string;
+    defaultValue?: string | null;
     /**
-     * Fires with the new value whenever the open item changes, controlled or not.
+     * 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) => void;
+    onValueChange?: (value: string | null) => void;
     /**
      * Delay before hovering a trigger opens its content (ms).
      * @default 200
@@ -36,6 +105,18 @@ export interface NavigationMenuProps extends PrimitivePropsWithRef<'nav'> {
      * @default 300
      */
     skipDelayDuration?: number;
+    /**
+     * 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;
+    /**
+     * 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;
 }
 /** Props for {@link NavigationMenuList}, the roving-focus container for `NavigationMenuItem`s. */
 export interface NavigationMenuListProps extends PrimitivePropsWithRef<'ul'> {

package/dist/number-field/NumberField.cjs

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

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

@@ -7,26 +7,15 @@ export declare const NumberFieldProvider: {
     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.
+ * Root numeric stepper: owns the clamped value and hands it to child controls
+ * via context. Controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ * `onValueChange` fires per keystroke; `onValueCommit` once settled (blur, Enter, step).
+ * With `name`, renders a hidden native input for form submission.
+ * Without `children`, derives anatomy with input and increment / decrement buttons.
  *
  * @example
  * ```tsx
- * <NumberField defaultValue={1} min={0} max={10}>
- *   <NumberFieldDecrement>-</NumberFieldDecrement>
- *   <NumberFieldInput />
- *   <NumberFieldIncrement>+</NumberFieldIncrement>
- * </NumberField>
+ * <NumberField defaultValue={1} min={0} max={10} />
  * ```
  */
 export declare const NumberField: React.ForwardRefExoticComponent<Omit<NumberFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -7,26 +7,15 @@ export declare const NumberFieldProvider: {
     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.
+ * Root numeric stepper: owns the clamped value and hands it to child controls
+ * via context. Controlled (`value` + `onValueChange`) or uncontrolled (`defaultValue`).
+ * `onValueChange` fires per keystroke; `onValueCommit` once settled (blur, Enter, step).
+ * With `name`, renders a hidden native input for form submission.
+ * Without `children`, derives anatomy with input and increment / decrement buttons.
  *
  * @example
  * ```tsx
- * <NumberField defaultValue={1} min={0} max={10}>
- *   <NumberFieldDecrement>-</NumberFieldDecrement>
- *   <NumberFieldInput />
- *   <NumberFieldIncrement>+</NumberFieldIncrement>
- * </NumberField>
+ * <NumberField defaultValue={1} min={0} max={10} />
  * ```
  */
 export declare const NumberField: React.ForwardRefExoticComponent<Omit<NumberFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/number-field/NumberField.js

@@ -1 +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};
+import*as s from"react";import{clamp as Y}from"../utils/clamp.js";import{createSafeContext as Ie}from"../utils/createContext.js";import{useFormReset as he,useFormValidityHandle as ke}from"../utils/formControl.js";import{HiddenInput as ge}from"../utils/hiddenInput.js";import{skdxPart as Ee}from"../utils/part.js";import{Primitive as Le}from"../utils/primitive.js";import{useCallbackRef as Te}from"../utils/useCallbackRef.js";import{useControllableState as Ve}from"../utils/useControllableState.js";import*as te from"react";import{skdxPart as pe}from"../utils/part.js";import{composeEventHandlers as V,Primitive as Ne}from"../utils/primitive.js";import*as f from"react";import{skdxPart as me}from"../utils/part.js";import{composeEventHandlers as T,Primitive as se}from"../utils/primitive.js";import{useCallbackRef as de}from"../utils/useCallbackRef.js";import{jsx as be}from"react/jsx-runtime";var ce=400,fe=80;function U(i,n){let e=f.useRef(0),o=f.useRef(0),l=de(i),r=f.useCallback(()=>{window.clearTimeout(e.current),window.clearInterval(o.current)},[]),a=f.useCallback(()=>{n||(l(),e.current=window.setTimeout(()=>{o.current=window.setInterval(()=>l(),fe)},ce))},[n,l]);return f.useEffect(()=>(n&&r(),r),[n,r]),{start:a,stop:r}}var S=f.forwardRef(({label:i="Increment",...n},e)=>{let o=F("NumberFieldIncrement"),l=o.value!==null&&o.value>=o.max,r=o.disabled||n.disabled||!1,a=!r&&(l||o.readOnly),{start:d,stop:u}=U(()=>o.stepBy(1),r||a);return be(se.button,{type:"button","aria-label":i,"aria-disabled":a?!0:void 0,disabled:r,"data-disabled":r||a?"":void 0,...n,...me("number-field","increment",n.className),ref:e,onPointerDown:T(n.onPointerDown,d),onPointerUp:T(n.onPointerUp,u),onPointerLeave:T(n.onPointerLeave,u),onPointerCancel:T(n.onPointerCancel,u)})});S.displayName="NumberFieldIncrement";import{jsx as ye}from"react/jsx-runtime";var W=te.forwardRef(({label:i="Decrement",...n},e)=>{let o=F("NumberFieldDecrement"),l=o.value!==null&&o.value<=o.min,r=o.disabled||n.disabled||!1,a=!r&&(l||o.readOnly),{start:d,stop:u}=U(()=>o.stepBy(-1),r||a);return ye(Ne.button,{type:"button","aria-label":i,"aria-disabled":a?!0:void 0,disabled:r,"data-disabled":r||a?"":void 0,...n,...pe("number-field","decrement",n.className),ref:e,onPointerDown:V(n.onPointerDown,d),onPointerUp:V(n.onPointerUp,u),onPointerLeave:V(n.onPointerLeave,u),onPointerCancel:V(n.onPointerCancel,u)})});W.displayName="NumberFieldDecrement";import*as v from"react";import{clamp as ve}from"../utils/clamp.js";import{formatNumberValue as Re,parseNumberValue as Fe}from"../utils/numberFormat.js";import{skdxPart as Pe}from"../utils/part.js";import{composeEventHandlers as B,Primitive as xe}from"../utils/primitive.js";import{useCallbackRef as ne}from"../utils/useCallbackRef.js";import{jsx as we}from"react/jsx-runtime";var q=v.forwardRef((i,n)=>{let e=F("NumberFieldInput"),{locale:o,formatOptions:l}=e,r=ne(t=>t===null?"":Re(t,o,l)),a=t=>Fe(t,o,l),[d,u]=v.useState(()=>r(e.value)),p=v.useRef(!1),P=t=>e.clampBehavior==="never"?t:ve(t,e.min,e.max),x=ne((t,m)=>{let c=a(t);return Number.isNaN(c)?m===null:P(c)===m});v.useEffect(()=>{u(t=>x(t,e.value)?t:r(e.value))},[e.value,x,r]);let w=(o||l)&&e.value!==null?r(e.value):void 0,C=()=>{if(!p.current)return;if(p.current=!1,d.trim()===""){e.commitValue(null),u("");return}let t=a(d);Number.isNaN(t)?(e.commitValue(e.value),u(r(e.value))):(e.commitValue(t),u(r(P(t))))},h=e.invalid||e.outOfRange;return we(xe.input,{type:"text",inputMode:"numeric",role:"spinbutton","aria-valuenow":e.value??void 0,"aria-valuetext":w,"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":h?!0:void 0,"aria-readonly":e.readOnly?!0:void 0,"aria-required":e.required?!0:void 0,"data-invalid":h?"":void 0,"data-readonly":e.readOnly?"":void 0,...i,value:d,...Pe("number-field","input",i.className),ref:n,onChange:B(i.onChange,t=>{let m=t.target.value;if(u(m),p.current=!0,m.trim()===""){e.setValue(null);return}let c=a(m);Number.isNaN(c)||e.setValue(c)}),onBlur:B(i.onBlur,C),onWheel:B(i.onWheel,t=>{!e.allowWheel||e.readOnly||t.currentTarget.ownerDocument.activeElement===t.currentTarget&&(t.preventDefault(),p.current=!1,e.stepBy(t.deltaY<0?1:-1))}),onKeyDown:B(i.onKeyDown,t=>{if(e.disabled||e.readOnly)return;let{min:m,max:c,commitValue:k,stepBy:R}=e;if(t.key==="Enter"){C();return}let N=O=>{t.preventDefault(),p.current=!1,O()},D=t.shiftKey?10:1;t.key==="ArrowUp"?N(()=>R(D)):t.key==="ArrowDown"?N(()=>R(-D)):t.key==="PageUp"?N(()=>R(10)):t.key==="PageDown"?N(()=>R(-10)):t.key==="Home"&&Number.isFinite(m)?N(()=>k(m)):t.key==="End"&&Number.isFinite(c)&&N(()=>k(c))})})});q.displayName="NumberFieldInput";import{Fragment as Ce,jsx as K,jsxs as De}from"react/jsx-runtime";var re=({showControls:i,incrementLabel:n,decrementLabel:e})=>De(Ce,{children:[i?K(W,{label:e}):null,K(q,{}),i?K(S,{label:n}):null]});import{jsx as _,jsxs as Oe}from"react/jsx-runtime";var[Be,F]=Ie("NumberField"),oe=s.forwardRef(({value:i,defaultValue:n=null,onValueChange:e,onValueCommit:o,min:l=-1/0,max:r=1/0,step:a=1,disabled:d=!1,invalid:u=!1,readOnly:p=!1,required:P=!1,formatOptions:x,locale:w,clampBehavior:C="blur",allowWheel:h=!1,form:t,name:m,showControls:c=!0,incrementLabel:k="Increment",decrementLabel:R="Decrement",children:N,...D},O)=>{let z=!!(w||x),le=s.useMemo(()=>z?new Intl.NumberFormat(w).resolvedOptions().locale:void 0,[z,w]),H=C==="blur",g=s.useCallback(b=>b===null||!H?b:Y(b,l,r),[H,l,r]),M=s.useRef(null),G=s.useRef(null),[y=null,E]=Ve({prop:i,defaultProp:n===null||!H?n:Y(n,l,r),onChange:e}),J=Te(o??(()=>{})),Q=s.useCallback(b=>E(g(b)),[E,g]),A=s.useCallback(b=>{let I=g(b);E(I),J(I)},[E,g,J]),ae=s.useCallback(b=>{let I=y??0,X=ue=>{let L=String(ue);if(L.includes("e")||L.includes("E"))return null;let ee=L.indexOf(".");return ee===-1?0:L.length-ee-1},Z=I+b*a,$=X(I),j=X(a),ie=$===null||j===null?Z:Number(Z.toFixed(Math.min(Math.max($,j),15)));A(Y(ie,l,r))},[y,a,A,l,r]);return ke(O,M,G),he(M,()=>Q(n),t),Oe(Be,{value:y,min:l,max:r,step:a,disabled:d,invalid:u,readOnly:p,required:P,formatOptions:x,locale:le,clampBehavior:C,allowWheel:h,outOfRange:y!==null&&(y<l||y>r),setValue:Q,commitValue:A,stepBy:ae,children:[_(Le.div,{"data-disabled":d?"":void 0,"data-invalid":u?"":void 0,"data-readonly":p?"":void 0,...D,...Ee("number-field","root",D.className),ref:M,children:N??_(re,{showControls:c,incrementLabel:k,decrementLabel:R})}),m&&_(ge,{ref:G,type:"text",name:m,value:y===null?"":String(y),required:P,disabled:d,form:t})]})});oe.displayName="NumberField";export{oe as NumberField,W as NumberFieldDecrement,S as NumberFieldIncrement,q as NumberFieldInput,Be as NumberFieldProvider,F as useNumberFieldContext,U as useRepeatingPress};

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

@@ -0,0 +1,12 @@
+/**
+ * The anatomy a {@link NumberField} draws when given no children: a derived
+ * `NumberFieldDecrement`, the `NumberFieldInput`, then a derived `NumberFieldIncrement` — both step buttons
+ * omitted when `showControls` is false.
+ *
+ * @internal
+ */
+export declare const NumberFieldAnatomy: ({ showControls, incrementLabel, decrementLabel, }: {
+    showControls: boolean;
+    incrementLabel?: string;
+    decrementLabel?: string;
+}) => import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+/**
+ * The anatomy a {@link NumberField} draws when given no children: a derived
+ * `NumberFieldDecrement`, the `NumberFieldInput`, then a derived `NumberFieldIncrement` — both step buttons
+ * omitted when `showControls` is false.
+ *
+ * @internal
+ */
+export declare const NumberFieldAnatomy: ({ showControls, incrementLabel, decrementLabel, }: {
+    showControls: boolean;
+    incrementLabel?: string;
+    decrementLabel?: string;
+}) => import("react").JSX.Element;

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

@@ -8,6 +8,10 @@ import type { NumberFieldDecrementProps } from './types.cjs';
  * Holding it down (pointer) repeats the decrement after an initial delay,
  * then at a fixed interval, until released.
  *
+ * Its projected content is usually a bare `-`, which announces as nothing
+ * useful, so the button carries an accessible name of its own — `label`, which
+ * is what makes that name translatable rather than a hardcoded English literal.
+ *
  * @example
  * ```tsx
  * <NumberField>

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

@@ -8,6 +8,10 @@ import type { NumberFieldDecrementProps } from './types.js';
  * Holding it down (pointer) repeats the decrement after an initial delay,
  * then at a fixed interval, until released.
  *
+ * Its projected content is usually a bare `-`, which announces as nothing
+ * useful, so the button carries an accessible name of its own — `label`, which
+ * is what makes that name translatable rather than a hardcoded English literal.
+ *
  * @example
  * ```tsx
  * <NumberField>

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

@@ -2,20 +2,21 @@ import * as React from 'react';
 import type { NumberFieldIncrementProps } from './types.cjs';
 /**
  * @internal Runs `onPress` once on press, then repeatedly while held — after a
- * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until
- * `stop` is called. No-op while `disabled`. Returns `{ start, stop }` handlers.
+ * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until `stop` is called.
+ * No-op while `disabled`. Returns `{ start, stop }` handlers.
  */
 export declare function useRepeatingPress(onPress: () => void, disabled: boolean): {
     start: () => void;
     stop: () => void;
 };
 /**
- * A button that raises a {@link NumberField}'s value by one `step`. Disabled
- * (with `data-disabled`) once the value reaches `max` 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 increment after an initial delay,
- * then at a fixed interval, until released.
+ * A button that raises a {@link NumberField}'s value by one `step`. Disabled (with `data-disabled`)
+ * once value reaches `max` or field itself is disabled. While field is read-only, button stays
+ * focusable but becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding down (pointer) repeats increment after initial delay, then at fixed interval.
+ *
+ * Projected content usually bare `+`, announces as nothing useful, so button carries its own
+ * accessible name — `label` — making it translatable rather than hardcoded English.
  *
  * @example
  * ```tsx

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

@@ -2,20 +2,21 @@ import * as React from 'react';
 import type { NumberFieldIncrementProps } from './types.js';
 /**
  * @internal Runs `onPress` once on press, then repeatedly while held — after a
- * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until
- * `stop` is called. No-op while `disabled`. Returns `{ start, stop }` handlers.
+ * {@link REPEAT_DELAY} ms delay, at a {@link REPEAT_INTERVAL} ms cadence — until `stop` is called.
+ * No-op while `disabled`. Returns `{ start, stop }` handlers.
  */
 export declare function useRepeatingPress(onPress: () => void, disabled: boolean): {
     start: () => void;
     stop: () => void;
 };
 /**
- * A button that raises a {@link NumberField}'s value by one `step`. Disabled
- * (with `data-disabled`) once the value reaches `max` 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 increment after an initial delay,
- * then at a fixed interval, until released.
+ * A button that raises a {@link NumberField}'s value by one `step`. Disabled (with `data-disabled`)
+ * once value reaches `max` or field itself is disabled. While field is read-only, button stays
+ * focusable but becomes inert (`aria-disabled`, no-op press) rather than natively disabled.
+ * Holding down (pointer) repeats increment after initial delay, then at fixed interval.
+ *
+ * Projected content usually bare `+`, announces as nothing useful, so button carries its own
+ * accessible name — `label` — making it translatable rather than hardcoded English.
  *
  * @example
  * ```tsx

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

@@ -1,19 +1,9 @@
 import * as React from 'react';
 import type { NumberFieldInputProps } from './types.cjs';
 /**
- * The text input for a {@link NumberField}. Renders `role="spinbutton"` with
- * `aria-valuenow`/`aria-valuemin`/`aria-valuemax` from context, plus
- * `aria-invalid`/`data-invalid` and the native `readOnly` attribute with
- * `aria-readonly`/`data-readonly` from context. Typed text is tracked
- * unclamped so multi-digit entry isn't fought mid-keystroke, and is
- * clamped/committed on blur (reverting to the last committed value if left
- * empty or non-numeric). Arrow Up/Down change the value by one `step`, and
- * Page Up/Down by ten `step`s.
- *
- * With the root's `formatOptions`/`locale`, the committed value is displayed
- * through `Intl.NumberFormat` and announced on `aria-valuetext`, while typed
- * or pasted text is parsed back through the same options — so a currency
- * symbol, a group separator or a `%` never reads as garbage.
+ * Text input for a {@link NumberField}, renders `role="spinbutton"`.
+ * Displayed text unclamped (multi-digit entry safe mid-keystroke); published value clamped.
+ * Non-numeric text reverts on blur. Arrows step by `step`; Page Up / Down by ten.
  *
  * @example
  * ```tsx

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

@@ -1,19 +1,9 @@
 import * as React from 'react';
 import type { NumberFieldInputProps } from './types.js';
 /**
- * The text input for a {@link NumberField}. Renders `role="spinbutton"` with
- * `aria-valuenow`/`aria-valuemin`/`aria-valuemax` from context, plus
- * `aria-invalid`/`data-invalid` and the native `readOnly` attribute with
- * `aria-readonly`/`data-readonly` from context. Typed text is tracked
- * unclamped so multi-digit entry isn't fought mid-keystroke, and is
- * clamped/committed on blur (reverting to the last committed value if left
- * empty or non-numeric). Arrow Up/Down change the value by one `step`, and
- * Page Up/Down by ten `step`s.
- *
- * With the root's `formatOptions`/`locale`, the committed value is displayed
- * through `Intl.NumberFormat` and announced on `aria-valuetext`, while typed
- * or pasted text is parsed back through the same options — so a currency
- * symbol, a group separator or a `%` never reads as garbage.
+ * Text input for a {@link NumberField}, renders `role="spinbutton"`.
+ * Displayed text unclamped (multi-digit entry safe mid-keystroke); published value clamped.
+ * Non-numeric text reverts on blur. Arrows step by `step`; Page Up / Down by ten.
  *
  * @example
  * ```tsx

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

@@ -1,5 +1,2 @@
-export * from './NumberField.cjs';
-export { NumberFieldInput } from './NumberFieldInput.cjs';
-export { NumberFieldIncrement } from './NumberFieldIncrement.cjs';
-export { NumberFieldDecrement } from './NumberFieldDecrement.cjs';
-export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.cjs';
+export { NumberField } from './NumberField.cjs';
+export type { NumberFieldProps, NumberFieldHandle } from './types.cjs';

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

@@ -1,5 +1,2 @@
-export * from './NumberField.js';
-export { NumberFieldInput } from './NumberFieldInput.js';
-export { NumberFieldIncrement } from './NumberFieldIncrement.js';
-export { NumberFieldDecrement } from './NumberFieldDecrement.js';
-export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.js';
+export { NumberField } from './NumberField.js';
+export type { NumberFieldProps, NumberFieldHandle } from './types.js';

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

@@ -0,0 +1,20 @@
+/**
+ * Advanced primitives for `NumberField` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { NumberField, NumberFieldDecrement, NumberFieldIncrement, NumberFieldInput } from '@skdx/react/primitives/number-field';
+ *
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export { NumberField } from './NumberField.cjs';
+export { NumberFieldInput } from './NumberFieldInput.cjs';
+export { NumberFieldIncrement } from './NumberFieldIncrement.cjs';
+export { NumberFieldDecrement } from './NumberFieldDecrement.cjs';
+export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.cjs';

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

@@ -0,0 +1,20 @@
+/**
+ * Advanced primitives for `NumberField` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { NumberField, NumberFieldDecrement, NumberFieldIncrement, NumberFieldInput } from '@skdx/react/primitives/number-field';
+ *
+ * <NumberField defaultValue={1} min={0} max={10}>
+ *   <NumberFieldDecrement>-</NumberFieldDecrement>
+ *   <NumberFieldInput />
+ *   <NumberFieldIncrement>+</NumberFieldIncrement>
+ * </NumberField>
+ * ```
+ */
+export { NumberField } from './NumberField.js';
+export { NumberFieldInput } from './NumberFieldInput.js';
+export { NumberFieldIncrement } from './NumberFieldIncrement.js';
+export { NumberFieldDecrement } from './NumberFieldDecrement.js';
+export type { NumberFieldProps, NumberFieldHandle, NumberFieldInputProps, NumberFieldIncrementProps, NumberFieldDecrementProps, } from './types.js';