rbtr-lang-scss 2026.9.0.dev1__tar.gz

rbtr_lang_scss-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_scss-2026.9.0.dev1/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: rbtr-lang-scss
+Version: 2026.9.0.dev1
+Summary: rbtr — SCSS/Sass language plugin
+Keywords: code-search,code-index,tree-sitter,static-analysis,semantic-search,developer-tools,scss,sass
+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-css==2026.9.0.dev1
+Requires-Dist: tree-sitter-scss
+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-scss#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-scss
+
+SCSS / Sass support for [rbtr]. Optional plugin — install with
+`pip install rbtr[scss]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+SCSS extends CSS with the Sass preprocessor constructs. Definitions map onto
+rbtr's capture conventions by shape:
+
+- **Variables** — `$`-prefixed declarations (`$primary: #333;`).
+- **Routines** — `@mixin` and `@function` definitions → functions.
+- **Rule sets & at-rule blocks** — selectors (incl. `%placeholder`), `@media`,
+  `@keyframes` → classes (a named collection of declarations).
+- **Directives** — `@charset` → config key.
+- **Imports** — `@use` / `@forward` / `@import` → imports (for cross-file
+  edges).
+
+## Chunks produced
+
+`name` is the declaration/selector; `scope` is the ancestor rule-set
+selectors for a nested rule (CSS-family nesting), else empty.
+
+```scss
+$primary: #333;                /* variable "$primary"                   */
+@mixin flex($dir) { … }        /* function "flex"                       */
+@function rem($px) { … }       /* function "rem"                        */
+%card { … }                    /* class "%card"                         */
+.btn { … }                     /* class ".btn"                          */
+@keyframes slide { … }         /* class "slide"                         */
+@use "config";                 /* import, metadata {module: "config"}   */
+```
+
+## Embedded / injected chunks
+
+None. SCSS does not embed other languages (it is embedded by the SFC plugins).
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-scss` grammar. Depends on **rbtr-lang-css** — it reuses
+that plugin's public `css_nesting_scope` helper for CSS-family rule nesting.

rbtr_lang_scss-2026.9.0.dev1/README.md

@@ -0,0 +1,43 @@
+# rbtr-lang-scss
+
+SCSS / Sass support for [rbtr]. Optional plugin — install with
+`pip install rbtr[scss]`.
+
+[rbtr]: https://github.com/janrito/rbtr/tree/main/packages/rbtr#readme
+
+## What it ingests
+
+SCSS extends CSS with the Sass preprocessor constructs. Definitions map onto
+rbtr's capture conventions by shape:
+
+- **Variables** — `$`-prefixed declarations (`$primary: #333;`).
+- **Routines** — `@mixin` and `@function` definitions → functions.
+- **Rule sets & at-rule blocks** — selectors (incl. `%placeholder`), `@media`,
+  `@keyframes` → classes (a named collection of declarations).
+- **Directives** — `@charset` → config key.
+- **Imports** — `@use` / `@forward` / `@import` → imports (for cross-file
+  edges).
+
+## Chunks produced
+
+`name` is the declaration/selector; `scope` is the ancestor rule-set
+selectors for a nested rule (CSS-family nesting), else empty.
+
+```scss
+$primary: #333;                /* variable "$primary"                   */
+@mixin flex($dir) { … }        /* function "flex"                       */
+@function rem($px) { … }       /* function "rem"                        */
+%card { … }                    /* class "%card"                         */
+.btn { … }                     /* class ".btn"                          */
+@keyframes slide { … }         /* class "slide"                         */
+@use "config";                 /* import, metadata {module: "config"}   */
+```
+
+## Embedded / injected chunks
+
+None. SCSS does not embed other languages (it is embedded by the SFC plugins).
+
+## Grammar & dependencies
+
+Uses the `tree-sitter-scss` grammar. Depends on **rbtr-lang-css** — it reuses
+that plugin's public `css_nesting_scope` helper for CSS-family rule nesting.

rbtr_lang_scss-2026.9.0.dev1/pyproject.toml

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

