@vertesia/create-plugin 0.24.0-dev.202601221707

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2024 Composable Prompts
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,162 @@
+# @vertesia/plugin
+
+CLI tool to create Vertesia plugins:
+- UI Plugins
+- Tool Server Plugins.
+
+## Usage
+
+```bash
+# Using pnpm create (recommended)
+pnpm create @vertesia/plugin my-project
+
+# Using npm create
+npm create @vertesia/plugin my-project
+
+# Using pnpm dlx (runs without installing)
+pnpm dlx @vertesia/plugin my-project
+
+# Using npx
+npx @vertesia/plugin my-project
+
+# Or install globally
+pnpm install -g @vertesia/plugin
+create-tool-server my-project
+```
+
+**Note:** When using `pnpm create` or `npm create`, drop the `create-` prefix from the package name.
+
+## Features
+
+- 📦 **Downloads template from GitHub** - Always get the latest template
+- ⚙️ **Template-driven configuration** - Template defines its own prompts via `template.config.json`
+- 🎨 **Interactive prompts** - User-friendly CLI with validation
+- 🔄 **Variable replacement** - Automatically replaces `{{VARIABLES}}` in files
+- 🧹 **Smart cleanup** - Removes meta files after installation
+- 📚 **Package manager agnostic** - Works with npm, pnpm, or yarn
+
+## How It Works
+
+1. **Downloads** the template repository from GitHub using `degit`
+2. **Reads** `template.config.json` from the template to determine configuration
+3. **Prompts** the user for values (project name, description, etc.)
+4. **Replaces** variables in specified files (e.g., `{{PROJECT_NAME}}` → `my-project`)
+5. **Cleans up** meta files (`.git`, `template.config.json`, etc.)
+6. **Installs** dependencies using the configured package manager
+
+## Configuration
+
+All configuration is centralized in `src/configuration.ts`:
+
+```typescript
+export const config = {
+  templateRepo: 'vertesiahq/plugin-template',
+  templateConfigFile: 'template.config.json',
+  packageManager: 'pnpm',
+  // ... more options
+}
+```
+
+### Key Configuration Options
+
+- **`templateRepo`** - GitHub repository for the template (format: `owner/repo`)
+- **`templateConfigFile`** - Name of the config file in the template
+- **`packageManager`** - Which package manager to use (`npm`, `pnpm`, or `yarn`)
+- **`useCache`** - Whether to cache downloaded templates
+
+## Template Structure
+
+The template repository should include a `template.config.json` file:
+
+```json
+{
+  "version": "1.0",
+  "prompts": [
+    {
+      "type": "text",
+      "name": "PROJECT_NAME",
+      "message": "Project name",
+      "initial": "my-tool-server"
+    },
+    {
+      "type": "text",
+      "name": "DESCRIPTION",
+      "message": "Project description",
+      "initial": "A tool server for LLM integrations"
+    }
+  ],
+  "files": [
+    "package.json",
+    "README.md",
+    "src/server.ts"
+  ],
+  "removeAfterInstall": [
+    ".git",
+    "template.config.json"
+  ]
+}
+```
+
+### Template Config Schema
+
+- **`prompts`** - Array of prompts using the [prompts](https://www.npmjs.com/package/prompts) library format
+- **`files`** - List of files where variable replacement should occur
+- **`removeAfterInstall`** - Files/directories to remove after installation
+- **`conditionalRemove`** - Conditional file removal based on user answers
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Test locally
+pnpm test
+
+# Watch mode
+pnpm dev
+```
+
+## Publishing
+
+```bash
+# Build and publish
+npm publish
+```
+
+After publishing, users can create projects with:
+
+```bash
+pnpm create @vertesia/plugin my-project
+```
+
+## Template Development
+
+To develop a template:
+
+1. Create a GitHub repository with your template files
+2. Add a `template.config.json` file with prompts and configuration
+3. Use `{{VARIABLES}}` in files where you want replacements
+4. Update `src/configuration.ts` to point to your template repo
+5. Test with `pnpm test` or run the built CLI directly
+
+## Examples
+
+### Create a project with default settings
+
+```bash
+pnpm create @vertesia/plugin my-project
+```
+
+### View help
+
+```bash
+pnpm dlx @vertesia/plugin --help
+```
+
+## License
+
+MIT

package/lib/configuration.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Configuration for @vertesia/create-tools
+ *
+ * This file centralizes all configuration values for the installer.
+ * Update these values to point to your template repository and customize behavior.
+ */
+/**
+ * Template definition
+ */
+export interface TemplateDefinition {
+    /** Display name for the template (shown to user) */
+    name: string;
+    /** GitHub repository path */
+    repository: string;
+}
+export declare const config: {
+    /**
+     * Available templates
+     * Array of template definitions with display names and repository paths
+     *
+     * Format for repository: 'owner/repo/subdirectory' or 'owner/repo/subdirectory#branch'
+     *
+     * Examples:
+     * - 'vertesia/composableai/templates/tool-server-template'
+     * - 'vertesia/composableai/templates/tool-server-template#main'
+     * - 'vertesia/composableai/templates/tool-server-template#v1.0.0'
+     */
+    readonly templates: TemplateDefinition[];
+    /**
+     * Name of the template configuration file in the template repo
+     * This file should contain prompts and installation instructions
+     */
+    readonly templateConfigFile: "template.config.json";
+    /**
+     * Whether to use cache for degit downloads
+     * Set to true for faster repeated installs (dev mode)
+     * Set to false to always get latest template (production)
+     */
+    readonly useCache: false;
+    /**
+     * Documentation URL to show in help messages
+     */
+    readonly docsUrl: "https://docs.vertesia.com";
+};
+/**
+ * Validation rules for project names
+ */
+export declare const validation: {
+    /**
+     * Regex for valid project names
+     * Allows: lowercase letters, numbers, hyphens
+     */
+    readonly projectNamePattern: RegExp;
+    /**
+     * Error message for invalid project names
+     */
+    readonly projectNameError: "Project name can only contain lowercase letters, numbers, and hyphens";
+    /**
+     * Reserved project names that cannot be used
+     */
+    readonly reservedNames: string[];
+};
+//# sourceMappingURL=configuration.d.ts.map

package/lib/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM;IACjB;;;;;;;;;;OAUG;wBAkBE,kBAAkB,EAAE;IAEzB;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;4BAME,MAAM,EAAE;CACL,CAAC"}

package/lib/configuration.js

@@ -0,0 +1,76 @@
+/**
+ * Configuration for @vertesia/create-tools
+ *
+ * This file centralizes all configuration values for the installer.
+ * Update these values to point to your template repository and customize behavior.
+ */
+export const config = {
+    /**
+     * Available templates
+     * Array of template definitions with display names and repository paths
+     *
+     * Format for repository: 'owner/repo/subdirectory' or 'owner/repo/subdirectory#branch'
+     *
+     * Examples:
+     * - 'vertesia/composableai/templates/tool-server-template'
+     * - 'vertesia/composableai/templates/tool-server-template#main'
+     * - 'vertesia/composableai/templates/tool-server-template#v1.0.0'
+     */
+    templates: [
+        {
+            name: 'Vertesia Plugin',
+            repository: 'vertesia/composableai/templates/plugin-template#preview'
+        },
+        {
+            name: 'Vertesia Tool Server (deprecated)',
+            repository: 'vertesia/composableai/templates/tool-server-template#preview'
+        },
+        {
+            name: 'Vertesia UI Plugin (deprecated)',
+            repository: 'vertesia/composableai/templates/ui-plugin-template#preview'
+        },
+        {
+            name: 'Vertesia Workflow Worker',
+            repository: 'vertesia/composableai/templates/worker-template#preview'
+        }
+    ],
+    /**
+     * Name of the template configuration file in the template repo
+     * This file should contain prompts and installation instructions
+     */
+    templateConfigFile: 'template.config.json',
+    /**
+     * Whether to use cache for degit downloads
+     * Set to true for faster repeated installs (dev mode)
+     * Set to false to always get latest template (production)
+     */
+    useCache: false,
+    /**
+     * Documentation URL to show in help messages
+     */
+    docsUrl: 'https://docs.vertesia.com',
+};
+/**
+ * Validation rules for project names
+ */
+export const validation = {
+    /**
+     * Regex for valid project names
+     * Allows: lowercase letters, numbers, hyphens
+     */
+    projectNamePattern: /^[a-z0-9-]+$/,
+    /**
+     * Error message for invalid project names
+     */
+    projectNameError: 'Project name can only contain lowercase letters, numbers, and hyphens',
+    /**
+     * Reserved project names that cannot be used
+     */
+    reservedNames: [
+        'test',
+        'node_modules',
+        'dist',
+        'build',
+    ],
+};
+//# sourceMappingURL=configuration.js.map

package/lib/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;;;;;;;;;OAUG;IACH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,iBAAiB;YACvB,UAAU,EAAE,yDAAyD;SACtE;QACD;YACE,IAAI,EAAE,mCAAmC;YACzC,UAAU,EAAE,8DAA8D;SAC3E;QACD;YACE,IAAI,EAAE,iCAAiC;YACvC,UAAU,EAAE,4DAA4D;SACzE;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,UAAU,EAAE,yDAAyD;SACtE;KACsB;IAEzB;;;OAGG;IACH,kBAAkB,EAAE,sBAAsB;IAE1C;;;;OAIG;IACH,QAAQ,EAAE,KAAK;IAEf;;OAEG;IACH,OAAO,EAAE,2BAA2B;CAC5B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;;;OAGG;IACH,kBAAkB,EAAE,cAAc;IAElC;;OAEG;IACH,gBAAgB,EAAE,uEAAuE;IAEzF;;OAEG;IACH,aAAa,EAAE;QACb,MAAM;QACN,cAAc;QACd,MAAM;QACN,OAAO;KACI;CACL,CAAC"}

package/lib/download-template.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Download template from GitHub using degit
+ */
+export declare function downloadTemplate(projectName: string, repository: string): Promise<void>;
+//# sourceMappingURL=download-template.d.ts.map

package/lib/download-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-template.d.ts","sourceRoot":"","sources":["../src/download-template.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7F"}

package/lib/download-template.js

@@ -0,0 +1,33 @@
+/**
+ * Template downloading from GitHub
+ */
+import degit from 'degit';
+import chalk from 'chalk';
+import { config } from './configuration.js';
+/**
+ * Download template from GitHub using degit
+ */
+export async function downloadTemplate(projectName, repository) {
+    console.log(chalk.blue('📦 Downloading template from GitHub...\n'));
+    console.log(chalk.gray(`   Repository: ${repository}`));
+    console.log(chalk.gray(`   Target: ./${projectName}\n`));
+    const emitter = degit(repository, {
+        cache: config.useCache,
+        force: true,
+    });
+    // Show download progress
+    emitter.on('info', (info) => {
+        console.log(chalk.gray(`   ${info.message}`));
+    });
+    emitter.on('warn', (warning) => {
+        console.log(chalk.yellow(`   ⚠️  ${warning.message}`));
+    });
+    try {
+        await emitter.clone(projectName);
+        console.log(chalk.green('   ✓ Template downloaded\n'));
+    }
+    catch (error) {
+        throw new Error(`Failed to download template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=download-template.js.map

package/lib/download-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-template.js","sourceRoot":"","sources":["../src/download-template.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,UAAkB;IAC5E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,UAAU,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,IAAI,CAAC,CAAC,CAAC;IAEzD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC,QAAQ;QACtB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9G,CAAC;AACH,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @vertesia/create-tool-server
+ *
+ * CLI tool to create Vertesia tool server projects from GitHub templates.
+ * Reads template.config.json from the template to determine prompts and file replacements.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * @vertesia/create-tool-server
+ *
+ * CLI tool to create Vertesia tool server projects from GitHub templates.
+ * Reads template.config.json from the template to determine prompts and file replacements.
+ */
+import chalk from 'chalk';
+import fs from 'fs';
+import { config, validation } from './configuration.js';
+import { selectTemplate } from './template-selector.js';
+import { selectPackageManager, installDependencies } from './package-manager.js';
+import { downloadTemplate } from './download-template.js';
+import { readTemplateConfig } from './template-config.js';
+import { promptUser } from './prompts.js';
+import { replaceVariables, adjustPackageJson, handleConditionalRemoves, renameFiles, removeMetaFiles } from './process-template.js';
+import { runPreInstallHooks, runPostInstallHooks } from './post-install.js';
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args) {
+    let projectName;
+    let branch;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '-b' || arg === '--branch') {
+            branch = args[i + 1];
+            i++; // Skip next arg
+        }
+        else if (!arg.startsWith('-')) {
+            projectName = arg;
+        }
+    }
+    if (!projectName) {
+        throw new Error('Project name is required');
+    }
+    return { projectName, branch };
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    // Show help
+    if (args.includes('--help') || args.includes('-h')) {
+        showHelp();
+        process.exit(0);
+    }
+    // Parse arguments
+    let projectName;
+    let branch;
+    try {
+        const parsed = parseArgs(args);
+        projectName = parsed.projectName;
+        branch = parsed.branch;
+    }
+    catch (error) {
+        console.log(chalk.red('❌ Please specify a project name:\n'));
+        console.log(chalk.white('Usage:'));
+        console.log(chalk.cyan('  npx @vertesia/create-plugin') + chalk.gray(' <project-name> [options]\n'));
+        console.log(chalk.white('Example:'));
+        console.log(chalk.gray('  npx @vertesia/create-plugin my-project\n'));
+        console.log(chalk.white('Options:'));
+        console.log(chalk.gray('  -b, --branch <branch>  Use specific branch'));
+        console.log(chalk.gray('  -h, --help             Show help\n'));
+        process.exit(1);
+    }
+    // Validate project name
+    if (!validation.projectNamePattern.test(projectName)) {
+        console.log(chalk.red(`❌ ${validation.projectNameError}\n`));
+        process.exit(1);
+    }
+    if (validation.reservedNames.includes(projectName)) {
+        console.log(chalk.red(`❌ "${projectName}" is a reserved name. Please choose a different name.\n`));
+        process.exit(1);
+    }
+    // Check if directory already exists
+    if (fs.existsSync(projectName)) {
+        console.log(chalk.red(`❌ Directory "${projectName}" already exists.\n`));
+        process.exit(1);
+    }
+    try {
+        // Step 1: Select template (only prompts if multiple templates available)
+        const selectedTemplate = await selectTemplate(branch);
+        // Show the selected template name with branch if specified
+        const branchInfo = branch ? chalk.gray(` (branch: ${branch})`) : '';
+        console.log(chalk.blue.bold(`\n🚀 Create ${selectedTemplate.name}`) + branchInfo + '\n');
+        // Step 2: Download template from GitHub
+        await downloadTemplate(projectName, selectedTemplate.repository);
+        // Step 3: Read template configuration
+        const templateConfig = readTemplateConfig(projectName);
+        // Step 4: Detect and select package manager (may be forced by template)
+        const packageManager = await selectPackageManager(templateConfig.packageManager);
+        // Step 5: Prompt user for configuration
+        const answers = await promptUser(projectName, templateConfig);
+        // Step 5: Replace variables in files
+        replaceVariables(projectName, templateConfig, answers);
+        // Step 6: Adjust package.json (name and workspace dependencies)
+        adjustPackageJson(projectName, answers);
+        // Step 7: Handle conditional removes
+        if (templateConfig.conditionalRemove) {
+            handleConditionalRemoves(projectName, templateConfig, answers);
+        }
+        // Step 8: Rename files (e.g., .env.template -> .env)
+        renameFiles(projectName, templateConfig);
+        // Step 9: Remove meta files
+        removeMetaFiles(projectName, templateConfig);
+        // Step 9: Run pre-install hooks (if any) - e.g., CLI authentication for private registries
+        let skipDependencyInstall = false;
+        if (templateConfig.preInstall) {
+            const preInstallSuccess = await runPreInstallHooks(projectName, templateConfig.preInstall, packageManager);
+            if (!preInstallSuccess) {
+                console.log(chalk.yellow('⚠️  Pre-install hooks failed. Skipping dependency installation.\n'));
+                console.log(chalk.gray('You can install dependencies manually after resolving the issue:\n'));
+                console.log(chalk.gray(`  cd ${projectName}`));
+                console.log(chalk.gray(`  ${packageManager} install\n`));
+                skipDependencyInstall = true;
+            }
+        }
+        // Step 10: Install dependencies
+        if (!skipDependencyInstall) {
+            await installDependencies(projectName, packageManager);
+        }
+        // Step 11: Run post-install hooks (if any)
+        if (!skipDependencyInstall && templateConfig.postInstall) {
+            await runPostInstallHooks(projectName, templateConfig.postInstall, packageManager);
+        }
+        // Step 12: Success!
+        showSuccess(projectName, packageManager, selectedTemplate.name, selectedTemplate.repository);
+    }
+    catch (error) {
+        console.log(chalk.red(`\n❌ Installation failed: ${error instanceof Error ? error.message : 'Unknown error'}\n`));
+        // Cleanup on failure
+        if (fs.existsSync(projectName)) {
+            console.log(chalk.gray('Cleaning up...'));
+            fs.rmSync(projectName, { recursive: true, force: true });
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Show success message
+ */
+function showSuccess(projectName, packageManager, templateName, repository) {
+    console.log(chalk.green.bold('✅ Project created successfully!\n'));
+    console.log(chalk.gray('Next steps:\n'));
+    console.log(chalk.cyan(`  cd ${projectName}`));
+    console.log(chalk.cyan(`  ${packageManager} dev`));
+    console.log();
+    console.log(chalk.gray(`Documentation: ${config.docsUrl}`));
+    console.log(chalk.gray(`Template: ${templateName}`));
+    console.log(chalk.gray(`Repository: ${repository}\n`));
+}
+/**
+ * Show help message
+ */
+function showHelp() {
+    console.log(chalk.blue.bold('\nVertesia Project Generator\n'));
+    console.log('Usage:');
+    console.log(chalk.gray('  pnpm create @vertesia/tool-server <project-name> [options]'));
+    console.log(chalk.gray('  npm create @vertesia/tool-server <project-name> [options]'));
+    console.log(chalk.gray('  npx @vertesia/create-tool-server <project-name> [options]\n'));
+    console.log('Options:');
+    console.log(chalk.gray('  -h, --help              Show this help message'));
+    console.log(chalk.gray('  -b, --branch <branch>   Use specific branch (default: configured branch or main)\n'));
+    console.log('Examples:');
+    console.log(chalk.gray('  pnpm create @vertesia/tool-server my-tool-server'));
+    console.log(chalk.gray('  npm create @vertesia/tool-server my-api-tools -b develop'));
+    console.log(chalk.gray('  npx @vertesia/create-tool-server my-project --branch v1.0.0\n'));
+    console.log('Available Templates:');
+    config.templates.forEach(template => {
+        console.log(chalk.gray(`  - ${template.name}`));
+    });
+    console.log();
+    console.log(`Documentation: ${chalk.cyan(config.docsUrl)}\n`);
+}
+// Run the installer
+main().catch((error) => {
+    console.error(chalk.red(`\n❌ Fatal error: ${error.message}\n`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/package-manager.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detect available package managers and let user choose
+ * Returns the selected package manager ('pnpm' or 'npm')
+ * @param forcedPackageManager - If specified, skip selection and use this package manager
+ */
+export declare function selectPackageManager(forcedPackageManager?: 'pnpm' | 'npm'): Promise<string>;
+/**
+ * Install dependencies using the specified package manager
+ */
+export declare function installDependencies(projectName: string, packageManager: string): Promise<void>;
+//# sourceMappingURL=package-manager.d.ts.map

package/lib/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../src/package-manager.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA4CjG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}