@sim-design/training 1.0.0 → 1.1.0

package/dist-types/client/src/plugins/shared/types.d.ts

@@ -0,0 +1,1247 @@
+import type { ReactNode } from 'react';
+import type { EvidenceSummary, DocumentDiscrepancy, EvaluationRules } from '@shared/types/index.js';
+export type DecisionMode = 'assessment' | 'select';
+/**
+ * 氛围风格类型
+ */
+export type AtmosphereStyle = 'document-review' | 'archive-management' | 'quality-inspection' | 'security-checkpoint' | 'counter-service' | 'smart-recognition';
+export interface JudgementItem {
+    id: string;
+    label: string;
+    category: '真实性' | '完整性' | '一致性' | '合规性' | '适配性' | '风险性';
+    result?: 'pass' | 'warning' | 'fail';
+    comment?: string;
+    evidence?: string[];
+    stepId?: string;
+}
+/**
+ * 单据审核 · 可点击标记的字段（找茬式）
+ */
+export interface ReviewField {
+    name: string;
+    label: string;
+    type: string;
+    value: string;
+    group?: string;
+    hint?: string;
+    colSpan?: number;
+}
+/**
+ * 待审单证（找茬式 - 多单证 Tab）
+ */
+export interface ReviewDocument {
+    documentType: string;
+    docNo?: string;
+    subtitle?: string;
+    fields: ReviewField[];
+}
+/**
+ * 错误类型选项（模型按案例领域生成，标记下拉用）
+ */
+export interface ErrorTypeOption {
+    id: string;
+    label: string;
+    group?: string;
+}
+/**
+ * 单据审核 InitData（下发前端、学员可见）
+ * 参考文档已归位 stepBriefing.referenceDocs，由引擎「实训资料」资料栏统一渲染。
+ */
+export interface DocumentReviewInitData {
+    documents: ReviewDocument[];
+    errorTypes: ErrorTypeOption[];
+}
+/**
+ * 参考不符点（单条参考答案）。
+ * 结构与 shared 的 DocumentDiscrepancy 一致，直接复用以保单一数据源——
+ * per-case 答案键 StepAnswerKey.documentReferenceAnswers 即 DocumentDiscrepancy[]。
+ */
+export type ReferenceDiscrepancy = DocumentDiscrepancy;
+/**
+ * 判分配置
+ */
+export interface ScoringConfig {
+    baseRatio?: number;
+    falseMarkPenalty?: 'half' | number;
+}
+/**
+ * 单据审核 RuntimeRules（下发前端、仅判分用，不进可见层）
+ */
+export interface DocumentReviewRuntimeRules {
+    referenceAnswers: ReferenceDiscrepancy[];
+    scoring?: ScoringConfig;
+}
+export interface DecisionOption {
+    value: string;
+    label: string;
+    score?: number;
+}
+export interface DecisionQuestion {
+    id: string;
+    question: string;
+    options: Array<string | DecisionOption>;
+}
+export interface DecisionSelectOption {
+    id: string;
+    name: string;
+    description?: string;
+    riskLevel?: string;
+    features?: string[];
+    [key: string]: any;
+}
+export interface DecisionMakingInitData {
+    decisionGroups?: any[];
+    decisionMode?: DecisionMode;
+    assessmentQuestions?: DecisionQuestion[];
+    options?: DecisionSelectOption[];
+    customerRiskLevel?: string;
+    previousEvidence?: EvidenceSummary[];
+}
+export interface DecisionMakingCheckRules {
+    businessRules?: string[];
+    mustMatchRiskLevel?: boolean;
+}
+export interface StepEvidenceEntry {
+    stepId: string;
+    summary: EvidenceSummary;
+    rawData?: any;
+    updatedAt: number;
+}
+export interface DecisionEvidenceContext {
+    previousEvidence: EvidenceSummary[];
+}
+/**
+ * 表单字段定义
+ */
+export interface FormField {
+    name: string;
+    label: string;
+    /** 英文副标签（高保真单证双语呈现，可选） */
+    labelEn?: string;
+    type: string;
+    value?: string;
+    required?: boolean;
+    /** 只读预填字段（灰底不可编辑，用于呈现案例预置信息，如投保人信息） */
+    readonly?: boolean;
+    validation?: string;
+    /** 字段填写引导提示（聚焦时在右栏「当前字段引导」展示，静态文本，支持 {路径}） */
+    hint?: string;
+    options?: Array<string | {
+        label: string;
+        value: string;
+    }>;
+    min?: number;
+    max?: number;
+    step?: number;
+    maxLength?: number;
+    group?: string;
+    colSpan?: number;
+    style?: React.CSSProperties;
+}
+/**
+ * 字段分组
+ */
+export interface FieldGroup {
+    key: string;
+    title: string;
+    fields: string[];
+    columns?: number;
+    style?: React.CSSProperties;
+    collapsible?: boolean;
+    defaultExpanded?: boolean;
+    description?: string;
+}
+/**
+ * 单张表单/单证配置（多表单容器的一项）。
+ * 字段语义与现有 formTemplate 一致，额外带标题/编号/副标题（Tab 头与单证抬头用）、
+ * 以及该证独立的分组与预填数据。一个 form-filling 步骤可含多张（Tab 切换）。
+ */
+export interface FormTemplateConfig {
+    /** 表单名，全实训会话内唯一；FormRegistry 按此存模板/已填数据，支持 {表单名.字段} 跨表单引用 */
+    formName: string;
+    /** Tab 标签 / 单证中文抬头（缺省回退 formName），支持 {路径} */
+    title?: string;
+    /** 单证英文抬头（高保真双语），支持 {路径} */
+    titleEn?: string;
+    /** 单证副标题（可选，支持 {路径}） */
+    subtitle?: string;
+    /** 单证编号 badge（可选，支持 {路径}/[表达式]，如 APP-2026-...） */
+    docNo?: string;
+    /** create=本步定义字段；edit=引用前序步骤同名表单字段 */
+    mode?: 'create' | 'edit';
+    /** 本证字段；edit 模式可空，运行时按 formName 从 FormRegistry 回退 */
+    fields: FormField[];
+    /** 本证字段分组（section） */
+    groups?: FieldGroup[];
+    /** 本证预填/只读数据（{路径} 引用案例、{表单名.字段} 引用他证、[表达式]） */
+    customerData?: Record<string, any>;
+    /** 本证列数覆盖（缺省用 uiConfig.columns） */
+    columns?: number;
+}
+/** 字段校验等级：error 阻断提交；warning/info 仅提示不阻断 */
+export type FieldValidationLevel = 'error' | 'warning' | 'info';
+/**
+ * 声明式校验规则（放 runtimeRules.validationRules）。
+ * 承载本步「答案无关、机器可判定」的过程校验：跨字段/跨表单一致、条件必填、比较、正则、范围；
+ * 只补 FormField 自身属性（required/validation/min/max/options）表达不了的部分。
+ * error 级是完成门禁；实时校验与提交时确定性评分共用同一执行器（evaluateDeclarativeRules），避免规则漂移。
+ */
+export interface DeclarativeValidationRule {
+    id: string;
+    kind: 'equals' | 'notEquals' | 'compare' | 'requiredIf' | 'pattern' | 'range' | 'crossFormEquals';
+    /** 错误归属字段（就地定位红/橙字）——必须是某表单字段的 name */
+    field: string;
+    /** 目标：另一字段 name / "{表单名.字段}" 跨表单引用 / 字面量（compare/range 用数字字符串） */
+    target?: string;
+    op?: '>' | '>=' | '<' | '<=' | '==' | '!=';
+    pattern?: string;
+    min?: number;
+    max?: number;
+    /** requiredIf：当 whenField 满足 whenOp(whenValue) 时，field 必填 */
+    whenField?: string;
+    whenOp?: '==' | '!=' | 'filled' | 'empty';
+    whenValue?: string;
+    level: FieldValidationLevel;
+    message: string;
+}
+/** 实时指导配置（放 runtimeRules.realtimeGuidance） */
+export interface RealtimeGuidanceConfig {
+    /** 是否启用定时实时指导；表单类步骤默认开启，显式 false 才关闭 */
+    enabled?: boolean;
+    /** 定时器间隔毫秒，默认 5000 */
+    intervalMs?: number;
+    /** 输入沉降窗毫秒（距最后一次输入不足此值则本轮跳过），默认 1500 */
+    settleMs?: number;
+}
+/**
+ * 表单填写运行时规则（过程参数 runtimeRules）。
+ * 承载本步「答案无关、机器可判定」的过程校验逻辑与实时指导开关。
+ * error 级 validationRules 是完成门禁，与提交端确定性评分共用同一执行器（evaluateDeclarativeRules）。
+ */
+export interface FormFillingRuntimeRules {
+    /** 声明式校验规则（跨字段/跨表单一致、条件必填、比较、正则、范围） */
+    validationRules?: DeclarativeValidationRule[];
+    /** 定时实时指导配置 */
+    realtimeGuidance?: RealtimeGuidanceConfig;
+}
+/**
+ * 主题令牌
+ */
+export interface ThemeTokens {
+    primaryColor: string;
+    backgroundColor: string;
+    borderRadius: number;
+    headerBg: string;
+    headerColor: string;
+    borderColor: string;
+    successColor: string;
+    warningColor: string;
+    dangerColor: string;
+    textColor: string;
+    textSecondaryColor: string;
+    surfaceColor: string;
+    surfaceLightColor: string;
+}
+/**
+ * 基础 UI 配置（所有插件共享的通用配置项）
+ */
+export interface BaseUIConfig {
+    theme?: string | ThemeTokens;
+    headerVariant?: 'card' | 'banner' | 'minimal';
+    styleOverrides?: React.CSSProperties;
+}
+/**
+ * 表单填写 UI 配置（通过 initData.uiConfig 传入）
+ */
+export interface UIConfig extends BaseUIConfig {
+    layout?: 'form' | 'stepper';
+    labelLayout?: 'vertical' | 'horizontal';
+    groupStyle?: 'divider' | 'card' | 'none';
+    columns?: number;
+    groups?: FieldGroup[];
+    submitButtonText?: string;
+    /**
+     * @deprecated 高代码表单已废弃，新表单填写插件忽略此字段（仅旧对话式表单视图可能仍用）。
+     * AI 生成的自定义布局 React 组件代码。
+     */
+    customLayoutCode?: string;
+    /** 多表单时 Tab 位置，默认 top */
+    multiFormTabPosition?: 'top' | 'left';
+    /** 是否显示跨表单聚合进度（已填/总数），默认 true */
+    showAggregateProgress?: boolean;
+}
+/**
+ * 对话交互 UI 配置
+ */
+export interface DialogueUIConfig extends BaseUIConfig {
+    chatBubbleStyle?: 'modern' | 'classic';
+    showAvatar?: boolean;
+    chatAreaHeight?: number | string;
+    tellerBubbleColor?: string;
+    customerBubbleColor?: string;
+    showTimestamp?: boolean;
+    showEmotionTag?: boolean;
+    inputPlaceholder?: string;
+    submitButtonText?: string;
+    scenarioDisplay?: 'card' | 'banner' | 'none';
+    goalDisplay?: 'card' | 'checklist' | 'tags' | 'none';
+}
+/**
+ * 案例分析 UI 配置
+ */
+export interface CaseAnalysisUIConfig extends BaseUIConfig {
+    caseCardStyle?: 'card' | 'banner' | 'minimal';
+    toolSelectLayout?: 'grid' | 'list';
+    toolColumns?: number;
+    dimensionInputRows?: number;
+    submitButtonText?: string;
+    showToolDescription?: boolean;
+    feedbackStyle?: 'card' | 'collapse';
+}
+/** 参考文档（左栏，可选） */
+export interface ReferenceDoc {
+    id: string;
+    title: string;
+    url?: string;
+    summary?: string;
+}
+/** 报告内容块类型 */
+export type ReportBlockKind = 'heading' | 'paragraph' | 'list' | 'table' | 'chart' | 'framework' | 'quote' | 'divider' | 'progress' | 'cover' | 'image' | 'card' | 'button';
+/** 图表录入数据（学生录入，映射到 VisualizationRenderer/ChartRenderer） */
+export interface ChartInputData {
+    labels: string[];
+    series: Array<{
+        name: string;
+        values: number[];
+    }>;
+}
+/**
+ * 块的视觉排版属性（学生在属性面板调，作用于画布渲染与导出，**不参与 AI 评分**）。
+ * 对应"排版三层评分"的第③层（像素级美化不进 AI 评分）。
+ */
+export interface BlockStyle {
+    /** 字号 px */
+    fontSize?: number;
+    /** 水平对齐 */
+    align?: 'left' | 'center' | 'right';
+    /** 文本颜色 */
+    color?: string;
+    /** 上间距 px */
+    marginTop?: number;
+    /** 下间距 px */
+    marginBottom?: number;
+}
+interface BaseReportBlock {
+    id: string;
+    /** 关联到推荐大纲的章节 id，用于完整性确定性判定 */
+    sectionId?: string;
+    /** 章节引导提示（硬骨架预置时来自 outline.hint / suggestedBlocks.note），空内容时作占位显示 */
+    hint?: string;
+    /** 视觉排版（渲染/导出用，不进评分） */
+    style?: BlockStyle;
+}
+export interface HeadingBlock extends BaseReportBlock {
+    kind: 'heading';
+    level: 1 | 2 | 3;
+    text: string;
+}
+export interface ParagraphBlock extends BaseReportBlock {
+    kind: 'paragraph';
+    text: string;
+}
+/** 列表变体：无序/有序/步骤/检查清单（checklist 用并行 checked[] 记录勾选） */
+export type ListVariant = 'unordered' | 'ordered' | 'step' | 'checklist';
+export interface ListBlock extends BaseReportBlock {
+    kind: 'list';
+    variant: ListVariant;
+    items: string[];
+    /** variant==='checklist' 时各项勾选状态（按 index 对齐 items） */
+    checked?: boolean[];
+}
+/** 表格变体：基础/对比/日历(7 列周表)/评分(指定列渲染星级) */
+export type TableVariant = 'basic' | 'comparison' | 'calendar' | 'rating';
+export interface TableBlock extends BaseReportBlock {
+    kind: 'table';
+    variant?: TableVariant;
+    headers: string[];
+    rows: string[][];
+    /** variant==='rating' 时按星级渲染的列索引（默认末列） */
+    ratingColumn?: number;
+}
+export interface ChartBlock extends BaseReportBlock {
+    kind: 'chart';
+    chartType: 'bar' | 'line' | 'pie' | 'radar';
+    data: ChartInputData;
+}
+/** 分析框架 widget：toolKey 指向 analysisTools 内置框架，cells 复用其 dimensions */
+export interface FrameworkBlock extends BaseReportBlock {
+    kind: 'framework';
+    toolKey: string;
+    title?: string;
+    cells: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+export interface QuoteBlock extends BaseReportBlock {
+    kind: 'quote';
+    text: string;
+}
+export interface DividerBlock extends BaseReportBlock {
+    kind: 'divider';
+}
+/** 进度条：多条带标签的百分比进度 */
+export interface ProgressBlock extends BaseReportBlock {
+    kind: 'progress';
+    items: Array<{
+        label: string;
+        percent: number;
+    }>;
+}
+/** 封面块：居中大标题 + 副标题 + 元信息 */
+export interface CoverBlock extends BaseReportBlock {
+    kind: 'cover';
+    title: string;
+    subtitle?: string;
+    meta?: string;
+}
+/** 图片/多媒体：图片地址 + 说明 */
+export interface ImageBlock extends BaseReportBlock {
+    kind: 'image';
+    url?: string;
+    caption?: string;
+    alt?: string;
+}
+/** 卡片容器：带边框的标题 + 正文 */
+export interface CardBlock extends BaseReportBlock {
+    kind: 'card';
+    title?: string;
+    body?: string;
+}
+/** 按钮：展示型胶囊按钮（label + 可选链接） */
+export interface ButtonBlock extends BaseReportBlock {
+    kind: 'button';
+    label: string;
+    href?: string;
+}
+export type ReportBlock = HeadingBlock | ParagraphBlock | ListBlock | TableBlock | ChartBlock | FrameworkBlock | QuoteBlock | DividerBlock | ProgressBlock | CoverBlock | ImageBlock | CardBlock | ButtonBlock;
+/** 学生最终产出物 */
+export interface ReportDraft {
+    blocks: ReportBlock[];
+}
+/** 推荐大纲的单个章节（硬骨架预置依据） */
+export interface OutlineSection {
+    id: string;
+    title: string;
+    hint?: string;
+    /** 必填章节 → 进完整性确定性兜底 */
+    required?: boolean;
+    /** 建议用什么组件表达这一章（驱动硬骨架预置） */
+    suggestedBlocks?: Array<{
+        component: ReportBlockKind;
+        /** component==='framework' 时指向某框架 key */
+        toolKey?: string;
+        note?: string;
+    }>;
+}
+/** 场景驱动的推荐大纲（生成端按步骤场景产） */
+export interface RecommendedOutline {
+    reportTitle?: string;
+    sections: OutlineSection[];
+}
+/** 确定性兜底阈值（完整性/态度分用；必填章节由 outline.required 推导，不在此重复） */
+export interface CaseAnalysisRuntimeRules {
+    minWordCount?: number;
+    minBlocks?: number;
+}
+/**
+ * 报告搭建器 initData（对外：方案设计）。
+ * PluginProps.initData 仍为 any，运行时插件内 as CaseAnalysisInitData 使用。
+ */
+export interface CaseAnalysisInitData {
+    scenario: string;
+    background?: string;
+    referenceDocs?: ReferenceDoc[];
+    recommendedOutline: RecommendedOutline;
+    availableComponents?: ReportBlockKind[];
+    availableFrameworks?: string[];
+    evaluationRules?: EvaluationRules;
+    uiConfig?: CaseAnalysisUIConfig;
+    caseData?: Record<string, unknown>;
+    currentUser?: {
+        userId: string;
+        name: string;
+    };
+    stepId?: string;
+    stepName?: string;
+    previousEvidence?: EvidenceSummary[];
+}
+/**
+ * 评估结果（案例分析/方案设计的 AI 评分产物 + 本地确定性维度合并后的最终形态）。
+ */
+export interface EvaluationResult {
+    stepId?: string;
+    totalScore: number;
+    pass: boolean;
+    dimensions: Array<{
+        name: string;
+        score: number;
+        feedback: string;
+        errors?: string[];
+        suggestions?: string[];
+    }>;
+    highlights: string[];
+    improvements: string[];
+    nextStepAdvice: string;
+}
+/**
+ * 对话式表单 UI 配置
+ */
+export interface DialogueFormUIConfig extends BaseUIConfig {
+    /** 布局方向：horizontal=左右布局 | vertical=上下布局 */
+    layout?: 'horizontal' | 'vertical';
+    /** 对话区域宽度（horizontal 时有效），如 '40%' | '50%' | '60%' */
+    dialogueWidth?: string;
+    /** 对话区域配置 */
+    dialogueConfig?: {
+        showAvatar?: boolean;
+        avatarUrl?: string;
+        roleName?: string;
+        placeholder?: string;
+        chatBubbleStyle?: 'modern' | 'classic';
+        showTimestamp?: boolean;
+    };
+    /** 表单区域配置 */
+    formConfig?: {
+        showTitle?: boolean;
+        showDescription?: boolean;
+        labelAlign?: 'left' | 'right' | 'top';
+    };
+    /** 智能联动配置 */
+    autoFillEnabled?: boolean;
+    highlightFieldOnMention?: boolean;
+}
+/**
+ * 模型级 UI 配置（按插件类型分区）
+ */
+export interface ModelUIConfig extends BaseUIConfig {
+    /** 沉浸模式背景图片 URL（覆盖全局 appConfig.backgroundImage） */
+    backgroundImage?: string;
+    /** 沉浸模式下"完成此步"按钮风格：capsule=胶囊发光 | border=渐变边框 | island=浮岛底栏（默认） */
+    completeButtonStyle?: 'capsule' | 'border' | 'island';
+    /** 是否向学员显示预设答案数量，默认 true */
+    showExpectedCount?: boolean;
+    formFilling?: Omit<UIConfig, keyof BaseUIConfig>;
+    dialogue?: Omit<DialogueUIConfig, keyof BaseUIConfig>;
+    dialogueForm?: Omit<DialogueFormUIConfig, keyof BaseUIConfig>;
+    caseAnalysis?: Omit<CaseAnalysisUIConfig, keyof BaseUIConfig>;
+    strategyLab?: Omit<StrategyLabUIConfig, keyof BaseUIConfig>;
+}
+/**
+ * 策略实验室 UI 配置
+ */
+export interface StrategyLabUIConfig extends BaseUIConfig {
+    /** 布局模式：single-column=垂直流式 | tabs=标签页 */
+    layout?: 'single-column' | 'tabs';
+    /** 对比视图（仅对比模式生效）：grid=网格 | carousel=轮播 | split-screen=分屏 */
+    comparisonView?: 'grid' | 'carousel' | 'split-screen';
+    /** 是否启用动画 */
+    animationEnabled?: boolean;
+    /** 结果逐步展示延迟（ms） */
+    resultRevealDelay?: number;
+    /** 按钮文案自定义 */
+    buttonLabels?: {
+        submit?: string;
+        adjust?: string;
+        addComparison?: string;
+        complete?: string;
+    };
+    /** 场景主题类型（前端渲染时使用，优先级高于 initData.sceneThemeType） */
+    sceneThemeType?: 'urban-planning' | 'business-strategy' | 'investment' | 'policy' | 'crisis';
+}
+/**
+ * SimulationMode 配置注册表（SIMULATION_MODES）的内部键类型。
+ * 仅用于推演引擎内部取推演/UI 配置：`SimulationLensType` 的 7 个真镜头同名直取；
+ * `default` 镜头取 `iterative` 配置（常规推演），`compare` 收敛方式取 `comparison` 配置（并排 UI）。
+ * 注意：这不是面向配置层的字段类型——字段层用「镜头(SimulationLensType) + 决策收敛方式(decisionStyle)」两轴表达。
+ */
+export type SimulationModeType = 'iterative' | 'comparison' | 'adversarial' | 'timeline' | 'collaborative' | 'stress-test' | 'reverse' | 'sandbox' | 'historical';
+/**
+ * 推演镜头类型（改变「AI 推演什么」的 7 种视角 + 默认无镜头）。
+ * 与决策收敛方式(decisionStyle: iterate|compare) 正交：`default` 即无特殊视角的常规推演，
+ * 「单方案打磨 / 多方案对比」由 decisionStyle 表达，不是镜头。
+ */
+export type SimulationLensType = 'default' | 'adversarial' | 'timeline' | 'collaborative' | 'stress-test' | 'reverse' | 'sandbox' | 'historical';
+/**
+ * 决策输入方式
+ */
+export type DecisionInputMethod = 'fields' | 'guided';
+/**
+ * 可视化输入字段
+ */
+export interface VisualField {
+    /** 字段名称（唯一标识） */
+    name: string;
+    /** 字段标签（显示名称） */
+    label: string;
+    /** 可视化类型 */
+    type: 'budget-allocation' | 'resource-distribution' | 'priority-ranking' | 'timeline-planning' | 'option-select' | 'stance-spectrum' | 'matrix-2d';
+    /** 是否必填 */
+    required?: boolean;
+    /** 字段配置（根据 type 不同，使用不同的配置） */
+    config: {
+        /** 预算分配配置 */
+        budgetAllocation?: {
+            /** 总预算 */
+            totalBudget: number;
+            /** 分类列表 */
+            categories: {
+                key: string;
+                label: string;
+                min?: number;
+                max?: number;
+            }[];
+            /** 显示模式 */
+            displayMode: 'sliders' | 'pie-interactive' | 'bar-draggable';
+        };
+        /** 资源分配配置 */
+        resourceDistribution?: {
+            /** 资源列表 */
+            resources: {
+                id: string;
+                label: string;
+                quantity: number;
+                unit: string;
+            }[];
+            /** 目标列表 */
+            targets: {
+                id: string;
+                label: string;
+                description?: string;
+            }[];
+        };
+        /** 优先级排序配置 */
+        priorityRanking?: {
+            /** 待排序项列表 */
+            items: {
+                id: string;
+                label: string;
+                description?: string;
+                impact?: string;
+            }[];
+        };
+        /** 时间规划配置 */
+        timelinePlanning?: {
+            /** 任务列表 */
+            tasks: {
+                id: string;
+                label: string;
+                duration: number;
+                dependencies?: string[];
+            }[];
+            /** 时间范围 */
+            timeRange: {
+                start: string;
+                end: string;
+            };
+        };
+        /** 方案选择配置（在若干互斥/可叠加方案间取舍） */
+        optionSelect?: {
+            /** 候选方案 */
+            options: {
+                id: string;
+                label: string;
+                /** 方案说明 */
+                description?: string;
+                /** 利（优势） */
+                pros?: string;
+                /** 弊（代价/风险） */
+                cons?: string;
+            }[];
+            /** 是否允许多选；默认 false（单选） */
+            multiple?: boolean;
+            /** 多选时最少选几个 */
+            minSelect?: number;
+            /** 多选时最多选几个 */
+            maxSelect?: number;
+        };
+        /** 立场光谱配置（在命名两极间定调，可多轴） */
+        stanceSpectrum?: {
+            axes: {
+                id: string;
+                /** 轴名，如「修复节奏」 */
+                label: string;
+                /** 左极标签，如「激进」 */
+                leftLabel: string;
+                /** 右极标签，如「稳健」 */
+                rightLabel: string;
+                /** 取值下界，默认 0 */
+                min?: number;
+                /** 取值上界，默认 100 */
+                max?: number;
+                /** 步长，默认 1 */
+                step?: number;
+            }[];
+        };
+        /** 二维象限定位配置（在两轴构成的平面上为各项定位，如 风险×收益） */
+        matrix2d?: {
+            xAxis: {
+                label: string;
+                leftLabel: string;
+                rightLabel: string;
+            };
+            yAxis: {
+                label: string;
+                bottomLabel: string;
+                topLabel: string;
+            };
+            /** 待定位的项（可一个或多个） */
+            items: {
+                id: string;
+                label: string;
+            }[];
+            /** 可选的象限名 */
+            quadrantLabels?: {
+                topLeft?: string;
+                topRight?: string;
+                bottomLeft?: string;
+                bottomRight?: string;
+            };
+        };
+    };
+}
+/**
+ * 预算分配数据
+ */
+export interface BudgetAllocationData {
+    [categoryKey: string]: number;
+}
+/**
+ * 资源分配数据
+ * targetId → { resourceId → 分配数量 }
+ */
+export interface ResourceAllocationData {
+    [targetId: string]: {
+        [resourceId: string]: number;
+    };
+}
+/**
+ * 优先级排序数据
+ */
+export type PriorityRankingData = string[];
+/**
+ * 时间规划数据
+ */
+export interface TimelinePlanningData {
+    [taskId: string]: {
+        start: string;
+        duration: number;
+    };
+}
+/**
+ * 方案选择数据：单选为 optionId，多选为 optionId[]
+ */
+export type OptionSelectData = string | string[];
+/**
+ * 立场光谱数据：axisId → 取值
+ */
+export interface StanceSpectrumData {
+    [axisId: string]: number;
+}
+/**
+ * 二维象限定位数据：itemId → { x, y }（0-100）
+ */
+export interface Matrix2DData {
+    [itemId: string]: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 可视化输入配置（新版本 - 多字段支持）
+ */
+export interface VisualInputConfig {
+    /** 可视化字段列表 */
+    fields: VisualField[];
+}
+/**
+ * 决策字段（统一决策输入）：一个决策 = 有序的 DecisionField 列表，每个字段自选 `control`。
+ * control 涵盖「简单控件」(text/textarea/number/select/radio/checkbox/slider/rating/date)
+ * 与「可视化 widget」(budget-allocation/resource-distribution/priority-ranking/timeline-planning/
+ * option-select/stance-spectrum/matrix-2d)，二者可在同一决策内任意混搭。
+ * 纯开放论述 = 单个 textarea 字段；AI 分步引导走 decisionInputMethod='guided'，不用本结构。
+ */
+export interface DecisionField {
+    /** 字段名（提交值的 key） */
+    name: string;
+    /** 字段标签（展示名） */
+    label: string;
+    /** 控件类型 */
+    control: 'text' | 'textarea' | 'number' | 'select' | 'radio' | 'checkbox' | 'slider' | 'rating' | 'date' | 'budget-allocation' | 'resource-distribution' | 'priority-ranking' | 'timeline-planning' | 'option-select' | 'stance-spectrum' | 'matrix-2d';
+    required?: boolean;
+    /** 占位提示（简单控件） */
+    placeholder?: string;
+    /** select/radio/checkbox 的选项 */
+    options?: Array<string | {
+        label: string;
+        value: string;
+    }>;
+    /** number/slider 的范围与步长 */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** 文本最大长度（text/textarea） */
+    maxLength?: number;
+    /** 可视化控件配置：仅 7 种可视化 control 使用，子结构同 VisualField.config */
+    config?: VisualField['config'];
+}
+/**
+ * 参考数据
+ */
+export interface ReferenceData {
+    type: string;
+    content: any;
+    source?: string;
+}
+/**
+ * 约束规则
+ */
+export interface SimulationConstraint {
+    type: string;
+    description: string;
+    value?: any;
+}
+/**
+ * 评估维度（策略实验室专用）
+ */
+export interface StrategyEvaluationDimension {
+    dimension: string;
+    weight: number;
+    criteria?: string;
+}
+/**
+ * 模拟模式配置
+ */
+export interface SimulationMode {
+    type: SimulationModeType;
+    label: string;
+    description: string;
+    flowControl: {
+        allowIteration: boolean;
+        allowComparison: boolean;
+        requiresGuidance: boolean;
+        maxIterations?: number;
+    };
+    promptTemplate: {
+        systemRole: string;
+        simulationInstruction: string;
+        evaluationCriteria: string;
+    };
+    uiLayout: {
+        inputArea: 'full' | 'left' | 'top';
+        resultArea: 'full' | 'right' | 'bottom';
+        showComparisonPanel?: boolean;
+        showTimelineView?: boolean;
+    };
+    specificConfig?: Record<string, any>;
+}
+/**
+ * 决策数据
+ */
+export interface DecisionData {
+    content: string | Record<string, any>;
+    timestamp: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * 角色类型（用于沉浸式体验）
+ */
+export interface Character {
+    name: string;
+    avatar?: string;
+    personality?: string[];
+    background?: string;
+    dialogue?: string;
+    stance?: string;
+}
+/**
+ * 推演结果
+ */
+export interface SimulationResult {
+    dimensions: {
+        name: string;
+        value: number;
+        change?: number;
+    }[];
+    visualization: VisualizationData;
+    reasoning: string[];
+    risks: string[];
+    opportunities: string[];
+    counterMeasures?: {
+        action: string;
+        impact: string;
+        severity: 'high' | 'medium' | 'low';
+    }[];
+    adversary?: Character;
+    timeline?: {
+        shortTerm: {
+            period: string;
+            changes: string[];
+            risks: string[];
+            opportunities: string[];
+        };
+        midTerm: {
+            period: string;
+            changes: string[];
+            risks: string[];
+            opportunities: string[];
+        };
+        longTerm: {
+            period: string;
+            changes: string[];
+            risks: string[];
+            opportunities: string[];
+        };
+    };
+    stressTest?: {
+        resilienceScore: number;
+        breakingPoint: string;
+        extremeScenarios: {
+            scenario: string;
+            impact: string;
+            survivalRate: number;
+        }[];
+    };
+    narrator?: Character;
+    stakeholders?: Array<{
+        name: string;
+        interests: string;
+        impact: number;
+        acceptance: number;
+        concerns?: string[];
+        character?: Character;
+    }>;
+    reversePath?: {
+        goal: string;
+        steps: any[];
+    };
+    randomEvents?: Array<{
+        type: string;
+        description: string;
+        probability: number;
+        impact: string;
+        response: string;
+    }>;
+    adaptabilityScore?: number;
+    historicalCases?: Array<{
+        name: string;
+        context: string;
+        outcome: string;
+        similarities: string[];
+        differences: string[];
+        lessons: string[];
+    }>;
+}
+/**
+ * 可视化数据
+ */
+export interface VisualizationData {
+    charts?: {
+        type: 'bar' | 'line' | 'pie' | 'radar' | 'sankey' | 'heatmap' | 'network' | 'gauge';
+        data: any;
+        options?: any;
+        animation?: AnimationConfig;
+    }[];
+    cards?: {
+        title: string;
+        value: string | number;
+        change?: {
+            value: number;
+            trend: 'up' | 'down' | 'stable';
+        };
+        icon?: string;
+        color?: string;
+    }[];
+    timeline?: {
+        nodes: {
+            time: string;
+            label: string;
+            events: string[];
+        }[];
+        branches?: {
+            from: string;
+            to: string;
+            condition: string;
+        }[];
+    };
+}
+/**
+ * 动画配置
+ */
+export interface AnimationConfig {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+}
+/**
+ * 评估结果（策略实验室）
+ */
+export interface StrategyEvaluationResult {
+    overallScore: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    dimensionScores: {
+        dimension: string;
+        score: number;
+        weight: number;
+        reasoning: string;
+    }[];
+    strengths: string[];
+    weaknesses: string[];
+    suggestions: string[];
+    evaluationBasis: string[];
+}
+/**
+ * 单个引导问题
+ */
+export interface GuidanceQuestion {
+    /** 问题文案 */
+    question: string;
+    inputType: 'text' | 'options' | 'number';
+    options?: string[];
+    allowMultiple?: boolean;
+    min?: number;
+    max?: number;
+}
+/**
+ * 引导步骤（引导模式专用）
+ * AI 可以一次返回多个无依赖关系的问题
+ */
+export interface GuidanceStep {
+    type: 'guidance';
+    questions: GuidanceQuestion[];
+}
+/**
+ * 引导历史条目
+ */
+export interface GuidanceHistoryItem {
+    question: string;
+    answer: any;
+}
+/**
+ * 引导确认状态：AI 已判断信息足够，等待用户确认/编辑后才推演
+ */
+export interface GuidanceConfirmState {
+    history: GuidanceHistoryItem[];
+}
+/**
+ * 策略实验室 InitData
+ */
+/**
+ * 角色配置（沉浸式体验）。落在节点上（initData.nodes[].characterConfig），按镜头按需启用。
+ */
+export interface StrategyLabCharacterConfig {
+    enabled: boolean;
+    forceRegenerate: boolean;
+    adversary?: Character;
+    stakeholders?: Array<{
+        name: string;
+        interests: string;
+        impact: number;
+        acceptance: number;
+        concerns?: string[];
+        character?: Character;
+    }>;
+    narrator?: Character;
+}
+/**
+ * 策略实验室 InitData —— 单一数据源：所有「场景配置」（场景/背景/镜头/收敛方式/推演配置/
+ * 评估维度/输入方式/角色等）只活在 `nodes[]` 里；单场景 = `nodes` 长度为 1 的退化。
+ * 顶层只保留步骤级 / UI 级、跨节点共享的配置。
+ */
+export interface StrategyLabInitData {
+    /**
+     * 推演节点链（必填，至少 1 个）。单场景就是长度为 1 的链；多节点 = 有序时序链。
+     * 运行时一律操作 nodes[]（见 resolveNodes 归一化）。
+     */
+    nodes: SimulationNode[];
+    /** 步骤级推演总目标（跨节点，可选） */
+    objectives?: string[];
+    /** 场景主题类型（UI 主题，步骤级） */
+    sceneThemeType?: 'urban-planning' | 'business-strategy' | 'investment' | 'policy' | 'crisis' | 'technology' | 'healthcare' | 'education' | 'supply-chain' | 'environment';
+    /** 场景主题覆盖配置（可选，已废弃，使用节点 simulationConfig.dimensions 替代） */
+    sceneThemeOverride?: {
+        dataLayers?: any[];
+        visual?: {
+            primaryColor?: string;
+            accentColor?: string;
+        };
+    };
+    modeConfig?: Record<string, any>;
+    visualizationPreset?: 'auto' | 'charts' | 'cards' | 'timeline' | 'custom';
+    uiConfig?: StrategyLabUIConfig;
+}
+/**
+ * 策略实验室 CheckRules
+ */
+export interface StrategyLabCheckRules {
+    minIterations?: number;
+    minComparisons?: number;
+    requiredSteps?: string[];
+    minScore?: number;
+    requiredDimensions?: {
+        dimension: string;
+        minScore: number;
+    }[];
+    mustIncludeRiskAnalysis?: boolean;
+    mustAdjustAfterFeedback?: boolean;
+    /** 节点链门禁：是否要求所有节点都已拍定决策，默认 true */
+    requireAllNodesCommitted?: boolean;
+}
+/**
+ * 推演节点（节点链的一个节点）。一个 strategy-lab 步骤可含一条有序节点链。
+ * 节点 = 场景配置 + 决策目标，本质是 initData 性质的配置（落 initData.nodes）。
+ * 仅当「上一节点推演 realize 出事先不可知的新局面、下一节点在新局面上决策」时才分节点；
+ * 信息齐备、需通盘协同的决策不分节点（用单节点多维推演+迭代）。
+ */
+export interface SimulationNode {
+    nodeId: string;
+    order: number;
+    /** 本节点场景描述（推演任务处境） */
+    scenario?: string;
+    /** 本节点背景事实（推演所依据的事实基础） */
+    background?: string;
+    /**
+     * 本节点学员要拍定的、带权衡张力的决策目标（非指标、非评分维度）。
+     * 多节点链里必填；单场景（nodes 长度为 1）可省。
+     */
+    decisionGoal?: string;
+    /** AI 评判该决策目标是否达成的依据。多节点链里建议给出；单场景可省。 */
+    goalCompletionCriteria?: string;
+    /** 推演镜头，每节点独立 */
+    mode: SimulationLensType;
+    /** 决策收敛方式，默认 iterate；compare=多方案并排择优 */
+    decisionStyle?: 'iterate' | 'compare';
+    /** 推演配置（事实/约束/推演维度） */
+    simulationConfig?: {
+        referenceData?: ReferenceData[];
+        constraints?: SimulationConstraint[];
+        dimensions?: Array<{
+            name: string;
+            initialValue?: number;
+            icon?: string;
+            color?: string;
+        }>;
+    };
+    /** 决策输入方式：默认 fields（渲染 decisionFields）；guided=AI 分步引导 */
+    decisionInputMethod?: DecisionInputMethod;
+    /** 统一决策字段列表（decisionInputMethod 非 guided 时渲染）。每字段自选控件，可混搭简单控件/可视化widget/文本 */
+    decisionFields?: DecisionField[];
+    /** 节点级即时评估维度 */
+    evaluationDimensions?: StrategyEvaluationDimension[];
+    /** 对抗/群体等镜头按需 */
+    characterConfig?: StrategyLabCharacterConfig;
+    /** 默认 false=软流转（未达成警告但可进入下一节点）；true=未达成硬卡 */
+    requireGoalAchieved?: boolean;
+}
+/**
+ * 节点产出：学员在该节点拍定后计算，作为下一节点推演的输入前提注入。
+ */
+export interface NodeOutcome {
+    nodeId: string;
+    /** 学员拍定的决策 */
+    decision: DecisionData;
+    /** 关键维度末值 → 下一节点维度基线 */
+    dimensionEndValues: Record<string, number>;
+    /** 关键风险 → 下一节点新增约束/背景 */
+    keyRisks: string[];
+    goalAchieved: boolean;
+    /** 注入下一节点背景的紧凑摘要 */
+    summary: string;
+}
+/**
+ * 节点运行时状态（按 stepId 持久化于 strategyLabStore）。
+ */
+export interface NodeRuntimeState {
+    nodeId: string;
+    status: 'pending' | 'active' | 'committed' | 'skipped';
+    /** 节点内多轮决策 */
+    decisions: DecisionData[];
+    simulationResults: SimulationResult[];
+    /** 节点独立会话，隔离跨节点上下文 */
+    conversationId: string | null;
+    /** 学员拍定的是第几轮决策 */
+    committedDecisionIndex?: number;
+    goalJudgment?: {
+        achieved: boolean;
+        reasoning: string[];
+        suggestions?: string[];
+    };
+    userConfirmedAt?: number;
+}
+/**
+ * 所有布局组件的统一 Props
+ */
+export interface FormLayoutProps {
+    fields: FormField[];
+    groups: FieldGroup[];
+    columns: number;
+    theme: ThemeTokens;
+    labelLayout: 'vertical' | 'horizontal';
+    groupStyle: 'divider' | 'card' | 'none';
+    formInstance: any;
+    formData: Record<string, any>;
+    validationErrors: Record<string, string>;
+    renderFormField: (field: FormField) => ReactNode;
+    onValuesChange: (changedValues: Record<string, any>) => void;
+    onSubmit?: () => void;
+    submitButtonText?: string;
+}
+/**
+ * 插件头部 Props
+ */
+export interface PluginHeaderProps {
+    title: string;
+    variant: 'card' | 'banner' | 'minimal';
+    theme: ThemeTokens;
+    /** 去掉底部 margin，由外层容器控制间距 */
+    noMargin?: boolean;
+}
+/**
+ * 插件底部 Props
+ */
+export interface PluginFooterProps {
+    buttonText: string;
+    theme: ThemeTokens;
+    onSubmit: () => void;
+}
+/**
+ * 判断是否为预算分配字段
+ */
+export declare function isBudgetAllocationField(field: VisualField): boolean;
+/**
+ * 判断是否为资源分配字段
+ */
+export declare function isResourceDistributionField(field: VisualField): boolean;
+/**
+ * 判断是否为优先级排序字段
+ */
+export declare function isPriorityRankingField(field: VisualField): boolean;
+/**
+ * 判断是否为时间规划字段
+ */
+export declare function isTimelinePlanningField(field: VisualField): boolean;
+/**
+ * 验证 VisualField 配置
+ */
+export declare function validateVisualField(field: VisualField): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 验证 VisualInputConfig 配置
+ */
+export declare function validateVisualInputConfig(config: VisualInputConfig): {
+    valid: boolean;
+    errors: string[];
+};
+export {};