@canonical/terrazzo-lsp 0.0.2 → 0.2.0

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

@@ -0,0 +1,220 @@
+/**
+ * Graph node types and data structures.
+ *
+ */
+import type { ArtifactDerivationFields, ArtifactDerivationKind, ArtifactMetadataFields, ArtifactRegistrationFields, ArtifactResolvedValueFields, ArtifactSourceFields, ArtifactTier, DtcgTokenType } from "@canonical/token-types";
+import type { CssValueType, OklchComponents, SelectorContext } from "./css.js";
+type Defined<T> = Exclude<T, undefined>;
+/**
+ * DTCG `$type` values recognised by the LSP.
+ *
+ * Aliased to the shared token contract so plugin and LSP stay in sync.
+ */
+export type DtcgType = DtcgTokenType;
+/**
+ * Provenance classification for a CSS custom property.
+ *
+ * Discriminated union — four mutually exclusive provenance kinds.
+ */
+export type TokenProvenance = {
+    kind: "artifact";
+    packageSource: string;
+} | {
+    kind: "property";
+    fileUri: string;
+} | {
+    kind: "local";
+    fileUri: string;
+} | {
+    kind: "external";
+    packageName: string;
+};
+/**
+ * A token node in the graph. Central node type — keyed by CSS variable name.
+ */
+export interface TokenNode {
+    /** CSS custom property name: "--color-foreground-primary". */
+    cssVar: string;
+    /** Provenance classification. */
+    provenance: TokenProvenance;
+    /** DTCG token ID: "color.foreground.primary". */
+    id: string;
+    /** DTCG $type. */
+    type: ArtifactMetadataFields["type"] | null;
+    /** DTCG $description. */
+    description: Defined<ArtifactMetadataFields["description"]>;
+    /** Full alias resolution chain (token IDs). */
+    aliasChain: Defined<ArtifactMetadataFields["aliasChain"]>;
+    /** `true` when aliasChain is empty (literal value, no alias). */
+    isPrimary: boolean;
+    /**
+     * Artifact tier classification. `null` for non-artifact tokens.
+     *
+     * Common values: `"primitive"`, `"semantic"`, `"derived"`.
+     * The LSP does not enforce a closed set — arbitrary tier strings from
+     * the artifact are accepted and used for display, sorting, and diagnostics.
+     */
+    tier: ArtifactTier | null;
+    /** Derived tier only: CSS var name of source token. */
+    derivedFrom: Defined<ArtifactDerivationFields["derivedFrom"]> | null;
+    /** Derived tier only: formula kind. */
+    derivation: ArtifactDerivationKind | null;
+    /** DTCG $extensions passthrough. */
+    extensions: Defined<ArtifactMetadataFields["extensions"]>;
+    /** Package source (e.g. npm scope or org name). */
+    packageSource: string | null;
+    /** CSS value type inferred from $type + unit. */
+    cssType: CssValueType;
+    /** Light-mode resolved CSS value. */
+    valueLight: Defined<ArtifactResolvedValueFields["valueLight"]> | null;
+    /** Dark-mode resolved CSS value. */
+    valueDark: Defined<ArtifactResolvedValueFields["valueDark"]> | null;
+    /** `true` when valueLight !== valueDark. */
+    isPaired: ArtifactResolvedValueFields["isPaired"];
+    /** Pre-resolved OKLCH components (light mode). */
+    oklchLight: OklchComponents | null;
+    /** Pre-resolved OKLCH components (dark mode). */
+    oklchDark: OklchComponents | null;
+    /** Hex string (light mode). */
+    hexLight: string | null;
+    /** Hex string (dark mode). */
+    hexDark: string | null;
+    /** `true` when an @property block exists for this variable. */
+    registered: Defined<ArtifactRegistrationFields["registered"]>;
+    /** @property syntax descriptor. */
+    syntax: Defined<ArtifactRegistrationFields["syntax"]>;
+    /** @property inherits descriptor. */
+    inherits: Defined<ArtifactRegistrationFields["inherits"]>;
+    /** @property initial-value descriptor. */
+    initialValue: Defined<ArtifactRegistrationFields["initialValue"]>;
+    /** Absolute path to *.tokens.json (artifact provenance). */
+    sourceFile: Defined<ArtifactSourceFields["sourceFile"]> | null;
+    /** Line number in the DTCG source file. */
+    sourceLine: Defined<ArtifactSourceFields["sourceLine"]> | null;
+    /** CSS output file containing this token's declaration. */
+    cssOutputFile: ArtifactSourceFields["cssOutputFile"] | null;
+    /** Line number in CSS output file. */
+    cssOutputLine: Defined<ArtifactSourceFields["cssOutputLine"]> | null;
+}
+/**
+ * A file node in the import graph.
+ */
+export interface FileNode {
+    /** Absolute file URI. */
+    uri: string;
+    /** Absolute filesystem path. */
+    path: string;
+    /** `true` when under `node_modules/`. */
+    isExternal: boolean;
+    /** Package name if external (e.g. `"@acme/tokens"`). */
+    packageName: string | null;
+}
+/**
+ * A CSS custom property declaration in a specific file.
+ */
+export interface DeclarationNode {
+    /** CSS custom property name. */
+    cssVar: string;
+    /** File URI where declared. */
+    fileUri: string;
+    /** 0-indexed line number. */
+    line: number;
+    /** 0-indexed column number. */
+    column: number;
+    /** Raw CSS value string. */
+    rawValue: string;
+    /** CSS value type inferred from raw value. */
+    cssType: CssValueType;
+    /** Selector context of the declaration. */
+    selector: SelectorContext;
+}
+/**
+ * An @property registration block.
+ */
+export interface PropertyNode {
+    /** CSS custom property name. */
+    cssVar: string;
+    /** File URI where declared. */
+    fileUri: string;
+    /** 0-indexed line number. */
+    line: number;
+    /** @property syntax descriptor: "<color>", "<length>", etc. */
+    syntax: string;
+    /** @property inherits descriptor. */
+    inherits: boolean;
+    /** @property initial-value descriptor. */
+    initialValue: string | null;
+    /** CSS value type from syntax descriptor. */
+    cssType: CssValueType;
+}
+/**
+ * A `var(--x)` usage site in a CSS file.
+ */
+export interface UsageNode {
+    /** CSS custom property name referenced. */
+    cssVar: string;
+    /** File URI where used. */
+    fileUri: string;
+    /** 0-indexed line number. */
+    line: number;
+    /** 0-indexed column of the `var(` call. */
+    column: number;
+    /** 0-indexed column of the `--name` inside `var()`. */
+    varNameColumn: number;
+    /** Character length of the `--name` string. */
+    varNameLength: number;
+    /** CSS property name: "background-color", "width", etc. */
+    property: string;
+    /** Fallback value text, or `null` if absent. */
+    fallback: string | null;
+}
+/**
+ * The central graph data structure — five node types, adjacency maps,
+ * and per-file indices for invalidation.
+ */
+export interface TokenGraphData {
+    /** cssVar → TokenNode. */
+    tokens: Map<string, TokenNode>;
+    /** URI → FileNode. */
+    files: Map<string, FileNode>;
+    /** cssVar → DeclarationNode[]. */
+    declarations: Map<string, DeclarationNode[]>;
+    /** cssVar → PropertyNode. */
+    properties: Map<string, PropertyNode>;
+    /** cssVar → UsageNode[]. */
+    usages: Map<string, UsageNode[]>;
+    /** URI → DeclarationNode[]. */
+    declarationsByFile: Map<string, DeclarationNode[]>;
+    /** URI → PropertyNode[]. */
+    propertiesByFile: Map<string, PropertyNode[]>;
+    /** URI → UsageNode[]. */
+    usagesByFile: Map<string, UsageNode[]>;
+    /** URI → Set of imported URIs. */
+    imports: Map<string, Set<string>>;
+    /** URI → Set of importer URIs. */
+    importedBy: Map<string, Set<string>>;
+    allVars: Set<string>;
+    /** File URIs whose declarations are injected by loadArtifact. */
+    artifactFileUris: Set<string>;
+}
+/**
+ * Query interface for the TokenGraph.
+ */
+export interface TokenGraphQueries {
+    /** Resolve a cssVar to its TokenNode (artifact or @property provenance first). */
+    resolveToken(cssVar: string): TokenNode | null;
+    /** Get all declaration nodes for a cssVar. */
+    getDeclarations(cssVar: string): DeclarationNode[];
+    /** Get declarations reachable from a given file (uses ReachabilityCache). */
+    declarationsReachableFrom(fileUri: string, cssVar: string): DeclarationNode[];
+    /** All cssVars available from a given file (completions). */
+    varsReachableFrom(fileUri: string): string[];
+    /** Is the artifact token for cssVar reachable from fileUri? */
+    isArtifactReachable(fileUri: string, cssVar: string): boolean;
+    /** Compute provenance for a cssVar in context of a specific file. */
+    provenanceFor(fileUri: string, cssVar: string): TokenProvenance;
+    /** Get the SelectorContext for a specific declaration. */
+    selectorContextFor(decl: DeclarationNode): SelectorContext;
+}
+export {};
+//# sourceMappingURL=graph.d.ts.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Type barrel — re-exports every domain module for single-import convenience.
+ *
+ * Provider-scoped types (semantic tokens, symbol kinds, navigation tiers,
+ * check report, tooltip options) live in `providers/types.ts` and are
+ * re-exported via `providers/index.ts`.
+ *
+ * @module types
+ */
+export type { DiagnosticCode } from "../diagnosticCodes.js";
+export * from "./config.js";
+export * from "./css.js";
+export * from "./graph.js";
+export * from "./lsp.js";
+export * from "./protocol.js";
+export * from "./worker.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/types/types/lsp.d.ts

