@skdx/react 0.27.0 → 0.29.0

package/dist/utils/mentions.d.ts

@@ -0,0 +1,116 @@
+/** The trigger character a Mentions field uses when it configures none. */
+export declare const DEFAULT_MENTION_TRIGGER = "@";
+/** The mention being typed: its trigger character, the text after it, and the range the pair occupies. */
+export interface MentionToken {
+    /** The trigger character that opened the token. */
+    trigger: string;
+    /** Text between the trigger character and the caret — what the item list is filtered by. */
+    query: string;
+    /** Offset of the trigger character in the field value. */
+    start: number;
+    /** Offset just past the query; always the caret offset the token was found at. */
+    end: number;
+}
+/** Where a trigger character is allowed to open a token, and what abandons one. */
+export interface MentionTokenOptions {
+    /**
+     * Trigger characters, either as an array or as one string read a character at a time.
+     * @defaultValue `'@'`
+     */
+    triggers?: string | readonly string[] | undefined;
+    /**
+     * How many spaces a query may contain before the token is abandoned.
+     * @defaultValue 0
+     */
+    allowedSpaces?: number | undefined;
+    /**
+     * Whether a trigger opens a token only at the start of the value or after a non-word character, so `user@example` is left alone.
+     * @defaultValue true
+     */
+    requireWordBoundary?: boolean | undefined;
+}
+/**
+ * The mention token the caret sits in, found by scanning backwards from the
+ * caret to the nearest trigger character.
+ *
+ * Returns `null` for every condition that ends a mention: no trigger before
+ * the caret, a line break between them, more spaces than `allowedSpaces`, a
+ * trigger that fails the word-boundary rule, or a caret that has moved out of
+ * the token. There is no token to cancel — call this again after every value,
+ * caret or selection change and the answer is the whole state.
+ *
+ * @param value the field's full text
+ * @param caret the caret offset, clamped into the value
+ * @param options the trigger and boundary rules
+ */
+export declare function findMentionToken(value: string, caret: number, options?: MentionTokenOptions): MentionToken | null;
+/**
+ * Whether an Escape recorded at `dismissedAt` still suppresses this token.
+ *
+ * Escape closes the popup while the token is still syntactically alive, so the
+ * offset of the dismissed trigger is held until {@link findMentionToken}
+ * returns `null` — which is the adapter's cue to forget it.
+ *
+ * @param token the token found for the current caret, or `null`
+ * @param dismissedAt the `start` of the token Escape closed, or `null`
+ */
+export declare function isMentionDismissed(token: MentionToken | null, dismissedAt: number | null): boolean;
+/** The field value and caret offset an insertion produces. */
+export interface MentionInsertion {
+    /** The whole field value with the token's range replaced. */
+    value: string;
+    /** Caret offset just past the inserted text, and past the appended space when one was added. */
+    caret: number;
+}
+/**
+ * Replaces a token's range with the serialized mention text.
+ *
+ * @param value the field value the token was found in
+ * @param token the token being replaced, from {@link findMentionToken}
+ * @param text the full replacement including the trigger character
+ * @param appendSpace whether a single space follows the mention, skipped when the value already continues with whitespace
+ */
+export declare function insertMention(value: string, token: MentionToken, text: string, appendSpace?: boolean): MentionInsertion;
+/** The caret's position in viewport coordinates, as an adapter measured it. */
+export interface CaretRect {
+    /** Distance in pixels from the viewport's top edge to the caret's top. */
+    top: number;
+    /** Distance in pixels from the viewport's left edge to the caret. */
+    left: number;
+    /** The caret's height in pixels, normally the field's computed line height. */
+    height: number;
+}
+/** The rectangle floating-ui reads off a positioning reference. */
+export interface AnchorRect {
+    x: number;
+    y: number;
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+    width: number;
+    height: number;
+}
+/** A positioning reference that is a rectangle rather than an element. */
+export interface VirtualAnchor {
+    getBoundingClientRect(): AnchorRect;
+    /** The element the rect lives inside, so floating-ui can observe ancestor scroll and resize. */
+    contextElement: Element;
+}
+/**
+ * Wraps a caret measurement as the zero-width virtual anchor the popup is
+ * positioned against.
+ *
+ * The measurement is re-read on every call, so one anchor survives a moved
+ * caret without being rebuilt, and `contextElement` is what lets floating-ui
+ * observe the ancestor scroll and resize that make it re-read.
+ *
+ * @param measure re-reads the caret rectangle, normally closing over a {@link MeasureCaretRect}, its field and the offset
+ * @param contextElement the field the caret sits in
+ */
+export declare function caretAnchor(measure: () => CaretRect, contextElement: Element): VirtualAnchor;
+/**
+ * The caret measurement each adapter implements with its own DOM work: the
+ * viewport rectangle of the caret at `offset` inside `field`.
+ */
+export type MeasureCaretRect = (field: HTMLTextAreaElement | HTMLInputElement, offset: number) => CaretRect;

package/dist/utils/mentions.js

@@ -0,0 +1,3 @@
+'use client';
+var d="@",f=/[\p{L}\p{N}_]/u;function g(e){return e===void 0?["@"]:typeof e=="string"?[...e]:e}function m(e,n,o={}){let{allowedSpaces:t=0,requireWordBoundary:u=!0}=o,s=g(o.triggers),c=Math.max(0,Math.min(n,e.length)),a=0;for(let r=c-1;r>=0;r--){let i=e[r];if(i===`
+`||i==="\r")return null;if(s.includes(i)){let l=r>0?e[r-1]:"";return u&&l!==""&&f.test(l)?null:{trigger:i,query:e.slice(r+1,c),start:r,end:c}}if(/\s/.test(i)&&++a>t)return null}return null}function p(e,n){return e!==null&&e.start===n}function h(e,n,o,t=!0){let u=e.slice(n.end),s=t&&!/^\s/.test(u)?" ":"";return{value:e.slice(0,n.start)+o+s+u,caret:n.start+o.length+s.length}}function b(e,n){return{getBoundingClientRect:()=>{let t=e();return{x:t.left,y:t.top,top:t.top,left:t.left,bottom:t.top+t.height,right:t.left,width:0,height:t.height}},contextElement:n}}export{d as DEFAULT_MENTION_TRIGGER,b as caretAnchor,m as findMentionToken,h as insertMention,p as isMentionDismissed};

