cotx-engine 0.1.0

package/dist/core/parser/field-extractors/configs/python.js

@@ -0,0 +1,92 @@
+/**
+ * Field extraction configuration for Python.
+ *
+ * Python class-level fields appear as expression_statement nodes wrapping
+ * either annotated assignments (`name: str = ""`) or plain assignments
+ * (`x = 5`). Instance variables set on `self` in `__init__` are not
+ * captured here -- only body-level declarations are in scope.
+ *
+ * Visibility uses Python convention:
+ *   - `__name` (dunder without trailing __) -> private
+ *   - `_name` -> protected
+ *   - anything else -> public
+ */
+import { SupportedLanguages } from '../../../shared/index.js';
+import { extractSimpleTypeName } from '../../type-extractors/shared.js';
+export const pythonConfig = {
+    language: SupportedLanguages.Python,
+    typeDeclarationNodes: ['class_definition'],
+    fieldNodeTypes: ['expression_statement'],
+    bodyNodeTypes: ['block'],
+    defaultVisibility: 'public',
+    extractName(stmt) {
+        const inner = stmt.firstNamedChild;
+        if (!inner)
+            return undefined;
+        // Annotated assignment: expression_statement > type > identifier
+        if (inner.type === 'type') {
+            const ident = inner.childForFieldName('name') ?? inner.firstNamedChild;
+            return ident?.type === 'identifier' ? ident.text : undefined;
+        }
+        // Plain assignment: expression_statement > assignment > left:identifier
+        if (inner.type === 'assignment') {
+            const lhs = inner.childForFieldName('left');
+            if (lhs?.type === 'identifier')
+                return lhs.text;
+        }
+        return undefined;
+    },
+    extractType(stmt) {
+        const inner = stmt.firstNamedChild;
+        if (!inner)
+            return undefined;
+        // Annotated assignment with type node
+        if (inner.type === 'type') {
+            const typeChild = inner.childForFieldName('type') ?? inner.namedChild(1);
+            if (typeChild)
+                return extractSimpleTypeName(typeChild) ?? typeChild.text?.trim();
+        }
+        // Assignment that may contain a type child (annotation without value)
+        if (inner.type === 'assignment') {
+            for (let idx = 0; idx < inner.childCount; idx++) {
+                const kid = inner.child(idx);
+                if (kid?.type === 'type') {
+                    const typeId = kid.firstNamedChild;
+                    if (typeId)
+                        return extractSimpleTypeName(typeId) ?? typeId.text?.trim();
+                }
+            }
+        }
+        return undefined;
+    },
+    extractVisibility(stmt) {
+        const inner = stmt.firstNamedChild;
+        let fieldName;
+        if (inner?.type === 'type') {
+            const ident = inner.childForFieldName('name') ?? inner.firstNamedChild;
+            fieldName = ident?.text;
+        }
+        else if (inner?.type === 'assignment') {
+            const lhs = inner.childForFieldName('left');
+            fieldName = lhs?.text;
+        }
+        if (!fieldName)
+            return 'public';
+        // Double underscore without trailing dunder => name-mangled (private)
+        if (fieldName.startsWith('__') && !fieldName.endsWith('__'))
+            return 'private';
+        // Single underscore prefix => protected by convention
+        if (fieldName.startsWith('_'))
+            return 'protected';
+        return 'public';
+    },
+    isStatic() {
+        // Python has no explicit static keyword for class variables.
+        // (Class-body assignments are class variables, but the AST has no modifier.)
+        return false;
+    },
+    isReadonly() {
+        return false;
+    },
+};
+//# sourceMappingURL=python.js.map

package/dist/core/parser/field-extractors/configs/python.js.map

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

package/dist/core/parser/field-extractors/configs/ruby.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Field extraction configuration for Ruby.
+ *
+ * Ruby does not have traditional field declarations. Accessible attributes
+ * are declared via `attr_accessor`, `attr_reader`, and `attr_writer` calls
+ * in the class body. Each call can list multiple symbol arguments, e.g.:
+ *
+ *   attr_accessor :foo, :bar, :baz
+ *
+ * We match `call` nodes inside `body_statement` and inspect the method name.
+ * Instance variable assignments (`@var = ...`) would need deeper analysis
+ * and are not extracted here.
+ */
+import type { FieldExtractionConfig } from '../generic.js';
+export declare const rubyConfig: FieldExtractionConfig;

package/dist/core/parser/field-extractors/configs/ruby.js

