universal-ast-mapper 1.27.0 → 2.0.0

package/dist/extractors/java.js

@@ -1,152 +0,0 @@
-import { namedChildren, nameOf, headerSignature, leadingComment } from "../parser.js";
-import { makeSymbol } from "./common.js";
-/* ─── helpers ─────────────────────────────────────────────────────────────── */
-function childOfType(node, type) {
-    for (let i = 0; i < node.childCount; i++) {
-        const c = node.child(i);
-        if (c && c.type === type)
-            return c;
-    }
-    return null;
-}
-function modifiersText(node) {
-    const m = childOfType(node, "modifiers");
-    return m ? m.text : "";
-}
-function vis(node) {
-    const m = modifiersText(node);
-    if (/\b(private|protected)\b/.test(m))
-        return "private";
-    return "public";
-}
-function exported(node) {
-    return /\bpublic\b/.test(modifiersText(node));
-}
-/* ─── directives (package declaration) ────────────────────────────────────── */
-export function extractDirectivesJava(root, _source) {
-    for (const child of namedChildren(root)) {
-        if (child.type !== "package_declaration")
-            continue;
-        const id = childOfType(child, "scoped_identifier") ?? childOfType(child, "identifier");
-        if (id)
-            return [`package:${id.text}`];
-    }
-    return [];
-}
-/* ─── import extraction ───────────────────────────────────────────────────── */
-export function extractImportsJava(root, _source) {
-    const out = [];
-    for (const child of namedChildren(root)) {
-        if (child.type !== "import_declaration")
-            continue;
-        const isStatic = /\bstatic\b/.test(child.text);
-        const isWildcard = /\.\s*\*/.test(child.text);
-        const pathNode = childOfType(child, "scoped_identifier") ?? childOfType(child, "identifier");
-        const from = pathNode ? pathNode.text : child.text.replace(/^import\s+|;\s*$/g, "").trim();
-        if (isWildcard) {
-            out.push({ symbol: "*", from, isNamespaceImport: true, isTypeOnly: !isStatic });
-        }
-        else {
-            const symbol = from.split(".").pop() ?? from;
-            out.push({ symbol, from, isTypeOnly: !isStatic });
-        }
-    }
-    return out;
-}
-/* ─── symbol extraction ───────────────────────────────────────────────────── */
-export function extractJava(root, _source) {
-    return collect(namedChildren(root));
-}
-function collect(nodes) {
-    const out = [];
-    for (const n of nodes) {
-        const res = handle(n);
-        if (Array.isArray(res))
-            out.push(...res);
-        else if (res)
-            out.push(res);
-    }
-    return out;
-}
-function handle(node) {
-    switch (node.type) {
-        case "class_declaration":
-        case "record_declaration": {
-            const body = node.childForFieldName("body");
-            return makeSymbol({
-                name: nameOf(node) ?? "(class)",
-                kind: "class",
-                node,
-                rawKind: node.type,
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-                children: body ? collect(namedChildren(body)) : [],
-            });
-        }
-        case "interface_declaration": {
-            const body = node.childForFieldName("body");
-            return makeSymbol({
-                name: nameOf(node) ?? "(interface)",
-                kind: "interface",
-                node,
-                rawKind: node.type,
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-                children: body ? collect(namedChildren(body)) : [],
-            });
-        }
-        case "enum_declaration": {
-            const body = node.childForFieldName("body");
-            return makeSymbol({
-                name: nameOf(node) ?? "(enum)",
-                kind: "enum",
-                node,
-                rawKind: node.type,
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-                children: body ? collect(namedChildren(body).filter((c) => c.type !== "enum_constant")) : [],
-            });
-        }
-        case "method_declaration":
-        case "constructor_declaration":
-            return makeSymbol({
-                name: nameOf(node) ?? "(method)",
-                kind: "method",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, node.childForFieldName("body")),
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-            });
-        case "field_declaration":
-            return fieldDeclarators(node);
-        default:
-            return null;
-    }
-}
-function fieldDeclarators(node) {
-    const m = modifiersText(node);
-    const kind = /\bstatic\b/.test(m) && /\bfinal\b/.test(m) ? "const" : "field";
-    const out = [];
-    for (const decl of namedChildren(node)) {
-        if (decl.type !== "variable_declarator")
-            continue;
-        const name = nameOf(decl);
-        if (!name)
-            continue;
-        out.push(makeSymbol({
-            name,
-            kind,
-            node: decl,
-            rawKind: node.type,
-            signature: node.text.replace(/\s+/g, " ").replace(/;$/, "").trim(),
-            visibility: vis(node),
-            exported: exported(node),
-        }));
-    }
-    return out;
-}

