@forthtilliath/expo-release-updates-ui 0.2.8 → 0.3.0

package/README.md

@@ -129,6 +129,8 @@ import { UpdateAvailableBanner } from "@forthtilliath/expo-release-updates-ui";
 }
 ```
 
+Built-in labels are French by default; pass `locale="en"` for English (e.g. from the app's language on a bilingual app). `labels` still overrides individual strings — `title`, `action`, `dismiss`, `dismissAccessibilityLabel` — whatever the locale.
+
 ## Scripts
 
 ```bash

package/dist/UpdateAvailableBanner.d.ts

@@ -10,6 +10,8 @@ export interface UpdateAvailableBannerStyles {
     dismissButton?: StyleProp<ViewStyle>;
     dismissButtonText?: StyleProp<TextStyle>;
 }
+/** Languages the banner's built-in labels are available in. */
+export type UpdateBannerLocale = "fr" | "en";
 export interface UpdateAvailableBannerLabels {
     title?: (version: string) => string;
     action?: string;
@@ -22,8 +24,14 @@ export interface UpdateAvailableBannerProps {
     notes: string;
     onPress: () => void;
     onDismiss: () => void;
+    /** Overrides individual built-in labels, whatever the `locale`. */
     labels?: UpdateAvailableBannerLabels;
+    /**
+     * Language of the built-in labels.
+     * @defaultValue "fr"
+     */
+    locale?: UpdateBannerLocale;
     styles?: UpdateAvailableBannerStyles;
 }
-export declare function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, styles, }: UpdateAvailableBannerProps): import("react").JSX.Element;
+export declare function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, locale, styles, }: UpdateAvailableBannerProps): import("react").JSX.Element;
 //# sourceMappingURL=UpdateAvailableBanner.d.ts.map

package/dist/UpdateAvailableBanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdateAvailableBanner.d.ts","sourceRoot":"","sources":["../src/UpdateAvailableBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAwCD,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,0BAA0B,+BA+C5B"}
+{"version":3,"file":"UpdateAvailableBanner.d.ts","sourceRoot":"","sources":["../src/UpdateAvailableBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,gBAAgB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,+DAA+D;AAC/D,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,mEAAmE;IACnE,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAmDD,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAa,EACb,MAAM,GACP,EAAE,0BAA0B,+BA+C5B"}

package/dist/UpdateAvailableBanner.js

@@ -28,16 +28,24 @@ const defaultStyles = {
     dismissButtonText: { fontSize: 13, color: "#6b7280" },
 };
 const defaultLabels = {
-    title: (version) => `Version ${version} disponible`,
-    action: "Voir",
-    dismiss: "Fermer",
-    dismissAccessibilityLabel: "Fermer la notification de mise à jour",
+    fr: {
+        title: (version) => `Version ${version} disponible`,
+        action: "Voir",
+        dismiss: "Fermer",
+        dismissAccessibilityLabel: "Fermer la notification de mise à jour",
+    },
+    en: {
+        title: (version) => `Version ${version} available`,
+        action: "View",
+        dismiss: "Close",
+        dismissAccessibilityLabel: "Dismiss the update notification",
+    },
 };
 // Dismissible banner announcing an available update: version, release notes
 // (via `ChangelogNotes`), and an action + dismiss button. Has no opinion on
 // what "action" does (e.g. navigate to an update screen) or on how/whether
 // dismissal is persisted — both are left entirely to the caller.
-export function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, styles, }) {
+export function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labels, locale = "fr", styles, }) {
     // Style fields are merged as arrays (default, then override) so a partial
     // override only changes the properties it specifies instead of replacing
     // the whole default style object. `notes` is forwarded as-is to
@@ -58,6 +66,6 @@ export function UpdateAvailableBanner({ version, notes, onPress, onDismiss, labe
             styles?.dismissButtonText,
         ],
     };
-    const t = { ...defaultLabels, ...labels };
+    const t = { ...defaultLabels[locale], ...labels };
     return (_jsxs(View, { style: merged.container, children: [_jsxs(View, { style: merged.header, children: [_jsx(Text, { style: merged.title, children: t.title(version) }), _jsx(Pressable, { style: merged.dismissButton, onPress: onDismiss, accessibilityRole: "button", accessibilityLabel: t.dismissAccessibilityLabel, children: _jsx(Text, { style: merged.dismissButtonText, children: t.dismiss }) })] }), notes ? _jsx(ChangelogNotes, { notes: notes, styles: merged.notes }) : null, _jsx(Pressable, { style: merged.actionButton, onPress: onPress, accessibilityRole: "button", accessibilityLabel: t.action, children: _jsx(Text, { style: merged.actionButtonText, children: t.action }) })] }));
 }

