@skdx/react 0.26.0 → 0.28.0

package/dist/utils/part.d.ts

@@ -1,57 +1,3 @@
-/**
- * The styling hook every part of every component emits.
- *
- * Why this exists
- * ---------------
- * The React package is headless: importing it must never pull in CSS, and it
- * still doesn't — this file emits *class names*, not styles. A class name with
- * no stylesheet behind it is inert, so `@skdx/react` on its own renders
- * exactly the markup it always did, plus an attribute a stylesheet may or may
- * not match. That is the whole trade: components stay unstyled, but they stop
- * being *unstylable* without the consumer inventing their own class for every
- * part.
- *
- * Before this, 85% of the package's DOM had no stable selector at all. A
- * consumer wanting to style an accordion trigger had to either wrap it in
- * their own element or reach in with a structural selector like
- * `[data-state] > button`, which breaks the moment the anatomy changes. The 15%
- * that *were* addressable used ad-hoc `data-skdx-accordion-trigger` attributes,
- * added case by case, with no rule for when a part earned one.
- *
- * The contract this emits
- * -----------------------
- * For a root part:
- *
- * ```html
- * <button class="skdx-button" data-skdx-component="button" data-part="root">
- * ```
- *
- * For a non-root part:
- *
- * ```html
- * <span class="skdx-button__icon" data-part="icon">
- * ```
- *
- * Three hooks, because each answers a different question and no one of them
- * answers all three:
- *
- *   - `class` is what a stylesheet matches. `:where(.skdx-button)` gives
- *     `@skdx/skins` zero specificity, so a consumer's own single class beats
- *     it without `!important`.
- *   - `data-skdx-component` identifies the *family* on the root only, so
- *     `[data-skdx-component="button"]` finds every button regardless of which
- *     part classes a consumer has since overridden.
- *   - `data-part` names the part in the same vocabulary the Web Components
- *     package already exposes through `::part()`, which is what keeps a skin
- *     written against React reusable against `<skdx-button>`.
- *
- * Part names are not invented here. They come from each family's existing
- * `styling.cssParts` in `@skdx/shared` — the vocabulary
- * `packages/web-components` already ships and `scripts/contract-parts.mjs`
- * already enforces — so the two frameworks cannot drift apart by construction.
- *
- * @see docs/architecture/component-styling-contract.md
- */
 /** The attribute bag {@link skdxPart} returns, spread onto a part's root element. */
 export interface SkdxPartAttributes {
     className: string;

package/dist/utils/passThrough.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var u=(e,t,i,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of o(t))!c.call(e,r)&&r!==i&&s(e,r,{get:()=>t[r],enumerable:!(a=n(t,r))||a.enumerable});return e};var b=e=>u(s({},"__esModule",{value:!0}),e);var d={};module.exports=b(d);

package/dist/utils/passThrough.d.cts

@@ -0,0 +1,28 @@
+import type * as React from 'react';
+/** @internal Any `data-*` attribute, so a recipe can forward one it cannot name in advance. */
+interface DataAttributes {
+    [key: `data-${string}`]: string | number | boolean | undefined;
+}
+/**
+ * Standard attributes recipes forward to the *real* control (trigger, input, listbox, panel), not to wrapper elements.
+ *
+ * Without `id` on the control, external `<label for>` cannot associate, which is a WCAG failure.
+ */
+export interface PassThroughProps extends React.AriaAttributes, DataAttributes {
+    /**
+     * Forwarded to control, so external `<label for>` can name it.
+     * @default undefined
+     */
+    id?: string;
+    /**
+     * Forwarded to control alongside part class.
+     * @default undefined
+     */
+    className?: string;
+    /**
+     * Inline styles forwarded to the underlying control element.
+     * @default undefined
+     */
+    style?: React.CSSProperties;
+}
+export {};

package/dist/utils/passThrough.d.ts

@@ -0,0 +1,28 @@
+import type * as React from 'react';
+/** @internal Any `data-*` attribute, so a recipe can forward one it cannot name in advance. */
+interface DataAttributes {
+    [key: `data-${string}`]: string | number | boolean | undefined;
+}
+/**
+ * Standard attributes recipes forward to the *real* control (trigger, input, listbox, panel), not to wrapper elements.
+ *
+ * Without `id` on the control, external `<label for>` cannot associate, which is a WCAG failure.
+ */
+export interface PassThroughProps extends React.AriaAttributes, DataAttributes {
+    /**
+     * Forwarded to control, so external `<label for>` can name it.
+     * @default undefined
+     */
+    id?: string;
+    /**
+     * Forwarded to control alongside part class.
+     * @default undefined
+     */
+    className?: string;
+    /**
+     * Inline styles forwarded to the underlying control element.
+     * @default undefined
+     */
+    style?: React.CSSProperties;
+}
+export {};

package/dist/utils/popper.cjs