package/dist/utils/menuGroup.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var c=Object.create;var r=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,i=Object.prototype.hasOwnProperty;var p=(e,t)=>{for(var n in t)r(e,n,{get:t[n],enumerable:!0})},s=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of b(t))!i.call(e,a)&&a!==n&&r(e,a,{get:()=>t[a],enumerable:!(o=d(t,a))||o.enumerable});return e};var x=(e,t,n)=>(n=e!=null?c(f(e)):{},s(t||!e||!e.__esModule?r(n,"default",{value:e,enumerable:!0}):n,e)),M=e=>s(r({},"__esModule",{value:!0}),e);var m={};p(m,{MenuGroupProvider:()=>L,useMenuGroupLabel:()=>C,useMenuLabelId:()=>R});module.exports=M(m);var u=x(require("react"),1),l=require("./createContext.cjs"),G={labelId:"",setHasLabel:()=>{}},[L,I]=(0,l.createSafeContext)("MenuGroup",G);function C(){let e=u.useId(),[t,n]=u.useState(!1),o=u.useMemo(()=>({labelId:e,setHasLabel:n}),[e]);return{labelId:t?e:void 0,context:o}}function R(){let{labelId:e,setHasLabel:t}=I("MenuLabel");return u.useEffect(()=>{if(e)return t(!0),()=>t(!1)},[e,t]),e||void 0}0&&(module.exports={MenuGroupProvider,useMenuGroupLabel,useMenuLabelId});

package/dist/utils/menuGroup.d.cts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+/**
+ * Naming for `role="group"` containers in menu families (Group, RadioGroup).
+ * `role="group"` needs `aria-labelledby` pointing at the Label; registration ensures the id exists.
+ */
+/** @internal What a `role="group"` hands to the Label inside it. */
+export interface MenuGroupContextValue {
+    /** Id the Label takes, and the group points `aria-labelledby` at. */
+    labelId: string;
+    /** Called by the Label on mount/unmount, so the group knows whether the id resolves. */
+    setHasLabel: (hasLabel: boolean) => void;
+}
+declare const MenuGroupProvider: React.FC<MenuGroupContextValue & {
+    children: React.ReactNode;
+}>;
+export { MenuGroupProvider };
+/**
+ * @internal State a `Group`/`RadioGroup` needs to be named by its Label:
+ * `labelId` is the value for `aria-labelledby`, and is `undefined` until a
+ * Label is actually mounted; `context` goes straight into a
+ * {@link MenuGroupProvider}.
+ */
+export declare function useMenuGroupLabel(): {
+    labelId: string | undefined;
+    context: MenuGroupContextValue;
+};
+/**
+ * @internal The id a `Label` must render, so the group around it can name
+ * itself after it — `undefined` when the Label is not inside one.
+ */
+export declare function useMenuLabelId(): string | undefined;

package/dist/utils/menuGroup.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+/**
+ * Naming for `role="group"` containers in menu families (Group, RadioGroup).
+ * `role="group"` needs `aria-labelledby` pointing at the Label; registration ensures the id exists.
+ */
+/** @internal What a `role="group"` hands to the Label inside it. */
+export interface MenuGroupContextValue {
+    /** Id the Label takes, and the group points `aria-labelledby` at. */
+    labelId: string;
+    /** Called by the Label on mount/unmount, so the group knows whether the id resolves. */
+    setHasLabel: (hasLabel: boolean) => void;
+}
+declare const MenuGroupProvider: React.FC<MenuGroupContextValue & {
+    children: React.ReactNode;
+}>;
+export { MenuGroupProvider };
+/**
+ * @internal State a `Group`/`RadioGroup` needs to be named by its Label:
+ * `labelId` is the value for `aria-labelledby`, and is `undefined` until a
+ * Label is actually mounted; `context` goes straight into a
+ * {@link MenuGroupProvider}.
+ */
+export declare function useMenuGroupLabel(): {
+    labelId: string | undefined;
+    context: MenuGroupContextValue;
+};
+/**
+ * @internal The id a `Label` must render, so the group around it can name
+ * itself after it — `undefined` when the Label is not inside one.
+ */
+export declare function useMenuLabelId(): string | undefined;

package/dist/utils/menuGroup.js

@@ -0,0 +1,2 @@
+'use client';
+import*as e from"react";import{createSafeContext as o}from"./createContext.js";var r={labelId:"",setHasLabel:()=>{}},[c,s]=o("MenuGroup",r);function d(){let t=e.useId(),[n,u]=e.useState(!1),a=e.useMemo(()=>({labelId:t,setHasLabel:u}),[t]);return{labelId:n?t:void 0,context:a}}function b(){let{labelId:t,setHasLabel:n}=s("MenuLabel");return e.useEffect(()=>{if(t)return n(!0),()=>n(!1)},[t,n]),t||void 0}export{c as MenuGroupProvider,d as useMenuGroupLabel,b as useMenuLabelId};

package/dist/utils/menuSub.cjs

