tiny-essentials 1.20.3 → 1.21.1

package/dist/v1/basics/clock.cjs

@@ -144,17 +144,7 @@ function formatCustomTimer(totalSeconds, level = 'seconds', format = '{time}') {
     parts.seconds = remaining;
   }
 
-  // Calculate total
-  const totalMap = {
-    seconds: include.seconds ? totalSeconds : NaN,
-    minutes: include.minutes ? totalSeconds / 60 : NaN,
-    hours: include.hours ? totalSeconds / 3600 : NaN,
-    days: include.days ? totalSeconds / 86400 : NaN,
-    months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
-    years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
-  };
-
-  parts.total = +(totalMap[level] || 0).toFixed(2).replace(/\.00$/, '');
+  parts.total = +totalSeconds.toFixed(2).replace(/\.00$/, '');
 
   /**
    * Pads a number to ensure it is at least two digits long, using leading zeros if necessary.
@@ -211,6 +201,132 @@ function formatDayTimer(seconds) {
   return formatCustomTimer(seconds, 'days', '{days}d {hours}:{minutes}:{seconds}');
 }
 
+/**
+ * Breaks down a duration in milliseconds into its time components.
+ *
+ * @param {number} totalMs - The total duration in milliseconds.
+ * @param {'milliseconds'|'seconds'|'minutes'|'hours'|'days'|'months'|'years'} [level='milliseconds'] - The highest level to calculate and display.
+ * @returns {{
+ *   years: number|NaN,
+ *   months: number|NaN,
+ *   days: number|NaN,
+ *   hours: number|NaN,
+ *   minutes: number|NaN,
+ *   seconds: number|NaN,
+ *   milliseconds: number|NaN,
+ *   total: number|NaN
+ * }}
+ */
+function breakdownDuration(totalMs, level = 'milliseconds') {
+  totalMs = Math.max(0, Math.floor(totalMs));
+
+  const levels = ['milliseconds', 'seconds', 'minutes', 'hours', 'days', 'months', 'years'];
+  const index = levels.indexOf(level);
+
+  const include = {
+    years: index >= 6,
+    months: index >= 5,
+    days: index >= 4,
+    hours: index >= 3,
+    minutes: index >= 2,
+    seconds: index >= 1,
+    milliseconds: index >= 0,
+  };
+
+  const parts = {
+    years: include.years ? 0 : NaN,
+    months: include.months ? 0 : NaN,
+    days: include.days ? 0 : NaN,
+    hours: include.hours ? 0 : NaN,
+    minutes: include.minutes ? 0 : NaN,
+    seconds: include.seconds ? 0 : NaN,
+    milliseconds: include.milliseconds ? 0 : NaN,
+    total: NaN,
+  };
+
+  let remaining = totalMs;
+
+  if (include.years || include.months || include.days) {
+    const baseDate = new Date(1980, 0, 1);
+    const targetDate = new Date(baseDate.getTime() + remaining);
+    const workingDate = new Date(baseDate);
+
+    // Years
+    if (include.years) {
+      while (
+        new Date(
+          workingDate.getFullYear() + 1,
+          workingDate.getMonth(),
+          workingDate.getDate(),
+        ).getTime() <= targetDate.getTime()
+      ) {
+        workingDate.setFullYear(workingDate.getFullYear() + 1);
+        parts.years++;
+      }
+    }
+
+    // Months
+    if (include.months) {
+      while (
+        new Date(
+          workingDate.getFullYear(),
+          workingDate.getMonth() + 1,
+          workingDate.getDate(),
+        ).getTime() <= targetDate.getTime()
+      ) {
+        workingDate.setMonth(workingDate.getMonth() + 1);
+        parts.months++;
+      }
+    }
+
+    // Days
+    if (include.days) {
+      while (
+        new Date(
+          workingDate.getFullYear(),
+          workingDate.getMonth(),
+          workingDate.getDate() + 1,
+        ).getTime() <= targetDate.getTime()
+      ) {
+        workingDate.setDate(workingDate.getDate() + 1);
+        parts.days++;
+      }
+    }
+
+    remaining = targetDate.getTime() - workingDate.getTime();
+  }
+
+  if (include.hours) {
+    parts.hours = Math.floor(remaining / 3600000);
+    remaining %= 3600000;
+  }
+
+  if (include.minutes) {
+    parts.minutes = Math.floor(remaining / 60000);
+    remaining %= 60000;
+  }
+
+  if (include.seconds) {
+    parts.seconds = Math.floor(remaining / 1000);
+    remaining %= 1000;
+  }
+
+  if (include.milliseconds) {
+    parts.milliseconds = remaining;
+  }
+
+  // Totals
+  ({
+    months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
+    years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
+  });
+
+  parts.total = +totalMs;
+
+  return parts;
+}
+
+exports.breakdownDuration = breakdownDuration;
 exports.formatCustomTimer = formatCustomTimer;
 exports.formatDayTimer = formatDayTimer;
 exports.formatTimer = formatTimer;

