@stryke/fs 0.33.31 → 0.33.33

package/dist/json/src/utils/stringify.cjs

@@ -1 +1,67 @@
-const e=require(`../../../type-checks/src/is-number.cjs`),t=require(`../../../type-checks/src/is-undefined.cjs`),n=`@/#$ :;,.!?&=+-*%^~|\\"'\`{}[]()<>`.split(``),r=(i,a=2)=>{let o=e.isNumber(a)?` `.repeat(a):a;switch(i){case null:return`null`;case void 0:return`"undefined"`;case!0:return`true`;case!1:return`false`;case 1/0:return`infinity`;case-1/0:return`-infinity`}if(Array.isArray(i))return`[${o}${i.map(e=>r(e,o)).join(`,${o}`)}${o}]`;if(i instanceof Uint8Array)return i.toString();switch(typeof i){case`number`:return`${i}`;case`string`:return JSON.stringify(i);case`object`:return`{${o}${Object.keys(i).filter(e=>!t.isUndefined(i[e])).map(e=>`${n.some(t=>e.includes(t))?`"${e}"`:e}: ${o}${r(i[e],o)}`).join(`,${o}`)}${o}}`;default:return`null`}};exports.stringify=r;
+const require_is_number = require('../../../type-checks/src/is-number.cjs');
+const require_is_undefined = require('../../../type-checks/src/is-undefined.cjs');
+
+//#region ../json/src/utils/stringify.ts
+const invalidKeyChars = [
+	"@",
+	"/",
+	"#",
+	"$",
+	" ",
+	":",
+	";",
+	",",
+	".",
+	"!",
+	"?",
+	"&",
+	"=",
+	"+",
+	"-",
+	"*",
+	"%",
+	"^",
+	"~",
+	"|",
+	"\\",
+	"\"",
+	"'",
+	"`",
+	"{",
+	"}",
+	"[",
+	"]",
+	"(",
+	")",
+	"<",
+	">"
+];
+/**
+* Stringify a value to a JSON-like string.
+*
+* @param value - The value to stringify
+* @param spacing - The spacing to use for the stringification
+* @returns The stringified value
+*/
+const stringify = (value, spacing = 2) => {
+	const space = require_is_number.isNumber(spacing) ? " ".repeat(spacing) : spacing;
+	switch (value) {
+		case null: return "null";
+		case void 0: return "\"undefined\"";
+		case true: return "true";
+		case false: return "false";
+		case Number.POSITIVE_INFINITY: return "infinity";
+		case Number.NEGATIVE_INFINITY: return "-infinity";
+	}
+	if (Array.isArray(value)) return `[${space}${value.map((v) => stringify(v, space)).join(`,${space}`)}${space}]`;
+	if (value instanceof Uint8Array) return value.toString();
+	switch (typeof value) {
+		case "number": return `${value}`;
+		case "string": return JSON.stringify(value);
+		case "object": return `{${space}${Object.keys(value).filter((key) => !require_is_undefined.isUndefined(value[key])).map((key) => `${invalidKeyChars.some((invalidKeyChar) => key.includes(invalidKeyChar)) ? `"${key}"` : key}: ${space}${stringify(value[key], space)}`).join(`,${space}`)}${space}}`;
+		default: return "null";
+	}
+};
+
+//#endregion
+exports.stringify = stringify;

package/dist/json/src/utils/stringify.mjs

@@ -1,2 +1,68 @@
-import{isNumber as e}from"../../../type-checks/src/is-number.mjs";import{isUndefined as t}from"../../../type-checks/src/is-undefined.mjs";const n=`@/#$ :;,.!?&=+-*%^~|\\"'\`{}[]()<>`.split(``),r=(i,a=2)=>{let o=e(a)?` `.repeat(a):a;switch(i){case null:return`null`;case void 0:return`"undefined"`;case!0:return`true`;case!1:return`false`;case 1/0:return`infinity`;case-1/0:return`-infinity`}if(Array.isArray(i))return`[${o}${i.map(e=>r(e,o)).join(`,${o}`)}${o}]`;if(i instanceof Uint8Array)return i.toString();switch(typeof i){case`number`:return`${i}`;case`string`:return JSON.stringify(i);case`object`:return`{${o}${Object.keys(i).filter(e=>!t(i[e])).map(e=>`${n.some(t=>e.includes(t))?`"${e}"`:e}: ${o}${r(i[e],o)}`).join(`,${o}`)}${o}}`;default:return`null`}};export{r as stringify};
+import { isNumber } from "../../../type-checks/src/is-number.mjs";
+import { isUndefined } from "../../../type-checks/src/is-undefined.mjs";
+
+//#region ../json/src/utils/stringify.ts
+const invalidKeyChars = [
+	"@",
+	"/",
+	"#",
+	"$",
+	" ",
+	":",
+	";",
+	",",
+	".",
+	"!",
+	"?",
+	"&",
+	"=",
+	"+",
+	"-",
+	"*",
+	"%",
+	"^",
+	"~",
+	"|",
+	"\\",
+	"\"",
+	"'",
+	"`",
+	"{",
+	"}",
+	"[",
+	"]",
+	"(",
+	")",
+	"<",
+	">"
+];
+/**
+* Stringify a value to a JSON-like string.
+*
+* @param value - The value to stringify
+* @param spacing - The spacing to use for the stringification
+* @returns The stringified value
+*/
+const stringify = (value, spacing = 2) => {
+	const space = isNumber(spacing) ? " ".repeat(spacing) : spacing;
+	switch (value) {
+		case null: return "null";
+		case void 0: return "\"undefined\"";
+		case true: return "true";
+		case false: return "false";
+		case Number.POSITIVE_INFINITY: return "infinity";
+		case Number.NEGATIVE_INFINITY: return "-infinity";
+	}
+	if (Array.isArray(value)) return `[${space}${value.map((v) => stringify(v, space)).join(`,${space}`)}${space}]`;
+	if (value instanceof Uint8Array) return value.toString();
+	switch (typeof value) {
+		case "number": return `${value}`;
+		case "string": return JSON.stringify(value);
+		case "object": return `{${space}${Object.keys(value).filter((key) => !isUndefined(value[key])).map((key) => `${invalidKeyChars.some((invalidKeyChar) => key.includes(invalidKeyChar)) ? `"${key}"` : key}: ${space}${stringify(value[key], space)}`).join(`,${space}`)}${space}}`;
+		default: return "null";
+	}
+};
+
+//#endregion
+export { stringify };
 //# sourceMappingURL=stringify.mjs.map

