@mmapp/react 0.1.0-alpha.1 → 0.1.0-alpha.3

package/README.md

@@ -0,0 +1,112 @@
+# @mmapp/react
+
+React hooks, components, and runtime bridge for building MindMatrix workflow applications.
+
+Published on npm as `@mmapp/react` (internal workspace name: `@mindmatrix/react`).
+
+## Installation
+
+```bash
+npm install @mmapp/react @mmapp/player-core
+```
+
+## Hooks
+
+| Hook | Purpose |
+|------|---------|
+| `useQuery(slug)` | Fetch workflow instances by slug |
+| `useMutation(slug)` | Create, update, transition workflow instances |
+| `usePlayer(definition)` | Run a state machine in the browser |
+| `useRouter()` | Blueprint-aware navigation |
+| `useAuth()` | Authentication state |
+| `useToast()` | Toast notifications |
+| `useForm(fields)` | Form state management with validation |
+| `useChannel(name)` | Real-time WebSocket channels |
+| `useRole(slug)` | Role-based access control |
+| `useComputed(expr)` | Computed field evaluation |
+| `useModel(definition)` | Type-safe model access |
+| `useModule(slug)` | Module configuration |
+| `useServerAction(name)` | Server-side action execution |
+| `useServerState(slug)` | Server-synced state |
+
+## Configuration
+
+### defineBlueprint
+
+```typescript
+import { defineBlueprint } from '@mmapp/react';
+
+export default defineBlueprint({
+  slug: 'my-app',
+  name: 'My App',
+  version: '1.0.0',
+  models: [employeeModel, departmentModel],
+  views: {
+    '/': HomePage,
+    '/employees': EmployeeList,
+    '/employees/:id': EmployeeDetail,
+  },
+});
+```
+
+### defineModel
+
+```typescript
+import { defineModel } from '@mmapp/react';
+
+export default defineModel({
+  slug: 'employee',
+  fields: {
+    name: { type: 'string', required: true },
+    salary: { type: 'number', default: 0 },
+    department: { type: 'string' },
+  },
+  states: {
+    active: { type: 'initial' },
+    terminated: { type: 'terminal' },
+  },
+  transitions: {
+    terminate: { from: ['active'], to: 'terminated' },
+  },
+});
+```
+
+## Atoms
+
+Pre-built UI components available via `@mmapp/react/atoms`:
+
+```typescript
+import { Box, Text, Button, Input, Select, Modal, Card } from '@mmapp/react/atoms';
+```
+
+## npm Publishing
+
+This package is published to npm under the `@mmapp` scope.
+
+| npm name | workspace name | current version |
+|----------|---------------|-----------------|
+| `@mmapp/react` | `@mindmatrix/react` | 0.1.0-alpha.1 |
+
+### Publishing a new version
+
+Use the publish script from the monorepo root:
+
+```bash
+# Publish all 3 packages (player-core, react, react-compiler)
+./scripts/publish-npm.sh patch   # 0.1.0-alpha.1 → 0.1.0-alpha.2
+./scripts/publish-npm.sh minor   # 0.1.0-alpha.1 → 0.2.0-alpha.1
+./scripts/publish-npm.sh 0.2.0-beta.1  # explicit version
+```
+
+Or publish just this package:
+
+```bash
+cd packages/react
+pnpm run publish:alpha          # auto-increments alpha version
+```
+
+### Version strategy
+
+- `0.1.0-alpha.X` — internal development (current)
+- `0.1.0-beta.X` — user testing
+- `1.0.0` — production launch

package/dist/index.d.mts

@@ -4746,9 +4746,34 @@ declare function getInstalledModule(slug: string): InstalledModuleRef | undefine
 declare function getInstalledModules(): InstalledModuleRef[];
 /**
  * Read the merged configuration for a module.
- * Merges: configSchema.defaults ← install-time config
+ * Merges: configSchema.defaults ← persisted server config ← install-time overrides
  */
 declare function useModuleConfig(moduleSlug: string): Record<string, unknown>;
