@logixjs/core 0.0.1 → 0.0.2

package/dist/{Runtime-CtyzZG4i.d.ts → Runtime-BWc9YfUB.d.ts}

@@ -1,11 +1,11 @@
 import * as effect from 'effect';
 import { Scope, ManagedRuntime, Layer, Effect } from 'effect';
-import { h as AnyModuleShape, l as ModuleRuntime, o as StateOf, p as ActionOf, B as BoundApi, S as StateTransactionInstrumentation, H as TraitConvergeTimeSlicingPatch, I as TxnLanesPatch, J as StateTransactionTraitConvergeOverrides, e as ConcurrencyPolicy, k as ModuleImpl, K as StateTransactionOverrides, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch } from './module-k7m3txak.js';
-import { A as AnyModule } from './Module-DnzluX2J.js';
-import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-B5q5Bkzx.js';
+import { j as AnyModuleShape, o as ModuleRuntime, r as StateOf, s as ActionOf, B as BoundApi, b as StateTransactionInstrumentation, Z as TraitConvergeTimeSlicingPatch, _ as TxnLanesPatch, $ as StateTransactionTraitConvergeOverrides, g as ConcurrencyPolicy, m as ModuleImpl, a0 as StateTransactionOverrides, h as ConcurrencyPolicyOverrides, i as ConcurrencyPolicyPatch } from './module-DqQ1U-Me.js';
+import { A as AnyModule } from './Module-CFj0I2yE.js';
+import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-ByM7m4Ft.js';
 import { MiddlewareStack } from './EffectOp.js';
-import { g as ReadQueryFallbackReason$1 } from './ReadQuery-SinbStGF.js';
-import { DebugObserverConfig } from './Middleware.js';
+import { R as ReadQueryFallbackReason$1 } from './ReadQuery-CafjlJQo.js';
+import { D as DebugObserverConfig } from './Middleware-DS7CbTTN.js';
 
 interface ProgramRunContext<Sh extends AnyModuleShape> {
     readonly scope: Scope.CloseableScope;
@@ -81,6 +81,14 @@ interface RunProgramOptions<Args = unknown> extends OpenProgramOptions {
     readonly exitCode?: boolean;
     readonly reportError?: boolean;
 }
+type HostSchedulerCancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => HostSchedulerCancel;
+};
 /**
  * Runtime-level StateTransaction defaults.
  *
@@ -132,6 +140,17 @@ interface RuntimeOptions {
      * Optional runtime label (e.g. `AppDemoRuntime`) for Debug / DevTools grouping.
      */
     readonly label?: string;
+    /**
+     * Optional HostScheduler override for this Runtime.
+     *
+     * Use it when you need deterministic host scheduling (tests) or a custom host integration.
+     *
+     * NOTE:
+     * - TickScheduler captures HostScheduler at Layer build-time (073); overriding HostScheduler via `options.layer`
+     *   is not sufficient unless the dependent layer is built under that override.
+     * - This option avoids the pitfall by injecting HostScheduler into the runtime tick services build pipeline.
+     */
+    readonly hostScheduler?: HostScheduler;
     /**
      * Optional Debug console output configuration.
      *
@@ -198,6 +217,16 @@ interface DevtoolsRuntimeOptions {
  * - Exposes a ManagedRuntime; the full Env is provided by `root.layer + options.layer`.
  */
 declare const make: (root: ModuleImpl<any, AnyModuleShape, any> | AnyModule, options?: RuntimeOptions) => ManagedRuntime.ManagedRuntime<any, never>;
+/**
+ * Runtime.batch：
+ * - Provides a stronger "tick boundary" for RuntimeStore/TickScheduler than the default microtask boundary.
+ * - Sync-only: nested batches flatten; only the outermost batch triggers the flush boundary.
+ * - NOT a transaction: no rollback; errors may result in partial commits, but the flush boundary is still released in finally.
+ *
+ * WARNING:
+ * - Do not `await` inside the batch callback expecting mid-flush; batch only establishes a synchronous boundary.
+ */
+declare const batch: <A>(fn: () => A) => A;
 /**
  * Resourceful entry: returns a scope-bound ProgramRunContext (booted and ready).
  */
@@ -260,6 +289,7 @@ type Runtime_RuntimeReadQueryOptions = RuntimeReadQueryOptions;
 type Runtime_RuntimeReadQueryStrictGateOptions = RuntimeReadQueryStrictGateOptions;
 type Runtime_RuntimeStateTransactionOptions = RuntimeStateTransactionOptions;
 declare const Runtime_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const Runtime_batch: typeof batch;
 declare const Runtime_concurrencyPolicyOverridesLayer: typeof concurrencyPolicyOverridesLayer;
 declare const Runtime_make: typeof make;
 declare const Runtime_openProgram: typeof openProgram;
