@markup-carve/carve-lsp 0.1.0

package/dist/folding.js

@@ -0,0 +1,64 @@
+import { parse, resolve } from '@markup-carve/carve';
+/** Block kinds worth offering as a collapsible region when multi-line. */
+const FOLDABLE = new Set([
+    'code-block',
+    'raw-block',
+    'comment',
+    'blockquote',
+    'list',
+    'table',
+    'admonition',
+    'div',
+    'definition-list',
+    'figure',
+]);
+/**
+ * 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 function foldingRanges(source) {
+    let doc;
+    try {
+        doc = resolve(parse(source, { positions: true }));
+    }
+    catch {
+        return [];
+    }
+    const ranges = [];
+    const headings = [];
+    const visit = (nodes) => {
+        for (const node of nodes) {
+            if (node.type === 'heading' && node.pos) {
+                headings.push({ level: node.level, startLine: node.pos.startLine });
+            }
+            if (node.pos && node.pos.endLine > node.pos.startLine && FOLDABLE.has(node.type)) {
+                ranges.push({ startLine: node.pos.startLine - 1, endLine: node.pos.endLine - 1 });
+            }
+            if ('children' in node && Array.isArray(node.children)) {
+                visit(node.children.filter(isBlockNode));
+            }
+        }
+    };
+    visit(doc.children);
+    const lastLine = Math.max(0, source.split(/\r?\n/).length - 1);
+    for (let i = 0; i < headings.length; i++) {
+        const heading = headings[i];
+        let end = lastLine;
+        for (let j = i + 1; j < headings.length; j++) {
+            if (headings[j].level <= heading.level) {
+                end = headings[j].startLine - 2;
+                break;
+            }
+        }
+        if (end > heading.startLine - 1) {
+            ranges.push({ startLine: heading.startLine - 1, endLine: end, kind: 'region' });
+        }
+    }
+    return ranges;
+}
+function isBlockNode(node) {
+    return Boolean(node && typeof node === 'object' && 'type' in node);
+}
+//# sourceMappingURL=folding.js.map

package/dist/folding.js.map

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

package/dist/folding.test.d.ts

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

package/dist/folding.test.js

@@ -0,0 +1,20 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { foldingRanges } from './folding.js';
+const src = '# A\n\ntext\n\n## B\n\nmore\n\n```js\none\ntwo\n```\n';
+test('folds the section under a top-level heading', () => {
+    const ranges = foldingRanges(src);
+    assert.ok(ranges.some((r) => r.startLine === 0 && r.endLine >= 11), 'H1 section fold');
+});
+test('folds a nested subsection', () => {
+    const ranges = foldingRanges(src);
+    assert.ok(ranges.some((r) => r.startLine === 4), 'H2 section fold');
+});
+test('folds a multi-line fenced code block', () => {
+    const ranges = foldingRanges(src);
+    assert.ok(ranges.some((r) => r.startLine === 8 && r.endLine === 11), 'code block fold');
+});
+test('returns nothing for an empty document', () => {
+    assert.deepEqual(foldingRanges(''), []);
+});
+//# sourceMappingURL=folding.test.js.map

package/dist/folding.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folding.test.js","sourceRoot":"","sources":["../src/folding.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,GAAG,GAAG,uDAAuD,CAAA;AAEnE,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;IACvD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACxF,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACrC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACrE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,EAAE,iBAAiB,CAAC,CAAA;AACzF,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AACzC,CAAC,CAAC,CAAA"}

package/dist/format.d.ts

@@ -0,0 +1 @@
+export declare function formatDocument(source: string): string;

package/dist/format.js

@@ -0,0 +1,83 @@
+/*
+ * Conservative Carve formatter.
+ *
+ * Carve has no canonical source serializer, so this does not reflow content.
+ * It only applies safe, idempotent normalizations OUTSIDE verbatim blocks
+ * (fenced code, raw blocks, comment blocks):
+ *   - strip trailing whitespace
+ *   - collapse runs of 2+ blank lines to a single blank line
+ *   - trim leading/trailing blank lines
+ *   - end the file with exactly one newline
+ *
+ * Verbatim block interiors are emitted byte-for-byte (only the file-final
+ * newline is enforced), so code, raw HTML, and comments are never altered.
+ */
+export function formatDocument(source) {
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const lines = source.split(/\r?\n/);
+    const out = [];
+    let openFence = null;
+    let blankRun = 0;
+    for (const raw of lines) {
+        if (openFence !== null) {
+            out.push(raw);
+            if (closesFence(raw, openFence))
+                openFence = null;
+            blankRun = 0;
+            continue;
+        }
+        const opener = fenceOpener(raw);
+        if (opener) {
+            openFence = opener;
+            out.push(raw.replace(/[ \t]+$/, ''));
+            blankRun = 0;
+            continue;
+        }
+        const trimmed = raw.replace(/[ \t]+$/, '');
+        if (trimmed === '') {
+            blankRun++;
+            if (blankRun === 1)
+                out.push('');
+            continue;
+        }
+        blankRun = 0;
+        out.push(trimmed);
+    }
+    while (out.length && out[0] === '')
+        out.shift();
+    while (out.length && out[out.length - 1] === '')
+        out.pop();
+    return out.length ? out.join(eol) + eol : '';
+}
+/**
+ * A verbatim block opener: a fence marker indented at most three spaces.
+ * Backtick fences cannot carry a backtick in the info string, and a comment
+ * fence (`%%%`) must stand alone (no info), matching the parser.
+ */
+function fenceOpener(line) {
+    const match = /^( {0,3})(`{3,}|~{3,}|%{3,})(.*)$/.exec(line);
+    if (!match)
+        return null;
+    const marker = match[2];
+    const info = match[3];
+    if (marker[0] === '`' && info.includes('`'))
+        return null;
+    if (marker[0] === '%' && info.trim() !== '')
+        return null;
+    return marker;
+}
+/**
+ * A verbatim block closes on a lone fence (indent <= 3) of the same char.
+ * Comment blocks close only on an exact-length marker; code/raw fences close
+ * on a marker at least as long as the opener (CommonMark rule).
+ */
+function closesFence(line, openFence) {
+    const match = /^ {0,3}(`{3,}|~{3,}|%{3,})[ \t]*$/.exec(line);
+    if (!match)
+        return false;
+    const close = match[1];
+    if (close[0] !== openFence[0])
+        return false;
+    return openFence[0] === '%' ? close.length === openFence.length : close.length >= openFence.length;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/format.test.d.ts

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

package/dist/format.test.js

@@ -0,0 +1,46 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { formatDocument } from './format.js';
+test('strips trailing whitespace and enforces a final newline', () => {
+    assert.equal(formatDocument('# Title   \n\npara\t'), '# Title\n\npara\n');
+});
+test('collapses runs of blank lines to a single blank line', () => {
+    assert.equal(formatDocument('a\n\n\n\nb'), 'a\n\nb\n');
+});
+test('trims leading and trailing blank lines', () => {
+    assert.equal(formatDocument('\n\n# Title\n\n\n'), '# Title\n');
+});
+test('preserves verbatim interiors of fenced code blocks', () => {
+    const src = '```js\ncode   \n\n\n  more\n```\n';
+    // Trailing spaces and blank runs inside the fence are untouched.
+    assert.equal(formatDocument(src), src);
+});
+test('still normalizes outside a closed fence', () => {
+    const src = '```\nx\n```\n\n\n\ntail   \n';
+    assert.equal(formatDocument(src), '```\nx\n```\n\ntail\n');
+});
+test('handles nested longer fences without closing early', () => {
+    const src = '````md\n```\ninner   \n```\n````\n';
+    assert.equal(formatDocument(src), src);
+});
+test('a 4-space-indented fence does not close a code block', () => {
+    const src = '```\ncode\n    ```\n```\n\n\n\ntail   \n';
+    // The indented ``` stays inside the block; the flush ``` closes it; only the
+    // prose after the block is normalized.
+    assert.equal(formatDocument(src), '```\ncode\n    ```\n```\n\ntail\n');
+});
+test('comment block closes only on an exact-length marker', () => {
+    const src = '%%%\nhidden   \n%%%%\nstill   \n%%%\n';
+    // %%%% (len 4) does not close %%% (len 3); the block runs to the matching %%%.
+    assert.equal(formatDocument(src), src);
+});
+test('a backtick line with inline backticks is not a fence', () => {
+    // Not a real opener, so trailing whitespace after it is still trimmed.
+    const src = '``` not `a` fence   \nbody   \n';
+    assert.equal(formatDocument(src), '``` not `a` fence\nbody\n');
+});
+test('is idempotent', () => {
+    const once = formatDocument('# T  \n\n\n\nbody  \n');
+    assert.equal(formatDocument(once), once);
+});
+//# sourceMappingURL=format.test.js.map

package/dist/format.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.js","sourceRoot":"","sources":["../src/format.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACnE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,sBAAsB,CAAC,EAAE,mBAAmB,CAAC,CAAA;AAC3E,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAA;AACxD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IAClD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,CAAA;AAChE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,GAAG,GAAG,mCAAmC,CAAA;IAC/C,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,GAAG,GAAG,8BAA8B,CAAA;IAC1C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,uBAAuB,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,GAAG,GAAG,oCAAoC,CAAA;IAChD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,0CAA0C,CAAA;IACtD,6EAA6E;IAC7E,uCAAuC;IACvC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,mCAAmC,CAAC,CAAA;AACxE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC/D,MAAM,GAAG,GAAG,uCAAuC,CAAA;IACnD,+EAA+E;IAC/E,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;AACxC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,uEAAuE;IACvE,MAAM,GAAG,GAAG,iCAAiC,CAAA;IAC7C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,2BAA2B,CAAC,CAAA;AAChE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;IACzB,MAAM,IAAI,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAA;IACpD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;AAC1C,CAAC,CAAC,CAAA"}

package/dist/hover.d.ts

@@ -0,0 +1,2 @@
+import { type Hover, type Position } from 'vscode-languageserver/node.js';
+export declare function hoverAt(source: string, position: Position): Hover | null;

package/dist/hover.js

@@ -0,0 +1,222 @@
+import { MarkupKind } from 'vscode-languageserver/node.js';
+import { parse, resolve, } from '@markup-carve/carve';
+const rules = [
+    {
+        pattern: /#{1,6}/g,
+        contents: '**Heading**\n\n`#` through `######` create section headings.',
+    },
+    {
+        pattern: /\*[^*\n]+\*/g,
+        contents: '**Bold**\n\nCarve uses single asterisks for bold text: `*bold*`.',
+    },
+    {
+        pattern: /\/[^/\n]+\//g,
+        contents: '**Italic**\n\nCarve uses slashes for italic text: `/italic/`.',
+    },
+    {
+        pattern: /_[^_\n]+_/g,
+        contents: '**Underline**\n\nCarve uses underscores for underline: `_underlined_`.',
+    },
+    {
+        pattern: /~[^~\n]+~/g,
+        contents: '**Strikethrough**\n\nCarve uses tildes for strikethrough: `~removed~`.',
+    },
+    {
+        pattern: /\{[^}\n]+\}/g,
+        contents: '**Attributes**\n\nAttach IDs, classes, and key/value pairs with `{#id .class key=value}`.',
+    },
+    {
+        pattern: /\[[^\]\n]+\]\([^\s)]+(?:\s+"[^"]*")?\)/g,
+        contents: '**Link**\n\nInline links use `[label](url)`.',
+    },
+    {
+        pattern: /!\[[^\]\n]*\]\([^\s)]+(?:\s+"[^"]*")?\)/g,
+        contents: '**Image**\n\nImages use `![alt](url)` and can be followed by captions.',
+    },
+    {
+        pattern: /`[^`\n]+`/g,
+        contents: '**Inline Code**\n\nBackticks mark inline code spans.',
+    },
+];
+export function hoverAt(source, position) {
+    try {
+        const hover = astHoverAt(resolve(parse(source)), position);
+        if (hover)
+            return hover;
+    }
+    catch {
+        // Fall back to lexical help below for documents that do not parse.
+    }
+    const line = source.replace(/\r\n?/g, '\n').split('\n')[position.line];
+    if (line === undefined)
+        return null;
+    for (const rule of rules) {
+        rule.pattern.lastIndex = 0;
+        for (const match of line.matchAll(rule.pattern)) {
+            const start = match.index ?? 0;
+            const end = start + match[0].length;
+            if (position.character < start || position.character > end)
+                continue;
+            return {
+                contents: {
+                    kind: MarkupKind.Markdown,
+                    value: rule.contents,
+                },
+                range: {
+                    start: { line: position.line, character: start },
+                    end: { line: position.line, character: end },
+                },
+            };
+        }
+    }
+    return null;
+}
+function astHoverAt(doc, position) {
+    const matches = [];
+    for (const node of doc.children)
+        collectBlock(matches, node, position);
+    matches.sort((a, b) => spanSize(a.pos) - spanSize(b.pos));
+    const match = matches[0];
+    if (!match)
+        return null;
+    return {
+        contents: {
+            kind: MarkupKind.Markdown,
+            value: match.contents,
+        },
+        range: toRange(match.pos),
+    };
+}
+function collectBlock(matches, node, position) {
+    addMatch(matches, node.pos, position, blockContents(node));
+    switch (node.type) {
+        case 'heading':
+            collectInline(matches, node.children, position);
+            break;
+        case 'paragraph':
+            collectInline(matches, node.children, position);
+            break;
+        case 'blockquote':
+            node.children.forEach((child) => collectBlock(matches, child, position));
+            break;
+        case 'list':
+            node.items.forEach((item) => item.children.forEach((child) => collectBlock(matches, child, position)));
+            break;
+        case 'admonition':
+        case 'div':
+            node.children.forEach((child) => collectBlock(matches, child, position));
+            if (node.type === 'admonition' && node.title)
+                collectInline(matches, node.title, position);
+            break;
+        case 'definition-list':
+            node.items.forEach((item) => {
+                item.terms.forEach((term) => collectInline(matches, term, position));
+                item.definitions.forEach((definition) => definition.forEach((child) => collectBlock(matches, child, position)));
+            });
+            break;
+        case 'figure':
+            collectBlock(matches, node.target, position);
+            collectInline(matches, node.caption, position);
+            break;
+        case 'table':
+            if (node.caption)
+                collectInline(matches, node.caption, position);
+            node.rows.forEach((row) => row.cells.forEach((cell) => collectInline(matches, cell.children, position)));
+            break;
+    }
+}
+function collectInline(matches, nodes, position) {
+    for (const node of nodes) {
+        addMatch(matches, node.pos, position, inlineContents(node));
+        const children = node.children;
+        if (Array.isArray(children))
+            collectInline(matches, children, position);
+        const content = node.content;
+        if (Array.isArray(content))
+            collectInline(matches, content, position);
+    }
+}
+function addMatch(matches, pos, position, contents) {
+    if (!contents || !pos || !contains(pos, position))
+        return;
+    matches.push({ pos, contents });
+}
+function blockContents(node) {
+    switch (node.type) {
+        case 'heading':
+            return '**Heading**\n\n`#` through `######` create section headings.';
+        case 'code-block':
+            return '**Code Block**\n\nTriple backtick or tilde fences create verbatim code blocks.';
+        case 'raw-block':
+            return '**Raw Block**\n\nRaw passthrough blocks render only for matching output formats.';
+        case 'blockquote':
+            return '**Block Quote**\n\nLines beginning with `>` create quoted blocks.';
+        case 'list':
+            return '**List**\n\nUse bullets, task markers, or ordered markers for lists.';
+        case 'table':
+            return '**Table**\n\nPipe-delimited rows create tables.';
+        case 'admonition':
+            return '**Admonition**\n\nTyped `:::` fences create admonition blocks.';
+        case 'div':
+            return '**Div**\n\nBare `:::` fences create generic container blocks.';
+        default:
+            return null;
+    }
+}
+function inlineContents(node) {
+    switch (node.type) {
+        case 'strong':
+            return '**Bold**\n\nCarve uses single asterisks for bold text: `*bold*`.';
+        case 'italic':
+            return '**Italic**\n\nCarve uses slashes for italic text: `/italic/`.';
+        case 'underline':
+            return '**Underline**\n\nCarve uses underscores for underline: `_underlined_`.';
+        case 'strike':
+            return '**Strikethrough**\n\nCarve uses tildes for strikethrough: `~removed~`.';
+        case 'sub':
+            return '**Subscript**\n\nCarve subscript uses the braced form `{,text,}`, e.g. `H{,2,}O`. A bare comma is literal text.';
+        case 'super':
+            return '**Superscript**\n\nCarve superscript uses the braced form `{^text^}`, e.g. `E=mc{^2^}`. A bare caret is literal text.';
+        case 'highlight':
+            return '**Highlight**\n\nCarve highlight is a single equals: `=marked=` (use the forced form `{=marked=}` intraword).';
+        case 'code':
+            return '**Inline Code**\n\nBackticks mark inline code spans.';
+        case 'link':
+            return '**Link**\n\nInline links use `[label](url)` or reference-link syntax.';
+        case 'image':
+            return '**Image**\n\nImages use `![alt](url)` and can be followed by captions.';
+        case 'mention':
+            return '**Mention**\n\nMentions use `@name`.';
+        case 'tag':
+            return '**Tag**\n\nTags use `#name`.';
+        case 'span':
+            return '**Span**\n\nInline spans use `[text]{attrs}`.';
+        default:
+            return null;
+    }
+}
+function contains(pos, position) {
+    if (pos.startColumn === undefined ||
+        pos.endColumn === undefined ||
+        position.line + 1 < pos.startLine ||
+        position.line + 1 > pos.endLine) {
+        return false;
+    }
+    if (position.line + 1 === pos.startLine && position.character + 1 < pos.startColumn)
+        return false;
+    if (position.line + 1 === pos.endLine && position.character + 1 > pos.endColumn)
+        return false;
+    return true;
+}
+function toRange(pos) {
+    return {
+        start: { line: pos.startLine - 1, character: (pos.startColumn ?? 1) - 1 },
+        end: { line: pos.endLine - 1, character: (pos.endColumn ?? 1) - 1 },
+    };
+}
+function spanSize(pos) {
+    if (pos.startOffset !== undefined && pos.endOffset !== undefined)
+        return pos.endOffset - pos.startOffset;
+    return (pos.endLine - pos.startLine) * 1000 + ((pos.endColumn ?? 1) - (pos.startColumn ?? 1));
+}
+//# sourceMappingURL=hover.js.map

