@skillsmith/core 0.4.0 → 0.4.2

package/dist/src/learning/PatternStore.d.ts

@@ -1,368 +1,9 @@
-/**
- * @fileoverview PatternStore with EWC++ for catastrophic forgetting prevention
- * @module @skillsmith/core/learning/PatternStore
- * @see SMI-1522: Add EWC++ pattern storage for successful matches
- *
- * Implements Elastic Weight Consolidation++ (EWC++) to store successful
- * recommendation patterns without catastrophic forgetting. Unlike traditional
- * storage that overwrites old patterns, EWC++ preserves important learned
- * patterns while integrating new ones.
- *
- * Key capabilities:
- * - storePattern(): Encodes successful matches with Fisher Information tracking
- * - findSimilarPatterns(): Retrieves relevant patterns using importance-weighted similarity
- * - consolidate(): Updates Fisher Information matrix without forgetting important patterns
- * - 95%+ pattern preservation: New patterns do not overwrite important historical patterns
- *
- * @see https://arxiv.org/abs/1801.10112 (Progress & Compress)
- */
-/**
- * EWC++ algorithm configuration
- *
- * @see https://arxiv.org/abs/1801.10112 (Progress & Compress)
- */
-export interface EWCConfig {
-    /**
-     * Lambda (regularization strength).
-     * Higher values = stronger preservation of old patterns.
-     *
-     * - 0.1-1.0: Allows more plasticity (learning new patterns)
-     * - 1.0-10.0: Balanced preservation and learning
-     * - 10.0-100.0: Strong preservation (minimal forgetting)
-     *
-     * @default 5.0
-     */
-    lambda: number;
-    /**
-     * Decay factor for online Fisher Information updates.
-     * Applied to running sum before adding new gradient squared.
-     *
-     * - 0.9: Fast decay, recent patterns dominate
-     * - 0.99: Slow decay, historical patterns preserved longer
-     * - 1.0: No decay (original EWC, not recommended)
-     *
-     * @default 0.95
-     */
-    fisherDecay: number;
-    /**
-     * Minimum importance threshold for pattern preservation.
-     * Patterns below this threshold are eligible for overwriting.
-     *
-     * @default 0.01
-     */
-    importanceThreshold: number;
-    /**
-     * Number of patterns to sample for Fisher Information estimation.
-     * Higher values = more accurate importance estimates but slower.
-     *
-     * @default 100
-     */
-    fisherSampleSize: number;
-    /**
-     * Consolidation trigger threshold.
-     * Consolidate when (new_patterns / total_patterns) exceeds this.
-     *
-     * @default 0.1 (10%)
-     */
-    consolidationThreshold: number;
-    /**
-     * Maximum patterns to retain before pruning low-importance ones.
-     *
-     * @default 10000
-     */
-    maxPatterns: number;
-}
-/**
- * PatternStore configuration
- */
-export interface PatternStoreConfig {
-    /**
-     * Path to SQLite database for pattern storage.
-     * If not provided, uses in-memory database.
-     */
-    dbPath?: string;
-    /**
-     * EWC++ algorithm parameters.
-     */
-    ewc?: Partial<EWCConfig>;
-    /**
-     * Embedding dimensions (must match embedding model).
-     * @default 384 (all-MiniLM-L6-v2)
-     */
-    dimensions?: number;
-    /**
-     * Enable automatic consolidation on pattern insertion.
-     * @default true
-     */
-    autoConsolidate?: boolean;
-    /**
-     * Enable pattern access tracking for importance boosting.
-     * @default true
-     */
-    trackAccess?: boolean;
-    /**
-     * Enable V3 ReasoningBank integration.
-     * @default true (auto-detect)
-     */
-    useV3Integration?: boolean;
-}
-/**
- * Default EWC++ configuration
- */
-export declare const DEFAULT_EWC_CONFIG: EWCConfig;
-/**
- * Default PatternStore configuration
- */
-export declare const DEFAULT_PATTERN_STORE_CONFIG: Required<Omit<PatternStoreConfig, 'dbPath'>> & {
-    dbPath?: string;
-};
-/**
- * Pattern outcome types aligned with ReasoningBankIntegration rewards
- *
- * @see ReasoningBankIntegration.TRAJECTORY_REWARDS
- */
-export type PatternOutcomeType = 'accept' | 'usage' | 'frequent' | 'dismiss' | 'abandonment' | 'uninstall';
-/**
- * Outcome result for a pattern
- */
-export interface PatternOutcome {
-    /** Type of outcome */
-    type: PatternOutcomeType;
-    /** Reward value [-1.0, 1.0] */
-    reward: number;
-    /** Confidence in this outcome (for partial observations) */
-    confidence?: number;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Reward values for pattern outcomes
- * Matches ReasoningBankIntegration.TRAJECTORY_REWARDS
- */
-export declare const PATTERN_REWARDS: Record<PatternOutcomeType, number>;
-/**
- * Context that led to a recommendation
- */
-export interface PatternRecommendationContext {
-    /** User's current installed skills */
-    installedSkills: string[];
-    /** Frameworks/languages detected in project */
-    frameworks?: string[];
-    /** Keywords from user query or context */
-    keywords?: string[];
-    /** Time of day (for temporal patterns) */
-    timeOfDay?: 'morning' | 'afternoon' | 'evening' | 'night';
-    /** Day type (for usage patterns) */
-    dayType?: 'weekday' | 'weekend';
-    /** Session duration in minutes */
-    sessionDuration?: number;
-    /** Number of recommendations shown in session */
-    recommendationsShown?: number;
-}
-/**
- * Skill features used in pattern matching
- */
-export interface SkillFeatures {
-    /** Skill identifier (author/name format) */
-    skillId: string;
-    /** Skill category */
-    category?: string;
-    /** Trust tier (verified, community, experimental) */
-    trustTier?: string;
-    /** Skill keywords/tags */
-    keywords?: string[];
-    /** Trigger phrases */
-    triggerPhrases?: string[];
-    /** Quality score [0-100] */
-    qualityScore?: number;
-    /** Install count */
-    installCount?: number;
-}
-/**
- * Complete pattern definition
- */
-export interface Pattern {
-    /** Unique pattern identifier (auto-generated if not provided) */
-    id?: string;
-    /** Recommendation context that led to this match */
-    context: PatternRecommendationContext;
-    /** Skill that was recommended */
-    skill: SkillFeatures;
-    /** Original recommendation score [0-1] */
-    originalScore: number;
-    /** Source of the recommendation (search, recommend, install) */
-    source: 'search' | 'recommend' | 'install' | 'compare';
-}
-/**
- * Stored pattern with computed fields
- */
-export interface StoredPattern extends Pattern {
-    /** Pattern ID (guaranteed after storage) */
-    id: string;
-    /** Context embedding vector */
-    contextEmbedding: Float32Array;
-    /** Pattern outcome */
-    outcome: PatternOutcome;
-    /** Pattern importance (from Fisher Information) */
-    importance: number;
-    /** Number of times this pattern was accessed */
-    accessCount: number;
-    /** Creation timestamp */
-    createdAt: Date;
-    /** Last access timestamp */
-    lastAccessedAt: Date;
-}
-/**
- * Pattern query for similarity search
- */
-export interface PatternQuery {
-    /** Context to match against */
-    context: PatternRecommendationContext;
-    /** Optional skill to filter by */
-    skillId?: string;
-    /** Optional category filter */
-    category?: string;
-    /** Minimum importance threshold */
-    minImportance?: number;
-    /** Outcome type filter */
-    outcomeType?: PatternOutcomeType;
-    /** Only positive outcomes (accept, usage, frequent) */
-    positiveOnly?: boolean;
-}
-/**
- * Similar pattern result
- */
-export interface SimilarPattern {
-    /** The matched pattern */
-    pattern: StoredPattern;
-    /** Similarity score [0-1] */
-    similarity: number;
-    /** Importance-weighted similarity */
-    weightedSimilarity: number;
-    /** Rank in results */
-    rank: number;
-}
-/**
- * Consolidation operation result
- */
-export interface ConsolidationResult {
-    /** Whether consolidation was performed */
-    consolidated: boolean;
-    /** Patterns processed during consolidation */
-    patternsProcessed: number;
-    /** Patterns preserved (importance above threshold) */
-    patternsPreserved: number;
-    /** Patterns pruned (importance below threshold) */
-    patternsPruned: number;
-    /** Preservation rate (should be >= 0.95) */
-    preservationRate: number;
-    /** Time taken in milliseconds */
-    durationMs: number;
-    /** New average importance after consolidation */
-    averageImportance: number;
-}
-/**
- * PatternStore metrics for monitoring
- */
-export interface PatternStoreMetrics {
-    /** Total patterns stored */
-    totalPatterns: number;
-    /** Patterns by outcome type */
-    patternsByOutcome: Record<PatternOutcomeType, number>;
-    /** Average pattern importance */
-    averageImportance: number;
-    /** High importance patterns (above 90th percentile) */
-    highImportancePatterns: number;
-    /** Consolidation statistics */
-    consolidation: {
-        totalConsolidations: number;
-        lastConsolidation: Date | null;
-        averagePreservationRate: number;
-        patternsPruned: number;
-    };
-    /** Storage statistics */
-    storage: {
-        sizeBytes: number;
-        fisherMatrixSizeBytes: number;
-    };
-    /** Query performance */
-    queryPerformance: {
-        averageLatencyMs: number;
-        queriesPerformed: number;
-    };
-}
-/**
- * Fisher Information Matrix interface
- */
-export interface IFisherInformationMatrix {
-    getImportance(dimensionIndex: number): number;
-    update(gradient: Float32Array): void;
-    decay(decayFactor: number): void;
-    getImportanceVector(): Float32Array;
-    getAverageImportance(): number;
-    serialize(): Buffer;
-    deserialize(buffer: Buffer): void;
-    reset(): void;
-}
-/**
- * Fisher Information Matrix implementation for EWC++
- *
- * Stores diagonal approximation of Fisher Information,
- * indicating which "weights" (pattern dimensions) are important.
- *
- * In the context of pattern storage:
- * - Each dimension of the context embedding has an importance value
- * - High importance = changing this dimension would harm prediction
- * - Low importance = safe to overwrite with new patterns
- */
-export declare class FisherInformationMatrix implements IFisherInformationMatrix {
-    private dimensions;
-    /** Diagonal of Fisher Information (importance per dimension) */
-    private importance;
-    /** Running sum for online updates */
-    private runningSum;
-    /** Number of updates performed */
-    private updateCount;
-    constructor(dimensions: number);
-    getImportance(dimensionIndex: number): number;
-    update(gradient: Float32Array): void;
-    decay(decayFactor: number): void;
-    getImportanceVector(): Float32Array;
-    getAverageImportance(): number;
-    serialize(): Buffer;
-    deserialize(buffer: Buffer): void;
-    reset(): void;
-    getUpdateCount(): number;
-}
-/**
- * PatternStore - EWC++ pattern storage for successful recommendation matches
- *
- * Prevents catastrophic forgetting by tracking which pattern dimensions
- * are important via Fisher Information Matrix and preserving high-importance
- * patterns during consolidation.
- *
- * @example
- * ```typescript
- * const store = new PatternStore({ dbPath: './patterns.db' })
- * await store.initialize()
- *
- * // Store a successful pattern
- * await store.storePattern(
- *   {
- *     context: { installedSkills: ['commit'], frameworks: ['react'] },
- *     skill: { skillId: 'jest-helper', category: 'testing' },
- *     originalScore: 0.85,
- *     source: 'recommend'
- *   },
- *   { type: 'accept', reward: 1.0 }
- * )
- *
- * // Find similar patterns
- * const similar = await store.findSimilarPatterns({
- *   context: { installedSkills: ['commit'], frameworks: ['react', 'typescript'] }
- * })
- * ```
- */
+export type { EWCConfig, PatternStoreConfig, PatternOutcomeType, PatternOutcome, PatternRecommendationContext, SkillFeatures, Pattern, StoredPattern, PatternQuery, SimilarPattern, ConsolidationResult, PatternStoreMetrics, ConsolidationState, PatternRow, } from './PatternStore.types.js';
+export { DEFAULT_EWC_CONFIG, DEFAULT_PATTERN_STORE_CONFIG, PATTERN_REWARDS, } from './PatternStore.types.js';
+export type { IFisherInformationMatrix } from './PatternStore.helpers.js';
+export { FisherInformationMatrix } from './PatternStore.helpers.js';
+import type { PatternStoreConfig, PatternOutcome, Pattern, PatternQuery, SimilarPattern, ConsolidationResult, PatternStoreMetrics } from './PatternStore.types.js';
+/** PatternStore - EWC++ pattern storage for successful recommendation matches */
 export declare class PatternStore {
     private db;
     private fisherMatrix;
@@ -374,84 +15,23 @@ export declare class PatternStore {
     private queryLatencies;
     private maxQuerySamples;
     constructor(config?: PatternStoreConfig);
-    /**
-     * Initialize the PatternStore
-     */
     initialize(): Promise<void>;
-    /**
-     * Check if PatternStore is initialized
-     */
     isInitialized(): boolean;
-    /**
-     * Attempt to initialize V3 ReasoningBank integration
-     */
     private initializeV3Integration;
-    /**
-     * Store a pattern with EWC++ protection
-     *
-     * @param pattern - Pattern to store
-     * @param outcome - Outcome of the recommendation
-     * @returns Pattern ID
-     */
     storePattern(pattern: Pattern, outcome: PatternOutcome): Promise<string>;
-    /**
-     * Find similar patterns using importance-weighted similarity
-     *
-     * @param query - Pattern query
-     * @param limit - Maximum results
-     * @returns Similar patterns sorted by weighted similarity
-     */
     findSimilarPatterns(query: PatternQuery, limit?: number): Promise<SimilarPattern[]>;
-    /**
-     * Consolidate patterns using EWC++
-     *
-     * Applies Fisher decay, recalculates importance, and prunes low-importance patterns.
-     * Guarantees 95%+ preservation of important patterns.
-     *
-     * @returns Consolidation result
-     */
     consolidate(): Promise<ConsolidationResult>;
-    /**
-     * Get pattern importance value
-     *
-     * @param patternId - Pattern identifier
-     * @returns Importance value or 0 if not found
-     */
     getPatternImportance(patternId: string): number;
-    /**
-     * Get PatternStore metrics
-     */
     getMetrics(): PatternStoreMetrics;
-    /**
-     * Close the PatternStore and release resources
-     */
     close(): void;
     private ensureInitialized;
-    private contextToText;
-    private computeGradient;
     private computeAverageEmbedding;
-    private deserializeEmbedding;
-    private cosineSimilarity;
-    private importanceWeightedSimilarity;
-    private calculatePatternImportance;
-    private calculateDimensionImportance;
     private shouldConsolidate;
-    private getPatternCount;
-    private getSamplePatterns;
-    private getAllPatterns;
-    private updatePatternInDB;
-    private updatePatternImportance;
-    private updateAccessCount;
-    private deletePattern;
-    private getDatabaseSize;
     private loadFisherMatrix;
     private saveFisherMatrix;
 }
 /**
  * Create and initialize a PatternStore instance
- *
- * @param config - Configuration options
- * @returns Initialized PatternStore
  */
 export declare function createPatternStore(config?: PatternStoreConfig): Promise<PatternStore>;
 //# sourceMappingURL=PatternStore.d.ts.map

package/dist/src/learning/PatternStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PatternStore.d.ts","sourceRoot":"","sources":["../../../src/learning/PatternStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PatternStore.d.ts","sourceRoot":"","sources":["../../../src/learning/PatternStore.ts"],"names":[],"mappings":"AAUA,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,4BAA4B,EAC5B,aAAa,EACb,OAAO,EACP,aAAa,EACb,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,eAAe,GAChB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAGnE,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EAGpB,MAAM,yBAAyB,CAAA;AAiChC,iFAAiF;AACjF,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAoE;IAClF,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,eAAe,CAAM;gBAEjB,MAAM,GAAE,kBAAuB;IAcrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC,aAAa,IAAI,OAAO;YAIV,uBAAuB;IAY/B,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAiExE,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0EvF,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA2GjD,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAO/C,UAAU,IAAI,mBAAmB;IAsCjC,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,iBAAiB;YAMX,uBAAuB;IAoBrC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;CAIzB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAI/F"}

package/dist/src/learning/PatternStore.helpers.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview PatternStore helper classes and utility functions
+ * @module @skillsmith/core/learning/PatternStore.helpers
+ *
+ * Contains FisherInformationMatrix implementation, SQL schema, and utility functions.
+ */
+import type { PatternRecommendationContext, StoredPattern, PatternOutcome, PatternRow } from './PatternStore.types.js';
+/**
+ * SQLite schema for pattern storage
+ */
+export declare const PATTERN_STORE_SCHEMA = "\n-- Patterns table: stores recommendation patterns with outcomes\nCREATE TABLE IF NOT EXISTS patterns (\n  pattern_id TEXT PRIMARY KEY,\n  context_embedding BLOB NOT NULL,\n  skill_id TEXT NOT NULL,\n  skill_features TEXT NOT NULL,\n  context_data TEXT NOT NULL,\n  outcome_type TEXT NOT NULL,\n  outcome_reward REAL NOT NULL,\n  importance REAL NOT NULL DEFAULT 0.1,\n  original_score REAL NOT NULL,\n  source TEXT NOT NULL,\n  access_count INTEGER NOT NULL DEFAULT 0,\n  created_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  last_accessed_at INTEGER NOT NULL DEFAULT (unixepoch())\n);\n\n-- Indexes for efficient queries\nCREATE INDEX IF NOT EXISTS idx_patterns_skill_id ON patterns(skill_id);\nCREATE INDEX IF NOT EXISTS idx_patterns_outcome_type ON patterns(outcome_type);\nCREATE INDEX IF NOT EXISTS idx_patterns_importance ON patterns(importance DESC);\nCREATE INDEX IF NOT EXISTS idx_patterns_created_at ON patterns(created_at DESC);\n\n-- Fisher Information matrix state\nCREATE TABLE IF NOT EXISTS fisher_info (\n  id INTEGER PRIMARY KEY DEFAULT 1,\n  matrix_data BLOB NOT NULL,\n  update_count INTEGER NOT NULL DEFAULT 0,\n  last_decay_at INTEGER NOT NULL DEFAULT (unixepoch()),\n  updated_at INTEGER NOT NULL DEFAULT (unixepoch())\n);\n\n-- Consolidation history for monitoring\nCREATE TABLE IF NOT EXISTS consolidation_history (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  timestamp INTEGER NOT NULL DEFAULT (unixepoch()),\n  patterns_processed INTEGER NOT NULL,\n  patterns_preserved INTEGER NOT NULL,\n  patterns_pruned INTEGER NOT NULL,\n  preservation_rate REAL NOT NULL,\n  duration_ms INTEGER NOT NULL,\n  average_importance REAL NOT NULL\n);\n";
+/**
+ * Fisher Information Matrix interface
+ */
+export interface IFisherInformationMatrix {
+    getImportance(dimensionIndex: number): number;
+    update(gradient: Float32Array): void;
+    decay(decayFactor: number): void;
+    getImportanceVector(): Float32Array;
+    getAverageImportance(): number;
+    serialize(): Buffer;
+    deserialize(buffer: Buffer): void;
+    reset(): void;
+    getUpdateCount(): number;
+}
+/**
+ * Fisher Information Matrix implementation for EWC++
+ *
+ * Stores diagonal approximation of Fisher Information,
+ * indicating which "weights" (pattern dimensions) are important.
+ *
+ * In the context of pattern storage:
+ * - Each dimension of the context embedding has an importance value
+ * - High importance = changing this dimension would harm prediction
+ * - Low importance = safe to overwrite with new patterns
+ */
+export declare class FisherInformationMatrix implements IFisherInformationMatrix {
+    private dimensions;
+    /** Diagonal of Fisher Information (importance per dimension) */
+    private importance;
+    /** Running sum for online updates */
+    private runningSum;
+    /** Number of updates performed */
+    private updateCount;
+    constructor(dimensions: number);
+    getImportance(dimensionIndex: number): number;
+    update(gradient: Float32Array): void;
+    decay(decayFactor: number): void;
+    getImportanceVector(): Float32Array;
+    getAverageImportance(): number;
+    serialize(): Buffer;
+    deserialize(buffer: Buffer): void;
+    reset(): void;
+    getUpdateCount(): number;
+}
+/**
+ * Convert pattern context to text for embedding
+ */
+export declare function contextToText(context: PatternRecommendationContext): string;
+/**
+ * Compute gradient between two embeddings
+ */
+export declare function computeGradient(a: Float32Array, b: Float32Array): Float32Array;
+/**
+ * Deserialize embedding from buffer
+ */
+export declare function deserializeEmbedding(buffer: Buffer, dimensions: number): Float32Array;
+/**
+ * Calculate cosine similarity between two embeddings
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/**
+ * Calculate importance-weighted similarity
+ */
+export declare function importanceWeightedSimilarity(a: Float32Array, b: Float32Array, importance: Float32Array): number;
+/**
+ * Calculate pattern importance based on outcome and access patterns
+ */
+export declare function calculatePatternImportance(pattern: StoredPattern, outcome: PatternOutcome): number;
+/**
+ * Calculate dimension-based importance using Fisher Information
+ */
+export declare function calculateDimensionImportance(pattern: StoredPattern, importanceVector: Float32Array, dimensions: number, lambda: number): number;
+/**
+ * Convert database row to StoredPattern
+ */
+export declare function rowToStoredPattern(row: PatternRow, dimensions: number): StoredPattern;
+//# sourceMappingURL=PatternStore.helpers.d.ts.map

package/dist/src/learning/PatternStore.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternStore.helpers.d.ts","sourceRoot":"","sources":["../../../src/learning/PatternStore.helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,aAAa,EACb,cAAc,EACd,UAAU,EACX,MAAM,yBAAyB,CAAA;AAMhC;;GAEG;AACH,eAAO,MAAM,oBAAoB,ooDA4ChC,CAAA;AAMD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7C,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,mBAAmB,IAAI,YAAY,CAAA;IACnC,oBAAoB,IAAI,MAAM,CAAA;IAC9B,SAAS,IAAI,MAAM,CAAA;IACnB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,KAAK,IAAI,IAAI,CAAA;IACb,cAAc,IAAI,MAAM,CAAA;CACzB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IAU1D,OAAO,CAAC,UAAU;IAT9B,gEAAgE;IAChE,OAAO,CAAC,UAAU,CAAc;IAEhC,qCAAqC;IACrC,OAAO,CAAC,UAAU,CAAc;IAEhC,kCAAkC;IAClC,OAAO,CAAC,WAAW,CAAY;gBAEX,UAAU,EAAE,MAAM;IAKtC,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAI7C,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAapC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAUhC,mBAAmB,IAAI,YAAY;IAInC,oBAAoB,IAAI,MAAM;IAQ9B,SAAS,IAAI,MAAM;IAcnB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwBjC,KAAK,IAAI,IAAI;IAMb,cAAc,IAAI,MAAM;CAGzB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CAoB3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAM9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAMrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAazE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,YAAY,EACf,CAAC,EAAE,YAAY,EACf,UAAU,EAAE,YAAY,GACvB,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,cAAc,GACtB,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,YAAY,EAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAiBrF"}