@longzai-intelligence-design/utils 0.0.4 → 0.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -3,12 +3,13 @@ import { RefObject } from "react";
3
3
  /**
4
4
  * 合并 CSS 类名
5
5
  *
6
- * 智能处理 Tailwind CSS 类名冲突,后面的类名会覆盖前面的同名类
6
+ * @remarks
7
+ * 智能处理 Tailwind CSS 类名冲突,后面的类名会覆盖前面的同名类
8
+ * @param inputs - 任意数量的类名值,支持字符串、条件对象与嵌套数组
9
+ * @returns 合并并消解冲突后的单一类名字符串
7
10
  */
8
11
  declare function cn(...inputs: ClassValue[]): string;
9
12
  /**
10
- * @module color/oklch
11
- *
12
13
  * OKLCH 颜色空间到 sRGB(hex) 的转换。
13
14
  *
14
15
  * 设计令牌的原始色板以 OKLCH(与 Tailwind v4 一致)定义,但 React Native /
@@ -19,8 +20,18 @@ declare function cn(...inputs: ClassValue[]): string;
19
20
  * 仅处理纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的语义色需运行时背景,
20
21
  * 不在此解析(返回 null 由调用方跳过)。
21
22
  */
22
- /** sRGB 三通道(0–255,已做 gamma 编码)。 */
23
+ /**
24
+ * sRGB 三通道(0–255,已做 gamma 编码)。
25
+ */
23
26
  type Rgb = [r: number, g: number, b: number];
27
+ /**
28
+ * OKLCH 解析产物:明度、彩度与色相。
29
+ */
30
+ type OklchComponents = {
31
+ l: number;
32
+ c: number;
33
+ h: number;
34
+ };
24
35
  /**
25
36
  * 解析 oklch() 字面量为 { L, C, H }。
26
37
  *
@@ -29,11 +40,7 @@ type Rgb = [r: number, g: number, b: number];
29
40
  * @param input - 颜色字符串,如 `oklch(71.1% 0.166 22)`。
30
41
  * @returns 解析结果,非 oklch 输入返回 null。
31
42
  */
32
- declare function parseOklch(input: string): {
33
- l: number;
34
- c: number;
35
- h: number;
36
- } | null;
43
+ declare function parseOklch(input: string): OklchComponents | null;
37
44
  /**
38
45
  * OKLCH 字面量 → sRGB 三通道(0–255)。
39
46
  *
@@ -47,7 +54,7 @@ declare function oklchToRgb(input: string): Rgb | null;
47
54
  * @param rgb - sRGB 三通道。
48
55
  * @returns 形如 `#ffffff` 的 hex 字符串。
49
56
  */
50
- declare function rgbToHex([r, g, b]: Rgb): string;
57
+ declare function rgbToHex(rgb: Rgb): string;
51
58
  /**
52
59
  * OKLCH 字面量 → `#rrggbb` hex(跨端展示用)。
53
60
  *
@@ -56,8 +63,6 @@ declare function rgbToHex([r, g, b]: Rgb): string;
56
63
  */
57
64
  declare function oklchToHex(input: string): string | null;
58
65
  /**
59
- * @module color/palette
60
- *
61
66
  * 将设计令牌的原始色板(OKLCH)整体解析为 hex,供跨端 adapter 在构建期生成
62
67
  * 平台可用的调色板。仅解析纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的
63
68
  * 运行时表达式跳过(值为 null),由调用方按需忽略。
@@ -81,8 +86,6 @@ type ResolvedPalette = Readonly<Record<string, string | null | ResolvedScale>>;
81
86
  */
82
87
  declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>): ResolvedPalette;
