@sendevia/pi-ask-author 1.0.6 → 1.1.0

package/dist/texts.d.ts

@@ -1,492 +1,251 @@
 /**
  * @file texts.ts
- * @description 布局常量、终端图标、小说语法模板表与全局双向文案字典的单一来源，禁止各层直接书写文案字面量
+ * @description 全局双向文案字典的组装点：LLM 面协议常量与当前系统语言的作者面文案在此汇合
  *
  * 核心架构特性：
- * - 全插件唯一文案来源：任何可见字符串均必须经由本模块获取数值，其余各层只做获取数值、组合与排版
- * - `LAYOUT_CONFIG` / `ICONS` / `MAX_*` 集中声明可调参数与强制上限，便于统一调整参数与验证边界
- * - `NOVEL_TEMPLATES` 以「定界符 → 语义哨兵 → 原生 Markdown 载体 → 主题样式」单表声明小说语法，新增语法只需在表尾追加一项
- * - `TEXTS` 按受众严格分区，LLM 面恒为英文，作者面恒为中文，两侧文案不得互相渗透
+ * - 作者可见文案一律来自 `lang/*.json`，LLM 面文案来自 `llm-texts.ts`；本文件只做装载、组合与派生，不新增字面量
+ * - 派生函数（多选模式标签、确认按钮明细与标签）集中在此，避免组件层与排版层各自拼接
+ * - 语言探测与模板编译在 `i18n.ts` 完成，语言资源键集合以 `en_US` 为规范
  *
- * 分区导航（与文件自上而下的顺序一致）：终端呈现常量 → 载荷上限 → 小说语法资产 → 共享排版字面量 → 文案字典 `TEXTS`
- * 受众划分：`tool`（`label` 除外）/ `schema` / `markdown` 面向 LLM，唯一非英文片段为封套定界符 `【】`；`tool.label` / `command` / `common` / `tabs` / `view` / `menu` / `editor` / `status` / `help` / `summary` / `card` / `fallbacks` 面向作者
- *
- * 依赖方向：texts.ts → theme.ts（仅类型）；作为叶层被 format / schema / model / novel-markdown / view-rows / view-summary / component / index 消费，禁止任何反向导入
+ * 依赖方向：texts.ts → layout.ts / llm-texts.ts / i18n.ts；作为作者面文案的装配点被 schema / model / novel-markdown / view-* / tool-* / component / index 消费
  */
-import type { Theme } from "./theme.js";
-/** TUI 视图几何、分栏与滚动行为配置（数值项均标注单位 ms / cols / lines；分隔线条目为字符文本，不带单位） */
-export declare const LAYOUT_CONFIG: {
-    /** 双栏中间分隔符文本 */
-    readonly dividerChar: " │ ";
-    /** 外层框架分割线字符（双横线） */
-    readonly dividerThick: "═";
-    /** 内部内容分割线字符（单横线） */
-    readonly dividerThin: "─";
-    /** 中间分隔符可见宽度 (cols) */
-    readonly dividerWidth: 3;
-    /** 左栏最大可见宽度 (cols) */
-    readonly leftColMax: 46;
-    /** 左栏最小可见宽度 (cols) */
-    readonly leftColMin: 30;
-    /** 宽屏双栏下左栏占视口比例 */
-    readonly leftColRatio: 0.42;
-    /** 触发宽屏双栏的终端最小列宽 (cols) */
-    readonly splitViewMinWidth: 72;
-    /** 预览区单次翻页滚动行数 (lines) */
-    readonly previewScrollStep: 3;
-    /** 窄屏单栏折叠预览区最大可见行数 (lines) */
-    readonly singlePreviewHeight: 7;
-    /** 宽屏双栏右侧预览区最大可见行数 (lines) */
-    readonly splitPreviewHeight: 14;
-    /** 总览页单页最大内容行数 (lines) */
-    readonly summaryPageSize: 16;
-    /** 总览页单次滚动步长 (lines) */
-    readonly summaryScrollStep: 3;
-    /** 菜单每页最大可见选项数 (项) */
-    readonly visibleOptionCount: 7;
-    /** 底部状态通知停留时长 (ms) */
-    readonly statusDurationMs: 3000;
-};
-/** Nerd Font 状态与操作语义图标字典（按语义分区排列；四个选择指示符自带 1 空格尾随填充以拉开与标签的间距） */
-export declare const ICONS: {
-    /** 取消 / 中止 */
-    readonly cancel: "󰜺";
-    /** 完成与确认（结果卡片与总览页完成态） */
-    readonly check: "󰄬";
-    /** 题目已完成 */
-    readonly checked: "󰐾";
-    /** 题目未完成 */
-    readonly unchecked: "󰄰";
-    /** 失败 */
-    readonly error: "󰅚";
-    /** 补充说明 */
-    readonly note: "󰷬";
-    /** 菜单行首聚焦指示 */
-    readonly cursor: "";
-    /** 列表与总览页向上方向提示 */
-    readonly scrollUp: "";
-    /** 列表与总览页向下方向提示 */
-    readonly scrollDown: "";
-    /** 多选已勾选（方括号复选框样式） */
-    readonly checkedMulti: "[󰄬] ";
-    /** 多选未勾选（方括号复选框样式） */
-    readonly uncheckedMulti: "[ ] ";
-    /** 单选已选中（圆括号圆钮样式） */
-    readonly checkedSingle: "(•) ";
-    /** 单选未选中（圆括号圆钮样式） */
-    readonly uncheckedSingle: "( ) ";
-};
-/** 单题最大选项数上限（项；同时约束 `schema.ts` 的 `options.maxItems`（批量与平铺两处）与 `sanitize.ts` 的选项截断） */
-export declare const MAX_OPTIONS = 30;
-/** 单份问卷最大题目数上限（题；同时约束 `schema.ts` 的 `questions.maxItems` 与 `sanitize.ts` 的题目截断） */
-export declare const MAX_QUESTIONS = 20;
 /**
- * 语义哨兵前缀：不可见 NUL 控制字符，仅存在于 transform 产出与 `theme.code` 消费之间的中间态
- * 约定：输入侧已在 `format.ts` 边界剥离，分类时立即剥离，绝不进入终端输出
+ * 渲染多选模式标签（形如 `[多选 可不选 至多3项]` / `[Multi, optional, up to 3]`）
+ * @param min - 模型收敛后的最小勾选数（区间 `0 ~ optionCount`）
+ * @param max - 模型收敛后的最大勾选数（区间 `min ~ optionCount`）
+ * @param optionCount - 本题候选选项数
+ * @param allowEmpty - 是否允许零勾选提交
+ * @returns `min > 1` 时标注强制下限；`min === 0` 或 `allowEmpty` 时标注可不选；`max` 小于选项总数时追加上限标注，等于总数则视为无额外上限而省略
+ */
+declare const modeMultiLabel: (min: number, max: number, optionCount: number, allowEmpty: boolean) => string;
+/**
+ * 渲染多选确认按钮的已选计数明细
+ * @param selectedCount - 已选数
+ * @param minSelect - 本题下限
+ * @returns 未达下限时呈现为 `已选 n/min 项`，否则呈现为 `已选 n 项`
+ */
+declare const confirmDetailMulti: (selectedCount: number, minSelect: number) => string;
+/**
+ * 渲染确认本题按钮标签
+ * @param detail - 已选计数明细（取自 `confirmDetailMulti`）
+ * @param hasNote - 是否已填写题目补充说明
+ * @returns 形如 `󰄬 确认本题 (已选 2 项 + 补充说明)`
  */
