@skdx/react 0.27.0 → 0.29.0

package/dist/utils/announcer.d.ts

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

package/dist/utils/announcer.js

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

package/dist/utils/appearance.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var p=(n,e)=>{for(var r in e)s(n,r,{get:e[r],enumerable:!0})},l=(n,e,r,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of u(e))!d.call(n,t)&&t!==r&&s(n,t,{get:()=>e[t],enumerable:!(a=c(e,t))||a.enumerable});return n};var f=n=>l(s({},"__esModule",{value:!0}),n);var A={};p(A,{appearanceAttrs:()=>g});module.exports=f(A);function g(n,e={}){let r={};for(let a of Object.keys(n)){let t=`data-${a.replace(/[A-Z]/g,i=>`-${i.toLowerCase()}`)}`,o=n[a]??e[t];o==null||o===!1?r[t]=void 0:r[t]=o===!0?"":String(o)}return r}0&&(module.exports={appearanceAttrs});

package/dist/utils/appearance.d.cts

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

package/dist/utils/appearance.d.ts

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

package/dist/utils/appearance.js

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

package/dist/utils/arrow-keys.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var i=(e,t)=>{for(var n in t)o(e,n,{get:t[n],enumerable:!0})},E=(e,t,n,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of s(t))!a.call(e,r)&&r!==n&&o(e,r,{get:()=>t[r],enumerable:!(l=u(t,r))||l.enumerable});return e};var b=e=>E(o({},"__esModule",{value:!0}),e);var T={};i(T,{arrowKeyBelongsToDescendant:()=>A});module.exports=b(T);var c=new Set(["textbox","searchbox","listbox","slider","spinbutton","menu","menubar","tablist","grid","treegrid","tree","combobox","radiogroup"]),f=new Set(["INPUT","SELECT","TEXTAREA","AUDIO","VIDEO"]);function m(e){if(f.has(e.tagName)||e.isContentEditable)return!0;let t=e.getAttribute("role");return t!==null&&c.has(t)}function A(e,t){if(!(e instanceof Element))return!1;let n=e;for(;n!==null&&n!==t;){if(m(n))return!0;n=n.parentElement}return!1}0&&(module.exports={arrowKeyBelongsToDescendant});

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

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

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

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

package/dist/utils/arrow-keys.js

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

package/dist/utils/calendar-locale.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var s=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var y=(e,t)=>{for(var n in t)s(e,n,{get:t[n],enumerable:!0})},d=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of h(t))!p.call(e,o)&&o!==n&&s(e,o,{get:()=>t[o],enumerable:!(r=D(t,o))||r.enumerable});return e};var w=e=>d(s({},"__esModule",{value:!0}),e);var F={};y(F,{clearLocaleNameCache:()=>k,formatDateLabel:()=>W,formatMonthLabel:()=>L,formatYear:()=>m,formatYearRange:()=>N,getLocaleWeekStartsOn:()=>I,getMonthNames:()=>b,getWeekDayNames:()=>x,resolveLocale:()=>a});module.exports=w(F);var c=new Date(2024,0,7),g=new Map;function u(e,t){let n=g.get(e);if(n)return n;let r=t();return g.set(e,r),r}function a(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function b(e,t="long"){let n=a(e);return u(`m|${n}|${t}`,()=>{let r=new Intl.DateTimeFormat(n,{month:t,timeZone:"UTC"});return Array.from({length:12},(o,i)=>r.format(Date.UTC(2024,i,15)))})}function x(e,t=0,n="short"){let r=a(e),o=u(`w|${r}|${n}`,()=>{let l=new Intl.DateTimeFormat(r,{weekday:n});return Array.from({length:7},($,f)=>l.format(new Date(c.getFullYear(),c.getMonth(),c.getDate()+f)))}),i=(t%7+7)%7;return o.slice(i).concat(o.slice(0,i))}function I(e){try{let t=new Intl.Locale(a(e)),n=(t.getWeekInfo?.()??t.weekInfo)?.firstDay;if(typeof n=="number")return n%7}catch{}return 0}function L(e,t){return e.toLocaleDateString(a(t),{month:"long",year:"numeric"})}function m(e,t){return new Intl.NumberFormat(a(t),{useGrouping:!1}).format(e)}function N(e,t,n){return`${m(e,n)} \u2013 ${m(t,n)}`}function W(e,t){return e.toLocaleDateString(a(t),{weekday:"long",year:"numeric",month:"long",day:"numeric"})}function k(){g.clear()}0&&(module.exports={clearLocaleNameCache,formatDateLabel,formatMonthLabel,formatYear,formatYearRange,getLocaleWeekStartsOn,getMonthNames,getWeekDayNames,resolveLocale});

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

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

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

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

package/dist/utils/calendar-locale.js

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

package/dist/utils/cardNesting.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var u=Object.create;var c=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var h=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var g=(e,t)=>{for(var n in t)c(e,n,{get:t[n],enumerable:!0})},l=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of R(t))!p.call(e,o)&&o!==n&&c(e,o,{get:()=>t[o],enumerable:!(r=m(t,o))||r.enumerable});return e};var C=(e,t,n)=>(n=e!=null?u(h(e)):{},l(t||!e||!e.__esModule?c(n,"default",{value:e,enumerable:!0}):n,e)),E=e=>l(c({},"__esModule",{value:!0}),e);var L={};g(L,{useCardNestingWarning:()=>T});module.exports=E(L);var i=C(require("react"),1),d=require("./dev-mode.cjs"),f=require("./tabbable.cjs"),b='input[type="checkbox"], input[type="radio"]';function T(e,t){let n=i.useRef("");i.useEffect(()=>{let r=t.current;if(!r)return;let o=Array.from(r.querySelectorAll(f.TABBABLE_SELECTOR)).filter(a=>!a.matches(b)),s=o.map(a=>a.localName).join(",");s!==n.current&&(n.current=s,o.length!==0&&(0,d.isDevMode)()&&console.warn(`[skdx] ${e}: found ${o.length} focusable element(s) nested inside the card \u2014 ${o.map(a=>`<${a.localName}>`).join(", ")}. The card root is a <label>, so clicking one of these also toggles the card, and a <label> may not contain interactive content. Put actions beside the card, never inside it.`))})}0&&(module.exports={useCardNestingWarning});

