@mathwiz/ui-components 0.1.17 → 0.1.22

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

@@ -0,0 +1,106 @@
+/**
+ * TriangleAdapterV3 - 同步数据适配器
+ *
+ * 零网络依赖、完全同步的技术路线，确保数据转换稳定可靠。
+ * 替代现有异步适配器 triangleDataAdapterV2。
+ */
+export * from './core';
+export * from './bridge';
+export * from './types';
+export * from './constants';
+export * from './config';
+export * from './resolvers';
+export * from './transformers';
+export * from './validators';
+export * from './utils';
+/**
+ * 同步适配三角形数据（主函数）
+ *
+ * @param inputData 原始三角形问题数据
+ * @param config 适配器配置
+ * @returns 适配后的 MathPracticeProblemData
+ */
+export { adaptTriangleDataSync } from './core';
+/**
+ * 异步适配三角形数据（兼容接口）
+ *
+ * @param inputData 原始三角形问题数据
+ * @param config 适配器配置
+ * @returns Promise<MathPracticeProblemData>
+ */
+export { adaptTriangleDataAsync } from './bridge';
+export { adaptTriangleDataSync as adaptTriangleDataV3 } from './core';
+export { adaptTriangleDataAsync as adaptTriangleData } from './bridge';
+/**
+ * 同步加载三角形问题数据
+ */
+export { loadTriangleProblemDataSync } from './core';
+/**
+ * 异步加载三角形问题数据（兼容接口）
+ */
+export { loadTriangleProblemDataAsync } from './bridge';
+export { loadTriangleProblemDataSync as loadTriangleProblemDataV3 } from './core';
+export { loadTriangleProblemDataAsync as loadTriangleProblemData } from './bridge';
+/**
+ * 创建同步适配器
+ */
+export { createSyncAdapter } from './core';
+/**
+ * 创建异步适配器（兼容接口）
+ */
+export { createAsyncAdapter } from './bridge';
+export { createAsyncAdapter as createTriangleDataAdapter } from './bridge';
+/**
+ * 从V2迁移到V3
+ */
+export { migrateFromV2Adapter } from './bridge';
+/**
+ * 自动选择适配器
+ */
+export { autoSelectAdapter } from './bridge';
+/**
+ * 验证数据格式
+ */
+export { validateTriangleData } from './core';
+/**
+ * 性能测试
+ */
+export { benchmarkAdapter } from './core';
+/**
+ * 默认导出（兼容现有导入方式）
+ */
+import { triangleDataAdapterV3 } from './bridge';
+export default triangleDataAdapterV3;
+export declare const VERSION = "3.0.0";
+export declare const SCHEMA_VERSION = "2.0.0";
+/**
+ * 检查兼容性
+ */
+export declare function checkCompatibility(expectedVersion?: string): boolean;
+/**
+ * 使用示例：
+ *
+ * ```typescript
+ * // 方式1：同步适配（推荐）
+ * import { adaptTriangleDataSync } from '@mathwiz/ui-components/data/TriangleAdapterV3';
+ * const data = adaptTriangleDataSync(rawData, { strictMode: false });
+ *
+ * // 方式2：异步适配（兼容现有代码）
+ * import { adaptTriangleDataAsync } from '@mathwiz/ui-components/data/TriangleAdapterV3';
+ * const data = await adaptTriangleDataAsync(rawData);
+ *
+ * // 方式3：使用默认适配器
+ * import triangleAdapter from '@mathwiz/ui-components/data/TriangleAdapterV3';
+ * const data = await triangleAdapter.adapt(rawData);
+ *
+ * // 方式4：验证数据
+ * import { validateTriangleData } from '@mathwiz/ui-components/data/TriangleAdapterV3';
+ * const validation = validateTriangleData(rawData, 'input');
+ * if (validation.isValid) {
+ *   console.log('数据格式正确');
+ * }
+ * ```
+ */
+export { TriangleAdapterV3Demo } from './TriangleAdapterV3Demo';
+export type { RawTriangleProblemData, MathPracticeProblemData, SyncAdapterConfig, AdapterResult, AdapterError, AdapterWarning, AdapterErrorCode, ReferenceContext, ReferenceType, ReferenceResolution, PerformanceMark, PerformanceStats } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/TriangleAdapterV3/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAMxB;;;;;;GAMG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAE/C;;;;;;GAMG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGlD,OAAO,EAAE,qBAAqB,IAAI,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAE,sBAAsB,IAAI,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMvE;;GAEG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAErD;;GAEG;AACH,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,2BAA2B,IAAI,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAClF,OAAO,EAAE,4BAA4B,IAAI,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAMnF;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3C;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,kBAAkB,IAAI,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAM3E;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM7C;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAE9C;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAM1C;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,eAAe,qBAAqB,CAAC;AAMrC,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,GAAE,MAAgB,GAAG,OAAO,CAE7E;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,YAAY,EAEV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAGhB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EAGnB,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC"}

