@skillsmith/core 0.5.4 → 0.5.6

package/dist/services/SearchService.js

@@ -0,0 +1,320 @@
+/**
+ * SMI-579: SearchService - FTS5 search with BM25 ranking
+ *
+ * Features:
+ * - Full-text search using SQLite FTS5
+ * - BM25 ranking for relevance scoring
+ * - Phrase queries and boolean operators
+ * - Result highlighting for matched terms
+ * - Pagination support
+ * - Search caching
+ */
+import { CacheRepository } from '../repositories/CacheRepository.js';
+import { escapeFtsToken, buildFtsQuery, buildCacheKey, rowToSkill, buildSearchResult, } from './SearchService.helpers.js';
+// Re-export helpers for testing and advanced usage
+export { escapeFtsToken, buildFtsQuery, buildHighlights } from './SearchService.helpers.js';
+/**
+ * Full-text search service with BM25 ranking
+ */
+export class SearchService {
+    db;
+    cache;
+    cacheTtl;
+    constructor(db, options) {
+        this.db = db;
+        this.cache = new CacheRepository(db);
+        this.cacheTtl = options?.cacheTtl ?? 300; // 5 minutes default
+    }
+    /**
+     * Search skills using FTS5 with BM25 ranking
+     */
+    search(options) {
+        const { query, limit = 20, offset = 0, trustTier, minQualityScore, category, 
+        // SMI-825: Security filters
+        safeOnly, maxRiskScore, } = options;
+        // Check cache first
+        const cacheKey = buildCacheKey(options);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // ADR-019: Handle empty/whitespace-only queries with filter-only search
+        const trimmedQuery = query?.trim() || '';
+        if (trimmedQuery.length === 0) {
+            return this.searchByFiltersOnly(options);
+        }
+        // Build the FTS5 query
+        const ftsQuery = buildFtsQuery(query);
+        // Handle case where query contains only special characters (results in empty FTS query)
+        if (!ftsQuery) {
+            return this.searchByFiltersOnly(options);
+        }
+        // Build filter conditions
+        const filters = [];
+        const params = [ftsQuery];
+        if (trustTier) {
+            filters.push('s.trust_tier = ?');
+            params.push(trustTier);
+        }
+        if (minQualityScore !== undefined) {
+            filters.push('s.quality_score >= ?');
+            params.push(minQualityScore);
+        }
+        // SMI-825: Security filters
+        if (safeOnly) {
+            filters.push('s.security_passed = 1');
+        }
+        if (maxRiskScore !== undefined) {
+            filters.push('(s.risk_score IS NULL OR s.risk_score <= ?)');
+            params.push(maxRiskScore);
+        }
+        // SMI-1787: Category filter - check both junction table AND tags JSON
+        // Junction table may be empty for locally indexed skills
+        if (category) {
+            filters.push(`(
+        EXISTS (
+          SELECT 1 FROM skill_categories sc
+          INNER JOIN categories c ON sc.category_id = c.id
+          WHERE sc.skill_id = s.id AND c.name = ?
+        )
+        OR s.tags LIKE ?
+      )`);
+            params.push(category);
+            params.push(`%"${category}"%`); // Match category in JSON tags array
+        }
+        const whereClause = filters.length > 0 ? `AND ${filters.join(' AND ')}` : '';
+        // Count total results
+        const countSql = `
+      SELECT COUNT(*) as total
+      FROM skills s
+      INNER JOIN skills_fts f ON s.rowid = f.rowid
+      WHERE skills_fts MATCH ?
+      ${whereClause}
+    `;
+        const { total } = this.db.prepare(countSql).get(...params);
+        // Get paginated results with BM25 ranking
+        const searchSql = `
+      SELECT
+        s.*,
+        bm25(skills_fts, 10.0, 5.0, 1.0, 2.0) as rank
+      FROM skills s
+      INNER JOIN skills_fts f ON s.rowid = f.rowid
+      WHERE skills_fts MATCH ?
+      ${whereClause}
+      ORDER BY rank
+      LIMIT ? OFFSET ?
+    `;
+        params.push(limit, offset);
+        const rows = this.db.prepare(searchSql).all(...params);
+        // Build results with highlights
+        const items = rows.map((row) => buildSearchResult(row, query));
+        const result = {
+            items,
+            total,
+            limit,
+            offset,
+            hasMore: offset + items.length < total,
+        };
+        // Cache the results
+        this.cache.set(cacheKey, result, this.cacheTtl);
+        return result;
+    }
+    /**
+     * Search with phrase query support
+     */
+    searchPhrase(phrase, options) {
+        // Wrap in quotes for exact phrase matching
+        const query = `"${phrase.replace(/"/g, '""')}"`;
+        return this.search({ ...options, query });
+    }
+    /**
+     * Search with boolean operators (AND, OR, NOT)
+     */
+    searchBoolean(terms, options) {
+        const parts = [];
+        if (terms.must?.length) {
+            parts.push(terms.must.map((t) => escapeFtsToken(t)).join(' AND '));
+        }
+        if (terms.should?.length) {
+            parts.push(`(${terms.should.map((t) => escapeFtsToken(t)).join(' OR ')})`);
+        }
+        if (terms.not?.length) {
+            parts.push(terms.not.map((t) => `NOT ${escapeFtsToken(t)}`).join(' AND '));
+        }
+        const query = parts.join(' AND ');
+        return this.search({ ...options, query });
+    }
+    /**
+     * Get search suggestions based on partial input
+     */
+    suggest(prefix, limit = 5) {
+        const sql = `
+      SELECT DISTINCT name
+      FROM skills
+      WHERE name LIKE ? || '%'
+      ORDER BY quality_score DESC NULLS LAST
+      LIMIT ?
+    `;
+        const rows = this.db.prepare(sql).all(prefix, limit);
+        return rows.map((row) => row.name);
+    }
+    /**
+     * Find similar skills based on a skill's content
+     */
+    findSimilar(skillId, limit = 5) {
+        const skill = this.db.prepare('SELECT * FROM skills WHERE id = ?').get(skillId);
+        if (!skill)
+            return [];
+        // Build a query from the skill's name and tags
+        const tags = JSON.parse(skill.tags || '[]');
+        const queryParts = [skill.name, ...tags].filter(Boolean);
+        const query = queryParts.map((p) => escapeFtsToken(p)).join(' OR ');
+        const sql = `
+      SELECT
+        s.*,
+        bm25(skills_fts, 10.0, 5.0, 1.0, 2.0) as rank
+      FROM skills s
+      INNER JOIN skills_fts f ON s.rowid = f.rowid
+      WHERE skills_fts MATCH ?
+        AND s.id != ?
+      ORDER BY rank
+      LIMIT ?
+    `;
+        const rows = this.db.prepare(sql).all(query, skillId, limit);
+        return rows.map((row) => buildSearchResult(row, skill.name));
+    }
+    /**
+     * Get popular skills by trust tier
+     */
+    getPopular(trustTier, limit = 10) {
+        let sql = `
+      SELECT * FROM skills
+      WHERE quality_score IS NOT NULL
+    `;
+        const params = [];
+        if (trustTier) {
+            sql += ' AND trust_tier = ?';
+            params.push(trustTier);
+        }
+        sql += ' ORDER BY quality_score DESC LIMIT ?';
+        params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => rowToSkill(row));
+    }
+    /**
+     * Clear the search cache
+     */
+    clearCache() {
+        return this.cache.clear();
+    }
+    /**
+     * ADR-019: Filter-only search when query is empty
+     * Queries the skills table directly instead of using FTS5
+     */
+    searchByFiltersOnly(options) {
+        const { limit = 20, offset = 0, trustTier, minQualityScore, category, 
+        // SMI-825: Security filters
+        safeOnly, maxRiskScore, } = options;
+        // Check cache first
+        const cacheKey = buildCacheKey(options);
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Build base query
+        const params = [];
+        let countSql;
+        let searchSql;
+        if (category) {
+            // SMI-1787: Category filter - check both junction table AND tags JSON
+            // Junction table may be empty for locally indexed skills
+            // Tags array stores category from skill metadata
+            const baseWhere = `
+        FROM skills s
+        WHERE (
+          EXISTS (
+            SELECT 1 FROM skill_categories sc
+            INNER JOIN categories c ON sc.category_id = c.id
+            WHERE sc.skill_id = s.id AND c.name = ?
+          )
+          OR s.tags LIKE ?
+        )`;
+            const filters = [];
+            params.push(category);
+            params.push(`%"${category}"%`); // Match category in JSON tags array
+            if (trustTier) {
+                filters.push('s.trust_tier = ?');
+                params.push(trustTier);
+            }
+            if (minQualityScore !== undefined) {
+                filters.push('s.quality_score >= ?');
+                params.push(minQualityScore);
+            }
+            // SMI-825: Security filters
+            if (safeOnly) {
+                filters.push('s.security_passed = 1');
+            }
+            if (maxRiskScore !== undefined) {
+                filters.push('(s.risk_score IS NULL OR s.risk_score <= ?)');
+                params.push(maxRiskScore);
+            }
+            const whereClause = filters.length > 0 ? ` AND ${filters.join(' AND ')}` : '';
+            countSql = `SELECT COUNT(*) as total ${baseWhere}${whereClause}`;
+            searchSql = `
+        SELECT s.*, 1.0 as rank
+        ${baseWhere}${whereClause}
+        ORDER BY s.quality_score DESC NULLS LAST
+        LIMIT ? OFFSET ?`;
+        }
+        else {
+            // No category filter - simpler query
+            const filters = [];
+            if (trustTier) {
+                filters.push('s.trust_tier = ?');
+                params.push(trustTier);
+            }
+            if (minQualityScore !== undefined) {
+                filters.push('s.quality_score >= ?');
+                params.push(minQualityScore);
+            }
+            // SMI-825: Security filters
+            if (safeOnly) {
+                filters.push('s.security_passed = 1');
+            }
+            if (maxRiskScore !== undefined) {
+                filters.push('(s.risk_score IS NULL OR s.risk_score <= ?)');
+                params.push(maxRiskScore);
+            }
+            const whereClause = filters.length > 0 ? `WHERE ${filters.join(' AND ')}` : '';
+            countSql = `SELECT COUNT(*) as total FROM skills s ${whereClause}`;
+            searchSql = `
+        SELECT s.*, 1.0 as rank
+        FROM skills s
+        ${whereClause}
+        ORDER BY s.quality_score DESC NULLS LAST
+        LIMIT ? OFFSET ?`;
+        }
+        // Get total count (using params without limit/offset)
+        const { total } = this.db.prepare(countSql).get(...params);
+        // Get paginated results
+        params.push(limit, offset);
+        const rows = this.db.prepare(searchSql).all(...params);
+        // Build results (no highlights for filter-only search)
+        const items = rows.map((row) => ({
+            skill: rowToSkill(row),
+            rank: 1.0,
+            highlights: {},
+        }));
+        const result = {
+            items,
+            total,
+            limit,
+            offset,
+            hasMore: offset + items.length < total,
+        };
+        // Cache the results
+        this.cache.set(cacheKey, result, this.cacheTtl);
+        return result;
+    }
+}
+//# sourceMappingURL=SearchService.js.map

