@formatjs/intl-pluralrules 6.3.12 → 6.3.14

package/index.d.ts

@@ -1,5 +1,4 @@
 import { Decimal } from "@formatjs/bigdecimal";
-
 //#region packages/ecma402-abstract/types/core.d.ts
 type Locale = string;
 interface LocaleData<T> {
@@ -13,7 +12,9 @@ interface PluralRangesData {
   cardinal?: Record<string, LDMLPluralRule>;
   ordinal?: Record<string, LDMLPluralRule>;
 }
+type CompactExponentData = Record<"short" | "long", Record<number, number>>;
 interface PluralRulesData {
+  compactExponents?: CompactExponentData;
   categories: {
     cardinal: string[];
     ordinal: string[];
@@ -45,71 +46,71 @@ type TrailingZeroDisplay = "auto" | "stripIfInteger";
 //#endregion
 //#region packages/intl-pluralrules/index.d.ts
 /**
-* Type augmentation for Intl.PluralRules
-*
-* ECMA-402 Spec: selectRange method (Intl.PluralRules.prototype.selectRange)
-* https://tc39.es/ecma402/#sec-intl.pluralrules.prototype.selectrange
-*
-* Extension: notation and compactDisplay options (not in ECMA-402 spec)
-* Mirrors Intl.NumberFormat notation option for proper plural selection with compact numbers
-*/
+ * Type augmentation for Intl.PluralRules
+ *
+ * ECMA-402 Spec: selectRange method (Intl.PluralRules.prototype.selectRange)
+ * https://tc39.es/ecma402/#sec-intl.pluralrules.prototype.selectrange
+ *
+ * ECMA-402 notation and compactDisplay options
+ * Mirrors Intl.NumberFormat notation option for proper plural selection with compact numbers
+ */
 declare global {
   namespace Intl {
     interface PluralRules {
       selectRange(start: number | bigint, end: number | bigint): LDMLPluralRule;
     }
     interface PluralRulesOptions {
-      notation?: "standard" | "compact";
+      notation?: "standard" | "scientific" | "engineering" | "compact";
       compactDisplay?: "short" | "long";
     }
   }
 }
-interface PluralRulesInternal extends NumberFormatDigitInternalSlots {
+export interface PluralRulesInternal extends NumberFormatDigitInternalSlots {
   initializedPluralRules: boolean;
   locale: string;
   type: "cardinal" | "ordinal";
-  notation: "standard" | "compact";
+  notation: "standard" | "scientific" | "engineering" | "compact";
   compactDisplay?: "short" | "long";
-  dataLocaleData?: any;
+  compactExponents?: CompactExponentData;
 }
-declare class PluralRules {
+export declare class PluralRules {
   constructor(locales?: string | string[], options?: Intl.PluralRulesOptions);
   resolvedOptions(): Intl.ResolvedPluralRulesOptions;
   select(val: number | bigint): LDMLPluralRule;
   /**
-  * Intl.PluralRules.prototype.selectRange ( start, end )
-  *
-  * Returns a string indicating which plural rule applies to a range of numbers.
-  * This is useful for formatting ranges like "1-2 items" vs "2-3 items" where
-  * different languages have different plural rules for ranges.
-  *
-  * Specification: https://tc39.es/ecma402/#sec-intl.pluralrules.prototype.selectrange
-  *
-  * @param start - The start value of the range (number or bigint)
-  * @param end - The end value of the range (number or bigint)
-  * @returns The plural category for the range (zero, one, two, few, many, or other)
-  *
-  * @example
-  * const pr = new Intl.PluralRules('en');
-  * pr.selectRange(1, 2); // "other" (English: "1-2 items")
-  * pr.selectRange(1, 1); // "one" (same value: "1 item")
-  *
-  * @example
-  * const prFr = new Intl.PluralRules('fr');
-  * prFr.selectRange(0, 1); // "one" (French: "0-1 vue")
-  * prFr.selectRange(1, 2); // "other" (French: "1-2 vues")
-  *
-  * @example
-  * // BigInt support (spec-compliant, but Chrome has a bug as of early 2025)
-  * pr.selectRange(BigInt(1), BigInt(2)); // "other"
-  *
-  * @throws {TypeError} If start or end is undefined
-  * @throws {RangeError} If start or end is not a finite number (Infinity, NaN)
-  *
-  * @note Chrome's native implementation (as of early 2025) has a bug where it throws
-  * "Cannot convert a BigInt value to a number" when using BigInt arguments. This is
-  * a browser bug - the spec requires BigInt support. This polyfill handles BigInt correctly.
-  */
+   * Intl.PluralRules.prototype.selectRange ( start, end )
+   *
+   * Returns a string indicating which plural rule applies to a range of numbers.
+   * This is useful for formatting ranges like "1-2 items" vs "2-3 items" where
+   * different languages have different plural rules for ranges.
+   *
+   * Specification: https://tc39.es/ecma402/#sec-intl.pluralrules.prototype.selectrange
+   *
+   * @param start - The start value of the range (number or bigint)
+   * @param end - The end value of the range (number or bigint)
+   * @returns The plural category for the range (zero, one, two, few, many, or other)
+   *
+   * @example
+   * const pr = new Intl.PluralRules('en');
+   * pr.selectRange(1, 2); // "other" (English: "1-2 items")
+   * pr.selectRange(1, 1); // "one" (same value: "1 item")
+   *
+   * @example
+   * const prFr = new Intl.PluralRules('fr');
+   * prFr.selectRange(0, 1); // "one" (French: "0-1 vue")
+   * prFr.selectRange(1, 2); // "other" (French: "1-2 vues")
+   *
+   * @example
+   * // BigInt support (spec-compliant, but Chrome has a bug as of early 2025)
+   * pr.selectRange(BigInt(1), BigInt(2)); // "other"
+   *
+   * @throws {TypeError} If start or end is undefined
+   * @throws {RangeError} If start or end converts to NaN
+   *
+   * @note Chrome's native implementation (as of early 2025) has a bug where it throws
+   * "Cannot convert a BigInt value to a number" when using BigInt arguments. This is
+   * a browser bug - the spec requires BigInt support. This polyfill handles BigInt correctly.
+   */
   selectRange(start: number | bigint, end: number | bigint): LDMLPluralRule;
   toString(): string;
   static supportedLocalesOf(locales?: string | string[], options?: Pick<Intl.PluralRulesOptions, "localeMatcher">): string[];
@@ -122,5 +123,4 @@ declare class PluralRules {
   static polyfilled: boolean;
 }
 //#endregion
-export { PluralRules, PluralRulesInternal };
 //# sourceMappingURL=index.d.ts.map