@meng-xi/vite-plugin 0.0.8 → 0.0.9

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const format=require("./shared/vite-plugin.Ba9646wL.cjs"),validation=require("./shared/vite-plugin.IGZeStMa.cjs"),index=require("./shared/vite-plugin.CawoITTT.cjs"),logger_index=require("./logger/index.cjs"),index$1=require("./shared/vite-plugin.CIQOGuWb.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.fileExists=format.fileExists,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileContent=format.readFileContent,exports.readFileSync=format.readFileSync,exports.runWithConcurrency=format.runWithConcurrency,exports.shouldUpdateFile=format.shouldUpdateFile,exports.stripJsonComments=format.stripJsonComments,exports.toCamelCase=format.toCamelCase,exports.toPascalCase=format.toPascalCase,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory,exports.Logger=logger_index.Logger,exports.buildProgress=index$1.buildProgress,exports.copyFile=index$1.copyFile,exports.generateRouter=index$1.generateRouter,exports.generateVersion=index$1.generateVersion,exports.injectIco=index$1.injectIco,exports.injectLoading=index$1.injectLoading;
+"use strict";const format=require("./shared/vite-plugin.Ba9646wL.cjs"),validation=require("./shared/vite-plugin.IGZeStMa.cjs"),index=require("./shared/vite-plugin.CawoITTT.cjs"),logger_index=require("./logger/index.cjs"),index$1=require("./shared/vite-plugin.CsdNNQ-4.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.fileExists=format.fileExists,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileContent=format.readFileContent,exports.readFileSync=format.readFileSync,exports.runWithConcurrency=format.runWithConcurrency,exports.shouldUpdateFile=format.shouldUpdateFile,exports.stripJsonComments=format.stripJsonComments,exports.toCamelCase=format.toCamelCase,exports.toPascalCase=format.toPascalCase,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory,exports.Logger=logger_index.Logger,exports.buildProgress=index$1.buildProgress,exports.copyFile=index$1.copyFile,exports.generateRouter=index$1.generateRouter,exports.generateVersion=index$1.generateVersion,exports.injectIco=index$1.injectIco,exports.injectLoading=index$1.injectLoading;

package/dist/index.mjs

@@ -1 +1 @@
-export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,f as fileExists,b as formatDate,g as generateRandomHash,d as getDateFormatParams,p as padNumber,h as parseTemplate,r as readDirRecursive,i as readFileContent,j as readFileSync,k as runWithConcurrency,s as shouldUpdateFile,l as stripJsonComments,t as toCamelCase,m as toPascalCase,w as writeFileContent}from"./shared/vite-plugin.C3ejdBNf.mjs";export{V as Validator,d as deepMerge}from"./shared/vite-plugin.B88RyRN8.mjs";export{B as BasePlugin,c as createPluginFactory}from"./shared/vite-plugin.DSb6XzBn.mjs";export{Logger}from"./logger/index.mjs";export{b as buildProgress,c as copyFile,g as generateRouter,a as generateVersion,i as injectIco,d as injectLoading}from"./shared/vite-plugin.N63Ts2dO.mjs";import"fs";import"path";import"crypto";
+export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,f as fileExists,b as formatDate,g as generateRandomHash,d as getDateFormatParams,p as padNumber,h as parseTemplate,r as readDirRecursive,i as readFileContent,j as readFileSync,k as runWithConcurrency,s as shouldUpdateFile,l as stripJsonComments,t as toCamelCase,m as toPascalCase,w as writeFileContent}from"./shared/vite-plugin.C3ejdBNf.mjs";export{V as Validator,d as deepMerge}from"./shared/vite-plugin.B88RyRN8.mjs";export{B as BasePlugin,c as createPluginFactory}from"./shared/vite-plugin.DSb6XzBn.mjs";export{Logger}from"./logger/index.mjs";export{b as buildProgress,c as copyFile,g as generateRouter,a as generateVersion,i as injectIco,d as injectLoading}from"./shared/vite-plugin.BI4kA-bR.mjs";import"fs";import"path";import"crypto";

package/dist/plugins/index.cjs

