@utilix-tech/sdk 0.21.0 → 0.22.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.22.0
+- Add `convertAprApy` (apr-apy-converter): convert between a nominal APR and effective APY for a given compounding frequency, in both directions.
+- Add `parseIso8601Duration` / `formatIso8601Duration` (iso8601-duration): parse an ISO 8601 duration into components and total seconds, or format seconds into a canonical duration string.
+
 ## 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.

package/README.md

@@ -234,7 +234,8 @@ generateData([
 
 ```ts
 import { diffDates, parseCron, convertTime, formatRelative,
-         getNextRuns, humanizeDiff } from "@utilix-tech/sdk/time";
+         getNextRuns, humanizeDiff, parseIso8601Duration,
+         formatIso8601Duration } from "@utilix-tech/sdk/time";
 
 formatRelative(new Date("2024-01-01"));  // "2 years ago"
 
@@ -249,6 +250,10 @@ parseCron("0 9 * * MON-FRI");
 // { description: "At 09:00, Monday through Friday", ... }
 
 getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
+
+// ISO 8601 durations, both directions
+parseIso8601Duration("P3DT4H30M");   // { totalSeconds: 275400, days: 3, ... }
+formatIso8601Duration(90061);        // { iso: "P1DT1H1M1S", ... }
 ```
 
 ---
@@ -256,7 +261,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, calculatePercentageChange } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -318,6 +323,10 @@ calculateTimeValue(1000, 5, 10, "future");
 // Percentage change between two numbers
 calculatePercentageChange(200, 250);
 // { percentChange: 25, absoluteChange: 50, direction: "increase", multiplier: 1.25 }
+
+// APR <-> APY conversion for a given compounding frequency
+convertAprApy(12, 12, "apr-to-apy");
+// { apr: 12, apy: 12.682503, difference: 0.682503, compoundsPerYear: 12, ... }
 ```
 
 ---

package/dist/{chunk-ZPQZEIXP.js → chunk-IEPWZERQ.js}

@@ -9,6 +9,7 @@ __export(time_exports, {
   convertTime: () => convertTime,
   diffDates: () => diffDates,
   formatInTimezone: () => formatInTimezone,
+  formatIso8601Duration: () => formatIso8601Duration,
   formatRelative: () => formatRelative,
   formatRunDate: () => formatRunDate,
   fromIsoString: () => fromIsoString,
@@ -21,7 +22,8 @@ __export(time_exports, {
   humanizeDiff: () => humanizeDiff,
   parseCron: () => parseCron,
   parseCronExpression: () => parseCronExpression,
-  parseDate: () => parseDate
+  parseDate: () => parseDate,
+  parseIso8601Duration: () => parseIso8601Duration
 });
 function formatRelative(diffMs) {
   const absMs = Math.abs(diffMs);
@@ -681,5 +683,96 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var DURATION_SECONDS_PER_YEAR = 365 * 86400;
+var DURATION_SECONDS_PER_MONTH = 30 * 86400;
+function humanizeDurationParts(parts) {
+  const pieces = [];
+  for (const [value, label] of parts) {
+    if (value === 0) continue;
+    pieces.push(`${value} ${label}${value === 1 ? "" : "s"}`);
+  }
+  return pieces.length > 0 ? pieces.join(", ") : "0 seconds";
+}
+function parseIso8601Duration(input) {
+  if (typeof input !== "string") return { error: "Duration must be a string" };
+  const trimmed = input.trim();
+  if (trimmed.length === 0) return { error: "Duration is empty" };
+  const match = trimmed.match(
+    /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/
+  );
+  if (!match) {
+    return { error: 'Not a valid ISO 8601 duration (expected a form like "P3DT4H30M")' };
+  }
+  const years = match[1] ? parseInt(match[1], 10) : 0;
+  const months = match[2] ? parseInt(match[2], 10) : 0;
+  const weeks = match[3] ? parseInt(match[3], 10) : 0;
+  const days = match[4] ? parseInt(match[4], 10) : 0;
+  const hours = match[5] ? parseInt(match[5], 10) : 0;
+  const minutes = match[6] ? parseInt(match[6], 10) : 0;
+  const seconds = match[7] ? parseFloat(match[7]) : 0;
+  if (years + months + weeks + days + hours + minutes + seconds === 0) {
+    return { error: 'Duration has no components (a bare "P" or "PT" is not valid)' };
+  }
+  const approximate = years > 0 || months > 0;
+  const totalSeconds = years * DURATION_SECONDS_PER_YEAR + months * DURATION_SECONDS_PER_MONTH + weeks * 7 * 86400 + days * 86400 + hours * 3600 + minutes * 60 + seconds;
+  const human = humanizeDurationParts([
+    [years, "year"],
+    [months, "month"],
+    [weeks, "week"],
+    [days, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [seconds, "second"]
+  ]);
+  return {
+    input: trimmed,
+    years,
+    months,
+    weeks,
+    days,
+    hours,
+    minutes,
+    seconds,
+    totalSeconds: Math.round(totalSeconds * 1e6) / 1e6,
+    approximate,
+    human
+  };
+}
+function formatIso8601Duration(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds < 0) {
+    return { error: "Seconds must be zero or a positive number" };
+  }
+  const totalDays = Math.floor(seconds / 86400);
+  let rem = seconds - totalDays * 86400;
+  const hours = Math.floor(rem / 3600);
+  rem -= hours * 3600;
+  const minutes = Math.floor(rem / 60);
+  let secs = rem - minutes * 60;
+  secs = Math.round(secs * 1e6) / 1e6;
+  let iso = "P";
+  if (totalDays > 0) iso += `${totalDays}D`;
+  const hasTime = hours > 0 || minutes > 0 || secs > 0;
+  if (hasTime) {
+    iso += "T";
+    if (hours > 0) iso += `${hours}H`;
+    if (minutes > 0) iso += `${minutes}M`;
+    if (secs > 0) iso += `${secs}S`;
+  }
+  if (iso === "P") iso = "PT0S";
+  const human = humanizeDurationParts([
+    [totalDays, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [secs, "second"]
+  ]);
+  return {
+    seconds,
+    iso,
+    days: totalDays,
+    hours,
+    minutes,
+    human
+  };
+}
 
-export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, time_exports };
+export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration, time_exports };

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

@@ -27,6 +27,7 @@ __export(units_exports, {
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
+  convertAprApy: () => convertAprApy,
   convertBytes: () => convertBytes,
   convertIp: () => convertIp,
   coverBox: () => coverBox,
@@ -1361,5 +1362,37 @@ function calculatePercentageChange(oldValue, newValue) {
     multiplier: round4(multiplier)
   };
 }
+function convertAprApy(rate, compoundsPerYear, direction) {
+  if (!Number.isFinite(rate) || rate < 0) return { error: "Rate must be zero or a positive number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (direction !== "apr-to-apy" && direction !== "apy-to-apr") {
+    return { error: 'Direction must be "apr-to-apy" or "apy-to-apr"' };
+  }
+  const round6 = (n2) => Math.round(n2 * 1e6) / 1e6;
+  const round8 = (n2) => Math.round(n2 * 1e8) / 1e8;
+  const n = compoundsPerYear;
+  let aprDecimal;
+  let apyDecimal;
+  if (direction === "apr-to-apy") {
+    aprDecimal = rate / 100;
+    apyDecimal = Math.pow(1 + aprDecimal / n, n) - 1;
+  } else {
+    apyDecimal = rate / 100;
+    aprDecimal = n * (Math.pow(1 + apyDecimal, 1 / n) - 1);
+  }
+  const apr = round6(aprDecimal * 100);
+  const apy = round6(apyDecimal * 100);
+  return {
+    direction,
+    compoundsPerYear: n,
+    apr,
+    apy,
+    aprDecimal: round8(aprDecimal),
+    apyDecimal: round8(apyDecimal),
+    difference: round6(apy - apr)
+  };
+}
 
-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 };
+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, convertAprApy, 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/index.cjs

@@ -6144,6 +6144,7 @@ __export(time_exports, {
   convertTime: () => convertTime,
   diffDates: () => diffDates,
   formatInTimezone: () => formatInTimezone,
+  formatIso8601Duration: () => formatIso8601Duration,
   formatRelative: () => formatRelative,
   formatRunDate: () => formatRunDate,
   fromIsoString: () => fromIsoString,
@@ -6156,7 +6157,8 @@ __export(time_exports, {
   humanizeDiff: () => humanizeDiff,
   parseCron: () => parseCron,
   parseCronExpression: () => parseCronExpression,
-  parseDate: () => parseDate
+  parseDate: () => parseDate,
+  parseIso8601Duration: () => parseIso8601Duration
 });
 function formatRelative(diffMs) {
   const absMs = Math.abs(diffMs);
@@ -6816,6 +6818,97 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var DURATION_SECONDS_PER_YEAR = 365 * 86400;
+var DURATION_SECONDS_PER_MONTH = 30 * 86400;
+function humanizeDurationParts(parts) {
+  const pieces = [];
+  for (const [value, label] of parts) {
+    if (value === 0) continue;
+    pieces.push(`${value} ${label}${value === 1 ? "" : "s"}`);
+  }
+  return pieces.length > 0 ? pieces.join(", ") : "0 seconds";
+}
+function parseIso8601Duration(input) {
+  if (typeof input !== "string") return { error: "Duration must be a string" };
+  const trimmed = input.trim();
+  if (trimmed.length === 0) return { error: "Duration is empty" };
+  const match = trimmed.match(
+    /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/
+  );
+  if (!match) {
+    return { error: 'Not a valid ISO 8601 duration (expected a form like "P3DT4H30M")' };
+  }
+  const years = match[1] ? parseInt(match[1], 10) : 0;
+  const months = match[2] ? parseInt(match[2], 10) : 0;
+  const weeks = match[3] ? parseInt(match[3], 10) : 0;
+  const days = match[4] ? parseInt(match[4], 10) : 0;
+  const hours = match[5] ? parseInt(match[5], 10) : 0;
+  const minutes = match[6] ? parseInt(match[6], 10) : 0;
+  const seconds = match[7] ? parseFloat(match[7]) : 0;
+  if (years + months + weeks + days + hours + minutes + seconds === 0) {
+    return { error: 'Duration has no components (a bare "P" or "PT" is not valid)' };
+  }
+  const approximate = years > 0 || months > 0;
+  const totalSeconds = years * DURATION_SECONDS_PER_YEAR + months * DURATION_SECONDS_PER_MONTH + weeks * 7 * 86400 + days * 86400 + hours * 3600 + minutes * 60 + seconds;
+  const human = humanizeDurationParts([
+    [years, "year"],
+    [months, "month"],
+    [weeks, "week"],
+    [days, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [seconds, "second"]
+  ]);
+  return {
+    input: trimmed,
+    years,
+    months,
+    weeks,
+    days,
+    hours,
+    minutes,
+    seconds,
+    totalSeconds: Math.round(totalSeconds * 1e6) / 1e6,
+    approximate,
+    human
+  };
+}
+function formatIso8601Duration(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds < 0) {
+    return { error: "Seconds must be zero or a positive number" };
+  }
+  const totalDays = Math.floor(seconds / 86400);
+  let rem = seconds - totalDays * 86400;
+  const hours = Math.floor(rem / 3600);
+  rem -= hours * 3600;
+  const minutes = Math.floor(rem / 60);
+  let secs = rem - minutes * 60;
+  secs = Math.round(secs * 1e6) / 1e6;
+  let iso = "P";
+  if (totalDays > 0) iso += `${totalDays}D`;
+  const hasTime = hours > 0 || minutes > 0 || secs > 0;
+  if (hasTime) {
+    iso += "T";
+    if (hours > 0) iso += `${hours}H`;
+    if (minutes > 0) iso += `${minutes}M`;
+    if (secs > 0) iso += `${secs}S`;
+  }
+  if (iso === "P") iso = "PT0S";
+  const human = humanizeDurationParts([
+    [totalDays, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [secs, "second"]
+  ]);
+  return {
+    seconds,
+    iso,
+    days: totalDays,
+    hours,
+    minutes,
+    human
+  };
+}
 
 // src/tools/units.ts
 var units_exports = {};
@@ -6844,6 +6937,7 @@ __export(units_exports, {
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
+  convertAprApy: () => convertAprApy,
   convertBytes: () => convertBytes,
   convertIp: () => convertIp,
   coverBox: () => coverBox,
@@ -8178,6 +8272,38 @@ function calculatePercentageChange(oldValue, newValue) {
     multiplier: round4(multiplier)
   };
 }
+function convertAprApy(rate, compoundsPerYear, direction) {
+  if (!Number.isFinite(rate) || rate < 0) return { error: "Rate must be zero or a positive number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (direction !== "apr-to-apy" && direction !== "apy-to-apr") {
+    return { error: 'Direction must be "apr-to-apy" or "apy-to-apr"' };
+  }
+  const round6 = (n2) => Math.round(n2 * 1e6) / 1e6;
+  const round8 = (n2) => Math.round(n2 * 1e8) / 1e8;
+  const n = compoundsPerYear;
+  let aprDecimal;
+  let apyDecimal;
+  if (direction === "apr-to-apy") {
+    aprDecimal = rate / 100;
+    apyDecimal = Math.pow(1 + aprDecimal / n, n) - 1;
+  } else {
+    apyDecimal = rate / 100;
+    aprDecimal = n * (Math.pow(1 + apyDecimal, 1 / n) - 1);
+  }
+  const apr = round6(aprDecimal * 100);
+  const apy = round6(apyDecimal * 100);
+  return {
+    direction,
+    compoundsPerYear: n,
+    apr,
+    apy,
+    aprDecimal: round8(aprDecimal),
+    apyDecimal: round8(apyDecimal),
+    difference: round6(apy - apr)
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};

package/dist/index.d.cts

@@ -4,8 +4,8 @@ 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-pIRkHnsU.cjs';
+export { t as time } from './time-KqJjdqII.cjs';
+export { u as units } from './units-KrjRyu0w.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

@@ -4,8 +4,8 @@ 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-pIRkHnsU.js';
+export { t as time } from './time-KqJjdqII.js';
+export { u as units } from './units-KrjRyu0w.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-TFNCFD3E.js';
+export { units_exports as units } from './chunk-TLRSQHMP.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';
@@ -13,7 +13,7 @@ export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
 export { text_exports as text } from './chunk-2I4O5YCT.js';
 export { data_exports as data } from './chunk-TINQFTLO.js';
 export { generators_exports as generators } from './chunk-2CJSLYWI.js';
-export { time_exports as time } from './chunk-ZPQZEIXP.js';
+export { time_exports as time } from './chunk-IEPWZERQ.js';
 import './chunk-MLKGABMK.js';
 
 // src/index.ts

package/dist/{time-DbT8fjaF.d.cts → time-KqJjdqII.d.cts}

@@ -6,6 +6,7 @@
  *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
  *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
  *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ *  - iso8601-duration : parseIso8601Duration, formatIso8601Duration
  */
 interface TimestampResult {
     unix: number;
@@ -111,6 +112,47 @@ declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Dat
 };
 declare function formatRunDate(date: Date, timezone?: string): string;
 declare function getRunInterval(dates: Date[]): string;
+interface DurationParseResult {
+    input: string;
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    totalSeconds: number;
+    approximate: boolean;
+    human: string;
+}
+interface DurationFormatResult {
+    seconds: number;
+    iso: string;
+    days: number;
+    hours: number;
+    minutes: number;
+    human: string;
+}
+/**
+ * Parse an ISO 8601 duration string (e.g. "P3DT4H30M", "PT1H", "P1Y6M") into
+ * its individual components plus a total number of seconds. Years and months
+ * have no fixed length, so when either is present `totalSeconds` uses nominal
+ * conversions (1 year = 365 days, 1 month = 30 days) and `approximate` is set
+ * to true. Weeks, days, hours, minutes, and seconds are exact. Fractional
+ * seconds are supported.
+ */
+declare function parseIso8601Duration(input: string): DurationParseResult | {
+    error: string;
+};
+/**
+ * Format a non-negative number of seconds into a canonical ISO 8601 duration
+ * string. The output uses only days, hours, minutes, and seconds (never years
+ * or months, which have no fixed length), e.g. 90061 -> "P1DT1H1M1S". Zero is
+ * rendered as "PT0S". Fractional seconds are preserved.
+ */
+declare function formatIso8601Duration(seconds: number): DurationFormatResult | {
+    error: string;
+};
 
 declare const time_COMMON_CRONS: typeof COMMON_CRONS;
 declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
@@ -118,6 +160,8 @@ type time_CronField = CronField;
 type time_CronNextField = CronNextField;
 type time_CronResult = CronResult;
 type time_DateDiffResult = DateDiffResult;
+type time_DurationFormatResult = DurationFormatResult;
+type time_DurationParseResult = DurationParseResult;
 type time_ParsedCron = ParsedCron;
 declare const time_TIMEZONES: typeof TIMEZONES;
 type time_TimestampResult = TimestampResult;
@@ -125,6 +169,7 @@ type time_TimezoneEntry = TimezoneEntry;
 declare const time_convertTime: typeof convertTime;
 declare const time_diffDates: typeof diffDates;
 declare const time_formatInTimezone: typeof formatInTimezone;
+declare const time_formatIso8601Duration: typeof formatIso8601Duration;
 declare const time_formatRelative: typeof formatRelative;
 declare const time_formatRunDate: typeof formatRunDate;
 declare const time_fromIsoString: typeof fromIsoString;
@@ -138,8 +183,9 @@ declare const time_humanizeDiff: typeof humanizeDiff;
 declare const time_parseCron: typeof parseCron;
 declare const time_parseCronExpression: typeof parseCronExpression;
 declare const time_parseDate: typeof parseDate;
+declare const time_parseIso8601Duration: typeof parseIso8601Duration;
 declare namespace time {
-  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate };
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
 }
 
-export { COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type TimestampResult as e, type TimezoneEntry as f, convertTime as g, diffDates as h, formatInTimezone as i, formatRelative as j, formatRunDate as k, fromIsoString as l, fromUnix as m, getAllZonesForTime as n, getNextRuns as o, getNow as p, getRunInterval as q, getTimezoneOffset as r, humanizeDiff as s, time as t, parseCron as u, parseCronExpression as v, parseDate as w };
+export { parseIso8601Duration as A, COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type DurationFormatResult as e, type DurationParseResult as f, type TimestampResult as g, type TimezoneEntry as h, convertTime as i, diffDates as j, formatInTimezone as k, formatIso8601Duration as l, formatRelative as m, formatRunDate as n, fromIsoString as o, fromUnix as p, getAllZonesForTime as q, getNextRuns as r, getNow as s, time as t, getRunInterval as u, getTimezoneOffset as v, humanizeDiff as w, parseCron as x, parseCronExpression as y, parseDate as z };

package/dist/{time-DbT8fjaF.d.ts → time-KqJjdqII.d.ts}

@@ -6,6 +6,7 @@
  *  - date-diff   : parseDate, humanizeDiff, diffDates, COMMON_DATE_PRESETS
  *  - timezone    : TIMEZONES, getTimezoneOffset, convertTime, formatInTimezone, getAllZonesForTime
  *  - cron-next   : parseCronExpression, getNextRuns, formatRunDate, getRunInterval
+ *  - iso8601-duration : parseIso8601Duration, formatIso8601Duration
  */
 interface TimestampResult {
     unix: number;
@@ -111,6 +112,47 @@ declare function getNextRuns(expr: string, count?: number, fromDate?: Date): Dat
 };
 declare function formatRunDate(date: Date, timezone?: string): string;
 declare function getRunInterval(dates: Date[]): string;
+interface DurationParseResult {
+    input: string;
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    totalSeconds: number;
+    approximate: boolean;
+    human: string;
+}
+interface DurationFormatResult {
+    seconds: number;
+    iso: string;
+    days: number;
+    hours: number;
+    minutes: number;
+    human: string;
+}
+/**
+ * Parse an ISO 8601 duration string (e.g. "P3DT4H30M", "PT1H", "P1Y6M") into
+ * its individual components plus a total number of seconds. Years and months
+ * have no fixed length, so when either is present `totalSeconds` uses nominal
+ * conversions (1 year = 365 days, 1 month = 30 days) and `approximate` is set
+ * to true. Weeks, days, hours, minutes, and seconds are exact. Fractional
+ * seconds are supported.
+ */
+declare function parseIso8601Duration(input: string): DurationParseResult | {
+    error: string;
+};
+/**
+ * Format a non-negative number of seconds into a canonical ISO 8601 duration
+ * string. The output uses only days, hours, minutes, and seconds (never years
+ * or months, which have no fixed length), e.g. 90061 -> "P1DT1H1M1S". Zero is
+ * rendered as "PT0S". Fractional seconds are preserved.
+ */
+declare function formatIso8601Duration(seconds: number): DurationFormatResult | {
+    error: string;
+};
 
 declare const time_COMMON_CRONS: typeof COMMON_CRONS;
 declare const time_COMMON_DATE_PRESETS: typeof COMMON_DATE_PRESETS;
@@ -118,6 +160,8 @@ type time_CronField = CronField;
 type time_CronNextField = CronNextField;
 type time_CronResult = CronResult;
 type time_DateDiffResult = DateDiffResult;
+type time_DurationFormatResult = DurationFormatResult;
+type time_DurationParseResult = DurationParseResult;
 type time_ParsedCron = ParsedCron;
 declare const time_TIMEZONES: typeof TIMEZONES;
 type time_TimestampResult = TimestampResult;
@@ -125,6 +169,7 @@ type time_TimezoneEntry = TimezoneEntry;
 declare const time_convertTime: typeof convertTime;
 declare const time_diffDates: typeof diffDates;
 declare const time_formatInTimezone: typeof formatInTimezone;
+declare const time_formatIso8601Duration: typeof formatIso8601Duration;
 declare const time_formatRelative: typeof formatRelative;
 declare const time_formatRunDate: typeof formatRunDate;
 declare const time_fromIsoString: typeof fromIsoString;
@@ -138,8 +183,9 @@ declare const time_humanizeDiff: typeof humanizeDiff;
 declare const time_parseCron: typeof parseCron;
 declare const time_parseCronExpression: typeof parseCronExpression;
 declare const time_parseDate: typeof parseDate;
+declare const time_parseIso8601Duration: typeof parseIso8601Duration;
 declare namespace time {
-  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate };
+  export { time_COMMON_CRONS as COMMON_CRONS, time_COMMON_DATE_PRESETS as COMMON_DATE_PRESETS, type time_CronField as CronField, type time_CronNextField as CronNextField, type time_CronResult as CronResult, type time_DateDiffResult as DateDiffResult, type time_DurationFormatResult as DurationFormatResult, type time_DurationParseResult as DurationParseResult, type time_ParsedCron as ParsedCron, time_TIMEZONES as TIMEZONES, type time_TimestampResult as TimestampResult, type time_TimezoneEntry as TimezoneEntry, time_convertTime as convertTime, time_diffDates as diffDates, time_formatInTimezone as formatInTimezone, time_formatIso8601Duration as formatIso8601Duration, time_formatRelative as formatRelative, time_formatRunDate as formatRunDate, time_fromIsoString as fromIsoString, time_fromUnix as fromUnix, time_getAllZonesForTime as getAllZonesForTime, time_getNextRuns as getNextRuns, time_getNow as getNow, time_getRunInterval as getRunInterval, time_getTimezoneOffset as getTimezoneOffset, time_humanizeDiff as humanizeDiff, time_parseCron as parseCron, time_parseCronExpression as parseCronExpression, time_parseDate as parseDate, time_parseIso8601Duration as parseIso8601Duration };
 }
 
-export { COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type TimestampResult as e, type TimezoneEntry as f, convertTime as g, diffDates as h, formatInTimezone as i, formatRelative as j, formatRunDate as k, fromIsoString as l, fromUnix as m, getAllZonesForTime as n, getNextRuns as o, getNow as p, getRunInterval as q, getTimezoneOffset as r, humanizeDiff as s, time as t, parseCron as u, parseCronExpression as v, parseDate as w };
+export { parseIso8601Duration as A, COMMON_CRONS as C, type DateDiffResult as D, type ParsedCron as P, TIMEZONES as T, COMMON_DATE_PRESETS as a, type CronField as b, type CronNextField as c, type CronResult as d, type DurationFormatResult as e, type DurationParseResult as f, type TimestampResult as g, type TimezoneEntry as h, convertTime as i, diffDates as j, formatInTimezone as k, formatIso8601Duration as l, formatRelative as m, formatRunDate as n, fromIsoString as o, fromUnix as p, getAllZonesForTime as q, getNextRuns as r, getNow as s, time as t, getRunInterval as u, getTimezoneOffset as v, humanizeDiff as w, parseCron as x, parseCronExpression as y, parseDate as z };

package/dist/tools/time.cjs

@@ -659,6 +659,97 @@ function getRunInterval(dates) {
   const days = Math.round(diffMins / 1440);
   return `Every ${days} days`;
 }
+var DURATION_SECONDS_PER_YEAR = 365 * 86400;
+var DURATION_SECONDS_PER_MONTH = 30 * 86400;
+function humanizeDurationParts(parts) {
+  const pieces = [];
+  for (const [value, label] of parts) {
+    if (value === 0) continue;
+    pieces.push(`${value} ${label}${value === 1 ? "" : "s"}`);
+  }
+  return pieces.length > 0 ? pieces.join(", ") : "0 seconds";
+}
+function parseIso8601Duration(input) {
+  if (typeof input !== "string") return { error: "Duration must be a string" };
+  const trimmed = input.trim();
+  if (trimmed.length === 0) return { error: "Duration is empty" };
+  const match = trimmed.match(
+    /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/
+  );
+  if (!match) {
+    return { error: 'Not a valid ISO 8601 duration (expected a form like "P3DT4H30M")' };
+  }
+  const years = match[1] ? parseInt(match[1], 10) : 0;
+  const months = match[2] ? parseInt(match[2], 10) : 0;
+  const weeks = match[3] ? parseInt(match[3], 10) : 0;
+  const days = match[4] ? parseInt(match[4], 10) : 0;
+  const hours = match[5] ? parseInt(match[5], 10) : 0;
+  const minutes = match[6] ? parseInt(match[6], 10) : 0;
+  const seconds = match[7] ? parseFloat(match[7]) : 0;
+  if (years + months + weeks + days + hours + minutes + seconds === 0) {
+    return { error: 'Duration has no components (a bare "P" or "PT" is not valid)' };
+  }
+  const approximate = years > 0 || months > 0;
+  const totalSeconds = years * DURATION_SECONDS_PER_YEAR + months * DURATION_SECONDS_PER_MONTH + weeks * 7 * 86400 + days * 86400 + hours * 3600 + minutes * 60 + seconds;
+  const human = humanizeDurationParts([
+    [years, "year"],
+    [months, "month"],
+    [weeks, "week"],
+    [days, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [seconds, "second"]
+  ]);
+  return {
+    input: trimmed,
+    years,
+    months,
+    weeks,
+    days,
+    hours,
+    minutes,
+    seconds,
+    totalSeconds: Math.round(totalSeconds * 1e6) / 1e6,
+    approximate,
+    human
+  };
+}
+function formatIso8601Duration(seconds) {
+  if (typeof seconds !== "number" || !Number.isFinite(seconds) || seconds < 0) {
+    return { error: "Seconds must be zero or a positive number" };
+  }
+  const totalDays = Math.floor(seconds / 86400);
+  let rem = seconds - totalDays * 86400;
+  const hours = Math.floor(rem / 3600);
+  rem -= hours * 3600;
+  const minutes = Math.floor(rem / 60);
+  let secs = rem - minutes * 60;
+  secs = Math.round(secs * 1e6) / 1e6;
+  let iso = "P";
+  if (totalDays > 0) iso += `${totalDays}D`;
+  const hasTime = hours > 0 || minutes > 0 || secs > 0;
+  if (hasTime) {
+    iso += "T";
+    if (hours > 0) iso += `${hours}H`;
+    if (minutes > 0) iso += `${minutes}M`;
+    if (secs > 0) iso += `${secs}S`;
+  }
+  if (iso === "P") iso = "PT0S";
+  const human = humanizeDurationParts([
+    [totalDays, "day"],
+    [hours, "hour"],
+    [minutes, "minute"],
+    [secs, "second"]
+  ]);
+  return {
+    seconds,
+    iso,
+    days: totalDays,
+    hours,
+    minutes,
+    human
+  };
+}
 
 exports.COMMON_CRONS = COMMON_CRONS;
 exports.COMMON_DATE_PRESETS = COMMON_DATE_PRESETS;
@@ -666,6 +757,7 @@ exports.TIMEZONES = TIMEZONES;
 exports.convertTime = convertTime;
 exports.diffDates = diffDates;
 exports.formatInTimezone = formatInTimezone;
+exports.formatIso8601Duration = formatIso8601Duration;
 exports.formatRelative = formatRelative;
 exports.formatRunDate = formatRunDate;
 exports.fromIsoString = fromIsoString;
@@ -679,3 +771,4 @@ exports.humanizeDiff = humanizeDiff;
 exports.parseCron = parseCron;
 exports.parseCronExpression = parseCronExpression;
 exports.parseDate = parseDate;
+exports.parseIso8601Duration = parseIso8601Duration;

package/dist/tools/time.d.cts

@@ -1 +1 @@
-export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, P as ParsedCron, T as TIMEZONES, e as TimestampResult, f as TimezoneEntry, g as convertTime, h as diffDates, i as formatInTimezone, j as formatRelative, k as formatRunDate, l as fromIsoString, m as fromUnix, n as getAllZonesForTime, o as getNextRuns, p as getNow, q as getRunInterval, r as getTimezoneOffset, s as humanizeDiff, u as parseCron, v as parseCronExpression, w as parseDate } from '../time-DbT8fjaF.cjs';
+export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, e as DurationFormatResult, f as DurationParseResult, P as ParsedCron, T as TIMEZONES, g as TimestampResult, h as TimezoneEntry, i as convertTime, j as diffDates, k as formatInTimezone, l as formatIso8601Duration, m as formatRelative, n as formatRunDate, o as fromIsoString, p as fromUnix, q as getAllZonesForTime, r as getNextRuns, s as getNow, u as getRunInterval, v as getTimezoneOffset, w as humanizeDiff, x as parseCron, y as parseCronExpression, z as parseDate, A as parseIso8601Duration } from '../time-KqJjdqII.cjs';

package/dist/tools/time.d.ts

@@ -1 +1 @@
-export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, P as ParsedCron, T as TIMEZONES, e as TimestampResult, f as TimezoneEntry, g as convertTime, h as diffDates, i as formatInTimezone, j as formatRelative, k as formatRunDate, l as fromIsoString, m as fromUnix, n as getAllZonesForTime, o as getNextRuns, p as getNow, q as getRunInterval, r as getTimezoneOffset, s as humanizeDiff, u as parseCron, v as parseCronExpression, w as parseDate } from '../time-DbT8fjaF.js';
+export { C as COMMON_CRONS, a as COMMON_DATE_PRESETS, b as CronField, c as CronNextField, d as CronResult, D as DateDiffResult, e as DurationFormatResult, f as DurationParseResult, P as ParsedCron, T as TIMEZONES, g as TimestampResult, h as TimezoneEntry, i as convertTime, j as diffDates, k as formatInTimezone, l as formatIso8601Duration, m as formatRelative, n as formatRunDate, o as fromIsoString, p as fromUnix, q as getAllZonesForTime, r as getNextRuns, s as getNow, u as getRunInterval, v as getTimezoneOffset, w as humanizeDiff, x as parseCron, y as parseCronExpression, z as parseDate, A as parseIso8601Duration } from '../time-KqJjdqII.js';

package/dist/tools/time.js

@@ -1,2 +1,2 @@
-export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate } from '../chunk-ZPQZEIXP.js';
+export { COMMON_CRONS, COMMON_DATE_PRESETS, TIMEZONES, convertTime, diffDates, formatInTimezone, formatIso8601Duration, formatRelative, formatRunDate, fromIsoString, fromUnix, getAllZonesForTime, getNextRuns, getNow, getRunInterval, getTimezoneOffset, humanizeDiff, parseCron, parseCronExpression, parseDate, parseIso8601Duration } from '../chunk-IEPWZERQ.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/units.cjs

@@ -1287,6 +1287,38 @@ function calculatePercentageChange(oldValue, newValue) {
     multiplier: round4(multiplier)
   };
 }
+function convertAprApy(rate, compoundsPerYear, direction) {
+  if (!Number.isFinite(rate) || rate < 0) return { error: "Rate must be zero or a positive number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (direction !== "apr-to-apy" && direction !== "apy-to-apr") {
+    return { error: 'Direction must be "apr-to-apy" or "apy-to-apr"' };
+  }
+  const round6 = (n2) => Math.round(n2 * 1e6) / 1e6;
+  const round8 = (n2) => Math.round(n2 * 1e8) / 1e8;
+  const n = compoundsPerYear;
+  let aprDecimal;
+  let apyDecimal;
+  if (direction === "apr-to-apy") {
+    aprDecimal = rate / 100;
+    apyDecimal = Math.pow(1 + aprDecimal / n, n) - 1;
+  } else {
+    apyDecimal = rate / 100;
+    aprDecimal = n * (Math.pow(1 + apyDecimal, 1 / n) - 1);
+  }
+  const apr = round6(aprDecimal * 100);
+  const apy = round6(apyDecimal * 100);
+  return {
+    direction,
+    compoundsPerYear: n,
+    apr,
+    apy,
+    aprDecimal: round8(aprDecimal),
+    apyDecimal: round8(apyDecimal),
+    difference: round6(apy - apr)
+  };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1312,6 +1344,7 @@ exports.calculateTimeValue = calculateTimeValue;
 exports.calculateTipSplit = calculateTipSplit;
 exports.compareSemver = compareSemver;
 exports.convert = convert;
+exports.convertAprApy = convertAprApy;
 exports.convertBytes = convertBytes;
 exports.convertIp = convertIp;
 exports.coverBox = coverBox;

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

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

@@ -21,6 +21,9 @@
  *  - isbn-validator : validateIsbn
  *  - tip-calculator : calculateTipSplit
  *  - simple-interest-calculator : calculateSimpleInterest
+ *  - present-value-calculator : calculateTimeValue
+ *  - percentage-change-calculator : calculatePercentageChange
+ *  - apr-apy-converter : convertAprApy
  */
 interface PxConvertResult {
     px: number;
@@ -448,8 +451,33 @@ interface PercentageChangeResult {
 declare function calculatePercentageChange(oldValue: number, newValue: number): PercentageChangeResult | {
     error: string;
 };
+type AprApyDirection = "apr-to-apy" | "apy-to-apr";
+interface AprApyResult {
+    direction: AprApyDirection;
+    compoundsPerYear: number;
+    apr: number;
+    apy: number;
+    aprDecimal: number;
+    apyDecimal: number;
+    difference: number;
+}
+/**
+ * Convert between a nominal annual rate (APR) and the effective annual yield
+ * (APY) for a given compounding frequency. With direction "apr-to-apy" the
+ * input rate is treated as the nominal APR and the effective APY is computed
+ * as (1 + apr/n)^n - 1; with "apy-to-apr" the input is the effective APY and
+ * the nominal APR is recovered as n * ((1 + apy)^(1/n) - 1). Both rates are
+ * percentages, `difference` is apy - apr in percentage points, and n is the
+ * number of compounding periods per year. Pure closed-form formula, no live
+ * rate feed.
+ */
+declare function convertAprApy(rate: number, compoundsPerYear: number, direction: AprApyDirection): AprApyResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
+type units_AprApyDirection = AprApyDirection;
+type units_AprApyResult = AprApyResult;
 type units_AspectRatioResult = AspectRatioResult;
 declare const units_BASE_LABELS: typeof BASE_LABELS;
 declare const units_BASE_PREFIXES: typeof BASE_PREFIXES;
@@ -506,6 +534,7 @@ declare const units_calculateTimeValue: typeof calculateTimeValue;
 declare const units_calculateTipSplit: typeof calculateTipSplit;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
+declare const units_convertAprApy: typeof convertAprApy;
 declare const units_convertBytes: typeof convertBytes;
 declare const units_convertIp: typeof convertIp;
 declare const units_coverBox: typeof coverBox;
@@ -554,7 +583,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_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 { type units_AmortizationRow as AmortizationRow, type units_AprApyDirection as AprApyDirection, type units_AprApyResult as AprApyResult, 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_convertAprApy as convertAprApy, 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 { 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 };
+export { calculatePercentageChange as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type PercentageChangeResult as E, type FilePermissions as F, type Permission as G, type PxConvertResult as H, type IbanValidationResult as I, type SimpleInterestResult as J, type SubnetInfo as K, type LoanResult as L, type TaxResult as M, type NotationStyle as N, type TimeValueDirection as O, type PercentChangeDirection as P, type TimeValueResult as Q, type TipSplitResult as R, type SemverVersion as S, type TaxDirection as T, autoFormat as U, type ViewportConvertResult as V, bumpVersion as W, calcAspectRatio as X, calcSubnet as Y, calculateCompoundInterest as Z, calculateLoan as _, type AprApyDirection as a, calculateSimpleInterest as a0, calculateTax as a1, calculateTimeValue as a2, calculateTipSplit as a3, compareSemver as a4, convert as a5, convertAprApy as a6, convertBytes as a7, convertIp as a8, coverBox as a9, permissionsToChmod as aA, permissionsToOctal as aB, permissionsToSymbolic as aC, ptToPx as aD, pxToAll as aE, pxToViewport as aF, remToPx as aG, satisfiesRange as aH, scaleByHeight as aI, scaleByWidth as aJ, sortVersions as aK, splitSubnet as aL, symbolicToPermissions as aM, validateBarcode as aN, validateCardNumber as aO, validateIban as aP, validateIsbn as aQ, viewportToPx as aR, decimalToIp as aa, decimalToIpCidr as ab, describePermissions as ac, fitIntoBox as ad, formatNumber as ae, formatValue as af, formatVwValue as ag, formatWithSeparator as ah, gcd as ai, ipFromBinary as aj, ipFromDecimal as ak, ipFromHex as al, ipToBinary as am, ipToDecimal as an, ipToDecimalCidr as ao, ipToHex as ap, ipToOctal as aq, isValid as ar, isValidCidr as as, isValidIp as at, isValidIpv4 as au, octalToPermissions as av, parseFileSize as aw, parseInput as ax, parseNumberString as ay, parseSemver as az, type AprApyResult as b, type AspectRatioResult as c, BASE_PREFIXES as d, BYTE_UNITS as e, type BarcodeFormat as f, type BarcodeValidationResult as g, type BaseConvertResult as h, type ByteConvertResult as i, type ByteUnit as j, COMMON_LOCALES as k, COMMON_PERMISSIONS as l, COMMON_RATIOS as m, COMMON_SIZES as n, COMMON_TAX_RATES as o, COMMON_TIP_PERCENTAGES as p, COMMON_VIEWPORTS as q, type CardValidationResult as r, type CompoundInterestResult as s, type CompoundYearRow as t, units as u, type FormatOptions as v, type IpConversion as w, type IsbnFormat as x, type IsbnResult as y, type NumberBase as z };

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

@@ -21,6 +21,9 @@
  *  - isbn-validator : validateIsbn
  *  - tip-calculator : calculateTipSplit
  *  - simple-interest-calculator : calculateSimpleInterest
+ *  - present-value-calculator : calculateTimeValue
+ *  - percentage-change-calculator : calculatePercentageChange
+ *  - apr-apy-converter : convertAprApy
  */
 interface PxConvertResult {
     px: number;
@@ -448,8 +451,33 @@ interface PercentageChangeResult {
 declare function calculatePercentageChange(oldValue: number, newValue: number): PercentageChangeResult | {
     error: string;
 };
+type AprApyDirection = "apr-to-apy" | "apy-to-apr";
+interface AprApyResult {
+    direction: AprApyDirection;
+    compoundsPerYear: number;
+    apr: number;
+    apy: number;
+    aprDecimal: number;
+    apyDecimal: number;
+    difference: number;
+}
+/**
+ * Convert between a nominal annual rate (APR) and the effective annual yield
+ * (APY) for a given compounding frequency. With direction "apr-to-apy" the
+ * input rate is treated as the nominal APR and the effective APY is computed
+ * as (1 + apr/n)^n - 1; with "apy-to-apr" the input is the effective APY and
+ * the nominal APR is recovered as n * ((1 + apy)^(1/n) - 1). Both rates are
+ * percentages, `difference` is apy - apr in percentage points, and n is the
+ * number of compounding periods per year. Pure closed-form formula, no live
+ * rate feed.
+ */
+declare function convertAprApy(rate: number, compoundsPerYear: number, direction: AprApyDirection): AprApyResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
+type units_AprApyDirection = AprApyDirection;
+type units_AprApyResult = AprApyResult;
 type units_AspectRatioResult = AspectRatioResult;
 declare const units_BASE_LABELS: typeof BASE_LABELS;
 declare const units_BASE_PREFIXES: typeof BASE_PREFIXES;
@@ -506,6 +534,7 @@ declare const units_calculateTimeValue: typeof calculateTimeValue;
 declare const units_calculateTipSplit: typeof calculateTipSplit;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
+declare const units_convertAprApy: typeof convertAprApy;
 declare const units_convertBytes: typeof convertBytes;
 declare const units_convertIp: typeof convertIp;
 declare const units_coverBox: typeof coverBox;
@@ -554,7 +583,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_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 { type units_AmortizationRow as AmortizationRow, type units_AprApyDirection as AprApyDirection, type units_AprApyResult as AprApyResult, 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_convertAprApy as convertAprApy, 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 { 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 };
+export { calculatePercentageChange as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type PercentageChangeResult as E, type FilePermissions as F, type Permission as G, type PxConvertResult as H, type IbanValidationResult as I, type SimpleInterestResult as J, type SubnetInfo as K, type LoanResult as L, type TaxResult as M, type NotationStyle as N, type TimeValueDirection as O, type PercentChangeDirection as P, type TimeValueResult as Q, type TipSplitResult as R, type SemverVersion as S, type TaxDirection as T, autoFormat as U, type ViewportConvertResult as V, bumpVersion as W, calcAspectRatio as X, calcSubnet as Y, calculateCompoundInterest as Z, calculateLoan as _, type AprApyDirection as a, calculateSimpleInterest as a0, calculateTax as a1, calculateTimeValue as a2, calculateTipSplit as a3, compareSemver as a4, convert as a5, convertAprApy as a6, convertBytes as a7, convertIp as a8, coverBox as a9, permissionsToChmod as aA, permissionsToOctal as aB, permissionsToSymbolic as aC, ptToPx as aD, pxToAll as aE, pxToViewport as aF, remToPx as aG, satisfiesRange as aH, scaleByHeight as aI, scaleByWidth as aJ, sortVersions as aK, splitSubnet as aL, symbolicToPermissions as aM, validateBarcode as aN, validateCardNumber as aO, validateIban as aP, validateIsbn as aQ, viewportToPx as aR, decimalToIp as aa, decimalToIpCidr as ab, describePermissions as ac, fitIntoBox as ad, formatNumber as ae, formatValue as af, formatVwValue as ag, formatWithSeparator as ah, gcd as ai, ipFromBinary as aj, ipFromDecimal as ak, ipFromHex as al, ipToBinary as am, ipToDecimal as an, ipToDecimalCidr as ao, ipToHex as ap, ipToOctal as aq, isValid as ar, isValidCidr as as, isValidIp as at, isValidIpv4 as au, octalToPermissions as av, parseFileSize as aw, parseInput as ax, parseNumberString as ay, parseSemver as az, type AprApyResult as b, type AspectRatioResult as c, BASE_PREFIXES as d, BYTE_UNITS as e, type BarcodeFormat as f, type BarcodeValidationResult as g, type BaseConvertResult as h, type ByteConvertResult as i, type ByteUnit as j, COMMON_LOCALES as k, COMMON_PERMISSIONS as l, COMMON_RATIOS as m, COMMON_SIZES as n, COMMON_TAX_RATES as o, COMMON_TIP_PERCENTAGES as p, COMMON_VIEWPORTS as q, type CardValidationResult as r, type CompoundInterestResult as s, type CompoundYearRow as t, units as u, type FormatOptions as v, type IpConversion as w, type IsbnFormat as x, type IsbnResult as y, type NumberBase as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.21.0",
+  "version": "0.22.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",