@skdx/react 0.27.0 → 0.29.0

package/dist/utils/segmentedField.d.ts

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

package/dist/utils/segmentedField.js

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

package/dist/utils/select-keyboard.cjs

@@ -0,0 +1,2 @@
+'use client';
+"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/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;

package/dist/utils/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/utils/select-keyboard.js

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

package/dist/utils/selection.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var l=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var p=(e,n)=>{for(var r in n)l(e,r,{get:n[r],enumerable:!0})},d=(e,n,r,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of c(n))!f.call(e,t)&&t!==r&&l(e,t,{get:()=>n[t],enumerable:!(i=g(n,t))||i.enumerable});return e};var y=e=>d(l({},"__esModule",{value:!0}),e);var b={};p(b,{nextSelection:()=>m,parseSelectionAttribute:()=>V,sameSelection:()=>x,selectedValueOf:()=>S,toSelectionValues:()=>u,toValues:()=>h});module.exports=y(b);var a=require("./dev-mode.cjs");function h(e){return Array.isArray(e)?e:e?[e]:[]}function s(e){if((0,a.isDevMode)())throw new RangeError(e);console.error(e)}function u(e,{multiple:n,label:r}){let i;Array.isArray(e)?i=e:i=e==null?[]:[e];let t=[];for(let o of i){if(typeof o!="string"){s(`[skdx] ${r}: a selection value must be a string, got ${o===null?"null":typeof o} (${JSON.stringify(o)}). If this is a change payload, read its \`value\` \u2014 the event carries { value, selectedValue } and only \`value\` goes back in.`);continue}o!==""&&t.push(o)}return n||t.length<=1?t:(s(`[skdx] ${r}: a single-selection control was given ${t.length} values (${t.join(", ")}). Only one can be held \u2014 pass a single value, or turn the control multiple. Set multiple (or type="multiple") to keep them all.`),[t[0]])}function S(e){return e.length>0?e[0]:null}function m(e,n,r,i=!1){return r?e.includes(n)?e.filter(t=>t!==n):[...e,n]:i&&e.length===1&&e[0]===n?[]:[n]}function x(e,n){return e.length===n.length&&e.every((r,i)=>r===n[i])}function V(e,n){return e==null?[]:u(e.split(",").map(r=>r.trim()),n)}0&&(module.exports={nextSelection,parseSelectionAttribute,sameSelection,selectedValueOf,toSelectionValues,toValues});

package/dist/utils/selection.d.cts

@@ -0,0 +1,58 @@
+/** Why a selection change happened: user-driven (keyboard or pointer) or set by the application. */
+export type SelectionChangeReason = 'keyboard' | 'pointer' | 'programmatic';
+/** The payload every single-or-many control's change event carries — the strict-out shape. */
+export interface SelectionChangeDetail {
+    /** The whole selection, always an array, in single and multiple mode alike. */
+    value: string[];
+    /** The first selected value, or `null` when nothing is selected. */
+    selectedValue: string | null;
+    /** The selection this change replaced, in the same array shape as `value`. */
+    previousValue?: string[];
+    /** What drove the change — see {@link SelectionChangeReason}. */
+    reason?: SelectionChangeReason;
+}
+/** Options {@link toSelectionValues} needs to apply the single-selection rule. */
+export interface SelectionValueOptions {
+    /** Whether the control may hold more than one value at once — `multiple`, or `type === 'multiple'` on the families that spell it that way. */
+    multiple: boolean;
+    /** The component and member named in the development error, e.g. `Select value`, so the message says which of a page's selects is wrong. */
+    label: string;
+}
+/** Every selected value as an array, whatever shape was passed; `''` and `undefined` mean nothing selected. */
+export declare function toValues(value: string | string[] | undefined): string[];
+/**
+ * Normalizes every selection value to `string[]`, enforcing the single-selection rule; called once at the boundary, never again downstream.
+ *
+ * @param input the value the consumer supplied, in any accepted shape
+ * @param options cardinality and label for errors — see {@link SelectionValueOptions}
+ * @returns the selection as an array; at most one element unless `multiple`
+ * @throws RangeError in development when an entry is not a string or a single-select gets multiple values
+ */
+export declare function toSelectionValues(input: string | readonly string[] | null | undefined, { multiple, label }: SelectionValueOptions): string[];
+/**
+ * The `selectedValue` half of the rule's output: the first selected value, or `null` (never `undefined` or `''`).
+ *
+ * @param values the normalized selection, as {@link toSelectionValues} returns it
+ * @returns the first selected value, or `null` when nothing is selected
+ */
+export declare function selectedValueOf(values: readonly string[]): string | null;
+/**
+ * The selection after choosing `value`: replaces it, or toggles it within the set when `multiple`.
+ *
+ * @param selected the current selection, already normalized
+ * @param value the option value the user committed
+ * @param multiple whether choosing toggles within a set rather than replacing
+ * @param deselectable whether re-choosing the only selected value clears it (single-select only)
+ * @returns the new selection as an array in both cardinalities
+ */
+export declare function nextSelection(selected: readonly string[], value: string, multiple: boolean, deselectable?: boolean): string[];
+/** Whether two selections are indistinguishable to a consumer: same values in the same order. */
+export declare function sameSelection(a: readonly string[], b: readonly string[]): boolean;
+/**
+ * Parses the attribute form — one comma-separated list under both cardinalities — with {@link toSelectionValues} enforcing the rule.
+ *
+ * @param attribute the raw attribute string, or `null` when absent
+ * @param options cardinality and label for errors
+ * @returns the selection as an array
+ */
+export declare function parseSelectionAttribute(attribute: string | null | undefined, options: SelectionValueOptions): string[];

