@lzehrung/codegraph-core 2.1.0

package/dist/languages/sfc.js

@@ -0,0 +1,402 @@
+import path from "node:path";
+export function detectSFCFramework(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (ext === ".vue")
+        return "vue";
+    if (ext === ".svelte")
+        return "svelte";
+    return null;
+}
+export function parseSFC(source) {
+    const blocks = [];
+    const lineIndex = buildLineIndex(source);
+    let cursor = 0;
+    while (cursor < source.length) {
+        const openTag = findNextSFCOpeningTag(source, cursor);
+        if (!openTag)
+            break;
+        const closeTag = findClosingTag(source, openTag.name, openTag.end);
+        if (!closeTag) {
+            // Malformed document: stop at the first unmatched opening tag rather
+            // than scanning inside the unclosed block and reporting its contents as
+            // additional top-level blocks.
+            break;
+        }
+        const contentStart = openTag.end;
+        const contentEnd = closeTag.start;
+        const content = source.slice(contentStart, contentEnd);
+        const startLine = lineForOffset(lineIndex, contentStart);
+        const endLine = contentStart === contentEnd ? startLine : lineForOffset(lineIndex, Math.max(contentStart, contentEnd - 1));
+        blocks.push({
+            type: openTag.name,
+            attrs: parseAttributes(openTag.attrsText),
+            content,
+            startLine,
+            endLine,
+            startOffset: contentStart,
+            endOffset: contentEnd,
+            blockStart: openTag.start,
+            blockEnd: closeTag.end,
+        });
+        cursor = closeTag.end;
+    }
+    return blocks;
+}
+export function buildSvelteTemplateBlocks(source, blocks) {
+    if (!source)
+        return [];
+    const lineIndex = buildLineIndex(source);
+    const gaps = [];
+    const occupied = blocks.map((b) => ({ start: b.blockStart, end: b.blockEnd })).sort((a, b) => a.start - b.start);
+    let cursor = 0;
+    for (const range of occupied) {
+        if (range.start > cursor)
+            gaps.push({ start: cursor, end: range.start });
+        cursor = Math.max(cursor, range.end);
+    }
+    if (cursor < source.length)
+        gaps.push({ start: cursor, end: source.length });
+    const templateBlocks = [];
+    for (const gap of gaps) {
+        const slice = source.slice(gap.start, gap.end);
+        if (!slice.trim())
+            continue;
+        const startLine = lineForOffset(lineIndex, gap.start);
+        const endLine = lineForOffset(lineIndex, Math.max(gap.start, gap.end - 1));
+        templateBlocks.push({
+            type: "template",
+            attrs: {},
+            content: slice,
+            startLine,
+            endLine,
+            startOffset: gap.start,
+            endOffset: gap.end,
+            blockStart: gap.start,
+            blockEnd: gap.end,
+        });
+    }
+    return templateBlocks;
+}
+/**
+ * Preserves a block's original offsets while making it safe to parse with the
+ * language that owns the block rather than the enclosing SFC grammar.
+ */
+export function prepareSFCBlockSource(source, block) {
+    return maskOutsideRanges(source, [{ start: block.startOffset, end: block.endOffset }]);
+}
+export function prepareSFCScriptSource(source, _framework) {
+    const blocks = parseSFC(source);
+    const scriptBlocks = blocks.filter((b) => b.type === "script");
+    const scriptLangId = inferScriptLanguage(scriptBlocks);
+    const externalScriptImports = extractExternalScriptImports(scriptBlocks);
+    if (!scriptBlocks.length) {
+        return {
+            maskedSource: appendSyntheticImports(preserveLineStructure(source), externalScriptImports),
+            scriptLangId,
+            hasScript: false,
+        };
+    }
+    const keepRanges = scriptBlocks.map((b) => ({
+        start: b.startOffset,
+        end: b.endOffset,
+    }));
+    const maskedSource = maskOutsideRanges(source, keepRanges);
+    return {
+        maskedSource: appendSyntheticImports(maskedSource, externalScriptImports),
+        scriptLangId,
+        hasScript: true,
+    };
+}
+export function inferScriptLanguage(blocks, fallback = "js") {
+    for (const block of blocks) {
+        const lang = normalizeLang(block.attrs.lang);
+        if (lang === "ts" || lang === "tsx")
+            return lang;
+    }
+    return fallback;
+}
+export function scriptLanguageIdForBlock(block) {
+    return inferScriptLanguage([block]);
+}
+export function styleLanguageKey(block) {
+    const raw = normalizeLang(block.attrs.lang) ?? normalizeLang(block.attrs.type);
+    if (!raw)
+        return "css";
+    if (raw === "scss" || raw === "less" || raw === "css")
+        return raw;
+    if (raw === "sass")
+        return "scss";
+    return null;
+}
+export function templateLanguageKey(_framework) {
+    return "html";
+}
+function normalizeLang(value) {
+    if (typeof value === "string") {
+        return value.trim().toLowerCase();
+    }
+    return undefined;
+}
+function normalizeSrc(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+function extractExternalScriptImports(blocks) {
+    const imports = [];
+    const seen = new Set();
+    for (const block of blocks) {
+        const src = normalizeSrc(block.attrs.src);
+        if (!src || seen.has(src))
+            continue;
+        seen.add(src);
+        imports.push(src);
+    }
+    return imports;
+}
+function appendSyntheticImports(source, imports) {
+    if (!imports.length)
+        return source;
+    const syntheticSource = imports.map((specifier) => `import ${JSON.stringify(specifier)};`).join("\n");
+    return `${source}\n${syntheticSource}`;
+}
+function findNextSFCOpeningTag(source, fromIndex) {
+    let index = fromIndex;
+    while (index < source.length) {
+        if (source.startsWith("<!--", index)) {
+            index = skipDelimited(source, index + 4, "-->");
+            continue;
+        }
+        if (source.startsWith("<![CDATA[", index)) {
+            index = skipDelimited(source, index + 9, "]]>");
+            continue;
+        }
+        const char = source[index];
+        if (isQuote(char)) {
+            index = skipQuotedString(source, index);
+            continue;
+        }
+        if (char !== "<") {
+            index++;
+            continue;
+        }
+        if (source[index + 1] === "/" || source[index + 1] === "!" || source[index + 1] === "?") {
+            const tagEnd = findTagEnd(source, index + 1);
+            index = tagEnd === -1 ? index + 1 : tagEnd;
+            continue;
+        }
+        const nameStart = index + 1;
+        let nameEnd = nameStart;
+        while (isTagNameCharacter(source[nameEnd]))
+            nameEnd++;
+        if (nameEnd === nameStart) {
+            index++;
+            continue;
+        }
+        const tagEnd = findTagEnd(source, nameEnd);
+        if (tagEnd === -1) {
+            index = nameEnd;
+            continue;
+        }
+        const tagName = source.slice(nameStart, nameEnd).toLowerCase();
+        const attrsEnd = source[tagEnd - 2] === "/" ? tagEnd - 2 : tagEnd - 1;
+        if ((tagName === "template" || tagName === "script" || tagName === "style") &&
+            isTagBoundary(source[nameEnd]) &&
+            source[tagEnd - 2] !== "/") {
+            return {
+                name: tagName,
+                attrsText: source.slice(nameEnd, attrsEnd),
+                start: index,
+                end: tagEnd,
+            };
+        }
+        index = tagEnd;
+    }
+    return null;
+}
+function findClosingTag(source, tag, fromIndex) {
+    let index = fromIndex;
+    // Template bodies are parsed content and commonly nest same-name blocks
+    // (Vue <template v-if>), so their close tag is matched by depth. Script and
+    // style bodies are raw text that cannot nest, so the first matching close
+    // tag still wins there.
+    let depth = 1;
+    const trackNesting = tag === "template";
+    while (index < source.length) {
+        if (source.startsWith("<!--", index)) {
+            index = skipDelimited(source, index + 4, "-->");
+            continue;
+        }
+        if (source.startsWith("<![CDATA[", index)) {
+            index = skipDelimited(source, index + 9, "]]>");
+            continue;
+        }
+        const char = source[index];
+        if (isQuote(char)) {
+            index = skipQuotedString(source, index);
+            continue;
+        }
+        if (tag === "script" && source.startsWith("//", index)) {
+            index = skipLineComment(source, index + 2);
+            continue;
+        }
+        if ((tag === "script" || tag === "style") && source.startsWith("/*", index)) {
+            index = skipDelimited(source, index + 2, "*/");
+            continue;
+        }
+        if (char !== "<") {
+            index++;
+            continue;
+        }
+        if (source[index + 1] === "/") {
+            const nameStart = index + 2;
+            if (!matchesCaseInsensitive(source, nameStart, tag)) {
+                index++;
+                continue;
+            }
+            const nameEnd = nameStart + tag.length;
+            if (!isTagBoundary(source[nameEnd])) {
+                index++;
+                continue;
+            }
+            const tagEnd = findTagEnd(source, nameEnd);
+            if (tagEnd === -1) {
+                index++;
+                continue;
+            }
+            depth--;
+            if (depth === 0)
+                return { start: index, end: tagEnd };
+            index = tagEnd;
+            continue;
+        }
+        if (trackNesting) {
+            const nameStart = index + 1;
+            if (matchesCaseInsensitive(source, nameStart, tag)) {
+                const nameEnd = nameStart + tag.length;
+                if (isTagBoundary(source[nameEnd])) {
+                    const tagEnd = findTagEnd(source, nameEnd);
+                    if (tagEnd !== -1) {
+                        if (source[tagEnd - 2] !== "/")
+                            depth++;
+                        index = tagEnd;
+                        continue;
+                    }
+                }
+            }
+        }
+        index++;
+    }
+    return null;
+}
+function findTagEnd(source, fromIndex) {
+    let index = fromIndex;
+    while (index < source.length) {
+        const char = source[index];
+        if (isQuote(char)) {
+            index = skipQuotedString(source, index);
+            continue;
+        }
+        if (char === ">")
+            return index + 1;
+        index++;
+    }
+    return -1;
+}
+function skipQuotedString(source, quoteStart) {
+    const quote = source[quoteStart];
+    let index = quoteStart + 1;
+    while (index < source.length) {
+        if (source[index] === "\\") {
+            index += 2;
+            continue;
+        }
+        if (source[index] === quote)
+            return index + 1;
+        index++;
+    }
+    return source.length;
+}
+function skipDelimited(source, contentStart, closing) {
+    const closingIndex = source.indexOf(closing, contentStart);
+    return closingIndex === -1 ? source.length : closingIndex + closing.length;
+}
+function skipLineComment(source, contentStart) {
+    const newline = source.indexOf("\n", contentStart);
+    return newline === -1 ? source.length : newline + 1;
+}
+function matchesCaseInsensitive(source, start, value) {
+    if (start + value.length > source.length)
+        return false;
+    for (let index = 0; index < value.length; index++) {
+        if (source[start + index].toLowerCase() !== value[index])
+            return false;
+    }
+    return true;
+}
+function isTagNameCharacter(char) {
+    return !!char && /[A-Za-z0-9:_-]/.test(char);
+}
+function isTagBoundary(char) {
+    return char === undefined || char === ">" || char === "/" || /\s/.test(char);
+}
+function isQuote(char) {
+    return char === "'" || char === '"' || char === "`";
+}
+function parseAttributes(source) {
+    const attrs = {};
+    const attrRegex = /([^\s=]+)(?:=(?:"([^"]*)"|'([^']*)'|([^\s"'>]+)))?/g;
+    let match;
+    while ((match = attrRegex.exec(source)) !== null) {
+        const key = match[1] ?? "";
+        const value = match[2] ?? match[3] ?? match[4] ?? true;
+        attrs[key] = value;
+    }
+    return attrs;
+}
+function buildLineIndex(text) {
+    const index = [0];
+    for (let i = 0; i < text.length; i++) {
+        if (text[i] === "\n") {
+            index.push(i + 1);
+        }
+    }
+    return index;
+}
+function lineForOffset(index, offset) {
+    let lo = 0;
+    let hi = index.length - 1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (index[mid] <= offset)
+            lo = mid + 1;
+        else
+            hi = mid - 1;
+    }
+    return hi + 1;
+}
+function maskOutsideRanges(source, ranges) {
+    if (!ranges.length)
+        return preserveLineStructure(source);
+    const sorted = [...ranges].sort((a, b) => a.start - b.start);
+    let current = sorted.shift();
+    const chars = source.split("");
+    for (let i = 0; i < chars.length; i++) {
+        while (current && i >= current.end) {
+            current = sorted.shift();
+        }
+        const inside = current && i >= current.start && i < current.end;
+        if (inside)
+            continue;
+        const ch = chars[i];
+        if (ch === "\n" || ch === "\r")
+            continue;
+        chars[i] = " ";
+    }
+    return chars.join("");
+}
+function preserveLineStructure(text) {
+    return text.replace(/[^\r\n]/g, " ");
+}
+//# sourceMappingURL=sfc.js.map

