@utilix-tech/sdk 0.25.0 → 0.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1508,6 +1508,91 @@ function calculateBreakEven(input) {
1508
1508
  }
1509
1509
  return result;
1510
1510
  }
1511
+ function calculateVideoBitrate(input) {
1512
+ const { mode, durationSeconds, videoBitrateKbps, targetSizeMB } = input;
1513
+ const audioBitrateKbps = input.audioBitrateKbps ?? 0;
1514
+ if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
1515
+ return { error: "durationSeconds must be a positive number" };
1516
+ }
1517
+ if (!Number.isFinite(audioBitrateKbps) || audioBitrateKbps < 0) {
1518
+ return { error: "audioBitrateKbps must be zero or a positive number" };
1519
+ }
1520
+ const round22 = (n) => Math.round(n * 100) / 100;
1521
+ if (mode === "size-from-bitrate") {
1522
+ if (typeof videoBitrateKbps !== "number" || !Number.isFinite(videoBitrateKbps) || videoBitrateKbps <= 0) {
1523
+ return { error: 'videoBitrateKbps must be a positive number for mode "size-from-bitrate"' };
1524
+ }
1525
+ const totalBitrateKbps = videoBitrateKbps + audioBitrateKbps;
1526
+ const fileSizeBytes = totalBitrateKbps * 1e3 * durationSeconds / 8;
1527
+ return {
1528
+ mode,
1529
+ durationSeconds,
1530
+ videoBitrateKbps: round22(videoBitrateKbps),
1531
+ audioBitrateKbps: round22(audioBitrateKbps),
1532
+ totalBitrateKbps: round22(totalBitrateKbps),
1533
+ fileSizeBytes: Math.round(fileSizeBytes),
1534
+ fileSizeMB: round22(fileSizeBytes / 1e6),
1535
+ fileSizeMiB: round22(fileSizeBytes / 1048576)
1536
+ };
1537
+ }
1538
+ if (mode === "bitrate-from-size") {
1539
+ if (typeof targetSizeMB !== "number" || !Number.isFinite(targetSizeMB) || targetSizeMB <= 0) {
1540
+ return { error: 'targetSizeMB must be a positive number for mode "bitrate-from-size"' };
1541
+ }
1542
+ const fileSizeBytes = targetSizeMB * 1e6;
1543
+ const totalBitrateKbps = fileSizeBytes * 8 / (1e3 * durationSeconds);
1544
+ const videoKbps = totalBitrateKbps - audioBitrateKbps;
1545
+ if (videoKbps <= 0) {
1546
+ return {
1547
+ error: "audioBitrateKbps exceeds the total bitrate available at this target size and duration; lower the audio bitrate or raise the target size"
1548
+ };
1549
+ }
1550
+ return {
1551
+ mode,
1552
+ durationSeconds,
1553
+ videoBitrateKbps: round22(videoKbps),
1554
+ audioBitrateKbps: round22(audioBitrateKbps),
1555
+ totalBitrateKbps: round22(totalBitrateKbps),
1556
+ fileSizeBytes: Math.round(fileSizeBytes),
1557
+ fileSizeMB: round22(targetSizeMB),
1558
+ fileSizeMiB: round22(fileSizeBytes / 1048576)
1559
+ };
1560
+ }
1561
+ return { error: 'mode must be "size-from-bitrate" or "bitrate-from-size"' };
1562
+ }
1563
+ function calculateRuleOf72(value, direction) {
1564
+ if (!Number.isFinite(value) || value <= 0) return { error: "Value must be a positive number" };
1565
+ if (direction !== "rate-to-years" && direction !== "years-to-rate") {
1566
+ return { error: 'Direction must be "rate-to-years" or "years-to-rate"' };
1567
+ }
1568
+ const round4 = (n) => Math.round(n * 1e4) / 1e4;
1569
+ if (direction === "rate-to-years") {
1570
+ const ratePercent = value;
1571
+ const ruleOf72Estimate2 = 72 / ratePercent;
1572
+ const exactValue2 = Math.log(2) / Math.log(1 + ratePercent / 100);
1573
+ const errorPercent2 = (ruleOf72Estimate2 - exactValue2) / exactValue2 * 100;
1574
+ return {
1575
+ direction,
1576
+ ratePercent: round4(ratePercent),
1577
+ years: round4(exactValue2),
1578
+ ruleOf72Estimate: round4(ruleOf72Estimate2),
1579
+ exactValue: round4(exactValue2),
1580
+ errorPercent: round4(errorPercent2)
1581
+ };
1582
+ }
1583
+ const years = value;
1584
+ const ruleOf72Estimate = 72 / years;
1585
+ const exactValue = (Math.pow(2, 1 / years) - 1) * 100;
1586
+ const errorPercent = (ruleOf72Estimate - exactValue) / exactValue * 100;
1587
+ return {
1588
+ direction,
1589
+ ratePercent: round4(exactValue),
1590
+ years: round4(years),
1591
+ ruleOf72Estimate: round4(ruleOf72Estimate),
1592
+ exactValue: round4(exactValue),
1593
+ errorPercent: round4(errorPercent)
1594
+ };
1595
+ }
1511
1596
 
