@pulse-editor/cli 0.1.1-beta.9 → 0.1.3

package/dist/lib/webpack/webpack.config.js

@@ -0,0 +1,527 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { ModuleFederationPlugin } from '@module-federation/enhanced/webpack';
+import MiniCssExtractPlugin from 'mini-css-extract-plugin';
+import HtmlWebpackPlugin from 'html-webpack-plugin';
+import { networkInterfaces } from 'os';
+import path from 'path';
+import { globSync } from 'glob';
+import fs from 'fs';
+import CopyWebpackPlugin from 'copy-webpack-plugin';
+import ts from 'typescript';
+import { pathToFileURL } from 'url';
+import mfNode from '@module-federation/node';
+const { NodeFederationPlugin } = mfNode;
+import wp from 'webpack';
+const { webpack } = wp;
+export async function createWebpackConfig(isPreview, buildTarget, mode) {
+    const projectDirName = process.cwd();
+    async function loadPulseConfig() {
+        // compile to js file and import
+        const program = ts.createProgram({
+            rootNames: [path.join(projectDirName, 'pulse.config.ts')],
+            options: {
+                module: ts.ModuleKind.ESNext,
+                target: ts.ScriptTarget.ES2020,
+                outDir: path.join(projectDirName, 'node_modules/.pulse/config'),
+                esModuleInterop: true,
+                skipLibCheck: true,
+                forceConsistentCasingInFileNames: true,
+            },
+        });
+        program.emit();
+        // Fix imports in the generated js file for all files in node_modules/.pulse/config
+        globSync('node_modules/.pulse/config/**/*.js', {
+            cwd: projectDirName,
+            absolute: true,
+        }).forEach(jsFile => {
+            let content = fs.readFileSync(jsFile, 'utf-8');
+            content = content.replace(/(from\s+["']\.\/[^\s"']+)(["'])/g, (match, p1, p2) => {
+                // No change if the import already has any extension
+                if (p1.match(/\.(js|cjs|mjs|ts|tsx|json)$/)) {
+                    return match; // No change needed
+                }
+                return `${p1}.js${p2}`;
+            });
+            fs.writeFileSync(jsFile, content);
+        });
+        // Copy package.json if exists
+        const pkgPath = path.join(projectDirName, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const destPath = path.join(projectDirName, 'node_modules/.pulse/config/package.json');
+            fs.copyFileSync(pkgPath, destPath);
+        }
+        const compiledConfig = path.join(projectDirName, 'node_modules/.pulse/config/pulse.config.js');
+        const mod = await import(pathToFileURL(compiledConfig).href);
+        // delete the compiled config after importing
+        fs.rmSync(path.join(projectDirName, 'node_modules/.pulse/config'), {
+            recursive: true,
+            force: true,
+        });
+        return mod.default;
+    }
+    const pulseConfig = await loadPulseConfig();
+    function getLocalNetworkIP() {
+        const interfaces = networkInterfaces();
+        for (const iface of Object.values(interfaces)) {
+            if (!iface)
+                continue;
+            for (const config of iface) {
+                if (config.family === 'IPv4' && !config.internal) {
+                    return config.address; // Returns the first non-internal IPv4 address
+                }
+            }
+        }
+        return 'localhost'; // Fallback
+    }
+    const origin = getLocalNetworkIP();
+    const previewStartupMessage = `
+🎉 Your Pulse extension preview \x1b[1m${pulseConfig.displayName}\x1b[0m is LIVE! 
+
+⚡️ Local: http://localhost:3030
+⚡️ Network: http://${origin}:3030
+
+✨ Try it out in your browser and let the magic happen! 🚀
+`;
+    const devStartupMessage = `
+🎉 Your Pulse extension \x1b[1m${pulseConfig.displayName}\x1b[0m is LIVE! 
+
+⚡️ Local: http://localhost:3030/${pulseConfig.id}/${pulseConfig.version}/
+⚡️ Network: http://${origin}:3030/${pulseConfig.id}/${pulseConfig.version}/
+
+✨ Try it out in the Pulse Editor and let the magic happen! 🚀
+`;
+    // #region Node Federation Plugin for Server Functions
+    function makeNodeFederationPlugin() {
+        function discoverServerFunctions() {
+            // Get all .ts files under src/server-function and read use default exports as entry points
+            const files = globSync('./src/server-function/**/*.ts');
+            const entryPoints = files
+                .map(file => file.replaceAll('\\', '/'))
+                .map(file => {
+                return {
+                    ['./' +
+                        file.replace('src/server-function/', '').replace(/\.ts$/, '')]: './' + file,
+                };
+            })
+                .reduce((acc, curr) => {
+                return { ...acc, ...curr };
+            }, {});
+            return entryPoints;
+        }
+        const funcs = discoverServerFunctions();
+        console.log(`Discovered server functions:
+${Object.entries(funcs)
+            .map(([name, file]) => {
+            return `  - ${name.slice(2)} (from ${file})`;
+        })
+            .join('\n')}
+`);
+        return new NodeFederationPlugin({
+            name: pulseConfig.id + '_server',
+            remoteType: 'script',
+            useRuntimePlugin: true,
+            library: { type: 'commonjs-module' },
+            filename: 'remoteEntry.js',
+            exposes: {
+                ...funcs,
+            },
+        }, {});
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function compileServerFunctions(compiler) {
+        // Remove existing entry points
+        try {
+            fs.rmSync('dist/server', { recursive: true, force: true });
+        }
+        catch (e) {
+            console.error('Error removing dist/server:', e);
+            console.log('Continuing...');
+        }
+        // Generate tsconfig for server functions
+        function generateTempTsConfig() {
+            const tempTsConfigPath = path.join(process.cwd(), 'node_modules/.pulse/tsconfig.server.json');
+            const tsConfig = {
+                compilerOptions: {
+                    target: 'ES2020',
+                    module: 'esnext',
+                    moduleResolution: 'bundler',
+                    strict: true,
+                    declaration: true,
+                    outDir: path.join(process.cwd(), 'dist'),
+                },
+                include: [
+                    path.join(process.cwd(), 'src/server-function/**/*'),
+                    path.join(process.cwd(), 'pulse.config.ts'),
+                    path.join(process.cwd(), 'global.d.ts'),
+                ],
+                exclude: [
+                    path.join(process.cwd(), 'node_modules'),
+                    path.join(process.cwd(), 'dist'),
+                ],
+            };
+            fs.writeFileSync(tempTsConfigPath, JSON.stringify(tsConfig, null, 2));
+        }
+        generateTempTsConfig();
+        // Run a new webpack compilation to pick up new server functions
+        const options = {
+            ...compiler.options,
+            watch: false,
+            plugins: [
+                // Add a new NodeFederationPlugin with updated entry points
+                makeNodeFederationPlugin(),
+            ],
+        };
+        const newCompiler = webpack(options);
+        // Run the new compiler
+        newCompiler?.run((err, stats) => {
+            if (err) {
+                console.error(`[Server] ❌ Error during recompilation:`, err);
+            }
+            else if (stats?.hasErrors()) {
+                console.error(`[Server] ❌ Compilation errors:`, stats.toJson().errors);
+            }
+            else {
+                console.log(`[Server] ✅ Compiled server functions successfully.`);
+            }
+        });
+    }
+    // #endregion
+    // #region Source file parser for Pulse Config plugin
+    class PulseConfigPlugin {
+        requireFS = false;
+        apply(compiler) {
+            compiler.hooks.beforeCompile.tap('PulseConfigPlugin', () => {
+                this.requireFS = false;
+                globSync(['src/**/*.tsx', 'src/**/*.ts']).forEach(file => {
+                    const source = fs.readFileSync(file, 'utf8');
+                    this.scanSource(source);
+                });
+                // Persist result
+                pulseConfig.requireWorkspace = this.requireFS;
+            });
+        }
+        isWorkspaceHook(node) {
+            return (ts.isCallExpression(node) &&
+                ts.isIdentifier(node.expression) &&
+                [
+                    'useFileSystem',
+                    'useFile',
+                    'useReceiveFile',
+                    'useTerminal',
+                    'useWorkspaceInfo',
+                ].includes(node.expression.text));
+        }
+        scanSource(sourceText) {
+            const sourceFile = ts.createSourceFile('temp.tsx', sourceText, ts.ScriptTarget.Latest, true);
+            const visit = (node) => {
+                // Detect: useFileSystem(...)
+                if (this.isWorkspaceHook(node)) {
+                    this.requireFS = true;
+                }
+                ts.forEachChild(node, visit);
+            };
+            visit(sourceFile);
+        }
+    }
+    // #endregion
+    // #region Webpack Configs
+    const previewClientConfig = {
+        mode: mode,
+        entry: {
+            main: './node_modules/.pulse/server/preview/frontend/index.js',
+        },
+        output: {
+            path: path.resolve(projectDirName, 'dist/client'),
+        },
+        resolve: {
+            extensions: ['.ts', '.tsx', '.js'],
+        },
+        plugins: [
+            new PulseConfigPlugin(),
+            new HtmlWebpackPlugin({
+                template: './node_modules/.pulse/server/preview/frontend/index.html',
+            }),
+            new MiniCssExtractPlugin({
+                filename: 'globals.css',
+            }),
+            new CopyWebpackPlugin({
+                patterns: [{ from: 'src/assets', to: 'assets' }],
+            }),
+            {
+                apply: compiler => {
+                    let isFirstRun = true;
+                    // Before build starts
+                    compiler.hooks.watchRun.tap('ReloadMessagePlugin', () => {
+                        if (!isFirstRun) {
+                            console.log('[client-preview] 🔄 Reloading app...');
+                        }
+                        else {
+                            console.log('[client-preview] 🔄 Building app...');
+                        }
+                    });
+                    // After build finishes
+                    compiler.hooks.done.tap('ReloadMessagePlugin', () => {
+                        if (isFirstRun) {
+                            console.log('[client-preview] ✅ Successfully built preview.');
+                            console.log(previewStartupMessage);
+                            isFirstRun = false;
+                        }
+                        else {
+                            console.log('[client-preview] ✅ Reload finished');
+                        }
+                        // Write pulse config to dist
+                        fs.writeFileSync(path.resolve(projectDirName, 'dist/client/pulse.config.json'), JSON.stringify(pulseConfig, null, 2));
+                        fs.writeFileSync(path.resolve(projectDirName, 'dist/server/pulse.config.json'), JSON.stringify(pulseConfig, null, 2));
+                    });
+                },
+            },
+        ],
+        watchOptions: {
+            ignored: /src\/server-function/,
+        },
+        module: {
+            rules: [
+                {
+                    test: /\.tsx?$/,
+                    use: 'ts-loader',
+                    exclude: [/node_modules/, /dist/],
+                },
+                {
+                    test: /\.css$/i,
+                    use: [
+                        MiniCssExtractPlugin.loader,
+                        'css-loader',
+                        {
+                            loader: 'postcss-loader',
+                        },
+                    ],
+                },
+            ],
+        },
+        stats: {
+            all: false,
+            errors: true,
+            warnings: true,
+            logging: 'warn',
+            colors: true,
+        },
+        infrastructureLogging: {
+            level: 'warn',
+        },
+    };
+    const mfClientConfig = {
+        mode: mode,
+        name: 'client',
+        entry: './src/main.tsx',
+        output: {
+            publicPath: 'auto',
+            path: path.resolve(projectDirName, 'dist/client'),
+        },
+        resolve: {
+            extensions: ['.ts', '.tsx', '.js'],
+        },
+        plugins: [
+            new PulseConfigPlugin(),
+            new MiniCssExtractPlugin({
+                filename: 'globals.css',
+            }),
+            // Copy assets to dist
+            new CopyWebpackPlugin({
+                patterns: [{ from: 'src/assets', to: 'assets' }],
+            }),
+            new ModuleFederationPlugin({
+                // Do not use hyphen character '-' in the name
+                name: pulseConfig.id,
+                filename: 'remoteEntry.js',
+                exposes: {
+                    './main': './src/main.tsx',
+                },
+                shared: {
+                    react: {
+                        requiredVersion: '19.2.0',
+                        import: 'react', // the "react" package will be used a provided and fallback module
+                        shareKey: 'react', // under this name the shared module will be placed in the share scope
+                        shareScope: 'default', // share scope with this name will be used
+                        singleton: true, // only a single version of the shared module is allowed
+                    },
+                    'react-dom': {
+                        requiredVersion: '19.2.0',
+                        singleton: true, // only a single version of the shared module is allowed
+                    },
+                },
+            }),
+            {
+                apply: compiler => {
+                    if (compiler.options.mode === 'development') {
+                        let isFirstRun = true;
+                        // Before build starts
+                        compiler.hooks.watchRun.tap('ReloadMessagePlugin', () => {
+                            if (!isFirstRun) {
+                                console.log('[client] 🔄 reloading app...');
+                            }
+                            else {
+                                console.log('[client] 🔄 building app...');
+                            }
+                        });
+                        // Log file updates
+                        compiler.hooks.invalid.tap('LogFileUpdates', (file, changeTime) => {
+                            console.log(`[watch] change detected in: ${file} at ${new Date(changeTime || Date.now()).toLocaleTimeString()}`);
+                        });
+                        // After build finishes
+                        compiler.hooks.done.tap('ReloadMessagePlugin', () => {
+                            if (isFirstRun) {
+                                console.log('[client] ✅ Successfully built client.');
+                                console.log(devStartupMessage);
+                                isFirstRun = false;
+                            }
+                            else {
+                                console.log('[client] ✅ Reload finished.');
+                            }
+                            // Write pulse config to dist
+                            fs.writeFileSync(path.resolve(projectDirName, 'dist/client/pulse.config.json'), JSON.stringify(pulseConfig, null, 2));
+                        });
+                    }
+                    else {
+                        // Print build success/failed message
+                        compiler.hooks.done.tap('BuildMessagePlugin', stats => {
+                            if (stats.hasErrors()) {
+                                console.log(`[client] ❌ Failed to build client.`);
+                            }
+                            else {
+                                console.log(`[client] ✅ Successfully built client.`);
+                                // Write pulse config to dist
+                                fs.writeFileSync(path.resolve(projectDirName, 'dist/client/pulse.config.json'), JSON.stringify(pulseConfig, null, 2));
+                            }
+                        });
+                    }
+                },
+            },
+        ],
+        module: {
+            rules: [
+                {
+                    test: /\.tsx?$/,
+                    use: 'ts-loader',
+                    exclude: [/node_modules/, /dist/],
+                },
+                {
+                    test: /\.css$/i,
+                    use: [
+                        MiniCssExtractPlugin.loader,
+                        'css-loader',
+                        {
+                            loader: 'postcss-loader',
+                        },
+                    ],
+                    exclude: [/dist/],
+                },
+            ],
+        },
+        stats: {
+            all: false,
+            errors: true,
+            warnings: true,
+            logging: 'warn',
+            colors: true,
+            assets: false,
+        },
+        infrastructureLogging: {
+            level: 'warn',
+        },
+    };
+    const mfServerConfig = {
+        mode: mode,
+        name: 'server',
+        entry: {},
+        target: 'async-node',
+        output: {
+            publicPath: 'auto',
+            path: path.resolve(projectDirName, 'dist/server'),
+        },
+        resolve: {
+            extensions: ['.ts', '.js'],
+        },
+        plugins: [
+            {
+                apply: compiler => {
+                    if (compiler.options.mode === 'development') {
+                        let isFirstRun = true;
+                        // Before build starts
+                        compiler.hooks.watchRun.tap('ReloadMessagePlugin', () => {
+                            if (!isFirstRun) {
+                                console.log(`[Server] 🔄 Reloading app...`);
+                            }
+                            else {
+                                console.log(`[Server] 🔄 Building app...`);
+                            }
+                            compileServerFunctions(compiler);
+                        });
+                        // After build finishes
+                        compiler.hooks.done.tap('ReloadMessagePlugin', () => {
+                            if (isFirstRun) {
+                                console.log(`[Server] ✅ Successfully built server.`);
+                                isFirstRun = false;
+                            }
+                            else {
+                                console.log(`[Server] ✅ Reload finished.`);
+                            }
+                        });
+                        // Watch for changes in the server-function directory to trigger rebuilds
+                        compiler.hooks.thisCompilation.tap('WatchServerFunctions', compilation => {
+                            compilation.contextDependencies.add(path.resolve(projectDirName, 'src/server-function'));
+                        });
+                    }
+                    else {
+                        // Print build success/failed message
+                        compiler.hooks.done.tap('BuildMessagePlugin', stats => {
+                            if (stats.hasErrors()) {
+                                console.log(`[Server] ❌ Failed to build server.`);
+                            }
+                            else {
+                                compileServerFunctions(compiler);
+                                console.log(`[Server] ✅ Successfully built server.`);
+                            }
+                        });
+                    }
+                },
+            },
+        ],
+        module: {
+            rules: [
+                {
+                    test: /\.tsx?$/,
+                    use: {
+                        loader: 'ts-loader',
+                        options: {
+                            configFile: 'node_modules/.pulse/tsconfig.server.json',
+                        },
+                    },
+                    exclude: [/node_modules/, /dist/],
+                },
+            ],
+        },
+        stats: {
+            all: false,
+            errors: true,
+            warnings: true,
+            logging: 'warn',
+            colors: true,
+        },
+        infrastructureLogging: {
+            level: 'warn',
+        },
+    };
+    // #endregion
+    if (isPreview) {
+        return [previewClientConfig, mfServerConfig];
+    }
+    else if (buildTarget === 'server') {
+        return [mfServerConfig];
+    }
+    else if (buildTarget === 'client') {
+        return [mfClientConfig];
+    }
+    else {
+        return [mfClientConfig, mfServerConfig];
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pulse-editor/cli",
-	"version": "0.1.1-beta.9",
+	"version": "0.1.3",
 	"license": "MIT",
 	"bin": {
 		"pulse": "dist/cli.js"
@@ -11,7 +11,7 @@
 	},
 	"scripts": {
 		"build": "tsx build.ts",
-		"dev": "tsx watch --include \"./source/**/*\" build.ts",
+		"dev": "tsx watch --include \"./src/**/*\" build.ts",
 		"test": "prettier --check . && xo && ava",
 		"link": "npm link"
 	},
@@ -19,48 +19,60 @@
 		"dist"
 	],
 	"dependencies": {
+		"@module-federation/enhanced": "2.0.1",
+		"@module-federation/node": "2.7.32",
+		"@module-federation/runtime": "2.0.1",
+		"@pulse-editor/shared-utils": "^0.1.1-beta.76",
 		"concurrently": "^9.2.1",
 		"connect-livereload": "^0.6.1",
-		"cors": "^2.8.5",
+		"copy-webpack-plugin": "^13.0.1",
+		"cors": "^2.8.6",
 		"cross-env": "^10.1.0",
-		"dotenv": "^17.2.3",
+		"dotenv": "^17.3.1",
 		"execa": "^9.6.1",
 		"express": "^5.2.1",
-		"ink": "^6.5.1",
+		"glob": "^13.0.6",
+		"html-webpack-plugin": "^5.6.6",
+		"ink": "^6.8.0",
 		"ink-select-input": "^6.2.0",
 		"ink-spinner": "^5.0.0",
 		"ink-text-input": "^6.0.0",
+		"jszip": "^3.10.1",
 		"livereload": "^0.10.3",
-		"meow": "^14.0.0",
-		"openid-client": "^6.8.1",
-		"react": "19.2.0",
-		"react-dom": "19.2.0",
-		"rimraf": "^6.1.2",
-		"tsx": "^4.21.0"
+		"meow": "^14.1.0",
+		"mini-css-extract-plugin": "^2.10.0",
+		"openid-client": "^6.8.2",
+		"rimraf": "^6.1.3",
+		"ts-morph": "^27.0.2",
+		"tsx": "^4.21.0",
+		"webpack": "^5.105.2",
+		"webpack-dev-server": "^5.2.3"
 	},
 	"devDependencies": {
-		"@module-federation/enhanced": "0.21.6",
-		"@module-federation/node": "2.7.25",
-		"@module-federation/runtime": "0.21.6",
 		"@sindresorhus/tsconfig": "^8.1.0",
 		"@types/connect-livereload": "^0.6.3",
 		"@types/cors": "^2.8.19",
 		"@types/express": "^5.0.6",
+		"@types/jszip": "^3.4.0",
 		"@types/livereload": "^0.9.5",
-		"@types/react": "^19.2.7",
+		"@types/react": "^19.2.14",
 		"@types/react-dom": "^19.2.3",
-		"@vdemedes/prettier-config": "^2.0.1",
 		"ava": "^6.4.1",
 		"chalk": "^5.6.2",
 		"eslint-config-xo-react": "^0.29.0",
 		"eslint-plugin-react": "^7.37.5",
 		"eslint-plugin-react-hooks": "^7.0.1",
 		"ink-testing-library": "^4.0.0",
-		"prettier": "^3.7.4",
+		"react": "19.2.4",
+		"react-dom": "19.2.4",
 		"ts-node": "^10.9.2",
 		"typescript": "^5.9.3",
 		"xo": "^1.2.3"
 	},
+	"peerDependencies": {
+		"react": "19.2.4",
+		"react-dom": "19.2.4"
+	},
 	"ava": {
 		"extensions": {
 			"ts": "module",
@@ -76,6 +88,5 @@
 		"rules": {
 			"react/prop-types": "off"
 		}
-	},
-	"prettier": "@vdemedes/prettier-config"
-}
+	}
+}

