@mediaproc/cli 0.8.4 → 1.0.0

package/dist/utils/package-manager.d.ts

@@ -0,0 +1,37 @@
+export type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'deno';
+/**
+ * Detect available package managers
+ * Checks in preferred order: pnpm > bun > yarn > npm > deno
+ * @returns Detected package manager, defaults to 'npm' if none found
+ */
+export declare function detectPackageManager(): Promise<PackageManager>;
+/**
+ * Check if CLI is running from a global installation
+ */
+export declare function isGlobalInstall(): Promise<boolean>;
+/**
+ * Check if a plugin is installed globally
+ * @param pluginName - Full plugin package name
+ * @returns true if plugin is installed globally, false otherwise
+ */
+export declare function isPluginGlobal(pluginName: string): Promise<boolean>;
+/**
+ * Build package manager installation arguments
+ * @param packageManager - The package manager to use
+ * @param pluginNames - Plugin name(s) to install (string or array)
+ * @param options - Installation options
+ */
+export declare function buildInstallArgs(packageManager: PackageManager, pluginNames: string | string[], options?: {
+    global?: boolean;
+    saveDev?: boolean;
+}): string[];
+/**
+ * Build package manager uninstall arguments
+ * @param packageManager - The package manager to use
+ * @param pluginNames - Plugin name(s) to uninstall (string or array)
+ * @param options - Uninstallation options
+ */
+export declare function buildUninstallArgs(packageManager: PackageManager, pluginNames: string | string[], options?: {
+    global?: boolean;
+}): string[];
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtE;;;;GAIG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CAwBpE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAqBxD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqDzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,MAAM,EAAE,CAkCV;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,MAAM,EAAE,CA8BV"}

package/dist/utils/package-manager.js

