@oa-sdk/spec-bundler 0.1.0

package/dist/link-rewriter.d.ts

@@ -0,0 +1,65 @@
+import type { LinkDiagnostic, LinkResolutionConfig } from "./types.js";
+/**
+ * Temporarily masks code blocks and inline code to prevent false-positive link mutations.
+ * Provides character-accurate original line and column mapping.
+ */
+export declare function maskCodeBlocks(markdown: string): {
+    masked: string;
+    restore: (text: string) => string;
+    getOriginalPosition: (maskedOffset: number) => {
+        line: number;
+        column: number;
+        offset: number;
+    };
+};
+/**
+ * Resolves a raw href from markdown to an absolute local filesystem path.
+ */
+export declare function resolveLocalPath(rawPath: string, sourceFileAbs: string, workspaceRoot: string): string | null;
+/**
+ * Rewrites markdown links and reference definitions in a file so that they point to bundle-relative locations.
+ */
+export declare function rewriteMarkdownContent(content: string, sourceFileAbs: string, bundleDestPath: string, sourceAbsToBundleDest: Map<string, string>, workspaceRoot: string, config?: LinkResolutionConfig): {
+    rewritten: string;
+    diagnostics: LinkDiagnostic[];
+};
+/**
+ * Rewrites TypeSpec (@evidence, relative import, and @doc markdown) references in a file
+ * so that they point to bundle-relative locations.
+ */
+export declare function rewriteTypeSpecContent(content: string, sourceFileAbs: string, bundleDestPath: string, sourceAbsToBundleDest: Map<string, string>, workspaceRoot: string, config?: LinkResolutionConfig): {
+    rewritten: string;
+    diagnostics: LinkDiagnostic[];
+};
+/**
+ * Normalizes heading text into a GitHub CommonMark-compliant anchor slug.
+ * Supports Unicode (Korean, CJK, etc.) and alphanumeric characters.
+ */
+export declare function normalizeSlug(text: string): string;
+export interface DocumentAnchors {
+    readonly slugs: Set<string>;
+    readonly explicit: Set<string>;
+    readonly all: Set<string>;
+}
+export declare function extractDocumentAnchors(content: string): DocumentAnchors;
+/**
+ * Finds high-confidence closest candidate anchor in existingAnchors using Levenshtein distance.
+ */
+export declare function findClosestAnchor(missingAnchor: string, existingAnchors: Set<string>): string | null;
+/**
+ * Verifies that all relative markdown and TypeSpec links point to files that actually exist within the bundle.
+ */
+export declare function verifyBundleLinkIntegrity(bundleEntries: Map<string, string | Buffer>, options?: {
+    severity?: "warning" | "error";
+    unbundledPolicy?: string;
+    checkAnchors?: boolean;
+}): LinkDiagnostic[];
+/**
+ * Calculates Levenshtein edit distance between two strings.
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Finds high-confidence closest candidate file path in existingFiles for a missing target path.
+ */
+export declare function findClosestFile(missingPath: string, existingFiles: Set<string>): string | null;
+//# sourceMappingURL=link-rewriter.d.ts.map