@utilix-tech/sdk 0.24.0 → 0.26.0

package/dist/tools/units.cjs

@@ -1468,6 +1468,98 @@ function applySuccessiveDiscounts(originalPrice, discountPercents) {
     steps
   };
 }
+function calculateBreakEven(input) {
+  const { fixedCosts, variableCostPerUnit, pricePerUnit, salesVolume } = input;
+  if (!Number.isFinite(fixedCosts)) return { error: "fixedCosts must be a finite number" };
+  if (!Number.isFinite(variableCostPerUnit)) return { error: "variableCostPerUnit must be a finite number" };
+  if (!Number.isFinite(pricePerUnit)) return { error: "pricePerUnit must be a finite number" };
+  if (fixedCosts < 0) return { error: "fixedCosts cannot be negative" };
+  if (variableCostPerUnit < 0) return { error: "variableCostPerUnit cannot be negative" };
+  if (pricePerUnit <= 0) return { error: "pricePerUnit must be greater than zero" };
+  if (pricePerUnit <= variableCostPerUnit) {
+    return { error: "pricePerUnit must be greater than variableCostPerUnit, otherwise every unit sold loses money and break-even is never reached" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const contributionMarginPerUnit = pricePerUnit - variableCostPerUnit;
+  const contributionMarginRatio = contributionMarginPerUnit / pricePerUnit * 100;
+  const breakEvenUnits = fixedCosts / contributionMarginPerUnit;
+  const breakEvenUnitsRounded = Math.ceil(breakEvenUnits);
+  const breakEvenRevenue = breakEvenUnits * pricePerUnit;
+  const result = {
+    fixedCosts: round4(fixedCosts),
+    variableCostPerUnit: round4(variableCostPerUnit),
+    pricePerUnit: round4(pricePerUnit),
+    contributionMarginPerUnit: round4(contributionMarginPerUnit),
+    contributionMarginRatio: round4(contributionMarginRatio),
+    breakEvenUnits: round4(breakEvenUnits),
+    breakEvenUnitsRounded,
+    breakEvenRevenue: round4(breakEvenRevenue)
+  };
+  if (typeof salesVolume === "number" && Number.isFinite(salesVolume)) {
+    if (salesVolume < 0) return { error: "salesVolume cannot be negative" };
+    const revenueAtSalesVolume = salesVolume * pricePerUnit;
+    const profitAtSalesVolume = salesVolume * contributionMarginPerUnit - fixedCosts;
+    const marginOfSafetyUnits = salesVolume - breakEvenUnits;
+    result.salesVolume = round4(salesVolume);
+    result.revenueAtSalesVolume = round4(revenueAtSalesVolume);
+    result.profitAtSalesVolume = round4(profitAtSalesVolume);
+    result.marginOfSafetyUnits = round4(marginOfSafetyUnits);
+    result.marginOfSafetyPercent = salesVolume > 0 ? round4(marginOfSafetyUnits / salesVolume * 100) : 0;
+  }
+  return result;
+}
+function calculateVideoBitrate(input) {
+  const { mode, durationSeconds, videoBitrateKbps, targetSizeMB } = input;
+  const audioBitrateKbps = input.audioBitrateKbps ?? 0;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+    return { error: "durationSeconds must be a positive number" };
+  }
+  if (!Number.isFinite(audioBitrateKbps) || audioBitrateKbps < 0) {
+    return { error: "audioBitrateKbps must be zero or a positive number" };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  if (mode === "size-from-bitrate") {
+    if (typeof videoBitrateKbps !== "number" || !Number.isFinite(videoBitrateKbps) || videoBitrateKbps <= 0) {
+      return { error: 'videoBitrateKbps must be a positive number for mode "size-from-bitrate"' };
+    }
+    const totalBitrateKbps = videoBitrateKbps + audioBitrateKbps;
+    const fileSizeBytes = totalBitrateKbps * 1e3 * durationSeconds / 8;
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round22(videoBitrateKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(fileSizeBytes / 1e6),
+      fileSizeMiB: round22(fileSizeBytes / 1048576)
+    };
+  }
+  if (mode === "bitrate-from-size") {
+    if (typeof targetSizeMB !== "number" || !Number.isFinite(targetSizeMB) || targetSizeMB <= 0) {
+      return { error: 'targetSizeMB must be a positive number for mode "bitrate-from-size"' };
+    }
+    const fileSizeBytes = targetSizeMB * 1e6;
+    const totalBitrateKbps = fileSizeBytes * 8 / (1e3 * durationSeconds);
+    const videoKbps = totalBitrateKbps - audioBitrateKbps;
+    if (videoKbps <= 0) {
+      return {
+        error: "audioBitrateKbps exceeds the total bitrate available at this target size and duration; lower the audio bitrate or raise the target size"
+      };
+    }
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round22(videoKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(targetSizeMB),
+      fileSizeMiB: round22(fileSizeBytes / 1048576)
+    };
+  }
+  return { error: 'mode must be "size-from-bitrate" or "bitrate-from-size"' };
+}
 
 exports.BASE_LABELS = BASE_LABELS;
 exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1485,6 +1577,7 @@ exports.autoFormat = autoFormat;
 exports.bumpVersion = bumpVersion;
 exports.calcAspectRatio = calcAspectRatio;
 exports.calcSubnet = calcSubnet;
+exports.calculateBreakEven = calculateBreakEven;
 exports.calculateCompoundInterest = calculateCompoundInterest;
 exports.calculateDiscount = calculateDiscount;
 exports.calculateLoan = calculateLoan;
@@ -1494,6 +1587,7 @@ exports.calculateSimpleInterest = calculateSimpleInterest;
 exports.calculateTax = calculateTax;
 exports.calculateTimeValue = calculateTimeValue;
 exports.calculateTipSplit = calculateTipSplit;
+exports.calculateVideoBitrate = calculateVideoBitrate;
 exports.compareSemver = compareSemver;
 exports.convert = convert;
 exports.convertAprApy = convertAprApy;

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, v as DiscountField, w as DiscountInput, x as DiscountResult, F as FilePermissions, y as FormatOptions, I as IbanValidationResult, z as IpConversion, E as IsbnFormat, G as IsbnResult, L as LoanResult, M as MarginMarkupField, H as MarginMarkupInput, J as MarginMarkupResult, N as NotationStyle, K as NumberBase, P as PercentChangeDirection, O as PercentageChangeResult, Q as Permission, R as PxConvertResult, S as SemverVersion, T as SimpleInterestResult, U as SubnetInfo, V as SuccessiveDiscountResult, W as SuccessiveDiscountStep, X as TaxDirection, Y as TaxResult, Z as TimeValueDirection, _ as TimeValueResult, $ as TipSplitResult, a0 as ViewportConvertResult, a1 as applySuccessiveDiscounts, a2 as autoFormat, a3 as bumpVersion, a4 as calcAspectRatio, a5 as calcSubnet, a6 as calculateCompoundInterest, a7 as calculateDiscount, a8 as calculateLoan, a9 as calculateMarginMarkup, aa as calculatePercentageChange, ab as calculateSimpleInterest, ac as calculateTax, ad as calculateTimeValue, ae as calculateTipSplit, af as compareSemver, ag as convert, ah as convertAprApy, ai as convertBytes, aj as convertIp, ak as coverBox, al as decimalToIp, am as decimalToIpCidr, an as describePermissions, ao as fitIntoBox, ap as formatNumber, aq as formatValue, ar as formatVwValue, as as formatWithSeparator, at as gcd, au as ipFromBinary, av as ipFromDecimal, aw as ipFromHex, ax as ipToBinary, ay as ipToDecimal, az as ipToDecimalCidr, aA as ipToHex, aB as ipToOctal, aC as isValid, aD as isValidCidr, aE as isValidIp, aF as isValidIpv4, aG as marginToMarkup, aH as markupToMargin, aI as octalToPermissions, aJ as parseFileSize, aK as parseInput, aL as parseNumberString, aM as parseSemver, aN as permissionsToChmod, aO as permissionsToOctal, aP as permissionsToSymbolic, aQ as ptToPx, aR as pxToAll, aS as pxToViewport, aT as remToPx, aU as satisfiesRange, aV as scaleByHeight, aW as scaleByWidth, aX as sortVersions, aY as splitSubnet, aZ as symbolicToPermissions, a_ as validateBarcode, a$ as validateCardNumber, b0 as validateIban, b1 as validateIsbn, b2 as viewportToPx } from '../units-DAoSM2g8.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 BreakEvenInput, j as BreakEvenResult, k as ByteConvertResult, l as ByteUnit, C as COMMON_CURRENCIES, m as COMMON_LOCALES, n as COMMON_PERMISSIONS, o as COMMON_RATIOS, p as COMMON_SIZES, q as COMMON_TAX_RATES, r as COMMON_TIP_PERCENTAGES, s as COMMON_VIEWPORTS, t as CardValidationResult, v as CompoundInterestResult, w as CompoundYearRow, D as Dimensions, x as DiscountField, y as DiscountInput, z as DiscountResult, F as FilePermissions, E as FormatOptions, I as IbanValidationResult, G as IpConversion, H as IsbnFormat, J as IsbnResult, L as LoanResult, M as MarginMarkupField, K as MarginMarkupInput, N as MarginMarkupResult, O as NotationStyle, P as NumberBase, Q as PercentChangeDirection, R as PercentageChangeResult, S as Permission, T as PxConvertResult, U as SemverVersion, V as SimpleInterestResult, W as SubnetInfo, X as SuccessiveDiscountResult, Y as SuccessiveDiscountStep, Z as TaxDirection, _ as TaxResult, $ as TimeValueDirection, a0 as TimeValueResult, a1 as TipSplitResult, a2 as VideoBitrateInput, a3 as VideoBitrateMode, a4 as VideoBitrateResult, a5 as ViewportConvertResult, a6 as applySuccessiveDiscounts, a7 as autoFormat, a8 as bumpVersion, a9 as calcAspectRatio, aa as calcSubnet, ab as calculateBreakEven, ac as calculateCompoundInterest, ad as calculateDiscount, ae as calculateLoan, af as calculateMarginMarkup, ag as calculatePercentageChange, ah as calculateSimpleInterest, ai as calculateTax, aj as calculateTimeValue, ak as calculateTipSplit, al as calculateVideoBitrate, am as compareSemver, an as convert, ao as convertAprApy, ap as convertBytes, aq as convertIp, ar as coverBox, as as decimalToIp, at as decimalToIpCidr, au as describePermissions, av as fitIntoBox, aw as formatNumber, ax as formatValue, ay as formatVwValue, az as formatWithSeparator, aA as gcd, aB as ipFromBinary, aC as ipFromDecimal, aD as ipFromHex, aE as ipToBinary, aF as ipToDecimal, aG as ipToDecimalCidr, aH as ipToHex, aI as ipToOctal, aJ as isValid, aK as isValidCidr, aL as isValidIp, aM as isValidIpv4, aN as marginToMarkup, aO as markupToMargin, aP as octalToPermissions, aQ as parseFileSize, aR as parseInput, aS as parseNumberString, aT as parseSemver, aU as permissionsToChmod, aV as permissionsToOctal, aW as permissionsToSymbolic, aX as ptToPx, aY as pxToAll, aZ as pxToViewport, a_ as remToPx, a$ as satisfiesRange, b0 as scaleByHeight, b1 as scaleByWidth, b2 as sortVersions, b3 as splitSubnet, b4 as symbolicToPermissions, b5 as validateBarcode, b6 as validateCardNumber, b7 as validateIban, b8 as validateIsbn, b9 as viewportToPx } from '../units-D2wEimKG.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, v as DiscountField, w as DiscountInput, x as DiscountResult, F as FilePermissions, y as FormatOptions, I as IbanValidationResult, z as IpConversion, E as IsbnFormat, G as IsbnResult, L as LoanResult, M as MarginMarkupField, H as MarginMarkupInput, J as MarginMarkupResult, N as NotationStyle, K as NumberBase, P as PercentChangeDirection, O as PercentageChangeResult, Q as Permission, R as PxConvertResult, S as SemverVersion, T as SimpleInterestResult, U as SubnetInfo, V as SuccessiveDiscountResult, W as SuccessiveDiscountStep, X as TaxDirection, Y as TaxResult, Z as TimeValueDirection, _ as TimeValueResult, $ as TipSplitResult, a0 as ViewportConvertResult, a1 as applySuccessiveDiscounts, a2 as autoFormat, a3 as bumpVersion, a4 as calcAspectRatio, a5 as calcSubnet, a6 as calculateCompoundInterest, a7 as calculateDiscount, a8 as calculateLoan, a9 as calculateMarginMarkup, aa as calculatePercentageChange, ab as calculateSimpleInterest, ac as calculateTax, ad as calculateTimeValue, ae as calculateTipSplit, af as compareSemver, ag as convert, ah as convertAprApy, ai as convertBytes, aj as convertIp, ak as coverBox, al as decimalToIp, am as decimalToIpCidr, an as describePermissions, ao as fitIntoBox, ap as formatNumber, aq as formatValue, ar as formatVwValue, as as formatWithSeparator, at as gcd, au as ipFromBinary, av as ipFromDecimal, aw as ipFromHex, ax as ipToBinary, ay as ipToDecimal, az as ipToDecimalCidr, aA as ipToHex, aB as ipToOctal, aC as isValid, aD as isValidCidr, aE as isValidIp, aF as isValidIpv4, aG as marginToMarkup, aH as markupToMargin, aI as octalToPermissions, aJ as parseFileSize, aK as parseInput, aL as parseNumberString, aM as parseSemver, aN as permissionsToChmod, aO as permissionsToOctal, aP as permissionsToSymbolic, aQ as ptToPx, aR as pxToAll, aS as pxToViewport, aT as remToPx, aU as satisfiesRange, aV as scaleByHeight, aW as scaleByWidth, aX as sortVersions, aY as splitSubnet, aZ as symbolicToPermissions, a_ as validateBarcode, a$ as validateCardNumber, b0 as validateIban, b1 as validateIsbn, b2 as viewportToPx } from '../units-DAoSM2g8.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 BreakEvenInput, j as BreakEvenResult, k as ByteConvertResult, l as ByteUnit, C as COMMON_CURRENCIES, m as COMMON_LOCALES, n as COMMON_PERMISSIONS, o as COMMON_RATIOS, p as COMMON_SIZES, q as COMMON_TAX_RATES, r as COMMON_TIP_PERCENTAGES, s as COMMON_VIEWPORTS, t as CardValidationResult, v as CompoundInterestResult, w as CompoundYearRow, D as Dimensions, x as DiscountField, y as DiscountInput, z as DiscountResult, F as FilePermissions, E as FormatOptions, I as IbanValidationResult, G as IpConversion, H as IsbnFormat, J as IsbnResult, L as LoanResult, M as MarginMarkupField, K as MarginMarkupInput, N as MarginMarkupResult, O as NotationStyle, P as NumberBase, Q as PercentChangeDirection, R as PercentageChangeResult, S as Permission, T as PxConvertResult, U as SemverVersion, V as SimpleInterestResult, W as SubnetInfo, X as SuccessiveDiscountResult, Y as SuccessiveDiscountStep, Z as TaxDirection, _ as TaxResult, $ as TimeValueDirection, a0 as TimeValueResult, a1 as TipSplitResult, a2 as VideoBitrateInput, a3 as VideoBitrateMode, a4 as VideoBitrateResult, a5 as ViewportConvertResult, a6 as applySuccessiveDiscounts, a7 as autoFormat, a8 as bumpVersion, a9 as calcAspectRatio, aa as calcSubnet, ab as calculateBreakEven, ac as calculateCompoundInterest, ad as calculateDiscount, ae as calculateLoan, af as calculateMarginMarkup, ag as calculatePercentageChange, ah as calculateSimpleInterest, ai as calculateTax, aj as calculateTimeValue, ak as calculateTipSplit, al as calculateVideoBitrate, am as compareSemver, an as convert, ao as convertAprApy, ap as convertBytes, aq as convertIp, ar as coverBox, as as decimalToIp, at as decimalToIpCidr, au as describePermissions, av as fitIntoBox, aw as formatNumber, ax as formatValue, ay as formatVwValue, az as formatWithSeparator, aA as gcd, aB as ipFromBinary, aC as ipFromDecimal, aD as ipFromHex, aE as ipToBinary, aF as ipToDecimal, aG as ipToDecimalCidr, aH as ipToHex, aI as ipToOctal, aJ as isValid, aK as isValidCidr, aL as isValidIp, aM as isValidIpv4, aN as marginToMarkup, aO as markupToMargin, aP as octalToPermissions, aQ as parseFileSize, aR as parseInput, aS as parseNumberString, aT as parseSemver, aU as permissionsToChmod, aV as permissionsToOctal, aW as permissionsToSymbolic, aX as ptToPx, aY as pxToAll, aZ as pxToViewport, a_ as remToPx, a$ as satisfiesRange, b0 as scaleByHeight, b1 as scaleByWidth, b2 as sortVersions, b3 as splitSubnet, b4 as symbolicToPermissions, b5 as validateBarcode, b6 as validateCardNumber, b7 as validateIban, b8 as validateIsbn, b9 as viewportToPx } from '../units-D2wEimKG.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, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateDiscount, 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-HZIS2DMJ.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, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, 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-HP6C4VBX.js';
 import '../chunk-MLKGABMK.js';

