@utilix-tech/sdk 0.21.0 → 0.23.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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.23.0
+- Add `calculateMarginMarkup` (margin-markup-calculator): given exactly two of cost, price, margin percent, and markup percent, solve for the other two plus the gross profit.
+- Add `marginToMarkup` / `markupToMargin` helpers for converting between the two percentage bases.
+
+## 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

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**558 developer utility functions for Node.js: runs locally, no API key required.**
+**564 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)
@@ -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, calculateMarginMarkup } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -318,6 +323,14 @@ 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, ... }
+
+// Margin/markup: pass any TWO of cost, price, marginPercent, markupPercent
+calculateMarginMarkup({ cost: 80, price: 100 });
+// { cost: 80, price: 100, profit: 20, marginPercent: 20, markupPercent: 25, ... }
 ```
 
 ---

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

@@ -20,6 +20,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
@@ -27,6 +28,7 @@ __export(units_exports, {
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
+  convertAprApy: () => convertAprApy,
   convertBytes: () => convertBytes,
   convertIp: () => convertIp,
   coverBox: () => coverBox,
@@ -51,6 +53,8 @@ __export(units_exports, {
   isValidCidr: () => isValidCidr,
   isValidIp: () => isValidIp,
   isValidIpv4: () => isValidIpv4,
+  marginToMarkup: () => marginToMarkup,
+  markupToMargin: () => markupToMargin,
   octalToPermissions: () => octalToPermissions,
   parseFileSize: () => parseFileSize,
   parseInput: () => parseInput,
@@ -1361,5 +1365,104 @@ 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)
+  };
+}
+var _MARGIN_FIELDS = ["cost", "price", "marginPercent", "markupPercent"];
+function calculateMarginMarkup(input) {
+  const provided = (v) => typeof v === "number" && Number.isFinite(v);
+  const given = _MARGIN_FIELDS.filter((f) => provided(input[f]));
+  if (given.length !== 2) {
+    return { error: `Provide exactly two of cost, price, marginPercent, markupPercent (got ${given.length})` };
+  }
+  const has = (f) => given.includes(f);
+  const cost0 = input.cost;
+  const price0 = input.price;
+  const margin0 = input.marginPercent;
+  const markup0 = input.markupPercent;
+  if (has("cost") && cost0 <= 0) return { error: "Cost must be greater than zero" };
+  if (has("price") && price0 <= 0) return { error: "Price must be greater than zero" };
+  if (has("marginPercent") && margin0 >= 100) {
+    return { error: "Margin percent must be below 100 (a 100% margin implies a zero cost)" };
+  }
+  if (has("markupPercent") && markup0 <= -100) {
+    return { error: "Markup percent must be greater than -100" };
+  }
+  let cost;
+  let price;
+  if (has("cost") && has("price")) {
+    cost = cost0;
+    price = price0;
+  } else if (has("cost") && has("marginPercent")) {
+    cost = cost0;
+    price = cost0 / (1 - margin0 / 100);
+  } else if (has("cost") && has("markupPercent")) {
+    cost = cost0;
+    price = cost0 * (1 + markup0 / 100);
+  } else if (has("price") && has("marginPercent")) {
+    price = price0;
+    cost = price0 * (1 - margin0 / 100);
+  } else if (has("price") && has("markupPercent")) {
+    price = price0;
+    cost = price0 / (1 + markup0 / 100);
+  } else {
+    return { error: "Margin and markup alone cannot be solved: also provide a cost or a price" };
+  }
+  if (!Number.isFinite(cost) || !Number.isFinite(price)) return { error: "Inputs produce a non-finite result" };
+  if (cost <= 0) return { error: "Those inputs imply a cost of zero or less" };
+  if (price <= 0) return { error: "Those inputs imply a price of zero or less" };
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const profit = price - cost;
+  return {
+    cost: round4(cost),
+    price: round4(price),
+    profit: round4(profit),
+    marginPercent: round4(profit / price * 100),
+    markupPercent: round4(profit / cost * 100),
+    given,
+    solvedFor: _MARGIN_FIELDS.filter((f) => !given.includes(f))
+  };
+}
+function marginToMarkup(marginPercent) {
+  if (!Number.isFinite(marginPercent) || marginPercent >= 100) {
+    return { error: "Margin percent must be a finite number below 100" };
+  }
+  return Math.round(marginPercent / (100 - marginPercent) * 100 * 1e4) / 1e4;
+}
+function markupToMargin(markupPercent) {
+  if (!Number.isFinite(markupPercent) || markupPercent <= -100) {
+    return { error: "Markup percent must be a finite number greater than -100" };
+  }
+  return Math.round(markupPercent / (100 + markupPercent) * 100 * 1e4) / 1e4;
+}
 
-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, calculateMarginMarkup, 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, marginToMarkup, markupToMargin, 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-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/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 = {};
@@ -6837,6 +6930,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
@@ -6844,6 +6938,7 @@ __export(units_exports, {
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
+  convertAprApy: () => convertAprApy,
   convertBytes: () => convertBytes,
   convertIp: () => convertIp,
   coverBox: () => coverBox,
@@ -6868,6 +6963,8 @@ __export(units_exports, {
   isValidCidr: () => isValidCidr,
   isValidIp: () => isValidIp,
   isValidIpv4: () => isValidIpv4,
+  marginToMarkup: () => marginToMarkup,
+  markupToMargin: () => markupToMargin,
   octalToPermissions: () => octalToPermissions,
   parseFileSize: () => parseFileSize,
   parseInput: () => parseInput,
@@ -8178,6 +8275,105 @@ 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)
+  };
+}
+var _MARGIN_FIELDS = ["cost", "price", "marginPercent", "markupPercent"];
+function calculateMarginMarkup(input) {
+  const provided = (v) => typeof v === "number" && Number.isFinite(v);
+  const given = _MARGIN_FIELDS.filter((f) => provided(input[f]));
+  if (given.length !== 2) {
+    return { error: `Provide exactly two of cost, price, marginPercent, markupPercent (got ${given.length})` };
+  }
+  const has = (f) => given.includes(f);
+  const cost0 = input.cost;
+  const price0 = input.price;
+  const margin0 = input.marginPercent;
+  const markup0 = input.markupPercent;
+  if (has("cost") && cost0 <= 0) return { error: "Cost must be greater than zero" };
+  if (has("price") && price0 <= 0) return { error: "Price must be greater than zero" };
+  if (has("marginPercent") && margin0 >= 100) {
+    return { error: "Margin percent must be below 100 (a 100% margin implies a zero cost)" };
+  }
+  if (has("markupPercent") && markup0 <= -100) {
+    return { error: "Markup percent must be greater than -100" };
+  }
+  let cost;
+  let price;
+  if (has("cost") && has("price")) {
+    cost = cost0;
+    price = price0;
+  } else if (has("cost") && has("marginPercent")) {
+    cost = cost0;
+    price = cost0 / (1 - margin0 / 100);
+  } else if (has("cost") && has("markupPercent")) {
+    cost = cost0;
+    price = cost0 * (1 + markup0 / 100);
+  } else if (has("price") && has("marginPercent")) {
+    price = price0;
+    cost = price0 * (1 - margin0 / 100);
+  } else if (has("price") && has("markupPercent")) {
+    price = price0;
+    cost = price0 / (1 + markup0 / 100);
+  } else {
+    return { error: "Margin and markup alone cannot be solved: also provide a cost or a price" };
+  }
+  if (!Number.isFinite(cost) || !Number.isFinite(price)) return { error: "Inputs produce a non-finite result" };
+  if (cost <= 0) return { error: "Those inputs imply a cost of zero or less" };
+  if (price <= 0) return { error: "Those inputs imply a price of zero or less" };
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const profit = price - cost;
+  return {
+    cost: round4(cost),
+    price: round4(price),
+    profit: round4(profit),
+    marginPercent: round4(profit / price * 100),
+    markupPercent: round4(profit / cost * 100),
+    given,
+    solvedFor: _MARGIN_FIELDS.filter((f) => !given.includes(f))
+  };
+}
+function marginToMarkup(marginPercent) {
+  if (!Number.isFinite(marginPercent) || marginPercent >= 100) {
+    return { error: "Margin percent must be a finite number below 100" };
+  }
+  return Math.round(marginPercent / (100 - marginPercent) * 100 * 1e4) / 1e4;
+}
+function markupToMargin(markupPercent) {
+  if (!Number.isFinite(markupPercent) || markupPercent <= -100) {
+    return { error: "Markup percent must be a finite number greater than -100" };
+  }
+  return Math.round(markupPercent / (100 + markupPercent) * 100 * 1e4) / 1e4;
+}
 
 // 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-h4rHQGp5.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-h4rHQGp5.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-AIKSKJ77.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