@skdx/react 0.27.0 → 0.29.0

package/dist/utils/primitive.d.ts

@@ -1,39 +1,37 @@
-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"];
+import type * as React from 'react';
+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", "mark", "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>;
+    [E in (typeof NODES)[number]]: PrimitiveComponent<E>;
 };
+/** The tag names an `as` prop accepts: `NODES` minus the void and replaced elements, none of which can carry a part's children. */
+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> & {
     /**
-     * Render this part's behavior onto your own child element instead of the
-     * default DOM tag, via {@link Slot}. The child must be a single React element.
+     * Render this part's behavior onto your own child element instead of the default DOM tag, via {@link Slot}; the child must be a single React element.
      * @default false
      */
-    asChild?: boolean;
+    asChild?: boolean | undefined;
 };
-interface PrimitiveForwardRefComponent<E extends React.ElementType> extends React.ForwardRefExoticComponent<PrimitivePropsWithRef<E>> {
+interface PrimitiveComponent<E extends React.ElementType> {
+    (props: PrimitivePropsWithRef<E>): React.ReactNode;
+    displayName?: string | undefined;
 }
 /**
- * The base DOM element every primitive part is built on — one forwardRef
- * component per tag (`Primitive.div`, `Primitive.button`, `Primitive.svg`, …),
- * each accepting {@link PrimitivePropsWithRef.asChild}. Internal building
- * block; component authors extending this library reach for it directly,
- * most consumers only ever see it through a component's own parts.
+ * The base DOM element every primitive part is built on — one component per tag, each accepting {@link PrimitivePropsWithRef.asChild}.
  *
  * @example
  * ```tsx
- * const MyPart = React.forwardRef<HTMLDivElement, PrimitivePropsWithRef<'div'>>(
- *   (props, ref) => <Primitive.div data-my-state="idle" {...props} ref={ref} />
+ * const MyPart = ({ ref, ...props }: PrimitivePropsWithRef<'div'>) => (
+ *   <Primitive.div data-my-state="idle" {...props} ref={ref} />
  * );
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare const Primitive: Primitives;
 /**
- * Composes two event handlers so both run without either clobbering the
- * other. The user-supplied `originalEventHandler` runs first; if it calls
- * `event.preventDefault()`, `ourEventHandler` (the primitive's own internal
- * handler) is skipped unless `checkForDefaultPrevented` is `false`.
+ * Composes two event handlers so both run without clobbering; `originalEventHandler` runs first, and `ourEventHandler` is skipped if it called `preventDefault()` unless `checkForDefaultPrevented` is `false`.
  *
  * @param originalEventHandler - The consumer's handler, passed through `{...props}`, run first.
  * @param ourEventHandler - The primitive's internal handler, run second.
@@ -46,10 +44,29 @@ export declare const Primitive: Primitives;
  *   onClick={composeEventHandlers(props.onClick, () => setOpen(true))}
  * />
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare function composeEventHandlers<E extends {
     defaultPrevented: boolean;
 }>(originalEventHandler?: (event: E) => void, ourEventHandler?: (event: E) => void, { checkForDefaultPrevented }?: {
     checkForDefaultPrevented?: boolean | undefined;
 }): (event: E) => void;
+/**
+ * Render-phase form of {@link composeEventHandlers}, for handlers that touch a ref.
+ *
+ * The React Compiler cannot see that `composeEventHandlers` only stores its arguments, so a
+ * ref-reading handler passed to it reads as a render-phase ref access; a hook boundary is where
+ * the compiler stops looking. Call it unconditionally, like any hook.
+ *
+ * @param originalEventHandler - The consumer's handler, passed through `{...props}`, run first.
+ * @param ourEventHandler - The primitive's internal handler, run second.
+ * @param options - Forwarded to {@link composeEventHandlers}.
+ * @internal
+ */
+export declare function useComposedEventHandlers<E extends {
+    defaultPrevented: boolean;
+}>(originalEventHandler?: (event: E) => void, ourEventHandler?: (event: E) => void, options?: {
+    checkForDefaultPrevented?: boolean;
+}): (event: E) => void;
 export {};

package/dist/utils/primitive.js

@@ -1 +1,2 @@
-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};
+'use client';
+import{Slot as s}from"./slot.js";import{jsx as f}from"react/jsx-runtime";var l=["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","mark","ol","p","pre","small","span","strong","svg","table","tbody","td","textarea","tfoot","th","thead","time","tr","ul"],v=l.reduce((n,e)=>{let t=r=>{let{asChild:i,ref:d,...a}=r,p=i?s:e;if(e==="a"){let o=a;o.target==="_blank"&&o.rel===void 0&&(o.rel="noopener noreferrer")}return f(p,{...a,ref:d})};return t.displayName=`Primitive.${e}`,{...n,[e]:t}},{});function m(n,e,{checkForDefaultPrevented:t=!0}={}){return function(i){if(n?.(i),!t||!i.defaultPrevented)return e?.(i)}}function u(n,e,t){return m(n,e,t)}export{v as Primitive,m as composeEventHandlers,u as useComposedEventHandlers};

