@lingfan-engine/shell 0.1.5 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingfan-engine/shell",
-  "version": "0.1.5",
+  "version": "0.3.0",
   "type": "module",
   "description": "灵泛叙事引擎宿主编排层：平台无关的宿主装配逻辑（提示条、事件落点、面板数据、叙事状态投影），消费方用自己的响应式系统落地",
   "license": "Apache-2.0",
@@ -13,8 +13,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@lingfan-engine/core": "^0.1.5",
-    "@lingfan-engine/ui": "^0.1.5"
+    "@lingfan-engine/core": "^0.3.0",
+    "@lingfan-engine/ui": "^0.3.0"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -41,6 +41,7 @@ export {
 /** 叙事视图状态投影 */
 export {
   createNarrativeState,
+  type InputCandidate,
   type MenuChoice,
   type NarrativeState,
   type NarrativeStateOptions,

package/src/state/index.ts

@@ -3,6 +3,7 @@
  */
 export { createNarrativeState } from "./narrativeState";
 export type {
+  InputCandidate,
   MenuChoice,
   NarrativeState,
   NarrativeStateOptions,

package/src/state/narrativeState.ts

@@ -17,6 +17,7 @@ import {
   INSTANCE_Z_KEYS,
   SYS,
   type ElementInstance,
+  type InputCandidate,
 } from "@lingfan-engine/core";
 import {
   createStateView,
@@ -38,6 +39,7 @@ const STATE_KEYS: StateKeyTable = {
   nvlBuffer: SYS.nvlBuffer,
   menuOptions: SYS.menuOptions,
   menuTargets: SYS.menuTargets,
+  inputOptions: SYS.inputOptions,
   dialogVisible: SYS.dialogVisible,
   elements: SYS.elements,
 };
@@ -65,6 +67,7 @@ export function createNarrativeState(
   const dialogHidden = cell(false);
   const menuPrompt = cell("");
   const inputPrompt = cell("");
+  const inputCandidates = cell<InputCandidate[]>([]);
   const inputValue = cell("");
   const rawTexts = cell<string[]>([]);
   const rawTargets = cell<string[]>([]);
@@ -88,6 +91,19 @@ export function createNarrativeState(
     }));
   }
 
+  /** 输入候选的读形：只收 `{ text, value }` 双字符串项，畸形项整项丢弃 */
+  function candidatesOf(value: unknown): InputCandidate[] {
+    if (!Array.isArray(value)) return [];
+    const out: InputCandidate[] = [];
+    for (const item of value) {
+      if (item === null || typeof item !== "object") continue;
+      const { text, value: fill } = item as { text?: unknown; value?: unknown };
+      if (typeof text !== "string" || typeof fill !== "string") continue;
+      out.push({ text, value: fill });
+    }
+    return out;
+  }
+
   const toIntent = createStateView({
     keys: STATE_KEYS,
     resolveLayer: (key) => options.resolveLayer(key),
@@ -151,6 +167,9 @@ export function createNarrativeState(
             rawTargets.value = value as string[];
             refreshMenuOptions();
           }
+        } else if (key === STATE_KEYS.inputOptions) {
+          // 候选是「显示文本 + 填入值」的对象数组：畸形项整项丢弃，全丢即等于无候选
+          inputCandidates.value = candidatesOf(value);
         }
         return;
       case "nvl-mode":
@@ -198,6 +217,7 @@ export function createNarrativeState(
     dialogHidden,
     menuPrompt,
     inputPrompt,
+    inputCandidates,
     inputValue,
     rawTexts,
     rawTargets,
@@ -229,6 +249,7 @@ export function createNarrativeState(
       menuPrompt.value = typeof mp === "string" ? mp : "";
       const ip = read(SYS.inputPrompt);
       inputPrompt.value = typeof ip === "string" ? ip : "";
+      inputCandidates.value = candidatesOf(read(SYS.inputOptions));
       const opts = read(SYS.menuOptions);
       rawTexts.value = Array.isArray(opts) ? (opts as string[]) : [];
       const tgts = read(SYS.menuTargets);

package/src/state/types.ts

@@ -7,6 +7,7 @@
  */
 import type {
   ElementInstance,
+  InputCandidate,
   LayerId,
   MenuChoice,
 } from "@lingfan-engine/core";
@@ -14,7 +15,7 @@ import type { TypingSetting } from "@lingfan-engine/ui";
 import type { Cell, ReadonlyCell } from "../cell";
 
 // 选项形状属于引擎读口，本域只转出：消费方不必为此再引一个包
-export type { MenuChoice };
+export type { InputCandidate, MenuChoice };
 
 /** 本域的状态单元集：每个视图字段一个单元（框架宿主传响应式单元） */
 export interface StateCells {
@@ -74,6 +75,8 @@ export interface NarrativeState {
   readonly menuPrompt: Cell<string>;
   /** 输入提示行 */
   readonly inputPrompt: Cell<string>;
+  /** 输入候选（显示文本 + 填入值；空数组 = 只有输入框） */
+  readonly inputCandidates: ReadonlyCell<InputCandidate[]>;
   /** 输入框内容 */
   readonly inputValue: Cell<string>;
   /** 选项文本（引擎原样） */