@loom-framework/core 0.1.0-alpha.141 → 0.1.0-alpha.143

package/dist/backend/routes/skill-parser.d.ts

@@ -0,0 +1,41 @@
+/** Skill file parsing utilities */
+export interface SkillMetadata {
+    name?: string;
+    description?: string;
+    version?: string;
+    'allowed-tools'?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Parse YAML frontmatter from markdown content using simple regex.
+ */
+export declare function parseFrontmatter(content: string): {
+    metadata: SkillMetadata;
+    body: string;
+};
+/**
+ * Recursively scan a directory for files, returning relative paths.
+ * Excludes SKILL.md (handled separately).
+ */
+export declare function scanDirFiles(dir: string, base: string): Promise<string[]>;
+/**
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
+ */
+export declare function safeResolve(baseDir: string, filePath: string): string | null;
+/**
+ * Validate skill name.
+ */
+export declare function isValidSkillName(name: string): boolean;
+/**
+ * Text file extensions that should be kept when parsing zip archives.
+ */
+export declare const TEXT_EXTENSIONS: Set<string>;
+/**
+ * Check if a file path looks like a text file based on extension.
+ */
+export declare function isTextFile(filePath: string): boolean;
+/**
+ * Get MIME type for a file extension.
+ */
+export declare function getContentType(filePath: string): string;
+//# sourceMappingURL=skill-parser.d.ts.map

package/dist/backend/routes/skill-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skill-parser.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAQnC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqG3F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,aAK1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAevD"}

package/dist/backend/routes/skill-parser.js

@@ -0,0 +1,184 @@
+/** Skill file parsing utilities */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+// ── Functions ──
+/**
+ * Parse YAML frontmatter from markdown content using simple regex.
+ */
+export function parseFrontmatter(content) {
+    // The \n before closing --- is optional to handle empty frontmatter (---\n---\nBody)
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n?---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { metadata: {}, body: content };
+    const metadataRaw = match[1];
+    const body = match[2];
+    try {
+        const metadata = {};
+        const lines = metadataRaw.split('\n');
+        let currentKey = '';
+        let currentValues = [];
+        let inArray = false;
+        let inBlock = false;
+        let blockLines = [];
+        const flushArray = () => {
+            if (inArray && currentKey) {
+                // If array items were collected, store as array; otherwise store empty string
+                metadata[currentKey] = currentValues.length > 0 ? currentValues : '';
+                inArray = false;
+                currentValues = [];
+            }
+        };
+        const flushBlock = () => {
+            if (inBlock && currentKey) {
+                metadata[currentKey] = blockLines.join('\n').trim();
+            }
+            inBlock = false;
+            blockLines = [];
+        };
+        for (const line of lines) {
+            if (inBlock) {
+                if (/^[ \t]+/.test(line) || (line === '' && blockLines.length > 0)) {
+                    blockLines.push(line.replace(/^[ \t]+/, ''));
+                    continue;
+                }
+                else {
+                    flushBlock();
+                }
+            }
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const arrayMatch = trimmed.match(/^-\s+(.+)$/);
+            if (inArray && arrayMatch) {
+                currentValues.push(arrayMatch[1].replace(/^['"]|['"]$/g, '').trim());
+                continue;
+            }
+            if (inArray) {
+                flushArray();
+            }
+            const kvMatch = trimmed.match(/^([a-zA-Z_-][a-zA-Z0-9_-]*):\s*(.*)$/);
+            if (kvMatch) {
+                currentKey = kvMatch[1];
+                let val = kvMatch[2].trim();
+                if ((val.startsWith("'") && val.endsWith("'")) || (val.startsWith('"') && val.endsWith('"'))) {
+                    val = val.slice(1, -1);
+                }
+                if (val === '|' || val === '>') {
+                    inBlock = true;
+                    blockLines = [];
+                    continue;
+                }
+                if (val === '[') {
+                    inArray = true;
+                    currentValues = [];
+                    continue;
+                }
+                if (val.startsWith('[') && val.endsWith(']')) {
+                    metadata[currentKey] = val.slice(1, -1).split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
+                    currentKey = '';
+                    continue;
+                }
+                // Empty value means multi-line array follows (YAML list syntax: "key:\n  - item")
+                if (val === '') {
+                    inArray = true;
+                    currentValues = [];
+                    continue;
+                }
+                metadata[currentKey] = val;
+                currentKey = '';
+            }
+        }
+        flushArray();
+        flushBlock();
+        return { metadata, body };
+    }
+    catch {
+        return { metadata: {}, body: content };
+    }
+}
+/**
+ * Recursively scan a directory for files, returning relative paths.
+ * Excludes SKILL.md (handled separately).
+ */
+export async function scanDirFiles(dir, base) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const subFiles = await scanDirFiles(path.join(dir, entry.name), base);
+            results.push(...subFiles);
+        }
+        else {
+            const relPath = path.relative(base, path.join(dir, entry.name));
+            results.push(relPath);
+        }
+    }
+    return results;
+}
+/**
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
+ */
+export function safeResolve(baseDir, filePath) {
+    if (filePath.includes('..'))
+        return null;
+    const resolved = path.resolve(baseDir, filePath);
+    if (!resolved.startsWith(baseDir))
+        return null;
+    return resolved;
+}
+/**
+ * Validate skill name.
+ */
+export function isValidSkillName(name) {
+    return /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name);
+}
+/**
+ * Text file extensions that should be kept when parsing zip archives.
+ */
+export const TEXT_EXTENSIONS = new Set([
+    '.md', '.json', '.yaml', '.yml', '.txt', '.ts', '.js', '.tsx', '.jsx',
+    '.xml', '.html', '.css', '.sh', '.py', '.rb', '.go', '.rs', '.java',
+    '.kt', '.swift', '.c', '.cpp', '.h', '.hpp', '.toml', '.ini', '.cfg',
+    '.env', '.gitignore', '.prettierrc', '.eslintrc', '.conf', '.properties',
+]);
+/**
+ * Check if a file path looks like a text file based on extension.
+ */
+export function isTextFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext))
+        return true;
+    // Files with no extension but common names
+    const basename = path.basename(filePath).toLowerCase();
+    if (['readme', 'license', 'makefile', 'dockerfile', '.gitkeep', '.gitignore'].includes(basename))
+        return true;
+    if (basename.startsWith('.git'))
+        return true;
+    return false;
+}
+/**
+ * Get MIME type for a file extension.
+ */
+export function getContentType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const types = {
+        '.md': 'text/markdown',
+        '.txt': 'text/plain',
+        '.json': 'application/json',
+        '.xml': 'application/xml',
+        '.yaml': 'text/yaml',
+        '.yml': 'text/yaml',
+        '.ts': 'text/typescript',
+        '.js': 'text/javascript',
+        '.html': 'text/html',
+        '.css': 'text/css',
+    };
+    return types[ext] || 'text/plain';
+}
+//# sourceMappingURL=skill-parser.js.map