@@ -1 +1,2 @@
-"use strict";var I=Object.create;var P=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var K=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty;var F=(e,o)=>{for(var a in o)P(e,a,{get:o[a],enumerable:!0})},T=(e,o,a,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let i of A(o))!_.call(e,i)&&i!==a&&P(e,i,{get:()=>o[i],enumerable:!(t=O(o,i))||t.enumerable});return e};var q=(e,o,a)=>(a=e!=null?I(K(e)):{},T(o||!e||!e.__esModule?P(a,"default",{value:e,enumerable:!0}):a,e)),B=e=>T(P({},"__esModule",{value:!0}),e);var W={};F(W,{MENU_BRANCH_ATTRIBUTE:()=>x,MenuSub:()=>L,MenuSubContent:()=>k,MenuSubTrigger:()=>D});module.exports=B(W);var r=q(require("react"),1),C=require("./composeRefs.cjs"),S=require("./createContext.cjs"),d=require("./direction.cjs"),M=require("./part.cjs"),R=require("./popper.cjs"),y=require("./portal.cjs"),c=require("./primitive.cjs"),E=require("./useControllableState.cjs"),v=require("./useOpenChangeComplete.cjs"),h=require("./useRovingFocus.cjs"),p=require("react/jsx-runtime"),w='[role^="menuitem"]:not([data-disabled])',x="data-skdx-menu-branch",U=150,[V,N]=(0,S.createSafeContext)("MenuSub");function L({family:e,children:o,open:a,defaultOpen:t=!1,onOpenChange:i,onOpenChangeComplete:s}){let m=r.useRef(null),n=r.useRef(null),u=r.useRef(void 0),[b=!1,l]=(0,E.useControllableState)({prop:a,defaultProp:t,onChange:i});(0,v.useOpenChangeComplete)(b,n,s),r.useEffect(()=>()=>clearTimeout(u.current),[]);let f=r.useCallback(()=>{clearTimeout(u.current),l(!0)},[l]),g=r.useCallback(()=>{clearTimeout(u.current),l(!1)},[l]),H=r.useCallback(()=>{clearTimeout(u.current),u.current=setTimeout(()=>l(!1),U)},[l]);return(0,p.jsx)(R.PopperRoot,{children:(0,p.jsx)(V,{family:e,open:b,openNow:f,closeNow:g,scheduleClose:H,triggerRef:m,contentRef:n,contentId:r.useId(),children:o})})}L.displayName="MenuSub";var D=r.forwardRef(({disabled:e,...o},a)=>{let t=N("MenuSubTrigger"),i=(0,C.useComposedRefs)(a,t.triggerRef),s=(0,d.useDirection)(),m=()=>{t.openNow(),requestAnimationFrame(()=>{let n=t.contentRef.current;(n?.querySelector(w)??n)?.focus({preventScroll:!0})})};return(0,p.jsx)(R.PopperAnchor,{asChild:!0,children:(0,p.jsx)(c.Primitive.div,{role:"menuitem","aria-haspopup":"menu","aria-expanded":t.open,"aria-controls":t.contentId,"data-state":t.open?"open":"closed","data-disabled":e?"":void 0,"aria-disabled":e||void 0,tabIndex:e?void 0:-1,...o,...(0,M.skdxPart)(t.family,"sub-trigger",o.className),ref:i,onClick:(0,c.composeEventHandlers)(o.onClick,()=>{e||m()}),onKeyDown:(0,c.composeEventHandlers)(o.onKeyDown,n=>{if(e)return;let u=(0,d.directionalKey)(n.key,n.currentTarget,s);["ArrowRight","Enter"," "].includes(u)&&(n.preventDefault(),n.stopPropagation(),m())}),onPointerEnter:(0,c.composeEventHandlers)(o.onPointerEnter,n=>{e||(n.currentTarget.focus(),t.openNow())}),onPointerLeave:(0,c.composeEventHandlers)(o.onPointerLeave,()=>{e||t.scheduleClose()})})})});D.displayName="MenuSubTrigger";var k=r.forwardRef(({forceMount:e,loop:o=!0,side:a="end",align:t="start",sideOffset:i=0,...s},m)=>{let n=N("MenuSubContent"),u=(0,C.useComposedRefs)(m,n.contentRef),b=(0,d.useDirection)(),l=(0,h.useRovingFocus)({orientation:"vertical",loop:o,itemSelector:w,typeahead:!0});return e||n.open?(0,p.jsx)(y.Portal,{[x]:"",children:(0,p.jsx)(R.PopperContent,{role:"menu","aria-orientation":"vertical",id:n.contentId,"data-state":n.open?"open":"closed",tabIndex:-1,side:a,align:t,sideOffset:i,...s,...(0,M.skdxPart)(n.family,"sub-content",s.className),ref:u,onKeyDown:(0,c.composeEventHandlers)(s.onKeyDown,f=>{let g=(0,d.directionalKey)(f.key,f.currentTarget,b);g==="ArrowLeft"||g==="Escape"?(f.preventDefault(),n.closeNow(),n.triggerRef.current?.focus()):l(f),f.key!=="Tab"&&f.stopPropagation()}),onPointerEnter:(0,c.composeEventHandlers)(s.onPointerEnter,n.openNow),onPointerLeave:(0,c.composeEventHandlers)(s.onPointerLeave,n.scheduleClose)})}):null});k.displayName="MenuSubContent";0&&(module.exports={MENU_BRANCH_ATTRIBUTE,MenuSub,MenuSubContent,MenuSubTrigger});
+'use client';
+"use strict";var A=Object.create;var P=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var _=Object.getPrototypeOf,F=Object.prototype.hasOwnProperty;var V=(n,o)=>{for(var r in o)P(n,r,{get:o[r],enumerable:!0})},S=(n,o,r,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of K(o))!F.call(n,t)&&t!==r&&P(n,t,{get:()=>o[t],enumerable:!(i=H(o,t))||i.enumerable});return n};var q=(n,o,r)=>(r=n!=null?A(_(n)):{},S(o||!n||!n.__esModule?P(r,"default",{value:n,enumerable:!0}):r,n)),B=n=>S(P({},"__esModule",{value:!0}),n);var j={};V(j,{MENU_BRANCH_ATTRIBUTE:()=>D,MenuSub:()=>L,MenuSubContent:()=>O,MenuSubTrigger:()=>k});module.exports=B(j);var u=q(require("react"),1),T=require("./appearance.cjs"),y=require("./composeRefs.cjs"),h=require("./createContext.cjs"),p=require("./direction.cjs"),M=require("./part.cjs"),m=require("./popper.cjs"),v=require("./portal.cjs"),c=require("./primitive.cjs"),E=require("./useControllableState.cjs"),x=require("./useOpenChangeComplete.cjs"),w=require("./useRovingFocus.cjs"),f=require("react/jsx-runtime"),N='[role^="menuitem"]',D="data-skdx-menu-branch",U=150,[W,I]=(0,h.createSafeContext)("MenuSub");function L({family:n,children:o,open:r,defaultOpen:i=!1,onOpenChange:t,onOpenChangeComplete:g}){let R=u.useRef(null),a=u.useRef(null),e=u.useRef(void 0),[d=!1,l]=(0,E.useControllableState)({prop:r,defaultProp:i,onChange:t});(0,x.useOpenChangeComplete)(d,a,g),u.useEffect(()=>()=>clearTimeout(e.current),[]);let C=u.useCallback(()=>{clearTimeout(e.current),l(!0)},[l]),s=u.useCallback(()=>{clearTimeout(e.current),l(!1)},[l]),b=u.useCallback(()=>{clearTimeout(e.current),e.current=setTimeout(()=>l(!1),U)},[l]);return(0,f.jsx)(m.PopperRoot,{children:(0,f.jsx)(W,{family:n,open:d,openNow:C,closeNow:s,scheduleClose:b,triggerRef:R,contentRef:a,contentId:u.useId(),triggerId:u.useId(),children:o})})}L.displayName="MenuSub";var k=({disabled:n,textValue:o,ref:r,...i})=>{let t=I("MenuSubTrigger"),g=(0,y.useComposedRefs)(r,t.triggerRef),R=(0,p.useDirection)(),a=()=>{t.openNow(),requestAnimationFrame(()=>{let e=t.contentRef.current;(e?.querySelector(N)??e)?.focus({preventScroll:!0})})};return(0,f.jsx)(m.PopperAnchor,{asChild:!0,children:(0,f.jsx)(c.Primitive.div,{role:"menuitem",id:t.triggerId,"aria-haspopup":"menu","aria-expanded":t.open,"aria-controls":t.contentId,"data-state":t.open?"open":"closed","data-disabled":n?"":void 0,"data-text-value":o,"aria-disabled":n||void 0,tabIndex:-1,...i,...(0,M.skdxPart)(t.family,"sub-trigger",i.className),ref:g,onClick:(0,c.composeEventHandlers)(i.onClick,()=>{n||a()}),onKeyDown:(0,c.composeEventHandlers)(i.onKeyDown,e=>{if(n)return;let d=(0,p.directionalKey)(e.key,e.currentTarget,R);["ArrowRight","Enter"," "].includes(d)&&(e.preventDefault(),e.stopPropagation(),a())}),onPointerEnter:(0,c.composeEventHandlers)(i.onPointerEnter,e=>{n||(e.currentTarget.focus(),t.openNow())}),onPointerLeave:(0,c.composeEventHandlers)(i.onPointerLeave,()=>{n||t.scheduleClose()})})})};k.displayName="MenuSubTrigger";var O=({forceMount:n,loop:o=!0,side:r="end",align:i="start",sideOffset:t=0,ref:g,size:R,...a})=>{let e=I("MenuSubContent"),d=(0,y.useComposedRefs)(g,e.contentRef),l=(0,p.usePortalledDirection)(e.triggerRef),C=(0,w.useRovingFocus)({orientation:"vertical",loop:o,itemSelector:N,typeahead:!0,includeDisabled:!0});return n||e.open?(0,f.jsx)(v.Portal,{[D]:"",children:(0,f.jsx)(m.PopperContent,{role:"menu","aria-orientation":"vertical",dir:l,"aria-labelledby":a["aria-label"]===void 0?e.triggerId:void 0,id:e.contentId,"data-state":e.open?"open":"closed",tabIndex:-1,side:r,align:i,sideOffset:t,...a,...(0,T.appearanceAttrs)({size:R},a),...(0,M.skdxPart)(e.family,"sub-content",a.className),ref:d,onKeyDown:(0,c.composeEventHandlers)(a.onKeyDown,s=>{let b=(0,p.directionalKey)(s.key,s.currentTarget,l);b==="ArrowLeft"||b==="Escape"?(s.preventDefault(),e.closeNow(),e.triggerRef.current?.focus()):C(s),s.key!=="Tab"&&s.stopPropagation()}),onPointerEnter:(0,c.composeEventHandlers)(a.onPointerEnter,e.openNow),onPointerLeave:(0,c.composeEventHandlers)(a.onPointerLeave,e.scheduleClose)})}):null};O.displayName="MenuSubContent";0&&(module.exports={MENU_BRANCH_ATTRIBUTE,MenuSub,MenuSubContent,MenuSubTrigger});