package/dist/extractors/kotlin.js

@@ -1,159 +0,0 @@
-import { namedChildren, headerSignature, leadingComment } from "../parser.js";
-import { makeSymbol } from "./common.js";
-/* ─── helpers ─────────────────────────────────────────────────────────────── */
-function childOfType(node, type) {
-    for (let i = 0; i < node.childCount; i++) {
-        const c = node.child(i);
-        if (c && c.type === type)
-            return c;
-    }
-    return null;
-}
-function firstChildOfTypes(node, types) {
-    for (let i = 0; i < node.namedChildCount; i++) {
-        const c = node.namedChild(i);
-        if (c && types.has(c.type))
-            return c;
-    }
-    return null;
-}
-const TYPE_NAME_NODES = new Set(["type_identifier", "simple_identifier"]);
-const SIMPLE_NAME_NODES = new Set(["simple_identifier"]);
-function modifiersText(node) {
-    const m = childOfType(node, "modifiers");
-    return m ? m.text : "";
-}
-function vis(node) {
-    const m = modifiersText(node);
-    if (/\b(private|protected|internal)\b/.test(m))
-        return "private";
-    return "public"; // Kotlin default is public
-}
-function exported(node) {
-    const m = modifiersText(node);
-    if (/\b(private|protected|internal)\b/.test(m))
-        return false;
-    return true;
-}
-function classKind(node) {
-    const m = modifiersText(node);
-    if (/\bdata\b/.test(node.text.slice(0, 80)))
-        return "class";
-    if (/\benum\b/.test(node.text.slice(0, 80)))
-        return "enum";
-    return "class";
-}
-/* ─── imports + package ───────────────────────────────────────────────────── */
-export function extractDirectivesKotlin(root, _source) {
-    for (const c of namedChildren(root)) {
-        if (c.type === "package_header") {
-            const id = childOfType(c, "identifier");
-            if (id)
-                return [`package:${id.text}`];
-        }
-    }
-    return [];
-}
-export function extractImportsKotlin(root, _source) {
-    const out = [];
-    const list = childOfType(root, "import_list");
-    if (!list)
-        return out;
-    for (const h of namedChildren(list)) {
-        if (h.type !== "import_header")
-            continue;
-        const id = childOfType(h, "identifier");
-        if (!id)
-            continue;
-        const isWildcard = /\.\*\s*$/.test(h.text);
-        const from = id.text;
-        const sym = isWildcard ? "*" : (from.split(".").pop() ?? from);
-        out.push({ symbol: sym, from, isNamespaceImport: isWildcard });
-    }
-    return out;
-}
-/* ─── symbol extraction ───────────────────────────────────────────────────── */
-export function extractKotlin(root, _source) {
-    return collect(namedChildren(root), false);
-}
-function collect(nodes, insideClass) {
-    const out = [];
-    for (const n of nodes) {
-        const res = handle(n, insideClass);
-        if (res)
-            out.push(res);
-    }
-    return out;
-}
-function handle(node, insideClass) {
-    switch (node.type) {
-        case "class_declaration": {
-            const nameNode = firstChildOfTypes(node, TYPE_NAME_NODES);
-            if (!nameNode)
-                return null;
-            const body = childOfType(node, "class_body") ?? childOfType(node, "enum_class_body");
-            return makeSymbol({
-                name: nameNode.text,
-                kind: classKind(node),
-                node,
-                rawKind: node.type,
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-                children: body ? collect(namedChildren(body), true) : [],
-            });
-        }
-        case "object_declaration": {
-            const nameNode = firstChildOfTypes(node, TYPE_NAME_NODES);
-            if (!nameNode)
-                return null;
-            const body = childOfType(node, "class_body");
-            return makeSymbol({
-                name: nameNode.text,
-                kind: "class",
-                node,
-                rawKind: node.type,
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-                children: body ? collect(namedChildren(body), true) : [],
-            });
-        }
-        case "function_declaration": {
-            const nameNode = firstChildOfTypes(node, SIMPLE_NAME_NODES);
-            if (!nameNode)
-                return null;
-            const body = childOfType(node, "function_body");
-            return makeSymbol({
-                name: nameNode.text,
-                kind: insideClass ? "method" : "function",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, body),
-                visibility: vis(node),
-                exported: exported(node),
-                doc: leadingComment(node),
-            });
-        }
-        case "property_declaration": {
-            // variable_declaration → simple_identifier
-            const vd = childOfType(node, "variable_declaration");
-            const nameNode = vd ? firstChildOfTypes(vd, SIMPLE_NAME_NODES) : firstChildOfTypes(node, SIMPLE_NAME_NODES);
-            if (!nameNode)
-                return null;
-            const m = modifiersText(node);
-            const kind = insideClass ? "field" : (/\bconst\b/.test(m) ? "const" : "var");
-            return makeSymbol({
-                name: nameNode.text,
-                kind,
-                node,
-                rawKind: node.type,
-                signature: node.text.replace(/\s+/g, " ").trim(),
-                visibility: vis(node),
-                exported: exported(node),
-            });
-        }
-        default:
-            return null;
-    }
-}

