@skdx/react 0.26.0 → 0.28.0

package/dist/utils/segmentedField.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type Granularity, type HourCycle, type SegmentType, type SegmentValues } from './dateSegments.cjs';
+import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, type SegmentType, type SegmentValues } from './dateSegments.cjs';
 import { type Direction } from './direction.cjs';
 import { type PrimitivePropsWithRef } from './primitive.cjs';
 /**
@@ -29,9 +29,9 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
      * @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
+     * 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.
      */
     family: 'date-field' | 'time-field';
@@ -45,21 +45,57 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
     hourCycle?: HourCycle;
     /** Current per-segment values. */
     values: SegmentValues;
+    /** See {@link DateFieldProps.shouldForceLeadingZeros}. */
+    shouldForceLeadingZeros?: boolean;
+    /**
+     * See {@link TimeFieldProps.step} — seconds, driving both the finest
+     * segment's arrow increment and the mirrored input's `step` attribute.
+     */
+    step?: number;
     /** 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.
+     */
+    formType: 'date' | 'datetime-local' | 'time';
+    /** `min` of the mirrored input, in the same wire shape as `formValue`. */
+    formMin?: string;
+    /** `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;
     /** Writing direction override; without it, direction is read off the DOM. */
     dir?: Direction;
     /** See {@link SegmentedLabelProps.getSegmentLabel}. */
     getSegmentLabel?: (type: SegmentType) => string;
     /** See {@link SegmentedLabelProps.emptySegmentText}. */
     emptySegmentText?: string;
+    /** 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
@@ -68,11 +104,13 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
     onFormReset?: () => void;
 }
 /**
- * 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.
+ * 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`.
  */