package/dist/json/src/utils/stringify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stringify.mjs","names":[],"sources":["../../../../../json/src/utils/stringify.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\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\n\nexport const invalidKeyChars = [\n  \"@\",\n  \"/\",\n  \"#\",\n  \"$\",\n  \" \",\n  \":\",\n  \";\",\n  \",\",\n  \".\",\n  \"!\",\n  \"?\",\n  \"&\",\n  \"=\",\n  \"+\",\n  \"-\",\n  \"*\",\n  \"%\",\n  \"^\",\n  \"~\",\n  \"|\",\n  \"\\\\\",\n  '\"',\n  \"'\",\n  \"`\",\n  \"{\",\n  \"}\",\n  \"[\",\n  \"]\",\n  \"(\",\n  \")\",\n  \"<\",\n  \">\"\n] as const;\n\n/**\n * Stringify a value to a JSON-like string.\n *\n * @param value - The value to stringify\n * @param spacing - The spacing to use for the stringification\n * @returns The stringified value\n */\nexport const stringify = (\n  value: unknown,\n  spacing: string | number = 2\n): string => {\n  const space = isNumber(spacing) ? \" \".repeat(spacing) : spacing;\n\n  switch (value) {\n    case null: {\n      return \"null\";\n    }\n    case undefined: {\n      return '\"undefined\"';\n    }\n    case true: {\n      return \"true\";\n    }\n    case false: {\n      return \"false\";\n    }\n    case Number.POSITIVE_INFINITY: {\n      return \"infinity\";\n    }\n    case Number.NEGATIVE_INFINITY: {\n      return \"-infinity\";\n    }\n  }\n\n  if (Array.isArray(value)) {\n    return `[${space}${value.map(v => stringify(v, space)).join(`,${space}`)}${space}]`;\n  }\n  if (value instanceof Uint8Array) {\n    return value.toString();\n  }\n\n  // eslint-disable-next-line ts/switch-exhaustiveness-check\n  switch (typeof value) {\n    case \"number\": {\n      return `${value}`;\n    }\n    case \"string\": {\n      return JSON.stringify(value);\n    }\n    case \"object\": {\n      const keys = Object.keys(value as object).filter(\n        key => !isUndefined((value as any)[key])\n      );\n\n      return `{${space}${keys\n        .map(\n          key =>\n            `${invalidKeyChars.some(invalidKeyChar => key.includes(invalidKeyChar)) ? `\"${key}\"` : key}: ${space}${stringify((value as any)[key], space)}`\n        )\n        .join(`,${space}`)}${space}}`;\n    }\n    default:\n      return \"null\";\n  }\n};\n"],"mappings":"0IAqBA,MAAa,EAAkB,8CAiC9B,CASY,GACX,EACA,EAA2B,IAChB,CACX,IAAM,EAAQ,EAAS,EAAQ,CAAG,IAAI,OAAO,EAAQ,CAAG,EAExD,OAAQ,EAAR,CACE,KAAK,KACH,MAAO,OAET,KAAK,IAAA,GACH,MAAO,cAET,IAAK,GACH,MAAO,OAET,IAAK,GACH,MAAO,QAET,IAAK,KACH,MAAO,WAET,IAAK,KACH,MAAO,YAIX,GAAI,MAAM,QAAQ,EAAM,CACtB,MAAO,IAAI,IAAQ,EAAM,IAAI,GAAK,EAAU,EAAG,EAAM,CAAC,CAAC,KAAK,IAAI,IAAQ,GAAG,EAAM,GAEnF,GAAI,aAAiB,WACnB,OAAO,EAAM,UAAU,CAIzB,OAAQ,OAAO,EAAf,CACE,IAAK,SACH,MAAO,GAAG,IAEZ,IAAK,SACH,OAAO,KAAK,UAAU,EAAM,CAE9B,IAAK,SAKH,MAAO,IAAI,IAJE,OAAO,KAAK,EAAgB,CAAC,OACxC,GAAO,CAAC,EAAa,EAAc,GAAK,CACzC,CAGE,IACC,GACE,GAAG,EAAgB,KAAK,GAAkB,EAAI,SAAS,EAAe,CAAC,CAAG,IAAI,EAAI,GAAK,EAAI,IAAI,IAAQ,EAAW,EAAc,GAAM,EAAM,GAC/I,CACA,KAAK,IAAI,IAAQ,GAAG,EAAM,GAE/B,QACE,MAAO"}
+{"version":3,"file":"stringify.mjs","names":[],"sources":["../../../../../json/src/utils/stringify.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\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\n\nexport const invalidKeyChars = [\n  \"@\",\n  \"/\",\n  \"#\",\n  \"$\",\n  \" \",\n  \":\",\n  \";\",\n  \",\",\n  \".\",\n  \"!\",\n  \"?\",\n  \"&\",\n  \"=\",\n  \"+\",\n  \"-\",\n  \"*\",\n  \"%\",\n  \"^\",\n  \"~\",\n  \"|\",\n  \"\\\\\",\n  '\"',\n  \"'\",\n  \"`\",\n  \"{\",\n  \"}\",\n  \"[\",\n  \"]\",\n  \"(\",\n  \")\",\n  \"<\",\n  \">\"\n] as const;\n\n/**\n * Stringify a value to a JSON-like string.\n *\n * @param value - The value to stringify\n * @param spacing - The spacing to use for the stringification\n * @returns The stringified value\n */\nexport const stringify = (\n  value: unknown,\n  spacing: string | number = 2\n): string => {\n  const space = isNumber(spacing) ? \" \".repeat(spacing) : spacing;\n\n  switch (value) {\n    case null: {\n      return \"null\";\n    }\n    case undefined: {\n      return '\"undefined\"';\n    }\n    case true: {\n      return \"true\";\n    }\n    case false: {\n      return \"false\";\n    }\n    case Number.POSITIVE_INFINITY: {\n      return \"infinity\";\n    }\n    case Number.NEGATIVE_INFINITY: {\n      return \"-infinity\";\n    }\n  }\n\n  if (Array.isArray(value)) {\n    return `[${space}${value.map(v => stringify(v, space)).join(`,${space}`)}${space}]`;\n  }\n  if (value instanceof Uint8Array) {\n    return value.toString();\n  }\n\n  // eslint-disable-next-line ts/switch-exhaustiveness-check\n  switch (typeof value) {\n    case \"number\": {\n      return `${value}`;\n    }\n    case \"string\": {\n      return JSON.stringify(value);\n    }\n    case \"object\": {\n      const keys = Object.keys(value as object).filter(\n        key => !isUndefined((value as any)[key])\n      );\n\n      return `{${space}${keys\n        .map(\n          key =>\n            `${invalidKeyChars.some(invalidKeyChar => key.includes(invalidKeyChar)) ? `\"${key}\"` : key}: ${space}${stringify((value as any)[key], space)}`\n        )\n        .join(`,${space}`)}${space}}`;\n    }\n    default:\n      return \"null\";\n  }\n};\n"],"mappings":";;;;AAqBA,MAAa,kBAAkB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;AASD,MAAa,aACX,OACA,UAA2B,MAChB;CACX,MAAM,QAAQ,SAAS,QAAQ,GAAG,IAAI,OAAO,QAAQ,GAAG;AAExD,SAAQ,OAAR;EACE,KAAK,KACH,QAAO;EAET,KAAK,OACH,QAAO;EAET,KAAK,KACH,QAAO;EAET,KAAK,MACH,QAAO;EAET,KAAK,OAAO,kBACV,QAAO;EAET,KAAK,OAAO,kBACV,QAAO;;AAIX,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,IAAI,QAAQ,MAAM,KAAI,MAAK,UAAU,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,QAAQ,GAAG,MAAM;AAEnF,KAAI,iBAAiB,WACnB,QAAO,MAAM,UAAU;AAIzB,SAAQ,OAAO,OAAf;EACE,KAAK,SACH,QAAO,GAAG;EAEZ,KAAK,SACH,QAAO,KAAK,UAAU,MAAM;EAE9B,KAAK,SAKH,QAAO,IAAI,QAJE,OAAO,KAAK,MAAgB,CAAC,QACxC,QAAO,CAAC,YAAa,MAAc,KAAK,CACzC,CAGE,KACC,QACE,GAAG,gBAAgB,MAAK,mBAAkB,IAAI,SAAS,eAAe,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,UAAW,MAAc,MAAM,MAAM,GAC/I,CACA,KAAK,IAAI,QAAQ,GAAG,MAAM;EAE/B,QACE,QAAO"}