@@ -0,0 +1,68 @@
+/**
+ * Field extraction configuration for Ruby.
+ *
+ * Ruby does not have traditional field declarations. Accessible attributes
+ * are declared via `attr_accessor`, `attr_reader`, and `attr_writer` calls
+ * in the class body. Each call can list multiple symbol arguments, e.g.:
+ *
+ *   attr_accessor :foo, :bar, :baz
+ *
+ * We match `call` nodes inside `body_statement` and inspect the method name.
+ * Instance variable assignments (`@var = ...`) would need deeper analysis
+ * and are not extracted here.
+ */
+import { SupportedLanguages } from '../../../shared/index.js';
+const ATTR_METHODS = new Set(['attr_accessor', 'attr_reader', 'attr_writer']);
+/**
+ * Given an attr_* call node, collect every symbol argument into a list of
+ * field names (stripping the leading `:` from each symbol).
+ */
+function gatherSymbolNames(callNode) {
+    const methodChild = callNode.childForFieldName('method');
+    if (!methodChild || !ATTR_METHODS.has(methodChild.text))
+        return [];
+    const argsChild = callNode.childForFieldName('arguments');
+    if (!argsChild)
+        return [];
+    const result = [];
+    for (let idx = 0; idx < argsChild.namedChildCount; idx++) {
+        const arg = argsChild.namedChild(idx);
+        if (!arg)
+            continue;
+        const raw = arg.text;
+        result.push(raw.startsWith(':') ? raw.slice(1) : raw);
+    }
+    return result;
+}
+export const rubyConfig = {
+    language: SupportedLanguages.Ruby,
+    typeDeclarationNodes: ['class'],
+    fieldNodeTypes: ['call'],
+    bodyNodeTypes: ['body_statement'],
+    defaultVisibility: 'public',
+    extractName(callNode) {
+        // Return first symbol name for the single-name interface contract.
+        // Multi-name extraction is handled by extractNames below.
+        const names = gatherSymbolNames(callNode);
+        return names.length > 0 ? names[0] : undefined;
+    },
+    extractNames(callNode) {
+        return gatherSymbolNames(callNode);
+    },
+    extractType() {
+        // Standard Ruby has no type annotations
+        return undefined;
+    },
+    extractVisibility() {
+        // attr_* declarations are public by default
+        return 'public';
+    },
+    isStatic() {
+        return false;
+    },
+    isReadonly(callNode) {
+        const methodChild = callNode.childForFieldName('method');
+        return methodChild?.text === 'attr_reader';
+    },
+};
+//# sourceMappingURL=ruby.js.map

package/dist/core/parser/field-extractors/configs/ruby.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby.js","sourceRoot":"","sources":["../../../../../src/core/parser/field-extractors/configs/ruby.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;AAE9E;;;GAGG;AACH,SAAS,iBAAiB,CAAC,QAAoB;IAC7C,MAAM,WAAW,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnE,MAAM,SAAS,GAAG,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAA0B;IAC/C,QAAQ,EAAE,kBAAkB,CAAC,IAAI;IAEjC,oBAAoB,EAAE,CAAC,OAAO,CAAC;IAC/B,cAAc,EAAE,CAAC,MAAM,CAAC;IACxB,aAAa,EAAE,CAAC,gBAAgB,CAAC;IACjC,iBAAiB,EAAE,QAAQ;IAE3B,WAAW,CAAC,QAAQ;QAClB,mEAAmE;QACnE,0DAA0D;QAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,QAAQ;QACnB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,WAAW;QACT,wCAAwC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iBAAiB;QACf,4CAA4C;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ;QACN,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU,CAAC,QAAQ;QACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,WAAW,EAAE,IAAI,KAAK,aAAa,CAAC;IAC7C,CAAC;CACF,CAAC"}

package/dist/core/parser/field-extractors/configs/rust.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Field extraction configuration for Rust.
+ *
+ * Rust structs declare fields via `field_declaration` nodes inside a
+ * `field_declaration_list`. Visibility is determined by the presence of a
+ * `visibility_modifier` child (covers `pub`, `pub(crate)`, `pub(super)`).
+ *
+ * Rust fields are always immutable at the type level -- mutability is
+ * controlled by the variable binding, not the struct definition.
+ */
+import type { FieldExtractionConfig } from '../generic.js';
+export declare const rustConfig: FieldExtractionConfig;

package/dist/core/parser/field-extractors/configs/rust.js

