@canonical/terrazzo-lsp 0.0.2 → 0.2.0

package/README.md

@@ -17,15 +17,23 @@ Language server providing CSS custom property intelligence for design token work
 
 ## Editor Setup
 
-Build the packages first (`bun run build:all` from the repo root), then install for your editor:
-
-**VS Code:**
+**VS Code** (recommended):
 
 ```bash
-bun dist/esm/cli.js install vscode
+bun run build:all
+npm install -D @canonical/design-tokens
+npx terrazzo-lsp install vscode
 ```
 
-**Neovim:**
+The `terrazzo-lsp` command is re-exported by `@canonical/design-tokens`, so
+consumers can use `npx terrazzo-lsp` without installing the LSP package
+directly. The install command attempts to install the bundled VS Code extension
+with the `code` CLI and always writes `.vscode/settings.json`. If `code` is not
+on your `PATH`, it prints the manual `code --install-extension ...` command.
+
+The extension auto-detects `bun` first and falls back to `node >= 22`.
+
+**Neovim** (via nvim-lspconfig):
 
 ```bash
 bun dist/esm/cli.js install neovim
@@ -40,12 +48,124 @@ bun dist/esm/cli.js install helix
 ## CLI
 
 ```bash
-bun dist/esm/cli.js --stdio              # Start LSP server on stdio
-bun dist/esm/cli.js check [globs]        # Run diagnostics on CSS files
-bun dist/esm/cli.js status               # Show config and artifact status
-bun dist/esm/cli.js inspect <var>        # Inspect a CSS custom property
+npx terrazzo-lsp install vscode         # Install bundled VS Code extension + workspace settings
+npx terrazzo-lsp --stdio                # Start LSP server on stdio
+npx terrazzo-lsp --stdio --allow-degraded  # Start with reduced capabilities when config is missing
+npx terrazzo-lsp check [globs]          # Run diagnostics on CSS files
+npx terrazzo-lsp status                 # Show config and artifact status
+npx terrazzo-lsp inspect <var>          # Inspect a CSS custom property
+npx terrazzo-lsp resolve <spec>         # Resolve an import specifier
+npx terrazzo-lsp graph <file>           # Show import graph from a file
+```
+
+## Diagnostics Reference
+
+The LSP emits 14 diagnostic codes across two categories: **CSS** (in-file analysis) and **DTCG** (artifact-level validation). The example below triggers every CSS diagnostic:
+
+```css
+/* ──────────────────────────────────────────────────────────
+   Example: every terrazzo-lsp CSS diagnostic in one file
+   ────────────────────────────────────────────────────────── */
+
+/* Assume the following tokens exist in the artifact:
+ *   --color-fg           : oklch(17.2% 0 0)        tier: semantic, type: color
+ *   --spacing-sm         : 0.5rem                   tier: semantic, type: dimension
+ *   --color-palette-blue : oklch(50% 0.15 250)      tier: primitive, type: color
+ *   --button-pad         : 0.75rem                  tier: semantic, scoped to .button
+ *   --unreachable-token  : 1rem                     (in a file not imported by this sheet)
+ */
+
+/* ① css/unknown-var (off by default — enable via config)
+ *    A var() reference that does not match any known custom property. */
+.unknown {
+  margin: var(--does-not-exist);
+}
+
+/* ② css/missing-fallback
+ *    A var() reference to a non-artifact property with no fallback value
+ *    and no @property registration. */
+.missing-fb {
+  padding: var(--local-pad);
+}
+
+/* ③ css/stale-fallback
+ *    The fallback literal no longer matches the token's resolved value. */
+.stale-fb {
+  gap: var(--spacing-sm, 16px); /* actual resolved value is 0.5rem, not 16px */
+}
+
+/* ④ css/type-mismatch
+ *    A token's DTCG type is incompatible with the CSS property's
+ *    expected value type (e.g. color token in a length context). */
+.type-err {
+  width: var(--color-fg); /* color token used where <length> is expected */
+}
+
+/* ⑤ css/type-uncertain
+ *    A typed token appears in a shorthand or context where multiple
+ *    value types are acceptable — the LSP cannot confirm correctness. */
+.type-warn {
+  background: var(--spacing-sm); /* dimension token in a shorthand that accepts many types */
+}
+
+/* ⑥ css/unreachable-token
+ *    The token's artifact output file is not reachable through this
+ *    file's @import graph. */
+.unreachable {
+  margin: var(--unreachable-token);
+}
+
+/* ⑦ css/primitive-token
+ *    Direct use of a primitive-tier token. Prefer semantic aliases. */
+.primitive {
+  color: var(--color-palette-blue);
+}
+
+/* ⑧ css/scoped-usage
+ *    The token is declared under a specific selector scope (e.g. .button)
+ *    but is referenced outside that scope. */
+.card {
+  padding: var(--button-pad); /* --button-pad is scoped to .button */
+}
+
+/* ⑨ css/no-color-scheme
+ *    A light-dark() function is used without a color-scheme property
+ *    on the same selector or an ancestor. */
+.no-scheme {
+  color: light-dark(black, white); /* no color-scheme declared */
+}
+
+/* ──────────────────────────────────────────────────────────
+   Suppression syntax
+   ────────────────────────────────────────────────────────── */
+
+/* Disable all checks for a region: */
+/* terrazzo-lsp-disable */
+.suppressed {
+  width: var(--color-fg);         /* no diagnostic — all checks disabled */
+}
+/* terrazzo-lsp-enable */
+
+/* Disable a specific code for the next line: */
+/* terrazzo-lsp-disable css/primitive-token */
+.selective {
+  color: var(--color-palette-blue); /* no diagnostic — primitive check disabled */
+}
+/* terrazzo-lsp-enable css/primitive-token */
 ```
 
+### DTCG Diagnostics (artifact-level)
+
+These are emitted once when loading `tokens.json` artifacts, not per CSS file. They validate that the design token definitions conform to the [DTCG 2025.10](https://tr.designtokens.org/format/) specification.
+
+| Code | Default Severity | Trigger |
+|------|-----------------|---------|
+| `dtcg/broken-alias` | Error | An `{alias.path}` reference points to a token ID that does not exist in any loaded artifact. |
+| `dtcg/schema-violation` | Error | A token's value is invalid for its declared `$type` — e.g. `$type: color` with a value that is not a valid CSS colour, or `$type: dimension` with a value that cannot be resolved to a length/percentage. |
+| `dtcg/circular-alias` | Error | The alias chain for a token forms a cycle (a token ID appears more than once in the resolution path). |
+| `dtcg/missing-type` | Warning | Token has no `$type` field and cannot inherit one from a parent group. The resolved type is ambiguous. |
+| `dtcg/draft-syntax` | Info | Token uses pre-standardisation draft field syntax (`value`/`type` without the `$` prefix) or has an empty token ID, suggesting it was authored before the DTCG standard was finalised. |
+
 ## Configuration
 
 Create a `terrazzo-lsp.config.json` in your workspace root:
@@ -57,13 +177,41 @@ Create a `terrazzo-lsp.config.json` in your workspace root:
 }
 ```
 
