@cmtlyt/lingshu-toolkit 0.5.0 → 0.7.0

package/dist/shared/types/pack.js

@@ -1 +1 @@
-Symbol('__PACK__');
+Symbol("__PACK__");

package/dist/shared/utils/base.d.ts

@@ -1,3 +1,3 @@
-export declare const noop: () => undefined;
+export declare const noop: () => void;
 export declare const identity: <T>(_v: T) => T;
 export declare function getType(_v: any): string;

package/dist/shared/utils/base.js

@@ -1,6 +1 @@
-const noop = ()=>void 0;
-const identity = (_v)=>_v;
-function getType(_v) {
-    return Object.prototype.toString.call(_v).slice(8, -1).toLowerCase();
-}
-export { getType, identity, noop };
+let t=()=>void 0,e=t=>t;function o(t){return Object.prototype.toString.call(t).slice(8,-1).toLowerCase()}export{o as getType,e as identity,t as noop};

package/dist/shared/utils/index.js

@@ -1,2 +1 @@
-export * from "./base.js";
-export * from "./verify.js";
+export*from"./base.js";export*from"./verify.js";

package/dist/shared/utils/verify.d.ts

@@ -49,5 +49,5 @@ export declare function isTruthy<T>(_v: T): _v is Exclude<T, false | 0 | '' | nu
 export declare function isFalsy(_v: unknown): _v is false | 0 | '' | null | undefined;
 /** 判断是一个函数 */
 export declare function isFunction(_v: unknown): _v is AnyFunc;
-/** 判断是一个 Promise */
+/** 判断是一个 PromiseLike */
 export declare function isPromiseLike(_v: unknown): _v is PromiseLike<any>;

package/dist/shared/utils/verify.js

@@ -1,67 +1 @@
-function isSymbol(_v) {
-    return 'symbol' == typeof _v;
-}
-function isUndef(_v) {
-    return void 0 === _v;
-}
-function isNull(_v) {
-    return null === _v;
-}
-function isNullOrUndef(_v) {
-    return isNull(_v) || isUndef(_v);
-}
-function verify_isNaN(_v) {
-    return Number.isNaN(_v);
-}
-function isPlainSymbol(_v) {
-    return isSymbol(_v) && isUndef(Symbol.keyFor(_v));
-}
-function isObject(_v) {
-    return 'object' == typeof _v && !isNull(_v);
-}
-function isPlainObject(_v) {
-    return isObject(_v) && !isArray(_v);
-}
-function isArray(_v) {
-    return Array.isArray(_v);
-}
-function isEmptyArray(_v) {
-    return isArray(_v) && 0 === _v.length;
-}
-function isString(_v) {
-    return 'string' == typeof _v;
-}
-function isEmptyString(_v) {
-    return isString(_v) && 0 === _v.length;
-}
-function isNumber(_v) {
-    return 'number' == typeof _v;
-}
-function isPlainNumber(_v) {
-    return isNumber(_v) && !verify_isNaN(_v);
-}
-function isPropertyKey(_v) {
-    return isString(_v) || isNumber(_v) || isSymbol(_v);
-}
-function isBoolean(_v) {
-    return 'boolean' == typeof _v;
-}
-function isTrue(_v) {
-    return true === _v || isString(_v) && 'true' === _v.toLowerCase();
-}
-function isFalse(_v) {
-    return false === _v || isString(_v) && 'false' === _v.toLowerCase();
-}
-function isTruthy(_v) {
-    return !!_v;
-}
-function isFalsy(_v) {
-    return !(verify_isNaN(_v) || _v);
-}
-function isFunction(_v) {
-    return 'function' == typeof _v;
-}
-function isPromiseLike(_v) {
-    return isObject(_v) && isFunction(_v.then);
-}
-export { isArray, isBoolean, isEmptyArray, isEmptyString, isFalse, isFalsy, isFunction, verify_isNaN as isNaN, isNull, isNullOrUndef, isNumber, isObject, isPlainNumber, isPlainObject, isPlainSymbol, isPromiseLike, isPropertyKey, isString, isSymbol, isTrue, isTruthy, isUndef };
+function n(n){return"symbol"==typeof n}function r(n){return void 0===n}function t(n){return null===n}function i(n){return t(n)||r(n)}function e(n){return Number.isNaN(n)}function u(t){return n(t)&&r(Symbol.keyFor(t))}function o(n){return"object"==typeof n&&!t(n)}function s(n){return o(n)&&!f(n)}function f(n){return Array.isArray(n)}function c(n){return f(n)&&0===n.length}function y(n){return"string"==typeof n}function l(n){return y(n)&&0===n.length}function a(n){return"number"==typeof n}function b(n){return a(n)&&!e(n)}function m(r){return y(r)||a(r)||n(r)}function N(n){return"boolean"==typeof n}function p(n){return!0===n||y(n)&&"true"===n.toLowerCase()}function g(n){return!1===n||y(n)&&"false"===n.toLowerCase()}function P(n){return!!n}function S(n){return!(e(n)||n)}function h(n){return"function"==typeof n}function A(n){return(o(n)||h(n))&&h(n.then)}export{f as isArray,N as isBoolean,c as isEmptyArray,l as isEmptyString,g as isFalse,S as isFalsy,h as isFunction,t as isNull,i as isNullOrUndef,a as isNumber,o as isObject,b as isPlainNumber,s as isPlainObject,u as isPlainSymbol,A as isPromiseLike,m as isPropertyKey,y as isString,n as isSymbol,p as isTrue,P as isTruthy,r as isUndef,e as isNaN};

