@kemdict/gettext 0.1.0

package/LICENSE

@@ -0,0 +1,16 @@
+Copyright (c) 2011-2012 Andris Reinman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# @kemdict/gettext
+
+A fork of [node-gettext](https://github.com/alexanderwallin/node-gettext). The hope is to add more stuff to the runtime behavior of node-gettext, as well as add extraction features.
+
+The main use is for [Kemdict](https://github.com/kemdict/kemdict).
+
+The design of not directly depending on gettext-parser will be kept.
+
+## Stability
+
+I do not commit to any backwards compatibility whatsoever at this early stage.
+
+---
+
+## Features
+
+- Supports contexts and plurals
+- Load translations in the format returned by [gettext-parser](https://github.com/smhg/gettext-parser), so .json, .mo, and .po files can all be loaded
+- Use plural forms from the PO file, with fallback for many languages
+  - Safe by default (there is effectively an allowlist of `plurals=` expressions), if more complicated expressions are needed and you trust the PO files then use trusted mode.
+
+### Comparison with GNU gettext and node-gettext
+
+(This is modified from node-gettext's explanation.)
+
+1. **There is no global locale, nor is the current locale a state of the class.** When the Gettext instance itself holds the current locale and is used asynchronously (like on a server handling requests), [a request may set the locale to something else before another one has finished using it](https://github.com/alexanderwallin/node-gettext/issues/67). This library instead binds the “current” locale per set of translation functions.
+
+   To infer the current locale from environment variables, use the `guessEnvLocale` function, which should read the LANG etc. variables basically just like GNU gettext does.
+
+2. **There are no categories.** GNU gettext features [categories such as `LC_MESSAGES`, `LC_NUMERIC` and `LC_MONETARY`](https://www.gnu.org/software/gettext/manual/gettext.html#Locale-Environment-Variables), which are better handled with other libraries in the JS world. This is just like node-gettext.
+3. **There are no domains.** Like [Python's gettext](https://docs.python.org/3/library/gettext.html), this library takes a class-based approach, so if you need multiple sets of translations simply use multiple instances of the `Gettext` class. node-gettext retains domains.
+4. **Translations have to be loaded from the file system in a separate step.**
+
+   GNU gettext is a C library that reads files from the file system: after using `bindtextdomain(domain, localesDirPath)` and `setlocale(category, locale)`, those four parameters are then used to read the appropriate translations file.
+
+   This library (like `node-gettext`) has a goal to work both on the server and in browsers, and the file system may not always be available. Therefore it is up to the developer to read translation files from disk and provide them in the constructor.
+
+   Various loaders are also provided as wrappers over `gettext-parser`; see below. In environments supporting Rollup plugins, use rollup-plugin-gettext (also developed in this repository) to import and bundle translation data.
+
+## Installation
+
+TODO. This package is not yet published; the name isn't even final yet (I'm not sure I actually want to publish this as @kemdict/gettext).
+
+## Usage
+
+```js
+import Gettext from '@kemdict/gettext'
+import swedishTranslations from './translations/sv-SE.json'
+
+const gt = new Gettext({
+  translations: {
+    'sv-SE': swedishTranslations
+  }
+})
+const { gettext } = gt.bindLocale('sv-SE')
+
+gettext('The world is a funny place')
+// -> "Världen är en underlig plats"
+```
+
+### Recipes
+
+#### Load and add translations from .mo or .po files
+
+`@kemdict/gettext` expects translations to be in the format specified by [`gettext-parser`](https://github.com/smhg/gettext-parser). We also provide various loaders to conveniently read translation files on disk.
+
+```js
+import Gettext from '@kemdict/gettext'
+import { loadTranslations } from '@kemdict/gettext/loaders'
+const gt = new Gettext({
+  // this reads and parses all .po files under path/to/locales
+  // their filenames are the locale names ('de.po' creates an entry for 'de')
+  translations: loadTranslations('path/to/locales')
+})
+```
+
+## Reference
+
+### "@kemdict/gettext"
+
+#### guessEnvLocale(env) → string[]
+
+Guess or lookup the preferred language list from environment variables.
+
+`env` defaults to `process.env`.
+
+#### class Gettext({ sourceLocale, translations, trusted })
+
+The main class. This class holds the loaded translation catalogs.
+
+`sourceLocale` specifies which locale source text is written in. I am not sure this is necessary or useful.
+
+`translations` is in the shape of `Record<string, GetTextTranslations>` where `GetTextTranslations` is the return type of `gettext-parser`'s parsers.
+
+`trusted` specifies whether the PO file is trusted to be safe. By default the Plural-Forms expression is matched against a lookup table; with `trusted` as true the Plural-Forms expression will be directly used to create a JS function.
+
+##### gettext.getLocales() → string[]
+
+Return the list of locales that are in this gettext instance's catalog.
+
+##### gettext.bindLocale(locales) → Translators
+
+Return an object of translator functions that will translate as if `locales` is the “current” locale.
+
+#### Translators
+
+This object actually doesn't have a name in code but I'm abstracting them like this here.
+
+This is an object of functions which can all be used standalone without needing to `.bind(this)`.
+
+##### Translators.gettext(msgid), _(msgid)
+
+Translate a string like gettext.
+
+##### Translators.ngettext(msgid, msgidPlural, count)
+
+Translate a string with plural handling like ngettext.
+
+##### Translators.pgettext(msgctxt, msgid)
+
+Translate a string with context like pgettext.
+
+##### Translators.npgettext(msgctxt, msgid, msgidPlural, count)
+
+Translate a string with context and plural handling like npgettext.
+
+### Loaders ("@kemdict/gettext/loaders.js")
+
+#### bindtextdomain(domain, ...localesDirs) → Record<string, GetTextTranslations>
+
+Load MO files from the directories `localesDirs`. These directories should be arranged like /usr/share/locale, i.e. `<locale>/LC_MESSAGES/<domain>.mo`.
+
+Loading translations from [Elisa](http://apps.kde.org/elisa) if it's installed for example:
+
+```typescript
+import Gettext, { guessEnvLocale } from "@kemdict/gettext";
+import { bindtextdomain } from "@kemdict/gettext/loaders";
+const gt = new Gettext({
+  translations: bindtextdomain("elisa", "/usr/share/locale/"),
+});
+const { pgettext } = gt.bindLocale(guessEnvLocale());
+pgettext("@title:window", "Choose Folder") // 選擇資料夾 in zh_TW
+```
+
+#### loadTranslations(dir) → Record<string, GetTextTranslations>
+
+Load PO files from `dir`. `dir` should contain one PO file for each locale, like `<dir>/zh_TW.po`, `<dir>/de.po`, `<dir>/sv.po`, and so on.
+
+## License
+
+MIT
+
+## See also
+
+- [node-gettext](https://github.com/alexanderwallin/node-gettext) - where this library forked from, because I have way too many major changes that I want to implement
+- [gettext-parser](https://github.com/smhg/gettext-parser) - Parsing and compiling gettext translations between .po/.mo files and JSON
+- [lioness](https://github.com/alexanderwallin/lioness) - Gettext library for React
+- [react-gettext-parser](https://github.com/laget-se/react-gettext-parser) - Extracting gettext translatable strings from JS(X) code

package/lib/gettext.js

@@ -0,0 +1,233 @@
+import { parsePluralForms, fallbackPluralForms } from "./plurals.js";
+
+/**
+ * Guess or lookup the preferred language list from environment variables.
+ * @param {Record<string, string | undefined>} env
+ *   A map of environment variables. Defaults to process.env.
+ * @returns string[] | undefined
+ */
+export function guessEnvLocale(env = process?.env) {
+    if (!env) return;
+    // If $LANG is C, C.<encoding>, or POSIX: return msgid untranslated.
+    // Prefer LANGUAGE, then LC_ALL, then LC_MESSAGES, then LANG.
+    const LANG = env["LANG"];
+    if (LANG && (LANG === "C" || LANG.startsWith("C.") || LANG === "POSIX")) {
+        return;
+    }
+    /** @type Set<string> */
+    const locales = new Set();
+    const LANGUAGE = env["LANGUAGE"];
+    if (LANGUAGE)
+        LANGUAGE.split(":").forEach((lang) => {
+            locales.add(lang);
+        });
+    const LC_ALL = env["LC_ALL"];
+    if (LC_ALL) locales.add(LC_ALL);
+    const LC_MESSAGES = env["LC_MESSAGES"];
+    if (LC_MESSAGES) locales.add(LC_MESSAGES);
+    if (LANG) locales.add(LANG);
+    return [...locales];
+}
+
+/**
+ * @import { GetTextTranslations } from "gettext-parser";
+ * @typedef {string} Locale
+ * @typedef {{ eventName: string, callback: Function }} Listener
+ * @typedef {GetTextTranslations} Catalog
+ */
+
+export default class Gettext {
+    /** @type Map<Locale, Catalog> */
+    catalogs = new Map();
+    /** @type Array<Listener> */
+    listeners = [];
+    trusted = false;
+    /**
+     * Creates and returns a new Gettext instance.
+     *
+     * @typedef {Object} Options - a set of options
+     * @property {string} [sourceLocale] - The locale that the source code and its
+     *                                     texts are written in. Translations for
+     *                                     this locale is not necessary.
+     * @property {Record<Locale, Catalog>} [translations] - Translations to add to the catalog
+     * @property {boolean} [trusted] - Trust that the plural forms code in
+     *                                 `translations` are safe to evaluate.
+     * @param {Options} [options]
+     */
+    constructor(options) {
+        options = options || {};
+
+        // Set source locale
+        this.sourceLocale = "";
+        if (options.sourceLocale) {
+            this.sourceLocale = options.sourceLocale;
+        }
+
+        if (options.translations) {
+            for (const [locale, catalog] of Object.entries(
+                options.translations,
+            )) {
+                this.catalogs.set(locale, catalog);
+            }
+        }
+        if (options.trusted) this.trusted = true;
+    }
+    /**
+     * Return locales currently added to the catalogs.
+     */
+    getLocales() {
+        return this.catalogs.keys();
+    }
+    // NOTE: This function is actually relatively hot, since every component and
+    // every module would call it. But caching this could only really be faster
+    // if we generate the key from the arguments with something with maybe 2
+    // inputs, anything more complex would literally just be slower. At best
+    // it's a 2x speed increase, but we're talking about going from 0.0002ms per
+    // bindLocale call to 0.0001ms here. It's not worth it.
+    /**
+     * Return functions that translate strings into `locale`.
+     * This allows not having global state while also not having to pass the
+     * locale for every call.
+     *
+     * @param {Locale[] | Locale | undefined} locales
+     * A string to use as a locale, or an array of locales to try to match for,
+     * or undefined which means to not do any translations.
+     */
+    bindLocale(locales) {
+        const localesArr = !locales
+            ? []
+            : Array.isArray(locales)
+              ? locales
+              : [locales];
+
+        // The value of `this` would no longer be our instance if we call each
+        // of the functions as standalone functions. This reference to our
+        // instance, on the other hand, will not change even when the returned
+        // functions are called as standalone functions.
+        const self = this;
+
+        /**
+         * The base function for all variants.
+         * This does not need to take `locale` as an input, because all functions
+         * resulting from a given `.with` call all use the same locale.
+         *
+         * @param {string | null | undefined} msgctxt - Translation context. undefined or empty string means no context.
+         * @param {string} msgid - String to be translated
+         * @param {string} [msgidPlural] - If no translation was found, return this on count!=1
+         * @param {number} [count] - Number count for the plural
+         * @return {string}
+         *
+         */
+        const baseGettext = (msgctxt, msgid, msgidPlural, count) => {
+            const context = msgctxt || "";
+
+            let defaultTranslation = msgid;
+            if (count !== undefined && !isNaN(count) && count !== 1) {
+                defaultTranslation = msgidPlural || msgid;
+            }
+
+            for (const locale of localesArr) {
+                if (
+                    locale === "C" ||
+                    locale === "POSIX" ||
+                    locale.startsWith("C.")
+                ) {
+                    return defaultTranslation;
+                }
+                const pluralFunc = self._getCatalogPluralForms(locale).plural;
+                const catalog = self.catalogs.get(locale);
+                const translation = catalog?.translations?.[context]?.[msgid];
+                if (!translation) continue;
+
+                /** @type {boolean | number} */
+                let index = typeof count === "number" ? pluralFunc(count) : 0;
+                if (typeof index === "boolean") {
+                    index = index ? 1 : 0;
+                }
+                const msgstr = translation.msgstr[index];
+                if (msgstr) return msgstr;
+            }
+            return defaultTranslation;
+        };
+        return {
+            /**
+             * Translate a string.
+             * The locale is implicit.
+             *
+             * @param  {string} msgid - String to be translated
+             * @return {string} Translation or the original string if no translation was found
+             */
+            gettext(msgid) {
+                return baseGettext(undefined, msgid);
+            },
+            /**
+             * Translate a string.
+             * Same as `gettext`.
+             * The locale is implicit.
+             *
+             * @param  {string} msgid - String to be translated
+             * @return {string} Translation or the original string if no translation was found
+             */
+            _(msgid) {
+                return baseGettext(undefined, msgid);
+            },
+            /**
+             * Translate a plural string.
+             * The locale is implicit.
+             *
+             * @param  {string} msgid        String to be translated when count is not plural
+             * @param  {string} msgidPlural  String to be translated when count is plural
+             * @param  {number} count        Number count for the plural
+             * @return {string} Translation or the original string if no translation was found
+             */
+            ngettext(msgid, msgidPlural, count) {
+                return baseGettext(undefined, msgid, msgidPlural, count);
+            },
+            /**
+             * Translate a string from a specific context.
+             * The locale is implicit.
+             *
+             * @param  {string} msgctxt  Translation context
+             * @param  {string} msgid    String to be translated
+             * @return {string} Translation or the original string if no translation was found
+             */
+            pgettext(msgctxt, msgid) {
+                return baseGettext(msgctxt, msgid);
+            },
+            /**
+             * Translate a plural string from a specific context.
+             * The locale is implicit.
+             *
+             * @param  {string} msgctxt      Translation context
+             * @param  {string} msgid        String to be translated when count is not plural
+             * @param  {string} msgidPlural  String to be translated when count is plural
+             * @param  {number} count        Number count for the plural
+             * @return {string} Translation or the original string if no translation was found
+             */
+            npgettext(msgctxt, msgid, msgidPlural, count) {
+                return baseGettext(msgctxt, msgid, msgidPlural, count);
+            },
+        };
+    }
+    /**
+     * Cache for computed plural forms.
+     * Right now the computation is just normalizing the value then looking it
+     * up, but this already benefits from a cache.
+     * @type {Map<string, import("./plural-data.js").PluralFormsObj>}
+     */
+    _pluralForms = new Map();
+
+    /**
+     * Return plural forms header for the current catalogs for `locale`.
+     * @param {string} locale - The locale name
+     */
+    _getCatalogPluralForms(locale) {
+        return this._pluralForms.getOrInsertComputed(locale, () => {
+            const header = this.catalogs.get(locale)?.headers["Plural-Forms"];
+            return header
+                ? parsePluralForms(header, this.trusted) ||
+                      fallbackPluralForms(locale)
+                : fallbackPluralForms(locale);
+        });
+    }
+}

package/lib/loaders.js

@@ -0,0 +1,54 @@
+/** @import {Catalog, Locale} from "./gettext.js" */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { po, mo } from "gettext-parser";
+
+/**
+ * Load MO translations the directories `localesDirs`.
+ *
+ * These directories should be arranged similar to /usr/share/locale, like
+ * <dir>/<locale>/LC_MESSAGES/<domain>.mo.
+ *
+ * @param {string} domain
+ * @param {...string} localesDirs
+ */
+export function bindtextdomain(domain, ...localesDirs) {
+    /** @type Record<Locale, Catalog> */
+    const catalogs = {};
+    for (const localesDir of localesDirs) {
+        if (!fs.existsSync(localesDir)) continue;
+        for (const locale of fs.readdirSync(localesDir)) {
+            const localePath = path.join(localesDir, locale);
+            if (!fs.statSync(localePath).isDirectory()) continue;
+            const messagesPath = path.join(localePath, "LC_MESSAGES");
+            if (!fs.existsSync(messagesPath)) continue;
+            if (!fs.statSync(messagesPath).isDirectory()) continue;
+            const domainPath = path.join(messagesPath, `${domain}.mo`);
+            if (!fs.existsSync(domainPath)) continue;
+
+            const translations = mo.parse(fs.readFileSync(domainPath));
+            catalogs[locale] = translations;
+        }
+    }
+    return catalogs;
+}
+
+/**
+ * Load PO translations from `dir`.
+ * `dir` should be structured like <dir>/<locale>.po.
+ * @param {string} dir
+ */
+export function loadTranslations(dir) {
+    /** @type Record<Locale, Catalog> */
+    const catalogs = {};
+    for (const file of fs.readdirSync(dir)) {
+        if (file.endsWith(".po")) {
+            const translations = po.parse(
+                fs.readFileSync(path.join(dir, file)),
+            );
+            catalogs[file.slice(0, -3)] = translations;
+        }
+    }
+    return catalogs;
+}

package/lib/plural-data.js

@@ -0,0 +1,245 @@
+// The fallback plurals of this file are from GNU Gettext's plural-table.c as
+// well as converted from Unicode CLDR.
+
+// FIXME obviously this is not ideal!
+
+/**
+ *  @typedef {((n: number) => number) | ((n: number) => boolean)} PluralFunc
+ *  @typedef {{
+ *    nplurals: number;
+ *    plural: PluralFunc
+ * }} PluralFormsObj */
+
+/**
+ * Lookup table for existing "plural=" expressions to "parsed" function values.
+ * The keys are normalized to always start and end with parens to reduce (though
+ * not eliminate) duplicate keys.
+ * @type Record<string, PluralFunc>
+ */
+export const pluralFuncTable = {
+    "(n==1?0:n==2?1:n==0||(n%100>=3&&n%100<=10)?2:n%100>=11&&n%100<=19?3:4)": (
+        n,
+    ) =>
+        n == 1
+            ? 0
+            : n == 2
+              ? 1
+              : n == 0 || (n % 100 >= 3 && n % 100 <= 10)
+                ? 2
+                : n % 100 >= 11 && n % 100 <= 19
+                  ? 3
+                  : 4,
+    "(n%10==1&&n%100!=11)": (n) => n % 10 == 1 && n % 100 != 11,
+    "(n==0?0:n==1?1:n==2?2:n%100>=3&&n%100<=10?3:n%100>=11&&n%100<=99?4:5)": (
+        n,
+    ) =>
+        n == 0
+            ? 0
+            : n == 1
+              ? 1
+              : n == 2
+                ? 2
+                : n % 100 >= 3 && n % 100 <= 10
+                  ? 3
+                  : n % 100 >= 11 && n % 100 <= 99
+                    ? 4
+                    : 5,
+    "((n==1)?0:(n>=2&&n<=4)?1:2)": (n) =>
+        n == 1 ? 0 : n >= 2 && n <= 4 ? 1 : 2,
+    "((n==1||n==11)?0:(n==2||n==12)?1:(n>2&&n<20)?2:3)": (n) =>
+        n == 1 || n == 11 ? 0 : n == 2 || n == 12 ? 1 : n > 2 && n < 20 ? 2 : 3,
+    "(0)": () => 0,
+    "(1)": () => 1,
+    "(n!=1)": (n) => n != 1,
+    "(n%100==1?0:n%100==2?1:n%100==3||n%100==4?2:3)": (n) =>
+        n % 100 == 1
+            ? 0
+            : n % 100 == 2
+              ? 1
+              : n % 100 == 3 || n % 100 == 4
+                ? 2
+                : 3,
+    "(n%100==1?0:n%100==2?1:n%100>=3&&n%100<=4?2:3)": (n) =>
+        n % 100 == 1
+            ? 0
+            : n % 100 == 2
+              ? 1
+              : n % 100 >= 3 && n % 100 <= 4
+                ? 2
+                : 3,
+    "(n%100==1?1:n%100==2?2:n%100==3||n%100==4?3:0)": (n) =>
+        n % 100 == 1
+            ? 1
+            : n % 100 == 2
+              ? 2
+              : n % 100 == 3 || n % 100 == 4
+                ? 3
+                : 0,
+    "(n%10==1&&n%100!=11?0:n!=0?1:2)": (n) =>
+        n % 10 == 1 && n % 100 != 11 ? 0 : n != 0 ? 1 : 2,
+    "(n%10==1&&n%100!=11?0:n%10>=2&&(n%100<10||n%100>=20)?1:2)": (n) =>
+        n % 10 == 1 && n % 100 != 11
+            ? 0
+            : n % 10 >= 2 && (n % 100 < 10 || n % 100 >= 20)
+              ? 1
+              : 2,
+    "(n%10==1&&n%100!=11?0:n%10>=2&&n%10<=4&&(n%100<10||n%100>=20)?1:2)": (
+        n,
+    ) =>
+        n % 10 == 1 && n % 100 != 11
+            ? 0
+            : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20)
+              ? 1
+              : 2,
+    "(n%10==1&&n%100!=11?0:n%10>=2&&n%10<=4&&(n%100<12||n%100>14)?1:n%10==0||n%10>=5&&n%10<=9||n%100>=11&&n%100<=14?2:3)":
+        (n) =>
+            n % 10 == 1 && n % 100 != 11
+                ? 0
+                : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14)
+                  ? 1
+                  : n % 10 == 0 ||
+                      (n % 10 >= 5 && n % 10 <= 9) ||
+                      (n % 100 >= 11 && n % 100 <= 14)
+                    ? 2
+                    : 3,
+    "(n%10==1?0:n%10==2?1:2)": (n) => (n % 10 == 1 ? 0 : n % 10 == 2 ? 1 : 2),
+    "(n==0?0:n==1?1:n==2?2:3)": (n) =>
+        n == 0 ? 0 : n == 1 ? 1 : n == 2 ? 2 : 3,
+    "(n==0?0:n==1?1:n==2?2:n%100>=3&&n%100<=10?3:n%100>=11?4:5)": (n) =>
+        n == 0
+            ? 0
+            : n == 1
+              ? 1
+              : n == 2
+                ? 2
+                : n % 100 >= 3 && n % 100 <= 10
+                  ? 3
+                  : n % 100 >= 11
+                    ? 4
+                    : 5,
+    "(n==0||n==1)": (n) => n == 0 || n == 1,
+    "(n==1)?0:((n==2)?1:((n>10&&n%10==0)?2:3))": (n) =>
+        n == 1 ? 0 : n == 2 ? 1 : n > 10 && n % 10 == 0 ? 2 : 3,
+    "(n==1?0:(n==0||(n%100>0&&n%100<20))?1:2)": (n) =>
+        n == 1 ? 0 : n == 0 || (n % 100 > 0 && n % 100 < 20) ? 1 : 2,
+    "(n==1?0:n%10>=2&&(n%100<10||n%100>=20)?1:n%10==0||(n%100>10&&n%100<20)?2:3)":
+        (n) =>
+            n == 1
+                ? 0
+                : n % 10 >= 2 && (n % 100 < 10 || n % 100 >= 20)
+                  ? 1
+                  : n % 10 == 0 || (n % 100 > 10 && n % 100 < 20)
+                    ? 2
+                    : 3,
+    "(n==1?0:n%10>=2&&n%10<=4&&(n%100<10||n%100>=20)?1:2)": (n) =>
+        n == 1
+            ? 0
+            : n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 10 || n % 100 >= 20)
+              ? 1
+              : 2,
+    "(n==1?0:n==2?1:2)": (n) => (n == 1 ? 0 : n == 2 ? 1 : 2),
+    "(n==1?0:n==2?1:n<7?2:n<11?3:4)": (n) =>
+        n == 1 ? 0 : n == 2 ? 1 : n < 7 ? 2 : n < 11 ? 3 : 4,
+    "(n==1?3:n%10==1&&n%100!=11?0:n%10>=2&&n%10<=4&&(n%100<10||n%100>=20)?1:2)":
+        (n) =>
+            n == 1
+                ? 3
+                : n % 10 == 1 && n % 100 != 11
+                  ? 0
+                  : n % 10 >= 2 &&
+                      n % 10 <= 4 &&
+                      (n % 100 < 10 || n % 100 >= 20)
+                    ? 1
+                    : 2,
+    "(n>1)": (n) => n > 1,
+    "(n>2)": (n) => n > 2,
+};
+
+// from Gettext's plural-table.c
+// prettier-ignore
+const pluralTable = {
+    "ja vi ko": "nplurals=1; plural=0;",
+    "en de nl sv da no nb nn fo es pt it bg el fi et he eo hu tr ca": "nplurals=2; plural=(n != 1);",
+    "pt_BR fr": "nplurals=2; plural=(n > 1);",
+    "lv": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);",
+    "ga": "nplurals=3; plural=n==1 ? 0 : n==2 ? 1 : 2;",
+    "ro": "nplurals=3; plural=n==1 ? 0 : (n==0 || (n%100 > 0 && n%100 < 20)) ? 1 : 2;",
+    "lt": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "ru uk be sr hr": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "cs sk": "nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;",
+    "pl": "nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "sl": "nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);",
+};
+
+// from Unicode CLDR (plurals.xml), converted with Gettext's cldr-plurals program
+// prettier-ignore
+const cldrPlurals = {
+    "bm bo dz hnj id ig ii in ja jbo jv jw kde kea km ko lkt lo ms my nqo osa root sah ses sg su th to tpi vi wo yo yue zh":
+        "nplurals=1; plural=0;",
+    "am as bn doi fa gu hi kn kok kok_Latn pcm zu":
+        "nplurals=2; plural=(n==0 || n==1);",
+    "ff hy kab": "nplurals=2; plural=(n > 1);",
+    "ast de en et fi fy gl ia ie io ji lij nl sc sv sw ur yi":
+        "nplurals=2; plural=(n != 1);",
+    "si": "nplurals=2; plural=(n > 1);",
+    "ak bho csw guw ln mg nso pa ti wa": "nplurals=2; plural=(n > 1);",
+    "tzm": "nplurals=2; plural=(n<=1 || (n>=11 && n<=99));",
+    "af an asa az bal bem bez bg brx ce cgg chr ckb dv ee el eo eu fo fur gsw ha haw hu jgo jmc ka kaj kcg kk kkj kl ks ksb ku ky lb lg mas mgo ml mn mr nah nb nd ne nn nnh no nr ny nyn om or os pap ps rm rof rwk saq sd sdh seh sn so sq ss ssy st syr ta te teo tig tk tn tr ts ug uz ve vo vun wae xh xog":
+        "nplurals=2; plural=(n != 1);",
+    "da": "nplurals=2; plural=(n != 1);",
+    "is": "nplurals=2; plural=(n%10==1 && n%100!=11);",
+    "mk": "nplurals=2; plural=(n%10==1 && n%100!=11);",
+    "ceb fil tl":
+        "nplurals=2; plural=(n==1 || n==2 || n==3 || (n%10!=4 && n%10!=6 && n%10!=9));",
+    "lv prg":
+        "nplurals=3; plural=(n%10==0 || (n%100>=11 && n%100<=19) ? 0 : n%10==1 && n%100!=11 ? 1 : 2);",
+    "lag": "nplurals=3; plural=(n==0 ? 0 : (n==0 || n==1) && n!=0 ? 1 : 2);",
+    "blo cv ksh": "nplurals=3; plural=(n==0 ? 0 : n==1 ? 1 : 2);",
+    "he iw": "nplurals=3; plural=(n==1 ? 0 : n==2 ? 1 : 2);",
+    "iu naq sat se sma smi smj smn sms":
+        "nplurals=3; plural=(n==1 ? 0 : n==2 ? 1 : 2);",
+    "shi": "nplurals=3; plural=(n==0 || n==1 ? 0 : n>=2 && n<=10 ? 1 : 2);",
+    "mo ro":
+        "nplurals=3; plural=(n==1 ? 0 : n==0 || (n!=1 && n%100>=1 && n%100<=19) ? 1 : 2);",
+    "bs hr sh sr":
+        "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);",
+    "fr": "nplurals=3; plural=(n==0 || n==1 ? 0 : n!=0 && n%1000000==0 ? 1 : 2);",
+    "pt": "nplurals=3; plural=(n<=1 ? 0 : n!=0 && n%1000000==0 ? 1 : 2);",
+    "ca it lld pt_PT scn vec":
+        "nplurals=3; plural=(n==1 ? 0 : n!=0 && n%1000000==0 ? 1 : 2);",
+    "es": "nplurals=3; plural=(n==1 ? 0 : n!=0 && n%1000000==0 ? 1 : 2);",
+    "gd": "nplurals=4; plural=(n==1 || n==11 ? 0 : n==2 || n==12 ? 1 : (n>=3 && n<=10) || (n>=13 && n<=19) ? 2 : 3);",
+    "sl": "nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100>=3 && n%100<=4 ? 2 : 3);",
+    "dsb hsb":
+        "nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100>=3 && n%100<=4 ? 2 : 3);",
+    "cs sk": "nplurals=3; plural=(n==1 ? 0 : n>=2 && n<=4 ? 1 : 2);",
+    "pl": "nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);",
+    "be": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);",
+    "lt": "nplurals=3; plural=(n%10==1 && (n%100<11 || n%100>19) ? 0 : n%10>=2 && n%10<=9 && (n%100<11 || n%100>19) ? 1 : 2);",
+    "ru uk":
+        "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);",
+    "sgs": "nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n==2 ? 1 : n!=2 && n%10>=2 && n%10<=9 && (n%100<11 || n%100>19) ? 2 : 3);",
+    "br": "nplurals=5; plural=(n%10==1 && n%100!=11 && n%100!=71 && n%100!=91 ? 0 : n%10==2 && n%100!=12 && n%100!=72 && n%100!=92 ? 1 : ((n%10>=3 && n%10<=4) || n%10==9) && (n%100<10 || n%100>19) && (n%100<70 || n%100>79) && (n%100<90 || n%100>99) ? 2 : n!=0 && n%1000000==0 ? 3 : 4);",
+    "mt": "nplurals=5; plural=(n==1 ? 0 : n==2 ? 1 : n==0 || (n%100>=3 && n%100<=10) ? 2 : n%100>=11 && n%100<=19 ? 3 : 4);",
+    "ga": "nplurals=5; plural=(n==1 ? 0 : n==2 ? 1 : n>=3 && n<=6 ? 2 : n>=7 && n<=10 ? 3 : 4);",
+    "gv": "nplurals=4; plural=(n%10==1 ? 0 : n%10==2 ? 1 : n%100==0 || n%100==20 || n%100==40 || n%100==60 || n%100==80 ? 2 : 3);",
+    "kw": "nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n%100==2 || n%100==22 || n%100==42 || n%100==62 || n%100==82 || (n%1000==0 && ((n%100000>=1000 && n%100000<=20000) || n%100000==40000 || n%100000==60000 || n%100000==80000)) || (n!=0 && n%1000000==100000) ? 2 : n%100==3 || n%100==23 || n%100==43 || n%100==63 || n%100==83 ? 3 : n!=1 && (n%100==1 || n%100==21 || n%100==41 || n%100==61 || n%100==81) ? 4 : 5);",
+    "ar ars":
+        "nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5);",
+    "cy": "nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n==3 ? 3 : n==6 ? 4 : 5);",
+};
+
+/**
+ * Lookup table mapping locales to plural forms.
+ * @param {string} locale - The locale to look up.
+ */
+export function localePluralForms(locale) {
+    // Try gettext's first
+    for (const [langs, value] of Object.entries(pluralTable)) {
+        if (langs.split(" ").includes(locale)) return value;
+    }
+    // Then try CLDR
+    for (const [langs, value] of Object.entries(cldrPlurals)) {
+        if (langs.split(" ").includes(locale)) return value;
+    }
+}

package/lib/plurals.js

@@ -0,0 +1,76 @@
+import { pluralFuncTable, localePluralForms } from "./plural-data.js";
+
+// The function can only always return numbers or always return booleans
+// regardless of the input.
+/**
+ * @import { PluralFormsObj } from "./plural-data.js";
+ * @type PluralFormsObj
+ */
+const defaultPluralForms = {
+    nplurals: 2,
+    plural: (n) => n !== 1,
+};
+
+/**
+ * "Parse" the plural forms.
+ *
+ * Ideally this would actually parse it instead of using a lookup table, except
+ * that would be too complicated and also questionably safe. So maybe using a
+ * lookup table is fine.
+ *
+ * @param {string} pluralForms - The plural forms string from the header
+ * @param {boolean} trusted - Trust that the code in `pluralForms` is safe to run
+ */
+export function parsePluralForms(pluralForms, trusted = false) {
+    const normalized = pluralForms.replaceAll(/ |(?:;(?:\\n)?$)/g, "");
+    const match = normalized.match(/^nplurals=(\d);plural=(.*)/);
+    if (!match) {
+        console.log(
+            `Warning: matching pluralForms failed! Original value: ${pluralForms}`,
+        );
+        return undefined;
+    }
+    const nplurals = parseInt(match[1]);
+    let pluralStr = match[2];
+    if (!pluralStr.match(/^\(.*\)$/)) {
+        pluralStr = "(" + pluralStr + ")";
+    }
+
+    const func = trusted
+        ? /** @type import("./plural-data.js").PluralFunc */ (
+              new Function("n", `return ${pluralStr}`)
+          )
+        : pluralFuncTable[pluralStr];
+    if (func) {
+        return {
+            nplurals,
+            plural: func,
+        };
+    }
+    console.log(`Warning: unknown pluralForms! "${pluralForms}"`);
+    return undefined;
+}
+
+/**
+ * Return the fallback plural forms for `locale`.
+ *
+ * If the locale with a region does not match, try without its region.
+ * @param {string} locale - The locale to get the fallback value for.
+ */
+export function fallbackPluralForms(locale) {
+    const pluralForms =
+        localePluralForms(locale) ||
+        // if not found, try with underscore. GNU Gettext usually prefers underscore
+        localePluralForms(locale.replace("-", "_")) ||
+        // if not found, try the top level code. The top level code can only
+        // be 2 ~ 3 characters.
+        localePluralForms(locale.slice(0, 3).replace(/[-_]/, ""));
+    if (pluralForms) {
+        const parsed = parsePluralForms(pluralForms, true);
+        if (parsed) return parsed;
+    }
+    console.log(
+        `Warning: no fallback plurals found for locale "${locale}". Using default plurals (Germanic).`,
+    );
+    return defaultPluralForms;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kemdict/gettext",
+  "description": "A JavaScript implementation of gettext, a localization framework",
+  "version": "0.1.0",
+  "//": "Messy setup for this fork. The original author Andris Reinman is the original author but not the one responsible for this fork.",
+  "author": "Kisaragi Hiu",
+  "contributors": ["Andris Reinman", "Kisaragi Hiu"],
+  "maintainers": ["Kisaragi Hiu <mail@kisaragi-hiu.com>"],
+  "homepage": "http://github.com/kemdict/gettext",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kemdict/gettext.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": ["lib", "types", "README.md", "LICENSE", "package.json"],
+  "exports": {
+    ".": {
+      "types": "./types/gettext.d.ts",
+      "default": "./lib/gettext.js"
+    },
+    "./loaders.js": {
+      "types": "./types/loaders.d.ts",
+      "default": "./lib/loaders.js"
+    }
+  },
+  "devDependencies": {
+    "@types/gettext-parser": "^8.0.0",
+    "@types/node": "^26.0.1",
+    "gettext-parser": "^9.0.0",
+    "prettier": "^3.7.4",
+    "typescript": "^6.0.3"
+  },
+  "engine": {
+    "node": ">=26"
+  },
+  "keywords": [
+    "i18n",
+    "l10n",
+    "internationalization",
+    "localization",
+    "translation",
+    "gettext"
+  ]
+}

package/types/gettext.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Guess or lookup the preferred language list from environment variables.
+ * @param {Record<string, string | undefined>} env
+ *   A map of environment variables. Defaults to process.env.
+ * @returns string[] | undefined
+ */
+export function guessEnvLocale(env?: Record<string, string | undefined>): string[] | undefined;
+/**
+ * @import { GetTextTranslations } from "gettext-parser";
+ * @typedef {string} Locale
+ * @typedef {{ eventName: string, callback: Function }} Listener
+ * @typedef {GetTextTranslations} Catalog
+ */
+export default class Gettext {
+    /**
+     * Creates and returns a new Gettext instance.
+     *
+     * @typedef {Object} Options - a set of options
+     * @property {string} [sourceLocale] - The locale that the source code and its
+     *                                     texts are written in. Translations for
+     *                                     this locale is not necessary.
+     * @property {Record<Locale, Catalog>} [translations] - Translations to add to the catalog
+     * @property {boolean} [trusted] - Trust that the plural forms code in
+     *                                 `translations` are safe to evaluate.
+     * @param {Options} [options]
+     */
+    constructor(options?: {
+        /**
+         * - The locale that the source code and its
+         *    texts are written in. Translations for
+         *    this locale is not necessary.
+         */
+        sourceLocale?: string | undefined;
+        /**
+         * - Translations to add to the catalog
+         */
+        translations?: Record<string, GetTextTranslations> | undefined;
+        /**
+         * - Trust that the plural forms code in
+         *    `translations` are safe to evaluate.
+         */
+        trusted?: boolean | undefined;
+    });
+    /** @type Map<Locale, Catalog> */
+    catalogs: Map<Locale, Catalog>;
+    /** @type Array<Listener> */
+    listeners: Array<Listener>;
+    trusted: boolean;
+    sourceLocale: string;
+    /**
+     * Return locales currently added to the catalogs.
+     */
+    getLocales(): MapIterator<string>;
+    /**
+     * Return functions that translate strings into `locale`.
+     * This allows not having global state while also not having to pass the
+     * locale for every call.
+     *
+     * @param {Locale[] | Locale | undefined} locales
+     * A string to use as a locale, or an array of locales to try to match for,
+     * or undefined which means to not do any translations.
+     */
+    bindLocale(locales: Locale[] | Locale | undefined): {
+        /**
+         * Translate a string.
+         * The locale is implicit.
+         *
+         * @param  {string} msgid - String to be translated
+         * @return {string} Translation or the original string if no translation was found
+         */
+        gettext(msgid: string): string;
+        /**
+         * Translate a string.
+         * Same as `gettext`.
+         * The locale is implicit.
+         *
+         * @param  {string} msgid - String to be translated
+         * @return {string} Translation or the original string if no translation was found
+         */
+        _(msgid: string): string;
+        /**
+         * Translate a plural string.
+         * The locale is implicit.
+         *
+         * @param  {string} msgid        String to be translated when count is not plural
+         * @param  {string} msgidPlural  String to be translated when count is plural
+         * @param  {number} count        Number count for the plural
+         * @return {string} Translation or the original string if no translation was found
+         */
+        ngettext(msgid: string, msgidPlural: string, count: number): string;
+        /**
+         * Translate a string from a specific context.
+         * The locale is implicit.
+         *
+         * @param  {string} msgctxt  Translation context
+         * @param  {string} msgid    String to be translated
+         * @return {string} Translation or the original string if no translation was found
+         */
+        pgettext(msgctxt: string, msgid: string): string;
+        /**
+         * Translate a plural string from a specific context.
+         * The locale is implicit.
+         *
+         * @param  {string} msgctxt      Translation context
+         * @param  {string} msgid        String to be translated when count is not plural
+         * @param  {string} msgidPlural  String to be translated when count is plural
+         * @param  {number} count        Number count for the plural
+         * @return {string} Translation or the original string if no translation was found
+         */
+        npgettext(msgctxt: string, msgid: string, msgidPlural: string, count: number): string;
+    };
+    /**
+     * Cache for computed plural forms.
+     * Right now the computation is just normalizing the value then looking it
+     * up, but this already benefits from a cache.
+     * @type {Map<string, import("./plural-data.js").PluralFormsObj>}
+     */
+    _pluralForms: Map<string, import("./plural-data.js").PluralFormsObj>;
+    /**
+     * Return plural forms header for the current catalogs for `locale`.
+     * @param {string} locale - The locale name
+     */
+    _getCatalogPluralForms(locale: string): import("./plural-data.js").PluralFormsObj;
+}
+export type Locale = string;
+export type Listener = {
+    eventName: string;
+    callback: Function;
+};
+export type Catalog = GetTextTranslations;
+import type { GetTextTranslations } from "gettext-parser";
+//# sourceMappingURL=gettext.d.ts.map

package/types/gettext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gettext.d.ts","sourceRoot":"","sources":["../lib/gettext.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,qCAJW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,wBAyB5C;AAED;;;;;GAKG;AAEH;IAMI;;;;;;;;;;;OAWG;IACH;;;;;;;;;;;;;;;;OAiBC;IAlCD,iCAAiC;IACjC,UADU,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CACT;IACrB,4BAA4B;IAC5B,WADU,KAAK,CAAC,QAAQ,CAAC,CACV;IACf,iBAAgB;IAiBZ,qBAAsB;IAc1B;;OAEG;IACH,kCAEC;IAOD;;;;;;;;OAQG;IACH,oBAJW,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS;QA6DhC;;;;;;WAMG;uBAFS,MAAM,GACN,MAAM;QAKlB;;;;;;;WAOG;iBAFS,MAAM,GACN,MAAM;QAKlB;;;;;;;;WAQG;wBAJS,MAAM,eACN,MAAM,SACN,MAAM,GACN,MAAM;QAKlB;;;;;;;WAOG;0BAHS,MAAM,SACN,MAAM,GACN,MAAM;QAKlB;;;;;;;;;WASG;2BALS,MAAM,SACN,MAAM,eACN,MAAM,SACN,MAAM,GACN,MAAM;MAMzB;IACD;;;;;OAKG;IACH,cAFU,GAAG,CAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,cAAc,CAAC,CAEvC;IAEzB;;;OAGG;IACH,+BAFW,MAAM,6CAUhB;CACJ;qBAvMY,MAAM;uBACN;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,WAAU;CAAE;sBACzC,mBAAmB;yCAHQ,gBAAgB"}

package/types/loaders.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Load MO translations the directories `localesDirs`.
+ *
+ * These directories should be arranged similar to /usr/share/locale, like
+ * <dir>/<locale>/LC_MESSAGES/<domain>.mo.
+ *
+ * @param {string} domain
+ * @param {...string} localesDirs
+ */
+export function bindtextdomain(domain: string, ...localesDirs: string[]): Record<string, import("gettext-parser").GetTextTranslations>;
+/**
+ * Load PO translations from `dir`.
+ * `dir` should be structured like <dir>/<locale>.po.
+ * @param {string} dir
+ */
+export function loadTranslations(dir: string): Record<string, import("gettext-parser").GetTextTranslations>;
+//# sourceMappingURL=loaders.d.ts.map

package/types/loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaders.d.ts","sourceRoot":"","sources":["../lib/loaders.js"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,uCAHW,MAAM,kBACH,MAAM,EAAA,gEAqBnB;AAED;;;;GAIG;AACH,sCAFW,MAAM,gEAchB"}

package/types/plural-data.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lookup table mapping locales to plural forms.
+ * @param {string} locale - The locale to look up.
+ */
+export function localePluralForms(locale: string): string | undefined;
+/**
+ *  @typedef {((n: number) => number) | ((n: number) => boolean)} PluralFunc
+ *  @typedef {{
+ *    nplurals: number;
+ *    plural: PluralFunc
+ * }} PluralFormsObj */
+/**
+ * Lookup table for existing "plural=" expressions to "parsed" function values.
+ * The keys are normalized to always start and end with parens to reduce (though
+ * not eliminate) duplicate keys.
+ * @type Record<string, PluralFunc>
+ */
+export const pluralFuncTable: Record<string, PluralFunc>;
+export type PluralFunc = ((n: number) => number) | ((n: number) => boolean);
+export type PluralFormsObj = {
+    nplurals: number;
+    plural: PluralFunc;
+};
+//# sourceMappingURL=plural-data.d.ts.map

package/types/plural-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plural-data.d.ts","sourceRoot":"","sources":["../lib/plural-data.js"],"names":[],"mappings":"AAuOA;;;GAGG;AACH,0CAFW,MAAM,sBAWhB;AA/OD;;;;;uBAKuB;AAEvB;;;;;GAKG;AACH,8BAFS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA2IjC;yBArJY,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;6BAClD;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAA;CACpB"}

package/types/plurals.d.ts

@@ -0,0 +1,23 @@
+/**
+ * "Parse" the plural forms.
+ *
+ * Ideally this would actually parse it instead of using a lookup table, except
+ * that would be too complicated and also questionably safe. So maybe using a
+ * lookup table is fine.
+ *
+ * @param {string} pluralForms - The plural forms string from the header
+ * @param {boolean} trusted - Trust that the code in `pluralForms` is safe to run
+ */
+export function parsePluralForms(pluralForms: string, trusted?: boolean): {
+    nplurals: number;
+    plural: import("./plural-data.js").PluralFunc;
+} | undefined;
+/**
+ * Return the fallback plural forms for `locale`.
+ *
+ * If the locale with a region does not match, try without its region.
+ * @param {string} locale - The locale to get the fallback value for.
+ */
+export function fallbackPluralForms(locale: string): PluralFormsObj;
+import type { PluralFormsObj } from "./plural-data.js";
+//# sourceMappingURL=plurals.d.ts.map

package/types/plurals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plurals.d.ts","sourceRoot":"","sources":["../lib/plurals.js"],"names":[],"mappings":"AAaA;;;;;;;;;GASG;AACH,8CAHW,MAAM,YACN,OAAO;;;cA8BjB;AAED;;;;;GAKG;AACH,4CAFW,MAAM,kBAkBhB;oCAtEkC,kBAAkB"}