@longzai-intelligence-design/utils 0.0.2 → 0.0.4

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
@@ -1,14 +1,11 @@
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
  * 智能处理 Tailwind CSS 类名冲突,后面的类名会覆盖前面的同名类
8
7
  */
9
8
  declare function cn(...inputs: ClassValue[]): string;
10
- //#endregion
11
- //#region src/color/oklch.d.ts
12
9
  /**
13
10
  * @module color/oklch
14
11
  *
@@ -58,8 +55,6 @@ declare function rgbToHex([r, g, b]: Rgb): string;
58
55
  * @returns hex 字符串;非 oklch 输入返回 null。
59
56
  */
60
57
  declare function oklchToHex(input: string): string | null;
61
- //#endregion
62
- //#region src/color/palette.d.ts
63
58
  /**
64
59
  * @module color/palette
65
60
  *
@@ -85,8 +80,6 @@ type ResolvedPalette = Readonly<Record<string, string | null | ResolvedScale>>;
85
80
  * @returns 与输入同形的已解析调色板。
86
81
  */
87
82
  declare function resolvePaletteHex(palette: Readonly<Record<string, unknown>>): ResolvedPalette;
88
- //#endregion
89
- //#region src/color/semantics.d.ts
90
83
  /**
91
84
  * @module color/semantics
92
85
  *
@@ -139,14 +132,10 @@ declare function formatColor(color: RgbaColor): string;
139
132
  * @returns 与输入同键的已解析色值表。
140
133
  */
141
134
  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
135
  /**
145
136
  * 检测当前是否为移动端视口
146
137
  */
147
138
  declare function useIsMobile(): boolean;
148
- //#endregion
149
- //#region src/hooks/useMediaQuery.d.ts
150
139
  interface UseMediaQueryOptions {
151
140
  defaultValue?: boolean;
152
141
  initializeWithValue?: boolean;
@@ -158,8 +147,6 @@ interface UseMediaQueryOptions {
158
147
  * @param options - 配置选项
159
148
  */
160
149
  declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
161
- //#endregion
162
- //#region src/hooks/useStepper.d.ts
163
150
  interface UseStepperOptions {
164
151
  /** 各步骤的间隔延迟(毫秒):第 i 步完成后等待 steps[i] ms 再进入第 i+1 步 */
165
152
  steps: readonly number[];
@@ -193,8 +180,6 @@ interface UseStepperOptions {
193
180
  * ```
194
181
  */
195
182
  declare function useStepper({ steps, enabled, loop, loopDelay }: UseStepperOptions): number;
196
- //#endregion
197
- //#region src/hooks/useMagicPill.d.ts
198
183
  interface UseMagicPillOptions {
199
184
  /**
200
185
  * 容器 ref(需为 positioned 元素,子项 offsetTop 相对它计算;
@@ -251,5 +236,4 @@ interface MagicPillPosition {
251
236
  * ```
252
237
  */
253
238
  declare function useMagicPill({ containerRef, activeIndex, hoverIndex, itemSelector }: UseMagicPillOptions): MagicPillPosition;
254
- //#endregion
255
239
  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: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,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};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@longzai-intelligence-design/utils",
3
- "version": "0.0.2",
3
+ "version": "0.0.4",
4
4
  "description": "Longzai Intelligence Design 通用工具层",
5
5
  "keywords": [
6
6
  "longzai-intelligence",
@@ -27,10 +27,7 @@
27
27
  "build:prod": "NODE_ENV=production bun run build",
28
28
  "prepublishOnly": "bun run build:prod",
29
29
  "dev": "lzi-builder --watch",
30
- "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
31
- "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
32
- "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
33
- "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
30
+ "typecheck": "lzi-typecheck",
34
31
  "clean": "lzi-dev-cli clean",
35
32
  "test": "vitest run",
36
33
  "test:watch": "vitest"