@marktiderman/genesis-native 0.5.2 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -35,7 +35,29 @@ From the outside in:
35
35
  set-up throws (a boot step id that clashes with the shell's, say), or the
36
36
  `fatal` slot itself throws, this is what shows, and "Try again" starts over.
37
37
  2. **Theme**: `GenesisThemeProvider` with `syncNativeAppearance` on, so the
38
- root owns the platform color scheme.
38
+ root owns the platform color scheme. NativeWind's role classes
39
+ (`bg-primary`, `border-input`) read the role variables the app's
40
+ stylesheet declares: for your brand, use
41
+ `createGenesisNativewindPreset({ brand })` (design-system
42
+ `presets/nativewind`) in `tailwind.config`, or your brand package's own.
43
+ The shell sets none by default, since NativeWind can't tell which `:root`
44
+ variables are the app's. `brandVariables` opts in: `true` sets
45
+ `brandRoleVariables(brand)` on a view around the app for the current mode,
46
+ and an object (one map, or `{ light, dark }`) sets your own. With
47
+ `modules.navigation` (`{ ThemeProvider, DefaultTheme, DarkTheme }` from
48
+ `expo-router`), the shell also themes React Navigation (headers, tab bars,
49
+ the screen background) in the same role colors for the current mode, so a
50
+ header is never light in dark mode. Take the module from `expo-router` in
51
+ an Expo Router app: it bundles its own React Navigation, whose navigators
52
+ don't read `@react-navigation/native`'s theme. The colors are
53
+ `brandRoleVariables(brand)`, with your `brandVariables` map over them when
54
+ you pass one. Without `brandVariables`, your screens' NativeWind classes
55
+ read your stylesheet's variables instead, so with a brand of your own pass
56
+ the same map to both, or headers and screens can differ. `navigationTheme`
57
+ takes a theme of your own (or `{ light, dark }`; a theme without `fonts`
58
+ keeps React Navigation's), and `false` sets none. The app
59
+ installs `@marktiderman/genesis-core` and `nativewind` itself (peer
60
+ dependencies, so one copy of each loads).
39
61
  3. **Keyboard**: your `keyboardProvider` (react-native-keyboard-controller's
40
62
  `KeyboardProvider`), mounted once, then `KeyboardScrollProvider` with your
41
63
  `keyboardScroll`, so Genesis form screens scroll the focused field into
@@ -1,7 +1,7 @@
1
1
  import * as react from 'react';
2
2
  import { ComponentType, ReactNode } from 'react';
3
3
  import { c as ScreenErrorProps } from './screen-boundary-BlT6KBpa.js';
4
- import { N as NativeBlock, r as NativeBlockRootProps } from './blocks-CyXjSGwV.js';
4
+ import { N as NativeBlock, r as NativeBlockRootProps } from './blocks-ByVBKaQW.js';
5
5
  import { b as ErrorReport } from './query-DobJyRvs.js';
6
6
 
7
7
  /**
@@ -7,7 +7,7 @@ import { QueryClient, QueryClientConfig } from '@tanstack/react-query';
7
7
  import { CanonicalBrand } from '@marktiderman/genesis-design-system';
8
8
  import { SupabaseClientInput, DataProvider } from '@marktiderman/genesis-core/provider';
9
9
  import { KeyboardScrollProps, KeyboardToolbarProps } from '@marktiderman/genesis-ui-native/layouts';
10
- import { GenesisModules, NativeSheetLibrary, NativeToastProviderProps } from '@marktiderman/genesis-ui-native/components';
10
+ import { GenesisNavigationTheme, GenesisModules, NativeSheetLibrary, NativeToastProviderProps } from '@marktiderman/genesis-ui-native/components';
11
11
 
12
12
  interface BootStepContext {
13
13
  /**
@@ -1341,6 +1341,30 @@ interface GenesisNativeAppProps {
1341
1341
  keyboardProvider?: ComponentType<{
1342
1342
  children: ReactNode;
1343
1343
  }>;
1344
+ /**
1345
+ * Theme role variables (`--primary`, `--background`, …) to set on a view
1346
+ * around the app, over what the app's stylesheet declares on `:root`.
1347
+ * Default `false`: none are set, so the app's own variables (from
1348
+ * `createGenesisNativewindPreset({ brand })` or its brand package) stand.
1349
+ * `true` sets `brandRoleVariables(brand)` for the current mode; an object
1350
+ * sets the app's own, one map for both modes or `{ light, dark }`.
1351
+ */
1352
+ brandVariables?: boolean | Record<string, string> | {
1353
+ light: Record<string, string>;
1354
+ dark: Record<string, string>;
1355
+ };
1356
+ /**
1357
+ * React Navigation's theme (headers, tab bars, the screen background), when
1358
+ * `modules.navigation` is given. Default: worked out from the same role
1359
+ * variables as `brandVariables` (the app's own when it passes them,
1360
+ * `brandRoleVariables(brand)` otherwise), for the current mode, so a header
1361
+ * is never light in dark mode. Pass a theme (or `{ light, dark }`) to use
1362
+ * your own, or `false` to set none.
1363
+ */
1364
+ navigationTheme?: false | GenesisNavigationTheme | {
1365
+ light: GenesisNavigationTheme;
1366
+ dark: GenesisNavigationTheme;
1367
+ };
1344
1368
  /** `KeyboardAwareScrollView` from react-native-keyboard-controller, for form screens. Needs `keyboardProvider`. */
1345
1369
  keyboardScroll?: ComponentType<KeyboardScrollProps>;
1346
1370
  /**
@@ -1,6 +1,6 @@
1
- import { N as NativeBlock, U as UpdatesBlock, V as VersionSignature } from './blocks-CyXjSGwV.js';
2
- export { D as DevtoolsFeedbackProps, a as DevtoolsSlots } from './blocks-CyXjSGwV.js';
3
- import { O as ObservabilityBlock, R as RecentActivity } from './block-DFnC8j5U.js';
1
+ import { N as NativeBlock, U as UpdatesBlock, V as VersionSignature } from './blocks-ByVBKaQW.js';
2
+ export { D as DevtoolsFeedbackProps, a as DevtoolsSlots } from './blocks-ByVBKaQW.js';
3
+ import { O as ObservabilityBlock, R as RecentActivity } from './block-q6_CV0WK.js';
4
4
  import 'react';
5
5
  import '@marktiderman/genesis-core/slots';
6
6
  import '@marktiderman/genesis-features/blocks';
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { A as AuthClientLike, b as AuthGate, c as AuthGateProps, B as BlockSettingsSection, d as BootController, e as BootOptions, f as BootProvider, g as BootScreen, h as BootScreenProps, i as BootState, j as BootStatus, k as BootStep, l as BootStepContext, m as BootTimeoutError, G as GenesisNativeApp, n as GenesisNativeAppProps, H as HeldLinkAuth, L as LinkHold, o as LinkOptions, p as LinkTarget, q as NativeAppSlots, N as NativeBlock, r as NativeBlockRootProps, s as NativeQueryClientOptions, S as SessionProvider, t as SessionState, u as SessionStatus, v as SessionStore, w as SessionStoreOptions, x as SettingsRowLike, y as SignedOutProps, z as SplashModule, C as UseBlockSettingsOptions, E as UseBootReturn, F as UseHeldLinkOptions, I as createBoot, J as createLinkHold, K as createSessionStore, M as mergeBlockSettings, O as normalizeLink, P as useBlockSettings, Q as useBlocks, R as useBoot, T as useHeldLink, W as useSession } from './blocks-CyXjSGwV.js';
1
+ export { A as AuthClientLike, b as AuthGate, c as AuthGateProps, B as BlockSettingsSection, d as BootController, e as BootOptions, f as BootProvider, g as BootScreen, h as BootScreenProps, i as BootState, j as BootStatus, k as BootStep, l as BootStepContext, m as BootTimeoutError, G as GenesisNativeApp, n as GenesisNativeAppProps, H as HeldLinkAuth, L as LinkHold, o as LinkOptions, p as LinkTarget, q as NativeAppSlots, N as NativeBlock, r as NativeBlockRootProps, s as NativeQueryClientOptions, S as SessionProvider, t as SessionState, u as SessionStatus, v as SessionStore, w as SessionStoreOptions, x as SettingsRowLike, y as SignedOutProps, z as SplashModule, C as UseBlockSettingsOptions, E as UseBootReturn, F as UseHeldLinkOptions, I as createBoot, J as createLinkHold, K as createSessionStore, M as mergeBlockSettings, O as normalizeLink, P as useBlockSettings, Q as useBlocks, R as useBoot, T as useHeldLink, W as useSession } from './blocks-ByVBKaQW.js';
2
2
  import { A as AsyncStorageLike } from './query-DobJyRvs.js';
3
3
  export { a as AppStateLike, D as DAY_MS, E as EnableRejectionTracker, b as ErrorReport, c as ErrorUtilsLike, F as FatalScreen, d as FatalScreenProps, G as GenesisErrorBoundary, e as GenesisErrorBoundaryProps, f as GlobalErrorHandlerOptions, N as NetInfoLike, O as OnError, P as PlainFatalScreen, Q as QueryErrorReporter, g as QueryLifecycleOptions, h as QueryPersistence, R as ReportQueryErrorsOptions, i as connectQueryLifecycle, j as createNativeQueryClient, k as defaultErrorUtils, l as defaultRejectionTracker, m as errorDetails, n as installGlobalErrorHandler, o as installRejectionTracker, q as queryKeyName, r as reportQueryErrors } from './query-DobJyRvs.js';
4
4
  export { S as ScreenErrorBoundary, a as ScreenErrorBoundaryOptions, b as ScreenErrorBoundaryProps, c as ScreenErrorProps, d as ScreenErrorScreen, e as createScreenErrorBoundary } from './screen-boundary-BlT6KBpa.js';
package/dist/index.js CHANGED
@@ -8,9 +8,11 @@ export { BootProvider, BootTimeoutError, FatalScreen, GenesisErrorBoundary, Plai
8
8
  export { BEFORE_RELOAD_TIMEOUT_MS, onBeforeReload, runBeforeReload } from './chunk-VIC2KXMA.js';
9
9
  import { createSessionStore, SessionProvider } from './chunk-NGYNYJPL.js';
10
10
  export { AuthGate, SessionProvider, createSessionStore, useSession } from './chunk-NGYNYJPL.js';
11
- import { useSyncExternalStore, useRef, useEffect, useState } from 'react';
11
+ import { useSyncExternalStore, useRef, useEffect, useState, useMemo } from 'react';
12
12
  import { View, Text } from 'react-native';
13
- import { GenesisThemeProvider } from '@marktiderman/genesis-design-system/theme';
13
+ import { vars } from 'nativewind';
14
+ import { GenesisThemeProvider, useTheme } from '@marktiderman/genesis-design-system/theme';
15
+ import { brandRoleVariables } from '@marktiderman/genesis-design-system';
14
16
  import { createSupabaseProvider, GenesisProvider } from '@marktiderman/genesis-core/provider';
15
17
  import { renderSlot } from '@marktiderman/genesis-core/slots';
16
18
  import { KeyboardScrollProvider } from '@marktiderman/genesis-ui-native/layouts';
@@ -111,7 +113,71 @@ function ThemedShell(props) {
111
113
  if (modules) body = /* @__PURE__ */ jsx(GenesisModulesProvider, { modules, children: body });
112
114
  if (keyboardScroll) body = /* @__PURE__ */ jsx(KeyboardScrollProvider, { component: keyboardScroll, toolbar: keyboardToolbar, children: body });
113
115
  if (Keyboard) body = /* @__PURE__ */ jsx(Keyboard, { children: body });
114
- return /* @__PURE__ */ jsx(ThemeProvider, { brand, syncNativeAppearance: true, children: body });
116
+ if (modules?.navigation && props.navigationTheme !== false) {
117
+ body = /* @__PURE__ */ jsx(NavigationTheme, { module: modules.navigation, brand, brandVariables: props.brandVariables, given: props.navigationTheme, children: body });
118
+ }
119
+ return /* @__PURE__ */ jsx(ThemeProvider, { brand, syncNativeAppearance: true, children: props.brandVariables ? /* @__PURE__ */ jsx(BrandVariables, { brand, given: props.brandVariables, children: body }) : body });
120
+ }
121
+ function BrandVariables({
122
+ brand,
123
+ given,
124
+ children
125
+ }) {
126
+ const { resolvedMode } = useTheme();
127
+ const variables = useMemo(() => {
128
+ if (given === true) return brandRoleVariables(brand);
129
+ const perMode = given;
130
+ if (typeof perMode.light === "object" && typeof perMode.dark === "object") return given;
131
+ return { light: given, dark: given };
132
+ }, [brand, given]);
133
+ const style = useMemo(() => [{ flex: 1 }, vars(variables[resolvedMode])], [variables, resolvedMode]);
134
+ return /* @__PURE__ */ jsx(View, { testID: "genesis-brand-variables", style, children });
135
+ }
136
+ function roleColor(value) {
137
+ if (!value) return void 0;
138
+ const [color = "", alpha] = value.split("/").map((p) => p.trim());
139
+ const parts = color.split(/\s+/);
140
+ if (parts.length !== 3) return value;
141
+ return alpha ? `hsla(${parts.join(", ")}, ${alpha})` : `hsl(${parts.join(", ")})`;
142
+ }
143
+ function NavigationTheme({
144
+ module,
145
+ brand,
146
+ brandVariables,
147
+ given,
148
+ children
149
+ }) {
150
+ const { resolvedMode } = useTheme();
151
+ const theme = useMemo(() => {
152
+ const base = resolvedMode === "dark" ? module.DarkTheme : module.DefaultTheme;
153
+ if (given) {
154
+ const perMode = given;
155
+ const own = perMode.light && perMode.dark ? perMode[resolvedMode] : given;
156
+ return own.fonts ? own : { ...own, fonts: base.fonts };
157
+ }
158
+ let variables = brandRoleVariables(brand)[resolvedMode];
159
+ if (brandVariables && brandVariables !== true) {
160
+ const perMode = brandVariables;
161
+ const own = typeof perMode.light === "object" && typeof perMode.dark === "object" ? brandVariables[resolvedMode] : brandVariables;
162
+ variables = { ...variables, ...own };
163
+ }
164
+ const pick = (name, fallback) => roleColor(variables[`--${name}`]) ?? fallback;
165
+ return {
166
+ ...base,
167
+ dark: resolvedMode === "dark",
168
+ colors: {
169
+ ...base.colors,
170
+ primary: pick("primary", base.colors.primary),
171
+ background: pick("background", base.colors.background),
172
+ card: pick("card", base.colors.card),
173
+ text: pick("foreground", base.colors.text),
174
+ border: pick("border", base.colors.border),
175
+ notification: pick("destructive", base.colors.notification)
176
+ }
177
+ };
178
+ }, [module, brand, brandVariables, given, resolvedMode]);
179
+ const Provider = module.ThemeProvider;
180
+ return /* @__PURE__ */ jsx(Provider, { value: theme, children });
115
181
  }
116
182
  var SESSION_STEP_MARGIN_MS = 15e3;
117
183
  function Shell(props) {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/held-link.ts","../src/app.tsx","../src/hydration-gate.ts"],"names":["useRef","useEffect","client","persistence","session","boot","FatalFallback","useSyncExternalStore"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Hold a deep link until sign-in completes.\n *\n * expo-router opens every incoming link itself. For a signed-in user that is\n * all that should happen. For a signed-out user, the auth layout redirects to\n * sign-in and the link is lost; holding it lets the app go there once the user\n * has signed in. The hold lives outside React, because expo-router's\n * `+native-intent` runs before any component:\n *\n * // lib/links.ts\n * export const linkHold = createLinkHold();\n * // app/+native-intent.ts\n * export function redirectSystemPath({ path }) {\n * const to = normalizeLink(path, links);\n * if (to && to !== \"/\") linkHold.hold(to);\n * return to;\n * }\n *\n * `useHeldLink` follows a held link only if the user was seen signed out\n * while it was held. A link that arrives while signed in, or at a cold start\n * that turns out signed in, is dropped, since the router already opened it.\n * `GenesisNativeApp` runs it for you (`links.onRelease`).\n */\nimport { useEffect, useRef, useSyncExternalStore } from \"react\";\n\nexport interface LinkHold {\n /** Hold `path`, replacing any held one. */\n hold(path: string): void;\n peek(): string | null;\n /** Return the held path and forget it. */\n take(): string | null;\n clear(): void;\n subscribe(listener: () => void): () => void;\n}\n\n/** A place to hold one deep link until sign-in completes; lives outside React. */\nexport function createLinkHold(): LinkHold {\n let held: string | null = null;\n const listeners = new Set<() => void>();\n const set = (next: string | null) => {\n if (held === next) return;\n held = next;\n for (const listener of listeners) listener();\n };\n return {\n hold: (path) => set(path),\n peek: () => held,\n take() {\n const path = held;\n set(null);\n return path;\n },\n clear: () => set(null),\n subscribe(listener) {\n listeners.add(listener);\n return () => listeners.delete(listener);\n },\n };\n}\n\n/** `\"pending\"` while booting or reading the session. */\nexport type HeldLinkAuth = \"pending\" | \"signedOut\" | \"signedIn\";\n\nexport interface UseHeldLinkOptions {\n auth: HeldLinkAuth;\n /** Go there, e.g. `(path) => router.replace(path)`. Called once per link held across a sign-in. */\n onRelease: (path: string) => void;\n}\n\n/** Follow the held link after a sign-in, drop it otherwise; returns the link still held. */\nexport function useHeldLink(hold: LinkHold, { auth, onRelease }: UseHeldLinkOptions): string | null {\n const held = useSyncExternalStore(hold.subscribe, hold.peek, hold.peek);\n const release = useRef(onRelease);\n release.current = onRelease;\n // Was the user signed out while this link was held?\n const waitedForSignIn = useRef(false);\n useEffect(() => {\n if (held === null) {\n waitedForSignIn.current = false;\n return;\n }\n if (auth === \"signedOut\") waitedForSignIn.current = true;\n if (auth !== \"signedIn\") return;\n const path = hold.take();\n const follow = waitedForSignIn.current;\n waitedForSignIn.current = false;\n if (path !== null && follow) release.current(path);\n }, [auth, held, hold]);\n return held;\n}\n","/**\n * `<GenesisNativeApp>`: everything above an Expo app's screens, so the root\n * `_layout.tsx` is a few lines.\n *\n * last-resort boundary (React Native primitives only)\n * └ theme (GenesisThemeProvider, owning the platform color scheme)\n * └ keyboard (`keyboardProvider`, once, then `keyboardScroll` for form screens)\n * └ toasts (`NativeToastProvider`, so `useToast()` works on every screen; `toast={null}` drops it)\n * └ data (GenesisProvider over the Supabase client, the QueryClient)\n * └ session + boot (splash held until both are known)\n * └ blocks' roots (with `blocks`, e.g. updates: force upgrade, maintenance, banner, what's new)\n * └ errorBoundary → `bottomSheet`'s provider, if given → your screens (or `signedOut`)\n *\n * Every error the shell catches goes to each block's `onError` (the\n * observability block reports it) and then to the app's own `onError`:\n * render, global, boot and unhandled-rejection errors, and queries and\n * mutations that failed unexpectedly (`reportQueryErrors`).\n *\n * `blocks` (`defineBlock` declarations a native shell can run) are resolved\n * once: requirements checked, boot steps run behind the splash, roots\n * mounted, slot fills put under your `slots`, Settings rows handed to\n * `useBlockSettings`.\n * Global errors, render errors and a failed boot show the `fatal` slot with\n * \"Try again\". Every part is a slot (`slots` / `slotProps`, `null` drops it)\n * and is also exported on its own.\n */\nimport { useEffect, useRef, useState, useSyncExternalStore, type ComponentType, type ReactNode } from \"react\";\nimport { Text, View } from \"react-native\";\nimport type { QueryClient, QueryClientConfig } from \"@tanstack/react-query\";\nimport { GenesisThemeProvider } from \"@marktiderman/genesis-design-system/theme\";\nimport type { CanonicalBrand } from \"@marktiderman/genesis-design-system\";\nimport { GenesisProvider, createSupabaseProvider, type DataProvider, type SupabaseClientInput } from \"@marktiderman/genesis-core/provider\";\nimport { renderSlot, type SlotPropsFor, type Slots } from \"@marktiderman/genesis-core/slots\";\nimport { KeyboardScrollProvider, type KeyboardScrollProps, type KeyboardToolbarProps } from \"@marktiderman/genesis-ui-native/layouts\";\nimport {\n GenesisModulesProvider,\n NativeSheetProvider,\n NativeToastProvider,\n type GenesisModules,\n type NativeSheetLibrary,\n type NativeToastProviderProps,\n} from \"@marktiderman/genesis-ui-native/components\";\nimport { BootProvider, createBoot, type BootOptions, type BootStatus, type BootStep } from \"./boot\";\nimport {\n FatalScreen,\n GenesisErrorBoundary,\n PlainFatalScreen,\n defaultErrorUtils,\n defaultRejectionTracker,\n installGlobalErrorHandler,\n installRejectionTracker,\n type EnableRejectionTracker,\n type ErrorUtilsLike,\n type FatalScreenProps,\n type GenesisErrorBoundaryProps,\n type OnError,\n} from \"./errors\";\nimport { SessionProvider, createSessionStore, type AuthClientLike } from \"./auth\";\nimport { useHeldLink, type HeldLinkAuth, type LinkHold } from \"./held-link\";\nimport { connectQueryLifecycle, createNativeQueryClient, reportQueryErrors, type QueryLifecycleOptions, type QueryPersistence } from \"./query\";\nimport { resolveBlocks } from \"@marktiderman/genesis-features/blocks\";\nimport { BlocksProvider, reportToBlocks, type NativeBlock } from \"./blocks\";\nimport type { DevtoolsSlots } from \"./devtools/slots\";\n// Types only: the block's code is in the `/updates` entry and arrives with the `updates` prop.\nimport type { UpdatesBlock, UpdatesSlots } from \"./updates/block\";\n// Types only, likewise: the push block (`/push`) arrives in `blocks`.\nimport type { PushSlots } from \"./push/block\";\n\n/** `expo-splash-screen`, or a stand-in. Call `preventAutoHideAsync()` at module scope yourself too. */\nexport interface SplashModule {\n preventAutoHideAsync?: () => Promise<unknown>;\n hideAsync: () => Promise<unknown>;\n}\n\nexport interface BootScreenProps {\n status: BootStatus;\n}\n\nexport interface SignedOutProps {\n /** Your screens. The default renders them, for an expo-router layout that redirects. */\n children: ReactNode;\n}\n\n// A type, not an interface, so it fits the slots contract's Record constraint.\n// The updates block's slots (`forceUpgrade`, `maintenance`, `updateBanner`,\n// `whatsNew`) render only when the `updates` prop is given.\nexport type NativeAppSlots = UpdatesSlots &\n PushSlots &\n DevtoolsSlots & {\n /** Shown while booting: under the splash at launch, on its own after \"Try again\". Default `BootScreen`. */\n boot: BootScreenProps;\n /** A failed boot, a fatal global error or a render error. Default `FatalScreen`. */\n fatal: FatalScreenProps;\n /** The boundary around your screens. Default `GenesisErrorBoundary`. */\n errorBoundary: GenesisErrorBoundaryProps;\n /** What a signed-out user sees. Default your screens (gate them with `useSession`). */\n signedOut: SignedOutProps;\n};\n\nexport interface NativeQueryClientOptions {\n /** Your own client. Default `createNativeQueryClient(config)`. */\n client?: QueryClient;\n config?: QueryClientConfig;\n}\n\nexport interface GenesisNativeAppProps {\n brand: CanonicalBrand;\n /** A Supabase client (from `createGenesisSupabase` in `@marktiderman/genesis-supabase`). */\n supabase: AuthClientLike & SupabaseClientInput;\n /** The data provider. Default `createSupabaseProvider(supabase)`. */\n provider?: DataProvider;\n queryClient?: NativeQueryClientOptions;\n /**\n * Save queries to the phone: `persistQueries({ storage, keys, buster })`\n * from `@marktiderman/genesis-native/persist`. The saved cache belongs to\n * one user: it is restored only for that user and cleared when the user\n * changes (sign-out, a session that ended while the app was closed, an\n * account switch).\n */\n persist?: (client: QueryClient) => QueryPersistence;\n /** `expo-splash-screen`: hidden once boot has finished and the session is known. */\n splash?: SplashModule;\n /**\n * `KeyboardProvider` from react-native-keyboard-controller, mounted once\n * around the app. Its keyboard views (`keyboardScroll` included) do nothing\n * without it: give both or neither. Read once: it wraps the whole app, so\n * a different component later would remount everything below it. To pass\n * it props, define the wrapper at module scope, not inline.\n */\n keyboardProvider?: ComponentType<{ children: ReactNode }>;\n /** `KeyboardAwareScrollView` from react-native-keyboard-controller, for form screens. Needs `keyboardProvider`. */\n keyboardScroll?: ComponentType<KeyboardScrollProps>;\n /**\n * `KeyboardToolbar` from react-native-keyboard-controller: previous / next /\n * done above the keyboard on Genesis's form layouts. Needs `keyboardScroll`\n * (and so `keyboardProvider`); without them it is ignored.\n */\n keyboardToolbar?: ComponentType<KeyboardToolbarProps>;\n /**\n * The optional native modules the app installed, for Genesis components to\n * use (`GenesisModulesProvider` from `@marktiderman/genesis-ui-native`):\n * FlashList, expo-image, Reanimated, expo-glass-effect, expo-symbols, a\n * lucide icon set, the @expo/ui date picker. Each one left out falls back\n * to plain React Native. Read once.\n */\n modules?: GenesisModules;\n /**\n * `@gorhom/bottom-sheet` v5, to opt every `NativeSheet` into it (snap\n * points, drag between heights): `import * as BottomSheet from \"@gorhom/bottom-sheet\"`,\n * then `bottomSheet={BottomSheet}`. The app mounts `NativeSheetProvider`\n * (and so the library's `BottomSheetModalProvider`) for you; the app's root\n * must still be inside gesture-handler's `GestureHandlerRootView`, with\n * Reanimated set up. Leave it out and sheets are React Native's own modal\n * (an iOS page sheet), which needs neither. Read once.\n */\n bottomSheet?: NativeSheetLibrary;\n /**\n * Toasts (`useToast()` from `@marktiderman/genesis-ui-native`): `NativeToastProvider` is\n * mounted around the screens, at the top of the screen by default (a bottom toast would sit on\n * a tab bar). Pass its options to place it, or `null` to mount your own. Read once.\n */\n toast?: Pick<NativeToastProviderProps, \"position\" | \"disableAnimation\"> | null;\n /** Follow a link held while signed out, once the user signs in. */\n links?: { hold: LinkHold; onRelease: (path: string) => void };\n /** Run before first render, in order (wipe-on-reinstall, hydrate stores, fonts). Read once. */\n steps?: readonly BootStep[];\n bootOptions?: BootOptions;\n /** Longest wait for Supabase's `getSession()` before using the stored session (offline). Default 5000 ms. */\n sessionWaitMs?: number;\n /** Default `globalThis.ErrorUtils`. */\n errorUtils?: ErrorUtilsLike;\n /** Report unhandled promise rejections to `onError`. Default Hermes's tracker; `null` turns it off. */\n rejectionTracker?: EnableRejectionTracker | null;\n /** `AppState` and NetInfo, so queries refetch on focus and know the network. */\n lifecycle?: QueryLifecycleOptions;\n /**\n * Report queries and mutations that failed for good to `onError` (and so\n * to the observability block), non-fatal, as `query` / `mutation` with the\n * key's first segment as a tag. Only unexpected errors: offline, signed\n * out, not found and the server's expected refusals are left to the\n * screen. One query opts out with `meta: { reportErrors: false }`.\n * Default true. Read once.\n */\n reportQueryErrors?: boolean;\n /**\n * Every caught error, after the blocks' own `onError` (the observability\n * block, `createObservability` from `/observability`, reports to Sentry\n * there). A throwing reporter is ignored.\n */\n onError?: OnError;\n /** After a signed-in user signs out, once the query cache is cleared. */\n onSignedOut?: () => void;\n /**\n * The updates block: `createUpdates(…)` from `@marktiderman/genesis-native/updates`\n * (force upgrade, maintenance, the update banner, what's new). Its policy\n * loads behind the splash for at most `policyTimeoutMs` and never fails the\n * boot. Read once; leave it out to turn the block off.\n */\n updates?: UpdatesBlock;\n /**\n * Blocks to run (`createUpdates(…)` is one). Resolved once at start: a\n * block whose requirement is missing, or two blocks contributing the same\n * slot, nav entry or Settings row, shows the fatal screen and reports a\n * `BlockError` to `onError`. Read once.\n */\n blocks?: readonly NativeBlock[];\n /**\n * Your features (FeatureIds) that blocks may require but that aren't\n * blocks. A block requiring anything that is neither one of `blocks` nor\n * listed here is a `BlockError`. Read once.\n */\n appFeatures?: readonly string[];\n slots?: Slots<NativeAppSlots>;\n slotProps?: SlotPropsFor<NativeAppSlots>;\n children?: ReactNode;\n}\n\n/** The default boot slot: a plain loading view (the splash covers it at launch). */\nexport function BootScreen(_props: BootScreenProps) {\n return (\n <View testID=\"genesis-boot\" accessibilityRole=\"progressbar\" style={{ flex: 1, justifyContent: \"center\", alignItems: \"center\" }}>\n <Text>Loading…</Text>\n </View>\n );\n}\n\nconst PassThrough: ComponentType<SignedOutProps> = ({ children }) => <>{children}</>;\n\n// The web provider's types don't list the native-only prop; Metro resolves the native provider.\nconst ThemeProvider = GenesisThemeProvider as ComponentType<{\n brand: CanonicalBrand;\n syncNativeAppearance?: boolean;\n children: ReactNode;\n}>;\n\n/**\n * The root of an Expo app: theme, keyboard, data, boot behind the splash, errors, session and held links.\n *\n * @stability Beta\n */\nexport function GenesisNativeApp(props: GenesisNativeAppProps) {\n // Above every provider: if one of them (or the shell's own set-up) throws,\n // this shows a screen made of nothing that can fail, and retry starts over.\n const [rootKey, setRootKey] = useState(0);\n const onErrorRef = useRef(props.onError);\n onErrorRef.current = props.onError;\n // The blocks as given, before they are resolved: an error here may come from resolving them.\n const blocksRef = useRef(givenBlocks(props));\n const splashRef = useRef(props.splash);\n splashRef.current = props.splash;\n return (\n <GenesisErrorBoundary\n key={rootKey}\n fallback={PlainFatalScreen}\n onError={(e, r) => {\n reportToBlocks(blocksRef.current, e, r);\n try {\n onErrorRef.current?.(e, r);\n } catch {\n // A failing reporter must not stop the fatal screen.\n }\n // The shell (which hides the splash) never mounted: hide it here, or the screen stays behind it.\n splashRef.current?.hideAsync().catch(() => {});\n }}\n onRetry={() => setRootKey((key) => key + 1)}\n >\n <ThemedShell {...props} />\n </GenesisErrorBoundary>\n );\n}\n\ndeclare const __DEV__: boolean | undefined;\n\nconst MISSING_KEYBOARD_PROVIDER =\n \"GenesisNativeApp: `keyboardScroll` was given without `keyboardProvider`, so form screens won't move above the keyboard. \" +\n 'Pass `keyboardProvider={KeyboardProvider}` from \"react-native-keyboard-controller\" too.';\n\nconst TOOLBAR_WITHOUT_SCROLL =\n \"GenesisNativeApp: `keyboardToolbar` was given without `keyboardScroll`, so it is ignored. \" +\n 'Pass `keyboardScroll={KeyboardAwareScrollView}` and `keyboardProvider={KeyboardProvider}` from \"react-native-keyboard-controller\" too.';\n\nfunction ThemedShell(props: GenesisNativeAppProps) {\n const { brand, keyboardScroll, keyboardToolbar } = props;\n // Frozen: a new component type here (an inline wrapper) would remount the shell and reset the app.\n const [Keyboard] = useState(() => props.keyboardProvider);\n // Frozen too: an inline object would hand every component a new module set each render.\n const [modules] = useState(() => props.modules);\n const [toast] = useState(() => (props.toast === null ? null : { position: \"top\" as const, ...props.toast }));\n const missingProvider = Boolean(keyboardScroll) && !Keyboard;\n const toolbarWithoutScroll = Boolean(keyboardToolbar) && !keyboardScroll;\n useEffect(() => {\n if (typeof __DEV__ === \"undefined\" || !__DEV__) return;\n // genesis-allow-console: development-only set-up mistakes, shown as LogBox errors on purpose.\n if (missingProvider) console.error(MISSING_KEYBOARD_PROVIDER);\n if (toolbarWithoutScroll) console.error(TOOLBAR_WITHOUT_SCROLL);\n }, [missingProvider, toolbarWithoutScroll]);\n let body = <Shell {...props} />;\n // Inside the modules: a toast animates with Reanimated and draws Liquid Glass when the app gave them.\n if (toast) body = <NativeToastProvider {...toast}>{body}</NativeToastProvider>;\n if (modules) body = <GenesisModulesProvider modules={modules}>{body}</GenesisModulesProvider>;\n if (keyboardScroll) body = <KeyboardScrollProvider component={keyboardScroll} toolbar={keyboardToolbar}>{body}</KeyboardScrollProvider>;\n if (Keyboard) body = <Keyboard>{body}</Keyboard>;\n return (\n <ThemeProvider brand={brand} syncNativeAppearance>\n {body}\n </ThemeProvider>\n );\n}\n\nconst SESSION_STEP_MARGIN_MS = 15_000;\n\nfunction Shell(props: GenesisNativeAppProps) {\n const { supabase, provider, queryClient: queryOptions, persist, splash, links, steps = [], bootOptions, sessionWaitMs = 5000 } = props;\n const { errorUtils, rejectionTracker, lifecycle, slotProps, children } = props;\n const latest = useRef(props);\n latest.current = props;\n const [blockList] = useState(() => givenBlocks(props));\n // Read once, like the keyboard provider: a different module later would remount the screens.\n const [bottomSheet] = useState(() => props.bottomSheet);\n const onError: OnError = (error, report) => {\n reportToBlocks(blockList, error, report);\n try {\n latest.current.onError?.(error, report);\n } catch {\n // A failing reporter must not take the shell down with it.\n }\n };\n // How many fatal screens are up (the global handler lets a second fatal error end the app).\n const fatalShown = useRef(0);\n\n // Created once: the shell's parts live as long as the app.\n const [parts] = useState(() => {\n const list = blockList;\n const blocks = resolveBlocks(list, props.appFeatures ? [...list.map((b) => b.id), ...props.appFeatures] : undefined, {\n platform: \"native\",\n slots: NATIVE_APP_SLOT_NAMES,\n });\n const client = queryOptions?.client ?? createNativeQueryClient(queryOptions?.config);\n const persistence = persist ? persist(client) : null;\n const session = createSessionStore(supabase, {\n waitMs: sessionWaitMs,\n // Another user (or nobody) now: nothing of the last user's may show or stay on disk.\n onUserChange: (previous, next) => {\n client.clear();\n void persistence?.clear();\n if (previous !== null && next === null) latest.current.onSignedOut?.();\n },\n });\n const boot = createBoot(\n [\n ...steps,\n // Blocks' steps, in dependency order (the updates block's settles within its own timeout and never throws).\n ...blocks.blocks.flatMap((block) => block.bootSteps ?? []),\n { id: \"genesis:session\", run: () => session.load(), timeoutMs: sessionWaitMs + SESSION_STEP_MARGIN_MS },\n // After the session, so only the cache saved for this user is restored.\n ...(persistence ? [{ id: \"genesis:query-cache\", run: () => persistence.restore(session.getState().userId ?? \"\") }] : []),\n ],\n bootOptions,\n );\n // One component type for the life of the app, so a re-render never remounts a visible fatal screen.\n function FatalFallback(fallbackProps: FatalScreenProps) {\n useEffect(() => {\n fatalShown.current++;\n return () => {\n fatalShown.current--;\n };\n }, []);\n const { slotProps: sp } = latest.current;\n const s = withBlockSlots(blocks.slots, latest.current.slots);\n return (\n // A `fatal` slot that throws falls back to the plain screen.\n <GenesisErrorBoundary fallback={PlainFatalScreen} onError={onError} onRetry={fallbackProps.retry}>\n {renderSlot(FatalScreen, s?.fatal, fallbackProps, sp?.fatal)}\n </GenesisErrorBoundary>\n );\n }\n return { client, persistence, session, boot, FatalFallback, blocks, provider: provider ?? createSupabaseProvider(supabase) };\n });\n const { boot, session, persistence, client, FatalFallback } = parts;\n const slots = withBlockSlots(parts.blocks.slots, props.slots);\n const bootState = useSyncExternalStore(boot.subscribe, boot.getState, boot.getState);\n const sessionState = useSyncExternalStore(session.subscribe, session.getState, session.getState);\n const [fatal, setFatal] = useState<Error | null>(null);\n const [resetKey, setResetKey] = useState(0);\n\n useEffect(() => session.start(), [session]);\n useEffect(() => {\n void boot.start();\n }, [boot]);\n useEffect(() => {\n if (bootState.status === \"failed\" && bootState.error) onError(bootState.error, { fatal: true, source: \"boot\" });\n }, [bootState.status, bootState.error]);\n useEffect(() => {\n if (bootState.status === \"ready\" && persistence) return persistence.subscribe(sessionState.userId ?? \"\");\n }, [bootState.status, persistence, sessionState.userId]);\n useEffect(() => {\n const utils = errorUtils ?? defaultErrorUtils();\n if (!utils) return;\n return installGlobalErrorHandler({ errorUtils: utils, onError, onFatal: setFatal, alreadyFatal: () => fatalShown.current > 0 });\n }, [errorUtils]);\n useEffect(() => {\n const enable = rejectionTracker === null ? undefined : (rejectionTracker ?? defaultRejectionTracker());\n if (enable) installRejectionTracker({ enable, onError });\n }, [rejectionTracker]);\n useEffect(() => (lifecycle ? connectQueryLifecycle(lifecycle) : undefined), [lifecycle]);\n const [queryReports] = useState(() => props.reportQueryErrors !== false);\n useEffect(() => (queryReports ? reportQueryErrors(client, onError) : undefined), [client, queryReports]);\n\n // Splash: up until boot has finished (the session step included), or failed.\n const settled = bootState.status === \"ready\" || bootState.status === \"failed\" || fatal !== null;\n const splashHidden = useRef(false);\n useEffect(() => {\n if (!settled || !splash || splashHidden.current) return;\n splashHidden.current = true;\n splash.hideAsync().catch(() => {});\n }, [settled, splash]);\n\n const auth: HeldLinkAuth = bootState.status !== \"ready\" || sessionState.status === \"loading\" ? \"pending\" : sessionState.status;\n useHeldLink(links?.hold ?? NO_HOLD, { auth: links ? auth : \"pending\", onRelease: (path) => links?.onRelease(path) });\n\n const retry = () => {\n setFatal(null);\n setResetKey((key) => key + 1);\n if (boot.getState().status === \"failed\") void boot.retry();\n };\n\n let content: ReactNode;\n if (fatal) {\n content = <FatalFallback error={fatal} retry={retry} />;\n } else if (bootState.status === \"failed\" && bootState.error) {\n content = <FatalFallback error={bootState.error} retry={retry} />;\n } else if (bootState.status !== \"ready\") {\n content = renderSlot(BootScreen, slots?.boot, { status: bootState.status }, slotProps?.boot);\n } else {\n const screens =\n sessionState.status === \"signedOut\" ? renderSlot(PassThrough, slots?.signedOut, { children }, slotProps?.signedOut) : children;\n const guarded = renderSlot(\n GenesisErrorBoundary,\n slots?.errorBoundary,\n { fallback: FatalFallback, onError, resetKey, onRetry: retry, children: screens },\n slotProps?.errorBoundary,\n );\n // The first block's root is the outermost.\n content = parts.blocks.blocks.reduceRight<ReactNode>((inner, block) => {\n const Root = block.Root;\n return Root ? (\n <Root key={block.id} slots={slots} slotProps={slotProps}>\n {inner}\n </Root>\n ) : (\n inner\n );\n }, guarded);\n }\n\n return (\n <GenesisProvider provider={parts.provider} queryClient={client}>\n <SessionProvider store={session}>\n <BootProvider boot={boot}>\n <BlocksProvider value={parts.blocks}>\n <GenesisErrorBoundary key={resetKey} fallback={FatalFallback} onError={onError} onRetry={retry}>\n {/* Sheet content renders in the library's portal, here: below data, session, boot and blocks. */}\n {bottomSheet ? <NativeSheetProvider bottomSheet={bottomSheet}>{content}</NativeSheetProvider> : content}\n </GenesisErrorBoundary>\n </BlocksProvider>\n </BootProvider>\n </SessionProvider>\n </GenesisProvider>\n );\n}\n\n// Every slot name, checked against NativeAppSlots by the compiler: a block filling any other is a BlockError.\nconst SLOT_NAMES: Record<keyof NativeAppSlots, true> = {\n boot: true,\n fatal: true,\n errorBoundary: true,\n signedOut: true,\n forceUpgrade: true,\n maintenance: true,\n updateBanner: true,\n whatsNew: true,\n devtoolsFeedback: true,\n pushPrompt: true,\n};\nconst NATIVE_APP_SLOT_NAMES: readonly string[] = Object.keys(SLOT_NAMES);\n\n/** Blocks' slot fills under the app's own slots: the app's (a component or `null`) always win. */\nfunction withBlockSlots(fills: Readonly<Record<string, unknown>>, own: Slots<NativeAppSlots> | undefined): Slots<NativeAppSlots> | undefined {\n if (Object.keys(fills).length === 0) return own;\n return { ...(fills as Slots<NativeAppSlots>), ...own };\n}\n\n/** `blocks`, with `updates` added when it was given on its own (given both ways, it runs once). */\nfunction givenBlocks(props: Pick<GenesisNativeAppProps, \"blocks\" | \"updates\">): readonly NativeBlock[] {\n const given = props.blocks ?? [];\n return props.updates && !given.includes(props.updates) ? [...given, props.updates] : given;\n}\n\nconst NO_HOLD: LinkHold = {\n hold: () => {},\n peek: () => null,\n take: () => null,\n clear: () => {},\n subscribe: () => () => {},\n};\n","/**\n * A hydration gate holds writes until a persisted store has loaded from disk.\n *\n * The bug it prevents: a persisted store (zustand `persist`, say) is created\n * with defaults, something sets a value before the saved state has been read,\n * and that write lands on disk first, replacing what the user had. With the\n * gate, a write made before hydration never reaches disk (`storage()`), or\n * waits for it (`run()`).\n *\n * const gate = createHydrationGate();\n * persist(store, {\n * storage: createJSONStorage(() => gate.storage(AsyncStorage)),\n * // Open only after a good read: after a failed one, writes would replace what's on disk.\n * onRehydrateStorage: () => (_state, error) => {\n * if (!error) gate.markHydrated();\n * },\n * });\n */\nimport type { AsyncStorageLike } from \"./query\";\n\nexport interface HydrationGate {\n readonly hydrated: boolean;\n /** Call once the store has read its saved state. Idempotent. */\n markHydrated(): void;\n /** Resolves once hydrated. */\n whenHydrated(): Promise<void>;\n /** Run a write now if hydrated, otherwise once hydrated. */\n run<T>(write: () => T | Promise<T>): Promise<T>;\n /**\n * The storage, with writes made before hydration dropped (reads pass\n * through, since hydration is a read). After hydration the store writes\n * its merged state on its next change, so nothing is lost but the stale\n * write. (A zustand migration's own write during hydration is dropped too;\n * the old version stays on disk and is migrated again until then.)\n */\n storage<S extends AsyncStorageLike>(storage: S): S;\n}\n\nexport interface HydrationGateOptions {\n /** Told about each write `storage()` dropped (to log it in development). */\n onDroppedWrite?: (key: string) => void;\n}\n\n/** A gate that holds writes until a persisted store has hydrated. */\nexport function createHydrationGate({ onDroppedWrite }: HydrationGateOptions = {}): HydrationGate {\n let hydrated = false;\n let open!: () => void;\n const opened = new Promise<void>((resolve) => {\n open = resolve;\n });\n\n const gate: HydrationGate = {\n get hydrated() {\n return hydrated;\n },\n markHydrated() {\n if (hydrated) return;\n hydrated = true;\n open();\n },\n whenHydrated: () => opened,\n async run(write) {\n if (!hydrated) await opened;\n return write();\n },\n storage(storage) {\n const setItem = async (key: string, value: string) => {\n if (!hydrated) return onDroppedWrite?.(key);\n return storage.setItem(key, value);\n };\n const removeItem = async (key: string) => {\n if (!hydrated) return onDroppedWrite?.(key);\n return storage.removeItem(key);\n };\n // A proxy, not a spread: a storage class's prototype methods (and its\n // private fields, through `this`) keep working.\n return new Proxy(storage, {\n get(target, property) {\n if (property === \"setItem\") return setItem;\n if (property === \"removeItem\") return removeItem;\n const value = Reflect.get(target, property, target) as unknown;\n return typeof value === \"function\" ? value.bind(target) : value;\n },\n });\n },\n };\n return gate;\n}\n"]}
