@skillsmith/core 0.5.6 → 0.5.8

package/dist/learning/types.d.ts

@@ -1,284 +0,0 @@
-/**
- * @fileoverview Type definitions for Recommendation Learning Loop
- * @module @skillsmith/core/learning/types
- * @see docs/phase4/epic1/recommendation-learning-loop-design.md
- *
- * Epic 1 - Sub-issue 5: Build Recommendation Learning Loop
- * Owner: Data Scientist
- *
- * Provides type-safe interfaces for:
- * - Signal collection (accept/dismiss/usage)
- * - User preference profiles
- * - Learning algorithm configuration
- * - Privacy-preserving storage
- */
-/**
- * User interaction signal types for recommendation learning
- */
-export declare enum SignalType {
-    /** User accepted and installed recommended skill */
-    ACCEPT = "accept",
-    /** User explicitly dismissed recommendation */
-    DISMISS = "dismiss",
-    /** User actively uses installed skill (daily usage) */
-    USAGE_DAILY = "usage_daily",
-    /** User rarely uses installed skill (weekly usage) */
-    USAGE_WEEKLY = "usage_weekly",
-    /** Skill installed but never used (30+ days) */
-    ABANDONED = "abandoned",
-    /** User uninstalled previously accepted skill */
-    UNINSTALL = "uninstall"
-}
-/**
- * Signal strength weights for learning algorithm
- * Range: [-1.0, 1.0] where:
- * - Positive = user preference signal
- * - Negative = user rejection signal
- */
-export declare const SIGNAL_WEIGHTS: Readonly<Record<SignalType, number>>;
-/**
- * Reason for dismissing a recommendation
- */
-export declare enum DismissReason {
-    /** Not relevant to current work */
-    NOT_RELEVANT = "not_relevant",
-    /** Already have similar functionality */
-    DUPLICATE = "duplicate",
-    /** Don't trust the source */
-    TRUST_ISSUE = "trust_issue",
-    /** Too complex/heavyweight */
-    TOO_COMPLEX = "too_complex",
-    /** No specific reason */
-    OTHER = "other"
-}
-/**
- * Skill category enum (aligned with skill schema)
- */
-export declare enum SkillCategory {
-    GIT = "git",
-    TESTING = "testing",
-    DOCUMENTATION = "documentation",
-    DEVOPS = "devops",
-    FRONTEND = "frontend",
-    BACKEND = "backend",
-    DATABASE = "database",
-    SECURITY = "security",
-    PRODUCTIVITY = "productivity",
-    ANALYSIS = "analysis"
-}
-/**
- * Context when skill was recommended
- */
-export interface RecommendationContext {
-    /** Skills installed at recommendation time */
-    installed_skills: string[];
-    /** Project context used for recommendation */
-    project_context?: string;
-    /** Similarity score at recommendation time */
-    original_score: number;
-    /** Trust tier of recommended skill */
-    trust_tier?: string;
-    /** Category of recommended skill */
-    category?: string;
-}
-/**
- * Optional metadata for signal events
- */
-export interface SignalMetadata {
-    /** Time between recommendation and action (ms) */
-    time_to_action?: number;
-    /** Number of times skill was suggested before action */
-    suggestion_count?: number;
-    /** Additional context-specific data */
-    extra?: Record<string, unknown>;
-}
-/**
- * Individual signal event stored in database
- */
-export interface SignalEvent {
-    /** Unique event ID (UUID) */
-    id: string;
-    /** Signal type */
-    type: SignalType;
-    /** Skill that was recommended/interacted with */
-    skill_id: string;
-    /** Unix timestamp (ms) of event */
-    timestamp: number;
-    /** Recommendation context when skill was suggested */
-    context: RecommendationContext;
-    /** Optional metadata */
-    metadata?: SignalMetadata;
-    /** Dismiss reason (only for DISMISS signals) */
-    dismiss_reason?: DismissReason;
-}
-/**
- * Filter for querying signal events
- */
-export interface SignalFilter {
-    /** Filter by skill ID */
-    skill_id?: string;
-    /** Filter by signal type */
-    type?: SignalType | SignalType[];
-    /** Filter by time range */
-    time_range?: {
-        start: number;
-        end: number;
-    };
-    /** Filter by category */
-    category?: SkillCategory;
-}
-/**
- * User-specific preference profile (local storage only)
- * PRIVACY: This data never leaves the local machine
- */
-export interface UserPreferenceProfile {
-    /** Profile schema version for migrations */
-    version: number;
-    /** Last updated timestamp (ms) */
-    last_updated: number;
-    /** Total signals collected */
-    signal_count: number;
-    /** Category preferences learned from signals
-     * Range: [-2.0, 2.0] where:
-     * - Positive = user prefers this category
-     * - Negative = user avoids this category
-     */
-    category_weights: Partial<Record<SkillCategory, number>>;
-    /** Trust tier preferences
-     * Range: [-2.0, 2.0]
-     */
-    trust_tier_weights: Record<string, number>;
-    /** Keyword/tag preferences
-     * Range: [-2.0, 2.0]
-     */
-    keyword_weights: Record<string, number>;
-    /** Anti-preferences (things user consistently dismisses) */
-    negative_patterns: {
-        /** Keywords user doesn't like */
-        keywords: string[];
-        /** Categories user avoids */
-        categories: SkillCategory[];
-        /** Specific skills user explicitly doesn't want */
-        skill_ids: string[];
-    };
-    /** Usage pattern insights */
-    usage_patterns: {
-        /** Average time from install to first use (ms) */
-        avg_time_to_first_use_ms: number;
-        /** Percentage of accepted skills actually used (0-1) */
-        utilization_rate: number;
-        /** Most used skill categories (ordered by frequency) */
-        top_categories: SkillCategory[];
-    };
-}
-/**
- * Learning hyperparameters (tunable)
- */
-export interface LearningConfig {
-    /** Base learning rate for weight updates (default: 0.1)
-     * Range: [0.01, 0.5]
-     */
-    learning_rate: number;
-    /** Time decay factor for old signals (default: 0.95/month)
-     * Range: [0.8, 1.0] where 1.0 = no decay
-     */
-    decay_factor: number;
-    /** Minimum signals before personalization kicks in */
-    min_signals_threshold: number;
-    /** Weight clipping bounds to prevent extreme values */
-    weight_bounds: {
-        min: number;
-        max: number;
-    };
-    /** Data retention period (days) */
-    signal_retention_days: number;
-}
-/**
- * Default learning configuration
- */
-export declare const DEFAULT_LEARNING_CONFIG: Readonly<LearningConfig>;
-/**
- * Cold start default weights (before personalization)
- * Based on aggregate popularity data
- */
-export declare const COLD_START_WEIGHTS: Readonly<{
-    category_weights: Partial<Record<SkillCategory, number>>;
-    trust_tier_weights: Record<string, number>;
-}>;
-/**
- * Personalized recommendation result
- */
-export interface PersonalizedRecommendation {
-    /** Skill identifier */
-    skill_id: string;
-    /** Base similarity score [0-1] */
-    base_score: number;
-    /** Personalized score after learning adjustments [0-1] */
-    personalized_score: number;
-    /** Whether personalization was applied */
-    personalization_applied: boolean;
-    /** Breakdown of score adjustments */
-    score_breakdown: {
-        category_boost: number;
-        trust_boost: number;
-        keyword_boost: number;
-        anti_penalty: number;
-    };
-}
-/**
- * Aggregate statistics (anonymized, no PII)
- */
-export interface AggregateStats {
-    /** Date (YYYY-MM-DD) */
-    date: string;
-    /** Total signals recorded */
-    total_signals: number;
-    /** Breakdown by signal type */
-    signal_counts: Partial<Record<SignalType, number>>;
-    /** Average accept rate */
-    avg_accept_rate: number;
-    /** Average utilization rate */
-    avg_utilization_rate: number;
-    /** Popular categories */
-    popular_categories: Array<{
-        category: SkillCategory;
-        count: number;
-    }>;
-}
-/**
- * User data export (GDPR-style)
- */
-export interface UserDataExport {
-    /** Export timestamp */
-    exported_at: number;
-    /** Profile version */
-    version: number;
-    /** User preference profile */
-    profile: UserPreferenceProfile;
-    /** All signal events */
-    signals: SignalEvent[];
-    /** Aggregate stats */
-    stats: AggregateStats[];
-}
-/**
- * Events emitted by learning system
- */
-export interface LearningEvents {
-    /** Signal recorded successfully */
-    'signal:recorded': {
-        signal_id: string;
-        type: SignalType;
-        skill_id: string;
-    };
-    /** Profile updated */
-    'profile:updated': {
-        signal_count: number;
-        personalization_active: boolean;
-    };
-    /** Data purged (privacy cleanup) */
-    'data:purged': {
-        signals_deleted: number;
-        retention_days: number;
-    };
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/learning/types.d.ts.map

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

package/dist/learning/types.js

@@ -1,112 +0,0 @@
-/**
- * @fileoverview Type definitions for Recommendation Learning Loop
- * @module @skillsmith/core/learning/types
- * @see docs/phase4/epic1/recommendation-learning-loop-design.md
- *
- * Epic 1 - Sub-issue 5: Build Recommendation Learning Loop
- * Owner: Data Scientist
- *
- * Provides type-safe interfaces for:
- * - Signal collection (accept/dismiss/usage)
- * - User preference profiles
- * - Learning algorithm configuration
- * - Privacy-preserving storage
- */
-/**
- * User interaction signal types for recommendation learning
- */
-export var SignalType;
-(function (SignalType) {
-    /** User accepted and installed recommended skill */
-    SignalType["ACCEPT"] = "accept";
-    /** User explicitly dismissed recommendation */
-    SignalType["DISMISS"] = "dismiss";
-    /** User actively uses installed skill (daily usage) */
-    SignalType["USAGE_DAILY"] = "usage_daily";
-    /** User rarely uses installed skill (weekly usage) */
-    SignalType["USAGE_WEEKLY"] = "usage_weekly";
-    /** Skill installed but never used (30+ days) */
-    SignalType["ABANDONED"] = "abandoned";
-    /** User uninstalled previously accepted skill */
-    SignalType["UNINSTALL"] = "uninstall";
-})(SignalType || (SignalType = {}));
-/**
- * Signal strength weights for learning algorithm
- * Range: [-1.0, 1.0] where:
- * - Positive = user preference signal
- * - Negative = user rejection signal
- */
-export const SIGNAL_WEIGHTS = {
-    [SignalType.ACCEPT]: 0.5,
-    [SignalType.DISMISS]: -0.3,
-    [SignalType.USAGE_DAILY]: 1.0,
-    [SignalType.USAGE_WEEKLY]: 0.3,
-    [SignalType.ABANDONED]: -0.7,
-    [SignalType.UNINSTALL]: -1.0,
-};
-/**
- * Reason for dismissing a recommendation
- */
-export var DismissReason;
-(function (DismissReason) {
-    /** Not relevant to current work */
-    DismissReason["NOT_RELEVANT"] = "not_relevant";
-    /** Already have similar functionality */
-    DismissReason["DUPLICATE"] = "duplicate";
-    /** Don't trust the source */
-    DismissReason["TRUST_ISSUE"] = "trust_issue";
-    /** Too complex/heavyweight */
-    DismissReason["TOO_COMPLEX"] = "too_complex";
-    /** No specific reason */
-    DismissReason["OTHER"] = "other";
-})(DismissReason || (DismissReason = {}));
-/**
- * Skill category enum (aligned with skill schema)
- */
-export var SkillCategory;
-(function (SkillCategory) {
-    SkillCategory["GIT"] = "git";
-    SkillCategory["TESTING"] = "testing";
-    SkillCategory["DOCUMENTATION"] = "documentation";
-    SkillCategory["DEVOPS"] = "devops";
-    SkillCategory["FRONTEND"] = "frontend";
-    SkillCategory["BACKEND"] = "backend";
-    SkillCategory["DATABASE"] = "database";
-    SkillCategory["SECURITY"] = "security";
-    SkillCategory["PRODUCTIVITY"] = "productivity";
-    SkillCategory["ANALYSIS"] = "analysis";
-})(SkillCategory || (SkillCategory = {}));
-/**
- * Default learning configuration
- */
-export const DEFAULT_LEARNING_CONFIG = {
-    learning_rate: 0.1,
-    decay_factor: 0.95,
-    min_signals_threshold: 5,
-    weight_bounds: {
-        min: -2.0,
-        max: 2.0,
-    },
-    signal_retention_days: 90,
-};
-/**
- * Cold start default weights (before personalization)
- * Based on aggregate popularity data
- */
-export const COLD_START_WEIGHTS = {
-    category_weights: {
-        [SkillCategory.TESTING]: 0.3,
-        [SkillCategory.GIT]: 0.3,
-        [SkillCategory.DEVOPS]: 0.2,
-        [SkillCategory.DOCUMENTATION]: 0.1,
-        [SkillCategory.FRONTEND]: 0.2,
-        [SkillCategory.BACKEND]: 0.2,
-    },
-    trust_tier_weights: {
-        verified: 0.2,
-        community: 0.0,
-        standard: -0.1,
-        unverified: -0.3,
-    },
-};
-//# sourceMappingURL=types.js.map

package/dist/learning/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/learning/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,oDAAoD;IACpD,+BAAiB,CAAA;IACjB,+CAA+C;IAC/C,iCAAmB,CAAA;IACnB,uDAAuD;IACvD,yCAA2B,CAAA;IAC3B,sDAAsD;IACtD,2CAA6B,CAAA;IAC7B,gDAAgD;IAChD,qCAAuB,CAAA;IACvB,iDAAiD;IACjD,qCAAuB,CAAA;AACzB,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyC;IAClE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG;IACxB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG;IAC1B,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,GAAG;IAC7B,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,GAAG;IAC9B,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG;IAC5B,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG;CACpB,CAAA;AAEV;;GAEG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,mCAAmC;IACnC,8CAA6B,CAAA;IAC7B,yCAAyC;IACzC,wCAAuB,CAAA;IACvB,6BAA6B;IAC7B,4CAA2B,CAAA;IAC3B,8BAA8B;IAC9B,4CAA2B,CAAA;IAC3B,yBAAyB;IACzB,gCAAe,CAAA;AACjB,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAWX;AAXD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,oCAAmB,CAAA;IACnB,gDAA+B,CAAA;IAC/B,kCAAiB,CAAA;IACjB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,sCAAqB,CAAA;IACrB,8CAA6B,CAAA;IAC7B,sCAAqB,CAAA;AACvB,CAAC,EAXW,aAAa,KAAb,aAAa,QAWxB;AAgJD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,IAAI;IAClB,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE;QACb,GAAG,EAAE,CAAC,GAAG;QACT,GAAG,EAAE,GAAG;KACT;IACD,qBAAqB,EAAE,EAAE;CACjB,CAAA;AAEV;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAG1B;IACH,gBAAgB,EAAE;QAChB,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG;QAC5B,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG;QACxB,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG;QAC3B,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,GAAG;QAClC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG;QAC7B,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG;KAC7B;IACD,kBAAkB,EAAE;QAClB,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,CAAC,GAAG;QACd,UAAU,EAAE,CAAC,GAAG;KACjB;CACO,CAAA"}

package/dist/matching/OverlapDetector.d.ts

@@ -1,152 +0,0 @@
-/**
- * @fileoverview Trigger phrase overlap detection for skills
- * @module @skillsmith/core/matching/OverlapDetector
- * @see SMI-604: Trigger phrase overlap detection
- *
- * Detects similarity between skill trigger phrases to prevent
- * recommending skills that overlap too much with installed ones.
- *
- * @example
- * const detector = new OverlapDetector({ useFallback: true });
- * const overlap = await detector.detectOverlap(skill1, skill2);
- * if (overlap.overlapScore > 0.8) {
- *   console.log('Skills are too similar:', overlap.overlappingPhrases);
- * }
- */
-import { type EmbeddingServiceOptions } from '../embeddings/index.js';
-/**
- * Skill with trigger phrases for overlap detection
- */
-export interface TriggerPhraseSkill {
-    /** Unique skill identifier */
-    id: string;
-    /** Skill display name */
-    name: string;
-    /** Trigger phrases that activate this skill */
-    triggerPhrases: string[];
-}
-/**
- * Result of overlap detection between two skills
- */
-export interface OverlapResult {
-    /** First skill ID */
-    skillId1: string;
-    /** Second skill ID */
-    skillId2: string;
-    /** Overall overlap score (0-1) */
-    overlapScore: number;
-    /** Specific phrases that overlap */
-    overlappingPhrases: Array<{
-        phrase1: string;
-        phrase2: string;
-        similarity: number;
-    }>;
-    /** Whether skills are considered duplicates */
-    isDuplicate: boolean;
-}
-/**
- * Result of filtering skills by overlap
- */
-export interface FilteredSkillsResult {
-    /** Skills that passed the overlap filter */
-    accepted: TriggerPhraseSkill[];
-    /** Skills that were rejected due to overlap */
-    rejected: Array<{
-        skill: TriggerPhraseSkill;
-        overlapsWith: string;
-        overlapScore: number;
-    }>;
-}
-/**
- * Options for OverlapDetector
- */
-export interface OverlapDetectorOptions extends EmbeddingServiceOptions {
-    /** Similarity threshold for phrase matching (0-1, default 0.75) */
-    phraseThreshold?: number;
-    /** Overall overlap threshold for skill rejection (0-1, default 0.6) */
-    overlapThreshold?: number;
-    /** Whether to use exact string matching in addition to semantic (default true) */
-    useExactMatch?: boolean;
-}
-/**
- * Detects overlap between skill trigger phrases.
- *
- * Uses semantic similarity to identify skills that respond to
- * similar user inputs, preventing confusing recommendations.
- *
- * @example
- * const detector = new OverlapDetector({ overlapThreshold: 0.7 });
- * const result = await detector.filterByOverlap(candidates, installed);
- * // Use result.accepted for recommendations
- */
-export declare class OverlapDetector {
-    private embeddingService;
-    private phraseEmbeddings;
-    private readonly phraseThreshold;
-    private readonly overlapThreshold;
-    private readonly useExactMatch;
-    constructor(options?: OverlapDetectorOptions);
-    /**
-     * Check if detector is using fallback mode
-     */
-    isUsingFallback(): boolean;
-    /**
-     * Detect overlap between two skills.
-     *
-     * @param skill1 - First skill
-     * @param skill2 - Second skill
-     * @returns Detailed overlap analysis
-     */
-    detectOverlap(skill1: TriggerPhraseSkill, skill2: TriggerPhraseSkill): Promise<OverlapResult>;
-    /**
-     * Check for exact string match (case-insensitive, normalized)
-     */
-    private isExactMatch;
-    /**
-     * Get or compute embedding for a phrase
-     */
-    private getPhraseEmbedding;
-    /**
-     * Filter candidate skills by overlap with installed skills.
-     *
-     * Removes candidates that have too much trigger phrase overlap
-     * with already installed skills.
-     *
-     * @param candidates - Skills to consider for recommendation
-     * @param installed - Currently installed skills
-     * @returns Filtered results with accepted and rejected skills
-     *
-     * @example
-     * const result = await detector.filterByOverlap(candidates, installed);
-     * console.log(`Accepted: ${result.accepted.length}`);
-     * console.log(`Rejected: ${result.rejected.length}`);
-     */
-    filterByOverlap(candidates: TriggerPhraseSkill[], installed: TriggerPhraseSkill[]): Promise<FilteredSkillsResult>;
-    /**
-     * Find all overlapping skill pairs in a set.
-     *
-     * Useful for auditing a skill library for potential conflicts.
-     *
-     * @param skills - Skills to check for overlaps
-     * @returns List of overlapping pairs
-     */
-    findAllOverlaps(skills: TriggerPhraseSkill[]): Promise<OverlapResult[]>;
-    /**
-     * Get overlap threshold
-     */
-    getOverlapThreshold(): number;
-    /**
-     * Get phrase similarity threshold
-     */
-    getPhraseThreshold(): number;
-    /**
-     * Clear cached embeddings
-     */
-    clear(): void;
-    /**
-     * Close resources
-     */
-    close(): void;
-}
-export default OverlapDetector;
-//# sourceMappingURL=OverlapDetector.d.ts.map

package/dist/matching/OverlapDetector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OverlapDetector.d.ts","sourceRoot":"","sources":["../../src/matching/OverlapDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAEvF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,kBAAkB,EAAE,KAAK,CAAC;QACxB,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;IACF,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,kBAAkB,CAAA;QACzB,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kFAAkF;IAClF,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,sBAA2B;IAOhD;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,aAAa,CAAC;IA0DzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;YACW,kBAAkB;IAWhC;;;;;;;;;;;;;;OAcG;IACG,eAAe,CACnB,UAAU,EAAE,kBAAkB,EAAE,EAChC,SAAS,EAAE,kBAAkB,EAAE,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA0ChC;;;;;;;OAOG;IACG,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAmB7E;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAe,eAAe,CAAA"}