@mathwiz/ui-components 0.1.17 → 0.1.22

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

@@ -0,0 +1,92 @@
+/**
+ * GeometryProblemAdapterV4 - 统一几何问题适配器
+ *
+ * 基于 TriangleAdapterV3 重构的通用几何问题适配器。
+ * 支持三角形、梯形、平行四边形等多种几何形状的 V4 格式数据。
+ */
+export * from './GeometryAdapterCore';
+export * from './types';
+import { GeometryAdapterCore } from './GeometryAdapterCore';
+import type { GeometryProblemDataV4, SyncAdapterConfig, AdapterResult } from './types';
+/**
+ * 同步适配几何问题数据（主函数）
+ *
+ * @param inputData 原始几何问题数据 (V4格式)
+ * @param config 适配器配置
+ * @returns 适配后的 MathPracticeProblemData
+ */
+export declare function adaptGeometryDataSync(inputData: GeometryProblemDataV4, config?: SyncAdapterConfig): AdapterResult;
+/**
+ * 异步适配几何问题数据（兼容接口）
+ *
+ * @param inputData 原始几何问题数据 (V4格式)
+ * @param config 适配器配置
+ * @returns Promise<AdapterResult>
+ */
+export declare function adaptGeometryDataAsync(inputData: GeometryProblemDataV4, config?: SyncAdapterConfig): Promise<AdapterResult>;
+export { adaptGeometryDataSync as adaptGeometryDataV4 };
+export { adaptGeometryDataAsync as adaptGeometryData };
+/**
+ * 同步加载几何问题数据
+ */
+export declare function loadGeometryProblemDataSync(dataSource: GeometryProblemDataV4 | (() => GeometryProblemDataV4), config?: SyncAdapterConfig): AdapterResult;
+/**
+ * 异步加载几何问题数据（兼容接口）
+ */
+export declare function loadGeometryProblemDataAsync(dataSource: GeometryProblemDataV4 | (() => GeometryProblemDataV4) | Promise<GeometryProblemDataV4>, config?: SyncAdapterConfig): Promise<AdapterResult>;
+export { loadGeometryProblemDataSync as loadGeometryProblemDataV4 };
+export { loadGeometryProblemDataAsync as loadGeometryProblemData };
+/**
+ * 创建同步适配器
+ */
+export declare function createSyncAdapter(config?: SyncAdapterConfig): GeometryAdapterCore;
+/**
+ * 创建异步适配器（兼容接口）
+ */
+export declare function createAsyncAdapter(config?: SyncAdapterConfig): {
+    adapt: (data: GeometryProblemDataV4) => Promise<AdapterResult>;
+};
+export { createAsyncAdapter as createGeometryDataAdapter };
+export { ValidationManager } from '../TriangleAdapterV3/validators';
+/**
+ * 验证数据格式
+ */
+export declare function validateGeometryData(data: any, type?: 'input' | 'output'): {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * 性能测试
+ */
+export declare function benchmarkAdapter(adapter: GeometryAdapterCore, testData: GeometryProblemDataV4, iterations?: number): {
+    averageTime: number;
+    minTime: number;
+    maxTime: number;
+    memoryUsage: number;
+};
+/**
+ * 默认导出（兼容现有导入方式）
+ */
+declare const geometryAdapterV4: {
+    adapt: (data: GeometryProblemDataV4, config?: SyncAdapterConfig) => AdapterResult;
+    adaptAsync: (data: GeometryProblemDataV4, config?: SyncAdapterConfig) => Promise<AdapterResult>;
+    create: (config?: SyncAdapterConfig) => GeometryAdapterCore;
+};
+export default geometryAdapterV4;
+export declare const VERSION = "4.0.0";
+export declare const SCHEMA_VERSION = "4.0.0";
+/**
+ * 检查兼容性
+ */
+export declare function checkCompatibility(expectedVersion?: string): boolean;
+/**
+ * 检查是否为V4格式数据
+ */
+export declare function isV4Format(data: any): boolean;
+/**
+ * 检查是否为几何问题数据
+ */
+export declare function isGeometryProblem(data: any): boolean;
+export type { GeometryProblemDataV4, MathPracticeProblemData, SyncAdapterConfig, AdapterResult, AdapterError, AdapterWarning, AdapterErrorCode, GeometryShapeType, ReferenceContext, ReferenceType, ReferenceResolution, PerformanceMark, PerformanceStats } from './types';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/data/GeometryProblemAdapterV4/jsondata/age-problem-compatible.json

@@ -0,0 +1,203 @@
+{
+  "id": "age-word-problem-001",
+  "title": "年龄倍数问题",
+  "grade": 4,
+  "unit": "应用题",
+  "lesson": "年龄倍数问题",
+  "skill": "年龄差计算和倍数关系",
+  "objective": "理解年龄问题中的不变量原理",
+  "knowledgePoints": [
+    "年龄差不变原理",
+    "倍数关系分析",
+    "代数方程建立"
+  ],
+  "difficulty": 3,
+  "metadata": {
+    "topic": "应用题",
+    "skill": "年龄问题",
+    "tags": ["年龄差", "倍数", "代数"]
+  },
+  "description": "解决年龄问题的关键，是找到那个永远不会变的量：年龄差",
+  "basicInfo": {
+    "question": "今年小明12岁，妈妈36岁。请问几年后，妈妈的年龄是小明的2倍？",
+    "answerUnit": "年后"
+  },
+  "scenes": {
+    "question": {
+      "content": [
+        {
+          "type": "text",
+          "content": "今年小明12岁，妈妈36岁。请问几年后，妈妈的年龄是小明的2倍？",
+          "style": {
+            "fontSize": "1.5rem",
+            "color": "#1e293b"
+          }
+        }
+      ]
+    },
+    "solve": {
+      "content": [
+        {
+          "type": "text",
+          "content": "解题步骤：",
+          "style": {
+            "fontSize": "1.25rem",
+            "fontWeight": "bold",
+            "color": "#1e293b"
+          }
+        },
+        {
+          "type": "text",
+          "content": "1. 找出不变的'年龄差'：36 - 12 = 24岁"
+        },
+        {
+          "type": "text",
+          "content": "2. 未来妈妈的年龄是小明的2倍，年龄差正好是未来小明的年龄（1份）"
+        },
+        {
+          "type": "text",
+          "content": "3. 未来小明的年龄就是24岁"
+        },
+        {
+          "type": "text",
+          "content": "4. 需要的年数：24 - 12 = 12年"
+        }
+      ]
+    },
+    "review": {
+      "content": [
+        {
+          "type": "text",
+          "content": "核心概念回顾：",
+          "style": {
+            "fontSize": "1.25rem",
+            "fontWeight": "bold",
+            "color": "#1e293b"
+          }
+        },
+        {
+          "type": "text",
+          "content": "解决年龄问题的关键是找到不变量：年龄差",
+          "style": { "marginTop": "8px" }
+        },
+        {
+          "type": "formula",
+          "content": "妈妈年龄 - 小明年龄 = 年龄差 (永远不变)",
+          "style": { "color": "#64748b" }
+        }
+      ]
+    }
+  },
+  "explanation": [
+    {
+      "id": "exp-step-1",
+      "type": "instructionalStep",
+      "content": {
+        "title": "第一步：找到'年龄差'这个不变量",
+        "description": "首先，我们计算出小明和妈妈当前的年龄差。无论过了多少年，这个差值是永远不变的！<br>计算：36 - 12 = <strong>24岁</strong>",
+        "chartConfig": {
+          "type": "graph",
+          "boundingBox": [-5, 50, 50, -5],
+          "showGrid": false,
+          "showAxis": false,
+          "shapes": [
+            { "id": "xiaomingLabel", "type": "text", "position": { "x": -4, "y": 30 }, "content": "小明 (现在)", "fontSize": 14 },
+            { "id": "xiaomingLine", "type": "line", "start": { "x": 0, "y": 30 }, "end": { "x": 12, "y": 30 }, "strokeColor": "#3B82F6", "strokeWidth": 5, "name": "12岁" },
+            { "id": "motherLabel", "type": "text", "position": { "x": -4, "y": 15 }, "content": "妈妈 (现在)", "fontSize": 14 },
+            { "id": "motherLine", "type": "line", "start": { "x": 0, "y": 15 }, "end": { "x": 36, "y": 15 }, "strokeColor": "#F59E0B", "strokeWidth": 5, "name": "36岁" },
+            { "id": "diffLine", "type": "line", "start": { "x": 12, "y": 15 }, "end": { "x": 36, "y": 15 }, "strokeColor": "#EF4444", "strokeWidth": 3, "name": "年龄差: 24岁" },
+            { "id": "dashLine", "type": "line", "start": { "x": 12, "y": 16 }, "end": { "x": 12, "y": 29 }, "strokeColor": "#CCC", "strokeWidth": 1, "dash": 2 },
+            { "id": "diffLabel", "type": "text", "position": { "x": 24, "y": 10 }, "content": "年龄差 = 24岁", "fontSize": 14, "color": "#EF4444" }
+          ]
+        }
+      }
+    },
+    {
+      "id": "exp-step-2",
+      "type": "instructionalStep",
+      "content": {
+        "title": "第二步：画出几年后'2倍'的关系",
+        "description": "未来妈妈的年龄是小明的2倍。我们将未来小明的年龄看作 <span style='color:#10B981'><strong>1份</strong></span>，妈妈的年龄就是 <span style='color:#F59E0B'><strong>2份</strong></span>。辅助虚线表示他们长大了相同的岁数。",
+        "chartConfig": {
+          "type": "graph",
+          "boundingBox": [-5, 50, 50, -5],
+          "showGrid": false,
+          "showAxis": false,
+          "shapes": [
+            { "id": "xmFutureLabel", "type": "text", "position": { "x": -4, "y": 35 }, "content": "小明 (未来)", "fontSize": 14 },
+            { "id": "xmPresentLine", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 12, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 5, "name": "12岁" },
+            { "id": "xmFutureLine", "type": "line", "start": { "x": 12, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#10B981", "strokeWidth": 5, "name": "若干年后" },
+            { "id": "xmTotalLine", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 2, "dash": 1, "name": "1份" },
+
+            { "id": "moFutureLabel", "type": "text", "position": { "x": -4, "y": 15 }, "content": "妈妈 (未来)", "fontSize": 14 },
+            { "id": "moPresentLine", "type": "line", "start": { "x": 0, "y": 15 }, "end": { "x": 36, "y": 15 }, "strokeColor": "#F59E0B", "strokeWidth": 5, "name": "36岁" },
+            { "id": "moFutureLine", "type": "line", "start": { "x": 36, "y": 15 }, "end": { "x": 48, "y": 15 }, "strokeColor": "#10B981", "strokeWidth": 5, "name": "若干年后" },
+            { "id": "moTotalLine", "type": "line", "start": { "x": 0, "y": 15 }, "end": { "x": 48, "y": 15 }, "strokeColor": "#F59E0B", "strokeWidth": 2, "dash": 1, "name": "2份" },
+
+            { "id": "futureDashLine", "type": "line", "start": { "x": 24, "y": 16 }, "end": { "x": 24, "y": 34 }, "strokeColor": "#CCC", "strokeWidth": 1, "dash": 2 },
+            { "id": "part1Label", "type": "text", "position": { "x": 12, "y": 40 }, "content": "1份", "fontSize": 14, "color": "#10B981" },
+            { "id": "part2Label", "type": "text", "position": { "x": 24, "y": 5 }, "content": "2份", "fontSize": 14, "color": "#F59E0B" }
+          ]
+        }
+      }
+    },
+    {
+      "id": "exp-step-3",
+      "type": "instructionalStep",
+      "content": {
+        "title": "第三步：结合'年龄差'和'倍数关系'",
+        "description": "关键一步！妈妈比小明多的部分（年龄差）正好等于未来小明的年龄（1份）！因为年龄差是24岁，所以未来小明的年龄就是<strong>24岁</strong>。",
+        "chartConfig": {
+          "type": "graph",
+          "boundingBox": [-5, 50, 50, -5],
+          "showGrid": false,
+          "showAxis": false,
+          "shapes": [
+            { "id": "xmFutureLabel3", "type": "text", "position": { "x": -4, "y": 35 }, "content": "小明 (未来)", "fontSize": 14 },
+            { "id": "xmPresentLine3", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 12, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 5, "name": "看作1份" },
+            { "id": "xmFutureLine3", "type": "line", "start": { "x": 12, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#10B981", "strokeWidth": 5 },
+            { "id": "xmTotalLine3", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 2, "dash": 1, "name": "1份 = 24岁" },
+
+            { "id": "moFutureLabel3", "type": "text", "position": { "x": -4, "y": 15 }, "content": "妈妈 (未来)", "fontSize": 14 },
+            { "id": "moPart1Line3", "type": "line", "start": { "x": 0, "y": 15 }, "end": { "x": 24, "y": 15 }, "strokeColor": "#3B82F6", "strokeWidth": 5, "name": "1份" },
+            { "id": "moPart2Line3", "type": "line", "start": { "x": 24, "y": 15 }, "end": { "x": 48, "y": 15 }, "strokeColor": "#EF4444", "strokeWidth": 3, "name": "1份 = 年龄差" },
+            { "id": "moTotalLine3", "type": "line", "start": { "x": 0, "y": 15 }, "end": { "x": 48, "y": 15 }, "strokeColor": "#F59E0B", "strokeWidth": 2, "dash": 1, "name": "2份 = 48岁" },
+
+            { "id": "relationDashLine3", "type": "line", "start": { "x": 24, "y": 16 }, "end": { "x": 24, "y": 34 }, "strokeColor": "#AAA", "strokeWidth": 1, "dash": 2 },
+            { "id": "ageDiffLabel3", "type": "text", "position": { "x": 36, "y": 10 }, "content": "年龄差 = 24岁", "fontSize": 14, "color": "#EF4444" }
+          ]
+        }
+      }
+    },
+    {
+      "id": "exp-step-4",
+      "type": "instructionalStep",
+      "content": {
+        "title": "第四步：计算最终答案",
+        "description": "我们已经推导出未来小明是24岁。他现在12岁，那么需要过的年数就是：<br>24 - 12 = <strong>12年</strong>。<br><strong>最终答案是12年后。</strong>",
+        "chartConfig": {
+          "type": "graph",
+          "boundingBox": [-5, 50, 50, -5],
+          "showGrid": false,
+          "showAxis": false,
+          "shapes": [
+            { "id": "xmTimelineLabel", "type": "text", "position": { "x": -1, "y": 35 }, "content": "小明年龄", "fontSize": 14 },
+            { "id": "xmPresentLine4", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 12, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 5, "name": "12岁 (现在)" },
+            { "id": "xmYearsPassedLine4", "type": "line", "start": { "x": 12, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#10B981", "strokeWidth": 5, "name": "过了？年，年龄为24岁" },
+            { "id": "xmTimelineTotal", "type": "line", "start": { "x": 0, "y": 35 }, "end": { "x": 24, "y": 35 }, "strokeColor": "#3B82F6", "strokeWidth": 2, "dash": 1, "name": "24岁 (未来)" },
+            { "id": "yearsLabel", "type": "text", "position": { "x": 18, "y": 40 }, "content": "12年", "fontSize": 16, "color": "#10B981", "fontWeight": "bold" }
+          ]
+        }
+      }
+    }
+  ],
+  "answer": {
+    "value": 12,
+    "unit": "年后",
+    "explanation": "正确答案是12年后。计算方法：首先计算年龄差 36-12=24岁。当妈妈年龄是小明2倍时，年龄差正好等于小明当时的年龄，即24岁。所以，还需要 24-12=12年。"
+  },
+  "layout": {
+    "type": "card",
+    "padding": "20px"
+  }
+}