feat(state): enable application state management

.changeset/app_state-support.md

@@ -0,0 +1,31 @@
+---
+"@equinor/fusion-framework-app": minor
+---
+
+Add state management module support to @equinor/fusion-framework-app
+
+This change introduces comprehensive state management capabilities to the app package, allowing developers to easily enable persistent state storage in their Fusion applications.
+
+**Features**
+
+- **State Module Enabler**: Added `enableState` function that configures the state module with PouchDB storage
+- **Package Exports**: Added new export path `./enable-state` for the state enabler function
+- **Type Definitions**: Added typesVersions support for the new state enabler
+- **Peer Dependencies**: Added `@equinor/fusion-framework-module-state` as an optional peer dependency
+- **Storage Configuration**: Automatic app-scoped storage with key prefixing to prevent state collisions
+
+**Usage**
+
+Applications can now enable state management by:
+
+```typescript
+import { enableState } from '@equinor/fusion-framework-app/enable-state';
+
+export const configure = (configurator) => {
+  enableState(configurator);
+};
+```
+
+The state module provides persistent storage with automatic app-key scoping and uses PouchDB for reliable data persistence across browser sessions.
+
+**Note**: Applications must install `@equinor/fusion-framework-module-state` to use this functionality.

.changeset/cookbook-app-react-state_merge-with-replication.md

@@ -0,0 +1,28 @@
+---
+"@equinor/fusion-framework-cookbook-app-react-state": major
+---
+
+Merged the `app-react-state` and `app-react-state-replication` cookbooks into one comprehensive
+`@equinor/fusion-framework-cookbook-app-react-state` cookbook covering the full
+`@equinor/fusion-framework-module-state` surface:
+
+- **Basics** page: `useAppState` fundamentals - boolean, string, and optional state with no
+  `defaultValue` - using the state module's own zero-config default storage.
+- **Profile** and **Todos** pages: object and list state, now optionally upgraded to CouchDB
+  replication via `PouchDbSyncStorage` when `FUSION_SPA_COUCHDB_URL` is set (see `.env.example`)
+  - unset, the cookbook runs with no Docker/CouchDB setup required.
+- Replaced the cookbook's custom `app-state-with-replication` module (a hand-rolled
+  `StateProvider`/sync-event reimplementation) with the framework's own `PouchDbSyncStorage` and
+  native `onStateSync.status` / `onStateSync.change` / `onStateSync.complete` / `onStateSync.error`
+  events, dispatched through the app's `event` module.
+- Removed `predev`'s automatic CouchDB startup - `pnpm couchdb:start` is now an explicit, optional
+  step for trying the replication demo.
+- The `SyncStatusMonitor`/`SyncEventList`/`SyncStatusIndicator` components now consume the
+  framework's `useStateSyncEvents` hook (`@equinor/fusion-framework-react-app/state`) instead of a
+  cookbook-local hook/Context reimplementation of the same subscription logic.
+- Simplified `ProfileManager` from 10 files (a `@equinor/fusion-observable` reducer, action
+  creators, and seven single-field presentational components) down to a single component using
+  plain `useAppState` + immutable object spreads, matching the pattern already used by the
+  `Basics` and `Todos` pages - and dropped the now-unused `@equinor/fusion-observable` dependency.
+- Removed leftover debug `console.log`s and dead types (`SyncStatus`, `ReplicationSettings`) left
+  over from the pre-merge, hand-rolled sync implementation.

.changeset/module-state_sync-events.md

@@ -0,0 +1,40 @@
+---
+"@equinor/fusion-framework-module-state": major
+---
+
+**🚀 Introducing the Fusion Framework State Module**
+
+**@equinor/fusion-framework-module-state** is a new reactive state management module with built-in synchronization capabilities and comprehensive event system for enterprise-grade applications.
+
+**🗄️ Synchronization Features**
+- **PouchDbSyncStorage**: Bidirectional synchronization with remote databases
+- **Real-time sync events**: Monitor sync progress, errors, and status changes
+- **Conflict resolution**: Automatic handling of concurrent data modifications
+- **Live sync options**: Configurable heartbeat, retry, and timeout settings
+
+**📡 Event System**
+Comprehensive event architecture for type-safe state management:
+
+**Event Classes:**
+- `StateEntryCreatedEvent` - Item creation tracking
+- `StateEntryUpdatedEvent` - Item modification events
+- `StateEntryDeletedEvent` - Item removal notifications
+- `StateSyncChangeEvent` - Sync data changes
+- `StateSyncCompleteEvent` - Sync operation completion
+- `StateSyncErrorEvent` - Sync failure handling
+- `StateSyncStatusEvent` - Sync status monitoring
+- `StateOperationSuccessEvent` - Successful operations
+- `StateOperationFailureEvent` - Operation failure tracking
+
+**Event Organization:**
+- `StateChangeEvent` - CRUD operation events
+- `StateSyncEvent` - Synchronization events
+- `StateOperationEvent` - Operation result events
+
+**🏗️ Core Architecture**
+- **StateProvider**: Reactive state management with observable patterns
+- **Storage Interface**: Extensible storage backends with sync capabilities
+- **Type Safety**: Comprehensive TypeScript definitions
+- **Memory Management**: Proper cleanup and disposal patterns
+- Storage and sync events are dispatched through the app's `event` module, so `onStateSync.*`
+  listeners registered via `useAppModule('event').addEventListener(...)` actually fire.

