@flyos/design-system 2.4.0 → 2.5.0

package/fesm2022/flyos-design-system.mjs

@@ -47,7 +47,7 @@ import { CdkConnectedOverlay, CdkOverlayOrigin } from '@angular/cdk/overlay';
 // tools/publish-library.ps1 at bump time, and asserted by the spec beside this file.
 // Used only for the diagnostic message; the duplicate-instance detection itself is
 // version-agnostic, so a stale literal misnames a fork rather than hiding one.
-const FLY_DS_VERSION = '2.4.0';
+const FLY_DS_VERSION = '2.5.0';
 const FLY_DS_REGISTRY_KEY = '__FLY_DS_INSTANCES__';
 /**
  * Records this design-system instance on the shared `scope` and returns the
@@ -19602,6 +19602,8 @@ function currencyFormatter(locale, code, digits) {
             currencyDisplay: 'code',
             minimumFractionDigits: digits,
             maximumFractionDigits: digits,
+            // See TRAILING_ZERO_OPTION — "AED 620,000.00" reads as noise; "AED 620,000" is the figure.
+            ...TRAILING_ZERO_OPTION,
         });
         moneyFormatterCache.set(key, f);
         return f;
@@ -19610,12 +19612,34 @@ function currencyFormatter(locale, code, digits) {
         return null;
     }
 }
+/**
+ * Drop the decimal part when it carries no value: `620000.00` renders `620,000`, while
+ * `620000.50` still renders `620,000.50`.
+ *
+ * <b>`stripIfInteger`, NOT `minimumFractionDigits: 0`.</b> The latter also strips the trailing zero
+ * INSIDE the decimals (`620,000.5`), which is wrong for money — a partial amount conventionally
+ * shows the currency's full minor units. This option strips all-or-nothing, which is the intent:
+ * the decimals either mean something or they do not.
+ *
+ * `maximumFractionDigits` is still the currency's own `decimalDigits`, so 3-decimal dinars and
+ * 0-decimal yen are unaffected in the cases that matter — this only removes a run of zeros a reader
+ * gains nothing from.
+ *
+ * Spread rather than set inline because `trailingZeroDisplay` is a newer Intl option than the
+ * TypeScript DOM lib in this workspace declares; the cast is contained to this one constant instead
+ * of every formatter construction.
+ */
+const TRAILING_ZERO_OPTION = { trailingZeroDisplay: 'stripIfInteger' };
 const plainDecimalCache = new Map();
 function plainDecimalFormatter(locale, digits) {
     const key = `${locale}|${digits}`;
     let f = plainDecimalCache.get(key);
     if (!f) {
-        f = new Intl.NumberFormat(locale, { minimumFractionDigits: digits, maximumFractionDigits: digits });
+        f = new Intl.NumberFormat(locale, {
+            minimumFractionDigits: digits,
+            maximumFractionDigits: digits,
+            ...TRAILING_ZERO_OPTION,
+        });
         plainDecimalCache.set(key, f);
     }
     return f;
@@ -19632,7 +19656,8 @@ function manualFormat(amount, meta, display, locale) {
  * ```ts
  * flyFormatMoney(1234.5, kwdRow)                          // "د.ك 1,234.500" (KWD is 3-decimal)
  * flyFormatMoney(1234, 'JPY')                              // "JPY 1,234"     (bare code, no symbol to read — degrades to the code)
- * flyFormatMoney(-42, usdRow, { display: 'code' })         // "-USD 42.00"
+ * flyFormatMoney(-42, usdRow, { display: 'code' })         // "-USD 42"       (whole amount — see TRAILING_ZERO_OPTION)
+ * flyFormatMoney(-42.5, usdRow, { display: 'code' })       // "-USD 42.50"    (partial amount keeps its minor units)
  * flyFormatMoney(99.9, eurRow, { display: 'none' })        // "99.90"         (currency named elsewhere on screen)
  * flyFormatMoney(null, usdRow)                             // "—"             (never "NaN")
  * ```