@azerothjs/language-service 0.4.0-beta.1

package/dist/providers/css-service.js

@@ -0,0 +1,84 @@
+// CSS intelligence for inline `style="…"` values, via `vscode-css-languageservice`
+// (the engine behind VS Code's CSS support). An inline style is a declaration
+// list, not a full stylesheet, so we wrap it in a synthetic rule `*{ … }` and
+// shift positions by the 2-character prefix - the same trick VS Code uses for
+// embedded styles. Only static `style="…"` values reach here; `style={…}` is a
+// JavaScript expression handled by the TypeScript bridge.
+import { getCSSLanguageService } from 'vscode-css-languageservice';
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import { CompletionItemKind } from "../protocol.js";
+/** The `*{` we prepend so the declaration list parses as a stylesheet. */
+const WRAP_PREFIX = '*{';
+let service = null;
+const css = () => (service ??= getCSSLanguageService());
+/** The `[start, end)` of the style value's content around `offset`, or null. */
+function styleValueSpan(source, offset) {
+    let i = offset - 1;
+    while (i >= 0 && source[i] !== '"' && source[i] !== '\'' && source[i] !== '<' && source[i] !== '>') {
+        i--;
+    }
+    if (i < 0 || (source[i] !== '"' && source[i] !== '\'')) {
+        return null;
+    }
+    const quote = source[i];
+    const start = i + 1;
+    let j = offset;
+    while (j < source.length && source[j] !== quote && source[j] !== '<' && source[j] !== '>') {
+        j++;
+    }
+    return { start, end: j, quote };
+}
+/** Builds the wrapped CSS document and the caret offset within it. */
+function wrap(source, offset) {
+    const span = styleValueSpan(source, offset);
+    if (span === null) {
+        return null;
+    }
+    const content = source.slice(span.start, span.end);
+    const doc = TextDocument.create('inline://style.css', 'css', 0, `${WRAP_PREFIX}${content}}`);
+    return { doc, caret: WRAP_PREFIX.length + (offset - span.start), contentStart: span.start };
+}
+/** CSS property/value completion inside an inline `style="…"`. */
+export function cssCompletions(source, offset) {
+    const wrapped = wrap(source, offset);
+    if (wrapped === null) {
+        return [];
+    }
+    const stylesheet = css().parseStylesheet(wrapped.doc);
+    const list = css().doComplete(wrapped.doc, wrapped.doc.positionAt(wrapped.caret), stylesheet);
+    return list.items.map(item => ({
+        label: item.label,
+        kind: (item.kind ?? CompletionItemKind.Property),
+        detail: item.detail,
+        documentation: typeof item.documentation === 'string' ? item.documentation : item.documentation?.value,
+        insertText: item.textEdit && 'newText' in item.textEdit ? item.textEdit.newText : item.insertText ?? item.label,
+        insertTextFormat: item.insertTextFormat ?? 1,
+        sortText: item.sortText
+    }));
+}
+/** CSS hover (property/value docs) inside an inline `style="…"`. */
+export function cssHover(source, offset, lineIndex) {
+    const wrapped = wrap(source, offset);
+    if (wrapped === null) {
+        return null;
+    }
+    const stylesheet = css().parseStylesheet(wrapped.doc);
+    const hover = css().doHover(wrapped.doc, wrapped.doc.positionAt(wrapped.caret), stylesheet);
+    if (!hover) {
+        return null;
+    }
+    const contents = typeof hover.contents === 'string'
+        ? hover.contents
+        : Array.isArray(hover.contents)
+            ? hover.contents.map(part => (typeof part === 'string' ? part : part.value)).join('\n\n')
+            : hover.contents.value;
+    let range;
+    if (hover.range) {
+        // Map the css-doc range back to the original source.
+        const startOffset = wrapped.doc.offsetAt(hover.range.start) - WRAP_PREFIX.length + wrapped.contentStart;
+        const endOffset = wrapped.doc.offsetAt(hover.range.end) - WRAP_PREFIX.length + wrapped.contentStart;
+        range = lineIndex.rangeAt(startOffset, endOffset);
+    }
+    return { contents, range };
+}
+//# sourceMappingURL=css-service.js.map

