@utilix-tech/sdk 0.22.0 → 0.23.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.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.

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)
@@ -261,7 +261,7 @@ formatIso8601Duration(90061);        // { iso: "P1DT1H1M1S", ... }
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy } 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
@@ -327,6 +327,10 @@ calculatePercentageChange(200, 250);
 // 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-TLRSQHMP.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,
@@ -52,6 +53,8 @@ __export(units_exports, {
   isValidCidr: () => isValidCidr,
   isValidIp: () => isValidIp,
   isValidIpv4: () => isValidIpv4,
+  marginToMarkup: () => marginToMarkup,
+  markupToMargin: () => markupToMargin,
   octalToPermissions: () => octalToPermissions,
   parseFileSize: () => parseFileSize,
   parseInput: () => parseInput,
@@ -1394,5 +1397,72 @@ function convertAprApy(rate, compoundsPerYear, direction) {
     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, 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 };
+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/index.cjs

@@ -6930,6 +6930,7 @@ __export(units_exports, {
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateLoan: () => calculateLoan,
+  calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
@@ -6962,6 +6963,8 @@ __export(units_exports, {
   isValidCidr: () => isValidCidr,
   isValidIp: () => isValidIp,
   isValidIpv4: () => isValidIpv4,
+  marginToMarkup: () => marginToMarkup,
+  markupToMargin: () => markupToMargin,
   octalToPermissions: () => octalToPermissions,
   parseFileSize: () => parseFileSize,
   parseInput: () => parseInput,
@@ -8304,6 +8307,73 @@ function convertAprApy(rate, compoundsPerYear, direction) {
     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

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

@@ -5,7 +5,7 @@ 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-KqJjdqII.js';
-export { u as units } from './units-KrjRyu0w.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-TLRSQHMP.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';

package/dist/tools/units.cjs

@@ -1319,6 +1319,73 @@ function convertAprApy(rate, compoundsPerYear, direction) {
     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;
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1337,6 +1404,7 @@ exports.calcAspectRatio = calcAspectRatio;
 exports.calcSubnet = calcSubnet;
 exports.calculateCompoundInterest = calculateCompoundInterest;
 exports.calculateLoan = calculateLoan;
+exports.calculateMarginMarkup = calculateMarginMarkup;
 exports.calculatePercentageChange = calculatePercentageChange;
 exports.calculateSimpleInterest = calculateSimpleInterest;
 exports.calculateTax = calculateTax;
@@ -1369,6 +1437,8 @@ exports.isValid = isValid;
 exports.isValidCidr = isValidCidr;
 exports.isValidIp = isValidIp;
 exports.isValidIpv4 = isValidIpv4;
+exports.marginToMarkup = marginToMarkup;
+exports.markupToMargin = markupToMargin;
 exports.octalToPermissions = octalToPermissions;
 exports.parseFileSize = parseFileSize;
 exports.parseInput = parseInput;

package/dist/tools/units.d.cts

@@ -1 +1 @@
-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';
+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, M as MarginMarkupField, z as MarginMarkupInput, E as MarginMarkupResult, N as NotationStyle, G as NumberBase, P as PercentChangeDirection, H as PercentageChangeResult, J as Permission, K as PxConvertResult, S as SemverVersion, O as SimpleInterestResult, Q as SubnetInfo, T as TaxDirection, R as TaxResult, U as TimeValueDirection, V as TimeValueResult, W as TipSplitResult, X as ViewportConvertResult, Y as autoFormat, Z as bumpVersion, _ as calcAspectRatio, $ as calcSubnet, a0 as calculateCompoundInterest, a1 as calculateLoan, a2 as calculateMarginMarkup, a3 as calculatePercentageChange, a4 as calculateSimpleInterest, a5 as calculateTax, a6 as calculateTimeValue, a7 as calculateTipSplit, a8 as compareSemver, a9 as convert, aa as convertAprApy, ab as convertBytes, ac as convertIp, ad as coverBox, ae as decimalToIp, af as decimalToIpCidr, ag as describePermissions, ah as fitIntoBox, ai as formatNumber, aj as formatValue, ak as formatVwValue, al as formatWithSeparator, am as gcd, an as ipFromBinary, ao as ipFromDecimal, ap as ipFromHex, aq as ipToBinary, ar as ipToDecimal, as as ipToDecimalCidr, at as ipToHex, au as ipToOctal, av as isValid, aw as isValidCidr, ax as isValidIp, ay as isValidIpv4, az as marginToMarkup, aA as markupToMargin, aB as octalToPermissions, aC as parseFileSize, aD as parseInput, aE as parseNumberString, aF as parseSemver, aG as permissionsToChmod, aH as permissionsToOctal, aI as permissionsToSymbolic, aJ as ptToPx, aK as pxToAll, aL as pxToViewport, aM as remToPx, aN as satisfiesRange, aO as scaleByHeight, aP as scaleByWidth, aQ as sortVersions, aR as splitSubnet, aS as symbolicToPermissions, aT as validateBarcode, aU as validateCardNumber, aV as validateIban, aW as validateIsbn, aX as viewportToPx } from '../units-h4rHQGp5.cjs';

package/dist/tools/units.d.ts

@@ -1 +1 @@
-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';
+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, M as MarginMarkupField, z as MarginMarkupInput, E as MarginMarkupResult, N as NotationStyle, G as NumberBase, P as PercentChangeDirection, H as PercentageChangeResult, J as Permission, K as PxConvertResult, S as SemverVersion, O as SimpleInterestResult, Q as SubnetInfo, T as TaxDirection, R as TaxResult, U as TimeValueDirection, V as TimeValueResult, W as TipSplitResult, X as ViewportConvertResult, Y as autoFormat, Z as bumpVersion, _ as calcAspectRatio, $ as calcSubnet, a0 as calculateCompoundInterest, a1 as calculateLoan, a2 as calculateMarginMarkup, a3 as calculatePercentageChange, a4 as calculateSimpleInterest, a5 as calculateTax, a6 as calculateTimeValue, a7 as calculateTipSplit, a8 as compareSemver, a9 as convert, aa as convertAprApy, ab as convertBytes, ac as convertIp, ad as coverBox, ae as decimalToIp, af as decimalToIpCidr, ag as describePermissions, ah as fitIntoBox, ai as formatNumber, aj as formatValue, ak as formatVwValue, al as formatWithSeparator, am as gcd, an as ipFromBinary, ao as ipFromDecimal, ap as ipFromHex, aq as ipToBinary, ar as ipToDecimal, as as ipToDecimalCidr, at as ipToHex, au as ipToOctal, av as isValid, aw as isValidCidr, ax as isValidIp, ay as isValidIpv4, az as marginToMarkup, aA as markupToMargin, aB as octalToPermissions, aC as parseFileSize, aD as parseInput, aE as parseNumberString, aF as parseSemver, aG as permissionsToChmod, aH as permissionsToOctal, aI as permissionsToSymbolic, aJ as ptToPx, aK as pxToAll, aL as pxToViewport, aM as remToPx, aN as satisfiesRange, aO as scaleByHeight, aP as scaleByWidth, aQ as sortVersions, aR as splitSubnet, aS as symbolicToPermissions, aT as validateBarcode, aU as validateCardNumber, aV as validateIban, aW as validateIsbn, aX as viewportToPx } from '../units-h4rHQGp5.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, 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';
+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, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx } from '../chunk-AIKSKJ77.js';
 import '../chunk-MLKGABMK.js';

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

@@ -24,6 +24,7 @@
  *  - present-value-calculator : calculateTimeValue
  *  - percentage-change-calculator : calculatePercentageChange
  *  - apr-apy-converter : convertAprApy
+ *  - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
  */
 interface PxConvertResult {
     px: number;
@@ -474,6 +475,42 @@ interface AprApyResult {
 declare function convertAprApy(rate: number, compoundsPerYear: number, direction: AprApyDirection): AprApyResult | {
     error: string;
 };
+type MarginMarkupField = "cost" | "price" | "marginPercent" | "markupPercent";
+interface MarginMarkupInput {
+    cost?: number | null;
+    price?: number | null;
+    marginPercent?: number | null;
+    markupPercent?: number | null;
+}
+interface MarginMarkupResult {
+    cost: number;
+    price: number;
+    profit: number;
+    marginPercent: number;
+    markupPercent: number;
+    given: MarginMarkupField[];
+    solvedFor: MarginMarkupField[];
+}
+/**
+ * Solve a pricing triangle: given exactly two of cost, price, gross margin
+ * percent, and markup percent, derive the other two. Margin is profit as a
+ * share of the selling price (profit / price) while markup is profit as a
+ * share of the cost (profit / cost), so a 20% margin is the same deal as a
+ * 25% markup — conflating them is the classic mistake this exists to avoid.
+ * Margin plus markup alone cannot be solved, since neither carries an
+ * absolute amount. Pure closed-form arithmetic, no live price feed.
+ */
+declare function calculateMarginMarkup(input: MarginMarkupInput): MarginMarkupResult | {
+    error: string;
+};
+/** Markup percent that produces a given gross margin percent (margin < 100). */
+declare function marginToMarkup(marginPercent: number): number | {
+    error: string;
+};
+/** Gross margin percent that results from a given markup percent (markup > -100). */
+declare function markupToMargin(markupPercent: number): number | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AprApyDirection = AprApyDirection;
@@ -506,6 +543,9 @@ type units_IpConversion = IpConversion;
 type units_IsbnFormat = IsbnFormat;
 type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
+type units_MarginMarkupField = MarginMarkupField;
+type units_MarginMarkupInput = MarginMarkupInput;
+type units_MarginMarkupResult = MarginMarkupResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
 type units_PercentChangeDirection = PercentChangeDirection;
@@ -527,6 +567,7 @@ declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
+declare const units_calculateMarginMarkup: typeof calculateMarginMarkup;
 declare const units_calculatePercentageChange: typeof calculatePercentageChange;
 declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
@@ -559,6 +600,8 @@ declare const units_isValid: typeof isValid;
 declare const units_isValidCidr: typeof isValidCidr;
 declare const units_isValidIp: typeof isValidIp;
 declare const units_isValidIpv4: typeof isValidIpv4;
+declare const units_marginToMarkup: typeof marginToMarkup;
+declare const units_markupToMargin: typeof markupToMargin;
 declare const units_octalToPermissions: typeof octalToPermissions;
 declare const units_parseFileSize: typeof parseFileSize;
 declare const units_parseInput: typeof parseInput;
@@ -583,7 +626,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_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 { 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_MarginMarkupField as MarginMarkupField, type units_MarginMarkupInput as MarginMarkupInput, type units_MarginMarkupResult as MarginMarkupResult, 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_calculateMarginMarkup as calculateMarginMarkup, 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_marginToMarkup as marginToMarkup, units_markupToMargin as markupToMargin, 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 { 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 };
+export { calcSubnet as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type MarginMarkupResult as E, type FilePermissions as F, type NumberBase as G, type PercentageChangeResult as H, type IbanValidationResult as I, type Permission as J, type PxConvertResult as K, type LoanResult as L, type MarginMarkupField as M, type NotationStyle as N, type SimpleInterestResult as O, type PercentChangeDirection as P, type SubnetInfo as Q, type TaxResult as R, type SemverVersion as S, type TaxDirection as T, type TimeValueDirection as U, type TimeValueResult as V, type TipSplitResult as W, type ViewportConvertResult as X, autoFormat as Y, bumpVersion as Z, calcAspectRatio as _, type AprApyDirection as a, calculateCompoundInterest as a0, calculateLoan as a1, calculateMarginMarkup as a2, calculatePercentageChange as a3, calculateSimpleInterest as a4, calculateTax as a5, calculateTimeValue as a6, calculateTipSplit as a7, compareSemver as a8, convert as a9, markupToMargin as aA, octalToPermissions as aB, parseFileSize as aC, parseInput as aD, parseNumberString as aE, parseSemver as aF, permissionsToChmod as aG, permissionsToOctal as aH, permissionsToSymbolic as aI, ptToPx as aJ, pxToAll as aK, pxToViewport as aL, remToPx as aM, satisfiesRange as aN, scaleByHeight as aO, scaleByWidth as aP, sortVersions as aQ, splitSubnet as aR, symbolicToPermissions as aS, validateBarcode as aT, validateCardNumber as aU, validateIban as aV, validateIsbn as aW, viewportToPx as aX, convertAprApy as aa, convertBytes as ab, convertIp as ac, coverBox as ad, decimalToIp as ae, decimalToIpCidr as af, describePermissions as ag, fitIntoBox as ah, formatNumber as ai, formatValue as aj, formatVwValue as ak, formatWithSeparator as al, gcd as am, ipFromBinary as an, ipFromDecimal as ao, ipFromHex as ap, ipToBinary as aq, ipToDecimal as ar, ipToDecimalCidr as as, ipToHex as at, ipToOctal as au, isValid as av, isValidCidr as aw, isValidIp as ax, isValidIpv4 as ay, marginToMarkup 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 MarginMarkupInput as z };

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

@@ -24,6 +24,7 @@
  *  - present-value-calculator : calculateTimeValue
  *  - percentage-change-calculator : calculatePercentageChange
  *  - apr-apy-converter : convertAprApy
+ *  - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
  */
 interface PxConvertResult {
     px: number;
@@ -474,6 +475,42 @@ interface AprApyResult {
 declare function convertAprApy(rate: number, compoundsPerYear: number, direction: AprApyDirection): AprApyResult | {
     error: string;
 };
+type MarginMarkupField = "cost" | "price" | "marginPercent" | "markupPercent";
+interface MarginMarkupInput {
+    cost?: number | null;
+    price?: number | null;
+    marginPercent?: number | null;
+    markupPercent?: number | null;
+}
+interface MarginMarkupResult {
+    cost: number;
+    price: number;
+    profit: number;
+    marginPercent: number;
+    markupPercent: number;
+    given: MarginMarkupField[];
+    solvedFor: MarginMarkupField[];
+}
+/**
+ * Solve a pricing triangle: given exactly two of cost, price, gross margin
+ * percent, and markup percent, derive the other two. Margin is profit as a
+ * share of the selling price (profit / price) while markup is profit as a
+ * share of the cost (profit / cost), so a 20% margin is the same deal as a
+ * 25% markup — conflating them is the classic mistake this exists to avoid.
+ * Margin plus markup alone cannot be solved, since neither carries an
+ * absolute amount. Pure closed-form arithmetic, no live price feed.
+ */
+declare function calculateMarginMarkup(input: MarginMarkupInput): MarginMarkupResult | {
+    error: string;
+};
+/** Markup percent that produces a given gross margin percent (margin < 100). */
+declare function marginToMarkup(marginPercent: number): number | {
+    error: string;
+};
+/** Gross margin percent that results from a given markup percent (markup > -100). */
+declare function markupToMargin(markupPercent: number): number | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AprApyDirection = AprApyDirection;
@@ -506,6 +543,9 @@ type units_IpConversion = IpConversion;
 type units_IsbnFormat = IsbnFormat;
 type units_IsbnResult = IsbnResult;
 type units_LoanResult = LoanResult;
+type units_MarginMarkupField = MarginMarkupField;
+type units_MarginMarkupInput = MarginMarkupInput;
+type units_MarginMarkupResult = MarginMarkupResult;
 type units_NotationStyle = NotationStyle;
 type units_NumberBase = NumberBase;
 type units_PercentChangeDirection = PercentChangeDirection;
@@ -527,6 +567,7 @@ declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateLoan: typeof calculateLoan;
+declare const units_calculateMarginMarkup: typeof calculateMarginMarkup;
 declare const units_calculatePercentageChange: typeof calculatePercentageChange;
 declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
@@ -559,6 +600,8 @@ declare const units_isValid: typeof isValid;
 declare const units_isValidCidr: typeof isValidCidr;
 declare const units_isValidIp: typeof isValidIp;
 declare const units_isValidIpv4: typeof isValidIpv4;
+declare const units_marginToMarkup: typeof marginToMarkup;
+declare const units_markupToMargin: typeof markupToMargin;
 declare const units_octalToPermissions: typeof octalToPermissions;
 declare const units_parseFileSize: typeof parseFileSize;
 declare const units_parseInput: typeof parseInput;
@@ -583,7 +626,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_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 { 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_MarginMarkupField as MarginMarkupField, type units_MarginMarkupInput as MarginMarkupInput, type units_MarginMarkupResult as MarginMarkupResult, 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_calculateMarginMarkup as calculateMarginMarkup, 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_marginToMarkup as marginToMarkup, units_markupToMargin as markupToMargin, 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 { 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 };
+export { calcSubnet as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type MarginMarkupResult as E, type FilePermissions as F, type NumberBase as G, type PercentageChangeResult as H, type IbanValidationResult as I, type Permission as J, type PxConvertResult as K, type LoanResult as L, type MarginMarkupField as M, type NotationStyle as N, type SimpleInterestResult as O, type PercentChangeDirection as P, type SubnetInfo as Q, type TaxResult as R, type SemverVersion as S, type TaxDirection as T, type TimeValueDirection as U, type TimeValueResult as V, type TipSplitResult as W, type ViewportConvertResult as X, autoFormat as Y, bumpVersion as Z, calcAspectRatio as _, type AprApyDirection as a, calculateCompoundInterest as a0, calculateLoan as a1, calculateMarginMarkup as a2, calculatePercentageChange as a3, calculateSimpleInterest as a4, calculateTax as a5, calculateTimeValue as a6, calculateTipSplit as a7, compareSemver as a8, convert as a9, markupToMargin as aA, octalToPermissions as aB, parseFileSize as aC, parseInput as aD, parseNumberString as aE, parseSemver as aF, permissionsToChmod as aG, permissionsToOctal as aH, permissionsToSymbolic as aI, ptToPx as aJ, pxToAll as aK, pxToViewport as aL, remToPx as aM, satisfiesRange as aN, scaleByHeight as aO, scaleByWidth as aP, sortVersions as aQ, splitSubnet as aR, symbolicToPermissions as aS, validateBarcode as aT, validateCardNumber as aU, validateIban as aV, validateIsbn as aW, viewportToPx as aX, convertAprApy as aa, convertBytes as ab, convertIp as ac, coverBox as ad, decimalToIp as ae, decimalToIpCidr as af, describePermissions as ag, fitIntoBox as ah, formatNumber as ai, formatValue as aj, formatVwValue as ak, formatWithSeparator as al, gcd as am, ipFromBinary as an, ipFromDecimal as ao, ipFromHex as ap, ipToBinary as aq, ipToDecimal as ar, ipToDecimalCidr as as, ipToHex as at, ipToOctal as au, isValid as av, isValidCidr as aw, isValidIp as ax, isValidIpv4 as ay, marginToMarkup 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 MarginMarkupInput as z };

package/package.json

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