@@ -1 +1 @@
-"use strict";var z=Object.create;var P=Object.defineProperty;var U=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var q=Object.getPrototypeOf,J=Object.prototype.hasOwnProperty;var K=(e,t)=>{for(var r in t)P(e,r,{get:t[r],enumerable:!0})},b=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of j(t))!J.call(e,n)&&n!==r&&P(e,n,{get:()=>t[n],enumerable:!(s=U(t,n))||s.enumerable});return e};var Q=(e,t,r)=>(r=e!=null?z(q(e)):{},b(t||!e||!e.__esModule?P(r,"default",{value:e,enumerable:!0}):r,e)),Z=e=>b(P({},"__esModule",{value:!0}),e);var ie={};K(ie,{PopperAnchor:()=>A,PopperArrow:()=>H,PopperContent:()=>$,PopperRoot:()=>te,setMeasurementProperties:()=>C,usePopperContext:()=>y});module.exports=Z(ie);var o=require("@floating-ui/react-dom"),i=Q(require("react"),1),u=require("./composeRefs.cjs"),S=require("./createContext.cjs"),m=require("./direction.cjs"),h=require("./primitive.cjs"),c=require("react/jsx-runtime"),[ee,y]=(0,S.createSafeContext)("Popper");function te({children:e}){let[t,r]=i.useState(null);return(0,c.jsx)(ee,{anchor:t,setAnchor:r,children:e})}var A=i.forwardRef((e,t)=>{let r=y("PopperAnchor"),s=(0,u.useComposedRefs)(t,n=>r.setAnchor(n));return(0,c.jsx)(h.Primitive.div,{...e,ref:s})});A.displayName="PopperAnchor";function re(e,t){return t==="center"?e:`${e}-${t}`}var oe={start:"0%",center:"50%",end:"100%"};function C(e,t,r){let{availableWidth:s,availableHeight:n,triggerWidth:d,side:l,align:p}=r,a=oe[p],f=l==="top"||l==="bottom"?`${a} ${l==="top"?"100%":"0%"}`:`${l==="left"?"100%":"0%"} ${a}`;e.style.setProperty(`--skdx-${t}-available-width`,`${s}px`),e.style.setProperty(`--skdx-${t}-available-height`,`${n}px`),e.style.setProperty(`--skdx-${t}-trigger-width`,`${d}px`),e.style.setProperty(`--skdx-${t}-transform-origin`,f)}var E=i.createContext(null),$=i.forwardRef((e,t)=>{let{side:r="bottom",align:s="center",sideOffset:n=0,alignOffset:d=0,avoidCollisions:l=!0,collisionPadding:p=8,collisionBoundary:a,component:f,style:M,...L}=e,x=y("PopperContent"),R=i.useRef(null),O=(0,m.useDirection)(),T=(0,m.resolveDirection)(x.anchor,O),g=a?{boundary:a}:{},{refs:W,floatingStyles:D,placement:N,middlewareData:v}=(0,o.useFloating)({placement:re((0,m.resolvePhysicalSide)(r,T),s),whileElementsMounted:o.autoUpdate,elements:{reference:x.anchor},middleware:[(0,o.offset)({mainAxis:n,alignmentAxis:d}),...l?[(0,o.flip)({padding:p,...g}),(0,o.shift)({padding:p,limiter:(0,o.limitShift)(),...g})]:[],(0,o.size)({padding:p,...g,apply({availableWidth:X,availableHeight:Y,elements:B,rects:F,placement:G}){if(!f)return;let[V,_="center"]=G.split("-");C(B.floating,f,{availableWidth:X,availableHeight:Y,triggerWidth:F.reference.width,side:V,align:_})}}),(0,o.arrow)({element:R})]}),k=(0,u.useComposedRefs)(t,W.setFloating),[w,I="center"]=N.split("-");return(0,c.jsx)(E.Provider,{value:{arrowRef:R,arrowX:v.arrow?.x,arrowY:v.arrow?.y,side:w},children:(0,c.jsx)(h.Primitive.div,{"data-side":w,"data-align":I,...L,ref:k,style:{...D,...M}})})});$.displayName="PopperContent";var ne={top:"bottom",right:"left",bottom:"top",left:"right"},H=i.forwardRef((e,t)=>{let r=i.useContext(E);if(!r)throw new Error("[skandadx] PopperArrow must be used within PopperContent.");let{arrowRef:s,arrowX:n,arrowY:d,side:l}=r,p=(0,u.useComposedRefs)(t,s),a=ne[l];return(0,c.jsx)(h.Primitive.span,{...e,ref:p,style:{position:"absolute",left:n!=null?`${n}px`:void 0,top:d!=null?`${d}px`:void 0,[a]:void 0,...a==="top"&&{top:0,transform:"translateY(-100%)"},...a==="bottom"&&{bottom:0,transform:"translateY(100%)"},...a==="left"&&{left:0,transform:"translateX(-100%)"},...a==="right"&&{right:0,transform:"translateX(100%)"},...e.style}})});H.displayName="PopperArrow";0&&(module.exports={PopperAnchor,PopperArrow,PopperContent,PopperRoot,setMeasurementProperties,usePopperContext});
+"use strict";var K=Object.create;var P=Object.defineProperty;var Q=Object.getOwnPropertyDescriptor;var Z=Object.getOwnPropertyNames;var ee=Object.getPrototypeOf,te=Object.prototype.hasOwnProperty;var re=(e,t)=>{for(var r in t)P(e,r,{get:t[r],enumerable:!0})},A=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of Z(t))!te.call(e,o)&&o!==r&&P(e,o,{get:()=>t[o],enumerable:!(a=Q(t,o))||a.enumerable});return e};var ne=(e,t,r)=>(r=e!=null?K(ee(e)):{},A(t||!e||!e.__esModule?P(r,"default",{value:e,enumerable:!0}):r,e)),oe=e=>A(P({},"__esModule",{value:!0}),e);var ce={};re(ce,{PopperAnchor:()=>C,PopperArrow:()=>M,PopperContent:()=>O,PopperRoot:()=>ae,setMeasurementProperties:()=>H,usePopperContext:()=>x});module.exports=oe(ce);var n=require("@floating-ui/react-dom"),i=ne(require("react"),1),h=require("./composeRefs.cjs"),E=require("./createContext.cjs"),f=require("./direction.cjs"),g=require("./primitive.cjs"),p=require("react/jsx-runtime"),[ie,x]=(0,E.createSafeContext)("Popper");function ae({children:e,updateRef:t}){let[r,a]=i.useState(null),o=i.useRef(null);return(0,p.jsx)(ie,{anchor:r,setAnchor:a,updateRef:t??o,children:e})}var C=i.forwardRef((e,t)=>{let r=x("PopperAnchor"),a=(0,h.useComposedRefs)(t,o=>r.setAnchor(o));return(0,p.jsx)(g.Primitive.div,{...e,ref:a})});C.displayName="PopperAnchor";function se(e,t){return t==="center"?e:`${e}-${t}`}var le={start:"0%",center:"50%",end:"100%"};function H(e,t,r){let{availableWidth:a,availableHeight:o,triggerWidth:c,side:l,align:d}=r,s=le[d],m=l==="top"||l==="bottom"?`${s} ${l==="top"?"100%":"0%"}`:`${l==="left"?"100%":"0%"} ${s}`;e.style.setProperty(`--skdx-${t}-available-width`,`${a}px`),e.style.setProperty(`--skdx-${t}-available-height`,`${o}px`),e.style.setProperty(`--skdx-${t}-trigger-width`,`${c}px`),e.style.setProperty(`--skdx-${t}-transform-origin`,m)}var $=i.createContext(null),O=i.forwardRef((e,t)=>{let{side:r="bottom",align:a="center",sideOffset:o=0,alignOffset:c=0,avoidCollisions:l=!0,collisionPadding:d=8,collisionBoundary:s,component:m,arrowPadding:L=0,hideWhenDetached:T=!1,style:W,...D}=e,R=x("PopperContent"),w=i.useRef(null),N=(0,f.useDirection)(),k=(0,f.resolveDirection)(R.anchor,N),u=s?{boundary:s}:{},{refs:I,floatingStyles:X,placement:Y,middlewareData:y,update:b}=(0,n.useFloating)({placement:se((0,f.resolvePhysicalSide)(r,k),a),whileElementsMounted:n.autoUpdate,elements:{reference:R.anchor},middleware:[(0,n.offset)({mainAxis:o,alignmentAxis:c}),...l?[(0,n.flip)({padding:d,...u}),(0,n.shift)({padding:d,limiter:(0,n.limitShift)(),...u})]:[],(0,n.size)({padding:d,...u,apply({availableWidth:G,availableHeight:U,elements:V,rects:_,placement:z}){if(!m)return;let[q,J="center"]=z.split("-");H(V.floating,m,{availableWidth:G,availableHeight:U,triggerWidth:_.reference.width,side:q,align:J})}}),(0,n.arrow)({element:w,padding:L}),...T?[(0,n.hide)({strategy:"referenceHidden",...u})]:[]]}),j=(0,h.useComposedRefs)(t,I.setFloating),[S,B="center"]=Y.split("-"),F=y.hide?.referenceHidden===!0,{updateRef:v}=R;return i.useEffect(()=>(v.current=b,()=>{v.current=null}),[v,b]),(0,p.jsx)($.Provider,{value:{arrowRef:w,arrowX:y.arrow?.x,arrowY:y.arrow?.y,side:S},children:(0,p.jsx)(g.Primitive.div,{"data-side":S,"data-align":B,...D,ref:j,style:{...X,...W,...F&&{visibility:"hidden",pointerEvents:"none"}}})})});O.displayName="PopperContent";var de={top:"bottom",right:"left",bottom:"top",left:"right"},M=i.forwardRef((e,t)=>{let r=i.useContext($);if(!r)throw new Error("[skandadx] PopperArrow must be used within PopperContent.");let{arrowRef:a,arrowX:o,arrowY:c,side:l}=r,d=(0,h.useComposedRefs)(t,a),s=de[l];return(0,p.jsx)(g.Primitive.span,{...e,ref:d,style:{position:"absolute",left:o!=null?`${o}px`:void 0,top:c!=null?`${c}px`:void 0,[s]:void 0,...s==="top"&&{top:0,transform:"translateY(-100%)"},...s==="bottom"&&{bottom:0,transform:"translateY(100%)"},...s==="left"&&{left:0,transform:"translateX(-100%)"},...s==="right"&&{right:0,transform:"translateX(100%)"},...e.style}})});M.displayName="PopperArrow";0&&(module.exports={PopperAnchor,PopperArrow,PopperContent,PopperRoot,setMeasurementProperties,usePopperContext});

package/dist/utils/popper.d.cts

