@lingfan-engine/create 0.1.4 → 0.2.0

package/template/overlays/ts/Stories.src/gen/stories.gen.d.ts

@@ -0,0 +1,12 @@
+/* GENERATED by stories:build (typegen) — 手改会在下次构建被覆盖 */
+export {};
+
+declare module "@lingfan-engine/editor" {
+  interface ColumnNameRegistry {
+    "look_around": 1;
+    "title_main": 1;
+  }
+  interface InterpolationKeyRegistry {
+    "name": 1;
+  }
+}

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

@@ -0,0 +1,15 @@
+/**
+ * 四处看看：第二列，演示「一个函数就是一列」。
+ *
+ * 列与列之间靠名字跳转（`menu` 的选项值就是目标列 id），跨文件也可以——
+ * 本文件与 `title_main.ts` 同属 `config.ts` 里 `folders` 声明的目录，
+ * 因此互相跳转不需要 import。
+ */
+import { script } from "@lingfan-engine/editor";
+
+const { say } = script;
+
+export default function look_around(): void {
+  say("你绕着走了一圈，什么也没发生。", "旁白");
+  say("想加点东西，就打开 Stories.src/title/look_around.ts 改写这一列。");
+}

package/template/overlays/ts/Stories.src/title/title_main.ts

@@ -0,0 +1,23 @@
+/**
+ * 入口故事列。
+ *
+ * 写法与运行时无关：这些函数在构建期被求值成命令序列，产物是
+ * `Resources/Stories/title/title_main.json`——引擎运行期读的是产物，不是本文件。
+ * 因此本文件可以随便用 TS 的能力（类型、函数、循环、import），只要最终落到
+ * `script` 提供的词上。词表与签名由 `@lingfan-engine/editor` 给出，编辑器里能补全。
+ *
+ * 一个函数就是一列（column）：函数名即列 id。`config.ts` 的 `start` 指向本文件，
+ * 所以它是进入故事时执行的第一列。
+ */
+import { script } from "@lingfan-engine/editor";
+
+const { menu, option, say } = script;
+
+export default function title_main(): void {
+  say("这是用 TypeScript 写的故事列。", "旁白");
+  say("改完保存，在工程根跑 pnpm stories:build 就会重新生成故事文件。");
+  menu("接下来做什么？", [
+    option("四处看看", "look_around"),
+    option("重来一次", "title_main"),
+  ]);
+}

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

@@ -0,0 +1,14 @@
+{
+  "devDependencies": {
+    "@lingfan-engine/editor": "^0.1.0",
+    "@lingfan-engine/stories-build": "^0.1.0"
+  },
+  "scripts": {
+    "stories:build": "lingfan-stories-build .",
+    "stories:watch": "lingfan-stories-watch .",
+    "stories-typecheck": "tsc --noEmit -p tsconfig.stories.json"
+  },
+  "create": {
+    "remove": ["Resources/Stories"]
+  }
+}

package/template/overlays/ts/src/stories.ts

@@ -0,0 +1,10 @@
+/**
+ * 本工程的故事文件表（相对资源根 `Resources/`）——**全工程唯一声明点**。
+ *
+ * 本工程走 TS 创作链：这里列的是 `Stories.src/` 编译出来的产物，
+ * 不要直接改 `Resources/Stories/**` 下的文件——它们是生成物，下次构建会被覆盖，
+ * 源里没有的旧列还会被清理掉。改故事请改 `Stories.src/`，然后 `pnpm stories:build`。
+ *
+ * 新增一列后记得回来把产物路径加进本表（Web 形态按显式清单取文件，不扫目录）。
+ */
+export const STORIES: readonly string[] = ["Stories/title/title_main.json"];

package/template/overlays/ts/tsconfig.stories.json

@@ -0,0 +1,25 @@
+{
+  /* Stories.src 的类型检查工程：与工程根的 tsconfig.json 分开。
+     理由：根 tsconfig 由框架层/壳层决定（Vue 要 vue-tsc、React 要 jsx），
+     而故事源只需要纯 tsc + 故事源自己的全局声明（defineVars / StoriesConfig /
+     script 的词表）。合并成一个工程会让两侧的 compilerOptions 互相打架。
+
+     构建（pnpm stories:build）不做类型检查——它只把 TS 编译成命令序列，
+     类型错了照样能生成故事文件。想让类型错误拦住你，就单独跑
+     pnpm stories-typecheck。 */
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["Stories.src/**/*.ts"]
+}

package/template/overlays/vue/src/main.ts

@@ -11,16 +11,15 @@
 import { createApp } from "vue";
 import { DEFAULT_TEXT_CPS, DEFAULT_TOAST_MS } from "@lingfan-engine/ui";
 import { bootHost, must, reportBootFailure, type StageDom } from "./host";
+import { STORIES } from "./stories";
 import App from "./App.vue";
 
 /**
  * 工程清单与故事文件：**都在应用资源根 `Resources/` 内**。
  * 宿主把 `Resources` 作为静态根，故逻辑路径就是 `project.json` / `Stories/**`。
- * **新增故事文件必须同步此表**（Web 形态按显式清单取文件）。
+ * 故事表在 `./stories`（唯一声明点，各形态共用）。
  */
 const MANIFEST = "project.json";
-/** 本工程的故事文件表（相对资源根；新增故事必须同步此表） */
-const STORIES = ["Stories/title/title_main.story"];
 
 /** 页面节点句柄表：每个 id 都必须由 `App.vue` 渲染（缺一个 `must` 当场抛） */
 function readDom(): StageDom {

package/template/template-meta.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.6.0",
+  "version": "1.7.0",
   "minEngineVersion": "0.1.0",
   "placeholder": "__PROJECT__",
   "frameworks": [
@@ -36,5 +36,17 @@
       "hint": "给浏览器形态再加一个桌面壳：存档落到应用数据目录，其余不变"
     }
   ],
-  "_comment": "模板版本唯一来源，独立于引擎版本：仅当 template/v1 内容真正变化时才手动 bump。placeholder 是目录/文件内的工程名占位符，生成时整体替换为工程名（对齐 _LingFanEngineTemplateTitle_ 占位符语义）。minEngineVersion 表示此模板要求的最低引擎版本。frameworks 与 shells 决定生成器会问什么、能叠哪些层，首项为缺省值；每一项的 id 对应 template/v1/overlays/<id> 目录（缺省层可以没有目录）。"
+  "sources": [
+    {
+      "id": "story",
+      "label": "故事文件（.story）",
+      "hint": "直接写引擎自带的文本故事格式，改完保存即生效"
+    },
+    {
+      "id": "ts",
+      "label": "TypeScript 源（Stories.src）",
+      "hint": "用 TS 写故事列：有类型补全与重构，构建时编译成故事文件"
+    }
+  ],
+  "_comment": "模板版本唯一来源，独立于引擎版本：仅当 template/v1 内容真正变化时才手动 bump。placeholder 是目录/文件内的工程名占位符，生成时整体替换为工程名（对齐 _LingFanEngineTemplateTitle_ 占位符语义）。minEngineVersion 表示此模板要求的最低引擎版本。frameworks / shells / sources 决定生成器会问什么、能叠哪些层，各自首项为缺省值；每一项的 id 对应 template/v1/overlays/<id> 目录（缺省层可以没有目录）。合并顺序为「骨架 → 框架 → 故事源 → 壳」，同路径文件由后一层覆盖前一层。"
 }