package/dist/data/TriangleAdapterV3/resolvers/animationRefResolver.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 动画引用解析器
+ *
+ * 解析 animationRef:xxx 等动画配置引用
+ * 支持从 animation_configs 中加载和解析动画配置
+ */
+import type { ReferenceContext } from '../types';
+import type { AnimationConfig } from '../../../components/MathGraph/animation.types';
+/**
+ * 动画引用解析器
+ */
+export declare class AnimationRefResolver {
+    /**
+     * 检查是否能够解析该引用
+     * 只接受明确的 animationRef:xxx 格式，拒绝简单的标识符
+     */
+    static canResolve(ref: string): boolean;
+    /**
+     * 解析动画引用
+     *
+     * @param ref - 动画引用字符串（如 "animationRef:double_rotation_proof"）
+     * @param context - 引用解析上下文，包含 animation_configs
+     * @returns 解析后的 AnimationConfig
+     * @throws 当引用格式无效或动画配置未找到时抛出错误
+     */
+    static resolve(ref: string, context: ReferenceContext): AnimationConfig;
+    /**
+     * 解析并转换动画配置
+     *
+     * 处理原始配置中的函数字符串，将其转换为可执行函数
+     *
+     * @param animationId - 动画配置 ID
+     * @param rawConfig - 原始动画配置（可能包含函数字符串）
+     * @param context - 引用解析上下文
+     * @returns 解析后的 AnimationConfig
+     */
+    private static resolveAnimationConfig;
+    /**
+     * 验证动画引用是否能够被解析
+     *
+     * @param ref - 动画引用字符串
+     * @param context - 引用解析上下文
+     * @returns 是否能够解析
+     */
+    static validate(ref: string, context: ReferenceContext): boolean;
+    /**
+     * 批量解析多个动画引用
+     *
+     * @param refs - 动画引用字符串数组
+     * @param context - 引用解析上下文
+     * @returns 解析结果映射表
+     */
+    static batchResolve(refs: string[], context: ReferenceContext): Record<string, AnimationConfig>;
+    /**
+     * 从内容块中提取动画引用
+     *
+     * @param content - 内容块数组
+     * @returns 提取的动画引用字符串数组
+     */
+    static extractAnimationRefs(content: any[]): string[];
+}
+/**
+ * 动画引用解析器工厂函数
+ */
+export declare function createAnimationRefResolver(): {
+    type: "animation_ref";
+    canResolve: typeof AnimationRefResolver.canResolve;
+    resolve: typeof AnimationRefResolver.resolve;
+    validate: typeof AnimationRefResolver.validate;
+};
+//# sourceMappingURL=animationRefResolver.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/animationRefResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationRefResolver.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/animationRefResolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,OAAO,KAAK,EAAE,eAAe,EAA0C,MAAM,+CAA+C,CAAC;AAM7H;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUvC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,eAAe;IAoCvE;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA2FrC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAwBhE;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAiB/F;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;CAgCtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B;;;;;EAOzC"}