+/** Set persisted config for a module (loaded from server at boot) */
+declare function setPersistedModuleConfig(moduleSlug: string, config: Record<string, unknown>): void;
+/**
+ * Sync module config defaults to the server at install time.
+ * Creates or updates the config for a module with its default values.
+ * Called by handleInstallModule when a module is first installed.
+ */
+declare function syncConfigDefaults(moduleSlug: string, defaults: Record<string, unknown>, definitionId?: string): Promise<void>;
+/** Set the active definition context for config mutations */
+declare function setConfigContext(definitionId: string, apiBaseUrl?: string): void;
+/**
+ * Update config values for the active definition.
+ * PATCHes /api/v1/workflow/definitions/{id}/config with the provided key-value pairs.
+ * Returns the updated config object from the server.
+ */
+declare function updateDefinitionConfig(values: Record<string, unknown>, definitionId?: string): Promise<Record<string, unknown>>;
+/**
+ * Hook that returns the merged config + an updateConfig function.
+ * Combines read (useModuleConfig) with write (updateDefinitionConfig).
+ */
+declare function useModuleConfigWithMutation(moduleSlug: string): {
+    config: Record<string, unknown>;
+    updateConfig: (values: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    isSaving: boolean;
+};
 
 /**
  * @mindmatrix/react/builders — Fluent builder API for ModelDefinition objects.
@@ -6996,4 +7021,4 @@ declare class BrowserPlayer {
     private log;
 }
 
-export { Accordion, type ActionContext, type ActionCreator, type ActionCreators, type ActionDefinition, type ActionEnvironment, type ActionHandler, type ActionManifest, type ActionManifestEntry, type ActionNotifyOptions, type ActionOptions, type ActionResult, AnimatedBox, type ApprovalConfig, type AuthOptions, type AuthResolver, type AuthResult, type AuthUser, Badge, type BadgeProps, Blueprint, type BlueprintAction, type BlueprintConfig, type BlueprintConfigSchema, type BlueprintDependency, type BlueprintManifest, type BlueprintRoute, type BlueprintServerActionDeclaration, type BlueprintSlotContribution, type BlueprintViewDeclaration, BrowserPlayer, type BrowserPlayerConfig, type TransitionResult as BrowserTransitionResult, Button, type ButtonProps, type CRUDConfig, Canvas3D, Card, type CardProps, type CedarPolicy, type ChannelHandle, type ChannelMessage, type ChannelOptions, type ChannelTransport, Chart, type CollectionHandle, Column, type ColumnProps, type ComputedFieldMode, type ComputedFieldResult, type CronFields, type CrudConfig, DataGrid, type DataSource, type DataSourceResult, Divider, type DividerProps, type DmnRule, type DomainEvent, type DomainSubscriptionConfig, type DomainSubscriptionTransport, type DuringAction, type DuringActionConfig, Each, type EachProps, type EscalationConfig, type EventPayload, type EventSubscription, type ExperienceViewConfig, ExperienceWorkflowBridge, type ExperienceWorkflowBridgeProps, type ExperienceWorkflowDefinition, type ExpressionLibraryRecord, type ExpressionLibraryResolver, type ExpressionLibraryResult, Field, FieldBuilder, type FieldRegistration, type FieldTypeMap, type FieldValidation, type FieldValidator, type FormConfig, type FormHandle, type FormValidator, type GeoPosition, type GeolocationError, type GeolocationOptions, type GeolocationResult, type GrammarIsland, Grid, Heading, type HeadingProps, Icon, Image, type InferFieldNames, type InferFields, type InferSlug, type InferStates, type InferTransitions, type InstalledModuleRef, type InstanceData, type InstanceKeyParams, type InstanceRef, type LatLng, type LatLngBounds, type LibraryParam, Link, type LocalDataResolver, type LocalEngineAdapter, type LocalEngineContextValue, LocalEngineProvider, type LocalEngineStore, LocalWorkflowEngine, type LoginCredentials, type MapMarker, type MapViewHandle, type MapViewOptions, Markdown, MetricCard, type MiddlewareContext, type MiddlewareFn, type MiddlewareHandle, type MiddlewareOptions, type MiddlewareResult, type MmWasmModule, Modal, ModelBuilder, type ModelDefinition, type ModelHandle, type ModelMixin, type ModelTestContext, type ModuleAction, type ModuleConfigSchema, type ModuleDependency, type ModuleHandle, type ModuleManifest, type ModuleRoute, type ModuleRouteConfig, type MutationHandle, type MutationResolver, NavLink, type NotificationResult, type NotifyOptions, type PackageChild, type PackageManifest, type PackageResult, type PipelineConfig, type PipelineStage, type PlayerConfig, type PlayerEvent, type PlayerEventCallback, type PlayerEventListener, type PlayerHandle, type PlayerInstance, type PlayerLogEntry, PlayerProvider, type PlayerProviderProps, type QueryParams$1 as QueryParams, type QueryResolver, type QueryResult, type RealtimeQueryParams, type RealtimeQueryResult, type ReviewConfig, type RoleDefinition, RoleGuard, type RoleOptions, type RoleResult, Route, type RouteDefinition, type RouteGuard, type RouteLocation, type RouteParamsOptions, Router, type RouterHandle, type RouterOptions, Row, type RowProps, type RuntimeConfig, RuntimeContext, type RuntimeSnapshot, ScrollArea, Section, Select, type ServerActionFn, type ServerActionHandle, type ServerActionOptions, type ServerActionResolver, type ServerActionResult, ServerGrid, type ServerStateOptions, type ServerStateResolver, type ServerStateResult, type ServerStateSnapshot, type SetupWizard, type SetupWizardStep, Show, type ShowProps, Slot, type SlotContribution, type SlotContributions, type SlotProps, Spacer, type SpawnActionOptions, type SpawnOptions, Stack, type StackProps, StateBuilder, type StateDescriptor, type StateHome, type Subscription, Tabs, type TestChain, type TestStep, Text, TextInput, type TextInputProps, type TextProps, type ToastConfig, type ToastHandle, type ToastInstance, type ToastVariant, TransitionBuilder, type TransitionCondition, type TransitionConfig, type TransitionContext, type TransitionDescriptor, type TransitionHandle, type TypedMutationHandle, TypedTransitionBuilder, type UseCollectionOptions, type UseComputedOptions, type UseModelOptions, type UseModuleOptions, type UseOnEventOptions, type UseWorkflowOptions, type ValidationIssue, type ValidationResult, type ValidationRule, type ViewDefinitionResult, type ViewRecord, type ViewResolver, type WithAuditTrailOptions, type WithOwnershipOptions, type WithRBACOptions, type WithSearchOptions, type WithSlugOptions, type WithSoftDeleteOptions, type WithVersioningOptions, type WorkflowDataSource, type WorkflowDefinition, type WorkflowEvent, type WorkflowEventHandler, type WorkflowFieldDef, type WorkflowFieldDescriptor, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceWithEvents, WorkflowProvider, type WorkflowProviderProps, WorkflowRuntime, type WorkflowState, type WorkflowTransition, action, and, applyMixins, approval, assertModelValid, cedar, connector, createActions, createCRUD, createLocalDataResolver, createLocalEngineAdapter, createPipeline, cron, crud, defineBlueprint, defineModel, defineModule, defineWorkspace, deriveInstanceKey, deriveInstanceKeySync, describeModel, deviceAction, dmn, escalation, expr, field, fieldContains, fieldEquals, fieldGreaterThan, fieldIn, fieldIsEmpty, fieldIsSet, fieldLessThan, fieldMatches, fieldNotEquals, fieldNotIn, getInstalledModule, getInstalledModules, graphql, hasAnyRole, hasRole, inState, inputEquals, inputRequired, isActor, isCreator, isOwner, isPlayerDebug, isSender, jsonpath, llm, loadExperienceWorkflow, logEvent, model, normalizeDefinition, not, notInState, notify, or, pipe, playerLog, prefetchData, refHasAnyRole, refHasRole, requireAuth, requireRole, review, serverAction, setAuthResolver, setChannelTransport, setExpressionLibraryResolver, setField, setFields, setInstalledModules, setModuleConfigDefaults, setMutationResolver, setPlayerDebug, setQueryResolver, setRealtimeQueryResolver, setRoleHierarchy, setServerActionResolver, setServerStateResolver, setViewResolver, spawn, sql, state, testModel, transition, useAuth, useChannel, useCollection, useComputed, useComputedWithMeta, useDomainSubscription, useDuringAction, useExperienceState, useExpressionLibrary, useForm, useGeolocation, useLocalEngine, useMapView, useMiddleware, useModel, useModule, useModuleConfig, useMutation, useNotification, useOnChange, useOnEnter, useOnEvent, useOnExit, useOnTransition, usePackage, useParams, usePlayer, usePlayerContext, usePlayerContextSafe, useQuery, useRealtimeQuery, useRole, useRouteParams, useRouter, useRuntimeContext, useServerAction, useServerState, useStateField, useToast, useTransition, useView, useWhileIn, useWorkflow, useState as useWorkflowState, validateExperienceWorkflow, validateModel, when, withAuditTrail, withOwnership, withPagination, withRBAC, withSearch, withSlug, withSoftDelete, withTags, withTimestamps, withVersioning };
+export { Accordion, type ActionContext, type ActionCreator, type ActionCreators, type ActionDefinition, type ActionEnvironment, type ActionHandler, type ActionManifest, type ActionManifestEntry, type ActionNotifyOptions, type ActionOptions, type ActionResult, AnimatedBox, type ApprovalConfig, type AuthOptions, type AuthResolver, type AuthResult, type AuthUser, Badge, type BadgeProps, Blueprint, type BlueprintAction, type BlueprintConfig, type BlueprintConfigSchema, type BlueprintDependency, type BlueprintManifest, type BlueprintRoute, type BlueprintServerActionDeclaration, type BlueprintSlotContribution, type BlueprintViewDeclaration, BrowserPlayer, type BrowserPlayerConfig, type TransitionResult as BrowserTransitionResult, Button, type ButtonProps, type CRUDConfig, Canvas3D, Card, type CardProps, type CedarPolicy, type ChannelHandle, type ChannelMessage, type ChannelOptions, type ChannelTransport, Chart, type CollectionHandle, Column, type ColumnProps, type ComputedFieldMode, type ComputedFieldResult, type CronFields, type CrudConfig, DataGrid, type DataSource, type DataSourceResult, Divider, type DividerProps, type DmnRule, type DomainEvent, type DomainSubscriptionConfig, type DomainSubscriptionTransport, type DuringAction, type DuringActionConfig, Each, type EachProps, type EscalationConfig, type EventPayload, type EventSubscription, type ExperienceViewConfig, ExperienceWorkflowBridge, type ExperienceWorkflowBridgeProps, type ExperienceWorkflowDefinition, type ExpressionLibraryRecord, type ExpressionLibraryResolver, type ExpressionLibraryResult, Field, FieldBuilder, type FieldRegistration, type FieldTypeMap, type FieldValidation, type FieldValidator, type FormConfig, type FormHandle, type FormValidator, type GeoPosition, type GeolocationError, type GeolocationOptions, type GeolocationResult, type GrammarIsland, Grid, Heading, type HeadingProps, Icon, Image, type InferFieldNames, type InferFields, type InferSlug, type InferStates, type InferTransitions, type InstalledModuleRef, type InstanceData, type InstanceKeyParams, type InstanceRef, type LatLng, type LatLngBounds, type LibraryParam, Link, type LocalDataResolver, type LocalEngineAdapter, type LocalEngineContextValue, LocalEngineProvider, type LocalEngineStore, LocalWorkflowEngine, type LoginCredentials, type MapMarker, type MapViewHandle, type MapViewOptions, Markdown, MetricCard, type MiddlewareContext, type MiddlewareFn, type MiddlewareHandle, type MiddlewareOptions, type MiddlewareResult, type MmWasmModule, Modal, ModelBuilder, type ModelDefinition, type ModelHandle, type ModelMixin, type ModelTestContext, type ModuleAction, type ModuleConfigSchema, type ModuleDependency, type ModuleHandle, type ModuleManifest, type ModuleRoute, type ModuleRouteConfig, type MutationHandle, type MutationResolver, NavLink, type NotificationResult, type NotifyOptions, type PackageChild, type PackageManifest, type PackageResult, type PipelineConfig, type PipelineStage, type PlayerConfig, type PlayerEvent, type PlayerEventCallback, type PlayerEventListener, type PlayerHandle, type PlayerInstance, type PlayerLogEntry, PlayerProvider, type PlayerProviderProps, type QueryParams$1 as QueryParams, type QueryResolver, type QueryResult, type RealtimeQueryParams, type RealtimeQueryResult, type ReviewConfig, type RoleDefinition, RoleGuard, type RoleOptions, type RoleResult, Route, type RouteDefinition, type RouteGuard, type RouteLocation, type RouteParamsOptions, Router, type RouterHandle, type RouterOptions, Row, type RowProps, type RuntimeConfig, RuntimeContext, type RuntimeSnapshot, ScrollArea, Section, Select, type ServerActionFn, type ServerActionHandle, type ServerActionOptions, type ServerActionResolver, type ServerActionResult, ServerGrid, type ServerStateOptions, type ServerStateResolver, type ServerStateResult, type ServerStateSnapshot, type SetupWizard, type SetupWizardStep, Show, type ShowProps, Slot, type SlotContribution, type SlotContributions, type SlotProps, Spacer, type SpawnActionOptions, type SpawnOptions, Stack, type StackProps, StateBuilder, type StateDescriptor, type StateHome, type Subscription, Tabs, type TestChain, type TestStep, Text, TextInput, type TextInputProps, type TextProps, type ToastConfig, type ToastHandle, type ToastInstance, type ToastVariant, TransitionBuilder, type TransitionCondition, type TransitionConfig, type TransitionContext, type TransitionDescriptor, type TransitionHandle, type TypedMutationHandle, TypedTransitionBuilder, type UseCollectionOptions, type UseComputedOptions, type UseModelOptions, type UseModuleOptions, type UseOnEventOptions, type UseWorkflowOptions, type ValidationIssue, type ValidationResult, type ValidationRule, type ViewDefinitionResult, type ViewRecord, type ViewResolver, type WithAuditTrailOptions, type WithOwnershipOptions, type WithRBACOptions, type WithSearchOptions, type WithSlugOptions, type WithSoftDeleteOptions, type WithVersioningOptions, type WorkflowDataSource, type WorkflowDefinition, type WorkflowEvent, type WorkflowEventHandler, type WorkflowFieldDef, type WorkflowFieldDescriptor, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceWithEvents, WorkflowProvider, type WorkflowProviderProps, WorkflowRuntime, type WorkflowState, type WorkflowTransition, action, and, applyMixins, approval, assertModelValid, cedar, connector, createActions, createCRUD, createLocalDataResolver, createLocalEngineAdapter, createPipeline, cron, crud, defineBlueprint, defineModel, defineModule, defineWorkspace, deriveInstanceKey, deriveInstanceKeySync, describeModel, deviceAction, dmn, escalation, expr, field, fieldContains, fieldEquals, fieldGreaterThan, fieldIn, fieldIsEmpty, fieldIsSet, fieldLessThan, fieldMatches, fieldNotEquals, fieldNotIn, getInstalledModule, getInstalledModules, graphql, hasAnyRole, hasRole, inState, inputEquals, inputRequired, isActor, isCreator, isOwner, isPlayerDebug, isSender, jsonpath, llm, loadExperienceWorkflow, logEvent, model, normalizeDefinition, not, notInState, notify, or, pipe, playerLog, prefetchData, refHasAnyRole, refHasRole, requireAuth, requireRole, review, serverAction, setAuthResolver, setChannelTransport, setConfigContext, setExpressionLibraryResolver, setField, setFields, setInstalledModules, setModuleConfigDefaults, setMutationResolver, setPersistedModuleConfig, setPlayerDebug, setQueryResolver, setRealtimeQueryResolver, setRoleHierarchy, setServerActionResolver, setServerStateResolver, setViewResolver, spawn, sql, state, syncConfigDefaults, testModel, transition, updateDefinitionConfig, useAuth, useChannel, useCollection, useComputed, useComputedWithMeta, useDomainSubscription, useDuringAction, useExperienceState, useExpressionLibrary, useForm, useGeolocation, useLocalEngine, useMapView, useMiddleware, useModel, useModule, useModuleConfig, useModuleConfigWithMutation, useMutation, useNotification, useOnChange, useOnEnter, useOnEvent, useOnExit, useOnTransition, usePackage, useParams, usePlayer, usePlayerContext, usePlayerContextSafe, useQuery, useRealtimeQuery, useRole, useRouteParams, useRouter, useRuntimeContext, useServerAction, useServerState, useStateField, useToast, useTransition, useView, useWhileIn, useWorkflow, useState as useWorkflowState, validateExperienceWorkflow, validateModel, when, withAuditTrail, withOwnership, withPagination, withRBAC, withSearch, withSlug, withSoftDelete, withTags, withTimestamps, withVersioning };

package/dist/index.d.ts

@@ -4746,9 +4746,34 @@ declare function getInstalledModule(slug: string): InstalledModuleRef | undefine
 declare function getInstalledModules(): InstalledModuleRef[];
 /**
  * Read the merged configuration for a module.
- * Merges: configSchema.defaults ← install-time config
+ * Merges: configSchema.defaults ← persisted server config ← install-time overrides
  */
 declare function useModuleConfig(moduleSlug: string): Record<string, unknown>;
+/** Set persisted config for a module (loaded from server at boot) */
+declare function setPersistedModuleConfig(moduleSlug: string, config: Record<string, unknown>): void;
+/**
+ * Sync module config defaults to the server at install time.
+ * Creates or updates the config for a module with its default values.
+ * Called by handleInstallModule when a module is first installed.
+ */
+declare function syncConfigDefaults(moduleSlug: string, defaults: Record<string, unknown>, definitionId?: string): Promise<void>;
+/** Set the active definition context for config mutations */
+declare function setConfigContext(definitionId: string, apiBaseUrl?: string): void;
+/**
+ * Update config values for the active definition.
+ * PATCHes /api/v1/workflow/definitions/{id}/config with the provided key-value pairs.
+ * Returns the updated config object from the server.
+ */
+declare function updateDefinitionConfig(values: Record<string, unknown>, definitionId?: string): Promise<Record<string, unknown>>;
+/**
+ * Hook that returns the merged config + an updateConfig function.
+ * Combines read (useModuleConfig) with write (updateDefinitionConfig).
+ */
+declare function useModuleConfigWithMutation(moduleSlug: string): {
+    config: Record<string, unknown>;
+    updateConfig: (values: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    isSaving: boolean;
+};
 
 /**
  * @mindmatrix/react/builders — Fluent builder API for ModelDefinition objects.
@@ -6996,4 +7021,4 @@ declare class BrowserPlayer {
     private log;
 }
 
-export { Accordion, type ActionContext, type ActionCreator, type ActionCreators, type ActionDefinition, type ActionEnvironment, type ActionHandler, type ActionManifest, type ActionManifestEntry, type ActionNotifyOptions, type ActionOptions, type ActionResult, AnimatedBox, type ApprovalConfig, type AuthOptions, type AuthResolver, type AuthResult, type AuthUser, Badge, type BadgeProps, Blueprint, type BlueprintAction, type BlueprintConfig, type BlueprintConfigSchema, type BlueprintDependency, type BlueprintManifest, type BlueprintRoute, type BlueprintServerActionDeclaration, type BlueprintSlotContribution, type BlueprintViewDeclaration, BrowserPlayer, type BrowserPlayerConfig, type TransitionResult as BrowserTransitionResult, Button, type ButtonProps, type CRUDConfig, Canvas3D, Card, type CardProps, type CedarPolicy, type ChannelHandle, type ChannelMessage, type ChannelOptions, type ChannelTransport, Chart, type CollectionHandle, Column, type ColumnProps, type ComputedFieldMode, type ComputedFieldResult, type CronFields, type CrudConfig, DataGrid, type DataSource, type DataSourceResult, Divider, type DividerProps, type DmnRule, type DomainEvent, type DomainSubscriptionConfig, type DomainSubscriptionTransport, type DuringAction, type DuringActionConfig, Each, type EachProps, type EscalationConfig, type EventPayload, type EventSubscription, type ExperienceViewConfig, ExperienceWorkflowBridge, type ExperienceWorkflowBridgeProps, type ExperienceWorkflowDefinition, type ExpressionLibraryRecord, type ExpressionLibraryResolver, type ExpressionLibraryResult, Field, FieldBuilder, type FieldRegistration, type FieldTypeMap, type FieldValidation, type FieldValidator, type FormConfig, type FormHandle, type FormValidator, type GeoPosition, type GeolocationError, type GeolocationOptions, type GeolocationResult, type GrammarIsland, Grid, Heading, type HeadingProps, Icon, Image, type InferFieldNames, type InferFields, type InferSlug, type InferStates, type InferTransitions, type InstalledModuleRef, type InstanceData, type InstanceKeyParams, type InstanceRef, type LatLng, type LatLngBounds, type LibraryParam, Link, type LocalDataResolver, type LocalEngineAdapter, type LocalEngineContextValue, LocalEngineProvider, type LocalEngineStore, LocalWorkflowEngine, type LoginCredentials, type MapMarker, type MapViewHandle, type MapViewOptions, Markdown, MetricCard, type MiddlewareContext, type MiddlewareFn, type MiddlewareHandle, type MiddlewareOptions, type MiddlewareResult, type MmWasmModule, Modal, ModelBuilder, type ModelDefinition, type ModelHandle, type ModelMixin, type ModelTestContext, type ModuleAction, type ModuleConfigSchema, type ModuleDependency, type ModuleHandle, type ModuleManifest, type ModuleRoute, type ModuleRouteConfig, type MutationHandle, type MutationResolver, NavLink, type NotificationResult, type NotifyOptions, type PackageChild, type PackageManifest, type PackageResult, type PipelineConfig, type PipelineStage, type PlayerConfig, type PlayerEvent, type PlayerEventCallback, type PlayerEventListener, type PlayerHandle, type PlayerInstance, type PlayerLogEntry, PlayerProvider, type PlayerProviderProps, type QueryParams$1 as QueryParams, type QueryResolver, type QueryResult, type RealtimeQueryParams, type RealtimeQueryResult, type ReviewConfig, type RoleDefinition, RoleGuard, type RoleOptions, type RoleResult, Route, type RouteDefinition, type RouteGuard, type RouteLocation, type RouteParamsOptions, Router, type RouterHandle, type RouterOptions, Row, type RowProps, type RuntimeConfig, RuntimeContext, type RuntimeSnapshot, ScrollArea, Section, Select, type ServerActionFn, type ServerActionHandle, type ServerActionOptions, type ServerActionResolver, type ServerActionResult, ServerGrid, type ServerStateOptions, type ServerStateResolver, type ServerStateResult, type ServerStateSnapshot, type SetupWizard, type SetupWizardStep, Show, type ShowProps, Slot, type SlotContribution, type SlotContributions, type SlotProps, Spacer, type SpawnActionOptions, type SpawnOptions, Stack, type StackProps, StateBuilder, type StateDescriptor, type StateHome, type Subscription, Tabs, type TestChain, type TestStep, Text, TextInput, type TextInputProps, type TextProps, type ToastConfig, type ToastHandle, type ToastInstance, type ToastVariant, TransitionBuilder, type TransitionCondition, type TransitionConfig, type TransitionContext, type TransitionDescriptor, type TransitionHandle, type TypedMutationHandle, TypedTransitionBuilder, type UseCollectionOptions, type UseComputedOptions, type UseModelOptions, type UseModuleOptions, type UseOnEventOptions, type UseWorkflowOptions, type ValidationIssue, type ValidationResult, type ValidationRule, type ViewDefinitionResult, type ViewRecord, type ViewResolver, type WithAuditTrailOptions, type WithOwnershipOptions, type WithRBACOptions, type WithSearchOptions, type WithSlugOptions, type WithSoftDeleteOptions, type WithVersioningOptions, type WorkflowDataSource, type WorkflowDefinition, type WorkflowEvent, type WorkflowEventHandler, type WorkflowFieldDef, type WorkflowFieldDescriptor, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceWithEvents, WorkflowProvider, type WorkflowProviderProps, WorkflowRuntime, type WorkflowState, type WorkflowTransition, action, and, applyMixins, approval, assertModelValid, cedar, connector, createActions, createCRUD, createLocalDataResolver, createLocalEngineAdapter, createPipeline, cron, crud, defineBlueprint, defineModel, defineModule, defineWorkspace, deriveInstanceKey, deriveInstanceKeySync, describeModel, deviceAction, dmn, escalation, expr, field, fieldContains, fieldEquals, fieldGreaterThan, fieldIn, fieldIsEmpty, fieldIsSet, fieldLessThan, fieldMatches, fieldNotEquals, fieldNotIn, getInstalledModule, getInstalledModules, graphql, hasAnyRole, hasRole, inState, inputEquals, inputRequired, isActor, isCreator, isOwner, isPlayerDebug, isSender, jsonpath, llm, loadExperienceWorkflow, logEvent, model, normalizeDefinition, not, notInState, notify, or, pipe, playerLog, prefetchData, refHasAnyRole, refHasRole, requireAuth, requireRole, review, serverAction, setAuthResolver, setChannelTransport, setExpressionLibraryResolver, setField, setFields, setInstalledModules, setModuleConfigDefaults, setMutationResolver, setPlayerDebug, setQueryResolver, setRealtimeQueryResolver, setRoleHierarchy, setServerActionResolver, setServerStateResolver, setViewResolver, spawn, sql, state, testModel, transition, useAuth, useChannel, useCollection, useComputed, useComputedWithMeta, useDomainSubscription, useDuringAction, useExperienceState, useExpressionLibrary, useForm, useGeolocation, useLocalEngine, useMapView, useMiddleware, useModel, useModule, useModuleConfig, useMutation, useNotification, useOnChange, useOnEnter, useOnEvent, useOnExit, useOnTransition, usePackage, useParams, usePlayer, usePlayerContext, usePlayerContextSafe, useQuery, useRealtimeQuery, useRole, useRouteParams, useRouter, useRuntimeContext, useServerAction, useServerState, useStateField, useToast, useTransition, useView, useWhileIn, useWorkflow, useState as useWorkflowState, validateExperienceWorkflow, validateModel, when, withAuditTrail, withOwnership, withPagination, withRBAC, withSearch, withSlug, withSoftDelete, withTags, withTimestamps, withVersioning };
+export { Accordion, type ActionContext, type ActionCreator, type ActionCreators, type ActionDefinition, type ActionEnvironment, type ActionHandler, type ActionManifest, type ActionManifestEntry, type ActionNotifyOptions, type ActionOptions, type ActionResult, AnimatedBox, type ApprovalConfig, type AuthOptions, type AuthResolver, type AuthResult, type AuthUser, Badge, type BadgeProps, Blueprint, type BlueprintAction, type BlueprintConfig, type BlueprintConfigSchema, type BlueprintDependency, type BlueprintManifest, type BlueprintRoute, type BlueprintServerActionDeclaration, type BlueprintSlotContribution, type BlueprintViewDeclaration, BrowserPlayer, type BrowserPlayerConfig, type TransitionResult as BrowserTransitionResult, Button, type ButtonProps, type CRUDConfig, Canvas3D, Card, type CardProps, type CedarPolicy, type ChannelHandle, type ChannelMessage, type ChannelOptions, type ChannelTransport, Chart, type CollectionHandle, Column, type ColumnProps, type ComputedFieldMode, type ComputedFieldResult, type CronFields, type CrudConfig, DataGrid, type DataSource, type DataSourceResult, Divider, type DividerProps, type DmnRule, type DomainEvent, type DomainSubscriptionConfig, type DomainSubscriptionTransport, type DuringAction, type DuringActionConfig, Each, type EachProps, type EscalationConfig, type EventPayload, type EventSubscription, type ExperienceViewConfig, ExperienceWorkflowBridge, type ExperienceWorkflowBridgeProps, type ExperienceWorkflowDefinition, type ExpressionLibraryRecord, type ExpressionLibraryResolver, type ExpressionLibraryResult, Field, FieldBuilder, type FieldRegistration, type FieldTypeMap, type FieldValidation, type FieldValidator, type FormConfig, type FormHandle, type FormValidator, type GeoPosition, type GeolocationError, type GeolocationOptions, type GeolocationResult, type GrammarIsland, Grid, Heading, type HeadingProps, Icon, Image, type InferFieldNames, type InferFields, type InferSlug, type InferStates, type InferTransitions, type InstalledModuleRef, type InstanceData, type InstanceKeyParams, type InstanceRef, type LatLng, type LatLngBounds, type LibraryParam, Link, type LocalDataResolver, type LocalEngineAdapter, type LocalEngineContextValue, LocalEngineProvider, type LocalEngineStore, LocalWorkflowEngine, type LoginCredentials, type MapMarker, type MapViewHandle, type MapViewOptions, Markdown, MetricCard, type MiddlewareContext, type MiddlewareFn, type MiddlewareHandle, type MiddlewareOptions, type MiddlewareResult, type MmWasmModule, Modal, ModelBuilder, type ModelDefinition, type ModelHandle, type ModelMixin, type ModelTestContext, type ModuleAction, type ModuleConfigSchema, type ModuleDependency, type ModuleHandle, type ModuleManifest, type ModuleRoute, type ModuleRouteConfig, type MutationHandle, type MutationResolver, NavLink, type NotificationResult, type NotifyOptions, type PackageChild, type PackageManifest, type PackageResult, type PipelineConfig, type PipelineStage, type PlayerConfig, type PlayerEvent, type PlayerEventCallback, type PlayerEventListener, type PlayerHandle, type PlayerInstance, type PlayerLogEntry, PlayerProvider, type PlayerProviderProps, type QueryParams$1 as QueryParams, type QueryResolver, type QueryResult, type RealtimeQueryParams, type RealtimeQueryResult, type ReviewConfig, type RoleDefinition, RoleGuard, type RoleOptions, type RoleResult, Route, type RouteDefinition, type RouteGuard, type RouteLocation, type RouteParamsOptions, Router, type RouterHandle, type RouterOptions, Row, type RowProps, type RuntimeConfig, RuntimeContext, type RuntimeSnapshot, ScrollArea, Section, Select, type ServerActionFn, type ServerActionHandle, type ServerActionOptions, type ServerActionResolver, type ServerActionResult, ServerGrid, type ServerStateOptions, type ServerStateResolver, type ServerStateResult, type ServerStateSnapshot, type SetupWizard, type SetupWizardStep, Show, type ShowProps, Slot, type SlotContribution, type SlotContributions, type SlotProps, Spacer, type SpawnActionOptions, type SpawnOptions, Stack, type StackProps, StateBuilder, type StateDescriptor, type StateHome, type Subscription, Tabs, type TestChain, type TestStep, Text, TextInput, type TextInputProps, type TextProps, type ToastConfig, type ToastHandle, type ToastInstance, type ToastVariant, TransitionBuilder, type TransitionCondition, type TransitionConfig, type TransitionContext, type TransitionDescriptor, type TransitionHandle, type TypedMutationHandle, TypedTransitionBuilder, type UseCollectionOptions, type UseComputedOptions, type UseModelOptions, type UseModuleOptions, type UseOnEventOptions, type UseWorkflowOptions, type ValidationIssue, type ValidationResult, type ValidationRule, type ViewDefinitionResult, type ViewRecord, type ViewResolver, type WithAuditTrailOptions, type WithOwnershipOptions, type WithRBACOptions, type WithSearchOptions, type WithSlugOptions, type WithSoftDeleteOptions, type WithVersioningOptions, type WorkflowDataSource, type WorkflowDefinition, type WorkflowEvent, type WorkflowEventHandler, type WorkflowFieldDef, type WorkflowFieldDescriptor, type WorkflowHandle, type WorkflowInstance, type WorkflowInstanceWithEvents, WorkflowProvider, type WorkflowProviderProps, WorkflowRuntime, type WorkflowState, type WorkflowTransition, action, and, applyMixins, approval, assertModelValid, cedar, connector, createActions, createCRUD, createLocalDataResolver, createLocalEngineAdapter, createPipeline, cron, crud, defineBlueprint, defineModel, defineModule, defineWorkspace, deriveInstanceKey, deriveInstanceKeySync, describeModel, deviceAction, dmn, escalation, expr, field, fieldContains, fieldEquals, fieldGreaterThan, fieldIn, fieldIsEmpty, fieldIsSet, fieldLessThan, fieldMatches, fieldNotEquals, fieldNotIn, getInstalledModule, getInstalledModules, graphql, hasAnyRole, hasRole, inState, inputEquals, inputRequired, isActor, isCreator, isOwner, isPlayerDebug, isSender, jsonpath, llm, loadExperienceWorkflow, logEvent, model, normalizeDefinition, not, notInState, notify, or, pipe, playerLog, prefetchData, refHasAnyRole, refHasRole, requireAuth, requireRole, review, serverAction, setAuthResolver, setChannelTransport, setConfigContext, setExpressionLibraryResolver, setField, setFields, setInstalledModules, setModuleConfigDefaults, setMutationResolver, setPersistedModuleConfig, setPlayerDebug, setQueryResolver, setRealtimeQueryResolver, setRoleHierarchy, setServerActionResolver, setServerStateResolver, setViewResolver, spawn, sql, state, syncConfigDefaults, testModel, transition, updateDefinitionConfig, useAuth, useChannel, useCollection, useComputed, useComputedWithMeta, useDomainSubscription, useDuringAction, useExperienceState, useExpressionLibrary, useForm, useGeolocation, useLocalEngine, useMapView, useMiddleware, useModel, useModule, useModuleConfig, useModuleConfigWithMutation, useMutation, useNotification, useOnChange, useOnEnter, useOnEvent, useOnExit, useOnTransition, usePackage, useParams, usePlayer, usePlayerContext, usePlayerContextSafe, useQuery, useRealtimeQuery, useRole, useRouteParams, useRouter, useRuntimeContext, useServerAction, useServerState, useStateField, useToast, useTransition, useView, useWhileIn, useWorkflow, useState as useWorkflowState, validateExperienceWorkflow, validateModel, when, withAuditTrail, withOwnership, withPagination, withRBAC, withSearch, withSlug, withSoftDelete, withTags, withTimestamps, withVersioning };

package/dist/index.js

@@ -150,12 +150,14 @@ __export(index_exports, {
   serverAction: () => serverAction,
   setAuthResolver: () => setAuthResolver,
   setChannelTransport: () => setChannelTransport,
+  setConfigContext: () => setConfigContext,
   setExpressionLibraryResolver: () => setExpressionLibraryResolver,
   setField: () => setField,
   setFields: () => setFields,
   setInstalledModules: () => setInstalledModules,
   setModuleConfigDefaults: () => setModuleConfigDefaults,
   setMutationResolver: () => setMutationResolver,
+  setPersistedModuleConfig: () => setPersistedModuleConfig,
   setPlayerDebug: () => setPlayerDebug,
   setQueryResolver: () => setQueryResolver,
   setRealtimeQueryResolver: () => setRealtimeQueryResolver,
@@ -166,8 +168,10 @@ __export(index_exports, {
   spawn: () => spawn,
   sql: () => sql,
   state: () => state,
+  syncConfigDefaults: () => syncConfigDefaults,
   testModel: () => testModel,
   transition: () => transition,
+  updateDefinitionConfig: () => updateDefinitionConfig,
   useAuth: () => useAuth,
   useChannel: () => useChannel,
   useCollection: () => useCollection,
@@ -185,6 +189,7 @@ __export(index_exports, {
   useModel: () => useModel,
   useModule: () => useModule,
   useModuleConfig: () => useModuleConfig,
+  useModuleConfigWithMutation: () => useModuleConfigWithMutation,
   useMutation: () => useMutation,
   useNotification: () => useNotification,
   useOnChange: () => useOnChange,
@@ -1286,8 +1291,8 @@ var ActionDispatcher = class {
       }
       const handler = this.handlers.get(action2.type);
       if (!handler) {
-        console.warn(`[player-core] No handler registered for action type "${action2.type}"`);
-        results.push({ type: action2.type, success: false, error: `No handler for "${action2.type}"` });
+        console.warn(`[player-core] No handler registered for action type "${action2.type}" \u2014 unsupported action`);
+        results.push({ type: action2.type, success: false, error: `unsupported action: "${action2.type}"` });
         continue;
       }
       try {
@@ -1305,6 +1310,10 @@ var ActionDispatcher = class {
   get size() {
     return this.handlers.size;
   }
+  /** Get all registered action type names */
+  getRegisteredTypes() {
+    return Array.from(this.handlers.keys());
+  }
   /** Remove all handlers */
   clear() {
     this.handlers.clear();
@@ -4745,9 +4754,62 @@ function useModuleConfig(moduleSlug) {
   return (0, import_react34.useMemo)(() => {
     const installed = getInstalledModule(moduleSlug);
     const defaults = configDefaultsStore.get(moduleSlug) ?? {};
-    return { ...defaults, ...installed?.config };
+    const persisted = persistedConfigStore.get(moduleSlug) ?? {};
+    return { ...defaults, ...persisted, ...installed?.config };
   }, [moduleSlug]);
 }
+var persistedConfigStore = /* @__PURE__ */ new Map();
+function setPersistedModuleConfig(moduleSlug, config) {
+  persistedConfigStore.set(moduleSlug, config);
+}
+async function syncConfigDefaults(moduleSlug, defaults, definitionId) {
+  const id = definitionId ?? activeDefinitionIdStore;
+  if (!id) return;
+  try {
+    const moduleKey = `module_config.${moduleSlug}`;
+    await updateDefinitionConfig({ [moduleKey]: defaults }, id);
+    persistedConfigStore.set(moduleSlug, defaults);
+  } catch (e) {
+    console.warn(`[useModuleConfig] Failed to sync config for ${moduleSlug}:`, e);
+  }
+}
+var activeDefinitionIdStore = null;
+var apiBaseUrlStore = "/api/v1/workflow";
+function setConfigContext(definitionId, apiBaseUrl) {
+  activeDefinitionIdStore = definitionId;
+  if (apiBaseUrl) apiBaseUrlStore = apiBaseUrl;
+}
+async function updateDefinitionConfig(values, definitionId) {
+  const id = definitionId ?? activeDefinitionIdStore;
+  if (!id) throw new Error("No active definition ID. Call setConfigContext() first.");
+  const token = typeof localStorage !== "undefined" ? localStorage.getItem("auth_token") : null;
+  const response = await fetch(`${apiBaseUrlStore}/definitions/${id}/config`, {
+    method: "PATCH",
+    headers: {
+      "Content-Type": "application/json",
+      ...token ? { Authorization: `Bearer ${token}` } : {}
+    },
+    body: JSON.stringify(values)
+  });
+  if (!response.ok) {
+    const err = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(err.message || `Failed to update config: ${response.status}`);
+  }
+  return response.json();
+}
+function useModuleConfigWithMutation(moduleSlug) {
+  const config = useModuleConfig(moduleSlug);
+  const [isSaving, setIsSaving] = (0, import_react34.useState)(false);
+  const updateConfig = (0, import_react34.useCallback)(async (values) => {
+    setIsSaving(true);
+    try {
+      return await updateDefinitionConfig(values);
+    } finally {
+      setIsSaving(false);
+    }
+  }, []);
+  return { config, updateConfig, isSaving };
+}
 
 // src/builders.ts
 function handlerToAction(handler, qualifier) {
@@ -8169,12 +8231,14 @@ var BrowserPlayer = class {
   serverAction,
   setAuthResolver,
   setChannelTransport,
+  setConfigContext,
   setExpressionLibraryResolver,
   setField,
   setFields,
   setInstalledModules,
   setModuleConfigDefaults,
   setMutationResolver,
+  setPersistedModuleConfig,
   setPlayerDebug,
   setQueryResolver,
   setRealtimeQueryResolver,
@@ -8185,8 +8249,10 @@ var BrowserPlayer = class {
   spawn,
   sql,
   state,
+  syncConfigDefaults,
   testModel,
   transition,
+  updateDefinitionConfig,
   useAuth,
   useChannel,
   useCollection,
@@ -8204,6 +8270,7 @@ var BrowserPlayer = class {
   useModel,
   useModule,
   useModuleConfig,
+  useModuleConfigWithMutation,
   useMutation,
   useNotification,
   useOnChange,

package/dist/index.mjs

@@ -1056,8 +1056,8 @@ var ActionDispatcher = class {
       }
       const handler = this.handlers.get(action2.type);
       if (!handler) {
-        console.warn(`[player-core] No handler registered for action type "${action2.type}"`);
-        results.push({ type: action2.type, success: false, error: `No handler for "${action2.type}"` });
+        console.warn(`[player-core] No handler registered for action type "${action2.type}" \u2014 unsupported action`);
+        results.push({ type: action2.type, success: false, error: `unsupported action: "${action2.type}"` });
         continue;
       }
       try {
@@ -1075,6 +1075,10 @@ var ActionDispatcher = class {
   get size() {
     return this.handlers.size;
   }
+  /** Get all registered action type names */
+  getRegisteredTypes() {
+    return Array.from(this.handlers.keys());
+  }
   /** Remove all handlers */
   clear() {
     this.handlers.clear();
@@ -4496,7 +4500,7 @@ function useModule(slug, config = {}, options = {}) {
 }
 
 // src/hooks/useModuleConfig.ts
-import { useMemo as useMemo17 } from "react";
+import { useCallback as useCallback20, useMemo as useMemo17, useState as useState21 } from "react";
 var installedModulesStore = [];
 var configDefaultsStore = /* @__PURE__ */ new Map();
 function setInstalledModules(modules) {
@@ -4515,9 +4519,62 @@ function useModuleConfig(moduleSlug) {
   return useMemo17(() => {
     const installed = getInstalledModule(moduleSlug);
     const defaults = configDefaultsStore.get(moduleSlug) ?? {};
-    return { ...defaults, ...installed?.config };
+    const persisted = persistedConfigStore.get(moduleSlug) ?? {};
+    return { ...defaults, ...persisted, ...installed?.config };
   }, [moduleSlug]);
 }
+var persistedConfigStore = /* @__PURE__ */ new Map();
+function setPersistedModuleConfig(moduleSlug, config) {
+  persistedConfigStore.set(moduleSlug, config);
+}
+async function syncConfigDefaults(moduleSlug, defaults, definitionId) {
+  const id = definitionId ?? activeDefinitionIdStore;
+  if (!id) return;
+  try {
+    const moduleKey = `module_config.${moduleSlug}`;
+    await updateDefinitionConfig({ [moduleKey]: defaults }, id);
+    persistedConfigStore.set(moduleSlug, defaults);
+  } catch (e) {
+    console.warn(`[useModuleConfig] Failed to sync config for ${moduleSlug}:`, e);
+  }
+}
+var activeDefinitionIdStore = null;
+var apiBaseUrlStore = "/api/v1/workflow";
+function setConfigContext(definitionId, apiBaseUrl) {
+  activeDefinitionIdStore = definitionId;
+  if (apiBaseUrl) apiBaseUrlStore = apiBaseUrl;
+}
+async function updateDefinitionConfig(values, definitionId) {
+  const id = definitionId ?? activeDefinitionIdStore;
+  if (!id) throw new Error("No active definition ID. Call setConfigContext() first.");
+  const token = typeof localStorage !== "undefined" ? localStorage.getItem("auth_token") : null;
+  const response = await fetch(`${apiBaseUrlStore}/definitions/${id}/config`, {
+    method: "PATCH",
+    headers: {
+      "Content-Type": "application/json",
+      ...token ? { Authorization: `Bearer ${token}` } : {}
+    },
+    body: JSON.stringify(values)
+  });
+  if (!response.ok) {
+    const err = await response.json().catch(() => ({ message: response.statusText }));
+    throw new Error(err.message || `Failed to update config: ${response.status}`);
+  }
+  return response.json();
+}
+function useModuleConfigWithMutation(moduleSlug) {
+  const config = useModuleConfig(moduleSlug);
+  const [isSaving, setIsSaving] = useState21(false);
+  const updateConfig = useCallback20(async (values) => {
+    setIsSaving(true);
+    try {
+      return await updateDefinitionConfig(values);
+    } finally {
+      setIsSaving(false);
+    }
+  }, []);
+  return { config, updateConfig, isSaving };
+}
 
 // src/builders.ts
 function handlerToAction(handler, qualifier) {
@@ -6711,7 +6768,7 @@ function describeModel(def) {
 }
 
 // src/hooks/usePlayer.ts
-import { useCallback as useCallback20, useEffect as useEffect21, useMemo as useMemo18, useRef as useRef24, useState as useState21 } from "react";
+import { useCallback as useCallback21, useEffect as useEffect21, useMemo as useMemo18, useRef as useRef24, useState as useState22 } from "react";
 
 // src/logger.ts
 var debugEnabled = false;
@@ -6816,7 +6873,7 @@ function usePlayer(config) {
     return { sm: sm2, eventBus: eventBus2, dispatcher };
   }, [config.definition.id, evaluator]);
   const { sm, eventBus } = engine;
-  const [playerState, setPlayerState] = useState21(() => computePlayerState(sm));
+  const [playerState, setPlayerState] = useState22(() => computePlayerState(sm));
   useEffect21(() => {
     const stateDef = sm.getCurrentStateDefinition();
     if (!stateDef?.on_event?.length) return;
@@ -6897,7 +6954,7 @@ function usePlayer(config) {
     });
     return unsub;
   }, [sm]);
-  const transition2 = useCallback20(
+  const transition2 = useCallback21(
     async (name, data) => {
       playerLog({
         level: "info",
@@ -6924,20 +6981,20 @@ function usePlayer(config) {
     },
     [sm]
   );
-  const setField2 = useCallback20(
+  const setField2 = useCallback21(
     (field2, value) => {
       sm.setField(field2, value);
       setPlayerState(computePlayerState(sm));
     },
     [sm]
   );
-  const setMemory = useCallback20(
+  const setMemory = useCallback21(
     (key, value) => {
       sm.setMemory(key, value);
     },
     [sm]
   );
-  const publishEvent = useCallback20(
+  const publishEvent = useCallback21(
     (topic, payload) => {
       playerLog({
         level: "debug",
@@ -7020,11 +7077,11 @@ function useDomainSubscription(eventBus, transport, config) {
 }
 
 // src/hooks/useExperienceState.ts
-import { useCallback as useCallback21, useRef as useRef26 } from "react";
+import { useCallback as useCallback22, useRef as useRef26 } from "react";
 function useExperienceState(player, selector) {
   const selectorRef = useRef26(selector);
   selectorRef.current = selector;
-  const getSnapshot = useCallback21(() => {
+  const getSnapshot = useCallback22(() => {
     return selectorRef.current({
       currentState: player.currentState,
       stateData: player.stateData,
@@ -7938,12 +7995,14 @@ export {
   serverAction,
   setAuthResolver,
   setChannelTransport,
+  setConfigContext,
   setExpressionLibraryResolver,
   setField,
   setFields,
   setInstalledModules,
   setModuleConfigDefaults,
   setMutationResolver,
+  setPersistedModuleConfig,
   setPlayerDebug,
   setQueryResolver,
   setRealtimeQueryResolver,
@@ -7954,8 +8013,10 @@ export {
   spawn,
   sql,
   state,
+  syncConfigDefaults,
   testModel,
   transition,
+  updateDefinitionConfig,
   useAuth,
   useChannel,
   useCollection,
@@ -7973,6 +8034,7 @@ export {
   useModel,
   useModule,
   useModuleConfig,
+  useModuleConfigWithMutation,
   useMutation,
   useNotification,
   useOnChange,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmapp/react",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "React integration for the MindMatrix Player — hooks, components, and WebSocket bridge for browser-side workflow engines",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -22,14 +22,15 @@
     "dev": "tsup src/index.ts --format cjs,esm --dts --external react --watch",
     "test": "vitest run",
     "test:watch": "vitest --watch",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "publish:alpha": "cd ../.. && ./scripts/publish-npm.sh"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
     "@tanstack/react-query": ">=5.0.0"
   },
   "dependencies": {
-    "@mmapp/player-core": "^0.1.0-alpha.1"
+    "@mmapp/player-core": "^0.1.0-alpha.3"
   },
   "publishConfig": {
     "access": "public"

package/package.json.backup

@@ -1,41 +0,0 @@
-{
-  "name": "@mindmatrix/react",
-  "version": "0.1.0",
-  "description": "React integration for the MindMatrix Player — hooks, components, and WebSocket bridge for browser-side workflow engines",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    },
-    "./atoms": {
-      "types": "./dist/atoms/index.d.ts",
-      "import": "./dist/atoms/index.mjs",
-      "require": "./dist/atoms/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --external react",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --external react --watch",
-    "test": "vitest run",
-    "test:watch": "vitest --watch",
-    "type-check": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "react": ">=18.0.0",
-    "@tanstack/react-query": ">=5.0.0"
-  },
-  "dependencies": {
-    "@mindmatrix/player-core": "workspace:*"
-  },
-  "devDependencies": {
-    "@types/react": "^19.0.0",
-    "react": "^19.0.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.4.0",
-    "vitest": "^1.5.0"
-  }
-}