@wirestate/react 0.6.2 → 0.7.0-experimental.1

package/esm/development/commands/use-optional-command-caller.js

@@ -1,12 +1,28 @@
 import { CommandBus } from '@wirestate/core';
 import { useCallback } from 'react';
-import { useContainer } from '../provision/use-container.js';
+import { useContainer } from '../context/use-container.js';
 
 /**
- * Returns a function to dispatch optional commands on the active container.
- * Returns null instead of throwing when no handler is registered.
+ * Returns a stable function to dispatch optional commands on the active container.
  *
- * @returns optional command dispatcher
+ * @remarks
+ * Similar to {@link useCommandCaller}, but returns `null` instead of throwing
+ * {WirestateError} if no handler is registered for the command type.
+ * Uses {@link CommandBus.commandOptional} internally.
+ *
+ * @group Commands
+ *
+ * @returns An optional command dispatcher function.
+ *
+ * @example
+ * ```tsx
+ * const callOptional: OptionalCommandCaller = useOptionalCommandCaller();
+ * const descriptor: CommandDescriptor<string> | null = callOptional("OPTIONAL_COMMAND", data);
+ *
+ * if (descriptor) {
+ *   const result: string = await descriptor.task;
+ * }
+ * ```
  */
 function useOptionalCommandCaller() {
   var container = useContainer();

package/esm/development/commands/use-optional-command-caller.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-optional-command-caller.js","sources":["../../../../../../../../src/wirestate-react/commands/use-optional-command-caller.ts"],"sourcesContent":[null],"names":["useOptionalCommandCaller","container","useContainer","useCallback","type","data","get","CommandBus","commandOptional"],"mappings":";;;;AAQA;;;;;AAKG;SACaA,wBAAwBA,GAAA;AACtC,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;AAE3C,EAAA,OAAOC,WAAW,CAChB,UAAgEC,IAAO,EAAEC,IAAQ,EAAA;AAM/E,IAAA,OAAOJ,SAAS,CAACK,GAAG,CAACC,UAAU,CAAC,CAACC,eAAe,CAAOJ,IAAI,EAAEC,IAAI,CAAC;AACpE,EAAA,CAAC,EACD,CAACJ,SAAS,CAAC,CACZ;AACH;;;;"}
+{"version":3,"file":"use-optional-command-caller.js","sources":["../../../../../../../../src/wirestate-react/commands/use-optional-command-caller.ts"],"sourcesContent":[null],"names":["useOptionalCommandCaller","container","useContainer","useCallback","type","data","get","CommandBus","commandOptional"],"mappings":";;;;AASA;;;;;;;;;;;;;;;;;;;;;AAqBG;SACaA,wBAAwBA,GAAA;AACtC,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;AAE3C,EAAA,OAAOC,WAAW,CAChB,UAAgEC,IAAO,EAAEC,IAAQ,EAAA;AAM/E,IAAA,OAAOJ,SAAS,CAACK,GAAG,CAACC,UAAU,CAAC,CAACC,eAAe,CAAOJ,IAAI,EAAEC,IAAI,CAAC;AACpE,EAAA,CAAC,EACD,CAACJ,SAAS,CAAC,CACZ;AACH;;;;"}

package/esm/development/context/container-context.js

@@ -0,0 +1,16 @@
+import { createContext } from 'react';
+
+/**
+ * React context carrying the container.
+ *
+ * @remarks
+ * This context is internal to Wirestate. Consumers should use provided hooks
+ * like {@link useContainer}, {@link useInjection} or {@link useScope} to access the container and resolved services.
+ *
+ * @group Context
+ */
+var ContainerReactContext = createContext(null);
+ContainerReactContext.displayName = "ContainerContext";
+
+export { ContainerReactContext };
+//# sourceMappingURL=container-context.js.map

package/esm/development/context/container-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-context.js","sources":["../../../../../../../../src/wirestate-react/context/container-context.ts"],"sourcesContent":[null],"names":["ContainerReactContext","createContext","displayName"],"mappings":";;AAKA;;;;;;;;AAQG;IACUA,qBAAqB,GAAiCC,aAAa,CAAsB,IAAI;AAE1GD,qBAAqB,CAACE,WAAW,GAAG,kBAAkB;;;;"}

package/esm/development/context/use-container.js

@@ -0,0 +1,33 @@
+import { WirestateError } from '@wirestate/core';
+import { useContext } from 'react';
+import { ERROR_CODE_INVALID_CONTEXT } from '../error/error-code.js';
+import { ContainerReactContext } from './container-context.js';
+
+/**
+ * Returns the active container from the context.
+ *
+ * @remarks
+ * Use this hook when you need direct access to the {@link Container} for manual
+ * resolution or checking bindings. For typical service usage, prefer
+ * {@link useInjection}.
+ *
+ * @group Context
+ *
+ * @returns The active container.
+ *
+ * @example
+ * ```tsx
+ * const container: Container = useContainer();
+ * const isBound: boolean = container.isBound(MyToken);
+ * ```
+ */
+function useContainer() {
+  var value = useContext(ContainerReactContext);
+  if (!value) {
+    throw new WirestateError(ERROR_CODE_INVALID_CONTEXT, "Trying to access container context from React subtree not wrapped in <ContainerProvider>.");
+  }
+  return value;
+}
+
+export { useContainer };
+//# sourceMappingURL=use-container.js.map

package/esm/development/context/use-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-container.js","sources":["../../../../../../../../src/wirestate-react/context/use-container.ts"],"sourcesContent":[null],"names":["useContainer","value","useContext","ContainerReactContext","WirestateError","ERROR_CODE_INVALID_CONTEXT"],"mappings":";;;;;AAQA;;;;;;;;;;;;;;;;;AAiBG;SACaA,YAAYA,GAAA;AAC1B,EAAA,IAAMC,KAAK,GAAwBC,UAAU,CAACC,qBAAqB,CAAC;EAEpE,IAAI,CAACF,KAAK,EAAE;AACV,IAAA,MAAM,IAAIG,cAAc,CACtBC,0BAA0B,EAC1B,2FAA2F,CAC5F;AACH,EAAA;AAEA,EAAA,OAAOJ,KAAK;AACd;;;;"}

package/esm/development/context/use-root-container.js

@@ -0,0 +1,35 @@
+import { useMemo } from 'react';
+
+/**
+ * Creates and memoizes a root container for a component.
+ *
+ * @remarks
+ * The `factory` function re-runs only when one of `deps` changes.
+ * Between such changes, the same container instance is returned.
+ *
+ * @group Context
+ *
+ * @param factory - Lazily creates the root container.
+ * @param deps - Dependency list controlling when container is recreated.
+ * @returns The memoized root container instance.
+ *
+ * @example
+ * ```tsx
+ * const container: Container = useRootContainer(
+ *   () =>
+ *     createIocContainer({
+ *       entries: [CounterService, LoggerService],
+ *     }),
+ *   []
+ * );
+ * ```
+ */
+function useRootContainer(factory, deps) {
+  return useMemo(function () {
+    var container = factory();
+    return container;
+  }, deps);
+}
+
+export { useRootContainer };
+//# sourceMappingURL=use-root-container.js.map

package/esm/development/context/use-root-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-root-container.js","sources":["../../../../../../../../src/wirestate-react/context/use-root-container.ts"],"sourcesContent":[null],"names":["useRootContainer","factory","deps","useMemo","container"],"mappings":";;AAMA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAUA,gBAAgBA,CAACC,OAAwB,EAAEC,IAAoB,EAAA;EAC7E,OAAOC,OAAO,CAAC,YAAA;AACb,IAAA,IAAMC,SAAS,GAAcH,OAAO,EAAE;AAItC,IAAA,OAAOG,SAAS;EAClB,CAAC,EAAEF,IAAI,CAAC;AACV;;;;"}

package/esm/development/context/use-scope.js

@@ -0,0 +1,31 @@
+import { WireScope } from '@wirestate/core';
+import { useMemo } from 'react';
+import { useContainer } from './use-container.js';
+
+/**
+ * Returns a {@link WireScope} instance bound to the active container.
+ *
+ * @remarks
+ * The scope is recreated if the container changes. It provides a convenient
+ * way to access container features like events, commands, and queries.
+ *
+ * @group Context
+ *
+ * @returns A {@link WireScope} instance.
+ *
+ * @example
+ * ```tsx
+ * const scope: WireScope = useScope();
+ *
+ * scope.emitEvent("UI_READY");
+ * ```
+ */
+function useScope() {
+  var container = useContainer();
+  return useMemo(function () {
+    return container.get(WireScope);
+  }, [container]);
+}
+
+export { useScope };
+//# sourceMappingURL=use-scope.js.map

package/esm/development/context/use-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-scope.js","sources":["../../../../../../../../src/wirestate-react/context/use-scope.ts"],"sourcesContent":[null],"names":["useScope","container","useContainer","useMemo","get","WireScope"],"mappings":";;;;AAQA;;;;;;;;;;;;;;;;;AAiBG;SACaA,QAAQA,GAAA;AACtB,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;EAE3C,OAAOC,OAAO,CAAC,YAAA;AAKb,IAAA,OAAOF,SAAS,CAACG,GAAG,CAAYC,SAAS,CAAC;AAC5C,EAAA,CAAC,EAAE,CAACJ,SAAS,CAAC,CAAC;AACjB;;;;"}

package/esm/development/error/error-code.js

@@ -1,6 +1,4 @@
-var ERROR_CODE_VALIDATION_ERROR = 1050;
 var ERROR_CODE_INVALID_CONTEXT = 1052;
-var ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER = 1101;
 
-export { ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER, ERROR_CODE_INVALID_CONTEXT, ERROR_CODE_VALIDATION_ERROR };
+export { ERROR_CODE_INVALID_CONTEXT };
 //# sourceMappingURL=error-code.js.map

package/esm/development/error/error-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-code.js","sources":["../../../../../../../../src/wirestate-react/error/error-code.ts"],"sourcesContent":[null],"names":["ERROR_CODE_VALIDATION_ERROR","ERROR_CODE_INVALID_CONTEXT","ERROR_CODE_FAILED_TO_RESOLVE_QUERY_HANDLER"],"mappings":"AAAO,IAAMA,2BAA2B,GAAW;AAC5C,IAAMC,0BAA0B,GAAW;AAE3C,IAAMC,0CAA0C,GAAW;;;;"}
+{"version":3,"file":"error-code.js","sources":["../../../../../../../../src/wirestate-react/error/error-code.ts"],"sourcesContent":[null],"names":["ERROR_CODE_INVALID_CONTEXT"],"mappings":"AACO,IAAMA,0BAA0B,GAAW;;;;"}

package/esm/development/events/use-event-emitter.js

@@ -1,14 +1,30 @@
 import { EventBus } from '@wirestate/core';
 import { useCallback } from 'react';
-import { useIocContext } from '../provision/use-ioc-context.js';
+import { useContainer } from '../context/use-container.js';
 
 /**
- * Returns a stable function to emit events.
+ * Returns a stable function to emit events via the {@link EventBus}.
  *
- * @returns event emitter
+ * @remarks
+ * The returned emitter is memoized using `useCallback` and stays stable
+ * for the lifetime of the container.
+ *
+ * @group Events
+ *
+ * @template P - Default payload type for emitted events.
+ * @template T - Default event identifier type.
+ *
+ * @returns An event emitter function.
+ *
+ * @example
+ * ```tsx
+ * const emit: EventEmitter = useEventEmitter();
+ *
+ * const onClick = () => emit("BUTTON_CLICKED", { id: "submit" });
+ * ```
  */
 function useEventEmitter() {
-  var container = useIocContext().container;
+  var container = useContainer();
   return useCallback(function (type, payload, from) {
     container.get(EventBus).emit({
       type: type,

package/esm/development/events/use-event-emitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-event-emitter.js","sources":["../../../../../../../../src/wirestate-react/events/use-event-emitter.ts"],"sourcesContent":[null],"names":["useEventEmitter","container","useIocContext","useCallback","type","payload","from","get","EventBus","emit"],"mappings":";;;;AASA;;;;AAIG;SACaA,eAAeA,GAAA;AAC7B,EAAA,IAAMC,SAAS,GAAcC,aAAa,EAAE,CAACD,SAAS;EAEtD,OAAOE,WAAW,CAChB,UAAyBC,IAAO,EAAEC,OAAW,EAAEC,IAAc,EAAA;AAO3DL,IAAAA,SAAS,CAACM,GAAG,CAACC,QAAQ,CAAC,CAACC,IAAI,CAAC;AAAEL,MAAAA,IAAI,EAAAA,IAAA;AAAEC,MAAAA,OAAO,EAAAA,OAAA;AAAEC,MAAAA,IAAI,EAAAA;AAAA,KAAE,CAAC;AACvD,EAAA,CAAC,EACD,CAACL,SAAS,CAAC,CACZ;AACH;;;;"}
+{"version":3,"file":"use-event-emitter.js","sources":["../../../../../../../../src/wirestate-react/events/use-event-emitter.ts"],"sourcesContent":[null],"names":["useEventEmitter","container","useContainer","useCallback","type","payload","from","get","EventBus","emit"],"mappings":";;;;AASA;;;;;;;;;;;;;;;;;;;;AAoBG;SACaA,eAAeA,GAAA;AAC7B,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;EAE3C,OAAOC,WAAW,CAChB,UAAyBC,IAAO,EAAEC,OAAW,EAAEC,IAAc,EAAA;AAO3DL,IAAAA,SAAS,CAACM,GAAG,CAACC,QAAQ,CAAC,CAACC,IAAI,CAAC;AAAEL,MAAAA,IAAI,EAAAA,IAAA;AAAEC,MAAAA,OAAO,EAAAA,OAAA;AAAEC,MAAAA,IAAI,EAAAA;AAAA,KAAE,CAAC;AACvD,EAAA,CAAC,EACD,CAACL,SAAS,CAAC,CACZ;AACH;;;;"}

package/esm/development/events/use-event.js

@@ -1,12 +1,26 @@
 import { EventBus } from '@wirestate/core';
 import { useRef, useEffect } from 'react';
-import { useContainer } from '../provision/use-container.js';
+import { useContainer } from '../context/use-container.js';
 
 /**
- * Subscribes a component to events.
+ * Subscribes a component to a specific event type on the {@link EventBus}.
  *
- * @param type - event type to listen to
- * @param handler - event handler to invoke when event is emitted
+ * @remarks
+ * The subscription is active for the component's lifetime and is automatically
+ * cleaned up on unmount. The handler is synced via `useRef` to avoid stale
+ * closures without requiring manual memoization of the handler function.
+ *
+ * @group Events
+ *
+ * @param type - Event type to listen for.
+ * @param handler - Function invoked when the specified event is emitted.
+ *
+ * @example
+ * ```tsx
+ * useEvent("USER_LOGGED_IN", (event) => {
+ *   console.log("User logged in:,", event);
+ * });
+ * ```
  */
 function useEvent(type, handler) {
   var typeRef = useRef(type);

package/esm/development/events/use-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-event.js","sources":["../../../../../../../../src/wirestate-react/events/use-event.ts"],"sourcesContent":[null],"names":["useEvent","type","handler","typeRef","useRef","handlerRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","_a","call"],"mappings":";;;;AAKA;;;;;AAKG;AACG,SAAUA,QAAQA,CAACC,IAAe,EAAEC,OAAqB,EAAA;AAC7D,EAAA,IAAMC,OAAO,GAAgCC,MAAM,CAACH,IAAI,CAAC;AACzD,EAAA,IAAMI,UAAU,GAAmCD,MAAM,CAACF,OAAO,CAAC;AAClE,EAAA,IAAMI,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRL,OAAO,CAACM,OAAO,GAAGR,IAAI;IACtBI,UAAU,CAACI,OAAO,GAAGP,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFM,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;AAC7C,MAAA,IAAIA,KAAK,CAACZ,IAAI,KAAKE,OAAO,CAACM,OAAO,EAAE;QAClC,CAAAK,EAAA,GAAAT,UAAU,CAACI,OAAO,MAAA,IAAA,IAAAK,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAV,UAAA,EAAGQ,KAAK,CAAC;AAC7B,MAAA;AACF,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,EAAEL,IAAI,CAAC,CAAC;AACvB;;;;"}
+{"version":3,"file":"use-event.js","sources":["../../../../../../../../src/wirestate-react/events/use-event.ts"],"sourcesContent":[null],"names":["useEvent","type","handler","typeRef","useRef","handlerRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","_a","call"],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAUA,QAAQA,CAACC,IAAe,EAAEC,OAAqB,EAAA;AAC7D,EAAA,IAAMC,OAAO,GAAgCC,MAAM,CAACH,IAAI,CAAC;AACzD,EAAA,IAAMI,UAAU,GAAmCD,MAAM,CAACF,OAAO,CAAC;AAClE,EAAA,IAAMI,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRL,OAAO,CAACM,OAAO,GAAGR,IAAI;IACtBI,UAAU,CAACI,OAAO,GAAGP,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFM,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;AAC7C,MAAA,IAAIA,KAAK,CAACZ,IAAI,KAAKE,OAAO,CAACM,OAAO,EAAE;QAClC,CAAAK,EAAA,GAAAT,UAAU,CAACI,OAAO,MAAA,IAAA,IAAAK,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAV,UAAA,EAAGQ,KAAK,CAAC;AAC7B,MAAA;AACF,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,EAAEL,IAAI,CAAC,CAAC;AACvB;;;;"}

package/esm/development/events/use-events-handler.js

@@ -1,11 +1,26 @@
 import { EventBus } from '@wirestate/core';
 import { useRef, useEffect } from 'react';
-import { useContainer } from '../provision/use-container.js';
+import { useContainer } from '../context/use-container.js';
 
 /**
- * Subscribes a component to all events without type filtering.
+ * Subscribes a component to all events on the {@link EventBus} without type filtering.
  *
- * @param handler - event handler invoked for every emitted event
+ * @remarks
+ * Useful for logging, debugging, or cross-cutting concerns that need to see
+ * every event passing through the bus.
+ * The handler is synced via `useRef` to avoid stale closures.
+ * The subscription is automatically cleaned up on unmount.
+ *
+ * @group Events
+ *
+ * @param handler - Event handler invoked for every emitted event.
+ *
+ * @example
+ * ```tsx
+ * useEventsHandler((event) => {
+ *   console.log('Event receieved:', event.type, event.payload);
+ * });
+ * ```
  */
 function useEventsHandler(handler) {
   var handlerRef = useRef(handler);

package/esm/development/events/use-events-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-events-handler.js","sources":["../../../../../../../../src/wirestate-react/events/use-events-handler.ts"],"sourcesContent":[null],"names":["useEventsHandler","handler","handlerRef","useRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","_a","call"],"mappings":";;;;AAMA;;;;AAIG;AACG,SAAUA,gBAAgBA,CAACC,OAAqB,EAAA;AACpD,EAAA,IAAMC,UAAU,GAA0CC,MAAM,CAACF,OAAO,CAAC;AACzE,EAAA,IAAMG,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRJ,UAAU,CAACK,OAAO,GAAGN,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFK,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;MAC7C,CAAAC,EAAA,GAAAV,UAAU,CAACK,OAAO,MAAA,IAAA,IAAAK,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAX,UAAA,EAAGS,KAAK,CAAC;AAC7B,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,CAAC,CAAC;AACjB;;;;"}
+{"version":3,"file":"use-events-handler.js","sources":["../../../../../../../../src/wirestate-react/events/use-events-handler.ts"],"sourcesContent":[null],"names":["useEventsHandler","handler","handlerRef","useRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","_a","call"],"mappings":";;;;AAMA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAUA,gBAAgBA,CAACC,OAAqB,EAAA;AACpD,EAAA,IAAMC,UAAU,GAA0CC,MAAM,CAACF,OAAO,CAAC;AACzE,EAAA,IAAMG,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRJ,UAAU,CAACK,OAAO,GAAGN,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFK,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;MAC7C,CAAAC,EAAA,GAAAV,UAAU,CAACK,OAAO,MAAA,IAAA,IAAAK,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAX,UAAA,EAAGS,KAAK,CAAC;AAC7B,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,CAAC,CAAC;AACjB;;;;"}

package/esm/development/events/use-events.js

@@ -1,12 +1,26 @@
 import { EventBus } from '@wirestate/core';
 import { useRef, useEffect } from 'react';
-import { useContainer } from '../provision/use-container.js';
+import { useContainer } from '../context/use-container.js';
 
 /**
- * Subscribes a component to multiple event types.
+ * Subscribes a component to multiple event types on the {@link EventBus}.
  *
- * @param types - event types to filter by
- * @param handler - events handler
+ * @remarks
+ * Similar to {@link useEvent}, but allows listening for a collection of event
+ * types using a single handler.
+ * The handler and type list are synced via `useRef` to avoid stale closures.
+ *
+ * @group Events
+ *
+ * @param types - Array of event types (strings or symbols) to filter by.
+ * @param handler - Function invoked when any of the specified events are emitted.
+ *
+ * @example
+ * ```tsx
+ * useEvents(["USER_UPDATED", "USER_DELETED"], (event) => {
+ *   refreshList();
+ * });
+ * ```
  */
 function useEvents(types, handler) {
   var typesRef = useRef(types);

package/esm/development/events/use-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-events.js","sources":["../../../../../../../../src/wirestate-react/events/use-events.ts"],"sourcesContent":[null],"names":["useEvents","types","handler","typesRef","useRef","handlerRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","includes","type","_a","call"],"mappings":";;;;AAKA;;;;;AAKG;AACG,SAAUA,SAASA,CAACC,KAA+B,EAAEC,OAAqB,EAAA;AAC9E,EAAA,IAAMC,QAAQ,GAA+CC,MAAM,CAACH,KAAK,CAAC;AAC1E,EAAA,IAAMI,UAAU,GAAmCD,MAAM,CAACF,OAAO,CAAC;AAClE,EAAA,IAAMI,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRL,QAAQ,CAACM,OAAO,GAAGR,KAAK;IACxBI,UAAU,CAACI,OAAO,GAAGP,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFM,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;MAC7C,IAAIV,QAAQ,CAACM,OAAO,CAACK,QAAQ,CAACD,KAAK,CAACE,IAAI,CAAC,EAAE;QACzC,CAAAC,EAAA,GAAAX,UAAU,CAACI,OAAO,MAAA,IAAA,IAAAO,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAZ,UAAA,EAAGQ,KAAK,CAAC;AAC7B,MAAA;AACF,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,CAAC,CAAC;AACjB;;;;"}
+{"version":3,"file":"use-events.js","sources":["../../../../../../../../src/wirestate-react/events/use-events.ts"],"sourcesContent":[null],"names":["useEvents","types","handler","typesRef","useRef","handlerRef","container","useContainer","useEffect","current","get","EventBus","subscribe","event","includes","type","_a","call"],"mappings":";;;;AAKA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAUA,SAASA,CAACC,KAA+B,EAAEC,OAAqB,EAAA;AAC9E,EAAA,IAAMC,QAAQ,GAA+CC,MAAM,CAACH,KAAK,CAAC;AAC1E,EAAA,IAAMI,UAAU,GAAmCD,MAAM,CAACF,OAAO,CAAC;AAClE,EAAA,IAAMI,SAAS,GAAcC,YAAY,EAAE;AAE3CC,EAAAA,SAAS,CAAC,YAAA;IACRL,QAAQ,CAACM,OAAO,GAAGR,KAAK;IACxBI,UAAU,CAACI,OAAO,GAAGP,OAAO;AAC9B,EAAA,CAAC,CAAC;AAEFM,EAAAA,SAAS,CAAC,YAAA;IACR,OAAOF,SAAS,CAACI,GAAG,CAACC,QAAQ,CAAC,CAACC,SAAS,CAAC,UAACC,KAAK,EAAA;;MAC7C,IAAIV,QAAQ,CAACM,OAAO,CAACK,QAAQ,CAACD,KAAK,CAACE,IAAI,CAAC,EAAE;QACzC,CAAAC,EAAA,GAAAX,UAAU,CAACI,OAAO,MAAA,IAAA,IAAAO,EAAA,KAAA,MAAA,GAAA,MAAA,GAAAA,EAAA,CAAAC,IAAA,CAAAZ,UAAA,EAAGQ,KAAK,CAAC;AAC7B,MAAA;AACF,IAAA,CAAC,CAAC;AACJ,EAAA,CAAC,EAAE,CAACP,SAAS,CAAC,CAAC;AACjB;;;;"}

package/esm/development/index.js

@@ -1,19 +1,21 @@
 export { useCommandCaller } from './commands/use-command-caller.js';
 export { useOptionalCommandCaller } from './commands/use-optional-command-caller.js';
 export { useCommandHandler } from './commands/use-command-handler.js';
+export { useContainer } from './context/use-container.js';
+export { useRootContainer } from './context/use-root-container.js';
+export { useScope } from './context/use-scope.js';
+export { useEvent } from './events/use-event.js';
+export { useEvents } from './events/use-events.js';
+export { useEventsHandler } from './events/use-events-handler.js';
+export { useEventEmitter } from './events/use-event-emitter.js';
+export { useInjection } from './injection/use-injection.js';
+export { useOptionalInjection } from './injection/use-optional-injection.js';
+export { SubContainerProvider } from './provision/sub-container-provider.js';
+export { ContainerActivator } from './provision/container-activator.js';
+export { ContainerProvider } from './provision/container-provider.js';
 export { useQueryCaller } from './queries/use-query-caller.js';
 export { useOptionalQueryCaller } from './queries/use-optional-query-caller.js';
 export { useQueryHandler } from './queries/use-query-handler.js';
 export { useSyncQueryCaller } from './queries/use-sync-query-caller.js';
 export { useOptionalSyncQueryCaller } from './queries/use-optional-sync-query-caller.js';
-export { useInjection } from './provision/use-injection.js';
-export { useOptionalInjection } from './provision/use-optional-injection.js';
-export { createInjectablesProvider } from './provision/create-injectables-provider.js';
-export { IocProvider } from './provision/ioc-provider.js';
-export { useContainer } from './provision/use-container.js';
-export { useContainerRevision } from './provision/use-container-revision.js';
-export { useEvent } from './events/use-event.js';
-export { useEvents } from './events/use-events.js';
-export { useEventsHandler } from './events/use-events-handler.js';
-export { useEventEmitter } from './events/use-event-emitter.js';
 //# sourceMappingURL=index.js.map

package/esm/development/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}

package/esm/development/injection/use-injection.js

@@ -0,0 +1,36 @@
+import { useMemo } from 'react';
+import { useContainer } from '../context/use-container.js';
+
+/**
+ * Resolves a service or constant from the active container.
+ *
+ * @remarks
+ * This hook automatically re-resolves the dependency if the container's
+ * revision changes (e.g., due to re-binding in a provider).
+ *
+ * @group Injection
+ *
+ * @template T - The type of the value being resolved.
+ *
+ * @param injectionId - The service identifier (string, symbol, or constructor).
+ *
+ * @returns The resolved instance or value.
+ *
+ * @throws {WirestateError} If the container is not found in context.
+ * @throws {Error} If Inversify fails to resolve the identifier.
+ *
+ * @example
+ * ```tsx
+ * const api: ApiService = useInjection(ApiService);
+ * ```
+ */
+function useInjection(injectionId) {
+  var container = useContainer();
+  // Revision bump causes a container reset; force re-resolution to drop stale instances.
+  return useMemo(function () {
+    return container.get(injectionId);
+  }, [container, injectionId]);
+}
+
+export { useInjection };
+//# sourceMappingURL=use-injection.js.map

package/esm/development/injection/use-injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-injection.js","sources":["../../../../../../../../src/wirestate-react/injection/use-injection.ts"],"sourcesContent":[null],"names":["useInjection","injectionId","container","useContainer","useMemo","get"],"mappings":";;;AASA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AACG,SAAUA,YAAYA,CAAIC,WAAiC,EAAA;AAC/D,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;AAE3C;EACA,OAAOC,OAAO,CAAC,YAAA;AAOb,IAAA,OAAOF,SAAS,CAACG,GAAG,CAAIJ,WAAW,CAAC;AACtC,EAAA,CAAC,EAAE,CAACC,SAAS,EAAED,WAAW,CAAC,CAAC;AAC9B;;;;"}

package/esm/development/injection/use-optional-injection.js

@@ -0,0 +1,40 @@
+import { useMemo } from 'react';
+import { useContainer } from '../context/use-container.js';
+
+/**
+ * Safely resolves a value from the container, returning a fallback or null if not bound.
+ *
+ * @remarks
+ * Unlike {@link useInjection}, this hook does not throw if the dependency
+ * is missing from the container.
+ *
+ * @group Injection
+ *
+ * @template T - The type of the value being resolved.
+ *
+ * @param injectionId - The service identifier (string, symbol, or constructor).
+ * @param onFallback - Optional function called to provide a value if the token is not bound.
+ *
+ * @returns The resolved value, the result of the fallback function, or `null`.
+ *
+ * @example
+ * ```tsx
+ * const logger = useOptionalInjection(FileLogger, (container) => container.get(ConsoleLoggerService);
+ * ```
+ */
+function useOptionalInjection(injectionId, onFallback) {
+  var container = useContainer();
+  // Revision bump forces a container reset; force re-resolution to drop stale instances.
+  return useMemo(function () {
+    if (container.isBound(injectionId)) {
+      return container.get(injectionId);
+    } else if (onFallback) {
+      return onFallback(container);
+    } else {
+      return null;
+    }
+  }, [container, injectionId]);
+}
+
+export { useOptionalInjection };
+//# sourceMappingURL=use-optional-injection.js.map

package/esm/development/injection/use-optional-injection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-optional-injection.js","sources":["../../../../../../../../src/wirestate-react/injection/use-optional-injection.ts"],"sourcesContent":[null],"names":["useOptionalInjection","injectionId","onFallback","container","useContainer","useMemo","isBound","get"],"mappings":";;;AASA;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAUA,oBAAoBA,CAClCC,WAAiC,EACjCC,UAAwC,EAAA;AAExC,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;AAE3C;EACA,OAAOC,OAAO,CAAC,YAAA;AACb,IAAA,IAAIF,SAAS,CAACG,OAAO,CAACL,WAAW,CAAC,EAAE;AAQlC,MAAA,OAAOE,SAAS,CAACI,GAAG,CAAIN,WAAW,CAAC;IACtC,CAAC,MAAM,IAAIC,UAAU,EAAE;MAQrB,OAAOA,UAAU,CAACC,SAAS,CAAC;AAC9B,IAAA,CAAC,MAAM;AAQL,MAAA,OAAO,IAAI;AACb,IAAA;AACF,EAAA,CAAC,EAAE,CAACA,SAAS,EAAEF,WAAW,CAAC,CAAC;AAC9B;;;;"}

package/esm/development/provision/container-activator.js

@@ -0,0 +1,33 @@
+import { useRef } from 'react';
+import { useContainer } from '../context/use-container.js';
+
+/**
+ * Resolves specified services from the current IoC container before rendering children.
+ *
+ * @remarks
+ * Activation runs once per container instance.
+ * On rerender with the same container, services are not resolved again.
+ *
+ * @group Provision
+ *
+ * @param props - Component properties.
+ * @param props.activate - Services to resolve eagerly from container.
+ * @param props.children - React children element.
+ * @returns React children after activation side effect is applied.
+ */
+function ContainerActivator(props) {
+  var _a;
+  var container = useContainer();
+  var activatedContainerRef = useRef(null);
+  if (activatedContainerRef.current !== container) {
+    activatedContainerRef.current = container;
+    for (var _i = 0, _b = props.activate; _i < _b.length; _i++) {
+      var entry = _b[_i];
+      container.get(entry);
+    }
+  }
+  return (_a = props.children) !== null && _a !== void 0 ? _a : null;
+}
+
+export { ContainerActivator };
+//# sourceMappingURL=container-activator.js.map

package/esm/development/provision/container-activator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-activator.js","sources":["../../../../../../../../src/wirestate-react/provision/container-activator.ts"],"sourcesContent":[null],"names":["ContainerActivator","props","container","useContainer","activatedContainerRef","useRef","current","_i","_b","activate","length","entry","get","children","_a"],"mappings":";;;AA0BA;;;;;;;;;;;;;AAaG;AACG,SAAUA,kBAAkBA,CAACC,KAA8B,EAAA;;AAC/D,EAAA,IAAMC,SAAS,GAAcC,YAAY,EAAE;AAC3C,EAAA,IAAMC,qBAAqB,GAA0CC,MAAM,CAAC,IAAI,CAAC;AAEjF,EAAA,IAAID,qBAAqB,CAACE,OAAO,KAAKJ,SAAS,EAAE;IAC/CE,qBAAqB,CAACE,OAAO,GAAGJ,SAAS;AAEzC,IAAA,KAAoB,IAAAK,EAAA,GAAA,CAAc,EAAdC,EAAA,GAAAP,KAAK,CAACQ,QAAQ,EAAdF,EAAA,GAAAC,EAAA,CAAAE,MAAc,EAAdH,EAAA,EAAc,EAAE;AAA/B,MAAA,IAAMI,KAAK,GAAAH,EAAA,CAAAD,EAAA,CAAA;AACdL,MAAAA,SAAS,CAACU,GAAG,CAACD,KAAK,CAAC;AACtB,IAAA;AACF,EAAA;AAEA,EAAA,OAAO,MAACV,KAAK,CAACY,QAAyB,MAAA,IAAA,IAAAC,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,IAAI;AACjD;;;;"}

package/esm/development/provision/container-provider.js

@@ -0,0 +1,74 @@
+import { Container, createContainer } from '@wirestate/core';
+import { createElement } from 'react';
+import { ContainerReactContext } from '../context/container-context.js';
+import { shallowEqualArrays } from '../utils/shallow-equal-arrays.js';
+import { useContainerProvisionState } from './use-container-provision-state.js';
+
+/**
+ * Provides a root Wirestate container to a React subtree.
+ *
+ * @remarks
+ * The provider supports two modes:
+ *
+ * - External mode: `container` is a prebuilt {@link Container}. The provider
+ *   only passes it through context.
+ * - Managed mode: `container` is {@link CreateContainerOptions}. The provider
+ *   creates a container, owns its disposal, recreates it when `entries` change,
+ *   and revives it after React development remount cleanup.
+ *
+ * @group Provision
+ *
+ * @param props - Provider props.
+ * @returns A React context provider for the active container.
+ */
+function ContainerProvider(props) {
+  var _a;
+  var state = useContainerProvisionState(props.container, {
+    create: createContainerState,
+    label: "ContainerProvider",
+    reuse: canReuseContainerState
+  });
+  return createElement(ContainerReactContext.Provider, {
+    value: state.container
+  }, (_a = props.children) !== null && _a !== void 0 ? _a : null);
+}
+/**
+ * Selects the provider state that should be exposed for the current source.
+ *
+ * @param current - Previously exposed state, if any.
+ * @param source - Current container source prop.
+ * @param disposed - Containers already disposed by this provider.
+ * @returns `true` when current state can be reused.
+ */
+function canReuseContainerState(current, source, disposed) {
+  var _a, _b;
+  if (source instanceof Container) {
+    return !current.owned && current.container === source;
+  }
+  return current.owned && !disposed.has(current.container) && shallowEqualArrays((_a = source.entries) !== null && _a !== void 0 ? _a : [], current.source instanceof Container ? [] : (_b = current.source.entries) !== null && _b !== void 0 ? _b : []);
+}
+/**
+ * Creates provider state for an external or managed container source.
+ *
+ * @param source - Container instance or creation options.
+ * @returns Provider state ready for context.
+ */
+function createContainerState(source) {
+  if (source instanceof Container) {
+    return {
+      source: source,
+      container: source,
+      owned: false
+    };
+  } else {
+    var container = createContainer(source);
+    return {
+      source: source,
+      container: container,
+      owned: true
+    };
+  }
+}
+
+export { ContainerProvider };
+//# sourceMappingURL=container-provider.js.map

package/esm/development/provision/container-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-provider.js","sources":["../../../../../../../../src/wirestate-react/provision/container-provider.ts"],"sourcesContent":[null],"names":["ContainerProvider","props","state","useContainerProvisionState","container","create","createContainerState","label","reuse","canReuseContainerState","createElement","ContainerReactContext","Provider","value","_a","children","current","source","disposed","Container","owned","has","shallowEqualArrays","entries","_b","createContainer"],"mappings":";;;;;;AAkDA;;;;;;;;;;;;;;;;AAgBG;AACG,SAAUA,iBAAiBA,CAACC,KAA6B,EAAA;;AAC7D,EAAA,IAAMC,KAAK,GAA2BC,0BAA0B,CAACF,KAAK,CAACG,SAAS,EAAE;AAChFC,IAAAA,MAAM,EAAEC,oBAAoB;AAC5BC,IAAAA,KAAK,EAAE,mBAAmB;AAC1BC,IAAAA,KAAK,EAAEC;AACR,GAAA,CAAC;AAEF,EAAA,OAAOC,aAAa,CAACC,qBAAqB,CAACC,QAAQ,EAAE;IAAEC,KAAK,EAAEX,KAAK,CAACE;AAAS,GAAE,EAAE,CAAAU,EAAA,GAAAb,KAAK,CAACc,QAAQ,MAAA,IAAA,IAAAD,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,IAAI,CAAC;AAC1G;AAEA;;;;;;;AAOG;AACH,SAASL,sBAAsBA,CAC7BO,OAA+B,EAC/BC,MAA+B,EAC/BC,QAA4B,EAAA;;EAE5B,IAAID,MAAM,YAAYE,SAAS,EAAE;IAC/B,OAAO,CAACH,OAAO,CAACI,KAAK,IAAIJ,OAAO,CAACZ,SAAS,KAAKa,MAAM;AACvD,EAAA;AAEA,EAAA,OACED,OAAO,CAACI,KAAK,IACb,CAACF,QAAQ,CAACG,GAAG,CAACL,OAAO,CAACZ,SAAS,CAAC,IAChCkB,kBAAkB,CAAC,CAAAR,EAAA,GAAAG,MAAM,CAACM,OAAO,MAAA,IAAA,IAAAT,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,EAAE,EAAEE,OAAO,CAACC,MAAM,YAAYE,SAAS,GAAG,EAAE,GAAI,CAAAK,EAAA,GAAAR,OAAO,CAACC,MAAM,CAACM,OAAO,MAAA,IAAA,IAAAC,EAAA,KAAA,MAAA,GAAAA,EAAA,GAAI,EAAG,CAAC;AAEvH;AAEA;;;;;AAKG;AACH,SAASlB,oBAAoBA,CAACW,MAA+B,EAAA;EAC3D,IAAIA,MAAM,YAAYE,SAAS,EAAE;IAK/B,OAAO;AACLF,MAAAA,MAAM,EAAAA,MAAA;AACNb,MAAAA,SAAS,EAAEa,MAAM;AACjBG,MAAAA,KAAK,EAAE;KACR;AACH,EAAA,CAAC,MAAM;AAKL,IAAA,IAAMhB,SAAS,GAAcqB,eAAe,CAACR,MAAM,CAAC;IAEpD,OAAO;AACLA,MAAAA,MAAM,EAAAA,MAAA;AACNb,MAAAA,SAAS,EAAAA,SAAA;AACTgB,MAAAA,KAAK,EAAE;KACR;AACH,EAAA;AACF;;;;"}