package/dist/utils/selection.d.ts

@@ -0,0 +1,58 @@
+/** Why a selection change happened: user-driven (keyboard or pointer) or set by the application. */
+export type SelectionChangeReason = 'keyboard' | 'pointer' | 'programmatic';
+/** The payload every single-or-many control's change event carries — the strict-out shape. */
+export interface SelectionChangeDetail {
+    /** The whole selection, always an array, in single and multiple mode alike. */
+    value: string[];
+    /** The first selected value, or `null` when nothing is selected. */
+    selectedValue: string | null;
+    /** The selection this change replaced, in the same array shape as `value`. */
+    previousValue?: string[];
+    /** What drove the change — see {@link SelectionChangeReason}. */
+    reason?: SelectionChangeReason;
+}
+/** Options {@link toSelectionValues} needs to apply the single-selection rule. */
+export interface SelectionValueOptions {
+    /** Whether the control may hold more than one value at once — `multiple`, or `type === 'multiple'` on the families that spell it that way. */
+    multiple: boolean;
+    /** The component and member named in the development error, e.g. `Select value`, so the message says which of a page's selects is wrong. */
+    label: string;
+}
+/** Every selected value as an array, whatever shape was passed; `''` and `undefined` mean nothing selected. */
+export declare function toValues(value: string | string[] | undefined): string[];
+/**
+ * Normalizes every selection value to `string[]`, enforcing the single-selection rule; called once at the boundary, never again downstream.
+ *
+ * @param input the value the consumer supplied, in any accepted shape
+ * @param options cardinality and label for errors — see {@link SelectionValueOptions}
+ * @returns the selection as an array; at most one element unless `multiple`
+ * @throws RangeError in development when an entry is not a string or a single-select gets multiple values
+ */
+export declare function toSelectionValues(input: string | readonly string[] | null | undefined, { multiple, label }: SelectionValueOptions): string[];
+/**
+ * The `selectedValue` half of the rule's output: the first selected value, or `null` (never `undefined` or `''`).
+ *
+ * @param values the normalized selection, as {@link toSelectionValues} returns it
+ * @returns the first selected value, or `null` when nothing is selected
+ */
+export declare function selectedValueOf(values: readonly string[]): string | null;
+/**
+ * The selection after choosing `value`: replaces it, or toggles it within the set when `multiple`.
+ *
+ * @param selected the current selection, already normalized
+ * @param value the option value the user committed
+ * @param multiple whether choosing toggles within a set rather than replacing
+ * @param deselectable whether re-choosing the only selected value clears it (single-select only)
+ * @returns the new selection as an array in both cardinalities
+ */
+export declare function nextSelection(selected: readonly string[], value: string, multiple: boolean, deselectable?: boolean): string[];
+/** Whether two selections are indistinguishable to a consumer: same values in the same order. */
+export declare function sameSelection(a: readonly string[], b: readonly string[]): boolean;
+/**
+ * Parses the attribute form — one comma-separated list under both cardinalities — with {@link toSelectionValues} enforcing the rule.
+ *
+ * @param attribute the raw attribute string, or `null` when absent
+ * @param options cardinality and label for errors
+ * @returns the selection as an array
+ */
+export declare function parseSelectionAttribute(attribute: string | null | undefined, options: SelectionValueOptions): string[];