package/dist/data/TriangleAdapterV3/resolvers/designTokenResolver.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 设计令牌解析器
+ *
+ * 解析 $colors.primary 等设计令牌引用
+ */
+import type { ReferenceContext } from '../types';
+/**
+ * 设计令牌解析器
+ */
+export declare class DesignTokenResolver {
+    /**
+     * 检查是否能够解析该引用
+     */
+    static canResolve(ref: string): boolean;
+    /**
+     * 解析设计令牌引用
+     */
+    static resolve(ref: string, context: ReferenceContext): any;
+    /**
+     * 根据路径解析令牌值
+     */
+    private static resolvePath;
+    /**
+     * 批量解析设计令牌引用
+     */
+    static batchResolve(refs: string[], context: ReferenceContext): Record<string, any>;
+    /**
+     * 提取对象中的所有设计令牌引用
+     */
+    static extractDesignTokenRefs(obj: any): string[];
+    /**
+     * 替换对象中的设计令牌引用
+     */
+    static replaceDesignTokenRefs(obj: any, context: ReferenceContext, onMissing?: (ref: string) => any): any;
+}
+/**
+ * 设计令牌解析器工厂函数
+ */
+export declare function createDesignTokenResolver(): {
+    type: "design_token";
+    canResolve: typeof DesignTokenResolver.canResolve;
+    resolve: typeof DesignTokenResolver.resolve;
+};
+//# sourceMappingURL=designTokenResolver.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/designTokenResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designTokenResolver.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/designTokenResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG;IAU3D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAuB1B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiBnF;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE;IAmBjD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,GAC/B,GAAG;CAsEP;AAED;;GAEG;AACH,wBAAgB,yBAAyB;;;;EAMxC"}

package/dist/data/TriangleAdapterV3/resolvers/geometryRefResolver.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 几何引用解析器
+ *
+ * 解析 geometryRef:acute_triangle 等几何引用
+ */
+import type { ReferenceContext } from '../types';
+/**
+ * 几何引用解析器
+ */
+export declare class GeometryRefResolver {
+    /**
+     * 检查是否能够解析该引用
+     */
+    static canResolve(ref: string, context?: ReferenceContext): boolean;
+    /**
+     * 解析顶点引用（$ref 格式）
+     */
+    private static resolveVertexReference;
+    /**
+     * 解析几何引用
+     */
+    static resolve(ref: string, context: ReferenceContext): any;
+    /**
+     * 验证几何引用是否存在
+     */
+    static validate(ref: string, context: ReferenceContext): boolean;
+    /**
+     * 获取所有可用的几何预设名称
+     */
+    static getAvailableGeometryNames(context: ReferenceContext): string[];
+    /**
+     * 解析几何引用并应用样式（如果几何中包含styleRef）
+     */
+    static resolveWithStyle(ref: string, context: ReferenceContext): any;
+    /**
+     * 批量解析几何引用
+     */
+    static batchResolve(refs: string[], context: ReferenceContext): Record<string, any>;
+    /**
+     * 从内容块中提取几何引用
+     */
+    static extractGeometryRefs(content: any[]): string[];
+}
+/**
+ * 几何引用解析器工厂函数
+ */
+export declare function createGeometryRefResolver(): {
+    type: "geometry_ref";
+    canResolve: typeof GeometryRefResolver.canResolve;
+    resolve: typeof GeometryRefResolver.resolve;
+    validate: typeof GeometryRefResolver.validate;
+};
+//# sourceMappingURL=geometryRefResolver.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/geometryRefResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryRefResolver.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/geometryRefResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO;IAuDnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAsCrC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG;IA6F3D;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAmBhE;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAIrE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG;IAepE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAgBnF;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;CAmCrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB;;;;;EAOxC"}

