create-nexo 1.0.0

package/dist/plugins/loader.js

@@ -0,0 +1,229 @@
+/**
+ * NEXO Plugin System - Plugin Loader
+ *
+ * Loads plugins from various sources:
+ * - .nexorc.json configuration file
+ * - package.json nexo config
+ * - Direct npm packages
+ * - Local file paths
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import pc from 'picocolors';
+import { loadPlugins, pluginManager } from './manager.js';
+// ============================================
+// Configuration File Paths
+// ============================================
+const CONFIG_FILES = [
+    '.nexorc.json',
+    '.nexorc',
+    'nexo.config.json',
+    '.config/nexo.json',
+];
+// ============================================
+// Configuration Loading
+// ============================================
+/**
+ * Find and read the nexo configuration file
+ */
+export const findConfig = async (cwd = process.cwd()) => {
+    // Try config files
+    for (const configFile of CONFIG_FILES) {
+        const configPath = path.join(cwd, configFile);
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist or can't be parsed
+        }
+    }
+    // Try package.json
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        const content = await fs.readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        if (pkg.nexo) {
+            return pkg.nexo;
+        }
+    }
+    catch {
+        // No package.json or no nexo config
+    }
+    return null;
+};
+/**
+ * Resolve extends in configuration
+ */
+const resolveExtends = async (config, cwd) => {
+    if (!config.extends) {
+        return config;
+    }
+    try {
+        // Try to load extended config
+        let extendedConfig;
+        if (config.extends.startsWith('.')) {
+            // Local path
+            const extPath = path.resolve(cwd, config.extends);
+            const content = await fs.readFile(extPath, 'utf-8');
+            extendedConfig = JSON.parse(content);
+        }
+        else {
+            // npm package
+            const module = await import(config.extends);
+            extendedConfig = module.default || module;
+        }
+        // Recursively resolve extends
+        extendedConfig = await resolveExtends(extendedConfig, cwd);
+        // Merge configurations
+        return {
+            ...extendedConfig,
+            ...config,
+            plugins: [
+                ...(extendedConfig.plugins || []),
+                ...(config.plugins || []),
+            ],
+            defaults: {
+                ...extendedConfig.defaults,
+                ...config.defaults,
+            },
+            customConfigurators: [
+                ...(extendedConfig.customConfigurators || []),
+                ...(config.customConfigurators || []),
+            ],
+        };
+    }
+    catch (error) {
+        console.warn(pc.yellow(`Warning: Failed to load extended config "${config.extends}": ${error}`));
+        return config;
+    }
+};
+/**
+ * Load all plugins from configuration
+ */
+export const loadPluginsFromConfig = async (cwd = process.cwd()) => {
+    const results = [];
+    // Find configuration
+    let config = await findConfig(cwd);
+    if (!config) {
+        return { config: null, results };
+    }
+    // Resolve extends
+    config = await resolveExtends(config, cwd);
+    // Load plugins
+    if (config.plugins && config.plugins.length > 0) {
+        const pluginSources = config.plugins.map(source => {
+            // Resolve local paths
+            if (source.startsWith('.')) {
+                return path.resolve(cwd, source);
+            }
+            return source;
+        });
+        const loadResults = await loadPlugins(pluginSources);
+        results.push(...loadResults);
+    }
+    // Load custom configurators
+    if (config.customConfigurators && config.customConfigurators.length > 0) {
+        for (const custom of config.customConfigurators) {
+            const customPath = path.resolve(cwd, custom.path);
+            try {
+                const module = await import(customPath);
+                const configurator = module.default || module;
+                // Create a mini-plugin for this configurator
+                const plugin = {
+                    name: `custom-configurator-${custom.name}`,
+                    version: '1.0.0',
+                    configurators: {
+                        [custom.name]: configurator,
+                    },
+                };
+                pluginManager.register(plugin);
+                results.push({ success: true, plugin });
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    error: `Failed to load custom configurator "${custom.name}": ${error}`,
+                });
+            }
+        }
+    }
+    return { config, results };
+};
+/**
+ * Initialize plugins from configuration and return defaults
+ */
+export const initializePlugins = async (cwd = process.cwd()) => {
+    const errors = [];
+    const { config, results } = await loadPluginsFromConfig(cwd);
+    // Collect errors
+    for (const result of results) {
+        if (!result.success && result.error) {
+            errors.push(result.error);
+        }
+    }
+    const loadedCount = results.filter(r => r.success).length;
+    return {
+        defaults: config?.defaults || {},
+        loadedCount,
+        errors,
+    };
+};
+// ============================================
+// Plugin Discovery
+// ============================================
+/**
+ * Discover plugins in node_modules that match naming convention
+ */
+export const discoverPlugins = async (cwd = process.cwd()) => {
+    const discovered = [];
+    const nodeModulesPath = path.join(cwd, 'node_modules');
+    try {
+        const entries = await fs.readdir(nodeModulesPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            // Check for nexo-plugin-* pattern
+            if (entry.name.startsWith('nexo-plugin-')) {
+                discovered.push(entry.name);
+            }
+            // Check for @nexo/* scoped packages
+            if (entry.name === '@nexo') {
+                const scopedPath = path.join(nodeModulesPath, '@nexo');
+                const scopedEntries = await fs.readdir(scopedPath, { withFileTypes: true });
+                for (const scoped of scopedEntries) {
+                    if (scoped.isDirectory()) {
+                        discovered.push(`@nexo/${scoped.name}`);
+                    }
+                }
+            }
+            // Check for @*/nexo-* pattern in other scopes
+            if (entry.name.startsWith('@')) {
+                const scopedPath = path.join(nodeModulesPath, entry.name);
+                try {
+                    const scopedEntries = await fs.readdir(scopedPath, { withFileTypes: true });
+                    for (const scoped of scopedEntries) {
+                        if (scoped.isDirectory() && scoped.name.startsWith('nexo-')) {
+                            discovered.push(`${entry.name}/${scoped.name}`);
+                        }
+                    }
+                }
+                catch {
+                    // Scope directory not readable
+                }
+            }
+        }
+    }
+    catch {
+        // node_modules doesn't exist or can't be read
+    }
+    return discovered;
+};
+/**
+ * Auto-discover and load plugins
+ */
+export const autoDiscoverPlugins = async (cwd = process.cwd()) => {
+    const discovered = await discoverPlugins(cwd);
+    return loadPlugins(discovered);
+};
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/manager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * NEXO Plugin System - Plugin Manager
+ */
+import type { NexoPlugin, PluginLoadResult, PluginManager } from './types.js';
+/**
+ * Create a plugin manager instance
+ */
+export declare const createPluginManager: () => PluginManager;
+/**
+ * Global plugin manager instance
+ */
+export declare const pluginManager: PluginManager;
+/**
+ * Define a plugin (helper for type safety)
+ *
+ * @example
+ * ```typescript
+ * export default definePlugin({
+ *   name: 'my-plugin',
+ *   version: '1.0.0',
+ *   beforeSetup: async (ctx) => {
+ *     console.log('Before setup!');
+ *   }
+ * });
+ * ```
+ */
+export declare const definePlugin: (plugin: NexoPlugin) => NexoPlugin;
+/**
+ * Load plugins from a list of sources
+ */
+export declare const loadPlugins: (sources: string[], manager?: PluginManager) => Promise<PluginLoadResult[]>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/plugins/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EAEd,MAAM,YAAY,CAAC;AAqBpB;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAO,aA+KtC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,aAAa,eAAwB,CAAC;AAMnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,UAAU,KAAG,UAAoB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,SAAS,MAAM,EAAE,EACjB,UAAS,aAA6B,KACrC,OAAO,CAAC,gBAAgB,EAAE,CAa5B,CAAC"}

