@markup-carve/carve-lsp 0.1.3 → 0.1.4

package/dist/workspace-index.js

@@ -0,0 +1,254 @@
+import { DiagnosticSeverity, SymbolKind, } from 'vscode-languageserver/node.js';
+import { parse, resolve } from '@markup-carve/carve';
+/**
+ * Versioned semantic inventory shared by workspace-facing LSP features.
+ *
+ * It deliberately stores authored tokens rather than parser nodes. Nodes are
+ * excellent for meaning, but rename/reference edits need the exact source
+ * range of the identifier and included files need a stable URI even when the
+ * current edit is temporarily malformed.
+ */
+export class WorkspaceIndex {
+    #documents = new Map();
+    update(uri, source, version) {
+        const current = this.#documents.get(uri);
+        if (current?.version === version && current.source === source)
+            return;
+        this.#documents.set(uri, { version, source, tokens: scanDocument(uri, source) });
+    }
+    remove(uri) {
+        this.#documents.delete(uri);
+    }
+    clear() {
+        this.#documents.clear();
+    }
+    tokens(uri) {
+        if (uri !== undefined)
+            return [...(this.#documents.get(uri)?.tokens ?? [])];
+        return [...this.#documents.values()].flatMap((document) => document.tokens);
+    }
+    documents() {
+        return [...this.#documents].map(([uri, document]) => ({
+            uri,
+            source: document.source,
+            tokens: [...document.tokens],
+        }));
+    }
+    tokenAt(uri, position) {
+        const candidates = this.tokens(uri).filter((token) => contains(token.range, position));
+        candidates.sort((a, b) => rangeSize(a.range) - rangeSize(b.range));
+        return candidates[0] ?? null;
+    }
+    definitions(kind, key) {
+        return this.tokens().filter((token) => token.declaration && sameIdentity(token, kind, key));
+    }
+    references(kind, key, includeDeclaration = false) {
+        return this.tokens()
+            .filter((token) => (includeDeclaration || !token.declaration) && sameIdentity(token, kind, key))
+            .map(({ uri, range }) => ({ uri, range }));
+    }
+    symbols(query = '') {
+        const wanted = query.toLocaleLowerCase();
+        return this.tokens()
+            .filter((token) => token.declaration && token.key.toLocaleLowerCase().includes(wanted))
+            .map((token) => ({
+            name: token.label ?? token.key,
+            kind: symbolKind(token.kind),
+            location: { uri: token.uri, range: token.range },
+            containerName: token.kind,
+        }));
+    }
+    diagnostics(uri) {
+        const diagnostics = [];
+        const tokens = this.tokens(uri);
+        for (const token of tokens) {
+            if (!token.declaration && this.definitions(token.kind, token.key).length === 0) {
+                diagnostics.push({
+                    range: token.range,
+                    severity: DiagnosticSeverity.Warning,
+                    source: 'carve-workspace',
+                    code: `workspace-unresolved-${token.kind}`,
+                    message: `No ${token.kind} declaration named ${JSON.stringify(token.key)} exists in the workspace.`,
+                });
+            }
+            if (token.declaration) {
+                const declarations = this.definitions(token.kind, token.key);
+                const first = declarations[0];
+                if (declarations.length > 1 && first && (first.uri !== token.uri || first.range.start.line !== token.range.start.line)) {
+                    diagnostics.push({
+                        range: token.range,
+                        severity: DiagnosticSeverity.Error,
+                        source: 'carve-workspace',
+                        code: `workspace-duplicate-${token.kind}`,
+                        message: `Duplicate workspace ${token.kind} declaration ${JSON.stringify(token.key)}.`,
+                        relatedInformation: [{ location: { uri: first.uri, range: first.range }, message: 'First declaration' }],
+                    });
+                }
+            }
+        }
+        return diagnostics;
+    }
+    rename(uri, position, newName) {
+        const target = this.tokenAt(uri, position);
+        if (!target || !isValidName(target.kind, newName))
+            return null;
+        const edits = new Map();
+        for (const token of this.tokens()) {
+            if (!sameIdentity(token, target.kind, target.key))
+                continue;
+            const entries = edits.get(token.uri) ?? [];
+            entries.push(token.generated && token.declaration
+                ? {
+                    range: { start: { line: token.range.start.line, character: 0 }, end: { line: token.range.start.line, character: 0 } },
+                    newText: `{#${newName}}\n`,
+                }
+                : { range: token.range, newText: newName });
+            edits.set(token.uri, entries);
+        }
+        return { changes: Object.fromEntries(edits) };
+    }
+}
+export function scanDocument(uri, source) {
+    const tokens = [];
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    for (let line = 0; line < lines.length; line += 1) {
+        const text = lines[line];
+        const heading = /^(#{1,6}) (.*)$/.exec(text);
+        if (heading) {
+            const explicit = /\{#([^\s}]+)(?:\s[^}]*)?\}\s*$/.exec(heading[2]);
+            if (explicit)
+                push(tokens, uri, 'heading', explicit[1], line, text.indexOf(explicit[1]), true);
+        }
+        const attributed = /^\{[^}]*#([^\s}]+)[^}]*\}\s*$/.exec(text);
+        if (attributed) {
+            const next = lines[line + 1] ?? '';
+            const kind = /^#{1,6} /.test(next) ? 'heading' : 'caption';
+            push(tokens, uri, kind, attributed[1], line, text.indexOf(attributed[1]), true);
+        }
+        const footnoteDef = /^(?: {0,3})\[\^([^\]]+)\]:/.exec(text);
+        if (footnoteDef)
+            push(tokens, uri, 'footnote', footnoteDef[1], line, text.indexOf(footnoteDef[1]), true);
+        const citationDef = /^(?: {0,3})\[@([^\]]+)\]:/.exec(text);
+        if (citationDef)
+            push(tokens, uri, 'citation', citationDef[1], line, text.indexOf(citationDef[1]), true);
+        const linkDef = /^(?: {0,3})\[([^\]^@][^\]]*)\]:/.exec(text);
+        if (linkDef)
+            push(tokens, uri, 'linkref', linkDef[1], line, text.indexOf(linkDef[1]), true);
+        for (const match of text.matchAll(/<\/#([^>\s]+)>|\]\(#([^\s)]+)\)/g)) {
+            const key = match[1] ?? match[2];
+            const start = match.index + match[0].indexOf(key);
+            push(tokens, uri, 'heading', key, line, start, false);
+        }
+        for (const match of text.matchAll(/\[\^([^\]]+)\](?!:)/g)) {
+            push(tokens, uri, 'footnote', match[1], line, match.index + 2, false);
+        }
+        for (const match of text.matchAll(/\]\[([^\]]+)\]/g)) {
+            if (match[1] === '' || match[1].startsWith('^') || match[1].startsWith('@'))
+                continue;
+            push(tokens, uri, 'linkref', match[1], line, match.index + 2, false);
+        }
+        for (const group of text.matchAll(/\[([^\]]*@[^^\]]+)\]/g)) {
+            if (citationDef && group.index === text.indexOf(`[@${citationDef[1]}]`))
+                continue;
+            for (const cite of group[1].matchAll(/@([\p{L}\p{N}_:.+-]+)/gu)) {
+                push(tokens, uri, 'citation', cite[1], line, group.index + 1 + cite.index + 1, false);
+            }
+        }
+    }
+    // Generated heading ids come from the resolver, which is authoritative for
+    // Unicode, inline markup, and duplicate suffixes. The lexical inventory
+    // above remains available when a document is temporarily malformed.
+    try {
+        const document = resolve(parse(source, { positions: true }));
+        walkBlocks(document.children, (node) => {
+            if (node.type !== 'heading' || !node.pos || !node.attrs?.id)
+                return;
+            const line = node.pos.startLine - 1;
+            const alreadyAuthored = tokens.some((token) => token.declaration && anchorKind(token.kind) && token.key === node.attrs?.id &&
+                (token.range.start.line === line || token.range.start.line === line - 1));
+            if (alreadyAuthored)
+                return;
+            const lineText = lines[line] ?? '';
+            const start = Math.min(lineText.length, /^#{1,6}\s+/.exec(lineText)?.[0].length ?? 0);
+            tokens.push({
+                kind: 'heading', key: node.attrs.id, uri, declaration: true, generated: true,
+                label: inlineText(node.children) || node.attrs.id,
+                range: { start: { line, character: start }, end: { line, character: lineText.length } },
+            });
+        });
+    }
+    catch {
+        // Keep tolerant lexical results while the edit is broken.
+    }
+    return dedupe(tokens);
+}
+function walkBlocks(nodes, visit) {
+    for (const node of nodes) {
+        visit(node);
+        if ('children' in node && Array.isArray(node.children)) {
+            walkBlocks(node.children.filter((child) => Boolean(child && typeof child === 'object' && 'type' in child && !inlineKinds.has(child.type))), visit);
+        }
+    }
+}
+const inlineKinds = new Set(['text', 'softbreak', 'linebreak', 'emph', 'strong', 'underline', 'strikethrough', 'highlight', 'superscript', 'subscript', 'code', 'verbatim', 'math', 'link', 'image', 'crossref', 'footnote', 'citation', 'symbol', 'smart', 'span']);
+function inlineText(nodes) {
+    return nodes.map((node) => {
+        if ('value' in node && typeof node.value === 'string')
+            return node.value;
+        if ('children' in node && Array.isArray(node.children))
+            return inlineText(node.children);
+        return '';
+    }).join('').trim();
+}
+function push(tokens, uri, kind, key, line, character, declaration) {
+    tokens.push({
+        kind,
+        key,
+        uri,
+        declaration,
+        range: {
+            start: { line, character },
+            end: { line, character: character + key.length },
+        },
+    });
+}
+function dedupe(tokens) {
+    const seen = new Set();
+    return tokens.filter((token) => {
+        const id = `${token.kind}:${token.key}:${token.range.start.line}:${token.range.start.character}:${token.declaration}`;
+        if (seen.has(id))
+            return false;
+        seen.add(id);
+        return true;
+    });
+}
+function sameIdentity(token, kind, key) {
+    const sameKind = token.kind === kind || (anchorKind(token.kind) && anchorKind(kind));
+    return sameKind && token.key.toLocaleLowerCase() === key.toLocaleLowerCase();
+}
+function anchorKind(kind) {
+    return kind === 'heading' || kind === 'caption';
+}
+function contains(range, position) {
+    return position.line === range.start.line && position.character >= range.start.character && position.character <= range.end.character;
+}
+function rangeSize(range) {
+    return (range.end.line - range.start.line) * 1_000_000 + range.end.character - range.start.character;
+}
+function symbolKind(kind) {
+    if (kind === 'heading')
+        return SymbolKind.Namespace;
+    if (kind === 'caption')
+        return SymbolKind.Object;
+    if (kind === 'citation')
+        return SymbolKind.Key;
+    return SymbolKind.Variable;
+}
+function isValidName(kind, value) {
+    if (value.length === 0 || /[\[\]\r\n]/.test(value))
+        return false;
+    if (kind === 'heading' || kind === 'caption' || kind === 'citation')
+        return !/\s/.test(value);
+    return true;
+}
+//# sourceMappingURL=workspace-index.js.map