package/dist/extractors/php.js

@@ -1,208 +0,0 @@
-import { namedChildren, nameOf, headerSignature, leadingComment } from "../parser.js";
-import { makeSymbol } from "./common.js";
-// ─── PHP extractor (tree-sitter-php) ──────────────────────────────────────────
-export function extractPhp(root, _source) {
-    return collect(namedChildren(root));
-}
-function collect(nodes) {
-    const out = [];
-    for (const n of nodes) {
-        const sym = handle(n);
-        if (sym)
-            out.push(sym);
-        else if (n.type === "namespace_definition") {
-            // `namespace Foo;` (no braces) — siblings follow; emit the namespace marker.
-            const name = nameOf(n)?.replace(/\s+/g, "") ?? namespaceName(n);
-            if (name) {
-                out.push(makeSymbol({ name, kind: "namespace", node: n, rawKind: n.type }));
-            }
-            const body = n.childForFieldName("body");
-            if (body)
-                out[out.length - 1].children = collect(namedChildren(body));
-        }
-        else if (n.type === "expression_statement" || n.type === "if_statement") {
-            // skip — top-level statements
-        }
-    }
-    return out;
-}
-function namespaceName(n) {
-    for (const c of namedChildren(n)) {
-        if (c.type === "namespace_name")
-            return c.text.replace(/\s+/g, "");
-    }
-    return null;
-}
-function phpVisibility(node) {
-    for (const c of namedChildren(node)) {
-        if (c.type === "visibility_modifier") {
-            const t = c.text;
-            if (t === "private" || t === "protected")
-                return "private";
-            return "public";
-        }
-    }
-    return "public";
-}
-function classLike(node, kind) {
-    const name = nameOf(node) ?? "(class)";
-    const body = node.childForFieldName("body") ?? findChild(node, "declaration_list");
-    return makeSymbol({
-        name,
-        kind,
-        node,
-        rawKind: node.type,
-        signature: headerSignature(node, body),
-        doc: leadingComment(node),
-        children: body ? collect(namedChildren(body)) : [],
-    });
-}
-function findChild(node, type) {
-    for (const c of namedChildren(node))
-        if (c.type === type)
-            return c;
-    return null;
-}
-function handle(node) {
-    switch (node.type) {
-        case "class_declaration":
-        case "trait_declaration":
-            return classLike(node, "class");
-        case "interface_declaration":
-            return classLike(node, "interface");
-        case "enum_declaration": {
-            const body = findChild(node, "enum_declaration_list");
-            return makeSymbol({
-                name: nameOf(node) ?? "(enum)",
-                kind: "enum",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, body),
-                doc: leadingComment(node),
-                children: body
-                    ? namedChildren(body)
-                        .filter((c) => c.type === "enum_case")
-                        .map((c) => makeSymbol({ name: nameOf(c) ?? c.text, kind: "const", node: c, rawKind: c.type }))
-                    : [],
-            });
-        }
-        case "function_definition": {
-            const body = node.childForFieldName("body") ?? findChild(node, "compound_statement");
-            return makeSymbol({
-                name: nameOf(node) ?? "(function)",
-                kind: "function",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, body),
-                doc: leadingComment(node),
-            });
-        }
-        case "method_declaration": {
-            const body = node.childForFieldName("body") ?? findChild(node, "compound_statement");
-            const vis = phpVisibility(node);
-            return makeSymbol({
-                name: nameOf(node) ?? "(method)",
-                kind: "method",
-                node,
-                rawKind: node.type,
-                signature: headerSignature(node, body),
-                visibility: vis,
-                exported: vis === "public",
-                doc: leadingComment(node),
-            });
-        }
-        case "const_declaration": {
-            const el = findChild(node, "const_element");
-            const name = el ? namedChildren(el)[0]?.text : null;
-            if (!name)
-                return null;
-            const vis = phpVisibility(node);
-            return makeSymbol({
-                name,
-                kind: "const",
-                node,
-                rawKind: node.type,
-                visibility: vis,
-                exported: vis === "public",
-            });
-        }
-        case "property_declaration": {
-            const decl = findChild(node, "property_element");
-            const name = decl?.text.replace(/\s*=.*$/, "").trim();
-            if (!name)
-                return null;
-            const vis = phpVisibility(node);
-            return makeSymbol({
-                name,
-                kind: "field",
-                node,
-                rawKind: node.type,
-                visibility: vis,
-                exported: vis === "public",
-            });
-        }
-        default:
-            return null;
-    }
-}
-// ─── Import extraction ────────────────────────────────────────────────────────
-// `use App\Models\User;`, grouped `use App\{A, B};`, and require/include calls.
-export function extractImportsPhp(root, _source) {
-    const imports = [];
-    walk(root, imports, 0);
-    return imports;
-}
-function walk(node, out, depth) {
-    if (depth > 4)
-        return;
-    for (const c of namedChildren(node)) {
-        if (c.type === "namespace_use_declaration")
-            parseUse(c, out);
-        else if (c.type === "require_expression" ||
-            c.type === "require_once_expression" ||
-            c.type === "include_expression" ||
-            c.type === "include_once_expression") {
-            const str = findString(c);
-            if (str)
-                out.push({ symbol: "*", from: str, isSideEffect: true });
-        }
-        else {
-            walk(c, out, depth + 1);
-        }
-    }
-}
-function findString(node) {
-    for (const c of namedChildren(node)) {
-        if (c.type === "string")
-            return c.text.replace(/^['"]|['"]$/g, "");
-        const deep = findString(c);
-        if (deep)
-            return deep;
-    }
-    return null;
-}
-function parseUse(node, out) {
-    let groupBase = null;
-    for (const c of namedChildren(node)) {
-        if (c.type === "namespace_name")
-            groupBase = c.text.replace(/\s+/g, "");
-        else if (c.type === "namespace_use_clause") {
-            const qn = c.text.replace(/\s+as\s+.*$/, "").replace(/\s+/g, "");
-            const alias = /\s+as\s+(\w+)/.exec(c.text)?.[1];
-            const leaf = qn.split("\\").pop() ?? qn;
-            const imp = { symbol: leaf, from: qn };
-            if (alias)
-                imp.alias = alias;
-            out.push(imp);
-        }
-        else if (c.type === "namespace_use_group") {
-            for (const g of namedChildren(c)) {
-                if (g.type !== "namespace_use_group_clause")
-                    continue;
-                const txt = g.text.replace(/\s+/g, "");
-                const leaf = txt.split("\\").pop() ?? txt;
-                out.push({ symbol: leaf, from: groupBase ? `${groupBase}\\${txt}` : txt });
-            }
-        }
-    }
-}

package/dist/extractors/python.js

@@ -1,153 +0,0 @@
-import { namedChildren, nameOf, headerSignature } from "../parser.js";
-import { makeSymbol, pythonVisibility } from "./common.js";
-export function extractPython(root, _source) {
-    return collect(namedChildren(root), false);
-}
-function collect(nodes, insideClass) {
-    const out = [];
-    for (const n of nodes) {
-        const res = handle(n, insideClass);
-        if (res)
-            out.push(res);
-    }
-    return out;
-}
-function handle(node, insideClass) {
-    if (node.type === "decorated_definition") {
-        const inner = innerDefinition(node);
-        if (!inner)
-            return null;
-        const sym = handle(inner, insideClass);
-        if (sym) {
-            const decs = namedChildren(node)
-                .filter((c) => c.type === "decorator")
-                .map((d) => d.text.replace(/^@\s*/, "").replace(/\s+/g, " ").trim())
-                .filter((t) => t.length > 0);
-            if (decs.length > 0)
-                sym.decorators = decs;
-        }
-        return sym;
-    }
-    if (node.type === "class_definition") {
-        const name = nameOf(node) ?? "(class)";
-        const body = node.childForFieldName("body");
-        const children = body ? collect(namedChildren(body), true) : [];
-        return makeSymbol({
-            name,
-            kind: "class",
-            node,
-            rawKind: node.type,
-            visibility: pythonVisibility(name),
-            exported: pythonVisibility(name) === "public",
-            doc: body ? docstring(body) : null,
-            children,
-        });
-    }
-    if (node.type === "function_definition") {
-        const name = nameOf(node) ?? "(function)";
-        const body = node.childForFieldName("body");
-        return makeSymbol({
-            name,
-            kind: insideClass ? "method" : "function",
-            node,
-            rawKind: node.type,
-            signature: headerSignature(node, body),
-            visibility: pythonVisibility(name),
-            exported: pythonVisibility(name) === "public",
-            doc: body ? docstring(body) : null,
-        });
-    }
-    return null;
-}
-function innerDefinition(decorated) {
-    const byField = decorated.childForFieldName("definition");
-    if (byField)
-        return byField;
-    for (const c of namedChildren(decorated)) {
-        if (c.type === "function_definition" || c.type === "class_definition")
-            return c;
-    }
-    return null;
-}
-// ─── Import extraction ────────────────────────────────────────────────────────
-export function extractImportsPython(root, _source) {
-    const imports = [];
-    for (const child of namedChildren(root)) {
-        if (child.type === "import_statement")
-            parseSimpleImport(child, imports);
-        else if (child.type === "import_from_statement")
-            parseFromImport(child, imports);
-    }
-    return imports;
-}
-function parseSimpleImport(node, out) {
-    for (let i = 0; i < node.namedChildCount; i++) {
-        const c = node.namedChild(i);
-        if (!c)
-            continue;
-        if (c.type === "dotted_name" || c.type === "identifier") {
-            out.push({ symbol: c.text, from: c.text });
-        }
-        else if (c.type === "aliased_import") {
-            const nameNode = c.childForFieldName("name");
-            const aliasNode = c.childForFieldName("alias");
-            if (nameNode) {
-                const imp = { symbol: nameNode.text, from: nameNode.text };
-                if (aliasNode)
-                    imp.alias = aliasNode.text;
-                out.push(imp);
-            }
-        }
-    }
-}
-/**
- * Convert Python import path to a JS-style relative path.
- * ".models" → "./models", "..utils" → "../utils", "os" → "os" (external).
- */
-function pythonFromPath(raw) {
-    const m = raw.match(/^(\.+)(.*)/);
-    if (!m)
-        return raw; // absolute/external import
-    const dotCount = m[1].length;
-    const rest = m[2]; // module name after the dots, e.g. "models" or ""
-    const upDirs = dotCount === 1 ? "." : Array(dotCount - 1).fill("..").join("/");
-    return rest ? `${upDirs}/${rest.replace(/\./g, "/")}` : upDirs;
-}
-function parseFromImport(node, out) {
-    const moduleNode = node.childForFieldName("module_name");
-    const from = moduleNode ? pythonFromPath(moduleNode.text) : ".";
-    for (let i = 0; i < node.namedChildCount; i++) {
-        const c = node.namedChild(i);
-        if (!c || c === moduleNode)
-            continue;
-        if (c.type === "wildcard_import") {
-            out.push({ symbol: "*", from, isNamespaceImport: true });
-        }
-        else if (c.type === "relative_import" || c.type === "dotted_name") {
-            // skip — these are part of the module path, not the imported names
-        }
-        else if (c.type === "identifier") {
-            out.push({ symbol: c.text, from });
-        }
-        else if (c.type === "aliased_import") {
-            const nameNode = c.childForFieldName("name");
-            const aliasNode = c.childForFieldName("alias");
-            if (nameNode) {
-                const imp = { symbol: nameNode.text, from };
-                if (aliasNode)
-                    imp.alias = aliasNode.text;
-                out.push(imp);
-            }
-        }
-    }
-}
-/** Extract a leading triple-quoted docstring from a `block`. */
-function docstring(body) {
-    const first = body.namedChild(0);
-    if (!first || first.type !== "expression_statement")
-        return null;
-    const str = first.namedChild(0);
-    if (!str || str.type !== "string")
-        return null;
-    return str.text.replace(/^[rbuRBU]*("""|'''|"|')/, "").replace(/("""|'''|"|')$/, "").trim().slice(0, 500);
-}