@stryke/json 0.9.44 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 # Changelog for Stryke - JSON
 
+## [0.9.44](https://github.com/storm-software/stryke/releases/tag/json%400.9.44) (03/02/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.26**
+- Updated **types** to **v0.10.40**
+
 ## [0.9.43](https://github.com/storm-software/stryke/releases/tag/json%400.9.43) (02/09/2026)
 
 ### Updated Dependencies

package/dist/code-frames-BMkA9i6j.d.mts

@@ -0,0 +1,17 @@
+//#region src/utils/code-frames.d.ts
+interface Location {
+  column: number;
+  line: number;
+}
+interface NodeLocation {
+  end?: Location;
+  start?: Location;
+}
+declare function codeFrameColumns(rawLines: string, loc: NodeLocation, opts?: {
+  linesAbove?: number;
+  linesBelow?: number;
+  highlight?: (rawLines: string) => string;
+}): string;
+//#endregion
+export { codeFrameColumns as t };
+//# sourceMappingURL=code-frames-BMkA9i6j.d.mts.map

package/dist/code-frames-BMkA9i6j.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-frames-BMkA9i6j.d.mts","names":[],"sources":["../src/utils/code-frames.ts"],"sourcesContent":[],"mappings":";UAkBU,QAAA;EAAA,MAAA,EAAA,MAAQ;EAKR,IAAA,EAAA,MAAA;AAoFV;UApFU,YAAA;QACF;UACE;;iBAkFM,gBAAA,wBAET"}

package/dist/code-frames-BUtrssZ5.d.cts

@@ -0,0 +1,17 @@
+//#region src/utils/code-frames.d.ts
+interface Location {
+  column: number;
+  line: number;
+}
+interface NodeLocation {
+  end?: Location;
+  start?: Location;
+}
+declare function codeFrameColumns(rawLines: string, loc: NodeLocation, opts?: {
+  linesAbove?: number;
+  linesBelow?: number;
+  highlight?: (rawLines: string) => string;
+}): string;
+//#endregion
+export { codeFrameColumns as t };
+//# sourceMappingURL=code-frames-BUtrssZ5.d.cts.map

package/dist/code-frames-BUtrssZ5.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-frames-BUtrssZ5.d.cts","names":[],"sources":["../src/utils/code-frames.ts"],"sourcesContent":[],"mappings":";UAkBU,QAAA;EAAA,MAAA,EAAA,MAAQ;EAKR,IAAA,EAAA,MAAA;AAoFV;UApFU,YAAA;QACF;UACE;;iBAkFM,gBAAA,wBAET"}

package/dist/code-frames-Cv8r5tSN.cjs

@@ -0,0 +1,82 @@
+
+//#region src/utils/code-frames.ts
+/**
+* RegExp to test for newlines in terminal.
+*/
+const NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
+/**
+* Extract what lines should be marked and highlighted.
+*/
+function getMarkerLines(loc, source, opts = {}) {
+	const startLoc = {
+		column: 0,
+		line: -1,
+		...loc.start
+	};
+	const endLoc = {
+		...startLoc,
+		...loc.end
+	};
+	const { linesAbove = 2, linesBelow = 3 } = opts || {};
+	const startLine = startLoc.line;
+	const startColumn = startLoc.column;
+	const endLine = endLoc.line;
+	const endColumn = endLoc.column;
+	let start = Math.max(startLine - (linesAbove + 1), 0);
+	let end = Math.min(source.length, endLine + linesBelow);
+	if (startLine === -1) start = 0;
+	if (endLine === -1) end = source.length;
+	const lineDiff = endLine - startLine;
+	const markerLines = {};
+	if (lineDiff) for (let i = 0; i <= lineDiff; i++) {
+		const lineNumber = i + startLine;
+		if (!startColumn) markerLines[lineNumber] = true;
+		else if (i === 0) markerLines[lineNumber] = [startColumn, (source[lineNumber - 1]?.length ?? 0) - startColumn + 1];
+		else if (i === lineDiff) markerLines[lineNumber] = [0, endColumn];
+		else markerLines[lineNumber] = [0, source[lineNumber - i]?.length ?? 0];
+	}
+	else if (startColumn === endColumn) markerLines[startLine] = startColumn ? [startColumn, 0] : true;
+	else markerLines[startLine] = [startColumn, endColumn - startColumn];
+	return {
+		start,
+		end,
+		markerLines
+	};
+}
+function codeFrameColumns(rawLines, loc, opts = {}) {
+	const { start, end, markerLines } = getMarkerLines(loc, rawLines.split(NEWLINE), opts);
+	const numberMaxWidth = String(end).length;
+	return (opts.highlight ? opts.highlight(rawLines) : rawLines).split(NEWLINE).slice(start, end).map((line, index) => {
+		const number = start + 1 + index;
+		const gutter = ` ${` ${number}`.slice(-numberMaxWidth)} | `;
+		const hasMarker = Boolean(markerLines[number] ?? false);
+		if (hasMarker) {
+			let markerLine = "";
+			if (Array.isArray(hasMarker)) {
+				const markerSpacing = line.slice(0, Math.max(hasMarker[0] - 1, 0)).replace(/[^\t]/g, " ");
+				const numberOfMarkers = hasMarker[1] || 1;
+				markerLine = [
+					"\n ",
+					gutter.replace(/\d/g, " "),
+					markerSpacing,
+					"^".repeat(numberOfMarkers)
+				].join("");
+			}
+			return [
+				">",
+				gutter,
+				line,
+				markerLine
+			].join("");
+		}
+		return ` ${gutter}${line}`;
+	}).join("\n");
+}
+
+//#endregion
+Object.defineProperty(exports, 'codeFrameColumns', {
+  enumerable: true,
+  get: function () {
+    return codeFrameColumns;
+  }
+});

