@lapidist/dtif-language-server 0.5.0

package/README.md

@@ -0,0 +1,108 @@
+# DTIF Language Server
+
+`@lapidist/dtif-language-server` delivers Language Server Protocol (LSP) services for the Design Token Interchange Format (DTIF). It brings schema-backed diagnostics, pointer-aware navigation, and assisted authoring into any editor that can host a Node.js language server.
+
+> **Runtime** · Node.js 22<br>
+> **Transports** · stdio (default), custom message readers/writers
+
+## Capabilities
+
+### Diagnostics and validation
+
+- Parses DTIF documents with tolerant JSONC support and precise error ranges.
+- Validates against the canonical DTIF schema via `@lapidist/dtif-validator`.
+- Publishes diagnostics on open and change events, clearing them automatically when documents close.
+
+### Navigation and insights
+
+- Resolves JSON pointers for `$ref` members and theming overrides.
+- Provides jump-to-definition, hover documentation with inline token previews, and related location metadata.
+- Keeps an incremental document index so navigation stays responsive in large workspaces.
+
+### Refactors and quick fixes
+
+- Supports rename refactors for pointer definitions, emitting workspace edits that update every reference currently loaded by the server.
+- Offers quick fixes for common schema issues such as missing `$type` or `$ref` members, inserting scaffolded payloads that respect DTIF structure.
+
+### Authoring assistance
+
+- Supplies contextual completions for `$type` identifiers, measurement units, and `$extensions` namespaces sourced from the DTIF registry.
+- Orders completion results by relevance to the active pointer scope.
+
+## Installation
+
+```bash
+npm install --save-dev @lapidist/dtif-language-server
+```
+
+The package bundles TypeScript declarations and compiled JavaScript so editors can load it directly from `node_modules`.
+
+## Minimal bootstrap
+
+```ts
+import { start } from '@lapidist/dtif-language-server';
+
+start();
+```
+
+`start()` wires the language server to stdio, making it compatible with VS Code, Neovim, Sublime Text, and any editor that launches Node-based LSP servers as child processes. For socket- or stream-based transports, pass custom message reader and writer instances:
+
+```ts
+import net from 'node:net';
+import { createConnection, start } from '@lapidist/dtif-language-server';
+import { SocketMessageReader, SocketMessageWriter } from 'vscode-languageserver/node';
+
+const socket = net.connect({ port: 7000 });
+const connection = createConnection(
+  new SocketMessageReader(socket),
+  new SocketMessageWriter(socket)
+);
+
+start({ connection });
+```
+
+## Workspace settings
+
+The language server reads optional workspace configuration under the `dtifLanguageServer` section.
+
+| Setting           | Type            | Default | Description                                                                     |
+| ----------------- | --------------- | ------- | ------------------------------------------------------------------------------- |
+| `validation.mode` | `'on' \| 'off'` | `'on'`  | Enables or suppresses schema diagnostics while keeping navigation indexes warm. |
+
+Settings can be supplied by clients that implement [`workspace/configuration`](https://microsoft.github.io/language-server-protocol/specifications/specification-current/#workspace_configuration) or via editor-specific configuration files.
+
+### VS Code example
+
+```jsonc
+{
+  "dtifLanguageServer": {
+    "validation": {
+      "mode": "on"
+    }
+  }
+}
+```
+
+## Version alignment
+
+The language server depends on `@lapidist/dtif-parser`, `@lapidist/dtif-validator`, and `@lapidist/dtif-schema`. Package versions are locked so that a single release captures compatible behaviour across the stack. When upgrading one dependency, bump the workspace using a Changeset so downstream integrators receive an aligned bundle.
+
+## Development
+
+- `npm run build --workspace=@lapidist/dtif-language-server` – compile to `dist/`.
+- `npm test --workspace=@lapidist/dtif-language-server` – run the Node.js test suite.
+- `npm run lint` / `npm run lint:ts` – enforce repository lint rules.
+
+Integration tests in `language-server/tests/` spin up the LSP over JSON-RPC streams to verify diagnostics, navigation, refactors, and configuration handling end to end.
+
+## Troubleshooting
+
+| Symptom                                               | Suggested action                                                                                                                  |
+| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| Diagnostics do not appear                             | Confirm `validation.mode` is set to `'on'` and the client calls `textDocument/didOpen` for DTIF files.                            |
+| Rename edits miss some files                          | Only documents opened by the client are available to the server. Ensure the editor loads relevant files before triggering rename. |
+| Diagnostics do not reappear after toggling validation | Ensure the client re-requests configuration after edits. Some editors only refetch settings on save or focus changes.             |
+
+## License
+
+This package is distributed under the [MIT License](../LICENSE). See the repository root for contributing guidelines and governance.

package/dist/code-actions.d.ts

@@ -0,0 +1,11 @@
+import { type CodeAction, type CodeActionParams } from 'vscode-languageserver/node.js';
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import { DocumentAnalysisStore } from './core/documents/analysis-store.js';
+interface QuickFixContext {
+    readonly document: TextDocument;
+    readonly params: CodeActionParams;
+    readonly store: DocumentAnalysisStore;
+}
+export declare function buildQuickFixes(context: QuickFixContext): CodeAction[];
+export {};
+//# sourceMappingURL=code-actions.d.ts.map

package/dist/code-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-actions.d.ts","sourceRoot":"","sources":["../src/code-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAGtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAO3E,UAAU,eAAe;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC;AAaD,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,EAAE,CAkDtE"}

package/dist/code-actions.js

@@ -0,0 +1,106 @@
+import { CodeActionKind } from 'vscode-languageserver/node.js';
+import { isRecord } from './core/utils/object.js';
+const INDENT_UNIT = '  ';
+const LEADING_WHITESPACE = /^\s*/u;
+export function buildQuickFixes(context) {
+    const { document, params, store } = context;
+    const actions = [];
+    const uri = params.textDocument.uri;
+    for (const diagnostic of params.context.diagnostics) {
+        const data = toDiagnosticData(diagnostic.data);
+        if (!data?.pointer) {
+            continue;
+        }
+        if (data.keyword === 'required' && isRecord(data.params)) {
+            const missingProperty = data.params.missingProperty;
+            if (missingProperty === '$type') {
+                const action = buildInsertPropertyAction({
+                    document,
+                    uri,
+                    pointer: data.pointer,
+                    property: '$type',
+                    value: '',
+                    title: 'Add "$type" property',
+                    diagnostic,
+                    store
+                });
+                if (action) {
+                    action.isPreferred = true;
+                    actions.push(action);
+                }
+                continue;
+            }
+            if (missingProperty === '$ref') {
+                const action = buildInsertPropertyAction({
+                    document,
+                    uri,
+                    pointer: data.pointer,
+                    property: '$ref',
+                    value: '',
+                    title: 'Add "$ref" property',
+                    diagnostic,
+                    store
+                });
+                if (action) {
+                    actions.push(action);
+                }
+            }
+        }
+    }
+    return actions;
+}
+function buildInsertPropertyAction(options) {
+    const node = options.store.getPointerNode(options.uri, options.pointer);
+    if (!node || node.type !== 'object') {
+        return undefined;
+    }
+    const edit = buildInsertPropertyEdit(options.document, node, options.property, options.value);
+    if (!edit) {
+        return undefined;
+    }
+    const workspaceEdit = { changes: { [options.uri]: [edit] } };
+    return {
+        title: options.title,
+        kind: CodeActionKind.QuickFix,
+        diagnostics: [options.diagnostic],
+        edit: workspaceEdit
+    };
+}
+function buildInsertPropertyEdit(document, node, property, value) {
+    const insertOffset = node.offset + 1;
+    const position = document.positionAt(insertOffset);
+    const indent = getIndentation(document, node.offset);
+    const propertyIndent = `${indent}${INDENT_UNIT}`;
+    const propertyText = `${propertyIndent}${JSON.stringify(property)}: ${JSON.stringify(value)}`;
+    const hasProperties = Array.isArray(node.children) && node.children.length > 0;
+    const newText = hasProperties ? `\n${propertyText},\n` : `\n${propertyText}\n${indent}`;
+    return {
+        range: { start: position, end: position },
+        newText
+    };
+}
+function getIndentation(document, offset) {
+    const position = document.positionAt(offset);
+    const lineStart = { line: position.line, character: 0 };
+    const lineEnd = { line: position.line, character: position.character };
+    const prefix = document.getText({ start: lineStart, end: lineEnd });
+    const match = LEADING_WHITESPACE.exec(prefix);
+    return match?.[0] ?? '';
+}
+function toDiagnosticData(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const pointerValue = value.pointer;
+    if (typeof pointerValue !== 'string') {
+        return undefined;
+    }
+    const keywordValue = typeof value.keyword === 'string' ? value.keyword : undefined;
+    const paramsValue = 'params' in value ? value.params : undefined;
+    return {
+        pointer: pointerValue,
+        keyword: keywordValue,
+        params: paramsValue
+    };
+}
+//# sourceMappingURL=code-actions.js.map

package/dist/code-actions.js.map

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

package/dist/core/documents/analysis-store.d.ts

@@ -0,0 +1,27 @@
+import type { Node as JsonNode } from 'jsonc-parser';
+import type { Position } from 'vscode-languageserver/node.js';
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import { type PointerKeyMatch, type PointerMatch } from './queries.js';
+import type { DocumentAnalysis, DocumentReference, PointerMetadata } from './types.js';
+export interface DocumentAnalysisUpdateResult {
+    readonly ok: boolean;
+    readonly error?: unknown;
+}
+export declare class DocumentAnalysisStore {
+    #private;
+    update(document: TextDocument): DocumentAnalysisUpdateResult;
+    remove(uri: string): void;
+    get(uri: string): DocumentAnalysis | undefined;
+    entries(): IterableIterator<[string, DocumentAnalysis]>;
+    findReference(uri: string, position: Position): DocumentReference | null;
+    findPointerKey(uri: string, position: Position): PointerKeyMatch | null;
+    matchPointer(uri: string, position: Position): PointerMatch | null;
+    getPointerMetadata(uri: string, pointer: string): PointerMetadata | undefined;
+    getPointerNode(uri: string, pointer: string): JsonNode | undefined;
+    getTypeValues(): readonly string[];
+    getExtensionKeys(): readonly string[];
+    getUnitValues(): readonly string[];
+    references(): IterableIterator<DocumentReference>;
+    private collectValues;
+}
+//# sourceMappingURL=analysis-store.d.ts.map

package/dist/core/documents/analysis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-store.d.ts","sourceRoot":"","sources":["../../../src/core/documents/analysis-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,qBAAqB;;IAGhC,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,4BAA4B;IAe5D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI9C,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAIvD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,GAAG,IAAI;IAQxE,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI;IAQvE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI;IAQlE,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI7E,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIlE,aAAa,IAAI,SAAS,MAAM,EAAE;IAIlC,gBAAgB,IAAI,SAAS,MAAM,EAAE;IAIrC,aAAa,IAAI,SAAS,MAAM,EAAE;IAIjC,UAAU,IAAI,gBAAgB,CAAC,iBAAiB,CAAC;IAQlD,OAAO,CAAC,aAAa;CAStB"}

package/dist/core/documents/analysis-store.js

@@ -0,0 +1,83 @@
+import { analyzeTextDocument } from './analyzer.js';
+import { findPointerKeyAtPosition, findReferenceAtPosition, matchPointerInAnalysis } from './queries.js';
+export class DocumentAnalysisStore {
+    #analyses = new Map();
+    update(document) {
+        try {
+            const analysis = analyzeTextDocument(document);
+            if (analysis) {
+                this.#analyses.set(document.uri, analysis);
+            }
+            else {
+                this.#analyses.delete(document.uri);
+            }
+            return { ok: true };
+        }
+        catch (error) {
+            this.#analyses.delete(document.uri);
+            return { ok: false, error };
+        }
+    }
+    remove(uri) {
+        this.#analyses.delete(uri);
+    }
+    get(uri) {
+        return this.#analyses.get(uri);
+    }
+    entries() {
+        return this.#analyses.entries();
+    }
+    findReference(uri, position) {
+        const analysis = this.#analyses.get(uri);
+        if (!analysis) {
+            return null;
+        }
+        return findReferenceAtPosition(analysis.references, position);
+    }
+    findPointerKey(uri, position) {
+        const analysis = this.#analyses.get(uri);
+        if (!analysis) {
+            return null;
+        }
+        return findPointerKeyAtPosition(analysis.pointers, position);
+    }
+    matchPointer(uri, position) {
+        const analysis = this.#analyses.get(uri);
+        if (!analysis) {
+            return null;
+        }
+        return matchPointerInAnalysis(analysis, position);
+    }
+    getPointerMetadata(uri, pointer) {
+        return this.#analyses.get(uri)?.pointers.get(pointer);
+    }
+    getPointerNode(uri, pointer) {
+        return this.getPointerMetadata(uri, pointer)?.node;
+    }
+    getTypeValues() {
+        return this.collectValues((analysis) => analysis.typeValues);
+    }
+    getExtensionKeys() {
+        return this.collectValues((analysis) => analysis.extensionKeys);
+    }
+    getUnitValues() {
+        return this.collectValues((analysis) => analysis.unitValues);
+    }
+    *references() {
+        for (const analysis of this.#analyses.values()) {
+            for (const reference of analysis.references) {
+                yield reference;
+            }
+        }
+    }
+    collectValues(selector) {
+        const values = new Set();
+        for (const analysis of this.#analyses.values()) {
+            for (const value of selector(analysis)) {
+                values.add(value);
+            }
+        }
+        return Array.from(values).sort();
+    }
+}
+//# sourceMappingURL=analysis-store.js.map

package/dist/core/documents/analysis-store.js.map

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

package/dist/core/documents/analyzer.d.ts

@@ -0,0 +1,4 @@
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import type { DocumentAnalysis } from './types.js';
+export declare function analyzeTextDocument(document: TextDocument): DocumentAnalysis | null;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/core/documents/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/documents/analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAsC,MAAM,YAAY,CAAC;AAKvF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAwCnF"}

package/dist/core/documents/analyzer.js

@@ -0,0 +1,147 @@
+import { parseTree } from 'jsonc-parser';
+import { escapeJsonPointerSegment, pointerToPath } from '../../pointer-utils.js';
+import { rangeFromNode } from './ranges.js';
+const POINTER_REFERENCE_KEYS = new Set(['$ref', 'token', 'ref']);
+export function analyzeTextDocument(document) {
+    const text = document.getText();
+    const parseErrors = [];
+    const tree = parseTree(text, parseErrors, {
+        allowTrailingComma: false,
+        disallowComments: true
+    });
+    if (!tree || parseErrors.length > 0) {
+        return null;
+    }
+    const pointers = new Map();
+    const typeValues = new Set();
+    const extensionKeys = new Set();
+    const unitValues = new Set();
+    collectPointerMetadata(tree, '#', document, pointers, undefined, undefined, typeValues, extensionKeys, unitValues);
+    const references = [];
+    collectReferences(tree, document, document.uri, references);
+    return {
+        pointers,
+        references,
+        tree,
+        typeValues,
+        extensionKeys,
+        unitValues
+    };
+}
+function collectPointerMetadata(node, pointer, document, result, keyNode, parentPointer, typeValues, extensionKeys, unitValues) {
+    result.set(pointer, {
+        valueRange: rangeFromNode(node, document),
+        keyRange: keyNode ? rangeFromNode(keyNode, document) : undefined,
+        node
+    });
+    if (keyNode && typeof keyNode.value === 'string') {
+        if (keyNode.value === '$type' && typeof node.value === 'string') {
+            typeValues.add(node.value);
+        }
+        if (keyNode.value === 'unit' && typeof node.value === 'string') {
+            unitValues.add(node.value);
+        }
+        if (parentPointer) {
+            const parentPath = pointerToPath(parentPointer);
+            const parentKey = parentPath[parentPath.length - 1];
+            if (parentKey === '$extensions') {
+                extensionKeys.add(keyNode.value);
+            }
+        }
+    }
+    if (!node.children || node.children.length === 0) {
+        return;
+    }
+    if (node.type === 'object') {
+        for (const property of node.children) {
+            const nextKey = property.children?.[0];
+            const valueNode = property.children?.[1];
+            if (!nextKey || !valueNode || typeof nextKey.value !== 'string') {
+                continue;
+            }
+            const escaped = escapeJsonPointerSegment(nextKey.value);
+            const childPointer = pointer === '#' ? `#/${escaped}` : `${pointer}/${escaped}`;
+            collectPointerMetadata(valueNode, childPointer, document, result, nextKey, pointer, typeValues, extensionKeys, unitValues);
+        }
+        return;
+    }
+    if (node.type === 'array') {
+        node.children.forEach((child, index) => {
+            const segment = index.toString();
+            const childPointer = pointer === '#' ? `#/${segment}` : `${pointer}/${segment}`;
+            collectPointerMetadata(child, childPointer, document, result, undefined, pointer, typeValues, extensionKeys, unitValues);
+        });
+    }
+}
+function collectReferences(node, document, documentUri, references) {
+    if (!node.children || node.children.length === 0) {
+        return;
+    }
+    if (node.type === 'object') {
+        for (const property of node.children) {
+            const keyNode = property.children?.[0];
+            const valueNode = property.children?.[1];
+            if (!keyNode || !valueNode || typeof keyNode.value !== 'string') {
+                continue;
+            }
+            if (valueNode.type === 'string' && POINTER_REFERENCE_KEYS.has(keyNode.value)) {
+                const pointerCandidate = valueNode.value;
+                if (typeof pointerCandidate !== 'string') {
+                    continue;
+                }
+                const reference = resolvePointerTarget(pointerCandidate, documentUri);
+                if (reference) {
+                    references.push({
+                        documentUri,
+                        range: rangeFromNode(valueNode, document),
+                        targetUri: reference.uri,
+                        targetPointer: reference.pointer,
+                        rawValue: pointerCandidate
+                    });
+                }
+            }
+            collectReferences(valueNode, document, documentUri, references);
+        }
+        return;
+    }
+    if (node.type === 'array') {
+        for (const child of node.children) {
+            collectReferences(child, document, documentUri, references);
+        }
+    }
+}
+function resolvePointerTarget(value, baseUri) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = normalizePointerCandidate(value);
+    if (normalized) {
+        return { uri: baseUri, pointer: normalized };
+    }
+    try {
+        const parsed = new URL(value, baseUri);
+        if (!parsed.hash) {
+            return undefined;
+        }
+        return { uri: parsed.toString(), pointer: normalizePointerCandidate(parsed.hash) ?? '#' };
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizePointerCandidate(value) {
+    if (value === '#') {
+        return '#';
+    }
+    if (value.startsWith('#/')) {
+        return value;
+    }
+    if (value.startsWith('/')) {
+        return `#${value}`;
+    }
+    if (value.startsWith('#')) {
+        return value.length > 1 ? `#/${value.slice(1)}` : '#';
+    }
+    return undefined;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/core/documents/analyzer.js.map

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

package/dist/core/documents/queries.d.ts

@@ -0,0 +1,15 @@
+import type { Position } from 'vscode-languageserver/node.js';
+import type { DocumentAnalysis, DocumentReference, PointerMetadata } from './types.js';
+export declare function findReferenceAtPosition(references: readonly DocumentReference[], position: Position): DocumentReference | null;
+export interface PointerKeyMatch {
+    readonly pointer: string;
+    readonly metadata: PointerMetadata;
+}
+export declare function findPointerKeyAtPosition(pointers: ReadonlyMap<string, PointerMetadata>, position: Position): PointerKeyMatch | null;
+export interface PointerMatch {
+    readonly pointer: string;
+    readonly inKey: boolean;
+}
+export declare function matchPointerInAnalysis(analysis: DocumentAnalysis, position: Position): PointerMatch | null;
+export declare function referenceIntersectsPosition(reference: DocumentReference, position: Position): boolean;
+//# sourceMappingURL=queries.d.ts.map

package/dist/core/documents/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/core/documents/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGvF,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,QAAQ,EAAE,QAAQ,GACjB,iBAAiB,GAAG,IAAI,CAO1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,QAAQ,EAAE,QAAQ,GACjB,eAAe,GAAG,IAAI,CAOxB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,QAAQ,GACjB,YAAY,GAAG,IAAI,CAyBrB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAMT"}

package/dist/core/documents/queries.js

@@ -0,0 +1,52 @@
+import { pointerToPath } from '../../pointer-utils.js';
+import { equalsPosition, rangeContainsInclusive } from './ranges.js';
+export function findReferenceAtPosition(references, position) {
+    for (const reference of references) {
+        if (rangeContainsInclusive(reference.range, position)) {
+            return reference;
+        }
+    }
+    return null;
+}
+export function findPointerKeyAtPosition(pointers, position) {
+    for (const [pointer, metadata] of pointers) {
+        if (metadata.keyRange && rangeContainsInclusive(metadata.keyRange, position)) {
+            return { pointer, metadata };
+        }
+    }
+    return null;
+}
+export function matchPointerInAnalysis(analysis, position) {
+    let bestMatch = null;
+    for (const [pointer, metadata] of analysis.pointers) {
+        if (metadata.keyRange && rangeContainsInclusive(metadata.keyRange, position)) {
+            const depth = pointerDepth(pointer);
+            if (!bestMatch || depth >= bestMatch.depth) {
+                bestMatch = { pointer, inKey: true, depth };
+            }
+            continue;
+        }
+        if (rangeContainsInclusive(metadata.valueRange, position)) {
+            const depth = pointerDepth(pointer);
+            if (!bestMatch || depth >= bestMatch.depth) {
+                bestMatch = { pointer, inKey: false, depth };
+            }
+        }
+    }
+    if (!bestMatch) {
+        return null;
+    }
+    return { pointer: bestMatch.pointer, inKey: bestMatch.inKey };
+}
+export function referenceIntersectsPosition(reference, position) {
+    return (rangeContainsInclusive(reference.range, position) ||
+        equalsPosition(reference.range.end, position) ||
+        equalsPosition(reference.range.start, position));
+}
+function pointerDepth(pointer) {
+    if (pointer === '#') {
+        return 0;
+    }
+    return pointerToPath(pointer).length;
+}
+//# sourceMappingURL=queries.js.map

package/dist/core/documents/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/core/documents/queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,UAAU,uBAAuB,CACrC,UAAwC,EACxC,QAAkB;IAElB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,sBAAsB,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,MAAM,UAAU,wBAAwB,CACtC,QAA8C,EAC9C,QAAkB;IAElB,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC3C,IAAI,QAAQ,CAAC,QAAQ,IAAI,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAA4B,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,MAAM,UAAU,sBAAsB,CACpC,QAA0B,EAC1B,QAAkB;IAElB,IAAI,SAAS,GAA8D,IAAI,CAAC;IAEhF,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpD,IAAI,QAAQ,CAAC,QAAQ,IAAI,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7E,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,SAAS,IAAI,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC3C,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9C,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,sBAAsB,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,SAAS,IAAI,KAAK,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC3C,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAyB,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,SAA4B,EAC5B,QAAkB;IAElB,OAAO,CACL,sBAAsB,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC;QACjD,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC7C,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC"}

package/dist/core/documents/ranges.d.ts

@@ -0,0 +1,9 @@
+import type { Node as JsonNode } from 'jsonc-parser';
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import type { Position, Range } from 'vscode-languageserver/node.js';
+export declare function rangeFromNode(node: JsonNode, document: TextDocument): Range;
+export declare function rangeFromOffset(document: TextDocument, offset: number, length: number): Range;
+export declare function rangeContainsInclusive(range: Range, position: Position): boolean;
+export declare function isBefore(a: Position, b: Position): boolean;
+export declare function equalsPosition(a: Position, b: Position): boolean;
+//# sourceMappingURL=ranges.d.ts.map

package/dist/core/documents/ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.d.ts","sourceRoot":"","sources":["../../../src/core/documents/ranges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAErE,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAG,KAAK,CAI3E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAI7F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAUhF;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAU1D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAEhE"}