@motiadev/workbench 0.14.0-beta.165-285707 → 0.15.0-beta.165

package/dist/motia-plugin/hmr.js

@@ -1,100 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isConfigFile = isConfigFile;
-exports.shouldInvalidatePlugins = shouldInvalidatePlugins;
-exports.handlePluginHotUpdate = handlePluginHotUpdate;
-const path_1 = __importDefault(require("path"));
-const resolver_1 = require("./resolver");
-const types_1 = require("./types");
-const utils_1 = require("./utils");
-const WATCHED_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.css', '.scss', '.less'];
-function isConfigFile(file) {
-    const normalizedFile = (0, utils_1.normalizePath)(file);
-    return normalizedFile.endsWith('motia.config.ts') || normalizedFile.endsWith('motia.config.js');
-}
-/**
- * Checks if a file change should trigger HMR for plugins.
- *
- * @param file - The file path that changed
- * @param plugins - Current plugin configurations
- * @returns True if the change affects plugins
- */
-function shouldInvalidatePlugins(file, plugins) {
-    const normalizedFile = (0, utils_1.normalizePath)(file);
-    const absoluteFile = path_1.default.isAbsolute(normalizedFile) ? normalizedFile : path_1.default.resolve(process.cwd(), normalizedFile);
-    if (isConfigFile(file)) {
-        return true;
-    }
-    const hasWatchedExtension = WATCHED_EXTENSIONS.some((ext) => absoluteFile.endsWith(ext));
-    if (!hasWatchedExtension) {
-        return false;
-    }
-    for (const plugin of plugins) {
-        if ((0, utils_1.isLocalPlugin)(plugin.packageName)) {
-            const resolved = (0, resolver_1.resolvePluginPackage)(plugin);
-            const pluginAbsolutePath = path_1.default.isAbsolute(resolved.resolvedPath)
-                ? resolved.resolvedPath
-                : path_1.default.resolve(process.cwd(), resolved.resolvedPath);
-            const normalizedPluginPath = pluginAbsolutePath.endsWith(path_1.default.sep)
-                ? pluginAbsolutePath
-                : `${pluginAbsolutePath}${path_1.default.sep}`;
-            if (absoluteFile.startsWith(normalizedPluginPath) || absoluteFile === pluginAbsolutePath) {
-                return true;
-            }
-        }
-    }
-    return false;
-}
-/**
- * Handles hot updates for the plugin system.
- * This function is called by Vite's handleHotUpdate hook.
- *
- * @param ctx - Vite's HMR context
- * @param plugins - Current plugin configurations
- * @param printer - Printer instance for logging
- * @returns Array of modules to update, or undefined to continue with default behavior
- */
-function handlePluginHotUpdate(ctx, plugins, printer) {
-    const { file, server, timestamp } = ctx;
-    printer.printPluginLog(`HMR: File changed: ${(0, utils_1.normalizePath)(file)}`);
-    if (isConfigFile(file)) {
-        printer.printPluginLog('HMR: Config file changed, triggering full page reload');
-        printer.printPluginWarn('Configuration changes require a server restart for full effect. Please restart the dev server to apply all changes.');
-        server.ws.send({
-            type: 'full-reload',
-            path: '*',
-        });
-        return;
-    }
-    if (!shouldInvalidatePlugins(file, plugins)) {
-        printer.printPluginLog('HMR: Change outside plugin scope, delegating to Vite default handling');
-        return;
-    }
-    printer.printPluginLog('HMR: Plugin change detected, invalidating virtual module');
-    const virtualModule = server.moduleGraph.getModuleById(types_1.CONSTANTS.RESOLVED_VIRTUAL_MODULE_ID);
-    if (!virtualModule) {
-        printer.printPluginWarn('HMR: Virtual module not found, triggering full reload as fallback');
-        server.ws.send({
-            type: 'full-reload',
-            path: '*',
-        });
-        return;
-    }
-    server.moduleGraph.invalidateModule(virtualModule, new Set(), timestamp);
-    printer.printPluginLog('HMR: Virtual module invalidated');
-    const modulesToUpdateSet = new Set([virtualModule]);
-    const processedModules = new Set([virtualModule]);
-    for (const importer of virtualModule.importers) {
-        if (!processedModules.has(importer)) {
-            processedModules.add(importer);
-            modulesToUpdateSet.add(importer);
-            server.moduleGraph.invalidateModule(importer, new Set(), timestamp);
-        }
-    }
-    const modulesToUpdate = Array.from(modulesToUpdateSet);
-    printer.printPluginLog(`HMR: Updated ${modulesToUpdate.length} module(s)`);
-    return modulesToUpdate;
-}

