@opensip-cli/lang-java 0.1.7 → 0.1.9

package/README.md

@@ -23,8 +23,8 @@ This package is published for the CLI and advanced plugin authors; most users sh
 ## Documentation
 
 - 📚 Project docs: https://opensip.ai/docs/opensip-cli/
-- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.7/docs/public/70-reference/02-package-catalog.md
-- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.7/packages/languages/lang-java
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.9/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.9/packages/languages/lang-java
 
 ## License
 

package/dist/__tests__/query.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query.test.d.ts.map

package/dist/__tests__/query.test.d.ts.map

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

package/dist/__tests__/query.test.js

@@ -0,0 +1,64 @@
+import { describe, expect, it } from 'vitest';
+import { javaAdapter } from '../adapter.js';
+function parse(src) {
+    const tree = javaAdapter.parse(src, 'S.java');
+    if (!tree)
+        throw new Error('no tree');
+    return tree;
+}
+const q = javaAdapter.query;
+describe('javaQuery (LanguageQueryAPI)', () => {
+    it('is wired onto the adapter', () => {
+        expect(javaAdapter.query).toBeDefined();
+    });
+    it('findFunctions returns methods, constructors, and anonymous lambdas', () => {
+        const tree = parse(['class S {', '    S() {}', '    void m() { Runnable r = () -> {}; }', '}', ''].join('\n'));
+        const names = q.findFunctions(tree).map((f) => f.name);
+        expect(names).toContain('S'); // constructor
+        expect(names).toContain('m'); // method
+        expect(names).toContain(null); // lambda
+    });
+    it('findImports handles single-type and wildcard imports', () => {
+        const tree = parse(['import java.util.List;', 'import java.util.*;', 'class S {}', ''].join('\n'));
+        const imports = q.findImports(tree);
+        const list = imports.find((i) => i.specifier === 'java.util.List');
+        expect(list?.names).toEqual(['List']);
+        const star = imports.find((i) => i.specifier === 'java.util.*');
+        expect(star?.names).toEqual([]); // wildcard imports a package, no single name
+    });
+    it('findCallsTo matches method invocations and object creations', () => {
+        const tree = parse([
+            'class S {',
+            '    void m() {',
+            '        foo();',
+            '        obj.bar();',
+            '        new Widget();',
+            '    }',
+            '}',
+            '',
+        ].join('\n'));
+        expect(q.findCallsTo(tree, 'foo').length).toBe(1);
+        expect(q.findCallsTo(tree, 'bar').length).toBe(1);
+        expect(q.findCallsTo(tree, 'Widget').length).toBe(1); // new Widget()
+        expect(q.findCallsTo(tree, 'absent').length).toBe(0);
+    });
+    it('findCallsTo resolves a generic object creation to its raw type name', () => {
+        const tree = parse([
+            'class S {',
+            '    void m() {',
+            '        var xs = new ArrayList<String>();',
+            '    }',
+            '}',
+            '',
+        ].join('\n'));
+        expect(q.findCallsTo(tree, 'ArrayList').length).toBe(1);
+    });
+    it('findStringLiterals returns values; getText/getLocation read nodes', () => {
+        const tree = parse(['class S {', '    void m() { String s = "hello"; }', '}', ''].join('\n'));
+        expect(q.findStringLiterals(tree).map((s) => s.value)).toContain('hello');
+        const fns = q.findFunctions(tree);
+        expect(q.getText(tree, fns[0].node)).toContain('void m');
+        expect(q.getLocation(tree, fns[0].node).line).toBeGreaterThanOrEqual(1);
+    });
+});
+//# sourceMappingURL=query.test.js.map

package/dist/__tests__/query.test.js.map

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

package/dist/adapter.d.ts

@@ -1,6 +1,7 @@
 import { type JavaTree } from './parse.js';
 import type { LanguageAdapter } from '@opensip-cli/core';
-export declare const javaAdapter: LanguageAdapter<JavaTree>;
+import type { Node } from '@opensip-cli/tree-sitter';
+export declare const javaAdapter: LanguageAdapter<JavaTree, Node>;
 /** Plugin contract — exported as the lang plugin's `adapters` array. */
-export declare const adapters: readonly [LanguageAdapter<import("@opensip-cli/tree-sitter").ParsedFile, unknown>];
+export declare const adapters: readonly [LanguageAdapter<import("@opensip-cli/tree-sitter").ParsedFile, Node>];
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,WAAW,EAAE,eAAe,CAAC,QAAQ,CAMjD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,oFAAyB,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,eAAe,CAAC,QAAQ,EAAE,IAAI,CAOvD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,iFAAyB,CAAC"}

