@bobfrankston/importgen 0.1.25 → 0.1.27

package/.claude/settings.local.json

@@ -9,7 +9,9 @@
       "Bash(ls:*)",
       "Bash(where extractids:*)",
       "Bash(cd \"y:/dev/utils/importgen\" && npx tsc --noEmit 2>&1222)",
-      "Bash(cd y:/dev/utils/importgen && npm run release 2>&1exit)"
+      "Bash(cd y:/dev/utils/importgen && npm run release 2>&1exit)",
+      "Bash(cd y:/dev/utils/importgen && npx tsc --noEmit 2>&1)",
+      "Bash(cd:*)"
     ]
   }
 }

package/README.md

@@ -25,7 +25,7 @@ npm install -g @bobfrankston/importgen
 Run from your project directory (containing `package.json` and your HTML file):
 
 ```bash
-importgen [htmlfile] [--watch|-w] [--version|-v]
+importgen [htmlfile] [--watch|-w] [--freeze] [--unfreeze] [--version|-v]
 ```
 
 ```bash
@@ -42,6 +42,12 @@ importgen default.htm --watch
 
 # Show version
 importgen -v
+
+# Freeze: replace symlinks/junctions with real copies for deployment
+importgen --freeze
+
+# Unfreeze: restore symlinks and run npm install
+importgen --unfreeze
 ```
 
 `importgen` reads dependencies from `package.json` in the current directory and injects the import map into the HTML file.
@@ -129,6 +135,14 @@ Add a `.dependencies` field to `package.json` to override resolution paths for s
 
 The import map will use the `.dependencies` path instead of the `node_modules` path for that package.
 
+## Freeze / Unfreeze
+
+`--freeze` prepares a project for deployment by replacing all symlinks and junctions in `node_modules` with real directory copies. This is useful when `file:` or `workspace:` dependencies point to local packages via symlinks that won't exist on a deployment target.
+
+Freeze also adds a `preinstall` guard script to `package.json` that prevents accidental `npm install` from overwriting the frozen copies. If a `preinstall` script already exists, it is saved as `frozen-preinstall` so it can be restored later.
+
+`--unfreeze` reverses the process: it removes the preinstall guard (restoring any original preinstall script), then runs `npm install` to re-establish normal symlinked dependencies.
+
 ## VS Code tasks.json Integration
 
 Add `importgen --watch` as a background task that starts automatically when you open the project. Combined with `tsc --watch`, your import map stays current as you develop.

package/index.js

@@ -5,8 +5,13 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import { execSync } from 'node:child_process';
 import chokidar from 'chokidar';
 import packageJson from './package.json' with { type: 'json' };
+/** Timestamp prefix for log messages */
+function ts() {
+    return `[${new Date().toLocaleTimeString()}]`;
+}
 /**
  * Resolve dependency path based on version specifier
  */
@@ -90,7 +95,7 @@ function collectDependencies(packageJsonPath, visited, dependencies, htmlDir, no
             let depPath = resolveDependencyPath(packageDir, depName, versionToUse);
             if (!depPath) {
                 const warning = `Could not follow path for ${depName} (${versionToUse})`;
-                console.warn(`[generate-importmap] Warning: ${warning}`);
+                console.warn(`${ts()} [generate-importmap] Warning: ${warning}`);
                 warnings.push(warning);
                 continue;
             }
@@ -98,7 +103,7 @@ function collectDependencies(packageJsonPath, visited, dependencies, htmlDir, no
             const dependencyBackupPath = depPath + '.dependency';
             if (fs.existsSync(dependencyBackupPath)) {
                 const warning = `Using backup path ${dependencyBackupPath}`;
-                console.warn(`[generate-importmap] Warning: ${warning}`);
+                console.warn(`${ts()} [generate-importmap] Warning: ${warning}`);
                 warnings.push(warning);
                 depPath = dependencyBackupPath;
             }
@@ -109,7 +114,7 @@ function collectDependencies(packageJsonPath, visited, dependencies, htmlDir, no
             const depPackageJsonPath = path.join(depPath, 'package.json');
             if (!fs.existsSync(depPackageJsonPath)) {
                 const warning = `Could not follow path for ${depName} - no package.json found at ${depPath}`;
-                console.warn(`[generate-importmap] Warning: ${warning}`);
+                console.warn(`${ts()} [generate-importmap] Warning: ${warning}`);
                 warnings.push(warning);
                 continue;
             }
@@ -134,7 +139,7 @@ function collectDependencies(packageJsonPath, visited, dependencies, htmlDir, no
         }
     }
     catch (e) {
-        console.error(`[generate-importmap] Error processing ${packageJsonPath}:`, e.message);
+        console.error(`${ts()} [generate-importmap] Error processing ${packageJsonPath}:`, e.message);
         throw e; // Propagate so callers can avoid overwriting HTML with empty map
     }
 }
@@ -183,14 +188,14 @@ function generateImportMap(packageJsonPath, htmlFilePath) {
         }
         // Write back to HTML file
         fs.writeFileSync(htmlFilePath, html, 'utf-8');
-        console.log('[generate-importmap] Updated import map');
+        console.log(`${ts()} [generate-importmap] Updated import map`);
         console.log(`  Scanned ${visited.size} dependencies, generated ${dependencies.size} entries`);
         if (dependencies.size > 0) {
             console.log('  Packages:', Array.from(dependencies.keys()).join(', '));
         }
     }
     catch (e) {
-        console.error('[generate-importmap] Error:', e.message);
+        console.error(`${ts()} [generate-importmap] Error:`, e.message);
         process.exit(1);
     }
     return result;