package/dist/hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.js","sourceRoot":"","sources":["../src/hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA6B,MAAM,+BAA+B,CAAA;AACrF,OAAO,EACL,KAAK,EACL,OAAO,GAKR,MAAM,qBAAqB,CAAA;AAO5B,MAAM,KAAK,GAAgB;IACzB;QACE,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,8DAA8D;KACzE;IACD;QACE,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,kEAAkE;KAC7E;IACD;QACE,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,+DAA+D;KAC1E;IACD;QACE,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,wEAAwE;KACnF;IACD;QACE,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,wEAAwE;KACnF;IACD;QACE,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,2FAA2F;KACtG;IACD;QACE,OAAO,EAAE,yCAAyC;QAClD,QAAQ,EAAE,8CAA8C;KACzD;IACD;QACE,OAAO,EAAE,0CAA0C;QACnD,QAAQ,EAAE,wEAAwE;KACnF;IACD;QACE,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,sDAAsD;KACjE;CACF,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,QAAkB;IACxD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC1D,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAA;QAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAA;YAC9B,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACnC,IAAI,QAAQ,CAAC,SAAS,GAAG,KAAK,IAAI,QAAQ,CAAC,SAAS,GAAG,GAAG;gBAAE,SAAQ;YACpE,OAAO;gBACL,QAAQ,EAAE;oBACR,IAAI,EAAE,UAAU,CAAC,QAAQ;oBACzB,KAAK,EAAE,IAAI,CAAC,QAAQ;iBACrB;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;oBAChD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;iBAC7C;aACF,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,UAAU,CAAC,GAAa,EAAE,QAAkB;IACnD,MAAM,OAAO,GAAqD,EAAE,CAAA;IACpE,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,QAAQ;QAAE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU,CAAC,QAAQ;YACzB,KAAK,EAAE,KAAK,CAAC,QAAQ;SACtB;QACD,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;KAC1B,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CACnB,OAAyD,EACzD,IAAe,EACf,QAAkB;IAElB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAC1D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAC/C,MAAK;QACP,KAAK,WAAW;YACd,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAC/C,MAAK;QACP,KAAK,YAAY;YACf,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;YACxE,MAAK;QACP,KAAK,MAAM;YACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;YACtG,MAAK;QACP,KAAK,YAAY,CAAC;QAClB,KAAK,KAAK;YACR,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;YACxE,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,KAAK;gBAAE,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;YAC1F,MAAK;QACP,KAAK,iBAAiB;YACpB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;gBACpE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CACtC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CACtE,CAAA;YACH,CAAC,CAAC,CAAA;YACF,MAAK;QACP,KAAK,QAAQ;YACX,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;YAC5C,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAC9C,MAAK;QACP,KAAK,OAAO;YACV,IAAI,IAAI,CAAC,OAAO;gBAAE,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAChE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;YACxG,MAAK;IACT,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,OAAyD,EACzD,KAAmB,EACnB,QAAkB;IAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAI,IAAoC,CAAC,QAAQ,CAAA;QAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACvE,MAAM,OAAO,GAAI,IAAmC,CAAC,OAAO,CAAA;QAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACvE,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CACf,OAAyD,EACzD,GAA+B,EAC/B,QAAkB,EAClB,QAAuB;IAEvB,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;QAAE,OAAM;IACzD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,IAAe;IACpC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,8DAA8D,CAAA;QACvE,KAAK,YAAY;YACf,OAAO,gFAAgF,CAAA;QACzF,KAAK,WAAW;YACd,OAAO,kFAAkF,CAAA;QAC3F,KAAK,YAAY;YACf,OAAO,mEAAmE,CAAA;QAC5E,KAAK,MAAM;YACT,OAAO,sEAAsE,CAAA;QAC/E,KAAK,OAAO;YACV,OAAO,iDAAiD,CAAA;QAC1D,KAAK,YAAY;YACf,OAAO,gEAAgE,CAAA;QACzE,KAAK,KAAK;YACR,OAAO,+DAA+D,CAAA;QACxE;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAgB;IACtC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,kEAAkE,CAAA;QAC3E,KAAK,QAAQ;YACX,OAAO,+DAA+D,CAAA;QACxE,KAAK,WAAW;YACd,OAAO,wEAAwE,CAAA;QACjF,KAAK,QAAQ;YACX,OAAO,wEAAwE,CAAA;QACjF,KAAK,KAAK;YACR,OAAO,iHAAiH,CAAA;QAC1H,KAAK,OAAO;YACV,OAAO,uHAAuH,CAAA;QAChI,KAAK,WAAW;YACd,OAAO,+GAA+G,CAAA;QACxH,KAAK,MAAM;YACT,OAAO,sDAAsD,CAAA;QAC/D,KAAK,MAAM;YACT,OAAO,uEAAuE,CAAA;QAChF,KAAK,OAAO;YACV,OAAO,wEAAwE,CAAA;QACjF,KAAK,SAAS;YACZ,OAAO,sCAAsC,CAAA;QAC/C,KAAK,KAAK;YACR,OAAO,8BAA8B,CAAA;QACvC,KAAK,MAAM;YACT,OAAO,+CAA+C,CAAA;QACxD;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB,EAAE,QAAkB;IACvD,IACE,GAAG,CAAC,WAAW,KAAK,SAAS;QAC7B,GAAG,CAAC,SAAS,KAAK,SAAS;QAC3B,QAAQ,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,SAAS;QACjC,QAAQ,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,EAC/B,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,GAAG,GAAG,CAAC,WAAW;QAAE,OAAO,KAAK,CAAA;IACjG,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,GAAG,GAAG,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAC7F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,OAAO,CAAC,GAAmB;IAClC,OAAO;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE;QACzE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE;KACpE,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB;IACnC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,WAAW,CAAA;IACxG,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAA;AAC/F,CAAC"}

