dbx/apps/desktop/src/lib/sql/semantic/README.md

SQL Semantic

This directory owns the pure frontend SQL semantic layer used by editor completion, diagnostics, and navigation.

• tokens.ts: span-preserving SQL tokenization and active statement detection.
• dialect.ts: dialect adapters for identifier normalization, quoting, qualifier roles, and projection alias visibility.
• model.ts: active-statement semantic model, row-source parsing, cursor intent, and confidence/fallback output.
• completion.ts: compatibility adapter from semantic intent to the existing SQL completion item builder.
• references.ts: shared row-source references for completion, diagnostics, and navigation.
• diagnostics.ts: SQL semantic diagnostic helpers and viewport range selection.
• fixtures.ts and types.ts: test fixtures and shared semantic types.

The older sqlCompletion.ts and sqlNavigation.ts files remain at lib/ for now because they are broad public editor utilities. Move them only with a separate behavior-preserving migration.