codebeacon 0.1.2__py3-none-any.whl

codebeacon/extract/queries/laravel.scm

@@ -0,0 +1,172 @@
+; ── Laravel (PHP) ─────────────────────────────────────────────────────────────
+; Grammar: tree-sitter-php
+;
+; PHP grammar note:
+;   - scoped_call_expression: Route::get(...)  (static method call)
+;   - member_call_expression: Route::prefix("api")->group(...)
+;   - class_constant_access_expression: UserController::class
+;   - encapsed_string: PHP double-quoted string
+;   - name nodes: identifiers in PHP
+;
+; Special handling in extract/routes.py:
+;   - Route::resource("users", ...) → 7 CRUD routes expanded
+;   - Route::prefix("api")->group(fn) → prefix propagation
+;
+; Captures:
+;   @route.method         - get/post/put/patch/delete/any
+;   @route.path           - path string content
+;   @route.controller     - ControllerClass::class → class name
+;   @route.resource_name  - Route::resource("users") → "users"
+;   @route.prefix         - Route::prefix("api") value
+;   @entity.class_name    - Eloquent Model subclass
+;   @entity.relation_type - hasMany/belongsTo/hasOne etc.
+;   @entity.relation_model - target model class
+;   @service.class_name   - service/provider class
+;   @di.interface         - $this->app->bind(Interface::class, ...)
+;   @di.implementation    - bind target class
+;   @import.path          - use Namespace\Class
+
+; ── Route::get("/path", [Controller::class, "method"]) ───────────────────────
+
+(expression_statement
+  (scoped_call_expression
+    name: (name) @_class (#eq? @_class "Route")
+    (name) @route.method
+    (#match? @route.method "^(get|post|put|patch|delete|options|any|match)$")
+    (arguments
+      (argument
+        [
+          (encapsed_string (string_content) @route.path)
+          (string (string_content) @route.path)
+        ]
+      )
+      (argument
+        [
+          (array_creation_expression
+            (array_element_initializer
+              (class_constant_access_expression
+                (name) @route.controller
+                (name) @_class_kw (#eq? @_class_kw "class")
+              )
+            )
+          )
+          (string (string_content) @route.closure_action)
+        ]
+      )?
+    )
+  )
+) @route.call
+
+; ── Route::resource("users", UserController::class) ──────────────────────────
+
+(expression_statement
+  (scoped_call_expression
+    name: (name) @_class (#eq? @_class "Route")
+    (name) @_res (#match? @_res "^(resource|apiResource|resources|apiResources)$")
+    (arguments
+      (argument
+        [
+          (encapsed_string (string_content) @route.resource_name)
+          (string (string_content) @route.resource_name)
+        ]
+      )
+      (argument
+        (class_constant_access_expression
+          (name) @route.resource_controller
+          (name) @_ck (#eq? @_ck "class")
+        )
+      )
+    )
+  )
+) @route.resource
+
+; ── Route::prefix("api")->group(...) ─────────────────────────────────────────
+
+(expression_statement
+  (member_call_expression
+    object: (scoped_call_expression
+      name: (name) @_class (#eq? @_class "Route")
+      (name) @_prefix (#eq? @_prefix "prefix")
+      (arguments
+        (argument
+          [
+            (encapsed_string (string_content) @route.prefix)
+            (string (string_content) @route.prefix)
+          ]
+        )
+      )
+    )
+    name: (name) @_group (#eq? @_group "group")
+  )
+) @route.prefix_group
+
+; ── Route::middleware(...)->prefix(...)->group(...) chains ────────────────────
+; Covered by member_call_expression nesting — prefix propagation in routes.py
+
+; ── Eloquent Model subclass ───────────────────────────────────────────────────
+
+(class_declaration
+  name: (name) @entity.class_name
+  (base_clause
+    (qualified_name (name) @_base (#match? @_base "^(Model|Authenticatable)$"))
+  )
+) @entity.model
+
+; Eloquent relations
+(method_declaration
+  name: (name) @entity.relation_type
+  (#match? @entity.relation_type "^(hasMany|hasOne|belongsTo|belongsToMany|hasManyThrough|hasOneThrough|morphTo|morphMany|morphOne)$")
+  (compound_statement
+    (return_statement
+      (member_call_expression
+        name: (name) @_rel_fn
+        (arguments
+          (argument
+            (class_constant_access_expression
+              (name) @entity.relation_model
+              (name) @_ck (#eq? @_ck "class")
+            )
+          )
+        )
+      )
+    )
+  )
+) @entity.relation
+
+; ── Service provider bindings ─────────────────────────────────────────────────
+
+(member_call_expression
+  object: (member_access_expression
+    object: (variable_name (name) @_this (#eq? @_this "this"))
+    name: (name) @_app (#eq? @_app "app")
+  )
+  name: (name) @_bind (#match? @_bind "^(bind|singleton|scoped|transient)$")
+  (arguments
+    (argument
+      (class_constant_access_expression
+        (name) @di.interface
+        (name) @_ck (#eq? @_ck "class")
+      )
+    )
+    (argument
+      (class_constant_access_expression
+        (name) @di.implementation
+        (name) @_ck2 (#eq? @_ck2 "class")
+      )
+    )
+  )
+) @di.binding
+
+; ── Plain service class ───────────────────────────────────────────────────────
+
+(class_declaration
+  name: (name) @service.class_name
+) @service.class
+
+; ── use statements ────────────────────────────────────────────────────────────
+
+(namespace_use_declaration
+  (namespace_use_clause
+    (qualified_name) @import.path
+  )
+) @import.use

codebeacon/extract/queries/nestjs.scm

@@ -0,0 +1,183 @@
+; ── NestJS (TypeScript) ───────────────────────────────────────────────────────
+; Grammar: tree-sitter-typescript
+;
+; TypeScript AST note:
+;   In tree-sitter-typescript, class-level decorators (@Controller, @Injectable,
+;   @Entity) are siblings of class_declaration inside export_statement, not
+;   children of class_declaration.
+;   Method-level decorators (@Get, @Post) are siblings of method_definition
+;   inside class_body, connected via the `.` (immediate sibling) anchor.
+;
+; Captures:
+;   @route.controller_prefix - @Controller("prefix") value
+;   @route.class_name        - controller class name
+;   @route.method_decorator  - @Get/@Post/@Put/@Delete/@Patch
+;   @route.method_name       - handler method name
+;   @route.path_value        - path string literal
+;   @service.class_name      - @Injectable() class name
+;   @service.inject_type     - constructor injected type
+;   @module.providers        - providers array items
+;   @entity.class_name       - @Entity() class name
+;   @import.path             - import source
+
+; ── @Controller("prefix") class ──────────────────────────────────────────────
+
+; export_statement wraps the decorator + class_declaration
+(export_statement
+  (decorator
+    (call_expression
+      function: (identifier) @_ctrl
+      (#eq? @_ctrl "Controller")
+      arguments: (arguments
+        (string) @route.controller_prefix
+      )
+    )
+  )
+  declaration: (class_declaration
+    name: (type_identifier) @route.class_name
+  )
+) @route.controller_with_prefix
+
+; @Controller() without prefix
+(export_statement
+  (decorator
+    (call_expression
+      function: (identifier) @_ctrl2
+      (#eq? @_ctrl2 "Controller")
+      arguments: (arguments)
+    )
+  )
+  declaration: (class_declaration
+    name: (type_identifier) @route.class_name
+  )
+) @route.controller_no_prefix
+
+; Non-exported @Controller
+(class_declaration
+  (decorator
+    (call_expression
+      function: (identifier) @_ctrl3
+      (#eq? @_ctrl3 "Controller")
+      arguments: (arguments
+        (string) @route.controller_prefix
+      )
+    )
+  )
+  name: (type_identifier) @route.class_name
+) @route.controller_with_prefix_noexport
+
+; ── HTTP method decorators on methods (sibling pattern) ─────────────────────
+
+; Decorator + method_definition as adjacent siblings in class_body
+(class_body
+  (decorator
+    (call_expression
+      function: (identifier) @route.method_decorator
+      (#match? @route.method_decorator "^(Get|Post|Put|Delete|Patch|Options|Head|All)$")
+      arguments: (arguments
+        (string) @route.path_value
+      )
+    )
+  )
+  .
+  (method_definition
+    name: (property_identifier) @route.method_name
+  )
+) @route.handler
+
+; Decorator without path argument
+(class_body
+  (decorator
+    (call_expression
+      function: (identifier) @route.method_decorator
+      (#match? @route.method_decorator "^(Get|Post|Put|Delete|Patch|Options|Head|All)$")
+      arguments: (arguments)
+    )
+  )
+  .
+  (method_definition
+    name: (property_identifier) @route.method_name
+  )
+) @route.handler_no_path
+
+; ── @Injectable() service ────────────────────────────────────────────────────
+
+(export_statement
+  (decorator
+    (call_expression
+      function: (identifier) @_inj
+      (#eq? @_inj "Injectable")
+    )
+  )
+  declaration: (class_declaration
+    name: (type_identifier) @service.class_name
+  )
+) @service.injectable
+
+; Non-exported @Injectable
+(class_declaration
+  (decorator
+    (call_expression
+      function: (identifier) @_inj2
+      (#eq? @_inj2 "Injectable")
+    )
+  )
+  name: (type_identifier) @service.class_name
+) @service.injectable_noexport
+
+; Constructor DI (inside any class)
+; required_parameter uses field "pattern" for the identifier, not "name"
+(method_definition
+  name: (property_identifier) @_ctor
+  (#eq? @_ctor "constructor")
+  parameters: (formal_parameters
+    (required_parameter
+      pattern: (identifier) @_pname
+      type: (type_annotation
+        (type_identifier) @service.inject_type
+      )
+    )
+  )
+) @service.constructor_di
+
+; ── @Module({ providers: [...] }) ────────────────────────────────────────────
+
+(export_statement
+  (decorator
+    (call_expression
+      function: (identifier) @_mod
+      (#eq? @_mod "Module")
+      arguments: (arguments
+        (object
+          (pair
+            key: (property_identifier) @_providers_key
+            (#eq? @_providers_key "providers")
+            value: (array
+              (identifier) @module.providers
+            )
+          )
+        )
+      )
+    )
+  )
+) @module.class
+
+; ── @Entity() / @Schema() ───────────────────────────────────────────────────
+
+(export_statement
+  (decorator
+    (call_expression
+      function: (identifier) @_ent
+      (#match? @_ent "^(Entity|Schema)$")
+    )
+  )
+  declaration: (class_declaration
+    name: (type_identifier) @entity.class_name
+  )
+) @entity.class
+
+; ── imports ───────────────────────────────────────────────────────────────────
+
+(import_statement
+  source: (string) @import.path
+) @import.decl

codebeacon/extract/queries/rails.scm

@@ -0,0 +1,114 @@
+; ── Rails (Ruby) ──────────────────────────────────────────────────────────────
+; Grammar: tree-sitter-ruby
+;
+; Special handling note:
+;   - `resources :users` → 7 CRUD routes expanded by extract/routes.py
+;   - `db/schema.rb` parsed separately for table columns
+;   - `routes.rb` is dispatched to this query by the extractor
+;
+; Captures:
+;   @route.resources_name   - resources :users name
+;   @route.http_method      - get/post/put/patch/delete
+;   @route.path             - path string
+;   @route.to               - "controller#action" string
+;   @route.namespace        - namespace/scope block
+;   @route.member_action    - member/collection route method
+;   @entity.class_name      - ApplicationRecord subclass
+;   @entity.relation_type   - has_many/belongs_to/has_one/has_and_belongs_to_many
+;   @entity.relation_target - relation target name (symbol)
+;   @service.class_name     - plain Ruby service class
+;   @import.path            - require path
+
+; ── resources :model_name ────────────────────────────────────────────────────
+
+(call
+  method: (identifier) @_res
+  (#match? @_res "^(resources|resource)$")
+  arguments: (argument_list
+    (simple_symbol) @route.resources_name
+  )
+) @route.resources
+
+; resources :users, only: [:index, :show]
+(call
+  method: (identifier) @_res
+  (#match? @_res "^(resources|resource)$")
+  arguments: (argument_list
+    (simple_symbol) @route.resources_name
+    (pair
+      key: (hash_key_symbol) @_only
+      (#match? @_only "^(only|except)$")
+      value: (array
+        (simple_symbol) @route.resources_filter
+      )
+    )
+  )
+) @route.resources_filtered
+
+; ── get/post/put/patch/delete "path", to: "ctrl#action" ──────────────────────
+
+(call
+  method: (identifier) @route.http_method
+  (#match? @route.http_method "^(get|post|put|patch|delete|match|root)$")
+  arguments: (argument_list
+    (string) @route.path
+    (pair
+      key: (hash_key_symbol) @_to
+      (#eq? @_to "to")
+      value: (string) @route.to
+    )?
+  )
+) @route.explicit
+
+; ── namespace/scope blocks ────────────────────────────────────────────────────
+
+(call
+  method: (identifier) @route.namespace
+  (#match? @route.namespace "^(namespace|scope|constraints|concern)$")
+  arguments: (argument_list
+    (string)? @route.namespace_path
+    (simple_symbol)? @route.namespace_path
+  )
+  block: _
+) @route.namespace_block
+
+; ── ApplicationRecord / ActiveRecord model ────────────────────────────────────
+
+(class
+  name: (constant) @entity.class_name
+  superclass: (superclass
+    [
+      (constant) @_base
+      (#match? @_base "^(ApplicationRecord|ActiveRecord)$")
+      (scope_resolution
+        name: (constant) @_base
+        (#eq? @_base "Base")
+      )
+    ]
+  )
+) @entity.model
+
+; Associations
+(call
+  method: (identifier) @entity.relation_type
+  (#match? @entity.relation_type "^(has_many|has_one|belongs_to|has_and_belongs_to_many)$")
+  arguments: (argument_list
+    (simple_symbol) @entity.relation_target
+  )
+) @entity.association
+
+; ── Plain service class ───────────────────────────────────────────────────────
+
+(class
+  name: (constant) @service.class_name
+) @service.class
+
+; ── require ───────────────────────────────────────────────────────────────────
+
+(call
+  method: (identifier) @_req
+  (#match? @_req "^(require|require_relative)$")
+  arguments: (argument_list
+    (string) @import.path
+  )
+) @import.require

codebeacon/extract/queries/react.scm

@@ -0,0 +1,111 @@
+; ── React / Next.js (TSX / TypeScript) ───────────────────────────────────────
+; Grammar: tree-sitter-typescript (for .ts) / tree-sitter-tsx (for .tsx)
+;
+; Component detection heuristic:
+;   - Exported function/arrow-function whose name starts with uppercase
+;   - Function returning JSX (jsx_element, jsx_self_closing_element) — TSX grammar
+;   - React.memo(Component), React.forwardRef(Component) wrappers
+;
+; Next.js routes: handled by convention in detector.py (file path → route).
+; This file captures component names and hooks for the graph.
+;
+; Captures:
+;   @component.func_name  - exported function component name
+;   @component.arrow_name - arrow function component name (const Foo = ...)
+;   @component.memo_name  - React.memo(Component) → inner component
+;   @hook.name            - used hooks (useState, useEffect, custom useX)
+;   @prop.name            - prop destructuring pattern names
+;   @route.pages_path     - file-system route (extracted from filename in routes.py)
+;   @server.directive     - "use server" / "use client" directive
+;   @import.path          - import source
+
+; ── Exported function component ───────────────────────────────────────────────
+
+(export_statement
+  (function_declaration
+    name: (identifier) @component.func_name
+  )
+) @component.export_func
+
+(export_statement
+  (function_declaration
+    name: (identifier) @component.func_name
+    (#match? @component.func_name "^[A-Z]")
+  )
+) @component.export_func_upper
+
+; export default function Component
+(export_statement
+  "default"
+  (function_declaration
+    name: (identifier) @component.func_name
+  )
+) @component.export_default_func
+
+; ── Arrow function component: export const Foo = (...) => ────────────────────
+
+(export_statement
+  (lexical_declaration
+    (variable_declarator
+      name: (identifier) @component.arrow_name
+      (#match? @component.arrow_name "^[A-Z]")
+      value: (arrow_function)
+    )
+  )
+) @component.export_arrow
+
+; Non-exported: const Foo = () => (used as sub-component)
+(lexical_declaration
+  (variable_declarator
+    name: (identifier) @component.arrow_name
+    (#match? @component.arrow_name "^[A-Z]")
+    value: (arrow_function)
+  )
+) @component.local_arrow
+
+; ── React.memo / React.forwardRef ────────────────────────────────────────────
+
+(export_statement
+  (lexical_declaration
+    (variable_declarator
+      name: (identifier) @component.memo_name
+      value: (call_expression
+        function: (member_expression
+          object: (identifier) @_react (#eq? @_react "React")
+          property: (property_identifier) @_hoc
+          (#match? @_hoc "^(memo|forwardRef|lazy)$")
+        )
+      )
+    )
+  )
+) @component.hoc
+
+; ── Hook usage ────────────────────────────────────────────────────────────────
+
+(call_expression
+  function: (identifier) @hook.name
+  (#match? @hook.name "^use[A-Z]")
+) @hook.call
+
+(call_expression
+  function: (member_expression
+    object: (identifier) @_react (#eq? @_react "React")
+    property: (property_identifier) @hook.name
+    (#match? @hook.name "^use[A-Z]")
+  )
+) @hook.react_call
+
+; ── "use client" / "use server" directive (Next.js App Router) ───────────────
+
+(expression_statement
+  (string
+    (string_fragment) @server.directive
+    (#match? @server.directive "^use (client|server)$")
+  )
+) @server.directive_stmt
+
+; ── imports ───────────────────────────────────────────────────────────────────
+
+(import_statement
+  source: (string) @import.path
+) @import.decl