1512
1597
  exports.BASE_LABELS = BASE_LABELS;
1513
1598
  exports.BASE_PREFIXES = BASE_PREFIXES;
@@ -1531,10 +1616,12 @@ exports.calculateDiscount = calculateDiscount;
1531
1616
  exports.calculateLoan = calculateLoan;
1532
1617
  exports.calculateMarginMarkup = calculateMarginMarkup;
1533
1618
  exports.calculatePercentageChange = calculatePercentageChange;
1619
+ exports.calculateRuleOf72 = calculateRuleOf72;
1534
1620
  exports.calculateSimpleInterest = calculateSimpleInterest;
1535
1621
  exports.calculateTax = calculateTax;
1536
1622
  exports.calculateTimeValue = calculateTimeValue;
1537
1623
  exports.calculateTipSplit = calculateTipSplit;
1624
+ exports.calculateVideoBitrate = calculateVideoBitrate;
1538
1625
  exports.compareSemver = compareSemver;
1539
1626
  exports.convert = convert;
1540
1627
  exports.convertAprApy = convertAprApy;
@@ -1 +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 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 ViewportConvertResult, a3 as applySuccessiveDiscounts, a4 as autoFormat, a5 as bumpVersion, a6 as calcAspectRatio, a7 as calcSubnet, a8 as calculateBreakEven, a9 as calculateCompoundInterest, aa as calculateDiscount, ab as calculateLoan, ac as calculateMarginMarkup, ad as calculatePercentageChange, ae as calculateSimpleInterest, af as calculateTax, ag as calculateTimeValue, ah as calculateTipSplit, ai as compareSemver, aj as convert, ak as convertAprApy, al as convertBytes, am as convertIp, an as coverBox, ao as decimalToIp, ap as decimalToIpCidr, aq as describePermissions, ar as fitIntoBox, as as formatNumber, at as formatValue, au as formatVwValue, av as formatWithSeparator, aw as gcd, ax as ipFromBinary, ay as ipFromDecimal, az as ipFromHex, aA as ipToBinary, aB as ipToDecimal, aC as ipToDecimalCidr, aD as ipToHex, aE as ipToOctal, aF as isValid, aG as isValidCidr, aH as isValidIp, aI as isValidIpv4, aJ as marginToMarkup, aK as markupToMargin, aL as octalToPermissions, aM as parseFileSize, aN as parseInput, aO as parseNumberString, aP as parseSemver, aQ as permissionsToChmod, aR as permissionsToOctal, aS as permissionsToSymbolic, aT as ptToPx, aU as pxToAll, aV as pxToViewport, aW as remToPx, aX as satisfiesRange, aY as scaleByHeight, aZ as scaleByWidth, a_ as sortVersions, a$ as splitSubnet, b0 as symbolicToPermissions, b1 as validateBarcode, b2 as validateCardNumber, b3 as validateIban, b4 as validateIsbn, b5 as viewportToPx } from '../units-DUqjk24x.cjs';
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 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 RuleOf72Direction, V as RuleOf72Result, W as SemverVersion, X as SimpleInterestResult, Y as SubnetInfo, Z as SuccessiveDiscountResult, _ as SuccessiveDiscountStep, $ as TaxDirection, a0 as TaxResult, a1 as TimeValueDirection, a2 as TimeValueResult, a3 as TipSplitResult, a4 as VideoBitrateInput, a5 as VideoBitrateMode, a6 as VideoBitrateResult, a7 as ViewportConvertResult, a8 as applySuccessiveDiscounts, a9 as autoFormat, aa as bumpVersion, ab as calcAspectRatio, ac as calcSubnet, ad as calculateBreakEven, ae as calculateCompoundInterest, af as calculateDiscount, ag as calculateLoan, ah as calculateMarginMarkup, ai as calculatePercentageChange, aj as calculateRuleOf72, ak as calculateSimpleInterest, al as calculateTax, am as calculateTimeValue, an as calculateTipSplit, ao as calculateVideoBitrate, ap as compareSemver, aq as convert, ar as convertAprApy, as as convertBytes, at as convertIp, au as coverBox, av as decimalToIp, aw as decimalToIpCidr, ax as describePermissions, ay as fitIntoBox, az as formatNumber, aA as formatValue, aB as formatVwValue, aC as formatWithSeparator, aD as gcd, aE as ipFromBinary, aF as ipFromDecimal, aG as ipFromHex, aH as ipToBinary, aI as ipToDecimal, aJ as ipToDecimalCidr, aK as ipToHex, aL as ipToOctal, aM as isValid, aN as isValidCidr, aO as isValidIp, aP as isValidIpv4, aQ as marginToMarkup, aR as markupToMargin, aS as octalToPermissions, aT as parseFileSize, aU as parseInput, aV as parseNumberString, aW as parseSemver, aX as permissionsToChmod, aY as permissionsToOctal, aZ as permissionsToSymbolic, a_ as ptToPx, a$ as pxToAll, b0 as pxToViewport, b1 as remToPx, b2 as satisfiesRange, b3 as scaleByHeight, b4 as scaleByWidth, b5 as sortVersions, b6 as splitSubnet, b7 as symbolicToPermissions, b8 as validateBarcode, b9 as validateCardNumber, ba as validateIban, bb as validateIsbn, bc as viewportToPx } from '../units-COt5uI20.cjs';
@@ -1 +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 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 ViewportConvertResult, a3 as applySuccessiveDiscounts, a4 as autoFormat, a5 as bumpVersion, a6 as calcAspectRatio, a7 as calcSubnet, a8 as calculateBreakEven, a9 as calculateCompoundInterest, aa as calculateDiscount, ab as calculateLoan, ac as calculateMarginMarkup, ad as calculatePercentageChange, ae as calculateSimpleInterest, af as calculateTax, ag as calculateTimeValue, ah as calculateTipSplit, ai as compareSemver, aj as convert, ak as convertAprApy, al as convertBytes, am as convertIp, an as coverBox, ao as decimalToIp, ap as decimalToIpCidr, aq as describePermissions, ar as fitIntoBox, as as formatNumber, at as formatValue, au as formatVwValue, av as formatWithSeparator, aw as gcd, ax as ipFromBinary, ay as ipFromDecimal, az as ipFromHex, aA as ipToBinary, aB as ipToDecimal, aC as ipToDecimalCidr, aD as ipToHex, aE as ipToOctal, aF as isValid, aG as isValidCidr, aH as isValidIp, aI as isValidIpv4, aJ as marginToMarkup, aK as markupToMargin, aL as octalToPermissions, aM as parseFileSize, aN as parseInput, aO as parseNumberString, aP as parseSemver, aQ as permissionsToChmod, aR as permissionsToOctal, aS as permissionsToSymbolic, aT as ptToPx, aU as pxToAll, aV as pxToViewport, aW as remToPx, aX as satisfiesRange, aY as scaleByHeight, aZ as scaleByWidth, a_ as sortVersions, a$ as splitSubnet, b0 as symbolicToPermissions, b1 as validateBarcode, b2 as validateCardNumber, b3 as validateIban, b4 as validateIsbn, b5 as viewportToPx } from '../units-DUqjk24x.js';
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 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 RuleOf72Direction, V as RuleOf72Result, W as SemverVersion, X as SimpleInterestResult, Y as SubnetInfo, Z as SuccessiveDiscountResult, _ as SuccessiveDiscountStep, $ as TaxDirection, a0 as TaxResult, a1 as TimeValueDirection, a2 as TimeValueResult, a3 as TipSplitResult, a4 as VideoBitrateInput, a5 as VideoBitrateMode, a6 as VideoBitrateResult, a7 as ViewportConvertResult, a8 as applySuccessiveDiscounts, a9 as autoFormat, aa as bumpVersion, ab as calcAspectRatio, ac as calcSubnet, ad as calculateBreakEven, ae as calculateCompoundInterest, af as calculateDiscount, ag as calculateLoan, ah as calculateMarginMarkup, ai as calculatePercentageChange, aj as calculateRuleOf72, ak as calculateSimpleInterest, al as calculateTax, am as calculateTimeValue, an as calculateTipSplit, ao as calculateVideoBitrate, ap as compareSemver, aq as convert, ar as convertAprApy, as as convertBytes, at as convertIp, au as coverBox, av as decimalToIp, aw as decimalToIpCidr, ax as describePermissions, ay as fitIntoBox, az as formatNumber, aA as formatValue, aB as formatVwValue, aC as formatWithSeparator, aD as gcd, aE as ipFromBinary, aF as ipFromDecimal, aG as ipFromHex, aH as ipToBinary, aI as ipToDecimal, aJ as ipToDecimalCidr, aK as ipToHex, aL as ipToOctal, aM as isValid, aN as isValidCidr, aO as isValidIp, aP as isValidIpv4, aQ as marginToMarkup, aR as markupToMargin, aS as octalToPermissions, aT as parseFileSize, aU as parseInput, aV as parseNumberString, aW as parseSemver, aX as permissionsToChmod, aY as permissionsToOctal, aZ as permissionsToSymbolic, a_ as ptToPx, a$ as pxToAll, b0 as pxToViewport, b1 as remToPx, b2 as satisfiesRange, b3 as scaleByHeight, b4 as scaleByWidth, b5 as sortVersions, b6 as splitSubnet, b7 as symbolicToPermissions, b8 as validateBarcode, b9 as validateCardNumber, ba as validateIban, bb as validateIsbn, bc as viewportToPx } from '../units-COt5uI20.js';
@@ -1,2 +1,2 @@
1
- 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, 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-FVKNR3PV.js';
1
+ 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, calculateRuleOf72, 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-I63BCOAG.js';
2
2
  import '../chunk-MLKGABMK.js';