package/dist/data/TriangleAdapterV3/resolvers/geometryTransformRefResolver.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 几何变换引用解析器
+ *
+ * 解析 geometryTransformRef 引用，从配置定义中加载完整几何变换参数
+ */
+import { type ReferenceContext, type GeometryTransformConfig } from '../types';
+/**
+ * 几何变换引用解析器
+ */
+export declare class GeometryTransformRefResolver {
+    /**
+     * 检查是否能够解析该引用
+     */
+    static canResolve(ref: string): boolean;
+    /**
+     * 解析几何变换引用
+     */
+    static resolve(ref: string, context: ReferenceContext, override?: Partial<GeometryTransformConfig>): GeometryTransformConfig;
+    /**
+     * 应用覆盖配置
+     */
+    private static applyOverride;
+    /**
+     * 验证几何变换引用是否存在
+     */
+    static validate(ref: string, context: ReferenceContext): boolean;
+    /**
+     * 批量解析几何变换引用
+     */
+    static batchResolve(refs: string[], context: ReferenceContext, overrides?: Record<string, Partial<GeometryTransformConfig>>): Record<string, GeometryTransformConfig>;
+    /**
+     * 从内容块中提取几何变换引用
+     */
+    static extractFromContentBlock(contentBlock: any): string | null;
+    /**
+     * 提取多个内容块中的引用
+     */
+    static extractFromContentBlocks(blocks: any[]): string[];
+}
+/**
+ * 创建几何变换引用解析器实例
+ */
+export declare function createGeometryTransformRefResolver(): {
+    type: "geometry_transform_ref";
+    canResolve: typeof GeometryTransformRefResolver.canResolve;
+    resolve: typeof GeometryTransformRefResolver.resolve;
+    validate: typeof GeometryTransformRefResolver.validate;
+};
+//# sourceMappingURL=geometryTransformRefResolver.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/geometryTransformRefResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryTransformRefResolver.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/geometryTransformRefResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAiD,MAAM,UAAU,CAAC;AAG9H;;GAEG;AACH,qBAAa,4BAA4B;IACvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYvC;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,EACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC1C,uBAAuB;IAsC1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAsC5B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAehE;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC,GAC3D,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC;IAiB1C;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,YAAY,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAYhE;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;CAYzD;AAED;;GAEG;AACH,wBAAgB,kCAAkC;;;;;EAOjD"}

package/dist/data/TriangleAdapterV3/resolvers/index.d.ts

@@ -0,0 +1,101 @@
+/**
+ * TriangleAdapterV3 解析器模块导出
+ */
+import type { ReferenceContext } from '../types';
+import { ReferenceType } from '../types';
+import type { ExtractedReference } from './referenceExtractor';
+export * from './designTokenResolver';
+export * from './geometryRefResolver';
+export * from './transformRefResolver';
+export * from './styleRefResolver';
+export * from './layoutRefResolver';
+export * from './animationRefResolver';
+export * from './sliderRefResolver';
+export * from './geometryTransformRefResolver';
+export * from './referenceExtractor';
+export interface Resolver {
+    type: ReferenceType;
+    canResolve(ref: string): boolean;
+    resolve(ref: string, context: ReferenceContext): any;
+    validate?(ref: string, context: ReferenceContext): boolean;
+}
+/**
+ * 可解析的引用类型（支持字符串和结构化数据）
+ */
+export type ResolvableReference = string | ExtractedReference;
+/**
+ * 解析器注册表
+ */
+export declare class ResolverRegistry {
+    private resolvers;
+    constructor();
+    /**
+     * 注册默认解析器
+     */
+    private registerDefaultResolvers;
+    /**
+     * 注册解析器
+     */
+    register(resolver: Resolver): void;
+    /**
+     * 获取所有解析器
+     */
+    getAllResolvers(): Resolver[];
+    /**
+     * 根据引用类型获取解析器
+     */
+    getResolverByType(type: ReferenceType): Resolver | undefined;
+    /**
+     * 根据引用字符串获取解析器
+     */
+    getResolverForRef(ref: string): Resolver | undefined;
+    /**
+     * 解析单个引用（支持字符串和结构化数据）
+     *
+     * 策略：
+     * - 如果是 ExtractedReference：直接使用其类型信息，精确解析
+     * - 如果是字符串：尝试所有声明可以解析的解析器（向后兼容）
+     * 如果一个解析器抛出错误，继续尝试下一个
+     */
+    resolve(ref: ResolvableReference, context: ReferenceContext): any;
+    /**
+     * 批量解析引用（支持结构化数据）
+     */
+    batchResolve(refs: ResolvableReference[], context: ReferenceContext): Record<string, any>;
+    /**
+     * 提取对象中的所有引用（新方法 - 返回结构化数据）
+     *
+     * 使用 ReferenceExtractor，基于直接的字段名匹配
+     * 性能更好，代码更简洁，易于维护
+     *
+     * @param obj - 要提取引用的对象
+     * @returns 结构化引用数组（包含字段上下文）
+     */
+    extractAllRefsEnhanced(obj: any): ExtractedReference[];
+    /**
+     * 提取对象中的所有引用（向后兼容）
+     *
+     * 返回传统的字符串数组，用于兼容现有代码
+     *
+     * @param obj - 要提取引用的对象
+     * @returns 引用数组（去重，格式如 ["animationRef:value1", ...]）
+     */
+    extractAllRefs(obj: any): string[];
+    /**
+     * 提取对象中的所有引用（旧方法 - 仅用于性能测试对比）
+     *
+     * @deprecated 此方法仅用于性能测试对比，生产代码应使用 extractAllRefsEnhanced()
+     * @param obj - 要提取引用的对象
+     * @returns 引用数组（去重）
+     */
+    extractAllRefsLegacy(obj: any): string[];
+    /**
+     * 验证引用是否存在
+     */
+    validate(ref: string, context: ReferenceContext): boolean;
+}
+/**
+ * 创建默认解析器注册表
+ */
+export declare function createDefaultResolverRegistry(): ResolverRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY/D,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AAGrC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG,CAAC;IACrD,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE9D;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAkB;;IAMnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIlC;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAI7B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS;IAI5D;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIpD;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG;IA2CjE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAmBzF;;;;;;;;OAQG;IACH,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,EAAE;IAWtD;;;;;;;OAOG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE;IAKlC;;;;;;OAMG;IACH,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE;IA8BxC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;CAkB1D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAEhE"}