@@ -268,7 +298,7 @@ declare const Runtime_setConcurrencyPolicyOverride: typeof setConcurrencyPolicyO
 declare const Runtime_setTraitConvergeOverride: typeof setTraitConvergeOverride;
 declare const Runtime_stateTransactionOverridesLayer: typeof stateTransactionOverridesLayer;
 declare namespace Runtime {
-  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
+  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_batch as batch, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
 }
 
-export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, concurrencyPolicyOverridesLayer as g, setTraitConvergeOverride as h, setConcurrencyPolicyOverride as i, applyTransactionSnapshot as j, DisposeError as k, DisposeTimeoutError as l, make as m, type ProgramIdentity as n, openProgram as o, type ProgramRunnerErrorTag as p, runProgram as r, stateTransactionOverridesLayer as s };
+export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, batch as g, concurrencyPolicyOverridesLayer as h, setTraitConvergeOverride as i, setConcurrencyPolicyOverride as j, applyTransactionSnapshot as k, DisposeError as l, make as m, DisposeTimeoutError as n, openProgram as o, type ProgramIdentity as p, type ProgramRunnerErrorTag as q, runProgram as r, stateTransactionOverridesLayer as s };

package/dist/{Runtime-B-aL-f29.d.cts → Runtime-PShIC4DW.d.cts}

@@ -1,11 +1,11 @@
 import * as effect from 'effect';
 import { Scope, ManagedRuntime, Layer, Effect } from 'effect';
-import { h as AnyModuleShape, l as ModuleRuntime, o as StateOf, p as ActionOf, B as BoundApi, S as StateTransactionInstrumentation, H as TraitConvergeTimeSlicingPatch, I as TxnLanesPatch, J as StateTransactionTraitConvergeOverrides, e as ConcurrencyPolicy, k as ModuleImpl, K as StateTransactionOverrides, f as ConcurrencyPolicyOverrides, g as ConcurrencyPolicyPatch } from './module-B8CBqIZ_.cjs';
-import { A as AnyModule } from './Module-B_0xRDMR.cjs';
-import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-Bq8Sqjcr.cjs';
+import { j as AnyModuleShape, o as ModuleRuntime, r as StateOf, s as ActionOf, B as BoundApi, b as StateTransactionInstrumentation, Z as TraitConvergeTimeSlicingPatch, _ as TxnLanesPatch, $ as StateTransactionTraitConvergeOverrides, g as ConcurrencyPolicy, m as ModuleImpl, a0 as StateTransactionOverrides, h as ConcurrencyPolicyOverrides, i as ConcurrencyPolicyPatch } from './module-doenaCsZ.cjs';
+import { A as AnyModule } from './Module-DpXPW9EQ.cjs';
+import { z as DebugLayerOptions, b as DiagnosticsLevel, T as TraitConvergeDiagnosticsSamplingConfig } from './Debug-BhMYr-1i.cjs';
 import { MiddlewareStack } from './EffectOp.cjs';