+If no config file is present, the output panel logs every candidate path it
+tried, prints a ready-to-copy starter config, and then exits. For temporary
+degraded startup, pass `--allow-degraded`.
+
+```json
+{ "artifacts": ["@canonical/design-tokens/dist/tokens.json"] }
+```
+
 See the root repository README for the full configuration reference.
 
 ## Development
 
+### Architecture
+
+The LSP server is organised into four main layers:
+
+| Layer | Path | Responsibility |
+|-------|------|----------------|
+| **Protocol** | `protocol/` | JSON-RPC message parsing, config loading, request/response matching |
+| **Runtime** | `runtime/` | Server lifecycle, document management, import graph building, worker dispatch |
+| **Graph** | `graph/` | Token graph data structure, artifact loading, reachability cache |
+| **Providers** | `providers/` | All LSP features: completions, hover, diagnostics, rename, etc. |
+
+**Diagnostics pipeline:**
+
+```
+CSS diagnostics:  orchestrateDiagnostics → per-rule check modules → makeDiagnostic
+DTCG diagnostics: produceArtifactDiagnostics → per-rule check modules → makeDiagnostic
+```
+
+Each diagnostic rule lives in its own file (`diagnostics/checkMissingFallback.ts`, `artifactDiagnostics/checkBrokenAlias.ts`, etc.) with a co-located `.tests.ts` file. The orchestrator loops over usages (CSS) or tokens (DTCG) and delegates to each check function.
+
 ```bash
 bun run build      # Compile LSP server (tsc)
-bun run build:ext  # Build + package VS Code extension
+bun run build:all  # Build + package VS Code extension
 bun run test       # Run tests
 bun run check      # Lint + type check
 ```

