@skdx/react 0.28.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

@@ -1 +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

@@ -10,12 +10,9 @@ export interface MenuGroupContextValue {
     /** Called by the Label on mount/unmount, so the group knows whether the id resolves. */
     setHasLabel: (hasLabel: boolean) => void;
 }
-declare const MenuGroupProvider: {
-    (props: MenuGroupContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-};
+declare const MenuGroupProvider: React.FC<MenuGroupContextValue & {
+    children: React.ReactNode;
+}>;
 export { MenuGroupProvider };
 /**
  * @internal State a `Group`/`RadioGroup` needs to be named by its Label:

package/dist/utils/menuGroup.d.ts

@@ -10,12 +10,9 @@ export interface MenuGroupContextValue {
     /** Called by the Label on mount/unmount, so the group knows whether the id resolves. */
     setHasLabel: (hasLabel: boolean) => void;
 }
-declare const MenuGroupProvider: {
-    (props: MenuGroupContextValue & {
-        children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-};
+declare const MenuGroupProvider: React.FC<MenuGroupContextValue & {
+    children: React.ReactNode;
+}>;
 export { MenuGroupProvider };
 /**
  * @internal State a `Group`/`RadioGroup` needs to be named by its Label:

package/dist/utils/menuGroup.js

@@ -1 +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 O=Object.create;var P=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var K=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty;var F=(e,n)=>{for(var o in n)P(e,o,{get:n[o],enumerable:!0})},y=(e,n,o,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of A(n))!_.call(e,t)&&t!==o&&P(e,t,{get:()=>n[t],enumerable:!(c=H(n,t))||c.enumerable});return e};var V=(e,n,o)=>(o=e!=null?O(K(e)):{},y(n||!e||!e.__esModule?P(o,"default",{value:e,enumerable:!0}):o,e)),q=e=>y(P({},"__esModule",{value:!0}),e);var W={};F(W,{MENU_BRANCH_ATTRIBUTE:()=>x,MenuSub:()=>N,MenuSubContent:()=>I,MenuSubTrigger:()=>L});module.exports=q(W);var i=V(require("react"),1),C=require("./composeRefs.cjs"),T=require("./createContext.cjs"),m=require("./direction.cjs"),M=require("./part.cjs"),g=require("./popper.cjs"),S=require("./portal.cjs"),l=require("./primitive.cjs"),h=require("./useControllableState.cjs"),v=require("./useOpenChangeComplete.cjs"),E=require("./useRovingFocus.cjs"),p=require("react/jsx-runtime"),w='[role^="menuitem"]',x="data-skdx-menu-branch",B=150,[U,D]=(0,T.createSafeContext)("MenuSub");function N({family:e,children:n,open:o,defaultOpen:c=!1,onOpenChange:t,onOpenChangeComplete:u}){let R=i.useRef(null),r=i.useRef(null),a=i.useRef(void 0),[s=!1,d]=(0,h.useControllableState)({prop:o,defaultProp:c,onChange:t});(0,v.useOpenChangeComplete)(s,r,u),i.useEffect(()=>()=>clearTimeout(a.current),[]);let f=i.useCallback(()=>{clearTimeout(a.current),d(!0)},[d]),b=i.useCallback(()=>{clearTimeout(a.current),d(!1)},[d]),k=i.useCallback(()=>{clearTimeout(a.current),a.current=setTimeout(()=>d(!1),B)},[d]);return(0,p.jsx)(g.PopperRoot,{children:(0,p.jsx)(U,{family:e,open:s,openNow:f,closeNow:b,scheduleClose:k,triggerRef:R,contentRef:r,contentId:i.useId(),triggerId:i.useId(),children:n})})}N.displayName="MenuSub";var L=i.forwardRef(({disabled:e,textValue:n,...o},c)=>{let t=D("MenuSubTrigger"),u=(0,C.useComposedRefs)(c,t.triggerRef),R=(0,m.useDirection)(),r=()=>{t.openNow(),requestAnimationFrame(()=>{let a=t.contentRef.current;(a?.querySelector(w)??a)?.focus({preventScroll:!0})})};return(0,p.jsx)(g.PopperAnchor,{asChild:!0,children:(0,p.jsx)(l.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":e?"":void 0,"data-text-value":n,"aria-disabled":e||void 0,tabIndex:-1,...o,...(0,M.skdxPart)(t.family,"sub-trigger",o.className),ref:u,onClick:(0,l.composeEventHandlers)(o.onClick,()=>{e||r()}),onKeyDown:(0,l.composeEventHandlers)(o.onKeyDown,a=>{if(e)return;let s=(0,m.directionalKey)(a.key,a.currentTarget,R);["ArrowRight","Enter"," "].includes(s)&&(a.preventDefault(),a.stopPropagation(),r())}),onPointerEnter:(0,l.composeEventHandlers)(o.onPointerEnter,a=>{e||(a.currentTarget.focus(),t.openNow())}),onPointerLeave:(0,l.composeEventHandlers)(o.onPointerLeave,()=>{e||t.scheduleClose()})})})});L.displayName="MenuSubTrigger";var I=i.forwardRef(({forceMount:e,loop:n=!0,side:o="end",align:c="start",sideOffset:t=0,...u},R)=>{let r=D("MenuSubContent"),a=(0,C.useComposedRefs)(R,r.contentRef),s=(0,m.usePortalledDirection)(r.triggerRef),d=(0,E.useRovingFocus)({orientation:"vertical",loop:n,itemSelector:w,typeahead:!0,includeDisabled:!0});return e||r.open?(0,p.jsx)(S.Portal,{[x]:"",children:(0,p.jsx)(g.PopperContent,{role:"menu","aria-orientation":"vertical",dir:s,"aria-labelledby":u["aria-label"]===void 0?r.triggerId:void 0,id:r.contentId,"data-state":r.open?"open":"closed",tabIndex:-1,side:o,align:c,sideOffset:t,...u,...(0,M.skdxPart)(r.family,"sub-content",u.className),ref:a,onKeyDown:(0,l.composeEventHandlers)(u.onKeyDown,f=>{let b=(0,m.directionalKey)(f.key,f.currentTarget,s);b==="ArrowLeft"||b==="Escape"?(f.preventDefault(),r.closeNow(),r.triggerRef.current?.focus()):d(f),f.key!=="Tab"&&f.stopPropagation()}),onPointerEnter:(0,l.composeEventHandlers)(u.onPointerEnter,r.openNow),onPointerLeave:(0,l.composeEventHandlers)(u.onPointerLeave,r.scheduleClose)})}):null});I.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,15 +1,7 @@
 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 not being
- * `contains()`-reachable from the menu's content ref.
- *
- * Deliberately valueless rather than keyed to the owning menu's id: two menus
- * are never open with a submenu between them, so nothing can observe the distinction.
- */
+/** 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 {
@@ -17,30 +9,27 @@ export interface MenuSubProps {
      * 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'> {
@@ -48,71 +37,46 @@ export interface MenuSubTriggerProps extends PrimitivePropsWithRef<'div'> {
      * 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`, which every matcher reads ahead of
-     * `textContent`.
+     * 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;
+    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.
- *
- * The `family` parameter is not part of MenuSubProps — it is supplied by the
- * wrapping family component (DropdownMenuSub, ContextMenuSub, MenubarSub) and
- * resolved from that family's context, not exposed as a public prop.
- */
+/** @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`, an `id` for
- * `MenuSubContent` to name itself after, 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"` named after its
- * SubTrigger via `aria-labelledby` (unless the consumer supplies an
- * `aria-label`, which wins), 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,15 +1,7 @@
 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 not being
- * `contains()`-reachable from the menu's content ref.
- *
- * Deliberately valueless rather than keyed to the owning menu's id: two menus
- * are never open with a submenu between them, so nothing can observe the distinction.
- */
+/** 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 {
@@ -17,30 +9,27 @@ export interface MenuSubProps {
      * 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'> {
@@ -48,71 +37,46 @@ export interface MenuSubTriggerProps extends PrimitivePropsWithRef<'div'> {
      * 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`, which every matcher reads ahead of
-     * `textContent`.
+     * 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;
+    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.
- *
- * The `family` parameter is not part of MenuSubProps — it is supplied by the
- * wrapping family component (DropdownMenuSub, ContextMenuSub, MenubarSub) and
- * resolved from that family's context, not exposed as a public prop.
- */
+/** @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`, an `id` for
- * `MenuSubContent` to name itself after, 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"` named after its
- * SubTrigger via `aria-labelledby` (unless the consumer supplies an
- * `aria-label`, which wins), 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 R}from"./composeRefs.js";import{createSafeContext as T}from"./createContext.js";import{directionalKey as b,useDirection as S,usePortalledDirection as h}from"./direction.js";import{skdxPart as P}from"./part.js";import{PopperAnchor as v,PopperContent as E,PopperRoot as w}from"./popper.js";import{Portal as x}from"./portal.js";import{composeEventHandlers as s,Primitive as D}from"./primitive.js";import{useControllableState as N}from"./useControllableState.js";import{useOpenChangeComplete as L}from"./useOpenChangeComplete.js";import{useRovingFocus as I}from"./useRovingFocus.js";import{jsx as d}from"react/jsx-runtime";var C='[role^="menuitem"]',k="data-skdx-menu-branch",O=150,[H,M]=T("MenuSub");function A({family:r,children:f,open:a,defaultOpen:p=!1,onOpenChange:n,onOpenChangeComplete:i}){let m=o.useRef(null),e=o.useRef(null),t=o.useRef(void 0),[u=!1,l]=N({prop:a,defaultProp:p,onChange:n});L(u,e,i),o.useEffect(()=>()=>clearTimeout(t.current),[]);let c=o.useCallback(()=>{clearTimeout(t.current),l(!0)},[l]),g=o.useCallback(()=>{clearTimeout(t.current),l(!1)},[l]),y=o.useCallback(()=>{clearTimeout(t.current),t.current=setTimeout(()=>l(!1),O)},[l]);return d(w,{children:d(H,{family:r,open:u,openNow:c,closeNow:g,scheduleClose:y,triggerRef:m,contentRef:e,contentId:o.useId(),triggerId:o.useId(),children:f})})}A.displayName="MenuSub";var K=o.forwardRef(({disabled:r,textValue:f,...a},p)=>{let n=M("MenuSubTrigger"),i=R(p,n.triggerRef),m=S(),e=()=>{n.openNow(),requestAnimationFrame(()=>{let t=n.contentRef.current;(t?.querySelector(C)??t)?.focus({preventScroll:!0})})};return d(v,{asChild:!0,children:d(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":f,"aria-disabled":r||void 0,tabIndex:-1,...a,...P(n.family,"sub-trigger",a.className),ref:i,onClick:s(a.onClick,()=>{r||e()}),onKeyDown:s(a.onKeyDown,t=>{if(r)return;let u=b(t.key,t.currentTarget,m);["ArrowRight","Enter"," "].includes(u)&&(t.preventDefault(),t.stopPropagation(),e())}),onPointerEnter:s(a.onPointerEnter,t=>{r||(t.currentTarget.focus(),n.openNow())}),onPointerLeave:s(a.onPointerLeave,()=>{r||n.scheduleClose()})})})});K.displayName="MenuSubTrigger";var _=o.forwardRef(({forceMount:r,loop:f=!0,side:a="end",align:p="start",sideOffset:n=0,...i},m)=>{let e=M("MenuSubContent"),t=R(m,e.contentRef),u=h(e.triggerRef),l=I({orientation:"vertical",loop:f,itemSelector:C,typeahead:!0,includeDisabled:!0});return r||e.open?d(x,{[k]:"",children:d(E,{role:"menu","aria-orientation":"vertical",dir:u,"aria-labelledby":i["aria-label"]===void 0?e.triggerId:void 0,id:e.contentId,"data-state":e.open?"open":"closed",tabIndex:-1,side:a,align:p,sideOffset:n,...i,...P(e.family,"sub-content",i.className),ref:t,onKeyDown:s(i.onKeyDown,c=>{let g=b(c.key,c.currentTarget,u);g==="ArrowLeft"||g==="Escape"?(c.preventDefault(),e.closeNow(),e.triggerRef.current?.focus()):l(c),c.key!=="Tab"&&c.stopPropagation()}),onPointerEnter:s(i.onPointerEnter,e.openNow),onPointerLeave:s(i.onPointerLeave,e.scheduleClose)})}):null});_.displayName="MenuSubContent";export{k as MENU_BRANCH_ATTRIBUTE,A as MenuSub,_ as MenuSubContent,K 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,13 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField. Without `locale`
- * or `formatOptions`, formatting is off. Percent values are fractions:
- * `0.5` displays as `50%`; `min`, `max`, `step` operate on fractions.
- */
+/** `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,13 +1,4 @@
-/**
- * `Intl.NumberFormat` display/parse pair for NumberField. Without `locale`
- * or `formatOptions`, formatting is off. Percent values are fractions:
- * `0.5` displays as `50%`; `min`, `max`, `step` operate on fractions.
- */
+/** `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});

package/dist/utils/part.d.cts

@@ -1,35 +1,22 @@
+/**
+ * Joins the truthy class-name values with single spaces, skipping the rest.
+ *
+ * @internal
+ */
+export declare function cx(...values: Array<string | false | null | undefined>): string;
 /** The attribute bag {@link skdxPart} returns, spread onto a part's root element. */
 export interface SkdxPartAttributes {
     className: string;
     'data-part': string;
-    'data-skdx-component'?: string;
+    'data-skdx-component'?: string | undefined;
 }
 /**
- * Builds the class and `data-*` hooks for one part of one component.
- *
- * Spread this **after** the consumer's `{...props}` so the merged `className`
- * wins over the raw one — otherwise a consumer passing `className` would
- * silently delete the part's own class and with it every rule in the skin:
- *
- * ```tsx
- * <Primitive.button
- *   type="button"
- *   {...props}
- *   {...skdxPart('button', 'root', props.className)}
- *   ref={forwardedRef}
- * />
- * ```
- *
- * The consumer's class is appended rather than prepended, but order in the
- * attribute is not what resolves a conflict — specificity and source order in
- * the *stylesheet* are. It is appended because that reads as "ours, then
- * theirs" in the DOM inspector, which is the order a person debugging an
- * override expects to see.
+ * Builds the class and `data-*` hooks for one part of one component; spread after the consumer's `{...props}` so the merged `className` wins instead of being silently deleted.
  *
  * @param component - Family name in kebab-case, e.g. `'button'`, `'tree-select'`. Becomes the `skdx-` class stem and, on the root, `data-skdx-component`.
  * @param part - Part name from the family's `styling.cssParts`, or `'root'`.
  * @param className - The consumer's `className`, merged in. Pass `props.className`.
- * @param inheritedComponent - A `data-skdx-component` already on the incoming props, which wins. Only a component that can be rendered *as* another family's root needs this; see the note on the parameter in {@link skdxPart}'s body.
+ * @param inheritedComponent - A `data-skdx-component` already on the incoming props, which wins.
  *
  * @example
  * ```tsx