1
+ {"version":3,"sources":["../src/held-link.ts","../src/app.tsx","../src/hydration-gate.ts"],"names":["useRef","useEffect","client","persistence","session","boot","FatalFallback","useSyncExternalStore"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Hold a deep link until sign-in completes.\n *\n * expo-router opens every incoming link itself. For a signed-in user that is\n * all that should happen. For a signed-out user, the auth layout redirects to\n * sign-in and the link is lost; holding it lets the app go there once the user\n * has signed in. The hold lives outside React, because expo-router's\n * `+native-intent` runs before any component:\n *\n * // lib/links.ts\n * export const linkHold = createLinkHold();\n * // app/+native-intent.ts\n * export function redirectSystemPath({ path }) {\n * const to = normalizeLink(path, links);\n * if (to && to !== \"/\") linkHold.hold(to);\n * return to;\n * }\n *\n * `useHeldLink` follows a held link only if the user was seen signed out\n * while it was held. A link that arrives while signed in, or at a cold start\n * that turns out signed in, is dropped, since the router already opened it.\n * `GenesisNativeApp` runs it for you (`links.onRelease`).\n */\nimport { useEffect, useRef, useSyncExternalStore } from \"react\";\n\nexport interface LinkHold {\n /** Hold `path`, replacing any held one. */\n hold(path: string): void;\n peek(): string | null;\n /** Return the held path and forget it. */\n take(): string | null;\n clear(): void;\n subscribe(listener: () => void): () => void;\n}\n\n/** A place to hold one deep link until sign-in completes; lives outside React. */\nexport function createLinkHold(): LinkHold {\n let held: string | null = null;\n const listeners = new Set<() => void>();\n const set = (next: string | null) => {\n if (held === next) return;\n held = next;\n for (const listener of listeners) listener();\n };\n return {\n hold: (path) => set(path),\n peek: () => held,\n take() {\n const path = held;\n set(null);\n return path;\n },\n clear: () => set(null),\n subscribe(listener) {\n listeners.add(listener);\n return () => listeners.delete(listener);\n },\n };\n}\n\n/** `\"pending\"` while booting or reading the session. */\nexport type HeldLinkAuth = \"pending\" | \"signedOut\" | \"signedIn\";\n\nexport interface UseHeldLinkOptions {\n auth: HeldLinkAuth;\n /** Go there, e.g. `(path) => router.replace(path)`. Called once per link held across a sign-in. */\n onRelease: (path: string) => void;\n}\n\n/** Follow the held link after a sign-in, drop it otherwise; returns the link still held. */\nexport function useHeldLink(hold: LinkHold, { auth, onRelease }: UseHeldLinkOptions): string | null {\n const held = useSyncExternalStore(hold.subscribe, hold.peek, hold.peek);\n const release = useRef(onRelease);\n release.current = onRelease;\n // Was the user signed out while this link was held?\n const waitedForSignIn = useRef(false);\n useEffect(() => {\n if (held === null) {\n waitedForSignIn.current = false;\n return;\n }\n if (auth === \"signedOut\") waitedForSignIn.current = true;\n if (auth !== \"signedIn\") return;\n const path = hold.take();\n const follow = waitedForSignIn.current;\n waitedForSignIn.current = false;\n if (path !== null && follow) release.current(path);\n }, [auth, held, hold]);\n return held;\n}\n","/**\n * `<GenesisNativeApp>`: everything above an Expo app's screens, so the root\n * `_layout.tsx` is a few lines.\n *\n * last-resort boundary (React Native primitives only)\n * └ theme (GenesisThemeProvider, owning the platform color scheme; with `brandVariables`,\n * role variables on a view around the app for NativeWind's role classes; with\n * `modules.navigation`, React Navigation's theme in the same colors and mode)\n * └ keyboard (`keyboardProvider`, once, then `keyboardScroll` for form screens)\n * └ toasts (`NativeToastProvider`, so `useToast()` works on every screen; `toast={null}` drops it)\n * └ data (GenesisProvider over the Supabase client, the QueryClient)\n * └ session + boot (splash held until both are known)\n * └ blocks' roots (with `blocks`, e.g. updates: force upgrade, maintenance, banner, what's new)\n * └ errorBoundary → `bottomSheet`'s provider, if given → your screens (or `signedOut`)\n *\n * Every error the shell catches goes to each block's `onError` (the\n * observability block reports it) and then to the app's own `onError`:\n * render, global, boot and unhandled-rejection errors, and queries and\n * mutations that failed unexpectedly (`reportQueryErrors`).\n *\n * `blocks` (`defineBlock` declarations a native shell can run) are resolved\n * once: requirements checked, boot steps run behind the splash, roots\n * mounted, slot fills put under your `slots`, Settings rows handed to\n * `useBlockSettings`.\n * Global errors, render errors and a failed boot show the `fatal` slot with\n * \"Try again\". Every part is a slot (`slots` / `slotProps`, `null` drops it)\n * and is also exported on its own.\n */\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore, type ComponentType, type ReactNode } from \"react\";\nimport { Text, View } from \"react-native\";\nimport type { QueryClient, QueryClientConfig } from \"@tanstack/react-query\";\nimport { vars } from \"nativewind\";\nimport { GenesisThemeProvider, useTheme } from \"@marktiderman/genesis-design-system/theme\";\nimport { brandRoleVariables, type CanonicalBrand } from \"@marktiderman/genesis-design-system\";\nimport { GenesisProvider, createSupabaseProvider, type DataProvider, type SupabaseClientInput } from \"@marktiderman/genesis-core/provider\";\nimport { renderSlot, type SlotPropsFor, type Slots } from \"@marktiderman/genesis-core/slots\";\nimport { KeyboardScrollProvider, type KeyboardScrollProps, type KeyboardToolbarProps } from \"@marktiderman/genesis-ui-native/layouts\";\nimport {\n GenesisModulesProvider,\n NativeSheetProvider,\n NativeToastProvider,\n type GenesisModules,\n type GenesisNavigationModule,\n type GenesisNavigationTheme,\n type NativeSheetLibrary,\n type NativeToastProviderProps,\n} from \"@marktiderman/genesis-ui-native/components\";\nimport { BootProvider, createBoot, type BootOptions, type BootStatus, type BootStep } from \"./boot\";\nimport {\n FatalScreen,\n GenesisErrorBoundary,\n PlainFatalScreen,\n defaultErrorUtils,\n defaultRejectionTracker,\n installGlobalErrorHandler,\n installRejectionTracker,\n type EnableRejectionTracker,\n type ErrorUtilsLike,\n type FatalScreenProps,\n type GenesisErrorBoundaryProps,\n type OnError,\n} from \"./errors\";\nimport { SessionProvider, createSessionStore, type AuthClientLike } from \"./auth\";\nimport { useHeldLink, type HeldLinkAuth, type LinkHold } from \"./held-link\";\nimport { connectQueryLifecycle, createNativeQueryClient, reportQueryErrors, type QueryLifecycleOptions, type QueryPersistence } from \"./query\";\nimport { resolveBlocks } from \"@marktiderman/genesis-features/blocks\";\nimport { BlocksProvider, reportToBlocks, type NativeBlock } from \"./blocks\";\nimport type { DevtoolsSlots } from \"./devtools/slots\";\n// Types only: the block's code is in the `/updates` entry and arrives with the `updates` prop.\nimport type { UpdatesBlock, UpdatesSlots } from \"./updates/block\";\n// Types only, likewise: the push block (`/push`) arrives in `blocks`.\nimport type { PushSlots } from \"./push/block\";\n\n/** `expo-splash-screen`, or a stand-in. Call `preventAutoHideAsync()` at module scope yourself too. */\nexport interface SplashModule {\n preventAutoHideAsync?: () => Promise<unknown>;\n hideAsync: () => Promise<unknown>;\n}\n\nexport interface BootScreenProps {\n status: BootStatus;\n}\n\nexport interface SignedOutProps {\n /** Your screens. The default renders them, for an expo-router layout that redirects. */\n children: ReactNode;\n}\n\n// A type, not an interface, so it fits the slots contract's Record constraint.\n// The updates block's slots (`forceUpgrade`, `maintenance`, `updateBanner`,\n// `whatsNew`) render only when the `updates` prop is given.\nexport type NativeAppSlots = UpdatesSlots &\n PushSlots &\n DevtoolsSlots & {\n /** Shown while booting: under the splash at launch, on its own after \"Try again\". Default `BootScreen`. */\n boot: BootScreenProps;\n /** A failed boot, a fatal global error or a render error. Default `FatalScreen`. */\n fatal: FatalScreenProps;\n /** The boundary around your screens. Default `GenesisErrorBoundary`. */\n errorBoundary: GenesisErrorBoundaryProps;\n /** What a signed-out user sees. Default your screens (gate them with `useSession`). */\n signedOut: SignedOutProps;\n};\n\nexport interface NativeQueryClientOptions {\n /** Your own client. Default `createNativeQueryClient(config)`. */\n client?: QueryClient;\n config?: QueryClientConfig;\n}\n\nexport interface GenesisNativeAppProps {\n brand: CanonicalBrand;\n /** A Supabase client (from `createGenesisSupabase` in `@marktiderman/genesis-supabase`). */\n supabase: AuthClientLike & SupabaseClientInput;\n /** The data provider. Default `createSupabaseProvider(supabase)`. */\n provider?: DataProvider;\n queryClient?: NativeQueryClientOptions;\n /**\n * Save queries to the phone: `persistQueries({ storage, keys, buster })`\n * from `@marktiderman/genesis-native/persist`. The saved cache belongs to\n * one user: it is restored only for that user and cleared when the user\n * changes (sign-out, a session that ended while the app was closed, an\n * account switch).\n */\n persist?: (client: QueryClient) => QueryPersistence;\n /** `expo-splash-screen`: hidden once boot has finished and the session is known. */\n splash?: SplashModule;\n /**\n * `KeyboardProvider` from react-native-keyboard-controller, mounted once\n * around the app. Its keyboard views (`keyboardScroll` included) do nothing\n * without it: give both or neither. Read once: it wraps the whole app, so\n * a different component later would remount everything below it. To pass\n * it props, define the wrapper at module scope, not inline.\n */\n keyboardProvider?: ComponentType<{ children: ReactNode }>;\n /**\n * Theme role variables (`--primary`, `--background`, …) to set on a view\n * around the app, over what the app's stylesheet declares on `:root`.\n * Default `false`: none are set, so the app's own variables (from\n * `createGenesisNativewindPreset({ brand })` or its brand package) stand.\n * `true` sets `brandRoleVariables(brand)` for the current mode; an object\n * sets the app's own, one map for both modes or `{ light, dark }`.\n */\n brandVariables?: boolean | Record<string, string> | { light: Record<string, string>; dark: Record<string, string> };\n /**\n * React Navigation's theme (headers, tab bars, the screen background), when\n * `modules.navigation` is given. Default: worked out from the same role\n * variables as `brandVariables` (the app's own when it passes them,\n * `brandRoleVariables(brand)` otherwise), for the current mode, so a header\n * is never light in dark mode. Pass a theme (or `{ light, dark }`) to use\n * your own, or `false` to set none.\n */\n navigationTheme?: false | GenesisNavigationTheme | { light: GenesisNavigationTheme; dark: GenesisNavigationTheme };\n /** `KeyboardAwareScrollView` from react-native-keyboard-controller, for form screens. Needs `keyboardProvider`. */\n keyboardScroll?: ComponentType<KeyboardScrollProps>;\n /**\n * `KeyboardToolbar` from react-native-keyboard-controller: previous / next /\n * done above the keyboard on Genesis's form layouts. Needs `keyboardScroll`\n * (and so `keyboardProvider`); without them it is ignored.\n */\n keyboardToolbar?: ComponentType<KeyboardToolbarProps>;\n /**\n * The optional native modules the app installed, for Genesis components to\n * use (`GenesisModulesProvider` from `@marktiderman/genesis-ui-native`):\n * FlashList, expo-image, Reanimated, expo-glass-effect, expo-symbols, a\n * lucide icon set, the @expo/ui date picker. Each one left out falls back\n * to plain React Native. Read once.\n */\n modules?: GenesisModules;\n /**\n * `@gorhom/bottom-sheet` v5, to opt every `NativeSheet` into it (snap\n * points, drag between heights): `import * as BottomSheet from \"@gorhom/bottom-sheet\"`,\n * then `bottomSheet={BottomSheet}`. The app mounts `NativeSheetProvider`\n * (and so the library's `BottomSheetModalProvider`) for you; the app's root\n * must still be inside gesture-handler's `GestureHandlerRootView`, with\n * Reanimated set up. Leave it out and sheets are React Native's own modal\n * (an iOS page sheet), which needs neither. Read once.\n */\n bottomSheet?: NativeSheetLibrary;\n /**\n * Toasts (`useToast()` from `@marktiderman/genesis-ui-native`): `NativeToastProvider` is\n * mounted around the screens, at the top of the screen by default (a bottom toast would sit on\n * a tab bar). Pass its options to place it, or `null` to mount your own. Read once.\n */\n toast?: Pick<NativeToastProviderProps, \"position\" | \"disableAnimation\"> | null;\n /** Follow a link held while signed out, once the user signs in. */\n links?: { hold: LinkHold; onRelease: (path: string) => void };\n /** Run before first render, in order (wipe-on-reinstall, hydrate stores, fonts). Read once. */\n steps?: readonly BootStep[];\n bootOptions?: BootOptions;\n /** Longest wait for Supabase's `getSession()` before using the stored session (offline). Default 5000 ms. */\n sessionWaitMs?: number;\n /** Default `globalThis.ErrorUtils`. */\n errorUtils?: ErrorUtilsLike;\n /** Report unhandled promise rejections to `onError`. Default Hermes's tracker; `null` turns it off. */\n rejectionTracker?: EnableRejectionTracker | null;\n /** `AppState` and NetInfo, so queries refetch on focus and know the network. */\n lifecycle?: QueryLifecycleOptions;\n /**\n * Report queries and mutations that failed for good to `onError` (and so\n * to the observability block), non-fatal, as `query` / `mutation` with the\n * key's first segment as a tag. Only unexpected errors: offline, signed\n * out, not found and the server's expected refusals are left to the\n * screen. One query opts out with `meta: { reportErrors: false }`.\n * Default true. Read once.\n */\n reportQueryErrors?: boolean;\n /**\n * Every caught error, after the blocks' own `onError` (the observability\n * block, `createObservability` from `/observability`, reports to Sentry\n * there). A throwing reporter is ignored.\n */\n onError?: OnError;\n /** After a signed-in user signs out, once the query cache is cleared. */\n onSignedOut?: () => void;\n /**\n * The updates block: `createUpdates(…)` from `@marktiderman/genesis-native/updates`\n * (force upgrade, maintenance, the update banner, what's new). Its policy\n * loads behind the splash for at most `policyTimeoutMs` and never fails the\n * boot. Read once; leave it out to turn the block off.\n */\n updates?: UpdatesBlock;\n /**\n * Blocks to run (`createUpdates(…)` is one). Resolved once at start: a\n * block whose requirement is missing, or two blocks contributing the same\n * slot, nav entry or Settings row, shows the fatal screen and reports a\n * `BlockError` to `onError`. Read once.\n */\n blocks?: readonly NativeBlock[];\n /**\n * Your features (FeatureIds) that blocks may require but that aren't\n * blocks. A block requiring anything that is neither one of `blocks` nor\n * listed here is a `BlockError`. Read once.\n */\n appFeatures?: readonly string[];\n slots?: Slots<NativeAppSlots>;\n slotProps?: SlotPropsFor<NativeAppSlots>;\n children?: ReactNode;\n}\n\n/** The default boot slot: a plain loading view (the splash covers it at launch). */\nexport function BootScreen(_props: BootScreenProps) {\n return (\n <View testID=\"genesis-boot\" accessibilityRole=\"progressbar\" style={{ flex: 1, justifyContent: \"center\", alignItems: \"center\" }}>\n <Text>Loading…</Text>\n </View>\n );\n}\n\nconst PassThrough: ComponentType<SignedOutProps> = ({ children }) => <>{children}</>;\n\n// The web provider's types don't list the native-only prop; Metro resolves the native provider.\nconst ThemeProvider = GenesisThemeProvider as ComponentType<{\n brand: CanonicalBrand;\n syncNativeAppearance?: boolean;\n children: ReactNode;\n}>;\n\n/**\n * The root of an Expo app: theme, keyboard, data, boot behind the splash, errors, session and held links.\n *\n * @stability Beta\n */\nexport function GenesisNativeApp(props: GenesisNativeAppProps) {\n // Above every provider: if one of them (or the shell's own set-up) throws,\n // this shows a screen made of nothing that can fail, and retry starts over.\n const [rootKey, setRootKey] = useState(0);\n const onErrorRef = useRef(props.onError);\n onErrorRef.current = props.onError;\n // The blocks as given, before they are resolved: an error here may come from resolving them.\n const blocksRef = useRef(givenBlocks(props));\n const splashRef = useRef(props.splash);\n splashRef.current = props.splash;\n return (\n <GenesisErrorBoundary\n key={rootKey}\n fallback={PlainFatalScreen}\n onError={(e, r) => {\n reportToBlocks(blocksRef.current, e, r);\n try {\n onErrorRef.current?.(e, r);\n } catch {\n // A failing reporter must not stop the fatal screen.\n }\n // The shell (which hides the splash) never mounted: hide it here, or the screen stays behind it.\n splashRef.current?.hideAsync().catch(() => {});\n }}\n onRetry={() => setRootKey((key) => key + 1)}\n >\n <ThemedShell {...props} />\n </GenesisErrorBoundary>\n );\n}\n\ndeclare const __DEV__: boolean | undefined;\n\nconst MISSING_KEYBOARD_PROVIDER =\n \"GenesisNativeApp: `keyboardScroll` was given without `keyboardProvider`, so form screens won't move above the keyboard. \" +\n 'Pass `keyboardProvider={KeyboardProvider}` from \"react-native-keyboard-controller\" too.';\n\nconst TOOLBAR_WITHOUT_SCROLL =\n \"GenesisNativeApp: `keyboardToolbar` was given without `keyboardScroll`, so it is ignored. \" +\n 'Pass `keyboardScroll={KeyboardAwareScrollView}` and `keyboardProvider={KeyboardProvider}` from \"react-native-keyboard-controller\" too.';\n\nfunction ThemedShell(props: GenesisNativeAppProps) {\n const { brand, keyboardScroll, keyboardToolbar } = props;\n // Frozen: a new component type here (an inline wrapper) would remount the shell and reset the app.\n const [Keyboard] = useState(() => props.keyboardProvider);\n // Frozen too: an inline object would hand every component a new module set each render.\n const [modules] = useState(() => props.modules);\n const [toast] = useState(() => (props.toast === null ? null : { position: \"top\" as const, ...props.toast }));\n const missingProvider = Boolean(keyboardScroll) && !Keyboard;\n const toolbarWithoutScroll = Boolean(keyboardToolbar) && !keyboardScroll;\n useEffect(() => {\n if (typeof __DEV__ === \"undefined\" || !__DEV__) return;\n // genesis-allow-console: development-only set-up mistakes, shown as LogBox errors on purpose.\n if (missingProvider) console.error(MISSING_KEYBOARD_PROVIDER);\n if (toolbarWithoutScroll) console.error(TOOLBAR_WITHOUT_SCROLL);\n }, [missingProvider, toolbarWithoutScroll]);\n let body = <Shell {...props} />;\n // Inside the modules: a toast animates with Reanimated and draws Liquid Glass when the app gave them.\n if (toast) body = <NativeToastProvider {...toast}>{body}</NativeToastProvider>;\n if (modules) body = <GenesisModulesProvider modules={modules}>{body}</GenesisModulesProvider>;\n if (keyboardScroll) body = <KeyboardScrollProvider component={keyboardScroll} toolbar={keyboardToolbar}>{body}</KeyboardScrollProvider>;\n if (Keyboard) body = <Keyboard>{body}</Keyboard>;\n if (modules?.navigation && props.navigationTheme !== false) {\n body = (\n <NavigationTheme module={modules.navigation} brand={brand} brandVariables={props.brandVariables} given={props.navigationTheme}>\n {body}\n </NavigationTheme>\n );\n }\n return (\n <ThemeProvider brand={brand} syncNativeAppearance>\n {props.brandVariables ? (\n <BrandVariables brand={brand} given={props.brandVariables}>\n {body}\n </BrandVariables>\n ) : (\n body\n )}\n </ThemeProvider>\n );\n}\n\n/**\n * Theme role variables (`--primary`, `--background`, …) for the current mode,\n * set on a view around the app, so NativeWind's role classes (`bg-primary` is\n * `hsl(var(--primary))`) read them instead of what `:root` declares. Only with\n * `brandVariables`: NativeWind can't tell which `:root` variables are the\n * app's own, so setting them is the app's choice.\n */\nfunction BrandVariables({\n brand,\n given,\n children,\n}: {\n brand: CanonicalBrand;\n given: NonNullable<GenesisNativeAppProps[\"brandVariables\"]>;\n children: ReactNode;\n}) {\n const { resolvedMode } = useTheme();\n const variables = useMemo(() => {\n if (given === true) return brandRoleVariables(brand);\n const perMode = given as { light?: unknown; dark?: unknown };\n if (typeof perMode.light === \"object\" && typeof perMode.dark === \"object\") return given as { light: Record<string, string>; dark: Record<string, string> };\n return { light: given as Record<string, string>, dark: given as Record<string, string> };\n }, [brand, given]);\n const style = useMemo(() => [{ flex: 1 }, vars(variables[resolvedMode])], [variables, resolvedMode]);\n return (\n <View testID=\"genesis-brand-variables\" style={style}>\n {children}\n </View>\n );\n}\n\n/**\n * `\"240 10% 3.9%\"` (a role variable's value) → `\"hsl(240, 10%, 3.9%)\"`, and `\"240 10% 3.9% / 0.5\"`\n * → `\"hsla(240, 10%, 3.9%, 0.5)\"`; anything else as it is.\n */\nfunction roleColor(value: string | undefined): string | undefined {\n if (!value) return undefined;\n const [color = \"\", alpha] = value.split(\"/\").map((p) => p.trim());\n const parts = color.split(/\\s+/);\n if (parts.length !== 3) return value;\n return alpha ? `hsla(${parts.join(\", \")}, ${alpha})` : `hsl(${parts.join(\", \")})`;\n}\n\n/**\n * React Navigation's theme for the current mode, in the app's role colors: the\n * variables `brandVariables` sets (or `brandRoleVariables(brand)`) over React\n * Navigation's own light or dark theme, which keeps its fonts.\n */\nfunction NavigationTheme({\n module,\n brand,\n brandVariables,\n given,\n children,\n}: {\n module: GenesisNavigationModule;\n brand: CanonicalBrand;\n brandVariables: GenesisNativeAppProps[\"brandVariables\"];\n given: GenesisNativeAppProps[\"navigationTheme\"];\n children: ReactNode;\n}) {\n const { resolvedMode } = useTheme();\n const theme = useMemo((): GenesisNavigationTheme => {\n const base = resolvedMode === \"dark\" ? module.DarkTheme : module.DefaultTheme;\n if (given) {\n const perMode = given as { light?: GenesisNavigationTheme; dark?: GenesisNavigationTheme };\n const own = perMode.light && perMode.dark ? perMode[resolvedMode]! : (given as GenesisNavigationTheme);\n // React Navigation's headers read every font variant: a theme without fonts keeps the base's.\n return own.fonts ? own : { ...own, fonts: base.fonts };\n }\n // The app's own map over the brand's role colors, so a partial map never falls back to React Navigation's.\n let variables = brandRoleVariables(brand)[resolvedMode];\n if (brandVariables && brandVariables !== true) {\n const perMode = brandVariables as { light?: unknown; dark?: unknown };\n const own = typeof perMode.light === \"object\" && typeof perMode.dark === \"object\" ? (brandVariables as Record<\"light\" | \"dark\", Record<string, string>>)[resolvedMode] : (brandVariables as Record<string, string>);\n variables = { ...variables, ...own };\n }\n const pick = (name: string, fallback: GenesisNavigationTheme[\"colors\"][\"text\"]) => roleColor(variables[`--${name}`]) ?? fallback;\n return {\n ...base,\n dark: resolvedMode === \"dark\",\n colors: {\n ...base.colors,\n primary: pick(\"primary\", base.colors.primary),\n background: pick(\"background\", base.colors.background),\n card: pick(\"card\", base.colors.card),\n text: pick(\"foreground\", base.colors.text),\n border: pick(\"border\", base.colors.border),\n notification: pick(\"destructive\", base.colors.notification),\n },\n };\n }, [module, brand, brandVariables, given, resolvedMode]);\n const Provider = module.ThemeProvider;\n return <Provider value={theme}>{children}</Provider>;\n}\n\nconst SESSION_STEP_MARGIN_MS = 15_000;\n\nfunction Shell(props: GenesisNativeAppProps) {\n const { supabase, provider, queryClient: queryOptions, persist, splash, links, steps = [], bootOptions, sessionWaitMs = 5000 } = props;\n const { errorUtils, rejectionTracker, lifecycle, slotProps, children } = props;\n const latest = useRef(props);\n latest.current = props;\n const [blockList] = useState(() => givenBlocks(props));\n // Read once, like the keyboard provider: a different module later would remount the screens.\n const [bottomSheet] = useState(() => props.bottomSheet);\n const onError: OnError = (error, report) => {\n reportToBlocks(blockList, error, report);\n try {\n latest.current.onError?.(error, report);\n } catch {\n // A failing reporter must not take the shell down with it.\n }\n };\n // How many fatal screens are up (the global handler lets a second fatal error end the app).\n const fatalShown = useRef(0);\n\n // Created once: the shell's parts live as long as the app.\n const [parts] = useState(() => {\n const list = blockList;\n const blocks = resolveBlocks(list, props.appFeatures ? [...list.map((b) => b.id), ...props.appFeatures] : undefined, {\n platform: \"native\",\n slots: NATIVE_APP_SLOT_NAMES,\n });\n const client = queryOptions?.client ?? createNativeQueryClient(queryOptions?.config);\n const persistence = persist ? persist(client) : null;\n const session = createSessionStore(supabase, {\n waitMs: sessionWaitMs,\n // Another user (or nobody) now: nothing of the last user's may show or stay on disk.\n onUserChange: (previous, next) => {\n client.clear();\n void persistence?.clear();\n if (previous !== null && next === null) latest.current.onSignedOut?.();\n },\n });\n const boot = createBoot(\n [\n ...steps,\n // Blocks' steps, in dependency order (the updates block's settles within its own timeout and never throws).\n ...blocks.blocks.flatMap((block) => block.bootSteps ?? []),\n { id: \"genesis:session\", run: () => session.load(), timeoutMs: sessionWaitMs + SESSION_STEP_MARGIN_MS },\n // After the session, so only the cache saved for this user is restored.\n ...(persistence ? [{ id: \"genesis:query-cache\", run: () => persistence.restore(session.getState().userId ?? \"\") }] : []),\n ],\n bootOptions,\n );\n // One component type for the life of the app, so a re-render never remounts a visible fatal screen.\n function FatalFallback(fallbackProps: FatalScreenProps) {\n useEffect(() => {\n fatalShown.current++;\n return () => {\n fatalShown.current--;\n };\n }, []);\n const { slotProps: sp } = latest.current;\n const s = withBlockSlots(blocks.slots, latest.current.slots);\n return (\n // A `fatal` slot that throws falls back to the plain screen.\n <GenesisErrorBoundary fallback={PlainFatalScreen} onError={onError} onRetry={fallbackProps.retry}>\n {renderSlot(FatalScreen, s?.fatal, fallbackProps, sp?.fatal)}\n </GenesisErrorBoundary>\n );\n }\n return { client, persistence, session, boot, FatalFallback, blocks, provider: provider ?? createSupabaseProvider(supabase) };\n });\n const { boot, session, persistence, client, FatalFallback } = parts;\n const slots = withBlockSlots(parts.blocks.slots, props.slots);\n const bootState = useSyncExternalStore(boot.subscribe, boot.getState, boot.getState);\n const sessionState = useSyncExternalStore(session.subscribe, session.getState, session.getState);\n const [fatal, setFatal] = useState<Error | null>(null);\n const [resetKey, setResetKey] = useState(0);\n\n useEffect(() => session.start(), [session]);\n useEffect(() => {\n void boot.start();\n }, [boot]);\n useEffect(() => {\n if (bootState.status === \"failed\" && bootState.error) onError(bootState.error, { fatal: true, source: \"boot\" });\n }, [bootState.status, bootState.error]);\n useEffect(() => {\n if (bootState.status === \"ready\" && persistence) return persistence.subscribe(sessionState.userId ?? \"\");\n }, [bootState.status, persistence, sessionState.userId]);\n useEffect(() => {\n const utils = errorUtils ?? defaultErrorUtils();\n if (!utils) return;\n return installGlobalErrorHandler({ errorUtils: utils, onError, onFatal: setFatal, alreadyFatal: () => fatalShown.current > 0 });\n }, [errorUtils]);\n useEffect(() => {\n const enable = rejectionTracker === null ? undefined : (rejectionTracker ?? defaultRejectionTracker());\n if (enable) installRejectionTracker({ enable, onError });\n }, [rejectionTracker]);\n useEffect(() => (lifecycle ? connectQueryLifecycle(lifecycle) : undefined), [lifecycle]);\n const [queryReports] = useState(() => props.reportQueryErrors !== false);\n useEffect(() => (queryReports ? reportQueryErrors(client, onError) : undefined), [client, queryReports]);\n\n // Splash: up until boot has finished (the session step included), or failed.\n const settled = bootState.status === \"ready\" || bootState.status === \"failed\" || fatal !== null;\n const splashHidden = useRef(false);\n useEffect(() => {\n if (!settled || !splash || splashHidden.current) return;\n splashHidden.current = true;\n splash.hideAsync().catch(() => {});\n }, [settled, splash]);\n\n const auth: HeldLinkAuth = bootState.status !== \"ready\" || sessionState.status === \"loading\" ? \"pending\" : sessionState.status;\n useHeldLink(links?.hold ?? NO_HOLD, { auth: links ? auth : \"pending\", onRelease: (path) => links?.onRelease(path) });\n\n const retry = () => {\n setFatal(null);\n setResetKey((key) => key + 1);\n if (boot.getState().status === \"failed\") void boot.retry();\n };\n\n let content: ReactNode;\n if (fatal) {\n content = <FatalFallback error={fatal} retry={retry} />;\n } else if (bootState.status === \"failed\" && bootState.error) {\n content = <FatalFallback error={bootState.error} retry={retry} />;\n } else if (bootState.status !== \"ready\") {\n content = renderSlot(BootScreen, slots?.boot, { status: bootState.status }, slotProps?.boot);\n } else {\n const screens =\n sessionState.status === \"signedOut\" ? renderSlot(PassThrough, slots?.signedOut, { children }, slotProps?.signedOut) : children;\n const guarded = renderSlot(\n GenesisErrorBoundary,\n slots?.errorBoundary,\n { fallback: FatalFallback, onError, resetKey, onRetry: retry, children: screens },\n slotProps?.errorBoundary,\n );\n // The first block's root is the outermost.\n content = parts.blocks.blocks.reduceRight<ReactNode>((inner, block) => {\n const Root = block.Root;\n return Root ? (\n <Root key={block.id} slots={slots} slotProps={slotProps}>\n {inner}\n </Root>\n ) : (\n inner\n );\n }, guarded);\n }\n\n return (\n <GenesisProvider provider={parts.provider} queryClient={client}>\n <SessionProvider store={session}>\n <BootProvider boot={boot}>\n <BlocksProvider value={parts.blocks}>\n <GenesisErrorBoundary key={resetKey} fallback={FatalFallback} onError={onError} onRetry={retry}>\n {/* Sheet content renders in the library's portal, here: below data, session, boot and blocks. */}\n {bottomSheet ? <NativeSheetProvider bottomSheet={bottomSheet}>{content}</NativeSheetProvider> : content}\n </GenesisErrorBoundary>\n </BlocksProvider>\n </BootProvider>\n </SessionProvider>\n </GenesisProvider>\n );\n}\n\n// Every slot name, checked against NativeAppSlots by the compiler: a block filling any other is a BlockError.\nconst SLOT_NAMES: Record<keyof NativeAppSlots, true> = {\n boot: true,\n fatal: true,\n errorBoundary: true,\n signedOut: true,\n forceUpgrade: true,\n maintenance: true,\n updateBanner: true,\n whatsNew: true,\n devtoolsFeedback: true,\n pushPrompt: true,\n};\nconst NATIVE_APP_SLOT_NAMES: readonly string[] = Object.keys(SLOT_NAMES);\n\n/** Blocks' slot fills under the app's own slots: the app's (a component or `null`) always win. */\nfunction withBlockSlots(fills: Readonly<Record<string, unknown>>, own: Slots<NativeAppSlots> | undefined): Slots<NativeAppSlots> | undefined {\n if (Object.keys(fills).length === 0) return own;\n return { ...(fills as Slots<NativeAppSlots>), ...own };\n}\n\n/** `blocks`, with `updates` added when it was given on its own (given both ways, it runs once). */\nfunction givenBlocks(props: Pick<GenesisNativeAppProps, \"blocks\" | \"updates\">): readonly NativeBlock[] {\n const given = props.blocks ?? [];\n return props.updates && !given.includes(props.updates) ? [...given, props.updates] : given;\n}\n\nconst NO_HOLD: LinkHold = {\n hold: () => {},\n peek: () => null,\n take: () => null,\n clear: () => {},\n subscribe: () => () => {},\n};\n","/**\n * A hydration gate holds writes until a persisted store has loaded from disk.\n *\n * The bug it prevents: a persisted store (zustand `persist`, say) is created\n * with defaults, something sets a value before the saved state has been read,\n * and that write lands on disk first, replacing what the user had. With the\n * gate, a write made before hydration never reaches disk (`storage()`), or\n * waits for it (`run()`).\n *\n * const gate = createHydrationGate();\n * persist(store, {\n * storage: createJSONStorage(() => gate.storage(AsyncStorage)),\n * // Open only after a good read: after a failed one, writes would replace what's on disk.\n * onRehydrateStorage: () => (_state, error) => {\n * if (!error) gate.markHydrated();\n * },\n * });\n */\nimport type { AsyncStorageLike } from \"./query\";\n\nexport interface HydrationGate {\n readonly hydrated: boolean;\n /** Call once the store has read its saved state. Idempotent. */\n markHydrated(): void;\n /** Resolves once hydrated. */\n whenHydrated(): Promise<void>;\n /** Run a write now if hydrated, otherwise once hydrated. */\n run<T>(write: () => T | Promise<T>): Promise<T>;\n /**\n * The storage, with writes made before hydration dropped (reads pass\n * through, since hydration is a read). After hydration the store writes\n * its merged state on its next change, so nothing is lost but the stale\n * write. (A zustand migration's own write during hydration is dropped too;\n * the old version stays on disk and is migrated again until then.)\n */\n storage<S extends AsyncStorageLike>(storage: S): S;\n}\n\nexport interface HydrationGateOptions {\n /** Told about each write `storage()` dropped (to log it in development). */\n onDroppedWrite?: (key: string) => void;\n}\n\n/** A gate that holds writes until a persisted store has hydrated. */\nexport function createHydrationGate({ onDroppedWrite }: HydrationGateOptions = {}): HydrationGate {\n let hydrated = false;\n let open!: () => void;\n const opened = new Promise<void>((resolve) => {\n open = resolve;\n });\n\n const gate: HydrationGate = {\n get hydrated() {\n return hydrated;\n },\n markHydrated() {\n if (hydrated) return;\n hydrated = true;\n open();\n },\n whenHydrated: () => opened,\n async run(write) {\n if (!hydrated) await opened;\n return write();\n },\n storage(storage) {\n const setItem = async (key: string, value: string) => {\n if (!hydrated) return onDroppedWrite?.(key);\n return storage.setItem(key, value);\n };\n const removeItem = async (key: string) => {\n if (!hydrated) return onDroppedWrite?.(key);\n return storage.removeItem(key);\n };\n // A proxy, not a spread: a storage class's prototype methods (and its\n // private fields, through `this`) keep working.\n return new Proxy(storage, {\n get(target, property) {\n if (property === \"setItem\") return setItem;\n if (property === \"removeItem\") return removeItem;\n const value = Reflect.get(target, property, target) as unknown;\n return typeof value === \"function\" ? value.bind(target) : value;\n },\n });\n },\n };\n return gate;\n}\n"]}
@@ -1,7 +1,7 @@
1
- import { a as RouteErrorBoundaryProps, b as ObservabilitySink } from './block-DFnC8j5U.js';
2
- export { B as Breadcrumb, c as BreadcrumbLevel, C as ConsoleSinkOptions, E as ErrorContext, d as EventCheck, e as EventPropSpec, f as EventProps, g as EventSchema, h as EventValues, i as OBSERVABILITY_BLOCK_ID, O as ObservabilityBlock, j as ObservabilityOptions, k as ObservabilityProvider, l as ObserveLike, m as ObserveSinkOptions, R as RecentActivity, n as RecentError, o as RecentStore, T as TimingTags, p as checkEvent, q as consoleSink, r as createObservability, s as defineEvents, t as observeSink, u as scrubBreadcrumb, v as scrubbedError, w as useObservability, x as useRecentActivity } from './block-DFnC8j5U.js';
1
+ import { a as RouteErrorBoundaryProps, b as ObservabilitySink } from './block-q6_CV0WK.js';
2
+ export { B as Breadcrumb, c as BreadcrumbLevel, C as ConsoleSinkOptions, E as ErrorContext, d as EventCheck, e as EventPropSpec, f as EventProps, g as EventSchema, h as EventValues, i as OBSERVABILITY_BLOCK_ID, O as ObservabilityBlock, j as ObservabilityOptions, k as ObservabilityProvider, l as ObserveLike, m as ObserveSinkOptions, R as RecentActivity, n as RecentError, o as RecentStore, T as TimingTags, p as checkEvent, q as consoleSink, r as createObservability, s as defineEvents, t as observeSink, u as scrubBreadcrumb, v as scrubbedError, w as useObservability, x as useRecentActivity } from './block-q6_CV0WK.js';
3
3
  import { ComponentType } from 'react';
