@symbiote-native/localization 3.0.0 → 3.0.2

package/README.md

@@ -12,13 +12,27 @@ depended on directly and never the `expo` meta-package, why the upstream JS is h
 
 ## Install
 
+**New app:**
+
 ```bash
-npm install @symbiote-native/localization
+npx @symbiote-native/cli new my-app --localization
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --localization
 ```
 
-Scaffolding or extending a SymbioteNative app? `npx @symbiote-native/cli new --localization` (or
-`add --localization` in an existing app) installs and wires this for you — see
-[`@symbiote-native/cli`](../cli).
+Either way: installs `@symbiote-native/localization` and wires the native autolinking
+automatically — see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI — installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/localization
+```
 
 Depends on `expo-localization` and `expo-modules-core` directly (regular dependencies, pinned to
 exact versions — never a caret range, since this package's `core/` is hand-ported against one
@@ -48,6 +62,8 @@ implementation: `examples/expo-react/ios/Podfile` and
 No platform permission string is needed — locale and calendar settings are read-only system
 state with no runtime permission prompt on either platform.
 
+</details>
+
 ## Shape
 
 ```

package/build/react/hooks/use-calendars/index.js

@@ -4,6 +4,9 @@ import { useEffect, useMemo, useReducer } from 'react';
 import { addCalendarListener, getCalendars, } from '../../../core/index.js';
 export function useCalendars() {
     const [invalidationKey, invalidate] = useReducer((key) => key + 1, 0);
+    // invalidationKey is a pure invalidation signal, never read inside the memo — it exists only to
+    // force a recompute when the native listener fires, matching upstream's identical pattern.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
     const calendars = useMemo(() => getCalendars(), [invalidationKey]);
     useEffect(() => {
         const subscription = addCalendarListener(invalidate);

package/build/react/hooks/use-locales/index.js

@@ -6,6 +6,9 @@ import { useEffect, useMemo, useReducer } from 'react';
 import { addLocaleListener, getLocales } from '../../../core/index.js';
 export function useLocales() {
     const [invalidationKey, invalidate] = useReducer((key) => key + 1, 0);
+    // invalidationKey is a pure invalidation signal, never read inside the memo — it exists only to
+    // force a recompute when the native listener fires, matching upstream's identical pattern.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
     const locales = useMemo(() => getLocales(), [invalidationKey]);
     useEffect(() => {
         const subscription = addLocaleListener(invalidate);

package/native-link.json

@@ -7,6 +7,7 @@
         "className": "LocalizationModule",
         "nativeName": "ExpoLocalization"
       }
-    ]
+    ],
+    "mainActivityConfigChanges": ["locale", "layoutDirection"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/localization",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "expo-localization wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Two independent synchronous getters (getLocales, getCalendars), each with its own native change listener and its own reactive hook per adapter.",
   "license": "MIT",
   "repository": {
@@ -80,12 +80,12 @@
     "solid-js": ">=1.9.0",
     "svelte": ">=5.56.0",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "^3.0.0",
-    "@symbiote-native/engine": "^1.0.0",
-    "@symbiote-native/react": "^3.0.0",
-    "@symbiote-native/solid": "^3.0.0",
-    "@symbiote-native/svelte": "^3.0.0",
-    "@symbiote-native/vue": "^3.0.0"
+    "@symbiote-native/angular": "^3.1.2",
+    "@symbiote-native/engine": "^1.3.1",
+    "@symbiote-native/react": "^3.0.4",
+    "@symbiote-native/solid": "^3.0.4",
+    "@symbiote-native/svelte": "^3.0.4",
+    "@symbiote-native/vue": "^3.0.4"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -133,13 +133,13 @@
     "solid-js": "^1.9.14",
     "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "3.0.0",
-    "@symbiote-native/engine": "1.0.0",
-    "@symbiote-native/react": "3.0.0",
-    "@symbiote-native/solid": "3.0.0",
-    "@symbiote-native/svelte": "3.0.0",
-    "@symbiote-native/test-utils": "0.3.1",
-    "@symbiote-native/vue": "3.0.0"
+    "@symbiote-native/angular": "3.1.2",
+    "@symbiote-native/engine": "1.3.1",
+    "@symbiote-native/react": "3.0.4",
+    "@symbiote-native/solid": "3.0.4",
+    "@symbiote-native/svelte": "3.0.4",
+    "@symbiote-native/test-utils": "0.4.4",
+    "@symbiote-native/vue": "3.0.4"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/react/hooks/use-calendars/index.ts

@@ -9,6 +9,9 @@ import {
 
 export function useCalendars(): Calendar[] {
   const [invalidationKey, invalidate] = useReducer((key: number) => key + 1, 0);
+  // invalidationKey is a pure invalidation signal, never read inside the memo — it exists only to
+  // force a recompute when the native listener fires, matching upstream's identical pattern.
+  // eslint-disable-next-line react-hooks/exhaustive-deps
   const calendars = useMemo(() => getCalendars(), [invalidationKey]);
 
   useEffect(() => {

package/src/react/hooks/use-locales/index.ts

@@ -7,6 +7,9 @@ import { addLocaleListener, getLocales, type Locale } from '../../../core';
 
 export function useLocales(): Locale[] {
   const [invalidationKey, invalidate] = useReducer((key: number) => key + 1, 0);
+  // invalidationKey is a pure invalidation signal, never read inside the memo — it exists only to
+  // force a recompute when the native listener fires, matching upstream's identical pattern.
+  // eslint-disable-next-line react-hooks/exhaustive-deps
   const locales = useMemo(() => getLocales(), [invalidationKey]);
 
   useEffect(() => {