@opensip-cli/lang-java 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,8 @@
+OpenSIP CLI
+Copyright 2026 opensip-ai
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this software except in compliance with the License. A copy of the License is
+included in the LICENSE file and is also available at:
+
+    http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -0,0 +1,31 @@
+<!-- Generated by scripts/build-package-readmes.mjs — do not edit by hand.
+     Change the package's "description" (or the generator template) and run
+     `pnpm docs:readmes`. CI enforces sync via `pnpm docs:readmes:check`. -->
+
+# @opensip-cli/lang-java
+
+> Java language adapter for opensip-cli
+
+This is an **internal library** of the opensip-cli toolkit. It is published so the CLI and tools can depend on it; most users will not install it directly.
+
+Part of [**opensip-cli**](https://github.com/opensip-ai/opensip-cli) — an open-source codebase-analysis toolkit: fitness checks (`fit`), static call-graph analysis (`graph`), and simulation (`sim`).
+
+## Install
+
+Most users install the CLI, which bundles the first-party tools:
+
+```bash
+curl -fsSL https://opensip.ai/cli/install.sh | bash
+```
+
+This package is published for the CLI and advanced plugin authors; most users should not install `@opensip-cli/lang-java` directly.
+
+## 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.0/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.0/packages/languages/lang-java
+
+## License
+
+Apache-2.0 © opensip-ai

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

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

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

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

package/dist/__tests__/adapter.test.js

@@ -0,0 +1,167 @@
+import { describe, expect, it } from 'vitest';
+import { javaAdapter } from '../adapter.js';
+import { stripComments, stripStrings } from '../strip.js';
+describe('javaAdapter', () => {
+    it('declares the expected identity and extension', () => {
+        expect(javaAdapter.id).toBe('java');
+        expect(javaAdapter.fileExtensions).toContain('.java');
+    });
+    it('parse() returns a real tree-sitter tree + source', () => {
+        const src = 'class A {\n  void m() {}\n}';
+        const tree = javaAdapter.parse(src, 'A.java');
+        expect(tree).not.toBeNull();
+        expect(tree?.source).toBe(src);
+        expect(tree?.tree.rootNode.type).toBe('program');
+    });
+});
+describe('java stripStrings', () => {
+    it('replaces regular string content but preserves length', () => {
+        const src = 'String s = "hello world";';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain('hello');
+        expect(out).toContain('String s =');
+        expect(out).toContain('"');
+    });
+    it('strips text block body but preserves the triple quotes and newlines', () => {
+        const src = 'String s = """\nfoo bar\n""";';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain('foo');
+        expect(out).not.toContain('bar');
+        // Triple quotes (delimiters) survive
+        expect(out).toContain('"""');
+        // Newlines are preserved
+        expect(out.split('\n').length).toBe(src.split('\n').length);
+    });
+    it('preserves char literals (single chars are code, not strings)', () => {
+        const src = "char c = 'x';";
+        const out = stripStrings(src);
+        expect(out).toBe(src);
+    });
+    it('preserves char literals with escapes', () => {
+        const src = String.raw `char c = '\n';`;
+        const out = stripStrings(src);
+        expect(out).toBe(src);
+    });
+    it('preserves newlines inside text blocks', () => {
+        const src = 'String x = """\nline1\nline2\n""";';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        expect(out.split('\n').length).toBe(src.split('\n').length);
+    });
+    it('handles escapes inside regular strings', () => {
+        const src = String.raw `String s = "a\"b";`;
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain(String.raw `a\"b`);
+    });
+    // F1: text-block scanner must honor backslash escapes per JLS §3.10.6.
+    // A literal `\"""` inside a text block is a backslash, an escaped quote,
+    // then two literal quotes — NOT a closing delimiter.
+    it('does not prematurely close a text block on an escaped triple quote', () => {
+        const src = 'String s = """\n  literal \\""" inside\n  """;\nint after = 1;';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        // Body content should be stripped
+        expect(out).not.toContain('literal');
+        expect(out).not.toContain('inside');
+        // The trailing code outside the text block must NOT be stripped
+        expect(out).toContain('int after = 1;');
+    });
+    // F1: graceful end-of-source recovery when a text block is unterminated.
+    it('recovers from an unterminated text block at end of source', () => {
+        const src = 'String s = """\n unterminated';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain('unterminated');
+        // Outer prefix is preserved
+        expect(out).toContain('String s =');
+        expect(out).toContain('"""');
+    });
+    // N2: when `"""` is NOT followed by a line terminator, the text-block
+    // detection must fall through to the regular-string branch. Pin the
+    // happy path through that fall-through so a future change in
+    // scanRegularString's empty-string fast path does not silently break
+    // Java's not-a-text-block semantics.
+    it(String.raw `falls through to regular-string when """ has no following line terminator`, () => {
+        // `String s = """abc";` — the leading `""` is an empty regular
+        // string; the third `"` opens a new regular string with body `abc`,
+        // closing at the trailing `"`. Result: both string regions are
+        // stripped, and the surrounding code structure survives.
+        const src = 'String s = """abc";';
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        // The body content is stripped.
+        expect(out).not.toContain('abc');
+        // Outer code structure survives — no scanner spin.
+        expect(out).toContain('String s =');
+        expect(out).toContain(';');
+    });
+    // F2: stray apostrophe in malformed input must not swallow following code.
+    it('does not swallow code on a stray apostrophe (malformed input)', () => {
+        const src = "char c = 'a; int x = 1;";
+        const out = stripStrings(src);
+        expect(out.length).toBe(src.length);
+        // The trailing statement is real code and must survive intact
+        expect(out).toContain('int x = 1;');
+    });
+    // F2: a unicode-escape char literal (`'A'` = 8 chars including quotes)
+    // must still close inside the 8-char scan cap.
+    it('closes a unicode-escape char literal within the 8-char cap', () => {
+        const src = String.raw `char c = 'A'; int x = 1;`;
+        const out = stripStrings(src);
+        expect(out).toBe(src);
+        expect(out).toContain('int x = 1;');
+    });
+    // F6: '\'' is the canonical case where the escape branch must run before
+    // the closing-quote branch. If the order is wrong, this test fails.
+    it(String.raw `parses an escaped-apostrophe char literal '\''`, () => {
+        const src = String.raw `char c = '\''; int x = 1;`;
+        const out = stripStrings(src);
+        expect(out).toBe(src);
+        // Followup statement must not be eaten
+        expect(out).toContain('int x = 1;');
+    });
+});
+describe('java stripComments', () => {
+    it('replaces line comments', () => {
+        const src = 'int x = 1; // comment';
+        const out = stripComments(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain('comment');
+        expect(out).toContain('int x = 1;');
+    });
+    it('replaces block comments', () => {
+        const src = 'int x = /* hi */ 2;';
+        const out = stripComments(src);
+        expect(out.length).toBe(src.length);
+        expect(out).not.toContain('hi');
+        expect(out).toContain('int x =');
+        expect(out).toContain('2;');
+    });
+    it('does not nest block comments (Java semantics)', () => {
+        // The first */ closes the block; the second one is plain code.
+        const src = 'int x = /* outer /* inner */ rest */ 1;';
+        const out = stripComments(src);
+        expect(out.length).toBe(src.length);
+        // The inner section is replaced
+        expect(out).not.toContain('outer');
+        expect(out).not.toContain('inner');
+        // ...but the trailing `rest */ 1;` is back in code-land
+        expect(out).toContain('rest');
+    });
+    it('strips strings as well as comments', () => {
+        const src = 'String s = "// not a comment";';
+        const out = stripComments(src);
+        expect(out.length).toBe(src.length);
+        // The `// not a comment` was a STRING, not a comment, but stripComments
+        // replaces both kinds of regions.
+        expect(out).not.toContain('not a comment');
+        // The outer structure (assignment, semicolon, quotes) is intact
+        expect(out).toContain('String s =');
+        expect(out).toContain('"');
+        expect(out).toContain(';');
+    });
+});
+//# sourceMappingURL=adapter.test.js.map

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

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

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

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

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

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

package/dist/__tests__/strip.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest';
+import { stripStrings, stripComments } from '../strip.js';
+describe('stripStrings (Java)', () => {
+    it('strips double-quoted strings', () => {
+        const out = stripStrings('String s = "hello";');
+        expect(out).not.toContain('hello');
+    });
+    it('strips text blocks (triple-quoted multi-line strings)', () => {
+        const src = 'String s = """\nline1\nline2\n""";';
+        const out = stripStrings(src);
+        expect(out).not.toContain('line1');
+        expect(out).not.toContain('line2');
+    });
+    it('handles escape sequences', () => {
+        const out = stripStrings(String.raw `String s = "a\"b";`);
+        expect(out).not.toContain('a');
+    });
+    it('preserves char literals', () => {
+        expect(stripStrings("char c = 'a';")).toContain("'a'");
+    });
+    it('handles unterminated string', () => {
+        const out = stripStrings('String s = "unterminated');
+        expect(out).toContain('String s = ');
+    });
+    it('passes through code with no strings unchanged', () => {
+        const code = 'class Foo { int x = 1; }';
+        expect(stripStrings(code)).toBe(code);
+    });
+    it('handles unterminated text block', () => {
+        const out = stripStrings('String s = """\nunterminated');
+        expect(out).toContain('String s = ');
+        expect(out).not.toContain('unterminated');
+    });
+    it('handles char literal hitting a newline before closing quote', () => {
+        const out = stripStrings("char c = 'unterminated\nint x = 1;");
+        expect(out).toContain('int x = 1;');
+    });
+});
+describe('stripComments (Java)', () => {
+    it('strips line comments', () => {
+        const out = stripComments('int x = 1; // comment');
+        expect(out).not.toContain('comment');
+    });
+    it('strips block comments', () => {
+        const out = stripComments('int x = 1; /* hidden */ int y = 2;');
+        expect(out).not.toContain('hidden');
+    });
+    it('strips javadoc-style comments', () => {
+        const out = stripComments('/** doc */\nclass Foo {}');
+        expect(out).not.toContain('doc');
+    });
+    it('handles unterminated block comment', () => {
+        const out = stripComments('int x = 1; /* oops');
+        expect(out).toContain('int x = 1;');
+    });
+});
+//# sourceMappingURL=strip.test.js.map

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

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

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

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

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

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

package/dist/__tests__/substrate.test.js

@@ -0,0 +1,72 @@
+import { RunScope, runWithScopeSync } from '@opensip-cli/core';
+import { initParseCache, clearParseCache } from '@opensip-cli/core/languages/parse-cache.js';
+import { walkNodes } from '@opensip-cli/tree-sitter';
+import { describe, expect, it } from 'vitest';
+import { findEnclosingFunction, getEnclosingFunctionName } from '../enclosing.js';
+import { parseJava } from '../parse.js';
+import { isCatch, isClass, isComment, isConditional, isConstructor, isFunction, isLoop, isMethod, isString, } from '../predicates.js';
+import { getSharedTree } from '../shared-tree.js';
+const SRC = [
+    'package app;',
+    '// c',
+    'class S {',
+    '    S() {}',
+    '    void m() {',
+    '        String x = "h";',
+    '        if (true) { return; }',
+    '        for (int i = 0; i < 3; i++) {}',
+    '        try { } catch (RuntimeException e) { }',
+    '    }',
+    '}',
+    '',
+].join('\n');
+function root() {
+    const tree = parseJava(SRC, 'S.java');
+    if (!tree)
+        throw new Error('no tree');
+    return tree.tree.rootNode;
+}
+function count(pred) {
+    let n = 0;
+    walkNodes(root(), (node) => {
+        if (pred(node))
+            n++;
+    });
+    return n;
+}
+describe('java substrate', () => {
+    it('predicates match the tree-sitter-java node types', () => {
+        expect(count(isFunction)).toBe(2);
+        expect(count(isMethod)).toBe(1);
+        expect(count(isConstructor)).toBe(1);
+        expect(count(isClass)).toBe(1);
+        expect(count(isComment)).toBe(1);
+        expect(count(isString)).toBe(1);
+        expect(count(isCatch)).toBe(1);
+        expect(count(isConditional)).toBe(1);
+        expect(count(isLoop)).toBe(1);
+    });
+    it('getSharedTree caches within an active parse cache', () => {
+        runWithScopeSync(new RunScope(), () => {
+            initParseCache();
+            try {
+                const a = getSharedTree('X.java', 'class X {}');
+                const b = getSharedTree('X.java', 'class X {}');
+                expect(a).toBe(b);
+            }
+            finally {
+                clearParseCache();
+            }
+        });
+    });
+    it('findEnclosingFunction resolves the nearest method/constructor', () => {
+        const strings = [];
+        walkNodes(root(), (n) => {
+            if (n.type === 'string_literal')
+                strings.push(n);
+        });
+        expect(getEnclosingFunctionName(strings[0])).toBe('m');
+        expect(findEnclosingFunction(strings[0])?.type).toBe('method_declaration');
+    });
+});
+//# sourceMappingURL=substrate.test.js.map

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

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

package/dist/adapter.d.ts

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

package/dist/adapter.d.ts.map

@@ -0,0 +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"}

package/dist/adapter.js

@@ -0,0 +1,12 @@
+import { parseJava } from './parse.js';
+import { stripComments, stripStrings } from './strip.js';
+export const javaAdapter = {
+    id: 'java',
+    fileExtensions: ['.java'],
+    parse: parseJava,
+    stripStrings,
+    stripComments,
+};
+/** Plugin contract — exported as the lang plugin's `adapters` array. */
+export const adapters = [javaAdapter];
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +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"}

package/dist/enclosing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Composed enclosing-scope helpers for Java (ADR-0010) — the per-language layer
+ * over the generic `findEnclosing`/`nameOf` from `@opensip-cli/tree-sitter`.
+ * `isMethod` is grammar-direct (Java's `method_declaration`) and lives in
+ * predicates.ts; this module composes the enclosing-function lookups.
+ */
+import { type Node } from '@opensip-cli/tree-sitter';
+/** The nearest enclosing method/constructor of `node`, or `null` at class scope. */
+export declare function findEnclosingFunction(node: Node): Node | null;
+/** The name of the nearest enclosing method/constructor, or `null`. */
+export declare function getEnclosingFunctionName(node: Node): string | null;
+//# sourceMappingURL=enclosing.d.ts.map

package/dist/enclosing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing.d.ts","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAI5E,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAGlE"}

package/dist/enclosing.js

@@ -0,0 +1,19 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * Composed enclosing-scope helpers for Java (ADR-0010) — the per-language layer
+ * over the generic `findEnclosing`/`nameOf` from `@opensip-cli/tree-sitter`.
+ * `isMethod` is grammar-direct (Java's `method_declaration`) and lives in
+ * predicates.ts; this module composes the enclosing-function lookups.
+ */
+import { findEnclosing, nameOf } from '@opensip-cli/tree-sitter';
+import { isFunction } from './predicates.js';
+/** The nearest enclosing method/constructor of `node`, or `null` at class scope. */
+export function findEnclosingFunction(node) {
+    return findEnclosing(node, isFunction);
+}
+/** The name of the nearest enclosing method/constructor, or `null`. */
+export function getEnclosingFunctionName(node) {
+    const fn = findEnclosingFunction(node);
+    return fn ? nameOf(fn) : null;
+}
+//# sourceMappingURL=enclosing.js.map

package/dist/enclosing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enclosing.js","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAa,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,oFAAoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CAAC,IAAU;IACjD,MAAM,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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 { isFunction, isMethod, isConstructor, isClass, isComment, isString, isCatch, isConditional, isLoop, } from './predicates.js';
+export { findEnclosingFunction, getEnclosingFunctionName } from './enclosing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { javaAdapter, adapters } from './adapter.js';
+export { parseJava } from './parse.js';
+export { getSharedTree } from './shared-tree.js';
+export { stripStrings, stripComments } from './strip.js';
+export { isFunction, isMethod, isConstructor, isClass, isComment, isString, isCatch, isConditional, isLoop, } from './predicates.js';
+export { findEnclosingFunction, getEnclosingFunctionName } from './enclosing.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/parse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Java parse — web-tree-sitter + vendored tree-sitter-java.wasm.
+ *
+ * ADR-0010: `lang-java` is the canonical Java parse substrate — fitness checks
+ * parse via the adapter (`getSharedTree`) and the graph Java adapter consumes
+ * this too. The grammar loads once at module top level (the WASM runtime is
+ * initialized by `@opensip-cli/tree-sitter`'s top-level `Parser.init()`); a
+ * single reused parser keeps `parse()` synchronous. Tree-sitter recovers from
+ * syntax errors with MISSING nodes, so a malformed file yields a partial tree
+ * (non-null) rather than throwing.
+ */
+import { type ParsedFile } from '@opensip-cli/tree-sitter';
+/** Parsed Java source: tree-sitter parse tree plus the original source text. */
+export type JavaTree = ParsedFile;
+/** Parses Java source into a {@link JavaTree}, or null when no tree is produced. */
+export declare function parseJava(content: string, _filePath: string): JavaTree | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +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"}

package/dist/parse.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Java parse — web-tree-sitter + vendored tree-sitter-java.wasm.
+ *
+ * ADR-0010: `lang-java` is the canonical Java parse substrate — fitness checks
+ * parse via the adapter (`getSharedTree`) and the graph Java adapter consumes
+ * this too. The grammar loads once at module top level (the WASM runtime is
+ * initialized by `@opensip-cli/tree-sitter`'s top-level `Parser.init()`); a
+ * single reused parser keeps `parse()` synchronous. Tree-sitter recovers from
+ * syntax errors with MISSING nodes, so a malformed file yields a partial tree
+ * (non-null) rather than throwing.
+ */
+import { fileURLToPath } from 'node:url';
+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);
+/** Parses Java source into a {@link JavaTree}, or null when no tree is produced. */
+export function parseJava(content, _filePath) {
+    const tree = parseToTree(parser, content);
+    return tree ? { tree, source: content } : null;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +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"}

package/dist/predicates.d.ts

@@ -0,0 +1,26 @@
+/**
+ * v1 per-language node-kind predicates for Java (ADR-0010). The generic
+ * traversal/position helpers live in `@opensip-cli/tree-sitter`; only the
+ * grammar-specific node `type` strings differ. Node types are from the
+ * tree-sitter-java grammar.
+ */
+import type { Node } from '@opensip-cli/tree-sitter';
+/** A method or constructor declaration (both are callable defs). */
+export declare const isFunction: (node: Node) => boolean;
+/** A method declaration. */
+export declare const isMethod: (node: Node) => boolean;
+/** A constructor declaration. */
+export declare const isConstructor: (node: Node) => boolean;
+/** A class declaration. */
+export declare const isClass: (node: Node) => boolean;
+/** A line or block comment. */
+export declare const isComment: (node: Node) => boolean;
+/** A string literal. */
+export declare const isString: (node: Node) => boolean;
+/** A `catch` clause — Java's error-handling node. */
+export declare const isCatch: (node: Node) => boolean;
+/** An `if` statement. */
+export declare const isConditional: (node: Node) => boolean;
+/** A `for`, `while`, or enhanced-`for` (for-each) loop. */
+export declare const isLoop: (node: Node) => boolean;
+//# sourceMappingURL=predicates.d.ts.map

package/dist/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,oEAAoE;AACpE,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,OACuC,CAAC;AAEhF,4BAA4B;AAC5B,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAA6C,CAAC;AAEpF,iCAAiC;AACjC,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,OAAkD,CAAC;AAE9F,2BAA2B;AAC3B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAA4C,CAAC;AAElF,+BAA+B;AAC/B,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,OACwB,CAAC;AAEhE,wBAAwB;AACxB,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAyC,CAAC;AAEhF,qDAAqD;AACrD,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAAuC,CAAC;AAE7E,yBAAyB;AACzB,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,OAAuC,CAAC;AAEnF,2DAA2D;AAC3D,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,KAAG,OAGI,CAAC"}

package/dist/predicates.js

@@ -0,0 +1,28 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * v1 per-language node-kind predicates for Java (ADR-0010). The generic
+ * traversal/position helpers live in `@opensip-cli/tree-sitter`; only the
+ * grammar-specific node `type` strings differ. Node types are from the
+ * tree-sitter-java grammar.
+ */
+/** A method or constructor declaration (both are callable defs). */
+export const isFunction = (node) => node.type === 'method_declaration' || node.type === 'constructor_declaration';
+/** A method declaration. */
+export const isMethod = (node) => node.type === 'method_declaration';
+/** A constructor declaration. */
+export const isConstructor = (node) => node.type === 'constructor_declaration';
+/** A class declaration. */
+export const isClass = (node) => node.type === 'class_declaration';
+/** A line or block comment. */
+export const isComment = (node) => node.type === 'line_comment' || node.type === 'block_comment';
+/** A string literal. */
+export const isString = (node) => node.type === 'string_literal';
+/** A `catch` clause — Java's error-handling node. */
+export const isCatch = (node) => node.type === 'catch_clause';
+/** An `if` statement. */
+export const isConditional = (node) => node.type === 'if_statement';
+/** A `for`, `while`, or enhanced-`for` (for-each) loop. */
+export const isLoop = (node) => node.type === 'for_statement' ||
+    node.type === 'while_statement' ||
+    node.type === 'enhanced_for_statement';
+//# sourceMappingURL=predicates.js.map

package/dist/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAIH,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAChD,IAAI,CAAC,IAAI,KAAK,oBAAoB,IAAI,IAAI,CAAC,IAAI,KAAK,yBAAyB,CAAC;AAEhF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC;AAEpF,iCAAiC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,yBAAyB,CAAC;AAE9F,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC;AAElF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAW,EAAE,CAC/C,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AAEhE,wBAAwB;AACxB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;AAEhF,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAE7E,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAEnF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAW,EAAE,CAC5C,IAAI,CAAC,IAAI,KAAK,eAAe;IAC7B,IAAI,CAAC,IAAI,KAAK,iBAAiB;IAC/B,IAAI,CAAC,IAAI,KAAK,wBAAwB,CAAC"}

package/dist/shared-tree.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cached Java parse entry point — the analog of `lang-typescript`'s
+ * `getSharedSourceFile`. Routes through `core`'s active `LanguageParseCache`
+ * so a file parsed by a fitness check and by the graph adapter in the same run
+ * is parsed once; falls back to a direct parse when no cache is active.
+ */
+import type { JavaTree } from './parse.js';
+/** Returns the shared (cached) Java parse tree for `filePath`, or null when unparseable. */
+export declare function getSharedTree(filePath: string, content: string): JavaTree | null;
+//# sourceMappingURL=shared-tree.d.ts.map

package/dist/shared-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-tree.d.ts","sourceRoot":"","sources":["../src/shared-tree.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEhF"}

package/dist/shared-tree.js

@@ -0,0 +1,14 @@
+// @fitness-ignore-file duplicate-utility-functions -- ADR-0010: the per-language tree-sitter vocabulary intentionally shares helper names across lang-* with grammar-specific implementations; consolidating would defeat the substrate design.
+/**
+ * Cached Java parse entry point — the analog of `lang-typescript`'s
+ * `getSharedSourceFile`. Routes through `core`'s active `LanguageParseCache`
+ * so a file parsed by a fitness check and by the graph adapter in the same run
+ * is parsed once; falls back to a direct parse when no cache is active.
+ */
+import { getParseTree } from '@opensip-cli/core/languages/parse-cache.js';
+import { javaAdapter } from './adapter.js';
+/** Returns the shared (cached) Java parse tree for `filePath`, or null when unparseable. */
+export function getSharedTree(filePath, content) {
+    return getParseTree(javaAdapter, filePath, content);
+}
+//# sourceMappingURL=shared-tree.js.map

package/dist/shared-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-tree.js","sourceRoot":"","sources":["../src/shared-tree.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,4FAA4F;AAC5F,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,OAAO,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/strip.d.ts

@@ -0,0 +1,5 @@
+/** Replace string literal content with whitespace; preserves length. */
+export declare const stripStrings: (content: string) => string;
+/** Replace string literals AND comments with whitespace; preserves length. */
+export declare const stripComments: (content: string) => string;
+//# sourceMappingURL=strip.d.ts.map

package/dist/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../src/strip.ts"],"names":[],"mappings":"AAqIA,wEAAwE;AACxE,eAAO,MAAM,YAAY,6BAAwB,CAAC;AAClD,8EAA8E;AAC9E,eAAO,MAAM,aAAa,6BAAyB,CAAC"}

package/dist/strip.js

@@ -0,0 +1,120 @@
+// Java string and comment stripping.
+//
+// Hand-written lexer that recognizes:
+// - Line comments (//) and block comments (slash-star ... star-slash, non-nesting)
+// - Regular strings ("...") with escape handling
+// - Text blocks (""" ... """) — Java 13+ multi-line strings, opened by
+//   `"""` followed by a line terminator and closed by `"""`
+// - Char literals ('a', '\n') — preserved as-is (single character is code,
+//   not a string)
+//
+// Both strip functions preserve byte length: replacement is whitespace
+// (newlines preserved) so line/column positions remain stable.
+import { makeStripper, scanBlockCommentNonNesting, scanCharLiteral, scanLineComment, scanRegularString, } from '@opensip-cli/core';
+// eslint-disable-next-line sonarjs/cognitive-complexity -- token-state-machine: cyclomatic complexity is inherent to lexer-style scanners; splitting hurts readability
+function scan(src) {
+    const stringRegions = [];
+    const commentRegions = [];
+    const len = src.length;
+    let i = 0;
+    // INVARIANT: every iteration of the outer loop MUST advance `i`. Each
+    // branch either (a) sets `i = result.end` / `i = result.next` from a
+    // helper that always reports a strictly-increasing position, or
+    // (b) falls through to the `i++` at the bottom. A future branch that
+    // forgets to advance — or misuses `result.end` (note: scanCharLiteral
+    // returns `start + 1` on overflow, which IS still an advance) — would
+    // spin. Keep this invariant in mind when adding new token branches.
+    while (i < len) {
+        const c = src[i];
+        const next = src[i + 1];
+        // Line comment: // ... \n
+        if (c === '/' && next === '/') {
+            const start = i;
+            const lc = scanLineComment(src, i);
+            i = lc.end;
+            commentRegions.push({ start, end: i });
+            continue;
+        }
+        // Block comment: /* ... */ (Java block comments do NOT nest)
+        if (c === '/' && next === '*') {
+            const start = i;
+            const bc = scanBlockCommentNonNesting(src, i);
+            i = bc.end;
+            commentRegions.push({ start, end: i });
+            continue;
+        }
+        // Text block: """ followed by line terminator, ... """
+        // Per JLS, the opening delimiter is `"""` followed by optional
+        // whitespace and then a line terminator. The body starts after that
+        // terminator and ends at the next `"""`.
+        if (c === '"' && src[i + 1] === '"' && src[i + 2] === '"') {
+            // Look past optional whitespace for a newline to confirm text block
+            let j = i + 3;
+            while (j < len && (src[j] === ' ' || src[j] === '\t'))
+                j++;
+            if (j < len && (src[j] === '\n' || src[j] === '\r')) {
+                // It's a text block. Body starts after the line terminator.
+                // Skip the line terminator (handle \r\n).
+                j += src[j] === '\r' && src[j + 1] === '\n' ? 2 : 1;
+                const contentStart = j;
+                // Scan to closing """ — track backslash escapes so a literal `\"""`
+                // inside the body does not prematurely close the text block (JLS §3.10.6
+                // honors the same escape sequences as regular string literals).
+                let bodyEscape = false;
+                let closed = false;
+                while (j < len) {
+                    if (bodyEscape) {
+                        bodyEscape = false;
+                        j++;
+                        continue;
+                    }
+                    if (src[j] === '\\') {
+                        bodyEscape = true;
+                        j++;
+                        continue;
+                    }
+                    if (src[j] === '"' && src[j + 1] === '"' && src[j + 2] === '"') {
+                        const contentEnd = j;
+                        stringRegions.push({ start: contentStart, end: contentEnd });
+                        i = j + 3;
+                        closed = true;
+                        break;
+                    }
+                    j++;
+                }
+                if (!closed) {
+                    // Unterminated text block — record what we have
+                    stringRegions.push({ start: contentStart, end: len });
+                    i = len;
+                }
+                continue;
+            }
+            // Not a text block (e.g. `""` empty string followed by another `"`).
+            // Fall through to regular string handling.
+        }
+        // Regular string: "..."
+        if (c === '"') {
+            const result = scanRegularString(src, i);
+            stringRegions.push({ start: i + 1, end: result.contentEnd });
+            i = result.next;
+            continue;
+        }
+        // Char literal: '...' — preserve as code (single character, not a string).
+        // Use the shared scanCharLiteral helper from core (default 8-char cap
+        // matches the lang-cpp / lang-rust heuristic; branch order is
+        // load-bearing — see core's scanCharLiteral docstring and lang-java F6).
+        if (c === "'") {
+            const result = scanCharLiteral(src, i);
+            i = result.end;
+            continue;
+        }
+        i++;
+    }
+    return { stringRegions, commentRegions };
+}
+const stripper = makeStripper(scan);
+/** Replace string literal content with whitespace; preserves length. */
+export const stripStrings = stripper.stripStrings;
+/** Replace string literals AND comments with whitespace; preserves length. */
+export const stripComments = stripper.stripComments;
+//# sourceMappingURL=strip.js.map

package/dist/strip.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@opensip-cli/lang-java",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Java language adapter for opensip-cli",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "parser",
+    "ast",
+    "tree-sitter",
+    "java"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/languages/lang-java"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "wasm",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@opensip-cli/core": "0.1.0",
+    "@opensip-cli/tree-sitter": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}