codebeacon 0.1.2__py3-none-any.whl

codebeacon/extract/queries/spring_boot.scm

@@ -0,0 +1,204 @@
+; ── Spring Boot (Java) tree-sitter queries ──────────────────────────────────
+; Grammar: tree-sitter-java
+;
+; Java grammar note:
+;   - marker_annotation: @Override, @RestController (no arguments)
+;   - annotation: @RequestMapping("/path") (with arguments)
+;   Both appear as children of `modifiers`.
+;
+; Captures used by routes.py / services.py / entities.py:
+;   @route.class_annotation  - @RequestMapping on class
+;   @route.method_annotation - @GetMapping/@PostMapping/etc on method
+;   @route.class_name        - controller class name
+;   @route.method_name       - handler method name
+;   @route.path_value        - path string literal
+;   @service.annotation      - @Service/@Component etc. name
+;   @service.class_name      - service class name
+;   @service.interface       - implemented interface name
+;   @entity.class_name       - entity class name
+;   @entity.table_name       - @Table(name="...") value
+;   @di.field_type           - @Autowired field type
+;   @di.field_name           - @Autowired field name
+;   @di.ctor_param_type      - constructor injection param type
+;   @di.ctor_param_name      - constructor injection param name
+;   @import.path             - import path
+
+; ── Controller class ─────────────────────────────────────────────────────────
+
+(class_declaration
+  (modifiers
+    [
+      (annotation name: (identifier) @route.class_annotation)
+      (marker_annotation name: (identifier) @route.class_annotation)
+    ]
+    (#match? @route.class_annotation "^(RestController|Controller)$")
+  )
+  name: (identifier) @route.class_name
+) @route.controller_class
+
+; Class-level @RequestMapping path
+(class_declaration
+  (modifiers
+    (annotation
+      name: (identifier) @_rm
+      (#eq? @_rm "RequestMapping")
+      arguments: (annotation_argument_list
+        [
+          (string_literal) @route.class_path
+          (element_value_pair
+            key: (identifier) @_key
+            (#match? @_key "^(value|path)$")
+            value: [
+              (string_literal) @route.class_path
+              (array_initializer (string_literal) @route.class_path)
+            ]
+          )
+        ]
+      )
+    )
+  )
+) @route.class_mapping
+
+; ── Method-level route annotations ───────────────────────────────────────────
+
+; With arguments (annotation)
+(method_declaration
+  (modifiers
+    (annotation
+      name: (identifier) @route.method_annotation
+      (#match? @route.method_annotation "^(GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping|RequestMapping)$")
+    )
+  )
+  name: (identifier) @route.method_name
+) @route.handler_method
+
+; Without arguments (marker_annotation) — e.g. @GetMapping with no path
+(method_declaration
+  (modifiers
+    (marker_annotation
+      name: (identifier) @route.method_annotation
+      (#match? @route.method_annotation "^(GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping|RequestMapping)$")
+    )
+  )
+  name: (identifier) @route.method_name
+) @route.handler_method
+
+; Method annotation WITH path value
+(method_declaration
+  (modifiers
+    (annotation
+      name: (identifier) @_ann
+      (#match? @_ann "^(GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping|RequestMapping)$")
+      arguments: (annotation_argument_list
+        [
+          (string_literal) @route.path_value
+          (element_value_pair
+            key: (identifier) @_key
+            (#match? @_key "^(value|path)$")
+            value: [
+              (string_literal) @route.path_value
+              (array_initializer (string_literal) @route.path_value)
+            ]
+          )
+        ]
+      )
+    )
+  )
+  name: (identifier) @route.method_name_with_path
+) @route.method_with_path
+
+; ── Service / Component / Repository ─────────────────────────────────────────
+
+(class_declaration
+  (modifiers
+    [
+      (annotation name: (identifier) @service.annotation)
+      (marker_annotation name: (identifier) @service.annotation)
+    ]
+    (#match? @service.annotation "^(Service|Component|Repository|RestController|Controller)$")
+  )
+  name: (identifier) @service.class_name
+) @service.class
+
+; Implemented interfaces
+(class_declaration
+  name: (identifier) @service.class_name
+  (super_interfaces
+    (type_list
+      (type_identifier) @service.interface
+    )
+  )
+) @service.with_interface
+
+; ── Entity ────────────────────────────────────────────────────────────────────
+
+(class_declaration
+  (modifiers
+    (marker_annotation
+      name: (identifier) @entity.annotation
+      (#eq? @entity.annotation "Entity")
+    )
+  )
+  name: (identifier) @entity.class_name
+) @entity.class
+
+; @Table(name = "...") — separate query (not inside class_declaration to avoid nesting issues)
+(annotation
+  name: (identifier) @_tbl
+  (#eq? @_tbl "Table")
+  arguments: (annotation_argument_list
+    (element_value_pair
+      key: (identifier) @_name_key
+      (#eq? @_name_key "name")
+      value: (string_literal) @entity.table_name
+    )
+  )
+) @entity.table_annotation
+
+; ── DI — @Autowired field injection ──────────────────────────────────────────
+
+(field_declaration
+  (modifiers
+    [
+      (annotation name: (identifier) @_aw (#eq? @_aw "Autowired"))
+      (marker_annotation name: (identifier) @_aw (#eq? @_aw "Autowired"))
+    ]
+  )
+  type: (type_identifier) @di.field_type
+  (variable_declarator
+    name: (identifier) @di.field_name
+  )
+) @di.autowired_field
+
+; ── DI — Constructor injection ───────────────────────────────────────────────
+
+(constructor_declaration
+  parameters: (formal_parameters
+    (formal_parameter
+      type: (type_identifier) @di.ctor_param_type
+      name: (identifier) @di.ctor_param_name
+    )
+  )
+) @di.constructor
+
+; ── Entity fields ─────────────────────────────────────────────────────────────
+
+(field_declaration
+  (modifiers
+    [
+      (annotation name: (identifier) @entity.field_annotation)
+      (marker_annotation name: (identifier) @entity.field_annotation)
+    ]
+    (#match? @entity.field_annotation "^(Id|Column|ManyToOne|OneToMany|ManyToMany|OneToOne|JoinColumn|GeneratedValue)$")
+  )
+  type: _ @entity.field_type
+  (variable_declarator
+    name: (identifier) @entity.field_name
+  )
+) @entity.field
+
+; ── Imports ───────────────────────────────────────────────────────────────────
+
+(import_declaration
+  (scoped_identifier) @import.path
+) @import.decl

codebeacon/extract/queries/svelte.scm

@@ -0,0 +1,73 @@
+; ── Svelte / SvelteKit (script section only) ──────────────────────────────────
+; Grammar: tree-sitter-typescript (applied to extracted <script> section)
+;
+; Usage note:
+;   .svelte files use SFC section extraction (same as Vue).
+;   This .scm file applies to the extracted <script> section.
+;
+; Svelte 5 runes: $state(), $derived(), $effect() — captured as call_expression
+; Svelte 4: export let prop — explicit prop declarations
+; SvelteKit routes: file-system (src/routes/**/+page.svelte) → detector.py
+; SvelteKit load: +page.ts export function load() { } — separate file
+;
+; Captures:
+;   @component.name     - component name (derived from filename in routes.py)
+;   @prop.name          - export let propName (Svelte 4)
+;   @store.name         - writable/readable/derived store
+;   @rune.name          - Svelte 5: $state/$derived/$effect call
+;   @load.func          - SvelteKit load function name
+;   @import.path        - import source
+
+; ── export let prop (Svelte 4 props) ─────────────────────────────────────────
+
+(export_statement
+  (lexical_declaration
+    (variable_declarator
+      name: (identifier) @prop.name
+    )
+  )
+) @prop.exported_let
+
+; ── Svelte 5 runes ────────────────────────────────────────────────────────────
+
+(variable_declarator
+  name: (identifier) @_var
+  value: (call_expression
+    function: (identifier) @rune.name
+    (#match? @rune.name "^\\$(state|derived|effect|props|bindable|inspect|host)$")
+  )
+) @rune.usage
+
+; ── Svelte stores ─────────────────────────────────────────────────────────────
+
+(variable_declarator
+  name: (identifier) @store.name
+  value: (call_expression
+    function: (identifier) @_store_fn
+    (#match? @_store_fn "^(writable|readable|derived|get)$")
+  )
+) @store.decl
+
+; ── SvelteKit load function ───────────────────────────────────────────────────
+
+(export_statement
+  (function_declaration
+    name: (identifier) @load.func
+    (#match? @load.func "^(load|GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD|fallback)$")
+  )
+) @load.export
+
+; ── Component function / class (less common in Svelte but possible) ──────────
+
+(export_statement
+  (function_declaration
+    name: (identifier) @component.name
+    (#match? @component.name "^[A-Z]")
+  )
+) @component.func
+
+; ── imports ───────────────────────────────────────────────────────────────────
+
+(import_statement
+  source: (string) @import.path
+) @import.decl

codebeacon/extract/queries/vapor.scm

@@ -0,0 +1,130 @@
+; ── Vapor (Swift) ────────────────────────────────────────────────────────────
+; Grammar: tree-sitter-swift
+;
+; Swift grammar note:
+;   - call_expression + navigation_expression: app.get("path") { ... }
+;   - navigation_suffix with simple_identifier: method name
+;   - call_suffix + value_arguments: route path arguments
+;   - line_string_literal: Swift double-quoted string
+;   - line_str_text: string content
+;   - property_declaration: let x = app.grouped("prefix")
+;   - attribute: @ID, @Field property wrappers
+;
+; Note: Swift paths can be multiple string arguments: app.get("users", ":id")
+; extract/routes.py joins them with "/"
+;
+; Captures:
+;   @route.object       - app / group variable
+;   @route.method       - get/post/put/patch/delete/on
+;   @route.path_segment - path string segment(s)
+;   @route.grouped_name - grouped variable name
+;   @route.grouped_prefix - grouped path string
+;   @entity.class_name  - Fluent Model class
+;   @entity.field_name  - @Field property name
+;   @entity.field_key   - @Field(key: "column") value
+;   @entity.id_name     - @ID property name
+;   @service.func_name  - routes configuration function
+;   @import.name        - import module name
+
+; ── app.get("path") { ... } ──────────────────────────────────────────────────
+
+(call_expression
+  (navigation_expression
+    (simple_identifier) @route.object
+    (navigation_suffix
+      (simple_identifier) @route.method
+      (#match? @route.method "^(get|post|put|patch|delete|on|grouped)$")
+    )
+  )
+  (call_suffix
+    (value_arguments
+      (value_argument
+        (line_string_literal
+          (line_str_text) @route.path_segment
+        )
+      )
+    )
+    (lambda_literal)?
+  )
+) @route.call
+
+; ── let users = app.grouped("users") ─────────────────────────────────────────
+
+(property_declaration
+  (pattern
+    (simple_identifier) @route.grouped_name
+  )
+  (call_expression
+    (navigation_expression
+      (simple_identifier) @_app
+      (navigation_suffix
+        (simple_identifier) @_grouped
+        (#eq? @_grouped "grouped")
+      )
+    )
+    (call_suffix
+      (value_arguments
+        (value_argument
+          (line_string_literal
+            (line_str_text) @route.grouped_prefix
+          )
+        )
+      )
+    )
+  )
+) @route.grouped_decl
+
+; ── Fluent Model class ────────────────────────────────────────────────────────
+
+(class_declaration
+  (type_modifiers (attribute (user_type (type_identifier) @_final (#eq? @_final "final"))))?
+  (simple_identifier) @entity.class_name
+  (type_inheritance_clause
+    (inheritance_specifier
+      (user_type
+        (type_identifier) @_base
+        (#match? @_base "^(Model|Content|Authenticatable)$")
+      )
+    )
+  )
+) @entity.model
+
+; @Field(key: "column_name") var fieldName: Type
+(property_declaration
+  (modifiers
+    (attribute
+      (user_type (type_identifier) @_attr (#eq? @_attr "Field"))
+      (attribute_argument_clause
+        (value_argument
+          (simple_identifier) @_key (#eq? @_key "key")
+          (line_string_literal (line_str_text) @entity.field_key)
+        )
+      )
+    )
+  )
+  (pattern (simple_identifier) @entity.field_name)
+) @entity.field
+
+; @ID(key: .id) var id
+(property_declaration
+  (modifiers
+    (attribute
+      (user_type (type_identifier) @_id (#eq? @_id "ID"))
+    )
+  )
+  (pattern (simple_identifier) @entity.id_name)
+) @entity.id_field
+
+; ── Routes function ───────────────────────────────────────────────────────────
+
+(function_declaration
+  (simple_identifier) @service.func_name
+) @service.func
+
+; ── imports ───────────────────────────────────────────────────────────────────
+
+(import_declaration
+  (identifier
+    (simple_identifier) @import.name
+  )
+) @import.decl

codebeacon/extract/queries/vue.scm

@@ -0,0 +1,123 @@
+; ── Vue / Nuxt (script section only) ──────────────────────────────────────────
+; Grammar: tree-sitter-typescript (applied to extracted <script> section)
+;
+; Usage note:
+;   .vue SFC files are NOT parsed directly. extract/base.py extracts the
+;   <script> section text and parses it with TypeScript grammar.
+;   This .scm file describes queries for that extracted script section.
+;
+; Vue 3 Composition API patterns:
+;   - defineComponent({ name, setup, components, props })
+;   - <script setup> — top-level statements are component options
+;   - defineProps<{ name: string }>() / defineProps({ name: String })
+;   - defineEmits
+;   - const router = useRouter() / const route = useRoute()
+;
+; Vue Router: const routes = [{ path: "/users", component: UserList }]
+; Nuxt: file-system routing handled in detector.py
+;
+; Captures:
+;   @component.name        - defineComponent({ name: "..." }) value
+;   @component.class_name  - export default class ComponentName
+;   @component.setup_name  - <script setup> — use filename as component name
+;   @route.path            - Vue Router route path string
+;   @route.component       - Vue Router component identifier
+;   @prop.name             - defineProps({ name: ... }) key
+;   @composable.name       - used composable (useX function calls)
+;   @import.path           - import source
+
+; ── defineComponent({ name: "ComponentName", ... }) ─────────────────────────
+
+(call_expression
+  function: (identifier) @_dc
+  (#eq? @_dc "defineComponent")
+  arguments: (arguments
+    (object
+      (pair
+        key: (property_identifier) @_name_key
+        (#eq? @_name_key "name")
+        value: (string
+          (string_fragment) @component.name
+        )
+      )
+    )
+  )
+) @component.define
+
+; ── export default class ComponentName ───────────────────────────────────────
+
+(export_statement
+  "default"
+  (class_declaration
+    name: (type_identifier) @component.class_name
+  )
+) @component.class
+
+(export_statement
+  "default"
+  (call_expression
+    function: (identifier) @_dc2
+    (#eq? @_dc2 "defineComponent")
+  )
+) @component.define_anon
+
+; ── defineProps({ ... }) / defineProps<T>() ──────────────────────────────────
+
+(call_expression
+  function: (identifier) @_dp
+  (#eq? @_dp "defineProps")
+  arguments: (arguments
+    (object
+      (pair
+        key: (property_identifier) @prop.name
+      )
+    )
+  )
+) @component.props_object
+
+; ── Vue Router routes array ───────────────────────────────────────────────────
+
+(variable_declarator
+  name: (identifier) @_routes
+  (#eq? @_routes "routes")
+  value: (array
+    (object
+      (pair
+        key: (property_identifier) @_path_key
+        (#eq? @_path_key "path")
+        value: (string
+          (string_fragment) @route.path
+        )
+      )
+    )
+  )
+) @route.routes_array
+
+; Route component reference
+(object
+  (pair
+    key: (property_identifier) @_path_key2
+    (#eq? @_path_key2 "path")
+    value: (string
+      (string_fragment) @route.path
+    )
+  )
+  (pair
+    key: (property_identifier) @_comp_key
+    (#match? @_comp_key "^(component|components)$")
+    value: (identifier) @route.component
+  )
+) @route.route_entry
+
+; ── Composable usage (useX) ───────────────────────────────────────────────────
+
+(call_expression
+  function: (identifier) @composable.name
+  (#match? @composable.name "^use[A-Z]")
+) @composable.call
+
+; ── imports ───────────────────────────────────────────────────────────────────
+
+(import_statement
+  source: (string) @import.path
+) @import.decl