@markup-carve/carve-lsp 0.1.4 → 0.1.7

package/dist/include-selection.js

@@ -0,0 +1,67 @@
+/**
+ * The two selections an include directive can carry - `#section` and a line
+ * range - resolved against a child's own source (PART 9 §19 I4, I5).
+ *
+ * Both are decidable from the child alone: no merge, no heading shift, no id
+ * renaming. That is what lets this server diagnose and navigate them while
+ * expansion itself still lives in the engine.
+ *
+ * Heading ids come from the resolver rather than a lexical scan, because the
+ * resolver is authoritative for Unicode, inline markup and duplicate suffixes.
+ * A lexical guess would report `include-section` against ids the engine
+ * generates perfectly well, and a false diagnostic on a working document is
+ * worse than a missing one.
+ */
+import { parse, resolve } from '@markup-carve/carve';
+const HEADING_MARKER_RE = /^#{1,6}\s+/;
+/** Every heading id the child declares, in document order. */
+export function sections(source) {
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    let document;
+    try {
+        document = resolve(parse(source, { positions: true }));
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    walk(document.children, (node) => {
+        if (node.type !== 'heading' || !node.pos || !node.attrs?.id)
+            return;
+        const line = node.pos.startLine - 1;
+        const text = lines[line] ?? '';
+        const character = Math.min(text.length, HEADING_MARKER_RE.exec(text)?.[0].length ?? 0);
+        found.push({
+            id: node.attrs.id,
+            range: { start: { line, character }, end: { line, character: text.length } },
+        });
+    });
+    return found;
+}
+/** Where a named section starts in the child, or undefined when it has none. */
+export function sectionRange(source, id) {
+    return sections(source).find((section) => section.id === id)?.range;
+}
+/**
+ * Lines as the line-range option counts them. A trailing newline does not open
+ * a further line, so `@lines:3-3` on a three-line file is in range.
+ */
+export function lineCount(source) {
+    if (source === '')
+        return 0;
+    const normalized = source.replace(/\r\n?/g, '\n');
+    const lines = normalized.split('\n');
+    if (lines.length > 1 && lines[lines.length - 1] === '')
+        lines.pop();
+    return lines.length;
+}
+function walk(nodes, visit) {
+    for (const node of nodes) {
+        visit(node);
+        const children = node.children;
+        if (!Array.isArray(children))
+            continue;
+        walk(children.filter((child) => Boolean(child && typeof child === 'object' && 'type' in child)), visit);
+    }
+}
+//# sourceMappingURL=include-selection.js.map

package/dist/include-selection.js.map

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

package/dist/include-settings.d.ts

@@ -7,7 +7,13 @@ export interface IncludeSettings {
      * OFF: silence is not consent.
      */
     enabled: 'auto' | 'on' | 'off';
-    /** Containment root override. Otherwise the workspace root, then the document's directory. */
+    /**
+     * Containment root override. Otherwise the workspace root, then the
+     * document's directory.
+     *
+     * Only an ABSOLUTE, non-blank path is a root. See {@link usableIncludeRoot}
+     * for why the other spellings are dropped rather than resolved.
+     */
     includeRoot?: string;
     /** Allow absolute include paths, still subject to root containment. */
     allowAbsolute?: boolean;
@@ -15,6 +21,8 @@ export interface IncludeSettings {
     allowedRemoteHosts?: string[];
     maxDepth?: number;
     maxBytes?: number;
+    /** Resolver calls allowed for one walk. Default 1000. */
+    maxResolverCalls?: number;
 }
 export declare const DEFAULT_INCLUDE_SETTINGS: IncludeSettings;
 /**
@@ -22,7 +30,39 @@ export declare const DEFAULT_INCLUDE_SETTINGS: IncludeSettings;
  * `workspace/didChangeConfiguration` payload. Anything unrecognized falls back
  * to the default rather than being trusted as given.
  */
-export declare function readIncludeSettings(raw: unknown): IncludeSettings;
+export declare function readIncludeSettings(raw: unknown, log?: (message: string) => void): IncludeSettings;
+/**
+ * Whether a configured `includeRoot` is usable as a containment root, and why
+ * not when it is not.
+ *
+ * Both rejected spellings resolve against the PROCESS WORKING DIRECTORY, which
+ * is the one root §19 containment must never have: a language server is
+ * commonly spawned from the project the editor opened, from the user's home or
+ * from `/`, and none of those is the workspace.
+ *
+ * - BLANK. `realpathSync('')` returns the process working directory and does
+ *   NOT throw, so a blank value is not a value that fails - it is a value that
+ *   silently succeeds at the wrong root. An editor returns `''` for an unset
+ *   string setting, so a client forwarding its setting unchanged sends one by
+ *   default.
+ * - RELATIVE. The configuration protocol gives a relative path no base, so the
+ *   only base available here is again the working directory. Resolving it
+ *   against the workspace root instead would be a policy this server invented:
+ *   it reads the client's intent, and a value such as `..` would widen the root
+ *   ABOVE the workspace, which is the same escape by another route. Dropping it
+ *   falls back to a root the client did name.
+ *
+ * Dropping is fail-closed in both cases: the fallback chain - workspace root,
+ * then the document's own directory - is never wider than the workspace.
+ */
+export declare function usableIncludeRoot(value: string): {
+    root: string;
+    ignored?: undefined;
+} | {
+    root?: undefined;
+    ignored: 'blank' | 'relative';
+};
+export declare function ignoredIncludeRootMessage(value: string, reason: 'blank' | 'relative'): string;
 /** Client-reported workspace trust. Absent means untrusted. */
 export declare function readWorkspaceTrusted(raw: unknown): boolean;
 export declare function fsPath(uri: string): string | undefined;
@@ -50,3 +90,8 @@ export interface IncludeGateInput {
  * meaningless.
  */
 export declare function includeOptionsFor(input: IncludeGateInput): IncludeOptions | undefined;
+/**
+ * Include options for `carve.previewHtml`. The preview expands only under an
+ * explicitly configured root; otherwise it renders the source as written.
+ */
+export declare function previewIncludeOptionsFor(input: IncludeGateInput): IncludeOptions | undefined;

package/dist/include-settings.js

@@ -17,7 +17,7 @@ export const DEFAULT_INCLUDE_SETTINGS = { enabled: 'auto' };
  * `workspace/didChangeConfiguration` payload. Anything unrecognized falls back
  * to the default rather than being trusted as given.
  */
-export function readIncludeSettings(raw) {
+export function readIncludeSettings(raw, log) {
     const source = raw?.carve
         ?.includes;
     if (!source || typeof source !== 'object')
@@ -26,8 +26,14 @@ export function readIncludeSettings(raw) {
     const settings = {
         enabled: enabled === 'on' || enabled === 'off' ? enabled : 'auto',
     };
-    if (typeof source['includeRoot'] === 'string')
-        settings.includeRoot = source['includeRoot'];
+    const configuredRoot = source['includeRoot'];
+    if (typeof configuredRoot === 'string') {
+        const verdict = usableIncludeRoot(configuredRoot);
+        if (verdict.root !== undefined)
+            settings.includeRoot = verdict.root;
+        else
+            log?.(ignoredIncludeRootMessage(configuredRoot, verdict.ignored));
+    }
     if (typeof source['allowAbsolute'] === 'boolean')
         settings.allowAbsolute = source['allowAbsolute'];
     if (Array.isArray(source['allowedRemoteHosts'])) {
@@ -37,8 +43,48 @@ export function readIncludeSettings(raw) {
         settings.maxDepth = source['maxDepth'];
     if (typeof source['maxBytes'] === 'number')
         settings.maxBytes = source['maxBytes'];
+    if (typeof source['maxResolverCalls'] === 'number') {
+        settings.maxResolverCalls = source['maxResolverCalls'];
+    }
     return settings;
 }
+/**
+ * Whether a configured `includeRoot` is usable as a containment root, and why
+ * not when it is not.
+ *
+ * Both rejected spellings resolve against the PROCESS WORKING DIRECTORY, which
+ * is the one root §19 containment must never have: a language server is
+ * commonly spawned from the project the editor opened, from the user's home or
+ * from `/`, and none of those is the workspace.
+ *
+ * - BLANK. `realpathSync('')` returns the process working directory and does
+ *   NOT throw, so a blank value is not a value that fails - it is a value that
+ *   silently succeeds at the wrong root. An editor returns `''` for an unset
+ *   string setting, so a client forwarding its setting unchanged sends one by
+ *   default.
+ * - RELATIVE. The configuration protocol gives a relative path no base, so the
+ *   only base available here is again the working directory. Resolving it
+ *   against the workspace root instead would be a policy this server invented:
+ *   it reads the client's intent, and a value such as `..` would widen the root
+ *   ABOVE the workspace, which is the same escape by another route. Dropping it
+ *   falls back to a root the client did name.
+ *
+ * Dropping is fail-closed in both cases: the fallback chain - workspace root,
+ * then the document's own directory - is never wider than the workspace.
+ */
+export function usableIncludeRoot(value) {
+    if (value.trim() === '')
+        return { ignored: 'blank' };
+    if (!path.isAbsolute(value))
+        return { ignored: 'relative' };
+    return { root: value };
+}
+export function ignoredIncludeRootMessage(value, reason) {
+    const because = reason === 'blank'
+        ? 'it is blank'
+        : `it is relative (${JSON.stringify(value)}), and a relative root would resolve against the server's working directory`;
+    return `Carve: ignoring carve.includes.includeRoot because ${because}; falling back to the workspace root.`;
+}
 /** Client-reported workspace trust. Absent means untrusted. */
 export function readWorkspaceTrusted(raw) {
     return raw?.workspaceTrusted === true;
@@ -98,9 +144,13 @@ export function includeOptionsFor(input) {
     // directory to resolve against and gets no capability.
     if (documentPath === undefined)
         return undefined;
-    const configured = input.settings.includeRoot ??
-        workspaceRootFor(documentPath, input.workspaceRoots) ??
-        dirname(documentPath);
+    // Defense in depth against a settings object built by hand rather than read
+    // through `readIncludeSettings`: an unusable root is ABSENT here too, so the
+    // fallback chain below is the same one an omitted key already takes.
+    const override = input.settings.includeRoot === undefined
+        ? undefined
+        : usableIncludeRoot(input.settings.includeRoot).root;
+    const configured = override ?? workspaceRootFor(documentPath, input.workspaceRoots) ?? dirname(documentPath);
     // Canonicalize the root here as well as inside the resolver, so that the
     // root a caller sees on `includeRoot` is in the same coordinate system as
     // the ids the resolver returns. Without it, a root reached through a symlink
@@ -131,6 +181,19 @@ export function includeOptionsFor(input) {
         options.maxDepth = input.settings.maxDepth;
     if (input.settings.maxBytes !== undefined)
         options.maxBytes = input.settings.maxBytes;
+    if (input.settings.maxResolverCalls !== undefined) {
+        options.maxResolverCalls = input.settings.maxResolverCalls;
+    }
     return options;
 }
+/**
+ * Include options for `carve.previewHtml`. The preview expands only under an
+ * explicitly configured root; otherwise it renders the source as written.
+ */
+export function previewIncludeOptionsFor(input) {
+    const configured = input.settings.includeRoot;
+    if (configured === undefined || usableIncludeRoot(configured).root === undefined)
+        return undefined;
+    return includeOptionsFor(input);
+}
 //# sourceMappingURL=include-settings.js.map

package/dist/include-settings.js.map

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

package/dist/include-settings.test.js

@@ -188,4 +188,122 @@ test('settings are read from the carve.includes section', () => {
         maxBytes: 2048,
     });
 });
+// ---------------------------------------------------------------------------
+// The resolver-call bound (PART 9 §19), configurable like the other two totals
+// ---------------------------------------------------------------------------
+test('the resolver-call bound is read from the carve.includes section', () => {
+    const settings = readIncludeSettings({ carve: { includes: { maxResolverCalls: 25 } } });
+    assert.equal(settings.maxResolverCalls, 25);
+});
+test('a non-numeric resolver-call bound is ignored rather than trusted as given', () => {
+    const settings = readIncludeSettings({ carve: { includes: { maxResolverCalls: 'lots' } } });
+    assert.equal(settings.maxResolverCalls, undefined);
+});
+test('an unset resolver-call bound leaves the walk on its own default', () => {
+    const settings = readIncludeSettings({ carve: { includes: { enabled: 'on' } } });
+    assert.equal(settings.maxResolverCalls, undefined);
+});
+test('a configured resolver-call bound reaches the walk options', () => {
+    const dir = workspace();
+    const options = includeOptionsFor({
+        uri: pathToFileURL(path.join(dir, 'docs/main.crv')).href,
+        settings: { enabled: 'on', maxResolverCalls: 25 },
+        workspaceTrusted: true,
+        workspaceRoots: [dir],
+    });
+    assert.equal(options?.maxResolverCalls, 25);
+});
+test('an unconfigured resolver-call bound is left off the options entirely', () => {
+    // Absent rather than undefined-valued, so the walk applies its own default
+    // under exactOptionalPropertyTypes.
+    const dir = workspace();
+    const options = includeOptionsFor({
+        uri: pathToFileURL(path.join(dir, 'docs/main.crv')).href,
+        settings: { enabled: 'on' },
+        workspaceTrusted: true,
+        workspaceRoots: [dir],
+    });
+    assert.ok(options && !('maxResolverCalls' in options));
+});
+test('the resolver-call bound does not open the capability on its own', () => {
+    // §19 opt-in: a bound is a limit, never a grant.
+    const dir = workspace();
+    const options = includeOptionsFor({
+        uri: pathToFileURL(path.join(dir, 'docs/main.crv')).href,
+        settings: { enabled: 'auto', maxResolverCalls: 25 },
+        workspaceTrusted: false,
+        workspaceRoots: [dir],
+    });
+    assert.equal(options, undefined);
+});
+/**
+ * The reader-level half of the containment fix. The behavior it produces is
+ * pinned end-to-end in `include-root-containment.test.ts`, against the running
+ * server; these pin the seam and the wording the log carries.
+ */
+test('a blank includeRoot is read as absent, not as the working directory', () => {
+    const settings = readIncludeSettings({ carve: { includes: { enabled: 'on', includeRoot: '' } } });
+    assert.equal(settings.includeRoot, undefined);
+});
+test('a whitespace-only includeRoot is read as absent too', () => {
+    const settings = readIncludeSettings({
+        carve: { includes: { enabled: 'on', includeRoot: ' \t ' } },
+    });
+    assert.equal(settings.includeRoot, undefined);
+});
+test('a relative includeRoot is read as absent, since it has no base but the cwd', () => {
+    const settings = readIncludeSettings({
+        carve: { includes: { enabled: 'on', includeRoot: 'docs' } },
+    });
+    assert.equal(settings.includeRoot, undefined);
+});
+test('dropping a blank includeRoot does not disable includes', () => {
+    const settings = readIncludeSettings({ carve: { includes: { enabled: 'on', includeRoot: '' } } });
+    assert.equal(settings.enabled, 'on');
+});
+test('an absolute includeRoot is still read as given', () => {
+    const settings = readIncludeSettings({
+        carve: { includes: { enabled: 'on', includeRoot: '/ws/docs' } },
+    });
+    assert.equal(settings.includeRoot, '/ws/docs');
+});
+test('a dropped includeRoot is logged once, naming the reason', () => {
+    const logged = [];
+    readIncludeSettings({ carve: { includes: { includeRoot: '' } } }, (m) => logged.push(m));
+    assert.deepEqual(logged, [
+        'Carve: ignoring carve.includes.includeRoot because it is blank; falling back to the workspace root.',
+    ]);
+});
+test('a dropped relative includeRoot names the value it dropped', () => {
+    const logged = [];
+    readIncludeSettings({ carve: { includes: { includeRoot: 'docs' } } }, (m) => logged.push(m));
+    assert.match(logged[0] ?? '', /relative \("docs"\)/);
+});
+test('an honored includeRoot logs nothing', () => {
+    const logged = [];
+    readIncludeSettings({ carve: { includes: { includeRoot: '/ws' } } }, (m) => logged.push(m));
+    assert.deepEqual(logged, []);
+});
+test('a blank includeRoot reaching includeOptionsFor directly falls back as well', () => {
+    // `readIncludeSettings` is not the only way an `IncludeSettings` is built;
+    // the containment decision is owned here, so the guard is here too.
+    const dir = workspace();
+    const options = includeOptionsFor({
+        uri: pathToFileURL(path.join(dir, 'docs/main.crv')).href,
+        settings: { enabled: 'on', includeRoot: '' },
+        workspaceTrusted: true,
+        workspaceRoots: [dir],
+    });
+    assert.equal(options?.includeRoot, dir);
+});
+test('a relative includeRoot reaching includeOptionsFor directly falls back as well', () => {
+    const dir = workspace();
+    const options = includeOptionsFor({
+        uri: pathToFileURL(path.join(dir, 'docs/main.crv')).href,
+        settings: { enabled: 'on', includeRoot: 'docs' },
+        workspaceTrusted: true,
+        workspaceRoots: [dir],
+    });
+    assert.equal(options?.includeRoot, dir);
+});
 //# sourceMappingURL=include-settings.test.js.map

package/dist/include-settings.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"include-settings.test.js","sourceRoot":"","sources":["../src/include-settings.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,uBAAuB,CAAA;AAE9B,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IAC3E,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACtD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,mBAAmB,CAAC,CAAA;IACnE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAA;IAC3D,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC/D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,IAAI,GAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjD,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACrF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,IAAI;QACd,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAA;IACpD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IAC7C,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;IACtE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;AACtE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,IAAI;QACd,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC5B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IACtC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAA;AACnE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC5B,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACtD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,KAAK;QACvB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AAC9B,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,IAAI,CAAC,mFAAmF,EAAE,GAAG,EAAE;IAC7F,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;AACtD,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;IACzB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,IAAI;QACtB,qDAAqD;QACrD,cAAc,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC;KAC7B,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAAA;AACzC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACvF,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,KAAK,GAAG,SAAS,EAAE,CAAA;IACzB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,KAAK,CAAC;KACxB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACxD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;KAC9C,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE;QAChE,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,sEAAsE;IACtE,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACvE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACtB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QAC9C,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAAA;AACzC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,MAAM,GAAG,GAAG,SAAS,EAAE,CAAA;IACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI;QACxD,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE;QAC1E,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,GAAG,CAAC;KACtB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACrE,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC3B,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE,CAAC,MAAM,CAAC;KACzB,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,IAAI,CAAC,sEAAsE,EAAE,GAAG,EAAE;IAChF,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IACrE,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9D,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE;QACxF,OAAO,EAAE,MAAM;KAChB,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,KAAK,EAAE;YACL,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,KAAK;gBAClB,aAAa,EAAE,IAAI;gBACnB,kBAAkB,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;gBACtC,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,IAAI;aACf;SACF;KACF,CAAC,CAAA;IACF,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE;QACzB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,IAAI;QACnB,6DAA6D;QAC7D,kBAAkB,EAAE,CAAC,aAAa,CAAC;QACnC,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,IAAI;KACf,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"include-settings.test.js","sourceRoot":"","sources":["../src/include-settings.test.ts"],"names":[],"mappings":"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"}

package/dist/includes.d.ts

@@ -1,5 +1,36 @@
-import type { IncludeResolver } from './include-path.js';
-/** Warning emitted by {@link resolveIncludes}. Shape mirrors the engine's. */
+/**
+ * Include resolution for the language server (PART 9 §19), delegated to the
+ * engine.
+ *
+ * The rules are `expandIncludes`': it merges each child into the parent and
+ * reports every §19 degradation, including the six that are only decidable
+ * once the merge has happened - a clamped heading level, a renamed heading id
+ * or footnote label, block content at an inline position. This server used to
+ * carry its own walk because the pinned engine had no include pass; it has one
+ * now, so the walk is gone and there is one spelling of each rule again.
+ *
+ * What stays here is what a language server needs and the engine's contract
+ * cannot carry:
+ *
+ * - the ROOT anchor for every warning. The engine reports a child's problem at
+ *   the child's own offsets, which is right for a renderer and unusable as an
+ *   LSP range: the client has the root open. Each warning keeps its root span
+ *   and gains {@link IncludeWarning.within} for the other end.
+ * - the `watch` candidate and the refusal class, which the engine's resolver
+ *   contract has no slot for.
+ * - the child sources, which the outline and the seam location read back.
+ * - a sliced child's own coordinates. The engine slices before it parses, so a
+ *   child pulled in with `@lines` reports positions against the slice under the
+ *   whole file's id, which §19 requires to be the file's own. See
+ *   {@link sliceShifts}; markup-carve/carve-js#1861 is the engine-side defect.
+ *
+ * The path-level security guards are untouched in {@link ./include-path.js}.
+ * The resolver is still this server's, so what may be read at all is still
+ * decided here.
+ */
+import { type Document } from '@markup-carve/carve';
+import type { IncludeDenial, IncludeResolver } from './include-path.js';
+/** Warning emitted by {@link resolveIncludes}. */
 export interface IncludeWarning {
     /** 1-based line number in the ROOT document. */
     line: number;
@@ -10,13 +41,22 @@ export interface IncludeWarning {
     /** Human-readable explanation of the include degradation. */
     message: string;
     /**
-     * Failure class, when one exists. Kept OUT of `message` on purpose: §19 I7
+     * Raw text of a resolver that THREW. Kept OUT of `message` on purpose: §19 I7
      * requires a processor-generated message naming the failure class rather
      * than a resolver's own error, which routinely embeds absolute filesystem
      * paths. Tools that want it (a log sink, a test) read it here; the published
-     * diagnostic does not print it.
+     * diagnostic does not print it. A resolver that REFUSED rather than threw
+     * reports its class on {@link denial}, which is typed and safe to publish.
      */
     detail?: string;
+    /**
+     * Resolver refusal class, when the failure came from a resolver that reports
+     * one. Typed, unlike {@link detail}, which is overloaded with the raw text of
+     * a resolver that THREW and must never reach an author. The published
+     * diagnostic maps this to its code and wording; see
+     * {@link ./include-denial.js}.
+     */
+    denial?: IncludeDenial;
     /** 0-based start offset in the ROOT document, inclusive. */
     start: number;
     /** 0-based end offset in the ROOT document, exclusive. */
@@ -25,9 +65,28 @@ export interface IncludeWarning {
      * Identity of the file the warning arose in: the resolver's canonical id, or
      * the raw directive path when there is none. A directive that failed to
      * resolve is attributed to the document containing it, not to the target it
-     * names; a warning raised while walking a child is attributed to that child.
+     * names; a warning raised while expanding a child is attributed to that child.
      */
     file?: string;
+    /**
+     * Where the warning actually sits inside {@link file}: that file's own
+     * offsets, and its own 1-based line and column.
+     *
+     * `start`/`end` above stay anchored to the ROOT document, because that is
+     * the only range valid in the document the client has open. This is the
+     * other half, for a host that can also open the child: a diagnostic that
+     * points at the parent for a child's problem sends the author to edit the
+     * wrong file, which is worse than reporting nothing.
+     *
+     * Absent for a warning raised in the root document, where `start`/`end`
+     * already are that position.
+     */
+    within?: {
+        line: number;
+        column: number;
+        start: number;
+        end: number;
+    };
 }
 /**
  * One include target touched during resolution. Hosts key file watchers off
@@ -57,9 +116,27 @@ export interface IncludeOptions {
     maxDepth?: number;
     /** Total byte budget across the walk. Default max(1 MiB, 8 x root bytes). */
     maxBytes?: number;
+    /**
+     * Resolver calls allowed for one walk. Default 1000, the §19 RECOMMENDED
+     * floor and the engine's own default.
+     *
+     * Bounds the WORK, which the byte budget does not: a target is resolved
+     * before its size is known, and a target that fails to resolve is never
+     * charged at all.
+     */
+    maxResolverCalls?: number;
+    /**
+     * Warnings retained. Default 100, the engine's. One per distinct rule always
+     * survives and {@link IncludeResolution.suppressedWarnings} reports the
+     * remainder, so a document of a thousand refused directives costs a bounded
+     * republish on every keystroke without hiding a failure class.
+     */
+    maxWarnings?: number;
 }
 export interface IncludeResolution {
     warnings: IncludeWarning[];
+    /** Warnings raised but not retained. Zero on every uncapped run. */
+    suppressedWarnings: number;
     /**
      * Every include target touched, nested children included, de-duplicated and
      * in first-encounter order. Empty when no resolver was supplied.
@@ -67,13 +144,42 @@ export interface IncludeResolution {
     dependencies: IncludeDependency[];
     /** Bytes charged against the budget. */
     bytes: number;
-    /** Successfully read child documents, de-duplicated by canonical id. */
+    /**
+     * Successfully read child documents, de-duplicated by canonical id.
+     *
+     * `watch` is the resolver's own filesystem path for the child, present only
+     * when the resolver has one. It is what separates a real file from an
+     * identity that merely looks like a path: a virtual-filesystem resolver may
+     * hand back `/virtual/child.crv`, and a host that turned that into a `file:`
+     * URI would offer the author a location that does not exist.
+     */
     documents: Array<{
         id: string;
         source: string;
         version?: string;
+        watch?: string;
     }>;
+    /**
+     * The document with every child merged in, as §19 defines it, or `undefined`
+     * when the pass was inert or the root did not parse.
+     *
+     * Every node a child contributed carries that child's identity on `pos.file`
+     * (§19 source mapping), and carries it AFTER the renames, clamps and section
+     * selection the merge applied. That is what makes it the thing to navigate
+     * through: a crossref in the parent names the id the merged document ended
+     * up with, which is not always the id the child file spells.
+     */
+    expanded?: Document;
 }
+/**
+ * Offset of each line's first character, counted in the unit the installed
+ * parser's offsets are in, so `locateIn` can be given one directly.
+ *
+ * Exported for the test that drives the branch the installed engine does not
+ * take. A test that built its own table would agree with this one under either
+ * unit and so could not see the branch at all.
+ */
+export declare function lineStarts(source: string): number[];
 /**
  * Walk the include graph rooted at `source`.
  *