@skdx/vue 0.27.0 → 0.29.0

package/dist/utils/Portal.vue.d.cts

@@ -1,15 +1,6 @@
 import type { PortalContainer } from './portal.cjs';
 /**
- * Teleports its children into a different part of the DOM (`document.body` by
- * default) — so overlay content escapes clipping/`overflow: hidden`
- * ancestors and any ancestor `transform`/`filter`/`contain` that would
- * otherwise become the containing block for `position: fixed` descendants.
- *
- * Thin wrapper over Vue's own `<Teleport>`, exposed publicly so consumers can
- * portal their own content the same way the overlay components portal theirs.
- * Every per-component `Skdx*Portal` part delegates here and forwards its own
- * `container`, so they all accept the same targets; this one is the bare
- * mechanism, with no family `open` state gating it.
+ * Teleports children into a different DOM part (default: body) to escape clipping/overflow/transform ancestors.
  *
  * @example
  * ```vue
@@ -23,8 +14,8 @@ type __VLS_Props = {
      * DOM node (or CSS selector) the children are moved into.
      * @default 'body'
      */
-    container?: PortalContainer;
-    /** Renders the children in place instead of teleporting them — useful for SSR or for a temporary opt-out. */
+    container?: PortalContainer | undefined;
+    /** Renders children in place (useful for SSR or opt-out). */
     disabled?: boolean;
 };
 declare var __VLS_5: {};
@@ -33,7 +24,7 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
-    container: PortalContainer;
+    container: PortalContainer | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/utils/Portal.vue.d.ts

@@ -1,15 +1,6 @@
 import type { PortalContainer } from './portal.js';
 /**
- * Teleports its children into a different part of the DOM (`document.body` by
- * default) — so overlay content escapes clipping/`overflow: hidden`
- * ancestors and any ancestor `transform`/`filter`/`contain` that would
- * otherwise become the containing block for `position: fixed` descendants.
- *
- * Thin wrapper over Vue's own `<Teleport>`, exposed publicly so consumers can
- * portal their own content the same way the overlay components portal theirs.
- * Every per-component `Skdx*Portal` part delegates here and forwards its own
- * `container`, so they all accept the same targets; this one is the bare
- * mechanism, with no family `open` state gating it.
+ * Teleports children into a different DOM part (default: body) to escape clipping/overflow/transform ancestors.
  *
  * @example
  * ```vue
@@ -23,8 +14,8 @@ type __VLS_Props = {
      * DOM node (or CSS selector) the children are moved into.
      * @default 'body'
      */
-    container?: PortalContainer;
-    /** Renders the children in place instead of teleporting them — useful for SSR or for a temporary opt-out. */
+    container?: PortalContainer | undefined;
+    /** Renders children in place (useful for SSR or opt-out). */
     disabled?: boolean;
 };
 declare var __VLS_5: {};
