kimu-cli 0.1.1 → 1.0.0

package/dist/commands/new.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * New command implementation - Create components from templates
+ * Template-based generator system for extensibility
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupNewCommand = setupNewCommand;
+exports.handleNewCommand = handleNewCommand;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const logger_1 = require("../utils/logger");
+const constants_1 = require("../config/constants");
+/**
+ * Get the templates directory path
+ */
+function getTemplatesDir() {
+    // In development, templates are in the project root
+    // When published, they're in the package root
+    const devPath = path.join(__dirname, '../../templates/generators');
+    const prodPath = path.join(__dirname, '../templates/generators');
+    if (fs.existsSync(devPath)) {
+        return devPath;
+    }
+    else if (fs.existsSync(prodPath)) {
+        return prodPath;
+    }
+    else {
+        throw new Error('Templates directory not found');
+    }
+}
+/**
+ * Discover available generator types
+ */
+function discoverGenerators() {
+    const templatesDir = getTemplatesDir();
+    if (!fs.existsSync(templatesDir)) {
+        return [];
+    }
+    const entries = fs.readdirSync(templatesDir, { withFileTypes: true });
+    return entries
+        .filter(entry => entry.isDirectory())
+        .map(entry => entry.name)
+        .filter(name => fs.existsSync(path.join(templatesDir, name, 'config.json')));
+}
+/**
+ * Load generator configuration
+ */
+function loadGeneratorConfig(type) {
+    const templatesDir = getTemplatesDir();
+    const configPath = path.join(templatesDir, type, 'config.json');
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Generator config not found: ${configPath}`);
+    }
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+}
+/**
+ * Convert kebab-case to PascalCase
+ */
+function toPascalCase(str) {
+    return str
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+/**
+ * Convert kebab-case to camelCase
+ */
+function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/**
+ * Convert kebab-case to Title Case
+ */
+function toTitleCase(str) {
+    return str
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Convert kebab-case to snake_case
+ */
+function toSnakeCase(str) {
+    return str.replace(/-/g, '_');
+}
+/**
+ * Replace placeholders in text
+ */
+function replacePlaceholders(text, name, targetPath) {
+    const replacements = {
+        '{{name}}': name,
+        '{{className}}': toPascalCase(name),
+        '{{kebabName}}': name,
+        '{{camelName}}': toCamelCase(name),
+        '{{titleName}}': toTitleCase(name),
+        '{{snakeName}}': toSnakeCase(name),
+        '{{targetPath}}': targetPath,
+    };
+    let result = text;
+    for (const [placeholder, value] of Object.entries(replacements)) {
+        result = result.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), value);
+    }
+    return result;
+}
+/**
+ * Register component in manifest or config
+ */
+async function registerComponent(config, name, targetPath, logger) {
+    if (!config.registration || !config.registration.enabled) {
+        return;
+    }
+    const { file, type, path: configPath, entry } = config.registration;
+    if (!fs.existsSync(file)) {
+        logger.warn(`Registration file not found: ${file}. Skipping registration.`);
+        return;
+    }
+    const content = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    if (type === 'array') {
+        // Add to array (e.g., extension-manifest.json)
+        const entryWithPlaceholders = JSON.stringify(entry);
+        const finalEntry = JSON.parse(replacePlaceholders(entryWithPlaceholders, name, targetPath));
+        content.push(finalEntry);
+    }
+    else if (type === 'object' && configPath) {
+        // Add to nested object (e.g., kimu.config.json modules.installed)
+        const pathParts = configPath.split('.');
+        let current = content;
+        for (let i = 0; i < pathParts.length - 1; i++) {
+            const key = pathParts[i];
+            if (key && !current[key]) {
+                current[key] = {};
+            }
+            if (key) {
+                current = current[key];
+            }
+        }
+        const lastKey = pathParts[pathParts.length - 1];
+        if (lastKey && !Array.isArray(current[lastKey])) {
+            current[lastKey] = [];
+        }
+        if (lastKey) {
+            current[lastKey].push(name);
+        }
+    }
+    fs.writeFileSync(file, JSON.stringify(content, null, 2) + '\n');
+    logger.success(`Registered in ${file}`);
+}
+/**
+ * Create component from generator template
+ */
+async function createFromTemplate(type, name, options, logger, spinner) {
+    // Load generator configuration
+    const config = loadGeneratorConfig(type);
+    const templatesDir = getTemplatesDir();
+    const templateDir = path.join(templatesDir, type, 'templates');
+    // Resolve target path with placeholders
+    const targetPath = options.path || replacePlaceholders(config.targetPath, name, '');
+    // Check if component already exists
+    if (fs.existsSync(targetPath) && !options.force) {
+        spinner.fail(chalk_1.default.red(`Component already exists: ${targetPath}`));
+        logger.error('Use --force to overwrite');
+        process.exit(1);
+    }
+    // Create target directory
+    fs.ensureDirSync(targetPath);
+    spinner.text = `Creating ${type} structure...`;
+    // Process each template file
+    for (const fileConfig of config.files) {
+        const templatePath = path.join(templateDir, fileConfig.template);
+        const outputPath = path.join(targetPath, replacePlaceholders(fileConfig.output, name, targetPath));
+        if (!fs.existsSync(templatePath)) {
+            logger.warn(`Template not found: ${templatePath}`);
+            continue;
+        }
+        // Read template content
+        const templateContent = fs.readFileSync(templatePath, 'utf-8');
+        // Replace placeholders
+        const finalContent = replacePlaceholders(templateContent, name, targetPath);
+        // Write output file
+        fs.writeFileSync(outputPath, finalContent);
+        if (options.verbose) {
+            logger.debug(`Created: ${outputPath}`);
+        }
+    }
+    // Register component if enabled
+    if (options.register !== false) {
+        spinner.text = `Registering ${type}...`;
+        await registerComponent(config, name, targetPath, logger);
+    }
+    spinner.succeed(chalk_1.default.green(`✅ ${config.name} ${chalk_1.default.cyan(name)} created successfully!`));
+    // Show post-creation instructions
+    if (config.postCreate && config.postCreate.length > 0) {
+        logger.newLine();
+        logger.info(chalk_1.default.bold('Next steps:'));
+        for (const instruction of config.postCreate) {
+            const finalInstruction = replacePlaceholders(instruction, name, targetPath);
+            logger.bullet(finalInstruction);
+        }
+    }
+}
+/**
+ * Setup new command
+ */
+function setupNewCommand(program) {
+    program
+        .command('new <type> <name>')
+        .description('Create a new component from template (extension, module, etc.)')
+        .option('--path <path>', 'custom path for the component')
+        .option('--force', 'overwrite if component already exists')
+        .option('--no-register', 'skip registration in manifest/config')
+        .option('--verbose', 'enable verbose output')
+        .action(async (type, name, options) => {
+        const logger = new logger_1.Logger(options.verbose);
+        await handleNewCommand(type, name, options, logger);
+    });
+    // Add list subcommand to show available generators
+    program
+        .command('new:list')
+        .description('List all available component generators')
+        .action(() => {
+        const generators = discoverGenerators();
+        console.log(chalk_1.default.bold('\nAvailable component generators:\n'));
+        if (generators.length === 0) {
+            console.log(chalk_1.default.yellow('  No generators found.'));
+            console.log(chalk_1.default.gray('  Check templates/generators/ directory.\n'));
+            return;
+        }
+        for (const type of generators) {
+            try {
+                const config = loadGeneratorConfig(type);
+                console.log(`  ${chalk_1.default.cyan(type.padEnd(15))} ${chalk_1.default.gray(config.description)}`);
+            }
+            catch (error) {
+                console.log(`  ${chalk_1.default.cyan(type.padEnd(15))} ${chalk_1.default.red('(config error)')}`);
+            }
+        }
+        console.log('\nUsage: kimu new <type> <name>\n');
+    });
+}
+/**
+ * Handle new command
+ */
+async function handleNewCommand(type, name, options, logger) {
+    const spinner = (0, ora_1.default)('Creating component...').start();
+    try {
+        // Check if we're in a KIMU project
+        if (!fs.existsSync(constants_1.KIMU_CONFIG_FILE)) {
+            spinner.fail(chalk_1.default.red('Not in a KIMU project directory'));
+            logger.error(`Run this command from the root of a KIMU project (${constants_1.KIMU_CONFIG_FILE} not found)`);
+            process.exit(1);
+        }
+        // Validate component type
+        const availableTypes = discoverGenerators();
+        if (!availableTypes.includes(type)) {
+            spinner.fail(chalk_1.default.red(`Invalid component type: ${type}`));
+            logger.error(`Valid types: ${availableTypes.join(', ')}`);
+            logger.info('Run "kimu new:list" to see all available generators');
+            process.exit(1);
+        }
+        // Validate component name
+        const namePattern = /^[a-z0-9-]+$/;
+        if (!namePattern.test(name)) {
+            spinner.fail(chalk_1.default.red('Invalid component name'));
+            logger.error('Component name must contain only lowercase letters, numbers, and hyphens');
+            process.exit(1);
+        }
+        spinner.text = `Creating ${type} ${chalk_1.default.cyan(name)}...`;
+        // Create component from template
+        await createFromTemplate(type, name, options, logger, spinner);
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red('Failed to create component'));
+        logger.error('Error details:', error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/types/cli-types.d.ts

@@ -7,6 +7,13 @@ export interface CreateOptions {
     verbose: boolean;
     yes: boolean;
 }
+export interface NewOptions {
+    path?: string;
+    force: boolean;
+    register: boolean;
+    verbose: boolean;
+}
+export type ComponentType = 'extension' | 'module';
 export interface InstallOptions {
     verbose: boolean;
     save: boolean;

package/dist/types/cli-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-types.d.ts","sourceRoot":"","sources":["../../src/types/cli-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"cli-types.d.ts","sourceRoot":"","sources":["../../src/types/cli-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/utils/module-installer.d.ts

@@ -0,0 +1,11 @@
+interface InstallOptions {
+    verbose?: boolean;
+    type?: 'module' | 'extension';
+    saveDev?: boolean;
+    registry?: string;
+    version?: string;
+    force?: boolean;
+}
+export declare function installModuleOrExtension(name: string, options: InstallOptions): Promise<any>;
+export {};
+//# sourceMappingURL=module-installer.d.ts.map

package/dist/utils/module-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-installer.d.ts","sourceRoot":"","sources":["../../src/utils/module-installer.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,gBAmBxB"}

package/dist/utils/module-installer.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installModuleOrExtension = installModuleOrExtension;
+// module-installer.ts: logica di installazione moduli/estensioni KIMU
+const registry_1 = require("./registry");
+async function installModuleOrExtension(name, options) {
+    const registry = registry_1.KimuRegistry.getInstance();
+    const info = await registry.getModuleInfo(name, options.type);
+    if (!info) {
+        throw new Error(`${options.type || 'Module/Extension'} "${name}" not found in registry.`);
+    }
+    // TODO: download, extraction, file copy, config update, etc.
+    // Mock implementation for now
+    if (options.verbose) {
+        console.log(`[DEBUG] Mock installation of ${info.type}: ${info.name} (${info.version})`);
+    }
+    // Simulate installation
+    await new Promise(resolve => setTimeout(resolve, 500));
+    return info;
+}
+//# sourceMappingURL=module-installer.js.map

package/dist/utils/module-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-installer.js","sourceRoot":"","sources":["../../src/utils/module-installer.ts"],"names":[],"mappings":";;AAYA,4DAqBC;AAjCD,sEAAsE;AACtE,yCAA0C;AAWnC,KAAK,UAAU,wBAAwB,CAC5C,IAAY,EACZ,OAAuB;IAEvB,MAAM,QAAQ,GAAG,uBAAY,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,IAAI,kBAAkB,KAAK,IAAI,0BAA0B,CACzE,CAAC;IACJ,CAAC;IACD,6DAA6D;IAC7D,8BAA8B;IAC9B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CACT,gCAAgC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,GAAG,CAC5E,CAAC;IACJ,CAAC;IACD,wBAAwB;IACxB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/registry.d.ts

@@ -0,0 +1,8 @@
+export declare class KimuRegistry {
+    private static instance;
+    static getInstance(): KimuRegistry;
+    getModuleInfo(name: string, type?: 'module' | 'extension'): Promise<any | null>;
+    listModules(): Promise<any[]>;
+    listExtensions(): Promise<any[]>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/utils/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IAEtC,MAAM,CAAC,WAAW,IAAI,YAAY;IAO5B,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,GAC5B,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAqDhB,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IA2B7B,cAAc,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;CAoBvC"}

package/dist/utils/registry.js

@@ -0,0 +1,109 @@
+"use strict";
+// KimuRegistry: manages the catalog of modules/extensions from the official registry
+// (Initial stub, to be expanded with real fetch, cache, etc.)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KimuRegistry = void 0;
+class KimuRegistry {
+    static getInstance() {
+        if (!KimuRegistry.instance) {
+            KimuRegistry.instance = new KimuRegistry();
+        }
+        return KimuRegistry.instance;
+    }
+    async getModuleInfo(name, type) {
+        // TODO: real fetch from remote registry
+        // Mock for now: "router" module and "kimu-home" extension
+        const mockCatalog = {
+            modules: {
+                router: {
+                    name: 'router',
+                    type: 'module',
+                    version: '1.2.0',
+                    description: 'Routing module',
+                },
+                i18n: {
+                    name: 'i18n',
+                    type: 'module',
+                    version: '1.5.0',
+                    description: 'Internationalization module',
+                },
+                analytics: {
+                    name: 'analytics',
+                    type: 'module',
+                    version: '0.8.0',
+                    description: 'Analytics tracking module',
+                },
+            },
+            extensions: {
+                'kimu-home': {
+                    name: 'kimu-home',
+                    type: 'extension',
+                    version: '1.0.0',
+                    description: 'Home extension',
+                },
+                'kimu-dashboard': {
+                    name: 'kimu-dashboard',
+                    type: 'extension',
+                    version: '2.1.0',
+                    description: 'Dashboard extension',
+                },
+            },
+        };
+        if (type === 'module') {
+            return mockCatalog.modules[name] || null;
+        }
+        else if (type === 'extension') {
+            return mockCatalog.extensions[name] || null;
+        }
+        // Fallback: search in both
+        return mockCatalog.modules[name] || mockCatalog.extensions[name] || null;
+    }
+    async listModules() {
+        // TODO: real fetch from remote registry
+        const mockCatalog = {
+            modules: {
+                router: {
+                    name: 'router',
+                    type: 'module',
+                    version: '1.2.0',
+                    description: 'Routing module',
+                },
+                i18n: {
+                    name: 'i18n',
+                    type: 'module',
+                    version: '1.5.0',
+                    description: 'Internationalization module',
+                },
+                analytics: {
+                    name: 'analytics',
+                    type: 'module',
+                    version: '0.8.0',
+                    description: 'Analytics tracking module',
+                },
+            },
+        };
+        return Object.values(mockCatalog.modules);
+    }
+    async listExtensions() {
+        // TODO: real fetch from remote registry
+        const mockCatalog = {
+            extensions: {
+                'kimu-home': {
+                    name: 'kimu-home',
+                    type: 'extension',
+                    version: '1.0.0',
+                    description: 'Home extension',
+                },
+                'kimu-dashboard': {
+                    name: 'kimu-dashboard',
+                    type: 'extension',
+                    version: '2.1.0',
+                    description: 'Dashboard extension',
+                },
+            },
+        };
+        return Object.values(mockCatalog.extensions);
+    }
+}
+exports.KimuRegistry = KimuRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/utils/registry.js.map

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

package/docs/README.md

@@ -0,0 +1,126 @@
+# KIMU-CLI Documentation
+
+Welcome to the official documentation for KIMU-CLI, the command-line interface for the KIMU framework ecosystem.
+
+## 🚀 Quick Links
+
+### **New to KIMU-CLI?**
+Start here: [**Getting Started Guide**](getting-started.md) ⭐
+
+This comprehensive guide walks you through:
+- Installing KIMU-CLI
+- Creating your first project
+- Understanding the project structure
+- Making your first changes
+- Building and deploying
+
+### **Need Quick Reference?**
+Common commands: [**Quick Reference**](quick-reference.md) 🚀
+
+One-page guide with:
+- Most used commands
+- Common workflows
+- Troubleshooting tips
+- Configuration examples
+
+### Documentation Index
+- [**Documentation Index**](index.md) - Complete documentation map
+- [**Introduction**](intro.md) - What is KIMU-CLI and why use it
+- [**Command Reference**](command-kimu.md) - All available commands
+- [**Distribution Guide**](distribution.md) - Advanced installation and publishing
+
+## 📚 Available Commands
+
+### ✅ Ready to Use
+- [`kimu create`](commands/create.md) - Create new KIMU projects
+- [`kimu new`](commands/new.md) - Create components from templates
+- [`kimu info`](commands/info.md) - Show project information
+- [`kimu version`](commands/version.md) - Display version information
+- [`kimu help`](commands/help.md) - Get command help
+
+### ⏳ Coming Soon
+- [`kimu install`](commands/install.md) - Install modules and extensions
+- [`kimu remove`](commands/remove.md) - Remove packages
+- [`kimu list`](commands/list.md) - List available/installed packages
+- [`kimu build`](commands/build.md) - Build for production
+- [`kimu dev`](commands/dev.md) - Start development server
+- [`kimu serve`](commands/serve.md) - Serve built project
+- [`kimu doctor`](commands/doctor.md) - Project diagnostics
+
+## 🎯 Quick Start
+
+### Installation
+```bash
+# Global installation
+npm install -g kimu-cli
+
+# Or use with npx
+npx kimu-cli create my-app
+```
+
+### Create a Project
+```bash
+# Create new project
+kimu create my-awesome-app
+
+# Navigate to it
+cd my-awesome-app
+
+# Start developing
+npm run dev
+```
+
+### Get Help
+```bash
+# General help
+kimu --help
+
+# Command-specific help
+kimu create --help
+
+# Check version
+kimu --version
+```
+
+## 📖 Documentation Structure
+
+```
+docs/
+├── README.md              # This file
+├── index.md               # Documentation index and navigation
+├── getting-started.md     # Complete tutorial for beginners
+├── intro.md               # Introduction to KIMU-CLI
+├── command-kimu.md        # Complete command reference
+├── distribution.md        # Installation and publishing guide
+└── commands/              # Detailed command documentation
+    ├── create.md
+    ├── info.md
+    ├── version.md
+    ├── help.md
+    └── ... (more commands)
+```
+
+## 🔗 External Resources
+
+- **NPM Package**: [kimu-cli on npm](https://www.npmjs.com/package/kimu-cli)
+- **GitHub Repository**: [UnicoVerso/kimu-cli](https://github.com/UnicoVerso/kimu-cli)
+- **KIMU Core Framework**: [kimu-core on npm](https://www.npmjs.com/package/kimu-core)
+- **KIMU Core Repo**: [UnicoVerso/kimu-core](https://github.com/UnicoVerso/kimu-core)
+
+## 💡 Need Help?
+
+- **Documentation**: You're reading it! Browse the links above
+- **GitHub Issues**: [Report bugs or request features](https://github.com/UnicoVerso/kimu-cli/issues)
+- **GitHub Discussions**: [Ask questions and share ideas](https://github.com/UnicoVerso/kimu-cli/discussions)
+
+## 📝 Contributing to Documentation
+
+Found an error or want to improve the docs? Contributions are welcome!
+
+1. Fork the repository
+2. Edit the markdown files in `/docs/`
+3. Submit a pull request
+
+---
+
+**Ready to start building with KIMU?** Begin with the [Getting Started Guide](getting-started.md)! 🚀