@logixjs/react 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,10 @@
+export { ModuleHandle, ModulePreloadPolicy, RuntimeProvider, RuntimeProviderErrorContext, RuntimeProviderPolicy, RuntimeProviderPolicyMode, RuntimeProviderProps, YieldPolicy, YieldStrategy } from './RuntimeProvider.cjs';
+export { UseProcessesOptions, UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime } from './Hooks.cjs';
+export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-CnO5-66H.cjs';
+export { ReactPlatformLayer } from './Platform.cjs';
+export { ReactPlatform } from './ReactPlatform.cjs';
+export { ModuleScope, ModuleScopeOptions } from './ModuleScope.cjs';
+export { M as ModuleActions, a as ModuleDispatchers, b as ModuleDispatchersOfShape, c as ModuleRef } from './ModuleRef-wZSQ3Wwo.cjs';
+import 'react';
+import 'effect';
+import '@logixjs/core';

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { ModuleHandle, ModulePreloadPolicy, RuntimeProvider, RuntimeProviderErrorContext, RuntimeProviderPolicy, RuntimeProviderPolicyMode, RuntimeProviderProps, YieldPolicy, YieldStrategy } from './RuntimeProvider.js';
+export { UseProcessesOptions, UseRuntimeOptions, shallow, useImportedModule, useLayerModule, useModuleList, useProcesses, useRuntime } from './Hooks.js';
+export { c as useDispatch, a as useLocalModule, u as useModule, b as useSelector } from './useDispatch-BnzYVkRE.js';
+export { ReactPlatformLayer } from './Platform.js';
+export { ReactPlatform } from './ReactPlatform.js';
+export { ModuleScope, ModuleScopeOptions } from './ModuleScope.js';
+export { M as ModuleActions, a as ModuleDispatchers, b as ModuleDispatchersOfShape, c as ModuleRef } from './ModuleRef-wZSQ3Wwo.js';
+import 'react';
+import 'effect';
+import '@logixjs/core';

package/dist/index.js

@@ -0,0 +1,44 @@
+import {
+  ModuleScope
+} from "./chunk-G5MRIFKK.js";
+import {
+  ReactPlatformLayer
+} from "./chunk-ZANGOPUQ.js";
+import {
+  ReactPlatform
+} from "./chunk-4G7H66OY.js";
+import {
+  useDispatch,
+  useImportedModule,
+  useLayerModule,
+  useLocalModule,
+  useModuleList,
+  useProcesses
+} from "./chunk-PYWHL7TA.js";
+import {
+  shallow,
+  useModule,
+  useRuntime,
+  useSelector
+} from "./chunk-UFFCJGSZ.js";
+import "./chunk-VFWWMK67.js";
+import {
+  RuntimeProvider
+} from "./chunk-JXAJTWSZ.js";
+import "./chunk-2WFULYPJ.js";
+export {
+  ModuleScope,
+  ReactPlatform,
+  ReactPlatformLayer,
+  RuntimeProvider,
+  shallow,
+  useDispatch,
+  useImportedModule,
+  useLayerModule,
+  useLocalModule,
+  useModule,
+  useModuleList,
+  useProcesses,
+  useRuntime,
+  useSelector
+};

package/dist/useDispatch-BnzYVkRE.d.ts