package/dist/utils/qr-encoder.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var w=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var H=Object.prototype.hasOwnProperty;var K=(n,t)=>{for(var e in t)w(n,e,{get:t[e],enumerable:!0})},X=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of j(t))!H.call(n,o)&&o!==e&&w(n,o,{get:()=>t[o],enumerable:!(r=Y(t,o))||r.enumerable});return n};var W=n=>X(w({},"__esModule",{value:!0}),n);var yn={};K(yn,{MAX_VERSION:()=>U,MIN_VERSION:()=>G,alignmentPatternPositions:()=>I,dataCapacityBits:()=>y,encodeQr:()=>hn,formatInfoBits:()=>T,moduleCount:()=>k,reedSolomonGeneratorPoly:()=>O,totalCodewords:()=>_,versionInfoBits:()=>V});module.exports=W(yn);var q={L:1,M:0,Q:3,H:2},S={L:0,M:1,Q:2,H:3},F=[[-1,7,10,15,20,26,18,20,24,30,18,20,24,26,30,22,24,28,30,28,28,28,28,30,30,26,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,10,16,26,18,24,16,18,22,22,26,30,22,22,24,24,28,28,26,26,26,26,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28],[-1,13,22,18,26,18,24,18,22,20,24,28,26,24,20,30,24,28,28,26,30,28,30,30,30,30,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,17,28,22,16,22,28,26,26,24,28,24,28,22,24,24,30,28,28,26,28,30,24,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30]],R=[[-1,1,1,1,1,1,2,2,2,2,4,4,4,4,4,6,6,6,6,7,8,8,9,9,10,12,12,12,13,14,15,16,17,18,19,19,20,21,22,24,25],[-1,1,1,1,2,2,4,4,4,5,5,5,8,9,9,10,10,11,13,14,16,17,17,18,20,21,23,25,26,28,29,31,33,35,37,38,40,43,45,47,49],[-1,1,1,2,2,4,4,6,6,8,8,8,10,12,16,12,17,16,18,21,20,23,23,25,27,29,34,34,35,38,40,43,45,48,51,53,56,59,62,65,68],[-1,1,1,2,4,4,4,5,6,8,8,11,11,16,16,18,16,19,21,25,25,25,34,30,32,35,37,40,42,45,48,51,54,57,60,63,66,70,74,77,81]],G=1,U=40,J=3,Z=3,$=40,v=10;function k(n){return n*4+17}function g(n){let t=(16*n+128)*n+64;if(n>=2){let e=Math.floor(n/7)+2;t-=(25*e-10)*e-55,n>=7&&(t-=36)}return t}function _(n){return Math.floor(g(n)/8)}function y(n,t){let e=S[t],r=F[e][n]*R[e][n];return(_(n)-r)*8}function I(n){if(n===1)return[];let t=Math.floor(n/7)+2,e=n===32?26:Math.ceil((n*4+4)/(t*2-2))*2,r=[6];for(let o=k(n)-7;r.length<t;o-=e)r.splice(1,0,o);return r}var h=new Uint8Array(512),L=new Uint8Array(256);{let n=1;for(let t=0;t<255;t++)h[t]=n,L[n]=t,n<<=1,n&256&&(n^=285);for(let t=255;t<512;t++)h[t]=h[t-255]}function M(n,t){return n===0||t===0?0:h[L[n]+L[t]]}function O(n){let t=new Uint8Array(n);t[n-1]=1;let e=1;for(let r=0;r<n;r++){for(let o=0;o<n;o++){let u=M(t[o]??0,e);t[o]=o+1<n?u^(t[o+1]??0):u}e=M(e,2)}return t}function nn(n,t){let e=new Uint8Array(t.length);for(let r of n){let o=r^(e[0]??0);e.copyWithin(0,1),e[e.length-1]=0;for(let u=0;u<e.length;u++)e[u]=(e[u]??0)^M(t[u]??0,o)}return e}function D(n,t,e){let r=n;for(let o=0;o<e;o++)r=r<<1^(r>>>e-1)*t;return r}function T(n,t){let e=q[n]<<3|t;return((e<<10|D(e,1335,10))^21522)&32767}function V(n){return(n<<12|D(n,7973,12))&262143}function B(n){return n<=9?8:16}function d(n,t,e){for(let r=e-1;r>=0;r--)n.push(t>>>r&1)}function tn(n,t,e){let r=y(t,e),o=[];d(o,4,4),d(o,n.length,B(t));for(let c of n)d(o,c,8);d(o,0,Math.min(4,r-o.length)),d(o,0,(8-o.length%8)%8);for(let c=236;o.length<r;c^=253)d(o,c,8);let u=new Uint8Array(o.length/8);for(let c=0;c<o.length;c++){let l=c>>>3;u[l]=(u[l]??0)|o[c]<<7-(c&7)}return u}function on(n,t,e){let r=S[e],o=R[r][t],u=F[r][t],c=_(t),l=o-c%o,f=Math.floor(c/o)-u,m=O(u),p=[];for(let i=0,b=0;i<o;i++){let N=f+(i<l?0:1),z=n.subarray(b,b+N);b+=N,p.push({data:z,ecc:nn(z,m)})}let x=new Uint8Array(c),P=0;for(let i=0;i<=f;i++)for(let b of p)i<b.data.length&&(x[P++]=b.data[i]);for(let i=0;i<u;i++)for(let b of p)x[P++]=b.ecc[i];return x}var Q=[(n,t)=>(n+t)%2===0,(n,t)=>t%2===0,n=>n%3===0,(n,t)=>(n+t)%3===0,(n,t)=>(Math.floor(t/2)+Math.floor(n/3))%2===0,(n,t)=>n*t%2+n*t%3===0,(n,t)=>(n*t%2+n*t%3)%2===0,(n,t)=>((n+t)%2+n*t%3)%2===0];function rn(n){let t=k(n),e=()=>Array.from({length:t},()=>new Array(t).fill(!1));return{size:t,modules:e(),isFunction:e()}}function s(n,t,e,r){n.modules[e][t]=r,n.isFunction[e][t]=!0}var a=(n,t)=>(n>>>t&1)!==0;function A(n,t,e){for(let r=-4;r<=4;r++)for(let o=-4;o<=4;o++){let u=t+o,c=e+r;if(u<0||u>=n.size||c<0||c>=n.size)continue;let l=Math.max(Math.abs(o),Math.abs(r));s(n,u,c,l!==2&&l!==4)}}function en(n,t,e){for(let r=-2;r<=2;r++)for(let o=-2;o<=2;o++)s(n,t+o,e+r,Math.max(Math.abs(o),Math.abs(r))!==1)}function C(n,t,e){let r=T(t,e),{size:o}=n;for(let u=0;u<=5;u++)s(n,8,u,a(r,u));s(n,8,7,a(r,6)),s(n,8,8,a(r,7)),s(n,7,8,a(r,8));for(let u=9;u<15;u++)s(n,14-u,8,a(r,u));for(let u=0;u<8;u++)s(n,o-1-u,8,a(r,u));for(let u=8;u<15;u++)s(n,8,o-15+u,a(r,u));s(n,8,o-8,!0)}function un(n,t){if(t<7)return;let e=V(t);for(let r=0;r<18;r++){let o=a(e,r),u=n.size-11+r%3,c=Math.floor(r/3);s(n,u,c,o),s(n,c,u,o)}}function cn(n,t,e){let{size:r}=n;for(let c=0;c<r;c++)s(n,6,c,c%2===0),s(n,c,6,c%2===0);A(n,3,3),A(n,r-4,3),A(n,3,r-4);let o=I(t),u=o.length-1;for(let c=0;c<=u;c++)for(let l=0;l<=u;l++)c===0&&l===0||c===0&&l===u||c===u&&l===0||en(n,o[c],o[l]);C(n,e,0),un(n,t)}function ln(n,t){let{size:e}=n,r=0;for(let o=e-1;o>=1;o-=2){o===6&&(o=5);for(let u=0;u<e;u++)for(let c=0;c<2;c++){let l=o-c,m=(o+1&2)===0?e-1-u:u;n.isFunction[m][l]||r>=t.length*8||(n.modules[m][l]=a(t[r>>>3],7-(r&7)),r++)}}}function E(n,t){let e=Q[t];for(let r=0;r<n.size;r++)for(let o=0;o<n.size;o++)!n.isFunction[r][o]&&e(o,r)&&(n.modules[r][o]=!n.modules[r][o])}function sn(n,t){let e=0,r=n(0),o=1;for(let u=1;u<t;u++)n(u)===r?(o++,o===5?e+=J:o>5&&(e+=1)):(r=n(u),o=1);return e}function fn(n,t){let e=0;for(let r=0;r+10<t;r++){let o=0,u=0;for(let c=0;c<11;c++){let l=n(r+c)?1:0;o=o<<1|l,u|=l<<c}(o===1488||u===1488)&&(e+=$)}return e}function an(n){let{size:t,modules:e}=n,r=0;for(let o=0;o+1<t;o++)for(let u=0;u+1<t;u++){let c=e[o][u];c===e[o][u+1]&&c===e[o+1][u]&&c===e[o+1][u+1]&&(r+=Z)}return r}function bn(n){let{size:t,modules:e}=n,r=0;for(let u of e)for(let c of u)c&&r++;let o=t*t;return Math.floor(Math.abs(r*2-o)*10/o)*v}function mn(n){let{size:t,modules:e}=n,r=0;for(let o of[!0,!1])for(let u=0;u<t;u++){let c=l=>o?e[u][l]:e[l][u];r+=sn(c,t),r+=fn(c,t)}return r+an(n)+bn(n)}function dn(n,t){for(let e=G;e<=U;e++)if(4+B(e)+n*8<=y(e,t))return e;return null}function hn(n,t,e){let r=new TextEncoder().encode(n),o;if(e===void 0?o=dn(r.length,t):!Number.isInteger(e)||e<G||e>U?o=null:o=4+B(e)+r.length*8<=y(e,t)?e:null,o===null)return null;let u=rn(o);cn(u,o,t),ln(u,on(tn(r,o,t),o,t));let c=0,l=1/0;for(let f=0;f<Q.length;f++){E(u,f),C(u,t,f);let m=mn(u);m<l&&(l=m,c=f),E(u,f)}return E(u,c),C(u,t,c),u.modules}0&&(module.exports={MAX_VERSION,MIN_VERSION,alignmentPatternPositions,dataCapacityBits,encodeQr,formatInfoBits,moduleCount,reedSolomonGeneratorPoly,totalCodewords,versionInfoBits});

