skillpkg-core 0.5.5 → 0.5.7

package/dist/matching/engine.js

@@ -0,0 +1,419 @@
+/**
+ * Skill Matching Engine
+ *
+ * Analyzes user goals and recommends relevant skills based on
+ * keyword matching with configurable weights.
+ */
+import { DEFAULT_WEIGHTS } from './types.js';
+/**
+ * Priority order for sorting (higher = better)
+ */
+const PRIORITY_ORDER = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/**
+ * Skill Matching Engine
+ */
+export class MatchingEngine {
+    weights;
+    minConfidence;
+    researchThreshold;
+    maxResults;
+    constructor(options = {}) {
+        this.weights = { ...DEFAULT_WEIGHTS, ...options.weights };
+        this.minConfidence = options.minConfidence ?? 0.3;
+        this.researchThreshold = options.researchThreshold ?? 0.5;
+        this.maxResults = options.maxResults ?? 5;
+    }
+    /**
+     * Extract keywords from user goal
+     */
+    extractKeywords(goal) {
+        // Normalize: lowercase and split by common delimiters
+        const normalized = goal.toLowerCase();
+        // Split by spaces, punctuation, and common separators
+        const words = normalized
+            .split(/[\s,.\-_:;!?()[\]{}'"、。，！？]+/)
+            .filter((word) => word.length > 1);
+        // Remove common stop words (basic set for both English and Chinese)
+        const stopWords = new Set([
+            // English
+            'a',
+            'an',
+            'the',
+            'is',
+            'are',
+            'was',
+            'were',
+            'be',
+            'been',
+            'being',
+            'have',
+            'has',
+            'had',
+            'do',
+            'does',
+            'did',
+            'will',
+            'would',
+            'could',
+            'should',
+            'may',
+            'might',
+            'must',
+            'shall',
+            'can',
+            'need',
+            'dare',
+            'ought',
+            'used',
+            'want',
+            'to',
+            'of',
+            'in',
+            'for',
+            'on',
+            'with',
+            'at',
+            'by',
+            'from',
+            'as',
+            'into',
+            'through',
+            'during',
+            'before',
+            'after',
+            'above',
+            'below',
+            'between',
+            'under',
+            'again',
+            'further',
+            'then',
+            'once',
+            'here',
+            'there',
+            'when',
+            'where',
+            'why',
+            'how',
+            'all',
+            'each',
+            'few',
+            'more',
+            'most',
+            'other',
+            'some',
+            'such',
+            'no',
+            'nor',
+            'not',
+            'only',
+            'own',
+            'same',
+            'so',
+            'than',
+            'too',
+            'very',
+            'just',
+            'and',
+            'but',
+            'if',
+            'or',
+            'because',
+            'until',
+            'while',
+            'about',
+            'against',
+            'i',
+            'me',
+            'my',
+            'myself',
+            'we',
+            'our',
+            'you',
+            'your',
+            'he',
+            'him',
+            'his',
+            'she',
+            'her',
+            'it',
+            'its',
+            'they',
+            'them',
+            'their',
+            'what',
+            'which',
+            'who',
+            'whom',
+            'this',
+            'that',
+            'these',
+            'those',
+            'am',
+            // Chinese
+            '的',
+            '了',
+            '是',
+            '在',
+            '我',
+            '有',
+            '和',
+            '就',
+            '不',
+            '人',
+            '都',
+            '一',
+            '一個',
+            '上',
+            '也',
+            '很',
+            '到',
+            '說',
+            '要',
+            '去',
+            '你',
+            '會',
+            '著',
+            '沒有',
+            '看',
+            '好',
+            '自己',
+            '這',
+            '那',
+            '什麼',
+            '嗎',
+            '想',
+            '他',
+            '她',
+            '它',
+            '們',
+            '來',
+            '讓',
+            '把',
+            '給',
+            '用',
+            '做',
+            '幫',
+            '能',
+            '可以',
+            '需要',
+            '想要',
+            '請',
+            '怎麼',
+            '如何',
+        ]);
+        return words.filter((word) => !stopWords.has(word));
+    }
+    /**
+     * Normalize triggers to structured format
+     */
+    normalizeTriggers(triggers) {
+        if (!triggers) {
+            return {};
+        }
+        // Legacy format: array of strings -> treat as primary keywords
+        if (Array.isArray(triggers)) {
+            return {
+                keywords: {
+                    primary: triggers.map((t) => t.toLowerCase()),
+                    secondary: [],
+                },
+                context_boost: [],
+                context_penalty: [],
+                priority: 'medium',
+            };
+        }
+        // Normalize all keywords to lowercase
+        return {
+            keywords: {
+                primary: (triggers.keywords?.primary || []).map((k) => k.toLowerCase()),
+                secondary: (triggers.keywords?.secondary || []).map((k) => k.toLowerCase()),
+            },
+            context_boost: (triggers.context_boost || []).map((k) => k.toLowerCase()),
+            context_penalty: (triggers.context_penalty || []).map((k) => k.toLowerCase()),
+            priority: triggers.priority || 'medium',
+        };
+    }
+    /**
+     * Calculate match score for a skill
+     */
+    calculateScore(keywords, triggers) {
+        let score = 0;
+        const matchedKeywords = [];
+        let hasPrimary = false;
+        let hasSecondary = false;
+        const primarySet = new Set(triggers.keywords?.primary || []);
+        const secondarySet = new Set(triggers.keywords?.secondary || []);
+        const boostSet = new Set(triggers.context_boost || []);
+        const penaltySet = new Set(triggers.context_penalty || []);
+        for (const keyword of keywords) {
+            const lowerKeyword = keyword.toLowerCase();
+            // Check primary keywords
+            if (primarySet.has(lowerKeyword)) {
+                score += this.weights.primary;
+                matchedKeywords.push(keyword);
+                hasPrimary = true;
+            }
+            // Check secondary keywords
+            else if (secondarySet.has(lowerKeyword)) {
+                score += this.weights.secondary;
+                matchedKeywords.push(keyword);
+                hasSecondary = true;
+            }
+            // Check context boost
+            if (boostSet.has(lowerKeyword)) {
+                score += this.weights.contextBoost;
+            }
+            // Check context penalty
+            if (penaltySet.has(lowerKeyword)) {
+                score += this.weights.contextPenalty; // This is negative
+            }
+        }
+        // Determine match type
+        let matchType = 'secondary';
+        if (hasPrimary && hasSecondary) {
+            matchType = 'mixed';
+        }
+        else if (hasPrimary) {
+            matchType = 'primary';
+        }
+        return { score, matchedKeywords, matchType };
+    }
+    /**
+     * Calculate confidence from score (normalized to 0-1)
+     */
+    calculateConfidence(score) {
+        // Normalize score to 0-1 range
+        // Score of 2.0 or higher = 1.0 confidence
+        const confidence = Math.min(score / 2.0, 1.0);
+        return Math.max(0, confidence);
+    }
+    /**
+     * Match a single skill against keywords
+     */
+    matchSkill(skill, keywords) {
+        const triggers = this.normalizeTriggers(skill.triggers);
+        const { score, matchedKeywords, matchType } = this.calculateScore(keywords, triggers);
+        if (matchedKeywords.length === 0) {
+            return null;
+        }
+        const confidence = this.calculateConfidence(score);
+        if (confidence < this.minConfidence) {
+            return null;
+        }
+        const priority = triggers.priority || 'medium';
+        return {
+            name: skill.name,
+            confidence,
+            matchedKeywords,
+            matchType,
+            priority,
+            reason: this.generateReason(skill, matchedKeywords, matchType),
+        };
+    }
+    /**
+     * Generate human-readable reason for recommendation
+     */
+    generateReason(_skill, matchedKeywords, matchType) {
+        const keywordStr = matchedKeywords.slice(0, 3).join(', ');
+        const moreCount = matchedKeywords.length - 3;
+        if (matchType === 'primary') {
+            return `Direct match for "${keywordStr}"${moreCount > 0 ? ` +${moreCount} more` : ''}`;
+        }
+        else if (matchType === 'mixed') {
+            return `Strong match for "${keywordStr}"${moreCount > 0 ? ` +${moreCount} more` : ''}`;
+        }
+        else {
+            return `Related to "${keywordStr}"${moreCount > 0 ? ` +${moreCount} more` : ''}`;
+        }
+    }
+    /**
+     * Match skills against a user goal
+     */
+    matchSkills(goal, skills) {
+        const keywords = this.extractKeywords(goal);
+        const matches = [];
+        for (const skill of skills) {
+            const match = this.matchSkill(skill, keywords);
+            if (match) {
+                matches.push(match);
+            }
+        }
+        // Sort by confidence (desc), then priority (desc), then name (asc)
+        matches.sort((a, b) => {
+            if (b.confidence !== a.confidence) {
+                return b.confidence - a.confidence;
+            }
+            const priorityDiff = PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority];
+            if (priorityDiff !== 0) {
+                return priorityDiff;
+            }
+            return a.name.localeCompare(b.name);
+        });
+        return {
+            matches: matches.slice(0, this.maxResults),
+            extractedKeywords: keywords,
+        };
+    }
+    /**
+     * Analyze a goal and return full recommendation
+     */
+    analyze(goal, skills) {
+        const keywords = this.extractKeywords(goal);
+        // Separate domain and software skills
+        const domainSkills = skills.filter((s) => s.type === 'domain');
+        const softwareSkills = skills.filter((s) => s.type === 'software');
+        // Match both types
+        const domainMatches = this.matchSkills(goal, domainSkills);
+        const softwareMatches = this.matchSkills(goal, softwareSkills);
+        // Collect software skills from domain skill dependencies
+        const fromDependencies = new Set();
+        for (const match of domainMatches.matches) {
+            const skill = domainSkills.find((s) => s.name === match.name);
+            if (skill?.dependencies?.['software-skills']) {
+                for (const dep of skill.dependencies['software-skills']) {
+                    fromDependencies.add(dep);
+                }
+            }
+        }
+        // Calculate overall confidence
+        const allMatches = [...domainMatches.matches, ...softwareMatches.matches];
+        const overallConfidence = allMatches.length > 0
+            ? allMatches.reduce((sum, m) => sum + m.confidence, 0) / allMatches.length
+            : 0;
+        // Determine if research mode should be triggered
+        const researchMode = overallConfidence < this.researchThreshold;
+        // Generate research suggestions if in research mode
+        const researchSuggestions = researchMode ? this.generateResearchSuggestions(goal, keywords) : undefined;
+        return {
+            goal,
+            extractedKeywords: keywords,
+            domain_skills: domainMatches.matches,
+            software_skills: softwareMatches.matches,
+            from_dependencies: Array.from(fromDependencies),
+            overall_confidence: overallConfidence,
+            research_mode: researchMode,
+            research_suggestions: researchSuggestions,
+        };
+    }
+    /**
+     * Generate research suggestions when confidence is low
+     */
+    generateResearchSuggestions(goal, keywords) {
+        const suggestions = [];
+        // Suggest searching for skills related to main keywords
+        if (keywords.length > 0) {
+            suggestions.push(`Search external skill registries for: ${keywords.slice(0, 3).join(', ')}`);
+        }
+        // Suggest web search for domain knowledge
+        suggestions.push(`Web search for best practices: "${goal}"`);
+        // Suggest asking user for clarification
+        suggestions.push('Ask user to clarify specific requirements or technologies');
+        return suggestions;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/matching/engine.js.map

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

package/dist/matching/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Skill Matching Engine
+ *
+ * @module matching
+ */
+export { MatchingEngine } from './engine.js';
+export type { MatchingWeights, MatchingOptions, SkillData, SkillMatch, SkillRecommendation, } from './types.js';
+export { DEFAULT_WEIGHTS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,eAAe,EACf,SAAS,EACT,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/matching/index.js

@@ -0,0 +1,8 @@
+/**
+ * Skill Matching Engine
+ *
+ * @module matching
+ */
+export { MatchingEngine } from './engine.js';
+export { DEFAULT_WEIGHTS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/matching/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/matching/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Types for skill matching engine
+ */
+import type { SkillTriggers } from '../skill/types.js';
+/**
+ * Matching weights configuration
+ */
+export interface MatchingWeights {
+    /** Weight for primary keyword matches (default: 1.0) */
+    primary: number;
+    /** Weight for secondary keyword matches (default: 0.6) */
+    secondary: number;
+    /** Bonus for context_boost matches (default: 0.2) */
+    contextBoost: number;
+    /** Penalty for context_penalty matches (default: -0.3) */
+    contextPenalty: number;
+}
+/**
+ * Default matching weights
+ */
+export declare const DEFAULT_WEIGHTS: MatchingWeights;
+/**
+ * Individual skill match result
+ */
+export interface SkillMatch {
+    /** Skill name */
+    name: string;
+    /** Match confidence score (0-1) */
+    confidence: number;
+    /** Keywords that matched */
+    matchedKeywords: string[];
+    /** Match type (primary or secondary) */
+    matchType: 'primary' | 'secondary' | 'mixed';
+    /** Priority from skill triggers */
+    priority: 'high' | 'medium' | 'low';
+    /** Reason for recommendation */
+    reason: string;
+}
+/**
+ * Skill recommendation result from matching engine
+ */
+export interface SkillRecommendation {
+    /** Original user goal/query */
+    goal: string;
+    /** Extracted keywords from goal */
+    extractedKeywords: string[];
+    /** Matched domain skills */
+    domain_skills: SkillMatch[];
+    /** Matched software skills */
+    software_skills: SkillMatch[];
+    /** Software skills from domain skill dependencies */
+    from_dependencies: string[];
+    /** Overall confidence score (0-1) */
+    overall_confidence: number;
+    /** Whether research mode should be triggered (confidence < 0.5) */
+    research_mode: boolean;
+    /** Suggested research topics if research_mode is true */
+    research_suggestions?: string[];
+}
+/**
+ * Skill data for matching
+ */
+export interface SkillData {
+    /** Skill name */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Skill type */
+    type: 'domain' | 'software';
+    /** Triggers configuration */
+    triggers?: string[] | SkillTriggers;
+    /** Dependencies */
+    dependencies?: {
+        skills?: string[];
+        'software-skills'?: string[];
+    };
+}
+/**
+ * Matching engine options
+ */
+export interface MatchingOptions {
+    /** Custom weights */
+    weights?: Partial<MatchingWeights>;
+    /** Minimum confidence threshold (default: 0.3) */
+    minConfidence?: number;
+    /** Research mode threshold (default: 0.5) */
+    researchThreshold?: number;
+    /** Maximum results per category (default: 5) */
+    maxResults?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/matching/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,eAK7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC7C,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qCAAqC;IACrC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,aAAa,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;IACpC,mBAAmB;IACnB,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACnC,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/matching/types.js

@@ -0,0 +1,13 @@
+/**
+ * Types for skill matching engine
+ */
+/**
+ * Default matching weights
+ */
+export const DEFAULT_WEIGHTS = {
+    primary: 1.0,
+    secondary: 0.6,
+    contextBoost: 0.2,
+    contextPenalty: -0.3,
+};
+//# sourceMappingURL=types.js.map

package/dist/matching/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/matching/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,CAAC,GAAG;CACrB,CAAC"}

package/dist/parser/schema.d.ts

@@ -76,11 +76,57 @@ export declare const skillSchema: {
             readonly description: "Keywords for search";
         };
         readonly triggers: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-            readonly description: "Trigger words to activate the skill";
+            readonly oneOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            }, {
+                readonly type: "object";
+                readonly properties: {
+                    readonly keywords: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly primary: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Primary keywords (weight: 1.0) - direct match triggers";
+                            };
+                            readonly secondary: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                                readonly description: "Secondary keywords (weight: 0.6) - candidate match";
+                            };
+                        };
+                        readonly additionalProperties: false;
+                    };
+                    readonly context_boost: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Context words that boost score (+0.2 when co-occurring)";
+                    };
+                    readonly context_penalty: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Context words that reduce score (-0.3 when co-occurring)";
+                    };
+                    readonly priority: {
+                        readonly type: "string";
+                        readonly enum: readonly ["high", "medium", "low"];
+                        readonly description: "Priority for tie-breaking (default: medium)";
+                    };
+                };
+                readonly additionalProperties: false;
+            }];
+            readonly description: "Trigger words or structured matching configuration";
         };
         readonly capabilities: {
             readonly type: "array";
@@ -153,6 +199,13 @@ export declare const skillSchema: {
                         };
                         readonly description: "Skill dependencies (names or sources)";
                     };
+                    readonly 'software-skills': {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Software skill dependencies for domain skills (cross-domain)";
+                    };
                     readonly mcp: {
                         readonly type: "array";
                         readonly items: {
@@ -163,11 +216,11 @@ export declare const skillSchema: {
                 };
                 readonly additionalProperties: false;
             }];
-            readonly description: "Skill and MCP dependencies";
+            readonly description: "Skill, software-skill, and MCP dependencies";
         };
     };
-    readonly required: readonly ["schema", "name", "version", "description", "instructions"];
-    readonly additionalProperties: false;
+    readonly required: readonly ["name", "description"];
+    readonly additionalProperties: true;
 };
 /**
  * Human-readable field descriptions for error messages

package/dist/parser/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/parser/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Id,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpD,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/parser/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpD,CAAC"}