@skdx/web-components 0.27.0 → 0.28.0

package/dist/internal/date-segments.d.ts

@@ -1,24 +1,17 @@
 /**
- * The segment engine behind `<skdx-date-field>` and `<skdx-time-field>`: turns a
- * locale plus a granularity into an ordered list of editable segments, and
- * turns keystrokes into new segment values.
- *
- * Built entirely on `Intl.DateTimeFormat.formatToParts` — segment order *and*
- * the literals between segments come from CLDR, so there is no bundled
- * separator table, no locale data and no date library.
- *
- * Every framework package carries its own copy of this module (the same way
- * each carries its own `calendar/locale` and `numberFormat`), because
- * `@skdx/shared` is a dev-only dependency — contracts and test assertions, not
- * runtime code. See `reports/design-system-competitive-audit/RFC-segmented-field.md`.
- *
- * The module is deliberately framework-free and side-effect-free apart from its
- * `Intl` memo caches.
+ * Segment engine behind `<skdx-date-field>` and `<skdx-time-field>`: turns a
+ * locale and granularity into editable segments, and keystrokes into segment
+ * values, using `Intl.DateTimeFormat.formatToParts` for locale order.
  */
 /** One editable piece of a segmented date/time value. */
 export type SegmentType = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'dayPeriod';
-/** How far down a segmented field is editable. Ordered coarse → fine. */
-export type Granularity = 'day' | 'hour' | 'minute' | 'second';
+/**
+ * How far down a segmented field is editable, coarse to fine.
+ *
+ * No `'hour'` member: {@link segmentTypesFor} always pairs hour with minute,
+ * so an hour-only granularity would render identically to `'minute'`.
+ */
+export type Granularity = 'day' | 'minute' | 'second';
 /** Whether hours read `1`–`12` (with an AM/PM segment) or `0`–`23`. */
 export type HourCycle = 12 | 24;
 /** Current numeric value of each editable segment; `null` means "not typed yet". */
@@ -40,9 +33,16 @@ export interface Segment {
     /** `false` only for literals. */
     isEditable: boolean;
 }
-/** Placeholder text shown before a segment has been typed. */
+/**
+ * Placeholder text shown before a segment has been typed, and the default
+ * {@link SegmentPlaceholderResolver}.
+ *
+ * Always English: CLDR has no notion of a placeholder, only of a value's own
+ * rendering, so a German field shows `dd.mm.yyyy` unless a consumer passes
+ * `getSegmentPlaceholder`.
+ */
 export declare const SEGMENT_PLACEHOLDERS: Record<SegmentType, string>;
-/** The runtime's own locale, used whenever `locale` is omitted — matches `calendar/locale`'s `resolveLocale`. */
+/** Use the runtime's locale when none is given. */
 export declare function resolveLocale(locale?: string): string;
 /**
  * The hour cycle to render with: the explicit `hourCycle` when given, otherwise
@@ -76,8 +76,22 @@ export declare function segmentRange(type: SegmentType, values: SegmentValues, h
 };
 /** The locale's AM and PM names, e.g. `['AM', 'PM']` or `['vorm.', 'nachm.']`. */
 export declare function getDayPeriodNames(locale?: string): [string, string];
