@scalar/json-magic 0.4.3 → 0.5.1

package/dist/bundle/plugins/parse-json/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/bundle/plugins/parse-json/index.ts"],
-  "sourcesContent": ["import { isJsonObject } from '@/utils/is-json-object'\nimport type { LoaderPlugin, ResolveResult } from '@/bundle'\n\n/**\n * Creates a plugin that parses JSON strings into JavaScript objects.\n * @returns A plugin object with validate and exec functions\n * @example\n * ```ts\n * const jsonPlugin = parseJson()\n * const result = jsonPlugin.exec('{\"name\": \"John\", \"age\": 30}')\n * // result = { name: 'John', age: 30 }\n * ```\n */\nexport function parseJson(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isJsonObject,\n    exec: async (value): Promise<ResolveResult> => {\n      try {\n        return {\n          ok: true,\n          data: JSON.parse(value),\n        }\n      } catch {\n        return {\n          ok: false,\n        }\n      }\n    },\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,oBAAoB;AAatB,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,OAAO,UAAkC;AAC7C,UAAI;AACF,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,KAAK,MAAM,KAAK;AAAA,QACxB;AAAA,MACF,QAAQ;AACN,eAAO;AAAA,UACL,IAAI;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { LoaderPlugin, ResolveResult } from '@/bundle'\nimport { isJsonObject } from '@/helpers/is-json-object'\n\n/**\n * Creates a plugin that parses JSON strings into JavaScript objects.\n * @returns A plugin object with validate and exec functions\n * @example\n * ```ts\n * const jsonPlugin = parseJson()\n * const result = jsonPlugin.exec('{\"name\": \"John\", \"age\": 30}')\n * // result = { name: 'John', age: 30 }\n * ```\n */\nexport function parseJson(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isJsonObject,\n    exec: async (value): Promise<ResolveResult> => {\n      try {\n        return {\n          ok: true,\n          data: JSON.parse(value),\n        }\n      } catch {\n        return {\n          ok: false,\n        }\n      }\n    },\n  }\n}\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAYtB,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,OAAO,UAAkC;AAC7C,UAAI;AACF,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,KAAK,MAAM,KAAK;AAAA,QACxB;AAAA,MACF,QAAQ;AACN,eAAO;AAAA,UACL,IAAI;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/bundle/plugins/parse-yaml/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bundle/plugins/parse-yaml/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,UAAU,CAAA;AAI3D;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAiBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bundle/plugins/parse-yaml/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,UAAU,CAAA;AAG3D;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAiBxC"}

package/dist/bundle/plugins/parse-yaml/index.js

@@ -1,5 +1,5 @@
-import { isYaml } from "../../../utils/is-yaml.js";
 import YAML from "yaml";
