@ecopoesis/homebridge-dmx 0.5.5 → 0.6.0

package/dist/show/dsl.js

@@ -0,0 +1,326 @@
+// Show DSL — parameterized step lists, resolved at config load.
+//
+// Vocabulary borrows from the DMX chaser convention shared by QLC+, the
+// Nicolaudie ESA/Sunlite scene editor and node-dmx's Animation: a show is
+// a list of STEPS; each step names a LOOK (targets → colors) and the FADE
+// time to crossfade into it plus a HOLD time to sit on it. Unmentioned
+// targets TRACK their previous value (theatrical cue-list tracking). When
+// the last step ends the show loops back to the first (default) or stops.
+//
+//   palette:
+//     surprise pink: "#f2a1ff"           # optional user color names
+//
+//   shows:
+//     - id: crossfade                    # template: params without defaults
+//       params: { a: ~, b: ~, secs: 10 } #   → no HomeKit switch
+//       steps:
+//         - look: { up: $a, down: $b }
+//           fade: $secs
+//         - look: { up: $b, down: $a }
+//           fade: $secs
+//
+//     - id: texture                      # instance: all params bound
+//       name: Texture                    #   → one HomeKit Switch
+//       extends: crossfade
+//       params: { a: indigo, b: surprise pink, secs: 20 }
+//
+// Look targets are fixture ids, zone ids, group ids (top-level `groups:`,
+// named fixture sets with no HomeKit tile) or `all`; a key may list several
+// separated by commas. Later keys override earlier ones. `$params` are
+// substituted in values only, never in target keys. Color specs: see
+// colors.ts. Times are seconds (number) or "500ms" / "10s" / "2m".
+import { colorKey, parseColor } from './colors.js';
+export const EASES = ['linear', 'sine'];
+export function parseDuration(v, what) {
+    if (v == null)
+        return 0;
+    if (typeof v === 'number') {
+        if (!Number.isFinite(v) || v < 0)
+            throw new Error(`${what}: must be >= 0 seconds`);
+        return Math.round(v * 1000);
+    }
+    if (typeof v === 'string') {
+        const m = v.trim().toLowerCase().match(/^(\d*\.?\d+)\s*(ms|s|sec|secs|m|min|mins)?$/);
+        if (m) {
+            const n = Number(m[1]);
+            const unit = m[2] ?? 's';
+            if (unit === 'ms')
+                return Math.round(n);
+            if (unit.startsWith('m'))
+                return Math.round(n * 60_000);
+            return Math.round(n * 1000);
+        }
+    }
+    throw new Error(`${what}: bad duration "${v}" (use seconds, or "500ms" / "10s" / "2m")`);
+}
+export function parsePalette(raw) {
+    const pal = new Map();
+    if (raw == null)
+        return pal;
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('palette: must be a map of name → color');
+    }
+    for (const [name, spec] of Object.entries(raw)) {
+        try {
+            pal.set(colorKey(name), parseColor(spec, pal));
+        }
+        catch (e) {
+            throw new Error(`palette "${name}": ${e.message}`);
+        }
+    }
+    return pal;
+}
+// ── parameter substitution ─────────────────────────────────────────────────
+const WHOLE_PARAM = /^\$\{?([A-Za-z_][A-Za-z0-9_]*)\}?$/;
+const INLINE_PARAM = /\$\{?([A-Za-z_][A-Za-z0-9_]*)\}?/g;
+/** Deep-substitute `$name` / `${name}` in `value`. A string that is exactly
+ *  one reference becomes the param's value with its own type (so
+ *  `fade: $secs` stays numeric); otherwise references interpolate as text. */
+export function substitute(value, params, where) {
+    if (typeof value === 'string') {
+        const whole = value.match(WHOLE_PARAM);
+        if (whole)
+            return lookup(whole[1]);
+        return value.replace(INLINE_PARAM, (_m, name) => String(lookup(name)));
+    }
+    if (Array.isArray(value))
+        return value.map((v, i) => substitute(v, params, `${where}[${i}]`));
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = substitute(v, params, `${where}.${k}`);
+        }
+        return out;
+    }
+    return value;
+    function lookup(name) {
+        if (!(name in params))
+            throw new Error(`${where}: unknown param "$${name}"`);
+        const v = params[name];
+        if (v == null)
+            throw new Error(`${where}: param "$${name}" has no value`);
+        return v;
+    }
+}
+/** Collect the param names referenced anywhere in a value tree. */
+function referencedParams(value, out = new Set()) {
+    if (typeof value === 'string') {
+        for (const m of value.matchAll(INLINE_PARAM))
+            out.add(m[1]);
+    }
+    else if (Array.isArray(value)) {
+        for (const v of value)
+            referencedParams(v, out);
+    }
+    else if (value && typeof value === 'object') {
+        for (const v of Object.values(value))
+            referencedParams(v, out);
+    }
+    return out;
+}
+/** Merge a show onto its `extends` chain: child params/name/loop/defaults
+ *  override, steps come from the nearest ancestor that defines them. */
+function flatten(spec, byId, trail = []) {
+    if (trail.includes(spec.id)) {
+        throw new Error(`show "${spec.id}": extends cycle ${[...trail, spec.id].join(' → ')}`);
+    }
+    let base = {
+        id: spec.id, name: spec.id, params: {}, steps: [], loop: true, switch: true,
+    };
+    if (spec.extends) {
+        const parent = byId.get(spec.extends);
+        if (!parent)
+            throw new Error(`show "${spec.id}": extends unknown show "${spec.extends}"`);
+        base = flatten(parent, byId, [...trail, spec.id]);
+    }
+    if (spec.params != null && (typeof spec.params !== 'object' || Array.isArray(spec.params))) {
+        throw new Error(`show "${spec.id}": params must be a map`);
+    }
+    if (spec.steps != null && !Array.isArray(spec.steps)) {
+        throw new Error(`show "${spec.id}": steps must be an array`);
+    }
+    return {
+        id: spec.id,
+        name: spec.name ?? spec.id,
+        params: { ...base.params, ...(spec.params ?? {}) },
+        steps: spec.steps ?? base.steps,
+        loop: spec.loop ?? base.loop,
+        fade: spec.fade ?? base.fade,
+        hold: spec.hold ?? base.hold,
+        ease: spec.ease ?? base.ease,
+        switch: spec.switch ?? base.switch,
+    };
+}
+function parseEase(v, what) {
+    if (v == null)
+        return 'linear';
+    if (typeof v === 'string' && EASES.includes(v))
+        return v;
+    throw new Error(`${what}: ease must be one of ${EASES.join(', ')}`);
+}
+/** Named fixture sets for show targets: `groups: { odd: [id, id, ...] }`.
+ *  Unlike zones they create no HomeKit accessory. Ids may be fixture ids
+ *  or zone ids; group ids must not collide with either. */
+export function parseGroups(raw, fixtures, zones) {
+    const groups = new Map();
+    if (raw == null)
+        return groups;
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error('groups: must be a map of group id → [fixture or zone ids]');
+    }
+    const fixturesById = new Map(fixtures.map((f) => [f.id, f]));
+    const zonesById = new Map(zones.map((z) => [z.id, z]));
+    for (const [id, members] of Object.entries(raw)) {
+        if (fixturesById.has(id) || zonesById.has(id)) {
+            throw new Error(`group "${id}": collides with a fixture or zone id`);
+        }
+        if (!Array.isArray(members) || members.length === 0) {
+            throw new Error(`group "${id}": must be a non-empty array of fixture or zone ids`);
+        }
+        const out = [];
+        for (const m of members) {
+            const fx = fixturesById.get(String(m));
+            const z = zonesById.get(String(m));
+            if (fx)
+                out.push(fx);
+            else if (z)
+                out.push(...z.members);
+            else
+                throw new Error(`group "${id}": unknown fixture or zone "${m}"`);
+        }
+        groups.set(id, out);
+    }
+    return groups;
+}
+export function loadShows(specs, fixtures, zones, groups, palette) {
+    const byId = new Map();
+    for (const s of specs) {
+        if (!s || typeof s !== 'object' || !s.id)
+            throw new Error('show: missing id');
+        if (byId.has(s.id))
+            throw new Error(`show: duplicate id "${s.id}"`);
+        byId.set(s.id, s);
+    }
+    const fixturesById = new Map(fixtures.map((f) => [f.id, f]));
+    const targetsById = new Map();
+    for (const z of zones)
+        targetsById.set(z.id, z.members);
+    for (const [id, members] of groups)
+        targetsById.set(id, members);
+    const shows = [];
+    for (const spec of specs) {
+        const flat = flatten(spec, byId);
+        const tag = `show "${flat.id}"`;
+        if (flat.steps.length === 0)
+            throw new Error(`${tag}: no steps (define steps or extend a show that has them)`);
+        // Params: every reference must be declared; unbound ones make the show
+        // a template (no switch) rather than an error, so a base show can
+        // carry `params: { a: ~ }` purely as documentation of its inputs.
+        const referenced = referencedParams({ steps: flat.steps, fade: flat.fade, hold: flat.hold, ease: flat.ease });
+        for (const p of referenced) {
+            if (!(p in flat.params))
+                throw new Error(`${tag}: references undeclared param "$${p}"`);
+        }
+        const unbound = Object.entries(flat.params).filter(([, v]) => v == null).map(([k]) => k);
+        const runnable = unbound.length === 0;
+        if (!runnable) {
+            shows.push({
+                id: flat.id, name: flat.name, loop: flat.loop, runnable, unboundParams: unbound,
+                exposeSwitch: false, fixtures: [], steps: [], cycleMs: 0,
+            });
+            continue;
+        }
+        const stepsRaw = substitute(flat.steps, flat.params, `${tag}.steps`);
+        const defFade = parseDuration(substitute(flat.fade, flat.params, `${tag}.fade`), `${tag}.fade`);
+        const defHold = parseDuration(substitute(flat.hold, flat.params, `${tag}.hold`), `${tag}.hold`);
+        const defEase = parseEase(substitute(flat.ease, flat.params, `${tag}.ease`), `${tag}.ease`);
+        // Pass 1: each step's explicitly-named fixtures.
+        const explicit = [];
+        const involved = new Map();
+        const parsed = [];
+        stepsRaw.forEach((st, i) => {
+            const stag = `${tag} step ${i + 1}`;
+            if (!st || typeof st !== 'object')
+                throw new Error(`${stag}: must be a map`);
+            if (!st.look || typeof st.look !== 'object' || Array.isArray(st.look)) {
+                throw new Error(`${stag}: needs a "look" map of target → color`);
+            }
+            const look = new Map();
+            for (const [targetKey, colorSpec] of Object.entries(st.look)) {
+                let color;
+                try {
+                    color = parseColor(colorSpec, palette);
+                }
+                catch (e) {
+                    throw new Error(`${stag} look "${targetKey}": ${e.message}`);
+                }
+                for (const fx of expandTargets(targetKey, fixturesById, targetsById, stag)) {
+                    look.set(fx.id, color);
+                    involved.set(fx.id, fx);
+                }
+            }
+            explicit.push(look);
+            parsed.push({
+                fadeMs: st.fade == null ? defFade : parseDuration(st.fade, `${stag}.fade`),
+                holdMs: st.hold == null ? defHold : parseDuration(st.hold, `${stag}.hold`),
+                ease: st.ease == null ? defEase : parseEase(st.ease, `${stag}.ease`),
+            });
+        });
+        // Pass 2: tracking. Walk the steps twice for looping shows so step 0
+        // inherits from the tail of the cycle; once for one-shots.
+        const carry = new Map();
+        const passes = flat.loop ? 2 : 1;
+        const targets = explicit.map(() => new Map());
+        for (let p = 0; p < passes; p++) {
+            explicit.forEach((look, i) => {
+                for (const [id, c] of look)
+                    carry.set(id, c);
+                targets[i] = new Map(carry);
+            });
+        }
+        if (involved.size === 0)
+            throw new Error(`${tag}: no step names any fixture`);
+        const steps = parsed.map((p, i) => ({ targets: targets[i], ...p }));
+        const cycleMs = steps.reduce((s, st) => s + st.fadeMs + st.holdMs, 0);
+        if (cycleMs <= 0)
+            throw new Error(`${tag}: needs some fade or hold time`);
+        shows.push({
+            id: flat.id,
+            name: flat.name,
+            loop: flat.loop,
+            runnable: true,
+            unboundParams: [],
+            exposeSwitch: flat.switch,
+            fixtures: [...involved.values()],
+            steps,
+            cycleMs,
+        });
+    }
+    return shows;
+}
+function expandTargets(key, fixturesById, targetsById, // zones + groups
+where) {
+    const out = [];
+    for (const raw of key.split(/[,\s]+/)) {
+        const t = raw.trim();
+        if (!t)
+            continue;
+        const fx = fixturesById.get(t);
+        if (fx) {
+            out.push(fx);
+            continue;
+        }
+        const set = targetsById.get(t);
+        if (set) {
+            out.push(...set);
+            continue;
+        }
+        if (t === 'all' || t === '*') {
+            out.push(...fixturesById.values());
+            continue;
+        }
+        throw new Error(`${where}: unknown target "${t}" (not a fixture, zone or group id, or "all")`);
+    }
+    return out;
+}
+//# sourceMappingURL=dsl.js.map