package/dist/services/SearchService.js.map

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

package/dist/services/SearchService.types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * SMI-579: SearchService Types
+ *
+ * Type definitions for FTS5 search with BM25 ranking.
+ */
+import type { TrustTier } from '../types/skill.js';
+/**
+ * Raw database row type for FTS search results
+ * Used for type-safe parsing of search results from SQLite
+ */
+export interface FTSRow {
+    id: string;
+    name: string;
+    description: string | null;
+    author: string | null;
+    repo_url: string | null;
+    quality_score: number | null;
+    trust_tier: string;
+    tags: string;
+    installable: boolean | null;
+    risk_score: number | null;
+    security_findings_count: number | null;
+    security_scanned_at: string | null;
+    security_passed: number | null;
+    compatibility: string | null;
+    created_at: string;
+    updated_at: string;
+    rank: number;
+}
+/**
+ * Boolean search terms for advanced queries
+ */
+export interface BooleanSearchTerms {
+    /** Terms that must appear */
+    must?: string[];
+    /** Terms where at least one should appear */
+    should?: string[];
+    /** Terms that must not appear */
+    not?: string[];
+}
+/**
+ * Search cache key options
+ */
+export interface SearchCacheOptions {
+    query?: string;
+    limit?: number;
+    offset?: number;
+    trustTier?: TrustTier;
+    minQualityScore?: number;
+    category?: string;
+    safeOnly?: boolean;
+    maxRiskScore?: number;
+}
+//# sourceMappingURL=SearchService.types.d.ts.map