package/dist/utils/cardNesting.d.cts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+/**
+ * @internal Warns in dev when a card root contains a focusable descendant that is not its own Control.
+ * @param family the card family's name, so the message says which card is wrong
+ * @param rootRef the card root `<label>`
+ */
+export declare function useCardNestingWarning(family: 'CheckboxCard' | 'RadioCard', rootRef: React.RefObject<HTMLElement | null>): void;

package/dist/utils/cardNesting.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+/**
+ * @internal Warns in dev when a card root contains a focusable descendant that is not its own Control.
+ * @param family the card family's name, so the message says which card is wrong
+ * @param rootRef the card root `<label>`
+ */
+export declare function useCardNestingWarning(family: 'CheckboxCard' | 'RadioCard', rootRef: React.RefObject<HTMLElement | null>): void;

package/dist/utils/cardNesting.js

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

package/dist/utils/clamp.cjs

@@ -1 +1,2 @@
-"use strict";var t=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var h=(m,n)=>{for(var r in n)t(m,r,{get:n[r],enumerable:!0})},i=(m,n,r,u)=>{if(n&&typeof n=="object"||typeof n=="function")for(let e of b(n))!c.call(m,e)&&e!==r&&t(m,e,{get:()=>n[e],enumerable:!(u=a(n,e))||u.enumerable});return m};var o=m=>i(t({},"__esModule",{value:!0}),m);var x={};h(x,{clamp:()=>p});module.exports=o(x);function p(m,n,r){return Math.min(Math.max(m,n),r)}0&&(module.exports={clamp});
+'use client';
+"use strict";var u=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var h=(m,n)=>{for(var r in n)u(m,r,{get:n[r],enumerable:!0})},i=(m,n,r,t)=>{if(n&&typeof n=="object"||typeof n=="function")for(let e of b(n))!c.call(m,e)&&e!==r&&u(m,e,{get:()=>n[e],enumerable:!(t=a(n,e))||t.enumerable});return m};var o=m=>i(u({},"__esModule",{value:!0}),m);var x={};h(x,{clamp:()=>p});module.exports=o(x);function p(m,n,r){return Math.min(Math.max(m,n),r)}0&&(module.exports={clamp});

package/dist/utils/clamp.js

@@ -1 +1,2 @@
+'use client';
 function e(n,m,r){return Math.min(Math.max(n,m),r)}export{e as clamp};

package/dist/utils/color.cjs

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

package/dist/utils/color.d.cts

