@lingfan-engine/create 0.3.5 → 0.3.7

package/package.json

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

package/template/overlays/miniprogram/tsconfig.json

@@ -15,5 +15,10 @@
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true
   },
+  /* 故事源不吃本工程：它是独立的 TS 工程，由 tsconfig.stories.json 的纯 tsc 检查。
+     本文件要么是 vue-tsc（Vue 要 SFC 类型），要么带 jsx（React 要 .tsx）——
+     两者都会把故事源 import 的 *.vue / *.tsx 解析成真实组件，
+     盖过 authoring 声明的 UiHandle 通配，把 mount(句柄) 判成型不匹配。 */
+  "exclude": ["src/Stories.src/**"],
   "include": ["src/**/*.ts", "src/**/*.vue", "vite.config.ts"]
 }

package/template/overlays/react/src/Stories.src/title/look_around.ts

@@ -0,0 +1,23 @@
+/**
+ * 这一列演示挂载界面：`mount(句柄, 显隐, props)`。
+ *
+ * 界面本体在 `src/ui/hint/hint.tsx`——目录名就是 UI 名，故事源默认导入它，
+ * 绑定名必须与目录名一致，构建期逐条校验。`props` 整份替换而不是逐字段合并，
+ * 值必须 JSON 安全（随快照存档），要操作引擎就走运行期注入的 `controls`。
+ */
+import { mount, script } from "@lingfan-engine/editor";
+
+import hint from "../../ui/hint/hint.tsx";
+
+const { say } = script;
+
+export const columnType = "ui";
+
+export default function look_around(): void {
+  mount(hint, true, { text: "提示条从这一列的 mount 调用挂上来" });
+  say("你绕着走了一圈，什么也没发生。", "旁白");
+  say(
+    "提示条是 src/ui/hint/hint.tsx，挂载语句在 src/Stories.src/title/look_around.ts。",
+    "旁白",
+  );
+}

package/template/overlays/react/src/ui/hint/hint.tsx

@@ -0,0 +1,30 @@
+/**
+ * 常驻提示条：一块贴在舞台上沿的只读小牌子。
+ *
+ * 三条约定与宿主形态无关——样式内联、不依赖 stage.css；只读部分设
+ * `pointerEvents: "none"`，不吃舞台上的点击；不读引擎状态（显隐由 `mount` 决定，
+ * 文案由 `props` 给，操作走 `controls`）。
+ */
+export default function Hint(props: { text?: string }) {
+  const text = props.text ?? "";
+  if (text === "") return null;
+  return (
+    <div
+      role="status"
+      style={{
+        position: "absolute",
+        top: "1rem",
+        left: "50%",
+        transform: "translateX(-50%)",
+        padding: "0.25rem 0.75rem",
+        borderRadius: "999px",
+        background: "rgba(0, 0, 0, 0.55)",
+        color: "#f4f1e8",
+        fontSize: "0.875rem",
+        pointerEvents: "none",
+      }}
+    >
+      {text}
+    </div>
+  );
+}

package/template/overlays/react/tsconfig.json

@@ -16,5 +16,10 @@
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true
   },
+  /* 故事源不吃本工程：它是独立的 TS 工程，由 tsconfig.stories.json 的纯 tsc 检查。
+     本文件要么是 vue-tsc（Vue 要 SFC 类型），要么带 jsx（React 要 .tsx）——
+     两者都会把故事源 import 的 *.vue / *.tsx 解析成真实组件，
+     盖过 authoring 声明的 UiHandle 通配，把 mount(句柄) 判成型不匹配。 */
+  "exclude": ["src/Stories.src/**"],
   "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

package/template/overlays/vue/src/Stories.src/title/look_around.ts

@@ -0,0 +1,23 @@
+/**
+ * 这一列演示挂载界面：`mount(句柄, 显隐, props)`。
+ *
+ * 界面本体在 `src/ui/hint/hint.vue`——目录名就是 UI 名，故事源默认导入它，
+ * 绑定名必须与目录名一致，构建期逐条校验。`props` 整份替换而不是逐字段合并，
+ * 值必须 JSON 安全（随快照存档），要操作引擎就走运行期注入的 `controls`。
+ */
+import { mount, script } from "@lingfan-engine/editor";
+
+import hint from "../../ui/hint/hint.vue";
+
+const { say } = script;
+
+export const columnType = "ui";
+
+export default function look_around(): void {
+  mount(hint, true, { text: "提示条从这一列的 mount 调用挂上来" });
+  say("你绕着走了一圈，什么也没发生。", "旁白");
+  say(
+    "提示条是 src/ui/hint/hint.vue，挂载语句在 src/Stories.src/title/look_around.ts。",
+    "旁白",
+  );
+}

package/template/overlays/vue/src/ui/hint/hint.vue

@@ -0,0 +1,29 @@
+<!--
+  常驻提示条：一块贴在舞台上沿的只读小牌子。
+
+  三条约定与宿主形态无关——自带 scoped 样式、不依赖 stage.css；只读部分设
+  `pointer-events: none`，不吃舞台上的点击；不读引擎状态（显隐由 `mount` 决定，
+  文案由 `props` 给，操作走 `controls`）。
+-->
+<script setup lang="ts">
+withDefaults(defineProps<{ text?: string }>(), { text: "" });
+</script>
+
+<template>
+  <div v-if="text !== ''" class="hint" role="status">{{ text }}</div>
+</template>
+
+<style scoped>
+.hint {
+  position: absolute;
+  top: 1rem;
+  left: 50%;
+  transform: translateX(-50%);
+  padding: 0.25rem 0.75rem;
+  border-radius: 999px;
+  background: rgb(0 0 0 / 55%);
+  color: #f4f1e8;
+  font-size: 0.875rem;
+  pointer-events: none;
+}
+</style>

package/template/overlays/vue/tsconfig.json

@@ -15,5 +15,10 @@
     "noUnusedParameters": true,
     "noFallthroughCasesInSwitch": true
   },
+  /* 故事源不吃本工程：它是独立的 TS 工程，由 tsconfig.stories.json 的纯 tsc 检查。
+     本文件要么是 vue-tsc（Vue 要 SFC 类型），要么带 jsx（React 要 .tsx）——
+     两者都会把故事源 import 的 *.vue / *.tsx 解析成真实组件，
+     盖过 authoring 声明的 UiHandle 通配，把 mount(句柄) 判成型不匹配。 */
+  "exclude": ["src/Stories.src/**"],
   "include": ["src/**/*.ts", "src/**/*.vue"]
 }

package/template/template-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.12.0",
+  "version": "1.14.0",
   "minEngineVersion": "0.3.2",
   "placeholder": "__PROJECT__",
   "frameworks": [