@utilix-tech/sdk 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.21.0
+- Add `calculatePercentageChange` (percentage-change-calculator): percentage change between two numbers, with absolute change, direction, and multiplier.
+- Add `resolveJsonPointer` (json-pointer-resolver): resolve an RFC 6901 JSON Pointer against a document, with ~0/~1 escaping and clear not-found reasons.
+
 ## 0.20.0
 - Add `buildCacheControl` (cache-control-builder): assemble and explain a `Cache-Control` response header from directives, with warnings for combinations that cancel out.
 - Add `detectFillerWords` (filler-word-detector): scan text for filler words, hedge phrases, and clichés with per-phrase counts and a density score.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**556 developer utility functions for Node.js: runs locally, no API key required.**
+**558 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -66,7 +66,7 @@ const { formatJson } = require("@utilix-tech/sdk/json");
 
 ```ts
 import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
-         evaluateJsonPath, jsonToCsv, yamlToJson, jsonToYaml, getJsonStats } from "@utilix-tech/sdk/json";
+         evaluateJsonPath, resolveJsonPointer, jsonToCsv, yamlToJson, jsonToYaml, getJsonStats } from "@utilix-tech/sdk/json";
 
 // Format with 2-space indent
 formatJson('{"name":"alice","age":30}', { indent: 2 });
@@ -80,6 +80,10 @@ jsonToTypescript('{"id":1,"name":"Alice"}', { rootName: "User" });
 // Query with JSONPath
 evaluateJsonPath(obj, "$.users[*].name");
 
+// Resolve an RFC 6901 JSON Pointer
+resolveJsonPointer('{"users":[{"name":"Alice"}]}', "/users/0/name");
+// { found: true, value: "Alice", tokens: ["users", "0", "name"] }
+
 // Convert JSON to CSV
 jsonToCsv('[{"a":1,"b":2}]');
 
@@ -252,7 +256,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -310,6 +314,10 @@ calculateSimpleInterest(1000, 5, 2);
 // Present / future value (time value of money), either direction
 calculateTimeValue(1000, 5, 10, "future");
 // { presentValue: 1000, futureValue: 1628.89, growthFactor: 1.628895, ... }
+
+// Percentage change between two numbers
+calculatePercentageChange(200, 250);
+// { percentChange: 25, absoluteChange: 50, direction: "increase", multiplier: 1.25 }
 ```
 
 ---

package/dist/{chunk-U34B5XPK.js → chunk-TFNCFD3E.js}

@@ -20,6 +20,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
@@ -1337,5 +1338,28 @@ function calculateTimeValue(amount, annualRatePercent, years, direction, compoun
     interest: round22(futureValue - presentValue)
   };
 }
+function calculatePercentageChange(oldValue, newValue) {
+  if (!Number.isFinite(oldValue)) return { error: "Original value must be a finite number" };
+  if (!Number.isFinite(newValue)) return { error: "New value must be a finite number" };
+  if (oldValue === 0 && newValue !== 0) {
+    return { error: "Percentage change from zero is undefined (division by zero); use a nonzero original value" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const absoluteChange = newValue - oldValue;
+  const percentChange = oldValue === 0 ? 0 : absoluteChange / Math.abs(oldValue) * 100;
+  const multiplier = oldValue === 0 ? 1 : newValue / oldValue;
+  let direction;
+  if (absoluteChange > 0) direction = "increase";
+  else if (absoluteChange < 0) direction = "decrease";
+  else direction = "no change";
+  return {
+    oldValue,
+    newValue,
+    absoluteChange: round4(absoluteChange),
+    percentChange: round4(percentChange),
+    direction,
+    multiplier: round4(multiplier)
+  };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculatePercentageChange, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };

package/dist/{chunk-TSAGO3XP.js → chunk-WO3LJMVV.js}

@@ -24,6 +24,7 @@ __export(json_exports, {
   minifyJson: () => minifyJson,
   parseJson: () => parseJson,
   parseStructs: () => parseStructs,
+  resolveJsonPointer: () => resolveJsonPointer,
   toPascalCase: () => toPascalCase,
   toSnakeCase: () => toSnakeCase,
   validateJson: () => validateJson,
@@ -1249,5 +1250,57 @@ function jsonToZod(json, options) {
 
 export const ${rootName}Schema = ${schema}`;
 }
+function _unescapePointerToken(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function resolveJsonPointer(json, pointer) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return { pointer, found: false, tokens: [], error: "Invalid JSON input" };
+  }
+  let ptr = pointer;
+  if (ptr.startsWith("#")) {
+    ptr = ptr.slice(1);
+    try {
+      ptr = decodeURIComponent(ptr);
+    } catch {
+      return { pointer, found: false, tokens: [], error: "Invalid percent-encoding in URI-fragment pointer" };
+    }
+  }
+  if (ptr === "") {
+    return { pointer, found: true, value: parsed, tokens: [] };
+  }
+  if (!ptr.startsWith("/")) {
+    return { pointer, found: false, tokens: [], error: "Pointer must be empty or start with '/' (RFC 6901)" };
+  }
+  const tokens = ptr.split("/").slice(1).map(_unescapePointerToken);
+  let current = parsed;
+  for (const token of tokens) {
+    if (Array.isArray(current)) {
+      if (token === "-") {
+        return { pointer, found: false, tokens, failedAt: token, reason: '"-" refers to the nonexistent element after the end of the array' };
+      }
+      if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `"${token}" is not a valid array index` };
+      }
+      const idx = Number(token);
+      if (idx >= current.length) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `array index ${idx} is out of bounds (length ${current.length})` };
+      }
+      current = current[idx];
+    } else if (current !== null && typeof current === "object") {
+      const obj = current;
+      if (!Object.prototype.hasOwnProperty.call(obj, token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `key "${token}" not found` };
+      }
+      current = obj[token];
+    } else {
+      return { pointer, found: false, tokens, failedAt: token, reason: `cannot descend into ${current === null ? "null" : typeof current} at "${token}"` };
+    }
+  }
+  return { pointer, found: true, value: current, tokens };
+}
 
-export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, json_exports, minifyJson, parseJson, parseStructs, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson };
+export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, json_exports, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson };

package/dist/index.cjs

@@ -62,6 +62,7 @@ __export(json_exports, {
   minifyJson: () => minifyJson,
   parseJson: () => parseJson,
   parseStructs: () => parseStructs,
+  resolveJsonPointer: () => resolveJsonPointer,
   toPascalCase: () => toPascalCase,
   toSnakeCase: () => toSnakeCase,
   validateJson: () => validateJson,
@@ -1287,6 +1288,58 @@ function jsonToZod(json, options) {
 
 export const ${rootName}Schema = ${schema}`;
 }
+function _unescapePointerToken(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function resolveJsonPointer(json, pointer) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return { pointer, found: false, tokens: [], error: "Invalid JSON input" };
+  }
+  let ptr = pointer;
+  if (ptr.startsWith("#")) {
+    ptr = ptr.slice(1);
+    try {
+      ptr = decodeURIComponent(ptr);
+    } catch {
+      return { pointer, found: false, tokens: [], error: "Invalid percent-encoding in URI-fragment pointer" };
+    }
+  }
+  if (ptr === "") {
+    return { pointer, found: true, value: parsed, tokens: [] };
+  }
+  if (!ptr.startsWith("/")) {
+    return { pointer, found: false, tokens: [], error: "Pointer must be empty or start with '/' (RFC 6901)" };
+  }
+  const tokens = ptr.split("/").slice(1).map(_unescapePointerToken);
+  let current = parsed;
+  for (const token of tokens) {
+    if (Array.isArray(current)) {
+      if (token === "-") {
+        return { pointer, found: false, tokens, failedAt: token, reason: '"-" refers to the nonexistent element after the end of the array' };
+      }
+      if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `"${token}" is not a valid array index` };
+      }
+      const idx = Number(token);
+      if (idx >= current.length) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `array index ${idx} is out of bounds (length ${current.length})` };
+      }
+      current = current[idx];
+    } else if (current !== null && typeof current === "object") {
+      const obj = current;
+      if (!Object.prototype.hasOwnProperty.call(obj, token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `key "${token}" not found` };
+      }
+      current = obj[token];
+    } else {
+      return { pointer, found: false, tokens, failedAt: token, reason: `cannot descend into ${current === null ? "null" : typeof current} at "${token}"` };
+    }
+  }
+  return { pointer, found: true, value: current, tokens };
+}
 
 // src/tools/encoding.ts
 var encoding_exports = {};
