@bobfrankston/npmglobalize 1.0.79 → 1.0.81

package/cli.js

@@ -2,44 +2,13 @@
 /**
  * npmglobalize CLI - Transform file: dependencies to npm versions for publishing
  */
-import { globalize, globalizeWorkspace, readConfig, readPackageJson, writePackageJson } from './lib.js';
+import { globalize, globalizeWorkspace, readConfig, readPackageJson, writeConfig, writePackageJson } from './lib.js';
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import { styleText } from 'util';
 import JSON5 from 'json5';
-// Check if JS files are up-to-date with TS files
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Check all .ts files in the directory
-const tsFiles = ['lib.ts', 'cli.ts', 'index.ts'];
-const outOfSync = [];
-for (const tsFile of tsFiles) {
-    const tsPath = path.join(__dirname, tsFile);
-    const jsPath = path.join(__dirname, tsFile.replace('.ts', '.js'));
-    if (fs.existsSync(tsPath) && fs.existsSync(jsPath)) {
-        const tsStat = fs.statSync(tsPath);
-        const jsStat = fs.statSync(jsPath);
-        if (jsStat.mtime < tsStat.mtime) {
-            outOfSync.push(tsFile);
-        }
-    }
-}
-if (outOfSync.length > 0 && !process.argv.includes('--force')) {
-    console.error('\n' + styleText('red', '❌ Build check failed:'));
-    console.error(styleText('red', `   ${outOfSync.length} file(s) need compilation in ${__dirname}:`));
-    outOfSync.forEach(f => {
-        const tsPath = path.join(__dirname, f);
-        const jsPath = path.join(__dirname, f.replace('.ts', '.js'));
-        const tsMtime = fs.statSync(tsPath).mtime;
-        const jsMtime = fs.statSync(jsPath).mtime;
-        const fmt = (d) => d.toLocaleString();
-        console.error(styleText('red', `     - ${tsPath}`));
-        console.error(styleText('red', `       .ts: ${fmt(tsMtime)}  .js: ${fmt(jsMtime)}`));
-    });
-    console.error('\n' + styleText('yellow', '   Please run: tsc'));
-    console.error(styleText('yellow', '   Or use --force to skip this check') + '\n');
-    process.exit(1);
-}
+// npmglobalize install directory (for --version)
+const __dirname = import.meta.dirname;
 function printHelp() {
     console.log(`
 npmglobalize - Transform file: dependencies to npm versions for publishing
@@ -65,8 +34,10 @@ Dependency Options:
   --fix                     Run npm audit fix after transformation
 
 Install Options:
-  --install, -i    Global install after publish (Windows)
+  --install, -i    Global install after publish (from registry)
+  --link           Global install via symlink (npm install -g .)
   --wsl            Also install globally in WSL
+  --once           Don't persist flags to .globalize.json5
 
 Mode Options:
   --files         Keep file: paths after publish (default)
@@ -108,7 +79,8 @@ Examples:
   npmglobalize -npd                  Skip auto-publishing file: deps (use with caution)
   npmglobalize --force-publish       Force republish all file: dependencies
   npmglobalize --fix                 Fix security vulnerabilities
-  npmglobalize --install --wsl       Release + install on Windows and WSL
+  npmglobalize --install --wsl       Release + install on Windows and WSL (from registry)
+  npmglobalize --link --wsl          Release + link on Windows and WSL (symlink)
   npmglobalize -np                   Just transform, no publish
   npmglobalize --cleanup             Restore original dependencies
   npmglobalize --init                Initialize new git repo + release
@@ -126,7 +98,8 @@ function parseArgs(args) {
     const options = {
         help: false,
         version: false,
-        error: ''
+        error: '',
+        explicitKeys: new Set()
     };
     const unrecognized = [];
     const positional = [];
@@ -161,25 +134,35 @@ function parseArgs(args) {
             case '--install':
             case '-i':
                 options.install = true;
+                options.explicitKeys.add('install');
                 break;
             case '--noinstall':
             case '-ni':
                 options.install = false;
+                options.explicitKeys.add('install');
+                break;
+            case '--link':
+                options.link = true;
+                options.explicitKeys.add('link');
                 break;
             case '--wsl':
                 options.wsl = true;
+                options.explicitKeys.add('wsl');
                 break;
             case '--nowsl':
                 options.wsl = false;
+                options.explicitKeys.add('wsl');
                 break;
             case '--force':
                 options.force = true;
                 break;
             case '--files':
                 options.files = true;
+                options.explicitKeys.add('files');
                 break;
             case '--nofiles':
                 options.files = false;
+                options.explicitKeys.add('files');
                 break;
             case '--dry-run':
                 options.dryRun = true;
@@ -198,6 +181,7 @@ function parseArgs(args) {
                 i++;
                 if (args[i] === 'private' || args[i] === 'public') {
                     options.gitVisibility = args[i];
+                    options.explicitKeys.add('gitVisibility');
                 }
                 else {
                     options.error = `--git requires 'private' or 'public', got: ${args[i]}`;
@@ -207,6 +191,7 @@ function parseArgs(args) {
                 i++;
                 if (args[i] === 'private' || args[i] === 'public') {
                     options.npmVisibility = args[i];
+                    options.explicitKeys.add('npmVisibility');
                 }
                 else {
                     options.error = `--npm requires 'private' or 'public', got: ${args[i]}`;
@@ -257,9 +242,11 @@ function parseArgs(args) {
                 break;
             case '--fix':
                 options.fix = true;
+                options.explicitKeys.add('fix');
                 break;
             case '--no-fix':
                 options.fix = false;
+                options.explicitKeys.add('fix');
                 break;
             case '--workspace':
             case '-w':
@@ -283,6 +270,9 @@ function parseArgs(args) {
             case '-pkg':
                 options.package = true;
                 break;
+            case '--once':
+                options.once = true;
+                break;
             default:
                 if (arg.startsWith('-')) {
                     unrecognized.push(arg);
@@ -312,52 +302,11 @@ export async function main() {
         process.exit(0);
     }
     if (cliOptions.version) {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = path.dirname(__filename);
         const pkgPath = path.join(__dirname, 'package.json');
         const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
         console.log(pkg.version);
         process.exit(0);
     }
-    // Check if TypeScript files are compiled (unless --force or --help/--version)
-    if (!cliOptions.force && !cliOptions.help && !cliOptions.version) {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = path.dirname(__filename);
-        // Check for noEmit in tsconfig.json
-        let noEmit = false;
-        try {
-            const tsconfigPath = path.join(__dirname, 'tsconfig.json');
-            const content = fs.readFileSync(tsconfigPath, 'utf-8');
-            const tsconfig = JSON5.parse(content);
-            noEmit = tsconfig.compilerOptions?.noEmit === true;
-        }
-        catch (error) {
-            // If we can't read tsconfig, assume we need to check
-        }
-        if (!noEmit) {
-            // Check if this .js file is older than its .ts source
-            const jsFile = __filename;
-            const tsFile = jsFile.replace(/\.js$/, '.ts');
-            if (fs.existsSync(tsFile)) {
-                if (!fs.existsSync(jsFile)) {
-                    console.error('\n❌ Error: TypeScript files not compiled');
-                    console.error(`Missing: ${path.basename(jsFile)}`);
-                    console.error('\nPlease run: npm run build');
-                    console.error('Or use --force to skip this check\n');
-                    process.exit(1);
-                }
-                const tsStat = fs.statSync(tsFile);
-                const jsStat = fs.statSync(jsFile);
-                if (jsStat.mtime < tsStat.mtime) {
-                    console.error('\n❌ Error: TypeScript files not compiled');
-                    console.error(`${path.basename(jsFile)} is older than ${path.basename(tsFile)}`);
-                    console.error('\nPlease run: npm run build');
-                    console.error('Or use --force to skip this check\n');
-                    process.exit(1);
-                }
-            }
-        }
-    }
     if (cliOptions.error) {
         console.error(`Error: ${cliOptions.error}`);
         console.error('Run with --help for usage.');
@@ -376,6 +325,50 @@ export async function main() {
             process.exit(1);
         }
     }
+    // Check if TypeScript files in target project are compiled
+    if (!cliOptions.force) {
+        let noEmit = false;
+        try {
+            const tsconfigPath = path.join(cwd, 'tsconfig.json');
+            const content = fs.readFileSync(tsconfigPath, 'utf-8');
+            const tsconfig = JSON5.parse(content);
+            noEmit = tsconfig.compilerOptions?.noEmit === true;
+        }
+        catch (error) {
+            // No tsconfig or can't parse — skip check
+            noEmit = true;
+        }
+        if (!noEmit) {
+            const outOfSync = [];
+            const jsFiles = fs.readdirSync(cwd).filter(f => f.endsWith('.js') && !f.endsWith('.min.js'));
+            for (const jsFile of jsFiles) {
+                const tsFile = jsFile.replace(/\.js$/, '.ts');
+                const tsPath = path.join(cwd, tsFile);
+                const jsPath = path.join(cwd, jsFile);
+                if (fs.existsSync(tsPath)) {
+                    const tsStat = fs.statSync(tsPath);
+                    const jsStat = fs.statSync(jsPath);
+                    if (jsStat.mtime < tsStat.mtime) {
+                        outOfSync.push(tsFile);
+                    }
+                }
+            }
+            if (outOfSync.length > 0) {
+                console.error('\n' + styleText('red', '❌ Build check failed:'));
+                console.error(styleText('red', `   ${outOfSync.length} file(s) need compilation in ${cwd}:`));
+                outOfSync.forEach(f => {
+                    const tsPath = path.join(cwd, f);
+                    const jsPath = path.join(cwd, f.replace('.ts', '.js'));
+                    const fmt = (d) => d.toLocaleString();
+                    console.error(styleText('red', `     - ${f}`));
+                    console.error(styleText('red', `       .ts: ${fmt(fs.statSync(tsPath).mtime)}  .js: ${fmt(fs.statSync(jsPath).mtime)}`));
+                });
+                console.error('\n' + styleText('yellow', '   Please run: tsc'));
+                console.error(styleText('yellow', '   Or use --force to skip this check') + '\n');
+                process.exit(1);
+            }
+        }
+    }
     // Handle --package: update scripts in target package.json
     if (cliOptions.package) {
         const pkg = readPackageJson(cwd);
@@ -401,6 +394,14 @@ export async function main() {
     // Load config file and merge with CLI options (CLI takes precedence)
     const configOptions = readConfig(cwd);
     const options = { ...configOptions, ...cliOptions };
+    // Persist explicitly set CLI flags to .globalize.json5
+    if (cliOptions.explicitKeys.size > 0 && !cliOptions.once) {
+        const persistable = { ...configOptions };
+        for (const key of cliOptions.explicitKeys) {
+            persistable[key] = options[key];
+        }
+        writeConfig(cwd, persistable, cliOptions.explicitKeys);
+    }
     try {
         // Auto-detect workspace root: private package with workspaces[] field
         if (!options.noWorkspace) {

package/lib.d.ts

@@ -17,8 +17,10 @@ export interface GlobalizeOptions {
     noPublish?: boolean;
     /** Restore from .dependencies */
     cleanup?: boolean;
-    /** Global install after publish */
+    /** Global install after publish (from registry) */
     install?: boolean;
+    /** Global install via symlink (npm install -g .) */
+    link?: boolean;
     /** Also install in WSL */
     wsl?: boolean;
     /** Continue despite git errors */
@@ -67,6 +69,8 @@ export interface GlobalizeOptions {
     continueOnError?: boolean;
     /** Update package.json scripts to use npmglobalize */
     package?: boolean;
+    /** Don't persist CLI flags to .globalize.json5 */
+    once?: boolean;
     /** Internal: signals this call is from workspace orchestrator */
     _fromWorkspace?: boolean;
 }

package/lib.js

@@ -110,7 +110,7 @@ export function writeConfig(dir, config, explicitKeys) {
     const existing = readConfig(dir);
     // Filter out temporary flags and default values (unless explicitly set)
     const filtered = {};
-    const omitKeys = new Set(['noPublish', 'cleanup', 'init', 'dryRun', 'message', 'conform', 'asis', 'help', 'error', 'updateDeps', 'updateMajor', 'publishDeps', 'forcePublish']);
+    const omitKeys = new Set(['noPublish', 'cleanup', 'init', 'dryRun', 'message', 'conform', 'asis', 'help', 'error', 'updateDeps', 'updateMajor', 'publishDeps', 'forcePublish', 'once']);
     for (const [key, value] of Object.entries(config)) {
         if (omitKeys.has(key))
             continue;
@@ -138,7 +138,9 @@ export function writeConfig(dir, config, explicitKeys) {
             // Add inline comment for clarity
             let comment = '';
             if (key === 'install')
-                comment = '  // Auto-install globally after publish';
+                comment = '  // Auto-install globally after publish (from registry)';
+            else if (key === 'link')
+                comment = '  // Install globally via symlink (npm install -g .)';
             else if (key === 'wsl')
                 comment = '  // Also install in WSL';
             else if (key === 'files')
@@ -164,7 +166,8 @@ export function writeConfig(dir, config, explicitKeys) {
     // Add commented reference for all options
     lines.push('  // Defaults (omitted above):');
     lines.push('  // "bump": "patch"              // Version bump: patch, minor, major');
-    lines.push('  // "install": false             // Auto-install globally after publish');
+    lines.push('  // "install": false             // Auto-install globally after publish (from registry)');
+    lines.push('  // "link": false               // Install globally via symlink (npm install -g .)');
     lines.push('  // "wsl": false                 // Also install in WSL');
     lines.push('  // "files": true                // Keep file: paths after publish');
     lines.push('  // "force": false               // Continue despite git errors');
@@ -716,6 +719,27 @@ export function fixVersionTagMismatch(cwd, pkg, verbose = false) {
     }
     return deletedAny;
 }
+/** Wait for a package version to appear on the npm registry */
+function waitForNpmVersion(pkgName, version, maxWaitMs = 60000) {
+    const interval = 3000;
+    const maxAttempts = Math.ceil(maxWaitMs / interval);
+    process.stdout.write(`Waiting for ${pkgName}@${version} on npm registry`);
+    for (let i = 0; i < maxAttempts; i++) {
+        const result = spawnSync('npm', ['view', `${pkgName}@${version}`, 'version'], {
+            shell: process.platform === 'win32',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8'
+        });
+        if (result.status === 0 && result.stdout?.trim() === version) {
+            process.stdout.write(' ready\n');
+            return true;
+        }
+        process.stdout.write('.');
+        spawnSync(process.platform === 'win32' ? 'timeout' : 'sleep', process.platform === 'win32' ? ['/t', '3', '/nobreak'] : ['3'], { stdio: 'pipe', shell: process.platform === 'win32' });
+    }
+    process.stdout.write(' timed out\n');
+    return false;
+}
 /** Run a command and return success status */
 export function runCommand(cmd, args, options = {}) {
     const { silent = false, cwd } = options;
@@ -1393,7 +1417,7 @@ export function getToolVersion() {
     }
 }
 export async function globalize(cwd, options = {}, configOptions = {}) {
-    const { bump = 'patch', noPublish = false, cleanup = false, install = false, wsl = false, force = false, files = true, dryRun = false, quiet = true, verbose = false, init = false, gitVisibility = 'private', npmVisibility = 'private', message, conform = false, asis = false, updateDeps = false, updateMajor = false, publishDeps = true, // Default to publishing deps for safety
+    const { bump = 'patch', noPublish = false, cleanup = false, install = false, link = false, wsl = false, force = false, files = true, dryRun = false, quiet = true, verbose = false, init = false, gitVisibility = 'private', npmVisibility = 'private', message, conform = false, asis = false, updateDeps = false, updateMajor = false, publishDeps = true, // Default to publishing deps for safety
     forcePublish = false, fix = false, fixTags = false, rebase = false, show = false } = options;
     // Show tool version (skip when called from workspace orchestrator)
     const toolVersion = getToolVersion();
@@ -1405,6 +1429,8 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
         const settings = [];
         if (configOptions.install)
             settings.push('--install');
+        if (configOptions.link)
+            settings.push('--link');
         if (configOptions.npmVisibility)
             settings.push(`--npm-visibility ${configOptions.npmVisibility}`);
         if (configOptions.gitVisibility)
@@ -2023,40 +2049,54 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     if (!currentGitStatus.hasUncommitted && !message && !justInitialized && !isFirstPublish) {
         console.log('');
         console.log('No changes to commit and no custom message specified.');
-        // If install flag is set, install from local directory
-        if (install || wsl) {
+        // If install/link flag is set, install globally
+        if (install || link || wsl) {
             if (verbose) {
                 console.log('');
-                console.log('Installing from local directory...');
+                console.log(link ? 'Installing from local directory (link)...' : 'Installing from registry...');
             }
             const pkgName = pkg.name;
-            if (!pkg.bin && (install || wsl)) {
+            const pkgVersion = pkg.version;
+            if (!pkg.bin && (install || link || wsl)) {
                 console.log(colors.yellow('Note: This is a library (no bin field), skipping global installation.'));
                 console.log(colors.yellow('To use in projects: npm install ' + pkgName));
             }
             else {
-                if (install) {
-                    console.log(`Installing ${pkgName} globally from local directory...`);
+                if (link) {
+                    console.log(`Installing ${pkgName} globally from local directory (link)...`);
                     const localInstallResult = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false });
                     if (localInstallResult.success) {
-                        const version = pkg.version;
-                        console.log(colors.green(`✓ Installed globally: ${pkgName}@${version}`));
+                        console.log(colors.green(`✓ Linked globally: ${pkgName}@${pkgVersion}`));
                     }
                     else {
-                        console.error(colors.red(`✗ Global install failed`));
+                        console.error(colors.red(`✗ Global link install failed`));
                         console.error(colors.yellow('  Try running manually: npm install -g .'));
                     }
                 }
+                else if (install) {
+                    waitForNpmVersion(pkgName, pkgVersion);
+                    console.log(`Installing ${pkgName}@${pkgVersion} globally from registry...`);
+                    const registryInstallResult = runCommand('npm', ['install', '-g', `${pkgName}@${pkgVersion}`], { cwd, silent: false });
+                    if (registryInstallResult.success) {
+                        console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
+                    }
+                    else {
+                        console.error(colors.red(`✗ Global install failed`));
+                        console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
+                    }
+                }
                 if (wsl) {
-                    console.log(`Installing ${pkgName} in WSL from local directory...`);
-                    const wslInstallResult = runCommand('wsl', ['npm', 'install', '-g', '.'], { cwd, silent: false });
+                    const wslArgs = link ? ['npm', 'install', '-g', '.'] : ['npm', 'install', '-g', `${pkgName}@${pkgVersion}`];
+                    if (!link && !install)
+                        waitForNpmVersion(pkgName, pkgVersion);
+                    console.log(`Installing ${pkgName} in WSL${link ? ' (link)' : ' from registry'}...`);
+                    const wslInstallResult = runCommand('wsl', wslArgs, { cwd, silent: false });
                     if (wslInstallResult.success) {
-                        const version = pkg.version;
-                        console.log(colors.green(`✓ Installed in WSL: ${pkgName}@${version}`));
+                        console.log(colors.green(`✓ Installed in WSL: ${pkgName}@${pkgVersion}`));
                     }
                     else {
                         console.error(colors.red(`✗ WSL install failed`));
-                        console.error(colors.yellow('  Try running manually in WSL: npm install -g .'));
+                        console.error(colors.yellow('  Try running manually in WSL: npm install -g ' + (link ? '.' : pkgName)));
                     }
                 }
             }
@@ -2470,21 +2510,20 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     const updatedPkg = readPackageJson(cwd); // Re-read to get updated version
     const pkgName = updatedPkg.name;
     const pkgVersion = updatedPkg.version;
-    if (!updatedPkg.bin && (install || wsl)) {
+    if (!updatedPkg.bin && (install || link || wsl)) {
         console.log(colors.yellow('Note: This is a library (no bin field), skipping global installation.'));
         console.log(colors.yellow('To use in projects: npm install ' + pkgName));
     }
     else {
-        if (install) {
-            console.log(`Installing globally: ${pkgName}@${pkgVersion}...`);
+        if (link) {
+            console.log(`Linking globally: ${pkgName}@${pkgVersion}...`);
             if (!dryRun) {
-                // Install from local directory (faster and works immediately after publish)
                 const installResult = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false });
                 if (installResult.success) {
-                    console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
+                    console.log(colors.green(`✓ Linked globally: ${pkgName}@${pkgVersion}`));
                 }
                 else {
-                    console.error(colors.red(`✗ Global install failed`));
+                    console.error(colors.red(`✗ Global link install failed`));
                     console.error(colors.yellow('  Try running manually: npm install -g .'));
                 }
             }
@@ -2492,11 +2531,30 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                 console.log(`  [dry-run] Would run: npm install -g .`);
             }
         }
+        else if (install) {
+            console.log(`Installing globally from registry: ${pkgName}@${pkgVersion}...`);
+            if (!dryRun) {
+                waitForNpmVersion(pkgName, pkgVersion);
+                const installResult = runCommand('npm', ['install', '-g', `${pkgName}@${pkgVersion}`], { cwd, silent: false });
+                if (installResult.success) {
+                    console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
+                }
+                else {
+                    console.error(colors.red(`✗ Global install failed`));
+                    console.error(colors.yellow(`  Try running manually: npm install -g ${pkgName}@${pkgVersion}`));
+                }
+            }
+            else {
+                console.log(`  [dry-run] Would run: npm install -g ${pkgName}@${pkgVersion}`);
+            }
+        }
         if (wsl) {
-            console.log(`Installing in WSL: ${pkgName}@${pkgVersion}...`);
+            const wslArgs = link ? ['npm', 'install', '-g', '.'] : ['npm', 'install', '-g', `${pkgName}@${pkgVersion}`];
+            if (!link && !install)
+                waitForNpmVersion(pkgName, pkgVersion);
+            console.log(`Installing in WSL${link ? ' (link)' : ' from registry'}: ${pkgName}@${pkgVersion}...`);
             if (!dryRun) {
-                // Install from local directory in WSL
-                const wslResult = runCommand('wsl', ['npm', 'install', '-g', '.'], { cwd, silent: false });
+                const wslResult = runCommand('wsl', wslArgs, { cwd, silent: false });
                 if (wslResult.success) {
                     console.log(colors.green(`✓ Installed in WSL: ${pkgName}@${pkgVersion}`));
                 }
@@ -2505,7 +2563,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                 }
             }
             else {
-                console.log(`  [dry-run] Would run: wsl npm install -g ${pkgName}`);
+                console.log(`  [dry-run] Would run: wsl npm install -g ${link ? '.' : pkgName}`);
             }
         }
     }
@@ -2545,7 +2603,10 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     console.log(`  Version: ${colors.green('v' + finalPkg.version)}`);
     console.log(`  Published: ${colors.green('✓')} (${accessLabel})`);
     console.log(`  Git pushed: ${colors.green('✓')}`);
-    if (install) {
+    if (link) {
+        console.log(`  Linked globally: ${colors.green('✓')}`);
+    }
+    else if (install) {
         console.log(`  Installed globally: ${colors.green('✓')}`);
     }
     if (wsl) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.79",
+  "version": "1.0.81",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",