@su-record/vibe 2.5.10 → 2.5.12

package/dist/lib/SkillFrontmatter.js

@@ -0,0 +1,219 @@
+/**
+ * Skill Frontmatter System
+ * YAML metadata for declarative skill configuration
+ */
+/**
+ * Parse YAML frontmatter from skill file
+ */
+export function parseSkillFrontmatter(content) {
+    // Check for frontmatter delimiter
+    if (!content.startsWith('---')) {
+        return null;
+    }
+    // Find end of frontmatter
+    const endIndex = content.indexOf('---', 3);
+    if (endIndex === -1) {
+        return null;
+    }
+    const frontmatter = content.slice(3, endIndex).trim();
+    const template = content.slice(endIndex + 3).trim();
+    // Parse YAML (simple implementation)
+    const metadata = parseSimpleYaml(frontmatter);
+    if (!metadata.name) {
+        return null;
+    }
+    return {
+        metadata: metadata,
+        template,
+        raw: content,
+    };
+}
+/**
+ * Simple YAML parser for frontmatter
+ */
+function parseSimpleYaml(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = trimmed.slice(0, colonIndex).trim();
+        let value = trimmed.slice(colonIndex + 1).trim();
+        // Handle different value types
+        if (value === 'true')
+            value = true;
+        else if (value === 'false')
+            value = false;
+        else if (/^\d+$/.test(value))
+            value = parseInt(value, 10);
+        else if (value.startsWith('[') && value.endsWith(']')) {
+            // Parse simple array
+            value = value
+                .slice(1, -1)
+                .split(',')
+                .map(v => v.trim().replace(/^["']|["']$/g, ''))
+                .filter(Boolean);
+        }
+        else if (value.startsWith('"') || value.startsWith("'")) {
+            // Remove quotes
+            value = value.slice(1, -1);
+        }
+        // Convert kebab-case to camelCase
+        const camelKey = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        result[camelKey] = value;
+    }
+    return result;
+}
+/**
+ * Generate skill frontmatter
+ */
+export function generateSkillFrontmatter(metadata) {
+    const lines = ['---'];
+    lines.push(`name: ${metadata.name}`);
+    lines.push(`description: "${metadata.description}"`);
+    if (metadata.model) {
+        lines.push(`model: ${metadata.model}`);
+    }
+    if (metadata.agent) {
+        lines.push(`agent: ${metadata.agent}`);
+    }
+    if (metadata.argumentHint) {
+        lines.push(`argument-hint: "${metadata.argumentHint}"`);
+    }
+    if (metadata.userInvocable !== undefined) {
+        lines.push(`user-invocable: ${metadata.userInvocable}`);
+    }
+    if (metadata.subtask !== undefined) {
+        lines.push(`subtask: ${metadata.subtask}`);
+    }
+    if (metadata.allowedTools && metadata.allowedTools.length > 0) {
+        lines.push(`allowed-tools: [${metadata.allowedTools.join(', ')}]`);
+    }
+    if (metadata.triggers && metadata.triggers.length > 0) {
+        lines.push(`triggers: [${metadata.triggers.join(', ')}]`);
+    }
+    if (metadata.priority !== undefined) {
+        lines.push(`priority: ${metadata.priority}`);
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+/**
+ * Create full skill file content
+ */
+export function createSkillFile(metadata, template) {
+    const frontmatter = generateSkillFrontmatter(metadata);
+    return `${frontmatter}\n\n${template}`;
+}
+/**
+ * Validate skill metadata
+ */
+export function validateSkillMetadata(metadata) {
+    const errors = [];
+    if (!metadata.name) {
+        errors.push('Missing required field: name');
+    }
+    if (!metadata.description) {
+        errors.push('Missing required field: description');
+    }
+    if (metadata.model && !['haiku', 'sonnet', 'opus'].includes(metadata.model)) {
+        errors.push(`Invalid model: ${metadata.model}. Must be haiku, sonnet, or opus`);
+    }
+    if (metadata.priority !== undefined && (metadata.priority < 0 || metadata.priority > 100)) {
+        errors.push('Priority must be between 0 and 100');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Merge skill metadata with defaults
+ */
+export function mergeWithDefaults(metadata) {
+    return {
+        name: metadata.name || 'unnamed-skill',
+        description: metadata.description || 'No description',
+        model: metadata.model,
+        agent: metadata.agent,
+        argumentHint: metadata.argumentHint,
+        userInvocable: metadata.userInvocable ?? true,
+        subtask: metadata.subtask ?? false,
+        allowedTools: metadata.allowedTools,
+        triggers: metadata.triggers,
+        priority: metadata.priority ?? 50,
+        mcpConfig: metadata.mcpConfig,
+    };
+}
+/**
+ * Extract triggers from skill template
+ */
+export function extractTriggersFromTemplate(template) {
+    const triggers = [];
+    // Look for keyword patterns in template
+    const keywordPatterns = [
+        /\bwhen\s+(\w+)/gi,
+        /\bif\s+(\w+)/gi,
+        /\b(\w+)\s+detected/gi,
+        /trigger:\s*(\w+)/gi,
+    ];
+    for (const pattern of keywordPatterns) {
+        let match;
+        while ((match = pattern.exec(template)) !== null) {
+            const keyword = match[1].toLowerCase();
+            if (keyword.length > 2 && !triggers.includes(keyword)) {
+                triggers.push(keyword);
+            }
+        }
+    }
+    return triggers;
+}
+/**
+ * Substitute template variables
+ */
+export function substituteTemplateVars(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        // Support both {{VAR}} and $VAR patterns
+        result = result.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+        result = result.replace(new RegExp(`\\$${key}\\b`, 'g'), value);
+    }
+    return result;
+}
+/**
+ * Example skill template
+ */
+export const SKILL_TEMPLATE_EXAMPLE = `---
+name: example-skill
+description: "An example skill demonstrating the frontmatter system"
+model: sonnet
+agent: implementer
+argument-hint: "task description"
+user-invocable: true
+triggers: [example, demo, test]
+priority: 50
+---
+
+# Example Skill
+
+This skill demonstrates the frontmatter metadata system.
+
+## Arguments
+
+$ARGUMENTS
+
+## Process
+
+1. Parse the arguments
+2. Execute the task
+3. Return the result
+
+## Output
+
+Provide a clear summary of what was done.
+`;
+//# sourceMappingURL=SkillFrontmatter.js.map

package/dist/lib/SkillFrontmatter.js.map

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

package/dist/lib/SkillQualityGate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Skill Quality Gate
+ * 저장할 메모리/스킬의 품질을 검증
+ */
+export interface QualityCheckResult {
+    isValid: boolean;
+    score: number;
+    issues: string[];
+    suggestions: string[];
+    category: 'principle' | 'discovery' | 'decision' | 'code' | 'generic';
+}
+/**
+ * 메모리/스킬 품질 검증
+ */
+export declare function validateSkillQuality(key: string, value: string, category?: string): QualityCheckResult;
+/**
+ * 원칙 형태로 변환 도우미
+ */
+export declare function suggestPrincipleFormat(value: string): string;
+/**
+ * 스킬 분류
+ */
+export declare function classifySkill(value: string): {
+    type: 'principle' | 'discovery' | 'decision' | 'reference' | 'generic';
+    confidence: number;
+};
+/**
+ * 저장 전 검증 래퍼
+ */
+export declare function validateBeforeSave(key: string, value: string, options?: {
+    bypassValidation?: boolean;
+    minScore?: number;
+}): {
+    canSave: boolean;
+    result: QualityCheckResult;
+    formattedFeedback: string;
+};
+//# sourceMappingURL=SkillQualityGate.d.ts.map

package/dist/lib/SkillQualityGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillQualityGate.d.ts","sourceRoot":"","sources":["../../src/lib/SkillQualityGate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CACvE;AAoDD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,kBAAkB,CAyFpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG;IAC5C,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB,CAsCA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CA6B7E"}

package/dist/lib/SkillQualityGate.js

@@ -0,0 +1,216 @@
+/**
+ * Skill Quality Gate
+ * 저장할 메모리/스킬의 품질을 검증
+ */
+// 거부할 패턴 (너무 일반적이거나 쉽게 검색 가능한 정보)
+const REJECT_PATTERNS = [
+    // 일반적인 정보
+    /^(how to|what is|definition of)/i,
+    /^(npm install|pip install|cargo add)/i,
+    /^(import|from .* import|require\()/i,
+    // 단순 명령어
+    /^(git (add|commit|push|pull|merge|checkout))/i,
+    /^(docker (run|build|pull|push))/i,
+    /^(kubectl (get|apply|delete))/i,
+    // 너무 짧은 내용
+    /^.{0,20}$/,
+    // 일반적인 best practice (검색 가능)
+    /^(always use|never use|prefer|avoid)/i,
+    /^(use (async|await|promises))/i,
+    /^(handle (errors?|exceptions?))/i,
+];
+// 가치 있는 패턴 (원칙, 발견, 결정)
+const VALUE_PATTERNS = [
+    // 프로젝트 특정 결정
+    { pattern: /we (decided|chose|agreed|concluded)/i, category: 'decision', score: 20 },
+    { pattern: /after (debugging|investigating|researching)/i, category: 'discovery', score: 25 },
+    { pattern: /the root cause (is|was)/i, category: 'discovery', score: 30 },
+    // 원칙/휴리스틱
+    { pattern: /when .* then .* because/i, category: 'principle', score: 25 },
+    { pattern: /if .* fails?, (check|try|verify)/i, category: 'principle', score: 20 },
+    { pattern: /the trick (is|was) to/i, category: 'discovery', score: 25 },
+    // 구체적인 파일/라인 참조
+    { pattern: /in (file|path|line) [`"]?[\w/.:-]+[`"]?/i, category: 'code', score: 15 },
+    { pattern: /at line \d+/i, category: 'code', score: 10 },
+    { pattern: /error: .{20,}/i, category: 'discovery', score: 15 },
+    // 아키텍처/설계 결정
+    { pattern: /architecture|design pattern|trade-?off/i, category: 'decision', score: 20 },
+    { pattern: /because (performance|security|maintainability)/i, category: 'decision', score: 20 },
+];
+// 필수 요소 체크
+const REQUIRED_ELEMENTS = [
+    { name: 'context', pattern: /\b(when|if|because|since|after)\b/i, weight: 10 },
+    { name: 'specificity', pattern: /\b(this|our|my|the)\s+(project|codebase|repo|app)/i, weight: 15 },
+    { name: 'actionable', pattern: /\b(should|must|need to|have to|try|use|avoid)\b/i, weight: 10 },
+];
+/**
+ * 메모리/스킬 품질 검증
+ */
+export function validateSkillQuality(key, value, category) {
+    const issues = [];
+    const suggestions = [];
+    let score = 50; // 기본 점수
+    let detectedCategory = 'generic';
+    // 1. 거부 패턴 체크
+    for (const pattern of REJECT_PATTERNS) {
+        if (pattern.test(value)) {
+            issues.push(`Too generic or easily searchable: matches pattern ${pattern}`);
+            score -= 30;
+        }
+    }
+    // 2. 최소 길이 체크
+    if (value.length < 50) {
+        issues.push('Content too short (min 50 chars)');
+        score -= 20;
+        suggestions.push('Add more context: why, when, what was the situation?');
+    }
+    // 3. 가치 패턴 체크
+    for (const { pattern, category: cat, score: bonus } of VALUE_PATTERNS) {
+        if (pattern.test(value)) {
+            score += bonus;
+            detectedCategory = cat;
+        }
+    }
+    // 4. 필수 요소 체크
+    let hasRequiredElements = 0;
+    for (const { name, pattern, weight } of REQUIRED_ELEMENTS) {
+        if (pattern.test(value)) {
+            score += weight;
+            hasRequiredElements++;
+        }
+        else {
+            suggestions.push(`Consider adding ${name} (${pattern.source})`);
+        }
+    }
+    if (hasRequiredElements < 2) {
+        issues.push('Missing essential elements (context, specificity, or actionability)');
+        score -= 15;
+    }
+    // 5. 구체적인 참조 체크 (파일 경로, 라인 번호, 에러 메시지)
+    const hasFilePath = /[`"]?[\w/.-]+\.(ts|js|py|go|rs|java|tsx|jsx)[`"]?/i.test(value);
+    const hasLineNumber = /line\s*\d+|:\d+:/i.test(value);
+    const hasErrorMessage = /error:|exception:|failed:/i.test(value);
+    if (hasFilePath)
+        score += 10;
+    if (hasLineNumber)
+        score += 10;
+    if (hasErrorMessage)
+        score += 10;
+    if (!hasFilePath && !hasLineNumber && !hasErrorMessage) {
+        suggestions.push('Add specific references: file paths, line numbers, or error messages');
+    }
+    // 6. 원칙 형태 체크 ("when X, do Y because Z")
+    const isPrincipleForm = /when.*,.*because|if.*then.*because/i.test(value);
+    if (isPrincipleForm) {
+        score += 20;
+        detectedCategory = 'principle';
+    }
+    else {
+        suggestions.push('Consider reformulating as a principle: "When [situation], [action] because [reason]"');
+    }
+    // 7. 키 품질 체크
+    if (key.length < 5) {
+        issues.push('Key too short');
+        score -= 10;
+    }
+    if (!/^[a-z0-9-]+$/i.test(key.replace(/\s+/g, '-'))) {
+        suggestions.push('Use kebab-case for key (e.g., "auth-token-refresh-strategy")');
+    }
+    // 점수 정규화 (0-100)
+    score = Math.max(0, Math.min(100, score));
+    // 임계값: 60점 이상이면 통과
+    const isValid = score >= 60 && issues.length === 0;
+    return {
+        isValid,
+        score,
+        issues,
+        suggestions,
+        category: detectedCategory,
+    };
+}
+/**
+ * 원칙 형태로 변환 도우미
+ */
+export function suggestPrincipleFormat(value) {
+    // 이미 원칙 형태면 그대로 반환
+    if (/when.*because|if.*then.*because/i.test(value)) {
+        return value;
+    }
+    // 변환 템플릿 제안
+    return `Consider reformulating as:
+
+"When [describe the situation/trigger],
+[describe the action to take]
+because [explain the reasoning/tradeoff]"
+
+Example:
+"When the auth token expires during a request,
+retry the request after refreshing the token (not before)
+because refreshing preemptively causes race conditions with concurrent requests"`;
+}
+/**
+ * 스킬 분류
+ */
+export function classifySkill(value) {
+    const scores = {
+        principle: 0,
+        discovery: 0,
+        decision: 0,
+        reference: 0,
+        generic: 20, // 기본
+    };
+    // 원칙
+    if (/when.*then|if.*should|always.*because|never.*because/i.test(value)) {
+        scores.principle += 30;
+    }
+    // 발견
+    if (/found|discovered|realized|root cause|after debugging/i.test(value)) {
+        scores.discovery += 30;
+    }
+    // 결정
+    if (/decided|chose|agreed|will use|architecture|design/i.test(value)) {
+        scores.decision += 30;
+    }
+    // 참조 (파일/코드 중심)
+    if (/\.(ts|js|py|go)\b.*:\d+|file:|path:/i.test(value)) {
+        scores.reference += 30;
+    }
+    // 최고 점수 타입 선택
+    const entries = Object.entries(scores);
+    entries.sort((a, b) => b[1] - a[1]);
+    const [type, score] = entries[0];
+    const total = Object.values(scores).reduce((a, b) => a + b, 0);
+    const confidence = Math.round((score / total) * 100);
+    return { type, confidence };
+}
+/**
+ * 저장 전 검증 래퍼
+ */
+export function validateBeforeSave(key, value, options) {
+    if (options?.bypassValidation) {
+        return {
+            canSave: true,
+            result: { isValid: true, score: 100, issues: [], suggestions: [], category: 'generic' },
+            formattedFeedback: '⚠️ Validation bypassed',
+        };
+    }
+    const result = validateSkillQuality(key, value);
+    const minScore = options?.minScore ?? 60;
+    const canSave = result.score >= minScore && result.issues.length === 0;
+    let feedback = '';
+    if (canSave) {
+        feedback = `✅ Quality check passed (score: ${result.score}/100, category: ${result.category})`;
+    }
+    else {
+        feedback = `❌ Quality check failed (score: ${result.score}/100)\n`;
+        if (result.issues.length > 0) {
+            feedback += `\nIssues:\n${result.issues.map(i => `  - ${i}`).join('\n')}`;
+        }
+        if (result.suggestions.length > 0) {
+            feedback += `\n\nSuggestions:\n${result.suggestions.map(s => `  - ${s}`).join('\n')}`;
+        }
+        feedback += `\n\n${suggestPrincipleFormat(value)}`;
+    }
+    return { canSave, result, formattedFeedback: feedback };
+}
+//# sourceMappingURL=SkillQualityGate.js.map

package/dist/lib/SkillQualityGate.js.map

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

package/dist/lib/SkillRepository.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Skill Repository - ~/.claude/vibe/skills/ 저장소 관리
+ *
+ * 기본 스킬 세트를 전역 위치에 설치하고 관리
+ */
+import { SkillMetadata } from './SkillFrontmatter.js';
+export interface SkillInfo {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    source: 'user' | 'default';
+    metadata?: SkillMetadata;
+}
+export interface SkillRepositoryConfig {
+    userSkillsDir?: string;
+    bundledSkillsDir?: string;
+}
+/**
+ * 기본 전역 스킬 디렉토리 경로
+ */
+export declare function getGlobalSkillsDir(): string;
+/**
+ * 번들된 기본 스킬 디렉토리 (패키지 내부)
+ */
+export declare function getBundledSkillsDir(): string;
+/**
+ * Skill Repository 클래스
+ */
+export declare class SkillRepository {
+    private userSkillsDir;
+    private bundledSkillsDir;
+    constructor(config?: SkillRepositoryConfig);
+    /**
+     * 스킬 디렉토리 초기화
+     */
+    ensureSkillsDir(): void;
+    /**
+     * 기본 스킬 세트 시딩 (없는 것만 복사)
+     */
+    seedDefaultSkills(): {
+        seeded: string[];
+        skipped: string[];
+        errors: string[];
+    };
+    /**
+     * 모든 스킬 목록 조회 (user + bundled fallback)
+     */
+    listSkills(): SkillInfo[];
+    /**
+     * 디렉토리에서 스킬 로드
+     */
+    private loadSkillsFromDir;
+    /**
+     * 콘텐츠에서 설명 추출 (frontmatter 없는 경우)
+     */
+    private extractDescription;
+    /**
+     * ID로 스킬 조회
+     */
+    getSkill(id: string): SkillInfo | null;
+    /**
+     * 스킬 파일 찾기
+     */
+    private findSkillFile;
+    /**
+     * 스킬 정보 로드
+     */
+    private loadSkillInfo;
+    /**
+     * 스킬 콘텐츠 읽기
+     */
+    getSkillContent(id: string): string | null;
+    /**
+     * 유저 스킬 저장
+     */
+    saveSkill(id: string, content: string): void;
+    /**
+     * 유저 스킬 삭제
+     */
+    deleteSkill(id: string): boolean;
+    /**
+     * 트리거 기반 스킬 검색
+     */
+    findSkillsByTrigger(input: string): SkillInfo[];
+    /**
+     * 저장소 경로 정보
+     */
+    getPaths(): {
+        userDir: string;
+        bundledDir: string;
+    };
+}
+/**
+ * 기본 스킬 세트 정의 (인라인)
+ * postinstall에서 skills/ 폴더가 없을 때 사용
+ */
+export declare const DEFAULT_SKILLS: Array<{
+    id: string;
+    content: string;
+}>;
+/**
+ * 인라인 기본 스킬 시딩 (번들 폴더가 없을 때)
+ */
+export declare function seedInlineDefaultSkills(targetDir: string): {
+    seeded: string[];
+    errors: string[];
+};
+/**
+ * 편의 함수: 기본 스킬 세트 설치
+ */
+export declare function ensureDefaultSkills(): {
+    seeded: string[];
+    skipped: string[];
+    errors: string[];
+};
+//# sourceMappingURL=SkillRepository.d.ts.map

package/dist/lib/SkillRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRepository.d.ts","sourceRoot":"","sources":["../../src/lib/SkillRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAsC,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK1F,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,GAAE,qBAA0B;IAK9C;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,iBAAiB,IAAI;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA+C9E;;OAEG;IACH,UAAU,IAAI,SAAS,EAAE;IAgBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgBtC;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAW1C;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU5C;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAShC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAY/C;;OAEG;IACH,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAMpD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAgLjE,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA4BjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAG/F"}