package/dist/motia-plugin/index.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from 'vite';
-import type { WorkbenchPlugin } from './types';
-export default function motiaPluginsPlugin(plugins: WorkbenchPlugin[]): Plugin;

package/dist/motia-plugin/index.js

@@ -1,153 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = motiaPluginsPlugin;
-const core_1 = require("@motiadev/core");
-const path_1 = __importDefault(require("path"));
-const generator_1 = require("./generator");
-const hmr_1 = require("./hmr");
-const resolver_1 = require("./resolver");
-const types_1 = require("./types");
-const utils_1 = require("./utils");
-const validator_1 = require("./validator");
-/**
- * Vite plugin for loading and managing Motia workbench plugins.
- *
- * Features:
- * - Hot Module Replacement (HMR) support
- * - Runtime validation with detailed error messages
- * - Verbose logging for debugging
- * - CSS injection for plugin styles
- *
- * @param plugins - Array of plugin configurations
- * @param options - Optional loader configuration
- * @returns Vite plugin instance
- *
- * @example
- * ```ts
- * export default defineConfig({
- *   plugins: [
- *     motiaPluginsPlugin([
- *       { packageName: '@my-org/plugin', label: 'My Plugin' }
- *     ])
- *   ]
- * })
- * ```
- */
-const printer = new core_1.Printer(process.cwd());
-function motiaPluginsPlugin(plugins) {
-    let devServer = null;
-    try {
-        const validationResult = (0, validator_1.validatePlugins)(plugins, {
-            failFast: false,
-        });
-        if (!validationResult.valid) {
-            printer.printPluginError('Plugin configuration validation failed:');
-            for (const err of validationResult.errors) {
-                printer.printPluginError(`  ${err}`);
-            }
-            throw new Error('Invalid plugin configuration. See errors above.');
-        }
-        if (validationResult.warnings.length > 0) {
-            for (const warning of validationResult.warnings) {
-                printer.printPluginWarn(warning);
-            }
-        }
-    }
-    catch (error) {
-        printer.printPluginError(`Failed to validate plugins: ${error}`);
-        throw error;
-    }
-    const alias = (0, resolver_1.createAliasConfig)(plugins);
-    printer.printPluginLog(`Initialized with ${plugins.length} plugin(s)`);
-    return {
-        name: 'vite-plugin-motia-plugins',
-        enforce: 'pre',
-        buildStart() {
-            printer.printPluginLog('Build started');
-        },
-        config: () => ({
-            resolve: {
-                alias,
-            },
-        }),
-        configureServer(server) {
-            devServer = server;
-            printer.printPluginLog('Dev server configured, HMR enabled');
-            const configPaths = [path_1.default.join(process.cwd(), 'motia.config.ts'), path_1.default.join(process.cwd(), 'motia.config.js')];
-            for (const configPath of configPaths) {
-                server.watcher.add(configPath);
-            }
-            printer.printPluginLog('Watching for config file changes');
-            const localPlugins = plugins.filter((p) => (0, utils_1.isLocalPlugin)(p.packageName));
-            if (localPlugins.length > 0) {
-                printer.printPluginLog(`Watching ${localPlugins.length} local plugin(s)`);
-                for (const plugin of localPlugins) {
-                    const resolved = (0, resolver_1.resolvePluginPackage)(plugin);
-                    const watchPath = resolved.resolvedPath;
-                    server.watcher.add(watchPath);
-                    printer.printPluginLog(`Watching: ${watchPath}`);
-                }
-                server.watcher.on('change', (file) => {
-                    const normalizedFile = (0, utils_1.normalizePath)(file);
-                    printer.printPluginLog(`File watcher detected change: ${normalizedFile}`);
-                });
-                server.watcher.on('add', (file) => {
-                    const normalizedFile = (0, utils_1.normalizePath)(file);
-                    printer.printPluginLog(`File watcher detected new file: ${normalizedFile}`);
-                });
-            }
-        },
-        resolveId(id) {
-            if (id === types_1.CONSTANTS.VIRTUAL_MODULE_ID) {
-                return types_1.CONSTANTS.RESOLVED_VIRTUAL_MODULE_ID;
-            }
-        },
-        load(id) {
-            if (id !== types_1.CONSTANTS.RESOLVED_VIRTUAL_MODULE_ID) {
-                return null;
-            }
-            printer.printPluginLog('Loading plugins virtual module');
-            printer.printPluginLog('Generating plugin code...');
-            const code = (0, generator_1.generatePluginCode)(plugins);
-            if (!(0, generator_1.isValidCode)(code)) {
-                printer.printPluginError('Generated code is invalid or empty');
-                return 'export const plugins = []';
-            }
-            printer.printPluginLog('Plugin code generated successfully');
-            return code;
-        },
-        async transform(code, id) {
-            const normalizedId = (0, utils_1.normalizePath)(id);
-            if (!normalizedId.endsWith('src/index.css')) {
-                return null;
-            }
-            printer.printPluginLog('Injecting plugin CSS imports');
-            const cssImports = (0, generator_1.generateCssImports)(plugins);
-            if (!cssImports) {
-                return null;
-            }
-            return {
-                code: `${cssImports}\n${code}`,
-                map: null,
-            };
-        },
-        handleHotUpdate(ctx) {
-            if (!devServer) {
-                printer.printPluginWarn('HMR: Dev server not available');
-                return;
-            }
-            const modulesToUpdate = (0, hmr_1.handlePluginHotUpdate)(ctx, plugins, printer);
-            if (modulesToUpdate && modulesToUpdate.length > 0) {
-                const merged = Array.from(new Set([...(ctx.modules || []), ...modulesToUpdate]));
-                printer.printPluginLog(`HMR: Successfully updated ${merged.length} module(s)`);
-                return merged;
-            }
-        },
-        buildEnd() {
-            printer.printPluginLog('Build ended');
-        },
-    };
-}

