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

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+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`.

package/lib/esm/jsonLanguageTypes.d.ts

@@ -3,6 +3,14 @@ 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>;
+}