@@ -90,6 +128,18 @@ export interface SegmentedLabelProps {
      * @default 'Empty'
      */
     emptySegmentText?: string;
+    /**
+     * 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`.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver;
 }
 /**
  * Renders one segmented field: a `role="group"` holding a `role="spinbutton"`

package/dist/utils/segmentedField.d.ts

@@ -1,5 +1,5 @@
 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 './dateSegments.js';
 import { type Direction } from './direction.js';
 import { type PrimitivePropsWithRef } from './primitive.js';
 /**
@@ -29,9 +29,9 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
      * @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
+     * 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.
      */
     family: 'date-field' | 'time-field';
@@ -45,21 +45,57 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
     hourCycle?: HourCycle;
     /** Current per-segment values. */
     values: SegmentValues;
+    /** See {@link DateFieldProps.shouldForceLeadingZeros}. */
+    shouldForceLeadingZeros?: boolean;
+    /**
+     * See {@link TimeFieldProps.step} — seconds, driving both the finest
+     * segment's arrow increment and the mirrored input's `step` attribute.
+     */
+    step?: number;
     /** 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.
+     */
+    formType: 'date' | 'datetime-local' | 'time';
+    /** `min` of the mirrored input, in the same wire shape as `formValue`. */
+    formMin?: string;
+    /** `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;
     /** Writing direction override; without it, direction is read off the DOM. */
     dir?: Direction;
     /** See {@link SegmentedLabelProps.getSegmentLabel}. */
     getSegmentLabel?: (type: SegmentType) => string;
     /** See {@link SegmentedLabelProps.emptySegmentText}. */
     emptySegmentText?: string;
+    /** 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
@@ -68,11 +104,13 @@ export interface SegmentedFieldProps extends Omit<PrimitivePropsWithRef<'div'>,
     onFormReset?: () => void;
 }
 /**
- * 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.
+ * 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`.
  */
@@ -90,6 +128,18 @@ export interface SegmentedLabelProps {
      * @default 'Empty'
      */
     emptySegmentText?: string;
+    /**
+     * 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`.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver;
 }
 /**
  * Renders one segmented field: a `role="group"` holding a `role="spinbutton"`

package/dist/utils/segmentedField.js

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

package/dist/utils/slot.cjs

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

package/dist/utils/slot.d.cts

@@ -11,10 +11,12 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
  * 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,
- * `style` merges, and every other prop is overridden by the child's own value.
+ * 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.
+ * Throws on multiple children, or on a text child that `asChild` cannot clone.
  *
  * @example
  * ```tsx

package/dist/utils/slot.d.ts

@@ -11,10 +11,12 @@ export interface SlotProps extends React.HTMLAttributes<HTMLElement> {
  * 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,
- * `style` merges, and every other prop is overridden by the child's own value.
+ * 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.
+ * Throws on multiple children, or on a text child that `asChild` cannot clone.
  *
  * @example
  * ```tsx

package/dist/utils/slot.js

@@ -1 +1 @@
-import*as r from"react";import{composeRefs as c}from"./composeRefs.js";import{composeEventHandlers as l}from"./primitive.js";function i(a){let t=a.props;return t&&"ref"in t&&t.ref!==void 0?t.ref:a.ref??void 0}function f(a,t){let e={...t};for(let n of Object.keys(a)){let o=a[n],s=t[n];/^on[A-Z]/.test(n)?o&&s?e[n]=l(s,o):o&&(e[n]=o):n==="style"?e[n]={...o,...s}:n==="className"?e[n]=[o,s].filter(Boolean).join(" "):e[n]=s!==void 0?s:o}return{...a,...e}}var d=r.forwardRef((a,t)=>{let{children:e,...n}=a;if(r.isValidElement(e)){let o=i(e),s=f(n,e.props);return e.type!==r.Fragment&&(s.ref=t?c(t,o):o),r.cloneElement(e,s)}if(r.Children.count(e)>1)throw new Error("[skandadx] Slot expects a single React element child.");return null});d.displayName="Slot";export{d as Slot};
+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};

package/dist/utils/tabbable.cjs

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

package/dist/utils/tabbable.d.cts

@@ -0,0 +1,12 @@
+/**
+ * The elements a `Tab` press can land on. One definition of what "tabbable"
+ * means in this package, for the 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,12 @@
+/**
+ * The elements a `Tab` press can land on. One definition of what "tabbable"
+ * means in this package, for the 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 @@
+var t=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function n(e){return Array.from(e.querySelectorAll(t))}export{t as TABBABLE_SELECTOR,n as tabbablesWithin};

package/dist/utils/useCallbackRef.d.cts

@@ -1,7 +1,5 @@
 /**
- * Returns a function with a stable identity across renders that always
- * invokes the *latest* `callback` passed in — avoids re-subscribing effects
- * or event listeners just because an inline callback prop changed identity.
+ * Stable function identity across renders that invokes the latest callback. Prevents re-subscribing listeners.
  *
  * @example
  * ```tsx

package/dist/utils/useCallbackRef.d.ts

@@ -1,7 +1,5 @@
 /**
- * Returns a function with a stable identity across renders that always
- * invokes the *latest* `callback` passed in — avoids re-subscribing effects
- * or event listeners just because an inline callback prop changed identity.
+ * Stable function identity across renders that invokes the latest callback. Prevents re-subscribing listeners.
  *
  * @example
  * ```tsx

package/dist/utils/useControllableState.d.cts

@@ -8,14 +8,10 @@ interface UseControllableStateParams<T> {
     onChange?: (state: T) => void;
 }
 /**
- * The controlled/uncontrolled pattern shared by every stateful primitive
- * (`Checkbox`'s `checked`, `Tabs`'s `value`, `Dialog`'s `open`, …). Behaves
- * like `useState` when `prop` is `undefined`; once `prop` is defined, the
- * returned value always mirrors it and `setValue` only calls `onChange`
- * instead of storing internal state.
- *
- * @returns A `[value, setValue]` tuple, same shape as `useState`.
+ * Controlled/uncontrolled pattern. Behaves like `useState` when `prop` is
+ * undefined; mirrors it once defined, with `setValue` calling `onChange` instead.
  *
+ * @returns `[value, setValue]` tuple like `useState`.
  * @example
  * ```tsx
  * function MyCheckbox({ checked: checkedProp, defaultChecked, onCheckedChange }: Props) {
@@ -24,7 +20,6 @@ interface UseControllableStateParams<T> {
  *     defaultProp: defaultChecked,
  *     onChange: onCheckedChange,
  *   });
- *   // `checked` works whether the consumer passed `checked` or `defaultChecked`.
  * }
  * ```
  */

package/dist/utils/useControllableState.d.ts

@@ -8,14 +8,10 @@ interface UseControllableStateParams<T> {
     onChange?: (state: T) => void;
 }
 /**
- * The controlled/uncontrolled pattern shared by every stateful primitive
- * (`Checkbox`'s `checked`, `Tabs`'s `value`, `Dialog`'s `open`, …). Behaves
- * like `useState` when `prop` is `undefined`; once `prop` is defined, the
- * returned value always mirrors it and `setValue` only calls `onChange`
- * instead of storing internal state.
- *
- * @returns A `[value, setValue]` tuple, same shape as `useState`.
+ * Controlled/uncontrolled pattern. Behaves like `useState` when `prop` is
+ * undefined; mirrors it once defined, with `setValue` calling `onChange` instead.
  *
+ * @returns `[value, setValue]` tuple like `useState`.
  * @example
  * ```tsx
  * function MyCheckbox({ checked: checkedProp, defaultChecked, onCheckedChange }: Props) {
@@ -24,7 +20,6 @@ interface UseControllableStateParams<T> {
  *     defaultProp: defaultChecked,
  *     onChange: onCheckedChange,
  *   });
- *   // `checked` works whether the consumer passed `checked` or `defaultChecked`.
  * }
  * ```
  */

package/dist/utils/useDismiss.cjs

@@ -1 +1 @@
-"use strict";var N=Object.create;var E=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var R=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var g=(e,n)=>{for(var o in n)E(e,o,{get:n[o],enumerable:!0})},F=(e,n,o,d)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of k(n))!T.call(e,r)&&r!==o&&E(e,r,{get:()=>n[r],enumerable:!(d=P(n,r))||d.enumerable});return e};var x=(e,n,o)=>(o=e!=null?N(R(e)):{},F(n||!e||!e.__esModule?E(o,"default",{value:e,enumerable:!0}):o,e)),K=e=>F(E({},"__esModule",{value:!0}),e);var j={};g(j,{useDismiss:()=>C});module.exports=K(j);var h=x(require("react"),1),c=require("./useCallbackRef.cjs"),u=[];function C({enabled:e,onEscapeKeyDown:n,onPointerDownOutside:o,onFocusOutside:d,onInteractOutside:r,insideSelector:l},L){let m=(0,c.useCallbackRef)(n),p=(0,c.useCallbackRef)(o),O=(0,c.useCallbackRef)(d),v=(0,c.useCallbackRef)(r);h.useEffect(()=>{if(!e)return;let i=globalThis.document,f={};u.push(f);let w=t=>{if(L.some(a=>a.current?.contains(t)))return!1;let s=t.nodeType===Node.ELEMENT_NODE?t:t.parentElement;return!(l&&s?.closest(l))},y=t=>{t.key==="Escape"&&u[u.length-1]===f&&m(t)},b=t=>{let s=t.target;s&&w(s)&&(v(t),p(t))},D=t=>{let s=t.target;if(!s||s===i.body||!w(s))return;let a=new CustomEvent("focus-outside",{detail:t,cancelable:!0});v(a),O(a)};i.addEventListener("keydown",y);let I=window.setTimeout(()=>{i.addEventListener("pointerdown",b,!0),i.addEventListener("focusin",D,!0)},0);return()=>{let t=u.indexOf(f);t!==-1&&u.splice(t,1),i.removeEventListener("keydown",y),window.clearTimeout(I),i.removeEventListener("pointerdown",b,!0),i.removeEventListener("focusin",D,!0)}},[e,m,p,O,v,l])}0&&(module.exports={useDismiss});
+"use strict";var N=Object.create;var l=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var R=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var g=(e,t)=>{for(var s in t)l(e,s,{get:t[s],enumerable:!0})},F=(e,t,s,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of k(t))!T.call(e,r)&&r!==s&&l(e,r,{get:()=>t[r],enumerable:!(a=P(t,r))||a.enumerable});return e};var x=(e,t,s)=>(s=e!=null?N(R(e)):{},F(t||!e||!e.__esModule?l(s,"default",{value:e,enumerable:!0}):s,e)),K=e=>F(l({},"__esModule",{value:!0}),e);var j={};g(j,{useDismiss:()=>C});module.exports=K(j);var h=x(require("react"),1),u=require("./useCallbackRef.cjs"),d=[];function C({enabled:e,onEscapeKeyDown:t,onPointerDownOutside:s,onFocusOutside:a,onInteractOutside:r,insideSelector:m},L){let p=(0,u.useCallbackRef)(t),O=(0,u.useCallbackRef)(s),w=(0,u.useCallbackRef)(a),v=(0,u.useCallbackRef)(r),f=(0,u.useCallbackRef)(n=>{if(L.some(E=>E.current?.contains(n)))return!1;let c=n.nodeType===Node.ELEMENT_NODE?n:n.parentElement;return!(m&&c?.closest(m))});h.useEffect(()=>{if(!e)return;let n=globalThis.document,c={};d.push(c);let E=o=>{o.key==="Escape"&&d[d.length-1]===c&&p(o)},y=o=>{let i=o.target;i&&f(i)&&(v(o),O(o))},b=o=>{let i=o.target;if(!i||i===n.body||!f(i))return;let D=new CustomEvent("focus-outside",{detail:o,cancelable:!0});v(D),w(D)};n.addEventListener("keydown",E);let I=window.setTimeout(()=>{n.addEventListener("pointerdown",y,!0),n.addEventListener("focusin",b,!0)},0);return()=>{let o=d.indexOf(c);o!==-1&&d.splice(o,1),n.removeEventListener("keydown",E),window.clearTimeout(I),n.removeEventListener("pointerdown",y,!0),n.removeEventListener("focusin",b,!0)}},[e,p,O,w,v,f])}0&&(module.exports={useDismiss});

