esm-imports-analyzer 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Patricio Palladino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,7 +4,7 @@ A CLI tool that captures all ESM imports during a Node.js application's executio
 
 ![ESM Imports Analyzer](screenshot.png)
 
-[Live demo](TODO)
+[Live demo](https://patriciopalladino.com/esm-imports-analyzer/)
 
 ## Usage
 
@@ -58,23 +58,23 @@ The generated report is a single HTML file with:
 
 ### Graph interactions
 
-| Action | Effect |
-|--------|--------|
-| Click a node | Select it. Highlights outgoing imports (blue), incoming importers (green), and cycle edges (yellow). Everything else dims. |
-| Shift-click | Toggle a node in/out of the selection without affecting other selected nodes. |
-| Double-click a package | Expand or collapse it. |
-| Double-click a folder | Expand it (show its children inside the package). |
-| Double-click a module | Zoom into it. |
-| Double-click empty space | Zoom to fit the entire graph. |
-| Right-click any node | Context menu: expand importer/imported files, copy absolute path, copy full import chain from root. |
-| Hover a module | Tooltip with full path and import time. |
+| Action                   | Effect                                                                                                                     |
+| ------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
+| Click a node             | Select it. Highlights outgoing imports (blue), incoming importers (green), and cycle edges (yellow). Everything else dims. |
+| Shift-click              | Toggle a node in/out of the selection without affecting other selected nodes.                                              |
+| Double-click a package   | Expand or collapse it.                                                                                                     |
+| Double-click a folder    | Expand it (show its children inside the package).                                                                          |
+| Double-click a module    | Zoom into it.                                                                                                              |
+| Double-click empty space | Zoom to fit the entire graph.                                                                                              |
+| Right-click any node     | Context menu: expand importer/imported files, copy absolute path, copy full import chain from root.                        |
+| Hover a module           | Tooltip with full path and import time.                                                                                    |
 
 ### Other UI elements
 
 - **Cycles panel** (left sidebar) — lists all circular dependencies. Click one to reveal and highlight its members with orange.
 - **Table** (bottom, resizable) — shows the slowest modules. Click a row to focus on it in the graph. Sortable by import time, import count, or name.
 - **Expand all / Collapse all** — buttons in the header.
-- **Auto re-layout** — checkbox (default: on). When enabled, the graph layout recomputes automatically after every expand/collapse. Disable it to manually control when layout runs via the Re-layout button.
+- **Auto re-layout** — checkbox (default: on). When enabled, the graph layout recomputes automatically after every expand/collapse. Disable it to manually control when layout runs via the Re-layout button. Useful for very large graphs where automatic layout can be slow.
 
 ## How it works
 
@@ -84,11 +84,11 @@ The generated report is a single HTML file with:
 
    ```js
    // Your module's source
-   import { foo } from './bar.js';
+   import { foo } from "./bar.js";
    doSomething();
 
    // Injected at the end:
-   ;globalThis.__esm_analyzer_import_done__("<module-url>");
+   globalThis.__esm_analyzer_import_done__("<module-url>");
    ```
 
 3. When the module finishes evaluating — after all its static dependencies have been resolved, loaded, and evaluated, and its own top-level code has run — the injected callback fires and records the elapsed time since the resolve hook started. This gives the **total import time**: the full wall-clock cost of importing that module, including everything it triggers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esm-imports-analyzer",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A tool to generate an HTML visualization of the imports of an ESM Node.js application. It executes the application, tracks the imports during runtime, and creates the visualization after the execution is complete.",
   "keywords": [
     "node",
@@ -10,8 +10,10 @@
     "optimization"
   ],
   "author": "Patricio Palladino <email@patriciopalladino.com>",
+  "repository": "github:alcuadrado/esm-imports-analyzer",
   "license": "MIT",
   "type": "module",
+  "packageManager": "pnpm@10.33.0",
   "bin": {
     "esm-imports-analyzer": "dist/cli.js"
   },
@@ -19,15 +21,17 @@
   "files": [
     "dist"
   ],
-  "devDependencies": {
-    "@types/node": "^25.5.0",
-    "typescript": "^6.0.2"
-  },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "build": "rm -rf dist && tsc && cp -r src/report/ui dist/report/ui && cp src/report/template.html dist/report/template.html",
+    "pretest": "bash scripts/pretest.sh",
     "test": "node --test test/**/*.test.ts",
     "test:unit": "node --test test/unit/**/*.test.ts",
-    "test:integration": "node --test test/integration/**/*.test.ts"
+    "test:integration": "node --test test/integration/**/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
   }
-}
+}