rbtr_lang_scss-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_scss"
+# No source-exclude: the plugin's tests, samples, and snapshots ship
+# with the wheel (they are the language's golden record), and scss.scm
+# ships as package data.
+
+[project]
+name = "rbtr-lang-scss"
+version = "2026.9.0-dev1"
+description = "rbtr — SCSS/Sass 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",
+  "scss",
+  "sass",
+]
+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",
+  # Reuses css_nesting_scope from the css plugin (CSS-family nesting).
+  "rbtr-lang-css==2026.9.0-dev1",
+  "tree-sitter-scss",
+]
+
+[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-scss#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.
+scss = "rbtr_lang_scss.plugin:scss"
+
+[tool.uv.sources]
+rbtr = { workspace = true }
+rbtr-lang-css = { workspace = true }
+
+[dependency-groups]
+dev = ["rbtr[test]"]

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

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

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

@@ -0,0 +1,43 @@
+"""SCSS / Sass language plugin.
+
+Extends CSS extraction with the Sass preprocessor constructs,
+via a tree-sitter query. Rule sets (incl. `%placeholder`
+selectors) and `@media`/`@keyframes` blocks are captured as
+classes; `@charset` as a config key; `$`-prefixed declarations
+as variables; `@mixin` and `@function` definitions as functions;
+`@use`/`@forward`/`@import` as imports for cross-file edges.
+
+Extracted chunks::
+
+    $primary: #333;              → variable "$primary"
+    @mixin flex($dir) { ... }    → function "flex"
+    @function rem($px) { ... }   → function "rem"
+    %card { ... }                → class "%card"
+    .btn { ... }                 → class ".btn"
+    @keyframes slide { ... }     → class "slide"
+    @use "config";               → import, metadata {module: "config"}
+"""
+
+from __future__ import annotations
+
+from rbtr.languages.registration import (
+    LanguageRegistration,
+    QueryExtraction,
+    build_quoted_import,
+    load_query,
+)
+from rbtr_lang_css.plugin import css_nesting_scope
+
+scss = LanguageRegistration(
+    id="scss",
+    extensions=frozenset({".scss"}),
+    grammar_module="tree_sitter_scss",
+    extraction=QueryExtraction(
+        query=load_query(__package__, "scss"),
+    ),
+    import_targets=frozenset({"css", "scss", "less"}),
+    extraction_serial=3,
+)
+
+scss.scope_extractor(css_nesting_scope)
+scss.import_extractor(build_quoted_import)

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/scss.scm

@@ -0,0 +1,32 @@
+
+; Comments (SCSS: `/* */` is `comment`, `//` is `js_comment`).
+[(comment) (js_comment)] @comment
+
+(declaration
+  (property_name) @_var_name
+  (#match? @_var_name "^[$]")) @variable
+
+(mixin_statement
+  (identifier) @_fn_name) @function
+
+(function_statement
+  (identifier) @_fn_name) @function
+
+(rule_set
+  (selectors) @_cls_name) @class
+
+(media_statement) @class
+
+(charset_statement) @config_key
+
+(keyframes_statement
+  (keyframes_name) @_cls_name) @class
+
+(use_statement
+  (string_value) @_import_module) @import
+
+(forward_statement
+  (string_value) @_import_module) @import
+
+(import_statement
+  (string_value) @_import_module) @import

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

@@ -0,0 +1,7 @@
+[
+  "partials/dark.scss::@use \"tokens\"; -> partials/tokens.scss::$ink [imports]",
+  "scss.scss::@forward \"theme\"; -> theme.scss::$radius [imports]",
+  "scss.scss::@import \"reset\"; -> reset.scss::* [imports]",
+  "scss.scss::@use \"config\"; -> config.scss::$brand [imports]",
+  "scss.scss::@use \"partials/dark\"; -> partials/dark.scss::.greeting--dark [imports]"
+]

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

@@ -0,0 +1,496 @@
+[
+  {
+    "blob_sha": "sha1",
+    "file_path": "config.scss",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Imported by scss.scss via `@use \"config\"`.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "10b9e0c7ef48dbc6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "config.scss",
+    "kind": "variable",
+    "name": "$brand",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "$brand: #00aa77;",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "52e340a0eb1936f5"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.scss",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Used by scss.scss. Uses 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": "c6843977ca6a1f31"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.scss",
+    "kind": "import",
+    "name": "@use \"tokens\";",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@use \"tokens\";",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "tokens",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "fb5ca20e552f6628"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/dark.scss",
+    "kind": "class",
+    "name": ".greeting--dark",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": ".greeting--dark {\n  color: tokens.$ink;\n}",
+    "line_start": 5,
+    "line_end": 7,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "1f9af74673427ce0"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "partials/tokens.scss",
+    "kind": "variable",
+    "name": "$ink",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Used by partials/dark.scss as a bare sibling.\n$ink: #eeeeee;",
+    "line_start": 1,
+    "line_end": 2,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "6422526823945bc5"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "reset.scss",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Imported by scss.scss via `@import \"reset\"`.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "10b9e0c7ef48dbc6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "reset.scss",
+    "kind": "class",
+    "name": "*",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "* {\n  margin: 0;\n  padding: 0;\n}",
+    "line_start": 3,
+    "line_end": 6,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "719eb53fd28a4226"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Greeter theme (SCSS).\n//\n// The SCSS plugin extracts $-variables, @mixin and @function definitions,\n// rule sets (including %placeholders and nested rules), @media/@charset/\n// @keyframes as doc sections, and @use/@forward/@import as imports.",
+    "line_start": 1,
+    "line_end": 5,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "cff1e9ff754e1d2d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "config_key",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@charset \"UTF-8\";",
+    "line_start": 7,
+    "line_end": 7,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "1acf400ee24cb6b3"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "import",
+    "name": "@use \"config\";",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@use \"config\";",
+    "line_start": 9,
+    "line_end": 9,
+    "metadata": {
+      "module": "config",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "5b65dc8850d3d6d5"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "import",
+    "name": "@forward \"theme\";",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@forward \"theme\";",
+    "line_start": 10,
+    "line_end": 10,
+    "metadata": {
+      "module": "theme",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "d5fd0a10aa078b1b"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "import",
+    "name": "@import \"reset\";",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@import \"reset\";",
+    "line_start": 11,
+    "line_end": 11,
+    "metadata": {
+      "module": "reset",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "b8bb8586a8f0b2f3"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "variable",
+    "name": "$primary",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "$primary: #333;",
+    "line_start": 13,
+    "line_end": 13,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "eb470061d1a7b0d7"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "variable",
+    "name": "$spacing",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "$spacing: 8px;",
+    "line_start": 14,
+    "line_end": 14,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "f2f236eb0be1b193"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "function",
+    "name": "flex-center",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@mixin flex-center($direction: row) {\n  display: flex;\n  flex-direction: $direction;\n  align-items: center;\n}",
+    "line_start": 16,
+    "line_end": 20,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "e0552982f0d82fec"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "function",
+    "name": "rem",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@function rem($px) {\n  @return $px * 1rem;\n}",
+    "line_start": 22,
+    "line_end": 24,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "d473ca15da3fdc5f"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": "%card-base",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "%card-base {\n  border-radius: 4px;\n  padding: $spacing;\n}",
+    "line_start": 26,
+    "line_end": 29,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "8f095b47d2535eb6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": ".greeter {\n  color: $primary;\n  @include flex-center(column);\n\n  &:hover {\n    color: blue;\n  }\n}",
+    "line_start": 31,
+    "line_end": 38,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "a2cb287a9ded83d2"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": "&:hover",
+    "scope": ".greeter",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "&:hover {\n    color: blue;\n  }",
+    "line_start": 35,
+    "line_end": 37,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "c80bf42a8e0a332e"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@media (max-width: 600px) {\n  .greeter {\n    font-size: rem(14);\n  }\n}",
+    "line_start": 40,
+    "line_end": 44,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "458eced79f685c08"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": ".greeter",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": ".greeter {\n    font-size: rem(14);\n  }",
+    "line_start": 41,
+    "line_end": 43,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "065098f107e87ec7"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "class",
+    "name": "greeting-fade",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@keyframes greeting-fade {\n  from {\n    opacity: 0;\n  }\n  to {\n    opacity: 1;\n  }\n}",
+    "line_start": 46,
+    "line_end": 53,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "a56c5673f0ac04b8"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "scss.scss",
+    "kind": "import",
+    "name": "@use \"partials/dark\";",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "@use \"partials/dark\";",
+    "line_start": 55,
+    "line_end": 55,
+    "metadata": {
+      "module": "partials/dark",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "f356c78c2fc2927d"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "theme.scss",
+    "kind": "comment",
+    "name": "",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "// Re-exported by scss.scss via `@forward \"theme\"`.",
+    "line_start": 1,
+    "line_end": 1,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "10b9e0c7ef48dbc6"
+  },
+  {
+    "blob_sha": "sha1",
+    "file_path": "theme.scss",
+    "kind": "variable",
+    "name": "$radius",
+    "scope": "",
+    "language": "scss",
+    "file_language": "scss",
+    "content": "$radius: 6px;",
+    "line_start": 3,
+    "line_end": 3,
+    "metadata": {
+      "module": "",
+      "names": "",
+      "dots": "",
+      "language_hint": ""
+    },
+    "id": "1780202d18786446"
+  }
+]

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/config.scss

@@ -0,0 +1,3 @@
+// Imported by scss.scss via `@use "config"`.
+
+$brand: #00aa77;

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/partials/dark.scss

@@ -0,0 +1,7 @@
+// Used by scss.scss. Uses its own sibling by bare name, which only
+// resolves relative to this directory.
+@use "tokens";
+
+.greeting--dark {
+  color: tokens.$ink;
+}

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/partials/tokens.scss

@@ -0,0 +1,2 @@
+// Used by partials/dark.scss as a bare sibling.
+$ink: #eeeeee;

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/reset.scss

@@ -0,0 +1,6 @@
+// Imported by scss.scss via `@import "reset"`.
+
+* {
+  margin: 0;
+  padding: 0;
+}

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/scss.scss

@@ -0,0 +1,55 @@
+// Greeter theme (SCSS).
+//
+// The SCSS plugin extracts $-variables, @mixin and @function definitions,
+// rule sets (including %placeholders and nested rules), @media/@charset/
+// @keyframes as doc sections, and @use/@forward/@import as imports.
+
+@charset "UTF-8";
+
+@use "config";
+@forward "theme";
+@import "reset";
+
+$primary: #333;
+$spacing: 8px;
+
+@mixin flex-center($direction: row) {
+  display: flex;
+  flex-direction: $direction;
+  align-items: center;
+}
+
+@function rem($px) {
+  @return $px * 1rem;
+}
+
+%card-base {
+  border-radius: 4px;
+  padding: $spacing;
+}
+
+.greeter {
+  color: $primary;
+  @include flex-center(column);
+
+  &:hover {
+    color: blue;
+  }
+}
+
+@media (max-width: 600px) {
+  .greeter {
+    font-size: rem(14);
+  }
+}
+
+@keyframes greeting-fade {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@use "partials/dark";

rbtr_lang_scss-2026.9.0.dev1/src/rbtr_lang_scss/tests/samples/scss/theme.scss

@@ -0,0 +1,3 @@
+// Re-exported by scss.scss via `@forward "theme"`.
+
+$radius: 6px;

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

@@ -0,0 +1,83 @@
+"""SCSS sample extraction: the `samples/scss/` project through the real pipeline.
+
+The snapshots are the golden record of what SCSS 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/scss/` project."""
+    root = Path(__file__).parent / "samples" / "scss"
+    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 "scss"
+        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 SCSS's class, variable, function, config-key, and import chunks."""
+    kinds = {c.kind for c in chunks}
+    assert {
+        ChunkKind.CLASS,
+        ChunkKind.VARIABLE,
+        ChunkKind.FUNCTION,
+        ChunkKind.CONFIG_KEY,
+        ChunkKind.IMPORT,
+        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 "scss")
+        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