@logixjs/react 0.1.0

package/dist/RuntimeProvider.d.cts

@@ -0,0 +1,66 @@
+import React from 'react';
+import { Layer, ManagedRuntime, Cause, Effect } from 'effect';
+import * as Logix from '@logixjs/core';
+
+type RuntimeProviderPolicyMode = 'sync' | 'suspend' | 'defer';
+type YieldStrategy = 'none' | 'microtask' | 'macrotask';
+interface YieldPolicy {
+    readonly strategy?: YieldStrategy;
+    /**
+     * Only enable yield when historical init cost exceeds this threshold.
+     *
+     * Note: the first run still forces yield (to ensure suspend mode enters pending ASAP).
+     * "First run" is memoized per runtime/session (more robust to remount/HMR).
+     */
+    readonly onlyWhenOverBudgetMs?: number;
+}
+type ModuleHandle = Logix.ModuleImpl<string, Logix.AnyModuleShape, unknown> | Logix.ModuleTagType<string, Logix.AnyModuleShape>;
+interface ModulePreloadPolicy {
+    readonly handles: ReadonlyArray<ModuleHandle>;
+    readonly concurrency?: number;
+    readonly yield?: YieldPolicy;
+}
+interface RuntimeProviderPolicy {
+    readonly mode?: RuntimeProviderPolicyMode;
+    readonly syncBudgetMs?: number;
+    readonly yield?: YieldPolicy;
+    /**
+     * Only effective when mode="defer": pre-initialize critical modules after Provider commit,
+     * avoiding cold start during the subtree's first render.
+     *
+     * - Shorthand: pass handles array directly.
+     * - Full form: pass { handles, concurrency, yield }.
+     */
+    readonly preload?: ReadonlyArray<ModuleHandle> | ModulePreloadPolicy;
+}
+
+interface RuntimeProviderProps {
+    readonly layer?: Layer.Layer<any, any, never>;
+    readonly runtime?: ManagedRuntime.ManagedRuntime<any, any>;
+    readonly children: React.ReactNode;
+    readonly fallback?: React.ReactNode;
+    readonly policy?: RuntimeProviderPolicy;
+    readonly onError?: (cause: Cause.Cause<unknown>, context: RuntimeProviderErrorContext) => Effect.Effect<void>;
+}
+type RuntimeProviderErrorContext = {
+    readonly source: 'provider';
+    readonly phase: 'provider.layer.build';
+} | {
+    readonly source: 'provider';
+    readonly phase: 'debug.lifecycle_error';
+    readonly moduleId?: string;
+    readonly instanceId?: string;
+    readonly runtimeLabel?: string;
+} | {
+    readonly source: 'provider';
+    readonly phase: 'debug.diagnostic_error';
+    readonly code: string;
+    readonly message: string;
+    readonly hint?: string;
+    readonly moduleId?: string;
+    readonly instanceId?: string;
+    readonly runtimeLabel?: string;
+};
+declare const RuntimeProvider: React.FC<RuntimeProviderProps>;
+
+export { type ModuleHandle, type ModulePreloadPolicy, RuntimeProvider, type RuntimeProviderErrorContext, type RuntimeProviderPolicy, type RuntimeProviderPolicyMode, type RuntimeProviderProps, type YieldPolicy, type YieldStrategy };

package/dist/RuntimeProvider.d.ts

@@ -0,0 +1,66 @@
+import React from 'react';
+import { Layer, ManagedRuntime, Cause, Effect } from 'effect';
+import * as Logix from '@logixjs/core';
+
+type RuntimeProviderPolicyMode = 'sync' | 'suspend' | 'defer';
+type YieldStrategy = 'none' | 'microtask' | 'macrotask';
+interface YieldPolicy {
+    readonly strategy?: YieldStrategy;
+    /**
+     * Only enable yield when historical init cost exceeds this threshold.
+     *
+     * Note: the first run still forces yield (to ensure suspend mode enters pending ASAP).
+     * "First run" is memoized per runtime/session (more robust to remount/HMR).
+     */
+    readonly onlyWhenOverBudgetMs?: number;
+}
+type ModuleHandle = Logix.ModuleImpl<string, Logix.AnyModuleShape, unknown> | Logix.ModuleTagType<string, Logix.AnyModuleShape>;
+interface ModulePreloadPolicy {
+    readonly handles: ReadonlyArray<ModuleHandle>;
+    readonly concurrency?: number;
+    readonly yield?: YieldPolicy;
+}
+interface RuntimeProviderPolicy {
+    readonly mode?: RuntimeProviderPolicyMode;
+    readonly syncBudgetMs?: number;
+    readonly yield?: YieldPolicy;
+    /**
+     * Only effective when mode="defer": pre-initialize critical modules after Provider commit,
+     * avoiding cold start during the subtree's first render.
+     *
+     * - Shorthand: pass handles array directly.
+     * - Full form: pass { handles, concurrency, yield }.
+     */
+    readonly preload?: ReadonlyArray<ModuleHandle> | ModulePreloadPolicy;
+}
+
+interface RuntimeProviderProps {
+    readonly layer?: Layer.Layer<any, any, never>;
+    readonly runtime?: ManagedRuntime.ManagedRuntime<any, any>;
+    readonly children: React.ReactNode;
+    readonly fallback?: React.ReactNode;
+    readonly policy?: RuntimeProviderPolicy;
+    readonly onError?: (cause: Cause.Cause<unknown>, context: RuntimeProviderErrorContext) => Effect.Effect<void>;
+}
+type RuntimeProviderErrorContext = {
+    readonly source: 'provider';
+    readonly phase: 'provider.layer.build';
+} | {
+    readonly source: 'provider';
+    readonly phase: 'debug.lifecycle_error';
+    readonly moduleId?: string;
+    readonly instanceId?: string;
+    readonly runtimeLabel?: string;
+} | {
+    readonly source: 'provider';
+    readonly phase: 'debug.diagnostic_error';
+    readonly code: string;
+    readonly message: string;
+    readonly hint?: string;
+    readonly moduleId?: string;
+    readonly instanceId?: string;
+    readonly runtimeLabel?: string;
+};
+declare const RuntimeProvider: React.FC<RuntimeProviderProps>;
+
+export { type ModuleHandle, type ModulePreloadPolicy, RuntimeProvider, type RuntimeProviderErrorContext, type RuntimeProviderPolicy, type RuntimeProviderPolicyMode, type RuntimeProviderProps, type YieldPolicy, type YieldStrategy };

package/dist/RuntimeProvider.js

@@ -0,0 +1,8 @@
+import "./chunk-VFWWMK67.js";
+import {
+  RuntimeProvider
+} from "./chunk-JXAJTWSZ.js";
+import "./chunk-2WFULYPJ.js";
+export {
+  RuntimeProvider
+};