@untangle-code/file-graph 0.0.0-stage → 0.1.0

package/dist/resolve/candidates.js

@@ -0,0 +1,202 @@
+/**
+ * Kandidatenbildung: aus einem Pfad ohne Erweiterung die Liste der Dateien,
+ * die gemeint sein koennen — in fester Reihenfolge.
+ *
+ * DREI DINGE, DIE HIER PASSIEREN und ohne die jeder zweite Import dieses
+ * Repositories „unresolved" waere:
+ *
+ * 1. ERWEITERUNGSPROBE. `"./util"` kann `util.ts`, `util.tsx`, `util.js`,
+ *    … oder `util/index.ts` meinen.
+ *
+ * 2. RUECKABBILDUNG DER ESM-ENDUNG. TypeScript unter `NodeNext` schreibt
+ *    `import "./registry.js"` und meint `registry.ts`. Wer nur exakt
+ *    vergleicht, findet in einem modernen TypeScript-Monorepo praktisch
+ *    keinen einzigen relativen Import.
+ *
+ * 3. RUECKABBILDUNG DER BUILD-AUSGABE. Eine `exports`-Map zeigt auf
+ *    `dist/index.js`. Im Quellindex gibt es nur `src/index.ts`. Mit
+ *    `rootDir`/`outDir` aus der Projektkonfiguration wird daraus wieder eine
+ *    Quelldatei — und der Workspace-Import zeigt auf echten Quelltext statt
+ *    auf ein Artefakt, das gar nicht indiziert ist.
+ *
+ * Jede Probe, die NICHT getroffen hat, wird mitgefuehrt und landet als
+ * `rejectedCandidates` an der unaufgeloesten Kante (E4): wer die Aufloesung
+ * spaeter debuggt, sieht, wonach gesucht wurde.
+ */
+import { basenameOf, extensionOf, joinRelative, normalizePath, relativeWithin } from "../paths.js";
+/** Erweiterungen in Probierreihenfolge. Quelltext vor Build-Ausgabe. */
+export const DEFAULT_EXTENSION_ORDER = [
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",
+    ".d.ts",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".json",
+    ".py",
+    ".vue",
+];
+/**
+ * Endung, wie sie im Spezifizierer steht → Endungen, die tatsaechlich gemeint
+ * sein koennen. Die geschriebene Endung steht bewusst mit in der Liste, denn
+ * es gibt Projekte, in denen `./bundle.js` wirklich `bundle.js` meint.
+ *
+ * WELCHE ZUERST PROBIERT WIRD, haengt an der Sprache der QUELLDATEI
+ * (`preferSourceExtension`): in einer TypeScript-Datei meint `./util.js`
+ * unter `NodeNext` die Datei `util.ts`, also gewinnt dort die Quellendung.
+ * In einer JavaScript-Datei ist `./util.js` woertlich gemeint, also gewinnt
+ * dort die geschriebene Endung. Liegen `util.ts` und `util.js` nebeneinander,
+ * ist das der einzige Fall, in dem die Reihenfolge ueberhaupt zaehlt — und
+ * dann ist sie so, wie der jeweilige Uebersetzer sie auch waehlt.
+ */
+export const ESM_EXTENSION_REMAP = {
+    ".js": [".ts", ".tsx", ".d.ts", ".js"],
+    ".jsx": [".tsx", ".jsx"],
+    ".mjs": [".mts", ".d.mts", ".mjs"],
+    ".cjs": [".cts", ".d.cts", ".cjs"],
+};
+/** Erweiterungen, die als „nicht ausfuehrbarer Inhalt" gelten (spec.md §19/§20). */
+export const ASSET_EXTENSIONS = new Set([
+    ".avif",
+    ".css",
+    ".gif",
+    ".graphql",
+    ".ico",
+    ".jpeg",
+    ".jpg",
+    ".less",
+    ".md",
+    ".mdx",
+    ".png",
+    ".sass",
+    ".scss",
+    ".svg",
+    ".txt",
+    ".webp",
+    ".woff",
+    ".woff2",
+]);
+/**
+ * Bildet alle Kandidatenpfade zu einem Basispfad, ohne den Index zu befragen.
+ * Reihenfolge ist Teil des Vertrags: sie entscheidet, welche Datei gewinnt,
+ * wenn mehrere existieren.
+ */
+export function candidatePaths(basePath, extensionOrder = DEFAULT_EXTENSION_ORDER, options = {}) {
+    const preferSourceExtension = options.preferSourceExtension ?? true;
+    const normalized = normalizePath(basePath);
+    const candidates = [];
+    const push = (candidate) => {
+        if (!candidates.includes(candidate)) {
+            candidates.push(candidate);
+        }
+    };
+    const written = extensionOf(normalized);
+    if (written !== "") {
+        const remap = ESM_EXTENSION_REMAP[written];
+        if (remap === undefined || !preferSourceExtension) {
+            push(normalized);
+        }
+        if (remap !== undefined) {
+            const stem = normalized.slice(0, normalized.length - written.length);
+            for (const extension of remap) {
+                push(`${stem}${extension}`);
+            }
+            push(normalized);
+        }
+        // Ein Punkt im Namen ist NICHT immer eine Erweiterung: `./vitest.config`
+        // meint `vitest.config.ts`. Deshalb wird nur dann noch eine Erweiterung
+        // angehaengt, wenn der geschriebene Suffix keine bekannte ist — sonst
+        // entstuenden Unsinnskandidaten wie `context.js.cts`, die die
+        // `rejectedCandidates` unlesbar machen.
+        if (!isKnownExtension(written, extensionOrder)) {
+            for (const extension of extensionOrder) {
+                push(`${normalized}${extension}`);
+            }
+        }
+        // Auch ein Pfad mit Punkt kann ein Verzeichnis sein.
+        for (const extension of extensionOrder) {
+            push(`${normalized}/index${extension}`);
+        }
+        return candidates;
+    }
+    push(normalized);
+    for (const extension of extensionOrder) {
+        push(`${normalized}${extension}`);
+    }
+    for (const extension of extensionOrder) {
+        push(`${normalized}/index${extension}`);
+    }
+    // Python: ein Paketverzeichnis wird ueber seine Initialisierungsdatei erreicht.
+    push(`${normalized}/__init__.py`);
+    return candidates;
+}
+/**
+ * Bildet einen Pfad in der Build-Ausgabe eines Pakets auf den entsprechenden
+ * Quellpfad ab. `null`, wenn der Pfad nicht in einer bekannten Build-Ausgabe
+ * liegt oder das Paket keine Abbildung deklariert.
+ */
+export function reverseBuildOutput(packages, repoId, path) {
+    const normalized = normalizePath(path);
+    for (const entry of packages) {
+        if (entry.repoId !== repoId)
+            continue;
+        if (entry.outDir === undefined || entry.rootDir === undefined)
+            continue;
+        const withinOutput = relativeWithin(entry.outDir, normalized);
+        if (withinOutput === null || withinOutput === "")
+            continue;
+        const mapped = joinRelative(entry.rootDir, withinOutput);
+        if (mapped !== null) {
+            return mapped;
+        }
+    }
+    return null;
+}
+/**
+ * Sucht die erste existierende Datei zu einem Basispfad.
+ *
+ * Zuerst die direkten Kandidaten, danach — und nur, wenn keiner traf — die
+ * ueber `rootDir`/`outDir` zurueckgebildeten. Diese Reihenfolge ist wichtig:
+ * existiert die Build-Ausgabe wirklich im Index (weil jemand `dist/` mit
+ * indiziert hat), gewinnt sie, und wir erfinden keine Quelldatei.
+ */
+export function probeCandidates(context, repoId, basePath) {
+    const tried = [];
+    // In einer JavaScript-Quelle ist die geschriebene Endung woertlich gemeint;
+    // in einer TypeScript-Quelle ist sie die Endung der BUILD-Ausgabe.
+    const probeOptions = { preferSourceExtension: context.fromLanguageId !== "javascript" };
+    const direct = candidatePaths(basePath, context.extensionOrder, probeOptions);
+    for (const candidate of direct) {
+        tried.push(candidate);
+        if (context.files.hasFile(repoId, candidate)) {
+            return { path: candidate, tried };
+        }
+    }
+    const mapped = reverseBuildOutput(context.packageCatalog.all(), repoId, basePath);
+    if (mapped === null) {
+        return { path: null, tried };
+    }
+    for (const candidate of candidatePaths(mapped, context.extensionOrder, probeOptions)) {
+        if (tried.includes(candidate))
+            continue;
+        tried.push(candidate);
+        if (context.files.hasFile(repoId, candidate)) {
+            return { path: candidate, tried };
+        }
+    }
+    return { path: null, tried };
+}
+function isKnownExtension(extension, extensionOrder) {
+    return (extensionOrder.includes(extension) ||
+        extension in ESM_EXTENSION_REMAP ||
+        ASSET_EXTENSIONS.has(extension));
+}
+/** True, wenn der Spezifizierer auf eine Nicht-Code-Ressource zeigt. */
+export function isAssetSpecifier(specifier) {
+    const withoutQuery = specifier.split("?")[0] ?? specifier;
+    return ASSET_EXTENSIONS.has(extensionOf(basenameOf(withoutQuery)));
+}
+//# sourceMappingURL=candidates.js.map

