@bobfrankston/npmglobalize 1.0.109 → 1.0.111

package/README.md

@@ -179,7 +179,8 @@ When initializing a new repository with `--init`, npmglobalize automatically set
 
 **File structure** (per programming.md standards):
 - `.gitignore` - Node.js best practices (node_modules, secrets, certificates, etc.)
-- `.npmignore` - Publishing filters (excludes .git, tests, source files, etc.)  
+- `.npmignore` - Publishing filters (excludes .git, tests, source files, etc.)
+  - **noEmit projects:** `*.ts`, `*.map`, and `tsconfig.json` are kept (not ignored) since TS files are the runtime files
 - `.gitattributes` - Forces LF line endings for all text files
 
 **Git configuration** (ensures cross-platform compatibility):
@@ -298,6 +299,7 @@ Workspace mode is auto-detected when run from a root with `"private": true` and
 -verbose        Show detailed output
 -conform        Update .gitignore/.npmignore/.gitattributes to best practices
                 and configure git for LF line endings (fixes existing repos)
+                For noEmit projects: removes *.ts/*.map/tsconfig.json from .npmignore
 -asis           Skip ignore file checks (or set "asis": true in .globalize.json5)
 -fix-tags       Automatically fix version/tag mismatches
 -rebase         Automatically rebase if local is behind remote

package/cli.js

@@ -40,6 +40,8 @@ Install Options:
   -link          Global install via symlink (npm install -g .)
   -local         Local install only — skip transform/publish, just npm install -g .
   -wsl           Also install globally in WSL
+  -freeze        Freeze node_modules (replace symlinks with real copies for network shares)
+  -nofreeze      Disable freeze
   -once          Don't persist flags to .globalize.json5
 
 Mode Options:
@@ -65,6 +67,7 @@ Other Options:
   -quiet          Suppress npm warnings (default)
   -verbose        Show detailed output
   -conform        Update .gitignore/.npmignore to best practices
+                  (noEmit projects: removes TS ignores from .npmignore)
   -asis           Skip ignore file checks (or set "asis": true in .globalize.json5)
   -rebase         Automatically rebase if local is behind remote
   -show           Show package.json dependency changes
@@ -283,6 +286,14 @@ function parseArgs(args) {
             case '-pkg':
                 options.package = true;
                 break;
+            case '-freeze':
+                options.freeze = true;
+                options.explicitKeys.add('freeze');
+                break;
+            case '-nofreeze':
+                options.freeze = false;
+                options.explicitKeys.add('freeze');
+                break;
             case '-once':
                 options.once = true;
                 break;

package/lib.d.ts

@@ -74,6 +74,8 @@ export interface GlobalizeOptions {
     once?: boolean;
     /** Local install only — skip transform/publish, just npm install -g . */
     local?: boolean;
+    /** Freeze node_modules: replace symlinks/junctions with real copies for network share use */
+    freeze?: boolean;
     /** Internal: signals this call is from workspace orchestrator */
     _fromWorkspace?: boolean;
     /** Internal: signals this call is from CLI (version already printed) */

package/lib.js

@@ -13,6 +13,7 @@ import fs from 'fs';
 import path from 'path';
 import { execSync, spawnSync } from 'child_process';
 import { readConfig as readUserConfig, writeConfig as writeUserConfig, configDir } from '@bobfrankston/userconfig';
+import { freezeDependencies } from '@bobfrankston/freezepak';
 /** Wrapper for spawnSync that avoids DEP0190 (args + shell: true).
  *  When shell is true, joins cmd+args into a single command string. */
 function spawnSafe(cmd, args, options = {}) {
@@ -198,7 +199,8 @@ export function writeConfig(dir, config, explicitKeys) {
         install: false,
         wsl: false,
         force: false,
-        verbose: false
+        verbose: false,
+        freeze: false
     };
     // Read existing config to preserve values
     const existing = readConfig(dir);
@@ -257,6 +259,8 @@ export function writeConfig(dir, config, explicitKeys) {
                 comment = '  // Local install only (skip transform/publish)';
             else if (key === 'noPublish')
                 comment = '  // Transform but don\'t publish';
+            else if (key === 'freeze')
+                comment = '  // Freeze node_modules (replace symlinks with real copies)';
             lines.push(`  "${key}": ${jsonValue}${comma}${comment}`);
         });
         lines.push('');