@@ -27,6 +27,7 @@
27
27
  * - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
28
28
  * - discount-calculator : calculateDiscount, applySuccessiveDiscounts
29
29
  * - break-even-calculator : calculateBreakEven
30
+ * - video-bitrate-calculator : calculateVideoBitrate
30
31
  */
31
32
  interface PxConvertResult {
32
33
  px: number;
@@ -594,6 +595,60 @@ interface BreakEvenResult {
594
595
  declare function calculateBreakEven(input: BreakEvenInput): BreakEvenResult | {
595
596
  error: string;
596
597
  };
598
+ type VideoBitrateMode = 'size-from-bitrate' | 'bitrate-from-size';
599
+ interface VideoBitrateInput {
600
+ mode: VideoBitrateMode;
601
+ durationSeconds: number;
602
+ /** Required for mode "size-from-bitrate". */
603
+ videoBitrateKbps?: number;
604
+ /** Optional for either mode; defaults to 0. */
605
+ audioBitrateKbps?: number;
606
+ /** Required for mode "bitrate-from-size". Decimal MB (1 MB = 1,000,000 bytes). */
607
+ targetSizeMB?: number;
608
+ }
609
+ interface VideoBitrateResult {
610
+ mode: VideoBitrateMode;
611
+ durationSeconds: number;
612
+ videoBitrateKbps: number;
613
+ audioBitrateKbps: number;
614
+ totalBitrateKbps: number;
615
+ fileSizeBytes: number;
616
+ /** Decimal megabytes: 1 MB = 1,000,000 bytes. */
617
+ fileSizeMB: number;
618
+ /** Binary mebibytes: 1 MiB = 1,048,576 bytes. */
619
+ fileSizeMiB: number;
620
+ }
621
+ /**
622
+ * Calculate the video file size from a target bitrate and duration, or the
623
+ * required bitrate to hit a target file size, with an optional separate
624
+ * audio bitrate. Pure arithmetic (fileSizeBytes = totalBitrateBps *
625
+ * durationSeconds / 8); no container parsing or encoding is performed.
626
+ */
627
+ declare function calculateVideoBitrate(input: VideoBitrateInput): VideoBitrateResult | {
628
+ error: string;
629
+ };
630
+ type RuleOf72Direction = 'rate-to-years' | 'years-to-rate';
631
+ interface RuleOf72Result {
632
+ direction: RuleOf72Direction;
633
+ ratePercent: number;
634
+ years: number;
635
+ ruleOf72Estimate: number;
636
+ exactValue: number;
637
+ errorPercent: number;
638
+ }
639
+ /**
640
+ * Estimate how many years it takes an investment to double at a given annual
641
+ * rate (direction "rate-to-years"), or the rate needed to double in a given
642
+ * number of years (direction "years-to-rate"), using the Rule of 72 shortcut
643
+ * (72 / rate, or 72 / years). Also computes the exact result from the
644
+ * logarithmic doubling-time formula ln(2) / ln(1 + rate/100), so the two can
645
+ * be compared: the Rule of 72 is most accurate for rates roughly between 6%
646
+ * and 10% and drifts further from the exact value outside that range. Pure
647
+ * arithmetic, no live rate feed.
648
+ */
649
+ declare function calculateRuleOf72(value: number, direction: RuleOf72Direction): RuleOf72Result | {
650
+ error: string;
651
+ };
597
652
 
598
653
  type units_AmortizationRow = AmortizationRow;
599
654
  type units_AprApyDirection = AprApyDirection;
@@ -640,6 +695,8 @@ type units_PercentChangeDirection = PercentChangeDirection;
640
695
  type units_PercentageChangeResult = PercentageChangeResult;
641
696
  type units_Permission = Permission;
642
697
  type units_PxConvertResult = PxConvertResult;
698
+ type units_RuleOf72Direction = RuleOf72Direction;
699
+ type units_RuleOf72Result = RuleOf72Result;
643
700
  type units_SemverVersion = SemverVersion;
644
701
  type units_SimpleInterestResult = SimpleInterestResult;
645
702
  type units_SubnetInfo = SubnetInfo;
@@ -650,6 +707,9 @@ type units_TaxResult = TaxResult;
650
707
  type units_TimeValueDirection = TimeValueDirection;
651
708
  type units_TimeValueResult = TimeValueResult;
652
709
  type units_TipSplitResult = TipSplitResult;
710
+ type units_VideoBitrateInput = VideoBitrateInput;
711
+ type units_VideoBitrateMode = VideoBitrateMode;
712
+ type units_VideoBitrateResult = VideoBitrateResult;
653
713
  type units_ViewportConvertResult = ViewportConvertResult;
654
714
  declare const units_applySuccessiveDiscounts: typeof applySuccessiveDiscounts;
655
715
  declare const units_autoFormat: typeof autoFormat;
@@ -662,10 +722,12 @@ declare const units_calculateDiscount: typeof calculateDiscount;
662
722
  declare const units_calculateLoan: typeof calculateLoan;
663
723
  declare const units_calculateMarginMarkup: typeof calculateMarginMarkup;
664
724
  declare const units_calculatePercentageChange: typeof calculatePercentageChange;
725
+ declare const units_calculateRuleOf72: typeof calculateRuleOf72;
665
726
  declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
666
727
  declare const units_calculateTax: typeof calculateTax;
667
728
  declare const units_calculateTimeValue: typeof calculateTimeValue;
668
729
  declare const units_calculateTipSplit: typeof calculateTipSplit;
730
+ declare const units_calculateVideoBitrate: typeof calculateVideoBitrate;
669
731
  declare const units_compareSemver: typeof compareSemver;
670
732
  declare const units_convert: typeof convert;
671
733
  declare const units_convertAprApy: typeof convertAprApy;
@@ -719,7 +781,7 @@ declare const units_validateIban: typeof validateIban;
719
781
  declare const units_validateIsbn: typeof validateIsbn;
720
782
  declare const units_viewportToPx: typeof viewportToPx;
721
783
  declare namespace units {
722
- 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_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_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 };
784
+ 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_RuleOf72Direction as RuleOf72Direction, type units_RuleOf72Result as RuleOf72Result, 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_calculateRuleOf72 as calculateRuleOf72, 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 };
723
785
  }