package/dist/shared/with-resolvers/index.d.ts

@@ -1,6 +1,8 @@
-export type Resolver<T> = {
+interface Resolver<T> {
     promise: Promise<T>;
     resolve: (value: T | PromiseLike<T>) => void;
     reject: (reason?: any) => void;
-};
-export declare function withResolvers<T>(): Resolver<T>;
+}
+declare function withResolvers<T>(): Resolver<T>;
+export type { Resolver };
+export { withResolvers };

package/dist/shared/with-resolvers/index.js

@@ -1,15 +1 @@
-function withResolvers() {
-    return 'function' == typeof Promise.withResolvers ? Promise.withResolvers() : (()=>{
-        const resolver = {
-            promise: null,
-            resolve: null,
-            reject: null
-        };
-        resolver.promise = new Promise((resolve, reject)=>{
-            resolver.resolve = resolve;
-            resolver.reject = reject;
-        });
-        return resolver;
-    })();
-}
-export { withResolvers };
+function e(){let e;return"function"==typeof Promise.withResolvers?Promise.withResolvers():((e={promise:null,resolve:null,reject:null}).promise=new Promise((r,o)=>{e.resolve=r,e.reject=o}),e)}export{e as withResolvers};

package/dist/vue/index.js

@@ -1,29 +1 @@
-import { onScopeDispose, ref, toValue, watch } from "vue";
-import { dataHandler, $t, $dt } from "../707.js";
-function setTitle(title) {
-    if (!title || "u" < typeof document) return;
-    const oldTitle = document.title;
-    document.title = title;
-    return oldTitle;
-}
-const validInfo = $dt({
-    restoreOnUnmount: $t.boolean(true)
-});
-function useTitle(newTitle = '', options = {}) {
-    const { restoreOnUnmount } = dataHandler(options, validInfo, {
-        unwrap: true
-    });
-    const title = ref(toValue(newTitle));
-    const originalTitle = setTitle(title.value);
-    watch(title, setTitle, {
-        flush: 'sync'
-    });
-    watch(()=>toValue(newTitle), (value)=>{
-        title.value = value;
-    });
-    if (restoreOnUnmount) onScopeDispose(()=>{
-        setTitle(originalTitle);
-    });
-    return title;
-}
-export { useTitle };
+import{onScopeDispose as t,ref as e,toValue as n,watch as u}from"vue";import{dataHandler as o,$t as r,$dt as l}from"../665.js";function i(t){if(!t||"u"<typeof document)return;let e=document.title;return document.title=t,e}let m=l({restoreOnUnmount:r.boolean(!0)});function f(r="",l={}){let{restoreOnUnmount:c}=o(l,m,{unwrap:!0}),a=e(n(r)),p=i(a.value);return u(a,i,{flush:"sync"}),u(()=>n(r),t=>{a.value=t}),c&&t(()=>{i(p)}),a}export{f as useTitle};

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

@@ -2,5 +2,5 @@ import { type MaybeRefOrGetter } from 'vue';
 interface UseTitleOptions {
     restoreOnUnmount: boolean;
 }
-export declare function useTitle(newTitle?: MaybeRefOrGetter<string>, options?: Partial<UseTitleOptions>): import("vue").Ref<string, string>;
-export {};
+declare function useTitle(newTitle?: MaybeRefOrGetter<string>, options?: Partial<UseTitleOptions>): import("vue").Ref<string, string>;
+export { useTitle };

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

