@wordpress/i18n 5.26.0 → 6.0.1-next.46f643fa0.0

package/build-module/default-i18n.js.map

@@ -1 +1 @@
-{"version":3,"names":["createI18n","defaultHooks","i18n","undefined","getLocaleData","bind","setLocaleData","resetLocaleData","subscribe","__","_x","_n","_nx","isRTL","hasTranslation"],"sources":["@wordpress/i18n/src/default-i18n.js"],"sourcesContent":["/**\n * Internal dependencies\n */\nimport { createI18n } from './create-i18n';\n\n/**\n * WordPress dependencies\n */\nimport { defaultHooks } from '@wordpress/hooks';\n\nconst i18n = createI18n( undefined, undefined, defaultHooks );\n\n/**\n * Default, singleton instance of `I18n`.\n */\nexport default i18n;\n\n/*\n * Comments in this file are duplicated from ./i18n due to\n * https://github.com/WordPress/gutenberg/pull/20318#issuecomment-590837722\n */\n\n/**\n * @typedef {import('./create-i18n').LocaleData} LocaleData\n * @typedef {import('./create-i18n').SubscribeCallback} SubscribeCallback\n * @typedef {import('./create-i18n').UnsubscribeCallback} UnsubscribeCallback\n */\n\n/**\n * Returns locale data by domain in a Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param {string} [domain] Domain for which to get the data.\n * @return {LocaleData} Locale data.\n */\nexport const getLocaleData = i18n.getLocaleData.bind( i18n );\n\n/**\n * Merges locale data into the Tannin instance by domain. Accepts data in a\n * Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param {LocaleData} [data]   Locale data configuration.\n * @param {string}     [domain] Domain for which configuration applies.\n */\nexport const setLocaleData = i18n.setLocaleData.bind( i18n );\n\n/**\n * Resets all current Tannin instance locale data and sets the specified\n * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param {LocaleData} [data]   Locale data configuration.\n * @param {string}     [domain] Domain for which configuration applies.\n */\nexport const resetLocaleData = i18n.resetLocaleData.bind( i18n );\n\n/**\n * Subscribes to changes of locale data\n *\n * @param {SubscribeCallback} callback Subscription callback\n * @return {UnsubscribeCallback} Unsubscribe callback\n */\nexport const subscribe = i18n.subscribe.bind( i18n );\n\n/**\n * Retrieve the translation of text.\n *\n * @see https://developer.wordpress.org/reference/functions/__/\n *\n * @param {string} text     Text to translate.\n * @param {string} [domain] Domain to retrieve the translated text.\n *\n * @return {string} Translated text.\n */\nexport const __ = i18n.__.bind( i18n );\n\n/**\n * Retrieve translated string with gettext context.\n *\n * @see https://developer.wordpress.org/reference/functions/_x/\n *\n * @param {string} text     Text to translate.\n * @param {string} context  Context information for the translators.\n * @param {string} [domain] Domain to retrieve the translated text.\n *\n * @return {string} Translated context string without pipe.\n */\nexport const _x = i18n._x.bind( i18n );\n\n/**\n * Translates and retrieves the singular or plural form based on the supplied\n * number.\n *\n * @see https://developer.wordpress.org/reference/functions/_n/\n *\n * @param {string} single   The text to be used if the number is singular.\n * @param {string} plural   The text to be used if the number is plural.\n * @param {number} number   The number to compare against to use either the\n *                          singular or plural form.\n * @param {string} [domain] Domain to retrieve the translated text.\n *\n * @return {string} The translated singular or plural form.\n */\nexport const _n = i18n._n.bind( i18n );\n\n/**\n * Translates and retrieves the singular or plural form based on the supplied\n * number, with gettext context.\n *\n * @see https://developer.wordpress.org/reference/functions/_nx/\n *\n * @param {string} single   The text to be used if the number is singular.\n * @param {string} plural   The text to be used if the number is plural.\n * @param {number} number   The number to compare against to use either the\n *                          singular or plural form.\n * @param {string} context  Context information for the translators.\n * @param {string} [domain] Domain to retrieve the translated text.\n *\n * @return {string} The translated singular or plural form.\n */\nexport const _nx = i18n._nx.bind( i18n );\n\n/**\n * Check if current locale is RTL.\n *\n * **RTL (Right To Left)** is a locale property indicating that text is written from right to left.\n * For example, the `he` locale (for Hebrew) specifies right-to-left. Arabic (ar) is another common\n * language written RTL. The opposite of RTL, LTR (Left To Right) is used in other languages,\n * including English (`en`, `en-US`, `en-GB`, etc.), Spanish (`es`), and French (`fr`).\n *\n * @return {boolean} Whether locale is RTL.\n */\nexport const isRTL = i18n.isRTL.bind( i18n );\n\n/**\n * Check if there is a translation for a given string (in singular form).\n *\n * @param {string} single    Singular form of the string to look up.\n * @param {string} [context] Context information for the translators.\n * @param {string} [domain]  Domain to retrieve the translated text.\n * @return {boolean} Whether the translation exists or not.\n */\nexport const hasTranslation = i18n.hasTranslation.bind( i18n );\n"],"mappings":"AAAA;AACA;AACA;AACA,SAASA,UAAU,QAAQ,eAAe;;AAE1C;AACA;AACA;AACA,SAASC,YAAY,QAAQ,kBAAkB;AAE/C,MAAMC,IAAI,GAAGF,UAAU,CAAEG,SAAS,EAAEA,SAAS,EAAEF,YAAa,CAAC;;AAE7D;AACA;AACA;AACA,eAAeC,IAAI;;AAEnB;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,aAAa,GAAGF,IAAI,CAACE,aAAa,CAACC,IAAI,CAAEH,IAAK,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,aAAa,GAAGJ,IAAI,CAACI,aAAa,CAACD,IAAI,CAAEH,IAAK,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,eAAe,GAAGL,IAAI,CAACK,eAAe,CAACF,IAAI,CAAEH,IAAK,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,SAAS,GAAGN,IAAI,CAACM,SAAS,CAACH,IAAI,CAAEH,IAAK,CAAC;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMO,EAAE,GAAGP,IAAI,CAACO,EAAE,CAACJ,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMQ,EAAE,GAAGR,IAAI,CAACQ,EAAE,CAACL,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMS,EAAE,GAAGT,IAAI,CAACS,EAAE,CAACN,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMU,GAAG,GAAGV,IAAI,CAACU,GAAG,CAACP,IAAI,CAAEH,IAAK,CAAC;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMW,KAAK,GAAGX,IAAI,CAACW,KAAK,CAACR,IAAI,CAAEH,IAAK,CAAC;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMY,cAAc,GAAGZ,IAAI,CAACY,cAAc,CAACT,IAAI,CAAEH,IAAK,CAAC","ignoreList":[]}
+{"version":3,"names":["createI18n","defaultHooks","i18n","undefined","getLocaleData","bind","setLocaleData","resetLocaleData","subscribe","__","_x","_n","_nx","isRTL","hasTranslation"],"sources":["@wordpress/i18n/src/default-i18n.ts"],"sourcesContent":["/**\n * Internal dependencies\n */\nimport { createI18n } from './create-i18n';\n\n/**\n * WordPress dependencies\n */\nimport { defaultHooks } from '@wordpress/hooks';\nimport {\n\tLocaleData,\n\tSubscribeCallback,\n\tTranslatableText,\n\tUnsubscribeCallback,\n} from './types';\n\nconst i18n = createI18n( undefined, undefined, defaultHooks );\n\n/**\n * Default, singleton instance of `I18n`.\n */\nexport default i18n;\n\n/*\n * Comments in this file are duplicated from ./i18n due to\n * https://github.com/WordPress/gutenberg/pull/20318#issuecomment-590837722\n */\n\n/**\n * Returns locale data by domain in a Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param { string | undefined } [domain] Domain for which to get the data.\n * @return { LocaleData } Locale data.\n */\nexport const getLocaleData = i18n.getLocaleData.bind( i18n );\n\n/**\n * Merges locale data into the Tannin instance by domain. Accepts data in a\n * Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param {LocaleData }        [data]   Locale data configuration.\n * @param {string | undefined} [domain] Domain for which configuration applies.\n */\nexport const setLocaleData = i18n.setLocaleData.bind( i18n );\n\n/**\n * Resets all current Tannin instance locale data and sets the specified\n * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.\n *\n * @see http://messageformat.github.io/Jed/\n *\n * @param {LocaleData}         [data]   Locale data configuration.\n * @param {string | undefined} [domain] Domain for which configuration applies.\n */\nexport const resetLocaleData = i18n.resetLocaleData.bind( i18n );\n\n/**\n * Subscribes to changes of locale data\n *\n * @param {SubscribeCallback} callback Subscription callback\n * @return {UnsubscribeCallback} Unsubscribe callback\n */\nexport const subscribe = i18n.subscribe.bind( i18n );\n\n/**\n * Retrieve the translation of text.\n *\n * @see https://developer.wordpress.org/reference/functions/__/\n *\n * @template {string} Text\n *\n * @param {Text}               text   Text to translate.\n * @param {string | undefined} domain Domain to retrieve the translated text.\n *\n * @return {TranslatableText<Text>} Translated text.\n */\nexport const __ = i18n.__.bind( i18n );\n\n/**\n * Retrieve translated string with gettext context.\n *\n * @see https://developer.wordpress.org/reference/functions/_x/\n *\n * @template {string} Text\n *\n * @param {Text}               text    Text to translate.\n * @param {string}             context Context information for the translators.\n * @param {string | undefined} domain  Domain to retrieve the translated text.\n *\n * @return {TranslatableText<Text>} Translated context string without pipe.\n */\nexport const _x = i18n._x.bind( i18n );\n\n/**\n * Translates and retrieves the singular or plural form based on the supplied\n * number.\n *\n * @see https://developer.wordpress.org/reference/functions/_n/\n *\n * @template {string} Single\n * @template {string} Plural\n *\n * @param {Single}             single The text to be used if the number is singular.\n * @param {Plural}             plural The text to be used if the number is plural.\n * @param {number}             number The number to compare against to use either the\n *                                    singular or plural form.\n * @param {string | undefined} domain Domain to retrieve the translated text.\n *\n * @return {TranslatableText<Single | Plural>} The translated singular or plural form.\n */\nexport const _n = i18n._n.bind( i18n );\n\n/**\n * Translates and retrieves the singular or plural form based on the supplied\n * number, with gettext context.\n *\n * @see https://developer.wordpress.org/reference/functions/_nx/\n *\n * @template {string} Single\n * @template {string} Plural\n * @param {Single}             single   The text to be used if the number is singular.\n *\n * @param {Single}             single   The text to be used if the number is singular.\n * @param {Plural}             plural   The text to be used if the number is plural.\n * @param {number}             number   The number to compare against to use either the\n *                                      singular or plural form.\n * @param {string}             context  Context information for the translators.\n * @param {string | undefined} [domain] Domain to retrieve the translated text.\n *\n * @return {TranslatableText<Single | Plural>} The translated singular or plural form.\n */\nexport const _nx = i18n._nx.bind( i18n );\n\n/**\n * Check if current locale is RTL.\n *\n * **RTL (Right To Left)** is a locale property indicating that text is written from right to left.\n * For example, the `he` locale (for Hebrew) specifies right-to-left. Arabic (ar) is another common\n * language written RTL. The opposite of RTL, LTR (Left To Right) is used in other languages,\n * including English (`en`, `en-US`, `en-GB`, etc.), Spanish (`es`), and French (`fr`).\n *\n * @return {boolean} Whether locale is RTL.\n */\nexport const isRTL = i18n.isRTL.bind( i18n );\n\n/**\n * Check if there is a translation for a given string (in singular form).\n *\n * @param {string} single  Singular form of the string to look up.\n * @param {string} context Context information for the translators.\n * @param {string} domain  Domain to retrieve the translated text.\n *\n * @return {boolean} Whether the translation exists or not.\n */\nexport const hasTranslation = i18n.hasTranslation.bind( i18n );\n"],"mappings":"AAAA;AACA;AACA;AACA,SAASA,UAAU,QAAQ,eAAe;;AAE1C;AACA;AACA;AACA,SAASC,YAAY,QAAQ,kBAAkB;AAQ/C,MAAMC,IAAI,GAAGF,UAAU,CAAEG,SAAS,EAAEA,SAAS,EAAEF,YAAa,CAAC;;AAE7D;AACA;AACA;AACA,eAAeC,IAAI;;AAEnB;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,aAAa,GAAGF,IAAI,CAACE,aAAa,CAACC,IAAI,CAAEH,IAAK,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,aAAa,GAAGJ,IAAI,CAACI,aAAa,CAACD,IAAI,CAAEH,IAAK,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMK,eAAe,GAAGL,IAAI,CAACK,eAAe,CAACF,IAAI,CAAEH,IAAK,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,SAAS,GAAGN,IAAI,CAACM,SAAS,CAACH,IAAI,CAAEH,IAAK,CAAC;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMO,EAAE,GAAGP,IAAI,CAACO,EAAE,CAACJ,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMQ,EAAE,GAAGR,IAAI,CAACQ,EAAE,CAACL,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMS,EAAE,GAAGT,IAAI,CAACS,EAAE,CAACN,IAAI,CAAEH,IAAK,CAAC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMU,GAAG,GAAGV,IAAI,CAACU,GAAG,CAACP,IAAI,CAAEH,IAAK,CAAC;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMW,KAAK,GAAGX,IAAI,CAACW,KAAK,CAACR,IAAI,CAAEH,IAAK,CAAC;;AAE5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMY,cAAc,GAAGZ,IAAI,CAACY,cAAc,CAACT,IAAI,CAAEH,IAAK,CAAC","ignoreList":[]}