@@ -19,11 +19,33 @@ export type Align = 'start' | 'center' | 'end';
 interface PopperContextValue {
     anchor: HTMLElement | null;
     setAnchor: (node: HTMLElement | null) => void;
+    /**
+     * Filled by {@link PopperContent} with floating-ui's manual reposition
+     * trigger while it is mounted, and emptied again on unmount.
+     *
+     * `autoUpdate` already re-runs on scroll, resize and an observed size change
+     * of either element. What it cannot see is the anchor *moving* for a reason
+     * the DOM does not report — a CSS transform finishing, a virtual list
+     * re-flowing its rows, a parent that repositioned without changing size — so
+     * a family that exposes a public `reposition()` needs a handle on the same
+     * update the observers call. A ref rather than state: it is written from an
+     * effect and read from an event handler, never rendered.
+     */
+    updateRef: React.RefObject<(() => void) | null>;
 }
 declare const usePopperContext: (consumerName: string) => PopperContextValue;
-/** @internal Provides the anchor element to descendant `Popper*` parts; wrap the anchor and content in one. */
-export declare function PopperRoot({ children }: {
+/**
+ * @internal Provides the anchor element to descendant `Popper*` parts; wrap the
+ * anchor and content in one.
+ *
+ * @param updateRef Optional ref the mounted {@link PopperContent}'s reposition
+ * trigger is published into, so a family root rendered *outside* this provider
+ * (every overlay root wraps its children in one) can still expose a public
+ * `reposition()`. Omit it and the root keeps a private one.
+ */
+export declare function PopperRoot({ children, updateRef, }: {
     children: React.ReactNode;
+    updateRef?: React.RefObject<(() => void) | null>;
 }): React.JSX.Element;
 /** @internal Marks its rendered element as the anchor that {@link PopperContent} positions against. */
 export declare const PopperAnchor: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"div">, "ref"> & React.RefAttributes<HTMLDivElement>>;
@@ -85,6 +107,29 @@ interface PopperOwnProps extends PopperContentProps {
      * @default undefined — an internal popper with no documented namespace writes no measurement properties at all.
      */
     component?: string;
+    /**
+     * Clearance in pixels kept between the arrow and each end of the panel's
+     * edge, so the arrow never overlaps a rounded corner. Fed straight to
+     * floating-ui's `arrow` middleware as its `padding`.
+     *
+     * Defaults to `0` — today's behaviour — rather than to the `8` Popover's
+     * public prop defaults to: every popper family shares this layer, and
+     * silently moving Tooltip's, HoverCard's and the menu families' arrows is not
+     * warranted. A family that wants clearance passes its own.
+     * @default 0
+     */
+    arrowPadding?: number;
+    /**
+     * Hide the panel while the anchor is fully clipped out of view by a scroll
+     * container, instead of leaving it floating over unrelated content.
+     *
+     * Off by default because the middleware costs an extra overflow measurement
+     * on every reposition and the failure it prevents only exists for an anchor
+     * inside a scrollable ancestor. Passed through from a family's public
+     * `hideWhenDetached`.
+     * @default false
+     */
+    hideWhenDetached?: boolean;
 }
 /**
  * Writes the four measurement custom properties onto the floating element

package/dist/utils/popper.d.ts

@@ -19,11 +19,33 @@ export type Align = 'start' | 'center' | 'end';
 interface PopperContextValue {
     anchor: HTMLElement | null;
     setAnchor: (node: HTMLElement | null) => void;
+    /**
+     * Filled by {@link PopperContent} with floating-ui's manual reposition
+     * trigger while it is mounted, and emptied again on unmount.
+     *
+     * `autoUpdate` already re-runs on scroll, resize and an observed size change
+     * of either element. What it cannot see is the anchor *moving* for a reason
+     * the DOM does not report — a CSS transform finishing, a virtual list
+     * re-flowing its rows, a parent that repositioned without changing size — so
+     * a family that exposes a public `reposition()` needs a handle on the same
+     * update the observers call. A ref rather than state: it is written from an
+     * effect and read from an event handler, never rendered.
+     */
+    updateRef: React.RefObject<(() => void) | null>;
 }
 declare const usePopperContext: (consumerName: string) => PopperContextValue;
-/** @internal Provides the anchor element to descendant `Popper*` parts; wrap the anchor and content in one. */
-export declare function PopperRoot({ children }: {
+/**
+ * @internal Provides the anchor element to descendant `Popper*` parts; wrap the
+ * anchor and content in one.
+ *
+ * @param updateRef Optional ref the mounted {@link PopperContent}'s reposition
+ * trigger is published into, so a family root rendered *outside* this provider
+ * (every overlay root wraps its children in one) can still expose a public
+ * `reposition()`. Omit it and the root keeps a private one.
+ */
+export declare function PopperRoot({ children, updateRef, }: {
     children: React.ReactNode;
+    updateRef?: React.RefObject<(() => void) | null>;
 }): React.JSX.Element;
 /** @internal Marks its rendered element as the anchor that {@link PopperContent} positions against. */
 export declare const PopperAnchor: React.ForwardRefExoticComponent<Omit<PrimitivePropsWithRef<"div">, "ref"> & React.RefAttributes<HTMLDivElement>>;
@@ -85,6 +107,29 @@ interface PopperOwnProps extends PopperContentProps {
      * @default undefined — an internal popper with no documented namespace writes no measurement properties at all.
      */
     component?: string;
+    /**
+     * Clearance in pixels kept between the arrow and each end of the panel's
+     * edge, so the arrow never overlaps a rounded corner. Fed straight to
+     * floating-ui's `arrow` middleware as its `padding`.
+     *
+     * Defaults to `0` — today's behaviour — rather than to the `8` Popover's
+     * public prop defaults to: every popper family shares this layer, and
+     * silently moving Tooltip's, HoverCard's and the menu families' arrows is not
+     * warranted. A family that wants clearance passes its own.
+     * @default 0
+     */
+    arrowPadding?: number;
+    /**
+     * Hide the panel while the anchor is fully clipped out of view by a scroll
+     * container, instead of leaving it floating over unrelated content.
+     *
+     * Off by default because the middleware costs an extra overflow measurement
+     * on every reposition and the failure it prevents only exists for an anchor
+     * inside a scrollable ancestor. Passed through from a family's public
+     * `hideWhenDetached`.
+     * @default false
+     */
+    hideWhenDetached?: boolean;
 }
 /**
  * Writes the four measurement custom properties onto the floating element

package/dist/utils/popper.js

@@ -1 +1 @@
-import{arrow as k,autoUpdate as I,flip as X,limitShift as Y,offset as B,shift as F,size as G,useFloating as V}from"@floating-ui/react-dom";import*as r from"react";import{useComposedRefs as f}from"./composeRefs.js";import{createSafeContext as _}from"./createContext.js";import{resolveDirection as z,resolvePhysicalSide as U,useDirection as j}from"./direction.js";import{Primitive as P}from"./primitive.js";import{jsx as d}from"react/jsx-runtime";var[q,x]=_("Popper");function le({children:e}){let[t,n]=r.useState(null);return d(q,{anchor:t,setAnchor:n,children:e})}var J=r.forwardRef((e,t)=>{let n=x("PopperAnchor"),s=f(t,i=>n.setAnchor(i));return d(P.div,{...e,ref:s})});J.displayName="PopperAnchor";function K(e,t){return t==="center"?e:`${e}-${t}`}var Q={start:"0%",center:"50%",end:"100%"};function Z(e,t,n){let{availableWidth:s,availableHeight:i,triggerWidth:p,side:a,align:l}=n,o=Q[l],c=a==="top"||a==="bottom"?`${o} ${a==="top"?"100%":"0%"}`:`${a==="left"?"100%":"0%"} ${o}`;e.style.setProperty(`--skdx-${t}-available-width`,`${s}px`),e.style.setProperty(`--skdx-${t}-available-height`,`${i}px`),e.style.setProperty(`--skdx-${t}-trigger-width`,`${p}px`),e.style.setProperty(`--skdx-${t}-transform-origin`,c)}var R=r.createContext(null),ee=r.forwardRef((e,t)=>{let{side:n="bottom",align:s="center",sideOffset:i=0,alignOffset:p=0,avoidCollisions:a=!0,collisionPadding:l=8,collisionBoundary:o,component:c,style:v,...w}=e,u=x("PopperContent"),h=r.useRef(null),b=j(),S=z(u.anchor,b),m=o?{boundary:o}:{},{refs:A,floatingStyles:C,placement:E,middlewareData:g}=V({placement:K(U(n,S),s),whileElementsMounted:I,elements:{reference:u.anchor},middleware:[B({mainAxis:i,alignmentAxis:p}),...a?[X({padding:l,...m}),F({padding:l,limiter:Y(),...m})]:[],G({padding:l,...m,apply({availableWidth:M,availableHeight:L,elements:O,rects:T,placement:W}){if(!c)return;let[D,N="center"]=W.split("-");Z(O.floating,c,{availableWidth:M,availableHeight:L,triggerWidth:T.reference.width,side:D,align:N})}}),k({element:h})]}),$=f(t,A.setFloating),[y,H="center"]=E.split("-");return d(R.Provider,{value:{arrowRef:h,arrowX:g.arrow?.x,arrowY:g.arrow?.y,side:y},children:d(P.div,{"data-side":y,"data-align":H,...w,ref:$,style:{...C,...v}})})});ee.displayName="PopperContent";var te={top:"bottom",right:"left",bottom:"top",left:"right"},re=r.forwardRef((e,t)=>{let n=r.useContext(R);if(!n)throw new Error("[skandadx] PopperArrow must be used within PopperContent.");let{arrowRef:s,arrowX:i,arrowY:p,side:a}=n,l=f(t,s),o=te[a];return d(P.span,{...e,ref:l,style:{position:"absolute",left:i!=null?`${i}px`:void 0,top:p!=null?`${p}px`:void 0,[o]:void 0,...o==="top"&&{top:0,transform:"translateY(-100%)"},...o==="bottom"&&{bottom:0,transform:"translateY(100%)"},...o==="left"&&{left:0,transform:"translateX(-100%)"},...o==="right"&&{right:0,transform:"translateX(100%)"},...e.style}})});re.displayName="PopperArrow";export{J as PopperAnchor,re as PopperArrow,ee as PopperContent,le as PopperRoot,Z as setMeasurementProperties,x as usePopperContext};
+import{arrow as B,autoUpdate as F,flip as G,hide as U,limitShift as V,offset as _,shift as z,size as q,useFloating as J}from"@floating-ui/react-dom";import*as r from"react";import{useComposedRefs as h}from"./composeRefs.js";import{createSafeContext as K}from"./createContext.js";import{resolveDirection as Q,resolvePhysicalSide as Z,useDirection as ee}from"./direction.js";import{Primitive as g}from"./primitive.js";import{jsx as c}from"react/jsx-runtime";var[te,x]=K("Popper");function ue({children:e,updateRef:t}){let[o,a]=r.useState(null),i=r.useRef(null);return c(te,{anchor:o,setAnchor:a,updateRef:t??i,children:e})}var re=r.forwardRef((e,t)=>{let o=x("PopperAnchor"),a=h(t,i=>o.setAnchor(i));return c(g.div,{...e,ref:a})});re.displayName="PopperAnchor";function ne(e,t){return t==="center"?e:`${e}-${t}`}var oe={start:"0%",center:"50%",end:"100%"};function ie(e,t,o){let{availableWidth:a,availableHeight:i,triggerWidth:d,side:s,align:l}=o,n=oe[l],p=s==="top"||s==="bottom"?`${n} ${s==="top"?"100%":"0%"}`:`${s==="left"?"100%":"0%"} ${n}`;e.style.setProperty(`--skdx-${t}-available-width`,`${a}px`),e.style.setProperty(`--skdx-${t}-available-height`,`${i}px`),e.style.setProperty(`--skdx-${t}-trigger-width`,`${d}px`),e.style.setProperty(`--skdx-${t}-transform-origin`,p)}var w=r.createContext(null),ae=r.forwardRef((e,t)=>{let{side:o="bottom",align:a="center",sideOffset:i=0,alignOffset:d=0,avoidCollisions:s=!0,collisionPadding:l=8,collisionBoundary:n,component:p,arrowPadding:b=0,hideWhenDetached:S=!1,style:A,...E}=e,m=x("PopperContent"),R=r.useRef(null),C=ee(),H=Q(m.anchor,C),f=n?{boundary:n}:{},{refs:$,floatingStyles:O,placement:M,middlewareData:u,update:y}=J({placement:ne(Z(o,H),a),whileElementsMounted:F,elements:{reference:m.anchor},middleware:[_({mainAxis:i,alignmentAxis:d}),...s?[G({padding:l,...f}),z({padding:l,limiter:V(),...f})]:[],q({padding:l,...f,apply({availableWidth:D,availableHeight:N,elements:k,rects:I,placement:X}){if(!p)return;let[Y,j="center"]=X.split("-");ie(k.floating,p,{availableWidth:D,availableHeight:N,triggerWidth:I.reference.width,side:Y,align:j})}}),B({element:R,padding:b}),...S?[U({strategy:"referenceHidden",...f})]:[]]}),L=h(t,$.setFloating),[v,T="center"]=M.split("-"),W=u.hide?.referenceHidden===!0,{updateRef:P}=m;return r.useEffect(()=>(P.current=y,()=>{P.current=null}),[P,y]),c(w.Provider,{value:{arrowRef:R,arrowX:u.arrow?.x,arrowY:u.arrow?.y,side:v},children:c(g.div,{"data-side":v,"data-align":T,...E,ref:L,style:{...O,...A,...W&&{visibility:"hidden",pointerEvents:"none"}}})})});ae.displayName="PopperContent";var se={top:"bottom",right:"left",bottom:"top",left:"right"},le=r.forwardRef((e,t)=>{let o=r.useContext(w);if(!o)throw new Error("[skandadx] PopperArrow must be used within PopperContent.");let{arrowRef:a,arrowX:i,arrowY:d,side:s}=o,l=h(t,a),n=se[s];return c(g.span,{...e,ref:l,style:{position:"absolute",left:i!=null?`${i}px`:void 0,top:d!=null?`${d}px`:void 0,[n]:void 0,...n==="top"&&{top:0,transform:"translateY(-100%)"},...n==="bottom"&&{bottom:0,transform:"translateY(100%)"},...n==="left"&&{left:0,transform:"translateX(-100%)"},...n==="right"&&{right:0,transform:"translateX(100%)"},...e.style}})});le.displayName="PopperArrow";export{re as PopperAnchor,le as PopperArrow,ae as PopperContent,ue as PopperRoot,ie as setMeasurementProperties,x as usePopperContext};

package/dist/utils/portal.d.cts

@@ -9,10 +9,9 @@ export interface PortalProps extends PrimitivePropsWithRef<'div'> {
     container?: Element | DocumentFragment | null;
 }
 /**
- * Renders its children into a different part of the DOM (via `ReactDOM.createPortal`) —
- * used by overlay content (`Dialog`, `Popover`, `Tooltip`, …) to escape clipping/`overflow:
- * hidden` ancestors and sit above everything in stacking order. SSR-safe: renders nothing
- * until mounted on the client, since `document` doesn't exist on the server.
+ * Teleports children to a different DOM location via `ReactDOM.createPortal`.
+ * Used by overlay content to escape clipping and sit above everything.
+ * SSR-safe: renders nothing until mounted on the client.
  *
  * @example
  * ```tsx

package/dist/utils/portal.d.ts

@@ -9,10 +9,9 @@ export interface PortalProps extends PrimitivePropsWithRef<'div'> {
     container?: Element | DocumentFragment | null;
 }
 /**
- * Renders its children into a different part of the DOM (via `ReactDOM.createPortal`) —
- * used by overlay content (`Dialog`, `Popover`, `Tooltip`, …) to escape clipping/`overflow:
- * hidden` ancestors and sit above everything in stacking order. SSR-safe: renders nothing
- * until mounted on the client, since `document` doesn't exist on the server.
+ * Teleports children to a different DOM location via `ReactDOM.createPortal`.
+ * Used by overlay content to escape clipping and sit above everything.
+ * SSR-safe: renders nothing until mounted on the client.
  *
  * @example
  * ```tsx

package/dist/utils/presence.cjs

@@ -1 +1 @@
-"use strict";var E=Object.create;var c=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,L=Object.prototype.hasOwnProperty;var P=(e,n)=>{for(var t in n)c(e,t,{get:n[t],enumerable:!0})},l=(e,n,t,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of p(n))!L.call(e,o)&&o!==t&&c(e,o,{get:()=>n[o],enumerable:!(a=R(n,o))||a.enumerable});return e};var b=(e,n,t)=>(t=e!=null?E(v(e)):{},l(n||!e||!e.__esModule?c(t,"default",{value:e,enumerable:!0}):t,e)),M=e=>l(c({},"__esModule",{value:!0}),e);var g={};P(g,{Presence:()=>m,usePresence:()=>u});module.exports=M(g);var r=b(require("react"),1),s=require("./slot.cjs"),d=require("react/jsx-runtime");function S(e){let{animationName:n,display:t}=getComputedStyle(e);return n!==""&&n!=="none"&&t!=="none"}function u(e,n){let[t,a]=r.useState(e);return r.useEffect(()=>{if(e){a(!0);return}let o=n.current;if(!o||!S(o)){a(!1);return}let i=f=>{f.target===o&&a(!1)};return o.addEventListener("animationend",i),o.addEventListener("animationcancel",i),()=>{o.removeEventListener("animationend",i),o.removeEventListener("animationcancel",i)}},[e,n]),t}function m({present:e,children:n}){let t=r.useRef(null);return u(e,t)?(0,d.jsx)(s.Slot,{ref:t,children:n}):null}m.displayName="Presence";0&&(module.exports={Presence,usePresence});
+"use strict";var E=Object.create;var c=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,L=Object.prototype.hasOwnProperty;var P=(e,n)=>{for(var t in n)c(e,t,{get:n[t],enumerable:!0})},l=(e,n,t,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of p(n))!L.call(e,o)&&o!==t&&c(e,o,{get:()=>n[o],enumerable:!(a=R(n,o))||a.enumerable});return e};var b=(e,n,t)=>(t=e!=null?E(v(e)):{},l(n||!e||!e.__esModule?c(t,"default",{value:e,enumerable:!0}):t,e)),M=e=>l(c({},"__esModule",{value:!0}),e);var g={};P(g,{Presence:()=>m,usePresence:()=>u});module.exports=M(g);var r=b(require("react"),1),s=require("./slot.cjs"),d=require("react/jsx-runtime");function S(e){let{animationName:n,display:t}=getComputedStyle(e);return n!==""&&n!=="none"&&t!=="none"}function u(e,n){let[t,a]=r.useState(e);return e&&!t&&a(!0),r.useEffect(()=>{if(e)return;let o=n.current;if(!o||!S(o)){a(!1);return}let i=f=>{f.target===o&&a(!1)};return o.addEventListener("animationend",i),o.addEventListener("animationcancel",i),()=>{o.removeEventListener("animationend",i),o.removeEventListener("animationcancel",i)}},[e,n]),t}function m({present:e,children:n}){let t=r.useRef(null);return u(e,t)?(0,d.jsx)(s.Slot,{ref:t,children:n}):null}m.displayName="Presence";0&&(module.exports={Presence,usePresence});

package/dist/utils/presence.js

@@ -1 +1 @@
-import*as a from"react";import{Slot as l}from"./slot.js";import{jsx as d}from"react/jsx-runtime";function s(e){let{animationName:n,display:o}=getComputedStyle(e);return n!==""&&n!=="none"&&o!=="none"}function u(e,n){let[o,r]=a.useState(e);return a.useEffect(()=>{if(e){r(!0);return}let t=n.current;if(!t||!s(t)){r(!1);return}let i=c=>{c.target===t&&r(!1)};return t.addEventListener("animationend",i),t.addEventListener("animationcancel",i),()=>{t.removeEventListener("animationend",i),t.removeEventListener("animationcancel",i)}},[e,n]),o}function m({present:e,children:n}){let o=a.useRef(null);return u(e,o)?d(l,{ref:o,children:n}):null}m.displayName="Presence";export{m as Presence,u as usePresence};
+import*as a from"react";import{Slot as l}from"./slot.js";import{jsx as d}from"react/jsx-runtime";function s(e){let{animationName:n,display:t}=getComputedStyle(e);return n!==""&&n!=="none"&&t!=="none"}function u(e,n){let[t,r]=a.useState(e);return e&&!t&&r(!0),a.useEffect(()=>{if(e)return;let o=n.current;if(!o||!s(o)){r(!1);return}let i=c=>{c.target===o&&r(!1)};return o.addEventListener("animationend",i),o.addEventListener("animationcancel",i),()=>{o.removeEventListener("animationend",i),o.removeEventListener("animationcancel",i)}},[e,n]),t}function m({present:e,children:n}){let t=a.useRef(null);return u(e,t)?d(l,{ref:t,children:n}):null}m.displayName="Presence";export{m as Presence,u as usePresence};

package/dist/utils/primitive.cjs

@@ -1 +1 @@
-"use strict";var l=Object.create;var n=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var E=Object.getPrototypeOf,R=Object.prototype.hasOwnProperty;var P=(e,t)=>{for(var o in t)n(e,o,{get:t[o],enumerable:!0})},a=(e,t,o,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of v(t))!R.call(e,i)&&i!==o&&n(e,i,{get:()=>t[i],enumerable:!(r=c(t,i))||r.enumerable});return e};var u=(e,t,o)=>(o=e!=null?l(E(e)):{},a(t||!e||!e.__esModule?n(o,"default",{value:e,enumerable:!0}):o,e)),h=e=>a(n({},"__esModule",{value:!0}),e);var C={};P(C,{Primitive:()=>b,composeEventHandlers:()=>x});module.exports=h(C);var p=u(require("react"),1),d=require("./slot.cjs"),m=require("react/jsx-runtime"),y=["a","button","caption","div","fieldset","form","h2","h3","img","input","kbd","label","legend","li","nav","ol","p","span","svg","table","tbody","td","textarea","tfoot","th","thead","tr","ul"],b=y.reduce((e,t)=>{let o=p.forwardRef((r,i)=>{let{asChild:s,...f}=r;return(0,m.jsx)(s?d.Slot:t,{...f,ref:i})});return o.displayName=`Primitive.${t}`,{...e,[t]:o}},{});function x(e,t,{checkForDefaultPrevented:o=!0}={}){return function(i){if(e?.(i),!o||!i.defaultPrevented)return t?.(i)}}0&&(module.exports={Primitive,composeEventHandlers});
+"use strict";var h=Object.create;var n=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var E=Object.getPrototypeOf,P=Object.prototype.hasOwnProperty;var R=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})},p=(e,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of v(t))!P.call(e,o)&&o!==r&&n(e,o,{get:()=>t[o],enumerable:!(i=u(t,o))||i.enumerable});return e};var g=(e,t,r)=>(r=e!=null?h(E(e)):{},p(t||!e||!e.__esModule?n(r,"default",{value:e,enumerable:!0}):r,e)),y=e=>p(n({},"__esModule",{value:!0}),e);var w={};R(w,{Primitive:()=>x,composeEventHandlers:()=>C});module.exports=y(w);var s=g(require("react"),1),m=require("./slot.cjs"),f=require("react/jsx-runtime"),b=["a","article","aside","footer","header","main","nav","section","blockquote","button","caption","code","div","dd","dl","dt","em","fieldset","figcaption","figure","form","h1","h2","h3","h4","h5","h6","hr","img","input","kbd","label","legend","li","ol","p","pre","small","span","strong","svg","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul"],x=b.reduce((e,t)=>{let r=s.forwardRef((i,o)=>{let{asChild:l,...d}=i,c=l?m.Slot:t;if(t==="a"){let a=d;a.target==="_blank"&&a.rel===void 0&&(a.rel="noopener noreferrer")}return(0,f.jsx)(c,{...d,ref:o})});return r.displayName=`Primitive.${t}`,{...e,[t]:r}},{});function C(e,t,{checkForDefaultPrevented:r=!0}={}){return function(o){if(e?.(o),!r||!o.defaultPrevented)return t?.(o)}}0&&(module.exports={Primitive,composeEventHandlers});

package/dist/utils/primitive.d.cts

@@ -1,8 +1,14 @@
 import * as React from 'react';
-declare const NODES: readonly ["a", "button", "caption", "div", "fieldset", "form", "h2", "h3", "img", "input", "kbd", "label", "legend", "li", "nav", "ol", "p", "span", "svg", "table", "tbody", "td", "textarea", "tfoot", "th", "thead", "tr", "ul"];
+declare const NODES: readonly ["a", "article", "aside", "footer", "header", "main", "nav", "section", "blockquote", "button", "caption", "code", "div", "dd", "dl", "dt", "em", "fieldset", "figcaption", "figure", "form", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "img", "input", "kbd", "label", "legend", "li", "ol", "p", "pre", "small", "span", "strong", "svg", "table", "tbody", "td", "textarea", "tfoot", "th", "thead", "time", "tr", "ul"];
 type Primitives = {
     [E in (typeof NODES)[number]]: PrimitiveForwardRefComponent<E>;
 };
+/**
+ * The tag names an `as` prop accepts: `NODES` minus the void and replaced
+ * elements, none of which can carry a part's children. Mirrors the
+ * `POLYMORPHIC_TAGS` contract the parity gates read.
+ */
+export type PolymorphicTag = Exclude<(typeof NODES)[number], 'hr' | 'img' | 'input' | 'svg' | 'textarea'>;
 /** Props of the intrinsic element `E` plus `asChild`; the base prop type every {@link Primitive} part (and component props extending it) is built from. */
 export type PrimitivePropsWithRef<E extends React.ElementType> = React.ComponentPropsWithRef<E> & {
     /**

package/dist/utils/primitive.d.ts

@@ -1,8 +1,14 @@
 import * as React from 'react';
-declare const NODES: readonly ["a", "button", "caption", "div", "fieldset", "form", "h2", "h3", "img", "input", "kbd", "label", "legend", "li", "nav", "ol", "p", "span", "svg", "table", "tbody", "td", "textarea", "tfoot", "th", "thead", "tr", "ul"];
+declare const NODES: readonly ["a", "article", "aside", "footer", "header", "main", "nav", "section", "blockquote", "button", "caption", "code", "div", "dd", "dl", "dt", "em", "fieldset", "figcaption", "figure", "form", "h1", "h2", "h3", "h4", "h5", "h6", "hr", "img", "input", "kbd", "label", "legend", "li", "ol", "p", "pre", "small", "span", "strong", "svg", "table", "tbody", "td", "textarea", "tfoot", "th", "thead", "time", "tr", "ul"];
 type Primitives = {
     [E in (typeof NODES)[number]]: PrimitiveForwardRefComponent<E>;
 };
+/**
+ * The tag names an `as` prop accepts: `NODES` minus the void and replaced
+ * elements, none of which can carry a part's children. Mirrors the
+ * `POLYMORPHIC_TAGS` contract the parity gates read.
+ */
+export type PolymorphicTag = Exclude<(typeof NODES)[number], 'hr' | 'img' | 'input' | 'svg' | 'textarea'>;
 /** Props of the intrinsic element `E` plus `asChild`; the base prop type every {@link Primitive} part (and component props extending it) is built from. */
 export type PrimitivePropsWithRef<E extends React.ElementType> = React.ComponentPropsWithRef<E> & {
     /**

package/dist/utils/primitive.js

@@ -1 +1 @@
-import*as n from"react";import{Slot as d}from"./slot.js";import{jsx as s}from"react/jsx-runtime";var m=["a","button","caption","div","fieldset","form","h2","h3","img","input","kbd","label","legend","li","nav","ol","p","span","svg","table","tbody","td","textarea","tfoot","th","thead","tr","ul"],c=m.reduce((i,e)=>{let o=n.forwardRef((r,t)=>{let{asChild:a,...p}=r;return s(a?d:e,{...p,ref:t})});return o.displayName=`Primitive.${e}`,{...i,[e]:o}},{});function v(i,e,{checkForDefaultPrevented:o=!0}={}){return function(t){if(i?.(t),!o||!t.defaultPrevented)return e?.(t)}}export{c as Primitive,v as composeEventHandlers};
+import*as d from"react";import{Slot as m}from"./slot.js";import{jsx as l}from"react/jsx-runtime";var f=["a","article","aside","footer","header","main","nav","section","blockquote","button","caption","code","div","dd","dl","dt","em","fieldset","figcaption","figure","form","h1","h2","h3","h4","h5","h6","hr","img","input","kbd","label","legend","li","ol","p","pre","small","span","strong","svg","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul"],h=f.reduce((o,e)=>{let r=d.forwardRef((n,t)=>{let{asChild:p,...a}=n,s=p?m:e;if(e==="a"){let i=a;i.target==="_blank"&&i.rel===void 0&&(i.rel="noopener noreferrer")}return l(s,{...a,ref:t})});return r.displayName=`Primitive.${e}`,{...o,[e]:r}},{});function u(o,e,{checkForDefaultPrevented:r=!0}={}){return function(t){if(o?.(t),!r||!t.defaultPrevented)return e?.(t)}}export{h as Primitive,u as composeEventHandlers};

package/dist/utils/resolveSpace.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(e,n)=>{for(var t in n)d(e,t,{get:n[t],enumerable:!0})},S=(e,n,t,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of s(n))!c.call(e,r)&&r!==t&&d(e,r,{get:()=>n[r],enumerable:!(i=p(n,r))||i.enumerable});return e};var o=e=>S(d({},"__esModule",{value:!0}),e);var x={};f(x,{resolveSpace:()=>a});module.exports=o(x);var u=new Set(["1","2","3","4","5","6","8","10","12","16"]);function a(e){if(e!==void 0)return u.has(e)?`var(--skdx-space-${e})`:e}0&&(module.exports={resolveSpace});

package/dist/utils/resolveSpace.d.cts

@@ -0,0 +1,4 @@
+/** A spacing-scale token key, or any other string passed through as a raw CSS length. */
+export type Space = '1' | '2' | '3' | '4' | '5' | '6' | '8' | '10' | '12' | '16' | (string & {});
+/** A scale key resolves to its token (`var(--skdx-space-<key>)`); anything else passes through verbatim. */
+export declare function resolveSpace(value: Space | undefined): string | undefined;

package/dist/utils/resolveSpace.d.ts

@@ -0,0 +1,4 @@
+/** A spacing-scale token key, or any other string passed through as a raw CSS length. */
+export type Space = '1' | '2' | '3' | '4' | '5' | '6' | '8' | '10' | '12' | '16' | (string & {});
+/** A scale key resolves to its token (`var(--skdx-space-<key>)`); anything else passes through verbatim. */
+export declare function resolveSpace(value: Space | undefined): string | undefined;

package/dist/utils/resolveSpace.js

@@ -0,0 +1 @@
+var n=new Set(["1","2","3","4","5","6","8","10","12","16"]);function r(e){if(e!==void 0)return n.has(e)?`var(--skdx-space-${e})`:e}export{r as resolveSpace};

package/dist/utils/scoredFilter.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var a=(e,r)=>{for(var n in r)s(e,n,{get:r[n],enumerable:!0})},p=(e,r,n,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of c(r))!d.call(e,t)&&t!==n&&s(e,t,{get:()=>r[t],enumerable:!(u=i(r,t))||u.enumerable});return e};var f=e=>p(s({},"__esModule",{value:!0}),e);var m={};a(m,{filterKeeps:()=>y,rankByScore:()=>T,sortByOrder:()=>b});module.exports=f(m);function y(e){return typeof e=="number"?e>0:e}function T(e,r){let n=e.map((o,l)=>({id:o,score:r(o),index:l}));if(!n.some(o=>o.score!==null))return null;let u=[...n].sort((o,l)=>(l.score??0)-(o.score??0)||o.index-l.index),t=new Map;return u.forEach((o,l)=>t.set(o.id,l)),t}function b(e,r){return r?[...e].sort((n,u)=>(r.get(n.id)??0)-(r.get(u.id)??0)):[...e]}0&&(module.exports={filterKeeps,rankByScore,sortByOrder});

package/dist/utils/scoredFilter.d.cts

@@ -0,0 +1,31 @@
+/**
+ * The `boolean | number` filter predicate shared by Command, Combobox,
+ * Autocomplete and MultiSelect: a plain boolean keeps/excludes only; a
+ * number both filters and ranks.
+ */
+export type ScoredFilterResult = boolean | number;
+/**
+ * Whether a {@link ScoredFilterResult} keeps the item: `0` and `false`
+ * exclude, `true` and any positive number keep. A negative number excludes
+ * too — the contract only promises a positive score keeps, so treating a
+ * negative one as a rejection (rather than JS's own truthiness, which would
+ * keep it) is the conservative reading.
+ */
+export declare function filterKeeps(result: ScoredFilterResult): boolean;
+/**
+ * Ranks `ids` by descending score. `scoreOf` returns a number to rank, or
+ * `null` to skip (sorted as `0`, tie-broken by position).
+ *
+ * @returns rank map (`0` = first) or `null` when nothing scored.
+ */
+export declare function rankByScore<T>(ids: readonly T[], scoreOf: (id: T) => number | null): ReadonlyMap<T, number> | null;
+/**
+ * Sorts DOM elements by the rank {@link rankByScore} assigned their `id` —
+ * the traversal-order half of scored ranking, read by arrow keys, typeahead and
+ * `aria-activedescendant` instead of the elements' own DOM order. `null`
+ * order (no numeric score anywhere) is a no-op: elements come back exactly as
+ * given.
+ */
+export declare function sortByOrder<T extends {
+    id: string;
+}>(elements: readonly T[], order: ReadonlyMap<string, number> | null): T[];

package/dist/utils/scoredFilter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The `boolean | number` filter predicate shared by Command, Combobox,
+ * Autocomplete and MultiSelect: a plain boolean keeps/excludes only; a
+ * number both filters and ranks.
+ */
+export type ScoredFilterResult = boolean | number;
+/**
+ * Whether a {@link ScoredFilterResult} keeps the item: `0` and `false`
+ * exclude, `true` and any positive number keep. A negative number excludes
+ * too — the contract only promises a positive score keeps, so treating a
+ * negative one as a rejection (rather than JS's own truthiness, which would
+ * keep it) is the conservative reading.
+ */
+export declare function filterKeeps(result: ScoredFilterResult): boolean;
+/**
+ * Ranks `ids` by descending score. `scoreOf` returns a number to rank, or
+ * `null` to skip (sorted as `0`, tie-broken by position).
+ *
+ * @returns rank map (`0` = first) or `null` when nothing scored.
+ */
+export declare function rankByScore<T>(ids: readonly T[], scoreOf: (id: T) => number | null): ReadonlyMap<T, number> | null;
+/**
+ * Sorts DOM elements by the rank {@link rankByScore} assigned their `id` —
+ * the traversal-order half of scored ranking, read by arrow keys, typeahead and
+ * `aria-activedescendant` instead of the elements' own DOM order. `null`
+ * order (no numeric score anywhere) is a no-op: elements come back exactly as
+ * given.
+ */
+export declare function sortByOrder<T extends {
+    id: string;
+}>(elements: readonly T[], order: ReadonlyMap<string, number> | null): T[];

package/dist/utils/scoredFilter.js

@@ -0,0 +1 @@
+function s(r){return typeof r=="number"?r>0:r}function i(r,o){let t=r.map((e,n)=>({id:e,score:o(e),index:n}));if(!t.some(e=>e.score!==null))return null;let u=[...t].sort((e,n)=>(n.score??0)-(e.score??0)||e.index-n.index),l=new Map;return u.forEach((e,n)=>l.set(e.id,n)),l}function c(r,o){return o?[...r].sort((t,u)=>(o.get(t.id)??0)-(o.get(u.id)??0)):[...r]}export{s as filterKeeps,i as rankByScore,c as sortByOrder};

package/dist/utils/segmentedField.cjs

@@ -1 +1 @@
-"use strict";var X=Object.create;var b=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var J=Object.getPrototypeOf,Q=Object.prototype.hasOwnProperty;var Z=(t,n)=>{for(var i in n)b(t,i,{get:n[i],enumerable:!0})},A=(t,n,i,g)=>{if(n&&typeof n=="object"||typeof n=="function")for(let u of z(n))!Q.call(t,u)&&u!==i&&b(t,u,{get:()=>n[u],enumerable:!(g=Y(n,u))||g.enumerable});return t};var j=(t,n,i)=>(i=t!=null?X(J(t)):{},A(n||!t||!t.__esModule?b(i,"default",{value:t,enumerable:!0}):i,t)),ee=t=>A(b({},"__esModule",{value:!0}),t);var re={};Z(re,{EMPTY_VALUE_TEXT:()=>I,SEGMENT_LABELS:()=>C,SegmentedField:()=>q});module.exports=ee(re);var o=j(require("react"),1),H=require("../field/Field.cjs"),l=require("./dateSegments.cjs"),M=require("./direction.cjs"),T=require("./formControl.cjs"),F=require("./hiddenInput.cjs"),R=require("./part.cjs"),V=require("./primitive.cjs"),p=require("react/jsx-runtime"),I="Empty",C={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function te(t){return t?Array.from(t.querySelectorAll('[role="spinbutton"][data-segment]')):[]}var q=o.forwardRef(({family:t,kind:n,granularity:i,locale:g,hourCycle:u,values:x,onValuesChange:_,formValue:K,disabled:y=!1,readOnly:h=!1,invalid:w=!1,required:k=!1,name:L,dir:v,getSegmentLabel:N,emptySegmentText:U=I,onFormReset:B,...G},O)=>{let W=(0,l.buildSegments)({kind:n,granularity:i,locale:g,hourCycle:u,values:x}),d=o.useRef(0),S=o.useRef(null),D=o.useRef(null);(0,T.useFormValidityHandle)(O,S,D),(0,T.useFormReset)(S,()=>B?.());let E=o.useRef(!1);o.useEffect(()=>{E.current&&(E.current=!1,S.current?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0})))});let c=(e,a)=>{if(h)return;let r={...x,[e]:a};(e==="month"||e==="year")&&r.day!=null&&(r.day=Math.min(r.day,(0,l.daysInMonth)(r.year,r.month))),E.current=!0,_(r)},P=(e,a)=>{let r=te(e.parentElement),f=r.indexOf(e),m=r[f+a];m&&(d.current=0,m.focus())},$=(e,a)=>{let r=a.type,f=e.currentTarget,m=(0,M.directionalKey)(e.key,f,v);if(m==="ArrowLeft"||m==="ArrowRight"){e.preventDefault(),P(f,m==="ArrowRight"?1:-1);return}if(!h){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),d.current=0,c(r,(0,l.stepSegment)(a,e.key==="ArrowUp"?1:-1));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),d.current=0,c(r,e.key==="Home"?a.min:a.max);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),d.current=0,c(r,null);return}if(r==="dayPeriod"){let s=e.key.toLowerCase();(s==="a"||s==="p")&&(e.preventDefault(),c(r,s==="a"?0:1));return}if(/^\d$/.test(e.key)){e.preventDefault();let s=(0,l.typeDigit)(a,d.current,Number(e.key));d.current=s.buffer,c(r,s.value),s.advance&&P(f,1)}}};return(0,p.jsxs)(V.Primitive.div,{role:"group",[H.FIELD_CONTROL_ATTRIBUTE]:"","aria-disabled":y?!0:void 0,"aria-invalid":w?!0:void 0,"data-disabled":y?"":void 0,"data-readonly":h?"":void 0,"data-invalid":w?"":void 0,dir:v,...G,ref:S,children:[W.map((e,a)=>e.isEditable?(0,p.jsx)("span",{role:"spinbutton",tabIndex:y?-1:0,"aria-label":(N??(r=>C[r]))(e.type),"aria-valuenow":e.value??e.min,"aria-valuemin":e.min,"aria-valuemax":e.max,"aria-valuetext":e.isPlaceholder?U:e.text,"aria-disabled":y?!0:void 0,"aria-readonly":h?!0:void 0,"aria-required":k?!0:void 0,"data-segment":e.type,"data-placeholder":e.isPlaceholder?"":void 0,...(0,R.skdxPart)(t,"segment"),onKeyDown:r=>$(r,e),onFocus:()=>{d.current=0},children:e.text},e.type):(0,p.jsx)("span",{"aria-hidden":"true","data-segment":"literal",...(0,R.skdxPart)(t,"segment"),children:e.text},`literal-${a}`)),L?(0,p.jsx)(F.HiddenInput,{ref:D,type:"text",name:L,value:K??"",required:k,disabled:y}):null]})});q.displayName="SegmentedField";0&&(module.exports={EMPTY_VALUE_TEXT,SEGMENT_LABELS,SegmentedField});
+"use strict";var ae=Object.create;var b=Object.defineProperty;var ie=Object.getOwnPropertyDescriptor;var oe=Object.getOwnPropertyNames;var le=Object.getPrototypeOf,ue=Object.prototype.hasOwnProperty;var de=(t,i)=>{for(var l in i)b(t,l,{get:i[l],enumerable:!0})},C=(t,i,l,y)=>{if(i&&typeof i=="object"||typeof i=="function")for(let s of oe(i))!ue.call(t,s)&&s!==l&&b(t,s,{get:()=>i[s],enumerable:!(y=ie(i,s))||y.enumerable});return t};var se=(t,i,l)=>(l=t!=null?ae(le(t)):{},C(i||!t||!t.__esModule?b(l,"default",{value:t,enumerable:!0}):l,t)),me=t=>C(b({},"__esModule",{value:!0}),t);var ce={};de(ce,{EMPTY_VALUE_TEXT:()=>U,SEGMENT_LABELS:()=>B,SegmentedField:()=>G});module.exports=me(ce);var o=se(require("react"),1),q=require("../field/Field.cjs"),a=require("./dateSegments.cjs"),K=require("./direction.cjs"),R=require("./formControl.cjs"),N=require("./hiddenInput.cjs"),x=require("./part.cjs"),_=require("./primitive.cjs"),d=require("react/jsx-runtime"),U="Empty",B={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function pe(t){return t?Array.from(t.querySelectorAll('[role="spinbutton"][data-segment]')):[]}var G=o.forwardRef(({family:t,kind:i,granularity:l,locale:y,hourCycle:s,values:P,shouldForceLeadingZeros:O=!0,step:v,onValuesChange:W,formValue:$,formType:X,formMin:Y,formMax:Z,clampEdgeValues:w,disabled:f=!1,readOnly:h=!1,invalid:k=!1,required:T=!1,name:L,form:D,dir:M,getSegmentLabel:z,emptySegmentText:J=U,getSegmentPlaceholder:Q,onFormReset:j,asChild:A,children:F,...ee},te)=>{let re=(0,a.buildSegments)({kind:i,granularity:l,locale:y,hourCycle:s,values:P,getSegmentPlaceholder:Q,shouldForceLeadingZeros:O}),m=o.useRef(0),S=o.useRef(null),H=o.useRef(null);(0,R.useFormValidityHandle)(te,S,H),(0,R.useFormReset)(S,()=>j?.(),D);let E=o.useRef(!1);o.useEffect(()=>{E.current&&(E.current=!1,S.current?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0})))});let g=(e,u,r=!1)=>{if(h)return;let n={...P,[e]:u};(e==="month"||e==="year")&&n.day!=null&&(n.day=Math.min(n.day,(0,a.daysInMonth)(n.year,n.month))),r&&w&&(n=w(n)),E.current=!0,W(n)},V=(e,u)=>{let r=pe(e.parentElement),n=r.indexOf(e),p=r[n+u];p&&(m.current=0,p.focus())},ne=(e,u)=>{let r=u.type,n=e.currentTarget,p=(0,K.directionalKey)(e.key,n,M);if(p==="ArrowLeft"||p==="ArrowRight"){e.preventDefault(),V(n,p==="ArrowRight"?1:-1);return}if(!h){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),m.current=0,g(r,(0,a.stepSegment)(u,e.key==="ArrowUp"?1:-1,(0,a.segmentStepFor)(r,l,v)));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),m.current=0,g(r,e.key==="Home"?u.min:u.max,!0);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),m.current=0,g(r,null);return}if(r==="dayPeriod"){let c=(0,a.dayPeriodFromKey)(e.key,y);c!==null&&(e.preventDefault(),g(r,c));return}if(/^\d$/.test(e.key)){e.preventDefault();let c=(0,a.typeDigit)(u,m.current,Number(e.key));m.current=c.buffer,g(r,c.value),c.advance&&V(n,1)}}},I=(0,d.jsxs)(d.Fragment,{children:[re.map((e,u)=>e.isEditable?(0,d.jsx)("span",{role:"spinbutton",tabIndex:f?-1:0,"aria-label":(z??(r=>B[r]))(e.type),"aria-valuenow":(0,a.segmentValueNow)(e),"aria-valuemin":e.min,"aria-valuemax":e.max,"aria-valuetext":e.isPlaceholder?J:e.text,"aria-disabled":f?!0:void 0,"aria-readonly":h?!0:void 0,"aria-required":T?!0:void 0,"data-segment":e.type,"data-placeholder":e.isPlaceholder?"":void 0,...(0,x.skdxPart)(t,"segment"),onKeyDown:r=>ne(r,e),onFocus:()=>{m.current=0},children:e.text},e.type):(0,d.jsx)("span",{"aria-hidden":"true","data-segment":"literal",...(0,x.skdxPart)(t,"segment"),children:e.text},`literal-${u}`)),L||T?(0,d.jsx)(N.HiddenInput,{ref:H,type:X,min:Y,max:Z,step:v,name:L,value:$??"",required:T,disabled:f,form:D}):null]});return(0,d.jsx)(_.Primitive.div,{role:"group",[q.FIELD_CONTROL_ATTRIBUTE]:"","aria-disabled":f?!0:void 0,"aria-invalid":k?!0:void 0,"data-disabled":f?"":void 0,"data-readonly":h?"":void 0,"data-invalid":k?"":void 0,dir:M,...ee,asChild:A,ref:S,children:A&&o.isValidElement(F)?o.cloneElement(F,void 0,I):I})});G.displayName="SegmentedField";0&&(module.exports={EMPTY_VALUE_TEXT,SEGMENT_LABELS,SegmentedField});