@canonical/terrazzo-lsp 0.0.2 → 0.2.0

package/dist/types/graph/TokenGraph.d.ts

@@ -1,19 +1,121 @@
 /**
- * @see session/G.TOKEN_LSP.md §7.3
+ * Central in-memory graph for artifact tokens, CSS declarations, `@property`
+ * registrations, usage sites, and import edges.
+ *
+ * The graph deliberately keeps both per-variable and per-file indices so a
+ * single file can be rescanned incrementally without rebuilding the whole
+ * workspace model.
+ *
+ * External code must **not** access the internal data stores directly —
+ * use the query and mutation methods instead.
  */
-import type { DeclarationNode, FileNode, PropertyNode, SelectorContext, TokenGraphData, TokenNode, UsageNode } from "../types.js";
-export declare class TokenGraph {
-    readonly data: TokenGraphData;
+import type { DeclarationNode, FileNode, PropertyNode, SelectorContext, TokenNode, UsageNode } from "../types/index.js";
+export default class TokenGraph {
+    private readonly data;
     constructor();
+    /** Register or overwrite an artifact/local token. */
     addToken(node: TokenNode): void;
+    /** Remove all tokens (used when reloading artifacts). */
+    clearTokens(): void;
+    /** Register a file node. */
     addFile(node: FileNode): void;
+    /** Remove a file entry by URI. */
+    removeFile(fileUri: string): void;
+    /** Add a declaration and update both per-var and per-file indices. */
     addDeclaration(node: DeclarationNode): void;
+    /** Add an `@property` registration node. */
     addProperty(node: PropertyNode): void;
+    /** Add a `var()` usage site. */
     addUsage(node: UsageNode): void;
+    /** Add a single directed import edge (updates both forward and reverse). */
     addImport(importerUri: string, importedUri: string): void;
+    /**
+     * Replace the full import set for a file, cleaning up stale reverse edges.
+     *
+     * This is the primary entry-point used by the indexing pipeline when a
+     * document's `@import` list changes.
+     */
+    setImports(importerUri: string, nextImports: Set<string>): void;
+    /**
+     * Remove all import edges originating from *and* pointing to a file.
+     *
+     * Used during file cleanup / reindex to sever a file from the graph.
+     */
+    clearImportEdges(fileUri: string): void;
+    /** Mark a file URI as originating from artifact declarations. */
+    markArtifactFile(fileUri: string): void;
+    /**
+     * Remove all declarations, properties, and usages for a file.
+     *
+     * The per-var indices are patched to remove entries belonging to the file
+     * and `allVars` is synced (vars with no remaining token/decl/property are
+     * removed).
+     */
+    clearFile(fileUri: string): void;
+    /**
+     * Purge all non-artifact CSS data from the graph.
+     *
+     * Walks every file URI in the graph, skips artifact files, and removes
+     * all CSS-sourced data (declarations, properties, usages, import edges,
+     * file entries). Used by the reindex pipeline before re-scanning.
+     */
+    clearCssData(): void;
+    /** Resolve a CSS variable to its TokenNode, or `null` if not found. */
     resolveToken(cssVar: string): TokenNode | null;
+    /** Check whether a token exists for the given CSS variable. */
+    hasToken(cssVar: string): boolean;
+    /** Return the total number of registered tokens. */
+    get tokenCount(): number;
+    /** Iterate over all `[cssVar, TokenNode]` entries. */
+    tokenEntries(): IterableIterator<[string, TokenNode]>;
+    /** Iterate over all registered token nodes. */
+    tokenValues(): IterableIterator<TokenNode>;
+    /** Retrieve a file node by URI, or `null`. */
+    getFile(fileUri: string): FileNode | null;
+    /** Check whether a file is already indexed. */
+    hasFile(fileUri: string): boolean;
+    /** Return the total number of indexed files. */
+    get fileCount(): number;
+    /** Get all declaration nodes for a CSS variable. */
     getDeclarations(cssVar: string): DeclarationNode[];
+    /** Check whether any declarations exist for a CSS variable. */
+    hasDeclarations(cssVar: string): boolean;
+    /** Total count of distinct CSS variables that have declarations. */
+    get declarationVarCount(): number;
+    /** Iterate over all `[cssVar, DeclarationNode[]]` entries. */
+    declarationEntries(): IterableIterator<[string, DeclarationNode[]]>;
+    /** Get declarations for a specific file URI. */
+    getDeclarationsByFile(fileUri: string): DeclarationNode[];
+    /** Get the `@property` registration for a CSS variable, or `null`. */
+    getProperty(cssVar: string): PropertyNode | null;
+    /** Check whether an `@property` registration exists. */
+    hasProperty(cssVar: string): boolean;
+    /** Iterate over all registered property nodes. */
+    propertyValues(): IterableIterator<PropertyNode>;
+    /** Total count of distinct `@property` registrations. */
+    get propertyVarCount(): number;
+    /** Get `@property` nodes for a specific file URI. */
+    getPropertiesByFile(fileUri: string): PropertyNode[];
+    /** Get all `var()` usage sites for a CSS variable. */
+    getUsages(cssVar: string): UsageNode[];
+    /** Total count of distinct CSS variables that have usages. */
+    get usageVarCount(): number;
+    /** Get usages for a specific file URI. */
+    getUsagesByFile(fileUri: string): UsageNode[];
+    /** Get the set of URIs imported by a file (forward edges). */
+    getImports(fileUri: string): ReadonlySet<string> | undefined;
+    /** Get the set of URIs that import a file (reverse edges). */
+    getImportedBy(fileUri: string): ReadonlySet<string> | undefined;
+    /** Iterate all `[importerUri, Set<importedUri>]` forward edge entries. */
+    importEntries(): IterableIterator<[string, Set<string>]>;
+    /** Check whether any token, declaration, or property exists for a var. */
+    hasVar(cssVar: string): boolean;
+    /** Total number of known CSS variable names. */
+    get varCount(): number;
+    /** Check whether a file URI was injected by the artifact loader. */
+    isArtifactFile(fileUri: string): boolean;
+    /** Get the selector context from a declaration node. */
     selectorContextFor(decl: DeclarationNode): SelectorContext;
-    clearFile(fileUri: string): void;
+    private syncAllVar;
 }
 //# sourceMappingURL=TokenGraph.d.ts.map

package/dist/types/graph/TokenGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenGraph.d.ts","sourceRoot":"","sources":["../../../src/graph/TokenGraph.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;;IAmB9B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAK/B,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAU3C,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAQrC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAS/B,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IASzD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI9C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAIlD,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe;IAI1D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAoCjC"}
+{"version":3,"file":"TokenGraph.d.ts","sourceRoot":"","sources":["../../../src/graph/TokenGraph.ts"],"names":[],"mappings":"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"}

package/dist/types/graph/index.d.ts

@@ -1,5 +1,5 @@
-export { loadArtifact } from "./loadArtifact.js";
-export { parseArtifactToken } from "./parseArtifactToken.js";
-export { ReachabilityCache } from "./ReachabilityCache.js";
-export { TokenGraph } from "./TokenGraph.js";
+export { default as loadArtifact } from "./loadArtifact.js";
+export { default as parseArtifactToken } from "./parseArtifactToken.js";
+export { default as ReachabilityCache } from "./ReachabilityCache.js";
+export { default as TokenGraph } from "./TokenGraph.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/graph/loadArtifact.d.ts

@@ -1,13 +1,17 @@
 /**
- * @see session/G.TOKEN_LSP.md §16.3 — Artifact format
+ * Load a Terrazzo artifact payload into the runtime graph.
+ *
+ * Besides registering artifact tokens, this module also materializes embedded
+ * declaration metadata so hover, definition, and provenance features continue
+ * to work even before any CSS file has been scanned from disk.
  */
-import type { RawArtifact } from "../types.js";
-import type { TokenGraph } from "./TokenGraph.js";
+import type { RawArtifact } from "../types/index.js";
+import type TokenGraph from "./TokenGraph.js";
 /**
  * Load all tokens from an artifact into a TokenGraph.
  *
  * @param artifactDir - Directory containing the artifact file.
  *   Used to resolve relative `cssOutputFile` paths to absolute URIs.
  */
-export declare function loadArtifact(artifact: RawArtifact, graph: TokenGraph, packageSource?: string, artifactDir?: string): void;
+export default function loadArtifact(artifact: RawArtifact, graph: TokenGraph, packageSource?: string, artifactDir?: string): void;
 //# sourceMappingURL=loadArtifact.d.ts.map

package/dist/types/graph/loadArtifact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadArtifact.d.ts","sourceRoot":"","sources":["../../../src/graph/loadArtifact.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAEV,WAAW,EAGZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwBlD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,UAAU,EACjB,aAAa,SAAK,EAClB,WAAW,SAAK,GACf,IAAI,CAcN"}
+{"version":3,"file":"loadArtifact.d.ts","sourceRoot":"","sources":["../../../src/graph/loadArtifact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAoC9C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,UAAU,EACjB,aAAa,SAAK,EAClB,WAAW,SAAK,GACf,IAAI,CAcN"}

package/dist/types/graph/parseArtifactToken.d.ts

@@ -1,13 +1,17 @@
 /**
- * @see session/G.TOKEN_LSP.md §16.3 — ArtifactToken
- * @see session/G.TOKEN_LSP.md §10.2 — Colour resolution
+ * Convert one raw artifact token entry into the normalized `TokenNode` shape
+ * used by the LSP graph.
+ *
+ * This is where artifact-only hints become CSS-aware runtime data: DTCG types
+ * are narrowed to CSS value types, colour values are normalized into hex and
+ * oklch side data, and relative paths are resolved against the artifact file.
  */
-import type { RawArtifactToken, TokenNode } from "../types.js";
+import type { RawArtifactToken, TokenNode } from "../types/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 declare function parseArtifactToken(cssVar: string, raw: RawArtifactToken, packageSource?: string, artifactDir?: string): TokenNode;
+export default function parseArtifactToken(cssVar: string, raw: RawArtifactToken, packageSource?: string, artifactDir?: string): TokenNode;
 //# sourceMappingURL=parseArtifactToken.d.ts.map

package/dist/types/graph/parseArtifactToken.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseArtifactToken.d.ts","sourceRoot":"","sources":["../../../src/graph/parseArtifactToken.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAIV,gBAAgB,EAChB,SAAS,EACV,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,gBAAgB,EACrB,aAAa,SAAK,EAClB,WAAW,SAAK,GACf,SAAS,CA0DX"}
+{"version":3,"file":"parseArtifactToken.d.ts","sourceRoot":"","sources":["../../../src/graph/parseArtifactToken.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAIV,gBAAgB,EAChB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,gBAAgB,EACrB,aAAa,SAAK,EAClB,WAAW,SAAK,GACf,SAAS,CA0DX"}

package/dist/types/index.d.ts

@@ -1,13 +1,12 @@
 /**
  * Public API barrel export for terrazzo-lsp.
- *
- * @see session/G.TOKEN_LSP.md
  */
 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";
 export { loadArtifact, parseArtifactToken, ReachabilityCache, TokenGraph, } from "./graph/index.js";
 export { createRequest, isCompletionRequest, isDefinitionRequest, isDiagnosticsRequest, isHoverRequest, isReferencesRequest, matchResponse, resolveConfig, } from "./protocol/index.js";
 export { classifyProvenance, produceDiagnostics, provideCompletions, provideHover, resolveDefinition, } from "./providers/index.js";
+export type { NavigationTier, TooltipOptions } from "./providers/types.js";
 export type { FileSystem, GraphWorker, GraphWorkerOptions, PendingUpdate, } from "./runtime/index.js";
 export { buildImportGraph, createGraphWorker, rescanFile, scheduleBufferUpdate, } from "./runtime/index.js";
-export type { AtRuleContext, CodeAction, Color, ColorInformation, ColorPresentation, CompletionItem, CompletionItemKind, ConfigFileResult, ConfigurableSeverity, CssContext, CssValueType, DeclarationNode, Diagnostic, DiagnosticCode, DiagnosticSeverity, DiagnosticsConfig, DtcgType, FileNode, HoverConfig, InlayHintsConfig, Location, LocationLink, MarkupContent, NavigationTier, OklchComponents, Position, PropertyNode, PropertyTypeSet, Range, RangeConstraint, RawArtifact, RawArtifactToken, RawConfig, ResolvedConfig, ResolvedHoverConfig, ResolvedInlayHintsConfig, ScopeType, SelectorContext, SuppressionDirective, TerrazzoLspPlugin, TextDocumentContentChangeEvent, TextEdit, TokenGraphData, TokenGraphQueries, TokenNode, TokenProvenance, TooltipOptions, UsageNode, WorkerRequest, WorkerResponse, WorkspaceEdit, } from "./types.js";
+export type { AtRuleContext, CodeAction, Color, ColorInformation, ColorPresentation, CompletionItem, CompletionItemKind, ConfigFileResult, ConfigurableSeverity, CssContext, CssValueType, DeclarationNode, Diagnostic, DiagnosticCode, DiagnosticSeverity, DiagnosticsConfig, DtcgType, FileNode, HoverConfig, InlayHintsConfig, Location, LocationLink, MarkupContent, OklchComponents, Position, PropertyNode, PropertyTypeSet, Range, RangeConstraint, RawArtifact, RawArtifactToken, RawConfig, RawWrappedArtifact, ResolvedConfig, ResolvedHoverConfig, ResolvedInlayHintsConfig, ScopeType, SelectorContext, SharedArtifactTier, SharedKnownTokenTier, SuppressionDirective, TerrazzoLspPlugin, TextDocumentContentChangeEvent, TextEdit, TokenGraphData, TokenGraphQueries, TokenNode, TokenProvenance, UsageNode, WorkerRequest, WorkerResponse, WorkspaceEdit, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,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;AAGxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,KAAK,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,8BAA8B,EAC9B,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,cAAc,EACd,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,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;AAGxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,KAAK,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,8BAA8B,EAC9B,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,SAAS,EACT,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/types/protocol/createRequest.d.ts

@@ -1,7 +1,4 @@
-/**
- * @see session/G.TOKEN_LSP.md §7.2 — Communication protocol
- */
-import type { Position, WorkerRequest } from "../types.js";
+import type { Position, WorkerRequest } from "../types/index.js";
 type RequestParams = {
     COMPLETION: {
         uri: string;
@@ -43,8 +40,11 @@ type RequestParams = {
         path: string;
     };
 };
-/** Create a typed WorkerRequest with an auto-incrementing ID. */
-export declare function createRequest<T extends keyof RequestParams>(type: T, params: RequestParams[T]): WorkerRequest & {
+/**
+ * Create a typed worker request with an auto-incrementing ID.
+ * @note impure: increments the in-memory request id counter.
+ */
+export default function createRequest<T extends keyof RequestParams>(type: T, params: RequestParams[T]): WorkerRequest & {
     type: T;
 };
 export {};

package/dist/types/protocol/createRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRequest.d.ts","sourceRoot":"","sources":["../../../src/protocol/createRequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI3D,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC3C,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC9D,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,aAAa,EACzD,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,aAAa,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAG7B"}
+{"version":3,"file":"createRequest.d.ts","sourceRoot":"","sources":["../../../src/protocol/createRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIjE,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC3C,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAChD,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC9D,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC,SAAS,MAAM,aAAa,EACjE,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GACvB,aAAa,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAG7B"}

package/dist/types/protocol/index.d.ts

@@ -1,9 +1,5 @@
-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 { default as createRequest } from "./createRequest.js";
+export { default as matchResponse } from "./matchResponse.js";
 export { loadConfigFile, resolveConfig } from "./resolveConfig.js";
+export { isCompletionRequest, isDefinitionRequest, isDiagnosticsRequest, isHoverRequest, isReferencesRequest, } from "./typeGuards.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/protocol/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/types/protocol/matchResponse.d.ts

@@ -1,4 +1,4 @@
-import type { WorkerResponse } from "../types.js";
+import type { WorkerResponse } from "../types/index.js";
 /** Check whether a response matches a request by ID. */
-export declare function matchResponse(response: WorkerResponse, requestId: number): boolean;
+export default function matchResponse(response: WorkerResponse, requestId: number): boolean;
 //# sourceMappingURL=matchResponse.d.ts.map

package/dist/types/protocol/matchResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchResponse.d.ts","sourceRoot":"","sources":["../../../src/protocol/matchResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET"}
+{"version":3,"file":"matchResponse.d.ts","sourceRoot":"","sources":["../../../src/protocol/matchResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,wDAAwD;AACxD,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET"}

package/dist/types/protocol/resolveConfig.d.ts

@@ -1,7 +1,15 @@
 /**
- * @see session/G.TOKEN_LSP.md §15 — Configuration Reference
+ * Resolve raw user configuration into a fully-populated runtime config.
+ *
+ * Defaults are chosen to keep the server useful with zero setup: CSS files are
+ * scanned from common source folders, diagnostics are enabled at conservative
+ * severities, and hover metadata stays rich enough to explain provenance and
+ * navigation context.
+ *
+ * @note impure — resolveFromNodeModules uses existsSync; loadConfigFile
+ * reads config files from disk.
  */
-import type { ConfigFileResult, RawConfig, ResolvedConfig } from "../types.js";
+import type { ConfigFileResult, RawConfig, ResolvedConfig } from "../types/index.js";
 /** Resolve a raw config into a fully resolved config. */
 export declare function resolveConfig(raw: RawConfig, rootDir: string): ResolvedConfig;
 /**

package/dist/types/protocol/resolveConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveConfig.d.ts","sourceRoot":"","sources":["../../../src/protocol/resolveConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAIhB,SAAS,EACT,cAAc,EAGf,MAAM,aAAa,CAAC;AAyDrB,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAY7E;AAqID;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}
+{"version":3,"file":"resolveConfig.d.ts","sourceRoot":"","sources":["../../../src/protocol/resolveConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAIhB,SAAS,EACT,cAAc,EAGf,MAAM,mBAAmB,CAAC;AAkE3B,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAY7E;AAiID;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/dist/types/protocol/typeGuards.d.ts

@@ -0,0 +1,17 @@
+import type { WorkerRequest } from "../types/index.js";
+export declare function isCompletionRequest(req: WorkerRequest): req is WorkerRequest & {
+    type: "COMPLETION";
+};
+export declare function isDefinitionRequest(req: WorkerRequest): req is WorkerRequest & {
+    type: "DEFINITION";
+};
+export declare function isDiagnosticsRequest(req: WorkerRequest): req is WorkerRequest & {
+    type: "DIAGNOSTICS";
+};
+export declare function isHoverRequest(req: WorkerRequest): req is WorkerRequest & {
+    type: "HOVER";
+};
+export declare function isReferencesRequest(req: WorkerRequest): req is WorkerRequest & {
+    type: "REFERENCES";
+};
+//# sourceMappingURL=typeGuards.d.ts.map

package/dist/types/protocol/typeGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeGuards.d.ts","sourceRoot":"","sources":["../../../src/protocol/typeGuards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GACjB,GAAG,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAE/C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GACjB,GAAG,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAE/C;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,aAAa,GACjB,GAAG,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAEhD;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,GACjB,GAAG,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAE1C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GACjB,GAAG,IAAI,aAAa,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAE/C"}

package/dist/types/providers/artifactDiagnostics/checkBrokenAlias.d.ts

@@ -0,0 +1,4 @@
+/** Flag alias chains referencing non-existent tokens. */
+import type { Diagnostic, ResolvedConfig, TokenNode } from "../../types/index.js";
+export default function checkBrokenAlias(token: TokenNode, tokenById: Map<string, TokenNode>, config: ResolvedConfig, results: Diagnostic[]): void;
+//# sourceMappingURL=checkBrokenAlias.d.ts.map

package/dist/types/providers/artifactDiagnostics/checkBrokenAlias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkBrokenAlias.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkBrokenAlias.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CAmBN"}

package/dist/types/providers/artifactDiagnostics/checkCircularAlias.d.ts

@@ -0,0 +1,4 @@
+/** Detect cycles in alias chains. */
+import type { Diagnostic, ResolvedConfig, TokenNode } from "../../types/index.js";
+export default function checkCircularAlias(token: TokenNode, config: ResolvedConfig, results: Diagnostic[]): void;
+//# sourceMappingURL=checkCircularAlias.d.ts.map

package/dist/types/providers/artifactDiagnostics/checkCircularAlias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkCircularAlias.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkCircularAlias.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CA0BN"}

package/dist/types/providers/artifactDiagnostics/checkDraftSyntax.d.ts

@@ -0,0 +1,4 @@
+/** Flag tokens using pre-standardisation draft field syntax. */
+import type { Diagnostic, ResolvedConfig, TokenNode } from "../../types/index.js";
+export default function checkDraftSyntax(token: TokenNode, config: ResolvedConfig, results: Diagnostic[]): void;
+//# sourceMappingURL=checkDraftSyntax.d.ts.map

package/dist/types/providers/artifactDiagnostics/checkDraftSyntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkDraftSyntax.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkDraftSyntax.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CAuBN"}

package/dist/types/providers/artifactDiagnostics/checkMissingType.d.ts

@@ -0,0 +1,4 @@
+/** Flag tokens with no explicit `$type`. */
+import type { Diagnostic, ResolvedConfig, TokenNode } from "../../types/index.js";
+export default function checkMissingType(token: TokenNode, config: ResolvedConfig, results: Diagnostic[]): void;
+//# sourceMappingURL=checkMissingType.d.ts.map

package/dist/types/providers/artifactDiagnostics/checkMissingType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkMissingType.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkMissingType.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,OAAO,UAAU,gBAAgB,CACtC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CAaN"}

package/dist/types/providers/artifactDiagnostics/checkSchemaViolation.d.ts

@@ -0,0 +1,4 @@
+/** Validate token values against their declared type. */
+import type { Diagnostic, ResolvedConfig, TokenNode } from "../../types/index.js";
+export default function checkSchemaViolation(token: TokenNode, config: ResolvedConfig, results: Diagnostic[]): void;
+//# sourceMappingURL=checkSchemaViolation.d.ts.map

package/dist/types/providers/artifactDiagnostics/checkSchemaViolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSchemaViolation.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/checkSchemaViolation.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CA6BN"}

package/dist/types/providers/artifactDiagnostics/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Produce diagnostics for loaded artifact tokens.
+ *
+ * Unlike `produceDiagnostics` which operates on CSS file content,
+ * this function checks the artifact tokens in the graph for DTCG
+ * specification compliance issues.
+ */
+import type { TokenGraph } from "../../graph/index.js";
+import type { Diagnostic, ResolvedConfig } from "../../types/index.js";
+/** Produce diagnostics for all artifact tokens in the graph. */
+declare const produceArtifactDiagnostics: (graph: TokenGraph, config: ResolvedConfig) => Diagnostic[];
+export default produceArtifactDiagnostics;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/providers/artifactDiagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/artifactDiagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAO9B,gEAAgE;AAChE,QAAA,MAAM,0BAA0B,GAC9B,OAAO,UAAU,EACjB,QAAQ,cAAc,KACrB,UAAU,EAqBZ,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/types/providers/classifyProvenance.d.ts

@@ -1,8 +1,13 @@
 /**
- * @see session/G.TOKEN_LSP.md §10.5 — Provenance classification
+ * Classify where a CSS custom property came from so UI features can explain it
+ * consistently.
+ *
+ * The precedence is intentional: artifact tokens win over `@property`, which
+ * wins over scanned declarations. That keeps completions, hovers, and semantic
+ * tokens aligned with the most authoritative source available.
  */
 import type { TokenGraph } from "../graph/index.js";
-import type { TokenProvenance } from "../types.js";
+import type { TokenProvenance } from "../types/index.js";
 /** Classify the provenance of a CSS custom property. */
-export declare function classifyProvenance(cssVar: string, graph: TokenGraph, fileUri: string): TokenProvenance;
+export default function classifyProvenance(cssVar: string, graph: TokenGraph, fileUri: string): TokenProvenance;
 //# sourceMappingURL=classifyProvenance.d.ts.map

package/dist/types/providers/classifyProvenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classifyProvenance.d.ts","sourceRoot":"","sources":["../../../src/providers/classifyProvenance.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,wDAAwD;AACxD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,CAcjB"}
+{"version":3,"file":"classifyProvenance.d.ts","sourceRoot":"","sources":["../../../src/providers/classifyProvenance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,wDAAwD;AACxD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,CAcjB"}

package/dist/types/providers/completions/buildCompletionItem.d.ts

@@ -0,0 +1,5 @@
+import type { TokenGraph } from "../../graph/index.js";
+import { type CompletionItem, type CssValueType, type ResolvedConfig } from "../../types/index.js";
+/** Build a single completion item for a CSS variable in the graph. */
+export default function buildCompletionItem(cssVar: string, fileUri: string, graph: TokenGraph, config: ResolvedConfig, expectedType: CssValueType | null): CompletionItem | null;
+//# sourceMappingURL=buildCompletionItem.d.ts.map

package/dist/types/providers/completions/buildCompletionItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCompletionItem.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/buildCompletionItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,YAAY,EAEjB,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAc9B,sEAAsE;AACtE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,cAAc,GAAG,IAAI,CAsFvB"}

package/dist/types/providers/completions/buildSortText.d.ts

@@ -0,0 +1,15 @@
+import type { CssValueType, TokenNode } from "../../types/index.js";
+/**
+ * Score how well a token's CSS type matches the expected property type.
+ *
+ * - `"0"` — type is assignable to the expected type (best match)
+ * - `"1"` — no expected type, or type is unknown (neutral)
+ * - `"2"` — type is NOT assignable (worst match)
+ */
+export declare function contextMatchScore(cssType: CssValueType, expectedType: CssValueType | null): "0" | "1" | "2";
+/**
+ * Build a sort string that groups by context match, provenance, tier,
+ * type, then alphabetically.
+ */
+export declare function buildSortText(contextPrefix: string, provenancePrefix: string, cssVar: string, token: TokenNode): string;
+//# sourceMappingURL=buildSortText.d.ts.map

package/dist/types/providers/completions/buildSortText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSortText.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/buildSortText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,GAAG,GAAG,GAAG,GAAG,GAAG,CAKjB;AAaD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,GACf,MAAM,CAMR"}

package/dist/types/providers/completions/index.d.ts

@@ -0,0 +1,6 @@
+export { default as buildCompletionItem } from "./buildCompletionItem.js";
+export { buildSortText, contextMatchScore } from "./buildSortText.js";
+export { default as provideCompletions } from "./provideCompletions.js";
+export { default as resolveCompletionItem } from "./resolveCompletionItem.js";
+export { default as resolveExpectedType } from "./resolveExpectedType.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/providers/completions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/providers/{provideCompletions.d.ts → completions/provideCompletions.d.ts}

@@ -1,5 +1,5 @@
-import type { ReachabilityCache, TokenGraph } from "../graph/index.js";
-import { type CompletionItem, type Position, type ResolvedConfig } from "../types.js";
+import type { ReachabilityCache, TokenGraph } from "../../graph/index.js";
+import type { CompletionItem, Position, ResolvedConfig } from "../../types/index.js";
 /**
  * Produce completion items for a `var(--)` context in a CSS file.
  *
@@ -10,9 +10,6 @@ import { type CompletionItem, type Position, type ResolvedConfig } from "../type
  * When `source` and `position` are provided, the completion list is
  * sorted so that tokens whose type matches the enclosing CSS property
  * appear first.
- *
- * @see session/G.TOKEN_LSP.md §9.1 — Completions scoped to import graph
- * @see session/H.COMPLETION_PRIORITY.md §5 — Sort architecture
  */
-export declare function provideCompletions(fileUri: string, graph: TokenGraph, cache: ReachabilityCache, config: ResolvedConfig, source?: string, position?: Position): CompletionItem[];
+export default function provideCompletions(fileUri: string, graph: TokenGraph, cache: ReachabilityCache, config: ResolvedConfig, source?: string, position?: Position): CompletionItem[];
 //# sourceMappingURL=provideCompletions.d.ts.map

package/dist/types/providers/completions/provideCompletions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provideCompletions.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/provideCompletions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,QAAQ,GAClB,cAAc,EAAE,CAyClB"}

package/dist/types/providers/completions/resolveCompletionItem.d.ts

@@ -0,0 +1,9 @@
+import type { TokenGraph } from "../../graph/index.js";
+import type { CompletionItem, ResolvedConfig } from "../../types/index.js";
+/**
+ * Resolve a completion item by adding full documentation.
+ *
+ * The `label` field of the item is the CSS variable name (e.g. `--color-bg`).
+ */
+export default function resolveCompletionItem(item: CompletionItem, fileUri: string, graph: TokenGraph, config: ResolvedConfig): CompletionItem;
+//# sourceMappingURL=resolveCompletionItem.d.ts.map

package/dist/types/providers/completions/resolveCompletionItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveCompletionItem.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/resolveCompletionItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3E;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAC3C,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,cAAc,GACrB,cAAc,CAiBhB"}

package/dist/types/providers/completions/resolveExpectedType.d.ts

@@ -0,0 +1,9 @@
+import type { CssValueType, Position } from "../../types/index.js";
+/**
+ * Determine the expected CSS value type from the document context.
+ *
+ * Returns `null` when there is no position, no source, or the cursor
+ * is not inside a known property-value context.
+ */
+export default function resolveExpectedType(source: string | undefined, position: Position | undefined): CssValueType | null;
+//# sourceMappingURL=resolveExpectedType.d.ts.map

package/dist/types/providers/completions/resolveExpectedType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveExpectedType.d.ts","sourceRoot":"","sources":["../../../../src/providers/completions/resolveExpectedType.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CACzC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,YAAY,GAAG,IAAI,CAKrB"}

package/dist/types/providers/constants.d.ts

@@ -0,0 +1,31 @@
+import type { TooltipOptions } from "./types.js";
+export declare const COMPLETION_BADGE: {
+    readonly artifact: "●";
+    readonly property: "®";
+    readonly local: "◈";
+    readonly external: "⨡";
+    readonly buffer: "◌";
+};
+export declare const COMPLETION_DERIVATION_LABEL: Readonly<Record<string, string>>;
+export declare const COMPLETION_SORT_PREFIX: {
+    readonly artifact: "0";
+    readonly property: "1";
+    readonly local: "2";
+    readonly external: "2";
+    readonly buffer: "3";
+};
+/**
+ * Tier → badge icon map. Unknown tiers fall back to {@link TIER_BADGE_DEFAULT}.
+ *
+ * Common tiers: `"primitive"` (◇), `"semantic"` (●), `"derived"` (▲).
+ */
+export declare const TIER_BADGE: Readonly<Record<string, string>>;
+/** Fallback badge for unrecognised tier values. */
+export declare const TIER_BADGE_DEFAULT = "\u25CB";
+/**
+ * Tier → display label map. Unknown tiers are title-cased automatically.
+ */
+export declare const TIER_LABEL: Readonly<Record<string, string>>;
+export declare const HOVER_OPTIONS: TooltipOptions;
+export declare const COMPLETION_OPTIONS: TooltipOptions;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/providers/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC;AAEX,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK/D,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;CAMzB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9C,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9C,CAAC;AAEX,eAAO,MAAM,aAAa,EAAE,cAK3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAKhC,CAAC"}

package/dist/types/providers/diagnostics/checkMissingFallback.d.ts

@@ -0,0 +1,5 @@
+import type { Diagnostic } from "../../types/index.js";
+import type { UsageRuleContext } from "./types.js";
+/** Check: css/missing-fallback — var() without a fallback on an unregistered property. */
+export default function checkMissingFallback(ctx: UsageRuleContext, results: Diagnostic[]): void;
+//# sourceMappingURL=checkMissingFallback.d.ts.map

package/dist/types/providers/diagnostics/checkMissingFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkMissingFallback.d.ts","sourceRoot":"","sources":["../../../../src/providers/diagnostics/checkMissingFallback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,0FAA0F;AAC1F,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,UAAU,EAAE,GACpB,IAAI,CAqBN"}