package/dist/adapter.js

@@ -1,4 +1,5 @@
 import { parseJava } from './parse.js';
+import { javaQuery } from './query.js';
 import { stripComments, stripStrings } from './strip.js';
 export const javaAdapter = {
     id: 'java',
@@ -6,6 +7,7 @@ export const javaAdapter = {
     parse: parseJava,
     stripStrings,
     stripComments,
+    query: javaQuery,
 };
 /** Plugin contract — exported as the lang plugin's `adapters` array. */
 export const adapters = [javaAdapter];

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,EAAE,EAAE,MAAM;IACV,cAAc,EAAE,CAAC,OAAO,CAAC;IACzB,KAAK,EAAE,SAAS;IAChB,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAU,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKzD,MAAM,CAAC,MAAM,WAAW,GAAoC;IAC1D,EAAE,EAAE,MAAM;IACV,cAAc,EAAE,CAAC,OAAO,CAAC;IACzB,KAAK,EAAE,SAAS;IAChB,YAAY;IACZ,aAAa;IACb,KAAK,EAAE,SAAS;CACjB,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAU,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { javaAdapter, adapters } from './adapter.js';
 export { parseJava, type JavaTree } from './parse.js';
 export { getSharedTree } from './shared-tree.js';
 export { stripStrings, stripComments } from './strip.js';
+export { javaQuery } from './query.js';
 export { isFunction, isMethod, isConstructor, isClass, isComment, isString, isCatch, isConditional, isLoop, } from './predicates.js';
 export { findEnclosingFunction, getEnclosingFunctionName } from './enclosing.js';
+export { childrenOf, findEnclosing, getColumn, getLineNumber, nameOf, namedChildrenOf, nodeText, walkNodes, type Node, } from '@opensip-cli/tree-sitter';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAOjF,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,eAAe,EACf,QAAQ,EACR,SAAS,EACT,KAAK,IAAI,GACV,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -2,6 +2,13 @@ export { javaAdapter, adapters } from './adapter.js';
 export { parseJava } from './parse.js';
 export { getSharedTree } from './shared-tree.js';
 export { stripStrings, stripComments } from './strip.js';
+export { javaQuery } from './query.js';
 export { isFunction, isMethod, isConstructor, isClass, isComment, isString, isCatch, isConditional, isLoop, } from './predicates.js';
 export { findEnclosingFunction, getEnclosingFunctionName } from './enclosing.js';
+// Generic tree-sitter traversal/position vocabulary, re-exported so check
+// packs reach the parser substrate THROUGH the language adapter (ADR-0039):
+// the adapter owns the parser boundary; check packs depend on lang-java +
+// fitness only, never on @opensip-cli/tree-sitter directly (enforced by
+// dependency-cruiser).
+export { childrenOf, findEnclosing, getColumn, getLineNumber, nameOf, namedChildrenOf, nodeText, walkNodes, } from '@opensip-cli/tree-sitter';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,aAAa,EACb,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,uBAAuB;AACvB,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,eAAe,EACf,QAAQ,EACR,SAAS,GAEV,MAAM,0BAA0B,CAAC"}

package/dist/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAOnG,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAG7E"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAqBnG,gFAAgF;AAChF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAK7E"}

package/dist/parse.js

@@ -10,11 +10,29 @@
  * (non-null) rather than throwing.
  */
 import { fileURLToPath } from 'node:url';
+import { logger } from '@opensip-cli/core';
 import { loadGrammar, createParser, parseToTree } from '@opensip-cli/tree-sitter';
-const grammar = await loadGrammar(fileURLToPath(new URL('../wasm/tree-sitter-java.wasm', import.meta.url)));
-const parser = createParser(grammar);
+// Load the grammar once at module top level (keeps parse() synchronous). A
+// missing/corrupt/ABI-mismatched .wasm must NOT crash the whole CLI — contain
+// the failure so Java analysis degrades to "unavailable" (parse returns null).
+let parser;
+/* v8 ignore start -- grammar-load failure is environment-dependent (bad/missing .wasm); not reproducible under the test runner */
+try {
+    const grammar = await loadGrammar(fileURLToPath(new URL('../wasm/tree-sitter-java.wasm', import.meta.url)));
+    parser = createParser(grammar);
+}
+catch (error) {
+    logger.warn({
+        evt: 'lang.grammar.load_failed',
+        module: 'lang:java',
+        msg: `Java grammar failed to load — Java analysis is unavailable this run: ${error instanceof Error ? error.message : String(error)}`,
+    });
+}
 /** Parses Java source into a {@link JavaTree}, or null when no tree is produced. */
 export function parseJava(content, _filePath) {
+    /* v8 ignore next -- defensive: parser is undefined only when the grammar failed to load */
+    if (!parser)
+        return null;
     const tree = parseToTree(parser, content);
     return tree ? { tree, source: content } : null;
 }