package/dist/utils/qr-encoder.d.cts

@@ -0,0 +1,33 @@
+/**
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
+ *
+ * @module
+ */
+/** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
+export type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+export declare const MIN_VERSION = 1;
+export declare const MAX_VERSION = 40;
+/** Module count along one edge for `version`: `4 × version + 17`, so 21 at v1 and 177 at v40. */
+export declare function moduleCount(version: number): number;
+/** Total codewords (data + EC) a version holds, independent of level. */
+export declare function totalCodewords(version: number): number;
+/** Bits available for the data segment (mode indicator, character count, payload, padding) at this version and level. */
+export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
+/** Centre coordinates of alignment patterns for `version`, ascending, per ISO/IEC 18004 Table E.1. */
+export declare function alignmentPatternPositions(version: number): number[];
+/** Reed–Solomon generator polynomial `(x − α^0)(x − α^1)…(x − α^(degree−1))`, returned monic-implicit (leading 1 omitted). */
+export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
+/** 15-bit format-information word: BCH(15, 5) over `level | mask`, XOR-masked to avoid all-zero output. */
+export declare function formatInfoBits(level: ErrorCorrectionLevel, mask: number): number;
+/** 18-bit version-information word: BCH(18, 6), used only for version 7 and up. */
+export declare function versionInfoBits(version: number): number;
+/**
+ * Encodes `value` as a QR Code matrix.
+ *
+ * @param value - The payload, encoded as UTF-8 bytes (byte mode).
+ * @param level - Error-correction level. Use `'H'` whenever a logo covers the centre.
+ * @param version - Force a symbol version 1–40. Omit to pick the smallest that fits.
+ * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a dark
+ * module — or `null` when the payload exceeds capacity or `version` is invalid. Never throws.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

package/dist/utils/qr-encoder.d.ts

@@ -0,0 +1,33 @@
+/**
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
+ *
+ * @module
+ */
+/** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
+export type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+export declare const MIN_VERSION = 1;
+export declare const MAX_VERSION = 40;
+/** Module count along one edge for `version`: `4 × version + 17`, so 21 at v1 and 177 at v40. */
+export declare function moduleCount(version: number): number;
+/** Total codewords (data + EC) a version holds, independent of level. */
+export declare function totalCodewords(version: number): number;
+/** Bits available for the data segment (mode indicator, character count, payload, padding) at this version and level. */
+export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
+/** Centre coordinates of alignment patterns for `version`, ascending, per ISO/IEC 18004 Table E.1. */
+export declare function alignmentPatternPositions(version: number): number[];
+/** Reed–Solomon generator polynomial `(x − α^0)(x − α^1)…(x − α^(degree−1))`, returned monic-implicit (leading 1 omitted). */
+export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
+/** 15-bit format-information word: BCH(15, 5) over `level | mask`, XOR-masked to avoid all-zero output. */
+export declare function formatInfoBits(level: ErrorCorrectionLevel, mask: number): number;
+/** 18-bit version-information word: BCH(18, 6), used only for version 7 and up. */
+export declare function versionInfoBits(version: number): number;
+/**
+ * Encodes `value` as a QR Code matrix.
+ *
+ * @param value - The payload, encoded as UTF-8 bytes (byte mode).
+ * @param level - Error-correction level. Use `'H'` whenever a logo covers the centre.
+ * @param version - Force a symbol version 1–40. Omit to pick the smallest that fits.
+ * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a dark
+ * module — or `null` when the payload exceeds capacity or `version` is invalid. Never throws.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

package/dist/utils/qr-encoder.js

@@ -0,0 +1,2 @@
+'use client';
+var O={L:1,M:0,Q:3,H:2},_={L:0,M:1,Q:2,H:3},B=[[-1,7,10,15,20,26,18,20,24,30,18,20,24,26,30,22,24,28,30,28,28,28,28,30,30,26,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,10,16,26,18,24,16,18,22,22,26,30,22,22,24,24,28,28,26,26,26,26,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28],[-1,13,22,18,26,18,24,18,22,20,24,28,26,24,20,30,24,28,28,26,30,28,30,30,30,30,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,17,28,22,16,22,28,26,26,24,28,24,28,22,24,24,30,28,28,26,28,30,24,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30]],P=[[-1,1,1,1,1,1,2,2,2,2,4,4,4,4,4,6,6,6,6,7,8,8,9,9,10,12,12,12,13,14,15,16,17,18,19,19,20,21,22,24,25],[-1,1,1,1,2,2,4,4,4,5,5,5,8,9,9,10,10,11,13,14,16,17,17,18,20,21,23,25,26,28,29,31,33,35,37,38,40,43,45,47,49],[-1,1,1,2,2,4,4,6,6,8,8,8,10,12,16,12,17,16,18,21,20,23,23,25,27,29,34,34,35,38,40,43,45,48,51,53,56,59,62,65,68],[-1,1,1,2,4,4,4,5,6,8,8,11,11,16,16,18,16,19,21,25,25,25,34,30,32,35,37,40,42,45,48,51,54,57,60,63,66,70,74,77,81]],N=1,z=40,D=3,T=3,V=40,Q=10;function S(n){return n*4+17}function Y(n){let t=(16*n+128)*n+64;if(n>=2){let e=Math.floor(n/7)+2;t-=(25*e-10)*e-55,n>=7&&(t-=36)}return t}function F(n){return Math.floor(Y(n)/8)}function M(n,t){let e=_[t],r=B[e][n]*P[e][n];return(F(n)-r)*8}function j(n){if(n===1)return[];let t=Math.floor(n/7)+2,e=n===32?26:Math.ceil((n*4+4)/(t*2-2))*2,r=[6];for(let o=S(n)-7;r.length<t;o-=e)r.splice(1,0,o);return r}var h=new Uint8Array(512),A=new Uint8Array(256);{let n=1;for(let t=0;t<255;t++)h[t]=n,A[n]=t,n<<=1,n&256&&(n^=285);for(let t=255;t<512;t++)h[t]=h[t-255]}function E(n,t){return n===0||t===0?0:h[A[n]+A[t]]}function H(n){let t=new Uint8Array(n);t[n-1]=1;let e=1;for(let r=0;r<n;r++){for(let o=0;o<n;o++){let u=E(t[o]??0,e);t[o]=o+1<n?u^(t[o+1]??0):u}e=E(e,2)}return t}function K(n,t){let e=new Uint8Array(t.length);for(let r of n){let o=r^(e[0]??0);e.copyWithin(0,1),e[e.length-1]=0;for(let u=0;u<e.length;u++)e[u]=(e[u]??0)^E(t[u]??0,o)}return e}function R(n,t,e){let r=n;for(let o=0;o<e;o++)r=r<<1^(r>>>e-1)*t;return r}function X(n,t){let e=O[n]<<3|t;return((e<<10|R(e,1335,10))^21522)&32767}function W(n){return(n<<12|R(n,7973,12))&262143}function C(n){return n<=9?8:16}function d(n,t,e){for(let r=e-1;r>=0;r--)n.push(t>>>r&1)}function q(n,t,e){let r=M(t,e),o=[];d(o,4,4),d(o,n.length,C(t));for(let c of n)d(o,c,8);d(o,0,Math.min(4,r-o.length)),d(o,0,(8-o.length%8)%8);for(let c=236;o.length<r;c^=253)d(o,c,8);let u=new Uint8Array(o.length/8);for(let c=0;c<o.length;c++){let l=c>>>3;u[l]=(u[l]??0)|o[c]<<7-(c&7)}return u}function J(n,t,e){let r=_[e],o=P[r][t],u=B[r][t],c=F(t),l=o-c%o,f=Math.floor(c/o)-u,m=H(u),y=[];for(let i=0,b=0;i<o;i++){let U=f+(i<l?0:1),k=n.subarray(b,b+U);b+=U,y.push({data:k,ecc:K(k,m)})}let p=new Uint8Array(c),G=0;for(let i=0;i<=f;i++)for(let b of y)i<b.data.length&&(p[G++]=b.data[i]);for(let i=0;i<u;i++)for(let b of y)p[G++]=b.ecc[i];return p}var I=[(n,t)=>(n+t)%2===0,(n,t)=>t%2===0,n=>n%3===0,(n,t)=>(n+t)%3===0,(n,t)=>(Math.floor(t/2)+Math.floor(n/3))%2===0,(n,t)=>n*t%2+n*t%3===0,(n,t)=>(n*t%2+n*t%3)%2===0,(n,t)=>((n+t)%2+n*t%3)%2===0];function Z(n){let t=S(n),e=()=>Array.from({length:t},()=>new Array(t).fill(!1));return{size:t,modules:e(),isFunction:e()}}function s(n,t,e,r){n.modules[e][t]=r,n.isFunction[e][t]=!0}var a=(n,t)=>(n>>>t&1)!==0;function x(n,t,e){for(let r=-4;r<=4;r++)for(let o=-4;o<=4;o++){let u=t+o,c=e+r;if(u<0||u>=n.size||c<0||c>=n.size)continue;let l=Math.max(Math.abs(o),Math.abs(r));s(n,u,c,l!==2&&l!==4)}}function $(n,t,e){for(let r=-2;r<=2;r++)for(let o=-2;o<=2;o++)s(n,t+o,e+r,Math.max(Math.abs(o),Math.abs(r))!==1)}function L(n,t,e){let r=X(t,e),{size:o}=n;for(let u=0;u<=5;u++)s(n,8,u,a(r,u));s(n,8,7,a(r,6)),s(n,8,8,a(r,7)),s(n,7,8,a(r,8));for(let u=9;u<15;u++)s(n,14-u,8,a(r,u));for(let u=0;u<8;u++)s(n,o-1-u,8,a(r,u));for(let u=8;u<15;u++)s(n,8,o-15+u,a(r,u));s(n,8,o-8,!0)}function v(n,t){if(t<7)return;let e=W(t);for(let r=0;r<18;r++){let o=a(e,r),u=n.size-11+r%3,c=Math.floor(r/3);s(n,u,c,o),s(n,c,u,o)}}function g(n,t,e){let{size:r}=n;for(let c=0;c<r;c++)s(n,6,c,c%2===0),s(n,c,6,c%2===0);x(n,3,3),x(n,r-4,3),x(n,3,r-4);let o=j(t),u=o.length-1;for(let c=0;c<=u;c++)for(let l=0;l<=u;l++)c===0&&l===0||c===0&&l===u||c===u&&l===0||$(n,o[c],o[l]);L(n,e,0),v(n,t)}function nn(n,t){let{size:e}=n,r=0;for(let o=e-1;o>=1;o-=2){o===6&&(o=5);for(let u=0;u<e;u++)for(let c=0;c<2;c++){let l=o-c,m=(o+1&2)===0?e-1-u:u;n.isFunction[m][l]||r>=t.length*8||(n.modules[m][l]=a(t[r>>>3],7-(r&7)),r++)}}}function w(n,t){let e=I[t];for(let r=0;r<n.size;r++)for(let o=0;o<n.size;o++)!n.isFunction[r][o]&&e(o,r)&&(n.modules[r][o]=!n.modules[r][o])}function tn(n,t){let e=0,r=n(0),o=1;for(let u=1;u<t;u++)n(u)===r?(o++,o===5?e+=D:o>5&&(e+=1)):(r=n(u),o=1);return e}function on(n,t){let e=0;for(let r=0;r+10<t;r++){let o=0,u=0;for(let c=0;c<11;c++){let l=n(r+c)?1:0;o=o<<1|l,u|=l<<c}(o===1488||u===1488)&&(e+=V)}return e}function rn(n){let{size:t,modules:e}=n,r=0;for(let o=0;o+1<t;o++)for(let u=0;u+1<t;u++){let c=e[o][u];c===e[o][u+1]&&c===e[o+1][u]&&c===e[o+1][u+1]&&(r+=T)}return r}function en(n){let{size:t,modules:e}=n,r=0;for(let u of e)for(let c of u)c&&r++;let o=t*t;return Math.floor(Math.abs(r*2-o)*10/o)*Q}function un(n){let{size:t,modules:e}=n,r=0;for(let o of[!0,!1])for(let u=0;u<t;u++){let c=l=>o?e[u][l]:e[l][u];r+=tn(c,t),r+=on(c,t)}return r+rn(n)+en(n)}function cn(n,t){for(let e=N;e<=z;e++)if(4+C(e)+n*8<=M(e,t))return e;return null}function ln(n,t,e){let r=new TextEncoder().encode(n),o;if(e===void 0?o=cn(r.length,t):!Number.isInteger(e)||e<N||e>z?o=null:o=4+C(e)+r.length*8<=M(e,t)?e:null,o===null)return null;let u=Z(o);g(u,o,t),nn(u,J(q(r,o,t),o,t));let c=0,l=1/0;for(let f=0;f<I.length;f++){w(u,f),L(u,t,f);let m=un(u);m<l&&(l=m,c=f),w(u,f)}return w(u,c),L(u,t,c),u.modules}export{z as MAX_VERSION,N as MIN_VERSION,j as alignmentPatternPositions,M as dataCapacityBits,ln as encodeQr,X as formatInfoBits,S as moduleCount,H as reedSolomonGeneratorPoly,F as totalCodewords,W as versionInfoBits};

package/dist/utils/recipeAxis.cjs

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

package/dist/utils/recipeAxis.d.cts

@@ -0,0 +1,11 @@
+/**
+ * @internal Resolves a recipe's appearance prop against the `data-<axis>` a
+ * consumer may have written on the recipe tag instead, so both reach the part
+ * the recipe feeds. The prop wins whenever it is set.
+ */
+export declare function recipeAxis<T>(prop: T | undefined, attrs: object, attribute: string): T | undefined;
+/**
+ * @internal {@link recipeAxis} for a presence axis, where the written attribute
+ * carries no value: anything but an explicit `false` reads as on.
+ */
+export declare function recipeFlag(prop: boolean | undefined, attrs: object, attribute: string): boolean | undefined;

