@wardic/core 1.0.0-rc.4 → 1.0.0-rc.5

package/dist/SharedSource.d.ts

@@ -1,34 +1,54 @@
-import type * as Duration from "effect/Duration";
+/**
+ * Shared sources, for the Streams an Environment hands out: each hot and counted, so however many
+ * subscribe, one underlying source runs, started by the first subscriber and stopped when the last one
+ * leaves. `byTarget` keeps one per target, one observer on each element, and `make` one for the whole
+ * Environment. An Environment builds its sources with these, as `@wardic/dom` does, and `counted` shares
+ * anything else it opens per target.
+ *
+ * @example
+ * import * as SharedSource from "@wardic/core/SharedSource"
+ *
+ * const resize = yield* SharedSource.byTarget((target) => Effect.succeed(resizesOf(target)))
+ * // Both share one observer on `card`:
+ * Stream.runForEach(resize(card), onLayout)
+ * Stream.runForEach(resize(card), onScroll)
+ */
 import * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
+import * as Scope from "effect/Scope";
 import * as Stream from "effect/Stream";
-/** `byTarget`'s and `make`'s options. */
-export interface Options {
-    /**
-     * How long a source with no subscriber left keeps running before it stops, so a quick re-subscribe
-     * reuses it. Default: none, stopped at once.
-     */
-    readonly idleTimeToLive?: Duration.Input | undefined;
-}
+/**
+ * Values shared by key and counted: the first hold of a key opens its value with `open`, later holds
+ * share it, and the last one's release closes it with `close`. A key is held by identity and never
+ * hashed, so a DOM node is its own key. `open` runs inline, so it mustn't wait.
+ *
+ * @example
+ * // One listener set per container, however many readers hold it
+ * const containers = SharedSource.counted(
+ *   (container: Element) => ({ remove: listenTo(container) }),
+ *   (listening) => Effect.sync(listening.remove),
+ * )
+ * const listening = yield* containers(list) // held until the current Scope closes
+ */
+export declare const counted: <K, V>(open: (key: K) => V, close: (value: V) => Effect.Effect<void>) => ((key: K) => Effect.Effect<V, never, Scope.Scope>);
 /**
  * A shared source per target: a function from a target to a Stream that's hot and counted for that
  * target. The first subscriber for a target starts `lookup(target)`'s source, later ones share it, and it
- * stops when the last one for that target leaves, after `idleTimeToLive` if it's given.
+ * stops when the last one for that target leaves.
  *
  * @example
  * // `resizesOf(target)`: an Environment's own Stream of a target's sizes
  * const resize = yield* SharedSource.byTarget((target) => Effect.succeed(resizesOf(target)))
  */
-export declare const byTarget: <A>(lookup: (target: unknown) => Effect.Effect<Stream.Stream<A>, never, Scope.Scope>, options?: Options) => Effect.Effect<(target: unknown) => Stream.Stream<A>, never, Scope.Scope>;
+export declare const byTarget: <A>(lookup: (target: unknown) => Effect.Effect<Stream.Stream<A>, never, Scope.Scope>) => Effect.Effect<(target: unknown) => Stream.Stream<A>, never, Scope.Scope>;
 /**
  * One shared source for the whole Environment: a Stream that's hot and counted. The first subscriber
- * starts `acquire`'s source, later ones share it, and it stops when the last one leaves, after
- * `idleTimeToLive` if it's given. `byTarget`'s form without a target.
+ * starts `acquire`'s source, later ones share it, and it stops when the last one leaves. `byTarget`'s
+ * form without a target.
  *
  * @example
  * // `viewportChanges`: an Environment's own Stream of its viewport's size
  * const viewport = yield* SharedSource.make(Effect.succeed(viewportChanges))
  * Stream.runForEach(viewport, onResize) // one listener, however many subscribe
  */
-export declare const make: <A>(acquire: Effect.Effect<Stream.Stream<A>, never, Scope.Scope>, options?: Options) => Effect.Effect<Stream.Stream<A>, never, Scope.Scope>;
+export declare const make: <A>(acquire: Effect.Effect<Stream.Stream<A>, never, Scope.Scope>) => Effect.Effect<Stream.Stream<A>, never, Scope.Scope>;
 //# sourceMappingURL=SharedSource.d.ts.map