package/dist/v1/basics/clock.d.mts

@@ -35,4 +35,30 @@ export function formatTimer(seconds: number): string;
  * @returns {string} The formatted timer string in "Xd HH:MM:SS" format.
  */
 export function formatDayTimer(seconds: number): string;
+/**
+ * Breaks down a duration in milliseconds into its time components.
+ *
+ * @param {number} totalMs - The total duration in milliseconds.
+ * @param {'milliseconds'|'seconds'|'minutes'|'hours'|'days'|'months'|'years'} [level='milliseconds'] - The highest level to calculate and display.
+ * @returns {{
+ *   years: number|NaN,
+ *   months: number|NaN,
+ *   days: number|NaN,
+ *   hours: number|NaN,
+ *   minutes: number|NaN,
+ *   seconds: number|NaN,
+ *   milliseconds: number|NaN,
+ *   total: number|NaN
+ * }}
+ */
+export function breakdownDuration(totalMs: number, level?: "milliseconds" | "seconds" | "minutes" | "hours" | "days" | "months" | "years"): {
+    years: number | number;
+    months: number | number;
+    days: number | number;
+    hours: number | number;
+    minutes: number | number;
+    seconds: number | number;
+    milliseconds: number | number;
+    total: number | number;
+};
 //# sourceMappingURL=clock.d.mts.map

package/dist/v1/basics/clock.mjs

@@ -117,7 +117,7 @@ export function formatCustomTimer(totalSeconds, level = 'seconds', format = '{ti
         months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
         years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
     };
