@vope/utils 1.6.8 → 1.7.0

package/dist/index.js

@@ -1,4 +1,5 @@
-import { isCalc, default as default2 } from "./calc";
+import { default as default2 } from "./async-lock";
+import { isCalc, default as default3 } from "./calc";
 import { clamp } from "./clamp";
 import { classnames } from "./classnames";
 import { compareVersion } from "./compare/version";
@@ -8,8 +9,10 @@ import { hash8object } from "./convert/object";
 import { hash8strings } from "./convert/strings";
 import { weekDic, default_max_second, default_min_second, default_max_minute, default_min_minute, default_max_hour, default_min_hour, default_max_day, default_min_day, default_max_month, default_min_month, default_max_week, default_min_week, createCronRegexText, InvalidUnit, isInvalidUnit, DayLastUnit, isDayLastUnit, WeekLastUnit, isWeekLastUnit, WildcardUnit, isWildcardUnit, RangeUnit, isRangeUnit, AggUnit, isAggUnit, Cron } from "./cron";
 import { desensEncrypt, desensDecrypt, desensReplace } from "./desens";
-import { default as default3 } from "./dic";
+import { default as default4 } from "./dic";
+import { default as default5 } from "./disable-enumerable";
 import { getEncoding } from "./encoding";
+import { default as default6 } from "./index-sort";
 import { inputRegex } from "./input-regex";
 import { isClass } from "./is/class";
 import { isEmpty } from "./is/empty";
@@ -20,8 +23,8 @@ import { MemoryBasic } from "./memory/basic";
 import { MemoryList } from "./memory/list";
 import { MemoryPower } from "./memory/power";
 import { MemorySimple } from "./memory/simple";
-import { default as default4 } from "./neo4j-anchors";
-import { default as default5 } from "./neo4j";
+import { default as default7 } from "./neo4j-anchors";
+import { default as default8 } from "./neo4j";
 import { once } from "./once";
 import { parseNum } from "./parse/num";
 import { deconPowersSum } from "./power/decon";
@@ -29,7 +32,7 @@ import { rotateAngle } from "./rotate/angle";
 import { rotateRad } from "./rotate/rad";
 import { cubeURLParams, flatURLParams } from "./serialize/url-params";
 import { css } from "./style/css";
-import { default as default6 } from "./subscriber";
+import { default as default9 } from "./subscriber";
 import { FlexTable } from "./table/flex";
 import { Union } from "./union";
 import { joinPaths } from "./url/join";
