@vertesia/create-plugin 0.80.0-dev-20251118 → 0.80.0

package/README.md

@@ -1,105 +1,162 @@
-# @vertesia/create-plugin
+# @vertesia/plugin
 
-This package scaffolds Vertesia plugin projects. Use it to create either:
+CLI tool to create Vertesia plugins:
+- UI Plugins
+- Tool Server Plugins.
 
-- **Web Application Plugins**: React-based web applications that extend Vertesia Studio
-- **Agent Tool Server**: Custom agent tools accessible via API endpoints
+## Usage
 
-Visit <https://vertesiahq.com> for more information about Vertesia.
-
-## What Can You Create?
+```bash
+# Using pnpm create (recommended)
+pnpm create @vertesia/plugin my-project
 
-### Web Application Plugin (UI Extensions)
+# Using npm create
+npm create @vertesia/plugin my-project
 
-Vertesia web plugins are React-based web application that can be embedded into the Vertesia Studio interface. They allow you to create custom user experiences focused on specific use cases and business processes, while seamlessly leveraging all the vertesia platform features.
+# Using pnpm dlx (runs without installing)
+pnpm dlx @vertesia/plugin my-project
 
-### Agent Tool Server
+# Using npx
+npx @vertesia/plugin my-project
 
-An Agent Tool Server extends the capabilities of AI agents in Vertesia. It allows you to:
+# Or install globally
+pnpm install -g @vertesia/plugin
+create-tool-server my-project
+```
 
-- Create custom tools that agents can use
-- Integrate with external APIs and services
-- Organize tools into logical collections
-- Expose tools via REST API endpoints
-- Support authentication and context-aware execution
+**Note:** When using `pnpm create` or `npm create`, drop the `create-` prefix from the package name.
 
-## Prerequisites
+## Features
 
-Before creating a plugin project, you need:
+- 📦 **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
 
-- Node.js and pnpm (or npm)
-- Vertesia CLI
-- An application manifest declared in Vertesia
+## How It Works
 
-### Declaring Your Web Application Plugin in Vertesia
+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
 
-Before you can develop and integrate your web application plugin with Vertesia, you must declare an application manifest in the Vertesia platform using the Vertesia CLI.
+## Configuration
 
-#### Install the Vertesia CLI
+All configuration is centralized in `src/configuration.ts`:
 
-If not already done, install the Vertesia CLI and create a profile:
+```typescript
+export const config = {
+  templateRepo: 'vertesiahq/plugin-template',
+  templateConfigFile: 'template.config.json',
+  packageManager: 'pnpm',
+  // ... more options
+}
+```
 
-```bash
-npm install -g @vertesia/cli
-vertesia profiles create
+### 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"
+  ]
+}
 ```
 
-### Create the App Manifest
+### 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
 
-Create the app manifest using the Vertesia CLI:
+## Development
 
 ```bash
-vertesia apps create --manifest '{
-  "name": "my-app",
-  "title": "My App",
-  "description": "A sample app",
-  "publisher": "your-org",
-  "private": true,
-  "status": "beta"
-}' --install
-```
+# Install dependencies
+pnpm install
 
-The `--install` flag will automatically install the app and grant permissions to the creator.
+# Build
+pnpm build
 
-**Important**: The `name` field from your manifest (e.g., `my-app`) is what you'll use as your plugin name in the next step.
+# Test locally
+pnpm test
 
-## Initialize a Plugin Project
+# Watch mode
+pnpm dev
+```
 
-Run the initialization command:
+## Publishing
 
 ```bash
-npm init @vertesia/plugin
-# or
-pnpm create @vertesia/plugin
+# Build and publish
+npm publish
 ```
 
-You will be prompted to choose a template and provide configuration:
+After publishing, users can create projects with:
 
-### Prompts
+```bash
+pnpm create @vertesia/plugin my-project
+```
 
-1. **Template type**: Choose between:
-   - **Web application plugin**: For UI extensions
-   - **Agent tool server**: For custom agent tools
-2. **Package manager**: Choose between npm or pnpm
-3. **Plugin name**: Use kebab-case (e.g., my-plugin or my-tools)
-4. **Plugin version**: Semantic version (e.g., 1.0.0)
-5. **Description**: Optional description of your plugin
+## Template Development
 
-### Web Application Plugin Specific
+To develop a template:
 
-If you select the **Web application plugin** template, you'll also be asked:
+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
 
-1. **Isolation strategy**:
-   - **Shadow DOM**: Fully isolated plugin using Shadow DOM (recommended)
-   - **CSS-only isolation**: Lighter isolation using CSS scope, but may have style conflicts
+## Examples
 
-## Working with Plugins
+### Create a project with default settings
 
-After creating your project, see the README file in the generated project for comprehensive development instructions.
+```bash
+pnpm create @vertesia/plugin my-project
+```
 
-## Support
+### View help
+
+```bash
+pnpm dlx @vertesia/plugin --help
+```
 
-For issues, questions, or feature requests:
+## License
 
-- [GitHub Issues](https://github.com/vertesia/composableai/issues)
-- [Documentation](https://docs.vertesiahq.com/)
+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/packages/tool-server-template'
+     * - 'vertesia/composableai/packages/tool-server-template#main'
+     * - 'vertesia/composableai/packages/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/tools";
+};
+/**
+ * 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;wBAUE,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,68 @@
+/**
+ * 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/packages/tool-server-template'
+     * - 'vertesia/composableai/packages/tool-server-template#main'
+     * - 'vertesia/composableai/packages/tool-server-template#v1.0.0'
+     */
+    templates: [
+        {
+            name: 'Vertesia Tool Server',
+            repository: 'vertesia/composableai/packages/tool-server-template#preview'
+        },
+        {
+            name: 'Vertesia UI Plugin',
+            repository: 'vertesia/composableai/packages/ui-plugin-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/tools',
+};
+/**
+ * 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,sBAAsB;YAC5B,UAAU,EAAE,6DAA6D;SAC1E;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,UAAU,EAAE,2DAA2D;SACxE;KACsB;IAEzB;;;OAGG;IACH,kBAAkB,EAAE,sBAAsB;IAE1C;;;;OAIG;IACH,QAAQ,EAAE,KAAK;IAEf;;OAEG;IACH,OAAO,EAAE,iCAAiC;CAClC,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,159 @@
+#!/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, removeMetaFiles } from './process-template.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.gray('  pnpm create @vertesia/tool-server my-project'));
+        console.log(chalk.gray('  npm create @vertesia/tool-server my-project'));
+        console.log(chalk.gray('  npx @vertesia/create-tool-server my-project\n'));
+        console.log(chalk.gray('Options:'));
+        console.log(chalk.gray('  -b, --branch <branch>  Use specific branch\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: Detect and select package manager
+        const packageManager = await selectPackageManager();
+        // Step 3: Download template from GitHub
+        await downloadTemplate(projectName, selectedTemplate.repository);
+        // Step 4: Read template configuration
+        const templateConfig = readTemplateConfig(projectName);
+        // 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: Remove meta files
+        removeMetaFiles(projectName, templateConfig);
+        // Step 9: Install dependencies
+        await installDependencies(projectName, packageManager);
+        // Step 10: 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,10 @@
+/**
+ * Detect available package managers and let user choose
+ * Returns the selected package manager ('pnpm' or 'npm')
+ */
+export declare function selectPackageManager(): 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;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAmC5D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAapG"}