package/dist/utils/recipeAxis.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @internal Resolves a recipe's appearance prop against the `data-<axis>` a
+ * consumer may have written on the recipe tag instead, so both reach the part
+ * the recipe feeds. The prop wins whenever it is set.
+ */
+export declare function recipeAxis<T>(prop: T | undefined, attrs: object, attribute: string): T | undefined;
+/**
+ * @internal {@link recipeAxis} for a presence axis, where the written attribute
+ * carries no value: anything but an explicit `false` reads as on.
+ */
+export declare function recipeFlag(prop: boolean | undefined, attrs: object, attribute: string): boolean | undefined;

package/dist/utils/recipeAxis.js

@@ -0,0 +1,2 @@
+'use client';
+function r(n,e,i){return n??e[i]}function t(n,e,i){if(n!==void 0)return n;let d=e[i];return d===void 0?void 0:d!==!1&&d!=="false"}export{r as recipeAxis,t as recipeFlag};

package/dist/utils/resolveSpace.cjs

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

package/dist/utils/resolveSpace.d.cts

@@ -0,0 +1,6 @@
+/** 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;
+/** A number, or a digits-only string, becomes that many equal columns; any other string is a raw track list passed through. */
+export declare function resolveColumns(value: number | string | undefined): string | undefined;

package/dist/utils/resolveSpace.d.ts