package/dist/json/src/utils/strip-comments.cjs

@@ -1,4 +1,86 @@
-const e=require(`../../../types/src/base.cjs`),t=Symbol(`singleComment`),n=Symbol(`multiComment`);function r(){return``}function i(e,t,n){return e.slice(t,n).replace(/\S/g,` `)}function a(e,t){let n=t-1,r=0;for(;e[n]===`\\`;)--n,r+=1;return!!(r%2)}function o(o,{whitespace:s=!0,trailingCommas:c=!1}={}){if(typeof o!=`string`)throw TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof o}\``);let l=s?i:r,u=!1,d=!1,f=0,p=``,m=``,h=-1;for(let r=0;r<o.length;r++){let i=o[r],s=o[r+1];!d&&i===`"`&&(a(o,r)||(u=!u)),!u&&(!d&&i+(s??e.EMPTY_STRING)===`//`?(p+=o.slice(f,r),f=r,d=t,r++):d===t&&i+(s??e.EMPTY_STRING)===`\r
-`?(r++,d=!1,p+=l(o,f,r),f=r):d===t&&i===`
-`?(d=!1,p+=l(o,f,r),f=r):!d&&i+(s??e.EMPTY_STRING)===`/*`?(p+=o.slice(f,r),f=r,d=n,r++):d===n&&i+(s??e.EMPTY_STRING)===`*/`?(r++,d=!1,p+=l(o,f,r+1),f=r+1):c&&!d&&(h===-1?i===`,`&&(m+=p+o.slice(f,r),p=``,f=r,h=r):i===`}`||i===`]`?(p+=o.slice(f,r),m+=l(p,0,1)+p.slice(1),p=``,f=r,h=-1):i!==` `&&i!==`	`&&i!==`\r`&&i!==`
-`&&(p+=o.slice(f,r),f=r,h=-1)))}return m+p+(d?l(o.slice(f)):o.slice(f))}exports.stripComments=o;
+const require_base = require('../../../types/src/base.cjs');
+
+//#region ../json/src/utils/strip-comments.ts
+const singleComment = Symbol("singleComment");
+const multiComment = Symbol("multiComment");
+function stripWithoutWhitespace() {
+	return "";
+}
+function stripWithWhitespace(value, start, end) {
+	return value.slice(start, end).replace(/\S/g, " ");
+}
+function isEscaped(value, quotePosition) {
+	let index = quotePosition - 1;
+	let backslashCount = 0;
+	while (value[index] === "\\") {
+		index -= 1;
+		backslashCount += 1;
+	}
+	return Boolean(backslashCount % 2);
+}
+function stripComments(value, { whitespace = true, trailingCommas = false } = {}) {
+	if (typeof value !== "string") throw new TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof value}\``);
+	const strip = whitespace ? stripWithWhitespace : stripWithoutWhitespace;
+	let isInsideString = false;
+	let isInsideComment = false;
+	let offset = 0;
+	let buffer = "";
+	let result = "";
+	let commaIndex = -1;
+	for (let index = 0; index < value.length; index++) {
+		const currentCharacter = value[index];
+		const nextCharacter = value[index + 1];
+		if (!isInsideComment && currentCharacter === "\"") {
+			if (!isEscaped(value, index)) isInsideString = !isInsideString;
+		}
+		if (isInsideString) continue;
+		if (!isInsideComment && currentCharacter + (nextCharacter ?? require_base.EMPTY_STRING) === "//") {
+			buffer += value.slice(offset, index);
+			offset = index;
+			isInsideComment = singleComment;
+			index++;
+		} else if (isInsideComment === singleComment && currentCharacter + (nextCharacter ?? require_base.EMPTY_STRING) === "\r\n") {
+			index++;
+			isInsideComment = false;
+			buffer += strip(value, offset, index);
+			offset = index;
+		} else if (isInsideComment === singleComment && currentCharacter === "\n") {
+			isInsideComment = false;
+			buffer += strip(value, offset, index);
+			offset = index;
+		} else if (!isInsideComment && currentCharacter + (nextCharacter ?? require_base.EMPTY_STRING) === "/*") {
+			buffer += value.slice(offset, index);
+			offset = index;
+			isInsideComment = multiComment;
+			index++;
+		} else if (isInsideComment === multiComment && currentCharacter + (nextCharacter ?? require_base.EMPTY_STRING) === "*/") {
+			index++;
+			isInsideComment = false;
+			buffer += strip(value, offset, index + 1);
+			offset = index + 1;
+		} else if (trailingCommas && !isInsideComment) {
+			if (commaIndex !== -1) {
+				if (currentCharacter === "}" || currentCharacter === "]") {
+					buffer += value.slice(offset, index);
+					result += strip(buffer, 0, 1) + buffer.slice(1);
+					buffer = "";
+					offset = index;
+					commaIndex = -1;
+				} else if (currentCharacter !== " " && currentCharacter !== "	" && currentCharacter !== "\r" && currentCharacter !== "\n") {
+					buffer += value.slice(offset, index);
+					offset = index;
+					commaIndex = -1;
+				}
+			} else if (currentCharacter === ",") {
+				result += buffer + value.slice(offset, index);
+				buffer = "";
+				offset = index;
+				commaIndex = index;
+			}
+		}
+	}
+	return result + buffer + (isInsideComment ? strip(value.slice(offset)) : value.slice(offset));
+}
+
+//#endregion
+exports.stripComments = stripComments;

package/dist/json/src/utils/strip-comments.mjs