package/dist/utils/selection.js

@@ -0,0 +1,2 @@
+'use client';
+import{isDevMode as s}from"./dev-mode.js";function g(e){return Array.isArray(e)?e:e?[e]:[]}function l(e){if(s())throw new RangeError(e);console.error(e)}function a(e,{multiple:n,label:t}){let i;Array.isArray(e)?i=e:i=e==null?[]:[e];let r=[];for(let o of i){if(typeof o!="string"){l(`[skdx] ${t}: a selection value must be a string, got ${o===null?"null":typeof o} (${JSON.stringify(o)}). If this is a change payload, read its \`value\` \u2014 the event carries { value, selectedValue } and only \`value\` goes back in.`);continue}o!==""&&r.push(o)}return n||r.length<=1?r:(l(`[skdx] ${t}: a single-selection control was given ${r.length} values (${r.join(", ")}). Only one can be held \u2014 pass a single value, or turn the control multiple. Set multiple (or type="multiple") to keep them all.`),[r[0]])}function c(e){return e.length>0?e[0]:null}function f(e,n,t,i=!1){return t?e.includes(n)?e.filter(r=>r!==n):[...e,n]:i&&e.length===1&&e[0]===n?[]:[n]}function p(e,n){return e.length===n.length&&e.every((t,i)=>t===n[i])}function d(e,n){return e==null?[]:a(e.split(",").map(t=>t.trim()),n)}export{f as nextSelection,d as parseSelectionAttribute,p as sameSelection,c as selectedValueOf,a as toSelectionValues,g as toValues};

package/dist/utils/slot.cjs