package/dist/show/dsl.js.map

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

package/dist/show/engine.d.ts

@@ -0,0 +1,50 @@
+import type { Logger } from 'homebridge';
+import { Fixture } from '../config.js';
+import { HomeKitLightState } from '../color/types.js';
+import { DmxController } from '../dmxController.js';
+import { StateRegistry } from '../stateRegistry.js';
+import { LookColor } from './colors.js';
+import { Show } from './dsl.js';
+export type ShowListener = (runningId: string | null) => void;
+export declare class ShowEngine {
+    private readonly controllers;
+    private readonly registry;
+    private readonly log;
+    private run;
+    private listeners;
+    private lastEmitted;
+    private shows;
+    constructor(shows: Show[], controllers: Map<string, DmxController>, registry: StateRegistry, log: Logger);
+    running(): string | null;
+    onChange(cb: ShowListener): () => void;
+    start(id: string): void;
+    /** Stop the running show, freezing the lights where they are: the
+     *  registry gets the last frame that actually went on the wire. `except`
+     *  names a fixture whose registry state must NOT be overwritten (it was
+     *  just set from HomeKit and is the reason we're stopping). */
+    stop(reason?: string, except?: string): void;
+    /** `notify: false` on a handoff inside start(): the switches hear one
+     *  transition (A → B) instead of A → nothing → B, which would bounce
+     *  the tapped tile off and back on. */
+    private stopRun;
+    shutdown(): void;
+    /** Notify switches of the running show — only on an actual transition,
+     *  so the handoff inside start() (stop A, start B) doesn't bounce B's
+     *  tile off and back on. */
+    private emit;
+    private fixture;
+    private tick;
+    private applyFinal;
+    /** Where every fixture is at wall-clock `now`. Null once a one-shot show
+     *  has run past its end. */
+    private frameAt;
+}
+export declare function fromState(s: HomeKitLightState): LookColor;
+/** Shape a look for a specific fixture: only the characteristics its color
+ *  model exposes, HomeKit-style on/brightness. A dark look parks the
+ *  brightness at 100 so the next HomeKit "on" restores full (mirrors
+ *  hsvcct.parse). `precise` keeps fractional values — the wire path
+ *  renders 16-bit intensity, so fades stay smooth below 1 % steps; the
+ *  registry (HomeKit) gets integers. */
+export declare function toState(look: LookColor, fx: Fixture, precise?: boolean): HomeKitLightState;
+//# sourceMappingURL=engine.d.ts.map