package/dist/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,0BAA0B,CAAC;AAEnG,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACzE,CAAC;AACF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAKrC,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,SAAiB;IAC1D,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,0BAA0B,CAAC;AAEnG,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,IAAI,MAAmD,CAAC;AACxD,kIAAkI;AAClI,IAAI,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACzE,CAAC;IACF,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,IAAI,CAAC;QACV,GAAG,EAAE,0BAA0B;QAC/B,MAAM,EAAE,WAAW;QACnB,GAAG,EAAE,wEAAwE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KACtI,CAAC,CAAC;AACL,CAAC;AAMD,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,SAAiB;IAC1D,2FAA2F;IAC3F,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Java {@link LanguageQueryAPI} (ADR-0010, M10) — the grammar config for the
+ * shared `createTreeSitterQuery` factory. Node types are from tree-sitter-java;
+ * the callee extractor mirrors `graph-java`'s resolver.
+ *
+ * A Java `import a.b.C;` imports the single type `C` by its fully-qualified
+ * path, so `findImports` reports specifier `a.b.C` with name `[C]`. A
+ * wildcard `import a.b.*;` imports a whole package (no single named type), so
+ * names is empty — the faithful equivalent.
+ */
+import { type LanguageQueryAPI, type Node, type ParsedFile } from '@opensip-cli/tree-sitter';
+export declare const javaQuery: LanguageQueryAPI<ParsedFile, Node>;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAkFlC,eAAO,MAAM,SAAS,EAAE,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAKvD,CAAC"}

package/dist/query.js