package/dist/{units-DAoSM2g8.d.ts → units-D2wEimKG.d.cts}

@@ -26,6 +26,8 @@
  *  - apr-apy-converter : convertAprApy
  *  - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
  *  - discount-calculator : calculateDiscount, applySuccessiveDiscounts
+ *  - break-even-calculator : calculateBreakEven
+ *  - video-bitrate-calculator : calculateVideoBitrate
  */
 interface PxConvertResult {
     px: number;
@@ -560,6 +562,71 @@ declare function calculateDiscount(input: DiscountInput): DiscountResult | {
 declare function applySuccessiveDiscounts(originalPrice: number, discountPercents: number[]): SuccessiveDiscountResult | {
     error: string;
 };
+interface BreakEvenInput {
+    fixedCosts: number;
+    variableCostPerUnit: number;
+    pricePerUnit: number;
+    salesVolume?: number | null;
+}
+interface BreakEvenResult {
+    fixedCosts: number;
+    variableCostPerUnit: number;
+    pricePerUnit: number;
+    contributionMarginPerUnit: number;
+    contributionMarginRatio: number;
+    breakEvenUnits: number;
+    breakEvenUnitsRounded: number;
+    breakEvenRevenue: number;
+    salesVolume?: number;
+    revenueAtSalesVolume?: number;
+    profitAtSalesVolume?: number;
+    marginOfSafetyUnits?: number;
+    marginOfSafetyPercent?: number;
+}
+/**
+ * From fixed costs, the variable cost per unit, and the selling price per
+ * unit, compute the break-even point: the unit count and revenue at which
+ * profit is exactly zero. The price must exceed the variable cost, since
+ * otherwise every unit sold loses money and break-even is never reached no
+ * matter the volume. Optionally pass a sales volume to also get the profit
+ * (or loss) at that volume and the margin of safety above break-even. Pure
+ * arithmetic, no live cost/pricing feed.
+ */
+declare function calculateBreakEven(input: BreakEvenInput): BreakEvenResult | {
+    error: string;
+};
+type VideoBitrateMode = 'size-from-bitrate' | 'bitrate-from-size';
+interface VideoBitrateInput {
+    mode: VideoBitrateMode;
+    durationSeconds: number;
+    /** Required for mode "size-from-bitrate". */
+    videoBitrateKbps?: number;
+    /** Optional for either mode; defaults to 0. */
+    audioBitrateKbps?: number;
+    /** Required for mode "bitrate-from-size". Decimal MB (1 MB = 1,000,000 bytes). */
+    targetSizeMB?: number;
+}
+interface VideoBitrateResult {
+    mode: VideoBitrateMode;
+    durationSeconds: number;
+    videoBitrateKbps: number;
+    audioBitrateKbps: number;
+    totalBitrateKbps: number;
+    fileSizeBytes: number;
+    /** Decimal megabytes: 1 MB = 1,000,000 bytes. */
+    fileSizeMB: number;
+    /** Binary mebibytes: 1 MiB = 1,048,576 bytes. */
+    fileSizeMiB: number;
+}
+/**
+ * Calculate the video file size from a target bitrate and duration, or the
+ * required bitrate to hit a target file size, with an optional separate
+ * audio bitrate. Pure arithmetic (fileSizeBytes = totalBitrateBps *
+ * durationSeconds / 8); no container parsing or encoding is performed.
+ */
+declare function calculateVideoBitrate(input: VideoBitrateInput): VideoBitrateResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AprApyDirection = AprApyDirection;
@@ -571,6 +638,8 @@ declare const units_BYTE_UNITS: typeof BYTE_UNITS;
 type units_BarcodeFormat = BarcodeFormat;
 type units_BarcodeValidationResult = BarcodeValidationResult;
 type units_BaseConvertResult = BaseConvertResult;
+type units_BreakEvenInput = BreakEvenInput;
+type units_BreakEvenResult = BreakEvenResult;
 type units_ByteConvertResult = ByteConvertResult;
 type units_ByteUnit = ByteUnit;
 declare const units_COMMON_CURRENCIES: typeof COMMON_CURRENCIES;
@@ -614,12 +683,16 @@ type units_TaxResult = TaxResult;
 type units_TimeValueDirection = TimeValueDirection;
 type units_TimeValueResult = TimeValueResult;
 type units_TipSplitResult = TipSplitResult;
+type units_VideoBitrateInput = VideoBitrateInput;
+type units_VideoBitrateMode = VideoBitrateMode;
+type units_VideoBitrateResult = VideoBitrateResult;
 type units_ViewportConvertResult = ViewportConvertResult;
 declare const units_applySuccessiveDiscounts: typeof applySuccessiveDiscounts;
 declare const units_autoFormat: typeof autoFormat;
 declare const units_bumpVersion: typeof bumpVersion;
 declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
+declare const units_calculateBreakEven: typeof calculateBreakEven;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateDiscount: typeof calculateDiscount;
 declare const units_calculateLoan: typeof calculateLoan;
@@ -629,6 +702,7 @@ declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_calculateTimeValue: typeof calculateTimeValue;
 declare const units_calculateTipSplit: typeof calculateTipSplit;
+declare const units_calculateVideoBitrate: typeof calculateVideoBitrate;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
 declare const units_convertAprApy: typeof convertAprApy;
@@ -682,7 +756,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_DiscountField as DiscountField, type units_DiscountInput as DiscountInput, type units_DiscountResult as DiscountResult, 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_SuccessiveDiscountResult as SuccessiveDiscountResult, type units_SuccessiveDiscountStep as SuccessiveDiscountStep, 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_applySuccessiveDiscounts as applySuccessiveDiscounts, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateDiscount as calculateDiscount, 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 { 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_BreakEvenInput as BreakEvenInput, type units_BreakEvenResult as BreakEvenResult, 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_DiscountField as DiscountField, type units_DiscountInput as DiscountInput, type units_DiscountResult as DiscountResult, 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_SuccessiveDiscountResult as SuccessiveDiscountResult, type units_SuccessiveDiscountStep as SuccessiveDiscountStep, 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_VideoBitrateInput as VideoBitrateInput, type units_VideoBitrateMode as VideoBitrateMode, type units_VideoBitrateResult as VideoBitrateResult, type units_ViewportConvertResult as ViewportConvertResult, units_applySuccessiveDiscounts as applySuccessiveDiscounts, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateBreakEven as calculateBreakEven, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateDiscount as calculateDiscount, 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_calculateVideoBitrate as calculateVideoBitrate, 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 { type TipSplitResult as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type IsbnFormat as E, type FilePermissions as F, type IsbnResult as G, type MarginMarkupInput as H, type IbanValidationResult as I, type MarginMarkupResult as J, type NumberBase as K, type LoanResult as L, type MarginMarkupField as M, type NotationStyle as N, type PercentageChangeResult as O, type PercentChangeDirection as P, type Permission as Q, type PxConvertResult as R, type SemverVersion as S, type SimpleInterestResult as T, type SubnetInfo as U, type SuccessiveDiscountResult as V, type SuccessiveDiscountStep as W, type TaxDirection as X, type TaxResult as Y, type TimeValueDirection as Z, type TimeValueResult as _, type AprApyDirection as a, validateCardNumber as a$, type ViewportConvertResult as a0, applySuccessiveDiscounts as a1, autoFormat as a2, bumpVersion as a3, calcAspectRatio as a4, calcSubnet as a5, calculateCompoundInterest as a6, calculateDiscount as a7, calculateLoan as a8, calculateMarginMarkup as a9, ipToHex as aA, ipToOctal as aB, isValid as aC, isValidCidr as aD, isValidIp as aE, isValidIpv4 as aF, marginToMarkup as aG, markupToMargin as aH, octalToPermissions as aI, parseFileSize as aJ, parseInput as aK, parseNumberString as aL, parseSemver as aM, permissionsToChmod as aN, permissionsToOctal as aO, permissionsToSymbolic as aP, ptToPx as aQ, pxToAll as aR, pxToViewport as aS, remToPx as aT, satisfiesRange as aU, scaleByHeight as aV, scaleByWidth as aW, sortVersions as aX, splitSubnet as aY, symbolicToPermissions as aZ, validateBarcode as a_, calculatePercentageChange as aa, calculateSimpleInterest as ab, calculateTax as ac, calculateTimeValue as ad, calculateTipSplit as ae, compareSemver as af, convert as ag, convertAprApy as ah, convertBytes as ai, convertIp as aj, coverBox as ak, decimalToIp as al, decimalToIpCidr as am, describePermissions as an, fitIntoBox as ao, formatNumber as ap, formatValue as aq, formatVwValue as ar, formatWithSeparator as as, gcd as at, ipFromBinary as au, ipFromDecimal as av, ipFromHex as aw, ipToBinary as ax, ipToDecimal as ay, ipToDecimalCidr as az, type AprApyResult as b, validateIban as b0, validateIsbn as b1, viewportToPx as b2, 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 DiscountField as v, type DiscountInput as w, type DiscountResult as x, type FormatOptions as y, type IpConversion as z };
+export { type TimeValueDirection as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type FormatOptions as E, type FilePermissions as F, type IpConversion as G, type IsbnFormat as H, type IbanValidationResult as I, type IsbnResult as J, type MarginMarkupInput as K, type LoanResult as L, type MarginMarkupField as M, type MarginMarkupResult as N, type NotationStyle as O, type NumberBase as P, type PercentChangeDirection as Q, type PercentageChangeResult as R, type Permission as S, type PxConvertResult as T, type SemverVersion as U, type SimpleInterestResult as V, type SubnetInfo as W, type SuccessiveDiscountResult as X, type SuccessiveDiscountStep as Y, type TaxDirection as Z, type TaxResult as _, type AprApyDirection as a, satisfiesRange as a$, type TimeValueResult as a0, type TipSplitResult as a1, type VideoBitrateInput as a2, type VideoBitrateMode as a3, type VideoBitrateResult as a4, type ViewportConvertResult as a5, applySuccessiveDiscounts as a6, autoFormat as a7, bumpVersion as a8, calcAspectRatio as a9, gcd as aA, ipFromBinary as aB, ipFromDecimal as aC, ipFromHex as aD, ipToBinary as aE, ipToDecimal as aF, ipToDecimalCidr as aG, ipToHex as aH, ipToOctal as aI, isValid as aJ, isValidCidr as aK, isValidIp as aL, isValidIpv4 as aM, marginToMarkup as aN, markupToMargin as aO, octalToPermissions as aP, parseFileSize as aQ, parseInput as aR, parseNumberString as aS, parseSemver as aT, permissionsToChmod as aU, permissionsToOctal as aV, permissionsToSymbolic as aW, ptToPx as aX, pxToAll as aY, pxToViewport as aZ, remToPx as a_, calcSubnet as aa, calculateBreakEven as ab, calculateCompoundInterest as ac, calculateDiscount as ad, calculateLoan as ae, calculateMarginMarkup as af, calculatePercentageChange as ag, calculateSimpleInterest as ah, calculateTax as ai, calculateTimeValue as aj, calculateTipSplit as ak, calculateVideoBitrate as al, compareSemver as am, convert as an, convertAprApy as ao, convertBytes as ap, convertIp as aq, coverBox as ar, decimalToIp as as, decimalToIpCidr as at, describePermissions as au, fitIntoBox as av, formatNumber as aw, formatValue as ax, formatVwValue as ay, formatWithSeparator as az, type AprApyResult as b, scaleByHeight as b0, scaleByWidth as b1, sortVersions as b2, splitSubnet as b3, symbolicToPermissions as b4, validateBarcode as b5, validateCardNumber as b6, validateIban as b7, validateIsbn as b8, viewportToPx as b9, 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 BreakEvenInput as i, type BreakEvenResult as j, type ByteConvertResult as k, type ByteUnit as l, COMMON_LOCALES as m, COMMON_PERMISSIONS as n, COMMON_RATIOS as o, COMMON_SIZES as p, COMMON_TAX_RATES as q, COMMON_TIP_PERCENTAGES as r, COMMON_VIEWPORTS as s, type CardValidationResult as t, units as u, type CompoundInterestResult as v, type CompoundYearRow as w, type DiscountField as x, type DiscountInput as y, type DiscountResult as z };

package/dist/{units-DAoSM2g8.d.cts → units-D2wEimKG.d.ts}

@@ -26,6 +26,8 @@
  *  - apr-apy-converter : convertAprApy
  *  - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
  *  - discount-calculator : calculateDiscount, applySuccessiveDiscounts
+ *  - break-even-calculator : calculateBreakEven
+ *  - video-bitrate-calculator : calculateVideoBitrate
  */
 interface PxConvertResult {
     px: number;
@@ -560,6 +562,71 @@ declare function calculateDiscount(input: DiscountInput): DiscountResult | {
 declare function applySuccessiveDiscounts(originalPrice: number, discountPercents: number[]): SuccessiveDiscountResult | {
     error: string;
 };
+interface BreakEvenInput {
+    fixedCosts: number;
+    variableCostPerUnit: number;
+    pricePerUnit: number;
+    salesVolume?: number | null;
+}
+interface BreakEvenResult {
+    fixedCosts: number;
+    variableCostPerUnit: number;
+    pricePerUnit: number;
+    contributionMarginPerUnit: number;
+    contributionMarginRatio: number;
+    breakEvenUnits: number;
+    breakEvenUnitsRounded: number;
+    breakEvenRevenue: number;
+    salesVolume?: number;
+    revenueAtSalesVolume?: number;
+    profitAtSalesVolume?: number;
+    marginOfSafetyUnits?: number;
+    marginOfSafetyPercent?: number;
+}
+/**
+ * From fixed costs, the variable cost per unit, and the selling price per
+ * unit, compute the break-even point: the unit count and revenue at which
+ * profit is exactly zero. The price must exceed the variable cost, since
+ * otherwise every unit sold loses money and break-even is never reached no
+ * matter the volume. Optionally pass a sales volume to also get the profit
+ * (or loss) at that volume and the margin of safety above break-even. Pure
+ * arithmetic, no live cost/pricing feed.
+ */
+declare function calculateBreakEven(input: BreakEvenInput): BreakEvenResult | {
+    error: string;
+};
+type VideoBitrateMode = 'size-from-bitrate' | 'bitrate-from-size';
+interface VideoBitrateInput {
+    mode: VideoBitrateMode;
+    durationSeconds: number;
+    /** Required for mode "size-from-bitrate". */
+    videoBitrateKbps?: number;
+    /** Optional for either mode; defaults to 0. */
+    audioBitrateKbps?: number;
+    /** Required for mode "bitrate-from-size". Decimal MB (1 MB = 1,000,000 bytes). */
+    targetSizeMB?: number;
+}
+interface VideoBitrateResult {
+    mode: VideoBitrateMode;
+    durationSeconds: number;
+    videoBitrateKbps: number;
+    audioBitrateKbps: number;
+    totalBitrateKbps: number;
+    fileSizeBytes: number;
+    /** Decimal megabytes: 1 MB = 1,000,000 bytes. */
+    fileSizeMB: number;
+    /** Binary mebibytes: 1 MiB = 1,048,576 bytes. */
+    fileSizeMiB: number;
+}
+/**
+ * Calculate the video file size from a target bitrate and duration, or the
+ * required bitrate to hit a target file size, with an optional separate
+ * audio bitrate. Pure arithmetic (fileSizeBytes = totalBitrateBps *
+ * durationSeconds / 8); no container parsing or encoding is performed.
+ */
+declare function calculateVideoBitrate(input: VideoBitrateInput): VideoBitrateResult | {
+    error: string;
+};
 
 type units_AmortizationRow = AmortizationRow;
 type units_AprApyDirection = AprApyDirection;
@@ -571,6 +638,8 @@ declare const units_BYTE_UNITS: typeof BYTE_UNITS;
 type units_BarcodeFormat = BarcodeFormat;
 type units_BarcodeValidationResult = BarcodeValidationResult;
 type units_BaseConvertResult = BaseConvertResult;
+type units_BreakEvenInput = BreakEvenInput;
+type units_BreakEvenResult = BreakEvenResult;
 type units_ByteConvertResult = ByteConvertResult;
 type units_ByteUnit = ByteUnit;
 declare const units_COMMON_CURRENCIES: typeof COMMON_CURRENCIES;
@@ -614,12 +683,16 @@ type units_TaxResult = TaxResult;
 type units_TimeValueDirection = TimeValueDirection;
 type units_TimeValueResult = TimeValueResult;
 type units_TipSplitResult = TipSplitResult;
+type units_VideoBitrateInput = VideoBitrateInput;
+type units_VideoBitrateMode = VideoBitrateMode;
+type units_VideoBitrateResult = VideoBitrateResult;
 type units_ViewportConvertResult = ViewportConvertResult;
 declare const units_applySuccessiveDiscounts: typeof applySuccessiveDiscounts;
 declare const units_autoFormat: typeof autoFormat;
 declare const units_bumpVersion: typeof bumpVersion;
 declare const units_calcAspectRatio: typeof calcAspectRatio;
 declare const units_calcSubnet: typeof calcSubnet;
+declare const units_calculateBreakEven: typeof calculateBreakEven;
 declare const units_calculateCompoundInterest: typeof calculateCompoundInterest;
 declare const units_calculateDiscount: typeof calculateDiscount;
 declare const units_calculateLoan: typeof calculateLoan;
@@ -629,6 +702,7 @@ declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
 declare const units_calculateTax: typeof calculateTax;
 declare const units_calculateTimeValue: typeof calculateTimeValue;
 declare const units_calculateTipSplit: typeof calculateTipSplit;
+declare const units_calculateVideoBitrate: typeof calculateVideoBitrate;
 declare const units_compareSemver: typeof compareSemver;
 declare const units_convert: typeof convert;
 declare const units_convertAprApy: typeof convertAprApy;
@@ -682,7 +756,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_DiscountField as DiscountField, type units_DiscountInput as DiscountInput, type units_DiscountResult as DiscountResult, 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_SuccessiveDiscountResult as SuccessiveDiscountResult, type units_SuccessiveDiscountStep as SuccessiveDiscountStep, 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_applySuccessiveDiscounts as applySuccessiveDiscounts, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateDiscount as calculateDiscount, 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 { 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_BreakEvenInput as BreakEvenInput, type units_BreakEvenResult as BreakEvenResult, 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_DiscountField as DiscountField, type units_DiscountInput as DiscountInput, type units_DiscountResult as DiscountResult, 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_SuccessiveDiscountResult as SuccessiveDiscountResult, type units_SuccessiveDiscountStep as SuccessiveDiscountStep, 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_VideoBitrateInput as VideoBitrateInput, type units_VideoBitrateMode as VideoBitrateMode, type units_VideoBitrateResult as VideoBitrateResult, type units_ViewportConvertResult as ViewportConvertResult, units_applySuccessiveDiscounts as applySuccessiveDiscounts, units_autoFormat as autoFormat, units_bumpVersion as bumpVersion, units_calcAspectRatio as calcAspectRatio, units_calcSubnet as calcSubnet, units_calculateBreakEven as calculateBreakEven, units_calculateCompoundInterest as calculateCompoundInterest, units_calculateDiscount as calculateDiscount, 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_calculateVideoBitrate as calculateVideoBitrate, 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 { type TipSplitResult as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type IsbnFormat as E, type FilePermissions as F, type IsbnResult as G, type MarginMarkupInput as H, type IbanValidationResult as I, type MarginMarkupResult as J, type NumberBase as K, type LoanResult as L, type MarginMarkupField as M, type NotationStyle as N, type PercentageChangeResult as O, type PercentChangeDirection as P, type Permission as Q, type PxConvertResult as R, type SemverVersion as S, type SimpleInterestResult as T, type SubnetInfo as U, type SuccessiveDiscountResult as V, type SuccessiveDiscountStep as W, type TaxDirection as X, type TaxResult as Y, type TimeValueDirection as Z, type TimeValueResult as _, type AprApyDirection as a, validateCardNumber as a$, type ViewportConvertResult as a0, applySuccessiveDiscounts as a1, autoFormat as a2, bumpVersion as a3, calcAspectRatio as a4, calcSubnet as a5, calculateCompoundInterest as a6, calculateDiscount as a7, calculateLoan as a8, calculateMarginMarkup as a9, ipToHex as aA, ipToOctal as aB, isValid as aC, isValidCidr as aD, isValidIp as aE, isValidIpv4 as aF, marginToMarkup as aG, markupToMargin as aH, octalToPermissions as aI, parseFileSize as aJ, parseInput as aK, parseNumberString as aL, parseSemver as aM, permissionsToChmod as aN, permissionsToOctal as aO, permissionsToSymbolic as aP, ptToPx as aQ, pxToAll as aR, pxToViewport as aS, remToPx as aT, satisfiesRange as aU, scaleByHeight as aV, scaleByWidth as aW, sortVersions as aX, splitSubnet as aY, symbolicToPermissions as aZ, validateBarcode as a_, calculatePercentageChange as aa, calculateSimpleInterest as ab, calculateTax as ac, calculateTimeValue as ad, calculateTipSplit as ae, compareSemver as af, convert as ag, convertAprApy as ah, convertBytes as ai, convertIp as aj, coverBox as ak, decimalToIp as al, decimalToIpCidr as am, describePermissions as an, fitIntoBox as ao, formatNumber as ap, formatValue as aq, formatVwValue as ar, formatWithSeparator as as, gcd as at, ipFromBinary as au, ipFromDecimal as av, ipFromHex as aw, ipToBinary as ax, ipToDecimal as ay, ipToDecimalCidr as az, type AprApyResult as b, validateIban as b0, validateIsbn as b1, viewportToPx as b2, 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 DiscountField as v, type DiscountInput as w, type DiscountResult as x, type FormatOptions as y, type IpConversion as z };
+export { type TimeValueDirection as $, type AmortizationRow as A, BASE_LABELS as B, COMMON_CURRENCIES as C, type Dimensions as D, type FormatOptions as E, type FilePermissions as F, type IpConversion as G, type IsbnFormat as H, type IbanValidationResult as I, type IsbnResult as J, type MarginMarkupInput as K, type LoanResult as L, type MarginMarkupField as M, type MarginMarkupResult as N, type NotationStyle as O, type NumberBase as P, type PercentChangeDirection as Q, type PercentageChangeResult as R, type Permission as S, type PxConvertResult as T, type SemverVersion as U, type SimpleInterestResult as V, type SubnetInfo as W, type SuccessiveDiscountResult as X, type SuccessiveDiscountStep as Y, type TaxDirection as Z, type TaxResult as _, type AprApyDirection as a, satisfiesRange as a$, type TimeValueResult as a0, type TipSplitResult as a1, type VideoBitrateInput as a2, type VideoBitrateMode as a3, type VideoBitrateResult as a4, type ViewportConvertResult as a5, applySuccessiveDiscounts as a6, autoFormat as a7, bumpVersion as a8, calcAspectRatio as a9, gcd as aA, ipFromBinary as aB, ipFromDecimal as aC, ipFromHex as aD, ipToBinary as aE, ipToDecimal as aF, ipToDecimalCidr as aG, ipToHex as aH, ipToOctal as aI, isValid as aJ, isValidCidr as aK, isValidIp as aL, isValidIpv4 as aM, marginToMarkup as aN, markupToMargin as aO, octalToPermissions as aP, parseFileSize as aQ, parseInput as aR, parseNumberString as aS, parseSemver as aT, permissionsToChmod as aU, permissionsToOctal as aV, permissionsToSymbolic as aW, ptToPx as aX, pxToAll as aY, pxToViewport as aZ, remToPx as a_, calcSubnet as aa, calculateBreakEven as ab, calculateCompoundInterest as ac, calculateDiscount as ad, calculateLoan as ae, calculateMarginMarkup as af, calculatePercentageChange as ag, calculateSimpleInterest as ah, calculateTax as ai, calculateTimeValue as aj, calculateTipSplit as ak, calculateVideoBitrate as al, compareSemver as am, convert as an, convertAprApy as ao, convertBytes as ap, convertIp as aq, coverBox as ar, decimalToIp as as, decimalToIpCidr as at, describePermissions as au, fitIntoBox as av, formatNumber as aw, formatValue as ax, formatVwValue as ay, formatWithSeparator as az, type AprApyResult as b, scaleByHeight as b0, scaleByWidth as b1, sortVersions as b2, splitSubnet as b3, symbolicToPermissions as b4, validateBarcode as b5, validateCardNumber as b6, validateIban as b7, validateIsbn as b8, viewportToPx as b9, 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 BreakEvenInput as i, type BreakEvenResult as j, type ByteConvertResult as k, type ByteUnit as l, COMMON_LOCALES as m, COMMON_PERMISSIONS as n, COMMON_RATIOS as o, COMMON_SIZES as p, COMMON_TAX_RATES as q, COMMON_TIP_PERCENTAGES as r, COMMON_VIEWPORTS as s, type CardValidationResult as t, units as u, type CompoundInterestResult as v, type CompoundYearRow as w, type DiscountField as x, type DiscountInput as y, type DiscountResult as z };

package/package.json

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