-/** How a segment renders: zero-padded digits, the locale's AM/PM name, or the placeholder. */
-export declare function formatSegmentText(type: SegmentType, value: number | null, locale?: string): string;
+/**
+ * Day period a keystroke selects: `0` for AM, `1` for PM, `null` if neither.
+ *
+ * `a`/`p` match first, keeping the en-US shortcut working under any locale.
+ * Otherwise matches the locale's own AM/PM name by first character
+ * (case/accent-insensitive via `localeCompare`); an ambiguous match — both
+ * names sharing a first character — is refused rather than guessed.
+ */
+export declare function dayPeriodFromKey(key: string, locale?: string): number | null;
+/** Text to show for a placeholder segment. Return {@link SEGMENT_PLACEHOLDERS} entries by default. */
+export type SegmentPlaceholderResolver = (type: SegmentType) => string;
+/**
+ * @param shouldForceLeadingZeros `false` renders month/day/hour unpadded —
+ * see {@link SEGMENT_PAD_UNFORCED}.
+ */
+export declare function formatSegmentText(type: SegmentType, value: number | null, locale?: string, getSegmentPlaceholder?: SegmentPlaceholderResolver, shouldForceLeadingZeros?: boolean): string;
 /** Options for {@link buildSegments}. */
 export interface BuildSegmentsOptions {
     /** `'date'` adds year/month/day ahead of the time segments. */
@@ -90,6 +104,14 @@ export interface BuildSegmentsOptions {
     hourCycle?: HourCycle;
     /** Current per-segment values. */
     values: SegmentValues;
+    /** Words each segment's placeholder; omitted keeps the built-in English letters. */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    /**
+     * Whether a one-digit month, day or hour renders zero-padded (`05`) or bare
+     * (`5`). Never touches `year`, `minute` or `second`.
+     * @default true
+     */
+    shouldForceLeadingZeros?: boolean;
 }
 /**
  * The full ordered render list for a segmented field — editable segments
@@ -104,11 +126,37 @@ export interface BuildSegmentsOptions {
  */
 export declare function buildSegments(options: BuildSegmentsOptions): Segment[];
 /**
- * Steps one segment by `delta`, wrapping around its range (Arrow Up on `12:59`
- * minutes gives `12:00`, not `12:59`). An untyped segment starts at `min`,
- * except `year`, which starts at the current year rather than year 1.
+ * Arrow step in units per segment, mirroring `<input type="time" step>` —
+ * only the finest rendered segment steps by more than 1.
+ *
+ * @example
+ * ```ts
+ * segmentStepFor('minute', 'minute', 900); // 15
+ * segmentStepFor('hour', 'minute', 900); // 1 — only the finest segment steps
+ * ```
+ */
+export declare function segmentStepFor(type: SegmentType, granularity: Granularity, step?: number): number;
+/**
+ * Steps a segment by `delta`, wrapping at its range bounds. An untyped
+ * segment starts from {@link untypedSegmentStart} rather than `delta`
+ * applied to nothing.
+ *
+ * With `step` past 1 the segment only lands on the grid `min`, `min + step`,
+ * … up to `max`; a value already off that grid snaps onto it in the
+ * direction pressed, like a native stepper.
+ *
+ * @param step the segment's own step, from {@link segmentStepFor}
+ */
+export declare function stepSegment(segment: Segment, delta: number, step?: number): number;
+/**
+ * The `aria-valuenow` a segment publishes: its value clamped inside its own
+ * `aria-valuemin`/`aria-valuemax`.
+ *
+ * Mid-entry a value can legitimately sit below `min` (typing `0` into month);
+ * publishing that raw would contradict `aria-valuemin`. The raw digits still
+ * reach the user via `aria-valuetext`.
  */
-export declare function stepSegment(segment: Segment, delta: number): number;
+export declare function segmentValueNow(segment: Segment): number;
 /** The result of typing one digit into a segment. */
 export interface DigitEntry {
     /** The segment's new value. May be below `min` mid-entry (typing `0` then `5` into a month). */
@@ -119,10 +167,9 @@ export interface DigitEntry {
     advance: boolean;
 }
 /**
- * Types one digit into a segment, with React Aria's roll-over behaviour: a
- * keystroke that would overflow the segment restarts entry at that digit
- * instead of being rejected, and focus advances as soon as no further digit
- * could fit.
+ * Types one digit into a segment: a keystroke that would overflow the
+ * segment restarts entry at that digit instead of being rejected, and focus
+ * advances once no further digit could fit.
  *
  * @param segment the segment being typed into
  * @param buffer what has been typed into it so far (`0` when entry just started)
@@ -159,5 +206,62 @@ export declare function valuesToTimeString(values: SegmentValues, granularity: G
 export declare function timeStringToValues(time: string, hourCycle: HourCycle): SegmentValues;
 /** The `YYYY-MM-DD` / `YYYY-MM-DDTHH:mm[:ss]` string a segmented date field submits. */
 export declare function dateToFormValue(date: Date, granularity: Granularity): string;
+/**
+ * Inverse of {@link dateToFormValue}: reads `YYYY-MM-DD[THH:mm[:ss]]` back
+ * into a **local** `Date`.
+ *
+ * Built field by field rather than via `new Date(string)`, which reads a bare
+ * `YYYY-MM-DD` as UTC midnight — the previous day west of Greenwich.
+ *
+ * @param value a string in the shape {@link dateToFormValue} produces
+ * @returns the local date, or `null` when the string is not one of those shapes
+ */
+export declare function parseDateFormValue(value: string): Date | null;
+/** Which side of a `min`/`max` bound a value falls outside, or `null` when it is in range. */
+export type RangeViolation = 'underflow' | 'overflow';
+/**
+ * Whether an `HH:mm[:ss]` time falls below `min` or above `max` — the same
+ * comparison `<input type="time" min max>` makes, done as a string compare
+ * since zero-padded 24-hour times sort chronologically.
+ *
+ * @param value the field's current wire value, or `null` while incomplete
+ * @param min the earliest accepted time, `HH:mm[:ss]`
+ * @param max the latest accepted time, `HH:mm[:ss]`
+ * @returns which bound was crossed, or `null` when the value is in range (an
+ * incomplete field is never out of range — it has no time yet)
+ */
+export declare function timeRangeViolation(value: string | null | undefined, min?: string, max?: string): RangeViolation | null;
+/**
+ * Whether an `HH:mm[:ss]` time misses the `step` grid — the `stepMismatch`
+ * `<input type="time" step>` raises, computed the same way: `step` counts
+ * seconds, anchored on `min` when given, else midnight.
+ *
+ * Form-associated custom elements have no native control to raise this flag,
+ * so it must be computed here; the other frameworks use a hidden native input.
+ *
+ * @param value the field's current wire value, or `null` while incomplete
+ * @param step the step in seconds; non-positive or non-finite is no
+ * constraint, like a missing `step` attribute
+ * @param min the step base — same `min` the range check uses
+ */
+export declare function timeStepMismatch(value: string | null | undefined, step?: number, min?: string): boolean;
+/**
+ * Pulls time segment values back inside `min`/`max`, replacing every time
+ * segment with the crossed bound's own.
+ *
+ * Only `Home`/`End` clamp this way — typing and arrow-stepping leave an
+ * out-of-range value reachable so the field can still report
+ * `rangeUnderflow`/`rangeOverflow`.
+ */
+export declare function clampValuesToTimeRange(values: SegmentValues, granularity: Granularity, hourCycle: HourCycle, min?: string, max?: string): SegmentValues;
+/**
+ * Whether a `Date` falls below `minDate` or above `maxDate`, compared at the
+ * field's own `granularity` — a `day` field ignores time of day, like
+ * `<input type="date" min max>`.
+ *
+ * Compared through {@link dateToFormValue} so the comparison matches what
+ * the mirrored native input makes against the same two strings.
+ */
+export declare function dateRangeViolation(value: Date | null | undefined, granularity: Granularity, minDate?: Date, maxDate?: Date): RangeViolation | null;
 /** @internal Drops every memoized `Intl` result. Only needed by tests that switch locales in one process. */
 export declare function clearDateSegmentCache(): void;

package/dist/internal/date-segments.js

@@ -1 +1 @@
-var g={year:"yyyy",month:"mm",day:"dd",hour:"hh",minute:"mm",second:"ss",dayPeriod:"--"},f={year:4,month:2,day:2,hour:2,minute:2,second:2,dayPeriod:0},p=Date.UTC(2024,0,15,13,45,56),l=new Map,m=new Map;function c(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function h(e,t){if(t===12||t===24)return t;let n=new Intl.DateTimeFormat(c(e),{hour:"numeric"}).resolvedOptions(),r=n.hourCycle??(n.hour12?"h12":"h23");return r==="h11"||r==="h12"?12:24}function x(e,t){let n=e==="date"?["year","month","day"]:[];return(e==="time"||t!=="day")&&(n.push("hour","minute"),t==="second"&&n.push("second")),n}function S(e,t){return!e||!t?31:new Date(e,t,0).getDate()}function b(e,t,n){switch(e){case"year":return{min:1,max:9999};case"month":return{min:1,max:12};case"day":return{min:1,max:S(t.year,t.month)};case"hour":return n===12?{min:1,max:12}:{min:0,max:23};case"minute":case"second":return{min:0,max:59};case"dayPeriod":return{min:0,max:1}}}function T(e){let t=c(e),n=m.get(t);if(n)return n;let r=new Intl.DateTimeFormat(t,{hour:"numeric",hourCycle:"h12",timeZone:"UTC"}),o=u=>r.formatToParts(Date.UTC(2024,0,15,u)).find(a=>a.type==="dayPeriod")?.value??(u<12?"AM":"PM"),i=[o(1),o(13)];return m.set(t,i),i}function C(e,t){let n={timeZone:"UTC"};return e.includes("year")&&(n.year="numeric"),e.includes("month")&&(n.month="2-digit"),e.includes("day")&&(n.day="2-digit"),e.includes("hour")&&(n.hour="2-digit",n.hourCycle=t===12?"h12":"h23"),e.includes("minute")&&(n.minute="2-digit"),e.includes("second")&&(n.second="2-digit"),n}function D(e,t,n){let r=`${e}|${t.join(",")}|${n}`,o=l.get(r);if(o)return o;let i=new Intl.DateTimeFormat(e,C(t,n)).formatToParts(p),u=[];for(let a of i)a.type==="literal"?u.push({type:"literal",text:a.value.replace(/[\u202F\u2009\u00A0]/g," "),value:null,min:0,max:0,isPlaceholder:!1,isEditable:!1}):(a.type==="dayPeriod"||t.includes(a.type))&&u.push({type:a.type,text:"",value:null,min:0,max:0,isPlaceholder:!0,isEditable:!0});return l.set(r,u),u}function P(e,t,n){return t===null?g[e]:e==="dayPeriod"?T(n)[t===0?0:1]:String(t).padStart(f[e],"0")}function E(e){let t=c(e.locale),n=h(t,e.hourCycle),r=x(e.kind,e.granularity);return D(t,r,n).map(o=>{if(!o.isEditable)return o;let i=o.type,u=e.values[i]??null,{min:a,max:y}=b(i,e.values,n);return{type:i,text:P(i,u,t),value:u,min:a,max:y,isPlaceholder:u===null,isEditable:!0}})}function H(e,t){let{min:n,max:r}=e;if(e.value===null)return e.type==="year"?new Date().getFullYear():n;let o=r-n+1;return n+((e.value-n+t)%o+o)%o}function $(e,t,n){let r=t*10+n;r>e.max&&(r=n);let o=r*10>e.max;return{value:r,buffer:o?0:r,advance:o}}function F(e){return e.every(t=>!t.isEditable||t.value!==null&&t.value>=t.min&&t.value<=t.max)}function s(e,t,n){return n===24?e:e%12+(t===1?12:0)}function d(e,t){return t===24?[e,null]:[e%12===0?12:e%12,e<12?0:1]}function v(e,t){let{year:n,month:r,day:o}=e;if(!n||!r||!o)return null;let i=e.hour==null?0:s(e.hour,e.dayPeriod,t),u=new Date(n,r-1,o,i,e.minute??0,e.second??0,0);return n<100&&u.setFullYear(n),u}function M(e,t){let[n,r]=d(e.getHours(),t);return{year:e.getFullYear(),month:e.getMonth()+1,day:e.getDate(),hour:n,minute:e.getMinutes(),second:e.getSeconds(),dayPeriod:r}}function w(e,t,n){if(e.hour==null||e.minute==null||n===12&&e.dayPeriod==null)return null;let r=u=>String(u).padStart(2,"0"),o=s(e.hour,e.dayPeriod,n),i=`${r(o)}:${r(e.minute)}`;return t!=="second"?i:e.second==null?null:`${i}:${r(e.second)}`}function O(e,t){let n=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!n)return{};let r=Number(n[1]),o=Number(n[2]),i=n[3]===void 0?0:Number(n[3]);if(r>23||o>59||i>59)return{};let[u,a]=d(r,t);return{hour:u,minute:o,second:i,dayPeriod:a}}function V(e,t){let n=(i,u=2)=>String(i).padStart(u,"0"),r=`${n(e.getFullYear(),4)}-${n(e.getMonth()+1)}-${n(e.getDate())}`;if(t==="day")return r;let o=`${n(e.getHours())}:${n(e.getMinutes())}`;return t==="second"?`${r}T${o}:${n(e.getSeconds())}`:`${r}T${o}`}function R(){l.clear(),m.clear()}export{g as SEGMENT_PLACEHOLDERS,E as buildSegments,R as clearDateSegmentCache,V as dateToFormValue,M as dateToValues,S as daysInMonth,P as formatSegmentText,d as from24Hour,T as getDayPeriodNames,F as isComplete,h as resolveHourCycle,c as resolveLocale,b as segmentRange,x as segmentTypesFor,H as stepSegment,O as timeStringToValues,s as to24Hour,$ as typeDigit,v as valuesToDate,w as valuesToTimeString};
+var S={year:"yyyy",month:"mm",day:"dd",hour:"hh",minute:"mm",second:"ss",dayPeriod:"--"},y={year:4,month:2,day:2,hour:2,minute:2,second:2,dayPeriod:0},x={...y,month:1,day:1,hour:1},T=Date.UTC(2024,0,15,13,45,56),m=new Map,d=new Map;function f(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function D(e,n){if(n===12||n===24)return n;let t=new Intl.DateTimeFormat(f(e),{hour:"numeric"}).resolvedOptions(),r=t.hourCycle??(t.hour12?"h12":"h23");return r==="h11"||r==="h12"?12:24}function P(e,n){let t=e==="date"?["year","month","day"]:[];return(e==="time"||n!=="day")&&(t.push("hour","minute"),n==="second"&&t.push("second")),t}function C(e,n){return!e||!n?31:new Date(e,n,0).getDate()}function F(e,n,t){switch(e){case"year":return{min:1,max:9999};case"month":return{min:1,max:12};case"day":return{min:1,max:C(n.year,n.month)};case"hour":return t===12?{min:1,max:12}:{min:0,max:23};case"minute":case"second":return{min:0,max:59};case"dayPeriod":return{min:0,max:1}}}function p(e){let n=f(e),t=d.get(n);if(t)return t;let r=new Intl.DateTimeFormat(n,{hour:"numeric",hourCycle:"h12",timeZone:"UTC"}),u=i=>r.formatToParts(Date.UTC(2024,0,15,i)).find(l=>l.type==="dayPeriod")?.value??(i<12?"AM":"PM"),o=[u(1),u(13)];return d.set(n,o),o}function V(e,n){if([...e].length!==1)return null;let t=e.toLowerCase();if(t==="a")return 0;if(t==="p")return 1;let r=p(n),u=l=>{let a=[...l][0];return a!==void 0&&a.localeCompare(e,n,{sensitivity:"base"})===0},o=u(r[0]),i=u(r[1]);return o&&i?null:o?0:i?1:null}function w(e,n){let t={timeZone:"UTC"};return e.includes("year")&&(t.year="numeric"),e.includes("month")&&(t.month="2-digit"),e.includes("day")&&(t.day="2-digit"),e.includes("hour")&&(t.hour="2-digit",t.hourCycle=n===12?"h12":"h23"),e.includes("minute")&&(t.minute="2-digit"),e.includes("second")&&(t.second="2-digit"),t}function $(e,n,t){let r=`${e}|${n.join(",")}|${t}`,u=m.get(r);if(u)return u;let o=new Intl.DateTimeFormat(e,w(n,t)).formatToParts(T),i=[];for(let l of o)l.type==="literal"?i.push({type:"literal",text:l.value.replace(/[\u202F\u2009\u00A0]/g," "),value:null,min:0,max:0,isPlaceholder:!1,isEditable:!1}):(l.type==="dayPeriod"||n.includes(l.type))&&i.push({type:l.type,text:"",value:null,min:0,max:0,isPlaceholder:!0,isEditable:!0});return m.set(r,i),i}function E(e,n,t,r,u=!0){if(n===null)return r?.(e)??S[e];if(e==="dayPeriod")return p(t)[n===0?0:1];let o=u?y:x;return String(n).padStart(o[e],"0")}function v(e){let n=f(e.locale),t=D(n,e.hourCycle),r=P(e.kind,e.granularity);return $(n,r,t).map(u=>{if(!u.isEditable)return u;let o=u.type,i=e.values[o]??null,{min:l,max:a}=F(o,e.values,t);return{type:o,text:E(o,i,n,e.getSegmentPlaceholder,e.shouldForceLeadingZeros??!0),value:i,min:l,max:a,isPlaceholder:i===null,isEditable:!0}})}function H(e){let n=new Date;switch(e.type){case"year":return n.getFullYear();case"hour":{let t=n.getHours();return e.min===1?t%12===0?12:t%12:t}case"minute":return n.getMinutes();case"second":return n.getSeconds();case"dayPeriod":return n.getHours()<12?0:1;default:return e.min}}function G(e,n,t){let r=n==="second"?"second":"minute",u=n==="second"?1:60;if(e!==r||t===void 0||!Number.isFinite(t)||t<=0||t%u!==0)return 1;let o=t/u;return o<60?o:1}function O(e,n,t=1){let{min:r,max:u}=e;if(e.value===null)return r+Math.floor((H(e)-r)/t)*t;let o=Math.floor((u-r)/t)+1,i=e.value-r,l=(n>0?Math.floor(i/t):Math.ceil(i/t))+n;return r+(l%o+o)%o*t}function I(e){return Math.min(Math.max(e.value??e.min,e.min),e.max)}function A(e,n,t){let r=n*10+t;r>e.max&&(r=t);let u=r*10>e.max;return{value:r,buffer:u?0:r,advance:u}}function L(e){return e.every(n=>!n.isEditable||n.value!==null&&n.value>=n.min&&n.value<=n.max)}function h(e,n,t){return t===24?e:e%12+(n===1?12:0)}function b(e,n){return n===24?[e,null]:[e%12===0?12:e%12,e<12?0:1]}function U(e,n){let{year:t,month:r,day:u}=e;if(!t||!r||!u)return null;let o=e.hour==null?0:h(e.hour,e.dayPeriod,n),i=new Date(t,r-1,u,o,e.minute??0,e.second??0,0);return t<100&&i.setFullYear(t),i}function Y(e,n){let[t,r]=b(e.getHours(),n);return{year:e.getFullYear(),month:e.getMonth()+1,day:e.getDate(),hour:t,minute:e.getMinutes(),second:e.getSeconds(),dayPeriod:r}}function N(e,n,t){if(e.hour==null||e.minute==null||t===12&&e.dayPeriod==null)return null;let r=i=>String(i).padStart(2,"0"),u=h(e.hour,e.dayPeriod,t),o=`${r(u)}:${r(e.minute)}`;return n!=="second"?o:e.second==null?null:`${o}:${r(e.second)}`}function M(e,n){let t=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!t)return{};let r=Number(t[1]),u=Number(t[2]),o=t[3]===void 0?0:Number(t[3]);if(r>23||u>59||o>59)return{};let[i,l]=b(r,n);return{hour:i,minute:u,second:o,dayPeriod:l}}function c(e,n){let t=(o,i=2)=>String(o).padStart(i,"0"),r=`${t(e.getFullYear(),4)}-${t(e.getMonth()+1)}-${t(e.getDate())}`;if(n==="day")return r;let u=`${t(e.getHours())}:${t(e.getMinutes())}`;return n==="second"?`${r}T${u}:${t(e.getSeconds())}`:`${r}T${u}`}function _(e){let n=/^(\d{4,})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?)?$/.exec(e.trim());if(!n)return null;let t=Number(n[1]),r=new Date(t,Number(n[2])-1,Number(n[3]),Number(n[4]??0),Number(n[5]??0),Number(n[6]??0));return t<100&&r.setFullYear(t),Number.isNaN(r.getTime())?null:r}function s(e){let n=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!n)return null;let t=r=>r.padStart(2,"0");return`${t(n[1])}:${n[2]}:${t(n[3]??"00")}`}function R(e,n,t){if(!e)return null;let r=s(e);if(r===null)return null;let u=n?s(n):null;if(u!==null&&r<u)return"underflow";let o=t?s(t):null;return o!==null&&r>o?"overflow":null}function g(e){let n=s(e);if(n===null)return null;let[t,r,u]=n.split(":").map(Number);return t*3600+r*60+u}function Z(e,n,t){if(!e||n===void 0||!Number.isFinite(n)||n<=0)return!1;let r=g(e);if(r===null)return!1;let u=(t===void 0?0:g(t))??0;return((r-u)%n+n)%n!==0}function z(e,n,t,r,u){let o=N(e,n,t),i=R(o,r,u);return i===null?e:{...e,...M(i==="underflow"?r:u,t)}}function B(e,n,t,r){if(!e)return null;let u=c(e,n);return t&&u<c(t,n)?"underflow":r&&u>c(r,n)?"overflow":null}function j(){m.clear(),d.clear()}export{S as SEGMENT_PLACEHOLDERS,v as buildSegments,z as clampValuesToTimeRange,j as clearDateSegmentCache,B as dateRangeViolation,c as dateToFormValue,Y as dateToValues,V as dayPeriodFromKey,C as daysInMonth,E as formatSegmentText,b as from24Hour,p as getDayPeriodNames,L as isComplete,_ as parseDateFormValue,D as resolveHourCycle,f as resolveLocale,F as segmentRange,G as segmentStepFor,P as segmentTypesFor,I as segmentValueNow,O as stepSegment,R as timeRangeViolation,Z as timeStepMismatch,M as timeStringToValues,h as to24Hour,A as typeDigit,U as valuesToDate,N as valuesToTimeString};

