@skillsmith/core 0.1.0

package/dist/src/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/src/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/index.test.ts"],"names":[],"mappings":""}

package/dist/src/index.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { SCHEMA_VERSION } from './index.js';
+describe('@skillsmith/core', () => {
+    describe('SCHEMA_VERSION', () => {
+        it('should be defined', () => {
+            expect(SCHEMA_VERSION).toBeDefined();
+            expect(typeof SCHEMA_VERSION).toBe('number');
+        });
+        it('should be a positive integer', () => {
+            expect(SCHEMA_VERSION).toBeGreaterThan(0);
+            expect(Number.isInteger(SCHEMA_VERSION)).toBe(true);
+        });
+    });
+    describe('Module exports', () => {
+        it('should export database utilities', async () => {
+            const mod = await import('./index.js');
+            expect(mod.createDatabase).toBeDefined();
+            expect(mod.closeDatabase).toBeDefined();
+            expect(mod.initializeSchema).toBeDefined();
+        });
+        it('should export SkillRepository', async () => {
+            const mod = await import('./index.js');
+            expect(mod.SkillRepository).toBeDefined();
+        });
+        it('should export CacheRepository', async () => {
+            const mod = await import('./index.js');
+            expect(mod.CacheRepository).toBeDefined();
+        });
+        it('should export SearchService', async () => {
+            const mod = await import('./index.js');
+            expect(mod.SearchService).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/src/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAA;YACpC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;YACzC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACtC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAA;YACxC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAA;YACvC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,WAAW,EAAE,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACtC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACtC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAA;QAC3C,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;YACtC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAA;QACzC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/indexer/GitHubIndexer.d.ts

@@ -0,0 +1,107 @@
+/**
+ * SMI-628: GitHubIndexer - Fetches skill repositories from GitHub
+ *
+ * Provides:
+ * - Search GitHub for claude code skill repositories
+ * - Rate limit handling
+ * - Repository metadata extraction
+ */
+import type { SkillCreateInput } from '../types/skill.js';
+/**
+ * Skill metadata extracted from repository indexing
+ * Used by IndexerRepository for database operations
+ */
+export interface SkillMetadata {
+    name: string;
+    description: string | null;
+    author: string | null;
+    version: string | null;
+    tags: string[];
+    dependencies: string[];
+    category: string | null;
+    license: string | null;
+    rawContent: string;
+    repoUrl: string;
+    filePath: string;
+    sha: string;
+    owner: string;
+    repo: string;
+}
+/**
+ * GitHub repository metadata
+ */
+export interface GitHubRepository {
+    owner: string;
+    name: string;
+    fullName: string;
+    description: string | null;
+    url: string;
+    stars: number;
+    forks: number;
+    topics: string[];
+    updatedAt: string;
+    defaultBranch: string;
+}
+/**
+ * Options for GitHub indexing
+ */
+export interface GitHubIndexerOptions {
+    /** GitHub API token (optional but recommended for higher rate limits) */
+    token?: string;
+    /** Maximum repositories to fetch per request */
+    perPage?: number;
+    /** Delay between API calls in ms (default: 150) */
+    requestDelay?: number;
+    /** Topics to search for */
+    topics?: string[];
+}
+/**
+ * Result of an indexing operation
+ */
+export interface IndexResult {
+    /** Number of repositories found */
+    found: number;
+    /** Number successfully indexed */
+    indexed: number;
+    /** Number of failures */
+    failed: number;
+    /** Error messages for failures */
+    errors: string[];
+    /** Indexed repositories */
+    repositories: GitHubRepository[];
+}
+/**
+ * Indexes skill repositories from GitHub
+ */
+export declare class GitHubIndexer {
+    private token?;
+    private perPage;
+    private requestDelay;
+    private topics;
+    constructor(options?: GitHubIndexerOptions);
+    /**
+     * Delay between API calls to avoid rate limiting
+     */
+    private delay;
+    /**
+     * Build GitHub API headers
+     */
+    private buildHeaders;
+    /**
+     * Search GitHub for repositories by topic or query
+     */
+    searchRepositories(query: string, page?: number): Promise<IndexResult>;
+    /**
+     * Index all configured topics
+     */
+    indexAllTopics(maxPagesPerTopic?: number): Promise<IndexResult>;
+    /**
+     * Index repositories by first letter filter (A-F, G-L, etc.)
+     */
+    indexByLetterRange(startLetter: string, endLetter: string, maxPages?: number): Promise<IndexResult>;
+    /**
+     * Convert GitHub repository to SkillCreateInput
+     */
+    repositoryToSkill(repo: GitHubRepository): SkillCreateInput;
+}
+//# sourceMappingURL=GitHubIndexer.d.ts.map

package/dist/src/indexer/GitHubIndexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubIndexer.d.ts","sourceRoot":"","sources":["../../../src/indexer/GitHubIndexer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,2BAA2B;IAC3B,YAAY,EAAE,gBAAgB,EAAE,CAAA;CACjC;AAgCD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,MAAM,CAAU;gBAEZ,OAAO,GAAE,oBAAyB;IAO9C;;OAEG;YACW,KAAK;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAiE/E;;OAEG;IACG,cAAc,CAAC,gBAAgB,GAAE,MAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCxE;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAU,GACnB,OAAO,CAAC,WAAW,CAAC;IAyCvB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB;CA0B5D"}

package/dist/src/indexer/GitHubIndexer.js

@@ -0,0 +1,202 @@
+/**
+ * SMI-628: GitHubIndexer - Fetches skill repositories from GitHub
+ *
+ * Provides:
+ * - Search GitHub for claude code skill repositories
+ * - Rate limit handling
+ * - Repository metadata extraction
+ */
+const DEFAULT_TOPICS = ['claude-code-skill', 'claude-code', 'anthropic-claude', 'claude-skill'];
+/**
+ * Indexes skill repositories from GitHub
+ */
+export class GitHubIndexer {
+    token;
+    perPage;
+    requestDelay;
+    topics;
+    constructor(options = {}) {
+        this.token = options.token;
+        this.perPage = options.perPage ?? 30;
+        this.requestDelay = options.requestDelay ?? 150;
+        this.topics = options.topics ?? DEFAULT_TOPICS;
+    }
+    /**
+     * Delay between API calls to avoid rate limiting
+     */
+    async delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Build GitHub API headers
+     */
+    buildHeaders() {
+        const headers = {
+            Accept: 'application/vnd.github.v3+json',
+            'User-Agent': 'skillsmith-indexer/1.0',
+        };
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        return headers;
+    }
+    /**
+     * Search GitHub for repositories by topic or query
+     */
+    async searchRepositories(query, page = 1) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        try {
+            const searchQuery = encodeURIComponent(query);
+            const url = `https://api.github.com/search/repositories?q=${searchQuery}&per_page=${this.perPage}&page=${page}`;
+            const response = await fetch(url, {
+                headers: this.buildHeaders(),
+            });
+            if (!response.ok) {
+                if (response.status === 403) {
+                    result.errors.push('GitHub API rate limit exceeded');
+                }
+                else {
+                    result.errors.push(`GitHub API error: ${response.status}`);
+                }
+                result.failed = 1;
+                return result;
+            }
+            const data = (await response.json());
+            result.found = data.total_count;
+            for (const item of data.items) {
+                try {
+                    const repo = {
+                        owner: item.owner.login,
+                        name: item.name,
+                        fullName: item.full_name,
+                        description: item.description,
+                        url: item.html_url,
+                        stars: item.stargazers_count,
+                        forks: item.forks_count,
+                        topics: item.topics || [],
+                        updatedAt: item.updated_at,
+                        defaultBranch: item.default_branch,
+                    };
+                    result.repositories.push(repo);
+                    result.indexed++;
+                }
+                catch (error) {
+                    result.failed++;
+                    result.errors.push(`Failed to parse repository ${item.full_name}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                }
+            }
+            await this.delay(this.requestDelay);
+        }
+        catch (error) {
+            result.errors.push(`Network error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            result.failed = 1;
+        }
+        return result;
+    }
+    /**
+     * Index all configured topics
+     */
+    async indexAllTopics(maxPagesPerTopic = 3) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        const seenUrls = new Set();
+        for (const topic of this.topics) {
+            for (let page = 1; page <= maxPagesPerTopic; page++) {
+                const query = `topic:${topic}`;
+                const pageResult = await this.searchRepositories(query, page);
+                result.found += pageResult.found;
+                result.errors.push(...pageResult.errors);
+                for (const repo of pageResult.repositories) {
+                    if (!seenUrls.has(repo.url)) {
+                        seenUrls.add(repo.url);
+                        result.repositories.push(repo);
+                        result.indexed++;
+                    }
+                }
+                result.failed += pageResult.failed;
+                // Break if we've fetched all results for this topic
+                if (pageResult.repositories.length < this.perPage) {
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Index repositories by first letter filter (A-F, G-L, etc.)
+     */
+    async indexByLetterRange(startLetter, endLetter, maxPages = 3) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        const seenUrls = new Set();
+        for (const topic of this.topics) {
+            for (let page = 1; page <= maxPages; page++) {
+                const query = `topic:${topic}`;
+                const pageResult = await this.searchRepositories(query, page);
+                result.found += pageResult.found;
+                result.errors.push(...pageResult.errors);
+                for (const repo of pageResult.repositories) {
+                    const firstLetter = repo.name.charAt(0).toUpperCase();
+                    if (firstLetter >= startLetter.toUpperCase() && firstLetter <= endLetter.toUpperCase()) {
+                        if (!seenUrls.has(repo.url)) {
+                            seenUrls.add(repo.url);
+                            result.repositories.push(repo);
+                            result.indexed++;
+                        }
+                    }
+                }
+                result.failed += pageResult.failed;
+                if (pageResult.repositories.length < this.perPage) {
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert GitHub repository to SkillCreateInput
+     */
+    repositoryToSkill(repo) {
+        // Calculate quality score based on stars and activity
+        const starScore = Math.min(repo.stars / 10, 50); // Max 50 from stars
+        const forkScore = Math.min(repo.forks / 5, 25); // Max 25 from forks
+        const qualityScore = Math.round(starScore + forkScore + 25); // Base 25 points
+        // Determine trust tier based on indicators
+        let trustTier = 'unknown';
+        if (repo.topics.includes('claude-code-official')) {
+            trustTier = 'verified';
+        }
+        else if (repo.stars >= 50) {
+            trustTier = 'community';
+        }
+        else if (repo.stars >= 5) {
+            trustTier = 'experimental';
+        }
+        return {
+            name: repo.name,
+            description: repo.description,
+            author: repo.owner,
+            repoUrl: repo.url,
+            qualityScore,
+            trustTier,
+            tags: repo.topics,
+        };
+    }
+}
+//# sourceMappingURL=GitHubIndexer.js.map

package/dist/src/indexer/GitHubIndexer.js.map

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

package/dist/src/indexer/PartitionStrategy.d.ts

@@ -0,0 +1,115 @@
+/**
+ * SMI-643: PartitionStrategy - Load balancing for parallel repository indexing
+ *
+ * Provides:
+ * - Partition repositories by letter range (A-F, G-L, M-R, S-Z)
+ * - Load balancing across workers
+ * - Handle uneven distributions
+ */
+import type { GitHubRepository } from './GitHubIndexer.js';
+/**
+ * A partition of repositories for a worker
+ */
+export interface Partition {
+    /** Unique partition identifier */
+    id: string;
+    /** Start letter for this partition (inclusive) */
+    startLetter: string;
+    /** End letter for this partition (inclusive) */
+    endLetter: string;
+    /** Letter pattern description (e.g., "A-F") */
+    range: string;
+    /** Repositories assigned to this partition */
+    repositories: GitHubRepository[];
+}
+/**
+ * Options for partitioning strategy
+ */
+export interface PartitionOptions {
+    /** Number of partitions to create (default: 4) */
+    partitionCount?: number;
+    /** Custom partition ranges (overrides partitionCount) */
+    customRanges?: Array<{
+        start: string;
+        end: string;
+    }>;
+}
+/**
+ * Default letter ranges for 4-way partitioning
+ */
+export declare const DEFAULT_PARTITION_RANGES: Array<{
+    start: string;
+    end: string;
+}>;
+/**
+ * Partition strategy for distributing repositories across workers
+ */
+export declare class PartitionStrategy {
+    private ranges;
+    constructor(options?: PartitionOptions);
+    /**
+     * Generate balanced letter ranges for any partition count
+     */
+    private generateRanges;
+    /**
+     * Get the partition ranges
+     */
+    getRanges(): Array<{
+        start: string;
+        end: string;
+    }>;
+    /**
+     * Get empty partitions for workers to fill
+     */
+    createEmptyPartitions(): Partition[];
+    /**
+     * Check if a repository name belongs to a specific partition
+     */
+    belongsToPartition(repoName: string, partition: Partition): boolean;
+    /**
+     * Assign a single repository to the appropriate partition
+     */
+    assignToPartition(repo: GitHubRepository, partitions: Partition[]): Partition | null;
+    /**
+     * Partition a list of repositories across all partitions
+     */
+    partitionRepositories(repositories: GitHubRepository[]): Partition[];
+    /**
+     * Get partition statistics for load balancing analysis
+     */
+    getPartitionStats(partitions: Partition[]): PartitionStats;
+    /**
+     * Rebalance partitions by redistributing excess repositories
+     */
+    rebalancePartitions(partitions: Partition[]): Partition[];
+}
+/**
+ * Statistics about partition distribution
+ */
+export interface PartitionStats {
+    partitionCount: number;
+    totalRepositories: number;
+    averagePerPartition: number;
+    minSize: number;
+    maxSize: number;
+    imbalanceRatio: number;
+    isBalanced: boolean;
+    distribution: Array<{
+        id: string;
+        range: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Create a default partition strategy with 4 workers
+ */
+export declare function createDefaultStrategy(): PartitionStrategy;
+/**
+ * Create a custom partition strategy
+ */
+export declare function createCustomStrategy(ranges: Array<{
+    start: string;
+    end: string;
+}>): PartitionStrategy;
+//# sourceMappingURL=PartitionStrategy.d.ts.map

package/dist/src/indexer/PartitionStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartitionStrategy.d.ts","sourceRoot":"","sources":["../../../src/indexer/PartitionStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,YAAY,EAAE,gBAAgB,EAAE,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK1E,CAAA;AAiCD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAuC;gBAEzC,OAAO,GAAE,gBAAqB;IAS1C;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlD;;OAEG;IACH,qBAAqB,IAAI,SAAS,EAAE;IAUpC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO;IAgBnE;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI;IAWpF;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAAE;IAapE;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,cAAc;IAyB1D;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;CAkC1D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;CACH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAEzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5C,iBAAiB,CAEnB"}