@canonical/terrazzo-lsp-extension 0.4.0

package/README.md

@@ -0,0 +1,45 @@
+# Terrazzo LSP
+
+Terrazzo LSP adds CSS custom property intelligence for Canonical design token workflows in VS Code.
+
+## Features
+
+- Completions for `var(--token)` references
+- Hover details with resolved token values and provenance
+- Diagnostics for missing fallbacks, stale fallbacks, primitive token use, and type mismatches
+- Go to definition and rename for custom properties
+- Workspace symbol search across token names
+
+## Quick start
+
+1. Install `@canonical/design-tokens` in your project.
+2. Run `npx @canonical/terrazzo-lsp-extension` to install the extension.
+3. Create a `terrazzo-lsp.config.json` file in your workspace root:
+
+```json
+{
+  "artifacts": ["@canonical/design-tokens/dist/tokens.json"]
+}
+```
+
+## Configuration
+
+### `terrazzo-lsp.serverPath`
+
+Optional path to a custom `dist/esm/cli.js` server build.
+
+### `terrazzo-lsp.runtime`
+
+Optional runtime override. Leave empty to auto-detect `bun` first and `node >= 22` second.
+
+### `terrazzo-lsp.trace.server`
+
+Controls the VS Code language client trace level.
+
+## Troubleshooting
+
+If the extension cannot find a runtime, install `bun` or `node >= 22`, or set `terrazzo-lsp.runtime` explicitly in your workspace settings.
+
+If no `terrazzo-lsp.config.json` is present, the extension output logs the
+candidate paths it tried and includes a starter example you can paste into a
+new config file.

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,61 @@
+/**
+ * CLI entry-point dispatcher.
+ *
+ * Parses `process.argv`, dispatches to the appropriate sub-command,
+ * then tail-calls `run()`.
+ */
+import startLspServer from "../runtime/startLspServer.js";
+import { VERSION } from "../version.js";
+import { printHelp } from "./printHelp.js";
+import { runCheck } from "./runCheck.js";
+import { runGraph } from "./runGraph.js";
+import { runInspect } from "./runInspect.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 "--help":
+        case "-h":
+            printHelp();
+            break;
+        case "--version":
+        case "-v":
+            console.log(`terrazzo-lsp ${VERSION}`);
+            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,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,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,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,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,SAAS,EAAE,CAAC;YACZ,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;YACvC,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,19 @@
+/** 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
+
+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;;;;;;;;;;;;;;6CAc+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":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAe,EACf,OAAe;IAEf,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,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACtC,MAAM,iBAAiB,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEnD,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,UAAU,OAAO,EAAE,CAAC;QAEhC,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAE1E,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,KAAK;gBACxC,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,OAAO;oBAC5C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,MAAM,CAAC;YAEf,IAAI,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,KAAK;gBAAE,UAAU,EAAE,CAAC;YAC7D,IAAI,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,OAAO;gBAAE,YAAY,EAAE,CAAC;YAEjE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACrF,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,YAAY,YAAY,WAAW,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

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"}

package/dist/esm/cli/runStatus.js

@@ -0,0 +1,18 @@
+/**
+ * `status` command — show current config and artifact status.
+ *
+ * @note Impure — reads config, writes to stdout.
+ */
+import { loadConfigFile, resolveConfig } from "../protocol/index.js";
+export async function runStatus(rootDir) {
+    const { raw, configDir } = await loadConfigFile(rootDir);
+    const config = resolveConfig(raw, configDir ?? rootDir);
+    console.log("terrazzo-lsp status");
+    console.log("---");
+    console.log(`Root:       ${rootDir}`);
+    console.log(`Dist:       ${config.distDir}`);
+    console.log(`Artifacts:  ${config.artifactPaths.length > 0 ? config.artifactPaths.join(", ") : "(none)"}`);
+    console.log(`Scan globs: ${config.scanGlobs.join(", ")}`);
+    console.log(`Global CSS: ${config.globalStylesheets === null ? "(auto)" : config.globalStylesheets.join(", ") || "(none)"}`);
+}
+//# sourceMappingURL=runStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runStatus.js","sourceRoot":"","sources":["../../../src/cli/runStatus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,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,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CACT,eAAe,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC9F,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CACT,eAAe,MAAM,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAChH,CAAC;AACJ,CAAC"}

package/dist/esm/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+/** @see {@link ./cli/index.ts} for the CLI implementation. */
+import "./cli/index.js";
+//# sourceMappingURL=cli.js.map

package/dist/esm/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA,8DAA8D;AAC9D,OAAO,gBAAgB,CAAC"}

package/dist/esm/css/colorSetup.js

@@ -0,0 +1,13 @@
+/**
+ * @note impure — mutates the colorjs.io global ColorSpace registry.
+ */
+import { ColorSpace, OKLCH, sRGB } from "colorjs.io/fn";
+let isRegistered = false;
+export default function ensureColorSetup() {
+    if (isRegistered)
+        return;
+    ColorSpace.register(sRGB);
+    ColorSpace.register(OKLCH);
+    isRegistered = true;
+}
+//# sourceMappingURL=colorSetup.js.map

package/dist/esm/css/colorSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorSetup.js","sourceRoot":"","sources":["../../../src/css/colorSetup.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAExD,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,CAAC,OAAO,UAAU,gBAAgB;IACtC,IAAI,YAAY;QAAE,OAAO;IACzB,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/esm/css/createDocumentIndex.js

