@meng-xi/vite-plugin 0.1.0 → 0.1.1

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

@@ -0,0 +1,78 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+interface CopyFileOptions extends BasePluginOptions {
+    /**
+     * 源文件目录的路径
+     *
+     * @example 'src/assets'
+     */
+    sourceDir: string;
+    /**
+     * 目标文件目录的路径
+     *
+     * @example 'dist/assets'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * 是否启用增量复制
+     *
+     * @default true
+     */
+    incremental?: boolean;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * copyFile({
+ *   sourceDir: 'src/assets',
+ *   targetDir: 'dist/assets'
+ * })
+ *
+ * // 高级配置
+ * copyFile({
+ *   sourceDir: 'src/static',
+ *   targetDir: 'dist/static',
+ *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
+ *   verbose: true,
+ *   errorStrategy: 'throw'
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
+ */
+declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
+
+export { copyFile };
+export type { CopyFileOptions };

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

@@ -0,0 +1,78 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+interface CopyFileOptions extends BasePluginOptions {
+    /**
+     * 源文件目录的路径
+     *
+     * @example 'src/assets'
+     */
+    sourceDir: string;
+    /**
+     * 目标文件目录的路径
+     *
+     * @example 'dist/assets'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * 是否启用增量复制
+     *
+     * @default true
+     */
+    incremental?: boolean;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * copyFile({
+ *   sourceDir: 'src/assets',
+ *   targetDir: 'dist/assets'
+ * })
+ *
+ * // 高级配置
+ * copyFile({
+ *   sourceDir: 'src/static',
+ *   targetDir: 'dist/static',
+ *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
+ *   verbose: true,
+ *   errorStrategy: 'throw'
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
+ */
+declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
+
+export { copyFile };
+export type { CopyFileOptions };

package/dist/plugins/copyFile/index.mjs

@@ -0,0 +1 @@
+import{createPluginFactory as c,BasePlugin as n}from"../../factory/index.mjs";import{checkSourceExists as a,copySourceToTarget as l}from"../../common/fs/index.mjs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";import"fs";import"path";class F extends n{getDefaultOptions(){return{overwrite:!0,recursive:!0,incremental:!0}}validateOptions(){this.validator.field("sourceDir").required().string().custom(e=>e.trim()!=="","sourceDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("targetDir").required().string().custom(e=>e.trim()!=="","targetDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("overwrite").boolean().field("recursive").boolean().field("incremental").boolean().validate()}getPluginName(){return"copy-file"}getEnforce(){return"post"}async copyFiles(){const{sourceDir:e,targetDir:u,overwrite:t=!0,recursive:i=!0,incremental:o=!0,enabled:s=!0}=this.options;if(!s){this.logger.info(`\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${e} \u590D\u5236\u5230 ${u}`);return}await a(e);const r=await l(e,u,{recursive:i,overwrite:t,incremental:o});this.logger.success(`\u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${u}`,`\u590D\u5236\u4E86 ${r.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${r.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${r.executionTime}ms`)}addPluginHooks(e){e.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u590D\u5236\u6587\u4EF6")}}}const E=c(F);export{E as copyFile};

package/dist/plugins/faviconManager/index.cjs

@@ -0,0 +1 @@
+"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),validator=require("../../shared/vite-plugin.Bcg6RW2N.cjs"),common_html_index=require("../../common/html/index.cjs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("fs"),require("path");function generateIconTagDescriptors(u){const i=[];if(u.link)return[];if(u.icons&&u.icons.length>0)for(const e of u.icons){const t={rel:e.rel,href:e.href};e.sizes&&(t.sizes=e.sizes),e.type&&(t.type=e.type),i.push({tag:"link",attrs:t,injectTo:"head"})}else if(u.url)i.push({tag:"link",attrs:{rel:"icon",href:u.url},injectTo:"head"});else{const e=u.base||"/",t=e.endsWith("/")?`${e}favicon.ico`:`${e}/favicon.ico`;i.push({tag:"link",attrs:{rel:"icon",href:t},injectTo:"head"})}return i}class f extends factory_index.BasePlugin{getDefaultOptions(){return{base:"/"}}validateOptions(){this.validator.field("base").string().field("url").string().field("link").string().field("icons").array(),this.options?.copyOptions&&(this.validator.field("copyOptions").object(),new validator.Validator(this.options.copyOptions).field("sourceDir").required().string().field("targetDir").required().string().field("overwrite").boolean().field("recursive").boolean().validate()),this.validator.validate()}getPluginName(){return"favicon-manager"}getIconTagDescriptors(){if(!this.options.enabled)return this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),[];const i=generateIconTagDescriptors(this.options);return i.length>0&&this.logger.success(`\u6210\u529F\u6CE8\u5165 ${i.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),i}injectCustomLinkTag(i){if(!this.options.enabled||!this.options.link)return i;const e=this.options.link,t=common_html_index.injectBeforeTag(i,"</head>",e);return t.injected?(this.logger.success("\u6210\u529F\u6CE8\u5165\u81EA\u5B9A\u4E49\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6"),this.logger.info(`  - ${e}`),t.html):(this.logger.warn("\u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),i)}async copyFiles(){if(!this.options.enabled){this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");return}const{copyOptions:i}=this.options;if(!i)return;const{sourceDir:e,targetDir:t,overwrite:r=!0,recursive:n=!0}=i;await common_fs_index.checkSourceExists(e);const s=await common_fs_index.copySourceToTarget(e,t,{recursive:n,overwrite:r,incremental:!0});this.logger.success(`\u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${t}`,`\u590D\u5236\u4E86 ${s.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${s.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${s.executionTime}ms`)}addPluginHooks(i){i.transformIndexHtml={order:"pre",handler:e=>{if(this.options.link)return this.injectCustomLinkTag(e);const t=this.getIconTagDescriptors();return t.length>0?{html:e,tags:t}:e}},i.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u56FE\u6807\u6587\u4EF6\u590D\u5236")}}}const faviconManager=factory_index.createPluginFactory(f,u=>typeof u=="string"?{base:u}:u||{});exports.faviconManager=faviconManager;

package/dist/plugins/faviconManager/index.d.cts

@@ -0,0 +1,143 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.DRRlWY8P.cjs';
+
+/**
+ * 图标配置项接口
+ *
+ * @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;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+}
+/**
+ * 网站图标管理插件的配置选项接口
+ *
+ * @interface FaviconManagerOptions
+ */
+interface FaviconManagerOptions extends BasePluginOptions {
+    /**
+     * 图标文件的基础路径，默认为根路径 '/'
+     *
+     * @default '/'
+     * @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[];
+    /**
+     * 图标文件复制配置选项
+     *
+     * @remarks
+     * 当此对象存在时，才会开启图标文件复制功能
+     */
+    copyOptions?: CopyOptions;
+}
+
+/**
+ * 网站图标管理插件
+ *
+ * @param options - 插件配置选项，可以是字符串形式的 base 路径或完整的配置对象
+ * @returns Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * faviconManager() // 使用默认配置
+ *
+ * // 使用字符串配置 base 路径
+ * faviconManager('/assets')
+ *
+ * // 使用完整配置
+ * faviconManager({
+ *   base: '/assets',
+ *   icons: [
+ *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+ *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' }
+ *   ],
+ *   copyOptions: {
+ *     sourceDir: 'src/assets/icons',
+ *     targetDir: 'dist/assets/icons'
+ *   }
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在构建过程中：
+ * 1. 将网站图标（favicon）的 link 标签注入到 HTML 文件的 `<head>` 中
+ * 2. 如果配置了 copyOptions，将图标文件复制到目标目录
+ *
+ * 支持自定义图标链接、图标数组配置以及图标文件复制功能。
+ */
+declare const faviconManager: PluginFactory<FaviconManagerOptions, string | FaviconManagerOptions>;
+
+export { faviconManager };
+export type { FaviconManagerOptions, Icon };

package/dist/plugins/faviconManager/index.d.mts

@@ -0,0 +1,143 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 图标配置项接口
+ *
+ * @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;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+}
+/**
+ * 网站图标管理插件的配置选项接口
+ *
+ * @interface FaviconManagerOptions
+ */
+interface FaviconManagerOptions extends BasePluginOptions {
+    /**
+     * 图标文件的基础路径，默认为根路径 '/'
+     *
+     * @default '/'
+     * @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[];
+    /**
+     * 图标文件复制配置选项
+     *
+     * @remarks
+     * 当此对象存在时，才会开启图标文件复制功能
+     */
+    copyOptions?: CopyOptions;
+}
+
+/**
+ * 网站图标管理插件
+ *
+ * @param options - 插件配置选项，可以是字符串形式的 base 路径或完整的配置对象
+ * @returns Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * faviconManager() // 使用默认配置
+ *
+ * // 使用字符串配置 base 路径
+ * faviconManager('/assets')
+ *
+ * // 使用完整配置
+ * faviconManager({
+ *   base: '/assets',
+ *   icons: [
+ *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+ *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' }
+ *   ],
+ *   copyOptions: {
+ *     sourceDir: 'src/assets/icons',
+ *     targetDir: 'dist/assets/icons'
+ *   }
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在构建过程中：
+ * 1. 将网站图标（favicon）的 link 标签注入到 HTML 文件的 `<head>` 中
+ * 2. 如果配置了 copyOptions，将图标文件复制到目标目录
+ *
+ * 支持自定义图标链接、图标数组配置以及图标文件复制功能。
+ */
+declare const faviconManager: PluginFactory<FaviconManagerOptions, string | FaviconManagerOptions>;
+
+export { faviconManager };
+export type { FaviconManagerOptions, Icon };

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

@@ -0,0 +1,143 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 图标配置项接口
+ *
+ * @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;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+}
+/**
+ * 网站图标管理插件的配置选项接口
+ *
+ * @interface FaviconManagerOptions
+ */
+interface FaviconManagerOptions extends BasePluginOptions {
+    /**
+     * 图标文件的基础路径，默认为根路径 '/'
+     *
+     * @default '/'
+     * @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[];
+    /**
+     * 图标文件复制配置选项
+     *
+     * @remarks
+     * 当此对象存在时，才会开启图标文件复制功能
+     */
+    copyOptions?: CopyOptions;
+}
+
+/**
+ * 网站图标管理插件
+ *
+ * @param options - 插件配置选项，可以是字符串形式的 base 路径或完整的配置对象
+ * @returns Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * faviconManager() // 使用默认配置
+ *
+ * // 使用字符串配置 base 路径
+ * faviconManager('/assets')
+ *
+ * // 使用完整配置
+ * faviconManager({
+ *   base: '/assets',
+ *   icons: [
+ *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+ *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' }
+ *   ],
+ *   copyOptions: {
+ *     sourceDir: 'src/assets/icons',
+ *     targetDir: 'dist/assets/icons'
+ *   }
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在构建过程中：
+ * 1. 将网站图标（favicon）的 link 标签注入到 HTML 文件的 `<head>` 中
+ * 2. 如果配置了 copyOptions，将图标文件复制到目标目录
+ *
+ * 支持自定义图标链接、图标数组配置以及图标文件复制功能。
+ */
+declare const faviconManager: PluginFactory<FaviconManagerOptions, string | FaviconManagerOptions>;
+
+export { faviconManager };
+export type { FaviconManagerOptions, Icon };

package/dist/plugins/faviconManager/index.mjs

@@ -0,0 +1 @@
+import{createPluginFactory as n,BasePlugin as a}from"../../factory/index.mjs";import{checkSourceExists as c,copySourceToTarget as l}from"../../common/fs/index.mjs";import{V as g}from"../../shared/vite-plugin.DcExl6jd.mjs";import{injectBeforeTag as p}from"../../common/html/index.mjs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"fs";import"path";function F(u){const i=[];if(u.link)return[];if(u.icons&&u.icons.length>0)for(const e of u.icons){const t={rel:e.rel,href:e.href};e.sizes&&(t.sizes=e.sizes),e.type&&(t.type=e.type),i.push({tag:"link",attrs:t,injectTo:"head"})}else if(u.url)i.push({tag:"link",attrs:{rel:"icon",href:u.url},injectTo:"head"});else{const e=u.base||"/",t=e.endsWith("/")?`${e}favicon.ico`:`${e}/favicon.ico`;i.push({tag:"link",attrs:{rel:"icon",href:t},injectTo:"head"})}return i}class h extends a{getDefaultOptions(){return{base:"/"}}validateOptions(){this.validator.field("base").string().field("url").string().field("link").string().field("icons").array(),this.options?.copyOptions&&(this.validator.field("copyOptions").object(),new g(this.options.copyOptions).field("sourceDir").required().string().field("targetDir").required().string().field("overwrite").boolean().field("recursive").boolean().validate()),this.validator.validate()}getPluginName(){return"favicon-manager"}getIconTagDescriptors(){if(!this.options.enabled)return this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),[];const i=F(this.options);return i.length>0&&this.logger.success(`\u6210\u529F\u6CE8\u5165 ${i.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),i}injectCustomLinkTag(i){if(!this.options.enabled||!this.options.link)return i;const e=this.options.link,t=p(i,"</head>",e);return t.injected?(this.logger.success("\u6210\u529F\u6CE8\u5165\u81EA\u5B9A\u4E49\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6"),this.logger.info(`  - ${e}`),t.html):(this.logger.warn("\u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),i)}async copyFiles(){if(!this.options.enabled){this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");return}const{copyOptions:i}=this.options;if(!i)return;const{sourceDir:e,targetDir:t,overwrite:s=!0,recursive:o=!0}=i;await c(e);const r=await l(e,t,{recursive:o,overwrite:s,incremental:!0});this.logger.success(`\u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${t}`,`\u590D\u5236\u4E86 ${r.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${r.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${r.executionTime}ms`)}addPluginHooks(i){i.transformIndexHtml={order:"pre",handler:e=>{if(this.options.link)return this.injectCustomLinkTag(e);const t=this.getIconTagDescriptors();return t.length>0?{html:e,tags:t}:e}},i.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u56FE\u6807\u6587\u4EF6\u590D\u5236")}}}const f=n(h,u=>typeof u=="string"?{base:u}:u||{});export{f as faviconManager};

package/dist/plugins/generateRouter/index.cjs

@@ -0,0 +1,35 @@
+"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),common_format_index=require("../../common/format/index.cjs"),u=require("path"),s=require("fs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs"),require("crypto");class R extends factory_index.BasePlugin{projectRoot=process.cwd();tabBarPages=new Set;watcher=null;getDefaultOptions(){return{pagesJsonPath:"src/pages.json",outputPath:"src/router.config.ts",outputFormat:"ts",nameStrategy:"camelCase",includeSubPackages:!0,watch:!0,exportTypes:!0,preserveRouteChanges:!0,metaMapping:{navigationBarTitleText:"title",requireAuth:"requireAuth"}}}validateOptions(){if(this.validator.field("pagesJsonPath").string().field("outputPath").string().field("outputFormat").enum(["ts","js"]).field("nameStrategy").enum(["path","camelCase","pascalCase","custom"]).validate(),this.options.nameStrategy==="custom"&&!this.options.customNameGenerator)throw new Error("\u5F53 nameStrategy \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customNameGenerator")}getPluginName(){return"generate-router"}generateRouteName(e){switch(this.options.nameStrategy){case"path":return e.replace(/\//g,"_").replace(/^_/,"");case"camelCase":return common_format_index.toCamelCase(e);case"pascalCase":return common_format_index.toPascalCase(e);case"custom":return this.options.customNameGenerator(e);default:return common_format_index.toCamelCase(e)}}extractMeta(e,a){const t={},r=e.style||{},o=this.options.metaMapping||{};for(const[n,i]of Object.entries(o))r[n]!==void 0&&(t[i]=r[n]);return this.tabBarPages.has(a)&&(t.isTab=!0),t}parsePageToRoute(e,a=""){const t=a?`/${a}/${e.path}`:`/${e.path}`,r=this.generateRouteName(t),o=this.extractMeta(e,t.replace(/^\//,"")),n={path:t,name:r};return Object.keys(o).length>0&&(n.meta=o),n}parsePagesJson(e){const a=[];if(!e.pages||!Array.isArray(e.pages)||e.pages.length===0)return this.logger.warn("pages.json \u4E2D\u6CA1\u6709\u6709\u6548\u7684\u9875\u9762\u914D\u7F6E"),a;if(this.tabBarPages.clear(),e.tabBar?.list)for(const t of e.tabBar.list)this.tabBarPages.add(t.pagePath);for(const t of e.pages)a.push(this.parsePageToRoute(t));if(this.options.includeSubPackages&&e.subPackages){for(const t of e.subPackages)if(t.pages&&Array.isArray(t.pages))for(const r of t.pages)a.push(this.parsePageToRoute(r,t.root))}return a}generateTypeDefinitions(){return!this.options.exportTypes||this.options.outputFormat==="js"?"":`
+/**
+ * \u8DEF\u7531\u5143\u4FE1\u606F
+ */
+export interface RouteMeta {
+	/** \u9875\u9762\u6807\u9898 */
+	title?: string
+	/** \u662F\u5426\u4E3ATabBar\u9875\u9762 */
+	isTab?: boolean
+	/** \u662F\u5426\u9700\u8981\u767B\u5F55 */
+	requireAuth?: boolean
+	/** \u81EA\u5B9A\u4E49\u6269\u5C55\u5B57\u6BB5 */
+	[key: string]: unknown
+}
+
+/**
+ * \u8DEF\u7531\u914D\u7F6E\u9879
+ */
+export interface RouteConfig {
+	/** \u8DEF\u7531\u8DEF\u5F84 */
+	path: string
+	/** \u8DEF\u7531\u540D\u79F0\uFF08\u7528\u4E8E\u547D\u540D\u8DEF\u7531\u5BFC\u822A\uFF09 */
+	name?: string
+	/** \u8DEF\u7531\u5143\u4FE1\u606F */
+	meta?: RouteMeta
+}
+`}generateFileContent(e){const a=this.generateTypeDefinitions(),t=this.options.outputFormat==="ts",r=JSON.stringify(e,null,"	").replace(/"(\w+)":/g,"$1:").replace(/: "([^"]+)"/g,": '$1'");return`${a}
+/**
+ * \u8DEF\u7531\u914D\u7F6E\u5217\u8868
+ * @description \u7531 pages.json \u81EA\u52A8\u751F\u6210
+ */
+export const routes${t?": RouteConfig[]":""} = ${r}
+
+export default routes
+`}async readPagesJson(){const e=u.resolve(this.projectRoot,this.options.pagesJsonPath);if(!s.existsSync(e))return this.logger.warn(`pages.json \u6587\u4EF6\u4E0D\u5B58\u5728: ${e}`),null;try{const a=await common_fs_index.readFileContent(e),t=common_format_index.stripJsonComments(a);return JSON.parse(t)}catch(a){return this.logger.error(`\u89E3\u6790 pages.json \u5931\u8D25: ${a.message}`),null}}extractExistingRoutes(e){const a=new Map,t=e.match(/export const routes[^=]*=\s*(\[[\s\S]*?\](?=\s*\n|\s*$|\s*\/\/))/);if(!t)return a;try{let r=t[1].replace(/(\w+)(?=\s*:)/g,'"$1"').replace(/'([^']*)'/g,'"$1"').replace(/,\s*([\]\}])/g,"$1");const o=JSON.parse(r);for(const n of o)n.path&&a.set(n.path,n)}catch{this.logger.warn("\u89E3\u6790\u73B0\u6709 routes \u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5B8C\u5168\u91CD\u65B0\u751F\u6210")}return a}mergeRoutes(e,a){return e.map(t=>{const r=a.get(t.path);if(!r)return t;const o={};return t.meta&&Object.assign(o,t.meta),r.meta&&Object.assign(o,r.meta),{...r,path:t.path,meta:Object.keys(o).length>0?o:void 0}})}async generateRouterConfig(){const e=await this.readPagesJson();if(!e)return;let a=this.parsePagesJson(e);const t=u.resolve(this.projectRoot,this.options.outputPath);if(this.options.preserveRouteChanges&&s.existsSync(t))try{const o=await common_fs_index.readFileContent(t),n=this.extractExistingRoutes(o);n.size>0&&(a=this.mergeRoutes(a,n),this.logger.info("\u5DF2\u5408\u5E76\u7528\u6237\u5BF9\u8DEF\u7531\u914D\u7F6E\u7684\u4FEE\u6539"))}catch{}const r=this.generateFileContent(a);await common_fs_index.writeFileContent(t,r),this.logger.success(`\u8DEF\u7531\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210: ${t}`),this.logger.info(`\u5171\u751F\u6210 ${a.length} \u6761\u8DEF\u7531\u914D\u7F6E`)}startWatching(){if(!this.options.watch)return;const e=u.resolve(this.projectRoot,this.options.pagesJsonPath);s.existsSync(e)&&(this.watcher=s.watch(e,async a=>{a==="change"&&(this.logger.info("\u68C0\u6D4B\u5230 pages.json \u53D8\u5316\uFF0C\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E..."),await this.safeExecute(()=>this.generateRouterConfig(),"\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E"))}),this.logger.info(`\u6B63\u5728\u76D1\u542C pages.json \u53D8\u5316: ${e}`))}stopWatching(){this.watcher&&(this.watcher.close(),this.watcher=null)}addPluginHooks(e){e.configResolved=async a=>{this.projectRoot=a.root,await this.safeExecute(()=>this.generateRouterConfig(),"\u751F\u6210\u8DEF\u7531\u914D\u7F6E"),a.command==="serve"&&this.startWatching()}}destroy(){super.destroy(),this.stopWatching()}}const generateRouter=factory_index.createPluginFactory(R);exports.generateRouter=generateRouter;