@mathwiz/ui-components 0.1.16 → 0.1.22

package/dist/pages/AreaGeometrySessionPage/data/adapters/triangleDataAdapter/types/reference.types.d.ts

@@ -0,0 +1,313 @@
+/**
+ * 引用解析类型定义
+ *
+ * 本文件定义了引用解析系统的类型，包括引用格式、解析结果和解析器配置。
+ */
+import type { ReferenceType } from './adapter.types';
+/**
+ * 设计令牌引用格式
+ * 示例: $colors.primary, $fonts.body, $spacing.md, $geometry.stroke_width_normal
+ */
+export type DesignTokenRef = `\$${string}.${string}`;
+/**
+ * 样式引用格式
+ * 示例: styleRef:primary, styleRef:highlight
+ */
+export type StyleRef = `styleRef:${string}`;
+/**
+ * 几何引用格式
+ * 示例: geometryRef:acute_triangle, geometryRef:right_triangle
+ */
+export type GeometryRef = `geometryRef:${string}`;
+/**
+ * 布局引用格式
+ * 示例: layoutRef:vertical_centered, layoutRef:horizontal_spaced
+ */
+export type LayoutRef = `layoutRef:${string}`;
+/**
+ * 外观引用格式
+ * 示例: appearanceRef:appear_at_90, appearanceRef:fade_in
+ */
+export type AppearanceRef = `appearanceRef:${string}`;
+/**
+ * 棋盘配置引用格式
+ * 示例: boardRef:default, boardRef:extended
+ */
+export type BoardRef = `boardRef:${string}`;
+/**
+ * 变换定义引用格式
+ * 示例: transformRef:left_rotation, transformRef:right_rotation
+ */
+export type TransformRef = `transformRef:${string}`;
+/**
+ * 通用资源引用格式
+ * 示例: $ref:path.to.resource
+ */
+export type ResourceRef = `\$ref:${string}`;
+/**
+ * 所有引用类型的联合类型
+ */
+export type AnyRef = DesignTokenRef | StyleRef | GeometryRef | LayoutRef | AppearanceRef | BoardRef | TransformRef | ResourceRef;
+/**
+ * 引用匹配模式
+ */
+export interface RefPattern {
+    /** 正则表达式模式 */
+    pattern: RegExp;
+    /** 引用类型 */
+    type: ReferenceType;
+    /** 提取引用键的函数 */
+    extractKey: (ref: string) => string;
+}
+/**
+ * 引用解析器配置
+ */
+export interface ReferenceResolverConfig {
+    /** 是否启用缓存 */
+    enableCache: boolean;
+    /** 最大解析深度 */
+    maxDepth: number;
+    /** 是否检测循环引用 */
+    detectCircularRefs: boolean;
+    /** 是否抛出解析错误 */
+    throwOnError: boolean;
+    /** 默认值映射 */
+    defaultValueMap: Record<string, any>;
+}
+/**
+ * 默认引用解析器配置
+ */
+export declare const DEFAULT_REFERENCE_RESOLVER_CONFIG: ReferenceResolverConfig;
+/**
+ * 引用解析节点（用于构建解析图）
+ */
+export interface ReferenceNode {
+    /** 节点ID */
+    id: string;
+    /** 引用路径 */
+    ref: string;
+    /** 引用类型 */
+    type: ReferenceType;
+    /** 解析后的值 */
+    value: any;
+    /** 子节点引用 */
+    children: ReferenceNode[];
+    /** 父节点引用 */
+    parents: ReferenceNode[];
+    /** 解析深度 */
+    depth: number;
+    /** 是否已解析 */
+    resolved: boolean;
+    /** 解析错误 */
+    error?: string;
+}
+/**
+ * 引用解析图
+ */
+export interface ReferenceGraph {
+    /** 所有节点 */
+    nodes: Map<string, ReferenceNode>;
+    /** 根节点 */
+    root: ReferenceNode | null;
+    /** 最大深度 */
+    maxDepth: number;
+    /** 是否有循环引用 */
+    hasCircularRefs: boolean;
+    /** 循环引用路径 */
+    circularRefs: string[][];
+}
+/**
+ * 引用解析统计
+ */
+export interface ReferenceResolutionStats {
+    /** 总引用数 */
+    totalRefs: number;
+    /** 成功解析数 */
+    resolvedRefs: number;
+    /** 失败解析数 */
+    failedRefs: number;
+    /** 缓存命中数 */
+    cacheHits: number;
+    /** 缓存未命中数 */
+    cacheMisses: number;
+    /** 按类型统计 */
+    byType: Record<ReferenceType, {
+        count: number;
+        resolved: number;
+        failed: number;
+    }>;
+    /** 解析时间（毫秒） */
+    resolutionTime: number;
+    /** 平均解析深度 */
+    averageDepth: number;
+    /** 最大解析深度 */
+    maxDepth: number;
+}
+/**
+ * 引用解析器工厂函数
+ */
+export type ReferenceResolverFactory = (config: ReferenceResolverConfig) => ReferenceResolver;
+/**
+ * 引用解析器注册项
+ */
+export interface ReferenceResolverRegistryItem {
+    /** 解析器名称 */
+    name: string;
+    /** 支持的引用类型 */
+    supportedTypes: ReferenceType[];
+    /** 工厂函数 */
+    factory: ReferenceResolverFactory;
+    /** 优先级（数字越小优先级越高） */
+    priority: number;
+}
+/**
+ * 引用解析器注册表
+ */
+export type ReferenceResolverRegistry = Map<string, ReferenceResolverRegistryItem>;
+/**
+ * 引用路径解析结果
+ */
+export interface RefPathParseResult {
+    /** 引用类型 */
+    type: ReferenceType;
+    /** 命名空间（如 colors, fonts 等） */
+    namespace: string;
+    /** 键名（如 primary, body 等） */
+    key: string;
+    /** 完整路径 */
+    fullPath: string;
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 引用值转换选项
+ */
+export interface RefValueTransformOptions {
+    /** 是否递归转换嵌套引用 */
+    recursive: boolean;
+    /** 最大转换深度 */
+    maxDepth: number;
+    /** 转换后是否保留引用标记 */
+    keepRefMarkers: boolean;
+    /** 值转换函数 */
+    transformFn?: (value: any, path: string) => any;
+}
+/**
+ * 引用合并策略
+ */
+export declare enum RefMergeStrategy {
+    /** 覆盖：新值完全覆盖旧值 */
+    OVERRIDE = "override",
+    /** 合并：深度合并对象，数组替换 */
+    MERGE = "merge",
+    /** 合并数组：数组合并 */
+    MERGE_ARRAYS = "merge_arrays",
+    /** 智能合并：根据类型自动选择策略 */
+    SMART = "smart"
+}
+/**
+ * 引用合并选项
+ */
+export interface RefMergeOptions {
+    /** 合并策略 */
+    strategy: RefMergeStrategy;
+    /** 是否深度合并对象 */
+    deep: boolean;
+    /** 数组合并方式 */
+    arrayMerge: 'concat' | 'replace' | 'union';
+    /** 自定义合并函数 */
+    customMerge?: (target: any, source: any, key: string) => any;
+}
+/**
+ * 引用解析错误类型
+ */
+export declare enum ReferenceErrorType {
+    /** 引用格式错误 */
+    INVALID_FORMAT = "invalid_format",
+    /** 引用未找到 */
+    NOT_FOUND = "not_found",
+    /** 循环引用 */
+    CIRCULAR_REF = "circular_ref",
+    /** 解析深度超出限制 */
+    MAX_DEPTH_EXCEEDED = "max_depth_exceeded",
+    /** 类型不匹配 */
+    TYPE_MISMATCH = "type_mismatch",
+    /** 配置错误 */
+    CONFIG_ERROR = "config_error"
+}
+/**
+ * 引用解析错误
+ */
+export interface ReferenceError {
+    /** 错误类型 */
+    type: ReferenceErrorType;
+    /** 引用路径 */
+    ref: string;
+    /** 错误消息 */
+    message: string;
+    /** 错误堆栈 */
+    stack?: string;
+    /** 解析上下文 */
+    context?: {
+        depth: number;
+        path: string[];
+        parentRef?: string;
+    };
+}
+/**
+ * 引用解析结果（包含错误处理）
+ */
+export interface SafeReferenceResolution {
+    /** 是否成功 */
+    success: boolean;
+    /** 解析后的值（成功时） */
+    value?: any;
+    /** 错误信息（失败时） */
+    error?: ReferenceError;
+    /** 引用路径 */
+    ref: string;
+    /** 解析深度 */
+    depth: number;
+    /** 是否从缓存获取 */
+    cached: boolean;
+}
+/**
+ * 引用检测函数
+ */
+export type RefDetector = (value: any) => boolean;
+/**
+ * 引用提取函数
+ */
+export type RefExtractor = (value: any) => string[];
+/**
+ * 引用替换函数
+ */
+export type RefReplacer = (value: any, resolver: (ref: string) => any) => any;
+/**
+ * 引用验证函数
+ */
+export type RefValidator = (ref: string) => {
+    valid: boolean;
+    type?: ReferenceType;
+    error?: string;
+};
+/**
+ * 工具函数集合
+ */
+export interface ReferenceUtils {
+    /** 检测值是否包含引用 */
+    isRef: RefDetector;
+    /** 从值中提取所有引用 */
+    extractRefs: RefExtractor;
+    /** 替换值中的所有引用 */
+    replaceRefs: RefReplacer;
+    /** 验证引用格式 */
+    validateRef: RefValidator;
+    /** 解析引用路径 */
+    parseRefPath: (ref: string) => RefPathParseResult;
+    /** 构建引用路径 */
+    buildRefPath: (namespace: string, key: string) => string;
+}
+//# sourceMappingURL=reference.types.d.ts.map

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

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