package/dist/data/TriangleAdapterV3/resolvers/layoutRefResolver.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 布局引用解析器
+ *
+ * 解析 layoutRef:card 等布局引用
+ */
+import type { ReferenceContext } from '../types';
+/**
+ * 布局引用解析器
+ */
+export declare class LayoutRefResolver {
+    /**
+     * 检查是否能够解析该引用
+     */
+    static canResolve(ref: string): boolean;
+    /**
+     * 解析布局引用
+     */
+    static resolve(ref: string, context: ReferenceContext): any;
+    /**
+     * 解析布局预设，处理其中的设计令牌引用
+     */
+    private static resolveLayoutPreset;
+    /**
+     * 验证布局引用是否存在
+     */
+    static validate(ref: string, context: ReferenceContext): boolean;
+    /**
+     * 应用布局到场景配置
+     */
+    static applyLayout(sceneConfig: any, layout: any): any;
+    /**
+     * 批量解析布局引用
+     */
+    static batchResolve(refs: string[], context: ReferenceContext): Record<string, any>;
+    /**
+     * 从场景配置中提取布局引用
+     */
+    static extractLayoutRefs(scenes: Record<string, any>): string[];
+    /**
+     * 检查字符串是否为布局引用
+     */
+    private static isLayoutRef;
+    /**
+     * 创建默认布局（当布局引用未找到时使用）
+     */
+    static createDefaultLayout(): any;
+}
+/**
+ * 布局引用解析器工厂函数
+ */
+export declare function createLayoutRefResolver(): {
+    type: "layout_ref";
+    canResolve: typeof LayoutRefResolver.canResolve;
+    resolve: typeof LayoutRefResolver.resolve;
+    validate: typeof LayoutRefResolver.validate;
+};
+//# sourceMappingURL=layoutRefResolver.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/layoutRefResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutRefResolver.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/layoutRefResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAqBvC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,GAAG;IAmC3D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyBlC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAyBhE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG;IAiBtD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAgBnF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,EAAE;IAwB/D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,GAAG;CAOlC;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;;;;EAOtC"}