package/dist/workspace-index.js.map

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

package/dist/workspace-index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/workspace-index.test.js

@@ -0,0 +1,65 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { WorkspaceIndex, scanDocument } from './workspace-index.js';
+test('indexes declarations and uses across Carve namespaces', () => {
+    const tokens = scanDocument('file:///a.crv', '{#intro}\n# Intro\n\nSee </#intro> and [^n].\n\n[^n]: note\n');
+    assert.deepEqual(tokens.map(({ kind, key, declaration }) => ({ kind, key, declaration })), [
+        { kind: 'heading', key: 'intro', declaration: true },
+        { kind: 'heading', key: 'intro', declaration: false },
+        { kind: 'footnote', key: 'n', declaration: false },
+        { kind: 'footnote', key: 'n', declaration: true },
+    ]);
+});
+test('finds references and renames across indexed documents', () => {
+    const index = new WorkspaceIndex();
+    index.update('file:///a.crv', '[^note]: body\n', 1);
+    index.update('file:///b.crv', 'Use [^note].\n', 1);
+    assert.equal(index.references('footnote', 'note', true).length, 2);
+    const edit = index.rename('file:///b.crv', { line: 0, character: 7 }, 'source');
+    assert.deepEqual(Object.keys(edit?.changes ?? {}).sort(), ['file:///a.crv', 'file:///b.crv']);
+});
+test('versioned updates replace stale tokens and removal clears them', () => {
+    const index = new WorkspaceIndex();
+    index.update('file:///a.crv', '[^old]: body\n', 1);
+    index.update('file:///a.crv', '[^new]: body\n', 2);
+    assert.equal(index.definitions('footnote', 'old').length, 0);
+    assert.equal(index.definitions('footnote', 'new').length, 1);
+    index.remove('file:///a.crv');
+    assert.equal(index.tokens().length, 0);
+});
+test('indexes generated heading ids and materializes an explicit id when renamed', () => {
+    const index = new WorkspaceIndex();
+    index.update('file:///a.crv', '# Hello *World*\n', 1);
+    index.update('file:///b.crv', 'See </#Hello-World>.\n', 1);
+    assert.equal(index.definitions('heading', 'Hello-World')[0]?.label, 'Hello World');
+    assert.deepEqual(index.rename('file:///b.crv', { line: 0, character: 9 }, 'greeting'), {
+        changes: {
+            'file:///a.crv': [{
+                    range: { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } },
+                    newText: '{#greeting}\n',
+                }],
+            'file:///b.crv': [{
+                    range: { start: { line: 0, character: 7 }, end: { line: 0, character: 18 } },
+                    newText: 'greeting',
+                }],
+        },
+    });
+});
+test('headings and captions share the document anchor namespace', () => {
+    const index = new WorkspaceIndex();
+    index.update('file:///a.crv', '{#plot}\n![Plot](plot.svg)\n', 1);
+    index.update('file:///b.crv', 'See </#plot>.\n', 1);
+    assert.equal(index.definitions('heading', 'plot')[0]?.kind, 'caption');
+});
+test('reports workspace-wide dead references and duplicate declarations', () => {
+    const index = new WorkspaceIndex();
+    index.update('file:///a.crv', '{#same}\n# A\n', 1);
+    index.update('file:///b.crv', '{#same}\n# B\n\nSee </#missing>.\n', 1);
+    const diagnostics = index.diagnostics('file:///b.crv');
+    assert.deepEqual(diagnostics.map(({ code }) => code), [
+        'workspace-duplicate-heading',
+        'workspace-unresolved-heading',
+    ]);
+    assert.equal(diagnostics[0]?.relatedInformation?.[0]?.location.uri, 'file:///a.crv');
+});
+//# sourceMappingURL=workspace-index.test.js.map