@@ -0,0 +1,58 @@
+/**
+ * Field extraction configuration for Rust.
+ *
+ * Rust structs declare fields via `field_declaration` nodes inside a
+ * `field_declaration_list`. Visibility is determined by the presence of a
+ * `visibility_modifier` child (covers `pub`, `pub(crate)`, `pub(super)`).
+ *
+ * Rust fields are always immutable at the type level -- mutability is
+ * controlled by the variable binding, not the struct definition.
+ */
+import { SupportedLanguages } from '../../../shared/index.js';
+import { extractSimpleTypeName } from '../../type-extractors/shared.js';
+import { hasKeyword } from './helpers.js';
+export const rustConfig = {
+    language: SupportedLanguages.Rust,
+    typeDeclarationNodes: ['struct_item', 'enum_item'],
+    fieldNodeTypes: ['field_declaration'],
+    bodyNodeTypes: ['field_declaration_list'],
+    defaultVisibility: 'private',
+    extractName(decl) {
+        // Prefer the named 'name' field on the AST node
+        const nameChild = decl.childForFieldName('name');
+        if (nameChild)
+            return nameChild.text;
+        // Fallback: scan for a field_identifier among named children
+        for (let idx = 0; idx < decl.namedChildCount; idx++) {
+            const kid = decl.namedChild(idx);
+            if (kid?.type === 'field_identifier')
+                return kid.text;
+        }
+        return undefined;
+    },
+    extractType(decl) {
+        const typeChild = decl.childForFieldName('type');
+        if (!typeChild)
+            return undefined;
+        return extractSimpleTypeName(typeChild) ?? typeChild.text?.trim();
+    },
+    extractVisibility(decl) {
+        // Look for a visibility_modifier named child (pub, pub(crate), etc.)
+        for (let idx = 0; idx < decl.namedChildCount; idx++) {
+            const kid = decl.namedChild(idx);
+            if (kid?.type === 'visibility_modifier')
+                return 'public';
+        }
+        // Also check for bare `pub` keyword token
+        return hasKeyword(decl, 'pub') ? 'public' : 'private';
+    },
+    isStatic() {
+        // Rust struct fields cannot be static
+        return false;
+    },
+    isReadonly() {
+        // All struct fields are immutable by default (mutability lives on bindings)
+        return true;
+    },
+};
+//# sourceMappingURL=rust.js.map

package/dist/core/parser/field-extractors/configs/rust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.js","sourceRoot":"","sources":["../../../../../src/core/parser/field-extractors/configs/rust.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,UAAU,GAA0B;IAC/C,QAAQ,EAAE,kBAAkB,CAAC,IAAI;IAEjC,oBAAoB,EAAE,CAAC,aAAa,EAAE,WAAW,CAAC;IAClD,cAAc,EAAE,CAAC,mBAAmB,CAAC;IACrC,aAAa,EAAE,CAAC,wBAAwB,CAAC;IACzC,iBAAiB,EAAE,SAAS;IAE5B,WAAW,CAAC,IAAI;QACd,gDAAgD;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC;QAErC,6DAA6D;QAC7D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,GAAG,EAAE,IAAI,KAAK,kBAAkB;gBAAE,OAAO,GAAG,CAAC,IAAI,CAAC;QACxD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,WAAW,CAAC,IAAI;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,OAAO,qBAAqB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IAED,iBAAiB,CAAC,IAAI;QACpB,qEAAqE;QACrE,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,GAAG,EAAE,IAAI,KAAK,qBAAqB;gBAAE,OAAO,QAAQ,CAAC;QAC3D,CAAC;QACD,0CAA0C;QAC1C,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAED,QAAQ;QACN,sCAAsC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,4EAA4E;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/core/parser/field-extractors/configs/swift.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Field extraction configuration for Swift.
+ *
+ * Swift stored and computed properties are represented as
+ * `property_declaration` nodes inside `class_body` or `protocol_body`.
+ *
+ * The name sits inside a `pattern` child (pattern > simple_identifier).
+ * Type annotations appear as `type_annotation` children.
+ *
+ * Visibility modifiers: public, private, fileprivate, internal (default), open.
+ * Static properties use the `static` or `class` keyword.
+ * `let` declarations are readonly; `var` declarations are mutable.
+ */
+import type { FieldExtractionConfig } from '../generic.js';
+export declare const swiftConfig: FieldExtractionConfig;

