@canonical/terrazzo-lsp 0.0.2 → 0.2.0

package/dist/types/types.d.ts

@@ -1,927 +0,0 @@
-/**
- * Type definitions for terrazzo-lsp.
- *
- * Types-first: every public contract is defined here before any
- * implementation code exists. All types follow the spec in session/G.TOKEN_LSP.md.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — TokenGraph node types
- * @see session/G.TOKEN_LSP.md §7.2 — Worker protocol
- * @see session/G.TOKEN_LSP.md §11  — CSS type assignability
- * @see session/G.TOKEN_LSP.md §15  — Configuration
- * @see session/G.TOKEN_LSP.md §16.3 — Artifact format
- */
-/**
- * DTCG `$type` values recognised by the LSP.
- *
- * @see session/G.TOKEN_LSP.md §11.1
- */
-export type DtcgType = "color" | "dimension" | "number" | "fontFamily" | "fontWeight" | "duration" | "cubicBezier" | "gradient" | "border" | "shadow" | "typography" | "transition" | "strokeStyle";
-/**
- * CSS value types used for type assignability checking.
- *
- * @see session/G.TOKEN_LSP.md §11.1 — DTCG to CSS type mapping
- * @see session/G.TOKEN_LSP.md §11.3 — Subtype relations
- */
-export type CssValueType = "<color>" | "<length>" | "<percentage>" | "<length-percentage>" | "<number>" | "<integer>" | "<angle>" | "<time>" | "<frequency>" | "<resolution>" | "<flex>" | "<alpha-value>" | "<family-name>" | "<easing-function>" | "<gradient>" | "<image>" | "<url>" | "<unknown>";
-/**
- * Accepted CSS value types for a CSS property, with optional range constraints.
- *
- * @see session/G.TOKEN_LSP.md §11.2
- */
-export interface PropertyTypeSet {
-    /** CSS value types this property accepts. */
-    accepts: Set<CssValueType>;
-    /** Range constraints per type (e.g. width accepts `<length-percentage> [0,∞]`). */
-    rangeConstraints: Map<CssValueType, RangeConstraint>;
-}
-/** Numeric range constraint on a CSS value type. */
-export interface RangeConstraint {
-    min: number | null;
-    max: number | null;
-}
-/**
- * Provenance classification for a CSS custom property.
- *
- * Discriminated union — four mutually exclusive provenance kinds.
- *
- * @see session/G.TOKEN_LSP.md §10.5 — Provenance classification
- */
-export type TokenProvenance = {
-    kind: "artifact";
-    packageSource: string;
-} | {
-    kind: "property";
-    fileUri: string;
-} | {
-    kind: "local";
-    fileUri: string;
-} | {
-    kind: "external";
-    packageName: string;
-};
-/**
- * Scope classification for a CSS declaration's selector context.
- *
- * @see session/G.TOKEN_LSP.md §10.4 — Selector scope classification
- */
-export type ScopeType = "global" | "universal" | "class" | "media" | "layer" | "supports" | "other";
-/**
- * At-rule context wrapping a declaration (innermost first).
- *
- * @see session/G.TOKEN_LSP.md §7.3 — AtRuleContext
- */
-export interface AtRuleContext {
-    /** At-rule name: "media", "layer", "supports". */
-    name: string;
-    /** At-rule prelude: "(prefers-color-scheme: dark)", "base", etc. */
-    prelude: string;
-}
-/**
- * Full selector context for a CSS declaration.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — SelectorContext
- */
-export interface SelectorContext {
-    /** The selector itself: ":root", ".button", "html", etc. */
-    selector: string;
-    /** At-rule wrapping, innermost first. */
-    atRules: AtRuleContext[];
-    /** Computed scope type — drives hover warnings. */
-    scopeType: ScopeType;
-    /** `true` when scopeType === 'global' or 'universal'. */
-    isGlobal: boolean;
-    /** `true` when requires a matching ancestor to resolve. */
-    isScoped: boolean;
-}
-/** Pre-resolved OKLCH colour components for swatch rendering. */
-export interface OklchComponents {
-    l: number;
-    c: number;
-    h: number;
-}
-/**
- * A token node in the graph. Central node type — keyed by CSS variable name.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — TokenNode
- */
-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: DtcgType | null;
-    /** DTCG $description. */
-    description: string;
-    /** Full alias resolution chain (token IDs). */
-    aliasChain: string[];
-    /** `true` when aliasChain is empty (literal value, no alias). */
-    isPrimary: boolean;
-    /** Artifact tier classification. `null` for non-artifact tokens. */
-    tier: "primitive" | "semantic" | "derived" | null;
-    /** Derived tier only: CSS var name of source token. */
-    derivedFrom: string | null;
-    /** Derived tier only: formula kind. */
-    derivation: string | null;
-    /** DTCG $extensions passthrough. */
-    extensions: Record<string, unknown>;
-    /** Package source: "@canonical/tokens". */
-    packageSource: string | null;
-    /** CSS value type inferred from $type + unit. */
-    cssType: CssValueType;
-    /** Light-mode resolved CSS value. */
-    valueLight: string | null;
-    /** Dark-mode resolved CSS value. */
-    valueDark: string | null;
-    /** `true` when valueLight !== valueDark. */
-    isPaired: boolean;
-    /** 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: boolean;
-    /** @property syntax descriptor. */
-    syntax: string | null;
-    /** @property inherits descriptor. */
-    inherits: boolean | null;
-    /** @property initial-value descriptor. */
-    initialValue: string | null;
-    /** Absolute path to *.tokens.json (artifact provenance). */
-    sourceFile: string | null;
-    /** Line number in the DTCG source file. */
-    sourceLine: number | null;
-    /** CSS output file containing this token's declaration. */
-    cssOutputFile: string | null;
-    /** Line number in CSS output file. */
-    cssOutputLine: number | null;
-}
-/**
- * A file node in the import graph.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — FileNode
- */
-export interface FileNode {
-    /** Absolute file URI. */
-    uri: string;
-    /** Absolute filesystem path. */
-    path: string;
-    /** `true` when under `node_modules/`. */
-    isExternal: boolean;
-    /** Package name if external: "@canonical/tokens". */
-    packageName: string | null;
-}
-/**
- * A CSS custom property declaration in a specific file.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — DeclarationNode
- */
-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.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — PropertyNode
- */
-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.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — UsageNode
- */
-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.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — TokenGraph adjacency maps
- */
-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.
- *
- * @see session/G.TOKEN_LSP.md §7.3 — Primary query methods
- */
-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;
-}
-/**
- * Position in a text document (LSP convention).
- */
-export interface Position {
-    /** 0-indexed line number. */
-    line: number;
-    /** 0-indexed character offset. */
-    character: number;
-}
-/**
- * Text document content change event (LSP convention).
- */
-export interface TextDocumentContentChangeEvent {
-    /** Full text of the document after the change (full-sync mode). */
-    text: string;
-}
-/**
- * Messages from Main → Worker.
- *
- * @see session/G.TOKEN_LSP.md §7.2 — Communication protocol
- */
-export type WorkerRequest = {
-    id: number;
-    type: "COMPLETION";
-    uri: string;
-    position: Position;
-} | {
-    id: number;
-    type: "HOVER";
-    uri: string;
-    position: Position;
-} | {
-    id: number;
-    type: "DEFINITION";
-    uri: string;
-    position: Position;
-} | {
-    id: number;
-    type: "DIAGNOSTICS";
-    uri: string;
-    text: string;
-} | {
-    id: number;
-    type: "REFERENCES";
-    uri: string;
-    position: Position;
-} | {
-    id: number;
-    type: "RENAME";
-    uri: string;
-    position: Position;
-    newName: string;
-} | {
-    id: number;
-    type: "SEMANTIC_TOKENS";
-    uri: string;
-} | {
-    id: number;
-    type: "WORKSPACE_SYMBOL";
-    query: string;
-} | {
-    id: number;
-    type: "DOCUMENT_COLOR";
-    uri: string;
-} | {
-    id: number;
-    type: "OPEN_DOC";
-    uri: string;
-    text: string;
-} | {
-    id: number;
-    type: "CHANGE_DOC";
-    uri: string;
-    changes: TextDocumentContentChangeEvent[];
-} | {
-    id: number;
-    type: "CLOSE_DOC";
-    uri: string;
-} | {
-    id: number;
-    type: "FILE_CHANGED";
-    uri: string;
-} | {
-    id: number;
-    type: "ARTIFACT_CHANGED";
-    path: string;
-};
-/**
- * Messages from Worker → Main.
- *
- * @see session/G.TOKEN_LSP.md §7.2 — Communication protocol
- */
-export type WorkerResponse = {
-    id: number;
-    type: "COMPLETION_RESULT";
-    items: CompletionItem[];
-} | {
-    id: number;
-    type: "HOVER_RESULT";
-    content: MarkupContent | null;
-} | {
-    id: number;
-    type: "DEFINITION_RESULT";
-    locations: LocationLink[];
-} | {
-    id: number;
-    type: "DIAGNOSTICS_RESULT";
-    uri: string;
-    diagnostics: Diagnostic[];
-} | {
-    id: number;
-    type: "REFERENCES_RESULT";
-    locations: Location[];
-} | {
-    id: number;
-    type: "RENAME_RESULT";
-    result: RenameResult | null;
-} | {
-    id: number;
-    type: "SEMANTIC_TOKENS_RESULT";
-    data: number[];
-} | {
-    id: number;
-    type: "WORKSPACE_SYMBOL_RESULT";
-    symbols: WorkspaceSymbol[];
-} | {
-    id: number;
-    type: "DOCUMENT_COLOR_RESULT";
-    colors: DocumentColorInfo[];
-} | {
-    id: number;
-    type: "PUSH_DIAGNOSTICS";
-    uri: string;
-    diagnostics: Diagnostic[];
-};
-/** Serializable colour information for the worker protocol. */
-export interface DocumentColorInfo {
-    range: Range;
-    color: {
-        red: number;
-        green: number;
-        blue: number;
-        alpha: number;
-    };
-}
-/** 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;
-}
-/** Range in a text document. */
-export interface Range {
-    start: Position;
-    end: Position;
-}
-/** 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;
-}
-/**
- * CSS syntactic context at the cursor position.
- *
- * Discriminated union — determines how type checking is applied.
- *
- * @see session/G.TOKEN_LSP.md §10.1 — CSS context detection
- */
-export type CssContext = {
-    kind: "property-value";
-    propertyName: string;
-} | {
-    kind: "function-argument";
-    functionName: string;
-    argumentIndex: number;
-} | {
-    kind: "calc-operand";
-    resultProperty: string;
-} | {
-    kind: "shorthand-component";
-    propertyName: string;
-    componentAmbiguous: boolean;
-} | {
-    kind: "var-argument";
-} | {
-    kind: "var-fallback";
-} | {
-    kind: "at-property-block";
-} | {
-    kind: "outside-rule";
-} | {
-    kind: "unknown";
-};
-/**
- * All diagnostic codes emitted by the LSP.
- *
- * @see session/G.TOKEN_LSP.md §9.3 — Full diagnostic table
- */
-export type DiagnosticCode = "css/unknown-var" | "css/missing-fallback" | "css/stale-fallback" | "css/type-mismatch" | "css/type-uncertain" | "css/unreachable-token" | "css/primitive-token" | "css/scoped-usage" | "css/no-color-scheme" | "dtcg/broken-alias" | "dtcg/schema-violation" | "dtcg/circular-alias" | "dtcg/missing-type" | "dtcg/draft-syntax";
-/**
- * Configurable severity level for each diagnostic code.
- *
- * @see session/G.TOKEN_LSP.md §15.2 — diagnostics config
- */
-export type ConfigurableSeverity = "off" | "info" | "warning" | "error";
-/**
- * Raw configuration from `package.json` or `terrazzo-lsp.config.json`.
- *
- * @see session/G.TOKEN_LSP.md §15.2 — terrazzo-lsp.config.json
- */
-/** Log verbosity levels. */
-export type LogLevel = "off" | "error" | "warn" | "info" | "debug";
-export interface RawConfig {
-    /** Artifact paths (relative to workspace root). Typically one entry. */
-    artifacts?: string[];
-    /** Directory containing *.css.map files. */
-    distDir?: string;
-    /** Workspace-level scan globs. */
-    scanGlobs?: string[];
-    /** CSS files treated as implicitly reachable from every open document. */
-    globalStylesheets?: string[];
-    /** Diagnostic severity overrides. */
-    diagnostics?: DiagnosticsConfig;
-    /** Hover display options. */
-    hover?: HoverConfig;
-    /** Inlay hint options. */
-    inlayHints?: InlayHintsConfig;
-    /** Log level for server output. Defaults to "info". */
-    logLevel?: LogLevel;
-}
-/** Diagnostic severity configuration. */
-export interface DiagnosticsConfig {
-    unknownProperties?: ConfigurableSeverity;
-    missingFallback?: ConfigurableSeverity;
-    staleFallback?: ConfigurableSeverity;
-    brokenAlias?: ConfigurableSeverity;
-    schemaViolation?: ConfigurableSeverity;
-    circularAlias?: ConfigurableSeverity;
-    inferredType?: ConfigurableSeverity;
-    draftFormat?: ConfigurableSeverity;
-    lightDarkNoScheme?: ConfigurableSeverity;
-    typeMismatch?: ConfigurableSeverity;
-    typeUncertain?: ConfigurableSeverity;
-    unreachableToken?: ConfigurableSeverity;
-    primitiveToken?: ConfigurableSeverity;
-    scopedDeclaration?: ConfigurableSeverity;
-    ignoreGlobs?: string[];
-}
-/** Hover display configuration. */
-export interface HoverConfig {
-    showColourSwatches?: boolean;
-    showSelectorContext?: boolean;
-    showProvenanceBadge?: boolean;
-    showAliasChain?: boolean;
-    showSourceLocation?: boolean;
-    showNavigationTier?: boolean;
-    showSpecReferences?: boolean;
-}
-/** Inlay hints configuration. */
-export interface InlayHintsConfig {
-    enabled?: boolean;
-    showColourSwatches?: boolean;
-}
-/**
- * Fully resolved configuration with all defaults applied.
- * No optional fields — every setting has a value.
- */
-export interface ResolvedConfig {
-    /** Resolved artifact paths (absolute). */
-    artifactPaths: string[];
-    /** Directory containing *.css.map files (absolute). */
-    distDir: string;
-    /** Workspace-level scan globs. */
-    scanGlobs: string[];
-    /** Global stylesheet URIs. `null` means "derive from artifact". */
-    globalStylesheets: string[] | null;
-    /** Diagnostic severities keyed by DiagnosticCode. */
-    diagnostics: Map<DiagnosticCode, DiagnosticSeverity | null>;
-    /** Glob patterns to ignore for diagnostics. */
-    diagnosticIgnoreGlobs: string[];
-    /** Hover display options. */
-    hover: ResolvedHoverConfig;
-    /** Inlay hint options. */
-    inlayHints: ResolvedInlayHintsConfig;
-    /** Log level for server output. */
-    logLevel: LogLevel;
-}
-/** Resolved hover configuration — no optional fields. */
-export interface ResolvedHoverConfig {
-    showColourSwatches: boolean;
-    showSelectorContext: boolean;
-    showProvenanceBadge: boolean;
-    showAliasChain: boolean;
-    showSourceLocation: boolean;
-    showNavigationTier: boolean;
-    showSpecReferences: boolean;
-}
-/** Resolved inlay hints configuration — no optional fields. */
-export interface ResolvedInlayHintsConfig {
-    enabled: boolean;
-    showColourSwatches: boolean;
-}
-/**
- * Raw artifact as read from `tokens.json`.
- *
- * Supports two formats:
- * - **Flat** (current plugin output): top-level keys are CSS var names.
- * - **Wrapped** (legacy/spec): `{ version, generator, tokens: { ... } }`.
- *
- * @see session/G.TOKEN_LSP.md §16.3 — Artifact format
- */
-export type RawArtifact = Record<string, RawArtifactToken> | {
-    version: string;
-    generator: string;
-    tokens: Record<string, RawArtifactToken>;
-};
-/**
- * Raw artifact token entry as read from JSON.
- *
- * @see session/G.TOKEN_LSP.md §16.3 — ArtifactToken
- */
-export interface RawArtifactToken {
-    id: string | null;
-    type: string;
-    tier?: "primitive" | "semantic" | "derived";
-    value?: string;
-    valueLight?: string;
-    valueDark?: string;
-    isPaired?: boolean;
-    description?: string;
-    sourceFile?: string;
-    sourceLine?: number;
-    aliasChain?: string[];
-    extensions?: Record<string, unknown>;
-    registered?: boolean;
-    syntax?: string | null;
-    inherits?: boolean | null;
-    initialValue?: string | null;
-    cssOutputFile?: string | null;
-    cssOutputLine?: number | null;
-    derivedFrom?: string;
-    derivation?: string;
-    /** Declaration sites embedded by the plugin (selector, file, line). */
-    declarations?: RawArtifactDeclaration[];
-}
-/** A declaration site as embedded in the artifact JSON by the plugin. */
-export interface RawArtifactDeclaration {
-    /** CSS selector (e.g. ":root", ".warning", "*"). */
-    selector: string;
-    /** CSS output file (e.g. "modifiers.theme.css"). */
-    file: string;
-    /** 0-indexed line number in the CSS output file. */
-    line: number;
-    /** Enclosing at-rules, innermost-first (e.g. `@layer`, `@media`). */
-    atRules?: Array<{
-        name: string;
-        prelude: string;
-    }>;
-}
-/**
- * Navigation tier for go-to-definition.
- *
- * @see session/G.TOKEN_LSP.md §8.5 — Tier summary
- */
-export type NavigationTier = {
-    tier: 1;
-    label: "source map";
-} | {
-    tier: 2;
-    label: "artifact direct";
-} | {
-    tier: 3;
-    label: "declaration";
-};
-/**
- * Inline suppression directive parsed from CSS comments.
- *
- * @see session/G.TOKEN_LSP.md §9.3 — Inline suppression 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;
-};
-/**
- * Plugin contribution API for project-maintained extensions.
- *
- * @experimental The plugin API is defined for future use.
- * Plugin development is deferred to a later phase.
- *
- * @see session/G.TOKEN_LSP.md §9.10 — Plugin Contribution API
- */
-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[];
-}
-/**
- * Semantic token type registered with the server.
- *
- * @see session/G.TOKEN_LSP.md §9.7 — Semantic tokens
- */
-export declare const SEMANTIC_TOKEN_TYPES: readonly ["designToken"];
-/**
- * Semantic token modifiers.
- *
- * Applied to `var(--x)` occurrences based on provenance and scope.
- *
- * @see session/G.TOKEN_LSP.md §9.7 — Semantic token modifiers
- */
-export declare const SEMANTIC_TOKEN_MODIFIERS: readonly ["artifact", "registered", "local", "external", "scoped"];
-/** A single semantic token encoded for LSP delta response. */
-export interface SemanticToken {
-    /** 0-indexed line. */
-    line: number;
-    /** 0-indexed start character. */
-    startChar: number;
-    /** Length in characters. */
-    length: number;
-    /** Index into SEMANTIC_TOKEN_TYPES. */
-    tokenType: number;
-    /** Bitmask of SEMANTIC_TOKEN_MODIFIERS indices. */
-    tokenModifiers: number;
-}
-/** Legend describing the token types and modifiers. */
-export interface SemanticTokensLegend {
-    tokenTypes: readonly string[];
-    tokenModifiers: readonly string[];
-}
-/** Symbol kind (subset for design tokens). */
-export declare enum SymbolKind {
-    Variable = 13,
-    Property = 7,
-    Constant = 14
-}
-/**
- * Workspace symbol result.
- *
- * @see session/G.TOKEN_LSP.md §9.9 — Workspace symbol
- */
-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.
- *
- * @see session/G.TOKEN_LSP.md §9.6 — Rename with cascade
- */
-export interface RenameResult {
-    /** The workspace edit to apply. */
-    edit: WorkspaceEdit;
-    /** Whether a rebuild is required after rename. */
-    requiresRebuild: boolean;
-}
-/** JSON reporter output for `terrazzo-lsp check --reporter json`. */
-export interface CheckReport {
-    summary: CheckReportSummary;
-    diagnostics: CheckReportDiagnostic[];
-}
-/** Summary section of the JSON check report. */
-export interface CheckReportSummary {
-    files: number;
-    diagnostics: {
-        error: number;
-        warning: number;
-        info: number;
-        hint: number;
-    };
-    graph: {
-        tokenNodes: number;
-        fileNodes: number;
-        declarationNodes: number;
-        propertyNodes: number;
-        importEdges: number;
-    };
-    navigationTier: number;
-}
-/** Single diagnostic entry in the JSON check report. */
-export interface CheckReportDiagnostic {
-    file: string;
-    line: number;
-    column: number;
-    code: DiagnosticCode;
-    severity: "error" | "warning" | "info" | "hint";
-    message: string;
-    fixable: boolean;
-}
-/** 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;
-}
-/**
- * Result of config file discovery.
- *
- * `configDir` is the directory containing the config file — it becomes
- * the effective rootDir for resolving artifact paths and other relative
- * references.  When no config file is found, `configDir` is `null` and
- * the caller should fall back to the LSP rootUri.
- */
-export interface ConfigFileResult {
-    raw: RawConfig;
-    /** Directory containing the config file, or null if none found. */
-    configDir: string | null;
-}
-/** Controls which sections are included in the tooltip. */
-export interface TooltipOptions {
-    /** Show the provenance badge line (includes resolved value). */
-    showProvenanceBadge: boolean;
-    /** Show the description text. */
-    showDescription: boolean;
-    /** Show resolution table, source location, and registration detail. */
-    showMetadataFooter: boolean;
-    /** Show declaration sites with selector context. */
-    showSelectorContext: boolean;
-}
-//# sourceMappingURL=types.d.ts.map