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

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.5](https://github.com/speclynx/apidom/compare/v4.0.4...v4.0.5) (2026-03-13)
+
+**Note:** Version bump only for package @speclynx/apidom-parser-adapter-json
+
+## [4.0.4](https://github.com/speclynx/apidom/compare/v4.0.3...v4.0.4) (2026-03-12)
+
+### Bug Fixes
+
+- **release:** override minimatch 10.2.3 to fix glob pattern regression in lerna publish ([#157](https://github.com/speclynx/apidom/issues/157)) ([c2d65a0](https://github.com/speclynx/apidom/commit/c2d65a06a2187e8563a9dc9db74ba27255450e0b)), closes [lerna/lerna#4305](https://github.com/lerna/lerna/issues/4305) [isaacs/minimatch#284](https://github.com/isaacs/minimatch/issues/284)
+
 ## [4.0.3](https://github.com/speclynx/apidom/compare/v4.0.2...v4.0.3) (2026-03-11)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-parser-adapter-json",
-  "version": "4.0.3",
+  "version": "4.0.5",
   "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.3",
-    "@speclynx/apidom-datamodel": "4.0.3",
-    "@speclynx/apidom-error": "4.0.3",
+    "@speclynx/apidom-core": "4.0.5",
+    "@speclynx/apidom-datamodel": "4.0.5",
+    "@speclynx/apidom-error": "4.0.5",
     "web-tree-sitter": "=0.26.6"
   },
   "devDependencies": {
@@ -68,7 +68,8 @@
     "tree-sitter-json": "=0.24.8"
   },
   "files": [
-    "src/",
+    "src/**/*.mjs",
+    "src/**/*.cjs",
     "dist/",
     "types/apidom-parser-adapter-json.d.ts",
     "LICENSES",
@@ -76,5 +77,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "6ccfa09c02232516215e7de3ead276641957e626"
+  "gitHead": "5a85d2a832eeefb07d03760faa391b457447e966"
 }

package/src/adapter.ts

@@ -1,80 +0,0 @@
-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.ts

@@ -1,17 +0,0 @@
-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.ts

@@ -1,36 +0,0 @@
-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.ts

@@ -1,57 +0,0 @@
-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();
-  }
-};

package/src/tree-sitter/lexical-analysis/index.ts

@@ -1,48 +0,0 @@
-import { Tree, Parser, Language } from 'web-tree-sitter';
-import treeSitter from 'web-tree-sitter/web-tree-sitter.wasm';
-// eslint-disable-next-line import/no-extraneous-dependencies
-import treeSitterJson from 'tree-sitter-json/tree-sitter-json.wasm';
-import { ApiDOMError } from '@speclynx/apidom-error';
-
-let parser: Parser | null = null;
-let parserInitLock: Promise<Parser> | null = null;
-
-/**
- * Lexical Analysis of source string using WebTreeSitter.
- * This is WebAssembly version of TreeSitters Lexical Analysis.
- *
- * Given JavaScript doesn't support true parallelism, this
- * code should be as lazy as possible and temporal safety should be fine.
- * @public
- */
-const analyze = async (source: string): Promise<Tree> => {
-  if (parser === null && parserInitLock === null) {
-    // acquire lock
-    parserInitLock = Parser.init({
-      wasmBinary: treeSitter,
-      locateFile: (scriptName: string) => scriptName,
-    } as unknown as EmscriptenModule)
-      .then(() => Language.load(treeSitterJson))
-      .then((jsonLanguage) => {
-        const parserInstance = new Parser();
-        parserInstance.setLanguage(jsonLanguage);
-        return parserInstance;
-      })
-      .finally(() => {
-        // release lock
-        parserInitLock = null;
-      });
-    parser = await parserInitLock;
-  } else if (parser === null && parserInitLock !== null) {
-    // await for lock to be released if there is one
-    parser = await parserInitLock;
-  } else if (parser === null) {
-    throw new ApiDOMError(
-      'Error while initializing web-tree-sitter and loading tree-sitter-json grammar.',
-    );
-  }
-
-  return parser.parse(source) as Tree;
-};
-
-export default analyze;

package/src/tree-sitter/syntactic-analysis/index.ts