@@ -1,18 +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 React-free: it is imported by
- * `ColorPicker`, 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.
- *
- * **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;
@@ -27,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
@@ -60,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
@@ -72,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;
@@ -84,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
@@ -122,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,18 +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 React-free: it is imported by
- * `ColorPicker`, 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.
- *
- * **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;
@@ -27,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
@@ -60,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
@@ -72,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;
@@ -84,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
@@ -122,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,2 @@
-import{clamp as s}from"./clamp.js";function a(n,r=0){let t=10**r;return Math.round(n*t)/t}function i(n){return(n%360+360)%360}function m(n){return s(Math.round(n),0,255).toString(16).padStart(2,"0")}function M(n,r,t,o,e){if(!e)return 0;let u=o===n?(r-t)/e:o===r?(t-n)/e+2:(n-r)/e+4;return i(u*60)}function R(n,r,t,o,e){let u=Math.floor(i(n)/60)%6,l=[[r,t,0],[t,r,0],[0,r,t],[0,t,r],[t,0,r],[r,0,t]],[c,b,f]=l[u]??[0,0,0];return{r:a((c+o)*255),g:a((b+o)*255),b:a((f+o)*255),a:e}}function T(n,r=!1){let t=`#${m(n.r)}${m(n.g)}${m(n.b)}`;return r?`${t}${m(s(n.a,0,1)*255)}`:t}var v=/^#?([\da-f]{3,8})$/i;function N(n){let r=v.exec(n.trim());if(!r)return null;let t=r[1];if((t.length===3||t.length===4)&&(t=t.split("").map(e=>e+e).join("")),t.length!==6&&t.length!==8)return null;let o=e=>parseInt(t.slice(e,e+2),16);return{r:o(0),g:o(2),b:o(4),a:t.length===8?a(o(6)/255,3):1}}function H(n){let r=s(n.r,0,255)/255,t=s(n.g,0,255)/255,o=s(n.b,0,255)/255,e=Math.max(r,t,o),u=e-Math.min(r,t,o);return{h:M(r,t,o,e,u),s:e?u/e*100:0,b:e*100,a:s(n.a,0,1)}}function x(n){let r=i(n.h),t=s(n.s,0,100)/100,o=s(n.b,0,100)/100,e=o*t,u=e*(1-Math.abs(r/60%2-1));return R(r,e,u,o-e,s(n.a,0,1))}function w(n){let r=s(n.r,0,255)/255,t=s(n.g,0,255)/255,o=s(n.b,0,255)/255,e=Math.max(r,t,o),u=Math.min(r,t,o),l=e-u,c=(e+u)/2,b=l?l/(1-Math.abs(2*c-1)):0;return{h:M(r,t,o,e,l),s:s(b*100,0,100),l:c*100,a:s(n.a,0,1)}}function z(n){let r=i(n.h),t=s(n.s,0,100)/100,o=s(n.l,0,100)/100,e=(1-Math.abs(2*o-1))*t,u=e*(1-Math.abs(r/60%2-1));return R(r,e,u,o-e/2,s(n.a,0,1))}function y(n){let r=s(n.s,0,100)/100,t=s(n.b,0,100)/100,o=t*(1-r/2),e=Math.min(o,1-o);return{h:i(n.h),s:e?(t-o)/e*100:0,l:o*100,a:s(n.a,0,1)}}function F(n){let r=s(n.s,0,100)/100,t=s(n.l,0,100)/100,o=t+r*Math.min(t,1-t);return{h:i(n.h),s:o?2*(1-t/o)*100:0,b:o*100,a:s(n.a,0,1)}}var O=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function $(n){if(n===void 0)return null;let r=n.endsWith("%"),t=r?n.slice(0,-1):n.replace(/deg$/,"");if(t.trim()==="")return null;let o=Number(t);return Number.isFinite(o)?{value:o,percent:r}:null}function g(n){let r=$(n);return r&&(r.percent?r.value/100*255:r.value)}function p(n){let r=$(n);return r&&r.value}function A(n){if(n===void 0)return 1;let r=$(n);return r&&(r.percent?r.value/100:r.value)}function h(n){return{h:a(i(n.h),2),s:a(s(n.s,0,100),2),b:a(s(n.b,0,100),2),a:a(s(n.a,0,1),3)}}function I(n){if(typeof n!="string")return null;let r=n.trim().toLowerCase();if(!r)return null;let t=O.exec(r);if(!t){let f=N(r);return f?h(H(f)):null}let o=t[1].replace(/a$/,""),e=t[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);if(e.length!==3&&e.length!==4)return null;let u=A(e[3]);if(u===null)return null;if(o==="rgb"){let f=g(e[0]),C=g(e[1]),d=g(e[2]);return f===null||C===null||d===null?null:h(H({r:f,g:C,b:d,a:u}))}let l=p(e[0]),c=p(e[1]),b=p(e[2]);return l===null||c===null||b===null?null:h(o==="hsl"?F({h:l,s:c,l:b,a:u}):{h:l,s:c,b,a:u})}function L(n,r,t=!0){let o=a(s(n.a,0,1),3),e=t&&o<1;if(r==="rgb"){let{r:u,g:l,b:c}=x(n);return e?`rgba(${u}, ${l}, ${c}, ${o})`:`rgb(${u}, ${l}, ${c})`}if(r==="hsl"){let u=y(n),l=a(u.h),c=a(u.s),b=a(u.l);return e?`hsla(${l}, ${c}%, ${b}%, ${o})`:`hsl(${l}, ${c}%, ${b}%)`}if(r==="hsb"){let u=a(i(n.h)),l=a(s(n.s,0,100)),c=a(s(n.b,0,100));return e?`hsba(${u}, ${l}%, ${c}%, ${o})`:`hsb(${u}, ${l}%, ${c}%)`}return T(x(n),e)}export{L as formatColor,N as hexToRgb,y as hsbToHsl,x as hsbToRgb,F as hslToHsb,z as hslToRgb,I as parseColor,T as rgbToHex,H as rgbToHsb,w as rgbToHsl};
+'use client';
+function s(n,r,t){return Math.min(Math.max(n,r),t)}function b(n,r=0){let t=10**r;return Math.round(n*t)/t}function i(n){return(n%360+360)%360}function m(n){return s(Math.round(n),0,255).toString(16).padStart(2,"0")}function $(n,r,t,e,o){if(!o)return 0;let u;return e===n?u=(r-t)/o:e===r?u=(t-n)/o+2:u=(n-r)/o+4,i(u*60)}function d(n,r,t,e,o){let u=Math.floor(i(n)/60)%6,l=[[r,t,0],[t,r,0],[0,r,t],[0,t,r],[t,0,r],[r,0,t]],[c,a,x]=l[u]??[0,0,0];return{r:b((c+e)*255),g:b((a+e)*255),b:b((x+e)*255),a:o}}function M(n,r=!1){let t=`#${m(n.r)}${m(n.g)}${m(n.b)}`;return r?`${t}${m(s(n.a,0,1)*255)}`:t}var R=/^#?([\da-f]{3,8})$/i;function T(n){let r=R.exec(n.trim());if(!r)return null;let t=r[1];if((t.length===3||t.length===4)&&(t=t.split("").map(o=>o+o).join("")),t.length!==6&&t.length!==8)return null;let e=o=>parseInt(t.slice(o,o+2),16);return{r:e(0),g:e(2),b:e(4),a:t.length===8?b(e(6)/255,3):1}}function H(n){let r=s(n.r,0,255)/255,t=s(n.g,0,255)/255,e=s(n.b,0,255)/255,o=Math.max(r,t,e),u=o-Math.min(r,t,e);return{h:$(r,t,e,o,u),s:o?u/o*100:0,b:o*100,a:s(n.a,0,1)}}function C(n){let r=i(n.h),t=s(n.s,0,100)/100,e=s(n.b,0,100)/100,o=e*t,u=o*(1-Math.abs(r/60%2-1));return d(r,o,u,e-o,s(n.a,0,1))}function A(n){let r=s(n.r,0,255)/255,t=s(n.g,0,255)/255,e=s(n.b,0,255)/255,o=Math.max(r,t,e),u=Math.min(r,t,e),l=o-u,c=(o+u)/2,a=l?l/(1-Math.abs(2*c-1)):0;return{h:$(r,t,e,o,l),s:s(a*100,0,100),l:c*100,a:s(n.a,0,1)}}function E(n){let r=i(n.h),t=s(n.s,0,100)/100,e=s(n.l,0,100)/100,o=(1-Math.abs(2*e-1))*t,u=o*(1-Math.abs(r/60%2-1));return d(r,o,u,e-o/2,s(n.a,0,1))}function v(n){let r=s(n.s,0,100)/100,t=s(n.b,0,100)/100,e=t*(1-r/2),o=Math.min(e,1-e);return{h:i(n.h),s:o?(t-e)/o*100:0,l:e*100,a:s(n.a,0,1)}}function F(n){let r=s(n.s,0,100)/100,t=s(n.l,0,100)/100,e=t+r*Math.min(t,1-t);return{h:i(n.h),s:e?2*(1-t/e)*100:0,b:e*100,a:s(n.a,0,1)}}var N=/^(rgba?|hsla?|hsba?|hsva?)\(([^()]*)\)$/;function p(n){if(n===void 0)return null;let r=n.endsWith("%"),t=r?n.slice(0,-1):n.replace(/deg$/,"");if(t.trim()==="")return null;let e=Number(t);return Number.isFinite(e)?{value:e,percent:r}:null}function h(n){let r=p(n);return r&&(r.percent?r.value/100*255:r.value)}function g(n){let r=p(n);return r&&r.value}function y(n){if(n===void 0)return 1;let r=p(n);return r&&(r.percent?r.value/100:r.value)}function f(n){return{h:b(i(n.h),2),s:b(s(n.s,0,100),2),b:b(s(n.b,0,100),2),a:b(s(n.a,0,1),3)}}function P(n){if(typeof n!="string")return null;let r=n.trim().toLowerCase();if(!r)return null;let t=N.exec(r);if(!t){let u=T(r);return u?f(H(u)):null}let e=t[1].replace(/a$/,""),o=t[2].replace(/\//g," ").split(/[\s,]+/).filter(Boolean);return o.length!==3&&o.length!==4?null:O(e,o)}function O(n,r){let t=y(r[3]);if(t===null)return null;if(n==="rgb"){let l=h(r[0]),c=h(r[1]),a=h(r[2]);return l===null||c===null||a===null?null:f(H({r:l,g:c,b:a,a:t}))}let e=g(r[0]),o=g(r[1]),u=g(r[2]);return e===null||o===null||u===null?null:f(n==="hsl"?F({h:e,s:o,l:u,a:t}):{h:e,s:o,b:u,a:t})}function w(n,r,t=!0){let e=b(s(n.a,0,1),3),o=t&&e<1;if(r==="rgb"){let{r:u,g:l,b:c}=C(n);return o?`rgba(${u}, ${l}, ${c}, ${e})`:`rgb(${u}, ${l}, ${c})`}if(r==="hsl"){let u=v(n),l=b(u.h),c=b(u.s),a=b(u.l);return o?`hsla(${l}, ${c}%, ${a}%, ${e})`:`hsl(${l}, ${c}%, ${a}%)`}if(r==="hsb"){let u=b(i(n.h)),l=b(s(n.s,0,100)),c=b(s(n.b,0,100));return o?`hsba(${u}, ${l}%, ${c}%, ${e})`:`hsb(${u}, ${l}%, ${c}%)`}return M(C(n),o)}export{w as formatColor,T as hexToRgb,v as hsbToHsl,C as hsbToRgb,F as hslToHsb,E as hslToRgb,P as parseColor,M as rgbToHex,H as rgbToHsb,A as rgbToHsl};

