@mathwiz/ui-components 0.1.16 → 0.1.22

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/embeddedConfigs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddedConfigs.d.ts","sourceRoot":"","sources":["../../../../../../../src/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/embeddedConfigs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CzB,CAAC;AAMX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsIzB,CAAC;AAMX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2E5B,CAAC;AAMX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC1B,CAAC;AAMX,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8ClC,CAAC;AAMX,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DjC,CAAC;AAMX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCzB,CAAC;AAMX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQtB,CAAC"}

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/gradeResolver.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Grade 解析器
+ *
+ * 负责将 grade_id（如 'g5'）解析为年级数值（如 5）。
+ * 支持格式验证、默认值回退和错误处理。
+ */
+/**
+ * Grade ID 格式
+ * 示例: g1, g2, g3, ..., g12
+ */
+export type GradeId = `g${number}`;
+/**
+ * 有效的年级范围 (1-12)
+ */
+export declare const VALID_GRADES: number[];
+/**
+ * Grade ID 到年级数值的映射
+ */
+export declare const GRADE_ID_TO_NUMBER: Record<GradeId, number>;
+/**
+ * 年级数值到 Grade ID 的映射
+ */
+export declare const NUMBER_TO_GRADE_ID: Record<number, GradeId>;
+/**
+ * Grade 解析选项
+ */
+export interface GradeResolverOptions {
+    /** 是否启用严格模式（无效格式时抛出错误） */
+    strictMode?: boolean;
+    /** 默认年级（当无法解析时使用） */
+    defaultGrade?: number;
+    /** 是否验证年级范围 */
+    validateRange?: boolean;
+    /** 有效年级范围 */
+    validRange?: [number, number];
+    /** 是否记录警告 */
+    logWarnings?: boolean;
+}
+/**
+ * 默认 Grade 解析选项
+ */
+export declare const DEFAULT_GRADE_RESOLVER_OPTIONS: GradeResolverOptions;
+/**
+ * Grade 解析结果
+ */
+export interface GradeResolution {
+    /** 是否成功解析 */
+    success: boolean;
+    /** 解析后的年级数值 */
+    grade?: number;
+    /** 原始 Grade ID */
+    original?: string;
+    /** 是否使用了默认值 */
+    usedDefault?: boolean;
+    /** 错误信息 */
+    error?: string;
+    /** 警告信息 */
+    warnings?: string[];
+    /** 解析方法 */
+    method?: 'exact' | 'extract' | 'default' | 'fallback';
+}
+/**
+ * Grade 解析器类
+ */
+export declare class GradeResolver {
+    /** 解析器选项 */
+    private options;
+    /**
+     * 构造函数
+     */
+    constructor(options?: GradeResolverOptions);
+    /**
+     * 解析 Grade ID
+     */
+    resolve(gradeId: string | number | undefined | null): GradeResolution;
+    /**
+     * 批量解析 Grade IDs
+     */
+    resolveAll(gradeIds: (string | number | undefined | null)[]): GradeResolution[];
+    /**
+     * 验证 Grade ID 格式
+     */
+    validateFormat(gradeId: string): boolean;
+    /**
+     * 提取年级数值
+     */
+    extractGradeNumber(gradeId: string): number | null;
+    /**
+     * 获取当前选项
+     */
+    getOptions(): GradeResolverOptions;
+    /**
+     * 更新选项
+     */
+    updateOptions(options: Partial<GradeResolverOptions>): void;
+    /**
+     * 解析数字类型的 Grade ID
+     */
+    private resolveNumber;
+    /**
+     * 解析字符串类型的 Grade ID
+     */
+    private resolveString;
+    /**
+     * 处理缺失的 Grade ID
+     */
+    private handleMissingGrade;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    /**
+     * 从字符串中提取数字
+     */
+    private extractNumberFromString;
+}
+/**
+ * 验证 Grade ID 格式
+ */
+export declare function isValidGradeId(gradeId: string): gradeId is GradeId;
+/**
+ * 将 Grade ID 转换为年级数值
+ */
+export declare function gradeIdToNumber(gradeId: string): number | null;
+/**
+ * 将年级数值转换为 Grade ID
+ */
+export declare function numberToGradeId(gradeNum: number): GradeId | null;
+/**
+ * 规范化 Grade ID（确保格式正确）
+ */
+export declare function normalizeGradeId(gradeId: string | number): string;
+/**
+ * 获取默认 Grade 解析器实例
+ */
+export declare function getDefaultGradeResolver(options?: GradeResolverOptions): GradeResolver;
+/**
+ * 创建新的 Grade 解析器实例
+ */
+export declare function createGradeResolver(options?: GradeResolverOptions): GradeResolver;
+//# sourceMappingURL=gradeResolver.d.ts.map

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/gradeResolver.d.ts.map

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

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 配置模块导出
+ *
+ * 集中导出配置加载器和相关工具。
+ */
+export * from './configLoader';
+export * from './gradeResolver';
+export { ConfigLoader, getDefaultConfigLoader, createConfigLoader, type ConfigLoaderOptions, DEFAULT_CONFIG_LOADER_OPTIONS, } from './configLoader';
+export { GradeResolver, getDefaultGradeResolver, createGradeResolver, type GradeResolverOptions, type GradeResolution, DEFAULT_GRADE_RESOLVER_OPTIONS, isValidGradeId, gradeIdToNumber, numberToGradeId, normalizeGradeId, } from './gradeResolver';
+/**
+ * 配置模块工具函数
+ */
+export declare const configUtils: {
+    /**
+     * 创建默认配置上下文
+     */
+    createDefaultConfigContext(): Promise<any>;
+    /**
+     * 解析年级信息
+     */
+    resolveGrade(gradeId: string | number | undefined | null): any;
+    /**
+     * 验证配置完整性
+     */
+    validateConfig(config: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * 合并配置
+     */
+    mergeConfigs(base: any, override: any, strategy?: "deep" | "shallow" | "overwrite"): any;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,8BAA8B,EAC9B,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;;IAYH;;OAEG;0BACmB,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI;IAKxD;;OAEG;2BACoB,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAiCjE;;OAEG;uBACgB,GAAG,YAAY,GAAG,aAAY,MAAM,GAAG,SAAS,GAAG,WAAW;CAYlF,CAAC"}

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/index.d.ts

@@ -0,0 +1,238 @@
+/**
+ * 三角形数据适配器主入口
+ *
+ * 协调各模块将外部化配置的JSON数据转换为符合MathPracticeProblemData接口的标准格式。
+ * 支持组件契约和外部引用解析。
+ */
+import type { AdapterConfig, AdapterInput, AdapterOutput } from './types';
+import { type ConfigLoader } from './config';
+import { type ReferenceResolutionEngine } from './resolvers';
+import { type TransformerRegistry } from './transformers';
+import { type ValidatorRegistry } from './validators';
+import { type CacheManagerImpl as CacheManager } from './cache';
+/**
+ * 三角形数据适配器配置
+ */
+export interface TriangleDataAdapterConfig extends AdapterConfig {
+    /** 是否启用引用解析 */
+    enableReferenceResolution: boolean;
+    /** 是否启用组件契约验证 */
+    enableComponentContractValidation: boolean;
+    /** 是否启用缓存 */
+    enableCaching: boolean;
+    /** 是否启用详细日志 */
+    enableVerboseLogging: boolean;
+    /** 是否启用性能监控 */
+    enablePerformanceMonitoring: boolean;
+    /** 适配超时时间（毫秒） */
+    timeoutMs: number;
+    /** 最大引用解析深度 */
+    maxReferenceDepth: number;
+    /** 是否启用严格模式 */
+    strictMode: boolean;
+}
+/**
+ * 默认三角形数据适配器配置
+ */
+export declare const DEFAULT_TRIANGLE_DATA_ADAPTER_CONFIG: TriangleDataAdapterConfig;
+/**
+ * 适配器统计
+ */
+export interface AdapterStats {
+    /** 总适配次数 */
+    totalAdaptations: number;
+    /** 成功适配次数 */
+    successfulAdaptations: number;
+    /** 失败适配次数 */
+    failedAdaptations: number;
+    /** 平均适配时间（毫秒） */
+    averageAdaptationTime: number;
+    /** 缓存命中率 */
+    cacheHitRate: number;
+    /** 引用解析统计 */
+    referenceResolutionStats: {
+        totalResolutions: number;
+        successfulResolutions: number;
+        failedResolutions: number;
+        averageResolutionTime: number;
+    };
+    /** 验证统计 */
+    validationStats: {
+        totalValidations: number;
+        successfulValidations: number;
+        failedValidations: number;
+        averageValidationTime: number;
+    };
+    /** 转换统计 */
+    transformationStats: {
+        totalTransformations: number;
+        successfulTransformations: number;
+        failedTransformations: number;
+        averageTransformationTime: number;
+    };
+}
+/**
+ * 三角形数据适配器
+ */
+export declare class TriangleDataAdapter {
+    private config;
+    private configLoader;
+    private referenceEngine;
+    private transformerRegistry;
+    private validatorRegistry;
+    private cacheManager;
+    private stats;
+    private cacheHits;
+    private cacheQueries;
+    constructor(config?: Partial<TriangleDataAdapterConfig>);
+    /**
+     * 初始化统计
+     */
+    private initializeStats;
+    /**
+     * 适配三角形数据
+     * @param input 输入数据
+     */
+    adapt(input: AdapterInput): Promise<AdapterOutput>;
+    /**
+     * 检查缓存
+     */
+    private checkCache;
+    /**
+     * 解析引用
+     */
+    private resolveReferences;
+    /**
+     * 转换数据
+     */
+    private transformData;
+    /**
+     * 从grade_id中提取年级数字
+     */
+    private extractGradeFromGradeId;
+    /**
+     * 转换基础信息
+     */
+    private transformBasicInfo;
+    /**
+     * 验证组件契约
+     */
+    private validateComponentContracts;
+    /**
+     * 从数据中提取组件配置并进行验证
+     */
+    private extractAndValidateComponents;
+    /**
+     * 将字符串类型映射到ComponentType枚举
+     */
+    private mapToComponentType;
+    /**
+     * 构建输出
+     */
+    private buildOutput;
+    /**
+     * 缓存结果
+     */
+    private cacheResult;
+    /**
+     * 创建错误输出
+     */
+    createErrorOutput(input: AdapterInput, error: unknown, stage?: string, context?: Record<string, any>): AdapterOutput;
+    /**
+     * 错误分类
+     */
+    private classifyError;
+    /**
+     * 生成缓存键
+     */
+    private generateCacheKey;
+    /**
+     * 创建引用上下文
+     */
+    private createReferenceContext;
+    /**
+     * 更新引用解析统计
+     */
+    private updateReferenceResolutionStats;
+    /**
+     * 更新验证统计
+     */
+    private updateValidationStats;
+    /**
+     * 更新转换统计
+     */
+    private updateTransformationStats;
+    /**
+     * 更新缓存统计
+     */
+    private updateCacheStats;
+    /**
+     * 更新整体统计
+     */
+    private updateStats;
+    /**
+     * 创建安全的空全局配置
+     * 使用嵌入式配置作为回退，确保配置的一致性
+     */
+    private createEmptyGlobalConfig;
+    /**
+     * 安全地从输入中获取数据
+     */
+    private getDataFromInput;
+    /**
+     * 安全地获取几何图形
+     */
+    private getGeometryShapes;
+    /**
+     * 安全地获取变换定义
+     */
+    private getTransformDefinitions;
+    /**
+     * 获取适配器统计
+     */
+    getStats(): AdapterStats;
+    /**
+     * 重置适配器统计
+     */
+    resetStats(): void;
+    /**
+     * 更新适配器配置
+     */
+    updateConfig(config: Partial<TriangleDataAdapterConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): TriangleDataAdapterConfig;
+    /**
+     * 获取底层组件实例（用于调试和监控）
+     */
+    getComponents(): {
+        configLoader: ConfigLoader;
+        referenceEngine: ReferenceResolutionEngine;
+        transformerRegistry: TransformerRegistry;
+        validatorRegistry: ValidatorRegistry;
+        cacheManager: CacheManager;
+    };
+}
+/**
+ * 创建三角形数据适配器
+ */
+export declare function createTriangleDataAdapter(config?: Partial<TriangleDataAdapterConfig>): TriangleDataAdapter;
+export declare function getDefaultTriangleDataAdapter(): TriangleDataAdapter;
+/**
+ * 适配三角形数据（工具函数）
+ */
+export declare function adaptTriangleData(input: AdapterInput): Promise<AdapterOutput>;
+/**
+ * 批量适配三角形数据
+ */
+export declare function adaptTriangleDataBatch(inputs: AdapterInput[]): Promise<AdapterOutput[]>;
+/**
+ * 验证适配器配置
+ */
+export declare function validateAdapterConfig(config: Partial<TriangleDataAdapterConfig>): string[];
+/**
+ * 清理适配器资源
+ */
+export declare function cleanupAdapterResources(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EAId,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,KAAK,gBAAgB,IAAI,YAAY,EACtC,MAAM,SAAS,CAAC;AAmBjB;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC9D,eAAe;IACf,yBAAyB,EAAE,OAAO,CAAC;IACnC,iBAAiB;IACjB,iCAAiC,EAAE,OAAO,CAAC;IAC3C,aAAa;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe;IACf,oBAAoB,EAAE,OAAO,CAAC;IAC9B,eAAe;IACf,2BAA2B,EAAE,OAAO,CAAC;IACrC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oCAAoC,EAAE,yBASlD,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa;IACb,wBAAwB,EAAE;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,WAAW;IACX,eAAe,EAAE;QACf,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,WAAW;IACX,mBAAmB,EAAE;QACnB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,yBAAyB,EAAE,MAAM,CAAC;QAClC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,yBAAyB,EAAE,MAAM,CAAC;KACnC,CAAC;CACH;AAMD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;gBAEb,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAM;IAU3D;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAiGxD;;OAEG;YACW,UAAU;IAsBxB;;OAEG;YACW,iBAAiB;IA6D/B;;OAEG;YACW,aAAa;IA4D3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;YACW,0BAA0B;IAsCxC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoCpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,WAAW;IA+CnB;;OAEG;YACW,WAAW;IAOzB;;OAEG;IACI,iBAAiB,CACtB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,aAAa;IAyChB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAYtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,SAAS,IAAI,yBAAyB;IAItC;;OAEG;IACH,aAAa,IAAI;QACf,YAAY,EAAE,YAAY,CAAC;QAC3B,eAAe,EAAE,yBAAyB,CAAC;QAC3C,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,YAAY,EAAE,YAAY,CAAC;KAC5B;CASF;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC9C,mBAAmB,CAErB;AAOD,wBAAgB,6BAA6B,IAAI,mBAAmB,CAKnE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAGnF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,GACzC,MAAM,EAAE,CAYV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C"}

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/resolvers/appearanceRefResolver.d.ts

@@ -0,0 +1,177 @@
+/**
+ * 外观引用解析器
+ *
+ * 负责解析外观引用，如 appearanceRef:appear_at_90、appearanceRef:fade_in。
+ * 支持嵌套引用解析（外观定义内可包含设计令牌引用）、默认值回退和错误处理。
+ */
+import type { ReferenceResolver, ReferenceContext, ReferenceError, SafeReferenceResolution } from '../types';
+/**
+ * 外观引用解析器配置
+ */
+export interface AppearanceRefResolverConfig {
+    /** 是否启用缓存 */
+    enableCache: boolean;
+    /** 缓存生存时间（毫秒） */
+    cacheTTL: number;
+    /** 是否启用严格模式 */
+    strictMode: boolean;
+    /** 默认外观定义映射 */
+    defaultAppearanceDefinitions: Record<string, any>;
+    /** 是否记录解析统计 */
+    logStats: boolean;
+    /** 最大解析深度 */
+    maxDepth: number;
+    /** 是否递归解析嵌套引用 */
+    resolveNestedRefs: boolean;
+    /** 嵌套解析最大深度 */
+    nestedMaxDepth: number;
+}
+/**
+ * 默认外观引用解析器配置
+ */
+export declare const DEFAULT_APPEARANCE_REF_RESOLVER_CONFIG: AppearanceRefResolverConfig;
+/**
+ * 外观引用解析器状态
+ */
+interface AppearanceRefResolverState {
+    /** 解析统计 */
+    stats: {
+        totalResolutions: number;
+        cacheHits: number;
+        cacheMisses: number;
+        successes: number;
+        failures: number;
+        byAppearanceType: Record<string, number>;
+        nestedResolutions: number;
+        nestedFailures: number;
+    };
+    /** 缓存 */
+    cache: Map<string, {
+        value: any;
+        expiresAt: number;
+    }>;
+    /** 最后错误 */
+    lastError: ReferenceError | null;
+    /** 嵌套解析上下文栈（用于检测循环引用） */
+    resolutionStack: string[];
+}
+/**
+ * 外观引用解析器类
+ */
+export declare class AppearanceRefResolver implements ReferenceResolver {
+    /** 解析器配置 */
+    private config;
+    /** 解析器状态 */
+    private state;
+    /** 设计令牌解析器引用（用于解析嵌套的设计令牌） */
+    private designTokenResolver?;
+    /**
+     * 构造函数
+     */
+    constructor(config?: Partial<AppearanceRefResolverConfig>);
+    /**
+     * 设置设计令牌解析器（用于解析嵌套引用）
+     */
+    setDesignTokenResolver(resolver: ReferenceResolver): void;
+    /**
+     * 检查是否能够解析该引用
+     */
+    canResolve(ref: string): boolean;
+    /**
+     * 解析外观引用
+     */
+    resolve(ref: string, context: ReferenceContext): any;
+    /**
+     * 安全解析外观引用（返回包含错误信息的结果）
+     */
+    resolveSafe(ref: string, context: ReferenceContext): SafeReferenceResolution;
+    /**
+     * 验证引用有效性
+     */
+    validate(ref: string, context: ReferenceContext): boolean;
+    /**
+     * 批量解析外观引用
+     */
+    resolveAll(refs: string[], context: ReferenceContext): SafeReferenceResolution[];
+    /**
+     * 获取解析统计
+     */
+    getStats(): AppearanceRefResolverState['stats'];
+    /**
+     * 获取最后错误
+     */
+    getLastError(): ReferenceError | null;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 重置统计
+     */
+    resetStats(): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): AppearanceRefResolverConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<AppearanceRefResolverConfig>): void;
+    /**
+     * 检查是否为外观引用
+     */
+    private isAppearanceRef;
+    /**
+     * 解析引用路径
+     */
+    private parseRefPath;
+    /**
+     * 解析外观定义
+     */
+    private resolveAppearanceDefinition;
+    /**
+     * 解析嵌套引用
+     */
+    private resolveNestedRefs;
+    /**
+     * 从缓存获取值
+     */
+    private getFromCache;
+    /**
+     * 设置缓存值
+     */
+    private setToCache;
+    /**
+     * 生成缓存键
+     */
+    private getCacheKey;
+    /**
+     * 创建错误结果
+     */
+    private createErrorResult;
+}
+/**
+ * 获取默认外观引用解析器实例
+ */
+export declare function getDefaultAppearanceRefResolver(config?: Partial<AppearanceRefResolverConfig>): AppearanceRefResolver;
+/**
+ * 创建新的外观引用解析器实例
+ */
+export declare function createAppearanceRefResolver(config?: Partial<AppearanceRefResolverConfig>): AppearanceRefResolver;
+/**
+ * 提取外观引用
+ */
+export declare function extractAppearanceRefs(value: any): string[];
+/**
+ * 替换外观引用
+ */
+export declare function replaceAppearanceRefs(value: any, resolver: (ref: string) => any): any;
+/**
+ * 验证外观引用格式
+ */
+export declare function validateAppearanceRef(ref: string): {
+    valid: boolean;
+    error?: string;
+};
+export {};
+//# sourceMappingURL=appearanceRefResolver.d.ts.map

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/resolvers/appearanceRefResolver.d.ts.map

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