@markup-carve/carve-lsp 0.1.3 → 0.1.4

package/dist/lint-actions.test.js

@@ -0,0 +1,31 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { lintCodeActions } from './lint-actions.js';
+const diagnostic = (code) => ({
+    code,
+    message: code,
+    range: { start: { line: 0, character: 0 }, end: { line: 0, character: 1 } },
+});
+test('offers safe lint quick fixes', () => {
+    const raw = lintCodeActions('file:///a.crv', '```raw html\n', [diagnostic('raw-block-syntax')]);
+    assert.equal(raw[0]?.edit?.changes?.['file:///a.crv']?.[0]?.newText, '```=html');
+    const quote = lintCodeActions('file:///a.crv', '>text\n', [diagnostic('blockquote-marker-without-space')]);
+    assert.equal(quote[0]?.edit?.changes?.['file:///a.crv']?.[0]?.newText, ' ');
+});
+test('creates missing footnote and link-reference definitions', () => {
+    const footnote = lintCodeActions('file:///a.crv', 'See [^n].\n', [diagnostic('unresolved-footnote')]);
+    assert.match(footnote[0]?.edit?.changes?.['file:///a.crv']?.[0]?.newText ?? '', /\[\^n\]:/);
+    const link = lintCodeActions('file:///a.crv', 'See [x][r].\n', [diagnostic('unresolved-reference-link')]);
+    assert.match(link[0]?.edit?.changes?.['file:///a.crv']?.[0]?.newText ?? '', /\[r\]:/);
+});
+test('offers both explicit intentions for a near colon closer', () => {
+    const near = { ...diagnostic('colon-fence-length-mismatch'), data: { expectedWidth: 4 } };
+    const actions = lintCodeActions('file:///a.crv', ':::\n', [near]);
+    assert.deepEqual(actions.map((action) => action.title), [
+        'Resize to 4 colons and close the container',
+        'Preserve the colon run as literal text',
+    ]);
+    assert.equal(actions[0]?.edit?.changes?.['file:///a.crv']?.[0]?.newText, '::::');
+    assert.equal(actions[1]?.edit?.changes?.['file:///a.crv']?.[0]?.newText, '\\');
+});
+//# sourceMappingURL=lint-actions.test.js.map

package/dist/lint-actions.test.js.map

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

package/dist/no-git-dependencies.test.d.ts

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

package/dist/no-git-dependencies.test.js

