@brookmind/ai-toolkit 1.1.7 → 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Castillo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # AI Toolkit
 
+[![npm version](https://img.shields.io/npm/v/@brookmind/ai-toolkit.svg)](https://www.npmjs.com/package/@brookmind/ai-toolkit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
+
 A collection of agents, skills, and MCPs for AI coding assistants.
 
 ## Quick Install
@@ -14,6 +18,7 @@ The installer will:
 2. **Guide you through selecting**:
    - **Agents**: AI assistants for specific tasks
    - **Skills**: Extended capabilities and workflows
+   - **Commands**: Reusable prompts for common tasks
    - **MCPs**: Model Context Protocol servers
 3. **Theme installation**:
    - **New installations**: claude-vivid theme is installed automatically
@@ -23,27 +28,47 @@ The installer will:
 
 ### Agents
 
-- `code-reviewer` - Expert code review for quality and security
-- `code-simplifier` - Simplifies and refines code for clarity and maintainability
+| Name | Description |
+|------|-------------|
+| `changelog-generator` | Changelog and release notes from git history |
+| `code-reviewer` | Code review for quality, security, maintainability |
+| `code-simplifier` | Simplify code for clarity and maintainability |
+
+### Commands
+
+| Name | Description |
+|------|-------------|
+| `create-pr` | Create PR on GitHub with optional reviewer |
+| `create-pr-description` | Generate PR title and description |
+| `create-react-tests` | Generate Jest + RTL tests (90% coverage) |
 
 ### Skills
 
-- `github-cli` - GitHub operations (issues, PRs, releases)
-- `pdf-processing-pro` - Advanced PDF processing (OCR, tables, forms extraction)
-- `react-best-practices` - React performance optimization guidelines from Vercel Engineering
-- `skill-creator` - Create new skills
+| Name | Description |
+|------|-------------|
+| `expo-best-practices` | UI, navigation, styling, data fetching for Expo apps |
+| `github-cli` | Issues, PRs, releases via gh CLI |
+| `pdf-processing-pro` | Forms, tables, OCR, batch PDF operations |
+| `react-best-practices` | Performance patterns from Vercel Engineering |
+| `react-native-best-practices` | FPS, TTI, bundle size, animations optimization |
+| `skill-creator` | Guide for creating custom skills |
+| `spring-boot-development` | REST APIs, JPA, Security, microservices |
 
 ### MCPs
 
-- `context7` - Up-to-date library documentation
-- `expo-mcp` - Expo/React Native utilities
-- `figma-mcp` - Figma design integration (requires Figma Desktop app)
+| Name | Description |
+|------|-------------|
+| `context7` | Up-to-date library documentation |
+| `expo-mcp` | Expo/React Native utilities |
+| `figma-mcp` | Figma design integration (requires Desktop app) |
 
 ### Theme
 
-- `claude-vivid` - High-contrast theme with vivid colors inspired by Claude Code
-  - Auto-installed for new OpenCode users
-  - Optional for existing OpenCode users
+| Name | Description |
+|------|-------------|
+| `claude-vivid` | High-contrast theme with vivid colors |
+
+> Theme is auto-installed for new users, optional for existing installations.
 
 ## Manual Installation
 
@@ -58,8 +83,7 @@ npm start
 
 ## Requirements
 
-- Node.js 18+
-- OpenCode installed
+- Node.js 20+
 - For Figma MCP: Figma Desktop app running
 
 ## Configuration
@@ -95,6 +119,10 @@ To use GitHub Copilot with OpenCode, follow these steps:
 
 That's it! GitHub Copilot will now be available as a provider in OpenCode.
 
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
 ## License
 
 MIT

package/dist/__tests__/constants.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=constants.test.d.ts.map

package/dist/__tests__/constants.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/constants.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/constants.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { join } from 'path';
+import { homedir } from 'os';
+import { ROOT_DIR, TOOLS_DIR, HOME_DIR, OPENCODE_DIR, OPENCODE_CONFIG, BOTTOM_PADDING, MCP_DISPLAY_NAMES, DESCRIPTIONS, getDescription, } from '../constants.js';
+describe('constants', () => {
+    describe('path constants', () => {
+        it('should have ROOT_DIR pointing to project root', () => {
+            expect(ROOT_DIR).toBeDefined();
+            expect(typeof ROOT_DIR).toBe('string');
+            expect(ROOT_DIR.length).toBeGreaterThan(0);
+        });
+        it('should have TOOLS_DIR as subdirectory of ROOT_DIR', () => {
+            expect(TOOLS_DIR).toBe(join(ROOT_DIR, 'tools'));
+        });
+        it('should have HOME_DIR equal to os.homedir()', () => {
+            expect(HOME_DIR).toBe(homedir());
+        });
+        it('should have OPENCODE_DIR in .config/opencode', () => {
+            expect(OPENCODE_DIR).toBe(join(HOME_DIR, '.config', 'opencode'));
+        });
+        it('should have OPENCODE_CONFIG as opencode.json in OPENCODE_DIR', () => {
+            expect(OPENCODE_CONFIG).toBe(join(OPENCODE_DIR, 'opencode.json'));
+        });
+    });
+    describe('BOTTOM_PADDING', () => {
+        it('should be 5', () => {
+            expect(BOTTOM_PADDING).toBe(5);
+        });
+        it('should be a positive integer', () => {
+            expect(Number.isInteger(BOTTOM_PADDING)).toBe(true);
+            expect(BOTTOM_PADDING).toBeGreaterThan(0);
+        });
+    });
+    describe('MCP_DISPLAY_NAMES', () => {
+        it('should be a non-empty object', () => {
+            expect(typeof MCP_DISPLAY_NAMES).toBe('object');
+            expect(Object.keys(MCP_DISPLAY_NAMES).length).toBeGreaterThan(0);
+        });
+        it('should map pg-aiguide to postgres-mcp', () => {
+            expect(MCP_DISPLAY_NAMES['pg-aiguide']).toBe('postgres-mcp');
+        });
+        it('should have string values only', () => {
+            for (const value of Object.values(MCP_DISPLAY_NAMES)) {
+                expect(typeof value).toBe('string');
+            }
+        });
+    });
+    describe('DESCRIPTIONS', () => {
+        it('should be a non-empty object', () => {
+            expect(typeof DESCRIPTIONS).toBe('object');
+            expect(Object.keys(DESCRIPTIONS).length).toBeGreaterThan(0);
+        });
+        it('should have string values only', () => {
+            for (const value of Object.values(DESCRIPTIONS)) {
+                expect(typeof value).toBe('string');
+                expect(value.length).toBeGreaterThan(0);
+            }
+        });
+        it('should contain agent descriptions', () => {
+            expect(DESCRIPTIONS['changelog-generator']).toBeDefined();
+            expect(DESCRIPTIONS['code-reviewer']).toBeDefined();
+            expect(DESCRIPTIONS['code-simplifier']).toBeDefined();
+        });
+        it('should contain command descriptions', () => {
+            expect(DESCRIPTIONS['create-pr']).toBeDefined();
+            expect(DESCRIPTIONS['create-pr-description']).toBeDefined();
+            expect(DESCRIPTIONS['create-react-tests']).toBeDefined();
+        });
+        it('should contain skill descriptions', () => {
+            expect(DESCRIPTIONS['expo-best-practices']).toBeDefined();
+            expect(DESCRIPTIONS['github-cli']).toBeDefined();
+            expect(DESCRIPTIONS['react-best-practices']).toBeDefined();
+        });
+        it('should contain MCP descriptions', () => {
+            expect(DESCRIPTIONS['context7']).toBeDefined();
+            expect(DESCRIPTIONS['expo-mcp']).toBeDefined();
+        });
+    });
+    describe('getDescription', () => {
+        it('should return description for existing key', () => {
+            const result = getDescription('changelog-generator');
+            expect(result).toBe('Generate changelogs and release notes');
+        });
+        it('should return null for non-existing key', () => {
+            const result = getDescription('non-existing-key');
+            expect(result).toBeNull();
+        });
+        it('should return null for empty string key', () => {
+            const result = getDescription('');
+            expect(result).toBeNull();
+        });
+        it('should handle context7 (unquoted key)', () => {
+            const result = getDescription('context7');
+            expect(result).toBe('Library documentation lookup');
+        });
+        it('should handle quoted and hyphenated keys', () => {
+            const result = getDescription('pdf-processing-pro');
+            expect(result).toBe('Forms, tables, OCR, batch operations');
+        });
+    });
+});
+//# sourceMappingURL=constants.test.js.map

package/dist/__tests__/constants.test.js.map

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

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.js

@@ -0,0 +1,114 @@
+import { describe, it, expect } from 'vitest';
+import { access, readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+describe('project structure', () => {
+    it('should have required directories in tools/', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const toolsDir = join(rootDir, 'tools');
+        const dirs = ['agents', 'commands', 'skills', 'mcps', 'themes'];
+        for (const dir of dirs) {
+            const dirExists = await exists(join(toolsDir, dir));
+            expect(dirExists, `tools/${dir} directory should exist`).toBe(true);
+        }
+    });
+    it('should have package.json', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const pkgExists = await exists(join(rootDir, 'package.json'));
+        expect(pkgExists).toBe(true);
+    });
+    it('should have LICENSE file', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const licenseExists = await exists(join(rootDir, 'LICENSE'));
+        expect(licenseExists).toBe(true);
+    });
+});
+describe('skills validation', () => {
+    it('should have SKILL.md in each skill folder', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const skillsDir = join(rootDir, 'tools', 'skills');
+        const skills = await readdir(skillsDir, { withFileTypes: true });
+        const skillDirs = skills.filter((s) => s.isDirectory()).map((s) => s.name);
+        for (const skill of skillDirs) {
+            const skillMdExists = await exists(join(skillsDir, skill, 'SKILL.md'));
+            expect(skillMdExists, `${skill}/SKILL.md should exist`).toBe(true);
+        }
+    });
+});
+describe('mcps validation', () => {
+    it('should have .mcp.json in each mcp folder', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const mcpsDir = join(rootDir, 'tools', 'mcps');
+        const mcps = await readdir(mcpsDir, { withFileTypes: true });
+        const mcpDirs = mcps.filter((m) => m.isDirectory()).map((m) => m.name);
+        for (const mcp of mcpDirs) {
+            const mcpJsonExists = await exists(join(mcpsDir, mcp, '.mcp.json'));
+            expect(mcpJsonExists, `${mcp}/.mcp.json should exist`).toBe(true);
+        }
+    });
+});
+describe('descriptions validation', () => {
+    const getDescriptionsFromSource = async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const constantsPath = join(rootDir, 'src', 'constants.ts');
+        const content = await readFile(constantsPath, 'utf-8');
+        const match = content.match(/export const DESCRIPTIONS[^{]*\{([^}]+)\}/s);
+        if (!match)
+            return new Set();
+        const quotedKeys = match[1].match(/'([^']+)':/g) || [];
+        const unquotedKeys = match[1].match(/^\s*([a-zA-Z0-9-]+):/gm) || [];
+        const keys = new Set();
+        quotedKeys.forEach((k) => keys.add(k.replace(/'/g, '').replace(':', '')));
+        unquotedKeys.forEach((k) => keys.add(k.trim().replace(':', '')));
+        return keys;
+    };
+    it('should have description for each agent', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const agentsDir = join(rootDir, 'tools', 'agents');
+        const descriptions = await getDescriptionsFromSource();
+        const files = await readdir(agentsDir);
+        const agents = files.filter((f) => f.endsWith('.md')).map((f) => f.replace('.md', ''));
+        for (const agent of agents) {
+            expect(descriptions.has(agent), `Agent '${agent}' missing description`).toBe(true);
+        }
+    });
+    it('should have description for each skill', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const skillsDir = join(rootDir, 'tools', 'skills');
+        const descriptions = await getDescriptionsFromSource();
+        const entries = await readdir(skillsDir, { withFileTypes: true });
+        const skills = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+        for (const skill of skills) {
+            expect(descriptions.has(skill), `Skill '${skill}' missing description`).toBe(true);
+        }
+    });
+    it('should have description for each command', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const commandsDir = join(rootDir, 'tools', 'commands');
+        const descriptions = await getDescriptionsFromSource();
+        const files = await readdir(commandsDir);
+        const commands = files.filter((f) => f.endsWith('.md')).map((f) => f.replace('.md', ''));
+        for (const command of commands) {
+            expect(descriptions.has(command), `Command '${command}' missing description`).toBe(true);
+        }
+    });
+    it('should have description for each MCP', async () => {
+        const rootDir = join(import.meta.dirname, '..', '..');
+        const mcpsDir = join(rootDir, 'tools', 'mcps');
+        const descriptions = await getDescriptionsFromSource();
+        const entries = await readdir(mcpsDir, { withFileTypes: true });
+        const mcps = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+        for (const mcp of mcps) {
+            expect(descriptions.has(mcp), `MCP '${mcp}' missing description`).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEhE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAE3E,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;YACvE,MAAM,CAAC,aAAa,EAAE,GAAG,KAAK,wBAAwB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEvE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,aAAa,EAAE,GAAG,GAAG,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,MAAM,yBAAyB,GAAG,KAAK,IAA0B,EAAE;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC;QAEpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjE,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnD,MAAM,YAAY,GAAG,MAAM,yBAAyB,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAEvF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,UAAU,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnD,MAAM,YAAY,GAAG,MAAM,yBAAyB,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,UAAU,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAEvD,MAAM,YAAY,GAAG,MAAM,yBAAyB,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAEzF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,YAAY,OAAO,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/C,MAAM,YAAY,GAAG,MAAM,yBAAyB,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEvE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,GAAG,uBAAuB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/integration/installer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=installer.test.d.ts.map

package/dist/__tests__/integration/installer.test.d.ts.map

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