@@ -0,0 +1,6 @@
+/** 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;
+/** A number, or a digits-only string, becomes that many equal columns; any other string is a raw track list passed through. */
+export declare function resolveColumns(value: number | string | undefined): string | undefined;

package/dist/utils/resolveSpace.js

@@ -0,0 +1,2 @@
+'use client';
+var e=new Set(["1","2","3","4","5","6","8","10","12","16"]);function r(n){if(n!==void 0)return e.has(n)?`var(--skdx-space-${n})`:n}function t(n){if(n!==void 0)return typeof n=="string"&&!/^\d+$/.test(n)?n:`repeat(${Number(n)}, minmax(0, 1fr))`}export{t as resolveColumns,r as resolveSpace};

package/dist/utils/roving-tab-stop.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var f=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},d=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let l of u(t))!g.call(e,l)&&l!==n&&i(e,l,{get:()=>t[l],enumerable:!(r=a(t,l))||r.enumerable});return e};var m=e=>d(i({},"__esModule",{value:!0}),e);var x={};f(x,{DISABLED_ITEM_SELECTOR:()=>o,enabledRovingItems:()=>b,isRovingItemDisabled:()=>s,resolveTabStopId:()=>c,rovingItemIds:()=>E,rovingTabIndex:()=>p});module.exports=m(x);var o="[disabled], [data-disabled]";function s(e){return e.matches(o)}function b(e,t,n){return Array.from(e?.querySelectorAll(t)??[]).filter(l=>!s(l)&&(!n||l.closest(n)===e))}function c(e,t,n){let r=t.filter(l=>e.includes(l));return r.length>0?n!==null&&r.includes(n)?n:r[0]:n!==null&&e.includes(n)?n:e[0]??null}function E(e,t){return e.map(n=>n.getAttribute(t)).filter(n=>n!==null&&n!=="")}function p(e,t,n=!1){return e||n?t?0:-1:0}0&&(module.exports={DISABLED_ITEM_SELECTOR,enabledRovingItems,isRovingItemDisabled,resolveTabStopId,rovingItemIds,rovingTabIndex});