package/dist/utils/useDismiss.d.cts

@@ -1,8 +1,7 @@
 import * as React from 'react';
 /**
- * What `onFocusOutside` receives. `focusin` is not cancelable, so there would
- * be nothing to `preventDefault()` on the real event — the handler gets a
- * cancelable stand-in carrying the original as its `detail` instead.
+ * What `onFocusOutside` receives. `focusin` is not cancelable, so handler gets
+ * cancelable stand-in carrying the original as its `detail`.
  */
 export type FocusOutsideEvent = CustomEvent<FocusEvent>;
 /** Either flavour of outside interaction, as `onInteractOutside` sees it. */
@@ -17,31 +16,23 @@ interface UseDismissOptions {
     /** Called when focus moves to an element outside every element in `insideRefs`. */
     onFocusOutside?: (event: FocusOutsideEvent) => void;
     /**
-     * Called for *either* kind of outside interaction, immediately **before**
-     * the specific handler above and with the same event object — so a single
-     * `preventDefault()` here is already visible to that handler and vetoes the
-     * dismissal whichever way it was triggered.
+     * Called for either kind of outside interaction, immediately before the
+     * specific handler above, with the same event object — so a single
+     * `preventDefault()` here vetoes the dismissal either way.
      */
     onInteractOutside?: (event: InteractOutsideEvent) => void;
     /**
-     * Extra "inside" region, as a selector the target is matched against with
-     * `closest()`. `insideRefs` covers the elements the layer holds a ref to; this
-     * covers the ones it does not — a submenu panel portalled out of the menu it
-     * belongs to is not `contains()`-reachable from the menu's content ref, yet a
-     * pointer-down or a focus landing in it is unambiguously inside the menu.
+     * Extra "inside" region, as a selector matched against the target with
+     * `closest()` — for elements `insideRefs` can't reach, like a submenu panel
+     * portalled out of the menu it belongs to.
      */
     insideSelector?: string;
 }
 /**
- * Layer dismissal behavior shared by every dismissible overlay. Consumers pass
- * refs of elements that count as "inside" — which for the input-driven
- * families (Combobox, Autocomplete, MultiSelect, TreeSelect) includes the
- * input and any toggle button, not just the floating panel: real DOM focus
- * lives out there for the whole interaction.
+ * Layer dismissal behavior shared by every dismissible overlay. Consumers pass refs
+ * of "inside" elements (input-driven families include input and toggle button, not just panel).
  *
- * This hook only *reports*: the caller decides what dismissal means (Dialog
- * ignores outside interaction unless modal, AlertDialog ignores it entirely)
- * by checking `event.defaultPrevented` in its own handler.
+ * Hook only reports; caller decides dismissal meaning by checking `event.defaultPrevented`.
  */
 export declare function useDismiss({ enabled, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, insideSelector, }: UseDismissOptions, insideRefs: Array<React.RefObject<Element | null>>): void;
 export {};

