@morlay/dsh-client-modules 0.2.11-alpha.2 → 0.2.11-alpha.3

package/dist/client.cjs

@@ -1461,24 +1461,24 @@ window.__ModuleLoader__.load({
 		}
 		var schema_form_module_css_default = {
 			"lineFold": "oZhWGq_lineFold",
-			"hoverActions": "oZhWGq_hoverActions",
-			"hint": "oZhWGq_hint",
+			"valueTrigger": "oZhWGq_valueTrigger",
+			"addWrap": "oZhWGq_addWrap",
 			"lineRow": "oZhWGq_lineRow",
 			"lineNumber": "oZhWGq_lineNumber",
-			"valueSlot": "oZhWGq_valueSlot",
-			"editorRoot": "oZhWGq_editorRoot",
-			"lineToken": "oZhWGq_lineToken",
-			"lineValue": "oZhWGq_lineValue",
-			"valueTrigger": "oZhWGq_valueTrigger",
 			"lineBody": "oZhWGq_lineBody",
-			"lineComment": "oZhWGq_lineComment",
 			"compactInput": "oZhWGq_compactInput",
-			"compactTextField": "oZhWGq_compactTextField",
-			"addWrap": "oZhWGq_addWrap",
-			"lineFoldSpacer": "oZhWGq_lineFoldSpacer",
+			"lineComment": "oZhWGq_lineComment",
 			"lineKey": "oZhWGq_lineKey",
 			"lineInvalid": "oZhWGq_lineInvalid",
-			"lineActions": "oZhWGq_lineActions"
+			"compactTextField": "oZhWGq_compactTextField",
+			"valueSlot": "oZhWGq_valueSlot",
+			"editorRoot": "oZhWGq_editorRoot",
+			"lineFoldSpacer": "oZhWGq_lineFoldSpacer",
+			"lineToken": "oZhWGq_lineToken",
+			"hoverActions": "oZhWGq_hoverActions",
+			"lineActions": "oZhWGq_lineActions",
+			"hint": "oZhWGq_hint",
+			"lineValue": "oZhWGq_lineValue"
 		};
 		// ../dsh-client-ui-primitives/src/client/schema-form/TruncatedTooltip.tsx
 		function TruncatedTooltip({ label, children }) {
@@ -2425,55 +2425,55 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var layout_module_css_default = {
-			"narrow": "uxI0LG_narrow",
-			"toneSecondary": "uxI0LG_toneSecondary",
-			"gap2": "uxI0LG_gap2",
-			"toneDanger": "uxI0LG_toneDanger",
-			"gap10": "uxI0LG_gap10",
+			"gap16": "uxI0LG_gap16",
+			"justifyBetween": "uxI0LG_justifyBetween",
+			"weightMedium": "uxI0LG_weightMedium",
+			"tabular": "uxI0LG_tabular",
+			"fixed": "uxI0LG_fixed",
+			"sizeBase": "uxI0LG_sizeBase",
+			"stack": "uxI0LG_stack",
+			"gap14": "uxI0LG_gap14",
 			"mono": "uxI0LG_mono",
+			"boxed": "uxI0LG_boxed",
+			"strong": "uxI0LG_strong",
+			"sizeMd": "uxI0LG_sizeMd",
+			"gap12": "uxI0LG_gap12",
+			"plain": "uxI0LG_plain",
+			"padBlocking": "uxI0LG_padBlocking",
 			"padBody": "uxI0LG_padBody",
-			"sizeBase": "uxI0LG_sizeBase",
-			"gap16": "uxI0LG_gap16",
+			"grow": "uxI0LG_grow",
+			"scroll": "uxI0LG_scroll",
+			"justifyCenter": "uxI0LG_justifyCenter",
+			"text": "uxI0LG_text",
+			"sizeSm": "uxI0LG_sizeSm",
+			"toneTertiary": "uxI0LG_toneTertiary",
+			"gapWide": "uxI0LG_gapWide",
+			"gap2": "uxI0LG_gap2",
+			"wSearch": "uxI0LG_wSearch",
+			"sizeLg": "uxI0LG_sizeLg",
+			"justifyEnd": "uxI0LG_justifyEnd",
+			"narrow": "uxI0LG_narrow",
+			"alignCenter": "uxI0LG_alignCenter",
 			"wrap": "uxI0LG_wrap",
-			"justifyBetween": "uxI0LG_justifyBetween",
-			"padNone": "uxI0LG_padNone",
+			"tonePrimary": "uxI0LG_tonePrimary",
+			"toneSecondary": "uxI0LG_toneSecondary",
+			"gap8": "uxI0LG_gap8",
+			"gap4": "uxI0LG_gap4",
+			"fill": "uxI0LG_fill",
+			"truncate": "uxI0LG_truncate",
+			"padPage": "uxI0LG_padPage",
+			"alignEnd": "uxI0LG_alignEnd",
 			"padRow": "uxI0LG_padRow",
-			"gap12": "uxI0LG_gap12",
 			"alignStart": "uxI0LG_alignStart",
 			"push": "uxI0LG_push",
-			"padPage": "uxI0LG_padPage",
-			"sizeLg": "uxI0LG_sizeLg",
-			"padCard": "uxI0LG_padCard",
-			"fill": "uxI0LG_fill",
-			"tonePrimary": "uxI0LG_tonePrimary",
-			"strong": "uxI0LG_strong",
-			"tabular": "uxI0LG_tabular",
-			"boxed": "uxI0LG_boxed",
+			"padNone": "uxI0LG_padNone",
 			"gap6": "uxI0LG_gap6",
+			"padCard": "uxI0LG_padCard",
 			"sizeXs": "uxI0LG_sizeXs",
-			"gapWide": "uxI0LG_gapWide",
-			"sizeSm": "uxI0LG_sizeSm",
+			"toneDanger": "uxI0LG_toneDanger",
 			"row": "uxI0LG_row",
-			"gap14": "uxI0LG_gap14",
-			"justifyEnd": "uxI0LG_justifyEnd",
-			"alignCenter": "uxI0LG_alignCenter",
 			"gap0": "uxI0LG_gap0",
-			"alignEnd": "uxI0LG_alignEnd",
-			"justifyCenter": "uxI0LG_justifyCenter",
-			"grow": "uxI0LG_grow",
-			"scroll": "uxI0LG_scroll",
-			"plain": "uxI0LG_plain",
-			"padBlocking": "uxI0LG_padBlocking",
-			"text": "uxI0LG_text",
-			"weightMedium": "uxI0LG_weightMedium",
-			"truncate": "uxI0LG_truncate",
-			"gap4": "uxI0LG_gap4",
-			"wSearch": "uxI0LG_wSearch",
-			"gap8": "uxI0LG_gap8",
-			"toneTertiary": "uxI0LG_toneTertiary",
-			"fixed": "uxI0LG_fixed",
-			"sizeMd": "uxI0LG_sizeMd",
-			"stack": "uxI0LG_stack"
+			"gap10": "uxI0LG_gap10"
 		};
 		// ../dsh-client-ui-primitives/src/client/layout/scales.ts
 		function gapClass(css, gap) {
@@ -2545,8 +2545,8 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var Button_module_css_default = {
-			"label": "SBA8ka_label",
-			"danger": "SBA8ka_danger"
+			"danger": "SBA8ka_danger",
+			"label": "SBA8ka_label"
 		};
 		(0, react.forwardRef)(function Button({ className, tone, ...rest }, ref) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {

package/dist/index.cjs

@@ -386,7 +386,7 @@ function clientModulesAlias(options) {
 * 实例）。内容变了**不换 URL**，靠 `cache-control: no-cache` + `ETag` 协商（vite dev 对它自己的模块
 * 也是这套）。
 */
-const BUNDLER_REV = (0, node_crypto.createHash)("sha1").update(`client-modules:rules:22`).digest("hex").slice(0, 8);
+const BUNDLER_REV = (0, node_crypto.createHash)("sha1").update(`client-modules:rules:28`).digest("hex").slice(0, 8);
 /** 包 → 它在浏览器里的地址（联邦式）。 */
 function depsUrlOf(specifier, version, file = "index.js") {
 	const name = packageNameOf(specifier) || specifier;
@@ -528,6 +528,28 @@ function browserProcessPlugin() {
 	};
 }
 /**
+* 入口是否按**它所属包的声明**是 CJS（Node 的 ESM 解析会做 `default = module.exports` 的那一侧）。
+*
+* 判据只看声明，不看源码内容：
+* - `type: "module"` 的包 → 恒为 ESM（`.mjs` 同理）；
+* - 否则是"老约定"：`module` 字段指向的那份视为 ESM（打包器约定，Node 不认），其余 `.js` 视为 CJS、
+*   `.cjs` 恒为 CJS；`.ts` 这类源码交给语法（rolldown 自己判）。
+*
+* 以前这里是"读源码找 `module.exports =`"，那是猜：`exports.` 出现在注释里就会误判，而 `type: module` 的
+* 包即使有 CJS 写法也不该被当 CJS。
+*/
+async function declaresCjs(entry) {
+	if (entry.endsWith(".mjs")) return false;
+	if (entry.endsWith(".cjs")) return true;
+	if (!entry.endsWith(".js")) return false;
+	const manifestPath = await packageJsonNear(entry);
+	const manifest = JSON.parse(await (0, node_fs_promises.readFile)(manifestPath, "utf8").catch(() => "{}"));
+	if (manifest.type === "module") return false;
+	const manifestModule = manifest.module;
+	if (manifestModule === void 0) return true;
+	return (0, node_path.resolve)((0, node_path.dirname)(manifestPath), manifestModule) !== (0, node_path.resolve)(entry);
+}
+/**
 * CJS 入口的**具名导出包装**（`react` 这类）。
 *
 * `react` 的入口是 `module.exports = require('./cjs/react.development.js')`，rolldown 静态分析不出具名
@@ -538,8 +560,7 @@ function browserProcessPlugin() {
 * @returns 包装文件路径；入口不是 CJS、或求值拿不到键时 undefined（保持原样）。
 */
 async function cjsShimOf(options) {
-	const source = await (0, node_fs_promises.readFile)(options.entry, "utf8").catch(() => "");
-	if (!(/\.(?:cjs|js)$/u.test(options.entry) && /(?:^|\n)\s*(?:module\.exports\s*=|exports\.[A-Za-z_$][A-Za-z0-9_$]*\s*=)/u.test(source))) return void 0;
+	if (!await declaresCjs(options.entry)) return void 0;
 	let keys;
 	try {
 		const loaded = (0, node_module.createRequire)(options.entry)(options.entry);
@@ -561,6 +582,51 @@ async function cjsShimOf(options) {
 	options.log?.(`[bundle-cjs] ${options.name}/${options.exportName}: 补 ${String(named.length)} 个具名导出\n`);
 	return file;
 }
+/** 根出口的产物名（`urlOf` 对非 client 行写的就是它）。 */
+const ROOT_EXPORT = "index";
+/** 具名导出的合法标识符：补 default 时按它挑键（非标识符的导出名用不了简写）。 */
+const EXPORT_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+/**
+* 这个入口是否需要「CJS 包的 ESM 便利入口」的 default 补偿。判据**只看 package.json 的声明**：
+*
+* - `type: "module"` 的包：Node 与我们都按 `exports`（或 `main` 本身就是 ESM）解析，两边一致，不补；
+* - 其余是 CJS 包：`module` 只是打包器约定（视为 ESM），`main` 才是 CJS。这条链选 `module`（更小、没有
+*   webpack 垫片），而 Node 的 `import pkg from 'pkg'` 落到 `main`、default 是它的 `module.exports`——
+*   所以浏览器侧得补一个 default，否则消费方那句 default import 直接报
+*   `does not provide an export named 'default'`（`rrule` 就是这一例）。
+* - 有 `exports` 的包两边都按条件解析，不涉及这条约定；入口不是 `module` 的（选了 `main`）由
+*   {@link cjsShimOf} 处理。`main`/`module` 只描述根出口，子路径不在此列。
+*/
+async function needsCjsInterop(entry, exportName) {
+	if (exportName !== ROOT_EXPORT) return false;
+	const manifestPath = await packageJsonNear(entry);
+	const manifest = JSON.parse(await (0, node_fs_promises.readFile)(manifestPath, "utf8").catch(() => "{}"));
+	if (manifest.type === "module" || manifest.exports !== void 0) return false;
+	const manifestModule = manifest.module;
+	if (manifestModule === void 0 || manifest.main === void 0) return false;
+	const modulePath = (0, node_path.resolve)((0, node_path.dirname)(manifestPath), manifestModule);
+	return await (0, node_fs_promises.realpath)(modulePath).catch(() => modulePath) === await (0, node_fs_promises.realpath)(entry).catch(() => (0, node_path.resolve)(entry)) || modulePath === (0, node_path.resolve)(entry);
+}
+/**
+* 给「CJS 包的 ESM 便利入口」补 default：**看产物的真实导出面**（`chunk.exports`），不猜源码。
+* 已经有 default 的（`jsbi` 的 `export default JSBI`）原样保留——补成对象会把它顶掉，
+* `@js-temporal/polyfill` 那句 `import e from "jsbi"` 于是拿到命名空间、运行期 `e.BigInt is not a function`；
+* 没有的补成 `{ 具名导出… }`，与 CJS 的 `module.exports` 同形（`rrule` 的 `ALL_WEEKDAYS` / `rrulestr` 那批）。
+*/
+function cjsInteropPlugin(exportName) {
+	return {
+		name: "dsh-cjs-interop",
+		generateBundle(_options, bundle) {
+			for (const chunk of Object.values(bundle)) {
+				if (chunk.type !== "chunk" || chunk.isEntry !== true || chunk.name !== exportName) continue;
+				if (chunk.exports.includes("default")) continue;
+				const named = chunk.exports.filter((name) => EXPORT_IDENTIFIER.test(name));
+				if (named.length === 0) continue;
+				chunk.code += `\nexport default { ${named.join(", ")} };\n`;
+			}
+		}
+	};
+}
 /**
 * CSS 入口的包装：**样式文件不能直接当入口**——vite 的库模式固定 `cssCodeSplit: false`，遇到
 * `rolldownOptions.input` 里有 `.css` 直接报错。包一层 side-effect import，让样式插件按它一贯的方式
@@ -687,20 +753,29 @@ async function bundlePackageOnce(options, key) {
 	const startedAt = Date.now();
 	options.log?.(`[bundle-build] ${options.name}: rolldown start\n`);
 	const input = {};
-	for (const [exportName, entry] of Object.entries(options.input)) input[exportName] = await cjsShimOf({
-		name: options.name,
-		exportName,
-		entry,
-		...options.log === void 0 ? {} : { log: options.log },
-		outDir
-	}) ?? await cssShimOf({
-		exportName,
-		entry,
-		outDir
-	}) ?? entry;
+	let interopExport;
+	for (const [exportName, entry] of Object.entries(options.input)) {
+		if (await needsCjsInterop(entry, exportName)) interopExport = exportName;
+		input[exportName] = await cjsShimOf({
+			name: options.name,
+			exportName,
+			entry,
+			...options.log === void 0 ? {} : { log: options.log },
+			outDir
+		}) ?? await cssShimOf({
+			exportName,
+			entry,
+			outDir
+		}) ?? entry;
+	}
+	if (interopExport !== void 0) plugins.push(cjsInteropPlugin(interopExport));
 	const bundle = await (0, rolldown.rolldown)({
 		input,
 		plugins,
+		onLog: (level, log, handler) => {
+			if (log.code === "CONFIGURATION_FIELD_CONFLICT" && log.message?.includes("experimentalDecorators") === true) return;
+			handler(level, log);
+		},
 		...options.tsconfig === void 0 ? {} : { resolve: { tsconfigFilename: options.tsconfig } },
 		transform: {
 			target: [
@@ -1036,7 +1111,6 @@ async function startViteDev(ctx, options) {
 			}
 		},
 		optimizeDeps: {
-			disabled: true,
 			noDiscovery: true,
 			include: []
 		},
@@ -1098,7 +1172,8 @@ const inject = ["loader", "webServer"];
 */
 async function clientRowsOf(loader) {
 	const found = /* @__PURE__ */ new Map();
-	for (const entry of loader.entries()) {
+	for (const raw of loader.entries()) {
+		const entry = raw;
 		if (entry.disabled === true || entry.fiber === void 0) continue;
 		const name = entry.options?.name;
 		if (typeof name !== "string" || name === "") continue;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { createRequire, findPackageJSON } from "node:module";
-import { appendFile, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { appendFile, mkdir, readFile, readdir, realpath, stat, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { ASSET_MIME, NODE_BUILTIN, clientAssetPlugin } from "@morlay/dsh-cordis-assets/assets";
@@ -385,7 +385,7 @@ function clientModulesAlias(options) {
 * 实例）。内容变了**不换 URL**，靠 `cache-control: no-cache` + `ETag` 协商（vite dev 对它自己的模块
 * 也是这套）。
 */
-const BUNDLER_REV = createHash("sha1").update(`client-modules:rules:22`).digest("hex").slice(0, 8);
+const BUNDLER_REV = createHash("sha1").update(`client-modules:rules:28`).digest("hex").slice(0, 8);
 /** 包 → 它在浏览器里的地址（联邦式）。 */
 function depsUrlOf(specifier, version, file = "index.js") {
 	const name = packageNameOf(specifier) || specifier;
@@ -527,6 +527,28 @@ function browserProcessPlugin() {
 	};
 }
 /**
+* 入口是否按**它所属包的声明**是 CJS（Node 的 ESM 解析会做 `default = module.exports` 的那一侧）。
+*
+* 判据只看声明，不看源码内容：
+* - `type: "module"` 的包 → 恒为 ESM（`.mjs` 同理）；
+* - 否则是"老约定"：`module` 字段指向的那份视为 ESM（打包器约定，Node 不认），其余 `.js` 视为 CJS、
+*   `.cjs` 恒为 CJS；`.ts` 这类源码交给语法（rolldown 自己判）。
+*
+* 以前这里是"读源码找 `module.exports =`"，那是猜：`exports.` 出现在注释里就会误判，而 `type: module` 的
+* 包即使有 CJS 写法也不该被当 CJS。
+*/
+async function declaresCjs(entry) {
+	if (entry.endsWith(".mjs")) return false;
+	if (entry.endsWith(".cjs")) return true;
+	if (!entry.endsWith(".js")) return false;
+	const manifestPath = await packageJsonNear(entry);
+	const manifest = JSON.parse(await readFile(manifestPath, "utf8").catch(() => "{}"));
+	if (manifest.type === "module") return false;
+	const manifestModule = manifest.module;
+	if (manifestModule === void 0) return true;
+	return resolve(dirname(manifestPath), manifestModule) !== resolve(entry);
+}
+/**
 * CJS 入口的**具名导出包装**（`react` 这类）。
 *
 * `react` 的入口是 `module.exports = require('./cjs/react.development.js')`，rolldown 静态分析不出具名
@@ -537,8 +559,7 @@ function browserProcessPlugin() {
 * @returns 包装文件路径；入口不是 CJS、或求值拿不到键时 undefined（保持原样）。
 */
 async function cjsShimOf(options) {
-	const source = await readFile(options.entry, "utf8").catch(() => "");
-	if (!(/\.(?:cjs|js)$/u.test(options.entry) && /(?:^|\n)\s*(?:module\.exports\s*=|exports\.[A-Za-z_$][A-Za-z0-9_$]*\s*=)/u.test(source))) return void 0;
+	if (!await declaresCjs(options.entry)) return void 0;
 	let keys;
 	try {
 		const loaded = createRequire(options.entry)(options.entry);
@@ -560,6 +581,51 @@ async function cjsShimOf(options) {
 	options.log?.(`[bundle-cjs] ${options.name}/${options.exportName}: 补 ${String(named.length)} 个具名导出\n`);
 	return file;
 }
+/** 根出口的产物名（`urlOf` 对非 client 行写的就是它）。 */
+const ROOT_EXPORT = "index";
+/** 具名导出的合法标识符：补 default 时按它挑键（非标识符的导出名用不了简写）。 */
+const EXPORT_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+/**
+* 这个入口是否需要「CJS 包的 ESM 便利入口」的 default 补偿。判据**只看 package.json 的声明**：
+*
+* - `type: "module"` 的包：Node 与我们都按 `exports`（或 `main` 本身就是 ESM）解析，两边一致，不补；
+* - 其余是 CJS 包：`module` 只是打包器约定（视为 ESM），`main` 才是 CJS。这条链选 `module`（更小、没有
+*   webpack 垫片），而 Node 的 `import pkg from 'pkg'` 落到 `main`、default 是它的 `module.exports`——
+*   所以浏览器侧得补一个 default，否则消费方那句 default import 直接报
+*   `does not provide an export named 'default'`（`rrule` 就是这一例）。
+* - 有 `exports` 的包两边都按条件解析，不涉及这条约定；入口不是 `module` 的（选了 `main`）由
+*   {@link cjsShimOf} 处理。`main`/`module` 只描述根出口，子路径不在此列。
+*/
+async function needsCjsInterop(entry, exportName) {
+	if (exportName !== ROOT_EXPORT) return false;
+	const manifestPath = await packageJsonNear(entry);
+	const manifest = JSON.parse(await readFile(manifestPath, "utf8").catch(() => "{}"));
+	if (manifest.type === "module" || manifest.exports !== void 0) return false;
+	const manifestModule = manifest.module;
+	if (manifestModule === void 0 || manifest.main === void 0) return false;
+	const modulePath = resolve(dirname(manifestPath), manifestModule);
+	return await realpath(modulePath).catch(() => modulePath) === await realpath(entry).catch(() => resolve(entry)) || modulePath === resolve(entry);
+}
+/**
+* 给「CJS 包的 ESM 便利入口」补 default：**看产物的真实导出面**（`chunk.exports`），不猜源码。
+* 已经有 default 的（`jsbi` 的 `export default JSBI`）原样保留——补成对象会把它顶掉，
+* `@js-temporal/polyfill` 那句 `import e from "jsbi"` 于是拿到命名空间、运行期 `e.BigInt is not a function`；
+* 没有的补成 `{ 具名导出… }`，与 CJS 的 `module.exports` 同形（`rrule` 的 `ALL_WEEKDAYS` / `rrulestr` 那批）。
+*/
+function cjsInteropPlugin(exportName) {
+	return {
+		name: "dsh-cjs-interop",
+		generateBundle(_options, bundle) {
+			for (const chunk of Object.values(bundle)) {
+				if (chunk.type !== "chunk" || chunk.isEntry !== true || chunk.name !== exportName) continue;
+				if (chunk.exports.includes("default")) continue;
+				const named = chunk.exports.filter((name) => EXPORT_IDENTIFIER.test(name));
+				if (named.length === 0) continue;
+				chunk.code += `\nexport default { ${named.join(", ")} };\n`;
+			}
+		}
+	};
+}
 /**
 * CSS 入口的包装：**样式文件不能直接当入口**——vite 的库模式固定 `cssCodeSplit: false`，遇到
 * `rolldownOptions.input` 里有 `.css` 直接报错。包一层 side-effect import，让样式插件按它一贯的方式
@@ -686,20 +752,29 @@ async function bundlePackageOnce(options, key) {
 	const startedAt = Date.now();
 	options.log?.(`[bundle-build] ${options.name}: rolldown start\n`);
 	const input = {};
-	for (const [exportName, entry] of Object.entries(options.input)) input[exportName] = await cjsShimOf({
-		name: options.name,
-		exportName,
-		entry,
-		...options.log === void 0 ? {} : { log: options.log },
-		outDir
-	}) ?? await cssShimOf({
-		exportName,
-		entry,
-		outDir
-	}) ?? entry;
+	let interopExport;
+	for (const [exportName, entry] of Object.entries(options.input)) {
+		if (await needsCjsInterop(entry, exportName)) interopExport = exportName;
+		input[exportName] = await cjsShimOf({
+			name: options.name,
+			exportName,
+			entry,
+			...options.log === void 0 ? {} : { log: options.log },
+			outDir
+		}) ?? await cssShimOf({
+			exportName,
+			entry,
+			outDir
+		}) ?? entry;
+	}
+	if (interopExport !== void 0) plugins.push(cjsInteropPlugin(interopExport));
 	const bundle = await rolldown({
 		input,
 		plugins,
+		onLog: (level, log, handler) => {
+			if (log.code === "CONFIGURATION_FIELD_CONFLICT" && log.message?.includes("experimentalDecorators") === true) return;
+			handler(level, log);
+		},
 		...options.tsconfig === void 0 ? {} : { resolve: { tsconfigFilename: options.tsconfig } },
 		transform: {
 			target: [
@@ -1035,7 +1110,6 @@ async function startViteDev(ctx, options) {
 			}
 		},
 		optimizeDeps: {
-			disabled: true,
 			noDiscovery: true,
 			include: []
 		},
@@ -1097,7 +1171,8 @@ const inject = ["loader", "webServer"];
 */
 async function clientRowsOf(loader) {
 	const found = /* @__PURE__ */ new Map();
-	for (const entry of loader.entries()) {
+	for (const raw of loader.entries()) {
+		const entry = raw;
 		if (entry.disabled === true || entry.fiber === void 0) continue;
 		const name = entry.options?.name;
 		if (typeof name !== "string" || name === "") continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-client-modules",
-  "version": "0.2.11-alpha.2",
+  "version": "0.2.11-alpha.3",
   "description": "Dev-form web layer for dsh: serves the page, the app entry and every client resource through an in-process vite dev server (middleware mode) — the node-side counterpart of upstream @deepseek-ai/dsh-client-modules, with the module table replaced by vite's resolver, dependency prebundling and HMR.",
   "keywords": [
     "client",
@@ -36,26 +36,26 @@
     "./locale/*.json": "./locale/*.json"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-client-ui-theme": "^0.2.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.2.2-alpha.2",
-    "@morlay/dsh-client-ui-primitives": "0.0.14-alpha.2",
-    "@morlay/dsh-cordis-assets": "0.2.10-alpha.2",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.2.2-alpha.3",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.2-alpha.3",
+    "@morlay/dsh-client-ui-primitives": "0.0.14-alpha.3",
+    "@morlay/dsh-cordis-assets": "0.2.10-alpha.3",
     "@oxc-project/runtime": "^0.153.0",
     "lightningcss": "^1.30.0",
     "vite": "^8.3.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.6-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.6-alpha.2",
     "@local/devkit": "0.1.0",
     "@types/node": "^26.5.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.6-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.6-alpha.2",
     "react": "^18.3.1",
     "rolldown": "^1.2.14"
   },
   "engines": {
-    "dsh": ">= 0.2.2-alpha.2 < 0.2.3",
+    "dsh": ">= 0.2.2-alpha.3 < 0.2.3",
     "node": ">=24.11.0"
   },
   "dsh": {

package/src/__tests__/bundle.spec.ts

@@ -7,6 +7,7 @@
 import { appendFile, mkdir, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { pathToFileURL } from "node:url";
 import { afterAll, beforeAll, expect, test } from "vitest";
 import { BUNDLER_REV, bundlePackage, clientModulesAlias, urlOf } from "../bundle.ts";
 
@@ -82,6 +83,7 @@ beforeAll(async () => {
     "utf8",
   );
   await writeFile(join(packageRoot, "src", "b.ts"), "export const b = 2;\n", "utf8");
+  await writeFile(join(packageRoot, "src", "c.ts"), "export const c = 3;\n", "utf8");
 });
 
 afterAll(async () => {
@@ -154,6 +156,23 @@ test("装饰器在产物里必须已被转译，且**不依赖进程 cwd**", asy
   }
 });
 
+test("tsconfig 与 `transform.decorator` 都声明装饰器时不再提示冲突（语义相同，口径取 transform 那侧）", async () => {
+  // 两处声明是必须的：tsconfig 那项管不到 `node_modules` 里的包（include 面默认排除它），transform 那侧才是
+  // 保底。rolldown 的 `CONFIGURATION_FIELD_CONFLICT` 只是"重复声明"级提示，本链在 `onLog` 里过滤掉——
+  // 这条用例钉住"过滤生效"，别让它哪天又冒出来。
+  const warned: string[] = [];
+  const original = console.warn;
+  console.warn = (...args: unknown[]) => {
+    warned.push(args.map(String).join(" "));
+  };
+  try {
+    await bundlePackage({ ...options("c"), tsconfig: join(work, "tsconfig.json") });
+  } finally {
+    console.warn = original;
+  }
+  expect(warned.filter((line) => line.includes("CONFIGURATION_FIELD_CONFLICT"))).toEqual([]);
+});
+
 test("包住在没有 tsconfig 祖先的地方时，`resolve.tsconfigFilename` 也能让它转", async () => {
   // 外置/官方的包就住在 `node_modules/.pnpm/…` 里——向上找不到任何 tsconfig。这条守着那个开关：
   // 只给 `transform.decorator`（实测 vite 不带进 rolldown）不行，`resolve.tsconfigFilename` 才行。
@@ -172,8 +191,9 @@ test("包住在没有 tsconfig 祖先的地方时，`resolve.tsconfigFilename`
     ].join("\n"),
     "utf8",
   );
-  // tsconfig 放在**解析根之外**（那个包在 `work2/node_modules/…`，祖先链里没有 tsconfig），由
-  // `resolve.tsconfigFilename` 显式指过去——这正是外置/官方包在产物里的处境。
+  // 包在 `work2/node_modules/…`（祖先链里没有 tsconfig），tsconfig 由 `resolve.tsconfigFilename` 显式指过去——
+  // 外置/官方包在产物里的处境（`dshdev --prod` 的闭包面就是 node_modules 形态）。**装饰器由 transform 那一侧
+  // 保底**（tsconfig 的 include 面默认排除 node_modules），这条用例同时钉住"指了 tsconfig 也不会把装饰器弄丢"。
   const elsewhere = join(work2, "..", `dsh-tsconfig-${String(Date.now())}`, "tsconfig.json");
   await mkdir(join(elsewhere, ".."), { recursive: true });
   await writeFile(
@@ -202,6 +222,111 @@ test("包住在没有 tsconfig 祖先的地方时，`resolve.tsconfigFilename`
   }
 });
 
+test("`main` 是 CJS、`module` 是 ESM 的双形态包：产物补出 default（Node 下那句 import 拿的就是 CJS 的 module.exports）", async () => {
+  // `rrule` 就是这个形态：`main`（CJS）与 `module`（ESM，没有 default）导出面不同。浏览器里取的是 `module`，
+  // 不补 default 的话，上游那句 `import rrulePackage from 'rrule'` 会报
+  // `does not provide an export named 'default'`。
+  const dual = join(work, "dual");
+  await mkdir(join(dual, "dist", "cjs"), { recursive: true });
+  await mkdir(join(dual, "dist", "esm"), { recursive: true });
+  await writeFile(
+    join(dual, "package.json"),
+    `${JSON.stringify({
+      name: "dual",
+      version: "1.0.0",
+      main: "dist/cjs/index.js",
+      module: "dist/esm/index.js",
+    })}\n`,
+    "utf8",
+  );
+  await writeFile(
+    join(dual, "dist", "cjs", "index.js"),
+    "module.exports = { alpha: 1, beta: 2 };\n",
+    "utf8",
+  );
+  await writeFile(
+    join(dual, "dist", "esm", "index.js"),
+    "export const alpha = 1;\nexport const beta = 2;\n",
+    "utf8",
+  );
+
+  const bundled = await bundlePackage({
+    cacheRoot,
+    repoRoot: work,
+    alias: clientModulesAlias({
+      repoRoot,
+      nodeStub: join(repoRoot, "packages/client/dsh-client-modules/app-boot/node-stub.cjs"),
+    }),
+    name: "dual",
+    version: "1.0.0",
+    input: { index: join(dual, "dist", "esm", "index.js") },
+    watch: [join(dual, "dist", "esm")],
+  });
+  const file = join(cacheRoot, bundled?.files.get("index") ?? "");
+  const code = await readFile(file, "utf8");
+  // rolldown 会把 `export default` 压成 `export { x as default }`，两种形态都算补上了。
+  expect(code).toMatch(/\bas default\b|export default/u);
+
+  const loaded = (await import(pathToFileURL(file).href)) as {
+    readonly default: { readonly alpha?: number };
+    readonly beta?: number;
+  };
+  // default 与 Node 下 CJS 的 `module.exports` 同形：键都在上面。
+  expect(loaded.default.alpha).toBe(1);
+  expect(loaded.beta).toBe(2);
+});
+
+test("双形态包的 ESM 入口自带 default 时不覆盖它（`jsbi` 那种：`export default JSBI`）", async () => {
+  // 补 default 只对"ESM 入口没有 default"的那种包。`jsbi` 的 `module` 里有 `export default JSBI`，若也套上
+  // 命名空间对象，`@js-temporal/polyfill` 的 `import e from "jsbi"` 就拿不到 JSBI 类，运行期报
+  // `e.BigInt is not a function`。
+  const dualDefault = join(work, "dual-default");
+  await mkdir(join(dualDefault, "dist", "cjs"), { recursive: true });
+  await mkdir(join(dualDefault, "dist", "esm"), { recursive: true });
+  await writeFile(
+    join(dualDefault, "package.json"),
+    `${JSON.stringify({
+      name: "dual-default",
+      version: "1.0.0",
+      main: "dist/cjs/index.js",
+      module: "dist/esm/index.js",
+    })}\n`,
+    "utf8",
+  );
+  await writeFile(
+    join(dualDefault, "dist", "cjs", "index.js"),
+    "module.exports = { other: 1 };\n",
+    "utf8",
+  );
+  await writeFile(
+    join(dualDefault, "dist", "esm", "index.js"),
+    "const marker = { own: true };\nexport const other = 1;\nexport default marker;\n",
+    "utf8",
+  );
+
+  const bundled = await bundlePackage({
+    cacheRoot,
+    repoRoot: work,
+    alias: [],
+    name: "dual-default",
+    version: "1.0.0",
+    input: { index: join(dualDefault, "dist", "esm", "index.js") },
+    watch: [join(dualDefault, "dist", "esm")],
+  });
+  const file = join(cacheRoot, bundled?.files.get("index") ?? "");
+  const loaded = (await import(pathToFileURL(file).href)) as {
+    readonly default: { readonly own?: boolean; readonly other?: number };
+  };
+  // 包自己的 default（不是命名空间对象：命名空间上没有 `own`、倒是有 `other`）。
+  expect(loaded.default.own).toBe(true);
+  expect(loaded.default.other).toBeUndefined();
+});
+
+test("纯 ESM 的包不补 default（不掩盖真实的导出缺失）", async () => {
+  const code = await readFile(join(cacheRoot, "fixture@1.0.0", "b.js"), "utf8");
+  expect(code).not.toContain("export default");
+});
+
 test("清单里解析不到的依赖不算可外置候选，也不该让预编译失败", async () => {
   // 真实里踩到的形状：`zustand` 的 `peerDependencies` 里有 `@types/react`（optional）——类型包不在运行时闭包
   // 里，于是解析它必然失败。它是**可选** peer、又解析不到，两条都不该让它进候选；若把异常抛出去，死的是

package/src/bundle.ts

@@ -9,10 +9,10 @@
  * 两者产出的地址同构（`@client-modules/<pkg>@<version>/<file>`），所以运行时按 URL 取即可。
  */
 import { createHash } from "node:crypto";
-import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { mkdir, readFile, readdir, realpath, stat, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { findPackageJSON } from "node:module";
-import { dirname, join, relative, sep } from "node:path";
+import { dirname, join, relative, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 import { clientAssetPlugin, NODE_BUILTIN } from "@morlay/dsh-cordis-assets/assets";
 import { cssInlinePlugins } from "@morlay/dsh-cordis-assets/styles";
@@ -61,7 +61,7 @@ export function clientModulesAlias(options: {
  * 规则变了、源码没变时，旧产物必须作废，否则会继续复用带着老 URL 的字节。
  */
 /** 构建器**规则**版本：改解析 / 改写规则就 bump（见 {@link BUNDLER_REV}）。 */
-const BUNDLER_RULES = "22";
+const BUNDLER_RULES = "28";
 
 /**
  * 地址里的 `?v=`（与 vite 同一个写法）：构建器**规则指纹**（`BUNDLER_RULES` 的哈希，形如 vite 的 `?v=`）。
@@ -322,6 +322,32 @@ function browserProcessPlugin(): PluginOption {
   };
 }
 
+/**
+ * 入口是否按**它所属包的声明**是 CJS（Node 的 ESM 解析会做 `default = module.exports` 的那一侧）。
+ *
+ * 判据只看声明，不看源码内容：
+ * - `type: "module"` 的包 → 恒为 ESM（`.mjs` 同理）；
+ * - 否则是"老约定"：`module` 字段指向的那份视为 ESM（打包器约定，Node 不认），其余 `.js` 视为 CJS、
+ *   `.cjs` 恒为 CJS；`.ts` 这类源码交给语法（rolldown 自己判）。
+ *
+ * 以前这里是"读源码找 `module.exports =`"，那是猜：`exports.` 出现在注释里就会误判，而 `type: module` 的
+ * 包即使有 CJS 写法也不该被当 CJS。
+ */
+async function declaresCjs(entry: string): Promise<boolean> {
+  if (entry.endsWith(".mjs")) return false;
+  if (entry.endsWith(".cjs")) return true;
+  if (!entry.endsWith(".js")) return false;
+  const manifestPath = await packageJsonNear(entry);
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8").catch(() => "{}")) as {
+    type?: string;
+    module?: string;
+  };
+  if (manifest.type === "module") return false;
+  const manifestModule = manifest.module;
+  if (manifestModule === undefined) return true;
+  return resolve(dirname(manifestPath), manifestModule) !== resolve(entry);
+}
+
 /**
  * CJS 入口的**具名导出包装**（`react` 这类）。
  *
@@ -339,14 +365,7 @@ async function cjsShimOf(options: {
   outDir: string;
   log?: (message: string) => void;
 }): Promise<string | undefined> {
-  const source = await readFile(options.entry, "utf8").catch(() => "");
-  // 判据是**CJS 入口**：`.js`/`.cjs` 且源码里真的在赋值 `module.exports` / `exports.x`（`react` 的入口是
-  // `module.exports = require('./cjs/…')`）。TS 源码不在此列——那是 ESM；按"含 `exports.` 子串"判断会把
-  // 注释里的 `re-exports.` 也当成 CJS，反过来给一份纯 ESM 加 `import mod from …` 而构建失败。
-  const isCjsEntry =
-    /\.(?:cjs|js)$/u.test(options.entry) &&
-    /(?:^|\n)\s*(?:module\.exports\s*=|exports\.[A-Za-z_$][A-Za-z0-9_$]*\s*=)/u.test(source);
-  if (!isCjsEntry) return undefined;
+  if (!(await declaresCjs(options.entry))) return undefined;
   let keys: string[];
   try {
     // 求值才知道键：CJS 的导出面是**运行期**的（静态分析只能看到 `module.exports = require(…)`）。
@@ -381,6 +400,62 @@ async function cjsShimOf(options: {
   return file;
 }
 
+/** 根出口的产物名（`urlOf` 对非 client 行写的就是它）。 */
+const ROOT_EXPORT = "index";
+
+/** 具名导出的合法标识符：补 default 时按它挑键（非标识符的导出名用不了简写）。 */
+const EXPORT_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+
+/**
+ * 这个入口是否需要「CJS 包的 ESM 便利入口」的 default 补偿。判据**只看 package.json 的声明**：
+ *
+ * - `type: "module"` 的包：Node 与我们都按 `exports`（或 `main` 本身就是 ESM）解析，两边一致，不补；
+ * - 其余是 CJS 包：`module` 只是打包器约定（视为 ESM），`main` 才是 CJS。这条链选 `module`（更小、没有
+ *   webpack 垫片），而 Node 的 `import pkg from 'pkg'` 落到 `main`、default 是它的 `module.exports`——
+ *   所以浏览器侧得补一个 default，否则消费方那句 default import 直接报
+ *   `does not provide an export named 'default'`（`rrule` 就是这一例）。
+ * - 有 `exports` 的包两边都按条件解析，不涉及这条约定；入口不是 `module` 的（选了 `main`）由
+ *   {@link cjsShimOf} 处理。`main`/`module` 只描述根出口，子路径不在此列。
+ */
+async function needsCjsInterop(entry: string, exportName: string): Promise<boolean> {
+  if (exportName !== ROOT_EXPORT) return false;
+  const manifestPath = await packageJsonNear(entry);
+  const manifest = JSON.parse(await readFile(manifestPath, "utf8").catch(() => "{}")) as {
+    main?: string;
+    module?: string;
+    type?: string;
+    exports?: unknown;
+  };
+  if (manifest.type === "module" || manifest.exports !== undefined) return false;
+  const manifestModule = manifest.module;
+  if (manifestModule === undefined || manifest.main === undefined) return false;
+  const modulePath = resolve(dirname(manifestPath), manifestModule);
+  const moduleEntry = await realpath(modulePath).catch(() => modulePath);
+  const entryPath = await realpath(entry).catch(() => resolve(entry));
+  return moduleEntry === entryPath || modulePath === resolve(entry);
+}
+
+/**
+ * 给「CJS 包的 ESM 便利入口」补 default：**看产物的真实导出面**（`chunk.exports`），不猜源码。
+ * 已经有 default 的（`jsbi` 的 `export default JSBI`）原样保留——补成对象会把它顶掉，
+ * `@js-temporal/polyfill` 那句 `import e from "jsbi"` 于是拿到命名空间、运行期 `e.BigInt is not a function`；
+ * 没有的补成 `{ 具名导出… }`，与 CJS 的 `module.exports` 同形（`rrule` 的 `ALL_WEEKDAYS` / `rrulestr` 那批）。
+ */
+function cjsInteropPlugin(exportName: string): Plugin {
+  return {
+    name: "dsh-cjs-interop",
+    generateBundle(_options, bundle) {
+      for (const chunk of Object.values(bundle)) {
+        if (chunk.type !== "chunk" || chunk.isEntry !== true || chunk.name !== exportName) continue;
+        if (chunk.exports.includes("default")) continue;
+        const named = chunk.exports.filter((name) => EXPORT_IDENTIFIER.test(name));
+        if (named.length === 0) continue;
+        chunk.code += `\nexport default { ${named.join(", ")} };\n`;
+      }
+    },
+  };
+}
+
 /**
  * CSS 入口的包装：**样式文件不能直接当入口**——vite 的库模式固定 `cssCodeSplit: false`，遇到
  * `rolldownOptions.input` 里有 `.css` 直接报错。包一层 side-effect import，让样式插件按它一贯的方式
@@ -572,7 +647,10 @@ async function bundlePackageOnce(
   // 入口补偿：CJS 要带具名导出的包装；CSS 不能直接当入口（vite 的库模式 `cssCodeSplit: false`，
   // 明确拒绝 `rolldownOptions.input` 里出现 CSS 文件），包一层 side-effect import 让样式插件处理它。
   const input: Record<string, string> = {};
+  // 「CJS 包的 ESM 便利入口」这一形态要补一个 default（判据见 `needsCjsInterop`），补的时机在产物生成之后。
+  let interopExport: string | undefined;
   for (const [exportName, entry] of Object.entries(options.input)) {
+    if (await needsCjsInterop(entry, exportName)) interopExport = exportName;
     input[exportName] =
       (await cjsShimOf({
         name: options.name,
@@ -584,12 +662,25 @@ async function bundlePackageOnce(
       (await cssShimOf({ exportName, entry, outDir })) ??
       entry;
   }
+  if (interopExport !== undefined) plugins.push(cjsInteropPlugin(interopExport));
   // **直接跑 rolldown**（不经过 `vite build`）：插件本来就是 rolldown 的接口，而 vite 在这条路上只提供了
   // lib 模式的入口/输出命名与 `worker.format`——那几项自己写更直接，且 `build.rolldownOptions` 里的
   // `transform` / `resolve` 也不会再被 vite 吞掉（对照表见债文档，那份债随这次改动一起销）。
   const bundle = await rolldown({
     input,
     plugins,
+    // 装饰器口径在两处声明（tsconfig 的 `experimentalDecorators` 与 `transform.decorator`）时，rolldown 会提
+    // 一条 `CONFIGURATION_FIELD_CONFLICT` 让人确认——那是"重复声明"级提示，两者语义等价，我们主动取
+    // transform 这一侧（见上面的 decorator 注释）。过滤掉这一条，别的日志照旧走默认处理。
+    onLog: (level, log, handler) => {
+      if (
+        log.code === "CONFIGURATION_FIELD_CONFLICT" &&
+        log.message?.includes("experimentalDecorators") === true
+      ) {
+        return;
+      }
+      handler(level, log);
+    },
     // **不指 tsconfig**：装饰器由下面的 `transform.decorator.legacy` 直接开（直出时它生效，见对照表）。
     // rolldown 自己会解析 tsconfig（含 `extends`，实测过），所以两种形态各指一处不如一处都不指。
     ...(options.tsconfig === undefined ? {} : { resolve: { tsconfigFilename: options.tsconfig } }),
@@ -598,7 +689,11 @@ async function bundlePackageOnce(
       // 直出后没有 `build.target: "baseline-widely-available"` 那层展开，这里自己写全。不要图省事写
       // `esnext` 或留空——目标一低，oxc 就给类字段、可选链这些逐个加降级 helper，产物里全是奇怪的垫片。
       target: ["chrome111", "edge111", "firefox114", "safari16.4"],
-      // 装饰器：legacy（cordis 与上游用的就是这套）。有 tsconfig 时它会被那份覆盖，这里是默认。
+      // 装饰器：legacy（cordis 与上游用的就是这套）。**必须显式给**：闭包面（`node_modules`）里的包不在
+      // tsconfig 的 include 面里（tsc 默认排除 `node_modules`，oxc 同样不应用那份设置），只靠根 tsconfig 的
+      // `experimentalDecorators` 的话，上游的 `@Remote` 会原样留在产物里、浏览器整条入口不执行。
+      // 它与 tsconfig 那项**语义相同**，两处都声明时 rolldown 会提示"tsconfig 被 transform 覆盖"——这条提示
+      // 对我们没有决策价值（见下面的 `onLog`），不是需要处理的冲突。
       decorator: { legacy: true },
       // 浏览器没有 `process`：精确替换 `process.env`，裸 `process` 再给一个空壳——`immer` 这类包会在
       // 模块顶层读它，漏掉就是一个 `process is not defined` 把整份产物带下去。

package/src/index.ts

@@ -97,10 +97,13 @@ export interface ClientRow {
  * 自己的 client 半里 import，不该出现在装配清单里；混进来就会多装配一次（`apply` 里那些"同 namespace 的
  * locale 已注册"的报错就是这么来的），也会在入口打出一串 `skip (no apply/default)`。
  */
-async function clientRowsOf(loader: { entries(): Generator<LoaderEntry> }): Promise<ClientRow[]> {
+// 参数只声明"能迭代条目"：上游 `Entry` 的类型面随版本演进（alpha.3 换了 `Generator` 的返回/next 参数），
+// 我们只要下面那几个字段，边界收成 `unknown` 再窄化，别让版本演进每次都在这里报类型错。
+async function clientRowsOf(loader: { entries(): Iterable<unknown> }): Promise<ClientRow[]> {
   const found = new Map<string, ClientRow>();
   // `entries()` 是生成器（cordis 的 Loader 就是这么给的），直接迭代即可。
-  for (const entry of loader.entries()) {
+  for (const raw of loader.entries()) {
+    const entry = raw as LoaderEntry;
     if (entry.disabled === true || entry.fiber === undefined) continue;
     const name = entry.options?.name;
     if (typeof name !== "string" || name === "") continue;

package/src/serve-vite.ts

@@ -142,17 +142,14 @@ export async function startViteDev(
       // 表现为一串"没被 vite 接手"的 404）。
       fs: { strict: false, allow: [repoRoot] },
     },
-    // **不用** vite 的 `optimizeDeps`：裸说明符已由插件统一改写成 `@deps/`（我们自己预打包的产物），
-    // vite 再打一份就会与聚合产物里的那份形成两个实例。
-    // **不用** vite 的 `optimizeDeps`（关掉自动发现）：非开发模块与三方都由我们的联邦链产出，裸说明符
-    // 已在插件里改写成 `@client-modules/…`，这里没有任何东西需要预打包。开着只会多出第二条链（浏览器里
-    // 同时出现 `.vite/deps/react.js` 与我们的 `@client-modules/react@…/index.js`）与一次全仓扫描。
-    // **彻底不用** vite 的依赖优化器：裸说明符已由插件统一改写成 `@client-modules/…`（我们自己的联邦链产出），
-    // 这里没有任何东西需要它预打包。`noDiscovery: true` 只关了"自动发现"，扫描器仍会去解析那些包名——而行清单
-    // 是**虚拟模块**、里面写的包名 vite 按 `package.json` 的去向解析，落到工作区解析面上就报
-    // `Cannot find package … imported from …/package.json`（上游 workspace 内部包只存在于 vendor / 闭包）。
-    // `disabled` 是官方给的"整个关掉"（标了 deprecated，但语义正是这个）。
-    optimizeDeps: { disabled: true, noDiscovery: true, include: [] },
+    // **不用** vite 的依赖优化器：裸说明符已由插件统一改写成 `@client-modules/…`（我们自己的联邦链产出），
+    // 这里没有任何东西需要它预打包。开着只会多出第二条链（浏览器里同时出现 `.vite/deps/react.js` 与我们的
+    // `@client-modules/react@…/index.js`，两个实例）与一次全仓扫描。行清单是**虚拟模块**、里面写的包名 vite
+    // 会按 `package.json` 的去向解析，落到工作区解析面上就报
+    // `Cannot find package … imported from …/package.json`（上游 workspace 内部包只存在于 vendor / 闭包），
+    // 所以必须连"扫描"一起关掉。
+    // 官方口径的"整个关掉"就是这两个字段（`optimizeDeps.disabled` 在 Vite 5.1 已移除，传它只会换来一条告警）。
+    optimizeDeps: { noDiscovery: true, include: [] },
     plugins: [
       dshClientRowsPlugin({
         repoRoot,