package/dist/code-frames-DISWdYL6.mjs

@@ -0,0 +1,77 @@
+//#region src/utils/code-frames.ts
+/**
+* RegExp to test for newlines in terminal.
+*/
+const NEWLINE = /\r\n|[\n\r\u2028\u2029]/;
+/**
+* Extract what lines should be marked and highlighted.
+*/
+function getMarkerLines(loc, source, opts = {}) {
+	const startLoc = {
+		column: 0,
+		line: -1,
+		...loc.start
+	};
+	const endLoc = {
+		...startLoc,
+		...loc.end
+	};
+	const { linesAbove = 2, linesBelow = 3 } = opts || {};
+	const startLine = startLoc.line;
+	const startColumn = startLoc.column;
+	const endLine = endLoc.line;
+	const endColumn = endLoc.column;
+	let start = Math.max(startLine - (linesAbove + 1), 0);
+	let end = Math.min(source.length, endLine + linesBelow);
+	if (startLine === -1) start = 0;
+	if (endLine === -1) end = source.length;
+	const lineDiff = endLine - startLine;
+	const markerLines = {};
+	if (lineDiff) for (let i = 0; i <= lineDiff; i++) {
+		const lineNumber = i + startLine;
+		if (!startColumn) markerLines[lineNumber] = true;
+		else if (i === 0) markerLines[lineNumber] = [startColumn, (source[lineNumber - 1]?.length ?? 0) - startColumn + 1];
+		else if (i === lineDiff) markerLines[lineNumber] = [0, endColumn];
+		else markerLines[lineNumber] = [0, source[lineNumber - i]?.length ?? 0];
+	}
+	else if (startColumn === endColumn) markerLines[startLine] = startColumn ? [startColumn, 0] : true;
+	else markerLines[startLine] = [startColumn, endColumn - startColumn];
+	return {
+		start,
+		end,
+		markerLines
+	};
+}
+function codeFrameColumns(rawLines, loc, opts = {}) {
+	const { start, end, markerLines } = getMarkerLines(loc, rawLines.split(NEWLINE), opts);
+	const numberMaxWidth = String(end).length;
+	return (opts.highlight ? opts.highlight(rawLines) : rawLines).split(NEWLINE).slice(start, end).map((line, index) => {
+		const number = start + 1 + index;
+		const gutter = ` ${` ${number}`.slice(-numberMaxWidth)} | `;
+		const hasMarker = Boolean(markerLines[number] ?? false);
+		if (hasMarker) {
+			let markerLine = "";
+			if (Array.isArray(hasMarker)) {
+				const markerSpacing = line.slice(0, Math.max(hasMarker[0] - 1, 0)).replace(/[^\t]/g, " ");
+				const numberOfMarkers = hasMarker[1] || 1;
+				markerLine = [
+					"\n ",
+					gutter.replace(/\d/g, " "),
+					markerSpacing,
+					"^".repeat(numberOfMarkers)
+				].join("");
+			}
+			return [
+				">",
+				gutter,
+				line,
+				markerLine
+			].join("");
+		}
+		return ` ${gutter}${line}`;
+	}).join("\n");
+}
+
+//#endregion
+export { codeFrameColumns as t };
+//# sourceMappingURL=code-frames-DISWdYL6.mjs.map

