saykit 0.7.0 → 0.8.0

package/README.md

@@ -31,7 +31,7 @@ const say = new Say({
 say.activate('en');
 
 say`Hello, ${name}!`;
-say.plural(count, { one: '1 item', other: '# items' });
+say.plural(count, { one: '1 item', other: `${count} items` });
 ```
 
 ## Documentation

package/dist/runtime.d.mts

@@ -11,18 +11,25 @@ type Awaitable<T> = T | PromiseLike<T>;
 type Named<T> = {
   [name: string]: T;
 };
-interface NumeralOptions extends Omit<Partial<Record<Intl.LDMLPluralRule, string>>, 'other'> {
-  other: string;
-  [digit: number]: string;
+/**
+ * Branches of a choice, keyed by CLDR category or by exact number.
+ *
+ * `Branch` is what a case may be written as. It is text everywhere the message
+ * is text, and widens in JSX, where a case that shows the number has to be a
+ * fragment — a string attribute has nowhere to put a value.
+ */
+interface NumeralOptions<Branch = string> extends Omit<Partial<Record<Intl.LDMLPluralRule, Branch>>, 'other'> {
+  other: Branch;
+  [digit: number]: Branch;
   /**
    * Subtracted from the value before `#` is formatted, so "You and 2 others"
    * can select on a total of three. Reserved — it never names a branch.
    */
   offset?: number;
 }
-interface SelectOptions {
-  other: string;
-  [match: string | number]: string;
+interface SelectOptions<Branch = string> {
+  other: Branch;
+  [match: string | number]: Branch;
 }
 /**
  * Formatting for a `{arg, number}` placeholder.
@@ -188,11 +195,12 @@ declare class Say<Locale extends string = string, Loader extends Say.Loader<Loca
    * ```ts
    * say.plural(count, {
    *   one: 'You have 1 item',
-   *   other: 'You have # items',
+   *   other: `You have ${count} items`,
    * })
    * ```
    *
-   * The `#` symbol inside options is replaced with the numeric value.
+   * Interpolating the selector into a branch extracts as ICU's `#`, the number
+   * the message branched on. A `#` you write yourself is text.
    * @param _ Number to determine the plural form of
    * @param options Pluralisation rules keyed by CLDR categories or specific numbers
    * @returns The plural form of the number
@@ -201,15 +209,17 @@ declare class Say<Locale extends string = string, Loader extends Say.Loader<Loca
   plural(_: number | Named<number>, options: Disallow<NumeralOptions, 'id' | 'context'>): string;
   /**
    * Define an ordinal message (e.g. "1st", "2nd", "3rd").
-   * The `#` symbol inside options is replaced with the numeric value.
+   *
+   * Interpolating the selector into a branch extracts as ICU's `#`, the number
+   * the message branched on. A `#` you write yourself is text.
    *
    * @example
    * ```ts
    * say.ordinal(position, {
-   *   1: '#st',
-   *   2: '#nd',
-   *   3: '#rd',
-   *   other: '#th',
+   *   1: `${position}st`,
+   *   2: `${position}nd`,
+   *   3: `${position}rd`,
+   *   other: `${position}th`,
    * })
    * ```
    *

package/dist/runtime.mjs

@@ -203,11 +203,12 @@ var Say = class Say {
 	* ```ts
 	* say.plural(count, {
 	*   one: 'You have 1 item',
-	*   other: 'You have # items',
+	*   other: `You have ${count} items`,
 	* })
 	* ```
 	*
-	* The `#` symbol inside options is replaced with the numeric value.
+	* Interpolating the selector into a branch extracts as ICU's `#`, the number
+	* the message branched on. A `#` you write yourself is text.
 	* @param _ Number to determine the plural form of
 	* @param options Pluralisation rules keyed by CLDR categories or specific numbers
 	* @returns The plural form of the number
@@ -218,15 +219,17 @@ var Say = class Say {
 	}
 	/**
 	* Define an ordinal message (e.g. "1st", "2nd", "3rd").
-	* The `#` symbol inside options is replaced with the numeric value.
+	*
+	* Interpolating the selector into a branch extracts as ICU's `#`, the number
+	* the message branched on. A `#` you write yourself is text.
 	*
 	* @example
 	* ```ts
 	* say.ordinal(position, {
-	*   1: '#st',
-	*   2: '#nd',
-	*   3: '#rd',
-	*   other: '#th',
+	*   1: `${position}st`,
+	*   2: `${position}nd`,
+	*   3: `${position}rd`,
+	*   other: `${position}th`,
 	* })
 	* ```
 	*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saykit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Type-safe i18n library with compile-time macro transforms",
   "keywords": [
     "i18n",