rbtr-lang-vue 2026.9.0.dev1__tar.gz

rbtr_lang_vue-2026.9.0.dev1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alejandro Giacometti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rbtr_lang_vue-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-vue
+Version: 2026.9.0.dev1
+Summary: rbtr — Vue language plugin (thin; reuses rbtr-lang-svelte's SFC machinery)
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,vue
+Author: Alejandro Giacometti
+Author-email: Alejandro Giacometti <alejandro.giacometti@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Typing :: Typed
+Requires-Dist: rbtr==2026.9.0.dev1
+Requires-Dist: rbtr-lang-svelte==2026.9.0.dev1
+Requires-Dist: tree-sitter-language-pack
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/janrito/rbtr
+Project-URL: Repository, https://github.com/janrito/rbtr
+Project-URL: Documentation, https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-vue#readme
+Project-URL: Issues, https://github.com/janrito/rbtr/issues
+Project-URL: Changelog, https://github.com/janrito/rbtr/releases
+Description-Content-Type: text/markdown
+
+# rbtr-lang-vue
+
+Vue support for [rbtr]. Optional plugin — install with
+`pip install rbtr[vue]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+[rbtr-lang-svelte]: https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-svelte#readme
+
+## What it ingests
+
+`.vue` single-file components. Vue has the same `<script>`/`<style>`/template
+shape as Svelte, so this package reuses the SFC chunker and injection query
+from [rbtr-lang-svelte]: the markup template becomes one
+host **doc-section** chunk, a comment above that markup is its own chunk, and
+the `<script>`/`<style>` blocks are delegated to their embedded language.
+
+## Chunks produced
+
+```vue
+<script setup lang="ts">
+import { store } from "./store"     // → import        (typescript)
+const count = ref(0)                // → variable "count" (typescript)
+</script>
+
+<template>
+  <button>{{ count }}</button>      <!-- → doc_section "Counter" (vue host) -->
+</template>
+
+<style lang="scss">
+.btn { color: red; }                // → class ".btn" (scss)
+</style>
+```
+
+## Embedded / injected chunks
+
+`<script lang="ts">` → TypeScript (bare → JavaScript); `<style lang="scss">` →
+SCSS (`lang="less"` → Less, bare → CSS). These run only when the corresponding
+plugin (`rbtr-lang-javascript`, `rbtr-lang-css`) is installed.
+
+## Grammar & dependencies
+
+The Vue grammar is bundled in `tree-sitter-language-pack`. Depends on
+`rbtr-lang-svelte` for the shared SFC chunker and injection query.

rbtr_lang_vue-2026.9.0.dev1/README.md

@@ -0,0 +1,43 @@
+# rbtr-lang-vue
+
+Vue support for [rbtr]. Optional plugin — install with
+`pip install rbtr[vue]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+[rbtr-lang-svelte]: https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-svelte#readme
+
+## What it ingests
+
+`.vue` single-file components. Vue has the same `<script>`/`<style>`/template
+shape as Svelte, so this package reuses the SFC chunker and injection query
+from [rbtr-lang-svelte]: the markup template becomes one
+host **doc-section** chunk, a comment above that markup is its own chunk, and
+the `<script>`/`<style>` blocks are delegated to their embedded language.
+
+## Chunks produced
+
+```vue
+<script setup lang="ts">
+import { store } from "./store"     // → import        (typescript)
+const count = ref(0)                // → variable "count" (typescript)
+</script>
+
+<template>
+  <button>{{ count }}</button>      <!-- → doc_section "Counter" (vue host) -->
+</template>
+
+<style lang="scss">
+.btn { color: red; }                // → class ".btn" (scss)
+</style>
+```
+
+## Embedded / injected chunks
+
+`<script lang="ts">` → TypeScript (bare → JavaScript); `<style lang="scss">` →
+SCSS (`lang="less"` → Less, bare → CSS). These run only when the corresponding
+plugin (`rbtr-lang-javascript`, `rbtr-lang-css`) is installed.
+
+## Grammar & dependencies
+
+The Vue grammar is bundled in `tree-sitter-language-pack`. Depends on
+`rbtr-lang-svelte` for the shared SFC chunker and injection query.

rbtr_lang_vue-2026.9.0.dev1/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_vue"
+
+[tool.uv.sources.rbtr]
+workspace = true
+
+[tool.uv.sources.rbtr-lang-svelte]
+workspace = true
+
+[tool.uv.sources.rbtr-lang-javascript]
+workspace = true
+
+[tool.uv.sources.rbtr-lang-scss]
+workspace = true
+
+[project]
+name = "rbtr-lang-vue"
+version = "2026.9.0-dev1"
+description = "rbtr — Vue language plugin (thin; reuses rbtr-lang-svelte's SFC machinery)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "code-search",
+    "code-index",
+    "tree-sitter",
+    "static-analysis",
+    "semantic-search",
+    "developer-tools",
+    "vue",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Text Processing :: Indexing",
+    "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "rbtr==2026.9.0-dev1",
+    "rbtr-lang-svelte==2026.9.0-dev1",
+    "tree-sitter-language-pack",
+]
+
+[[project.authors]]
+name = "Alejandro Giacometti"
+email = "alejandro.giacometti@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/janrito/rbtr"
+Repository = "https://github.com/janrito/rbtr"
+Documentation = "https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-vue#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+vue = "rbtr_lang_vue.plugin:vue"
+
+[dependency-groups]
+dev = [
+    "rbtr[test]",
+    "rbtr-lang-javascript",
+    "rbtr-lang-scss",
+]