@@ -1 +1 @@
-"use strict";const index=require("../shared/vite-plugin.CIQOGuWb.cjs");require("../shared/vite-plugin.CawoITTT.cjs"),require("../logger/index.cjs"),require("fs"),require("path"),require("crypto"),require("../shared/vite-plugin.IGZeStMa.cjs"),require("../shared/vite-plugin.Ba9646wL.cjs"),exports.buildProgress=index.buildProgress,exports.copyFile=index.copyFile,exports.generateRouter=index.generateRouter,exports.generateVersion=index.generateVersion,exports.injectIco=index.injectIco,exports.injectLoading=index.injectLoading;
+"use strict";const index=require("../shared/vite-plugin.CsdNNQ-4.cjs");require("../shared/vite-plugin.CawoITTT.cjs"),require("../logger/index.cjs"),require("fs"),require("path"),require("crypto"),require("../shared/vite-plugin.IGZeStMa.cjs"),require("../shared/vite-plugin.Ba9646wL.cjs"),exports.buildProgress=index.buildProgress,exports.copyFile=index.copyFile,exports.generateRouter=index.generateRouter,exports.generateVersion=index.generateVersion,exports.injectIco=index.injectIco,exports.injectLoading=index.injectLoading;

package/dist/plugins/index.d.cts

@@ -901,13 +901,23 @@ interface LoadingStyle {
      */
     zIndex?: number;
     /**
-     * 遮罩层是否允许点击穿透
+     * 是否启用遮罩层的指针事件
      *
      * @remarks
-     * - `false`（默认）：遮罩层拦截所有鼠标事件，防止用户在加载期间操作
-     * - `true`：遮罩层允许点击穿透，用户可在加载期间继续交互
+     * 对应 CSS `pointer-events` 属性，控制遮罩层是否拦截用户的点击、滚动等交互操作：
+     * - `true`（默认）：启用指针事件（`pointer-events: auto`），遮罩层阻止所有交互
+     * - `false`：禁用指针事件（`pointer-events: none`），遮罩层允许交互穿透
      *
-     * @defaultValue `false`
+     * @defaultValue `true`
+     *
+     * @example
+     * ```typescript
+     * // 阻止交互（默认行为）
+     * injectLoading({ style: { pointerEvents: true } })
+     *
+     * // 允许交互穿透（如仅展示加载状态，不阻止操作）
+     * injectLoading({ style: { pointerEvents: false } })
+     * ```
      */
     pointerEvents?: boolean;
     /**
@@ -1137,12 +1147,54 @@ interface LoadingManager {
      */
     forceHide(): void;
     /**
-     * 销毁 loading 实例
+     * 切换 loading 的显示/隐藏状态
      *
-     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
-     * 销毁后所有其他方法调用将被安全忽略
+     * @remarks 如果当前显示则调用 {@link hide}，如果当前隐藏则调用 {@link show}
+     *
+     * @param text - 可选，切换为显示时的文本内容；不传则保留默认文本
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.toggle()
+     * window.__LOADING_MANAGER__.toggle('正在加载...')
+     * ```
      */
-    destroy(): void;
+    toggle(text?: string): void;
+    /**
+     * 启用遮罩层的指针事件，拦截所有点击和滚动操作
+     *
+     * @remarks 设置遮罩层的 `pointer-events: auto`，恢复默认的交互拦截行为。
+     * 适用于运行时动态启用交互阻止，例如在特定操作期间临时锁定页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.enablePointerEvents()
+     * ```
+     */
+    enablePointerEvents(): void;
+    /**
+     * 禁用遮罩层的指针事件，允许交互穿透
+     *
+     * @remarks 设置遮罩层的 `pointer-events: none`，使鼠标事件穿透到下层元素。
+     * 适用于运行时动态禁用交互阻止，例如需要用户在 loading 期间仍能操作页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.disablePointerEvents()
+     * ```
+     */
+    disablePointerEvents(): void;
+    /**
+     * 切换遮罩层的指针事件状态
+     *
+     * @remarks 如果当前启用指针事件则调用 {@link disablePointerEvents}，如果当前禁用则调用 {@link enablePointerEvents}
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.togglePointerEvents()
+     * ```
+     */
+    togglePointerEvents(): void;
     /**
      * 更新 loading 文本内容
      *
@@ -1160,12 +1212,25 @@ interface LoadingManager {
      * @returns `true` 表示 loading 正在显示且未被销毁
      */
     isVisible(): boolean;
+    /**
+     * 获取当前遮罩层是否启用了指针事件
+     *
+     * @returns `true` 表示指针事件已启用（遮罩层拦截交互），`false` 表示已禁用（允许穿透）
+     */
+    isPointerEventsEnabled(): boolean;
     /**
      * 获取当前挂起的请求数量
      *
      * @returns 当前正在进行的、被拦截的请求数量
      */
     getPendingCount(): number;
+    /**
+     * 销毁 loading 实例
+     *
+     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
+     * 销毁后所有其他方法调用将被安全忽略
+     */
+    destroy(): void;
 }
 /**
  * injectLoading 插件的配置选项

package/dist/plugins/index.d.mts

@@ -901,13 +901,23 @@ interface LoadingStyle {
      */
     zIndex?: number;
     /**
-     * 遮罩层是否允许点击穿透
+     * 是否启用遮罩层的指针事件
      *
      * @remarks
-     * - `false`（默认）：遮罩层拦截所有鼠标事件，防止用户在加载期间操作
-     * - `true`：遮罩层允许点击穿透，用户可在加载期间继续交互
+     * 对应 CSS `pointer-events` 属性，控制遮罩层是否拦截用户的点击、滚动等交互操作：
+     * - `true`（默认）：启用指针事件（`pointer-events: auto`），遮罩层阻止所有交互
+     * - `false`：禁用指针事件（`pointer-events: none`），遮罩层允许交互穿透
      *
-     * @defaultValue `false`
+     * @defaultValue `true`
+     *
+     * @example
+     * ```typescript
+     * // 阻止交互（默认行为）
+     * injectLoading({ style: { pointerEvents: true } })
+     *
+     * // 允许交互穿透（如仅展示加载状态，不阻止操作）
+     * injectLoading({ style: { pointerEvents: false } })
+     * ```
      */
     pointerEvents?: boolean;
     /**
@@ -1137,12 +1147,54 @@ interface LoadingManager {
      */
     forceHide(): void;
     /**
-     * 销毁 loading 实例
+     * 切换 loading 的显示/隐藏状态
      *
-     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
-     * 销毁后所有其他方法调用将被安全忽略
+     * @remarks 如果当前显示则调用 {@link hide}，如果当前隐藏则调用 {@link show}
+     *
+     * @param text - 可选，切换为显示时的文本内容；不传则保留默认文本
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.toggle()
+     * window.__LOADING_MANAGER__.toggle('正在加载...')
+     * ```
      */