-export declare const NOVEL_MARKER_PREFIX = "\0";
-/** 小说语法模板的字段规范（定界符 → 语义哨兵 → 原生 Markdown 载体 → 主题样式） */
-export interface NovelSyntaxTemplate {
-    /** 开始定界符 */
-    readonly opener: string;
-    /** 结束定界符 */
-    readonly closer: string;
-    /** 语义哨兵字符（紧随 {@link NOVEL_MARKER_PREFIX} 之后，`theme.code` 分类依据；`d` = dialogue、`m` = monologue） */
-    readonly marker: string;
-    /** 单个语义跨距最大字符数（含定界符；超出视为残缺定界符并放弃高亮） */
-    readonly maxSpanLength: number;
-    /**
-     * 依据当前主题绘制语义文本
-     * @param theme - 当前 TUI 主题实例（类型定义于叶层 `theme.ts`）
-     * @param text - 已剥离哨兵的语义原文（含定界符）
-     * @returns 应用语义样式后的富文本
-     */
-    readonly paint: (theme: Theme, text: string) => string;
-}
-/** 开定界符 → 语法模板 的 `O(1)` 索引（同开定界符按声明顺序后者覆盖前者） */
-export declare const NOVEL_TEMPLATE_BY_OPENER: ReadonlyMap<string, NovelSyntaxTemplate>;
-/** 语义哨兵字符 → 语法模板 的 `O(1)` 索引（`theme.code` 分类依据） */
-export declare const NOVEL_TEMPLATE_BY_MARKER: ReadonlyMap<string, NovelSyntaxTemplate>;
-/** 全局双向文案字典：统一定义面向大模型 (LLM) 的提示词规范与面向用户 (TUI) 的界面文案 */
+declare const confirmLabel: (detail: string, hasNote: boolean) => string;
+/** 全局双向文案字典：LLM 面固定英文协议常量，作者面取自当前系统语言对应的语言文件 */
 export declare const TEXTS: {
-    /** 工具注册元数据：`name` / `description` / `promptSnippet` / `promptGuidelines` 面向 LLM（英文高信噪比），`label` 面向作者（TUI 工具行中文名） */
+    /** 工具注册元数据：`name` / `description` / `promptSnippet` / `promptGuidelines` 面向 LLM（英文高信噪比），`label` 面向作者（TUI 工具行标题） */
     readonly tool: {
-        /** 工具调用名（LLM 协议标识，注册为 `ask_author`；不出现在作者界面） */
         readonly name: "ask_author";
-        /** 工具展示名（作者端中文，经 `index.ts` 渲染为会话调用卡片标题） */
-        readonly label: "向作者请示";
-        /** 工具说明（LLM 端英文；业务能力概要与调用场景） */
-        readonly description: "Consult the author on novel creative decisions, plot branches, scene drafting, or story settings. Supports single and batched questions with plot deductions and draft previews.";
-        /** `Available tools` 区块单行条目（LLM 端英文；动词引导，无句末标点，缺省则工具不进入该区块） */
-        readonly promptSnippet: "Consult author on novel creative decisions, plot branches, scene drafting, or story settings";
-        /**
-         * `Guidelines` 区块附加条目（LLM 端英文；分类标签前缀 + 行为要求）
-         * 约定：宿主把条目扁平追加进 `Guidelines` 且不加工具名前缀，故每条首词必须显式点名 `ask_author`
-         */
-        readonly promptGuidelines: readonly ["Invoke ask_author DIRECTLY without conversational preambles or greetings whenever author confirmation is needed for plot, characters, scenes, branches, or settings.", "ask_author modes: Always provide a concise formTitle. Use flat mode (formTitle + question + options) for single decisions, or the questions array for batch consultations. Batch interrelated decisions into one ask_author call; never make consecutive single-question calls.", "ask_author payload minimization: Strictly omit optional fields (id, description, minSelect, maxSelect, allowEmpty, allowCustom, customPlaceholder) when using default behavior. Never output auto-generated IDs or default boolean flags.", "ask_author option quality: Provide clear, descriptive labels summarizing the core action (never generic placeholders like 'Option A'). Include cause-and-effect plot deductions in description, and draft excerpts or dialogue in preview when helpful.", "ask_author multi-select & notes: Set multiSelect: true only when choices are not mutually exclusive. The author can always submit free-form notes alongside choices (both per-question and per-option).", "ask_author draft directives: Confirmed draft previews are automatically condensed into single-line directives in the ask_author result to guide subsequent story drafting.", "ask_author envelopes: [Author Decision Cancelled] means do not proceed with the discarded decision; [Author Consultation Error] means fix the arguments and retry once, then continue without the confirmation if it fails again."];
+        readonly description: "Ask the author to choose between concrete narrative directions. Supports one question or a batch of related questions, with options, optional Markdown draft previews, author notes, and conditional follow-ups based on earlier answers.";
+        readonly promptSnippet: "Ask the author to choose narrative directions with options, draft previews, and conditional follow-ups";
+        readonly promptGuidelines: readonly ["ask_author: Call it directly when the author must choose a plot branch, character action, scene direction, or setting; do not ask the same question in chat first.", "ask_author: Use flat mode (formTitle + question + options) for one decision, or the questions array for related decisions. Batch related choices into one call instead of consecutive calls, always give a concise formTitle, and add tabLabel when a long question title needs a short tab name.", "ask_author: Label options with concrete actions and put consequences in description. Add preview only when a Markdown draft or storyboard helps the author judge.", "ask_author: Omit optional fields that use defaults. Add a question id only when a later showIf references it, and point showIf at an earlier question id plus one of its option labels, or answered.", "ask_author: The author may choose multiple options, add notes, and edit drafts. Confirmed drafts return as [Draft directive: ...] lines.", "ask_author: [Author Decision Cancelled] means drop the decision. [Author Consultation Error] means fix the arguments and retry once, then continue without the confirmation."];
+        readonly label: string;
     };
-    /** LLM 端 TypeBox 字段描述字典（单句浓缩英文，仅声明语义、必要性与省略规则；数量约束来自 {@link MAX_OPTIONS} / {@link MAX_QUESTIONS} 插值） */
+    /** LLM 端 TypeBox 字段描述字典 */
     readonly schema: {
-        /** 选项标签（必须填写；要求简明动作导向，禁止占位式命名） */
-        readonly optionLabel: "Concise, descriptive label summarizing the action or choice";
-        /** 选项情节推演（可选；作者端渲染为「情节设定推演」预览面板） */
-        readonly optionDesc: "Plot consequences, rationale, or deduction (optional)";
-        /** 选项草稿预览（可选；作者端渲染为「正文草稿/分镜头试撰写」预览面板） */
-        readonly optionPreview: "Draft prose excerpt or scene storyboard preview (optional, Markdown)";
-        /** 选项批注占位符（可选；作者端作为选项补充说明编辑器的输入框占位文本） */
-        readonly optionCustomPlaceholder: "Placeholder text for option note input (optional)";
-        /** 题目 ID（可选；供批量模式与返回封套稳定引用） */
-        readonly questionId: "Question identifier (optional, omit unless needed)";
-        /** 题目标题（必须填写；作者端呈现为 Tab 标签与题头） */
-        readonly questionTitle: "Question title (e.g., 'Choose the next route')";
-        /** 题目背景说明（可选；作者端呈现为题头下方的上下文行） */
-        readonly questionDesc: "Context or background for this question (optional)";
-        /** 多选开关（可选；默认 false，开启后作者端展示多选模式标签与方框勾选指示符） */
+        readonly optionLabel: "Concrete action or choice label";
+        readonly optionDesc: "Consequences or rationale (optional)";
+        readonly optionPreview: "Markdown draft or storyboard excerpt (optional)";
+        readonly optionCustomPlaceholder: "Placeholder for the option note (optional)";
+        readonly optionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
+        readonly questionId: "Stable id for showIf references (optional)";
+        readonly questionTitle: "Question text";
+        readonly questionTabLabel: "Short label for the tab bar (default: Q<index>)";
+        readonly questionDesc: "Context for the question (optional)";
         readonly questionMultiSelect: "Allow multiple selections (default false)";
-        /** 最小勾选数（可选；默认 1，仅多选生效，作者端据此标注强制下限） */
-        readonly questionMinSelect: "Minimum selections required (default 1)";
-        /** 最大勾选数（可选；默认全部选项，仅多选生效，小于选项总数时作者端追加上限标注） */
-        readonly questionMaxSelect: "Maximum selections allowed (default: all options)";
-        /** 零勾选提交开关（可选；默认 false，仅多选生效，开启后作者端标注可不选） */
-        readonly questionAllowEmpty: "Allow submitting with zero selections (default false)";
-        /** 候选选项列表（必须填写；1~{@link MAX_OPTIONS} 项；建议 2~10 项） */
+        readonly questionMinSelect: "Minimum selections (default 1)";
+        readonly questionMaxSelect: "Maximum selections (default: all options)";
+        readonly questionAllowEmpty: "Allow submitting with no selection (default false)";
         readonly questionOptions: "Candidate options (1-30, 2-10 recommended)";
-        /** 自由批注开关（可选；默认 true，开启后作者端可额外提交非选项文本） */
-        readonly questionAllowCustom: "Allow author free-form custom notes (default true)";
-        /** 作者批注占位符（可选；作者端作为题目补充说明编辑器的输入框占位文本） */
-        readonly questionCustomPlaceholder: "Placeholder text for author note input (optional)";
-        /** 问卷标题（必须填写；作者端呈现为卡片标题与总览页标题） */
-        readonly formTitle: "Concise title describing the overall consultation task";
-        /** 问卷背景（可选；作者端呈现为问卷级上下文） */
-        readonly formDesc: "Overall context or background for the consultation (optional)";
-        /** 批量模式题目数组（可选；1~{@link MAX_QUESTIONS} 题；与平铺单题模式互斥） */
-        readonly formQuestions: "Batched related questions (1-20); batch interrelated decisions into one call instead of consecutive single-question calls";
-        /** 平铺模式的题目标题（可选；与批量模式的 `questionTitle` 同义） */
-        readonly formSingleQuestion: "Question title for flat single-question mode";
-        /** 平铺单题模式字段描述的统一区分前缀（LLM 端英文，`schema.ts` 逐字段拼接） */
+        readonly questionAllowCustom: "Allow author notes (default true)";
+        readonly questionCustomPlaceholder: "Placeholder for the author note (optional)";
+        readonly questionShowIf: "Show only when an earlier answer matches (condition or array; all must hold)";
+        readonly conditionQuestionId: "Id of an earlier question";
+        readonly conditionOption: "Option label that activates the condition";
+        readonly conditionAnswered: "Match any answer (default true) or no answer (false); ignored with option";
+        readonly formTitle: "Short title for the consultation";
+        readonly formDesc: "Overall context (optional)";
+        readonly formQuestions: "Related questions (1-20); batch related decisions into one call";
+        readonly formSingleQuestion: "Question for flat mode";
         readonly flatPrefix: "(Flat single-question mode only) ";
-        /** 平铺模式候选选项列表（可选；1~{@link MAX_OPTIONS} 项；建议 2~10 项） */
-        readonly flatQuestionOptions: "Candidate options for flat single-question mode (1-30, 2-10 recommended)";
+        readonly flatQuestionOptions: "Options for flat mode (1-30, 2-10 recommended)";
     };
-    /**
-     * LLM 端返回封套与纠正指令模板（全英文确定性结构，提升 Prompt Cache 命中率）
-     *
-     * 约定：首行方括号封套令牌 `[Author Decision Finalized]` / `[Author Decision Cancelled]` / `[Author Consultation Error]`；行内令牌 `[Author note: …]` / `[Draft directive: …]`；选项标签定界符 `【】`
-     * 语言归属：`【】` 是本区段唯一的非英文片段，`model.ts` 的 `sanitizeEnvelopeText` 剥离作者文本中的 `【】` 并把 ASCII `;` 归一为全角 `；`，插值文本无法击穿上述定界符
-     */
+    /** LLM 端返回封套与纠正指令模板 */
     readonly markdown: {
-        /** 完成封套首行标识（固定英文令牌，恒为返回正文第一行） */
         readonly envelopePrefix: "[Author Decision Finalized]";
-        /** 完成封套收尾指令（固定英文单行，驱动下游正文写作与大纲更新） */
-        readonly envelopeSuffix: "Execute workflow and writing strictly according to the author decisions and draft directives above without conversational acknowledgments.";
-        /** 取消封套（固定两行：标识行 + 禁止沿用被丢弃决策的英文处置指令） */
-        readonly envelopeCancelled: "[Author Decision Cancelled]\nThe author cancelled the consultation. Do not proceed with the discarded decision; propose next steps or ask for clarification in chat.";
-        /**
-         * 构建错误封套（固定三行：标识行 + 原因行 + 指引行）
-         * @param reason - 面向 LLM 的英文失败原因（取自 `errorReasons`）
-         * @param guidance - 面向 LLM 的英文纠正指引（取自 `errorGuidances`）
-         */
+        readonly envelopeSuffix: "Proceed with the author decisions and draft directives above without conversational acknowledgment.";
+        readonly envelopeCancelled: "[Author Decision Cancelled]\nThe author cancelled. Do not proceed with the discarded decision; propose next steps or ask for clarification.";
         readonly envelopeError: (reason: string, guidance: string) => string;
-        /** 错误封套原因行字典（英文单句，按失败路径枚举） */
         readonly errorReasons: {
-            /** 非交互式终端环境无法启动 TUI（对应作者端 {@link TEXTS.status.errorNonTui}） */
-            readonly nonTui: "Interactive TUI is unavailable in the current execution mode.";
-            /** 入参无有效题目或选项（对应作者端 {@link TEXTS.status.errorNoQuestions}） */
-            readonly noQuestions: "No valid questions or options were provided in arguments.";
-            /** 构建执行期异常的原因行（`details` 为宿主异常摘要，对应作者端 {@link TEXTS.status.errorExecutionFailed}） */
+            readonly nonTui: "Interactive TUI is unavailable in the current mode.";
+            readonly noQuestions: "No questions or options were provided.";
             readonly runtimeError: (details: string) => string;
+            readonly invalidCondition: (details: string) => string;
         };
-        /** 错误封套纠正指引行字典（英文单句，与 `errorReasons` 一一对应） */
         readonly errorGuidances: {
-            /** `nonTui` 的纠正指引 */
-            readonly nonTui: "Proceed using defaults or ask user via standard chat/message if crucial.";
-            /** `noQuestions` 的纠正指引 */
+            readonly nonTui: "Use defaults, or ask the user in chat if the decision is crucial.";
             readonly noQuestions: "Provide at least one question with concrete options.";
-            /** `runtimeError` 的纠正指引 */
-            readonly runtimeError: "Check arguments format and retry with valid questions and options.";
+            readonly runtimeError: "Check the arguments and retry with valid questions and options.";
+            readonly invalidCondition: "Reference an earlier question id plus one of its option labels, or use answered.";
+        };
+        readonly adaptiveErrors: {
+            readonly unknownQuestion: (questionId: string) => string;
+            readonly forwardQuestion: (questionId: string) => string;
+            readonly unknownOption: (questionId: string, option: string) => string;
         };
-        /** 空答卷封套正文（作者未作答时的英文处置指令，位于首尾标识之间） */
-        readonly envelopeEmpty: "Author submitted the form without any answers. Proceed with your defaults, or ask a follow-up question in chat if the decision is crucial.";
-        /** 单题无任何作答（未勾选且无批注）时的英文占位正文 */
-        readonly noSelection: "(No selection; author skipped this question)";
-        /** 行内批注令牌左定界符（尾随 1 空格，与 `noteSuffix` 成对） */
+        readonly envelopeEmpty: "The author submitted no answers. Use your defaults, or ask a follow-up if the decision is crucial.";
+        readonly noSelection: "(No selection; the author skipped this question)";
         readonly notePrefix: "[Author note: ";
-        /** 行内批注令牌右定界符 */
         readonly noteSuffix: "]";
-        /** 分镜头草稿指令令牌左定界符（尾随 1 空格，与 `draftDirectiveSuffix` 成对） */
         readonly draftDirectivePrefix: "[Draft directive: ";
-        /** 分镜头草稿指令令牌右定界符 */
         readonly draftDirectiveSuffix: "]";
-        /** 构建封套单题作答行（`index` 为 1-based 题号，`title` 为题目标题，`body` 为单行正文） */
         readonly answerLine: (index: number, title: string, body: string) => string;
-        /** 同一作答行内多个片段（选项推演 / 批注令牌 / 草稿指令）的分隔符（纯 ASCII；作者文本中的 `;` 已在 `sanitizeEnvelopeText` 归一为全角 `；` 消除歧义） */
         readonly partSeparator: "; ";
-        /** 正文草稿 / 分镜头草稿压缩为单行指令时的分镜头片段分隔符（LLM 端纯 ASCII） */
         readonly draftSegmentSeparator: " / ";
-        /**
-         * 构建带情节推演的选项片段：`【标签】推演 [Author note: …] [Draft directive: …]`
-         * @param label - 选项标签原文（调用方已过 `sanitizeEnvelopeText`）
-         * @param desc - 选项情节推演 / 设定阐述（调用方已过 `sanitizeEnvelopeText`）
-         * @param draftDirective - 已包装的 `[Draft directive: …]` 令牌（可选，非原文）
-         * @param note - 已包装的 `[Author note: …]` 令牌（可选，非原文）
-         * @returns 输出顺序恒为「标签 → 推演 → 批注 → 草稿指令」，与形参顺序不同处在于批注先于草稿
-         */
         readonly optionWithDesc: (label: string, desc: string, draftDirective?: string, note?: string) => string;
-        /**
-         * 构建无情节推演的选项片段：`【标签】[Author note: …] [Draft directive: …]`
-         * @param label - 选项标签原文（调用方已过 `sanitizeEnvelopeText`）
-         * @param draftDirective - 已包装的 `[Draft directive: …]` 令牌（可选，非原文）
-         * @param note - 已包装的 `[Author note: …]` 令牌（可选，非原文）
-         * @returns 输出顺序恒为「标签 → 批注 → 草稿指令」，与形参顺序不同处在于批注先于草稿
-         */
         readonly optionWithoutDesc: (label: string, draftDirective?: string, note?: string) => string;
-        /**
-         * 构建未选中选项上的孤立批注片段（英文前缀 + 标签 + 批注令牌）
-         * @param label - 选项标签原文（调用方已过 `sanitizeEnvelopeText`）
-         * @param note - 已包装的 `[Author note: …]` 令牌（非原文）
-         */
         readonly unselectedOptionNote: (label: string, note: string) => string;
-        /** 生成题目标题的英文占位（`index` 为 1-based 题号；仅封套编译期替换 `fallbacks.autoQuestionTitle` 与 `fallbacks.defaultQuestionTitle`，作者界面保留中文占位） */
         readonly fallbackQuestionTitle: (index: number) => string;
-        /** 生成选项标签的英文占位（`index` 为 1-based 选项序号；仅封套编译期替换 `fallbacks.autoOptionLabel` / `fallbacks.unnamedOptionLabel` / `fallbacks.defaultOptionLabel`，作者界面保留中文占位） */
         readonly fallbackOptionLabel: (index: number) => string;
     };
     /** `/ask-author` 辅助命令的注册元数据与作者可见提示文案 */
     readonly command: {
-        /** 命令名（注册为 `ask-author`，作者输入 `/ask-author` 触发） */
-        readonly name: "ask-author";
-        /** 命令说明（命令面板与补全列表展示） */
-        readonly description: "查看 ask_author 创作请示工具说明";
-        /** 命令执行后的提示通知（引导作者改用自然语言指示 AI 调用工具） */
-        readonly notify: "在提示词中指示 AI 调用 ask_author，即可向您请示创作决策";
+        readonly name: string;
+        readonly description: string;
+        readonly notify: string;
     };
     /** 跨视图共享的通用排版片段（枚举分隔符、列表条目前缀与按键帮助分隔符） */
     readonly common: {
-        /** 选项标签并列展示时的中文枚举分隔符（总览页与结果卡片共用） */
-        readonly optionSeparator: "、";
-        /** 列表条目统一前缀（作者端圆点标记；卡片行与预览面板提示行的唯一字面量来源） */
-        readonly bulletPrefix: "• ";
-        /** 底部按键帮助行各片段之间的分隔符 */
-        readonly helpSeparator: " • ";
+        readonly optionSeparator: string;
+        readonly bulletPrefix: string;
+        readonly helpSeparator: string;
     };
     /** Tab 导航栏标签文案（各题目页与答卷提交页） */
     readonly tabs: {
-        /** 渲染题目页标签（`index` 为 1-based 题号） */
-        readonly questionTab: (index: number) => string;
-        /** 答卷提交页标签（末尾固定页，前面附带完成徽标） */
-        readonly submitTab: "󰄬 提交答卷";
+        readonly questionTab: (...args: Array<string | number>) => string;
+        readonly submitTab: string;
     };
-    /** 作答视图与预览面板的结构化文案（题目标签、补充横幅、滚动信息与 Markdown 区块构建器，按界面渲染顺序排列） */
+    /** 作答视图与预览面板的结构化文案（`modeMulti` 由多选模式片段组合而成） */
     readonly view: {
-        /** 单选模式标签 */
-        readonly modeSingle: "[单选]";
-        /**
-         * 按勾选数量上下限渲染多选模式标签（形如 `[多选 可不选 至多3项]`）
-         * @param min - 模型收敛后的最小勾选数（区间 `0 ~ optionCount`）
-         * @param max - 模型收敛后的最大勾选数（区间 `min ~ optionCount`）
-         * @param optionCount - 本题候选选项数
-         * @param allowEmpty - 是否允许零勾选提交
-         * @returns `min > 1` 时标注强制下限；`min === 0` 或 `allowEmpty` 时标注可不选；`max` 小于选项总数时追加上限标注，等于总数则视为无额外上限而省略
-         */
-        readonly modeMulti: (min: number, max: number, optionCount: number, allowEmpty: boolean) => string;
-        /** 渲染题目级补充说明横幅（`text` 为补充说明原文，位于题头下方） */
-        readonly attachedNoteBanner: (text: string) => string;
-        /** 渲染选项级补充说明横幅（`label` 为选项标签，位于对应选项行下方） */
-        readonly optionAttachedNoteBanner: (label: string, text: string) => string;
-        /** 渲染列表上方剩余项数提示（`count` 为剩余项数） */
-        readonly listTopMore: (count: number) => string;
-        /** 渲染列表下方剩余项数提示（`count` 为剩余项数） */
-        readonly listBottomMore: (count: number) => string;
-        /** 选项补充说明面板标题 */
-        readonly optionNotePanelTitle: "选项补充说明";
-        /** 选项情节推演面板标题 */
-        readonly storyDescriptionPanelTitle: "情节设定推演";
-        /** 选项正文草稿 / 分镜头面板标题 */
-        readonly storyDraftPanelTitle: "正文草稿/分镜头试撰写";
-        /** 题目补充说明面板标题 */
-        readonly customNotePanelTitle: "题目补充说明";
-        /** 确认入口的按键说明面板标题 */
-        readonly confirmPanelTitle: "操作说明";
-        /** 已填写的题目补充说明字段标签（下方接说明原文） */
-        readonly customNotePanelCurrent: "当前填写内容：";
-        /** 渲染草稿预览的行区间与滚动提示（`start` / `end` / `total` 均为 1-based 行号与总行数） */
-        readonly previewScrollInfo: (start: number, end: number, total: number) => string;
-        /** 草稿预览缺省占位（无内容可预览时） */
-        readonly previewNoDraft: "(无内容预览)";
-        /** 题目补充说明面板的按键提示行集合 */
-        readonly customNotePanelTips: readonly ["• 随时按「N」或选择此项按「Enter」填写/修改本题补充说明", "• 按「x」清空本题补充说明", "• 补充说明将随所选选项及选项专属补充说明一并提交给 AI 助手"];
-        /** 确认面板的按键提示行集合 */
-        readonly confirmPanelTips: readonly ["• 按 `Enter` 确认本题并前往下一题", "• 最后一题确认后自动进入总览提交页"];
-        /** 构建预览面板 Markdown 三级小节标题（`title` 为小节标题原文） */
-        readonly sectionTitle: (title: string) => string;
-        /** 构建预览面板 Markdown bold 字段标签（`label` 为字段标签原文） */
-        readonly fieldLabel: (label: string) => string;
-        /** 构建预览面板 Markdown 斜体提示行（`text` 为提示行原文） */
-        readonly italicLine: (text: string) => string;
+        readonly modeSingle: string;
+        readonly conditionalBadge: string;
+        readonly modeMultiAtLeast: (...args: Array<string | number>) => string;
+        readonly modeMultiOptional: (...args: Array<string | number>) => string;
+        readonly modeMultiUnconstrained: (...args: Array<string | number>) => string;
+        readonly modeMultiMaxPart: (...args: Array<string | number>) => string;
+        readonly attachedNoteBanner: (...args: Array<string | number>) => string;
+        readonly optionAttachedNoteBanner: (...args: Array<string | number>) => string;
+        readonly listTopMore: (...args: Array<string | number>) => string;
+        readonly listBottomMore: (...args: Array<string | number>) => string;
+        readonly optionNotePanelTitle: string;
+        readonly storyDescriptionPanelTitle: string;
+        readonly storyDraftPanelTitle: string;
+        readonly customNotePanelTitle: string;
+        readonly confirmPanelTitle: string;
+        readonly customNotePanelCurrent: string;
+        readonly previewScrollInfo: (...args: Array<string | number>) => string;
+        readonly previewNoDraft: string;
+        readonly customNotePanelTips: readonly string[];
+        readonly confirmPanelTips: readonly string[];
+        readonly sectionTitle: (...args: Array<string | number>) => string;
+        readonly fieldLabel: (...args: Array<string | number>) => string;
+        readonly italicLine: (...args: Array<string | number>) => string;
+        readonly modeMulti: typeof modeMultiLabel;
     };
-    /** 题目菜单条目文案（补充说明入口与确认推进按钮） */
+    /** 题目菜单条目文案（`confirmDetailMulti` / `confirmLabel` 由已选数片段组合而成） */
     readonly menu: {
-        /** 补充说明入口标签（未填写态） */
-        readonly customNoteLabel: "󰷬 题目补充说明";
-        /** 补充说明入口标签（已填写态） */
-        readonly customNoteLabelFilled: "󰷬 题目补充说明 (已填写)";
-        /** 渲染多选确认按钮的已选计数明细（`selectedCount` 为已选数，`minSelect` 为下限；未达下限时呈现为 `已选 n/min`） */
-        readonly confirmDetailMulti: (selectedCount: number, minSelect: number) => string;
-        /** 渲染确认本题按钮标签（`detail` 取自 `confirmDetailMulti`，空串时不显示括号；`hasNote` 为真时追加补充标记） */
-        readonly confirmLabel: (detail: string, hasNote: boolean) => string;
-        /** 确认按钮的下方说明（声明确认后的跳转目标） */
-        readonly confirmDesc: "确认并前往下一题或总览页";
+        readonly customNoteLabel: string;
+        readonly customNoteLabelFilled: string;
+        readonly confirmDetailMultiBelowMin: (...args: Array<string | number>) => string;
+        readonly confirmNoteSuffix: string;
+        readonly confirmDesc: string;
+        readonly confirmDetailMulti: typeof confirmDetailMulti;
+        readonly confirmLabel: typeof confirmLabel;
     };
     /** 全屏补充说明编辑器的标题与页脚按键帮助文案 */
     readonly editor: {
-        /** 渲染题目补充说明编辑器标题（`questionTitle` 为题目标题） */
-        readonly title: (questionTitle: string) => string;
-        /** 渲染选项补充说明编辑器标题（`optionLabel` 为选项标签，`questionTitle` 为题目标题） */
-        readonly optionTitle: (questionTitle: string, optionLabel: string) => string;
-        /** 编辑器页脚按键帮助（保存与取消） */
-        readonly footerHelp: " [Enter] 保存并返回 • [Esc/Ctrl+C] 取消";
+        readonly title: (...args: Array<string | number>) => string;
+        readonly optionTitle: (...args: Array<string | number>) => string;
+        readonly footerHelp: string;
     };
     /** 底部临时状态栏通知（操作结果、阻断原因与阻断后的纠正操作路径） */
     readonly status: {
-        /** 题目补充说明已保存 */
-        readonly questionNoteSaved: "已保存本题补充说明";
-        /** 题目补充说明已清空 */
-        readonly noteCleared: "已清空本题补充说明";
-        /** 提示选项批注已保存（`label` 为选项标签；该选项已勾选） */
-        readonly optionNoteSaved: (label: string) => string;
-        /** 提示选项批注已保存但该选项未勾选（`label` 为选项标签；批注仅作批注提交） */
-        readonly optionNoteSavedUnselected: (label: string) => string;
-        /** 提示已达批注选项数量上限（`max` 为上限值，批注保留但该选项不再勾选） */
-        readonly optionNoteSavedAtLimit: (max: number) => string;
-        /** 提示选项批注已清空（`label` 为选项标签） */
-        readonly optionNoteCleared: (label: string) => string;
-        /** 提示单选已达上限（`limit` 为本题勾选上限；再次勾选被拒） */
-        readonly selectedUpToLimit: (limit: number) => string;
-        /** 提示多选已达上限（`max` 为本题勾选上限；引导取消已选项后重选） */
-        readonly maxSelectExceeded: (max: number) => string;
-        /** 提示多选未达下限（`min` 为本题勾选下限；引导继续勾选或改用补充说明） */
-        readonly minSelectRequired: (min: number) => string;
-        /** 提交时本题仍无任何作答：并列给出两条通过路径 */
-        readonly pleaseAnswerBeforeSubmit: "本题未完成：请按「空格/Enter」选定选项，或按「n/N」填写补充说明";
-        /** 编辑器放弃修改的二次确认（首次 Esc/Ctrl+C 触发） */
-        readonly editorDiscardConfirm: "再次按 Esc/Ctrl+C 放弃修改（未保存内容将丢失），继续输入可撤销";
-        /** 非交互式终端环境无法启动交互界面（与 `markdown.errorReasons.nonTui` 对应） */
-        readonly errorNonTui: "当前为非交互式终端环境，无法启动交互界面，请在交互式 TUI 会话中重试";
-        /** 入参无有效题目或选项（与 `markdown.errorReasons.noQuestions` 对应） */
-        readonly errorNoQuestions: "未提供有效的问题或选项，请提供至少一个带选项的问题";
-        /** 生成组件执行期异常通知（`reason` 为宿主异常摘要，与 `markdown.errorReasons.runtimeError` 对应） */
-        readonly errorExecutionFailed: (reason: string) => string;
+        readonly questionNoteSaved: string;
+        readonly noteCleared: string;
+        readonly optionNoteSaved: (...args: Array<string | number>) => string;
+        readonly optionNoteSavedUnselected: (...args: Array<string | number>) => string;
+        readonly optionNoteSavedAtLimit: (...args: Array<string | number>) => string;
+        readonly optionNoteCleared: (...args: Array<string | number>) => string;
+        readonly selectedUpToLimit: (...args: Array<string | number>) => string;
+        readonly maxSelectExceeded: (...args: Array<string | number>) => string;
+        readonly minSelectRequired: (...args: Array<string | number>) => string;
+        readonly pleaseAnswerBeforeSubmit: string;
+        readonly editorDiscardConfirm: string;
+        readonly errorNonTui: string;
+        readonly errorNoQuestions: string;
+        readonly errorInvalidCondition: (...args: Array<string | number>) => string;
+        readonly errorExecutionFailed: (...args: Array<string | number>) => string;
     };
-    /** 底部按键帮助行片段（标准键名 + 动宾结构，经 {@link TEXTS.common.helpSeparator} 拼接；条目按按键字母序排列） */
+    /** 底部按键帮助行片段（经 `common.helpSeparator` 拼接；条目按按键字母序排列） */
     readonly help: {
-        /** Esc / Ctrl+C：取消并关闭当前界面 */
-        readonly cancel: "Esc/Ctrl+C 取消";
-        /** x：清空光标所在位置的补充说明 */
-        readonly clearNote: "x 清空补充说明";
-        /** Enter：多选模式下确认本题并推进 */
-        readonly confirmQuestion: "Enter 确认";
-        /** Enter：总览页提交整份答卷 */
-        readonly confirmSubmit: "Enter 提交";
-        /** n：编辑题目补充说明（光标位于题目补充说明菜单项时） */
-        readonly editNote: "n 补充说明";
-        /** n：编辑当前选项的专属批注（光标位于选项行时） */
-        readonly editOptionNote: "n 选项补充说明";
-        /** N：直接编辑题目补充说明（光标位于选项行时的大写入口） */
-        readonly editQuestionNote: "N 题目补充说明";
-        /** 1~9：按题号直接跳转题目（题目数大于 1 时展示） */
-        readonly jumpQuestion: "1~9 跳转题目";
-        /** ↑↓ / jk：上下移动光标 */
-        readonly moveCursor: "↑↓/jk 移动";
-        /** PgUp / PgDn：作答页滚动草稿预览（存在预览内容时展示） */
-        readonly scrollDraft: "PgUp/PgDn 滚动草稿";
-        /** ↑↓ / PgUp / PgDn：总览页滚动内容 */
-        readonly scrollSummary: "↑↓/PgUp/PgDn 滚动";
-        /** 空格 / Enter：单选模式下选定当前项 */
-        readonly selectOptionSingle: "空格/Enter 选定";
-        /** Tab / ←→ / hl：切换题目或总览页 */
-        readonly switchQuestion: "Tab/←→/hl 切换题目";
-        /** a：多选模式下全选或清空 */
-        readonly toggleAll: "a 全选/清空";
-        /** 空格：多选模式下勾选或取消当前项 */
-        readonly toggleCheckMulti: "空格 勾选";
+        readonly cancel: string;
+        readonly clearNote: string;
+        readonly confirmQuestion: string;
+        readonly confirmSubmit: string;
+        readonly editNote: string;
+        readonly editOptionNote: string;
+        readonly editQuestionNote: string;
+        readonly jumpQuestion: string;
+        readonly moveCursor: string;
+        readonly scrollDraft: string;
+        readonly scrollSummary: string;
+        readonly selectOptionSingle: string;
+        readonly switchQuestion: string;
+        readonly toggleAll: string;
+        readonly toggleCheckMulti: string;
     };
-    /** 答卷总览确认页文案（完成状态徽标、已选项标签、选项批注角标与滚动提示，按页面自上而下的渲染顺序排列） */
+    /** 答卷总览确认页文案（完成状态徽标、已选项标签、选项批注角标与滚动提示） */
     readonly summary: {
-        /** 页标题 */
-        readonly title: "【答卷总览与确认】";
-        /** 单题完成徽标 */
-        readonly statusDone: "[已完成]";
-        /** 单题未完成徽标 */
-        readonly statusPending: "[未完成]";
-        /** 渲染题目块标题（`index` 为 1-based 题号，`title` 为题目标题） */
-        readonly questionPrefix: (index: number, title: string) => string;
-        /** 已选选项行标签 */
-        readonly selectedLabel: "已选：";
-        /** 已选选项行尾的批注存在角标 */
-        readonly optionNoteBadge: "(󰷬 批注)";
-        /** 渲染选项级批注行标签（`optLabel` 为所属选项标签） */
-        readonly optionNotePrefix: (optLabel: string) => string;
-        /** 题目级补充说明行标签 */
-        readonly customNoteLabel: "󰷬 题目补充说明：";
-        /** 全部完成时的提交引导行 */
-        readonly allDonePrompt: " 󰄬 全部完成，按 Enter/Ctrl+S 提交答卷，Tab/hl/1-9 返回修改";
-        /** 存在未完成题目时的阻断提示行 */
-        readonly pendingWarning: " 󰄰 尚有题目未完成，按 Enter 前往作答，Tab/hl/1-9 切换修改";
-        /** 渲染总览页上方剩余行数提示（`count` 为剩余行数） */
-        readonly topMore: (count: number) => string;
-        /** 渲染总览页下方剩余行数提示（`count` 为剩余行数） */
-        readonly bottomMore: (count: number) => string;
+        readonly title: string;
+        readonly statusDone: string;
+        readonly statusPending: string;
+        readonly questionPrefix: (...args: Array<string | number>) => string;
+        readonly selectedLabel: string;
+        readonly optionNoteBadge: string;
+        readonly optionNotePrefix: (...args: Array<string | number>) => string;
+        readonly customNoteLabel: string;
+        readonly allDonePrompt: string;
+        readonly pendingWarning: string;
+        readonly topMore: (...args: Array<string | number>) => string;
+        readonly bottomMore: (...args: Array<string | number>) => string;
     };
     /** 会话回放卡片文案（调用态摘要、结果态徽标与展开态明细） */
     readonly card: {
-        /** 渲染调用态多题摘要（`qCount` 为题数，`optCount` 为选项总数；形如 `3 题 • 8 选项`） */
-        readonly callQuestionAndOptionCount: (qCount: number, optCount: number) => string;
-        /** 渲染调用态平铺单题摘要（`optCount` 为选项数；形如 `4 选项`） */
-        readonly callOptionCountOnly: (optCount: number) => string;
-        /** 作者取消（warning 配色） */
-        readonly resultCancelled: "󰜺 已取消";
-        /** 执行失败（error 配色；展开态另附错误原因） */
-        readonly resultErrorShort: "󰅚 执行失败";
-        /** 正常完成（success 配色） */
-        readonly resultCompleted: "󰄬 已完成";
-        /** 渲染结果态已作答题目数（`n` 为题目数；形如 `3 项`，经 `common.bulletPrefix` 拼接） */
-        readonly resultCount: (n: number) => string;
-        /** 渲染展开态单条作答行（`title` 为题目标题，`content` 为明细正文） */
-        readonly optionBullet: (title: string, content: string) => string;
-        /** 渲染带专属批注的选项标签角标（`label` 为选项标签，`note` 为批注原文；形如 `选项 [note 批注]`） */
-        readonly optionWithNote: (label: string, note: string) => string;
-        /** 渲染题目补充说明角标（`text` 为补充说明原文，追加于作答行行尾） */
-        readonly questionNoteTag: (text: string) => string;
-        /** 渲染展开态错误原因行（`err` 为宿主异常摘要） */
-        readonly errorBullet: (err: string) => string;
+        readonly callQuestionAndOptionCount: (...args: Array<string | number>) => string;
+        readonly callOptionCountOnly: (...args: Array<string | number>) => string;
+        readonly resultCancelled: string;
+        readonly resultErrorShort: string;
+        readonly resultCompleted: string;
+        readonly resultCount: (...args: Array<string | number>) => string;
+        readonly optionBullet: (...args: Array<string | number>) => string;
+        readonly optionWithNote: (...args: Array<string | number>) => string;
+        readonly questionNoteTag: (...args: Array<string | number>) => string;
+        readonly errorBullet: (...args: Array<string | number>) => string;
     };
-    /**
-     * 兜底文案与自动命名派生：任一缺失 / 越界输入的最终回退，保证界面与封套永不空白
-     * 语言归属：本组为作者端中文占位，作者界面始终呈现中文
-     * 约定：`model.ts` 在封套编译期把 `autoQuestionTitle` / `defaultQuestionTitle` / `autoOptionLabel` / `unnamedOptionLabel` / `defaultOptionLabel` 替换为 `markdown.fallbackQuestionTitle` / `markdown.fallbackOptionLabel` 的英文占位
-     */
+    /** 兜底文案与自动命名派生：任一缺失 / 越界输入的最终回退，保证界面与封套永不空白 */
     readonly fallbacks: {
-        /** 问卷标题缺省（模型未提供 `formTitle` 时） */
-        readonly defaultFormTitle: "创作决策";
-        /** 题目标题缺省（模型未提供标题时的作者端中文占位，封套编译期替换为英文） */
-        readonly defaultQuestionTitle: "请选择接下来的创作方案";
-        /** 题目补充说明编辑器的缺省占位文本 */
-        readonly defaultCustomPlaceholder: "输入本题整体补充要求、伏笔细节或修改意见...";
-        /** 选项补充说明编辑器的缺省占位文本 */
-        readonly defaultOptionCustomPlaceholder: "输入针对该选项的具体补充要求或修改细节...";
-        /** 自由文本作答的选项名（作者填写自定义内容时占位） */
-        readonly defaultCustomChoiceName: "自定义方案";
-        /** 选项标签缺省（模型未提供标签时的作者端中文占位，封套编译期替换为英文） */
-        readonly defaultOptionLabel: "默认方案";
-        /** 选项标签缺失且无序号信息时的占位（封套编译期替换为英文） */
-        readonly unnamedOptionLabel: "未命名方案";
-        /** 未勾选且无补充说明时的展示占位（总览页与结果卡片共用；封套中由 `markdown.noSelection` 承担同义英文） */
-        readonly unselectedOption: "未选";
-        /** 生成自动题目 ID（`n` 为 1-based 序号） */
-        readonly autoQuestionId: (n: number) => string;
-        /** 生成自动题目标题（`n` 为 1-based 序号，作者端中文占位，封套编译期替换为英文） */
-        readonly autoQuestionTitle: (n: number) => string;
-        /** 生成自动选项标签（`n` 为 1-based 序号，作者端中文占位，封套编译期替换为英文） */
-        readonly autoOptionLabel: (n: number) => string;
+        readonly defaultFormTitle: string;
+        readonly defaultQuestionTitle: string;
+        readonly defaultCustomPlaceholder: string;
+        readonly defaultOptionCustomPlaceholder: string;
+        readonly defaultCustomChoiceName: string;
+        readonly defaultOptionLabel: string;
+        readonly unnamedOptionLabel: string;
+        readonly unselectedOption: string;
+        readonly autoQuestionId: (...args: Array<string | number>) => string;
+        readonly autoQuestionTitle: (...args: Array<string | number>) => string;
+        readonly autoOptionLabel: (...args: Array<string | number>) => string;
     };
 };
+export {};