package/dist/data/TriangleAdapterV3/resolvers/referenceExtractor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 引用提取器
+ *
+ * 基于显式字段名的引用提取算法
+ * 优点：直接、简洁、通用、可维护
+ */
+import { ReferenceType } from '../types';
+export interface ExtractedReference {
+    ref: string;
+    type: ReferenceType;
+    path?: string;
+}
+/**
+ * 提取的引用（结构化数据）
+ *
+ * 包含完整的字段上下文信息，避免引用类型误判
+ */
+export interface ExtractedReference {
+    /** 引用值（如 "double_rotation_proof"） */
+    value: string;
+    /** 字段名（如 "animationRef"） */
+    fieldName: string;
+    /** 解析器类型（由 fieldName 映射得到） */
+    type: ReferenceType;
+    /** 组合字符串（向下兼容，如 "animationRef:double_rotation_proof"） */
+    combined: string;
+}
+/**
+ * 核心引用字段映射
+ *
+ * 键：JSON 中的字段名
+ * 值：对应的解析器类型
+ *
+ * 设计原则：
+ * 1. 显式优于隐式：字段名就是引用字段，不需要猜测
+ * 2. 一一对应：每个字段有且只有一个解析器负责
+ * 3. 静态配置：编译时确定，运行时不变
+ * 4. 易于扩展：添加新字段只需修改这里
+ */
+export declare const REFERENCE_FIELD_MAP: Record<string, ReferenceType>;
+/**
+ * 引用提取器
+ *
+ * 专门负责从 JSON 数据中提取引用字段的工具类
+ */
+export declare class ReferenceExtractor {
+    /**
+     * 提取对象中的所有引用（结构化数据）
+     *
+     * 算法：
+     * 1. 遍历对象树（深度优先）
+     * 2. 检查每个字段名是否在 REFERENCE_FIELD_MAP 中
+     * 3. 如果是，创建结构化引用对象
+     * 4. 去重后返回
+     *
+     * 优点：
+     * - 保留字段上下文：value + fieldName + type
+     * - 避免引用类型误判
+     * - 向后兼容：combined 字段可用于现有代码
+     *
+     * @param obj - 要提取引用的对象
+     * @returns 结构化引用数组
+     */
+    static extractRefs(obj: any): ExtractedReference[];
+    /**
+     * 提取字符串中的设计令牌
+     *
+     * 示例：
+     * - "$colors.success" → ["$colors.success"]
+     * - "prefix-$spacing.large-suffix" → ["$spacing.large"]
+     *
+     * 模式：$xxx.yyy（如 $colors.primary, $fonts.label, $spacing.large）
+     *
+     * @param str - 要解析的字符串
+     * @returns 设计令牌数组
+     */
+    private static extractDesignTokens;
+    /**
+     * 计算引用指标（用于调试和监控）
+     *
+     * @param obj - 要分析的对象
+     * @returns 引用统计信息
+     */
+    static calculateStats(obj: any): {
+        totalRefs: number;
+        uniqueRefs: number;
+        fieldCounts: Record<string, number>;
+    };
+}
+/**
+ * 快速提取助手函数（向后兼容）
+ *
+ * 返回传统的字符串数组（如 ["animationRef:value1", "geometryRef:value2"]）
+ * 用于兼容现有代码
+ */
+export declare function extractAllReferences(obj: any): string[];
+/**
+ * 提取结构化引用（新API）
+ *
+ * 返回完整的结构化数据，包含字段上下文
+ * 推荐用于新代码
+ */
+export declare function extractAllReferencesEnhanced(obj: any): ExtractedReference[];
+//# sourceMappingURL=referenceExtractor.d.ts.map

package/dist/data/TriangleAdapterV3/resolvers/referenceExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceExtractor.d.ts","sourceRoot":"","sources":["../../../../src/data/TriangleAdapterV3/resolvers/referenceExtractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CA8B7D,CAAC;AAEF;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,EAAE;IA0ElD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAkBlC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC;CA0BF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,GAAG,GAAG,kBAAkB,EAAE,CAE3E"}