package/dist/resolve/candidates.js.map

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

package/dist/resolve/package-exports.d.ts

@@ -0,0 +1,31 @@
+import type { WorkspacePackageV1 } from "../types.js";
+/** Bedingungen in Auswertungsreihenfolge. */
+export declare const DEFAULT_EXPORT_CONDITIONS: readonly ["node", "import", "require", "default", "types"];
+/** Ergebnis der Subpfadauswertung. */
+export type SubpathResolution = {
+    status: "target";
+    target: string;
+    via: "exports" | "imports" | "manifest-field" | "direct";
+} | {
+    status: "blocked";
+    detail: string;
+} | {
+    status: "no_match";
+    detail: string;
+};
+/**
+ * Loest einen Subpfad eines Pakets auf einen repo-relativen Basispfad auf.
+ *
+ * `subpath` ist `"."` fuer den Paketwurzel-Import oder `"./unter/pfad"`.
+ * Das Ergebnis ist ein Pfad OHNE Existenzpruefung — die uebernimmt
+ * `probeCandidates`.
+ */
+export declare function resolvePackageSubpath(entry: WorkspacePackageV1, subpath: string, conditions?: readonly string[]): SubpathResolution;
+/** Loest einen `#`-Subpath-Import gegen die `imports`-Karte eines Pakets auf. */
+export declare function resolvePackageImports(entry: WorkspacePackageV1, specifier: string, conditions?: readonly string[]): SubpathResolution;
+/** Zerlegt einen Paketspezifizierer in Paketname und Subpfad. */
+export declare function splitPackageSpecifier(specifier: string): {
+    name: string;
+    subpath: string;
+} | null;
+//# sourceMappingURL=package-exports.d.ts.map

