@longzai-intelligence-design/utils 0.0.1
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/README.md +17 -0
- package/dist/index.d.ts +255 -0
- package/dist/index.js +1 -0
- package/package.json +46 -0
package/README.md
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# @longzai-intelligence-design/utils
|
|
2
|
+
|
|
3
|
+
## 意图
|
|
4
|
+
|
|
5
|
+
为设计系统各包提供共享工具函数与 React Hooks,使类名合并与响应式判断等通用能力能够被统一复用。
|
|
6
|
+
|
|
7
|
+
## 定位
|
|
8
|
+
|
|
9
|
+
在 Longzai Intelligence Design 项目中作为共享工具层,被 adapters、compositions、blocks 等上层包依赖,是设计系统的基础设施之一。
|
|
10
|
+
|
|
11
|
+
## 职能
|
|
12
|
+
|
|
13
|
+
提供 cn() 类名合并工具,基于 clsx 与 tailwind-merge 解决 Tailwind 类名冲突;提供响应式 Hooks(useMediaQuery / useIsMobile);提供交互步进与魔法人 pill Hooks(useStepper / useMagicPill);提供 OKLCH→hex 颜色转换(oklchToHex / resolvePaletteHex),将设计令牌原始 OKLCH 色板解析为跨端(RN / 小程序)可消费的 hex,供跨端 adapter 复用。
|
|
14
|
+
|
|
15
|
+
## 实现情况
|
|
16
|
+
|
|
17
|
+
已实现,包含类名合并工具、四个 Hooks 与颜色转换模块(含单测),可作为设计系统各包的通用工具来源。
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
import { ClassValue } from "clsx";
|
|
2
|
+
import { RefObject } from "react";
|
|
3
|
+
//#region src/cn.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* 合并 CSS 类名
|
|
6
|
+
*
|
|
7
|
+
* 智能处理 Tailwind CSS 类名冲突,后面的类名会覆盖前面的同名类
|
|
8
|
+
*/
|
|
9
|
+
declare function cn(...inputs: ClassValue[]): string;
|
|
10
|
+
//#endregion
|
|
11
|
+
//#region src/color/oklch.d.ts
|
|
12
|
+
/**
|
|
13
|
+
* @module color/oklch
|
|
14
|
+
*
|
|
15
|
+
* OKLCH 颜色空间到 sRGB(hex) 的转换。
|
|
16
|
+
*
|
|
17
|
+
* 设计令牌的原始色板以 OKLCH(与 Tailwind v4 一致)定义,但 React Native /
|
|
18
|
+
* 小程序等非浏览器运行时无法解析 oklch()/var()/color-mix()。本模块提供标准
|
|
19
|
+
* OKLCH→线性 sRGB→sRGB→hex 的纯函数转换(算法依据 CSS Color 4 / Björn Ottosson
|
|
20
|
+
* OKLab),供跨端 adapter 在构建期把原始色板解析为平台可用的 hex。
|
|
21
|
+
*
|
|
22
|
+
* 仅处理纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的语义色需运行时背景,
|
|
23
|
+
* 不在此解析(返回 null 由调用方跳过)。
|
|
24
|
+
*/
|
|
25
|
+
/** sRGB 三通道(0–255,已做 gamma 编码)。 */
|
|
26
|
+
type Rgb = [r: number, g: number, b: number];
|
|
27
|
+
/**
|
|
28
|
+
* 解析 oklch() 字面量为 { L, C, H }。
|
|
29
|
+
*
|
|
30
|
+
* 支持百分比明度(`98.5%` → 0.985)与裸数值明度(`0.62`)。色相单位为度。
|
|
31
|
+
*
|
|
32
|
+
* @param input - 颜色字符串,如 `oklch(71.1% 0.166 22)`。
|
|
33
|
+
* @returns 解析结果,非 oklch 输入返回 null。
|
|
34
|
+
*/
|
|
35
|
+
declare function parseOklch(input: string): {
|
|
36
|
+
l: number;
|
|
37
|
+
c: number;
|
|
38
|
+
h: number;
|
|
39
|
+
} | null;
|
|
40
|
+
/**
|
|
41
|
+
* OKLCH 字面量 → sRGB 三通道(0–255)。
|
|
42
|
+
*
|
|
43
|
+
* @param input - OKLCH 颜色字符串。
|
|
44
|
+
* @returns sRGB 三通道;非 oklch 输入返回 null。
|
|
45
|
+
*/
|
|
46
|
+
declare function oklchToRgb(input: string): Rgb | null;
|
|
47
|
+
/**
|
|
48
|
+
* sRGB 三通道(0–255)→ `#rrggbb` 小写 hex。
|
|
49
|
+
*
|
|
50
|
+
* @param rgb - sRGB 三通道。
|
|
51
|
+
* @returns 形如 `#ffffff` 的 hex 字符串。
|
|
52
|
+
*/
|
|
53
|
+
declare function rgbToHex([r, g, b]: Rgb): string;
|
|
54
|
+
/**
|
|
55
|
+
* OKLCH 字面量 → `#rrggbb` hex(跨端展示用)。
|
|
56
|
+
*
|
|
57
|
+
* @param input - OKLCH 颜色字符串。
|
|
58
|
+
* @returns hex 字符串;非 oklch 输入返回 null。
|
|
59
|
+
*/
|
|
60
|
+
declare function oklchToHex(input: string): string | null;
|
|
61
|
+
//#endregion
|
|
62
|
+
//#region src/color/palette.d.ts
|
|
63
|
+
/**
|
|
64
|
+
* @module color/palette
|
|
65
|
+
*
|
|
66
|
+
* 将设计令牌的原始色板(OKLCH)整体解析为 hex,供跨端 adapter 在构建期生成
|
|
67
|
+
* 平台可用的调色板。仅解析纯 OKLCH 字面量;含 var()/color-mix()/--alpha() 的
|
|
68
|
+
* 运行时表达式跳过(值为 null),由调用方按需忽略。
|
|
69
|
+
*/
|
|
70
|
+
/**
|
|
71
|
+
* 已解析的色阶(键 = 色阶名,值 = hex 或 null)。
|
|
72
|
+
*/
|
|
73
|
+
type ResolvedScale = Readonly<Record<string, string | null>>;
|
|
74
|
+
/**
|
|
75
|
+
* 已解析的调色板(与原始色板同形,字符串项或色阶对象均转为 hex / hex 色阶)。
|
|
76
|
+
*/
|
|
77
|
+
type ResolvedPalette = Readonly<Record<string, string | null | ResolvedScale>>;
|
|
78
|
+
/**
|
|
79
|
+
* 将原始调色板整体解析为 hex 结构。
|
|
80
|
+
*
|
|
81
|
+
* 输入形如 `{ white: 'oklch(...)', neutral: { '50': 'oklch(...)', ... }, red: {...} }`,
|
|
82
|
+
* 输出保持同形:单值项 → hex|null,色阶对象 → hex 色阶。
|
|
83
|
+
*
|
|
84
|
+
* @param palette - 原始调色板(来自 @longzai-intelligence-design/base 的 palette)。
|
|
85
|
+
* @returns 与输入同形的已解析调色板。
|
|
86
|
+
*/
|
|
87
|
+
declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>): ResolvedPalette;
|
|
88
|
+
//#endregion
|
|
89
|
+
//#region src/color/semantics.d.ts
|
|
90
|
+
/**
|
|
91
|
+
* @module color/semantics
|
|
92
|
+
*
|
|
93
|
+
* 设计令牌语义颜色的静态解析器。
|
|
94
|
+
*
|
|
95
|
+
* 语义色在 `languages/base` 中以 CSS 表达式定义(`var()` 引用、`--alpha()` 透明、
|
|
96
|
+
* `color-mix()` 混色),浏览器运行时可直接求值,但 React Native / 小程序等非
|
|
97
|
+
* 浏览器运行时无法解析。本模块在构建期把这些表达式静态解析为平台通用的
|
|
98
|
+
* hex / rgba() 字面量,供跨端 adapter 的语义色产物管线消费。
|
|
99
|
+
*
|
|
100
|
+
* 支持的表达式形态(与 `languages/base/src/tokens/colors.ts` 的实际用法对齐):
|
|
101
|
+
*
|
|
102
|
+
* - `var(--color-<hue>)` / `var(--color-<hue>-<step>)` — 原始调色板引用(OKLCH 源值);
|
|
103
|
+
* - `var(--<semantic-name>)` — 语义变量间引用(在同主题语义表内递归解析);
|
|
104
|
+
* - `--alpha(<color> / <pct>%)` — 在底色上叠加透明度;
|
|
105
|
+
* - `color-mix(in srgb, <color> <pct>%, <color> [<pct>%])` — sRGB 混色(按 CSS Color 4
|
|
106
|
+
* 规范在编码值上线性插值;缺省百分比按 100% − 对方权重补齐,双方均缺省为 50/50);
|
|
107
|
+
* - `oklch(...)` / `#rrggbb` / `#rgb` 字面量。
|
|
108
|
+
*
|
|
109
|
+
* 无法解析的表达式输出 null,由调用方决定回退策略。
|
|
110
|
+
*/
|
|
111
|
+
/** 已解析的 RGBA 颜色(r/g/b 为 0–255,a 为 0–1)。 */
|
|
112
|
+
interface RgbaColor {
|
|
113
|
+
/** 红色通道(0–255)。 */
|
|
114
|
+
r: number;
|
|
115
|
+
/** 绿色通道(0–255)。 */
|
|
116
|
+
g: number;
|
|
117
|
+
/** 蓝色通道(0–255)。 */
|
|
118
|
+
b: number;
|
|
119
|
+
/** 透明度(0–1)。 */
|
|
120
|
+
a: number;
|
|
121
|
+
}
|
|
122
|
+
/** 原始调色板输入:纯色(white/black)为字符串,其余色相为色阶记录。 */
|
|
123
|
+
type SemanticsPaletteInput = Readonly<Record<string, string | Readonly<Record<string, string>>>>;
|
|
124
|
+
/**
|
|
125
|
+
* 把已解析颜色格式化为平台通用字符串:不透明输出 `#rrggbb`,含透明度输出 `rgba()`。
|
|
126
|
+
*
|
|
127
|
+
* @param color - 已解析颜色。
|
|
128
|
+
* @returns hex 或 rgba() 字符串。
|
|
129
|
+
*/
|
|
130
|
+
declare function formatColor(color: RgbaColor): string;
|
|
131
|
+
/**
|
|
132
|
+
* 将一个主题的语义颜色表整体静态解析为平台通用色值。
|
|
133
|
+
*
|
|
134
|
+
* 输入键保持原样(camelCase),值由 CSS 表达式解析为 hex / rgba();不可解析的
|
|
135
|
+
* 表达式输出 null(键保留),由消费方决定回退策略。
|
|
136
|
+
*
|
|
137
|
+
* @param semanticColors - 同主题语义色表(原始 CSS 表达式,来自 design tokens)。
|
|
138
|
+
* @param palette - 原始调色板(来自 `@longzai-intelligence-design/base` 的 palette)。
|
|
139
|
+
* @returns 与输入同键的已解析色值表。
|
|
140
|
+
*/
|
|
141
|
+
declare function resolveSemanticColors(semanticColors: Readonly<Record<string, string>>, palette: SemanticsPaletteInput): Readonly<Record<string, string | null>>;
|
|
142
|
+
//#endregion
|
|
143
|
+
//#region src/hooks/use-is-mobile.d.ts
|
|
144
|
+
/**
|
|
145
|
+
* 检测当前是否为移动端视口
|
|
146
|
+
*/
|
|
147
|
+
declare function useIsMobile(): boolean;
|
|
148
|
+
//#endregion
|
|
149
|
+
//#region src/hooks/use-media-query.d.ts
|
|
150
|
+
interface UseMediaQueryOptions {
|
|
151
|
+
defaultValue?: boolean;
|
|
152
|
+
initializeWithValue?: boolean;
|
|
153
|
+
}
|
|
154
|
+
/**
|
|
155
|
+
* 响应式媒体查询 hook
|
|
156
|
+
*
|
|
157
|
+
* @param query - 媒体查询字符串
|
|
158
|
+
* @param options - 配置选项
|
|
159
|
+
*/
|
|
160
|
+
declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
|
|
161
|
+
//#endregion
|
|
162
|
+
//#region src/hooks/use-stepper.d.ts
|
|
163
|
+
interface UseStepperOptions {
|
|
164
|
+
/** 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步 */
|
|
165
|
+
steps: readonly number[];
|
|
166
|
+
/** 是否启用步进(默认 true);false 时立即跳到末步 */
|
|
167
|
+
enabled?: boolean;
|
|
168
|
+
/** 完成后是否循环回到第 0 步(默认 false) */
|
|
169
|
+
loop?: boolean;
|
|
170
|
+
/** 循环重置前的额外等待(毫秒,默认 0) */
|
|
171
|
+
loopDelay?: number;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* 序列步进 hook —— 按延迟序列逐步推进步骤索引。
|
|
175
|
+
*
|
|
176
|
+
* 移植自 beautiful-ui 的 useStepper,纯 setTimeout 状态机驱动,不依赖任何动效库。
|
|
177
|
+
* 常见用途:
|
|
178
|
+
* - 列表/网格的 staggered 入场错峰(配合 `animate-fade-up` + `animation-delay`)
|
|
179
|
+
* - 多阶段逐步显现(如 AI 思考链逐步展开)
|
|
180
|
+
* - 循环演示动画
|
|
181
|
+
*
|
|
182
|
+
* 第 i 步触发后等待 `steps[i]` 毫秒进入第 i+1 步,到达末步后停止(或循环)。
|
|
183
|
+
*
|
|
184
|
+
* @param options - 步进配置
|
|
185
|
+
* @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
|
+
*/
|
|
195
|
+
declare function useStepper({ steps, enabled, loop, loopDelay }: UseStepperOptions): number;
|
|
196
|
+
//#endregion
|
|
197
|
+
//#region src/hooks/use-magic-pill.d.ts
|
|
198
|
+
interface UseMagicPillOptions {
|
|
199
|
+
/**
|
|
200
|
+
* 容器 ref(需为 positioned 元素,子项 offsetTop 相对它计算;
|
|
201
|
+
* 通常给容器加 `relative`)。
|
|
202
|
+
*/
|
|
203
|
+
containerRef: RefObject<HTMLElement | null>;
|
|
204
|
+
/** 当前激活项的索引 */
|
|
205
|
+
activeIndex: number;
|
|
206
|
+
/**
|
|
207
|
+
* 当前悬停项的索引(hover 优先于 active);
|
|
208
|
+
* 传 -1 表示无悬停,回退到 activeIndex。
|
|
209
|
+
*/
|
|
210
|
+
hoverIndex?: number;
|
|
211
|
+
/** 容器内子项的查询选择器(默认取直接子元素) */
|
|
212
|
+
itemSelector?: string;
|
|
213
|
+
}
|
|
214
|
+
interface MagicPillPosition {
|
|
215
|
+
/** 高亮 span 的 top(px,相对容器 offsetParent) */
|
|
216
|
+
top: number;
|
|
217
|
+
/** 高亮 span 的 height(px) */
|
|
218
|
+
height: number;
|
|
219
|
+
/** 是否可见(存在有效目标项时为 true) */
|
|
220
|
+
visible: boolean;
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* 魔药丸高亮 hook —— 测量目标项的位置与尺寸,驱动一个绝对定位的高亮 span 平滑跟随。
|
|
224
|
+
*
|
|
225
|
+
* 移植自 beautiful-ui 的 Magic Pill 交互模式,用于:
|
|
226
|
+
* - 侧边栏 / Tab 栏的高亮指示器
|
|
227
|
+
* - 菜单 / 分段控件的选中项滑动背景
|
|
228
|
+
*
|
|
229
|
+
* 调用方在容器内渲染一个 `aria-hidden` 的绝对定位 span,以返回的 `top` / `height` 定位,
|
|
230
|
+
* 配合 CSS transition(建议 `transition-[top,height] duration-normal ease-emphasized`)实现滑动。
|
|
231
|
+
* hover 优先于 active:悬停时跟随悬停项,离开后回到激活项。
|
|
232
|
+
*
|
|
233
|
+
* @param options - 魔药丸配置
|
|
234
|
+
* @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
|
+
*/
|
|
253
|
+
declare function useMagicPill({ containerRef, activeIndex, hoverIndex, itemSelector }: UseMagicPillOptions): MagicPillPosition;
|
|
254
|
+
//#endregion
|
|
255
|
+
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
ADDED
|
@@ -0,0 +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: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};
|
package/package.json
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@longzai-intelligence-design/utils",
|
|
3
|
+
"version": "0.0.1",
|
|
4
|
+
"license": "UNLICENSED",
|
|
5
|
+
"files": [
|
|
6
|
+
"dist"
|
|
7
|
+
],
|
|
8
|
+
"type": "module",
|
|
9
|
+
"main": "./dist/index.js",
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"exports": {
|
|
12
|
+
".": {
|
|
13
|
+
"types": "./dist/index.d.ts",
|
|
14
|
+
"import": "./dist/index.js"
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"scripts": {
|
|
18
|
+
"build": "lzi-builder",
|
|
19
|
+
"build:prod": "NODE_ENV=production bun run build",
|
|
20
|
+
"prepublishOnly": "bun run build:prod",
|
|
21
|
+
"dev": "lzi-builder --watch",
|
|
22
|
+
"typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
|
|
23
|
+
"typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
|
|
24
|
+
"typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
|
|
25
|
+
"typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
|
|
26
|
+
"clean": "lzi-dev-cli clean",
|
|
27
|
+
"test": "vitest run",
|
|
28
|
+
"test:watch": "vitest"
|
|
29
|
+
},
|
|
30
|
+
"dependencies": {
|
|
31
|
+
"clsx": "^2.1.1",
|
|
32
|
+
"tailwind-merge": "^3.5.0"
|
|
33
|
+
},
|
|
34
|
+
"devDependencies": {
|
|
35
|
+
"@types/react": "^19.2.14",
|
|
36
|
+
"react": "^19.2.5"
|
|
37
|
+
},
|
|
38
|
+
"peerDependencies": {
|
|
39
|
+
"react": ">=18.0.0"
|
|
40
|
+
},
|
|
41
|
+
"peerDependenciesMeta": {
|
|
42
|
+
"react": {
|
|
43
|
+
"optional": true
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|