@skdx/web-components 0.28.0 → 0.30.0

package/dist/internal/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/internal/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/internal/qr-encoder.js

@@ -0,0 +1 @@
+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/internal/roving-tab-stop.cjs

@@ -0,0 +1 @@
+"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/internal/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/internal/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/internal/roving-tab-stop.js

@@ -0,0 +1 @@
+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/internal/scored-filter.d.cts

@@ -1,14 +1,6 @@
-/**
- * Filter predicate (command, combobox, autocomplete, multi-select). Boolean keeps/excludes; number filters and ranks.
- */
+/** Filter predicate (command, combobox, autocomplete, select); boolean keeps/excludes, number filters and ranks. */
 export type ScoredFilterResult = boolean | number;
-/**
- * Whether result keeps item: `0` and `false` exclude, `true` and positive numbers keep. Negative also excludes.
- */
+/** Whether `result` keeps the item: `0`, `false`, and negative numbers exclude; `true` and positive numbers keep. */
 export declare function filterKeeps(result: ScoredFilterResult): boolean;
-/**
- * Sorts option elements by score, sets inline CSS `order`. No-op if nothing scored numerically (preserves DOM order). Returns sequence for callers needing same order `order` paints.
- *
- * ponytail: `order` only works in flex/grid container — skin responsible.
- */
+/** Sorts option elements by score, setting inline CSS `order`; a no-op when nothing scored numerically, preserving DOM order. */
 export declare function sortByScore(container: Element, optionSelector: string, scoreOf: (id: string) => number | null): HTMLElement[];

package/dist/internal/scored-filter.d.ts

@@ -1,14 +1,6 @@
-/**
- * Filter predicate (command, combobox, autocomplete, multi-select). Boolean keeps/excludes; number filters and ranks.
- */
+/** Filter predicate (command, combobox, autocomplete, select); boolean keeps/excludes, number filters and ranks. */
 export type ScoredFilterResult = boolean | number;
-/**
- * Whether result keeps item: `0` and `false` exclude, `true` and positive numbers keep. Negative also excludes.
- */
+/** Whether `result` keeps the item: `0`, `false`, and negative numbers exclude; `true` and positive numbers keep. */
 export declare function filterKeeps(result: ScoredFilterResult): boolean;
-/**
- * Sorts option elements by score, sets inline CSS `order`. No-op if nothing scored numerically (preserves DOM order). Returns sequence for callers needing same order `order` paints.
- *
- * ponytail: `order` only works in flex/grid container — skin responsible.
- */
+/** Sorts option elements by score, setting inline CSS `order`; a no-op when nothing scored numerically, preserving DOM order. */
 export declare function sortByScore(container: Element, optionSelector: string, scoreOf: (id: string) => number | null): HTMLElement[];

package/dist/internal/segmented-field.cjs

