@bobfrankston/importgen 0.1.28 → 0.1.29

package/README.md

@@ -103,6 +103,25 @@ The browser sees `date-utils`, looks it up in the import map, and loads `./node_
 
 The key point: your TypeScript source files are the same whether they run in Node or the browser. `importgen` just provides the mapping the browser needs to find the packages.
 
+## Programmatic API
+
+`importgen` can be called from another application (e.g., `npmglobalize`) instead of the CLI:
+
+```typescript
+import { importgen } from "@bobfrankston/importgen";
+
+// Generate import map for a specific directory
+importgen("/path/to/my/app");
+
+// With explicit HTML filename
+importgen("/path/to/my/app", "default.htm");
+
+// Uses process.cwd() if no directory given
+importgen();
+```
+
+The function throws on missing `package.json` or HTML file (instead of calling `process.exit`), so callers can handle errors. Returns a `GenerateResult` with resolved dependency directories.
+
 ## How Entry Points Are Resolved
 
 For each dependency, `importgen` reads that package's `package.json` and picks the entry point in this order:

package/index.d.ts

@@ -3,5 +3,15 @@
  * Generate ES Module import map from package.json dependencies
  * Injects into HTML files for native browser module loading
  */
-export {};
+/** Result from generateImportMap including paths for watch mode */
+export interface GenerateResult {
+    depDirs: string[]; /** Resolved dependency directories */
+}
+/**
+ * API: run importgen on a directory.
+ * @param appDir - directory containing package.json and HTML file (defaults to cwd)
+ * @param htmlFile - HTML filename to update (auto-detected if omitted)
+ * @returns GenerateResult with resolved dependency directories
+ */
+export declare function importgen(appDir?: string, htmlFile?: string): GenerateResult;
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -199,98 +199,116 @@ function generateImportMap(packageJsonPath, htmlFilePath) {
     }
     return result;
 }
-// Parse CLI arguments
-const args = process.argv.slice(2);
-if (args.includes('-v') || args.includes('--version')) {
-    console.log(`importgen ${packageJson.version}`);
-    process.exit(0);
-}
-const knownFlags = new Set(['-w', '--watch', '-v', '--version']);
-// Report unrecognized flags as errors
-const unknownArgs = args.filter(a => a.startsWith('-') && !knownFlags.has(a));
-if (unknownArgs.length > 0) {
-    console.error(`${ts()} [importgen] Error: unrecognized argument(s): ${unknownArgs.join(', ')}`);
-    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [-v|--version]`);
-    process.exit(1);
-}
-const watchMode = args.includes('-w') || args.includes('--watch');
-const positionalArgs = args.filter(a => !a.startsWith('-'));
-if (positionalArgs.length > 1) {
-    console.error(`${ts()} [importgen] Error: too many arguments: ${positionalArgs.join(', ')}`);
-    console.error(`  Usage: importgen [htmlfile] [-w|--watch] [-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'];
-const htmlFileName = htmlArg || possibleHtmlFiles.find(f => fs.existsSync(path.join(process.cwd(), f)));
-const htmlFilePath = htmlFileName ? path.join(process.cwd(), htmlFileName) : null;
-// Check if files exist
-if (!fs.existsSync(packageJsonPath)) {
-    console.error(`${ts()} [generate-importmap] Error: package.json not found in current directory`);
-    process.exit(1);
-}
-if (!htmlFilePath || !fs.existsSync(htmlFilePath)) {
-    if (htmlArg) {
-        console.error(`${ts()} [generate-importmap] Error: ${htmlArg} not found in current directory`);
+/**
+ * API: run importgen on a directory.
+ * @param appDir - directory containing package.json and HTML file (defaults to cwd)
+ * @param htmlFile - HTML filename to update (auto-detected if omitted)
+ * @returns GenerateResult with resolved dependency directories
+ */
+export function importgen(appDir, htmlFile) {
+    const dir = appDir || process.cwd();
+    const pkgPath = path.join(dir, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        throw new Error(`package.json not found in ${dir}`);
     }
-    else {
-        console.error(`${ts()} [generate-importmap] Error: No HTML file found. Looking for: ${possibleHtmlFiles.join(', ')}`);
+    const possibleHtmlFiles = ['index.html', 'default.html', 'default.htm'];
+    const htmlName = htmlFile || possibleHtmlFiles.find(f => fs.existsSync(path.join(dir, f)));
+    const htmlPath = htmlName ? path.join(dir, htmlName) : null;
+    if (!htmlPath || !fs.existsSync(htmlPath)) {
+        throw new Error(htmlFile
+            ? `${htmlFile} not found in ${dir}`
+            : `No HTML file found in ${dir}. Looking for: ${possibleHtmlFiles.join(', ')}`);
     }
-    process.exit(1);
+    return generateImportMap(pkgPath, htmlPath);
 }
-if (watchMode) {
-    let result = generateImportMap(packageJsonPath, htmlFilePath);
-    let watchedDepDirs = new Set();
-    const watcher = chokidar.watch([packageJsonPath], {
-        persistent: true,
-        ignoreInitial: true
-    });
-    /** Update watcher to include/remove dependency directories */
-    function syncWatchedDeps(depDirs) {
-        const newDirs = new Set(depDirs);
-        // Remove dirs no longer in dependency list
-        for (const dir of watchedDepDirs) {
-            if (!newDirs.has(dir)) {
-                watcher.unwatch(dir);
-            }
+// CLI entry point
+if (import.meta.main) {
+    const args = process.argv.slice(2);
+    if (args.includes('-v') || args.includes('--version')) {
+        console.log(`importgen ${packageJson.version}`);
+        process.exit(0);
+    }
+    const knownFlags = new Set(['-w', '--watch', '-v', '--version']);
+    const unknownArgs = args.filter(a => a.startsWith('-') && !knownFlags.has(a));
+    if (unknownArgs.length > 0) {
+        console.error(`${ts()} [importgen] Error: unrecognized argument(s): ${unknownArgs.join(', ')}`);
+        console.error(`  Usage: importgen [htmlfile] [-w|--watch] [-v|--version]`);
+        process.exit(1);
+    }
+    const watchMode = args.includes('-w') || args.includes('--watch');
+    const positionalArgs = args.filter(a => !a.startsWith('-'));
+    if (positionalArgs.length > 1) {
+        console.error(`${ts()} [importgen] Error: too many arguments: ${positionalArgs.join(', ')}`);
+        console.error(`  Usage: importgen [htmlfile] [-w|--watch] [-v|--version]`);
+        process.exit(1);
+    }
+    const htmlArg = positionalArgs[0];
+    const packageJsonPath = path.join(process.cwd(), 'package.json');
+    const possibleHtmlFiles = ['index.html', 'default.html', 'default.htm'];
+    const htmlFileName = htmlArg || possibleHtmlFiles.find(f => fs.existsSync(path.join(process.cwd(), f)));
+    const htmlFilePath = htmlFileName ? path.join(process.cwd(), htmlFileName) : null;
+    if (!fs.existsSync(packageJsonPath)) {
+        console.error(`${ts()} [generate-importmap] Error: package.json not found in current directory`);
+        process.exit(1);
+    }
+    if (!htmlFilePath || !fs.existsSync(htmlFilePath)) {
+        if (htmlArg) {
+            console.error(`${ts()} [generate-importmap] Error: ${htmlArg} not found in current directory`);
         }
-        // Add new dirs
-        for (const dir of newDirs) {
-            if (!watchedDepDirs.has(dir)) {
-                watcher.add(dir);
-            }
+        else {
+            console.error(`${ts()} [generate-importmap] Error: No HTML file found. Looking for: ${possibleHtmlFiles.join(', ')}`);
         }
-        watchedDepDirs = newDirs;
+        process.exit(1);
     }
-    syncWatchedDeps(result.depDirs);
-    let debounceTimer = null;
-    const onChange = () => {
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(() => {
-            result = generateImportMap(packageJsonPath, htmlFilePath);
-            syncWatchedDeps(result.depDirs);
-        }, 100);
-    };
-    watcher.on('change', onChange);
-    watcher.on('add', onChange);
-    watcher.on('unlink', onChange);
-    watcher.on('ready', () => {
-        const total = 1 + watchedDepDirs.size;
-        console.log(`${ts()} [generate-importmap] Watching ${total} directories for changes...`);
-        if (watchedDepDirs.size > 0) {
+    if (watchMode) {
+        let result = generateImportMap(packageJsonPath, htmlFilePath);
+        let watchedDepDirs = new Set();
+        const watcher = chokidar.watch([packageJsonPath], {
+            persistent: true,
+            ignoreInitial: true
+        });
+        function syncWatchedDeps(depDirs) {
+            const newDirs = new Set(depDirs);
             for (const dir of watchedDepDirs) {
-                console.log(`  ${dir}`);
+                if (!newDirs.has(dir)) {
+                    watcher.unwatch(dir);
+                }
             }
+            for (const dir of newDirs) {
+                if (!watchedDepDirs.has(dir)) {
+                    watcher.add(dir);
+                }
+            }
+            watchedDepDirs = newDirs;
         }
-    });
-    watcher.on('error', (error) => {
-        console.error(`${ts()} [generate-importmap] Watcher error:`, error.message);
-    });
-}
-else {
-    generateImportMap(packageJsonPath, htmlFilePath);
+        syncWatchedDeps(result.depDirs);
+        let debounceTimer = null;
+        const onChange = () => {
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+                result = generateImportMap(packageJsonPath, htmlFilePath);
+                syncWatchedDeps(result.depDirs);
+            }, 100);
+        };
+        watcher.on('change', onChange);
+        watcher.on('add', onChange);
+        watcher.on('unlink', onChange);
+        watcher.on('ready', () => {
+            const total = 1 + watchedDepDirs.size;
+            console.log(`${ts()} [generate-importmap] Watching ${total} directories for changes...`);
+            if (watchedDepDirs.size > 0) {
+                for (const dir of watchedDepDirs) {
+                    console.log(`  ${dir}`);
+                }
+            }
+        });
+        watcher.on('error', (error) => {
+            console.error(`${ts()} [generate-importmap] Watcher error:`, error.message);
+        });
+    }
+    else {
+        generateImportMap(packageJsonPath, htmlFilePath);
+    }
 }
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@bobfrankston/importgen",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Generate ES Module import maps from package.json dependencies for native browser module loading",
   "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
   "bin": {
     "importgen": "index.js"
   },
   "type": "module",
   "scripts": {
+    "start": "node index.js --watch",
     "build": "tsc",
     "watch": "tsc -w",
     "preversion": "npm run build",

package/.claude/settings.local.json

@@ -1,17 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm run build:*)",
-      "Bash(npmglobalize)",
-      "Bash(npx tsc)",
-      "Bash(node index.js:*)",
-      "Bash(dir:*)",
-      "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 && npx tsc --noEmit 2>&1)",
-      "Bash(cd:*)"
-    ]
-  }
-}