83
88
  /**
84
- * @module color/semantics
85
- *
86
89
  * 设计令牌语义颜色的静态解析器。
87
90
  *
88
91
  * 语义色在 `languages/base` 中以 CSS 表达式定义(`var()` 引用、`--alpha()` 透明、
@@ -95,24 +98,36 @@ declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>):
95
98
  * - `var(--color-<hue>)` / `var(--color-<hue>-<step>)` — 原始调色板引用(OKLCH 源值);
96
99
  * - `var(--<semantic-name>)` — 语义变量间引用(在同主题语义表内递归解析);
97
100
  * - `--alpha(<color> / <pct>%)` — 在底色上叠加透明度;
98
- * - `color-mix(in srgb, <color> <pct>%, <color> [<pct>%])` — sRGB 混色(按 CSS Color 4
99
- * 规范在编码值上线性插值;缺省百分比按 100% − 对方权重补齐,双方均缺省为 50/50);
101
+ * - `color-mix(in srgb, <color> <pct>%, <color> [<pct>%])` — sRGB 混色(按 CSS Color 4 规范在编码值上线性插值;缺省百分比按
102
+ * 100% − 对方权重补齐,双方均缺省为 50/50);
100
103
  * - `oklch(...)` / `#rrggbb` / `#rgb` 字面量。
101
104
  *
102
105
  * 无法解析的表达式输出 null,由调用方决定回退策略。
103
106
  */
104
- /** 已解析的 RGBA 颜色(r/g/b 为 0–255,a 为 0–1)。 */
105
- interface RgbaColor {
106
- /** 红色通道(0–255)。 */
107
+ /**
108
+ * 已解析的 RGBA 颜色(r/g/b 为 0–255,a 为 0–1)。
109
+ */
110
+ type RgbaColor = {
111
+ /**
112
+ * 红色通道(0–255)。
113
+ */
107
114
  r: number;
108
- /** 绿色通道(0–255)。 */
115
+ /**
116
+ * 绿色通道(0–255)。
117
+ */
109
118
  g: number;
110
- /** 蓝色通道(0–255)。 */
119
+ /**
120
+ * 蓝色通道(0–255)。
121
+ */
111
122
  b: number;
112
- /** 透明度(0–1)。 */
123
+ /**
124
+ * 透明度(0–1)。
125
+ */
113
126
  a: number;
114
- }
115
- /** 原始调色板输入:纯色(white/black)为字符串,其余色相为色阶记录。 */
127
+ };
128
+ /**
129
+ * 原始调色板输入:纯色(white/black)为字符串,其余色相为色阶记录。
130
+ */
116
131
  type SemanticsPaletteInput = Readonly<Record<string, string | Readonly<Record<string, string>>>>;
117
132
  /**
118
133
  * 把已解析颜色格式化为平台通用字符串:不透明输出 `#rrggbb`,含透明度输出 `rgba()`。
@@ -134,80 +149,121 @@ declare function formatColor(color: RgbaColor): string;
134
149
  declare function resolveSemanticColors(semanticColors: Readonly<Record<string, string>>, palette: SemanticsPaletteInput): Readonly<Record<string, string | null>>;
135
150
  /**
136
151
  * 检测当前是否为移动端视口
152
+ *
153
+ * @returns 视口宽度落在移动端断点内时为 true
137
154
  */
138
155
  declare function useIsMobile(): boolean;
139
- interface UseMediaQueryOptions {
156
+ /**
157
+ * useMediaQuery 的配置选项。
158
+ */
159
+ type UseMediaQueryOptions = {
160
+ /**
161
+ * 服务端渲染或尚未取值时的缺省匹配结果。
162
+ */
140
163
  defaultValue?: boolean;
164
+ /**
165
+ * 初始化时是否立即读取一次匹配结果。
166
+ */
141
167
  initializeWithValue?: boolean;
142
- }
168
+ };
143
169
  /**
144
170
  * 响应式媒体查询 hook
145
171
  *
146
172
  * @param query - 媒体查询字符串
147
173
  * @param options - 配置选项
174
+ * @returns 当前媒体查询是否命中
148
175
  */
149
176
  declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
