@skdx/react 0.28.0 → 0.30.0

package/dist/{qr-code/encoder.d.cts → utils/qr-encoder.d.cts}

@@ -1,6 +1,5 @@
 /**
- * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40,
- * all four error-correction levels. Pure and synchronous; runs unchanged under SSR.
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
  *
  * @module
  */
@@ -12,30 +11,15 @@ export declare const MAX_VERSION = 40;
 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 — total codewords less every
- * error-correction codeword.
- */
+/** 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.
- * Empty at v1. Spacing per ISO/IEC 18004 Table E.1; v32 has a one-off step of 26.
- */
+/** 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).
- */
+/** 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.
- */
+/** 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). Only v7+; smaller symbols need none.
- */
+/** 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.
@@ -44,8 +28,6 @@ export declare function versionInfoBits(version: number): number;
  * @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 out of
- * range or too small. **Never throws**: over-capacity is an ordinary outcome for
- * a user-supplied string, not an exceptional one.
+ * 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/{qr-code/encoder.d.ts → utils/qr-encoder.d.ts}

@@ -1,6 +1,5 @@
 /**
- * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40,
- * all four error-correction levels. Pure and synchronous; runs unchanged under SSR.
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
  *
  * @module
  */
@@ -12,30 +11,15 @@ export declare const MAX_VERSION = 40;
 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 — total codewords less every
- * error-correction codeword.
- */
+/** 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.
- * Empty at v1. Spacing per ISO/IEC 18004 Table E.1; v32 has a one-off step of 26.
- */
+/** 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).
- */
+/** 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.
- */
+/** 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). Only v7+; smaller symbols need none.
- */
+/** 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.
@@ -44,8 +28,6 @@ export declare function versionInfoBits(version: number): number;
  * @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 out of
- * range or too small. **Never throws**: over-capacity is an ordinary outcome for
- * a user-supplied string, not an exceptional one.
+ * 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

@@ -1 +1,2 @@
-"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});
+'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

@@ -2,3 +2,5 @@
 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

@@ -2,3 +2,5 @@
 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

@@ -1 +1,2 @@
-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};
+'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

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

@@ -1,16 +1,6 @@
-/**
- * The `boolean | number` filter predicate shared by Command, Combobox,
- * Autocomplete and MultiSelect: a plain boolean keeps/excludes only; a
- * number both filters and ranks.
- */
+/** 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.
- */
+/** 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

package/dist/utils/scoredFilter.d.ts

@@ -1,16 +1,6 @@
-/**
- * The `boolean | number` filter predicate shared by Command, Combobox,
- * Autocomplete and MultiSelect: a plain boolean keeps/excludes only; a
- * number both filters and ranks.
- */
+/** 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.
- */
+/** 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

package/dist/utils/scoredFilter.js

@@ -1 +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 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});
+'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,158 +1,86 @@
 import * as React from 'react';
-import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, 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`.
-     *
-     * Without it, a segment carries only `data-segment` and no class, so both
-     * families' `__segment` rules match nothing and the date or time field
-     * ships 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;
+    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;
+    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;
-    /**
-     * `type` of the mirrored input — `'date'`/`'datetime-local'` for a DateField,
-     * `'time'` for a TimeField. Not cosmetic: it is what makes the browser check
-     * `min`/`max` natively and report `rangeUnderflow`/`rangeOverflow` through
-     * `checkValidity()`, which a `type="text"` mirror cannot do at all.
-     */
+    /** `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;
+    formMin?: string | undefined;
     /** `max` of the mirrored input, in the same wire shape as `formValue`. */
-    formMax?: string;
-    /**
-     * Pulls the values a `Home`/`End` keystroke produced back inside the field's
-     * own `min`/`max`. Those two keys mean "the extreme end of what this segment
-     * accepts", and with a bound in play that end is the bound rather than the
-     * segment's natural `0`/`59`. Only they clamp: typing and arrow-stepping must
-     * still be able to reach an out-of-range value, or the bounds could never
-     * raise the `rangeUnderflow`/`rangeOverflow` they exist for.
-     */
-    clampEdgeValues?: (values: SegmentValues) => SegmentValues;
-    disabled?: boolean;
-    readOnly?: boolean;
-    invalid?: boolean;
-    required?: boolean;
-    name?: string;
-    /**
-     * Id of the `<form>` this field submits into, for a field rendered outside it
-     * — inside a portalled Dialog, say. Forwarded to the hidden input's `form`
-     * attribute, and passed to `useFormReset` as the form id to resolve, so a
-     * field submitting elsewhere on the page also answers that form's reset.
-     */
-    form?: string;
+    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;
+    emptySegmentText?: string | undefined;
     /** See {@link SegmentedLabelProps.getSegmentPlaceholder}. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
-    /**
-     * 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;
+    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 three strings a segmented field shows or announces that `locale` cannot
- * translate: the accessible name of each segment, the `aria-valuetext` of an
- * untyped one, and the placeholder letters an untyped one *renders*. Segment
- * *order*, the literals between segments and the AM/PM names all come from
- * `Intl.DateTimeFormat` already — these three do not, because they describe
- * the widget rather than the value, and CLDR has nothing to say about how to
- * write a value that has not been entered.
- *
- * 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 it has been typed.
-     * Called per segment type (`'year'`, `'month'`, `'dayPeriod'`, …); return the
-     * built-in {@link SEGMENT_PLACEHOLDERS} entry for the ones you do not want to
-     * change.
-     *
-     * The separators around them *are* locale-derived; these letters are not, so
-     * a `de-DE` field renders `dd.mm.yyyy` until this prop turns it into
-     * `TT.MM.JJJJ`.
+     * 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;
+    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;
+};