@molecule/app-react 2.0.0 → 2.1.0

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-25T20:03:36.228Z
+Generated: 2026-10-27T17:48:51.379Z
 -->
 
 # @molecule/app-react
@@ -1171,6 +1171,43 @@ interface UseStorageValueResult<T> {
 }
 ```
 
+#### `UseStoragePreferenceOptions`
+
+Options for {@link useStoragePreference}.
+
+```typescript
+interface UseStoragePreferenceOptions<T> {
+  /**
+   * Value reported until the provider supplies one. It is NEVER written to
+   * storage: a default is a display fallback, not a decision the user made.
+   */
+  defaultValue?: T
+}
+```
+
+#### `UseStoragePreferenceResult`
+
+Result of {@link useStoragePreference}.
+
+```typescript
+interface UseStoragePreferenceResult<T> {
+  /** The persisted value, or `defaultValue` while none is known. */
+  value: T | undefined
+  /**
+   * Writes the value through the preference store: subscribers update
+   * immediately and persistence is best-effort.
+   */
+  setValue: (next: T | ((previous: T | undefined) => T)) => void
+  /** Removes the key through the preference store. */
+  removeValue: () => void
+  /**
+   * `true` once the store has a definite answer — the synchronous snapshot on
+   * a synchronous provider, or the hydration result on an asynchronous one.
+   */
+  ready: boolean
+}
+```
+
 #### `UseVerifyPaymentReturnOptions`
 
 Options for {@link useVerifyPaymentReturn}.
@@ -1912,7 +1949,7 @@ function useAIModels(projectId?: string): UseAIModelsResult
 Hook like useState but accepts Promises and supports partial state extension.
 
 ```typescript
-function useAsyncState(initialState: T): [T, AsyncSetState<T>, AsyncExtendState<T>]
+function useAsyncState<T>(initialState: T): [T, AsyncSetState<T>, AsyncExtendState<T>]
 ```
 
 - `initialState` — Initial state value
@@ -1928,7 +1965,10 @@ Pass the same generics the client was created with —
 the app's own fields.
 
 ```typescript
-function useAuthClient(): AuthClient<T, TRegister>
+function useAuthClient<
+  T = unknown,
+  TRegister extends RegisterExtraShape<TRegister> = Record<never, never>,
+>(): AuthClient<T, TRegister>
 ```
 
 **Returns:** The auth client from context
@@ -1958,7 +1998,10 @@ call (and `requestBody` receives the same payload). Without it, `register`
 accepts only the base fields.
 
 ```typescript
-function useAuth(options?: UseAuthOptions): UseAuthResult<T, TRegister>
+function useAuth<
+  T = unknown,
+  TRegister extends RegisterExtraShape<TRegister> = Record<never, never>,
+>(options?: UseAuthOptions): UseAuthResult<T, TRegister>
 ```
 
 - `options` — Hook options
@@ -1970,7 +2013,7 @@ function useAuth(options?: UseAuthOptions): UseAuthResult<T, TRegister>
 Hook to get just the authenticated user.
 
 ```typescript
-function useUser(): T | null
+function useUser<T = unknown>(): T | null
 ```
 
 **Returns:** The authenticated user or null
@@ -2132,7 +2175,7 @@ wires a form library once (`setProvider` from `@molecule/app-forms`) and
 every form picks it up. Passing `createForm` overrides that for one form.
 
 ```typescript
-function useForm(options?: UseFormOptions<T>): UseFormResult<T>
+function useForm<T extends Record<string, unknown>>(options?: UseFormOptions<T>): UseFormResult<T>
 ```
 
 - `options` — Form options. `defaultValues`, `mode` and the form-level `validate` are forwarded to the provider; omit the options entirely for a form whose fields are registered with their own defaults.
@@ -2144,7 +2187,10 @@ function useForm(options?: UseFormOptions<T>): UseFormResult<T>
 Hook to watch a specific field value.
 
 ```typescript
-function useWatch(form: FormController<T>, name: K): T[K]
+function useWatch<T extends Record<string, unknown>, K extends keyof T>(
+  form: FormController<T>,
+  name: K,
+): T[K]
 ```
 
 - `form` — Form controller
@@ -2157,7 +2203,10 @@ function useWatch(form: FormController<T>, name: K): T[K]
 Hook to get field-level state.
 
 ```typescript