@@ -0,0 +1,81 @@
+import React from 'react';
+import * as Logix from '@logixjs/core';
+import { c as ModuleRef, b as ModuleDispatchersOfShape, D as Dispatch } from './ModuleRef-wZSQ3Wwo.js';
+import { Effect } from 'effect';
+
+type ReactModuleHandle = Logix.ModuleRuntime<any, any> | Logix.ModuleTagType<any, any> | ModuleRef<any, any>;
+
+interface ModuleImplSyncOptions {
+    readonly deps?: React.DependencyList;
+    readonly key?: string;
+    readonly suspend?: false | undefined;
+    readonly initTimeoutMs?: number;
+    /**
+     * Keep-alive time (ms) after this ModuleRuntime has no holders (refCount=0).
+     * - Defaults to ModuleCache's default (~500ms) to absorb StrictMode jitter.
+     * - For session-level use cases, you can set a longer time, e.g. 5 minutes.
+     */
+    readonly gcTime?: number;
+    /**
+     * (Optional) instance label: a friendly name for DevTools / debugging views.
+     * - If omitted, when DevTools is enabled it falls back to key or auto numbering (Instance #1/#2).
+     * - Recommended for multi-instance scenarios like sessions/shards, e.g. "Session A" / "Session B".
+     */
+    readonly label?: string;
+}
+interface ModuleImplSuspendOptions {
+    readonly deps?: React.DependencyList;
+    readonly key: string;
+    readonly suspend: true;
+    readonly gcTime?: number;
+    /**
+     * Max pending time (ms) allowed for module initialization (including async Layer building).
+     * - Only applies when suspend:true.
+     * - If it still hasn't finished after this time, it fails via Effect.timeoutFail and the caller's ErrorBoundary
+     *   (or upper-layer logic) decides retry/degrade strategy.
+     * - Does not change gcTime semantics: gcTime still only describes keep-alive time after there are no holders.
+     */
+    readonly initTimeoutMs?: number;
+    /**
+     * (Optional) instance label: a friendly name for DevTools / debugging views.
+     * - If omitted, when DevTools is enabled it falls back to key or auto numbering.
+     */
+    readonly label?: string;
+}
+type ModuleImplOptions = ModuleImplSyncOptions | ModuleImplSuspendOptions;
+type ModuleDef$1<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = Logix.Module.ModuleDef<Id, Sh, Ext>;
+type StateOfHandle$1<H> = H extends ModuleRef<infer S, infer _A> ? S : H extends Logix.ModuleRuntime<infer S, infer _A> ? S : H extends Logix.ModuleTagType<string, infer Sh> ? Logix.StateOf<Sh> : never;
+type ActionOfHandle$1<H> = H extends ModuleRef<infer _S, infer A> ? A : H extends Logix.ModuleRuntime<infer _S, infer A> ? A : H extends Logix.ModuleTagType<string, infer Sh> ? Logix.ActionOf<Sh> : never;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>, options: ModuleImplOptions): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.Module.Module<Id, Sh, Ext, R>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>, options: ModuleImplOptions): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.Module.Module<Id, Sh, Ext, R>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}>(handle: ModuleDef$1<Id, Sh, Ext>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, ModuleDef$1<Id, Sh, Ext>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape>(handle: Logix.ModuleTagType<Id, Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<H extends ReactModuleHandle>(handle: H): ModuleRef<StateOfHandle$1<H>, ActionOfHandle$1<H>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R, V>(handle: Logix.ModuleImpl<Id, Sh, R>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R, V>(handle: Logix.Module.Module<Id, Sh, any, R>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, V>(handle: ModuleDef$1<Id, Sh, any>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, V>(handle: Logix.ModuleTagType<Id, Sh>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<H extends ReactModuleHandle, V>(handle: H, selector: (state: StateOfHandle$1<H>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+
+type LocalModuleFactory<S, A> = () => Effect.Effect<Logix.ModuleRuntime<S, A>, unknown, unknown>;
+type ModuleDef<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = Logix.Module.ModuleDef<Id, Sh, Ext>;
+interface ModuleTagOptions<Sh extends Logix.AnyModuleShape = Logix.AnyModuleShape> {
+    readonly initial: Logix.StateOf<Sh>;
+    readonly logics?: ReadonlyArray<Logix.ModuleLogic<Sh>>;
+    readonly deps?: React.DependencyList;
+    readonly key?: string;
+}
+declare function useLocalModule<S, A>(factory: LocalModuleFactory<S, A>, deps?: React.DependencyList): ModuleRef<S, A>;
+declare function useLocalModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}>(module: ModuleDef<Id, Sh, Ext>, options: ModuleTagOptions<Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, ModuleDef<Id, Sh, Ext>> & Ext;
+declare function useLocalModule<Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<string, Sh>, options: ModuleTagOptions<Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<string, Sh>>;
+
+type StateOfHandle<H> = H extends ModuleRef<infer S, any> ? S : H extends Logix.ModuleRuntime<infer S, any> ? S : H extends Logix.ModuleTagType<any, infer Sh> ? Logix.StateOf<Sh> : never;
+declare function useSelector<H extends ReactModuleHandle>(handle: H): StateOfHandle<H>;
+declare function useSelector<H extends ReactModuleHandle, V>(handle: H, selector: (state: StateOfHandle<H>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+
+type ActionOfHandle<H> = H extends ModuleRef<any, infer A> ? A : H extends Logix.ModuleRuntime<any, infer A> ? A : H extends Logix.ModuleTagType<any, infer Sh> ? Logix.ActionOf<Sh> : never;
+declare function useDispatch<H extends ReactModuleHandle>(handle: H): Dispatch<ActionOfHandle<H>>;
+
+export { useLocalModule as a, useSelector as b, useDispatch as c, useModule as u };

package/dist/useDispatch-CnO5-66H.d.cts

@@ -0,0 +1,81 @@
+import React from 'react';
+import * as Logix from '@logixjs/core';
+import { c as ModuleRef, b as ModuleDispatchersOfShape, D as Dispatch } from './ModuleRef-wZSQ3Wwo.cjs';
+import { Effect } from 'effect';
+
+type ReactModuleHandle = Logix.ModuleRuntime<any, any> | Logix.ModuleTagType<any, any> | ModuleRef<any, any>;
+
+interface ModuleImplSyncOptions {
+    readonly deps?: React.DependencyList;
+    readonly key?: string;
+    readonly suspend?: false | undefined;
+    readonly initTimeoutMs?: number;
+    /**
+     * Keep-alive time (ms) after this ModuleRuntime has no holders (refCount=0).
+     * - Defaults to ModuleCache's default (~500ms) to absorb StrictMode jitter.
+     * - For session-level use cases, you can set a longer time, e.g. 5 minutes.
+     */
+    readonly gcTime?: number;
+    /**
+     * (Optional) instance label: a friendly name for DevTools / debugging views.
+     * - If omitted, when DevTools is enabled it falls back to key or auto numbering (Instance #1/#2).
+     * - Recommended for multi-instance scenarios like sessions/shards, e.g. "Session A" / "Session B".
+     */
+    readonly label?: string;
+}
+interface ModuleImplSuspendOptions {
+    readonly deps?: React.DependencyList;
+    readonly key: string;
+    readonly suspend: true;
+    readonly gcTime?: number;
+    /**
+     * Max pending time (ms) allowed for module initialization (including async Layer building).
+     * - Only applies when suspend:true.
+     * - If it still hasn't finished after this time, it fails via Effect.timeoutFail and the caller's ErrorBoundary
+     *   (or upper-layer logic) decides retry/degrade strategy.
+     * - Does not change gcTime semantics: gcTime still only describes keep-alive time after there are no holders.
+     */
+    readonly initTimeoutMs?: number;
+    /**
+     * (Optional) instance label: a friendly name for DevTools / debugging views.
+     * - If omitted, when DevTools is enabled it falls back to key or auto numbering.
+     */
+    readonly label?: string;
+}
+type ModuleImplOptions = ModuleImplSyncOptions | ModuleImplSuspendOptions;
+type ModuleDef$1<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = Logix.Module.ModuleDef<Id, Sh, Ext>;
+type StateOfHandle$1<H> = H extends ModuleRef<infer S, infer _A> ? S : H extends Logix.ModuleRuntime<infer S, infer _A> ? S : H extends Logix.ModuleTagType<string, infer Sh> ? Logix.StateOf<Sh> : never;
+type ActionOfHandle$1<H> = H extends ModuleRef<infer _S, infer A> ? A : H extends Logix.ModuleRuntime<infer _S, infer A> ? A : H extends Logix.ModuleTagType<string, infer Sh> ? Logix.ActionOf<Sh> : never;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>, options: ModuleImplOptions): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.Module.Module<Id, Sh, Ext, R>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>, options: ModuleImplOptions): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.Module.Module<Id, Sh, Ext, R>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}>(handle: ModuleDef$1<Id, Sh, Ext>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, ModuleDef$1<Id, Sh, Ext>> & Ext;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape>(handle: Logix.ModuleTagType<Id, Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<Id, Sh>, ModuleDispatchersOfShape<Sh>>;
+declare function useModule<H extends ReactModuleHandle>(handle: H): ModuleRef<StateOfHandle$1<H>, ActionOfHandle$1<H>>;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R, V>(handle: Logix.ModuleImpl<Id, Sh, R>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, R, V>(handle: Logix.Module.Module<Id, Sh, any, R>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, V>(handle: ModuleDef$1<Id, Sh, any>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<Id extends string, Sh extends Logix.AnyModuleShape, V>(handle: Logix.ModuleTagType<Id, Sh>, selector: (state: Logix.StateOf<Sh>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+declare function useModule<H extends ReactModuleHandle, V>(handle: H, selector: (state: StateOfHandle$1<H>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+
+type LocalModuleFactory<S, A> = () => Effect.Effect<Logix.ModuleRuntime<S, A>, unknown, unknown>;
+type ModuleDef<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}> = Logix.Module.ModuleDef<Id, Sh, Ext>;
+interface ModuleTagOptions<Sh extends Logix.AnyModuleShape = Logix.AnyModuleShape> {
+    readonly initial: Logix.StateOf<Sh>;
+    readonly logics?: ReadonlyArray<Logix.ModuleLogic<Sh>>;
+    readonly deps?: React.DependencyList;
+    readonly key?: string;
+}
+declare function useLocalModule<S, A>(factory: LocalModuleFactory<S, A>, deps?: React.DependencyList): ModuleRef<S, A>;
+declare function useLocalModule<Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object = {}>(module: ModuleDef<Id, Sh, Ext>, options: ModuleTagOptions<Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, ModuleDef<Id, Sh, Ext>> & Ext;
+declare function useLocalModule<Sh extends Logix.AnyModuleShape>(module: Logix.ModuleTagType<string, Sh>, options: ModuleTagOptions<Sh>): ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>, keyof Sh['actionMap'] & string, Logix.ModuleTagType<string, Sh>>;
+
+type StateOfHandle<H> = H extends ModuleRef<infer S, any> ? S : H extends Logix.ModuleRuntime<infer S, any> ? S : H extends Logix.ModuleTagType<any, infer Sh> ? Logix.StateOf<Sh> : never;
+declare function useSelector<H extends ReactModuleHandle>(handle: H): StateOfHandle<H>;
+declare function useSelector<H extends ReactModuleHandle, V>(handle: H, selector: (state: StateOfHandle<H>) => V, equalityFn?: (previous: V, next: V) => boolean): V;
+
+type ActionOfHandle<H> = H extends ModuleRef<any, infer A> ? A : H extends Logix.ModuleRuntime<any, infer A> ? A : H extends Logix.ModuleTagType<any, infer Sh> ? Logix.ActionOf<Sh> : never;
+declare function useDispatch<H extends ReactModuleHandle>(handle: H): Dispatch<ActionOfHandle<H>>;
+
+export { useLocalModule as a, useSelector as b, useDispatch as c, useModule as u };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@logixjs/react",
+  "version": "0.1.0",
+  "files": [
+    "dist/**"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
+    },
+    "./internal/*": null
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "effect": "^3.19.8",
+    "use-sync-external-store": "^1.2.0",
+    "@logixjs/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.1",
+    "@types/react": "^19.2.2",
+    "@types/use-sync-external-store": "^1.5.0",
+    "jsdom": "24.0.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.4.5",
+    "vitest": "^4.0.15"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:changed": "vitest run --changed",
+    "test:cache": "vitest run --cache",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
+  }
+}