@amaster.ai/vite-plugins 1.1.0-beta.8 → 1.1.1

package/dist/index.d.ts

@@ -1,14 +1,9 @@
 import { Plugin } from 'vite';
 
-/**
- * Vite plugin: Add data-node-component-id to React components
- * Only enabled in development mode
- */
-declare function componentIdPlugin(): Plugin;
-
 /**
  * Vite plugin: Inject editor bridge script
- * Injects bridge.js in development mode by reading the built bridge script
+ * Injects minimal bridge that loads external script from platform
+ * Also provides virtual module for HMR and Tailwind config monitoring
  */
 declare function editorBridgePlugin(): Plugin;
 
@@ -20,30 +15,6 @@ declare function routesExposePlugin(options?: {
     routesFilePath?: string;
 }): Plugin;
 
-/**
- * Smart Reload 插件
- *
- * 在 Vite 服务器重启期间（如 PM2 重启 web-server），拦截浏览器端的刷新行为，
- * 让浏览器静默等待 WebSocket 重连，重连成功后不刷新页面（除非有实际的模块变更）。
- *
- * 场景说明：
- * - PM2 杀掉 Vite 进程 → WebSocket 断开 → PM2 重启 → 新 Vite 启动
- * - Vite 客户端检测到 WebSocket 断开后会通过 HTTP ping 轮询等待服务器恢复
- * - 服务器恢复后 Vite 客户端会调用 location.reload() 刷新页面
- * - 本插件拦截这个刷新行为，让页面保持当前状态
- *
- * 区分两种 full-reload 场景：
- * 1. 服务器重启 → full-reload 后 WebSocket 断开 → 静默等待重连，不刷新
- * 2. 模块变更需要 full-reload → WebSocket 保持连接 → 正常刷新
- *
- * 纯浏览器端方案，对用户完全无感：
- * - 不依赖服务端发送特殊消息
- * - WebSocket 断开 → 进入静默等待模式 → 抑制 location.reload
- * - Vite 客户端 HTTP ping 成功后调用 location.reload → 被拦截
- * - 拦截后延迟执行一次 soft-reload 恢复 HMR 连接
- */
-declare function smartReloadPlugin(): Plugin;
-
 interface TaroStyleAdapterOptions {
     /**
      * Design width for responsive scaling (default: 375)
@@ -208,32 +179,95 @@ interface PostCSSPlugin {
 }
 declare function rpx2pxPlugin(options?: Rpx2pxPluginOptions): PostCSSPlugin;
 
+interface JsxInlineStyleRpxOptions {
+    /**
+     * rpx 到 px 的转换比例（默认 2）
+     * 即 2rpx = 1px（基于 375 设计稿）
+     */
+    ratio?: number;
+}
+declare function transformJsxInlineStyleRpx(code: string, ratio?: number): {
+    changed: boolean;
+    code: string;
+};
+declare function jsxInlineStyleRpxPlugin(options?: JsxInlineStyleRpxOptions): Plugin;
+
+/**
+ * Vite plugin: JSX Source Tagger
+ * Intercepts react/jsx-dev-runtime to add source information to DOM elements
+ * Only enabled in development mode
+ */
+declare function jsxSourceTaggerPlugin(): Plugin;
+
+/**
+ * Vite plugin: Tailwind Config Sync
+ * Simplified version - just return raw config without resolveConfig
+ */
+declare function tailwindConfigSyncPlugin(options?: {
+    configPath?: string;
+}): Plugin;
+
 interface DevToolsOptions {
+    /**
+     * 是否为 Taro 项目
+     * - true: 启用 Taro 相关插件（taroStyleAdapterPlugin、rpx2pxPlugin）
+     * - false: 禁用 Taro 相关插件
+     * - undefined: 自动检测（通过 process.env.TARO_ENV 判断，默认为 false）
+     */
+    isTaro?: boolean;
     /**
      * Taro style adapter options
      * Controls H5 responsive scaling to match mini-program rpx behavior
+     * 仅在 isTaro 为 true 时生效
      */
     styleAdapter?: TaroStyleAdapterOptions;
+    /**
+     * 是否启用 JSX Source Tagger（通过 Symbol 标记元素源码位置）
+     * 默认：开发模式启用
+     */
+    jsxSourceTagger?: boolean;
+    /**
+     * 是否启用 Tailwind Config 同步（生成 JSON 文件）
+     * 默认：开发模式启用
+     */
+    tailwindConfigSync?: boolean;
+    /**
+     * Tailwind 配置文件路径
+     * 默认：./tailwind.config.ts
+     */
+    tailwindConfigPath?: string;
 }
 /**
  * 开发工具插件集合，简化调用，vite.config.ts 直接 devTools() 即可
+ *
  * @param options 配置项
+ * @param options.isTaro 是否为 Taro 项目（默认根据 TARO_ENV 自动判断）
  * @param options.styleAdapter Taro H5 样式适配配置，designWidth 应与 Taro config 一致
  * @returns Plugin[] Vite 插件数组
  *
  * @example
  * ```ts
- * // config/dev.ts
+ * // Taro 项目 - config/dev.ts
  * import devTools from "@amaster.ai/vite-plugins";
  *
  * export default {
  *   compiler: {
  *     type: 'vite',
- *     vitePlugins: [devTools()]
+ *     vitePlugins: [devTools({ isTaro: true })]
  *   }
  * }
  * ```
+ *
+ * @example
+ * ```ts
+ * // React 项目 - vite.config.ts
+ * import devTools from "@amaster.ai/vite-plugins";
+ *
+ * export default {
+ *   plugins: [devTools()]  // isTaro 默认为 false
+ * }
+ * ```
  */
 declare function devTools(options?: DevToolsOptions): Plugin[];
 
-export { type DevToolsOptions, type Rpx2pxPluginOptions, type TaroStyleAdapterOptions, componentIdPlugin, devTools as default, editorBridgePlugin, injectAmasterEnv, injectTaroEnv, routesExposePlugin, rpx2pxPlugin, smartReloadPlugin, taroStyleAdapterPlugin };
+export { type DevToolsOptions, type Rpx2pxPluginOptions, type TaroStyleAdapterOptions, devTools as default, editorBridgePlugin, injectAmasterEnv, injectTaroEnv, jsxInlineStyleRpxPlugin, jsxSourceTaggerPlugin, routesExposePlugin, rpx2pxPlugin, tailwindConfigSyncPlugin, taroStyleAdapterPlugin, transformJsxInlineStyleRpx };