vscode-json-languageservice 5.7.2 → 6.0.0-next.2

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+6.0.0-next.2 / 2026-07-11
+================
+- Support $dynamicRef / $dynamicAnchor (JSON Schema 2020-12)
+- Support JSON Schema 2019-09
+
+6.0.0-next.1 / 2026-03-04
+================
+* Breaking: the package is now ESM-only (`"type": "module"`) and exposes ESM entry points through `exports`.
+* Breaking: CommonJS/UMD output is no longer produced. Build, test and sample scripts now target `lib/esm`.
+* Updated TypeScript configuration to `NodeNext` module settings for Node ESM compatibility.
+* Removed `tsconfig.esm.json` as a separate build target (the main tsconfig now covers ESM output).
+* Converted build scripts in `build/` to ESM and added `npm run bundle-schemas`.
+
 5.7.0 / 2026-01-12
 ================
 * the error code for `SchemaResolveError` is now 0x10000 plus the error code returned by the request service.

package/lib/esm/jsonContributions.d.ts

@@ -1,4 +1,4 @@
-import { MarkedString, CompletionItem } from './jsonLanguageService';
+import { MarkedString, CompletionItem } from './jsonLanguageService.js';
 export interface JSONWorkerContribution {
     getInfoContribution(uri: string, location: JSONPath): PromiseLike<MarkedString[]>;
     collectPropertyCompletions(uri: string, location: JSONPath, currentWord: string, addValue: boolean, isLast: boolean, result: CompletionsCollector): PromiseLike<any>;

package/lib/esm/jsonLanguageService.d.ts

@@ -1,10 +1,10 @@
-import { ASTNode, Color, ColorInformation, ColorPresentation, LanguageServiceParams, LanguageSettings, DocumentLanguageSettings, FoldingRange, JSONSchema, SelectionRange, FoldingRangesContext, DocumentSymbolsContext, ColorInformationContext as DocumentColorsContext, TextDocument, Position, CompletionItem, CompletionList, Hover, Range, SymbolInformation, Diagnostic, TextEdit, FormattingOptions, DocumentSymbol, DefinitionLink, MatchingSchema, JSONLanguageStatus, SortOptions } from './jsonLanguageTypes';
+import { ASTNode, Color, ColorInformation, ColorPresentation, LanguageServiceParams, LanguageSettings, DocumentLanguageSettings, FoldingRange, JSONSchema, SelectionRange, FoldingRangesContext, DocumentSymbolsContext, ColorInformationContext as DocumentColorsContext, TextDocument, Position, CompletionItem, CompletionList, Hover, Range, SymbolInformation, Diagnostic, TextEdit, FormattingOptions, DocumentSymbol, DefinitionLink, MatchingSchema, JSONLanguageStatus, SortOptions } from './jsonLanguageTypes.js';
 import { DocumentLink } from 'vscode-languageserver-types';
 export type JSONDocument = {
     root: ASTNode | undefined;
     getNodeFromOffset(offset: number, includeRightBound?: boolean): ASTNode | undefined;
 };
-export * from './jsonLanguageTypes';
+export * from './jsonLanguageTypes.js';
 export interface LanguageService {
     configure(settings: LanguageSettings): void;
     doValidation(document: TextDocument, jsonDocument: JSONDocument, documentSettings?: DocumentLanguageSettings, schema?: JSONSchema): PromiseLike<Diagnostic[]>;

package/lib/esm/jsonLanguageService.js

@@ -2,19 +2,19 @@
  *  Copyright (c) Microsoft Corporation. All rights reserved.
  *  Licensed under the MIT License. See License.txt in the project root for license information.
  *--------------------------------------------------------------------------------------------*/
-import { JSONCompletion } from './services/jsonCompletion';
-import { JSONHover } from './services/jsonHover';
-import { JSONValidation } from './services/jsonValidation';
-import { JSONDocumentSymbols } from './services/jsonDocumentSymbols';
-import { parse as parseJSON, newJSONDocument } from './parser/jsonParser';
-import { schemaContributions } from './services/configuration';
-import { JSONSchemaService } from './services/jsonSchemaService';
-import { getFoldingRanges } from './services/jsonFolding';
-import { getSelectionRanges } from './services/jsonSelectionRanges';
-import { sort } from './utils/sort';
-import { format } from './utils/format';
-import { findLinks } from './services/jsonLinks';
-export * from './jsonLanguageTypes';
+import { JSONCompletion } from './services/jsonCompletion.js';
+import { JSONHover } from './services/jsonHover.js';
+import { JSONValidation } from './services/jsonValidation.js';
+import { JSONDocumentSymbols } from './services/jsonDocumentSymbols.js';
+import { parse as parseJSON, newJSONDocument } from './parser/jsonParser.js';
+import { schemaContributions } from './services/configuration.js';
+import { JSONSchemaService } from './services/jsonSchemaService.js';
+import { getFoldingRanges } from './services/jsonFolding.js';
+import { getSelectionRanges } from './services/jsonSelectionRanges.js';
+import { sort } from './utils/sort.js';
+import { format } from './utils/format.js';
+import { findLinks } from './services/jsonLinks.js';
+export * from './jsonLanguageTypes.js';
 export function getLanguageService(params) {
     const promise = params.promiseConstructor || Promise;
     const jsonSchemaService = new JSONSchemaService(params.schemaRequestService, params.workspaceContext, promise);

package/lib/esm/jsonLanguageTypes.d.ts

@@ -1,8 +1,16 @@
-import { JSONWorkerContribution, JSONPath, Segment, CompletionsCollector } from './jsonContributions';
-import { JSONSchema } from './jsonSchema';
+import { JSONWorkerContribution, JSONPath, Segment, CompletionsCollector } from './jsonContributions.js';
+import { JSONSchema } from './jsonSchema.js';
 import { Range, Position, DocumentUri, MarkupContent, MarkupKind, Color, ColorInformation, ColorPresentation, FoldingRange, FoldingRangeKind, SelectionRange, Diagnostic, DiagnosticSeverity, CompletionItem, CompletionItemKind, CompletionList, CompletionItemTag, InsertTextFormat, SymbolInformation, SymbolKind, DocumentSymbol, Location, Hover, MarkedString, FormattingOptions as LSPFormattingOptions, DefinitionLink, CodeActionContext, Command, CodeAction, DocumentHighlight, DocumentLink, WorkspaceEdit, TextEdit, CodeActionKind, TextDocumentEdit, VersionedTextDocumentIdentifier, DocumentHighlightKind } from 'vscode-languageserver-types';
 import { TextDocument, TextDocumentContentChangeEvent } from 'vscode-languageserver-textdocument';
 export { TextDocument, TextDocumentContentChangeEvent, Range, Position, DocumentUri, MarkupContent, MarkupKind, JSONSchema, JSONWorkerContribution, JSONPath, Segment, CompletionsCollector, Color, ColorInformation, ColorPresentation, FoldingRange, FoldingRangeKind, SelectionRange, Diagnostic, DiagnosticSeverity, CompletionItem, CompletionItemKind, CompletionList, CompletionItemTag, InsertTextFormat, DefinitionLink, SymbolInformation, SymbolKind, DocumentSymbol, Location, Hover, MarkedString, CodeActionContext, Command, CodeAction, DocumentHighlight, DocumentLink, WorkspaceEdit, TextEdit, CodeActionKind, TextDocumentEdit, VersionedTextDocumentIdentifier, DocumentHighlightKind };
+/**
+ * Represents active JSON Schema vocabularies with their required/optional status.
+ * Key = vocabulary URI, Value = true if required, false if optional.
+ * Both required and optional vocabularies are active; the boolean indicates
+ * whether the validator must understand it (true) or should understand it (false).
+ * @since 2019-09
+ */
+export type Vocabularies = Map<string, boolean>;
 /**
  * Error codes used by diagnostics
  */

package/lib/esm/jsonSchema.d.ts

@@ -61,8 +61,10 @@ export interface JSONSchema {
     };
     $anchor?: string;
     $recursiveRef?: string;
-    $recursiveAnchor?: string;
-    $vocabulary?: any;
+    $recursiveAnchor?: boolean;
+    $vocabulary?: {
+        [uri: string]: boolean;
+    };
     prefixItems?: JSONSchemaRef[];
     $dynamicRef?: string;
     $dynamicAnchor?: string;
@@ -90,3 +92,70 @@ export interface JSONSchema {
 export interface JSONSchemaMap {
     [name: string]: JSONSchemaRef;
 }
+/**
+ * Internal extension of {@link JSONSchema} used when one schema is merged into
+ * another (e.g. when resolving `$ref`). The `$originalId` field preserves the
+ * `$id`/`id` of the referenced schema so features like `$recursiveRef` can
+ * still identify schema resource roots after the merge.
+ *
+ * `$originalId` is set as a non-enumerable property to keep it out of
+ * `for..in` iteration and JSON serialization.
+ */
+export interface MergedJSONSchema extends JSONSchema {
+    $originalId?: string;
+    /**
+     * Non-enumerable metadata attached to a `$dynamicRef` node while resolving it.
+     * Held off the enumerable keywords so it stays invisible to schema traversal,
+     * merging and consumers, but available to the validator.
+     */
+    $dynamicRefInfo?: DynamicRefInfo;
+    /**
+     * Non-enumerable per-resource anchor maps, attached to resource-root schemas
+     * (a node with its own `$id`, or the document root) for 2020-12 `$dynamicRef`
+     * resolution.
+     */
+    $anchorMaps?: AnchorMaps;
+}
+/**
+ * Internal, non-enumerable metadata recorded for a single `$dynamicRef` occurrence.
+ */
+export interface DynamicRefInfo {
+    /**
+     * The statically resolved initial target (resolved like a plain `$ref`, against
+     * the reference's own base URI).
+     */
+    target?: JSONSchema;
+    /**
+     * The plain-name fragment of the `$dynamicRef` (set whenever the fragment is a
+     * plain name rather than a JSON pointer). The validator uses it, together with
+     * the initial target, to decide at validation time whether the 2020-12
+     * "bookending" requirement holds (i.e. the initial target is a `$dynamicAnchor`
+     * of that name) and therefore whether to perform dynamic-scope resolution
+     * instead of behaving like a plain `$ref`.
+     */
+    name?: string;
+    /**
+     * The schema resource (nearest enclosing `$id` scope) that lexically contains
+     * the `$dynamicRef`. Recorded before `$ref` merging flattens resource
+     * boundaries so an internal `#name` reference resolves against its own
+     * resource's anchors, not a sibling's.
+     */
+    scope?: MergedJSONSchema;
+}
+/**
+ * Internal, non-enumerable per-resource anchor maps used for 2020-12 `$dynamicRef`
+ * resolution. Attached to resource-root schemas.
+ */
+export interface AnchorMaps {
+    /**
+     * `$dynamicAnchor` names → sub-schemas within the resource, used by the
+     * validator to walk the dynamic scope (outermost resource first).
+     */
+    dynamic: Map<string, JSONSchema>;
+    /**
+     * Both `$anchor` and `$dynamicAnchor` names → sub-schemas within the resource,
+     * used to resolve an internal `$dynamicRef`'s initial target within its own
+     * resource.
+     */
+    local: Map<string, JSONSchema>;
+}