@skdx/vue 0.27.0 → 0.29.0

package/dist/utils/color.cjs

@@ -1 +1 @@
-const l=require("./clamp.cjs");function u(n,t=0){const r=10**t;return Math.round(n*r)/r}function h(n){return(n%360+360)%360}function f(n){return l.clamp(Math.round(n),0,255).toString(16).padStart(2,"0")}function M(n,t,r,s,c){return c?h((s===n?(t-r)/c:s===t?(r-n)/c+2:(n-t)/c+4)*60):0}function R(n,t,r,s,c){const o=Math.floor(h(n)/60)%6,[a,e,i]=[[t,r,0],[r,t,0],[0,t,r],[0,r,t],[r,0,t],[t,0,r]][o]??[0,0,0];return{r:u((a+s)*255),g:u((e+s)*255),b:u((i+s)*255),a:c}}function C(n,t=!1){const r=`#${f(n.r)}${f(n.g)}${f(n.b)}`;return t?`${r}${f(l.clamp(n.a,0,1)*255)}`:r}var A=/^#?([\da-f]{3,8})$/i;function x(n){const t=A.exec(n.trim());if(!t)return null;let r=t[1];if((r.length===3||r.length===4)&&(r=r.split("").map(c=>c+c).join("")),r.length!==6&&r.length!==8)return null;const s=c=>parseInt(r.slice(c,c+2),16);return{r:s(0),g:s(2),b:s(4),a:r.length===8?u(s(6)/255,3):1}}function g(n){const t=l.clamp(n.r,0,255)/255,r=l.clamp(n.g,0,255)/255,s=l.clamp(n.b,0,255)/255,c=Math.max(t,r,s),o=c-Math.min(t,r,s);return{h:M(t,r,s,c,o),s:c?o/c*100:0,b:c*100,a:l.clamp(n.a,0,1)}}function T(n){const t=h(n.h),r=l.clamp(n.s,0,100)/100,s=l.clamp(n.b,0,100)/100,c=s*r;return R(t,c,c*(1-Math.abs(t/60%2-1)),s-c,l.clamp(n.a,0,1))}function E(n){const t=l.clamp(n.r,0,255)/255,r=l.clamp(n.g,0,255)/255,s=l.clamp(n.b,0,255)/255,c=Math.max(t,r,s),o=Math.min(t,r,s),a=c-o,e=(c+o)/2,i=a?a/(1-Math.abs(2*e-1)):0;return{h:M(t,r,s,c,a),s:l.clamp(i*100,0,100),l:e*100,a:l.clamp(n.a,0,1)}}function F(n){const t=h(n.h),r=l.clamp(n.s,0,100)/100,s=l.clamp(n.l,0,100)/100,c=(1-Math.abs(2*s-1))*r;return R(t,c,c*(1-Math.abs(t/60%2-1)),s-c/2,l.clamp(n.a,0,1))}function N(n){const t=l.clamp(n.s,0,100)/100,r=l.clamp(n.b,0,100)/100,s=r*(1-t/2),c=Math.min(s,1-s);return{h:h(n.h),s:c?(r-s)/c*100:0,l:s*100,a:l.clamp(n.a,0,1)}}function O(n){const t=l.clamp(n.s,0,100)/100,r=l.clamp(n.l,0,100)/100,s=r+t*Math.min(r,1-r);return{h:h(n.h),s:s?2*(1-r/s)*100:0,b:s*100,a:l.clamp(n.a,0,1)}}var _=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function d(n){if(n===void 0)return null;const t=n.endsWith("%"),r=t?n.slice(0,-1):n.replace(/deg$/,"");if(r.trim()==="")return null;const s=Number(r);return Number.isFinite(s)?{value:s,percent:t}:null}function b(n){const t=d(n);return t&&(t.percent?t.value/100*255:t.value)}function $(n){const t=d(n);return t&&t.value}function q(n){if(n===void 0)return 1;const t=d(n);return t&&(t.percent?t.value/100:t.value)}function m(n){return{h:u(h(n.h),2),s:u(l.clamp(n.s,0,100),2),b:u(l.clamp(n.b,0,100),2),a:u(l.clamp(n.a,0,1),3)}}function w(n){if(typeof n!="string")return null;const t=n.trim().toLowerCase();if(!t)return null;const r=_.exec(t);if(!r){const p=x(t);return p?m(g(p)):null}const s=r[1].replace(/a$/,""),c=r[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);if(c.length!==3&&c.length!==4)return null;const o=q(c[3]);if(o===null)return null;if(s==="rgb"){const p=b(c[0]),v=b(c[1]),H=b(c[2]);return p===null||v===null||H===null?null:m(g({r:p,g:v,b:H,a:o}))}const a=$(c[0]),e=$(c[1]),i=$(c[2]);return a===null||e===null||i===null?null:m(s==="hsl"?O({h:a,s:e,l:i,a:o}):{h:a,s:e,b:i,a:o})}function y(n,t,r=!0){const s=u(l.clamp(n.a,0,1),3),c=r&&s<1;if(t==="rgb"){const{r:o,g:a,b:e}=T(n);return c?`rgba(${o}, ${a}, ${e}, ${s})`:`rgb(${o}, ${a}, ${e})`}if(t==="hsl"){const o=N(n),a=u(o.h),e=u(o.s),i=u(o.l);return c?`hsla(${a}, ${e}%, ${i}%, ${s})`:`hsl(${a}, ${e}%, ${i}%)`}if(t==="hsb"){const o=u(h(n.h)),a=u(l.clamp(n.s,0,100)),e=u(l.clamp(n.b,0,100));return c?`hsba(${o}, ${a}%, ${e}%, ${s})`:`hsb(${o}, ${a}%, ${e}%)`}return C(T(n),c)}exports.formatColor=y;exports.hexToRgb=x;exports.hsbToHsl=N;exports.hsbToRgb=T;exports.hslToHsb=O;exports.hslToRgb=F;exports.parseColor=w;exports.rgbToHex=C;exports.rgbToHsb=g;exports.rgbToHsl=E;
+function u(n,t,r){return Math.min(Math.max(n,t),r)}function a(n,t=0){const r=10**t;return Math.round(n*r)/r}function h(n){return(n%360+360)%360}function f(n){return u(Math.round(n),0,255).toString(16).padStart(2,"0")}function M(n,t,r,s,o){if(!o)return 0;let e;return s===n?e=(t-r)/o:s===t?e=(r-n)/o+2:e=(n-t)/o+4,h(e*60)}function v(n,t,r,s,o){const e=Math.floor(h(n)/60)%6,[c,l,i]=[[t,r,0],[r,t,0],[0,t,r],[0,r,t],[r,0,t],[t,0,r]][e]??[0,0,0];return{r:a((c+s)*255),g:a((l+s)*255),b:a((i+s)*255),a:o}}function d(n,t=!1){const r=`#${f(n.r)}${f(n.g)}${f(n.b)}`;return t?`${r}${f(u(n.a,0,1)*255)}`:r}var C=/^#?([\da-f]{3,8})$/i;function H(n){const t=C.exec(n.trim());if(!t)return null;let r=t[1];if((r.length===3||r.length===4)&&(r=r.split("").map(o=>o+o).join("")),r.length!==6&&r.length!==8)return null;const s=o=>parseInt(r.slice(o,o+2),16);return{r:s(0),g:s(2),b:s(4),a:r.length===8?a(s(6)/255,3):1}}function T(n){const t=u(n.r,0,255)/255,r=u(n.g,0,255)/255,s=u(n.b,0,255)/255,o=Math.max(t,r,s),e=o-Math.min(t,r,s);return{h:M(t,r,s,o,e),s:o?e/o*100:0,b:o*100,a:u(n.a,0,1)}}function m(n){const t=h(n.h),r=u(n.s,0,100)/100,s=u(n.b,0,100)/100,o=s*r;return v(t,o,o*(1-Math.abs(t/60%2-1)),s-o,u(n.a,0,1))}function N(n){const t=u(n.r,0,255)/255,r=u(n.g,0,255)/255,s=u(n.b,0,255)/255,o=Math.max(t,r,s),e=Math.min(t,r,s),c=o-e,l=(o+e)/2,i=c?c/(1-Math.abs(2*l-1)):0;return{h:M(t,r,s,o,c),s:u(i*100,0,100),l:l*100,a:u(n.a,0,1)}}function O(n){const t=h(n.h),r=u(n.s,0,100)/100,s=u(n.l,0,100)/100,o=(1-Math.abs(2*s-1))*r;return v(t,o,o*(1-Math.abs(t/60%2-1)),s-o/2,u(n.a,0,1))}function R(n){const t=u(n.s,0,100)/100,r=u(n.b,0,100)/100,s=r*(1-t/2),o=Math.min(s,1-s);return{h:h(n.h),s:o?(r-s)/o*100:0,l:s*100,a:u(n.a,0,1)}}function x(n){const t=u(n.s,0,100)/100,r=u(n.l,0,100)/100,s=r+t*Math.min(r,1-r);return{h:h(n.h),s:s?2*(1-r/s)*100:0,b:s*100,a:u(n.a,0,1)}}var A=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function p(n){if(n===void 0)return null;const t=n.endsWith("%"),r=t?n.slice(0,-1):n.replace(/deg$/,"");if(r.trim()==="")return null;const s=Number(r);return Number.isFinite(s)?{value:s,percent:t}:null}function $(n){const t=p(n);return t&&(t.percent?t.value/100*255:t.value)}function g(n){const t=p(n);return t&&t.value}function F(n){if(n===void 0)return 1;const t=p(n);return t&&(t.percent?t.value/100:t.value)}function b(n){return{h:a(h(n.h),2),s:a(u(n.s,0,100),2),b:a(u(n.b,0,100),2),a:a(u(n.a,0,1),3)}}function E(n){if(typeof n!="string")return null;const t=n.trim().toLowerCase();if(!t)return null;const r=A.exec(t);if(!r){const e=H(t);return e?b(T(e)):null}const s=r[1].replace(/a$/,""),o=r[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);return o.length!==3&&o.length!==4?null:P(s,o)}function P(n,t){const r=F(t[3]);if(r===null)return null;if(n==="rgb"){const c=$(t[0]),l=$(t[1]),i=$(t[2]);return c===null||l===null||i===null?null:b(T({r:c,g:l,b:i,a:r}))}const s=g(t[0]),o=g(t[1]),e=g(t[2]);return s===null||o===null||e===null?null:b(n==="hsl"?x({h:s,s:o,l:e,a:r}):{h:s,s:o,b:e,a:r})}function w(n,t,r=!0){const s=a(u(n.a,0,1),3),o=r&&s<1;if(t==="rgb"){const{r:e,g:c,b:l}=m(n);return o?`rgba(${e}, ${c}, ${l}, ${s})`:`rgb(${e}, ${c}, ${l})`}if(t==="hsl"){const e=R(n),c=a(e.h),l=a(e.s),i=a(e.l);return o?`hsla(${c}, ${l}%, ${i}%, ${s})`:`hsl(${c}, ${l}%, ${i}%)`}if(t==="hsb"){const e=a(h(n.h)),c=a(u(n.s,0,100)),l=a(u(n.b,0,100));return o?`hsba(${e}, ${c}%, ${l}%, ${s})`:`hsb(${e}, ${c}%, ${l}%)`}return d(m(n),o)}exports.formatColor=w;exports.hexToRgb=H;exports.hsbToHsl=R;exports.hsbToRgb=m;exports.hslToHsb=x;exports.hslToRgb=O;exports.parseColor=E;exports.rgbToHex=d;exports.rgbToHsb=T;exports.rgbToHsl=N;