package/dist/utils/menuSub.d.cts

@@ -1,120 +1,82 @@
 import * as React from 'react';
 import { type PopperContentProps } from './popper.cjs';
 import { type PrimitivePropsWithRef } from './primitive.cjs';
-/**
- * Marks a portalled submenu panel as belonging to the menu that opened it.
- *
- * A menu passes `[${MENU_BRANCH_ATTRIBUTE}]` to `useDismiss` as its
- * `insideSelector`, so the panel counts as inside despite no longer being
- * `contains()`-reachable from the menu's content ref.
- *
- * Deliberately valueless rather than keyed to the owning menu's id, which would
- * mean threading that id through three families for a distinction nothing can
- * observe: opening a second menu dismisses the first through *its* trigger's
- * pointer-down, which is outside either way, so two menus are never open with
- * a submenu between them.
- */
+/** Marks a portalled submenu panel as belonging to the menu that opened it, passed to `useDismiss` as an `insideSelector` since the panel isn't `contains()`-reachable from the menu's content ref. */
 export declare const MENU_BRANCH_ATTRIBUTE = "data-skdx-menu-branch";
 /** Props for a menu submenu root ({@link MenuSub}). */
 export interface MenuSubProps {
-    /**
-     * The re-exporting family, e.g. `'context-menu'`, which is what lets the
-     * shared parts name their own classes. Supplied by the family wrapper
-     * (`DropdownMenuSub`, `ContextMenuSub`, `MenubarSub`), never by an
-     * application — each wrapper `Omit`s it from its own props for that reason.
-     *
-     * Written as a description followed by the tag, not as tag text: the docs
-     * manifest takes a member's summary from the text *before* the first block
-     * tag, so `@internal The re-exporting family…` left all three wrappers
-     * reported as having an undescribed prop.
-     *
-     * @internal
-     */
-    family: string;
     /**
      * The `SubTrigger` and `SubContent` parts of this submenu.
      * @default undefined — renders nothing if omitted.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
      * Whether the submenu is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the submenu is initially open, for uncontrolled usage.
      * @default false
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the submenu opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `SubContent`'s enter or exit animation ends, or as soon as it has
-     * settled when the panel declares no animation. Use it for work that must not race
-     * the transition; use `onOpenChange` for work that must not wait for it.
+     * Fires with the new open state once the change has finished on screen, after the exit/enter animation ends or immediately if none; use for work that must not race the transition.
      * @default undefined — no-op if omitted.
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
 }
 /** Props for a menu submenu trigger ({@link MenuSubTrigger}). */
 export interface MenuSubTriggerProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Excludes the trigger from roving-focus navigation and blocks it from opening the submenu.
+     * Marks the trigger aria-disabled and blocks it from opening the submenu. It stays in the roving order and remains focusable, so a keyboard user still discovers it.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
+    /**
+     * Text typeahead matches this trigger by instead of its rendered text, reflected to `data-text-value`.
+     * @default undefined — the trigger's rendered text is used.
+     */
+    textValue?: string | undefined;
 }