package/dist/utils/useDismiss.d.ts

@@ -1,8 +1,7 @@
 import * as React from 'react';
 /**
- * What `onFocusOutside` receives. `focusin` is not cancelable, so there would
- * be nothing to `preventDefault()` on the real event — the handler gets a
- * cancelable stand-in carrying the original as its `detail` instead.
+ * What `onFocusOutside` receives. `focusin` is not cancelable, so handler gets
+ * cancelable stand-in carrying the original as its `detail`.
  */
 export type FocusOutsideEvent = CustomEvent<FocusEvent>;
 /** Either flavour of outside interaction, as `onInteractOutside` sees it. */
@@ -17,31 +16,23 @@ interface UseDismissOptions {
     /** Called when focus moves to an element outside every element in `insideRefs`. */
     onFocusOutside?: (event: FocusOutsideEvent) => void;
     /**
-     * Called for *either* kind of outside interaction, immediately **before**
-     * the specific handler above and with the same event object — so a single
-     * `preventDefault()` here is already visible to that handler and vetoes the
-     * dismissal whichever way it was triggered.
+     * Called for either kind of outside interaction, immediately before the
+     * specific handler above, with the same event object — so a single
+     * `preventDefault()` here vetoes the dismissal either way.
      */
     onInteractOutside?: (event: InteractOutsideEvent) => void;
     /**
-     * Extra "inside" region, as a selector the target is matched against with
-     * `closest()`. `insideRefs` covers the elements the layer holds a ref to; this
-     * covers the ones it does not — a submenu panel portalled out of the menu it
-     * belongs to is not `contains()`-reachable from the menu's content ref, yet a
-     * pointer-down or a focus landing in it is unambiguously inside the menu.
+     * Extra "inside" region, as a selector matched against the target with
+     * `closest()` — for elements `insideRefs` can't reach, like a submenu panel
+     * portalled out of the menu it belongs to.
      */
     insideSelector?: string;
 }
 /**
- * Layer dismissal behavior shared by every dismissible overlay. Consumers pass
- * refs of elements that count as "inside" — which for the input-driven
- * families (Combobox, Autocomplete, MultiSelect, TreeSelect) includes the
- * input and any toggle button, not just the floating panel: real DOM focus
- * lives out there for the whole interaction.
+ * Layer dismissal behavior shared by every dismissible overlay. Consumers pass refs
+ * of "inside" elements (input-driven families include input and toggle button, not just panel).
  *
- * This hook only *reports*: the caller decides what dismissal means (Dialog
- * ignores outside interaction unless modal, AlertDialog ignores it entirely)
- * by checking `event.defaultPrevented` in its own handler.
+ * Hook only reports; caller decides dismissal meaning by checking `event.defaultPrevented`.
  */
 export declare function useDismiss({ enabled, onEscapeKeyDown, onPointerDownOutside, onFocusOutside, onInteractOutside, insideSelector, }: UseDismissOptions, insideRefs: Array<React.RefObject<Element | null>>): void;
 export {};