package/dist/utils/roving-tab-stop.d.cts

@@ -0,0 +1,37 @@
+/** Matches an item excluded from the roving order — the contract names `data-disabled`, and native controls also carry `disabled`. */
+export declare const DISABLED_ITEM_SELECTOR = "[disabled], [data-disabled]";
+/** Whether an item is out of the roving order, testing both attribute spellings. */
+export declare function isRovingItemDisabled(item: Element): boolean;
+/**
+ * The group's items in document order, minus the disabled ones and minus any that belong to a nested group.
+ *
+ * @param root the group element owning the items, or `null` before it mounts
+ * @param itemSelector selector matching one item
+ * @param scopeSelector selector naming an item's owning group, so a nested group's items are left to it
+ * @returns the enabled items, empty when `root` is not mounted yet
+ */
+export declare function enabledRovingItems(root: ParentNode | null | undefined, itemSelector: string, scopeSelector?: string): HTMLElement[];
+/**
+ * The id that should hold the tab stop after the items or the selection changed.
+ *
+ * Active items win, and the stop stays put while it is still on one of them; with
+ * nothing active it stays on whichever item still claims it, else falls to the first.
+ * An active id that is not in `ids` — disabled, or unmounted since it was selected —
+ * cannot hold the stop, so the group stays reachable by Tab.
+ *
+ * @param ids every enabled item's id, in document order
+ * @param activeIds the ids of the selected/pressed/active items, in document order
+ * @param currentId the id holding the stop now, or `null` before one is resolved
+ * @returns the id to give the stop to, or `null` when the group has no enabled item
+ */
+export declare function resolveTabStopId(ids: readonly string[], activeIds: readonly string[], currentId: string | null): string | null;
+/** Every enabled item's id, skipping items that carry no id — they cannot hold a stop that survives a re-render. */
+export declare function rovingItemIds(items: readonly Element[], idAttribute: string): string[];
+/**
+ * The `tabindex` for one item: before the group resolves its stop — which only happens in a layout effect, so never during SSR — every enabled item is a stop rather than none.
+ *
+ * @param resolved whether the group has settled which item holds the stop
+ * @param isTabStop whether this item is that one
+ * @param disabled whether this item is disabled, in which case it never claims a stop
+ */
+export declare function rovingTabIndex(resolved: boolean, isTabStop: boolean, disabled?: boolean): 0 | -1;

