@lingfan-engine/stories-build 0.3.0 → 0.3.2

package/host-plugins.mjs

@@ -0,0 +1,20 @@
+/**
+ * `@lingfan-engine/stories-build/host-plugins` 的 Node 装载垫片。
+ *
+ * 为什么需要它：本包以 TypeScript 源码出口，而 Node 的类型擦除**拒绝加载
+ * node_modules 里的 .ts**（ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING）。这个子路径
+ * 的消费方恰好是 **Node 直接加载的构建配置**（`vite.config.ts` 经 `vite.plugins.ts`
+ * 引它），而 vite 默认的配置加载器会把依赖外置成真实的 ESM import——于是配置一加载
+ * 就崩在 .ts 上。垫片用本包自带依赖 `tsx` 装载真实实现，扫描逻辑仍然只有一份。
+ *
+ * 类型不走这里：`package.json` 的 `exports` 对该子路径用条件导出，`types` 条件仍指向
+ * `./src/host-plugins/index.ts`，TypeScript 侧看到的还是源码声明。
+ */
+import { tsImport } from "tsx/esm/api";
+
+const mod = await tsImport("./src/host-plugins/index.ts", import.meta.url);
+
+export const STORY_FONTS_MODULE_ID = mod.STORY_FONTS_MODULE_ID;
+export const STORY_LIST_MODULE_ID = mod.STORY_LIST_MODULE_ID;
+export const storyFontsVirtual = mod.storyFontsVirtual;
+export const storyListVirtual = mod.storyListVirtual;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingfan-engine/stories-build",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "Stories 创作链编译包：把 Stories.src 的多目录原生 TS 源编译成 Resources/Stories/** + project.json，并产出 cell 注册生成物",
   "license": "Apache-2.0",
@@ -9,7 +9,10 @@
     "./authoring": "./src/authoring.d.ts",
     "./cell": "./src/cell/index.ts",
     "./cli": "./src/cli/cli.ts",
-    "./host-plugins": "./src/host-plugins/index.ts",
+    "./host-plugins": {
+      "types": "./src/host-plugins/index.ts",
+      "default": "./host-plugins.mjs"
+    },
     "./watch": "./src/pipeline/watch.ts",
     "./watch-cli": "./src/cli/watch-cli.ts"
   },
@@ -20,12 +23,13 @@
   "files": [
     "src",
     "bin",
+    "host-plugins.mjs",
     "!src/**/*.test.ts"
   ],
   "sideEffects": false,
   "dependencies": {
-    "@lingfan-engine/core": "^0.3.0",
-    "@lingfan-engine/editor": "^0.3.0",
+    "@lingfan-engine/core": "^0.3.2",
+    "@lingfan-engine/editor": "^0.3.2",
     "esbuild": "^0.28.2",
     "tsx": "^4.23.15",
     "typescript": "~6.0.3"

package/src/host-plugins/virtual-modules.ts

@@ -27,20 +27,30 @@ export interface HostPlugin {
   readonly name: string;
   readonly resolveId: (id: string) => string | null;
   readonly load: (id: string) => string | null;
-  readonly configureServer?: (server: DevServerLike) => void;
+  /** 方法签名而非函数属性：理由同 `DevServerLike`，参数按双变才吃得下各版本 vite */
+  configureServer?(server: DevServerLike): void;
 }
 
-/** dev server 的最小结构面：只用到「加监听目录、作废模块、整页刷新」三件事 */
+/**
+ * dev server 的最小结构面：只用到「加监听目录、作废模块、整页刷新」三件事。
+ *
+ * 成员一律写成**方法签名**而不是函数属性。这不是风格问题：`strictFunctionTypes`
+ * 只对函数属性做参数逆变检查，方法签名按双变处理。写成属性时 `invalidateModule`
+ * 的参数会从 `unknown` 反向要求各版本 vite 的 `ModuleNode` 可赋给 `unknown`
+ * 之外的东西——vite 5 的 `(mod: ModuleNode, seen?, timestamp?, isHmr?)` 因此
+ * 判不成 `(mod: unknown) => void`，插件对象也就进不了它的 `plugins` 数组。
+ * 同一份结构面必须同时兼容 vite 5（小程序壳）与 vite 8（浏览器 / Tauri 壳）。
+ */
 export interface DevServerLike {
   readonly watcher: {
-    add: (paths: readonly string[]) => void;
-    on: (event: "add" | "unlink", listener: (file: string) => void) => void;
+    add(paths: readonly string[]): void;
+    on(event: "add" | "unlink", listener: (file: string) => void): void;
   };
   readonly moduleGraph: {
-    getModuleById: (id: string) => unknown;
-    invalidateModule: (mod: unknown) => void;
+    getModuleById(id: string): unknown;
+    invalidateModule(mod: unknown): void;
   };
-  readonly ws: { send: (payload: { type: "full-reload" }) => void };
+  readonly ws: { send(payload: { type: "full-reload" }): void };
 }
 
 /** 资源根定位选项 */