@speclynx/apidom-parser-adapter-json 1.12.1 → 2.0.1

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 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-parser-adapter-json
+
+# [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
+
+- add support for strict mode in JSON/YAML parser adapters ([#22](https://github.com/speclynx/apidom/issues/22)) ([a9c5f11](https://github.com/speclynx/apidom/commit/a9c5f11e8748135e7ba578b61d2f1807e11d34aa))
+- apply innovations learned during last 3 years ([#11](https://github.com/speclynx/apidom/issues/11)) ([cfdbbfc](https://github.com/speclynx/apidom/commit/cfdbbfc2721b0dadc77eeba31dd4e8768c078d22))
+
+### BREAKING CHANGES
+
+- source maps have been completely rewritten
+- 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-parser-adapter-json
+
 ## [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-parser-adapter-json

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

@@ -29,31 +29,12 @@ Syntactic Analysis will take a stream of tokens and turn it into an ApiDOM repre
 [CST](https://tree-sitter.github.io/tree-sitter/using-parsers#syntax-nodes) produced by lexical analysis is [syntactically analyzed](https://github.com/speclynx/apidom/blob/main/packages/apidom-parser-adapter-json/src/syntactic-analysis)
 and ApiDOM structure using [base ApiDOM namespace](https://github.com/speclynx/apidom/tree/main/packages/apidom#base-namespace) is produced.
 
-#### [Direct Syntactical analysis](https://github.com/speclynx/apidom/blob/main/packages/apidom-parser-adapter-json/src/syntactic-analysis/direct)
-
-This analysis directly turns tree-sitter CST into ApiDOM. Single traversal is required which makes
-it super performant, and it's the default analysis used.
+This analysis directly turns tree-sitter CST into ApiDOM in a single traversal pass, making it highly performant.
 
 ```js
 import { parse } from '@speclynx/apidom-parser-adapter-json';
 
-const parseResult = await parse('{"prop": "value"}', {
-  syntacticAnalysis: 'direct',
-});
-```
-
-#### [Indirect Syntactic analysis]((https://github.com/speclynx/apidom/blob/main/packages/apidom-parser-adapter-json/src/syntactic-analysis/indirect))
-
-This analysis turns trees-sitter CST into [JSON AST](https://github.com/speclynx/apidom/tree/main/packages/apidom-ast#json-ast-nodes) representation.
-Then JSON AST is turned into ApiDOM. Two traversals are required, which makes indirect analysis less performant than direct one.
-Thought less performant, having JSON AST representation allows us to do further complex analysis.
-
-```js
-import { parse } from '@speclynx/apidom-parser-adapter-json';
-
-const parseResult = await parse('{"prop": "value"}', {
-  syntacticAnalysis: 'indirect',
-});
+const parseResult = await parse('{"prop": "value"}');
 ```
 
 ## Parser adapter API
@@ -71,7 +52,14 @@ Defines list of media types that this parser adapter recognizes.
 
 ### detect
 
-[Detection](https://github.com/speclynx/apidom/blob/main/packages/apidom-parser-adapter-json/src/adapter.ts#L3) is based on using [JSON.parse](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse) to indicate whether the provided source string is or isn't JSON string.
+Detection indicates whether the provided source string is valid JSON.
+
+Option | Type | Default | Description
+--- | --- | --- | ---
+<a name="detect-strict"></a>`strict` | `Boolean` | `false` | Use strict detection mode (native `JSON.parse`).
+
+In default mode, detection uses tree-sitter for parsing with error recovery.
+In strict mode, detection uses native `JSON.parse` which is faster but requires valid JSON.
 
 ### namespace
 
@@ -84,10 +72,26 @@ This adapter exposes an instance of [base ApiDOM namespace](https://github.com/s
 Option | Type | Default | Description
 --- | --- | --- | ---
 <a name="sourceMap"></a>`sourceMap` | `Boolean` | `false` | Indicate whether to generate source maps.
-<a name="syntacticAnalysis"></a>`syntacticAnalysis` | `String` | `direct` | Indicate type of syntactic analysis
+<a name="strict"></a>`strict` | `Boolean` | `false` | Use strict parsing mode (native `JSON.parse`). When `true`, parsing is faster but throws on invalid JSON and doesn't support source maps.
 
 All unrecognized arbitrary options will be ignored.
 
+#### Parsing modes
+
+This adapter supports two parsing modes:
+
+**Tree-sitter mode** (default, `strict: false`):
+- Uses [web-tree-sitter](https://www.npmjs.com/package/web-tree-sitter) for parsing
+- Provides error recovery for malformed JSON
+- Supports source map generation
+- Slightly slower but more resilient
+
+**Strict mode** (`strict: true`):
+- Uses native `JSON.parse` for parsing
+- Faster performance
+- Throws `SyntaxError` on invalid JSON
+- Does not support source maps (throws error if both `strict` and `sourceMap` are `true`)
+
 ## Usage
 
 This parser adapter can be used directly or indirectly via [@speclynx/apidom-parser](https://github.com/speclynx/apidom/tree/main/packages/apidom-parser).
@@ -100,12 +104,19 @@ with [supported media types](#mediatypes).
 ```js
 import { parse, detect } from '@speclynx/apidom-parser-adapter-json';
 
-// detecting
+// detecting (tree-sitter mode - default)
 await detect('{"prop": "value"}'); // => true
 await detect('test'); // => false
 
-// parsing
+// detecting (strict mode)
+await detect('{"prop": "value"}', { strict: true }); // => true
+await detect('{invalid}', { strict: true }); // => false
+
+// parsing (tree-sitter mode - default, with source maps)
 const parseResult = await parse('{"prop": "value"}', { sourceMap: true });
+
+// parsing (strict mode - faster, no source maps)
+const parseResultStrict = await parse('{"prop": "value"}', { strict: true });
 ```
 
 ### Indirect usage

package/dist/167.apidom-parser-adapter-json.browser.min.js

@@ -1 +1 @@
-(self.webpackChunkapidomParserAdapterJson=self.webpackChunkapidomParserAdapterJson||[]).push([[167],{9167:()=>{}}]);
+(self.webpackChunkapidomParserAdapterJson=self.webpackChunkapidomParserAdapterJson||[]).push([[167],{167:()=>{}}]);

package/dist/451.apidom-parser-adapter-json.browser.min.js

@@ -1 +1 @@
-(self.webpackChunkapidomParserAdapterJson=self.webpackChunkapidomParserAdapterJson||[]).push([[451],{9451:()=>{}}]);
+(self.webpackChunkapidomParserAdapterJson=self.webpackChunkapidomParserAdapterJson||[]).push([[451],{451:()=>{}}]);