skillpkg-core 0.2.1 → 0.4.0

package/dist/installer/types.js.map

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

package/dist/parser/schema.d.ts

@@ -138,11 +138,32 @@ export declare const skillSchema: {
             readonly description: "Platform-specific configurations";
         };
         readonly dependencies: {
-            readonly type: "object";
-            readonly additionalProperties: {
-                readonly type: "string";
-            };
-            readonly description: "Skill dependencies with version ranges";
+            readonly oneOf: readonly [{
+                readonly type: "object";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                };
+            }, {
+                readonly type: "object";
+                readonly properties: {
+                    readonly skills: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Skill dependencies (names or sources)";
+                    };
+                    readonly mcp: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "MCP server dependencies";
+                    };
+                };
+                readonly additionalProperties: false;
+            }];
+            readonly description: "Skill and MCP dependencies";
         };
     };
     readonly required: readonly ["schema", "name", "version", "description", "instructions"];

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwHd,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Id,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpD,CAAC"}

package/dist/parser/schema.js

@@ -118,9 +118,31 @@ export const skillSchema = {
             description: 'Platform-specific configurations',
         },
         dependencies: {
-            type: 'object',
-            additionalProperties: { type: 'string' },
-            description: 'Skill dependencies with version ranges',
+            oneOf: [
+                {
+                    // Legacy format: Record<string, string> (name -> version)
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                },
+                {
+                    // New format: { skills?: string[], mcp?: string[] }
+                    type: 'object',
+                    properties: {
+                        skills: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Skill dependencies (names or sources)',
+                        },
+                        mcp: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'MCP server dependencies',
+                        },
+                    },
+                    additionalProperties: false,
+                },
+            ],
+            description: 'Skill and MCP dependencies',
         },
     },
     required: ['schema', 'name', 'version', 'description', 'instructions'],

package/dist/parser/schema.js.map

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

package/dist/resolver/dependency-resolver.d.ts

@@ -0,0 +1,59 @@
+/**
+ * DependencyResolver - Resolve skill and MCP dependencies
+ */
+import type { DependencyNode, ResolutionResult, SkillFetcher, SkillMetadata } from './types.js';
+import { type SkillDependencies } from '../types.js';
+/**
+ * DependencyResolver class
+ */
+export declare class DependencyResolver {
+    private fetcher;
+    constructor(fetcher: SkillFetcher);
+    /**
+     * Resolve all dependencies for a skill source
+     * Returns dependencies in topological order (dependencies first)
+     */
+    resolveDependencies(skillSource: string, installed?: Set<string>): Promise<ResolutionResult>;
+    /**
+     * Recursive dependency resolution with circular detection
+     */
+    private resolveRecursive;
+    /**
+     * Build a dependency tree for visualization
+     */
+    buildDependencyTree(skillSource: string, installed?: Set<string>): Promise<DependencyNode | null>;
+    /**
+     * Recursive tree building
+     */
+    private buildTreeRecursive;
+    /**
+     * Detect circular dependencies
+     * Returns the circular chain if found, null otherwise
+     */
+    detectCircular(skillSource: string): Promise<string[] | null>;
+    /**
+     * Get direct dependencies (not transitive)
+     */
+    getDirectDependencies(skillSource: string): Promise<SkillDependencies>;
+    /**
+     * Extract skill name from source
+     * e.g., "github:user/skill-name" -> "skill-name"
+     */
+    private extractSkillName;
+}
+/**
+ * Circular dependency error
+ */
+export declare class CircularDependencyError extends Error {
+    readonly chain: string[];
+    constructor(chain: string[]);
+}
+/**
+ * Create a DependencyResolver instance
+ */
+export declare function createDependencyResolver(fetcher: SkillFetcher): DependencyResolver;
+/**
+ * Create a mock fetcher for testing
+ */
+export declare function createMockFetcher(skills: Map<string, SkillMetadata>): SkillFetcher;
+//# sourceMappingURL=dependency-resolver.d.ts.map

package/dist/resolver/dependency-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-resolver.d.ts","sourceRoot":"","sources":["../../src/resolver/dependency-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAEV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,YAAY;IAIjC;;;OAGG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,GAAG,CAAC,MAAM,CAAa,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAwC5B;;OAEG;YACW,gBAAgB;IA+E9B;;OAEG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,GAAG,CAAC,MAAM,CAAa,GACjC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKjC;;OAEG;YACW,kBAAkB;IAuChC;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAKnE;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ5E;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAqBzB;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAEb,KAAK,EAAE,MAAM,EAAE;CAK5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CAElF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACjC,YAAY,CAkBd"}

