@opensip-cli/lang-python 0.1.8 → 0.1.10

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.8/docs/public/70-reference/02-package-catalog.md
-- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.8/packages/languages/lang-python
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.10/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.10/packages/languages/lang-python
 
 ## License
 

package/dist/__tests__/enclosing.test.js

@@ -1,8 +1,8 @@
 import { nameOf, walkNodes } from '@opensip-cli/tree-sitter';
 import { describe, expect, it } from 'vitest';
-import { findEnclosingFunction, getEnclosingFunctionName, isMethod } from '../enclosing.js';
+import { findEnclosingFunction, getEnclosingFunctionName } from '../enclosing.js';
 import { parsePython } from '../parse.js';
-import { isFunction } from '../predicates.js';
+import { isFunction, isMethod } from '../predicates.js';
 const SRC = [
     'class S:',
     '    def m(self):',

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

@@ -1 +1 @@
-{"version":3,"file":"enclosing.test.js","sourceRoot":"","sources":["../../src/__tests__/enclosing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,MAAM,GAAG,GAAG;IACV,UAAU;IACV,kBAAkB;IAClB,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC5B,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAA+C,EAAE,CAAC;QAC5D,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,UAAU,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,YAAY,GAAW,EAAE,CAAC;QAChC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"enclosing.test.js","sourceRoot":"","sources":["../../src/__tests__/enclosing.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIxD,MAAM,GAAG,GAAG;IACV,UAAU;IACV,kBAAkB;IAClB,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC5B,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAA+C,EAAE,CAAC;QAC5D,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,UAAU,CAAC,CAAC,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,YAAY,GAAW,EAAE,CAAC;QAChC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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,70 @@
+import { describe, expect, it } from 'vitest';
+import { pythonAdapter } from '../adapter.js';
+function parse(src) {
+    const tree = pythonAdapter.parse(src, 't.py');
+    if (!tree)
+        throw new Error('no tree');
+    return tree;
+}
+const q = pythonAdapter.query;
+describe('pythonQuery (LanguageQueryAPI)', () => {
+    it('is wired onto the adapter', () => {
+        expect(pythonAdapter.query).toBeDefined();
+    });
+    it('findFunctions returns defs, methods, and anonymous lambdas', () => {
+        const tree = parse([
+            'def top():',
+            '    pass',
+            'class C:',
+            '    def m(self):',
+            '        f = lambda x: x',
+            '',
+        ].join('\n'));
+        const names = q.findFunctions(tree).map((f) => f.name);
+        expect(names).toContain('top');
+        expect(names).toContain('m');
+        expect(names).toContain(null); // lambda
+    });
+    it('findImports handles import, aliased import, from-import, and wildcard', () => {
+        const tree = parse([
+            'import os.path',
+            'import numpy as np',
+            'from collections import OrderedDict, defaultdict',
+            'from mod import *',
+            '',
+        ].join('\n'));
+        const imports = q.findImports(tree);
+        const bySpec = new Map(imports.map((i) => [i.specifier, i.names]));
+        expect(bySpec.get('os.path')).toEqual(['path']);
+        expect(bySpec.get('numpy')).toEqual(['numpy']);
+        expect(bySpec.get('collections')).toEqual(['OrderedDict', 'defaultdict']);
+        expect(bySpec.get('mod')).toEqual([]); // wildcard contributes no names
+    });
+    it('findCallsTo matches identifier and attribute call targets', () => {
+        const tree = parse(['def f():', '    foo()', '    obj.bar()', ''].join('\n'));
+        expect(q.findCallsTo(tree, 'foo').length).toBe(1);
+        expect(q.findCallsTo(tree, 'bar').length).toBe(1);
+        expect(q.findCallsTo(tree, 'absent').length).toBe(0);
+    });
+    it('findCallsTo ignores computed/subscript callees', () => {
+        const tree = parse(['def f():', '    handlers[0]()', ''].join('\n'));
+        expect(q.findCallsTo(tree, 'handlers').length).toBe(0);
+    });
+    it('findImports handles relative from-imports', () => {
+        const tree = parse(['from . import sibling', 'from .pkg import thing', ''].join('\n'));
+        const imports = q.findImports(tree);
+        // The relative-import marker is part of the specifier (faithful to source).
+        const rel = imports.find((i) => i.names.includes('sibling'));
+        expect(rel?.specifier).toBe('.');
+        const pkg = imports.find((i) => i.names.includes('thing'));
+        expect(pkg?.specifier).toBe('.pkg');
+    });
+    it('findStringLiterals returns values; getText/getLocation read nodes', () => {
+        const tree = parse(['def f():', '    s = "hello"', ''].join('\n'));
+        expect(q.findStringLiterals(tree).map((s) => s.value)).toContain('hello');
+        const fn = q.findFunctions(tree)[0];
+        expect(q.getText(tree, fn.node)).toContain('def f');
+        expect(q.getLocation(tree, fn.node).line).toBe(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 PythonTree } from './parse.js';
 import type { LanguageAdapter } from '@opensip-cli/core';
-export declare const pythonAdapter: LanguageAdapter<PythonTree>;
+import type { Node } from '@opensip-cli/tree-sitter';
+export declare const pythonAdapter: LanguageAdapter<PythonTree, 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,EAAe,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,UAAU,CAOrD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,oFAA2B,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,CAQ3D,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,QAAQ,iFAA2B,CAAC"}

package/dist/adapter.js

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

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,EAAE,EAAE,QAAQ;IACZ,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,KAAK,EAAE,WAAW;IAClB,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAU,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKzD,MAAM,CAAC,MAAM,aAAa,GAAsC;IAC9D,EAAE,EAAE,QAAQ;IACZ,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,KAAK,EAAE,WAAW;IAClB,YAAY;IACZ,aAAa;IACb,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAU,CAAC"}

package/dist/enclosing.d.ts

@@ -2,17 +2,12 @@
  * Composed enclosing-scope helpers for Python (ADR-0010) — the per-language
  * layer over the generic `findEnclosing`/`nameOf` from
  * `@opensip-cli/tree-sitter`. Mirrors `lang-typescript`'s
- * `findEnclosingFunction` / `getEnclosingFunctionName`.
+ * `findEnclosingFunction` / `getEnclosingFunctionName`. `isMethod` lives in
+ * predicates.ts (normalized in M10), alongside the other node-kind predicates.
  */
 import { type Node } from '@opensip-cli/tree-sitter';
 /** The nearest enclosing `def` of `node`, or `null` at module scope. */
 export declare function findEnclosingFunction(node: Node): Node | null;
 /** The name of the nearest enclosing `def`, or `null`. */
 export declare function getEnclosingFunctionName(node: Node): string | null;
-/**
- * True when `node` is a method — a `function_definition` whose *nearest*
- * enclosing function-or-class is a class. A function nested inside another
- * function is therefore not a method (its nearest enclosing scope is a `def`).
- */
-export declare function isMethod(node: Node): boolean;
 //# sourceMappingURL=enclosing.d.ts.map

package/dist/enclosing.d.ts.map

@@ -1 +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,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAI5C"}
+{"version":3,"file":"enclosing.d.ts","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAI5E,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAE7D;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAGlE"}

package/dist/enclosing.js

@@ -3,10 +3,11 @@
  * Composed enclosing-scope helpers for Python (ADR-0010) — the per-language
  * layer over the generic `findEnclosing`/`nameOf` from
  * `@opensip-cli/tree-sitter`. Mirrors `lang-typescript`'s
- * `findEnclosingFunction` / `getEnclosingFunctionName`.
+ * `findEnclosingFunction` / `getEnclosingFunctionName`. `isMethod` lives in
+ * predicates.ts (normalized in M10), alongside the other node-kind predicates.
  */
 import { findEnclosing, nameOf } from '@opensip-cli/tree-sitter';
-import { isClass, isFunction } from './predicates.js';
+import { isFunction } from './predicates.js';
 /** The nearest enclosing `def` of `node`, or `null` at module scope. */
 export function findEnclosingFunction(node) {
     return findEnclosing(node, isFunction);
@@ -16,15 +17,4 @@ export function getEnclosingFunctionName(node) {
     const fn = findEnclosingFunction(node);
     return fn ? nameOf(fn) : null;
 }
-/**
- * True when `node` is a method — a `function_definition` whose *nearest*
- * enclosing function-or-class is a class. A function nested inside another
- * function is therefore not a method (its nearest enclosing scope is a `def`).
- */
-export function isMethod(node) {
-    if (!isFunction(node))
-        return false;
-    const enclosing = findEnclosing(node, (n) => isFunction(n) || isClass(n));
-    return enclosing !== null && isClass(enclosing);
-}
 //# sourceMappingURL=enclosing.js.map

package/dist/enclosing.js.map

@@ -1 +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,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtD,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,0DAA0D;AAC1D,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;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"enclosing.js","sourceRoot":"","sources":["../src/enclosing.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAa,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,IAAU;IAC9C,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,0DAA0D;AAC1D,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

@@ -2,7 +2,8 @@ export { pythonAdapter, adapters } from './adapter.js';
 export { parsePython, type PythonTree } from './parse.js';
 export { getSharedTree } from './shared-tree.js';
 export { stripStrings, stripComments } from './strip.js';
-export { isFunction, isClass, isComment, isString, isExcept, isConditional, isLoop, } from './predicates.js';
-export { findEnclosingFunction, getEnclosingFunctionName, isMethod } from './enclosing.js';
+export { pythonQuery } from './query.js';
+export { isFunction, isMethod, isClass, isComment, isString, isExcept, 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,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO3F,OAAO,EACL,UAAU,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,MAAM,EACN,eAAe,EACf,QAAQ,EACR,SAAS,EACT,KAAK,IAAI,GACV,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,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,8 +2,9 @@ export { pythonAdapter, adapters } from './adapter.js';
 export { parsePython } from './parse.js';
 export { getSharedTree } from './shared-tree.js';
 export { stripStrings, stripComments } from './strip.js';
-export { isFunction, isClass, isComment, isString, isExcept, isConditional, isLoop, } from './predicates.js';
-export { findEnclosingFunction, getEnclosingFunctionName, isMethod } from './enclosing.js';
+export { pythonQuery } from './query.js';
+export { isFunction, isMethod, isClass, isComment, isString, isExcept, 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-python +

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE3F,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,MAAM,GACP,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,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/predicates.d.ts

@@ -4,7 +4,7 @@
  * grammar-specific node `type` strings differ per language, and they live here.
  * Node types are from the tree-sitter-python grammar.
  */
-import type { Node } from '@opensip-cli/tree-sitter';
+import { type Node } from '@opensip-cli/tree-sitter';
 /** A `def` — both top-level functions and methods are `function_definition`. */
 export declare const isFunction: (node: Node) => boolean;
 /** A `class` declaration. */
@@ -19,4 +19,12 @@ export declare const isExcept: (node: Node) => boolean;
 export declare const isConditional: (node: Node) => boolean;
 /** A `for` or `while` loop. */
 export declare const isLoop: (node: Node) => boolean;
+/**
+ * True when `node` is a method — a `function_definition` whose *nearest*
+ * enclosing function-or-class is a class. A function nested inside another
+ * function is therefore not a method (its nearest enclosing scope is a `def`).
+ * Normalized into predicates.ts (M10): `isMethod` lives in predicates.ts in
+ * every tree-sitter adapter.
+ */
+export declare const isMethod: (node: Node) => boolean;
 //# sourceMappingURL=predicates.d.ts.map

package/dist/predicates.d.ts.map

@@ -1 +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,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,OAA8C,CAAC;AAEvF,6BAA6B;AAC7B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAA2C,CAAC;AAEjF,qBAAqB;AACrB,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,OAAkC,CAAC;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAiC,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAwC,CAAC;AAE/E,yBAAyB;AACzB,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,OAAuC,CAAC;AAEnF,+BAA+B;AAC/B,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,KAAG,OAC8B,CAAC"}
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEpE,gFAAgF;AAChF,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,KAAG,OAA8C,CAAC;AAEvF,6BAA6B;AAC7B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAA2C,CAAC;AAEjF,qBAAqB;AACrB,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,OAAkC,CAAC;AAE1E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAiC,CAAC;AAExE,+DAA+D;AAC/D,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAAwC,CAAC;AAE/E,yBAAyB;AACzB,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,OAAuC,CAAC;AAEnF,+BAA+B;AAC/B,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,KAAG,OAC8B,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAIrC,CAAC"}

package/dist/predicates.js

@@ -5,6 +5,7 @@
  * grammar-specific node `type` strings differ per language, and they live here.
  * Node types are from the tree-sitter-python grammar.
  */
+import { findEnclosing } from '@opensip-cli/tree-sitter';
 /** A `def` — both top-level functions and methods are `function_definition`. */
 export const isFunction = (node) => node.type === 'function_definition';
 /** A `class` declaration. */
@@ -19,4 +20,17 @@ export const isExcept = (node) => node.type === 'except_clause';
 export const isConditional = (node) => node.type === 'if_statement';
 /** A `for` or `while` loop. */
 export const isLoop = (node) => node.type === 'for_statement' || node.type === 'while_statement';
+/**
+ * True when `node` is a method — a `function_definition` whose *nearest*
+ * enclosing function-or-class is a class. A function nested inside another
+ * function is therefore not a method (its nearest enclosing scope is a `def`).
+ * Normalized into predicates.ts (M10): `isMethod` lives in predicates.ts in
+ * every tree-sitter adapter.
+ */
+export const isMethod = (node) => {
+    if (!isFunction(node))
+        return false;
+    const enclosing = findEnclosing(node, (n) => isFunction(n) || isClass(n));
+    return enclosing !== null && isClass(enclosing);
+};
 //# sourceMappingURL=predicates.js.map

package/dist/predicates.js.map

@@ -1 +1 @@
-{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAIH,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC;AAEvF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC;AAEjF,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAExE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AAE/E,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAEnF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAW,EAAE,CAC5C,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC"}
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA,gPAAgP;AAChP;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAa,MAAM,0BAA0B,CAAC;AAEpE,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC;AAEvF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC;AAEjF,qBAAqB;AACrB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AAExE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AAE/E,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC;AAEnF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAU,EAAW,EAAE,CAC5C,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAW,EAAE;IAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,OAAO,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Python {@link LanguageQueryAPI} (ADR-0010, M10) — the grammar config for the
+ * shared `createTreeSitterQuery` factory. Node types are from tree-sitter-python;
+ * the callee extractor mirrors `graph-python`'s resolver so the query agrees
+ * with the call graph.
+ */
+import { type LanguageQueryAPI, type Node, type ParsedFile } from '@opensip-cli/tree-sitter';
+export declare const pythonQuery: 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;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AA6FlC,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAKzD,CAAC"}

package/dist/query.js

@@ -0,0 +1,107 @@
+// @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.
+/**
+ * Python {@link LanguageQueryAPI} (ADR-0010, M10) — the grammar config for the
+ * shared `createTreeSitterQuery` factory. Node types are from tree-sitter-python;
+ * the callee extractor mirrors `graph-python`'s resolver so the query agrees
+ * with the call graph.
+ */
+import { createTreeSitterQuery, namedChildrenOf, } from '@opensip-cli/tree-sitter';
+/** Leaf callee name of a `call` node (`foo()` → `foo`, `o.m()` → `m`). */
+function calleeName(node) {
+    const fn = node.childForFieldName('function');
+    /* v8 ignore next -- a `call` node always exposes its `function` field */
+    if (!fn)
+        return null;
+    if (fn.type === 'identifier')
+        return fn.text;
+    if (fn.type === 'attribute') {
+        const attr = fn.childForFieldName('attribute');
+        /* v8 ignore next -- an attribute node always exposes its `attribute` field */
+        return attr ? attr.text : null;
+    }
+    // Other callee shapes (subscript/computed) — unresolved by name.
+    return null;
+}
+/** The terminal segment of a dotted module 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;
+}
+/** Resolve a name-bearing import item (identifier / dotted_name / aliased_import). */
+function importItemName(node) {
+    if (node.type === 'identifier')
+        return node.text;
+    if (node.type === 'dotted_name')
+        return dottedLeaf(node.text);
+    if (node.type === 'aliased_import') {
+        // `<path> as <alias>` — keep the underlying leaf name (alias dropped).
+        const inner = node.childForFieldName('name') ?? node.namedChild(0);
+        /* v8 ignore next -- an aliased_import always wraps a name node */
+        return inner ? importItemName(inner) : null;
+    }
+    // Non-name children (e.g. comments inside a parenthesized import list).
+    return null;
+}
+/**
+ * Expand a Python import statement into import targets.
+ *   - `import a.b.c`            → specifier `a.b.c`, names `[c]`
+ *   - `import a.b as x`         → specifier `a.b`, names `[b]`
+ *   - `from m import x, y`      → specifier `m`, names `[x, y]`
+ *   - `from m import *`         → specifier `m`, names `[]`
+ */
+/** The path text of an import item — the LHS path of an `aliased_import`. */
+function importItemSpecifier(item) {
+    if (item.type === 'aliased_import') {
+        const inner = item.childForFieldName('name') ?? item.namedChild(0);
+        /* v8 ignore next -- an aliased_import always wraps a path node */
+        return inner ? inner.text : item.text;
+    }
+    return item.text;
+}
+function extractImport(node) {
+    if (node.type === 'import_statement') {
+        const out = [];
+        for (const item of namedChildrenOf(node)) {
+            const specifier = importItemSpecifier(item);
+            const name = importItemName(item);
+            out.push({ specifier, names: name ? [name] : [] });
+        }
+        return out;
+    }
+    // import_from_statement (the only other configured import node type).
+    const moduleNode = node.childForFieldName('module_name');
+    /* v8 ignore next -- a from-import always has a module_name (`.` for relatives) */
+    const specifier = moduleNode ? moduleNode.text : '';
+    const names = [];
+    // Imported names are the name-bearing children other than the module
+    // itself. A bare `*` (`wildcard_import`) contributes no names.
+    for (const child of namedChildrenOf(node)) {
+        if (child.startIndex === moduleNode?.startIndex)
+            continue;
+        if (child.type === 'wildcard_import')
+            continue;
+        const name = importItemName(child);
+        if (name)
+            names.push(name);
+    }
+    return [{ specifier, names }];
+}
+const FUNCTION_NODE_TYPES = new Set(['function_definition', 'lambda']);
+const CALL_NODE_TYPES = new Set(['call']);
+const IMPORT_NODE_TYPES = new Set(['import_statement', 'import_from_statement']);
+const STRING_NODE_TYPES = new Set(['string']);
+/** A `lambda` has no name field — keep `findFunctions` faithful (null). */
+function pythonFunctionName(node) {
+    if (node.type === 'lambda')
+        return null;
+    const name = node.childForFieldName('name');
+    /* v8 ignore next -- a function_definition always exposes its name field */
+    return name ? name.text : null;
+}
+export const pythonQuery = createTreeSitterQuery({
+    functions: { nodeTypes: FUNCTION_NODE_TYPES, nameOf: pythonFunctionName },
+    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":"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"}

package/package.json

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