@atlantjs/arch 15.6.5 → 15.6.7

package/{objects → src/objects}/amount/amount.edge.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AmountEdge = void 0;
-const convert_units_1 = require("../../@tool-box/utils/convert-units/convert-units");
-const guardian_1 = require("../../@tool-box/utils/type-guard/guardian");
-const amount_value_edge_1 = require("./amount-value.edge");
-const energy_unit_point_1 = require("./points/energy-unit.point");
-const length_unit_point_1 = require("./points/length-unit.point");
-const mass_unit_point_1 = require("./points/mass-unit.point");
-const volume_unit_point_1 = require("./points/volume-unit.point");
+const convert_units_1 = require("#/@tool-box/utils/convert-units/convert-units");
+const guardian_1 = require("#/@tool-box/utils/type-guard/guardian");
+const amount_value_edge_1 = require("#/objects/amount/amount-value.edge");
+const energy_unit_point_1 = require("#/objects/amount/points/energy-unit.point");
+const length_unit_point_1 = require("#/objects/amount/points/length-unit.point");
+const mass_unit_point_1 = require("#/objects/amount/points/mass-unit.point");
+const volume_unit_point_1 = require("#/objects/amount/points/volume-unit.point");
 class AmountEdge {
     constructor(_value, _unit) {
         this._value = _value;
@@ -19,68 +19,74 @@ class AmountEdge {
     get unit() {
         return this._unit;
     }
-    // ==================== Arredondamento e Precisão ====================
+    // ====================
+    // Rounding and Precision
+    // ====================
     /**
-     * Arredonda o valor para o inteiro mais próximo.
-     * @returns this para permitir encadeamento de métodos
+     * Rounds the value to the nearest integer.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(5.7, MassUnitPoint.gram);
-     * amount.round(); // valor agora é 6
+     * amount.round(); // value is now 6
      */
     round() {
         this._value = Math.round(this._value);
         return this;
     }
     /**
-     * Arredonda o valor para cima (sempre para o próximo inteiro maior).
-     * @returns this para permitir encadeamento de métodos
+     * Rounds the value up to the next highest integer.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(5.2, MassUnitPoint.gram);
-     * amount.ceil(); // valor agora é 6
+     * amount.ceil(); // value is now 6
      */
     ceil() {
         this._value = Math.ceil(this._value);
         return this;
     }
     /**
-     * Arredonda o valor para baixo (sempre para o próximo inteiro menor).
-     * @returns this para permitir encadeamento de métodos
+     * Rounds the value down to the next lowest integer.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(5.9, MassUnitPoint.gram);
-     * amount.floor(); // valor agora é 5
+     * amount.floor(); // value is now 5
      */
     floor() {
         this._value = Math.floor(this._value);
         return this;
     }
     /**
-     * Arredonda o valor com uma precisão decimal específica.
-     * @param precision - Número de casas decimais desejadas
-     * @returns this para permitir encadeamento de métodos
+     * Rounds the value to a specified number of decimal places.
+     * @param precision - The number of decimal places to keep.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(5.6789, MassUnitPoint.gram);
-     * amount.toFixed(2); // valor agora é 5.68
+     * amount.toFixed(2); // value is now 5.68
      */
     toFixed(precision) {
         this._value = Number(this._value.toFixed(precision));
         return this;
     }
     /**
-     * Retorna o valor absoluto (sem sinal).
-     * @returns this para permitir encadeamento de métodos
+     * Returns the absolute value (without sign).
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(-5.5, MassUnitPoint.gram);
-     * amount.abs(); // valor agora é 5.5
+     * amount.abs(); // value is now 5.5
      */
     abs() {
         this._value = Math.abs(this._value);
         return this;
     }
-    // ==================== Compactação de Unidades ====================
+    // ====================
+    // Unit Compaction
+    // ====================
     /**
-     * Compacta a quantidade para uma unidade mais apropriada baseado no valor.
-     * Por exemplo, 1000 gramas é convertido para 1 quilograma.
-     * @returns Nova instância com a unidade compactada
+     * Compacts the amount into a more appropriate unit based on its value.
+     * For example, 1000 grams is converted to 1 kilogram.
+     *
+     * @returns A new instance with the compacted unit.
+     *
      * @example
      * const amount = new AmountEdge(1500, MassUnitPoint.gram);
      * const compact = amount.compact(); // 1.5 kg
@@ -125,41 +131,43 @@ class AmountEdge {
         }
         return this;
     }
-    // ==================== Operações Aritméticas ====================
+    // ====================
+    // Arithmetic Operations
+    // ====================
     /**
-     * Soma outra quantidade ao valor atual.
-     * @param amount - Quantidade a ser somada
-     * @returns this para permitir encadeamento de métodos
+     * Adds another amount to the current value.
+     * @param amount - The amount to be added.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(3, MassUnitPoint.gram);
-     * amount1.sum(amount2); // valor agora é 8
+     * amount1.sum(amount2); // value is now 8
      */
     sum(amount) {
         this._value += amount.value;
         return this;
     }
     /**
-     * Subtrai outra quantidade do valor atual.
-     * @param amount - Quantidade a ser subtraída
-     * @returns this para permitir encadeamento de métodos
+     * Subtracts another amount from the current value.
+     * @param amount - The amount to be subtracted.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount1 = new AmountEdge(8, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(3, MassUnitPoint.gram);
-     * amount1.subtract(amount2); // valor agora é 5
+     * amount1.subtract(amount2); // value is now 5
      */
     subtract(amount) {
         this._value -= amount.value;
         return this;
     }
     /**
-     * Divide o valor por um número ou outra quantidade.
-     * @param amount - Divisor (número ou AmountEdge)
-     * @returns this para permitir encadeamento de métodos
+     * Divides the value by a number or another amount.
+     * @param amount - Divisor (number or AmountEdge)
+     * @returns `this` to allow method chaining
      * @example
      * const amount = new AmountEdge(10, MassUnitPoint.gram);
-     * amount.divideBy(2); // valor agora é 5
-     * amount.divideBy(new AmountEdge(2, MassUnitPoint.gram)); // valor agora é 2.5
+     * amount.divideBy(2); // value is now 5
+     * amount.divideBy(new AmountEdge(2, MassUnitPoint.gram)); // value is now 2.5
      */
     divideBy(amount) {
         if (typeof amount === "number") {
@@ -171,13 +179,13 @@ class AmountEdge {
         return this;
     }
     /**
-     * Multiplica o valor por um número ou outra quantidade.
-     * @param amount - Multiplicador (número ou AmountEdge)
-     * @returns this para permitir encadeamento de métodos
+     * Multiplies the value by a number or another amount.
+     * @param amount - Multiplier (number or AmountEdge)
+     * @returns `this` to allow method chaining
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
-     * amount.multiplyBy(2); // valor agora é 10
-     * amount.multiplyBy(new AmountEdge(3, MassUnitPoint.gram)); // valor agora é 30
+     * amount.multiplyBy(2); // value is now 10
+     * amount.multiplyBy(new AmountEdge(3, MassUnitPoint.gram)); // value is now 30
      */
     multiplyBy(amount) {
         if (typeof amount === "number") {
@@ -189,12 +197,12 @@ class AmountEdge {
         return this;
     }
     /**
-     * Calcula o resto da divisão (módulo) do valor atual.
-     * @param amount - Divisor (número ou AmountEdge)
-     * @returns this para permitir encadeamento de métodos
+     * Calculates the remainder (modulus) of the current value.
+     * @param amount - The divisor, either a number or an AmountEdge instance.
+     * @returns `this` to allow method chaining.
      * @example
      * const amount = new AmountEdge(10, MassUnitPoint.gram);
-     * amount.modBy(3); // valor agora é 1
+     * amount.modBy(3); // value is now 1
      */
     modBy(amount) {
         if (typeof amount === "number") {
@@ -206,9 +214,9 @@ class AmountEdge {
         return this;
     }
     /**
-     * Calcula a diferença absoluta entre esta quantidade e outra.
-     * @param amount - Quantidade para comparação
-     * @returns Nova instância com a diferença absoluta
+     * Calculates the absolute difference between this amount and another.
+     * @param amount - The amount to compare against
+     * @returns A new instance with the absolute difference
      * @example
      * const amount1 = new AmountEdge(10, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(3, MassUnitPoint.gram);
@@ -219,12 +227,12 @@ class AmountEdge {
         return new AmountEdge(diff, this._unit);
     }
     /**
-     * Aplica uma porcentagem sobre o valor atual.
-     * @param percentage - Porcentagem a aplicar (0-100)
-     * @returns this para permitir encadeamento de métodos
+     * Applies a percentage to the current value.
+     * @param percentage - The percentage to apply (0-100)
+     * @returns `this` to allow method chaining
      * @example
      * const amount = new AmountEdge(100, MassUnitPoint.gram);
-     * amount.applyPercentage(20); // valor agora é 120 (100 + 20%)
+     * amount.applyPercentage(20); // value is now 120 (100 + 20%)
      */
     applyPercentage(percentage) {
         const percentageValue = (this._value * percentage) / 100;
@@ -232,9 +240,14 @@ class AmountEdge {
         return this;
     }
     /**
-     * Calcula a porcentagem que esta quantidade representa de um total.
-     * @param total - Quantidade total
-     * @returns Porcentagem como número (0-100)
+     * Calculates the percentage that this amount represents of a total.
+     * @param total - The total amount
+     * @returns The percentage as a number (0-100)
+     * @example
+     * const amount = new AmountEdge(25, MassUnitPoint.gram);
+     * const total = new AmountEdge(100, MassUnitPoint.gram);
+     * const percentage = amount.percentageOf(total); // 25
+     * @returns The percentage as a number (0-100)
      * @example
      * const amount = new AmountEdge(25, MassUnitPoint.gram);
      * const total = new AmountEdge(100, MassUnitPoint.gram);
@@ -245,11 +258,13 @@ class AmountEdge {
             return 0;
         return (this._value / total.value) * 100;
     }
-    // ==================== Comparações ====================
+    // ====================
+    // Comparisons
+    // ====================
     /**
-     * Verifica se esta quantidade é igual a outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se as quantidades são iguais (valor e unidade), false caso contrário
+     * Checks whether this amount is equal to another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if both amounts have the same value and unit; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(5, MassUnitPoint.gram);
@@ -259,9 +274,9 @@ class AmountEdge {
         return (guardian_1._.isEqual(this._value, amount.value) && guardian_1._.isEqual(this._unit, amount.unit));
     }
     /**
-     * Verifica se esta quantidade é diferente de outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se as quantidades são diferentes, false caso contrário
+     * Checks whether this amount is different from another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if the amounts are different; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(3, MassUnitPoint.gram);
@@ -271,9 +286,9 @@ class AmountEdge {
         return !this.isEqual(amount);
     }
     /**
-     * Verifica se esta quantidade é maior que outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se this.value > amount.value, false caso contrário
+     * Checks whether this amount is greater than another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if this amount's value is greater than `amount`'s value; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(10, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(5, MassUnitPoint.gram);
@@ -283,9 +298,9 @@ class AmountEdge {
         return this._value > amount.value;
     }
     /**
-     * Verifica se esta quantidade é menor que outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se this.value < amount.value, false caso contrário
+     * Checks whether this amount is less than another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if this amount's value is less than `amount`'s value; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(3, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(5, MassUnitPoint.gram);
@@ -295,9 +310,9 @@ class AmountEdge {
         return this._value < amount.value;
     }
     /**
-     * Verifica se esta quantidade é maior ou igual a outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se this.value >= amount.value, false caso contrário
+     * Checks whether this amount is greater than or equal to another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if this amount's value is greater than or equal to `amount`'s value; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(5, MassUnitPoint.gram);
@@ -307,9 +322,9 @@ class AmountEdge {
         return this._value >= amount.value;
     }
     /**
-     * Verifica se esta quantidade é menor ou igual a outra.
-     * @param amount - Quantidade para comparação
-     * @returns true se this.value <= amount.value, false caso contrário
+     * Checks whether this amount is less than or equal to another amount.
+     * @param amount - The amount to compare against.
+     * @returns `true` if this amount's value is less than or equal to `amount`'s value; otherwise, `false`.
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = new AmountEdge(5, MassUnitPoint.gram);
@@ -319,10 +334,10 @@ class AmountEdge {
         return this._value <= amount.value;
     }
     /**
-     * Verifica se esta quantidade está entre dois limites (inclusive).
-     * @param min - Quantidade mínima
-     * @param max - Quantidade máxima
-     * @returns true se o valor está entre min e max, false caso contrário
+     * Checks whether this amount is between two bounds (inclusive).
+     * @param min - The minimum amount.
+     * @param max - The maximum amount.
+     * @returns `true` if the value is between min and max; otherwise, `false`.
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * const min = new AmountEdge(1, MassUnitPoint.gram);
@@ -332,10 +347,12 @@ class AmountEdge {
     isBetween(min, max) {
         return this.isGreaterThanOrEqual(min) && this.isLessThanOrEqual(max);
     }
-    // ==================== Validações ====================
+    // ====================
+    // Validations
+    // ====================
     /**
-     * Verifica se o valor é zero.
-     * @returns true se this.value === 0, false caso contrário
+     * Checks whether the value is zero.
+     * @returns `true` if this.value === 0, `false` otherwise
      * @example
      * const amount = new AmountEdge(0, MassUnitPoint.gram);
      * amount.isZero(); // true
@@ -344,8 +361,8 @@ class AmountEdge {
         return this._value === 0;
     }
     /**
-     * Verifica se o valor é positivo (maior que zero).
-     * @returns true se this.value > 0, false caso contrário
+     * Checks whether the value is positive (greater than zero).
+     * @returns `true` if this.value > 0, `false` otherwise
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * amount.isPositive(); // true
@@ -354,8 +371,8 @@ class AmountEdge {
         return this._value > 0;
     }
     /**
-     * Verifica se o valor é negativo (menor que zero).
-     * @returns true se this.value < 0, false caso contrário
+     * Checks whether the value is negative (less than zero).
+     * @returns `true` if this.value < 0, `false` otherwise
      * @example
      * const amount = new AmountEdge(-5, MassUnitPoint.gram);
      * amount.isNegative(); // true
@@ -364,9 +381,9 @@ class AmountEdge {
         return this._value < 0;
     }
     /**
-     * Verifica se a unidade é igual a uma unidade específica.
-     * @param unit - Unidade a comparar
-     * @returns true se a unidade é igual, false caso contrário
+     * Checks whether the amount has a specific unit.
+     * @param unit - The unit to compare against.
+     * @returns `true` if the unit matches; otherwise, `false`.
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * amount.hasUnit(MassUnitPoint.gram); // true
@@ -375,24 +392,28 @@ class AmountEdge {
     hasUnit(unit) {
         return guardian_1._.isEqual(this._unit, unit);
     }
-    // ==================== Clonagem e Imutabilidade ====================
+    // ====================
+    // Cloning and Immutability
+    // ====================
     /**
-     * Cria uma cópia independente desta quantidade.
-     * Útil para evitar mutações indesejadas.
-     * @returns Nova instância com os mesmos valores
+     * Creates an independent copy of this amount.
+     * Useful for avoiding unintended mutations.
+     *
+     * @returns A new instance with the same value and unit.
+     *
      * @example
      * const amount1 = new AmountEdge(5, MassUnitPoint.gram);
      * const amount2 = amount1.clone();
-     * amount2.multiplyBy(2); // amount1 continua 5, amount2 é 10
+     * amount2.multiplyBy(2); // amount1 remains 5, amount2 is 10
      */
     clone() {
         return new AmountEdge(this._value, this._unit);
     }
     /**
-     * Retorna uma nova instância com o valor alterado.
-     * Mantém a imutabilidade da instância original.
-     * @param value - Novo valor
-     * @returns Nova instância com o valor alterado
+     * Returns a new instance with the value changed.
+     * Maintains the immutability of the original instance.
+     * @param value - New value
+     * @returns New instance with the changed value
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * const newAmount = amount.withValue(10); // amount continua 5, newAmount é 10
@@ -401,10 +422,10 @@ class AmountEdge {
         return new AmountEdge(value, this._unit);
     }
     /**
-     * Retorna uma nova instância com a unidade alterada.
-     * Mantém a imutabilidade da instância original.
-     * @param unit - Nova unidade
-     * @returns Nova instância com a unidade alterada
+     * Returns a new instance with the unit changed.
+     * Maintains the immutability of the original instance.
+     * @param unit - New unit
+     * @returns New instance with the changed unit
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * const newAmount = amount.withUnit(MassUnitPoint.kilogram);
@@ -412,10 +433,12 @@ class AmountEdge {
     withUnit(unit) {
         return new AmountEdge(this._value, unit);
     }
-    // ==================== Formatação ====================
+    // ====================
+    // Formatting
+    // ====================
     /**
-     * Retorna uma representação em string da quantidade.
-     * @returns String no formato "valor unidade"
+     * Returns a string representation of the amount.
+     * @returns A string in the format "value unit".
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * amount.toString(); // "5 g"
@@ -424,10 +447,10 @@ class AmountEdge {
         return `${this._value.toString()} ${this._unit}`;
     }
     /**
-     * Formata a quantidade como string com separador de milhar e precisão decimal.
-     * @param locale - Localização para formatação (ex: 'en-US', 'pt-BR')
-     * @param precision - Número de casas decimais
-     * @returns String formatada
+     * Formats the amount as a string with a thousands separator and decimal precision.
+     * @param locale - Locale for formatting (e.g., 'en-US', 'pt-BR')
+     * @param precision - NNumber of decimal places
+     * @returns Formatted string
      * @example
      * const amount = new AmountEdge(1234.5678, MassUnitPoint.gram);
      * amount.toFormattedString('pt-BR', 2); // "1.234,57 g"
@@ -440,9 +463,9 @@ class AmountEdge {
         return `${formatted} ${this._unit}`;
     }
     /**
-     * Retorna apenas o valor como string com precisão específica.
-     * @param precision - Número de casas decimais
-     * @returns String do valor formatado
+     * Returns only the value as a string with specific precision.
+     * @param precision - NNumber of decimal places
+     * @returns Formatted value string
      * @example
      * const amount = new AmountEdge(5.6789, MassUnitPoint.gram);
      * amount.toValueString(2); // "5.68"
@@ -450,11 +473,13 @@ class AmountEdge {
     toValueString(precision = 2) {
         return this._value.toFixed(precision);
     }
-    // ==================== Conversão ====================
+    // ====================
+    // Conversion
+    // ====================
     /**
-     * Converte a quantidade para um objeto Polygon.
-     * @param precision - Número de casas decimais
-     * @returns Objeto polygon com valor e unidade
+     * Converts the amount to a Polygon object.
+     * @param precision - The number of decimal places to retain.
+     * @returns A Polygon object containing the value and unit.
      * @example
      * const amount = new AmountEdge(5.6789, MassUnitPoint.gram);
      * amount.toPolygon(2); // { value: 5.68, unit: MassUnitPoint.gram }
@@ -468,8 +493,8 @@ class AmountEdge {
         };
     }
     /**
-     * Converte a quantidade para um objeto JSON.
-     * @returns Objeto JSON com value e unit
+     * Converts the amount to a JSON object.
+     * @returns JSON object with value and unit
      * @example
      * const amount = new AmountEdge(5, MassUnitPoint.gram);
      * amount.toJSON(); // { value: 5, unit: "g" }
@@ -480,12 +505,14 @@ class AmountEdge {
             unit: this._unit,
         };
     }
-    // ==================== Métodos Estáticos ====================
+    // ====================
+    // Static Methods
+    // ====================
     /**
-     * Cria uma nova quantidade com valor zero.
-     * @template T - Tipo da unidade
-     * @param unit - Unidade da quantidade
-     * @returns Nova instância com valor zero
+     * Creates a new amount with a value of zero.
+     * @template T - The unit type.
+     * @param unit - The unit of the amount.
+     * @returns A new instance with a value of zero.
      * @example
      * const zero = AmountEdge.zero(MassUnitPoint.gram); // 0 g
      */
@@ -493,10 +520,10 @@ class AmountEdge {
         return new AmountEdge(0, unit);
     }
     /**
-     * Soma uma lista de quantidades.
-     * @template T - Tipo da unidade
-     * @param amounts - Array de quantidades a somar
-     * @returns Nova instância com a soma total
+     * Sums a list of amounts.
+     * @template T - The unit type.
+     * @param amounts - An array of amounts to sum.
+     * @returns A new instance containing the total sum.
      * @example
      * const amounts = [
      *   new AmountEdge(5, MassUnitPoint.gram),
@@ -516,10 +543,10 @@ class AmountEdge {
         return total;
     }
     /**
-     * Retorna a quantidade máxima de uma lista.
-     * @template T - Tipo da unidade
-     * @param amounts - Array de quantidades
-     * @returns Nova instância com o maior valor
+     * Returns the maximum amount from a list.
+     * @template T - The unit type.
+     * @param amounts - n array of amounts.
+     * @returns A new instance with the maximum value.
      * @example
      * const amounts = [
      *   new AmountEdge(5, MassUnitPoint.gram),
@@ -541,10 +568,10 @@ class AmountEdge {
         return maxAmount;
     }
     /**
-     * Retorna a quantidade mínima de uma lista.
-     * @template T - Tipo da unidade
-     * @param amounts - Array de quantidades
-     * @returns Nova instância com o menor valor
+     * Returns the minimum amount from a list.
+     * @template T - The unit type.
+     * @param amounts - An array of amounts.
+     * @returns A new instance containing the smallest value.
      * @example
      * const amounts = [
      *   new AmountEdge(5, MassUnitPoint.gram),
@@ -566,10 +593,10 @@ class AmountEdge {
         return minAmount;
     }
     /**
-     * Calcula a média de uma lista de quantidades.
-     * @template T - Tipo da unidade
-     * @param amounts - Array de quantidades
-     * @returns Nova instância com a média dos valores
+     * Calculates the average of a list of amounts.
+     * @template T - The unit type.
+     * @param amounts - n array of amounts.
+     * @returns A new instance with the average value.
      * @example
      * const amounts = [
      *   new AmountEdge(10, MassUnitPoint.gram),
@@ -584,10 +611,10 @@ class AmountEdge {
         return total;
     }
     /**
-     * Cria uma quantidade a partir de um objeto Polygon.
-     * @template T - Tipo da unidade
-     * @param polygon - Objeto polygon com value e unit
-     * @returns Nova instância de AmountEdge
+     * Creates an amount from a Polygon object.
+     * @template T - The unit type.
+     * @param polygon - A Polygon object containing `value` and `unit`.
+     * @returns A new AmountEdge instance.
      * @example
      * const polygon = { value: 5, unit: MassUnitPoint.gram };
      * const amount = AmountEdge.fromPolygon(polygon); // 5 g

package/{objects → src/objects}/amount/amount.polygon.d.ts

@@ -2,3 +2,4 @@ export interface AmountPolygon<UnitsPoint> {
     value: number;
     unit: UnitsPoint;
 }
+//# sourceMappingURL=amount.polygon.d.ts.map

package/src/objects/amount/amount.polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.polygon.d.ts","sourceRoot":"","sources":["../../../../src/objects/amount/amount.polygon.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa,CAAC,UAAU;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;CACjB"}