@sendevia/pi-ask-author 1.0.5 → 1.1.0

package/dist/model.d.ts

@@ -7,17 +7,47 @@
  * - 两层清洗：`sanitize.ts` 边界归一化 + 本层对文本字段幂等兜底（绕过 sanitize 直接构造模型时同样安全）
  * - 封套防止击穿：插值文本经由 `sanitizeEnvelopeText` 归一化，定界符不可被作者文本击穿
  * - 封套语言单一：自动生成的占位题目/标签在封套编译期替换为英文占位（`Question N` / `Option N`），作者界面保留中文占位
- * - 答卷完整性：显式跳过与仅批注提交均产出条目，多选题目恒产出条目，问题不在结果中静默消失
+ * - 答卷完整性：显示中的题目即使显式跳过或仅批注提交也产出条目，多选题目恒产出条目，不存在静默消失的作答
+ * - 自适应显隐：题目与选项可声明 `showIf` 条件且仅允许引用更早题目；显隐快照按 `revision` 缓存，隐藏项的选择不计入作答与答卷
  *
  * 依赖方向：model.ts → format.ts / schema.ts / texts.ts（纯函数工具、Schema 单一类型源与文案字典，无回边）；不引用 `Theme` 与 TUI 组件，渲染细节全部上移组件层
  */
 import type { QuestionOption, RawParams } from "./schema.js";