@@ -0,0 +1,90 @@
+/**
+ * LSP feature types — artifact format, inline suppression, worker protocol
+ * shapes, and plugin API.
+ *
+ * Provider-scoped types (semantic tokens, symbol kinds, navigation tiers,
+ * check report, tooltip options) live in `providers/types.ts`.
+ *
+ */
+import type { DiagnosticCode } from "../diagnosticCodes.js";
+import type { SymbolKind } from "../providers/types.js";
+import type { ResolvedConfig } from "./config.js";
+import type { CssContext } from "./css.js";
+import type { TokenGraphData, TokenNode } from "./graph.js";
+import type { CodeAction, CompletionItem, Diagnostic, Location, MarkupContent, WorkspaceEdit } from "./protocol.js";
+/**
+ * Workspace symbol result.
+ */
+export interface WorkspaceSymbol {
+    /** Display name (CSS var or token ID). */
+    name: string;
+    /** Symbol kind. */
+    kind: SymbolKind;
+    /** Location of the symbol definition. */
+    location: Location;
+    /** Container name (package, file, or scope). */
+    containerName?: string;
+}
+/**
+ * Result of a rename operation.
+ */
+export interface RenameResult {
+    /** The workspace edit to apply. */
+    edit: WorkspaceEdit;
+    /** Whether a rebuild is required after rename. */
+    requiresRebuild: boolean;
+}
+/**
+ * Inline suppression directive parsed from CSS comments.
+ */
+export type SuppressionDirective = {
+    kind: "disable";
+    rules: DiagnosticCode[] | "all";
+    line: number;
+} | {
+    kind: "enable";
+    rules: DiagnosticCode[] | "all";
+    line: number;
+} | {
+    kind: "disable-next-line";
+    rules: DiagnosticCode[] | "all";
+    line: number;
+} | {
+    kind: "disable-line";
+    rules: DiagnosticCode[] | "all";
+    line: number;
+};
+import type { ArtifactDeclaration, ArtifactEnvelope, ArtifactTier, ArtifactToken, KnownTokenTier, WrappedArtifactEnvelope } from "@canonical/token-types";
+/** @see ArtifactEnvelope from @canonical/token-types */
+export type RawArtifact = ArtifactEnvelope;
+/** @see ArtifactToken from @canonical/token-types */
+export type RawArtifactToken = ArtifactToken;
+/** @see ArtifactDeclaration from @canonical/token-types */
+export type RawArtifactDeclaration = ArtifactDeclaration;
+/** @see ArtifactTier from @canonical/token-types */
+export type SharedArtifactTier = ArtifactTier;
+/** @see KnownTokenTier from @canonical/token-types */
+export type SharedKnownTokenTier = KnownTokenTier;
+/** @see WrappedArtifactEnvelope from @canonical/token-types */
+export type RawWrappedArtifact = WrappedArtifactEnvelope;
+/**
+ * Plugin contribution API for project-maintained extensions.
+ *
+ * @experimental The plugin API is defined for future use.
+ * Plugin development is deferred to a later phase.
+ */
+export interface TerrazzoLspPlugin {
+    name: string;
+    apiVersion: "1.0.0";
+    /** Augment the graph after full construction (runs in the worker). */
+    augmentGraph?(graph: TokenGraphData, config: ResolvedConfig): void | Promise<void>;
+    /** Contribute completions. */
+    provideCompletions?(context: CssContext, graph: TokenGraphData): CompletionItem[];
+    /** Augment hover — may add sections, must not remove core sections. */
+    augmentHover?(content: MarkupContent, token: TokenNode): MarkupContent;
+    /** Contribute diagnostics. */
+    provideDiagnostics?(uri: string, text: string, graph: TokenGraphData): Diagnostic[];
+    /** Contribute code actions for diagnostics produced by this plugin. */
+    provideCodeActions?(diagnostic: Diagnostic, uri: string): CodeAction[];
+}
+//# sourceMappingURL=lsp.d.ts.map

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

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

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