package/dist/resolve/package-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-exports.d.ts","sourceRoot":"","sources":["../../src/resolve/package-exports.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB,4DAA6D,CAAC;AAEpG,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,QAAQ,CAAA;CAAE,GAC9F;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,SAAS,MAAM,EAA8B,GACxD,iBAAiB,CAsDnB;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,SAAS,MAAM,EAA8B,GACxD,iBAAiB,CAmBnB;AA6HD,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBjG"}

package/dist/resolve/package-exports.js

@@ -0,0 +1,229 @@
+/**
+ * Auswertung der `exports`- und `imports`-Karten eines Paketmanifests
+ * (spec.md §14.3 „Node Package Exports").
+ *
+ * Was hier abgedeckt ist: die String-Kurzform, die Bedingungsobjekte
+ * (`types`/`node`/`import`/`require`/`default`), die Subpfadkarte, die
+ * Musterform mit `*`, Arrays als Fallbackliste und `null` als bewusste
+ * Sperre eines Subpfads.
+ *
+ * BEDINGUNGSREIHENFOLGE: Laufzeitbedingungen kommen VOR `types`. Grund: ein
+ * `types`-Treffer zeigt auf eine Deklarationsdatei (`.d.ts`), und die ist im
+ * Quellindex eines Monorepos praktisch nie vorhanden — die Kante waere
+ * unaufgeloest, obwohl das Paket eindeutig bestimmt ist. Ueber die
+ * Laufzeitbedingung landet man auf der Build-Ausgabe, und die
+ * `rootDir`/`outDir`-Rueckabbildung fuehrt von dort zur Quelldatei.
+ *
+ * `null` als Ziel ist KEIN „nicht gefunden": es ist die ausdrueckliche
+ * Aussage des Paketautors, dass dieser Subpfad nicht importiert werden darf.
+ * Das wird als eigener Grund gemeldet und nicht mit einem Fehlschlag
+ * verwechselt (E4).
+ */
+import { joinRelative, normalizePath } from "../paths.js";
+/** Bedingungen in Auswertungsreihenfolge. */
+export const DEFAULT_EXPORT_CONDITIONS = ["node", "import", "require", "default", "types"];
+/**
+ * Loest einen Subpfad eines Pakets auf einen repo-relativen Basispfad auf.
+ *
+ * `subpath` ist `"."` fuer den Paketwurzel-Import oder `"./unter/pfad"`.
+ * Das Ergebnis ist ein Pfad OHNE Existenzpruefung — die uebernimmt
+ * `probeCandidates`.
+ */
+export function resolvePackageSubpath(entry, subpath, conditions = DEFAULT_EXPORT_CONDITIONS) {
+    const normalizedSubpath = subpath === "" ? "." : subpath;
+    if (entry.exports !== undefined) {
+        const matched = matchExportsMap(entry.exports, normalizedSubpath, conditions);
+        if (matched.status === "target") {
+            const joined = joinRelative(entry.packageDir, matched.target);
+            if (joined === null) {
+                return {
+                    status: "no_match",
+                    detail: `exports target "${matched.target}" escapes the package directory "${entry.packageDir}"`,
+                };
+            }
+            return { status: "target", target: joined, via: "exports" };
+        }
+        if (matched.status === "blocked") {
+            return matched;
+        }
+        // Kein Subpfadtreffer in einer vorhandenen exports-Karte: das Paket
+        // kapselt seinen Inhalt, der Import ist ungueltig. Kein stiller Rueckfall
+        // auf den Verzeichnispfad — das waere geraten.
+        return {
+            status: "no_match",
+            detail: `package "${entry.name}" declares "exports" but no entry matches subpath "${normalizedSubpath}"`,
+        };
+    }
+    if (normalizedSubpath === ".") {
+        for (const field of ["module", "main", "types"]) {
+            const value = entry[field];
+            if (value === undefined)
+                continue;
+            const joined = joinRelative(entry.packageDir, value);
+            if (joined !== null) {
+                return { status: "target", target: joined, via: "manifest-field" };
+            }
+        }
+        const indexPath = joinRelative(entry.packageDir, "index");
+        if (indexPath === null) {
+            return {
+                status: "no_match",
+                detail: `package directory "${entry.packageDir}" is not usable`,
+            };
+        }
+        return { status: "target", target: indexPath, via: "direct" };
+    }
+    const joined = joinRelative(entry.packageDir, normalizedSubpath);
+    if (joined === null) {
+        return {
+            status: "no_match",
+            detail: `subpath "${normalizedSubpath}" escapes the package directory "${entry.packageDir}"`,
+        };
+    }
+    return { status: "target", target: joined, via: "direct" };
+}
+/** Loest einen `#`-Subpath-Import gegen die `imports`-Karte eines Pakets auf. */
+export function resolvePackageImports(entry, specifier, conditions = DEFAULT_EXPORT_CONDITIONS) {
+    if (entry.imports === undefined) {
+        return {
+            status: "no_match",
+            detail: `package "${entry.name}" declares no "imports" map for "${specifier}"`,
+        };
+    }
+    const matched = matchExportsMap(entry.imports, specifier, conditions);
+    if (matched.status !== "target") {
+        return matched;
+    }
+    const joined = joinRelative(entry.packageDir, matched.target);
+    if (joined === null) {
+        return {
+            status: "no_match",
+            detail: `imports target "${matched.target}" escapes the package directory "${entry.packageDir}"`,
+        };
+    }
+    return { status: "target", target: joined, via: "imports" };
+}
+function matchExportsMap(map, key, conditions) {
+    // Kurzform: `"exports": "./dist/index.js"` gilt nur fuer ".".
+    if (typeof map === "string") {
+        return key === "."
+            ? { status: "target", target: map }
+            : { status: "no_match", detail: `string "exports" only covers subpath "."` };
+    }
+    if (map === null) {
+        return { status: "blocked", detail: `"exports" is null — the package blocks all subpaths` };
+    }
+    if (Array.isArray(map)) {
+        return selectFromList(map, key, conditions);
+    }
+    if (typeof map !== "object") {
+        return { status: "no_match", detail: `"exports" is neither string, array nor object` };
+    }
+    const record = map;
+    const keys = Object.keys(record);
+    const isSubpathMap = keys.some((entry) => entry === "." || entry.startsWith("./") || entry.startsWith("#"));
+    if (!isSubpathMap) {
+        // Reines Bedingungsobjekt: gilt fuer ".".
+        if (key !== ".") {
+            return { status: "no_match", detail: `condition-only "exports" only covers subpath "."` };
+        }
+        return selectCondition(record, conditions);
+    }
+    const exact = record[key];
+    if (exact !== undefined) {
+        return resolveConditionValue(exact, conditions, key);
+    }
+    // Musterform: "./features/*": "./dist/features/*.js"
+    let best = null;
+    for (const pattern of keys) {
+        const starIndex = pattern.indexOf("*");
+        if (starIndex === -1)
+            continue;
+        const prefix = pattern.slice(0, starIndex);
+        const suffix = pattern.slice(starIndex + 1);
+        if (!key.startsWith(prefix) || !key.endsWith(suffix))
+            continue;
+        if (key.length < prefix.length + suffix.length)
+            continue;
+        const captured = key.slice(prefix.length, key.length - suffix.length);
+        // Node waehlt bei mehreren Mustern das mit dem laengsten Praefix.
+        if (best === null || prefix.length > best.pattern.indexOf("*")) {
+            best = { pattern, value: record[pattern], captured };
+        }
+    }
+    if (best === null) {
+        return { status: "no_match", detail: `no "exports" entry matches "${key}"` };
+    }
+    const resolved = resolveConditionValue(best.value, conditions, key);
+    if (resolved.status !== "target") {
+        return resolved;
+    }
+    return { status: "target", target: resolved.target.split("*").join(best.captured) };
+}
+function resolveConditionValue(value, conditions, key) {
+    if (value === null) {
+        return {
+            status: "blocked",
+            detail: `"exports" entry for "${key}" is null — import is forbidden`,
+        };
+    }
+    if (typeof value === "string") {
+        return { status: "target", target: value };
+    }
+    if (Array.isArray(value)) {
+        return selectFromList(value, key, conditions);
+    }
+    if (typeof value === "object") {
+        return selectCondition(value, conditions);
+    }
+    return { status: "no_match", detail: `"exports" entry for "${key}" has an unusable type` };
+}
+function selectFromList(list, key, conditions) {
+    const details = [];
+    for (const candidate of list) {
+        const resolved = resolveConditionValue(candidate, conditions, key);
+        if (resolved.status === "target") {
+            return resolved;
+        }
+        details.push(resolved.detail);
+    }
+    return {
+        status: "no_match",
+        detail: `no usable entry in "exports" array for "${key}" (${details.join("; ")})`,
+    };
+}
+function selectCondition(record, conditions) {
+    for (const condition of conditions) {
+        if (!(condition in record))
+            continue;
+        const value = record[condition];
+        const resolved = resolveConditionValue(value, conditions, condition);
+        if (resolved.status === "target" || resolved.status === "blocked") {
+            return resolved;
+        }
+    }
+    return {
+        status: "no_match",
+        detail: `none of the conditions [${conditions.join(", ")}] is present in [${Object.keys(record).join(", ")}]`,
+    };
+}
+/** Zerlegt einen Paketspezifizierer in Paketname und Subpfad. */
+export function splitPackageSpecifier(specifier) {
+    const normalized = normalizePath(specifier);
+    if (normalized === "") {
+        return null;
+    }
+    const segments = normalized.split("/");
+    if (normalized.startsWith("@")) {
+        if (segments.length < 2 || segments[1] === undefined || segments[1] === "") {
+            return null;
+        }
+        const name = `${segments[0]}/${segments[1]}`;
+        const rest = segments.slice(2).join("/");
+        return { name, subpath: rest === "" ? "." : `./${rest}` };
+    }
+    const name = segments[0];
+    const rest = segments.slice(1).join("/");
+    return { name, subpath: rest === "" ? "." : `./${rest}` };
+}
+//# sourceMappingURL=package-exports.js.map