@@ -1 +1,2 @@
-"use strict";var R=Object.create;var i=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,A=Object.prototype.hasOwnProperty;var H=(e,n)=>{for(var t in n)i(e,t,{get:n[t],enumerable:!0})},c=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of y(n))!A.call(e,r)&&r!==t&&i(e,r,{get:()=>n[r],enumerable:!(o=m(n,r))||o.enumerable});return e};var P=(e,n,t)=>(t=e!=null?R(g(e)):{},c(n||!e||!e.__esModule?i(t,"default",{value:e,enumerable:!0}):t,e)),k=e=>c(i({},"__esModule",{value:!0}),e);var h={};H(h,{Slot:()=>p});module.exports=k(h);var a=P(require("react"),1),f=require("./composeRefs.cjs"),d=require("./primitive.cjs");function l(...e){return e.filter(Boolean).join(" ")}function w(e){let n=e.props;return n&&"ref"in n&&n.ref!==void 0?n.ref:e.ref??void 0}function E(e,n){let t={...n};for(let o of Object.keys(e)){let r=e[o],s=n[o];/^on[A-Z]/.test(o)?r&&s?t[o]=(0,d.composeEventHandlers)(s,r):r&&(t[o]=r):o==="style"?t[o]={...r,...s}:o==="className"?t[o]=typeof s=="function"?(...u)=>l(r,s(...u)):l(r,s):t[o]=s!==void 0?s:r}return{...e,...t}}var p=a.forwardRef((e,n)=>{let{children:t,...o}=e;if(a.isValidElement(t)){let r=w(t),s=E(o,t.props);return t.type!==a.Fragment&&(s.ref=n?(0,f.composeRefs)(n,r):r),a.cloneElement(t,s)}if(a.Children.count(t)>1)throw new Error("[skandadx] Slot expects a single React element child.");return null});p.displayName="Slot";0&&(module.exports={Slot});
+'use client';
+"use strict";var R=Object.create;var c=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var h=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var w=(e,n)=>{for(var t in n)c(e,t,{get:n[t],enumerable:!0})},d=(e,n,t,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of g(n))!k.call(e,r)&&r!==t&&c(e,r,{get:()=>n[r],enumerable:!(s=y(n,r))||s.enumerable});return e};var A=(e,n,t)=>(t=e!=null?R(h(e)):{},d(n||!e||!e.__esModule?c(t,"default",{value:e,enumerable:!0}):t,e)),x=e=>d(c({},"__esModule",{value:!0}),e);var P={};w(P,{Slot:()=>m});module.exports=x(P);var a=A(require("react"),1),p=require("./composeRefs.cjs"),f=require("./part.cjs"),u=require("./primitive.cjs");function E(e){let n=e.props;return n&&"ref"in n&&n.ref!==void 0?n.ref:e.ref??void 0}function H(e,n){let t={...n};for(let s of Object.keys(e)){let r=e[s],o=n[s];/^on[A-Z]/.test(s)?r&&o?t[s]=(0,u.composeEventHandlers)(o,r):r&&(t[s]=r):s==="style"?t[s]={...r,...o}:s==="className"?t[s]=typeof o=="function"?(...i)=>(0,f.cx)(r,o(...i)):(0,f.cx)(r,o):t[s]=o!==void 0?o:r}return{...e,...t}}var m=({ref:e,...n})=>{let{children:t,...s}=n,r=a.Children.toArray(t),o=r.length===1?r[0]:t;if(a.isValidElement(o)){let l=E(o),i=H(s,o.props);return o.type!==a.Fragment&&(i.ref=e?(0,p.composeRefs)(e,l):l),a.cloneElement(o,i)}if(a.Children.count(o)>1)throw new Error("[skandadx] Slot expects a single React element child.");if(typeof o=="string"||typeof o=="number")throw new Error("[skandadx] Slot expects a single React element child, not text. Wrap it in an element.");return null};m.displayName="Slot";0&&(module.exports={Slot});

package/dist/utils/slot.d.cts

@@ -5,18 +5,10 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
      * A single React element to merge props (and ref) onto.
      * @default undefined — renders nothing if omitted.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
 }
 /**
- * Merges its own props (and ref) onto its single child element instead of
- * rendering a DOM node of its own. This is what powers the `asChild` prop
- * on every primitive: event handlers compose (both fire, yours first, and
- * yours can `preventDefault()` to cancel ours), `className` concatenates —
- * including when the child's `className` is a function, as react-router's
- * `NavLink` uses, in which case the merged value is itself a function — `style`
- * merges, and every other prop is overridden by the child's own value.
- *
- * Throws if given anything other than exactly one React element child.
+ * Merges its own props (and ref) onto its single child element instead of rendering a DOM node of its own — event handlers compose, `className` concatenates (even when the child's is a function), `style` merges, and other props are overridden by the child's own value. Throws on multiple children or a text child.
  *
  * @example
  * ```tsx
@@ -27,4 +19,9 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
  * </ButtonTrigger>
  * ```
  */
