@lingfan-engine/create 0.3.0 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingfan-engine/create",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "工程生成器：从模板骨架生成新工程，可选框架与壳",
   "license": "Apache-2.0",

package/template/__PROJECT__/package.json

@@ -10,11 +10,11 @@
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.node.json"
   },
   "dependencies": {
-    "@lingfan-engine/adapters": "^0.3.0",
-    "@lingfan-engine/core": "^0.3.0",
-    "@lingfan-engine/shell": "^0.3.0",
-    "@lingfan-engine/stories-build": "^0.3.0",
-    "@lingfan-engine/ui": "^0.3.0"
+    "@lingfan-engine/adapters": "^0.3.2",
+    "@lingfan-engine/core": "^0.3.2",
+    "@lingfan-engine/shell": "^0.3.2",
+    "@lingfan-engine/stories-build": "^0.3.2",
+    "@lingfan-engine/ui": "^0.3.2"
   },
   "devDependencies": {
     "@types/node": "^26.6.3",

package/template/__PROJECT__/vite.config.ts

@@ -1,5 +1,5 @@
 import { defineConfig } from "vite";
-import { storyFontsVirtual, storyListVirtual } from "./vite.plugins";
+import { storyFontsVirtual, storyListVirtual } from "./vite.plugins.ts";
 
 /**
  * 脚手架工程的 Vite 配置：约定资源根、宿主端口与两个清单虚拟模块。

package/template/overlays/miniprogram/package.patch.json

@@ -4,7 +4,7 @@
     "@dcloudio/uni-components": "3.0.0-4080720251210001",
     "@dcloudio/uni-h5": "3.0.0-4080720251210001",
     "@dcloudio/uni-mp-weixin": "3.0.0-4080720251210001",
-    "@lingfan-engine/shell": "^0.3.0",
+    "@lingfan-engine/shell": "^0.3.2",
     "vue": "3.4.21"
   },
   "devDependencies": {

package/template/overlays/miniprogram/vite.config.ts

@@ -20,7 +20,7 @@ import uniModule, {
   type VitePluginUniOptions,
 } from "@dcloudio/vite-plugin-uni";
 import { defineConfig, type Plugin } from "vite";
-import { storyFontsVirtual, storyListVirtual } from "./vite.plugins";
+import { storyFontsVirtual, storyListVirtual } from "./vite.plugins.ts";
 
 type UniPluginFactory = (options?: VitePluginUniOptions) => Plugin[];
 

package/template/overlays/react/src/UiHost.tsx

@@ -12,7 +12,13 @@
  *
  * 组件由 React 自己创建，所以挂载点的父子关系归 React——组合根不该再往这个容器里写节点。
  */
-import { createElement, useEffect, useMemo, useSyncExternalStore } from "react";
+import {
+  createElement,
+  Fragment,
+  useEffect,
+  useMemo,
+  useSyncExternalStore,
+} from "react";
 import { missingMounts, selectMounts } from "@lingfan-engine/ui";
 import { controlsStore } from "./controls";
 import { mountStore, uis } from "./mounts";
@@ -49,7 +55,10 @@ export function UiHost() {
     }
   }, [raw]);
 
+  // 外层用 Fragment 而不是 null：`createElement(null, …)` 不是合法调用形态，
+  // 类型上也过不去（第一个参数只接受标签名或组件）。
   return createElement(
+    Fragment,
     null,
     ...items.map((item) =>
       createElement(item.component as never, {

package/template/overlays/react/src/main.tsx

@@ -9,6 +9,7 @@
  * 本层只替换入口与组合根）。
  */
 import { createElement, StrictMode } from "react";
+import { flushSync } from "react-dom";
 import { createRoot } from "react-dom/client";
 import { MANIFEST_FILE } from "@lingfan-engine/core";
 import { DEFAULT_TEXT_CPS, DEFAULT_TOAST_MS } from "@lingfan-engine/ui";
@@ -63,10 +64,19 @@ function mountApp(): StageDom | undefined {
   try {
     const container = document.querySelector("#app");
     if (container === null) throw new Error("宿主缺少节点：#app");
-    // StrictMode 只影响开发期的重复渲染提示，不改变侧建行为：引擎在下面单独启动
-    createRoot(container).render(
-      createElement(StrictMode, null, createElement(App)),
-    );
+    /**
+     * 必须同步提交后再读节点。
+     *
+     * `createRoot().render()` 是并发渲染，只保证「稍后」提交——紧接着 `readDom()`
+     * 读到的还是空容器，取节点当场就抛，页面停在白屏。
+     * `flushSync` 把这次渲染强制同步落地，读节点时才拿得到 `App` 渲染出的结构。
+     * StrictMode 只影响开发期的重复渲染提示，不改变侧建行为：引擎在下面单独启动。
+     */
+    flushSync(() => {
+      createRoot(container).render(
+        createElement(StrictMode, null, createElement(App)),
+      );
+    });
     return readDom();
   } catch (error) {
     console.error(error);

package/template/overlays/react/vite.config.ts

@@ -9,7 +9,7 @@
  */
 import react from "@vitejs/plugin-react";
 import { defineConfig } from "vite";
-import { storyFontsVirtual, storyListVirtual } from "./vite.plugins";
+import { storyFontsVirtual, storyListVirtual } from "./vite.plugins.ts";
 
 /** 脚手架工程的 Vite 配置（React 形态） */
 export default defineConfig({

package/template/overlays/ts/package.patch.json

@@ -1,6 +1,6 @@
 {
   "devDependencies": {
-    "@lingfan-engine/editor": "^0.3.0"
+    "@lingfan-engine/editor": "^0.3.2"
   },
   "scripts": {
     "stories:build": "lingfan-stories-build .",

package/template/overlays/vue/vite.config.ts

@@ -9,7 +9,7 @@
  */
 import vue from "@vitejs/plugin-vue";
 import { defineConfig } from "vite";
-import { storyFontsVirtual, storyListVirtual } from "./vite.plugins";
+import { storyFontsVirtual, storyListVirtual } from "./vite.plugins.ts";
 
 /** 脚手架工程的 Vite 配置（Vue 形态） */
 export default defineConfig({

package/template/template-meta.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.8.0",
-  "minEngineVersion": "0.3.0",
+  "version": "1.8.2",
+  "minEngineVersion": "0.3.2",
   "placeholder": "__PROJECT__",
   "frameworks": [
     {