@@ -202,7 +207,7 @@ function generateImportMap(packageJsonPath, htmlFilePath) {
 function freezeDependencies(packageJsonPath) {
     const nodeModulesDir = path.join(process.cwd(), 'node_modules');
     if (!fs.existsSync(nodeModulesDir)) {
-        console.error('[importgen] Error: node_modules not found');
+        console.error(`${ts()} [importgen] Error: node_modules not found`);
         process.exit(1);
     }
     /** Check if a directory entry is a junction or symlink by comparing realpath to its path */
@@ -219,7 +224,7 @@ function freezeDependencies(packageJsonPath) {
             }
         }
         catch (e) {
-            console.error(`[importgen] Error checking ${entryPath}: ${e.message}`);
+            console.error(`${ts()} [importgen] Error checking ${entryPath}: ${e.message}`);
         }
         return false;
     }
@@ -228,11 +233,11 @@ function freezeDependencies(packageJsonPath) {
         if (!isLinked(entryPath))
             return;
         const target = fs.realpathSync(entryPath);
-        console.log(`  Freezing ${displayName} (${target})`);
+        console.log(`${ts()}   Freezing ${displayName} (${target})`);
         fs.rmSync(entryPath, { recursive: true });
         fs.cpSync(target, entryPath, { recursive: true });
     }
-    console.log('[importgen] Freezing dependencies...');
+    console.log(`${ts()} [importgen] Freezing dependencies...`);
     let frozenCount = 0;
     const entries = fs.readdirSync(nodeModulesDir);
     for (const entry of entries) {
@@ -257,7 +262,7 @@ function freezeDependencies(packageJsonPath) {
                 frozenCount++;
         }
     }
-    console.log(`[importgen] Frozen ${frozenCount} linked packages`);
+    console.log(`${ts()} [importgen] Frozen ${frozenCount} linked packages`);
     // Add preinstall guard to package.json
     try {
         const pkgRaw = fs.readFileSync(packageJsonPath, 'utf-8');
@@ -265,16 +270,53 @@ function freezeDependencies(packageJsonPath) {
         if (!pkg.scripts)
             pkg.scripts = {};
         if (pkg.scripts.preinstall) {
-            console.warn('[importgen] Warning: preinstall script already exists, skipping guard');
+            // Rename existing preinstall so unfreeze can restore it
+            pkg.scripts['frozen-preinstall'] = pkg.scripts.preinstall;
+            console.log(`${ts()} [importgen] Saved existing preinstall script as "frozen-preinstall"`);
+        }
+        pkg.scripts.preinstall = 'echo FROZEN: dependencies were frozen by importgen. Use importgen --unfreeze to restore. && exit 1';
+        fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+        console.log(`${ts()} [importgen] Added preinstall guard to package.json`);
+    }
+    catch (e) {
+        console.error(`${ts()} [importgen] Error updating package.json: ${e.message}`);
+    }
+}
+/**
+ * Unfreeze: remove preinstall guard, restore original preinstall if saved, then run npm install.
+ */
+function unfreezeDependencies(packageJsonPath) {
+    try {
+        const pkgRaw = fs.readFileSync(packageJsonPath, 'utf-8');
+        const pkg = JSON.parse(pkgRaw);
+        if (!pkg.scripts?.preinstall) {
+            console.log(`${ts()} [importgen] No preinstall guard found — nothing to unfreeze`);
+            return;
+        }
+        if (pkg.scripts['frozen-preinstall']) {
+            pkg.scripts.preinstall = pkg.scripts['frozen-preinstall'];
+            delete pkg.scripts['frozen-preinstall'];
+            console.log(`${ts()} [importgen] Restored original preinstall script`);
         }
         else {
-            pkg.scripts.preinstall = 'echo FROZEN: dependencies were frozen by importgen. Remove this script before running npm install. && exit 1';
-            fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
-            console.log('[importgen] Added preinstall guard to package.json');
+            delete pkg.scripts.preinstall;
+            console.log(`${ts()} [importgen] Removed preinstall guard`);
         }
+        fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+    }
+    catch (e) {
+        console.error(`${ts()} [importgen] Error updating package.json: ${e.message}`);
+        process.exit(1);
+    }
+    // Run npm install to restore proper dependencies
+    console.log(`${ts()} [importgen] Running npm install...`);
+    try {
+        execSync('npm install', { stdio: 'inherit', cwd: process.cwd() });
+        console.log(`${ts()} [importgen] Unfreeze complete`);
     }
     catch (e) {
-        console.error(`[importgen] Error updating package.json: ${e.message}`);
+        console.error(`${ts()} [importgen] npm install failed: ${e.message}`);
+        process.exit(1);
     }
 }
 // Parse CLI arguments
