@sunyard-szyy-ui/utils 0.2.0

package/README.md

@@ -0,0 +1,3 @@
+# @sunyard-szyy-ui/utils
+
+工具函数库，包含常用的工具函数和 Vite 插件 resolver。

package/dist/index.cjs

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SunyardSzyyUIResolver: () => SunyardSzyyUIResolver,
+  debounce: () => debounce,
+  deepClone: () => deepClone,
+  formatDate: () => formatDate,
+  throttle: () => throttle,
+  withInstall: () => withInstall
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/resolver.ts
+function pascalToKebab(str, prefix = "Sy") {
+  return str.slice(prefix.length).replace(/([A-Z])/g, "-$1").toLowerCase().slice(1);
+}
+function SunyardSzyyUIResolver(options = {}) {
+  const {
+    prefix = "Sy",
+    importStyle = true,
+    libraryName = "sunyard-szyy-ui",
+    styleLibraryName = "@sunyard-szyy-ui/theme-chalk",
+    componentsLibraryName = "@sunyard-szyy-ui/components",
+    devMode = false,
+    importMetaUrl,
+    fileURLToPath,
+    dirResolver
+  } = options;
+  if (devMode && !dirResolver) {
+    if (!importMetaUrl || !fileURLToPath) {
+      throw new Error(
+        "[SunyardSzyyUIResolver] devMode \u542F\u7528\u65F6\u5FC5\u987B\u63D0\u4F9B importMetaUrl \u548C fileURLToPath \u53C2\u6570\n\u793A\u4F8B\uFF1A\nimport { fileURLToPath } from 'node:url';\nSunyardSzyyUIResolver({ devMode: true, importMetaUrl: import.meta.url, fileURLToPath })"
+      );
+    }
+  }
+  let actualDirResolver = dirResolver;
+  if (devMode && importMetaUrl && fileURLToPath && !dirResolver) {
+    actualDirResolver = (name) => {
+      const styleFile = importStyle === "scss" ? "index.ts" : "css.ts";
+      return {
+        componentPath: fileURLToPath(new URL(`../packages/components/src/${name}/index.ts`, importMetaUrl)),
+        stylePath: fileURLToPath(new URL(`../packages/components/src/${name}/style/${styleFile}`, importMetaUrl))
+      };
+    };
+  }
+  return {
+    type: "component",
+    resolve: (name) => {
+      if (name.startsWith(prefix)) {
+        const componentName = pascalToKebab(name, prefix);
+        if (actualDirResolver) {
+          const paths = actualDirResolver(componentName);
+          if (paths.componentPath) {
+            return {
+              name,
+              from: paths.componentPath,
+              sideEffects: importStyle && paths.stylePath ? paths.stylePath : void 0
+            };
+          }
+        }
+        const result = {
+          name,
+          from: libraryName
+        };
+        if (importStyle) {
+          if (importStyle === "css") {
+            result.sideEffects = `${styleLibraryName}/${componentName}.css`;
+          } else if (importStyle === "scss") {
+            result.sideEffects = `${styleLibraryName}/src/${componentName}.scss`;
+          } else if (importStyle === true) {
+            result.sideEffects = `${styleLibraryName}/${componentName}.css`;
+          }
+        }
+        return result;
+      }
+    }
+  };
+}
+
+// src/index.ts
+function withInstall(component) {
+  const c = component;
+  c.install = (app) => {
+    const name = component.name;
+    if (!name) return;
+    app.component(name, component);
+  };
+  return c;
+}
+function debounce(fn, delay = 300) {
+  let timer = null;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn.apply(this, args);
+      timer = null;
+    }, delay);
+  };
+}
+function throttle(fn, delay = 300) {
+  let lastTime = 0;
+  return function(...args) {
+    const now = Date.now();
+    if (now - lastTime >= delay) {
+      fn.apply(this, args);
+      lastTime = now;
+    }
+  };
+}
+function formatDate(date, format = "YYYY-MM-DD HH:mm:ss") {
+  const d = typeof date === "number" ? new Date(date) : date;
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  const hours = String(d.getHours()).padStart(2, "0");
+  const minutes = String(d.getMinutes()).padStart(2, "0");
+  const seconds = String(d.getSeconds()).padStart(2, "0");
+  return format.replace("YYYY", String(year)).replace("MM", month).replace("DD", day).replace("HH", hours).replace("mm", minutes).replace("ss", seconds);
+}
+function deepClone(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (obj instanceof Date) {
+    return new Date(obj.getTime());
+  }
+  if (obj instanceof Array) {
+    return obj.map((item) => deepClone(item));
+  }
+  if (typeof obj === "object") {
+    const clonedObj = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        clonedObj[key] = deepClone(obj[key]);
+      }
+    }
+    return clonedObj;
+  }
+  return obj;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SunyardSzyyUIResolver,
+  debounce,
+  deepClone,
+  formatDate,
+  throttle,
+  withInstall
+});