rbtr_lang_vue-2026.9.0.dev1/pyproject.toml.orig

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_vue"
+# No source-exclude: the plugin's tests, samples, and snapshots ship with
+# the wheel (they are the language's golden record).
+
+[project]
+name = "rbtr-lang-vue"
+version = "2026.9.0-dev1"
+description = "rbtr — Vue language plugin (thin; reuses rbtr-lang-svelte's SFC machinery)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Alejandro Giacometti", email = "alejandro.giacometti@gmail.com" },
+]
+keywords = [
+  "code-search",
+  "code-index",
+  "tree-sitter",
+  "static-analysis",
+  "semantic-search",
+  "developer-tools",
+  "vue",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Libraries",
+  "Topic :: Text Processing :: Indexing",
+  "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+  "rbtr==2026.9.0-dev1",
+  "rbtr-lang-svelte==2026.9.0-dev1",
+  "tree-sitter-language-pack",  # Vue grammar (bundled, hermetic)
+]
+
+[project.urls]
+Homepage = "https://github.com/janrito/rbtr"
+Repository = "https://github.com/janrito/rbtr"
+Documentation = "https://github.com/janrito/rbtr/tree/main/packages/rbtr-lang-vue#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+
+[project.entry-points."rbtr.languages"]
+# The value resolves to the language's `LanguageRegistration` (named by its
+# id) — see the rbtr ARCHITECTURE "External plugins" note.
+vue = "rbtr_lang_vue.plugin:vue"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+rbtr-lang-svelte = { workspace = true }
+rbtr-lang-javascript = { workspace = true }
+rbtr-lang-scss = { workspace = true }
+
+[dependency-groups]
+# The sample embeds lang="ts" and lang="scss" blocks (scss pulls css).
+dev = ["rbtr[test]", "rbtr-lang-javascript", "rbtr-lang-scss"]

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/plugin.py