@@ -276,6 +280,7 @@ export function writeConfig(dir, config, explicitKeys) {
     lines.push('  // "fix": false                 // Auto-run npm audit fix');
     lines.push('  // "local": false              // Local install only (skip transform/publish)');
     lines.push('  // "noPublish": false          // Transform but don\'t publish');
+    lines.push('  // "freeze": false              // Freeze node_modules (replace symlinks with real copies)');
     lines.push('}');
     fs.writeFileSync(configPath, lines.join('\n') + '\n');
 }
@@ -1333,6 +1338,29 @@ const IGNORE_PATTERNS = loadIgnorePatterns();
 const ALL_GITIGNORE = [...IGNORE_PATTERNS.gitignore.security, ...IGNORE_PATTERNS.gitignore.recommended, ...(IGNORE_PATTERNS.gitignore.presenceOnly ?? [])];
 /** All .npmignore patterns (security + recommended) */
 const ALL_NPMIGNORE = [...IGNORE_PATTERNS.npmignore.security, ...IGNORE_PATTERNS.npmignore.recommended];
+/** Patterns that should NOT be in .npmignore for noEmit projects (TS files are the runtime files) */
+const TS_NPMIGNORE_PATTERNS = new Set(['*.ts', '!*.d.ts', '*.map', 'tsconfig.json']);
+/** Check if target project uses noEmit (TS files run directly, no compilation) */
+function isNoEmitProject(cwd) {
+    const tsconfigPath = path.join(cwd, 'tsconfig.json');
+    if (!fs.existsSync(tsconfigPath))
+        return false;
+    try {
+        const content = fs.readFileSync(tsconfigPath, 'utf-8');
+        const tsconfig = JSON5.parse(content);
+        return tsconfig.compilerOptions?.noEmit === true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Get applicable npmignore patterns, excluding TS patterns for noEmit projects */
+function getApplicableNpmignorePatterns(cwd) {
+    if (isNoEmitProject(cwd)) {
+        return ALL_NPMIGNORE.filter(p => !TS_NPMIGNORE_PATTERNS.has(p));
+    }
+    return ALL_NPMIGNORE;
+}
 /** Presence-only extensions derived from data file */
 const PRESENCE_ONLY_EXTENSIONS = new Set((IGNORE_PATTERNS.gitignore.presenceOnly ?? [])
     .map(p => p.match(/^\*(\.\w+)$/)?.[1])
@@ -1412,7 +1440,8 @@ function checkIgnoreFiles(cwd, options) {
     if (fs.existsSync(npmignorePath)) {
         const content = fs.readFileSync(npmignorePath, 'utf-8');
         const lines = content.split('\n').map(l => l.trim());
-        for (const pattern of ALL_NPMIGNORE) {
+        const applicableNpm = getApplicableNpmignorePatterns(cwd);
+        for (const pattern of applicableNpm) {
             if (!lineHasPattern(lines, pattern)) {
                 if (securityNpm.has(pattern)) {
                     securityChanges.push(`  .npmignore missing: ${pattern}`);
@@ -1447,7 +1476,8 @@ function conformIgnoreFiles(cwd, securityOnly = false) {
         }
     }
     const patternsGit = securityOnly ? getSecurityGitignorePatterns() : getApplicableGitignorePatterns(cwd);
-    const patternsNpm = securityOnly ? getSecurityNpmignorePatterns() : ALL_NPMIGNORE;
+    const patternsNpm = securityOnly ? getSecurityNpmignorePatterns() : getApplicableNpmignorePatterns(cwd);
+    const noEmit = isNoEmitProject(cwd);
     // Update .gitignore
     const gitignorePath = path.join(cwd, '.gitignore');
     if (fs.existsSync(gitignorePath)) {
@@ -1474,8 +1504,8 @@ function conformIgnoreFiles(cwd, securityOnly = false) {
         const lines = content.split('\n').map(l => l.trim());
         const newLines = new Set(lines.filter(l => l));
         let updated = false;
-        if (!securityOnly) {
-            // Add TypeScript exclusions (only in full conform)
+        if (!securityOnly && !noEmit) {
+            // Add TypeScript exclusions (only in full conform, skip for noEmit projects)
             for (const ts of ['*.ts', '!*.d.ts', '*.map']) {
                 if (!newLines.has(ts)) {
                     newLines.add(ts);
@@ -1483,6 +1513,15 @@ function conformIgnoreFiles(cwd, securityOnly = false) {
                 }
             }
         }
+        // For noEmit projects, remove TS patterns that shouldn't be ignored
+        if (noEmit) {
+            for (const ts of TS_NPMIGNORE_PATTERNS) {
+                if (newLines.has(ts)) {
+                    newLines.delete(ts);
+                    updated = true;
+                }
+            }
+        }
         for (const pattern of patternsNpm) {
             if (!newLines.has(pattern)) {
                 newLines.add(pattern);
@@ -1492,7 +1531,12 @@ function conformIgnoreFiles(cwd, securityOnly = false) {
         if (updated) {
             const newContent = Array.from(newLines).join('\n') + '\n';
             fs.writeFileSync(npmignorePath, newContent);
-            console.log(colors.cyan('  ✓ Auto-added security patterns to .npmignore'));
+            if (noEmit) {
+                console.log(colors.cyan('  ✓ .npmignore updated (noEmit: kept *.ts files)'));
+            }
+            else {
+                console.log(colors.cyan('  ✓ Auto-added security patterns to .npmignore'));
+            }
         }
     }
 }
@@ -1542,7 +1586,8 @@ function ensureNpmignore(cwd) {
     const npmignorePath = path.join(cwd, '.npmignore');
     if (!fs.existsSync(npmignorePath)) {
         console.log('  Creating .npmignore...');
-        const content = ALL_NPMIGNORE.join('\n') + '\n';
+        const patterns = getApplicableNpmignorePatterns(cwd);
+        const content = patterns.join('\n') + '\n';
         fs.writeFileSync(npmignorePath, content);
         console.log(colors.green('  ✓ .npmignore created'));
     }
@@ -1870,7 +1915,7 @@ async function doLocalInstall(cwd, options) {
 }
 export async function globalize(cwd, options = {}, configOptions = {}) {
     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, local = false } = options;
+    forcePublish = false, fix = false, fixTags = false, rebase = false, show = false, local = false, freeze = false } = options;
     // Show tool version only for recursive dep calls (CLI already prints it at startup)
     const toolVersion = getToolVersion();
     if (!options._fromWorkspace && !options._fromCli) {
@@ -1927,6 +1972,8 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             settings.push('--show');
         if (configOptions.local)
             settings.push('-local');
+        if (configOptions.freeze)
+            settings.push('-freeze');
         if (settings.length > 0) {
             console.log(colors.dim(`Settings from .globalize.json5: ${settings.join(', ')}`));
         }
@@ -2687,6 +2734,16 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     }
     if (noPublish) {
         console.log('Transform complete (--nopublish mode).');
+        if (freeze && !dryRun) {
+            console.log('Freezing node_modules (replacing symlinks with real copies)...');
+            try {
+                freezeDependencies(cwd);
+                console.log(colors.green('✓ node_modules frozen'));
+            }
+            catch (error) {
+                console.error(colors.red(`✗ Freeze failed: ${error.message}`));
+            }
+        }
         if (files && transformResult.transformed) {
             console.log('Restoring file: dependencies...');
             const finalPkg = readPackageJson(cwd);
@@ -2705,6 +2762,16 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
     // Skip if private
     if (pkg.private) {
         console.log('Package is private - skipping npm publish.');
+        if (freeze && !dryRun) {
+            console.log('Freezing node_modules (replacing symlinks with real copies)...');
+            try {
+                freezeDependencies(cwd);
+                console.log(colors.green('✓ node_modules frozen'));
+            }
+            catch (error) {
+                console.error(colors.red(`✗ Freeze failed: ${error.message}`));
+            }
+        }
         if (files && transformResult.transformed) {
             console.log('Restoring file: dependencies...');
             const finalPkg = readPackageJson(cwd);
@@ -3283,6 +3350,8 @@ 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;
+    let globalInstallOk = false;
+    let wslInstallOk = false;
     if (!updatedPkg.bin && (install || link || wsl)) {
         const proceed = await offerAddBin(cwd, updatedPkg);
         if (!proceed) {
@@ -3296,6 +3365,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             if (!dryRun) {
                 const installResult = runCommand('npm', ['install', '-g', '.'], { cwd, silent: false, showCommand: true });
                 if (installResult.success) {
+                    globalInstallOk = true;
                     console.log(colors.green(`✓ Linked globally: ${pkgName}@${pkgVersion}`));
                 }
                 else {
@@ -3313,6 +3383,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
                 waitForNpmVersion(pkgName, pkgVersion);
                 const installResult = installGlobalWithRetry(`${pkgName}@${pkgVersion}`, cwd);
                 if (installResult.success) {
+                    globalInstallOk = true;
                     console.log(colors.green(`✓ Installed globally: ${pkgName}@${pkgVersion}`));
                 }
                 else {
@@ -3332,6 +3403,7 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             if (!dryRun) {
                 const wslResult = runCommand('wsl', wslArgs, { cwd, silent: false, showCommand: true });
                 if (wslResult.success) {
+                    wslInstallOk = true;
                     console.log(colors.green(`✓ Installed in WSL: ${pkgName}@${pkgVersion}`));
                 }
                 else {
@@ -3343,6 +3415,20 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
             }
         }
     }
+    // Freeze node_modules: replace symlinks/junctions with real copies
+    if (freeze && !dryRun) {
+        console.log('Freezing node_modules (replacing symlinks with real copies)...');
+        try {
+            freezeDependencies(cwd);
+            console.log(colors.green('✓ node_modules frozen'));
+        }
+        catch (error) {
+            console.error(colors.red(`✗ Freeze failed: ${error.message}`));
+        }
+    }
+    else if (freeze && dryRun) {
+        console.log('  [dry-run] Would freeze node_modules');
+    }
     // Finalize - restore file: paths if --files mode (default)
     if (files && transformResult.transformed) {
         console.log('Restoring file: dependencies (--files mode)...');
@@ -3383,13 +3469,16 @@ export async function globalize(cwd, options = {}, configOptions = {}) {
         console.log(`  Git visibility: ${colors.green(gitVisibility.toUpperCase())}`);
     }
     if (link) {
-        console.log(`  Linked globally: ${colors.green('✓')}`);
+        console.log(`  Linked globally: ${globalInstallOk ? colors.green('✓') : colors.red('✗')}`);
     }
     else if (install) {
-        console.log(`  Installed globally: ${colors.green('✓')}`);
+        console.log(`  Installed globally: ${globalInstallOk ? colors.green('✓') : colors.red('✗')}`);
     }
     if (wsl) {
-        console.log(`  Installed in WSL: ${colors.green('✓')}`);
+        console.log(`  Installed in WSL: ${wslInstallOk ? colors.green('✓') : colors.red('✗')}`);
+    }
+    if (freeze) {
+        console.log(`  Frozen node_modules: ${colors.green('✓')}`);
     }
     if (files && transformResult.transformed) {
         console.log(`  Restored file: deps: ${colors.green('✓')}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/npmglobalize",
-  "version": "1.0.109",
+  "version": "1.0.111",
   "description": "Transform file: dependencies to npm versions for publishing",
   "main": "index.js",
   "type": "module",
@@ -31,6 +31,7 @@
     "url": "https://github.com/BobFrankston/npmglobalize.git"
   },
   "dependencies": {
+    "@bobfrankston/freezepak": "^0.1.4",
     "@bobfrankston/userconfig": "^1.0.4",
     "@npmcli/package-json": "^7.0.4",
     "json5": "^2.2.3",
@@ -43,6 +44,7 @@
     "access": "public"
   },
   ".dependencies": {
+    "@bobfrankston/freezepak": "file:../freezepak",
     "@bobfrankston/userconfig": "file:../userconfig",
     "@npmcli/package-json": "^7.0.4",
     "json5": "^2.2.3",