4
- import { V as VersionSignature } from './blocks-CyXjSGwV.js';
4
+ import { V as VersionSignature } from './blocks-ByVBKaQW.js';
5
5
  export { c as ScreenErrorProps, d as ScreenErrorScreen, e as createScreenErrorBoundary } from './screen-boundary-BlT6KBpa.js';
6
6
  import './query-DobJyRvs.js';
7
7
  import '@tanstack/react-query';
package/dist/push.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { X as PushPermissionStatus, Y as NotificationResponseLike, Z as NotificationLike, o as LinkOptions, _ as QuietHours } from './blocks-CyXjSGwV.js';
2
- export { $ as ChannelImportance, a0 as ChannelInputLike, a1 as DEFAULT_PREFERENCES, a2 as NotificationActionLike, a3 as NotificationBehaviorLike, a4 as NotificationCategory, a5 as NotificationPreferences, a6 as NotificationsModuleLike, a7 as PermissionRequestLike, a8 as PermissionState, a9 as PermissionStatusLike, aa as PermissionStore, ab as PreferencesState, ac as PreferencesStatus, ad as PreferencesStore, ae as PromptOptions, af as PromptState, ag as PromptStore, ah as PushAppStateLike, ai as PushBackend, aj as PushBackendError, ak as PushBlock, al as PushChannel, am as PushDeviceCategory, an as PushErrorSource, ao as PushOnError, ap as PushOptions, aq as PushPromptProps, ar as PushPromptSheet, as as PushProvider, at as PushRoot, au as PushRootProps, av as PushSlots, aw as PushStorageLike, ax as PushSupabaseLike, ay as Registration, az as RegistrationState, aA as RegistrationStatus, aB as SubscriptionLike, aC as canPush, aD as createPermissionStore, aE as createPreferencesStore, aF as createPromptStore, aG as createPush, aH as createRegistration, aI as statusOf, aJ as supabasePushBackend, aK as useBadge, aL as useNotificationPreferences, aM as useOptionalPush, aN as usePush, aO as usePushPermissionState, aP as usePushPrompt, aQ as usePushRegistration, aR as useSuppressNotifications, aS as validPreferences } from './blocks-CyXjSGwV.js';
1
+ import { X as PushPermissionStatus, Y as NotificationResponseLike, Z as NotificationLike, o as LinkOptions, _ as QuietHours } from './blocks-ByVBKaQW.js';
2
+ export { $ as ChannelImportance, a0 as ChannelInputLike, a1 as DEFAULT_PREFERENCES, a2 as NotificationActionLike, a3 as NotificationBehaviorLike, a4 as NotificationCategory, a5 as NotificationPreferences, a6 as NotificationsModuleLike, a7 as PermissionRequestLike, a8 as PermissionState, a9 as PermissionStatusLike, aa as PermissionStore, ab as PreferencesState, ac as PreferencesStatus, ad as PreferencesStore, ae as PromptOptions, af as PromptState, ag as PromptStore, ah as PushAppStateLike, ai as PushBackend, aj as PushBackendError, ak as PushBlock, al as PushChannel, am as PushDeviceCategory, an as PushErrorSource, ao as PushOnError, ap as PushOptions, aq as PushPromptProps, ar as PushPromptSheet, as as PushProvider, at as PushRoot, au as PushRootProps, av as PushSlots, aw as PushStorageLike, ax as PushSupabaseLike, ay as Registration, az as RegistrationState, aA as RegistrationStatus, aB as SubscriptionLike, aC as canPush, aD as createPermissionStore, aE as createPreferencesStore, aF as createPromptStore, aG as createPush, aH as createRegistration, aI as statusOf, aJ as supabasePushBackend, aK as useBadge, aL as useNotificationPreferences, aM as useOptionalPush, aN as usePush, aO as usePushPermissionState, aP as usePushPrompt, aQ as usePushRegistration, aR as useSuppressNotifications, aS as validPreferences } from './blocks-ByVBKaQW.js';
3
3
  import * as react from 'react';