-    parts.total = +(totalMap[level] || 0).toFixed(2).replace(/\.00$/, '');
+    parts.total = +totalSeconds.toFixed(2).replace(/\.00$/, '');
     /**
      * Pads a number to ensure it is at least two digits long, using leading zeros if necessary.
      *
@@ -168,3 +168,98 @@ export function formatTimer(seconds) {
 export function formatDayTimer(seconds) {
     return formatCustomTimer(seconds, 'days', '{days}d {hours}:{minutes}:{seconds}');
 }
+/**
+ * Breaks down a duration in milliseconds into its time components.
+ *
+ * @param {number} totalMs - The total duration in milliseconds.
+ * @param {'milliseconds'|'seconds'|'minutes'|'hours'|'days'|'months'|'years'} [level='milliseconds'] - The highest level to calculate and display.
+ * @returns {{
+ *   years: number|NaN,
+ *   months: number|NaN,
+ *   days: number|NaN,
+ *   hours: number|NaN,
+ *   minutes: number|NaN,
+ *   seconds: number|NaN,
+ *   milliseconds: number|NaN,
+ *   total: number|NaN
+ * }}
+ */
+export function breakdownDuration(totalMs, level = 'milliseconds') {
+    totalMs = Math.max(0, Math.floor(totalMs));
+    const levels = ['milliseconds', 'seconds', 'minutes', 'hours', 'days', 'months', 'years'];
+    const index = levels.indexOf(level);
+    const include = {
+        years: index >= 6,
+        months: index >= 5,
+        days: index >= 4,
+        hours: index >= 3,
+        minutes: index >= 2,
+        seconds: index >= 1,
+        milliseconds: index >= 0,
+    };
+    const parts = {
+        years: include.years ? 0 : NaN,
+        months: include.months ? 0 : NaN,
+        days: include.days ? 0 : NaN,
+        hours: include.hours ? 0 : NaN,
+        minutes: include.minutes ? 0 : NaN,
+        seconds: include.seconds ? 0 : NaN,
+        milliseconds: include.milliseconds ? 0 : NaN,
+        total: NaN,
+    };
+    let remaining = totalMs;
+    if (include.years || include.months || include.days) {
+        const baseDate = new Date(1980, 0, 1);
+        const targetDate = new Date(baseDate.getTime() + remaining);
+        const workingDate = new Date(baseDate);
+        // Years
+        if (include.years) {
+            while (new Date(workingDate.getFullYear() + 1, workingDate.getMonth(), workingDate.getDate()).getTime() <= targetDate.getTime()) {
+                workingDate.setFullYear(workingDate.getFullYear() + 1);
+                parts.years++;
+            }
+        }
+        // Months
+        if (include.months) {
+            while (new Date(workingDate.getFullYear(), workingDate.getMonth() + 1, workingDate.getDate()).getTime() <= targetDate.getTime()) {
+                workingDate.setMonth(workingDate.getMonth() + 1);
+                parts.months++;
+            }
+        }
+        // Days
+        if (include.days) {
+            while (new Date(workingDate.getFullYear(), workingDate.getMonth(), workingDate.getDate() + 1).getTime() <= targetDate.getTime()) {
+                workingDate.setDate(workingDate.getDate() + 1);
+                parts.days++;
+            }
+        }
+        remaining = targetDate.getTime() - workingDate.getTime();
+    }
+    if (include.hours) {
+        parts.hours = Math.floor(remaining / 3600000);
+        remaining %= 3600000;
+    }
+    if (include.minutes) {
+        parts.minutes = Math.floor(remaining / 60000);
+        remaining %= 60000;
+    }
+    if (include.seconds) {
+        parts.seconds = Math.floor(remaining / 1000);
+        remaining %= 1000;
+    }
+    if (include.milliseconds) {
+        parts.milliseconds = remaining;
+    }
+    // Totals
+    const totalMap = {
+        milliseconds: include.milliseconds ? totalMs : NaN,
+        seconds: include.seconds ? totalMs / 1000 : NaN,
+        minutes: include.minutes ? totalMs / 60000 : NaN,
+        hours: include.hours ? totalMs / 3600000 : NaN,
+        days: include.days ? totalMs / 86400000 : NaN,
+        months: include.months ? parts.years * 12 + parts.months + (parts.days || 0) / 30 : NaN,
+        years: include.years ? parts.years + (parts.months || 0) / 12 + (parts.days || 0) / 365 : NaN,
+    };
+    parts.total = +totalMs;
+    return parts;
+}

package/dist/v1/basics/index.cjs

@@ -5,7 +5,6 @@ var replaceAsync = require('../../legacy/libs/replaceAsync.cjs');
 var array = require('./array.cjs');
 var clock = require('./clock.cjs');
 var html = require('./html.cjs');
-var html_deprecated = require('./html_deprecated.cjs');
 var objFilter = require('./objFilter.cjs');
 var objChecker = require('./objChecker.cjs');
 var fullScreen = require('./fullScreen.cjs');
@@ -29,13 +28,6 @@ exports.readBase64Blob = html.readBase64Blob;
 exports.readFileBlob = html.readFileBlob;
 exports.readJsonBlob = html.readJsonBlob;
 exports.saveJsonFile = html.saveJsonFile;
