@skdx/react 0.28.0 → 0.29.0

package/dist/utils/segmentedField.d.ts

@@ -1,158 +1,86 @@
 import * as React from 'react';
-import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, 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`.
-     *
-     * Without it, a segment carries only `data-segment` and no class, so both
-     * families' `__segment` rules match nothing and the date or time field
-     * ships as run-together unstyled text: no padding, no selected-segment
-     * highlight, no placeholder treatment.
-     */
+    /** @internal The family rendering this field, so each segment can name itself (`skdx-date-field__segment` or `skdx-time-field__segment`). */
     family: 'date-field' | 'time-field';
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
     /** How far down the field is editable. */
     granularity: Granularity;
     /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
+    locale?: string | undefined;
     /** Forced hour cycle; omitted follows the locale. */
-    hourCycle?: HourCycle;
+    hourCycle?: HourCycle | undefined;
     /** Current per-segment values. */
     values: SegmentValues;
     /** See {@link DateFieldProps.shouldForceLeadingZeros}. */
-    shouldForceLeadingZeros?: boolean;
+    shouldForceLeadingZeros?: boolean | undefined;
     /**
      * See {@link TimeFieldProps.step} — seconds, driving both the finest
      * segment's arrow increment and the mirrored input's `step` attribute.
      */
-    step?: number;
+    step?: number | undefined;
     /** Called with the next per-segment values after any edit. */
     onValuesChange: (values: SegmentValues) => void;
     /** Value submitted by the hidden input; `null` submits an empty entry. */
     formValue: string | null;
-    /**
-     * `type` of the mirrored input — `'date'`/`'datetime-local'` for a DateField,
-     * `'time'` for a TimeField. Not cosmetic: it is what makes the browser check
-     * `min`/`max` natively and report `rangeUnderflow`/`rangeOverflow` through
-     * `checkValidity()`, which a `type="text"` mirror cannot do at all.
-     */
+    /** `type` of the mirrored input; not cosmetic, since it's what makes the browser check `min`/`max` natively and report `rangeUnderflow`/`rangeOverflow` through `checkValidity()`. */
     formType: 'date' | 'datetime-local' | 'time';
     /** `min` of the mirrored input, in the same wire shape as `formValue`. */
-    formMin?: string;
+    formMin?: string | undefined;
     /** `max` of the mirrored input, in the same wire shape as `formValue`. */
-    formMax?: string;
-    /**
-     * Pulls the values a `Home`/`End` keystroke produced back inside the field's
-     * own `min`/`max`. Those two keys mean "the extreme end of what this segment
-     * accepts", and with a bound in play that end is the bound rather than the
-     * segment's natural `0`/`59`. Only they clamp: typing and arrow-stepping must
-     * still be able to reach an out-of-range value, or the bounds could never
-     * raise the `rangeUnderflow`/`rangeOverflow` they exist for.
-     */
-    clampEdgeValues?: (values: SegmentValues) => SegmentValues;
-    disabled?: boolean;
-    readOnly?: boolean;
-    invalid?: boolean;
-    required?: boolean;
-    name?: string;
-    /**
-     * Id of the `<form>` this field submits into, for a field rendered outside it
-     * — inside a portalled Dialog, say. Forwarded to the hidden input's `form`
-     * attribute, and passed to `useFormReset` as the form id to resolve, so a
-     * field submitting elsewhere on the page also answers that form's reset.
-     */
-    form?: string;
+    formMax?: string | undefined;
+    /** Pulls the values a `Home`/`End` keystroke produced back inside the field's own `min`/`max`; only these two clamp, since typing and arrow-stepping must still reach out-of-range values for `rangeUnderflow`/`rangeOverflow` to fire. */
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    name?: string | undefined;
+    /** Id of the `<form>` this field submits into when rendered outside it (a portalled Dialog); forwarded to the hidden input and to `useFormReset`. */
+    form?: string | undefined;
     /** Writing direction override; without it, direction is read off the DOM. */
-    dir?: Direction;
+    dir?: Direction | undefined;
     /** See {@link SegmentedLabelProps.getSegmentLabel}. */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /** See {@link SegmentedLabelProps.emptySegmentText}. */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
     /** See {@link SegmentedLabelProps.getSegmentPlaceholder}. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
-    /**
-     * Called when the owning `<form>` is reset, so the field can put its
-     * segments back to the value it declared. Nothing here knows what that
-     * value is — `DateField`/`TimeField` own `defaultValue`.
-     */
-    onFormReset?: () => void;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
+    /** Called when the owning `<form>` is reset, so the field can put its segments back to the value it declared; `DateField`/`TimeField` own that value. */
+    onFormReset?: (() => void) | undefined;
 }
-/**
- * The three strings a segmented field shows or announces that `locale` cannot
- * translate: the accessible name of each segment, the `aria-valuetext` of an
- * untyped one, and the placeholder letters an untyped one *renders*. Segment
- * *order*, the literals between segments and the AM/PM names all come from
- * `Intl.DateTimeFormat` already — these three do not, because they describe
- * the widget rather than the value, and CLDR has nothing to say about how to
- * write a value that has not been entered.
- *
- * Shared verbatim by `DateFieldProps` and `TimeFieldProps`.
- */
+/** The three strings a segmented field shows or announces that `locale` cannot translate: each segment's accessible name, an untyped segment's `aria-valuetext`, and its placeholder letters; shared verbatim by `DateFieldProps` and `TimeFieldProps`. */
 export interface SegmentedLabelProps {
     /**
-     * Words the accessible name of one segment. Called per segment type
-     * (`'year'`, `'month'`, `'dayPeriod'`, …); return the built-in
-     * {@link SEGMENT_LABELS} entry for the ones you do not want to change.
+     * Words the accessible name of one segment, called per segment type; return the built-in {@link SEGMENT_LABELS} entry for the ones you don't want to change.
      * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
      */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /**
      * The `aria-valuetext` an untyped segment announces instead of a number it
      * does not have.
      * @default 'Empty'
      */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
     /**
-     * Words the placeholder letters one segment shows before it has been typed.
-     * Called per segment type (`'year'`, `'month'`, `'dayPeriod'`, …); return the
-     * built-in {@link SEGMENT_PLACEHOLDERS} entry for the ones you do not want to
-     * change.
-     *
-     * The separators around them *are* locale-derived; these letters are not, so
-     * a `de-DE` field renders `dd.mm.yyyy` until this prop turns it into
-     * `TT.MM.JJJJ`.
+     * Words the placeholder letters one segment shows before typed, called per segment type; return the built-in {@link SEGMENT_PLACEHOLDERS} entry for the ones you don't want to change. The separators are locale-derived, these letters are not.
      * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
      */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
 }
-/**
- * Renders one segmented field: a `role="group"` holding a `role="spinbutton"`
- * per editable segment interleaved with the locale's `aria-hidden` literals,
- * plus a hidden input for form submission.
- *
- * The forwarded ref is the root `<div>` with `checkValidity()`/
- * `reportValidity()` hung on it, both answering off that hidden input.
- *
- * A caveat worth knowing: the segments are `<span role="spinbutton">`, not
- * native controls, so a `<fieldset disabled>` ancestor does *not* disable them
- * on its own the way it disables an `<input>` — pass `disabled` explicitly.
- *
- * @internal
- */
-export declare const SegmentedField: React.ForwardRefExoticComponent<Omit<SegmentedFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** @internal Renders one segmented field: a `role="group"` holding a `role="spinbutton"` per editable segment plus a hidden input for form submission; a `<fieldset disabled>` ancestor does not disable the spinbuttons on its own, since they aren't native controls. */
+export declare const SegmentedField: {
+    ({ family, kind, granularity, locale, hourCycle, values, shouldForceLeadingZeros, step, onValuesChange, formValue, formType, formMin, formMax, clampEdgeValues, disabled, readOnly, invalid, required, name, form, dir, getSegmentLabel, emptySegmentText, getSegmentPlaceholder, onFormReset, asChild, children, ref: forwardedRef, ...props }: Omit<SegmentedFieldProps, "ref"> & {
+        ref?: React.Ref<HTMLDivElement & FormValidityHandle> | undefined;
+    }): React.ReactNode;
+    displayName: string;
+};

package/dist/utils/segmentedField.js

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

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