-    destroy(): void;
+    toggle(text?: string): void;
+    /**
+     * 启用遮罩层的指针事件，拦截所有点击和滚动操作
+     *
+     * @remarks 设置遮罩层的 `pointer-events: auto`，恢复默认的交互拦截行为。
+     * 适用于运行时动态启用交互阻止，例如在特定操作期间临时锁定页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.enablePointerEvents()
+     * ```
+     */
+    enablePointerEvents(): void;
+    /**
+     * 禁用遮罩层的指针事件，允许交互穿透
+     *
+     * @remarks 设置遮罩层的 `pointer-events: none`，使鼠标事件穿透到下层元素。
+     * 适用于运行时动态禁用交互阻止，例如需要用户在 loading 期间仍能操作页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.disablePointerEvents()
+     * ```
+     */
+    disablePointerEvents(): void;
+    /**
+     * 切换遮罩层的指针事件状态
+     *
+     * @remarks 如果当前启用指针事件则调用 {@link disablePointerEvents}，如果当前禁用则调用 {@link enablePointerEvents}
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.togglePointerEvents()
+     * ```
+     */
+    togglePointerEvents(): void;
     /**
      * 更新 loading 文本内容
      *
@@ -1160,12 +1212,25 @@ interface LoadingManager {
      * @returns `true` 表示 loading 正在显示且未被销毁
      */
     isVisible(): boolean;
+    /**
+     * 获取当前遮罩层是否启用了指针事件
+     *
+     * @returns `true` 表示指针事件已启用（遮罩层拦截交互），`false` 表示已禁用（允许穿透）
+     */
+    isPointerEventsEnabled(): boolean;
     /**
      * 获取当前挂起的请求数量
      *
      * @returns 当前正在进行的、被拦截的请求数量
      */
     getPendingCount(): number;