package/dist/esm/cli/expandGlobs.js

@@ -0,0 +1,21 @@
+/**
+ * Expand glob patterns to matching file paths (deduplicated).
+ *
+ * @note Impure — reads the file system via `fs.glob`.
+ */
+import * as fs from "node:fs/promises";
+export async function expandGlobs(patterns, rootDir) {
+    const results = [];
+    for (const pattern of patterns) {
+        try {
+            for await (const entry of fs.glob(pattern, { cwd: rootDir })) {
+                results.push(entry);
+            }
+        }
+        catch {
+            // Pattern didn't match — skip
+        }
+    }
+    return [...new Set(results)];
+}
+//# sourceMappingURL=expandGlobs.js.map

package/dist/esm/cli/expandGlobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expandGlobs.js","sourceRoot":"","sources":["../../../src/cli/expandGlobs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAkB,EAClB,OAAe;IAEf,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/esm/cli/index.js

@@ -0,0 +1,64 @@
+/**
+ * CLI entry-point dispatcher.
+ *
+ * Parses `process.argv`, dispatches to the appropriate sub-command,
+ * then tail-calls `run()`.
+ */
+import startLspServer from "../runtime/startLspServer.js";
+import { printHelp } from "./printHelp.js";
+import { runCheck } from "./runCheck.js";
+import { runGraph } from "./runGraph.js";
+import { runInspect } from "./runInspect.js";
+import { runInstall } from "./runInstall.js";
+import { runResolve } from "./runResolve.js";
+import { runStatus } from "./runStatus.js";
+const args = process.argv.slice(2).filter((arg) => arg !== "--allow-degraded");
+const allowDegraded = process.argv.includes("--allow-degraded");
+const command = args[0] ?? "--stdio";
+const rootDir = process.cwd();
+/**
+ * Run the CLI.
+ *
+ * @note This function is impure — it reads files, writes to stdout,
+ * and may exit the process.
+ */
+async function run() {
+    switch (command) {
+        case "--stdio":
+        case "serve":
+            startLspServer(rootDir, { allowDegraded });
+            break;
+        case "check":
+            await runCheck(args.slice(1), rootDir);
+            break;
+        case "status":
+            await runStatus(rootDir);
+            break;
+        case "inspect":
+            await runInspect(args[1], rootDir);
+            break;
+        case "resolve":
+            await runResolve(args[1], rootDir);
+            break;
+        case "graph":
+            await runGraph(args[1], rootDir);
+            break;
+        case "install":
+            await runInstall(args[1], rootDir);
+            break;
+        case "--help":
+        case "-h":
+            printHelp();
+            break;
+        case "--version":
+        case "-v":
+            console.log("terrazzo-lsp 0.1.0");
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+void run();
+//# sourceMappingURL=index.js.map

package/dist/esm/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC;AAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAChE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE9B;;;;;GAKG;AACH,KAAK,UAAU,GAAG;IAChB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,OAAO;YACV,cAAc,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACvC,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,OAAO;YACV,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,SAAS,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAClC,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,KAAK,GAAG,EAAE,CAAC"}

package/dist/esm/cli/loadArtifactFiles.js

@@ -0,0 +1,21 @@
+/**
+ * Read JSON artifact files from disk and load them into the token graph.
+ *
+ * @note Impure — reads files from disk.
+ */
+import * as fs from "node:fs/promises";
+import { dirname } from "node:path";
+import { loadArtifact } from "../graph/index.js";
+export async function loadArtifactFiles(paths, graph) {
+    for (const p of paths) {
+        try {
+            const raw = await fs.readFile(p, "utf-8");
+            const artifact = JSON.parse(raw);
+            loadArtifact(artifact, graph, "", dirname(p));
+        }
+        catch {
+            // Skip missing artifacts
+        }
+    }
+}
+//# sourceMappingURL=loadArtifactFiles.js.map

package/dist/esm/cli/loadArtifactFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadArtifactFiles.js","sourceRoot":"","sources":["../../../src/cli/loadArtifactFiles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAmB,MAAM,mBAAmB,CAAC;AAGlE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAe,EACf,KAAiB;IAEjB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9C,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/cli/printHelp.js

@@ -0,0 +1,20 @@
+/** Print CLI usage help. */
+export function printHelp() {
+    console.log(`terrazzo-lsp — CSS custom property intelligence for design tokens
+
+Usage:
+  terrazzo-lsp                  Start LSP server (stdio)
+  terrazzo-lsp check [globs]    Run diagnostics on CSS files
+  terrazzo-lsp status           Show config and artifact status
+  terrazzo-lsp inspect <var>    Inspect a CSS custom property
+  terrazzo-lsp resolve <spec>   Resolve an import specifier
+  terrazzo-lsp graph <file>     Show import graph from a file
+  terrazzo-lsp install <editor> Install LSP config (neovim, helix, vscode)
+
+Options:
+  --stdio                       Start LSP server on stdio (default)
+  --allow-degraded              Keep the server alive without config, with reduced capabilities
+  -h, --help                    Show this help
+  -v, --version                 Show version`);
+}
+//# sourceMappingURL=printHelp.js.map

package/dist/esm/cli/printHelp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printHelp.js","sourceRoot":"","sources":["../../../src/cli/printHelp.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;6CAe+B,CAAC,CAAC;AAC/C,CAAC"}

package/dist/esm/cli/runCheck.js

@@ -0,0 +1,52 @@
+/**
+ * `check` command — run diagnostics on CSS files and report.
+ *
+ * @note Impure — reads files, writes to stdout, may exit the process.
+ */
+import * as fs from "node:fs/promises";
+import { resolve } from "node:path";
+import { ReachabilityCache, TokenGraph } from "../graph/index.js";
+import { loadConfigFile, resolveConfig } from "../protocol/index.js";
+import { produceDiagnostics } from "../providers/index.js";
+import { DiagnosticSeverity } from "../types/index.js";
+import { expandGlobs } from "./expandGlobs.js";
+import { loadArtifactFiles } from "./loadArtifactFiles.js";
+export async function runCheck(globs, rootDir) {
+    const { raw, configDir } = await loadConfigFile(rootDir);
+    const config = resolveConfig(raw, configDir ?? rootDir);
+    const graph = new TokenGraph();
+    const cache = new ReachabilityCache();
+    await loadArtifactFiles(config.artifactPaths, graph);
+    const patterns = globs.length > 0 ? globs : config.scanGlobs;
+    const files = await expandGlobs(patterns, rootDir);
+    let errorCount = 0;
+    let warningCount = 0;
+    for (const file of files) {
+        const absPath = resolve(rootDir, file);
+        const source = await fs.readFile(absPath, "utf-8");
+        const uri = `file://${absPath}`;
+        const diagnostics = produceDiagnostics(uri, source, graph, cache, config);
+        for (const diag of diagnostics) {
+            const severity = diag.severity === DiagnosticSeverity.Error
+                ? "error"
+                : diag.severity === DiagnosticSeverity.Warning
+                    ? "warning"
+                    : "info";
+            if (diag.severity === DiagnosticSeverity.Error)
+                errorCount++;
+            if (diag.severity === DiagnosticSeverity.Warning)
+                warningCount++;
+            const loc = `${file}:${diag.range.start.line + 1}:${diag.range.start.character + 1}`;
+            console.log(`${loc} ${severity} ${diag.code} ${diag.message}`);
+        }
+    }
+    const total = errorCount + warningCount;
+    if (total > 0) {
+        console.log(`\n${errorCount} errors, ${warningCount} warnings`);
+        process.exit(errorCount > 0 ? 1 : 0);
+    }
+    else {
+        console.log("No issues found.");
+    }
+}
+//# sourceMappingURL=runCheck.js.map

package/dist/esm/cli/runCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCheck.js","sourceRoot":"","sources":["../../../src/cli/runCheck.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/runGraph.js

@@ -0,0 +1,41 @@
+/**
+ * `graph` command — show the import graph from a file.
+ *
+ * @note Impure — reads files, writes to stdout/stderr, may exit the process.
+ */
+import * as fs from "node:fs/promises";
+import { resolve } from "node:path";
+import { TokenGraph } from "../graph/index.js";
+import buildImportGraph from "../runtime/buildImportGraph.js";
+export async function runGraph(file, rootDir) {
+    if (!file) {
+        console.error("Usage: terrazzo-lsp graph <file>");
+        process.exit(1);
+    }
+    const graph = new TokenGraph();
+    const absPath = resolve(rootDir, file);
+    const uri = `file://${absPath}`;
+    const nodeFs = {
+        rootDir,
+        async readFile(fileUri) {
+            const fsPath = fileUri.startsWith("file://") ? fileUri.slice(7) : fileUri;
+            try {
+                return await fs.readFile(fsPath, "utf-8");
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+    await buildImportGraph(uri, graph, nodeFs);
+    console.log(`Import graph from ${file}:`);
+    for (const [importer, imported] of graph.importEntries()) {
+        for (const dep of imported) {
+            const short = (s) => s.startsWith("file://") ? s.slice(7).replace(rootDir, ".") : s;
+            console.log(`  ${short(importer)} → ${short(dep)}`);
+        }
+    }
+    console.log(`\nFiles: ${graph.fileCount}`);
+    console.log(`Declarations: ${graph.varCount}`);
+}
+//# sourceMappingURL=runGraph.js.map

package/dist/esm/cli/runGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runGraph.js","sourceRoot":"","sources":["../../../src/cli/runGraph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,gBAAgB,MAAM,gCAAgC,CAAC;AAG9D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAwB,EACxB,OAAe;IAEf,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,OAAO,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAe;QACzB,OAAO;QACP,KAAK,CAAC,QAAQ,CAAC,OAAe;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1E,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;IAEF,MAAM,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAC1B,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/esm/cli/runInspect.js

@@ -0,0 +1,27 @@
+/**
+ * `inspect` command — inspect a CSS custom property.
+ *
+ * @note Impure — reads config + artifacts, writes to stdout/stderr,
+ * may exit the process.
+ */
+import { TokenGraph } from "../graph/index.js";
+import { loadConfigFile, resolveConfig } from "../protocol/index.js";
+import { loadArtifactFiles } from "./loadArtifactFiles.js";
+export async function runInspect(cssVar, rootDir) {
+    if (!cssVar) {
+        console.error("Usage: terrazzo-lsp inspect <--custom-property>");
+        process.exit(1);
+    }
+    const { raw, configDir } = await loadConfigFile(rootDir);
+    const config = resolveConfig(raw, configDir ?? rootDir);
+    const graph = new TokenGraph();
+    await loadArtifactFiles(config.artifactPaths, graph);
+    const token = graph.resolveToken(cssVar);
+    if (token) {
+        console.log(JSON.stringify(token, null, 2));
+    }
+    else {
+        console.log(`Token "${cssVar}" not found in loaded artifacts.`);
+    }
+}
+//# sourceMappingURL=runInspect.js.map

package/dist/esm/cli/runInspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runInspect.js","sourceRoot":"","sources":["../../../src/cli/runInspect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA0B,EAC1B,OAAe;IAEf,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/B,MAAM,iBAAiB,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,kCAAkC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/esm/cli/runInstall.js

@@ -0,0 +1,126 @@
+/**
+ * `install` command — install LSP configuration for an editor.
+ *
+ * @note Impure — writes config files to disk, may exit the process.
+ */
+import * as fs from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { findBundledVsixPath, installBundledVscodeExtension, updateVscodeSettings, } from "../extension/index.js";
+const NEOVIM_CONFIG = `-- terrazzo-lsp configuration for Neovim
+-- Add this to your init.lua or lspconfig setup
+--
+-- Requires: bun (recommended) or node >= 22
+-- Update the cmd path to point to your project's dist/esm/cli.js
+require('lspconfig').terrazzo_lsp.setup({
+  cmd       = { 'bun', 'run', '<path-to-repo>/dist/esm/cli.js', '--stdio' },
+  filetypes = { 'css', 'scss', 'json' },
+  root_dir  = require('lspconfig').util.root_pattern(
+    'terrazzo-lsp.config.json', 'package.json', '.git'
+  ),
+  on_attach = function(client, bufnr)
+    local o = { buffer = bufnr, noremap = true, silent = true }
+    vim.keymap.set('n', 'gd',         vim.lsp.buf.definition,  o)
+    vim.keymap.set('n', 'gr',         vim.lsp.buf.references,  o)
+    vim.keymap.set('n', 'K',          vim.lsp.buf.hover,       o)
+    vim.keymap.set('n', '<leader>ca', vim.lsp.buf.code_action, o)
+    vim.keymap.set('n', '<leader>rn', vim.lsp.buf.rename,      o)
+  end,
+})
+`;
+const HELIX_CONFIG = `# terrazzo-lsp configuration for Helix
+# Add this to your ~/.config/helix/languages.toml
+#
+# Requires: bun (recommended) or node >= 22
+# Update the command path to point to your project's dist/esm/cli.js
+
+[language-server.terrazzo]
+command = "bun"
+args    = ["run", "<path-to-repo>/dist/esm/cli.js", "--stdio"]
+
+[[language]]
+name             = "css"
+language-servers = ["terrazzo", "vscode-css-language-server"]
+
+[[language]]
+name             = "scss"
+language-servers = ["terrazzo", "vscode-css-language-server"]
+`;
+/**
+ * Install LSP configuration for the specified editor.
+ *
+ * @note This function is impure — it writes config files.
+ */
+export async function runInstall(editor, rootDir) {
+    if (!editor) {
+        console.error("Usage: terrazzo-lsp install <editor>\nEditors: neovim, helix, vscode");
+        process.exit(1);
+        return;
+    }
+    switch (editor) {
+        case "neovim": {
+            const configDir = join(homedir(), ".config", "nvim", "lsp");
+            await fs.mkdir(configDir, { recursive: true });
+            const configPath = join(configDir, "terrazzo_lsp.lua");
+            await fs.writeFile(configPath, NEOVIM_CONFIG, "utf-8");
+            console.log(`Wrote Neovim LSP config to ${configPath}`);
+            console.log("Ensure nvim-lspconfig is installed. Update the cmd path in the config.");
+            break;
+        }
+        case "helix": {
+            const configDir = join(homedir(), ".config", "helix");
+            const configPath = join(configDir, "languages.toml");
+            let existing = "";
+            try {
+                existing = await fs.readFile(configPath, "utf-8");
+            }
+            catch {
+                // File doesn't exist yet
+            }
+            if (existing.includes("terrazzo")) {
+                console.log(`Helix config at ${configPath} already contains terrazzo configuration.`);
+            }
+            else {
+                await fs.mkdir(configDir, { recursive: true });
+                const updated = existing
+                    ? `${existing}\n${HELIX_CONFIG}`
+                    : HELIX_CONFIG;
+                await fs.writeFile(configPath, updated, "utf-8");
+                console.log(`Appended terrazzo-lsp config to ${configPath}`);
+            }
+            break;
+        }
+        case "vscode": {
+            const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+            const vsixPath = await findBundledVsixPath(packageRoot);
+            const extDir = join(rootDir, ".vscode");
+            await fs.mkdir(extDir, { recursive: true });
+            const settingsPath = join(extDir, "settings.json");
+            let settings = {};
+            try {
+                const raw = await fs.readFile(settingsPath, "utf-8");
+                settings = JSON.parse(raw);
+            }
+            catch {
+                // New file
+            }
+            if (vsixPath) {
+                const installResult = await installBundledVscodeExtension(vsixPath);
+                console.log(installResult.message);
+            }
+            else {
+                console.log("Bundled VS Code extension not found. Build it with `bun run build:extension`.");
+            }
+            settings = updateVscodeSettings(settings);
+            await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+            console.log(`Updated VS Code settings at ${settingsPath}`);
+            break;
+        }
+        default:
+            console.error(`Unknown editor: ${editor}`);
+            console.error("Supported editors: neovim, helix, vscode");
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=runInstall.js.map

package/dist/esm/cli/runInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runInstall.js","sourceRoot":"","sources":["../../../src/cli/runInstall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;CAoBrB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA0B,EAC1B,OAAe;IAEf,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,sEAAsE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5D,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CACT,wEAAwE,CACzE,CAAC;YACF,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACrD,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;YACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CACT,mBAAmB,UAAU,2CAA2C,CACzE,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM,OAAO,GAAG,QAAQ;oBACtB,CAAC,CAAC,GAAG,QAAQ,KAAK,YAAY,EAAE;oBAChC,CAAC,CAAC,YAAY,CAAC;gBACjB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,WAAW,GAAG,OAAO,CACzB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EACvC,IAAI,EACJ,IAAI,EACJ,IAAI,CACL,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAExD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACxC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACnD,IAAI,QAAQ,GAA4B,EAAE,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,aAAa,GAAG,MAAM,6BAA6B,CAAC,QAAQ,CAAC,CAAC;gBACpE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,+EAA+E,CAChF,CAAC;YACJ,CAAC;YAED,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC,SAAS,CAChB,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EACjC,OAAO,CACR,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;YAC3D,MAAM;QACR,CAAC;QACD;YACE,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/esm/cli/runResolve.js

@@ -0,0 +1,17 @@
+/**
+ * `resolve` command — resolve an import specifier.
+ *
+ * @note Impure — dynamically imports css module, writes to stdout/stderr,
+ * may exit the process.
+ */
+export async function runResolve(specifier, rootDir) {
+    if (!specifier) {
+        console.error("Usage: terrazzo-lsp resolve <import-specifier>");
+        process.exit(1);
+        return;
+    }
+    const { resolveImportSpecifier } = await import("../css/index.js");
+    const resolved = resolveImportSpecifier(specifier, rootDir, rootDir);
+    console.log(resolved ?? "(unresolvable)");
+}
+//# sourceMappingURL=runResolve.js.map

package/dist/esm/cli/runResolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runResolve.js","sourceRoot":"","sources":["../../../src/cli/runResolve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,SAA6B,EAC7B,OAAe;IAEf,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IACD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC;AAC5C,CAAC"}