PyPI - rbtr-lang-html - Versions diffs - 2026.9.0.dev1__tar.gz - Mend

rbtr-lang-html 2026.9.0.dev1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

rbtr_lang_html-2026.9.0.dev1/LICENSE ADDED Viewed

@@ -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_html-2026.9.0.dev1/PKG-INFO ADDED Viewed

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-html
+Version: 2026.9.0.dev1
+Summary: rbtr — HTML language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,html
+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: tree-sitter-html
+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-html#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-html
+HTML support for [rbtr]. A **default** plugin — installed with rbtr
+itself (`pip install rbtr`).
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+## What it ingests
+- **Sections** — major `<body>` elements (`<main>`, `<article>`, `<nav>`, …)
+  → doc sections, named by their `id` (else the tag name).
+- **Imports** — `<script src>` and `<link href>` → import chunks carrying the
+  referenced path and a language hint, so edges link to the target file.
+## Chunks produced
+```html
+<main id="content">…</main>           <!-- doc_section "content"                  -->
+<nav>…</nav>                          <!-- doc_section "nav"                      -->
+<script src="app.js"></script>        <!-- import {module: app.js, hint: javascript} -->
+<link rel="stylesheet" href="a.css">  <!-- import {module: a.css, hint: css}      -->
+```
+## Embedded / injected chunks
+HTML embeds other languages: an inline `<script>` delegates to JavaScript and
+an inline `<style>` to CSS, so their chunks extract at real line numbers
+within the page, each carrying its own language.
+```html
+<main id="app">                    <!-- doc_section "app"   (html)       -->
+  <script>
+    function boot() { start(); }   <!-- function "boot"     (javascript) -->
+  </script>
+  <style>
+    .hero { color: crimson; }      <!-- class ".hero"       (css)        -->
+  </style>
+</main>
+```
+## Grammar & dependencies
+Uses the `tree-sitter-html` grammar. No runtime dependency on other language
+plugins; the test suite dev-depends on `rbtr-lang-javascript` and
+`rbtr-lang-css` so the sample's linked and injected js/css extract and the
+cross-file edges snapshot.

rbtr_lang_html-2026.9.0.dev1/README.md ADDED Viewed

@@ -0,0 +1,46 @@
+# rbtr-lang-html
+HTML support for [rbtr]. A **default** plugin — installed with rbtr
+itself (`pip install rbtr`).
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+## What it ingests
+- **Sections** — major `<body>` elements (`<main>`, `<article>`, `<nav>`, …)
+  → doc sections, named by their `id` (else the tag name).
+- **Imports** — `<script src>` and `<link href>` → import chunks carrying the
+  referenced path and a language hint, so edges link to the target file.
+## Chunks produced
+```html
+<main id="content">…</main>           <!-- doc_section "content"                  -->
+<nav>…</nav>                          <!-- doc_section "nav"                      -->
+<script src="app.js"></script>        <!-- import {module: app.js, hint: javascript} -->
+<link rel="stylesheet" href="a.css">  <!-- import {module: a.css, hint: css}      -->
+```
+## Embedded / injected chunks
+HTML embeds other languages: an inline `<script>` delegates to JavaScript and
+an inline `<style>` to CSS, so their chunks extract at real line numbers
+within the page, each carrying its own language.
+```html
+<main id="app">                    <!-- doc_section "app"   (html)       -->
+  <script>
+    function boot() { start(); }   <!-- function "boot"     (javascript) -->
+  </script>
+  <style>
+    .hero { color: crimson; }      <!-- class ".hero"       (css)        -->
+  </style>
+</main>
+```
+## Grammar & dependencies
+Uses the `tree-sitter-html` grammar. No runtime dependency on other language
+plugins; the test suite dev-depends on `rbtr-lang-javascript` and
+`rbtr-lang-css` so the sample's linked and injected js/css extract and the
+cross-file edges snapshot.