@@ -1,29 +1 @@
-import { onScopeDispose, ref, toValue, watch } from "vue";
-import { $dt, $t, dataHandler } from "../../shared/data-handler/index.js";
-function setTitle(title) {
-    if (!title || "u" < typeof document) return;
-    const oldTitle = document.title;
-    document.title = title;
-    return oldTitle;
-}
-const validInfo = $dt({
-    restoreOnUnmount: $t.boolean(true)
-});
-function useTitle(newTitle = '', options = {}) {
-    const { restoreOnUnmount } = dataHandler(options, validInfo, {
-        unwrap: true
-    });
-    const title = ref(toValue(newTitle));
-    const originalTitle = setTitle(title.value);
-    watch(title, setTitle, {
-        flush: 'sync'
-    });
-    watch(()=>toValue(newTitle), (value)=>{
-        title.value = value;
-    });
-    if (restoreOnUnmount) onScopeDispose(()=>{
-        setTitle(originalTitle);
-    });
-    return title;
-}
-export { useTitle };
+import{onScopeDispose as e,ref as t,toValue as n,watch as r}from"vue";import{$dt as u,$t as o,dataHandler as l}from"../../shared/data-handler/index.js";function i(e){if(!e||"u"<typeof document)return;let t=document.title;return document.title=e,t}let a=u({restoreOnUnmount:o.boolean(!0)});function m(u="",o={}){let{restoreOnUnmount:d}=l(o,a,{unwrap:!0}),f=t(n(u)),c=i(f.value);return r(f,i,{flush:"sync"}),r(()=>n(u),e=>{f.value=e}),d&&e(()=>{i(c)}),f}export{m as useTitle};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmtlyt/lingshu-toolkit",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "./dist/shared.js",
   "module": "./dist/shared.js",
@@ -40,35 +40,35 @@
     "email": "cmtlyt@163.com"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.8",
-    "@cmtlyt/unplugin-shadcn-registry-generate": "^0.1.5",
-    "@commitlint/cli": "^20.3.1",
-    "@commitlint/config-conventional": "^20.3.1",
-    "@rslib/core": "^0.19.3",
+    "@biomejs/biome": "2.4.11",
+    "@cmtlyt/unplugin-shadcn-registry-generate": "^0.1.6",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@rslib/core": "^0.21.0",
     "@rspress/core": "^2.0.8",
-    "@types/node": "^24.10.9",
-    "@types/react": "^19.2.9",
-    "@vitejs/plugin-react": "^5.1.2",
-    "@vitejs/plugin-vue": "^6.0.3",
-    "@vitest/browser-playwright": "4.0.18",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/ui": "4.0.18",
+    "@types/node": "^25.5.2",
+    "@types/react": "^19.2.14",
+    "@vitejs/plugin-react": "^5.2.0",
+    "@vitejs/plugin-vue": "^6.0.5",
+    "@vitest/browser-playwright": "4.1.4",
+    "@vitest/coverage-v8": "4.1.4",
+    "@vitest/ui": "4.1.4",
     "changelogithub": "^14.0.0",
     "cross-env": "^10.1.0",
+    "depcheck": "^1.4.7",
     "esno": "^4.8.0",
     "husky": "^9.1.7",
-    "jsdom": "^27.4.0",
-    "lint-staged": "^16.2.7",
-    "msw": "^2.12.14",
-    "playwright": "^1.58.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^6.0.4",
-    "vitest": "4.0.18",
-    "vitest-browser-react": "2.0.2",
-    "vitest-browser-vue": "2.0.2",
-    "vue": "^3.5.27"
+    "lint-staged": "^16.4.0",
+    "msw": "^2.13.2",
+    "playwright": "^1.59.1",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "typescript": "^6.0.2",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "4.1.4",
+    "vitest-browser-react": "2.2.0",
+    "vitest-browser-vue": "2.1.0",
+    "vue": "^3.5.32"
   },
   "peerDependencies": {
     "react": "^19.2.3",
@@ -121,8 +121,8 @@
     "preview:docs": "rspress preview",
     "format": "biome format --write",
     "test": "vitest --config=vitest.project.config.ts --coverage.enabled --ui",
-    "test:ci": "cross-env skip_type_check=true gen_file_disabled=true vitest run --config=vitest.project.config.ts",
-    "test:lib:ci": "cross-env skip_type_check=true gen_file_disabled=true vitest run",
+    "test:ci": "cross-env ci_test=true gen_file_disabled=true vitest run --config=vitest.project.config.ts",
+    "test:lib:ci": "cross-env ci_test=true gen_file_disabled=true vitest run",
     "test:lib": "vitest --coverage.enabled --ui",
     "script:gen-file": "esno scripts/gen-file.ts"
   }