package/dist/migration-actions.d.ts

@@ -0,0 +1,15 @@
+import { CodeAction, Range, type Diagnostic } from 'vscode-languageserver/node.js';
+export interface MigrationFix {
+    rule: string;
+    range: Range;
+    suggestion: string;
+}
+export declare function migrationFixes(source: string): MigrationFix[];
+export declare function migrationCodeActions(uri: string, source: string, diagnostics: Diagnostic[]): CodeAction[];
+/**
+ * A single source action that rewrites every auto-fixable collision in the
+ * document via `applyMigrationFixes`. Offered only when something would
+ * change. Crossing (ambiguous) collisions are left in place; they keep their
+ * per-diagnostic warning for manual review.
+ */
+export declare function migrationFixAllAction(uri: string, source: string): CodeAction | null;

package/dist/migration-actions.js

@@ -0,0 +1,79 @@
+import { CodeActionKind, Range, TextEdit, } from 'vscode-languageserver/node.js';
+import { applyMigrationFixes, djotMigrationWarnings } from '@markup-carve/carve';
+// `MigrationWarning.start`/`end` are offsets into the line-ending-normalized
+// source, so positions are computed against the same normalization.
+function normalize(source) {
+    return source.replace(/\r\n?/g, '\n');
+}
+export function migrationFixes(source) {
+    const norm = normalize(source);
+    return djotMigrationWarnings(source).map((warning) => ({
+        rule: warning.rule,
+        range: Range.create(positionAt(norm, warning.start), positionAt(norm, warning.end)),
+        suggestion: warning.suggestion,
+    }));
+}
+export function migrationCodeActions(uri, source, diagnostics) {
+    const fixes = migrationFixes(source);
+    const actions = [];
+    for (const diagnostic of diagnostics) {
+        if (typeof diagnostic.code !== 'string')
+            continue;
+        const fix = fixes.find((candidate) => candidate.rule === diagnostic.code &&
+            candidate.range.start.line === diagnostic.range.start.line &&
+            candidate.range.start.character === diagnostic.range.start.character);
+        if (!fix)
+            continue;
+        actions.push({
+            title: `Convert to Carve syntax: ${fix.suggestion}`,
+            kind: CodeActionKind.QuickFix,
+            diagnostics: [diagnostic],
+            edit: {
+                changes: {
+                    [uri]: [TextEdit.replace(fix.range, fix.suggestion)],
+                },
+            },
+            isPreferred: true,
+        });
+    }
+    const fixAll = migrationFixAllAction(uri, source);
+    if (fixAll)
+        actions.push(fixAll);
+    return actions;
+}
+/**
+ * A single source action that rewrites every auto-fixable collision in the
+ * document via `applyMigrationFixes`. Offered only when something would
+ * change. Crossing (ambiguous) collisions are left in place; they keep their
+ * per-diagnostic warning for manual review.
+ */
+export function migrationFixAllAction(uri, source) {
+    const { output, applied } = applyMigrationFixes(source);
+    if (applied.length === 0)
+        return null;
+    // The whole-document range. Computed on the normalized text, whose
+    // per-line character offsets match the live document (line endings differ
+    // only at line breaks, which positionAt never indexes into).
+    const norm = normalize(source);
+    const fullRange = Range.create(positionAt(norm, 0), positionAt(norm, norm.length));
+    const n = applied.length;
+    return {
+        title: `Fix all Carve migration collisions (${n})`,
+        kind: CodeActionKind.SourceFixAll,
+        edit: {
+            changes: {
+                [uri]: [TextEdit.replace(fullRange, output)],
+            },
+        },
+    };
+}
+function positionAt(source, offset) {
+    const before = source.slice(0, offset);
+    const line = before.split('\n').length - 1;
+    const lastNewline = before.lastIndexOf('\n');
+    return {
+        line,
+        character: offset - lastNewline - 1,
+    };
+}
+//# sourceMappingURL=migration-actions.js.map

package/dist/migration-actions.js.map

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

package/dist/references.d.ts

@@ -0,0 +1,15 @@
+import { type Location, type Position, type ReferenceContext } from 'vscode-languageserver/node.js';
+/**
+ * Find-references for Carve constructs (same-document scope).
+ *
+ * Given the cursor position on either a definition or a usage, return ALL
+ * usages (and optionally the definition itself when `context.includeDeclaration`).
+ *
+ * Supported families, mirroring definition.ts:
+ * - Heading id  (on `#` heading line or on a `</#id>` / `[text](#id)` usage)
+ * - Footnote    `[^name]` references and `[^name]:` definition
+ * - Link-ref    `[text][ref]` / `[ref][]` usages and `[ref]:` definition
+ * - Citation    `[@key]` usages and `[@key]:` definition
+ * - Wikilink    `[[Page]]` usages (same-document headings only)
+ */
+export declare function referencesAt(uri: string, source: string, position: Position, context: ReferenceContext): Location[] | null;