package/dist/show/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/show/engine.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAW,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,MAAM,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAgB9D,qBAAa,UAAU;IAQnB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,KAAK,CAA2B;gBAGtC,KAAK,EAAE,IAAI,EAAE,EACI,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM;IAY9B,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,IAAI;IAKtC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA0CvB;;;mEAG+D;IAC/D,IAAI,CAAC,MAAM,SAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpD;;2CAEuC;IACvC,OAAO,CAAC,OAAO;IAgBf,QAAQ,IAAI,IAAI;IAIhB;;gCAE4B;IAC5B,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,IAAI;IAiCZ,OAAO,CAAC,UAAU;IAalB;gCAC4B;IAC5B,OAAO,CAAC,OAAO;CAoChB;AAID,wBAAgB,SAAS,CAAC,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAMzD;AAED;;;;;wCAKwC;AACxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,iBAAiB,CAexF"}

package/dist/show/engine.js

@@ -0,0 +1,264 @@
+// ShowEngine — runs at most one show at a time.
+//
+// Every frame (the involved controllers' fastest frame interval, 25 Hz on
+// sACN) the engine works out where each fixture is between the previous
+// step's look and the current one, renders it through the controller
+// (quietly — no per-frame logging) and moves on. The registry only hears
+// about it at step boundaries (throttled) and when the show stops, so
+// HomeKit tiles track the show without a 25 Hz event storm.
+//
+// Rules:
+//   - starting a show stops whichever one was running (its switch flips off)
+//   - the first fade starts from the fixtures' live registry state, so a
+//     show fades IN from whatever the lights were doing
+//   - stopping freezes the lights on the current frame and writes that
+//     frame to the registry (so tiles are accurate)
+//   - a HomeKit change to any fixture in the running show stops the show;
+//     the fixture that was touched keeps the user's new value
+import { SHOW_FRAME_MS_DEFAULT, SHOW_KEYFRAME_MIN_MS } from '../settings.js';
+import { mixLook } from './colors.js';
+export class ShowEngine {
+    controllers;
+    registry;
+    log;
+    run = null;
+    listeners = new Set();
+    lastEmitted = null;
+    shows = new Map();
+    constructor(shows, controllers, registry, log) {
+        this.controllers = controllers;
+        this.registry = registry;
+        this.log = log;
+        for (const s of shows)
+            this.shows.set(s.id, s);
+        // Any HomeKit change to a fixture in the running show ends the show.
+        registry.onChange((id, source) => {
+            if (source !== 'homekit' || !this.run)
+                return;
+            if (this.run.fixtures.has(id)) {
+                this.stop(`"${id}" changed from HomeKit`, id);
+            }
+        });
+    }
+    running() {
+        return this.run?.show.id ?? null;
+    }
+    onChange(cb) {
+        this.listeners.add(cb);
+        return () => this.listeners.delete(cb);
+    }
+    start(id) {
+        const show = this.shows.get(id);
+        if (!show) {
+            this.log.error(`show "${id}": unknown`);
+            return;
+        }
+        if (!show.runnable) {
+            this.log.error(`show "${id}": unbound params (${show.unboundParams.join(', ')})`);
+            return;
+        }
+        if (this.run?.show.id === id)
+            return;
+        if (this.run)
+            this.stopRun(`"${id}" starting`, undefined, false);
+        const snapshot = new Map();
+        for (const fx of show.fixtures)
+            snapshot.set(fx.id, fromState(this.registry.get(fx.id)));
+        // One timer drives every involved controller, so tick at the SLOWEST
+        // frame interval among them: flooding the Stick with 25 Hz sets would
+        // keep resetting its debounce and it would never transact at all.
+        const frameMs = show.fixtures.reduce((max, fx) => {
+            const c = this.controllers.get(fx.controller.id);
+            return Math.max(max, c?.frameIntervalMs ?? SHOW_FRAME_MS_DEFAULT);
+        }, 0) || SHOW_FRAME_MS_DEFAULT;
+        const run = {
+            show,
+            startedAt: Date.now(),
+            timer: setInterval(() => this.tick(), frameMs),
+            snapshot,
+            fixtures: new Map(show.fixtures.map((f) => [f.id, f])),
+            frameMs,
+            lastFrame: null,
+            lastKeyframeStep: -1,
+            lastKeyframeAt: 0,
+        };
+        run.timer.unref?.();
+        this.run = run;
+        this.log.info(`show "${show.id}" started: ${show.steps.length} steps, ${show.fixtures.length} fixtures, ` +
+            `cycle ${(show.cycleMs / 1000).toFixed(1)} s, ${show.loop ? 'looping' : 'one-shot'}, ` +
+            `${frameMs} ms frames`);
+        this.tick();
+        this.emit();
+    }
+    /** Stop the running show, freezing the lights where they are: the
+     *  registry gets the last frame that actually went on the wire. `except`
+     *  names a fixture whose registry state must NOT be overwritten (it was
+     *  just set from HomeKit and is the reason we're stopping). */
+    stop(reason = 'switched off', except) {
+        this.stopRun(reason, except, true);
+    }
+    /** `notify: false` on a handoff inside start(): the switches hear one
+     *  transition (A → B) instead of A → nothing → B, which would bounce
+     *  the tapped tile off and back on. */
+    stopRun(reason, except, notify) {
+        const run = this.run;
+        if (!run)
+            return;
+        clearInterval(run.timer);
+        this.run = null;
+        // Before the first tick nothing has been sent; after a one-shot's end
+        // the final look is on the wire (see applyFinal).
+        const frozen = run.lastFrame ?? run.show.steps[run.show.steps.length - 1].targets;
+        for (const [id, look] of frozen) {
+            if (id === except)
+                continue;
+            this.registry.set(id, toState(look, this.fixture(run, id)), 'show');
+        }
+        this.log.info(`show "${run.show.id}" stopped (${reason})`);
+        if (notify)
+            this.emit();
+    }
+    shutdown() {
+        if (this.run) {
+            clearInterval(this.run.timer);
+            this.run = null;
+        }
+    }
+    /** Notify switches of the running show — only on an actual transition,
+     *  so the handoff inside start() (stop A, start B) doesn't bounce B's
+     *  tile off and back on. */
+    emit() {
+        const id = this.running();
+        if (id === this.lastEmitted)
+            return;
+        this.lastEmitted = id;
+        for (const l of this.listeners)
+            l(id);
+    }
+    fixture(run, id) {
+        return run.fixtures.get(id);
+    }
+    tick() {
+        const run = this.run;
+        if (!run)
+            return;
+        const now = Date.now();
+        const frame = this.frameAt(run, now);
+        if (!frame) {
+            // One-shot show ran off the end: land on the final look and stop.
+            this.applyFinal(run);
+            return;
+        }
+        for (const [id, look] of frame.looks) {
+            const fx = this.fixture(run, id);
+            const c = this.controllers.get(fx.controller.id);
+            c?.setFixture(fx, toState(look, fx, true), { quiet: true });
+        }
+        run.lastFrame = frame.looks;
+        // Keyframe: on entering a new step, tell the registry where the lights
+        // are heading — the step's destination, not the in-between value, so
+        // a long fade shows its target for the whole fade. Throttled so fast
+        // chases don't flood HomeKit; on a sub-second chase the tiles lag by
+        // an unbounded amount, which is fine for a chase.
+        if (now - run.lastKeyframeAt >= SHOW_KEYFRAME_MIN_MS) {
+            run.lastKeyframeAt = now;
+            if (frame.step !== run.lastKeyframeStep) {
+                run.lastKeyframeStep = frame.step;
+                const targets = run.show.steps[frame.step].targets;
+                for (const [id, look] of targets) {
+                    this.registry.set(id, toState(look, this.fixture(run, id)), 'show');
+                }
+            }
+        }
+    }
+    applyFinal(run) {
+        clearInterval(run.timer);
+        this.run = null; // before any registry write, same as stop()
+        const last = run.show.steps[run.show.steps.length - 1];
+        for (const [id, look] of last.targets) {
+            const fx = this.fixture(run, id);
+            this.controllers.get(fx.controller.id)?.setFixture(fx, toState(look, fx, true), { quiet: true });
+            this.registry.set(id, toState(look, fx), 'show');
+        }
+        this.log.info(`show "${run.show.id}" finished`);
+        this.emit();
+    }
+    /** Where every fixture is at wall-clock `now`. Null once a one-shot show
+     *  has run past its end. */
+    frameAt(run, now) {
+        const { show, snapshot } = run;
+        let e = now - run.startedAt;
+        let firstCycle = true;
+        if (show.loop) {
+            if (e >= show.cycleMs) {
+                firstCycle = false;
+                e = e % show.cycleMs;
+            }
+        }
+        else if (e >= show.cycleMs) {
+            return null;
+        }
+        // Locate the step and the position within its fade/hold.
+        let i = 0;
+        let t = 1;
+        let acc = 0;
+        for (; i < show.steps.length; i++) {
+            const st = show.steps[i];
+            const len = st.fadeMs + st.holdMs;
+            if (e < acc + len || i === show.steps.length - 1) {
+                const local = e - acc;
+                t = st.fadeMs > 0 ? Math.min(1, local / st.fadeMs) : 1;
+                break;
+            }
+            acc += len;
+        }
+        const st = show.steps[i];
+        const from = i > 0 ? show.steps[i - 1].targets
+            : firstCycle ? null : show.steps[show.steps.length - 1].targets;
+        const eased = st.ease === 'sine' ? (1 - Math.cos(Math.PI * t)) / 2 : t;
+        const looks = new Map();
+        for (const fx of show.fixtures) {
+            const start = snapshot.get(fx.id);
+            const a = from?.get(fx.id) ?? start;
+            const b = st.targets.get(fx.id) ?? start;
+            looks.set(fx.id, mixLook(a, b, eased));
+        }
+        return { step: i, looks };
+    }
+}
+// ── LookColor ↔ HomeKitLightState ──────────────────────────────────────────
+export function fromState(s) {
+    const out = { brightness: s.on ? s.brightness : 0 };
+    if (s.hue != null)
+        out.hue = s.hue;
+    if (s.saturation != null)
+        out.saturation = s.saturation;
+    if (s.colorTemperatureMireds != null)
+        out.mireds = s.colorTemperatureMireds;
+    return out;
+}
+/** Shape a look for a specific fixture: only the characteristics its color
+ *  model exposes, HomeKit-style on/brightness. A dark look parks the
+ *  brightness at 100 so the next HomeKit "on" restores full (mirrors
+ *  hsvcct.parse). `precise` keeps fractional values — the wire path
+ *  renders 16-bit intensity, so fades stay smooth below 1 % steps; the
+ *  registry (HomeKit) gets integers. */
+export function toState(look, fx, precise = false) {
+    const chars = fx.profile.model.characteristics;
+    const r = precise ? (n) => n : Math.round;
+    const on = look.brightness > 0.5;
+    const s = {
+        on,
+        brightness: on ? Math.max(1, r(look.brightness)) : 100,
+    };
+    const colorMode = look.hue != null && (look.saturation ?? 0) > 0;
+    if (chars.includes('Hue') && look.hue != null)
+        s.hue = r(look.hue);
+    if (chars.includes('Saturation'))
+        s.saturation = r(look.saturation ?? 0);
+    if (chars.includes('ColorTemperature') && look.mireds != null && !colorMode) {
+        s.colorTemperatureMireds = r(look.mireds);
+    }
+    return s;
+}
+//# sourceMappingURL=engine.js.map