-exports.areHtmlElsColliding = html_deprecated.areHtmlElsColliding;
-exports.getHtmlElBorders = html_deprecated.getHtmlElBorders;
-exports.getHtmlElBordersWidth = html_deprecated.getHtmlElBordersWidth;
-exports.getHtmlElMargin = html_deprecated.getHtmlElMargin;
-exports.getHtmlElPadding = html_deprecated.getHtmlElPadding;
-exports.isInViewport = html_deprecated.isInViewport;
-exports.isScrolledIntoView = html_deprecated.isScrolledIntoView;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.extendObjType = objFilter.extendObjType;
 exports.objType = objFilter.objType;
@@ -49,6 +41,8 @@ exports.isScreenFilled = fullScreen.isScreenFilled;
 exports.offFullScreenChange = fullScreen.offFullScreenChange;
 exports.onFullScreenChange = fullScreen.onFullScreenChange;
 exports.requestFullScreen = fullScreen.requestFullScreen;
+exports.calculateMarketcap = simpleMath.calculateMarketcap;
+exports.compareMarketcap = simpleMath.compareMarketcap;
 exports.formatBytes = simpleMath.formatBytes;
 exports.genFibonacciSeq = simpleMath.genFibonacciSeq;
 exports.getAge = simpleMath.getAge;

package/dist/v1/basics/index.d.mts

@@ -1,3 +1,5 @@
+import { calculateMarketcap } from './simpleMath.mjs';
+import { compareMarketcap } from './simpleMath.mjs';
 import { getPercentage } from './simpleMath.mjs';
 import { areElsCollTop } from './collision.mjs';
 import { areElsCollBottom } from './collision.mjs';
@@ -17,15 +19,9 @@ import { getRectCenter } from './collision.mjs';
 import { getElsRelativeCenterOffset } from './collision.mjs';
 import { getElsCollDirDepth } from './collision.mjs';
 import { getElsCollDetails } from './collision.mjs';
-import { isInViewport } from './html_deprecated.mjs';
-import { isScrolledIntoView } from './html_deprecated.mjs';
 import { safeTextTrim } from './text.mjs';
 import { installWindowHiddenScript } from './html.mjs';
 import { genFibonacciSeq } from './simpleMath.mjs';
-import { getHtmlElBorders } from './html_deprecated.mjs';
-import { getHtmlElBordersWidth } from './html_deprecated.mjs';
-import { getHtmlElMargin } from './html_deprecated.mjs';
-import { getHtmlElPadding } from './html_deprecated.mjs';
 import { fetchJson } from './html.mjs';
 import { fetchText } from './html.mjs';
 import { readJsonBlob } from './html.mjs';
@@ -39,7 +35,6 @@ import { exitFullScreen } from './fullScreen.mjs';
 import { isFullScreenMode } from './fullScreen.mjs';
 import { onFullScreenChange } from './fullScreen.mjs';
 import { offFullScreenChange } from './fullScreen.mjs';
-import { areHtmlElsColliding } from './html_deprecated.mjs';
 import { isJsonObject } from './objChecker.mjs';
 import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import { formatBytes } from './simpleMath.mjs';
@@ -60,5 +55,5 @@ import { getTimeDuration } from './clock.mjs';
 import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
-export { getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/index.mjs

@@ -3,11 +3,10 @@ import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
 import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
 import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, fetchText, } from './html.mjs';
-import { areHtmlElsColliding, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, isInViewport, isScrolledIntoView, } from './html_deprecated.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType } from './objFilter.mjs';
 import { countObj, isJsonObject } from './objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './fullScreen.mjs';