package/dist/core/parser/field-extractors/configs/swift.js

@@ -0,0 +1,75 @@
+/**
+ * Field extraction configuration for Swift.
+ *
+ * Swift stored and computed properties are represented as
+ * `property_declaration` nodes inside `class_body` or `protocol_body`.
+ *
+ * The name sits inside a `pattern` child (pattern > simple_identifier).
+ * Type annotations appear as `type_annotation` children.
+ *
+ * Visibility modifiers: public, private, fileprivate, internal (default), open.
+ * Static properties use the `static` or `class` keyword.
+ * `let` declarations are readonly; `var` declarations are mutable.
+ */
+import { SupportedLanguages } from '../../../shared/index.js';
+import { hasKeyword, findVisibility } from './helpers.js';
+import { extractSimpleTypeName } from '../../type-extractors/shared.js';
+const SWIFT_VISIBILITY_SET = new Set([
+    'public',
+    'private',
+    'fileprivate',
+    'internal',
+    'open',
+]);
+export const swiftConfig = {
+    language: SupportedLanguages.Swift,
+    typeDeclarationNodes: ['class_declaration', 'struct_declaration', 'protocol_declaration'],
+    fieldNodeTypes: ['property_declaration'],
+    bodyNodeTypes: ['class_body', 'protocol_body'],
+    defaultVisibility: 'internal',
+    extractName(propDecl) {
+        // property_declaration > pattern > simple_identifier
+        for (let idx = 0; idx < propDecl.namedChildCount; idx++) {
+            const kid = propDecl.namedChild(idx);
+            if (kid?.type === 'pattern') {
+                // Look for simple_identifier inside the pattern
+                for (let j = 0; j < kid.namedChildCount; j++) {
+                    const inner = kid.namedChild(j);
+                    if (inner?.type === 'simple_identifier')
+                        return inner.text;
+                }
+                // Pattern itself may be the identifier text
+                return kid.text;
+            }
+            // Direct simple_identifier child
+            if (kid?.type === 'simple_identifier')
+                return kid.text;
+        }
+        // Fallback: try the named 'name' field
+        const nameChild = propDecl.childForFieldName('name');
+        return nameChild?.text;
+    },
+    extractType(propDecl) {
+        // property_declaration > type_annotation > user_type / type_identifier
+        for (let idx = 0; idx < propDecl.namedChildCount; idx++) {
+            const kid = propDecl.namedChild(idx);
+            if (kid?.type === 'type_annotation') {
+                const inner = kid.firstNamedChild;
+                if (inner)
+                    return extractSimpleTypeName(inner) ?? inner.text?.trim();
+            }
+        }
+        return undefined;
+    },
+    extractVisibility(propDecl) {
+        return findVisibility(propDecl, SWIFT_VISIBILITY_SET, 'internal', 'modifiers');
+    },
+    isStatic(propDecl) {
+        return hasKeyword(propDecl, 'static') || hasKeyword(propDecl, 'class');
+    },
+    isReadonly(propDecl) {
+        // `let` = constant (readonly), `var` = variable (mutable)
+        return hasKeyword(propDecl, 'let');
+    },
+};
+//# sourceMappingURL=swift.js.map

package/dist/core/parser/field-extractors/configs/swift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift.js","sourceRoot":"","sources":["../../../../../src/core/parser/field-extractors/configs/swift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAkB;IACpD,QAAQ;IACR,SAAS;IACT,aAAa;IACb,UAAU;IACV,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,QAAQ,EAAE,kBAAkB,CAAC,KAAK;IAElC,oBAAoB,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,sBAAsB,CAAC;IACzF,cAAc,EAAE,CAAC,sBAAsB,CAAC;IACxC,aAAa,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;IAC9C,iBAAiB,EAAE,UAAU;IAE7B,WAAW,CAAC,QAAQ;QAClB,qDAAqD;QACrD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC5B,gDAAgD;gBAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;oBAChC,IAAI,KAAK,EAAE,IAAI,KAAK,mBAAmB;wBAAE,OAAO,KAAK,CAAC,IAAI,CAAC;gBAC7D,CAAC;gBACD,4CAA4C;gBAC5C,OAAO,GAAG,CAAC,IAAI,CAAC;YAClB,CAAC;YACD,iCAAiC;YACjC,IAAI,GAAG,EAAE,IAAI,KAAK,mBAAmB;gBAAE,OAAO,GAAG,CAAC,IAAI,CAAC;QACzD,CAAC;QACD,uCAAuC;QACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrD,OAAO,SAAS,EAAE,IAAI,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,QAAQ;QAClB,uEAAuE;QACvE,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,GAAG,EAAE,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACpC,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,CAAC;gBAClC,IAAI,KAAK;oBAAE,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,QAAQ;QACxB,OAAO,cAAc,CAAC,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACjF,CAAC;IAED,QAAQ,CAAC,QAAQ;QACf,OAAO,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,UAAU,CAAC,QAAQ;QACjB,0DAA0D;QAC1D,OAAO,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;CACF,CAAC"}