4
4
  import { ReactNode } from 'react';
5
5
  import { Slots, SlotPropsFor } from '@marktiderman/genesis-core/slots';
package/dist/updates.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { aT as ApplicationLike, aU as CLOCK_SKEW_MS, aV as ChannelSwitchResult, aW as ChannelSwitcher, aX as ChannelSwitcherOptions, aY as EvaluatePolicyOptions, aZ as ForceUpgradeProps, a_ as ForceUpgradeScreen, a$ as MaintenanceProps, b0 as MaintenanceScreen, b1 as PolicyClientLike, b2 as PolicyOrigin, b3 as PolicyState, b4 as PolicyStore, b5 as PolicyStoreOptions, b6 as ReleaseNote, b7 as ReloadGuard, b8 as SupabasePolicySourceOptions, b9 as UPDATES_BLOCK_ID, ba as UpdateBanner, bb as UpdateBannerProps, bc as UpdateCheckState, bd as UpdateCheckStatus, be as UpdateChecker, bf as UpdateCheckerOptions, bg as UpdatePlatform, bh as UpdatePolicy, bi as UpdatePolicySource, bj as UpdateVerdict, bk as UpdatesAppStateLike, U as UpdatesBlock, bl as UpdatesErrorSource, bm as UpdatesModuleLike, bn as UpdatesOnError, bo as UpdatesOptions, bp as UpdatesProvider, bq as UpdatesRoot, br as UpdatesRootProps, bs as UpdatesSlots, bt as UpdatesStorageLike, V as VersionSignature, bu as VersionSignatureInput, bv as WEEK_MS, bw as WhatsNewOptions, bx as WhatsNewProps, by as WhatsNewSheet, bz as WhatsNewState, bA as WhatsNewStore, bB as createChannelSwitcher, bC as createPolicyStore, bD as createReloadGuard, bE as createUpdateChecker, bF as createUpdates, bG as createWhatsNewStore, bH as evaluatePolicy, bI as notesSince, bJ as sanitizePolicy, bK as staticPolicySource, bL as supabasePolicySource, bM as useBlockReload, bN as useCanReload, bO as useForceUpgrade, bP as useMaintenance, bQ as useUpdateBanner, bR as useUpdateCheck, bS as useUpdatePolicy, bT as useUpdateVerdict, bU as useUpdates, bV as useVersionSignature, bW as useWhatsNew, bX as versionSignature } from './blocks-CyXjSGwV.js';
1
+ export { aT as ApplicationLike, aU as CLOCK_SKEW_MS, aV as ChannelSwitchResult, aW as ChannelSwitcher, aX as ChannelSwitcherOptions, aY as EvaluatePolicyOptions, aZ as ForceUpgradeProps, a_ as ForceUpgradeScreen, a$ as MaintenanceProps, b0 as MaintenanceScreen, b1 as PolicyClientLike, b2 as PolicyOrigin, b3 as PolicyState, b4 as PolicyStore, b5 as PolicyStoreOptions, b6 as ReleaseNote, b7 as ReloadGuard, b8 as SupabasePolicySourceOptions, b9 as UPDATES_BLOCK_ID, ba as UpdateBanner, bb as UpdateBannerProps, bc as UpdateCheckState, bd as UpdateCheckStatus, be as UpdateChecker, bf as UpdateCheckerOptions, bg as UpdatePlatform, bh as UpdatePolicy, bi as UpdatePolicySource, bj as UpdateVerdict, bk as UpdatesAppStateLike, U as UpdatesBlock, bl as UpdatesErrorSource, bm as UpdatesModuleLike, bn as UpdatesOnError, bo as UpdatesOptions, bp as UpdatesProvider, bq as UpdatesRoot, br as UpdatesRootProps, bs as UpdatesSlots, bt as UpdatesStorageLike, V as VersionSignature, bu as VersionSignatureInput, bv as WEEK_MS, bw as WhatsNewOptions, bx as WhatsNewProps, by as WhatsNewSheet, bz as WhatsNewState, bA as WhatsNewStore, bB as createChannelSwitcher, bC as createPolicyStore, bD as createReloadGuard, bE as createUpdateChecker, bF as createUpdates, bG as createWhatsNewStore, bH as evaluatePolicy, bI as notesSince, bJ as sanitizePolicy, bK as staticPolicySource, bL as supabasePolicySource, bM as useBlockReload, bN as useCanReload, bO as useForceUpgrade, bP as useMaintenance, bQ as useUpdateBanner, bR as useUpdateCheck, bS as useUpdatePolicy, bT as useUpdateVerdict, bU as useUpdates, bV as useVersionSignature, bW as useWhatsNew, bX as versionSignature } from './blocks-ByVBKaQW.js';
2
2
  import 'react';
