@lingfan-engine/editor 0.1.4 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingfan-engine/editor",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "type": "module",
   "description": "灵泛叙事作者层：op schema 单一事实源 + 词函数子语言 + 编辑期诊断 + 故事树纯映射器——只读写故事 JSON，不碰运行时与平台",
   "exports": {
@@ -13,7 +13,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@lingfan-engine/core": "^0.1.4",
+    "@lingfan-engine/core": "^0.2.0",
     "zod": "^4.6.5"
   },
   "license": "Apache-2.0",

package/src/contracts/texts.ts

@@ -106,13 +106,13 @@ export interface EditorTexts {
   invalidVarHandlePath(prop: string, prefix: string): string;
   /** script/expr：未注册的变量。 */
   unregisteredVariable(key: string): string;
-  /** script/expr 审计：操作数类型不匹配。 */
+  /** script/expr 检查：操作数类型不匹配。 */
   operandKindMismatch(op: string, side: string, want: string, described: string, note: string): string;
-  /** script/expr 审计：三元条件必须为 boolean。 */
+  /** script/expr 检查：三元条件必须为 boolean。 */
   ternaryCondNotBool(described: string): string;
-  /** script/expr 审计：不支持跨类型比较。 */
+  /** script/expr 检查：不支持跨类型比较。 */
   crossTypeComparison(op: string, left: string, right: string): string;
-  /** script/expr 审计：未知类型的操作数标签。 */
+  /** script/expr 检查：未知类型的操作数标签。 */
   unknownOperandKind(): string;
 
   /** schema/surface：扩展 op 归组不合法。 */

package/src/i18n/surfaces.ts

@@ -9,11 +9,12 @@
  * 路径语法：`a.b` 逐段取值；`a[].b` 的 `[]` = 对数组逐项迭代（`options[].text`）。
  */
 
-/** 可翻译原文面（运行期 Translate 挂接：say 文本+说话人 / menu prompt+选项 / input prompt / notify 文本。character.screen 见下——仅入编辑器比对面，运行期不翻） */
+/** 可翻译原文面（运行期 Translate 挂接：say 文本+说话人 / menu prompt+选项 / input prompt+候选文本 / notify 文本。character.screen 见下——仅入编辑器比对面，运行期不翻） */
 export const TRANSLATE_SURFACES: Readonly<Record<string, readonly string[]>> = {
   say: ["text", "speaker"],
   menu: ["prompt", "options[].text"],
-  input: ["prompt"],
+  // 候选只翻显示文本；`value` 是要写进变量的原样值，**不进翻译面**（否则多语言下故事逻辑随语言漂移）
+  input: ["prompt", "options[].text"],
   notify: ["text"],
   // character.screen 仅入编辑器比对面（原文收集/键抽取），运行期**不翻**：引擎恰好 7 个
   // translate 调用点（runtime/i18n/translate.ts:31、ops/dialog.ts:92/107/171/175、

package/src/index.ts

@@ -291,6 +291,7 @@ export {
   hide,
   imageElement,
   input,
+  inputCandidate,
   interaction,
   jump,
   letVar,

package/src/schema/catalog.ts

@@ -136,6 +136,9 @@ export const FIELD_META: Readonly<Record<string, FieldMeta>> = {
   "menu.z": { label: "层级（实例）", kind: "number" },
   "input.prompt": { label: "提示语", kind: "text" },
   "input.store": { label: "存入变量", kind: "identifier" },
+  "input.options": { label: "候选值", kind: "array" },
+  "input.options[].text": { label: "候选文本", kind: "text" },
+  "input.options[].value": { label: "填入值", kind: "string" },
   "input.z": { label: "层级（实例）", kind: "number" },
   "notify.text": { label: "文本", kind: "text" },
   "notify.type": { label: "类型", kind: "string" },

package/src/schema/opSchemas/commands.ts

@@ -56,6 +56,10 @@ const menuSchema = z.strictObject({
 const inputSchema = z.strictObject({
   prompt: NonEmpty,
   store: NonEmpty,
+  // 候选快捷值：显示文本 + 要填进 store 的值（与 menu 的 {text,target} 刻意不同名）
+  options: z
+    .array(z.strictObject({ text: NonEmpty, value: NonEmpty }))
+    .optional(),
   z: InstanceZ, // choices 层实例 z
 });
 

package/src/script/expr/audit/index.ts

@@ -1,5 +1,5 @@
 /**
- * 审计子模块出口：判类器与它使用的词法词汇。
+ * 检查子模块出口：判类器与它使用的词法词汇。
  *
  * 装配层只从这里取，不引子模块内部文件。
  */

package/src/script/expr/audit/parser.ts

@@ -1,5 +1,5 @@
 /**
- * 表达式审计：把装配时产出的 token 流按引擎的类型规则判类，违规记入警告池。
+ * 表达式检查：把装配时产出的 token 流按引擎的类型规则判类，违规记入警告池。
  *
  * 判类器是一个整体（方法共享游标 `pos` 与警告池），所以实现文件刻意只留一条导入。
  */

package/src/script/index.ts

@@ -52,9 +52,20 @@ export {
 } from "./words/index.ts";
 
 // —— 叙事 ——
-export { say, option, menu, input, notify, nvl, character, uncharacter } from "./words/index.ts";
+export {
+  say,
+  option,
+  menu,
+  input,
+  inputCandidate,
+  notify,
+  nvl,
+  character,
+  uncharacter,
+} from "./words/index.ts";
 export type {
   MenuOptionSpec,
+  InputCandidateSpec,
   SayOptions,
   NotifyOptions,
   NvlCommandMode,

package/src/script/vocabulary-gen.ts

@@ -39,6 +39,7 @@ export function selectWordSources(fileNames: readonly string[]): string[] {
  *  未登记的新导出词会让重建失败（见 renderVocabulary 的缺登记核对）。 */
 export const HELPER_WORDS: Readonly<Record<string, string>> = {
   option: "$menu.option",
+  inputCandidate: "$input.candidate",
   whenChain: "$if.chain",
   reward: "$minigame.reward",
   extOp: "$ext.op",

package/src/script/vocabulary.g.ts

@@ -164,6 +164,7 @@ export const SCRIPT_COVERAGE: Readonly<Record<string, string>> = {
   videoSkipable: "video_skipable",
   // —— 辅助词（补充表登记，不产独立 op） ——
   option: "$menu.option",
+  inputCandidate: "$input.candidate",
   whenChain: "$if.chain",
   reward: "$minigame.reward",
   extOp: "$ext.op",

package/src/script/words/narrative.ts

@@ -146,6 +146,31 @@ export function menu(
   };
 }
 
+/** 输入候选：显示文本 + 要填进变量的值（用 {@link inputCandidate} 构造） */
+export type InputCandidateSpec = NonNullable<CommandOf<"input">["options"]>[number];
+
+/**
+ * 构造一个输入候选，配合 {@link input} 使用：玩家点中它，`value` 就直接当输入值提交，
+ * 同时仍然可以自己打字。
+ *
+ * 与菜单的 {@link option} 不同——候选不跳列，只替玩家填一个值。
+ *
+ * @param text 候选上显示的文字（支持翻译；翻译只影响显示）。
+ * @param value 选中后写进 `store` 的原样值（**不进翻译表**，多语言下不变）。
+ * @returns 输入候选数据。
+ * @example
+ * input("你的身份是？", "role", [
+ *   inputCandidate("旅人", "traveler"),
+ *   inputCandidate("商人", "merchant"),
+ * ]);
+ */
+export function inputCandidate(
+  text: string,
+  value: string,
+): InputCandidateSpec {
+  return { text, value };
+}
+
 /**
  * 向玩家要一段文字：弹出输入框显示 `prompt`，玩家提交后，输入内容写进
  * 状态键 `store`，故事从下一句继续。
@@ -154,13 +179,30 @@ export function menu(
  *
  * @param prompt 输入框上方显示的问题/提示语（必填非空）。
  * @param store 收纳玩家输入的状态变量名（写进全局状态，之后可用 `{store}` 插值显示）。
+ * @param options 候选快捷值（可选）：给了就在输入框旁列出，玩家点一项即提交该项的 `value`，
+ *   也可以不理候选自己打字。用 {@link inputCandidate} 构造。
  * @returns `input` 故事命令。
  * @example
  * input("主角叫什么名字？", "playerName");
  * say("你好，{playerName}！");
+ * @example
+ * // 带候选：既能点，也能自己打
+ * input("你的身份是？", "role", [
+ *   inputCandidate("旅人", "traveler"),
+ *   inputCandidate("商人", "merchant"),
+ * ]);
  */
-export function input(prompt: string, store: string): CommandOf<"input"> {
-  return { op: "input", prompt, store };
+export function input(
+  prompt: string,
+  store: string,
+  options?: readonly InputCandidateSpec[],
+): CommandOf<"input"> {
+  return {
+    op: "input",
+    prompt,
+    store,
+    ...(options === undefined ? {} : { options: [...options] }),
+  };
 }
 
 /** type 保持手写的窄联合（schema 是 string）——作者侧补全优于校验面放宽 */