package/dist/motia-plugin/resolver.js

@@ -1,92 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvePluginPackage = resolvePluginPackage;
-exports.createAliasConfig = createAliasConfig;
-exports.resolveAllPlugins = resolveAllPlugins;
-exports.getUniquePackageNames = getUniquePackageNames;
-const utils_1 = require("./utils");
-/**
- * Resolves a plugin package to its absolute path and creates an alias.
- *
- * @param plugin - The plugin configuration to resolve
- * @returns Resolved package information including path and alias
- *
- * @example
- * ```ts
- * // Local plugin
- * resolvePluginPackage({ packageName: '~/plugins/my-plugin' })
- * // Returns: {
- * //   packageName: '~/plugins/my-plugin',
- * //   resolvedPath: '/Users/project/plugins/my-plugin',
- * //   isLocal: true,
- * //   alias: '~/plugins/my-plugin'
- * // }
- *
- * // NPM package
- * resolvePluginPackage({ packageName: '@org/plugin' })
- * // Returns: {
- * //   packageName: '@org/plugin',
- * //   resolvedPath: '/Users/project/node_modules/@org/plugin',
- * //   isLocal: false,
- * //   alias: '@org/plugin'
- * // }
- * ```
- */
-function resolvePluginPackage(plugin) {
-    const { packageName } = plugin;
-    const local = (0, utils_1.isLocalPlugin)(packageName);
-    const resolvedPath = local ? (0, utils_1.resolveLocalPath)(packageName) : (0, utils_1.resolveNpmPath)(packageName);
-    return {
-        packageName,
-        resolvedPath: (0, utils_1.normalizePath)(resolvedPath),
-        isLocal: local,
-        alias: packageName,
-    };
-}
-/**
- * Resolves all plugin packages and creates a Vite alias configuration.
- *
- * @param plugins - Array of plugin configurations
- * @returns Vite alias configuration object
- *
- * @example
- * ```ts
- * const plugins = [
- *   { packageName: '~/plugins/local' },
- *   { packageName: '@org/npm-plugin' }
- * ]
- * const aliases = createAliasConfig(plugins)
- * // Returns: {
- * //   '~/plugins/local': '/Users/project/plugins/local',
- * //   '@org/npm-plugin': '/Users/project/node_modules/@org/npm-plugin'
- * // }
- * ```
- */
-function createAliasConfig(plugins) {
-    // Get unique package names to avoid duplicate aliases
-    const uniquePackages = Array.from(new Set(plugins.map((p) => p.packageName)));
-    const aliases = {};
-    for (const packageName of uniquePackages) {
-        const resolved = resolvePluginPackage({ packageName });
-        aliases[packageName] = resolved.resolvedPath;
-    }
-    return aliases;
-}
-/**
- * Resolves all plugins and returns their resolved package information.
- *
- * @param plugins - Array of plugin configurations
- * @returns Array of resolved package information
- */
-function resolveAllPlugins(plugins) {
-    return plugins.map((plugin) => resolvePluginPackage(plugin));
-}
-/**
- * Gets the unique set of package names from plugins.
- *
- * @param plugins - Array of plugin configurations
- * @returns Array of unique package names
- */
-function getUniquePackageNames(plugins) {
-    return Array.from(new Set(plugins.map((p) => p.packageName)));
-}