+/**
+ * 显示条件的归一化形态：引用的题目索引与选项索引均已解析
+ * - `option`：指定题目中某个选项当前处于选中状态
+ * - `answered`：指定题目存在（或不存在）任何作答痕迹
+ */
+export type VisibilityCondition = {
+    readonly kind: "option";
+    readonly questionIndex: number;
+    readonly optionIndex: number;
+} | {
+    readonly kind: "answered";
+    readonly questionIndex: number;
+    readonly answered: boolean;
+};
+/** 归一化后的候选选项（在 Schema 选项字段之外附带显示条件） */
+export interface NormalizedOption {
+    /** 选项标签 */
+    label: string;
+    /** 情节推演 / 设定阐述（可选） */
+    description?: string;
+    /** 正文草稿或分镜头预览（可选） */
+    preview?: string;
+    /** 选项补充说明占位词（可选） */
+    customPlaceholder?: string;
+    /** 该选项的显示条件（空数组表示恒显示） */
+    showIf: VisibilityCondition[];
+}
 /** 归一化后的问题对象（字段已兜底，区间已收敛） */
 export interface NormalizedQuestion {
     /** 题目唯一标识符 */
     id: string;
     /** 题目标题 */
     title: string;
+    /** Tab 栏短标签（可选；缺省时 Tab 栏显示题号） */
+    tabLabel?: string;
     /** 题目背景描述（可选） */
     description?: string;
     /** 是否多选（默认 false，即单选） */
@@ -31,11 +61,21 @@ export interface NormalizedQuestion {
     /** 是否允许 0 勾选提交（默认 false；单选与多选均生效） */
     allowEmpty: boolean;
     /** 归一化后的候选选项列表（至少一项） */
-    options: QuestionOption[];
+    options: NormalizedOption[];
     /** 是否允许自由补充说明（默认 true） */
     allowCustom: boolean;
     /** 补充说明输入框占位提示词 */
     customPlaceholder: string;
+    /** 该题目的显示条件（空数组表示恒显示） */
+    showIf: VisibilityCondition[];
+}
+/** 自适应条件非法（引用未知题目、后置题目或不存在的选项）：携带面向 LLM 的英文诊断消息，由入口层映射为结构化错误结果 */
+export declare class AdaptiveConditionError extends Error {
+    /**
+     * 构造自适应条件异常
+     * @param message - 英文诊断消息（取自 `TEXTS.markdown.adaptiveErrors`）
+     */
+    constructor(message: string);
 }
 /** 单题作答状态（内部数据结构，选项索引 0-based） */
 export interface QuestionAnswerState {
@@ -122,7 +162,7 @@ type NoteSaveResult = "saved" | "cleared" | "savedUnselected" | "savedAtLimit";
 export declare function hasQuestionNote(st: QuestionAnswerState): boolean;
 /**
  * 问卷数据模型：题目归一化、作答状态流转与答卷编译；全部状态突变经本类 mutation 方法完成并自动推进 `revision`，组件层只读
- * 只读访问面：`revision` / `questionCount` / `getQuestion` / `getState` / `getSelectedIndices`（0-based 升序，排序不变量唯一实现）/ `getMenuItems` / `isQuestionAnswered` / `areAllQuestionsAnswered` / `compileAnswers` / `formatAnswers`
+ * 只读访问面：`revision` / `questionCount` / `getQuestion` / `getState` / `getSelectedIndices`（0-based 升序，排序不变量唯一实现）/ `getSelectedIndex` / `isQuestionVisible` / `isOptionVisible` / `getVisibleQuestionIndices` / `hasAnyResponse` / `getMenuItems` / `isQuestionAnswered` / `areAllQuestionsAnswered` / `compileAnswers` / `formatAnswers`
  */
 export declare class AskAuthorFormModel {
     /** 问卷总标题 */
@@ -135,6 +175,8 @@ export declare class AskAuthorFormModel {
     private revisionValue;
     /** 各题作答状态映射（题目索引 0-based） */
     private readonly states;
+    /** 显隐快照缓存（按 `revision` 失效；包含题目可见性、选项可见性与可见选中项） */
+    private visibilityCache?;
     /**
      * 构造问卷数据模型实例（单题平铺与批量问卷两模式归一化）
      * @param rawParams - 经 prepareArguments 规整的入参；`questions` 缺省或为空数组时回退单题平铺模式，`options` 亦为空则题目列表为空
@@ -158,31 +200,82 @@ export declare class AskAuthorFormModel {
      */
     getState(index: number): QuestionAnswerState;
     /**
-     * 获取已勾选选项索引（0-based 升序，未作答为空数组；排序不变量唯一实现在此）
+     * 获取当前显隐快照（按 `revision` 缓存，题目顺序一次正向计算）
+     * 条件只允许引用更早题目，故单次正向遍历即可得出全部可见性；被引用题目自身不可见时，引用它的条件恒不成立
+     * @returns 题目可见性、各题选项可见性与各题可见选中项索引（升序）
+     */
+    private snapshot;
+    /**
+     * 判定单个显示条件是否成立
+     * @param condition - 已解析的条件
+     * @param questions - 已完成计算的题目可见性（下标小于当前题）
+     * @param selected - 已完成计算的可见选中项（下标小于当前题）
+     * @returns 被引用题目不可见时为 false；否则按选项选中态或作答存在性判定
+     */
+    private conditionHolds;
+    /**
+     * 判定指定题目是否留下过任何作答痕迹（已选选项或非空批注，不区分选项当前是否可见）
+     * @param qIndex - 题目顺序索引（0-based）
+     * @returns 存在任意痕迹时为 true；状态未创建时为 false
+     */
+    hasAnyResponse(qIndex: number): boolean;
+    /**
+     * 判定指定题目是否可见
+     * @param index - 题目顺序索引（0-based）
+     * @returns 无显示条件或全部条件成立时为 true；索引越界为 false
+     */
+    isQuestionVisible(index: number): boolean;
+    /**
+     * 判定指定选项是否可见
+     * @param qIndex - 题目顺序索引（0-based）
+     * @param optionIndex - 选项索引（0-based）
+     * @returns 无显示条件或全部条件成立时为 true；索引越界为 false
+     */
+    isOptionVisible(qIndex: number, optionIndex: number): boolean;
+    /**
+     * 获取当前可见题目索引
+     * @returns 升序索引数组；第一题无前置题目可引用，因此结果恒非空（题目列表非空时）
+     */
+    getVisibleQuestionIndices(): number[];
+    /**
+     * 获取已勾选且当前可见的选项索引（0-based 升序，未作答为空数组；排序不变量唯一实现在此）
+     * 选项因条件失效而隐藏时，其既有勾选不计入作答与答卷；条件恢复后重新生效
      * @param qIndex - 题目顺序索引（0-based）
      * @returns 全新数组（调用方可安全持有而不影响内部状态）；题目越界或状态未创建时为空数组
      */
     getSelectedIndices(qIndex: number): number[];
+    /**
+     * 获取单选选中项索引（可见选中项为空时 undefined）
+     * @param qIndex - 题目顺序索引（0-based）
+     * @returns 首个可见选中项索引；未选中、选中项已隐藏或索引越界时为 undefined
+     */
+    getSelectedIndex(qIndex: number): number | undefined;
     /** 推进作答状态版本号（全部 mutation 方法的统一出口） */
     private bumpRevision;
     /**
      * 派生指定题目的左侧菜单项列表（预设选项 + 自由补充入口 + 确认推进按钮）
      * 菜单项标签与确认按钮明细随当前作答状态派生：多选展示已选数/下限，单选展示已选项标签、自定义方案名或「未选」
      * @param qIndex - 题目顺序索引（0-based）
-     * @returns 顺序固定的菜单项数组（选项按声明顺序在前、补充入口居中、确认按钮殿后）；题目越界为空数组；`allowCustom` 为 false 时省略补充入口
+     * @returns 顺序固定的菜单项数组（选项按声明顺序在前、补充入口居中、确认按钮殿后）；题目越界为空数组；`allowCustom` 为 false 时省略补充入口；不可见选项不产出条目
      */
     getMenuItems(qIndex: number): MenuItem[];
+    /**
+     * 判定指定题目是否存在会被提交的批注（题目级批注或可见选项上的批注）
+     * @param qIndex - 题目顺序索引（0-based）
+     * @returns 存在非空批注时为 true；状态未创建时为 false
+     */
+    private hasSubmittableNote;
     /**
      * 判定指定题目是否满足作答下限提交要求
      * 单选：已选一项、`allowEmpty`，或 `allowCustom` 开启且存在任意非空批注；多选：勾选数达 `minSelect`、`allowEmpty` 下 0 选，
      * 或缺省下限未勾选（`minSelect` 未显式给出时收敛为 `min(1, 选项数)`，故此时 `count < minSelect` 等价于 `count === 0`）且 `allowCustom` 开启并存在任意非空批注
      * @param qIndex - 题目顺序索引（0-based）
-     * @returns 题目越界恒为 false；作答状态尚未懒加载时按只读空状态（{@link EMPTY_STATE}）判定，不写入任何状态
+     * @returns 题目越界或该题当前不可见时恒为 false；作答状态尚未懒加载时按空作答判定，不写入任何状态
      */
     isQuestionAnswered(qIndex: number): boolean;
     /**
-     * 判定问卷中的全部题目是否均已作答完毕
-     * @returns 每题均满足 {@link isQuestionAnswered} 时为 true；题目列表为空时恒为 true（`every` 的空集语义）
+     * 判定问卷中当前可见的题目是否均已作答完毕（隐藏题目不参与判定）
+     * @returns 所有可见题目均满足 {@link isQuestionAnswered} 时为 true；无可见题目时恒为 true（`every` 的空集语义）
      */
     areAllQuestionsAnswered(): boolean;
     /**
@@ -234,17 +327,18 @@ export declare class AskAuthorFormModel {
      */
     clearQuestionNote(qIndex: number): boolean;
     /**
-     * 收集全部非空选项批注（含未选中选项上的孤立批注），键转换为 1-based；与总览页展示保持一致
+     * 收集全部非空选项批注（含未选中选项上的孤立批注，跳过当前不可见的选项），键转换为 1-based；与总览页展示保持一致
+     * @param qIndex - 题目顺序索引（0-based）
      * @param q - 归一化题目对象
      * @param st - 题目作答状态（可选）
      * @returns 1-based 选项索引 → 批注内容的映射表
      */
     private collectOptionNotes;
     /**
-     * 编译全部作答状态为结果答案条目列表
+     * 编译当前可见题目的作答状态为结果答案条目列表（隐藏题目不产出条目）
      * 产出规则：多选题目恒产出条目（未作答时 `selectedOptions` / `selectedIndices` 为空）；单选题目仅在已作答时才产出条目（已选一项、`allowEmpty` 主动跳过或仅批注提交）
-     * 两种模式均杜绝问题在结果封套中静默消失；0-based 内部索引统一转换为 1-based
-     * @returns 与题目顺序一致的答卷条目列表（未产出的单选题目不占位）；题干无任何作答且非多选时为空数组
+     * 两种模式均杜绝可见题目在结果封套中静默消失；0-based 内部索引统一转换为 1-based
+     * @returns 与题目顺序一致的答卷条目列表（未产出的单选题目不占位）；无已作答题目时为空数组
      */
     compileAnswers(): AuthorAnswerItem[];
     /**

package/dist/novel-markdown.d.ts

@@ -3,7 +3,7 @@
  * @description 小说语法高亮引擎：把语义定界符（`「」` / `（）`）标注为携带哨兵的原生行内代码，折行与配色交还 Pi 原生 Markdown 引擎
  *
  * 核心架构特性：
- * - 声明式语法模板表（`NOVEL_TEMPLATE_*` 派生索引）驱动「定界符 → 语义哨兵 → 行内代码载体 → 主题样式」映射
+ * - 声明式语法模板表（定义于 `novel-syntax.ts` 的 `NOVEL_TEMPLATES` 与派生索引）驱动「定界符 → 语义哨兵 → 行内代码载体 → 主题样式」映射
  * - 对话台词「...」与旁白心理（...）由 `MarkdownOptions.transform` 在 marked 解析前完成标注
  * - `theme.code` 回调兼作哨兵分类器，未命中哨兵即完整交还原生行内代码样式
  * - 折行、嵌套与配色全部由原生 Markdown 引擎回填，插件不触碰任何 ANSI 转义流
@@ -11,7 +11,7 @@
  *
  * 索引约定：全文「扁平索引 / 行内列索引」一律指 UTF-16 码元下标，含义与 `String.prototype.length` / `charAt` / `slice` 一致
  *
- * 依赖方向：novel-markdown.ts → format.ts / texts.ts / theme.ts（另行引入 model.ts 的 `MenuItem` 类型，无回环依赖）；外部依赖 `@earendil-works/pi-tui` 的 `Markdown` / `MarkdownTheme` 与 `@earendil-works/pi-coding-agent` 的 `getMarkdownTheme`
+ * 依赖方向：novel-markdown.ts → format.ts / novel-syntax.ts / texts.ts / theme.ts（另行引入 model.ts 的 `MenuItem` 类型，无回环依赖）；外部依赖 `@earendil-works/pi-tui` 的 `Markdown` / `MarkdownTheme` 与 `@earendil-works/pi-coding-agent` 的 `getMarkdownTheme`
  * 宿主主题耦合：围栏代码块由 `getMarkdownTheme()` 的 `highlightCode` 着色，提取颜色读取宿主全局活动主题（须宿主已 `initTheme`，本模块不自行持有主题）；行内代码仅在未命中哨兵时走同一全局 `code` 提取颜色
  */
 import type { MenuItem } from "./model.js";

package/dist/novel-syntax.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file novel-syntax.ts
+ * @description 小说语法资产：定界符 → 语义哨兵 → 原生 Markdown 载体 → 主题样式的声明式模板表
+ *
+ * 核心架构特性：
+ * - 新增小说语法只需在 `NOVEL_TEMPLATES` 表尾追加一项，两个派生索引自动生成
+ * - 仅依赖 `theme.ts` 的类型别名，不装载语言资源与任何视图模块
+ *
+ * 依赖方向：novel-syntax.ts → theme.ts（仅类型）；被 novel-markdown.ts 消费
+ */
+import type { Theme } from "./theme.js";
+/**
+ * 语义哨兵前缀：不可见 NUL 控制字符，仅存在于 transform 产出与 `theme.code` 消费之间的中间态
+ * 约定：输入侧已在 `format.ts` 边界剥离，分类时立即剥离，绝不进入终端输出
+ */
+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>;

package/dist/schema.d.ts

@@ -10,8 +10,17 @@
  * 依赖方向：schema.ts → typebox / texts.ts（上限常量与字段描述）；被 sanitize / model / index 消费
  */
 import { Type, type Static } from "typebox";
+/** 显示条件参数 Schema：引用更早题目的作答状态，决定本题或本选项是否出现 */
+export declare const ShowIfConditionSchema: Type.TObject<{
+    /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+    questionId: Type.TString;
+    /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+    option: Type.TOptional<Type.TString>;
+    /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+    answered: Type.TOptional<Type.TBoolean>;
+}>;
 /** 单个候选选项的参数 Schema */
-declare const OptionSchema: Type.TObject<{
+export declare const OptionSchema: Type.TObject<{
     /** 选项简短标题/行动标签（必须填写；缺失时经 `sanitize.ts` → `model.ts` 两级兜底为自动占位标签） */
     label: Type.TString;
     /** 情节推演后果或设定阐述（可选） */
@@ -20,13 +29,31 @@ declare const OptionSchema: Type.TObject<{
     preview: Type.TOptional<Type.TString>;
     /** 该选项专属补充说明的占位引导文案（可选） */
     customPlaceholder: Type.TOptional<Type.TString>;
+    /** 该选项的显示条件（可选；不成立时不展示，选中态同样不计入答卷） */
+    showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+        /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+        questionId: Type.TString;
+        /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+        option: Type.TOptional<Type.TString>;
+        /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+        answered: Type.TOptional<Type.TBoolean>;
+    }>, Type.TArray<Type.TObject<{
+        /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+        questionId: Type.TString;
+        /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+        option: Type.TOptional<Type.TString>;
+        /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+        answered: Type.TOptional<Type.TBoolean>;
+    }>>]>>;
 }>;
 /** 单个问题的参数 Schema（批量问卷与平铺模式共用） */
-declare const QuestionSchema: Type.TObject<{
+export declare const QuestionSchema: Type.TObject<{
     /** 题目唯一标识符（可选；缺省由模型层按顺序生成，跨题重复由模型层去重） */
     id: Type.TOptional<Type.TString>;
     /** 题目标题（必须填写；缺失时两级兜底为自动占位标题） */
     title: Type.TString;
+    /** Tab 栏短标签（可选；缺省时 Tab 栏显示题号） */
+    tabLabel: Type.TOptional<Type.TString>;
     /** 题目背景与语境（可选） */
     description: Type.TOptional<Type.TString>;
     /** 是否允许多选（可选；默认 false，即单选） */
@@ -47,11 +74,43 @@ declare const QuestionSchema: Type.TObject<{
         preview: Type.TOptional<Type.TString>;
         /** 该选项专属补充说明的占位引导文案（可选） */
         customPlaceholder: Type.TOptional<Type.TString>;
+        /** 该选项的显示条件（可选；不成立时不展示，选中态同样不计入答卷） */
+        showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>, Type.TArray<Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>>]>>;
     }>>;
     /** 是否允许自由补充说明（可选；默认 true） */
     allowCustom: Type.TOptional<Type.TBoolean>;
     /** 题目整体补充说明的占位引导词（可选） */
     customPlaceholder: Type.TOptional<Type.TString>;
+    /** 该题目的显示条件（可选；不成立时不展示，也不计入答卷） */
+    showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+        /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+        questionId: Type.TString;
+        /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+        option: Type.TOptional<Type.TString>;
+        /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+        answered: Type.TOptional<Type.TBoolean>;
+    }>, Type.TArray<Type.TObject<{
+        /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+        questionId: Type.TString;
+        /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+        option: Type.TOptional<Type.TString>;
+        /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+        answered: Type.TOptional<Type.TBoolean>;
+    }>>]>>;
 }>;
 /** `ask_author` 工具完整参数 Schema（必须填写 `formTitle`；批量问卷传递 `questions`，单题平铺传递顶层 `question` + `options`） */
 export declare const AskAuthorParams: Type.TObject<{
@@ -65,6 +124,8 @@ export declare const AskAuthorParams: Type.TObject<{
         id: Type.TOptional<Type.TString>;
         /** 题目标题（必须填写；缺失时两级兜底为自动占位标题） */
         title: Type.TString;
+        /** Tab 栏短标签（可选；缺省时 Tab 栏显示题号） */
+        tabLabel: Type.TOptional<Type.TString>;
         /** 题目背景与语境（可选） */
         description: Type.TOptional<Type.TString>;
         /** 是否允许多选（可选；默认 false，即单选） */
@@ -85,11 +146,43 @@ export declare const AskAuthorParams: Type.TObject<{
             preview: Type.TOptional<Type.TString>;
             /** 该选项专属补充说明的占位引导文案（可选） */
             customPlaceholder: Type.TOptional<Type.TString>;
+            /** 该选项的显示条件（可选；不成立时不展示，选中态同样不计入答卷） */
+            showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+                /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+                questionId: Type.TString;
+                /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+                option: Type.TOptional<Type.TString>;
+                /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+                answered: Type.TOptional<Type.TBoolean>;
+            }>, Type.TArray<Type.TObject<{
+                /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+                questionId: Type.TString;
+                /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+                option: Type.TOptional<Type.TString>;
+                /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+                answered: Type.TOptional<Type.TBoolean>;
+            }>>]>>;
         }>>;
         /** 是否允许自由补充说明（可选；默认 true） */
         allowCustom: Type.TOptional<Type.TBoolean>;
         /** 题目整体补充说明的占位引导词（可选） */
         customPlaceholder: Type.TOptional<Type.TString>;
+        /** 该题目的显示条件（可选；不成立时不展示，也不计入答卷） */
+        showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>, Type.TArray<Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>>]>>;
     }>>>;
     /** 单题平铺模式题目标题（可选；仅在携带非空 `options` 时参与选题，缺省回退 `TEXTS.fallbacks.defaultQuestionTitle`） */
     question: Type.TOptional<Type.TString>;