150
- interface UseStepperOptions {
151
- /** 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步 */
177
+ /**
178
+ * useStepper 的配置选项。
179
+ */
180
+ type UseStepperOptions = {
181
+ /**
182
+ * 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步
183
+ */
152
184
  steps: readonly number[];
153
- /** 是否启用步进(默认 true);false 时立即跳到末步 */
185
+ /**
186
+ * 是否启用步进(默认 true);false 时立即跳到末步
187
+ */
154
188
  enabled?: boolean;
155
- /** 完成后是否循环回到第 0 步(默认 false) */
189
+ /**
190
+ * 完成后是否循环回到第 0 步(默认 false)
191
+ */
156
192
  loop?: boolean;
157
- /** 循环重置前的额外等待(毫秒,默认 0) */
193
+ /**
194
+ * 循环重置前的额外等待(毫秒,默认 0)
195
+ */
158
196
  loopDelay?: number;
159
- }
197
+ };
160
198
  /**
161
199
  * 序列步进 hook —— 按延迟序列逐步推进步骤索引。
162
200
  *
163
201
  * 移植自 beautiful-ui 的 useStepper,纯 setTimeout 状态机驱动,不依赖任何动效库。
164
202
  * 常见用途:
203
+ *
165
204
  * - 列表/网格的 staggered 入场错峰(配合 `animate-fade-up` + `animation-delay`)
166
205
  * - 多阶段逐步显现(如 AI 思考链逐步展开)
167
206
  * - 循环演示动画
168
207
  *
169
208
  * 第 i 步触发后等待 `steps[i]` 毫秒进入第 i+1 步,到达末步后停止(或循环)。
170
209
  *
210
+ * @example
211
+ * ```tsx
212
+ * const step = useStepper({ steps: [60, 60, 60, 60] });
213
+ * items.map((item, i) => (
214
+ * <li className={i <= step ? 'animate-fade-up' : 'opacity-0'}>{item}</li>
215
+ * ));
216
+ * ```;
217
+ *
171
218
  * @param options - 步进配置
172
219
  * @returns 当前步骤索引(0 起,至 `steps.length - 1` 停止)
173
- *
174
- * @example
175
- * ```tsx
176
- * const step = useStepper({ steps: [60, 60, 60, 60] });
177
- * items.map((item, i) => (
178
- * <li className={i <= step ? 'animate-fade-up' : 'opacity-0'}>{item}</li>
179
- * ));
180
- * ```
181
220
  */
182
221
  declare function useStepper({ steps, enabled, loop, loopDelay }: UseStepperOptions): number;
