@temboplus/frontend-core 1.0.1-beta.3 → 1.0.1

package/dist/domain/amount/amount.d.ts

@@ -316,6 +316,21 @@ declare class Amount {
      * ```
      */
     percentage(percentage: number): Amount;
+    /**
+     * Returns this amount as a percentage of another amount or numeric value.
+     *
+     * @param other - Amount object or number to use as the denominator
+     * @returns Percentage value as a number
+     * @throws {Error} If currencies don't match when comparing Amount objects
+     * @throws {Error} If the denominator is zero
+     *
+     * @example
+     * ```typescript
+     * Amount.from(25).asPercentageOf(Amount.from(100)); // 25
+     * Amount.from(50).asPercentageOf(200);              // 25
+     * ```
+     */
+    asPercentageOf(other: Amount | number): number;
     /**
      * Checks if this amount is zero
      *

package/dist/domain/amount/amount.helpers.d.ts

@@ -1,5 +1,6 @@
 import type { Currency } from "../currency/currency.js";
 import type { CurrencyCode } from "../currency/currency.types.js";
+import type { Amount } from "./amount.js";
 /**
  * Formatting options for the enhanced format method.
  */
@@ -52,13 +53,25 @@ declare function formatAmountText(value: number, currency: Currency): string;
 declare function formatAmountWithIntl(value: number, currency: Currency, options: AmountFormatOptions): string;
 declare function formatAmountManually(value: number, currency: Currency, options: AmountFormatOptions): string;
 declare function formatCompactAmount(value: number, currency: Currency, precision?: number, options?: AmountCompactFormatOptions): string;
+/** Sum of every Amount, requiring a non-empty array with matching currencies. */
+declare function sum(amounts: Amount[]): Amount;
+/** Mean of every Amount, requiring a non-empty array with matching currencies. */
+declare function average(amounts: Amount[]): Amount;
+/** Smallest Amount in the array. */
+declare function min(amounts: Amount[]): Amount;
+/** Largest Amount in the array. */
+declare function max(amounts: Amount[]): Amount;
 export declare const AmountHelpers: {
     AMOUNT_REGEX: RegExp;
+    average: typeof average;
     containsForbiddenCurrencySymbol: typeof containsForbiddenCurrencySymbol;
     formatAmountText: typeof formatAmountText;
     formatAmountManually: typeof formatAmountManually;
     formatAmountWithIntl: typeof formatAmountWithIntl;
     formatCompactAmount: typeof formatCompactAmount;
+    max: typeof max;
+    min: typeof min;
     parseCurrencyAmountInput: typeof parseCurrencyAmountInput;
+    sum: typeof sum;
 };
 export {};

package/dist/factories/amount.factory.d.ts

@@ -2,7 +2,7 @@ import { Amount } from "@domain/amount/amount.js";
 import { type AmountJSON } from "@domain/amount/amount.schema.js";
 import type { CurrencyCode } from "@domain/currency/currency.types.js";
 /**
- * Owns Amount construction, parsing, validation, and aggregate operations.
+ * Owns Amount construction, parsing, and validation.
  * Resolves currencies through CurrencyRegistry; never owns currency data itself.
  */
 export declare class AmountFactory {
@@ -35,14 +35,6 @@ export declare class AmountFactory {
     isAmountJSON(obj: unknown): obj is AmountJSON;
     /** Verifies that an Amount instance can still be reconstructed cleanly. */
     validate(amount: Amount): boolean;
-    /** Sum of every Amount, requiring matching currencies. */
-    sum(amounts: Amount[]): Amount;
-    /** Mean of every Amount, requiring matching currencies and non-empty array. */
-    average(amounts: Amount[]): Amount;
-    /** Smallest Amount in the array (most negative wins). */
-    min(amounts: Amount[]): Amount;
-    /** Largest Amount in the array. */
-    max(amounts: Amount[]): Amount;
     /** Builds an Amount by validating a numeric string and currency code. */
     private createFromString;
     /** Resolves a (possibly mixed-case) currency code to its canonical form. */