-import { g as ReadQueryFallbackReason$1 } from './ReadQuery-SinbStGF.cjs';
-import { DebugObserverConfig } from './Middleware.cjs';
+import { R as ReadQueryFallbackReason$1 } from './ReadQuery-CafjlJQo.cjs';
+import { D as DebugObserverConfig } from './Middleware-D8tUDLv_.cjs';
 
 interface ProgramRunContext<Sh extends AnyModuleShape> {
     readonly scope: Scope.CloseableScope;
@@ -81,6 +81,14 @@ interface RunProgramOptions<Args = unknown> extends OpenProgramOptions {
     readonly exitCode?: boolean;
     readonly reportError?: boolean;
 }
+type HostSchedulerCancel = () => void;
+type HostScheduler = {
+    readonly nowMs: () => number;
+    readonly scheduleMicrotask: (cb: () => void) => void;
+    readonly scheduleMacrotask: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleAnimationFrame: (cb: () => void) => HostSchedulerCancel;
+    readonly scheduleTimeout: (ms: number, cb: () => void) => HostSchedulerCancel;
+};
 /**
  * Runtime-level StateTransaction defaults.
  *
@@ -132,6 +140,17 @@ interface RuntimeOptions {
      * Optional runtime label (e.g. `AppDemoRuntime`) for Debug / DevTools grouping.
      */
     readonly label?: string;
+    /**
+     * Optional HostScheduler override for this Runtime.
+     *
+     * Use it when you need deterministic host scheduling (tests) or a custom host integration.
+     *
+     * NOTE:
+     * - TickScheduler captures HostScheduler at Layer build-time (073); overriding HostScheduler via `options.layer`
+     *   is not sufficient unless the dependent layer is built under that override.
+     * - This option avoids the pitfall by injecting HostScheduler into the runtime tick services build pipeline.
+     */
+    readonly hostScheduler?: HostScheduler;
     /**
      * Optional Debug console output configuration.
      *
@@ -198,6 +217,16 @@ interface DevtoolsRuntimeOptions {
  * - Exposes a ManagedRuntime; the full Env is provided by `root.layer + options.layer`.
  */
 declare const make: (root: ModuleImpl<any, AnyModuleShape, any> | AnyModule, options?: RuntimeOptions) => ManagedRuntime.ManagedRuntime<any, never>;
+/**
+ * Runtime.batch：
+ * - Provides a stronger "tick boundary" for RuntimeStore/TickScheduler than the default microtask boundary.
+ * - Sync-only: nested batches flatten; only the outermost batch triggers the flush boundary.
+ * - NOT a transaction: no rollback; errors may result in partial commits, but the flush boundary is still released in finally.
+ *
+ * WARNING:
+ * - Do not `await` inside the batch callback expecting mid-flush; batch only establishes a synchronous boundary.
+ */
+declare const batch: <A>(fn: () => A) => A;
 /**
  * Resourceful entry: returns a scope-bound ProgramRunContext (booted and ready).
  */
@@ -260,6 +289,7 @@ type Runtime_RuntimeReadQueryOptions = RuntimeReadQueryOptions;
 type Runtime_RuntimeReadQueryStrictGateOptions = RuntimeReadQueryStrictGateOptions;
 type Runtime_RuntimeStateTransactionOptions = RuntimeStateTransactionOptions;
 declare const Runtime_applyTransactionSnapshot: typeof applyTransactionSnapshot;
+declare const Runtime_batch: typeof batch;
 declare const Runtime_concurrencyPolicyOverridesLayer: typeof concurrencyPolicyOverridesLayer;
 declare const Runtime_make: typeof make;
 declare const Runtime_openProgram: typeof openProgram;
@@ -268,7 +298,7 @@ declare const Runtime_setConcurrencyPolicyOverride: typeof setConcurrencyPolicyO
 declare const Runtime_setTraitConvergeOverride: typeof setTraitConvergeOverride;
 declare const Runtime_stateTransactionOverridesLayer: typeof stateTransactionOverridesLayer;
 declare namespace Runtime {
-  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
+  export { Runtime_BootError as BootError, type Runtime_DevtoolsRuntimeOptions as DevtoolsRuntimeOptions, Runtime_DisposeError as DisposeError, Runtime_DisposeTimeoutError as DisposeTimeoutError, Runtime_MainError as MainError, type Runtime_OpenProgramOptions as OpenProgramOptions, type Runtime_ProgramIdentity as ProgramIdentity, type Runtime_ProgramRunContext as ProgramRunContext, type Runtime_ProgramRunnerErrorTag as ProgramRunnerErrorTag, type Runtime_ReadQueryFallbackReason as ReadQueryFallbackReason, type Runtime_RunProgramOptions as RunProgramOptions, type Runtime_RuntimeOptions as RuntimeOptions, type Runtime_RuntimeReadQueryOptions as RuntimeReadQueryOptions, type Runtime_RuntimeReadQueryStrictGateOptions as RuntimeReadQueryStrictGateOptions, type Runtime_RuntimeStateTransactionOptions as RuntimeStateTransactionOptions, Runtime_applyTransactionSnapshot as applyTransactionSnapshot, Runtime_batch as batch, Runtime_concurrencyPolicyOverridesLayer as concurrencyPolicyOverridesLayer, Runtime_make as make, Runtime_openProgram as openProgram, Runtime_runProgram as runProgram, Runtime_setConcurrencyPolicyOverride as setConcurrencyPolicyOverride, Runtime_setTraitConvergeOverride as setTraitConvergeOverride, Runtime_stateTransactionOverridesLayer as stateTransactionOverridesLayer };
 }
 
-export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, concurrencyPolicyOverridesLayer as g, setTraitConvergeOverride as h, setConcurrencyPolicyOverride as i, applyTransactionSnapshot as j, DisposeError as k, DisposeTimeoutError as l, make as m, type ProgramIdentity as n, openProgram as o, type ProgramRunnerErrorTag as p, runProgram as r, stateTransactionOverridesLayer as s };
+export { BootError as B, type DevtoolsRuntimeOptions as D, MainError as M, type OpenProgramOptions as O, type ProgramRunContext as P, Runtime as R, type RunProgramOptions as a, type RuntimeStateTransactionOptions as b, type ReadQueryFallbackReason as c, type RuntimeReadQueryStrictGateOptions as d, type RuntimeReadQueryOptions as e, type RuntimeOptions as f, batch as g, concurrencyPolicyOverridesLayer as h, setTraitConvergeOverride as i, setConcurrencyPolicyOverride as j, applyTransactionSnapshot as k, DisposeError as l, make as m, DisposeTimeoutError as n, openProgram as o, type ProgramIdentity as p, type ProgramRunnerErrorTag as q, runProgram as r, stateTransactionOverridesLayer as s };