@longzai-intelligence-design/utils 0.0.1 → 0.0.2

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 CHANGED
@@ -1,17 +1,14 @@
1
1
  # @longzai-intelligence-design/utils
2
2
 
3
- ## 意图
3
+ Longzai Intelligence Design 的通用工具层,提供设计系统各包共享的工具函数与 React Hooks。
4
4
 
5
- 为设计系统各包提供共享工具函数与 React Hooks,使类名合并与响应式判断等通用能力能够被统一复用。
5
+ ## 简介
6
6
 
7
- ## 定位
7
+ 治理通用能力分散复用的问题:类名合并、响应式判断等基础能力由本包统一提供,作为设计系统的基础设施被各上层包依赖。
8
8
 
9
- 在 Longzai Intelligence Design 项目中作为共享工具层,被 adapters、compositions、blocks 等上层包依赖,是设计系统的基础设施之一。
9
+ ## 能力
10
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 与颜色转换模块(含单测),可作为设计系统各包的通用工具来源。
11
+ - 类名合并:解决 Tailwind 类名冲突
12
+ - 响应式 Hooks:媒体查询与移动端判断
13
+ - 交互 Hooks:步进与 pill 交互
14
+ - OKLCH→hex 颜色转换:将设计令牌原始色板解析为跨端可消费的 hex,供跨端适配层复用
package/dist/index.d.ts CHANGED
@@ -140,13 +140,13 @@ declare function formatColor(color: RgbaColor): string;
140
140
  */
141
141
  declare function resolveSemanticColors(semanticColors: Readonly<Record<string, string>>, palette: SemanticsPaletteInput): Readonly<Record<string, string | null>>;
142
142
  //#endregion
143
- //#region src/hooks/use-is-mobile.d.ts
143
+ //#region src/hooks/useIsMobile.d.ts
144
144
  /**
145
145
  * 检测当前是否为移动端视口
146
146
  */
147
147
  declare function useIsMobile(): boolean;
148
148
  //#endregion
149
- //#region src/hooks/use-media-query.d.ts
149
+ //#region src/hooks/useMediaQuery.d.ts
150
150
  interface UseMediaQueryOptions {
151
151
  defaultValue?: boolean;
152
152
  initializeWithValue?: boolean;
@@ -159,7 +159,7 @@ interface UseMediaQueryOptions {
159
159
  */
160
160
  declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
161
161
  //#endregion
162
- //#region src/hooks/use-stepper.d.ts
162
+ //#region src/hooks/useStepper.d.ts
163
163
  interface UseStepperOptions {
164
164
  /** 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步 */
165
165
  steps: readonly number[];
@@ -194,7 +194,7 @@ interface UseStepperOptions {
194
194
  */
195
195
  declare function useStepper({ steps, enabled, loop, loopDelay }: UseStepperOptions): number;
196
196
  //#endregion
197
- //#region src/hooks/use-magic-pill.d.ts
197
+ //#region src/hooks/useMagicPill.d.ts
198
198
  interface UseMagicPillOptions {
199
199
  /**
200
200
  * 容器 ref(需为 positioned 元素,子项 offsetTop 相对它计算;
package/package.json CHANGED
@@ -1,6 +1,14 @@
1
1
  {
2
2
  "name": "@longzai-intelligence-design/utils",
3
- "version": "0.0.1",
3
+ "version": "0.0.2",
4
+ "description": "Longzai Intelligence Design 通用工具层",
5
+ "keywords": [
6
+ "longzai-intelligence",
7
+ "design",
8
+ "utils",
9
+ "hooks",
10
+ "classnames"
11
+ ],
4
12
  "license": "UNLICENSED",
5
13
  "files": [
6
14
  "dist"