package/dist/providers/css-service.js.map

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

package/dist/providers/diagnostics.d.ts

@@ -0,0 +1,5 @@
+import { type Diagnostic } from '../protocol.ts';
+import { type RequestContext } from '../request.ts';
+/** All diagnostics for the document. */
+export declare function getDiagnostics(ctx: RequestContext): Diagnostic[];
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/providers/diagnostics.ts"],"names":[],"mappings":"AAYA,OAAO,EAEH,KAAK,UAAU,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,EAAE,CAUhE"}

package/dist/providers/diagnostics.js

@@ -0,0 +1,89 @@
+// Diagnostics from two sources:
+//   1. The compiler's own parser - a CompileError (mismatched/closing tag,
+//      missing attribute value, ...) is reported at its exact offset.
+//   2. TypeScript's syntactic + semantic diagnostics over the virtual module,
+//      mapped back to original ranges. Diagnostics that land purely in
+//      generated scaffolding are dropped (there is no original code to flag),
+//      so what surfaces are genuine type errors in the user's expressions and
+//      script.
+import ts from 'typescript';
+import { findMarkupStart } from '@azerothjs/compiler';
+import { parseMarkup, CompileError } from '@azerothjs/compiler';
+import { DiagnosticSeverity } from "../protocol.js";
+/** All diagnostics for the document. */
+export function getDiagnostics(ctx) {
+    const markup = markupDiagnostics(ctx);
+    // A hard markup parse error means the virtual module is incomplete; TS
+    // diagnostics would be noise, so report only the markup error.
+    if (markup.length > 0) {
+        return markup;
+    }
+    return typeScriptDiagnostics(ctx);
+}
+/** Reports the first unparseable markup region as a CompileError diagnostic. */
+function markupDiagnostics(ctx) {
+    const out = [];
+    let i = 0;
+    for (;;) {
+        const start = findMarkupStart(ctx.source, i);
+        if (start === -1) {
+            break;
+        }
+        try {
+            const { end } = parseMarkup(ctx.source, start);
+            i = end;
+        }
+        catch (err) {
+            if (err instanceof CompileError) {
+                const at = Math.min(err.offset, ctx.source.length);
+                out.push({
+                    range: ctx.lineIndex.rangeAt(at, Math.min(at + 1, ctx.source.length)),
+                    severity: DiagnosticSeverity.Error,
+                    message: err.message,
+                    source: 'azeroth'
+                });
+            }
+            break;
+        }
+    }
+    return out;
+}
+/** TypeScript syntactic + semantic diagnostics, mapped to original ranges. */
+function typeScriptDiagnostics(ctx) {
+    const raw = [
+        ...ctx.project.service.getSyntacticDiagnostics(ctx.virtualFile),
+        ...ctx.project.service.getSemanticDiagnostics(ctx.virtualFile)
+    ];
+    const out = [];
+    for (const diag of raw) {
+        if (diag.start === undefined || diag.length === undefined) {
+            continue;
+        }
+        const mapped = ctx.virtual.mapping.toOriginalRange(diag.start, diag.start + diag.length);
+        if (mapped === null) {
+            continue;
+        }
+        out.push({
+            range: ctx.lineIndex.rangeAt(mapped.start, mapped.end),
+            severity: categoryToSeverity(diag.category),
+            message: ts.flattenDiagnosticMessageText(diag.messageText, '\n'),
+            code: diag.code,
+            source: 'azeroth-ts'
+        });
+    }
+    return out;
+}
+/** Maps a TS diagnostic category to an LSP severity. */
+function categoryToSeverity(category) {
+    switch (category) {
+        case ts.DiagnosticCategory.Error:
+            return DiagnosticSeverity.Error;
+        case ts.DiagnosticCategory.Warning:
+            return DiagnosticSeverity.Warning;
+        case ts.DiagnosticCategory.Suggestion:
+            return DiagnosticSeverity.Hint;
+        default:
+            return DiagnosticSeverity.Information;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/providers/diagnostics.js.map

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

package/dist/providers/editing.d.ts

@@ -0,0 +1,17 @@
+import type { Range } from '../protocol.ts';
+import type { RequestContext } from '../request.ts';
+/**
+ * After the user types `>`, returns a snippet that closes the just-opened tag
+ * (`$0</div>`), or null when there's nothing to close (self-closing tag, void
+ * element, fragment, or a `>` that wasn't a tag end).
+ *
+ * `offset` is the position immediately after the typed `>`.
+ */
+export declare function getAutoCloseTag(ctx: RequestContext, offset: number): string | null;
+/**
+ * Returns the opening- and closing-tag name ranges for the element under the
+ * caret, so the editor can edit them together (linked editing). Null unless the
+ * caret is on a tag name of an element that has a matching closing tag.
+ */
+export declare function getLinkedEditingRanges(ctx: RequestContext, offset: number): Range[] | null;
+//# sourceMappingURL=editing.d.ts.map

package/dist/providers/editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../../src/providers/editing.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AASpD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwClF;AAqGD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,IAAI,CAoB1F"}

package/dist/providers/editing.js

@@ -0,0 +1,176 @@
+// Markup editing behaviours that make `.azeroth` feel like a first-class
+// JSX-aware language:
+//
+//   - auto-close tags: typing the `>` of `<div>` returns `</div>` so the editor
+//     can complete the pair (mirroring VS Code's JSX behaviour);
+//   - linked editing: renaming an opening tag updates its closing tag live, and
+//     vice-versa.
+//
+// Both reuse the compiler's scanner (to skip strings/expressions correctly) and
+// parser (to understand structure), so a `<` inside an attribute expression
+// like `title={a < b}` is never mistaken for a tag.
+import { findMarkupStart, skipBalanced, skipString, isIdentStart, isIdentPart, isWhitespace } from '@azerothjs/compiler';
+import { parseMarkup } from '@azerothjs/compiler';
+import { collectMarkupNodes } from "../markup-model.js";
+/** Void HTML elements have no closing tag, so they are never auto-closed. */
+const VOID_ELEMENTS = new Set([
+    'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',
+    'link', 'meta', 'param', 'source', 'track', 'wbr'
+]);
+/**
+ * After the user types `>`, returns a snippet that closes the just-opened tag
+ * (`$0</div>`), or null when there's nothing to close (self-closing tag, void
+ * element, fragment, or a `>` that wasn't a tag end).
+ *
+ * `offset` is the position immediately after the typed `>`.
+ */
+export function getAutoCloseTag(ctx, offset) {
+    const source = ctx.source;
+    if (source[offset - 1] !== '>') {
+        return null;
+    }
+    // Find the markup region the caret is in, then walk its tags forward to the
+    // one whose opening tag ends exactly at the caret.
+    let i = 0;
+    for (;;) {
+        const start = findMarkupStart(source, i);
+        if (start === -1 || start >= offset) {
+            return null;
+        }
+        let parsedEnd;
+        try {
+            parsedEnd = parseMarkup(source, start).end;
+        }
+        catch {
+            parsedEnd = null;
+        }
+        if (parsedEnd === null || (start < offset && parsedEnd >= offset)) {
+            // This region contains (or is) the incomplete tag being typed.
+            const tag = tagEndingAt(source, start, offset);
+            if (tag === null || tag === '' || VOID_ELEMENTS.has(tag)) {
+                return null;
+            }
+            return `$0</${tag}>`;
+        }
+        i = parsedEnd;
+    }
+}
+/**
+ * Walks markup tags forward from a region start, returning the name of the
+ * opening tag whose `>` lands at `offset` (skipping completed children and
+ * expression holes), or null.
+ */
+function tagEndingAt(source, start, offset) {
+    let i = start;
+    while (i < offset) {
+        const ch = source[i];
+        if (ch === '{') {
+            i = skipBalanced(source, i);
+            continue;
+        }
+        if (ch !== '<') {
+            i++;
+            continue;
+        }
+        const next = source[i + 1];
+        if (next === '/') {
+            const gt = source.indexOf('>', i);
+            i = gt === -1 ? source.length : gt + 1;
+            continue;
+        }
+        if (next === '>' || isIdentStart(next)) {
+            const open = readOpenTag(source, i);
+            if (open === null) {
+                return null;
+            }
+            if (open.end === offset) {
+                return open.selfClosing ? null : open.tag;
+            }
+            i = open.end;
+            continue;
+        }
+        i++;
+    }
+    return null;
+}
+/** Reads a `<...>` opening tag, returning its name, end offset, and self-closing flag. */
+function readOpenTag(source, ltIndex) {
+    let i = ltIndex + 1;
+    if (source[i] === '>') {
+        return { tag: '', end: i + 1, selfClosing: false };
+    }
+    if (!isIdentStart(source[i])) {
+        return null;
+    }
+    const nameStart = i;
+    i++;
+    while (i < source.length && (isIdentPart(source[i]) || source[i] === '.' || source[i] === '-')) {
+        i++;
+    }
+    const tag = source.slice(nameStart, i);
+    while (i < source.length) {
+        const ch = source[i];
+        if (isWhitespace(ch)) {
+            i++;
+            continue;
+        }
+        if (ch === '>') {
+            return { tag, end: i + 1, selfClosing: false };
+        }
+        if (ch === '/' && source[i + 1] === '>') {
+            return { tag, end: i + 2, selfClosing: true };
+        }
+        if (ch === '{') {
+            i = skipBalanced(source, i);
+            continue;
+        }
+        if (ch === '"' || ch === '\'') {
+            i = skipString(source, i);
+            continue;
+        }
+        i++;
+    }
+    return null;
+}
+/**
+ * Returns the opening- and closing-tag name ranges for the element under the
+ * caret, so the editor can edit them together (linked editing). Null unless the
+ * caret is on a tag name of an element that has a matching closing tag.
+ */
+export function getLinkedEditingRanges(ctx, offset) {
+    for (const node of collectMarkupNodes(ctx.source)) {
+        if (node.kind !== 'element' || node.tag === '') {
+            continue;
+        }
+        const ranges = tagNameRanges(ctx, node);
+        if (ranges === null) {
+            continue;
+        }
+        const [open, close] = ranges;
+        if (within(open, offset) || within(close, offset)) {
+            return [ctx.lineIndex.rangeAt(open.start, open.end), ctx.lineIndex.rangeAt(close.start, close.end)];
+        }
+    }
+    return null;
+}
+/** Computes the opening/closing tag-name offset spans for an element, if it has a close tag. */
+function tagNameRanges(ctx, node) {
+    const source = ctx.source;
+    const openStart = node.start + 1;
+    const openEnd = openStart + node.tag.length;
+    // A closing tag occupies `</tag>` ending at node.end. Verify it's really there
+    // (self-closing elements end with `/>` and have no closing tag).
+    const closeEnd = node.end - 1;
+    const closeStart = closeEnd - node.tag.length;
+    if (closeStart < openEnd
+        || source[closeStart - 1] !== '/'
+        || source.slice(closeStart, closeEnd) !== node.tag) {
+        return null;
+    }
+    return [{ start: openStart, end: openEnd }, { start: closeStart, end: closeEnd }];
+}
+/** True when `offset` is inside (or touching) `[start, end]`. */
+function within(span, offset) {
+    return offset >= span.start && offset <= span.end;
+}
+//# sourceMappingURL=editing.js.map

package/dist/providers/editing.js.map

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

package/dist/providers/hover.d.ts

@@ -0,0 +1,5 @@
+import type { Hover } from '../protocol.ts';
+import { type RequestContext } from '../request.ts';
+/** Hover content for the caret at `offset`, or null. */
+export declare function getHover(ctx: RequestContext, offset: number): Hover | null;
+//# sourceMappingURL=hover.d.ts.map

package/dist/providers/hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../src/providers/hover.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAK5C,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9E,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAqE1E"}

package/dist/providers/hover.js

@@ -0,0 +1,213 @@
+// Hover, routed by caret context:
+//   - expression / script / text -> TypeScript quick-info at the mapped offset
+//     (authoritative signatures + JSDoc, full type inference);
+//   - a built-in component tag/prop -> the framework's documentation table;
+//   - a user component tag -> TypeScript quick-info (the tag is mapped 1:1);
+//   - a host element tag/attribute/value -> the HTML language service's
+//     MDN-backed hover.
+//
+// Context is decided first (not the offset map) so a host tag never shows a
+// stray TS result even when the surrounding markup is mid-edit.
+import ts from 'typescript';
+import { skipBalanced, skipString, skipTemplate, isWhitespace, isIdentPart } from '@azerothjs/compiler';
+import { classifyPosition, enclosingElement } from "../markup-model.js";
+import { BUILTIN_COMPONENT_MAP, attributeDocumentation } from "../language-data.js";
+import { htmlHover, eventDocumentation } from "./html-service.js";
+import { cssHover } from "./css-service.js";
+import { spanToRange, toGenerated } from "../request.js";
+/** Hover content for the caret at `offset`, or null. */
+export function getHover(ctx, offset) {
+    const context = classifyPosition(ctx.source, offset);
+    const position = ctx.lineIndex.positionAt(offset);
+    switch (context.kind) {
+        case 'expression':
+        case 'script':
+        case 'text':
+            return tsHover(ctx, offset);
+        case 'tagName':
+            {
+                const name = fullTagName(ctx, offset);
+                const builtin = BUILTIN_COMPONENT_MAP.get(name);
+                if (builtin) {
+                    return { contents: `**<${builtin.name}>** — built-in component\n\n${builtin.detail}\n\n${builtin.doc}` };
+                }
+                return isComponentName(name) ? tsHover(ctx, offset) : htmlHover(ctx.source, position);
+            }
+        case 'attributeName':
+            {
+                const attribute = fullAttributeName(ctx, offset);
+                // Component prop: read its type/JSDoc from the component's props
+                // type, falling back to the built-in table.
+                if (isComponentName(context.tag) || BUILTIN_COMPONENT_MAP.has(context.tag)) {
+                    const typed = typedPropHover(ctx, offset, attribute);
+                    if (typed) {
+                        return typed;
+                    }
+                    const prop = BUILTIN_COMPONENT_MAP.get(context.tag)?.props.find(candidate => candidate.name === attribute);
+                    return prop
+                        ? { contents: `**${prop.name}** — \`<${context.tag}>\` prop${prop.required ? ' (required)' : ''}\n\n${prop.doc}` }
+                        : null;
+                }
+                // AzerothJS binds camelCase events; the HTML engine only knows the
+                // lowercase form, so look its MDN docs up explicitly.
+                if (/^on[A-Z]/.test(attribute)) {
+                    const doc = eventDocumentation(attribute);
+                    return { contents: `**${attribute}** — DOM event handler${doc ? `\n\n${doc}` : ''}` };
+                }
+                // The HTML engine first; fall back to our docs for the common
+                // element attributes the standard dataset leaves undocumented.
+                const html = htmlHover(ctx.source, position);
+                if (html) {
+                    return html;
+                }
+                const fallback = attributeDocumentation(attribute);
+                return fallback ? { contents: `**${attribute}** — attribute\n\n${fallback}` } : null;
+            }
+        case 'attributeValue':
+            if (isComponentName(context.tag)) {
+                return null;
+            }
+            return context.attribute === 'style'
+                ? cssHover(ctx.source, offset, ctx.lineIndex)
+                : htmlHover(ctx.source, position);
+    }
+}
+/**
+ * Hover for a component prop, read from the component's props type (the same
+ * generated `Tag({ … })` object literal completion uses). Null when the type
+ * can't be resolved.
+ */
+function typedPropHover(ctx, offset, prop) {
+    const element = enclosingElement(ctx.source, offset);
+    if (!element || !element.isComponent) {
+        return null;
+    }
+    const generatedTag = ctx.virtual.mapping.toGenerated(element.start + 1);
+    if (generatedTag === null) {
+        return null;
+    }
+    const brace = ctx.virtual.code.indexOf('{', generatedTag + element.tag.length);
+    if (brace === -1) {
+        return null;
+    }
+    // Query the type at the generated property key (works whether or not other
+    // props are present, unlike completion details which skip filled props).
+    const key = propertyKeyOffset(ctx.virtual.code, brace, prop);
+    if (key === -1) {
+        return null;
+    }
+    const info = ctx.project.service.getQuickInfoAtPosition(ctx.virtualFile, key);
+    if (!info) {
+        return null;
+    }
+    const signature = ts.displayPartsToString(info.displayParts);
+    const doc = ts.displayPartsToString(info.documentation);
+    if (!signature && !doc) {
+        return null;
+    }
+    return { contents: '```typescript\n' + signature + '\n```' + (doc ? `\n\n${doc}` : '') };
+}
+/**
+ * Finds the offset of `prop`'s key inside the generated object literal that
+ * starts at `brace`, skipping over each entry's value (which may contain
+ * commas, braces, strings). Returns -1 if not present.
+ */
+function propertyKeyOffset(code, brace, prop) {
+    let i = brace + 1;
+    while (i < code.length) {
+        while (i < code.length && isWhitespace(code[i])) {
+            i++;
+        }
+        if (code[i] === '}' || i >= code.length) {
+            return -1;
+        }
+        const keyStart = i;
+        while (i < code.length && isIdentPart(code[i])) {
+            i++;
+        }
+        if (code.slice(keyStart, i) === prop) {
+            return keyStart;
+        }
+        while (i < code.length && code[i] !== ':' && code[i] !== ',' && code[i] !== '}') {
+            i++;
+        }
+        if (code[i] !== ':') {
+            // A spread (`...x`) or malformed entry; advance to the next one.
+            i = skipEntryValue(code, i);
+            continue;
+        }
+        i = skipEntryValue(code, i + 1);
+    }
+    return -1;
+}
+/** Skips an object-literal entry's value, stopping at a top-level `,` or `}`. */
+function skipEntryValue(code, start) {
+    let i = start;
+    while (i < code.length) {
+        const ch = code[i];
+        if (ch === ',') {
+            return i + 1;
+        }
+        if (ch === '}') {
+            return i;
+        }
+        if (ch === '"' || ch === '\'') {
+            i = skipString(code, i);
+            continue;
+        }
+        if (ch === '`') {
+            i = skipTemplate(code, i);
+            continue;
+        }
+        if (ch === '{' || ch === '(' || ch === '[') {
+            i = skipBalanced(code, i);
+            continue;
+        }
+        i++;
+    }
+    return i;
+}
+/** TypeScript quick-info at the mapped offset. */
+function tsHover(ctx, offset) {
+    const generated = toGenerated(ctx, offset);
+    if (generated === null) {
+        return null;
+    }
+    const info = ctx.project.service.getQuickInfoAtPosition(ctx.virtualFile, generated);
+    if (!info) {
+        return null;
+    }
+    const signature = ts.displayPartsToString(info.displayParts);
+    const doc = ts.displayPartsToString(info.documentation);
+    const contents = '```typescript\n' + signature + '\n```' + (doc ? `\n\n${doc}` : '');
+    return { contents, range: spanToRange(ctx, info.textSpan) ?? undefined };
+}
+/** True for a component tag name (PascalCase or dotted). */
+function isComponentName(name) {
+    return /^[A-Z]/.test(name) || name.includes('.');
+}
+/** The full tag name under the caret (the model only knows the typed prefix). */
+function fullTagName(ctx, offset) {
+    let start = offset;
+    while (start > 0 && /[A-Za-z0-9_$.-]/.test(ctx.source[start - 1]) && ctx.source[start - 1] !== '<') {
+        start--;
+    }
+    let end = offset;
+    while (end < ctx.source.length && /[A-Za-z0-9_$.-]/.test(ctx.source[end])) {
+        end++;
+    }
+    return ctx.source.slice(start, end);
+}
+/** The full attribute name under the caret. */
+function fullAttributeName(ctx, offset) {
+    let start = offset;
+    while (start > 0 && /[A-Za-z0-9_$:-]/.test(ctx.source[start - 1])) {
+        start--;
+    }
+    let end = offset;
+    while (end < ctx.source.length && /[A-Za-z0-9_$:-]/.test(ctx.source[end])) {
+        end++;
+    }
+    return ctx.source.slice(start, end);
+}
+//# sourceMappingURL=hover.js.map

package/dist/providers/hover.js.map

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