-function useFieldState(form: FormController<T>, name: keyof T): FieldState<T[keyof T]>
+function useFieldState<T extends Record<string, unknown>>(
+  form: FormController<T>,
+  name: keyof T,
+): FieldState<T[keyof T]>
 ```
 
 - `form` — Form controller
@@ -2189,7 +2238,7 @@ the client does replace `execute` (it selects a different request) and
 re-runs such an effect.
 
 ```typescript
-function useHttp(
+function useHttp<T>(
   method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',
   url: string,
   options?: UseHttpOptions<T>,
@@ -2207,7 +2256,7 @@ function useHttp(
 Hook for GET requests.
 
 ```typescript
-function useGet(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
+function useGet<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 ```
 
 - `url` — Request URL to fetch from.
@@ -2220,7 +2269,7 @@ function useGet(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 Hook for POST requests.
 
 ```typescript
-function usePost(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
+function usePost<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 ```
 
 - `url` — Request URL to post to.
@@ -2233,7 +2282,7 @@ function usePost(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 Hook for PUT requests.
 
 ```typescript
-function usePut(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
+function usePut<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 ```
 
 - `url` — Request URL to send the PUT request to.
@@ -2246,7 +2295,7 @@ function usePut(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 Hook for PATCH requests.
 
 ```typescript
-function usePatch(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
+function usePatch<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 ```
 
 - `url` — Request URL to send the PATCH request to.
@@ -2259,7 +2308,7 @@ function usePatch(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 Hook for DELETE requests.
 
 ```typescript
-function useDelete(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
+function useDelete<T>(url: string, options?: UseHttpOptions<T>): UseHttpResult<T>
 ```
 
 - `url` — Request URL of the resource to delete.
@@ -2322,7 +2371,7 @@ no separate `useRegister` hook. Use `usePromise(register)` when the form
 needs the same pending/error tracking as this login hook.
 
 ```typescript
-function useLogin(): UseLoginReturn<T>
+function useLogin<T = unknown>(): UseLoginReturn<T>
 ```
 
 **Returns:** Login state and action
@@ -2417,7 +2466,7 @@ the clean baseline; edits made while saving remain dirty. No request is made
 for a patch with no fields. A failed request retains the edits and shared user.
 
 ```typescript
-function useProfileForm(
+function useProfileForm<TUser, TValues extends Record<string, unknown>>(
   options: UseProfileFormOptions<TUser, TValues>,
 ): UseProfileFormResult<TUser, TValues>
 ```
@@ -2431,7 +2480,7 @@ function useProfileForm(
 Hook that wraps an async function with state tracking.
 
 ```typescript
-function usePromise(
+function usePromise<T extends (...args: any[]) => Promise<any>>(
   asyncFn: T,
 ): [
   UsePromiseState<Awaited<ReturnType<T>>>,
@@ -2492,7 +2541,7 @@ function useLocation(): RouteLocation
 Hook to get route parameters.
 
 ```typescript
-function useParams(): T
+function useParams<T extends Record<string, string> = RouteParams>(): T
 ```
 
 **Returns:** The current route parameters
@@ -2502,7 +2551,7 @@ function useParams(): T
 Hook to get query parameters.
 
 ```typescript
-function useQuery(): T
+function useQuery<T extends QueryParams = QueryParams>(): T
 ```
 
 **Returns:** The current query parameters
@@ -2535,7 +2584,10 @@ function useIsActive(path: string, exact?: boolean): boolean
 Hook for user registration with async state tracking.
 
 ```typescript
-function useSignup(): UseSignupReturn<T, TRegister>
+function useSignup<
+  T = unknown,
+  TRegister extends RegisterExtraShape<TRegister> = Record<never, never>,
+>(): UseSignupReturn<T, TRegister>
 ```
 
 **Returns:** Signup state and action
@@ -2555,7 +2607,10 @@ function useStorageProvider(): StorageProvider
 Hook to manage a single storage value with React state sync.
 
 ```typescript
-function useStorageValue(key: string, options?: UseStorageValueOptions<T>): UseStorageValueResult<T>
+function useStorageValue<T>(
+  key: string,
+  options?: UseStorageValueOptions<T>,
+): UseStorageValueResult<T>
 ```
 
 - `key` — Storage key
@@ -2563,6 +2618,33 @@ function useStorageValue(key: string, options?: UseStorageValueOptions<T>): UseS
 
 **Returns:** Storage value state (value, loading, error) and mutators (setValue, removeValue).
 
+#### `useStoragePreference(key, options)`
+
+Subscribes React state to ONE persisted preference.
+
+This is the component-side half of `getPreferenceStore()`: a render-time value
+is available immediately when the bonded provider can answer synchronously,
+and an asynchronous provider's hydration CONVERGES onto the same component
+without a remount. Ordering is the store's: a read that started before a
+newer write, remove or external change is discarded, so a slow hydration
+never overwrites an edit the user already made.
+
+Pass `null` for `key` while the real key is unknown (no project selected
+yet): the hook then behaves as local state around `defaultValue` and persists
+nothing.
+
+```typescript
+function useStoragePreference<T = unknown>(
+  key: string | null | undefined,
+  options?: UseStoragePreferenceOptions<T>,
+): UseStoragePreferenceResult<T>
+```
+
+- `key` — The storage key, or `null` when there is nothing to persist.
+- `options` — `defaultValue`, reported until the provider supplies one.
+
+**Returns:** The current value, its mutators, and whether it is definite yet.
+
 #### `useStorage()`
 
 Hook for simple storage operations without React state sync.
@@ -2607,7 +2689,7 @@ the state context. A store minted outside the `state` bond — the direct
 therefore as valid here as one `@molecule/app-state`'s `createStore()` made.
 
 ```typescript
-function useStore(store: Store<T>, options?: UseStoreOptions<T, S>): S
+function useStore<T, S = T>(store: Store<T>, options?: UseStoreOptions<T, S>): S
 ```
 
 - `store` — The store to subscribe to
@@ -2620,7 +2702,7 @@ function useStore(store: Store<T>, options?: UseStoreOptions<T, S>): S
 Hook to get the store's setState function.
 
 ```typescript
-function useSetStore(store: Store<T>): (partial: Partial<T> | ((state: T) => Partial<T>)) => void
+function useSetStore<T>(store: Store<T>): Store<T>['setState']
 ```
 
 - `store` — The store to get setState from
@@ -2632,7 +2714,7 @@ function useSetStore(store: Store<T>): (partial: Partial<T> | ((state: T) => Par
 Hook to create a bound action for a store.
 
 ```typescript
-function useStoreAction(
+function useStoreAction<T, Args extends unknown[], R>(
   store: Store<T>,
   action: (setState: Store<T>['setState'], getState: Store<T>['getState']) => (...args: Args) => R,
 ): (...args: Args) => R
@@ -2688,7 +2770,7 @@ function useThemeMode(): 'light' | 'dark'
 Hook to get theme colors.
 
 ```typescript
-function useThemeColors(): ThemeColors
+function useThemeColors(): Theme['colors']
 ```
 
 **Returns:** The current theme colors
@@ -2849,10 +2931,7 @@ function useWorkspace(): UseWorkspaceResult
 Provider for state management.
 
 ```typescript
-function StateProvider({
-  provider,
-  children,
-}: StateProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function StateProvider({ provider, children }: StateProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link StateProviderProps}).
@@ -2864,10 +2943,7 @@ function StateProvider({
 Provider for authentication.
 
 ```typescript
-function AuthProvider({
-  client,
-  children,
-}: AuthProviderProps<T>): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function AuthProvider<T = unknown>({ client, children }: AuthProviderProps<T>): React.ReactElement
 ```
 
 - `props` — Component props (see {@link AuthProviderProps}).
@@ -2879,10 +2955,7 @@ function AuthProvider({
 Provider for theming.
 
 ```typescript
-function ThemeProvider({
-  provider,
-  children,
-}: ThemeProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function ThemeProvider({ provider, children }: ThemeProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link ThemeProviderProps}).
@@ -2894,10 +2967,7 @@ function ThemeProvider({
 Provider for routing.
 
 ```typescript
-function RouterProvider({
-  router,
-  children,
-}: RouterProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function RouterProvider({ router, children }: RouterProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link RouterProviderProps}).
@@ -2909,10 +2979,7 @@ function RouterProvider({
 Provider for internationalization.
 
 ```typescript
-function I18nProvider({
-  provider,
-  children,
-}: I18nProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function I18nProvider({ provider, children }: I18nProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link I18nProviderProps}).
@@ -2924,10 +2991,7 @@ function I18nProvider({
 Provider for HTTP client.
 
 ```typescript
-function HttpProvider({
-  client,
-  children,
-}: HttpProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function HttpProvider({ client, children }: HttpProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link HttpProviderProps}).
@@ -2939,10 +3003,7 @@ function HttpProvider({
 Provider for storage.
 
 ```typescript
-function StorageProvider({
-  provider,
-  children,
-}: StorageProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function StorageProvider({ provider, children }: StorageProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link StorageProviderProps}).
@@ -2954,10 +3015,7 @@ function StorageProvider({
 Provider for logging.
 
 ```typescript
-function LoggerProvider({
-  provider,
-  children,
-}: LoggerProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function LoggerProvider({ provider, children }: LoggerProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link LoggerProviderProps}).
@@ -2969,10 +3027,7 @@ function LoggerProvider({
 Provider for AI chat.
 
 ```typescript
-function ChatProvider({
-  provider,
-  children,
-}: ChatProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function ChatProvider({ provider, children }: ChatProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link ChatProviderProps}).
@@ -2984,10 +3039,7 @@ function ChatProvider({
 Provider for IDE workspace.
 
 ```typescript
-function WorkspaceProvider({
-  provider,
-  children,
-}: WorkspaceProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function WorkspaceProvider({ provider, children }: WorkspaceProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link WorkspaceProviderProps}).
@@ -2999,10 +3051,7 @@ function WorkspaceProvider({
 Provider for code editor.
 
 ```typescript
-function EditorProvider({
-  provider,
-  children,
-}: EditorProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function EditorProvider({ provider, children }: EditorProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link EditorProviderProps}).
@@ -3014,10 +3063,7 @@ function EditorProvider({
 Provider for live preview.
 
 ```typescript
-function PreviewProvider({
-  provider,
-  children,
-}: PreviewProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+function PreviewProvider({ provider, children }: PreviewProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link PreviewProviderProps}).
@@ -3049,7 +3095,7 @@ function MoleculeProvider({
   workspace,
   editor,
   preview,
-}: MoleculeProviderProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>
+}: MoleculeProviderProps): React.ReactElement
 ```
 
 - `props` — Component props (see {@link MoleculeProviderProps}) — each service is optional, and ONLY the services passed are provided to the tree.

package/dist/hooks/useStorage.d.ts

@@ -3,7 +3,7 @@
  *
  * @module
  */
-import type { StorageProvider } from '@molecule/app-storage';
+import { type StorageProvider } from '@molecule/app-storage';
 /**
  * Hook to access the storage provider from context.
  *
@@ -57,6 +57,64 @@ export interface UseStorageValueResult<T> {
  * @returns Storage value state (value, loading, error) and mutators (setValue, removeValue).
  */
 export declare function useStorageValue<T>(key: string, options?: UseStorageValueOptions<T>): UseStorageValueResult<T>;
+/**
+ * Options for {@link useStoragePreference}.
+ */
+export interface UseStoragePreferenceOptions<T> {
+    /**
+     * Value reported until the provider supplies one. It is NEVER written to
+     * storage: a default is a display fallback, not a decision the user made.
+     */
+    defaultValue?: T;
+}
+/**
+ * Result of {@link useStoragePreference}.
+ */
+export interface UseStoragePreferenceResult<T> {
+    /** The persisted value, or `defaultValue` while none is known. */
+    value: T | undefined;
+    /**
+     * Writes the value through the preference store: subscribers update
+     * immediately and persistence is best-effort.
+     */
+    setValue: (next: T | ((previous: T | undefined) => T)) => void;
+    /** Removes the key through the preference store. */
+    removeValue: () => void;
+    /**
+     * `true` once the store has a definite answer — the synchronous snapshot on
+     * a synchronous provider, or the hydration result on an asynchronous one.
+     */
+    ready: boolean;
+}
+/**
+ * Subscribes React state to ONE persisted preference.
+ *
+ * This is the component-side half of `getPreferenceStore()`: a render-time value
+ * is available immediately when the bonded provider can answer synchronously,
+ * and an asynchronous provider's hydration CONVERGES onto the same component
+ * without a remount. Ordering is the store's: a read that started before a
+ * newer write, remove or external change is discarded, so a slow hydration
+ * never overwrites an edit the user already made.
+ *
+ * Pass `null` for `key` while the real key is unknown (no project selected
+ * yet): the hook then behaves as local state around `defaultValue` and persists
+ * nothing.
+ *
+ * @param key - The storage key, or `null` when there is nothing to persist.
+ * @param options - `defaultValue`, reported until the provider supplies one.
+ * @returns The current value, its mutators, and whether it is definite yet.
+ *
+ * @example
+ * ```tsx
+ * const { value: width, setValue: setWidth, ready } = useStoragePreference<number>(key, {
+ *   defaultValue: 280,
+ * })
+ * // A drag calls setWidth(320): the UI updates now and the write persists.
+ * // `ready` is false until hydration lands, so an effect must not persist the
+ * // fallback before then.
+ * ```
+ */
+export declare function useStoragePreference<T = unknown>(key: string | null | undefined, options?: UseStoragePreferenceOptions<T>): UseStoragePreferenceResult<T>;
 /**
  * Hook for simple storage operations without React state sync.
  *

package/dist/hooks/useStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAUpD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,qBAAqB,CAAC,CAAC,CAAC,CAsF1B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC9B,CAoBA"}
+{"version":3,"file":"useStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAIhF;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAUpD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,qBAAqB,CAAC,CAAC,CAAC,CAuF1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,kEAAkE;IAClE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;IACpB;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,KAAK,IAAI,CAAA;IAC9D,oDAAoD;IACpD,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAC9C,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACvC,0BAA0B,CAAC,CAAC,CAAC,CA8D/B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI;IAC5B,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC1C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC9B,CAoBA"}

package/dist/hooks/useStorage.js

@@ -3,8 +3,9 @@
  *
  * @module
  */
-import { useCallback, useContext, useEffect, useState } from 'react';
+import { useCallback, useContext, useEffect, useRef, useState } from 'react';
 import { t } from '@molecule/app-i18n';
+import { getPreferenceStore } from '@molecule/app-storage';
 import { StorageContext } from '../contexts.js';
 /**
  * Hook to access the storage provider from context.
@@ -49,19 +50,26 @@ export function useStorageValue(key, options) {
     const [value, setValueState] = useState(defaultValue);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
+    /**
+     * Incremented by every local write. A read that started before it must not
+     * replace the newer value — the user editing before the first read lands is
+     * the common case on a slow (native, encrypted) backend.
+     */
+    const writeVersion = useRef(0);
     // Load initial value
     useEffect(() => {
         let mounted = true;
+        const version = writeVersion.current;
         const loadValue = async () => {
             try {
                 const stored = await storage.get(key);
-                if (mounted) {
+                if (mounted && writeVersion.current === version) {
                     setValueState(stored ?? defaultValue);
                     setLoading(false);
                 }
             }
             catch (err) {
-                if (mounted) {
+                if (mounted && writeVersion.current === version) {
                     setError(err instanceof Error ? err : new Error(String(err)));
                     setLoading(false);
                 }
@@ -72,26 +80,19 @@ export function useStorageValue(key, options) {
             mounted = false;
         };
     }, [key, storage, defaultValue]);
-    // Sync across tabs if supported
+    // Sync across tabs if supported — through the PROVIDER's own subscription, so
+    // a non-browser backend (native, encrypted, memory) propagates the same way
+    // instead of being limited to the browser `storage` event.
     useEffect(() => {
-        if (!sync)
+        if (!sync || !storage.subscribe)
             return;
-        const handleStorageChange = (event) => {
-            if (event.key === key && event.newValue !== null) {
-                try {
-                    const newValue = JSON.parse(event.newValue);
-                    setValueState(newValue);
-                }
-                catch (_error) {
-                    // JSON.parse failed on newValue — the cross-tab sync is best-effort and the
-                    // local state already holds the last good value, so ignoring is safe here.
-                }
-            }
-        };
-        window.addEventListener('storage', handleStorageChange);
-        return () => window.removeEventListener('storage', handleStorageChange);
-    }, [key, sync]);
+        return storage.subscribe(key, (next) => {
+            writeVersion.current += 1;
+            setValueState(next === null ? defaultValue : next);
+        });
+    }, [key, sync, storage, defaultValue]);
     const setValue = useCallback(async (newValue) => {
+        writeVersion.current += 1;
         try {
             await storage.set(key, newValue);
             setValueState(newValue);
@@ -103,6 +104,7 @@ export function useStorageValue(key, options) {
         }
     }, [key, storage]);
     const removeValue = useCallback(async () => {
+        writeVersion.current += 1;
         try {
             await storage.remove(key);
             setValueState(defaultValue);
@@ -121,6 +123,92 @@ export function useStorageValue(key, options) {
         error,
     };
 }
+/**
+ * Subscribes React state to ONE persisted preference.
+ *
+ * This is the component-side half of `getPreferenceStore()`: a render-time value
+ * is available immediately when the bonded provider can answer synchronously,
+ * and an asynchronous provider's hydration CONVERGES onto the same component
+ * without a remount. Ordering is the store's: a read that started before a
+ * newer write, remove or external change is discarded, so a slow hydration
+ * never overwrites an edit the user already made.
+ *
+ * Pass `null` for `key` while the real key is unknown (no project selected
+ * yet): the hook then behaves as local state around `defaultValue` and persists
+ * nothing.
+ *
+ * @param key - The storage key, or `null` when there is nothing to persist.
+ * @param options - `defaultValue`, reported until the provider supplies one.
+ * @returns The current value, its mutators, and whether it is definite yet.
+ *
+ * @example
+ * ```tsx
+ * const { value: width, setValue: setWidth, ready } = useStoragePreference<number>(key, {
+ *   defaultValue: 280,
+ * })
+ * // A drag calls setWidth(320): the UI updates now and the write persists.
+ * // `ready` is false until hydration lands, so an effect must not persist the
+ * // fallback before then.
+ * ```
+ */
+export function useStoragePreference(key, options) {
+    const store = getPreferenceStore();
+    const defaultValueRef = useRef(options?.defaultValue);
+    defaultValueRef.current = options?.defaultValue;
+    const read = useCallback(() => {
+        if (!key)
+            return defaultValueRef.current;
+        const stored = store.get(key);
+        return stored === null ? defaultValueRef.current : stored;
+    }, [store, key]);
+    const [value, setValueState] = useState(read);
+    const [ready, setReady] = useState(!key);
+    const valueRef = useRef(value);
+    valueRef.current = value;
+    useEffect(() => {
+        if (!key) {
+            setReady(true);
+            setValueState(defaultValueRef.current);
+            return;
+        }
+        let cancelled = false;
+        const sync = () => {
+            if (!cancelled)
+                setValueState(read());
+        };
+        // Seed from whatever the store already knows, then let hydration converge
+        // it. With a synchronous provider this is a no-op change.
+        sync();
+        setReady(false);
+        const stop = store.subscribe(key, sync);
+        void store.hydrate([key]).then(() => {
+            if (cancelled)
+                return;
+            sync();
+            setReady(true);
+        });
+        return () => {
+            cancelled = true;
+            stop();
+        };
+    }, [store, key, read]);
+    const setValue = useCallback((next) => {
+        const resolved = typeof next === 'function'
+            ? next(valueRef.current)
+            : next;
+        valueRef.current = resolved;
+        setValueState(resolved);
+        if (key)
+            store.set(key, resolved);
+    }, [store, key]);
+    const removeValue = useCallback(() => {
+        valueRef.current = defaultValueRef.current;
+        setValueState(defaultValueRef.current);
+        if (key)
+            store.remove(key);
+    }, [store, key]);
+    return { value, setValue, removeValue, ready };
+}
 /**
  * Hook for simple storage operations without React state sync.
  *

package/dist/hooks/useStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStorage.js","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useStorage.js","sourceRoot":"","sources":["../../src/hooks/useStorage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-react",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "React framework bindings for molecule.dev",
   "type": "module",
   "main": "dist/index.js",
@@ -62,7 +62,7 @@
   "devDependencies": {
     "@molecule/app-ai-models": "1.4.3",
     "@molecule/app-bonds-default-react": "3.0.0",
-    "@molecule/app-i18n": "1.1.0",
+    "@molecule/app-i18n": "1.1.1",
     "@testing-library/dom": "10.4.2",
     "@testing-library/react": "16.3.3",
     "@types/node": "26.6.5",