package/dist/services/SearchService.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchService.types.d.ts","sourceRoot":"","sources":["../../src/services/SearchService.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,OAAO,GAAG,IAAI,CAAA;IAE3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB"}

package/dist/services/SearchService.types.js

@@ -0,0 +1,7 @@
+/**
+ * SMI-579: SearchService Types
+ *
+ * Type definitions for FTS5 search with BM25 ranking.
+ */
+export {};
+//# sourceMappingURL=SearchService.types.js.map

package/dist/services/SearchService.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchService.types.js","sourceRoot":"","sources":["../../src/services/SearchService.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/services/SkillAnalyzer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * SMI-1788: SkillAnalyzer - Analyze skills for optimization patterns
+ *
+ * Detects optimization opportunities based on:
+ * - Line count (>500 lines suggests decomposition)
+ * - Tool usage patterns (heavy tool usage suggests subagent)
+ * - Sequential Task() calls (can be parallelized)
+ * - Large examples sections (can use progressive disclosure)
+ *
+ * Part of the Skillsmith Optimization Layer for transforming
+ * community skills into more performant versions.
+ */
+export type { SkillAnalysis, ToolUsageAnalysis, TaskPatternAnalysis, ExtractableSection, OptimizationRecommendation, ParsedSection, ConfidenceLevel, } from './SkillAnalyzer.types.js';
+import type { SkillAnalysis } from './SkillAnalyzer.types.js';
+export { TOOL_PATTERNS, THRESHOLDS, escapeRegex, getConfidenceLevel, } from './SkillAnalyzer.helpers.js';
+/**
+ * Analyze a skill's content for optimization opportunities
+ *
+ * @param content - The full SKILL.md content
+ * @returns Analysis of optimization potential
+ * @remarks The lineCount for an empty string returns 1, matching standard
+ * String.split('\n') behavior where ''.split('\n') yields ['']
+ */
+export declare function analyzeSkill(content: string): SkillAnalysis;
+/**
+ * Quick check if a skill needs transformation without full analysis
+ *
+ * @param content - The full SKILL.md content
+ * @returns Whether quick transformation check passed
+ */
+export declare function quickTransformCheck(content: string): boolean;
+declare const _default: {
+    analyzeSkill: typeof analyzeSkill;
+    quickTransformCheck: typeof quickTransformCheck;
+};
+export default _default;
+//# sourceMappingURL=SkillAnalyzer.d.ts.map