package/dist/utils/roving-tab-stop.d.ts

@@ -0,0 +1,37 @@
+/** Matches an item excluded from the roving order — the contract names `data-disabled`, and native controls also carry `disabled`. */
+export declare const DISABLED_ITEM_SELECTOR = "[disabled], [data-disabled]";
+/** Whether an item is out of the roving order, testing both attribute spellings. */
+export declare function isRovingItemDisabled(item: Element): boolean;
+/**
+ * The group's items in document order, minus the disabled ones and minus any that belong to a nested group.
+ *
+ * @param root the group element owning the items, or `null` before it mounts
+ * @param itemSelector selector matching one item
+ * @param scopeSelector selector naming an item's owning group, so a nested group's items are left to it
+ * @returns the enabled items, empty when `root` is not mounted yet
+ */
+export declare function enabledRovingItems(root: ParentNode | null | undefined, itemSelector: string, scopeSelector?: string): HTMLElement[];
+/**
+ * The id that should hold the tab stop after the items or the selection changed.
+ *
+ * Active items win, and the stop stays put while it is still on one of them; with
+ * nothing active it stays on whichever item still claims it, else falls to the first.
+ * An active id that is not in `ids` — disabled, or unmounted since it was selected —
+ * cannot hold the stop, so the group stays reachable by Tab.
+ *
+ * @param ids every enabled item's id, in document order
+ * @param activeIds the ids of the selected/pressed/active items, in document order
+ * @param currentId the id holding the stop now, or `null` before one is resolved
+ * @returns the id to give the stop to, or `null` when the group has no enabled item
+ */
+export declare function resolveTabStopId(ids: readonly string[], activeIds: readonly string[], currentId: string | null): string | null;
+/** Every enabled item's id, skipping items that carry no id — they cannot hold a stop that survives a re-render. */
+export declare function rovingItemIds(items: readonly Element[], idAttribute: string): string[];
+/**
+ * The `tabindex` for one item: before the group resolves its stop — which only happens in a layout effect, so never during SSR — every enabled item is a stop rather than none.
+ *
+ * @param resolved whether the group has settled which item holds the stop
+ * @param isTabStop whether this item is that one
+ * @param disabled whether this item is disabled, in which case it never claims a stop
+ */
+export declare function rovingTabIndex(resolved: boolean, isTabStop: boolean, disabled?: boolean): 0 | -1;

package/dist/utils/roving-tab-stop.js

@@ -0,0 +1,2 @@
+'use client';
+var i="[disabled], [data-disabled]";function o(e){return e.matches(i)}function s(e,t,n){return Array.from(e?.querySelectorAll(t)??[]).filter(r=>!o(r)&&(!n||r.closest(n)===e))}function a(e,t,n){let l=t.filter(r=>e.includes(r));return l.length>0?n!==null&&l.includes(n)?n:l[0]:n!==null&&e.includes(n)?n:e[0]??null}function u(e,t){return e.map(n=>n.getAttribute(t)).filter(n=>n!==null&&n!=="")}function g(e,t,n=!1){return e||n?t?0:-1:0}export{i as DISABLED_ITEM_SELECTOR,s as enabledRovingItems,o as isRovingItemDisabled,a as resolveTabStopId,u as rovingItemIds,g as rovingTabIndex};

package/dist/utils/scoredFilter.cjs

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

package/dist/utils/segmentedField.d.cts

@@ -1,108 +1,86 @@
 import * as React from 'react';
-import { type Granularity, type HourCycle, type SegmentType, type SegmentValues } from './dateSegments.cjs';
+import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, type SegmentType, type SegmentValues } from './date-segments.cjs';
 import { type Direction } from './direction.cjs';
+import { type FormValidityHandle } from './formControl.cjs';
 import { type PrimitivePropsWithRef } from './primitive.cjs';
-/**
- * The rendering half of the segment engine, shared by `DateField` and
- * `TimeField` — the two differ only in which segments they own and how their
- * public value is shaped, so all the DOM, ARIA and keyboard handling lives
- * here once.
- *
- * `@internal` — not exported from the package barrel. Consumers compose
- * `DateField`/`TimeField`, never this.
- *
- * @internal
- */
 /** The `aria-valuetext` an untyped segment announces, so a spinbutton never reads a value the user did not enter. */
 export declare const EMPTY_VALUE_TEXT = "Empty";