@@ -111,6 +204,22 @@ export declare const AskAuthorParams: Type.TObject<{
         preview: Type.TOptional<Type.TString>;
         /** 该选项专属补充说明的占位引导文案（可选） */
         customPlaceholder: Type.TOptional<Type.TString>;
+        /** 该选项的显示条件（可选；不成立时不展示，选中态同样不计入答卷） */
+        showIf: Type.TOptional<Type.TUnion<[Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>, Type.TArray<Type.TObject<{
+            /** 被引用的题目 ID（必须为本次表单中更早出现的题目） */
+            questionId: Type.TString;
+            /** 匹配的选项标签（可选；给出时条件等价于「该选项被选中」） */
+            option: Type.TOptional<Type.TString>;
+            /** 作答存在性（可选；缺省等价于 true，给出 `option` 时忽略） */
+            answered: Type.TOptional<Type.TBoolean>;
+        }>>]>>;
     }>>>;
     /** 单题平铺模式是否允许自由补充说明（可选；默认 true） */
     allowCustom: Type.TOptional<Type.TBoolean>;
@@ -126,4 +235,7 @@ export type RawParams = Static<typeof AskAuthorParams>;
 export type QuestionOption = Static<typeof OptionSchema>;
 /** 单个问题的运行时类型（由 `QuestionSchema` 经 `Static<typeof>` 派生，批量与平铺共用） */
 export type QuestionInput = Static<typeof QuestionSchema>;
-export {};
+/** 单个显示条件的运行时类型（由 `ShowIfConditionSchema` 经 `Static<typeof>` 派生） */
+export type VisibilityConditionInput = Static<typeof ShowIfConditionSchema>;
+/** `showIf` 字段的运行时类型：单个条件或条件数组 */
+export type ShowIfInput = VisibilityConditionInput | VisibilityConditionInput[];