package/dist/backend/routes/skill-parser.js.map

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

package/dist/backend/routes/skill-service.d.ts

@@ -0,0 +1,113 @@
+/** Skill business logic — filesystem operations independent of Fastify */
+import type { SkillMetadata } from './skill-parser.js';
+import { parseZipArchive } from './skill-archive.js';
+export interface SkillInfo {
+    name: string;
+    metadata: SkillMetadata;
+    subDirs: string[];
+}
+export interface SkillDetail {
+    name: string;
+    metadata: SkillMetadata;
+    skillMd: string;
+    files: {
+        name: string;
+        path: string;
+    }[];
+}
+export interface CreateSkillBody {
+    name: string;
+    skillMd?: string;
+    references?: Array<{
+        name: string;
+        content: string;
+    }>;
+    scripts?: Array<{
+        name: string;
+        content: string;
+    }>;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export interface UploadFileBody {
+    filename: string;
+    content: string;
+}
+/**
+ * List all skills with metadata.
+ */
+export declare function listSkills(skillsDir: string): Promise<SkillInfo[]>;
+/**
+ * Get detailed information about a single skill.
+ */
+export declare function getSkillDetail(skillsDir: string, skillName: string): Promise<SkillDetail | null>;
+/**
+ * Create a new skill directory with SKILL.md and optional files.
+ * Returns the created skill info, or throws on conflict / invalid name.
+ */
+export declare function createSkill(skillsDir: string, body: CreateSkillBody): Promise<{
+    created: true;
+    info: SkillInfo;
+} | {
+    created: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Delete a skill directory.
+ */
+export declare function deleteSkill(skillsDir: string, skillName: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Read a file within a skill directory.
+ */
+export declare function getSkillFile(skillsDir: string, skillName: string, filePath: string): Promise<{
+    ok: true;
+    content: string;
+    path: string;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Upload/replace a file in a skill directory.
+ */
+export declare function uploadSkillFile(skillsDir: string, skillName: string, filename: string, content: string): Promise<{
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Create a ZIP archive of a skill directory.
+ */
+export declare function createSkillArchive(skillsDir: string, skillName: string): Promise<{
+    ok: true;
+    buffer: Buffer;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Parse a base64-encoded ZIP archive and extract skill structure.
+ */
+export declare function parseSkillArchive(base64Data: string): {
+    ok: true;
+    data: ReturnType<typeof parseZipArchive>;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
+//# sourceMappingURL=skill-service.d.ts.map

package/dist/backend/routes/skill-service.d.ts.map

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

package/dist/backend/routes/skill-service.js

@@ -0,0 +1,265 @@
+/** Skill business logic — filesystem operations independent of Fastify */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import AdmZip from 'adm-zip';
+import { parseFrontmatter, scanDirFiles, safeResolve, isValidSkillName } from './skill-parser.js';
+import { parseZipArchive } from './skill-archive.js';
+// ── Service functions ──
+/**
+ * Ensure the skills directory exists.
+ */
+async function ensureSkillsDir(skillsDir) {
+    await fs.mkdir(skillsDir, { recursive: true });
+}
+/**
+ * List all skills with metadata.
+ */
+export async function listSkills(skillsDir) {
+    await ensureSkillsDir(skillsDir);
+    let entries;
+    try {
+        entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillDir = path.join(skillsDir, entry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        let metadata = {};
+        try {
+            const content = await fs.readFile(skillMdPath, 'utf-8');
+            metadata = parseFrontmatter(content).metadata;
+        }
+        catch {
+            // SKILL.md doesn't exist or is unreadable
+        }
+        // Scan subdirectories dynamically (any folder name, not just 'references')
+        let subDirs = [];
+        try {
+            const dirEntries = await fs.readdir(skillDir, { withFileTypes: true });
+            subDirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch {
+            // ignore
+        }
+        skills.push({ name: entry.name, metadata, subDirs });
+    }
+    return skills;
+}
+/**
+ * Get detailed information about a single skill.
+ */
+export async function getSkillDetail(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists)
+        return null;
+    let skillMd = '';
+    let metadata = {};
+    try {
+        skillMd = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf-8');
+        metadata = parseFrontmatter(skillMd).metadata;
+    }
+    catch {
+        // SKILL.md doesn't exist
+    }
+    // Dynamically scan all files in subdirectories
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    const files = allFiles.map((p) => ({
+        name: path.basename(p),
+        path: p,
+    }));
+    return { name: skillName, metadata, skillMd, files };
+}
+/**
+ * Create a new skill directory with SKILL.md and optional files.
+ * Returns the created skill info, or throws on conflict / invalid name.
+ */
+export async function createSkill(skillsDir, body) {
+    const { name, skillMd, references, scripts: scriptFiles, files: archiveFiles } = body;
+    if (!isValidSkillName(name)) {
+        return { created: false, status: 400, error: 'Invalid skill name. Use alphanumeric, hyphens, and underscores only.' };
+    }
+    const skillDir = path.join(skillsDir, name);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (exists) {
+        return { created: false, status: 409, error: `Skill "${name}" already exists` };
+    }
+    await fs.mkdir(skillDir, { recursive: true });
+    const contentToWrite = skillMd || `---
+name: ${name}
+description: ''
+version: 1.0.0
+---
+
+# ${name}
+
+## Overview
+
+[Describe what this skill does]
+
+## Usage Scenarios
+
+- "User prompt" → [what the skill does]
+`;
+    await fs.writeFile(path.join(skillDir, 'SKILL.md'), contentToWrite, 'utf-8');
+    if (references && references.length > 0) {
+        const refDir = path.join(skillDir, 'references');
+        await fs.mkdir(refDir, { recursive: true });
+        for (const ref of references) {
+            const safePath = safeResolve(refDir, ref.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, ref.content, 'utf-8');
+            }
+        }
+    }
+    if (scriptFiles && scriptFiles.length > 0) {
+        const scriptsDir = path.join(skillDir, 'scripts');
+        await fs.mkdir(scriptsDir, { recursive: true });
+        for (const script of scriptFiles) {
+            const safePath = safeResolve(scriptsDir, script.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, script.content, 'utf-8');
+            }
+        }
+    }
+    if (archiveFiles && archiveFiles.length > 0) {
+        for (const file of archiveFiles) {
+            const safePath = safeResolve(skillDir, file.path);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, file.content, 'utf-8');
+            }
+        }
+    }
+    const metadata = parseFrontmatter(contentToWrite).metadata;
+    return { created: true, info: { name, metadata, subDirs: [] } };
+}
+/**
+ * Delete a skill directory.
+ */
+export async function deleteSkill(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    await fs.rm(skillDir, { recursive: true, force: true });
+    return { ok: true };
+}
+/**
+ * Read a file within a skill directory.
+ */
+export async function getSkillFile(skillsDir, skillName, filePath) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filePath);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    const fileExists = await fs.access(resolvedPath).then(() => true, () => false);
+    if (!fileExists) {
+        return { ok: false, status: 404, error: `File "${filePath}" not found` };
+    }
+    try {
+        const content = await fs.readFile(resolvedPath, 'utf-8');
+        return { ok: true, content, path: filePath };
+    }
+    catch (err) {
+        return { ok: false, status: 500, error: `Failed to read file: ${err}` };
+    }
+}
+/**
+ * Upload/replace a file in a skill directory.
+ */
+export async function uploadSkillFile(skillsDir, skillName, filename, content) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filename);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await fs.writeFile(resolvedPath, content, 'utf-8');
+    return { ok: true, path: filename };
+}
+/**
+ * Create a ZIP archive of a skill directory.
+ */
+export async function createSkillArchive(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const zip = new AdmZip();
+    // Add SKILL.md
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile('SKILL.md', Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // SKILL.md doesn't exist, skip
+    }
+    // Add all other files, preserving directory structure
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    for (const filePath of allFiles) {
+        if (filePath === 'SKILL.md')
+            continue;
+        const resolvedPath = safeResolve(skillDir, filePath);
+        if (!resolvedPath)
+            continue;
+        try {
+            const content = await fs.readFile(resolvedPath);
+            // Store under skillName/ prefix for proper extraction
+            zip.addFile(`${skillName}/${filePath}`, content);
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    // Also put SKILL.md under the prefix
+    zip.deleteFile('SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile(`${skillName}/SKILL.md`, Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // skip
+    }
+    return { ok: true, buffer: zip.toBuffer() };
+}
+/**
+ * Parse a base64-encoded ZIP archive and extract skill structure.
+ */
+export function parseSkillArchive(base64Data) {
+    let buffer;
+    try {
+        buffer = Buffer.from(base64Data, 'base64');
+    }
+    catch {
+        return { ok: false, status: 400, error: '无效的 base64 编码' };
+    }
+    try {
+        const result = parseZipArchive(buffer);
+        return { ok: true, data: result };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : '解析压缩包失败';
+        return { ok: false, status: 400, error: msg };
+    }
+}
+//# sourceMappingURL=skill-service.js.map

package/dist/backend/routes/skill-service.js.map

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

package/dist/backend/routes/skills.d.ts

@@ -9,6 +9,9 @@
  * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
  */
 import type { FastifyInstance } from 'fastify';
+export { parseFrontmatter, scanDirFiles, safeResolve, isValidSkillName, isTextFile, getContentType, TEXT_EXTENSIONS } from '../services/skill-parser.js';
+export type { SkillMetadata } from '../services/skill-parser.js';
+export { parseZipArchive } from '../services/skill-archive.js';
 export interface SkillRouteOptions {
     projectRoot: string;
 }

package/dist/backend/routes/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA2X/C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAoSN"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACzJ,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA4E/D,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CA8FN"}