package/dist/utils/composeRefs.cjs

@@ -1 +1,2 @@
+'use client';
 "use strict";var R=Object.create;var l=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var r=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var d=(e,t)=>{for(var n in t)l(e,n,{get:t[n],enumerable:!0})},s=(e,t,n,c)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of r(t))!b.call(e,o)&&o!==n&&l(e,o,{get:()=>t[o],enumerable:!(c=p(t,o))||c.enumerable});return e};var m=(e,t,n)=>(n=e!=null?R(T(e)):{},s(t||!e||!e.__esModule?l(n,"default",{value:e,enumerable:!0}):n,e)),C=e=>s(l({},"__esModule",{value:!0}),e);var P={};d(P,{composeRefs:()=>i,useComposedRefs:()=>y});module.exports=C(P);var a=m(require("react"),1);function u(e,t){if(typeof e=="function")return e(t);e!=null&&(e.current=t)}function i(...e){return t=>{let n=!1,c=e.map(o=>{let f=u(o,t);return!n&&typeof f=="function"&&(n=!0),f});if(n)return()=>{for(let o=0;o<c.length;o++){let f=c[o];typeof f=="function"?f():u(e[o],null)}}}}function y(...e){return a.useCallback(i(...e),[...e])}0&&(module.exports={composeRefs,useComposedRefs});

