@kbach/react-native 1.0.0-beta.20 → 1.0.0-beta.22

package/dist/jsx-runtime.web.mjs

@@ -2,8 +2,8 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-MJWWZJMH.mjs";
-import "./chunk-OGFB3OXS.mjs";
+} from "./chunk-OS7EPBH5.mjs";
+import "./chunk-AG7ZQ2K4.mjs";
 export {
   Fragment,
   jsx,

package/dist/{useDynamicToken-Dr15c88t.d.ts → useDynamicToken-DAHQob1u.d.ts}

@@ -80,18 +80,49 @@ interface ThemeState {
  */
 declare function useTheme(): ThemeState;
 
+/**
+ * The exact shape `@react-native-async-storage/async-storage`'s default
+ * export already has — pass it directly as `persist`. Any other async
+ * key-value store (MMKV, SecureStore, a custom backend, ...) works too, as
+ * long as it exposes these two methods with this signature. Kept minimal
+ * on purpose: `ThemeProvider` never imports a storage library itself (see
+ * `darkModeStore.ts`'s own doc comment on why this package forces no real
+ * native dependency on consumers who don't want persistence) — deliberately
+ * NOT a `boolean`-only option that reaches for AsyncStorage internally,
+ * since Metro resolves every `require()`/`import` target at BUNDLE time
+ * regardless of try/catch, so a library-internal "if installed, use it"
+ * check can't actually degrade gracefully when the package is absent — an
+ * injected adapter sidesteps that entirely.
+ */
+interface ThemeStorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+}
 interface ThemeProviderProps {
     children: ReactNode;
     /**
      * Applied once, on this provider's first mount, but ONLY if nothing has
      * made an explicit mode choice yet (see
      * `darkModeStore.ts::seedDefaultMode`) — an explicit prior choice always
-     * wins over a component's own default. Unlike @kbach/react's web
-     * version, there's no persisted value to check here — see
-     * darkModeStore.ts's own doc comment on why this package doesn't persist
-     * the mode across app launches.
+     * wins over a component's own default. If `persist` is also set and a
+     * persisted mode is found, the persisted mode wins over this fallback.
      */
     defaultMode?: ThemeMode;
+    /**
+     * Opt-in persistence across app launches — `false` by default (this
+     * package never persists on its own; see `darkModeStore.ts`'s doc
+     * comment). Pass a storage adapter to enable it:
+     * ```tsx
+     * import AsyncStorage from '@react-native-async-storage/async-storage';
+     * <ThemeProvider persist={AsyncStorage}>...
+     * ```
+     * The persisted value (if any) is read once on mount and applied via the
+     * same "don't clobber a real choice already in flight" guard
+     * `seedDefaultMode`/`defaultMode` uses; every later explicit mode change
+     * is written back automatically for as long as this provider stays
+     * mounted.
+     */
+    persist?: ThemeStorageAdapter | false;
 }
 /**
  * Optional — `useTheme()` reads `darkModeStore.ts`'s global store directly
@@ -107,7 +138,7 @@ interface ThemeProviderProps {
  * state — mounting more than one is very likely a mistake, so this warns
  * once in dev.
  */
-declare function ThemeProvider({ children, defaultMode }: ThemeProviderProps): react.JSX.Element;
+declare function ThemeProvider({ children, defaultMode, persist }: ThemeProviderProps): react.JSX.Element;
 
 interface ColorScale {
     /** `colors.blue[6]` -> raw value */
@@ -157,4 +188,4 @@ declare function useColors(): ColorsAPI;
  */
 declare function useDynamicToken(name: string): string | undefined;
 
-export { type ColorScale as C, type KbachConfig as K, ThemeProvider as T, type ColorsAPI as a, type ThemeProviderProps as b, type ThemeState as c, applyKbachConfig as d, useDynamicToken as e, useTheme as f, resolveKbachConfig as r, useColors as u };
+export { type ColorScale as C, type KbachConfig as K, ThemeProvider as T, type ColorsAPI as a, type ThemeProviderProps as b, type ThemeState as c, type ThemeStorageAdapter as d, applyKbachConfig as e, useDynamicToken as f, useTheme as g, resolveKbachConfig as r, useColors as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbach/react-native",
-  "version": "1.0.0-beta.20",
+  "version": "1.0.0-beta.22",
   "description": "Kbach's utility-class styling engine for React Native — the same class names as @kbach/react, resolved to a StyleSheet-ready style object via a Kotlin/JNI TurboModule (native), the same WASM engine @kbach/react uses (Expo Web / react-native-web), or a pure-JS fallback engine (Expo Go). Ships its own native Android module — one npm install, no separate native package. Beta. Native is Android-only (no iOS bridge yet); works with the React Native CLI, an Expo dev client, AND Expo Go (a reduced-coverage pure-JS fallback, since Expo Go can't load any custom native module).",
   "keywords": [
     "css",