@shadow-js/core 0.1.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +11 -0
- package/LICENSE +2 -2
- package/README.md +134 -331
- package/dist/dev/action.d.ts +36 -0
- package/dist/dev/action.js +90 -0
- package/dist/dev/action.js.map +1 -0
- package/dist/dev/cache.d.ts +35 -0
- package/dist/dev/cache.js +62 -0
- package/dist/dev/cache.js.map +1 -0
- package/dist/dev/context.d.ts +106 -0
- package/dist/dev/context.js +111 -0
- package/dist/dev/context.js.map +1 -0
- package/dist/dev/effect.d.ts +122 -0
- package/dist/dev/effect.js +111 -0
- package/dist/dev/effect.js.map +1 -0
- package/dist/dev/env.d.ts +29 -0
- package/dist/dev/env.js +31 -0
- package/dist/dev/env.js.map +1 -0
- package/dist/dev/events.d.ts +28 -0
- package/dist/dev/events.js +33 -0
- package/dist/dev/events.js.map +1 -0
- package/dist/dev/extend/index.d.ts +331 -0
- package/dist/dev/extend/index.js +317 -0
- package/dist/dev/extend/index.js.map +1 -0
- package/dist/dev/external-store.d.ts +60 -0
- package/dist/dev/external-store.js +60 -0
- package/dist/dev/external-store.js.map +1 -0
- package/dist/dev/index.d.ts +29 -0
- package/dist/dev/index.js +26 -0
- package/dist/dev/internal/concurrency.d.ts +213 -0
- package/dist/dev/internal/concurrency.js +632 -0
- package/dist/dev/internal/concurrency.js.map +1 -0
- package/dist/dev/internal/devtools.d.ts +71 -0
- package/dist/dev/internal/devtools.js +77 -0
- package/dist/dev/internal/devtools.js.map +1 -0
- package/dist/dev/internal/diagnostics.d.ts +90 -0
- package/dist/dev/internal/diagnostics.js +102 -0
- package/dist/dev/internal/diagnostics.js.map +1 -0
- package/dist/dev/internal/dispose.d.ts +28 -0
- package/dist/dev/internal/dispose.js +49 -0
- package/dist/dev/internal/dispose.js.map +1 -0
- package/dist/dev/internal/flags.js +11 -0
- package/dist/dev/internal/flags.js.map +1 -0
- package/dist/dev/internal/graph.d.ts +233 -0
- package/dist/dev/internal/graph.js +578 -0
- package/dist/dev/internal/graph.js.map +1 -0
- package/dist/dev/internal/hydration-flag.d.ts +33 -0
- package/dist/dev/internal/hydration-flag.js +46 -0
- package/dist/dev/internal/hydration-flag.js.map +1 -0
- package/dist/dev/internal/messages.d.ts +56 -0
- package/dist/dev/internal/messages.js +54 -0
- package/dist/dev/internal/messages.js.map +1 -0
- package/dist/dev/internal/owner.d.ts +142 -0
- package/dist/dev/internal/owner.js +290 -0
- package/dist/dev/internal/owner.js.map +1 -0
- package/dist/dev/internal/queue.js +46 -0
- package/dist/dev/internal/queue.js.map +1 -0
- package/dist/dev/internal/scheduler.d.ts +113 -0
- package/dist/dev/internal/scheduler.js +287 -0
- package/dist/dev/internal/scheduler.js.map +1 -0
- package/dist/dev/internal/state.d.ts +141 -0
- package/dist/dev/internal/state.js +28 -0
- package/dist/dev/internal/state.js.map +1 -0
- package/dist/dev/internal/suspension.d.ts +43 -0
- package/dist/dev/internal/suspension.js +45 -0
- package/dist/dev/internal/suspension.js.map +1 -0
- package/dist/dev/internal/types.d.ts +46 -0
- package/dist/dev/list.d.ts +93 -0
- package/dist/dev/list.js +282 -0
- package/dist/dev/list.js.map +1 -0
- package/dist/dev/memo.d.ts +60 -0
- package/dist/dev/memo.js +41 -0
- package/dist/dev/memo.js.map +1 -0
- package/dist/dev/optimistic.d.ts +26 -0
- package/dist/dev/optimistic.js +45 -0
- package/dist/dev/optimistic.js.map +1 -0
- package/dist/dev/ownership.d.ts +204 -0
- package/dist/dev/ownership.js +261 -0
- package/dist/dev/ownership.js.map +1 -0
- package/dist/dev/props.d.ts +134 -0
- package/dist/dev/props.js +282 -0
- package/dist/dev/props.js.map +1 -0
- package/dist/dev/reaction.d.ts +29 -0
- package/dist/dev/reaction.js +61 -0
- package/dist/dev/reaction.js.map +1 -0
- package/dist/dev/reducer.d.ts +41 -0
- package/dist/dev/reducer.js +39 -0
- package/dist/dev/reducer.js.map +1 -0
- package/dist/dev/refs.d.ts +52 -0
- package/dist/dev/refs.js +58 -0
- package/dist/dev/refs.js.map +1 -0
- package/dist/dev/resource.d.ts +135 -0
- package/dist/dev/resource.js +177 -0
- package/dist/dev/resource.js.map +1 -0
- package/dist/dev/selector.d.ts +34 -0
- package/dist/dev/selector.js +118 -0
- package/dist/dev/selector.js.map +1 -0
- package/dist/dev/signal.d.ts +42 -0
- package/dist/dev/signal.js +39 -0
- package/dist/dev/signal.js.map +1 -0
- package/dist/dev/store/index.d.ts +5 -0
- package/dist/dev/store/index.js +4 -0
- package/dist/dev/store/nodes.js +192 -0
- package/dist/dev/store/nodes.js.map +1 -0
- package/dist/dev/store/proxies.js +160 -0
- package/dist/dev/store/proxies.js.map +1 -0
- package/dist/dev/store/read.d.ts +39 -0
- package/dist/dev/store/read.js +72 -0
- package/dist/dev/store/read.js.map +1 -0
- package/dist/dev/store/reconcile.d.ts +73 -0
- package/dist/dev/store/reconcile.js +186 -0
- package/dist/dev/store/reconcile.js.map +1 -0
- package/dist/dev/store/types.d.ts +106 -0
- package/dist/dev/store/use-store.d.ts +60 -0
- package/dist/dev/store/use-store.js +168 -0
- package/dist/dev/store/use-store.js.map +1 -0
- package/dist/dev/suspense.d.ts +101 -0
- package/dist/dev/suspense.js +45 -0
- package/dist/dev/suspense.js.map +1 -0
- package/dist/dev/transitions.d.ts +77 -0
- package/dist/dev/transitions.js +101 -0
- package/dist/dev/transitions.js.map +1 -0
- package/dist/prod/action.js +2 -0
- package/dist/prod/action.js.map +1 -0
- package/dist/prod/cache.js +2 -0
- package/dist/prod/cache.js.map +1 -0
- package/dist/prod/context.js +2 -0
- package/dist/prod/context.js.map +1 -0
- package/dist/prod/effect.js +2 -0
- package/dist/prod/effect.js.map +1 -0
- package/dist/prod/env.js +2 -0
- package/dist/prod/env.js.map +1 -0
- package/dist/prod/events.js +2 -0
- package/dist/prod/events.js.map +1 -0
- package/dist/prod/extend/index.js +2 -0
- package/dist/prod/extend/index.js.map +1 -0
- package/dist/prod/external-store.js +2 -0
- package/dist/prod/external-store.js.map +1 -0
- package/dist/prod/index.js +1 -0
- package/dist/prod/internal/concurrency.js +2 -0
- package/dist/prod/internal/concurrency.js.map +1 -0
- package/dist/prod/internal/devtools.js +2 -0
- package/dist/prod/internal/devtools.js.map +1 -0
- package/dist/prod/internal/diagnostics.js +2 -0
- package/dist/prod/internal/diagnostics.js.map +1 -0
- package/dist/prod/internal/dispose.js +2 -0
- package/dist/prod/internal/dispose.js.map +1 -0
- package/dist/prod/internal/flags.js +2 -0
- package/dist/prod/internal/flags.js.map +1 -0
- package/dist/prod/internal/graph.js +2 -0
- package/dist/prod/internal/graph.js.map +1 -0
- package/dist/prod/internal/hydration-flag.js +2 -0
- package/dist/prod/internal/hydration-flag.js.map +1 -0
- package/dist/prod/internal/messages.js +2 -0
- package/dist/prod/internal/messages.js.map +1 -0
- package/dist/prod/internal/owner.js +2 -0
- package/dist/prod/internal/owner.js.map +1 -0
- package/dist/prod/internal/queue.js +2 -0
- package/dist/prod/internal/queue.js.map +1 -0
- package/dist/prod/internal/scheduler.js +2 -0
- package/dist/prod/internal/scheduler.js.map +1 -0
- package/dist/prod/internal/state.js +2 -0
- package/dist/prod/internal/state.js.map +1 -0
- package/dist/prod/internal/suspension.js +2 -0
- package/dist/prod/internal/suspension.js.map +1 -0
- package/dist/prod/list.js +2 -0
- package/dist/prod/list.js.map +1 -0
- package/dist/prod/memo.js +2 -0
- package/dist/prod/memo.js.map +1 -0
- package/dist/prod/optimistic.js +2 -0
- package/dist/prod/optimistic.js.map +1 -0
- package/dist/prod/ownership.js +2 -0
- package/dist/prod/ownership.js.map +1 -0
- package/dist/prod/props.js +2 -0
- package/dist/prod/props.js.map +1 -0
- package/dist/prod/reaction.js +2 -0
- package/dist/prod/reaction.js.map +1 -0
- package/dist/prod/reducer.js +2 -0
- package/dist/prod/reducer.js.map +1 -0
- package/dist/prod/refs.js +2 -0
- package/dist/prod/refs.js.map +1 -0
- package/dist/prod/resource.js +2 -0
- package/dist/prod/resource.js.map +1 -0
- package/dist/prod/selector.js +2 -0
- package/dist/prod/selector.js.map +1 -0
- package/dist/prod/signal.js +2 -0
- package/dist/prod/signal.js.map +1 -0
- package/dist/prod/store/index.js +1 -0
- package/dist/prod/store/nodes.js +2 -0
- package/dist/prod/store/nodes.js.map +1 -0
- package/dist/prod/store/proxies.js +2 -0
- package/dist/prod/store/proxies.js.map +1 -0
- package/dist/prod/store/read.js +2 -0
- package/dist/prod/store/read.js.map +1 -0
- package/dist/prod/store/reconcile.js +2 -0
- package/dist/prod/store/reconcile.js.map +1 -0
- package/dist/prod/store/use-store.js +2 -0
- package/dist/prod/store/use-store.js.map +1 -0
- package/dist/prod/suspense.js +2 -0
- package/dist/prod/suspense.js.map +1 -0
- package/dist/prod/transitions.js +2 -0
- package/dist/prod/transitions.js.map +1 -0
- package/dist/server/action.js +2 -0
- package/dist/server/action.js.map +1 -0
- package/dist/server/cache.js +2 -0
- package/dist/server/cache.js.map +1 -0
- package/dist/server/context.js +2 -0
- package/dist/server/context.js.map +1 -0
- package/dist/server/effect.js +2 -0
- package/dist/server/effect.js.map +1 -0
- package/dist/server/env.js +2 -0
- package/dist/server/env.js.map +1 -0
- package/dist/server/events.js +2 -0
- package/dist/server/events.js.map +1 -0
- package/dist/server/extend/index.js +2 -0
- package/dist/server/extend/index.js.map +1 -0
- package/dist/server/external-store.js +2 -0
- package/dist/server/external-store.js.map +1 -0
- package/dist/server/index.js +1 -0
- package/dist/server/internal/concurrency.js +2 -0
- package/dist/server/internal/concurrency.js.map +1 -0
- package/dist/server/internal/devtools.js +2 -0
- package/dist/server/internal/devtools.js.map +1 -0
- package/dist/server/internal/diagnostics.js +2 -0
- package/dist/server/internal/diagnostics.js.map +1 -0
- package/dist/server/internal/dispose.js +2 -0
- package/dist/server/internal/dispose.js.map +1 -0
- package/dist/server/internal/flags.js +2 -0
- package/dist/server/internal/flags.js.map +1 -0
- package/dist/server/internal/graph.js +2 -0
- package/dist/server/internal/graph.js.map +1 -0
- package/dist/server/internal/hydration-flag.js +2 -0
- package/dist/server/internal/hydration-flag.js.map +1 -0
- package/dist/server/internal/messages.js +2 -0
- package/dist/server/internal/messages.js.map +1 -0
- package/dist/server/internal/owner.js +2 -0
- package/dist/server/internal/owner.js.map +1 -0
- package/dist/server/internal/queue.js +2 -0
- package/dist/server/internal/queue.js.map +1 -0
- package/dist/server/internal/scheduler.js +2 -0
- package/dist/server/internal/scheduler.js.map +1 -0
- package/dist/server/internal/state.js +2 -0
- package/dist/server/internal/state.js.map +1 -0
- package/dist/server/internal/suspension.js +2 -0
- package/dist/server/internal/suspension.js.map +1 -0
- package/dist/server/list.js +2 -0
- package/dist/server/list.js.map +1 -0
- package/dist/server/memo.js +2 -0
- package/dist/server/memo.js.map +1 -0
- package/dist/server/optimistic.js +2 -0
- package/dist/server/optimistic.js.map +1 -0
- package/dist/server/ownership.js +2 -0
- package/dist/server/ownership.js.map +1 -0
- package/dist/server/props.js +2 -0
- package/dist/server/props.js.map +1 -0
- package/dist/server/reaction.js +2 -0
- package/dist/server/reaction.js.map +1 -0
- package/dist/server/reducer.js +2 -0
- package/dist/server/reducer.js.map +1 -0
- package/dist/server/refs.js +2 -0
- package/dist/server/refs.js.map +1 -0
- package/dist/server/resource.js +2 -0
- package/dist/server/resource.js.map +1 -0
- package/dist/server/selector.js +2 -0
- package/dist/server/selector.js.map +1 -0
- package/dist/server/signal.js +2 -0
- package/dist/server/signal.js.map +1 -0
- package/dist/server/store/index.js +1 -0
- package/dist/server/store/nodes.js +2 -0
- package/dist/server/store/nodes.js.map +1 -0
- package/dist/server/store/proxies.js +2 -0
- package/dist/server/store/proxies.js.map +1 -0
- package/dist/server/store/read.js +2 -0
- package/dist/server/store/read.js.map +1 -0
- package/dist/server/store/reconcile.js +2 -0
- package/dist/server/store/reconcile.js.map +1 -0
- package/dist/server/store/use-store.js +2 -0
- package/dist/server/store/use-store.js.map +1 -0
- package/dist/server/suspense.js +2 -0
- package/dist/server/suspense.js.map +1 -0
- package/dist/server/transitions.js +2 -0
- package/dist/server/transitions.js.map +1 -0
- package/dist/server-dev/action.js +90 -0
- package/dist/server-dev/action.js.map +1 -0
- package/dist/server-dev/cache.js +62 -0
- package/dist/server-dev/cache.js.map +1 -0
- package/dist/server-dev/context.js +108 -0
- package/dist/server-dev/context.js.map +1 -0
- package/dist/server-dev/effect.js +56 -0
- package/dist/server-dev/effect.js.map +1 -0
- package/dist/server-dev/env.js +31 -0
- package/dist/server-dev/env.js.map +1 -0
- package/dist/server-dev/events.js +33 -0
- package/dist/server-dev/events.js.map +1 -0
- package/dist/server-dev/extend/index.js +317 -0
- package/dist/server-dev/extend/index.js.map +1 -0
- package/dist/server-dev/external-store.js +46 -0
- package/dist/server-dev/external-store.js.map +1 -0
- package/dist/server-dev/index.js +26 -0
- package/dist/server-dev/internal/concurrency.js +633 -0
- package/dist/server-dev/internal/concurrency.js.map +1 -0
- package/dist/server-dev/internal/devtools.js +77 -0
- package/dist/server-dev/internal/devtools.js.map +1 -0
- package/dist/server-dev/internal/diagnostics.js +102 -0
- package/dist/server-dev/internal/diagnostics.js.map +1 -0
- package/dist/server-dev/internal/dispose.js +49 -0
- package/dist/server-dev/internal/dispose.js.map +1 -0
- package/dist/server-dev/internal/flags.js +11 -0
- package/dist/server-dev/internal/flags.js.map +1 -0
- package/dist/server-dev/internal/graph.js +578 -0
- package/dist/server-dev/internal/graph.js.map +1 -0
- package/dist/server-dev/internal/hydration-flag.js +46 -0
- package/dist/server-dev/internal/hydration-flag.js.map +1 -0
- package/dist/server-dev/internal/messages.js +54 -0
- package/dist/server-dev/internal/messages.js.map +1 -0
- package/dist/server-dev/internal/owner.js +290 -0
- package/dist/server-dev/internal/owner.js.map +1 -0
- package/dist/server-dev/internal/queue.js +46 -0
- package/dist/server-dev/internal/queue.js.map +1 -0
- package/dist/server-dev/internal/scheduler.js +287 -0
- package/dist/server-dev/internal/scheduler.js.map +1 -0
- package/dist/server-dev/internal/state.js +28 -0
- package/dist/server-dev/internal/state.js.map +1 -0
- package/dist/server-dev/internal/suspension.js +45 -0
- package/dist/server-dev/internal/suspension.js.map +1 -0
- package/dist/server-dev/list.js +282 -0
- package/dist/server-dev/list.js.map +1 -0
- package/dist/server-dev/memo.js +41 -0
- package/dist/server-dev/memo.js.map +1 -0
- package/dist/server-dev/optimistic.js +45 -0
- package/dist/server-dev/optimistic.js.map +1 -0
- package/dist/server-dev/ownership.js +261 -0
- package/dist/server-dev/ownership.js.map +1 -0
- package/dist/server-dev/props.js +282 -0
- package/dist/server-dev/props.js.map +1 -0
- package/dist/server-dev/reaction.js +61 -0
- package/dist/server-dev/reaction.js.map +1 -0
- package/dist/server-dev/reducer.js +39 -0
- package/dist/server-dev/reducer.js.map +1 -0
- package/dist/server-dev/refs.js +58 -0
- package/dist/server-dev/refs.js.map +1 -0
- package/dist/server-dev/resource.js +176 -0
- package/dist/server-dev/resource.js.map +1 -0
- package/dist/server-dev/selector.js +82 -0
- package/dist/server-dev/selector.js.map +1 -0
- package/dist/server-dev/signal.js +39 -0
- package/dist/server-dev/signal.js.map +1 -0
- package/dist/server-dev/store/index.js +4 -0
- package/dist/server-dev/store/nodes.js +192 -0
- package/dist/server-dev/store/nodes.js.map +1 -0
- package/dist/server-dev/store/proxies.js +160 -0
- package/dist/server-dev/store/proxies.js.map +1 -0
- package/dist/server-dev/store/read.js +72 -0
- package/dist/server-dev/store/read.js.map +1 -0
- package/dist/server-dev/store/reconcile.js +186 -0
- package/dist/server-dev/store/reconcile.js.map +1 -0
- package/dist/server-dev/store/use-store.js +168 -0
- package/dist/server-dev/store/use-store.js.map +1 -0
- package/dist/server-dev/suspense.js +45 -0
- package/dist/server-dev/suspense.js.map +1 -0
- package/dist/server-dev/transitions.js +86 -0
- package/dist/server-dev/transitions.js.map +1 -0
- package/package.json +111 -50
- package/dist/chunk-6Y3CCWOY.js +0 -887
- package/dist/chunk-6Y3CCWOY.js.map +0 -1
- package/dist/chunk-B5FTYDUG.js +0 -3
- package/dist/chunk-B5FTYDUG.js.map +0 -1
- package/dist/index.cjs +0 -2000
- package/dist/index.cjs.map +0 -1
- package/dist/index.d.cts +0 -609
- package/dist/index.d.ts +0 -609
- package/dist/index.js +0 -1094
- package/dist/index.js.map +0 -1
- package/dist/jsx-Bugil6CJ.d.cts +0 -151
- package/dist/jsx-Bugil6CJ.d.ts +0 -151
- package/dist/jsx-dev-runtime.cjs +0 -742
- package/dist/jsx-dev-runtime.cjs.map +0 -1
- package/dist/jsx-dev-runtime.d.cts +0 -2
- package/dist/jsx-dev-runtime.d.ts +0 -2
- package/dist/jsx-dev-runtime.js +0 -4
- package/dist/jsx-dev-runtime.js.map +0 -1
- package/dist/jsx-runtime.cjs +0 -742
- package/dist/jsx-runtime.cjs.map +0 -1
- package/dist/jsx-runtime.d.cts +0 -36
- package/dist/jsx-runtime.d.ts +0 -36
- package/dist/jsx-runtime.js +0 -4
- package/dist/jsx-runtime.js.map +0 -1
|
@@ -0,0 +1,633 @@
|
|
|
1
|
+
import { DEVTOOLS_EVENT, report } from "./devtools.js";
|
|
2
|
+
import { ShadowError } from "./diagnostics.js";
|
|
3
|
+
import { FLAG_PARKED, FLAG_SUSPENDED, FLAG_TRANSITION } from "./flags.js";
|
|
4
|
+
import { rt } from "./state.js";
|
|
5
|
+
import { Owner, addCleanup, handleError } from "./owner.js";
|
|
6
|
+
import { clearQueues, hasPending, place, renderQueue, userQueue } from "./queue.js";
|
|
7
|
+
import { Computation, Signal, hasObservers, markObservers, readSignal, recompute, updateIfNecessary } from "./graph.js";
|
|
8
|
+
import { byCreation, isOrdered, reportUncaught, schedule } from "./scheduler.js";
|
|
9
|
+
import { runWithContext } from "../context.js";
|
|
10
|
+
import { SuspenseContext } from "../suspense.js";
|
|
11
|
+
import { disposeTree } from "./dispose.js";
|
|
12
|
+
import { SUSPENSION, isSuspension } from "./suspension.js";
|
|
13
|
+
//#region src/internal/concurrency.ts
|
|
14
|
+
/** Transition-lane effects run per macrotask; between two chunks urgent work and input can run. */
|
|
15
|
+
const LANE_CHUNK = 64;
|
|
16
|
+
/** Visits `root` and every node below it. Iterative: the depth is user controlled. */
|
|
17
|
+
function walk(root, visit) {
|
|
18
|
+
const stack = [root];
|
|
19
|
+
while (stack.length > 0) {
|
|
20
|
+
const node = stack.pop();
|
|
21
|
+
if (node === void 0) break;
|
|
22
|
+
visit(node);
|
|
23
|
+
for (let child = node.lastChild; child !== null; child = child.prevSibling) stack.push(child);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
/** Creates the transition machinery. Called once, by the first API that needs it. */
|
|
27
|
+
function createHooks() {
|
|
28
|
+
const laneRender = [];
|
|
29
|
+
const laneUser = [];
|
|
30
|
+
/** Resolvers of the transitions waiting for the lane to go idle. */
|
|
31
|
+
const waiters = [];
|
|
32
|
+
/** Memos and effects that caught a suspension; woken all at once when a boundary releases them. */
|
|
33
|
+
const suspended = [];
|
|
34
|
+
/** Suspense boundaries currently holding a transition (the lane is busy while any holds). */
|
|
35
|
+
let holds = 0;
|
|
36
|
+
let scheduled = false;
|
|
37
|
+
const hasLanePending = () => laneRender.length > 0 || laneUser.length > 0;
|
|
38
|
+
const laneBusy = () => hasLanePending() || holds > 0;
|
|
39
|
+
/**
|
|
40
|
+
* Runs one chunk of a lane queue. An entry without FLAG_TRANSITION was promoted to the urgent queue
|
|
41
|
+
* after it was queued here; it is skipped (the urgent queue owns its FLAG_QUEUED).
|
|
42
|
+
*/
|
|
43
|
+
const drainLane = (queue, limit) => {
|
|
44
|
+
const batch = queue.splice(0, limit);
|
|
45
|
+
if (!isOrdered(batch)) batch.sort(byCreation);
|
|
46
|
+
for (const effect of batch) {
|
|
47
|
+
if ((effect.flags & 1024) === 0) continue;
|
|
48
|
+
effect.flags &= ~(2 | FLAG_TRANSITION);
|
|
49
|
+
if ((effect.flags & 4) !== 0) continue;
|
|
50
|
+
if (effect.pauses > 0) {
|
|
51
|
+
effect.flags |= FLAG_PARKED | FLAG_TRANSITION;
|
|
52
|
+
continue;
|
|
53
|
+
}
|
|
54
|
+
try {
|
|
55
|
+
if (effect.state === 2) recompute(effect);
|
|
56
|
+
else updateIfNecessary(effect);
|
|
57
|
+
} catch (error) {
|
|
58
|
+
handleError(error, effect);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return batch.length;
|
|
62
|
+
};
|
|
63
|
+
/** Resolves the transitions that wait for the lane, once the lane is idle. */
|
|
64
|
+
const settleLane = () => {
|
|
65
|
+
if (laneBusy() || waiters.length === 0) return;
|
|
66
|
+
const resolved = waiters.splice(0, waiters.length);
|
|
67
|
+
report(DEVTOOLS_EVENT.TRANSITION_END, resolved.length);
|
|
68
|
+
for (const resolve of resolved) resolve();
|
|
69
|
+
};
|
|
70
|
+
/** Asks for one lane macrotask (the timer lets the browser paint and take input first). */
|
|
71
|
+
const scheduleLane = () => {
|
|
72
|
+
if (scheduled) return;
|
|
73
|
+
scheduled = true;
|
|
74
|
+
setTimeout(flushLane, 0);
|
|
75
|
+
};
|
|
76
|
+
/**
|
|
77
|
+
* Runs the transition lane: one chunk per macrotask, render effects first. Writes made here belong to
|
|
78
|
+
* the lane, so the effects they wake join it. Errors nobody handled are reported, not thrown, because
|
|
79
|
+
* no caller is waiting for this macrotask.
|
|
80
|
+
*/
|
|
81
|
+
const flushLane = () => {
|
|
82
|
+
scheduled = false;
|
|
83
|
+
if (rt.flushing) {
|
|
84
|
+
scheduleLane();
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
const previous = rt.inTransition;
|
|
88
|
+
rt.inTransition = true;
|
|
89
|
+
rt.flushing = true;
|
|
90
|
+
let budget = LANE_CHUNK;
|
|
91
|
+
let passes = 0;
|
|
92
|
+
try {
|
|
93
|
+
while (budget > 0 && hasLanePending()) {
|
|
94
|
+
passes += 1;
|
|
95
|
+
if (passes > 1e3) {
|
|
96
|
+
clearQueues();
|
|
97
|
+
rt.uncaught.push(new ShadowError("INFINITE_LOOP"));
|
|
98
|
+
break;
|
|
99
|
+
}
|
|
100
|
+
const queue = laneRender.length > 0 ? laneRender : laneUser;
|
|
101
|
+
budget -= drainLane(queue, budget);
|
|
102
|
+
}
|
|
103
|
+
} finally {
|
|
104
|
+
rt.inTransition = previous;
|
|
105
|
+
rt.flushing = false;
|
|
106
|
+
}
|
|
107
|
+
const errors = rt.uncaught.splice(0, rt.uncaught.length);
|
|
108
|
+
for (const error of errors) reportUncaught(error);
|
|
109
|
+
if (hasLanePending()) scheduleLane();
|
|
110
|
+
else settleLane();
|
|
111
|
+
if (hasPending()) schedule();
|
|
112
|
+
};
|
|
113
|
+
const startTransition = (fn) => {
|
|
114
|
+
const previous = rt.inTransition;
|
|
115
|
+
const listener = rt.listener;
|
|
116
|
+
rt.inTransition = true;
|
|
117
|
+
rt.listener = null;
|
|
118
|
+
try {
|
|
119
|
+
fn();
|
|
120
|
+
} finally {
|
|
121
|
+
rt.inTransition = previous;
|
|
122
|
+
rt.listener = listener;
|
|
123
|
+
}
|
|
124
|
+
report(DEVTOOLS_EVENT.TRANSITION_START);
|
|
125
|
+
const applied = new Promise((resolve) => {
|
|
126
|
+
waiters.push(resolve);
|
|
127
|
+
});
|
|
128
|
+
settleLane();
|
|
129
|
+
return applied;
|
|
130
|
+
};
|
|
131
|
+
/** The hook's `place`: parks a paused effect or queues a lane effect. */
|
|
132
|
+
const parkOrLane = (effect, inLane) => {
|
|
133
|
+
if (effect.pauses > 0) {
|
|
134
|
+
effect.flags = inLane ? effect.flags | FLAG_PARKED | FLAG_TRANSITION : (effect.flags | FLAG_PARKED) & ~FLAG_TRANSITION;
|
|
135
|
+
return;
|
|
136
|
+
}
|
|
137
|
+
const render = (effect.flags & 16) !== 0;
|
|
138
|
+
effect.flags = effect.flags & ~FLAG_PARKED | 2 | FLAG_TRANSITION;
|
|
139
|
+
if (render) laneRender.push(effect);
|
|
140
|
+
else laneUser.push(effect);
|
|
141
|
+
scheduleLane();
|
|
142
|
+
};
|
|
143
|
+
const promote = (effect) => {
|
|
144
|
+
if ((effect.flags & 512) !== 0 || effect.pauses > 0) return;
|
|
145
|
+
if ((effect.flags & 2048) !== 0) {
|
|
146
|
+
place(effect, false);
|
|
147
|
+
return;
|
|
148
|
+
}
|
|
149
|
+
if ((effect.flags & 1026) !== 1026) return;
|
|
150
|
+
effect.flags &= ~FLAG_TRANSITION;
|
|
151
|
+
if ((effect.flags & 16) !== 0) renderQueue.push(effect);
|
|
152
|
+
else userQueue.push(effect);
|
|
153
|
+
};
|
|
154
|
+
const clear = () => {
|
|
155
|
+
for (const queue of [laneRender, laneUser]) {
|
|
156
|
+
for (const effect of queue) {
|
|
157
|
+
effect.flags &= ~(2 | FLAG_TRANSITION);
|
|
158
|
+
effect.state = 0;
|
|
159
|
+
}
|
|
160
|
+
queue.length = 0;
|
|
161
|
+
}
|
|
162
|
+
};
|
|
163
|
+
const suspend = (node, error) => {
|
|
164
|
+
if (error !== SUSPENSION) return false;
|
|
165
|
+
node.flags |= FLAG_SUSPENDED;
|
|
166
|
+
suspended.push(node);
|
|
167
|
+
return true;
|
|
168
|
+
};
|
|
169
|
+
const holdReader = (tracker) => {
|
|
170
|
+
if (tracker.hold?.() === true) throw SUSPENSION;
|
|
171
|
+
};
|
|
172
|
+
const beginHold = () => {
|
|
173
|
+
holds += 1;
|
|
174
|
+
};
|
|
175
|
+
const endHold = () => {
|
|
176
|
+
if (holds > 0) holds -= 1;
|
|
177
|
+
if (hasLanePending()) scheduleLane();
|
|
178
|
+
settleLane();
|
|
179
|
+
};
|
|
180
|
+
const wakeSuspended = () => {
|
|
181
|
+
const waiting = suspended.splice(0, suspended.length);
|
|
182
|
+
const previous = rt.inTransition;
|
|
183
|
+
rt.inTransition = true;
|
|
184
|
+
try {
|
|
185
|
+
for (const node of waiting) {
|
|
186
|
+
if ((node.flags & 4096) === 0 || node.disposed) continue;
|
|
187
|
+
node.flags &= ~FLAG_SUSPENDED;
|
|
188
|
+
node.state = 2;
|
|
189
|
+
if (node.kind === 2) place(node, true);
|
|
190
|
+
else markObservers(node);
|
|
191
|
+
}
|
|
192
|
+
} finally {
|
|
193
|
+
rt.inTransition = previous;
|
|
194
|
+
}
|
|
195
|
+
schedule();
|
|
196
|
+
};
|
|
197
|
+
const pause = (owner) => {
|
|
198
|
+
walk(owner, (node) => {
|
|
199
|
+
node.pauses += 1;
|
|
200
|
+
if (node instanceof Computation && node.kind === 2 && (node.flags & 16) === 0 && !node.disposed) node.runCleanups();
|
|
201
|
+
});
|
|
202
|
+
};
|
|
203
|
+
const createHold = (onSettled) => {
|
|
204
|
+
let count = 0;
|
|
205
|
+
let holding = false;
|
|
206
|
+
let engagedOnce = false;
|
|
207
|
+
const tracker = {
|
|
208
|
+
increment() {
|
|
209
|
+
count += 1;
|
|
210
|
+
},
|
|
211
|
+
decrement() {
|
|
212
|
+
count -= 1;
|
|
213
|
+
if (count !== 0) return;
|
|
214
|
+
if (holding) {
|
|
215
|
+
holding = false;
|
|
216
|
+
wakeSuspended();
|
|
217
|
+
endHold();
|
|
218
|
+
}
|
|
219
|
+
onSettled();
|
|
220
|
+
},
|
|
221
|
+
hold() {
|
|
222
|
+
engagedOnce = true;
|
|
223
|
+
if (!holding) {
|
|
224
|
+
holding = true;
|
|
225
|
+
beginHold();
|
|
226
|
+
}
|
|
227
|
+
return true;
|
|
228
|
+
}
|
|
229
|
+
};
|
|
230
|
+
return {
|
|
231
|
+
run: (fn) => runWithContext(SuspenseContext, tracker, fn),
|
|
232
|
+
count: () => count,
|
|
233
|
+
engaged: () => engagedOnce,
|
|
234
|
+
drop: () => {
|
|
235
|
+
if (!holding) return;
|
|
236
|
+
holding = false;
|
|
237
|
+
endHold();
|
|
238
|
+
}
|
|
239
|
+
};
|
|
240
|
+
};
|
|
241
|
+
const resume = (owner) => {
|
|
242
|
+
walk(owner, (node) => {
|
|
243
|
+
if (node.pauses > 0) node.pauses -= 1;
|
|
244
|
+
if (!(node instanceof Computation) || node.pauses !== 0 || node.disposed) return;
|
|
245
|
+
if (node.kind === 2) {
|
|
246
|
+
if ((node.flags & 16) !== 0 && (node.flags & 2048) === 0) return;
|
|
247
|
+
node.state = 2;
|
|
248
|
+
place(node, false);
|
|
249
|
+
} else if (node.state !== 0) markObservers(node);
|
|
250
|
+
});
|
|
251
|
+
schedule();
|
|
252
|
+
};
|
|
253
|
+
/** A Suspense boundary's hold: engaged by a transition read, released when its data arrived. */
|
|
254
|
+
const boundaryHold = () => {
|
|
255
|
+
let holding = false;
|
|
256
|
+
return {
|
|
257
|
+
engage: () => {
|
|
258
|
+
if (!holding) {
|
|
259
|
+
holding = true;
|
|
260
|
+
beginHold();
|
|
261
|
+
}
|
|
262
|
+
return true;
|
|
263
|
+
},
|
|
264
|
+
release: () => {
|
|
265
|
+
if (!holding) return;
|
|
266
|
+
holding = false;
|
|
267
|
+
wakeSuspended();
|
|
268
|
+
endHold();
|
|
269
|
+
},
|
|
270
|
+
holding: () => holding
|
|
271
|
+
};
|
|
272
|
+
};
|
|
273
|
+
/**
|
|
274
|
+
* The transition layer of one branch slot (Show, Switch). A change made during a transition, while a
|
|
275
|
+
* branch is on screen, builds the new branch under a hold and keeps the shown one until the hold
|
|
276
|
+
* settles; then it commits. The slot's output memo calls `step` first, so the usual path (its own
|
|
277
|
+
* teardown) only runs when no transition is involved. Its state lives in `state`, which the memo
|
|
278
|
+
* reads and writes.
|
|
279
|
+
*/
|
|
280
|
+
const slotSwap = (state, build, same, parent) => {
|
|
281
|
+
/** A transition's branch waiting for its reads; the shown branch stays until it is ready. */
|
|
282
|
+
let pending;
|
|
283
|
+
/** Owns the branches built during transitions: they live as long as the slot's owner. */
|
|
284
|
+
const holder = new Owner(parent);
|
|
285
|
+
/** Counts the settled holds; the memo reads it, so it runs again when a pending branch is ready. */
|
|
286
|
+
const settled = new Signal(0, false, void 0);
|
|
287
|
+
const settle = () => {
|
|
288
|
+
settled.value += 1;
|
|
289
|
+
if (hasObservers(settled)) {
|
|
290
|
+
markObservers(settled);
|
|
291
|
+
schedule();
|
|
292
|
+
}
|
|
293
|
+
};
|
|
294
|
+
/** Tears a branch down. Its owner is marked `disposing` first (see the accessors of Show). */
|
|
295
|
+
const retireBranch = (branch) => {
|
|
296
|
+
branch.owned.disposing = true;
|
|
297
|
+
try {
|
|
298
|
+
branch.hold?.drop();
|
|
299
|
+
branch.dispose?.();
|
|
300
|
+
} finally {
|
|
301
|
+
branch.owned.disposing = false;
|
|
302
|
+
}
|
|
303
|
+
};
|
|
304
|
+
const commit = (branch) => {
|
|
305
|
+
const previous = state.live;
|
|
306
|
+
state.live = branch;
|
|
307
|
+
if (previous !== void 0) retireBranch(previous);
|
|
308
|
+
};
|
|
309
|
+
/** Builds a transition's branch under the holder. A held read leaves it pending, not shown. */
|
|
310
|
+
const buildPending = (choice) => {
|
|
311
|
+
const owned = {
|
|
312
|
+
index: choice.index,
|
|
313
|
+
value: choice.when,
|
|
314
|
+
disposing: false
|
|
315
|
+
};
|
|
316
|
+
const hold = createHold(() => {
|
|
317
|
+
if (pending !== void 0 && pending.hold === hold) settle();
|
|
318
|
+
});
|
|
319
|
+
const root = new Owner(holder);
|
|
320
|
+
const previousOwner = rt.owner;
|
|
321
|
+
const previousListener = rt.listener;
|
|
322
|
+
rt.owner = root;
|
|
323
|
+
rt.listener = null;
|
|
324
|
+
let result;
|
|
325
|
+
try {
|
|
326
|
+
try {
|
|
327
|
+
result = hold.run(() => build(choice, owned, true));
|
|
328
|
+
} catch (error) {
|
|
329
|
+
if (!isSuspension(error)) throw error;
|
|
330
|
+
}
|
|
331
|
+
const marker = new Owner(root);
|
|
332
|
+
addCleanup(marker, () => {
|
|
333
|
+
owned.disposing = true;
|
|
334
|
+
});
|
|
335
|
+
} finally {
|
|
336
|
+
rt.owner = previousOwner;
|
|
337
|
+
rt.listener = previousListener;
|
|
338
|
+
}
|
|
339
|
+
return {
|
|
340
|
+
choice,
|
|
341
|
+
owned,
|
|
342
|
+
result,
|
|
343
|
+
dispose: () => disposeTree(root),
|
|
344
|
+
hold: hold.engaged() ? hold : null
|
|
345
|
+
};
|
|
346
|
+
};
|
|
347
|
+
return { step(choice) {
|
|
348
|
+
readSignal(settled);
|
|
349
|
+
if (pending !== void 0) {
|
|
350
|
+
if (!same(pending.choice, choice)) {
|
|
351
|
+
const dropped = pending;
|
|
352
|
+
pending = void 0;
|
|
353
|
+
dropped.hold?.drop();
|
|
354
|
+
dropped.dispose?.();
|
|
355
|
+
} else if ((pending.hold?.count() ?? 0) > 0) return true;
|
|
356
|
+
else {
|
|
357
|
+
const ready = pending;
|
|
358
|
+
pending = void 0;
|
|
359
|
+
commit(ready);
|
|
360
|
+
return true;
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
if (state.live !== void 0 && rt.inTransition) {
|
|
364
|
+
const built = buildPending(choice);
|
|
365
|
+
if (built.hold === null) commit(built);
|
|
366
|
+
else pending = built;
|
|
367
|
+
return true;
|
|
368
|
+
}
|
|
369
|
+
const live = state.live;
|
|
370
|
+
state.live = void 0;
|
|
371
|
+
if (live !== void 0) retireBranch(live);
|
|
372
|
+
return false;
|
|
373
|
+
} };
|
|
374
|
+
};
|
|
375
|
+
return {
|
|
376
|
+
place: parkOrLane,
|
|
377
|
+
promote,
|
|
378
|
+
clear,
|
|
379
|
+
suspend,
|
|
380
|
+
holdReader,
|
|
381
|
+
startTransition,
|
|
382
|
+
beginHold,
|
|
383
|
+
endHold,
|
|
384
|
+
wakeSuspended,
|
|
385
|
+
pause,
|
|
386
|
+
resume,
|
|
387
|
+
createHold,
|
|
388
|
+
slotSwap,
|
|
389
|
+
boundaryHold
|
|
390
|
+
};
|
|
391
|
+
}
|
|
392
|
+
/** Installs the transition machinery on first use; later calls return the same hooks. */
|
|
393
|
+
function ensureHooks() {
|
|
394
|
+
const existing = rt.hooks;
|
|
395
|
+
if (existing !== null) return existing;
|
|
396
|
+
const created = createHooks();
|
|
397
|
+
rt.hooks = created;
|
|
398
|
+
return created;
|
|
399
|
+
}
|
|
400
|
+
/**
|
|
401
|
+
* Installs the transition machinery (the transition lane, Activity pauses and Suspense holds) now
|
|
402
|
+
* instead of at the first `startTransition`. The machinery is created on first use so that an
|
|
403
|
+
* application that never uses transitions does not carry its code; call this from a primitive whose
|
|
404
|
+
* later work needs the lane to exist, as `useDeferredValue` does. Calling it again does nothing.
|
|
405
|
+
*
|
|
406
|
+
* @example
|
|
407
|
+
* import { registerTransitionLane } from "@shadow-js/core/extend";
|
|
408
|
+
*
|
|
409
|
+
* export function useBackgroundValue(): void {
|
|
410
|
+
* registerTransitionLane(); // later lane-only effects of this hook find the lane
|
|
411
|
+
* }
|
|
412
|
+
* @see startTransition
|
|
413
|
+
* @since 1.0.0
|
|
414
|
+
*/
|
|
415
|
+
function registerTransitionLane() {
|
|
416
|
+
ensureHooks();
|
|
417
|
+
}
|
|
418
|
+
/**
|
|
419
|
+
* Runs `fn` as a transition: the effects its writes wake wait in the transition lane, which runs
|
|
420
|
+
* after urgent work (in a macrotask, one chunk at a time). Reads see the writes at once; the DOM
|
|
421
|
+
* catches up when the lane runs. Use it for an update that may be slow to render or load, so input
|
|
422
|
+
* stays responsive and a Suspense boundary keeps its content instead of showing its fallback. `fn`
|
|
423
|
+
* runs untracked. The returned promise resolves when the lane is idle and no Suspense boundary holds
|
|
424
|
+
* the transition.
|
|
425
|
+
*
|
|
426
|
+
* On the server there are no effects, so `fn` simply runs and the promise is already resolved.
|
|
427
|
+
*
|
|
428
|
+
* @param fn Callback whose writes form the transition.
|
|
429
|
+
* @returns A promise that resolves when the transition has been applied.
|
|
430
|
+
* @throws What `fn` throws, synchronously; no transition is started then.
|
|
431
|
+
* @example
|
|
432
|
+
* import { startTransition, useSignal } from "@shadow-js/core";
|
|
433
|
+
*
|
|
434
|
+
* const [page, setPage] = useSignal("home");
|
|
435
|
+
* async function openReports(): Promise<void> {
|
|
436
|
+
* await startTransition(() => setPage("reports"));
|
|
437
|
+
* console.log(`${page()} is on screen`);
|
|
438
|
+
* }
|
|
439
|
+
* @see inTransition
|
|
440
|
+
* @since 1.0.0
|
|
441
|
+
*/
|
|
442
|
+
function startTransition(fn) {
|
|
443
|
+
fn();
|
|
444
|
+
return Promise.resolve();
|
|
445
|
+
}
|
|
446
|
+
/**
|
|
447
|
+
* Starts a Suspense hold: the boundary keeps showing its current content while a transition waits
|
|
448
|
+
* for data. Holds are counted, and the running transitions stay pending (`isPending` of
|
|
449
|
+
* `useTransition`, the promise of `startTransition`) until every hold has ended. For renderers that
|
|
450
|
+
* implement Suspense; each call needs one {@link endHold}. Does nothing before the transition
|
|
451
|
+
* machinery exists (no transition has run).
|
|
452
|
+
*
|
|
453
|
+
* @example
|
|
454
|
+
* import { beginHold, endHold, wakeSuspended } from "@shadow-js/core/extend";
|
|
455
|
+
*
|
|
456
|
+
* export function holdUntil(data: Promise<unknown>): void {
|
|
457
|
+
* beginHold(); // the boundary keeps its content
|
|
458
|
+
* void data.finally(() => {
|
|
459
|
+
* wakeSuspended();
|
|
460
|
+
* endHold();
|
|
461
|
+
* });
|
|
462
|
+
* }
|
|
463
|
+
* @see endHold
|
|
464
|
+
* @since 1.0.0
|
|
465
|
+
*/
|
|
466
|
+
function beginHold() {
|
|
467
|
+
rt.hooks?.beginHold();
|
|
468
|
+
}
|
|
469
|
+
/**
|
|
470
|
+
* Ends a Suspense hold started with {@link beginHold}. Call {@link wakeSuspended} first, so the
|
|
471
|
+
* memos and effects that waited are queued; this then schedules the lane for them and, once the lane
|
|
472
|
+
* is idle and no hold remains, resolves the transitions that were waiting. Extra calls never take the
|
|
473
|
+
* count below zero. Does nothing before the transition machinery exists.
|
|
474
|
+
*
|
|
475
|
+
* @example
|
|
476
|
+
* import { endHold, wakeSuspended } from "@shadow-js/core/extend";
|
|
477
|
+
*
|
|
478
|
+
* export function release(): void {
|
|
479
|
+
* wakeSuspended(); // the held readers run again with the data that arrived
|
|
480
|
+
* endHold();
|
|
481
|
+
* }
|
|
482
|
+
* @see beginHold
|
|
483
|
+
* @since 1.0.0
|
|
484
|
+
*/
|
|
485
|
+
function endHold() {
|
|
486
|
+
rt.hooks?.endHold();
|
|
487
|
+
}
|
|
488
|
+
/**
|
|
489
|
+
* Wakes every memo and effect that kept its value for a transition (it caught {@link SUSPENSION}):
|
|
490
|
+
* each runs again in the transition lane, so it reads the data that arrived. A Suspense boundary
|
|
491
|
+
* calls it when it releases its hold, before {@link endHold}. Does nothing before the transition
|
|
492
|
+
* machinery exists.
|
|
493
|
+
*
|
|
494
|
+
* @example
|
|
495
|
+
* import { endHold, wakeSuspended } from "@shadow-js/core/extend";
|
|
496
|
+
*
|
|
497
|
+
* export function onDataArrived(): void {
|
|
498
|
+
* wakeSuspended();
|
|
499
|
+
* endHold();
|
|
500
|
+
* }
|
|
501
|
+
* @see endHold
|
|
502
|
+
* @since 1.0.0
|
|
503
|
+
*/
|
|
504
|
+
function wakeSuspended() {
|
|
505
|
+
rt.hooks?.wakeSuspended();
|
|
506
|
+
}
|
|
507
|
+
/**
|
|
508
|
+
* Lets a pending read inside a transition keep the boundary's content: when the tracker's `hold()`
|
|
509
|
+
* returns true (the boundary holds its content for the transition), the reader throws
|
|
510
|
+
* {@link SUSPENSION} and keeps its previous value until the boundary wakes it. Call it from a data
|
|
511
|
+
* primitive's reader when its data is pending, the reader is tracked and {@link inTransition} is
|
|
512
|
+
* true, as `useResource` does. Does nothing before the transition machinery exists, or when the
|
|
513
|
+
* tracker has no `hold`.
|
|
514
|
+
*
|
|
515
|
+
* @param tracker The Suspense tracker of the nearest boundary (`SuspenseContext`).
|
|
516
|
+
* @throws {@link SUSPENSION} (not an error) when the boundary holds its content.
|
|
517
|
+
* @example
|
|
518
|
+
* import { useContext, SuspenseContext } from "@shadow-js/core";
|
|
519
|
+
* import { currentListener, holdReader, inTransition } from "@shadow-js/core/extend";
|
|
520
|
+
*
|
|
521
|
+
* export function readPending(): void {
|
|
522
|
+
* const tracker = useContext(SuspenseContext);
|
|
523
|
+
* if (tracker !== null && currentListener() !== null && inTransition()) holdReader(tracker);
|
|
524
|
+
* }
|
|
525
|
+
* @see isSuspension
|
|
526
|
+
* @since 1.0.0
|
|
527
|
+
*/
|
|
528
|
+
function holdReader(tracker) {
|
|
529
|
+
rt.hooks?.holdReader(tracker);
|
|
530
|
+
}
|
|
531
|
+
/**
|
|
532
|
+
* Tells whether a transition callback or a transition-lane run is active, so the writes made now
|
|
533
|
+
* belong to the lane. Use it in a primitive that treats transition reads differently, such as a data
|
|
534
|
+
* reader that holds the boundary only in a transition.
|
|
535
|
+
*
|
|
536
|
+
* @returns True inside `startTransition`'s callback and while the lane runs.
|
|
537
|
+
* @example
|
|
538
|
+
* import { startTransition } from "@shadow-js/core";
|
|
539
|
+
* import { inTransition } from "@shadow-js/core/extend";
|
|
540
|
+
*
|
|
541
|
+
* void startTransition(() => {
|
|
542
|
+
* console.log(inTransition()); // true in the browser
|
|
543
|
+
* });
|
|
544
|
+
* console.log(inTransition()); // false
|
|
545
|
+
* @see startTransition
|
|
546
|
+
* @since 1.0.0
|
|
547
|
+
*/
|
|
548
|
+
function inTransition() {
|
|
549
|
+
return rt.inTransition;
|
|
550
|
+
}
|
|
551
|
+
/**
|
|
552
|
+
* Creates the hold of a value a transition builds (see {@link TransitionHold}): the reads that wait
|
|
553
|
+
* for data inside `hold.run(...)` count against this hold instead of the Suspense boundary around the
|
|
554
|
+
* value, so the value on screen stays until the new one is ready. For renderers that build values
|
|
555
|
+
* during a transition.
|
|
556
|
+
*
|
|
557
|
+
* @param onSettled Called each time the number of waiting reads drops back to zero.
|
|
558
|
+
* @returns The hold, or null when the transition machinery does not exist yet (no transition has run,
|
|
559
|
+
* so nothing can be held).
|
|
560
|
+
* @example
|
|
561
|
+
* import { createTransitionHold } from "@shadow-js/core/extend";
|
|
562
|
+
*
|
|
563
|
+
* const hold = createTransitionHold(() => console.log("ready to commit"));
|
|
564
|
+
* const built = hold === null ? "now" : hold.run(() => "pending");
|
|
565
|
+
* @see transitionHooks
|
|
566
|
+
* @since 1.0.0
|
|
567
|
+
*/
|
|
568
|
+
function createTransitionHold(onSettled) {
|
|
569
|
+
const hooks = rt.hooks;
|
|
570
|
+
return hooks === null ? null : hooks.createHold(onSettled);
|
|
571
|
+
}
|
|
572
|
+
/**
|
|
573
|
+
* Returns the transition machinery while a transition is running, otherwise null. Renderers reach
|
|
574
|
+
* the slot and boundary layers (`slotSwap`, `boundaryHold`) only through it: a transition can only be
|
|
575
|
+
* running once the machinery exists, so this never creates it (a static call that did would keep the
|
|
576
|
+
* whole machinery in every bundle that renders a Show).
|
|
577
|
+
*
|
|
578
|
+
* @returns The hooks during a transition callback or lane run, null otherwise.
|
|
579
|
+
* @example
|
|
580
|
+
* import { transitionHooks } from "@shadow-js/core/extend";
|
|
581
|
+
*
|
|
582
|
+
* export function boundaryHoldIfTransition() {
|
|
583
|
+
* return transitionHooks()?.boundaryHold() ?? null;
|
|
584
|
+
* }
|
|
585
|
+
* @see inTransition
|
|
586
|
+
* @since 1.0.0
|
|
587
|
+
*/
|
|
588
|
+
function transitionHooks() {
|
|
589
|
+
return rt.inTransition ? rt.hooks : null;
|
|
590
|
+
}
|
|
591
|
+
/**
|
|
592
|
+
* Pauses `owner` and everything below it (Activity hidden). User effects run their cleanups and wait.
|
|
593
|
+
* DOM bindings (render effects) wait without a cleanup, so their nodes stay as they are. Memos keep their
|
|
594
|
+
* last value, and effects created below are parked until the owner resumes. Pauses nest: each
|
|
595
|
+
* `pauseOwner` needs one `resumeOwner`. Use it to hide a subtree while keeping its state.
|
|
596
|
+
*
|
|
597
|
+
* @param owner The owner to pause, with its whole subtree.
|
|
598
|
+
* @example
|
|
599
|
+
* import { createOwner, pauseOwner, resumeOwner } from "@shadow-js/core/extend";
|
|
600
|
+
*
|
|
601
|
+
* const hidden = createOwner(null);
|
|
602
|
+
* pauseOwner(hidden); // its effects stop; its memos keep their values
|
|
603
|
+
* resumeOwner(hidden); // its user effects run again with the latest values
|
|
604
|
+
* @see resumeOwner
|
|
605
|
+
* @since 1.0.0
|
|
606
|
+
*/
|
|
607
|
+
function pauseOwner(owner) {
|
|
608
|
+
ensureHooks().pause(owner);
|
|
609
|
+
}
|
|
610
|
+
/**
|
|
611
|
+
* Resumes an owner paused with {@link pauseOwner}; the subtree runs again once its last pause ends.
|
|
612
|
+
* User effects below it run once more with the current values (their cleanups ran on pause). DOM
|
|
613
|
+
* bindings run only if something they read changed while paused, so a hidden subtree is not rebuilt
|
|
614
|
+
* on show. Memos that changed while paused wake their readers outside the owner. Call it once per
|
|
615
|
+
* `pauseOwner`, not on an owner that is not paused.
|
|
616
|
+
*
|
|
617
|
+
* @param owner The paused owner.
|
|
618
|
+
* @example
|
|
619
|
+
* import { createOwner, pauseOwner, resumeOwner } from "@shadow-js/core/extend";
|
|
620
|
+
*
|
|
621
|
+
* const panel = createOwner(null);
|
|
622
|
+
* pauseOwner(panel);
|
|
623
|
+
* resumeOwner(panel); // every user effect below runs once with the latest values
|
|
624
|
+
* @see pauseOwner
|
|
625
|
+
* @since 1.0.0
|
|
626
|
+
*/
|
|
627
|
+
function resumeOwner(owner) {
|
|
628
|
+
rt.hooks?.resume(owner);
|
|
629
|
+
}
|
|
630
|
+
//#endregion
|
|
631
|
+
export { beginHold, createTransitionHold, endHold, holdReader, inTransition, pauseOwner, registerTransitionLane, resumeOwner, startTransition, transitionHooks, wakeSuspended };
|
|
632
|
+
|
|
633
|
+
//# sourceMappingURL=concurrency.js.map
|