package/dist/code-frames-DISWdYL6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-frames-DISWdYL6.mjs","names":["startLoc: Location","endLoc: Location"],"sources":["../src/utils/code-frames.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\ninterface Location {\n  column: number;\n  line: number;\n}\n\ninterface NodeLocation {\n  end?: Location;\n  start?: Location;\n}\n\n// Adapted from https://raw.githubusercontent.com/babel/babel/4108524/packages/babel-code-frame/src/index.js\n\n/**\n * RegExp to test for newlines in terminal.\n */\nconst NEWLINE = /\\r\\n|[\\n\\r\\u2028\\u2029]/;\n\n/**\n * Extract what lines should be marked and highlighted.\n */\nfunction getMarkerLines(\n  loc: NodeLocation,\n  source: string[],\n  opts: { linesAbove?: number; linesBelow?: number } = {}\n): {\n  start: number;\n  end: number;\n  markerLines: Record<number, boolean | [number, number]>;\n} {\n  const startLoc: Location = {\n    column: 0,\n    line: -1,\n    ...loc.start\n  };\n  const endLoc: Location = {\n    ...startLoc,\n    ...loc.end\n  };\n  const { linesAbove = 2, linesBelow = 3 } = opts || {};\n  const startLine = startLoc.line;\n  const startColumn = startLoc.column;\n  const endLine = endLoc.line;\n  const endColumn = endLoc.column;\n\n  let start = Math.max(startLine - (linesAbove + 1), 0);\n  let end = Math.min(source.length, endLine + linesBelow);\n\n  if (startLine === -1) {\n    start = 0;\n  }\n\n  if (endLine === -1) {\n    end = source.length;\n  }\n\n  const lineDiff = endLine - startLine;\n  const markerLines = {} as Record<number, boolean | [number, number]>;\n\n  if (lineDiff) {\n    for (let i = 0; i <= lineDiff; i++) {\n      const lineNumber = i + startLine;\n\n      if (!startColumn) {\n        markerLines[lineNumber] = true;\n      } else if (i === 0) {\n        const sourceLength = source[lineNumber - 1]?.length ?? 0;\n\n        markerLines[lineNumber] = [startColumn, sourceLength - startColumn + 1];\n      } else if (i === lineDiff) {\n        markerLines[lineNumber] = [0, endColumn];\n      } else {\n        const sourceLength = source[lineNumber - i]?.length ?? 0;\n\n        markerLines[lineNumber] = [0, sourceLength];\n      }\n    }\n  } else if (startColumn === endColumn) {\n    markerLines[startLine] = startColumn ? [startColumn, 0] : true;\n  } else {\n    markerLines[startLine] = [startColumn, endColumn - startColumn];\n  }\n\n  return {\n    start,\n    end,\n    markerLines\n  };\n}\n\nexport function codeFrameColumns(\n  rawLines: string,\n  loc: NodeLocation,\n  opts: {\n    linesAbove?: number;\n    linesBelow?: number;\n    highlight?: (rawLines: string) => string;\n  } = {}\n): string {\n  const lines = rawLines.split(NEWLINE);\n  const { start, end, markerLines } = getMarkerLines(loc, lines, opts);\n\n  const numberMaxWidth = String(end).length;\n  const highlightedLines = opts.highlight ? opts.highlight(rawLines) : rawLines;\n\n  const frame = highlightedLines\n    .split(NEWLINE)\n    .slice(start, end)\n    .map((line, index) => {\n      const number = start + 1 + index;\n      const paddedNumber = ` ${number}`.slice(-numberMaxWidth);\n      const gutter = ` ${paddedNumber} | `;\n      const hasMarker = Boolean(markerLines[number] ?? false);\n      if (hasMarker) {\n        let markerLine = \"\";\n        if (Array.isArray(hasMarker)) {\n          const markerSpacing = line\n            .slice(0, Math.max(hasMarker[0] - 1, 0))\n            .replace(/[^\\t]/g, \" \");\n          const numberOfMarkers = hasMarker[1] || 1;\n\n          markerLine = [\n            \"\\n \",\n            gutter.replace(/\\d/g, \" \"),\n            markerSpacing,\n            \"^\".repeat(numberOfMarkers)\n          ].join(\"\");\n        }\n        return [\">\", gutter, line, markerLine].join(\"\");\n      }\n      return ` ${gutter}${line}`;\n    })\n    .join(\"\\n\");\n\n  return frame;\n}\n"],"mappings":";;;;AAiCA,MAAM,UAAU;;;;AAKhB,SAAS,eACP,KACA,QACA,OAAqD,EAAE,EAKvD;CACA,MAAMA,WAAqB;EACzB,QAAQ;EACR,MAAM;EACN,GAAG,IAAI;EACR;CACD,MAAMC,SAAmB;EACvB,GAAG;EACH,GAAG,IAAI;EACR;CACD,MAAM,EAAE,aAAa,GAAG,aAAa,MAAM,QAAQ,EAAE;CACrD,MAAM,YAAY,SAAS;CAC3B,MAAM,cAAc,SAAS;CAC7B,MAAM,UAAU,OAAO;CACvB,MAAM,YAAY,OAAO;CAEzB,IAAI,QAAQ,KAAK,IAAI,aAAa,aAAa,IAAI,EAAE;CACrD,IAAI,MAAM,KAAK,IAAI,OAAO,QAAQ,UAAU,WAAW;AAEvD,KAAI,cAAc,GAChB,SAAQ;AAGV,KAAI,YAAY,GACd,OAAM,OAAO;CAGf,MAAM,WAAW,UAAU;CAC3B,MAAM,cAAc,EAAE;AAEtB,KAAI,SACF,MAAK,IAAI,IAAI,GAAG,KAAK,UAAU,KAAK;EAClC,MAAM,aAAa,IAAI;AAEvB,MAAI,CAAC,YACH,aAAY,cAAc;WACjB,MAAM,EAGf,aAAY,cAAc,CAAC,cAFN,OAAO,aAAa,IAAI,UAAU,KAEA,cAAc,EAAE;WAC9D,MAAM,SACf,aAAY,cAAc,CAAC,GAAG,UAAU;MAIxC,aAAY,cAAc,CAAC,GAFN,OAAO,aAAa,IAAI,UAAU,EAEZ;;UAGtC,gBAAgB,UACzB,aAAY,aAAa,cAAc,CAAC,aAAa,EAAE,GAAG;KAE1D,aAAY,aAAa,CAAC,aAAa,YAAY,YAAY;AAGjE,QAAO;EACL;EACA;EACA;EACD;;AAGH,SAAgB,iBACd,UACA,KACA,OAII,EAAE,EACE;CAER,MAAM,EAAE,OAAO,KAAK,gBAAgB,eAAe,KADrC,SAAS,MAAM,QAAQ,EAC0B,KAAK;CAEpE,MAAM,iBAAiB,OAAO,IAAI,CAAC;AAgCnC,SA/ByB,KAAK,YAAY,KAAK,UAAU,SAAS,GAAG,UAGlE,MAAM,QAAQ,CACd,MAAM,OAAO,IAAI,CACjB,KAAK,MAAM,UAAU;EACpB,MAAM,SAAS,QAAQ,IAAI;EAE3B,MAAM,SAAS,IADM,IAAI,SAAS,MAAM,CAAC,eAAe,CACxB;EAChC,MAAM,YAAY,QAAQ,YAAY,WAAW,MAAM;AACvD,MAAI,WAAW;GACb,IAAI,aAAa;AACjB,OAAI,MAAM,QAAQ,UAAU,EAAE;IAC5B,MAAM,gBAAgB,KACnB,MAAM,GAAG,KAAK,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC,CACvC,QAAQ,UAAU,IAAI;IACzB,MAAM,kBAAkB,UAAU,MAAM;AAExC,iBAAa;KACX;KACA,OAAO,QAAQ,OAAO,IAAI;KAC1B;KACA,IAAI,OAAO,gBAAgB;KAC5B,CAAC,KAAK,GAAG;;AAEZ,UAAO;IAAC;IAAK;IAAQ;IAAM;IAAW,CAAC,KAAK,GAAG;;AAEjD,SAAO,IAAI,SAAS;GACpB,CACD,KAAK,KAAK"}