-import { formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './simpleMath.mjs';
+import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './simpleMath.mjs';
 import { addAiMarkerShortcut, safeTextTrim, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './collision.mjs';
-export { getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, isInViewport, isScrolledIntoView, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, getHtmlElBorders, getHtmlElBordersWidth, getHtmlElMargin, getHtmlElPadding, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, areHtmlElsColliding, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/basics/simpleMath.cjs

@@ -181,6 +181,52 @@ function genFibonacciSeq({
   return sequence;
 }
 
+/**
+ * Calculates the unit price of a coin or token based on the market capitalization and circulating supply.
+ *
+ * This function is typically used in financial contexts to determine the price
+ * of an asset by dividing its total market capitalization by its circulating supply.
+ *
+ * @param {number} originalMarketCap - The total market capitalization (e.g., in USD).
+ * @param {number} circulatingSupply - The number of coins/tokens currently in circulation.
+ * @returns {number} The calculated price per unit of the asset.
+ */
+function calculateMarketcap(originalMarketCap, circulatingSupply) {
+  if (Number.isNaN(originalMarketCap) || !Number.isFinite(originalMarketCap))
+    throw new TypeError('Original market cap must be a number.');
+  if (Number.isNaN(circulatingSupply) || !Number.isFinite(circulatingSupply))
+    throw new TypeError('Circulating supply must be a number.');
+  if (circulatingSupply <= 0) throw new Error('Circulating supply must be greater than zero.');
+  return originalMarketCap / circulatingSupply;
+}
+
+/**
+ * Calculates the new price of a coin when the market cap changes.
+ * @param {number} originalMarketCap - The original market cap.
+ * @param {number} circulatingSupply - The circulating supply.
+ * @param {number} newMarketCap - The new market cap.
+ * @returns {{
+ *   originalPrice: number,
+ *   newPrice: number,
+ *   priceChangePercent: number
+ * }}
+ */
+function compareMarketcap(originalMarketCap, circulatingSupply, newMarketCap) {
+  if (Number.isNaN(newMarketCap) || !Number.isFinite(newMarketCap))
+    throw new TypeError('New market cap must be a number.');
+  const originalPrice = calculateMarketcap(originalMarketCap, circulatingSupply);
+  const newPrice = typeof newMarketCap === 'number' ? newMarketCap / circulatingSupply : NaN;
+  const priceChangePercent =
+    typeof newMarketCap === 'number' ? ((newPrice - originalPrice) / originalPrice) * 100 : NaN;
+  return {
+    originalPrice,
+    newPrice,
+    priceChangePercent,
+  };
+}
+
+exports.calculateMarketcap = calculateMarketcap;
+exports.compareMarketcap = compareMarketcap;
 exports.formatBytes = formatBytes;
 exports.genFibonacciSeq = genFibonacciSeq;
 exports.getAge = getAge;

package/dist/v1/basics/simpleMath.d.mts

@@ -112,6 +112,33 @@ export function genFibonacciSeq({ baseValues, length, combiner, }?: {
     length?: number | undefined;
     combiner?: ((a: number, b: number, index: number) => number) | undefined;
 }): number[];
+/**
+ * Calculates the unit price of a coin or token based on the market capitalization and circulating supply.
+ *
+ * This function is typically used in financial contexts to determine the price
+ * of an asset by dividing its total market capitalization by its circulating supply.
+ *
+ * @param {number} originalMarketCap - The total market capitalization (e.g., in USD).
+ * @param {number} circulatingSupply - The number of coins/tokens currently in circulation.
+ * @returns {number} The calculated price per unit of the asset.
+ */
+export function calculateMarketcap(originalMarketCap: number, circulatingSupply: number): number;
+/**
+ * Calculates the new price of a coin when the market cap changes.
+ * @param {number} originalMarketCap - The original market cap.
+ * @param {number} circulatingSupply - The circulating supply.
+ * @param {number} newMarketCap - The new market cap.
+ * @returns {{
+ *   originalPrice: number,
+ *   newPrice: number,
+ *   priceChangePercent: number
+ * }}
+ */
+export function compareMarketcap(originalMarketCap: number, circulatingSupply: number, newMarketCap: number): {
+    originalPrice: number;
+    newPrice: number;
+    priceChangePercent: number;
+};
 export type FormattedByteResult = {
     /**
      * - The resulting unit (e.g., 'MB', 'GB') or null if input is invalid.

package/dist/v1/basics/simpleMath.mjs

@@ -158,3 +158,45 @@ export function genFibonacciSeq({ baseValues = [0, 1], length = 10, combiner = (
     }
     return sequence;
 }
+/**
+ * Calculates the unit price of a coin or token based on the market capitalization and circulating supply.
+ *
+ * This function is typically used in financial contexts to determine the price
+ * of an asset by dividing its total market capitalization by its circulating supply.
+ *
+ * @param {number} originalMarketCap - The total market capitalization (e.g., in USD).
+ * @param {number} circulatingSupply - The number of coins/tokens currently in circulation.
+ * @returns {number} The calculated price per unit of the asset.
+ */
+export function calculateMarketcap(originalMarketCap, circulatingSupply) {
+    if (Number.isNaN(originalMarketCap) || !Number.isFinite(originalMarketCap))
+        throw new TypeError('Original market cap must be a number.');
+    if (Number.isNaN(circulatingSupply) || !Number.isFinite(circulatingSupply))
+        throw new TypeError('Circulating supply must be a number.');
+    if (circulatingSupply <= 0)
+        throw new Error('Circulating supply must be greater than zero.');
+    return originalMarketCap / circulatingSupply;
+}
+/**
+ * Calculates the new price of a coin when the market cap changes.
+ * @param {number} originalMarketCap - The original market cap.
+ * @param {number} circulatingSupply - The circulating supply.
+ * @param {number} newMarketCap - The new market cap.
+ * @returns {{
+ *   originalPrice: number,
+ *   newPrice: number,
+ *   priceChangePercent: number
+ * }}
+ */
+export function compareMarketcap(originalMarketCap, circulatingSupply, newMarketCap) {
+    if (Number.isNaN(newMarketCap) || !Number.isFinite(newMarketCap))
+        throw new TypeError('New market cap must be a number.');
+    const originalPrice = calculateMarketcap(originalMarketCap, circulatingSupply);
+    const newPrice = typeof newMarketCap === 'number' ? newMarketCap / circulatingSupply : NaN;
+    const priceChangePercent = typeof newMarketCap === 'number' ? ((newPrice - originalPrice) / originalPrice) * 100 : NaN;
+    return {
+        originalPrice,
+        newPrice,
+        priceChangePercent,
+    };
+}

package/dist/v1/build/TinyAdvancedRaffle.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyAdvancedRaffle = require('../libs/TinyAdvancedRaffle.cjs');
+
+
+
+exports.TinyAdvancedRaffle = TinyAdvancedRaffle;

package/dist/v1/build/TinyAdvancedRaffle.d.mts

@@ -0,0 +1,3 @@
+export { TinyAdvancedRaffle };
+import TinyAdvancedRaffle from '../libs/TinyAdvancedRaffle.mjs';
+//# sourceMappingURL=TinyAdvancedRaffle.d.mts.map

package/dist/v1/build/TinyAdvancedRaffle.mjs

@@ -0,0 +1,2 @@
+import TinyAdvancedRaffle from '../libs/TinyAdvancedRaffle.mjs';
+export { TinyAdvancedRaffle };

package/dist/v1/build/TinyArrayPaginator.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyArrayPaginator = require('../libs/TinyArrayPaginator.cjs');
+
+
+
+exports.TinyArrayPaginator = TinyArrayPaginator;

package/dist/v1/build/TinyArrayPaginator.d.mts

@@ -0,0 +1,3 @@
+export { TinyArrayPaginator };
+import TinyArrayPaginator from '../libs/TinyArrayPaginator.mjs';
+//# sourceMappingURL=TinyArrayPaginator.d.mts.map

package/dist/v1/build/TinyArrayPaginator.mjs

@@ -0,0 +1,2 @@
+import TinyArrayPaginator from '../libs/TinyArrayPaginator.mjs';
+export { TinyArrayPaginator };

package/dist/v1/build/TinyCookieConsent.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyCookieConsent = require('../libs/TinyCookieConsent.cjs');
+
+
+
+exports.TinyCookieConsent = TinyCookieConsent;

package/dist/v1/build/TinyCookieConsent.d.mts

@@ -0,0 +1,3 @@
+export { TinyCookieConsent };
+import TinyCookieConsent from '../libs/TinyCookieConsent.mjs';
+//# sourceMappingURL=TinyCookieConsent.d.mts.map

package/dist/v1/build/TinyCookieConsent.mjs

@@ -0,0 +1,2 @@
+import TinyCookieConsent from '../libs/TinyCookieConsent.mjs';
+export { TinyCookieConsent };

package/dist/v1/build/TinyDayNightCycle.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyDayNightCycle = require('../libs/TinyDayNightCycle.cjs');
+
+
+
+exports.TinyDayNightCycle = TinyDayNightCycle;

package/dist/v1/build/TinyDayNightCycle.d.mts

@@ -0,0 +1,3 @@
+export { TinyDayNightCycle };
+import TinyDayNightCycle from '../libs/TinyDayNightCycle.mjs';
+//# sourceMappingURL=TinyDayNightCycle.d.mts.map

package/dist/v1/build/TinyDayNightCycle.mjs

@@ -0,0 +1,2 @@
+import TinyDayNightCycle from '../libs/TinyDayNightCycle.mjs';
+export { TinyDayNightCycle };

package/dist/v1/build/TinyGamepad.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyGamepad = require('../libs/TinyGamepad.cjs');
+
+
+
+exports.TinyGamepad = TinyGamepad;

package/dist/v1/build/TinyGamepad.d.mts

@@ -0,0 +1,3 @@
+export { TinyGamepad };
+import TinyGamepad from '../libs/TinyGamepad.mjs';
+//# sourceMappingURL=TinyGamepad.d.mts.map

package/dist/v1/build/TinyGamepad.mjs

@@ -0,0 +1,2 @@
+import TinyGamepad from '../libs/TinyGamepad.mjs';
+export { TinyGamepad };

package/dist/v1/build/TinyI18.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyI18 = require('../libs/TinyI18.cjs');
+
+
+
+exports.TinyI18 = TinyI18;

package/dist/v1/build/TinyI18.d.mts

@@ -0,0 +1,3 @@
+export { TinyI18 };
+import TinyI18 from '../libs/TinyI18.mjs';
+//# sourceMappingURL=TinyI18.d.mts.map

package/dist/v1/build/TinyI18.mjs

@@ -0,0 +1,2 @@
+import TinyI18 from '../libs/TinyI18.mjs';
+export { TinyI18 };

package/dist/v1/build/TinyInventory.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyInventory = require('../libs/TinyInventory.cjs');
+
+
+
+exports.TinyInventory = TinyInventory;

package/dist/v1/build/TinyInventory.d.mts

@@ -0,0 +1,3 @@
+export { TinyInventory };
+import TinyInventory from '../libs/TinyInventory.mjs';
+//# sourceMappingURL=TinyInventory.d.mts.map

package/dist/v1/build/TinyInventory.mjs

@@ -0,0 +1,2 @@
+import TinyInventory from '../libs/TinyInventory.mjs';
+export { TinyInventory };

package/dist/v1/build/TinyInventoryTrader.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyInventoryTrader = require('../libs/TinyInventoryTrader.cjs');
+
+
+
+exports.TinyInventoryTrader = TinyInventoryTrader;

package/dist/v1/build/TinyInventoryTrader.d.mts

@@ -0,0 +1,3 @@
+export { TinyInventoryTrader };
+import TinyInventoryTrader from '../libs/TinyInventoryTrader.mjs';
+//# sourceMappingURL=TinyInventoryTrader.d.mts.map