@logixjs/react 0.1.0 → 0.1.1

package/dist/Hooks.d.cts

@@ -1,9 +1,9 @@
 import { Layer, ManagedRuntime, Effect } from 'effect';
-export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-CnO5-66H.cjs';
+export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-DiwQQAfC.cjs';
 import React from 'react';
 import * as Logix from '@logixjs/core';
-import { c as ModuleRef, b as ModuleDispatchersOfShape } from './ModuleRef-wZSQ3Wwo.cjs';
-export { M as ModuleActions, a as ModuleDispatchers } from './ModuleRef-wZSQ3Wwo.cjs';
+import { d as ModuleRef, h as ModuleRefOfTag } from './ModuleRef-gZmL6Zvb.cjs';
+export { c as ModuleActionTagsOfShape, M as ModuleActions, a as ModuleDispatchers, b as ModuleDispatchersOfShape, f as ModuleRefOfDef, g as ModuleRefOfModule, e as ModuleRefOfShape } from './ModuleRef-gZmL6Zvb.cjs';
 
 interface UseRuntimeOptions {
     readonly layer?: Layer.Layer<any, any, never>;
@@ -19,7 +19,7 @@ declare function useRuntime(options: UseRuntimeOptions): ManagedRuntime.ManagedR
  * - On the effect side, you already built the full Layer via `Module.live(initial, ...logics)`.
  * - A React component wants to "just consume" that Layer without caring about initial/logics details.
  */
-declare function useLayerModule<Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>, layer: Layer.Layer<Logix.ModuleRuntime<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>, never, any>, deps?: React.DependencyList): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>;
+declare function useLayerModule<Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>, layer: Layer.Layer<Logix.ModuleRuntimeOfShape<Sh>, never, any>, deps?: React.DependencyList): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>;
 
 /**
  * A hook to manage a dynamic list of Module instances.
@@ -41,7 +41,7 @@ declare function useModuleList<T, M>(items: T[], keyFn: (item: T) => string, fac
  * - const query = useImportedModule(host, SearchQuery.tag)
  * - const status = useSelector(query, s => s.search.status)
  */