+    /**
+     * 销毁 loading 实例
+     *
+     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
+     * 销毁后所有其他方法调用将被安全忽略
+     */
+    destroy(): void;
 }
 /**
  * injectLoading 插件的配置选项

package/dist/plugins/index.d.ts

@@ -901,13 +901,23 @@ interface LoadingStyle {
      */
     zIndex?: number;
     /**
-     * 遮罩层是否允许点击穿透
+     * 是否启用遮罩层的指针事件
      *
      * @remarks
-     * - `false`（默认）：遮罩层拦截所有鼠标事件，防止用户在加载期间操作
-     * - `true`：遮罩层允许点击穿透，用户可在加载期间继续交互
+     * 对应 CSS `pointer-events` 属性，控制遮罩层是否拦截用户的点击、滚动等交互操作：
+     * - `true`（默认）：启用指针事件（`pointer-events: auto`），遮罩层阻止所有交互
+     * - `false`：禁用指针事件（`pointer-events: none`），遮罩层允许交互穿透
      *
-     * @defaultValue `false`
+     * @defaultValue `true`
+     *
+     * @example
+     * ```typescript
+     * // 阻止交互（默认行为）
+     * injectLoading({ style: { pointerEvents: true } })
+     *
+     * // 允许交互穿透（如仅展示加载状态，不阻止操作）
+     * injectLoading({ style: { pointerEvents: false } })
+     * ```
      */
     pointerEvents?: boolean;
     /**
@@ -1137,12 +1147,54 @@ interface LoadingManager {
      */
     forceHide(): void;
     /**
-     * 销毁 loading 实例
+     * 切换 loading 的显示/隐藏状态
      *
-     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
-     * 销毁后所有其他方法调用将被安全忽略
+     * @remarks 如果当前显示则调用 {@link hide}，如果当前隐藏则调用 {@link show}
+     *
+     * @param text - 可选，切换为显示时的文本内容；不传则保留默认文本
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.toggle()
+     * window.__LOADING_MANAGER__.toggle('正在加载...')
+     * ```
      */
-    destroy(): void;
+    toggle(text?: string): void;
+    /**
+     * 启用遮罩层的指针事件，拦截所有点击和滚动操作
+     *
+     * @remarks 设置遮罩层的 `pointer-events: auto`，恢复默认的交互拦截行为。
+     * 适用于运行时动态启用交互阻止，例如在特定操作期间临时锁定页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.enablePointerEvents()
+     * ```
+     */
+    enablePointerEvents(): void;
+    /**
+     * 禁用遮罩层的指针事件，允许交互穿透
+     *
+     * @remarks 设置遮罩层的 `pointer-events: none`，使鼠标事件穿透到下层元素。
+     * 适用于运行时动态禁用交互阻止，例如需要用户在 loading 期间仍能操作页面
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.disablePointerEvents()
+     * ```
+     */
+    disablePointerEvents(): void;
+    /**
+     * 切换遮罩层的指针事件状态
+     *
+     * @remarks 如果当前启用指针事件则调用 {@link disablePointerEvents}，如果当前禁用则调用 {@link enablePointerEvents}
+     *
+     * @example
+     * ```typescript
+     * window.__LOADING_MANAGER__.togglePointerEvents()
+     * ```
+     */
+    togglePointerEvents(): void;
     /**
      * 更新 loading 文本内容
      *
@@ -1160,12 +1212,25 @@ interface LoadingManager {
      * @returns `true` 表示 loading 正在显示且未被销毁
      */
     isVisible(): boolean;
+    /**
+     * 获取当前遮罩层是否启用了指针事件
+     *
+     * @returns `true` 表示指针事件已启用（遮罩层拦截交互），`false` 表示已禁用（允许穿透）
+     */
+    isPointerEventsEnabled(): boolean;
     /**
      * 获取当前挂起的请求数量
      *
      * @returns 当前正在进行的、被拦截的请求数量
      */
     getPendingCount(): number;
+    /**
+     * 销毁 loading 实例
+     *
+     * @remarks 清理 DOM 元素、事件监听器，并恢复原始的 fetch/XHR 拦截。
+     * 销毁后所有其他方法调用将被安全忽略
+     */
+    destroy(): void;
 }
 /**
  * injectLoading 插件的配置选项

package/dist/plugins/index.mjs

@@ -1 +1 @@
-export{b as buildProgress,c as copyFile,g as generateRouter,a as generateVersion,i as injectIco,d as injectLoading}from"../shared/vite-plugin.N63Ts2dO.mjs";import"../shared/vite-plugin.DSb6XzBn.mjs";import"../logger/index.mjs";import"fs";import"path";import"crypto";import"../shared/vite-plugin.B88RyRN8.mjs";import"../shared/vite-plugin.C3ejdBNf.mjs";
+export{b as buildProgress,c as copyFile,g as generateRouter,a as generateVersion,i as injectIco,d as injectLoading}from"../shared/vite-plugin.BI4kA-bR.mjs";import"../shared/vite-plugin.DSb6XzBn.mjs";import"../logger/index.mjs";import"fs";import"path";import"crypto";import"../shared/vite-plugin.B88RyRN8.mjs";import"../shared/vite-plugin.C3ejdBNf.mjs";