package/dist/utils/color.d.cts

@@ -1,20 +1,3 @@
-/**
- * Colour maths for pickers, swatches and contrast checks — parsing, the four
- * model conversions, and serialisation back to a string.
- *
- * Deliberately dependency-free and Vue-free: it is imported by
- * `SkdxColorPicker`, but nothing here knows what a component is, so it can be
- * unit-tested as plain arithmetic and reused by a Node-side token pipeline.
- * Mirrors `packages/react/src/utils/color.ts` exactly — a behavioural
- * difference between the two is a bug in one of them.
- *
- * **HSB is the canonical model** for anything that stores a colour over time.
- * RGB and hex cannot represent the hue of a black or a white — every fully
- * dark colour is `#000000` regardless of which hue it came from — so a picker
- * that round-trips through RGB on every drag loses the user's hue the moment
- * they drag brightness to zero. Convert to RGB/hex at the edges, not in the
- * middle.
- */
 /** sRGB colour: `r`/`g`/`b` in `0–255`, `a` in `0–1`. */
 export interface RgbColor {
     r: number;
@@ -29,30 +12,17 @@ export interface HslColor {
     l: number;
     a: number;
 }
-/**
- * HSB (a.k.a. HSV) colour: `h` in `0–360` degrees, `s` (saturation) and `b`
- * (brightness) in `0–100` percent, `a` in `0–1`.
- *
- * Note `b` is **brightness**, not blue — the field names follow the model's
- * own initials, the way `RgbColor.b` follows RGB's.
- */
+/** HSB (a.k.a. HSV) colour: `h` in `0–360` degrees, `s`/`b` in `0–100` percent, `a` in `0–1`; `b` is brightness, not blue. */
 export interface HsbColor {
     h: number;
     s: number;
     b: number;
     a: number;
 }
-/**
- * Serialisation targets for {@link formatColor}. `'hsb'` is this library's own
- * notation (`hsb(210, 60%, 85%)`) rather than a CSS colour — CSS has no HSB
- * function — so it round-trips through {@link parseColor} but must not be
- * dropped into a stylesheet.
- */
+/** Serialisation targets for {@link formatColor}; `'hsb'` is this library's own notation, not CSS, so it round-trips through {@link parseColor} but must not go in a stylesheet. */
 export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'hsb';
 /**
- * Serialises an sRGB colour as `#rrggbb`, or `#rrggbbaa` when `includeAlpha`
- * is set. Channels are clamped and rounded, so a computed colour with
- * `r: 255.4` still produces valid hex rather than `#ff.6…`.
+ * Serialises an sRGB colour as `#rrggbb`, or `#rrggbbaa` when `includeAlpha` is set, clamping and rounding channels so a computed colour with `r: 255.4` still produces valid hex.
  *
  * @example
  * ```ts
@@ -62,9 +32,7 @@ export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'hsb';
  */
 export declare function rgbToHex(rgb: RgbColor, includeAlpha?: boolean): string;
 /**
- * Parses `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` (leading `#` optional,
- * case-insensitive) into sRGB. Returns `null` for anything else — including
- * 5- and 7-digit strings, which look like hex but are not a colour.
+ * Parses `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` into sRGB, returning `null` for anything else, including 5- and 7-digit strings that look like hex but aren't a colour.
  *
  * @example
  * ```ts
@@ -74,11 +42,7 @@ export declare function rgbToHex(rgb: RgbColor, includeAlpha?: boolean): string;
  * ```
  */
 export declare function hexToRgb(hex: string): RgbColor | null;
-/**
- * sRGB → HSB. A greyscale colour reports hue `0`, because it genuinely has
- * none — see the module note on why that makes HSB, not RGB, the model to
- * store.
- */
+/** sRGB → HSB. A greyscale colour reports hue `0`, because it genuinely has none. */
 export declare function rgbToHsb(rgb: RgbColor): HsbColor;
 /** HSB → sRGB. */
 export declare function hsbToRgb(hsb: HsbColor): RgbColor;
@@ -86,33 +50,12 @@ export declare function hsbToRgb(hsb: HsbColor): RgbColor;
 export declare function rgbToHsl(rgb: RgbColor): HslColor;
 /** HSL → sRGB. */
 export declare function hslToRgb(hsl: HslColor): RgbColor;
-/**
- * HSB → HSL, computed directly rather than via RGB. The detour would quantise
- * to 8 bits and flatten the hue of any near-black colour, which is exactly the
- * loss this module exists to avoid.
- */
+/** HSB → HSL, computed directly rather than via RGB, since the detour would quantise to 8 bits and flatten near-black hues. */
 export declare function hsbToHsl(hsb: HsbColor): HslColor;
 /** HSL → HSB, the exact inverse of {@link hsbToHsl}, also without an RGB detour. */
 export declare function hslToHsb(hsl: HslColor): HsbColor;
 /**
- * Parses a colour string into the canonical {@link HsbColor}, returning
- * **`null` rather than throwing** for anything it does not understand — this
- * is fed by user-typed text and by whatever a consumer passes as `value`, so
- * "unparseable" is a normal outcome, not an exception.
- *
- * Tolerant about *formatting*, not about vocabulary. It accepts:
- *
- * - hex, with or without `#`, in 3/4/6/8 digits;
- * - `rgb()` / `rgba()`, with numeric or `%` channels;
- * - `hsl()` / `hsla()`, with or without the `%` on saturation/lightness and
- *   with or without `deg` on the hue;
- * - `hsb()` / `hsba()` / `hsv()` / `hsva()`, this library's own notation;
- * - comma-separated *or* space-separated arguments, with the modern
- *   `rgb(255 0 0 / 50%)` slash-alpha form.
- *
- * It does **not** know named colours (`red`, `transparent`), `color()`,
- * `lab()`/`oklch()`, or `turn`/`rad` hue units. Those all return `null`; a
- * 148-entry name table is a dependency's job, not a picker's.
+ * Parses a colour string (hex, `rgb()`, `hsl()`, or this library's own `hsb()`) into the canonical {@link HsbColor}, returning `null` rather than throwing for anything unrecognized, including named colours.
  *
  * @example
  * ```ts
@@ -124,17 +67,7 @@ export declare function hslToHsb(hsl: HslColor): HsbColor;
  */
 export declare function parseColor(input: string): HsbColor | null;
 /**
- * Serialises the canonical {@link HsbColor} back to a string in `format`.
- *
- * Alpha appears **only when it is not 1** — `#ff0000` rather than `#ff0000ff`,
- * `rgb(…)` rather than `rgba(…, 1)` — because that is what every consumer's
- * stylesheet, design tool and clipboard expects, and appending a redundant
- * `ff` to every hex is the fastest way to make a picker's output look wrong.
- * Pass `alpha: false` to drop it unconditionally, for a picker that does not
- * offer transparency at all.
- *
- * `parseColor(formatColor(c, f))` returns `c` to within the precision `f` can
- * carry: exact for `'hsb'`, and 8-bit-quantised for `'hex'` and `'rgb'`.
+ * Serialises the canonical {@link HsbColor} back to a string in `format`, omitting alpha only when it equals 1 unless `alpha: false` forces it off; round-trips through {@link parseColor} to the precision `format` can carry.
  *
  * @example
  * ```ts

package/dist/utils/color.d.ts

@@ -1,20 +1,3 @@
-/**
- * Colour maths for pickers, swatches and contrast checks — parsing, the four
- * model conversions, and serialisation back to a string.
- *
- * Deliberately dependency-free and Vue-free: it is imported by
- * `SkdxColorPicker`, but nothing here knows what a component is, so it can be
- * unit-tested as plain arithmetic and reused by a Node-side token pipeline.
- * Mirrors `packages/react/src/utils/color.ts` exactly — a behavioural
- * difference between the two is a bug in one of them.
- *
- * **HSB is the canonical model** for anything that stores a colour over time.
- * RGB and hex cannot represent the hue of a black or a white — every fully
- * dark colour is `#000000` regardless of which hue it came from — so a picker
- * that round-trips through RGB on every drag loses the user's hue the moment
- * they drag brightness to zero. Convert to RGB/hex at the edges, not in the
- * middle.
- */
 /** sRGB colour: `r`/`g`/`b` in `0–255`, `a` in `0–1`. */
 export interface RgbColor {
     r: number;
@@ -29,30 +12,17 @@ export interface HslColor {
     l: number;
     a: number;
 }
-/**
- * HSB (a.k.a. HSV) colour: `h` in `0–360` degrees, `s` (saturation) and `b`
- * (brightness) in `0–100` percent, `a` in `0–1`.
- *
- * Note `b` is **brightness**, not blue — the field names follow the model's
- * own initials, the way `RgbColor.b` follows RGB's.
- */
+/** HSB (a.k.a. HSV) colour: `h` in `0–360` degrees, `s`/`b` in `0–100` percent, `a` in `0–1`; `b` is brightness, not blue. */
 export interface HsbColor {
     h: number;
     s: number;
     b: number;
     a: number;
 }
-/**
- * Serialisation targets for {@link formatColor}. `'hsb'` is this library's own
- * notation (`hsb(210, 60%, 85%)`) rather than a CSS colour — CSS has no HSB
- * function — so it round-trips through {@link parseColor} but must not be
- * dropped into a stylesheet.
- */
+/** Serialisation targets for {@link formatColor}; `'hsb'` is this library's own notation, not CSS, so it round-trips through {@link parseColor} but must not go in a stylesheet. */
 export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'hsb';
 /**
- * Serialises an sRGB colour as `#rrggbb`, or `#rrggbbaa` when `includeAlpha`
- * is set. Channels are clamped and rounded, so a computed colour with
- * `r: 255.4` still produces valid hex rather than `#ff.6…`.
+ * Serialises an sRGB colour as `#rrggbb`, or `#rrggbbaa` when `includeAlpha` is set, clamping and rounding channels so a computed colour with `r: 255.4` still produces valid hex.
  *
  * @example
  * ```ts
@@ -62,9 +32,7 @@ export type ColorFormat = 'hex' | 'rgb' | 'hsl' | 'hsb';
  */
 export declare function rgbToHex(rgb: RgbColor, includeAlpha?: boolean): string;
 /**
- * Parses `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` (leading `#` optional,
- * case-insensitive) into sRGB. Returns `null` for anything else — including
- * 5- and 7-digit strings, which look like hex but are not a colour.
+ * Parses `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` into sRGB, returning `null` for anything else, including 5- and 7-digit strings that look like hex but aren't a colour.
  *
  * @example
  * ```ts
@@ -74,11 +42,7 @@ export declare function rgbToHex(rgb: RgbColor, includeAlpha?: boolean): string;
  * ```
  */
 export declare function hexToRgb(hex: string): RgbColor | null;
-/**
- * sRGB → HSB. A greyscale colour reports hue `0`, because it genuinely has
- * none — see the module note on why that makes HSB, not RGB, the model to
- * store.
- */
+/** sRGB → HSB. A greyscale colour reports hue `0`, because it genuinely has none. */
 export declare function rgbToHsb(rgb: RgbColor): HsbColor;
 /** HSB → sRGB. */
 export declare function hsbToRgb(hsb: HsbColor): RgbColor;
@@ -86,33 +50,12 @@ export declare function hsbToRgb(hsb: HsbColor): RgbColor;
 export declare function rgbToHsl(rgb: RgbColor): HslColor;
 /** HSL → sRGB. */
 export declare function hslToRgb(hsl: HslColor): RgbColor;
-/**
- * HSB → HSL, computed directly rather than via RGB. The detour would quantise
- * to 8 bits and flatten the hue of any near-black colour, which is exactly the
- * loss this module exists to avoid.
- */
+/** HSB → HSL, computed directly rather than via RGB, since the detour would quantise to 8 bits and flatten near-black hues. */
 export declare function hsbToHsl(hsb: HsbColor): HslColor;
 /** HSL → HSB, the exact inverse of {@link hsbToHsl}, also without an RGB detour. */
 export declare function hslToHsb(hsl: HslColor): HsbColor;
 /**
- * Parses a colour string into the canonical {@link HsbColor}, returning
- * **`null` rather than throwing** for anything it does not understand — this
- * is fed by user-typed text and by whatever a consumer passes as `value`, so
- * "unparseable" is a normal outcome, not an exception.
- *
- * Tolerant about *formatting*, not about vocabulary. It accepts:
- *
- * - hex, with or without `#`, in 3/4/6/8 digits;
- * - `rgb()` / `rgba()`, with numeric or `%` channels;
- * - `hsl()` / `hsla()`, with or without the `%` on saturation/lightness and
- *   with or without `deg` on the hue;
- * - `hsb()` / `hsba()` / `hsv()` / `hsva()`, this library's own notation;
- * - comma-separated *or* space-separated arguments, with the modern
- *   `rgb(255 0 0 / 50%)` slash-alpha form.
- *
- * It does **not** know named colours (`red`, `transparent`), `color()`,
- * `lab()`/`oklch()`, or `turn`/`rad` hue units. Those all return `null`; a
- * 148-entry name table is a dependency's job, not a picker's.
+ * Parses a colour string (hex, `rgb()`, `hsl()`, or this library's own `hsb()`) into the canonical {@link HsbColor}, returning `null` rather than throwing for anything unrecognized, including named colours.
  *
  * @example
  * ```ts
@@ -124,17 +67,7 @@ export declare function hslToHsb(hsl: HslColor): HsbColor;
  */
 export declare function parseColor(input: string): HsbColor | null;
 /**
- * Serialises the canonical {@link HsbColor} back to a string in `format`.
- *
- * Alpha appears **only when it is not 1** — `#ff0000` rather than `#ff0000ff`,
- * `rgb(…)` rather than `rgba(…, 1)` — because that is what every consumer's
- * stylesheet, design tool and clipboard expects, and appending a redundant
- * `ff` to every hex is the fastest way to make a picker's output look wrong.
- * Pass `alpha: false` to drop it unconditionally, for a picker that does not
- * offer transparency at all.
- *
- * `parseColor(formatColor(c, f))` returns `c` to within the precision `f` can
- * carry: exact for `'hsb'`, and 8-bit-quantised for `'hex'` and `'rgb'`.
+ * Serialises the canonical {@link HsbColor} back to a string in `format`, omitting alpha only when it equals 1 unless `alpha: false` forces it off; round-trips through {@link parseColor} to the precision `format` can carry.
  *
  * @example
  * ```ts

package/dist/utils/color.js

@@ -1 +1 @@
-import{clamp as n}from"./clamp.js";function t(n,t=0){const r=10**t;return Math.round(n*r)/r}function r(n){return(n%360+360)%360}function s(t){return n(Math.round(t),0,255).toString(16).padStart(2,"0")}function u(n,t,s,u,e){return e?r(60*(u===n?(t-s)/e:u===t?(s-n)/e+2:(n-t)/e+4)):0}function e(n,s,u,e,l){const a=Math.floor(r(n)/60)%6,[o,c,i]=[[s,u,0],[u,s,0],[0,s,u],[0,u,s],[u,0,s],[s,0,u]][a]??[0,0,0];return{r:t(255*(o+e)),g:t(255*(c+e)),b:t(255*(i+e)),a:l}}function l(t,r=!1){const u=`#${s(t.r)}${s(t.g)}${s(t.b)}`;return r?`${u}${s(255*n(t.a,0,1))}`:u}var a=/^#?([\da-f]{3,8})$/i;function o(n){const r=a.exec(n.trim());if(!r)return null;let s=r[1];if((3===s.length||4===s.length)&&(s=s.split("").map(n=>n+n).join("")),6!==s.length&&8!==s.length)return null;const u=n=>parseInt(s.slice(n,n+2),16);return{r:u(0),g:u(2),b:u(4),a:8===s.length?t(u(6)/255,3):1}}function c(t){const r=n(t.r,0,255)/255,s=n(t.g,0,255)/255,e=n(t.b,0,255)/255,l=Math.max(r,s,e),a=l-Math.min(r,s,e);return{h:u(r,s,e,l,a),s:l?a/l*100:0,b:100*l,a:n(t.a,0,1)}}function i(t){const s=r(t.h),u=n(t.s,0,100)/100,l=n(t.b,0,100)/100,a=l*u;return e(s,a,a*(1-Math.abs(s/60%2-1)),l-a,n(t.a,0,1))}function h(t){const r=n(t.r,0,255)/255,s=n(t.g,0,255)/255,e=n(t.b,0,255)/255,l=Math.max(r,s,e),a=Math.min(r,s,e),o=l-a,c=(l+a)/2,i=o?o/(1-Math.abs(2*c-1)):0;return{h:u(r,s,e,l,o),s:n(100*i,0,100),l:100*c,a:n(t.a,0,1)}}function b(t){const s=r(t.h),u=n(t.s,0,100)/100,l=n(t.l,0,100)/100,a=(1-Math.abs(2*l-1))*u;return e(s,a,a*(1-Math.abs(s/60%2-1)),l-a/2,n(t.a,0,1))}function f(t){const s=n(t.s,0,100)/100,u=n(t.b,0,100)/100,e=u*(1-s/2),l=Math.min(e,1-e);return{h:r(t.h),s:l?(u-e)/l*100:0,l:100*e,a:n(t.a,0,1)}}function $(t){const s=n(t.s,0,100)/100,u=n(t.l,0,100)/100,e=u+s*Math.min(u,1-u);return{h:r(t.h),s:e?2*(1-u/e)*100:0,b:100*e,a:n(t.a,0,1)}}var g=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function m(n){if(void 0===n)return null;const t=n.endsWith("%"),r=t?n.slice(0,-1):n.replace(/deg$/,"");if(""===r.trim())return null;const s=Number(r);return Number.isFinite(s)?{value:s,percent:t}:null}function p(n){const t=m(n);return t&&(t.percent?t.value/100*255:t.value)}function M(n){const t=m(n);return t&&t.value}function v(s){return{h:t(r(s.h),2),s:t(n(s.s,0,100),2),b:t(n(s.b,0,100),2),a:t(n(s.a,0,1),3)}}function d(n){if("string"!=typeof n)return null;const t=n.trim().toLowerCase();if(!t)return null;const r=g.exec(t);if(!r){const n=o(t);return n?v(c(n)):null}const s=r[1].replace(/a$/,""),u=r[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);if(3!==u.length&&4!==u.length)return null;const e=function(n){if(void 0===n)return 1;const t=m(n);return t&&(t.percent?t.value/100:t.value)}(u[3]);if(null===e)return null;if("rgb"===s){const n=p(u[0]),t=p(u[1]),r=p(u[2]);return null===n||null===t||null===r?null:v(c({r:n,g:t,b:r,a:e}))}const l=M(u[0]),a=M(u[1]),i=M(u[2]);return null===l||null===a||null===i?null:v("hsl"===s?$({h:l,s:a,l:i,a:e}):{h:l,s:a,b:i,a:e})}function T(s,u,e=!0){const a=t(n(s.a,0,1),3),o=e&&a<1;if("rgb"===u){const{r:n,g:t,b:r}=i(s);return o?`rgba(${n}, ${t}, ${r}, ${a})`:`rgb(${n}, ${t}, ${r})`}if("hsl"===u){const n=f(s),r=t(n.h),u=t(n.s),e=t(n.l);return o?`hsla(${r}, ${u}%, ${e}%, ${a})`:`hsl(${r}, ${u}%, ${e}%)`}if("hsb"===u){const u=t(r(s.h)),e=t(n(s.s,0,100)),l=t(n(s.b,0,100));return o?`hsba(${u}, ${e}%, ${l}%, ${a})`:`hsb(${u}, ${e}%, ${l}%)`}return l(i(s),o)}export{T as formatColor,o as hexToRgb,f as hsbToHsl,i as hsbToRgb,$ as hslToHsb,b as hslToRgb,d as parseColor,l as rgbToHex,c as rgbToHsb,h as rgbToHsl};
+function n(n,t,r){return Math.min(Math.max(n,t),r)}function t(n,t=0){const r=10**t;return Math.round(n*r)/r}function r(n){return(n%360+360)%360}function u(t){return n(Math.round(t),0,255).toString(16).padStart(2,"0")}function e(n,t,u,e,s){if(!s)return 0;let l;return l=e===n?(t-u)/s:e===t?(u-n)/s+2:(n-t)/s+4,r(60*l)}function s(n,u,e,s,l){const a=Math.floor(r(n)/60)%6,[o,c,i]=[[u,e,0],[e,u,0],[0,u,e],[0,e,u],[e,0,u],[u,0,e]][a]??[0,0,0];return{r:t(255*(o+s)),g:t(255*(c+s)),b:t(255*(i+s)),a:l}}function l(t,r=!1){const e=`#${u(t.r)}${u(t.g)}${u(t.b)}`;return r?`${e}${u(255*n(t.a,0,1))}`:e}var a=/^#?([\da-f]{3,8})$/i;function o(n){const r=a.exec(n.trim());if(!r)return null;let u=r[1];if((3===u.length||4===u.length)&&(u=u.split("").map(n=>n+n).join("")),6!==u.length&&8!==u.length)return null;const e=n=>parseInt(u.slice(n,n+2),16);return{r:e(0),g:e(2),b:e(4),a:8===u.length?t(e(6)/255,3):1}}function c(t){const r=n(t.r,0,255)/255,u=n(t.g,0,255)/255,s=n(t.b,0,255)/255,l=Math.max(r,u,s),a=l-Math.min(r,u,s);return{h:e(r,u,s,l,a),s:l?a/l*100:0,b:100*l,a:n(t.a,0,1)}}function i(t){const u=r(t.h),e=n(t.s,0,100)/100,l=n(t.b,0,100)/100,a=l*e;return s(u,a,a*(1-Math.abs(u/60%2-1)),l-a,n(t.a,0,1))}function h(t){const r=n(t.r,0,255)/255,u=n(t.g,0,255)/255,s=n(t.b,0,255)/255,l=Math.max(r,u,s),a=Math.min(r,u,s),o=l-a,c=(l+a)/2,i=o?o/(1-Math.abs(2*c-1)):0;return{h:e(r,u,s,l,o),s:n(100*i,0,100),l:100*c,a:n(t.a,0,1)}}function f(t){const u=r(t.h),e=n(t.s,0,100)/100,l=n(t.l,0,100)/100,a=(1-Math.abs(2*l-1))*e;return s(u,a,a*(1-Math.abs(u/60%2-1)),l-a/2,n(t.a,0,1))}function b(t){const u=n(t.s,0,100)/100,e=n(t.b,0,100)/100,s=e*(1-u/2),l=Math.min(s,1-s);return{h:r(t.h),s:l?(e-s)/l*100:0,l:100*s,a:n(t.a,0,1)}}function $(t){const u=n(t.s,0,100)/100,e=n(t.l,0,100)/100,s=e+u*Math.min(e,1-e);return{h:r(t.h),s:s?2*(1-e/s)*100:0,b:100*s,a:n(t.a,0,1)}}var g=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function m(n){if(void 0===n)return null;const t=n.endsWith("%"),r=t?n.slice(0,-1):n.replace(/deg$/,"");if(""===r.trim())return null;const u=Number(r);return Number.isFinite(u)?{value:u,percent:t}:null}function M(n){const t=m(n);return t&&(t.percent?t.value/100*255:t.value)}function p(n){const t=m(n);return t&&t.value}function v(u){return{h:t(r(u.h),2),s:t(n(u.s,0,100),2),b:t(n(u.b,0,100),2),a:t(n(u.a,0,1),3)}}function d(n){if("string"!=typeof n)return null;const t=n.trim().toLowerCase();if(!t)return null;const r=g.exec(t);if(!r){const n=o(t);return n?v(c(n)):null}const u=r[1].replace(/a$/,""),e=r[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);return 3!==e.length&&4!==e.length?null:function(n,t){const r=function(n){if(void 0===n)return 1;const t=m(n);return t&&(t.percent?t.value/100:t.value)}(t[3]);if(null===r)return null;if("rgb"===n){const n=M(t[0]),u=M(t[1]),e=M(t[2]);return null===n||null===u||null===e?null:v(c({r:n,g:u,b:e,a:r}))}const u=p(t[0]),e=p(t[1]),s=p(t[2]);return null===u||null===e||null===s?null:v("hsl"===n?$({h:u,s:e,l:s,a:r}):{h:u,s:e,b:s,a:r})}(u,e)}function x(u,e,s=!0){const a=t(n(u.a,0,1),3),o=s&&a<1;if("rgb"===e){const{r:n,g:t,b:r}=i(u);return o?`rgba(${n}, ${t}, ${r}, ${a})`:`rgb(${n}, ${t}, ${r})`}if("hsl"===e){const n=b(u),r=t(n.h),e=t(n.s),s=t(n.l);return o?`hsla(${r}, ${e}%, ${s}%, ${a})`:`hsl(${r}, ${e}%, ${s}%)`}if("hsb"===e){const e=t(r(u.h)),s=t(n(u.s,0,100)),l=t(n(u.b,0,100));return o?`hsba(${e}, ${s}%, ${l}%, ${a})`:`hsb(${e}, ${s}%, ${l}%)`}return l(i(u),o)}export{x as formatColor,o as hexToRgb,b as hsbToHsl,i as hsbToRgb,$ as hslToHsb,f as hslToRgb,d as parseColor,l as rgbToHex,c as rgbToHsb,h as rgbToHsl};

package/dist/utils/composeRefs.d.cts

@@ -1,34 +1,11 @@
 import type { ComponentPublicInstance, Ref } from 'vue';
-/**
- * Anything a composed template ref is willing to write an element into: a Vue
- * `ref`, a plain setter function (for context state that isn't a `ref`), or
- * nothing at all, so call sites can pass an optional target unconditionally.
- */
+/** Anything a composed template ref can write into: a Vue `ref`, a plain setter, or nothing at all. */
 export type PossibleRef<T> = Ref<T | null> | ((node: T | null) => void) | null | undefined;
 /** The value Vue hands to a function template ref on mount and on unmount. */
 export type TemplateRefValue = Element | ComponentPublicInstance | null;
 /**
- * Merges any number of refs into a single **function template ref**, the Vue
- * counterpart of this package's React `composeRefs`. Bind the result with
- * `:ref="..."` wherever a component both keeps its own ref on a node and has
- * to publish that node somewhere else — a parent's context, most often.
- *
- * The point is *when* the write happens. Vue invokes a function template ref
- * synchronously from inside the patch that mounts the element, and again with
- * `null` from inside the patch that unmounts it, exactly like React committing
- * a callback ref. Publishing through a `watchEffect` instead costs a full tick
- * (the effect is a pre-flush job, so it lands on the flush *after* the ref is
- * assigned), which is long enough for a keyboard handler on an already-open
- * popup to read an empty context ref and no-op. The unmount half matters just
- * as much: a component's effect scope is stopped *before* its subtree is
- * unmounted, so a watcher never observes the ref going back to `null` and the
- * context is left holding a detached element.
- *
- * Targets are written in the order given, which matters only for a setter that
- * compares against another target's previous value — list it first.
- *
- * Refs are only ever invoked on the client — Vue does not set template refs
- * while server-rendering — so this stays SSR-safe.
+ * Merges any number of refs into a single function template ref, written
+ * synchronously on mount/unmount — unlike a `watchEffect`, which lands a tick late.
  *
  * @example
  * ```ts

package/dist/utils/composeRefs.d.ts

@@ -1,34 +1,11 @@
 import type { ComponentPublicInstance, Ref } from 'vue';
-/**
- * Anything a composed template ref is willing to write an element into: a Vue
- * `ref`, a plain setter function (for context state that isn't a `ref`), or
- * nothing at all, so call sites can pass an optional target unconditionally.
- */
+/** Anything a composed template ref can write into: a Vue `ref`, a plain setter, or nothing at all. */
 export type PossibleRef<T> = Ref<T | null> | ((node: T | null) => void) | null | undefined;
 /** The value Vue hands to a function template ref on mount and on unmount. */
 export type TemplateRefValue = Element | ComponentPublicInstance | null;
 /**
- * Merges any number of refs into a single **function template ref**, the Vue
- * counterpart of this package's React `composeRefs`. Bind the result with
- * `:ref="..."` wherever a component both keeps its own ref on a node and has
- * to publish that node somewhere else — a parent's context, most often.
- *
- * The point is *when* the write happens. Vue invokes a function template ref
- * synchronously from inside the patch that mounts the element, and again with
- * `null` from inside the patch that unmounts it, exactly like React committing
- * a callback ref. Publishing through a `watchEffect` instead costs a full tick
- * (the effect is a pre-flush job, so it lands on the flush *after* the ref is
- * assigned), which is long enough for a keyboard handler on an already-open
- * popup to read an empty context ref and no-op. The unmount half matters just
- * as much: a component's effect scope is stopped *before* its subtree is
- * unmounted, so a watcher never observes the ref going back to `null` and the
- * context is left holding a detached element.
- *
- * Targets are written in the order given, which matters only for a setter that
- * compares against another target's previous value — list it first.
- *
- * Refs are only ever invoked on the client — Vue does not set template refs
- * while server-rendering — so this stays SSR-safe.
+ * Merges any number of refs into a single function template ref, written
+ * synchronously on mount/unmount — unlike a `watchEffect`, which lands a tick late.
  *
  * @example
  * ```ts

package/dist/utils/controllable.cjs

@@ -0,0 +1 @@
+const u=require("./selection.cjs");function n(e,r){return Object.is(e,r)?!0:!Array.isArray(e)||!Array.isArray(r)||!e.every(t=>typeof t=="string")||!r.every(t=>typeof t=="string")?!1:u.sameSelection(e,r)}function i({controlled:e,uncontrolled:r}){return e!==void 0?e:r}function l({controlled:e}){return e!==void 0}function o(e,r){const t=i(e);return n(t,r)?{value:t,write:!1,emit:!1}:{value:r,write:!l(e),emit:!0}}function s(e,r){return o(e,r)}exports.controllableValue=i;exports.decideControllable=o;exports.decideReset=s;exports.isControlled=l;exports.sameControlledValue=n;

package/dist/utils/controllable.d.cts

@@ -0,0 +1,42 @@
+/**
+ * Whether two values are indistinguishable to a consumer, so no event is owed: `Object.is` for scalars, element-wise for the string arrays a selection carries.
+ *
+ * @param a the value now
+ * @param b the value proposed
+ */
+export declare function sameControlledValue(a: unknown, b: unknown): boolean;
+/** What the adapter currently holds on both sides of the controlled/uncontrolled split. */
+export interface ControllableState<T> {
+    /** The consumer's controlled value; `undefined` means the control owns its own value. */
+    controlled: T | undefined;
+    /** The value the adapter holds while uncontrolled; ignored once `controlled` is defined. */
+    uncontrolled: T | undefined;
+}
+/** What the adapter should do about a proposed change. */
+export interface ControllableDecision<T> {
+    /** The value in force after this decision — the proposal, or the current value when nothing changed. */
+    value: T | undefined;
+    /** Whether the adapter writes its own state; always `false` while controlled, since the consumer owns the value. */
+    write: boolean;
+    /** Whether the change event fires; only on an actual change, in both modes. */
+    emit: boolean;
+}
+/** The value in force: the controlled one when there is one, the adapter's own otherwise. */
+export declare function controllableValue<T>({ controlled, uncontrolled, }: ControllableState<T>): T | undefined;
+/** Whether the consumer owns the value, which is exactly "a controlled value was supplied". */
+export declare function isControlled<T>({ controlled }: ControllableState<T>): boolean;
+/**
+ * The decision for one proposed change.
+ *
+ * @param state what the adapter holds on both sides
+ * @param next the proposed value
+ * @returns the value in force, whether to write it, and whether to emit
+ */
+export declare function decideControllable<T>(state: ControllableState<T>, next: T | undefined): ControllableDecision<T>;
+/**
+ * The decision for a form reset, which restores `defaultValue` as it reads *now* — a consumer that changed the prop after mount expects the new default back, not the one the control was born with.
+ *
+ * @param state what the adapter holds on both sides
+ * @param liveDefault the `defaultValue` prop read at reset time
+ */
+export declare function decideReset<T>(state: ControllableState<T>, liveDefault: T | undefined): ControllableDecision<T>;

package/dist/utils/controllable.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Whether two values are indistinguishable to a consumer, so no event is owed: `Object.is` for scalars, element-wise for the string arrays a selection carries.
+ *
+ * @param a the value now
+ * @param b the value proposed
+ */
+export declare function sameControlledValue(a: unknown, b: unknown): boolean;
+/** What the adapter currently holds on both sides of the controlled/uncontrolled split. */
+export interface ControllableState<T> {
+    /** The consumer's controlled value; `undefined` means the control owns its own value. */
+    controlled: T | undefined;
+    /** The value the adapter holds while uncontrolled; ignored once `controlled` is defined. */
+    uncontrolled: T | undefined;
+}
+/** What the adapter should do about a proposed change. */
+export interface ControllableDecision<T> {
+    /** The value in force after this decision — the proposal, or the current value when nothing changed. */
+    value: T | undefined;
+    /** Whether the adapter writes its own state; always `false` while controlled, since the consumer owns the value. */
+    write: boolean;
+    /** Whether the change event fires; only on an actual change, in both modes. */
+    emit: boolean;
+}
+/** The value in force: the controlled one when there is one, the adapter's own otherwise. */
+export declare function controllableValue<T>({ controlled, uncontrolled, }: ControllableState<T>): T | undefined;
+/** Whether the consumer owns the value, which is exactly "a controlled value was supplied". */
+export declare function isControlled<T>({ controlled }: ControllableState<T>): boolean;
+/**
+ * The decision for one proposed change.
+ *
+ * @param state what the adapter holds on both sides
+ * @param next the proposed value
+ * @returns the value in force, whether to write it, and whether to emit
+ */
+export declare function decideControllable<T>(state: ControllableState<T>, next: T | undefined): ControllableDecision<T>;
+/**
+ * The decision for a form reset, which restores `defaultValue` as it reads *now* — a consumer that changed the prop after mount expects the new default back, not the one the control was born with.
+ *
+ * @param state what the adapter holds on both sides
+ * @param liveDefault the `defaultValue` prop read at reset time
+ */
+export declare function decideReset<T>(state: ControllableState<T>, liveDefault: T | undefined): ControllableDecision<T>;

package/dist/utils/controllable.js

@@ -0,0 +1 @@
+import{sameSelection as e}from"./selection.js";function r(r,t){return!!Object.is(r,t)||!!(Array.isArray(r)&&Array.isArray(t)&&r.every(e=>"string"==typeof e)&&t.every(e=>"string"==typeof e))&&e(r,t)}function t({controlled:e,uncontrolled:r}){return void 0!==e?e:r}function o({controlled:e}){return void 0!==e}function n(e,n){const i=t(e);return r(i,n)?{value:i,write:!1,emit:!1}:{value:n,write:!o(e),emit:!0}}function i(e,r){return n(e,r)}export{t as controllableValue,n as decideControllable,i as decideReset,o as isControlled,r as sameControlledValue};

package/dist/utils/date-segments.cjs

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