-declare function useImportedModule<Id extends string, Sh extends Logix.AnyModuleShape>(parent: Logix.ModuleRuntime<any, any> | ModuleRef<any, any>, module: Logix.ModuleTagType<Id, Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useImportedModule<Id extends string, Sh extends Logix.AnyModuleShape>(parent: Logix.ModuleRuntime<any, any> | ModuleRef<any, any>, module: Logix.ModuleTagType<Id, Sh>): ModuleRefOfTag<Id, Sh>;
 
 interface UseProcessesOptions {
     /**
@@ -74,4 +74,4 @@ declare function useProcesses(processes: ReadonlyArray<Effect.Effect<void, any,
  */
 declare const shallow: <T>(previous: T, next: T) => boolean;
 
-export { ModuleDispatchersOfShape, ModuleRef, type UseProcessesOptions, type UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime };
+export { ModuleRef, ModuleRefOfTag, type UseProcessesOptions, type UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime };

package/dist/Hooks.d.ts

@@ -1,9 +1,9 @@
 import { Layer, ManagedRuntime, Effect } from 'effect';
-export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-BnzYVkRE.js';
+export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-CiDimIYZ.js';
 import React from 'react';
 import * as Logix from '@logixjs/core';
-import { c as ModuleRef, b as ModuleDispatchersOfShape } from './ModuleRef-wZSQ3Wwo.js';
-export { M as ModuleActions, a as ModuleDispatchers } from './ModuleRef-wZSQ3Wwo.js';
+import { d as ModuleRef, h as ModuleRefOfTag } from './ModuleRef-gZmL6Zvb.js';
+export { c as ModuleActionTagsOfShape, M as ModuleActions, a as ModuleDispatchers, b as ModuleDispatchersOfShape, f as ModuleRefOfDef, g as ModuleRefOfModule, e as ModuleRefOfShape } from './ModuleRef-gZmL6Zvb.js';
 
 interface UseRuntimeOptions {
     readonly layer?: Layer.Layer<any, any, never>;
@@ -19,7 +19,7 @@ declare function useRuntime(options: UseRuntimeOptions): ManagedRuntime.ManagedR
  * - On the effect side, you already built the full Layer via `Module.live(initial, ...logics)`.
  * - A React component wants to "just consume" that Layer without caring about initial/logics details.
  */
-declare function useLayerModule<Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>, layer: Layer.Layer<Logix.ModuleRuntime<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>, never, any>, deps?: React.DependencyList): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>;
+declare function useLayerModule<Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>, layer: Layer.Layer<Logix.ModuleRuntimeOfShape<Sh>, never, any>, deps?: React.DependencyList): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>;
 
 /**
  * A hook to manage a dynamic list of Module instances.
@@ -41,7 +41,7 @@ declare function useModuleList<T, M>(items: T[], keyFn: (item: T) => string, fac
  * - const query = useImportedModule(host, SearchQuery.tag)
  * - const status = useSelector(query, s => s.search.status)
  */
-declare function useImportedModule<Id extends string, Sh extends Logix.AnyModuleShape>(parent: Logix.ModuleRuntime<any, any> | ModuleRef<any, any>, module: Logix.ModuleTagType<Id, Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useImportedModule<Id extends string, Sh extends Logix.AnyModuleShape>(parent: Logix.ModuleRuntime<any, any> | ModuleRef<any, any>, module: Logix.ModuleTagType<Id, Sh>): ModuleRefOfTag<Id, Sh>;
 
 interface UseProcessesOptions {
     /**
@@ -74,4 +74,4 @@ declare function useProcesses(processes: ReadonlyArray<Effect.Effect<void, any,
  */
 declare const shallow: <T>(previous: T, next: T) => boolean;
 
-export { ModuleDispatchersOfShape, ModuleRef, type UseProcessesOptions, type UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime };
+export { ModuleRef, ModuleRefOfTag, type UseProcessesOptions, type UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime };

package/dist/Hooks.js

@@ -5,13 +5,13 @@ import {
   useLocalModule,
   useModuleList,
   useProcesses
-} from "./chunk-PYWHL7TA.js";
+} from "./chunk-WOTNVLCD.js";
 import {
   shallow,
   useModule,
   useRuntime,
   useSelector
-} from "./chunk-UFFCJGSZ.js";
+} from "./chunk-G2LX7WWQ.js";
 import "./chunk-2WFULYPJ.js";
 export {
   shallow,

package/dist/{ModuleRef-wZSQ3Wwo.d.cts → ModuleRef-gZmL6Zvb.d.cts}

@@ -21,6 +21,11 @@ type ActionPayload<A, K> = Extract<A, {
 } ? P : never;
 type AnyActionToken = Logix.Action.ActionToken<string, any, any>;
 type ModuleDispatchersOfShape<Sh extends Logix.AnyModuleShape> = Sh['actionMap'];
+type ModuleActionTagsOfShape<Sh extends Logix.AnyModuleShape> = keyof Sh['actionMap'] & string;
+type ModuleRefOfShape<Sh extends Logix.AnyModuleShape, Def = unknown, Dispatchers = ModuleDispatchersOfShape<Sh>> = ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, ModuleActionTagsOfShape<Sh>, Def, Dispatchers>;
+type ModuleRefOfTag<Id extends string, Sh extends Logix.AnyModuleShape> = ModuleRefOfShape<Sh, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+type ModuleRefOfModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}, R = never> = ModuleRefOfShape<Sh, Logix.Module.Module<Id, Sh, Ext, R>, ModuleDispatchersOfShape<Sh>> & Ext;
+type ModuleRefOfDef<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = ModuleRefOfShape<Sh, Logix.Module.ModuleDef<Id, Sh, Ext>, ModuleDispatchersOfShape<Sh>> & Ext;
 type ModuleActions<A, Tags extends string = ActionTags<A>> = {
     readonly dispatch: Dispatch<A>;
 } & ([ActionTags<A>] extends [never] ? {} : {
@@ -45,7 +50,7 @@ type ModuleDispatchers<A, Tags extends string = ActionTags<A>, Def = unknown> =
     }>>;
 };
 interface ModuleImports {
-    readonly get: <Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>) => ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+    readonly get: <Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>) => ModuleRefOfTag<Id, Sh>;
 }
 interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Dispatchers = ModuleDispatchers<A, Tags, Def>> {
     /**
@@ -59,7 +64,7 @@ interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Di
     readonly dispatchers: Dispatchers;
     /**
      * Fractal module imports sugar:
-     * - host.imports.get(ChildModule) resolves a child module instance within the host instance scope.
+     * - host.imports.get(ChildModule.tag) resolves a child module instance within the host instance scope.
      * - strict by default: throws when scope is missing, avoiding accidentally routing to a global instance.
      */
     readonly imports: ModuleImports;
@@ -70,4 +75,4 @@ interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Di
     readonly ref: Logix.ModuleRuntime<S, A>['ref'];
 }
 