@@ -1,350 +0,0 @@
-import { TreeCursor, Tree, Point } from 'web-tree-sitter';
-import {
-  BooleanElement,
-  NullElement,
-  NumberElement,
-  ParseResultElement,
-  Element,
-  MemberElement,
-  ObjectElement,
-  ArrayElement,
-  StringElement,
-  AnnotationElement,
-  isPrimitiveElement,
-} from '@speclynx/apidom-datamodel';
-
-interface TransformContext {
-  sourceMap: boolean;
-  style: boolean;
-  indent: number;
-  annotations: AnnotationElement[];
-}
-
-interface CursorInfo {
-  type: string;
-  startPosition: Point;
-  endPosition: Point;
-  startIndex: number;
-  endIndex: number;
-  text: string;
-  isNamed: boolean;
-  isMissing: boolean;
-  hasError: boolean;
-  fieldName: string | null;
-}
-
-const getCursorInfo = (cursor: TreeCursor): CursorInfo => ({
-  type: cursor.nodeType,
-  startPosition: cursor.startPosition,
-  endPosition: cursor.endPosition,
-  startIndex: cursor.startIndex,
-  endIndex: cursor.endIndex,
-  text: cursor.nodeText,
-  isNamed: cursor.nodeIsNamed,
-  isMissing: cursor.nodeIsMissing,
-  hasError: cursor.currentNode.hasError,
-  fieldName: cursor.currentFieldName,
-});
-
-const maybeAddSourceMap = (info: CursorInfo, element: Element, ctx: TransformContext): void => {
-  if (!ctx.sourceMap) {
-    return;
-  }
-
-  element.startLine = info.startPosition.row;
-  element.startCharacter = info.startPosition.column;
-  element.startOffset = info.startIndex;
-  element.endLine = info.endPosition.row;
-  element.endCharacter = info.endPosition.column;
-  element.endOffset = info.endIndex;
-};
-
-// build json style object for an element
-const buildJsonStyle = (
-  ctx: TransformContext,
-  extras?: Record<string, unknown>,
-): Record<string, unknown> => {
-  const jsonStyle: Record<string, unknown> = { indent: ctx.indent };
-  if (extras) Object.assign(jsonStyle, extras);
-  return { json: jsonStyle };
-};
-
-// detect indent from an object's first pair child position
-// called during transformChildren when we encounter the first pair
-const detectIndent = (objectColumn: number, firstPairColumn: number): number => {
-  const diff = firstPairColumn - objectColumn;
-  return diff > 0 ? diff : 2;
-};
-
-type Transformer = (cursor: TreeCursor, ctx: TransformContext) => Element | null;
-type TransformerMap = Record<string, Transformer>;
-
-const transform = (
-  cursor: TreeCursor,
-  transformerMap: TransformerMap,
-  ctx: TransformContext,
-): Element | null => {
-  const info = getCursorInfo(cursor);
-
-  // Handle missing anonymous literals
-  if (!info.isNamed && info.isMissing) {
-    const value = info.type || info.text;
-    const message = `(Missing ${value})`;
-    const element = new AnnotationElement(message);
-    element.classes.push('warning');
-    maybeAddSourceMap(info, element, ctx);
-    ctx.annotations.push(element);
-    return null;
-  }
-
-  const transformer = transformerMap[info.type];
-  if (!transformer) {
-    return null; // remove unrecognized nodes
-  }
-
-  return transformer(cursor, ctx);
-};
-
-const transformChildren = (
-  cursor: TreeCursor,
-  transformerMap: TransformerMap,
-  ctx: TransformContext,
-): Element[] => {
-  const results: Element[] = [];
-
-  if (cursor.gotoFirstChild()) {
-    do {
-      const transformed = transform(cursor, transformerMap, ctx);
-      if (transformed !== null) {
-        results.push(transformed);
-      }
-    } while (cursor.gotoNextSibling());
-    cursor.gotoParent();
-  }
-
-  return results;
-};
-
-const createTransformers = (transformerMap: TransformerMap): TransformerMap => ({
-  document(cursor: TreeCursor, ctx: TransformContext): ParseResultElement {
-    const info = getCursorInfo(cursor);
-    const element = new ParseResultElement();
-    maybeAddSourceMap(info, element, ctx);
-
-    // Transform children
-    const children = transformChildren(cursor, transformerMap, ctx);
-    for (const child of children) {
-      element.push(child);
-    }
-
-    // Mark first non-Annotation element as result
-    // @ts-ignore
-    const elements = element.findElements(isPrimitiveElement);
-    if (elements.length > 0) {
-      elements[0].classes.push('result');
-    }
-
-    // Add collected annotations
-    for (const annotation of ctx.annotations) {
-      element.push(annotation);
-    }
-    ctx.annotations = [];
-
-    return element;
-  },
-
-  object(cursor: TreeCursor, ctx: TransformContext): ObjectElement {
-    const info = getCursorInfo(cursor);
-    const element = new ObjectElement();
-    maybeAddSourceMap(info, element, ctx);
-
-    // Detect indent from first pair if style is enabled and not yet detected
-    if (ctx.style && ctx.indent === 0) {
-      if (cursor.gotoFirstChild()) {
-        do {
-          if (cursor.nodeType === 'pair') {
-            ctx.indent = detectIndent(info.startPosition.column, cursor.startPosition.column);
-            break;
-          }
-        } while (cursor.gotoNextSibling());
-        cursor.gotoParent();
-      }
-    }
-
-    // Transform children (pairs)
-    const children = transformChildren(cursor, transformerMap, ctx);
-    for (const child of children) {
-      element.push(child);
-    }
-
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-
-    return element;
-  },
-
-  array(cursor: TreeCursor, ctx: TransformContext): ArrayElement {
-    const info = getCursorInfo(cursor);
-    const element = new ArrayElement();
-    maybeAddSourceMap(info, element, ctx);
-
-    // Transform children
-    const children = transformChildren(cursor, transformerMap, ctx);
-    for (const child of children) {
-      element.push(child);
-    }
-
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-
-    return element;
-  },
-
-  pair(cursor: TreeCursor, ctx: TransformContext): MemberElement {
-    const info = getCursorInfo(cursor);
-
-    let key: Element | null = null;
-    let value: Element | null = null;
-
-    // Find key and value by field name
-    if (cursor.gotoFirstChild()) {
-      do {
-        const fieldName = cursor.currentFieldName;
-        if (fieldName === 'key') {
-          key = transform(cursor, transformerMap, ctx);
-        } else if (fieldName === 'value') {
-          value = transform(cursor, transformerMap, ctx);
-        } else if (cursor.nodeType === 'ERROR') {
-          // Process error nodes
-          transform(cursor, transformerMap, ctx);
-        }
-      } while (cursor.gotoNextSibling());
-      cursor.gotoParent();
-    }
-
-    const element = new MemberElement(key ?? new StringElement(''), value ?? new StringElement(''));
-    maybeAddSourceMap(info, element, ctx);
-
-    return element;
-  },
-
-  string(cursor: TreeCursor, ctx: TransformContext): StringElement {
-    const info = getCursorInfo(cursor);
-    let element: StringElement;
-
-    try {
-      element = new StringElement(JSON.parse(info.text));
-    } catch (error: unknown) {
-      element = new StringElement(info.text);
-      if (error instanceof Error) {
-        element.meta.set('jsonParse', {
-          isError: true,
-          errorType: error.name,
-          errorMessage: error.message,
-        });
-      }
-    }
-
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-    maybeAddSourceMap(info, element, ctx);
-    return element;
-  },
-
-  number(cursor: TreeCursor, ctx: TransformContext): NumberElement {
-    const info = getCursorInfo(cursor);
-    const element = new NumberElement(Number(info.text));
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx, { rawContent: info.text });
-    }
-    maybeAddSourceMap(info, element, ctx);
-    return element;
-  },
-
-  null(cursor: TreeCursor, ctx: TransformContext): NullElement {
-    const info = getCursorInfo(cursor);
-    const element = new NullElement();
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-    maybeAddSourceMap(info, element, ctx);
-    return element;
-  },
-
-  true(cursor: TreeCursor, ctx: TransformContext): BooleanElement {
-    const info = getCursorInfo(cursor);
-    const element = new BooleanElement(true);
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-    maybeAddSourceMap(info, element, ctx);
-    return element;
-  },
-
-  false(cursor: TreeCursor, ctx: TransformContext): BooleanElement {
-    const info = getCursorInfo(cursor);
-    const element = new BooleanElement(false);
-    if (ctx.style) {
-      element.style = buildJsonStyle(ctx);
-    }
-    maybeAddSourceMap(info, element, ctx);
-    return element;
-  },
-
-  ERROR(cursor: TreeCursor, ctx: TransformContext): ParseResultElement | null {
-    const info = getCursorInfo(cursor);
-    const isUnexpected = !info.hasError;
-    const message = isUnexpected ? `(Unexpected ${info.text})` : `(Error ${info.text})`;
-    const element = new AnnotationElement(message);
-
-    element.classes.push('error');
-    maybeAddSourceMap(info, element, ctx);
-
-    ctx.annotations.push(element);
-
-    return null;
-  },
-});
-
-// Create the transformers map with self-reference for recursion
-const transformers: TransformerMap = {};
-Object.assign(transformers, createTransformers(transformers));
-
-/**
- * Syntactic analysis translates TreeSitter CST directly into ApiDOM.
- *
- * Direct transformation from TreeSitter CST using TreeSitter cursor.
- * TreeSitter cursor is a stateful object that allows us to walk syntax tree
- * containing large number of nodes with maximum efficiency.
- *
- * Single pass transformation from CST to ApiDOM.
- * @public
- */
-const analyze = (cst: Tree, { sourceMap = false, style = false } = {}): ParseResultElement => {
-  const cursor = cst.walk();
-
-  const ctx: TransformContext = {
-    sourceMap,
-    style,
-    indent: 0,
-    annotations: [],
-  };
-
-  const result = transform(cursor, transformers, ctx);
-
-  // Handle case where there's no document, only errors
-  if (result === null) {
-    const parseResult = new ParseResultElement();
-    for (const annotation of ctx.annotations) {
-      parseResult.push(annotation);
-    }
-    return parseResult;
-  }
-
-  return result as ParseResultElement;
-};
-
-export default analyze;

package/src/wasm.d.ts

@@ -1,18 +0,0 @@
-/**
- * TypeScript module declarations for WebAssembly (.wasm) files.
- * This allows importing .wasm files as modules without @ts-ignore.
- */
-declare module '*.wasm' {
-  const content: string;
-  export default content;
-}
-
-declare module 'web-tree-sitter/tree-sitter.wasm' {
-  const content: string;
-  export default content;
-}
-
-declare module 'tree-sitter-json/tree-sitter-json.wasm' {
-  const content: string;
-  export default content;
-}