@lzehrung/codegraph 2.1.0

package/dist/cli.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { isCliBootstrapActive } from "./cli/bootstrap.js";
+import { CLI_COMMAND_TABLE } from "./cli/commandTable.js";
+import { exitCli, getCwd, parseCliArgs, runWithCliRuntime, writeError, writeJSONLine, writeStderrLine, writeStdoutLine, } from "./cli/context.js";
+import { CLI_HELP_TEXT, CLI_TASK_HELP_TEXT, helpTextForCommand, isKnownCliCommand } from "./cli/help.js";
+import { routeForCliIntent, suggestCliCommands } from "./cli/commandCatalog.js";
+import { createCliBaseContext, createCliOptionAccessors, loadCliProjectContext } from "./cli/invocationContext.js";
+import { validateCliArgs } from "./cli/options.js";
+import { getCodegraphPackageIdentity, getCodegraphVersion } from "./util/packageInfo.js";
+import { errorMessage } from "./util/errors.js";
+export { isRelativePathInside as isCliDiscoveryRelativePathInside } from "./util/discoveryPath.js";
+export const CLI_DISPATCHABLE_COMMANDS = [
+    "apisurface",
+    "affected",
+    "artifact",
+    "callees",
+    "callers",
+    "chunk",
+    "cycles",
+    "deps",
+    "doctor",
+    "drift",
+    "dumpmod",
+    "duplicates",
+    "explain",
+    "explore",
+    "file",
+    "goto",
+    "graph",
+    "graph-delta",
+    "grep",
+    "hotspots",
+    "impact",
+    "implementations",
+    "index",
+    "init",
+    "inspect",
+    "install",
+    "links",
+    "mcp",
+    "orient",
+    "packet",
+    "path",
+    "rdeps",
+    "refactor-plan",
+    "refs",
+    "rename-preview",
+    "review",
+    "search",
+    "skill",
+    "sql",
+    "status",
+    "subtypes",
+    "supertypes",
+    "symbols",
+    "sync",
+    "uninit",
+    "uninstall",
+    "unresolved",
+    "viewer",
+    "version",
+];
+function normalizeEntrypointPath(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    try {
+        return fs.realpathSync.native(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+function isDirectCliExecution(importMetaUrl, argv = process.argv) {
+    const argv1 = argv[1];
+    if (!argv1)
+        return false;
+    const modulePath = normalizeEntrypointPath(fileURLToPath(importMetaUrl));
+    const invokedPath = normalizeEntrypointPath(argv1);
+    if (process.platform === "win32") {
+        return modulePath.toLowerCase() === invokedPath.toLowerCase();
+    }
+    return modulePath === invokedPath;
+}
+async function runCliWithActiveRuntime(rawArgs) {
+    if (!rawArgs.length) {
+        writeStdoutLine(CLI_TASK_HELP_TEXT);
+        return;
+    }
+    if (rawArgs[0] === "help") {
+        const command = rawArgs[1];
+        writeStdoutLine((command ? helpTextForCommand(command, rawArgs.slice(2)) : CLI_HELP_TEXT)?.trimEnd() ?? CLI_HELP_TEXT);
+        return;
+    }
+    const commandWasExplicit = Boolean(rawArgs[0] && !rawArgs[0].startsWith("-"));
+    const cmd = commandWasExplicit ? rawArgs[0] : "graph";
+    const argTokens = commandWasExplicit ? rawArgs.slice(1) : rawArgs;
+    let parsed;
+    try {
+        parsed = parseCliArgs(cmd, argTokens);
+    }
+    catch (error) {
+        writeStderrLine(errorMessage(error));
+        exitCli(2);
+    }
+    const { getOpt, hasFlag } = createCliOptionAccessors(parsed);
+    if (hasFlag("--help") || hasFlag("-h")) {
+        const commandHelp = commandWasExplicit ? helpTextForCommand(cmd, parsed.positionals) : undefined;
+        writeStdoutLine((commandHelp ?? CLI_HELP_TEXT).trimEnd());
+        return;
+    }
+    if (hasFlag("--version") || hasFlag("-v")) {
+        if (hasFlag("--json")) {
+            writeJSONLine(getCodegraphPackageIdentity());
+        }
+        else {
+            writeStdoutLine(getCodegraphVersion());
+        }
+        return;
+    }
+    if (!isKnownCliCommand(cmd)) {
+        writeStderrLine(`Unknown command "${cmd}".`);
+        const suggestions = suggestCliCommands(cmd);
+        if (suggestions.length)
+            writeStderrLine(`Did you mean: ${suggestions.join(", ")}?`);
+        const route = routeForCliIntent(cmd);
+        if (route)
+            writeStderrLine(`Try: ${route}`);
+        exitCli(1);
+        return;
+    }
+    try {
+        validateCliArgs(cmd, parsed);
+    }
+    catch (error) {
+        writeStderrLine(errorMessage(error));
+        exitCli(2);
+    }
+    if (cmd === "viewer") {
+        // Keep the human-only browser server out of normal agent command startup.
+        const { handleViewerCommand } = await import("./cli/viewer.js");
+        await handleViewerCommand({
+            getOpt,
+            hasFlag,
+            cwd: getCwd,
+            writeStderrLine,
+            writeStdoutLine,
+            exit: exitCli,
+        });
+        return;
+    }
+    const entry = CLI_COMMAND_TABLE[cmd];
+    if (!entry) {
+        writeStderrLine(`Unknown command: ${cmd}`);
+        exitCli(1);
+    }
+    const base = createCliBaseContext(cmd, parsed);
+    if (entry.stage === "base") {
+        await entry.run(base);
+        return;
+    }
+    const project = await loadCliProjectContext(base);
+    await entry.run(project);
+}
+export async function runCli(rawArgs = process.argv.slice(2), runtime = {}) {
+    await runWithCliRuntime(runtime, async () => await runCliWithActiveRuntime(rawArgs));
+}
+export async function main(rawArgs = process.argv.slice(2)) {
+    // Keep the failure path inside the ALS CLI context so --stderr-file (and other
+    // context-local state) remains visible to writeError/writeStderrLine.
+    await runWithCliRuntime({}, async () => {
+        try {
+            await runCliWithActiveRuntime(rawArgs);
+        }
+        catch (error) {
+            writeError(error);
+            exitCli(1);
+        }
+    });
+}
+if (!isCliBootstrapActive() && isDirectCliExecution(import.meta.url)) {
+    void main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/cliBootstrap.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cliBootstrap.d.ts.map

package/dist/cliBootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliBootstrap.d.ts","sourceRoot":"","sources":["../src/cliBootstrap.ts"],"names":[],"mappings":""}

package/dist/cliBootstrap.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { enableCliCompileCache } from "./cli/compileCache.js";
+import { markCliBootstrapActive } from "./cli/bootstrap.js";
+// Enable before loading the heavy CLI graph so subsequent dynamic imports (and
+// later process invocations) can reuse V8's module compile cache.
+enableCliCompileCache();
+markCliBootstrapActive();
+const { main } = await import("./cli.js");
+void main();
+//# sourceMappingURL=cliBootstrap.js.map

package/dist/cliBootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliBootstrap.js","sourceRoot":"","sources":["../src/cliBootstrap.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,+EAA+E;AAC/E,kEAAkE;AAClE,qBAAqB,EAAE,CAAC;AACxB,sBAAsB,EAAE,CAAC;AAEzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;AAC1C,KAAK,IAAI,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+import type { LanguageExtensionMap } from "./languages.js";
+import type { GraphBuildOptions } from "./graphs/types.js";
+import { type ProjectFileDiscoveryOptions } from "./util/projectFiles.js";
+export declare const CODEGRAPH_CONFIG_FILE = "codegraph.config.json";
+export type CodegraphConfig = {
+    discovery?: ProjectFileDiscoveryOptions;
+    languages?: {
+        extensions?: LanguageExtensionMap;
+    };
+    graph?: {
+        resolutionHints?: string[];
+    };
+};
+export declare function hasDiscoveryOptions(discovery: ProjectFileDiscoveryOptions): boolean;
+export declare function mergeDiscoveryOptions(base: ProjectFileDiscoveryOptions | undefined, override: ProjectFileDiscoveryOptions | undefined): ProjectFileDiscoveryOptions;
+export declare function mergeGraphOptions(base: CodegraphConfig["graph"] | undefined, override: GraphBuildOptions | undefined): GraphBuildOptions;
+export declare function loadCodegraphConfig(projectRoot: string): Promise<CodegraphConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAiC7D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,oBAAoB,CAAC;KACnC,CAAC;IACF,KAAK,CAAC,EAAE;QACN,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;CACH,CAAC;AAWF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,2BAA2B,GAAG,OAAO,CASnF;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,2BAA2B,GAAG,SAAS,EAC7C,QAAQ,EAAE,2BAA2B,GAAG,SAAS,GAChD,2BAA2B,CAe7B;AACD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,EAC1C,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,iBAAiB,CASnB;AAyCD,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAiCvF"}

package/dist/config.js

@@ -0,0 +1,141 @@
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { isLiteralLanguageExtension, isRemappableLanguageExtension, normalizeLanguageExtensions, supportById, } from "./languages.js";
+import { normalizeResolutionHints } from "./util/paths.js";
+import { errorMessage } from "./util/errors.js";
+import {} from "./util/projectFiles.js";
+export const CODEGRAPH_CONFIG_FILE = "codegraph.config.json";
+const stringArraySchema = z.array(z.string().trim().min(1));
+const languageExtensionsSchema = z.record(z.string().trim().min(1), z.string().trim().min(1));
+const codegraphConfigSchema = z
+    .object({
+    discovery: z
+        .object({
+        includeGlobs: stringArraySchema.optional(),
+        ignoreGlobs: stringArraySchema.optional(),
+        useGitignore: z.boolean().optional(),
+    })
+        .strict()
+        .optional(),
+    languages: z
+        .object({
+        extensions: languageExtensionsSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    graph: z
+        .object({
+        resolutionHints: stringArraySchema.optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+function uniq(values) {
+    return Array.from(new Set(values.map((value) => value.trim().replace(/\\/g, "/")).filter(Boolean)));
+}
+function normalizeDiscoveryRoot(root) {
+    const normalized = root?.trim().replace(/\\/g, "/");
+    return normalized ? normalized : undefined;
+}
+export function hasDiscoveryOptions(discovery) {
+    return Boolean(discovery.includeGlobs?.length ||
+        discovery.ignoreGlobs?.length ||
+        discovery.useGitignore !== undefined ||
+        normalizeDiscoveryRoot(discovery.globRoot) ||
+        normalizeDiscoveryRoot(discovery.gitignoreRoot) ||
+        discovery.logLevel);
+}
+export function mergeDiscoveryOptions(base, override) {
+    const includeGlobs = uniq([...(base?.includeGlobs ?? []), ...(override?.includeGlobs ?? [])]);
+    const ignoreGlobs = uniq([...(base?.ignoreGlobs ?? []), ...(override?.ignoreGlobs ?? [])]);
+    const useGitignore = override?.useGitignore ?? base?.useGitignore;
+    const globRoot = normalizeDiscoveryRoot(override?.globRoot) ?? normalizeDiscoveryRoot(base?.globRoot);
+    const gitignoreRoot = normalizeDiscoveryRoot(override?.gitignoreRoot) ?? normalizeDiscoveryRoot(base?.gitignoreRoot);
+    const logLevel = override?.logLevel ?? base?.logLevel;
+    return {
+        ...(includeGlobs.length ? { includeGlobs } : {}),
+        ...(ignoreGlobs.length ? { ignoreGlobs } : {}),
+        ...(useGitignore !== undefined ? { useGitignore } : {}),
+        ...(globRoot !== undefined ? { globRoot } : {}),
+        ...(gitignoreRoot !== undefined ? { gitignoreRoot } : {}),
+        ...(logLevel !== undefined ? { logLevel } : {}),
+    };
+}
+export function mergeGraphOptions(base, override) {
+    const resolutionHints = normalizeResolutionHints([
+        ...(base?.resolutionHints ?? []),
+        ...(override?.resolutionHints ?? []),
+    ]);
+    return {
+        ...override,
+        ...(resolutionHints.length ? { resolutionHints } : {}),
+    };
+}
+function normalizeDiscoveryConfig(discovery) {
+    if (!discovery)
+        return undefined;
+    const normalized = {
+        ...(discovery.includeGlobs !== undefined ? { includeGlobs: discovery.includeGlobs } : {}),
+        ...(discovery.ignoreGlobs !== undefined ? { ignoreGlobs: discovery.ignoreGlobs } : {}),
+        ...(discovery.useGitignore !== undefined ? { useGitignore: discovery.useGitignore } : {}),
+    };
+    return hasDiscoveryOptions(normalized) ? normalized : undefined;
+}
+function normalizeConfigLanguageExtensions(extensions) {
+    if (!extensions)
+        return undefined;
+    for (const [rawKey, rawLanguageId] of Object.entries(extensions)) {
+        const key = rawKey.trim().toLowerCase();
+        const languageId = rawLanguageId.trim().toLowerCase();
+        if (!key.startsWith(".")) {
+            throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: languages.extensions key "${rawKey}" must start with ".".`);
+        }
+        if (!isLiteralLanguageExtension(key)) {
+            throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: languages.extensions key "${rawKey}" must be a literal suffix containing only letters, digits, ".", "_", "+", or "-".`);
+        }
+        if (!isRemappableLanguageExtension(key)) {
+            throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: languages.extensions key "${rawKey}" cannot be remapped.`);
+        }
+        if (!supportById(languageId)) {
+            throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: languages.extensions["${rawKey}"] references unknown language "${languageId}".`);
+        }
+    }
+    return normalizeLanguageExtensions(extensions);
+}
+export async function loadCodegraphConfig(projectRoot) {
+    const configPath = path.join(projectRoot, CODEGRAPH_CONFIG_FILE);
+    let raw;
+    try {
+        raw = await fsp.readFile(configPath, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return {};
+        }
+        throw error;
+    }
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(raw);
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: ${message}`);
+    }
+    const parsed = codegraphConfigSchema.safeParse(parsedJson);
+    if (!parsed.success) {
+        throw new Error(`Invalid ${CODEGRAPH_CONFIG_FILE}: ${z.prettifyError(parsed.error)}`);
+    }
+    const languageExtensions = normalizeConfigLanguageExtensions(parsed.data.languages?.extensions);
+    const discovery = normalizeDiscoveryConfig(parsed.data.discovery);
+    const resolutionHints = normalizeResolutionHints(parsed.data.graph?.resolutionHints);
+    const graph = resolutionHints.length ? { resolutionHints } : undefined;
+    return {
+        ...(discovery ? { discovery } : {}),
+        ...(graph ? { graph } : {}),
+        ...(languageExtensions ? { languages: { extensions: languageExtensions } } : {}),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/documentLinks/asciidoc.d.ts

@@ -0,0 +1,3 @@
+import { type ModuleSpecifier } from "../util/specifiers.js";
+export declare function extractAsciidocModuleSpecifiers(source: string): ModuleSpecifier[];
+//# sourceMappingURL=asciidoc.d.ts.map

package/dist/documentLinks/asciidoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asciidoc.d.ts","sourceRoot":"","sources":["../../src/documentLinks/asciidoc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoC7D,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CAoDjF"}

package/dist/documentLinks/asciidoc.js

@@ -0,0 +1,115 @@
+import path from "node:path";
+import {} from "../util/specifiers.js";
+import { extractHtmlAttributeSpecifiers } from "./html.js";
+import { dedupeModuleSpecifiers, normalizeLinkSpecifier } from "./shared.js";
+function blankAsciidocLine(line) {
+    return line.replace(/[^\r\n]/g, " ");
+}
+function stripAsciidocCommentsAndLiteralBlocks(source) {
+    const lines = source.split(/\r?\n/);
+    let blockDelimiter = null;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        const trimmed = line.trim();
+        if (blockDelimiter) {
+            lines[index] = blankAsciidocLine(line);
+            if (trimmed === blockDelimiter)
+                blockDelimiter = null;
+            continue;
+        }
+        if (trimmed === "----" || trimmed === "...." || trimmed === "////") {
+            blockDelimiter = trimmed;
+            lines[index] = blankAsciidocLine(line);
+            continue;
+        }
+        if (/^\s*\/\//.test(line)) {
+            lines[index] = blankAsciidocLine(line);
+        }
+    }
+    return lines.join("\n");
+}
+export function extractAsciidocModuleSpecifiers(source) {
+    const out = [];
+    const cleaned = stripAsciidocCommentsAndLiteralBlocks(source);
+    for (const match of cleaned.matchAll(/\b(xref|link):([^\[\s]+)\[[^\]]*]/g)) {
+        const directive = (match[1] ?? "").toLowerCase();
+        const rawSpecifier = match[2]?.trim();
+        if (!rawSpecifier)
+            continue;
+        const fileLikeTarget = directive === "xref" ? isLikelyAsciidocXrefTarget(rawSpecifier) : isLikelyAsciidocFileTarget(rawSpecifier);
+        if (!fileLikeTarget)
+            continue;
+        const ambiguousXrefTarget = directive === "xref" && isAmbiguousAsciidocXrefTarget(rawSpecifier);
+        const normalized = normalizeLinkSpecifier(rawSpecifier, {
+            preferRelative: true,
+            resolutionKind: "document",
+            forceRelative: true,
+        });
+        if (normalized) {
+            out.push(ambiguousXrefTarget ? { ...normalized, dropIfUnresolved: true } : normalized);
+        }
+    }
+    for (const match of cleaned.matchAll(/^\s*include::([^\[\n]+)\[[^\]]*]/gm)) {
+        const rawSpecifier = match[1]?.trim();
+        if (!rawSpecifier)
+            continue;
+        const normalized = normalizeLinkSpecifier(rawSpecifier, {
+            preferRelative: true,
+            resolutionKind: "document",
+            forceRelative: true,
+        });
+        if (normalized)
+            out.push(normalized);
+    }
+    for (const match of cleaned.matchAll(/<<([^>,]+)(?:,[^>]*)?>>/g)) {
+        const rawSpecifier = match[1]?.trim();
+        if (!rawSpecifier)
+            continue;
+        if (!isLikelyAsciidocFileTarget(rawSpecifier))
+            continue;
+        const normalized = normalizeLinkSpecifier(rawSpecifier, {
+            preferRelative: true,
+            resolutionKind: "document",
+            forceRelative: true,
+        });
+        if (normalized)
+            out.push(normalized);
+    }
+    out.push(...extractHtmlAttributeSpecifiers(cleaned, {
+        a: ["href"],
+    }));
+    return dedupeModuleSpecifiers(out);
+}
+function isLikelyAsciidocXrefTarget(rawSpecifier) {
+    if (isLikelyAsciidocFileTarget(rawSpecifier))
+        return true;
+    const withoutFragment = rawSpecifier.trim().split("#", 1)[0]?.split("?", 1)[0]?.trim() ?? "";
+    if (!withoutFragment)
+        return false;
+    return /^[A-Za-z0-9._-]+$/.test(withoutFragment);
+}
+function isAmbiguousAsciidocXrefTarget(rawSpecifier) {
+    return isLikelyAsciidocXrefTarget(rawSpecifier) && !isLikelyAsciidocFileTarget(rawSpecifier);
+}
+function isLikelyAsciidocFileTarget(rawSpecifier) {
+    const trimmed = rawSpecifier.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+        return false;
+    if (/^[A-Za-z][A-Za-z0-9+.-]*:/.test(trimmed))
+        return true;
+    if (trimmed.startsWith("//"))
+        return true;
+    if (/^[A-Za-z]:[\\/]/.test(trimmed))
+        return true;
+    const withoutFragment = trimmed.split("#", 1)[0]?.split("?", 1)[0]?.trim() ?? "";
+    if (!withoutFragment)
+        return false;
+    if (withoutFragment.startsWith("./") || withoutFragment.startsWith("../") || withoutFragment.startsWith("/")) {
+        return true;
+    }
+    if (withoutFragment.includes("/") || withoutFragment.includes("\\")) {
+        return true;
+    }
+    return !!path.extname(withoutFragment).length;
+}
+//# sourceMappingURL=asciidoc.js.map

package/dist/documentLinks/asciidoc.js.map

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

package/dist/documentLinks/check.d.ts

@@ -0,0 +1,31 @@
+type MarkdownLinkCheckPosition = {
+    line: number;
+    column: number;
+};
+type MarkdownLinkCheckRange = {
+    start: MarkdownLinkCheckPosition;
+    end: MarkdownLinkCheckPosition;
+};
+export type MarkdownLinkCheckFailureReason = "missing_file" | "missing_reference" | "missing_fragment" | "outside_root";
+export type MarkdownLinkCheckFailure = {
+    file: string;
+    range: MarkdownLinkCheckRange;
+    raw: string;
+    reason: MarkdownLinkCheckFailureReason;
+    target?: string;
+};
+export type MarkdownLinkCheckResult = {
+    schemaVersion: 1;
+    root: string;
+    summary: {
+        filesScanned: number;
+        linksChecked: number;
+        externalSkipped: number;
+        failures: number;
+    };
+    failures: MarkdownLinkCheckFailure[];
+};
+export declare function checkMarkdownLinks(projectRoot: string): Promise<MarkdownLinkCheckResult>;
+export declare function checkMarkdownLinksInFiles(projectRoot: string, files: Iterable<string>): Promise<MarkdownLinkCheckResult>;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/dist/documentLinks/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/documentLinks/check.ts"],"names":[],"mappings":"AAOA,KAAK,yBAAyB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,KAAK,EAAE,yBAAyB,CAAC;IACjC,GAAG,EAAE,yBAAyB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,cAAc,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAExH,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,sBAAsB,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,8BAA8B,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC,CAAC;AAYF,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAG9F;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAqElC"}