@lingui/core 6.6.0 → 6.7.0

package/README.md

@@ -4,23 +4,46 @@
 
 # @lingui/core
 
-> Internationalization API for JavaScript apps
+> The Lingui i18n runtime: loads compiled message catalogs, tracks the active locale and formats ICU MessageFormat messages
 
-`@lingui/core` is part of [LinguiJS][linguijs]. See the [documentation][documentation] for all information, tutorials and examples.
+`@lingui/core` is part of [Lingui][documentation]. Lingui is a lightweight, open-source internationalization (i18n) library for JavaScript and TypeScript. It brings compile-time macros and a CLI for message extraction to React, React Native, Vue, SolidJS, Astro, Svelte, and Node.js.
 
-## Installation & Usage
+The package is framework-agnostic and behaves the same in the browser, in Node.js and inside any UI framework. `@lingui/core` exports the `i18n` instance, which loads catalogs, activates a locale and translates messages. `@lingui/core/macro` exports the `t`, `plural`, `select` and related macros, which are compiled into ICU messages at build time and need the [Babel][babel-plugin] or [SWC][swc-plugin] plugin.
 
-See the [tutorial][tutorial] or [reference][reference] documentation.
+## Usage
+
+```js
+import { i18n } from "@lingui/core"
+import { t } from "@lingui/core/macro"
+import { messages } from "./locales/cs/messages"
+
+i18n.load("cs", messages)
+i18n.activate("cs")
+
+function greeting(name) {
+  return t`Hello ${name}`
+}
+
+greeting("Fred") // "Ahoj Fred"
+```
+
+The `messages` module is produced by `lingui extract` and `lingui compile` from [`@lingui/cli`][cli]. Catalogs are compiled ahead of time, so the runtime ships without a MessageFormat parser.
+
+The [JavaScript tutorial][tutorial] walks through this setup. React projects use [`@lingui/react`][react] on top of this package. See the [core reference][reference] and the [macro reference][macro] for the full API.
 
 ## License
 
-This package is licensed under [MIT][license] license.
+This package is licensed under the [MIT][license] license.
 
 [license]: https://github.com/lingui/js-lingui/blob/main/LICENSE
-[linguijs]: https://github.com/lingui/js-lingui
 [documentation]: https://lingui.dev
 [tutorial]: https://lingui.dev/tutorials/javascript
 [reference]: https://lingui.dev/ref/core
+[macro]: https://lingui.dev/ref/macro
+[cli]: https://www.npmjs.com/package/@lingui/cli
+[react]: https://www.npmjs.com/package/@lingui/react
+[babel-plugin]: https://lingui.dev/installation#choosing-a-transpiler
+[swc-plugin]: https://lingui.dev/ref/swc-plugin
 [package]: https://www.npmjs.com/package/@lingui/core
 [badge-downloads]: https://img.shields.io/npm/dw/@lingui/core.svg
 [badge-version]: https://img.shields.io/npm/v/@lingui/core.svg

package/dist/index.mjs

@@ -156,7 +156,12 @@ const getDefaultFormats = (locale, passedLocales, formats = {}) => {
     time: (value, format) => time(locales, value, style(format) || format)
   };
 };
-const selectFormatter = (value, rules) => rules[value] ?? rules.other;
+const selectFormatter = (value, rules) => (
+  // Own-property check so a runtime value like "constructor" or "toString"
+  // falls back to the `other` branch instead of resolving to a member
+  // inherited from Object.prototype.
+  (Object.prototype.hasOwnProperty.call(rules, value) ? rules[value] : void 0) ?? rules.other
+);
 function interpolate(translation, locale, locales) {
   return (values = {}, formats) => {
     const formatters = getDefaultFormats(locale, locales, formats);
@@ -274,7 +279,10 @@ class I18n extends EventEmitter {
     return this;
   }
   _load(locale, messages) {
-    const maybeMessages = this._messages[locale];
+    const maybeMessages = Object.prototype.hasOwnProperty.call(
+      this._messages,
+      locale
+    ) ? this._messages[locale] : void 0;
     if (!maybeMessages) {
       this._messages[locale] = messages;
     } else {
@@ -325,7 +333,8 @@ class I18n extends EventEmitter {
       message = id.message;
       id = id.id;
     }
-    const messageForId = this.messages[id];
+    const messages = this.messages;
+    const messageForId = Object.prototype.hasOwnProperty.call(messages, id) ? messages[id] : void 0;
     const messageMissing = messageForId === void 0;
     const missing = this._missing;
     if (missing && messageMissing) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@lingui/core",
-  "version": "6.6.0",
+  "version": "6.7.0",
   "sideEffects": false,
-  "description": "Internationalization (i18n) tools for JavaScript",
+  "description": "The Lingui i18n runtime: loads compiled message catalogs, tracks the active locale and formats ICU MessageFormat messages",
   "type": "module",
   "author": {
     "name": "Tomáš Ehrlich",
@@ -55,8 +55,8 @@
     "macro/index.mjs"
   ],
   "dependencies": {
-    "@lingui/babel-plugin-lingui-macro": "6.6.0",
-    "@lingui/message-utils": "6.6.0"
+    "@lingui/babel-plugin-lingui-macro": "6.7.0",
+    "@lingui/message-utils": "6.7.0"
   },
   "devDependencies": {
     "@lingui/test-utils": "3.0.3",
@@ -75,5 +75,5 @@
   "unbuild": {
     "declaration": "node16"
   },
-  "gitHead": "665a19815378dedd89346bb7707bdb0e28df79e7"
+  "gitHead": "a2d4b6d42e052fed1d432050b20cc56cfdacfe98"
 }