package/dist/index.d.cts

@@ -0,0 +1,188 @@
+import * as vue from 'vue';
+
+/**
+ * 组件解析器类型（兼容 unplugin-vue-components）
+ */
+interface ComponentResolver {
+    type: 'component' | 'directive';
+    resolve: (name: string) => ComponentResolveResult | void | null | undefined;
+}
+/**
+ * 组件解析结果
+ */
+interface ComponentResolveResult {
+    name?: string;
+    from: string;
+    sideEffects?: string | string[];
+    [key: string]: any;
+}
+/**
+ * Resolver 配置选项
+ */
+interface SunyardSzyyUIResolverOptions {
+    /**
+     * 组件前缀
+     * @default 'Sy'
+     */
+    prefix?: string;
+    /**
+     * 是否导入样式
+     * @default true
+     */
+    importStyle?: boolean | 'css' | 'scss';
+    /**
+     * 组件库名称
+     * @default 'sunyard-szyy-ui'
+     */
+    libraryName?: string;
+    /**
+     * 样式包名称
+     * @default '@sunyard-szyy-ui/theme-chalk'
+     */
+    styleLibraryName?: string;
+    /**
+     * 组件目录名称
+     * @default '@sunyard-szyy-ui/components'
+     */
+    componentsLibraryName?: string;
+    /**
+     * 是否为源码开发模式（monorepo 内部开发）
+     *
+     * 启用后会自动使用 monorepo 源码路径，无需手动配置 dirResolver
+     *
+     * @default false
+     *
+     * @example
+     * // 在 monorepo 开发环境中使用
+     * import { fileURLToPath } from 'node:url';
+     *
+     * SunyardSzyyUIResolver({
+     *   devMode: true,
+     *   importMetaUrl: import.meta.url,
+     *   fileURLToPath: fileURLToPath
+     * })
+     */
+    devMode?: boolean;
+    /**
+     * import.meta.url（devMode 启用时必须提供）
+     *
+     * 用于解析 monorepo 源码的绝对路径
+     *
+     * @example
+     * import.meta.url
+     */
+    importMetaUrl?: string;
+    /**
+     * fileURLToPath 函数（devMode 启用时必须提供）
+     *
+     * 用于将 URL 转换为文件系统路径
+     *
+     * @example
+     * import { fileURLToPath } from 'node:url';
+     * // 然后传入: fileURLToPath: fileURLToPath
+     */
+    fileURLToPath?: (url: string | URL) => string;
+    /**
+     * 自定义目录解析器（高级用法，一般不需要）
+     *
+     * 如果提供了此选项，会覆盖 devMode 的默认行为
+     *
+     * @deprecated 推荐使用 devMode + importMetaUrl 替代
+     */
+    dirResolver?: (name: string) => {
+        /**
+         * 组件源码路径（开发模式使用）
+         */
+        componentPath?: string;
+        /**
+         * 样式源码路径（开发模式使用）
+         */
+        stylePath?: string;
+    };
+}
+/**
+ * sunyard-szyy-ui 组件自动导入 resolver
+ *
+ * 支持组件和样式的按需自动导入，适用于：
+ * - ✅ 外部项目使用（npm 包方式）
+ * - ✅ Monorepo 内部开发（源码方式）
+ *
+ * @example
+ * // 外部项目使用（默认配置）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ *
+ * Components({
+ *   resolvers: [SunyardSzyyUIResolver()]
+ * })
+ *
+ * @example
+ * // Monorepo 内部开发（推荐方式 - 简化配置）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ *
+ * Components({
+ *   resolvers: [
+ *     SunyardSzyyUIResolver({
+ *       devMode: true,
+ *       importMetaUrl: import.meta.url
+ *     })
+ *   ]
+ * })
+ *
+ * @example
+ * // Monorepo 内部开发（高级用法 - 自定义路径）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ * import { fileURLToPath, URL } from 'node:url';
+ *
+ * Components({
+ *   resolvers: [
+ *     SunyardSzyyUIResolver({
+ *       dirResolver: (name) => ({
+ *         componentPath: fileURLToPath(
+ *           new URL(`./packages/components/src/${name}/index.ts`, import.meta.url)
+ *         ),
+ *         stylePath: fileURLToPath(
+ *           new URL(`./packages/components/src/${name}/style/css.ts`, import.meta.url)
+ *         )
+ *       })
+ *     })
+ *   ]
+ * })
+ */
+declare function SunyardSzyyUIResolver(options?: SunyardSzyyUIResolverOptions): ComponentResolver;
+
+type SFCWithInstall<T> = T & {
+    install(app: vue.App): void;
+};
+declare function withInstall<T>(component: T & {
+    name?: string;
+}): SFCWithInstall<T>;
+
+/**
+ * 防抖函数
+ * @param fn 要防抖的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 防抖后的函数
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ * @param fn 要节流的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 节流后的函数
+ */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * 格式化日期
+ * @param date 日期对象或时间戳
+ * @param format 格式化字符串，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ */
+declare function formatDate(date: Date | number, format?: string): string;
+/**
+ * 深拷贝
+ * @param obj 要拷贝的对象
+ * @returns 拷贝后的对象
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { type ComponentResolveResult, type ComponentResolver, type SFCWithInstall, SunyardSzyyUIResolver, type SunyardSzyyUIResolverOptions, debounce, deepClone, formatDate, throttle, withInstall };

package/dist/index.d.ts

@@ -0,0 +1,188 @@
+import * as vue from 'vue';
+
+/**
+ * 组件解析器类型（兼容 unplugin-vue-components）
+ */
+interface ComponentResolver {
+    type: 'component' | 'directive';
+    resolve: (name: string) => ComponentResolveResult | void | null | undefined;
+}
+/**
+ * 组件解析结果
+ */
+interface ComponentResolveResult {
+    name?: string;
+    from: string;
+    sideEffects?: string | string[];
+    [key: string]: any;
+}
+/**
+ * Resolver 配置选项
+ */
+interface SunyardSzyyUIResolverOptions {
+    /**
+     * 组件前缀
+     * @default 'Sy'
+     */
+    prefix?: string;
+    /**
+     * 是否导入样式
+     * @default true
+     */
+    importStyle?: boolean | 'css' | 'scss';
+    /**
+     * 组件库名称
+     * @default 'sunyard-szyy-ui'
+     */
+    libraryName?: string;
+    /**
+     * 样式包名称
+     * @default '@sunyard-szyy-ui/theme-chalk'
+     */
+    styleLibraryName?: string;
+    /**
+     * 组件目录名称
+     * @default '@sunyard-szyy-ui/components'
+     */
+    componentsLibraryName?: string;
+    /**
+     * 是否为源码开发模式（monorepo 内部开发）
+     *
+     * 启用后会自动使用 monorepo 源码路径，无需手动配置 dirResolver
+     *
+     * @default false
+     *
+     * @example
+     * // 在 monorepo 开发环境中使用
+     * import { fileURLToPath } from 'node:url';
+     *
+     * SunyardSzyyUIResolver({
+     *   devMode: true,
+     *   importMetaUrl: import.meta.url,
+     *   fileURLToPath: fileURLToPath
+     * })
+     */
+    devMode?: boolean;
+    /**
+     * import.meta.url（devMode 启用时必须提供）
+     *
+     * 用于解析 monorepo 源码的绝对路径
+     *
+     * @example
+     * import.meta.url
+     */
+    importMetaUrl?: string;
+    /**
+     * fileURLToPath 函数（devMode 启用时必须提供）
+     *
+     * 用于将 URL 转换为文件系统路径
+     *
+     * @example
+     * import { fileURLToPath } from 'node:url';
+     * // 然后传入: fileURLToPath: fileURLToPath
+     */
+    fileURLToPath?: (url: string | URL) => string;
+    /**
+     * 自定义目录解析器（高级用法，一般不需要）
+     *
+     * 如果提供了此选项，会覆盖 devMode 的默认行为
+     *
+     * @deprecated 推荐使用 devMode + importMetaUrl 替代
+     */
+    dirResolver?: (name: string) => {
+        /**
+         * 组件源码路径（开发模式使用）
+         */
+        componentPath?: string;
+        /**
+         * 样式源码路径（开发模式使用）
+         */
+        stylePath?: string;
+    };
+}
+/**
+ * sunyard-szyy-ui 组件自动导入 resolver
+ *
+ * 支持组件和样式的按需自动导入，适用于：
+ * - ✅ 外部项目使用（npm 包方式）
+ * - ✅ Monorepo 内部开发（源码方式）
+ *
+ * @example
+ * // 外部项目使用（默认配置）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ *
+ * Components({
+ *   resolvers: [SunyardSzyyUIResolver()]
+ * })
+ *
+ * @example
+ * // Monorepo 内部开发（推荐方式 - 简化配置）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ *
+ * Components({
+ *   resolvers: [
+ *     SunyardSzyyUIResolver({
+ *       devMode: true,
+ *       importMetaUrl: import.meta.url
+ *     })
+ *   ]
+ * })
+ *
+ * @example
+ * // Monorepo 内部开发（高级用法 - 自定义路径）
+ * import { SunyardSzyyUIResolver } from '@sunyard-szyy-ui/utils';
+ * import { fileURLToPath, URL } from 'node:url';
+ *
+ * Components({
+ *   resolvers: [
+ *     SunyardSzyyUIResolver({
+ *       dirResolver: (name) => ({
+ *         componentPath: fileURLToPath(
+ *           new URL(`./packages/components/src/${name}/index.ts`, import.meta.url)
+ *         ),
+ *         stylePath: fileURLToPath(
+ *           new URL(`./packages/components/src/${name}/style/css.ts`, import.meta.url)
+ *         )
+ *       })
+ *     })
+ *   ]
+ * })
+ */
+declare function SunyardSzyyUIResolver(options?: SunyardSzyyUIResolverOptions): ComponentResolver;
+
+type SFCWithInstall<T> = T & {
+    install(app: vue.App): void;
+};
+declare function withInstall<T>(component: T & {
+    name?: string;
+}): SFCWithInstall<T>;
+
+/**
+ * 防抖函数
+ * @param fn 要防抖的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 防抖后的函数
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ * @param fn 要节流的函数
+ * @param delay 延迟时间（毫秒）
+ * @returns 节流后的函数
+ */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+/**
+ * 格式化日期
+ * @param date 日期对象或时间戳
+ * @param format 格式化字符串，默认 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ */
+declare function formatDate(date: Date | number, format?: string): string;
+/**
+ * 深拷贝
+ * @param obj 要拷贝的对象
+ * @returns 拷贝后的对象
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { type ComponentResolveResult, type ComponentResolver, type SFCWithInstall, SunyardSzyyUIResolver, type SunyardSzyyUIResolverOptions, debounce, deepClone, formatDate, throttle, withInstall };

package/dist/index.js

@@ -0,0 +1,138 @@
+// src/resolver.ts
+function pascalToKebab(str, prefix = "Sy") {
+  return str.slice(prefix.length).replace(/([A-Z])/g, "-$1").toLowerCase().slice(1);
+}
+function SunyardSzyyUIResolver(options = {}) {
+  const {
+    prefix = "Sy",
+    importStyle = true,
+    libraryName = "sunyard-szyy-ui",
+    styleLibraryName = "@sunyard-szyy-ui/theme-chalk",
+    componentsLibraryName = "@sunyard-szyy-ui/components",
+    devMode = false,
+    importMetaUrl,
+    fileURLToPath,
+    dirResolver
+  } = options;
+  if (devMode && !dirResolver) {
+    if (!importMetaUrl || !fileURLToPath) {
+      throw new Error(
+        "[SunyardSzyyUIResolver] devMode \u542F\u7528\u65F6\u5FC5\u987B\u63D0\u4F9B importMetaUrl \u548C fileURLToPath \u53C2\u6570\n\u793A\u4F8B\uFF1A\nimport { fileURLToPath } from 'node:url';\nSunyardSzyyUIResolver({ devMode: true, importMetaUrl: import.meta.url, fileURLToPath })"
+      );
+    }
+  }
+  let actualDirResolver = dirResolver;
+  if (devMode && importMetaUrl && fileURLToPath && !dirResolver) {
+    actualDirResolver = (name) => {
+      const styleFile = importStyle === "scss" ? "index.ts" : "css.ts";
+      return {
+        componentPath: fileURLToPath(new URL(`../packages/components/src/${name}/index.ts`, importMetaUrl)),
+        stylePath: fileURLToPath(new URL(`../packages/components/src/${name}/style/${styleFile}`, importMetaUrl))
+      };
+    };
+  }
+  return {
+    type: "component",
+    resolve: (name) => {
+      if (name.startsWith(prefix)) {
+        const componentName = pascalToKebab(name, prefix);
+        if (actualDirResolver) {
+          const paths = actualDirResolver(componentName);
+          if (paths.componentPath) {
+            return {
+              name,
+              from: paths.componentPath,
+              sideEffects: importStyle && paths.stylePath ? paths.stylePath : void 0
+            };
+          }
+        }
+        const result = {
+          name,
+          from: libraryName
+        };
+        if (importStyle) {
+          if (importStyle === "css") {
+            result.sideEffects = `${styleLibraryName}/${componentName}.css`;
+          } else if (importStyle === "scss") {
+            result.sideEffects = `${styleLibraryName}/src/${componentName}.scss`;
+          } else if (importStyle === true) {
+            result.sideEffects = `${styleLibraryName}/${componentName}.css`;
+          }
+        }
+        return result;
+      }
+    }
+  };
+}
+
+// src/index.ts
+function withInstall(component) {
+  const c = component;
+  c.install = (app) => {
+    const name = component.name;
+    if (!name) return;
+    app.component(name, component);
+  };
+  return c;
+}
+function debounce(fn, delay = 300) {
+  let timer = null;
+  return function(...args) {
+    if (timer) {
+      clearTimeout(timer);
+    }
+    timer = setTimeout(() => {
+      fn.apply(this, args);
+      timer = null;
+    }, delay);
+  };
+}
+function throttle(fn, delay = 300) {
+  let lastTime = 0;
+  return function(...args) {
+    const now = Date.now();
+    if (now - lastTime >= delay) {
+      fn.apply(this, args);
+      lastTime = now;
+    }
+  };
+}
+function formatDate(date, format = "YYYY-MM-DD HH:mm:ss") {
+  const d = typeof date === "number" ? new Date(date) : date;
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  const hours = String(d.getHours()).padStart(2, "0");
+  const minutes = String(d.getMinutes()).padStart(2, "0");
+  const seconds = String(d.getSeconds()).padStart(2, "0");
+  return format.replace("YYYY", String(year)).replace("MM", month).replace("DD", day).replace("HH", hours).replace("mm", minutes).replace("ss", seconds);
+}
+function deepClone(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (obj instanceof Date) {
+    return new Date(obj.getTime());
+  }
+  if (obj instanceof Array) {
+    return obj.map((item) => deepClone(item));
+  }
+  if (typeof obj === "object") {
+    const clonedObj = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        clonedObj[key] = deepClone(obj[key]);
+      }
+    }
+    return clonedObj;
+  }
+  return obj;
+}
+export {
+  SunyardSzyyUIResolver,
+  debounce,
+  deepClone,
+  formatDate,
+  throttle,
+  withInstall
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@sunyard-szyy-ui/utils",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "unplugin-vue-components": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "unplugin-vue-components": "^31.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "pnpm clean && tsup src/index.ts --format esm,cjs --dts --out-dir dist --tsconfig tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}