rbtr-lang-css 2026.9.0.dev1__tar.gz

rbtr_lang_css-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_css-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-css
+Version: 2026.9.0.dev1
+Summary: rbtr — CSS language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,css
+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-css
+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-css#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-css
+
+CSS support for [rbtr]. Optional plugin — install with
+`pip install rbtr[css]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+One chunk per top-level rule set, keyed by its selector. A rule set is a
+named collection of property declarations, so it maps to a **class** (the
+same shape SQL's `CREATE TABLE` takes) — as do `@media` and `@keyframes`
+blocks. `@charset` becomes a config key, `@import` statements become imports
+(for cross-language edges), and custom properties become variables.
+
+- **Rule sets & at-rule blocks** — `body { … }`, `.header { … }`, `@media`,
+  `@keyframes` → classes (named by selector; `@media` carries no name).
+- **Directives** — `@charset` → config key.
+- **Imports** — `@import url("reset.css")` → an import chunk carrying the
+  referenced path, so an edge links to the imported stylesheet.
+- **Custom properties** — `--brand: #333;` → variables.
+
+## Chunks produced
+
+`name` is the selector; `scope` is the ancestor rule-set selectors for a
+nested rule set (CSS nesting), else empty.
+
+```css
+body { color: #333; }              /* class "body",          scope ""      */
+.header { background: blue; }      /* class ".header",       scope ""      */
+.card { .title { … } }             /* class ".title",        scope ".card" */
+@media (max-width: 600px) { … }    /* class, unnamed                      */
+@keyframes slide { … }             /* class "slide"                       */
+@import url("reset.css");          /* import, metadata {module: reset.css} */
+:root { --brand: #333; }           /* variable "--brand"                   */
+```
+
+## Embedded / injected chunks
+
+None. CSS does not embed other languages (it is itself embedded by HTML and
+the SFC plugins).
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-css` grammar. No dependency on other language plugins;
+its `css_nesting_scope` helper is public API that the `scss` and `less`
+plugins reuse.

rbtr_lang_css-2026.9.0.dev1/README.md

@@ -0,0 +1,47 @@
+# rbtr-lang-css
+
+CSS support for [rbtr]. Optional plugin — install with
+`pip install rbtr[css]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+One chunk per top-level rule set, keyed by its selector. A rule set is a
+named collection of property declarations, so it maps to a **class** (the
+same shape SQL's `CREATE TABLE` takes) — as do `@media` and `@keyframes`
+blocks. `@charset` becomes a config key, `@import` statements become imports
+(for cross-language edges), and custom properties become variables.
+
+- **Rule sets & at-rule blocks** — `body { … }`, `.header { … }`, `@media`,
+  `@keyframes` → classes (named by selector; `@media` carries no name).
+- **Directives** — `@charset` → config key.
+- **Imports** — `@import url("reset.css")` → an import chunk carrying the
+  referenced path, so an edge links to the imported stylesheet.
+- **Custom properties** — `--brand: #333;` → variables.
+
+## Chunks produced
+
+`name` is the selector; `scope` is the ancestor rule-set selectors for a
+nested rule set (CSS nesting), else empty.
+
+```css
+body { color: #333; }              /* class "body",          scope ""      */
+.header { background: blue; }      /* class ".header",       scope ""      */
+.card { .title { … } }             /* class ".title",        scope ".card" */
+@media (max-width: 600px) { … }    /* class, unnamed                      */
+@keyframes slide { … }             /* class "slide"                       */
+@import url("reset.css");          /* import, metadata {module: reset.css} */
+:root { --brand: #333; }           /* variable "--brand"                   */
+```
+
+## Embedded / injected chunks
+
+None. CSS does not embed other languages (it is itself embedded by HTML and
+the SFC plugins).
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-css` grammar. No dependency on other language plugins;
+its `css_nesting_scope` helper is public API that the `scss` and `less`
+plugins reuse.

rbtr_lang_css-2026.9.0.dev1/pyproject.toml

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

rbtr_lang_css-2026.9.0.dev1/pyproject.toml.orig

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["uv_build>=0.11.26,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "rbtr_lang_css"
+# No source-exclude: the plugin's tests, samples, and snapshots ship
+# with the wheel (they are the language's golden record), and css.scm
+# ships as package data.
+
+[project]
+name = "rbtr-lang-css"
+version = "2026.9.0-dev1"
+description = "rbtr — CSS 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",
+  "css",
+]
+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-css",
+]
+
+[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-css#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.
+css = "rbtr_lang_css.plugin:css"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/__init__.py

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

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/css.scm

@@ -0,0 +1,24 @@
+; Comments (`/* */`).
+(comment) @comment
+
+(rule_set
+  (selectors) @_cls_name) @class
+
+(media_statement) @class
+
+(charset_statement) @config_key
+
+(keyframes_statement
+  (keyframes_name) @_cls_name) @class
+
+(import_statement
+  (call_expression
+    (arguments
+      (string_value (string_content) @_import_module)))) @import
+
+(import_statement
+  (string_value (string_content) @_import_module)) @import
+
+(declaration
+  (property_name) @_var_name
+  (#match? @_var_name "^--")) @variable

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

@@ -0,0 +1,65 @@
+"""CSS language plugin.
+
+Splits CSS into `class` chunks — one per rule set (named by its
+selector) and one per `@media` / `@keyframes` block — via a
+tree-sitter query. `@charset` is captured as a config key,
+`@import` statements as imports for cross-language edges, and
+custom properties as variables.
+
+Extracted chunks::
+
+    body { color: #333; }           → class "body", scope ""
+    .header { background: blue; }   → class ".header", scope ""
+    @media (max-width: 600px) {}    → class, unnamed, scope ""
+    @keyframes slide { ... }        → class "slide", scope ""
+    @charset "utf-8";               → config_key, unnamed
+    @import url("reset.css");       → import, metadata {module: "reset.css"}
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from rbtr.languages.registration import (
+    LanguageRegistration,
+    QueryExtraction,
+    ScopeResolver,
+    enclosing_nodes_of_type,
+    load_query,
+)
+
+if TYPE_CHECKING:
+    from tree_sitter import Node
+
+
+def css_nesting_scope(
+    _resolver: ScopeResolver, capture_name: str, node: Node, captures: dict[str, list[Node]]
+) -> list[str]:
+    """Scope a chunk under its ancestor rule-set selectors.
+
+    Shared by the CSS family (CSS/SCSS/Less), whose rule sets nest:
+    `.card { .title { … } }` scopes `.title` under `.card`. A rule set
+    inside an `@media` block has no rule-set ancestor, so it stays
+    unscoped. Segments are outermost-first.
+    """
+    segments: list[str] = []
+    for ancestor in enclosing_nodes_of_type(node, frozenset({"rule_set"})):
+        for child in ancestor.children:
+            if child.type == "selectors" and child.text:
+                segments.append(child.text.decode("utf-8", errors="replace").strip())
+                break
+    return segments
+
+
+css = LanguageRegistration(
+    id="css",
+    extensions=frozenset({".css"}),
+    grammar_module="tree_sitter_css",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "css"),
+    ),
+    import_targets=frozenset({"css"}),
+    extraction_serial=4,
+)
+
+css.scope_extractor(css_nesting_scope)

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

@@ -0,0 +1,8 @@
+[
+  "css.css::@import \"partials/dark.css\"; -> partials/dark.css::.greeting--dark [imports]",
+  "css.css::@import \"theme.css\"; -> theme.css::--greeting-color [imports]",
+  "css.css::@import \"theme.css\"; -> theme.css:::root [imports]",
+  "css.css::@import url(\"reset.css\"); -> reset.css::* [imports]",
+  "partials/dark.css::@import \"palette.css\"; -> partials/palette.css::--ink [imports]",
+  "partials/dark.css::@import \"palette.css\"; -> partials/palette.css:::root [imports]"
+]

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

@@ -0,0 +1,382 @@
+[
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "/* Greeter styles.\n *\n * The CSS plugin extracts rule sets, @media, @charset, and @keyframes\n * as doc sections, and @import statements as imports. */",
+    "line_start": 1,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "9a0889317229f181"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "config_key",
+    "name": "",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@charset \"UTF-8\";",
+    "line_start": 6,
+    "line_end": 6,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "201b42fa975466e2"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "import",
+    "name": "@import url(\"reset.css\");",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@import url(\"reset.css\");",
+    "line_start": 8,
+    "line_end": 8,
+    "metadata": {
+      "module": "reset.css",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "cbf97254020d81bd"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "import",
+    "name": "@import \"theme.css\";",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@import \"theme.css\";",
+    "line_start": 9,
+    "line_end": 9,
+    "metadata": {
+      "module": "theme.css",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "832cecbb8b3403fe"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": ":root",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ":root {\n  --greeting-color: #333;\n}",
+    "line_start": 11,
+    "line_end": 13,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "e62985770721d590"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "variable",
+    "name": "--greeting-color",
+    "scope": ":root",
+    "language": "css",
+    "file_language": "css",
+    "content": "--greeting-color: #333;",
+    "line_start": 12,
+    "line_end": 12,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "b90cc82662414f51"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ".greeter {\n  color: var(--greeting-color);\n  font-weight: bold;\n  .greeting-label {\n    text-transform: uppercase;\n  }\n}",
+    "line_start": 15,
+    "line_end": 21,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "0e53178978ed3263"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": ".greeting-label",
+    "scope": ".greeter",
+    "language": "css",
+    "file_language": "css",
+    "content": ".greeting-label {\n    text-transform: uppercase;\n  }",
+    "line_start": 18,
+    "line_end": 20,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "32e37f98d1abb442"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": "",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@media (max-width: 600px) {\n  .greeter {\n    font-size: 14px;\n  }\n}",
+    "line_start": 23,
+    "line_end": 27,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "139fd08b20e2104e"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ".greeter {\n    font-size: 14px;\n  }",
+    "line_start": 24,
+    "line_end": 26,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "bc40befb59eb6693"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "class",
+    "name": "greeting-fade",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@keyframes greeting-fade {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}",
+    "line_start": 29,
+    "line_end": 36,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "ac5a0c0be7138359"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "css.css",
+    "kind": "import",
+    "name": "@import \"partials/dark.css\";",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@import \"partials/dark.css\";",
+    "line_start": 38,
+    "line_end": 38,
+    "metadata": {
+      "module": "partials/dark.css",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "8b2906e0d46c28e6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.css",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "/* Imported by css.css. Imports its own sibling by bare name, which only\n   resolves relative to this directory. */",
+    "line_start": 1,
+    "line_end": 2,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "30e3b78720e6932b"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.css",
+    "kind": "import",
+    "name": "@import \"palette.css\";",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "@import \"palette.css\";",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "palette.css",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "11011a8ec682e572"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.css",
+    "kind": "class",
+    "name": ".greeting--dark",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ".greeting--dark {\n  color: var(--ink);\n}",
+    "line_start": 5,
+    "line_end": 7,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "7beceb826171befc"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/palette.css",
+    "kind": "class",
+    "name": ":root",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "/* Imported by partials/dark.css as a bare sibling. */\n:root {\n  --ink: #eeeeee;\n}",
+    "line_start": 1,
+    "line_end": 4,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "acdf532d0945bb9d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/palette.css",
+    "kind": "variable",
+    "name": "--ink",
+    "scope": ":root",
+    "language": "css",
+    "file_language": "css",
+    "content": "--ink: #eeeeee;",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "ec54218724ce0cb6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "reset.css",
+    "kind": "class",
+    "name": "*",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": "* {\n  margin: 0;\n}",
+    "line_start": 1,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "f3d13f9312e11df2"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "theme.css",
+    "kind": "class",
+    "name": ":root",
+    "scope": "",
+    "language": "css",
+    "file_language": "css",
+    "content": ":root {\n  --greeting-color: #333;\n}",
+    "line_start": 1,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "53ac44be42ab8233"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "theme.css",
+    "kind": "variable",
+    "name": "--greeting-color",
+    "scope": ":root",
+    "language": "css",
+    "file_language": "css",
+    "content": "--greeting-color: #333;",
+    "line_start": 2,
+    "line_end": 2,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "dfc190708e8af07c"
+  }
+]

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/cases_extraction.py

@@ -0,0 +1,33 @@
+"""CSS extraction test cases.
+
+Each `@case` returns test data consumed by `test_extraction.py` via
+`pytest-cases`. See the plugin docstring for the full source→chunk mapping.
+"""
+
+from __future__ import annotations
+
+from pytest_cases import case
+
+type SymbolCase = tuple[str, str, list[tuple[str, str, str]]]
+
+
+@case(tags=["symbol"])
+def case_css_rule_sets() -> SymbolCase:
+    """CSS splits by rule sets."""
+    src = """\
+body {
+  color: #333;
+}
+
+.header {
+  background: blue;
+}
+"""
+    return (
+        "css",
+        src,
+        [
+            ("class", "body", ""),
+            ("class", ".header", ""),
+        ],
+    )

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/samples/css/css.css

@@ -0,0 +1,38 @@
+/* Greeter styles.
+ *
+ * The CSS plugin extracts rule sets, @media, @charset, and @keyframes
+ * as doc sections, and @import statements as imports. */
+
+@charset "UTF-8";
+
+@import url("reset.css");
+@import "theme.css";
+
+:root {
+  --greeting-color: #333;
+}
+
+.greeter {
+  color: var(--greeting-color);
+  font-weight: bold;
+  .greeting-label {
+    text-transform: uppercase;
+  }
+}
+
+@media (max-width: 600px) {
+  .greeter {
+    font-size: 14px;
+  }
+}
+
+@keyframes greeting-fade {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@import "partials/dark.css";

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/samples/css/partials/dark.css

@@ -0,0 +1,7 @@
+/* Imported by css.css. Imports its own sibling by bare name, which only
+   resolves relative to this directory. */
+@import "palette.css";
+
+.greeting--dark {
+  color: var(--ink);
+}

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/samples/css/partials/palette.css

@@ -0,0 +1,4 @@
+/* Imported by partials/dark.css as a bare sibling. */
+:root {
+  --ink: #eeeeee;
+}

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/samples/css/reset.css

@@ -0,0 +1,3 @@
+* {
+  margin: 0;
+}

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/samples/css/theme.css

@@ -0,0 +1,3 @@
+:root {
+  --greeting-color: #333;
+}

rbtr_lang_css-2026.9.0.dev1/src/rbtr_lang_css/tests/test_extraction.py

@@ -0,0 +1,34 @@
+"""CSS extraction tests.
+
+Symbol cases (`cases_extraction.py`) drive the shared check; the function
+at the end pins CSS's `@import` 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_css_import_produces_import_chunk() -> None:
+    """CSS @import url(...) produces an import chunk."""
+    src = """\
+@import url("reset.css");
+body { color: #333; }
+"""
+    chunks = extract_file(FileEntry("input", "sha1", src.encode()), "css")
+    imports = [c for c in chunks if c.kind == ChunkKind.IMPORT]
+    assert len(imports) == 1
+    assert imports[0].metadata.module == "reset.css"

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

@@ -0,0 +1,82 @@
+"""CSS sample extraction: the `samples/css/` project through the real pipeline.
+
+The snapshots are the golden record of what CSS extraction produces.
+Engine-wide invariants are covered once in core.
+"""
+
+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/css/` project."""
+    root = Path(__file__).parent / "samples" / "css"
+    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`."""
+    manager = get_manager()
+    out: list[Chunk] = []
+    for path, text in project:
+        lang = manager.detect_language(path) or "css"
+        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 CSS's class, config-key, import, and variable chunks."""
+    kinds = {c.kind for c in chunks}
+    assert {
+        ChunkKind.CLASS,
+        ChunkKind.CONFIG_KEY,
+        ChunkKind.IMPORT,
+        ChunkKind.VARIABLE,
+        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 "css")
+        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