@speclynx/apidom-json-pointer-relative 4.0.3 → 4.0.4

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [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-json-pointer-relative",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "description": "Evaluate Relative JSON Pointer expressions against ApiDOM.",
   "keywords": [
     "apidom",
@@ -54,15 +54,16 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-datamodel": "4.0.3",
-    "@speclynx/apidom-error": "4.0.3",
-    "@speclynx/apidom-json-pointer": "4.0.3",
-    "@speclynx/apidom-traverse": "4.0.3",
+    "@speclynx/apidom-datamodel": "4.0.4",
+    "@speclynx/apidom-error": "4.0.4",
+    "@speclynx/apidom-json-pointer": "4.0.4",
+    "@speclynx/apidom-traverse": "4.0.4",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0"
   },
   "files": [
-    "src/",
+    "src/**/*.mjs",
+    "src/**/*.cjs",
     "dist/",
     "types/apidom-json-pointer-relative.d.ts",
     "LICENSES",
@@ -70,5 +71,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "6ccfa09c02232516215e7de3ead276641957e626"
+  "gitHead": "a06f6ef3d37ad5bf860cbbf4b442bfbe3a522cc2"
 }

package/src/compile.ts

@@ -1,41 +0,0 @@
-import { compile as compileJsonPointer } from '@speclynx/apidom-json-pointer';
-
-import { RelativeJsonPointer } from './types.ts';
-import CompilationRelativeJsonPointerError from './errors/CompilationRelativeJsonPointerError.ts';
-
-/**
- * @public
- */
-const compile = (relativeJsonPointer: RelativeJsonPointer): string => {
-  try {
-    let relativePointer = '';
-
-    // non-negative-integer
-    relativePointer += String(relativeJsonPointer.nonNegativeIntegerPrefix);
-
-    // index-manipulation
-    if (typeof relativeJsonPointer.indexManipulation === 'number') {
-      relativePointer += String(relativeJsonPointer.indexManipulation);
-    }
-
-    if (Array.isArray(relativeJsonPointer.jsonPointerTokens)) {
-      // <json-pointer>
-      relativePointer += compileJsonPointer(relativeJsonPointer.jsonPointerTokens);
-    } else if (relativeJsonPointer.hashCharacter) {
-      // "#"
-      relativePointer += '#';
-    }
-
-    return relativePointer;
-  } catch (error: unknown) {
-    throw new CompilationRelativeJsonPointerError(
-      'Relative JSON Pointer compilation encountered an error.',
-      {
-        relativePointer: relativeJsonPointer,
-        cause: error,
-      },
-    );
-  }
-};
-
-export default compile;

package/src/errors/CompilationRelativeJsonPointerError.ts

@@ -1,39 +0,0 @@
-import { ApiDOMErrorOptions } from '@speclynx/apidom-error';
-
-import { RelativeJsonPointer } from '../types.ts';
-import RelativeJsonPointerError from './RelativeJsonPointerError.ts';
-
-/**
- * @public
- */
-export interface CompilationRelativeJsonPointerErrorOptions extends ApiDOMErrorOptions {
-  readonly relativePointer: RelativeJsonPointer;
-}
-
-/**
- * @public
- */
-class CompilationRelativeJsonPointerError extends RelativeJsonPointerError {
-  public readonly nonNegativeIntegerPrefix!: number;
-
-  public readonly indexManipulation?: number;
-
-  public readonly jsonPointerTokens?: string[];
-
-  public readonly hashCharacter?: boolean;
-
-  constructor(message?: string, structuredOptions?: CompilationRelativeJsonPointerErrorOptions) {
-    super(message, structuredOptions);
-
-    if (typeof structuredOptions !== 'undefined') {
-      this.nonNegativeIntegerPrefix = structuredOptions.relativePointer.nonNegativeIntegerPrefix;
-      this.indexManipulation = structuredOptions.relativePointer.indexManipulation;
-      this.hashCharacter = structuredOptions.relativePointer.hashCharacter;
-      if (Array.isArray(structuredOptions.relativePointer.jsonPointerTokens)) {
-        this.jsonPointerTokens = [...structuredOptions.relativePointer.jsonPointerTokens];
-      }
-    }
-  }
-}
-
-export default CompilationRelativeJsonPointerError;

package/src/errors/EvaluationRelativeJsonPointerError.ts

@@ -1,51 +0,0 @@
-import { Element } from '@speclynx/apidom-datamodel';
-import { ApiDOMErrorOptions } from '@speclynx/apidom-error';
-
-import RelativeJsonPointerError from './RelativeJsonPointerError.ts';
-
-/**
- * @public
- */
-export interface EvaluationRelativeJsonPointerErrorOptions<
-  T extends Element,
-  U extends Element,
-  V extends Element,
-> extends ApiDOMErrorOptions {
-  readonly relativePointer: string;
-  readonly currentElement: T;
-  readonly rootElement: U;
-  readonly cursorElement?: V;
-}
-
-/**
- * @public
- */
-class EvaluationRelativeJsonPointerError<
-  T extends Element,
-  U extends Element,
-  V extends Element,
-> extends RelativeJsonPointerError {
-  public readonly relativePointer!: string;
-
-  public readonly currentElement!: T;
-
-  public readonly rootElement!: U;
-
-  public readonly cursorElement?: V;
-
-  constructor(
-    message?: string,
-    structuredOptions?: EvaluationRelativeJsonPointerErrorOptions<T, U, V>,
-  ) {
-    super(message, structuredOptions);
-
-    if (typeof structuredOptions !== 'undefined') {
-      this.relativePointer = structuredOptions.relativePointer;
-      this.currentElement = structuredOptions.currentElement;
-      this.rootElement = structuredOptions.rootElement;
-      this.cursorElement = structuredOptions.cursorElement;
-    }
-  }
-}
-
-export default EvaluationRelativeJsonPointerError;

package/src/errors/InvalidRelativeJsonPointerError.ts

@@ -1,25 +0,0 @@
-import { ApiDOMErrorOptions } from '@speclynx/apidom-error';
-
-import RelativeJsonPointerError from './RelativeJsonPointerError.ts';
-
-/**
- * @public
- */
-export interface InvalidRelativeJsonPointerErrorOptions extends ApiDOMErrorOptions {
-  readonly relativePointer: string;
-}
-
-/**
- * @public
- */
-export default class InvalidRelativeJsonPointerError extends RelativeJsonPointerError {
-  public readonly relativePointer!: string;
-
-  constructor(message?: string, structuredOptions?: InvalidRelativeJsonPointerErrorOptions) {
-    super(message, structuredOptions);
-
-    if (typeof structuredOptions !== 'undefined') {
-      this.relativePointer = structuredOptions.relativePointer;
-    }
-  }
-}

package/src/errors/RelativeJsonPointerError.ts

@@ -1,8 +0,0 @@
-import { ApiDOMStructuredError } from '@speclynx/apidom-error';
-
-/**
- * @public
- */
-class RelativeJsonPointerError extends ApiDOMStructuredError {}
-
-export default RelativeJsonPointerError;

package/src/evaluate.ts

@@ -1,178 +0,0 @@
-import {
-  Element,
-  isElement,
-  isMemberElement,
-  isArrayElement,
-  MemberElement,
-  ArrayElement,
-  NumberElement,
-  cloneDeep,
-} from '@speclynx/apidom-datamodel';
-import { traverse, Path } from '@speclynx/apidom-traverse';
-import {
-  compile as compileJsonPointer,
-  evaluate as evaluateJsonPointer,
-} from '@speclynx/apidom-json-pointer';
-import { last } from 'ramda';
-
-import EvaluationRelativeJsonPointerError from './errors/EvaluationRelativeJsonPointerError.ts';
-import parse from './parse.ts';
-import { RelativeJsonPointer } from './types.ts';
-
-/**
- * Evaluates Relative JSON Pointer against ApiDOM fragment.
- * @public
- */
-const evaluate = <T extends Element, U extends Element>(
-  relativePointer: string,
-  currentElement: T,
-  rootElement: U,
-): Element | undefined => {
-  let ancestorLineage: Element[] = [];
-  let cursor: Element | undefined = currentElement;
-
-  traverse(rootElement, {
-    enter(path: Path<Element>) {
-      if (path.node === currentElement) {
-        ancestorLineage = path.getAncestorNodes().reverse().filter(isElement);
-        path.stop();
-      }
-    },
-  });
-
-  if (ancestorLineage.length === 0) {
-    throw new EvaluationRelativeJsonPointerError(
-      'Relative JSON Pointer evaluation failed. Current element not found inside the root element',
-      {
-        relativePointer,
-        currentElement: cloneDeep(currentElement),
-        rootElement: cloneDeep(rootElement),
-        cursorElement: cloneDeep.safe(cursor),
-      },
-    );
-  }
-
-  if (last(ancestorLineage) === rootElement) {
-    throw new EvaluationRelativeJsonPointerError(
-      'Relative JSON Pointer evaluation failed. Current element cannot be the root element',
-      {
-        relativePointer,
-        currentElement,
-        rootElement,
-        cursorElement: cursor,
-      },
-    );
-  }
-
-  let relativeJsonPointer: RelativeJsonPointer;
-  try {
-    relativeJsonPointer = parse(relativePointer);
-  } catch (error: unknown) {
-    throw new EvaluationRelativeJsonPointerError(
-      'Relative JSON Pointer evaluation failed while parsing the pointer.',
-      {
-        relativePointer,
-        currentElement: cloneDeep(currentElement),
-        rootElement: cloneDeep(currentElement),
-        cursorElement: cloneDeep.safe(cursor),
-        cause: error,
-      },
-    );
-  }
-
-  // non-negative-integer
-  if (relativeJsonPointer.nonNegativeIntegerPrefix > 0) {
-    const ancestorLineageCopy = [...ancestorLineage];
-
-    for (
-      let { nonNegativeIntegerPrefix } = relativeJsonPointer;
-      nonNegativeIntegerPrefix > 0;
-      nonNegativeIntegerPrefix -= 1
-    ) {
-      cursor = ancestorLineageCopy.pop();
-      if (isMemberElement(cursor)) {
-        cursor = ancestorLineageCopy.pop();
-      }
-    }
-
-    if (typeof cursor === 'undefined') {
-      throw new EvaluationRelativeJsonPointerError(
-        `Relative JSON Pointer evaluation failed on non-negative-integer prefix of "${relativeJsonPointer.nonNegativeIntegerPrefix}"`,
-        {
-          relativePointer,
-          currentElement: cloneDeep(currentElement),
-          rootElement: cloneDeep(rootElement),
-          cursorElement: cloneDeep.safe(cursor),
-        },
-      );
-    }
-
-    ancestorLineage = ancestorLineageCopy;
-  }
-
-  // index-manipulation
-  if (typeof relativeJsonPointer.indexManipulation === 'number') {
-    const containedArray = last(ancestorLineage);
-
-    if (typeof containedArray === 'undefined' || !isArrayElement(containedArray)) {
-      throw new EvaluationRelativeJsonPointerError(
-        `Relative JSON Pointer evaluation failed failed on index-manipulation "${relativeJsonPointer.indexManipulation}"`,
-        {
-          relativePointer,
-          currentElement: cloneDeep(currentElement),
-          rootElement: cloneDeep(rootElement),
-          cursorElement: cloneDeep.safe(cursor),
-        },
-      );
-    }
-
-    const arrayContent = containedArray.content as Element[];
-    const currentCursorIndex = arrayContent.indexOf(cursor!);
-    const newCursorIndex = currentCursorIndex + relativeJsonPointer.indexManipulation;
-    cursor = arrayContent[newCursorIndex] as Element | undefined;
-
-    if (typeof cursor === 'undefined') {
-      throw new EvaluationRelativeJsonPointerError(
-        `Relative JSON Pointer evaluation failed on index-manipulation "${relativeJsonPointer.indexManipulation}"`,
-        {
-          relativePointer,
-          currentElement: cloneDeep(currentElement),
-          rootElement: cloneDeep(rootElement),
-          cursorElement: cloneDeep.safe(cursor),
-        },
-      );
-    }
-  }
-
-  if (Array.isArray(relativeJsonPointer.jsonPointerTokens)) {
-    // <json-pointer>
-    const jsonPointer = compileJsonPointer(relativeJsonPointer.jsonPointerTokens);
-    cursor = evaluateJsonPointer(cursor, jsonPointer);
-  } else if (relativeJsonPointer.hashCharacter) {
-    // "#"
-    if (cursor === rootElement) {
-      throw new EvaluationRelativeJsonPointerError(
-        'Relative JSON Pointer evaluation failed. Current element cannot be the root element to apply "#"',
-        {
-          relativePointer,
-          currentElement: cloneDeep(currentElement),
-          rootElement: cloneDeep(rootElement),
-          cursorElement: cloneDeep.safe(cursor),
-        },
-      );
-    }
-
-    const parentElement = last(ancestorLineage) as ArrayElement | MemberElement | undefined;
-    if (typeof parentElement !== 'undefined') {
-      if (isMemberElement(parentElement)) {
-        cursor = (parentElement as MemberElement).key as Element;
-      } else if (isArrayElement(parentElement)) {
-        cursor = new NumberElement((parentElement.content as Element[]).indexOf(cursor!));
-      }
-    }
-  }
-
-  return cursor;
-};
-
-export default evaluate;

package/src/index.ts

@@ -1,11 +0,0 @@
-export { default as RelativeJsonPointerError } from './errors/RelativeJsonPointerError.ts';
-export { default as InvalidRelativeJsonPointerError } from './errors/InvalidRelativeJsonPointerError.ts';
-export type { InvalidRelativeJsonPointerErrorOptions } from './errors/InvalidRelativeJsonPointerError.ts';
-export { default as EvaluationRelativeJsonPointerError } from './errors/EvaluationRelativeJsonPointerError.ts';
-export type { EvaluationRelativeJsonPointerErrorOptions } from './errors/EvaluationRelativeJsonPointerError.ts';
-export { default as CompilationRelativeJsonPointerError } from './errors/CompilationRelativeJsonPointerError.ts';
-export type { CompilationRelativeJsonPointerErrorOptions } from './errors/CompilationRelativeJsonPointerError.ts';
-export { default as parse, isRelativeJsonPointer } from './parse.ts';
-export { default as compile } from './compile.ts';
-export { default as evaluate } from './evaluate.ts';
-export type { RelativeJsonPointer } from './types.ts';

package/src/parse.ts

@@ -1,66 +0,0 @@
-import { parse as parseJsonPointer } from '@speclynx/apidom-json-pointer';
-
-import InvalidRelativeJsonPointerError from './errors/InvalidRelativeJsonPointerError.ts';
-import { RelativeJsonPointer } from './types.ts';
-
-const nonNegativeIntegerPrefixRegExp = '(?<nonNegativeIntegerPrefix>[1-9]\\d*|0)';
-const indexManipulationRegExp = '(?<indexManipulation>[+-][1-9]\\d*|0)';
-const hashCharacterRegExp = '(?<hashCharacter>#)';
-const jsonPointerRegExp = '(?<jsonPointer>\\/.*)';
-const relativeJsonPointerRegExp = new RegExp(
-  `^${nonNegativeIntegerPrefixRegExp}${indexManipulationRegExp}?(${hashCharacterRegExp}|${jsonPointerRegExp})?$`,
-);
-
-/**
- * @public
- */
-export const isRelativeJsonPointer = (value: any) => {
-  return typeof value === 'string' && relativeJsonPointerRegExp.test(value);
-};
-
-/**
- * @public
- */
-const parse = (relativePointer: string): RelativeJsonPointer => {
-  const match = relativePointer.match(relativeJsonPointerRegExp);
-  if (match === null || typeof match.groups === 'undefined') {
-    throw new InvalidRelativeJsonPointerError(
-      `Invalid Relative JSON Pointer "${relativePointer}".`,
-      { relativePointer },
-    );
-  }
-
-  try {
-    // non-negative-integer
-    const nonNegativeIntegerPrefix = parseInt(match.groups.nonNegativeIntegerPrefix, 10);
-    // index-manipulation
-    const indexManipulation =
-      typeof match.groups.indexManipulation === 'string'
-        ? parseInt(match.groups.indexManipulation, 10)
-        : undefined;
-    // <json-pointer>
-    const jsonPointerTokens =
-      typeof match.groups.jsonPointer === 'string'
-        ? parseJsonPointer(match.groups.jsonPointer).tree
-        : undefined;
-    // "#"
-    const hashCharacter = typeof match.groups.hashCharacter === 'string';
-
-    return {
-      nonNegativeIntegerPrefix,
-      indexManipulation,
-      jsonPointerTokens,
-      hashCharacter,
-    };
-  } catch (error: unknown) {
-    throw new InvalidRelativeJsonPointerError(
-      `Relative JSON Pointer parsing of "${relativePointer}" encountered an error.`,
-      {
-        relativePointer,
-        cause: error,
-      },
-    );
-  }
-};
-
-export default parse;

package/src/types.ts

@@ -1,9 +0,0 @@
-/**
- * @public
- */
-export type RelativeJsonPointer = {
-  readonly nonNegativeIntegerPrefix: number;
-  readonly indexManipulation?: number;
-  readonly jsonPointerTokens?: string[];
-  readonly hashCharacter?: boolean;
-};