package/dist/find-reference-BCg3dQx1.cjs

@@ -0,0 +1,157 @@
+const require_is_object = require('./is-object-umGh91v1.cjs');
+const require_is_undefined = require('./is-undefined-CnI0qe-z.cjs');
+const require_is_string = require('./is-string-C2RK4Gjs.cjs');
+
+//#region ../type-checks/src/is-null.ts
+const isNull = (value) => {
+	try {
+		return value === null;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-empty.ts
+/**
+* Check if the provided value's type is `null` or `undefined`
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is of type `null` or `undefined`
+*/
+const isEmpty = (value) => {
+	try {
+		return require_is_undefined.isUndefined(value) || isNull(value);
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-set.ts
+/**
+* The inverse of the `isEmpty` function
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is **NOT** of type `null` or `undefined`
+*/
+const isSet = (value) => {
+	try {
+		return !isEmpty(value);
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-non-null-object.ts
+/**
+* Check if the provided value's type is `Object` and is not `null` or `undefined`
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is of type `Object` and is not `null` or `undefined`
+*/
+const isNonNullObject = (value) => {
+	return isSet(value) && require_is_object.isObject(value);
+};
+
+//#endregion
+//#region ../type-checks/src/is-set-object.ts
+/**
+* Check if the provided value's type is an object with some fields set
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is an object with some fields se
+*/
+const isSetObject = (value) => {
+	try {
+		return isNonNullObject(value) && Object.keys(value).length > 0;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region src/pointer/find-reference.ts
+const { isArray } = Array;
+/**
+* Finds a target in document specified by JSON Pointer. Also returns the
+* object containing the target and key used to reference that object.
+*
+* Throws Error('NOT_FOUND') if pointer does not result into a value in the middle
+* of the path. If the last element of the path does not result into a value, the
+* lookup succeeds with `val` set to `undefined`. It can be used to discriminate
+* missing values, because `undefined` is not a valid JSON value.
+*
+* If last element in array is targeted using "-", e.g. "/arr/-", use
+* `isArrayEnd` to verify that:
+*
+* ```js
+* const ref = find({arr: [1, 2, 3], ['arr', '-']});
+* if (isArrayReference(ref)) {
+*   if (isArrayEnd(ref)) {
+*     // ...
+*   }
+* }
+* ```
+*
+* @param val - Document to search in.
+* @param path - JSON Pointer path.
+* @returns Reference to the target.
+*/
+const find = (val, path) => {
+	const pathLength = path.length;
+	if (!pathLength) return { val };
+	let obj;
+	let key;
+	for (let i = 0; i < pathLength; i++) {
+		obj = val;
+		key = path[i];
+		if (isArray(obj)) {
+			const length = obj.length;
+			if (key === "-") key = length;
+			else if (require_is_string.isString(key)) {
+				const key2 = Math.trunc(Number.parseInt(key));
+				if (String(key2) !== key) throw new Error("INVALID_INDEX");
+				key = key2;
+				if (key < 0) throw new Error("INVALID_INDEX");
+			}
+			if (key) val = obj[key];
+		} else if (isSetObject(obj)) val = key && key in obj ? obj[key] : void 0;
+		else throw new Error("NOT_FOUND");
+	}
+	return {
+		val,
+		obj,
+		key
+	};
+};
+const isArrayReference = (ref) => isArray(ref.obj) && typeof ref.key === "number";
+const isArrayEnd = (ref) => ref.obj.length === ref.key;
+const isObjectReference = (ref) => typeof ref.obj === "object" && typeof ref.key === "string";
+
+//#endregion
+Object.defineProperty(exports, 'find', {
+  enumerable: true,
+  get: function () {
+    return find;
+  }
+});
+Object.defineProperty(exports, 'isArrayEnd', {
+  enumerable: true,
+  get: function () {
+    return isArrayEnd;
+  }
+});
+Object.defineProperty(exports, 'isArrayReference', {
+  enumerable: true,
+  get: function () {
+    return isArrayReference;
+  }
+});
+Object.defineProperty(exports, 'isObjectReference', {
+  enumerable: true,
+  get: function () {
+    return isObjectReference;
+  }
+});

package/dist/find-reference-C-YleCds.d.cts

@@ -0,0 +1,52 @@
+//#region src/pointer/find-reference.d.ts
+interface Reference {
+  /** Target value where pointer is pointing. */
+  readonly val: unknown;
+  /** Object which contains the target value. */
+  readonly obj?: unknown | object | unknown[];
+  /** Key which targets the target value in the object. */
+  readonly key?: string | number;
+}
+/**
+ * Finds a target in document specified by JSON Pointer. Also returns the
+ * object containing the target and key used to reference that object.
+ *
+ * Throws Error('NOT_FOUND') if pointer does not result into a value in the middle
+ * of the path. If the last element of the path does not result into a value, the
+ * lookup succeeds with `val` set to `undefined`. It can be used to discriminate
+ * missing values, because `undefined` is not a valid JSON value.
+ *
+ * If last element in array is targeted using "-", e.g. "/arr/-", use
+ * `isArrayEnd` to verify that:
+ *
+ * ```js
+ * const ref = find({arr: [1, 2, 3], ['arr', '-']});
+ * if (isArrayReference(ref)) {
+ *   if (isArrayEnd(ref)) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ *
+ * @param val - Document to search in.
+ * @param path - JSON Pointer path.
+ * @returns Reference to the target.
+ */
+declare const find: (val: unknown, path: Reference["key"][]) => Reference;
+interface ArrayReference<T = unknown> {
+  /** `undefined` in case JSON Pointer points to last element, e.g. "/foo/-". */
+  readonly val: undefined | T;
+  readonly obj: T[];
+  readonly key: number;
+}
+declare const isArrayReference: <T = unknown>(ref: Reference) => ref is ArrayReference<T>;
+declare const isArrayEnd: (ref: ArrayReference) => boolean;
+interface ObjectReference<T = unknown> {
+  readonly val: T;
+  readonly obj: Record<string, T>;
+  readonly key: string;
+}
+declare const isObjectReference: <T = unknown>(ref: Reference) => ref is ObjectReference<T>;
+//#endregion
+export { isArrayEnd as a, find as i, ObjectReference as n, isArrayReference as o, Reference as r, isObjectReference as s, ArrayReference as t };
+//# sourceMappingURL=find-reference-C-YleCds.d.cts.map

package/dist/find-reference-C-YleCds.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference-C-YleCds.d.cts","names":[],"sources":["../src/pointer/find-reference.ts"],"sourcesContent":[],"mappings":";UAqBiB,SAAA;EAAA;EAoCJ,SAyCZ,GAAA,EAAA,OAzCwC;EA2CxB;EAOJ,SAAA,GAAA,CAAA,EAAA,OAEiE,GAAA,MAAA,GAAA,OAAA,EAAA;EADvE;EACkB,SAAA,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA;;;AAEzB;AAGA;;;;;AAMA;;;;;;;;;;;;;;;;;;cA/Da,2BAA4B,uBAAqB;UA2C7C;;4BAEW;gBACZ;;;cAIH,qCACN,qBACG,eAAe;cAEZ,kBAAmB;UAGf;gBACD;gBACA,eAAe;;;cAIlB,sCACN,qBACG,gBAAgB"}

package/dist/find-reference-b7rRdLFx.d.mts

@@ -0,0 +1,52 @@
+//#region src/pointer/find-reference.d.ts
+interface Reference {
+  /** Target value where pointer is pointing. */
+  readonly val: unknown;
+  /** Object which contains the target value. */
+  readonly obj?: unknown | object | unknown[];
+  /** Key which targets the target value in the object. */
+  readonly key?: string | number;
+}
+/**
+ * Finds a target in document specified by JSON Pointer. Also returns the
+ * object containing the target and key used to reference that object.
+ *
+ * Throws Error('NOT_FOUND') if pointer does not result into a value in the middle
+ * of the path. If the last element of the path does not result into a value, the
+ * lookup succeeds with `val` set to `undefined`. It can be used to discriminate
+ * missing values, because `undefined` is not a valid JSON value.
+ *
+ * If last element in array is targeted using "-", e.g. "/arr/-", use
+ * `isArrayEnd` to verify that:
+ *
+ * ```js
+ * const ref = find({arr: [1, 2, 3], ['arr', '-']});
+ * if (isArrayReference(ref)) {
+ *   if (isArrayEnd(ref)) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ *
+ * @param val - Document to search in.
+ * @param path - JSON Pointer path.
+ * @returns Reference to the target.
+ */
+declare const find: (val: unknown, path: Reference["key"][]) => Reference;
+interface ArrayReference<T = unknown> {
+  /** `undefined` in case JSON Pointer points to last element, e.g. "/foo/-". */
+  readonly val: undefined | T;
+  readonly obj: T[];
+  readonly key: number;
+}
+declare const isArrayReference: <T = unknown>(ref: Reference) => ref is ArrayReference<T>;
+declare const isArrayEnd: (ref: ArrayReference) => boolean;
+interface ObjectReference<T = unknown> {
+  readonly val: T;
+  readonly obj: Record<string, T>;
+  readonly key: string;
+}
+declare const isObjectReference: <T = unknown>(ref: Reference) => ref is ObjectReference<T>;
+//#endregion
+export { isArrayEnd as a, find as i, ObjectReference as n, isArrayReference as o, Reference as r, isObjectReference as s, ArrayReference as t };
+//# sourceMappingURL=find-reference-b7rRdLFx.d.mts.map

package/dist/find-reference-b7rRdLFx.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference-b7rRdLFx.d.mts","names":[],"sources":["../src/pointer/find-reference.ts"],"sourcesContent":[],"mappings":";UAqBiB,SAAA;EAAA;EAoCJ,SAyCZ,GAAA,EAAA,OAzCwC;EA2CxB;EAOJ,SAAA,GAAA,CAAA,EAAA,OAEiE,GAAA,MAAA,GAAA,OAAA,EAAA;EADvE;EACkB,SAAA,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA;;;AAEzB;AAGA;;;;;AAMA;;;;;;;;;;;;;;;;;;cA/Da,2BAA4B,uBAAqB;UA2C7C;;4BAEW;gBACZ;;;cAIH,qCACN,qBACG,eAAe;cAEZ,kBAAmB;UAGf;gBACD;gBACA,eAAe;;;cAIlB,sCACN,qBACG,gBAAgB"}

package/dist/find-reference-woYMiWzN.mjs

@@ -0,0 +1,135 @@
+import { t as isObject } from "./is-object-BpfmzHWa.mjs";
+import { t as isUndefined } from "./is-undefined-CmyJWYGD.mjs";
+import { t as isString } from "./is-string-CLiBUSKV.mjs";
+
+//#region ../type-checks/src/is-null.ts
+const isNull = (value) => {
+	try {
+		return value === null;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-empty.ts
+/**
+* Check if the provided value's type is `null` or `undefined`
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is of type `null` or `undefined`
+*/
+const isEmpty = (value) => {
+	try {
+		return isUndefined(value) || isNull(value);
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-set.ts
+/**
+* The inverse of the `isEmpty` function
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is **NOT** of type `null` or `undefined`
+*/
+const isSet = (value) => {
+	try {
+		return !isEmpty(value);
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region ../type-checks/src/is-non-null-object.ts
+/**
+* Check if the provided value's type is `Object` and is not `null` or `undefined`
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is of type `Object` and is not `null` or `undefined`
+*/
+const isNonNullObject = (value) => {
+	return isSet(value) && isObject(value);
+};
+
+//#endregion
+//#region ../type-checks/src/is-set-object.ts
+/**
+* Check if the provided value's type is an object with some fields set
+*
+* @param value - The value to type check
+* @returns An indicator specifying if the value provided is an object with some fields se
+*/
+const isSetObject = (value) => {
+	try {
+		return isNonNullObject(value) && Object.keys(value).length > 0;
+	} catch {
+		return false;
+	}
+};
+
+//#endregion
+//#region src/pointer/find-reference.ts
+const { isArray } = Array;
+/**
+* Finds a target in document specified by JSON Pointer. Also returns the
+* object containing the target and key used to reference that object.
+*
+* Throws Error('NOT_FOUND') if pointer does not result into a value in the middle
+* of the path. If the last element of the path does not result into a value, the
+* lookup succeeds with `val` set to `undefined`. It can be used to discriminate
+* missing values, because `undefined` is not a valid JSON value.
+*
+* If last element in array is targeted using "-", e.g. "/arr/-", use
+* `isArrayEnd` to verify that:
+*
+* ```js
+* const ref = find({arr: [1, 2, 3], ['arr', '-']});
+* if (isArrayReference(ref)) {
+*   if (isArrayEnd(ref)) {
+*     // ...
+*   }
+* }
+* ```
+*
+* @param val - Document to search in.
+* @param path - JSON Pointer path.
+* @returns Reference to the target.
+*/
+const find = (val, path) => {
+	const pathLength = path.length;
+	if (!pathLength) return { val };
+	let obj;
+	let key;
+	for (let i = 0; i < pathLength; i++) {
+		obj = val;
+		key = path[i];
+		if (isArray(obj)) {
+			const length = obj.length;
+			if (key === "-") key = length;
+			else if (isString(key)) {
+				const key2 = Math.trunc(Number.parseInt(key));
+				if (String(key2) !== key) throw new Error("INVALID_INDEX");
+				key = key2;
+				if (key < 0) throw new Error("INVALID_INDEX");
+			}
+			if (key) val = obj[key];
+		} else if (isSetObject(obj)) val = key && key in obj ? obj[key] : void 0;
+		else throw new Error("NOT_FOUND");
+	}
+	return {
+		val,
+		obj,
+		key
+	};
+};
+const isArrayReference = (ref) => isArray(ref.obj) && typeof ref.key === "number";
+const isArrayEnd = (ref) => ref.obj.length === ref.key;
+const isObjectReference = (ref) => typeof ref.obj === "object" && typeof ref.key === "string";
+
+//#endregion
+export { isObjectReference as i, isArrayEnd as n, isArrayReference as r, find as t };
+//# sourceMappingURL=find-reference-woYMiWzN.mjs.map

package/dist/find-reference-woYMiWzN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference-woYMiWzN.mjs","names":["obj: Reference[\"obj\"]","key: Reference[\"key\"]"],"sources":["../../type-checks/src/is-null.ts","../../type-checks/src/is-empty.ts","../../type-checks/src/is-set.ts","../../type-checks/src/is-non-null-object.ts","../../type-checks/src/is-set-object.ts","../src/pointer/find-reference.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const isNull = (value: unknown): value is null => {\n  try {\n    return value === null;\n  } catch {\n    return false;\n  }\n};\n","/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isDate } from \"./is-date\";\nimport { isFunction } from \"./is-function\";\nimport { isNull } from \"./is-null\";\nimport { isNumber } from \"./is-number\";\nimport { isSymbol } from \"./is-symbol\";\nimport { isUndefined } from \"./is-undefined\";\n\n/**\n * Check if the provided value's type is `null` or `undefined`\n *\n * @param value - The value to type check\n * @returns An indicator specifying if the value provided is of type `null` or `undefined`\n */\nexport const isEmpty = (value: unknown) => {\n  try {\n    return isUndefined(value) || isNull(value);\n  } catch {\n    return false;\n  }\n};\n\nexport const isEmptyAnything = (value: any) => {\n  if (value === true || value === false) return true;\n  if (value === null || value === undefined) return true;\n  if (isNumber(value)) return value === 0;\n  if (isDate(value)) return Number.isNaN(value.getTime());\n  if (isFunction(value)) return false;\n  if (isSymbol(value)) return false;\n  const { length } = value;\n  if (isNumber(length)) return length === 0;\n  const { size } = value;\n  if (isNumber(size)) return size === 0;\n  const keys = Object.keys(value).length;\n\n  return keys === 0;\n};\n","/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isEmpty } from \"./is-empty\";\n\n/**\n * The inverse of the `isEmpty` function\n *\n * @param value - The value to type check\n * @returns An indicator specifying if the value provided is **NOT** of type `null` or `undefined`\n */\nexport const isSet = (value: unknown): value is NonNullable<unknown> => {\n  try {\n    return !isEmpty(value);\n  } catch {\n    return false;\n  }\n};\n","/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isObject } from \"./is-object\";\nimport { isSet } from \"./is-set\";\n\n/**\n * Check if the provided value's type is `Object` and is not `null` or `undefined`\n *\n * @param value - The value to type check\n * @returns An indicator specifying if the value provided is of type `Object` and is not `null` or `undefined`\n */\nexport const isNonNullObject = (value: any): value is NonNullable<object> => {\n  return isSet(value) && isObject(value);\n};\n","/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isNonNullObject } from \"./is-non-null-object\";\n\n/**\n * Check if the provided value's type is an object with some fields set\n *\n * @param value - The value to type check\n * @returns An indicator specifying if the value provided is an object with some fields se\n */\nexport const isSetObject = (value: unknown): value is NonNullable<object> => {\n  try {\n    return isNonNullObject(value) && Object.keys(value).length > 0;\n  } catch {\n    return false;\n  }\n};\n","/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\n\nexport interface Reference {\n  /** Target value where pointer is pointing. */\n  readonly val: unknown;\n  /** Object which contains the target value. */\n  readonly obj?: unknown | object | unknown[];\n  /** Key which targets the target value in the object. */\n  readonly key?: string | number;\n}\n\nconst { isArray } = Array;\n\n/**\n * Finds a target in document specified by JSON Pointer. Also returns the\n * object containing the target and key used to reference that object.\n *\n * Throws Error('NOT_FOUND') if pointer does not result into a value in the middle\n * of the path. If the last element of the path does not result into a value, the\n * lookup succeeds with `val` set to `undefined`. It can be used to discriminate\n * missing values, because `undefined` is not a valid JSON value.\n *\n * If last element in array is targeted using \"-\", e.g. \"/arr/-\", use\n * `isArrayEnd` to verify that:\n *\n * ```js\n * const ref = find({arr: [1, 2, 3], ['arr', '-']});\n * if (isArrayReference(ref)) {\n *   if (isArrayEnd(ref)) {\n *     // ...\n *   }\n * }\n * ```\n *\n * @param val - Document to search in.\n * @param path - JSON Pointer path.\n * @returns Reference to the target.\n */\nexport const find = (val: unknown, path: Reference[\"key\"][]): Reference => {\n  const pathLength = path.length;\n  if (!pathLength) {\n    return { val };\n  }\n\n  let obj: Reference[\"obj\"];\n  let key: Reference[\"key\"];\n  for (let i = 0; i < pathLength; i++) {\n    obj = val;\n    key = path[i];\n    if (isArray(obj)) {\n      const length = obj.length;\n      if (key === \"-\") {\n        key = length;\n      } else if (isString(key)) {\n        const key2 = Math.trunc(Number.parseInt(key));\n        if (String(key2) !== key) {\n          throw new Error(\"INVALID_INDEX\");\n        }\n\n        key = key2;\n        if (key < 0) {\n          throw new Error(\"INVALID_INDEX\");\n        }\n      }\n\n      if (key) {\n        val = obj[key];\n      }\n    } else if (isSetObject(obj)) {\n      val = key && key in obj ? (obj as any)[key] : undefined;\n    } else throw new Error(\"NOT_FOUND\");\n  }\n  const ref: Reference = {\n    val,\n    obj,\n    key\n  };\n\n  return ref;\n};\n\nexport interface ArrayReference<T = unknown> {\n  /** `undefined` in case JSON Pointer points to last element, e.g. \"/foo/-\". */\n  readonly val: undefined | T;\n  readonly obj: T[];\n  readonly key: number;\n}\n\nexport const isArrayReference = <T = unknown>(\n  ref: Reference\n): ref is ArrayReference<T> => isArray(ref.obj) && typeof ref.key === \"number\";\n\nexport const isArrayEnd = (ref: ArrayReference): boolean =>\n  ref.obj.length === ref.key;\n\nexport interface ObjectReference<T = unknown> {\n  readonly val: T;\n  readonly obj: Record<string, T>;\n  readonly key: string;\n}\n\nexport const isObjectReference = <T = unknown>(\n  ref: Reference\n): ref is ObjectReference<T> =>\n  typeof ref.obj === \"object\" && typeof ref.key === \"string\";\n"],"mappings":";;;;;AAkBA,MAAa,UAAU,UAAkC;AACvD,KAAI;AACF,SAAO,UAAU;SACX;AACN,SAAO;;;;;;;;;;;;ACSX,MAAa,WAAW,UAAmB;AACzC,KAAI;AACF,SAAO,YAAY,MAAM,IAAI,OAAO,MAAM;SACpC;AACN,SAAO;;;;;;;;;;;;ACTX,MAAa,SAAS,UAAkD;AACtE,KAAI;AACF,SAAO,CAAC,QAAQ,MAAM;SAChB;AACN,SAAO;;;;;;;;;;;;ACHX,MAAa,mBAAmB,UAA6C;AAC3E,QAAO,MAAM,MAAM,IAAI,SAAS,MAAM;;;;;;;;;;;ACFxC,MAAa,eAAe,UAAiD;AAC3E,KAAI;AACF,SAAO,gBAAgB,MAAM,IAAI,OAAO,KAAK,MAAM,CAAC,SAAS;SACvD;AACN,SAAO;;;;;;ACAX,MAAM,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BpB,MAAa,QAAQ,KAAc,SAAwC;CACzE,MAAM,aAAa,KAAK;AACxB,KAAI,CAAC,WACH,QAAO,EAAE,KAAK;CAGhB,IAAIA;CACJ,IAAIC;AACJ,MAAK,IAAI,IAAI,GAAG,IAAI,YAAY,KAAK;AACnC,QAAM;AACN,QAAM,KAAK;AACX,MAAI,QAAQ,IAAI,EAAE;GAChB,MAAM,SAAS,IAAI;AACnB,OAAI,QAAQ,IACV,OAAM;YACG,SAAS,IAAI,EAAE;IACxB,MAAM,OAAO,KAAK,MAAM,OAAO,SAAS,IAAI,CAAC;AAC7C,QAAI,OAAO,KAAK,KAAK,IACnB,OAAM,IAAI,MAAM,gBAAgB;AAGlC,UAAM;AACN,QAAI,MAAM,EACR,OAAM,IAAI,MAAM,gBAAgB;;AAIpC,OAAI,IACF,OAAM,IAAI;aAEH,YAAY,IAAI,CACzB,OAAM,OAAO,OAAO,MAAO,IAAY,OAAO;MACzC,OAAM,IAAI,MAAM,YAAY;;AAQrC,QANuB;EACrB;EACA;EACA;EACD;;AAYH,MAAa,oBACX,QAC6B,QAAQ,IAAI,IAAI,IAAI,OAAO,IAAI,QAAQ;AAEtE,MAAa,cAAc,QACzB,IAAI,IAAI,WAAW,IAAI;AAQzB,MAAa,qBACX,QAEA,OAAO,IAAI,QAAQ,YAAY,OAAO,IAAI,QAAQ"}

package/dist/index-B_e8BwCm.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index-CDAfh8Ew.d.cts

@@ -0,0 +1 @@
+export { };