183
- interface UseMagicPillOptions {
222
+ /**
223
+ * useMagicPill 的配置选项。
224
+ */
225
+ type UseMagicPillOptions = {
184
226
  /**
185
227
  * 容器 ref(需为 positioned 元素,子项 offsetTop 相对它计算;
186
228
  * 通常给容器加 `relative`)。
187
229
  */
188
230
  containerRef: RefObject<HTMLElement | null>;
189
- /** 当前激活项的索引 */
231
+ /**
232
+ * 当前激活项的索引
233
+ */
190
234
  activeIndex: number;
191
235
  /**
192
236
  * 当前悬停项的索引(hover 优先于 active);
193
237
  * 传 -1 表示无悬停,回退到 activeIndex。
194
238
  */
195
239
  hoverIndex?: number;
196
- /** 容器内子项的查询选择器(默认取直接子元素) */
240
+ /**
241
+ * 容器内子项的查询选择器(默认取直接子元素)
242
+ */
197
243
  itemSelector?: string;
198
- }
199
- interface MagicPillPosition {
200
- /** 高亮 span 的 top(px,相对容器 offsetParent) */
244
+ };
245
+ /**
246
+ * 高亮 span 的定位状态。
247
+ */
248
+ type MagicPillPosition = {
249
+ /**
250
+ * 高亮 span 的 top(px,相对容器 offsetParent)
251
+ */
201
252
  top: number;
202
- /** 高亮 span 的 height(px) */
253
+ /**
254
+ * 高亮 span 的 height(px)
255
+ */
203
256
  height: number;
204
- /** 是否可见(存在有效目标项时为 true) */
257
+ /**
258
+ * 是否可见(存在有效目标项时为 true)
259
+ */
205
260
  visible: boolean;
206
- }
261
+ };
207
262
  /**
208
263
  * 魔药丸高亮 hook —— 测量目标项的位置与尺寸,驱动一个绝对定位的高亮 span 平滑跟随。
209
264
  *
210
265
  * 移植自 beautiful-ui 的 Magic Pill 交互模式,用于:
266
+ *
211
267
  * - 侧边栏 / Tab 栏的高亮指示器
212
268
  * - 菜单 / 分段控件的选中项滑动背景
213
269
  *
@@ -215,25 +271,35 @@ interface MagicPillPosition {
215
271
  * 配合 CSS transition(建议 `transition-[top,height] duration-normal ease-emphasized`)实现滑动。
216
272
  * hover 优先于 active:悬停时跟随悬停项,离开后回到激活项。
217
273
  *
274
+ * @example
275
+ * ```tsx
276
+ * const containerRef = useRef<HTMLUListElement>(null);
277
+ * const [active, setActive] = useState(0);
278
+ * const [hover, setHover] = useState(-1);
279
+ * const pill = useMagicPill({ containerRef, activeIndex: active, hoverIndex: hover });
280
+ * return (
281
+ * <ul ref={containerRef} className="relative">
282
+ * <span
283
+ * aria-hidden
284
+ * style={{ top: pill.top, height: pill.height, opacity: pill.visible ? 1 : 0 }}
285
+ * className="pointer-events-none absolute inset-x-0 rounded-md bg-muted transition-[top,height,opacity] duration-normal ease-emphasized"
286
+ * />
287
+ * {items.map((item, i) => (
288
+ * <li
289
+ * key={i}
290
+ * onMouseEnter={() => setHover(i)}
291
+ * onMouseLeave={() => setHover(-1)}
292
+ * onClick={() => setActive(i)}
293
+ * >
294
+ * {item}
295
+ * </li>
296
+ * ))}
297
+ * </ul>
298
+ * );
299
+ * ```;
300
+ *
218
301
  * @param options - 魔药丸配置
219
302
  * @returns 高亮 span 的定位状态
220
- *
221
- * @example
222
- * ```tsx
223
- * const containerRef = useRef<HTMLUListElement>(null);
224
- * const [active, setActive] = useState(0);
225
- * const [hover, setHover] = useState(-1);
226
- * const pill = useMagicPill({ containerRef, activeIndex: active, hoverIndex: hover });
227
- * return (
228
- * <ul ref={containerRef} className="relative">
229
- * <span aria-hidden style={{ top: pill.top, height: pill.height, opacity: pill.visible ? 1 : 0 }}
230
- * className="pointer-events-none absolute inset-x-0 rounded-md bg-muted transition-[top,height,opacity] duration-normal ease-emphasized" />
231
- * {items.map((item, i) => (
232
- * <li key={i} onMouseEnter={() => setHover(i)} onMouseLeave={() => setHover(-1)} onClick={() => setActive(i)}>{item}</li>
233
- * ))}
234
- * </ul>
235
- * );
236
- * ```
237
303
  */
238
304
  declare function useMagicPill({ containerRef, activeIndex, hoverIndex, itemSelector }: UseMagicPillOptions): MagicPillPosition;
