@skdx/vue 0.27.0 → 0.29.0

package/dist/utils/popper.d.ts

@@ -1,27 +1,22 @@
-import { type CSSProperties, type InjectionKey, type MaybeRefOrGetter, type Ref } from 'vue';
+import { type ComputedRef, type CSSProperties, type InjectionKey, type MaybeRefOrGetter, type Ref } from 'vue';
 import { type PhysicalSide } from './direction.js';
+import type { VirtualAnchor } from './mentions.js';
+import { type Align, type Side } from './placement.js';
+export { setMeasurementProperties, type Align, type Side } from './placement.js';
 export type { PhysicalSide } from './direction.js';
 /**
- * Internal positioning layer shared by Popover, Tooltip, HoverCard and any
- * future floating-content component. Wraps `@floating-ui/dom` with a
- * Radix-like side/align API and exposes `data-side`/`data-align` for
- * animation styling, mirroring `packages/react/src/utils/popper.tsx`.
+ * Internal positioning layer shared by every floating-content component, wrapping `@floating-ui/dom` with a Radix-like side/align API.
  * @internal
  */
-/**
- * @internal Edge of the anchor the floating content is placed against.
- * `start`/`end` are *logical*: they resolve to `left`/`right` under
- * `dir="ltr"` and swap under `dir="rtl"`, so an overlay authored as
- * `side="end"` mirrors itself. `left`/`right` are physical and never mirror.
- * `data-side` always reports a physical side — where the content landed.
- */
-export type Side = PhysicalSide | 'start' | 'end';
-/** @internal How floating content aligns along its chosen side: to the anchor's start, center, or end. */
-export type Align = 'start' | 'center' | 'end';
 /** @internal Injection key a PopperRoot provides so PopperAnchor/trigger components can register the anchor element. */
 export interface PopperContext {
     anchor: Ref<HTMLElement | null>;
-    setAnchor(node: HTMLElement | null): void;
+    /**
+     * Registers the positioning reference. An explicit `Anchor` part passes
+     * `explicit`, which outranks the trigger's own registration however the two
+     * happen to mount.
+     */
+    setAnchor(node: HTMLElement | null, explicit?: boolean): void;
 }
 /** @internal Injection key connecting a PopperRoot to the anchor/trigger parts that register its positioning anchor. */
 export declare const POPPER_CONTEXT: InjectionKey<PopperContext>;
@@ -30,85 +25,45 @@ export interface PopperArrowContext {
     style: Readonly<Ref<CSSProperties>>;
     setArrowEl(node: HTMLElement | null): void;
 }
-/**
- * @internal Injection key a `*Content` component provides so a nested
- * `*Arrow` component can register its element and read its computed
- * position, without each component pair (Popover, Tooltip, HoverCard, ...)
- * inventing its own.
- */
+/** @internal Injection key a `*Content` component provides so a nested `*Arrow` component can register and read its position. */
 export declare const ARROW_CONTEXT: InjectionKey<PopperArrowContext>;
 /** @internal Side/align, offsets and collision settings for placing floating content relative to its anchor. */
 export interface PopperPositionOptions {
     /** Preferred edge. `start`/`end` are logical and follow the writing direction; `left`/`right` are physical. */
-    side?: Side;
-    align?: Align;
-    sideOffset?: number;
-    alignOffset?: number;
-    avoidCollisions?: boolean;
+    side?: Side | undefined;
+    align?: Align | undefined;
+    sideOffset?: number | undefined;
+    alignOffset?: number | undefined;
+    avoidCollisions?: boolean | undefined;
+    /** Minimum distance in pixels kept from the collision boundary; a number applies to every side, an object sets only the sides it names. */
+    collisionPadding?: number | Partial<Record<PhysicalSide, number>> | undefined;
+    /** Element(s) collisions are measured against, instead of the content's clipping ancestors. */
+    collisionBoundary?: Element | Element[] | null | undefined;
     /**
-     * Minimum distance in pixels kept from the collision boundary when avoiding
-     * collisions. A number applies to every side; an object sets only the sides
-     * it names, the rest falling back to `0`.
+     * Kebab-case component name the measurement CSS custom properties are namespaced under.
+     * @internal
+     * @default undefined — writes no measurement properties.
      */
-    collisionPadding?: number | Partial<Record<PhysicalSide, number>>;
+    component?: string | undefined;
     /**
-     * Element (or elements) collisions are measured against, instead of the
-     * content's clipping ancestors. Use it to keep an overlay inside a scroll
-     * container or one pane of a split layout rather than the whole viewport.
+     * Clearance in pixels between the arrow and each end of the panel's edge.
+     * @default 0
      */
-    collisionBoundary?: Element | Element[] | null;
+    arrowPadding?: number | undefined;
     /**
-     * Kebab-case component name the measurement CSS custom properties are
-     * namespaced under — `"popover"` yields `--skdx-popover-available-width` and
-     * friends. Belongs to the component, not to its consumer, so it is never a
-     * public prop.
-     * @internal
-     * @default undefined — an internal popper with no documented namespace writes no measurement properties at all.
+     * Hides the panel while the anchor is fully clipped out of view by a scroll container.
+     * @default false
      */
-    component?: string;
+    hideWhenDetached?: boolean | undefined;
 }
 /**
- * Writes the four measurement custom properties onto the floating element
- * after each reposition, so a consumer can size the panel from CSS alone
- * (`max-height: var(--skdx-select-available-height)`) instead of measuring in
- * JavaScript. Mirrored by `PopperContent`/`positionFloating` in the other four
- * packages and asserted by `assertPopperMeasurementProperties`.
- *
- * The transform origin is derived from the *resolved* side and alignment, so
- * a panel that flipped grows from the edge it actually landed on.
- *
- * ponytail: origin is edge-and-alignment accurate but not arrow-accurate —
- * a panel with a shifted arrow scales from the aligned edge rather than from
- * the arrow's tip. Feed the arrow middleware's offset in here if that ever
- * shows.
- * @internal
- */
-export declare function setMeasurementProperties(floating: HTMLElement, component: string, measurements: {
-    availableWidth: number;
-    availableHeight: number;
-    triggerWidth: number;
-    side: PhysicalSide;
-    align: Align;
-}): void;
-/**
- * Positions `floatingRef`'s element relative to `anchorRef`'s element while
- * `enabled` is true, re-running on scroll/resize/anchor-size-change.
- * Optionally positions an arrow element via `arrowRef`. Returns reactive
- * placement/style data; cleans up its own `autoUpdate` subscription when
- * `enabled` turns false or the owner component unmounts, and re-registers it
- * when either element changes identity while still enabled — matching React's
- * `whileElementsMounted`.
- *
- * `options` is read fresh on every positioning pass, so a call site may pass
- * its own reactive `props`, a ref or a getter and have a changed `side`,
- * offset or collision setting actually reposition the content. A plain object
- * still works, but — being built once — freezes its values, exactly as a
- * literal always did.
+ * Positions a floating element relative to its anchor, re-running on scroll/resize, with an optional arrow.
  * @internal
  */
