@mrmeg/expo-ui 0.1.4 → 0.1.5

package/LLM_USAGE.md

@@ -70,8 +70,9 @@ export function RootLayout() {
 
 i18n is optional. Do not add app-level i18n setup just to use this package.
 Plain children and `text` props work without `i18next` or `react-i18next`.
-`tx` props render the key until the consumer opts in with a package-local
-translator:
+`tx` props render fallback text when provided and otherwise render the key
+until the consumer opts in with a package-local translator. Package-owned
+defaults such as notification titles stay human-readable without app i18n:
 
 ```tsx
 import { configureExpoUiI18n } from "@mrmeg/expo-ui/lib";

package/README.md

@@ -116,9 +116,10 @@ Useful `StyledText` props:
 - `variant`: `sansSerif`, `serif`
 - `align`, `tx`, `txOptions`
 
-`tx` support is opt-in. Without a configured translator, `tx` renders the key
-and `text` renders as provided. Consumers that already use i18n can connect it
-once near app startup:
+`tx` support is opt-in. Without a configured translator, `tx` renders its
+fallback text when provided and otherwise renders the key; package-owned
+defaults such as notification titles use readable fallback text. Consumers
+that already use i18n can connect it once near app startup:
 
 ```tsx
 import { configureExpoUiI18n } from "@mrmeg/expo-ui/lib";

package/dist/components/Button.d.ts

@@ -20,7 +20,7 @@ export interface ButtonProps extends PressableProps {
      */
     tx?: TextProps["tx"];
     /**
-     * The text to display if not using `tx` or nested components.
+     * The text to display directly, or as fallback text when `tx` is provided.
      */
     text?: TextProps["text"];
     /**

package/dist/components/Notification.js

@@ -139,11 +139,11 @@ export const Notification = () => {
             return alert.title;
         switch (alert?.type) {
             case "error":
-                return translateText("notification.error");
+                return translateText("notification.error", "Error");
             case "success":
-                return translateText("notification.success");
+                return translateText("notification.success", "Success");
             case "warning":
-                return translateText("notification.warning");
+                return translateText("notification.warning", "Warning");
             case "info":
                 return "";
             default:

package/dist/components/StyledText.d.ts

@@ -53,7 +53,7 @@ export type TextProps = RNTextProps & {
      */
     tx?: string;
     /**
-     * The text to display if not using `tx` or nested components.
+     * The text to display directly, or as fallback text when `tx` is provided.
      */
     text?: string;
     /**
@@ -101,7 +101,7 @@ export declare const StyledText: React.ForwardRefExoticComponent<RNTextProps & {
      */
     tx?: string;
     /**
-     * The text to display if not using `tx` or nested components.
+     * The text to display directly, or as fallback text when `tx` is provided.
      */
     text?: string;
     /**

package/dist/lib/i18n.d.ts

@@ -1,3 +1,3 @@
-export type TranslateFn = (key: string, options?: object) => string;
+export type TranslateFn = (key: string, options?: object) => string | undefined;
 export declare function configureExpoUiI18n(fn: TranslateFn | null): void;
-export declare function translateText(key?: string, text?: string, options?: object): string | undefined;
+export declare function translateText(key?: string, fallbackText?: string, options?: object): string | undefined;

package/dist/lib/i18n.js

@@ -2,10 +2,10 @@ let translate = null;
 export function configureExpoUiI18n(fn) {
     translate = fn;
 }
-export function translateText(key, text, options) {
-    if (text)
-        return text;
+export function translateText(key, fallbackText, options) {
     if (!key)
-        return undefined;
-    return translate ? translate(key, options) : key;
+        return fallbackText;
+    if (!translate)
+        return fallbackText ?? key;
+    return translate(key, options) ?? fallbackText ?? key;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrmeg/expo-ui",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "description": "Reusable Expo and React Native UI primitives for MrMeg projects.",
   "keywords": [