package/dist/motia-plugin/types.d.ts

@@ -1,169 +0,0 @@
-/**
- * Configuration for a single workbench plugin.
- * This interface defines how plugins are registered and configured in the Motia workbench.
- */
-export interface WorkbenchPlugin {
-    /**
-     * The package name or local path to the plugin.
-     * - For npm packages: use the package name (e.g., '@my-org/my-plugin')
-     * - For local plugins: use the tilde prefix (e.g., '~/plugins/my-plugin')
-     */
-    packageName: string;
-    /**
-     * Optional named export to use from the plugin package.
-     * If not specified, the default export will be used.
-     * Can be overridden by the plugin's own config.
-     */
-    componentName?: string;
-    /**
-     * Position where the plugin tab should appear in the workbench.
-     * - 'top': Display in the top tab bar
-     * - 'bottom': Display in the bottom tab bar
-     * @default 'top'
-     */
-    position?: 'top' | 'bottom';
-    /**
-     * Display label for the plugin tab.
-     * Can be overridden by the plugin's own config.
-     */
-    label?: string;
-    /**
-     * Icon name from lucide-react to display next to the label.
-     * Can be overridden by the plugin's own config.
-     * @default 'toy-brick'
-     */
-    labelIcon?: string;
-    /**
-     * Array of CSS package imports to inject into the workbench.
-     * These will be added to the main index.css file.
-     * Example: ['@my-org/my-plugin/styles.css']
-     */
-    cssImports?: string[];
-    /**
-     * Props to pass to the plugin component when it's rendered.
-     * Can be overridden by the plugin's own config.
-     */
-    props?: Record<string, any>;
-}
-/**
- * Result of validating a plugin configuration.
- */
-export interface ValidationResult {
-    /**
-     * Whether the validation passed
-     */
-    valid: boolean;
-    /**
-     * Array of error messages if validation failed
-     */
-    errors: string[];
-    /**
-     * Array of warning messages for non-critical issues
-     */
-    warnings: string[];
-    /**
-     * The validated and normalized plugin configuration (if valid)
-     */
-    plugin?: WorkbenchPlugin;
-}
-/**
- * Context object passed to various plugin internals functions.
- * Contains shared state and configuration.
- */
-export interface PluginContext {
-    /**
-     * Array of plugin configurations
-     */
-    plugins: WorkbenchPlugin[];
-    /**
-     * Vite dev server instance (only available in dev mode)
-     */
-    server?: any;
-}
-/**
- * Package resolution result.
- */
-export interface ResolvedPackage {
-    /**
-     * The original package name from the configuration
-     */
-    packageName: string;
-    /**
-     * Resolved absolute path to the package
-     */
-    resolvedPath: string;
-    /**
-     * Whether this is a local plugin (starts with ~/)
-     */
-    isLocal: boolean;
-    /**
-     * Alias to use for imports
-     */
-    alias: string;
-}
-/**
- * Generated virtual module exports interface.
- * This is what consumers will import from 'virtual:motia-plugins'.
- */
-export interface VirtualModuleExports {
-    /**
-     * Array of processed plugin configurations ready to be registered
-     */
-    plugins: ProcessedPlugin[];
-}
-/**
- * A plugin configuration after processing and normalization.
- * This is the format used by the workbench to register tabs.
- */
-export interface ProcessedPlugin {
-    /**
-     * Display label for the plugin tab
-     */
-    label: string;
-    /**
-     * Icon name from lucide-react
-     */
-    labelIcon: string;
-    /**
-     * Position in the workbench ('top' or 'bottom')
-     */
-    position: 'top' | 'bottom';
-    /**
-     * Props to pass to the component
-     */
-    props: Record<string, any>;
-    /**
-     * The React component to render
-     */
-    component: any;
-}
-/**
- * Type guard to check if position is valid.
- */
-export declare function isValidPosition(position: any): position is 'top' | 'bottom';
-/**
- * Constants used throughout the plugin system.
- */
-export declare const CONSTANTS: {
-    /**
-     * Virtual module ID for importing plugins
-     */
-    readonly VIRTUAL_MODULE_ID: "virtual:motia-plugins";
-    /**
-     * Resolved virtual module ID (with null byte prefix for Vite)
-     */
-    readonly RESOLVED_VIRTUAL_MODULE_ID: "\0virtual:motia-plugins";
-    /**
-     * Log prefix for all plugin messages
-     */
-    readonly LOG_PREFIX: "[motia-plugins]";
-    /**
-     * Default values for optional plugin fields
-     */
-    readonly DEFAULTS: {
-        readonly POSITION: "top";
-        readonly LABEL: "Plugin label";
-        readonly ICON: "toy-brick";
-        readonly PROPS: {};
-    };
-};

