@canonical/terrazzo-lsp 0.0.2 → 0.2.0

package/dist/esm/providers/produceDiagnostics.js

@@ -1,245 +0,0 @@
-/**
- * @see session/G.TOKEN_LSP.md §9.3 — Diagnostics
- */
-import { compareFallbackStaleness, expectedTypeForProperty, isAssignable, isSuppressed, MATH_FUNCTIONS, parseSuppressionDirectives, SHORTHAND_PROPERTIES, scanUsages, } from "../css/index.js";
-import { DiagnosticSeverity, } from "../types.js";
-/** Produce diagnostics for a CSS file. */
-export function produceDiagnostics(fileUri, source, graph, cache, config) {
-    const results = [];
-    const { directives, unknownRules } = parseSuppressionDirectives(source);
-    for (const { rule, line } of unknownRules) {
-        results.push(makeDiagnostic(line, 0, 0, DiagnosticSeverity.Information, "css/unknown-var", `Unknown rule "${rule}" in suppression comment`));
-    }
-    const usages = scanUsages(source, fileUri);
-    const reachableFiles = cache.reachableFiles(fileUri, graph);
-    const globalUris = resolveGlobalUris(graph, config);
-    const lines = source.split("\n");
-    // File-level checks
-    checkNoColorScheme(source, config, directives, results);
-    for (const usage of usages) {
-        const token = graph.resolveToken(usage.cssVar);
-        const prop = graph.data.properties.get(usage.cssVar);
-        const isRegistered = token?.registered || !!prop;
-        const lineText = lines[usage.line] ?? "";
-        const insideMath = isInsideMathFunction(lineText, usage.column);
-        if (!insideMath)
-            checkMissingFallback(usage, isRegistered, token, config, directives, results);
-        if (!insideMath)
-            checkTypeMismatch(usage, token, prop, lineText, config, directives, results);
-        if (!insideMath)
-            checkTypeUncertain(usage, token, prop, config, directives, results);
-        checkUnknownVar(usage, graph, config, directives, results);
-        checkUnreachableToken(usage, token, reachableFiles, globalUris, config, directives, results);
-        checkPrimitiveToken(usage, token, fileUri, config, directives, results);
-        if (!insideMath)
-            checkStaleFallback(usage, token, config, directives, results);
-        checkScopedUsage(usage, graph, fileUri, config, directives, results);
-    }
-    return results;
-}
-function checkMissingFallback(usage, isRegistered, token, config, directives, results) {
-    const severity = config.diagnostics.get("css/missing-fallback");
-    if (!severity)
-        return;
-    if (isRegistered)
-        return;
-    // Artifact tokens are provided by the design system and guaranteed to be
-    // defined — a missing fallback is expected, not a defect.
-    if (token?.provenance.kind === "artifact")
-        return;
-    if (usage.fallback !== null)
-        return;
-    if (isSuppressed("css/missing-fallback", usage.line, directives))
-        return;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/missing-fallback", `\`var(${usage.cssVar})\` has no fallback value and the property is not registered with \`@property\`. If the custom property is not set, the declaration will be invalid at computed-value time. [CSS Custom Properties Level 1 \u2014 \u00A73]`));
-}
-function checkTypeMismatch(usage, token, prop, lineText, config, directives, results) {
-    const severity = config.diagnostics.get("css/type-mismatch");
-    if (!severity)
-        return;
-    const tokenType = token?.cssType ?? prop?.cssType;
-    if (!tokenType || tokenType === "<unknown>")
-        return;
-    const expectedType = expectedTypeForProperty(usage.property);
-    if (!expectedType)
-        return;
-    if (isAssignable(tokenType, expectedType))
-        return;
-    if (isSuppressed("css/type-mismatch", usage.line, directives))
-        return;
-    // Underline the whole line (trimmed) for type errors
-    const trimStart = lineText.length - lineText.trimStart().length;
-    const trimEnd = lineText.trimEnd().length;
-    results.push(makeDiagnostic(usage.line, trimStart, trimEnd, severity, "css/type-mismatch", `Type mismatch: \`${usage.cssVar}\` resolves to \`${tokenType}\` which is not assignable to \`${usage.property}\`. \`${usage.property}\` expects \`${expectedType}\`. [CSS Values Level 4 \u00A74; CSS Custom Properties Level 1 \u00A72]`));
-}
-function checkUnreachableToken(usage, token, reachableFiles, globalUris, config, directives, results) {
-    const severity = config.diagnostics.get("css/unreachable-token");
-    if (!severity)
-        return;
-    if (!token || token.provenance.kind !== "artifact")
-        return;
-    if (token.registered)
-        return;
-    if (!token.cssOutputFile)
-        return;
-    const outputUri = `file://${token.cssOutputFile}`;
-    if (globalUris.has(outputUri))
-        return;
-    if (reachableFiles.has(outputUri))
-        return;
-    if (isSuppressed("css/unreachable-token", usage.line, directives))
-        return;
-    const outputBasename = token.cssOutputFile.split("/").pop() ?? token.cssOutputFile;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/unreachable-token", `\`${usage.cssVar}\` is a known design token${token.packageSource ? ` (${token.packageSource} \u00B7 ${token.id})` : ""} but its CSS output is not reachable from this file. Is \`${outputBasename}\` (or an equivalent entry point) imported in this file or one of its ancestors? [CSS Custom Properties Level 1 \u2014 \u00A72: unset custom properties produce guaranteed-invalid at computed-value time]`));
-}
-function checkPrimitiveToken(usage, token, fileUri, config, directives, results) {
-    const severity = config.diagnostics.get("css/primitive-token");
-    if (!severity)
-        return;
-    if (!token || token.provenance.kind !== "artifact")
-        return;
-    if (token.tier !== "primitive")
-        return;
-    if (token.cssOutputFile && fileUri === `file://${token.cssOutputFile}`)
-        return;
-    if (isSuppressed("css/primitive-token", usage.line, directives))
-        return;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/primitive-token", `\`${usage.cssVar}\` is a primitive token${token.packageSource ? ` (${token.packageSource} \u00B7 ${token.id})` : ""}. Primitive tokens are raw palette values \u2014 prefer a semantic token alias. [DTCG 2025.10 \u2014 \u00A76.3: aliases as the indirection mechanism]`));
-}
-function makeDiagnostic(line, column, endColumn, severity, code, message) {
-    return {
-        range: {
-            start: { line, character: column },
-            end: { line, character: endColumn },
-        },
-        severity,
-        code,
-        source: "terrazzo-lsp",
-        message,
-    };
-}
-function isInsideMathFunction(lineText, column) {
-    const before = lineText.substring(0, column);
-    for (const fn of MATH_FUNCTIONS) {
-        const fnPattern = `${fn}(`;
-        const idx = before.lastIndexOf(fnPattern);
-        if (idx >= 0) {
-            const afterFn = lineText.substring(idx);
-            let depth = 0;
-            for (let i = 0; i < afterFn.length && idx + i <= column; i++) {
-                if (afterFn[i] === "(")
-                    depth++;
-                if (afterFn[i] === ")")
-                    depth--;
-            }
-            if (depth > 0)
-                return true;
-        }
-    }
-    return false;
-}
-function checkStaleFallback(usage, token, config, directives, results) {
-    const severity = config.diagnostics.get("css/stale-fallback");
-    if (!severity)
-        return;
-    if (usage.fallback === null)
-        return;
-    if (!token)
-        return;
-    const isColour = token.type === "color";
-    const currentValue = token.valueLight ?? null;
-    if (!compareFallbackStaleness(usage.fallback, currentValue, isColour))
-        return;
-    if (isSuppressed("css/stale-fallback", usage.line, directives))
-        return;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/stale-fallback", `Fallback value \`${usage.fallback}\` does not match the current value of \`${usage.cssVar}\`${currentValue ? ` (\`${currentValue}\`)` : ""}. The fallback may be out of date. [CSS Custom Properties Level 1 \u2014 \u00A73: fallback values]`));
-}
-function checkScopedUsage(usage, graph, fileUri, config, directives, results) {
-    const severity = config.diagnostics.get("css/scoped-usage");
-    if (!severity)
-        return;
-    const decls = graph.data.declarations.get(usage.cssVar) ?? [];
-    if (decls.length === 0)
-        return;
-    const scopedDecls = decls.filter((d) => d.selector.isScoped && d.fileUri !== fileUri);
-    if (scopedDecls.length === 0)
-        return;
-    // Check that no non-scoped declarations exist
-    const hasGlobalDecl = decls.some((d) => d.selector.isGlobal);
-    if (hasGlobalDecl)
-        return;
-    if (isSuppressed("css/scoped-usage", usage.line, directives))
-        return;
-    const firstScoped = scopedDecls[0];
-    const scopeSelector = firstScoped.selector.selector;
-    const scopeFile = firstScoped.fileUri.split("/").pop() ?? firstScoped.fileUri;
-    // §9.3: warning for class scoped, info for media/layer
-    const effectiveSeverity = firstScoped.selector.scopeType === "class"
-        ? severity
-        : DiagnosticSeverity.Information;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, effectiveSeverity, "css/scoped-usage", `\`${usage.cssVar}\` is declared under \`${scopeSelector}\` in \`${scopeFile}\`. It will only resolve when an ancestor matches \`${scopeSelector}\` \u2014 using it outside that context produces guaranteed-invalid at computed-value time. [CSS Custom Properties Level 1 \u2014 \u00A72: scope and inheritance]`));
-}
-function checkUnknownVar(usage, graph, config, directives, results) {
-    const severity = config.diagnostics.get("css/unknown-var");
-    if (!severity)
-        return;
-    // Known if in tokens, declarations, properties, or allVars
-    if (graph.data.tokens.has(usage.cssVar))
-        return;
-    if (graph.data.properties.has(usage.cssVar))
-        return;
-    if (graph.data.allVars.has(usage.cssVar))
-        return;
-    if (isSuppressed("css/unknown-var", usage.line, directives))
-        return;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/unknown-var", `\`var(${usage.cssVar})\` references a custom property not found in any reachable graph node. [CSS Custom Properties Level 1 \u2014 \u00A72]`));
-}
-function checkNoColorScheme(source, config, directives, results) {
-    const severity = config.diagnostics.get("css/no-color-scheme");
-    if (!severity)
-        return;
-    const hasLightDark = /light-dark\s*\(/.test(source);
-    if (!hasLightDark)
-        return;
-    const hasColorScheme = /color-scheme\s*:/.test(source);
-    if (hasColorScheme)
-        return;
-    // Find line of first light-dark() usage
-    const lines = source.split("\n");
-    for (let i = 0; i < lines.length; i++) {
-        if (/light-dark\s*\(/.test(lines[i])) {
-            if (isSuppressed("css/no-color-scheme", i, directives))
-                continue;
-            const col = lines[i].indexOf("light-dark");
-            const startCol = col >= 0 ? col : 0;
-            const endCol = col >= 0 ? col + "light-dark".length : 0;
-            results.push(makeDiagnostic(i, startCol, endCol, severity, "css/no-color-scheme", `\`light-dark()\` is used but no \`color-scheme\` property is set in this file. Without \`color-scheme\`, the browser cannot determine which value to use. [CSS Color Level 5 \u2014 \u00A73.4]`));
-            break; // Only report first occurrence
-        }
-    }
-}
-function checkTypeUncertain(usage, token, prop, config, directives, results) {
-    const severity = config.diagnostics.get("css/type-uncertain");
-    if (!severity)
-        return;
-    const tokenType = token?.cssType ?? prop?.cssType;
-    if (!tokenType || tokenType === "<unknown>")
-        return;
-    // Only fires for shorthand properties where component mapping is ambiguous
-    if (!SHORTHAND_PROPERTIES.has(usage.property))
-        return;
-    if (isSuppressed("css/type-uncertain", usage.line, directives))
-        return;
-    results.push(makeDiagnostic(usage.line, usage.varNameColumn, usage.varNameColumn + usage.varNameLength, severity, "css/type-uncertain", `\`${usage.cssVar}\` resolves to \`${tokenType}\` in shorthand property \`${usage.property}\`. The component mapping is ambiguous \u2014 consider using a longhand property instead. [CSS Values Level 4 \u00A74]`));
-}
-function resolveGlobalUris(graph, config) {
-    if (config.globalStylesheets === null) {
-        const uris = new Set();
-        for (const token of graph.data.tokens.values())
-            if (token.cssOutputFile)
-                uris.add(`file://${token.cssOutputFile}`);
-        return uris;
-    }
-    return new Set(config.globalStylesheets);
-}
-//# sourceMappingURL=produceDiagnostics.js.map

package/dist/esm/providers/produceDiagnostics.js.map

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

package/dist/esm/providers/provideCompletions.js

@@ -1,286 +0,0 @@
-/**
- * Context-aware completion provider.
- *
- * Produces completion items for a `var(--)` context in a CSS file,
- * prioritized by type compatibility with the enclosing CSS property,
- * then by provenance (artifact > local), then by tier (semantic >
- * derived > primitive), then alphabetically.
- *
- * @see session/G.TOKEN_LSP.md §9.1 — Completion
- * @see session/H.COMPLETION_PRIORITY.md — Context-aware sorting design
- */
-import { expectedTypeForProperty, extractPropertyAtPosition, isAssignable, } from "../css/index.js";
-import { CompletionItemKind, InsertTextFormat, } from "../types.js";
-import { buildTokenTooltip } from "./buildTokenTooltip.js";
-import { COMPLETION_OPTIONS } from "./tooltipOptions.js";
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const BADGE = {
-    artifact: "\u25CF",
-    property: "\u00AE",
-    local: "\u25C8",
-    external: "\u2A21",
-    buffer: "\u25CC",
-};
-/** Tier-specific badges for artifact completion items. */
-const TIER_BADGE = {
-    primitive: "\u25C7", // ◇ — open diamond
-    semantic: "\u25CF", // ● — filled circle
-    derived: "\u25B2", // ▲ — triangle
-};
-/** Human-readable labels for derivation kinds. */
-const DERIVATION_LABEL = {
-    hover: "hover",
-    active: "active",
-    disabled: "disabled",
-    delta: "delta",
-};
-const SORT_PREFIX = {
-    artifact: "0",
-    property: "1",
-    local: "2",
-    external: "2",
-    buffer: "3",
-};
-const TIER_LABEL = {
-    primitive: "Primitive",
-    semantic: "Semantic",
-    derived: "Derived",
-};
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Produce completion items for a `var(--)` context in a CSS file.
- *
- * Completions are scoped to the file's import graph: only variables
- * reachable from the open document (via import traversal or global
- * stylesheets) are offered. Artifact tokens are always included.
- *
- * 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 function provideCompletions(fileUri, graph, cache, config, source, position) {
-    const results = [];
-    const globalStylesheets = resolveGlobalStylesheetSet(graph, config);
-    const reachableVars = cache.reachableVars(fileUri, graph, globalStylesheets);
-    // Start with all vars reachable through the import graph + globals
-    const scopedVars = new Set(reachableVars);
-    // Always include all artifact tokens — they represent the design system
-    // and should be available everywhere regardless of import scoping.
-    for (const [cssVar, token] of graph.data.tokens) {
-        if (token.provenance.kind === "artifact") {
-            scopedVars.add(cssVar);
-        }
-    }
-    // Determine the expected CSS type from the property at the cursor.
-    const expectedType = resolveExpectedType(source, position);
-    for (const cssVar of scopedVars) {
-        const item = buildCompletionItem(cssVar, fileUri, graph, config, expectedType);
-        if (item)
-            results.push(item);
-    }
-    return results;
-}
-// ---------------------------------------------------------------------------
-// Expected type resolution
-// ---------------------------------------------------------------------------
-/**
- * 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.
- */
-function resolveExpectedType(source, position) {
-    if (!source || !position)
-        return null;
-    const property = extractPropertyAtPosition(source, position);
-    if (!property)
-        return null;
-    return expectedTypeForProperty(property);
-}
-// ---------------------------------------------------------------------------
-// Completion item builder
-// ---------------------------------------------------------------------------
-function buildCompletionItem(cssVar, fileUri, graph, config, expectedType) {
-    const token = graph.data.tokens.get(cssVar);
-    const prop = graph.data.properties.get(cssVar);
-    const decls = graph.data.declarations.get(cssVar);
-    // Build documentation via the shared tooltip — skip provenance badge
-    // since the completion item's `detail` field already shows it.
-    const options = {
-        ...COMPLETION_OPTIONS,
-        showProvenanceBadge: false,
-        showSelectorContext: config.hover.showSelectorContext,
-    };
-    const docValue = buildTokenTooltip(cssVar, fileUri, graph, config, options);
-    const documentation = docValue
-        ? { kind: "markdown", value: docValue }
-        : undefined;
-    if (token?.provenance.kind === "artifact") {
-        const contextPrefix = contextMatchScore(token.cssType, expectedType);
-        return {
-            label: cssVar,
-            detail: buildArtifactDetail(token, graph),
-            kind: token.type === "color"
-                ? CompletionItemKind.Color
-                : CompletionItemKind.Variable,
-            sortText: buildSortText(contextPrefix, SORT_PREFIX.artifact, cssVar, token),
-            filterText: cssVar,
-            insertText: `${cssVar})$0`,
-            insertTextFormat: InsertTextFormat.Snippet,
-            documentation,
-        };
-    }
-    if (prop) {
-        const cssType = prop.cssType ?? "<unknown>";
-        const contextPrefix = contextMatchScore(cssType, expectedType);
-        return {
-            label: cssVar,
-            detail: `${BADGE.property} ${prop.syntax} \u00B7 initial: ${prop.initialValue ?? "none"}`,
-            kind: CompletionItemKind.Property,
-            sortText: `${contextPrefix}_${SORT_PREFIX.property}_0_zzz_${cssVar.replace(/^--/, "")}`,
-            filterText: cssVar,
-            insertText: `${cssVar})$0`,
-            insertTextFormat: InsertTextFormat.Snippet,
-            documentation,
-        };
-    }
-    const decl = decls?.[0];
-    if (decl) {
-        const file = graph.data.files.get(decl.fileUri);
-        const isExternal = file?.isExternal ?? false;
-        const badge = isExternal ? BADGE.external : BADGE.local;
-        const prefix = isExternal ? SORT_PREFIX.external : SORT_PREFIX.local;
-        const fileName = decl.fileUri.split("/").pop() ?? decl.fileUri;
-        const selectorStr = decl.selector.selector;
-        const contextPrefix = contextMatchScore(decl.cssType, expectedType);
-        return {
-            label: cssVar,
-            detail: `${badge} ${decl.rawValue}  \u00B7  ${selectorStr}  \u00B7  ${fileName}:${decl.line + 1}`,
-            kind: CompletionItemKind.Variable,
-            sortText: `${contextPrefix}_${prefix}_0_zzz_${cssVar.replace(/^--/, "")}`,
-            filterText: cssVar,
-            insertText: `${cssVar})$0`,
-            insertTextFormat: InsertTextFormat.Snippet,
-            documentation,
-        };
-    }
-    return {
-        label: cssVar,
-        detail: `${BADGE.buffer} (buffer)`,
-        kind: CompletionItemKind.Variable,
-        sortText: `1_${SORT_PREFIX.buffer}_0_zzz_${cssVar.replace(/^--/, "")}`,
-        filterText: cssVar,
-        insertText: `${cssVar})$0`,
-        insertTextFormat: InsertTextFormat.Snippet,
-    };
-}
-// ---------------------------------------------------------------------------
-// Detail line (shown inline in the completion list)
-// ---------------------------------------------------------------------------
-function buildArtifactDetail(token, graph) {
-    const badge = token.tier
-        ? (TIER_BADGE[token.tier] ?? BADGE.artifact)
-        : BADGE.artifact;
-    const parts = [badge];
-    if (token.tier)
-        parts.push(TIER_LABEL[token.tier] ?? token.tier);
-    if (token.type)
-        parts.push(token.type);
-    // Resolve to terminal value for display
-    const resolved = resolveTerminalLiteral(token, graph);
-    if (resolved) {
-        parts.push(`\u00B7 ${truncate(resolved, 40)}`);
-    }
-    // Derivation context for derived tokens
-    if (token.derivation) {
-        const kindLabel = DERIVATION_LABEL[token.derivation];
-        if (kindLabel)
-            parts.push(`\u00B7 ${kindLabel}`);
-    }
-    // Description is shown in the documentation panel (body), not here.
-    return parts.join(" ");
-}
-/**
- * Walk the alias chain to the terminal token and format its value.
- * Returns `light-dark(L, D)` for paired, plain value otherwise.
- */
-function resolveTerminalLiteral(token, graph) {
-    let terminal = token;
-    const visited = new Set([token.cssVar]);
-    for (const ref of token.aliasChain) {
-        if (visited.has(ref))
-            break;
-        visited.add(ref);
-        const target = graph.data.tokens.get(ref);
-        if (target)
-            terminal = target;
-        else
-            break;
-    }
-    if (terminal.isPaired &&
-        terminal.valueLight &&
-        terminal.valueDark &&
-        terminal.valueLight !== terminal.valueDark) {
-        return `light-dark(${terminal.valueLight}, ${terminal.valueDark})`;
-    }
-    return terminal.valueLight ?? null;
-}
-// ---------------------------------------------------------------------------
-// Sort text
-// ---------------------------------------------------------------------------
-/**
- * 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)
- */
-function contextMatchScore(cssType, expectedType) {
-    if (!expectedType)
-        return "1";
-    if (cssType === "<unknown>")
-        return "1";
-    if (isAssignable(cssType, expectedType))
-        return "0";
-    return "2";
-}
-/**
- * Build a sort string that groups by context match, provenance, tier,
- * type, then alphabetically.
- *
- * @see session/H.COMPLETION_PRIORITY.md §5a — Sort text format
- */
-function buildSortText(contextPrefix, provenancePrefix, cssVar, token) {
-    const tierGroup = token.tier === "semantic" ? "0" : token.tier === "derived" ? "1" : "2";
-    const typeGroup = token.type ?? "zzz";
-    return `${contextPrefix}_${provenancePrefix}_${tierGroup}_${typeGroup}_${cssVar.replace(/^--/, "")}`;
-}
-// ---------------------------------------------------------------------------
-// Global stylesheet resolution
-// ---------------------------------------------------------------------------
-function resolveGlobalStylesheetSet(graph, config) {
-    if (config.globalStylesheets === null) {
-        const files = new Set();
-        for (const token of graph.data.tokens.values())
-            if (token.cssOutputFile)
-                files.add(`file://${token.cssOutputFile}`);
-        return files.size > 0 ? files : undefined;
-    }
-    if (config.globalStylesheets.length === 0)
-        return undefined;
-    return new Set(config.globalStylesheets);
-}
-// ---------------------------------------------------------------------------
-// Utilities
-// ---------------------------------------------------------------------------
-function truncate(s, max) {
-    return s.length > max ? `${s.substring(0, max - 3)}...` : s;
-}
-//# sourceMappingURL=provideCompletions.js.map

package/dist/esm/providers/provideCompletions.js.map

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

package/dist/esm/providers/tooltipOptions.js

@@ -1,15 +0,0 @@
-/** Full options for hover cards — everything visible. */
-export const HOVER_OPTIONS = {
-    showProvenanceBadge: true,
-    showDescription: true,
-    showMetadataFooter: true,
-    showSelectorContext: true,
-};
-/** Completion documentation — same as hover for consistent experience. */
-export const COMPLETION_OPTIONS = {
-    showProvenanceBadge: true,
-    showDescription: true,
-    showMetadataFooter: true,
-    showSelectorContext: true,
-};
-//# sourceMappingURL=tooltipOptions.js.map

package/dist/esm/providers/tooltipOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tooltipOptions.js","sourceRoot":"","sources":["../../../src/providers/tooltipOptions.ts"],"names":[],"mappings":"AAQA,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,IAAI;IACxB,mBAAmB,EAAE,IAAI;CAC1B,CAAC"}