@@ -0,0 +1,243 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test, { after } from 'node:test';
+import { fileURLToPath } from 'node:url';
+/**
+ * The publish-time guard must detect a git dependency by what a spec IS NOT.
+ *
+ * WHY THIS FILE EXISTS. `ci.yml` already runs `tools/no-git-dependencies.mjs` on
+ * every pull request - but only against the manifest committed here, which is
+ * clean. So that step passes with the guard's logic in ANY state: delete the
+ * whole rule and it still exits zero, because there is nothing in this manifest
+ * for it to find. Running the script against a MUTATED manifest is what makes
+ * the logic load-bearing rather than the manifest.
+ *
+ * WHY THE GUARD WAS WIDENED. The rule was already an inversion, but the "not"
+ * was still spelled as a list of protocols plus a slash test, and both miss
+ * npm's scp-style URL: it carries no protocol, and when the repository sits at
+ * the root of its host it carries no slash either. That is the third hole in
+ * this guard family in this org - `git+https://` in pandoc-carve, `github:`
+ * here, then the bare `owner/repo#ref` shorthand - and each earlier fix added
+ * the next spelling to the list, which is why there was a next one (#123).
+ * markup-carve/carve-grammars#299 replaced the tail of the list with a catch-all
+ * over the characters no registry range can contain; this is that shape.
+ *
+ * Both directions are asserted. A rejection has to exit non-zero AND name the
+ * field, quote the spec and give a reason; an acceptance has to exit zero. So a
+ * guard stuck at always-pass and a guard stuck at always-fail each fail here,
+ * which is the property the CI step alone does not have.
+ *
+ * The `npm:` alias row is the near miss that keeps the rule from collapsing into
+ * "reject anything with a slash or an at-sign". An alias resolves from the
+ * registry, so rejecting it would be an over-broad fix that breaks a manifest
+ * that is fine - and an over-rejecting guard gets switched off by whoever hits
+ * it, which is worse than the hole.
+ */
+const root = fileURLToPath(new URL('..', import.meta.url));
+const guard = join(root, 'tools', 'no-git-dependencies.mjs');
+const manifestPath = join(root, 'package.json');
+const baseline = JSON.parse(readFileSync(manifestPath, 'utf8'));
+const scratch = mkdtempSync(join(tmpdir(), 'carve-lsp-guard-'));
+after(() => rmSync(scratch, { recursive: true, force: true }));
+/** Run the REAL script against a manifest written to a scratch file. */
+const runGuard = (manifest) => {
+    const path = join(scratch, 'package.json');
+    writeFileSync(path, JSON.stringify(manifest, null, 2), 'utf8');
+    const run = spawnSync(process.execPath, [guard, path], { encoding: 'utf8' });
+    assert.equal(run.error, undefined, `spawning the guard failed: ${run.error}`);
+    assert.notEqual(run.status, null, 'the guard was killed by a signal rather than exiting');
+    return { status: run.status, out: `${run.stdout}${run.stderr}` };
+};
+const ENGINE = '@markup-carve/carve';
+const withDep = (spec) => ({
+    ...baseline,
+    dependencies: { ...baseline.dependencies, [ENGINE]: spec },
+});
+/**
+ * Each row: what the spec is, the manifest carrying it, and whether a consumer's
+ * npm could install it from the registry alone. Cross-checked while writing
+ * against `npm-package-arg`, the module npm itself classifies a spec with -
+ * every `reject` row is one npa either calls `git` or refuses to classify at
+ * all, and every `accept` row is one it calls version, range, tag or alias.
+ */
+const MATRIX = [
+    ['a github: pin', withDep('github:markup-carve/carve-js#61f824d'), 'reject'],
+    [
+        'a git+https:// pin',
+        withDep('git+https://github.com/markup-carve/carve-js.git#61f824d'),
+        'reject',
+    ],
+    [
+        'a bare owner/repo#sha shorthand',
+        withDep('markup-carve/carve-js#61f824d5d5724bfaa26dd07dc5c159249a66c977'),
+        'reject',
+    ],
+    [
+        'a git spec in optionalDependencies',
+        { ...baseline, optionalDependencies: { 'some-tool': 'github:markup-carve/some-tool#abc123' } },
+        'reject',
+    ],
+    // The two rows this ticket is about. The first still carries a slash, so the
+    // previous version caught it by accident; the second does not, and was
+    // accepted.
+    ['an scp-style git URL', withDep('git@github.com:markup-carve/carve-js.git'), 'reject'],
+    ['an scp-style git URL with no slash', withDep('git@example.com:repo.git'), 'reject'],
+    // Caught by the catch-all rather than by a pattern named for them, which is
+    // the point of the catch-all: neither was anticipated and both leaked before.
+    ['a workspace: protocol spec', withDep('workspace:*'), 'reject'],
+    ['a catalog: protocol spec', withDep('catalog:default'), 'reject'],
+    ['an exact version', withDep('0.1.4'), 'accept'],
+    ['a caret range', withDep('^0.1.4'), 'accept'],
+    ['a dist-tag', withDep('latest'), 'accept'],
+    ['a compound range', withDep('>=0.1.4 <0.2.0'), 'accept'],
+    ['a prerelease version', withDep('0.2.0-beta.1'), 'accept'],
+    ['an npm: alias', withDep('npm:@markup-carve/carve@^0.1.4'), 'accept'],
+    /*
+     * ALIAS TARGETS (#126, markup-carve/carve-grammars#302). `npm:` used to
+     * return early and clean - an unconditional ALLOW on a prefix, which is the
+     * same denylist mistake as the URL-prefix list this file replaced, pointing
+     * the other way: it never asked what the alias pointed AT.
+     * `npm-package-arg` refuses every reject row here.
+     *
+     * BOTH DIRECTIONS, and the accept rows are the load-bearing half. The way a
+     * fix for this goes wrong is over-rejection - the rule collapsing into
+     * "reject anything with a slash or an at-sign" - and an over-rejecting guard
+     * is worse than the hole, because the next person who hits it switches the
+     * guard off.
+     */
+    ['an npm: alias to a plain package', withDep('npm:some-pkg'), 'accept'],
+    ['an npm: alias to a range', withDep('npm:some-pkg@^1.0.0'), 'accept'],
+    ['an npm: alias to a scoped package', withDep('npm:@scope/pkg@^1.0.0'), 'accept'],
+    ['an npm: alias to a dist-tag', withDep('npm:some-pkg@latest'), 'accept'],
+    // `npm:foo@` is npm's `*`, the same alias as `npm:foo`.
+    ['an npm: alias with an empty target', withDep('npm:some-pkg@'), 'accept'],
+    // No separating `@` at all, so there is no target to recurse into - the
+    // whole remainder is the alias's NAME, and that is what has to be refused.
+    ['an npm: alias whose name is a git URL', withDep('npm:git+https://x/y'), 'reject'],
+    ['an npm: alias whose name is a github: spec', withDep('npm:github:owner/repo'), 'reject'],
+    ['an npm: alias whose name is a shorthand', withDep('npm:owner/repo'), 'reject'],
+    // With a target, which recurses back through the same rule.
+    ['an npm: alias targeting github:', withDep('npm:foo@github:owner/repo'), 'reject'],
+    ['an npm: alias targeting git+https://', withDep('npm:foo@git+https://x/y.git'), 'reject'],
+    ['an npm: alias targeting a shorthand', withDep('npm:foo@owner/repo'), 'reject'],
+    ['an npm: alias targeting file:', withDep('npm:foo@file:../x'), 'reject'],
+    ['an npm: alias targeting workspace:', withDep('npm:foo@workspace:*'), 'reject'],
+    ['an npm: alias with no name at all', withDep('npm:'), 'reject'],
+    ['a nested npm: alias', withDep('npm:foo@npm:bar@1'), 'reject'],
+    /*
+     * PUNCTUATION npm REFUSES, found by `codex review` on #126 one layer under
+     * the alias hole it was reviewing. npm rejects a package name or a dist-tag
+     * carrying "any characters that encodeURIComponent encodes" - its own words -
+     * and the guard accepted all of these.
+     *
+     * The accept rows below it are why this is two character rules and not one. A
+     * semver RANGE is not held to the tag rule: `^1.0.0` and `1.0.0 || 2.0.0`
+     * carry characters encodeURIComponent encodes, and rejecting those would be
+     * the over-reach this guard is written to avoid. So does `my!tag`, which is a
+     * perfectly valid dist-tag and looks like nonsense.
+     */
+    ['an alias name with a fragment', withDep('npm:foo#bar'), 'reject'],
+    ['an alias name with a query', withDep('npm:foo?bar'), 'reject'],
+    ['an alias name with a percent', withDep('npm:foo%bar'), 'reject'],
+    ['an alias scope with a fragment', withDep('npm:@scope#bar/pkg'), 'reject'],
+    ['an alias targeting a bad tag', withDep('npm:foo@#bad'), 'reject'],
+    ['a bare spec with a fragment', withDep('#bad'), 'reject'],
+    ['a bare spec with braces', withDep('{x}'), 'reject'],
+    ['a bare spec with a comma', withDep('a,b'), 'reject'],
+    ['a dist-tag that only looks odd', withDep('my!tag'), 'accept'],
+    ['a dist-tag with parentheses', withDep('a(b)'), 'accept'],
+    ['a version with build metadata', withDep('1.0.0+build.1'), 'accept'],
+    ['an alias to a tilde-led name', withDep('npm:~foo'), 'accept'],
+    // A range's whitespace need not be a space, which is why the class above
+    // admits all of it. Also found by `codex review`, and the reason the guard is
+    // knowingly lenient on one spelling - see the whitespace note in the script.
+    ['a range separated by a tab', withDep('>=1\t<2'), 'accept'],
+    ['a range broken across lines', withDep('1.0.0\n|| 2.0.0'), 'accept'],
+    // A scope with no package. Also `codex review`, and the third thing it found
+    // under this one change: every PATTERN written for an alias name grew a
+    // fallback branch that let something through, which is why the shipped rule
+    // counts `/`-separated pieces instead of matching a shape.
+    ['a scope with no package', withDep('npm:@foo'), 'reject'],
+    ['a scope with no package and a target', withDep('npm:@foo@1'), 'reject'],
+    ['a scoped name with a third segment', withDep('npm:@scope/pkg/extra'), 'reject'],
+    // npm's leading `.`/`_` rule is on the WHOLE name, so it never reaches a
+    // scope - the fourth thing `codex review` found here, and the second
+    // over-rejection. All three of the accept rows were rejected by the version
+    // that applied the rule per segment.
+    ['an alias to an underscored scope', withDep('npm:@_scope/pkg'), 'accept'],
+    ['an alias to an underscored package in a scope', withDep('npm:@scope/_pkg'), 'accept'],
+    ['an alias to a dotted scope', withDep('npm:@.scope/pkg'), 'accept'],
+    ['an alias to a dotted package in a scope', withDep('npm:@scope/.pkg'), 'reject'],
+    ['an alias to an underscored bare name', withDep('npm:_pkg'), 'reject'],
+    // npm reads the alias prefix case-insensitively, and a case-sensitive test
+    // sent `NPM:foo` down to the catch-all where its `:` got it rejected. The
+    // fifth thing `codex review` found, and the third over-rejection - it only
+    // became visible once there was something past the prefix worth reaching.
+    ['an upper-case alias prefix', withDep('NPM:some-pkg'), 'accept'],
+    ['a mixed-case alias prefix', withDep('Npm:some-pkg@^1.0.0'), 'accept'],
+    ['a nested alias in upper case', withDep('npm:foo@NPM:bar'), 'reject'],
+    // A target carrying leading whitespace, which slipped past the nested-alias
+    // test and was then trimmed and read as a good alias one frame down. The
+    // sixth and last thing `codex review` found on this change.
+    ['a nested alias behind a space', withDep('npm:foo@ npm:bar'), 'reject'],
+    ['a git target behind a space', withDep('npm:foo@ github:o/r'), 'reject'],
+    ['a range behind a space', withDep('npm:foo@ ^1.0.0'), 'accept'],
+    // A leading dot is a local path to npm, whatever follows it - `.`, `..`,
+    // `./x` and `.x` are all directories, and none reaches the registry.
+    ['a bare dot', withDep('.'), 'reject'],
+    ['a parent directory', withDep('..'), 'reject'],
+    ['a relative path', withDep('./local'), 'reject'],
+    ['a dot-led tag lookalike', withDep('.x'), 'reject'],
+    ['an alias targeting a directory', withDep('npm:foo@.'), 'reject'],
+    // The near miss on that rule: a dot INSIDE a tag is ordinary.
+    ['a tag ending in a dot', withDep('x.'), 'accept'],
+];
+for (const [label, manifest, verdict] of MATRIX) {
+    test(`${verdict}s ${label}`, () => {
+        const { status, out } = runGuard(manifest);
+        if (verdict === 'accept') {
+            assert.equal(status, 0, `the guard rejected ${label}, which installs fine:\n${out}`);
+            return;
+        }
+        assert.notEqual(status, 0, `the guard passed ${label}, which needs git at install time`);
+        // A non-zero exit alone would also come from a crash, so the report has to
+        // name what it found.
+        const optional = (manifest.optionalDependencies ?? {});
+        const [field, spec] = Object.keys(optional).length
+            ? ['optionalDependencies', Object.values(optional)[0]]
+            : ['dependencies', manifest.dependencies[ENGINE]];
+        assert.ok(out.includes(field), `the report does not name the field it found it in:\n${out}`);
+        assert.ok(out.includes(spec), `the report does not quote the offending spec:\n${out}`);
+        assert.match(out, /registry/i, `the report does not say why:\n${out}`);
+    });
+}
+test("accepts this repo's own manifest", () => {
+    // The engine is declared as the exact registry version the v0.1.4 draft is
+    // cut from. This row is what keeps that publishable: a widening of the rule
+    // that also rejected the committed manifest would block the release.
+    const run = spawnSync(process.execPath, [guard, manifestPath], { encoding: 'utf8' });
+    assert.equal(run.status, 0, `the guard rejects the manifest that is committed here:\n${run.stdout}${run.stderr}`);
+});
+test('devDependencies are left alone', () => {
+    // A contributor's git devDependency costs a consumer nothing, and rejecting it
+    // would be the same over-reach the npm: alias row guards against.
+    const { status } = runGuard({
+        ...baseline,
+        devDependencies: { ...baseline.devDependencies, something: 'github:someone/something#abc' },
+    });
+    assert.equal(status, 0, 'a git devDependency was rejected; only installed fields are in scope');
+});
+test('both workflows run this script and not their own copy of the rule', () => {
+    // The guard is worth nothing if a workflow still carries an inline prefix list
+    // beside it, so both halves are pinned for each: the call is there, and no
+    // workflow greps the manifest for a spelling of its own.
+    for (const workflow of ['ci.yml', 'release.yml']) {
+        const text = readFileSync(join(root, '.github', 'workflows', workflow), 'utf8');
+        assert.ok(text.includes('node tools/no-git-dependencies.mjs'), `${workflow} does not call tools/no-git-dependencies.mjs`);
+        assert.doesNotMatch(text, /github:\|git|\^\(github\|git/, `${workflow} still carries a prefix-list filter beside the script`);
+    }
+});
+//# sourceMappingURL=no-git-dependencies.test.js.map

package/dist/no-git-dependencies.test.js.map

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

package/dist/packaging.test.d.ts

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

package/dist/packaging.test.js

@@ -0,0 +1,69 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, symlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test, { after } from 'node:test';
+import { fileURLToPath } from 'node:url';
+/**
+ * What an `exports` map does is decided by Node's resolver, against an
+ * INSTALLED package. Reading this repository's own manifest with `readFileSync`
+ * and asserting a key is present answers a different question - "what does the
+ * file say" - and such an assertion passes just as happily with the entry
+ * deleted. carve-js had exactly that test and it did (carve-js#1260).
+ *
+ * So this file asks the resolver instead. A scratch directory gets the
+ * `node_modules` layout an install produces, this package is linked into it,
+ * and a real `node` reads the specifier back from that directory the way a
+ * consumer's CI step would.
+ *
+ * The link points at the repository root, so `tsconfig.json` and `src/` are
+ * present on disk under the installed name. That is what makes the
+ * encapsulation assertion below mean something: those paths are reachable and
+ * still have to be refused.
+ */
+const root = fileURLToPath(new URL('..', import.meta.url));
+const manifest = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+const consumer = mkdtempSync(join(tmpdir(), 'carve-lsp-consumer-'));
+mkdirSync(join(consumer, 'node_modules', '@markup-carve'), { recursive: true });
+symlinkSync(root, join(consumer, 'node_modules', '@markup-carve', 'carve-lsp'), 'dir');
+after(() => rmSync(consumer, { recursive: true, force: true }));
+const run = (script) => execFileSync(process.execPath, ['-e', script], {
+    cwd: consumer,
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+}).trim();
+// Probed with `import`, not `require`: `.` names an `import` condition and no
+// `require` one, so a require probe would answer ERR_PACKAGE_PATH_NOT_EXPORTED
+// for a subpath that is wide open, and the two failures would be
+// indistinguishable.
+const codeOf = (specifier) => run(`import(${JSON.stringify(specifier)}).then(() => console.log('RESOLVED'),` +
+    ` (e) => console.log(e.code ?? String(e)))`);
+test('reads the installed version back through the package specifier', () => {
+    // The question a version-pinning CI step asks. Closed, it throws
+    // ERR_PACKAGE_PATH_NOT_EXPORTED, which reads as "this package is not
+    // installed" rather than "this subpath is closed" - so whoever hits it goes
+    // and audits their install before they suspect a manifest. That failure
+    // mode, not the missing capability, is the cost.
+    const version = run(`console.log(require(${JSON.stringify(`${manifest.name}/package.json`)}).version)`);
+    assert.equal(version, manifest.version);
+});
+test('reads it back under import as well as require', () => {
+    // Both resolvers consult the same map, but only one of them is what a given
+    // shell one-liner in CI happens to use.
+    const version = run(`import(${JSON.stringify(`${manifest.name}/package.json`)}, { with: { type: 'json' } })` +
+        `.then((m) => console.log(m.default.version))`);
+    assert.equal(version, manifest.version);
+});
+test('opens that one file and not the directory holding it', () => {
+    // The failure this guards: widening the map with a `./*` wildcard to fix the
+    // two above. That publishes the whole checkout as importable API - `src/`
+    // included - and nothing else here would notice.
+    assert.equal(codeOf(`${manifest.name}/tsconfig.json`), 'ERR_PACKAGE_PATH_NOT_EXPORTED');
+    assert.equal(codeOf(`${manifest.name}/src/analyze.ts`), 'ERR_PACKAGE_PATH_NOT_EXPORTED');
+    assert.equal(codeOf(`${manifest.name}/dist/analyze.js`), 'ERR_PACKAGE_PATH_NOT_EXPORTED');
+});
+test('still resolves the entry point the map already named', () => {
+    assert.equal(codeOf(manifest.name), 'RESOLVED');
+});
+//# sourceMappingURL=packaging.test.js.map

package/dist/packaging.test.js.map

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

package/dist/selection.d.ts

@@ -0,0 +1,2 @@
+import { type Position, type SelectionRange } from 'vscode-languageserver/node.js';
+export declare function selectionRanges(uri: string, source: string, positions: Position[]): SelectionRange[];

package/dist/selection.js

@@ -0,0 +1,36 @@
+import { scanDocument } from './workspace-index.js';
+export function selectionRanges(uri, source, positions) {
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    const tokens = scanDocument(uri, source);
+    return positions.map((position) => {
+        const lineText = lines[position.line] ?? '';
+        const lineRange = {
+            start: { line: position.line, character: 0 },
+            end: { line: position.line, character: lineText.length },
+        };
+        const documentRange = {
+            start: { line: 0, character: 0 },
+            end: { line: Math.max(0, lines.length - 1), character: lines.at(-1)?.length ?? 0 },
+        };
+        const parent = { range: lineRange, parent: { range: documentRange } };
+        const token = tokens.find((candidate) => contains(candidate.range, position));
+        if (token)
+            return { range: token.range, parent };
+        const word = wordRange(lineText, position);
+        return word ? { range: word, parent } : parent;
+    });
+}
+function contains(range, position) {
+    return position.line === range.start.line && position.character >= range.start.character && position.character <= range.end.character;
+}
+function wordRange(line, position) {
+    for (const match of line.matchAll(/[\p{L}\p{N}_-]+/gu)) {
+        const start = match.index;
+        const end = start + match[0].length;
+        if (position.character >= start && position.character <= end) {
+            return { start: { line: position.line, character: start }, end: { line: position.line, character: end } };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAAc,EAAE,SAAqB;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACxD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3C,MAAM,SAAS,GAAU;YACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;YAC5C,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE;SACzD,CAAA;QACD,MAAM,aAAa,GAAU;YAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YAChC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE;SACnF,CAAA;QACD,MAAM,MAAM,GAAmB,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAA;QACrF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;QAC7E,IAAI,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,CAAA;QAChD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAY,EAAE,QAAkB;IAChD,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAA;AACvI,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAkB;IACjD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAM,CAAA;QAC1B,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QACnC,IAAI,QAAQ,CAAC,SAAS,IAAI,KAAK,IAAI,QAAQ,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YAC7D,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAA;QAC3G,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/selection.test.d.ts

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

package/dist/selection.test.js

@@ -0,0 +1,10 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { selectionRanges } from './selection.js';
+test('expands identifier to line to document', () => {
+    const selected = selectionRanges('file:///a.crv', 'See [^note].\n\nTail.\n', [{ line: 0, character: 7 }])[0];
+    assert.equal(selected.range.start.character, 6);
+    assert.equal(selected.parent?.range.end.character, 12);
+    assert.equal(selected.parent?.parent?.range.end.line, 3);
+});
+//# sourceMappingURL=selection.test.js.map

package/dist/selection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.test.js","sourceRoot":"","sources":["../src/selection.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;IAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,eAAe,EAAE,yBAAyB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAA;IAC7G,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC/C,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACtD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC,CAAC,CAAA"}

package/dist/semantic.d.ts

@@ -1,16 +1,18 @@
-import { type SemanticTokens } from 'vscode-languageserver/node.js';
+import { SemanticTokensBuilder, type SemanticTokens } from 'vscode-languageserver/node.js';
 export declare const semanticTokenTypes: readonly ["keyword", "string", "comment", "property", "variable", "number", "operator", "type"];
 export declare const semanticTokenModifiers: readonly ["declaration", "definition", "readonly"];
 type TokenType = (typeof semanticTokenTypes)[number];
 type TokenModifier = (typeof semanticTokenModifiers)[number];
-interface Token {
+export interface Token {
     line: number;
     character: number;
     length: number;
     type: TokenType;
     modifiers?: TokenModifier[];
 }
-export declare function buildSemanticTokens(source: string): SemanticTokens;
+export declare function buildSemanticTokens(source: string, builder?: SemanticTokensBuilder): SemanticTokens;
+export declare function buildSemanticTokensRange(source: string, startLine: number, endLine: number): SemanticTokens;
+export declare function updateSemanticTokens(source: string, builder: SemanticTokensBuilder, previousResultId: string): SemanticTokens | import("vscode-languageserver-types").SemanticTokensDelta;
 export declare function semanticTokens(source: string): Token[];
 /**
  * Scan a single line for constructs the AST path misses:

package/dist/semantic.js

@@ -14,12 +14,24 @@ export const semanticTokenTypes = [
 export const semanticTokenModifiers = ['declaration', 'definition', 'readonly'];
 const tokenTypeIndex = new Map(semanticTokenTypes.map((type, index) => [type, index]));
 const tokenModifierIndex = new Map(semanticTokenModifiers.map((modifier, index) => [modifier, index]));
-export function buildSemanticTokens(source) {
+export function buildSemanticTokens(source, builder = new SemanticTokensBuilder()) {
+    fillBuilder(builder, semanticTokens(source));
+    return builder.build();
+}
+export function buildSemanticTokensRange(source, startLine, endLine) {
     const builder = new SemanticTokensBuilder();
-    for (const token of semanticTokens(source)) {
+    fillBuilder(builder, semanticTokens(source).filter((token) => token.line >= startLine && token.line <= endLine));
+    return builder.build();
+}
+export function updateSemanticTokens(source, builder, previousResultId) {
+    builder.previousResult(previousResultId);
+    fillBuilder(builder, semanticTokens(source));
+    return builder.buildEdits();
+}
+function fillBuilder(builder, tokens) {
+    for (const token of tokens) {
         builder.push(token.line, token.character, token.length, tokenTypeIndex.get(token.type) ?? 0, modifierMask(token.modifiers ?? []));
     }
-    return builder.build();
 }
 export function semanticTokens(source) {
     try {
@@ -126,7 +138,11 @@ function collectBlock(tokens, lines, node) {
                 collectInline(tokens, lines, node.caption);
             break;
         case 'table':
-            pushPosition(tokens, lines, node.pos, 'string');
+            if (node.pos) {
+                for (let line = node.pos.startLine - 1; line < node.pos.endLine; line += 1) {
+                    scanTableLine(tokens, line, lines[line] ?? '');
+                }
+            }
             if (node.caption)
                 collectInline(tokens, lines, node.caption);
             for (const row of node.rows) {
@@ -145,6 +161,17 @@ function collectBlock(tokens, lines, node) {
             break;
     }
 }
+function scanTableLine(tokens, line, text) {
+    for (const pipe of text.matchAll(/\|/g))
+        push(tokens, line, pipe.index, 1, 'operator');
+    for (const marker of text.matchAll(/\|=?\s*([<>~^v]{1,2})(?=\{| )/g)) {
+        const run = marker[1];
+        push(tokens, line, marker.index + marker[0].indexOf(run), run.length, 'keyword');
+    }
+    for (const attr of text.matchAll(/\b(aligns|valigns|widths|footer-rows|header-rows|header-cols)=/g)) {
+        push(tokens, line, attr.index, attr[1].length, 'property');
+    }
+}
 function collectFigureTarget(tokens, lines, node) {
     if (node.type === 'image')
         pushPosition(tokens, lines, node.pos, 'string');