package/dist/utils/useDismiss.js

@@ -1 +1 @@
-import*as O from"react";import{useCallbackRef as r}from"./useCallbackRef.js";var o=[];function I({enabled:d,onEscapeKeyDown:w,onPointerDownOutside:y,onFocusOutside:b,onInteractOutside:D,insideSelector:i},F){let a=r(w),E=r(y),l=r(b),u=r(D);O.useEffect(()=>{if(!d)return;let n=globalThis.document,c={};o.push(c);let v=e=>{if(F.some(s=>s.current?.contains(e)))return!1;let t=e.nodeType===Node.ELEMENT_NODE?e:e.parentElement;return!(i&&t?.closest(i))},f=e=>{e.key==="Escape"&&o[o.length-1]===c&&a(e)},m=e=>{let t=e.target;t&&v(t)&&(u(e),E(e))},p=e=>{let t=e.target;if(!t||t===n.body||!v(t))return;let s=new CustomEvent("focus-outside",{detail:e,cancelable:!0});u(s),l(s)};n.addEventListener("keydown",f);let h=window.setTimeout(()=>{n.addEventListener("pointerdown",m,!0),n.addEventListener("focusin",p,!0)},0);return()=>{let e=o.indexOf(c);e!==-1&&o.splice(e,1),n.removeEventListener("keydown",f),window.clearTimeout(h),n.removeEventListener("pointerdown",m,!0),n.removeEventListener("focusin",p,!0)}},[d,a,E,l,u,i])}export{I as useDismiss};
+import*as O from"react";import{useCallbackRef as s}from"./useCallbackRef.js";var r=[];function I({enabled:d,onEscapeKeyDown:w,onPointerDownOutside:y,onFocusOutside:b,onInteractOutside:D,insideSelector:a},F){let E=s(w),l=s(y),v=s(b),u=s(D),c=s(e=>{if(F.some(i=>i.current?.contains(e)))return!1;let o=e.nodeType===Node.ELEMENT_NODE?e:e.parentElement;return!(a&&o?.closest(a))});O.useEffect(()=>{if(!d)return;let e=globalThis.document,o={};r.push(o);let i=t=>{t.key==="Escape"&&r[r.length-1]===o&&E(t)},f=t=>{let n=t.target;n&&c(n)&&(u(t),l(t))},m=t=>{let n=t.target;if(!n||n===e.body||!c(n))return;let p=new CustomEvent("focus-outside",{detail:t,cancelable:!0});u(p),v(p)};e.addEventListener("keydown",i);let h=window.setTimeout(()=>{e.addEventListener("pointerdown",f,!0),e.addEventListener("focusin",m,!0)},0);return()=>{let t=r.indexOf(o);t!==-1&&r.splice(t,1),e.removeEventListener("keydown",i),window.clearTimeout(h),e.removeEventListener("pointerdown",f,!0),e.removeEventListener("focusin",m,!0)}},[d,E,l,v,u,c])}export{I as useDismiss};