package/dist/useUpdateCheck.d.ts

@@ -1,8 +1,6 @@
-export interface UpdateCheckRelease {
-    version: string;
-    notes: string;
-    apkUrl: string;
-}
+import type { LatestRelease } from "@forthtilliath/expo-release-updates/githubReleases";
+/** A release as returned by `fetchLatestRelease` (same shape). */
+export type UpdateCheckRelease = LatestRelease;
 export type UpdateCheckState = {
     status: "idle";
 } | {
@@ -16,8 +14,11 @@ export interface UseUpdateCheckOptions {
     currentVersion: string;
     /** Fetches the latest available release, or `null` if there is none. */
     checkForUpdate: () => Promise<UpdateCheckRelease | null>;
-    /** Positive when `a` is newer than `b`, e.g. semver comparison. */
-    compareVersions: (a: string, b: string) => number;
+    /**
+     * Positive when `a` is newer than `b`. Defaults to
+     * `@forthtilliath/expo-release-updates`'s semver `compareVersions`.
+     */
+    compareVersions?: (a: string, b: string) => number;
     /** Read once on mount: when the last check ran, and which version (if any) the user already dismissed. */
     getLastCheck: () => {
         lastCheckedAt: number | null;

package/dist/useUpdateCheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUpdateCheck.d.ts","sourceRoot":"","sources":["../src/useUpdateCheck.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzD,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,0GAA0G;IAC1G,YAAY,EAAE,MAAM;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;IACF,sGAAsG;IACtG,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAUD,wBAAgB,cAAc,CAAC,EAC7B,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAuC,EACvC,GAAc,GACf,EAAE,qBAAqB,GAAG,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAyCpE"}
+{"version":3,"file":"useUpdateCheck.d.ts","sourceRoot":"","sources":["../src/useUpdateCheck.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;AAExF,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzD;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,0GAA0G;IAC1G,YAAY,EAAE,MAAM;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;IACF,sGAAsG;IACtG,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAUD,wBAAgB,cAAc,CAAC,EAC7B,cAAc,EACd,cAAc,EACd,eAAwC,EACxC,YAAY,EACZ,SAAS,EACT,aAAuC,EACvC,GAAc,GACf,EAAE,qBAAqB,GAAG,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAyCpE"}

package/dist/useUpdateCheck.js

@@ -1,4 +1,5 @@
 import { useEffect, useState } from "react";
+import { compareVersions as defaultCompareVersions } from "@forthtilliath/expo-release-updates/compareVersions";
 const DEFAULT_MIN_INTERVAL_MS = 12 * 60 * 60 * 1000;
 // Checks once per mount (e.g. app launch) whether a newer release is
 // available, throttled to at most one real network check per `minIntervalMs`
@@ -6,7 +7,7 @@ const DEFAULT_MIN_INTERVAL_MS = 12 * 60 * 60 * 1000;
 // "when did we last check" / "which version did the user dismiss" is left
 // entirely to the caller (`getLastCheck`/`onChecked`, plus its own dismiss
 // handler) — this hook has no opinion on where that lives.
-export function useUpdateCheck({ currentVersion, checkForUpdate, compareVersions, getLastCheck, onChecked, minIntervalMs = DEFAULT_MIN_INTERVAL_MS, now = Date.now, }) {
+export function useUpdateCheck({ currentVersion, checkForUpdate, compareVersions = defaultCompareVersions, getLastCheck, onChecked, minIntervalMs = DEFAULT_MIN_INTERVAL_MS, now = Date.now, }) {
     const [state, setState] = useState({ status: "idle" });
     useEffect(() => {
         const { lastCheckedAt, dismissedVersion } = getLastCheck();

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@forthtilliath/expo-release-updates-ui",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "type": "module",
+  "sideEffects": false,
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -21,7 +22,7 @@
     "./*": "./dist/*.js"
   },
   "dependencies": {
-    "@forthtilliath/expo-release-updates": "0.4.7"
+    "@forthtilliath/expo-release-updates": "^0.5.0"
   },
   "peerDependencies": {
     "react": ">=19",
@@ -35,14 +36,14 @@
     "react-native": "0.86.0",
     "react-test-renderer": "19.2.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.10",
-    "@forthtilliath/eslint-config": "0.7.0",
+    "vitest": "^5.0.2",
+    "@forthtilliath/eslint-config": "0.8.0",
     "@forthtilliath/typescript-config": "0.1.1"
   },
   "scripts": {
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
-    "clean": "rm -rf dist",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "dev": "tsc --watch -p tsconfig.build.json",
     "build": "pnpm run clean && tsc -p tsconfig.build.json",
     "test": "vitest run",