@speclynx/apidom-parser-adapter-json 4.0.1 → 4.0.3

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [4.0.3](https://github.com/speclynx/apidom/compare/v4.0.2...v4.0.3) (2026-03-11)
+
+### Bug Fixes
+
+- **release:** fix v4.0.2 failed release ([b4dc1c4](https://github.com/speclynx/apidom/commit/b4dc1c48e8d9b2986a70e49b5554eb0a166d7528))
+
+## [4.0.2](https://github.com/speclynx/apidom/compare/v4.0.1...v4.0.2) (2026-03-11)
+
+**Note:** Version bump only for package @speclynx/apidom-parser-adapter-json
+
 ## [4.0.1](https://github.com/speclynx/apidom/compare/v4.0.0...v4.0.1) (2026-03-11)
 
 **Note:** Version bump only for package @speclynx/apidom-parser-adapter-json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-parser-adapter-json",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "Parser adapter for parsing JSON documents into base namespace.",
   "keywords": [
     "apidom",
@@ -58,9 +58,9 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "4.0.1",
-    "@speclynx/apidom-datamodel": "4.0.1",
-    "@speclynx/apidom-error": "4.0.1",
+    "@speclynx/apidom-core": "4.0.3",
+    "@speclynx/apidom-datamodel": "4.0.3",
+    "@speclynx/apidom-error": "4.0.3",
     "web-tree-sitter": "=0.26.6"
   },
   "devDependencies": {
@@ -68,8 +68,7 @@
     "tree-sitter-json": "=0.24.8"
   },
   "files": [
-    "src/**/*.mjs",
-    "src/**/*.cjs",
+    "src/",
     "dist/",
     "types/apidom-parser-adapter-json.d.ts",
     "LICENSES",
@@ -77,5 +76,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "223132a9b00081ca04842efc2736a491f7876f44"
+  "gitHead": "6ccfa09c02232516215e7de3ead276641957e626"
 }

package/src/adapter.cjs

@@ -0,0 +1,71 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+exports.__esModule = true;
+exports.syntacticAnalysis = exports.parse = exports.namespace = exports.mediaTypes = exports.lexicalAnalysis = exports.detectionRegExp = exports.detect = void 0;
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomError = require("@speclynx/apidom-error");
+var native = _interopRequireWildcard(require("./native/index.cjs"));
+var treeSitter = _interopRequireWildcard(require("./tree-sitter/index.cjs"));
+exports.lexicalAnalysis = treeSitter.lexicalAnalysis;
+exports.syntacticAnalysis = treeSitter.syntacticAnalysis;
+var _mediaTypes = _interopRequireDefault(require("./media-types.cjs"));
+exports.mediaTypes = _mediaTypes.default;
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const namespace = exports.namespace = new _apidomDatamodel.Namespace();
+
+/**
+ * @public
+ */
+const detectionRegExp = exports.detectionRegExp = treeSitter.detectionRegExp;
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const detect = async (source, {
+  strict = false
+} = {}) => {
+  if (strict) {
+    return native.detect(source);
+  }
+  return treeSitter.detect(source);
+};
+
+/**
+ * @public
+ */
+exports.detect = detect;
+/**
+ * @public
+ */
+const parse = async (source, {
+  sourceMap = false,
+  style = false,
+  strict = false
+} = {}) => {
+  if (strict && sourceMap) {
+    throw new _apidomError.UnsupportedOperationError('Cannot use sourceMap with strict parsing. Strict parsing does not support source maps.');
+  }
+  if (strict && style) {
+    throw new _apidomError.UnsupportedOperationError('Cannot use style with strict parsing. Strict parsing does not support style preservation.');
+  }
+  if (strict) {
+    return native.parse(source);
+  }
+  return treeSitter.parse(source, {
+    sourceMap,
+    style
+  });
+};
+exports.parse = parse;

package/src/adapter.mjs

@@ -0,0 +1,61 @@
+import { Namespace } from '@speclynx/apidom-datamodel';
+import { UnsupportedOperationError } from '@speclynx/apidom-error';
+import * as native from "./native/index.mjs";
+import * as treeSitter from "./tree-sitter/index.mjs";
+export { lexicalAnalysis, syntacticAnalysis } from "./tree-sitter/index.mjs";
+/**
+ * @public
+ */
+export { default as mediaTypes } from "./media-types.mjs";
+/**
+ * @public
+ */
+export const namespace = new Namespace();
+
+/**
+ * @public
+ */
+export const detectionRegExp = treeSitter.detectionRegExp;
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+export const detect = async (source, {
+  strict = false
+} = {}) => {
+  if (strict) {
+    return native.detect(source);
+  }
+  return treeSitter.detect(source);
+};
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+export const parse = async (source, {
+  sourceMap = false,
+  style = false,
+  strict = false
+} = {}) => {
+  if (strict && sourceMap) {
+    throw new UnsupportedOperationError('Cannot use sourceMap with strict parsing. Strict parsing does not support source maps.');
+  }
+  if (strict && style) {
+    throw new UnsupportedOperationError('Cannot use style with strict parsing. Strict parsing does not support style preservation.');
+  }
+  if (strict) {
+    return native.parse(source);
+  }
+  return treeSitter.parse(source, {
+    sourceMap,
+    style
+  });
+};

package/src/adapter.ts

@@ -0,0 +1,80 @@
+import { ParseResultElement, Namespace } from '@speclynx/apidom-datamodel';
+import { UnsupportedOperationError } from '@speclynx/apidom-error';
+
+import * as native from './native/index.ts';
+import * as treeSitter from './tree-sitter/index.ts';
+
+export type { JSONMediaTypes } from './media-types.ts';
+export type { Tree } from './tree-sitter/index.ts';
+
+export { lexicalAnalysis, syntacticAnalysis } from './tree-sitter/index.ts';
+
+/**
+ * @public
+ */
+export { default as mediaTypes } from './media-types.ts';
+
+/**
+ * @public
+ */
+export const namespace = new Namespace();
+
+/**
+ * @public
+ */
+export const detectionRegExp = treeSitter.detectionRegExp;
+
+/**
+ * @public
+ */
+export interface ParseDetectOptions {
+  strict?: boolean;
+}
+
+/**
+ * @public
+ */
+export const detect = async (
+  source: string,
+  { strict = false }: ParseDetectOptions = {},
+): Promise<boolean> => {
+  if (strict) {
+    return native.detect(source);
+  }
+  return treeSitter.detect(source);
+};
+
+/**
+ * @public
+ */
+export interface ParseOptions {
+  sourceMap?: boolean;
+  style?: boolean;
+  strict?: boolean;
+}
+
+/**
+ * @public
+ */
+export const parse = async (
+  source: string,
+  { sourceMap = false, style = false, strict = false }: ParseOptions = {},
+): Promise<ParseResultElement> => {
+  if (strict && sourceMap) {
+    throw new UnsupportedOperationError(
+      'Cannot use sourceMap with strict parsing. Strict parsing does not support source maps.',
+    );
+  }
+
+  if (strict && style) {
+    throw new UnsupportedOperationError(
+      'Cannot use style with strict parsing. Strict parsing does not support style preservation.',
+    );
+  }
+
+  if (strict) {
+    return native.parse(source);
+  }
+
+  return treeSitter.parse(source, { sourceMap, style });
+};

package/src/media-types.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = exports.JSONMediaTypes = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+/**
+ * @public
+ */
+class JSONMediaTypes extends _apidomCore.MediaTypes {
+  latest() {
+    return this[0];
+  }
+}
+
+/**
+ * @public
+ */
+exports.JSONMediaTypes = JSONMediaTypes;
+const mediaTypes = new JSONMediaTypes('application/json');
+var _default = exports.default = mediaTypes;

package/src/media-types.mjs

@@ -0,0 +1,16 @@
+import { MediaTypes } from '@speclynx/apidom-core';
+
+/**
+ * @public
+ */
+export class JSONMediaTypes extends MediaTypes {
+  latest() {
+    return this[0];
+  }
+}
+
+/**
+ * @public
+ */
+const mediaTypes = new JSONMediaTypes('application/json');
+export default mediaTypes;

package/src/media-types.ts

@@ -0,0 +1,17 @@
+import { MediaTypes } from '@speclynx/apidom-core';
+
+/**
+ * @public
+ */
+export class JSONMediaTypes extends MediaTypes<string> {
+  latest() {
+    return this[0];
+  }
+}
+
+/**
+ * @public
+ */
+const mediaTypes = new JSONMediaTypes('application/json');
+
+export default mediaTypes;

package/src/native/index.cjs

@@ -0,0 +1,37 @@
+"use strict";
+
+exports.__esModule = true;
+exports.parse = exports.detect = void 0;
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+/**
+ * @public
+ */
+const detect = async source => {
+  if (source.trim().length === 0) {
+    return false;
+  }
+  try {
+    JSON.parse(source);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * @public
+ */
+exports.detect = detect;
+const parse = async source => {
+  const parseResult = new _apidomDatamodel.ParseResultElement();
+  if (source.trim().length === 0) {
+    return parseResult;
+  }
+  let pojo = JSON.parse(source);
+  const element = (0, _apidomDatamodel.refract)(pojo);
+  pojo = null; // allow GC to reclaim POJO
+  element.classes.push('result');
+  parseResult.push(element);
+  return parseResult;
+};
+exports.parse = parse;

package/src/native/index.mjs

@@ -0,0 +1,32 @@
+import { ParseResultElement, refract } from '@speclynx/apidom-datamodel';
+
+/**
+ * @public
+ */
+export const detect = async source => {
+  if (source.trim().length === 0) {
+    return false;
+  }
+  try {
+    JSON.parse(source);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * @public
+ */
+export const parse = async source => {
+  const parseResult = new ParseResultElement();
+  if (source.trim().length === 0) {
+    return parseResult;
+  }
+  let pojo = JSON.parse(source);
+  const element = refract(pojo);
+  pojo = null; // allow GC to reclaim POJO
+  element.classes.push('result');
+  parseResult.push(element);
+  return parseResult;
+};

package/src/native/index.ts

@@ -0,0 +1,36 @@
+import { ParseResultElement, refract } from '@speclynx/apidom-datamodel';
+
+/**
+ * @public
+ */
+export const detect = async (source: string): Promise<boolean> => {
+  if (source.trim().length === 0) {
+    return false;
+  }
+
+  try {
+    JSON.parse(source);
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/**
+ * @public
+ */
+export const parse = async (source: string): Promise<ParseResultElement> => {
+  const parseResult = new ParseResultElement();
+
+  if (source.trim().length === 0) {
+    return parseResult;
+  }
+
+  let pojo: unknown = JSON.parse(source);
+  const element = refract(pojo);
+  pojo = null; // allow GC to reclaim POJO
+  element.classes.push('result');
+  parseResult.push(element);
+
+  return parseResult;
+};

package/src/tree-sitter/index.cjs

@@ -0,0 +1,56 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.parse = exports.detectionRegExp = exports.detect = void 0;
+var _index = _interopRequireDefault(require("./lexical-analysis/index.cjs"));
+exports.lexicalAnalysis = _index.default;
+var _index2 = _interopRequireDefault(require("./syntactic-analysis/index.cjs"));
+exports.syntacticAnalysis = _index2.default;
+/**
+ * @public
+ */
+const detectionRegExp = exports.detectionRegExp =
+// eslint-disable-next-line no-control-regex
+/(?<true>^\s*true\s*$)|(?<false>^\s*false\s*$)|(?<null>^\s*null\s*$)|(?<number>^\s*\d+\s*$)|(?<object>^\s*{\s*)|(?<array>^\s*\[\s*)|(?<string>^\s*"(((?=\\)\\(["\\/bfnrt]|u[0-9a-fA-F]{4}))|[^"\\\x00-\x1F\x7F])*"\s*$)/;
+
+/**
+ * @public
+ */
+const detect = async source => {
+  if (!detectionRegExp.test(source)) {
+    return false;
+  }
+  let cst = null;
+  try {
+    cst = await (0, _index.default)(source);
+    return cst.rootNode.type !== 'ERROR';
+  } catch {
+    return false;
+  } finally {
+    cst?.delete();
+  }
+};
+
+/**
+ * @public
+ */
+exports.detect = detect;
+/**
+ * @public
+ */
+const parse = async (source, {
+  sourceMap = false,
+  style = false
+} = {}) => {
+  const cst = await (0, _index.default)(source);
+  try {
+    return (0, _index2.default)(cst, {
+      sourceMap,
+      style
+    });
+  } finally {
+    cst.delete();
+  }
+};
+exports.parse = parse;

package/src/tree-sitter/index.mjs

@@ -0,0 +1,50 @@
+import lexicalAnalysis from "./lexical-analysis/index.mjs";
+import syntacticAnalysis from "./syntactic-analysis/index.mjs";
+export { lexicalAnalysis, syntacticAnalysis };
+
+/**
+ * @public
+ */
+export const detectionRegExp =
+// eslint-disable-next-line no-control-regex
+/(?<true>^\s*true\s*$)|(?<false>^\s*false\s*$)|(?<null>^\s*null\s*$)|(?<number>^\s*\d+\s*$)|(?<object>^\s*{\s*)|(?<array>^\s*\[\s*)|(?<string>^\s*"(((?=\\)\\(["\\/bfnrt]|u[0-9a-fA-F]{4}))|[^"\\\x00-\x1F\x7F])*"\s*$)/;
+
+/**
+ * @public
+ */
+export const detect = async source => {
+  if (!detectionRegExp.test(source)) {
+    return false;
+  }
+  let cst = null;
+  try {
+    cst = await lexicalAnalysis(source);
+    return cst.rootNode.type !== 'ERROR';
+  } catch {
+    return false;
+  } finally {
+    cst?.delete();
+  }
+};
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+export const parse = async (source, {
+  sourceMap = false,
+  style = false
+} = {}) => {
+  const cst = await lexicalAnalysis(source);
+  try {
+    return syntacticAnalysis(cst, {
+      sourceMap,
+      style
+    });
+  } finally {
+    cst.delete();
+  }
+};

package/src/tree-sitter/index.ts

@@ -0,0 +1,57 @@
+import { ParseResultElement } from '@speclynx/apidom-datamodel';
+import type { Tree } from 'web-tree-sitter';
+
+import lexicalAnalysis from './lexical-analysis/index.ts';
+import syntacticAnalysis from './syntactic-analysis/index.ts';
+
+export type { Tree };
+export { lexicalAnalysis, syntacticAnalysis };
+
+/**
+ * @public
+ */
+export const detectionRegExp =
+  // eslint-disable-next-line no-control-regex
+  /(?<true>^\s*true\s*$)|(?<false>^\s*false\s*$)|(?<null>^\s*null\s*$)|(?<number>^\s*\d+\s*$)|(?<object>^\s*{\s*)|(?<array>^\s*\[\s*)|(?<string>^\s*"(((?=\\)\\(["\\/bfnrt]|u[0-9a-fA-F]{4}))|[^"\\\x00-\x1F\x7F])*"\s*$)/;
+
+/**
+ * @public
+ */
+export const detect = async (source: string): Promise<boolean> => {
+  if (!detectionRegExp.test(source)) {
+    return false;
+  }
+
+  let cst: Tree | null = null;
+  try {
+    cst = await lexicalAnalysis(source);
+    return cst.rootNode.type !== 'ERROR';
+  } catch {
+    return false;
+  } finally {
+    cst?.delete();
+  }
+};
+
+/**
+ * @public
+ */
+export interface ParseOptions {
+  sourceMap?: boolean;
+  style?: boolean;
+}
+
+/**
+ * @public
+ */
+export const parse = async (
+  source: string,
+  { sourceMap = false, style = false }: ParseOptions = {},
+): Promise<ParseResultElement> => {
+  const cst = await lexicalAnalysis(source);
+  try {
+    return syntacticAnalysis(cst, { sourceMap, style });
+  } finally {
+    cst.delete();
+  }
+};