239
305
  export { type MagicPillPosition, type ResolvedPalette, type ResolvedScale, type Rgb, type RgbaColor, type SemanticsPaletteInput, type UseMagicPillOptions, type UseMediaQueryOptions, type UseStepperOptions, cn, formatColor, oklchToHex, oklchToRgb, parseOklch, resolvePaletteHex, resolveSemanticColors, rgbToHex, useIsMobile, useMagicPill, useMediaQuery, useStepper };
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{clsx as e}from"clsx";import{twMerge as t}from"tailwind-merge";import{useCallback as n,useEffect as r,useLayoutEffect as i,useRef as a,useState as o}from"react";function s(...n){return t(e(n))}function c(e){let t=/oklch\(\s*([^)]+?)\s*\)/i.exec(e.trim());if(!t)return null;let[n,r,i]=(t[1]??``).split(/\s+(?![^(]*\))/).map(e=>e.trim());if(n===void 0||r===void 0||i===void 0)return null;let a=n.endsWith(`%`)?Number.parseFloat(n)/100:Number.parseFloat(n),o=Number.parseFloat(r),s=Number.parseFloat(i);return[a,o,s].some(Number.isNaN)?null:{l:a,c:o,h:s}}function l(e){return e>=.0031308?1.055*e**(1/2.4)-.055:12.92*e}function u(e,t,n){let r=e+.3963377774*t+.2158037573*n,i=e-.1055613458*t-.0638541728*n,a=e-.0894841775*t-1.291485548*n,o=r**3,s=i**3,c=a**3;return[4.0767416621*o-3.3077115913*s+.2309699292*c,-1.2684380046*o+2.6097574011*s-.3413193965*c,-.0041960863*o-.7034186147*s+1.707614701*c]}function d(e){let t=c(e);if(!t)return null;let n=t.h*Math.PI/180,r=t.c*Math.cos(n),i=t.c*Math.sin(n),[a,o,s]=u(t.l,r,i);return[Math.round(f(l(a))*255),Math.round(f(l(o))*255),Math.round(f(l(s))*255)]}function f(e){return Math.min(1,Math.max(0,e))}function p([e,t,n]){let r=e=>e.toString(16).padStart(2,`0`);return`#${r(e)}${r(t)}${r(n)}`}function m(e){let t=d(e);return t?p(t):null}function h(e){return m(e)}function g(e){return Object.fromEntries(Object.entries(e).map(([e,t])=>[e,h(t)]))}function _(e){return Object.fromEntries(Object.entries(e).map(([e,t])=>typeof t==`string`?[e,h(t)]:typeof t==`object`&&t?[e,g(t)]:[e,null]))}function v(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function y(e,t){let n=e.replace(/^color-/,``),r=n.indexOf(`-`),i=r===-1?n:n.slice(0,r),a=r===-1?void 0:n.slice(r+1),o=t[i];if(typeof o==`string`)return b(o);if(typeof o==`object`&&o&&a!==void 0){let e=o[a];return e===void 0?null:b(e)}return null}function b(e){let t=e.trim(),n=d(t);if(n)return{r:n[0],g:n[1],b:n[2],a:1};let r=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(t);if(r){let e=r[1]??``,t=e.length===3?e.split(``).map(e=>e+e).join(``):e;return{r:Number.parseInt(t.slice(0,2),16),g:Number.parseInt(t.slice(2,4),16),b:Number.parseInt(t.slice(4,6),16),a:1}}return null}function x(e,t){let n=e.lastIndexOf(`/`);if(n===-1)return null;let r=T(e.slice(0,n),t),i=Number.parseFloat(e.slice(n+1));return!r||Number.isNaN(i)?null:{...r,a:r.a*(i/100)}}function S(e,t){let n=/^in\s+[a-z-]+\s*,\s*(.+)$/is.exec(e.trim());if(!n)return null;let r=w(n[1]??``,`,`);if(r.length!==2)return null;let i=C(r[0]??``,t),a=C(r[1]??``,t);if(!i||!a)return null;let o=i.weight,s=a.weight;Number.isNaN(o)&&Number.isNaN(s)?(o=50,s=50):Number.isNaN(o)?o=100-s:Number.isNaN(s)&&(s=100-o);let c=o+s;if(c<=0)return null;let l=o/c,u=s/c,d=(e,t)=>e*l+t*u;return{r:Math.round(d(i.color.r,a.color.r)),g:Math.round(d(i.color.g,a.color.g)),b:Math.round(d(i.color.b,a.color.b)),a:d(i.color.a,a.color.a)}}function C(e,t){let n=/^(.*?)\s+([\d.]+)%\s*$/.exec(e.trim()),r=n!==null,i=T(r?n?.[1]??``:e.trim(),t);return i?r?{color:i,weight:Number.parseFloat(n?.[2]??`0`)}:{color:i,weight:NaN}:null}function w(e,t){let n=0,r=0,i=[];for(let a=0;a<e.length;a+=1){let o=e[a];o===`(`?n+=1:o===`)`?--n:o===t&&n===0&&(i.push(e.slice(r,a).trim()),r=a+1)}return i.push(e.slice(r).trim()),i}function T(e,t){let n=e.trim(),r=/^var\(\s*(--[\w-]+)\s*\)$/.exec(n);if(r){let e=(r[1]??``).slice(2);if(e.startsWith(`color-`))return y(e,t.palette);let n=v(e),i=t.semantic[n];if(i===void 0||t.resolving.has(n))return null;t.resolving.add(n);let a=T(i,t);return t.resolving.delete(n),a}let i=/^--alpha\((.*)\)$/.exec(n);if(i)return x(i[1]??``,t);let a=/^color-mix\((.*)\)$/.exec(n);return a?S(a[1]??``,t):b(n)}function E(e){let t=e=>e.toString(16).padStart(2,`0`);return e.a>=1?`#${t(e.r)}${t(e.g)}${t(e.b)}`:`rgba(${e.r}, ${e.g}, ${e.b}, ${Number(e.a.toFixed(3))})`}function D(e,t){let n={};for(let[r,i]of Object.entries(e)){let a=T(i,{palette:t,semantic:e,resolving:/* @__PURE__ */ new Set([r])});n[r]=a?E(a):null}return n}const O=typeof window>`u`;function k(e,t={}){let{defaultValue:i=!1,initializeWithValue:a=!0}=t,s=n(e=>O?i:window.matchMedia(e).matches,[i]),[c,l]=o(()=>a?s(e):i);return r(()=>{let t=window.matchMedia(e),n=e=>{l(e.matches)};return l(t.matches),t.addEventListener(`change`,n),()=>{t.removeEventListener(`change`,n)}},[e]),c}function A(){return k(`(max-width: 767px)`,{defaultValue:!1})}function j({steps:e,enabled:t=!0,loop:n=!1,loopDelay:i=0}){let[s,c]=o(0),l=a(e);return l.current=e,r(()=>{if(!t){c(l.current.length-1);return}let e=l.current.length;if(e===0)return;if(s>=e-1){if(n){let e=window.setTimeout(()=>c(0),(l.current[s]??0)+i);return()=>window.clearTimeout(e)}return}let r=window.setTimeout(()=>c(e=>e+1),l.current[s]??0);return()=>window.clearTimeout(r)},[s,t,n,i]),s}const M={top:0,height:0,visible:!1};function N({containerRef:e,activeIndex:t,hoverIndex:n=-1,itemSelector:r}){let[a,s]=o(M);return i(()=>{let i=e.current;if(!i)return;let a=n>=0?n:t,o=(r?Array.from(i.querySelectorAll(r)):Array.from(i.children))[a];s(o?{top:o.offsetTop,height:o.offsetHeight,visible:!0}:e=>e.visible?{...e,visible:!1}:e)},[e,t,n,r]),a}export{s as cn,E as formatColor,m as oklchToHex,d as oklchToRgb,c as parseOklch,_ as resolvePaletteHex,D as resolveSemanticColors,p as rgbToHex,A as useIsMobile,N as useMagicPill,k as useMediaQuery,j as useStepper};
1
+ import{clsx as e}from"clsx";import{twMerge as t}from"tailwind-merge";import{useCallback as n,useEffect as r,useLayoutEffect as i,useRef as a,useState as o}from"react";function s(...n){return t(e(n))}function c(e){let t=/oklch\(\s*([^)]+?)\s*\)/i.exec(e.trim());if(!t)return null;let[n,r,i]=(t[1]??``).split(/\s+(?![^(]*\))/).map(e=>e.trim());if(n===void 0||r===void 0||i===void 0)return null;let a=n.endsWith(`%`)?Number.parseFloat(n)/100:Number.parseFloat(n),o=Number.parseFloat(r),s=Number.parseFloat(i);return[a,o,s].some(Number.isNaN)?null:{l:a,c:o,h:s}}function l(e){return e>=.0031308?1.055*e**(1/2.4)-.055:12.92*e}function u(e,t,n){let r=e+.3963377774*t+.2158037573*n,i=e-.1055613458*t-.0638541728*n,a=e-.0894841775*t-1.291485548*n,o=r**3,s=i**3,c=a**3;return[4.0767416621*o-3.3077115913*s+.2309699292*c,-1.2684380046*o+2.6097574011*s-.3413193965*c,-.0041960863*o-.7034186147*s+1.707614701*c]}function d(e){let t=c(e);if(!t)return null;let n=t.h*Math.PI/180,r=t.c*Math.cos(n),i=t.c*Math.sin(n),[a,o,s]=u(t.l,r,i);return[Math.round(f(l(a))*255),Math.round(f(l(o))*255),Math.round(f(l(s))*255)]}function f(e){return Math.min(1,Math.max(0,e))}function p(e){let t=e=>e.toString(16).padStart(2,`0`);return`#${t(e[0])}${t(e[1])}${t(e[2])}`}function m(e){let t=d(e);return t?p(t):null}function h(e){return typeof e!=`object`||!e?!1:Object.values(e).every(e=>typeof e==`string`)}function g(e){return m(e)}function _(e){return Object.fromEntries(Object.entries(e).map(([e,t])=>[e,g(t)]))}function v(e){return Object.fromEntries(Object.entries(e).map(([e,t])=>typeof t==`string`?[e,g(t)]:h(t)?[e,_(t)]:[e,null]))}function y(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}function b(e,t){let n=e.replace(/^color-/,``),r=n.indexOf(`-`),i=r===-1?n:n.slice(0,r),a=r===-1?void 0:n.slice(r+1),o=t[i];if(typeof o==`string`)return x(o);if(typeof o==`object`&&o&&a!==void 0){let e=o[a];return e===void 0?null:x(e)}return null}function x(e){let t=e.trim(),n=d(t);if(n)return{r:n[0],g:n[1],b:n[2],a:1};let r=/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(t);if(r){let e=r[1]??``,t=e.length===3?e.split(``).map(e=>e+e).join(``):e;return{r:Number.parseInt(t.slice(0,2),16),g:Number.parseInt(t.slice(2,4),16),b:Number.parseInt(t.slice(4,6),16),a:1}}return null}function S(e,t){let n=e.lastIndexOf(`/`);if(n===-1)return null;let r=E(e.slice(0,n),t),i=Number.parseFloat(e.slice(n+1));return!r||Number.isNaN(i)?null:{...r,a:r.a*(i/100)}}function C(e,t){let n=/^in\s+[a-z-]+\s*,\s*(.+)$/is.exec(e.trim());if(!n)return null;let r=T(n[1]??``,`,`);if(r.length!==2)return null;let i=w(r[0]??``,t),a=w(r[1]??``,t);if(!i||!a)return null;let o=i.weight,s=a.weight;Number.isNaN(o)&&Number.isNaN(s)?(o=50,s=50):Number.isNaN(o)?o=100-s:Number.isNaN(s)&&(s=100-o);let c=o+s;if(c<=0)return null;let l=o/c,u=s/c,d=(e,t)=>e*l+t*u;return{r:Math.round(d(i.color.r,a.color.r)),g:Math.round(d(i.color.g,a.color.g)),b:Math.round(d(i.color.b,a.color.b)),a:d(i.color.a,a.color.a)}}function w(e,t){let n=/^(.*?)\s+([\d.]+)%\s*$/.exec(e.trim()),r=n!==null,i=E(r?n?.[1]??``:e.trim(),t);return i?r?{color:i,weight:Number.parseFloat(n?.[2]??`0`)}:{color:i,weight:NaN}:null}function T(e,t){let n=0,r=0,i=[];for(let a=0;a<e.length;a+=1){let o=e[a];o===`(`?n+=1:o===`)`?--n:o===t&&n===0&&(i.push(e.slice(r,a).trim()),r=a+1)}return i.push(e.slice(r).trim()),i}function E(e,t){let n=e.trim(),r=/^var\(\s*(--[\w-]+)\s*\)$/.exec(n);if(r){let e=(r[1]??``).slice(2);if(e.startsWith(`color-`))return b(e,t.palette);let n=y(e),i=t.semantic[n];if(i===void 0||t.resolving.has(n))return null;t.resolving.add(n);let a=E(i,t);return t.resolving.delete(n),a}let i=/^--alpha\((.*)\)$/.exec(n);if(i)return S(i[1]??``,t);let a=/^color-mix\((.*)\)$/.exec(n);return a?C(a[1]??``,t):x(n)}function D(e){let t=e=>e.toString(16).padStart(2,`0`);return e.a>=1?`#${t(e.r)}${t(e.g)}${t(e.b)}`:`rgba(${e.r}, ${e.g}, ${e.b}, ${Number(e.a.toFixed(3))})`}function O(e,t){let n={};for(let[r,i]of Object.entries(e)){let a=E(i,{palette:t,semantic:e,resolving:/* @__PURE__ */ new Set([r])});n[r]=a?D(a):null}return n}const k=typeof window>`u`;function A(e,t={}){let{defaultValue:i=!1,initializeWithValue:a=!0}=t,s=n(e=>k?i:window.matchMedia(e).matches,[i]),[c,l]=o(()=>a?s(e):i);return r(()=>{let t=window.matchMedia(e),n=e=>{l(e.matches)};return l(t.matches),t.addEventListener(`change`,n),()=>{t.removeEventListener(`change`,n)}},[e]),c}function j(){return A(`(max-width: 767px)`,{defaultValue:!1})}function M({steps:e,enabled:t=!0,loop:n=!1,loopDelay:i=0}){let[s,c]=o(0),l=a(e);return l.current=e,r(()=>{if(!t){c(l.current.length-1);return}let e=l.current.length;if(e===0)return;if(s>=e-1){if(n){let e=window.setTimeout(()=>c(0),(l.current[s]??0)+i);return()=>window.clearTimeout(e)}return}let r=window.setTimeout(()=>c(e=>e+1),l.current[s]??0);return()=>window.clearTimeout(r)},[s,t,n,i]),s}const N={top:0,height:0,visible:!1};function P({containerRef:e,activeIndex:t,hoverIndex:n=-1,itemSelector:r}){let[a,s]=o(N);return i(()=>{let i=e.current;if(!i)return;let a=n>=0?n:t,o=r?i.querySelectorAll(r):i.children,c=Array.from(o).filter(e=>e instanceof HTMLElement)[a];s(c?{top:c.offsetTop,height:c.offsetHeight,visible:!0}:e=>e.visible?{...e,visible:!1}:e)},[e,t,n,r]),a}export{s as cn,D as formatColor,m as oklchToHex,d as oklchToRgb,c as parseOklch,v as resolvePaletteHex,O as resolveSemanticColors,p as rgbToHex,j as useIsMobile,P as useMagicPill,A as useMediaQuery,M as useStepper};
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "@longzai-intelligence-design/utils",
3
- "version": "0.0.4",
3
+ "version": "0.0.6",
4
4
  "description": "Longzai Intelligence Design 通用工具层",