package/dist/SharedSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SharedSource.d.ts","sourceRoot":"","sources":["../src/SharedSource.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAYvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAIvC,yCAAyC;AACzC,MAAM,WAAW,OAAO;IACtB;;;OAGG;IAEH,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAA;CACrD;AAoFD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAChF,OAAO,CAAC,EAAE,OAAO,KACd,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CA+BxE,CAAA;AAEJ;;;;;;;;;GASG;AAEH,eAAO,MAAM,IAAI,EAAE,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAC5D,OAAO,CAAC,EAAE,OAAO,KACd,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAgBnD,CAAA"}
+{"version":3,"file":"SharedSource.d.ts","sourceRoot":"","sources":["../src/SharedSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAUvC;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,CAAC,QACpB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SACZ,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KACvC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAoBnD,CAAA;AAwDD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,CAAC,EACvB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAUxE,CAAA;AAEJ;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KACzD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CASnD,CAAA"}

package/dist/SharedSource.js

@@ -2,7 +2,8 @@
  * Shared sources, for the Streams an Environment hands out: each hot and counted, so however many
  * subscribe, one underlying source runs, started by the first subscriber and stopped when the last one
  * leaves. `byTarget` keeps one per target, one observer on each element, and `make` one for the whole
- * Environment. An Environment builds its sources with these, as `@wardic/dom` does.
+ * Environment. An Environment builds its sources with these, as `@wardic/dom` does, and `counted` shares
+ * anything else it opens per target.
  *
  * @example
  * import * as SharedSource from "@wardic/core/SharedSource"
@@ -13,146 +14,121 @@
  * Stream.runForEach(resize(card), onScroll)
  */
 // CONTEXT.md's **Shared source** contract (#37, ADR-0041 *Amendment (#37)*). An Environment's **Input
-// feeds** are shared by `InputFeed.byTarget` instead, with no `PubSub` or fiber (#318).
+// feeds** are shared by `InputFeed.byTarget` instead, with no fiber (#318).
 //
-// Two constructors, both built on the same primitive (a `PubSub` fed by a `forkScoped` pump that drains
-// the cold source), wrapped in Effect's reference-counted resource caches: `byTarget` keys on the target
-// (`RcMap`), the cold `lookup` running once per target while a subscriber holds it (an Environment's
-// `Probe.observeResize`); `make` is the keyless case (`RcRef`). The cold source is acquired by the first
-// subscriber and released when the last subscriber's scope closes: `Stream.unwrap` holds the Rc reference
-// for the subscriber stream's lifetime, so when the last one ends the cache releases the entry, the pump
-// is interrupted, and the cold source's finalizers run (a listener is removed). The source's end ends
-// every subscriber, and its failure fails them (#618, decision 6). Effect's own `Stream.share` and
-// `Stream.broadcast` do this too, but put 2.2 KB gzip on every app (`bun run size`), so the pump stays.
+// One shape under both constructors (#518, ADR-0067 *Amendment (#518)*, decision 3): a target's entry in
+// a `counted` map holds its subscribers' hearings and, while any subscriber holds it, a pump that runs the
+// cold source and hands each element to every hearing, which resumes a waiting subscriber inside the
+// call, as the `PubSub` did. The first subscriber opens the entry and starts the pump; the
+// last one's release interrupts it, and the cold source's finalizers run (a listener is removed). The
+// source's end ends every subscriber, and its failure fails them (#618, decision 6). It replaced a
+// `PubSub` per source in Effect's `RcMap` and `RcRef`, whose code every app shipped (4.1 KB gzipped with
+// `Clock.ticks`' and the DOM's scroll containers'), and whose `idleTimeToLive` nothing passed.
 //
 // Tier 2 (ADR-0008), for Environment authors, as `InputSource.heldPointer` is (#31's rule: Wardic ships
 // what makes a new Environment little work). Observability: each constructor emits a
-// `wardic.sharedSource.*` span and a debug log on subscribe; the per-event publish path stays quiet.
-import * as Cause from "effect/Cause";
+// `wardic.sharedSource.*` span and a debug log on subscribe; the per-event path stays quiet.
 import * as Effect from "effect/Effect";
-import * as Equal from "effect/Equal";
 import * as Exit from "effect/Exit";
-import { identity } from "effect/Function";
-import * as Hash from "effect/Hash";
-import * as Match from "effect/Match";
-import * as MutableRef from "effect/MutableRef";
+import * as Fiber from "effect/Fiber";
+import * as Iter from "effect/Iterable";
 import * as Option from "effect/Option";
-import * as Predicate from "effect/Predicate";
-import * as PubSub from "effect/PubSub";
-import * as RcMap from "effect/RcMap";
-import * as RcRef from "effect/RcRef";
+import * as Scope from "effect/Scope";
 import * as Stream from "effect/Stream";
-import * as UndefinedOr from "effect/UndefinedOr";
+import * as Hearing from "./internal/hearing.js";
 import { tracedStream } from "./internal/tracing.js";
 /**
- * The hot `PubSub` that fronts a cold source: acquire the source via `acquire`, fork a scoped pump
- * that republishes every element into the PubSub, and hand back the PubSub. The pump is bound to
- * the Rc cache entry's scope, so when the cache releases the entry the pump is interrupted and the
- * cold source's finalizers run. When the source ends, how it ended is kept and the PubSub shut down,
- * which ends every subscription. Per-element publishing is un-logged: it's the hot path.
+ * Values shared by key and counted: the first hold of a key opens its value with `open`, later holds
+ * share it, and the last one's release closes it with `close`. A key is held by identity and never
+ * hashed, so a DOM node is its own key. `open` runs inline, so it mustn't wait.
+ *
+ * @example
+ * // One listener set per container, however many readers hold it
+ * const containers = SharedSource.counted(
+ *   (container: Element) => ({ remove: listenTo(container) }),
+ *   (listening) => Effect.sync(listening.remove),
+ * )
+ * const listening = yield* containers(list) // held until the current Scope closes
  */
-const fanIn = /*#__PURE__*/ Effect.fnUntraced(function* (acquire) {
-    const pubsub = yield* PubSub.unbounded();
-    const source = yield* acquire;
-    const ended = MutableRef.make(Option.none());
-    yield* Effect.forkScoped(Stream.runForEach(source, (a) => PubSub.publish(pubsub, a)).pipe(Effect.onExit((exit) => Effect.andThen(Effect.sync(() => MutableRef.set(ended, Option.some(exit))), PubSub.shutdown(pubsub)))));
-    return { pubsub, ended };
-});
-/** A source's failure, if it failed: an interruption is how its cache ends it, not a failure. */
-const failureOf = (exit) => {
-    if (Exit.isSuccess(exit))
-        return Option.none();
-    if (Cause.hasInterruptsOnly(exit.cause))
-        return Option.none();
-    return Option.some(exit.cause);
+// #518: what `RcMap` gave the DOM's scroll containers (#618, M7), with no Scope per entry and no `Hash`.
+export const counted = (open, close) => {
+    const held = new Map();
+    const acquire = (key) => Effect.sync(() => {
+        const entry = Option.getOrElse(Option.fromUndefinedOr(held.get(key)), () => {
+            const opened = { value: open(key), count: 0 };
+            held.set(key, opened);
+            return opened;
+        });
+        entry.count++;
+        return entry;
+    });
+    const release = (key, entry) => Effect.suspend(() => {
+        entry.count--;
+        if (entry.count > 0)
+            return Effect.void;
+        if (held.get(key) === entry)
+            held.delete(key);
+        return close(entry.value);
+    });
+    return (key) => Effect.map(Effect.acquireRelease(acquire(key), (entry) => release(key, entry)), (entry) => entry.value);
 };
-/** How a subscriber ends after its source has: failed with the source's failure, else at once. */
-const endOf = (ended) => Option.match(Option.flatMap(ended, failureOf), { onNone: () => Effect.void, onSome: (cause) => Effect.failCause(cause) });
-/**
- * A subscriber to a fanned-out source, made as it subscribes: its events, then the source's end. One that
- * subscribes after the end gets the end alone.
- */
-const subscriberOf = ({ pubsub, ended }) => Stream.onEnd(Option.match(MutableRef.get(ended), { onNone: () => Stream.fromPubSub(pubsub), onSome: () => Stream.empty }), Effect.suspend(() => endOf(MutableRef.get(ended))));
+/** A fresh source's entry, with no subscriber, no pump and no end. */
+const fanned = () => ({ hearings: new Set(), pump: Option.none(), ended: Option.none() });
+/** The pump: `acquire`'s source, each element to every subscriber; its end, kept and handed to each. */
+const pumpOf = (entry, acquire) => Effect.scoped(Effect.flatMap(acquire, (source) => Stream.runForEach(source, (a) => Effect.sync(() => Iter.forEach(entry.hearings, (hearing) => hearing.hear(a)))))).pipe(Effect.onExit((exit) => Effect.sync(() => {
+    entry.ended = Option.some(exit);
+    Iter.forEach(entry.hearings, (hearing) => hearing.end(exit));
+})));
+/** An entry's pump stopped, its last subscriber gone. */
+const stop = (entry) => Option.match(entry.pump, { onNone: () => Effect.void, onSome: (pump) => Effect.asVoid(Fiber.interrupt(pump)) });
 /**
- * An identity key for `RcMap`. `RcMap` hashes its keys with Effect's structural `Hash`, which
- * walks a target's properties: on a platform object that can throw (a DOM node's function
- * properties touch `.caller` in strict mode), and it would conflate two structurally equal but
- * distinct targets. This wrapper is equal by reference, with a stable per-instance hash, so `RcMap`
- * never inspects the target and each distinct target is its own entry. One wrapper is cached per
- * target (the `WeakMap` in {@link byTarget}).
+ * A subscriber to `key`'s shared source: its hearing on the entry while its Stream runs, the pump started
+ * for the first, in `scope`, the shared source's. One that subscribes after the source ended gets the end
+ * alone.
  */
-// Module state (#460, Q7): an id counter, only ever compared for distinctness, so every runtime may share it.
-let nextTargetHash = 1;
-class TargetKey {
-    target;
-    hash;
-    constructor(target) {
-        this.target = target;
-        this.hash = nextTargetHash++;
-    }
-    [Hash.symbol]() {
-        return this.hash;
-    }
-    [Equal.symbol](that) {
-        return this === that;
+const subscriberOf = (hold, key, acquire, scope) => Stream.unwrap(Effect.gen(function* () {
+    const entry = yield* hold(key);
+    const hearing = Hearing.make();
+    if (Option.isSome(entry.ended)) {
+        hearing.end(entry.ended.value);
+        return hearing.stream;
     }
-}
-/** The target a key addresses: a {@link TargetKey}'s own, else the key itself (a non-object target). */
-const targetOf = /*#__PURE__*/ Match.type().pipe(Match.when(Match.instanceOf(TargetKey), (key) => key.target), Match.orElse(identity));
-/** The cache's `idleTimeToLive`, when the options give one. */
-const idleOf = (options = {}) => UndefinedOr.match(options.idleTimeToLive, { onUndefined: () => ({}), onDefined: (idleTimeToLive) => ({ idleTimeToLive }) });
+    // Its hearing first, so what the pump hands on as it starts reaches it.
+    entry.hearings.add(hearing);
+    yield* Effect.addFinalizer(() => Effect.sync(() => entry.hearings.delete(hearing)));
+    if (Option.isNone(entry.pump))
+        entry.pump = Option.some(yield* Effect.forkIn(pumpOf(entry, acquire()), scope, { startImmediately: true }));
+    return hearing.stream;
+}));
 /**
  * A shared source per target: a function from a target to a Stream that's hot and counted for that
  * target. The first subscriber for a target starts `lookup(target)`'s source, later ones share it, and it
- * stops when the last one for that target leaves, after `idleTimeToLive` if it's given.
+ * stops when the last one for that target leaves.
  *
  * @example
  * // `resizesOf(target)`: an Environment's own Stream of a target's sizes
  * const resize = yield* SharedSource.byTarget((target) => Effect.succeed(resizesOf(target)))
  */
-export const byTarget = /*#__PURE__*/ Effect.fnUntraced(function* (lookup, options) {
+export const byTarget = /*#__PURE__*/ Effect.fnUntraced(function* (lookup) {
     yield* Effect.logDebug("wardic.sharedSource.byTarget: create");
-    // One stable identity key per target (see TargetKey). Object targets are cached weakly, so the
-    // key, and the RcMap entry it addresses, share the target's lifetime; a non-object target hashes
-    // safely on its own.
-    const keys = new WeakMap();
-    const keyFor = (target) => Option.match(Option.liftPredicate(target, Predicate.isObjectOrArray), {
-        onNone: () => target,
-        onSome: (object) => Option.getOrElse(Option.fromUndefinedOr(keys.get(object)), () => {
-            const key = new TargetKey(object);
-            keys.set(object, key);
-            return key;
-        }),
-    });
-    const map = yield* RcMap.make({
-        lookup: (key) => fanIn(lookup(targetOf(key))),
-        ...idleOf(options),
-    });
-    return (target) => tracedStream(Stream.unwrap(Effect.gen(function* () {
-        yield* Effect.logDebug("wardic.sharedSource.byTarget: subscribe");
-        return subscriberOf(yield* RcMap.get(map, keyFor(target)));
-    })), "wardic.sharedSource.byTarget");
+    const scope = yield* Scope.Scope;
+    const hold = counted(fanned, stop);
+    return (target) => tracedStream(Stream.unwrap(Effect.as(Effect.logDebug("wardic.sharedSource.byTarget: subscribe"), subscriberOf(hold, target, () => lookup(target), scope))), "wardic.sharedSource.byTarget");
 });
 /**
  * One shared source for the whole Environment: a Stream that's hot and counted. The first subscriber
- * starts `acquire`'s source, later ones share it, and it stops when the last one leaves, after
- * `idleTimeToLive` if it's given. `byTarget`'s form without a target.
+ * starts `acquire`'s source, later ones share it, and it stops when the last one leaves. `byTarget`'s
+ * form without a target.
  *
  * @example
  * // `viewportChanges`: an Environment's own Stream of its viewport's size
  * const viewport = yield* SharedSource.make(Effect.succeed(viewportChanges))
  * Stream.runForEach(viewport, onResize) // one listener, however many subscribe
  */
-// As `RcRef.make` is `RcMap.make`'s.
-export const make = /*#__PURE__*/ Effect.fnUntraced(function* (acquire, options) {
+export const make = /*#__PURE__*/ Effect.fnUntraced(function* (acquire) {
     yield* Effect.logDebug("wardic.sharedSource.make: create");
-    const ref = yield* RcRef.make({
-        acquire: fanIn(acquire),
-        ...idleOf(options),
-    });
-    return tracedStream(Stream.unwrap(Effect.gen(function* () {
-        yield* Effect.logDebug("wardic.sharedSource.make: subscribe");
-        return subscriberOf(yield* RcRef.get(ref));
-    })), "wardic.sharedSource.make");
+    const scope = yield* Scope.Scope;
+    const hold = counted(fanned, stop);
+    return tracedStream(Stream.unwrap(Effect.as(Effect.logDebug("wardic.sharedSource.make: subscribe"), subscriberOf(hold, undefined, () => acquire, scope))), "wardic.sharedSource.make");
 });
 //# sourceMappingURL=SharedSource.js.map

package/dist/SharedSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"SharedSource.js","sourceRoot":"","sources":["../src/SharedSource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SharedSource.js","sourceRoot":"","sources":["../src/SharedSource.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  *
  * Each Primitive is a machine (`Machine`), run as a `Stream` over the Clock's ticks
  * (`Machine.toStream`) or on the Frame loop (`Machine.run`). The services (`Clock`,
- * `RefreshFrameSource`, `Renderer`, `InputSource`, `Probe`, `InterpolatorRegistry`, `FrameLoop`,
+ * `RefreshFrameSource`, `Renderer`, `InputSource`, `Probe`, `ScrollSource`, `InterpolatorRegistry`, `FrameLoop`,
  * `DefaultTransition`) are each `X.X`, with the shared constructors the Environments build on
  * (`Clock.layer`, `Clock.fromRefreshFrames`, `InputSource.heldPointer`, `InputFeed.byTarget`,
  * `InterpolatorRegistry.layer`, `FrameLoop.layer`, `DefaultTransition.layerOneSpring`). Each module's
@@ -45,6 +45,7 @@ export * as RefreshFrameSource from "./RefreshFrameSource.ts";
 export * as Renderer from "./Renderer.ts";
 export * as Reorder from "./Reorder.ts";
 export * as Scalar from "./Scalar.ts";
+export * as ScrollSource from "./ScrollSource.ts";
 export * as Sequence from "./Sequence.ts";
 export * as SharedSource from "./SharedSource.ts";
 export * as Spring from "./Spring.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -6,7 +6,7 @@
  *
  * Each Primitive is a machine (`Machine`), run as a `Stream` over the Clock's ticks
  * (`Machine.toStream`) or on the Frame loop (`Machine.run`). The services (`Clock`,
- * `RefreshFrameSource`, `Renderer`, `InputSource`, `Probe`, `InterpolatorRegistry`, `FrameLoop`,
+ * `RefreshFrameSource`, `Renderer`, `InputSource`, `Probe`, `ScrollSource`, `InterpolatorRegistry`, `FrameLoop`,
  * `DefaultTransition`) are each `X.X`, with the shared constructors the Environments build on
  * (`Clock.layer`, `Clock.fromRefreshFrames`, `InputSource.heldPointer`, `InputFeed.byTarget`,
  * `InterpolatorRegistry.layer`, `FrameLoop.layer`, `DefaultTransition.layerOneSpring`). Each module's
@@ -47,6 +47,7 @@ export * as RefreshFrameSource from "./RefreshFrameSource.js";
 export * as Renderer from "./Renderer.js";
 export * as Reorder from "./Reorder.js";
 export * as Scalar from "./Scalar.js";
+export * as ScrollSource from "./ScrollSource.js";
 export * as Sequence from "./Sequence.js";
 export * as SharedSource from "./SharedSource.js";
 export * as Spring from "./Spring.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,oGAAoG;AACpG,uGAAuG;AACvG,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,oGAAoG;AACpG,uGAAuG;AACvG,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAA;AAC/B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAC7C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA"}

package/dist/internal/frameLoop.d.ts

@@ -1,6 +1,7 @@
 import * as Cause from "effect/Cause";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
+import type * as Metric from "effect/Metric";
 import * as Option from "effect/Option";
 import type * as Scope from "effect/Scope";
 import * as Clock from "../Clock.ts";
@@ -43,6 +44,22 @@ export interface Shape {
      */
     readonly afterTick: (hook: () => undefined) => Effect.Effect<void, never, Scope.Scope>;
 }
+/**
+ * The Frame loop's metrics: the running animations, the runs that settled and failed, and each tick's
+ * ms. None unless an app gives them (`FrameLoop.layerMetrics`, #518), so an app that reads none ships and
+ * updates none.
+ */
+export interface Metrics {
+    readonly animations: Metric.Gauge<number>;
+    readonly settled: Metric.Counter<number>;
+    readonly failed: Metric.Counter<number>;
+    readonly tickMs: Metric.Histogram<number>;
+}
+/**
+ * Where a run's fiber finds the metrics. The loop takes them from the first run that has them: an app
+ * gives them beside its Environment, which the loop's own build doesn't see, as `CheckFrames` is read.
+ */
+export declare const MetricsGiven: Context.Reference<Metrics | undefined>;
 /**
  * A check for development, off by default: on, every run started where it's on checks each Frame before
  * its sink gets it, and fails with `NonFiniteFrame` on a NaN or an Infinity. Read once a run, from the

package/dist/internal/frameLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameLoop.d.ts","sourceRoot":"","sources":["../../src/internal/frameLoop.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAGzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAMvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAG1C,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAA;AAO7C,iFAAiF;AAEjF,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAA;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,GAAG;IAClB,CAAC,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxG,CAAC,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;CACrJ;AAED,wDAAwD;AACxD,MAAM,WAAW,KAAK;IACpB;;;;;;;;OAQG;IAGH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB;;;OAGG;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB;;;;;OAKG;IAEH,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CACvF;AA2BD;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAEjD,CAAA;;;;AAEF;;;GAGG;AAEH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAqEL;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;sBAqHY,MAAM,SAAS,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;oCA6HrF,CAAA"}
+{"version":3,"file":"frameLoop.d.ts","sourceRoot":"","sources":["../../src/internal/frameLoop.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAGzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAG1C,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AACpC,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAA;AAO7C,iFAAiF;AAEjF,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAA;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,GAAG;IAClB,CAAC,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxG,CAAC,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;CACrJ;AAED,wDAAwD;AACxD,MAAM,WAAW,KAAK;IACpB;;;;;;;;OAQG;IAGH,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;IACjB;;;OAGG;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;IACrB;;;;;OAKG;IAEH,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CACvF;AAmBD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;CAC1C;AAED;;;GAGG;AAEH,eAAO,MAAM,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,GAAG,SAAS,CAE9D,CAAA;AAEF;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAEjD,CAAA;;;;AAEF;;;GAGG;AAEH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAqEL;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;sBA6HY,MAAM,SAAS,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;oCA+HrF,CAAA"}

package/dist/internal/frameLoop.js

@@ -29,11 +29,11 @@
  *
  * Observability: a span per run, named after its Primitive (`machine.span`), and one per burst
  * (`wardic.frameloop`). A run's `<name>: start` debug log, annotated with its span's attributes,
- * built only when a Debug log would be kept (#542). Per tick, no span or log: a gauge of running
- * animations and a histogram of ms per tick, each one `updateUnsafe` (ADR-0027, decision 6), and the
- * runs that settled or failed in it, counted as they end and added at its end by the loop's own
- * `afterTick` hook, its first (#542). The histogram ends before the hooks, so it measures the steps
- * alone, not the gate's flush (ADR-0033).
+ * built only when a Debug log would be kept (#542). Per tick, no span or log. With the metrics an app
+ * gives (`FrameLoop.layerMetrics`, #518): a gauge of running animations and a histogram of ms per tick,
+ * each one `updateUnsafe` (ADR-0027, decision 6), and the runs that settled or failed in it, counted as
+ * they end and added at its end by the loop's own `afterTick` hook, its first (#542). The histogram ends
+ * before the hooks, so it measures the steps alone, not the gate's flush (ADR-0033).
  *
  * A run's span is opened without a stack frame (ADR-0040, decision 3): `useSpan` with the span as
  * the `ParentSpan`, not `withSpan`, whose frame Effect stamps on an interrupted run's cause and
@@ -57,7 +57,6 @@ import * as Exit from "effect/Exit";
 import * as FiberHandle from "effect/FiberHandle";
 import { constUndefined, identity } from "effect/Function";
 import * as LogLevel from "effect/LogLevel";
-import * as Metric from "effect/Metric";
 import * as Option from "effect/Option";
 import * as Predicate from "effect/Predicate";
 import * as References from "effect/References";
@@ -66,12 +65,13 @@ import * as Tracer from "effect/Tracer";
 import * as Clock from "../Clock.js";
 import * as Supersede from "../Supersede.js";
 import { isTraced, traced } from "./tracing.js";
-const animations = Metric.gauge("wardic_frameloop_animations", { description: "Primitives running on the Frame loop" });
-const settledRuns = Metric.counter("wardic_frameloop_settled", { description: "Runs on the Frame loop that settled" });
-const failedRuns = Metric.counter("wardic_frameloop_failed", { description: "Runs on the Frame loop that failed" });
-const tickMs = Metric.histogram("wardic_frameloop_tick_ms", {
-    description: "Milliseconds the Frame loop spends on one tick",
-    boundaries: Metric.linearBoundaries({ start: 0, width: 0.5, count: 32 }),
+/**
+ * Where a run's fiber finds the metrics. The loop takes them from the first run that has them: an app
+ * gives them beside its Environment, which the loop's own build doesn't see, as `CheckFrames` is read.
+ */
+// #518, ADR-0067 *Amendment (#518)*, decision 2.
+export const MetricsGiven = Context.Reference("@wardic/core/FrameLoop/Metrics", {
+    defaultValue: constUndefined,
 });
 /**
  * A check for development, off by default: on, every run started where it's on checks each Frame before
@@ -174,6 +174,8 @@ export const make = Effect.fnUntraced(function* () {
     // once per tick. An interruption is neither, nor a superseded run, which the loop doesn't end.
     let settledCount = 0;
     let failedCount = 0;
+    // The metrics, once a run brings them (#518).
+    let metrics;
     /** End `entry`'s run: removed, counted, and its fiber resumed with `exit` (inline, within the tick). */
     const end = (entry, exit) => {
         entry.removed = true;
@@ -185,10 +187,12 @@ export const make = Effect.fnUntraced(function* () {
     };
     /** The runs ended since the last count, into the counters: once per tick, and as a burst ends. */
     const countEnds = () => {
-        if (settledCount > 0)
-            settledRuns.updateUnsafe(settledCount, buildContext);
-        if (failedCount > 0)
-            failedRuns.updateUnsafe(failedCount, buildContext);
+        if (Predicate.isNotUndefined(metrics)) {
+            if (settledCount > 0)
+                metrics.settled.updateUnsafe(settledCount, buildContext);
+            if (failedCount > 0)
+                metrics.failed.updateUnsafe(failedCount, buildContext);
+        }
         settledCount = 0;
         failedCount = 0;
         return undefined;
@@ -234,7 +238,10 @@ export const make = Effect.fnUntraced(function* () {
     // The first lane's loops stay inline in `tick`: moved into a function shared with the last lane,
     // Node's `chase/loop` ran 55% slower (`bench:core`, ADR-0027 *Amendment (#137)*).
     const tick = (dt) => {
-        const t0 = performance.now();
+        // The tick's start, read only for the metrics' histogram (#518).
+        let t0 = 0;
+        if (Predicate.isNotUndefined(metrics))
+            t0 = performance.now();
         // Both counts before any step: a run added during the tick, to either lane, waits for the next.
         const count = entries.length;
         const lastCount = lastEntries.length;
@@ -267,8 +274,10 @@ export const make = Effect.fnUntraced(function* () {
         entries.length = kept;
         if (lastEntries.length > 0)
             kept += compactLast();
-        animations.updateUnsafe(kept, buildContext);
-        tickMs.updateUnsafe(performance.now() - t0, buildContext);
+        if (Predicate.isNotUndefined(metrics)) {
+            metrics.animations.updateUnsafe(kept, buildContext);
+            metrics.tickMs.updateUnsafe(performance.now() - t0, buildContext);
+        }
         // The end of the tick: everything for this Refresh frame is written (ADR-0033). After
         // `tickMs`, which stays the cost of the steps alone.
         const ended = hooks;
@@ -299,7 +308,8 @@ export const make = Effect.fnUntraced(function* () {
             if (!entry.removed)
                 end(entry, ending);
         });
-        animations.updateUnsafe(0, buildContext);
+        if (Predicate.isNotUndefined(metrics))
+            metrics.animations.updateUnsafe(0, buildContext);
         countEnds();
     };
     const ticking = clock.ticks.pipe(Stream.map(tick), Stream.takeUntil(identity), Stream.runDrain, Effect.onExit((exit) => Effect.sync(() => endAll(exit))), (self) => traced(self, "wardic.frameloop", { root: true }), Effect.provideContext(buildContext));
@@ -323,6 +333,9 @@ export const make = Effect.fnUntraced(function* () {
     const runIn = (lane) => ((machine, sink, options) => Effect.withFiber((fiber) => {
         // Its start log only when a Debug log would be kept (#542): Effect's own rule, read once.
         const logged = !LogLevel.isGreaterThan(fiber.getRef(References.MinimumLogLevel), "Debug");
+        // The metrics from the first run whose fiber has them (#518); none is read once they're in.
+        if (Predicate.isUndefined(metrics))
+            metrics = fiber.getRef(MetricsGiven);
         if (!isTraced(fiber))
             return added(lane, machine, sink, options, undefined, logged);
         return Effect.useSpan(machine.span.name, { attributes: machine.span.attributes }, (span) => Effect.provideService(added(lane, machine, sink, options, span, logged), Tracer.ParentSpan, span));