@nasti-toolchain/nasti 2.4.4 → 2.5.0

package/dist/index.d.cts

@@ -49,6 +49,8 @@ interface NastiConfig {
     target?: 'web' | 'electron';
     /** 框架自动检测或手动指定 */
     framework?: 'react' | 'vue' | 'auto';
+    /** React JSX / Fast Refresh / Compiler 管线。仅在 framework 解析为 react 时生效。 */
+    react?: ReactOptions;
     /** 路径解析配置 */
     resolve?: ResolveConfig;
     /** 插件列表 */
@@ -78,6 +80,50 @@ interface NastiConfig {
     /** 实验特性（无稳定性保证，随时可能变更/移除） */
     experimental?: ExperimentalOptions;
 }
+type ReactFileFilter = string | RegExp | Array<string | RegExp>;
+/**
+ * 原生 React Compiler 的公共配置子集。其余实验字段会原样传给
+ * `oxc-transform-react`，无需让 Nasti 与编译器的快速迭代强耦合。
+ */
+interface ReactCompilerOptions {
+    compilationMode?: 'infer' | 'syntax' | 'annotation' | 'all';
+    panicThreshold?: 'none' | 'critical_errors' | 'all_errors';
+    target?: '17' | '18' | '19' | {
+        kind: 'donotuse_meta_internal';
+        runtimeModule?: string;
+    };
+    gating?: {
+        source: string;
+        importSpecifierName: string;
+    };
+    dynamicGating?: {
+        source: string;
+    };
+    noEmit?: boolean;
+    outputMode?: 'client' | 'ssr' | 'lint';
+    sources?: string[];
+    [option: string]: unknown;
+}
+/** React 管线选项；命名与 @vitejs/plugin-react 保持一致。 */
+interface ReactOptions {
+    /** @default /\.[tj]sx?$/ */
+    include?: ReactFileFilter;
+    /** @default /node_modules/ */
+    exclude?: ReactFileFilter;
+    /** @default 'react' */
+    jsxImportSource?: string;
+    /** @default 'automatic' */
+    jsxRuntime?: 'automatic' | 'classic';
+    /** 可选的原生 React Compiler；只编译 client consumer。 */
+    compiler?: boolean | ReactCompilerOptions;
+}
+interface ResolvedReactOptions {
+    include: ReactFileFilter;
+    exclude: ReactFileFilter;
+    jsxImportSource: string;
+    jsxRuntime: 'automatic' | 'classic';
+    compiler: false | ReactCompilerOptions;
+}
 interface ExperimentalOptions {
     /**
      * dev 用 Rolldown `dev()` 引擎整体打包 client 环境后从内存服务
@@ -607,6 +653,8 @@ interface ResolvedConfig {
     target: 'web' | 'electron';
     /** `auto` 在配置解析阶段已收敛为具体框架 */
     framework: 'react' | 'vue';
+    /** 解析后的 React 管线配置；Vue 项目仍保留该字段以简化插件读取。 */
+    react: ResolvedReactOptions;
     command: 'build' | 'serve';
     resolve: Required<ResolveConfig>;
     plugins: NastiPlugin[];
@@ -985,6 +1033,42 @@ interface MonacoEditorPluginOptions {
 }
 declare function monacoEditorPlugin(options?: MonacoEditorPluginOptions): NastiPlugin;
 
+interface RscPluginOptions {
+    /** Vite RSC 风格的三环境入口简写。 */
+    entries?: Partial<Record<'client' | 'ssr' | 'rsc', string | string[]>>;
+    /** 自定义环境名；默认 client / ssr / rsc。 */
+    environment?: Partial<Record<'client' | 'ssr' | 'rsc', string>>;
+    /** 扫描 client/server directive 的源码目录；默认扫描 app 与 src。 */
+    scanDirectories?: string[];
+    include?: ReactFileFilter;
+    exclude?: ReactFileFilter;
+    /** 可检查的引用清单；false 可关闭写出。 @default 'rsc-manifest.json' */
+    manifestFile?: string | false;
+}
+interface RscManifestReference {
+    id: string;
+    name: string;
+    chunks: string[];
+}
+interface RscManifest {
+    version: 1;
+    environments: {
+        client: string;
+        ssr: string;
+        rsc: string;
+    };
+    clientReferences: Record<string, RscManifestReference>;
+    serverReferences: Record<string, RscManifestReference>;
+}
+/**
+ * React Server Components 的低层生成器。
+ *
+ * 它只在显式安装时启用：RSC 环境中的 `"use client"` 模块会变成 client
+ * reference proxy，文件级 `"use server"` 导出会在 RSC 图注册、在 client/SSR
+ * 图生成 server reference proxy，并在 buildApp 收尾阶段写出稳定清单。
+ */
+declare function rsc(options?: RscPluginOptions): NastiPlugin;
+
 /** 非 client 环境的占位通道（SSR/edge 可由 runner/driver 接上真实 transport） */
 declare function createNoopHotChannel(): HotChannel;
 /**
@@ -1021,4 +1105,4 @@ declare function buildEnvDefine(env: EnvRecord, mode: string, overrides?: Record
 /** 按环境 consumer 派生 import.meta.env.SSR 的 define 覆盖 */
 declare function ssrDefineOverrides(consumer: 'client' | 'server'): Record<string, string>;
 
-export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, ssrDefineOverrides, startElectronDev };
+export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type ReactCompilerOptions, type ReactFileFilter, type ReactOptions, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type ResolvedReactOptions, type RscManifest, type RscManifestReference, type RscPluginOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, rsc, ssrDefineOverrides, startElectronDev };

