@maiyunnet/kebab 9.18.2 → 9.19.0

package/doc/kebab-rag.md

@@ -1438,7 +1438,7 @@ index/variables/VER.md
 
 # Variable: VER
 
-> `const` **VER**: `"9.18.2"` = `'9.18.2'`
+> `const` **VER**: `"9.19.0"` = `'9.19.0'`
 
 Defined in: [index.ts:10](https://github.com/maiyunnet/kebab/blob/master/index.ts#L10)
 
@@ -132834,7 +132834,7 @@ Defined in: [sys/ctr.ts:258](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_checkInput**(`input`, `rule`, `rtn`): `boolean`
 
-Defined in: [sys/ctr.ts:799](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L799)
+Defined in: [sys/ctr.ts:721](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L721)
 
 检测提交的数据类型
 
@@ -132868,7 +132868,7 @@ Defined in: [sys/ctr.ts:799](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_checkXInput**(`input`, `rule`, `rtn`, `ignore?`): `boolean`
 
-Defined in: [sys/ctr.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L978)
+Defined in: [sys/ctr.ts:900](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L900)
 
 检测提交的数据类型（会检测 XSRF）
 
@@ -132908,7 +132908,7 @@ Defined in: [sys/ctr.ts:978](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_cross**(`opt?`): `boolean`
 
-Defined in: [sys/ctr.ts:1213](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1213)
+Defined in: [sys/ctr.ts:1135](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1135)
 
 开启跨域请求
 
@@ -132953,7 +132953,7 @@ Defined in: [sys/ctr.ts:1213](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_device**(): `"unknown"` \| `"android"` \| `"linux"` \| `"windows"` \| `"macintosh"` \| `"ipad"`
 
-Defined in: [sys/ctr.ts:1023](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1023)
+Defined in: [sys/ctr.ts:945](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L945)
 
 根据用户 ua 获取当前用户的设备类型
 
@@ -132967,7 +132967,7 @@ Defined in: [sys/ctr.ts:1023](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_enabledXsrf**(`opt?`): `void`
 
-Defined in: [sys/ctr.ts:992](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L992)
+Defined in: [sys/ctr.ts:914](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L914)
 
 当前页面开启 XSRF 支持（主要检测 cookie 是否存在）
 如果当前页面有 CDN，请不要使用
@@ -132990,7 +132990,7 @@ Defined in: [sys/ctr.ts:992](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_end**(`code?`, `reason?`): `void`
 
-Defined in: [sys/ctr.ts:1323](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1323)
+Defined in: [sys/ctr.ts:1245](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1245)
 
 主动关闭当前 socket 连接
 
@@ -133018,7 +133018,7 @@ WebSocket 关闭码
 
 > `protected` **\_getBasicAuth**(`user`, `pwd`): `string`
 
-Defined in: [sys/ctr.ts:1016](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1016)
+Defined in: [sys/ctr.ts:938](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L938)
 
 获取 Auth 字符串，用于客户端提交
 
@@ -133046,7 +133046,7 @@ Defined in: [sys/ctr.ts:1016](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_getLocale**(): `string`
 
-Defined in: [sys/ctr.ts:1204](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1204)
+Defined in: [sys/ctr.ts:1126](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1126)
 
 获取当前语言名
 
@@ -133060,7 +133060,7 @@ Defined in: [sys/ctr.ts:1204](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_getLocaleJsonString**(): `string`
 
-Defined in: [sys/ctr.ts:1192](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1192)
+Defined in: [sys/ctr.ts:1114](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1114)
 
 根据当前后台语言包设置情况获取 JSON 字符串传输到前台
 
@@ -133112,7 +133112,7 @@ Defined in: [sys/ctr.ts:400](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_handleFormData**(`events?`, `limits?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:1332](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1332)
+Defined in: [sys/ctr.ts:1254](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1254)
 
 获取 formdata 的信息
 
@@ -133190,7 +133190,7 @@ multipart 字段与文件总数量，默认 1000
 
 > **\_l**(`key`, `data?`): `string`
 
-Defined in: [sys/ctr.ts:1256](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1256)
+Defined in: [sys/ctr.ts:1178](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1178)
 
 获取语言包值
 
@@ -133216,7 +133216,7 @@ Defined in: [sys/ctr.ts:1256](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_loadData**\<`T`\>(`path`): `Promise`\<`false` \| `T` \| `null`\>
 
-Defined in: [sys/ctr.ts:1092](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1092)
+Defined in: [sys/ctr.ts:1014](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1014)
 
 获取 data JSON 数据
 
@@ -133244,7 +133244,7 @@ Defined in: [sys/ctr.ts:1092](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_loadLocale**(`loc`, `pkg?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:1143](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1143)
+Defined in: [sys/ctr.ts:1065](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1065)
 
 设定语言并加载语言包
 
@@ -133276,7 +133276,7 @@ Defined in: [sys/ctr.ts:444](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 加载 React 全页面进行 SSR 渲染，组件需渲染完整 HTML 文档（含 html/head/body），无需 EJS
 框架自动注入 props：_urlBase/_urlFull/_urlStc/_staticVer/_staticPath/_staticPathFull
-多语言：自动注入 _locale（当前语言名）和 _localeData（已载语言包的合并键值对）
+多语言：自动注入 _locale（当前语言名）和 _localeData（当前语种已载语言包的合并键值对）
 组件内创建：const l = (key: string, ...args: string[]): string => { let i = 0; return (_localeData[key] ?? key).replace(/\?/g, () => args[i++] ?? ''); };
 
 #### Parameters
@@ -133301,13 +133301,7 @@ Defined in: [sys/ctr.ts:444](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 `boolean`
 
-是否注入客户端水合脚本（import map + hydrateRoot），默认 true
-
-###### reactVer?
-
-`string`
-
-react/react-dom/react-router-dom 版本号，用于 esm.sh CDN，默认 19
+是否注入客户端水合 bundle，默认 true；设为 false 时仅输出服务端渲染的 HTML
 
 ###### router?
 
@@ -133365,7 +133359,7 @@ Defined in: [sys/ctr.ts:417](https://github.com/maiyunnet/kebab/blob/master/sys/
 
 > `protected` **\_location**(`location`): `false`
 
-Defined in: [sys/ctr.ts:1113](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1113)
+Defined in: [sys/ctr.ts:1035](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1035)
 
 跳转（302临时跳转），支持相对本项目根路径的路径或绝对路径
 
@@ -133387,7 +133381,7 @@ Defined in: [sys/ctr.ts:1113](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_ping**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:1306](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1306)
+Defined in: [sys/ctr.ts:1228](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1228)
 
 发送 socket ping
 
@@ -133409,7 +133403,7 @@ Defined in: [sys/ctr.ts:1306](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_pong**(`data?`): `boolean`
 
-Defined in: [sys/ctr.ts:1314](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1314)
+Defined in: [sys/ctr.ts:1236](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1236)
 
 发送 socket pong
 
@@ -133431,7 +133425,7 @@ Defined in: [sys/ctr.ts:1314](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_startSession**(`link`, `auth?`, `opt?`): `Promise`\<`boolean`\>
 
-Defined in: [sys/ctr.ts:1127](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1127)
+Defined in: [sys/ctr.ts:1049](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1049)
 
 开启 Session
 
@@ -133465,7 +133459,7 @@ Kv 或 Db 实例
 
 > `protected` **\_valibot**\<`TSchema`\>(`schema`, `input`, `options?`): [`TValibotResult`](../type-aliases/TValibotResult.md)\<`TSchema`\>
 
-Defined in: [sys/ctr.ts:718](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L718)
+Defined in: [sys/ctr.ts:640](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L640)
 
 使用 Valibot schema 校验并解析输入，成功后 output 会自动推导类型
 
@@ -133507,7 +133501,7 @@ Valibot 配置和自定义客户端返回值
 
 > `protected` **\_valibotx**\<`TSchema`\>(`schema`, `input`, `options?`): [`TValibotResult`](../type-aliases/TValibotResult.md)\<`TSchema`, [`IValibotXsrfIssue`](../interfaces/IValibotXsrfIssue.md) \| [`InferIssue`](../../../lib/core/namespaces/v/type-aliases/InferIssue.md)\<`TSchema`\>\>
 
-Defined in: [sys/ctr.ts:742](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L742)
+Defined in: [sys/ctr.ts:664](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L664)
 
 使用 Valibot schema 校验并解析输入，同时检测 XSRF
 
@@ -133549,7 +133543,7 @@ Valibot 配置、自定义客户端返回值和 XSRF 选项
 
 > `protected` **\_writeBinary**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1298](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1298)
+Defined in: [sys/ctr.ts:1220](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1220)
 
 发送 socket 二进制
 
@@ -133571,7 +133565,7 @@ Defined in: [sys/ctr.ts:1298](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_writeResult**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1290](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1290)
+Defined in: [sys/ctr.ts:1212](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1212)
 
 发送结果对象文本
 
@@ -133593,7 +133587,7 @@ Defined in: [sys/ctr.ts:1290](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > `protected` **\_writeText**(`data`): `boolean`
 
-Defined in: [sys/ctr.ts:1282](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1282)
+Defined in: [sys/ctr.ts:1204](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1204)
 
 发送 socket 文本
 
@@ -133615,7 +133609,7 @@ Defined in: [sys/ctr.ts:1282](https://github.com/maiyunnet/kebab/blob/master/sys
 
 > **getAuthorization**(): `false` \| \{ `pwd`: `string`; `type`: `"basic"`; `user`: `string`; \} \| \{ `token`: `string`; `type`: `"bearer"`; \}
 
-Defined in: [sys/ctr.ts:1044](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L1044)
+Defined in: [sys/ctr.ts:966](https://github.com/maiyunnet/kebab/blob/master/sys/ctr.ts#L966)
 
 通过 header 或 _auth 获取鉴权信息，支持 Basic Auth 和 Bearer Token
 

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.18.2";
+export declare const VER = "9.19.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.18.2';
+export const VER = '9.19.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "9.18.2",
+  "version": "9.19.0",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/ctr.d.ts

@@ -213,17 +213,15 @@ export declare class Ctr {
     /**
      * --- 加载 React 全页面进行 SSR 渲染，组件需渲染完整 HTML 文档（含 html/head/body），无需 EJS ---
      * --- 框架自动注入 props：_urlBase/_urlFull/_urlStc/_staticVer/_staticPath/_staticPathFull ---
-     * --- 多语言：自动注入 _locale（当前语言名）和 _localeData（已载语言包的合并键值对） ---
+     * --- 多语言：自动注入 _locale（当前语言名）和 _localeData（当前语种已载语言包的合并键值对） ---
      * --- 组件内创建：const l = (key: string, ...args: string[]): string => { let i = 0; return (_localeData[key] ?? key).replace(/\?/g, () => args[i++] ?? ''); }; ---
      * @param path 页面组件路径（相对于 stc/ 目录，不含扩展名，tsx 编译后的 .js）
      * @param props 传入组件的 props，框架常量自动合并，整体序列化为内联 JSON 供客户端水合复用
      * @param opt 可选配置
      */
     protected _loadReactPage(path: string, props?: Record<string, kebab.Json>, opt?: {
-        /** --- 是否注入客户端水合脚本（import map + hydrateRoot），默认 true --- */
+        /** --- 是否注入客户端水合 bundle，默认 true；设为 false 时仅输出服务端渲染的 HTML --- */
         'hydrate'?: boolean;
-        /** --- react/react-dom/react-router-dom 版本号，用于 esm.sh CDN，默认 19 --- */
-        'reactVer'?: string;
         /**
          * --- 路由模式，不传则不注入任何 Router，组件自行管理路由（如 MemoryRouter）或无路由 ---
          * --- 'browser'：服务端用 StaticRouter，客户端用 BrowserRouter，地址栏与路由联动 ---
@@ -241,14 +239,6 @@ export declare class Ctr {
          */
         'staticPath'?: string;
     }): Promise<string>;
-    /**
-     * --- 递归扫描 JS 文件中的 import 语句，收集第三方 bare specifier ---
-     * @param filePath 当前要扫描的文件绝对路径
-     * @param scannedFiles 已扫描文件集（去重用）
-     * @param extraImports 收集到的第三方包名集合
-     * @param builtinImports 内置 import map，已有条目不重复添加
-     */
-    private _scanImports;
     /**
      * --- 设置校验错误返回值 ---
      * @param rtn 返回值数组

package/sys/ctr.js

@@ -264,7 +264,7 @@ export class Ctr {
     /**
      * --- 加载 React 全页面进行 SSR 渲染，组件需渲染完整 HTML 文档（含 html/head/body），无需 EJS ---
      * --- 框架自动注入 props：_urlBase/_urlFull/_urlStc/_staticVer/_staticPath/_staticPathFull ---
-     * --- 多语言：自动注入 _locale（当前语言名）和 _localeData（已载语言包的合并键值对） ---
+     * --- 多语言：自动注入 _locale（当前语言名）和 _localeData（当前语种已载语言包的合并键值对） ---
      * --- 组件内创建：const l = (key: string, ...args: string[]): string => { let i = 0; return (_localeData[key] ?? key).replace(/\?/g, () => args[i++] ?? ''); }; ---
      * @param path 页面组件路径（相对于 stc/ 目录，不含扩展名，tsx 编译后的 .js）
      * @param props 传入组件的 props，框架常量自动合并，整体序列化为内联 JSON 供客户端水合复用
@@ -272,13 +272,23 @@ export class Ctr {
      */
     async _loadReactPage(path, props = {}, opt = {}) {
         // --- 约定：传入路径不含 .page 后缀，框架自动补全（对应 build 命令的 *.page.tsx 约定）---
-        // --- 组件 JS 从 stc 目录读取，浏览器同样通过 staticPath（支持 CDN）下载 ---
+        // --- 服务端读取 tsc 生成的组件 JS，浏览器读取 kebab build 生成的 bundle ---
         const componentPath = this._config.const.rootPath + 'stc/' + path + '.page.js';
         if (!await lFs.isFile(componentPath)) {
             lCore.debug(`[CTR][_loadReactPage] componentPath ${componentPath} is not a file`);
             lCore.log(this, `[CTR][_loadReactPage] componentPath ${componentPath} is not a file`, '-error');
             return '';
         }
+        const bundlePath = this._config.const.rootPath + 'stc/' + path + '.page.bundle.js';
+        if ((opt.hydrate !== false) && !await lFs.isFile(bundlePath)) {
+            /** --- 完整错误仅写入服务端日志，避免向客户端暴露文件系统路径 --- */
+            const message = `[CTR][_loadReactPage] bundlePath ${bundlePath} is not a file; ` +
+                `run "npx kebab build -d ${this._config.const.rootPath}stc"`;
+            lCore.debug(message);
+            lCore.log(this, message, '-error');
+            this._httpCode = 500;
+            return '<h1>500 Server Error</h1><hr>Kebab';
+        }
         try {
             const reactDomServer = await import('react-dom/server');
             const importPath = componentPath.startsWith('/')
@@ -287,11 +297,8 @@ export class Ctr {
             const mod = await import(importPath);
             const component = mod.default;
             const react = await import('react');
-            // --- 语言包数据：合并所有已加载包的键值，供组件使用 _localeData 实现多语言 ---
-            const localeData = {};
-            for (const pkg in this._localeData) {
-                Object.assign(localeData, this._localeData[pkg]);
-            }
+            // --- 语言包数据：当前语种的各命名包已由 _loadLocale 合并 ---
+            const localeData = { ...(this._localeData[this._locale] ?? {}) };
             // --- 把框架常量合并进 props，与 _loadView 行为一致 ---
             const staticPath = opt.staticPath ?? this._config.set.staticPath;
             const fullProps = {
@@ -305,67 +312,22 @@ export class Ctr {
                 '_locale': this._locale,
                 '_localeData': localeData,
             };
+            if (opt.router === 'browser') {
+                // --- BrowserRouter 的 basename 同时用于服务端 StaticRouter 和客户端水合 ---
+                const base = opt.routerBase ?? '';
+                const routerBase = this._config.const.urlBase + base.replace(/^\//, '');
+                fullProps['_routerBase'] = routerBase.replace(/\/$/, '');
+            }
             // --- 框架自动注入的 HTML 片段，用户组件无需手动渲染 ---
-            let headInject = '';
             let bodyInject = '';
             if (opt.hydrate !== false) {
-                const reactVer = opt.reactVer ?? '19';
-                const esm = 'https://esm.sh/';
-                // --- 检查是否有 npx kebab build 生成的自包含预构建包 ---
-                const bundlePath = this._config.const.rootPath + 'stc/' + path + '.page.bundle.js';
-                const hasBundle = await lFs.isFile(bundlePath);
-                if (opt.router === 'browser') {
-                    // --- BrowserRouter 模式：_routerBase 注入 props，供水合脚本读取 ---
-                    const base = opt.routerBase ?? '';
-                    const routerBase = this._config.const.urlBase + base.replace(/^\//, '');
-                    fullProps['_routerBase'] = routerBase.replace(/\/$/, '');
-                }
                 // --- propsJson 在渲染前序列化，框架直接注入 HTML，组件无需手动渲染 ---
                 const propsJson = lText.stringifyJson(fullProps).replace(/<\/script>/gi, '<\\/script>');
-                let hydrateScript;
-                if (hasBundle) {
-                    // --- bundle 模式：bundle 自包含 React + 水合逻辑，无需 import map ---
-                    const clientUrl = `${staticPath}${path}.page.bundle.js?v=${this._config.set.staticVer}`;
-                    hydrateScript = `import'${clientUrl}';`;
-                }
-                else {
-                    // --- 开发模式（tsc 编译 .js）：通过 esm.sh import map 解析 bare import ---
-                    const clientUrl = `${staticPath}${path}.page.js?v=${this._config.set.staticVer}`;
-                    // --- 内置 import map 条目（React 生态核心包）---
-                    const builtinImports = {
-                        'react': `${esm}react@${reactVer}`,
-                        'react-dom': `${esm}react-dom@${reactVer}`,
-                        'react-dom/client': `${esm}react-dom@${reactVer}/client`,
-                        'react/jsx-runtime': `${esm}react@${reactVer}/jsx-runtime`,
-                        'react-router-dom': `${esm}react-router-dom@7?external=react,react-dom`,
-                    };
-                    // --- 自动扫描入口 JS 及其相对引用，收集所有第三方 bare specifier ---
-                    const scannedFiles = new Set();
-                    const extraImports = new Set();
-                    await this._scanImports(componentPath, scannedFiles, extraImports, builtinImports);
-                    // --- 第三方包统一通过 esm.sh 解析，external react/react-dom 避免重复加载 ---
-                    for (const pkg of extraImports) {
-                        builtinImports[pkg] = `${esm}${pkg}?external=react,react-dom`;
-                    }
-                    // --- import map 注入到 </head> 前 ---
-                    headInject = `<script type="importmap">${lText.stringifyJson({ 'imports': builtinImports })}</script>`;
-                    // --- BrowserRouter 模式多一段 Router 导入与包裹层 ---
-                    const routerImport = opt.router === 'browser' ? `import{BrowserRouter}from'react-router-dom';` : '';
-                    const routerCreate = opt.router === 'browser'
-                        ? `createElement(BrowserRouter,{basename:p._routerBase},createElement(App,p))`
-                        : `createElement(App,p)`;
-                    hydrateScript =
-                        `import{hydrateRoot}from'react-dom/client';` +
-                            `import{createElement}from'react';` +
-                            routerImport +
-                            `import App from'${clientUrl}';` +
-                            `const p=JSON.parse(document.getElementById('__kebab_props__').textContent);` +
-                            `hydrateRoot(document,${routerCreate});`;
-                }
+                const clientUrl = `${staticPath}${path}.page.bundle.js?v=${this._config.set.staticVer}`;
                 // --- props JSON + 水合脚本注入到 </body> 前 ---
                 bodyInject =
                     `<script id="__kebab_props__" type="application/json">${propsJson}</script>` +
-                        `<script type="module">${hydrateScript}</script>`;
+                        `<script type="module">import'${clientUrl}';</script>`;
             }
             // --- BrowserRouter 模式：服务端用 StaticRouter 渲染，与客户端的 BrowserRouter 等价 ---
             // --- component 来自动态 import，TypeScript 无法精确推断，需要明确限定 element 类型 ---
@@ -379,10 +341,9 @@ export class Ctr {
                     'basename': fullProps['_routerBase'],
                 }, react.createElement(component, fullProps));
             }
-            // --- 框架将 import map 注入 </head> 前，props JSON + 水合脚本注入 </body> 前 ---
+            // --- 框架将 props JSON + 水合 bundle 注入到 </body> 前 ---
             let html = '<!DOCTYPE html>' + reactDomServer.renderToString(element);
             if (opt.hydrate !== false) {
-                html = html.replace('</head>', headInject + '</head>');
                 html = html.replace('</body>', bodyInject + '</body>');
             }
             return html;
@@ -393,38 +354,6 @@ export class Ctr {
             return '';
         }
     }
-    /**
-     * --- 递归扫描 JS 文件中的 import 语句，收集第三方 bare specifier ---
-     * @param filePath 当前要扫描的文件绝对路径
-     * @param scannedFiles 已扫描文件集（去重用）
-     * @param extraImports 收集到的第三方包名集合
-     * @param builtinImports 内置 import map，已有条目不重复添加
-     */
-    async _scanImports(filePath, scannedFiles, extraImports, builtinImports) {
-        if (scannedFiles.has(filePath)) {
-            return;
-        }
-        scannedFiles.add(filePath);
-        const src = await lFs.getContent(filePath, 'utf8');
-        if (!src) {
-            return;
-        }
-        const re = /\bfrom\s*['"]([^'"]+)['"]/g;
-        let m;
-        while ((m = re.exec(src)) !== null) {
-            const spec = m[1];
-            if (spec.startsWith('./') || spec.startsWith('../')) {
-                // --- 相对引用：解析为绝对路径后递归扫描 ---
-                const dir = filePath.substring(0, filePath.lastIndexOf('/') + 1);
-                const resolved = new URL(spec, 'file://' + dir).pathname;
-                await this._scanImports(resolved, scannedFiles, extraImports, builtinImports);
-            }
-            else if (!spec.startsWith('/') && !spec.startsWith('http') && !(spec in builtinImports)) {
-                // --- 第三方 bare specifier：加入 import map ---
-                extraImports.add(spec);
-            }
-        }
-    }
     /**
      * --- 设置校验错误返回值 ---
      * @param rtn 返回值数组

package/www/example/ctr/test.js

@@ -2021,8 +2021,8 @@ error: ${JSON.stringify(res.error)}
     }
     async undiciPost() {
         const echo = [];
-        const res = await lUndici.post(this._internalUrl + 'test/netPost1', { 'a': '1', 'b': '2', 'c': ['1', '2', '3'] });
-        echo.push(`<pre>lUndici.post('${this._internalUrl}test/netPost1', { 'a': '1', 'b': '2', 'c': ['1', '2', '3'] });</pre>
+        const res = await lUndici.post(this._internalUrl + 'test/undiciPost1', { 'a': '1', 'b': '2', 'c': ['1', '2', '3'] });
+        echo.push(`<pre>lUndici.post('${this._internalUrl}test/undiciPost1', { 'a': '1', 'b': '2', 'c': ['1', '2', '3'] });</pre>
 headers: <pre>${JSON.stringify(res.headers, null, 4)}</pre>
 content: <pre>${(await res.getContent())?.toString() ?? 'null'}</pre>
 error: ${JSON.stringify(res.error)}`);
@@ -2033,8 +2033,8 @@ error: ${JSON.stringify(res.error)}`);
     }
     async undiciPostString() {
         const echo = [];
-        const res = await lUndici.post(this._internalUrl + 'test/netPostString1', 'HeiHei');
-        echo.push(`<pre>lUndici.post('${this._internalUrl}test/netPostString1', 'HeiHei');</pre>
+        const res = await lUndici.post(this._internalUrl + 'test/undiciPostString1', 'HeiHei');
+        echo.push(`<pre>lUndici.post('${this._internalUrl}test/undiciPostString1', 'HeiHei');</pre>
 headers: <pre>${JSON.stringify(res.headers, null, 4)}</pre>
 content: <pre>${(await res.getContent())?.toString() ?? 'null'}</pre>
 error: ${JSON.stringify(res.error)}`);
@@ -2045,8 +2045,8 @@ error: ${JSON.stringify(res.error)}`);
     }
     async undiciOpen() {
         const echo = [];
-        const res = await lUndici.open(this._internalUrl + 'test/netPost1').post().data({ 'a': '2', 'b': '0', 'c': ['0', '1', '3'] }).request();
-        echo.push(`<pre>lUndici.open('${this._internalUrl}test/netPost1').post().data({ 'a': '2', 'b': '0', 'c': ['0', '1', '3'] }).request();</pre>
+        const res = await lUndici.open(this._internalUrl + 'test/undiciPost1').post().data({ 'a': '2', 'b': '0', 'c': ['0', '1', '3'] }).request();
+        echo.push(`<pre>lUndici.open('${this._internalUrl}test/undiciPost1').post().data({ 'a': '2', 'b': '0', 'c': ['0', '1', '3'] }).request();</pre>
 headers: <pre>${JSON.stringify(res.headers, null, 4)}</pre>
 content: <pre>${(await res.getContent())?.toString() ?? 'null'}</pre>
 error: ${JSON.stringify(res.error)}`);

package/www/example/stc/view/hello.page.d.ts

@@ -5,7 +5,8 @@
  * 1. 这个 .page.tsx 文件（组件 + IProps）
  * 2. 一个 <link> 标签引入 CSS（如果不需要样式可省略）
  * 3. 在 Ctr 方法里调用 _loadReactPage('view/hello', props)
- * 其他一切由框架自动处理：SSR 渲染、import map、props 注入、客户端水合。
+ * 4. 执行 node ./source/main build -d source/www/example/stc 生成客户端水合 bundle
+ * 其他一切由框架自动处理：SSR 渲染、props 注入、客户端水合。
  */
 import { type ReactElement } from 'react';
 interface IProps {

package/www/example/stc/view/hello.page.js

@@ -6,7 +6,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 1. 这个 .page.tsx 文件（组件 + IProps）
  * 2. 一个 <link> 标签引入 CSS（如果不需要样式可省略）
  * 3. 在 Ctr 方法里调用 _loadReactPage('view/hello', props)
- * 其他一切由框架自动处理：SSR 渲染、import map、props 注入、客户端水合。
+ * 4. 执行 node ./source/main build -d source/www/example/stc 生成客户端水合 bundle
+ * 其他一切由框架自动处理：SSR 渲染、props 注入、客户端水合。
  */
 import { useState } from 'react';
 export default function HelloPage({ _urlStc, _staticVer, greeting }) {

package/www/example/stc/view/hello.page.tsx

@@ -5,7 +5,8 @@
  * 1. 这个 .page.tsx 文件（组件 + IProps）
  * 2. 一个 <link> 标签引入 CSS（如果不需要样式可省略）
  * 3. 在 Ctr 方法里调用 _loadReactPage('view/hello', props)
- * 其他一切由框架自动处理：SSR 渲染、import map、props 注入、客户端水合。
+ * 4. 执行 node ./source/main build -d source/www/example/stc 生成客户端水合 bundle
+ * 其他一切由框架自动处理：SSR 渲染、props 注入、客户端水合。
  */
 import { useState, type ReactElement } from 'react';
 

package/www/example/stc/view/react-router.page.d.ts

@@ -15,13 +15,13 @@
  * 3. 嵌套路由通过 Outlet 渲染子路由内容
  *
  * 【编译方式】
- * tsc watch 会自动编译本文件为同路径的 .js，无需额外命令。
- * 如需打包为 .bundle.js，执行：node ./source/main build
+ * tsc watch 会自动编译本文件为同路径的 .js，供服务端 SSR 使用。
+ * 客户端水合必须执行：node ./source/main build -d source/www/example/stc
  *
  * 【Tailwind CSS 构建】
  * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
  * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
- * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
+ * props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 interface IUser {
     'id': string;

package/www/example/stc/view/react-router.page.js

@@ -16,13 +16,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * 3. 嵌套路由通过 Outlet 渲染子路由内容
  *
  * 【编译方式】
- * tsc watch 会自动编译本文件为同路径的 .js，无需额外命令。
- * 如需打包为 .bundle.js，执行：node ./source/main build
+ * tsc watch 会自动编译本文件为同路径的 .js，供服务端 SSR 使用。
+ * 客户端水合必须执行：node ./source/main build -d source/www/example/stc
  *
  * 【Tailwind CSS 构建】
  * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
  * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
- * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
+ * props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 import { useState, useEffect } from 'react';
 import { Routes, Route, Link, NavLink, useParams, useNavigate, useLocation, Outlet } from 'react-router-dom';

package/www/example/stc/view/react-router.page.tsx

@@ -15,13 +15,13 @@
  * 3. 嵌套路由通过 Outlet 渲染子路由内容
  *
  * 【编译方式】
- * tsc watch 会自动编译本文件为同路径的 .js，无需额外命令。
- * 如需打包为 .bundle.js，执行：node ./source/main build
+ * tsc watch 会自动编译本文件为同路径的 .js，供服务端 SSR 使用。
+ * 客户端水合必须执行：node ./source/main build -d source/www/example/stc
  *
  * 【Tailwind CSS 构建】
  * 需提前执行 node ./source/main build -d source/www/example/stc 生成 CSS 产物。
  * 框架通过 _staticPath 和 _staticVer 自动拼接带版本号 URL；
- * import map、props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
+ * props JSON、水合脚本均由框架自动注入 HTML，组件无需手动处理。
  */
 
 import { useState, useEffect } from 'react';
@@ -336,7 +336,6 @@ export default function ReactRouterPage({
                 <meta charSet="UTF-8" />
                 <meta name="viewport" content="width=device-width, initial-scale=1" />
                 <title suppressHydrationWarning>{title}</title>
-                {/* --- import map 由框架自动注入在此标签前，无需手动添加 --- */}
                 {/* --- dev: 需先执行 node ./source/main build -d source/www/example/stc 生成 CSS --- */}
                 <link rel="stylesheet" href={`${_urlStc}view/react-router.page.css?v=${_staticVer}`} />
             </head>

package/www/example/stc/view/react.page.d.ts

@@ -9,26 +9,22 @@
  *
  * 【使用方式】
  * 在 Ctr 方法中调用 _loadReactPage('view/react', { ...props })，
- * 框架自动将 import map、props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
+ * 框架自动将 props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
  *
  * 【多页面 / 共用组件】
  * 将公共 UI（如 Label/Input/Checkbox）放在 stc/lib/ui/ 目录，各页面 import 进来。
  * 这和 shadcn/ui 推荐的 components/ui/ 目录结构完全一致。
- * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，无需打包工具。
+ * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，供服务端 SSR 使用。
  *
  * 【编译方式】
  * 本文件 (.tsx) 已集成到 source/tsconfig.json 的 include 中，
- * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译，无需额外命令。
+ * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译服务端文件。
  * 编译输出：stc/view/react.page.js（由 tsc 覆盖写入，勿手动编辑 .js 文件）
+ * 客户端水合需执行：node ./source/main build -d source/www/example/stc
  *
  * 【运行时机】
  * - 服务端（Node.js）：_loadReactPage() 调用 renderToString()，产出完整 HTML 字符串。
- * - 客户端（浏览器）：import map 将 bare import 解析到 esm.sh，hydrateRoot 接管 document。
- * - 两端使用同一份 JS 文件：服务端从磁盘读，浏览器从静态 URL 下载。
- *
- * 【第三方包 import map 自动解析】
- * 开发模式下，框架会自动扫描入口 JS 及其相对引用中的所有 bare specifier，
- * 并通过 esm.sh CDN 自动生成 import map 条目，无需手动配置。
+ * - 客户端（浏览器）：加载 kebab build 生成的 bundle，由 hydrateRoot 接管 document。
  *
  * 【限制】
  * - 不能包含 Node.js 专属代码（fs/path/lDb 等），数据必须通过 props 传入。

package/www/example/stc/view/react.page.js

@@ -10,26 +10,22 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * 【使用方式】
  * 在 Ctr 方法中调用 _loadReactPage('view/react', { ...props })，
- * 框架自动将 import map、props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
+ * 框架自动将 props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
  *
  * 【多页面 / 共用组件】
  * 将公共 UI（如 Label/Input/Checkbox）放在 stc/lib/ui/ 目录，各页面 import 进来。
  * 这和 shadcn/ui 推荐的 components/ui/ 目录结构完全一致。
- * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，无需打包工具。
+ * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，供服务端 SSR 使用。
  *
  * 【编译方式】
  * 本文件 (.tsx) 已集成到 source/tsconfig.json 的 include 中，
- * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译，无需额外命令。
+ * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译服务端文件。
  * 编译输出：stc/view/react.page.js（由 tsc 覆盖写入，勿手动编辑 .js 文件）
+ * 客户端水合需执行：node ./source/main build -d source/www/example/stc
  *
  * 【运行时机】
  * - 服务端（Node.js）：_loadReactPage() 调用 renderToString()，产出完整 HTML 字符串。
- * - 客户端（浏览器）：import map 将 bare import 解析到 esm.sh，hydrateRoot 接管 document。
- * - 两端使用同一份 JS 文件：服务端从磁盘读，浏览器从静态 URL 下载。
- *
- * 【第三方包 import map 自动解析】
- * 开发模式下，框架会自动扫描入口 JS 及其相对引用中的所有 bare specifier，
- * 并通过 esm.sh CDN 自动生成 import map 条目，无需手动配置。
+ * - 客户端（浏览器）：加载 kebab build 生成的 bundle，由 hydrateRoot 接管 document。
  *
  * 【限制】
  * - 不能包含 Node.js 专属代码（fs/path/lDb 等），数据必须通过 props 传入。
@@ -102,7 +98,7 @@ function ShadcnDemo() {
         e.preventDefault();
         setSubmitted(true);
     }
-    return (_jsxs("div", { className: "space-y-4", children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "shadcn/ui Components" }), _jsxs("p", { className: "text-slate-500 text-xs leading-relaxed", children: ["All components below are imported from ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "stc/lib/ui/" }), ", following the same ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " structure recommended by shadcn/ui. Built on Radix UI primitives, styled with Tailwind CSS. In dev mode, the framework auto-scans all bare imports and generates the import map automatically."] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Label + Input" }), _jsxs("div", { className: "grid gap-4", children: [_jsxs("div", { className: "grid gap-1.5", children: [_jsx(Label, { htmlFor: nameId, children: "Username" }), _jsx(Input, { id: nameId, type: "text", placeholder: "Enter your username", value: name, onChange: e => { setName(e.target.value); } })] }), _jsxs("div", { className: "grid gap-1.5", children: [_jsx(Label, { htmlFor: emailId, children: "Email" }), _jsx(Input, { id: emailId, type: "email", placeholder: "you@example.com", value: email, onChange: e => { setEmail(e.target.value); } })] })] }), _jsx("p", { className: "text-xs text-slate-400 mt-3", children: "Click the Label text to focus the corresponding input (Radix UI a11y semantics)" })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Checkbox" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: agreeId, checked: agree, onCheckedChange: setAgree }), _jsx(Label, { htmlFor: agreeId, children: "I have read and agree to the Terms of Service" })] }), _jsxs("p", { className: "text-xs text-slate-400 mt-3", children: ["Value: ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: String(agree) }), "\u00A0(supports ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "true | false | 'indeterminate'" }), " tri-state)"] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Switch" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Switch, { id: newsletterId, checked: newsletter, onCheckedChange: setNewsletter }), _jsx(Label, { htmlFor: newsletterId, children: "Subscribe to product updates" })] }), _jsxs("p", { className: "text-xs text-slate-400 mt-3", children: ["Value: ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: newsletter ? 'true' : 'false' })] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Combined Form (Submit Demo)" }), submitted ? (_jsxs("div", { className: "space-y-2 text-sm", children: [_jsx("p", { className: "text-green-700 font-medium", children: "\u2713 Submitted! Received data:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-3 text-xs text-slate-700 overflow-auto", children: JSON.stringify({ name, email, agree: Boolean(agree), newsletter }, null, 2) }), _jsx("button", { onClick: () => { setSubmitted(false); }, className: "text-xs text-blue-500 hover:underline cursor-pointer", children: "Reset" })] })) : (_jsxs("form", { onSubmit: handleSubmit, className: "space-y-4", children: [_jsxs("div", { className: "grid gap-1.5", children: [_jsxs(Label, { htmlFor: `${nameId}-form`, children: ["Username ", _jsx("span", { className: "text-red-500", children: "*" })] }), _jsx(Input, { id: `${nameId}-form`, required: true, placeholder: "At least 2 characters", value: name, onChange: e => { setName(e.target.value); } })] }), _jsxs("div", { className: "grid gap-1.5", children: [_jsxs(Label, { htmlFor: `${emailId}-form`, children: ["Email ", _jsx("span", { className: "text-red-500", children: "*" })] }), _jsx(Input, { id: `${emailId}-form`, type: "email", required: true, placeholder: "you@example.com", value: email, onChange: e => { setEmail(e.target.value); } })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: `${agreeId}-form`, checked: agree, onCheckedChange: setAgree, required: true }), _jsx(Label, { htmlFor: `${agreeId}-form`, children: "Agree to terms" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Switch, { id: `${newsletterId}-form`, checked: newsletter, onCheckedChange: setNewsletter }), _jsx(Label, { htmlFor: `${newsletterId}-form`, children: "Subscribe" })] }), _jsx("button", { type: "submit", className: "inline-flex items-center px-4 py-2 rounded-lg bg-blue-500 hover:bg-blue-600 text-white text-sm font-medium cursor-pointer", children: "Submit" })] }))] })] }));
+    return (_jsxs("div", { className: "space-y-4", children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "shadcn/ui Components" }), _jsxs("p", { className: "text-slate-500 text-xs leading-relaxed", children: ["All components below are imported from ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "stc/lib/ui/" }), ", following the same ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " structure recommended by shadcn/ui. Built on Radix UI primitives, styled with Tailwind CSS. Client dependencies are bundled locally by the Kebab build command."] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Label + Input" }), _jsxs("div", { className: "grid gap-4", children: [_jsxs("div", { className: "grid gap-1.5", children: [_jsx(Label, { htmlFor: nameId, children: "Username" }), _jsx(Input, { id: nameId, type: "text", placeholder: "Enter your username", value: name, onChange: e => { setName(e.target.value); } })] }), _jsxs("div", { className: "grid gap-1.5", children: [_jsx(Label, { htmlFor: emailId, children: "Email" }), _jsx(Input, { id: emailId, type: "email", placeholder: "you@example.com", value: email, onChange: e => { setEmail(e.target.value); } })] })] }), _jsx("p", { className: "text-xs text-slate-400 mt-3", children: "Click the Label text to focus the corresponding input (Radix UI a11y semantics)" })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Checkbox" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: agreeId, checked: agree, onCheckedChange: setAgree }), _jsx(Label, { htmlFor: agreeId, children: "I have read and agree to the Terms of Service" })] }), _jsxs("p", { className: "text-xs text-slate-400 mt-3", children: ["Value: ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: String(agree) }), "\u00A0(supports ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "true | false | 'indeterminate'" }), " tri-state)"] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Switch" }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Switch, { id: newsletterId, checked: newsletter, onCheckedChange: setNewsletter }), _jsx(Label, { htmlFor: newsletterId, children: "Subscribe to product updates" })] }), _jsxs("p", { className: "text-xs text-slate-400 mt-3", children: ["Value: ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: newsletter ? 'true' : 'false' })] })] }), _jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-4", children: "Combined Form (Submit Demo)" }), submitted ? (_jsxs("div", { className: "space-y-2 text-sm", children: [_jsx("p", { className: "text-green-700 font-medium", children: "\u2713 Submitted! Received data:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-3 text-xs text-slate-700 overflow-auto", children: JSON.stringify({ name, email, agree: Boolean(agree), newsletter }, null, 2) }), _jsx("button", { onClick: () => { setSubmitted(false); }, className: "text-xs text-blue-500 hover:underline cursor-pointer", children: "Reset" })] })) : (_jsxs("form", { onSubmit: handleSubmit, className: "space-y-4", children: [_jsxs("div", { className: "grid gap-1.5", children: [_jsxs(Label, { htmlFor: `${nameId}-form`, children: ["Username ", _jsx("span", { className: "text-red-500", children: "*" })] }), _jsx(Input, { id: `${nameId}-form`, required: true, placeholder: "At least 2 characters", value: name, onChange: e => { setName(e.target.value); } })] }), _jsxs("div", { className: "grid gap-1.5", children: [_jsxs(Label, { htmlFor: `${emailId}-form`, children: ["Email ", _jsx("span", { className: "text-red-500", children: "*" })] }), _jsx(Input, { id: `${emailId}-form`, type: "email", required: true, placeholder: "you@example.com", value: email, onChange: e => { setEmail(e.target.value); } })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: `${agreeId}-form`, checked: agree, onCheckedChange: setAgree, required: true }), _jsx(Label, { htmlFor: `${agreeId}-form`, children: "Agree to terms" })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Switch, { id: `${newsletterId}-form`, checked: newsletter, onCheckedChange: setNewsletter }), _jsx(Label, { htmlFor: `${newsletterId}-form`, children: "Subscribe" })] }), _jsx("button", { type: "submit", className: "inline-flex items-center px-4 py-2 rounded-lg bg-blue-500 hover:bg-blue-600 text-white text-sm font-medium cursor-pointer", children: "Submit" })] }))] })] }));
 }
 // ─── 页面主组件 ────────────────────────────────────────────────────────────────
 /** --- Kebab React 全页面演示 --- */
@@ -153,7 +149,7 @@ export default function ReactPage({ title, serverTime, node, _urlBase, _urlStc,
       checkbox.tsx      # shadcn Checkbox
       switch.tsx        # shadcn Switch
   view/
-    react-page.tsx      # Page component (import + compose)` }), _jsxs("p", { className: "text-slate-500 text-xs mt-3", children: ["Mirrors the shadcn/ui", ' ', _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " convention. In dev mode, the framework auto-scans imports \u2014 no manual import map configuration needed."] })] })] })), tab === 'routing' && (_jsxs(MemoryRouter, { children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-1", children: "React Router Demo" }), _jsxs("p", { className: "text-slate-500 text-xs mb-4", children: ["Uses ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "MemoryRouter" }), ' ', "to demonstrate route navigation, dynamic params (useParams), and programmatic navigation (useNavigate). Works on both server SSR and client hydration with no extra server configuration."] }), _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(RouterHome, {}) }), _jsx(Route, { path: "/about", element: _jsx(RouterAbout, {}) }), _jsx(Route, { path: "/user/:id", element: _jsx(RouterUser, {}) })] })] }), _jsxs(Card, { className: "mt-4", children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "Full-Page BrowserRouter Setup" }), _jsx("p", { className: "text-slate-500 text-xs mb-3", children: "To let React Router manage the real URL (e.g. /app, /app/about), replace MemoryRouter with BrowserRouter and route all sub-paths to the same Ctr method on the server:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-4 text-xs overflow-auto leading-relaxed text-slate-700", children: `// 1. route.json: 将所有子路径路由到同一 Ctr 方法
+    react-page.tsx      # Page component (import + compose)` }), _jsxs("p", { className: "text-slate-500 text-xs mt-3", children: ["Mirrors the shadcn/ui", ' ', _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "components/ui/" }), " convention. Client dependencies are bundled locally by the Kebab build command."] })] })] })), tab === 'routing' && (_jsxs(MemoryRouter, { children: [_jsxs(Card, { children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-1", children: "React Router Demo" }), _jsxs("p", { className: "text-slate-500 text-xs mb-4", children: ["Uses ", _jsx("code", { className: "bg-slate-100 px-1 rounded", children: "MemoryRouter" }), ' ', "to demonstrate route navigation, dynamic params (useParams), and programmatic navigation (useNavigate). Works on both server SSR and client hydration with no extra server configuration."] }), _jsxs(Routes, { children: [_jsx(Route, { path: "/", element: _jsx(RouterHome, {}) }), _jsx(Route, { path: "/about", element: _jsx(RouterAbout, {}) }), _jsx(Route, { path: "/user/:id", element: _jsx(RouterUser, {}) })] })] }), _jsxs(Card, { className: "mt-4", children: [_jsx("h2", { className: "font-semibold text-slate-900 mb-2", children: "Full-Page BrowserRouter Setup" }), _jsx("p", { className: "text-slate-500 text-xs mb-3", children: "To let React Router manage the real URL (e.g. /app, /app/about), replace MemoryRouter with BrowserRouter and route all sub-paths to the same Ctr method on the server:" }), _jsx("pre", { className: "bg-slate-50 border border-slate-200 rounded-lg p-4 text-xs overflow-auto leading-relaxed text-slate-700", children: `// 1. route.json: 将所有子路径路由到同一 Ctr 方法
 {
   "app":   "ctr/app@reactPage",
   "app\\/.*": "ctr/app@reactPage"

package/www/example/stc/view/react.page.tsx

@@ -9,26 +9,22 @@
  *
  * 【使用方式】
  * 在 Ctr 方法中调用 _loadReactPage('view/react', { ...props })，
- * 框架自动将 import map、props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
+ * 框架自动将 props JSON、水合脚本注入 HTML，组件只写业务逻辑，无需任何框架样板代码。
  *
  * 【多页面 / 共用组件】
  * 将公共 UI（如 Label/Input/Checkbox）放在 stc/lib/ui/ 目录，各页面 import 进来。
  * 这和 shadcn/ui 推荐的 components/ui/ 目录结构完全一致。
- * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，无需打包工具。
+ * tsc watch 会自动将所有 .tsx 编译为同路径的 .js，供服务端 SSR 使用。
  *
  * 【编译方式】
  * 本文件 (.tsx) 已集成到 source/tsconfig.json 的 include 中，
- * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译，无需额外命令。
+ * 开启 `tsc: watch - source/tsconfig.json` 即可自动编译服务端文件。
  * 编译输出：stc/view/react.page.js（由 tsc 覆盖写入，勿手动编辑 .js 文件）
+ * 客户端水合需执行：node ./source/main build -d source/www/example/stc
  *
  * 【运行时机】
  * - 服务端（Node.js）：_loadReactPage() 调用 renderToString()，产出完整 HTML 字符串。
- * - 客户端（浏览器）：import map 将 bare import 解析到 esm.sh，hydrateRoot 接管 document。
- * - 两端使用同一份 JS 文件：服务端从磁盘读，浏览器从静态 URL 下载。
- *
- * 【第三方包 import map 自动解析】
- * 开发模式下，框架会自动扫描入口 JS 及其相对引用中的所有 bare specifier，
- * 并通过 esm.sh CDN 自动生成 import map 条目，无需手动配置。
+ * - 客户端（浏览器）：加载 kebab build 生成的 bundle，由 hydrateRoot 接管 document。
  *
  * 【限制】
  * - 不能包含 Node.js 专属代码（fs/path/lDb 等），数据必须通过 props 传入。
@@ -210,7 +206,7 @@ function ShadcnDemo() {
                     All components below are imported from <code className="bg-slate-100 px-1 rounded">stc/lib/ui/</code>,
                     following the same <code className="bg-slate-100 px-1 rounded">components/ui/</code> structure recommended by shadcn/ui.
                     Built on Radix UI primitives, styled with Tailwind CSS.
-                    In dev mode, the framework auto-scans all bare imports and generates the import map automatically.
+                    Client dependencies are bundled locally by the Kebab build command.
                 </p>
             </Card>
 
@@ -392,8 +388,7 @@ export default function ReactPage({ title, serverTime, node, _urlBase, _urlStc,
                 <meta charSet="UTF-8" />
                 <meta name="viewport" content="width=device-width, initial-scale=1.0" />
                 <title>{title}</title>
-                {/* import map 由框架自动注入在此标签前，无需手动添加 */}
-                {/* dev: Tailwind Play CDN；prod: 将此行替换为 kebab build 编译的 CSS 文件 */}
+                {/* CSS 和客户端水合 bundle 均由 kebab build 生成 */}
                 <link href={`${_urlStc}view/react.page.css?v=${_staticVer}`} rel="stylesheet" />
             </head>
             <body className="bg-slate-50 min-h-screen font-sans">
@@ -494,8 +489,7 @@ export default function ReactPage({ title, serverTime, node, _urlBase, _urlStc,
                                 <p className="text-slate-500 text-xs mt-3">
                                     Mirrors the shadcn/ui{' '}
                                     <code className="bg-slate-100 px-1 rounded">components/ui/</code> convention.
-                                    In dev mode, the framework auto-scans imports —
-                                    no manual import map configuration needed.
+                                    Client dependencies are bundled locally by the Kebab build command.
                                 </p>
                             </Card>