package/dist/resolver/dependency-resolver.js

@@ -0,0 +1,217 @@
+import { normalizeDependencies } from '../types.js';
+/**
+ * DependencyResolver class
+ */
+export class DependencyResolver {
+    fetcher;
+    constructor(fetcher) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Resolve all dependencies for a skill source
+     * Returns dependencies in topological order (dependencies first)
+     */
+    async resolveDependencies(skillSource, installed = new Set()) {
+        const result = {
+            dependencies: [],
+            mcpToInstall: [],
+            errors: [],
+        };
+        const visited = new Set();
+        const inProgress = new Set(); // For circular detection
+        const resolved = [];
+        try {
+            await this.resolveRecursive(skillSource, installed, visited, inProgress, resolved, result, null);
+            // resolved is already in topological order (dependencies first)
+            // because we push after processing all children (post-order traversal)
+            result.dependencies = resolved;
+            // Deduplicate MCP dependencies
+            result.mcpToInstall = [...new Set(result.mcpToInstall)];
+        }
+        catch (error) {
+            if (error instanceof CircularDependencyError) {
+                result.circularChain = error.chain;
+                result.errors.push(`Circular dependency detected: ${error.chain.join(' → ')}`);
+            }
+            else {
+                result.errors.push(String(error));
+            }
+        }
+        return result;
+    }
+    /**
+     * Recursive dependency resolution with circular detection
+     */
+    async resolveRecursive(source, installed, visited, inProgress, resolved, result, requiredBy) {
+        // Normalize source to skill name for deduplication
+        const skillName = this.extractSkillName(source);
+        // Skip if already installed
+        if (installed.has(skillName)) {
+            return;
+        }
+        // Skip if already resolved
+        if (visited.has(skillName)) {
+            return;
+        }
+        // Check for circular dependency
+        if (inProgress.has(skillName)) {
+            const chain = [...inProgress, skillName];
+            throw new CircularDependencyError(chain);
+        }
+        // Mark as in progress
+        inProgress.add(skillName);
+        try {
+            // Fetch skill metadata
+            const metadata = await this.fetcher.fetchMetadata(source);
+            if (!metadata) {
+                result.errors.push(`Failed to fetch metadata for: ${source}`);
+                return;
+            }
+            // Normalize dependencies
+            const deps = normalizeDependencies(metadata.dependencies);
+            // Process skill dependencies first (depth-first)
+            for (const depSource of deps.skills || []) {
+                await this.resolveRecursive(depSource, installed, visited, inProgress, resolved, result, skillName);
+            }
+            // Collect MCP dependencies
+            for (const mcp of deps.mcp || []) {
+                if (!result.mcpToInstall.includes(mcp)) {
+                    result.mcpToInstall.push(mcp);
+                }
+            }
+            // Add this skill to resolved list
+            resolved.push({
+                name: skillName,
+                source,
+                type: 'skill',
+                transitive: requiredBy !== null,
+                requiredBy: requiredBy || undefined,
+            });
+        }
+        finally {
+            // Remove from in progress
+            inProgress.delete(skillName);
+            // Mark as visited
+            visited.add(skillName);
+        }
+    }
+    /**
+     * Build a dependency tree for visualization
+     */
+    async buildDependencyTree(skillSource, installed = new Set()) {
+        const visited = new Set();
+        return this.buildTreeRecursive(skillSource, installed, visited);
+    }
+    /**
+     * Recursive tree building
+     */
+    async buildTreeRecursive(source, installed, visited) {
+        const skillName = this.extractSkillName(source);
+        // Prevent infinite loops
+        if (visited.has(skillName)) {
+            return null;
+        }
+        visited.add(skillName);
+        // Fetch metadata
+        const metadata = await this.fetcher.fetchMetadata(source);
+        if (!metadata) {
+            return null;
+        }
+        const deps = normalizeDependencies(metadata.dependencies);
+        const children = [];
+        // Recursively build children
+        for (const depSource of deps.skills || []) {
+            const child = await this.buildTreeRecursive(depSource, installed, visited);
+            if (child) {
+                children.push(child);
+            }
+        }
+        return {
+            name: metadata.name,
+            version: metadata.version,
+            source,
+            dependencies: children,
+            mcpDependencies: deps.mcp || [],
+        };
+    }
+    /**
+     * Detect circular dependencies
+     * Returns the circular chain if found, null otherwise
+     */
+    async detectCircular(skillSource) {
+        const result = await this.resolveDependencies(skillSource);
+        return result.circularChain || null;
+    }
+    /**
+     * Get direct dependencies (not transitive)
+     */
+    async getDirectDependencies(skillSource) {
+        const metadata = await this.fetcher.fetchMetadata(skillSource);
+        if (!metadata) {
+            return { skills: [], mcp: [] };
+        }
+        return normalizeDependencies(metadata.dependencies);
+    }
+    /**
+     * Extract skill name from source
+     * e.g., "github:user/skill-name" -> "skill-name"
+     */
+    extractSkillName(source) {
+        // GitHub format: github:user/repo
+        if (source.startsWith('github:')) {
+            const parts = source.replace('github:', '').split('/');
+            return parts[parts.length - 1];
+        }
+        // URL format: https://github.com/user/repo
+        if (source.startsWith('http://') || source.startsWith('https://')) {
+            try {
+                const url = new URL(source);
+                const parts = url.pathname.split('/').filter(Boolean);
+                return parts[parts.length - 1] || source;
+            }
+            catch {
+                return source;
+            }
+        }
+        // Local path or skill name
+        return source.split('/').pop() || source;
+    }
+}
+/**
+ * Circular dependency error
+ */
+export class CircularDependencyError extends Error {
+    chain;
+    constructor(chain) {
+        super(`Circular dependency detected: ${chain.join(' → ')}`);
+        this.name = 'CircularDependencyError';
+        this.chain = chain;
+    }
+}
+/**
+ * Create a DependencyResolver instance
+ */
+export function createDependencyResolver(fetcher) {
+    return new DependencyResolver(fetcher);
+}
+/**
+ * Create a mock fetcher for testing
+ */
+export function createMockFetcher(skills) {
+    return {
+        async fetchMetadata(source) {
+            // Try exact match first
+            if (skills.has(source)) {
+                return skills.get(source) || null;
+            }
+            // Try by name
+            for (const [key, metadata] of skills.entries()) {
+                if (metadata.name === source || key.endsWith(`/${source}`)) {
+                    return metadata;
+                }
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=dependency-resolver.js.map

package/dist/resolver/dependency-resolver.js.map

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

package/dist/resolver/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Resolver module - Dependency resolution for skills and MCPs
+ *
+ * @example
+ * ```typescript
+ * import { DependencyResolver, createDependencyResolver, createInstallPlan } from '@skillpkg/core';
+ *
+ * const fetcher = {
+ *   async fetchMetadata(source) {
+ *     // Fetch skill metadata from source
+ *     return { name: 'my-skill', version: '1.0.0' };
+ *   }
+ * };
+ *
+ * const resolver = createDependencyResolver(fetcher);
+ *
+ * // Resolve all dependencies
+ * const result = await resolver.resolveDependencies('github:user/my-skill');
+ *
+ * // Create install plan
+ * const plan = createInstallPlan(result);
+ * console.log(formatInstallPlan(plan));
+ *
+ * // Check for circular dependencies
+ * const circular = await resolver.detectCircular('github:user/my-skill');
+ * if (circular) {
+ *   console.log('Circular dependency:', circular.join(' → '));
+ * }
+ * ```
+ */
+export type { ResolvedDependency, DependencyNode, ResolutionResult, McpResolutionResult, SkillFetcher, SkillMetadata, } from './types.js';
+export { DependencyResolver, CircularDependencyError, createDependencyResolver, createMockFetcher, } from './dependency-resolver.js';
+export type { InstallStep, McpRequirement, InstallPlan, InstallStepResult, InstallPlanResult, } from './install-plan.js';
+export { createInstallPlan, recordDependencyInstall, getSkillsToInstall, getInstallCount, hasMcpRequirements, formatInstallPlan, } from './install-plan.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/resolver/index.js

@@ -0,0 +1,34 @@
+/**
+ * Resolver module - Dependency resolution for skills and MCPs
+ *
+ * @example
+ * ```typescript
+ * import { DependencyResolver, createDependencyResolver, createInstallPlan } from '@skillpkg/core';
+ *
+ * const fetcher = {
+ *   async fetchMetadata(source) {
+ *     // Fetch skill metadata from source
+ *     return { name: 'my-skill', version: '1.0.0' };
+ *   }
+ * };
+ *
+ * const resolver = createDependencyResolver(fetcher);
+ *
+ * // Resolve all dependencies
+ * const result = await resolver.resolveDependencies('github:user/my-skill');
+ *
+ * // Create install plan
+ * const plan = createInstallPlan(result);
+ * console.log(formatInstallPlan(plan));
+ *
+ * // Check for circular dependencies
+ * const circular = await resolver.detectCircular('github:user/my-skill');
+ * if (circular) {
+ *   console.log('Circular dependency:', circular.join(' → '));
+ * }
+ * ```
+ */
+// DependencyResolver
+export { DependencyResolver, CircularDependencyError, createDependencyResolver, createMockFetcher, } from './dependency-resolver.js';
+export { createInstallPlan, recordDependencyInstall, getSkillsToInstall, getInstallCount, hasMcpRequirements, formatInstallPlan, } from './install-plan.js';
+//# sourceMappingURL=index.js.map

package/dist/resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAYH,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/resolver/install-plan.d.ts

@@ -0,0 +1,107 @@
+/**
+ * InstallPlan - Prepare installation plan from resolved dependencies
+ *
+ * This module bridges the gap between DependencyResolver and the actual
+ * installation process. It creates a plan that can be executed by the installer.
+ */
+import type { ResolutionResult } from './types.js';
+import type { StateManager } from '../state/index.js';
+/**
+ * A single step in the install plan
+ */
+export interface InstallStep {
+    /** Skill name */
+    name: string;
+    /** Source to install from (github:user/repo, URL, etc.) */
+    source: string;
+    /** Whether this is a transitive dependency */
+    isTransitive: boolean;
+    /** The skill that requires this dependency (for transitive deps) */
+    requiredBy?: string;
+    /** Action to take */
+    action: 'install' | 'skip';
+    /** Reason for skipping (if action is 'skip') */
+    skipReason?: string;
+}
+/**
+ * MCP dependency that needs attention
+ */
+export interface McpRequirement {
+    /** MCP server name */
+    name: string;
+    /** Skills that require this MCP */
+    requiredBy: string[];
+}
+/**
+ * Complete installation plan
+ */
+export interface InstallPlan {
+    /** Steps to execute in order */
+    steps: InstallStep[];
+    /** MCP servers that need to be installed */
+    mcpRequirements: McpRequirement[];
+    /** Whether there were any errors during planning */
+    hasErrors: boolean;
+    /** Error messages */
+    errors: string[];
+    /** Circular dependency chain if detected */
+    circularChain?: string[];
+}
+/**
+ * Result of executing an install step
+ */
+export interface InstallStepResult {
+    step: InstallStep;
+    success: boolean;
+    error?: string;
+    /** Version that was installed */
+    version?: string;
+}
+/**
+ * Result of executing the full install plan
+ */
+export interface InstallPlanResult {
+    /** Successfully installed skills */
+    installed: InstallStepResult[];
+    /** Failed installations */
+    failed: InstallStepResult[];
+    /** Skipped skills */
+    skipped: InstallStep[];
+    /** MCP requirements (not auto-installed) */
+    mcpRequirements: McpRequirement[];
+    /** Overall success */
+    success: boolean;
+}
+/**
+ * Create an install plan from resolution result
+ */
+export declare function createInstallPlan(resolution: ResolutionResult, installedSkills?: Set<string>): InstallPlan;
+/**
+ * Record dependencies in state after successful installation
+ *
+ * Call this after each skill is successfully installed to update
+ * the dependency tracking in state.
+ *
+ * @param projectPath - Path to the project root
+ * @param stateManager - StateManager instance
+ * @param step - The install step that was completed
+ * @param version - Version that was installed
+ */
+export declare function recordDependencyInstall(projectPath: string, stateManager: StateManager, step: InstallStep, version: string): Promise<void>;
+/**
+ * Get skills that would be installed (excluding skipped)
+ */
+export declare function getSkillsToInstall(plan: InstallPlan): InstallStep[];
+/**
+ * Get count of skills to install
+ */
+export declare function getInstallCount(plan: InstallPlan): number;
+/**
+ * Check if plan has any MCP requirements
+ */
+export declare function hasMcpRequirements(plan: InstallPlan): boolean;
+/**
+ * Format plan for display
+ */
+export declare function formatInstallPlan(plan: InstallPlan): string;
+//# sourceMappingURL=install-plan.d.ts.map

package/dist/resolver/install-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plan.d.ts","sourceRoot":"","sources":["../../src/resolver/install-plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,2BAA2B;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,qBAAqB;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,4CAA4C;IAC5C,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,eAAe,GAAE,GAAG,CAAC,MAAM,CAAa,GACvC,WAAW,CAgDb;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAyC3D"}