@mathwiz/ui-components 0.1.22 → 0.1.23

package/dist/data/GeometryProblemAdapterV4/geometry-types.d.ts

@@ -0,0 +1,1012 @@
+/**
+ * 数学几何问题V4数据格式类型定义 - 完整版
+ *
+ * 基于实际JSON数据结构、组件类型和适配器实现整合的完整类型定义。
+ * 提供完整的V4数据格式类型安全支持，支持设计令牌、几何引用、样式引用等。
+ * 整合来源：
+ * 1. GeometryTransform组件类型定义
+ * 2. MathPracticeSessionTypes类型定义
+ * 3. GeometryProblemAdapterV4适配器类型
+ * 4. 实际V4 JSON数据结构（triangle-v4-final.json）
+ *
+ * @generatedBy math-geometry-problem-generator
+ * @version 2.0.0
+ * @schemaVersion 4.0.0
+ */
+/**
+ * V4数据格式版本
+ */
+export type V4SchemaVersion = '4.0.0';
+/**
+ * 数学问题唯一标识符格式
+ * 格式：mp-{年级}-{单元}-{课程}-{类型}-{序号}
+ * 示例：mp-10506-0002-0002-G01-0001
+ */
+export type MathProblemId = `mp-${string}-${string}-${string}-${string}-${string}`;
+/**
+ * 几何形状类型 - 基于实际JSON和组件定义
+ */
+export type GeometryShapeType = 'acute_triangle' | 'right_triangle' | 'obtuse_triangle' | 'parallelogram' | 'rectangle' | 'square' | 'trapezoid' | 'circle' | 'polygon' | 'segment' | 'point' | 'text';
+/**
+ * 单位类型
+ */
+export type LengthUnit = 'cm' | 'm' | 'mm' | 'in' | 'ft';
+export type AreaUnit = 'cm²' | 'm²' | 'mm²' | 'in²' | 'ft²';
+/**
+ * 难度等级（1-5）
+ */
+export type DifficultyLevel = 1 | 2 | 3 | 4 | 5;
+/**
+ * 场景类型 - 基于实际JSON和MathPracticeSessionTypes
+ */
+export type SceneType = 'question' | 'solve' | 'review' | 'remember' | 'explanation' | 'success';
+/**
+ * 内容块类型 - 基于实际JSON scenes.items
+ */
+export type ContentType = 'text' | 'formula' | 'graph' | 'geometryTransform' | 'interactive';
+/**
+ * 布局类型
+ */
+export type LayoutType = 'vertical' | 'horizontal' | 'centered' | 'grid' | 'flow' | 'card';
+/**
+ * 方向类型 - 基于GeometryTransform组件
+ */
+export type DirectionType = 'clockwise' | 'counterclockwise' | 'horizontal' | 'vertical';
+/**
+ * 缓动函数类型
+ */
+export type EasingType = 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'step';
+/**
+ * 变换类型 - 基于GeometryTransform组件和JSON
+ */
+export type TransformType = 'rotation' | 'translation' | 'scale' | 'composite' | 'matrix' | 'fillcolor_set';
+/**
+ * 变换策略类型
+ */
+export type TransformStrategy = 'double_rotation' | 'single_rotation' | 'translation' | 'composite';
+/**
+ * 引用类型常量对象（替代枚举，兼容 erasableSyntaxOnly）
+ */
+export declare const ReferenceType: {
+    readonly DESIGN_TOKEN: "design_token";
+    readonly STYLE_REF: "style_ref";
+    readonly GEOMETRY_REF: "geometry_ref";
+    readonly TRANSFORM_REF: "transform_ref";
+    readonly LAYOUT_REF: "layout_ref";
+    readonly ANIMATION_REF: "animation_ref";
+    readonly BOARD_REF: "board_ref";
+    readonly GEOMETRY_TRANSFORM_REF: "geometry_transform_ref";
+    readonly SLIDER_REF: "slider_ref";
+    readonly APPEARANCE_REF: "appearance_ref";
+};
+export type ReferenceType = typeof ReferenceType[keyof typeof ReferenceType];
+/**
+ * 设计令牌引用
+ * 格式：$category.property
+ * 示例：$colors.primary, $fonts.heading_large
+ */
+export type DesignTokenRef = `$${string}.${string}`;
+/**
+ * 几何引用
+ * 格式：geometryRef:shape_id
+ * 示例：geometryRef:acute_triangle
+ */
+export type GeometryRef = `geometryRef:${string}`;
+/**
+ * 样式引用
+ * 格式：styleRef:style_id
+ * 示例：styleRef:primary
+ */
+export type StyleRef = `styleRef:${string}`;
+/**
+ * 变换引用
+ * 格式：transformRef:transform_id
+ * 示例：transformRef:left_rotation
+ */
+export type TransformRef = `transformRef:${string}`;
+/**
+ * 几何变换引用
+ * 格式：geometryTransformRef:config_id
+ * 示例：geometryTransformRef:double_rotation_proof
+ */
+export type GeometryTransformRef = `geometryTransformRef:${string}`;
+/**
+ * 滑块引用
+ * 格式：sliderRef:slider_id
+ * 示例：sliderRef:slider_horizontal
+ */
+export type SliderRef = `sliderRef:${string}`;
+/**
+ * 画板引用
+ * 格式：boardRef:board_id
+ * 示例：boardRef:default
+ */
+export type BoardRef = `boardRef:${string}`;
+/**
+ * 外观引用
+ * 格式：appearanceRef:appearance_id
+ * 示例：appearanceRef:always_visible
+ */
+export type AppearanceRef = `appearanceRef:${string}`;
+/**
+ * 顶点引用格式 - 基于实际JSON中的$ref引用
+ */
+export interface VertexRef {
+    $ref: string;
+}
+/**
+ * 引用值类型 - 所有可能的引用格式
+ */
+export type ReferenceValue = DesignTokenRef | GeometryRef | StyleRef | TransformRef | GeometryTransformRef | SliderRef | BoardRef | AppearanceRef | VertexRef | string;
+/**
+ * 引用对象
+ */
+export interface ReferenceObject {
+    type: ReferenceType;
+    value: string;
+    combined?: string;
+}
+/**
+ * 顶点格式 - 支持数组或对象格式
+ */
+export type VertexFormat = [number, number] | readonly [number, number] | {
+    x: number;
+    y: number;
+};
+/**
+ * 标签配置
+ */
+export interface LabelConfig {
+    /** 偏移量 */
+    offset?: [number, number];
+    /** 字体大小 */
+    fontSize?: number;
+    /** 颜色 */
+    color?: string;
+    /** 水平锚点 */
+    anchorX?: 'left' | 'middle' | 'right';
+    /** 垂直锚点 */
+    anchorY?: 'top' | 'middle' | 'bottom';
+    /** 标签内容（对于text类型） */
+    content?: string;
+}
+/**
+ * 几何形状定义 - 基于实际JSON结构和组件类型
+ * 用于geometry_shapes字段中的形状定义
+ */
+export interface GeometryShapeDefinition {
+    /** 形状ID（必需） */
+    id: string;
+    /** 形状类型（必需） */
+    type: 'point' | 'segment' | 'line' | 'polygon' | 'circle' | 'text';
+    /** 名称（可选，用于标签） */
+    name?: string;
+    /** 顶点数组（多边形必需，支持顶点引用） */
+    vertices?: Array<VertexRef | VertexFormat> | ReadonlyArray<VertexRef | VertexFormat> | ReadonlyArray<readonly [number, number]> | any[];
+    /** 端点数组（线段必需，支持顶点引用） */
+    endpoints?: Array<VertexRef | VertexFormat> | ReadonlyArray<VertexRef | VertexFormat> | ReadonlyArray<readonly [number, number]> | any[];
+    /** 位置（点必需） */
+    position?: VertexFormat;
+    /** 半径（圆必需） */
+    radius?: number;
+    /** 是否显示标签 */
+    withLabel?: boolean;
+    /** 标签配置 */
+    label?: LabelConfig;
+    /** 描述信息 */
+    description?: string;
+    /** 样式引用（可以是完整引用或普通字符串） */
+    styleRef?: string;
+    /** 外观引用（可以是完整引用或普通字符串） */
+    appearanceRef?: string;
+    /** 扩展字段 */
+    [key: string]: any;
+}
+/**
+ * 图形样式配置
+ */
+export interface ShapeStyle {
+    /** 填充颜色 */
+    fillColor?: string;
+    /** 填充透明度（0.0-1.0） */
+    fillOpacity?: number;
+    /** 描边颜色 */
+    strokeColor?: string;
+    /** 描边宽度 */
+    strokeWidth?: number;
+    /** 虚线样式 */
+    dashStyle?: number[];
+    /** 是否显示标签 */
+    labelVisible?: boolean;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 大小（点类型） */
+    size?: number;
+}
+/**
+ * 动态外观配置 - 基于GeometryTransform组件
+ */
+export interface DynamicAppearanceConfig {
+    /** 可见性控制 */
+    visibility?: {
+        type?: 'step' | 'fade';
+        threshold?: number;
+        startValue?: number;
+        endValue?: number;
+        easing?: EasingType;
+    };
+    /** 透明度控制 */
+    opacity?: {
+        type?: 'linear' | 'custom';
+        startAt?: number;
+        endAt?: number;
+        from?: number;
+        to?: number;
+        easing?: EasingType;
+    };
+    /** 颜色控制 */
+    color?: {
+        type?: 'gradient' | 'step';
+        startAt?: number;
+        endAt?: number;
+        from?: string;
+        to?: string;
+        easing?: EasingType;
+    };
+    /** 标签可见性控制 */
+    labelVisibility?: {
+        type?: 'step' | 'fade';
+        threshold?: number;
+        startValue?: number;
+        endValue?: number;
+        easing?: EasingType;
+    };
+}
+/**
+ * 图形元数据 - 基于GeometryTransform组件
+ */
+export interface ShapeMetadata {
+    /** 图形ID（必需） */
+    id: string;
+    /** 标签 */
+    label?: string;
+    /** 是否可移动 */
+    isMovable?: boolean;
+    /** 是否静态 */
+    isStatic?: boolean;
+    /** 旋转组标识 */
+    rotationGroup?: string;
+    /** 变换配置来源 */
+    transformSource?: 'shape' | 'global';
+    /** 动态外观配置 */
+    dynamicAppearance?: DynamicAppearanceConfig;
+}
+/**
+ * 几何图形（用于变换配置） - 基于GeometryTransform组件
+ */
+export interface GeometryShape {
+    /** 图形类型 */
+    type: GeometryShapeType;
+    /** 顶点数组 */
+    vertices: Array<[number, number]>;
+    /** 形状专属变换配置（优先于全局transform） */
+    transform?: TransformConfig;
+    /** 样式配置 */
+    style?: ShapeStyle;
+    /** 元数据 */
+    metadata?: ShapeMetadata;
+    /** 几何引用（可选，用于解析实际形状） */
+    geometryRef?: GeometryRef;
+    /** 样式引用（可选，覆盖style） */
+    styleRef?: StyleRef;
+    /** 外观引用（可选，用于动态外观） */
+    appearanceRef?: AppearanceRef;
+}
+/**
+ * 旋转变换配置 - 基于GeometryTransform组件和JSON
+ */
+export interface RotationConfig {
+    center: [number, number] | 'auto';
+    startAngle: number;
+    endAngle: number;
+    direction: DirectionType;
+}
+/**
+ * 平移变换配置
+ */
+export interface TranslationConfig {
+    direction: [number, number] | 'horizontal' | 'vertical';
+    distance: number;
+    startOffset?: number;
+}
+/**
+ * 缩放变换配置
+ */
+export interface ScaleConfig {
+    center: [number, number] | 'centroid';
+    startScale: number;
+    endScale: number;
+    uniform: boolean;
+}
+/**
+ * 填充颜色设置配置
+ */
+export interface FillColorSetConfig {
+    color: string;
+    opacity?: number;
+}
+/**
+ * 变换配置 - 基于GeometryTransform组件
+ */
+export interface TransformConfig {
+    type: TransformType;
+    rotation?: RotationConfig;
+    translation?: TranslationConfig;
+    scale?: ScaleConfig;
+    composite?: TransformConfig[];
+    fillColorSet?: FillColorSetConfig;
+    targetGroup?: string;
+}
+/**
+ * 变换定义 - 基于JSON中的transform_definitions
+ */
+export interface TransformDefinition {
+    id: string;
+    type: TransformType;
+    config: {
+        center?: {
+            x: number;
+            y: number;
+        } | [number, number] | 'auto' | 'centroid';
+        startAngle?: number;
+        endAngle?: number;
+        direction?: DirectionType;
+        distance?: number;
+        startScale?: number;
+        endScale?: number;
+        uniform?: boolean;
+        color?: string;
+        opacity?: number;
+    };
+    targetGroup?: string;
+    description?: string;
+}
+/**
+ * 变换配置或引用（支持transformRef引用或完整配置）
+ */
+export type TransformConfigOrRef = {
+    transformRef: string;
+} | TransformConfig;
+/**
+ * 动画配置 - 基于GeometryTransform组件
+ */
+export interface AnimationConfig {
+    /** 动画配置ID */
+    id: string;
+    /** 滑块配置 */
+    slider?: {
+        position: [number, number];
+        length: number;
+        orientation?: 'horizontal' | 'vertical';
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+    /** 进度指示器配置 */
+    progressIndicator?: {
+        enabled: boolean;
+        stages?: number;
+        labels?: string[];
+        showPercentage?: boolean;
+    };
+    /** 动画持续时间（毫秒） */
+    duration?: number;
+    /** 缓动函数类型 */
+    easing?: EasingType;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * 动画配置集合类型
+ * 用于animation_configs字段
+ */
+export type AnimationConfigs = Record<string, AnimationConfig>;
+/**
+ * 画板配置 - 基于GeometryTransform组件和JSON
+ */
+export interface BoardConfig {
+    originX?: number;
+    originY?: number;
+    boundingBox?: [number, number, number, number];
+    keepAspectRatio?: boolean;
+    showGrid?: boolean;
+    showAxis?: boolean;
+    gridSize?: number;
+    axisColor?: string;
+    gridColor?: string;
+}
+/**
+ * 几何变换配置 - 基于JSON中的geometry_transform_configs
+ */
+export interface GeometryTransformConfig {
+    /** 配置ID（必需） */
+    id: string;
+    /** 描述 */
+    description?: string;
+    /** 底边长度（必需） */
+    base: number;
+    /** 高度（必需） */
+    height: number;
+    /** 单位（必需） */
+    unit: LengthUnit;
+    /** 变换策略 */
+    strategy: TransformStrategy;
+    /** 图形定义（必需） */
+    shapes: {
+        /** 静态图形（保持不变） */
+        static: Array<{
+            id: string;
+            type: GeometryShapeType;
+            geometryRef: GeometryRef;
+            styleRef?: StyleRef;
+            appearanceRef?: AppearanceRef;
+        }>;
+        /** 动画图形（应用变换） */
+        animated: Array<{
+            id: string;
+            type: GeometryShapeType;
+            geometryRef: GeometryRef;
+            styleRef?: StyleRef;
+            appearanceRef?: AppearanceRef;
+        }>;
+    };
+    /** 变换配置（必需，支持transformRef引用或完整配置） */
+    transform: {
+        type: string;
+        transforms: any[];
+        executionMode?: string;
+    };
+    /** 滑块引用（必需） */
+    sliderRef: SliderRef;
+    /** 画板引用（必需） */
+    boardRef: BoardRef;
+}
+/**
+ * 场景定义 - 基于实际JSON scenes字段
+ */
+export interface SceneDefinition {
+    /** 内容项数组 */
+    items?: ContentBlock[];
+    /** 向后兼容字段 */
+    content?: ContentBlock[];
+    /** 布局类型 */
+    layout?: {
+        type?: LayoutType;
+        spacing?: string;
+        alignment?: string;
+        cardStyle?: {
+            backgroundColor?: string;
+            borderColor?: string;
+            borderWidth?: string;
+            borderRadius?: string;
+            padding?: string;
+            margin?: string;
+        };
+        layoutRef?: string;
+    };
+}
+/**
+ * 内容块类型 - 基于实际JSON scenes.items
+ */
+export type ContentBlock = TextContent | FormulaContent | GraphContent | GeometryTransformContent | InteractiveContent;
+/**
+ * 文本内容
+ */
+export interface TextContent {
+    type: 'text';
+    content: string;
+    styleRef?: StyleRef;
+    style?: Record<string, any>;
+}
+/**
+ * 公式内容
+ */
+export interface FormulaContent {
+    type: 'formula';
+    content: string;
+    parts?: string[];
+    displayMode?: boolean;
+    styleRef?: StyleRef;
+    style?: Record<string, any>;
+}
+/**
+ * 图形形状（用于GraphContent）
+ */
+export interface GraphShape {
+    id: string;
+    type: 'point' | 'segment' | 'polygon' | 'circle' | 'text';
+    geometryRef?: GeometryRef;
+    styleRef?: StyleRef;
+    position?: VertexFormat;
+    content?: string;
+    /** 点的大小（仅适用于type: 'point'） */
+    size?: number;
+    style?: Record<string, any>;
+}
+/**
+ * 图形内容
+ */
+export interface GraphContent {
+    type: 'graph';
+    shapes: GraphShape[];
+    boardRef?: BoardRef;
+    boundingBox?: [number, number, number, number];
+    showGrid?: boolean;
+    showAxis?: boolean;
+    autoBoundingBox?: boolean;
+    keepAspectRatio?: boolean;
+}
+/**
+ * 几何变换内容
+ */
+export interface GeometryTransformContent {
+    type: 'geometryTransform';
+    geometryTransformRef: GeometryTransformRef;
+    metadata?: {
+        componentType: 'geometry-transform';
+        config?: Partial<GeometryTransformConfig>;
+    };
+}
+/**
+ * 交互内容
+ */
+export interface InteractiveContent {
+    type: 'interactive';
+    component: string;
+    config: Record<string, any>;
+}
+/**
+ * 解释步骤 - 基于MathPracticeSessionTypes和实际JSON
+ */
+export interface ExplanationStep {
+    id: string;
+    type: string;
+    title: string;
+    description: string;
+    chartConfig?: {
+        type: 'graph' | 'geometryTransform';
+        boardRef?: string;
+        shapes?: GraphShape[];
+        geometryTransformRef?: GeometryTransformRef;
+        config?: any;
+        boundingBox?: [number, number, number, number];
+        showGrid?: boolean;
+        showAxis?: boolean;
+    };
+    videoUrl?: string;
+    commonErrors?: string[];
+    difficulty?: number;
+}
+/**
+ * 解释数据 - 基于MathPracticeSessionTypes
+ */
+export interface ExplanationData {
+    steps?: ExplanationStep[];
+    strategy?: string;
+    total_steps?: number;
+    estimated_time?: number;
+    hints?: Array<{
+        step: number;
+        text: string;
+        condition?: string;
+    }>;
+    videos?: Array<{
+        url: string;
+        title: string;
+        duration: number;
+    }>;
+    common_errors?: Array<{
+        description: string;
+        frequency: number;
+        prevention: string;
+    }>;
+    prerequisites?: string[];
+    learning_objectives?: string[];
+}
+/**
+ * 答案信息 - 基于实际JSON answer_info
+ */
+export interface AnswerInfo {
+    value: number;
+    unit: string;
+    type?: string;
+    tolerance?: number;
+    validation?: {
+        type: string;
+        allowPartial?: boolean;
+    };
+    explanation_text: string;
+    solution_steps?: string[];
+    format?: {
+        decimal_places?: number;
+        allow_fraction?: boolean;
+        allow_negative?: boolean;
+    };
+    validation_rules?: {
+        required?: boolean;
+        min_value?: number;
+        max_value?: number;
+        exact_match?: boolean;
+    };
+}
+/**
+ * 问题元数据
+ */
+export interface ProblemMetadata {
+    topic: string;
+    skill: string;
+    tags: string[];
+    version?: string;
+    author?: string;
+    strategy?: string;
+    estimatedTime?: number;
+    prerequisites?: string[];
+    learningObjectives?: string[];
+    [key: string]: any;
+}
+/**
+ * 基础信息 - 基于适配器类型和实际JSON
+ */
+export interface BasicInfo {
+    question: string;
+    answerUnit?: string;
+    areaUnit?: string;
+    shape?: GeometryShapeType | string;
+    base?: number;
+    height?: number;
+    baseUnit?: string;
+    heightUnit?: string;
+    topBase?: number;
+    topBaseUnit?: string;
+    length?: number;
+    width?: number;
+    lengthUnit?: string;
+    widthUnit?: string;
+    side?: number;
+    sideUnit?: string;
+    diagonal1?: number;
+    diagonal2?: number;
+    diagonalUnit?: string;
+    score?: number;
+    variables?: Record<string, any>;
+    context?: {
+        learning_objective?: string;
+        prerequisite_skills?: string[];
+        time_estimate?: number;
+    };
+    originX?: number;
+    originY?: number;
+    unit?: string;
+}
+/**
+ * 布局配置
+ */
+export interface LayoutConfig {
+    type?: string;
+    padding?: string;
+    theme?: string;
+    renderer?: {
+        showFormulaSteps?: boolean;
+        interactiveAnimations?: boolean;
+        validateAnswers?: boolean;
+        keepAspectRatio?: boolean;
+    };
+}
+/**
+ * V4数学几何问题数据接口 - 完整类型定义
+ */
+export interface V4MathGeometryProblemData {
+    /** 数据格式版本，必须为"4.0.0" */
+    schema_version: V4SchemaVersion;
+    /** 配置版本 */
+    config_version?: string;
+    /** 数学问题唯一标识符 */
+    math_prob_id: MathProblemId;
+    /** 问题标题 */
+    title: string;
+    /** 问题描述 */
+    description?: string;
+    /** 学习目标 */
+    objective: string;
+    /** 难度等级（1-5） */
+    difficulty: DifficultyLevel;
+    /** 年级标识，如"g5"表示五年级 */
+    grade_id: string;
+    /** 单元名称 */
+    unit_name: string;
+    /** 课程名称 */
+    lesson_name: string;
+    /** 技能描述 */
+    skill_description: string;
+    /** 知识点列表 */
+    knowledge_points: string[];
+    /** 分数 */
+    score?: number;
+    /** 元数据 */
+    metadata?: ProblemMetadata;
+    /** 基础信息 */
+    basic_info: BasicInfo;
+    /** 几何形状定义 */
+    geometry_shapes: Record<string, GeometryShapeDefinition>;
+    /** 几何变换配置 */
+    geometry_transform_configs?: Record<string, GeometryTransformConfig>;
+    /** 变换定义 */
+    transform_definitions?: Record<string, TransformDefinition>;
+    /** 动画配置 */
+    animation_configs?: AnimationConfigs;
+    /** 场景定义 */
+    scenes: Record<SceneType, SceneDefinition>;
+    /** 解释说明 */
+    explanation: ExplanationData | ExplanationStep[];
+    /** 答案信息 */
+    answer_info: AnswerInfo;
+    /** 布局配置 */
+    layout?: LayoutConfig;
+    /** 可选字段 */
+    unit_id?: number;
+    lesson_id?: number;
+    module_id?: number;
+    skill_item_id?: string;
+    skill_id?: number;
+    created_at?: string;
+    updated_at?: string;
+}
+/**
+ * 适配器错误代码
+ */
+export declare const AdapterErrorCode: {
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
+    readonly DESIGN_TOKEN_NOT_FOUND: "DESIGN_TOKEN_NOT_FOUND";
+    readonly GEOMETRY_REF_NOT_FOUND: "GEOMETRY_REF_NOT_FOUND";
+    readonly TRANSFORM_REF_NOT_FOUND: "TRANSFORM_REF_NOT_FOUND";
+    readonly GEOMETRY_TRANSFORM_REF_NOT_FOUND: "GEOMETRY_TRANSFORM_REF_NOT_FOUND";
+    readonly STYLE_REF_NOT_FOUND: "STYLE_REF_NOT_FOUND";
+    readonly ANIMATION_REF_NOT_FOUND: "ANIMATION_REF_NOT_FOUND";
+    readonly BOARD_REF_NOT_FOUND: "BOARD_REF_NOT_FOUND";
+    readonly SLIDER_REF_NOT_FOUND: "SLIDER_REF_NOT_FOUND";
+    readonly TRANSFORMATION_FAILED: "TRANSFORMATION_FAILED";
+    readonly OUTPUT_VALIDATION_FAILED: "OUTPUT_VALIDATION_FAILED";
+};
+export type AdapterErrorCode = typeof AdapterErrorCode[keyof typeof AdapterErrorCode];
+/**
+ * 适配器错误
+ */
+export declare class AdapterError extends Error {
+    code: AdapterErrorCode;
+    details?: Record<string, any>;
+    constructor(code: AdapterErrorCode, message: string, details?: Record<string, any>);
+}
+/**
+ * 适配器警告
+ */
+export interface AdapterWarning {
+    code: AdapterErrorCode;
+    message: string;
+    path?: string;
+    suggestion?: string;
+}
+/**
+ * 性能统计
+ */
+export interface PerformanceStats {
+    totalTime: number;
+    referenceResolutionTime: number;
+    transformationTime: number;
+    validationTime: number;
+    memoryUsage: number;
+    referenceCount: number;
+}
+/**
+ * 适配器结果
+ */
+export interface AdapterResult {
+    /** 解析后的标准数据 */
+    data: any;
+    /** 警告信息列表 */
+    warnings: AdapterWarning[];
+    /** 性能统计 */
+    performance?: PerformanceStats;
+    /** 引用解析统计 */
+    referenceStats: {
+        total: number;
+        resolved: number;
+        failed: number;
+        byType: {
+            [key: string]: {
+                total: number;
+                resolved: number;
+                failed: number;
+            };
+        };
+    };
+}
+/**
+ * 同步适配器配置
+ */
+export interface SyncAdapterConfig {
+    /** 是否启用严格模式（错误时抛出异常） */
+    strictMode?: boolean;
+    /** 是否启用详细日志 */
+    enableLogging?: boolean;
+    /** 验证级别 */
+    validationLevel?: 'none' | 'basic' | 'strict';
+    /** 错误时是否回退到默认数据 */
+    fallbackOnError?: boolean;
+    /** 是否启用引用解析 */
+    enableReferenceResolution?: boolean;
+    /** 是否启用组件契约验证 */
+    enableComponentContractValidation?: boolean;
+    /** 最大引用解析深度 */
+    maxReferenceDepth?: number;
+    /** 是否启用性能监控 */
+    enablePerformanceMonitoring?: boolean;
+}
+/**
+ * MathCardV2 数学练习问题数据 - 基于MathPracticeSessionTypes
+ */
+export interface MathPracticeProblemData {
+    id: string;
+    title: string;
+    grade: number;
+    unit: string;
+    lesson: string;
+    skill: string;
+    objective: string;
+    knowledgePoints: string[];
+    difficulty: number;
+    metadata: ProblemMetadata;
+    description?: string;
+    basicInfo: {
+        question: string;
+        answerUnit?: string;
+        areaUnit?: string;
+        shape?: string;
+        base?: number;
+        height?: number;
+        baseUnit?: string;
+        heightUnit?: string;
+        score?: number;
+        variables?: Record<string, any>;
+        context?: {
+            learning_objective?: string;
+            prerequisite_skills?: string[];
+            time_estimate?: number;
+        };
+        length?: number;
+        width?: number;
+        lengthUnit?: string;
+        widthUnit?: string;
+    };
+    scenes: {
+        question: {
+            items: ContentBlock[];
+            layout?: {
+                type?: string;
+                spacing?: string;
+                alignment?: string;
+            };
+        };
+        solve: {
+            items: ContentBlock[];
+            layout?: {
+                type?: string;
+                spacing?: string;
+                alignment?: string;
+                cardStyle?: {
+                    backgroundColor?: string;
+                    borderColor?: string;
+                    borderWidth?: string;
+                };
+            };
+        };
+        review: {
+            items: ContentBlock[];
+            layout?: {
+                type?: string;
+                spacing?: string;
+                alignment?: string;
+            };
+        };
+        remember?: {
+            items: ContentBlock[];
+            layout?: {
+                type?: string;
+                spacing?: string;
+                alignment?: string;
+                cardStyle?: {
+                    backgroundColor?: string;
+                    borderColor?: string;
+                    borderWidth?: string;
+                };
+            };
+        };
+    };
+    explanation: ExplanationData | ExplanationStep[];
+    answer: {
+        value: number;
+        unit: string;
+        explanation: string;
+    };
+    answer_info?: AnswerInfo;
+    math_prob_id?: string;
+    grade_id?: string;
+    unit_id?: number;
+    lesson_id?: number;
+    module_id?: number;
+    skill_item_id?: string;
+    skill_id?: number;
+    created_at?: string;
+    updated_at?: string;
+    layout?: {
+        type?: string;
+        padding?: string;
+        theme?: string;
+        renderer?: Record<string, any>;
+    };
+}
+/**
+ * 类型守卫：检查是否为V4数据
+ */
+export declare function isV4Data(data: any): data is V4MathGeometryProblemData;
+/**
+ * 类型守卫：检查是否为几何变换内容
+ */
+export declare function isGeometryTransformContent(content: ContentBlock): content is GeometryTransformContent;
+/**
+ * 类型守卫：检查是否为设计令牌引用
+ */
+export declare function isDesignTokenRef(ref: string): ref is DesignTokenRef;
+/**
+ * 类型守卫：检查是否为几何引用
+ */
+export declare function isGeometryRef(ref: string): ref is GeometryRef;
+/**
+ * 类型守卫：检查是否为变换引用
+ */
+export declare function isTransformRef(ref: string): ref is TransformRef;
+/**
+ * 类型守卫：检查是否为几何变换引用
+ */
+export declare function isGeometryTransformRef(ref: string): ref is GeometryTransformRef;
+/**
+ * 提取引用类型
+ */
+export declare function extractReferenceType(ref: string): ReferenceType | null;
+/**
+ * 创建引用对象
+ */
+export declare function createReferenceObject(ref: string): ReferenceObject | null;
+/**
+ * 标准化解释数据：将任何格式转换为标准ExplanationData对象
+ */
+export declare function normalizeExplanation(explanation: ExplanationData | ExplanationStep[] | any[]): ExplanationData;
+/**
+ * 原始几何问题数据接口 (V4 格式) - 适配器使用的原始类型
+ * @deprecated 使用V4MathGeometryProblemData替代
+ */
+export interface LegacyGeometryProblemDataV4 extends Omit<V4MathGeometryProblemData, 'geometry_shapes' | 'transform_definitions' | 'scenes' | 'explanation'> {
+    /** 几何形状定义 */
+    geometry_shapes: Record<string, any>;
+    /** 变换定义 */
+    transform_definitions: Record<string, any>;
+    /** 场景内容 */
+    scenes: Record<string, {
+        content?: any[];
+        items?: any[];
+        layout?: any;
+    }>;
+    /** 解释内容 */
+    explanation: any;
+}
+//# sourceMappingURL=geometry-types.d.ts.map