package/dist/utils/composeRefs.d.cts

@@ -1,26 +1,19 @@
 import * as React from 'react';
 type PossibleRef<T> = React.Ref<T> | undefined;
 /**
- * Merges any number of refs (callback refs, ref objects, `null`/`undefined`)
- * into a single callback ref that assigns the DOM node to all of them —
- * needed wherever a component both forwards a consumer's ref and keeps its
- * own internal ref on the same node. Supports React 19 cleanup functions:
- * if any callback ref returns a cleanup, the composed ref returns one too.
- *
- * Prefer {@link useComposedRefs} inside components so the composed ref is
- * memoized; use `composeRefs` directly only outside the render/hook flow.
+ * Merges any number of refs into a single callback ref that assigns the DOM node to all of them, supporting React 19 cleanup functions; prefer {@link useComposedRefs} inside components.
  *
  * @example
  * ```tsx
  * const internalRef = React.useRef<HTMLDivElement>(null);
  * return <div ref={composeRefs(forwardedRef, internalRef)} />;
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T>;
 /**
- * Hook version of {@link composeRefs} — memoizes the composed callback ref
- * with `useCallback` so the DOM node isn't detached and reattached on every
- * render (which `composeRefs(...)` called inline in JSX would cause).
+ * Hook version of {@link composeRefs}, memoized with `useCallback` so the DOM node isn't detached and reattached on every render.
  *
  * @example
  * ```tsx

package/dist/utils/composeRefs.d.ts

@@ -1,26 +1,19 @@
 import * as React from 'react';
 type PossibleRef<T> = React.Ref<T> | undefined;
 /**
- * Merges any number of refs (callback refs, ref objects, `null`/`undefined`)
- * into a single callback ref that assigns the DOM node to all of them —
- * needed wherever a component both forwards a consumer's ref and keeps its
- * own internal ref on the same node. Supports React 19 cleanup functions:
- * if any callback ref returns a cleanup, the composed ref returns one too.
- *
- * Prefer {@link useComposedRefs} inside components so the composed ref is
- * memoized; use `composeRefs` directly only outside the render/hook flow.
+ * Merges any number of refs into a single callback ref that assigns the DOM node to all of them, supporting React 19 cleanup functions; prefer {@link useComposedRefs} inside components.
  *
  * @example
  * ```tsx
  * const internalRef = React.useRef<HTMLDivElement>(null);
  * return <div ref={composeRefs(forwardedRef, internalRef)} />;
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
 export declare function composeRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T>;
 /**
- * Hook version of {@link composeRefs} — memoizes the composed callback ref
- * with `useCallback` so the DOM node isn't detached and reattached on every
- * render (which `composeRefs(...)` called inline in JSX would cause).
+ * Hook version of {@link composeRefs}, memoized with `useCallback` so the DOM node isn't detached and reattached on every render.
  *
  * @example
  * ```tsx

package/dist/utils/composeRefs.js

@@ -1 +1,2 @@
+'use client';
 import*as s from"react";function l(e,o){if(typeof e=="function")return e(o);e!=null&&(e.current=o)}function u(...e){return o=>{let c=!1,f=e.map(t=>{let n=l(t,o);return!c&&typeof n=="function"&&(c=!0),n});if(c)return()=>{for(let t=0;t<f.length;t++){let n=f[t];typeof n=="function"?n():l(e[t],null)}}}}function a(...e){return s.useCallback(u(...e),[...e])}export{u as composeRefs,a as useComposedRefs};

package/dist/utils/controllable.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var o=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var b=(e,n)=>{for(var r in n)o(e,r,{get:n[r],enumerable:!0})},C=(e,n,r,l)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of T(n))!s.call(e,t)&&t!==r&&o(e,t,{get:()=>n[t],enumerable:!(l=c(n,t))||l.enumerable});return e};var p=e=>C(o({},"__esModule",{value:!0}),e);var m={};b(m,{controllableValue:()=>a,decideControllable:()=>d,decideReset:()=>y,isControlled:()=>f,sameControlledValue:()=>u});module.exports=p(m);var i=require("./selection.cjs");function u(e,n){return Object.is(e,n)?!0:!Array.isArray(e)||!Array.isArray(n)||!e.every(r=>typeof r=="string")||!n.every(r=>typeof r=="string")?!1:(0,i.sameSelection)(e,n)}function a({controlled:e,uncontrolled:n}){return e!==void 0?e:n}function f({controlled:e}){return e!==void 0}function d(e,n){let r=a(e);return u(r,n)?{value:r,write:!1,emit:!1}:{value:n,write:!f(e),emit:!0}}function y(e,n){return d(e,n)}0&&(module.exports={controllableValue,decideControllable,decideReset,isControlled,sameControlledValue});