724
786
 
725
- 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, splitSubnet as a$, type TimeValueResult as a0, type TipSplitResult as a1, type ViewportConvertResult as a2, applySuccessiveDiscounts as a3, autoFormat as a4, bumpVersion as a5, calcAspectRatio as a6, calcSubnet as a7, calculateBreakEven as a8, calculateCompoundInterest as a9, ipToBinary as aA, ipToDecimal as aB, ipToDecimalCidr as aC, ipToHex as aD, ipToOctal as aE, isValid as aF, isValidCidr as aG, isValidIp as aH, isValidIpv4 as aI, marginToMarkup as aJ, markupToMargin as aK, octalToPermissions as aL, parseFileSize as aM, parseInput as aN, parseNumberString as aO, parseSemver as aP, permissionsToChmod as aQ, permissionsToOctal as aR, permissionsToSymbolic as aS, ptToPx as aT, pxToAll as aU, pxToViewport as aV, remToPx as aW, satisfiesRange as aX, scaleByHeight as aY, scaleByWidth as aZ, sortVersions as a_, calculateDiscount as aa, calculateLoan as ab, calculateMarginMarkup as ac, calculatePercentageChange as ad, calculateSimpleInterest as ae, calculateTax as af, calculateTimeValue as ag, calculateTipSplit as ah, compareSemver as ai, convert as aj, convertAprApy as ak, convertBytes as al, convertIp as am, coverBox as an, decimalToIp as ao, decimalToIpCidr as ap, describePermissions as aq, fitIntoBox as ar, formatNumber as as, formatValue as at, formatVwValue as au, formatWithSeparator as av, gcd as aw, ipFromBinary as ax, ipFromDecimal as ay, ipFromHex as az, type AprApyResult as b, symbolicToPermissions as b0, validateBarcode as b1, validateCardNumber as b2, validateIban as b3, validateIsbn as b4, viewportToPx as b5, 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 };
787
+ export { type TaxDirection 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 RuleOf72Direction as U, type RuleOf72Result as V, type SemverVersion as W, type SimpleInterestResult as X, type SubnetInfo as Y, type SuccessiveDiscountResult as Z, type SuccessiveDiscountStep as _, type AprApyDirection as a, pxToAll as a$, type TaxResult as a0, type TimeValueDirection as a1, type TimeValueResult as a2, type TipSplitResult as a3, type VideoBitrateInput as a4, type VideoBitrateMode as a5, type VideoBitrateResult as a6, type ViewportConvertResult as a7, applySuccessiveDiscounts as a8, autoFormat as a9, formatValue as aA, formatVwValue as aB, formatWithSeparator as aC, gcd as aD, ipFromBinary as aE, ipFromDecimal as aF, ipFromHex as aG, ipToBinary as aH, ipToDecimal as aI, ipToDecimalCidr as aJ, ipToHex as aK, ipToOctal as aL, isValid as aM, isValidCidr as aN, isValidIp as aO, isValidIpv4 as aP, marginToMarkup as aQ, markupToMargin as aR, octalToPermissions as aS, parseFileSize as aT, parseInput as aU, parseNumberString as aV, parseSemver as aW, permissionsToChmod as aX, permissionsToOctal as aY, permissionsToSymbolic as aZ, ptToPx as a_, bumpVersion as aa, calcAspectRatio as ab, calcSubnet as ac, calculateBreakEven as ad, calculateCompoundInterest as ae, calculateDiscount as af, calculateLoan as ag, calculateMarginMarkup as ah, calculatePercentageChange as ai, calculateRuleOf72 as aj, calculateSimpleInterest as ak, calculateTax as al, calculateTimeValue as am, calculateTipSplit as an, calculateVideoBitrate as ao, compareSemver as ap, convert as aq, convertAprApy as ar, convertBytes as as, convertIp as at, coverBox as au, decimalToIp as av, decimalToIpCidr as aw, describePermissions as ax, fitIntoBox as ay, formatNumber as az, type AprApyResult as b, pxToViewport as b0, remToPx as b1, satisfiesRange as b2, scaleByHeight as b3, scaleByWidth as b4, sortVersions as b5, splitSubnet as b6, symbolicToPermissions as b7, validateBarcode as b8, validateCardNumber as b9, validateIban as ba, validateIsbn as bb, viewportToPx as bc, 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 };
@@ -27,6 +27,7 @@
27
27
  * - margin-markup-calculator : calculateMarginMarkup, marginToMarkup, markupToMargin