package/dist/motia-plugin/types.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONSTANTS = void 0;
-exports.isValidPosition = isValidPosition;
-/**
- * Type guard to check if position is valid.
- */
-function isValidPosition(position) {
-    return position === 'top' || position === 'bottom';
-}
-/**
- * Constants used throughout the plugin system.
- */
-exports.CONSTANTS = {
-    /**
-     * Virtual module ID for importing plugins
-     */
-    VIRTUAL_MODULE_ID: 'virtual:motia-plugins',
-    /**
-     * Resolved virtual module ID (with null byte prefix for Vite)
-     */
-    RESOLVED_VIRTUAL_MODULE_ID: '\0virtual:motia-plugins',
-    /**
-     * Log prefix for all plugin messages
-     */
-    LOG_PREFIX: '[motia-plugins]',
-    /**
-     * Default values for optional plugin fields
-     */
-    DEFAULTS: {
-        POSITION: 'top',
-        LABEL: 'Plugin label',
-        ICON: 'toy-brick',
-        PROPS: {},
-    },
-};

package/dist/motia-plugin/utils.js

@@ -1,75 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizePath = normalizePath;
-exports.isLocalPlugin = isLocalPlugin;
-exports.resolveLocalPath = resolveLocalPath;
-exports.resolveNpmPath = resolveNpmPath;
-const path_1 = __importDefault(require("path"));
-/**
- * Normalizes a file path by replacing backslashes with forward slashes.
- * This is useful for consistent path comparisons across different operating systems.
- *
- * @param filePath - The file path to normalize
- * @returns The normalized file path with forward slashes
- *
- * @example
- * ```ts
- * normalizePath('C:\\Users\\file.ts') // Returns: 'C:/Users/file.ts'
- * normalizePath('/Users/file.ts')     // Returns: '/Users/file.ts'
- * ```
- */
-function normalizePath(filePath) {
-    return filePath.replace(/\\/g, '/');
-}
-/**
- * Checks if a package name represents a local plugin (starts with ~/).
- *
- * @param packageName - The package name to check
- * @returns True if the package is a local plugin
- *
- * @example
- * ```ts
- * isLocalPlugin('~/plugins/my-plugin')     // Returns: true
- * isLocalPlugin('@my-org/my-plugin')       // Returns: false
- * isLocalPlugin('my-plugin')               // Returns: false
- * ```
- */
-function isLocalPlugin(packageName) {
-    return packageName.startsWith('~/');
-}
-/**
- * Resolves a local plugin path to an absolute path.
- * Strips the ~/ prefix and joins with the current working directory.
- *
- * @param packageName - The local plugin package name (must start with ~/)
- * @returns The absolute path to the local plugin
- *
- * @example
- * ```ts
- * // If cwd is /Users/project
- * resolveLocalPath('~/plugins/my-plugin')
- * // Returns: '/Users/project/plugins/my-plugin'
- * ```
- */
-function resolveLocalPath(packageName) {
-    return path_1.default.join(process.cwd(), packageName.replace('~/', ''));
-}
-/**
- * Resolves an npm package path to the node_modules directory.
- *
- * @param packageName - The npm package name
- * @returns The absolute path to the package in node_modules
- *
- * @example
- * ```ts
- * // If cwd is /Users/project
- * resolveNpmPath('@my-org/my-plugin')
- * // Returns: '/Users/project/node_modules/@my-org/my-plugin'
- * ```
- */
-function resolveNpmPath(packageName) {
-    return path_1.default.join(process.cwd(), 'node_modules', packageName);
-}

package/dist/motia-plugin/validator.d.ts

@@ -1,19 +0,0 @@
-import type { ValidationResult } from './types';
-/**
- * Validates a single plugin configuration.
- *
- * @param plugin - The plugin configuration to validate
- * @param index - The index of the plugin in the array (for error messages)
- * @returns A validation result with errors, warnings, and normalized plugin
- */
-export declare function validatePluginConfig(plugin: any, index: number): ValidationResult;
-/**
- * Validates an array of plugin configurations.
- *
- * @param plugins - Array of plugin configurations to validate
- * @param options - Validation options
- * @returns Combined validation result for all plugins
- */
-export declare function validatePlugins(plugins: any[], options?: {
-    failFast?: boolean;
-}): ValidationResult;