package/dist/workspace-index.test.js.map

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

package/dist/workspace-loader.d.ts

@@ -0,0 +1,11 @@
+import type { WorkspaceIndex } from './workspace-index.js';
+export interface WorkspaceLoadResult {
+    files: number;
+    bytes: number;
+    truncated: boolean;
+}
+/** Bounded initial workspace census; open documents subsequently replace disk snapshots. */
+export declare function indexWorkspace(index: WorkspaceIndex, roots: readonly string[], limits?: {
+    maxFiles?: number;
+    maxBytes?: number;
+}): WorkspaceLoadResult;

package/dist/workspace-loader.js

@@ -0,0 +1,50 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** Bounded initial workspace census; open documents subsequently replace disk snapshots. */
+export function indexWorkspace(index, roots, limits = {}) {
+    const maxFiles = limits.maxFiles ?? 10_000;
+    const maxBytes = limits.maxBytes ?? 64 * 1024 * 1024;
+    let files = 0;
+    let bytes = 0;
+    let truncated = false;
+    const pending = [...roots];
+    while (pending.length > 0) {
+        const directory = pending.pop();
+        let entries;
+        try {
+            entries = readdirSync(directory, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.name === '.git' || entry.name === 'node_modules')
+                continue;
+            const absolute = path.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                pending.push(absolute);
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith('.crv'))
+                continue;
+            if (files >= maxFiles) {
+                truncated = true;
+                return { files, bytes, truncated };
+            }
+            try {
+                const size = statSync(absolute).size;
+                if (bytes + size > maxBytes) {
+                    truncated = true;
+                    return { files, bytes, truncated };
+                }
+                index.update(pathToFileURL(absolute).toString(), readFileSync(absolute, 'utf8'), `disk:${statSync(absolute).mtimeMs}`);
+                files += 1;
+                bytes += size;
+            }
+            catch { /* A racing file is simply absent from this snapshot. */ }
+        }
+    }
+    return { files, bytes, truncated };
+}
+//# sourceMappingURL=workspace-loader.js.map