28
28
  * - discount-calculator : calculateDiscount, applySuccessiveDiscounts
29
29
  * - break-even-calculator : calculateBreakEven
30
+ * - video-bitrate-calculator : calculateVideoBitrate
30
31
  */
31
32
  interface PxConvertResult {
32
33
  px: number;
@@ -594,6 +595,60 @@ interface BreakEvenResult {
594
595
  declare function calculateBreakEven(input: BreakEvenInput): BreakEvenResult | {
595
596
  error: string;
596
597
  };
598
+ type VideoBitrateMode = 'size-from-bitrate' | 'bitrate-from-size';
599
+ interface VideoBitrateInput {
600
+ mode: VideoBitrateMode;
601
+ durationSeconds: number;
602
+ /** Required for mode "size-from-bitrate". */
603
+ videoBitrateKbps?: number;
604
+ /** Optional for either mode; defaults to 0. */
605
+ audioBitrateKbps?: number;
606
+ /** Required for mode "bitrate-from-size". Decimal MB (1 MB = 1,000,000 bytes). */
607
+ targetSizeMB?: number;
608
+ }
609
+ interface VideoBitrateResult {
610
+ mode: VideoBitrateMode;
611
+ durationSeconds: number;
612
+ videoBitrateKbps: number;
613
+ audioBitrateKbps: number;
614
+ totalBitrateKbps: number;
615
+ fileSizeBytes: number;
616
+ /** Decimal megabytes: 1 MB = 1,000,000 bytes. */
617
+ fileSizeMB: number;
618
+ /** Binary mebibytes: 1 MiB = 1,048,576 bytes. */
619
+ fileSizeMiB: number;
620
+ }
621
+ /**
622
+ * Calculate the video file size from a target bitrate and duration, or the
623
+ * required bitrate to hit a target file size, with an optional separate
624
+ * audio bitrate. Pure arithmetic (fileSizeBytes = totalBitrateBps *
625
+ * durationSeconds / 8); no container parsing or encoding is performed.
626
+ */
627
+ declare function calculateVideoBitrate(input: VideoBitrateInput): VideoBitrateResult | {
628
+ error: string;
629
+ };
630
+ type RuleOf72Direction = 'rate-to-years' | 'years-to-rate';
631
+ interface RuleOf72Result {
632
+ direction: RuleOf72Direction;
633
+ ratePercent: number;
634
+ years: number;
635
+ ruleOf72Estimate: number;
636
+ exactValue: number;
637
+ errorPercent: number;
638
+ }
639
+ /**
640
+ * Estimate how many years it takes an investment to double at a given annual
641
+ * rate (direction "rate-to-years"), or the rate needed to double in a given
642
+ * number of years (direction "years-to-rate"), using the Rule of 72 shortcut
643
+ * (72 / rate, or 72 / years). Also computes the exact result from the
644
+ * logarithmic doubling-time formula ln(2) / ln(1 + rate/100), so the two can
645
+ * be compared: the Rule of 72 is most accurate for rates roughly between 6%
646
+ * and 10% and drifts further from the exact value outside that range. Pure
647
+ * arithmetic, no live rate feed.
648
+ */
649
+ declare function calculateRuleOf72(value: number, direction: RuleOf72Direction): RuleOf72Result | {
650
+ error: string;
651
+ };
597
652
 
598
653
  type units_AmortizationRow = AmortizationRow;
599
654
  type units_AprApyDirection = AprApyDirection;
@@ -640,6 +695,8 @@ type units_PercentChangeDirection = PercentChangeDirection;
640
695
  type units_PercentageChangeResult = PercentageChangeResult;
641
696
  type units_Permission = Permission;
642
697
  type units_PxConvertResult = PxConvertResult;
698
+ type units_RuleOf72Direction = RuleOf72Direction;
699
+ type units_RuleOf72Result = RuleOf72Result;
643
700
  type units_SemverVersion = SemverVersion;
644
701
  type units_SimpleInterestResult = SimpleInterestResult;
645
702
  type units_SubnetInfo = SubnetInfo;
@@ -650,6 +707,9 @@ type units_TaxResult = TaxResult;
650
707
  type units_TimeValueDirection = TimeValueDirection;
651
708
  type units_TimeValueResult = TimeValueResult;
652
709
  type units_TipSplitResult = TipSplitResult;
710
+ type units_VideoBitrateInput = VideoBitrateInput;
711
+ type units_VideoBitrateMode = VideoBitrateMode;
712
+ type units_VideoBitrateResult = VideoBitrateResult;
653
713
  type units_ViewportConvertResult = ViewportConvertResult;
654
714
  declare const units_applySuccessiveDiscounts: typeof applySuccessiveDiscounts;
655
715
  declare const units_autoFormat: typeof autoFormat;
@@ -662,10 +722,12 @@ declare const units_calculateDiscount: typeof calculateDiscount;
662
722
  declare const units_calculateLoan: typeof calculateLoan;
663
723
  declare const units_calculateMarginMarkup: typeof calculateMarginMarkup;
664
724
  declare const units_calculatePercentageChange: typeof calculatePercentageChange;
725
+ declare const units_calculateRuleOf72: typeof calculateRuleOf72;
665
726
  declare const units_calculateSimpleInterest: typeof calculateSimpleInterest;
666
727
  declare const units_calculateTax: typeof calculateTax;
667
728
  declare const units_calculateTimeValue: typeof calculateTimeValue;
668
729
  declare const units_calculateTipSplit: typeof calculateTipSplit;
730
+ declare const units_calculateVideoBitrate: typeof calculateVideoBitrate;
669
731
  declare const units_compareSemver: typeof compareSemver;
670
732
  declare const units_convert: typeof convert;
671
733
  declare const units_convertAprApy: typeof convertAprApy;
@@ -719,7 +781,7 @@ declare const units_validateIban: typeof validateIban;
719
781
  declare const units_validateIsbn: typeof validateIsbn;
720
782
  declare const units_viewportToPx: typeof viewportToPx;
721
783
  declare namespace units {
722
- 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_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_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 };
784
+ 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_RuleOf72Direction as RuleOf72Direction, type units_RuleOf72Result as RuleOf72Result, 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_calculateRuleOf72 as calculateRuleOf72, 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 };
723
785
  }