3
3
  import '@marktiderman/genesis-core/slots';
4
4
  import '@marktiderman/genesis-features/blocks';
package/package.json CHANGED
@@ -1,10 +1,31 @@
1
1
  {
2
2
  "name": "@marktiderman/genesis-native",
3
- "version": "0.5.2",
3
+ "version": "0.7.0",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "sideEffects": false,
7
7
  "description": "The native app shell for Genesis Expo apps: one GenesisNativeApp root that runs boot steps behind the splash, catches errors into a fatal screen with retry, persists the query cache, gates on the Supabase session and normalizes deep links. An optional updates block (/updates) adds force upgrade, maintenance, an update banner and what's new; an optional push block (/push) adds push registration, tap routing, the badge and a notification settings screen with quiet hours and private previews; the observability block (/observability) reports errors, breadcrumbs, typed analytics events and timings through vendor-neutral sinks (Sentry, EAS Observe, console) with PII scrubbed on the device; the devtools overlay (/devtools) is a debug sheet for development and preview builds. openOnWeb (/web-handoff) opens a page of the web app signed in as the same person. Blocks (defineBlock declarations, through `blocks`) add boot steps, roots, slot fills and Settings rows. Every part is a slot and is also exported on its own. Part of the Genesis framework.",
8
+ "keywords": [
9
+ "genesis",
10
+ "genesis-framework",
11
+ "react-native",
12
+ "expo",
13
+ "app-shell",
14
+ "notifications",
15
+ "push-token",
16
+ "quiet-hours",
17
+ "force-upgrade",
18
+ "maintenance",
19
+ "ota",
20
+ "crash-reporting",
21
+ "sentry",
22
+ "analytics",
23
+ "breadcrumbs"
24
+ ],
25
+ "homepage": "https://github.com/marktiderman/genesis/tree/main/packages/native#readme",
26
+ "bugs": {
27
+ "url": "https://github.com/marktiderman/genesis/issues"
28
+ },
8
29
  "repository": {
9
30
  "type": "git",
10
31
  "url": "git+https://github.com/marktiderman/genesis.git",
@@ -81,12 +102,13 @@
81
102
  "README.md"
82
103
  ],
83
104
  "dependencies": {
84
- "@marktiderman/genesis-core": "^2.1.0",
85
- "@marktiderman/genesis-design-system": "^1.5.1",
86
- "@marktiderman/genesis-features": "^0.7.0",
87
- "@marktiderman/genesis-ui-native": "^3.1.0"
105
+ "@marktiderman/genesis-design-system": "^1.6.1",
106
+ "@marktiderman/genesis-features": "^0.8.0",
107
+ "@marktiderman/genesis-ui-native": "^3.3.0"
88
108
  },
89
109
  "peerDependencies": {
110
+ "@marktiderman/genesis-core": ">=2.1.0 <3.0.0",
111
+ "nativewind": "^4.0.0 || ^5.0.0-preview",
90
112
  "@tanstack/query-async-storage-persister": "^5.0.0",
91
113
  "@tanstack/query-persist-client-core": "^5.0.0",
92
114
  "@tanstack/react-query": "^5.0.0",
@@ -125,21 +147,26 @@
125
147
  }
126
148
  },