package/dist/plugins/manager.js

@@ -0,0 +1,220 @@
+/**
+ * NEXO Plugin System - Plugin Manager
+ */
+import pc from 'picocolors';
+// ============================================
+// Plugin Registry
+// ============================================
+const createRegistry = () => ({
+    plugins: new Map(),
+    hooks: {
+        beforeSetup: [],
+        afterSetup: [],
+        beforeConfigurator: [],
+        afterConfigurator: [],
+        modifySelections: [],
+    },
+});
+// ============================================
+// Plugin Manager Implementation
+// ============================================
+/**
+ * Create a plugin manager instance
+ */
+export const createPluginManager = () => {
+    const registry = createRegistry();
+    /**
+     * Load a plugin from a source (npm package or local path)
+     */
+    const load = async (source) => {
+        try {
+            // Dynamic import
+            const module = await import(source);
+            const plugin = module.default || module;
+            // Validate plugin
+            if (!plugin.name || !plugin.version) {
+                return {
+                    success: false,
+                    error: `Invalid plugin: missing name or version (source: ${source})`,
+                };
+            }
+            // Register the plugin
+            register(plugin);
+            return { success: true, plugin };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to load plugin from "${source}": ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    };
+    /**
+     * Register a plugin and its hooks
+     */
+    const register = (plugin) => {
+        // Check for duplicate
+        if (registry.plugins.has(plugin.name)) {
+            console.warn(pc.yellow(`Plugin "${plugin.name}" is already registered. Overwriting.`));
+        }
+        // Store plugin
+        registry.plugins.set(plugin.name, plugin);
+        // Register hooks
+        if (plugin.beforeSetup) {
+            registry.hooks.beforeSetup.push(plugin.beforeSetup);
+        }
+        if (plugin.afterSetup) {
+            registry.hooks.afterSetup.push(plugin.afterSetup);
+        }
+        if (plugin.beforeConfigurator) {
+            registry.hooks.beforeConfigurator.push(plugin.beforeConfigurator);
+        }
+        if (plugin.afterConfigurator) {
+            registry.hooks.afterConfigurator.push(plugin.afterConfigurator);
+        }
+        if (plugin.modifySelections) {
+            registry.hooks.modifySelections.push(plugin.modifySelections);
+        }
+    };
+    /**
+     * Unregister a plugin
+     */
+    const unregister = (name) => {
+        const plugin = registry.plugins.get(name);
+        if (!plugin)
+            return;
+        // Remove hooks
+        if (plugin.beforeSetup) {
+            const idx = registry.hooks.beforeSetup.indexOf(plugin.beforeSetup);
+            if (idx > -1)
+                registry.hooks.beforeSetup.splice(idx, 1);
+        }
+        if (plugin.afterSetup) {
+            const idx = registry.hooks.afterSetup.indexOf(plugin.afterSetup);
+            if (idx > -1)
+                registry.hooks.afterSetup.splice(idx, 1);
+        }
+        if (plugin.beforeConfigurator) {
+            const idx = registry.hooks.beforeConfigurator.indexOf(plugin.beforeConfigurator);
+            if (idx > -1)
+                registry.hooks.beforeConfigurator.splice(idx, 1);
+        }
+        if (plugin.afterConfigurator) {
+            const idx = registry.hooks.afterConfigurator.indexOf(plugin.afterConfigurator);
+            if (idx > -1)
+                registry.hooks.afterConfigurator.splice(idx, 1);
+        }
+        if (plugin.modifySelections) {
+            const idx = registry.hooks.modifySelections.indexOf(plugin.modifySelections);
+            if (idx > -1)
+                registry.hooks.modifySelections.splice(idx, 1);
+        }
+        registry.plugins.delete(name);
+    };
+    /**
+     * Get all registered plugins
+     */
+    const getPlugins = () => {
+        return Array.from(registry.plugins.values());
+    };
+    /**
+     * Get a plugin by name
+     */
+    const getPlugin = (name) => {
+        return registry.plugins.get(name);
+    };
+    /**
+     * Execute beforeSetup hooks
+     */
+    const executeBeforeSetup = async (ctx) => {
+        for (const hook of registry.hooks.beforeSetup) {
+            await hook(ctx);
+        }
+    };
+    /**
+     * Execute afterSetup hooks
+     */
+    const executeAfterSetup = async (ctx) => {
+        for (const hook of registry.hooks.afterSetup) {
+            await hook(ctx);
+        }
+    };
+    /**
+     * Execute beforeConfigurator hooks
+     */
+    const executeBeforeConfigurator = async (ctx, name) => {
+        for (const hook of registry.hooks.beforeConfigurator) {
+            await hook(ctx, name);
+        }
+    };
+    /**
+     * Execute afterConfigurator hooks
+     */
+    const executeAfterConfigurator = async (ctx, name) => {
+        for (const hook of registry.hooks.afterConfigurator) {
+            await hook(ctx, name);
+        }
+    };
+    /**
+     * Apply selection modifiers
+     */
+    const applyModifySelections = async (selections) => {
+        let result = selections;
+        for (const hook of registry.hooks.modifySelections) {
+            result = await hook(result);
+        }
+        return result;
+    };
+    return {
+        load,
+        register,
+        unregister,
+        getPlugins,
+        getPlugin,
+        executeBeforeSetup,
+        executeAfterSetup,
+        executeBeforeConfigurator,
+        executeAfterConfigurator,
+        applyModifySelections,
+    };
+};
+// ============================================
+// Default Plugin Manager Instance
+// ============================================
+/**
+ * Global plugin manager instance
+ */
+export const pluginManager = createPluginManager();
+// ============================================
+// Plugin Helpers
+// ============================================
+/**
+ * Define a plugin (helper for type safety)
+ *
+ * @example
+ * ```typescript
+ * export default definePlugin({
+ *   name: 'my-plugin',
+ *   version: '1.0.0',
+ *   beforeSetup: async (ctx) => {
+ *     console.log('Before setup!');
+ *   }
+ * });
+ * ```
+ */
+export const definePlugin = (plugin) => plugin;
+/**
+ * Load plugins from a list of sources
+ */
+export const loadPlugins = async (sources, manager = pluginManager) => {
+    const results = [];
+    for (const source of sources) {
+        const result = await manager.load(source);
+        results.push(result);
+        if (!result.success) {
+            console.warn(pc.yellow(`Warning: ${result.error}`));
+        }
+    }
+    return results;
+};
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

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