@vef-framework/shared 1.0.134 → 2.0.0

package/dist/cjs/utils/error.cjs

@@ -0,0 +1,60 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const stackTrace = require('stacktrace-js');
+const path = require('./path.cjs');
+
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: 'Module' } });
+  if (e) {
+    for (const k in e) {
+      if (k !== 'default') {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+const stackTrace__namespace = /*#__PURE__*/_interopNamespaceDefault(stackTrace);
+
+async function parseErrorStack(error, filter) {
+  return await stackTrace__namespace.fromError(error, {
+    offline: true,
+    filter
+  });
+}
+function filterUserFrame(stackFrame) {
+  return !stackFrame.fileName || !stackFrame.fileName.includes("node_modules");
+}
+async function getSanitizedErrorStack(error) {
+  const frames = await parseErrorStack(error, filterUserFrame);
+  const cleanStack = frames.map((frame) => `    at ${frame.functionName || "anonymous"} (${frame.fileName ? path.getBaseName(frame.fileName, true) : "unknown"}:${frame.lineNumber}:${frame.columnNumber})`).join("\n");
+  return `${error.name}: ${error.message}
+${cleanStack}`;
+}
+async function getCurrentStack(filter) {
+  return await stackTrace__namespace.get({
+    offline: true,
+    filter
+  });
+}
+function getCurrentStackSync(filter) {
+  return stackTrace__namespace.getSync({
+    offline: true,
+    filter
+  });
+}
+
+exports.filterUserFrame = filterUserFrame;
+exports.getCurrentStack = getCurrentStack;
+exports.getCurrentStackSync = getCurrentStackSync;
+exports.getSanitizedErrorStack = getSanitizedErrorStack;
+exports.parseErrorStack = parseErrorStack;

package/dist/cjs/utils/event.cjs

@@ -0,0 +1,62 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const mitt = require('mitt');
+
+class EventEmitter {
+  /** Private mitt instance for handling the actual event operations */
+  #bus = mitt();
+  /**
+   * Subscribe to an event with a listener function.
+   * Returns an unsubscribe function for easy cleanup.
+   *
+   * @param eventType - The type of event to listen for
+   * @param eventListener - The function to call when the event is emitted
+   * @returns A function that removes this specific listener when called
+   */
+  on(eventType, eventListener) {
+    this.#bus.on(eventType, eventListener);
+    return () => {
+      this.#bus.off(eventType, eventListener);
+    };
+  }
+  emit(eventType, eventPayload) {
+    if (eventPayload) {
+      this.#bus.emit(eventType, eventPayload);
+    } else {
+      this.#bus.emit(eventType);
+    }
+  }
+  /**
+   * Remove a specific listener for an event type.
+   * If no listener is provided, removes all listeners for that event type.
+   *
+   * @param eventType - The type of event to remove listeners from
+   * @param eventListener - Optional specific listener to remove
+   */
+  off(eventType, eventListener) {
+    this.#bus.off(eventType, eventListener);
+  }
+  /**
+   * Remove all event listeners from all event types.
+   * Useful for cleanup when the emitter is no longer needed.
+   */
+  clear() {
+    this.#bus.all.clear();
+  }
+  /**
+   * Get all registered listeners for debugging purposes.
+   * Returns a Map of event types to their listener arrays.
+   */
+  getAllListeners() {
+    return this.#bus.all;
+  }
+}
+function createEventEmitter() {
+  return new EventEmitter();
+}
+
+exports.EventEmitter = EventEmitter;
+exports.createEventEmitter = createEventEmitter;

package/dist/cjs/utils/format.cjs

@@ -0,0 +1,31 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const BYTES_UNIT = 1024;
+const BYTE_SIZES = ["B", "KB", "MB", "GB", "TB", "PB"];
+const NUMBER_UNIT = 1e3;
+const NUMBER_UNITS = ["", "K", "M", "B", "T"];
+function formatBytes(bytes, decimals = 2) {
+  if (bytes === 0) {
+    return "0 B";
+  }
+  const dm = Math.max(decimals, 0);
+  const i = Math.floor(Math.log(bytes) / Math.log(BYTES_UNIT));
+  return `${Number.parseFloat((bytes / BYTES_UNIT ** i).toFixed(dm))} ${BYTE_SIZES[i]}`;
+}
+function formatNumber(num, decimals = 2) {
+  if (num === 0) {
+    return "0";
+  }
+  if (num < NUMBER_UNIT) {
+    return num.toString();
+  }
+  const dm = Math.max(decimals, 0);
+  const i = Math.floor(Math.log(num) / Math.log(NUMBER_UNIT));
+  return `${Number.parseFloat((num / NUMBER_UNIT ** i).toFixed(dm))} ${NUMBER_UNITS[i]}`;
+}
+
+exports.formatBytes = formatBytes;
+exports.formatNumber = formatNumber;

package/dist/cjs/utils/function.cjs

@@ -0,0 +1,49 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+function isAsyncFunction(fn) {
+  return fn.constructor.name === "AsyncFunction" || Object.prototype.toString.call(fn) === "[object AsyncFunction]" || fn.toString().startsWith("async ");
+}
+async function invokeAwaitableFn(fn, args, options) {
+  const {
+    onInvoke,
+    onSuccess,
+    onError,
+    onFinally
+  } = options;
+  const returned = fn(...args);
+  if (returned instanceof Promise) {
+    let context;
+    try {
+      context = onInvoke?.();
+      const result = await returned;
+      onSuccess?.(result, context);
+      return result;
+    } catch (error) {
+      onError?.(error, context);
+      throw error;
+    } finally {
+      onFinally?.(context);
+    }
+  } else {
+    return returned;
+  }
+}
+function identity(value) {
+  return value;
+}
+function createThrowNotImplementedFn(feature) {
+  return () => throwNotImplemented(feature);
+}
+function throwNotImplemented(feature) {
+  const label = feature ? `${feature} not implemented` : "Not implemented";
+  throw new Error(label);
+}
+
+exports.createThrowNotImplementedFn = createThrowNotImplementedFn;
+exports.identity = identity;
+exports.invokeAwaitableFn = invokeAwaitableFn;
+exports.isAsyncFunction = isAsyncFunction;
+exports.throwNotImplemented = throwNotImplemented;

package/dist/cjs/utils/id.cjs

@@ -0,0 +1,38 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const cuid2 = require('@paralleldrive/cuid2');
+const radashi = require('radashi');
+
+function isFingerprintSupported() {
+  if (radashi.isNullish(navigator)) {
+    return false;
+  }
+  if (navigator.userAgent.includes("jsdom")) {
+    return false;
+  }
+  return true;
+}
+let createId = cuid2.init({
+  length: 16,
+  // vef-framework default fingerprint
+  fingerprint: "0cd902ccad1f26c27b8db84af2282b7b"
+});
+if (isFingerprintSupported()) {
+  import('@fingerprintjs/fingerprintjs').then(({ load }) => load()).then((fp) => fp.get()).then((result) => {
+    const fingerprint = result.visitorId;
+    createId = cuid2.init({
+      length: 16,
+      fingerprint
+    });
+  }).catch((error) => {
+    console.error("Failed to initialize fingerprint:", error);
+  });
+}
+function generateId() {
+  return createId();
+}
+
+exports.generateId = generateId;

package/dist/cjs/utils/index.cjs

@@ -0,0 +1,86 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const chrono = require('./chrono.cjs');
+const equal = require('./equal.cjs');
+const error = require('./error.cjs');
+const event = require('./event.cjs');
+const format = require('./format.cjs');
+const _function = require('./function.cjs');
+const id = require('./id.cjs');
+const key = require('./key.cjs');
+const lib = require('./lib.cjs');
+const object = require('./object.cjs');
+const path = require('./path.cjs');
+const pinyin = require('./pinyin.cjs');
+const security = require('./security.cjs');
+const string = require('./string.cjs');
+const task = require('./task.cjs');
+const tree = require('./tree.cjs');
+require('./zod.cjs');
+
+
+
+exports.DEFAULT_DATETIME_FORMAT = chrono.DEFAULT_DATETIME_FORMAT;
+exports.DEFAULT_DATE_FORMAT = chrono.DEFAULT_DATE_FORMAT;
+exports.DEFAULT_TIME_FORMAT = chrono.DEFAULT_TIME_FORMAT;
+exports.LOCALIZED_DATETIME_FORMAT = chrono.LOCALIZED_DATETIME_FORMAT;
+exports.LOCALIZED_DATE_FORMAT = chrono.LOCALIZED_DATE_FORMAT;
+exports.formatDate = chrono.formatDate;
+exports.formatDuration = chrono.formatDuration;
+exports.getLocalizedDateTime = chrono.getLocalizedDateTime;
+exports.getNow = chrono.getNow;
+exports.getNowDateString = chrono.getNowDateString;
+exports.getNowDateTimeString = chrono.getNowDateTimeString;
+exports.getNowTimeString = chrono.getNowTimeString;
+exports.getTemporalFormats = chrono.getTemporalFormats;
+exports.parseDate = chrono.parseDate;
+exports.tryParseDate = chrono.tryParseDate;
+exports.isDeepEqual = equal.isDeepEqual;
+exports.isShallowEqual = equal.isShallowEqual;
+exports.filterUserFrame = error.filterUserFrame;
+exports.getCurrentStack = error.getCurrentStack;
+exports.getCurrentStackSync = error.getCurrentStackSync;
+exports.getSanitizedErrorStack = error.getSanitizedErrorStack;
+exports.parseErrorStack = error.parseErrorStack;
+exports.EventEmitter = event.EventEmitter;
+exports.createEventEmitter = event.createEventEmitter;
+exports.formatBytes = format.formatBytes;
+exports.formatNumber = format.formatNumber;
+exports.createThrowNotImplementedFn = _function.createThrowNotImplementedFn;
+exports.identity = _function.identity;
+exports.invokeAwaitableFn = _function.invokeAwaitableFn;
+exports.isAsyncFunction = _function.isAsyncFunction;
+exports.throwNotImplemented = _function.throwNotImplemented;
+exports.generateId = id.generateId;
+exports.hashKey = key.hashKey;
+exports.alwaysFalse = lib.alwaysFalse;
+exports.alwaysTrue = lib.alwaysTrue;
+exports.mergeWith = object.mergeWith;
+exports.formatPath = path.formatPath;
+exports.getBaseName = path.getBaseName;
+exports.getDirName = path.getDirName;
+exports.getExtName = path.getExtName;
+exports.getRelativePath = path.getRelativePath;
+exports.isAbsolutePath = path.isAbsolutePath;
+exports.joinPaths = path.joinPaths;
+exports.normalizePath = path.normalizePath;
+exports.parsePath = path.parsePath;
+exports.pathSeparator = path.pathSeparator;
+exports.resolvePath = path.resolvePath;
+exports.getPinyin = pinyin.getPinyin;
+exports.getPinyinInitials = pinyin.getPinyinInitials;
+exports.withPinyin = pinyin.withPinyin;
+exports.decryptUsingRSA = security.decryptUsingRSA;
+exports.encryptUsingRSA = security.encryptUsingRSA;
+exports.constantCase = string.constantCase;
+exports.scheduleMicrotask = task.scheduleMicrotask;
+exports.buildTree = tree.buildTree;
+exports.filterTree = tree.filterTree;
+exports.filterTreeWithAncestors = tree.filterTreeWithAncestors;
+exports.findNodeInTree = tree.findNodeInTree;
+exports.flattenTree = tree.flattenTree;
+exports.mapTree = tree.mapTree;
+exports.traverseTree = tree.traverseTree;

package/dist/cjs/utils/key.cjs

@@ -0,0 +1,34 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+require('./lib.cjs');
+const radashi = require('radashi');
+
+function hashKey(key) {
+  return JSON.stringify(
+    key,
+    (_, value) => {
+      if (radashi.isPlainObject(value)) {
+        const stringKeys = Object.keys(value).toSorted();
+        const symbolKeys = Object.getOwnPropertySymbols(value);
+        const result = {};
+        for (const key2 of stringKeys) {
+          result[key2] = value[key2];
+        }
+        const symbolResult = {};
+        for (const sym of symbolKeys) {
+          symbolResult[sym.toString()] = value[sym];
+        }
+        for (const key2 of Object.keys(symbolResult).toSorted()) {
+          result[`@@${key2}`] = symbolResult[key2];
+        }
+        return result;
+      }
+      return value;
+    }
+  );
+}
+
+exports.hashKey = hashKey;

package/dist/cjs/utils/lib.cjs

@@ -0,0 +1,234 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const radashi = require('radashi');
+const klona = require('klona');
+const qs = require('qs');
+
+const alwaysTrue = radashi.always(true);
+const alwaysFalse = radashi.always(false);
+
+Object.defineProperty(exports, "always", {
+  enumerable: true,
+  get: () => radashi.always
+});
+Object.defineProperty(exports, "assign", {
+  enumerable: true,
+  get: () => radashi.assign
+});
+Object.defineProperty(exports, "camelCase", {
+  enumerable: true,
+  get: () => radashi.camel
+});
+Object.defineProperty(exports, "capitalize", {
+  enumerable: true,
+  get: () => radashi.capitalize
+});
+Object.defineProperty(exports, "cluster", {
+  enumerable: true,
+  get: () => radashi.cluster
+});
+Object.defineProperty(exports, "debounce", {
+  enumerable: true,
+  get: () => radashi.debounce
+});
+Object.defineProperty(exports, "first", {
+  enumerable: true,
+  get: () => radashi.first
+});
+Object.defineProperty(exports, "get", {
+  enumerable: true,
+  get: () => radashi.get
+});
+Object.defineProperty(exports, "isArray", {
+  enumerable: true,
+  get: () => radashi.isArray
+});
+Object.defineProperty(exports, "isBigInt", {
+  enumerable: true,
+  get: () => radashi.isBigInt
+});
+Object.defineProperty(exports, "isBoolean", {
+  enumerable: true,
+  get: () => radashi.isBoolean
+});
+Object.defineProperty(exports, "isDate", {
+  enumerable: true,
+  get: () => radashi.isDate
+});
+Object.defineProperty(exports, "isEmpty", {
+  enumerable: true,
+  get: () => radashi.isEmpty
+});
+Object.defineProperty(exports, "isError", {
+  enumerable: true,
+  get: () => radashi.isError
+});
+Object.defineProperty(exports, "isFloat", {
+  enumerable: true,
+  get: () => radashi.isFloat
+});
+Object.defineProperty(exports, "isFunction", {
+  enumerable: true,
+  get: () => radashi.isFunction
+});
+Object.defineProperty(exports, "isInt", {
+  enumerable: true,
+  get: () => radashi.isInt
+});
+Object.defineProperty(exports, "isIntString", {
+  enumerable: true,
+  get: () => radashi.isIntString
+});
+Object.defineProperty(exports, "isMap", {
+  enumerable: true,
+  get: () => radashi.isMap
+});
+Object.defineProperty(exports, "isNullish", {
+  enumerable: true,
+  get: () => radashi.isNullish
+});
+Object.defineProperty(exports, "isNumber", {
+  enumerable: true,
+  get: () => radashi.isNumber
+});
+Object.defineProperty(exports, "isObject", {
+  enumerable: true,
+  get: () => radashi.isObject
+});
+Object.defineProperty(exports, "isPlainObject", {
+  enumerable: true,
+  get: () => radashi.isPlainObject
+});
+Object.defineProperty(exports, "isPrimitive", {
+  enumerable: true,
+  get: () => radashi.isPrimitive
+});
+Object.defineProperty(exports, "isPromise", {
+  enumerable: true,
+  get: () => radashi.isPromise
+});
+Object.defineProperty(exports, "isRegExp", {
+  enumerable: true,
+  get: () => radashi.isRegExp
+});
+Object.defineProperty(exports, "isSet", {
+  enumerable: true,
+  get: () => radashi.isSet
+});
+Object.defineProperty(exports, "isString", {
+  enumerable: true,
+  get: () => radashi.isString
+});
+Object.defineProperty(exports, "isSymbol", {
+  enumerable: true,
+  get: () => radashi.isSymbol
+});
+Object.defineProperty(exports, "isUndefined", {
+  enumerable: true,
+  get: () => radashi.isUndefined
+});
+Object.defineProperty(exports, "isWeakMap", {
+  enumerable: true,
+  get: () => radashi.isWeakMap
+});
+Object.defineProperty(exports, "isWeakSet", {
+  enumerable: true,
+  get: () => radashi.isWeakSet
+});
+Object.defineProperty(exports, "kebabCase", {
+  enumerable: true,
+  get: () => radashi.dash
+});
+Object.defineProperty(exports, "last", {
+  enumerable: true,
+  get: () => radashi.last
+});
+Object.defineProperty(exports, "max", {
+  enumerable: true,
+  get: () => radashi.max
+});
+Object.defineProperty(exports, "memoize", {
+  enumerable: true,
+  get: () => radashi.memo
+});
+Object.defineProperty(exports, "min", {
+  enumerable: true,
+  get: () => radashi.min
+});
+Object.defineProperty(exports, "noop", {
+  enumerable: true,
+  get: () => radashi.noop
+});
+Object.defineProperty(exports, "omit", {
+  enumerable: true,
+  get: () => radashi.omit
+});
+Object.defineProperty(exports, "once", {
+  enumerable: true,
+  get: () => radashi.once
+});
+Object.defineProperty(exports, "pascalCase", {
+  enumerable: true,
+  get: () => radashi.pascal
+});
+Object.defineProperty(exports, "pick", {
+  enumerable: true,
+  get: () => radashi.pick
+});
+Object.defineProperty(exports, "set", {
+  enumerable: true,
+  get: () => radashi.set
+});
+Object.defineProperty(exports, "similarity", {
+  enumerable: true,
+  get: () => radashi.similarity
+});
+Object.defineProperty(exports, "snakeCase", {
+  enumerable: true,
+  get: () => radashi.snake
+});
+Object.defineProperty(exports, "sum", {
+  enumerable: true,
+  get: () => radashi.sum
+});
+Object.defineProperty(exports, "template", {
+  enumerable: true,
+  get: () => radashi.template
+});
+Object.defineProperty(exports, "throttle", {
+  enumerable: true,
+  get: () => radashi.throttle
+});
+Object.defineProperty(exports, "toFloat", {
+  enumerable: true,
+  get: () => radashi.toFloat
+});
+Object.defineProperty(exports, "toInt", {
+  enumerable: true,
+  get: () => radashi.toInt
+});
+Object.defineProperty(exports, "trim", {
+  enumerable: true,
+  get: () => radashi.trim
+});
+Object.defineProperty(exports, "unique", {
+  enumerable: true,
+  get: () => radashi.unique
+});
+Object.defineProperty(exports, "cloneDeep", {
+  enumerable: true,
+  get: () => klona.klona
+});
+Object.defineProperty(exports, "decodeQueryString", {
+  enumerable: true,
+  get: () => qs.parse
+});
+Object.defineProperty(exports, "encodeQueryString", {
+  enumerable: true,
+  get: () => qs.stringify
+});
+exports.alwaysFalse = alwaysFalse;
+exports.alwaysTrue = alwaysTrue;

package/dist/cjs/utils/object.cjs

@@ -0,0 +1,20 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+require('./lib.cjs');
+const radashi = require('radashi');
+
+function mergeWith(target, source, overrideExisting = false) {
+  const validEntries = Object.entries(source).filter(([_, value]) => !radashi.isUndefined(value));
+  for (const [key, value] of validEntries) {
+    const targetKey = key;
+    if (overrideExisting || radashi.isUndefined(target[targetKey])) {
+      target[targetKey] = value;
+    }
+  }
+  return target;
+}
+
+exports.mergeWith = mergeWith;

package/dist/cjs/utils/path.cjs

@@ -0,0 +1,63 @@
+/*! @vef-framework/shared v2.0.0 made with ❤️ by Venus | 2025-11-25T10:06:28.916Z */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const path = require('path-browserify');
+
+const {
+  basename,
+  dirname,
+  extname,
+  isAbsolute,
+  join,
+  normalize,
+  parse,
+  relative,
+  resolve,
+  format,
+  sep: pathSeparator
+} = path;
+function getBaseName(path2, keepExt = true) {
+  const ext = keepExt ? void 0 : extname(path2);
+  return basename(path2, ext);
+}
+function getExtName(path2) {
+  return extname(path2);
+}
+function getDirName(path2) {
+  return dirname(path2);
+}
+function joinPaths(...paths) {
+  return join(...paths);
+}
+function isAbsolutePath(path2) {
+  return isAbsolute(path2);
+}
+function normalizePath(path2) {
+  return normalize(path2);
+}
+function parsePath(path2) {
+  return parse(path2);
+}
+function formatPath(pathObject) {
+  return format(pathObject);
+}
+function getRelativePath(from, to) {
+  return relative(from, to);
+}
+function resolvePath(...pathSegments) {
+  return resolve(...pathSegments);
+}
+
+exports.formatPath = formatPath;
+exports.getBaseName = getBaseName;
+exports.getDirName = getDirName;
+exports.getExtName = getExtName;
+exports.getRelativePath = getRelativePath;
+exports.isAbsolutePath = isAbsolutePath;
+exports.joinPaths = joinPaths;
+exports.normalizePath = normalizePath;
+exports.parsePath = parsePath;
+exports.pathSeparator = pathSeparator;
+exports.resolvePath = resolvePath;