5
5
  "keywords": [
6
- "longzai-intelligence",
6
+ "classnames",
7
7
  "design",
8
- "utils",
9
8
  "hooks",
10
- "classnames"
9
+ "longzai-intelligence",
10
+ "utils"
11
11
  ],
12
12
  "license": "UNLICENSED",
13
13
  "files": [
@@ -26,19 +26,21 @@
26
26
  "build": "lzi-builder",
27
27
  "build:prod": "NODE_ENV=production bun run build",
28
28
  "prepublishOnly": "bun run build:prod",
29
- "dev": "lzi-builder --watch",
30
29
  "typecheck": "lzi-typecheck",
31
- "clean": "lzi-dev-cli clean",
32
- "test": "vitest run",
33
- "test:watch": "vitest"
30
+ "lint": "lzi-lint lint",
31
+ "lint:fix": "lzi-lint fix",
32
+ "test": "lzi-bun test",
33
+ "test:watch": "lzi-bun test --watch",
34
+ "test:coverage": "lzi-bun test --coverage",
35
+ "clean": "lzi-dev-tools clean"
34
36
  },
35
37
  "dependencies": {
36
38
  "clsx": "^2.1.1",
37
- "tailwind-merge": "^3.5.0"
39
+ "tailwind-merge": "^3.7.0"
38
40
  },
39
41
  "devDependencies": {
40
- "@types/react": "^19.2.14",
41
- "react": "^19.2.5"
42
+ "@types/react": "^19.3.0",
43
+ "react": "^19.3.1"
42
44
  },
43
45
  "peerDependencies": {
44
46
  "react": ">=18.0.0"