cgraphx 1.1.0

package/dist/extraction/languages/kotlin.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kotlinExtractor = void 0;
+const tree_sitter_helpers_1 = require("../tree-sitter-helpers");
+/** Kotlin return types that can't be a chained-call receiver (no class to chain on). */
+const KOTLIN_NON_CLASS_RETURN = new Set(['Unit', 'Nothing']);
+/**
+ * A Kotlin function's declared return type, normalized to the bare class name a
+ * chained `Foo.getInstance().bar()` could be called on (the #645/#608 mechanism).
+ * tree-sitter-kotlin exposes no field names, so the return type is found
+ * positionally: the first `user_type` / `nullable_type` that FOLLOWS
+ * `function_value_parameters` (an extension receiver's type sits before the
+ * params, so it's never mistaken for the return). An inferred return (expression
+ * body with no `: Type`), a lambda return type, or `Unit` / `Nothing` → undefined.
+ */
+function extractKotlinReturnType(node, source) {
+    let seenParams = false;
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (!child)
+            continue;
+        if (child.type === 'function_value_parameters') {
+            seenParams = true;
+            continue;
+        }
+        if (!seenParams)
+            continue;
+        // The return type is the type node right after the params. If we reach the
+        // body or a `where`-clause first, there's no declared return type.
+        if (child.type === 'function_body' || child.type === 'type_constraints')
+            return undefined;
+        if (child.type === 'user_type' || child.type === 'nullable_type') {
+            const ut = child.type === 'nullable_type'
+                ? (child.namedChildren.find((c) => c.type === 'user_type') ?? child)
+                : child;
+            const typeId = ut.namedChildren.find((c) => c.type === 'type_identifier');
+            const name = (0, tree_sitter_helpers_1.getNodeText)(typeId ?? ut, source).trim();
+            if (!name || !/^[A-Za-z_]\w*$/.test(name))
+                return undefined;
+            if (KOTLIN_NON_CLASS_RETURN.has(name))
+                return undefined;
+            return name;
+        }
+    }
+    return undefined;
+}
+/** Check if a node matches the `fun interface` misparse pattern */
+function isFunInterfaceNode(node) {
+    let hasFun = false;
+    let hasInterfaceType = false;
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (!child)
+            continue;
+        if (child.type === 'fun' && !child.isNamed)
+            hasFun = true;
+        if (child.type === 'user_type') {
+            const typeId = child.namedChildren.find((c) => c.type === 'type_identifier');
+            if (typeId && typeId.text === 'interface')
+                hasInterfaceType = true;
+        }
+        // Pattern 2b: user_type("interface") is inside an ERROR child
+        if (child.type === 'ERROR') {
+            for (let j = 0; j < child.childCount; j++) {
+                const gc = child.child(j);
+                if (gc && gc.type === 'user_type') {
+                    const typeId = gc.namedChildren.find((c) => c.type === 'type_identifier');
+                    if (typeId && typeId.text === 'interface')
+                        hasInterfaceType = true;
+                }
+            }
+        }
+    }
+    return hasFun && hasInterfaceType;
+}
+exports.kotlinExtractor = {
+    functionTypes: ['function_declaration'],
+    classTypes: ['class_declaration'],
+    methodTypes: ['function_declaration'], // Methods are functions inside classes
+    interfaceTypes: [], // Handled via classifyClassNode
+    structTypes: [], // Kotlin uses data classes
+    enumTypes: [], // Handled via classifyClassNode
+    enumMemberTypes: ['enum_entry'],
+    typeAliasTypes: ['type_alias'],
+    importTypes: ['import_header'],
+    callTypes: ['call_expression'],
+    variableTypes: ['property_declaration'],
+    fieldTypes: ['property_declaration'],
+    extraClassNodeTypes: ['object_declaration'],
+    nameField: 'simple_identifier',
+    bodyField: 'function_body',
+    visitNode: (node, ctx) => {
+        // Kotlin properties (`val` / `var` / `const val`). The name nests as
+        // property_declaration → variable_declaration → simple_identifier, which the
+        // generic variable/field path can't read — so nothing was extracted before.
+        // Kind by enclosing scope: a singleton `object` / `companion object` (and a
+        // top-level property) holds *shared* values — `val`→`constant`,
+        // `var`→`variable` (the Scala-object rule; a `const val` is a `val`). A
+        // `class`/`interface`/`enum` instance `val`/`var` is per-instance state →
+        // `field` (never a value-ref target, like a Java instance `final`). A
+        // property inside a function body / `init` block / lambda is a local and is
+        // skipped entirely.
+        if (node.type === 'property_declaration') {
+            const varDecl = node.namedChildren.find((c) => c.type === 'variable_declaration');
+            const nameNode = varDecl?.namedChildren.find((c) => c.type === 'simple_identifier');
+            if (!nameNode)
+                return false; // destructuring `val (a,b)` etc. — leave to default
+            const name = (0, tree_sitter_helpers_1.getNodeText)(nameNode, ctx.source);
+            if (!name)
+                return false;
+            // Walk to the nearest enclosing definition: a function body / init / lambda
+            // means it's a local; `object`/`companion object` is a constant scope; a
+            // `class_declaration` (covers class/interface/enum) is an instance scope.
+            let scope = 'const';
+            for (let p = node.parent; p; p = p.parent) {
+                const pt = p.type;
+                if (pt === 'function_body' || pt === 'function_declaration' ||
+                    pt === 'lambda_literal' || pt === 'anonymous_initializer' ||
+                    pt === 'control_structure_body' || pt === 'getter' || pt === 'setter') {
+                    scope = 'local';
+                    break;
+                }
+                if (pt === 'companion_object' || pt === 'object_declaration') {
+                    scope = 'const';
+                    break;
+                }
+                if (pt === 'class_declaration') {
+                    scope = 'instance';
+                    break;
+                }
+            }
+            if (scope === 'local')
+                return true; // a local — don't extract
+            const binding = node.namedChildren.find((c) => c.type === 'binding_pattern_kind');
+            const isVal = binding != null && (0, tree_sitter_helpers_1.getNodeText)(binding, ctx.source) === 'val';
+            const kind = scope === 'instance' ? 'field' : isVal ? 'constant' : 'variable';
+            const typeNode = node.childForFieldName('type');
+            const sig = typeNode
+                ? `${isVal ? 'val' : 'var'} ${name}: ${(0, tree_sitter_helpers_1.getNodeText)(typeNode, ctx.source)}`
+                : undefined;
+            ctx.createNode(kind, name, node, { signature: sig });
+            return true;
+        }
+        // Handle Kotlin `fun interface` declarations.
+        // Tree-sitter-kotlin doesn't support `fun interface` syntax (Kotlin 1.4+).
+        // It produces two different misparse patterns:
+        //   Pattern 1 (simple): ERROR node + sibling lambda_literal for body
+        //   Pattern 2 (complex): function_declaration misparse with ERROR child
+        // Skip lambda_literal bodies that were already consumed by a fun interface ERROR node
+        if (node.type === 'lambda_literal') {
+            const prev = node.previousSibling;
+            if (prev && prev.type === 'ERROR' && isFunInterfaceNode(prev))
+                return true;
+            return false;
+        }
+        if (node.type !== 'ERROR' && node.type !== 'function_declaration')
+            return false;
+        // Skip ERROR nodes that are class bodies (start with `{`). These contain parent
+        // methods + trailing `fun interface` tokens. The methods are extracted via
+        // resolveBody; handling the ERROR here would consume the whole body.
+        if (node.type === 'ERROR') {
+            const firstChild = node.child(0);
+            if (firstChild && firstChild.type === '{')
+                return false;
+        }
+        if (!isFunInterfaceNode(node))
+            return false;
+        // Extract the interface name.
+        // For function_declaration misparses (patterns 2a/2b), the real name is inside
+        // an ERROR child — direct simple_identifier children are the misparsed method name.
+        let nameText = null;
+        if (node.type === 'function_declaration') {
+            for (let i = 0; i < node.childCount; i++) {
+                const child = node.child(i);
+                if (child && child.type === 'ERROR') {
+                    for (let j = 0; j < child.childCount; j++) {
+                        const gc = child.child(j);
+                        if (gc && gc.type === 'simple_identifier') {
+                            nameText = gc.text;
+                            break;
+                        }
+                    }
+                    if (nameText)
+                        break;
+                }
+            }
+        }
+        // Fallback: direct simple_identifier child (Pattern 1: ERROR node at top level)
+        if (!nameText) {
+            for (let i = 0; i < node.childCount; i++) {
+                const child = node.child(i);
+                if (child && child.type === 'simple_identifier') {
+                    nameText = child.text;
+                    break;
+                }
+            }
+        }
+        if (!nameText)
+            return false;
+        // Create the interface node
+        const ifaceNode = ctx.createNode('interface', nameText, node);
+        if (!ifaceNode)
+            return false;
+        ctx.pushScope(ifaceNode.id);
+        if (node.type === 'ERROR') {
+            // Pattern 1: body is in the next sibling lambda_literal
+            const nextSibling = node.nextSibling;
+            if (nextSibling && nextSibling.type === 'lambda_literal') {
+                for (let i = 0; i < nextSibling.namedChildCount; i++) {
+                    const child = nextSibling.namedChild(i);
+                    if (child && child.type === 'statements') {
+                        for (let j = 0; j < child.namedChildCount; j++) {
+                            const stmt = child.namedChild(j);
+                            if (stmt)
+                                ctx.visitNode(stmt);
+                        }
+                    }
+                }
+            }
+        }
+        // Pattern 2 (function_declaration): nested classes are siblings at source_file level,
+        // already visited by the normal traversal. The single abstract method is misparsed
+        // and cannot be reliably recovered, but the interface node itself is the key value.
+        ctx.popScope();
+        return true;
+    },
+    paramsField: 'function_value_parameters',
+    returnField: 'type',
+    getReturnType: extractKotlinReturnType,
+    resolveBody: (node, _bodyField) => {
+        // Kotlin's tree-sitter grammar doesn't use field names, so getChildByField fails.
+        // Find body by type: function_body for functions/methods, class_body for classes,
+        // enum_class_body for enums.
+        //
+        // Special case: when a class/interface contains a nested `fun interface`, tree-sitter
+        // misparsed the parent's body as an ERROR node (starting with `{`) and creates
+        // a class_body sibling for the nested interface's body. Prefer the ERROR body
+        // so the parent's methods are extracted.
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (child && child.type === 'ERROR') {
+                const firstChild = child.child(0);
+                if (firstChild && firstChild.type === '{') {
+                    return child;
+                }
+            }
+            if (child && (child.type === 'function_body' || child.type === 'class_body' || child.type === 'enum_class_body')) {
+                return child;
+            }
+        }
+        return null;
+    },
+    classifyClassNode: (node) => {
+        // Kotlin reuses class_declaration for classes, interfaces, and enums.
+        // Detect by checking for keyword children:
+        //   interface Foo { }       → has 'interface' keyword child
+        //   enum class Level { }    → has 'enum' keyword child
+        //   class / data class / abstract class → default 'class'
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (!child)
+                continue;
+            if (child.type === 'interface')
+                return 'interface';
+            if (child.type === 'enum')
+                return 'enum';
+        }
+        return 'class';
+    },
+    getReceiverType: (node, source) => {
+        // Kotlin extension functions: fun Type.method() { }
+        // AST: function_declaration > user_type, ".", simple_identifier
+        // The user_type before the dot is the receiver type.
+        let foundUserType = null;
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (!child)
+                continue;
+            if (child.type === 'user_type') {
+                foundUserType = child;
+            }
+            else if (child.type === '.' && foundUserType) {
+                // The user_type before the dot is the receiver type
+                const typeId = foundUserType.namedChildren.find((c) => c.type === 'type_identifier');
+                return typeId ? (0, tree_sitter_helpers_1.getNodeText)(typeId, source) : (0, tree_sitter_helpers_1.getNodeText)(foundUserType, source);
+            }
+            else if (child.type === 'simple_identifier' || child.type === 'function_value_parameters') {
+                // Past the function name — no receiver
+                break;
+            }
+        }
+        return undefined;
+    },
+    getSignature: (node, source) => {
+        // Kotlin function signature: fun name(params): ReturnType
+        const params = (0, tree_sitter_helpers_1.getChildByField)(node, 'function_value_parameters');
+        const returnType = (0, tree_sitter_helpers_1.getChildByField)(node, 'type');
+        if (!params)
+            return undefined;
+        let sig = (0, tree_sitter_helpers_1.getNodeText)(params, source);
+        if (returnType) {
+            sig += ': ' + (0, tree_sitter_helpers_1.getNodeText)(returnType, source);
+        }
+        return sig;
+    },
+    getVisibility: (node) => {
+        // Check for visibility modifiers in Kotlin
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child?.type === 'modifiers') {
+                const text = child.text;
+                if (text.includes('public'))
+                    return 'public';
+                if (text.includes('private'))
+                    return 'private';
+                if (text.includes('protected'))
+                    return 'protected';
+                if (text.includes('internal'))
+                    return 'internal';
+            }
+        }
+        return 'public'; // Kotlin defaults to public
+    },
+    isStatic: (_node) => {
+        // Kotlin doesn't have static, uses companion objects
+        return false;
+    },
+    isAsync: (node) => {
+        // Kotlin uses suspend keyword for coroutines
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child?.type === 'modifiers' && child.text.includes('suspend')) {
+                return true;
+            }
+        }
+        return false;
+    },
+    extractModifiers: (node) => {
+        // Kotlin Multiplatform `expect`/`actual` markers live in
+        //   modifiers > platform_modifier > (expect | actual)
+        // Capturing them lets the resolver link an `expect` declaration in a
+        // common source set to its `actual` implementations in platform source
+        // sets (those impls otherwise have zero dependents — the caller resolves
+        // to the `expect`). Match the AST node, not raw text, so an annotation
+        // argument or identifier named "actual" can't false-positive.
+        const mods = [];
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child?.type !== 'modifiers')
+                continue;
+            for (let j = 0; j < child.childCount; j++) {
+                const pm = child.child(j);
+                if (pm?.type !== 'platform_modifier')
+                    continue;
+                for (let k = 0; k < pm.childCount; k++) {
+                    const kw = pm.child(k);
+                    if (kw && (kw.type === 'expect' || kw.type === 'actual'))
+                        mods.push(kw.type);
+                }
+            }
+        }
+        return mods.length > 0 ? mods : undefined;
+    },
+    extractImport: (node, source) => {
+        const importText = source.substring(node.startIndex, node.endIndex).trim();
+        const identifier = node.namedChildren.find((c) => c.type === 'identifier');
+        if (identifier) {
+            return { moduleName: source.substring(identifier.startIndex, identifier.endIndex), signature: importText };
+        }
+        return null;
+    },
+    packageTypes: ['package_header'],
+    extractPackage: (node, source) => {
+        // package_header → identifier (dotted: `com.example.foo`)
+        const id = node.namedChildren.find((c) => c.type === 'identifier');
+        return id ? source.substring(id.startIndex, id.endIndex).trim() : null;
+    },
+};
+//# sourceMappingURL=kotlin.js.map