package/dist/workspace-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-loader.js","sourceRoot":"","sources":["../src/workspace-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AASxC,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAC5B,KAAqB,EACrB,KAAwB,EACxB,SAAmD,EAAE;IAErD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAA;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;IACpD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAA;IAC1B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAG,CAAA;QAChC,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YAAC,OAAO,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAQ;QAAC,CAAC;QACpF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;gBAAE,SAAQ;YACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACjD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACtB,SAAQ;YACV,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,SAAQ;YAC7D,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAAC,SAAS,GAAG,IAAI,CAAC;gBAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;YAAC,CAAC;YAC/E,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAA;gBACpC,IAAI,KAAK,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC;oBAAC,SAAS,GAAG,IAAI,CAAC;oBAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;gBAAC,CAAC;gBACrF,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;gBACtH,KAAK,IAAI,CAAC,CAAA;gBACV,KAAK,IAAI,IAAI,CAAA;YACf,CAAC;YAAC,MAAM,CAAC,CAAC,wDAAwD,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACpC,CAAC"}

package/dist/workspace-loader.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/workspace-loader.test.js

@@ -0,0 +1,19 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { WorkspaceIndex } from './workspace-index.js';
+import { indexWorkspace } from './workspace-loader.js';
+test('indexes bounded .crv workspace files and ignores dependency directories', () => {
+    const root = mkdtempSync(path.join(tmpdir(), 'carve-workspace-'));
+    mkdirSync(path.join(root, 'chapters'));
+    mkdirSync(path.join(root, 'node_modules'));
+    writeFileSync(path.join(root, 'chapters', 'a.crv'), '[^a]: note\n');
+    writeFileSync(path.join(root, 'node_modules', 'hidden.crv'), '[^hidden]: no\n');
+    const index = new WorkspaceIndex();
+    assert.deepEqual(indexWorkspace(index, [root]), { files: 1, bytes: 11, truncated: false });
+    assert.equal(index.definitions('footnote', 'a').length, 1);
+    assert.equal(index.definitions('footnote', 'hidden').length, 0);
+});
+//# sourceMappingURL=workspace-loader.test.js.map

package/dist/workspace-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-loader.test.js","sourceRoot":"","sources":["../src/workspace-loader.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAA;IACjE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;IACtC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;IAC1C,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,CAAC,CAAA;IACnE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,iBAAiB,CAAC,CAAA;IAC/E,MAAM,KAAK,GAAG,IAAI,cAAc,EAAE,CAAA;IAClC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1F,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markup-carve/carve-lsp",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Language server for Carve markup documents",
   "license": "MIT",
@@ -23,7 +23,8 @@
     ".": {
       "import": "./dist/analyze.js",
       "types": "./dist/analyze.d.ts"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist"
@@ -38,7 +39,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@markup-carve/carve": "0.1.4",
+    "@markup-carve/carve": "0.1.5",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12"
   },