127
149
  "devDependencies": {
150
+ "@marktiderman/genesis-core": "^2.4.1",
128
151
  "@supabase/supabase-js": "^2.118.0",
129
- "@tanstack/query-async-storage-persister": "5.101.4",
130
- "@tanstack/query-persist-client-core": "5.101.4",
131
- "@tanstack/react-query": "^5.75.0",
152
+ "@tanstack/query-async-storage-persister": "5.104.5",
153
+ "@tanstack/query-persist-client-core": "5.104.5",
154
+ "@tanstack/react-query": "5.104.5",
132
155
  "@testing-library/react": "^16.3.2",
133
156
  "@types/react": "^19.2.14",
134
157
  "expo": "~58.0.19",
135
- "happy-dom": "^20.9.0",
158
+ "happy-dom": "^21.0.4",
159
+ "nativewind": "^4.2.7",
136
160
  "react": "^19.2.5",
137
161
  "react-dom": "^19.2.5",
138
162
  "tsup": "^8.3.0",
139
163
  "typescript": "~6.0.3",
140
- "vitest": "^4.1.12"
164
+ "vitest": "^5.0.5"
141
165
  },
142
166
  "genesis": {
167
+ "layer": "primitive",
168
+ "group": "shells",
169
+ "owner": "@marktiderman",
143
170
  "blocks": {
144
171
  "push": {
145
172
  "feature": {
package/src/app.tsx CHANGED
@@ -3,7 +3,9 @@
3
3
  * `_layout.tsx` is a few lines.
4
4
  *
5
5
  * last-resort boundary (React Native primitives only)
6
- * └ theme (GenesisThemeProvider, owning the platform color scheme)
6
+ * └ theme (GenesisThemeProvider, owning the platform color scheme; with `brandVariables`,
7
+ * role variables on a view around the app for NativeWind's role classes; with
8
+ * `modules.navigation`, React Navigation's theme in the same colors and mode)
7
9
  * └ keyboard (`keyboardProvider`, once, then `keyboardScroll` for form screens)
8
10
  * └ toasts (`NativeToastProvider`, so `useToast()` works on every screen; `toast={null}` drops it)
9
11
  * └ data (GenesisProvider over the Supabase client, the QueryClient)
@@ -24,11 +26,12 @@
24
26
  * "Try again". Every part is a slot (`slots` / `slotProps`, `null` drops it)
25
27
  * and is also exported on its own.
26
28
  */
27
- import { useEffect, useRef, useState, useSyncExternalStore, type ComponentType, type ReactNode } from "react";
29
+ import { useEffect, useMemo, useRef, useState, useSyncExternalStore, type ComponentType, type ReactNode } from "react";
28
30
  import { Text, View } from "react-native";
29
31
  import type { QueryClient, QueryClientConfig } from "@tanstack/react-query";
30
- import { GenesisThemeProvider } from "@marktiderman/genesis-design-system/theme";
31
- import type { CanonicalBrand } from "@marktiderman/genesis-design-system";
32
+ import { vars } from "nativewind";
33
+ import { GenesisThemeProvider, useTheme } from "@marktiderman/genesis-design-system/theme";
34
+ import { brandRoleVariables, type CanonicalBrand } from "@marktiderman/genesis-design-system";
32
35
  import { GenesisProvider, createSupabaseProvider, type DataProvider, type SupabaseClientInput } from "@marktiderman/genesis-core/provider";
33
36
  import { renderSlot, type SlotPropsFor, type Slots } from "@marktiderman/genesis-core/slots";
34
37
  import { KeyboardScrollProvider, type KeyboardScrollProps, type KeyboardToolbarProps } from "@marktiderman/genesis-ui-native/layouts";
@@ -37,6 +40,8 @@ import {
37
40
  NativeSheetProvider,
38
41
  NativeToastProvider,
39
42
  type GenesisModules,
43
+ type GenesisNavigationModule,
44
+ type GenesisNavigationTheme,
40
45
  type NativeSheetLibrary,
41
46
  type NativeToastProviderProps,
42
47
  } from "@marktiderman/genesis-ui-native/components";
@@ -128,6 +133,24 @@ export interface GenesisNativeAppProps {
128
133
  * it props, define the wrapper at module scope, not inline.
129
134
  */
130
135
  keyboardProvider?: ComponentType<{ children: ReactNode }>;
136
+ /**
137
+ * Theme role variables (`--primary`, `--background`, …) to set on a view
138
+ * around the app, over what the app's stylesheet declares on `:root`.
139
+ * Default `false`: none are set, so the app's own variables (from
140
+ * `createGenesisNativewindPreset({ brand })` or its brand package) stand.
141
+ * `true` sets `brandRoleVariables(brand)` for the current mode; an object
142
+ * sets the app's own, one map for both modes or `{ light, dark }`.
143
+ */
144
+ brandVariables?: boolean | Record<string, string> | { light: Record<string, string>; dark: Record<string, string> };
145
+ /**
146
+ * React Navigation's theme (headers, tab bars, the screen background), when
147
+ * `modules.navigation` is given. Default: worked out from the same role
148
+ * variables as `brandVariables` (the app's own when it passes them,
149
+ * `brandRoleVariables(brand)` otherwise), for the current mode, so a header
150
+ * is never light in dark mode. Pass a theme (or `{ light, dark }`) to use
151
+ * your own, or `false` to set none.
152
+ */
153
+ navigationTheme?: false | GenesisNavigationTheme | { light: GenesisNavigationTheme; dark: GenesisNavigationTheme };
131
154
  /** `KeyboardAwareScrollView` from react-native-keyboard-controller, for form screens. Needs `keyboardProvider`. */
132
155
  keyboardScroll?: ComponentType<KeyboardScrollProps>;
133
156
  /**
@@ -300,13 +323,122 @@ function ThemedShell(props: GenesisNativeAppProps) {
300
323
  if (modules) body = <GenesisModulesProvider modules={modules}>{body}</GenesisModulesProvider>;
301
324
  if (keyboardScroll) body = <KeyboardScrollProvider component={keyboardScroll} toolbar={keyboardToolbar}>{body}</KeyboardScrollProvider>;
302
325
  if (Keyboard) body = <Keyboard>{body}</Keyboard>;
326
+ if (modules?.navigation && props.navigationTheme !== false) {
327
+ body = (
328
+ <NavigationTheme module={modules.navigation} brand={brand} brandVariables={props.brandVariables} given={props.navigationTheme}>
329
+ {body}
330
+ </NavigationTheme>
331
+ );
332
+ }
303
333
  return (
304
334
  <ThemeProvider brand={brand} syncNativeAppearance>
305
- {body}
335
+ {props.brandVariables ? (
336
+ <BrandVariables brand={brand} given={props.brandVariables}>
337
+ {body}
338
+ </BrandVariables>
339
+ ) : (
340
+ body
341
+ )}
306
342
  </ThemeProvider>
307
343
  );
308
344
  }
309
345
 
346
+ /**
347
+ * Theme role variables (`--primary`, `--background`, …) for the current mode,
348
+ * set on a view around the app, so NativeWind's role classes (`bg-primary` is
349
+ * `hsl(var(--primary))`) read them instead of what `:root` declares. Only with
350
+ * `brandVariables`: NativeWind can't tell which `:root` variables are the
351
+ * app's own, so setting them is the app's choice.
352
+ */
353
+ function BrandVariables({
354
+ brand,
355
+ given,
356
+ children,
357
+ }: {
358
+ brand: CanonicalBrand;
359
+ given: NonNullable<GenesisNativeAppProps["brandVariables"]>;
360
+ children: ReactNode;
361
+ }) {
362
+ const { resolvedMode } = useTheme();
363
+ const variables = useMemo(() => {
364
+ if (given === true) return brandRoleVariables(brand);
365
+ const perMode = given as { light?: unknown; dark?: unknown };
366
+ if (typeof perMode.light === "object" && typeof perMode.dark === "object") return given as { light: Record<string, string>; dark: Record<string, string> };
367
+ return { light: given as Record<string, string>, dark: given as Record<string, string> };
368
+ }, [brand, given]);
369
+ const style = useMemo(() => [{ flex: 1 }, vars(variables[resolvedMode])], [variables, resolvedMode]);
370
+ return (
371
+ <View testID="genesis-brand-variables" style={style}>
372
+ {children}
373
+ </View>
374
+ );
375
+ }
376
+
377
+ /**
378
+ * `"240 10% 3.9%"` (a role variable's value) → `"hsl(240, 10%, 3.9%)"`, and `"240 10% 3.9% / 0.5"`
379
+ * → `"hsla(240, 10%, 3.9%, 0.5)"`; anything else as it is.
380
+ */
381
+ function roleColor(value: string | undefined): string | undefined {
382
+ if (!value) return undefined;
383
+ const [color = "", alpha] = value.split("/").map((p) => p.trim());
384
+ const parts = color.split(/\s+/);
385
+ if (parts.length !== 3) return value;
386
+ return alpha ? `hsla(${parts.join(", ")}, ${alpha})` : `hsl(${parts.join(", ")})`;
387
+ }
388
+
389
+ /**
390
+ * React Navigation's theme for the current mode, in the app's role colors: the
391
+ * variables `brandVariables` sets (or `brandRoleVariables(brand)`) over React
392
+ * Navigation's own light or dark theme, which keeps its fonts.
393
+ */
394
+ function NavigationTheme({
395
+ module,
396
+ brand,
397
+ brandVariables,
398
+ given,
399
+ children,
400
+ }: {
401
+ module: GenesisNavigationModule;
402
+ brand: CanonicalBrand;
403
+ brandVariables: GenesisNativeAppProps["brandVariables"];
404
+ given: GenesisNativeAppProps["navigationTheme"];
405
+ children: ReactNode;
406
+ }) {
407
+ const { resolvedMode } = useTheme();
408
+ const theme = useMemo((): GenesisNavigationTheme => {
409
+ const base = resolvedMode === "dark" ? module.DarkTheme : module.DefaultTheme;
410
+ if (given) {
411
+ const perMode = given as { light?: GenesisNavigationTheme; dark?: GenesisNavigationTheme };
412
+ const own = perMode.light && perMode.dark ? perMode[resolvedMode]! : (given as GenesisNavigationTheme);
413
+ // React Navigation's headers read every font variant: a theme without fonts keeps the base's.
414
+ return own.fonts ? own : { ...own, fonts: base.fonts };
415
+ }
416
+ // The app's own map over the brand's role colors, so a partial map never falls back to React Navigation's.
417
+ let variables = brandRoleVariables(brand)[resolvedMode];
418
+ if (brandVariables && brandVariables !== true) {
419
+ const perMode = brandVariables as { light?: unknown; dark?: unknown };
420
+ const own = typeof perMode.light === "object" && typeof perMode.dark === "object" ? (brandVariables as Record<"light" | "dark", Record<string, string>>)[resolvedMode] : (brandVariables as Record<string, string>);
421
+ variables = { ...variables, ...own };
422
+ }
423
+ const pick = (name: string, fallback: GenesisNavigationTheme["colors"]["text"]) => roleColor(variables[`--${name}`]) ?? fallback;
424
+ return {
425
+ ...base,
426
+ dark: resolvedMode === "dark",
427
+ colors: {
428
+ ...base.colors,
429
+ primary: pick("primary", base.colors.primary),
430
+ background: pick("background", base.colors.background),
431
+ card: pick("card", base.colors.card),
432
+ text: pick("foreground", base.colors.text),
433
+ border: pick("border", base.colors.border),
434
+ notification: pick("destructive", base.colors.notification),
435
+ },
436
+ };
437
+ }, [module, brand, brandVariables, given, resolvedMode]);
438
+ const Provider = module.ThemeProvider;
439
+ return <Provider value={theme}>{children}</Provider>;
440
+ }
441
+
310
442
  const SESSION_STEP_MARGIN_MS = 15_000;
311
443
 
312
444
  function Shell(props: GenesisNativeAppProps) {