package/dist/utils/useFocusTrap.cjs

@@ -1 +1 @@
-"use strict";var F=Object.create;var a=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,x=Object.prototype.hasOwnProperty;var L=(e,t)=>{for(var o in t)a(e,o,{get:t[o],enumerable:!0})},m=(e,t,o,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of y(t))!x.call(e,n)&&n!==o&&a(e,n,{get:()=>t[n],enumerable:!(c=A(t,n))||c.enumerable});return e};var R=(e,t,o)=>(o=e!=null?F(T(e)):{},m(t||!e||!e.__esModule?a(o,"default",{value:e,enumerable:!0}):o,e)),O=e=>m(a({},"__esModule",{value:!0}),e);var H={};L(H,{autoFocusEvent:()=>f,useFocusTrap:()=>C});module.exports=O(H);var s=R(require("react"),1),h=["a[href]","button:not([disabled])",'input:not([disabled]):not([type="hidden"])',"select:not([disabled])","textarea:not([disabled])",'[tabindex]:not([tabindex="-1"])'].join(", ");function E(e){return Array.from(e.querySelectorAll(h)).filter(t=>t.offsetParent!==null||t===document.activeElement)}function f(e,t){if(!t)return!0;let o=new CustomEvent(e,{cancelable:!0,detail:null});return t(o),!o.defaultPrevented}function C(e,t,o={}){let c=s.useRef(o);s.useEffect(()=>{c.current=o}),s.useEffect(()=>{if(!t)return;let n=e.current;if(!n)return;let l=document.activeElement,p=requestAnimationFrame(()=>{if(n.contains(document.activeElement)||!f("open-auto-focus",c.current.onOpenAutoFocus))return;let r=E(n)[0]??n;n.tabIndex=n.tabIndex>=0?n.tabIndex:-1,r.focus({preventScroll:!0})}),d=u=>{if(u.key!=="Tab")return;let r=E(n);if(r.length===0){u.preventDefault();return}let b=r[0],v=r[r.length-1],i=document.activeElement;u.shiftKey&&(i===b||i===n)?(u.preventDefault(),v.focus()):!u.shiftKey&&i===v&&(u.preventDefault(),b.focus())};return n.addEventListener("keydown",d),()=>{cancelAnimationFrame(p),n.removeEventListener("keydown",d),f("close-auto-focus",c.current.onCloseAutoFocus)&&l&&document.contains(l)&&l.focus?.({preventScroll:!0})}},[e,t])}0&&(module.exports={autoFocusEvent,useFocusTrap});
+"use strict";var A=Object.create;var l=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var L=Object.getPrototypeOf,R=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var n in t)l(e,n,{get:t[n],enumerable:!0})},b=(e,t,n,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of T(t))!R.call(e,o)&&o!==n&&l(e,o,{get:()=>t[o],enumerable:!(c=y(t,o))||c.enumerable});return e};var O=(e,t,n)=>(n=e!=null?A(L(e)):{},b(t||!e||!e.__esModule?l(n,"default",{value:e,enumerable:!0}):n,e)),C=e=>b(l({},"__esModule",{value:!0}),e);var M={};x(M,{autoFocusEvent:()=>i,useFocusTrap:()=>H});module.exports=C(M);var s=O(require("react"),1),d=require("./tabbable.cjs");function p(e){return Array.from(e.querySelectorAll(d.TABBABLE_SELECTOR)).filter(t=>t.offsetParent!==null||t===document.activeElement)}function i(e,t){if(!t)return!0;let n=new CustomEvent(e,{cancelable:!0,detail:null});return t(n),!n.defaultPrevented}function H(e,t,n={}){let c=s.useRef(n);s.useEffect(()=>{c.current=n}),s.useEffect(()=>{if(!t)return;let o=e.current;if(!o)return;let a=document.activeElement,F=requestAnimationFrame(()=>{if(o.contains(document.activeElement)||!i("open-auto-focus",c.current.onOpenAutoFocus))return;let r=p(o)[0]??o;o.tabIndex=o.tabIndex>=0?o.tabIndex:-1,r.focus({preventScroll:!0})}),m=u=>{if(u.key!=="Tab")return;let r=p(o);if(r.length===0){u.preventDefault();return}let v=r[0],E=r[r.length-1],f=document.activeElement;u.shiftKey&&(f===v||f===o)?(u.preventDefault(),E.focus()):!u.shiftKey&&f===E&&(u.preventDefault(),v.focus())};return o.addEventListener("keydown",m),()=>{cancelAnimationFrame(F),o.removeEventListener("keydown",m),i("close-auto-focus",c.current.onCloseAutoFocus)&&a&&a!==document.body&&document.contains(a)&&a.focus?.({preventScroll:!0})}},[e,t])}0&&(module.exports={autoFocusEvent,useFocusTrap});

package/dist/utils/useFocusTrap.d.cts

@@ -15,11 +15,10 @@ export interface FocusTrapOptions {
     onCloseAutoFocus?: (event: AutoFocusEvent) => void;
 }
 /**
- * Traps Tab focus inside `containerRef` while `enabled`. Focuses the first
- * tabbable element (or the container) on mount and restores focus to the
- * previously focused element on unmount — each of those two moves first
- * announced as a cancelable `open-auto-focus` / `close-auto-focus` event, so
- * a consumer can redirect initial focus or take over the return when the
- * trigger no longer exists (the WAI-ARIA modal pattern's two escape hatches).
+ * Traps Tab focus inside `containerRef` while `enabled`: focuses the first
+ * tabbable element (or the container) on mount, restores focus on unmount —
+ * each move first announced as a cancelable `open-auto-focus`/`close-auto-focus`
+ * event, so a consumer can redirect initial focus or take over the return
+ * (the WAI-ARIA modal pattern's two escape hatches).
  */
 export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, enabled: boolean, options?: FocusTrapOptions): void;