@@ -0,0 +1,124 @@
+/**
+ * LSP protocol subset types.
+ *
+ * Minimal definitions mirroring `vscode-languageserver-types` — declared
+ * locally to avoid coupling the type layer to the LSP SDK.
+ *
+ */
+/**
+ * Position in a text document (LSP convention).
+ */
+export interface Position {
+    /** 0-indexed line number. */
+    line: number;
+    /** 0-indexed character offset. */
+    character: number;
+}
+/** Range in a text document. */
+export interface Range {
+    start: Position;
+    end: Position;
+}
+/** Completion item kind (subset). */
+export declare enum CompletionItemKind {
+    Color = 16,
+    Variable = 6,
+    Property = 10
+}
+/** Insert text format for completion items. */
+export declare enum InsertTextFormat {
+    PlainText = 1,
+    Snippet = 2
+}
+/** LSP Command — used for post-insertion actions. */
+export interface Command {
+    title: string;
+    command: string;
+    arguments?: unknown[];
+}
+/** Completion item (abridged). */
+export interface CompletionItem {
+    label: string;
+    detail?: string;
+    kind?: CompletionItemKind;
+    sortText?: string;
+    insertText?: string;
+    insertTextFormat?: InsertTextFormat;
+    documentation?: MarkupContent;
+    /** Filter text used by the editor to match this item against the user's input. */
+    filterText?: string;
+    /** Command executed after insertion — used to dismiss suggestions. */
+    command?: Command;
+}
+/** Markup content for hover/documentation. */
+export interface MarkupContent {
+    kind: "markdown" | "plaintext";
+    value: string;
+}
+/** Location in a file. */
+export interface Location {
+    uri: string;
+    range: Range;
+}
+/** Location link for go-to-definition. */
+export interface LocationLink {
+    targetUri: string;
+    targetRange: Range;
+    targetSelectionRange: Range;
+}
+/** Diagnostic severity. */
+export declare enum DiagnosticSeverity {
+    Error = 1,
+    Warning = 2,
+    Information = 3,
+    Hint = 4
+}
+/** LSP diagnostic. */
+export interface Diagnostic {
+    range: Range;
+    severity: DiagnosticSeverity;
+    code: string;
+    source: string;
+    message: string;
+}
+/** Code action (abridged). */
+export interface CodeAction {
+    title: string;
+    kind: string;
+    edit?: WorkspaceEdit;
+}
+/** Workspace edit (abridged). */
+export interface WorkspaceEdit {
+    changes: Record<string, TextEdit[]>;
+}
+/** Text edit. */
+export interface TextEdit {
+    range: Range;
+    newText: string;
+}
+/** LSP Color (0-1 RGBA). */
+export interface Color {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+}
+/** LSP ColorInformation — a colour and the range it applies to. */
+export interface ColorInformation {
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    color: Color;
+}
+/** LSP ColorPresentation — how to display a picked colour. */
+export interface ColorPresentation {
+    label: string;
+}
+//# sourceMappingURL=protocol.d.ts.map

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

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