@@ -0,0 +1,195 @@
+import { execa } from 'execa';
+/**
+ * Detect available package managers
+ * Checks in preferred order: pnpm > bun > yarn > npm > deno
+ * @returns Detected package manager, defaults to 'npm' if none found
+ */
+export async function detectPackageManager() {
+    const managers = ['pnpm', 'bun', 'yarn', 'npm', 'deno'];
+    for (const manager of managers) {
+        try {
+            // Set timeout to avoid hanging on slow systems
+            const { stdout } = await execa(manager, ['--version'], {
+                stdio: 'pipe',
+                timeout: 5000,
+                reject: false
+            });
+            // Verify we got valid output
+            if (stdout && stdout.trim()) {
+                return manager;
+            }
+        }
+        catch (error) {
+            // Continue to next manager if this one fails
+            continue;
+        }
+    }
+    // Always fallback to npm (should be available on most systems)
+    return 'npm';
+}
+/**
+ * Check if CLI is running from a global installation
+ */
+export async function isGlobalInstall() {
+    const execPath = process.argv[1];
+    // Check common global paths
+    const globalPaths = [
+        '/usr/local',
+        '/usr/lib',
+        '/.nvm/',
+        '/.npm-global/',
+        '/.npm/',
+        '/AppData/Roaming/npm',
+        '/pnpm-global/',
+        '/.bun/install/global',
+        '/.yarn/global'
+    ];
+    if (globalPaths.some(p => execPath.includes(p))) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if a plugin is installed globally
+ * @param pluginName - Full plugin package name
+ * @returns true if plugin is installed globally, false otherwise
+ */
+export async function isPluginGlobal(pluginName) {
+    if (!pluginName || typeof pluginName !== 'string') {
+        return false;
+    }
+    const trimmed = pluginName.trim();
+    if (!trimmed) {
+        return false;
+    }
+    // Try npm list -g
+    try {
+        const { stdout } = await execa('npm', ['list', '-g', '--depth=0', trimmed], {
+            stdio: 'pipe',
+            reject: false,
+            timeout: 10000
+        });
+        if (stdout && stdout.includes(trimmed)) {
+            return true;
+        }
+    }
+    catch {
+        // Continue to next check
+    }
+    // Try pnpm list -g
+    try {
+        const { stdout } = await execa('pnpm', ['list', '-g', '--depth=0', trimmed], {
+            stdio: 'pipe',
+            reject: false,
+            timeout: 10000
+        });
+        if (stdout && stdout.includes(trimmed)) {
+            return true;
+        }
+    }
+    catch {
+        // Continue to next check
+    }
+    // Try yarn global list
+    try {
+        const { stdout } = await execa('yarn', ['global', 'list'], {
+            stdio: 'pipe',
+            reject: false,
+            timeout: 10000
+        });
+        if (stdout && stdout.includes(trimmed)) {
+            return true;
+        }
+    }
+    catch {
+        // All checks failed
+    }
+    return false;
+}
+/**
+ * Build package manager installation arguments
+ * @param packageManager - The package manager to use
+ * @param pluginNames - Plugin name(s) to install (string or array)
+ * @param options - Installation options
+ */
+export function buildInstallArgs(packageManager, pluginNames, options = {}) {
+    const args = [];
+    const names = Array.isArray(pluginNames) ? pluginNames : [pluginNames];
+    switch (packageManager) {
+        case 'pnpm':
+            args.push('add');
+            if (options.global)
+                args.push('-g');
+            else if (options.saveDev)
+                args.push('-D');
+            break;
+        case 'bun':
+            args.push('add');
+            if (options.global)
+                args.push('-g');
+            else if (options.saveDev)
+                args.push('-d');
+            break;
+        case 'yarn':
+            if (options.global) {
+                args.push('global', 'add');
+            }
+            else {
+                args.push('add');
+                if (options.saveDev)
+                    args.push('--dev');
+            }
+            break;
+        case 'deno':
+            // Deno doesn't need traditional installation
+            return [];
+        default: // npm
+            args.push('install');
+            if (options.global)
+                args.push('-g');
+            else if (options.saveDev)
+                args.push('--save-dev');
+    }
+    args.push(...names);
+    return args;
+}
+/**
+ * Build package manager uninstall arguments
+ * @param packageManager - The package manager to use
+ * @param pluginNames - Plugin name(s) to uninstall (string or array)
+ * @param options - Uninstallation options
+ */
+export function buildUninstallArgs(packageManager, pluginNames, options = {}) {
+    const args = [];
+    const names = Array.isArray(pluginNames) ? pluginNames : [pluginNames];
+    switch (packageManager) {
+        case 'pnpm':
+            args.push('remove');
+            if (options.global)
+                args.push('-g');
+            break;
+        case 'yarn':
+            if (options.global) {
+                args.push('global', 'remove');
+            }
+            else {
+                args.push('remove');
+            }
+            break;
+        case 'bun':
+            args.push('remove');
+            if (options.global)
+                args.push('-g');
+            break;
+        case 'deno':
+            // Deno doesn't have traditional uninstall
+            return [];
+        default: // npm
+            args.push('uninstall');
+            if (options.global)
+                args.push('-g');
+    }
+    args.push(...names);
+    return args;
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/utils/package-manager.js.map

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

package/dist/utils/plugin-helpers.d.ts

@@ -0,0 +1,39 @@
+import type { Command } from 'commander';
+import type { PluginManager } from './plugins/manager.js';
+/**
+ * Verify plugin is installed and can be imported
+ * @param pluginName - Full plugin package name
+ * @param isGlobal - Optional flag to check global installation
+ */
+export declare function verifyPluginInstallation(pluginName: string, isGlobal?: boolean): Promise<boolean>;
+/**
+ * Load plugin with error handling
+ * @param pluginName - Full plugin package name
+ * @param program - Commander program instance
+ * @param pluginManager - Plugin manager instance
+ */
+export declare function loadPluginSafe(pluginName: string, program: Command, pluginManager: PluginManager): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Check if plugin is already loaded
+ */
+export declare function isPluginLoaded(pluginName: string, pluginManager: PluginManager): boolean;
+/**
+ * Format plugin name for display (remove @mediaproc/ prefix)
+ */
+export declare function formatPluginName(pluginName: string): string;
+/**
+ * Resolve plugin command name (e.g., 'image' from '@mediaproc/image')
+ */
+export declare function getPluginCommand(pluginName: string): string;
+/**
+ * Validate plugin name format
+ */
+export declare function isValidPluginName(pluginName: string): boolean;
+/**
+ * Get plugin examples by package name
+ */
+export declare function getPluginExamples(packageName: string): string[];
+//# sourceMappingURL=plugin-helpers.d.ts.map

package/dist/utils/plugin-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAExF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAW7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA0D/D"}

package/dist/utils/plugin-helpers.js

@@ -0,0 +1,156 @@
+/**
+ * Verify plugin is installed and can be imported
+ * @param pluginName - Full plugin package name
+ * @param isGlobal - Optional flag to check global installation
+ */
+export async function verifyPluginInstallation(pluginName, isGlobal) {
+    try {
+        // Try importing the plugin
+        await import(pluginName);
+        return true;
+    }
+    catch (importError) {
+        // If import fails and we're checking global, verify via package manager
+        if (isGlobal !== undefined) {
+            try {
+                const { execa } = await import('execa');
+                const { stdout } = await execa('npm', ['list', '-g', '--depth=0', pluginName], {
+                    stdio: 'pipe',
+                    reject: false
+                });
+                return stdout.includes(pluginName);
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+}
+/**
+ * Load plugin with error handling
+ * @param pluginName - Full plugin package name
+ * @param program - Commander program instance
+ * @param pluginManager - Plugin manager instance
+ */
+export async function loadPluginSafe(pluginName, program, pluginManager) {
+    try {
+        // Check if already loaded
+        if (pluginManager.getPlugin(pluginName)) {
+            return { success: true };
+        }
+        // Attempt to load
+        await pluginManager.loadPlugin(pluginName, program);
+        return { success: true };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Check if it's a "module not found" error
+        if (errorMessage.includes('Cannot find module') || errorMessage.includes('MODULE_NOT_FOUND')) {
+            return {
+                success: false,
+                error: 'Plugin not installed. Please install it first.'
+            };
+        }
+        // Return the actual error
+        return { success: false, error: errorMessage };
+    }
+}
+/**
+ * Check if plugin is already loaded
+ */
+export function isPluginLoaded(pluginName, pluginManager) {
+    return pluginManager.getPlugin(pluginName) !== undefined;
+}
+/**
+ * Format plugin name for display (remove @mediaproc/ prefix)
+ */
+export function formatPluginName(pluginName) {
+    return pluginName.replace('@mediaproc/', '').replace('mediaproc-', '');
+}
+/**
+ * Resolve plugin command name (e.g., 'image' from '@mediaproc/image')
+ */
+export function getPluginCommand(pluginName) {
+    if (pluginName.startsWith('@mediaproc/')) {
+        return pluginName.replace('@mediaproc/', '');
+    }
+    if (pluginName.startsWith('mediaproc-')) {
+        return pluginName.replace('mediaproc-', '');
+    }
+    return pluginName;
+}
+/**
+ * Validate plugin name format
+ */
+export function isValidPluginName(pluginName) {
+    // Must be scoped (@mediaproc/), community (mediaproc-), or valid npm package name
+    const scopedRegex = /^@[\w-]+\/[\w-]+$/;
+    const communityRegex = /^mediaproc-[\w-]+$/;
+    const npmRegex = /^[\w-]+$/;
+    return (scopedRegex.test(pluginName) ||
+        communityRegex.test(pluginName) ||
+        npmRegex.test(pluginName));
+}
+/**
+ * Get plugin examples by package name
+ */
+export function getPluginExamples(packageName) {
+    const examples = {
+        '@mediaproc/image': [
+            'resize photo.jpg -w 800',
+            'convert image.png --format webp',
+            'grayscale photo.jpg',
+            'compress image.png --quality 80'
+        ],
+        '@mediaproc/video': [
+            'compress movie.mp4 --quality high',
+            'transcode video.avi --format mp4',
+            'trim video.mp4 -s 00:00:10 -e 00:01:00',
+            'resize video.mp4 -s 720p'
+        ],
+        '@mediaproc/audio': [
+            'convert song.wav --format mp3',
+            'normalize audio.mp3',
+            'trim music.mp3 -s 30 -d 60',
+            'extract video.mp4 --format flac'
+        ],
+        '@mediaproc/document': [
+            'compress report.pdf --quality ebook',
+            'ocr scanned.pdf',
+            'convert document.docx --format pdf'
+        ],
+        '@mediaproc/animation': [
+            'gifify video.mp4 --fps 15',
+            'optimize animation.gif',
+            'convert video.mp4 --format webp'
+        ],
+        '@mediaproc/3d': [
+            'optimize model.glb',
+            'compress textures/',
+            'convert model.obj --format glb'
+        ],
+        '@mediaproc/metadata': [
+            'inspect video.mp4',
+            'strip-metadata image.jpg',
+            'extract audio.mp3'
+        ],
+        '@mediaproc/stream': [
+            'pack video.mp4 --hls',
+            'encrypt video.mp4 --drm',
+            'manifest playlist.m3u8'
+        ],
+        '@mediaproc/ai': [
+            'blur-faces video.mp4',
+            'caption audio.wav',
+            'detect-scenes video.mp4'
+        ],
+        '@mediaproc/pipeline': [
+            'run workflow.yaml',
+            'validate pipeline.yaml',
+            'execute batch-process.yaml'
+        ]
+    };
+    return examples[packageName] || [];
+}
+//# sourceMappingURL=plugin-helpers.js.map

package/dist/utils/plugin-helpers.js.map

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

package/dist/utils/plugins/api.d.ts

@@ -0,0 +1,106 @@
+import type { Command } from 'commander';
+/**
+ * Plugin API for mediaproc
+ *
+ * All plugins must export a `register` function that takes a Commander program
+ * and registers their commands.
+ *
+ * @example
+ * ```ts
+ * import type { Command } from 'commander';
+ *
+ * export const name = '@mediaproc/plugin-name';
+ * export const version = '1.0.0';
+ *
+ * export function register(program: Command): void {
+ *   const pluginCmd = program
+ *     .command('plugin')
+ *     .description('plugin description')
+ *     .version(version, '-v, --version', 'Output the plugin version')
+ *     .helpOption('-h, --help', 'Display help for plugin');
+ *
+ *   pluginCmd
+ *     .command('subcommand <parameters>')
+ *     .option('--flags', 'Flag description')
+ *     .action(async (input, options) => {
+ *        // Implementation
+ *     });
+ * }
+ * ```
+ */
+export interface PluginAPI {
+    /**
+     * Plugin name (should match package name)
+     * - Official: @mediaproc/plugin-name
+     * - Community: mediaproc-plugin-name
+     * - Third-party: any valid npm package name
+     */
+    name: string;
+    /**
+     * Plugin version (semver format)
+     */
+    version: string;
+    /**
+     * Register commands with the CLI
+     * This function is called when the plugin is loaded
+     */
+    register(program: Command): void | Promise<void>;
+    /**
+     * Optional: Indicates if this is a built-in/bundled plugin
+     */
+    isBuiltIn?: boolean;
+    /**
+     * Optional: Plugin description
+     */
+    description?: string;
+    /**
+     * Optional: Plugin author
+     */
+    author?: string;
+    /**
+     * Optional: System requirements (e.g., FFmpeg, Sharp)
+     */
+    systemRequirements?: string[];
+}
+/**
+ * Plugin metadata structure
+ */
+export interface PluginMetadata {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+}
+/**
+ * Plugin load result
+ */
+export interface PluginLoadResult {
+    success: boolean;
+    plugin?: PluginAPI;
+    error?: string;
+}
+/**
+ * Plugin type enum
+ */
+export declare enum PluginType {
+    OFFICIAL = "official",
+    COMMUNITY = "community",
+    THIRD_PARTY = "third-party"
+}
+/**
+ * Plugin status
+ */
+export declare enum PluginStatus {
+    LOADED = "loaded",
+    NOT_INSTALLED = "not-installed",
+    LOADING = "loading",
+    ERROR = "error"
+}
+export type { Command };
+//# sourceMappingURL=api.d.ts.map

package/dist/utils/plugins/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/utils/plugins/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,YAAY,EAAE,OAAO,EAAE,CAAC"}

package/dist/utils/plugins/api.js

@@ -0,0 +1,20 @@
+/**
+ * Plugin type enum
+ */
+export var PluginType;
+(function (PluginType) {
+    PluginType["OFFICIAL"] = "official";
+    PluginType["COMMUNITY"] = "community";
+    PluginType["THIRD_PARTY"] = "third-party";
+})(PluginType || (PluginType = {}));
+/**
+ * Plugin status
+ */
+export var PluginStatus;
+(function (PluginStatus) {
+    PluginStatus["LOADED"] = "loaded";
+    PluginStatus["NOT_INSTALLED"] = "not-installed";
+    PluginStatus["LOADING"] = "loading";
+    PluginStatus["ERROR"] = "error";
+})(PluginStatus || (PluginStatus = {}));
+//# sourceMappingURL=api.js.map

package/dist/utils/plugins/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/utils/plugins/api.ts"],"names":[],"mappings":"AAkGA;;GAEG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,mCAAqB,CAAA;IACrB,qCAAuB,CAAA;IACvB,yCAA2B,CAAA;AAC7B,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,+CAA+B,CAAA;IAC/B,mCAAmB,CAAA;IACnB,+BAAe,CAAA;AACjB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB"}

package/dist/utils/plugins/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api.js';
+export { PluginManager, pluginManager, getPluginNameForCommand } from './manager.js';
+export { resolvePluginPackage, detectPluginType, getPluginsByCategory, getAllPlugins, searchPlugins, getPluginEntry, isValidPlugin, getPluginCategory, PLUGIN_REGISTRY, type PluginRegistryEntry } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/plugins/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGrF,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAC"}

package/dist/utils/plugins/index.js

@@ -0,0 +1,7 @@
+// Plugin API types and interfaces
+export * from './api.js';
+// Plugin Manager
+export { PluginManager, pluginManager, getPluginNameForCommand } from './manager.js';
+// Plugin Registry
+export { resolvePluginPackage, detectPluginType, getPluginsByCategory, getAllPlugins, searchPlugins, getPluginEntry, isValidPlugin, getPluginCategory, PLUGIN_REGISTRY } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/plugins/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,cAAc,UAAU,CAAC;AAEzB,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAErF,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EAEhB,MAAM,eAAe,CAAC"}