@@ -1,5 +1,87 @@
-import{EMPTY_STRING as e}from"../../../types/src/base.mjs";const t=Symbol(`singleComment`),n=Symbol(`multiComment`);function r(){return``}function i(e,t,n){return e.slice(t,n).replace(/\S/g,` `)}function a(e,t){let n=t-1,r=0;for(;e[n]===`\\`;)--n,r+=1;return!!(r%2)}function o(o,{whitespace:s=!0,trailingCommas:c=!1}={}){if(typeof o!=`string`)throw TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof o}\``);let l=s?i:r,u=!1,d=!1,f=0,p=``,m=``,h=-1;for(let r=0;r<o.length;r++){let i=o[r],s=o[r+1];!d&&i===`"`&&(a(o,r)||(u=!u)),!u&&(!d&&i+(s??e)===`//`?(p+=o.slice(f,r),f=r,d=t,r++):d===t&&i+(s??e)===`\r
-`?(r++,d=!1,p+=l(o,f,r),f=r):d===t&&i===`
-`?(d=!1,p+=l(o,f,r),f=r):!d&&i+(s??e)===`/*`?(p+=o.slice(f,r),f=r,d=n,r++):d===n&&i+(s??e)===`*/`?(r++,d=!1,p+=l(o,f,r+1),f=r+1):c&&!d&&(h===-1?i===`,`&&(m+=p+o.slice(f,r),p=``,f=r,h=r):i===`}`||i===`]`?(p+=o.slice(f,r),m+=l(p,0,1)+p.slice(1),p=``,f=r,h=-1):i!==` `&&i!==`	`&&i!==`\r`&&i!==`
-`&&(p+=o.slice(f,r),f=r,h=-1)))}return m+p+(d?l(o.slice(f)):o.slice(f))}export{o as stripComments};
+import { EMPTY_STRING } from "../../../types/src/base.mjs";
+
+//#region ../json/src/utils/strip-comments.ts
+const singleComment = Symbol("singleComment");
+const multiComment = Symbol("multiComment");
+function stripWithoutWhitespace() {
+	return "";
+}
+function stripWithWhitespace(value, start, end) {
+	return value.slice(start, end).replace(/\S/g, " ");
+}
+function isEscaped(value, quotePosition) {
+	let index = quotePosition - 1;
+	let backslashCount = 0;
+	while (value[index] === "\\") {
+		index -= 1;
+		backslashCount += 1;
+	}
+	return Boolean(backslashCount % 2);
+}
+function stripComments(value, { whitespace = true, trailingCommas = false } = {}) {
+	if (typeof value !== "string") throw new TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof value}\``);
+	const strip = whitespace ? stripWithWhitespace : stripWithoutWhitespace;
+	let isInsideString = false;
+	let isInsideComment = false;
+	let offset = 0;
+	let buffer = "";
+	let result = "";
+	let commaIndex = -1;
+	for (let index = 0; index < value.length; index++) {
+		const currentCharacter = value[index];
+		const nextCharacter = value[index + 1];
+		if (!isInsideComment && currentCharacter === "\"") {
+			if (!isEscaped(value, index)) isInsideString = !isInsideString;
+		}
+		if (isInsideString) continue;
+		if (!isInsideComment && currentCharacter + (nextCharacter ?? EMPTY_STRING) === "//") {
+			buffer += value.slice(offset, index);
+			offset = index;
+			isInsideComment = singleComment;
+			index++;
+		} else if (isInsideComment === singleComment && currentCharacter + (nextCharacter ?? EMPTY_STRING) === "\r\n") {
+			index++;
+			isInsideComment = false;
+			buffer += strip(value, offset, index);
+			offset = index;
+		} else if (isInsideComment === singleComment && currentCharacter === "\n") {
+			isInsideComment = false;
+			buffer += strip(value, offset, index);
+			offset = index;
+		} else if (!isInsideComment && currentCharacter + (nextCharacter ?? EMPTY_STRING) === "/*") {
+			buffer += value.slice(offset, index);
+			offset = index;
+			isInsideComment = multiComment;
+			index++;
+		} else if (isInsideComment === multiComment && currentCharacter + (nextCharacter ?? EMPTY_STRING) === "*/") {
+			index++;
+			isInsideComment = false;
+			buffer += strip(value, offset, index + 1);
+			offset = index + 1;
+		} else if (trailingCommas && !isInsideComment) {
+			if (commaIndex !== -1) {
+				if (currentCharacter === "}" || currentCharacter === "]") {
+					buffer += value.slice(offset, index);
+					result += strip(buffer, 0, 1) + buffer.slice(1);
+					buffer = "";
+					offset = index;
+					commaIndex = -1;
+				} else if (currentCharacter !== " " && currentCharacter !== "	" && currentCharacter !== "\r" && currentCharacter !== "\n") {
+					buffer += value.slice(offset, index);
+					offset = index;
+					commaIndex = -1;
+				}
+			} else if (currentCharacter === ",") {
+				result += buffer + value.slice(offset, index);
+				buffer = "";
+				offset = index;
+				commaIndex = index;
+			}
+		}
+	}
+	return result + buffer + (isInsideComment ? strip(value.slice(offset)) : value.slice(offset));
+}
+
+//#endregion
+export { stripComments };
 //# sourceMappingURL=strip-comments.mjs.map