@@ -39,21 +42,22 @@ export {
   AggUnit,
   Cron,
   DayLastUnit,
-  default3 as DicRollup,
+  default4 as DicRollup,
   FlexTable,
   InvalidUnit,
   MemoryBasic,
   MemoryList,
   MemoryPower,
   MemorySimple,
-  default5 as Neo4j,
-  default4 as Neo4jAhchors,
+  default8 as Neo4j,
+  default7 as Neo4jAhchors,
   RangeUnit,
-  default6 as Subscriber,
+  default9 as Subscriber,
   Union,
   WeekLastUnit,
   WildcardUnit,
-  default2 as calc,
+  default2 as asyncLock,
+  default3 as calc,
   clamp,
   classnames,
   compareVersion,
@@ -78,11 +82,13 @@ export {
   desensDecrypt,
   desensEncrypt,
   desensReplace,
+  default5 as disableEnumerable,
   flatURLParams,
   getEncoding,
   hash8json,
   hash8object,
   hash8strings,
+  default6 as indexSort,
   inputRegex,
   isAggUnit,
   isCalc,

package/dist/memory/basic.d.ts

@@ -1,36 +1,71 @@
-import type { Memory } from './type';
-interface Config<Reactor> {
+import type { GetGivenProps } from '@vope/types';
+declare const PUSH = 1;
+declare const RESET = 2;
+declare const DELETE = 0;
+export declare namespace Memory {
+    type Type = string | number | symbol;
+    type Pitch<Data, Type> = (Data extends object ? GetGivenProps<Data, Type> : never) | ((data: Data) => Type);
+    interface Emit<T> {
+        (type: typeof PUSH, data: T): void;
+        (type: typeof RESET, data: T[]): void;
+        (type: typeof DELETE, index: number): void;
+    }
+}
+interface Mount<T> {
     /**
-     * 定义数据如何挂载到存储中
      * @param index 当前存入数据对应的角标
      * @param reactor 当前存入数据对应存储单元
      */
-    mount(index: number, reactor?: Reactor): Reactor;
+    (index: number, reactor?: T): T;
+}
+interface Reflex<T> {
+    /**
+     * @param reactor 存储单元
+     */
+    (reactor: T): number[];
+}
+interface Config<T, Reactor> {
+    /**
+     * 定义数据如何挂载到存储中
+     */
+    mount: Mount<Reactor>;
     /**
      * 定义存储单元和存储关系
      * @param reactor 存储单元
      */
-    reflex(reactor: Reactor): number[];
+    reflex: Reflex<Reactor>;
+    /**
+     * 存储变化触发(用于同步数据)
+     */
+    emit?: Memory.Emit<T>;
 }
+declare const LIST_SYMBOL: unique symbol;
+declare const MEMORYS_SYMBOL: unique symbol;
 /**
  * 分类存储(通过继承，可用于拓展存储方式)
  */
 export declare class MemoryBasic<T, Reactor, Type extends Memory.Type> {
     #private;
     protected key: Memory.Pitch<T, Type>;
-    protected list: T[];
-    protected memorys: Map<Type, Reactor>;
+    static readonly PUSH = 1;
+    static readonly RESET = 2;
+    static readonly DELETE = 0;
+    protected [LIST_SYMBOL]: T[];
+    protected [MEMORYS_SYMBOL]: Map<Type, Reactor>;
     /**
      * 返回存储长度
      */
     get size(): number;
     /**
-     * @param key 用于对数据进行分类的key
-     * @param config
+     * @param key     用于对数据进行分类的key
+     * @param config  配置项
      */
-    constructor(key: Memory.Pitch<T, Type>, config: Config<Reactor>);
+    constructor(key: Memory.Pitch<T, Type>, config: Config<T, Reactor>);
     protected getType(data: T): Type;
-    push(...list: T[]): this;
+    /**
+     * 添加数据
+     */
+    push(...values: T[]): this;
     /**
      * 返回位于指定索引处的项
      */

package/dist/memory/basic.js

@@ -1,36 +1,51 @@
 import { hash8strings } from "../convert/strings";
+const PUSH = 1;
+const RESET = 2;
+const DELETE = 0;
+const LIST_SYMBOL = Symbol();
+const MEMORYS_SYMBOL = Symbol();
 class MemoryBasic {
   /**
-   * @param key 用于对数据进行分类的key
-   * @param config 
+   * @param key     用于对数据进行分类的key
+   * @param config  配置项
    */
   constructor(key, config) {
     this.key = key;
     this.#mount = config.mount;
     this.#reflex = config.reflex;
+    this.#emit = config.emit;
   }
+  static PUSH = PUSH;
+  static RESET = RESET;
+  static DELETE = DELETE;
   #mount;
   #reflex;
-  list = [];
-  memorys = /* @__PURE__ */ new Map();
+  #emit;
+  [LIST_SYMBOL] = [];
+  [MEMORYS_SYMBOL] = /* @__PURE__ */ new Map();
   /**
    * 返回存储长度
    */
   get size() {
-    return this.list.length;
+    return this[LIST_SYMBOL].length;
   }
   getType(data) {
     const { key } = this;
     return typeof key === "function" ? key(data) : data[key];
   }
-  push(...list) {
-    const { memorys } = this;
-    list.forEach((data) => {
+  /**
+   * 添加数据
+   */
+  push(...values) {
+    const memorys = this[MEMORYS_SYMBOL];
+    const list = this[LIST_SYMBOL];
+    values.forEach((data) => {
       const type = this.getType(data);
       const memory = memorys.get(type);
-      const index = this.list.push(data) - 1;
+      const index = list.push(data) - 1;
       const result = this.#mount(index, memory);
       memory === result || memorys.set(type, result);
+      this.#emit?.(PUSH, data);
     });
     return this;
   }
@@ -38,24 +53,25 @@ class MemoryBasic {
    * 返回位于指定索引处的项
    */
   at(index) {
-    const { list } = this;
+    const list = this[LIST_SYMBOL];
     if (index < 0) {
       index += list.length;
     }
-    return this.list.at(index);
+    return list.at(index);
   }
   /**
    * 遍历所有存储数据(按入栈顺序)
    */
   forEach(callback) {
-    this.list.forEach(callback);
+    this[LIST_SYMBOL].forEach(callback);
     return this;
   }
   /**
    * 遍历所有存储类型
    */
   forType(callback) {
-    const { memorys, list } = this;
+    const memorys = this[MEMORYS_SYMBOL];
+    const list = this[LIST_SYMBOL];
     for (const [type, memory] of memorys) {
       const caches = this.#reflex(memory).map((index) => list[index]);
       callback(caches, type);
@@ -66,38 +82,39 @@ class MemoryBasic {
    * some(按入栈顺序)
    */
   some(callback) {
-    return this.list.some(callback);
+    return this[LIST_SYMBOL].some(callback);
   }
   /**
    * map(按入栈顺序)
    */
   map(callback) {
-    return this.list.map(callback);
+    return this[LIST_SYMBOL].map(callback);
   }
   /**
    * reduce(按入栈顺序)
    */
   reduce(callback, initialValue) {
-    return this.list.reduce(callback, initialValue);
+    return this[LIST_SYMBOL].reduce(callback, initialValue);
   }
   /**
    * 判断存储是否包含指定类型
    */
   includes(type) {
-    return this.memorys.has(type);
+    return this[MEMORYS_SYMBOL].has(type);
   }
   /**
    * 获取指定类型存储数据
    */
   get(type) {
-    const memory = this.memorys.get(type);
-    return memory === void 0 ? null : this.#reflex(memory).map((count) => this.list[count]);
+    const memory = this[MEMORYS_SYMBOL].get(type);
+    return memory === void 0 ? null : this.#reflex(memory).map((count) => this[LIST_SYMBOL][count]);
   }
   /**
    * 删除指定存储数据
    */
   delete(data) {
-    const { memorys, list } = this;
+    const memorys = this[MEMORYS_SYMBOL];
+    const list = this[LIST_SYMBOL];
     let index = -1;
     if (!list.some((value, i) => {
       if (data === value) {
@@ -133,33 +150,36 @@ class MemoryBasic {
         memorys.set(type, reactor);
       }
     }
+    this.#emit?.(DELETE, index);
     return this;
   }
   /**
    * 删除指定类型存储数据
    */
   deleteType(type) {
-    const { memorys, list } = this;
+    const memorys = this[MEMORYS_SYMBOL];
+    const list = this[LIST_SYMBOL];
     if (!memorys.has(type)) return this;
     const local = hash8strings(this.#reflex(memorys.get(type)));
-    const Memory = this.constructor;
-    const imitator = new Memory(this.key, {
+    const imitator = new MemoryBasic(this.key, {
       mount: this.#mount,
       reflex: this.#reflex
     });
     list.forEach((data, index) => {
       index in local || imitator.push(data);
     });
-    this.list = imitator.list;
-    this.memorys = imitator.memorys;
+    const tmp = this[LIST_SYMBOL] = imitator[LIST_SYMBOL];
+    this[MEMORYS_SYMBOL] = imitator[MEMORYS_SYMBOL];
+    this.#emit?.(RESET, tmp.slice(0));
     return this;
   }
   /**
    * 清理存储
    */
   clear() {
-    this.list = [];
-    this.memorys.clear();
+    this[LIST_SYMBOL] = [];
+    this[MEMORYS_SYMBOL].clear();
+    this.#emit?.(RESET, []);
   }
 }
 export {

package/dist/memory/list.d.ts

@@ -1,8 +1,7 @@
-import { MemoryBasic } from './basic';
-import type { Memory } from './type';
+import { MemoryBasic, type Memory } from './basic';
 /**
  * 分类存储(基于普通的键值存储)
  */
 export declare class MemoryList<T, Type extends Memory.Type = Memory.Type> extends MemoryBasic<T, number[], Type> {
-    constructor(key: Memory.Pitch<T, Type>);
+    constructor(key: Memory.Pitch<T, Type>, emit?: Memory.Emit<T>);
 }

package/dist/memory/list.js

@@ -1,9 +1,10 @@
 import { MemoryBasic } from "./basic";
 class MemoryList extends MemoryBasic {
-  constructor(key) {
+  constructor(key, emit) {
     super(key, {
       mount: (index, reactor) => reactor ? (reactor.push(index), reactor) : [index],
-      reflex: (reactor) => reactor
+      reflex: (reactor) => reactor,
+      emit
     });
   }
 }

package/dist/memory/power.d.ts

@@ -1,8 +1,7 @@
-import { MemoryBasic } from './basic';
-import type { Memory } from './type';
+import { MemoryBasic, type Memory } from './basic';
 /**
  * 分类存储(基于2的n次幂之和构建唯一键进行存储)
  */
 export declare class MemoryPower<T, Type extends Memory.Type = Memory.Type> extends MemoryBasic<T, number, Type> {
-    constructor(key: Memory.Pitch<T, Type>);
+    constructor(key: Memory.Pitch<T, Type>, emit?: Memory.Emit<T>);
 }

package/dist/memory/power.js

@@ -1,10 +1,11 @@
 import { deconPowersSum } from "../power/decon";
 import { MemoryBasic } from "./basic";
 class MemoryPower extends MemoryBasic {
-  constructor(key) {
+  constructor(key, emit) {
     super(key, {
       mount: (index, reactor) => (reactor || 0) + 2 ** index,
-      reflex: (reactor) => deconPowersSum(reactor, "asc")
+      reflex: (reactor) => deconPowersSum(reactor, "asc"),
+      emit
     });
   }
 }

package/dist/memory/simple.d.ts

@@ -1,6 +1,5 @@
 import type { Assign } from '@vope/types';
-import { MemoryBasic } from './basic';
-import type { Memory } from './type';
+import { MemoryBasic, type Memory } from './basic';
 type Transform<T, V> = {
     [P in keyof T]: T[P] extends (...args: any) => any ? (...args: Parameters<T[P]>) => ReturnType<T[P]> extends T ? V : ReturnType<T[P]> : T[P];
 };

package/dist/subscriber.js

@@ -46,7 +46,7 @@ class Subscriber {
           listeners[name].splice(index, 1);
           return true;
         }
-      }) && once[name].some((value, index) => {
+      }) && once[name]?.some((value, index) => {
         if (value === count) {
           listeners[name].splice(index, 1);
           return true;

package/package.json

@@ -1,81 +1,81 @@
-{
-  "name": "@vope/utils",
-  "version": "1.6.8",
-  "description": "",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "types": "./dist/index.d.ts",
-  "typings": "./dist/index.d.ts",
-  "module": "./dist/index.js",
-  "main": "./dist/index.js",
-  "scripts": {
-    "start": "esbuild ./start.ts --outfile=start.cjs --format=cjs & node ./start.cjs",
-    "poststart": "esbuild ./pre.ts --outfile=pre.cjs --format=cjs & node ./pre.cjs",
-    "build": "npm run start & node ./build.cjs",
-    "premocha": "node ./build.cjs --type=test",
-    "mocha": "mocha __tests/**/*.js",
-    "test": "npm run mocha",
-    "prepublishOnly": "npm run build & npm run test",
-    "debug": "npm run start & npm run premocha",
-    "clean": "rimraf start.cjs pre.cjs build.cjs src/index.ts dist/ __tests/ __examples/ sub_storage/"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs.js"
-    },
-    "./storage": {
-      "types": "./sub_storage/offline.d.ts",
-      "import": "./sub_storage/offline.js",
-      "require": "./sub_storage/offline.cjs.js"
-    }
-  },
-  "author": "vope",
-  "license": "ISC",
-  "files": [
-    "dist",
-    "sub_storage"
-  ],
-  "devDependencies": {
-    "@babel/parser": "^7.26.9",
-    "@babel/traverse": "^7.26.9",
-    "@babel/types": "^7.26.9",
-    "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.2",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.0",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/babel__traverse": "^7.20.6",
-    "@types/mocha": "^10.0.6",
-    "@types/node": "^22.13.5",
-    "@types/sm-crypto": "^0.3.4",
-    "esbuild": "^0.25.0",
-    "glob": "^11.0.1",
-    "iconv-lite": "^0.6.3",
-    "mocha": "^10.2.0",
-    "puppeteer": "^24.3.0",
-    "rimraf": "^5.0.5",
-    "rollup": "^4.34.8",
-    "tslib": "^2.8.1",
-    "typescript": "^5.9.2",
-    "uuid": "^11.1.0"
-  },
-  "dependencies": {
-    "@type-challenges/utils": "^0.1.1",
-    "@types/lodash-es": "^4.17.12",
-    "@vope/types": "^1.2.0",
-    "csstype": "^3.1.3",
-    "localforage": "^1.10.0",
-    "lodash-es": "^4.17.21",
-    "sm-crypto": "^0.3.13"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild",
-      "puppeteer"
-    ]
-  }
-}
+{
+  "name": "@vope/utils",
+  "version": "1.7.0",
+  "description": "",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "types": "./dist/index.d.ts",
+  "typings": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "main": "./dist/index.js",
+  "scripts": {
+    "start": "esbuild ./start.ts --outfile=start.cjs --format=cjs & node ./start.cjs",
+    "poststart": "esbuild ./pre.ts --outfile=pre.cjs --format=cjs & node ./pre.cjs",
+    "build": "npm run start & node ./build.cjs",
+    "premocha": "node ./build.cjs --type=test",
+    "mocha": "mocha __tests/**/*.js",
+    "test": "npm run mocha",
+    "prepublishOnly": "npm run build & npm run test",
+    "debug": "npm run start & npm run premocha",
+    "clean": "rimraf start.cjs pre.cjs build.cjs src/index.ts dist/ __tests/ __examples/ sub_storage/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs.js"
+    },
+    "./storage": {
+      "types": "./sub_storage/offline.d.ts",
+      "import": "./sub_storage/offline.js",
+      "require": "./sub_storage/offline.cjs.js"
+    }
+  },
+  "author": "vope",
+  "license": "ISC",
+  "files": [
+    "dist",
+    "sub_storage"
+  ],
+  "devDependencies": {
+    "@babel/parser": "^7.26.9",
+    "@babel/traverse": "^7.26.9",
+    "@babel/types": "^7.26.9",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/babel__traverse": "^7.20.6",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^22.13.5",
+    "@types/sm-crypto": "^0.3.4",
+    "esbuild": "^0.25.0",
+    "glob": "^11.0.1",
+    "iconv-lite": "^0.6.3",
+    "mocha": "^10.2.0",
+    "puppeteer": "^24.3.0",
+    "rimraf": "^5.0.5",
+    "rollup": "^4.34.8",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.2",
+    "uuid": "^11.1.0"
+  },
+  "dependencies": {
+    "@type-challenges/utils": "^0.1.1",
+    "@types/lodash-es": "^4.17.12",
+    "@vope/types": "^1.2.0",
+    "csstype": "^3.2.3",
+    "localforage": "^1.10.0",
+    "lodash-es": "^4.17.21",
+    "sm-crypto": "^0.3.13"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "puppeteer"
+    ]
+  }
+}

package/dist/memory/type.d.ts

@@ -1,11 +0,0 @@
-import { GetGivenProps } from '@vope/types'
-
-export namespace Memory { 
-  type Type = string | number | symbol
-
-  type Pitch<Data, Type> = (
-    Data extends object
-      ? GetGivenProps<Data, Type>
-      : never
-  ) | ((data: Data) => Type)
-}