package/dist/core/parser/field-extractors/configs/typescript-javascript.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Field extraction configurations for TypeScript and JavaScript.
+ *
+ * Both languages share identical extraction logic; only the language
+ * enum value differs. Fields live in `class_body`, `interface_body`,
+ * or `object_type` as `public_field_definition`, `property_signature`,
+ * or `field_definition` nodes.
+ *
+ * Visibility is determined by `accessibility_modifier` children
+ * (TypeScript only) or direct keyword tokens.
+ */
+import type { FieldExtractionConfig } from '../generic.js';
+export declare const typescriptConfig: FieldExtractionConfig;
+export declare const javascriptConfig: FieldExtractionConfig;

package/dist/core/parser/field-extractors/configs/typescript-javascript.js

@@ -0,0 +1,72 @@
+/**
+ * Field extraction configurations for TypeScript and JavaScript.
+ *
+ * Both languages share identical extraction logic; only the language
+ * enum value differs. Fields live in `class_body`, `interface_body`,
+ * or `object_type` as `public_field_definition`, `property_signature`,
+ * or `field_definition` nodes.
+ *
+ * Visibility is determined by `accessibility_modifier` children
+ * (TypeScript only) or direct keyword tokens.
+ */
+import { SupportedLanguages } from '../../../shared/index.js';
+import { hasKeyword, findVisibility, typeFromAnnotation } from './helpers.js';
+const TS_JS_VISIBILITY_SET = new Set(['public', 'private', 'protected']);
+/**
+ * Shared config body for both TypeScript and JavaScript.
+ * The `language` property is applied by the two named exports below.
+ */
+const commonConfig = {
+    typeDeclarationNodes: [
+        'class_declaration',
+        'abstract_class_declaration',
+        'interface_declaration',
+    ],
+    fieldNodeTypes: ['public_field_definition', 'property_signature', 'field_definition'],
+    bodyNodeTypes: ['class_body', 'interface_body', 'object_type'],
+    defaultVisibility: 'public',
+    extractName(fieldNode) {
+        const nameChild = fieldNode.childForFieldName('name') ?? fieldNode.childForFieldName('property');
+        return nameChild?.text;
+    },
+    extractType(fieldNode) {
+        // tree-sitter-typescript may expose the type via a named 'type' field
+        const typeChild = fieldNode.childForFieldName('type');
+        if (typeChild) {
+            if (typeChild.type === 'type_annotation') {
+                const inner = typeChild.firstNamedChild;
+                return inner?.text?.trim();
+            }
+            return typeChild.text?.trim();
+        }
+        // Fallback: walk children for a type_annotation node
+        return typeFromAnnotation(fieldNode);
+    },
+    extractVisibility(fieldNode) {
+        // Check for accessibility_modifier (TypeScript-specific)
+        for (let idx = 0; idx < fieldNode.namedChildCount; idx++) {
+            const kid = fieldNode.namedChild(idx);
+            if (kid && kid.type === 'accessibility_modifier') {
+                const vis = kid.text.trim();
+                if (TS_JS_VISIBILITY_SET.has(vis))
+                    return vis;
+            }
+        }
+        return findVisibility(fieldNode, TS_JS_VISIBILITY_SET, 'public', 'modifiers');
+    },
+    isStatic(fieldNode) {
+        return hasKeyword(fieldNode, 'static');
+    },
+    isReadonly(fieldNode) {
+        return hasKeyword(fieldNode, 'readonly');
+    },
+};
+export const typescriptConfig = {
+    ...commonConfig,
+    language: SupportedLanguages.TypeScript,
+};
+export const javascriptConfig = {
+    ...commonConfig,
+    language: SupportedLanguages.JavaScript,
+};
+//# sourceMappingURL=typescript-javascript.js.map

