@canonical/terrazzo-lsp 0.0.1

package/dist/esm/graph/parseArtifactToken.js

@@ -0,0 +1,112 @@
+/**
+ * @see session/G.TOKEN_LSP.md §16.3 — ArtifactToken
+ * @see session/G.TOKEN_LSP.md §10.2 — Colour resolution
+ */
+import * as path from "node:path";
+import { formatHex, oklch, parse } from "culori";
+import { mapDtcgType, parseSyntaxType, resolveDimensionValue, } from "../css/index.js";
+/**
+ * Parse a single artifact token entry into a TokenNode.
+ *
+ * @param artifactDir - Directory containing the artifact file.
+ *   Used to resolve relative `cssOutputFile` paths to absolute paths.
+ */
+export function parseArtifactToken(cssVar, raw, packageSource = "", artifactDir = "") {
+    const dtcgType = raw.type ?? null;
+    const aliasChain = raw.aliasChain ?? [];
+    const tier = raw.tier ?? null;
+    const valueLight = raw.valueLight ?? raw.value ?? null;
+    const valueDark = raw.valueDark ?? raw.value ?? null;
+    let cssType;
+    if (raw.registered && raw.syntax) {
+        cssType = parseSyntaxType(raw.syntax);
+    }
+    else if (dtcgType === "dimension") {
+        const narrowFrom = raw.value ?? valueLight;
+        cssType = narrowFrom
+            ? resolveDimensionValue(narrowFrom)
+            : mapDtcgType(dtcgType);
+    }
+    else {
+        cssType = mapDtcgType(dtcgType);
+    }
+    const oklchLight = resolveOklch(valueLight);
+    const oklchDark = resolveOklch(valueDark);
+    const hexLight = resolveHex(valueLight);
+    const hexDark = resolveHex(valueDark);
+    // Resolve relative file paths to absolute using the artifact directory
+    const sourceFile = resolvePath(raw.sourceFile, artifactDir);
+    const cssOutputFile = resolvePath(raw.cssOutputFile, artifactDir);
+    return {
+        cssVar,
+        provenance: { kind: "artifact", packageSource },
+        id: raw.id ?? "",
+        type: dtcgType,
+        description: raw.description ?? "",
+        aliasChain,
+        isPrimary: aliasChain.length === 0,
+        tier,
+        derivedFrom: raw.derivedFrom ?? null,
+        derivation: raw.derivation ?? null,
+        extensions: raw.extensions ?? {},
+        packageSource,
+        cssType,
+        valueLight,
+        valueDark,
+        isPaired: raw.isPaired ?? false,
+        oklchLight,
+        oklchDark,
+        hexLight,
+        hexDark,
+        registered: raw.registered ?? false,
+        syntax: raw.syntax ?? null,
+        inherits: raw.inherits ?? null,
+        initialValue: raw.initialValue ?? null,
+        sourceFile,
+        sourceLine: raw.sourceLine ?? null,
+        cssOutputFile,
+        cssOutputLine: raw.cssOutputLine ?? null,
+    };
+}
+function resolveOklch(value) {
+    if (!value)
+        return null;
+    try {
+        const parsed = parse(value);
+        if (!parsed)
+            return null;
+        const ok = oklch(parsed);
+        if (!ok)
+            return null;
+        return { l: ok.l, c: ok.c, h: ok.h ?? 0 };
+    }
+    catch {
+        return null;
+    }
+}
+function resolveHex(value) {
+    if (!value)
+        return null;
+    try {
+        const parsed = parse(value);
+        if (!parsed)
+            return null;
+        return formatHex(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve a file path from the artifact, making relative paths absolute. */
+function resolvePath(filePath, artifactDir) {
+    if (!filePath)
+        return null;
+    // Already absolute
+    if (path.isAbsolute(filePath))
+        return filePath;
+    // Relative — resolve against the artifact directory
+    if (artifactDir)
+        return path.resolve(artifactDir, filePath);
+    return filePath;
+}
+//# sourceMappingURL=parseArtifactToken.js.map

package/dist/esm/graph/parseArtifactToken.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,16 @@
+/**
+ * Public API barrel export for terrazzo-lsp.
+ *
+ * @see session/G.TOKEN_LSP.md
+ */
+// CSS domain
+export { buildSelectorContext, classifySelectorScope, compareFallbackStaleness, extractCssImports, extractJsImports, extractPackageName, extractUnit, formatFileUri, isAssignable, isBareSpecifier, isExternalPath, isSuppressed, MATH_FUNCTIONS, mapDtcgType, parseFileUri, parseSuppressionDirectives, parseSyntaxType, resolveDimensionValue, resolveImportSpecifier, SUBTYPE_RELATIONS, scanDeclarations, scanProperties, scanUsages, } from "./css/index.js";
+// Graph domain
+export { loadArtifact, parseArtifactToken, ReachabilityCache, TokenGraph, } from "./graph/index.js";
+// Protocol domain
+export { createRequest, isCompletionRequest, isDefinitionRequest, isDiagnosticsRequest, isHoverRequest, isReferencesRequest, matchResponse, resolveConfig, } from "./protocol/index.js";
+// Providers domain
+export { classifyProvenance, produceDiagnostics, provideCompletions, provideHover, resolveDefinition, } from "./providers/index.js";
+// Runtime domain
+export { buildImportGraph, createGraphWorker, rescanFile, scheduleBufferUpdate, } from "./runtime/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,EACZ,0BAA0B,EAC1B,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAO9B,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/esm/protocol/createRequest.js

@@ -0,0 +1,7 @@
+let nextId = 1;
+/** Create a typed WorkerRequest with an auto-incrementing ID. */
+export function createRequest(type, params) {
+    const id = nextId++;
+    return { id, type, ...params };
+}
+//# sourceMappingURL=createRequest.js.map

package/dist/esm/protocol/createRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRequest.js","sourceRoot":"","sources":["../../../src/protocol/createRequest.ts"],"names":[],"mappings":"AAKA,IAAI,MAAM,GAAG,CAAC,CAAC;AAef,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAC3B,IAAO,EACP,MAAwB;IAExB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAiC,CAAC;AAChE,CAAC"}

package/dist/esm/protocol/index.js

@@ -0,0 +1,9 @@
+export { createRequest } from "./createRequest.js";
+export { isCompletionRequest } from "./isCompletionRequest.js";
+export { isDefinitionRequest } from "./isDefinitionRequest.js";
+export { isDiagnosticsRequest } from "./isDiagnosticsRequest.js";
+export { isHoverRequest } from "./isHoverRequest.js";
+export { isReferencesRequest } from "./isReferencesRequest.js";
+export { matchResponse } from "./matchResponse.js";
+export { loadConfigFile, resolveConfig } from "./resolveConfig.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/protocol/isCompletionRequest.js

@@ -0,0 +1,4 @@
+export function isCompletionRequest(req) {
+    return req.type === "COMPLETION";
+}
+//# sourceMappingURL=isCompletionRequest.js.map

package/dist/esm/protocol/isCompletionRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isCompletionRequest.js","sourceRoot":"","sources":["../../../src/protocol/isCompletionRequest.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,GAAkB;IAElB,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACnC,CAAC"}

package/dist/esm/protocol/isDefinitionRequest.js

@@ -0,0 +1,4 @@
+export function isDefinitionRequest(req) {
+    return req.type === "DEFINITION";
+}
+//# sourceMappingURL=isDefinitionRequest.js.map

package/dist/esm/protocol/isDefinitionRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDefinitionRequest.js","sourceRoot":"","sources":["../../../src/protocol/isDefinitionRequest.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,GAAkB;IAElB,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACnC,CAAC"}

package/dist/esm/protocol/isDiagnosticsRequest.js

@@ -0,0 +1,4 @@
+export function isDiagnosticsRequest(req) {
+    return req.type === "DIAGNOSTICS";
+}
+//# sourceMappingURL=isDiagnosticsRequest.js.map

package/dist/esm/protocol/isDiagnosticsRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDiagnosticsRequest.js","sourceRoot":"","sources":["../../../src/protocol/isDiagnosticsRequest.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,GAAkB;IAElB,OAAO,GAAG,CAAC,IAAI,KAAK,aAAa,CAAC;AACpC,CAAC"}

package/dist/esm/protocol/isHoverRequest.js

@@ -0,0 +1,4 @@
+export function isHoverRequest(req) {
+    return req.type === "HOVER";
+}
+//# sourceMappingURL=isHoverRequest.js.map

package/dist/esm/protocol/isHoverRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isHoverRequest.js","sourceRoot":"","sources":["../../../src/protocol/isHoverRequest.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAC5B,GAAkB;IAElB,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC"}

package/dist/esm/protocol/isReferencesRequest.js

@@ -0,0 +1,4 @@
+export function isReferencesRequest(req) {
+    return req.type === "REFERENCES";
+}
+//# sourceMappingURL=isReferencesRequest.js.map

package/dist/esm/protocol/isReferencesRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isReferencesRequest.js","sourceRoot":"","sources":["../../../src/protocol/isReferencesRequest.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CACjC,GAAkB;IAElB,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACnC,CAAC"}

package/dist/esm/protocol/matchResponse.js

@@ -0,0 +1,5 @@
+/** Check whether a response matches a request by ID. */
+export function matchResponse(response, requestId) {
+    return response.id === requestId;
+}
+//# sourceMappingURL=matchResponse.js.map

package/dist/esm/protocol/matchResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchResponse.js","sourceRoot":"","sources":["../../../src/protocol/matchResponse.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,SAAiB;IAEjB,OAAO,QAAQ,CAAC,EAAE,KAAK,SAAS,CAAC;AACnC,CAAC"}

package/dist/esm/protocol/resolveConfig.js

@@ -0,0 +1,206 @@
+/**
+ * @see session/G.TOKEN_LSP.md §15 — Configuration Reference
+ */
+import { existsSync } from "node:fs";
+import * as fs from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { isBareSpecifier } from "../css/isBareSpecifier.js";
+import { DiagnosticSeverity } from "../types.js";
+const DEFAULT_SCAN_GLOBS = ["src/**/*.css", "src/**/*.scss"];
+const DEFAULT_HOVER = {
+    showColourSwatches: true,
+    showSelectorContext: true,
+    showProvenanceBadge: true,
+    showAliasChain: true,
+    showSourceLocation: true,
+    showNavigationTier: true,
+    showSpecReferences: true,
+};
+const DEFAULT_INLAY_HINTS = {
+    enabled: false,
+    showColourSwatches: true,
+};
+const DEFAULT_SEVERITIES = new Map([
+    ["css/unknown-var", null],
+    ["css/missing-fallback", DiagnosticSeverity.Warning],
+    ["css/stale-fallback", DiagnosticSeverity.Warning],
+    ["css/type-mismatch", DiagnosticSeverity.Error],
+    ["css/type-uncertain", DiagnosticSeverity.Information],
+    ["css/unreachable-token", DiagnosticSeverity.Warning],
+    ["css/primitive-token", DiagnosticSeverity.Warning],
+    ["css/scoped-usage", DiagnosticSeverity.Warning],
+    ["css/no-color-scheme", DiagnosticSeverity.Information],
+    ["dtcg/broken-alias", DiagnosticSeverity.Error],
+    ["dtcg/schema-violation", DiagnosticSeverity.Error],
+    ["dtcg/circular-alias", DiagnosticSeverity.Error],
+    ["dtcg/missing-type", DiagnosticSeverity.Information],
+    ["dtcg/draft-syntax", DiagnosticSeverity.Information],
+]);
+const CONFIG_KEY_TO_CODE = new Map([
+    ["unknownProperties", "css/unknown-var"],
+    ["missingFallback", "css/missing-fallback"],
+    ["staleFallback", "css/stale-fallback"],
+    ["typeMismatch", "css/type-mismatch"],
+    ["typeUncertain", "css/type-uncertain"],
+    ["unreachableToken", "css/unreachable-token"],
+    ["primitiveToken", "css/primitive-token"],
+    ["scopedDeclaration", "css/scoped-usage"],
+    ["lightDarkNoScheme", "css/no-color-scheme"],
+    ["brokenAlias", "dtcg/broken-alias"],
+    ["schemaViolation", "dtcg/schema-violation"],
+    ["circularAlias", "dtcg/circular-alias"],
+    ["inferredType", "dtcg/missing-type"],
+    ["draftFormat", "dtcg/draft-syntax"],
+]);
+/** Resolve a raw config into a fully resolved config. */
+export function resolveConfig(raw, rootDir) {
+    return {
+        artifactPaths: resolveArtifactPaths(raw, rootDir),
+        distDir: raw.distDir ? join(rootDir, raw.distDir) : join(rootDir, "dist"),
+        scanGlobs: raw.scanGlobs ?? DEFAULT_SCAN_GLOBS,
+        globalStylesheets: resolveGlobalStylesheets(raw, rootDir),
+        diagnostics: resolveDiagnostics(raw),
+        diagnosticIgnoreGlobs: raw.diagnostics?.ignoreGlobs ?? [],
+        hover: resolveHover(raw),
+        inlayHints: resolveInlayHints(raw),
+        logLevel: resolveLogLevel(raw.logLevel),
+    };
+}
+function resolveArtifactPaths(raw, rootDir) {
+    if (raw.artifacts)
+        return raw.artifacts.map((a) => resolveArtifactPath(a, rootDir));
+    return [];
+}
+/** Config-context bare specifier: a real package name, not a relative-ish path. */
+function isPackageSpecifier(specifier) {
+    return (isBareSpecifier(specifier) &&
+        !specifier.startsWith("node_modules/") &&
+        !specifier.startsWith("."));
+}
+function resolveArtifactPath(artifact, rootDir) {
+    if (isPackageSpecifier(artifact)) {
+        return resolveFromNodeModules(artifact, rootDir);
+    }
+    return join(rootDir, artifact);
+}
+function resolveGlobalStylesheets(raw, rootDir) {
+    if (raw.globalStylesheets === undefined)
+        return null;
+    return raw.globalStylesheets.map((gs) => {
+        // Already a file URI — pass through
+        if (gs.startsWith("file://"))
+            return gs;
+        // Already absolute — convert to file URI
+        if (gs.startsWith("/"))
+            return `file://${gs}`;
+        // Bare specifier — resolve through node_modules walk-up
+        if (isPackageSpecifier(gs))
+            return `file://${resolveFromNodeModules(gs, rootDir)}`;
+        // Relative — resolve against rootDir and convert to file URI
+        return `file://${join(rootDir, gs)}`;
+    });
+}
+function resolveDiagnostics(raw) {
+    const result = new Map(DEFAULT_SEVERITIES);
+    if (!raw.diagnostics)
+        return result;
+    for (const [configKey, code] of CONFIG_KEY_TO_CODE) {
+        const value = raw.diagnostics[configKey];
+        if (typeof value === "string")
+            result.set(code, severityFromString(value));
+    }
+    return result;
+}
+function severityFromString(value) {
+    switch (value) {
+        case "off":
+            return null;
+        case "error":
+            return DiagnosticSeverity.Error;
+        case "warning":
+            return DiagnosticSeverity.Warning;
+        case "info":
+            return DiagnosticSeverity.Information;
+    }
+}
+function resolveHover(raw) {
+    if (!raw.hover)
+        return { ...DEFAULT_HOVER };
+    return {
+        showColourSwatches: raw.hover.showColourSwatches ?? DEFAULT_HOVER.showColourSwatches,
+        showSelectorContext: raw.hover.showSelectorContext ?? DEFAULT_HOVER.showSelectorContext,
+        showProvenanceBadge: raw.hover.showProvenanceBadge ?? DEFAULT_HOVER.showProvenanceBadge,
+        showAliasChain: raw.hover.showAliasChain ?? DEFAULT_HOVER.showAliasChain,
+        showSourceLocation: raw.hover.showSourceLocation ?? DEFAULT_HOVER.showSourceLocation,
+        showNavigationTier: raw.hover.showNavigationTier ?? DEFAULT_HOVER.showNavigationTier,
+        showSpecReferences: raw.hover.showSpecReferences ?? DEFAULT_HOVER.showSpecReferences,
+    };
+}
+function resolveInlayHints(raw) {
+    if (!raw.inlayHints)
+        return { ...DEFAULT_INLAY_HINTS };
+    return {
+        enabled: raw.inlayHints.enabled ?? DEFAULT_INLAY_HINTS.enabled,
+        showColourSwatches: raw.inlayHints.showColourSwatches ??
+            DEFAULT_INLAY_HINTS.showColourSwatches,
+    };
+}
+const VALID_LOG_LEVELS = new Set([
+    "off",
+    "error",
+    "warn",
+    "info",
+    "debug",
+]);
+function resolveLogLevel(value) {
+    if (value && VALID_LOG_LEVELS.has(value))
+        return value;
+    return "info";
+}
+/**
+ * Walk up from `startDir` toward the filesystem root, checking each
+ * `node_modules/` directory for `specifier`.  Returns the first candidate
+ * that exists on disk, falling back to `<startDir>/node_modules/<specifier>`
+ * when nothing is found (so downstream code can report a clear "file not
+ * found" on a sensible path).
+ */
+function resolveFromNodeModules(specifier, startDir) {
+    let dir = resolve(startDir);
+    const fallback = join(dir, "node_modules", specifier);
+    while (true) {
+        const candidate = join(dir, "node_modules", specifier);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return fallback; // filesystem root — give up
+        dir = parent;
+    }
+}
+const CONFIG_FILENAME = "terrazzo-lsp.config.json";
+/**
+ * Search for `terrazzo-lsp.config.json` starting from `startDir` and
+ * walking up the directory tree.  Returns the parsed config and the
+ * directory where it was found.
+ *
+ * If no config file is found anywhere, returns an empty config with
+ * `configDir: null`.
+ */
+export async function loadConfigFile(startDir) {
+    let dir = startDir;
+    while (true) {
+        try {
+            const raw = await fs.readFile(join(dir, CONFIG_FILENAME), "utf-8");
+            return { raw: JSON.parse(raw), configDir: dir };
+        }
+        catch {
+            // Not found here — try parent
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // filesystem root
+        dir = parent;
+    }
+    return { raw: {}, configDir: null };
+}
+//# sourceMappingURL=resolveConfig.js.map

package/dist/esm/protocol/resolveConfig.js.map

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