From f4c5518453afd3752ea4777419b5b04036ffd07d Mon Sep 17 00:00:00 2001
From: Csaba Tuncsik <csaba.tuncsik@gmail.com>
Date: Wed, 18 Mar 2026 20:17:51 +0100
Subject: [PATCH] docs: update language support and graph docs for CSS @import
 and path aliases

- Move Svelte/Vue from "Indexing Only" to "Full Support" in README
- Move SASS/LESS to "Code Graph via Regex" in README
- Add graph-aliases.ts to DEVELOPER.md service file listing
- Update DEVELOPER.md data flow with CSS @import, path alias, and SCSS
  partial resolution steps
---
 DEVELOPER.md | 17 ++++++++++++++---
 README.md    |  8 +++++---
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/DEVELOPER.md b/DEVELOPER.md
index d8dd300..39376cc 100644
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -194,8 +194,9 @@ src/
 │   ├── logger.ts            # Structured JSON logging — stderr (startup/no MCP transport) or MCP notifications/message (when hosted)
 │   ├── code-graph.ts        # AST-based code graph building via ast-grep
 │   ├── graph-analysis.ts    # Graph queries: dependencies, stats, cycles, Mermaid diagrams
+│   ├── graph-aliases.ts     # Path alias resolution from tsconfig/jsconfig compilerOptions.paths
 │   ├── graph-imports.ts     # Import/require/use extraction for 18+ languages via AST
-│   ├── graph-resolution.ts  # Module specifier → file path resolution
+│   ├── graph-resolution.ts  # Module specifier → file path resolution (incl. aliases, SCSS partials)
 │   ├── startup.ts           # Startup lifecycle: auto-resume, graceful shutdown coordination
 │   └── context-artifacts.ts # Context artifact loading, chunking, indexing, search
 │
@@ -458,14 +459,24 @@ When `codebase_graph_build` is called:
    │   ├── Swift: import
    │   ├── Bash: source, . (dot)
    │   ├── Dart/Lua: regex-based extraction
-   │   └── Svelte/Vue: HTML parse → <script> extraction → re-parse as TypeScript
+   │   ├── Svelte/Vue: HTML parse → <script> extraction → re-parse as TypeScript
+   │   ├── Svelte/Vue: HTML parse → <style> extraction → CSS @import/@require regex
+   │   └── CSS/SCSS/SASS/LESS: @import/@import url()/@require regex extraction
+   ├── Tag CSS imports with isCssImport flag (for correct resolution extensions)
    ├── Update progress: filesProcessed++
    └── Return ImportInfo[] with module specifiers
 
 4. RESOLVE IMPORTS
+   ├── Load path aliases from tsconfig.json/jsconfig.json (once per build)
+   │   ├── Parse compilerOptions.paths + baseUrl
+   │   ├── Follow "extends" chains (up to 10 levels, circular-safe)
+   │   └── Fall back to jsconfig.json if tsconfig has no paths
    ├── For each import, resolve module specifier to actual file path
    ├── Handle relative paths: ./foo → foo.ts, foo/index.ts, etc.
-   ├── Try extension variations per language
+   ├── Try path alias resolution: $lib/foo → src/lib/foo.ts, @/bar → src/bar.ts
+   ├── Try extension variations per language (JS/TS extensions or CSS extensions)
+   ├── SCSS partial resolution: @import "vars" → _vars.scss
+   ├── CSS imports from <style> blocks → resolved with CSS extensions (.css/.scss/.sass/.less/.styl)
    ├── Check against known file set for existence
    └── Skip unresolvable imports (external packages, built-ins)
 
diff --git a/README.md b/README.md
index 76e9e9a..96257ef 100644
--- a/README.md
+++ b/README.md
@@ -602,15 +602,17 @@ SocratiCode supports languages at three levels:
 
 ### Full Support (indexing + code graph + AST chunking)
 
-JavaScript, TypeScript, TSX, Python, Java, Kotlin, Scala, C, C++, C#, Go, Rust, Ruby, PHP, Swift, Bash/Shell, HTML, CSS/SCSS
+JavaScript, TypeScript, TSX, Python, Java, Kotlin, Scala, C, C++, C#, Go, Rust, Ruby, PHP, Swift, Bash/Shell, HTML, CSS/SCSS, Svelte, Vue
+
+Svelte and Vue: imports extracted from `<script>` blocks (re-parsed as TypeScript) and CSS `@import`/`@require` from `<style>` blocks (any combination of `lang`, `scoped`, `module`, `global` attributes). Path aliases from `tsconfig.json`/`jsconfig.json` `compilerOptions.paths` are resolved (including `extends` chains). SCSS partial resolution (`_` prefix convention) is supported.
 
 ### Code Graph via Regex + Indexing
 
-Dart (import/export/part), Lua (require/dofile/loadfile)
+Dart (import/export/part), Lua (require/dofile/loadfile), SASS, LESS (CSS `@import` extraction)
 
 ### Indexing Only (hybrid search, line-based chunking)
 
-Vue, Svelte, SASS, LESS, JSON, YAML, TOML, XML, INI/CFG, Markdown/MDX, RST, SQL, R, Dockerfile, TXT, and any file matching a supported extension or special filename (Dockerfile, Makefile, Gemfile, Rakefile, etc.)
+JSON, YAML, TOML, XML, INI/CFG, Markdown/MDX, RST, SQL, R, Dockerfile, TXT, and any file matching a supported extension or special filename (Dockerfile, Makefile, Gemfile, Rakefile, etc.)
 
 **54 file extensions** + 8 special filenames supported out of the box.