@streamscloud/kit 0.60.0 → 0.61.0

package/dist/core/i18n/index.d.ts

@@ -1 +1 @@
-export { plural } from './plural';
+export { resolvePluralForm } from './resolve-plural-form';

package/dist/core/i18n/index.js

@@ -1 +1 @@
-export { plural } from './plural';
+export { resolvePluralForm } from './resolve-plural-form';

package/dist/core/i18n/resolve-plural-form.d.ts

@@ -0,0 +1,23 @@
+export type ResolvePluralFormOptions = {
+    count: number;
+    candidates: [string, ...string[]];
+    locale: string;
+};
+/**
+ * Picks the plural form matching `count` for `locale`.
+ *
+ * @param count - The number to pluralize
+ * @param candidates - One string per plural category `locale` distinguishes, in canonical CLDR order
+ *   (zero, one, two, few, many, other) filtered to that locale's categories — e.g. 2 entries for 'en'
+ *   (one, other), 4 for 'ru' (one, few, many, other). The caller (or its translation catalog) owns
+ *   supplying the right length and order for the given locale. In dev, a length mismatch against
+ *   `locale`'s actual category count throws instead of silently resolving the wrong form.
+ * @param locale - BCP 47 locale used to resolve the matching category via `Intl.PluralRules`.
+ *   Invalid locale tags silently fall back to the runtime default — validate the locale upstream.
+ * @returns The matching candidate with # replaced by count
+ *
+ * @example
+ * resolvePluralForm({ count: 1, candidates: ['# item', '# items'], locale: 'en' }) // "1 item"
+ * resolvePluralForm({ count: 5, candidates: ['# item', '# items'], locale: 'en' }) // "5 items"
+ */
+export declare const resolvePluralForm: ({ count, candidates, locale }: ResolvePluralFormOptions) => string;

package/dist/core/i18n/resolve-plural-form.js

@@ -0,0 +1,41 @@
+/**
+ * Picks the plural form matching `count` for `locale`.
+ *
+ * @param count - The number to pluralize
+ * @param candidates - One string per plural category `locale` distinguishes, in canonical CLDR order
+ *   (zero, one, two, few, many, other) filtered to that locale's categories — e.g. 2 entries for 'en'
+ *   (one, other), 4 for 'ru' (one, few, many, other). The caller (or its translation catalog) owns
+ *   supplying the right length and order for the given locale. In dev, a length mismatch against
+ *   `locale`'s actual category count throws instead of silently resolving the wrong form.
+ * @param locale - BCP 47 locale used to resolve the matching category via `Intl.PluralRules`.
+ *   Invalid locale tags silently fall back to the runtime default — validate the locale upstream.
+ * @returns The matching candidate with # replaced by count
+ *
+ * @example
+ * resolvePluralForm({ count: 1, candidates: ['# item', '# items'], locale: 'en' }) // "1 item"
+ * resolvePluralForm({ count: 5, candidates: ['# item', '# items'], locale: 'en' }) // "5 items"
+ */
+export const resolvePluralForm = ({ count, candidates, locale }) => {
+    const { index, categoriesLength } = indexerFor(locale);
+    if (import.meta.env?.DEV && candidates.length !== categoriesLength) {
+        throw new Error(`resolvePluralForm(): locale "${locale}" needs ${categoriesLength} candidate(s), got ${JSON.stringify(candidates)}.`);
+    }
+    const template = candidates[index(count)] ?? candidates[candidates.length - 1];
+    return template.replace(/#/g, String(count));
+};
+const PLURAL_CATEGORY_ORDER = ['zero', 'one', 'two', 'few', 'many', 'other'];
+const indexers = new Map();
+const indexerFor = (locale) => {
+    const cached = indexers.get(locale);
+    if (cached) {
+        return cached;
+    }
+    const rules = new Intl.PluralRules(locale);
+    const categories = rules
+        .resolvedOptions()
+        .pluralCategories.slice()
+        .sort((a, b) => PLURAL_CATEGORY_ORDER.indexOf(a) - PLURAL_CATEGORY_ORDER.indexOf(b));
+    const indexer = { index: (count) => categories.indexOf(rules.select(count)), categoriesLength: categories.length };
+    indexers.set(locale, indexer);
+    return indexer;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.60.0",
+  "version": "0.61.0",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",

package/dist/core/i18n/plural.d.ts

@@ -1,14 +0,0 @@
-/**
- * Plural function for wuchale i18n.
- * Wuchale extracts the candidates array and compiles locale-specific plural rules.
- *
- * @param count - The number to pluralize
- * @param candidates - Array of plural forms, e.g., ['One item', '# items']
- * @param rule - Optional plural rule function (injected by wuchale at compile time)
- * @returns The appropriate plural form with # replaced by count
- *
- * @example
- * plural(1, ['# item', '# items']) // "1 item"
- * plural(5, ['# item', '# items']) // "5 items"
- */
-export declare const plural: (count: number, candidates: string[], rule?: (n: number) => number) => string;

package/dist/core/i18n/plural.js

@@ -1,18 +0,0 @@
-/**
- * Plural function for wuchale i18n.
- * Wuchale extracts the candidates array and compiles locale-specific plural rules.
- *
- * @param count - The number to pluralize
- * @param candidates - Array of plural forms, e.g., ['One item', '# items']
- * @param rule - Optional plural rule function (injected by wuchale at compile time)
- * @returns The appropriate plural form with # replaced by count
- *
- * @example
- * plural(1, ['# item', '# items']) // "1 item"
- * plural(5, ['# item', '# items']) // "5 items"
- */
-export const plural = (count, candidates, rule = (n) => (n === 1 ? 0 : 1)) => {
-    const index = rule(count);
-    const template = candidates[index] ?? candidates[candidates.length - 1];
-    return template.replace(/#/g, String(count));
-};