@@ -0,0 +1,97 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010/M10: the per-language tree-sitter query config intentionally shares helper names (callee/import/string extractors) across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * Java {@link LanguageQueryAPI} (ADR-0010, M10) — the grammar config for the
+ * shared `createTreeSitterQuery` factory. Node types are from tree-sitter-java;
+ * the callee extractor mirrors `graph-java`'s resolver.
+ *
+ * A Java `import a.b.C;` imports the single type `C` by its fully-qualified
+ * path, so `findImports` reports specifier `a.b.C` with name `[C]`. A
+ * wildcard `import a.b.*;` imports a whole package (no single named type), so
+ * names is empty — the faithful equivalent.
+ */
+import { createTreeSitterQuery, } from '@opensip-cli/tree-sitter';
+/** Leaf callee name of a `method_invocation` / `object_creation_expression`. */
+function calleeName(node) {
+    if (node.type === 'method_invocation') {
+        const name = node.childForFieldName('name');
+        /* v8 ignore next -- a method_invocation always exposes its `name` field */
+        return name ? name.text : null;
+    }
+    // object_creation_expression (the only other configured call node type).
+    const ty = node.childForFieldName('type');
+    /* v8 ignore next -- `new T(...)` always exposes its `type` field */
+    return ty ? leafTypeName(ty) : null;
+}
+/** Terminal name of a (possibly generic / qualified) type node. */
+function leafTypeName(node) {
+    if (node.type === 'type_identifier')
+        return node.text;
+    if (node.type === 'generic_type') {
+        // `ArrayList<String>` → first named child is the raw `type_identifier`.
+        const inner = node.namedChild(0);
+        /* v8 ignore next -- a generic_type always wraps a raw type node */
+        return inner ? leafTypeName(inner) : null;
+    }
+    if (node.type === 'scoped_type_identifier') {
+        // `a.b.C` → last named child is the terminal type name.
+        const inner = node.namedChild(node.namedChildCount - 1);
+        /* v8 ignore next -- a scoped_type_identifier always has a terminal name */
+        return inner ? leafTypeName(inner) : null;
+    }
+    return node.text;
+}
+/** Terminal segment of a dotted import path (`a.b.C` → `C`). */
+function dottedLeaf(text) {
+    /* v8 ignore next -- split('.') on a non-empty path always yields a segment */
+    return text.split('.').pop() ?? text;
+}
+/**
+ * Expand an `import_declaration` into a single import target.
+ *   - `import a.b.C;`  → specifier `a.b.C`, names `[C]`
+ *   - `import a.b.*;`  → specifier `a.b.*`, names `[]`
+ *   - `import static a.b.C.m;` → specifier `a.b.C.m`, names `[m]`
+ */
+function extractImport(node) {
+    const path = node.childForFieldName('name') ?? firstScopedIdentifier(node);
+    /* v8 ignore next -- an import_declaration always has a path */
+    if (!path)
+        return [];
+    const hasAsterisk = node.children.some((c) => c !== null && c.type === 'asterisk');
+    const base = path.text;
+    if (hasAsterisk)
+        return [{ specifier: `${base}.*`, names: [] }];
+    return [{ specifier: base, names: [dottedLeaf(base)] }];
+}
+/* v8 ignore start -- defensive fallback: import_declaration always exposes the
+   `name` field, so this scan only runs on a malformed/partial tree */
+function firstScopedIdentifier(node) {
+    for (const c of node.namedChildren) {
+        if (c && (c.type === 'scoped_identifier' || c.type === 'identifier'))
+            return c;
+    }
+    return null;
+}
+/* v8 ignore stop */
+const FUNCTION_NODE_TYPES = new Set([
+    'method_declaration',
+    'constructor_declaration',
+    'lambda_expression',
+]);
+const CALL_NODE_TYPES = new Set(['method_invocation', 'object_creation_expression']);
+const IMPORT_NODE_TYPES = new Set(['import_declaration']);
+const STRING_NODE_TYPES = new Set(['string_literal']);
+/** A `lambda_expression` has no name field — keep `findFunctions` faithful. */
+function javaFunctionName(node) {
+    if (node.type === 'lambda_expression')
+        return null;
+    const name = node.childForFieldName('name');
+    /* v8 ignore next -- method/constructor declarations always expose a name field */
+    return name ? name.text : null;
+}
+export const javaQuery = createTreeSitterQuery({
+    functions: { nodeTypes: FUNCTION_NODE_TYPES, nameOf: javaFunctionName },
+    calls: { nodeTypes: CALL_NODE_TYPES, calleeName },
+    imports: { nodeTypes: IMPORT_NODE_TYPES, extract: extractImport },
+    strings: { nodeTypes: STRING_NODE_TYPES },
+});
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,wRAAwR;AACxR;;;;;;;;;GASG;AAEH,OAAO,EACL,qBAAqB,GAKtB,MAAM,0BAA0B,CAAC;AAElC,gFAAgF;AAChF,SAAS,UAAU,CAAC,IAAU;IAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC5C,2EAA2E;QAC3E,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,yEAAyE;IACzE,MAAM,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,oEAAoE;IACpE,OAAO,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED,mEAAmE;AACnE,SAAS,YAAY,CAAC,IAAU;IAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACjC,wEAAwE;QACxE,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,mEAAmE;QACnE,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;QAC3C,wDAAwD;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QACxD,2EAA2E;QAC3E,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,gEAAgE;AAChE,SAAS,UAAU,CAAC,IAAY;IAC9B,8EAA8E;IAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAU;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC3E,+DAA+D;IAC/D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,WAAW;QAAE,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;sEACsE;AACtE,SAAS,qBAAqB,CAAC,IAAU;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;YAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AACD,oBAAoB;AAEpB,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,oBAAoB;IACpB,yBAAyB;IACzB,mBAAmB;CACpB,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,4BAA4B,CAAC,CAAC,CAAC;AACrF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAC1D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEtD,+EAA+E;AAC/E,SAAS,gBAAgB,CAAC,IAAU;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,kFAAkF;IAClF,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAuC,qBAAqB,CAAC;IACjF,SAAS,EAAE,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,EAAE,gBAAgB,EAAE;IACvE,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE;IACjD,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,aAAa,EAAE;IACjE,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE;CAC1C,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensip-cli/lang-java",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "license": "Apache-2.0",
   "description": "Java language adapter for opensip-cli",
   "keywords": [
@@ -34,8 +34,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@opensip-cli/core": "0.1.7",
-    "@opensip-cli/tree-sitter": "0.1.7"
+    "@opensip-cli/core": "0.1.9",
+    "@opensip-cli/tree-sitter": "0.1.9"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",