@@ -283,20 +325,21 @@ if (args.includes('-v') || args.includes('--version')) {
     console.log(`importgen ${packageJson.version}`);
     process.exit(0);
 }
-const knownFlags = new Set(['-w', '--watch', '--freeze', '-freeze', '-v', '--version']);
+const knownFlags = new Set(['-w', '--watch', '--freeze', '-freeze', '--unfreeze', '-unfreeze', '-v', '--version']);
 // Report unrecognized flags as errors
 const unknownArgs = args.filter(a => a.startsWith('-') && !knownFlags.has(a));
 if (unknownArgs.length > 0) {
-    console.error(`[importgen] Error: unrecognized argument(s): ${unknownArgs.join(', ')}`);
-    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [--freeze] [-v|--version]`);
+    console.error(`${ts()} [importgen] Error: unrecognized argument(s): ${unknownArgs.join(', ')}`);
+    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [--freeze] [--unfreeze] [-v|--version]`);
     process.exit(1);
 }
 const watchMode = args.includes('-w') || args.includes('--watch');
 const freezeMode = args.includes('--freeze') || args.includes('-freeze');
+const unfreezeMode = args.includes('--unfreeze') || args.includes('-unfreeze');
 const positionalArgs = args.filter(a => !a.startsWith('-'));
 if (positionalArgs.length > 1) {
-    console.error(`[importgen] Error: too many arguments: ${positionalArgs.join(', ')}`);
-    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [--freeze] [-v|--version]`);
+    console.error(`${ts()} [importgen] Error: too many arguments: ${positionalArgs.join(', ')}`);
+    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [--freeze] [--unfreeze] [-v|--version]`);
     process.exit(1);
 }
 const htmlArg = positionalArgs[0];
@@ -307,19 +350,23 @@ const htmlFileName = htmlArg || possibleHtmlFiles.find(f => fs.existsSync(path.j
 const htmlFilePath = htmlFileName ? path.join(process.cwd(), htmlFileName) : null;
 // Check if files exist
 if (!fs.existsSync(packageJsonPath)) {
-    console.error('[generate-importmap] Error: package.json not found in current directory');
+    console.error(`${ts()} [generate-importmap] Error: package.json not found in current directory`);
     process.exit(1);
 }
 if (freezeMode) {
     freezeDependencies(packageJsonPath);
     process.exit(0);
 }
+if (unfreezeMode) {
+    unfreezeDependencies(packageJsonPath);
+    process.exit(0);
+}
 if (!htmlFilePath || !fs.existsSync(htmlFilePath)) {
     if (htmlArg) {
-        console.error(`[generate-importmap] Error: ${htmlArg} not found in current directory`);
+        console.error(`${ts()} [generate-importmap] Error: ${htmlArg} not found in current directory`);
     }
     else {
-        console.error(`[generate-importmap] Error: No HTML file found. Looking for: ${possibleHtmlFiles.join(', ')}`);
+        console.error(`${ts()} [generate-importmap] Error: No HTML file found. Looking for: ${possibleHtmlFiles.join(', ')}`);
     }
     process.exit(1);
 }
@@ -362,7 +409,7 @@ if (watchMode) {
     watcher.on('unlink', onChange);
     watcher.on('ready', () => {
         const total = 1 + watchedDepDirs.size;
-        console.log(`[generate-importmap] Watching ${total} directories for changes...`);
+        console.log(`${ts()} [generate-importmap] Watching ${total} directories for changes...`);
         if (watchedDepDirs.size > 0) {
             for (const dir of watchedDepDirs) {
                 console.log(`  ${dir}`);
@@ -370,7 +417,7 @@ if (watchMode) {
         }
     });
     watcher.on('error', (error) => {
-        console.error('[generate-importmap] Watcher error:', error.message);
+        console.error(`${ts()} [generate-importmap] Watcher error:`, error.message);
     });
 }
 else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/importgen",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Generate ES Module import maps from package.json dependencies for native browser module loading",
   "main": "index.js",
   "bin": {
@@ -34,7 +34,7 @@
     "chokidar": "^4.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.2.1"
+    "@types/node": "^25.3.0"
   },
   "publishConfig": {
     "access": "public"