@skdx/react 0.28.0 → 0.29.0

package/dist/utils/cardNesting.cjs

@@ -1 +1,2 @@
-"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("./is-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});
+'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

@@ -1,25 +1,7 @@
 import * as React from 'react';
 /**
- * Warns when a card root contains a focusable descendant that is not its own
- * Control.
- *
- * Both card families document the rule — "nothing interactive may be nested
- * inside the card" — and until this existed nothing enforced it: no runtime
- * check, no lint rule, no assertion. It is not a style preference. The root is
- * a `<label>`, so a nested `<a>` or `<button>` is an HTML content-model
- * violation *and* a live usability bug: clicking the inner control activates
- * the label too, so a "Learn more" link inside a card silently toggles the
- * card on the way to the link. That is exactly the thing the first consumer who
- * wants a link on a card will build, and the failure is invisible in review.
- *
- * A warning rather than a thrown error: the page still works, badly, and
- * breaking a consumer's render over a composition mistake is a worse trade than
- * telling them about it. Runs from an effect, so it sees the *rendered*
- * subtree — which is the only place the answer lives, since the offending child
- * may come from a consumer's own component.
- *
+ * @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>`
- * @internal
  */
 export declare function useCardNestingWarning(family: 'CheckboxCard' | 'RadioCard', rootRef: React.RefObject<HTMLElement | null>): void;

package/dist/utils/cardNesting.d.ts

@@ -1,25 +1,7 @@
 import * as React from 'react';
 /**
- * Warns when a card root contains a focusable descendant that is not its own
- * Control.
- *
- * Both card families document the rule — "nothing interactive may be nested
- * inside the card" — and until this existed nothing enforced it: no runtime
- * check, no lint rule, no assertion. It is not a style preference. The root is
- * a `<label>`, so a nested `<a>` or `<button>` is an HTML content-model
- * violation *and* a live usability bug: clicking the inner control activates
- * the label too, so a "Learn more" link inside a card silently toggles the
- * card on the way to the link. That is exactly the thing the first consumer who
- * wants a link on a card will build, and the failure is invisible in review.
- *
- * A warning rather than a thrown error: the page still works, badly, and
- * breaking a consumer's render over a composition mistake is a worse trade than
- * telling them about it. Runs from an effect, so it sees the *rendered*
- * subtree — which is the only place the answer lives, since the offending child
- * may come from a consumer's own component.
- *
+ * @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>`
- * @internal
  */
 export declare function useCardNestingWarning(family: 'CheckboxCard' | 'RadioCard', rootRef: React.RefObject<HTMLElement | null>): void;

package/dist/utils/cardNesting.js

@@ -1 +1,2 @@
-import*as n from"react";import{isDevMode as s}from"./is-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};
+'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});

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,2 @@
+'use client';
+import{sameSelection as t}from"./selection.js";function o(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:t(e,n)}function l({controlled:e,uncontrolled:n}){return e!==void 0?e:n}function i({controlled:e}){return e!==void 0}function u(e,n){let r=l(e);return o(r,n)?{value:r,write:!1,emit:!1}:{value:n,write:!i(e),emit:!0}}function f(e,n){return u(e,n)}export{l as controllableValue,u as decideControllable,f as decideReset,i as isControlled,o as sameControlledValue};

package/dist/utils/createContext.cjs