@@ -6784,6 +6837,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
@@ -8101,6 +8155,29 @@ function calculateTimeValue(amount, annualRatePercent, years, direction, compoun
     interest: round23(futureValue - presentValue)
   };
 }
+function calculatePercentageChange(oldValue, newValue) {
+  if (!Number.isFinite(oldValue)) return { error: "Original value must be a finite number" };
+  if (!Number.isFinite(newValue)) return { error: "New value must be a finite number" };
+  if (oldValue === 0 && newValue !== 0) {
+    return { error: "Percentage change from zero is undefined (division by zero); use a nonzero original value" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const absoluteChange = newValue - oldValue;
+  const percentChange = oldValue === 0 ? 0 : absoluteChange / Math.abs(oldValue) * 100;
+  const multiplier = oldValue === 0 ? 1 : newValue / oldValue;
+  let direction;
+  if (absoluteChange > 0) direction = "increase";
+  else if (absoluteChange < 0) direction = "decrease";
+  else direction = "no change";
+  return {
+    oldValue,
+    newValue,
+    absoluteChange: round4(absoluteChange),
+    percentChange: round4(percentChange),
+    direction,
+    multiplier: round4(multiplier)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-export { j as json } from './json-BjSoIS1h.cjs';
+export { j as json } from './json-DEVFIpsC.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
 export { t as text } from './text-DS70aMY5.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
-export { u as units } from './units-BFTQwpBu.cjs';
+export { u as units } from './units-pIRkHnsU.cjs';
 export { n as network } from './network-BJOjJnmY.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-DaRvff2v.cjs';

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export { j as json } from './json-BjSoIS1h.js';
+export { j as json } from './json-DEVFIpsC.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CnetQFD_.js';
 export { t as text } from './text-DS70aMY5.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
-export { u as units } from './units-BFTQwpBu.js';
+export { u as units } from './units-pIRkHnsU.js';
 export { n as network } from './network-BJOjJnmY.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-DaRvff2v.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-U34B5XPK.js';
+export { units_exports as units } from './chunk-TFNCFD3E.js';
 export { network_exports as network } from './chunk-Y5OOP6WN.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
@@ -7,7 +7,7 @@ export { color_exports as color } from './chunk-BPVAB4P2.js';
 export { css_exports as css } from './chunk-6YPV2AB5.js';
 export { misc_exports as misc } from './chunk-GX7H6TAX.js';
 export { ai_agent_exports as ai_agent } from './chunk-265NPGKH.js';
-export { json_exports as json } from './chunk-TSAGO3XP.js';
+export { json_exports as json } from './chunk-WO3LJMVV.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
 export { text_exports as text } from './chunk-2I4O5YCT.js';

package/dist/{json-BjSoIS1h.d.cts → json-DEVFIpsC.d.cts}

@@ -148,6 +148,28 @@ interface ZodOptions {
 declare function jsonToZod(json: string, options?: ZodOptions): string | {
     error: string;
 };
+interface JsonPointerResult {
+    pointer: string;
+    found: boolean;
+    value?: unknown;
+    /** Decoded reference tokens (after ~1 -> / and ~0 -> ~ unescaping). */
+    tokens: string[];
+    /** Set when the input JSON is invalid or the pointer syntax is malformed. */
+    error?: string;
+    /** The reference token at which resolution stopped (found === false). */
+    failedAt?: string;
+    /** Why resolution stopped at `failedAt`. */
+    reason?: string;
+}
+/**
+ * Resolve an RFC 6901 JSON Pointer against a JSON document. Accepts both the
+ * plain form ("" for the whole document, or "/foo/0") and the URI-fragment
+ * form ("#/foo/0", percent-decoded). Distinguishes an invalid document /
+ * malformed pointer (`error`) from a syntactically valid pointer whose target
+ * is simply absent (`found: false` with `failedAt` + `reason`). Pure
+ * traversal, no external calls.
+ */
+declare function resolveJsonPointer(json: string, pointer: string): JsonPointerResult;
 
 type json_ConvertOptions = ConvertOptions;
 type json_CsvOptions = CsvOptions;
@@ -158,6 +180,7 @@ type json_GoStruct = GoStruct;
 type json_JsonDiffResult = JsonDiffResult;
 type json_JsonParseResult = JsonParseResult;
 type json_JsonPathResult = JsonPathResult;
+type json_JsonPointerResult = JsonPointerResult;
 type json_ParseStatus = ParseStatus;
 type json_PythonClass = PythonClass;
 type json_PythonField = PythonField;
@@ -185,6 +208,7 @@ declare const json_jsonToZod: typeof jsonToZod;
 declare const json_minifyJson: typeof minifyJson;
 declare const json_parseJson: typeof parseJson;
 declare const json_parseStructs: typeof parseStructs;
+declare const json_resolveJsonPointer: typeof resolveJsonPointer;
 declare const json_toPascalCase: typeof toPascalCase;
 declare const json_toSnakeCase: typeof toSnakeCase;
 declare const json_validateJson: typeof validateJson;
@@ -192,7 +216,7 @@ declare const json_validateJsonPath: typeof validateJsonPath;
 declare const json_validateJsonString: typeof validateJsonString;
 declare const json_yamlToJson: typeof yamlToJson;
 declare namespace json {
-  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
+  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_JsonPointerResult as JsonPointerResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_resolveJsonPointer as resolveJsonPointer, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
 }
 
-export { jsonToZod as A, minifyJson as B, type ConvertOptions as C, type DiffNode as D, parseJson as E, parseStructs as F, type GoField as G, toPascalCase as H, toSnakeCase as I, type JsonDiffResult as J, validateJson as K, validateJsonPath as L, validateJsonString as M, yamlToJson as N, type ParseStatus as P, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type PythonClass as f, type PythonField as g, type PythonMode as h, type ValidationResult as i, json as j, csvToJson as k, detectFormat as l, diffJson as m, evaluateJsonPath as n, formatDiffLine as o, formatJson as p, generateExample as q, getJsonStats as r, inferGoType as s, inferPythonType as t, inferType as u, jsonToCsv as v, jsonToGo as w, jsonToPython as x, jsonToTypescript as y, jsonToYaml as z };
+export { jsonToYaml as A, jsonToZod as B, type ConvertOptions as C, type DiffNode as D, minifyJson as E, parseJson as F, type GoField as G, parseStructs as H, resolveJsonPointer as I, type JsonDiffResult as J, toPascalCase as K, toSnakeCase as L, validateJson as M, validateJsonPath as N, validateJsonString as O, type ParseStatus as P, yamlToJson as Q, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type JsonPointerResult as f, type PythonClass as g, type PythonField as h, type PythonMode as i, json as j, type ValidationResult as k, csvToJson as l, detectFormat as m, diffJson as n, evaluateJsonPath as o, formatDiffLine as p, formatJson as q, generateExample as r, getJsonStats as s, inferGoType as t, inferPythonType as u, inferType as v, jsonToCsv as w, jsonToGo as x, jsonToPython as y, jsonToTypescript as z };

package/dist/{json-BjSoIS1h.d.ts → json-DEVFIpsC.d.ts}

@@ -148,6 +148,28 @@ interface ZodOptions {
 declare function jsonToZod(json: string, options?: ZodOptions): string | {
     error: string;
 };
+interface JsonPointerResult {
+    pointer: string;
+    found: boolean;
+    value?: unknown;
+    /** Decoded reference tokens (after ~1 -> / and ~0 -> ~ unescaping). */
+    tokens: string[];
+    /** Set when the input JSON is invalid or the pointer syntax is malformed. */
+    error?: string;
+    /** The reference token at which resolution stopped (found === false). */
+    failedAt?: string;
+    /** Why resolution stopped at `failedAt`. */
+    reason?: string;
+}
+/**
+ * Resolve an RFC 6901 JSON Pointer against a JSON document. Accepts both the
+ * plain form ("" for the whole document, or "/foo/0") and the URI-fragment
+ * form ("#/foo/0", percent-decoded). Distinguishes an invalid document /
+ * malformed pointer (`error`) from a syntactically valid pointer whose target
+ * is simply absent (`found: false` with `failedAt` + `reason`). Pure
+ * traversal, no external calls.
+ */
+declare function resolveJsonPointer(json: string, pointer: string): JsonPointerResult;
 
 type json_ConvertOptions = ConvertOptions;
 type json_CsvOptions = CsvOptions;
@@ -158,6 +180,7 @@ type json_GoStruct = GoStruct;
 type json_JsonDiffResult = JsonDiffResult;
 type json_JsonParseResult = JsonParseResult;
 type json_JsonPathResult = JsonPathResult;
+type json_JsonPointerResult = JsonPointerResult;
 type json_ParseStatus = ParseStatus;
 type json_PythonClass = PythonClass;
 type json_PythonField = PythonField;
@@ -185,6 +208,7 @@ declare const json_jsonToZod: typeof jsonToZod;
 declare const json_minifyJson: typeof minifyJson;
 declare const json_parseJson: typeof parseJson;
 declare const json_parseStructs: typeof parseStructs;
+declare const json_resolveJsonPointer: typeof resolveJsonPointer;
 declare const json_toPascalCase: typeof toPascalCase;
 declare const json_toSnakeCase: typeof toSnakeCase;
 declare const json_validateJson: typeof validateJson;
@@ -192,7 +216,7 @@ declare const json_validateJsonPath: typeof validateJsonPath;
 declare const json_validateJsonString: typeof validateJsonString;
 declare const json_yamlToJson: typeof yamlToJson;
 declare namespace json {
-  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
+  export { type json_ConvertOptions as ConvertOptions, type json_CsvOptions as CsvOptions, type json_DiffNode as DiffNode, type json_DiffType as DiffType, type json_GoField as GoField, type json_GoStruct as GoStruct, type json_JsonDiffResult as JsonDiffResult, type json_JsonParseResult as JsonParseResult, type json_JsonPathResult as JsonPathResult, type json_JsonPointerResult as JsonPointerResult, type json_ParseStatus as ParseStatus, type json_PythonClass as PythonClass, type json_PythonField as PythonField, type json_PythonMode as PythonMode, type json_ValidationError as ValidationError, type json_ValidationResult as ValidationResult, type json_ZodOptions as ZodOptions, json_csvToJson as csvToJson, json_detectFormat as detectFormat, json_diffJson as diffJson, json_evaluateJsonPath as evaluateJsonPath, json_formatDiffLine as formatDiffLine, json_formatJson as formatJson, json_generateExample as generateExample, json_getJsonStats as getJsonStats, json_inferGoType as inferGoType, json_inferPythonType as inferPythonType, json_inferType as inferType, json_jsonToCsv as jsonToCsv, json_jsonToGo as jsonToGo, json_jsonToPython as jsonToPython, json_jsonToTypescript as jsonToTypescript, json_jsonToYaml as jsonToYaml, json_jsonToZod as jsonToZod, json_minifyJson as minifyJson, json_parseJson as parseJson, json_parseStructs as parseStructs, json_resolveJsonPointer as resolveJsonPointer, json_toPascalCase as toPascalCase, json_toSnakeCase as toSnakeCase, json_validateJson as validateJson, json_validateJsonPath as validateJsonPath, json_validateJsonString as validateJsonString, json_yamlToJson as yamlToJson };
 }
 
-export { jsonToZod as A, minifyJson as B, type ConvertOptions as C, type DiffNode as D, parseJson as E, parseStructs as F, type GoField as G, toPascalCase as H, toSnakeCase as I, type JsonDiffResult as J, validateJson as K, validateJsonPath as L, validateJsonString as M, yamlToJson as N, type ParseStatus as P, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type PythonClass as f, type PythonField as g, type PythonMode as h, type ValidationResult as i, json as j, csvToJson as k, detectFormat as l, diffJson as m, evaluateJsonPath as n, formatDiffLine as o, formatJson as p, generateExample as q, getJsonStats as r, inferGoType as s, inferPythonType as t, inferType as u, jsonToCsv as v, jsonToGo as w, jsonToPython as x, jsonToTypescript as y, jsonToYaml as z };
+export { jsonToYaml as A, jsonToZod as B, type ConvertOptions as C, type DiffNode as D, minifyJson as E, parseJson as F, type GoField as G, parseStructs as H, resolveJsonPointer as I, type JsonDiffResult as J, toPascalCase as K, toSnakeCase as L, validateJson as M, validateJsonPath as N, validateJsonString as O, type ParseStatus as P, yamlToJson as Q, type ValidationError as V, type ZodOptions as Z, type CsvOptions as a, type DiffType as b, type GoStruct as c, type JsonParseResult as d, type JsonPathResult as e, type JsonPointerResult as f, type PythonClass as g, type PythonField as h, type PythonMode as i, json as j, type ValidationResult as k, csvToJson as l, detectFormat as m, diffJson as n, evaluateJsonPath as o, formatDiffLine as p, formatJson as q, generateExample as r, getJsonStats as s, inferGoType as t, inferPythonType as u, inferType as v, jsonToCsv as w, jsonToGo as x, jsonToPython as y, jsonToTypescript as z };

package/dist/tools/json.cjs

@@ -1241,6 +1241,58 @@ function jsonToZod(json, options) {
 
 export const ${rootName}Schema = ${schema}`;
 }
+function _unescapePointerToken(token) {
+  return token.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function resolveJsonPointer(json, pointer) {
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return { pointer, found: false, tokens: [], error: "Invalid JSON input" };
+  }
+  let ptr = pointer;
+  if (ptr.startsWith("#")) {
+    ptr = ptr.slice(1);
+    try {
+      ptr = decodeURIComponent(ptr);
+    } catch {
+      return { pointer, found: false, tokens: [], error: "Invalid percent-encoding in URI-fragment pointer" };
+    }
+  }
+  if (ptr === "") {
+    return { pointer, found: true, value: parsed, tokens: [] };
+  }
+  if (!ptr.startsWith("/")) {
+    return { pointer, found: false, tokens: [], error: "Pointer must be empty or start with '/' (RFC 6901)" };
+  }
+  const tokens = ptr.split("/").slice(1).map(_unescapePointerToken);
+  let current = parsed;
+  for (const token of tokens) {
+    if (Array.isArray(current)) {
+      if (token === "-") {
+        return { pointer, found: false, tokens, failedAt: token, reason: '"-" refers to the nonexistent element after the end of the array' };
+      }
+      if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `"${token}" is not a valid array index` };
+      }
+      const idx = Number(token);
+      if (idx >= current.length) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `array index ${idx} is out of bounds (length ${current.length})` };
+      }
+      current = current[idx];
+    } else if (current !== null && typeof current === "object") {
+      const obj = current;
+      if (!Object.prototype.hasOwnProperty.call(obj, token)) {
+        return { pointer, found: false, tokens, failedAt: token, reason: `key "${token}" not found` };
+      }
+      current = obj[token];
+    } else {
+      return { pointer, found: false, tokens, failedAt: token, reason: `cannot descend into ${current === null ? "null" : typeof current} at "${token}"` };
+    }
+  }
+  return { pointer, found: true, value: current, tokens };
+}
 
 exports.csvToJson = csvToJson;
 exports.detectFormat = detectFormat;
@@ -1262,6 +1314,7 @@ exports.jsonToZod = jsonToZod;
 exports.minifyJson = minifyJson;
 exports.parseJson = parseJson;
 exports.parseStructs = parseStructs;
+exports.resolveJsonPointer = resolveJsonPointer;
 exports.toPascalCase = toPascalCase;
 exports.toSnakeCase = toSnakeCase;
 exports.validateJson = validateJson;

package/dist/tools/json.d.cts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, P as ParseStatus, f as PythonClass, g as PythonField, h as PythonMode, V as ValidationError, i as ValidationResult, Z as ZodOptions, k as csvToJson, l as detectFormat, m as diffJson, n as evaluateJsonPath, o as formatDiffLine, p as formatJson, q as generateExample, r as getJsonStats, s as inferGoType, t as inferPythonType, u as inferType, v as jsonToCsv, w as jsonToGo, x as jsonToPython, y as jsonToTypescript, z as jsonToYaml, A as jsonToZod, B as minifyJson, E as parseJson, F as parseStructs, H as toPascalCase, I as toSnakeCase, K as validateJson, L as validateJsonPath, M as validateJsonString, N as yamlToJson } from '../json-BjSoIS1h.cjs';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, P as ParseStatus, g as PythonClass, h as PythonField, i as PythonMode, V as ValidationError, k as ValidationResult, Z as ZodOptions, l as csvToJson, m as detectFormat, n as diffJson, o as evaluateJsonPath, p as formatDiffLine, q as formatJson, r as generateExample, s as getJsonStats, t as inferGoType, u as inferPythonType, v as inferType, w as jsonToCsv, x as jsonToGo, y as jsonToPython, z as jsonToTypescript, A as jsonToYaml, B as jsonToZod, E as minifyJson, F as parseJson, H as parseStructs, I as resolveJsonPointer, K as toPascalCase, L as toSnakeCase, M as validateJson, N as validateJsonPath, O as validateJsonString, Q as yamlToJson } from '../json-DEVFIpsC.cjs';

package/dist/tools/json.d.ts

@@ -1 +1 @@
-export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, P as ParseStatus, f as PythonClass, g as PythonField, h as PythonMode, V as ValidationError, i as ValidationResult, Z as ZodOptions, k as csvToJson, l as detectFormat, m as diffJson, n as evaluateJsonPath, o as formatDiffLine, p as formatJson, q as generateExample, r as getJsonStats, s as inferGoType, t as inferPythonType, u as inferType, v as jsonToCsv, w as jsonToGo, x as jsonToPython, y as jsonToTypescript, z as jsonToYaml, A as jsonToZod, B as minifyJson, E as parseJson, F as parseStructs, H as toPascalCase, I as toSnakeCase, K as validateJson, L as validateJsonPath, M as validateJsonString, N as yamlToJson } from '../json-BjSoIS1h.js';
+export { C as ConvertOptions, a as CsvOptions, D as DiffNode, b as DiffType, G as GoField, c as GoStruct, J as JsonDiffResult, d as JsonParseResult, e as JsonPathResult, f as JsonPointerResult, P as ParseStatus, g as PythonClass, h as PythonField, i as PythonMode, V as ValidationError, k as ValidationResult, Z as ZodOptions, l as csvToJson, m as detectFormat, n as diffJson, o as evaluateJsonPath, p as formatDiffLine, q as formatJson, r as generateExample, s as getJsonStats, t as inferGoType, u as inferPythonType, v as inferType, w as jsonToCsv, x as jsonToGo, y as jsonToPython, z as jsonToTypescript, A as jsonToYaml, B as jsonToZod, E as minifyJson, F as parseJson, H as parseStructs, I as resolveJsonPointer, K as toPascalCase, L as toSnakeCase, M as validateJson, N as validateJsonPath, O as validateJsonString, Q as yamlToJson } from '../json-DEVFIpsC.js';

package/dist/tools/json.js

@@ -1,2 +1,2 @@
-export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, minifyJson, parseJson, parseStructs, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-TSAGO3XP.js';
+export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson } from '../chunk-WO3LJMVV.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/units.cjs

@@ -1264,6 +1264,29 @@ function calculateTimeValue(amount, annualRatePercent, years, direction, compoun
     interest: round22(futureValue - presentValue)
   };
 }
+function calculatePercentageChange(oldValue, newValue) {
+  if (!Number.isFinite(oldValue)) return { error: "Original value must be a finite number" };
+  if (!Number.isFinite(newValue)) return { error: "New value must be a finite number" };
+  if (oldValue === 0 && newValue !== 0) {
+    return { error: "Percentage change from zero is undefined (division by zero); use a nonzero original value" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const absoluteChange = newValue - oldValue;
+  const percentChange = oldValue === 0 ? 0 : absoluteChange / Math.abs(oldValue) * 100;
+  const multiplier = oldValue === 0 ? 1 : newValue / oldValue;
+  let direction;
+  if (absoluteChange > 0) direction = "increase";
+  else if (absoluteChange < 0) direction = "decrease";
+  else direction = "no change";
+  return {
+    oldValue,
+    newValue,
+    absoluteChange: round4(absoluteChange),
+    percentChange: round4(percentChange),
+    direction,
+    multiplier: round4(multiplier)
+  };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1282,6 +1305,7 @@ exports.calcAspectRatio = calcAspectRatio;
 exports.calcSubnet = calcSubnet;
 exports.calculateCompoundInterest = calculateCompoundInterest;
 exports.calculateLoan = calculateLoan;
+exports.calculatePercentageChange = calculatePercentageChange;
 exports.calculateSimpleInterest = calculateSimpleInterest;
 exports.calculateTax = calculateTax;
 exports.calculateTimeValue = calculateTimeValue;

package/dist/tools/units.d.cts

@@ -1 +1 @@
-export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BarcodeFormat, e as BarcodeValidationResult, f as BaseConvertResult, g as ByteConvertResult, h as ByteUnit, C as COMMON_CURRENCIES, i as COMMON_LOCALES, j as COMMON_PERMISSIONS, k as COMMON_RATIOS, l as COMMON_SIZES, m as COMMON_TAX_RATES, n as COMMON_TIP_PERCENTAGES, o as COMMON_VIEWPORTS, p as CardValidationResult, q as CompoundInterestResult, r as CompoundYearRow, D as Dimensions, F as FilePermissions, s as FormatOptions, I as IbanValidationResult, t as IpConversion, v as IsbnFormat, w as IsbnResult, L as LoanResult, N as NotationStyle, x as NumberBase, P as Permission, y as PxConvertResult, S as SemverVersion, z as SimpleInterestResult, E as SubnetInfo, T as TaxDirection, G as TaxResult, H as TimeValueDirection, J as TimeValueResult, K as TipSplitResult, V as ViewportConvertResult, M as autoFormat, O as bumpVersion, Q as calcAspectRatio, R as calcSubnet, U as calculateCompoundInterest, W as calculateLoan, X as calculateSimpleInterest, Y as calculateTax, Z as calculateTimeValue, _ as calculateTipSplit, $ as compareSemver, a0 as convert, a1 as convertBytes, a2 as convertIp, a3 as coverBox, a4 as decimalToIp, a5 as decimalToIpCidr, a6 as describePermissions, a7 as fitIntoBox, a8 as formatNumber, a9 as formatValue, aa as formatVwValue, ab as formatWithSeparator, ac as gcd, ad as ipFromBinary, ae as ipFromDecimal, af as ipFromHex, ag as ipToBinary, ah as ipToDecimal, ai as ipToDecimalCidr, aj as ipToHex, ak as ipToOctal, al as isValid, am as isValidCidr, an as isValidIp, ao as isValidIpv4, ap as octalToPermissions, aq as parseFileSize, ar as parseInput, as as parseNumberString, at as parseSemver, au as permissionsToChmod, av as permissionsToOctal, aw as permissionsToSymbolic, ax as ptToPx, ay as pxToAll, az as pxToViewport, aA as remToPx, aB as satisfiesRange, aC as scaleByHeight, aD as scaleByWidth, aE as sortVersions, aF as splitSubnet, aG as symbolicToPermissions, aH as validateBarcode, aI as validateCardNumber, aJ as validateIban, aK as validateIsbn, aL as viewportToPx } from '../units-BFTQwpBu.cjs';
+export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BarcodeFormat, e as BarcodeValidationResult, f as BaseConvertResult, g as ByteConvertResult, h as ByteUnit, C as COMMON_CURRENCIES, i as COMMON_LOCALES, j as COMMON_PERMISSIONS, k as COMMON_RATIOS, l as COMMON_SIZES, m as COMMON_TAX_RATES, n as COMMON_TIP_PERCENTAGES, o as COMMON_VIEWPORTS, p as CardValidationResult, q as CompoundInterestResult, r as CompoundYearRow, D as Dimensions, F as FilePermissions, s as FormatOptions, I as IbanValidationResult, t as IpConversion, v as IsbnFormat, w as IsbnResult, L as LoanResult, N as NotationStyle, x as NumberBase, P as PercentChangeDirection, y as PercentageChangeResult, z as Permission, E as PxConvertResult, S as SemverVersion, G as SimpleInterestResult, H as SubnetInfo, T as TaxDirection, J as TaxResult, K as TimeValueDirection, M as TimeValueResult, O as TipSplitResult, V as ViewportConvertResult, Q as autoFormat, R as bumpVersion, U as calcAspectRatio, W as calcSubnet, X as calculateCompoundInterest, Y as calculateLoan, Z as calculatePercentageChange, _ as calculateSimpleInterest, $ as calculateTax, a0 as calculateTimeValue, a1 as calculateTipSplit, a2 as compareSemver, a3 as convert, a4 as convertBytes, a5 as convertIp, a6 as coverBox, a7 as decimalToIp, a8 as decimalToIpCidr, a9 as describePermissions, aa as fitIntoBox, ab as formatNumber, ac as formatValue, ad as formatVwValue, ae as formatWithSeparator, af as gcd, ag as ipFromBinary, ah as ipFromDecimal, ai as ipFromHex, aj as ipToBinary, ak as ipToDecimal, al as ipToDecimalCidr, am as ipToHex, an as ipToOctal, ao as isValid, ap as isValidCidr, aq as isValidIp, ar as isValidIpv4, as as octalToPermissions, at as parseFileSize, au as parseInput, av as parseNumberString, aw as parseSemver, ax as permissionsToChmod, ay as permissionsToOctal, az as permissionsToSymbolic, aA as ptToPx, aB as pxToAll, aC as pxToViewport, aD as remToPx, aE as satisfiesRange, aF as scaleByHeight, aG as scaleByWidth, aH as sortVersions, aI as splitSubnet, aJ as symbolicToPermissions, aK as validateBarcode, aL as validateCardNumber, aM as validateIban, aN as validateIsbn, aO as viewportToPx } from '../units-pIRkHnsU.cjs';

package/dist/tools/units.d.ts

@@ -1 +1 @@
-export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BarcodeFormat, e as BarcodeValidationResult, f as BaseConvertResult, g as ByteConvertResult, h as ByteUnit, C as COMMON_CURRENCIES, i as COMMON_LOCALES, j as COMMON_PERMISSIONS, k as COMMON_RATIOS, l as COMMON_SIZES, m as COMMON_TAX_RATES, n as COMMON_TIP_PERCENTAGES, o as COMMON_VIEWPORTS, p as CardValidationResult, q as CompoundInterestResult, r as CompoundYearRow, D as Dimensions, F as FilePermissions, s as FormatOptions, I as IbanValidationResult, t as IpConversion, v as IsbnFormat, w as IsbnResult, L as LoanResult, N as NotationStyle, x as NumberBase, P as Permission, y as PxConvertResult, S as SemverVersion, z as SimpleInterestResult, E as SubnetInfo, T as TaxDirection, G as TaxResult, H as TimeValueDirection, J as TimeValueResult, K as TipSplitResult, V as ViewportConvertResult, M as autoFormat, O as bumpVersion, Q as calcAspectRatio, R as calcSubnet, U as calculateCompoundInterest, W as calculateLoan, X as calculateSimpleInterest, Y as calculateTax, Z as calculateTimeValue, _ as calculateTipSplit, $ as compareSemver, a0 as convert, a1 as convertBytes, a2 as convertIp, a3 as coverBox, a4 as decimalToIp, a5 as decimalToIpCidr, a6 as describePermissions, a7 as fitIntoBox, a8 as formatNumber, a9 as formatValue, aa as formatVwValue, ab as formatWithSeparator, ac as gcd, ad as ipFromBinary, ae as ipFromDecimal, af as ipFromHex, ag as ipToBinary, ah as ipToDecimal, ai as ipToDecimalCidr, aj as ipToHex, ak as ipToOctal, al as isValid, am as isValidCidr, an as isValidIp, ao as isValidIpv4, ap as octalToPermissions, aq as parseFileSize, ar as parseInput, as as parseNumberString, at as parseSemver, au as permissionsToChmod, av as permissionsToOctal, aw as permissionsToSymbolic, ax as ptToPx, ay as pxToAll, az as pxToViewport, aA as remToPx, aB as satisfiesRange, aC as scaleByHeight, aD as scaleByWidth, aE as sortVersions, aF as splitSubnet, aG as symbolicToPermissions, aH as validateBarcode, aI as validateCardNumber, aJ as validateIban, aK as validateIsbn, aL as viewportToPx } from '../units-BFTQwpBu.js';
+export { A as AmortizationRow, a as AspectRatioResult, B as BASE_LABELS, b as BASE_PREFIXES, c as BYTE_UNITS, d as BarcodeFormat, e as BarcodeValidationResult, f as BaseConvertResult, g as ByteConvertResult, h as ByteUnit, C as COMMON_CURRENCIES, i as COMMON_LOCALES, j as COMMON_PERMISSIONS, k as COMMON_RATIOS, l as COMMON_SIZES, m as COMMON_TAX_RATES, n as COMMON_TIP_PERCENTAGES, o as COMMON_VIEWPORTS, p as CardValidationResult, q as CompoundInterestResult, r as CompoundYearRow, D as Dimensions, F as FilePermissions, s as FormatOptions, I as IbanValidationResult, t as IpConversion, v as IsbnFormat, w as IsbnResult, L as LoanResult, N as NotationStyle, x as NumberBase, P as PercentChangeDirection, y as PercentageChangeResult, z as Permission, E as PxConvertResult, S as SemverVersion, G as SimpleInterestResult, H as SubnetInfo, T as TaxDirection, J as TaxResult, K as TimeValueDirection, M as TimeValueResult, O as TipSplitResult, V as ViewportConvertResult, Q as autoFormat, R as bumpVersion, U as calcAspectRatio, W as calcSubnet, X as calculateCompoundInterest, Y as calculateLoan, Z as calculatePercentageChange, _ as calculateSimpleInterest, $ as calculateTax, a0 as calculateTimeValue, a1 as calculateTipSplit, a2 as compareSemver, a3 as convert, a4 as convertBytes, a5 as convertIp, a6 as coverBox, a7 as decimalToIp, a8 as decimalToIpCidr, a9 as describePermissions, aa as fitIntoBox, ab as formatNumber, ac as formatValue, ad as formatVwValue, ae as formatWithSeparator, af as gcd, ag as ipFromBinary, ah as ipFromDecimal, ai as ipFromHex, aj as ipToBinary, ak as ipToDecimal, al as ipToDecimalCidr, am as ipToHex, an as ipToOctal, ao as isValid, ap as isValidCidr, aq as isValidIp, ar as isValidIpv4, as as octalToPermissions, at as parseFileSize, au as parseInput, av as parseNumberString, aw as parseSemver, ax as permissionsToChmod, ay as permissionsToOctal, az as permissionsToSymbolic, aA as ptToPx, aB as pxToAll, aC as pxToViewport, aD as remToPx, aE as satisfiesRange, aF as scaleByHeight, aG as scaleByWidth, aH as sortVersions, aI as splitSubnet, aJ as symbolicToPermissions, aK as validateBarcode, aL as validateCardNumber, aM as validateIban, aN as validateIsbn, aO as viewportToPx } from '../units-pIRkHnsU.js';

package/dist/tools/units.js

@@ -1,2 +1,2 @@
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx } from '../chunk-U34B5XPK.js';
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculatePercentageChange, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx } from '../chunk-TFNCFD3E.js';
 import '../chunk-MLKGABMK.js';

package/dist/{units-BFTQwpBu.d.cts → units-pIRkHnsU.d.cts}

@@ -429,6 +429,25 @@ interface TimeValueResult {
 declare function calculateTimeValue(amount: number, annualRatePercent: number, years: number, direction: TimeValueDirection, compoundsPerYear?: number): TimeValueResult | {
     error: string;
 };
+type PercentChangeDirection = "increase" | "decrease" | "no change";
+interface PercentageChangeResult {
+    oldValue: number;
+    newValue: number;
+    absoluteChange: number;
+    percentChange: number;
+    direction: PercentChangeDirection;
+    multiplier: number;
+}
+/**
+ * Percentage change from oldValue to newValue: ((new - old) / |old|) * 100.
+ * `absoluteChange` is the raw difference (new - old) and `multiplier` is
+ * new / old (how many times the original the new value is). The original
+ * value cannot be zero (division by zero) unless the new value is also zero.
+ * Pure arithmetic over user-supplied numbers.
+ */
+declare function calculatePercentageChange(oldValue: number, newValue: number): PercentageChangeResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
@@ -461,6 +480,8 @@ type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
+type units_PercentChangeDirection = PercentChangeDirection;
+type units_PercentageChangeResult = PercentageChangeResult;
 type units_Permission = Permission;
 type units_PxConvertResult = PxConvertResult;
 type units_SemverVersion = SemverVersion;
@@ -478,6 +499,7 @@ declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
+declare const units_calculatePercentageChange: typeof calculatePercentageChange;
 declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_calculateTimeValue: typeof calculateTimeValue;
@@ -532,7 +554,7 @@ declare const units_validateIban: typeof validateIban;
 declare const units_validateIsbn: typeof validateIsbn;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_TAX_RATES as COMMON_TAX_RATES, units_COMMON_TIP_PERCENTAGES as COMMON_TIP_PERCENTAGES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SimpleInterestResult as SimpleInterestResult, type units_SubnetInfo as SubnetInfo, type units_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_TimeValueDirection as TimeValueDirection, type units_TimeValueResult as TimeValueResult, type units_TipSplitResult as TipSplitResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculateSimpleInterest as calculateSimpleInterest, units_calculateTax as calculateTax, units_calculateTimeValue as calculateTimeValue, units_calculateTipSplit as calculateTipSplit, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
+  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_TAX_RATES as COMMON_TAX_RATES, units_COMMON_TIP_PERCENTAGES as COMMON_TIP_PERCENTAGES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_PercentChangeDirection as PercentChangeDirection, type units_PercentageChangeResult as PercentageChangeResult, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SimpleInterestResult as SimpleInterestResult, type units_SubnetInfo as SubnetInfo, type units_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_TimeValueDirection as TimeValueDirection, type units_TimeValueResult as TimeValueResult, type units_TipSplitResult as TipSplitResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculatePercentageChange as calculatePercentageChange, units_calculateSimpleInterest as calculateSimpleInterest, units_calculateTax as calculateTax, units_calculateTimeValue as calculateTimeValue, units_calculateTipSplit as calculateTipSplit, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
 }
 
-export { compareSemver as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type SubnetInfo as E, type FilePermissions as F, type TaxResult as G, type TimeValueDirection as H, type IbanValidationResult as I, type TimeValueResult as J, type TipSplitResult as K, type LoanResult as L, autoFormat as M, type NotationStyle as N, bumpVersion as O, type Permission as P, calcAspectRatio as Q, calcSubnet as R, type SemverVersion as S, type TaxDirection as T, calculateCompoundInterest as U, type ViewportConvertResult as V, calculateLoan as W, calculateSimpleInterest as X, calculateTax as Y, calculateTimeValue as Z, calculateTipSplit as _, type AspectRatioResult as a, convert as a0, convertBytes as a1, convertIp as a2, coverBox as a3, decimalToIp as a4, decimalToIpCidr as a5, describePermissions as a6, fitIntoBox as a7, formatNumber as a8, formatValue as a9, remToPx as aA, satisfiesRange as aB, scaleByHeight as aC, scaleByWidth as aD, sortVersions as aE, splitSubnet as aF, symbolicToPermissions as aG, validateBarcode as aH, validateCardNumber as aI, validateIban as aJ, validateIsbn as aK, viewportToPx as aL, formatVwValue as aa, formatWithSeparator as ab, gcd as ac, ipFromBinary as ad, ipFromDecimal as ae, ipFromHex as af, ipToBinary as ag, ipToDecimal as ah, ipToDecimalCidr as ai, ipToHex as aj, ipToOctal as ak, isValid as al, isValidCidr as am, isValidIp as an, isValidIpv4 as ao, octalToPermissions as ap, parseFileSize as aq, parseInput as ar, parseNumberString as as, parseSemver as at, permissionsToChmod as au, permissionsToOctal as av, permissionsToSymbolic as aw, ptToPx as ax, pxToAll as ay, pxToViewport as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_TIP_PERCENTAGES as n, COMMON_VIEWPORTS as o, type CardValidationResult as p, type CompoundInterestResult as q, type CompoundYearRow as r, type FormatOptions as s, type IpConversion as t, units as u, type IsbnFormat as v, type IsbnResult as w, type NumberBase as x, type PxConvertResult as y, type SimpleInterestResult as z };
+export { calculateTax as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type PxConvertResult as E, type FilePermissions as F, type SimpleInterestResult as G, type SubnetInfo as H, type IbanValidationResult as I, type TaxResult as J, type TimeValueDirection as K, type LoanResult as L, type TimeValueResult as M, type NotationStyle as N, type TipSplitResult as O, type PercentChangeDirection as P, autoFormat as Q, bumpVersion as R, type SemverVersion as S, type TaxDirection as T, calcAspectRatio as U, type ViewportConvertResult as V, calcSubnet as W, calculateCompoundInterest as X, calculateLoan as Y, calculatePercentageChange as Z, calculateSimpleInterest as _, type AspectRatioResult as a, calculateTimeValue as a0, calculateTipSplit as a1, compareSemver as a2, convert as a3, convertBytes as a4, convertIp as a5, coverBox as a6, decimalToIp as a7, decimalToIpCidr as a8, describePermissions as a9, ptToPx as aA, pxToAll as aB, pxToViewport as aC, remToPx as aD, satisfiesRange as aE, scaleByHeight as aF, scaleByWidth as aG, sortVersions as aH, splitSubnet as aI, symbolicToPermissions as aJ, validateBarcode as aK, validateCardNumber as aL, validateIban as aM, validateIsbn as aN, viewportToPx as aO, fitIntoBox as aa, formatNumber as ab, formatValue as ac, formatVwValue as ad, formatWithSeparator as ae, gcd as af, ipFromBinary as ag, ipFromDecimal as ah, ipFromHex as ai, ipToBinary as aj, ipToDecimal as ak, ipToDecimalCidr as al, ipToHex as am, ipToOctal as an, isValid as ao, isValidCidr as ap, isValidIp as aq, isValidIpv4 as ar, octalToPermissions as as, parseFileSize as at, parseInput as au, parseNumberString as av, parseSemver as aw, permissionsToChmod as ax, permissionsToOctal as ay, permissionsToSymbolic as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_TIP_PERCENTAGES as n, COMMON_VIEWPORTS as o, type CardValidationResult as p, type CompoundInterestResult as q, type CompoundYearRow as r, type FormatOptions as s, type IpConversion as t, units as u, type IsbnFormat as v, type IsbnResult as w, type NumberBase as x, type PercentageChangeResult as y, type Permission as z };

package/dist/{units-BFTQwpBu.d.ts → units-pIRkHnsU.d.ts}

@@ -429,6 +429,25 @@ interface TimeValueResult {
 declare function calculateTimeValue(amount: number, annualRatePercent: number, years: number, direction: TimeValueDirection, compoundsPerYear?: number): TimeValueResult | {
     error: string;
 };
+type PercentChangeDirection = "increase" | "decrease" | "no change";
+interface PercentageChangeResult {
+    oldValue: number;
+    newValue: number;
+    absoluteChange: number;
+    percentChange: number;
+    direction: PercentChangeDirection;
+    multiplier: number;
+}
+/**
+ * Percentage change from oldValue to newValue: ((new - old) / |old|) * 100.
+ * `absoluteChange` is the raw difference (new - old) and `multiplier` is
+ * new / old (how many times the original the new value is). The original
+ * value cannot be zero (division by zero) unless the new value is also zero.
+ * Pure arithmetic over user-supplied numbers.
+ */
+declare function calculatePercentageChange(oldValue: number, newValue: number): PercentageChangeResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AspectRatioResult = AspectRatioResult;
@@ -461,6 +480,8 @@ type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
+type units_PercentChangeDirection = PercentChangeDirection;
+type units_PercentageChangeResult = PercentageChangeResult;
 type units_Permission = Permission;
 type units_PxConvertResult = PxConvertResult;
 type units_SemverVersion = SemverVersion;
@@ -478,6 +499,7 @@ declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
+declare const units_calculatePercentageChange: typeof calculatePercentageChange;
 declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_calculateTimeValue: typeof calculateTimeValue;
@@ -532,7 +554,7 @@ declare const units_validateIban: typeof validateIban;
 declare const units_validateIsbn: typeof validateIsbn;
 declare const units_viewportToPx: typeof viewportToPx;
 declare namespace units {
-  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_TAX_RATES as COMMON_TAX_RATES, units_COMMON_TIP_PERCENTAGES as COMMON_TIP_PERCENTAGES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SimpleInterestResult as SimpleInterestResult, type units_SubnetInfo as SubnetInfo, type units_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_TimeValueDirection as TimeValueDirection, type units_TimeValueResult as TimeValueResult, type units_TipSplitResult as TipSplitResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculateSimpleInterest as calculateSimpleInterest, units_calculateTax as calculateTax, units_calculateTimeValue as calculateTimeValue, units_calculateTipSplit as calculateTipSplit, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
+  export { type units_AmortizationRow as AmortizationRow, type units_AspectRatioResult as AspectRatioResult, units_BASE_LABELS as BASE_LABELS, units_BASE_PREFIXES as BASE_PREFIXES, units_BYTE_UNITS as BYTE_UNITS, type units_BarcodeFormat as BarcodeFormat, type units_BarcodeValidationResult as BarcodeValidationResult, type units_BaseConvertResult as BaseConvertResult, type units_ByteConvertResult as ByteConvertResult, type units_ByteUnit as ByteUnit, units_COMMON_CURRENCIES as COMMON_CURRENCIES, units_COMMON_LOCALES as COMMON_LOCALES, units_COMMON_PERMISSIONS as COMMON_PERMISSIONS, units_COMMON_RATIOS as COMMON_RATIOS, units_COMMON_SIZES as COMMON_SIZES, units_COMMON_TAX_RATES as COMMON_TAX_RATES, units_COMMON_TIP_PERCENTAGES as COMMON_TIP_PERCENTAGES, units_COMMON_VIEWPORTS as COMMON_VIEWPORTS, type units_CardValidationResult as CardValidationResult, type units_CompoundInterestResult as CompoundInterestResult, type units_CompoundYearRow as CompoundYearRow, type units_Dimensions as Dimensions, type units_FilePermissions as FilePermissions, type units_FormatOptions as FormatOptions, type units_IbanValidationResult as IbanValidationResult, type units_IpConversion as IpConversion, type units_IsbnFormat as IsbnFormat, type units_IsbnResult as IsbnResult, type units_LoanResult as LoanResult, type units_NotationStyle as NotationStyle, type units_NumberBase as NumberBase, type units_PercentChangeDirection as PercentChangeDirection, type units_PercentageChangeResult as PercentageChangeResult, type units_Permission as Permission, type units_PxConvertResult as PxConvertResult, type units_SemverVersion as SemverVersion, type units_SimpleInterestResult as SimpleInterestResult, type units_SubnetInfo as SubnetInfo, type units_TaxDirection as TaxDirection, type units_TaxResult as TaxResult, type units_TimeValueDirection as TimeValueDirection, type units_TimeValueResult as TimeValueResult, type units_TipSplitResult as TipSplitResult, type units_ViewportConvertResult as ViewportConvertResult, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateLoan as calculateLoan, units_calculatePercentageChange as calculatePercentageChange, units_calculateSimpleInterest as calculateSimpleInterest, units_calculateTax as calculateTax, units_calculateTimeValue as calculateTimeValue, units_calculateTipSplit as calculateTipSplit, units_compareSemver as compareSemver, units_convert as convert, units_convertBytes as convertBytes, units_convertIp as convertIp, units_coverBox as coverBox, units_decimalToIp as decimalToIp, units_decimalToIpCidr as decimalToIpCidr, units_describePermissions as describePermissions, units_fitIntoBox as fitIntoBox, units_formatNumber as formatNumber, units_formatValue as formatValue, units_formatVwValue as formatVwValue, units_formatWithSeparator as formatWithSeparator, units_gcd as gcd, units_ipFromBinary as ipFromBinary, units_ipFromDecimal as ipFromDecimal, units_ipFromHex as ipFromHex, units_ipToBinary as ipToBinary, units_ipToDecimal as ipToDecimal, units_ipToDecimalCidr as ipToDecimalCidr, units_ipToHex as ipToHex, units_ipToOctal as ipToOctal, units_isValid as isValid, units_isValidCidr as isValidCidr, units_isValidIp as isValidIp, units_isValidIpv4 as isValidIpv4, units_octalToPermissions as octalToPermissions, units_parseFileSize as parseFileSize, units_parseInput as parseInput, units_parseNumberString as parseNumberString, units_parseSemver as parseSemver, units_permissionsToChmod as permissionsToChmod, units_permissionsToOctal as permissionsToOctal, units_permissionsToSymbolic as permissionsToSymbolic, units_ptToPx as ptToPx, units_pxToAll as pxToAll, units_pxToViewport as pxToViewport, units_remToPx as remToPx, units_satisfiesRange as satisfiesRange, units_scaleByHeight as scaleByHeight, units_scaleByWidth as scaleByWidth, units_sortVersions as sortVersions, units_splitSubnet as splitSubnet, units_symbolicToPermissions as symbolicToPermissions, units_validateBarcode as validateBarcode, units_validateCardNumber as validateCardNumber, units_validateIban as validateIban, units_validateIsbn as validateIsbn, units_viewportToPx as viewportToPx };
 }
 
-export { compareSemver as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type SubnetInfo as E, type FilePermissions as F, type TaxResult as G, type TimeValueDirection as H, type IbanValidationResult as I, type TimeValueResult as J, type TipSplitResult as K, type LoanResult as L, autoFormat as M, type NotationStyle as N, bumpVersion as O, type Permission as P, calcAspectRatio as Q, calcSubnet as R, type SemverVersion as S, type TaxDirection as T, calculateCompoundInterest as U, type ViewportConvertResult as V, calculateLoan as W, calculateSimpleInterest as X, calculateTax as Y, calculateTimeValue as Z, calculateTipSplit as _, type AspectRatioResult as a, convert as a0, convertBytes as a1, convertIp as a2, coverBox as a3, decimalToIp as a4, decimalToIpCidr as a5, describePermissions as a6, fitIntoBox as a7, formatNumber as a8, formatValue as a9, remToPx as aA, satisfiesRange as aB, scaleByHeight as aC, scaleByWidth as aD, sortVersions as aE, splitSubnet as aF, symbolicToPermissions as aG, validateBarcode as aH, validateCardNumber as aI, validateIban as aJ, validateIsbn as aK, viewportToPx as aL, formatVwValue as aa, formatWithSeparator as ab, gcd as ac, ipFromBinary as ad, ipFromDecimal as ae, ipFromHex as af, ipToBinary as ag, ipToDecimal as ah, ipToDecimalCidr as ai, ipToHex as aj, ipToOctal as ak, isValid as al, isValidCidr as am, isValidIp as an, isValidIpv4 as ao, octalToPermissions as ap, parseFileSize as aq, parseInput as ar, parseNumberString as as, parseSemver as at, permissionsToChmod as au, permissionsToOctal as av, permissionsToSymbolic as aw, ptToPx as ax, pxToAll as ay, pxToViewport as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_TIP_PERCENTAGES as n, COMMON_VIEWPORTS as o, type CardValidationResult as p, type CompoundInterestResult as q, type CompoundYearRow as r, type FormatOptions as s, type IpConversion as t, units as u, type IsbnFormat as v, type IsbnResult as w, type NumberBase as x, type PxConvertResult as y, type SimpleInterestResult as z };
+export { calculateTax as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type PxConvertResult as E, type FilePermissions as F, type SimpleInterestResult as G, type SubnetInfo as H, type IbanValidationResult as I, type TaxResult as J, type TimeValueDirection as K, type LoanResult as L, type TimeValueResult as M, type NotationStyle as N, type TipSplitResult as O, type PercentChangeDirection as P, autoFormat as Q, bumpVersion as R, type SemverVersion as S, type TaxDirection as T, calcAspectRatio as U, type ViewportConvertResult as V, calcSubnet as W, calculateCompoundInterest as X, calculateLoan as Y, calculatePercentageChange as Z, calculateSimpleInterest as _, type AspectRatioResult as a, calculateTimeValue as a0, calculateTipSplit as a1, compareSemver as a2, convert as a3, convertBytes as a4, convertIp as a5, coverBox as a6, decimalToIp as a7, decimalToIpCidr as a8, describePermissions as a9, ptToPx as aA, pxToAll as aB, pxToViewport as aC, remToPx as aD, satisfiesRange as aE, scaleByHeight as aF, scaleByWidth as aG, sortVersions as aH, splitSubnet as aI, symbolicToPermissions as aJ, validateBarcode as aK, validateCardNumber as aL, validateIban as aM, validateIsbn as aN, viewportToPx as aO, fitIntoBox as aa, formatNumber as ab, formatValue as ac, formatVwValue as ad, formatWithSeparator as ae, gcd as af, ipFromBinary as ag, ipFromDecimal as ah, ipFromHex as ai, ipToBinary as aj, ipToDecimal as ak, ipToDecimalCidr as al, ipToHex as am, ipToOctal as an, isValid as ao, isValidCidr as ap, isValidIp as aq, isValidIpv4 as ar, octalToPermissions as as, parseFileSize as at, parseInput as au, parseNumberString as av, parseSemver as aw, permissionsToChmod as ax, permissionsToOctal as ay, permissionsToSymbolic as az, BASE_PREFIXES as b, BYTE_UNITS as c, type BarcodeFormat as d, type BarcodeValidationResult as e, type BaseConvertResult as f, type ByteConvertResult as g, type ByteUnit as h, COMMON_LOCALES as i, COMMON_PERMISSIONS as j, COMMON_RATIOS as k, COMMON_SIZES as l, COMMON_TAX_RATES as m, COMMON_TIP_PERCENTAGES as n, COMMON_VIEWPORTS as o, type CardValidationResult as p, type CompoundInterestResult as q, type CompoundYearRow as r, type FormatOptions as s, type IpConversion as t, units as u, type IsbnFormat as v, type IsbnResult as w, type NumberBase as x, type PercentageChangeResult as y, type Permission as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",