@@ -0,0 +1,43 @@
+import extractCssImports from "./imports/extractCssImports.js";
+import extractJsImports from "./imports/extractJsImports.js";
+import extractPackageName from "./imports/extractPackageName.js";
+import formatFileUri from "./imports/formatFileUri.js";
+import isExternalPath from "./imports/isExternalPath.js";
+import parseFileUri from "./imports/parseFileUri.js";
+import resolveImportSpecifier from "./imports/resolveImportSpecifier.js";
+import scanDeclarations from "./scanners/scanDeclarations.js";
+import scanProperties from "./scanners/scanProperties.js";
+import scanUsages from "./scanners/scanUsages.js";
+export default function createDocumentIndex(options) {
+    const { fileUri, rootDir, source, tree } = options;
+    const path = parseFileUri(fileUri);
+    return {
+        declarations: scanDeclarations(source, fileUri, tree),
+        file: {
+            uri: fileUri,
+            path,
+            isExternal: isExternalPath(path),
+            packageName: isExternalPath(path) ? extractPackageName(path) : null,
+        },
+        importedUris: rootDir
+            ? resolveImportedUris(source, tree, path, rootDir)
+            : [],
+        properties: scanProperties(source, fileUri, tree),
+        usages: scanUsages(source, fileUri, tree),
+    };
+}
+function resolveImportedUris(source, tree, importerPath, rootDir) {
+    const importedUris = new Set();
+    const specifiers = [
+        ...extractCssImports(source, tree),
+        ...extractJsImports(source),
+    ];
+    for (const specifier of specifiers) {
+        const resolvedPath = resolveImportSpecifier(specifier, importerPath, rootDir);
+        if (resolvedPath) {
+            importedUris.add(formatFileUri(resolvedPath));
+        }
+    }
+    return [...importedUris];
+}
+//# sourceMappingURL=createDocumentIndex.js.map

package/dist/esm/css/createDocumentIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDocumentIndex.js","sourceRoot":"","sources":["../../../src/css/createDocumentIndex.ts"],"names":[],"mappings":"AASA,OAAO,iBAAiB,MAAM,gCAAgC,CAAC;AAC/D,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,kBAAkB,MAAM,iCAAiC,CAAC;AACjE,OAAO,aAAa,MAAM,4BAA4B,CAAC;AACvD,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,YAAY,MAAM,2BAA2B,CAAC;AACrD,OAAO,sBAAsB,MAAM,qCAAqC,CAAC;AAEzE,OAAO,gBAAgB,MAAM,gCAAgC,CAAC;AAC9D,OAAO,cAAc,MAAM,8BAA8B,CAAC;AAC1D,OAAO,UAAU,MAAM,0BAA0B,CAAC;AAiBlD,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,OAAmC;IAEnC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEnC,OAAO;QACL,YAAY,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACrD,IAAI,EAAE;YACJ,GAAG,EAAE,OAAO;YACZ,IAAI;YACJ,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC;YAChC,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;SACpE;QACD,YAAY,EAAE,OAAO;YACnB,CAAC,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;YAClD,CAAC,CAAC,EAAE;QACN,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;QACjD,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAc,EACd,IAAU,EACV,YAAoB,EACpB,OAAe;IAEf,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,UAAU,GAAG;QACjB,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC;QAClC,GAAG,gBAAgB,CAAC,MAAM,CAAC;KAC5B,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,sBAAsB,CACzC,SAAS,EACT,YAAY,EACZ,OAAO,CACR,CAAC;QACF,IAAI,YAAY,EAAE,CAAC;YACjB,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC;AAC3B,CAAC"}

package/dist/esm/css/imports/extractCssImports.js

@@ -0,0 +1,41 @@
+import * as lezer from "../lezer/index.js";
+/** Extract CSS @import paths from CSS/SCSS source text. */
+export default function extractCssImports(source, tree) {
+    const results = [];
+    const parsed = tree ?? lezer.parseCSS(source);
+    visit(parsed.topNode, (node) => {
+        if (node.name !== "ImportStatement")
+            return;
+        const stringNode = node.getChild("StringLiteral");
+        if (stringNode) {
+            results.push(stripQuotes(lezer.getNodeText(source, stringNode)));
+            return;
+        }
+        const callNode = node.getChild("CallLiteral");
+        if (!callNode)
+            return;
+        const callString = callNode.getChild("StringLiteral");
+        if (callString) {
+            results.push(stripQuotes(lezer.getNodeText(source, callString)));
+            return;
+        }
+        const raw = lezer.getNodeText(source, callNode).trim();
+        const inner = raw
+            .replace(/^url\(/i, "")
+            .replace(/\)$/, "")
+            .trim();
+        if (inner)
+            results.push(stripQuotes(inner));
+    });
+    return results;
+}
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, "").trim();
+}
+function visit(node, onNode) {
+    onNode(node);
+    for (let child = node.firstChild; child; child = child.nextSibling) {
+        visit(child, onNode);
+    }
+}
+//# sourceMappingURL=extractCssImports.js.map

package/dist/esm/css/imports/extractCssImports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractCssImports.js","sourceRoot":"","sources":["../../../../src/css/imports/extractCssImports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAE3C,2DAA2D;AAC3D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,MAAc,EACd,IAAW;IAEX,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9C,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB;YAAE,OAAO;QAE5C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAClD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;YACjE,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG;aACd,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;aACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;aAClB,IAAI,EAAE,CAAC;QACV,IAAI,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,KAAK,CACZ,IAA4C,EAC5C,MAA8D;IAE9D,MAAM,CAAC,IAAI,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACnE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}