@logixjs/react 0.1.0

package/dist/ModuleScope.d.cts

@@ -0,0 +1,62 @@
+import React from 'react';
+import * as Logix from '@logixjs/core';
+import { c as ModuleRef, b as ModuleDispatchersOfShape } from './ModuleRef-wZSQ3Wwo.cjs';
+
+type ModuleScopeOptions = {
+    readonly deps?: React.DependencyList;
+    /**
+     * scopeId: stable identifier for this Scope (domain boundary id).
+     *
+     * Typical: route:${routeId} / route:${routeId}:tab:${tabId}
+     *
+     * - Same scopeId reuses the same Host instance (and its imported child modules).
+     * - Changing scopeId creates a new isolated instance.
+     */
+    readonly scopeId?: string;
+    readonly suspend?: false | undefined;
+    readonly initTimeoutMs?: number;
+    readonly gcTime?: number;
+    readonly label?: string;
+} | {
+    readonly deps?: React.DependencyList;
+    readonly scopeId: string;
+    readonly suspend: true;
+    readonly initTimeoutMs?: number;
+    readonly gcTime?: number;
+    readonly label?: string;
+};
+type ModuleScope<Ref> = {
+    readonly Provider: React.FC<{
+        readonly children: React.ReactNode;
+        readonly options?: ModuleScopeOptions;
+    }>;
+    readonly use: () => Ref;
+    /**
+     * useImported: sugar for the route Host(imports) use case.
+     *
+     * Equivalent to:
+     * - const host = scope.use()
+     * - const child = host.imports.get(Child.tag)
+     */
+    readonly useImported: <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 Context: React.Context<Ref | null>;
+    /**
+     * Bridge: reuse the same scope across React subtrees / separate roots.
+     *
+     * - Precondition: within the same runtime tree, some Provider (typically a route/page boundary)
+     *   has already registered the scope with a stable scopeId.
+     * - Behavior: retrieves the registered runtime + module runtime from ScopeRegistry and re-provides them in this subtree.
+     */
+    readonly Bridge: React.FC<{
+        readonly scopeId: string;
+        readonly children: React.ReactNode;
+    }>;
+};
+declare const ModuleScope: {
+    readonly make: {
+        <Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>, defaults?: ModuleScopeOptions): ModuleScope<ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>>;
+        <Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>, defaults?: ModuleScopeOptions): ModuleScope<ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>> & Ext>;
+    };
+};
+
+export { ModuleScope, type ModuleScopeOptions };

package/dist/ModuleScope.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+import * as Logix from '@logixjs/core';
+import { c as ModuleRef, b as ModuleDispatchersOfShape } from './ModuleRef-wZSQ3Wwo.js';
+
+type ModuleScopeOptions = {
+    readonly deps?: React.DependencyList;
+    /**
+     * scopeId: stable identifier for this Scope (domain boundary id).
+     *
+     * Typical: route:${routeId} / route:${routeId}:tab:${tabId}
+     *
+     * - Same scopeId reuses the same Host instance (and its imported child modules).
+     * - Changing scopeId creates a new isolated instance.
+     */
+    readonly scopeId?: string;
+    readonly suspend?: false | undefined;
+    readonly initTimeoutMs?: number;
+    readonly gcTime?: number;
+    readonly label?: string;
+} | {
+    readonly deps?: React.DependencyList;
+    readonly scopeId: string;
+    readonly suspend: true;
+    readonly initTimeoutMs?: number;
+    readonly gcTime?: number;
+    readonly label?: string;
+};
+type ModuleScope<Ref> = {
+    readonly Provider: React.FC<{
+        readonly children: React.ReactNode;
+        readonly options?: ModuleScopeOptions;
+    }>;
+    readonly use: () => Ref;
+    /**
+     * useImported: sugar for the route Host(imports) use case.
+     *
+     * Equivalent to:
+     * - const host = scope.use()
+     * - const child = host.imports.get(Child.tag)
+     */
+    readonly useImported: <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 Context: React.Context<Ref | null>;
+    /**
+     * Bridge: reuse the same scope across React subtrees / separate roots.
+     *
+     * - Precondition: within the same runtime tree, some Provider (typically a route/page boundary)
+     *   has already registered the scope with a stable scopeId.
+     * - Behavior: retrieves the registered runtime + module runtime from ScopeRegistry and re-provides them in this subtree.
+     */
+    readonly Bridge: React.FC<{
+        readonly scopeId: string;
+        readonly children: React.ReactNode;
+    }>;
+};
+declare const ModuleScope: {
+    readonly make: {
+        <Id extends string, Sh extends Logix.AnyModuleShape, R = never>(handle: Logix.ModuleImpl<Id, Sh, R>, defaults?: ModuleScopeOptions): ModuleScope<ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>>>;
+        <Id extends string, Sh extends Logix.AnyModuleShape, Ext extends object, R = never>(handle: Logix.Module.Module<Id, Sh, Ext, R>, defaults?: ModuleScopeOptions): ModuleScope<ModuleRef<Logix.StateOf<Sh>, Logix.ActionOf<Sh>> & Ext>;
+    };
+};
+
+export { ModuleScope, type ModuleScopeOptions };