package/dist/languages/sfc.js.map

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

package/dist/languages/types.d.ts

@@ -0,0 +1,110 @@
+import type { ParserLanguage, ParserSyntaxNode, SyntaxPoint } from "../parserBackend.js";
+export type { ParserLanguage };
+export type SyntaxPositionLike = SyntaxPoint;
+export type SyntaxNodeLike = ParserSyntaxNode;
+export interface SyntaxTreeLike {
+    rootNode: SyntaxNodeLike & {
+        descendantForIndex(startIndex: number, endIndex: number): SyntaxNodeLike;
+        descendantForPosition(start: SyntaxPositionLike, end: SyntaxPositionLike): SyntaxNodeLike;
+    };
+}
+export type NativeQueryKind = "imports" | "exports" | "locals" | "importBindings";
+export type NativeCompatibilityQueryKind = NativeQueryKind | "adHoc";
+export interface NativeCompatibility {
+    normalizeQuery?: (kind: NativeCompatibilityQueryKind, query: string) => string;
+    authoritativeKinds?: NativeQueryKind[];
+    notes?: string[];
+}
+export interface LanguageDefinition {
+    id: string;
+    extensions: string[];
+    grammar: (filename?: string) => ParserLanguage;
+    /**
+     * Configuration for semantic chunking.
+     * Defines how to split code into meaningful blocks.
+     */
+    structure: {
+        /** Node types that represent cohesive units (functions, classes) */
+        blocks: BlockDefinition[];
+        /** Node types that represent inner control flow to split on (if, loops) */
+        splitPoints: string[];
+        /** Node types for comments */
+        comments: string[];
+    };
+    /**
+     * Configuration for dependency graphing and symbol indexing.
+     */
+    graph: {
+        /** Tree-sitter query string for imports */
+        imports: string;
+        /** Tree-sitter query string for exports */
+        exports: string;
+        /** Tree-sitter query string for local definitions */
+        locals: string;
+        /** Tree-sitter query string for import bindings */
+        importBindings: string;
+    };
+    /**
+     * Whether native local-definition captures are authoritative for this language.
+     */
+    usesQueryDrivenLocals?: boolean;
+    /**
+     * Helper to classify a definition node (function vs class vs var).
+     */
+    classifyDefinition?: (node: SyntaxNodeLike) => string;
+    /**
+     * Helper to check if a node is a declaration name.
+     */
+    isDeclarationName?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Names that must be registered by scope construction in addition to its
+     * structural declaration handling. "all" preserves a language's established
+     * declaration-name semantics; a predicate can opt in a missing node shape.
+     */
+    scopeDeclarationNames?: "all" | ((node: SyntaxNodeLike) => boolean);
+    /**
+     * Normalizes syntax-specific identifier spelling for lexical scope matching.
+     */
+    normalizeIdentifier?: (name: string) => string;
+    /**
+     * Helper to check if a node creates a block scope.
+     */
+    createsBlockScope?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Helper to check if a node creates a function scope.
+     */
+    createsFunctionScope?: (node: SyntaxNodeLike) => boolean;
+    /**
+     * Whether an unqualified call within a type can resolve to one of its members.
+     */
+    membersAreImplicitlyInScope?: boolean;
+    /**
+     * Whether the language supports cross-module symbol resolution.
+     */
+    supportsCrossModuleSymbols?: boolean;
+    /**
+     * Helper to check if a statement represents a type-only dependency.
+     */
+    isTypeOnly?: (stmtText: string) => boolean;
+    /**
+     * Specific node types used for symbol resolution
+     */
+    nodeTypes?: {
+        identifier: string[];
+        propertyIdentifier?: string[];
+        shorthandPropertyIdentifier?: string[];
+        memberExpression?: string;
+    };
+    /**
+     * Optional native-runtime compatibility hooks for grammar/query differences.
+     */
+    native?: NativeCompatibility;
+}
+export interface BlockDefinition {
+    type: string;
+    nameQuery?: string;
+    captureId?: string;
+    parentType?: string;
+    isBlock?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/languages/types.d.ts.map

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

package/dist/languages/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/languages/types.js.map

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

package/dist/languages.d.ts

@@ -0,0 +1,63 @@
+import type { ParserLanguage, NativeCompatibility, SyntaxNodeLike } from "./languages/types.js";
+import "./languages/all.js";
+export type IdentifierNodeType = string;
+export type LanguageSupport = {
+    id: string;
+    matchExts: string[];
+    language: (filename: string) => ParserLanguage;
+    nodeTypes: {
+        identifier: IdentifierNodeType[];
+        propertyIdentifier?: IdentifierNodeType[];
+        shorthandPropertyIdentifier?: IdentifierNodeType[];
+        memberExpression?: string;
+    };
+    queries: {
+        imports: string;
+        exports: string;
+        locals: string;
+        importBindings: string;
+    };
+    classifyDefinition: (nameNode: SyntaxNodeLike) => string;
+    isDeclarationName: (node: SyntaxNodeLike) => boolean;
+    scopeDeclarationNames: (node: SyntaxNodeLike) => boolean;
+    createsBlockScope: (node: SyntaxNodeLike) => boolean;
+    createsFunctionScope: (node: SyntaxNodeLike) => boolean;
+    membersAreImplicitlyInScope: boolean;
+    supportsCrossModuleSymbols: boolean;
+    isTypeOnly: (stmtText: string) => boolean;
+    usesQueryDrivenLocals: boolean;
+    native?: NativeCompatibility;
+    normalizeIdentifier: (name: string) => string;
+};
+export declare const TS_SUPPORT: LanguageSupport;
+export declare const TSX_SUPPORT: LanguageSupport;
+export declare const JS_SUPPORT: LanguageSupport;
+export declare const PY_SUPPORT: LanguageSupport;
+export declare const PHP_SUPPORT: LanguageSupport;
+export declare const HTML_SUPPORT: LanguageSupport;
+export declare const CSS_SUPPORT: LanguageSupport;
+export declare const SCSS_SUPPORT: LanguageSupport;
+export declare const LESS_SUPPORT: LanguageSupport;
+export declare const VUE_SUPPORT: LanguageSupport;
+export declare const SVELTE_SUPPORT: LanguageSupport;
+export declare const RUBY_SUPPORT: LanguageSupport;
+export declare const GO_SUPPORT: LanguageSupport;
+export declare const JAVA_SUPPORT: LanguageSupport;
+export declare const CSHARP_SUPPORT: LanguageSupport;
+export declare const RUST_SUPPORT: LanguageSupport;
+export declare const C_SUPPORT: LanguageSupport;
+export declare const CPP_SUPPORT: LanguageSupport;
+export declare const KOTLIN_SUPPORT: LanguageSupport;
+export declare const SWIFT_SUPPORT: LanguageSupport;
+export declare const ZIG_SUPPORT: LanguageSupport;
+export declare const SQL_SUPPORT: LanguageSupport;
+export declare const LANGUAGE_SUPPORTS: LanguageSupport[];
+export type LanguageExtensionMap = Record<string, string>;
+export declare function isLiteralLanguageExtension(extension: string): boolean;
+export declare function isRemappableLanguageExtension(extension: string): boolean;
+export declare function normalizeLanguageExtensions(extensions: LanguageExtensionMap | undefined): LanguageExtensionMap | undefined;
+export declare function languageExtensionPatterns(extensions: LanguageExtensionMap | undefined): string[];
+export declare function supportForFile(filename: string, extensionMap?: LanguageExtensionMap | undefined): LanguageSupport | undefined;
+export declare function languageForFile(filename: string, extensionMap?: LanguageExtensionMap | undefined): ParserLanguage;
+export declare function supportById(id: string): LanguageSupport | undefined;
+//# sourceMappingURL=languages.d.ts.map

package/dist/languages.d.ts.map

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