package/dist/services/SkillAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAnalyzer.d.ts","sourceRoot":"","sources":["../../src/services/SkillAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,aAAa,EACb,eAAe,GAChB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,0BAA0B,CAAA;AAgBjC,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,kBAAkB,GACnB,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA4C3D;AAwPD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA2B5D;;;;;AAED,wBAAoD"}

package/dist/services/SkillAnalyzer.helpers.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SMI-1788: SkillAnalyzer Helpers
+ *
+ * Tool detection patterns, thresholds, and utility functions
+ * for skill analysis and optimization.
+ */
+import type { ConfidenceLevel } from './SkillAnalyzer.types.js';
+/**
+ * Tool detection patterns for analyzing skill content
+ */
+export declare const TOOL_PATTERNS: Record<string, {
+    patterns: string[];
+    weight: number;
+}>;
+/**
+ * Thresholds for optimization decisions
+ */
+export declare const THRESHOLDS: {
+    /** Maximum lines before recommending decomposition */
+    readonly maxLinesBeforeDecompose: 500;
+    /** Minimum lines for an extractable section */
+    readonly minSectionLines: 50;
+    /** Heavy tool usage count that suggests subagent */
+    readonly heavyToolUsageCount: 5;
+    /** Sequential Task() calls that should be parallelized */
+    readonly sequentialTaskThreshold: 2;
+    /** Minimum optimization score to recommend transformation */
+    readonly minTransformScore: 30;
+    /** Large examples section threshold */
+    readonly largeExamplesThreshold: 200;
+};
+/**
+ * Escape special regex characters in a string
+ * @param str - String to escape
+ * @returns Escaped string safe for use in RegExp
+ */
+export declare function escapeRegex(str: string): string;
+/**
+ * Determine confidence level based on match count
+ * @param matchCount - Number of detected tools
+ * @returns Confidence level
+ */
+export declare function getConfidenceLevel(matchCount: number): ConfidenceLevel;
+/**
+ * Estimate examples lines by looking for code blocks
+ * @param content - Full skill content
+ * @returns Estimated number of lines in code blocks
+ */
+export declare function estimateExamplesLines(content: string): number;
+/**
+ * Detect tools in content
+ * @param content - Skill content to analyze
+ * @returns Object with detected tools and total weight
+ */
+export declare function detectTools(content: string): {
+    tools: string[];
+    totalWeight: number;
+};
+/**
+ * Count specific command patterns in content
+ * @param content - Skill content to analyze
+ * @returns Counts for bash, read, and write commands
+ */
+export declare function countCommandPatterns(content: string): {
+    bashCommandCount: number;
+    fileReadCount: number;
+    fileWriteCount: number;
+};
+/**
+ * Determine if tool usage suggests a subagent would be beneficial
+ * @param bashCount - Number of bash commands
+ * @param fileOpCount - Total file operations (read + write)
+ * @param totalWeight - Total tool weight
+ * @returns Whether subagent is suggested
+ */
+export declare function shouldSuggestSubagent(bashCount: number, fileOpCount: number, totalWeight: number): boolean;
+/**
+ * Count sequential Task() calls in content
+ * @param content - Skill content to analyze
+ * @returns Count of sequential Task calls
+ */
+export declare function countSequentialTaskCalls(content: string): number;
+/**
+ * Calculate batch savings percentage
+ * @param sequentialCalls - Number of sequential Task calls
+ * @returns Estimated savings percentage
+ */
+export declare function calculateBatchSavings(sequentialCalls: number): number;
+/**
+ * Determine extraction reason for a section
+ * @param sectionName - Name of the section
+ * @param lineCount - Number of lines in section
+ * @returns Human-readable extraction reason
+ */
+export declare function getExtractionReason(sectionName: string, lineCount: number): string;
+/**
+ * Calculate extraction priority based on size ratio
+ * @param lineCount - Section line count
+ * @param totalLines - Total document lines
+ * @returns Priority (1 = highest, 3 = lowest)
+ */
+export declare function calculateExtractionPriority(lineCount: number, totalLines: number): number;
+//# sourceMappingURL=SkillAnalyzer.helpers.d.ts.map

package/dist/services/SkillAnalyzer.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillAnalyzer.helpers.d.ts","sourceRoot":"","sources":["../../src/services/SkillAnalyzer.helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAyDhF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,sDAAsD;;IAGtD,+CAA+C;;IAG/C,oDAAoD;;IAGpD,0DAA0D;;IAG1D,6DAA6D;;IAG7D,uCAAuC;;CAE/B,CAAA;AAEV;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAItE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAmBrF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB,CAMA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBhE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBlF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMzF"}