esm-imports-analyzer 0.1.0

package/README.md

@@ -0,0 +1,113 @@
+# ESM Imports Analyzer
+
+A CLI tool that captures all ESM imports during a Node.js application's execution and generates a self-contained HTML report with an interactive dependency graph and timing data.
+
+![ESM Imports Analyzer](screenshot.png)
+
+[Live demo](TODO)
+
+## Usage
+
+Requires **Node.js 24+**.
+
+### Install
+
+```bash
+npm install -D esm-imports-analyzer
+```
+
+### Run
+
+```bash
+npx esm-imports-analyzer -- node app.js
+```
+
+The `--` separator is required. Everything after it is the command to analyze.
+
+```bash
+# Analyze a test suite
+npx esm-imports-analyzer -- node --test test/run-all.js
+
+# Analyze a CLI tool
+npx esm-imports-analyzer -- node_modules/.bin/hardhat compile
+
+# Custom output path
+npx esm-imports-analyzer -o report.html -- node app.js
+```
+
+> **Avoid using `npx`, `pnpm`, `bunx`, etc. after `--`** — they are Node.js processes themselves and will be measured. Use `node_modules/.bin/<tool>` or `node <script>` directly instead.
+
+### Options
+
+```
+--output, -o <path>   Output HTML report path (default: ./esm-imports-report.html)
+--help, -h            Show help
+--version, -v         Show version
+```
+
+## Features
+
+The generated report is a single HTML file with:
+
+- **Dependency graph** — interactive visualization of all module imports, grouped by package
+- **Import time** — wall-clock time to fully import each module (resolve + load + parse + dependencies + top-level execution)
+- **Circular dependency detection** — found via Tarjan's strongly connected components algorithm
+- **Package grouping** — modules grouped by `package.json` boundaries with collapsible folder hierarchy
+- **Slowest modules table** — sortable by import time or recursive import count
+- **Search** — highlight matching modules across the graph
+
+### 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. |
+
+### 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.
+
+## How it works
+
+1. The CLI prepends `--import=<register.ts>` to `NODE_OPTIONS` and spawns your command as a child process. This injects a loader hook into the Node.js runtime without modifying your code.
+
+2. The loader uses `module.registerHooks()` (Node 24's in-thread hooks API) to intercept every `resolve` and `load` call. On each `resolve`, it records a timestamp. On each `load`, it appends a small callback invocation to the module's source code:
+
+   ```js
+   // Your module's source
+   import { foo } from './bar.js';
+   doSomething();
+
+   // Injected at the end:
+   ;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.
+
+4. On process exit, all collected data is written to a temporary JSON file.
+
+5. The CLI reads that file and runs the analysis pipeline: builds the import tree, detects cycles (Tarjan's SCC), groups modules by package, computes the folder hierarchy, and ranks modules by import time.
+
+6. The result is assembled into a single self-contained HTML file. The graph is rendered client-side using [Cytoscape.js](https://js.cytoscape.org/) with [dagre](https://github.com/dagrejs/dagre) layout computed in a Web Worker.
+
+## Known limitations
+
+- **Node.js 24+ required** — uses `module.registerHooks()`, available since Node 24.
+- **ESM entry point required** — the project being analyzed must use ESM (`"type": "module"` or `.mjs` entry). CJS modules imported from ESM are measured correctly.
+- **Modules that throw** — if a module throws during evaluation, the injected callback never runs, so its import time won't be recorded.
+- **Top-level await** — import time includes time spent suspended in `await`. This is technically correct (it's real time your app waits) but can make async modules look disproportionately slow.
+- **Process must exit cleanly** — import data is flushed via `beforeExit`/`exit` event handlers. If the process is killed with `SIGKILL` or exits in a way that skips these handlers, data may be lost.
+- **CDN dependency** — the HTML report loads Cytoscape.js from [unpkg](https://unpkg.com/) on first open. After that, the browser cache handles it.
+
+## License
+
+MIT - Patricio Palladino

package/dist/analysis/cycle-detector.d.ts

@@ -0,0 +1,3 @@
+import type { ImportRecord, Cycle } from '../types.ts';
+export declare function detectCycles(records: ImportRecord[]): Cycle[];
+//# sourceMappingURL=cycle-detector.d.ts.map

package/dist/analysis/cycle-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-detector.d.ts","sourceRoot":"","sources":["../../src/analysis/cycle-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAiHvD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAa7D"}

package/dist/analysis/cycle-detector.js

@@ -0,0 +1,111 @@
+// Build adjacency list from import records
+function buildAdjacencyList(records) {
+    const graph = new Map();
+    for (const record of records) {
+        if (!graph.has(record.resolvedURL)) {
+            graph.set(record.resolvedURL, new Set());
+        }
+        if (record.parentURL !== null) {
+            if (!graph.has(record.parentURL)) {
+                graph.set(record.parentURL, new Set());
+            }
+            graph.get(record.parentURL).add(record.resolvedURL);
+        }
+    }
+    return graph;
+}
+// Tarjan's SCC algorithm
+function tarjanSCC(graph) {
+    let index = 0;
+    const stack = [];
+    const onStack = new Set();
+    const indices = new Map();
+    const lowlinks = new Map();
+    const sccs = [];
+    function strongconnect(v) {
+        indices.set(v, index);
+        lowlinks.set(v, index);
+        index++;
+        stack.push(v);
+        onStack.add(v);
+        const neighbors = graph.get(v) ?? new Set();
+        for (const w of neighbors) {
+            if (!indices.has(w)) {
+                strongconnect(w);
+                lowlinks.set(v, Math.min(lowlinks.get(v), lowlinks.get(w)));
+            }
+            else if (onStack.has(w)) {
+                lowlinks.set(v, Math.min(lowlinks.get(v), indices.get(w)));
+            }
+        }
+        if (lowlinks.get(v) === indices.get(v)) {
+            const scc = [];
+            let w;
+            do {
+                w = stack.pop();
+                onStack.delete(w);
+                scc.push(w);
+            } while (w !== v);
+            sccs.push(scc);
+        }
+    }
+    for (const v of graph.keys()) {
+        if (!indices.has(v)) {
+            strongconnect(v);
+        }
+    }
+    return sccs;
+}
+// Extract individual cycles from SCCs using DFS
+function extractCycles(scc, graph) {
+    if (scc.length === 1) {
+        const node = scc[0];
+        const neighbors = graph.get(node) ?? new Set();
+        if (neighbors.has(node)) {
+            return [{ modules: [node], length: 1 }];
+        }
+        return [];
+    }
+    const sccSet = new Set(scc);
+    const cycles = [];
+    const visited = new Set();
+    function dfs(start, current, path) {
+        const neighbors = graph.get(current) ?? new Set();
+        for (const next of neighbors) {
+            if (!sccSet.has(next))
+                continue;
+            if (next === start && path.length > 0) {
+                cycles.push({ modules: [...path], length: path.length });
+            }
+            else if (!visited.has(next) && !path.includes(next)) {
+                dfs(start, next, [...path, next]);
+            }
+        }
+    }
+    for (const node of scc) {
+        visited.clear();
+        dfs(node, node, [node]);
+        visited.add(node);
+    }
+    // Deduplicate cycles (same set of nodes in different rotations)
+    const unique = new Map();
+    for (const cycle of cycles) {
+        const key = [...cycle.modules].sort().join('\0');
+        if (!unique.has(key) || cycle.length < unique.get(key).length) {
+            unique.set(key, cycle);
+        }
+    }
+    return [...unique.values()];
+}
+export function detectCycles(records) {
+    const graph = buildAdjacencyList(records);
+    const sccs = tarjanSCC(graph);
+    const cycles = [];
+    for (const scc of sccs) {
+        cycles.push(...extractCycles(scc, graph));
+    }
+    // Sort by cycle length (shortest first)
+    cycles.sort((a, b) => a.length - b.length);
+    return cycles;
+}
+//# sourceMappingURL=cycle-detector.js.map

package/dist/analysis/cycle-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-detector.js","sourceRoot":"","sources":["../../src/analysis/cycle-detector.ts"],"names":[],"mappings":"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"}

package/dist/analysis/folder-tree.d.ts

@@ -0,0 +1,3 @@
+import type { FolderTreeNode } from '../types.ts';
+export declare function buildFolderTree(groupId: string, packageDir: string, moduleURLs: string[]): FolderTreeNode[];
+//# sourceMappingURL=folder-tree.d.ts.map

package/dist/analysis/folder-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-tree.d.ts","sourceRoot":"","sources":["../../src/analysis/folder-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmGlD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAkD3G"}

package/dist/analysis/folder-tree.js

@@ -0,0 +1,141 @@
+import { relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+function makeRawFolder(name) {
+    return { name, children: new Map() };
+}
+function insertPath(root, segments, moduleURL) {
+    let current = root;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        if (!current.children.has(seg)) {
+            current.children.set(seg, makeRawFolder(seg));
+        }
+        current = current.children.get(seg);
+    }
+    const fileName = segments[segments.length - 1];
+    current.children.set(fileName, {
+        name: fileName,
+        children: new Map(),
+        moduleURL,
+    });
+}
+function sortNodes(nodes) {
+    return nodes.sort((a, b) => {
+        if (a.type !== b.type)
+            return a.type === 'folder' ? -1 : 1;
+        return a.label.localeCompare(b.label);
+    });
+}
+// Convert a raw trie node into a FolderTreeNode (no flattening yet)
+function rawToTree(groupId, node, relPath) {
+    if (node.moduleURL !== undefined) {
+        return {
+            id: node.moduleURL,
+            label: node.name,
+            type: 'file',
+            moduleURL: node.moduleURL,
+            children: [],
+        };
+    }
+    const children = [];
+    for (const child of node.children.values()) {
+        const childRel = relPath ? relPath + '/' + child.name : child.name;
+        children.push(rawToTree(groupId, child, childRel));
+    }
+    return {
+        id: 'ftree::' + groupId + '::' + relPath,
+        label: node.name,
+        type: 'folder',
+        children: sortNodes(children),
+    };
+}
+// Flatten a list of sibling nodes. For each folder that has exactly 1 child,
+// merge it with that child (concatenating labels). Repeat until stable.
+function flattenChildren(groupId, nodes) {
+    return sortNodes(nodes.map(node => flattenSingle(groupId, node)));
+}
+function joinLabel(a, b) {
+    return a ? a + '/' + b : b;
+}
+function flattenSingle(groupId, node) {
+    if (node.type === 'file')
+        return node;
+    let current = node;
+    // Walk down through single-child folders, accumulating the path
+    while (current.type === 'folder' && current.children.length === 1) {
+        const only = current.children[0];
+        const merged = joinLabel(current.label, only.label);
+        if (only.type === 'file') {
+            return { ...only, label: merged };
+        }
+        // Single folder child: merge labels and continue
+        current = {
+            ...only,
+            label: merged,
+            id: 'ftree::' + groupId + '::' + merged,
+            children: only.children,
+        };
+    }
+    // current now has 0 or 2+ children — flatten each child recursively
+    return {
+        ...current,
+        children: flattenChildren(groupId, current.children),
+    };
+}
+export function buildFolderTree(groupId, packageDir, moduleURLs) {
+    const root = makeRawFolder('');
+    for (const url of moduleURLs) {
+        if (!url.startsWith('file://'))
+            continue;
+        let filePath;
+        try {
+            filePath = fileURLToPath(url);
+        }
+        catch {
+            continue;
+        }
+        const rel = relative(packageDir, filePath);
+        if (rel.startsWith('..') || rel.startsWith('/'))
+            continue;
+        const segments = rel.split('/').filter(s => s.length > 0);
+        if (segments.length === 0)
+            continue;
+        insertPath(root, segments, url);
+    }
+    // Convert to typed tree (root is virtual, we take its children)
+    const topLevel = [];
+    for (const child of root.children.values()) {
+        topLevel.push(rawToTree(groupId, child, child.name));
+    }
+    // Treat the virtual root like a folder and apply the same flatten logic:
+    // if exactly 1 child, merge through it.
+    const virtualRoot = {
+        id: '',
+        label: '',
+        type: 'folder',
+        children: sortNodes(topLevel),
+    };
+    const flattened = flattenSingle(groupId, virtualRoot);
+    if (flattened.type === 'file') {
+        // Entire package is a single file
+        return [flattened];
+    }
+    // If the virtual root was flattened (label is non-empty), we absorbed
+    // intermediate folders. Prefix all children's labels with that path.
+    if (flattened.label) {
+        return flattened.children.map(child => prefixNode(groupId, flattened.label, child));
+    }
+    return flattened.children;
+}
+function prefixNode(groupId, prefix, node) {
+    const label = prefix + '/' + node.label;
+    if (node.type === 'file') {
+        return { ...node, label };
+    }
+    return {
+        ...node,
+        label,
+        id: 'ftree::' + groupId + '::' + label,
+    };
+}
+//# sourceMappingURL=folder-tree.js.map

package/dist/analysis/folder-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-tree.js","sourceRoot":"","sources":["../../src/analysis/folder-tree.ts"],"names":[],"mappings":"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"}

package/dist/analysis/grouper.d.ts

@@ -0,0 +1,4 @@
+import type { ImportRecord, Group } from '../types.ts';
+export declare function groupModules(records: ImportRecord[]): Group[];
+export declare function clearPackageJsonCache(): void;
+//# sourceMappingURL=grouper.d.ts.map

package/dist/analysis/grouper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouper.d.ts","sourceRoot":"","sources":["../../src/analysis/grouper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA4EvD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CA2F7D;AAGD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/analysis/grouper.js

@@ -0,0 +1,156 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildFolderTree } from "./folder-tree.js";
+const packageJsonCache = new Map();
+function getNodeModulesPackageRoot(dir) {
+    const SEP = '/node_modules/';
+    const lastNM = dir.lastIndexOf(SEP);
+    if (lastNM === -1)
+        return null;
+    const afterNM = dir.substring(lastNM + SEP.length);
+    const parts = afterNM.split('/');
+    if (parts.length === 0 || parts[0] === '')
+        return null;
+    // Scoped package: @scope/pkg
+    if (parts[0].startsWith('@')) {
+        if (parts.length < 2)
+            return null;
+        return dir.substring(0, lastNM) + SEP + parts[0] + '/' + parts[1];
+    }
+    // Regular package: pkg
+    return dir.substring(0, lastNM) + SEP + parts[0];
+}
+function findPackageJson(dir) {
+    if (packageJsonCache.has(dir)) {
+        return packageJsonCache.get(dir);
+    }
+    // For paths inside node_modules, jump directly to the package root
+    // instead of walking up and potentially hitting nested package.json files.
+    const nmRoot = getNodeModulesPackageRoot(dir);
+    if (nmRoot !== null && nmRoot !== dir) {
+        const result = findPackageJson(nmRoot);
+        packageJsonCache.set(dir, result);
+        return result;
+    }
+    const pkgPath = join(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const content = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            const name = (typeof content['name'] === 'string' ? content['name'] : dirname(dir).split('/').pop());
+            const isNodeModules = dir.includes('node_modules');
+            const info = {
+                name,
+                dir,
+                packageJsonPath: pkgPath,
+                isNodeModules,
+            };
+            packageJsonCache.set(dir, info);
+            return info;
+        }
+        catch {
+            // Invalid package.json, keep searching
+        }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) {
+        // Reached filesystem root
+        packageJsonCache.set(dir, null);
+        return null;
+    }
+    const result = findPackageJson(parent);
+    packageJsonCache.set(dir, result);
+    return result;
+}
+export function groupModules(records) {
+    const groupMap = new Map();
+    const seenURLs = new Set();
+    for (const record of records) {
+        const url = record.resolvedURL;
+        if (seenURLs.has(url))
+            continue;
+        seenURLs.add(url);
+        // Handle node: builtins
+        if (url.startsWith('node:')) {
+            const id = 'node-builtins';
+            if (!groupMap.has(id)) {
+                groupMap.set(id, {
+                    id,
+                    label: 'Node.js Builtins',
+                    packageJsonPath: '',
+                    modules: [],
+                    isNodeModules: false,
+                });
+            }
+            groupMap.get(id).modules.push(url);
+            continue;
+        }
+        // Handle data: URLs
+        if (url.startsWith('data:')) {
+            const id = 'inline-modules';
+            if (!groupMap.has(id)) {
+                groupMap.set(id, {
+                    id,
+                    label: 'Inline Modules',
+                    packageJsonPath: '',
+                    modules: [],
+                    isNodeModules: false,
+                });
+            }
+            groupMap.get(id).modules.push(url);
+            continue;
+        }
+        // Handle file: URLs
+        if (url.startsWith('file://')) {
+            let filePath;
+            try {
+                filePath = fileURLToPath(url);
+            }
+            catch {
+                continue;
+            }
+            const dir = dirname(filePath);
+            const pkgInfo = findPackageJson(dir);
+            if (pkgInfo) {
+                const id = resolve(pkgInfo.dir);
+                if (!groupMap.has(id)) {
+                    groupMap.set(id, {
+                        id,
+                        label: pkgInfo.name,
+                        packageJsonPath: pkgInfo.packageJsonPath,
+                        modules: [],
+                        isNodeModules: pkgInfo.isNodeModules,
+                    });
+                }
+                groupMap.get(id).modules.push(url);
+            }
+            else {
+                const id = 'ungrouped';
+                if (!groupMap.has(id)) {
+                    groupMap.set(id, {
+                        id,
+                        label: 'Ungrouped',
+                        packageJsonPath: '',
+                        modules: [],
+                        isNodeModules: false,
+                    });
+                }
+                groupMap.get(id).modules.push(url);
+            }
+        }
+    }
+    const groups = [...groupMap.values()];
+    // Build folder trees for groups that have a package directory
+    for (const group of groups) {
+        if (group.packageJsonPath) {
+            const packageDir = dirname(group.packageJsonPath);
+            group.folderTree = buildFolderTree(group.id, packageDir, group.modules);
+        }
+    }
+    return groups;
+}
+// Clear the cache (useful for testing)
+export function clearPackageJsonCache() {
+    packageJsonCache.clear();
+}
+//# sourceMappingURL=grouper.js.map

package/dist/analysis/grouper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouper.js","sourceRoot":"","sources":["../../src/analysis/grouper.ts"],"names":[],"mappings":"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"}

package/dist/analysis/timing.d.ts

@@ -0,0 +1,9 @@
+import type { ImportRecord } from '../types.ts';
+export interface TimingEntry {
+    resolvedURL: string;
+    specifier: string;
+    totalTime: number;
+}
+export declare function computeRankedList(records: ImportRecord[]): TimingEntry[];
+export declare function computeTotalTime(records: ImportRecord[]): number;
+//# sourceMappingURL=timing.d.ts.map

package/dist/analysis/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/analysis/timing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAoBxE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAahE"}

package/dist/analysis/timing.js

@@ -0,0 +1,37 @@
+export function computeRankedList(records) {
+    // Use first occurrence of each module (subsequent imports are cached)
+    const seen = new Set();
+    const entries = [];
+    for (const record of records) {
+        if (!seen.has(record.resolvedURL)) {
+            seen.add(record.resolvedURL);
+            entries.push({
+                resolvedURL: record.resolvedURL,
+                specifier: record.specifier,
+                totalTime: record.totalImportTime ?? 0,
+            });
+        }
+    }
+    // Sort descending by totalTime, stable sort preserves insertion order for equal times
+    entries.sort((a, b) => b.totalTime - a.totalTime);
+    return entries;
+}
+export function computeTotalTime(records) {
+    if (records.length === 0)
+        return 0;
+    let minStart = Infinity;
+    let maxEnd = -Infinity;
+    for (const record of records) {
+        if (record.importStartTime < minStart)
+            minStart = record.importStartTime;
+        if (record.totalImportTime !== undefined) {
+            const end = record.importStartTime + record.totalImportTime;
+            if (end > maxEnd)
+                maxEnd = end;
+        }
+    }
+    if (maxEnd === -Infinity)
+        return 0;
+    return maxEnd - minStart;
+}
+//# sourceMappingURL=timing.js.map

package/dist/analysis/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/analysis/timing.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,sEAAsE;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC;gBACX,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAElD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,IAAI,MAAM,GAAG,CAAC,QAAQ,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,eAAe,GAAG,QAAQ;YAAE,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC;QACzE,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;YAC5D,IAAI,GAAG,GAAG,MAAM;gBAAE,MAAM,GAAG,GAAG,CAAC;QACjC,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,MAAM,GAAG,QAAQ,CAAC;AAC3B,CAAC"}

package/dist/analysis/tree-builder.d.ts

@@ -0,0 +1,3 @@
+import type { ImportRecord, ModuleNode } from '../types.ts';
+export declare function buildTree(records: ImportRecord[]): ModuleNode[];
+//# sourceMappingURL=tree-builder.d.ts.map

package/dist/analysis/tree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-builder.d.ts","sourceRoot":"","sources":["../../src/analysis/tree-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,UAAU,EAAE,CA+C/D"}