@abide/abide 0.121.1 → 0.123.0

package/src/shared/index.ts

@@ -54,8 +54,9 @@ export { online } from './online.ts'
 export { outbox, type QueuedCall } from './outbox.ts'
 export { onMenu } from './onMenu.ts'
 export { type Principal, principal } from './principal.ts'
-// EMITTED CODE'S: a prop the child writes (33.6, 33.7).
+// EMITTED CODE'S: a prop the child writes (33.6, 33.7), and one it hands where a `Reactive` is due (33.27).
 export {
+    heldProp,
     propCell,
     propCells,
     propOr,

package/src/shared/propCell.ts

@@ -21,6 +21,24 @@ export function propCell(read: Accessor): () => Reactive<unknown> {
     return () => cell
 }
 
+// Each read prop's `heldProp`, built on the first ask and kept for as long as its accessor is.
+const HELD = new WeakMap<Accessor, Reactive<unknown>>()
+
+/**
+ * 33.27 — a prop the child only reads, where its position holds the `Reactive` (31.3, 31.13): the
+ * one cell `propCell` would have built, over the caller's accessor. So `busy(rows)` asks what the
+ * caller's expression read — the caller's own `Reactive` where it bound one — and a plain value's is
+ * a cell nothing loads. Built only where one is asked for, and once per accessor.
+ */
+export function heldProp(read: Accessor): Reactive<unknown> {
+    let cell = HELD.get(read)
+    if (cell === undefined) {
+        cell = propCell(read)()
+        HELD.set(read, cell)
+    }
+    return cell
+}
+
 /**
  * 33.20 — a defaulted prop's accessor: the caller's, answering the default wherever it reads
  * `undefined`, and the default alone where the caller passed nothing. A bound accessor asked to

package/src/shared/rpc.ts

@@ -19,7 +19,7 @@ import { GLOBAL_GETS } from './GLOBAL_GETS.ts'
 import { HandlerRoute } from './HandlerRoute.ts'
 import { IN_PROCESS_ORIGIN } from './IN_PROCESS_ORIGIN.ts'
 import type { Issues } from './Issues.ts'
-import { compose, type Middleware } from './Middleware.ts'
+import { compose, type Rung } from './Middleware.ts'
 import { outbox, type QueuedCall, sendingFor } from './outbox.ts'
 import { principalRotated } from './principalRotated.ts'
 import {
@@ -192,7 +192,7 @@ const SENT: unique symbol = Symbol('abide.sent')
 
 export type RpcOptions<Args = unknown> = {
     description?: string
-    middleware?: Middleware<RpcContext<Args>, unknown>[]
+    middleware?: Rung<RpcContext<Args>, unknown>[]
     timeout?: number
     clients?: Clients
     crossOrigin?: boolean | string[]

package/src/shared/writePath.ts

@@ -14,7 +14,7 @@ import { putOwn } from './putOwn.ts'
  * object where an array was, and `length`, `map` and every later `{#for}` over it go with it. The
  * shape is decided here, where the value is.
  *
- * 31.15 — ONLY PLAIN DATA IS COPIED. An element, a class instance, a `Map`: anything whose prototype
+ * 31.14 — ONLY PLAIN DATA IS COPIED. An element, a class instance, a `Map`: anything whose prototype
  * is not `Object.prototype`, `null` or `Array.prototype` owns its own state, and its setters say
  * what a write means — `video.currentTime = t` seeks. A spread of one is a plain object holding a
  * few own fields, so the write reached nothing and the `Reactive` came to hold the husk. The write