.changeset/module_fix-reduce-type-inference.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-module": patch
+---
+
+Internal: pin explicit generic types on the `reduce` operator in `createModuleConfigs` so the accumulator type is no longer inferred as `unknown` under TypeScript 7's stricter inference, which broke builds for consumers with composite project references.

.changeset/react-app_state-support.md

@@ -0,0 +1,32 @@
+---
+"@equinor/fusion-framework-react-app": minor
+---
+
+Add state management support to `@equinor/fusion-framework-react-app/state`:
+
+- `enableAppState` - configures the app to use `@equinor/fusion-framework-module-state`, with
+  app-scoped storage key prefixing to prevent state collisions between apps.
+- `useAppState` - a persistent, cross-component-synchronized alternative to `useState`, backed by
+  the state module's storage.
+- `useStateSyncEvents` - subscribes to the app's `onStateSync.status`/`.change`/`.complete`/`.error`
+  events (dispatched when storage is configured for replication, e.g. `PouchDbSyncStorage`) and
+  returns the most recent events, oldest first, bounded to a given `limit`. Also re-exports
+  `StateSyncEvent` and `StateSyncEventType` from `@equinor/fusion-framework-module-state` for
+  convenience.
+
+```typescript
+import { enableAppState } from '@equinor/fusion-framework-react-app/state';
+
+export const configure = (configurator) => {
+  enableAppState(configurator);
+};
+```
+
+```typescript
+import { useAppState, useStateSyncEvents } from '@equinor/fusion-framework-react-app/state';
+
+const [count, setCount] = useAppState('counter', { defaultValue: 0 });
+const events = useStateSyncEvents(20);
+```
+
+Requires the optional peer dependency `@equinor/fusion-framework-module-state`.

CODEMAP.md

@@ -61,6 +61,7 @@ Format: `package name` → path → role.
 | `@equinor/fusion-framework-module-service-discovery` | `packages/modules/service-discovery` | Service discovery |
 | `@equinor/fusion-framework-module-services` | `packages/modules/services` | Typed Fusion service clients |
 | `@equinor/fusion-framework-module-signalr` | `packages/modules/signalr` | SignalR transport |
+| `@equinor/fusion-framework-module-state` | `packages/modules/state` | Replicated/persisted app state (PouchDB-backed sync) |
 | `@equinor/fusion-framework-module-telemetry` | `packages/modules/telemetry` | Microsoft telemetry |
 | `@equinor/fusion-framework-module-widget` | `packages/modules/widget` | Widget loading |
 
@@ -141,8 +142,9 @@ Format: `package name` → path → role.
 `app-react-bookmark`, `app-react-bookmark-advanced`, `app-react-charts`, `app-react-context`,
 `app-react-context-custom-error`, `app-react-environment-variables`, `app-react-feature-flag`,
 `app-react-module`, `app-react-msal`, `app-react-observable`, `app-react-people`,
-`app-react-router`, `app-react-router-legacy`, `app-react-settings`, `app-react-styling`,
-`app-vanilla`, `poc-portal`, `portal`, `portal-analytics`.
+`app-react-router`, `app-react-router-legacy`, `app-react-settings`, `app-react-state`,
+`app-react-styling`, `app-vanilla`, `poc-portal`, `portal`,
+`portal-analytics`.
 
 Package name pattern: `@equinor/fusion-framework-cookbook-<folder>`.
 

cookbooks/app-react-state/.env.example

@@ -0,0 +1,8 @@
+# Local CouchDB replication demo (optional)
+#
+# Unset (the default), the state module uses its own default storage - the same
+# zero-config behavior any consuming app gets.
+#
+# To see the `Profile`, `Todos`, and sync-event pages replicate against a local Docker
+# CouchDB instead: run `pnpm couchdb:start`, copy this file to `.env`, then restart `pnpm dev`.
+FUSION_SPA_COUCHDB_URL=http://admin:admin@localhost:5984/cookbooks_app_state