@cmtlyt/lingshu-toolkit 0.5.0 → 0.6.0

package/README.md

@@ -11,3 +11,13 @@
 然后 shadcn 可以提供很好的定制化, 而且 npm 包有 bug 的话也可以通过 shadcn 拉取并修改, 修改完成后还能通过 pr 的方式重新提交回 npm 包, 这样就可以获取 npm 包的长期维护能力了
 
 shadcn 的安装方式可以通过[官方文档](https://cmtlyt.github.io/lingshu-toolkit/)查看, 文档后续会慢慢完善的
+
+## AI 支持
+
+AI 用户可以通过在 AGENTS.md 或者 CLAUDE.md 等 AI 文件中添加 [llms.txt](https://cmtlyt.github.io/lingshu-toolkit/llms.txt) 来让 AI 可以自动获取 lingshu-toolkit 的文档
+
+```md
+## Docs
+
+- @cmtlyt/lingshu-toolkit: https://cmtlyt.github.io/lingshu-toolkit/llms.txt
+```

package/dist/665.js

@@ -0,0 +1 @@
+function r(n,t,e=Error){return new e(`[@cmtlyt/lingshu-toolkit#${n}]: ${t}`)}function n(t,e,o=Error){throw r(t,e,o)}function t(r,t){n(r,t,TypeError)}function e(r){return"symbol"==typeof r}function o(r){return void 0===r}function i(r){return null===r}function u(r){return i(r)||o(r)}function s(r){return Number.isNaN(r)}function l(r){return e(r)&&o(Symbol.keyFor(r))}function a(r){return"object"==typeof r&&!i(r)}function f(r){return a(r)&&!c(r)}function c(r){return Array.isArray(r)}function y(r){return c(r)&&0===r.length}function d(r){return"string"==typeof r}function m(r){return d(r)&&0===r.length}function b(r){return"number"==typeof r}function g(r){return b(r)&&!s(r)}function h(r){return d(r)||b(r)||e(r)}function p(r){return"boolean"==typeof r}function N(r){return!0===r||d(r)&&"true"===r.toLowerCase()}function E(r){return!1===r||d(r)&&"false"===r.toLowerCase()}function w(r){return!!r}function $(r){return!(s(r)||r)}function v(r){return"function"==typeof r}function S(r){return(a(r)||v(r))&&v(r.then)}let T=new Proxy(console,{get(r,n,t){if((globalThis.$$lingshu$$||{}).disableLogger)return()=>void 0;let e=Reflect.get(r,n,t).bind(console);return(r,...n)=>{e(`[@cmtlyt/lingshu-toolkit#${r}]:`,...n)}}}),K=()=>void 0,j=r=>r;function A(r){return Object.prototype.toString.call(r).slice(8,-1).toLowerCase()}function P(r,n){return t=>(e,o)=>{if(n?n(e):A(e)===r)return!0;if(u(t))return!1;let i=t;"function"==typeof t&&(i=t(e)),o.transform(i)}}let L={notNullable:P("notNullable",r=>!u(r)),string:P("string"),validString:P("validString",r=>"string"==typeof r&&r.length>0),number:P("number"),validNumber:P("validNumber",r=>"number"==typeof r&&!Number.isNaN(r)),boolean:P("boolean"),object:P("object"),array:P("array"),function:P("function"),symbol:P("symbol"),enum:(r,n)=>{Array.isArray(r)||t("$t.enum","list must be an array");let e=new Set(r);return P("enum",r=>e.has(r))(n)}};function k(r){let n={},t=Reflect.ownKeys(r);for(let e=0,o=t[e],i=r[o];e<t.length;i=r[o=t[++e]]){if("function"==typeof i){n[o]=i;continue}let r=L[i];if(!r){T.warn("defineTransform",`${i} is not a valid type`);continue}n[o]=r()}return n}function F(r,n,e){let o,i;n||t("dataHandler","handler is required");let{strict:u=!1,errorHandler:s,defaultValue:l,unwrap:a=!1}=e||{},f="function"==typeof n,c=f?n:(r,t,...e)=>n[t](r,...e),d={...l,...r},m=f?Reflect.ownKeys(r):Reflect.ownKeys(n),[b,g,h]=(o={errors:[],transforms:[],handledErrorKeys:new Set},i={addError(r,n=`${String(r)} is not valid`){o.handledErrorKeys.has(r)||(o.handledErrorKeys.add(r),o.errors.push(n))},addTransform(r,n){o.transforms.push([r,n])}},[o,i,r=>({assert:(n,t=`${String(r)} is not valid`)=>(n||i.addError(r,t),n),transform:n=>(o.handledErrorKeys.has(r)||i.addTransform(r,n),n)})]);for(let r=0,n=m[r];r<m.length;n=m[++r])!1===c(d[n],n,h(n),d)&&g.addError(n);p=b.errors,!y(p)&&(s?s(p):u&&t("dataHandler",p.join("\n")));var p,N=b.transforms;if(!y(N))for(let r=0,[n,t]=N[r];r<N.length;[n,t]=N[++r]||[])d[n]=t;return!function(r,n,t={}){n.handledErrorKeys.forEach(n=>{r[n]=t[n]})}(d,b,l),a?d:{result:d,errors:b.errors}}export{L as $t,r as createError,F as dataHandler,k as $dt,A as getType,j as identity,c as isArray,p as isBoolean,y as isEmptyArray,m as isEmptyString,E as isFalse,$ as isFalsy,v as isFunction,i as isNull,u as isNullOrUndef,b as isNumber,a as isObject,g as isPlainNumber,f as isPlainObject,l as isPlainSymbol,S as isPromiseLike,h as isPropertyKey,d as isString,e as isSymbol,N as isTrue,w as isTruthy,o as isUndef,T as logger,K as noop,n as throwError,t as throwType,s as isNaN};

package/dist/893.js

@@ -0,0 +1 @@
+import{dataHandler as e,logger as t,$dt as a,throwError as r,isNullOrUndef as o,$t as l}from"./665.js";let n=a({storageKey:"validString",storageType:l.enum(["local","session","memory"],"local"),autoSaveInterval:l.number(0)}),s={data:{},getItem(e){return this.data[e]},setItem(e,t){this.data[e]=t},removeItem(e){delete this.data[e]}},m=Symbol("cleared");function i(a,l,d={}){let{storageKey:g,storageType:c,autoSaveInterval:S}=e({storageKey:a,...d},n,{unwrap:!0}),u=function(e){try{if("memory"===e)return s;return"local"===e?localStorage:sessionStorage}catch{return t.warn("createStorage","Failed to access localStorage or sessionStorage, using memoryStorage instead."),s}}(c),y=u.getItem(g),I={data:y?JSON.parse(y):l||{},timer:null},f=()=>{null!==I.timer&&(clearTimeout(I.timer),I.timer=null)};return{get:e=>(I.data===m&&r("createStorageHandler","Storage has been cleared."),o(e))?I.data:I.data[e],set(e,t){I.data===m&&r("createStorageHandler","Storage has been cleared."),o(t)?I.data=e:I.data[t]=e,S>0?(f(),I.timer=setTimeout(()=>{u.setItem(g,JSON.stringify(I.data))},S)):u.setItem(g,JSON.stringify(I.data))},clear(){f(),I.data=m,u.removeItem(g)}}}export{i as createStorageHandler};

package/dist/react/index.js

@@ -1,205 +1 @@
-import { useEffect, useEffectEvent, useMemo, useReducer, useRef, useState } from "react";
-import { dataHandler, logger, $dt, $t, throwType } from "../707.js";
-import { createStorageHandler } from "../247.js";
-function useToggle(defualtValue = false, reverseValue) {
-    const [state, setState] = useState(defualtValue);
-    const toggleRef = useRef([
-        defualtValue,
-        void 0 === reverseValue ? !defualtValue : reverseValue
-    ]);
-    const actions = useMemo(()=>{
-        const [left, right] = toggleRef.current;
-        return {
-            set: (value)=>{
-                if (value !== left && value !== right) throwType('useToggle', 'value is not left or right');
-                setState(value);
-            },
-            setLeft: ()=>setState(left),
-            setRight: ()=>setState(right),
-            toggle: ()=>setState((prev)=>prev === left ? right : left)
-        };
-    }, []);
-    return [
-        state,
-        actions
-    ];
-}
-function useBoolean(defaultValue = false) {
-    const [state, { toggle, set }] = useToggle(!!defaultValue);
-    const actions = useMemo(()=>({
-            toggle,
-            setTrue: ()=>set(true),
-            setFalse: ()=>set(false),
-            set: (value)=>set(!!value)
-        }), []);
-    return [
-        state,
-        actions
-    ];
-}
-function useValidData(data, verifyInfo, options) {
-    const verifyInfoRef = useRef(verifyInfo);
-    const optionsRef = useRef(options);
-    return useMemo(()=>dataHandler(data, verifyInfoRef.current, {
-            unwrap: true,
-            ...optionsRef.current
-        }), [
-        data
-    ]);
-}
-const validInfo = $dt({
-    defaultValuePropName: $t.validString('defaultValue'),
-    valuePropName: $t.validString('value'),
-    trigger: $t.validString('onChange')
-});
-function useControllableValue(props = {}, options = {}) {
-    const { defaultValue: _defaultValue, trigger, valuePropName, defaultValuePropName } = useValidData(options, validInfo);
-    const { [valuePropName]: propValue, [defaultValuePropName]: defaultValue = _defaultValue, [trigger]: emitChange } = props;
-    const hasValueRef = useRef(Boolean(Reflect.getOwnPropertyDescriptor(props, valuePropName)));
-    const isFirstRenderRef = useRef(true);
-    const [ctrlValue, setCtrlValue] = useState(hasValueRef.current ? propValue : defaultValue);
-    const setValue = useEffectEvent((value, ...args)=>{
-        if ('function' == typeof emitChange) emitChange(value, ...args);
-        if (!hasValueRef.current) setCtrlValue(value);
-    });
-    useEffect(()=>{
-        if (isFirstRenderRef.current || !hasValueRef.current) {
-            isFirstRenderRef.current = false;
-            return;
-        }
-        setCtrlValue(propValue);
-    }, [
-        propValue
-    ]);
-    return [
-        ctrlValue,
-        setValue
-    ];
-}
-function getRealValue(value, options) {
-    const { min, max } = options;
-    return Math.min(Math.max(value, min), max);
-}
-function nanTransform(_dv) {
-    return (_v)=>{
-        if (void 0 === _v) return _dv;
-        logger.warn('useCounter', 'value is not a number', _v, 'useCounter will use default value');
-        const numV = Number(_v);
-        if (Number.isNaN(numV)) return _dv;
-        return numV;
-    };
-}
-const use_counter_validInfo = $dt({
-    min: $t.validNumber(nanTransform(-1 / 0)),
-    max: $t.validNumber(nanTransform(1 / 0)),
-    step: $t.validNumber(nanTransform(1))
-});
-function useCounter(initialValue = 0, options = {}) {
-    const validOptions = useValidData(options, use_counter_validInfo);
-    const { step } = validOptions;
-    const initialValueRef = useRef(getRealValue(Number(initialValue), validOptions));
-    const [current, setCurrent] = useState(getRealValue(Number(initialValue), validOptions));
-    const setValue = useEffectEvent((value)=>{
-        setCurrent(()=>getRealValue('function' == typeof value ? value(current) : value, validOptions));
-    });
-    const actions = useMemo(()=>{
-        const _step = Math.abs(step);
-        const increment = (delta = _step)=>setValue((prev)=>prev + delta);
-        const decrement = (delta = _step)=>setValue((prev)=>prev - delta);
-        const reset = ()=>setCurrent(initialValueRef.current);
-        return {
-            increment,
-            decrement,
-            reset,
-            set: setValue
-        };
-    }, [
-        step
-    ]);
-    return [
-        current,
-        actions
-    ];
-}
-function useForceUpdate() {
-    const [, forceUpdate] = useReducer((prev)=>(prev + 1) % 10, 0);
-    return forceUpdate;
-}
-function useMount(callback) {
-    const callbackRef = useRef(callback);
-    useEffect(()=>{
-        dataHandler({
-            fn: callbackRef.current
-        }, {
-            fn: $t["function"]()
-        }, {
-            strict: true
-        });
-        callbackRef.current();
-    }, []);
-}
-const clone = structuredClone;
-function useRefState(initialState) {
-    const stateRef = useRef(initialState);
-    const forceUpdate = useForceUpdate();
-    const ctrl = useMemo(()=>{
-        const origin = clone(stateRef.current);
-        const updateHandler = (update = true)=>void (update && forceUpdate());
-        const patchState = (updater, update = true)=>{
-            updater(stateRef.current);
-            updateHandler(update);
-        };
-        const setState = (state, update = true)=>{
-            stateRef.current = state;
-            updateHandler(update);
-        };
-        return {
-            patchState,
-            forceUpdate,
-            getState: ()=>stateRef.current,
-            setState,
-            reset: (update = true)=>setState(clone(origin), update)
-        };
-    }, [
-        forceUpdate
-    ]);
-    return [
-        stateRef.current,
-        ctrl
-    ];
-}
-function useStorage(storageKey, options, initialData) {
-    const optionsRef = useRef({
-        initialData,
-        options
-    });
-    return useMemo(()=>{
-        const { initialData: _initialData, options: _options } = optionsRef.current;
-        return createStorageHandler(storageKey, _initialData || {}, _options);
-    }, [
-        storageKey
-    ]);
-}
-function setTitle(title) {
-    if (!title) return;
-    document.title = title;
-}
-const use_title_validInfo = $dt({
-    restoreOnUnmount: $t.boolean(true)
-});
-function useTitle(title, options = {}) {
-    const { restoreOnUnmount } = useValidData(options, use_title_validInfo);
-    useEffect(()=>{
-        const originalTitle = document.title;
-        setTitle(title);
-        return ()=>{
-            if (restoreOnUnmount) setTitle(originalTitle);
-        };
-    }, [
-        title,
-        restoreOnUnmount
-    ]);
-    return setTitle;
-}
-export { $dt, $t, defineTransform } from "../707.js";
-export { useBoolean, useControllableValue, useCounter, useForceUpdate, useMount, useRefState, useStorage, useTitle, useToggle, useValidData };
+import{useEffect as e,useEffectEvent as t,useMemo as r,useReducer as n,useRef as u,useState as l}from"react";import{dataHandler as o,logger as a,$dt as i,$t as c,throwType as s}from"../665.js";import{createStorageHandler as f}from"../893.js";function m(e=!1,t){let[n,o]=l(e),a=u([e,void 0===t?!e:t]);return[n,r(()=>{let[e,t]=a.current;return{set:r=>{r!==e&&r!==t&&s("useToggle","value is not left or right"),o(r)},setLeft:()=>o(e),setRight:()=>o(t),toggle:()=>o(r=>r===e?t:e)}},[])]}function d(e=!1){let[t,{toggle:n,set:u}]=m(!!e);return[t,r(()=>({toggle:n,setTrue:()=>u(!0),setFalse:()=>u(!1),set:e=>u(!!e)}),[])]}function g(e,t,n){let l=u(t),a=u(n);return r(()=>o(e,l.current,{unwrap:!0,...a.current}),[e])}let p=i({defaultValuePropName:c.validString("defaultValue"),valuePropName:c.validString("value"),trigger:c.validString("onChange")});function _(r={},n={}){let{defaultValue:o,trigger:a,valuePropName:i,defaultValuePropName:c}=g(n,p),{[i]:s,[c]:f=o,[a]:m}=r,d=u(!!Reflect.getOwnPropertyDescriptor(r,i)),N=u(!0),[v,S]=l(d.current?s:f),C=t((e,...t)=>{"function"==typeof m&&m(e,...t),d.current||S(e)});return e(()=>{if(N.current||!d.current){N.current=!1;return}S(s)},[s]),[v,C]}function N(e,t){let{min:r,max:n}=t;return Math.min(Math.max(e,r),n)}function v(e){return t=>{if(void 0===t)return e;a.warn("useCounter","value is not a number",t,"useCounter will use default value");let r=Number(t);return Number.isNaN(r)?e:r}}let S=i({min:c.validNumber(v(-1/0)),max:c.validNumber(v(1/0)),step:c.validNumber(v(1))});function C(e=0,n={}){let o=g(n,S),{step:a}=o,i=u(N(Number(e),o)),[c,s]=l(N(Number(e),o)),f=t(e=>{s(()=>N("function"==typeof e?e(c):e,o))});return[c,r(()=>{let e=Math.abs(a);return{increment:(t=e)=>f(e=>e+t),decrement:(t=e)=>f(e=>e-t),reset:()=>s(i.current),set:f}},[a])]}function b(){let[,e]=n(e=>(e+1)%10,0);return e}function h(t){let r=u(t);e(()=>{o({fn:r.current},{fn:c.function()},{strict:!0}),r.current()},[])}let M=structuredClone;function K(e){let t=u(e),n=b(),l=r(()=>{let e=M(t.current),r=(e,r=!0)=>{t.current=e,((e=!0)=>e&&n())(r)};return{patchState:(e,r=!0)=>{e(t.current),((e=!0)=>e&&n())(r)},forceUpdate:n,getState:()=>t.current,setState:r,reset:(t=!0)=>r(M(e),t)}},[n]);return[t.current,l]}function P(e,t,n){let l=u({initialData:n,options:t});return r(()=>{let{initialData:t,options:r}=l.current;return f(e,t||{},r)},[e])}function R(e){e&&(document.title=e)}let T=i({restoreOnUnmount:c.boolean(!0)});function U(t,r={}){let{restoreOnUnmount:n}=g(r,T);return e(()=>{let e=document.title;return R(t),()=>{n&&R(e)}},[t,n]),R}export{$dt,$dt as defineTransform,$t,dataHandler}from"../665.js";export{d as useBoolean,_ as useControllableValue,C as useCounter,b as useForceUpdate,h as useMount,K as useRefState,P as useStorage,U as useTitle,m as useToggle,g as useValidData};

package/dist/react/use-boolean/index.d.ts

@@ -1,6 +1,7 @@
-export declare function useBoolean(defaultValue?: boolean): readonly [boolean, {
+declare function useBoolean(defaultValue?: boolean): readonly [boolean, {
     toggle: () => void;
     setTrue: () => void;
     setFalse: () => void;
     set: (value: boolean) => void;
 }];
+export { useBoolean };

package/dist/react/use-boolean/index.js

@@ -1,16 +1 @@
-import { useMemo } from "react";
-import { useToggle } from "../use-toggle/index.js";
-function useBoolean(defaultValue = false) {
-    const [state, { toggle, set }] = useToggle(!!defaultValue);
-    const actions = useMemo(()=>({
-            toggle,
-            setTrue: ()=>set(true),
-            setFalse: ()=>set(false),
-            set: (value)=>set(!!value)
-        }), []);
-    return [
-        state,
-        actions
-    ];
-}
-export { useBoolean };
+import{useMemo as e}from"react";import{useToggle as t}from"../use-toggle/index.js";function o(r=!1){let[s,{toggle:n,set:u}]=t(!!r);return[s,e(()=>({toggle:n,setTrue:()=>u(!0),setFalse:()=>u(!1),set:e=>u(!!e)}),[])]}export{o as useBoolean};

package/dist/react/use-controllable-value/index.d.ts

@@ -4,12 +4,12 @@ interface UseControllableValueOptions<Ks extends PropertyKey = PropertyKey, P ex
     valuePropName: P;
     trigger: Ks;
 }
-export type PublicUseControllableValueOptions<Ks extends PropertyKey = PropertyKey, P extends Ks | (string & {}) = 'value'> = Partial<UseControllableValueOptions<Ks, P>>;
+type PublicUseControllableValueOptions<Ks extends PropertyKey = PropertyKey, P extends Ks | (string & {}) = 'value'> = Partial<UseControllableValueOptions<Ks, P>>;
 type ParseDefaultValue<OT extends Record<PropertyKey, any>, O extends PublicUseControllableValueOptions> = O['defaultValuePropName'] extends keyof OT ? OT[O['defaultValuePropName']] : O['defaultValue'];
 type Defaultize<OT extends Record<PropertyKey, any>, P extends keyof OT | (string & {}), O extends PublicUseControllableValueOptions> = P extends keyof OT ? undefined extends OT[P] ? OT[P] & ParseDefaultValue<OT, O> : OT[P] : ParseDefaultValue<OT, O>;
 type ValueType<T extends Record<PropertyKey, any>, O extends PublicUseControllableValueOptions<PropertyKey, any>> = O['valuePropName'] extends keyof T ? Defaultize<T, O['valuePropName'], O> : Defaultize<T, 'value', O>;
 /**
  * 受控组件 value 逻辑切换, 如果传递了 value 则走受控逻辑, 否则走非受控逻辑
  */
-export declare function useControllableValue<T extends Record<PropertyKey, any>, P extends keyof T | (string & {}) = PropertyKey, O extends PublicUseControllableValueOptions<keyof T, P> = PublicUseControllableValueOptions<keyof T, P>>(props?: T, options?: O): [ValueType<T, O>, (value: ValueType<T, O>, ...args: any[]) => void];
-export {};
+declare function useControllableValue<T extends Record<PropertyKey, any>, P extends keyof T | (string & {}) = PropertyKey, O extends PublicUseControllableValueOptions<keyof T, P> = PublicUseControllableValueOptions<keyof T, P>>(props?: T, options?: O): [ValueType<T, O>, (value: ValueType<T, O>, ...args: any[]) => void];
+export { type PublicUseControllableValueOptions, useControllableValue };

package/dist/react/use-controllable-value/index.js

@@ -1,32 +1 @@
-import { useEffect, useEffectEvent, useRef, useState } from "react";
-import { $dt, $t, useValidData } from "../use-valid-data/index.js";
-const validInfo = $dt({
-    defaultValuePropName: $t.validString('defaultValue'),
-    valuePropName: $t.validString('value'),
-    trigger: $t.validString('onChange')
-});
-function useControllableValue(props = {}, options = {}) {
-    const { defaultValue: _defaultValue, trigger, valuePropName, defaultValuePropName } = useValidData(options, validInfo);
-    const { [valuePropName]: propValue, [defaultValuePropName]: defaultValue = _defaultValue, [trigger]: emitChange } = props;
-    const hasValueRef = useRef(Boolean(Reflect.getOwnPropertyDescriptor(props, valuePropName)));
-    const isFirstRenderRef = useRef(true);
-    const [ctrlValue, setCtrlValue] = useState(hasValueRef.current ? propValue : defaultValue);
-    const setValue = useEffectEvent((value, ...args)=>{
-        if ('function' == typeof emitChange) emitChange(value, ...args);
-        if (!hasValueRef.current) setCtrlValue(value);
-    });
-    useEffect(()=>{
-        if (isFirstRenderRef.current || !hasValueRef.current) {
-            isFirstRenderRef.current = false;
-            return;
-        }
-        setCtrlValue(propValue);
-    }, [
-        propValue
-    ]);
-    return [
-        ctrlValue,
-        setValue
-    ];
-}
-export { useControllableValue };
+import{useEffect as e,useEffectEvent as r,useRef as t,useState as a}from"react";import{$dt as u,$t as l,useValidData as n}from"../use-valid-data/index.js";let i=u({defaultValuePropName:l.validString("defaultValue"),valuePropName:l.validString("value"),trigger:l.validString("onChange")});function o(u={},l={}){let{defaultValue:c,trigger:f,valuePropName:d,defaultValuePropName:p}=n(l,i),{[d]:g,[p]:m=c,[f]:v}=u,s=t(!!Reflect.getOwnPropertyDescriptor(u,d)),V=t(!0),[P,S]=a(s.current?g:m),x=r((e,...r)=>{"function"==typeof v&&v(e,...r),s.current||S(e)});return e(()=>{if(V.current||!s.current){V.current=!1;return}S(g)},[g]),[P,x]}export{o as useControllableValue};

package/dist/react/use-counter/index.d.ts

@@ -3,10 +3,10 @@ interface UseCounterOptions {
     max: number;
     step: number;
 }
-export declare function useCounter(initialValue?: number, options?: Partial<UseCounterOptions>): readonly [number, {
+declare function useCounter(initialValue?: number, options?: Partial<UseCounterOptions>): readonly [number, {
     increment: (delta?: number) => void;
     decrement: (delta?: number) => void;
     reset: () => void;
     set: (value: number | ((prev: number) => number)) => void;
 }];
-export {};
+export { useCounter };

package/dist/react/use-counter/index.js

@@ -1,49 +1 @@
-import { useEffectEvent, useMemo, useRef, useState } from "react";
-import { $dt, $t, useValidData } from "../use-valid-data/index.js";
-import { logger } from "../../shared/logger/index.js";
-function getRealValue(value, options) {
-    const { min, max } = options;
-    return Math.min(Math.max(value, min), max);
-}
-function nanTransform(_dv) {
-    return (_v)=>{
-        if (void 0 === _v) return _dv;
-        logger.warn('useCounter', 'value is not a number', _v, 'useCounter will use default value');
-        const numV = Number(_v);
-        if (Number.isNaN(numV)) return _dv;
-        return numV;
-    };
-}
-const validInfo = $dt({
-    min: $t.validNumber(nanTransform(-1 / 0)),
-    max: $t.validNumber(nanTransform(1 / 0)),
-    step: $t.validNumber(nanTransform(1))
-});
-function useCounter(initialValue = 0, options = {}) {
-    const validOptions = useValidData(options, validInfo);
-    const { step } = validOptions;
-    const initialValueRef = useRef(getRealValue(Number(initialValue), validOptions));
-    const [current, setCurrent] = useState(getRealValue(Number(initialValue), validOptions));
-    const setValue = useEffectEvent((value)=>{
-        setCurrent(()=>getRealValue('function' == typeof value ? value(current) : value, validOptions));
-    });
-    const actions = useMemo(()=>{
-        const _step = Math.abs(step);
-        const increment = (delta = _step)=>setValue((prev)=>prev + delta);
-        const decrement = (delta = _step)=>setValue((prev)=>prev - delta);
-        const reset = ()=>setCurrent(initialValueRef.current);
-        return {
-            increment,
-            decrement,
-            reset,
-            set: setValue
-        };
-    }, [
-        step
-    ]);
-    return [
-        current,
-        actions
-    ];
-}
-export { useCounter };
+import{useEffectEvent as e,useMemo as r,useRef as t,useState as u}from"react";import{$dt as n,$t as i,useValidData as a}from"../use-valid-data/index.js";import{logger as m}from"../../shared/logger/index.js";function o(e,r){let{min:t,max:u}=r;return Math.min(Math.max(e,t),u)}function l(e){return r=>{if(void 0===r)return e;m.warn("useCounter","value is not a number",r,"useCounter will use default value");let t=Number(r);return Number.isNaN(t)?e:t}}let s=n({min:i.validNumber(l(-1/0)),max:i.validNumber(l(1/0)),step:i.validNumber(l(1))});function d(n=0,i={}){let m=a(i,s),{step:l}=m,f=t(o(Number(n),m)),[b,N]=u(o(Number(n),m)),c=e(e=>{N(()=>o("function"==typeof e?e(b):e,m))});return[b,r(()=>{let e=Math.abs(l);return{increment:(r=e)=>c(e=>e+r),decrement:(r=e)=>c(e=>e-r),reset:()=>N(f.current),set:c}},[l])]}export{d as useCounter};

package/dist/react/use-force-update/index.d.ts

@@ -1 +1,2 @@
-export declare function useForceUpdate(): import("react").ActionDispatch<[]>;
+declare function useForceUpdate(): import("react").ActionDispatch<[]>;
+export { useForceUpdate };

package/dist/react/use-force-update/index.js

@@ -1,6 +1 @@
-import { useReducer } from "react";
-function useForceUpdate() {
-    const [, forceUpdate] = useReducer((prev)=>(prev + 1) % 10, 0);
-    return forceUpdate;
-}
-export { useForceUpdate };
+import{useReducer as e}from"react";function r(){let[,r]=e(e=>(e+1)%10,0);return r}export{r as useForceUpdate};

package/dist/react/use-mount/index.d.ts

@@ -1 +1,2 @@
-export declare function useMount(callback: () => any): void;
+declare function useMount(callback: () => any): void;
+export { useMount };

package/dist/react/use-mount/index.js

@@ -1,16 +1 @@
-import { useEffect, useRef } from "react";
-import { $t, dataHandler } from "../../shared/data-handler/index.js";
-function useMount(callback) {
-    const callbackRef = useRef(callback);
-    useEffect(()=>{
-        dataHandler({
-            fn: callbackRef.current
-        }, {
-            fn: $t["function"]()
-        }, {
-            strict: true
-        });
-        callbackRef.current();
-    }, []);
-}
-export { useMount };
+import{useEffect as r,useRef as t}from"react";import{$t as n,dataHandler as e}from"../../shared/data-handler/index.js";function o(o){let c=t(o);r(()=>{e({fn:c.current},{fn:n.function()},{strict:!0}),c.current()},[])}export{o as useMount};

package/dist/react/use-ref-state/index.d.ts

@@ -1,8 +1,9 @@
-export interface UseRefStateCtrl<T> {
+interface UseRefStateCtrl<T> {
     patchState: (updater: (draft: T) => void, update?: boolean) => void;
     forceUpdate: () => void;
     getState: () => T;
     setState: (state: T, update?: boolean) => void;
     reset: (update?: boolean) => void;
 }
-export declare function useRefState<T>(initialState: T): readonly [T, UseRefStateCtrl<T>];
+declare function useRefState<T>(initialState: T): readonly [T, UseRefStateCtrl<T>];
+export { type UseRefStateCtrl, useRefState };

package/dist/react/use-ref-state/index.js

@@ -1,33 +1 @@
-import { useMemo, useRef } from "react";
-import { useForceUpdate } from "../use-force-update/index.js";
-const clone = structuredClone;
-function useRefState(initialState) {
-    const stateRef = useRef(initialState);
-    const forceUpdate = useForceUpdate();
-    const ctrl = useMemo(()=>{
-        const origin = clone(stateRef.current);
-        const updateHandler = (update = true)=>void (update && forceUpdate());
-        const patchState = (updater, update = true)=>{
-            updater(stateRef.current);
-            updateHandler(update);
-        };
-        const setState = (state, update = true)=>{
-            stateRef.current = state;
-            updateHandler(update);
-        };
-        return {
-            patchState,
-            forceUpdate,
-            getState: ()=>stateRef.current,
-            setState,
-            reset: (update = true)=>setState(clone(origin), update)
-        };
-    }, [
-        forceUpdate
-    ]);
-    return [
-        stateRef.current,
-        ctrl
-    ];
-}
-export { useRefState };
+import{useMemo as t,useRef as e}from"react";import{useForceUpdate as r}from"../use-force-update/index.js";let u=structuredClone;function n(n){let c=e(n),o=r(),a=t(()=>{let t=u(c.current),e=(t,e=!0)=>{c.current=t,((t=!0)=>t&&o())(e)};return{patchState:(t,e=!0)=>{t(c.current),((t=!0)=>t&&o())(e)},forceUpdate:o,getState:()=>c.current,setState:e,reset:(r=!0)=>e(u(t),r)}},[o]);return[c.current,a]}export{n as useRefState};

package/dist/react/use-storage/index.d.ts

@@ -1,2 +1,3 @@
 import { type CreateStorageOptions } from '../../shared/create-storage-handler';
-export declare function useStorage<T extends Record<string, any>>(storageKey: string, options?: Partial<CreateStorageOptions>, initialData?: T): import("../../shared/create-storage-handler").StorageHandler<T>;
+declare function useStorage<T extends Record<string, any>>(storageKey: string, options?: Partial<CreateStorageOptions>, initialData?: T): import("../../shared/create-storage-handler").StorageHandler<T>;
+export { useStorage };

package/dist/react/use-storage/index.js

@@ -1,15 +1 @@
-import { useMemo, useRef } from "react";
-import { createStorageHandler } from "../../shared/create-storage-handler/index.js";
-function useStorage(storageKey, options, initialData) {
-    const optionsRef = useRef({
-        initialData,
-        options
-    });
-    return useMemo(()=>{
-        const { initialData: _initialData, options: _options } = optionsRef.current;
-        return createStorageHandler(storageKey, _initialData || {}, _options);
-    }, [
-        storageKey
-    ]);
-}
-export { useStorage };
+import{useMemo as r,useRef as t}from"react";import{createStorageHandler as e}from"../../shared/create-storage-handler/index.js";function o(o,a,n){let i=t({initialData:n,options:a});return r(()=>{let{initialData:r,options:t}=i.current;return e(o,r||{},t)},[o])}export{o as useStorage};

package/dist/react/use-title/index.d.ts

@@ -2,5 +2,5 @@ interface UseTitleOptions {
     restoreOnUnmount: boolean;
 }
 declare function setTitle(title?: string): void;
-export declare function useTitle(title?: string, options?: Partial<UseTitleOptions>): typeof setTitle;
-export {};
+declare function useTitle(title?: string, options?: Partial<UseTitleOptions>): typeof setTitle;
+export { useTitle };

package/dist/react/use-title/index.js

@@ -1,24 +1 @@
-import { useEffect } from "react";
-import { $dt, $t, useValidData } from "../use-valid-data/index.js";
-function setTitle(title) {
-    if (!title) return;
-    document.title = title;
-}
-const validInfo = $dt({
-    restoreOnUnmount: $t.boolean(true)
-});
-function useTitle(title, options = {}) {
-    const { restoreOnUnmount } = useValidData(options, validInfo);
-    useEffect(()=>{
-        const originalTitle = document.title;
-        setTitle(title);
-        return ()=>{
-            if (restoreOnUnmount) setTitle(originalTitle);
-        };
-    }, [
-        title,
-        restoreOnUnmount
-    ]);
-    return setTitle;
-}
-export { useTitle };
+import{useEffect as t}from"react";import{$dt as e,$t as n,useValidData as o}from"../use-valid-data/index.js";function r(t){t&&(document.title=t)}let i=e({restoreOnUnmount:n.boolean(!0)});function u(e,n={}){let{restoreOnUnmount:l}=o(n,i);return t(()=>{let t=document.title;return r(e),()=>{l&&r(t)}},[e,l]),r}export{u as useTitle};

package/dist/react/use-toggle/index.d.ts

@@ -4,7 +4,7 @@ interface Actions<T> {
     setRight: () => void;
     toggle: () => void;
 }
-export declare function useToggle(): [boolean, Actions<boolean>];
-export declare function useToggle<L>(defaultValue: L): [L, Actions<L>];
-export declare function useToggle<L, R>(defaultValue: L, reverseValue: R): [L | R, Actions<L | R>];
-export {};
+declare function useToggle(): [boolean, Actions<boolean>];
+declare function useToggle<L>(defaultValue: L): [L, Actions<L>];
+declare function useToggle<L, R>(defaultValue: L, reverseValue: R): [L | R, Actions<L | R>];
+export { useToggle };

package/dist/react/use-toggle/index.js

@@ -1,26 +1 @@
-import { useMemo, useRef, useState } from "react";
-import { throwType } from "../../shared/throw-error/index.js";
-function useToggle(defualtValue = false, reverseValue) {
-    const [state, setState] = useState(defualtValue);
-    const toggleRef = useRef([
-        defualtValue,
-        void 0 === reverseValue ? !defualtValue : reverseValue
-    ]);
-    const actions = useMemo(()=>{
-        const [left, right] = toggleRef.current;
-        return {
-            set: (value)=>{
-                if (value !== left && value !== right) throwType('useToggle', 'value is not left or right');
-                setState(value);
-            },
-            setLeft: ()=>setState(left),
-            setRight: ()=>setState(right),
-            toggle: ()=>setState((prev)=>prev === left ? right : left)
-        };
-    }, []);
-    return [
-        state,
-        actions
-    ];
-}
-export { useToggle };
+import{useMemo as e,useRef as t,useState as r}from"react";import{throwType as o}from"../../shared/throw-error/index.js";function g(i=!1,s){let[l,n]=r(i),u=t([i,void 0===s?!i:s]);return[l,e(()=>{let[e,t]=u.current;return{set:r=>{r!==e&&r!==t&&o("useToggle","value is not left or right"),n(r)},setLeft:()=>n(e),setRight:()=>n(t),toggle:()=>n(r=>r===e?t:e)}},[])]}export{g as useToggle};

package/dist/react/use-valid-data/index.d.ts

@@ -1,8 +1,9 @@
 import type { DataHandlerOptions, Handler } from '../../shared/data-handler/types';
-export * from '../../shared/data-handler/tools';
-export declare function useValidData<T extends Record<PropertyKey, any>, H extends Handler<T> = Handler<T>, O extends DataHandlerOptions<T> = DataHandlerOptions<T> & {
+declare function useValidData<T extends Record<PropertyKey, any>, H extends Handler<T> = Handler<T>, O extends DataHandlerOptions<T> = DataHandlerOptions<T> & {
     unwrap: true;
-}>(data: T, verifyInfo: H, options?: O): O["unwrap"] extends true ? import("../../shared").Printify<import("../../shared/data-handler").Transform2Type<H> extends infer T_1 ? T_1 extends import("../../shared/data-handler").Transform2Type<H> ? T_1 extends (...args: any[]) => any ? T & O["defaultValue"] : T & O["defaultValue"] & { [K in keyof T_1]: import("../../shared").Equal<T_1[K], any> extends true ? Required<T & O["defaultValue"]>[K] : T_1[K]; } : never : never> : {
-    result: import("../../shared").Printify<import("../../shared/data-handler").Transform2Type<H> extends infer T_2 ? T_2 extends import("../../shared/data-handler").Transform2Type<H> ? T_2 extends (...args: any[]) => any ? T & O["defaultValue"] : T & O["defaultValue"] & { [K_1 in keyof T_2]: import("../../shared").Equal<T_2[K_1], any> extends true ? Required<T & O["defaultValue"]>[K_1] : T_2[K_1]; } : never : never>;
+}>(data: T, verifyInfo: H, options?: O): O["unwrap"] extends true ? import("../../shared").Printify<import("../../shared/data-handler/tools").Transform2Type<H> extends infer T_1 ? T_1 extends import("../../shared/data-handler/tools").Transform2Type<H> ? T_1 extends (...args: any[]) => any ? T & O["defaultValue"] : T & O["defaultValue"] & { [K in keyof T_1]: import("../../shared").Equal<T_1[K], any> extends true ? Required<T & O["defaultValue"]>[K] : T_1[K]; } : never : never> : {
+    result: import("../../shared").Printify<import("../../shared/data-handler/tools").Transform2Type<H> extends infer T_2 ? T_2 extends import("../../shared/data-handler/tools").Transform2Type<H> ? T_2 extends (...args: any[]) => any ? T & O["defaultValue"] : T & O["defaultValue"] & { [K_1 in keyof T_2]: import("../../shared").Equal<T_2[K_1], any> extends true ? Required<T & O["defaultValue"]>[K_1] : T_2[K_1]; } : never : never>;
     errors: string[];
 };
+export * from '@/shared/data-handler';
+export { useValidData };

package/dist/react/use-valid-data/index.js

@@ -1,14 +1 @@
-import { useMemo, useRef } from "react";
-import { dataHandler } from "../../shared/data-handler/index.js";
-export * from "../../shared/data-handler/tools.js";
-function useValidData(data, verifyInfo, options) {
-    const verifyInfoRef = useRef(verifyInfo);
-    const optionsRef = useRef(options);
-    return useMemo(()=>dataHandler(data, verifyInfoRef.current, {
-            unwrap: true,
-            ...optionsRef.current
-        }), [
-        data
-    ]);
-}
-export { useValidData };
+import{useMemo as r,useRef as e}from"react";import{dataHandler as a}from"../../shared/data-handler/index.js";export*from"../../shared/data-handler/index.js";function t(t,n,d){let o=e(n),i=e(d);return r(()=>a(t,o.current,{unwrap:!0,...i.current}),[t])}export{t as useValidData};

package/dist/shared/allx/index.d.ts

@@ -10,4 +10,5 @@ import type { AllxContext, AllxOptions, AllxResult } from './types';
  *   async c() { return (await this.$.a) + 10 }
  * })
  */
-export declare function allx<M extends Record<PropertyKey, any>, O extends AllxOptions>(tasks: M & ThisType<AllxContext<M>>, options?: O): Promise<AllxResult<M, O>>;
+declare function allx<M extends Record<PropertyKey, any>, O extends AllxOptions>(tasks: M & ThisType<AllxContext<M>>, options?: O): Promise<AllxResult<M, O>>;
+export { allx };