i18n.js 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171
  1. import { escapeText } from './util.js';
  2. import { createRequire } from 'module';
  3. const require = createRequire(import.meta.url);
  4. const {defaultSettings} = require('../util/default.json');
  5. const i18n = require('./i18n/allLangs.json');
  6. Object.keys(i18n.allLangs.names).forEach( lang => i18n[lang] = require('./i18n/' + lang + '.json') );
  7. /**
  8. * A language.
  9. * @class
  10. */
  11. export default class Lang {
  12. /**
  13. * Creates a new language.
  14. * @param {String[]} [langs] - The language code.
  15. * @constructs Lang
  16. */
  17. constructor(...langs) {
  18. this.lang = ( langs.filter( lang => {
  19. if ( typeof lang !== 'string' ) return false;
  20. return i18n.allLangs.map.hasOwnProperty(lang.toLowerCase());
  21. } ).map( lang => {
  22. return i18n.allLangs.map[lang.toLowerCase()];
  23. } )[0] || defaultSettings.lang );
  24. this.fallback = ( i18n?.[this.lang]?.fallback.slice() || [defaultSettings.lang] ).filter( fb => fb.trim() );
  25. this.fromCookie = [];
  26. }
  27. /**
  28. * Get a localized message.
  29. * @param {String} message - Name of the message.
  30. * @param {Boolean} escaped - If the message should be HTML escaped.
  31. * @param {(String|import('cheerio').default)[]} args - Arguments for the message.
  32. * @returns {String}
  33. */
  34. get(message = '', escaped = false, ...args) {
  35. let keys = ( message.length ? message.split('.') : [] );
  36. let lang = this.lang;
  37. let text = i18n?.[lang];
  38. let fallback = 0;
  39. for ( let n = 0; n < keys.length; n++ ) {
  40. if ( text ) {
  41. text = text?.[keys[n]];
  42. if ( typeof text === 'string' ) text = text.trim();
  43. }
  44. if ( !text ) {
  45. if ( fallback < this.fallback.length ) {
  46. lang = this.fallback[fallback];
  47. fallback++;
  48. text = i18n?.[lang];
  49. n = -1;
  50. }
  51. else {
  52. n = keys.length;
  53. }
  54. }
  55. }
  56. if ( typeof text === 'string' ) {
  57. if ( escaped ) text = escapeText(text);
  58. args.forEach( (arg, i) => {
  59. if ( escaped && typeof arg !== 'string' ) {
  60. text = text.replaceSave( new RegExp( `\\[([^\\]]+)\\]\\(\\$${i + 1}\\)`, 'g' ), (m, linkText) => {
  61. return arg.html(linkText);
  62. } );
  63. }
  64. text = text.replaceSave( new RegExp( `\\$${i + 1}`, 'g' ), arg );
  65. } );
  66. if ( text.includes( 'PLURAL:' ) ) text = text.replace( /{{\s*PLURAL:\s*[+-]?(\d+)\s*\|\s*([^\{\}]*?)\s*}}/g, (m, number, cases) => {
  67. return plural(lang, parseInt(number, 10), cases.split(/\s*\|\s*/));
  68. } );
  69. }
  70. return ( text || '⧼' + message + ( isDebug && args.length ? ': ' + args.join(', ') : '' ) + '⧽' );
  71. }
  72. /**
  73. * Get a localized message with all fallback languages.
  74. * @param {String} message - Name of the message.
  75. * @returns {Object[]}
  76. */
  77. getWithFallback(message = '') {
  78. return [this.lang, ...this.fallback].map( lang => {
  79. let keys = ( message.length ? message.split('.') : [] );
  80. let text = i18n?.[lang];
  81. for ( let n = 0; n < keys.length; n++ ) {
  82. if ( text ) text = text?.[keys[n]];
  83. if ( !text ) n = keys.length;
  84. }
  85. return text;
  86. } );
  87. }
  88. /**
  89. * Get names for all languages.
  90. * @static
  91. */
  92. static allLangs() {
  93. return i18n.allLangs;
  94. }
  95. }
  96. /**
  97. * Parse plural text.
  98. * @param {String} lang - The language code.
  99. * @param {Number} number - The amount.
  100. * @param {String[]} args - The possible text.
  101. * @returns {String}
  102. */
  103. function plural(lang, number, args) {
  104. // https://translatewiki.net/wiki/Plural/Mediawiki_plural_rules
  105. var text = args[args.length - 1];
  106. switch ( lang ) {
  107. case 'fr':
  108. case 'hi':
  109. if ( number <= 1 ) text = getArg(args, 0);
  110. else text = getArg(args, 1);
  111. break;
  112. case 'pl':
  113. if ( number === 1 ) text = getArg(args, 0);
  114. else if ( [2,3,4].includes( number % 10 ) && ![12,13,14].includes( number % 100 ) ) {
  115. text = getArg(args, 1);
  116. }
  117. else text = getArg(args, 2);
  118. break;
  119. case 'ru':
  120. case 'sr':
  121. case 'uk':
  122. if ( args.length > 2 ) {
  123. if ( number % 10 === 1 && number % 100 !== 11 ) text = getArg(args, 0);
  124. else if ( [2,3,4].includes( number % 10 ) && ![12,13,14].includes( number % 100 ) ) {
  125. text = getArg(args, 1);
  126. }
  127. else text = getArg(args, 2);
  128. }
  129. else {
  130. if ( number === 1 ) text = getArg(args, 0);
  131. else text = getArg(args, 1);
  132. }
  133. break;
  134. case 'bn':
  135. case 'de':
  136. case 'en':
  137. case 'es':
  138. case 'it':
  139. case 'ja':
  140. case 'ko':
  141. case 'nl':
  142. case 'pt-br':
  143. case 'th':
  144. case 'sv':
  145. case 'tr':
  146. case 'vi':
  147. case 'zh-hans':
  148. case 'zh-hant':
  149. default:
  150. if ( number === 1 ) text = getArg(args, 0);
  151. else text = getArg(args, 1);
  152. }
  153. return text;
  154. }
  155. /**
  156. * Get text option.
  157. * @param {String[]} args - The list of options.
  158. * @param {Number} index - The preferred option.
  159. * @returns {String}
  160. */
  161. function getArg(args, index) {
  162. return ( args.length > index ? args[index] : args[args.length - 1] );
  163. }
  164. export const allLangs = Lang.allLangs;