@@ -1,21 +1,25 @@
-"use strict";var c=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var $=(e,t)=>{for(var r in t)c(e,r,{get:t[r],enumerable:!0})},k=(e,t,r,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of T(t))!E.call(e,a)&&a!==r&&c(e,a,{get:()=>t[a],enumerable:!(l=h(t,a))||l.enumerable});return e};var x=e=>k(c({},"__esModule",{value:!0}),e);var M={};$(M,{renderSegmentedField:()=>w});module.exports=x(M);var m=require("lit"),d=require("./date-segments.cjs"),g=require("./direction.cjs"),s=require("./part.cjs"),L="Empty",v={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function A(e){return e?Array.from(e.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function f(e,t,r){let l=A(e.parentElement),a=l[l.indexOf(e)+t];a&&(r.current=0,a.focus())}function y(e,t,r,l,a=!1){if(t.readOnly)return;let n={...t.values,[r]:l};(r==="month"||r==="year")&&n.day!=null&&(n.day=Math.min(n.day,(0,d.daysInMonth)(n.year,n.month))),a&&t.clampEdgeValues&&(n=t.clampEdgeValues(n)),t.onValuesChange(n),(e.parentElement??e).dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))}function V(e,t,r){let l=t.type,a=e.currentTarget,n=(0,g.directionalKey)(e.key,a);if(n==="ArrowLeft"||n==="ArrowRight"){e.preventDefault(),f(a,n==="ArrowRight"?1:-1,r.buffer);return}if(!r.readOnly){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),r.buffer.current=0,y(a,r,l,(0,d.stepSegment)(t,e.key==="ArrowUp"?1:-1,(0,d.segmentStepFor)(l,r.granularity,r.step)));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),r.buffer.current=0,y(a,r,l,e.key==="Home"?t.min:t.max,!0);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),r.buffer.current=0,y(a,r,l,null);return}if(l==="dayPeriod"){let i=(0,d.dayPeriodFromKey)(e.key,r.locale);i!==null&&(e.preventDefault(),y(a,r,l,i));return}if(/^\d$/.test(e.key)){e.preventDefault();let i=(0,d.typeDigit)(t,r.buffer.current,Number(e.key));r.buffer.current=i.buffer,y(a,r,l,i.value),i.advance&&f(a,1,r.buffer)}}}function w(e){let{host:t,disabled:r,readOnly:l,invalid:a,required:n}=e,i=e.getSegmentLabel??(u=>v[u]),b=e.emptySegmentText??L,o=`skdx-${e.part}__segment`,p=(0,d.buildSegments)({kind:e.kind,granularity:e.granularity,locale:e.locale,hourCycle:e.hourCycle,values:e.values,getSegmentPlaceholder:e.getSegmentPlaceholder,shouldForceLeadingZeros:e.shouldForceLeadingZeros});return t.setAttribute("role","group"),t.setAttribute("part",e.part),e.label!=null&&t.setAttribute("aria-label",e.label),(0,s.reflectHostState)(t,{"aria-disabled":r?"true":null,"aria-invalid":a?"true":null,"data-disabled":r?"":null,"data-readonly":l?"":null,"data-invalid":a?"":null}),m.html`${p.map(u=>u.isEditable?m.html`<span
+"use strict";var c=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var E=Object.prototype.hasOwnProperty;var $=(e,a)=>{for(var r in a)c(e,r,{get:a[r],enumerable:!0})},k=(e,a,r,n)=>{if(a&&typeof a=="object"||typeof a=="function")for(let t of T(a))!E.call(e,t)&&t!==r&&c(e,t,{get:()=>a[t],enumerable:!(n=h(a,t))||n.enumerable});return e};var v=e=>k(c({},"__esModule",{value:!0}),e);var w={};$(w,{renderSegmentedField:()=>V});module.exports=v(w);var i=require("lit"),d=require("./date-segments.cjs"),o=require("./direction.cjs"),g=require("./part.cjs"),x="Empty",L={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function A(e){return e?Array.from(e.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function s(e,a,r){let n=A(e.parentElement),t=n[n.indexOf(e)+a];t&&(r.current=0,t.focus())}function m(e,a,r,n,t=!1){if(a.disabled||a.readOnly)return;let l={...a.values,[r]:n};(r==="month"||r==="year")&&l.day!=null&&(l.day=Math.min(l.day,(0,d.daysInMonth)(l.year,l.month))),t&&a.clampEdgeValues&&(l=a.clampEdgeValues(l)),a.onValuesChange(l);let y=e.parentElement??e;a.host.updateComplete.then(()=>{y.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function M(e,a,r){let n=a.type,t=e.currentTarget,l=(0,o.directionalKey)(e.key,t);if(l==="ArrowLeft"||l==="ArrowRight"){e.preventDefault(),s(t,l==="ArrowRight"?1:-1,r.buffer);return}if(!(r.disabled||r.readOnly)){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),r.buffer.current=0,m(t,r,n,(0,d.stepSegment)(a,e.key==="ArrowUp"?1:-1,(0,d.segmentStepFor)(n,r.granularity,r.step)));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),r.buffer.current=0,m(t,r,n,e.key==="Home"?a.min:a.max,!0);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),r.buffer.current=0,m(t,r,n,null);return}P(e,a,r,t,n)}}function P(e,a,r,n,t){if(t==="dayPeriod"){let l=(0,d.dayPeriodFromKey)(e.key,r.locale);l!==null&&(e.preventDefault(),m(n,r,t,l));return}if(/^\d$/.test(e.key)){e.preventDefault();let l=(0,d.typeDigit)(a,r.buffer.current,Number(e.key));r.buffer.current=l.buffer,m(n,r,t,l.value),l.advance&&s(n,1,r.buffer)}}function V(e){let{host:a,disabled:r,readOnly:n,invalid:t,required:l}=e,y=e.getSegmentLabel??(u=>L[u]),b=e.emptySegmentText??x,f=`skdx-${e.part}__segment`,S=(0,d.buildSegments)({kind:e.kind,granularity:e.granularity,locale:e.locale,hourCycle:e.hourCycle,values:e.values,getSegmentPlaceholder:e.getSegmentPlaceholder,shouldForceLeadingZeros:e.shouldForceLeadingZeros});return a.setAttribute("role","group"),a.setAttribute("part",e.part),e.label!=null&&a.setAttribute("aria-label",e.label),(0,g.reflectHostState)(a,{"aria-disabled":r?"true":null,"aria-invalid":t?"true":null,"data-disabled":r?"":null,"data-readonly":n?"":null,"data-invalid":t?"":null}),i.html`${S.map(u=>u.isEditable?i.html`<span
           role="spinbutton"
           part="segment"
-          class=${o}
+          class=${f}
           tabindex=${r?-1:0}
-          aria-label=${i(u.type)}
+          aria-label=${y(u.type)}
           aria-valuenow=${(0,d.segmentValueNow)(u)}
           aria-valuemin=${u.min}
           aria-valuemax=${u.max}
           aria-valuetext=${u.isPlaceholder?b:u.text}
-          aria-disabled=${r?"true":m.nothing}
-          aria-readonly=${l?"true":m.nothing}
-          aria-required=${n?"true":m.nothing}
+          aria-disabled=${r?"true":i.nothing}
+          aria-readonly=${n?"true":i.nothing}
+          aria-required=${l?"true":i.nothing}
           data-segment=${u.type}
-          data-placeholder=${u.isPlaceholder?"":m.nothing}
-          @keydown=${S=>V(S,u,e)}
+          data-placeholder=${u.isPlaceholder?"":i.nothing}
+          @keydown=${p=>M(p,u,e)}
           @focus=${()=>{e.buffer.current=0}}
           >${u.text}</span
-        >`:m.html`<span part="literal" class=${o} aria-hidden="true" data-segment="literal"
+        >`:i.html`<span
+          part="literal"
+          class=${f}
+          aria-hidden="true"
+          data-segment="literal"
           >${u.text}</span
         >`)}`}0&&(module.exports={renderSegmentedField});

package/dist/internal/segmented-field.d.cts

@@ -6,8 +6,10 @@ export interface SegmentTypingBuffer {
 }
 /** Everything {@link renderSegmentedField} needs from the component that owns the value. @internal */
 export interface SegmentedFieldOptions {
-    /** The field element itself — the `role="group"` the segments render into. */
-    host: HTMLElement;
+    /** The field element itself — the `role="group"` the segments render into; its `updateComplete` is what the synthetic `input` waits on. */
+    host: HTMLElement & {
+        readonly updateComplete: Promise<boolean>;
+    };
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
     /** Family and `part` name for the root — `date-field` or `time-field`. */
@@ -15,23 +17,23 @@ export interface SegmentedFieldOptions {
     /** 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;
     /** Resolved hour cycle (never left to the locale at this point). */
     hourCycle: HourCycle;
     /** Current per-segment values. */
     values: SegmentValues;
     /** See the host's `shouldForceLeadingZeros`; unset renders every numeric segment at full width. */
-    shouldForceLeadingZeros?: boolean;
+    shouldForceLeadingZeros?: boolean | undefined;
     /** Step in seconds; controls arrow increment of finest segment. */
-    step?: number;
+    step?: number | undefined;
     /** Accessible name for the group, forwarded from the host's `aria-label`. */
     label: string | null;
     /** See the host's `getSegmentLabel`; unset falls back to {@link SEGMENT_LABELS}. */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /** See the host's `emptySegmentText`; unset falls back to {@link EMPTY_VALUE_TEXT}. */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
     /** See the host's `getSegmentPlaceholder`; unset falls back to the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
     disabled: boolean;
     readOnly: boolean;
     invalid: boolean;
@@ -41,24 +43,10 @@ export interface SegmentedFieldOptions {
     /** Called with the next per-segment values after any edit. */
     onValuesChange: (values: SegmentValues) => void;
     /** Clamps Home/End keystroke values to field's min/max bounds. */
-    clampEdgeValues?: (values: SegmentValues) => SegmentValues;
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
 }
 /**
- * The whole rendered content of a segmented field: one `role="spinbutton"` per
- * editable segment, interleaved with the locale's `aria-hidden` literals,
- * rendered into the host's **light DOM** — the host itself is the
- * `role="group"`, exactly like React's root, so the skin's
- * `.skdx-date-field__segment` geometry rules (document-level, unable to cross a
- * shadow boundary) reach the segments.
- *
- * Every segment — literals included, or the run breaks visually at each
- * separator — wears the family's `__segment` class, matching React's
- * `skdxPart(family, 'segment')`.
- *
- * Form submission is *not* here — both fields are form-associated custom
- * elements, so the value goes out through `ElementInternals` rather than
- * through a hidden input the way React's copy has to.
- *
+ * The whole rendered content of a segmented field: one `role="spinbutton"` per editable segment interleaved with the locale's `aria-hidden` literals, rendered into the host's light DOM (the host itself is `role="group"`).
  * @internal
  */
 export declare function renderSegmentedField(options: SegmentedFieldOptions): TemplateResult;

package/dist/internal/segmented-field.d.ts

@@ -6,8 +6,10 @@ export interface SegmentTypingBuffer {
 }
 /** Everything {@link renderSegmentedField} needs from the component that owns the value. @internal */
 export interface SegmentedFieldOptions {
-    /** The field element itself — the `role="group"` the segments render into. */
-    host: HTMLElement;
+    /** The field element itself — the `role="group"` the segments render into; its `updateComplete` is what the synthetic `input` waits on. */
+    host: HTMLElement & {
+        readonly updateComplete: Promise<boolean>;
+    };
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
     /** Family and `part` name for the root — `date-field` or `time-field`. */
@@ -15,23 +17,23 @@ export interface SegmentedFieldOptions {
     /** 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;
     /** Resolved hour cycle (never left to the locale at this point). */
     hourCycle: HourCycle;
     /** Current per-segment values. */
     values: SegmentValues;
     /** See the host's `shouldForceLeadingZeros`; unset renders every numeric segment at full width. */
-    shouldForceLeadingZeros?: boolean;
+    shouldForceLeadingZeros?: boolean | undefined;
     /** Step in seconds; controls arrow increment of finest segment. */
-    step?: number;
+    step?: number | undefined;
     /** Accessible name for the group, forwarded from the host's `aria-label`. */
     label: string | null;
     /** See the host's `getSegmentLabel`; unset falls back to {@link SEGMENT_LABELS}. */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /** See the host's `emptySegmentText`; unset falls back to {@link EMPTY_VALUE_TEXT}. */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
     /** See the host's `getSegmentPlaceholder`; unset falls back to the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
     disabled: boolean;
     readOnly: boolean;
     invalid: boolean;
@@ -41,24 +43,10 @@ export interface SegmentedFieldOptions {
     /** Called with the next per-segment values after any edit. */
     onValuesChange: (values: SegmentValues) => void;
     /** Clamps Home/End keystroke values to field's min/max bounds. */
-    clampEdgeValues?: (values: SegmentValues) => SegmentValues;
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
 }
 /**
- * The whole rendered content of a segmented field: one `role="spinbutton"` per
- * editable segment, interleaved with the locale's `aria-hidden` literals,
- * rendered into the host's **light DOM** — the host itself is the
- * `role="group"`, exactly like React's root, so the skin's
- * `.skdx-date-field__segment` geometry rules (document-level, unable to cross a
- * shadow boundary) reach the segments.
- *
- * Every segment — literals included, or the run breaks visually at each
- * separator — wears the family's `__segment` class, matching React's
- * `skdxPart(family, 'segment')`.
- *
- * Form submission is *not* here — both fields are form-associated custom
- * elements, so the value goes out through `ElementInternals` rather than
- * through a hidden input the way React's copy has to.
- *
+ * The whole rendered content of a segmented field: one `role="spinbutton"` per editable segment interleaved with the locale's `aria-hidden` literals, rendered into the host's light DOM (the host itself is `role="group"`).
  * @internal
  */
 export declare function renderSegmentedField(options: SegmentedFieldOptions): TemplateResult;

package/dist/internal/segmented-field.js

@@ -1,21 +1,25 @@
-import{html as y,nothing as m}from"lit";import{buildSegments as b,dayPeriodFromKey as p,daysInMonth as S,segmentStepFor as h,segmentValueNow as T,stepSegment as E,typeDigit as $}from"./date-segments.js";import{directionalKey as k}from"./direction.js";import{reflectHostState as x}from"./part.js";var L="Empty",v={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function A(e){return e?Array.from(e.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function o(e,t,r){let l=A(e.parentElement),a=l[l.indexOf(e)+t];a&&(r.current=0,a.focus())}function i(e,t,r,l,a=!1){if(t.readOnly)return;let n={...t.values,[r]:l};(r==="month"||r==="year")&&n.day!=null&&(n.day=Math.min(n.day,S(n.year,n.month))),a&&t.clampEdgeValues&&(n=t.clampEdgeValues(n)),t.onValuesChange(n),(e.parentElement??e).dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))}function V(e,t,r){let l=t.type,a=e.currentTarget,n=k(e.key,a);if(n==="ArrowLeft"||n==="ArrowRight"){e.preventDefault(),o(a,n==="ArrowRight"?1:-1,r.buffer);return}if(!r.readOnly){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),r.buffer.current=0,i(a,r,l,E(t,e.key==="ArrowUp"?1:-1,h(l,r.granularity,r.step)));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),r.buffer.current=0,i(a,r,l,e.key==="Home"?t.min:t.max,!0);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),r.buffer.current=0,i(a,r,l,null);return}if(l==="dayPeriod"){let d=p(e.key,r.locale);d!==null&&(e.preventDefault(),i(a,r,l,d));return}if(/^\d$/.test(e.key)){e.preventDefault();let d=$(t,r.buffer.current,Number(e.key));r.buffer.current=d.buffer,i(a,r,l,d.value),d.advance&&o(a,1,r.buffer)}}}function H(e){let{host:t,disabled:r,readOnly:l,invalid:a,required:n}=e,d=e.getSegmentLabel??(u=>v[u]),f=e.emptySegmentText??L,c=`skdx-${e.part}__segment`,g=b({kind:e.kind,granularity:e.granularity,locale:e.locale,hourCycle:e.hourCycle,values:e.values,getSegmentPlaceholder:e.getSegmentPlaceholder,shouldForceLeadingZeros:e.shouldForceLeadingZeros});return t.setAttribute("role","group"),t.setAttribute("part",e.part),e.label!=null&&t.setAttribute("aria-label",e.label),x(t,{"aria-disabled":r?"true":null,"aria-invalid":a?"true":null,"data-disabled":r?"":null,"data-readonly":l?"":null,"data-invalid":a?"":null}),y`${g.map(u=>u.isEditable?y`<span
+import{html as y,nothing as i}from"lit";import{buildSegments as b,dayPeriodFromKey as S,daysInMonth as p,segmentStepFor as h,segmentValueNow as T,stepSegment as E,typeDigit as $}from"./date-segments.js";import{directionalKey as k}from"./direction.js";import{reflectHostState as v}from"./part.js";var x="Empty",L={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"};function A(e){return e?Array.from(e.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function f(e,a,r){let n=A(e.parentElement),l=n[n.indexOf(e)+a];l&&(r.current=0,l.focus())}function d(e,a,r,n,l=!1){if(a.disabled||a.readOnly)return;let t={...a.values,[r]:n};(r==="month"||r==="year")&&t.day!=null&&(t.day=Math.min(t.day,p(t.year,t.month))),l&&a.clampEdgeValues&&(t=a.clampEdgeValues(t)),a.onValuesChange(t);let m=e.parentElement??e;a.host.updateComplete.then(()=>{m.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function M(e,a,r){let n=a.type,l=e.currentTarget,t=k(e.key,l);if(t==="ArrowLeft"||t==="ArrowRight"){e.preventDefault(),f(l,t==="ArrowRight"?1:-1,r.buffer);return}if(!(r.disabled||r.readOnly)){if(e.key==="ArrowUp"||e.key==="ArrowDown"){e.preventDefault(),r.buffer.current=0,d(l,r,n,E(a,e.key==="ArrowUp"?1:-1,h(n,r.granularity,r.step)));return}if(e.key==="Home"||e.key==="End"){e.preventDefault(),r.buffer.current=0,d(l,r,n,e.key==="Home"?a.min:a.max,!0);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),r.buffer.current=0,d(l,r,n,null);return}P(e,a,r,l,n)}}function P(e,a,r,n,l){if(l==="dayPeriod"){let t=S(e.key,r.locale);t!==null&&(e.preventDefault(),d(n,r,l,t));return}if(/^\d$/.test(e.key)){e.preventDefault();let t=$(a,r.buffer.current,Number(e.key));r.buffer.current=t.buffer,d(n,r,l,t.value),t.advance&&f(n,1,r.buffer)}}function C(e){let{host:a,disabled:r,readOnly:n,invalid:l,required:t}=e,m=e.getSegmentLabel??(u=>L[u]),o=e.emptySegmentText??x,c=`skdx-${e.part}__segment`,g=b({kind:e.kind,granularity:e.granularity,locale:e.locale,hourCycle:e.hourCycle,values:e.values,getSegmentPlaceholder:e.getSegmentPlaceholder,shouldForceLeadingZeros:e.shouldForceLeadingZeros});return a.setAttribute("role","group"),a.setAttribute("part",e.part),e.label!=null&&a.setAttribute("aria-label",e.label),v(a,{"aria-disabled":r?"true":null,"aria-invalid":l?"true":null,"data-disabled":r?"":null,"data-readonly":n?"":null,"data-invalid":l?"":null}),y`${g.map(u=>u.isEditable?y`<span
           role="spinbutton"
           part="segment"
           class=${c}
           tabindex=${r?-1:0}
-          aria-label=${d(u.type)}
+          aria-label=${m(u.type)}
           aria-valuenow=${T(u)}
           aria-valuemin=${u.min}
           aria-valuemax=${u.max}
-          aria-valuetext=${u.isPlaceholder?f:u.text}
-          aria-disabled=${r?"true":m}
-          aria-readonly=${l?"true":m}
-          aria-required=${n?"true":m}
+          aria-valuetext=${u.isPlaceholder?o:u.text}
+          aria-disabled=${r?"true":i}
+          aria-readonly=${n?"true":i}
+          aria-required=${t?"true":i}
           data-segment=${u.type}
-          data-placeholder=${u.isPlaceholder?"":m}
-          @keydown=${s=>V(s,u,e)}
+          data-placeholder=${u.isPlaceholder?"":i}
+          @keydown=${s=>M(s,u,e)}
           @focus=${()=>{e.buffer.current=0}}
           >${u.text}</span
-        >`:y`<span part="literal" class=${c} aria-hidden="true" data-segment="literal"
+        >`:y`<span
+          part="literal"
+          class=${c}
+          aria-hidden="true"
+          data-segment="literal"
           >${u.text}</span
-        >`)}`}export{H as renderSegmentedField};
+        >`)}`}export{C as renderSegmentedField};

package/dist/internal/select-keyboard.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var s=(e,n)=>{for(var t in n)c(e,t,{get:n[t],enumerable:!0})},u=(e,n,t,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of k(n))!m.call(e,i)&&i!==t&&c(e,i,{get:()=>n[i],enumerable:!(r=l(n,i))||r.enumerable});return e};var p=e=>u(c({},"__esModule",{value:!0}),e);var S={};s(S,{SELECT_PAGE_SIZE:()=>a,selectClosedAction:()=>A,selectKeyPrevented:()=>f,selectOpenAction:()=>b});module.exports=p(S);var d=require("./typeahead.cjs"),a=10,y={ArrowDown:"first",Home:"first",ArrowUp:"last",End:"last",Enter:"selected"," ":"selected"};function f(e){return e.kind!=="ignore"&&e.kind!=="commit-on-exit"}function o(e,n,t){return Math.min(t-1,Math.max(0,e+n))}function A(e,n){if(e.altKey&&e.key==="ArrowUp")return{kind:"ignore"};let t=y[e.key];return t!==void 0?{kind:"open",intent:e.altKey&&e.key==="ArrowDown"?"selected":t}:(0,d.isTypeaheadKey)(e)?n?{kind:"open-for-typeahead"}:{kind:"typeahead"}:{kind:"ignore"}}function b(e,n,t){if(e.altKey&&(e.key==="ArrowUp"||e.key==="ArrowDown"))return e.key==="ArrowUp"?{kind:"commit-and-close"}:{kind:"claim"};let r=w(e.key,n,t);return r!==null?t===0?{kind:"claim"}:{kind:"activate",index:r}:e.key==="Enter"||e.key===" "?{kind:"commit"}:e.key==="Tab"?{kind:"commit-on-exit"}:(0,d.isTypeaheadKey)(e)?{kind:"typeahead"}:{kind:"ignore"}}function w(e,n,t){switch(e){case"ArrowDown":return o(n,1,t);case"ArrowUp":return o(n,-1,t);case"PageDown":return o(n,a,t);case"PageUp":return o(n,-a,t);case"Home":return 0;case"End":return t-1;default:return null}}0&&(module.exports={SELECT_PAGE_SIZE,selectClosedAction,selectKeyPrevented,selectOpenAction});

package/dist/internal/select-keyboard.d.cts

@@ -0,0 +1,80 @@
+/** Where the listbox should put the active option when a key opens it. */
+export type SelectOpenIntent = 'selected' | 'first' | 'last';
+/** Ten is the normative page jump for a listbox — a headless package has no rendered row height to divide by. */
+export declare const SELECT_PAGE_SIZE = 10;
+/** What a keydown on a closed trigger asks for. Every action but `'ignore'` wants `preventDefault()`. */
+export type SelectClosedAction = 
+/** Open the listbox with the active option placed as `intent` says. */
+{
+    kind: 'open';
+    intent: SelectOpenIntent;
+}
+/** A letter arrived on a multiple-select: open the listbox and search there, since a closed multi-select has no single "current" option to walk from. */
+ | {
+    kind: 'open-for-typeahead';
+}
+/** A letter arrived on a single-select: match it against the options and select the hit without opening, as a native `<select>` does. */
+ | {
+    kind: 'typeahead';
+}
+/** Not a key this trigger claims. */
+ | {
+    kind: 'ignore';
+};
+/** What a keydown on an open listbox asks for; `index` is already clamped into range. */
+export type SelectOpenAction = 
+/** Move the active option to `index`. */
+{
+    kind: 'activate';
+    index: number;
+}
+/** Select the active option, and close unless `closeOnSelect` is off. */
+ | {
+    kind: 'commit';
+}
+/** Alt+ArrowUp: select the active option and close, the keyboard equivalent of clicking it. */
+ | {
+    kind: 'commit-and-close';
+}
+/** Tab: add the active option to the selection without ever removing it, then close and let the browser's own Tab run. */
+ | {
+    kind: 'commit-on-exit';
+}
+/** A letter arrived: run the typeahead and activate its hit. */
+ | {
+    kind: 'typeahead';
+}
+/** Alt+ArrowDown, the open key: claimed so it cannot move focus, but nothing else happens. */
+ | {
+    kind: 'claim';
+}
+/** Not a key the listbox claims. */
+ | {
+    kind: 'ignore';
+};
+/** A keydown, reduced to what the decision needs. */
+export interface SelectKeyEvent {
+    key: string;
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+}
+/** Whether the adapter should call `preventDefault()` for this action; Tab is the exception, because focus is not trapped and the browser's own Tab has to carry focus onward. */
+export declare function selectKeyPrevented(action: SelectClosedAction | SelectOpenAction): boolean;
+/**
+ * The action for a keydown on a closed trigger.
+ *
+ * @param event the keydown
+ * @param multiple whether the Select holds more than one value
+ * @returns what the adapter should do; see {@link SelectClosedAction}
+ */
+export declare function selectClosedAction(event: SelectKeyEvent, multiple: boolean): SelectClosedAction;
+/**
+ * The action for a keydown while the listbox is open, over virtual focus: DOM focus stays on the trigger, so these move the active option, not the focused element.
+ *
+ * @param event the keydown
+ * @param currentIndex the active option's index, or `-1` when none is active
+ * @param optionCount how many options the listbox renders
+ * @returns what the adapter should do; see {@link SelectOpenAction}
+ */
+export declare function selectOpenAction(event: SelectKeyEvent, currentIndex: number, optionCount: number): SelectOpenAction;

package/dist/internal/select-keyboard.d.ts

@@ -0,0 +1,80 @@
+/** Where the listbox should put the active option when a key opens it. */
+export type SelectOpenIntent = 'selected' | 'first' | 'last';
+/** Ten is the normative page jump for a listbox — a headless package has no rendered row height to divide by. */
+export declare const SELECT_PAGE_SIZE = 10;
+/** What a keydown on a closed trigger asks for. Every action but `'ignore'` wants `preventDefault()`. */
+export type SelectClosedAction = 
+/** Open the listbox with the active option placed as `intent` says. */
+{
+    kind: 'open';
+    intent: SelectOpenIntent;
+}
+/** A letter arrived on a multiple-select: open the listbox and search there, since a closed multi-select has no single "current" option to walk from. */
+ | {
+    kind: 'open-for-typeahead';
+}
+/** A letter arrived on a single-select: match it against the options and select the hit without opening, as a native `<select>` does. */
+ | {
+    kind: 'typeahead';
+}
+/** Not a key this trigger claims. */
+ | {
+    kind: 'ignore';
+};
+/** What a keydown on an open listbox asks for; `index` is already clamped into range. */
+export type SelectOpenAction = 
+/** Move the active option to `index`. */
+{
+    kind: 'activate';
+    index: number;
+}
+/** Select the active option, and close unless `closeOnSelect` is off. */
+ | {
+    kind: 'commit';
+}
+/** Alt+ArrowUp: select the active option and close, the keyboard equivalent of clicking it. */
+ | {
+    kind: 'commit-and-close';
+}
+/** Tab: add the active option to the selection without ever removing it, then close and let the browser's own Tab run. */
+ | {
+    kind: 'commit-on-exit';
+}
+/** A letter arrived: run the typeahead and activate its hit. */
+ | {
+    kind: 'typeahead';
+}
+/** Alt+ArrowDown, the open key: claimed so it cannot move focus, but nothing else happens. */
+ | {
+    kind: 'claim';
+}
+/** Not a key the listbox claims. */
+ | {
+    kind: 'ignore';
+};
+/** A keydown, reduced to what the decision needs. */
+export interface SelectKeyEvent {
+    key: string;
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+}
+/** Whether the adapter should call `preventDefault()` for this action; Tab is the exception, because focus is not trapped and the browser's own Tab has to carry focus onward. */
+export declare function selectKeyPrevented(action: SelectClosedAction | SelectOpenAction): boolean;
+/**
+ * The action for a keydown on a closed trigger.
+ *
+ * @param event the keydown
+ * @param multiple whether the Select holds more than one value
+ * @returns what the adapter should do; see {@link SelectClosedAction}
+ */
+export declare function selectClosedAction(event: SelectKeyEvent, multiple: boolean): SelectClosedAction;
+/**
+ * The action for a keydown while the listbox is open, over virtual focus: DOM focus stays on the trigger, so these move the active option, not the focused element.
+ *
+ * @param event the keydown
+ * @param currentIndex the active option's index, or `-1` when none is active
+ * @param optionCount how many options the listbox renders
+ * @returns what the adapter should do; see {@link SelectOpenAction}
+ */
+export declare function selectOpenAction(event: SelectKeyEvent, currentIndex: number, optionCount: number): SelectOpenAction;

package/dist/internal/select-keyboard.js

@@ -0,0 +1 @@
+import{isTypeaheadKey as c}from"./typeahead.js";var o=10,a={ArrowDown:"first",Home:"first",ArrowUp:"last",End:"last",Enter:"selected"," ":"selected"};function k(e){return e.kind!=="ignore"&&e.kind!=="commit-on-exit"}function r(e,t,n){return Math.min(n-1,Math.max(0,e+t))}function m(e,t){if(e.altKey&&e.key==="ArrowUp")return{kind:"ignore"};let n=a[e.key];return n!==void 0?{kind:"open",intent:e.altKey&&e.key==="ArrowDown"?"selected":n}:c(e)?t?{kind:"open-for-typeahead"}:{kind:"typeahead"}:{kind:"ignore"}}function s(e,t,n){if(e.altKey&&(e.key==="ArrowUp"||e.key==="ArrowDown"))return e.key==="ArrowUp"?{kind:"commit-and-close"}:{kind:"claim"};let i=d(e.key,t,n);return i!==null?n===0?{kind:"claim"}:{kind:"activate",index:i}:e.key==="Enter"||e.key===" "?{kind:"commit"}:e.key==="Tab"?{kind:"commit-on-exit"}:c(e)?{kind:"typeahead"}:{kind:"ignore"}}function d(e,t,n){switch(e){case"ArrowDown":return r(t,1,n);case"ArrowUp":return r(t,-1,n);case"PageDown":return r(t,o,n);case"PageUp":return r(t,-o,n);case"Home":return 0;case"End":return n-1;default:return null}}export{o as SELECT_PAGE_SIZE,m as selectClosedAction,k as selectKeyPrevented,s as selectOpenAction};