package/dist/resolve/package-exports.js.map

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

package/dist/resolve/pipeline.d.ts

@@ -0,0 +1,11 @@
+import type { ImportResolverV1, ResolveContextV1, ResolveResultV1 } from "../types.js";
+/** Die Standardpipeline in der Reihenfolge von architecture.md §16.2. */
+export declare const DEFAULT_RESOLVER_PIPELINE: readonly ImportResolverV1[];
+/** Ergebnis eines Pipelinelaufs samt der Spur der befragten Resolver. */
+export interface PipelineOutcomeV1 {
+    result: ResolveResultV1;
+    /** Namen aller Resolver, die sich zustaendig erklaert haben, in Reihenfolge. */
+    attemptedResolvers: string[];
+}
+export declare function resolveImport(specifier: string, context: ResolveContextV1, pipeline?: readonly ImportResolverV1[]): PipelineOutcomeV1;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/resolve/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/resolve/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAavF,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,EAAE,SAAS,gBAAgB,EAShE,CAAC;AAEF,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,GAAE,SAAS,gBAAgB,EAA8B,GAChE,iBAAiB,CAkFnB"}

package/dist/resolve/pipeline.js

@@ -0,0 +1,109 @@
+/**
+ * Die Resolver-Pipeline (architecture.md §16.2).
+ *
+ * Reihenfolge wie dort festgelegt: relativer Pfad → Sprachaliase →
+ * Projektaliase → Workspace-Paketkarte → installierte Paketmetadaten →
+ * Klassifikation als extern/unaufgeloest.
+ *
+ * DER WICHTIGE TEIL IST DAS SCHEITERN. Ein Resolver, der zustaendig war und
+ * NICHT getroffen hat, beendet die Suche nicht: der naechste zustaendige darf
+ * es versuchen. Erst wenn keiner mehr uebrig ist, entsteht eine unaufgeloeste
+ * Kante — und die traegt dann den Grund des ERSTEN zustaendigen Resolvers,
+ * ergaenzt um die Namen aller weiteren Versuche und die Vereinigung aller
+ * geprueften Kandidaten. Ein pauschales „konnte nicht aufgeloest werden" ohne
+ * diese Spur waere genau die stille Ausblendung, die E4 verbietet.
+ */
+import { compareCodepoints } from "@untangle-code/domain";
+import { configuredAliasResolver, installedPackageResolver, projectAliasResolver, pythonModuleResolver, relativePathResolver, runtimeBuiltinResolver, subpathImportResolver, workspacePackageResolver, } from "./resolvers.js";
+/** Die Standardpipeline in der Reihenfolge von architecture.md §16.2. */
+export const DEFAULT_RESOLVER_PIPELINE = [
+    relativePathResolver,
+    runtimeBuiltinResolver,
+    subpathImportResolver,
+    pythonModuleResolver,
+    projectAliasResolver,
+    configuredAliasResolver,
+    workspacePackageResolver,
+    installedPackageResolver,
+];
+export function resolveImport(specifier, context, pipeline = DEFAULT_RESOLVER_PIPELINE) {
+    const attempted = [];
+    const failures = [];
+    for (const resolver of pipeline) {
+        let supports;
+        try {
+            supports = resolver.supports(specifier, context);
+        }
+        catch (error) {
+            // Ein werfender Resolver darf die Kette nicht abbrechen — der Fehler
+            // wird zum benannten Fehlschlag, nicht zum verschluckten Ausnahmefall.
+            attempted.push(resolver.name);
+            failures.push({
+                resolver: resolver.name,
+                result: {
+                    status: "unresolved",
+                    reason: "no_resolver_supports_specifier",
+                    detail: `resolver "${resolver.name}" threw while deciding support: ${messageOf(error)}`,
+                },
+            });
+            continue;
+        }
+        if (!supports)
+            continue;
+        attempted.push(resolver.name);
+        let outcome;
+        try {
+            outcome = resolver.resolve(specifier, context);
+        }
+        catch (error) {
+            failures.push({
+                resolver: resolver.name,
+                result: {
+                    status: "unresolved",
+                    reason: "target_file_not_found",
+                    detail: `resolver "${resolver.name}" threw: ${messageOf(error)}`,
+                },
+            });
+            continue;
+        }
+        if (outcome === null)
+            continue;
+        if (outcome.status !== "unresolved") {
+            return { result: outcome, attemptedResolvers: attempted };
+        }
+        failures.push({ resolver: resolver.name, result: outcome });
+    }
+    if (failures.length === 0) {
+        return {
+            result: {
+                status: "unresolved",
+                reason: "no_resolver_supports_specifier",
+                detail: `no resolver in [${pipeline.map((entry) => entry.name).join(", ")}] claims specifier "${specifier}" from "${context.fromPath}"`,
+            },
+            attemptedResolvers: attempted,
+        };
+    }
+    const first = failures[0];
+    const rejected = new Set();
+    for (const failure of failures) {
+        for (const candidate of failure.result.rejectedCandidates ?? []) {
+            rejected.add(candidate);
+        }
+    }
+    const trail = failures
+        .map((failure) => `${failure.resolver}: ${failure.result.detail}`)
+        .join(" | ");
+    return {
+        result: {
+            status: "unresolved",
+            reason: first.result.reason,
+            detail: trail,
+            ...(rejected.size > 0 ? { rejectedCandidates: [...rejected].sort(compareCodepoints) } : {}),
+        },
+        attemptedResolvers: attempted,
+    };
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/resolve/pipeline.js.map

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

package/dist/resolve/resolvers.d.ts

@@ -0,0 +1,25 @@
+import type { ImportResolverV1 } from "../types.js";
+/**
+ * Modulnamen, die die Laufzeit selbst mitbringt. Bewusst als Liste und nicht
+ * ueber `node:module`s `builtinModules`: die Liste haengt sonst von der
+ * Node-Version der ANALYSIERENDEN Maschine ab, und dieselbe Codebasis haette
+ * je nach Rechner eine andere Import-Resolution-Rate.
+ */
+export declare const RUNTIME_BUILTIN_MODULES: Set<string>;
+export declare const relativePathResolver: ImportResolverV1;
+export declare const runtimeBuiltinResolver: ImportResolverV1;
+export declare const subpathImportResolver: ImportResolverV1;
+export declare const projectAliasResolver: ImportResolverV1;
+export declare const configuredAliasResolver: ImportResolverV1;
+/** `"@app/*"` gegen `"@app/util"` → `"util"`; ohne `*` exakter Vergleich. */
+export declare function matchAlias(pattern: string, specifier: string): string | null;
+export declare const workspacePackageResolver: ImportResolverV1;
+export declare const installedPackageResolver: ImportResolverV1;
+/**
+ * Python schreibt Importe punktiert (`from ..pkg.mod import x` → `"..pkg.mod"`).
+ * Fuehrende Punkte sind relative Schritte nach oben, der Rest ist ein Pfad.
+ * Ohne diesen Resolver waere in einem Python-Teilprojekt JEDER Import
+ * unaufgeloest — mit ihm ist wenigstens der relative Fall exakt.
+ */
+export declare const pythonModuleResolver: ImportResolverV1;
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/resolve/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../src/resolve/resolvers.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAqC,MAAM,aAAa,CAAC;AAUvF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,aA2ClC,CAAC;AAoBH,eAAO,MAAM,oBAAoB,EAAE,gBA4BlC,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,gBAcpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAgBnC,CAAC;AAkDF,eAAO,MAAM,oBAAoB,kBAIhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,kBAInC,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc5E;AAMD,eAAO,MAAM,wBAAwB,EAAE,gBA+CtC,CAAC;AAMF,eAAO,MAAM,wBAAwB,EAAE,gBA6BtC,CAAC;AAsBF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAuElC,CAAC"}