@@ -1 +1,2 @@
-"use strict";var C=Object.create;var i=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var w=(e,t)=>{for(var n in t)i(e,n,{get:t[n],enumerable:!0})},x=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of h(t))!v.call(e,o)&&o!==n&&i(e,o,{get:()=>t[o],enumerable:!(r=R(t,o))||r.enumerable});return e};var b=(e,t,n)=>(n=e!=null?C(g(e)):{},x(t||!e||!e.__esModule?i(n,"default",{value:e,enumerable:!0}):n,e)),j=e=>x(i({},"__esModule",{value:!0}),e);var P={};w(P,{createSafeContext:()=>O});module.exports=j(P);var c=b(require("react"),1),f=require("react/jsx-runtime");function k(e,t){let n=Object.keys(e);return n.length!==Object.keys(t).length?!1:n.every(r=>r in t&&Object.is(e[r],t[r]))}function O(e,t){let n=c.createContext(t);function r(u){let{children:s,...a}=u,d=c.useRef(a);return k(d.current,a)||(d.current=a),(0,f.jsx)(n.Provider,{value:d.current,children:s})}r.displayName=`${e}Provider`;function o(u){let s=c.useContext(n);if(s!==void 0)return s;if(t!==void 0)return t;throw new Error(`[skandadx] \`${u}\` must be used within \`${e}\`.`)}function l(){return c.useContext(n)??t}return[r,o,l]}0&&(module.exports={createSafeContext});
+'use client';
+"use strict";var f=Object.create;var s=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,v=Object.prototype.hasOwnProperty;var w=(e,t)=>{for(var n in t)s(e,n,{get:t[n],enumerable:!0})},x=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of h(t))!v.call(e,o)&&o!==n&&s(e,o,{get:()=>t[o],enumerable:!(r=R(t,o))||r.enumerable});return e};var b=(e,t,n)=>(n=e!=null?f(g(e)):{},x(t||!e||!e.__esModule?s(n,"default",{value:e,enumerable:!0}):n,e)),j=e=>x(s({},"__esModule",{value:!0}),e);var y={};w(y,{createSafeContext:()=>k});module.exports=j(y);var c=b(require("react"),1),l=require("react/jsx-runtime");function V(e,t){let n=Object.keys(e);return n.length!==Object.keys(t).length?!1:n.every(r=>r in t&&Object.is(e[r],t[r]))}function k(e,t){let n=c.createContext(t);function r(i){let{children:u,...a}=i,d=c.useRef(a);return V(d.current,a)||(d.current=a),(0,l.jsx)(n.Provider,{value:d.current,children:u})}r.displayName=`${e}Provider`;function o(i){let u=c.useContext(n);if(u!==void 0)return u;if(t!==void 0)return t;throw new Error(`[skandadx] \`${i}\` must be used within \`${e}\`.`)}function C(){return c.useContext(n)??t}return[r,o,C]}0&&(module.exports={createSafeContext});

package/dist/utils/createContext.d.cts

@@ -1,10 +1,6 @@
 import * as React from 'react';
 /**
- * Creates a scoped `[Provider, useContext]` pair for a compound component's
- * internal state (e.g. `Tabs`'s selected value, shared with `TabsTrigger`
- * and `TabsContent`). Unlike raw `React.createContext`, the returned
- * `useContext(consumerName)` throws a descriptive error instead of silently
- * returning `undefined` when a part is rendered outside its root.
+ * Creates a scoped `[Provider, useContext]` pair for a compound component's internal state, whose `useContext(consumerName)` throws a descriptive error instead of silently returning `undefined` outside its root.
  *
  * @param rootComponentName - Name of the root component, used in the Provider's `displayName` and in error messages.
  * @param defaultValue - Optional fallback so the context also works without a Provider (rare; most compound components require one).
@@ -20,10 +16,13 @@ import * as React from 'react';
  * // in TabsTrigger.tsx
  * const context = useTabsContext('TabsTrigger'); // throws "`TabsTrigger` must be used within `Tabs`." if misused
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
-export declare function createSafeContext<ContextValue extends object | null>(rootComponentName: string, defaultValue?: ContextValue): readonly [{
-    (props: ContextValue & {
+export declare function createSafeContext<ContextValue extends object | null>(rootComponentName: string, defaultValue?: ContextValue): readonly [
+    React.FC<ContextValue & {
         children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, (consumerName: string) => ContextValue, () => ContextValue | undefined];
+    }>,
+    (consumerName: string) => ContextValue,
+    () => ContextValue | undefined
+];