-export type { Dispatch as D, ModuleActions as M, ModuleDispatchers as a, ModuleDispatchersOfShape as b, ModuleRef as c };
+export type { Dispatch as D, ModuleActions as M, ModuleDispatchers as a, ModuleDispatchersOfShape as b, ModuleActionTagsOfShape as c, ModuleRef as d, ModuleRefOfShape as e, ModuleRefOfDef as f, ModuleRefOfModule as g, ModuleRefOfTag as h };

package/dist/{ModuleRef-wZSQ3Wwo.d.ts → ModuleRef-gZmL6Zvb.d.ts}

@@ -21,6 +21,11 @@ type ActionPayload<A, K> = Extract<A, {
 } ? P : never;
 type AnyActionToken = Logix.Action.ActionToken<string, any, any>;
 type ModuleDispatchersOfShape<Sh extends Logix.AnyModuleShape> = Sh['actionMap'];
+type ModuleActionTagsOfShape<Sh extends Logix.AnyModuleShape> = keyof Sh['actionMap'] & string;
+type ModuleRefOfShape<Sh extends Logix.AnyModuleShape, Def = unknown, Dispatchers = ModuleDispatchersOfShape<Sh>> = ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, ModuleActionTagsOfShape<Sh>, Def, Dispatchers>;
+type ModuleRefOfTag<Id extends string, Sh extends Logix.AnyModuleShape> = ModuleRefOfShape<Sh, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+type ModuleRefOfModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}, R = never> = ModuleRefOfShape<Sh, Logix.Module.Module<Id, Sh, Ext, R>, ModuleDispatchersOfShape<Sh>> & Ext;
+type ModuleRefOfDef<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = ModuleRefOfShape<Sh, Logix.Module.ModuleDef<Id, Sh, Ext>, ModuleDispatchersOfShape<Sh>> & Ext;
 type ModuleActions<A, Tags extends string = ActionTags<A>> = {
     readonly dispatch: Dispatch<A>;
 } & ([ActionTags<A>] extends [never] ? {} : {
@@ -45,7 +50,7 @@ type ModuleDispatchers<A, Tags extends string = ActionTags<A>, Def = unknown> =
     }>>;
 };
 interface ModuleImports {
-    readonly get: <Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>) => ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+    readonly get: <Id extends string, Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<Id, Sh>) => ModuleRefOfTag<Id, Sh>;
 }
 interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Dispatchers = ModuleDispatchers<A, Tags, Def>> {
     /**
@@ -59,7 +64,7 @@ interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Di
     readonly dispatchers: Dispatchers;
     /**
      * Fractal module imports sugar:
-     * - host.imports.get(ChildModule) resolves a child module instance within the host instance scope.
+     * - host.imports.get(ChildModule.tag) resolves a child module instance within the host instance scope.
      * - strict by default: throws when scope is missing, avoiding accidentally routing to a global instance.
      */
     readonly imports: ModuleImports;
@@ -70,4 +75,4 @@ interface ModuleRef<S, A, Tags extends string = ActionTags<A>, Def = unknown, Di
     readonly ref: Logix.ModuleRuntime<S, A>['ref'];
 }
 
-export type { Dispatch as D, ModuleActions as M, ModuleDispatchers as a, ModuleDispatchersOfShape as b, ModuleRef as c };
+export type { Dispatch as D, ModuleActions as M, ModuleDispatchers as a, ModuleDispatchersOfShape as b, ModuleActionTagsOfShape as c, ModuleRef as d, ModuleRefOfShape as e, ModuleRefOfDef as f, ModuleRefOfModule as g, ModuleRefOfTag as h };