@longzai-intelligence-design/utils 0.0.3 → 0.0.5
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 +132 -82
- package/dist/index.js +1 -1
- package/package.json +13 -11
package/dist/index.d.ts
CHANGED
|
@@ -1,17 +1,15 @@
|
|
|
1
1
|
import { ClassValue } from "clsx";
|
|
2
2
|
import { RefObject } from "react";
|
|
3
|
-
//#region src/cn.d.ts
|
|
4
3
|
/**
|
|
5
4
|
* 合并 CSS 类名
|
|
6
5
|
*
|
|
7
|
-
*
|
|
6
|
+
* @remarks
|
|
7
|
+
* 智能处理 Tailwind CSS 类名冲突,后面的类名会覆盖前面的同名类
|
|
8
|
+
* @param inputs - 任意数量的类名值,支持字符串、条件对象与嵌套数组
|
|
9
|
+
* @returns 合并并消解冲突后的单一类名字符串
|
|
8
10
|
*/
|
|
9
11
|
declare function cn(...inputs: ClassValue[]): string;
|
|
10
|
-
//#endregion
|
|
11
|
-
//#region src/color/oklch.d.ts
|
|
12
12
|
/**
|
|
13
|
-
* @module color/oklch
|
|
14
|
-
*
|
|
15
13
|
* OKLCH 颜色空间到 sRGB(hex) 的转换。
|
|
16
14
|
*
|
|
17
15
|
* 设计令牌的原始色板以 OKLCH(与 Tailwind v4 一致)定义,但 React Native /
|
|
@@ -22,8 +20,18 @@ declare function cn(...inputs: ClassValue[]): string;
|
|
|
22
20
|
* 仅处理纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的语义色需运行时背景,
|
|
23
21
|
* 不在此解析(返回 null 由调用方跳过)。
|
|
24
22
|
*/
|
|
25
|
-
/**
|
|
23
|
+
/**
|
|
24
|
+
* sRGB 三通道(0–255,已做 gamma 编码)。
|
|
25
|
+
*/
|
|
26
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
|
+
};
|
|
27
35
|
/**
|
|
28
36
|
* 解析 oklch() 字面量为 { L, C, H }。
|
|
29
37
|
*
|
|
@@ -32,11 +40,7 @@ type Rgb = [r: number, g: number, b: number];
|
|
|
32
40
|
* @param input - 颜色字符串,如 `oklch(71.1% 0.166 22)`。
|
|
33
41
|
* @returns 解析结果,非 oklch 输入返回 null。
|
|
34
42
|
*/
|
|
35
|
-
declare function parseOklch(input: string):
|
|
36
|
-
l: number;
|
|
37
|
-
c: number;
|
|
38
|
-
h: number;
|
|
39
|
-
} | null;
|
|
43
|
+
declare function parseOklch(input: string): OklchComponents | null;
|
|
40
44
|
/**
|
|
41
45
|
* OKLCH 字面量 → sRGB 三通道(0–255)。
|
|
42
46
|
*
|
|
@@ -50,7 +54,7 @@ declare function oklchToRgb(input: string): Rgb | null;
|
|
|
50
54
|
* @param rgb - sRGB 三通道。
|
|
51
55
|
* @returns 形如 `#ffffff` 的 hex 字符串。
|
|
52
56
|
*/
|
|
53
|
-
declare function rgbToHex(
|
|
57
|
+
declare function rgbToHex(rgb: Rgb): string;
|
|
54
58
|
/**
|
|
55
59
|
* OKLCH 字面量 → `#rrggbb` hex(跨端展示用)。
|
|
56
60
|
*
|
|
@@ -58,11 +62,7 @@ declare function rgbToHex([r, g, b]: Rgb): string;
|
|
|
58
62
|
* @returns hex 字符串;非 oklch 输入返回 null。
|
|
59
63
|
*/
|
|
60
64
|
declare function oklchToHex(input: string): string | null;
|
|
61
|
-
//#endregion
|
|
62
|
-
//#region src/color/palette.d.ts
|
|
63
65
|
/**
|
|
64
|
-
* @module color/palette
|
|
65
|
-
*
|
|
66
66
|
* 将设计令牌的原始色板(OKLCH)整体解析为 hex,供跨端 adapter 在构建期生成
|
|
67
67
|
* 平台可用的调色板。仅解析纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的
|
|
68
68
|
* 运行时表达式跳过(值为 null),由调用方按需忽略。
|
|
@@ -85,11 +85,7 @@ type ResolvedPalette = Readonly<Record<string, string | null | ResolvedScale>>;
|
|
|
85
85
|
* @returns 与输入同形的已解析调色板。
|
|
86
86
|
*/
|
|
87
87
|
declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>): ResolvedPalette;
|
|
88
|
-
//#endregion
|
|
89
|
-
//#region src/color/semantics.d.ts
|
|
90
88
|
/**
|
|
91
|
-
* @module color/semantics
|
|
92
|
-
*
|
|
93
89
|
* 设计令牌语义颜色的静态解析器。
|
|
94
90
|
*
|
|
95
91
|
* 语义色在 `languages/base` 中以 CSS 表达式定义(`var()` 引用、`--alpha()` 透明、
|
|
@@ -102,24 +98,36 @@ declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>):
|
|
|
102
98
|
* - `var(--color-<hue>)` / `var(--color-<hue>-<step>)` — 原始调色板引用(OKLCH 源值);
|
|
103
99
|
* - `var(--<semantic-name>)` — 语义变量间引用(在同主题语义表内递归解析);
|
|
104
100
|
* - `--alpha(<color> / <pct>%)` — 在底色上叠加透明度;
|
|
105
|
-
* - `color-mix(in srgb, <color> <pct>%, <color> [<pct>%])` — sRGB 混色(按 CSS Color 4
|
|
106
|
-
*
|
|
101
|
+
* - `color-mix(in srgb, <color> <pct>%, <color> [<pct>%])` — sRGB 混色(按 CSS Color 4 规范在编码值上线性插值;缺省百分比按
|
|
102
|
+
* 100% − 对方权重补齐,双方均缺省为 50/50);
|
|
107
103
|
* - `oklch(...)` / `#rrggbb` / `#rgb` 字面量。
|
|
108
104
|
*
|
|
109
105
|
* 无法解析的表达式输出 null,由调用方决定回退策略。
|
|
110
106
|
*/
|
|
111
|
-
/**
|
|
112
|
-
|
|
113
|
-
|
|
107
|
+
/**
|
|
108
|
+
* 已解析的 RGBA 颜色(r/g/b 为 0–255,a 为 0–1)。
|
|
109
|
+
*/
|
|
110
|
+
type RgbaColor = {
|
|
111
|
+
/**
|
|
112
|
+
* 红色通道(0–255)。
|
|
113
|
+
*/
|
|
114
114
|
r: number;
|
|
115
|
-
/**
|
|
115
|
+
/**
|
|
116
|
+
* 绿色通道(0–255)。
|
|
117
|
+
*/
|
|
116
118
|
g: number;
|
|
117
|
-
/**
|
|
119
|
+
/**
|
|
120
|
+
* 蓝色通道(0–255)。
|
|
121
|
+
*/
|
|
118
122
|
b: number;
|
|
119
|
-
/**
|
|
123
|
+
/**
|
|
124
|
+
* 透明度(0–1)。
|
|
125
|
+
*/
|
|
120
126
|
a: number;
|
|
121
|
-
}
|
|
122
|
-
/**
|
|
127
|
+
};
|
|
128
|
+
/**
|
|
129
|
+
* 原始调色板输入:纯色(white/black)为字符串,其余色相为色阶记录。
|
|
130
|
+
*/
|
|
123
131
|
type SemanticsPaletteInput = Readonly<Record<string, string | Readonly<Record<string, string>>>>;
|
|
124
132
|
/**
|
|
125
133
|
* 把已解析颜色格式化为平台通用字符串:不透明输出 `#rrggbb`,含透明度输出 `rgba()`。
|
|
@@ -139,90 +147,123 @@ declare function formatColor(color: RgbaColor): string;
|
|
|
139
147
|
* @returns 与输入同键的已解析色值表。
|
|
140
148
|
*/
|
|
141
149
|
declare function resolveSemanticColors(semanticColors: Readonly<Record<string, string>>, palette: SemanticsPaletteInput): Readonly<Record<string, string | null>>;
|
|
142
|
-
//#endregion
|
|
143
|
-
//#region src/hooks/useIsMobile.d.ts
|
|
144
150
|
/**
|
|
145
151
|
* 检测当前是否为移动端视口
|
|
152
|
+
*
|
|
153
|
+
* @returns 视口宽度落在移动端断点内时为 true
|
|
146
154
|
*/
|
|
147
155
|
declare function useIsMobile(): boolean;
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
156
|
+
/**
|
|
157
|
+
* useMediaQuery 的配置选项。
|
|
158
|
+
*/
|
|
159
|
+
type UseMediaQueryOptions = {
|
|
160
|
+
/**
|
|
161
|
+
* 服务端渲染或尚未取值时的缺省匹配结果。
|
|
162
|
+
*/
|
|
151
163
|
defaultValue?: boolean;
|
|
164
|
+
/**
|
|
165
|
+
* 初始化时是否立即读取一次匹配结果。
|
|
166
|
+
*/
|
|
152
167
|
initializeWithValue?: boolean;
|
|
153
|
-
}
|
|
168
|
+
};
|
|
154
169
|
/**
|
|
155
170
|
* 响应式媒体查询 hook
|
|
156
171
|
*
|
|
157
172
|
* @param query - 媒体查询字符串
|
|
158
173
|
* @param options - 配置选项
|
|
174
|
+
* @returns 当前媒体查询是否命中
|
|
159
175
|
*/
|
|
160
176
|
declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
177
|
+
/**
|
|
178
|
+
* useStepper 的配置选项。
|
|
179
|
+
*/
|
|
180
|
+
type UseStepperOptions = {
|
|
181
|
+
/**
|
|
182
|
+
* 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步
|
|
183
|
+
*/
|
|
165
184
|
steps: readonly number[];
|
|
166
|
-
/**
|
|
185
|
+
/**
|
|
186
|
+
* 是否启用步进(默认 true);false 时立即跳到末步
|
|
187
|
+
*/
|
|
167
188
|
enabled?: boolean;
|
|
168
|
-
/**
|
|
189
|
+
/**
|
|
190
|
+
* 完成后是否循环回到第 0 步(默认 false)
|
|
191
|
+
*/
|
|
169
192
|
loop?: boolean;
|
|
170
|
-
/**
|
|
193
|
+
/**
|
|
194
|
+
* 循环重置前的额外等待(毫秒,默认 0)
|
|
195
|
+
*/
|
|
171
196
|
loopDelay?: number;
|
|
172
|
-
}
|
|
197
|
+
};
|
|
173
198
|
/**
|
|
174
199
|
* 序列步进 hook —— 按延迟序列逐步推进步骤索引。
|
|
175
200
|
*
|
|
176
201
|
* 移植自 beautiful-ui 的 useStepper,纯 setTimeout 状态机驱动,不依赖任何动效库。
|
|
177
202
|
* 常见用途:
|
|
203
|
+
*
|
|
178
204
|
* - 列表/网格的 staggered 入场错峰(配合 `animate-fade-up` + `animation-delay`)
|
|
179
205
|
* - 多阶段逐步显现(如 AI 思考链逐步展开)
|
|
180
206
|
* - 循环演示动画
|
|
181
207
|
*
|
|
182
208
|
* 第 i 步触发后等待 `steps[i]` 毫秒进入第 i+1 步,到达末步后停止(或循环)。
|
|
183
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
|
+
*
|
|
184
218
|
* @param options - 步进配置
|
|
185
219
|
* @returns 当前步骤索引(0 起,至 `steps.length - 1` 停止)
|
|
186
|
-
*
|
|
187
|
-
* @example
|
|
188
|
-
* ```tsx
|
|
189
|
-
* const step = useStepper({ steps: [60, 60, 60, 60] });
|
|
190
|
-
* items.map((item, i) => (
|
|
191
|
-
* <li className={i <= step ? 'animate-fade-up' : 'opacity-0'}>{item}</li>
|
|
192
|
-
* ));
|
|
193
|
-
* ```
|
|
194
220
|
*/
|
|
195
221
|
declare function useStepper({ steps, enabled, loop, loopDelay }: UseStepperOptions): number;
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
222
|
+
/**
|
|
223
|
+
* useMagicPill 的配置选项。
|
|
224
|
+
*/
|
|
225
|
+
type UseMagicPillOptions = {
|
|
199
226
|
/**
|
|
200
227
|
* 容器 ref(需为 positioned 元素,子项 offsetTop 相对它计算;
|
|
201
228
|
* 通常给容器加 `relative`)。
|
|
202
229
|
*/
|
|
203
230
|
containerRef: RefObject<HTMLElement | null>;
|
|
204
|
-
/**
|
|
231
|
+
/**
|
|
232
|
+
* 当前激活项的索引
|
|
233
|
+
*/
|
|
205
234
|
activeIndex: number;
|
|
206
235
|
/**
|
|
207
236
|
* 当前悬停项的索引(hover 优先于 active);
|
|
208
237
|
* 传 -1 表示无悬停,回退到 activeIndex。
|
|
209
238
|
*/
|
|
210
239
|
hoverIndex?: number;
|
|
211
|
-
/**
|
|
240
|
+
/**
|
|
241
|
+
* 容器内子项的查询选择器(默认取直接子元素)
|
|
242
|
+
*/
|
|
212
243
|
itemSelector?: string;
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
|
|
244
|
+
};
|
|
245
|
+
/**
|
|
246
|
+
* 高亮 span 的定位状态。
|
|
247
|
+
*/
|
|
248
|
+
type MagicPillPosition = {
|
|
249
|
+
/**
|
|
250
|
+
* 高亮 span 的 top(px,相对容器 offsetParent)
|
|
251
|
+
*/
|
|
216
252
|
top: number;
|
|
217
|
-
/**
|
|
253
|
+
/**
|
|
254
|
+
* 高亮 span 的 height(px)
|
|
255
|
+
*/
|
|
218
256
|
height: number;
|
|
219
|
-
/**
|
|
257
|
+
/**
|
|
258
|
+
* 是否可见(存在有效目标项时为 true)
|
|
259
|
+
*/
|
|
220
260
|
visible: boolean;
|
|
221
|
-
}
|
|
261
|
+
};
|
|
222
262
|
/**
|
|
223
263
|
* 魔药丸高亮 hook —— 测量目标项的位置与尺寸,驱动一个绝对定位的高亮 span 平滑跟随。
|
|
224
264
|
*
|
|
225
265
|
* 移植自 beautiful-ui 的 Magic Pill 交互模式,用于:
|
|
266
|
+
*
|
|
226
267
|
* - 侧边栏 / Tab 栏的高亮指示器
|
|
227
268
|
* - 菜单 / 分段控件的选中项滑动背景
|
|
228
269
|
*
|
|
@@ -230,26 +271,35 @@ interface MagicPillPosition {
|
|
|
230
271
|
* 配合 CSS transition(建议 `transition-[top,height] duration-normal ease-emphasized`)实现滑动。
|
|
231
272
|
* hover 优先于 active:悬停时跟随悬停项,离开后回到激活项。
|
|
232
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
|
+
*
|
|
233
301
|
* @param options - 魔药丸配置
|
|
234
302
|
* @returns 高亮 span 的定位状态
|
|
235
|
-
*
|
|
236
|
-
* @example
|
|
237
|
-
* ```tsx
|
|
238
|
-
* const containerRef = useRef<HTMLUListElement>(null);
|
|
239
|
-
* const [active, setActive] = useState(0);
|
|
240
|
-
* const [hover, setHover] = useState(-1);
|
|
241
|
-
* const pill = useMagicPill({ containerRef, activeIndex: active, hoverIndex: hover });
|
|
242
|
-
* return (
|
|
243
|
-
* <ul ref={containerRef} className="relative">
|
|
244
|
-
* <span aria-hidden style={{ top: pill.top, height: pill.height, opacity: pill.visible ? 1 : 0 }}
|
|
245
|
-
* className="pointer-events-none absolute inset-x-0 rounded-md bg-muted transition-[top,height,opacity] duration-normal ease-emphasized" />
|
|
246
|
-
* {items.map((item, i) => (
|
|
247
|
-
* <li key={i} onMouseEnter={() => setHover(i)} onMouseLeave={() => setHover(-1)} onClick={() => setActive(i)}>{item}</li>
|
|
248
|
-
* ))}
|
|
249
|
-
* </ul>
|
|
250
|
-
* );
|
|
251
|
-
* ```
|
|
252
303
|
*/
|
|
253
304
|
declare function useMagicPill({ containerRef, activeIndex, hoverIndex, itemSelector }: UseMagicPillOptions): MagicPillPosition;
|
|
254
|
-
//#endregion
|
|
255
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(
|
|
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.
|
|
3
|
+
"version": "0.0.5",
|
|
4
4
|
"description": "Longzai Intelligence Design 通用工具层",
|
|
5
5
|
"keywords": [
|
|
6
|
-
"
|
|
6
|
+
"classnames",
|
|
7
7
|
"design",
|
|
8
|
-
"utils",
|
|
9
8
|
"hooks",
|
|
10
|
-
"
|
|
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
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"test
|
|
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.
|
|
39
|
+
"tailwind-merge": "^3.7.0"
|
|
38
40
|
},
|
|
39
41
|
"devDependencies": {
|
|
40
|
-
"@types/react": "^19.
|
|
41
|
-
"react": "^19.
|
|
42
|
+
"@types/react": "^19.3.0",
|
|
43
|
+
"react": "^19.3.1"
|
|
42
44
|
},
|
|
43
45
|
"peerDependencies": {
|
|
44
46
|
"react": ">=18.0.0"
|