@@ -33,7 +24,7 @@ type __VLS_Slots = {} & {
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     disabled: boolean;
-    container: PortalContainer;
+    container: PortalContainer | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/utils/Portal.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-let e=require("vue");var a=(0,e.defineComponent)({__name:"Portal",props:{container:{default:null},disabled:{type:Boolean,default:!1}},setup(t){return(l,o)=>((0,e.openBlock)(),(0,e.createBlock)(e.Teleport,{to:t.container??"body",disabled:t.disabled},[(0,e.renderSlot)(l.$slots,"default")],8,["to","disabled"]))}});exports.default=a;
+let e=require("vue");var u=(0,e.defineComponent)({__name:"Portal",props:{container:{default:null},disabled:{type:Boolean,default:!1}},setup(t){const l=(0,e.ref)(!((0,e.inject)(e.ssrContextKey,null)!==null||(0,e.getCurrentInstance)()?.vnode.el!==null));return(0,e.onMounted)(()=>{l.value=!0}),(n,a)=>((0,e.openBlock)(),(0,e.createBlock)(e.Teleport,{to:t.container??"body",disabled:t.disabled||!l.value},[(0,e.renderSlot)(n.$slots,"default")],8,["to","disabled"]))}});exports.default=u;

package/dist/utils/Portal.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{Teleport as e,createBlock as a,defineComponent as o,openBlock as t,renderSlot as l}from"vue";var d=/* @__PURE__ */o({__name:"Portal",props:{container:{default:null},disabled:{type:Boolean,default:!1}},setup:o=>(d,s)=>(t(),a(e,{to:o.container??"body",disabled:o.disabled},[l(d.$slots,"default")],8,["to","disabled"]))});export{d as default};
+import{Teleport as e,createBlock as a,defineComponent as t,getCurrentInstance as l,inject as n,onMounted as o,openBlock as s,ref as r,renderSlot as d,ssrContextKey as u}from"vue";var i=/* @__PURE__ */t({__name:"Portal",props:{container:{default:null},disabled:{type:Boolean,default:!1}},setup(t){const i=r(!(null!==n(u,null)||null!==l()?.vnode.el));return o(()=>{i.value=!0}),(l,n)=>(s(),a(e,{to:t.container??"body",disabled:t.disabled||!i.value},[d(l.$slots,"default")],8,["to","disabled"]))}});export{i as default};

package/dist/utils/SegmentedField.vue.d.cts

@@ -1,13 +1,7 @@
-import { type Granularity, type HourCycle, type SegmentType, type SegmentValues } from './dateSegments.cjs';
+import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, type SegmentType, type SegmentValues } from './date-segments.cjs';
 import { type Direction } from './direction.cjs';
 type __VLS_Props = {
-    /**
-     * @internal The field rendering this, so each segment can name its own part
-     * — `skdx-date-field__segment` / `skdx-time-field__segment`. Shared code
-     * cannot hard-code one family, and a segment with no class is a segment the
-     * skin cannot reach: mirrors React's `segmentedField.tsx`, which takes the
-     * same prop for the same reason.
-     */
+    /** @internal Field family name used for segment part classes. */
     family: 'date-field' | 'time-field';
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
@@ -15,48 +9,73 @@ type __VLS_Props = {
     granularity: Granularity;
     /** Current per-segment values. */
     values: SegmentValues;
+    /**
+     * The root's `shouldForceLeadingZeros`: whether a one-digit month, day or
+     * hour renders zero-padded.
+     * @default true
+     */
+    shouldForceLeadingZeros?: boolean | undefined;
+    /**
+     * The root's `step`, in seconds — it drives both the finest segment's arrow
+     * increment and the mirrored input's `step` attribute.
+     * @default undefined — every segment steps by one unit and nothing constrains the grid.
+     */
+    step?: number | undefined;
     /** Value submitted by the hidden input; `null` submits an empty entry. */
     formValue: string | null;
+    /** Input type (`date`/`datetime-local`/`time`); enables native min/max validation. */
+    formType: 'date' | 'datetime-local' | 'time';
     /** 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;
-    disabled?: boolean;
-    readOnly?: boolean;
-    invalid?: boolean;
-    required?: boolean;
-    name?: string;
+    hourCycle?: HourCycle | undefined;
+    /** `min` of the mirrored input, in the same wire shape as `formValue`. */
+    formMin?: string | undefined;
+    /** `max` of the mirrored input, in the same wire shape as `formValue`. */
+    formMax?: string | undefined;
+    /** Callback to clamp Home/End values inside the field's own `min`/`max`. */
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    name?: string | undefined;
+    /** Form id for a field rendered outside its `<form>`; bound to the hidden input's `form` attribute. */
+    form?: string | undefined;
     /** Writing direction override; without it, direction is read off the DOM. */
-    dir?: Direction;
+    dir?: Direction | undefined;
     /**
      * The root's `getSegmentLabel`, which words the accessible name of one
      * segment from its type.
      * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
      */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /**
      * The root's `emptySegmentText`, the `aria-valuetext` an untyped segment
      * announces instead of a number it does not have.
      * @default 'Empty'
      */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
+    /**
+     * The root's `getSegmentPlaceholder`, which words the letters a segment
+     * shows before it has been typed.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
     inputEl: import("vue").Ref<HTMLInputElement | null, HTMLInputElement | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "values-change": (values: Partial<Record<SegmentType, number | null>>) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onValues-change"?: ((values: Partial<Record<SegmentType, number | null>>) => any) | undefined;
+    "onValues-change"?: (values: Partial<Record<SegmentType, number | null>>) => any;
 }>, {
-    disabled: boolean;
-    required: boolean;
-    name: string;
-    invalid: boolean;
-    dir: Direction;
-    readOnly: boolean;
-    locale: string;
-    hourCycle: HourCycle;
-    getSegmentLabel: (type: SegmentType) => string;
-    emptySegmentText: string;
+    disabled: boolean | undefined;
+    name: string | undefined;
+    readOnly: boolean | undefined;
+    required: boolean | undefined;
+    invalid: boolean | undefined;
+    shouldForceLeadingZeros: boolean | undefined;
+    emptySegmentText: string | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/utils/SegmentedField.vue.d.ts

@@ -1,13 +1,7 @@
-import { type Granularity, type HourCycle, type SegmentType, type SegmentValues } from './dateSegments.js';
+import { type Granularity, type HourCycle, type SegmentPlaceholderResolver, type SegmentType, type SegmentValues } from './date-segments.js';
 import { type Direction } from './direction.js';
 type __VLS_Props = {
-    /**
-     * @internal The field rendering this, so each segment can name its own part
-     * — `skdx-date-field__segment` / `skdx-time-field__segment`. Shared code
-     * cannot hard-code one family, and a segment with no class is a segment the
-     * skin cannot reach: mirrors React's `segmentedField.tsx`, which takes the
-     * same prop for the same reason.
-     */
+    /** @internal Field family name used for segment part classes. */
     family: 'date-field' | 'time-field';
     /** `'date'` renders year/month/day ahead of the time segments. */
     kind: 'date' | 'time';
@@ -15,48 +9,73 @@ type __VLS_Props = {
     granularity: Granularity;
     /** Current per-segment values. */
     values: SegmentValues;
+    /**
+     * The root's `shouldForceLeadingZeros`: whether a one-digit month, day or
+     * hour renders zero-padded.
+     * @default true
+     */
+    shouldForceLeadingZeros?: boolean | undefined;
+    /**
+     * The root's `step`, in seconds — it drives both the finest segment's arrow
+     * increment and the mirrored input's `step` attribute.
+     * @default undefined — every segment steps by one unit and nothing constrains the grid.
+     */
+    step?: number | undefined;
     /** Value submitted by the hidden input; `null` submits an empty entry. */
     formValue: string | null;
+    /** Input type (`date`/`datetime-local`/`time`); enables native min/max validation. */
+    formType: 'date' | 'datetime-local' | 'time';
     /** 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;
-    disabled?: boolean;
-    readOnly?: boolean;
-    invalid?: boolean;
-    required?: boolean;
-    name?: string;
+    hourCycle?: HourCycle | undefined;
+    /** `min` of the mirrored input, in the same wire shape as `formValue`. */
+    formMin?: string | undefined;
+    /** `max` of the mirrored input, in the same wire shape as `formValue`. */
+    formMax?: string | undefined;
+    /** Callback to clamp Home/End values inside the field's own `min`/`max`. */
+    clampEdgeValues?: ((values: SegmentValues) => SegmentValues) | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    name?: string | undefined;
+    /** Form id for a field rendered outside its `<form>`; bound to the hidden input's `form` attribute. */
+    form?: string | undefined;
     /** Writing direction override; without it, direction is read off the DOM. */
-    dir?: Direction;
+    dir?: Direction | undefined;
     /**
      * The root's `getSegmentLabel`, which words the accessible name of one
      * segment from its type.
      * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
      */
-    getSegmentLabel?: (type: SegmentType) => string;
+    getSegmentLabel?: ((type: SegmentType) => string) | undefined;
     /**
      * The root's `emptySegmentText`, the `aria-valuetext` an untyped segment
      * announces instead of a number it does not have.
      * @default 'Empty'
      */
-    emptySegmentText?: string;
+    emptySegmentText?: string | undefined;
+    /**
+     * The root's `getSegmentPlaceholder`, which words the letters a segment
+     * shows before it has been typed.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {
     inputEl: import("vue").Ref<HTMLInputElement | null, HTMLInputElement | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "values-change": (values: Partial<Record<SegmentType, number | null>>) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onValues-change"?: ((values: Partial<Record<SegmentType, number | null>>) => any) | undefined;
+    "onValues-change"?: (values: Partial<Record<SegmentType, number | null>>) => any;
 }>, {
-    disabled: boolean;
-    required: boolean;
-    name: string;
-    invalid: boolean;
-    dir: Direction;
-    readOnly: boolean;
-    locale: string;
-    hourCycle: HourCycle;
-    getSegmentLabel: (type: SegmentType) => string;
-    emptySegmentText: string;
+    disabled: boolean | undefined;
+    name: string | undefined;
+    readOnly: boolean | undefined;
+    required: boolean | undefined;
+    invalid: boolean | undefined;
+    shouldForceLeadingZeros: boolean | undefined;
+    emptySegmentText: string | undefined;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/utils/SegmentedField.vue_vue_type_script_setup_true_lang.cjs

@@ -1 +1 @@
-const E=require("./direction.cjs"),u=require("./dateSegments.cjs");let t=require("vue");var S=["aria-disabled","aria-invalid","data-disabled","data-readonly","data-invalid","dir"],w=["tabindex","aria-label","aria-valuenow","aria-valuemin","aria-valuemax","aria-valuetext","aria-disabled","aria-readonly","aria-required","data-segment","data-placeholder","onKeydown"],q=["name","^value","required","disabled"],D=(0,t.defineComponent)({__name:"SegmentedField",props:{family:{},kind:{},granularity:{},values:{},formValue:{},locale:{default:void 0},hourCycle:{default:void 0},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},invalid:{type:Boolean,default:!1},required:{type:Boolean,default:!1},name:{default:void 0},dir:{default:void 0},getSegmentLabel:{type:Function,default:void 0},emptySegmentText:{default:u.EMPTY_VALUE_TEXT}},emits:["values-change"],setup(l,{expose:v,emit:k}){const i=l,b=k;function p(a){const r=a.type;return i.getSegmentLabel?i.getSegmentLabel(r):u.SEGMENT_LABELS[r]}const f=(0,t.ref)(null),s=(0,t.ref)(null);v({inputEl:s});const h=(0,t.computed)(()=>u.buildSegments({kind:i.kind,granularity:i.granularity,locale:i.locale,hourCycle:i.hourCycle,values:i.values}));let d=0;function g(){d=0}function c(a,r){if(i.readOnly)return;const e={...i.values,[a]:r};(a==="month"||a==="year")&&e.day!=null&&(e.day=Math.min(e.day,u.daysInMonth(e.year,e.month))),b("values-change",e),(0,t.nextTick)(()=>{f.value?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function x(){return f.value?Array.from(f.value.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function m(a,r){const e=x(),n=e[e.indexOf(a)+r];n&&(d=0,n.focus())}function B(a,r){const e=r.type,n=a.currentTarget,y=E.directionalKey(a.key,n,i.dir);if(y==="ArrowLeft"||y==="ArrowRight"){a.preventDefault(),m(n,y==="ArrowRight"?1:-1);return}if(!i.readOnly){if(a.key==="ArrowUp"||a.key==="ArrowDown"){a.preventDefault(),d=0,c(e,u.stepSegment(r,a.key==="ArrowUp"?1:-1));return}if(a.key==="Home"||a.key==="End"){a.preventDefault(),d=0,c(e,a.key==="Home"?r.min:r.max);return}if(a.key==="Backspace"||a.key==="Delete"){a.preventDefault(),d=0,c(e,null);return}if(e==="dayPeriod"){const o=a.key.toLowerCase();(o==="a"||o==="p")&&(a.preventDefault(),c(e,o==="a"?0:1));return}if(/^\d$/.test(a.key)){a.preventDefault();const o=u.typeDigit(r,d,Number(a.key));d=o.buffer,c(e,o.value),o.advance&&m(n,1)}}}return(a,r)=>((0,t.openBlock)(),(0,t.createElementBlock)("div",{ref_key:"rootRef",ref:f,role:"group","data-skdx-field-control":"","aria-disabled":l.disabled?!0:void 0,"aria-invalid":l.invalid?!0:void 0,"data-disabled":l.disabled?"":void 0,"data-readonly":l.readOnly?"":void 0,"data-invalid":l.invalid?"":void 0,dir:l.dir},[((0,t.openBlock)(!0),(0,t.createElementBlock)(t.Fragment,null,(0,t.renderList)(h.value,(e,n)=>((0,t.openBlock)(),(0,t.createElementBlock)(t.Fragment,{key:e.isEditable?e.type:`literal-${n}`},[e.isEditable?((0,t.openBlock)(),(0,t.createElementBlock)("span",{key:0,class:(0,t.normalizeClass)(`skdx-${l.family}__segment`),"data-part":"segment",role:"spinbutton",tabindex:l.disabled?-1:0,"aria-label":p(e),"aria-valuenow":e.value??e.min,"aria-valuemin":e.min,"aria-valuemax":e.max,"aria-valuetext":e.isPlaceholder?l.emptySegmentText:e.text,"aria-disabled":l.disabled?!0:void 0,"aria-readonly":l.readOnly?!0:void 0,"aria-required":l.required?!0:void 0,"data-segment":e.type,"data-placeholder":e.isPlaceholder?"":void 0,onKeydown:y=>B(y,e),onFocus:g},(0,t.toDisplayString)(e.text),43,w)):((0,t.openBlock)(),(0,t.createElementBlock)("span",{key:1,class:(0,t.normalizeClass)(`skdx-${l.family}__segment`),"data-part":"segment","aria-hidden":"true","data-segment":"literal"},(0,t.toDisplayString)(e.text),3))],64))),128)),l.name?((0,t.openBlock)(),(0,t.createElementBlock)("input",{key:0,ref_key:"inputEl",ref:s,"aria-hidden":"true",tabindex:"-1",name:l.name,"^value":l.formValue??"",required:l.required,disabled:l.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,q)):(0,t.createCommentVNode)("",!0)],8,S))}});exports.default=D;
+const q=require("./direction.cjs"),d=require("./date-segments.cjs");let t=require("vue");var D=["aria-disabled","aria-invalid","data-disabled","data-readonly","data-invalid","dir"],F=["tabindex","aria-label","aria-valuenow","aria-valuemin","aria-valuemax","aria-valuetext","aria-disabled","aria-readonly","aria-required","data-segment","data-placeholder","onKeydown"],L=["type","min","max","step","name","form","^value","required","disabled"],A=(0,t.defineComponent)({__name:"SegmentedField",props:{family:{},kind:{},granularity:{},values:{},shouldForceLeadingZeros:{type:Boolean,default:!0},step:{},formValue:{},formType:{},locale:{},hourCycle:{},formMin:{},formMax:{},clampEdgeValues:{},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},invalid:{type:Boolean,default:!1},required:{type:Boolean,default:!1},name:{default:void 0},form:{},dir:{},getSegmentLabel:{},emptySegmentText:{default:d.EMPTY_VALUE_TEXT},getSegmentPlaceholder:{}},emits:["values-change"],setup(l,{expose:m,emit:g}){const n=l,k=g;function v(e){const r=e.type;return n.getSegmentLabel?n.getSegmentLabel(r):d.SEGMENT_LABELS[r]}const y=(0,t.ref)(null),f=(0,t.ref)(null);m({inputEl:f});const b=(0,t.computed)(()=>d.buildSegments({kind:n.kind,granularity:n.granularity,locale:n.locale,hourCycle:n.hourCycle,values:n.values,getSegmentPlaceholder:n.getSegmentPlaceholder,shouldForceLeadingZeros:n.shouldForceLeadingZeros}));let o=0;function h(){o=0}function u(e,r,a=!1){if(n.disabled||n.readOnly)return;let i={...n.values,[e]:r};(e==="month"||e==="year")&&i.day!=null&&(i.day=Math.min(i.day,d.daysInMonth(i.year,i.month))),a&&n.clampEdgeValues&&(i=n.clampEdgeValues(i)),k("values-change",i),(0,t.nextTick)(()=>{y.value?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function p(){return y.value?Array.from(y.value.querySelectorAll('[role="spinbutton"][data-segment]')):[]}function s(e,r){const a=p(),i=a[a.indexOf(e)+r];i&&(o=0,i.focus())}function x(e,r,a){e.preventDefault(),o=0,u(a,d.stepSegment(r,e.key==="ArrowUp"?1:-1,d.segmentStepFor(a,n.granularity,n.step)))}function E(e,r,a){e.preventDefault(),o=0,u(a,e.key==="Home"?r.min:r.max,!0)}function S(e,r){const a=d.dayPeriodFromKey(e.key,n.locale);a!==null&&(e.preventDefault(),u(r,a))}function B(e,r,a){e.preventDefault();const i=d.typeDigit(r,o,Number(e.key));o=i.buffer,u(r.type,i.value),i.advance&&s(a,1)}function w(e,r){const a=r.type,i=e.currentTarget,c=q.directionalKey(e.key,i,n.dir);if(c==="ArrowLeft"||c==="ArrowRight"){e.preventDefault(),s(i,c==="ArrowRight"?1:-1);return}if(!(n.disabled||n.readOnly)){if(e.key==="ArrowUp"||e.key==="ArrowDown"){x(e,r,a);return}if(e.key==="Home"||e.key==="End"){E(e,r,a);return}if(e.key==="Backspace"||e.key==="Delete"){e.preventDefault(),o=0,u(a,null);return}if(a==="dayPeriod"){S(e,a);return}/^\d$/.test(e.key)&&B(e,r,i)}}return(e,r)=>((0,t.openBlock)(),(0,t.createElementBlock)("div",{ref_key:"rootRef",ref:y,role:"group","data-skdx-field-control":"","aria-disabled":l.disabled?!0:void 0,"aria-invalid":l.invalid?!0:void 0,"data-disabled":l.disabled?"":void 0,"data-readonly":l.readOnly?"":void 0,"data-invalid":l.invalid?"":void 0,dir:l.dir},[((0,t.openBlock)(!0),(0,t.createElementBlock)(t.Fragment,null,(0,t.renderList)(b.value,(a,i)=>((0,t.openBlock)(),(0,t.createElementBlock)(t.Fragment,{key:a.isEditable?a.type:`literal-${i}`},[a.isEditable?((0,t.openBlock)(),(0,t.createElementBlock)("span",{key:0,class:(0,t.normalizeClass)(`skdx-${l.family}__segment`),"data-part":"segment",role:"spinbutton",tabindex:l.disabled?-1:0,"aria-label":v(a),"aria-valuenow":(0,t.unref)(d.segmentValueNow)(a),"aria-valuemin":a.min,"aria-valuemax":a.max,"aria-valuetext":a.isPlaceholder?l.emptySegmentText:a.text,"aria-disabled":l.disabled?!0:void 0,"aria-readonly":l.readOnly?!0:void 0,"aria-required":l.required?!0:void 0,"data-segment":a.type,"data-placeholder":a.isPlaceholder?"":void 0,onKeydown:c=>w(c,a),onFocus:h},(0,t.toDisplayString)(a.text),43,F)):((0,t.openBlock)(),(0,t.createElementBlock)("span",{key:1,class:(0,t.normalizeClass)(`skdx-${l.family}__segment`),"data-part":"literal","aria-hidden":"true","data-segment":"literal"},(0,t.toDisplayString)(a.text),3))],64))),128)),l.name||l.required?((0,t.openBlock)(),(0,t.createElementBlock)("input",{key:0,ref_key:"inputEl",ref:f,"aria-hidden":"true",tabindex:"-1",type:l.formType,min:l.formMin,max:l.formMax,step:l.step,name:l.name,form:l.form,"^value":l.formValue??"",required:l.required,disabled:l.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,L)):(0,t.createCommentVNode)("",!0)],8,D))}});exports.default=A;

package/dist/utils/SegmentedField.vue_vue_type_script_setup_true_lang.js

@@ -1 +1 @@
-import{directionalKey as e}from"./direction.js";import{EMPTY_VALUE_TEXT as a,SEGMENT_LABELS as t,buildSegments as i,daysInMonth as n,stepSegment as r,typeDigit as l}from"./dateSegments.js";import{Fragment as d,computed as o,createCommentVNode as s,createElementBlock as u,defineComponent as m,nextTick as y,normalizeClass as v,openBlock as p,ref as f,renderList as c,toDisplayString as g}from"vue";var b=["aria-disabled","aria-invalid","data-disabled","data-readonly","data-invalid","dir"],k=["tabindex","aria-label","aria-valuenow","aria-valuemin","aria-valuemax","aria-valuetext","aria-disabled","aria-readonly","aria-required","data-segment","data-placeholder","onKeydown"],x=["name","^value","required","disabled"],h=/* @__PURE__ */m({__name:"SegmentedField",props:{family:{},kind:{},granularity:{},values:{},formValue:{},locale:{default:void 0},hourCycle:{default:void 0},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},invalid:{type:Boolean,default:!1},required:{type:Boolean,default:!1},name:{default:void 0},dir:{default:void 0},getSegmentLabel:{type:Function,default:void 0},emptySegmentText:{default:a}},emits:["values-change"],setup(a,{expose:m,emit:h}){const w=a,E=h;function S(e){const a=e.type;return w.getSegmentLabel?w.getSegmentLabel(a):t[a]}const _=f(null),A=f(null);m({inputEl:A});const D=o(()=>i({kind:w.kind,granularity:w.granularity,locale:w.locale,hourCycle:w.hourCycle,values:w.values}));let L=0;function q(){L=0}function B(e,a){if(w.readOnly)return;const t={...w.values,[e]:a};("month"===e||"year"===e)&&null!=t.day&&(t.day=Math.min(t.day,n(t.year,t.month))),E("values-change",t),y(()=>{_.value?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function T(e,a){const t=_.value?Array.from(_.value.querySelectorAll('[role="spinbutton"][data-segment]')):[],i=t[t.indexOf(e)+a];i&&(L=0,i.focus())}return(t,i)=>(p(),u("div",{ref_key:"rootRef",ref:_,role:"group","data-skdx-field-control":"","aria-disabled":!!a.disabled||void 0,"aria-invalid":!!a.invalid||void 0,"data-disabled":a.disabled?"":void 0,"data-readonly":a.readOnly?"":void 0,"data-invalid":a.invalid?"":void 0,dir:a.dir},[(p(!0),u(d,null,c(D.value,(t,i)=>(p(),u(d,{key:t.isEditable?t.type:`literal-${i}`},[t.isEditable?(p(),u("span",{key:0,class:v(`skdx-${a.family}__segment`),"data-part":"segment",role:"spinbutton",tabindex:a.disabled?-1:0,"aria-label":S(t),"aria-valuenow":t.value??t.min,"aria-valuemin":t.min,"aria-valuemax":t.max,"aria-valuetext":t.isPlaceholder?a.emptySegmentText:t.text,"aria-disabled":!!a.disabled||void 0,"aria-readonly":!!a.readOnly||void 0,"aria-required":!!a.required||void 0,"data-segment":t.type,"data-placeholder":t.isPlaceholder?"":void 0,onKeydown:a=>function(a,t){const i=t.type,n=a.currentTarget,d=e(a.key,n,w.dir);if("ArrowLeft"===d||"ArrowRight"===d)return a.preventDefault(),void T(n,"ArrowRight"===d?1:-1);if(!w.readOnly){if("ArrowUp"===a.key||"ArrowDown"===a.key)return a.preventDefault(),L=0,void B(i,r(t,"ArrowUp"===a.key?1:-1));if("Home"===a.key||"End"===a.key)return a.preventDefault(),L=0,void B(i,"Home"===a.key?t.min:t.max);if("Backspace"===a.key||"Delete"===a.key)return a.preventDefault(),L=0,void B(i,null);if("dayPeriod"===i){const e=a.key.toLowerCase();return void(("a"===e||"p"===e)&&(a.preventDefault(),B(i,"a"===e?0:1)))}if(/^\d$/.test(a.key)){a.preventDefault();const e=l(t,L,Number(a.key));L=e.buffer,B(i,e.value),e.advance&&T(n,1)}}}(a,t),onFocus:q},g(t.text),43,k)):(p(),u("span",{key:1,class:v(`skdx-${a.family}__segment`),"data-part":"segment","aria-hidden":"true","data-segment":"literal"},g(t.text),3))],64))),128)),a.name?(p(),u("input",{key:0,ref_key:"inputEl",ref:A,"aria-hidden":"true",tabindex:"-1",name:a.name,"^value":a.formValue??"",required:a.required,disabled:a.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,x)):s("",!0)],8,b))}});export{h as default};
+import{directionalKey as e}from"./direction.js";import{EMPTY_VALUE_TEXT as a,SEGMENT_LABELS as t,buildSegments as r,dayPeriodFromKey as i,daysInMonth as l,segmentStepFor as n,segmentValueNow as d,stepSegment as o,typeDigit as s}from"./date-segments.js";import{Fragment as u,computed as m,createCommentVNode as y,createElementBlock as p,defineComponent as f,nextTick as c,normalizeClass as v,openBlock as g,ref as b,renderList as k,toDisplayString as h,unref as x}from"vue";var E=["aria-disabled","aria-invalid","data-disabled","data-readonly","data-invalid","dir"],S=["tabindex","aria-label","aria-valuenow","aria-valuemin","aria-valuemax","aria-valuetext","aria-disabled","aria-readonly","aria-required","data-segment","data-placeholder","onKeydown"],w=["type","min","max","step","name","form","^value","required","disabled"],L=/* @__PURE__ */f({__name:"SegmentedField",props:{family:{},kind:{},granularity:{},values:{},shouldForceLeadingZeros:{type:Boolean,default:!0},step:{},formValue:{},formType:{},locale:{},hourCycle:{},formMin:{},formMax:{},clampEdgeValues:{},disabled:{type:Boolean,default:!1},readOnly:{type:Boolean,default:!1},invalid:{type:Boolean,default:!1},required:{type:Boolean,default:!1},name:{default:void 0},form:{},dir:{},getSegmentLabel:{},emptySegmentText:{default:a},getSegmentPlaceholder:{}},emits:["values-change"],setup(a,{expose:f,emit:L}){const _=a,A=L;function D(e){const a=e.type;return _.getSegmentLabel?_.getSegmentLabel(a):t[a]}const T=b(null),q=b(null);f({inputEl:q});const B=m(()=>r({kind:_.kind,granularity:_.granularity,locale:_.locale,hourCycle:_.hourCycle,values:_.values,getSegmentPlaceholder:_.getSegmentPlaceholder,shouldForceLeadingZeros:_.shouldForceLeadingZeros}));let F=0;function M(){F=0}function P(e,a,t=!1){if(_.disabled||_.readOnly)return;let r={..._.values,[e]:a};("month"===e||"year"===e)&&null!=r.day&&(r.day=Math.min(r.day,l(r.year,r.month))),t&&_.clampEdgeValues&&(r=_.clampEdgeValues(r)),A("values-change",r),c(()=>{T.value?.dispatchEvent(new Event("input",{bubbles:!0,composed:!0}))})}function V(e,a){const t=T.value?Array.from(T.value.querySelectorAll('[role="spinbutton"][data-segment]')):[],r=t[t.indexOf(e)+a];r&&(F=0,r.focus())}return(t,r)=>(g(),p("div",{ref_key:"rootRef",ref:T,role:"group","data-skdx-field-control":"","aria-disabled":!!a.disabled||void 0,"aria-invalid":!!a.invalid||void 0,"data-disabled":a.disabled?"":void 0,"data-readonly":a.readOnly?"":void 0,"data-invalid":a.invalid?"":void 0,dir:a.dir},[(g(!0),p(u,null,k(B.value,(t,r)=>(g(),p(u,{key:t.isEditable?t.type:`literal-${r}`},[t.isEditable?(g(),p("span",{key:0,class:v(`skdx-${a.family}__segment`),"data-part":"segment",role:"spinbutton",tabindex:a.disabled?-1:0,"aria-label":D(t),"aria-valuenow":x(d)(t),"aria-valuemin":t.min,"aria-valuemax":t.max,"aria-valuetext":t.isPlaceholder?a.emptySegmentText:t.text,"aria-disabled":!!a.disabled||void 0,"aria-readonly":!!a.readOnly||void 0,"aria-required":!!a.required||void 0,"data-segment":t.type,"data-placeholder":t.isPlaceholder?"":void 0,onKeydown:a=>function(a,t){const r=t.type,l=a.currentTarget,d=e(a.key,l,_.dir);if("ArrowLeft"===d||"ArrowRight"===d)return a.preventDefault(),void V(l,"ArrowRight"===d?1:-1);if(!_.disabled&&!_.readOnly){if("ArrowUp"===a.key||"ArrowDown"===a.key)return void function(e,a,t){e.preventDefault(),F=0,P(t,o(a,"ArrowUp"===e.key?1:-1,n(t,_.granularity,_.step)))}(a,t,r);if("Home"===a.key||"End"===a.key)return void function(e,a,t){e.preventDefault(),F=0,P(t,"Home"===e.key?a.min:a.max,!0)}(a,t,r);if("Backspace"===a.key||"Delete"===a.key)return a.preventDefault(),F=0,void P(r,null);if("dayPeriod"===r)return void function(e,a){const t=i(e.key,_.locale);null!==t&&(e.preventDefault(),P(a,t))}(a,r);/^\d$/.test(a.key)&&function(e,a,t){e.preventDefault();const r=s(a,F,Number(e.key));F=r.buffer,P(a.type,r.value),r.advance&&V(t,1)}(a,t,l)}}(a,t),onFocus:M},h(t.text),43,S)):(g(),p("span",{key:1,class:v(`skdx-${a.family}__segment`),"data-part":"literal","aria-hidden":"true","data-segment":"literal"},h(t.text),3))],64))),128)),a.name||a.required?(g(),p("input",{key:0,ref_key:"inputEl",ref:q,"aria-hidden":"true",tabindex:"-1",type:a.formType,min:a.formMin,max:a.formMax,step:a.step,name:a.name,form:a.form,"^value":a.formValue??"",required:a.required,disabled:a.disabled,style:{position:"absolute","pointer-events":"none",opacity:"0",margin:"0",width:"1px",height:"1px"}},null,8,w)):y("",!0)],8,E))}});export{L as default};

package/dist/utils/announcer.cjs

@@ -0,0 +1 @@
+var i=150,r="position:absolute;border:0;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;word-wrap:normal;",d=class{constructor(){this.regions=new Map}announce(t,o="polite"){if(typeof document>"u")return;const e=t.trim();if(!e)return;const n=this.regionFor(o);n.pending=e,n.node.textContent="",clearTimeout(n.timer),n.timer=setTimeout(()=>{n.timer=void 0,n.node.textContent=n.pending},150)}clear(t){for(const[o,e]of this.regions)t!==void 0&&o!==t||(clearTimeout(e.timer),e.timer=void 0,e.node.textContent="")}destroy(){this.clear();for(const t of this.regions.values())t.node.remove();this.regions.clear()}regionFor(t){const o=this.regions.get(t);if(o?.node.isConnected)return o;const e=document.createElement("div");e.setAttribute("aria-live",t),e.setAttribute("aria-atomic","true"),e.setAttribute("data-skdx-live-announcer",t),e.style.cssText=r,document.body.appendChild(e);const n={node:e,pending:"",timer:void 0};return this.regions.set(t,n),n}};exports.ANNOUNCE_DEBOUNCE_MS=i;exports.Announcer=d;

package/dist/utils/announcer.d.cts

@@ -0,0 +1,17 @@
+/** Which of the two singleton live regions a message is routed to. */
+export type AnnouncePoliteness = 'polite' | 'assertive';
+/** How long successive announcements keep merging into one write before the region updates. */
+export declare const ANNOUNCE_DEBOUNCE_MS = 150;
+/** Owns the `aria-live` regions and their debounced writes; one instance per process (or per Angular injector). */
+export declare class Announcer {
+    private readonly regions;
+    /**
+     * Schedules `message` for the region; a burst inside one debounce window collapses to its last message, and a repeat of the text already shown is re-announced.
+     */
+    announce(message: string, politeness?: AnnouncePoliteness): void;
+    /** Empties the region(s) and drops anything still pending; pass a politeness to clear just one. */
+    clear(politeness?: AnnouncePoliteness): void;
+    /** Clears and removes the regions from the document. */
+    destroy(): void;
+    private regionFor;
+}

package/dist/utils/announcer.d.ts

@@ -0,0 +1,17 @@
+/** Which of the two singleton live regions a message is routed to. */
+export type AnnouncePoliteness = 'polite' | 'assertive';
+/** How long successive announcements keep merging into one write before the region updates. */
+export declare const ANNOUNCE_DEBOUNCE_MS = 150;
+/** Owns the `aria-live` regions and their debounced writes; one instance per process (or per Angular injector). */
+export declare class Announcer {
+    private readonly regions;
+    /**
+     * Schedules `message` for the region; a burst inside one debounce window collapses to its last message, and a repeat of the text already shown is re-announced.
+     */
+    announce(message: string, politeness?: AnnouncePoliteness): void;
+    /** Empties the region(s) and drops anything still pending; pass a politeness to clear just one. */
+    clear(politeness?: AnnouncePoliteness): void;
+    /** Clears and removes the regions from the document. */
+    destroy(): void;
+    private regionFor;
+}

package/dist/utils/announcer.js

@@ -0,0 +1 @@
+var e=150,t=class{constructor(){this.regions=/* @__PURE__ */new Map}announce(e,t="polite"){if(typeof document>"u")return;const o=e.trim();if(!o)return;const n=this.regionFor(t);n.pending=o,n.node.textContent="",clearTimeout(n.timer),n.timer=setTimeout(()=>{n.timer=void 0,n.node.textContent=n.pending},150)}clear(e){for(const[t,o]of this.regions)void 0!==e&&t!==e||(clearTimeout(o.timer),o.timer=void 0,o.node.textContent="")}destroy(){this.clear();for(const e of this.regions.values())e.node.remove();this.regions.clear()}regionFor(e){const t=this.regions.get(e);if(t?.node.isConnected)return t;const o=document.createElement("div");o.setAttribute("aria-live",e),o.setAttribute("aria-atomic","true"),o.setAttribute("data-skdx-live-announcer",e),o.style.cssText="position:absolute;border:0;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;word-wrap:normal;",document.body.appendChild(o);const n={node:o,pending:"",timer:void 0};return this.regions.set(e,n),n}};export{e as ANNOUNCE_DEBOUNCE_MS,t as Announcer};

package/dist/utils/appearance.cjs

@@ -0,0 +1 @@
+function c(r,o={}){const e={};for(const n of Object.keys(r)){const a=`data-${n.replace(/[A-Z]/g,s=>`-${s.toLowerCase()}`)}`,t=r[n]??o[a];t==null||t===!1?e[a]=void 0:e[a]=t===!0?"":String(t)}return e}exports.appearanceAttrs=c;

package/dist/utils/appearance.d.cts

@@ -0,0 +1,14 @@
+/** One appearance axis value as a consumer may pass it: a rung name, a presence flag, or nothing. */
+export type AppearanceValue = string | boolean | null | undefined;
+/**
+ * Resolves appearance axes to the `data-*` attributes the skin reads, so a
+ * consumer may set either the prop (`size="lg"`) or the attribute
+ * (`data-size="lg"`) and both render the same. The prop wins when both are
+ * given; `false`, `null` and `undefined` leave the attribute off; `true`
+ * writes a bare presence attribute.
+ *
+ * @param values - Axis name to prop value, e.g. `{ size, iconOnly }`; camelCase keys map to kebab-case attributes.
+ * @param attrs - The pass-through attributes the consumer supplied, read for `data-<axis>` fallbacks.
+ * @returns A `data-<axis>` record to spread after the pass-through attributes.
+ */
+export declare function appearanceAttrs(values: Record<string, AppearanceValue>, attrs?: Record<string, unknown>): Record<string, string | undefined>;

package/dist/utils/appearance.d.ts

@@ -0,0 +1,14 @@
+/** One appearance axis value as a consumer may pass it: a rung name, a presence flag, or nothing. */
+export type AppearanceValue = string | boolean | null | undefined;
+/**
+ * Resolves appearance axes to the `data-*` attributes the skin reads, so a
+ * consumer may set either the prop (`size="lg"`) or the attribute
+ * (`data-size="lg"`) and both render the same. The prop wins when both are
+ * given; `false`, `null` and `undefined` leave the attribute off; `true`
+ * writes a bare presence attribute.
+ *
+ * @param values - Axis name to prop value, e.g. `{ size, iconOnly }`; camelCase keys map to kebab-case attributes.
+ * @param attrs - The pass-through attributes the consumer supplied, read for `data-<axis>` fallbacks.
+ * @returns A `data-<axis>` record to spread after the pass-through attributes.
+ */
+export declare function appearanceAttrs(values: Record<string, AppearanceValue>, attrs?: Record<string, unknown>): Record<string, string | undefined>;

package/dist/utils/appearance.js

@@ -0,0 +1 @@
+function t(t,e={}){const o={};for(const n of Object.keys(t)){const r=`data-${n.replace(/[A-Z]/g,t=>`-${t.toLowerCase()}`)}`,a=t[n]??e[r];o[r]=null==a||!1===a?void 0:!0===a?"":String(a)}return o}export{t as appearanceAttrs};

package/dist/utils/arrow-keys.cjs

@@ -0,0 +1 @@
+var n=new Set(["textbox","searchbox","listbox","slider","spinbutton","menu","menubar","tablist","grid","treegrid","tree","combobox","radiogroup"]),o=new Set(["INPUT","SELECT","TEXTAREA","AUDIO","VIDEO"]);function s(e){if(o.has(e.tagName)||e.isContentEditable)return!0;const t=e.getAttribute("role");return t!==null&&n.has(t)}function u(e,t){if(!(e instanceof Element))return!1;let r=e;for(;r!==null&&r!==t;){if(s(r))return!0;r=r.parentElement}return!1}exports.arrowKeyBelongsToDescendant=u;

package/dist/utils/arrow-keys.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Whether the carousel root should ignore this Arrow keypress, leaving it to whatever inside the carousel owns it.
+ *
+ * @param target the event's target
+ * @param root the carousel root the handler is attached to
+ */
+export declare function arrowKeyBelongsToDescendant(target: EventTarget | null, root: Element): boolean;

package/dist/utils/arrow-keys.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether the carousel root should ignore this Arrow keypress, leaving it to whatever inside the carousel owns it.
+ *
+ * @param target the event's target
+ * @param root the carousel root the handler is attached to
+ */
+export declare function arrowKeyBelongsToDescendant(target: EventTarget | null, root: Element): boolean;

package/dist/utils/arrow-keys.js

@@ -0,0 +1 @@
+var e=/* @__PURE__ */new Set(["textbox","searchbox","listbox","slider","spinbutton","menu","menubar","tablist","grid","treegrid","tree","combobox","radiogroup"]),t=/* @__PURE__ */new Set(["INPUT","SELECT","TEXTAREA","AUDIO","VIDEO"]);function n(n){if(t.has(n.tagName)||n.isContentEditable)return!0;const r=n.getAttribute("role");return null!==r&&e.has(r)}function r(e,t){if(!(e instanceof Element))return!1;let r=e;for(;null!==r&&r!==t;){if(n(r))return!0;r=r.parentElement}return!1}export{r as arrowKeyBelongsToDescendant};

package/dist/utils/calendar-locale.cjs

@@ -0,0 +1 @@
+var l=new Date(2024,0,7),m=new Map;function s(e,t){const n=m.get(e);if(n)return n;const a=t();return m.set(e,a),a}function r(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function g(e,t="long"){const n=r(e);return s(`m|${n}|${t}`,()=>{const a=new Intl.DateTimeFormat(n,{month:t,timeZone:"UTC"});return Array.from({length:12},(c,o)=>a.format(Date.UTC(2024,o,15)))})}function D(e,t=0,n="short"){const a=r(e),c=s(`w|${a}|${n}`,()=>{const u=new Intl.DateTimeFormat(a,{weekday:n});return Array.from({length:7},(b,i)=>u.format(new Date(l.getFullYear(),l.getMonth(),l.getDate()+i)))}),o=(t%7+7)%7;return c.slice(o).concat(c.slice(0,o))}function h(e){try{const t=new Intl.Locale(r(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function L(e,t){return e.toLocaleDateString(r(t),{month:"long",year:"numeric"})}function f(e,t){return new Intl.NumberFormat(r(t),{useGrouping:!1}).format(e)}function y(e,t,n){return`${f(e,n)} – ${f(t,n)}`}function w(e,t){return e.toLocaleDateString(r(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function N(){m.clear()}exports.clearLocaleNameCache=N;exports.formatDateLabel=w;exports.formatMonthLabel=L;exports.formatYear=f;exports.formatYearRange=y;exports.getLocaleWeekStartsOn=h;exports.getMonthNames=g;exports.getWeekDayNames=D;exports.resolveLocale=r;

package/dist/utils/calendar-locale.d.cts

@@ -0,0 +1,35 @@
+/** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
+export type NameWidth = 'narrow' | 'short' | 'long';
+/** The runtime's own locale, used whenever `locale` is omitted — matches what `toLocaleDateString()` would pick. */
+export declare function resolveLocale(locale?: string): string;
+/**
+ * The twelve month names of `locale`, January first, at the requested width.
+ *
+ * @example
+ * ```ts
+ * getMonthNames('fr-FR')[0]; // 'janvier'
+ * ```
+ */
+export declare function getMonthNames(locale?: string, width?: NameWidth): string[];
+/**
+ * The seven weekday names of `locale` at the requested width, rotated so index
+ * `0` is `weekStartsOn` (`0` = Sunday … `6` = Saturday).
+ *
+ * @example
+ * ```ts
+ * getWeekDayNames('en-GB', 1, 'short'); // ['Mon', 'Tue', … 'Sun']
+ * ```
+ */
+export declare function getWeekDayNames(locale?: string, weekStartsOn?: number, width?: NameWidth): string[];
+/** The first day of the week `locale` uses (`0` = Sunday … `6` = Saturday), read from `Intl.Locale`'s week info, falling back to `0` on engines without it. */
+export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
+export declare function formatMonthLabel(month: Date, locale?: string): string;
+/** A bare year formatted for `locale` (e.g. `'2026'`, `'٢٠٢٦'` in `ar-EG`) using `Intl.NumberFormat` with grouping off, since a grouped `2,026` is not a year. */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
+/** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
+export declare function formatDateLabel(date: Date, locale?: string): string;
+/** @internal Drops every memoized name list. */
+export declare function clearLocaleNameCache(): void;

package/dist/utils/calendar-locale.d.ts

@@ -0,0 +1,35 @@
+/** How much of a name to render — the `Intl.DateTimeFormat` `month`/`weekday` widths. */
+export type NameWidth = 'narrow' | 'short' | 'long';
+/** The runtime's own locale, used whenever `locale` is omitted — matches what `toLocaleDateString()` would pick. */
+export declare function resolveLocale(locale?: string): string;
+/**
+ * The twelve month names of `locale`, January first, at the requested width.
+ *
+ * @example
+ * ```ts
+ * getMonthNames('fr-FR')[0]; // 'janvier'
+ * ```
+ */
+export declare function getMonthNames(locale?: string, width?: NameWidth): string[];
+/**
+ * The seven weekday names of `locale` at the requested width, rotated so index
+ * `0` is `weekStartsOn` (`0` = Sunday … `6` = Saturday).
+ *
+ * @example
+ * ```ts
+ * getWeekDayNames('en-GB', 1, 'short'); // ['Mon', 'Tue', … 'Sun']
+ * ```
+ */
+export declare function getWeekDayNames(locale?: string, weekStartsOn?: number, width?: NameWidth): string[];
+/** The first day of the week `locale` uses (`0` = Sunday … `6` = Saturday), read from `Intl.Locale`'s week info, falling back to `0` on engines without it. */
+export declare function getLocaleWeekStartsOn(locale?: string): 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** The month heading label for `month` (e.g. `'janvier 2026'`), formatted for `locale`. */
+export declare function formatMonthLabel(month: Date, locale?: string): string;
+/** A bare year formatted for `locale` (e.g. `'2026'`, `'٢٠٢٦'` in `ar-EG`) using `Intl.NumberFormat` with grouping off, since a grouped `2,026` is not a year. */
+export declare function formatYear(year: number, locale?: string): string;
+/** A year page label (e.g. `'2020 – 2039'`), the year view's heading and grid name. */
+export declare function formatYearRange(start: number, end: number, locale?: string): string;
+/** A full, spoken-friendly date label (e.g. `'Monday, January 5, 2026'`) for live-region announcements. */
+export declare function formatDateLabel(date: Date, locale?: string): string;
+/** @internal Drops every memoized name list. */
+export declare function clearLocaleNameCache(): void;

package/dist/utils/calendar-locale.js

@@ -0,0 +1 @@
+var e=new Date(2024,0,7),t=/* @__PURE__ */new Map;function n(e,n){const r=t.get(e);if(r)return r;const a=n();return t.set(e,a),a}function r(e){return e??(new Intl.DateTimeFormat).resolvedOptions().locale}function a(e,t="long"){const a=r(e);return n(`m|${a}|${t}`,()=>{const e=new Intl.DateTimeFormat(a,{month:t,timeZone:"UTC"});return Array.from({length:12},(t,n)=>e.format(Date.UTC(2024,n,15)))})}function o(t,a=0,o="short"){const c=r(t),u=n(`w|${c}|${o}`,()=>{const t=new Intl.DateTimeFormat(c,{weekday:o});return Array.from({length:7},(n,r)=>t.format(new Date(e.getFullYear(),e.getMonth(),e.getDate()+r)))}),l=(a%7+7)%7;return u.slice(l).concat(u.slice(0,l))}function c(e){try{const t=new Intl.Locale(r(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if("number"==typeof n)return n%7}catch{}return 0}function u(e,t){return e.toLocaleDateString(r(t),{month:"long",year:"numeric"})}function l(e,t){return new Intl.NumberFormat(r(t),{useGrouping:!1}).format(e)}function m(e,t,n){return`${l(e,n)} – ${l(t,n)}`}function s(e,t){return e.toLocaleDateString(r(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function i(){t.clear()}export{i as clearLocaleNameCache,s as formatDateLabel,u as formatMonthLabel,l as formatYear,m as formatYearRange,c as getLocaleWeekStartsOn,a as getMonthNames,o as getWeekDayNames,r as resolveLocale};

package/dist/utils/cardNesting.cjs

@@ -0,0 +1 @@
+const a=require("./dev-mode.cjs"),i=require("./tabbable.cjs");var o='input[type="checkbox"], input[type="radio"]';function c(r,n){if(!n)return;const e=Array.from(n.querySelectorAll(i.TABBABLE_SELECTOR)).filter(t=>!t.matches(o));e.length!==0&&a.isDevMode()&&console.warn(`[skdx] ${r}: found ${e.length} focusable element(s) nested inside the card — ${e.map(t=>`<${t.localName}>`).join(", ")}. The card root is a <label>, so clicking one of these also toggles the card, and a <label> may not contain interactive content. Put actions beside the card, never inside it.`)}exports.warnOnNestedInteractive=c;

package/dist/utils/cardNesting.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Warns when the card root contains a focusable descendant that isn't its Control.
+ * @param family Card family.
+ * @param root Card root element.
+ * @internal
+ */
+export declare function warnOnNestedInteractive(family: 'CheckboxCard' | 'RadioCard', root: Element | null): void;

package/dist/utils/cardNesting.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Warns when the card root contains a focusable descendant that isn't its Control.
+ * @param family Card family.
+ * @param root Card root element.
+ * @internal
+ */
+export declare function warnOnNestedInteractive(family: 'CheckboxCard' | 'RadioCard', root: Element | null): void;

package/dist/utils/cardNesting.js

@@ -0,0 +1 @@
+import{isDevMode as e}from"./dev-mode.js";import{TABBABLE_SELECTOR as t}from"./tabbable.js";function n(n,o){if(!o)return;const a=Array.from(o.querySelectorAll(t)).filter(e=>!e.matches('input[type="checkbox"], input[type="radio"]'));0!==a.length&&e()&&console.warn(`[skdx] ${n}: found ${a.length} focusable element(s) nested inside the card — ${a.map(e=>`<${e.localName}>`).join(", ")}. The card root is a <label>, so clicking one of these also toggles the card, and a <label> may not contain interactive content. Put actions beside the card, never inside it.`)}export{n as warnOnNestedInteractive};