@meng-xi/vite-plugin 0.0.1 → 0.0.2

package/dist/plugins/copyFile/index.d.ts

@@ -1,44 +0,0 @@
-import { type Plugin } from 'vite';
-import type { CopyFileOptions } from './type';
-/**
- * 复制文件插件
- *
- * @param options - 配置参数
- * @returns 一个 Vite 插件实例
- *
- * @example
- * ```typescript
- * // 基本使用
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets'
- * })
- *
- * // 自定义配置
- * copyFile({
- *   sourceDir: 'src/static',
- *   targetDir: 'dist/static',
- *   overwrite: false,
- *   verbose: true,
- *   recursive: false
- * })
- *
- * // 根据环境启用
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: process.env.NODE_ENV === 'production'
- * })
- *
- * // 禁用复制功能
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: false
- * })
- * ```
- *
- * @remarks
- * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
- */
-export declare function copyFile(options: CopyFileOptions): Plugin;

package/dist/plugins/copyFile/index.mjs

@@ -1,43 +0,0 @@
-import { checkSourceExists, ensureTargetDir, copySourceToTarget } from "@/utils";
-export function copyFile(options) {
-  const { sourceDir, targetDir, overwrite = true, recursive = true, verbose = true, enabled = true } = options;
-  return {
-    // 插件名称
-    name: "copy-file",
-    // 插件在构建流程的最后阶段执行，确保其他构建任务完成后再进行文件复制
-    enforce: "post",
-    /**
-     * Vite 构建完成后触发的钩子函数，执行文件复制操作
-     *
-     * @remarks
-     * 该钩子在 Vite 构建流程的最后阶段执行，确保所有构建任务完成后再进行文件复制
-     *
-     * @throws 当源文件不存在、权限不足或复制过程中出现其他错误时抛出异常
-     */
-    async writeBundle() {
-      if (!enabled) {
-        if (verbose) {
-          console.log(`\u2139 \u590D\u5236\u6587\u4EF6\u529F\u80FD\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-        return;
-      }
-      try {
-        await checkSourceExists(sourceDir);
-        await ensureTargetDir(targetDir);
-        await copySourceToTarget(sourceDir, targetDir, { recursive, overwrite });
-        if (verbose) {
-          console.log(`\u2705 \u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-      } catch (err) {
-        if (verbose) {
-          if (err instanceof Error) {
-            console.error(err.message);
-          } else {
-            console.error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${sourceDir} -> ${targetDir}`, err);
-          }
-        }
-        throw err;
-      }
-    }
-  };
-}

package/dist/plugins/copyFile/type.d.ts

@@ -1,47 +0,0 @@
-/**
- * 复制文件插件的配置选项接口
- *
- * @interface CopyFileOptions
- */
-export interface CopyFileOptions {
-    /**
-     * 源文件目录的路径
-     *
-     * @example 'src/assets'
-     */
-    sourceDir: string;
-    /**
-     * 目标文件目录的路径
-     *
-     * @example 'dist/assets'
-     */
-    targetDir: string;
-    /**
-     * 是否覆盖同名文件
-     *
-     * @defaultValue true
-     * @example false
-     */
-    overwrite?: boolean;
-    /**
-     * 是否支持递归复制
-     *
-     * @defaultValue true
-     * @example false
-     */
-    recursive?: boolean;
-    /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用复制功能
-     *
-     * @defaultValue true
-     * @example false
-     */
-    enabled?: boolean;
-}

package/dist/plugins/injectIco/index.d.ts

@@ -1,74 +0,0 @@
-import { type Plugin } from 'vite';
-import type { InjectIcoOptions } from './type';
-/**
- * 注入网站图标链接到 HTML 文件的头部
- *
- * @param options - 配置选项（字符串时视为 base）
- * @returns 一个 Vite 插件实例，用于在构建过程中修改 HTML 文件
- *
- * @example
- * ```typescript
- * // 基本使用
- * injectIco({ base: '/assets' })
- *
- * // 自定义图标
- * injectIco({
- *   icons: [
- *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
- *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' },
- *     { rel: 'icon', href: '/favicon-16x16.png', sizes: '16x16', type: 'image/png' }
- *   ]
- * })
- *
- * // 带文件复制功能（适用于 uni-app 等框架）
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 带完整复制配置的使用
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons',
- *     overwrite: false,
- *     recursive: true
- *   }
- * })
- *
- * // 关闭日志输出
- * injectIco({
- *   base: '/assets',
- *   verbose: false,
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 根据环境启用
- * injectIco({
- *   base: '/assets',
- *   enabled: process.env.NODE_ENV === 'production',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 禁用插件
- * injectIco({
- *   base: '/assets',
- *   enabled: false,
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- * ```
- */
-export declare function injectIco(options?: InjectIcoOptions | string): Plugin;

package/dist/plugins/injectIco/index.mjs

@@ -1,82 +0,0 @@
-import { checkSourceExists, ensureTargetDir, copySourceToTarget, generateIconTags } from "@/utils";
-export function injectIco(options) {
-  const normalizedOptions = typeof options === "string" ? { base: options } : options || {};
-  const { verbose = true, enabled = true } = normalizedOptions;
-  return {
-    name: "inject-ico",
-    /**
-     * 转换 HTML 入口文件的钩子函数
-     *
-     * @param html - 原始的 HTML 内容
-     * @returns 经过修改后的 HTML 内容，在 `</head>` 标签前注入图标链接
-     */
-    transformIndexHtml(html) {
-      if (!enabled) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");
-        }
-        return html;
-      }
-      const iconTags = generateIconTags(normalizedOptions);
-      if (iconTags.length === 0) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u6CA1\u6709\u751F\u6210\u56FE\u6807\u6807\u7B7E\uFF0C\u8DF3\u8FC7\u6CE8\u5165");
-        }
-        return html;
-      }
-      let modifiedHtml = html;
-      const headCloseIndex = modifiedHtml.indexOf("</head>");
-      if (headCloseIndex !== -1) {
-        const tagsHtml = iconTags.join("\n") + "\n";
-        modifiedHtml = modifiedHtml.substring(0, headCloseIndex) + tagsHtml + modifiedHtml.substring(headCloseIndex);
-        if (verbose) {
-          console.log(`\u2705 inject-ico: \u6210\u529F\u6CE8\u5165 ${iconTags.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`);
-          iconTags.forEach((tag) => {
-            console.log(`  - ${tag}`);
-          });
-        }
-      } else {
-        if (verbose) {
-          console.warn("\u26A0 inject-ico: \u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");
-        }
-      }
-      return modifiedHtml;
-    },
-    /**
-     * 构建完成后执行的钩子函数，用于复制图标文件到打包目录
-     *
-     * @remarks
-     * 只有当配置了 copyOptions 对象且 enabled 为 true 时才会执行复制操作
-     *
-     * @throws 当源文件不存在、权限不足或复制过程中出现其他错误时抛出异常
-     */
-    async writeBundle() {
-      if (!enabled) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");
-        }
-        return;
-      }
-      const { copyOptions } = normalizedOptions;
-      if (!copyOptions) return;
-      const { sourceDir, targetDir, overwrite = true, recursive = true } = copyOptions;
-      try {
-        await checkSourceExists(sourceDir);
-        await ensureTargetDir(targetDir);
-        await copySourceToTarget(sourceDir, targetDir, { recursive, overwrite });
-        if (verbose) {
-          console.log(`\u2705 inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-      } catch (err) {
-        if (verbose) {
-          if (err instanceof Error) {
-            console.error(err.message);
-          } else {
-            console.error(`\u274C inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${sourceDir} -> ${targetDir}`, err);
-          }
-        }
-        throw err;
-      }
-    }
-  };
-}

package/dist/plugins/injectIco/type.d.ts

@@ -1,115 +0,0 @@
-/**
- * 图标配置项接口
- *
- * @interface Icon
- */
-interface Icon {
-    /**
-     * 图标关系类型
-     */
-    rel: string;
-    /**
-     * 图标 URL
-     */
-    href: string;
-    /**
-     * 图标尺寸
-     */
-    sizes?: string;
-    /**
-     * 图标 MIME 类型
-     */
-    type?: string;
-}
-/**
- * 图标文件复制配置选项接口
- *
- * @interface CopyOptions
- */
-interface CopyOptions {
-    /**
-     * 图标源文件目录，用于复制图标到打包目录
-     *
-     * @example 'src/assets/icons'
-     */
-    sourceDir: string;
-    /**
-     * 图标目标目录（打包目录），用于复制图标到打包目录
-     *
-     * @example 'dist/assets/icons'
-     */
-    targetDir: string;
-    /**
-     * 是否覆盖同名文件
-     *
-     * @defaultValue true
-     * @example false
-     */
-    overwrite?: boolean;
-    /**
-     * 是否支持递归复制
-     *
-     * @defaultValue true
-     * @example false
-     */
-    recursive?: boolean;
-}
-/**
- * 注入网站图标链接的配置选项接口
- *
- * @interface InjectIcoOptions
- */
-export interface InjectIcoOptions {
-    /**
-     * 图标文件的基础路径，默认为根路径 `/`
-     *
-     * @defaultValue `/`
-     * @example '/assets'
-     */
-    base?: string;
-    /**
-     * 图标的完整 URL，如果提供则优先使用（覆盖 base + favicon.ico）
-     *
-     * @example 'https://example.com/favicon.ico'
-     */
-    url?: string;
-    /**
-     * 自定义的完整 link 标签 HTML，如果提供则优先使用（覆盖 url 和 base）
-     *
-     * @example '<link rel="icon" href="/favicon.svg" type="image/svg+xml" />'
-     */
-    link?: string;
-    /**
-     * 自定义图标数组，支持多种图标格式和尺寸
-     *
-     * @example
-     * [
-     *   { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
-     *   { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' },
-     *   { rel: 'icon', href: '/favicon-16x16.png', sizes: '16x16', type: 'image/png' }
-     * ]
-     */
-    icons?: Icon[];
-    /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用图标注入和文件复制功能
-     *
-     * @defaultValue true
-     * @example false
-     */
-    enabled?: boolean;
-    /**
-     * 图标文件复制配置选项
-     *
-     * @remarks
-     * 当此对象存在时，才会开启图标文件复制功能
-     */
-    copyOptions?: CopyOptions;
-}
-export {};