package/build-module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["sprintf","default","defaultI18n","setLocaleData","resetLocaleData","getLocaleData","subscribe","__","_x","_n","_nx","isRTL","hasTranslation"],"sources":["@wordpress/i18n/src/index.js"],"sourcesContent":["export { sprintf } from './sprintf';\nexport * from './create-i18n';\nexport {\n\tdefault as defaultI18n,\n\tsetLocaleData,\n\tresetLocaleData,\n\tgetLocaleData,\n\tsubscribe,\n\t__,\n\t_x,\n\t_n,\n\t_nx,\n\tisRTL,\n\thasTranslation,\n} from './default-i18n';\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,WAAW;AACnC,cAAc,eAAe;AAC7B,SACCC,OAAO,IAAIC,WAAW,EACtBC,aAAa,EACbC,eAAe,EACfC,aAAa,EACbC,SAAS,EACTC,EAAE,EACFC,EAAE,EACFC,EAAE,EACFC,GAAG,EACHC,KAAK,EACLC,cAAc,QACR,gBAAgB","ignoreList":[]}
+{"version":3,"names":["sprintf","default","defaultI18n","setLocaleData","resetLocaleData","getLocaleData","subscribe","__","_x","_n","_nx","isRTL","hasTranslation"],"sources":["@wordpress/i18n/src/index.ts"],"sourcesContent":["export { sprintf } from './sprintf';\nexport * from './create-i18n';\nexport type * from './types';\nexport {\n\tdefault as defaultI18n,\n\tsetLocaleData,\n\tresetLocaleData,\n\tgetLocaleData,\n\tsubscribe,\n\t__,\n\t_x,\n\t_n,\n\t_nx,\n\tisRTL,\n\thasTranslation,\n} from './default-i18n';\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,WAAW;AACnC,cAAc,eAAe;AAE7B,SACCC,OAAO,IAAIC,WAAW,EACtBC,aAAa,EACbC,eAAe,EACfC,aAAa,EACbC,SAAS,EACTC,EAAE,EACFC,EAAE,EACFC,EAAE,EACFC,GAAG,EACHC,KAAK,EACLC,cAAc,QACR,gBAAgB","ignoreList":[]}

package/build-module/sprintf.js

@@ -1,37 +1,25 @@
 /**
  * External dependencies
  */
-import memoize from 'memize';
-import sprintfjs from 'sprintf-js';
+// Disable reason: `eslint-plugin-import` doesn't support `exports` (https://github.com/import-js/eslint-plugin-import/issues/1810)
+// eslint-disable-next-line import/no-unresolved
+import _sprintf from '@tannin/sprintf';
 
 /**
- * Log to console, once per message; or more precisely, per referentially equal
- * argument set. Because Jed throws errors, we log these to the console instead
- * to avoid crashing the application.
- *
- * @param {...*} args Arguments to pass to `console.error`
+ * Internal dependencies
  */
-const logErrorOnce = memoize(console.error); // eslint-disable-line no-console
 
 /**
- * Returns a formatted string. If an error occurs in applying the format, the
- * original format string is returned.
+ * Returns a formatted string.
  *
- * @param {string} format The format of the string to generate.
- * @param {...*}   args   Arguments to apply to the format.
+ * @param format The format of the string to generate.
+ * @param args   Arguments to apply to the format.
  *
- * @see https://www.npmjs.com/package/sprintf-js
+ * @see https://www.npmjs.com/package/@tannin/sprintf
  *
- * @return {string} The formatted string.
+ * @return The formatted string.
  */
 export function sprintf(format, ...args) {
-  try {
-    return sprintfjs.sprintf(format, ...args);
-  } catch (error) {
-    if (error instanceof Error) {
-      logErrorOnce('sprintf error: \n\n' + error.toString());
-    }
-    return format;
-  }
+  return _sprintf(format, ...args);
 }
 //# sourceMappingURL=sprintf.js.map

package/build-module/sprintf.js.map

@@ -1 +1 @@
-{"version":3,"names":["memoize","sprintfjs","logErrorOnce","console","error","sprintf","format","args","Error","toString"],"sources":["@wordpress/i18n/src/sprintf.js"],"sourcesContent":["/**\n * External dependencies\n */\nimport memoize from 'memize';\nimport sprintfjs from 'sprintf-js';\n\n/**\n * Log to console, once per message; or more precisely, per referentially equal\n * argument set. Because Jed throws errors, we log these to the console instead\n * to avoid crashing the application.\n *\n * @param {...*} args Arguments to pass to `console.error`\n */\nconst logErrorOnce = memoize( console.error ); // eslint-disable-line no-console\n\n/**\n * Returns a formatted string. If an error occurs in applying the format, the\n * original format string is returned.\n *\n * @param {string} format The format of the string to generate.\n * @param {...*}   args   Arguments to apply to the format.\n *\n * @see https://www.npmjs.com/package/sprintf-js\n *\n * @return {string} The formatted string.\n */\nexport function sprintf( format, ...args ) {\n\ttry {\n\t\treturn sprintfjs.sprintf( format, ...args );\n\t} catch ( error ) {\n\t\tif ( error instanceof Error ) {\n\t\t\tlogErrorOnce( 'sprintf error: \\n\\n' + error.toString() );\n\t\t}\n\t\treturn format;\n\t}\n}\n"],"mappings":"AAAA;AACA;AACA;AACA,OAAOA,OAAO,MAAM,QAAQ;AAC5B,OAAOC,SAAS,MAAM,YAAY;;AAElC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,YAAY,GAAGF,OAAO,CAAEG,OAAO,CAACC,KAAM,CAAC,CAAC,CAAC;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CAAEC,MAAM,EAAE,GAAGC,IAAI,EAAG;EAC1C,IAAI;IACH,OAAON,SAAS,CAACI,OAAO,CAAEC,MAAM,EAAE,GAAGC,IAAK,CAAC;EAC5C,CAAC,CAAC,OAAQH,KAAK,EAAG;IACjB,IAAKA,KAAK,YAAYI,KAAK,EAAG;MAC7BN,YAAY,CAAE,qBAAqB,GAAGE,KAAK,CAACK,QAAQ,CAAC,CAAE,CAAC;IACzD;IACA,OAAOH,MAAM;EACd;AACD","ignoreList":[]}
+{"version":3,"names":["_sprintf","sprintf","format","args"],"sources":["@wordpress/i18n/src/sprintf.ts"],"sourcesContent":["/**\n * External dependencies\n */\n// Disable reason: `eslint-plugin-import` doesn't support `exports` (https://github.com/import-js/eslint-plugin-import/issues/1810)\n// eslint-disable-next-line import/no-unresolved\nimport _sprintf from '@tannin/sprintf';\n\n/**\n * Internal dependencies\n */\nimport type { DistributeSprintfArgs, TranslatableText } from './types';\n\nexport function sprintf< T extends string >(\n\tformat: T | TranslatableText< T >,\n\t...args: DistributeSprintfArgs< T >\n): string;\nexport function sprintf< T extends string >(\n\tformat: T | TranslatableText< T >,\n\targs: DistributeSprintfArgs< T >\n): string;\n\n/**\n * Returns a formatted string.\n *\n * @param format The format of the string to generate.\n * @param args   Arguments to apply to the format.\n *\n * @see https://www.npmjs.com/package/@tannin/sprintf\n *\n * @return The formatted string.\n */\nexport function sprintf< T extends string >(\n\tformat: T | TranslatableText< T >,\n\t...args: DistributeSprintfArgs< T >\n): string {\n\treturn _sprintf( format as T, ...( args as DistributeSprintfArgs< T > ) );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA,OAAOA,QAAQ,MAAM,iBAAiB;;AAEtC;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,OAAOA,CACtBC,MAAiC,EACjC,GAAGC,IAAgC,EAC1B;EACT,OAAOH,QAAQ,CAAEE,MAAM,EAAO,GAAKC,IAAqC,CAAC;AAC1E","ignoreList":[]}

package/build-module/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build-module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["@wordpress/i18n/src/types.ts"],"sourcesContent":["/**\n * External dependencies\n */\nimport type sprintf from '@tannin/sprintf';\nimport { type TanninDomainMetadata } from 'tannin';\n\n/**\n * Return type for string translation functions.\n *\n * This type should be treated as if it were `string`.\n */\nexport type TranslatableText< T extends string > = string & {\n\t/**\n\t * DO NOT USE! This property _does not exist_.\n\t * @private\n\t */\n\treadonly __translatableText: T;\n};\n\n/**\n * Type to extends TanninDomainMetadata to support additional properties.\n */\nexport type I18nDomainMetadata< TextDomain extends string > =\n\tTanninDomainMetadata & {\n\t\tdomain?: TextDomain;\n\t\t[ key: string ]: unknown;\n\t};\n\n/**\n * Locale data is a record of domain names to their metadata or translations.\n */\nexport type LocaleData< TextDomain extends string = string > = Record<\n\tstring,\n\tI18nDomainMetadata< TextDomain > | string[]\n>;\n\nexport type SubscribeCallback = () => void;\nexport type UnsubscribeCallback = () => void;\n\n/**\n * Retrieve the domain to use when calling domain-specific filters.\n */\nexport type getFilterDomain = ( domain?: string ) => string;\n\n/**\n * An i18n instance\n */\nexport interface I18n< TextDomain extends string = string > {\n\t/**\n\t * Returns locale data by domain in a\n\t * Jed-formatted JSON object shape.\n\t *\n\t * @see http://messageformat.github.io/Jed/\n\t */\n\tgetLocaleData: ( domain?: TextDomain ) => LocaleData< TextDomain >;\n\n\t/**\n\t * Merges locale data into the Tannin instance by domain. Note that this\n\t * function will overwrite the domain configuration. Accepts data in a\n\t * Jed-formatted JSON object shape.\n\t *\n\t * @see http://messageformat.github.io/Jed/\n\t */\n\tsetLocaleData: (\n\t\tdata?: LocaleData< TextDomain >,\n\t\tdomain?: TextDomain\n\t) => void;\n\n\t/**\n\t * Merges locale data into the Tannin instance by domain. Note that this\n\t * function will also merge the domain configuration. Accepts data in a\n\t * Jed-formatted JSON object shape.\n\t *\n\t * @see http://messageformat.github.io/Jed/\n\t */\n\taddLocaleData: (\n\t\tdata?: LocaleData< TextDomain >,\n\t\tdomain?: TextDomain\n\t) => void;\n\n\t/**\n\t * Resets all current Tannin instance locale data and sets the specified\n\t * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.\n\t *\n\t * @see http://messageformat.github.io/Jed/\n\t */\n\tresetLocaleData: (\n\t\tdata?: LocaleData< TextDomain >,\n\t\tdomain?: TextDomain\n\t) => void;\n\n\t/**\n\t * Subscribes to changes of locale data\n\t */\n\tsubscribe: ( callback: SubscribeCallback ) => UnsubscribeCallback;\n\n\t/**\n\t * Retrieve the translation of text.\n\t *\n\t * @see https://developer.wordpress.org/reference/functions/__/\n\t */\n\t__: < Text extends string >(\n\t\ttext: Text,\n\t\tdomain?: TextDomain\n\t) => TranslatableText< Text >;\n\n\t/**\n\t * Retrieve translated string with gettext context.\n\t *\n\t * @see https://developer.wordpress.org/reference/functions/_x/\n\t */\n\t_x: < Text extends string >(\n\t\ttext: Text,\n\t\tcontext: string,\n\t\tdomain?: TextDomain\n\t) => TranslatableText< Text >;\n\n\t/**\n\t * Translates and retrieves the singular or plural form based on the supplied\n\t * number.\n\t *\n\t * @see https://developer.wordpress.org/reference/functions/_n/\n\t */\n\t_n: < Single extends string, Plural extends string >(\n\t\tsingle: Single,\n\t\tplural: Plural,\n\t\tnumber: number,\n\t\tdomain?: TextDomain\n\t) => TranslatableText< Single | Plural >;\n\n\t/**\n\t * Translates and retrieves the singular or plural form based on the supplied\n\t * number, with gettext context.\n\t *\n\t * @see https://developer.wordpress.org/reference/functions/_nx/\n\t */\n\t_nx: < Single extends string, Plural extends string >(\n\t\tsingle: Single,\n\t\tplural: Plural,\n\t\tnumber: number,\n\t\tcontext: string,\n\t\tdomain?: TextDomain\n\t) => TranslatableText< Single | Plural >;\n\n\t/**\n\t * Check if current locale is RTL.\n\t *\n\t * **RTL (Right To Left)** is a locale property indicating that text is written from right to left.\n\t * For example, the `he` locale (for Hebrew) specifies right-to-left. Arabic (ar) is another common\n\t * language written RTL. The opposite of RTL, LTR (Left To Right) is used in other languages,\n\t * including English (`en`, `en-US`, `en-GB`, etc.), Spanish (`es`), and French (`fr`).\n\t */\n\tisRTL: () => boolean;\n\n\t/**\n\t * Check if there is a translation for a given string in singular form.\n\t */\n\thasTranslation: (\n\t\tsingle: string,\n\t\tcontext?: string,\n\t\tdomain?: TextDomain\n\t) => boolean;\n}\n\nexport type DistributeSprintfArgs< T extends string > = T extends any\n\t? Parameters< typeof sprintf< T > >[ 1 ]\n\t: never;\n"],"mappings":"","ignoreList":[]}

package/build-types/create-i18n.d.ts

@@ -1,123 +1,19 @@
-export function createI18n(initialData?: LocaleData, initialDomain?: string, hooks?: Hooks): I18n;
-export type LocaleData = Record<string, any>;
 /**
- * Returns locale data by domain in a
- * Jed-formatted JSON object shape.
+ * Internal dependencies
  */
-export type GetLocaleData = (domain?: string) => LocaleData;
+import type { I18n, LocaleData } from './types';
 /**
- * Merges locale data into the Tannin instance by domain. Note that this
- * function will overwrite the domain configuration. Accepts data in a
- * Jed-formatted JSON object shape.
+ * WordPress dependencies
  */
-export type SetLocaleData = (data?: LocaleData, domain?: string) => void;
+import type { Hooks } from '@wordpress/hooks';
 /**
- * Merges locale data into the Tannin instance by domain. Note that this
- * function will also merge the domain configuration. Accepts data in a
- * Jed-formatted JSON object shape.
- */
-export type AddLocaleData = (data?: LocaleData, domain?: string) => void;
-/**
- * Resets all current Tannin instance locale data and sets the specified
- * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.
- */
-export type ResetLocaleData = (data?: LocaleData, domain?: string) => void;
-export type SubscribeCallback = () => void;
-export type UnsubscribeCallback = () => void;
-/**
- * Subscribes to changes of locale data
- */
-export type Subscribe = (callback: SubscribeCallback) => UnsubscribeCallback;
-/**
- * Retrieve the domain to use when calling domain-specific filters.
- */
-export type GetFilterDomain = (domain?: string) => string;
-/**
- * Retrieve the translation of text.
- */
-export type __ = (text: string, domain?: string) => string;
-/**
- * Retrieve translated string with gettext context.
- */
-export type _x = (text: string, context: string, domain?: string) => string;
-/**
- * Translates and retrieves the singular or plural form based on the supplied
- * number.
- */
-export type _n = (single: string, plural: string, number: number, domain?: string) => string;
-/**
- * Translates and retrieves the singular or plural form based on the supplied
- * number, with gettext context.
- */
-export type _nx = (single: string, plural: string, number: number, context: string, domain?: string) => string;
-/**
- * Check if current locale is RTL.
+ * Create an i18n instance
  *
- * **RTL (Right To Left)** is a locale property indicating that text is written from right to left.
- * For example, the `he` locale (for Hebrew) specifies right-to-left. Arabic (ar) is another common
- * language written RTL. The opposite of RTL, LTR (Left To Right) is used in other languages,
- * including English (`en`, `en-US`, `en-GB`, etc.), Spanish (`es`), and French (`fr`).
- */
-export type IsRtl = () => boolean;
-/**
- * Check if there is a translation for a given string in singular form.
- */
-export type HasTranslation = (single: string, context?: string, domain?: string) => boolean;
-export type Hooks = import("@wordpress/hooks").Hooks;
-/**
- * An i18n instance
+ * @param [initialData]   Locale data configuration.
+ * @param [initialDomain] Domain for which configuration applies.
+ * @param [hooks]         Hooks implementation.
+ *
+ * @return I18n instance.
  */
-export type I18n = {
-    /**
-     * Returns locale data by domain in a Jed-formatted JSON object shape.
-     */
-    getLocaleData: GetLocaleData;
-    /**
-     * Merges locale data into the Tannin instance by domain. Note that this
-     * function will overwrite the domain configuration. Accepts data in a
-     * Jed-formatted JSON object shape.
-     */
-    setLocaleData: SetLocaleData;
-    /**
-     * Merges locale data into the Tannin instance by domain. Note that this
-     * function will also merge the domain configuration. Accepts data in a
-     * Jed-formatted JSON object shape.
-     */
-    addLocaleData: AddLocaleData;
-    /**
-     * Resets all current Tannin instance locale data and sets the specified
-     * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.
-     */
-    resetLocaleData: ResetLocaleData;
-    /**
-     * Subscribes to changes of Tannin locale data.
-     */
-    subscribe: Subscribe;
-    /**
-     * Retrieve the translation of text.
-     */
-    __: __;
-    /**
-     * Retrieve translated string with gettext context.
-     */
-    _x: _x;
-    /**
-     * Translates and retrieves the singular or plural form based on the supplied
-     * number.
-     */
-    _n: _n;
-    /**
-     * Translates and retrieves the singular or plural form based on the supplied
-     * number, with gettext context.
-     */
-    _nx: _nx;
-    /**
-     * Check if current locale is RTL.
-     */
-    isRTL: IsRtl;
-    /**
-     * Check if there is a translation for a given string.
-     */
-    hasTranslation: HasTranslation;
-};
+export declare const createI18n: <TextDomain extends string>(initialData?: LocaleData<TextDomain>, initialDomain?: TextDomain, hooks?: Hooks) => I18n<TextDomain>;
 //# sourceMappingURL=create-i18n.d.ts.map

package/build-types/create-i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-i18n.d.ts","sourceRoot":"","sources":["../src/create-i18n.js"],"names":[],"mappings":"AA2JO,yCANI,UAAU,kBACV,MAAM,UACN,KAAK,GAEJ,IAAI,CAgWf;yBAnfY,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC;;;;;4BAyBlB,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,UAAU;;;;;;4BAQ/B,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI;;;;;;4BAS5C,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI;;;;;8BAS5C,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI;gCAO3C,MAAM,IAAI;kCACV,MAAM,IAAI;;;;wBAEX,CAAC,QAAQ,EAAE,iBAAiB,KAAK,mBAAmB;;;;8BAKpD,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM;;;;iBAI3B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM;;;;iBAOzC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM;;;;;iBAO1D,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM;;;;;kBAQ3E,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM;;;;;;;;;oBAQ5F,MAAM,OAAO;;;;6BAUb,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO;oBAI7D,OAAO,kBAAkB,EAAE,KAAK;;;;;;;;mBAMhC,aAAa;;;;;;mBACb,aAAa;;;;;;mBAGb,aAAa;;;;;qBAGb,eAAe;;;;eAEf,SAAS;;;;QACT,EAAE;;;;QACF,EAAE;;;;;QACF,EAAE;;;;;SAEF,GAAG;;;;WAEH,KAAK;;;;oBACL,cAAc"}
+{"version":3,"file":"create-i18n.d.ts","sourceRoot":"","sources":["../src/create-i18n.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAEX,IAAI,EACJ,UAAU,EAIV,MAAM,SAAS,CAAC;AACjB;;GAEG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAmB9C;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GAAK,UAAU,SAAS,MAAM,gBACtC,UAAU,CAAE,UAAU,CAAE,kBACtB,UAAU,UAClB,KAAK,KACX,IAAI,CAAE,UAAU,CAiWlB,CAAC"}

package/build-types/default-i18n.d.ts

@@ -1,99 +1,110 @@
-export default i18n;
+import { LocaleData, SubscribeCallback, TranslatableText, UnsubscribeCallback } from './types';
+declare const i18n: import("./types").I18n<string>;
 /**
- * @typedef {import('./create-i18n').LocaleData} LocaleData
- * @typedef {import('./create-i18n').SubscribeCallback} SubscribeCallback
- * @typedef {import('./create-i18n').UnsubscribeCallback} UnsubscribeCallback
+ * Default, singleton instance of `I18n`.
  */
+export default i18n;
 /**
  * Returns locale data by domain in a Jed-formatted JSON object shape.
  *
  * @see http://messageformat.github.io/Jed/
  *
- * @param {string} [domain] Domain for which to get the data.
- * @return {LocaleData} Locale data.
+ * @param { string | undefined } [domain] Domain for which to get the data.
+ * @return { LocaleData } Locale data.
  */
-export const getLocaleData: import("./create-i18n").GetLocaleData;
+export declare const getLocaleData: (domain?: string | undefined) => LocaleData<string>;
 /**
  * Merges locale data into the Tannin instance by domain. Accepts data in a
  * Jed-formatted JSON object shape.
  *
  * @see http://messageformat.github.io/Jed/
  *
- * @param {LocaleData} [data]   Locale data configuration.
- * @param {string}     [domain] Domain for which configuration applies.
+ * @param {LocaleData }        [data]   Locale data configuration.
+ * @param {string | undefined} [domain] Domain for which configuration applies.
  */
-export const setLocaleData: import("./create-i18n").SetLocaleData;
+export declare const setLocaleData: (data?: LocaleData<string> | undefined, domain?: string | undefined) => void;
 /**
  * Resets all current Tannin instance locale data and sets the specified
  * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.
  *
  * @see http://messageformat.github.io/Jed/
  *
- * @param {LocaleData} [data]   Locale data configuration.
- * @param {string}     [domain] Domain for which configuration applies.
+ * @param {LocaleData}         [data]   Locale data configuration.
+ * @param {string | undefined} [domain] Domain for which configuration applies.
  */
-export const resetLocaleData: import("./create-i18n").ResetLocaleData;
+export declare const resetLocaleData: (data?: LocaleData<string> | undefined, domain?: string | undefined) => void;
 /**
  * Subscribes to changes of locale data
  *
  * @param {SubscribeCallback} callback Subscription callback
  * @return {UnsubscribeCallback} Unsubscribe callback
  */
-export const subscribe: import("./create-i18n").Subscribe;
+export declare const subscribe: (callback: SubscribeCallback) => UnsubscribeCallback;
 /**
  * Retrieve the translation of text.
  *
  * @see https://developer.wordpress.org/reference/functions/__/
  *
- * @param {string} text     Text to translate.
- * @param {string} [domain] Domain to retrieve the translated text.
+ * @template {string} Text
  *
- * @return {string} Translated text.
+ * @param {Text}               text   Text to translate.
+ * @param {string | undefined} domain Domain to retrieve the translated text.
+ *
+ * @return {TranslatableText<Text>} Translated text.
  */
-export const __: import("./create-i18n").__;
+export declare const __: <Text extends string>(text: Text, domain?: string | undefined) => TranslatableText<Text>;
 /**
  * Retrieve translated string with gettext context.
  *
  * @see https://developer.wordpress.org/reference/functions/_x/
  *
- * @param {string} text     Text to translate.
- * @param {string} context  Context information for the translators.
- * @param {string} [domain] Domain to retrieve the translated text.
+ * @template {string} Text
+ *
+ * @param {Text}               text    Text to translate.
+ * @param {string}             context Context information for the translators.
+ * @param {string | undefined} domain  Domain to retrieve the translated text.
  *
- * @return {string} Translated context string without pipe.
+ * @return {TranslatableText<Text>} Translated context string without pipe.
  */
-export const _x: import("./create-i18n")._x;
+export declare const _x: <Text extends string>(text: Text, context: string, domain?: string | undefined) => TranslatableText<Text>;
 /**
  * Translates and retrieves the singular or plural form based on the supplied
  * number.
  *
  * @see https://developer.wordpress.org/reference/functions/_n/
  *
- * @param {string} single   The text to be used if the number is singular.
- * @param {string} plural   The text to be used if the number is plural.
- * @param {number} number   The number to compare against to use either the
- *                          singular or plural form.
- * @param {string} [domain] Domain to retrieve the translated text.
+ * @template {string} Single
+ * @template {string} Plural
  *
- * @return {string} The translated singular or plural form.
+ * @param {Single}             single The text to be used if the number is singular.
+ * @param {Plural}             plural The text to be used if the number is plural.
+ * @param {number}             number The number to compare against to use either the
+ *                                    singular or plural form.
+ * @param {string | undefined} domain Domain to retrieve the translated text.
+ *
+ * @return {TranslatableText<Single | Plural>} The translated singular or plural form.
  */
-export const _n: import("./create-i18n")._n;
+export declare const _n: <Single extends string, Plural extends string>(single: Single, plural: Plural, number: number, domain?: string | undefined) => TranslatableText<Single | Plural>;
 /**
  * Translates and retrieves the singular or plural form based on the supplied
  * number, with gettext context.
  *
  * @see https://developer.wordpress.org/reference/functions/_nx/
  *
- * @param {string} single   The text to be used if the number is singular.
- * @param {string} plural   The text to be used if the number is plural.
- * @param {number} number   The number to compare against to use either the
- *                          singular or plural form.
- * @param {string} context  Context information for the translators.
- * @param {string} [domain] Domain to retrieve the translated text.
+ * @template {string} Single
+ * @template {string} Plural
+ * @param {Single}             single   The text to be used if the number is singular.
+ *
+ * @param {Single}             single   The text to be used if the number is singular.
+ * @param {Plural}             plural   The text to be used if the number is plural.
+ * @param {number}             number   The number to compare against to use either the
+ *                                      singular or plural form.
+ * @param {string}             context  Context information for the translators.
+ * @param {string | undefined} [domain] Domain to retrieve the translated text.
  *
- * @return {string} The translated singular or plural form.
+ * @return {TranslatableText<Single | Plural>} The translated singular or plural form.
  */
-export const _nx: import("./create-i18n")._nx;
+export declare const _nx: <Single extends string, Plural extends string>(single: Single, plural: Plural, number: number, context: string, domain?: string | undefined) => TranslatableText<Single | Plural>;
 /**
  * Check if current locale is RTL.
  *
@@ -104,18 +115,15 @@ export const _nx: import("./create-i18n")._nx;
  *
  * @return {boolean} Whether locale is RTL.
  */
-export const isRTL: import("./create-i18n").IsRtl;
+export declare const isRTL: () => boolean;
 /**
  * Check if there is a translation for a given string (in singular form).
  *
- * @param {string} single    Singular form of the string to look up.
- * @param {string} [context] Context information for the translators.
- * @param {string} [domain]  Domain to retrieve the translated text.
+ * @param {string} single  Singular form of the string to look up.
+ * @param {string} context Context information for the translators.
+ * @param {string} domain  Domain to retrieve the translated text.
+ *
  * @return {boolean} Whether the translation exists or not.
  */
-export const hasTranslation: import("./create-i18n").HasTranslation;
-export type LocaleData = import("./create-i18n").LocaleData;
-export type SubscribeCallback = import("./create-i18n").SubscribeCallback;
-export type UnsubscribeCallback = import("./create-i18n").UnsubscribeCallback;
-declare const i18n: import("./create-i18n").I18n;
+export declare const hasTranslation: (single: string, context?: string, domain?: string | undefined) => boolean;
 //# sourceMappingURL=default-i18n.d.ts.map

package/build-types/default-i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-i18n.d.ts","sourceRoot":"","sources":["../src/default-i18n.js"],"names":[],"mappings":";AAsBA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,kEAA6D;AAE7D;;;;;;;;GAQG;AACH,kEAA6D;AAE7D;;;;;;;;GAQG;AACH,sEAAiE;AAEjE;;;;;GAKG;AACH,0DAAqD;AAErD;;;;;;;;;GASG;AACH,4CAAuC;AAEvC;;;;;;;;;;GAUG;AACH,4CAAuC;AAEvC;;;;;;;;;;;;;GAaG;AACH,4CAAuC;AAEvC;;;;;;;;;;;;;;GAcG;AACH,8CAAyC;AAEzC;;;;;;;;;GASG;AACH,kDAA6C;AAE7C;;;;;;;GAOG;AACH,oEAA+D;yBA3HlD,OAAO,eAAe,EAAE,UAAU;gCAClC,OAAO,eAAe,EAAE,iBAAiB;kCACzC,OAAO,eAAe,EAAE,mBAAmB;AAfxD,iDAA8D"}
+{"version":3,"file":"default-i18n.d.ts","sourceRoot":"","sources":["../src/default-i18n.ts"],"names":[],"mappings":"AASA,OAAO,EACN,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAEjB,QAAA,MAAM,IAAI,gCAAmD,CAAC;AAE9D;;GAEG;AACH,eAAe,IAAI,CAAC;AAOpB;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,qDAAkC,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,8EAAkC,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,8EAAoC,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,SAAS,sDAA8B,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,EAAE,0FAAuB,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,EAAE,2GAAuB,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,EAAE,kKAAuB,CAAC;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,GAAG,mLAAwB,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK,eAA0B,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,4EAAmC,CAAC"}

package/build-types/index.d.ts

@@ -1,4 +1,5 @@
-export { sprintf } from "./sprintf";
-export * from "./create-i18n";
-export { default as defaultI18n, setLocaleData, resetLocaleData, getLocaleData, subscribe, __, _x, _n, _nx, isRTL, hasTranslation } from "./default-i18n";
+export { sprintf } from './sprintf';
+export * from './create-i18n';
+export type * from './types';
+export { default as defaultI18n, setLocaleData, resetLocaleData, getLocaleData, subscribe, __, _x, _n, _nx, isRTL, hasTranslation, } from './default-i18n';
 //# sourceMappingURL=index.d.ts.map

package/build-types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,mBAAmB,SAAS,CAAC;AAC7B,OAAO,EACN,OAAO,IAAI,WAAW,EACtB,aAAa,EACb,eAAe,EACf,aAAa,EACb,SAAS,EACT,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,KAAK,EACL,cAAc,GACd,MAAM,gBAAgB,CAAC"}

package/build-types/sprintf.d.ts

@@ -1,13 +1,7 @@
 /**
- * Returns a formatted string. If an error occurs in applying the format, the
- * original format string is returned.
- *
- * @param {string} format The format of the string to generate.
- * @param {...*}   args   Arguments to apply to the format.
- *
- * @see https://www.npmjs.com/package/sprintf-js
- *
- * @return {string} The formatted string.
+ * Internal dependencies
  */
-export function sprintf(format: string, ...args: any[]): string;
+import type { DistributeSprintfArgs, TranslatableText } from './types';
+export declare function sprintf<T extends string>(format: T | TranslatableText<T>, ...args: DistributeSprintfArgs<T>): string;
+export declare function sprintf<T extends string>(format: T | TranslatableText<T>, args: DistributeSprintfArgs<T>): string;
 //# sourceMappingURL=sprintf.d.ts.map

package/build-types/sprintf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprintf.d.ts","sourceRoot":"","sources":["../src/sprintf.js"],"names":[],"mappings":"AAeA;;;;;;;;;;GAUG;AACH,gCAPW,MAAM,WACH,GAAC,EAAA,GAIH,MAAM,CAWjB"}
+{"version":3,"file":"sprintf.d.ts","sourceRoot":"","sources":["../src/sprintf.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvE,wBAAgB,OAAO,CAAE,CAAC,SAAS,MAAM,EACxC,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAE,CAAC,CAAE,EACjC,GAAG,IAAI,EAAE,qBAAqB,CAAE,CAAC,CAAE,GACjC,MAAM,CAAC;AACV,wBAAgB,OAAO,CAAE,CAAC,SAAS,MAAM,EACxC,MAAM,EAAE,CAAC,GAAG,gBAAgB,CAAE,CAAC,CAAE,EACjC,IAAI,EAAE,qBAAqB,CAAE,CAAC,CAAE,GAC9B,MAAM,CAAC"}

package/build-types/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * External dependencies
+ */
+import type sprintf from '@tannin/sprintf';
+import { type TanninDomainMetadata } from 'tannin';
+/**
+ * Return type for string translation functions.
+ *
+ * This type should be treated as if it were `string`.
+ */
+export type TranslatableText<T extends string> = string & {
+    /**
+     * DO NOT USE! This property _does not exist_.
+     * @private
+     */
+    readonly __translatableText: T;
+};
+/**
+ * Type to extends TanninDomainMetadata to support additional properties.
+ */
+export type I18nDomainMetadata<TextDomain extends string> = TanninDomainMetadata & {
+    domain?: TextDomain;
+    [key: string]: unknown;
+};
+/**
+ * Locale data is a record of domain names to their metadata or translations.
+ */
+export type LocaleData<TextDomain extends string = string> = Record<string, I18nDomainMetadata<TextDomain> | string[]>;
+export type SubscribeCallback = () => void;
+export type UnsubscribeCallback = () => void;
+/**
+ * Retrieve the domain to use when calling domain-specific filters.
+ */
+export type getFilterDomain = (domain?: string) => string;
+/**
+ * An i18n instance
+ */
+export interface I18n<TextDomain extends string = string> {
+    /**
+     * Returns locale data by domain in a
+     * Jed-formatted JSON object shape.
+     *
+     * @see http://messageformat.github.io/Jed/
+     */
+    getLocaleData: (domain?: TextDomain) => LocaleData<TextDomain>;
+    /**
+     * Merges locale data into the Tannin instance by domain. Note that this
+     * function will overwrite the domain configuration. Accepts data in a
+     * Jed-formatted JSON object shape.
+     *
+     * @see http://messageformat.github.io/Jed/
+     */
+    setLocaleData: (data?: LocaleData<TextDomain>, domain?: TextDomain) => void;
+    /**
+     * Merges locale data into the Tannin instance by domain. Note that this
+     * function will also merge the domain configuration. Accepts data in a
+     * Jed-formatted JSON object shape.
+     *
+     * @see http://messageformat.github.io/Jed/
+     */
+    addLocaleData: (data?: LocaleData<TextDomain>, domain?: TextDomain) => void;
+    /**
+     * Resets all current Tannin instance locale data and sets the specified
+     * locale data for the domain. Accepts data in a Jed-formatted JSON object shape.
+     *
+     * @see http://messageformat.github.io/Jed/
+     */
+    resetLocaleData: (data?: LocaleData<TextDomain>, domain?: TextDomain) => void;
+    /**
+     * Subscribes to changes of locale data
+     */
+    subscribe: (callback: SubscribeCallback) => UnsubscribeCallback;
+    /**
+     * Retrieve the translation of text.
+     *
+     * @see https://developer.wordpress.org/reference/functions/__/
+     */
+    __: <Text extends string>(text: Text, domain?: TextDomain) => TranslatableText<Text>;
+    /**
+     * Retrieve translated string with gettext context.
+     *
+     * @see https://developer.wordpress.org/reference/functions/_x/
+     */
+    _x: <Text extends string>(text: Text, context: string, domain?: TextDomain) => TranslatableText<Text>;
+    /**
+     * Translates and retrieves the singular or plural form based on the supplied
+     * number.
+     *
+     * @see https://developer.wordpress.org/reference/functions/_n/
+     */
+    _n: <Single extends string, Plural extends string>(single: Single, plural: Plural, number: number, domain?: TextDomain) => TranslatableText<Single | Plural>;
+    /**
+     * Translates and retrieves the singular or plural form based on the supplied
+     * number, with gettext context.
+     *
+     * @see https://developer.wordpress.org/reference/functions/_nx/
+     */
+    _nx: <Single extends string, Plural extends string>(single: Single, plural: Plural, number: number, context: string, domain?: TextDomain) => TranslatableText<Single | Plural>;
+    /**
+     * Check if current locale is RTL.
+     *
+     * **RTL (Right To Left)** is a locale property indicating that text is written from right to left.
+     * For example, the `he` locale (for Hebrew) specifies right-to-left. Arabic (ar) is another common
+     * language written RTL. The opposite of RTL, LTR (Left To Right) is used in other languages,
+     * including English (`en`, `en-US`, `en-GB`, etc.), Spanish (`es`), and French (`fr`).
+     */
+    isRTL: () => boolean;
+    /**
+     * Check if there is a translation for a given string in singular form.
+     */
+    hasTranslation: (single: string, context?: string, domain?: TextDomain) => boolean;
+}
+export type DistributeSprintfArgs<T extends string> = T extends any ? Parameters<typeof sprintf<T>>[1] : never;
+//# sourceMappingURL=types.d.ts.map

package/build-types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}