@bobfrankston/importgen 0.1.24 → 0.1.26

package/.claude/settings.local.json

@@ -8,7 +8,10 @@
       "Bash(dir:*)",
       "Bash(ls:*)",
       "Bash(where extractids:*)",
-      "Bash(cd \"y:/dev/utils/importgen\" && npx tsc --noEmit 2>&1222)"
+      "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 && 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,6 +5,7 @@
  */
 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' };
 /**
@@ -265,16 +266,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(`[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('[importgen] Added preinstall guard to package.json');
+    }
+    catch (e) {
+        console.error(`[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('[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('[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('[importgen] Removed preinstall guard');
         }
+        fs.writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
     }
     catch (e) {
         console.error(`[importgen] Error updating package.json: ${e.message}`);
+        process.exit(1);
+    }
+    // Run npm install to restore proper dependencies
+    console.log('[importgen] Running npm install...');
+    try {
+        execSync('npm install', { stdio: 'inherit', cwd: process.cwd() });
+        console.log('[importgen] Unfreeze complete');
+    }
+    catch (e) {
+        console.error(`[importgen] npm install failed: ${e.message}`);
+        process.exit(1);
     }
 }
 // Parse CLI arguments
@@ -283,9 +321,24 @@ if (args.includes('-v') || args.includes('--version')) {
     console.log(`importgen ${packageJson.version}`);
     process.exit(0);
 }
+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] [--unfreeze] [-v|--version]`);
+    process.exit(1);
+}
 const watchMode = args.includes('-w') || args.includes('--watch');
-const freezeMode = args.includes('--freeze');
-const htmlArg = args.find(a => !a.startsWith('-'));
+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] [--unfreeze] [-v|--version]`);
+    process.exit(1);
+}
+const htmlArg = positionalArgs[0];
 const packageJsonPath = path.join(process.cwd(), 'package.json');
 // Resolve HTML file: explicit argument, or search for common names
 const possibleHtmlFiles = ['index.html', 'default.html', 'default.htm'];
@@ -300,6 +353,10 @@ 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`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/importgen",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Generate ES Module import maps from package.json dependencies for native browser module loading",
   "main": "index.js",
   "bin": {