-/**
- * Props for a menu submenu panel ({@link MenuSubContent}). Extends the shared
- * popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`).
- */
+/** Props for a menu submenu panel ({@link MenuSubContent}), extending the shared popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`, `avoidCollisions`, `collisionPadding`). */
 export interface MenuSubContentProps extends PopperContentProps {
     /**
-     * Keep this panel mounted even while the submenu is closed. Useful for
-     * animation libraries that need the outgoing panel present in the DOM
-     * during an exit transition.
+     * Keep this panel mounted even while the submenu is closed, for an animation library that needs the outgoing panel present during an exit transition.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
      * Whether Up/Down arrow-key navigation wraps from the last item back to
      * the first (and vice versa).
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
+    /**
+     * Size rung the skin scales the panel by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
-/**
- * @internal Root of a nested submenu: owns the submenu's open state and the
- * hover grace timer, and provides a nested popper anchor context so
- * `MenuSubContent` positions against `MenuSubTrigger`. Renders no DOM element
- * itself.
- */
-export declare function MenuSub({ family, children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: MenuSubProps): React.JSX.Element;
+/** @internal Root of a nested submenu, owning open state and the hover grace timer and providing a popper anchor context for `MenuSubContent`; `family` is supplied by the wrapping family component, not a public prop. */
+export declare function MenuSub({ family, children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: MenuSubProps & {
+    family: string;
+}): React.JSX.Element;
 export declare namespace MenuSub {
     var displayName: string;
 }
-/**
- * @internal The parent-menu item that opens a submenu: `role="menuitem"` with
- * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls` and `data-state`.
- * Doubles as the popper anchor for `MenuSubContent`. Opens on click, Enter,
- * Space and ArrowRight (moving focus to the submenu's first item), and on
- * hover (leaving focus where it is). Under `dir="rtl"` the opening key is
- * ArrowLeft instead.
- */
-export declare const MenuSubTrigger: React.ForwardRefExoticComponent<Omit<MenuSubTriggerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-/**
- * @internal The submenu's floating panel: `role="menu"` with
- * `aria-orientation="vertical"` and `data-state`, positioned by the shared
- * popper layer against its `MenuSubTrigger` (`side="end"`, `align="start"` by
- * default — logical, so it opens to the right under LTR and to the left under
- * RTL) and exposing the resolved `data-side`/`data-align`. Owns vertical
- * roving focus and typeahead over its own items; ArrowLeft and Escape close
- * it and return focus to the trigger, leaving the parent menu open — under
- * `dir="rtl"` the closing arrow is ArrowRight.
- */
-export declare const MenuSubContent: React.ForwardRefExoticComponent<Omit<MenuSubContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** @internal Parent-menu item that opens a submenu (`role="menuitem"`, `aria-haspopup="menu"`), doubling as the popper anchor; opens on click, Enter, Space, ArrowRight (or ArrowLeft under RTL), and hover. */
+export declare const MenuSubTrigger: {
+    ({ disabled, textValue, ref: forwardedRef, ...props }: MenuSubTriggerProps): React.ReactNode;
+    displayName: string;
+};
+/** @internal Submenu's floating panel (`role="menu"`), positioned against its `MenuSubTrigger` with logical `side="end"`/`align="start"` defaults; owns vertical roving focus and typeahead, closing on ArrowLeft (or ArrowRight under RTL) or Escape. */
+export declare const MenuSubContent: {
+    ({ forceMount, loop, side, align, sideOffset, ref: forwardedRef, size, ...props }: MenuSubContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/utils/menuSub.d.ts

@@ -1,120 +1,82 @@
 import * as React from 'react';
 import { type PopperContentProps } from './popper.js';
 import { type PrimitivePropsWithRef } from './primitive.js';
-/**
- * Marks a portalled submenu panel as belonging to the menu that opened it.
- *
- * A menu passes `[${MENU_BRANCH_ATTRIBUTE}]` to `useDismiss` as its
- * `insideSelector`, so the panel counts as inside despite no longer being
- * `contains()`-reachable from the menu's content ref.
- *
- * Deliberately valueless rather than keyed to the owning menu's id, which would
- * mean threading that id through three families for a distinction nothing can
- * observe: opening a second menu dismisses the first through *its* trigger's
- * pointer-down, which is outside either way, so two menus are never open with
- * a submenu between them.
- */
+/** Marks a portalled submenu panel as belonging to the menu that opened it, passed to `useDismiss` as an `insideSelector` since the panel isn't `contains()`-reachable from the menu's content ref. */
 export declare const MENU_BRANCH_ATTRIBUTE = "data-skdx-menu-branch";
 /** Props for a menu submenu root ({@link MenuSub}). */
 export interface MenuSubProps {
-    /**
-     * The re-exporting family, e.g. `'context-menu'`, which is what lets the
-     * shared parts name their own classes. Supplied by the family wrapper
-     * (`DropdownMenuSub`, `ContextMenuSub`, `MenubarSub`), never by an
-     * application — each wrapper `Omit`s it from its own props for that reason.
-     *
-     * Written as a description followed by the tag, not as tag text: the docs
-     * manifest takes a member's summary from the text *before* the first block
-     * tag, so `@internal The re-exporting family…` left all three wrappers
-     * reported as having an undescribed prop.
-     *
-     * @internal
-     */
-    family: string;
     /**
      * The `SubTrigger` and `SubContent` parts of this submenu.
      * @default undefined — renders nothing if omitted.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
     /**
      * Whether the submenu is open, for controlled usage. Pair with `onOpenChange`.
      * @default undefined — uncontrolled, tracks its own open state internally.
      */
-    open?: boolean;
+    open?: boolean | undefined;
     /**
      * Whether the submenu is initially open, for uncontrolled usage.
      * @default false
      */
-    defaultOpen?: boolean;
+    defaultOpen?: boolean | undefined;
     /**
      * Fires with the new open state whenever the submenu opens or closes, controlled or not.
      * @default undefined — no-op if omitted.
      */
-    onOpenChange?: (open: boolean) => void;
+    onOpenChange?: ((open: boolean) => void) | undefined;
     /**
-     * Fires with the new open state once the change has finished on screen —
-     * after `SubContent`'s enter or exit animation ends, or as soon as it has
-     * settled when the panel declares no animation. Use it for work that must not race
-     * the transition; use `onOpenChange` for work that must not wait for it.
+     * Fires with the new open state once the change has finished on screen, after the exit/enter animation ends or immediately if none; use for work that must not race the transition.
      * @default undefined — no-op if omitted.
      */
-    onOpenChangeComplete?: (open: boolean) => void;
+    onOpenChangeComplete?: ((open: boolean) => void) | undefined;
 }
 /** Props for a menu submenu trigger ({@link MenuSubTrigger}). */
 export interface MenuSubTriggerProps extends PrimitivePropsWithRef<'div'> {
     /**
-     * Excludes the trigger from roving-focus navigation and blocks it from opening the submenu.
+     * Marks the trigger aria-disabled and blocks it from opening the submenu. It stays in the roving order and remains focusable, so a keyboard user still discovers it.
      * @default false
      */
-    disabled?: boolean;
+    disabled?: boolean | undefined;
+    /**
+     * Text typeahead matches this trigger by instead of its rendered text, reflected to `data-text-value`.
+     * @default undefined — the trigger's rendered text is used.
+     */
+    textValue?: string | undefined;
 }
-/**
- * Props for a menu submenu panel ({@link MenuSubContent}). Extends the shared
- * popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`,
- * `avoidCollisions`, `collisionPadding`).
- */
+/** Props for a menu submenu panel ({@link MenuSubContent}), extending the shared popper positioning props (`side`, `align`, `sideOffset`, `alignOffset`, `avoidCollisions`, `collisionPadding`). */
 export interface MenuSubContentProps extends PopperContentProps {
     /**
-     * Keep this panel mounted even while the submenu is closed. Useful for
-     * animation libraries that need the outgoing panel present in the DOM
-     * during an exit transition.
+     * Keep this panel mounted even while the submenu is closed, for an animation library that needs the outgoing panel present during an exit transition.
      * @default false
      */
-    forceMount?: boolean;
+    forceMount?: boolean | undefined;
     /**
      * Whether Up/Down arrow-key navigation wraps from the last item back to
      * the first (and vice versa).
      * @default true
      */
-    loop?: boolean;
+    loop?: boolean | undefined;
+    /**
+     * Size rung the skin scales the panel by, mirrored to `data-size`.
+     * @default undefined — the skin's own default size.
+     */
+    size?: 'sm' | 'lg' | (string & {}) | undefined;
 }
-/**
- * @internal Root of a nested submenu: owns the submenu's open state and the
- * hover grace timer, and provides a nested popper anchor context so
- * `MenuSubContent` positions against `MenuSubTrigger`. Renders no DOM element
- * itself.
- */
-export declare function MenuSub({ family, children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: MenuSubProps): React.JSX.Element;
+/** @internal Root of a nested submenu, owning open state and the hover grace timer and providing a popper anchor context for `MenuSubContent`; `family` is supplied by the wrapping family component, not a public prop. */
+export declare function MenuSub({ family, children, open: openProp, defaultOpen, onOpenChange, onOpenChangeComplete, }: MenuSubProps & {
+    family: string;
+}): React.JSX.Element;
 export declare namespace MenuSub {
     var displayName: string;
 }
-/**
- * @internal The parent-menu item that opens a submenu: `role="menuitem"` with
- * `aria-haspopup="menu"`, `aria-expanded`, `aria-controls` and `data-state`.
- * Doubles as the popper anchor for `MenuSubContent`. Opens on click, Enter,
- * Space and ArrowRight (moving focus to the submenu's first item), and on
- * hover (leaving focus where it is). Under `dir="rtl"` the opening key is
- * ArrowLeft instead.
- */
-export declare const MenuSubTrigger: React.ForwardRefExoticComponent<Omit<MenuSubTriggerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
-/**
- * @internal The submenu's floating panel: `role="menu"` with
- * `aria-orientation="vertical"` and `data-state`, positioned by the shared
- * popper layer against its `MenuSubTrigger` (`side="end"`, `align="start"` by
- * default — logical, so it opens to the right under LTR and to the left under
- * RTL) and exposing the resolved `data-side`/`data-align`. Owns vertical
- * roving focus and typeahead over its own items; ArrowLeft and Escape close
- * it and return focus to the trigger, leaving the parent menu open — under
- * `dir="rtl"` the closing arrow is ArrowRight.
- */
-export declare const MenuSubContent: React.ForwardRefExoticComponent<Omit<MenuSubContentProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** @internal Parent-menu item that opens a submenu (`role="menuitem"`, `aria-haspopup="menu"`), doubling as the popper anchor; opens on click, Enter, Space, ArrowRight (or ArrowLeft under RTL), and hover. */
+export declare const MenuSubTrigger: {
+    ({ disabled, textValue, ref: forwardedRef, ...props }: MenuSubTriggerProps): React.ReactNode;
+    displayName: string;
+};
+/** @internal Submenu's floating panel (`role="menu"`), positioned against its `MenuSubTrigger` with logical `side="end"`/`align="start"` defaults; owns vertical roving focus and typeahead, closing on ArrowLeft (or ArrowRight under RTL) or Escape. */
+export declare const MenuSubContent: {
+    ({ forceMount, loop, side, align, sideOffset, ref: forwardedRef, size, ...props }: MenuSubContentProps): React.ReactNode;
+    displayName: string;
+};

package/dist/utils/menuSub.js

@@ -1 +1,2 @@
-import*as o from"react";import{useComposedRefs as b}from"./composeRefs.js";import{createSafeContext as y}from"./createContext.js";import{directionalKey as g,useDirection as P}from"./direction.js";import{skdxPart as C}from"./part.js";import{PopperAnchor as E,PopperContent as v,PopperRoot as h}from"./popper.js";import{Portal as w}from"./portal.js";import{composeEventHandlers as s,Primitive as x}from"./primitive.js";import{useControllableState as N}from"./useControllableState.js";import{useOpenChangeComplete as L}from"./useOpenChangeComplete.js";import{useRovingFocus as D}from"./useRovingFocus.js";import{jsx as f}from"react/jsx-runtime";var M='[role^="menuitem"]:not([data-disabled])',k="data-skdx-menu-branch",H=150,[I,T]=y("MenuSub");function O({family:t,children:r,open:p,defaultOpen:n=!1,onOpenChange:m,onOpenChangeComplete:i}){let l=o.useRef(null),e=o.useRef(null),a=o.useRef(void 0),[d=!1,u]=N({prop:p,defaultProp:n,onChange:m});L(d,e,i),o.useEffect(()=>()=>clearTimeout(a.current),[]);let c=o.useCallback(()=>{clearTimeout(a.current),u(!0)},[u]),R=o.useCallback(()=>{clearTimeout(a.current),u(!1)},[u]),S=o.useCallback(()=>{clearTimeout(a.current),a.current=setTimeout(()=>u(!1),H)},[u]);return f(h,{children:f(I,{family:t,open:d,openNow:c,closeNow:R,scheduleClose:S,triggerRef:l,contentRef:e,contentId:o.useId(),children:r})})}O.displayName="MenuSub";var A=o.forwardRef(({disabled:t,...r},p)=>{let n=T("MenuSubTrigger"),m=b(p,n.triggerRef),i=P(),l=()=>{n.openNow(),requestAnimationFrame(()=>{let e=n.contentRef.current;(e?.querySelector(M)??e)?.focus({preventScroll:!0})})};return f(E,{asChild:!0,children:f(x.div,{role:"menuitem","aria-haspopup":"menu","aria-expanded":n.open,"aria-controls":n.contentId,"data-state":n.open?"open":"closed","data-disabled":t?"":void 0,"aria-disabled":t||void 0,tabIndex:t?void 0:-1,...r,...C(n.family,"sub-trigger",r.className),ref:m,onClick:s(r.onClick,()=>{t||l()}),onKeyDown:s(r.onKeyDown,e=>{if(t)return;let a=g(e.key,e.currentTarget,i);["ArrowRight","Enter"," "].includes(a)&&(e.preventDefault(),e.stopPropagation(),l())}),onPointerEnter:s(r.onPointerEnter,e=>{t||(e.currentTarget.focus(),n.openNow())}),onPointerLeave:s(r.onPointerLeave,()=>{t||n.scheduleClose()})})})});A.displayName="MenuSubTrigger";var K=o.forwardRef(({forceMount:t,loop:r=!0,side:p="end",align:n="start",sideOffset:m=0,...i},l)=>{let e=T("MenuSubContent"),a=b(l,e.contentRef),d=P(),u=D({orientation:"vertical",loop:r,itemSelector:M,typeahead:!0});return t||e.open?f(w,{[k]:"",children:f(v,{role:"menu","aria-orientation":"vertical",id:e.contentId,"data-state":e.open?"open":"closed",tabIndex:-1,side:p,align:n,sideOffset:m,...i,...C(e.family,"sub-content",i.className),ref:a,onKeyDown:s(i.onKeyDown,c=>{let R=g(c.key,c.currentTarget,d);R==="ArrowLeft"||R==="Escape"?(c.preventDefault(),e.closeNow(),e.triggerRef.current?.focus()):u(c),c.key!=="Tab"&&c.stopPropagation()}),onPointerEnter:s(i.onPointerEnter,e.openNow),onPointerLeave:s(i.onPointerLeave,e.scheduleClose)})}):null});K.displayName="MenuSubContent";export{k as MENU_BRANCH_ATTRIBUTE,O as MenuSub,K as MenuSubContent,A as MenuSubTrigger};
+'use client';
+import*as o from"react";import{appearanceAttrs as S}from"./appearance.js";import{useComposedRefs as b}from"./composeRefs.js";import{createSafeContext as T}from"./createContext.js";import{directionalKey as P,useDirection as h,usePortalledDirection as v}from"./direction.js";import{skdxPart as C}from"./part.js";import{PopperAnchor as E,PopperContent as x,PopperRoot as w}from"./popper.js";import{Portal as N}from"./portal.js";import{composeEventHandlers as l,Primitive as D}from"./primitive.js";import{useControllableState as I}from"./useControllableState.js";import{useOpenChangeComplete as L}from"./useOpenChangeComplete.js";import{useRovingFocus as k}from"./useRovingFocus.js";import{jsx as s}from"react/jsx-runtime";var y='[role^="menuitem"]',O="data-skdx-menu-branch",A=150,[H,M]=T("MenuSub");function K({family:r,children:d,open:f,defaultOpen:i=!1,onOpenChange:n,onOpenChangeComplete:p}){let m=o.useRef(null),t=o.useRef(null),e=o.useRef(void 0),[c=!1,a]=I({prop:f,defaultProp:i,onChange:n});L(c,t,p),o.useEffect(()=>()=>clearTimeout(e.current),[]);let R=o.useCallback(()=>{clearTimeout(e.current),a(!0)},[a]),u=o.useCallback(()=>{clearTimeout(e.current),a(!1)},[a]),g=o.useCallback(()=>{clearTimeout(e.current),e.current=setTimeout(()=>a(!1),A)},[a]);return s(w,{children:s(H,{family:r,open:c,openNow:R,closeNow:u,scheduleClose:g,triggerRef:m,contentRef:t,contentId:o.useId(),triggerId:o.useId(),children:d})})}K.displayName="MenuSub";var _=({disabled:r,textValue:d,ref:f,...i})=>{let n=M("MenuSubTrigger"),p=b(f,n.triggerRef),m=h(),t=()=>{n.openNow(),requestAnimationFrame(()=>{let e=n.contentRef.current;(e?.querySelector(y)??e)?.focus({preventScroll:!0})})};return s(E,{asChild:!0,children:s(D.div,{role:"menuitem",id:n.triggerId,"aria-haspopup":"menu","aria-expanded":n.open,"aria-controls":n.contentId,"data-state":n.open?"open":"closed","data-disabled":r?"":void 0,"data-text-value":d,"aria-disabled":r||void 0,tabIndex:-1,...i,...C(n.family,"sub-trigger",i.className),ref:p,onClick:l(i.onClick,()=>{r||t()}),onKeyDown:l(i.onKeyDown,e=>{if(r)return;let c=P(e.key,e.currentTarget,m);["ArrowRight","Enter"," "].includes(c)&&(e.preventDefault(),e.stopPropagation(),t())}),onPointerEnter:l(i.onPointerEnter,e=>{r||(e.currentTarget.focus(),n.openNow())}),onPointerLeave:l(i.onPointerLeave,()=>{r||n.scheduleClose()})})})};_.displayName="MenuSubTrigger";var F=({forceMount:r,loop:d=!0,side:f="end",align:i="start",sideOffset:n=0,ref:p,size:m,...t})=>{let e=M("MenuSubContent"),c=b(p,e.contentRef),a=v(e.triggerRef),R=k({orientation:"vertical",loop:d,itemSelector:y,typeahead:!0,includeDisabled:!0});return r||e.open?s(N,{[O]:"",children:s(x,{role:"menu","aria-orientation":"vertical",dir:a,"aria-labelledby":t["aria-label"]===void 0?e.triggerId:void 0,id:e.contentId,"data-state":e.open?"open":"closed",tabIndex:-1,side:f,align:i,sideOffset:n,...t,...S({size:m},t),...C(e.family,"sub-content",t.className),ref:c,onKeyDown:l(t.onKeyDown,u=>{let g=P(u.key,u.currentTarget,a);g==="ArrowLeft"||g==="Escape"?(u.preventDefault(),e.closeNow(),e.triggerRef.current?.focus()):R(u),u.key!=="Tab"&&u.stopPropagation()}),onPointerEnter:l(t.onPointerEnter,e.openNow),onPointerLeave:l(t.onPointerLeave,e.scheduleClose)})}):null};F.displayName="MenuSubContent";export{O as MENU_BRANCH_ATTRIBUTE,K as MenuSub,F as MenuSubContent,_ as MenuSubTrigger};

package/dist/utils/numberFormat.cjs

@@ -1 +1,2 @@
+'use client';
 "use strict";var s=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var b=(e,r)=>{for(var t in r)s(e,t,{get:r[t],enumerable:!0})},c=(e,r,t,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of l(r))!f.call(e,n)&&n!==t&&s(e,n,{get:()=>r[n],enumerable:!(u=p(r,n))||u.enumerable});return e};var g=e=>c(s({},"__esModule",{value:!0}),e);var I={};b(I,{formatNumberValue:()=>d,parseNumberValue:()=>F});module.exports=g(I);function d(e,r,t){return!r&&!t?String(e):new Intl.NumberFormat(r,t).format(e)}function F(e,r,t){let u=e.trim();if(u==="")return NaN;if(!r&&!t)return Number(u);let n=new Intl.NumberFormat(r,t).formatToParts(-12345.6),N=n.find(a=>a.type==="group")?.value,o=n.find(a=>a.type==="decimal")?.value??new Intl.NumberFormat(r).formatToParts(1.5).find(a=>a.type==="decimal")?.value??".",i=u.replace(/[\s\u00a0\u202f]/g,"").replace(/\u2212/g,"-");if(N&&(i=i.split(N).join("")),i=i.split(o).join(".").replace(/[^0-9.-]/g,""),!/[0-9]/.test(i))return NaN;let m=Number(i);return Number.isNaN(m)?NaN:t?.style==="percent"?m/100:m}0&&(module.exports={formatNumberValue,parseNumberValue});

package/dist/utils/numberFormat.d.cts

@@ -1,19 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField.
- *
- * With neither `locale` nor `formatOptions`, formatting is off and the value
- * round-trips through `String`/`Number` exactly as it did before — the
- * formatted path is opt-in.
- *
- * Percent follows `Intl.NumberFormat` semantics: the value is the *fraction*,
- * so `0.5` displays as `50%` and typing `50%` parses back to `0.5`. `min`,
- * `max` and `step` therefore also operate on the fraction.
- */
+/** `Intl.NumberFormat`-based formatter for NumberField: formatting is off without `locale`/`formatOptions`, and percent values are fractions (`0.5` → `50%`). */
 export declare function formatNumberValue(value: number, locale?: string, formatOptions?: Intl.NumberFormatOptions): string;
-/**
- * Parses text the user typed or pasted back into a number, tolerating
- * everything {@link formatNumberValue} can emit: group separators, the
- * locale's decimal separator, currency symbols, unit suffixes, `%`, and the
- * Unicode minus sign. Returns `NaN` when the text holds no number.
- */
+/** Parses text the user typed or pasted back into a number, tolerating everything {@link formatNumberValue} can emit, returning `NaN` when the text holds no number. */
 export declare function parseNumberValue(text: string, locale?: string, formatOptions?: Intl.NumberFormatOptions): number;

package/dist/utils/numberFormat.d.ts

@@ -1,19 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField.
- *
- * With neither `locale` nor `formatOptions`, formatting is off and the value
- * round-trips through `String`/`Number` exactly as it did before — the
- * formatted path is opt-in.
- *
- * Percent follows `Intl.NumberFormat` semantics: the value is the *fraction*,
- * so `0.5` displays as `50%` and typing `50%` parses back to `0.5`. `min`,
- * `max` and `step` therefore also operate on the fraction.
- */
+/** `Intl.NumberFormat`-based formatter for NumberField: formatting is off without `locale`/`formatOptions`, and percent values are fractions (`0.5` → `50%`). */
 export declare function formatNumberValue(value: number, locale?: string, formatOptions?: Intl.NumberFormatOptions): string;
-/**
- * Parses text the user typed or pasted back into a number, tolerating
- * everything {@link formatNumberValue} can emit: group separators, the
- * locale's decimal separator, currency symbols, unit suffixes, `%`, and the
- * Unicode minus sign. Returns `NaN` when the text holds no number.
- */
+/** Parses text the user typed or pasted back into a number, tolerating everything {@link formatNumberValue} can emit, returning `NaN` when the text holds no number. */
 export declare function parseNumberValue(text: string, locale?: string, formatOptions?: Intl.NumberFormatOptions): number;

package/dist/utils/numberFormat.js

@@ -1 +1,2 @@
+'use client';
 function o(u,r,e){return!r&&!e?String(u):new Intl.NumberFormat(r,e).format(u)}function p(u,r,e){let i=u.trim();if(i==="")return NaN;if(!r&&!e)return Number(i);let m=new Intl.NumberFormat(r,e).formatToParts(-12345.6),s=m.find(n=>n.type==="group")?.value,N=m.find(n=>n.type==="decimal")?.value??new Intl.NumberFormat(r).formatToParts(1.5).find(n=>n.type==="decimal")?.value??".",t=i.replace(/[\s\u00a0\u202f]/g,"").replace(/\u2212/g,"-");if(s&&(t=t.split(s).join("")),t=t.split(N).join(".").replace(/[^0-9.-]/g,""),!/[0-9]/.test(t))return NaN;let a=Number(t);return Number.isNaN(a)?NaN:e?.style==="percent"?a/100:a}export{o as formatNumberValue,p as parseNumberValue};

package/dist/utils/part.cjs

@@ -1 +1,2 @@
-"use strict";var i=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var x=(s,t)=>{for(var r in t)i(s,r,{get:t[r],enumerable:!0})},f=(s,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of u(t))!c.call(s,n)&&n!==r&&i(s,n,{get:()=>t[n],enumerable:!(a=d(t,n))||a.enumerable});return s};var g=s=>f(i({},"__esModule",{value:!0}),s);var b={};x(b,{skdxPart:()=>l});module.exports=g(b);function k(...s){let t="";for(let r of s)r&&(t=t?`${t} ${r}`:r);return t}function l(s,t,r,a){let n=t==="root",o=n?`skdx-${s}`:`skdx-${s}__${t}`,e={className:k(o,r),"data-part":t};return n&&(e["data-skdx-component"]=a??s),e}0&&(module.exports={skdxPart});
+'use client';
+"use strict";var e=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(r,t)=>{for(var s in t)e(r,s,{get:t[s],enumerable:!0})},g=(r,t,s,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of x(t))!c.call(r,n)&&n!==s&&e(r,n,{get:()=>t[n],enumerable:!(a=u(t,n))||a.enumerable});return r};var k=r=>g(e({},"__esModule",{value:!0}),r);var b={};f(b,{cx:()=>o,skdxPart:()=>l});module.exports=k(b);function o(...r){let t="";for(let s of r)s&&(t=t?`${t} ${s}`:s);return t}function l(r,t,s,a){let n=t==="root",d=n?`skdx-${r}`:`skdx-${r}__${t}`,i={className:o(d,s),"data-part":t};return n&&(i["data-skdx-component"]=a??r),i}0&&(module.exports={cx,skdxPart});