tdepend 0.2.0 → 0.3.1

package/dist/files/collectFiles.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SKIPS = void 0;
+exports.collectFiles = collectFiles;
+exports.createExcludeMatcher = createExcludeMatcher;
+const node_path_1 = require("node:path");
+const picomatch_1 = __importDefault(require("picomatch"));
+const fs_1 = require("../fs");
+const gitignore_1 = require("../project/gitignore");
+exports.DEFAULT_SKIPS = [
+    '**/*.{test,spec}.*',
+    '**/__tests__/**',
+    '**/*.stories.*',
+    '**/*.d.ts',
+    '**/*.d.mts',
+    '**/*.d.cts',
+    '**/*.min.js',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/public/**',
+    'e2e/**',
+];
+const SOURCE_FILE = /\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs)$/;
+const DECLARATION_FILE = /\.d\.(?:ts|mts|cts)$/;
+function collectFiles(ctx, opts) {
+    const fs = opts.fs ?? (0, fs_1.nodeFileSystem)();
+    const isExcluded = createExcludeMatcher(opts.presetSkips, opts.exclude);
+    const matchesInclude = opts.include.length === 0 ? null : (0, picomatch_1.default)(opts.include, { dot: true });
+    const { candidates, skipped: walkSkipped } = discoverCandidates(fs, ctx, matchesInclude);
+    const { files, skipped: admitSkipped } = admitCandidates(fs, ctx, candidates, isExcluded);
+    const skipped = [...walkSkipped, ...admitSkipped];
+    const covered = coveredFiles(fs, ctx);
+    const uncovered = files.filter((file) => !covered.has(file));
+    files.sort();
+    uncovered.sort();
+    skipped.sort(compareSkipped);
+    return { files, uncovered, skipped };
+}
+function discoverCandidates(fs, ctx, matchesInclude) {
+    const root = ctx.rootDir;
+    const candidates = new Map();
+    const skipped = [];
+    if (matchesInclude === null) {
+        for (const entry of ctx.tsconfigs) {
+            for (const file of entry.fileNames) {
+                if (SOURCE_FILE.test(file))
+                    candidates.set(file, (0, node_path_1.join)(root, file));
+            }
+        }
+    }
+    walkSourceFiles(fs, root, matchesInclude, {
+        onFile: (rel, abs) => candidates.set(rel, abs),
+        onOutside: (rel) => skipped.push({ file: rel, reason: 'outside-root' }),
+    });
+    return { candidates, skipped };
+}
+function admitCandidates(fs, ctx, candidates, isExcluded) {
+    const root = ctx.rootDir;
+    const files = [];
+    const skipped = [];
+    const seen = new Set();
+    for (const [rel, abs] of candidates) {
+        if (!(0, fs_1.isFile)(fs, abs))
+            continue;
+        const realRel = realRelative(fs, root, abs);
+        if (realRel === null) {
+            skipped.push({ file: rel, reason: 'outside-root' });
+            continue;
+        }
+        const reason = skipReasonFor(ctx, isExcluded, rel, abs);
+        if (reason !== null) {
+            skipped.push({ file: rel, reason });
+            continue;
+        }
+        if (seen.has(realRel))
+            continue;
+        seen.add(realRel);
+        files.push(realRel);
+    }
+    return { files, skipped };
+}
+function skipReasonFor(ctx, isExcluded, rel, abs) {
+    if (DECLARATION_FILE.test(rel))
+        return 'declaration';
+    if (isExcluded(rel))
+        return 'excluded';
+    if (ctx.isIgnored(abs))
+        return 'gitignored';
+    return null;
+}
+function walkSourceFiles(fs, root, matchesInclude, handlers) {
+    visitDirectory({ fs, root, matchesInclude, handlers }, root);
+}
+function visitDirectory(ctx, dir) {
+    let entries;
+    try {
+        entries = ctx.fs.readdir(dir);
+    }
+    catch {
+        return;
+    }
+    entries.sort();
+    for (const name of entries) {
+        const abs = (0, node_path_1.join)(dir, name);
+        const stats = (0, fs_1.tryStat)(ctx.fs, abs);
+        if (stats === null)
+            continue;
+        const rel = (0, fs_1.toPosix)((0, node_path_1.relative)(ctx.root, abs));
+        if (stats.isDirectory()) {
+            if ((0, gitignore_1.shouldSkipDir)(name))
+                continue;
+            if (realRelative(ctx.fs, ctx.root, abs) === null)
+                ctx.handlers.onOutside(rel);
+            else
+                visitDirectory(ctx, abs);
+        }
+        else if (stats.isFile()) {
+            visitFile(ctx, { abs, name, rel });
+        }
+    }
+}
+function visitFile(ctx, entry) {
+    if (!SOURCE_FILE.test(entry.name))
+        return;
+    if (realRelative(ctx.fs, ctx.root, entry.abs) === null) {
+        ctx.handlers.onOutside(entry.rel);
+        return;
+    }
+    if (ctx.matchesInclude !== null && !ctx.matchesInclude(entry.rel))
+        return;
+    ctx.handlers.onFile(entry.rel, entry.abs);
+}
+function createExcludeMatcher(presetSkips, exclude) {
+    const effective = [];
+    for (const pattern of [...presetSkips, ...exclude]) {
+        if (pattern === '')
+            continue;
+        if (pattern.startsWith('!')) {
+            const index = effective.indexOf(pattern.slice(1));
+            if (index >= 0)
+                effective.splice(index, 1);
+            continue;
+        }
+        if (!effective.includes(pattern))
+            effective.push(pattern);
+    }
+    if (effective.length === 0)
+        return () => false;
+    const match = (0, picomatch_1.default)(effective, { dot: true });
+    return (rel) => match(rel);
+}
+function coveredFiles(fs, ctx) {
+    const covered = new Set();
+    for (const entry of ctx.tsconfigs) {
+        for (const file of entry.fileNames) {
+            covered.add(file);
+            const realRel = realRelative(fs, ctx.rootDir, (0, node_path_1.join)(ctx.rootDir, file));
+            if (realRel !== null)
+                covered.add(realRel);
+        }
+    }
+    return covered;
+}
+function realRelative(fs, root, abs) {
+    let real;
+    try {
+        real = fs.realpath(abs);
+    }
+    catch {
+        return null;
+    }
+    if (real === root)
+        return '';
+    if (!real.startsWith(root + node_path_1.sep))
+        return null;
+    return (0, fs_1.toPosix)(real.slice(root.length + 1));
+}
+function compareSkipped(a, b) {
+    if (a.file !== b.file)
+        return a.file < b.file ? -1 : 1;
+    if (a.reason !== b.reason)
+        return a.reason < b.reason ? -1 : 1;
+    return 0;
+}
+//# sourceMappingURL=collectFiles.js.map

package/dist/files/collectFiles.js.map

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

package/dist/fs.d.ts

@@ -0,0 +1,16 @@
+export type StatLike = {
+    isFile(): boolean;
+    isDirectory(): boolean;
+};
+export interface FileSystemLike {
+    readFile(path: string): string;
+    readdir(path: string): string[];
+    stat(path: string): StatLike;
+    realpath(path: string): string;
+}
+export declare function nodeFileSystem(): FileSystemLike;
+export declare function toPosix(path: string): string;
+export declare function tryRead(fs: FileSystemLike, path: string): string | null;
+export declare function tryStat(fs: FileSystemLike, path: string): StatLike | null;
+export declare function isDir(fs: FileSystemLike, path: string): boolean;
+export declare function isFile(fs: FileSystemLike, path: string): boolean;

package/dist/fs.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeFileSystem = nodeFileSystem;
+exports.toPosix = toPosix;
+exports.tryRead = tryRead;
+exports.tryStat = tryStat;
+exports.isDir = isDir;
+exports.isFile = isFile;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function nodeFileSystem() {
+    return {
+        readFile: (path) => stripBom((0, node_fs_1.readFileSync)(path, 'utf-8')),
+        readdir: (path) => (0, node_fs_1.readdirSync)(path),
+        stat: (path) => {
+            const stats = (0, node_fs_1.statSync)(path);
+            return { isFile: () => stats.isFile(), isDirectory: () => stats.isDirectory() };
+        },
+        realpath: (path) => node_fs_1.realpathSync.native(path),
+    };
+}
+function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+function toPosix(path) {
+    return node_path_1.sep === '/' ? path : path.split(node_path_1.sep).join('/');
+}
+function tryRead(fs, path) {
+    try {
+        return fs.readFile(path);
+    }
+    catch {
+        return null;
+    }
+}
+function tryStat(fs, path) {
+    try {
+        return fs.stat(path);
+    }
+    catch {
+        return null;
+    }
+}
+function isDir(fs, path) {
+    return tryStat(fs, path)?.isDirectory() ?? false;
+}
+function isFile(fs, path) {
+    return tryStat(fs, path)?.isFile() ?? false;
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":";;AAYA,wCAUC;AAMD,0BAEC;AAED,0BAMC;AAED,0BAMC;AAED,sBAEC;AAED,wBAEC;AAtDD,qCAA4E;AAC5E,yCAAgC;AAWhC,SAAgB,cAAc;IAC5B,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,qBAAW,EAAC,IAAI,CAAC;QACpC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAClF,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAY,CAAC,MAAM,CAAC,IAAI,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,eAAG,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAgB,OAAO,CAAC,EAAkB,EAAE,IAAY;IACtD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,OAAO,CAAC,EAAkB,EAAE,IAAY;IACtD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,KAAK,CAAC,EAAkB,EAAE,IAAY;IACpD,OAAO,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;AACnD,CAAC;AAED,SAAgB,MAAM,CAAC,EAAkB,EAAE,IAAY;IACrD,OAAO,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC;AAC9C,CAAC"}

package/dist/graph/buildFileGraph.d.ts

@@ -0,0 +1,33 @@
+import { type FileSystemLike } from '../fs';
+import type { CollectResult } from '../files/collectFiles';
+import { type Compiler } from '../parser/loadsTarget';
+import type { ImportSite, ParsedFile } from '../parser/types';
+import type { ProjectContext } from '../project/types';
+import type { Resolution, ResolutionClass, Resolver } from '../resolver/types';
+import { FileGraph } from './fileGraph';
+export declare const DEFAULT_COMPILERS: Compiler[];
+export interface SiteRecord {
+    file: string;
+    site: ImportSite;
+    resolution: Resolution;
+}
+export interface ResolutionReport {
+    stats: Record<ResolutionClass, number>;
+    unresolved: SiteRecord[];
+    ignoredByDir: Record<string, number>;
+    unsupported: SiteRecord[];
+    selfImports: string[];
+    uncovered: string[];
+    skipped: CollectResult['skipped'];
+}
+export interface BuildGraphResult {
+    graph: FileGraph;
+    sites: SiteRecord[];
+    report: ResolutionReport;
+    parsed: Map<string, ParsedFile>;
+}
+export interface BuildGraphOptions {
+    compilers?: Compiler[];
+    fs?: FileSystemLike;
+}
+export declare function buildFileGraph(ctx: ProjectContext, files: CollectResult, resolver: Resolver, typeOnly: 'usage' | 'syntax', options?: BuildGraphOptions): BuildGraphResult;

package/dist/graph/buildFileGraph.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_COMPILERS = void 0;
+exports.buildFileGraph = buildFileGraph;
+const node_path_1 = require("node:path");
+const errors_1 = require("../errors");
+const fs_1 = require("../fs");
+const extractSites_1 = require("../parser/extractSites");
+const loadsTarget_1 = require("../parser/loadsTarget");
+const workspaceHost_1 = require("../resolver/workspaceHost");
+const fileGraph_1 = require("./fileGraph");
+exports.DEFAULT_COMPILERS = ['tsc', 'esbuild', 'swc'];
+const RESOLUTION_CLASSES = [
+    'builtin',
+    'asset',
+    'virtual',
+    'internal',
+    'workspace',
+    'excluded',
+    'external',
+    'ignored',
+    'unsupported',
+    'unresolved',
+];
+function buildFileGraph(ctx, files, resolver, typeOnly, options = {}) {
+    const fs = options.fs ?? (0, fs_1.nodeFileSystem)();
+    const compilers = options.compilers ?? exports.DEFAULT_COMPILERS;
+    const parsed = new Map();
+    const sites = [];
+    const collector = emptyCollector();
+    for (const file of files.files) {
+        const { options: compilerOptions } = ctx.optionsFor(file);
+        const parsedFile = (0, extractSites_1.parseFile)(file, readSourceFile(fs, ctx.rootDir, file), compilerOptions, (0, node_path_1.join)(ctx.rootDir, file));
+        parsed.set(file, parsedFile);
+        const environment = {
+            resolver,
+            typeOnly,
+            compilers,
+            file,
+            parsedFile,
+            compilerOptions,
+        };
+        for (const site of parsedFile.sites) {
+            sites.push(collectSite(collector, environment, site));
+        }
+    }
+    return {
+        graph: new fileGraph_1.FileGraph(files.files, [...collector.edges.values()]),
+        sites,
+        report: buildReport(collector, files),
+        parsed,
+    };
+}
+// Classifies how a site loads, resolves it, and files the result under the class
+// it landed in, adding a graph edge only when the site names an analysed file.
+function collectSite(collector, environment, site) {
+    const { parsedFile, compilerOptions, typeOnly, compilers, resolver, file } = environment;
+    const verdict = (0, loadsTarget_1.classifyLoads)(parsedFile, site, compilerOptions, typeOnly, compilers);
+    site.loadsTarget = verdict.loadsTarget;
+    site.loadsTargetBy = verdict.loadsTargetBy;
+    site.loadReason = verdict.reason;
+    const resolution = resolver.resolve(site, parsedFile);
+    const record = { file, site, resolution };
+    collector.stats[resolution.class] += 1;
+    if (resolution.class === 'unresolved')
+        collector.unresolved.push(record);
+    if (resolution.class === 'unsupported')
+        collector.unsupported.push(record);
+    if (resolution.class === 'ignored' && resolution.reason === 'gitignored') {
+        recordIgnoredDirectory(collector.ignoredByDir, file, site.specifier);
+    }
+    addGraphEdge(collector, file, site, resolution);
+    return record;
+}
+function addGraphEdge(collector, file, site, resolution) {
+    const target = edgeTarget(resolution);
+    if (target === null)
+        return;
+    if (target === file) {
+        collector.selfImports.add(file);
+        return;
+    }
+    mergeEdge(collector.edges, file, target, site, resolution);
+}
+function recordIgnoredDirectory(ignoredByDir, file, specifier) {
+    const dir = targetDirectory(file, specifier);
+    if (dir === null)
+        return;
+    ignoredByDir.set(dir, (ignoredByDir.get(dir) ?? 0) + 1);
+}
+function buildReport(collector, files) {
+    return {
+        stats: collector.stats,
+        unresolved: collector.unresolved,
+        ignoredByDir: Object.fromEntries([...collector.ignoredByDir.entries()].sort()),
+        unsupported: collector.unsupported,
+        selfImports: [...collector.selfImports].sort(),
+        uncovered: files.uncovered,
+        skipped: files.skipped,
+    };
+}
+function emptyCollector() {
+    return {
+        stats: emptyStats(),
+        unresolved: [],
+        unsupported: [],
+        ignoredByDir: new Map(),
+        selfImports: new Set(),
+        edges: new Map(),
+    };
+}
+function emptyStats() {
+    const stats = {};
+    for (const resolutionClass of RESOLUTION_CLASSES)
+        stats[resolutionClass] = 0;
+    return stats;
+}
+// A collected file that cannot be read makes the whole analysis incomplete: its
+// imports would silently vanish from the graph. Fail loudly instead of skipping.
+function readSourceFile(fs, rootDir, file) {
+    try {
+        return fs.readFile((0, node_path_1.join)(rootDir, file));
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new errors_1.ParseError(`Cannot read source file ${file}: ${reason}`, file);
+    }
+}
+// Only the resolved-file classes that carry a graph edge. An `excluded` target
+// keeps its file for selectors, but it adds no edge.
+function edgeTarget(resolution) {
+    if (resolution.class !== 'internal' && resolution.class !== 'workspace')
+        return null;
+    const target = resolution.target;
+    if (target === null || !('file' in target))
+        return null;
+    return target.file;
+}
+function mergeEdge(edges, from, to, site, resolution) {
+    const key = `${from}\u0000${to}`;
+    const existing = edges.get(key);
+    if (existing !== undefined) {
+        existing.sites.push(site);
+        existing.runtime = existing.runtime || site.loadsTarget === true;
+        existing.mapped = existing.mapped || resolution.mapped !== undefined;
+        return;
+    }
+    edges.set(key, {
+        from,
+        to,
+        sites: [site],
+        runtime: site.loadsTarget === true,
+        mapped: resolution.mapped !== undefined,
+    });
+}
+function targetDirectory(file, specifier) {
+    const target = (0, workspaceHost_1.posixJoin)((0, workspaceHost_1.posixDirname)(file), specifier);
+    const dir = (0, workspaceHost_1.posixDirname)(target);
+    if (dir === '' || dir.startsWith('..'))
+        return null;
+    return `${dir}/`;
+}
+//# sourceMappingURL=buildFileGraph.js.map

package/dist/graph/buildFileGraph.js.map

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

package/dist/graph/fileGraph.d.ts

@@ -0,0 +1,20 @@
+import type { ImportSite } from '../parser/types';
+export interface FileEdge {
+    from: string;
+    to: string;
+    sites: ImportSite[];
+    runtime: boolean;
+    mapped: boolean;
+}
+export declare class FileGraph {
+    readonly id: string;
+    private readonly nodeList;
+    private readonly edgeList;
+    private readonly fromIndex;
+    private readonly toIndex;
+    constructor(files: string[], edges: FileEdge[]);
+    files(): string[];
+    edges(): FileEdge[];
+    edgesFrom(file: string): FileEdge[];
+    edgesTo(file: string): FileEdge[];
+}

package/dist/graph/fileGraph.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileGraph = void 0;
+const node_crypto_1 = require("node:crypto");
+// The file graph is the source every other level is aggregated from. Nodes are
+// root-relative file paths and edges hold every site between two files.
+class FileGraph {
+    constructor(files, edges) {
+        this.nodeList = [...files].sort();
+        this.edgeList = [...edges].sort(compareEdges);
+        this.fromIndex = indexBy(this.edgeList, (edge) => edge.from);
+        this.toIndex = indexBy(this.edgeList, (edge) => edge.to);
+        this.id = hashEdges(this.edgeList);
+    }
+    files() {
+        return [...this.nodeList];
+    }
+    edges() {
+        return [...this.edgeList];
+    }
+    edgesFrom(file) {
+        return [...(this.fromIndex.get(file) ?? [])];
+    }
+    edgesTo(file) {
+        return [...(this.toIndex.get(file) ?? [])];
+    }
+}
+exports.FileGraph = FileGraph;
+function compareEdges(a, b) {
+    if (a.from !== b.from)
+        return a.from < b.from ? -1 : 1;
+    if (a.to !== b.to)
+        return a.to < b.to ? -1 : 1;
+    return 0;
+}
+function indexBy(edges, key) {
+    const index = new Map();
+    for (const edge of edges) {
+        const value = key(edge);
+        const list = index.get(value);
+        if (list === undefined)
+            index.set(value, [edge]);
+        else
+            list.push(edge);
+    }
+    return index;
+}
+// Cache key for anything derived from the graph: the sorted edges plus the
+// filter-relevant shape of their sites. A source edit that moves a site between
+// filtering categories gets a new identity, so a cached cycle result is never
+// reused across it. Line and column stay out on purpose: editing above an import
+// must not churn the id.
+function hashEdges(edges) {
+    const canonical = edges.map((edge) => [
+        edge.from,
+        edge.to,
+        edge.runtime,
+        edge.mapped,
+        siteSignatures(edge.sites),
+    ]);
+    return (0, node_crypto_1.createHash)('sha1').update(JSON.stringify(canonical)).digest('hex');
+}
+function siteSignatures(sites) {
+    return sites
+        .map((site) => [site.kind, site.loadsTarget === true, site.deferred === true])
+        .sort(compareSiteSignatures);
+}
+function compareSiteSignatures(a, b) {
+    const left = JSON.stringify(a);
+    const right = JSON.stringify(b);
+    if (left === right)
+        return 0;
+    return left < right ? -1 : 1;
+}
+//# sourceMappingURL=fileGraph.js.map

package/dist/graph/fileGraph.js.map

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

package/dist/index.d.ts

@@ -1,26 +1,15 @@
 /**
- * TDepend - TypeScript Dependency Analysis Library
+ * tdepend: executable architecture contracts for TypeScript.
  *
- * A JDepend-inspired dependency analysis tool for TypeScript projects.
- * Computes architectural metrics and detects dependency issues.
- *
- * @packageDocumentation
+ * The public surface is the four high-level functions below plus their types.
+ * Discovery, resolution and graph helpers stay internal.
  */
-export { analyze, analyzeWithConfig } from './api/analyze';
+export { analyze } from './api/analyze';
 export type { AnalyzeOptions } from './api/analyze';
-export { exportToFile, exportToJson } from './api/export';
-export type { ExportOptions } from './api/export';
+export { explainFile } from './api/explain';
+export type { ExplainRow } from './api/explain';
+export { exportToFile } from './api/export';
 export { toSerializable } from './api/serialization';
-export { DependencyGraph } from './graph/dependencyGraph';
-export { detectCycles } from './graph/cycleDetector';
-export { computeAllMetrics } from './metrics';
-export { parseProject, parseFile } from './parser/tsParser';
-export { scanFiles } from './parser/fileScanner';
-export { loadConfig } from './config/loadConfig';
-export { generateReport, formatJsonOutput } from './analysis/reporter';
-export type { ParsedModule, ParsedClass, ParsedNamespace } from './types/parser';
-export type { DependencyNode, ModuleMetrics } from './types/graph';
-export type { AnalysisReport } from './analysis/reporter';
-export type { TDependConfig } from './config/schema';
-export type { AnalysisResult, SerializableAnalysisResult, SerializableDependencyGraph, SerializableDependencyNode, SerializableCycle, } from './types/api';
-export { defaultConfig } from './config/schema';
+export type { EdgeKind, LoadReason } from './parser/types';
+export type { ResolutionClass } from './resolver/types';
+export type { AnalysisResult, SerializableEdge, SerializableReport, SerializableResult, SerializableSite, SerializableSiteLocation, SerializableUnsupported, } from './types/api';