package/dist/internal/date-value.cjs

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var n in t)f(e,n,{get:t[n],enumerable:!0})},x=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let a of y(t))!N.call(e,a)&&a!==n&&f(e,a,{get:()=>t[a],enumerable:!(r=p(t,a))||r.enumerable});return e};var M=e=>x(f({},"__esModule",{value:!0}),e);var L={};h(L,{resetMalformedDateWarning:()=>b,toCalendarString:()=>$,toCalendarValue:()=>A,toDate:()=>u,toISODateValue:()=>o,toTimeValue:()=>V});module.exports=M(L);var g=require("../utils/is-dev-mode.cjs"),d=require("./date-segments.cjs"),I=/^(\d{4,})-(\d{2})$/,Y=/^(\d{4,}-\d{2}-\d{2})/,c=!1;function b(){c=!1}function m(e,t){c||(c=!0,(0,g.isDevMode)()&&console.warn(`[skdx] ${t?`\`${t}\``:"A date property"} was given ${JSON.stringify(e)}, which is not an ISO-8601 date. Expected \`YYYY-MM-DD\`, \`YYYY-MM-DDTHH:mm[:ss]\`, or a bare \`YYYY-MM\` for a month. The value is ignored \u2014 the property behaves as if it had not been supplied \u2014 rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function u(e,t){if(e==null)return null;if(e instanceof Date)return Number.isNaN(e.getTime())?null:e;if(typeof e!="string")return null;let n=e.trim();if(n==="")return null;let r=(0,d.parseDateFormValue)(n);if(r!==null){let i=Y.exec(n)?.[1];return i!==void 0&&o(r)!==i?(m(n,t),null):r}let a=I.exec(n);if(a){let i=Number(a[2])-1;if(i>=0&&i<=11){let l=Number(a[1]),s=new Date(l,i,1);if(l<100&&s.setFullYear(l),!Number.isNaN(s.getTime()))return s}}return m(n,t),null}function o(e,t="day"){return(0,d.dateToFormValue)(e,t)}function A(e,t,n){if(e===void 0)return;if(e===null)return t==="multiple"?[]:null;if(typeof e=="string"){let i=S(e,n);return D(i,t)}if(Array.isArray(e)){let i=e.map(l=>u(l,n)).filter(l=>l!==null);return D(i,t)}if(e instanceof Date)return D(u(e,n),t);let r=e,a=u(r.start,n);return a===null?t==="multiple"?[]:null:{start:a,end:u(r.end,n)}}function D(e,t){return t!=="multiple"?e:e===null?[]:Array.isArray(e)?e:e instanceof Date?[e]:[]}function S(e,t){let n=e.trim();if(n==="")return null;if(n.includes("/")){let[r="",a=""]=n.split("/"),i=u(r,t);return i===null?null:{start:i,end:a===""?null:u(a,t)}}return n.includes(",")?n.split(",").map(r=>u(r,t)).filter(r=>r!==null):u(n,t)}function $(e){return e==null?null:Array.isArray(e)?e.length===0?null:e.map(t=>o(t)).join(","):e instanceof Date?o(e):`${o(e.start)}/${e.end===null?"":o(e.end)}`}var T=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function V(e,t){if(e==null)return null;if(e instanceof Date){if(Number.isNaN(e.getTime()))return null;let a=s=>String(s).padStart(2,"0"),i=e.getSeconds(),l=`${a(e.getHours())}:${a(e.getMinutes())}`;return i===0?l:`${l}:${a(i)}`}if(typeof e!="string")return null;let n=e.trim();if(n==="")return null;let r=T.exec(n);return!r||Number(r[1])>23||Number(r[2])>59||r[3]!==void 0&&Number(r[3])>59?(m(n,t),null):n}0&&(module.exports={resetMalformedDateWarning,toCalendarString,toCalendarValue,toDate,toISODateValue,toTimeValue});

package/dist/internal/date-value.d.cts

@@ -0,0 +1,63 @@
+import { type Granularity } from './date-segments.cjs';
+/** Anything a date-shaped member accepts: the native object, or its ISO-8601 wire form. */
+export type DateInput = Date | string;
+/** A date range, structurally identical to Calendar's own `DateRange`. */
+export interface DateRangeLike {
+    start: Date;
+    end: Date | null;
+}
+/** What {@link toCalendarValue} produces — the `Date`-shaped selection every framework emits. */
+export type DateValue = Date | Date[] | DateRangeLike | null;
+/** How many dates a selection holds, deciding how a wire string widens. */
+export type SelectionModeLike = 'single' | 'multiple' | 'range';
+/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". Only needed by tests. */
+export declare function resetMalformedDateWarning(): void;
+/**
+ * Parse consumer input into a local `Date` or `null`.
+ * Date passes through untouched (Invalid Date → null). String parsed field-by-field in local time,
+ * never via `new Date(string)` (reads YYYY-MM-DD as UTC, shifting day west of Greenwich).
+ *
+ * @param input `Date`, ISO-8601 string, or `null` / `undefined`
+ * @param source property name for warning
+ * @returns local calendar date, or `null`
+ */
+export declare function toDate(input: DateInput | null | undefined, source?: string): Date | null;
+/**
+ * Canonical ISO-8601 string (persist / form submit). Local wall-clock only
+ * (not UTC via `toISOString()`, which shifts day for half the planet).
+ *
+ * @param date local date to render
+ * @param granularity time-of-day detail level
+ * @returns `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm[:ss]` past `day`
+ */
+export declare function toISODateValue(date: Date, granularity?: Granularity): string;
+/**
+ * Parse a selection (single / array / range) into framework-native shape.
+ * Wire string is self-describing: `YYYY-MM-DD` (single), comma-split (array), slash-split (range).
+ * `undefined` persists (controlled vs uncontrolled distinction); `selectionMode` widens single-date
+ * `multiple` selections to array.
+ *
+ * @param input authored selection, any accepted form
+ * @param mode selection shape (single / multiple / range)
+ * @param source property name for warning
+ */
+export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
+    start: DateInput;
+    end?: DateInput | null;
+} | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
+/**
+ * Canonical wire string for a selection (attribute form / `valueAsString` / persist).
+ *
+ * @param value selection in `Date` shape
+ * @returns string, or `null` if nothing selected
+ */
+export declare function toCalendarString(value: DateValue | undefined): string | null;
+/**
+ * Parse time of day from 24-hour string or `Date` (local wall-clock only, date part discarded).
+ * Time of day is not an instant (why value stays string across framework evolution).
+ *
+ * @param input `HH:mm[:ss]` string, `Date`, or `null` / `undefined`
+ * @param source property name for warning
+ * @returns 24-hour string, or `null` if unreadable
+ */
+export declare function toTimeValue(input: Date | string | null | undefined, source?: string): string | null;

package/dist/internal/date-value.d.ts

@@ -0,0 +1,63 @@
+import { type Granularity } from './date-segments.js';
+/** Anything a date-shaped member accepts: the native object, or its ISO-8601 wire form. */
+export type DateInput = Date | string;
+/** A date range, structurally identical to Calendar's own `DateRange`. */
+export interface DateRangeLike {
+    start: Date;
+    end: Date | null;
+}
+/** What {@link toCalendarValue} produces — the `Date`-shaped selection every framework emits. */
+export type DateValue = Date | Date[] | DateRangeLike | null;
+/** How many dates a selection holds, deciding how a wire string widens. */
+export type SelectionModeLike = 'single' | 'multiple' | 'range';
+/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". Only needed by tests. */
+export declare function resetMalformedDateWarning(): void;
+/**
+ * Parse consumer input into a local `Date` or `null`.
+ * Date passes through untouched (Invalid Date → null). String parsed field-by-field in local time,
+ * never via `new Date(string)` (reads YYYY-MM-DD as UTC, shifting day west of Greenwich).
+ *
+ * @param input `Date`, ISO-8601 string, or `null` / `undefined`
+ * @param source property name for warning
+ * @returns local calendar date, or `null`
+ */
+export declare function toDate(input: DateInput | null | undefined, source?: string): Date | null;
+/**
+ * Canonical ISO-8601 string (persist / form submit). Local wall-clock only
+ * (not UTC via `toISOString()`, which shifts day for half the planet).
+ *
+ * @param date local date to render
+ * @param granularity time-of-day detail level
+ * @returns `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm[:ss]` past `day`
+ */
+export declare function toISODateValue(date: Date, granularity?: Granularity): string;
+/**
+ * Parse a selection (single / array / range) into framework-native shape.
+ * Wire string is self-describing: `YYYY-MM-DD` (single), comma-split (array), slash-split (range).
+ * `undefined` persists (controlled vs uncontrolled distinction); `selectionMode` widens single-date
+ * `multiple` selections to array.
+ *
+ * @param input authored selection, any accepted form
+ * @param mode selection shape (single / multiple / range)
+ * @param source property name for warning
+ */
+export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
+    start: DateInput;
+    end?: DateInput | null;
+} | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
+/**
+ * Canonical wire string for a selection (attribute form / `valueAsString` / persist).
+ *
+ * @param value selection in `Date` shape
+ * @returns string, or `null` if nothing selected
+ */
+export declare function toCalendarString(value: DateValue | undefined): string | null;
+/**
+ * Parse time of day from 24-hour string or `Date` (local wall-clock only, date part discarded).
+ * Time of day is not an instant (why value stays string across framework evolution).
+ *
+ * @param input `HH:mm[:ss]` string, `Date`, or `null` / `undefined`
+ * @param source property name for warning
+ * @returns 24-hour string, or `null` if unreadable
+ */
+export declare function toTimeValue(input: Date | string | null | undefined, source?: string): string | null;

package/dist/internal/date-value.js

@@ -0,0 +1 @@
+import{isDevMode as c}from"../utils/is-dev-mode.js";import{dateToFormValue as m,parseDateFormValue as g}from"./date-segments.js";var p=/^(\d{4,})-(\d{2})$/,y=/^(\d{4,}-\d{2}-\d{2})/,f=!1;function I(){f=!1}function D(e,t){f||(f=!0,c()&&console.warn(`[skdx] ${t?`\`${t}\``:"A date property"} was given ${JSON.stringify(e)}, which is not an ISO-8601 date. Expected \`YYYY-MM-DD\`, \`YYYY-MM-DDTHH:mm[:ss]\`, or a bare \`YYYY-MM\` for a month. The value is ignored \u2014 the property behaves as if it had not been supplied \u2014 rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function u(e,t){if(e==null)return null;if(e instanceof Date)return Number.isNaN(e.getTime())?null:e;if(typeof e!="string")return null;let n=e.trim();if(n==="")return null;let r=g(n);if(r!==null){let a=y.exec(n)?.[1];return a!==void 0&&s(r)!==a?(D(n,t),null):r}let i=p.exec(n);if(i){let a=Number(i[2])-1;if(a>=0&&a<=11){let l=Number(i[1]),o=new Date(l,a,1);if(l<100&&o.setFullYear(l),!Number.isNaN(o.getTime()))return o}}return D(n,t),null}function s(e,t="day"){return m(e,t)}function Y(e,t,n){if(e===void 0)return;if(e===null)return t==="multiple"?[]:null;if(typeof e=="string"){let a=N(e,n);return d(a,t)}if(Array.isArray(e)){let a=e.map(l=>u(l,n)).filter(l=>l!==null);return d(a,t)}if(e instanceof Date)return d(u(e,n),t);let r=e,i=u(r.start,n);return i===null?t==="multiple"?[]:null:{start:i,end:u(r.end,n)}}function d(e,t){return t!=="multiple"?e:e===null?[]:Array.isArray(e)?e:e instanceof Date?[e]:[]}function N(e,t){let n=e.trim();if(n==="")return null;if(n.includes("/")){let[r="",i=""]=n.split("/"),a=u(r,t);return a===null?null:{start:a,end:i===""?null:u(i,t)}}return n.includes(",")?n.split(",").map(r=>u(r,t)).filter(r=>r!==null):u(n,t)}function b(e){return e==null?null:Array.isArray(e)?e.length===0?null:e.map(t=>s(t)).join(","):e instanceof Date?s(e):`${s(e.start)}/${e.end===null?"":s(e.end)}`}var h=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function A(e,t){if(e==null)return null;if(e instanceof Date){if(Number.isNaN(e.getTime()))return null;let i=o=>String(o).padStart(2,"0"),a=e.getSeconds(),l=`${i(e.getHours())}:${i(e.getMinutes())}`;return a===0?l:`${l}:${i(a)}`}if(typeof e!="string")return null;let n=e.trim();if(n==="")return null;let r=h.exec(n);return!r||Number(r[1])>23||Number(r[2])>59||r[3]!==void 0&&Number(r[3])>59?(D(n,t),null):n}export{I as resetMalformedDateWarning,b as toCalendarString,Y as toCalendarValue,u as toDate,s as toISODateValue,A as toTimeValue};

package/dist/internal/define.cjs

@@ -1 +1 @@
-"use strict";var r=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var f=(e,t)=>{for(var n in t)r(e,n,{get:t[n],enumerable:!0})},u=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of d(t))!C.call(e,s)&&s!==n&&r(e,s,{get:()=>t[s],enumerable:!(o=m(t,s))||o.enumerable});return e};var p=e=>u(r({},"__esModule",{value:!0}),e);var y={};f(y,{customElement:()=>E});module.exports=p(y);var a=require("./part.cjs"),l=require("./styles.cjs"),c=Symbol.for("skdx.part"),E=(e,t,n)=>((o,s)=>{t!==void 0&&n!==void 0&&(o[c]=[t,n]),h(o);let i=()=>{customElements.get(e)===void 0&&customElements.define(e,o)};s===void 0?i():s.addInitializer(i)});function h(e){let t=e.prototype,n=t.connectedCallback;t.connectedCallback=function(){let o=this.constructor[c];o&&(0,a.applyHostPart)(this,o[0],o[1]),n?.call(this),this.shadowRoot&&(0,l.adoptInheritanceStyles)(this.shadowRoot)}}0&&(module.exports={customElement});
+"use strict";var r=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var f=(t,e)=>{for(var n in e)r(t,n,{get:e[n],enumerable:!0})},C=(t,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of d(e))!u.call(t,s)&&s!==n&&r(t,s,{get:()=>e[s],enumerable:!(o=m(e,s))||o.enumerable});return t};var p=t=>C(r({},"__esModule",{value:!0}),t);var b={};f(b,{customElement:()=>E,isUpgraded:()=>g,whenUpgraded:()=>y});module.exports=p(b);var a=require("./part.cjs"),l=require("./styles.cjs"),c=Symbol.for("skdx.part"),E=(t,e,n)=>((o,s)=>{e!==void 0&&n!==void 0&&(o[c]=[e,n]),h(o);let i=()=>{customElements.get(t)===void 0&&customElements.define(t,o)};s===void 0?i():s.addInitializer(i)});function h(t){let e=t.prototype,n=e.connectedCallback;e.connectedCallback=function(){let o=this.constructor[c];o&&(0,a.applyHostPart)(this,o[0],o[1]),n?.call(this),this.shadowRoot&&(0,l.adoptInheritanceStyles)(this.shadowRoot)}}function y(t,e){customElements.get(t.localName)?e():customElements.whenDefined(t.localName).then(e)}function g(t){return customElements.get(t.localName)!==void 0}0&&(module.exports={customElement,isUpgraded,whenUpgraded});

package/dist/internal/define.d.cts

@@ -1,38 +1,11 @@
 import type { CustomElementDecorator } from 'lit/decorators.js';
 /**
- * Drop-in replacement for Lit's `customElement` decorator that **skips the
- * define when the tag is already registered** instead of throwing.
- *
- * `customElements.define()` throws `NotSupportedError: name has already been
- * used with this registry` and, because every module in this package is
- * side-effectful (`sideEffects: true`), that throw happens at *import* time
- * and takes the entire host bundle down. Duplicate registration is not a
- * hypothetical here: the package ships both ESM and CJS, and those are
- * separate module registries — one dependency resolving `dist/index.cjs`
- * while another resolves `dist/index.js` is enough, as is two majors of
- * `@skdx/web-components` coexisting in a single dependency tree.
- *
- * First definition wins. A second copy of the package silently reuses the
- * already-registered class rather than replacing it, which matches how every
- * other custom-element library resolves the same collision.
- *
- * Otherwise identical to `lit/decorators.js`'s `customElement`, including
- * standard-decorator support (the define runs from a class initializer, so
- * the registry check happens at define time in both decorator modes).
- *
- * Skin parts
- * ----------
- * Passing `component` and `part` makes the element carry its `@skdx/skins`
- * class on the host — see {@link applyHostPart} for why the host and not the
- * shadow root. It is done here, rather than in 295 `connectedCallback`s,
- * because every element in the package already routes through this one
- * decorator: the part then sits on the same line as the tag name it belongs
- * to, and no component can acquire a shadow root without a reviewer seeing
- * whether it declared a part.
- *
- * Omitting them is meaningful, not a default: an element with no part is one
- * `@skdx/skins` does not style. `scripts/skin-parts.mjs` is what holds that
- * claim honest against React.
- * @internal
+ * Decorator that skips re-registration of already-registered tags, avoiding
+ * `NotSupportedError` at import time. First definition wins. Optionally applies
+ * skin part class via `component` and `part` parameters. @internal
  */
 export declare const customElement: (tagName: string, component?: string, part?: string) => CustomElementDecorator;
+/** Runs callback once element is upgraded to its custom-element definition. @internal */
+export declare function whenUpgraded(element: Element, then: () => void): void;
+/** True once `element`'s tag has a registered custom-element definition. @internal */
+export declare function isUpgraded(element: Element): boolean;

package/dist/internal/define.d.ts

@@ -1,38 +1,11 @@
 import type { CustomElementDecorator } from 'lit/decorators.js';
 /**
- * Drop-in replacement for Lit's `customElement` decorator that **skips the
- * define when the tag is already registered** instead of throwing.
- *
- * `customElements.define()` throws `NotSupportedError: name has already been
- * used with this registry` and, because every module in this package is
- * side-effectful (`sideEffects: true`), that throw happens at *import* time
- * and takes the entire host bundle down. Duplicate registration is not a
- * hypothetical here: the package ships both ESM and CJS, and those are
- * separate module registries — one dependency resolving `dist/index.cjs`
- * while another resolves `dist/index.js` is enough, as is two majors of
- * `@skdx/web-components` coexisting in a single dependency tree.
- *
- * First definition wins. A second copy of the package silently reuses the
- * already-registered class rather than replacing it, which matches how every
- * other custom-element library resolves the same collision.
- *
- * Otherwise identical to `lit/decorators.js`'s `customElement`, including
- * standard-decorator support (the define runs from a class initializer, so
- * the registry check happens at define time in both decorator modes).
- *
- * Skin parts
- * ----------
- * Passing `component` and `part` makes the element carry its `@skdx/skins`
- * class on the host — see {@link applyHostPart} for why the host and not the
- * shadow root. It is done here, rather than in 295 `connectedCallback`s,
- * because every element in the package already routes through this one
- * decorator: the part then sits on the same line as the tag name it belongs
- * to, and no component can acquire a shadow root without a reviewer seeing
- * whether it declared a part.
- *
- * Omitting them is meaningful, not a default: an element with no part is one
- * `@skdx/skins` does not style. `scripts/skin-parts.mjs` is what holds that
- * claim honest against React.
- * @internal
+ * Decorator that skips re-registration of already-registered tags, avoiding
+ * `NotSupportedError` at import time. First definition wins. Optionally applies
+ * skin part class via `component` and `part` parameters. @internal
  */
 export declare const customElement: (tagName: string, component?: string, part?: string) => CustomElementDecorator;
+/** Runs callback once element is upgraded to its custom-element definition. @internal */
+export declare function whenUpgraded(element: Element, then: () => void): void;
+/** True once `element`'s tag has a registered custom-element definition. @internal */
+export declare function isUpgraded(element: Element): boolean;

package/dist/internal/define.js

@@ -1 +1 @@
-import{applyHostPart as a}from"./part.js";import{adoptInheritanceStyles as l}from"./styles.js";var i=Symbol.for("skdx.part"),C=(o,e,n)=>((t,s)=>{e!==void 0&&n!==void 0&&(t[i]=[e,n]),c(t);let r=()=>{customElements.get(o)===void 0&&customElements.define(o,t)};s===void 0?r():s.addInitializer(r)});function c(o){let e=o.prototype,n=e.connectedCallback;e.connectedCallback=function(){let t=this.constructor[i];t&&a(this,t[0],t[1]),n?.call(this),this.shadowRoot&&l(this.shadowRoot)}}export{C as customElement};
+import{applyHostPart as a}from"./part.js";import{adoptInheritanceStyles as l}from"./styles.js";var i=Symbol.for("skdx.part"),u=(e,t,n)=>((o,s)=>{t!==void 0&&n!==void 0&&(o[i]=[t,n]),c(o);let r=()=>{customElements.get(e)===void 0&&customElements.define(e,o)};s===void 0?r():s.addInitializer(r)});function c(e){let t=e.prototype,n=t.connectedCallback;t.connectedCallback=function(){let o=this.constructor[i];o&&a(this,o[0],o[1]),n?.call(this),this.shadowRoot&&l(this.shadowRoot)}}function f(e,t){customElements.get(e.localName)?t():customElements.whenDefined(e.localName).then(t)}function C(e){return customElements.get(e.localName)!==void 0}export{u as customElement,C as isUpgraded,f as whenUpgraded};

package/dist/internal/derive.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var y=(t,e)=>{for(var n in e)c(t,n,{get:e[n],enumerable:!0})},v=(t,e,n,l)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of E(e))!b.call(t,r)&&r!==n&&c(t,r,{get:()=>e[r],enumerable:!(l=h(e,r))||l.enumerable});return t};var A=t=>v(c({},"__esModule",{value:!0}),t);var C={};y(C,{applyChildren:()=>w,claimSlot:()=>$,generatedPart:()=>p,hasAuthoredPart:()=>g,textPart:()=>x});module.exports=A(C);var f=require("../utils/is-dev-mode.cjs");function p(t,e,n){return t.querySelector(`:scope > ${e}[${n}]`)}function g(t,e,n){return t.querySelector(`:scope > ${e}:not([${n}])`)!==null}function $(t,e,n,l,r=t){let m=r.querySelector(`:scope > ${n}[${l}="${e}"]`);if(m)return m;let i=Array.from(t.children).filter(u=>u.getAttribute("slot")===e);if(i.length===0)return null;let[o]=i;if(i.length===1&&o&&o.localName===n)return o.removeAttribute("slot"),o.setAttribute(l,e),o;let s=document.createElement(n);s.setAttribute(l,e);for(let u of i)u.removeAttribute("slot");return s.append(...i),s}function x(t,e,n,l){if(!n||g(t,e,l))return null;let r=p(t,e,l)??document.createElement(e);return r.setAttribute(l,""),r.textContent!==n&&(r.textContent=n),r}function w(t,e){let n=t.childNodes;n.length===e.length&&e.every((l,r)=>n[r]===l)||((0,f.isDevMode)()&&M(t),t.replaceChildren(...e))}var a=new WeakMap,d=!1;function M(t){let e=(a.get(t)??0)+1;if(a.set(t,e),d||(d=!0,setTimeout(()=>{a=new WeakMap,d=!1})),e>100)throw new Error(`[skandadx] <${t.tagName.toLowerCase()}> rebuilt its derived anatomy ${e} times in one task. A derived part is being re-created instead of reclaimed \u2014 check that it is stamped with the marker value its lookup reads.`)}0&&(module.exports={applyChildren,claimSlot,generatedPart,hasAuthoredPart,textPart});

package/dist/internal/derive.d.cts

@@ -0,0 +1,31 @@
+/**
+ * Light-DOM derived anatomy building blocks, used by recipes that wrap consumer
+ * content (`<skdx-card>`, `<skdx-field>`, `<skdx-alert>`). These derive
+ * additively per prop/slot, not via `hasAuthoredParts`.
+ * @internal
+ */
+/** The generated `tag` directly under `root`, if this module already made one. */
+export declare function generatedPart(root: Element, tag: string, marker: string): HTMLElement | null;
+/** Whether the consumer authored a `tag` of their own — the guard against deriving a duplicate. */
+export declare function hasAuthoredPart(root: Element, tag: string, marker: string): boolean;
+/**
+ * Wraps `root`'s `slot="name"` children in a generated `tag`, reusing it from
+ * a previous build. The `slot` attribute is stripped as claimed; once moved
+ * inside the part, an unmatched `slot` blocks its shadow `<slot>`.
+ *
+ * `within` is where the wrapper was placed previously (e.g., QrCode's Overlay
+ * inside Frame). Searching the wrong parent treats it as absent and drops it.
+ */
+export declare function claimSlot(root: Element, name: string, tag: string, marker: string, within?: Element): Element | null;
+/**
+ * Generated `tag` holding text, reused across updates. Returns `null` for
+ * empty text or when consumer authored the part (a duplicate would exceed one
+ * generated id).
+ */
+export declare function textPart(root: Element, tag: string, text: string | undefined, marker: string): Element | null;
+/**
+ * Writes `nodes` to `root` only if they differ. Re-inserting identical nodes
+ * disconnects and reconnects custom elements, losing focus — a cost since these
+ * rebuild on every property change.
+ */
+export declare function applyChildren(root: Element, nodes: readonly Node[]): void;

package/dist/internal/derive.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Light-DOM derived anatomy building blocks, used by recipes that wrap consumer
+ * content (`<skdx-card>`, `<skdx-field>`, `<skdx-alert>`). These derive
+ * additively per prop/slot, not via `hasAuthoredParts`.
+ * @internal
+ */
+/** The generated `tag` directly under `root`, if this module already made one. */
+export declare function generatedPart(root: Element, tag: string, marker: string): HTMLElement | null;
+/** Whether the consumer authored a `tag` of their own — the guard against deriving a duplicate. */
+export declare function hasAuthoredPart(root: Element, tag: string, marker: string): boolean;
+/**
+ * Wraps `root`'s `slot="name"` children in a generated `tag`, reusing it from
+ * a previous build. The `slot` attribute is stripped as claimed; once moved
+ * inside the part, an unmatched `slot` blocks its shadow `<slot>`.
+ *
+ * `within` is where the wrapper was placed previously (e.g., QrCode's Overlay
+ * inside Frame). Searching the wrong parent treats it as absent and drops it.
+ */
+export declare function claimSlot(root: Element, name: string, tag: string, marker: string, within?: Element): Element | null;
+/**
+ * Generated `tag` holding text, reused across updates. Returns `null` for
+ * empty text or when consumer authored the part (a duplicate would exceed one
+ * generated id).
+ */
+export declare function textPart(root: Element, tag: string, text: string | undefined, marker: string): Element | null;
+/**
+ * Writes `nodes` to `root` only if they differ. Re-inserting identical nodes
+ * disconnects and reconnects custom elements, losing focus — a cost since these
+ * rebuild on every property change.
+ */
+export declare function applyChildren(root: Element, nodes: readonly Node[]): void;

package/dist/internal/derive.js

@@ -0,0 +1 @@
+import{isDevMode as m}from"../utils/is-dev-mode.js";function f(t,e,n){return t.querySelector(`:scope > ${e}[${n}]`)}function p(t,e,n){return t.querySelector(`:scope > ${e}:not([${n}])`)!==null}function E(t,e,n,r,l=t){let d=l.querySelector(`:scope > ${n}[${r}="${e}"]`);if(d)return d;let i=Array.from(t.children).filter(u=>u.getAttribute("slot")===e);if(i.length===0)return null;let[o]=i;if(i.length===1&&o&&o.localName===n)return o.removeAttribute("slot"),o.setAttribute(r,e),o;let s=document.createElement(n);s.setAttribute(r,e);for(let u of i)u.removeAttribute("slot");return s.append(...i),s}function b(t,e,n,r){if(!n||p(t,e,r))return null;let l=f(t,e,r)??document.createElement(e);return l.setAttribute(r,""),l.textContent!==n&&(l.textContent=n),l}function y(t,e){let n=t.childNodes;n.length===e.length&&e.every((r,l)=>n[l]===r)||(m()&&g(t),t.replaceChildren(...e))}var c=new WeakMap,a=!1;function g(t){let e=(c.get(t)??0)+1;if(c.set(t,e),a||(a=!0,setTimeout(()=>{c=new WeakMap,a=!1})),e>100)throw new Error(`[skandadx] <${t.tagName.toLowerCase()}> rebuilt its derived anatomy ${e} times in one task. A derived part is being re-created instead of reclaimed \u2014 check that it is stamped with the marker value its lookup reads.`)}export{y as applyChildren,E as claimSlot,f as generatedPart,p as hasAuthoredPart,b as textPart};