-export declare function usePopperPosition(anchorRef: Ref<HTMLElement | null>, floatingRef: Ref<HTMLElement | null>, enabled: Ref<boolean>, options?: MaybeRefOrGetter<PopperPositionOptions>, arrowRef?: Ref<HTMLElement | null>): {
-    style: import("vue").ComputedRef<CSSProperties>;
-    arrowStyle: import("vue").ComputedRef<CSSProperties>;
-    placedSide: import("vue").ComputedRef<PhysicalSide>;
-    placedAlign: import("vue").ComputedRef<Align>;
+export declare function usePopperPosition(anchorRef: Ref<HTMLElement | null> | Ref<VirtualAnchor | null>, floatingRef: Ref<HTMLElement | null>, enabled: Ref<boolean>, options?: MaybeRefOrGetter<PopperPositionOptions>, arrowRef?: Ref<HTMLElement | null>): {
+    style: ComputedRef<CSSProperties>;
+    arrowStyle: ComputedRef<CSSProperties>;
+    placedSide: ComputedRef<PhysicalSide>;
+    placedAlign: ComputedRef<Align>;
+    reposition: () => void;
 };

package/dist/utils/popper.js

@@ -1 +1 @@
-import{resolveDirection as e,resolvePhysicalSide as t,useDirection as i}from"./direction.js";import{computed as o,onBeforeUnmount as a,ref as n,shallowRef as l,toValue as s,watch as r}from"vue";import{arrow as d,autoUpdate as p,computePosition as f,flip as u,limitShift as c,offset as m,shift as v,size as g}from"@floating-ui/dom";var x=/* @__PURE__ */Symbol("skdx-popper-context"),h=/* @__PURE__ */Symbol("skdx-popper-arrow-context");function y(e,t){return"center"===t?e:`${e}-${t}`}var b={top:"bottom",right:"left",bottom:"top",left:"right"},$={start:"0%",center:"50%",end:"100%"};function P(e,t,i){const{availableWidth:o,availableHeight:a,triggerWidth:n,side:l,align:s}=i,r=$[s],d="top"===l||"bottom"===l?`${r} ${"top"===l?"100%":"0%"}`:`${"left"===l?"100%":"0%"} ${r}`;e.style.setProperty(`--skdx-${t}-available-width`,`${o}px`),e.style.setProperty(`--skdx-${t}-available-height`,`${a}px`),e.style.setProperty(`--skdx-${t}-trigger-width`,`${n}px`),e.style.setProperty(`--skdx-${t}-transform-origin`,d)}function w(x,h,$,w={},O){function A(){const{side:e="bottom",align:t="center",sideOffset:i=0,alignOffset:o=0,avoidCollisions:a=!0,collisionPadding:n=8,collisionBoundary:l,component:r}=s(w);return{side:e,align:t,sideOffset:i,alignOffset:o,avoidCollisions:a,collisionPadding:n,collisionBoundary:l,component:r}}const k=i(),S=i=>t(i,e(x.value,k())),W=A(),C=n(S(W.side)),B=n(W.align),R=l({position:"fixed",left:"0px",top:"0px"}),T=l({position:"absolute"});let X,D,E=0;function F(){const e=x.value,t=h.value;if(!e||!t)return;const{side:i,align:o,sideOffset:a,alignOffset:n,avoidCollisions:l,collisionPadding:s,collisionBoundary:r,component:p}=A(),$=r?{boundary:r}:{},w=++E;f(e,t,{strategy:"fixed",placement:y(S(i),o),middleware:[m({mainAxis:a,alignmentAxis:n}),...l?[u({padding:s,...$}),v({padding:s,limiter:c(),...$})]:[],g({padding:s,...$,apply({availableWidth:e,availableHeight:t,elements:i,rects:o,placement:a}){if(!p)return;const[n,l="center"]=a.split("-");P(i.floating,p,{availableWidth:e,availableHeight:t,triggerWidth:o.reference.width,side:n,align:l})}}),...O?.value?[d({element:O.value})]:[]]}).then(({x:e,y:t,placement:i,middlewareData:o})=>{if(w!==E)return;R.value={position:"fixed",left:`${e}px`,top:`${t}px`};const[a,n="center"]=i.split("-");C.value=a,B.value=n;const l=o.arrow,s=b[a];T.value={position:"absolute",left:null!=l?.x?`${l.x}px`:void 0,top:null!=l?.y?`${l.y}px`:void 0,..."top"===s&&{top:"0px",transform:"translateY(-100%)"},..."bottom"===s&&{bottom:"0px",transform:"translateY(100%)"},..."left"===s&&{left:"0px",transform:"translateX(-100%)"},..."right"===s&&{right:"0px",transform:"translateX(100%)"}}})}function H(){D=void 0;const e=x.value,t=h.value;!e||!t||X||(X=p(e,t,F))}function j(){void 0!==D&&cancelAnimationFrame(D),D=void 0,X?.(),X=void 0}return typeof document<"u"&&(r($,e=>{e?void 0===D&&(D=requestAnimationFrame(H)):j()},{immediate:!0}),r([x,h],([e,t])=>{$.value&&(j(),e&&t&&(D=requestAnimationFrame(H)))}),r(()=>Object.values(A()),()=>{$.value&&F()}),a(j)),{style:o(()=>R.value),arrowStyle:o(()=>T.value),placedSide:o(()=>C.value),placedAlign:o(()=>B.value)}}export{h as ARROW_CONTEXT,x as POPPER_CONTEXT,P as setMeasurementProperties,w as usePopperPosition};
+import{resolveDirection as e,resolvePhysicalSide as i,useDirection as o}from"./direction.js";import{arrowStyle as a,placementParts as n,positioningMiddleware as t,toPlacement as s}from"./placement.js";import{computed as l,onBeforeUnmount as d,ref as r,shallowRef as c,toValue as f,watch as u}from"vue";import{arrow as p,autoUpdate as m,computePosition as v,flip as h,hide as g,limitShift as P,offset as w,shift as y,size as x}from"@floating-ui/dom";var O={offset:w,flip:h,shift:y,limitShift:P,size:x,arrow:p,hide:g},S=/* @__PURE__ */Symbol("skdx-popper-context"),D=/* @__PURE__ */Symbol("skdx-popper-arrow-context");function b(p,h,g,P={},w){function y(){const{side:e="bottom",align:i="center",sideOffset:o=0,alignOffset:a=0,avoidCollisions:n=!0,collisionPadding:t=8,collisionBoundary:s,component:l,arrowPadding:d=0,hideWhenDetached:r=!1}=f(P);return{side:e,align:i,sideOffset:o,alignOffset:a,avoidCollisions:n,collisionPadding:t,collisionBoundary:s,component:l,arrowPadding:d,hideWhenDetached:r}}const x=o(),S=o=>i(o,e((()=>{const e=p.value;return e&&"nodeType"in e?e:e?.contextElement??null})(),x())),D=y(),b=r(S(D.side)),C=r(D.align),A=c({position:"fixed",left:"0px",top:"0px"}),B=c({position:"absolute"});let E,T,W=0;function R(){const e=p.value,i=h.value;if(!e||!i)return;const{side:o,align:l,sideOffset:d,alignOffset:r,avoidCollisions:c,collisionPadding:f,collisionBoundary:u,component:m,arrowPadding:g,hideWhenDetached:P}=y(),x=++W;v(e,i,{strategy:"fixed",placement:s(S(o),l),middleware:t(O,{sideOffset:d,alignOffset:r,avoidCollisions:c,collisionPadding:f,collisionBoundary:u,component:m,arrow:w?.value,arrowPadding:g,hideWhenDetached:P})}).then(({x:e,y:i,placement:o,middlewareData:t})=>{if(x!==W)return;const s=!0===t.hide?.referenceHidden;A.value={position:"fixed",left:`${e}px`,top:`${i}px`,...s&&{visibility:"hidden",pointerEvents:"none"}};const[l,d]=n(o);b.value=l,C.value=d,B.value=a(t.arrow,l)})}function j(){T=void 0;const e=p.value,i=h.value;!e||!i||E||(E=m(e,i,R))}function F(){void 0!==T&&cancelAnimationFrame(T),T=void 0,E?.(),E=void 0}return typeof document<"u"&&(u(g,e=>{e?void 0===T&&(T=requestAnimationFrame(j)):F()},{immediate:!0}),u([p,h],([e,i])=>{g.value&&(F(),e&&i&&(T=requestAnimationFrame(j)))}),u(()=>Object.values(y()),()=>{g.value&&R()}),d(F)),{style:l(()=>A.value),arrowStyle:l(()=>B.value),placedSide:l(()=>b.value),placedAlign:l(()=>C.value),reposition:R}}export{D as ARROW_CONTEXT,S as POPPER_CONTEXT,b as usePopperPosition};

package/dist/utils/portal.d.cts

@@ -1,20 +1,2 @@
-/**
- * Where a `SkdxPortal` — or any per-component `Skdx*Portal` part, which all
- * delegate to it — may move its children.
- *
- * Declared once because seventeen call sites repeat it, and because the union
- * is the package's portal contract rather than any one part's detail.
- *
- * Superset of React's `PortalProps['container']`
- * (`packages/react/src/utils/portal.tsx:11` — `Element | DocumentFragment |
- * null`) by the CSS-selector string Vue's `<Teleport to>` also accepts. The
- * `DocumentFragment` arm is the one that matters: a `ShadowRoot` *is* a
- * `DocumentFragment` and not an `HTMLElement`, so the narrower
- * `string | HTMLElement | null` this replaced could not express the
- * shadow-DOM host that portalling into an arbitrary container exists for.
- * `Element` rather than `HTMLElement` for the same reason on the SVG side.
- *
- * `null` means "no container given" and resolves to `document.body`, matching
- * React, whose `container ?? document.body` fallback does the same.
- */
+/** Where SkdxPortal may move children: a CSS selector, an Element (including SVG), a DocumentFragment (e.g. ShadowRoot), or `null` for `document.body`. */
 export type PortalContainer = string | Element | DocumentFragment | null;

package/dist/utils/portal.d.ts

@@ -1,20 +1,2 @@
-/**
- * Where a `SkdxPortal` — or any per-component `Skdx*Portal` part, which all
- * delegate to it — may move its children.
- *
- * Declared once because seventeen call sites repeat it, and because the union
- * is the package's portal contract rather than any one part's detail.
- *
- * Superset of React's `PortalProps['container']`
- * (`packages/react/src/utils/portal.tsx:11` — `Element | DocumentFragment |
- * null`) by the CSS-selector string Vue's `<Teleport to>` also accepts. The
- * `DocumentFragment` arm is the one that matters: a `ShadowRoot` *is* a
- * `DocumentFragment` and not an `HTMLElement`, so the narrower
- * `string | HTMLElement | null` this replaced could not express the
- * shadow-DOM host that portalling into an arbitrary container exists for.
- * `Element` rather than `HTMLElement` for the same reason on the SVG side.
- *
- * `null` means "no container given" and resolves to `document.body`, matching
- * React, whose `container ?? document.body` fallback does the same.
- */
+/** Where SkdxPortal may move children: a CSS selector, an Element (including SVG), a DocumentFragment (e.g. ShadowRoot), or `null` for `document.body`. */
 export type PortalContainer = string | Element | DocumentFragment | null;

package/dist/utils/qr-encoder.cjs

@@ -0,0 +1 @@
+var T={L:1,M:0,Q:3,H:2},z={L:0,M:1,Q:2,H:3},I=[[-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]],F=[[-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]];var V=3,Q=3,Y=40,j=10;function A(t){return t*4+17}function K(t){let n=(16*t+128)*t+64;if(t>=2){const r=Math.floor(t/7)+2;n-=(25*r-10)*r-55,t>=7&&(n-=36)}return n}function E(t){return Math.floor(K(t)/8)}function y(t,n){const r=z[n],e=I[r][t]*F[r][t];return(E(t)-e)*8}function x(t){if(t===1)return[];const n=Math.floor(t/7)+2,r=t===32?26:Math.ceil((t*4+4)/(n*2-2))*2,e=[6];for(let o=A(t)-7;e.length<n;o-=r)e.splice(1,0,o);return e}var w=new Uint8Array(512),P=new Uint8Array(256);{let t=1;for(let n=0;n<255;n++)w[n]=t,P[t]=n,t<<=1,t&256&&(t^=285);for(let n=255;n<512;n++)w[n]=w[n-255]}function k(t,n){return t===0||n===0?0:w[P[t]+P[n]]}function R(t){const n=new Uint8Array(t);n[t-1]=1;let r=1;for(let e=0;e<t;e++){for(let o=0;o<t;o++){const c=k(n[o]??0,r);n[o]=o+1<t?c^(n[o+1]??0):c}r=k(r,2)}return n}function X(t,n){const r=new Uint8Array(n.length);for(const e of t){const o=e^(r[0]??0);r.copyWithin(0,1),r[r.length-1]=0;for(let c=0;c<r.length;c++)r[c]=(r[c]??0)^k(n[c]??0,o)}return r}function O(t,n,r){let e=t;for(let o=0;o<r;o++)e=e<<1^(e>>>r-1)*n;return e}function U(t,n){const r=T[t]<<3|n;return((r<<10|O(r,1335,10))^21522)&32767}function D(t){return(t<<12|O(t,7973,12))&262143}function L(t){return t<=9?8:16}function m(t,n,r){for(let e=r-1;e>=0;e--)t.push(n>>>e&1)}function H(t,n,r){const e=y(n,r),o=[];m(o,4,4),m(o,t.length,L(n));for(const l of t)m(o,l,8);m(o,0,Math.min(4,e-o.length)),m(o,0,(8-o.length%8)%8);for(let l=236;o.length<e;l^=253)m(o,l,8);const c=new Uint8Array(o.length/8);for(let l=0;l<o.length;l++){const s=l>>>3;c[s]=(c[s]??0)|o[l]<<7-(l&7)}return c}function W(t,n,r){const e=z[r],o=F[e][n],c=I[e][n],l=E(n),s=o-l%o,a=Math.floor(l/o)-c,d=R(c),M=[];for(let i=0,h=0;i<o;i++){const N=a+(i<s?0:1),S=t.subarray(h,h+N);h+=N,M.push({data:S,ecc:X(S,d)})}const b=new Uint8Array(l);let _=0;for(let i=0;i<=a;i++)for(const h of M)i<h.data.length&&(b[_++]=h.data[i]);for(let i=0;i<c;i++)for(const h of M)b[_++]=h.ecc[i];return b}var G=[(t,n)=>(t+n)%2===0,(t,n)=>n%2===0,t=>t%3===0,(t,n)=>(t+n)%3===0,(t,n)=>(Math.floor(n/2)+Math.floor(t/3))%2===0,(t,n)=>t*n%2+t*n%3===0,(t,n)=>(t*n%2+t*n%3)%2===0,(t,n)=>((t+n)%2+t*n%3)%2===0];function q(t){const n=A(t),r=()=>Array.from({length:n},()=>new Array(n).fill(!1));return{size:n,modules:r(),isFunction:r()}}function f(t,n,r,e){t.modules[r][n]=e,t.isFunction[r][n]=!0}var u=(t,n)=>(t>>>n&1)!==0;function B(t,n,r){for(let e=-4;e<=4;e++)for(let o=-4;o<=4;o++){const c=n+o,l=r+e;if(c<0||c>=t.size||l<0||l>=t.size)continue;const s=Math.max(Math.abs(o),Math.abs(e));f(t,c,l,s!==2&&s!==4)}}function J(t,n,r){for(let e=-2;e<=2;e++)for(let o=-2;o<=2;o++)f(t,n+o,r+e,Math.max(Math.abs(o),Math.abs(e))!==1)}function p(t,n,r){const e=U(n,r),{size:o}=t;for(let c=0;c<=5;c++)f(t,8,c,u(e,c));f(t,8,7,u(e,6)),f(t,8,8,u(e,7)),f(t,7,8,u(e,8));for(let c=9;c<15;c++)f(t,14-c,8,u(e,c));for(let c=0;c<8;c++)f(t,o-1-c,8,u(e,c));for(let c=8;c<15;c++)f(t,8,o-15+c,u(e,c));f(t,8,o-8,!0)}function Z(t,n){if(n<7)return;const r=D(n);for(let e=0;e<18;e++){const o=u(r,e),c=t.size-11+e%3,l=Math.floor(e/3);f(t,c,l,o),f(t,l,c,o)}}function $(t,n,r){const{size:e}=t;for(let l=0;l<e;l++)f(t,6,l,l%2===0),f(t,l,6,l%2===0);B(t,3,3),B(t,e-4,3),B(t,3,e-4);const o=x(n),c=o.length-1;for(let l=0;l<=c;l++)for(let s=0;s<=c;s++)l===0&&s===0||l===0&&s===c||l===c&&s===0||J(t,o[l],o[s]);p(t,r,0),Z(t,n)}function g(t,n){const{size:r}=t;let e=0;for(let o=r-1;o>=1;o-=2){o===6&&(o=5);for(let c=0;c<r;c++)for(let l=0;l<2;l++){const s=o-l,a=(o+1&2)===0?r-1-c:c;t.isFunction[a][s]||e>=n.length*8||(t.modules[a][s]=u(n[e>>>3],7-(e&7)),e++)}}}function C(t,n){const r=G[n];for(let e=0;e<t.size;e++)for(let o=0;o<t.size;o++)!t.isFunction[e][o]&&r(o,e)&&(t.modules[e][o]=!t.modules[e][o])}function v(t,n){let r=0,e=t(0),o=1;for(let c=1;c<n;c++)t(c)===e?(o++,o===5?r+=V:o>5&&(r+=1)):(e=t(c),o=1);return r}function tt(t,n){let r=0;for(let e=0;e+10<n;e++){let o=0,c=0;for(let l=0;l<11;l++){const s=t(e+l)?1:0;o=o<<1|s,c|=s<<l}(o===1488||c===1488)&&(r+=Y)}return r}function nt(t){const{size:n,modules:r}=t;let e=0;for(let o=0;o+1<n;o++)for(let c=0;c+1<n;c++){const l=r[o][c];l===r[o][c+1]&&l===r[o+1][c]&&l===r[o+1][c+1]&&(e+=Q)}return e}function ot(t){const{size:n,modules:r}=t;let e=0;for(const c of r)for(const l of c)l&&e++;const o=n*n;return Math.floor(Math.abs(e*2-o)*10/o)*j}function et(t){const{size:n,modules:r}=t;let e=0;for(const o of[!0,!1])for(let c=0;c<n;c++){const l=s=>o?r[c][s]:r[s][c];e+=v(l,n),e+=tt(l,n)}return e+nt(t)+ot(t)}function rt(t,n){for(let r=1;r<=40;r++)if(4+L(r)+t*8<=y(r,n))return r;return null}function ct(t,n,r){const e=new TextEncoder().encode(t);let o;if(r===void 0?o=rt(e.length,n):!Number.isInteger(r)||r<1||r>40?o=null:o=4+L(r)+e.length*8<=y(r,n)?r:null,o===null)return null;const c=q(o);$(c,o,n),g(c,W(H(e,o,n),o,n));let l=0,s=1/0;for(let a=0;a<G.length;a++){C(c,a),p(c,n,a);const d=et(c);d<s&&(s=d,l=a),C(c,a)}return C(c,l),p(c,n,l),c.modules}exports.alignmentPatternPositions=x;exports.dataCapacityBits=y;exports.encodeQr=ct;exports.formatInfoBits=U;exports.moduleCount=A;exports.reedSolomonGeneratorPoly=R;exports.totalCodewords=E;exports.versionInfoBits=D;

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

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

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

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

package/dist/utils/qr-encoder.js

@@ -0,0 +1 @@
+var t={L:1,M:0,Q:3,H:2},n={L:0,M:1,Q:2,H:3},o=[[-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]],e=[[-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]];function r(t){return 4*t+17}function l(t){return Math.floor(function(t){let n=(16*t+128)*t+64;if(t>=2){const o=Math.floor(t/7)+2;n-=(25*o-10)*o-55,t>=7&&(n-=36)}return n}(t)/8)}function f(t,r){const f=n[r],s=o[f][t]*e[f][t];return 8*(l(t)-s)}function s(t){if(1===t)return[];const n=Math.floor(t/7)+2,o=32===t?26:2*Math.ceil((4*t+4)/(2*n-2)),e=[6];for(let l=r(t)-7;e.length<n;l-=o)e.splice(1,0,l);return e}var c=/* @__PURE__ */new Uint8Array(512),u=/* @__PURE__ */new Uint8Array(256);{let t=1;for(let n=0;n<255;n++)c[n]=t,u[t]=n,t<<=1,256&t&&(t^=285);for(let t=255;t<512;t++)c[t]=c[t-255]}function i(t,n){return 0===t||0===n?0:c[u[t]+u[n]]}function a(t){const n=new Uint8Array(t);n[t-1]=1;let o=1;for(let e=0;e<t;e++){for(let e=0;e<t;e++){const r=i(n[e]??0,o);n[e]=e+1<t?r^(n[e+1]??0):r}o=i(o,2)}return n}function h(t,n){const o=new Uint8Array(n.length);for(const e of t){const t=e^(o[0]??0);o.copyWithin(0,1),o[o.length-1]=0;for(let e=0;e<o.length;e++)o[e]=(o[e]??0)^i(n[e]??0,t)}return o}function d(t,n,o){let e=t;for(let t=0;t<o;t++)e=e<<1^(e>>>o-1)*n;return e}function g(n,o){const e=t[n]<<3|o;return 32767&(21522^(e<<10|d(e,1335,10)))}function M(t){return 262143&(t<<12|d(t,7973,12))}function m(t){return t<=9?8:16}function y(t,n,o){for(let e=o-1;e>=0;e--)t.push(n>>>e&1)}var z=[(t,n)=>(t+n)%2==0,(t,n)=>n%2==0,t=>t%3==0,(t,n)=>(t+n)%3==0,(t,n)=>(Math.floor(n/2)+Math.floor(t/3))%2==0,(t,n)=>t*n%2+t*n%3==0,(t,n)=>(t*n%2+t*n%3)%2==0,(t,n)=>((t+n)%2+t*n%3)%2==0];function w(t,n,o,e){t.modules[o][n]=e,t.isFunction[o][n]=!0}var A=(t,n)=>!!(t>>>n&1);function b(t,n,o){for(let e=-4;e<=4;e++)for(let r=-4;r<=4;r++){const l=n+r,f=o+e;if(l<0||l>=t.size||f<0||f>=t.size)continue;const s=Math.max(Math.abs(r),Math.abs(e));w(t,l,f,2!==s&&4!==s)}}function p(t,n,o){for(let e=-2;e<=2;e++)for(let r=-2;r<=2;r++)w(t,n+r,o+e,1!==Math.max(Math.abs(r),Math.abs(e)))}function v(t,n,o){const e=g(n,o),{size:r}=t;for(let n=0;n<=5;n++)w(t,8,n,A(e,n));w(t,8,7,A(e,6)),w(t,8,8,A(e,7)),w(t,7,8,A(e,8));for(let n=9;n<15;n++)w(t,14-n,8,A(e,n));for(let n=0;n<8;n++)w(t,r-1-n,8,A(e,n));for(let n=8;n<15;n++)w(t,8,r-15+n,A(e,n));w(t,8,r-8,!0)}function U(t,n){const o=z[n];for(let n=0;n<t.size;n++)for(let e=0;e<t.size;e++)!t.isFunction[n][e]&&o(e,n)&&(t.modules[n][e]=!t.modules[n][e])}function x(t,n){let o=0,e=t(0),r=1;for(let l=1;l<n;l++)t(l)===e?(r++,5===r?o+=3:r>5&&(o+=1)):(e=t(l),r=1);return o}function F(t,n){let o=0;for(let e=0;e+10<n;e++){let n=0,r=0;for(let o=0;o<11;o++){const l=t(e+o)?1:0;n=n<<1|l,r|=l<<o}(1488===n||1488===r)&&(o+=40)}return o}function B(t){const{size:n,modules:o}=t;let e=0;for(const t of[!0,!1])for(let r=0;r<n;r++){const l=n=>t?o[r][n]:o[n][r];e+=x(l,n),e+=F(l,n)}return e+function(t){const{size:n,modules:o}=t;let e=0;for(let t=0;t+1<n;t++)for(let r=0;r+1<n;r++){const n=o[t][r];n===o[t][r+1]&&n===o[t+1][r]&&n===o[t+1][r+1]&&(e+=3)}return e}(t)+function(t){const{size:n,modules:o}=t;let e=0;for(const t of o)for(const n of t)n&&e++;const r=n*n;return 10*Math.floor(10*Math.abs(2*e-r)/r)}(t)}function C(t,c,u){const i=(new TextEncoder).encode(t);let d;if(d=void 0===u?function(t,n){for(let o=1;o<=40;o++)if(4+m(o)+8*t<=f(o,n))return o;return null}(i.length,c):!Number.isInteger(u)||u<1||u>40?null:4+m(u)+8*i.length<=f(u,c)?u:null,null===d)return null;const g=function(t){const n=r(t),o=()=>Array.from({length:n},()=>new Array(n).fill(!1));return{size:n,modules:o(),isFunction:o()}}(d);(function(t,n,o){const{size:e}=t;for(let n=0;n<e;n++)w(t,6,n,n%2==0),w(t,n,6,n%2==0);b(t,3,3),b(t,e-4,3),b(t,3,e-4);const r=s(n),l=r.length-1;for(let n=0;n<=l;n++)for(let o=0;o<=l;o++)0===n&&0===o||0===n&&o===l||n===l&&0===o||p(t,r[n],r[o]);v(t,o,0),function(t,n){if(n<7)return;const o=M(n);for(let n=0;n<18;n++){const e=A(o,n),r=t.size-11+n%3,l=Math.floor(n/3);w(t,r,l,e),w(t,l,r,e)}}(t,n)})(g,d,c),function(t,n){const{size:o}=t;let e=0;for(let r=o-1;r>=1;r-=2){6===r&&(r=5);for(let l=0;l<o;l++)for(let f=0;f<2;f++){const s=r-f,c=r+1&2?l:o-1-l;t.isFunction[c][s]||e>=8*n.length||(t.modules[c][s]=A(n[e>>>3],7-(7&e)),e++)}}}(g,function(t,r,f){const s=n[f],c=e[s][r],u=o[s][r],i=l(r),d=c-i%c,g=Math.floor(i/c)-u,M=a(u),m=[];for(let n=0,o=0;n<c;n++){const e=g+(n<d?0:1),r=t.subarray(o,o+e);o+=e,m.push({data:r,ecc:h(r,M)})}const y=new Uint8Array(i);let z=0;for(let t=0;t<=g;t++)for(const n of m)t<n.data.length&&(y[z++]=n.data[t]);for(let t=0;t<u;t++)for(const n of m)y[z++]=n.ecc[t];return y}(function(t,n,o){const e=f(n,o),r=[];y(r,4,4),y(r,t.length,m(n));for(const n of t)y(r,n,8);y(r,0,Math.min(4,e-r.length)),y(r,0,(8-r.length%8)%8);for(let t=236;r.length<e;t^=253)y(r,t,8);const l=new Uint8Array(r.length/8);for(let t=0;t<r.length;t++){const n=t>>>3;l[n]=(l[n]??0)|r[t]<<7-(7&t)}return l}(i,d,c),d,c));let x=0,F=1/0;for(let t=0;t<z.length;t++){U(g,t),v(g,c,t);const n=B(g);n<F&&(F=n,x=t),U(g,t)}return U(g,x),v(g,c,x),g.modules}export{s as alignmentPatternPositions,f as dataCapacityBits,C as encodeQr,g as formatInfoBits,r as moduleCount,a as reedSolomonGeneratorPoly,l as totalCodewords,M as versionInfoBits};

package/dist/utils/reassertValue.d.cts

@@ -1,16 +1,2 @@
-/**
- * @internal Puts the source of truth back into a user-editable element after an
- * edit has had its chance to propagate.
- *
- * A native `input` event has *already* moved the DOM by the time a handler runs,
- * and Vue re-patches a `:value` binding only when the bound state itself moves.
- * So when a strictly controlled owner **rejects** the change — the component
- * emits, the owner declines to update the bound value — Vue re-renders nothing
- * and the rejected text stays on screen even though the component's value never
- * did. React does not have this problem: it re-renders and resets the node.
- *
- * `truth` is read *after* `nextTick` rather than passed by value, so it sees the
- * state the owner settled on rather than the one that existed mid-keystroke.
- * Uncontrolled (and accepted-controlled) use is a no-op: the two already agree.
- */
+/** @internal Resets an input to `truth` after a controlled owner rejects a change, since Vue won't re-render rejected text away on its own. */
 export declare function reassertValue(el: HTMLInputElement | HTMLTextAreaElement, truth: () => string): Promise<void>;

package/dist/utils/reassertValue.d.ts

@@ -1,16 +1,2 @@
-/**
- * @internal Puts the source of truth back into a user-editable element after an
- * edit has had its chance to propagate.
- *
- * A native `input` event has *already* moved the DOM by the time a handler runs,
- * and Vue re-patches a `:value` binding only when the bound state itself moves.
- * So when a strictly controlled owner **rejects** the change — the component
- * emits, the owner declines to update the bound value — Vue re-renders nothing
- * and the rejected text stays on screen even though the component's value never
- * did. React does not have this problem: it re-renders and resets the node.
- *
- * `truth` is read *after* `nextTick` rather than passed by value, so it sees the
- * state the owner settled on rather than the one that existed mid-keystroke.
- * Uncontrolled (and accepted-controlled) use is a no-op: the two already agree.
- */
+/** @internal Resets an input to `truth` after a controlled owner rejects a change, since Vue won't re-render rejected text away on its own. */
 export declare function reassertValue(el: HTMLInputElement | HTMLTextAreaElement, truth: () => string): Promise<void>;

package/dist/utils/renderProp.cjs

@@ -0,0 +1 @@
+let d=require("vue");var e=r=>r.render();e.props=["render"];exports.RenderProp=e;

package/dist/utils/renderProp.d.cts

@@ -0,0 +1,5 @@
+import { type FunctionalComponent } from 'vue';
+/** @internal Renders whatever a `render*` prop returns (VNode, string, or array) inline, avoiding `{{ }}` stringification. */
+export declare const RenderProp: FunctionalComponent<{
+    render: () => unknown;
+}>;

package/dist/utils/renderProp.d.ts

@@ -0,0 +1,5 @@
+import { type FunctionalComponent } from 'vue';
+/** @internal Renders whatever a `render*` prop returns (VNode, string, or array) inline, avoiding `{{ }}` stringification. */
+export declare const RenderProp: FunctionalComponent<{
+    render: () => unknown;
+}>;

package/dist/utils/renderProp.js

@@ -0,0 +1 @@
+import"vue";var r=r=>r.render();r.props=["render"];export{r as RenderProp};

package/dist/utils/resolveRel.cjs

@@ -0,0 +1 @@
+function n(r,e){return e!==void 0?e:r==="_blank"?"noopener noreferrer":void 0}exports.resolveRel=n;

package/dist/utils/resolveRel.d.cts

@@ -0,0 +1,5 @@
+/**
+ * Reverse-tabnabbing guard: defaults `rel` to `'noopener noreferrer'` when
+ * `target` is `'_blank'` and none was given; an explicit `rel` always wins.
+ */
+export declare function resolveRel(target: string | undefined, rel: string | undefined): string | undefined;

package/dist/utils/resolveRel.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Reverse-tabnabbing guard: defaults `rel` to `'noopener noreferrer'` when
+ * `target` is `'_blank'` and none was given; an explicit `rel` always wins.
+ */
+export declare function resolveRel(target: string | undefined, rel: string | undefined): string | undefined;

package/dist/utils/resolveRel.js

@@ -0,0 +1 @@
+function e(e,r){return void 0!==r?r:"_blank"===e?"noopener noreferrer":void 0}export{e as resolveRel};

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

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

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 @@
+var e="[disabled], [data-disabled]";function n(n){return n.matches(e)}function t(e,t,l){return Array.from(e?.querySelectorAll(t)??[]).filter(t=>!(n(t)||l&&t.closest(l)!==e))}function l(e,n,t){const l=n.filter(n=>e.includes(n));return l.length>0?null!==t&&l.includes(t)?t:l[0]:null!==t&&e.includes(t)?t:e[0]??null}function r(e,n){return e.map(e=>e.getAttribute(n)).filter(e=>null!==e&&""!==e)}function i(e,n,t=!1){return e||t?n?0:-1:0}export{e as DISABLED_ITEM_SELECTOR,t as enabledRovingItems,n as isRovingItemDisabled,l as resolveTabStopId,r as rovingItemIds,i as rovingTabIndex};

package/dist/utils/scoredFilter.cjs

@@ -0,0 +1 @@
+function i(e){return typeof e=="number"?e>0:e}function d(e,s,f){const t=Array.from(e.querySelectorAll(s)),c=t.map(r=>({el:r,score:f(r.id)}));if(!c.some(r=>r.score!==null))return t;const n=[...c].sort((r,o)=>(o.score??0)-(r.score??0));return n.forEach(({el:r},o)=>{r.style.order=String(o)}),n.map(r=>r.el)}exports.filterKeeps=i;exports.orderByScore=d;

package/dist/utils/scoredFilter.d.cts

@@ -0,0 +1,12 @@
+/** Filter predicate shared by Command, Combobox, Autocomplete, Select: boolean keeps/excludes; number filters and ranks. */
+export type ScoredFilterResult = boolean | number;
+/** Whether a {@link ScoredFilterResult} keeps the item: `0`/`false` exclude, `true`/positive keep, and a negative number also excludes. */
+export declare function filterKeeps(result: ScoredFilterResult): boolean;
+/**
+ * Returns `container`'s currently-visible option elements in traversal order
+ * (descending filter score, ties keeping DOM order) and sets inline CSS
+ * `order` on each to match; a no-op when nothing scores numerically.
+ *
+ * `order` only reorders inside a flex or grid container — the skin is responsible for the list being one.
+ */
+export declare function orderByScore(container: HTMLElement, optionSelector: string, scoreOf: (id: string) => number | null): HTMLElement[];

package/dist/utils/scoredFilter.d.ts

@@ -0,0 +1,12 @@
+/** Filter predicate shared by Command, Combobox, Autocomplete, Select: boolean keeps/excludes; number filters and ranks. */
+export type ScoredFilterResult = boolean | number;
+/** Whether a {@link ScoredFilterResult} keeps the item: `0`/`false` exclude, `true`/positive keep, and a negative number also excludes. */
+export declare function filterKeeps(result: ScoredFilterResult): boolean;
+/**
+ * Returns `container`'s currently-visible option elements in traversal order
+ * (descending filter score, ties keeping DOM order) and sets inline CSS
+ * `order` on each to match; a no-op when nothing scores numerically.
+ *
+ * `order` only reorders inside a flex or grid container — the skin is responsible for the list being one.
+ */
+export declare function orderByScore(container: HTMLElement, optionSelector: string, scoreOf: (id: string) => number | null): HTMLElement[];

package/dist/utils/scoredFilter.js

@@ -0,0 +1 @@
+function r(r){return"number"==typeof r?r>0:r}function e(r,e,o){const t=Array.from(r.querySelectorAll(e)),n=t.map(r=>({el:r,score:o(r.id)}));if(!n.some(r=>null!==r.score))return t;const s=[...n].sort((r,e)=>(e.score??0)-(r.score??0));return s.forEach(({el:r},e)=>{r.style.order=String(e)}),s.map(r=>r.el)}export{r as filterKeeps,e as orderByScore};

package/dist/utils/select-keyboard.cjs

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

package/dist/utils/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;