-/**
- * Accessible name of each segment. Spelled for speech, not for code — a screen
- * reader announcing "dayPeriod" helps nobody.
- *
- * Exported so `getSegmentLabel` can fall back to it for the segment types a
- * consumer does not want to re-word.
- */
+/** Accessible name of each segment, spelled for speech not code; exported so `getSegmentLabel` can fall back to it for types a consumer doesn't want to re-word. */
 export declare const SEGMENT_LABELS: Record<SegmentType, string>;
 /** Props for {@link SegmentedField}. @internal */
 export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>, 'defaultValue' | 'onChange' | 'dir'> {
-    /**
-     * @internal The family rendering this field, so each segment can name itself
-     * — `skdx-date-field__segment` or `skdx-time-field__segment`.
-     *
-     * The segments used to carry `data-segment` and no class at all, so both
-     * families' `__segment` rules matched nothing and every date and time field
-     * shipped as run-together unstyled text: no padding, no selected-segment
-     * highlight, no placeholder treatment.
-     */
+    /** @internal The family rendering this field, so each segment can name itself (`skdx-date-field__segment` or `skdx-time-field__segment`). */
     family: 'date-field' | 'time-field';
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
     /** How far down the field is editable. */
     granularity: Granularity;
     /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
+    locale?: string | undefined;
     /** Forced hour cycle; omitted follows the locale. */
-    hourCycle?: HourCycle;
+    hourCycle?: HourCycle | undefined;
     /** Current per-segment values. */
     values: SegmentValues;
+    /** See {@link DateFieldProps.shouldForceLeadingZeros}. */
+    shouldForceLeadingZeros?: boolean | undefined;
+    /**
+     * See {@link TimeFieldProps.step} — seconds, driving both the finest
+     * segment's arrow increment and the mirrored input's `step` attribute.
+     */
+    step?: number | undefined;
     /** Called with the next per-segment values after any edit. */
     onValuesChange: (values: SegmentValues) => void;
     /** Value submitted by the hidden input; `null` submits an empty entry. */
     formValue: string | null;
-    disabled?: boolean;
-    readOnly?: boolean;
-    invalid?: boolean;
-    required?: boolean;
-    name?: string;
+    /** `type` of the mirrored input; not cosmetic, since it's what makes the browser check `min`/`max` natively and report `rangeUnderflow`/`rangeOverflow` through `checkValidity()`. */
+    formType: 'date' | 'datetime-local' | 'time';
+    /** `min` of the mirrored input, in the same wire shape as `formValue`. */
+    formMin?: string | undefined;
+    /** `max` of the mirrored input, in the same wire shape as `formValue`. */
+    formMax?: string | undefined;
+    /** Pulls the values a `Home`/`End` keystroke produced back inside the field's own `min`/`max`; only these two clamp, since typing and arrow-stepping must still reach out-of-range values for `rangeUnderflow`/`rangeOverflow` to fire. */
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    name?: string | undefined;
+    /** Id of the `<form>` this field submits into when rendered outside it (a portalled Dialog); forwarded to the hidden input and to `useFormReset`. */
+    form?: string | undefined;
     /** Writing direction override; without it, direction is read off the DOM. */
-    dir?: Direction;
+    dir?: Direction | undefined;
     /** See {@link SegmentedLabelProps.getSegmentLabel}. */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /** See {@link SegmentedLabelProps.emptySegmentText}. */
-    emptySegmentText?: string;
-    /**
-     * Called when the owning `<form>` is reset, so the field can put its
-     * segments back to the value it declared. Nothing here knows what that
-     * value is — `DateField`/`TimeField` own `defaultValue`.
-     */
-    onFormReset?: () => void;
+    emptySegmentText?: string | undefined;
+    /** See {@link SegmentedLabelProps.getSegmentPlaceholder}. */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
+    /** Called when the owning `<form>` is reset, so the field can put its segments back to the value it declared; `DateField`/`TimeField` own that value. */
+    onFormReset?: (() => void) | undefined;
 }
-/**
- * The two strings a segmented field announces that `locale` cannot translate:
- * the accessible name of each segment and the `aria-valuetext` of an untyped
- * one. Segment *order*, the literals between segments and the AM/PM names all
- * come from `Intl.DateTimeFormat` already — these two do not, because they
- * describe the widget rather than the value.
- *
- * Shared verbatim by `DateFieldProps` and `TimeFieldProps`.
- */
+/** The three strings a segmented field shows or announces that `locale` cannot translate: each segment's accessible name, an untyped segment's `aria-valuetext`, and its placeholder letters; shared verbatim by `DateFieldProps` and `TimeFieldProps`. */
 export interface SegmentedLabelProps {
     /**
-     * Words the accessible name of one segment. Called per segment type
-     * (`'year'`, `'month'`, `'dayPeriod'`, …); return the built-in
-     * {@link SEGMENT_LABELS} entry for the ones you do not want to change.
+     * Words the accessible name of one segment, called per segment type; return the built-in {@link SEGMENT_LABELS} entry for the ones you don't want to change.
      * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
      */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /**
      * The `aria-valuetext` an untyped segment announces instead of a number it
      * does not have.
      * @default 'Empty'
      */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
+    /**
+     * Words the placeholder letters one segment shows before typed, called per segment type; return the built-in {@link SEGMENT_PLACEHOLDERS} entry for the ones you don't want to change. The separators are locale-derived, these letters are not.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
 }
-/**
- * Renders one segmented field: a `role="group"` holding a `role="spinbutton"`
- * per editable segment interleaved with the locale's `aria-hidden` literals,
- * plus a hidden input for form submission.
- *
- * The forwarded ref is the root `<div>` with `checkValidity()`/
- * `reportValidity()` hung on it, both answering off that hidden input.
- *
- * A caveat worth knowing: the segments are `<span role="spinbutton">`, not
- * native controls, so a `<fieldset disabled>` ancestor does *not* disable them
- * on its own the way it disables an `<input>` — pass `disabled` explicitly.
- *
- * @internal
- */
-export declare const SegmentedField: React.ForwardRefExoticComponent<Omit<SegmentedFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** @internal Renders one segmented field: a `role="group"` holding a `role="spinbutton"` per editable segment plus a hidden input for form submission; a `<fieldset disabled>` ancestor does not disable the spinbuttons on its own, since they aren't native controls. */
+export declare const SegmentedField: {
+    ({ family, kind, granularity, locale, hourCycle, values, shouldForceLeadingZeros, step, onValuesChange, formValue, formType, formMin, formMax, clampEdgeValues, disabled, readOnly, invalid, required, name, form, dir, getSegmentLabel, emptySegmentText, getSegmentPlaceholder, onFormReset, asChild, children, ref: forwardedRef, ...props }: Omit<SegmentedFieldProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & FormValidityHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};