package/dist/core/parser/field-extractors/configs/typescript-javascript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-javascript.js","sourceRoot":"","sources":["../../../../../src/core/parser/field-extractors/configs/typescript-javascript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAG9E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,YAAY,GAA4C;IAC5D,oBAAoB,EAAE;QACpB,mBAAmB;QACnB,4BAA4B;QAC5B,uBAAuB;KACxB;IACD,cAAc,EAAE,CAAC,yBAAyB,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;IACrF,aAAa,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAC9D,iBAAiB,EAAE,QAAQ;IAE3B,WAAW,CAAC,SAAS;QACnB,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACjG,OAAO,SAAS,EAAE,IAAI,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,SAAS;QACnB,sEAAsE;QACtE,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,SAAS,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC;gBACxC,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC7B,CAAC;YACD,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;QACD,qDAAqD;QACrD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,iBAAiB,CAAC,SAAS;QACzB,yDAAyD;QACzD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;gBACjD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,EAAqB,CAAC;gBAC/C,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,GAAG,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,cAAc,CAAC,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChF,CAAC;IAED,QAAQ,CAAC,SAAS;QAChB,OAAO,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,SAAS;QAClB,OAAO,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,GAAG,YAAY;IACf,QAAQ,EAAE,kBAAkB,CAAC,UAAU;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,GAAG,YAAY;IACf,QAAQ,EAAE,kBAAkB,CAAC,UAAU;CACxC,CAAC"}

package/dist/core/parser/field-extractors/generic.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Generic table-driven field extractor factory.
+ *
+ * Instead of 14 separate 300-line files, define a config per language and
+ * generate extractors from configs. The factory produces a plain object
+ * implementing FieldExtractor — no class hierarchy needed.
+ */
+import type { SyntaxNode } from '../utils/ast-helpers.js';
+import { SupportedLanguages } from '../../shared/index.js';
+import type { FieldExtractor } from '../field-extractor.js';
+import type { FieldExtractorContext, FieldInfo, FieldVisibility } from '../field-types.js';
+export interface FieldExtractionConfig {
+    language: SupportedLanguages;
+    /** AST node types that are class/struct/interface declarations */
+    typeDeclarationNodes: string[];
+    /** AST node types that represent field/property declarations inside a body */
+    fieldNodeTypes: string[];
+    /** AST node type(s) for the class body container (e.g., 'class_body', 'declaration_list') */
+    bodyNodeTypes: string[];
+    /** Default visibility when no modifier is present */
+    defaultVisibility: FieldVisibility;
+    /**
+     * Extract field name from a field declaration node.
+     * Use this for nodes that declare exactly one field.
+     */
+    extractName: (node: SyntaxNode) => string | undefined;
+    /**
+     * Extract multiple field names from a single declaration node.
+     * Optional override for languages where one AST node can declare
+     * several fields (e.g. Ruby `attr_accessor :foo, :bar`).
+     * When present, the factory uses this instead of `extractName`.
+     */
+    extractNames?: (node: SyntaxNode) => string[];
+    /** Extract type annotation from a field declaration node */
+    extractType: (node: SyntaxNode) => string | undefined;
+    /** Extract visibility from a field declaration node */
+    extractVisibility: (node: SyntaxNode) => FieldVisibility;
+    /** Check if a field is static */
+    isStatic: (node: SyntaxNode) => boolean;
+    /** Check if a field is readonly/final/const */
+    isReadonly: (node: SyntaxNode) => boolean;
+    /** Extract fields from primary constructor parameters on the owner node itself
+     *  (e.g. C# record positional parameters, C# 12 class primary constructors). */
+    extractPrimaryFields?: (ownerNode: SyntaxNode, context: FieldExtractorContext) => FieldInfo[];
+    /**
+     * Extract fields from the value of a type declaration (e.g. TypeScript
+     * `type Config = { host: string; }` — object type literals).
+     * Called on the owner (type declaration) node when present.
+     */
+    extractFromValue?: (ownerNode: SyntaxNode, context: FieldExtractorContext) => FieldInfo[];
+    /**
+     * AST node types to scan for when discovering nested types inside a
+     * type declaration body. E.g. `['class_declaration', 'interface_declaration']`.
+     * When omitted, nestedTypes is always empty.
+     */
+    nestedTypeNodeTypes?: string[];
+}
+/**
+ * Create a FieldExtractor from a declarative config.
+ */
+export declare function createFieldExtractor(config: FieldExtractionConfig): FieldExtractor;