+import { isYaml } from "../../../helpers/is-yaml.js";
 function parseYaml() {
   return {
     type: "loader",

package/dist/bundle/plugins/parse-yaml/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/bundle/plugins/parse-yaml/index.ts"],
-  "sourcesContent": ["import type { LoaderPlugin, ResolveResult } from '@/bundle'\nimport { isYaml } from '@/utils/is-yaml'\nimport YAML from 'yaml'\n\n/**\n * Creates a plugin that parses YAML strings into JavaScript objects.\n * @returns A plugin object with validate and exec functions\n * @example\n * ```ts\n * const yamlPlugin = parseYaml()\n * const result = yamlPlugin.exec('name: John\\nage: 30')\n * // result = { name: 'John', age: 30 }\n * ```\n */\nexport function parseYaml(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isYaml,\n    exec: async (value): Promise<ResolveResult> => {\n      try {\n        return {\n          ok: true,\n          data: YAML.parse(value),\n        }\n      } catch {\n        return {\n          ok: false,\n        }\n      }\n    },\n  }\n}\n"],
-  "mappings": "AACA,SAAS,cAAc;AACvB,OAAO,UAAU;AAYV,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,OAAO,UAAkC;AAC7C,UAAI;AACF,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,KAAK,MAAM,KAAK;AAAA,QACxB;AAAA,MACF,QAAQ;AACN,eAAO;AAAA,UACL,IAAI;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import YAML from 'yaml'\n\nimport type { LoaderPlugin, ResolveResult } from '@/bundle'\nimport { isYaml } from '@/helpers/is-yaml'\n\n/**\n * Creates a plugin that parses YAML strings into JavaScript objects.\n * @returns A plugin object with validate and exec functions\n * @example\n * ```ts\n * const yamlPlugin = parseYaml()\n * const result = yamlPlugin.exec('name: John\\nage: 30')\n * // result = { name: 'John', age: 30 }\n * ```\n */\nexport function parseYaml(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isYaml,\n    exec: async (value): Promise<ResolveResult> => {\n      try {\n        return {\n          ok: true,\n          data: YAML.parse(value),\n        }\n      } catch {\n        return {\n          ok: false,\n        }\n      }\n    },\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,UAAU;AAGjB,SAAS,cAAc;AAYhB,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM,OAAO,UAAkC;AAC7C,UAAI;AACF,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,MAAM,KAAK,MAAM,KAAK;AAAA,QACxB;AAAA,MACF,QAAQ;AACN,eAAO;AAAA,UACL,IAAI;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/bundle/plugins/read-files/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bundle/plugins/read-files/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAG3D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAMxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/bundle/plugins/read-files/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAI3D;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAMxC"}

package/dist/bundle/plugins/read-files/index.js

@@ -1,5 +1,5 @@
-import { normalize } from "../../../utils/normalize.js";
 import { isFilePath } from "../../../bundle/bundle.js";
+import { normalize } from "../../../helpers/normalize.js";
 async function readFile(path) {
   const fs = typeof window === "undefined" ? await import("node:fs/promises") : void 0;
   if (fs === void 0) {

package/dist/bundle/plugins/read-files/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/bundle/plugins/read-files/index.ts"],
-  "sourcesContent": ["import { normalize } from '@/utils/normalize'\nimport type { LoaderPlugin, ResolveResult } from '@/bundle'\nimport { isFilePath } from '@/bundle/bundle'\n\n/**\n * Reads and normalizes data from a local file\n * @param path - The file path to read from\n * @returns A promise that resolves to either the normalized data or an error result\n * @example\n * ```ts\n * const result = await readFile('./schemas/user.json')\n * if (result.ok) {\n *   console.log(result.data) // The normalized data\n * } else {\n *   console.log('Failed to read file')\n * }\n * ```\n */\nexport async function readFile(path: string): Promise<ResolveResult> {\n  const fs = typeof window === 'undefined' ? await import('node:fs/promises') : undefined\n\n  if (fs === undefined) {\n    throw 'Can not use readFiles plugin outside of a node environment'\n  }\n\n  try {\n    const fileContents = await fs.readFile(path, { encoding: 'utf-8' })\n\n    return {\n      ok: true,\n      data: normalize(fileContents),\n    }\n  } catch {\n    return {\n      ok: false,\n    }\n  }\n}\n\n/**\n * Creates a plugin for handling local file references.\n * This plugin validates and reads data from local filesystem paths.\n *\n * @returns A plugin object with validate and exec functions\n * @example\n * const filePlugin = readFiles()\n * if (filePlugin.validate('./local-schema.json')) {\n *   const result = await filePlugin.exec('./local-schema.json')\n * }\n */\nexport function readFiles(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isFilePath,\n    exec: readFile,\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,kBAAkB;AAgB3B,eAAsB,SAAS,MAAsC;AACnE,QAAM,KAAK,OAAO,WAAW,cAAc,MAAM,OAAO,kBAAkB,IAAI;AAE9E,MAAI,OAAO,QAAW;AACpB,UAAM;AAAA,EACR;AAEA,MAAI;AACF,UAAM,eAAe,MAAM,GAAG,SAAS,MAAM,EAAE,UAAU,QAAQ,CAAC;AAElE,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM,UAAU,YAAY;AAAA,IAC9B;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,MACL,IAAI;AAAA,IACN;AAAA,EACF;AACF;AAaO,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM;AAAA,EACR;AACF;",
+  "sourcesContent": ["import type { LoaderPlugin, ResolveResult } from '@/bundle'\nimport { isFilePath } from '@/bundle/bundle'\nimport { normalize } from '@/helpers/normalize'\n\n/**\n * Reads and normalizes data from a local file\n * @param path - The file path to read from\n * @returns A promise that resolves to either the normalized data or an error result\n * @example\n * ```ts\n * const result = await readFile('./schemas/user.json')\n * if (result.ok) {\n *   console.log(result.data) // The normalized data\n * } else {\n *   console.log('Failed to read file')\n * }\n * ```\n */\nexport async function readFile(path: string): Promise<ResolveResult> {\n  const fs = typeof window === 'undefined' ? await import('node:fs/promises') : undefined\n\n  if (fs === undefined) {\n    throw 'Can not use readFiles plugin outside of a node environment'\n  }\n\n  try {\n    const fileContents = await fs.readFile(path, { encoding: 'utf-8' })\n\n    return {\n      ok: true,\n      data: normalize(fileContents),\n    }\n  } catch {\n    return {\n      ok: false,\n    }\n  }\n}\n\n/**\n * Creates a plugin for handling local file references.\n * This plugin validates and reads data from local filesystem paths.\n *\n * @returns A plugin object with validate and exec functions\n * @example\n * const filePlugin = readFiles()\n * if (filePlugin.validate('./local-schema.json')) {\n *   const result = await filePlugin.exec('./local-schema.json')\n * }\n */\nexport function readFiles(): LoaderPlugin {\n  return {\n    type: 'loader',\n    validate: isFilePath,\n    exec: readFile,\n  }\n}\n"],
+  "mappings": "AACA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAgB1B,eAAsB,SAAS,MAAsC;AACnE,QAAM,KAAK,OAAO,WAAW,cAAc,MAAM,OAAO,kBAAkB,IAAI;AAE9E,MAAI,OAAO,QAAW;AACpB,UAAM;AAAA,EACR;AAEA,MAAI;AACF,UAAM,eAAe,MAAM,GAAG,SAAS,MAAM,EAAE,UAAU,QAAQ,CAAC;AAElE,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,MAAM,UAAU,YAAY;AAAA,IAC9B;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,MACL,IAAI;AAAA,IACN;AAAA,EACF;AACF;AAaO,SAAS,YAA0B;AACxC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,MAAM;AAAA,EACR;AACF;",
   "names": []
 }

package/dist/helpers/convert-to-local-ref.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Translates a JSON Reference ($ref) to a local object path within the root schema.
+ *
+ * @param ref - The JSON Reference string (e.g., "#/foo/bar", "other.json#/baz", "other.json#anchor")
+ * @param currentContext - The current base context (usually the $id of the current schema or parent)
+ * @param schemas - A map of schema identifiers ($id, $anchor) to their local object paths
+ * @returns The local object path as a string, or undefined if the reference cannot be resolved
+ */
+export declare const convertToLocalRef: (ref: string, currentContext: string, schemas: Map<string, string>) => string | undefined;
+//# sourceMappingURL=convert-to-local-ref.d.ts.map

package/dist/helpers/convert-to-local-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-to-local-ref.d.ts","sourceRoot":"","sources":["../../src/helpers/convert-to-local-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,MAAM,EACX,gBAAgB,MAAM,EACtB,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,MAAM,GAAG,SA8BX,CAAA"}

package/dist/helpers/convert-to-local-ref.js

@@ -0,0 +1,26 @@
+const convertToLocalRef = (ref, currentContext, schemas) => {
+  const [baseUrl, pathOrAnchor] = ref.split("#", 2);
+  if (baseUrl) {
+    if (!schemas.has(baseUrl)) {
+      return void 0;
+    }
+    if (!pathOrAnchor) {
+      return schemas.get(baseUrl);
+    }
+    if (pathOrAnchor.startsWith("/")) {
+      return `${schemas.get(baseUrl)}${pathOrAnchor}`;
+    }
+    return schemas.get(`${baseUrl}#${pathOrAnchor}`);
+  }
+  if (pathOrAnchor) {
+    if (pathOrAnchor.startsWith("/")) {
+      return pathOrAnchor.slice(1);
+    }
+    return schemas.get(`${currentContext}#${pathOrAnchor}`);
+  }
+  return void 0;
+};
+export {
+  convertToLocalRef
+};
+//# sourceMappingURL=convert-to-local-ref.js.map

package/dist/helpers/convert-to-local-ref.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/convert-to-local-ref.ts"],
+  "sourcesContent": ["/**\n * Translates a JSON Reference ($ref) to a local object path within the root schema.\n *\n * @param ref - The JSON Reference string (e.g., \"#/foo/bar\", \"other.json#/baz\", \"other.json#anchor\")\n * @param currentContext - The current base context (usually the $id of the current schema or parent)\n * @param schemas - A map of schema identifiers ($id, $anchor) to their local object paths\n * @returns The local object path as a string, or undefined if the reference cannot be resolved\n */\nexport const convertToLocalRef = (\n  ref: string,\n  currentContext: string,\n  schemas: Map<string, string>,\n): string | undefined => {\n  // Split the reference into base URL and path/anchor (e.g., \"foo.json#/bar\" => [\"foo.json\", \"/bar\"])\n  const [baseUrl, pathOrAnchor] = ref.split('#', 2)\n\n  if (baseUrl) {\n    if (!schemas.has(baseUrl)) {\n      return undefined\n    }\n\n    if (!pathOrAnchor) {\n      return schemas.get(baseUrl)\n    }\n\n    // If the pathOrAnchor is a JSON pointer, we need to append it to the baseUrl\n    if (pathOrAnchor.startsWith('/')) {\n      return `${schemas.get(baseUrl)}${pathOrAnchor}`\n    }\n\n    // If the pathOrAnchor is an anchor, we need to return the anchor\n    return schemas.get(`${baseUrl}#${pathOrAnchor}`)\n  }\n\n  if (pathOrAnchor) {\n    if (pathOrAnchor.startsWith('/')) {\n      return pathOrAnchor.slice(1)\n    }\n    return schemas.get(`${currentContext}#${pathOrAnchor}`)\n  }\n\n  return undefined\n}\n"],
+  "mappings": "AAQO,MAAM,oBAAoB,CAC/B,KACA,gBACA,YACuB;AAEvB,QAAM,CAAC,SAAS,YAAY,IAAI,IAAI,MAAM,KAAK,CAAC;AAEhD,MAAI,SAAS;AACX,QAAI,CAAC,QAAQ,IAAI,OAAO,GAAG;AACzB,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,cAAc;AACjB,aAAO,QAAQ,IAAI,OAAO;AAAA,IAC5B;AAGA,QAAI,aAAa,WAAW,GAAG,GAAG;AAChC,aAAO,GAAG,QAAQ,IAAI,OAAO,CAAC,GAAG,YAAY;AAAA,IAC/C;AAGA,WAAO,QAAQ,IAAI,GAAG,OAAO,IAAI,YAAY,EAAE;AAAA,EACjD;AAEA,MAAI,cAAc;AAChB,QAAI,aAAa,WAAW,GAAG,GAAG;AAChC,aAAO,aAAa,MAAM,CAAC;AAAA,IAC7B;AACA,WAAO,QAAQ,IAAI,GAAG,cAAc,IAAI,YAAY,EAAE;AAAA,EACxD;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/helpers/escape-json-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-json-pointer.d.ts","sourceRoot":"","sources":["../../src/helpers/escape-json-pointer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,UAE5C"}

package/dist/{utils → helpers}/escape-json-pointer.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/escape-json-pointer.ts"],
+  "sources": ["../../src/helpers/escape-json-pointer.ts"],
   "sourcesContent": ["/**\n * Escapes a JSON pointer string.\n *\n * Example: `/foo/bar~baz` -> `/foo~1bar~0baz`\n */\nexport function escapeJsonPointer(str: string) {\n  return str.replace(/~/g, '~0').replace(/\\//g, '~1')\n}\n"],
   "mappings": "AAKO,SAAS,kBAAkB,KAAa;AAC7C,SAAO,IAAI,QAAQ,MAAM,IAAI,EAAE,QAAQ,OAAO,IAAI;AACpD;",
   "names": []

package/dist/helpers/get-schemas.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Retrieves the $id property from the input object if it exists and is a string.
+ *
+ * @param input - The object to extract the $id from.
+ * @returns The $id string if present, otherwise undefined.
+ */
+export declare const getId: (input: unknown) => string | undefined;
+/**
+ * Recursively traverses the input object to collect all schemas identified by $id and $anchor properties.
+ *
+ * - If an object has a $id property, it is added to the map with its $id as the key.
+ * - If an object has a $anchor property, it is added to the map with a key composed of the current base and the anchor.
+ * - The function performs a depth-first search (DFS) through all nested objects.
+ *
+ * @param input - The input object to traverse.
+ * @param base - The current base URI, used for resolving anchors.
+ * @param map - The map collecting found schemas.
+ * @returns A map of schema identifiers to their corresponding objects.
+ */
+export declare const getSchemas: (input: unknown, base?: string, segments?: string[], map?: Map<string, string>, visited?: WeakSet<object>) => Map<string, string>;
+//# sourceMappingURL=get-schemas.d.ts.map

package/dist/helpers/get-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-schemas.d.ts","sourceRoot":"","sources":["../../src/helpers/get-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAK/C,CAAA;AAYD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,OAAO,EACd,OAAM,MAAW,EACjB,WAAU,MAAM,EAAO,EACvB,yBAA+B,EAC/B,yBAAuB,wBAuCxB,CAAA"}

package/dist/helpers/get-schemas.js

@@ -0,0 +1,37 @@
+const getId = (input) => {
+  if (input && typeof input === "object" && input["$id"] && typeof input["$id"] === "string") {
+    return input["$id"];
+  }
+  return void 0;
+};
+const getPath = (segments) => {
+  return segments.join("/");
+};
+const getSchemas = (input, base = "", segments = [], map = /* @__PURE__ */ new Map(), visited = /* @__PURE__ */ new WeakSet()) => {
+  if (typeof input !== "object" || input === null) {
+    return map;
+  }
+  if (visited.has(input)) {
+    return map;
+  }
+  visited.add(input);
+  const id = getId(input);
+  if (id) {
+    map.set(id, getPath(segments));
+  }
+  const newBase = id ?? base;
+  if (input["$anchor"] && typeof input["$anchor"] === "string") {
+    map.set(`${newBase}#${input["$anchor"]}`, getPath(segments));
+  }
+  for (const key in input) {
+    if (typeof input[key] === "object" && input[key] !== null) {
+      getSchemas(input[key], newBase, [...segments, key], map, visited);
+    }
+  }
+  return map;
+};
+export {
+  getId,
+  getSchemas
+};
+//# sourceMappingURL=get-schemas.js.map

package/dist/helpers/get-schemas.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/get-schemas.ts"],
+  "sourcesContent": ["/**\n * Retrieves the $id property from the input object if it exists and is a string.\n *\n * @param input - The object to extract the $id from.\n * @returns The $id string if present, otherwise undefined.\n */\nexport const getId = (input: unknown): string | undefined => {\n  if (input && typeof input === 'object' && input['$id'] && typeof input['$id'] === 'string') {\n    return input['$id']\n  }\n  return undefined\n}\n\n/**\n * Joins an array of path segments into a single string separated by '/'.\n *\n * @param segments - The array of path segments.\n * @returns The joined path string.\n */\nconst getPath = (segments: string[]): string => {\n  return segments.join('/')\n}\n\n/**\n * Recursively traverses the input object to collect all schemas identified by $id and $anchor properties.\n *\n * - If an object has a $id property, it is added to the map with its $id as the key.\n * - If an object has a $anchor property, it is added to the map with a key composed of the current base and the anchor.\n * - The function performs a depth-first search (DFS) through all nested objects.\n *\n * @param input - The input object to traverse.\n * @param base - The current base URI, used for resolving anchors.\n * @param map - The map collecting found schemas.\n * @returns A map of schema identifiers to their corresponding objects.\n */\nexport const getSchemas = (\n  input: unknown,\n  base: string = '',\n  segments: string[] = [],\n  map = new Map<string, string>(),\n  visited = new WeakSet(),\n) => {\n  // Only process non-null objects\n  if (typeof input !== 'object' || input === null) {\n    return map\n  }\n\n  // If the object has already been visited, return the map\n  if (visited.has(input)) {\n    return map\n  }\n\n  // Add the object to the visited set\n  visited.add(input)\n\n  // Attempt to get $id from the current object\n  const id = getId(input)\n\n  // If $id exists, add the object to the map with $id as the key\n  if (id) {\n    map.set(id, getPath(segments))\n  }\n\n  // Update the base for nested anchors\n  const newBase = id ?? base\n\n  // If $anchor exists, add the object to the map with base#anchor as the key\n  if (input['$anchor'] && typeof input['$anchor'] === 'string') {\n    map.set(`${newBase}#${input['$anchor']}`, getPath(segments))\n  }\n\n  // Recursively traverse all properties (DFS)\n  for (const key in input) {\n    if (typeof input[key] === 'object' && input[key] !== null) {\n      getSchemas(input[key], newBase, [...segments, key], map, visited)\n    }\n  }\n\n  return map\n}\n"],
+  "mappings": "AAMO,MAAM,QAAQ,CAAC,UAAuC;AAC3D,MAAI,SAAS,OAAO,UAAU,YAAY,MAAM,KAAK,KAAK,OAAO,MAAM,KAAK,MAAM,UAAU;AAC1F,WAAO,MAAM,KAAK;AAAA,EACpB;AACA,SAAO;AACT;AAQA,MAAM,UAAU,CAAC,aAA+B;AAC9C,SAAO,SAAS,KAAK,GAAG;AAC1B;AAcO,MAAM,aAAa,CACxB,OACA,OAAe,IACf,WAAqB,CAAC,GACtB,MAAM,oBAAI,IAAoB,GAC9B,UAAU,oBAAI,QAAQ,MACnB;AAEH,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,QAAQ,IAAI,KAAK,GAAG;AACtB,WAAO;AAAA,EACT;AAGA,UAAQ,IAAI,KAAK;AAGjB,QAAM,KAAK,MAAM,KAAK;AAGtB,MAAI,IAAI;AACN,QAAI,IAAI,IAAI,QAAQ,QAAQ,CAAC;AAAA,EAC/B;AAGA,QAAM,UAAU,MAAM;AAGtB,MAAI,MAAM,SAAS,KAAK,OAAO,MAAM,SAAS,MAAM,UAAU;AAC5D,QAAI,IAAI,GAAG,OAAO,IAAI,MAAM,SAAS,CAAC,IAAI,QAAQ,QAAQ,CAAC;AAAA,EAC7D;AAGA,aAAW,OAAO,OAAO;AACvB,QAAI,OAAO,MAAM,GAAG,MAAM,YAAY,MAAM,GAAG,MAAM,MAAM;AACzD,iBAAW,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,UAAU,GAAG,GAAG,KAAK,OAAO;AAAA,IAClE;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/helpers/get-segments-from-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-segments-from-path.d.ts","sourceRoot":"","sources":["../../src/helpers/get-segments-from-path.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,YAW/C"}

package/dist/{utils → helpers}/get-segments-from-path.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/get-segments-from-path.ts"],
+  "sources": ["../../src/helpers/get-segments-from-path.ts"],
   "sourcesContent": ["import { unescapeJsonPointer } from './unescape-json-pointer'\n\n/**\n * Translate `/paths/~1test` to `['paths', '/test']`\n */\nexport function getSegmentsFromPath(path: string) {\n  return (\n    // /paths/~1test\n    path\n      // ['', 'paths', '~1test']\n      .split('/')\n      // ['paths', '~test']\n      .slice(1)\n      // ['paths', '/test']\n      .map(unescapeJsonPointer)\n  )\n}\n"],
   "mappings": "AAAA,SAAS,2BAA2B;AAK7B,SAAS,oBAAoB,MAAc;AAChD;AAAA;AAAA,IAEE,KAEG,MAAM,GAAG,EAET,MAAM,CAAC,EAEP,IAAI,mBAAmB;AAAA;AAE9B;",
   "names": []

package/dist/helpers/get-value-by-path.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Traverses an object using an array of string segments (path keys) and returns
+ * the value at the specified path along with its context (id if available).
+ *
+ * @param target - The root object to traverse.
+ * @param segments - An array of string keys representing the path to traverse.
+ * @returns An object containing the final context (id or previous context) and the value at the path.
+ *
+ * @example
+ * const obj = {
+ *   foo: {
+ *     bar: {
+ *       baz: 42
+ *     }
+ *   }
+ * };
+ * // Returns: { context: '', value: 42 }
+ * getValueByPath(obj, ['foo', 'bar', 'baz']);
+ */
+export declare function getValueByPath(target: unknown, segments: string[]): {
+    context: string;
+    value: any;
+};
+//# sourceMappingURL=get-value-by-path.d.ts.map

package/dist/helpers/get-value-by-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-value-by-path.d.ts","sourceRoot":"","sources":["../../src/helpers/get-value-by-path.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAsBnG"}

package/dist/helpers/get-value-by-path.js

@@ -0,0 +1,23 @@
+import { getId } from "../helpers/get-schemas.js";
+function getValueByPath(target, segments) {
+  return segments.reduce(
+    (acc, key) => {
+      if (acc.value === void 0) {
+        return { context: "", value: void 0 };
+      }
+      if (typeof acc.value !== "object" || acc.value === null) {
+        return { context: "", value: void 0 };
+      }
+      const id = getId(acc.value);
+      return { context: id ?? acc.context, value: acc.value?.[key] };
+    },
+    {
+      context: "",
+      value: target
+    }
+  );
+}
+export {
+  getValueByPath
+};
+//# sourceMappingURL=get-value-by-path.js.map

package/dist/helpers/get-value-by-path.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/get-value-by-path.ts"],
+  "sourcesContent": ["import { getId } from '@/helpers/get-schemas'\n\n/**\n * Traverses an object using an array of string segments (path keys) and returns\n * the value at the specified path along with its context (id if available).\n *\n * @param target - The root object to traverse.\n * @param segments - An array of string keys representing the path to traverse.\n * @returns An object containing the final context (id or previous context) and the value at the path.\n *\n * @example\n * const obj = {\n *   foo: {\n *     bar: {\n *       baz: 42\n *     }\n *   }\n * };\n * // Returns: { context: '', value: 42 }\n * getValueByPath(obj, ['foo', 'bar', 'baz']);\n */\nexport function getValueByPath(target: unknown, segments: string[]): { context: string; value: any } {\n  return segments.reduce<{ context: string; value: unknown }>(\n    (acc, key) => {\n      // If the accumulator is undefined, the path does not exist\n      if (acc.value === undefined) {\n        return { context: '', value: undefined }\n      }\n      // If the accumulator is not an object or is null, stop traversal\n      if (typeof acc.value !== 'object' || acc.value === null) {\n        return { context: '', value: undefined }\n      }\n      // Attempt to get the id from the current value for context tracking\n      const id = getId(acc.value)\n\n      // Return the next context and value for the next iteration\n      return { context: id ?? acc.context, value: acc.value?.[key] }\n    },\n    {\n      context: '',\n      value: target,\n    },\n  )\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AAqBf,SAAS,eAAe,QAAiB,UAAqD;AACnG,SAAO,SAAS;AAAA,IACd,CAAC,KAAK,QAAQ;AAEZ,UAAI,IAAI,UAAU,QAAW;AAC3B,eAAO,EAAE,SAAS,IAAI,OAAO,OAAU;AAAA,MACzC;AAEA,UAAI,OAAO,IAAI,UAAU,YAAY,IAAI,UAAU,MAAM;AACvD,eAAO,EAAE,SAAS,IAAI,OAAO,OAAU;AAAA,MACzC;AAEA,YAAM,KAAK,MAAM,IAAI,KAAK;AAG1B,aAAO,EAAE,SAAS,MAAM,IAAI,SAAS,OAAO,IAAI,QAAQ,GAAG,EAAE;AAAA,IAC/D;AAAA,IACA;AAAA,MACE,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/helpers/is-json-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-json-object.d.ts","sourceRoot":"","sources":["../../src/helpers/is-json-object.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,WAYzC"}

package/dist/{utils → helpers}/is-json-object.js

@@ -1,4 +1,4 @@
-import { isObject } from "../utils/is-object.js";
+import { isObject } from "../helpers/is-object.js";
 function isJsonObject(value) {
   if (!/^\s*(\{)/.test(value.slice(0, 500))) {
     return false;

package/dist/helpers/is-json-object.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/is-json-object.ts"],
+  "sourcesContent": ["import { isObject } from '@/helpers/is-object'\n\n/**\n * Determines if a string represents a valid JSON object (i.e., a plain object, not an array, primitive, or null).\n * The function first checks if the string appears to start with an opening curly brace (ignoring leading whitespace),\n * which is a quick heuristic to rule out arrays, primitives, and most invalid JSON. If this check passes,\n * it attempts to parse the string with JSON.parse. The result is then checked to ensure it is a plain object\n * (not an array, null, or primitive) using the isObject utility.\n *\n * @param value - The string to evaluate\n * @returns true if the string is valid JSON and parses to a plain object, false otherwise\n *\n * @example\n * isJsonObject('{\"foo\": \"bar\"}') // true\n * isJsonObject('[1,2,3]') // false\n * isJsonObject('not json') // false\n * isJsonObject('42') // false\n */\nexport function isJsonObject(value: string) {\n  // Quickly rule out anything that doesn't start with an object brace\n  if (!/^\\s*(\\{)/.test(value.slice(0, 500))) {\n    return false\n  }\n\n  try {\n    const val = JSON.parse(value)\n    return isObject(val)\n  } catch {\n    return false\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AAkBlB,SAAS,aAAa,OAAe;AAE1C,MAAI,CAAC,WAAW,KAAK,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG;AACzC,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,MAAM,KAAK,MAAM,KAAK;AAC5B,WAAO,SAAS,GAAG;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/helpers/is-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-object.d.ts","sourceRoot":"","sources":["../../src/helpers/is-object.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,MAAwE,CAAA"}

package/dist/{utils → helpers}/is-object.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/is-object.ts"],
+  "sources": ["../../src/helpers/is-object.ts"],
   "sourcesContent": ["/**\n * Check if the given value is an object\n */\nexport const isObject = (obj: any): obj is object => typeof obj === 'object' && !Array.isArray(obj) && obj !== null\n"],
   "mappings": "AAGO,MAAM,WAAW,CAAC,QAA4B,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ,GAAG,KAAK,QAAQ;",
   "names": []

package/dist/helpers/is-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-yaml.d.ts","sourceRoot":"","sources":["../../src/helpers/is-yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7C"}

package/dist/{utils → helpers}/is-yaml.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/is-yaml.ts"],
+  "sources": ["../../src/helpers/is-yaml.ts"],
   "sourcesContent": ["/**\n * Checks if a string appears to be YAML content.\n * This function uses a simple heuristic: it looks for a line that starts with an optional dash,\n * followed by a key (alphanumeric or dash), a colon, and a value, and then at least one more line.\n * This is not a full YAML parser, but works for basic detection.\n *\n * @param value - The string to check\n * @returns true if the string looks like YAML, false otherwise\n *\n * @example\n * isYaml('openapi: 3.0.0\\ninfo:\\n  title: Example') // true\n * isYaml('{\"openapi\": \"3.0.0\", \"info\": {\"title\": \"Example\"}}') // false\n * isYaml('- name: value\\n- name: value2') // true\n * isYaml('type: object') // false (only one line)\n */\nexport function isYaml(value: string): boolean {\n  return /^\\s*(?:-\\s*)?[\\w\\-]+\\s*:\\s*.+\\n.*/.test(value)\n}\n"],
   "mappings": "AAeO,SAAS,OAAO,OAAwB;AAC7C,SAAO,oCAAoC,KAAK,KAAK;AACvD;",
   "names": []

package/dist/{utils → helpers}/json-path-utils.d.ts

@@ -9,17 +9,6 @@
  * ```
  */
 export declare function parseJsonPointer(pointer: string): string[];
-/**
- * Retrieves a nested value from the source document using a path array
- *
- * @example
- * ```ts
- * getValueByPath(document, ['components', 'schemas', 'User'])
- *
- * { id: '123', name: 'John Doe' }
- * ```
- */
-export declare function getValueByPath<R = unknown>(obj: any, pointer: string[]): R;
 /**
  * Creates a nested path in an object from an array of path segments.
  * Only creates intermediate objects/arrays if they don't already exist.

package/dist/helpers/json-path-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-path-utils.d.ts","sourceRoot":"","sources":["../../src/helpers/json-path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAWlE"}

package/dist/{utils → helpers}/json-path-utils.js

@@ -1,14 +1,6 @@
 function parseJsonPointer(pointer) {
   return pointer.split("/").filter((segment, index) => (index !== 0 || segment !== "#") && segment);
 }
-function getValueByPath(obj, pointer) {
-  return pointer.reduce((acc, part) => {
-    if (acc === void 0 || acc === null) {
-      return void 0;
-    }
-    return acc[part];
-  }, obj);
-}
 function createPathFromSegments(obj, segments) {
   return segments.reduce((acc, part) => {
     if (acc[part] === void 0) {
@@ -23,7 +15,6 @@ function createPathFromSegments(obj, segments) {
 }
 export {
   createPathFromSegments,
-  getValueByPath,
   parseJsonPointer
 };
 //# sourceMappingURL=json-path-utils.js.map

package/dist/helpers/json-path-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/json-path-utils.ts"],
+  "sourcesContent": ["/**\n * Parses a JSON Pointer string into an array of path segments\n *\n * @example\n * ```ts\n * parseJsonPointer('#/components/schemas/User')\n *\n * ['components', 'schemas', 'User']\n * ```\n */\nexport function parseJsonPointer(pointer: string): string[] {\n  return (\n    pointer\n      // Split on '/'\n      .split('/')\n      // Remove the leading '#' if present\n      .filter((segment, index) => (index !== 0 || segment !== '#') && segment)\n  )\n}\n\n/**\n * Creates a nested path in an object from an array of path segments.\n * Only creates intermediate objects/arrays if they don't already exist.\n *\n * @param obj - The target object to create the path in\n * @param segments - Array of path segments to create\n * @returns The final nested object/array at the end of the path\n *\n * @example\n * ```ts\n * const obj = {}\n * createPathFromSegments(obj, ['components', 'schemas', 'User'])\n * // Creates: { components: { schemas: { User: {} } } }\n *\n * createPathFromSegments(obj, ['items', '0', 'name'])\n * // Creates: { items: [{ name: {} }] }\n * ```\n */\nexport function createPathFromSegments(obj: any, segments: string[]) {\n  return segments.reduce((acc, part) => {\n    if (acc[part] === undefined) {\n      if (isNaN(Number(part))) {\n        acc[part] = {}\n      } else {\n        acc[part] = []\n      }\n    }\n    return acc[part]\n  }, obj)\n}\n"],
+  "mappings": "AAUO,SAAS,iBAAiB,SAA2B;AAC1D,SACE,QAEG,MAAM,GAAG,EAET,OAAO,CAAC,SAAS,WAAW,UAAU,KAAK,YAAY,QAAQ,OAAO;AAE7E;AAoBO,SAAS,uBAAuB,KAAU,UAAoB;AACnE,SAAO,SAAS,OAAO,CAAC,KAAK,SAAS;AACpC,QAAI,IAAI,IAAI,MAAM,QAAW;AAC3B,UAAI,MAAM,OAAO,IAAI,CAAC,GAAG;AACvB,YAAI,IAAI,IAAI,CAAC;AAAA,MACf,OAAO;AACL,YAAI,IAAI,IAAI,CAAC;AAAA,MACf;AAAA,IACF;AACA,WAAO,IAAI,IAAI;AAAA,EACjB,GAAG,GAAG;AACR;",
+  "names": []
+}

package/dist/helpers/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/helpers/normalize.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,GAAG,OA4BrC"}

package/dist/{utils → helpers}/normalize.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/normalize.ts"],
+  "sources": ["../../src/helpers/normalize.ts"],
   "sourcesContent": ["import { parse } from 'yaml'\n\n/**\n * Normalize a string (YAML, JSON, object) to a JavaScript datatype.\n */\nexport function normalize(content: any) {\n  if (content === null) {\n    return undefined\n  }\n\n  if (typeof content === 'string') {\n    if (content.trim() === '') {\n      return undefined\n    }\n\n    try {\n      return JSON.parse(content)\n    } catch (_error) {\n      // Does it look like YAML?\n      const hasColon = /^[^:]+:/.test(content)\n      const isJson = content.slice(0, 50).trimStart().startsWith('{')\n\n      if (!hasColon || isJson) {\n        return undefined\n      }\n\n      return parse(content, {\n        maxAliasCount: 10000,\n      })\n    }\n  }\n\n  return content\n}\n"],
   "mappings": "AAAA,SAAS,aAAa;AAKf,SAAS,UAAU,SAAc;AACtC,MAAI,YAAY,MAAM;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,YAAY,UAAU;AAC/B,QAAI,QAAQ,KAAK,MAAM,IAAI;AACzB,aAAO;AAAA,IACT;AAEA,QAAI;AACF,aAAO,KAAK,MAAM,OAAO;AAAA,IAC3B,SAAS,QAAQ;AAEf,YAAM,WAAW,UAAU,KAAK,OAAO;AACvC,YAAM,SAAS,QAAQ,MAAM,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,GAAG;AAE9D,UAAI,CAAC,YAAY,QAAQ;AACvB,eAAO;AAAA,MACT;AAEA,aAAO,MAAM,SAAS;AAAA,QACpB,eAAe;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF;AAEA,SAAO;AACT;",
   "names": []

package/dist/helpers/unescape-json-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unescape-json-pointer.d.ts","sourceRoot":"","sources":["../../src/helpers/unescape-json-pointer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,UAE9C"}

package/dist/{utils → helpers}/unescape-json-pointer.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/unescape-json-pointer.ts"],
+  "sources": ["../../src/helpers/unescape-json-pointer.ts"],
   "sourcesContent": ["/**\n * Unescape JSON pointer\n *\n * Examples:\n * /foo~1bar~0baz -> /foo/bar~baz\n */\nexport function unescapeJsonPointer(uri: string) {\n  return decodeURI(uri.replace(/~1/g, '/').replace(/~0/g, '~'))\n}\n"],
   "mappings": "AAMO,SAAS,oBAAoB,KAAa;AAC/C,SAAO,UAAU,IAAI,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,CAAC;AAC9D;",
   "names": []

package/dist/magic-proxy/proxy.d.ts

@@ -3,16 +3,16 @@ import type { UnknownObject } from '../types.js';
  * Creates a "magic" proxy for a given object or array, enabling transparent access to
  * JSON Reference ($ref) values as if they were directly present on the object.
  *
- * - If an object contains a `$ref` property, accessing the special `$ref-value` property
- *   will resolve and return the referenced value from the root object.
- * - All nested objects and arrays are recursively wrapped in proxies, so reference resolution
- *   works at any depth.
- * - Properties starting with an underscore (_) are hidden and will not be accessible through
- *   the proxy (returns undefined on access, false on 'in' checks, excluded from enumeration).
+ * Features:
+ * - If an object contains a `$ref` property, accessing the special `$ref-value` property will resolve and return the referenced value from the root object.
+ * - All nested objects and arrays are recursively wrapped in proxies, so reference resolution works at any depth.
+ * - Properties starting with an underscore (_) are considered internal and are hidden by default: they return undefined on access, are excluded from enumeration, and `'in'` checks return false. This can be overridden with the `showInternal` option.
  * - Setting, deleting, and enumerating properties works as expected, including for proxied references.
+ * - Ensures referential stability by caching proxies for the same target object.
  *
  * @param target - The object or array to wrap in a magic proxy
- * @param root - The root object for resolving local JSON references (defaults to target)
+ * @param options - Optional settings (e.g., showInternal to expose internal properties)
+ * @param args - Internal arguments for advanced usage (root object, proxy/cache maps, current context)
  * @returns A proxied version of the input object/array with magic $ref-value support
  *
  * @example
@@ -37,9 +37,34 @@ import type { UnknownObject } from '../types.js';
  * proxy.refObj.extra = 'hello'
  * delete proxy.refObj.extra
  */
-export declare const createMagicProxy: <T extends Record<keyof T & symbol, unknown>, S extends UnknownObject>(target: T, options?: {
-    showInternal?: boolean;
-}, root?: S | T, cache?: Map<string, unknown>, proxyCache?: WeakMap<object, T>) => T;
+export declare const createMagicProxy: <T extends Record<keyof T & symbol, unknown>, S extends UnknownObject>(target: T, options?: Partial<{
+    showInternal: boolean;
+}>, args?: {
+    /**
+     * The root object for resolving local JSON references.
+     */
+    root: S | T;
+    /**
+     * Cache to store already created proxies for target objects to ensure referential stability.
+     *
+     * It is helpful when dealing with reactive frameworks like Vue,
+     */
+    proxyCache: WeakMap<object, T>;
+    /**
+     * Cache to store resolved JSON references.
+     */
+    cache: Map<string, unknown>;
+    /**
+     * Map of all schemas by their $id or $anchor for cross-document reference resolution.
+     */
+    schemas: Map<string, string>;
+    /**
+     * The current JSON path context within the root object.
+     *
+     * Used to resolve $anchor references correctly.
+     */
+    currentContext: string;
+}) => T;
 /**
  * Gets the raw (non-proxied) version of an object created by createMagicProxy.
  * This is useful when you need to access the original object without the magic proxy wrapper.

package/dist/magic-proxy/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/magic-proxy/proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAW5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,aAAa,EACnG,QAAQ,CAAC,EACT,UAAU;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,EACpC,OAAM,CAAC,GAAG,CAAU,EACpB,4BAAkC,EAClC,+BAAqC,MAsLtC,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAUnC"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/magic-proxy/proxy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAQ5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,aAAa,EACnG,QAAQ,CAAC,EACT,UAAU,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,EAC5C,OAAM;IACJ;;OAEG;IACH,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;IACX;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9B;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3B;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAA;CAOvB,MAyMF,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAUnC"}

package/dist/magic-proxy/proxy.js

@@ -1,17 +1,24 @@
-import { isLocalRef } from "../bundle/bundle.js";
-import { getSegmentsFromPath } from "../utils/get-segments-from-path.js";
-import { isObject } from "../utils/is-object.js";
-import { createPathFromSegments, getValueByPath, parseJsonPointer } from "../utils/json-path-utils.js";
+import { convertToLocalRef } from "../helpers/convert-to-local-ref.js";
+import { getId, getSchemas } from "../helpers/get-schemas.js";
+import { getValueByPath } from "../helpers/get-value-by-path.js";
+import { isObject } from "../helpers/is-object.js";
+import { createPathFromSegments, parseJsonPointer } from "../helpers/json-path-utils.js";
 const isMagicProxy = Symbol("isMagicProxy");
 const magicProxyTarget = Symbol("magicProxyTarget");
 const REF_VALUE = "$ref-value";
 const REF_KEY = "$ref";
-const createMagicProxy = (target, options, root = target, cache = /* @__PURE__ */ new Map(), proxyCache = /* @__PURE__ */ new WeakMap()) => {
+const createMagicProxy = (target, options, args = {
+  root: target,
+  proxyCache: /* @__PURE__ */ new WeakMap(),
+  cache: /* @__PURE__ */ new Map(),
+  schemas: getSchemas(target),
+  currentContext: ""
+}) => {
   if (!isObject(target) && !Array.isArray(target)) {
     return target;
   }
-  if (proxyCache.has(target)) {
-    return proxyCache.get(target);
+  if (args.proxyCache.has(target)) {
+    return args.proxyCache.get(target);
   }
   const handler = {
     /**
@@ -29,21 +36,29 @@ const createMagicProxy = (target, options, root = target, cache = /* @__PURE__ *
       if (prop === magicProxyTarget) {
         return target2;
       }
-      const ref = Reflect.get(target2, REF_KEY, receiver);
       if (typeof prop === "string" && prop.startsWith("_") && !options?.showInternal) {
         return void 0;
       }
-      if (prop === REF_VALUE && typeof ref === "string" && isLocalRef(ref)) {
-        if (cache.has(ref)) {
-          return cache.get(ref);
+      const ref = Reflect.get(target2, REF_KEY, receiver);
+      const id = getId(target2);
+      if (prop === REF_VALUE && typeof ref === "string") {
+        if (args.cache.has(ref)) {
+          return args.cache.get(ref);
         }
-        const resolvedValue = getValueByPath(root, parseJsonPointer(ref));
-        const proxiedValue = createMagicProxy(resolvedValue, options, root, cache);
-        cache.set(ref, proxiedValue);
+        const path = convertToLocalRef(ref, id ?? args.currentContext, args.schemas);
+        if (path === void 0) {
+          return void 0;
+        }
+        const resolvedValue = getValueByPath(args.root, parseJsonPointer(`#/${path}`));
+        const proxiedValue = createMagicProxy(resolvedValue.value, options, {
+          ...args,
+          currentContext: resolvedValue.context
+        });
+        args.cache.set(ref, proxiedValue);
         return proxiedValue;
       }
       const value = Reflect.get(target2, prop, receiver);
-      return createMagicProxy(value, options, root, cache, proxyCache);
+      return createMagicProxy(value, options, { ...args, currentContext: id ?? args.currentContext });
     },
     /**
      * Proxy "set" trap for magic proxy.
@@ -58,14 +73,19 @@ const createMagicProxy = (target, options, root = target, cache = /* @__PURE__ *
       if (typeof prop === "string" && prop.startsWith("_") && !options?.showInternal) {
         return true;
       }
-      if (prop === REF_VALUE && typeof ref === "string" && isLocalRef(ref)) {
-        const segments = getSegmentsFromPath(ref);
+      if (prop === REF_VALUE && typeof ref === "string") {
+        const id = getId(target2);
+        const path = convertToLocalRef(ref, id ?? args.currentContext, args.schemas);
+        if (path === void 0) {
+          return void 0;
+        }
+        const segments = parseJsonPointer(`#/${path}`);
         if (segments.length === 0) {
           return false;
         }
-        const getParentNode = () => getValueByPath(root, segments.slice(0, -1));
+        const getParentNode = () => getValueByPath(args.root, segments.slice(0, -1)).value;
         if (getParentNode() === void 0) {
-          createPathFromSegments(root, segments.slice(0, -1));
+          createPathFromSegments(args.root, segments.slice(0, -1));
           console.warn(
             `Trying to set $ref-value for invalid reference: ${ref}
 
@@ -144,7 +164,7 @@ Please fix your input file to fix this issue.`
     }
   };
   const proxied = new Proxy(target, handler);
-  proxyCache.set(target, proxied);
+  args.proxyCache.set(target, proxied);
   return proxied;
 };
 function getRaw(obj) {