@untangle-code/parser-registry 0.0.0-stage → 0.1.1

package/dist/languages/python/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../../src/languages/python/profile.ts"],"names":[],"mappings":"AA+BA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKlD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAC7C,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAEjF,qGAAqG;AACrG,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,qBAAqB;IACrB,kBAAkB;IAClB,QAAQ;CACT,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,oFAAoF;AACpF,SAAS,iBAAiB,CAAC,IAAgB;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CACrB,IAAgB,EAChB,GAAoB,EACpB,SAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;QAAE,OAAO,SAAS,CAAC;IAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,UAAU,KAAK,IAAI,IAAI,iBAAiB,CAAC,UAAU,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpF,OAAO,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,IAAgB;IACrC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,SAAS,CAAC,IAAI,KAAK,sBAAsB;YAAE,SAAS;QACxD,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,KAAK,YAAY;YAAE,SAAS;QACtE,MAAM,IAAI,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACrF,MAAM,KAAK,GAAG,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACpD,IACE,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EACzE,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,IAAI,KAAK,IAAI;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,SAAS,UAAU,CAAC,IAAgB;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,KAAK,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC;AACpF,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,+EAA+E;AAC/E,SAAS,kBAAkB,CAAC,IAAgB;IAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,IAAI,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC;QAC/D,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,kFAAkF;AAClF,SAAS,aAAa,CAAC,IAAgB;IACrC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,IAAgB,EAChB,GAAoB,EACpB,IAAoB,EACpB,UAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,qEAAqE;IACrE,wEAAwE;IACxE,MAAM,UAAU,GACd,UAAU,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE1D,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAChB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,UAAU;gBACV,KAAK;gBACL,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;aACvE,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACzD,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO;IAChC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,4EAA4E;IAC5E,mEAAmE;IACnE,0EAA0E;IAC1E,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,YAAY;YAAE,SAAS;QAC5B,uEAAuE;QACvE,yEAAyE;QACzE,uBAAuB;QACvB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,IAAI;YAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAChB,SAAS,EAAE,UAAU,CAAC,IAAI;QAC1B,UAAU;QACV,KAAK;QACL,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,IAAgB,EAAE,SAAiB;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC;IACxE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,eAAe,CAAC,IAAgB,EAAE,IAAY,EAAE,SAAiB;IACxE,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACxD,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,cAAc,GAClB,UAAU,KAAK,IAAI;QACjB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YACtC,CAAC,CAAC,UAAU,CAAC,IAAI;YACjB,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACzD,gEAAgE;IAChE,4EAA4E;IAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,cAAc,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7F,MAAM,UAAU,GAAG,GAAG,IAAI,GAAG,sBAAsB,CAAC,cAAc,CAAC,GAAG,mBAAmB,CACvF,UAAU,EAAE,IAAI,CACjB,EAAE,CAAC;IACJ,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAqB,EACrB,IAAgB,EAChB,IAAgB;IAEhB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC;IAEzB,OAAO;QACL,GAAG,IAAI;QAEP,4EAA4E;QAC5E,sBAAsB,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,sBAAsB,EAAE,GAAG,iBAAiB,CAAC,CAAC;QACvF,iBAAiB,CAAC,IAAY;YAC5B,OAAO,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC;QAED,sEAAsE;QACtE,0EAA0E;QAC1E,kBAAkB,EAAE,IAAI,GAAG,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAErD,mDAAmD;QACnD,WAAW,CAAC,IAAgB;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB;gBAAE,OAAO,IAAI,CAAC;YAC5E,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,kBAAkB;gBAAE,OAAO,UAAU,CAAC;YACvE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxE,CAAC;QAED,cAAc,CAAC,IAAgB,EAAE,KAAwB,EAAE,IAAY;YACrE,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAChD,CAAC;QAED,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC;QAE7D,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAEnD,yEAAyE;QACzE,0EAA0E;QAC1E,aAAa,CAAC,IAAgB,EAAE,IAAY;YAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjC,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,wBAAwB,CAAC,IAAgB;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACrD,sEAAsE;YACtE,yEAAyE;YACzE,wEAAwE;YACxE,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO,QAAQ,CAAC;YACtF,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,IAAI,YAAY,IAAI,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACvC,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,CAAC,EAAE,EAAE,CAAC;QACvF,CAAC;QAED,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI;YACrD,IACE,IAAI,KAAK,kBAAkB;gBAC3B,IAAI,KAAK,uBAAuB;gBAChC,IAAI,KAAK,yBAAyB,EAClC,CAAC;gBACD,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/languages/python/signature.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Signature text normalization for Python (spec.md §5.5).
+ *
+ * `normalizedSignature` feeds `buildSymbolId` and MUST be stable across
+ * formatting-only edits. Rules (documented WP-09 decision — Python has no
+ * `tree-sitter-python` grammar to reuse `languages/shared/signature.ts`'s
+ * `<`/`>`-as-bracket assumption from, which is wrong for Python anyway:
+ * `<`/`>` are ONLY comparison operators here, never generic brackets):
+ *
+ * 1. **Whitespace**: any run of spaces/tabs/newlines collapses to a single
+ *    space; spacing around `,`, `:` (annotation colon) and `=` (only for
+ *    an ANNOTATED parameter's default, per PEP 8 — `x: int = 1`, not
+ *    `x=1`) is canonicalized.
+ * 2. **Default values** (`= <expr>`) are STRIPPED from the identity
+ *    signature, exactly like the TS/JS adapters: a default value is a
+ *    call-site convenience, not a change to the parameter's name,
+ *    position, or `*`/`**` role — keeping it would change a symbol's id on
+ *    a body-only-feeling edit (`def f(a=1)` -> `def f(a=2)` should not look
+ *    like a new symbol). Unlike TypeScript, Python has no separate
+ *    "optional marker" syntax (`?`) that would otherwise carry the
+ *    "caller may omit this" information forward — that information is
+ *    simply not part of the normalized identity for Python, a documented
+ *    (not accidental) asymmetry with the TS/JS adapters.
+ * 3. **Type annotations** (`: <type>`) are kept verbatim (modulo whitespace
+ *    rules) — they are part of the observable call contract.
+ * 4. **`*args` / `**kwargs` / bare `*` (keyword-only marker) / `/`
+ *    (positional-only marker, PEP 570)**: their `*`/`**`/`/` marker is kept
+ *    exactly as written (it changes the call contract), only a following
+ *    default (impossible for `*args`/`**kwargs`/markers, but harmless to
+ *    guard) or its annotation spacing is normalized.
+ * 5. **Return type** (`-> <type>`) is kept verbatim (modulo whitespace),
+ *    canonicalized to always have exactly one space on each side of `->`.
+ *
+ * Known limitation (documented, not a defect, mirroring the TS/JS
+ * adapters' own documented limitation): default-value stripping uses a
+ * bracket-DEPTH scanner over `( [ {` (never `<`/`>` — see above), not a
+ * full expression parser. A default expression containing an unbalanced
+ * string literal with a comma/`=` inside is not specially protected either
+ * (rare enough in default-value position to accept as a scoping decision).
+ */
+/** Collapses whitespace runs to single spaces and trims. */
+export declare function normalizeSpacing(text: string): string;
+/** Splits `content` on top-level `,` (depth 0 w.r.t. `( [ {`). */
+export declare function splitTopLevelComma(content: string): string[];
+/** Strips one parameter entry's default value (`= <expr>`), keeping any annotation before it. */
+export declare function stripDefaultValue(entry: string): string;
+/** Normalizes a parameter-list text INCLUDING its outer parens, e.g. `( a:int=1, *, b = 2 )` -> `(a: int, *, b)`. */
+export declare function normalizeParameterList(paramsText: string): string;
+/** Normalizes a `-> ReturnType` suffix (or `""` when absent). */
+export declare function normalizeReturnType(returnTypeRaw: string | undefined): string;
+/** Normalizes a class/def header text with no parameter list (e.g. a bare `class Foo:`). */
+export declare function normalizeHeaderText(headerText: string): string;
+//# sourceMappingURL=signature.d.ts.map

package/dist/languages/python/signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/languages/python/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAKH,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC5D;AAyCD,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAiCD,qHAAqH;AACrH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CASjE;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG7E;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/languages/python/signature.js

@@ -0,0 +1,188 @@
+/**
+ * Signature text normalization for Python (spec.md §5.5).
+ *
+ * `normalizedSignature` feeds `buildSymbolId` and MUST be stable across
+ * formatting-only edits. Rules (documented WP-09 decision — Python has no
+ * `tree-sitter-python` grammar to reuse `languages/shared/signature.ts`'s
+ * `<`/`>`-as-bracket assumption from, which is wrong for Python anyway:
+ * `<`/`>` are ONLY comparison operators here, never generic brackets):
+ *
+ * 1. **Whitespace**: any run of spaces/tabs/newlines collapses to a single
+ *    space; spacing around `,`, `:` (annotation colon) and `=` (only for
+ *    an ANNOTATED parameter's default, per PEP 8 — `x: int = 1`, not
+ *    `x=1`) is canonicalized.
+ * 2. **Default values** (`= <expr>`) are STRIPPED from the identity
+ *    signature, exactly like the TS/JS adapters: a default value is a
+ *    call-site convenience, not a change to the parameter's name,
+ *    position, or `*`/`**` role — keeping it would change a symbol's id on
+ *    a body-only-feeling edit (`def f(a=1)` -> `def f(a=2)` should not look
+ *    like a new symbol). Unlike TypeScript, Python has no separate
+ *    "optional marker" syntax (`?`) that would otherwise carry the
+ *    "caller may omit this" information forward — that information is
+ *    simply not part of the normalized identity for Python, a documented
+ *    (not accidental) asymmetry with the TS/JS adapters.
+ * 3. **Type annotations** (`: <type>`) are kept verbatim (modulo whitespace
+ *    rules) — they are part of the observable call contract.
+ * 4. **`*args` / `**kwargs` / bare `*` (keyword-only marker) / `/`
+ *    (positional-only marker, PEP 570)**: their `*`/`**`/`/` marker is kept
+ *    exactly as written (it changes the call contract), only a following
+ *    default (impossible for `*args`/`**kwargs`/markers, but harmless to
+ *    guard) or its annotation spacing is normalized.
+ * 5. **Return type** (`-> <type>`) is kept verbatim (modulo whitespace),
+ *    canonicalized to always have exactly one space on each side of `->`.
+ *
+ * Known limitation (documented, not a defect, mirroring the TS/JS
+ * adapters' own documented limitation): default-value stripping uses a
+ * bracket-DEPTH scanner over `( [ {` (never `<`/`>` — see above), not a
+ * full expression parser. A default expression containing an unbalanced
+ * string literal with a comma/`=` inside is not specially protected either
+ * (rare enough in default-value position to accept as a scoping decision).
+ */
+const OPEN_BRACKETS = new Set(["(", "[", "{"]);
+const CLOSE_BRACKETS = new Set([")", "]", "}"]);
+/** Collapses whitespace runs to single spaces and trims. */
+export function normalizeSpacing(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+/** Splits `content` on top-level `,` (depth 0 w.r.t. `( [ {`). */
+export function splitTopLevelComma(content) {
+    const parts = [];
+    let depth = 0;
+    let current = "";
+    let inString = null;
+    for (let i = 0; i < content.length; i += 1) {
+        const ch = content[i];
+        if (inString !== null) {
+            current += ch;
+            if (ch === "\\") {
+                i += 1;
+                if (i < content.length)
+                    current += content[i];
+            }
+            else if (ch === inString) {
+                inString = null;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = ch;
+            current += ch;
+            continue;
+        }
+        if (OPEN_BRACKETS.has(ch))
+            depth += 1;
+        else if (CLOSE_BRACKETS.has(ch))
+            depth = Math.max(0, depth - 1);
+        if (ch === "," && depth === 0) {
+            parts.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    parts.push(current);
+    return parts;
+}
+/** Index of the top-level `=` introducing a default value, or -1. Excludes `==`, `!=`, `<=`, `>=`, `:=`. */
+function findTopLevelDefaultEquals(text) {
+    let depth = 0;
+    let inString = null;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString !== null) {
+            if (ch === "\\")
+                i += 1;
+            else if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = ch;
+            continue;
+        }
+        if (OPEN_BRACKETS.has(ch)) {
+            depth += 1;
+            continue;
+        }
+        if (CLOSE_BRACKETS.has(ch)) {
+            depth = Math.max(0, depth - 1);
+            continue;
+        }
+        if (ch === "=" && depth === 0) {
+            const prev = i > 0 ? text[i - 1] : "";
+            const next = i + 1 < text.length ? text[i + 1] : "";
+            const isCompoundOperator = next === "=" ||
+                prev === "=" ||
+                prev === "!" ||
+                prev === "<" ||
+                prev === ">" ||
+                prev === ":";
+            if (!isCompoundOperator)
+                return i;
+        }
+    }
+    return -1;
+}
+/** Strips one parameter entry's default value (`= <expr>`), keeping any annotation before it. */
+export function stripDefaultValue(entry) {
+    const eqIndex = findTopLevelDefaultEquals(entry);
+    return eqIndex === -1 ? entry : entry.slice(0, eqIndex).trimEnd();
+}
+/** Canonicalizes one parameter entry's internal spacing: `a :int=1` -> `a: int`. */
+function normalizeParamEntry(entry) {
+    const stripped = stripDefaultValue(entry);
+    const colonIndex = topLevelColonIndex(stripped);
+    if (colonIndex === -1)
+        return normalizeSpacing(stripped);
+    const name = normalizeSpacing(stripped.slice(0, colonIndex));
+    const annotation = normalizeSpacing(stripped.slice(colonIndex + 1));
+    return `${name}: ${annotation}`;
+}
+function topLevelColonIndex(text) {
+    let depth = 0;
+    let inString = null;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString !== null) {
+            if (ch === "\\")
+                i += 1;
+            else if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = ch;
+            continue;
+        }
+        if (OPEN_BRACKETS.has(ch))
+            depth += 1;
+        else if (CLOSE_BRACKETS.has(ch))
+            depth = Math.max(0, depth - 1);
+        else if (ch === ":" && depth === 0)
+            return i;
+    }
+    return -1;
+}
+/** Normalizes a parameter-list text INCLUDING its outer parens, e.g. `( a:int=1, *, b = 2 )` -> `(a: int, *, b)`. */
+export function normalizeParameterList(paramsText) {
+    const trimmed = paramsText.trim();
+    const hasParens = trimmed.startsWith("(") && trimmed.endsWith(")");
+    const inner = hasParens ? trimmed.slice(1, -1) : trimmed;
+    const entries = splitTopLevelComma(inner)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    const normalizedEntries = entries.map(normalizeParamEntry);
+    return `(${normalizedEntries.join(", ")})`;
+}
+/** Normalizes a `-> ReturnType` suffix (or `""` when absent). */
+export function normalizeReturnType(returnTypeRaw) {
+    if (returnTypeRaw === undefined || returnTypeRaw.trim().length === 0)
+        return "";
+    return ` -> ${normalizeSpacing(returnTypeRaw)}`;
+}
+/** Normalizes a class/def header text with no parameter list (e.g. a bare `class Foo:`). */
+export function normalizeHeaderText(headerText) {
+    return normalizeSpacing(headerText.replace(/:\s*$/, ""));
+}
+//# sourceMappingURL=signature.js.map

package/dist/languages/python/signature.js.map

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

package/dist/languages/python/table.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Die Sprachtabelle fuer Python — die zwoelfte Sprache des ast-grep-Backends.
+ *
+ * WAS HIER GESCHAH (WP-239): bis Welle 7 stand an dieser Stelle ein
+ * HANDGESCHRIEBENER Tokenizer, Parser und AST-Motor ueber 5.604 Zeilen. Sie
+ * entstanden nicht aus einer fachlichen Notwendigkeit, sondern weil eine zu
+ * enge Auftragsgrenze einem Agenten verbot, `package.json` anzufassen
+ * (dokumentiert in `docs/PARITY.md`). Die Grammatik, die es dafuer braucht,
+ * gibt es fertig und MIT-lizenziert: `@ast-grep/lang-python`.
+ *
+ * WAS DIE ABLOESUNG NEBENBEI BEHOBEN HAT — nicht durch eine Korrektur,
+ * sondern weil die Klasse von Fehlern verschwindet:
+ *
+ *   - WP-238: `with a() as x, b() as y:` liess im handgeschriebenen Parser die
+ *     GANZE Datei mit `parseQuality: "failed"` durchfallen. Die Grammatik legt
+ *     dafuer `with_clause > with_item*` an; es gibt nichts zu erkennen.
+ *   - WP-115: verschachtelte Ausdruecke in f-String-Formatangaben
+ *     (`f"{x:{w}.{p}}"`) gingen im Teil-Parse verloren. Hier sind sie
+ *     gewoehnliche `interpolation`/`format_expression`-Knoten im Baum —
+ *     deshalb steht `string` NICHT unter `stringContainerKinds` (siehe dort).
+ *   - WP-226: ein nachgestellter Kommentar vor dem Zeilenende verschluckte im
+ *     Tokenizer das NEWLINE. Ein `comment` ist hier ein Geschwister wie jedes
+ *     andere.
+ *
+ * WAS DIE TABELLE NICHT LEISTET, steht in `profile.ts` daneben: Docstrings,
+ * Sichtbarkeit aus der Namenskonvention, `__all__`, die Unterscheidung
+ * Funktion/Methode/Konstruktor und die Importformen sind Python-Regeln, die
+ * KEINE Tabelle ausdrueckt. Sie stehen als Verfeinerung ueber diesem Profil,
+ * nicht als Sonderfaelle im gemeinsamen Motor.
+ *
+ * DIE KNOTENARTEN SIND NACHGESEHEN, NICHT GERATEN: jede Zeichenkette hier
+ * stammt aus einem echten Baum, den `adapters.test.ts` mit demselben
+ * Quelltext wieder erzeugt.
+ */
+import type { AstGrepLanguageSource } from "../astgrep-backend/index.js";
+import type { LanguageKindTable } from "../shared/table-profile.js";
+/** Woher die Grammatik kommt. MIT-lizenziert, siehe `THIRD_PARTY_LICENSES.md`. */
+export declare const PYTHON_SOURCE: AstGrepLanguageSource;
+/**
+ * Zeichenkettenblaetter. Sie stehen NICHT unter `numberLeafKinds` und
+ * Verwandten, weil `simpleLiteralKind` daraus "number"/"boolean"/"null"
+ * ableitet; `profile.ts` haengt sie an und beantwortet sie mit "string".
+ */
+export declare const PYTHON_STRING_LEAF_KINDS: readonly string[];
+export declare const PYTHON_TABLE: LanguageKindTable;
+//# sourceMappingURL=table.d.ts.map

package/dist/languages/python/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/languages/python/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,kFAAkF;AAClF,eAAO,MAAM,aAAa,EAAE,qBAG3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAA0C,CAAC;AAEjG,eAAO,MAAM,YAAY,EAAE,iBAmF1B,CAAC"}

package/dist/languages/python/table.js

@@ -0,0 +1,88 @@
+import { DEFAULT_PUNCTUATION } from "../shared/table-profile.js";
+/** Woher die Grammatik kommt. MIT-lizenziert, siehe `THIRD_PARTY_LICENSES.md`. */
+export const PYTHON_SOURCE = {
+    languageName: "python",
+    moduleName: "@ast-grep/lang-python",
+};
+/**
+ * Zeichenkettenblaetter. Sie stehen NICHT unter `numberLeafKinds` und
+ * Verwandten, weil `simpleLiteralKind` daraus "number"/"boolean"/"null"
+ * ableitet; `profile.ts` haengt sie an und beantwortet sie mit "string".
+ */
+export const PYTHON_STRING_LEAF_KINDS = ["string_content", "escape_sequence"];
+export const PYTHON_TABLE = {
+    languageId: "python",
+    extensions: [".py", ".pyi"],
+    supportLevel: "deep",
+    commentKinds: ["comment"],
+    /**
+     * ABSICHTLICH LEER. Ein `string` waere in jeder anderen Sprache ein
+     * Container, dessen Teilbaum EIN Operand ist. In Python ist er das nicht:
+     * ein f-String traegt `interpolation`-Knoten mit vollwertigen Ausdruecken,
+     * und ein Aufruf darin ist ein Aufruf. Wer `string` hier eintraegt, macht
+     * WP-115 zum zweiten Mal — nur diesmal ohne Diagnose, weil der Walk gar
+     * nicht erst hineinsieht.
+     */
+    stringContainerKinds: [],
+    identifierLeafKinds: ["identifier"],
+    numberLeafKinds: ["integer", "float"],
+    booleanLeafKinds: ["true", "false"],
+    nullLeafKinds: ["none"],
+    // `string_start`/`string_end` tragen das Praefix und die Anfuehrungszeichen;
+    // sie sind Struktur, kein Operator. Ohne sie stuende `f"` als "Operator" in
+    // jeder Halstead-Rechnung.
+    punctuationKinds: [...DEFAULT_PUNCTUATION, "string_start", "string_end"],
+    scopes: [
+        { kinds: ["function_definition"], scopeKind: "function" },
+        { kinds: ["class_definition"], scopeKind: "class" },
+        // Ein `lambda` ist eine Ausfuehrungseinheit wie eine `def`: spec.md §16.1
+        // zaehlt Lambdas mit, und §16.4 verlangt fuer sie ein eigenes
+        // Nesting-Ereignis im umgebenden Scope. Beides haengt daran, dass es hier
+        // steht.
+        { kinds: ["lambda"], scopeKind: "function" },
+    ],
+    decisions: {
+        // `if_clause` ist BEIDES: der Filter einer Komprehension
+        // (`[x for x in a if p(x)]`) und der Waechter eines `case`. Beide sind
+        // eine echte Verzweigung, beide zaehlen — und beide heissen so.
+        ifKinds: ["if_statement", "if_clause"],
+        elseIfKinds: ["elif_clause"],
+        // `for_in_clause` ist die `for`-Klausel einer Komprehension. Sie ist eine
+        // Schleife, auch wenn sie keine Anweisung ist.
+        loopKinds: ["for_statement", "while_statement", "for_in_clause"],
+        catchKinds: ["except_clause", "except_group_clause"],
+        ternaryKinds: ["conditional_expression"],
+        switchKinds: ["match_statement"],
+        caseKinds: ["case_clause"],
+        // `case _:` zaehlt in Python MIT: anders als ein C-`default` ist `_` ein
+        // gewoehnliches Muster in der Reihenfolge, und ein `match` bricht ohne
+        // Treffer einfach ab. Deshalb steht hier KEIN `caseExcludeChildKinds`.
+        patternAlternativeKinds: ["union_pattern"],
+        binaryKinds: ["boolean_operator"],
+        operatorField: "operator",
+        logicalAndOperators: ["and"],
+        logicalOrOperators: ["or"],
+        jumpKinds: ["return_statement", "raise_statement", "break_statement", "continue_statement"],
+        blockKinds: ["block"],
+        consequenceField: "consequence",
+        // `elif_clause` UND `else_clause` stehen beide im Feld `alternative`.
+        // Genau deshalb ist ein `if` mit `elif` kein Waechter (`guard`), sondern
+        // ein `if` — was `adapters.test.ts` festhaelt.
+        alternativeField: "alternative",
+    },
+    // Die Importe wertet `profile.ts` aus: Python fuehrt in EINER Anweisung
+    // mehrere Ziele mit je eigenem Alias, und das druecken `ImportRules` nicht
+    // aus. Die Arten stehen hier, damit das Vorsieb (`needsNode`) sie kennt.
+    imports: {
+        kinds: ["import_statement", "import_from_statement", "future_import_statement"],
+    },
+    calls: {
+        kinds: ["call"],
+        functionField: "function",
+        argumentsField: "arguments",
+        memberKinds: ["attribute"],
+    },
+    declarationParentKinds: ["function_definition", "class_definition"],
+    bodyField: "body",
+};
+//# sourceMappingURL=table.js.map

package/dist/languages/python/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../../src/languages/python/table.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,kFAAkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,uBAAuB;CACpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,CAAC,SAAS,CAAC;IAEzB;;;;;;;OAOG;IACH,oBAAoB,EAAE,EAAE;IAExB,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,eAAe,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;IACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACnC,aAAa,EAAE,CAAC,MAAM,CAAC;IAEvB,6EAA6E;IAC7E,4EAA4E;IAC5E,2BAA2B;IAC3B,gBAAgB,EAAE,CAAC,GAAG,mBAAmB,EAAE,cAAc,EAAE,YAAY,CAAC;IAExE,MAAM,EAAE;QACN,EAAE,KAAK,EAAE,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE;QACzD,EAAE,KAAK,EAAE,CAAC,kBAAkB,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;QACnD,0EAA0E;QAC1E,8DAA8D;QAC9D,0EAA0E;QAC1E,SAAS;QACT,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE;KAC7C;IAED,SAAS,EAAE;QACT,yDAAyD;QACzD,uEAAuE;QACvE,gEAAgE;QAChE,OAAO,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC;QACtC,WAAW,EAAE,CAAC,aAAa,CAAC;QAC5B,0EAA0E;QAC1E,+CAA+C;QAC/C,SAAS,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,eAAe,CAAC;QAChE,UAAU,EAAE,CAAC,eAAe,EAAE,qBAAqB,CAAC;QACpD,YAAY,EAAE,CAAC,wBAAwB,CAAC;QACxC,WAAW,EAAE,CAAC,iBAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,yEAAyE;QACzE,uEAAuE;QACvE,uEAAuE;QACvE,uBAAuB,EAAE,CAAC,eAAe,CAAC;QAC1C,WAAW,EAAE,CAAC,kBAAkB,CAAC;QACjC,aAAa,EAAE,UAAU;QACzB,mBAAmB,EAAE,CAAC,KAAK,CAAC;QAC5B,kBAAkB,EAAE,CAAC,IAAI,CAAC;QAC1B,SAAS,EAAE,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;QAC3F,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,gBAAgB,EAAE,aAAa;QAC/B,sEAAsE;QACtE,yEAAyE;QACzE,+CAA+C;QAC/C,gBAAgB,EAAE,aAAa;KAChC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,yEAAyE;IACzE,OAAO,EAAE;QACP,KAAK,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,yBAAyB,CAAC;KAChF;IAED,KAAK,EAAE;QACL,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,aAAa,EAAE,UAAU;QACzB,cAAc,EAAE,WAAW;QAC3B,WAAW,EAAE,CAAC,WAAW,CAAC;KAC3B;IAED,sBAAsB,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;IAEnE,SAAS,EAAE,MAAM;CAClB,CAAC"}

package/dist/languages/shared/call-detection.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Call-site detection (architecture.md §6.5, spec.md §15.2). No resolution
+ * happens here — that is symbol-graph's job (task instructions, explicit).
+ *
+ * `require(...)` and dynamic `import(...)` are deliberately EXCLUDED here:
+ * they are modeled purely as `RawImport` entries (`import-detection.ts`) so
+ * the symbol-graph does not see the same source construct as both an import
+ * edge and a call edge.
+ */
+import type { RawCall } from "@untangle-code/domain";
+import type { FileTextContext } from "./node-utils.js";
+import type { SyntaxNode } from "./syntax.js";
+/** Detects a `call_expression` as a `RawCall`, or `null` for require/dynamic-import (see file doc). */
+export declare function detectCallExpression(node: SyntaxNode, callerScopeId: string, ctx: FileTextContext): RawCall | null;
+/** Detects a `new_expression` as a `RawCall` (constructor invocation). */
+export declare function detectNewExpression(node: SyntaxNode, callerScopeId: string, ctx: FileTextContext): RawCall | null;
+//# sourceMappingURL=call-detection.d.ts.map

package/dist/languages/shared/call-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-detection.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/call-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAc9C,uGAAuG;AACvG,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,eAAe,GACnB,OAAO,GAAG,IAAI,CAuChB;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,eAAe,GACnB,OAAO,GAAG,IAAI,CAiChB"}

package/dist/languages/shared/call-detection.js

@@ -0,0 +1,86 @@
+import { rangeOf } from "./node-utils.js";
+function argumentCountOf(node) {
+    const args = node.childForFieldName("arguments");
+    return args !== null ? args.namedChildCount : undefined;
+}
+function isRequireOrDynamicImportCallee(functionNode) {
+    return (functionNode.type === "import" ||
+        (functionNode.type === "identifier" && functionNode.text === "require"));
+}
+/** Detects a `call_expression` as a `RawCall`, or `null` for require/dynamic-import (see file doc). */
+export function detectCallExpression(node, callerScopeId, ctx) {
+    const functionNode = node.childForFieldName("function");
+    if (functionNode === null)
+        return null;
+    if (isRequireOrDynamicImportCallee(functionNode))
+        return null;
+    const range = rangeOf(node, ctx);
+    const argumentCount = argumentCountOf(node);
+    if (functionNode.type === "identifier") {
+        return {
+            calleeName: functionNode.text,
+            callerScopeId,
+            range,
+            ...(argumentCount !== undefined ? { argumentCount } : {}),
+        };
+    }
+    if (functionNode.type === "member_expression") {
+        const property = functionNode.childForFieldName("property");
+        const object = functionNode.childForFieldName("object");
+        if (property === null)
+            return null;
+        return {
+            calleeName: property.text,
+            ...(object !== null ? { qualifier: object.text } : {}),
+            callerScopeId,
+            range,
+            ...(argumentCount !== undefined ? { argumentCount } : {}),
+        };
+    }
+    // Any other callee shape (IIFE, call result invoked again, computed
+    // member, etc.): fall back to the raw written expression text as the
+    // callee name so the call site is not silently dropped.
+    return {
+        calleeName: functionNode.text,
+        callerScopeId,
+        range,
+        ...(argumentCount !== undefined ? { argumentCount } : {}),
+    };
+}
+/** Detects a `new_expression` as a `RawCall` (constructor invocation). */
+export function detectNewExpression(node, callerScopeId, ctx) {
+    const constructorNode = node.childForFieldName("constructor");
+    if (constructorNode === null)
+        return null;
+    const range = rangeOf(node, ctx);
+    const args = node.childForFieldName("arguments");
+    const argumentCount = args !== null ? args.namedChildCount : undefined;
+    if (constructorNode.type === "identifier") {
+        return {
+            calleeName: constructorNode.text,
+            callerScopeId,
+            range,
+            ...(argumentCount !== undefined ? { argumentCount } : {}),
+        };
+    }
+    if (constructorNode.type === "member_expression") {
+        const property = constructorNode.childForFieldName("property");
+        const object = constructorNode.childForFieldName("object");
+        if (property === null)
+            return null;
+        return {
+            calleeName: property.text,
+            ...(object !== null ? { qualifier: object.text } : {}),
+            callerScopeId,
+            range,
+            ...(argumentCount !== undefined ? { argumentCount } : {}),
+        };
+    }
+    return {
+        calleeName: constructorNode.text,
+        callerScopeId,
+        range,
+        ...(argumentCount !== undefined ? { argumentCount } : {}),
+    };
+}
+//# sourceMappingURL=call-detection.js.map

package/dist/languages/shared/call-detection.js.map

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

package/dist/languages/shared/chunks.d.ts

@@ -0,0 +1,28 @@
+/**
+ * AstRegion tree construction from the `ScopeNode` tree (spec.md §8.2-§8.3).
+ *
+ * One `AstRegion` of kind `"module"` is returned, spanning the whole file,
+ * with a nested `children` tree the chunker descends into for large symbols
+ * (spec.md §8.3 step 6) — see domain `analysis.ts` `AstRegion.children` doc.
+ *
+ * `ChunkKind` (domain `types/common.ts`, spec.md §8.2) has no `"namespace"`
+ * member; a TS `namespace`/`module` scope maps to `"module"` (documented
+ * WP-06 decision, README "Entscheidungen") since it is itself a nested
+ * module-like grouping of symbols.
+ */
+import type { AstRegion } from "@untangle-code/domain";
+import type { FileTextContext } from "./node-utils.js";
+import type { LanguageProfile } from "./profile.js";
+import type { ScopeNode } from "./scope-model.js";
+/**
+ * Exported (in addition to being called from {@link buildChildRegions})
+ * so `chunks.test.ts` can exercise the WP-73 empty-list guard directly:
+ * `buildChildRegions`'s own `flushProperties` never calls this with an
+ * empty `properties` array, so that path cannot be reached end-to-end
+ * through `buildFileRegion` alone.
+ */
+export declare function propertyGroupRegion(properties: ScopeNode[], parentScopeId: string, ordinal: number, ctx: FileTextContext, profile: LanguageProfile): AstRegion;
+/** Leading file content (shebang/header comments/imports) before the first top-level region, if non-trivial. */
+/** Builds the single root ("module") `AstRegion` for a whole file. */
+export declare function buildFileRegion(fileScope: ScopeNode, ctx: FileTextContext, profile: LanguageProfile): AstRegion;
+//# sourceMappingURL=chunks.d.ts.map

package/dist/languages/shared/chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/chunks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAA0B,MAAM,uBAAuB,CAAC;AAG/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA2FlD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,EAAE,EACvB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,eAAe,GACvB,SAAS,CAgCX;AAkCD,gHAAgH;AAChH,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,eAAe,GACvB,SAAS,CAsBX"}