package/dist/247.js

@@ -1,66 +0,0 @@
-import { dataHandler, logger, $dt, throwError, $t } from "./707.js";
-const validInfo = $dt({
-    storageKey: 'validString',
-    storageType: $t["enum"]([
-        'local',
-        'session',
-        'memory'
-    ], 'local'),
-    autoSaveInterval: $t.number(0)
-});
-const memoryStorage = {
-    data: {},
-    getItem (key) {
-        return this.data[key];
-    },
-    setItem (key, value) {
-        this.data[key] = value;
-    },
-    removeItem (key) {
-        delete this.data[key];
-    }
-};
-function getStorage(storageType) {
-    try {
-        if ('memory' === storageType) return memoryStorage;
-        return 'local' === storageType ? localStorage : sessionStorage;
-    } catch  {
-        logger.warn('createStorage', 'Failed to access localStorage or sessionStorage, using memoryStorage instead.');
-        return memoryStorage;
-    }
-}
-const CLEAR_FLAG = Symbol('cleared');
-function createStorageHandler(storageKey, initialData, options = {}) {
-    const { storageKey: validStorageKey, storageType, autoSaveInterval } = dataHandler({
-        storageKey,
-        ...options
-    }, validInfo, {
-        unwrap: true
-    });
-    const storage = getStorage(storageType);
-    const storageData = storage.getItem(validStorageKey);
-    const context = {
-        data: storageData ? JSON.parse(storageData) : initialData || {}
-    };
-    return {
-        get (key) {
-            if (context.data === CLEAR_FLAG) throwError('createStorageHandler', 'Storage has been cleared.');
-            if (null == key) return context.data;
-            return context.data[key];
-        },
-        set (value, key) {
-            if (context.data === CLEAR_FLAG) throwError('createStorageHandler', 'Storage has been cleared.');
-            if (null == key) context.data = value;
-            else context.data[key] = value;
-            if (autoSaveInterval > 0) setTimeout(()=>{
-                storage.setItem(validStorageKey, JSON.stringify(context.data));
-            }, autoSaveInterval);
-            else storage.setItem(validStorageKey, JSON.stringify(context.data));
-        },
-        clear () {
-            context.data = CLEAR_FLAG;
-            storage.removeItem(validStorageKey);
-        }
-    };
-}
-export { createStorageHandler };

package/dist/707.js