724
786
 
725
- 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, splitSubnet as a$, type TimeValueResult as a0, type TipSplitResult as a1, type ViewportConvertResult as a2, applySuccessiveDiscounts as a3, autoFormat as a4, bumpVersion as a5, calcAspectRatio as a6, calcSubnet as a7, calculateBreakEven as a8, calculateCompoundInterest as a9, ipToBinary as aA, ipToDecimal as aB, ipToDecimalCidr as aC, ipToHex as aD, ipToOctal as aE, isValid as aF, isValidCidr as aG, isValidIp as aH, isValidIpv4 as aI, marginToMarkup as aJ, markupToMargin as aK, octalToPermissions as aL, parseFileSize as aM, parseInput as aN, parseNumberString as aO, parseSemver as aP, permissionsToChmod as aQ, permissionsToOctal as aR, permissionsToSymbolic as aS, ptToPx as aT, pxToAll as aU, pxToViewport as aV, remToPx as aW, satisfiesRange as aX, scaleByHeight as aY, scaleByWidth as aZ, sortVersions as a_, calculateDiscount as aa, calculateLoan as ab, calculateMarginMarkup as ac, calculatePercentageChange as ad, calculateSimpleInterest as ae, calculateTax as af, calculateTimeValue as ag, calculateTipSplit as ah, compareSemver as ai, convert as aj, convertAprApy as ak, convertBytes as al, convertIp as am, coverBox as an, decimalToIp as ao, decimalToIpCidr as ap, describePermissions as aq, fitIntoBox as ar, formatNumber as as, formatValue as at, formatVwValue as au, formatWithSeparator as av, gcd as aw, ipFromBinary as ax, ipFromDecimal as ay, ipFromHex as az, type AprApyResult as b, symbolicToPermissions as b0, validateBarcode as b1, validateCardNumber as b2, validateIban as b3, validateIsbn as b4, viewportToPx as b5, 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 };
787
+ export { type TaxDirection 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 RuleOf72Direction as U, type RuleOf72Result as V, type SemverVersion as W, type SimpleInterestResult as X, type SubnetInfo as Y, type SuccessiveDiscountResult as Z, type SuccessiveDiscountStep as _, type AprApyDirection as a, pxToAll as a$, type TaxResult as a0, type TimeValueDirection as a1, type TimeValueResult as a2, type TipSplitResult as a3, type VideoBitrateInput as a4, type VideoBitrateMode as a5, type VideoBitrateResult as a6, type ViewportConvertResult as a7, applySuccessiveDiscounts as a8, autoFormat as a9, formatValue as aA, formatVwValue as aB, formatWithSeparator as aC, gcd as aD, ipFromBinary as aE, ipFromDecimal as aF, ipFromHex as aG, ipToBinary as aH, ipToDecimal as aI, ipToDecimalCidr as aJ, ipToHex as aK, ipToOctal as aL, isValid as aM, isValidCidr as aN, isValidIp as aO, isValidIpv4 as aP, marginToMarkup as aQ, markupToMargin as aR, octalToPermissions as aS, parseFileSize as aT, parseInput as aU, parseNumberString as aV, parseSemver as aW, permissionsToChmod as aX, permissionsToOctal as aY, permissionsToSymbolic as aZ, ptToPx as a_, bumpVersion as aa, calcAspectRatio as ab, calcSubnet as ac, calculateBreakEven as ad, calculateCompoundInterest as ae, calculateDiscount as af, calculateLoan as ag, calculateMarginMarkup as ah, calculatePercentageChange as ai, calculateRuleOf72 as aj, calculateSimpleInterest as ak, calculateTax as al, calculateTimeValue as am, calculateTipSplit as an, calculateVideoBitrate as ao, compareSemver as ap, convert as aq, convertAprApy as ar, convertBytes as as, convertIp as at, coverBox as au, decimalToIp as av, decimalToIpCidr as aw, describePermissions as ax, fitIntoBox as ay, formatNumber as az, type AprApyResult as b, pxToViewport as b0, remToPx as b1, satisfiesRange as b2, scaleByHeight as b3, scaleByWidth as b4, sortVersions as b5, splitSubnet as b6, symbolicToPermissions as b7, validateBarcode as b8, validateCardNumber as b9, validateIban as ba, validateIsbn as bb, viewportToPx as bc, 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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@utilix-tech/sdk",
3
- "version": "0.25.0",
3
+ "version": "0.27.0",
4
4
  "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
5
5
  "author": "Utilix <hello@utilix.tech>",
6
6
  "license": "MIT",