package/readme.md

@@ -1,10 +1,13 @@
 # Pulse CLI
+
 ## Install
+
 ```bash
 $ npm install --global @pulse-editor/cli
 ```
 
 ## Link local development version
+
 ```bash
 npm run link
 ```
@@ -48,6 +51,8 @@ npm run link
                       --visibility, -v [visibility]
                         The visibility of the new project. Options are private,
                         public, and unlisted.
+                      --path, -p [path]
+                        The path where to create the new project. Defaults to the name of the project in the current working directory.
 
     preview         Build the Pulse App in development mode and
                     start a preview server accessible via browser
@@ -75,6 +80,7 @@ npm run link
 ```
 
 ## Development
+
 ```
 npm run dev
-```
+```

package/dist/components/commands/preview copy.js

@@ -1,14 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { Text } from 'ink';
-import { useEffect } from 'react';
-import { execa } from 'execa';
-export default function Preview({ cli }) {
-    useEffect(() => {
-        // Start dev server
-        execa('npm run preview', {
-            stdio: 'inherit',
-            shell: true,
-        });
-    }, []);
-    return (_jsx(_Fragment, { children: _jsx(Text, { children: "Starting preview server..." }) }));
-}

package/dist/components/commands/start copy.js

@@ -1,14 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
-import { Text } from 'ink';
-import { useEffect } from 'react';
-import { execa } from 'execa';
-export default function Start({ cli }) {
-    useEffect(() => {
-        // Start dev server
-        execa('npm run start', {
-            stdio: 'inherit',
-            shell: true,
-        });
-    }, []);
-    return (_jsx(_Fragment, { children: _jsx(Text, { children: "Starting prod server..." }) }));
-}