@msb235/blits 0.11.0 → 0.12.0

package/dist/held.js

@@ -17,8 +17,11 @@ export function unreachedOf(voice, now) {
     voice.unreached = none;
     return none;
 }
-/** What this voice holds for this subject, made on first sight with `target` and `stagger` asked once. */
-export function held(voice, subject, slot) {
+/**
+ * What this voice holds for this subject, made on first sight with `target` and `stagger` asked
+ * once; `guess` is a record it may be, from the subject's chain as last linked.
+ */
+export function held(voice, subject, slot, guess = null) {
     if (voice.sharing) {
         const all = everyoneOf(this, voice);
         if (all !== null)
@@ -26,7 +29,7 @@ export function held(voice, subject, slot) {
     }
     if (unreached(voice, slot))
         return voice.unreached;
-    let held = voice.subjects.get(subject);
+    let held = (guess === null ? voice.subjects.get(subject) : voice.subjects.find(subject, guess));
     if (held !== undefined)
         return held;
     const now = this.now;

package/dist/history.d.ts

@@ -5,6 +5,10 @@ import { type Subject, type Voice } from './voice.js';
 export declare function last<T extends {
     at: number;
 }>(list: readonly T[], t: number, inclusive: boolean | ((e: T) => boolean)): T | undefined;
+/** Where `last` finds its entry in the list, -1 where it finds none. */
+export declare function lastIndex<T extends {
+    at: number;
+}>(list: readonly T[], t: number, inclusive: boolean | ((e: T) => boolean)): number;
 /**
  * The last entry of a list kept in the order it was made that falls inside `cut`, an entry made
  * before its frame was read counting as `early`.
@@ -21,8 +25,21 @@ export declare function elapsedThen<I, O>(mix: Mixer<I, O>, voice: Voice<I, O>,
 export declare function noted<I, O>(mix: Mixer<I, O>, voice: Voice<I, O>): void;
 /** A copy of the state a voice's patch keeps for a subject. */
 export declare function copyState<I, O>(voice: Voice<I, O>, state: unknown): unknown;
-/** A copy of a subject's record that shares nothing a read could change. */
-export declare function copyHeld<I, O>(voice: Voice<I, O>, h: Subject<unknown>): Subject<unknown>;
+/**
+ * A copy of a subject's record that shares nothing a read could change; with `shared`, its state is
+ * the record's own, for a copy that takes one of its own before it steps.
+ */
+export declare function copyHeld<I, O>(voice: Voice<I, O>, h: Subject<unknown>, shared?: boolean): Subject<unknown>;
+/**
+ * As `copyHeld`, written over `into`, a record nothing else holds, so a copy made in its place
+ * leaves nothing new to collect. test/history.test.ts holds this to `copyHeld` field by field.
+ */
+export declare function copyHeldInto<I, O>(voice: Voice<I, O>, h: Subject<unknown>, into: Subject<unknown>, shared?: boolean): Subject<unknown>;
+/**
+ * Lets go of what a record holds from its last probe and its place in a chain, as a copy of it
+ * starts: a seek puts back a record nothing else holds this way, in place of a copy.
+ */
+export declare function unread(h: Subject<unknown>): Subject<unknown>;
 /** Under `history` with `inputs`, copies the host fields any voice reads, once a frame, when they changed. */
 export declare function recordHost<I, O>(mix: Mixer<I, O>, now: number): void;
 /** Under `history` with `inputs`, keeps what an input signal read, each time it changes. */

package/dist/history.js

@@ -9,14 +9,18 @@ import { within } from './transport.js';
 import { none } from './voice.js';
 /** The last entry taken before `t`, or at it where `inclusive` says so. */
 export function last(list, t, inclusive) {
+    return list[lastIndex(list, t, inclusive)];
+}
+/** Where `last` finds its entry in the list, -1 where it finds none. */
+export function lastIndex(list, t, inclusive) {
     let lo = 0;
     let hi = list.length - 1;
-    let found;
+    let found = -1;
     while (lo <= hi) {
         const mid = (lo + hi) >> 1;
         const e = list[mid];
         if (e.at < t || (e.at === t && (typeof inclusive === 'function' ? inclusive(e) : inclusive))) {
-            found = e;
+            found = mid;
             lo = mid + 1;
         }
         else
@@ -86,45 +90,125 @@ export function noted(mix, voice) {
         pageOut(mix, 'controls', voice.id, undefined, log.splice(0, drop), copied, reach);
 }
 const copied = (e) => ({ ...e });
+const nothing = Object.freeze([]);
 /** Takes off the front of a list kept by time what a read back to `reach` no longer needs. */
 function older(list, reach) {
+    const n = past(list, reach);
+    return n === 0 ? nothing : list.splice(0, n);
+}
+/** How many entries at the front of a list kept by time a read back to `reach` no longer needs. */
+function past(list, reach) {
     let n = 0;
     while (n + 1 < list.length && list[n + 1].at <= reach)
         n++;
-    return n === 0 ? [] : list.splice(0, n);
+    return n;
 }
 /** A copy of the state a voice's patch keeps for a subject. */
 export function copyState(voice, state) {
     const patch = voice.patch;
     return patch.clone ? patch.clone(state) : clone(state);
 }
-/** A copy of a subject's record that shares nothing a read could change. */
-export function copyHeld(voice, h) {
-    let kept = null;
-    if (h.kept !== null) {
-        kept = new Map();
-        for (const [owner, value] of h.kept)
-            kept.set(owner, clone(value));
-    }
-    return {
-        ...h,
+/**
+ * A copy of a subject's record that shares nothing a read could change; with `shared`, its state is
+ * the record's own, for a copy that takes one of its own before it steps.
+ */
+export function copyHeld(voice, h, shared = false) {
+    const kept = keptOf(h);
+    // Every field in `record`'s order, written out: a spread with fields after it costs a third more.
+    return unread({
+        reaches: h.reaches,
+        delay: h.delay,
+        since: h.since,
+        shown: h.shown,
+        weight: h.weight,
+        rested: h.rested,
         bands: h.bands === null ? null : h.bands.slice(),
-        state: h.state === undefined ? undefined : copyState(voice, h.state),
-        kept,
-        unkept: h.unkept?.map(clone),
-        probed: Number.NaN,
-        delta: null,
-        phase: 0,
-        seeks: 0,
+        state: h.state === undefined || shared ? h.state : copyState(voice, h.state),
+        stepped: h.stepped,
+        ticks: h.ticks,
+        probed: h.probed,
+        delta: h.delta,
+        phase: h.phase,
+        seeks: h.seeks,
+        rebuilt: h.rebuilt,
+        copied: h.copied,
         base: h.base === undefined ? undefined : clone(h.base),
         slope: h.slope === undefined ? undefined : clone(h.slope),
-        snaps: undefined,
-        inputs: undefined,
-        next: null,
-        version: Number.NaN,
-        loci: null,
-        slot: -1,
-    };
+        kept,
+        unkept: h.unkept?.map(clone),
+        snaps: h.snaps,
+        from: h.from,
+        unknown: h.unknown,
+        inputs: h.inputs,
+        replay: h.replay,
+        voice: h.voice,
+        next: h.next,
+        version: h.version,
+        loci: h.loci,
+        slot: h.slot,
+        run: h.run,
+        freed: h.freed,
+        // In no store, so stamped by none: a store trusts its stamp to say a record is still its own.
+        restored: null,
+    });
+}
+/** A copy of what a record keeps through `setting.keep`. */
+function keptOf(h) {
+    if (h.kept === null)
+        return null;
+    const kept = new Map();
+    for (const [owner, value] of h.kept)
+        kept.set(owner, clone(value));
+    return kept;
+}
+/**
+ * As `copyHeld`, written over `into`, a record nothing else holds, so a copy made in its place
+ * leaves nothing new to collect. test/history.test.ts holds this to `copyHeld` field by field.
+ */
+export function copyHeldInto(voice, h, into, shared = false) {
+    into.reaches = h.reaches;
+    into.delay = h.delay;
+    into.since = h.since;
+    into.shown = h.shown;
+    into.weight = h.weight;
+    into.rested = h.rested;
+    into.bands = h.bands === null ? null : h.bands.slice();
+    into.state = h.state === undefined || shared ? h.state : copyState(voice, h.state);
+    into.stepped = h.stepped;
+    into.ticks = h.ticks;
+    into.rebuilt = h.rebuilt;
+    into.copied = h.copied;
+    into.base = h.base === undefined ? undefined : clone(h.base);
+    into.slope = h.slope === undefined ? undefined : clone(h.slope);
+    into.kept = keptOf(h);
+    into.unkept = h.unkept?.map(clone);
+    into.from = h.from;
+    into.unknown = h.unknown;
+    into.replay = h.replay;
+    into.voice = h.voice;
+    into.slot = h.slot;
+    into.run = h.run;
+    into.freed = h.freed;
+    into.restored = null;
+    // `probed`, `delta`, `phase`, `seeks`, `snaps`, `inputs`, `next`, `version` and `loci` as
+    // `unread` leaves them.
+    return unread(into);
+}
+/**
+ * Lets go of what a record holds from its last probe and its place in a chain, as a copy of it
+ * starts: a seek puts back a record nothing else holds this way, in place of a copy.
+ */
+export function unread(h) {
+    h.probed = Number.NaN;
+    h.delta = null;
+    h.phase = 0;
+    h.seeks = 0;
+    h.snaps = undefined;
+    h.inputs = undefined;
+    h.next = null;
+    h.version = Number.NaN;
+    h.loci = null;
+    return h;
 }
 /** Under `history` with `inputs`, copies the host fields any voice reads, once a frame, when they changed. */
 export function recordHost(mix, now) {
@@ -168,6 +252,19 @@ export function record(mix, voice, subject, held, value) {
 export function apart(history) {
     return history.every ?? 200;
 }
+/**
+ * A copy of a record to keep now, written over a spare the latest seek back cut, or one just let go
+ * of, where it has one.
+ */
+function snapOf(mix, voice, held, gone) {
+    const spare = voice.spares?.pop() ?? gone;
+    if (spare === undefined)
+        return { at: mix.now, seq: mix.transport.seq, held: copyHeld(voice, held) };
+    spare.at = mix.now;
+    spare.seq = mix.transport.seq;
+    copyHeldInto(voice, held, spare.held);
+    return spare;
+}
 /** Under `history`, keeps a copy of a stateful voice's record for this subject every so often. */
 export function remember(mix, voice, subject, held) {
     const history = mix.opts.history;
@@ -182,11 +279,32 @@ export function remember(mix, voice, subject, held) {
     const prev = snaps[snaps.length - 1];
     if (prev !== undefined && mix.now - prev.at < apart(history))
         return;
-    snaps.push({ at: mix.now, seq: mix.transport.seq, held: copyHeld(voice, held) });
+    // What falls out is the same before the push as after it, since the copy pushed is newer.
     const reach = mix.now - history.ms;
-    const out = older(snaps, reach);
-    if (out.length > 0)
-        pageOut(mix, 'snap', voice.id, mix.keys?.key(subject), out, (e) => packHeld(voice, e.held), reach);
+    const n = past(snaps, reach);
+    let gone;
+    if (n > 0) {
+        if (mix.transport.pager !== null)
+            pageOut(mix, 'snap', voice.id, mix.keys?.key(subject), snaps.slice(0, n), (e) => packHeld(voice, e.held), reach);
+        gone = reusable(snaps, n);
+        // `shift` moves the list's start where `splice` copies what it keeps and allocates what it cuts.
+        if (n === 1)
+            snaps.shift();
+        else
+            snaps.splice(0, n);
+    }
+    snaps.push(snapOf(mix, voice, held, gone));
+}
+/** The first of a list's first `n` copies no other record's list holds, made ready to be written over. */
+function reusable(snaps, n) {
+    for (let i = 0; i < n; i++) {
+        const snap = snaps[i];
+        if (snap.shared)
+            continue;
+        snap.ahead = undefined;
+        return snap;
+    }
+    return undefined;
 }
 /**
  * Under history, keeps the record a subject had when it left a voice, faded out of it or dropped,

package/dist/hosts.js

@@ -1,4 +1,6 @@
+import { release } from './arcs.js';
 import { Book } from './book.js';
+import { headOf } from './chain.js';
 import { numericOf } from './channels.js';
 import { stepOf } from './clock.js';
 import { crowdable } from './crowd.js';
@@ -71,31 +73,44 @@ export function laneHost(mix) {
         },
         passes: (was, w) => mix.passes(was, w),
         naming: (subject) => (mix.naming === 0 ? undefined : mix.named.get(subject)),
-        slotOf: (subject) => mix.chains.get(subject)?.slot ?? -1,
+        slotOf: (subject) => headOf(mix, subject)?.slot ?? -1,
         envelope: (voice, since) => voice.owner === null
             ? mix.envelope(voice, mix.now, since)
             : mix.envelope(voice, mix.now, since) * mix.ownedBy(voice, undefined),
         parting: (voice, subject) => mix.parting(voice, subject, mix.now),
-        ready: (voice, subject, held, elapsed, pass, weight) => {
-            mix.prime(voice, held, mix.now, elapsed, pass);
-            voice.setting.weight = weight;
+        ready: (voice, subject, held) => {
+            const arg = mix.lanes.arg;
+            const primed = mix.primed;
+            primed[0 /* Primed.NOW */] = mix.now;
+            primed[1 /* Primed.ELAPSED */] = arg[1 /* Arg.ELAPSED */];
+            primed[2 /* Primed.PASS */] = arg[3 /* Arg.PASS */];
+            mix.prime(voice, held);
+            voice.setting.weight = arg[0 /* Arg.WEIGHT */];
             mix.sending.voice = voice;
             mix.sending.subject = subject;
         },
-        signal: (voice, subject, held, elapsed, pass, slot) => {
+        signal: (voice, subject, held, slot) => {
+            const arg = mix.lanes.arg;
             // A blend member after the first takes the read already made, with no setting to fill.
             const read = voice.blend === null ? Number.NaN : mix.laneRead(voice, slot);
-            if (!Number.isNaN(read))
-                return read;
-            mix.prime(voice, held, mix.now, elapsed, pass);
+            if (!Number.isNaN(read)) {
+                arg[0 /* Arg.WEIGHT */] = read;
+                return;
+            }
+            const primed = mix.primed;
+            primed[0 /* Primed.NOW */] = mix.now;
+            primed[1 /* Primed.ELAPSED */] = arg[1 /* Arg.ELAPSED */];
+            primed[2 /* Primed.PASS */] = arg[3 /* Arg.PASS */];
+            mix.prime(voice, held);
             const kept = reading.kept;
             const base = mix.base(voice, subject, mix.now, held, slot);
             if (reading.kept !== kept && !voice.keeping)
                 stateful(mix, voice);
-            return base;
+            arg[0 /* Arg.WEIGHT */] = base;
         },
         horizon: (voice, delay) => {
-            reading.horizon = mix.horizonFor(voice, delay, mix.now);
+            if (voice.motion !== undefined)
+                reading.horizon = mix.horizonFor(voice, delay, mix.now);
         },
         keeps: mix.opts.history !== undefined,
         after: (voice, subject, held) => remember(mix, voice, subject, held),
@@ -224,12 +239,13 @@ function handleHost(mix) {
                 beginFade(mix, voice, (opts ?? {}));
         },
         rise: (voice, opts) => beginRise(mix, voice, opts ?? {}),
+        release: (voice) => release(mix, voice),
         weightOf: (voice, subject) => {
             if (voice.state === 'done')
                 return 0;
             if (voice.holding !== null)
                 return ownWeight(voice, mix.now, mix.reducedNow, (o) => mix.ownerBase(o, subject));
-            const slot = mix.lanes === null ? -1 : (mix.chains.get(subject)?.slot ?? -1);
+            const slot = mix.lanes === null ? -1 : (headOf(mix, subject)?.slot ?? -1);
             if (voice.laned && mix.lanes !== null) {
                 const w = mix.lanes.weightOf(voice.id, slot);
                 if (w !== undefined)

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { NumberOptions, Vec } from './channels.js';
 export { kit, last, max, mul, sum, vec } from './channels.js';
 export type { ColorOptions } from './color.js';
 export { color, css, mixHex, oklab, toHex } from './color.js';
+export type { Curve } from './easing.js';
+export { curve } from './easing.js';
 export type { Claim, Fit, FitPlan, Order, SpanClaim, Strength } from './fit.js';
 export { conclude, condense, lax, layout, overrun, pipe, plain, shed, } from './fit.js';
 export { mix, mixer } from './mixer.js';
@@ -17,6 +19,7 @@ export { fold } from './stack.js';
 export type { Ticked, Ticker, TickerOptions } from './ticker.js';
 export { ticker } from './ticker.js';
 export { transport } from './transport.js';
-export type { Anchor, BlendMember, BookedHit, Booker, BookOptions, Channel, Columns, Described, Doubt, Easing, Engine, FadeOptions, FadeSpec, FitResult, Handle, HistoryOptions, HistoryStore, Hit, Keyframe, Kit, Mark, Marked, MarkName, Mix, MixOptions, MotionSpec, OwnerSpec, Paged, PagedStream, Patch, Placement, Projection, Query, SeekOptions, Sent, Setting, Signal, SpanHandle, SpanHints, SpanSpec, Tape, TapeBranch, TapeMaker, TapeOp, Transport, TransportOptions, TransportProjection, VoiceSpec, } from './types.js';
+export type { Anchor, ArcHandle, ArcPart, ArcSpec, ArcVoice, BlendMember, BookedHit, Booker, BookOptions, Channel, Columns, Described, Doubt, Easing, Engine, FadeOptions, FadeSpec, FitResult, Handle, HistoryOptions, HistoryStore, Hit, Hold, Keyframe, Kit, Mark, Marked, MarkName, Mix, MixOptions, MotionSpec, OwnerSpec, Paged, PagedStream, Patch, Placement, Projection, Query, Registry, SeekOptions, Sent, Setting, Signal, SpanHandle, SpanHints, SpanSpec, Tape, TapeBranch, TapeMaker, TapeOp, Transport, TransportOptions, TransportProjection, VoiceSpec, Watched, WatchedFrame, } from './types.js';
+export { watched } from './watch.js';
 export type { WaveOptions, WaveShape } from './wave.js';
 export { wave, waveAt } from './wave.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 export { kit, last, max, mul, sum, vec } from './channels.js';
 export { color, css, mixHex, oklab, toHex } from './color.js';
+export { curve } from './easing.js';
 export { conclude, condense, lax, layout, overrun, pipe, plain, shed, } from './fit.js';
 export { mix, mixer } from './mixer.js';
 export { glide, spring, tween } from './motion.js';
@@ -10,4 +11,5 @@ export { gate, input, lag, level, peak, share, slew } from './signals.js';
 export { fold } from './stack.js';
 export { ticker } from './ticker.js';
 export { transport } from './transport.js';
+export { watched } from './watch.js';
 export { wave, waveAt } from './wave.js';

package/dist/lanes.d.ts

@@ -33,14 +33,18 @@ export interface LaneHost<I, O> {
     envelope(voice: Voice<I, O>, since: number): number;
     /** What a subject's own ramp out of the voice leaves of its weight, 0..1. */
     parting(voice: Voice<I, O>, subject: I): number;
-    /** Fills the voice's setting and the send target for a call to its patch. */
-    ready(voice: Voice<I, O>, subject: I, held: Subject<unknown>, elapsed: number, pass: number, weight: number): void;
     /**
-     * A voice with a signal weight: the signal's value for a subject the general path has met, before
-     * the fade and ramp `weighed` applies, with the setting filled in for the call; makes the voice
-     * stateful if the signal keeps state. `slot` is the subject's number.
+     * Fills the voice's setting and the send target for a call to its patch, at the voice time, pass
+     * and weight in `Arg.ELAPSED`, `Arg.PASS` and `Arg.WEIGHT`.
      */
-    signal(voice: Voice<I, O>, subject: I, held: Subject<unknown>, elapsed: number, pass: number, slot: number): number;
+    ready(voice: Voice<I, O>, subject: I, held: Subject<unknown>): void;
+    /**
+     * A voice with a signal weight: the signal's value for a subject the general path has met, at the
+     * voice time and pass in `Arg.ELAPSED` and `Arg.PASS`, left in `Arg.WEIGHT` before the fade and
+     * ramp `weighed` applies, with the setting filled in for the call; makes the voice stateful if the
+     * signal keeps state. `slot` is the subject's number.
+     */
+    signal(voice: Voice<I, O>, subject: I, held: Subject<unknown>, slot: number): void;
     /** Whether a rest-less channel's contribution passes the band, as the general path decides it. */
     passes(was: boolean | undefined, w: number): boolean;
     /** Sets `reading.horizon` for the voice and a subject delayed `delay` voice ms. */
@@ -176,7 +180,12 @@ export declare class Lanes<I, O> implements Watcher {
     lately: number;
     filledVersion: number;
     qualifiedVersion: number;
-    constructor(host: LaneHost<I, O>);
+    /**
+     * With `from`, the lanes a seek replaces: their subject numbers carry over, each met as newly
+     * numbered when its chain is next linked (`renew`), so a seek makes no new weak reference per
+     * subject.
+     */
+    constructor(host: LaneHost<I, O>, from?: Lanes<I, O>);
     /** A change that may move a voice on or off its lane: qualify again, then fill again. */
     invalidate(): void;
     /** A change to a laned voice's weight or clock between probes: fill again. */
@@ -189,6 +198,13 @@ export declare class Lanes<I, O> implements Watcher {
     /** Numbers a subject the mix sees for the first time. */
     number(subject: I): number;
     release(slot: number): void;
+    /** Whether `slot` is a number a seek carried over whose chain has not been linked since. */
+    sought(slot: number): boolean;
+    /**
+     * A chain is being linked for the subject at `slot`: one a seek carried over is from now on as
+     * `number` leaves a subject it numbers. Says whether it was one.
+     */
+    renew(slot: number): boolean;
     /** A voice faded a subject out of itself alone: its lane lets the subject's position go. */
     part(id: number, slot: number): void;
     /** A voice brought a subject back: its next probe meets every lane again, as it met them first. */

package/dist/lanes.js

@@ -134,9 +134,27 @@ export class Lanes {
     lately = -1;
     filledVersion = Number.NaN;
     qualifiedVersion = Number.NaN;
-    constructor(host) {
+    /**
+     * With `from`, the lanes a seek replaces: their subject numbers carry over, each met as newly
+     * numbered when its chain is next linked (`renew`), so a seek makes no new weak reference per
+     * subject.
+     */
+    constructor(host, from) {
         this.host = host;
-        this.numbers = new Numbers(this);
+        if (from === undefined) {
+            this.numbers = new Numbers(this);
+            return;
+        }
+        this.numbers = from.numbers;
+        this.numbers.adopt(this);
+        this.live = from.live;
+        const size = this.numbers.size;
+        this.grow(size);
+        const per = this.per;
+        for (let slot = 0; slot < size; slot++) {
+            per[slot * 6 /* Per.SLOT */ + 0 /* Per.FILLED */] = Number.NaN;
+            per[slot * 6 /* Per.SLOT */ + 1 /* Per.SEEN */] = -1;
+        }
     }
     /** A change that may move a voice on or off its lane: qualify again, then fill again. */
     invalidate() {
@@ -173,6 +191,22 @@ export class Lanes {
     release(slot) {
         this.numbers.release(slot);
     }
+    /** Whether `slot` is a number a seek carried over whose chain has not been linked since. */
+    sought(slot) {
+        return Number.isNaN(this.per[slot * 6 /* Per.SLOT */ + 0 /* Per.FILLED */]);
+    }
+    /**
+     * A chain is being linked for the subject at `slot`: one a seek carried over is from now on as
+     * `number` leaves a subject it numbers. Says whether it was one.
+     */
+    renew(slot) {
+        if (!this.sought(slot))
+            return false;
+        this.per[slot * 6 /* Per.SLOT */ + 0 /* Per.FILLED */] = this.fills;
+        if (this.filling)
+            this.late.push(slot);
+        return true;
+    }
     /** A voice faded a subject out of itself alone: its lane lets the subject's position go. */
     part(id, slot) {
         const lane = this.byId.get(id);

package/dist/lean.js

@@ -1,4 +1,4 @@
-import { Mixer } from './mixer.js';
+import { made } from './mixer.js';
 export * from './index.js';
 /**
  * The stock engine without lanes: every voice folds subject by subject, to the same values, and a
@@ -10,7 +10,7 @@ export const lean = {
     name: 'lean',
     runs: new Set(['fn', 'keys', 'motion']),
     create(kit, opts) {
-        return new Mixer(kit, opts, null);
+        return made(kit, opts, null);
     },
 };
 /**

package/dist/marks.js

@@ -1,3 +1,4 @@
+import { arcMark } from './arcs.js';
 import { inPass } from './book.js';
 import { startOf } from './place.js';
 import { none } from './voice.js';
@@ -105,6 +106,8 @@ export function markOf(mix, voice, mark) {
         return undefined;
     if (mark === 'start')
         return start;
+    if (voice.arc !== null && (mark === 'in' || mark === 'coast' || mark === 'out' || mark === 'end'))
+        return arcMark(voice, start, mark);
     if (mark === 'in')
         return start + (voice.fade.in ?? 0);
     if (mark === 'coast')

package/dist/mixer.d.ts

@@ -1,3 +1,4 @@
+import { type Arc } from './arcs.js';
 import { blended, laneRead, shareKept } from './blend.js';
 import type { Book } from './book.js';
 import { aims, chain, linkable, relink } from './chain.js';
@@ -22,7 +23,7 @@ import { ScoreIndex } from './scored.js';
 import { Fitting } from './spans.js';
 import { Store } from './store.js';
 import { type Announced, Transport } from './transport.js';
-import type { BlendMember, Booker, BookOptions, Channel, Columns, Engine, Handle, Kit, Marked, Mix, MixOptions, OwnerSpec, Patch, Projection, Sent, Signal, SpanHandle, SpanSpec, Tape, VoiceSpec } from './types.js';
+import type { ArcHandle, ArcSpec, BlendMember, Booker, BookOptions, Channel, Columns, Engine, Handle, Kit, Marked, Mix, MixOptions, OwnerSpec, Patch, Projection, Sent, Signal, SpanHandle, SpanSpec, Tape, VoiceSpec } from './types.js';
 import { type Subject, type Voice } from './voice.js';
 import { base, capped, fadeOf, horizonFor, ownedBy, ownerBase, prime, weigh, weighOwned } from './weigh.js';
 /**
@@ -127,6 +128,8 @@ export declare class Mixer<I, O> implements Mix<I, O> {
      */
     chains: Store<I, Subject<unknown>>;
     version: number;
+    /** What `prime` reads its clock, voice time and pass from: see `Primed`. */
+    readonly primed: Float64Array<ArrayBuffer>;
     readonly steps: Steps<Voice<I, O>, I>;
     /** Per subject, the voices whose `subjects` name it, in voice order. */
     named: Store<I, Voice<I, O>[]>;
@@ -179,6 +182,8 @@ export declare class Mixer<I, O> implements Mix<I, O> {
     readonly bounded: number[];
     /** By slot, a stock array channel's in-place `lerp`. */
     readonly lerpsInto: (LerpInto | undefined)[];
+    /** By slot, a stock scalar channel's arithmetic, which a fold applies without calling the channel. */
+    readonly scalars: ('sum' | 'mul' | 'max' | undefined)[];
     /** What a fold with a locus in play gathers into, one per depth of folds under way. */
     readonly locusScratch: LocusScratch<I, O>[];
     locusDepth: number;
@@ -189,6 +194,8 @@ export declare class Mixer<I, O> implements Mix<I, O> {
     bookers: Book<I, O>[] | null;
     /** The fit a span being cued takes, which `cue` hands its voice. */
     fitting: Fitting | null;
+    /** What an arc being cued keeps, which `cue` hands its voice. */
+    arcing: Arc | null;
     /** Every owner still in the mix, null until one is cued. */
     owners: Voice<I, O>[] | null;
     /** With a history store, the key each subject is paged under; null without one. */
@@ -226,6 +233,7 @@ export declare class Mixer<I, O> implements Mix<I, O> {
     blend(members: readonly (Patch<I, O, unknown> | BlendMember<I, O>)[], by: Signal<I>, spec?: Omit<VoiceSpec<I, O>, 'patch' | 'weight' | 'locus'>): Handle<I>[];
     owns(spec: OwnerSpec<I>): Handle<I>;
     span(spec: SpanSpec<I>): SpanHandle<I>;
+    arc(spec: ArcSpec<I, O>): ArcHandle<I>;
     sync(timestamp: number): void;
     book<E = unknown>(opts: BookOptions<E, I>): Booker;
     probe(subject: I, out?: O): O;
@@ -260,6 +268,10 @@ export declare class Mixer<I, O> implements Mix<I, O> {
         over?: number;
     }): void;
     drop(subject: I): void;
+    /** Lets `voice` go of a dropped subject. Methods rather than closures, so a drop makes neither. */
+    private forgetIn;
+    private releaseIn;
+    private recordDrop;
     touch(subject?: I): void;
     drain<E = unknown>(tag?: string): Sent<I, E>[];
     /** Voices whose stop 0 is mid-computation, so a fold for one cannot re-enter itself. */
@@ -328,6 +340,8 @@ declare const methods: {
 type Methods = typeof methods;
 export interface Mixer<I, O> extends Methods {
 }
+/** Makes a mix the host asked for, with the registry's history where it names none, and lists it there. */
+export declare function made<I, O, H>(kit: Kit<O>, opts: MixOptions<H>, lanes: typeof Lanes | null): Mix<I, O, H>;
 /**
  * The one that ships: every form on the CPU, probed per subject on demand.
  *