package/dist/index.d.ts

@@ -49,6 +49,8 @@ interface NastiConfig {
     target?: 'web' | 'electron';
     /** 框架自动检测或手动指定 */
     framework?: 'react' | 'vue' | 'auto';
+    /** React JSX / Fast Refresh / Compiler 管线。仅在 framework 解析为 react 时生效。 */
+    react?: ReactOptions;
     /** 路径解析配置 */
     resolve?: ResolveConfig;
     /** 插件列表 */
@@ -78,6 +80,50 @@ interface NastiConfig {
     /** 实验特性（无稳定性保证，随时可能变更/移除） */
     experimental?: ExperimentalOptions;
 }
+type ReactFileFilter = string | RegExp | Array<string | RegExp>;
+/**
+ * 原生 React Compiler 的公共配置子集。其余实验字段会原样传给
+ * `oxc-transform-react`，无需让 Nasti 与编译器的快速迭代强耦合。
+ */
+interface ReactCompilerOptions {
+    compilationMode?: 'infer' | 'syntax' | 'annotation' | 'all';
+    panicThreshold?: 'none' | 'critical_errors' | 'all_errors';
+    target?: '17' | '18' | '19' | {
+        kind: 'donotuse_meta_internal';
+        runtimeModule?: string;
+    };
+    gating?: {
+        source: string;
+        importSpecifierName: string;
+    };
+    dynamicGating?: {
+        source: string;
+    };
+    noEmit?: boolean;
+    outputMode?: 'client' | 'ssr' | 'lint';
+    sources?: string[];
+    [option: string]: unknown;
+}
+/** React 管线选项；命名与 @vitejs/plugin-react 保持一致。 */
+interface ReactOptions {
+    /** @default /\.[tj]sx?$/ */
+    include?: ReactFileFilter;
+    /** @default /node_modules/ */
+    exclude?: ReactFileFilter;
+    /** @default 'react' */
+    jsxImportSource?: string;
+    /** @default 'automatic' */
+    jsxRuntime?: 'automatic' | 'classic';
+    /** 可选的原生 React Compiler；只编译 client consumer。 */
+    compiler?: boolean | ReactCompilerOptions;
+}
+interface ResolvedReactOptions {
+    include: ReactFileFilter;
+    exclude: ReactFileFilter;
+    jsxImportSource: string;
+    jsxRuntime: 'automatic' | 'classic';
+    compiler: false | ReactCompilerOptions;
+}
 interface ExperimentalOptions {
     /**
      * dev 用 Rolldown `dev()` 引擎整体打包 client 环境后从内存服务
@@ -607,6 +653,8 @@ interface ResolvedConfig {
     target: 'web' | 'electron';
     /** `auto` 在配置解析阶段已收敛为具体框架 */
     framework: 'react' | 'vue';
+    /** 解析后的 React 管线配置；Vue 项目仍保留该字段以简化插件读取。 */
+    react: ResolvedReactOptions;
     command: 'build' | 'serve';
     resolve: Required<ResolveConfig>;
     plugins: NastiPlugin[];
@@ -985,6 +1033,42 @@ interface MonacoEditorPluginOptions {
 }
 declare function monacoEditorPlugin(options?: MonacoEditorPluginOptions): NastiPlugin;
 
+interface RscPluginOptions {
+    /** Vite RSC 风格的三环境入口简写。 */
+    entries?: Partial<Record<'client' | 'ssr' | 'rsc', string | string[]>>;
+    /** 自定义环境名；默认 client / ssr / rsc。 */
+    environment?: Partial<Record<'client' | 'ssr' | 'rsc', string>>;
+    /** 扫描 client/server directive 的源码目录；默认扫描 app 与 src。 */
+    scanDirectories?: string[];
+    include?: ReactFileFilter;
+    exclude?: ReactFileFilter;
+    /** 可检查的引用清单；false 可关闭写出。 @default 'rsc-manifest.json' */
+    manifestFile?: string | false;
+}
+interface RscManifestReference {
+    id: string;
+    name: string;
+    chunks: string[];
+}
+interface RscManifest {
+    version: 1;
+    environments: {
+        client: string;
+        ssr: string;
+        rsc: string;
+    };
+    clientReferences: Record<string, RscManifestReference>;
+    serverReferences: Record<string, RscManifestReference>;
+}
+/**
+ * React Server Components 的低层生成器。
+ *
+ * 它只在显式安装时启用：RSC 环境中的 `"use client"` 模块会变成 client
+ * reference proxy，文件级 `"use server"` 导出会在 RSC 图注册、在 client/SSR
+ * 图生成 server reference proxy，并在 buildApp 收尾阶段写出稳定清单。
+ */
+declare function rsc(options?: RscPluginOptions): NastiPlugin;
+
 /** 非 client 环境的占位通道（SSR/edge 可由 runner/driver 接上真实 transport） */
 declare function createNoopHotChannel(): HotChannel;
 /**
@@ -1021,4 +1105,4 @@ declare function buildEnvDefine(env: EnvRecord, mode: string, overrides?: Record
 /** 按环境 consumer 派生 import.meta.env.SSR 的 define 覆盖 */
 declare function ssrDefineOverrides(consumer: 'client' | 'server'): Record<string, string>;
 
-export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, ssrDefineOverrides, startElectronDev };
+export { type AppBuildOutput, type AppHmrContext, type BuildAppContext, type BuildConfig, type BuildResult, type DevServer, type ElectronConfig, type EnvironmentAssetMetadata, type EnvironmentBuildMetadata, type EnvironmentBuildOutput, type EnvironmentBuildResult, type EnvironmentChunkMetadata, type EnvironmentCssChunk, type EnvironmentCssMetadata, type EnvironmentCssModule, type EnvironmentDriver, type EnvironmentDriverContext, type EnvironmentDriverServeContext, type EnvironmentHotUpdateResult, type EnvironmentInstance, type EnvironmentOptions, type EnvironmentServeResult, type EnvironmentTransformedModule, type HmrPayload, type HmrUpdate, type HotChannel, type HotChannelClient, type HotChannelInvokeHandlers, type LogLevel, LogLevels, type LogOptions, type Logger, type ModuleNode, type MonacoCustomWorker, type MonacoEditorLanguageWorker, type MonacoEditorPluginOptions, type NastiConfig, NastiEnvironment, type NastiPlugin, type NastiRolldownOptions, type PluginApi, type PluginApiKey, type PluginContext, type ReactCompilerOptions, type ReactFileFilter, type ReactOptions, type RenderChunkContext, type ResolvedConfig, type ResolvedEnvironmentOptions, type ResolvedReactOptions, type RscManifest, type RscManifestReference, type RscPluginOptions, type TransformResult, type VueEnvironmentOptions, type VueSfcSourceTransform, type VueSfcTransformContext, build, buildElectron, buildEnvDefine, createDebugger, createElectronRendererConfig, createLogger, createNoopHotChannel, createServer, createWsHotChannel, defineConfig, detectFramework, electronPlugin, electronRendererDevPath, loadEnv, monacoEditorPlugin, printServerUrls, resolveConfig, resolveEnvironmentPlugins, rsc, ssrDefineOverrides, startElectronDev };