@speclynx/apidom-ns-json-schema-2020-12 1.12.1 → 2.0.1

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.0.1](https://github.com/speclynx/apidom/compare/v2.0.0...v2.0.1) (2026-01-14)
+
+**Note:** Version bump only for package @speclynx/apidom-ns-json-schema-2020-12
+
+# [2.0.0](https://github.com/speclynx/apidom/compare/v1.12.2...v2.0.0) (2026-01-14)
+
+### Bug Fixes
+
+- limit source maps memory consuption ([#20](https://github.com/speclynx/apidom/issues/20)) ([4a0574f](https://github.com/speclynx/apidom/commit/4a0574fd6d466be7c33c8a5871baacd384918d22))
+
+### Features
+
+- apply innovations learned during last 3 years ([#11](https://github.com/speclynx/apidom/issues/11)) ([cfdbbfc](https://github.com/speclynx/apidom/commit/cfdbbfc2721b0dadc77eeba31dd4e8768c078d22))
+- **traverse:** move traverse operations to apidom-traverse package ([#18](https://github.com/speclynx/apidom/issues/18)) ([36c9d49](https://github.com/speclynx/apidom/commit/36c9d490ceac2ea961e2b23fbbc72df7fb54bbf3))
+
+### BREAKING CHANGES
+
+- source maps have been completely rewritten
+- **traverse:** move traverse operations from core to traverse package
+- breaking changes introduced to every package public API
+
+## [1.12.2](https://github.com/speclynx/apidom/compare/v1.12.1...v1.12.2) (2025-12-23)
+
+**Note:** Version bump only for package @speclynx/apidom-ns-json-schema-2020-12
+
 ## [1.12.1](https://github.com/speclynx/apidom/compare/v1.12.0...v1.12.1) (2025-12-23)
 
 **Note:** Version bump only for package @speclynx/apidom-ns-json-schema-2020-12

package/NOTICE

@@ -5,11 +5,6 @@ This distribution includes modifications by SpecLynx.
 All such modifications are licensed under the Apache License, Version 2.0.
 A copy of the Apache 2.0 license can be found in `LICENSES/Apache-2.0.txt`.
 
-ApiDOM
-Copyright 2020 SmartBear Software Inc.
-ApiDOM is licensed under Apache 2.0 license.
-Copy of the Apache 2.0 license can be found in `LICENSES/Apache-2.0.txt` file.
-
 json-schema-ref-parser
 Copyright (c) 2015 James Messinger
 File packages/apidom-reference/src/util/url.ts (the file) was originally created under MIT license in https://github.com/APIDevTools/json-schema-ref-parser repository.
@@ -18,8 +13,8 @@ Copy of the MIT license can be found in `LICENSES/MIT.txt` file.
 
 graphql-js
 Copyright (c) GraphQL Contributors
-File packages/apidom-ast/src/traversal/visitor.ts (the file) was originally created under MIT license in https://github.com/graphql/graphql-js repository.
-The file has been copied into this project and modified. All modifications are licensed under Apache 2.0 License.
+File packages/apidom-traverse/src/traversal.ts (the file) was originally inspired by https://github.com/graphql/graphql-js repository.
+All modifications are licensed under Apache 2.0 License.
 Copy of the MIT license can be found in `LICENSES/MIT.txt` file.
 
 babel-plugin-add-import-extension
@@ -54,6 +49,20 @@ Copyright (c) 2012 James Halliday, Josh Duff, and other contributors
 Copy of the MIT license can be found in `LICENSES/MIT.txt` file.
 All modifications are licensed under Apache 2.0 License.
 
+ApiDOM
+Copyright 2020 SmartBear Software Inc.
+ApiDOM is licensed under Apache 2.0 license.
+Copy of the Apache 2.0 license can be found in `LICENSES/Apache-2.0.txt` file.
+
+minim
+Copyright (c) 2014 Stephen Mizell
+The apidom-datamodel package contains code originally created under the MIT
+License as part of the Minim project (https://github.com/refractproject/minim).
+This code has been copied into this project and modified.
+The original portions remain licensed under the MIT License. Our modifications
+to that code are licensed under the Apache License 2.0.
+Copy of the MIT license can be found in `LICENSES/MIT.txt` file.
+
 ---
 
 If the SPDX-FileCopyrightText and SPDX-License-Identifier tags are not present in the file,

package/README.md

@@ -13,20 +13,20 @@ You can install this package via [npm CLI](https://docs.npmjs.com/cli) by runnin
 ## JSON Schema 2020-12 namespace
 
 JSON Schema 2020-12 namespace consists of [number of elements](https://github.com/speclynx/apidom/tree/main/packages/apidom-ns-json-schema-2020-12/src/elements) implemented on top
-of [primitive ones](https://github.com/refractproject/minim/tree/master/lib/primitives).
+of [primitive ones](https://github.com/speclynx/apidom/tree/main/packages/apidom-datamodel/src/primitives).
 
 ```js
-import { createNamespace } from '@speclynx/apidom-core';
-import jsonShema202012Namespace from '@speclynx/apidom-ns-json-schema-2020-12';
+import { Namespace } from '@speclynx/apidom-datamodel';
+import jsonSchema202012Namespace from '@speclynx/apidom-ns-json-schema-2020-12';
 
-const namespace = createNamespace(jsonShema202012Namespace);
+const namespace = new Namespace().use(jsonSchema202012Namespace);
 
 const objectElement = new namespace.elements.Object();
 const jsonSchemaElement = new namespace.elements.JSONSchema202012();
 ```
 
 When namespace instance is created in this way, it will extend the base namespace
-with the namespace provided as an argument.
+with the namespace plugin provided as an argument.
 
 Elements from the namespace can also be used directly by importing them.
 
@@ -52,23 +52,22 @@ isJSONSchemaElement(jsonSchemaElement); // => true
 
 ## Traversal
 
-Traversing ApiDOM in this namespace is possible by using `visit` function from `apidom` package.
-This package comes with its own [keyMap](https://github.com/speclynx/apidom/blob/main/packages/apidom-ns-json-schema-2020-12/src/traversal/visitor.ts#L11) and [nodeTypeGetter](https://github.com/speclynx/apidom/blob/main/packages/apidom-ns-json-schema-2020-12/src/traversal/visitor.ts#L4).
-To learn more about these `visit` configuration options please refer to [@speclynx/apidom-ast documentation](https://github.com/speclynx/apidom/blob/main/packages/apidom-ast/README.md#visit).
+Traversing ApiDOM in this namespace is possible by using `traverse` function from `@speclynx/apidom-traverse` package.
+To learn more about the `traverse` function, please refer to [@speclynx/apidom-traverse documentation](https://github.com/speclynx/apidom/blob/main/packages/apidom-traverse/README.md).
 
 ```js
-import { visit } from '@speclynx/apidom-core';
-import { JSONSchemaElement, keyMap, getNodeType } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { traverse } from '@speclynx/apidom-traverse';
+import { JSONSchemaElement } from '@speclynx/apidom-ns-json-schema-2020-12';
 
 const element = new JSONSchemaElement();
 
 const visitor = {
-  JSONSchema202012Element(jsonSchemaElement) {
-    console.dir(jsonSchemaElement);
+  JSONSchema202012Element(path) {
+    console.dir(path.node);
   },
 };
 
-visit(element, visitor, { keyMap, nodeTypeGetter: getNodeType });
+traverse(element, visitor);
 ```
 
 ## Refractors
@@ -79,37 +78,37 @@ or generic ApiDOM structures into structures built from elements of this namespa
 **Refracting JavaScript structures**:
 
 ```js
-import { LinkDescriptionElement } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { refractLinkDescription } from '@speclynx/apidom-ns-json-schema-2020-12';
 
 const object = {
   anchor: 'nodes/{thisNodeId}',
   anchorPointer: '#/relative/json/pointer',
 };
 
-LinkDescriptionElement.refract(object); // => LinkDescriptionElement({ anchor, anchorPointer })
+refractLinkDescription(object); // => LinkDescriptionElement({ anchor, anchorPointer })
 ```
 
 **Refracting generic ApiDOM structures**:
 
 ```js
-import { ObjectElement } from '@speclynx/apidom-core';
-import { LinkDescriptionElement } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { ObjectElement } from '@speclynx/apidom-datamodel';
+import { refractLinkDescription } from '@speclynx/apidom-ns-json-schema-2020-12';
 
 const objectElement = new ObjectElement({
   anchor: 'nodes/{thisNodeId}',
   anchorPointer: '#/relative/json/pointer',
 });
 
-LinkDescriptionElement.refract(objectElement); // => LinkDescriptionElement({ anchor = 'nodes/{thisNodeId}', anchorPointer = '#/relative/json/pointer' })
+refractLinkDescription(objectElement); // => LinkDescriptionElement({ anchor = 'nodes/{thisNodeId}', anchorPointer = '#/relative/json/pointer' })
 ```
 
 ### Refractor plugins
 
-Refractors can accept plugins as a second argument of refract static method.
+Refractors can accept plugins as a second argument of the refract function.
 
 ```js
-import { ObjectElement } from '@speclynx/apidom-core';
-import { LinkDescriptionElement } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { ObjectElement } from '@speclynx/apidom-datamodel';
+import { refractLinkDescription } from '@speclynx/apidom-ns-json-schema-2020-12';
 
 const objectElement = new ObjectElement({
   anchor: 'nodes/{thisNodeId}',
@@ -122,8 +121,8 @@ const plugin = ({ predicates, namespace }) => ({
       console.dir('runs before traversal');
   },
   visitor: {
-    LinkDescriptionElement(linkDescriptionElement) {
-      linkDescriptionElement.anchorPointer = '#/relative/json/pointer/x';
+    LinkDescriptionElement(path) {
+      path.node.anchorPointer = '#/relative/json/pointer/x';
     },
   },
   post() {
@@ -131,7 +130,7 @@ const plugin = ({ predicates, namespace }) => ({
   },
 });
 
-LinkDescriptionElement.refract(objectElement, { plugins: [plugin] }); // => LinkDescriptionElement({ anchor = 'nodes/{thisNodeId}', anchorPointer = '#/relative/json/pointer/x' })
+refractLinkDescription(objectElement, { plugins: [plugin] }); // => LinkDescriptionElement({ anchor = 'nodes/{thisNodeId}', anchorPointer = '#/relative/json/pointer/x' })
 ```
 
 You can define as many plugins as needed to enhance the resulting namespaced ApiDOM structure.
@@ -145,14 +144,14 @@ this missing value with the most appropriate semantic element type.
 
 ```js
 import { parse } from '@speclynx/apidom-parser-adapter-yaml-1-2';
-import { refractorPluginReplaceEmptyElement, JSONSchemaElement } from '@speclynx/apidom-ns-json-schema-2020-12';
+import { refractorPluginReplaceEmptyElement, refractJSONSchema } from '@speclynx/apidom-ns-json-schema-2020-12';
 
 const yamlDefinition = `
 $schema: 'https://json-schema.org/draft/2020-12/schema'
 if:
 `;
 const apiDOM = await parse(yamlDefinition);
-const jsonSchemaElement = JSONSchemaElement.refract(apiDOM.result, {
+const jsonSchemaElement = refractJSONSchema(apiDOM.result, {
   plugins: [refractorPluginReplaceEmptyElement()],
 });
 
@@ -183,4 +182,3 @@ Only fully implemented specification objects should be checked here.
 - [x] [Link Description Object](https://json-schema.org/draft/2019-09/draft-handrews-json-schema-hyperschema-02#rfc.section.6)
 
 
-