rbtr_lang_html-2026.9.0.dev1/pyproject.toml ADDED Viewed

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+[tool.uv.build-backend]
+module-name = "rbtr_lang_html"
+[tool.uv.sources.rbtr]
+workspace = true
+[tool.uv.sources.rbtr-lang-css]
+workspace = true
+[tool.uv.sources.rbtr-lang-javascript]
+workspace = true
+[project]
+name = "rbtr-lang-html"
+version = "2026.9.0-dev1"
+description = "rbtr — HTML language plugin"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "code-search",
+    "code-index",
+    "tree-sitter",
+    "static-analysis",
+    "semantic-search",
+    "developer-tools",
+    "html",
+]
+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",
+    "tree-sitter-html",
+]
+[[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-html#readme"
+Issues = "https://github.com/janrito/rbtr/issues"
+Changelog = "https://github.com/janrito/rbtr/releases"
+[project.entry-points."rbtr.languages"]
+html = "rbtr_lang_html.plugin:html"
+[dependency-groups]
+dev = [
+    "rbtr[test]",
+    "rbtr-lang-css",
+    "rbtr-lang-javascript",
+]

rbtr_lang_html-2026.9.0.dev1/pyproject.toml.orig ADDED Viewed

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+[tool.uv.build-backend]
+module-name = "rbtr_lang_html"
+# No source-exclude: the plugin's tests, samples, and snapshots ship
+# with the wheel (they are the language's golden record), and the .scm
+# queries ship as package data.
+[project]
+name = "rbtr-lang-html"
+version = "2026.9.0-dev1"
+description = "rbtr — HTML language plugin"
+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",
+  "html",
+]
+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",
+  "tree-sitter-html",
+]
+[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-html#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.
+html = "rbtr_lang_html.plugin:html"
+[tool.uv.sources]
+rbtr = { workspace = true }
+# The html sample embeds JavaScript and CSS (inline <script>/<style> and a
+# linked .js/.css), so the sample test needs those plugins to extract the
+# injected/linked chunks and snapshot the cross edges.
+rbtr-lang-css = { workspace = true }
+rbtr-lang-javascript = { workspace = true }
+[dependency-groups]
+dev = ["rbtr[test]", "rbtr-lang-css", "rbtr-lang-javascript"]

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ """HTML language plugin package."""

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/html.scm ADDED Viewed

@@ -0,0 +1,21 @@
+; Comments (`<!-- -->`).
+(comment) @comment
+(element (start_tag (tag_name) @_tag)
+  (#any-of? @_tag "head" "body" "article" "aside" "nav" "section" "header" "main" "footer" "figure" "form" "dialog" "details" "table")) @doc_section
+(script_element
+  (start_tag
+    (attribute (attribute_name) @_a
+      (quoted_attribute_value (attribute_value) @_import_module))
+    (#eq? @_a "src"))) @import
+(element
+  [(start_tag (tag_name) @_lt
+     (attribute (attribute_name) @_h
+       (quoted_attribute_value (attribute_value) @_import_module)))
+   (self_closing_tag (tag_name) @_lt
+     (attribute (attribute_name) @_h
+       (quoted_attribute_value (attribute_value) @_import_module)))]
+  (#eq? @_lt "link")
+  (#eq? @_h "href")) @import

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/injections.scm ADDED Viewed

@@ -0,0 +1,8 @@
+; Inline <script>/<style> delegate to JavaScript/CSS. External
+; <script src>/<link href> have no raw_text, so they become imports instead.
+((script_element (raw_text) @injection.content)
+  (#set! injection.language "javascript"))
+((style_element (raw_text) @injection.content)
+  (#set! injection.language "css"))

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/plugin.py ADDED Viewed

@@ -0,0 +1,110 @@
+"""HTML language plugin.
+Extracts semantic and structural elements as doc sections and cross-language
+import references, via a tree-sitter query.
+Extracted chunks::
+    <main id="content">…</main>   → doc_section "content" (named by id)
+    <nav>…</nav>                   → doc_section "nav" (named by tag)
+    <script src="app.js">          → import {module: "app.js", hint javascript}
+    <link href="styles.css">       → import {module: "styles.css", hint css}
+Element chunks cover `head`, `body`, sectioning content, landmarks, and
+self-contained units; nested elements are each extracted (overlapping, like a
+class and its methods). A file with none of these is left to the engine's
+presence handling. Inline `<script>`/`<style>` delegate to JavaScript/CSS via
+`injection_query`; external `<script src>`/`<link href>` become import edges.
+"""
+from __future__ import annotations
+from typing import TYPE_CHECKING
+from rbtr.domain.models import ImportMeta
+from rbtr.languages.registration import (
+    ImportResolver,
+    LanguageRegistration,
+    NameResolver,
+    QueryExtraction,
+    load_query,
+)
+if TYPE_CHECKING:
+    from tree_sitter import Node
+# Elements that hold meaning of their own: the document containers, HTML5
+# sectioning content and landmarks, and self-contained units. Named by their
+# `id` when present, else by tag.
+# Inline <script>/<style> delegate to JavaScript/CSS. External <script src>/
+# <link href> have no raw_text, so they are skipped here and become imports.
+def _get_attr(start_tag: Node, attr_name: str) -> str | None:
+    """Extract an attribute value from a start_tag node."""
+    for child in start_tag.children:
+        if child.type != "attribute":
+            continue
+        name_node = None
+        value_node = None
+        for gc in child.children:
+            if gc.type == "attribute_name" and gc.text:
+                name_node = gc
+            elif gc.type == "quoted_attribute_value":
+                for vg in gc.children:
+                    if vg.type == "attribute_value" and vg.text:
+                        value_node = vg
+        if (
+            name_node is not None
+            and value_node is not None
+            and name_node.text == attr_name.encode()
+        ):
+            text = value_node.text
+            return text.decode("utf-8", errors="replace") if text else None
+    return None
+# ── Plugin ───────────────────────────────────────────────────────────
+html = LanguageRegistration(
+    id="html",
+    extensions=frozenset({".html", ".htm"}),
+    grammar_module="tree_sitter_html",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "html"),
+    ),
+    injection_query=load_query(__package__, "injections"),
+    import_targets=frozenset({"javascript", "typescript", "css"}),
+    extraction_serial=3,
+)
+@html.name_extractor
+def _element_name(
+    resolver: NameResolver, capture_name: str, node: Node, captures: dict[str, list[Node]]
+) -> str:
+    """Name a semantic element by its `id`, else its tag; others by default."""
+    if capture_name != "doc_section":
+        return resolver(capture_name, node, captures)
+    start_tag = next((c for c in node.children if c.type == "start_tag"), None)
+    if start_tag is not None:
+        elem_id = _get_attr(start_tag, "id")
+        if elem_id:
+            return elem_id
+    tag_nodes = captures.get("_tag")
+    if tag_nodes and tag_nodes[0].text:
+        return tag_nodes[0].text.decode()
+    return ""
+@html.import_extractor
+def _import_meta(
+    resolver: ImportResolver, node: Node, captures: dict[str, list[Node]]
+) -> ImportMeta:
+    """Import metadata with a language hint from the element kind."""
+    meta = resolver(node, captures)
+    meta.language_hint = "javascript" if node.type == "script_element" else "css"
+    return meta

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/py.typed ADDED Viewed

File without changes

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/__init__.py ADDED Viewed

File without changes

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/__snapshots__/test_samples/test_edges_match_snapshot.json ADDED Viewed

@@ -0,0 +1,5 @@
+[
+  "html.html::<link rel=\"stylesheet\" href=\"styles.css\"> -> styles.css::.greeter [imports]",
+  "html.html::<script src=\"greeter.js\"></script> -> greeter.js::greet [imports]",
+  "pages/about.html::<script src=\"about.js\"></script> -> pages/about.js::describe [imports]"
+]

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/__snapshots__/test_samples/test_extraction_matches_snapshot.json ADDED Viewed

@@ -0,0 +1,382 @@
+[
+  {
+    "blob_sha": "sha1",
+    "file_path": "greeter.js",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "javascript",
+    "file_language": "javascript",
+    "content": "// Client-side greeter.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "1086b120f17a34b9"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "greeter.js",
+    "kind": "function",
+    "name": "greet",
+    "scope": "",
+    "language": "javascript",
+    "file_language": "javascript",
+    "content": "function greet(name) {\n  return `Hello, ${name}`;\n}",
+    "line_start": 2,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "0622b12891ac9cdc"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<!-- Greeter page. The HTML plugin extracts <script src>/<link href>\n     as imports (with a language hint) and major <body> elements as\n     doc sections. -->",
+    "line_start": 2,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "df0cb4650d419a7c"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "head",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<head>\n    <title>Greeter</title>\n    <link rel=\"stylesheet\" href=\"styles.css\">\n    <script src=\"greeter.js\"></script>\n    <style>\n      .greeter {\n        font-family: system-ui;\n      }\n    </style>\n  </head>",
+    "line_start": 6,
+    "line_end": 15,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "8b6caffda7ad3b29"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "import",
+    "name": "<link rel=\"stylesheet\" href=\"styles.css\">",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<link rel=\"stylesheet\" href=\"styles.css\">\n    ",
+    "line_start": 8,
+    "line_end": 9,
+    "metadata": {
+      "module": "styles.css",
+      "names": "",
+      "dots": "",
+      "language_hint": "css"
+    },
+    "id": "74784d330d51707b"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "import",
+    "name": "<script src=\"greeter.js\"></script>",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<script src=\"greeter.js\"></script>",
+    "line_start": 9,
+    "line_end": 9,
+    "metadata": {
+      "module": "greeter.js",
+      "names": "",
+      "dots": "",
+      "language_hint": "javascript"
+    },
+    "id": "da346ac121464c2b"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "body",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<body>\n    <header class=\"page-header\">\n      <h1>Greeter</h1>\n    </header>\n    <main id=\"content\">\n      <section id=\"intro\">\n        <p>Format greetings for named recipients.</p>\n      </section>\n    </main>\n    <footer>\n      <small>Greeter &mdash; a greetings library.</small>\n    </footer>\n    <script>\n      function init() {\n        return greet(\"world\");\n      }\n    </script>\n  </body>",
+    "line_start": 16,
+    "line_end": 33,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "8c9ed79d9778bcb8"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "header",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<header class=\"page-header\">\n      <h1>Greeter</h1>\n    </header>",
+    "line_start": 17,
+    "line_end": 19,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "be2a2586545ab335"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "content",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<main id=\"content\">\n      <section id=\"intro\">\n        <p>Format greetings for named recipients.</p>\n      </section>\n    </main>",
+    "line_start": 20,
+    "line_end": 24,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "a55b5c4e1e5c6f38"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "intro",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<section id=\"intro\">\n        <p>Format greetings for named recipients.</p>\n      </section>",
+    "line_start": 21,
+    "line_end": 23,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "2633ecb762f41b95"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "doc_section",
+    "name": "footer",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<footer>\n      <small>Greeter &mdash; a greetings library.</small>\n    </footer>",
+    "line_start": 25,
+    "line_end": 27,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "b036defcfc351337"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "css",
+    "file_language": "html",
+    "content": ".greeter {\n        font-family: system-ui;\n      }",
+    "line_start": 11,
+    "line_end": 13,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "722491d8d6786030"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "html.html",
+    "kind": "function",
+    "name": "init",
+    "scope": "",
+    "language": "javascript",
+    "file_language": "html",
+    "content": "function init() {\n        return greet(\"world\");\n      }",
+    "line_start": 29,
+    "line_end": 31,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "ab46b1ed9ad7e266"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.html",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<!-- Linked from html.html. Its script src is a bare sibling, which only\n     resolves relative to this directory. -->",
+    "line_start": 1,
+    "line_end": 2,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "685e10d015c11d95"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.html",
+    "kind": "doc_section",
+    "name": "head",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<head>\n    <script src=\"about.js\"></script>\n  </head>",
+    "line_start": 4,
+    "line_end": 6,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "3b7525e08faf54be"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.html",
+    "kind": "import",
+    "name": "<script src=\"about.js\"></script>",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<script src=\"about.js\"></script>",
+    "line_start": 5,
+    "line_end": 5,
+    "metadata": {
+      "module": "about.js",
+      "names": "",
+      "dots": "",
+      "language_hint": "javascript"
+    },
+    "id": "869b48c31de20a5d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.html",
+    "kind": "doc_section",
+    "name": "body",
+    "scope": "",
+    "language": "html",
+    "file_language": "html",
+    "content": "<body>\n    <h1>About</h1>\n  </body>",
+    "line_start": 7,
+    "line_end": 9,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "8c81895e570fa47d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.js",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "javascript",
+    "file_language": "javascript",
+    "content": "// Referenced from pages/about.html as a bare sibling.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "1086b120f17a34b9"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "pages/about.js",
+    "kind": "function",
+    "name": "describe",
+    "scope": "",
+    "language": "javascript",
+    "file_language": "javascript",
+    "content": "function describe() {\n  return \"about\";\n}",
+    "line_start": 2,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "e8f56e596019719c"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "styles.css",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ".greeter {\n  color: #333;\n}",
+    "line_start": 1,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "6f956de079e5ad55"
+  }
+]

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/cases_extraction.py ADDED Viewed

@@ -0,0 +1,31 @@
+"""HTML extraction test cases."""
+from __future__ import annotations
+from pytest_cases import case
+type SymbolCase = tuple[str, str, list[tuple[str, str, str]]]
+@case(tags=["symbol"])
+def case_html_semantic_elements() -> SymbolCase:
+    """HTML names an element by its id (even beside a class), else its tag."""
+    src = """\
+<html>
+<body>
+  <main id="content"><p>Hello</p></main>
+  <article class="post" id="first">Text</article>
+  <nav>Links</nav>
+</body>
+</html>
+"""
+    return (
+        "html",
+        src,
+        [
+            ("doc_section", "body", ""),
+            ("doc_section", "content", ""),
+            ("doc_section", "first", ""),
+            ("doc_section", "nav", ""),
+        ],
+    )

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/samples/html/greeter.js ADDED Viewed

@@ -0,0 +1,4 @@
+// Client-side greeter.
+export function greet(name) {
+  return `Hello, ${name}`;
+}

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/samples/html/html.html ADDED Viewed

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<!-- Greeter page. The HTML plugin extracts <script src>/<link href>
+     as imports (with a language hint) and major <body> elements as
+     doc sections. -->
+<html lang="en">
+  <head>
+    <title>Greeter</title>
+    <link rel="stylesheet" href="styles.css">
+    <script src="greeter.js"></script>
+    <style>
+      .greeter {
+        font-family: system-ui;
+      }
+    </style>
+  </head>
+  <body>
+    <header class="page-header">
+      <h1>Greeter</h1>
+    </header>
+    <main id="content">
+      <section id="intro">
+        <p>Format greetings for named recipients.</p>
+      </section>
+    </main>
+    <footer>
+      <small>Greeter &mdash; a greetings library.</small>
+    </footer>
+    <script>
+      function init() {
+        return greet("world");
+      }
+    </script>
+  </body>
+</html>

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/samples/html/pages/about.html ADDED Viewed

@@ -0,0 +1,10 @@
+<!-- Linked from html.html. Its script src is a bare sibling, which only
+     resolves relative to this directory. -->
+<html>
+  <head>
+    <script src="about.js"></script>
+  </head>
+  <body>
+    <h1>About</h1>
+  </body>
+</html>

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/samples/html/pages/about.js ADDED Viewed

@@ -0,0 +1,4 @@
+// Referenced from pages/about.html as a bare sibling.
+export function describe() {
+  return "about";
+}

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/samples/html/styles.css ADDED Viewed

@@ -0,0 +1,3 @@
+.greeter {
+  color: #333;
+}

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/test_extraction.py ADDED Viewed

@@ -0,0 +1,78 @@
+"""HTML extraction tests.
+The symbol case (`cases_extraction.py`) drives the shared check; the functions
+below pin HTML's element naming and its `<script src>` / `<link href>` import
+and non-semantic-presence edge behaviour.
+"""
+from __future__ import annotations
+from pytest_cases import parametrize_with_cases
+from rbtr.domain.models import ChunkKind
+from rbtr.git import FileEntry
+from rbtr.languages.extract import extract_file
+@parametrize_with_cases("lang, source, expected", cases=".cases_extraction", has_tag="symbol")
+def test_extracts_expected_symbols(lang: str, source: str, expected: list) -> None:
+    """Each expected (kind, name, scope) tuple appears in the output."""
+    chunks = extract_file(FileEntry("input", "sha1", source.encode()), lang)
+    symbols = [(c.kind, c.name, c.scope) for c in chunks]
+    for exp in expected:
+        assert exp in symbols, f"expected {exp} not found in {symbols}"
+def test_html_non_semantic_only_emits_presence() -> None:
+    """HTML with no head/body/semantic element yields only a presence chunk.
+    A non-semantic wrapper (`<div>`) is not elevated, so no searchable
+    doc_section is produced; the engine appends one content-less host chunk.
+    """
+    chunks = extract_file(FileEntry("input", "sha1", b"<div>hello</div>"), "html")
+    assert [c.kind for c in chunks if c.content] == []
+    assert [c.language for c in chunks] == ["html"]
+def test_html_script_src_produces_import() -> None:
+    """HTML <script src> produces an import chunk."""
+    src = """\
+<html>
+<head><script src="app.js"></script></head>
+<body><p>hello</p></body>
+</html>
+"""
+    chunks = extract_file(FileEntry("input", "sha1", src.encode()), "html")
+    imports = [c for c in chunks if c.kind == ChunkKind.IMPORT]
+    assert len(imports) == 1
+    assert imports[0].metadata.module == "app.js"
+    assert imports[0].metadata.language_hint == "javascript"
+def test_html_link_href_produces_import() -> None:
+    """HTML <link href> produces an import chunk."""
+    src = """\
+<html>
+<head><link rel="stylesheet" href="styles.css"></head>
+<body><p>hello</p></body>
+</html>
+"""
+    chunks = extract_file(FileEntry("input", "sha1", src.encode()), "html")
+    imports = [c for c in chunks if c.kind == ChunkKind.IMPORT]
+    assert len(imports) == 1
+    assert imports[0].metadata.module == "styles.css"
+    assert imports[0].metadata.language_hint == "css"
+def test_html_self_closing_link_produces_import() -> None:
+    """An XHTML-style self-closing `<link ... />` produces an import."""
+    src = """\
+<html>
+<head><link rel="stylesheet" href="styles.css" /></head>
+<body><p>hello</p></body>
+</html>
+"""
+    chunks = extract_file(FileEntry("input", "sha1", src.encode()), "html")
+    imports = [c for c in chunks if c.kind == ChunkKind.IMPORT]
+    assert len(imports) == 1
+    assert imports[0].metadata.module == "styles.css"

rbtr_lang_html-2026.9.0.dev1/src/rbtr_lang_html/tests/test_samples.py ADDED Viewed

@@ -0,0 +1,81 @@
+"""HTML sample extraction: the `samples/html/` project through the real pipeline.
+The sample links a `.js` and a `.css` and embeds inline `<script>`/`<style>`,
+so the javascript and css plugins (dev dependencies) extract the linked and
+injected chunks, and the edge snapshot captures the cross-file links.
+"""
+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 render_edges
+if TYPE_CHECKING:
+    from syrupy.assertion import SnapshotAssertion
+@pytest.fixture
+def project() -> list[tuple[str, str]]:
+    """The `(relative path, text)` files of the `samples/html/` project."""
+    root = Path(__file__).parent / "samples" / "html"
+    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]:
+    """Chunks from every project file, each via the real `extract_file`.
+    A file is extracted as its own detected language, so the project spans
+    html, javascript, and css.
+    """
+    manager = get_manager()
+    out: list[Chunk] = []
+    for path, text in project:
+        lang = manager.detect_language(path) or "html"
+        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]:
+    """Import edges inferred across the project's files."""
+    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 sample exercises HTML's import, doc-section, and (injected) function chunks."""
+    kinds = {c.kind for c in chunks}
+    assert {ChunkKind.IMPORT, ChunkKind.DOC_SECTION, ChunkKind.FUNCTION, ChunkKind.COMMENT} <= kinds
+def test_parses_cleanly(project: list[tuple[str, str]]) -> None:
+    """Every project file is valid source — no tree-sitter ERROR/MISSING nodes."""
+    manager = get_manager()
+    for path, text in project:
+        grammar = manager.grammar(manager.detect_language(path) or "html")
+        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