@markup-carve/carve-lsp 0.1.0

package/dist/completion.js

@@ -0,0 +1,91 @@
+import { CompletionItemKind, } from 'vscode-languageserver/node.js';
+import { parse, resolve } from '@markup-carve/carve';
+/** The eight canonical admonition kinds (grammar PART 9 §12, Tier 1). */
+const ADMONITIONS = ['note', 'tip', 'warning', 'danger', 'info', 'success', 'example', 'quote'];
+/**
+ * Context-aware completions driven by the text immediately before the cursor:
+ *   - `::: ` opens an admonition -> canonical kinds
+ *   - `</#`  cross-reference     -> heading ids in the document
+ *   - `[^`   footnote reference  -> defined footnote labels
+ *   - `][`   reference link      -> defined link reference labels
+ */
+export function completionAt(source, position) {
+    const line = source.split(/\r?\n/)[position.line] ?? '';
+    const prefix = line.slice(0, position.character);
+    let match;
+    if ((match = /:::\s*([\w-]*)$/.exec(prefix))) {
+        return ADMONITIONS.map((kind) => completion(kind, CompletionItemKind.Keyword, match[1], position, 'Admonition kind'));
+    }
+    if ((match = /<\/#([\w-]*)$/.exec(prefix))) {
+        return headingIds(source).map((id) => completion(id, CompletionItemKind.Reference, match[1], position, 'Heading id'));
+    }
+    if ((match = /\[\^([\w-]*)$/.exec(prefix))) {
+        return footnoteLabels(source).map((label) => completion(label, CompletionItemKind.Reference, match[1], position, 'Footnote'));
+    }
+    if ((match = /\]\[([\w-]*)$/.exec(prefix))) {
+        return linkReferenceLabels(source).map((label) => completion(label, CompletionItemKind.Reference, match[1], position, 'Link reference'));
+    }
+    return [];
+}
+function completion(value, kind, partial, position, detail) {
+    return {
+        label: value,
+        kind,
+        detail,
+        // Replace the partial token the user already typed so values containing
+        // `-` or `#` are not mangled by the editor's default word range.
+        textEdit: {
+            range: {
+                start: { line: position.line, character: position.character - partial.length },
+                end: position,
+            },
+            newText: value,
+        },
+    };
+}
+function headingIds(source) {
+    const ids = [];
+    try {
+        const doc = resolve(parse(source));
+        walkBlocks(doc.children, (node) => {
+            if (node.type === 'heading' && node.attrs?.id)
+                ids.push(node.attrs.id);
+        });
+    }
+    catch {
+        // Parsing may fail mid-edit; offer no ids rather than throwing.
+    }
+    return [...new Set(ids)];
+}
+function footnoteLabels(source) {
+    try {
+        const doc = resolve(parse(source));
+        return Object.keys(doc.footnoteDefs ?? {});
+    }
+    catch {
+        return [];
+    }
+}
+/** Scrape `[label]: url` reference definitions straight from the source. */
+function linkReferenceLabels(source) {
+    const labels = new Set();
+    for (const line of source.split(/\r?\n/)) {
+        const match = /^\s{0,3}\[([^\]]+)\]:\s+\S/.exec(line);
+        // `[^label]:` is a footnote definition, not a link reference definition.
+        if (match && !match[1].startsWith('^'))
+            labels.add(match[1]);
+    }
+    return [...labels];
+}
+function walkBlocks(nodes, visit) {
+    for (const node of nodes) {
+        visit(node);
+        if ('children' in node && Array.isArray(node.children)) {
+            walkBlocks(node.children.filter(isBlockNode), visit);
+        }
+    }
+}
+function isBlockNode(node) {
+    return Boolean(node && typeof node === 'object' && 'type' in node);
+}
+//# sourceMappingURL=completion.js.map

package/dist/completion.js.map

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

package/dist/completion.test.d.ts

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

package/dist/completion.test.js

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { completionAt } from './completion.js';
+const labels = (source, line, character) => completionAt(source, { line, character }).map((item) => item.label);
+test('suggests admonition kinds after a colon fence', () => {
+    const items = labels(':::', 0, 3);
+    assert.ok(items.includes('note'));
+    assert.ok(items.includes('warning'));
+});
+test('suggests heading ids for a cross-reference', () => {
+    const source = '# Hello World\n\n</#';
+    // carve-js derives case-preserving heading ids (spaces -> hyphens).
+    assert.deepEqual(labels(source, 2, 3), ['Hello-World']);
+});
+test('suggests defined footnote labels', () => {
+    const source = 'text[^a]\n\n[^a]: note\n\n[^';
+    assert.deepEqual(labels(source, 4, 2), ['a']);
+});
+test('suggests link reference labels', () => {
+    const source = '[site]: https://example.com\n\nsee [text][';
+    assert.deepEqual(labels(source, 2, 11), ['site']);
+});
+test('does not offer footnote definitions as link references', () => {
+    const source = '[site]: https://example.com\n[^fn]: a footnote\n\nsee [text][';
+    assert.deepEqual(labels(source, 3, 11), ['site']);
+});
+test('returns nothing in plain prose', () => {
+    assert.deepEqual(labels('just some text', 0, 9), []);
+});
+test('completion replaces the typed partial', () => {
+    const items = completionAt('</#hel', { line: 0, character: 6 });
+    // Nothing to complete against (no headings) -> empty, but must not throw.
+    assert.deepEqual(items, []);
+});
+//# sourceMappingURL=completion.test.js.map

package/dist/completion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.test.js","sourceRoot":"","sources":["../src/completion.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,SAAiB,EAAY,EAAE,CAC3E,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAErE,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACtD,MAAM,MAAM,GAAG,sBAAsB,CAAA;IACrC,oEAAoE;IACpE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;AACzD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAG,8BAA8B,CAAA;IAC7C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC1C,MAAM,MAAM,GAAG,4CAA4C,CAAA;IAC3D,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AACnD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,wDAAwD,EAAE,GAAG,EAAE;IAClE,MAAM,MAAM,GAAG,+DAA+D,CAAA;IAC9E,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AACnD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC1C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACtD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAA;IAC/D,0EAA0E;IAC1E,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC7B,CAAC,CAAC,CAAA"}

package/dist/definition.d.ts

@@ -0,0 +1,12 @@
+import { type Location, type Position } from 'vscode-languageserver/node.js';
+/**
+ * Go-to-definition for Carve constructs:
+ *
+ * - Cross-reference  `</#id>`         -> the heading whose generated id is `id`
+ * - Fragment link    `[text](#id)`     -> same (href starts with `#`)
+ * - Footnote ref     `[^name]`         -> the `[^name]:` definition line
+ * - Link reference   `[text][ref]`     -> the `[ref]:` definition line
+ * - Citation         `[@key]`          -> the `[@key]:` definition line
+ * - Wikilink         `[[Page]]`        -> heading whose text matches Page (best-effort)
+ */
+export declare function definitionAt(uri: string, source: string, position: Position): Location | null;

package/dist/definition.js

@@ -0,0 +1,280 @@
+import { parse, resolve } from '@markup-carve/carve';
+/**
+ * Go-to-definition for Carve constructs:
+ *
+ * - Cross-reference  `</#id>`         -> the heading whose generated id is `id`
+ * - Fragment link    `[text](#id)`     -> same (href starts with `#`)
+ * - Footnote ref     `[^name]`         -> the `[^name]:` definition line
+ * - Link reference   `[text][ref]`     -> the `[ref]:` definition line
+ * - Citation         `[@key]`          -> the `[@key]:` definition line
+ * - Wikilink         `[[Page]]`        -> heading whose text matches Page (best-effort)
+ */
+export function definitionAt(uri, source, position) {
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    const line = lines[position.line] ?? '';
+    // 1. Citation [@key] - check before link-ref so `[@foo]` doesn't match as link-ref
+    const citationTarget = resolveCitationAt(lines, line, position);
+    if (citationTarget !== null)
+        return locationAtLine(uri, citationTarget);
+    // 2. Cross-reference </#id> or fragment link [text](#id)
+    const crossrefTarget = resolveCrossrefAt(uri, source, line, position);
+    if (crossrefTarget !== null)
+        return crossrefTarget;
+    // 3. Footnote reference [^name]
+    const footnoteTarget = resolveFootnoteAt(lines, line, position);
+    if (footnoteTarget !== null)
+        return locationAtLine(uri, footnoteTarget);
+    // 4. Link reference [text][ref] or collapsed [ref][]
+    const linkrefTarget = resolveLinkrefAt(lines, line, position);
+    if (linkrefTarget !== null)
+        return locationAtLine(uri, linkrefTarget);
+    // 5. Wikilink [[Page]]
+    const wikilinkTarget = resolveWikilinkAt(uri, source, line, position);
+    if (wikilinkTarget !== null)
+        return wikilinkTarget;
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Citation: [@key] or [text; @key] -- navigate to the [@key]: definition line
+// ---------------------------------------------------------------------------
+function resolveCitationAt(lines, line, position) {
+    // Find all citation groups on the line: [...@key...]
+    // A citation key appears after @ inside [...]
+    const citationGroupRe = /\[([^\]]*@[^\]]*)\]/g;
+    for (const m of line.matchAll(citationGroupRe)) {
+        const start = m.index;
+        const end = start + m[0].length;
+        if (position.character < start || position.character >= end)
+            continue;
+        // Extract the key that the cursor is on
+        const inner = m[1];
+        // Keys: @key tokens separated by ; optionally prefixed with +/-
+        const keyRe = /-?@([A-Za-z0-9_.:-]+)/g;
+        for (const km of inner.matchAll(keyRe)) {
+            // offset of key label relative to full match
+            const keyAbsStart = start + 1 + km.index + 1; // skip '[' then '-?' then '@'
+            const keyAbsEnd = keyAbsStart + km[1].length;
+            if (position.character < start + 1 + km.index || position.character > keyAbsEnd)
+                continue;
+            const key = km[1];
+            // Find [@key]: definition line
+            return findCitationDef(lines, key);
+        }
+    }
+    return null;
+}
+function findCitationDef(lines, key) {
+    const defRe = new RegExp(`^\\[@${escapeRegExp(key)}\\]:`);
+    for (let i = 0; i < lines.length; i++) {
+        if (defRe.test(lines[i]))
+            return i;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Cross-reference: </#id> or [text](#id) -> heading
+// ---------------------------------------------------------------------------
+function resolveCrossrefAt(uri, source, line, position) {
+    // Pattern 1: </#id>
+    const crossrefRe = /<\/#([A-Za-z0-9_.:-]+)>/g;
+    for (const m of line.matchAll(crossrefRe)) {
+        const start = m.index;
+        const end = start + m[0].length;
+        if (position.character < start || position.character >= end)
+            continue;
+        return findHeadingById(uri, source, m[1]);
+    }
+    // Pattern 2: [text](#id) - inline link to a fragment
+    const fragLinkRe = /\[[^\]]*\]\(#([A-Za-z0-9_.:-]+)[^)]*\)/g;
+    for (const m of line.matchAll(fragLinkRe)) {
+        const start = m.index;
+        const end = start + m[0].length;
+        if (position.character < start || position.character >= end)
+            continue;
+        return findHeadingById(uri, source, m[1]);
+    }
+    return null;
+}
+function findHeadingById(uri, source, targetId) {
+    let doc;
+    try {
+        doc = resolve(parse(source));
+    }
+    catch {
+        return null;
+    }
+    const heading = findHeadingWithId(doc.children, targetId.toLowerCase());
+    if (!heading || !heading.pos)
+        return null;
+    const line = heading.pos.startLine - 1;
+    return {
+        uri,
+        range: {
+            start: { line, character: 0 },
+            end: { line, character: (heading.pos.endColumn ?? 200) - 1 },
+        },
+    };
+}
+function findHeadingWithId(nodes, targetId) {
+    for (const node of nodes) {
+        if (node.type === 'heading') {
+            const headingId = node.attrs?.id;
+            if (headingId && headingId.toLowerCase() === targetId)
+                return node;
+        }
+        if ('children' in node && Array.isArray(node.children)) {
+            const found = findHeadingWithId(node.children.filter(isBlockNode), targetId);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+function isBlockNode(node) {
+    return Boolean(node && typeof node === 'object' && 'type' in node);
+}
+// ---------------------------------------------------------------------------
+// Footnote reference [^name] -> definition line [^name]: ...
+// ---------------------------------------------------------------------------
+function resolveFootnoteAt(lines, line, position) {
+    const fnRefRe = /\[\^([^\]\s]+)\]/g;
+    for (const m of line.matchAll(fnRefRe)) {
+        const start = m.index;
+        const end = start + m[0].length;
+        if (position.character < start || position.character >= end)
+            continue;
+        const label = m[1];
+        // Find the definition (starts at line beginning: [^label]: ...)
+        return findFootnoteDef(lines, label);
+    }
+    return null;
+}
+function findFootnoteDef(lines, label) {
+    const defRe = new RegExp(`^\\[\\^${escapeRegExp(label)}\\]:`);
+    for (let i = 0; i < lines.length; i++) {
+        if (defRe.test(lines[i]))
+            return i;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Link reference [text][ref] or [ref][] -> definition line [ref]: url
+// ---------------------------------------------------------------------------
+function resolveLinkrefAt(lines, line, position) {
+    // Match ][label] (full reference) or ][](collapsed) — exclude footnotes
+    const fullRefRe = /\]\[([^\]^][^\]]*)\]/g;
+    for (const m of line.matchAll(fullRefRe)) {
+        // cursor is on the label portion (after `][`)
+        const labelStart = m.index + 2;
+        const labelEnd = labelStart + m[1].length;
+        if (position.character < labelStart || position.character > labelEnd)
+            continue;
+        const label = m[1];
+        return findLinkrefDef(lines, label);
+    }
+    // Collapsed reference: [ref][] — cursor on first bracket group
+    const collapsedRe = /\[([^\]^][^\]]*)\]\[\]/g;
+    for (const m of line.matchAll(collapsedRe)) {
+        const labelStart = m.index + 1;
+        const labelEnd = labelStart + m[1].length;
+        if (position.character < labelStart || position.character > labelEnd)
+            continue;
+        const label = m[1];
+        return findLinkrefDef(lines, label);
+    }
+    return null;
+}
+function findLinkrefDef(lines, label) {
+    const normalized = label.replace(/\s+/g, ' ').trim();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Definition: [label]: url at line start (up to 3 leading spaces)
+        const defMatch = /^( {0,3})\[([^\]]+)\]:/.exec(line);
+        if (defMatch && !defMatch[2].startsWith('^')) {
+            const defLabel = defMatch[2].replace(/\s+/g, ' ').trim();
+            if (defLabel === normalized)
+                return i;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Wikilink [[Page]] -> heading whose text matches Page
+// ---------------------------------------------------------------------------
+function resolveWikilinkAt(uri, source, line, position) {
+    const wikilinkRe = /\[\[([^\]|#]+?)(?:[|#][^\]]*)?]]/g;
+    for (const m of line.matchAll(wikilinkRe)) {
+        const start = m.index;
+        const end = start + m[0].length;
+        if (position.character < start || position.character >= end)
+            continue;
+        const page = m[1].trim();
+        return findHeadingByText(uri, source, page);
+    }
+    return null;
+}
+function findHeadingByText(uri, source, text) {
+    let doc;
+    try {
+        doc = resolve(parse(source));
+    }
+    catch {
+        return null;
+    }
+    const target = text.toLowerCase();
+    const heading = findHeadingWithText(doc.children, target);
+    if (!heading || !heading.pos)
+        return null;
+    const line = heading.pos.startLine - 1;
+    return {
+        uri,
+        range: {
+            start: { line, character: 0 },
+            end: { line, character: (heading.pos.endColumn ?? 200) - 1 },
+        },
+    };
+}
+function headingPlainText(nodes) {
+    let out = '';
+    for (const node of nodes) {
+        if (node.type === 'text')
+            out += node.value;
+        else if ('children' in node && Array.isArray(node.children)) {
+            out += headingPlainText(node.children);
+        }
+        else if (node.type === 'code')
+            out += node.value;
+    }
+    return out.trim();
+}
+function findHeadingWithText(nodes, targetText) {
+    for (const node of nodes) {
+        if (node.type === 'heading') {
+            const text = headingPlainText(node.children).toLowerCase();
+            if (text === targetText)
+                return node;
+        }
+        if ('children' in node && Array.isArray(node.children)) {
+            const found = findHeadingWithText(node.children.filter(isBlockNode), targetText);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function locationAtLine(uri, line) {
+    return {
+        uri,
+        range: {
+            start: { line, character: 0 },
+            end: { line, character: 9999 },
+        },
+    };
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=definition.js.map

package/dist/definition.js.map

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

package/dist/definition.test.d.ts

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

package/dist/definition.test.js

@@ -0,0 +1,136 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { definitionAt } from './definition.js';
+const URI = 'file:///doc.crv';
+// ---------------------------------------------------------------------------
+// Cross-reference </#id>
+// ---------------------------------------------------------------------------
+test('crossref </#id> jumps to the matching heading', () => {
+    const source = '# Introduction\n\nSee </#introduction>.';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.ok(loc, 'expected a location');
+    assert.equal(loc.uri, URI);
+    assert.equal(loc.range.start.line, 0);
+});
+test('crossref </#id> with explicit {#custom-id} block attribute', () => {
+    // In Carve, a block attribute ({#id}) is placed on the line BEFORE the heading.
+    const source = '{#my-section}\n# Intro\n\nSee </#my-section>.';
+    const loc = definitionAt(URI, source, { line: 3, character: 8 });
+    assert.ok(loc);
+    // The heading is on line 1 (0-based), but its pos.startLine = 2 (block attr on line 1).
+    assert.equal(loc.range.start.line, 1);
+});
+test('crossref </#id> returns null for unknown id', () => {
+    const source = '# Hello\n\nSee </#nope>.';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.equal(loc, null);
+});
+// ---------------------------------------------------------------------------
+// Fragment link [text](#id)
+// ---------------------------------------------------------------------------
+test('fragment link [text](#id) jumps to heading', () => {
+    const source = '# Getting Started\n\n[jump](#getting-started)';
+    const loc = definitionAt(URI, source, { line: 2, character: 8 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('fragment link returns null for missing heading', () => {
+    const source = '# Hello\n\n[jump](#nowhere)';
+    const loc = definitionAt(URI, source, { line: 2, character: 8 });
+    assert.equal(loc, null);
+});
+// ---------------------------------------------------------------------------
+// Footnote reference [^name]
+// ---------------------------------------------------------------------------
+test('footnote reference jumps to definition', () => {
+    const source = 'see note[^fn]\n\n[^fn]: The footnote text.';
+    const loc = definitionAt(URI, source, { line: 0, character: 10 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 2);
+});
+test('footnote definition does NOT navigate to itself (cursor on def)', () => {
+    // On the definition line, there is no "go to definition" target — it IS the definition.
+    // The function should return the line itself (same-line definition found).
+    const source = 'see note[^fn]\n\n[^fn]: The footnote text.';
+    const loc = definitionAt(URI, source, { line: 2, character: 3 });
+    assert.ok(loc);
+    // It finds the def line itself (first match is the def pattern).
+    assert.equal(loc.range.start.line, 2);
+});
+test('footnote reference returns null when definition is missing', () => {
+    const source = 'see note[^missing]';
+    const loc = definitionAt(URI, source, { line: 0, character: 12 });
+    assert.equal(loc, null);
+});
+// ---------------------------------------------------------------------------
+// Link reference [text][ref]
+// ---------------------------------------------------------------------------
+test('full link reference [text][ref] jumps to definition', () => {
+    const source = '[carve]: https://example.com\n\nsee [the site][carve]';
+    const loc = definitionAt(URI, source, { line: 2, character: 16 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('collapsed link reference [ref][] jumps to definition', () => {
+    const source = '[carve]: https://example.com\n\nsee [carve][]';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('link reference returns null when definition is missing', () => {
+    const source = '[text][nope]';
+    const loc = definitionAt(URI, source, { line: 0, character: 9 });
+    assert.equal(loc, null);
+});
+test('link reference with spaces in label resolves correctly', () => {
+    const source = '[my label]: https://example.com\n\nsee [text][my label]';
+    const loc = definitionAt(URI, source, { line: 2, character: 13 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+// ---------------------------------------------------------------------------
+// Citation [@key]
+// ---------------------------------------------------------------------------
+test('citation [@key] jumps to definition', () => {
+    const source = '[@smith2024]: Smith et al. 2024\n\nSee [@smith2024].';
+    const loc = definitionAt(URI, source, { line: 2, character: 7 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('citation returns null when definition is missing', () => {
+    const source = 'See [@nobody].';
+    const loc = definitionAt(URI, source, { line: 0, character: 7 });
+    assert.equal(loc, null);
+});
+// ---------------------------------------------------------------------------
+// Wikilink [[Page]]
+// ---------------------------------------------------------------------------
+test('wikilink [[Page]] jumps to matching heading', () => {
+    const source = '# Tigers\n\nSee [[Tigers]].';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('wikilink [[Page]] is case-insensitive', () => {
+    const source = '# Tigers\n\nSee [[tigers]].';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.ok(loc);
+    assert.equal(loc.range.start.line, 0);
+});
+test('wikilink returns null when no matching heading exists', () => {
+    const source = '# Hello\n\nSee [[Nowhere]].';
+    const loc = definitionAt(URI, source, { line: 2, character: 6 });
+    assert.equal(loc, null);
+});
+// ---------------------------------------------------------------------------
+// No-op cases: cursor not on any navigable construct
+// ---------------------------------------------------------------------------
+test('returns null on plain text', () => {
+    const loc = definitionAt(URI, 'just some text here', { line: 0, character: 5 });
+    assert.equal(loc, null);
+});
+test('returns null on empty line', () => {
+    const loc = definitionAt(URI, 'line one\n\nline three', { line: 1, character: 0 });
+    assert.equal(loc, null);
+});
+//# sourceMappingURL=definition.test.js.map

package/dist/definition.test.js.map

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

package/dist/folding.d.ts

@@ -0,0 +1,8 @@
+import { type FoldingRange } from 'vscode-languageserver/node.js';
+/**
+ * Folding regions for a Carve document:
+ *   - every multi-line block (code, admonition, div, list, table, …)
+ *   - each heading's section, from the heading line down to the line before
+ *     the next heading of the same or shallower level (or end of document).
+ */
+export declare function foldingRanges(source: string): FoldingRange[];