-export declare const Slot: React.ForwardRefExoticComponent<SlotProps & React.RefAttributes<HTMLElement>>;
+export declare const Slot: {
+    ({ ref: forwardedRef, ...props }: Omit<SlotProps, "ref"> & {
+        ref?: React.Ref<HTMLElement> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};

package/dist/utils/slot.d.ts

@@ -5,18 +5,10 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
      * A single React element to merge props (and ref) onto.
      * @default undefined — renders nothing if omitted.
      */
-    children?: React.ReactNode;
+    children?: React.ReactNode | undefined;
 }
 /**
- * Merges its own props (and ref) onto its single child element instead of
- * rendering a DOM node of its own. This is what powers the `asChild` prop
- * on every primitive: event handlers compose (both fire, yours first, and
- * yours can `preventDefault()` to cancel ours), `className` concatenates —
- * including when the child's `className` is a function, as react-router's
- * `NavLink` uses, in which case the merged value is itself a function — `style`
- * merges, and every other prop is overridden by the child's own value.
- *
- * Throws if given anything other than exactly one React element child.
+ * Merges its own props (and ref) onto its single child element instead of rendering a DOM node of its own — event handlers compose, `className` concatenates (even when the child's is a function), `style` merges, and other props are overridden by the child's own value. Throws on multiple children or a text child.
  *
  * @example
  * ```tsx
@@ -27,4 +19,9 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
  * </ButtonTrigger>
  * ```
  */
-export declare const Slot: React.ForwardRefExoticComponent<SlotProps & React.RefAttributes<HTMLElement>>;
+export declare const Slot: {
+    ({ ref: forwardedRef, ...props }: Omit<SlotProps, "ref"> & {
+        ref?: React.Ref<HTMLElement> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};

package/dist/utils/slot.js

@@ -1 +1,2 @@
-import*as a from"react";import{composeRefs as l}from"./composeRefs.js";import{composeEventHandlers as f}from"./primitive.js";function i(...o){return o.filter(Boolean).join(" ")}function d(o){let s=o.props;return s&&"ref"in s&&s.ref!==void 0?s.ref:o.ref??void 0}function p(o,s){let e={...s};for(let n of Object.keys(o)){let t=o[n],r=s[n];/^on[A-Z]/.test(n)?t&&r?e[n]=f(r,t):t&&(e[n]=t):n==="style"?e[n]={...t,...r}:n==="className"?e[n]=typeof r=="function"?(...c)=>i(t,r(...c)):i(t,r):e[n]=r!==void 0?r:t}return{...o,...e}}var u=a.forwardRef((o,s)=>{let{children:e,...n}=o;if(a.isValidElement(e)){let t=d(e),r=p(n,e.props);return e.type!==a.Fragment&&(r.ref=s?l(s,t):t),a.cloneElement(e,r)}if(a.Children.count(e)>1)throw new Error("[skandadx] Slot expects a single React element child.");return null});u.displayName="Slot";export{u as Slot};
+'use client';
+import*as a from"react";import{composeRefs as f}from"./composeRefs.js";import{cx as l}from"./part.js";import{composeEventHandlers as d}from"./primitive.js";function p(r){let o=r.props;return o&&"ref"in o&&o.ref!==void 0?o.ref:r.ref??void 0}function u(r,o){let s={...o};for(let n of Object.keys(r)){let t=r[n],e=o[n];/^on[A-Z]/.test(n)?t&&e?s[n]=d(e,t):t&&(s[n]=t):n==="style"?s[n]={...t,...e}:n==="className"?s[n]=typeof e=="function"?(...i)=>l(t,e(...i)):l(t,e):s[n]=e!==void 0?e:t}return{...r,...s}}var m=({ref:r,...o})=>{let{children:s,...n}=o,t=a.Children.toArray(s),e=t.length===1?t[0]:s;if(a.isValidElement(e)){let c=p(e),i=u(n,e.props);return e.type!==a.Fragment&&(i.ref=r?f(r,c):c),a.cloneElement(e,i)}if(a.Children.count(e)>1)throw new Error("[skandadx] Slot expects a single React element child.");if(typeof e=="string"||typeof e=="number")throw new Error("[skandadx] Slot expects a single React element child, not text. Wrap it in an element.");return null};m.displayName="Slot";export{m as Slot};

package/dist/utils/tabbable.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var i=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var r=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var s=(t,e)=>{for(var o in e)i(t,o,{get:e[o],enumerable:!0})},E=(t,e,o,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of r(e))!b.call(t,n)&&n!==o&&i(t,n,{get:()=>e[n],enumerable:!(a=l(e,n))||a.enumerable});return t};var u=t=>E(i({},"__esModule",{value:!0}),t);var c={};s(c,{TABBABLE_SELECTOR:()=>d,tabbablesWithin:()=>x});module.exports=u(c);var d=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function x(t){return Array.from(t.querySelectorAll(d))}0&&(module.exports={TABBABLE_SELECTOR,tabbablesWithin});

package/dist/utils/tabbable.d.cts

@@ -0,0 +1,8 @@
+/** The elements a `Tab` press can land on — this package's one definition of "tabbable", for components that have to walk the tab order by hand. */
+export declare const TABBABLE_SELECTOR: string;
+/**
+ * Every tabbable element inside `container`, in document order. Uses only the
+ * selector without visibility checks (unlike focus traps) because overlays are
+ * small subtrees only in the DOM while open.
+ */
+export declare function tabbablesWithin(container: Element): HTMLElement[];

package/dist/utils/tabbable.d.ts

@@ -0,0 +1,8 @@
+/** The elements a `Tab` press can land on — this package's one definition of "tabbable", for components that have to walk the tab order by hand. */
+export declare const TABBABLE_SELECTOR: string;
+/**
+ * Every tabbable element inside `container`, in document order. Uses only the
+ * selector without visibility checks (unlike focus traps) because overlays are
+ * small subtrees only in the DOM while open.
+ */
+export declare function tabbablesWithin(container: Element): HTMLElement[];

package/dist/utils/tabbable.js

@@ -0,0 +1,2 @@
+'use client';
+var e=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function n(t){return Array.from(t.querySelectorAll(e))}export{e as TABBABLE_SELECTOR,n as tabbablesWithin};

package/dist/utils/timer.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var o=Object.prototype.hasOwnProperty;var u=(i,e)=>{for(var s in e)a(i,s,{get:e[s],enumerable:!0})},p=(i,e,s,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of h(e))!o.call(i,t)&&t!==s&&a(i,t,{get:()=>e[t],enumerable:!(r=d(e,t))||r.enumerable});return i};var c=i=>p(a({},"__esModule",{value:!0}),i);var l={};u(l,{Timer:()=>n});module.exports=c(l);var n=class{constructor(e={}){this.phase="idle";this.accrued=0;this.startedAt=0;this.pausedByPage=!1;this.onVisibilityChange=()=>{document.hidden?this.pauseForPage():this.pausedByPage&&this.resume()};this.onPageHide=()=>{this.pauseForPage()};this.options=e,this.duration=e.duration??Number.POSITIVE_INFINITY,this.tickMs=e.tickMs??0,!(e.pauseWhenHidden===!1||typeof document>"u")&&(document.addEventListener("visibilitychange",this.onVisibilityChange),window.addEventListener("pagehide",this.onPageHide))}get state(){let e=this.measure();return{phase:this.phase,elapsed:e,remaining:this.duration-e,duration:this.duration}}start(e){e!==void 0&&(this.duration=e),this.clearHandles(),this.accrued=0,this.pausedByPage=!1,this.run()}pause(){this.pausedByPage=!1,this.phase==="running"&&(this.accrued=this.measure(),this.clearHandles(),this.setPhase("paused"))}resume(){this.pausedByPage=!1,this.phase==="paused"&&this.run()}reset(){this.clearHandles(),this.accrued=0,this.startedAt=0,this.pausedByPage=!1,this.setPhase("idle")}destroy(){this.clearHandles(),!(this.options.pauseWhenHidden===!1||typeof document>"u")&&(document.removeEventListener("visibilitychange",this.onVisibilityChange),window.removeEventListener("pagehide",this.onPageHide))}measure(){let e=this.phase==="running"?Date.now()-this.startedAt:0;return Math.min(this.accrued+e,this.duration)}run(){this.startedAt=Date.now();let e=this.duration-this.accrued;Number.isFinite(e)&&(this.completion=setTimeout(()=>this.complete(),Math.max(e,0))),this.tickMs>0&&(this.ticker=setInterval(()=>this.options.onTick?.(this.state),this.tickMs)),this.setPhase("running")}complete(){this.clearHandles(),this.accrued=this.duration,this.setPhase("complete"),this.tickMs>0&&this.options.onTick?.(this.state)}setPhase(e){this.phase!==e&&(this.phase=e,this.options.onPhaseChange?.(this.state))}clearHandles(){clearTimeout(this.completion),clearInterval(this.ticker),this.completion=void 0,this.ticker=void 0}pauseForPage(){this.phase==="running"&&(this.pause(),this.pausedByPage=!0)}};0&&(module.exports={Timer});