package/dist/ModuleScope.js

@@ -0,0 +1,9 @@
+import {
+  ModuleScope
+} from "./chunk-G5MRIFKK.js";
+import "./chunk-UFFCJGSZ.js";
+import "./chunk-JXAJTWSZ.js";
+import "./chunk-2WFULYPJ.js";
+export {
+  ModuleScope
+};

package/dist/Platform.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Platform.ts
+var Platform_exports = {};
+__export(Platform_exports, {
+  ReactPlatformLayer: () => ReactPlatformLayer
+});
+module.exports = __toCommonJS(Platform_exports);
+
+// src/internal/platform/ReactPlatformLayer.ts
+var import_effect = require("effect");
+var import_core = require("@logixjs/core");
+var ReactPlatformImpl = class {
+  constructor(suspendRef, resumeRef, resetRef) {
+    this.suspendRef = suspendRef;
+    this.resumeRef = resumeRef;
+    this.resetRef = resetRef;
+    this.lifecycle = {
+      onSuspend: (eff) => import_effect.Ref.update(this.suspendRef, (list) => [...list, eff]).pipe(import_effect.Effect.asVoid),
+      onResume: (eff) => import_effect.Ref.update(this.resumeRef, (list) => [...list, eff]).pipe(import_effect.Effect.asVoid),
+      onReset: (eff) => import_effect.Ref.update(this.resetRef, (list) => [...list, eff]).pipe(import_effect.Effect.asVoid)
+    };
+    // The emit* methods are not part of the official Logic.Platform interface; they are for host/test use only.
+    // After retrieving the instance via `Effect.service(Logic.Platform)`, call them via `any`.
+    this.emitSuspend = () => import_effect.Ref.get(this.suspendRef).pipe(import_effect.Effect.flatMap((effects) => import_effect.Effect.forEach(effects, (eff) => eff, { discard: true })));
+    this.emitResume = () => import_effect.Ref.get(this.resumeRef).pipe(import_effect.Effect.flatMap((effects) => import_effect.Effect.forEach(effects, (eff) => eff, { discard: true })));
+    this.emitReset = () => import_effect.Ref.get(this.resetRef).pipe(import_effect.Effect.flatMap((effects) => import_effect.Effect.forEach(effects, (eff) => eff, { discard: true })));
+  }
+};
+var makeReactPlatform = import_effect.Effect.gen(function* () {
+  const suspendRef = yield* import_effect.Ref.make([]);
+  const resumeRef = yield* import_effect.Ref.make([]);
+  const resetRef = yield* import_effect.Ref.make([]);
+  return new ReactPlatformImpl(suspendRef, resumeRef, resetRef);
+});
+var ReactPlatformLayer = import_effect.Layer.scoped(
+  import_core.Platform.tag,
+  makeReactPlatform
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReactPlatformLayer
+});

package/dist/Platform.d.cts

@@ -0,0 +1,6 @@
+import { Layer } from 'effect';
+import { Platform } from '@logixjs/core';
+
+declare const ReactPlatformLayer: Layer.Layer<Platform.Service, never, never>;
+
+export { ReactPlatformLayer };

package/dist/Platform.d.ts

@@ -0,0 +1,6 @@
+import { Layer } from 'effect';
+import { Platform } from '@logixjs/core';
+
+declare const ReactPlatformLayer: Layer.Layer<Platform.Service, never, never>;
+
+export { ReactPlatformLayer };

package/dist/Platform.js

@@ -0,0 +1,6 @@
+import {
+  ReactPlatformLayer
+} from "./chunk-ZANGOPUQ.js";
+export {
+  ReactPlatformLayer
+};