package/dist/json/src/utils/strip-comments.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"strip-comments.mjs","names":["isInsideString: boolean | symbol","isInsideComment: boolean | symbol"],"sources":["../../../../../json/src/utils/strip-comments.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\nimport { EMPTY_STRING } from \"@stryke/types/base\";\n\nconst singleComment = Symbol(\"singleComment\");\nconst multiComment = Symbol(\"multiComment\");\n\nfunction stripWithoutWhitespace() {\n  return \"\";\n}\nfunction stripWithWhitespace(value: string, start?: number, end?: number) {\n  return value.slice(start, end).replace(/\\S/g, \" \");\n}\n\nfunction isEscaped(value: string, quotePosition: number) {\n  let index = quotePosition - 1;\n  let backslashCount = 0;\n  while (value[index] === \"\\\\\") {\n    index -= 1;\n    backslashCount += 1;\n  }\n\n  return Boolean(backslashCount % 2);\n}\n\nexport function stripComments(\n  value: string,\n  { whitespace = true, trailingCommas = false } = {}\n) {\n  if (typeof value !== \"string\") {\n    throw new TypeError(\n      `Expected argument \\`jsonString\\` to be a \\`string\\`, got \\`${typeof value}\\``\n    );\n  }\n\n  const strip = whitespace ? stripWithWhitespace : stripWithoutWhitespace;\n  let isInsideString: boolean | symbol = false;\n  let isInsideComment: boolean | symbol = false;\n  let offset = 0;\n  let buffer = \"\";\n  let result = \"\";\n  let commaIndex = -1;\n  for (let index = 0; index < value.length; index++) {\n    const currentCharacter = value[index];\n    const nextCharacter = value[index + 1];\n    if (!isInsideComment && currentCharacter === '\"') {\n      const escaped = isEscaped(value, index);\n      if (!escaped) {\n        isInsideString = !isInsideString;\n      }\n    }\n    if (isInsideString) {\n      continue;\n    }\n    if (\n      !isInsideComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"//\"\n    ) {\n      buffer += value.slice(offset, index);\n      offset = index;\n      isInsideComment = singleComment;\n      index++;\n    } else if (\n      isInsideComment === singleComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"\\r\\n\"\n    ) {\n      index++;\n      isInsideComment = false;\n      buffer += strip(value, offset, index);\n      offset = index;\n    } else if (isInsideComment === singleComment && currentCharacter === \"\\n\") {\n      isInsideComment = false;\n      buffer += strip(value, offset, index);\n      offset = index;\n    } else if (\n      !isInsideComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"/*\"\n    ) {\n      buffer += value.slice(offset, index);\n      offset = index;\n      isInsideComment = multiComment;\n      index++;\n    } else if (\n      isInsideComment === multiComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"*/\"\n    ) {\n      index++;\n      isInsideComment = false;\n      buffer += strip(value, offset, index + 1);\n      offset = index + 1;\n    } else if (trailingCommas && !isInsideComment) {\n      if (commaIndex !== -1) {\n        if (currentCharacter === \"}\" || currentCharacter === \"]\") {\n          buffer += value.slice(offset, index);\n          result += strip(buffer, 0, 1) + buffer.slice(1);\n          buffer = \"\";\n          offset = index;\n          commaIndex = -1;\n        } else if (\n          currentCharacter !== \" \" &&\n          currentCharacter !== \"\t\" &&\n          currentCharacter !== \"\\r\" &&\n          currentCharacter !== \"\\n\"\n        ) {\n          buffer += value.slice(offset, index);\n          offset = index;\n          commaIndex = -1;\n        }\n      } else if (currentCharacter === \",\") {\n        result += buffer + value.slice(offset, index);\n        buffer = \"\";\n        offset = index;\n        commaIndex = index;\n      }\n    }\n  }\n\n  return (\n    result +\n    buffer +\n    (isInsideComment ? strip(value.slice(offset)) : value.slice(offset))\n  );\n}\n"],"mappings":"2DAoBA,MAAM,EAAgB,OAAO,gBAAgB,CACvC,EAAe,OAAO,eAAe,CAE3C,SAAS,GAAyB,CAChC,MAAO,GAET,SAAS,EAAoB,EAAe,EAAgB,EAAc,CACxE,OAAO,EAAM,MAAM,EAAO,EAAI,CAAC,QAAQ,MAAO,IAAI,CAGpD,SAAS,EAAU,EAAe,EAAuB,CACvD,IAAI,EAAQ,EAAgB,EACxB,EAAiB,EACrB,KAAO,EAAM,KAAW,MACtB,IACA,GAAkB,EAGpB,MAAO,GAAQ,EAAiB,GAGlC,SAAgB,EACd,EACA,CAAE,aAAa,GAAM,iBAAiB,IAAU,EAAE,CAClD,CACA,GAAI,OAAO,GAAU,SACnB,MAAU,UACR,8DAA8D,OAAO,EAAM,IAC5E,CAGH,IAAM,EAAQ,EAAa,EAAsB,EAC7CA,EAAmC,GACnCC,EAAoC,GACpC,EAAS,EACT,EAAS,GACT,EAAS,GACT,EAAa,GACjB,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAM,OAAQ,IAAS,CACjD,IAAM,EAAmB,EAAM,GACzB,EAAgB,EAAM,EAAQ,GAChC,CAAC,GAAmB,IAAqB,MAC3B,EAAU,EAAO,EAAM,GAErC,EAAiB,CAAC,IAGlB,KAIF,CAAC,GACD,GAAoB,GAAiB,KAAkB,MAEvD,GAAU,EAAM,MAAM,EAAQ,EAAM,CACpC,EAAS,EACT,EAAkB,EAClB,KAEA,IAAoB,GACpB,GAAoB,GAAiB,KAAkB;GAEvD,IACA,EAAkB,GAClB,GAAU,EAAM,EAAO,EAAQ,EAAM,CACrC,EAAS,GACA,IAAoB,GAAiB,IAAqB;GACnE,EAAkB,GAClB,GAAU,EAAM,EAAO,EAAQ,EAAM,CACrC,EAAS,GAET,CAAC,GACD,GAAoB,GAAiB,KAAkB,MAEvD,GAAU,EAAM,MAAM,EAAQ,EAAM,CACpC,EAAS,EACT,EAAkB,EAClB,KAEA,IAAoB,GACpB,GAAoB,GAAiB,KAAkB,MAEvD,IACA,EAAkB,GAClB,GAAU,EAAM,EAAO,EAAQ,EAAQ,EAAE,CACzC,EAAS,EAAQ,GACR,GAAkB,CAAC,IACxB,IAAe,GAiBR,IAAqB,MAC9B,GAAU,EAAS,EAAM,MAAM,EAAQ,EAAM,CAC7C,EAAS,GACT,EAAS,EACT,EAAa,GApBT,IAAqB,KAAO,IAAqB,KACnD,GAAU,EAAM,MAAM,EAAQ,EAAM,CACpC,GAAU,EAAM,EAAQ,EAAG,EAAE,CAAG,EAAO,MAAM,EAAE,CAC/C,EAAS,GACT,EAAS,EACT,EAAa,IAEb,IAAqB,KACrB,IAAqB,KACrB,IAAqB,MACrB,IAAqB;IAErB,GAAU,EAAM,MAAM,EAAQ,EAAM,CACpC,EAAS,EACT,EAAa,MAWrB,OACE,EACA,GACC,EAAkB,EAAM,EAAM,MAAM,EAAO,CAAC,CAAG,EAAM,MAAM,EAAO"}
+{"version":3,"file":"strip-comments.mjs","names":["isInsideString: boolean | symbol","isInsideComment: boolean | symbol"],"sources":["../../../../../json/src/utils/strip-comments.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\nimport { EMPTY_STRING } from \"@stryke/types/base\";\n\nconst singleComment = Symbol(\"singleComment\");\nconst multiComment = Symbol(\"multiComment\");\n\nfunction stripWithoutWhitespace() {\n  return \"\";\n}\nfunction stripWithWhitespace(value: string, start?: number, end?: number) {\n  return value.slice(start, end).replace(/\\S/g, \" \");\n}\n\nfunction isEscaped(value: string, quotePosition: number) {\n  let index = quotePosition - 1;\n  let backslashCount = 0;\n  while (value[index] === \"\\\\\") {\n    index -= 1;\n    backslashCount += 1;\n  }\n\n  return Boolean(backslashCount % 2);\n}\n\nexport function stripComments(\n  value: string,\n  { whitespace = true, trailingCommas = false } = {}\n) {\n  if (typeof value !== \"string\") {\n    throw new TypeError(\n      `Expected argument \\`jsonString\\` to be a \\`string\\`, got \\`${typeof value}\\``\n    );\n  }\n\n  const strip = whitespace ? stripWithWhitespace : stripWithoutWhitespace;\n  let isInsideString: boolean | symbol = false;\n  let isInsideComment: boolean | symbol = false;\n  let offset = 0;\n  let buffer = \"\";\n  let result = \"\";\n  let commaIndex = -1;\n  for (let index = 0; index < value.length; index++) {\n    const currentCharacter = value[index];\n    const nextCharacter = value[index + 1];\n    if (!isInsideComment && currentCharacter === '\"') {\n      const escaped = isEscaped(value, index);\n      if (!escaped) {\n        isInsideString = !isInsideString;\n      }\n    }\n    if (isInsideString) {\n      continue;\n    }\n    if (\n      !isInsideComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"//\"\n    ) {\n      buffer += value.slice(offset, index);\n      offset = index;\n      isInsideComment = singleComment;\n      index++;\n    } else if (\n      isInsideComment === singleComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"\\r\\n\"\n    ) {\n      index++;\n      isInsideComment = false;\n      buffer += strip(value, offset, index);\n      offset = index;\n    } else if (isInsideComment === singleComment && currentCharacter === \"\\n\") {\n      isInsideComment = false;\n      buffer += strip(value, offset, index);\n      offset = index;\n    } else if (\n      !isInsideComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"/*\"\n    ) {\n      buffer += value.slice(offset, index);\n      offset = index;\n      isInsideComment = multiComment;\n      index++;\n    } else if (\n      isInsideComment === multiComment &&\n      currentCharacter + (nextCharacter ?? EMPTY_STRING) === \"*/\"\n    ) {\n      index++;\n      isInsideComment = false;\n      buffer += strip(value, offset, index + 1);\n      offset = index + 1;\n    } else if (trailingCommas && !isInsideComment) {\n      if (commaIndex !== -1) {\n        if (currentCharacter === \"}\" || currentCharacter === \"]\") {\n          buffer += value.slice(offset, index);\n          result += strip(buffer, 0, 1) + buffer.slice(1);\n          buffer = \"\";\n          offset = index;\n          commaIndex = -1;\n        } else if (\n          currentCharacter !== \" \" &&\n          currentCharacter !== \"\t\" &&\n          currentCharacter !== \"\\r\" &&\n          currentCharacter !== \"\\n\"\n        ) {\n          buffer += value.slice(offset, index);\n          offset = index;\n          commaIndex = -1;\n        }\n      } else if (currentCharacter === \",\") {\n        result += buffer + value.slice(offset, index);\n        buffer = \"\";\n        offset = index;\n        commaIndex = index;\n      }\n    }\n  }\n\n  return (\n    result +\n    buffer +\n    (isInsideComment ? strip(value.slice(offset)) : value.slice(offset))\n  );\n}\n"],"mappings":";;;AAoBA,MAAM,gBAAgB,OAAO,gBAAgB;AAC7C,MAAM,eAAe,OAAO,eAAe;AAE3C,SAAS,yBAAyB;AAChC,QAAO;;AAET,SAAS,oBAAoB,OAAe,OAAgB,KAAc;AACxE,QAAO,MAAM,MAAM,OAAO,IAAI,CAAC,QAAQ,OAAO,IAAI;;AAGpD,SAAS,UAAU,OAAe,eAAuB;CACvD,IAAI,QAAQ,gBAAgB;CAC5B,IAAI,iBAAiB;AACrB,QAAO,MAAM,WAAW,MAAM;AAC5B,WAAS;AACT,oBAAkB;;AAGpB,QAAO,QAAQ,iBAAiB,EAAE;;AAGpC,SAAgB,cACd,OACA,EAAE,aAAa,MAAM,iBAAiB,UAAU,EAAE,EAClD;AACA,KAAI,OAAO,UAAU,SACnB,OAAM,IAAI,UACR,8DAA8D,OAAO,MAAM,IAC5E;CAGH,MAAM,QAAQ,aAAa,sBAAsB;CACjD,IAAIA,iBAAmC;CACvC,IAAIC,kBAAoC;CACxC,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,aAAa;AACjB,MAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;EACjD,MAAM,mBAAmB,MAAM;EAC/B,MAAM,gBAAgB,MAAM,QAAQ;AACpC,MAAI,CAAC,mBAAmB,qBAAqB,MAE3C;OAAI,CADY,UAAU,OAAO,MAAM,CAErC,kBAAiB,CAAC;;AAGtB,MAAI,eACF;AAEF,MACE,CAAC,mBACD,oBAAoB,iBAAiB,kBAAkB,MACvD;AACA,aAAU,MAAM,MAAM,QAAQ,MAAM;AACpC,YAAS;AACT,qBAAkB;AAClB;aAEA,oBAAoB,iBACpB,oBAAoB,iBAAiB,kBAAkB,QACvD;AACA;AACA,qBAAkB;AAClB,aAAU,MAAM,OAAO,QAAQ,MAAM;AACrC,YAAS;aACA,oBAAoB,iBAAiB,qBAAqB,MAAM;AACzE,qBAAkB;AAClB,aAAU,MAAM,OAAO,QAAQ,MAAM;AACrC,YAAS;aAET,CAAC,mBACD,oBAAoB,iBAAiB,kBAAkB,MACvD;AACA,aAAU,MAAM,MAAM,QAAQ,MAAM;AACpC,YAAS;AACT,qBAAkB;AAClB;aAEA,oBAAoB,gBACpB,oBAAoB,iBAAiB,kBAAkB,MACvD;AACA;AACA,qBAAkB;AAClB,aAAU,MAAM,OAAO,QAAQ,QAAQ,EAAE;AACzC,YAAS,QAAQ;aACR,kBAAkB,CAAC,iBAC5B;OAAI,eAAe,IACjB;QAAI,qBAAqB,OAAO,qBAAqB,KAAK;AACxD,eAAU,MAAM,MAAM,QAAQ,MAAM;AACpC,eAAU,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,MAAM,EAAE;AAC/C,cAAS;AACT,cAAS;AACT,kBAAa;eAEb,qBAAqB,OACrB,qBAAqB,OACrB,qBAAqB,QACrB,qBAAqB,MACrB;AACA,eAAU,MAAM,MAAM,QAAQ,MAAM;AACpC,cAAS;AACT,kBAAa;;cAEN,qBAAqB,KAAK;AACnC,cAAU,SAAS,MAAM,MAAM,QAAQ,MAAM;AAC7C,aAAS;AACT,aAAS;AACT,iBAAa;;;;AAKnB,QACE,SACA,UACC,kBAAkB,MAAM,MAAM,MAAM,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO"}

package/dist/json.cjs

@@ -1 +1,74 @@
-const e=require(`./type-checks/src/is-error.cjs`),t=require(`./read-file.cjs`),n=require(`./write-file.cjs`),r=require(`./json/src/storm-json.cjs`);function i(n,i){let a=t.readFileSync(n);i&&(i.endsWithNewline=a.codePointAt(a.length-1)===10);try{return r.StormJSON.parseJson(a,i)}catch(t){throw e.isError(t)?(t.message=t.message.replace(`JSON`,n),t):Error(`Failed to parse JSON: ${n}`)}}async function a(n,i){let a=await t.readFile(n);i&&(i.endsWithNewline=a.codePointAt(a.length-1)===10);try{return r.StormJSON.parseJson(a,i)}catch(t){throw e.isError(t)?(t.message=t.message.replace(`JSON`,n),t):Error(`Failed to parse JSON: ${n}`)}}function o(e,t,i){let a=r.StormJSON.stringify(t,i);return n.writeFileSync(e,i?.appendNewLine?`${a}\n`:a)}async function s(e,t,i){let a=r.StormJSON.stringify(t);return n.writeFile(e,i?.appendNewLine?`${a}\n`:a)}exports.readJsonFile=a,exports.readJsonFileSync=i,exports.writeJsonFile=s,exports.writeJsonFileSync=o;
+const require_is_error = require('./type-checks/src/is-error.cjs');
+const require_read_file = require('./read-file.cjs');
+const require_write_file = require('./write-file.cjs');
+const require_storm_json = require('./json/src/storm-json.cjs');
+
+//#region src/json.ts
+/**
+* Reads a JSON file and returns the object the JSON content represents.
+*
+* @param path - A path to a file.
+* @param options - JSON parse options
+* @returns Object the JSON content of the file represents
+*/
+function readJsonFileSync(path, options) {
+	const content = require_read_file.readFileSync(path);
+	if (options) options.endsWithNewline = content.codePointAt(content.length - 1) === 10;
+	try {
+		return require_storm_json.StormJSON.parseJson(content, options);
+	} catch (error) {
+		if (require_is_error.isError(error)) {
+			error.message = error.message.replace("JSON", path);
+			throw error;
+		}
+		throw new Error(`Failed to parse JSON: ${path}`);
+	}
+}
+/**
+* Reads a JSON file and returns the object the JSON content represents.
+*
+* @param path - A path to a file.
+* @param options - JSON parse options
+* @returns Object the JSON content of the file represents
+*/
+async function readJsonFile(path, options) {
+	const content = await require_read_file.readFile(path);
+	if (options) options.endsWithNewline = content.codePointAt(content.length - 1) === 10;
+	try {
+		return require_storm_json.StormJSON.parseJson(content, options);
+	} catch (error) {
+		if (require_is_error.isError(error)) {
+			error.message = error.message.replace("JSON", path);
+			throw error;
+		}
+		throw new Error(`Failed to parse JSON: ${path}`);
+	}
+}
+/**
+* Serializes the given data to JSON and writes it to a file.
+*
+* @param path - A path to a file.
+* @param data - data which should be serialized to JSON and written to the file
+* @param options - JSON serialize options
+*/
+function writeJsonFileSync(path, data, options) {
+	const serializedJson = require_storm_json.StormJSON.stringify(data, options);
+	return require_write_file.writeFileSync(path, options?.appendNewLine ? `${serializedJson}\n` : serializedJson);
+}
+/**
+* Serializes the given data to JSON and writes it to a file asynchronously.
+*
+* @param path - A path to a file.
+* @param data - data which should be serialized to JSON and written to the file
+* @param options - JSON serialize options
+*/
+async function writeJsonFile(path, data, options) {
+	const serializedJson = require_storm_json.StormJSON.stringify(data);
+	return require_write_file.writeFile(path, options?.appendNewLine ? `${serializedJson}\n` : serializedJson);
+}
+
+//#endregion
+exports.readJsonFile = readJsonFile;
+exports.readJsonFileSync = readJsonFileSync;
+exports.writeJsonFile = writeJsonFile;
+exports.writeJsonFileSync = writeJsonFileSync;

package/dist/json.mjs

@@ -1,2 +1,72 @@
-import{isError as e}from"./type-checks/src/is-error.mjs";import{readFile as t,readFileSync as n}from"./read-file.mjs";import{writeFile as r,writeFileSync as i}from"./write-file.mjs";import{StormJSON as a}from"./json/src/storm-json.mjs";function o(t,r){let i=n(t);r&&(r.endsWithNewline=i.codePointAt(i.length-1)===10);try{return a.parseJson(i,r)}catch(n){throw e(n)?(n.message=n.message.replace(`JSON`,t),n):Error(`Failed to parse JSON: ${t}`)}}async function s(n,r){let i=await t(n);r&&(r.endsWithNewline=i.codePointAt(i.length-1)===10);try{return a.parseJson(i,r)}catch(t){throw e(t)?(t.message=t.message.replace(`JSON`,n),t):Error(`Failed to parse JSON: ${n}`)}}function c(e,t,n){let r=a.stringify(t,n);return i(e,n?.appendNewLine?`${r}\n`:r)}async function l(e,t,n){let i=a.stringify(t);return r(e,n?.appendNewLine?`${i}\n`:i)}export{s as readJsonFile,o as readJsonFileSync,l as writeJsonFile,c as writeJsonFileSync};
+import { isError } from "./type-checks/src/is-error.mjs";
+import { readFile, readFileSync } from "./read-file.mjs";
+import { writeFile, writeFileSync } from "./write-file.mjs";
+import { StormJSON } from "./json/src/storm-json.mjs";
+
+//#region src/json.ts
+/**
+* Reads a JSON file and returns the object the JSON content represents.
+*
+* @param path - A path to a file.
+* @param options - JSON parse options
+* @returns Object the JSON content of the file represents
+*/
+function readJsonFileSync(path, options) {
+	const content = readFileSync(path);
+	if (options) options.endsWithNewline = content.codePointAt(content.length - 1) === 10;
+	try {
+		return StormJSON.parseJson(content, options);
+	} catch (error) {
+		if (isError(error)) {
+			error.message = error.message.replace("JSON", path);
+			throw error;
+		}
+		throw new Error(`Failed to parse JSON: ${path}`);
+	}
+}
+/**
+* Reads a JSON file and returns the object the JSON content represents.
+*
+* @param path - A path to a file.
+* @param options - JSON parse options
+* @returns Object the JSON content of the file represents
+*/
+async function readJsonFile(path, options) {
+	const content = await readFile(path);
+	if (options) options.endsWithNewline = content.codePointAt(content.length - 1) === 10;
+	try {
+		return StormJSON.parseJson(content, options);
+	} catch (error) {
+		if (isError(error)) {
+			error.message = error.message.replace("JSON", path);
+			throw error;
+		}
+		throw new Error(`Failed to parse JSON: ${path}`);
+	}
+}
+/**
+* Serializes the given data to JSON and writes it to a file.
+*
+* @param path - A path to a file.
+* @param data - data which should be serialized to JSON and written to the file
+* @param options - JSON serialize options
+*/
+function writeJsonFileSync(path, data, options) {
+	const serializedJson = StormJSON.stringify(data, options);
+	return writeFileSync(path, options?.appendNewLine ? `${serializedJson}\n` : serializedJson);
+}
+/**
+* Serializes the given data to JSON and writes it to a file asynchronously.
+*
+* @param path - A path to a file.
+* @param data - data which should be serialized to JSON and written to the file
+* @param options - JSON serialize options
+*/
+async function writeJsonFile(path, data, options) {
+	const serializedJson = StormJSON.stringify(data);
+	return writeFile(path, options?.appendNewLine ? `${serializedJson}\n` : serializedJson);
+}
+
+//#endregion
+export { readJsonFile, readJsonFileSync, writeJsonFile, writeJsonFileSync };
 //# sourceMappingURL=json.mjs.map

package/dist/json.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"json.mjs","names":[],"sources":["../src/json.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\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport type {\n  JsonParseOptions,\n  JsonSerializeOptions\n} from \"@stryke/json/types\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { readFile, readFileSync } from \"./read-file\";\nimport { writeFile, writeFileSync } from \"./write-file\";\n\nexport interface JsonReadOptions extends JsonParseOptions {\n  /**\n   * mutable field recording whether JSON ends with new line\n   *\n   * @defaultValue false\n   */\n  endsWithNewline?: boolean;\n}\n\n/**\n * Reads a JSON file and returns the object the JSON content represents.\n *\n * @param path - A path to a file.\n * @param options - JSON parse options\n * @returns Object the JSON content of the file represents\n */\nexport function readJsonFileSync<T extends object = any>(\n  path: string,\n  options?: JsonReadOptions\n): T {\n  const content = readFileSync(path);\n  if (options) {\n    options.endsWithNewline = content.codePointAt(content.length - 1) === 10;\n  }\n\n  try {\n    return StormJSON.parseJson<T>(content, options);\n  } catch (error) {\n    if (isError(error)) {\n      error.message = error.message.replace(\"JSON\", path);\n      throw error;\n    }\n\n    throw new Error(`Failed to parse JSON: ${path}`);\n  }\n}\n\n/**\n * Reads a JSON file and returns the object the JSON content represents.\n *\n * @param path - A path to a file.\n * @param options - JSON parse options\n * @returns Object the JSON content of the file represents\n */\nexport async function readJsonFile<T extends object = any>(\n  path: string,\n  options?: JsonReadOptions\n): Promise<T> {\n  const content = await readFile(path);\n  if (options) {\n    options.endsWithNewline = content.codePointAt(content.length - 1) === 10;\n  }\n\n  try {\n    return StormJSON.parseJson<T>(content, options);\n  } catch (error) {\n    if (isError(error)) {\n      error.message = error.message.replace(\"JSON\", path);\n      throw error;\n    }\n\n    throw new Error(`Failed to parse JSON: ${path}`);\n  }\n}\n\nexport interface JsonWriteOptions extends JsonSerializeOptions {\n  /**\n   * whether to append new line at the end of JSON file\n   *\n   * @defaultValue false\n   */\n  appendNewLine?: boolean;\n}\n\n/**\n * Serializes the given data to JSON and writes it to a file.\n *\n * @param path - A path to a file.\n * @param data - data which should be serialized to JSON and written to the file\n * @param options - JSON serialize options\n */\nexport function writeJsonFileSync<T extends object = object>(\n  path: string,\n  data: T,\n  options?: JsonWriteOptions\n): void {\n  const serializedJson = StormJSON.stringify(data, options);\n\n  return writeFileSync(\n    path,\n    options?.appendNewLine ? `${serializedJson}\\n` : serializedJson\n  );\n}\n\n/**\n * Serializes the given data to JSON and writes it to a file asynchronously.\n *\n * @param path - A path to a file.\n * @param data - data which should be serialized to JSON and written to the file\n * @param options - JSON serialize options\n */\nexport async function writeJsonFile<T extends object = object>(\n  path: string,\n  data: T,\n  options?: JsonWriteOptions\n): Promise<void> {\n  const serializedJson = StormJSON.stringify(data);\n\n  return writeFile(\n    path,\n    options?.appendNewLine ? `${serializedJson}\\n` : serializedJson\n  );\n}\n"],"mappings":"4OA2CA,SAAgB,EACd,EACA,EACG,CACH,IAAM,EAAU,EAAa,EAAK,CAC9B,IACF,EAAQ,gBAAkB,EAAQ,YAAY,EAAQ,OAAS,EAAE,GAAK,IAGxE,GAAI,CACF,OAAO,EAAU,UAAa,EAAS,EAAQ,OACxC,EAAO,CAMd,MALI,EAAQ,EAAM,EAChB,EAAM,QAAU,EAAM,QAAQ,QAAQ,OAAQ,EAAK,CAC7C,GAGE,MAAM,yBAAyB,IAAO,EAWpD,eAAsB,EACpB,EACA,EACY,CACZ,IAAM,EAAU,MAAM,EAAS,EAAK,CAChC,IACF,EAAQ,gBAAkB,EAAQ,YAAY,EAAQ,OAAS,EAAE,GAAK,IAGxE,GAAI,CACF,OAAO,EAAU,UAAa,EAAS,EAAQ,OACxC,EAAO,CAMd,MALI,EAAQ,EAAM,EAChB,EAAM,QAAU,EAAM,QAAQ,QAAQ,OAAQ,EAAK,CAC7C,GAGE,MAAM,yBAAyB,IAAO,EAoBpD,SAAgB,EACd,EACA,EACA,EACM,CACN,IAAM,EAAiB,EAAU,UAAU,EAAM,EAAQ,CAEzD,OAAO,EACL,EACA,GAAS,cAAgB,GAAG,EAAe,IAAM,EAClD,CAUH,eAAsB,EACpB,EACA,EACA,EACe,CACf,IAAM,EAAiB,EAAU,UAAU,EAAK,CAEhD,OAAO,EACL,EACA,GAAS,cAAgB,GAAG,EAAe,IAAM,EAClD"}
+{"version":3,"file":"json.mjs","names":[],"sources":["../src/json.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\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport type {\n  JsonParseOptions,\n  JsonSerializeOptions\n} from \"@stryke/json/types\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { readFile, readFileSync } from \"./read-file\";\nimport { writeFile, writeFileSync } from \"./write-file\";\n\nexport interface JsonReadOptions extends JsonParseOptions {\n  /**\n   * mutable field recording whether JSON ends with new line\n   *\n   * @defaultValue false\n   */\n  endsWithNewline?: boolean;\n}\n\n/**\n * Reads a JSON file and returns the object the JSON content represents.\n *\n * @param path - A path to a file.\n * @param options - JSON parse options\n * @returns Object the JSON content of the file represents\n */\nexport function readJsonFileSync<T extends object = any>(\n  path: string,\n  options?: JsonReadOptions\n): T {\n  const content = readFileSync(path);\n  if (options) {\n    options.endsWithNewline = content.codePointAt(content.length - 1) === 10;\n  }\n\n  try {\n    return StormJSON.parseJson<T>(content, options);\n  } catch (error) {\n    if (isError(error)) {\n      error.message = error.message.replace(\"JSON\", path);\n      throw error;\n    }\n\n    throw new Error(`Failed to parse JSON: ${path}`);\n  }\n}\n\n/**\n * Reads a JSON file and returns the object the JSON content represents.\n *\n * @param path - A path to a file.\n * @param options - JSON parse options\n * @returns Object the JSON content of the file represents\n */\nexport async function readJsonFile<T extends object = any>(\n  path: string,\n  options?: JsonReadOptions\n): Promise<T> {\n  const content = await readFile(path);\n  if (options) {\n    options.endsWithNewline = content.codePointAt(content.length - 1) === 10;\n  }\n\n  try {\n    return StormJSON.parseJson<T>(content, options);\n  } catch (error) {\n    if (isError(error)) {\n      error.message = error.message.replace(\"JSON\", path);\n      throw error;\n    }\n\n    throw new Error(`Failed to parse JSON: ${path}`);\n  }\n}\n\nexport interface JsonWriteOptions extends JsonSerializeOptions {\n  /**\n   * whether to append new line at the end of JSON file\n   *\n   * @defaultValue false\n   */\n  appendNewLine?: boolean;\n}\n\n/**\n * Serializes the given data to JSON and writes it to a file.\n *\n * @param path - A path to a file.\n * @param data - data which should be serialized to JSON and written to the file\n * @param options - JSON serialize options\n */\nexport function writeJsonFileSync<T extends object = object>(\n  path: string,\n  data: T,\n  options?: JsonWriteOptions\n): void {\n  const serializedJson = StormJSON.stringify(data, options);\n\n  return writeFileSync(\n    path,\n    options?.appendNewLine ? `${serializedJson}\\n` : serializedJson\n  );\n}\n\n/**\n * Serializes the given data to JSON and writes it to a file asynchronously.\n *\n * @param path - A path to a file.\n * @param data - data which should be serialized to JSON and written to the file\n * @param options - JSON serialize options\n */\nexport async function writeJsonFile<T extends object = object>(\n  path: string,\n  data: T,\n  options?: JsonWriteOptions\n): Promise<void> {\n  const serializedJson = StormJSON.stringify(data);\n\n  return writeFile(\n    path,\n    options?.appendNewLine ? `${serializedJson}\\n` : serializedJson\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA2CA,SAAgB,iBACd,MACA,SACG;CACH,MAAM,UAAU,aAAa,KAAK;AAClC,KAAI,QACF,SAAQ,kBAAkB,QAAQ,YAAY,QAAQ,SAAS,EAAE,KAAK;AAGxE,KAAI;AACF,SAAO,UAAU,UAAa,SAAS,QAAQ;UACxC,OAAO;AACd,MAAI,QAAQ,MAAM,EAAE;AAClB,SAAM,UAAU,MAAM,QAAQ,QAAQ,QAAQ,KAAK;AACnD,SAAM;;AAGR,QAAM,IAAI,MAAM,yBAAyB,OAAO;;;;;;;;;;AAWpD,eAAsB,aACpB,MACA,SACY;CACZ,MAAM,UAAU,MAAM,SAAS,KAAK;AACpC,KAAI,QACF,SAAQ,kBAAkB,QAAQ,YAAY,QAAQ,SAAS,EAAE,KAAK;AAGxE,KAAI;AACF,SAAO,UAAU,UAAa,SAAS,QAAQ;UACxC,OAAO;AACd,MAAI,QAAQ,MAAM,EAAE;AAClB,SAAM,UAAU,MAAM,QAAQ,QAAQ,QAAQ,KAAK;AACnD,SAAM;;AAGR,QAAM,IAAI,MAAM,yBAAyB,OAAO;;;;;;;;;;AAoBpD,SAAgB,kBACd,MACA,MACA,SACM;CACN,MAAM,iBAAiB,UAAU,UAAU,MAAM,QAAQ;AAEzD,QAAO,cACL,MACA,SAAS,gBAAgB,GAAG,eAAe,MAAM,eAClD;;;;;;;;;AAUH,eAAsB,cACpB,MACA,MACA,SACe;CACf,MAAM,iBAAiB,UAAU,UAAU,KAAK;AAEhD,QAAO,UACL,MACA,SAAS,gBAAgB,GAAG,eAAe,MAAM,eAClD"}