@@ -1,142 +0,0 @@
-function createError(fnName, message, ErrorClass = Error) {
-    return new ErrorClass(`[@cmtlyt/lingshu-toolkit#${fnName}]: ${message}`);
-}
-function throwError(fnName, message, ErrorClass = Error) {
-    throw createError(fnName, message, ErrorClass);
-}
-function throwType(fnName, message) {
-    throwError(fnName, message, TypeError);
-}
-const logger = new Proxy(console, {
-    get (target, prop, receiver) {
-        if ((globalThis.$$lingshu$$ || {}).disableLogger) return ()=>void 0;
-        const oldLog = Reflect.get(target, prop, receiver).bind(console);
-        return (fnName, ...args)=>{
-            oldLog(`[@cmtlyt/lingshu-toolkit#${fnName}]:`, ...args);
-        };
-    }
-});
-const noop = ()=>void 0;
-const identity = (_v)=>_v;
-function getType(_v) {
-    return Object.prototype.toString.call(_v).slice(8, -1).toLowerCase();
-}
-function typeHandler(type, verifyFn) {
-    return (fullback)=>(_v, actions)=>{
-            if (verifyFn ? verifyFn(_v) : getType(_v) === type) return true;
-            if (null == fullback) return false;
-            let fullbackValue = fullback;
-            if ('function' == typeof fullback) fullbackValue = fullback(_v);
-            actions.transform(fullbackValue);
-        };
-}
-const $t = {
-    notNullable: typeHandler('notNullable', (_v)=>null != _v),
-    string: typeHandler('string'),
-    validString: typeHandler('validString', (_v)=>'string' == typeof _v && _v.length > 0),
-    number: typeHandler('number'),
-    validNumber: typeHandler('validNumber', (_v)=>'number' == typeof _v && !Number.isNaN(_v)),
-    boolean: typeHandler('boolean'),
-    object: typeHandler('object'),
-    array: typeHandler('array'),
-    function: typeHandler('function'),
-    symbol: typeHandler('symbol'),
-    enum: (list, fullback)=>{
-        if (!Array.isArray(list)) throwType('$t.enum', 'list must be an array');
-        const set = new Set(list);
-        return typeHandler('enum', (_v)=>set.has(_v))(fullback);
-    }
-};
-function defineTransform(dataInfo) {
-    const verifyInfo = {};
-    const keys = Reflect.ownKeys(dataInfo);
-    for(let i = 0, key = keys[i], item = dataInfo[key]; i < keys.length; key = keys[++i], item = dataInfo[key]){
-        if ('function' == typeof item) {
-            verifyInfo[key] = item;
-            continue;
-        }
-        const handler = $t[item];
-        if (!handler) {
-            logger.warn('defineTransform', `${item} is not a valid type`);
-            continue;
-        }
-        verifyInfo[key] = handler();
-    }
-    return verifyInfo;
-}
-const $dt = defineTransform;
-function createActions() {
-    const ctx = {
-        errors: [],
-        transforms: [],
-        handledErrorKeys: new Set()
-    };
-    const handler = {
-        addError (key, msg = `${String(key)} is not valid`) {
-            if (ctx.handledErrorKeys.has(key)) return;
-            ctx.handledErrorKeys.add(key);
-            ctx.errors.push(msg);
-        },
-        addTransform (key, value) {
-            ctx.transforms.push([
-                key,
-                value
-            ]);
-        }
-    };
-    return [
-        ctx,
-        handler,
-        (key)=>({
-                assert: (flag, msg = `${String(key)} is not valid`)=>{
-                    if (!flag) handler.addError(key, msg);
-                    return flag;
-                },
-                transform: (value)=>{
-                    if (!ctx.handledErrorKeys.has(key)) handler.addTransform(key, value);
-                    return value;
-                }
-            })
-    ];
-}
-function transformApply(data, transforms) {
-    if (!transforms.length) return;
-    for(let i = 0, [key, value] = transforms[i]; i < transforms.length; [key, value] = transforms[++i] || [])data[key] = value;
-}
-function handleProcess(data, keys, handleFn, getActions, actionHandlers) {
-    for(let i = 0, key = keys[i]; i < keys.length; key = keys[++i]){
-        const flag = handleFn(data[key], key, getActions(key), data);
-        if (false === flag) actionHandlers.addError(key);
-    }
-}
-function errorProcess(errors, errorHandler, strict) {
-    if (!errors.length) return;
-    if (errorHandler) errorHandler(errors);
-    else if (strict) throwType('dataHandler', errors.join('\n'));
-}
-function filterData(data, ctx, defaultValue = {}) {
-    ctx.handledErrorKeys.forEach((key)=>{
-        data[key] = defaultValue[key];
-    });
-}
-function dataHandler(data, handler, options) {
-    if (!handler) throwType('dataHandler', 'handler is required');
-    const { strict = false, errorHandler, defaultValue, unwrap = false } = options || {};
-    const handlerIsFunction = 'function' == typeof handler;
-    const handleFn = handlerIsFunction ? handler : (value, key, ...args)=>handler[key](value, ...args);
-    const tempData = {
-        ...defaultValue,
-        ...data
-    };
-    const keys = handlerIsFunction ? Reflect.ownKeys(data) : Reflect.ownKeys(handler);
-    const [ctx, actionHandler, getActions] = createActions();
-    handleProcess(tempData, keys, handleFn, getActions, actionHandler);
-    errorProcess(ctx.errors, errorHandler, strict);
-    transformApply(tempData, ctx.transforms);
-    filterData(tempData, ctx, defaultValue);
-    return unwrap ? tempData : {
-        result: tempData,
-        errors: ctx.errors
-    };
-}
-export { $dt, $t, createError, dataHandler, defineTransform, getType, identity, logger, noop, throwError, throwType };

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/allsettled.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/basic.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/circular-dependency.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/dependency.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/edge-cases.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/error-handling.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/execution-order.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/falsy-values.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/performance.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/type-checking.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/allx/__test__/use-cases.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/animation/__test__/animation-pause-resume.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/animation/__test__/animation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/animation/__test__/step-animation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/animation/__test__/utils.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/api-controller/__test__/index.browser.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/shared/api-controller/__test__/index.node.test.d.ts

@@ -1 +0,0 @@
-export {};