@mathwiz/ui-components 0.1.17 → 0.1.22

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

@@ -0,0 +1,281 @@
+/**
+ * GeometryProblemAdapterV4 类型定义
+ *
+ * 基于 TriangleAdapterV3 重构的通用几何问题适配器类型定义。
+ * 支持三角形、梯形、平行四边形等多种几何形状的 V4 格式数据。
+ */
+import type { MathPracticeProblemData } from '../../components/MathCardV2/MathPracticeSessionTypes';
+/**
+ * 同步适配器配置
+ */
+export interface SyncAdapterConfig {
+    /** 是否启用严格模式（错误时抛出异常） */
+    strictMode?: boolean;
+    /** 是否启用详细日志 */
+    enableLogging?: boolean;
+    /** 验证级别 */
+    validationLevel?: 'none' | 'basic' | 'strict';
+    /** 错误时是否回退到默认数据 */
+    fallbackOnError?: boolean;
+    /** 是否启用引用解析 */
+    enableReferenceResolution?: boolean;
+    /** 是否启用组件契约验证 */
+    enableComponentContractValidation?: boolean;
+    /** 最大引用解析深度 */
+    maxReferenceDepth?: number;
+    /** 是否启用性能监控 */
+    enablePerformanceMonitoring?: boolean;
+}
+/**
+ * 默认适配器配置
+ */
+export declare const DEFAULT_SYNC_ADAPTER_CONFIG: SyncAdapterConfig;
+/**
+ * 支持的几何形状类型
+ */
+export declare const GeometryShapeType: {
+    readonly TRIANGLE: "triangle";
+    readonly ACUTE_TRIANGLE: "acute_triangle";
+    readonly RIGHT_TRIANGLE: "right_triangle";
+    readonly OBTUSE_TRIANGLE: "obtuse_triangle";
+    readonly TRAPEZOID: "trapezoid";
+    readonly PARALLELOGRAM: "parallelogram";
+    readonly RECTANGLE: "rectangle";
+    readonly SQUARE: "square";
+    readonly RHOMBUS: "rhombus";
+};
+export type GeometryShapeType = typeof GeometryShapeType[keyof typeof GeometryShapeType];
+/**
+ * 原始几何问题数据接口 (V4 格式)
+ * 对应外部JSON数据格式，支持多种几何形状
+ */
+export interface GeometryProblemDataV4 {
+    /** Schema版本，用于检测数据格式 */
+    schema_version?: string;
+    math_prob_id: string;
+    title: string;
+    grade_id: string;
+    unit_name: string;
+    lesson_name: string;
+    skill_description: string;
+    objective: string;
+    knowledge_points: string[];
+    difficulty: number;
+    description?: string;
+    metadata?: Record<string, any>;
+    /** 基础信息，包含几何参数 */
+    basic_info: {
+        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;
+        };
+    };
+    /** 几何形状定义 */
+    geometry_shapes: Record<string, any>;
+    /** 变换定义 */
+    transform_definitions: Record<string, any>;
+    /** 几何变换配置 */
+    geometry_transform_configs?: Record<string, GeometryTransformConfig>;
+    /** 动画配置 */
+    animation_configs?: Record<string, any>;
+    /** 场景内容 */
+    scenes: Record<string, {
+        content?: any[];
+        items?: any[];
+        layout?: any;
+    }>;
+    /** 解释内容 */
+    explanation: any;
+    /** 答案信息 */
+    answer_info: {
+        value: number;
+        unit: string;
+        explanation_text: string;
+    };
+    unit_id?: number;
+    lesson_id?: number;
+    module_id?: number;
+    skill_item_id?: string;
+    skill_id?: number;
+    created_at?: string;
+    updated_at?: string;
+    layout?: any;
+}
+/**
+ * 引用类型常量对象（替代枚举，兼容 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";
+};
+export type ReferenceType = typeof ReferenceType[keyof typeof ReferenceType];
+/**
+ * 几何变换配置接口
+ */
+export interface GeometryTransformConfig {
+    id: string;
+    description?: string;
+    base: number;
+    height: number;
+    unit: string;
+    strategy: string;
+    shapes: {
+        static: any[];
+        animated: any[];
+    };
+    transform: {
+        type: string;
+        transforms: any[];
+        executionMode?: string;
+    };
+    sliderRef?: string;
+    boardRef?: string;
+}
+/**
+ * 几何变换引用接口
+ */
+export interface GeometryTransformRef {
+    geometryTransformRef: string;
+    override?: Partial<GeometryTransformConfig>;
+}
+/**
+ * 引用解析上下文
+ */
+export interface ReferenceContext {
+    designTokens: Record<string, any>;
+    stylePresets: Record<string, any>;
+    geometryPresets: Record<string, any>;
+    transformDefinitions?: Record<string, any>;
+    layoutPresets?: Record<string, any>;
+    animationConfigs?: Record<string, any>;
+    boardDefinitions?: Record<string, any>;
+    geometryTransformConfigs?: Record<string, GeometryTransformConfig>;
+    basicInfo?: any;
+}
+/**
+ * 引用解析结果
+ */
+export interface ReferenceResolution {
+    type: ReferenceType;
+    path: string;
+    value: any;
+    depth: number;
+}
+/**
+ * 适配器错误代码常量对象（替代枚举，兼容 erasableSyntaxOnly）
+ */
+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 PerformanceMark {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+}
+/**
+ * 性能统计
+ */
+export interface PerformanceStats {
+    totalTime: number;
+    referenceResolutionTime: number;
+    transformationTime: number;
+    validationTime: number;
+    memoryUsage: number;
+    referenceCount: number;
+}
+/**
+ * 适配器输出结果
+ */
+export interface AdapterResult {
+    /** 解析后的标准数据 */
+    data: MathPracticeProblemData;
+    /** 警告信息列表 */
+    warnings: AdapterWarning[];
+    /** 性能统计 */
+    performance?: PerformanceStats;
+    /** 引用解析统计 */
+    referenceStats: {
+        total: number;
+        resolved: number;
+        failed: number;
+        byType: {
+            [key: string]: {
+                total: number;
+                resolved: number;
+                failed: number;
+            };
+        };
+    };
+}
+/**
+ * 严格模式检查结果
+ */
+export interface StrictCheckResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export type { MathPracticeProblemData } from '../../components/MathCardV2/MathPracticeSessionTypes';
+//# sourceMappingURL=types.d.ts.map

package/dist/data/GeometryProblemAdapterV4/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/data/GeometryProblemAdapterV4/types.ts"],"names":[],"mappings":"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"}