@@ -0,0 +1,38 @@
+"""Vue language plugin.
+
+`.vue` single-file components have the same `<script>`/`<style>`/template
+shape as Svelte, so they reuse the SFC chunker (`chunk_sfc`) and injection
+query from `rbtr-lang-svelte`. Only the grammar differs: Vue's is bundled in
+`tree-sitter-language-pack`, kept out of a plain Svelte install by living
+behind this separate package.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rbtr.languages.registration import LanguageRegistration, load_query
+from rbtr_lang_svelte.plugin import chunk_sfc
+
+if TYPE_CHECKING:
+    from tree_sitter import Language
+
+
+def _vue_grammar() -> Language:
+    """Load the Vue grammar from the bundled language pack."""
+    import tree_sitter_language_pack  # deferred: heavy bundled native grammars
+
+    return tree_sitter_language_pack.get_language("vue")
+
+
+# Reuses the SFC injection query shipped in rbtr-lang-svelte (cached, so this
+# and svelte's own load read the file once).
+vue = LanguageRegistration(
+    id="vue",
+    extensions=frozenset({".vue"}),
+    grammar_factory=_vue_grammar,
+    injection_query=load_query("rbtr_lang_svelte", "injections"),
+    extraction_serial=2,
+)
+
+vue.chunker(chunk_sfc)

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/tests/__snapshots__/test_samples/test_edges_match_snapshot.json

@@ -0,0 +1,3 @@
+[
+  "Counter.vue::import { makeStore } from \"./store\"; -> store.ts::makeStore [imports]"
+]

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json

@@ -0,0 +1,192 @@
+[
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "doc_section",
+    "name": "Counter",
+    "scope": "",
+    "language": "vue",
+    "file_language": "vue",
+    "content": "<template>\n  <button class=\"counter\" @click=\"increment\">{{ store.count }}</button>\n</template>",
+    "line_start": 33,
+    "line_end": 35,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "383d4211ee508e85"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "vue",
+    "file_language": "vue",
+    "content": "<!--\n  Vue single-file component.\n\n  The SFC plugin delegates <script> to TypeScript and <style> to SCSS.\n  This comment is itself a chunk, so a component's own explanation of\n  what it is for stays searchable.\n-->",
+    "line_start": 1,
+    "line_end": 7,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "b8108f5642e5ab1d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "vue",
+    "content": "// Vue single-file component.\n//\n// The SFC plugin delegates the <script setup> block to TypeScript and\n// the <style> block to SCSS, reusing the same chunker as Svelte. The\n// template is not extracted.",
+    "line_start": 10,
+    "line_end": 14,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "10a55ab379567fb3"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "import",
+    "name": "import { makeStore } from \"./store\";",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "vue",
+    "content": "import { makeStore } from \"./store\";",
+    "line_start": 15,
+    "line_end": 15,
+    "metadata": {
+      "module": "store",
+      "names": "makeStore",
+      "dots": "1",
+      "language_hint": ""
+    },
+    "id": "2829a0c60e534b3e"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "variable",
+    "name": "store",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "vue",
+    "content": "store = makeStore()",
+    "line_start": 17,
+    "line_end": 17,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "4c8308057f92d8a6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "function",
+    "name": "increment",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "vue",
+    "content": "function increment(): void {\n  store.count += 1;\n}",
+    "line_start": 19,
+    "line_end": 21,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "648d9d1f6c623121"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "variable",
+    "name": "$accent",
+    "scope": "",
+    "language": "scss",
+    "file_language": "vue",
+    "content": "$accent: #00aa77;",
+    "line_start": 25,
+    "line_end": 25,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "cebdec667e5d1547"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "Counter.vue",
+    "kind": "class",
+    "name": ".counter",
+    "scope": "",
+    "language": "scss",
+    "file_language": "vue",
+    "content": ".counter {\n    color: $accent;\n    font-weight: bold;\n  }",
+    "line_start": 27,
+    "line_end": 30,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "c41a0c5fc46325f9"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "store.ts",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "typescript",
+    "content": "// Imported by Counter.vue's <script setup> block.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "b0eec444d8e60c22"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "store.ts",
+    "kind": "function",
+    "name": "makeStore",
+    "scope": "",
+    "language": "typescript",
+    "file_language": "typescript",
+    "content": "function makeStore(): { count: number } {\n  return { count: 0 };\n}",
+    "line_start": 3,
+    "line_end": 5,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "a264a8c3d2ecd498"
+  }
+]

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/tests/samples/vue/Counter.vue

@@ -0,0 +1,35 @@
+<!--
+  Vue single-file component.
+
+  The SFC plugin delegates <script> to TypeScript and <style> to SCSS.
+  This comment is itself a chunk, so a component's own explanation of
+  what it is for stays searchable.
+-->
+
+<script setup lang="ts">
+// Vue single-file component.
+//
+// The SFC plugin delegates the <script setup> block to TypeScript and
+// the <style> block to SCSS, reusing the same chunker as Svelte. The
+// template is not extracted.
+import { makeStore } from "./store";
+
+const store = makeStore();
+
+function increment(): void {
+  store.count += 1;
+}
+</script>
+
+<style lang="scss">
+  $accent: #00aa77;
+
+  .counter {
+    color: $accent;
+    font-weight: bold;
+  }
+</style>
+
+<template>
+  <button class="counter" @click="increment">{{ store.count }}</button>
+</template>

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/tests/samples/vue/store.ts

@@ -0,0 +1,5 @@
+// Imported by Counter.vue's <script setup> block.
+
+export function makeStore(): { count: number } {
+  return { count: 0 };
+}

rbtr_lang_vue-2026.9.0.dev1/src/rbtr_lang_vue/tests/test_samples.py

@@ -0,0 +1,86 @@
+"""Vue sample extraction: the `samples/vue/` project through the real pipeline."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import pytest
+from tree_sitter import Parser
+
+from rbtr.domain.models import Chunk, ChunkKind, Edge
+from rbtr.git import FileEntry
+from rbtr.languages.edges import build_resolution_map, infer_import_edges
+from rbtr.languages.extract import extract_file
+from rbtr.languages.manager import get_manager
+from rbtr.testing import assert_document_fully_chunked, render_edges
+
+if TYPE_CHECKING:
+    from syrupy.assertion import SnapshotAssertion
+
+
+@pytest.fixture
+def project() -> list[tuple[str, str]]:
+    root = Path(__file__).parent / "samples" / "vue"
+    return [
+        (str(p.relative_to(root)), p.read_text()) for p in sorted(root.rglob("*")) if p.is_file()
+    ]
+
+
+@pytest.fixture
+def chunks(project: list[tuple[str, str]]) -> list[Chunk]:
+    manager = get_manager()
+    out: list[Chunk] = []
+    for path, text in project:
+        lang = manager.detect_language(path) or "vue"
+        out.extend(extract_file(FileEntry(path, "sha1", text.encode()), lang))
+    return out
+
+
+@pytest.fixture
+def edges(project: list[tuple[str, str]], chunks: list[Chunk]) -> list[Edge]:
+    manager = get_manager()
+    repo_files = {path for path, _ in project}
+    return infer_import_edges(chunks, repo_files, build_resolution_map(manager))
+
+
+def test_emits_expected_kinds(chunks: list[Chunk]) -> None:
+    """The `<script lang="ts">` and blocks are delegated to TypeScript/SCSS; the template is a host chunk."""
+    kinds = {c.kind for c in chunks}
+    assert {
+        ChunkKind.FUNCTION,
+        ChunkKind.VARIABLE,
+        ChunkKind.DOC_SECTION,
+        ChunkKind.IMPORT,
+    } <= kinds
+
+
+def test_parses_cleanly(project: list[tuple[str, str]]) -> None:
+    manager = get_manager()
+    for path, text in project:
+        grammar = manager.grammar(manager.detect_language(path) or "vue")
+        assert grammar is not None
+        assert not Parser(grammar).parse(text.encode()).root_node.has_error, path
+
+
+def test_extraction_matches_snapshot(chunks: list[Chunk], snapshot_json: SnapshotAssertion) -> None:
+    assert chunks == snapshot_json
+
+
+def test_edges_match_snapshot(
+    chunks: list[Chunk], edges: list[Edge], snapshot_json: SnapshotAssertion
+) -> None:
+    assert render_edges(edges, chunks) == snapshot_json
+
+
+def test_every_block_of_every_document_is_chunked(
+    project: list[tuple[str, str]], chunks: list[Chunk]
+) -> None:
+    """A chunker owns the whole document, so no top-level block is dropped."""
+    manager = get_manager()
+    for path, text in project:
+        if manager.detect_language(path) != "vue":
+            continue
+        grammar = manager.grammar("vue")
+        assert grammar is not None
+        assert_document_fully_chunked(path, text, chunks, grammar)