package/dist/extraction/languages/kotlin.js.map

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

package/dist/extraction/languages/lua.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageExtractor } from '../tree-sitter-types';
+export declare const luaExtractor: LanguageExtractor;
+//# sourceMappingURL=lua.d.ts.map

package/dist/extraction/languages/lua.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lua.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/lua.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA2D9D,eAAO,MAAM,YAAY,EAAE,iBA0F1B,CAAC"}

package/dist/extraction/languages/lua.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.luaExtractor = void 0;
+const tree_sitter_helpers_1 = require("../tree-sitter-helpers");
+// Node names follow the vendored ABI-15 grammar (@tree-sitter-grammars/
+// tree-sitter-lua), NOT the older tree-sitter-wasms build — see grammars.ts.
+/** First descendant of a given type (breadth-first), or null. */
+function findDescendant(node, type) {
+    const queue = [...node.namedChildren];
+    while (queue.length) {
+        const n = queue.shift();
+        if (n.type === type)
+            return n;
+        queue.push(...n.namedChildren);
+    }
+    return null;
+}
+/**
+ * If `callNode` is a `require(...)` call, return the module name; otherwise null.
+ * Lua/Luau have no import statement — modules are loaded by calling the global
+ * `require`. Handles both:
+ *   - string requires:  `require("net.http")` / `require "net.http"`  → "net.http"
+ *   - Roblox/Luau path requires: `require(script.Parent.Signal)`      → "Signal"
+ *     (the dominant idiom in Roblox code, where the argument is an instance path
+ *     rather than a string — use the trailing field as the module name).
+ */
+function requireModule(callNode, source) {
+    // function_call > name: <callee>, arguments: arguments
+    const name = (0, tree_sitter_helpers_1.getChildByField)(callNode, 'name');
+    // A dotted/colon callee (e.g. `socket.connect`) is dot/method_index_expression,
+    // never a bare `require`.
+    if (!name || name.type !== 'identifier')
+        return null;
+    if ((0, tree_sitter_helpers_1.getNodeText)(name, source) !== 'require')
+        return null;
+    const args = (0, tree_sitter_helpers_1.getChildByField)(callNode, 'arguments');
+    if (!args)
+        return null;
+    // String require — `string > content: string_content` gives the bare name.
+    const content = findDescendant(args, 'string_content');
+    if (content)
+        return (0, tree_sitter_helpers_1.getNodeText)(content, source).trim() || null;
+    const str = findDescendant(args, 'string');
+    if (str) {
+        const mod = (0, tree_sitter_helpers_1.getNodeText)(str, source)
+            .trim()
+            .replace(/^\[\[/, '')
+            .replace(/\]\]$/, '')
+            .replace(/^["']/, '')
+            .replace(/["']$/, '');
+        if (mod)
+            return mod;
+    }
+    // Roblox/Luau instance-path require: `require(script.Parent.Signal)` → "Signal".
+    const idx = findDescendant(args, 'dot_index_expression') ?? findDescendant(args, 'method_index_expression');
+    if (idx) {
+        const field = (0, tree_sitter_helpers_1.getChildByField)(idx, 'field') ?? (0, tree_sitter_helpers_1.getChildByField)(idx, 'method');
+        if (field)
+            return (0, tree_sitter_helpers_1.getNodeText)(field, source).trim() || null;
+    }
+    return null;
+}
+exports.luaExtractor = {
+    // function_declaration covers global (`function f`), table (`function t.f`),
+    // method (`function t:m`), and local (`local function f`) forms — the form is
+    // distinguished by the `name:` child (identifier / dot_index_expression /
+    // method_index_expression) and a `local` token, not by separate node types.
+    // Anonymous `function() ... end` (function_definition) has no name and is
+    // captured via its enclosing variable instead.
+    functionTypes: ['function_declaration'],
+    classTypes: [], // Lua has no classes/structs/interfaces/enums — tables are used for everything
+    methodTypes: [],
+    interfaceTypes: [],
+    structTypes: [],
+    enumTypes: [],
+    typeAliasTypes: [],
+    importTypes: [], // `require` is a function_call — handled in visitNode below
+    callTypes: ['function_call'],
+    variableTypes: ['variable_declaration'], // see the `lua` branch in extractVariable
+    nameField: 'name',
+    bodyField: 'body',
+    paramsField: 'parameters',
+    getSignature: (node, source) => {
+        const params = (0, tree_sitter_helpers_1.getChildByField)(node, 'parameters');
+        return params ? (0, tree_sitter_helpers_1.getNodeText)(params, source) : undefined;
+    },
+    // `function t.f()` / `function t:m()` are methods on table `t`: return the
+    // table as the receiver so they extract as methods with a `t::f` qualified
+    // name. Plain `function f()` / `local function f()` have no receiver and stay
+    // functions. (For `a.b.c`, the receiver is the nested `a.b`.)
+    getReceiverType: (node, source) => {
+        const name = (0, tree_sitter_helpers_1.getChildByField)(node, 'name');
+        if (name && (name.type === 'dot_index_expression' || name.type === 'method_index_expression')) {
+            const table = (0, tree_sitter_helpers_1.getChildByField)(name, 'table');
+            if (table)
+                return (0, tree_sitter_helpers_1.getNodeText)(table, source);
+        }
+        return undefined;
+    },
+    // Emit import nodes for `require(...)`. The local-declaration form is handled
+    // explicitly because the variable branch skips the initializer subtree; bare
+    // and global `require` calls are caught when the walker reaches the
+    // function_call node.
+    visitNode: (node, ctx) => {
+        const source = ctx.source;
+        const emit = (callNode) => {
+            const mod = requireModule(callNode, source);
+            if (!mod)
+                return;
+            const imp = ctx.createNode('import', mod, callNode, {
+                signature: (0, tree_sitter_helpers_1.getNodeText)(callNode, source).trim().slice(0, 100),
+            });
+            if (imp && ctx.nodeStack.length > 0) {
+                const parentId = ctx.nodeStack[ctx.nodeStack.length - 1];
+                if (parentId) {
+                    ctx.addUnresolvedReference({
+                        fromNodeId: parentId,
+                        referenceName: mod,
+                        referenceKind: 'imports',
+                        line: callNode.startPosition.row + 1,
+                        column: callNode.startPosition.column,
+                    });
+                }
+            }
+        };
+        // Bare / global `require("x")` — claim it so it isn't double-counted as a call.
+        if (node.type === 'function_call') {
+            if (requireModule(node, source)) {
+                emit(node);
+                return true;
+            }
+            return false;
+        }
+        // `local x = require("x")` — variable_declaration wraps an assignment_statement
+        // whose initializer subtree the variable branch will skip, so dig it out here.
+        if (node.type === 'variable_declaration') {
+            const assign = node.namedChildren.find((c) => c.type === 'assignment_statement');
+            const exprList = assign?.namedChildren.find((c) => c.type === 'expression_list');
+            if (exprList) {
+                for (const val of exprList.namedChildren) {
+                    if (val.type === 'function_call')
+                        emit(val);
+                }
+            }
+            return false;
+        }
+        return false;
+    },
+};
+//# sourceMappingURL=lua.js.map

package/dist/extraction/languages/lua.js.map

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

package/dist/extraction/languages/luau.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageExtractor } from '../tree-sitter-types';
+export declare const luauExtractor: LanguageExtractor;
+//# sourceMappingURL=luau.d.ts.map

package/dist/extraction/languages/luau.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luau.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/luau.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAc9D,eAAO,MAAM,aAAa,EAAE,iBAoB3B,CAAC"}

package/dist/extraction/languages/luau.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.luauExtractor = void 0;
+const tree_sitter_helpers_1 = require("../tree-sitter-helpers");
+const lua_1 = require("./lua");
+// Luau (https://luau.org) is a gradually-typed superset of Lua. The
+// tree-sitter-luau grammar reuses the same node names as the vendored Lua
+// grammar (function_declaration, variable_declaration, function_call,
+// dot/method_index_expression, …), so the Luau extractor extends the Lua one
+// and adds the type-system pieces Luau introduces:
+//   - `type X = ...` / `export type X = ...`  → type_definition (type_alias)
+//   - typed parameters and return types        → richer signatures
+//
+// require detection, receiver-splitting (t.f / t:m → methods), and local
+// variable extraction are inherited unchanged from luaExtractor. The shared
+// `extractVariable` core branch is gated on `lua` || `luau`.
+exports.luauExtractor = {
+    ...lua_1.luaExtractor,
+    // `type X = ...` and `export type X = ...`
+    typeAliasTypes: ['type_definition'],
+    // Only Luau `export type` is exported; the keyword leads the node.
+    isExported: (node, source) => source.slice(node.startIndex, node.startIndex + 7) === 'export ',
+    // Params + Luau return type (the named child after `parameters`, before the body).
+    getSignature: (node, source) => {
+        const params = (0, tree_sitter_helpers_1.getChildByField)(node, 'parameters');
+        if (!params)
+            return undefined;
+        let sig = (0, tree_sitter_helpers_1.getNodeText)(params, source);
+        const kids = node.namedChildren;
+        const idx = kids.findIndex((c) => c.startIndex === params.startIndex);
+        const ret = idx >= 0 ? kids[idx + 1] : null;
+        if (ret && ret.type !== 'block')
+            sig += `: ${(0, tree_sitter_helpers_1.getNodeText)(ret, source)}`;
+        return sig;
+    },
+};
+//# sourceMappingURL=luau.js.map

package/dist/extraction/languages/luau.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"luau.js","sourceRoot":"","sources":["../../../src/extraction/languages/luau.ts"],"names":[],"mappings":";;;AAAA,gEAAsE;AAEtE,+BAAqC;AAErC,oEAAoE;AACpE,0EAA0E;AAC1E,sEAAsE;AACtE,6EAA6E;AAC7E,mDAAmD;AACnD,6EAA6E;AAC7E,mEAAmE;AACnE,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,6DAA6D;AAChD,QAAA,aAAa,GAAsB;IAC9C,GAAG,kBAAY;IAEf,2CAA2C;IAC3C,cAAc,EAAE,CAAC,iBAAiB,CAAC;IAEnC,mEAAmE;IACnE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,SAAS;IAE9F,mFAAmF;IACnF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAA,qCAAe,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,IAAI,GAAG,GAAG,IAAA,iCAAW,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,GAAG,IAAI,KAAK,IAAA,iCAAW,EAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;QACxE,OAAO,GAAG,CAAC;IACb,CAAC;CACF,CAAC"}

package/dist/extraction/languages/objc.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageExtractor } from '../tree-sitter-types';
+export declare const objcExtractor: LanguageExtractor;
+//# sourceMappingURL=objc.d.ts.map

package/dist/extraction/languages/objc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objc.d.ts","sourceRoot":"","sources":["../../../src/extraction/languages/objc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA+FhF,eAAO,MAAM,aAAa,EAAE,iBA+E3B,CAAC"}