multiclone 0.0.0-stage → 0.1.0

package/dist/capture/collectors/index.js

@@ -0,0 +1,50 @@
+import { a11yCollector } from './a11y.js';
+import { animationsCollector } from './animations.js';
+import { breakpointsCollector } from './breakpoints.js';
+import { consentCollector } from './consent.js';
+import { coverageCollector } from './coverage.js';
+import { domCollector } from './dom.js';
+import { fontsCollector } from './fonts.js';
+import { interactionsCollector } from './interactions.js';
+import { introCollector } from './intro.js';
+import { listenersCollector } from './listeners.js';
+import { framesCollector } from './frames.js';
+import { motionCollector } from './motion.js';
+import { networkCollector } from './network.js';
+import { probesCollector } from './probes.js';
+import { runtimeCollector } from './runtime.js';
+import { scriptsCollector } from './scripts.js';
+import { sectionsCollector } from './sections.js';
+import { shotsCollector } from './shots.js';
+import { snapshotCollector } from './snapshot.js';
+import { sourcemapsCollector } from './sourcemaps.js';
+import { storageCollector } from './storage.js';
+/** Collectors in run order; within each hook they execute in this order. */
+export function defaultCollectors() {
+    return [
+        // Setup order matters: frames registers child-session handling before anything navigates.
+        framesCollector(),
+        networkCollector(),
+        scriptsCollector(),
+        runtimeCollector(),
+        introCollector(),
+        consentCollector(),
+        animationsCollector(),
+        probesCollector(),
+        domCollector(),
+        snapshotCollector(),
+        fontsCollector(),
+        a11yCollector(),
+        storageCollector(),
+        sectionsCollector(),
+        listenersCollector(),
+        motionCollector(),
+        coverageCollector(),
+        interactionsCollector(),
+        shotsCollector(),
+        // Finish order: network and scripts are flushed above, so maps can read them.
+        sourcemapsCollector(),
+        breakpointsCollector(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/capture/collectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capture/collectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,0FAA0F;QAC1F,eAAe,EAAE;QACjB,gBAAgB,EAAE;QAClB,gBAAgB,EAAE;QAClB,gBAAgB,EAAE;QAClB,cAAc,EAAE;QAChB,gBAAgB,EAAE;QAClB,mBAAmB,EAAE;QACrB,eAAe,EAAE;QACjB,YAAY,EAAE;QACd,iBAAiB,EAAE;QACnB,cAAc,EAAE;QAChB,aAAa,EAAE;QACf,gBAAgB,EAAE;QAClB,iBAAiB,EAAE;QACnB,kBAAkB,EAAE;QACpB,eAAe,EAAE;QACjB,iBAAiB,EAAE;QACnB,qBAAqB,EAAE;QACvB,cAAc,EAAE;QAChB,8EAA8E;QAC9E,mBAAmB,EAAE;QACrB,oBAAoB,EAAE;KACvB,CAAC;AACJ,CAAC"}

package/dist/capture/collectors/interactions.js

@@ -0,0 +1,208 @@
+import { join } from 'node:path';
+import { sleep, writeBytes, writeJson } from '../../core/files.js';
+import { log } from '../../core/log.js';
+import { diffStates, readStates, STATE_PROPS } from '../hooks/styles.js';
+const MAX_FORCED = 60;
+const MAX_HOVERS = 40;
+const MAX_CLICKS = 12;
+const PAD = 24;
+/** Elements that became visible after a click (menus, dialogs, panels). Self-contained. */
+function visibleSet() {
+    const out = [];
+    for (const el of Array.from(document.body.querySelectorAll('*')).slice(0, 8000)) {
+        const rect = el.getBoundingClientRect();
+        if (rect.width < 40 || rect.height < 20)
+            continue;
+        const style = getComputedStyle(el);
+        if (style.visibility === 'hidden' || style.display === 'none' || style.opacity === '0')
+            continue;
+        out.push(`${el.tagName}|${String(Math.round(rect.left))}|${String(Math.round(rect.top))}|${String(Math.round(rect.width))}|${String(Math.round(rect.height))}`);
+    }
+    return out;
+}
+async function nodeIdFor(context, selector) {
+    try {
+        const { root } = await context.cdp.send('DOM.getDocument', {
+            depth: 0,
+        });
+        const { nodeId } = await context.cdp.send('DOM.querySelector', {
+            nodeId: root.nodeId,
+            selector,
+        });
+        return nodeId || null;
+    }
+    catch {
+        return null;
+    }
+}
+async function crop(context, candidate, scrollY, file) {
+    const [x, y, w, h] = candidate.box;
+    const png = await context.page.screenshot({
+        x: x - PAD,
+        y: y - scrollY - PAD,
+        width: Math.min(w + PAD * 2, context.viewport.width),
+        height: Math.min(h + PAD * 2, context.viewport.height),
+    });
+    await writeBytes(join(context.dir, file), png);
+    context.run.output('interactions', file);
+    return file;
+}
+/**
+ * Hover/focus/active states of interactive elements. CSS pseudo-states are forced and diffed,
+ * real pointer hovers catch JS hover effects, and a capped number of in-place toggles are
+ * clicked (never links that leave the page), with a reload to restore state afterwards.
+ * Writes interactions/<viewport>.json plus crops.
+ */
+export function interactionsCollector() {
+    return {
+        id: 'interactions',
+        timeLimitMs: 300_000,
+        async explore(context) {
+            if (!context.deep)
+                return;
+            const { cdp, page, viewport } = context;
+            const candidates = (context.run.candidates.get(viewport.name) ?? []).filter((c) => !c.path.includes('>>>'));
+            if (!candidates.length)
+                return;
+            log(`    interaction states for ${String(Math.min(candidates.length, MAX_FORCED))} elements`);
+            await cdp.send('DOM.enable');
+            await cdp.send('CSS.enable');
+            const records = [];
+            const read = (selector) => page.run(readStates, { selector, props: [...STATE_PROPS], maxDescendants: 30 });
+            for (const [index, candidate] of candidates.slice(0, MAX_FORCED).entries()) {
+                const forced = {};
+                const nodeId = await nodeIdFor(context, candidate.path);
+                const rest = await read(candidate.path);
+                if (nodeId !== null && rest) {
+                    for (const state of ['hover', 'focus-visible', 'active']) {
+                        await cdp
+                            .send('CSS.forcePseudoState', { nodeId, forcedPseudoClasses: [state] })
+                            .catch(() => undefined);
+                        const active = await read(candidate.path);
+                        await cdp
+                            .send('CSS.forcePseudoState', { nodeId, forcedPseudoClasses: [] })
+                            .catch(() => undefined);
+                        if (!active)
+                            continue;
+                        const diff = diffStates(rest, active);
+                        if (Object.keys(diff).length)
+                            forced[state] = diff;
+                    }
+                }
+                let hover;
+                if (index < MAX_HOVERS && rest) {
+                    const [x, y, w, h] = candidate.box;
+                    const scrollY = await page.scrollTo(Math.max(0, y - viewport.height / 3), viewport);
+                    await cdp.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: 1, y: 1 });
+                    await sleep(350);
+                    const before = await read(candidate.path);
+                    const restFile = await crop(context, candidate, scrollY, join('interactions', `${viewport.name}-${String(index + 1)}-rest.png`));
+                    await cdp.send('Input.dispatchMouseEvent', {
+                        type: 'mouseMoved',
+                        x: x + w / 2,
+                        y: y - scrollY + h / 2,
+                    });
+                    await sleep(700);
+                    const after = await read(candidate.path);
+                    const activeFile = await crop(context, candidate, scrollY, join('interactions', `${viewport.name}-${String(index + 1)}-hover.png`));
+                    await cdp.send('Input.dispatchMouseEvent', { type: 'mouseMoved', x: 1, y: 1 });
+                    if (before && after)
+                        hover = { diff: diffStates(before, after), rest: restFile, active: activeFile };
+                }
+                if (Object.keys(forced).length || (hover && Object.keys(hover.diff).length)) {
+                    records.push({
+                        path: candidate.path,
+                        tag: candidate.tag,
+                        text: candidate.text,
+                        role: candidate.role,
+                        forced,
+                        ...(hover ? { hover } : {}),
+                    });
+                }
+            }
+            const toggles = candidates.filter((c) => c.toggles && !c.navigates).slice(0, MAX_CLICKS);
+            for (const [index, candidate] of toggles.entries()) {
+                const [x, y, w, h] = candidate.box;
+                const scrollY = await page.scrollTo(Math.max(0, y - viewport.height / 3), viewport);
+                const beforeUrl = await page.evaluate('location.href');
+                const before = await page.run(visibleSet, undefined);
+                const rest = await read(candidate.path);
+                await cdp.send('Input.dispatchMouseEvent', {
+                    type: 'mousePressed',
+                    x: x + w / 2,
+                    y: y - scrollY + h / 2,
+                    button: 'left',
+                    clickCount: 1,
+                });
+                await cdp.send('Input.dispatchMouseEvent', {
+                    type: 'mouseReleased',
+                    x: x + w / 2,
+                    y: y - scrollY + h / 2,
+                    button: 'left',
+                    clickCount: 1,
+                });
+                await sleep(900);
+                const afterUrl = await page.evaluate('location.href').catch(() => '');
+                if (afterUrl.split('#')[0] !== beforeUrl.split('#')[0]) {
+                    context.run.warn(`interactions: click on ${candidate.path} navigated; restored`);
+                    await page.goto(context.settings.url, 0);
+                    await page.settle(context.settings.settleMs, context.signal);
+                    continue;
+                }
+                const after = await page.run(visibleSet, undefined);
+                const appeared = after.filter((item) => !before.includes(item)).slice(0, 20);
+                const active = await read(candidate.path);
+                const shot = join('interactions', `${viewport.name}-click-${String(index + 1)}.png`);
+                await writeBytes(join(context.dir, shot), await page.screenshot());
+                context.run.output('interactions', shot);
+                const existing = records.find((record) => record.path === candidate.path);
+                const click = {
+                    diff: rest && active ? diffStates(rest, active) : {},
+                    shot,
+                    opened: appeared.map((item) => {
+                        const [tag = '', left = '0', top = '0', width = '0', height = '0'] = item.split('|');
+                        return {
+                            path: tag.toLowerCase(),
+                            box: [Number(left), Number(top) + scrollY, Number(width), Number(height)],
+                        };
+                    }),
+                };
+                if (existing)
+                    records[records.indexOf(existing)] = { ...existing, click };
+                else
+                    records.push({
+                        path: candidate.path,
+                        tag: candidate.tag,
+                        text: candidate.text,
+                        role: candidate.role,
+                        forced: {},
+                        click,
+                    });
+                // Close whatever opened: Escape, then a click on the same control if still open.
+                await cdp.send('Input.dispatchKeyEvent', {
+                    type: 'keyDown',
+                    key: 'Escape',
+                    code: 'Escape',
+                    windowsVirtualKeyCode: 27,
+                });
+                await cdp.send('Input.dispatchKeyEvent', {
+                    type: 'keyUp',
+                    key: 'Escape',
+                    code: 'Escape',
+                    windowsVirtualKeyCode: 27,
+                });
+                await sleep(400);
+            }
+            if (toggles.length) {
+                // Clicks can leave state behind; reload so screenshots see the untouched page.
+                await page.goto(context.settings.url, 0);
+                await page.settle(context.settings.settleMs, context.signal);
+                await page.autoScroll(viewport);
+            }
+            const file = join('interactions', `${viewport.name}.json`);
+            await writeJson(join(context.dir, file), records);
+            context.run.output('interactions', file);
+        },
+    };
+}
+//# sourceMappingURL=interactions.js.map

package/dist/capture/collectors/interactions.js.map

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

package/dist/capture/collectors/intro.js

@@ -0,0 +1,84 @@
+import { join } from 'node:path';
+import { sleep, writeBytes, writeJson } from '../../core/files.js';
+export const INTRO_MS = [0, 150, 300, 600, 1000, 1500, 2500, 4000];
+/** Picks the frame closest to each target time (at or before it, else the first after). */
+export function pickFrames(frames, targets) {
+    const sorted = [...frames].sort((a, b) => a.t - b.t);
+    return targets.map((target) => {
+        let best = null;
+        for (const frame of sorted) {
+            if (frame.t <= target)
+                best = frame;
+            else
+                return best ?? frame;
+        }
+        return best;
+    });
+}
+/**
+ * Intro filmstrip on the primary viewport: screencast frames timestamped from navigation, saved
+ * at INTRO_MS. Falls back to timed screenshots when the screencast yields nothing.
+ * Writes intro/<viewport>-<ms>.png and intro/index.json.
+ */
+export function introCollector() {
+    let frames = [];
+    let started = 0;
+    let off = null;
+    return {
+        id: 'intro',
+        async beforeNavigate(context) {
+            if (!context.primary)
+                return;
+            frames = [];
+            started = Date.now();
+            off = context.cdp.on('Page.screencastFrame', (params) => {
+                const sessionId = params.sessionId;
+                frames.push({ t: Date.now() - started, png: Buffer.from(params.data, 'base64') });
+                void context.cdp.send('Page.screencastFrameAck', { sessionId }).catch(() => undefined);
+            });
+            await context.cdp.send('Page.startScreencast', {
+                format: 'png',
+                everyNthFrame: 1,
+                maxWidth: context.viewport.width,
+                maxHeight: context.viewport.height,
+            });
+            started = Date.now();
+        },
+        async loaded(context) {
+            if (!context.primary)
+                return;
+            const last = INTRO_MS.at(-1) ?? 4000;
+            const elapsed = Date.now() - started;
+            if (elapsed < last)
+                await sleep(last - elapsed + 100);
+            await context.cdp.send('Page.stopScreencast').catch(() => undefined);
+            off?.();
+            off = null;
+            let picked = pickFrames(frames, INTRO_MS);
+            let source = 'screencast';
+            if (picked.every((frame) => frame === null)) {
+                // Screencast unavailable: a later reload would change state, so record what we can now.
+                source = 'timed';
+                picked = [{ t: Date.now() - started, png: await context.page.screenshot() }];
+            }
+            const index = [];
+            for (const [position, frame] of picked.entries()) {
+                if (!frame)
+                    continue;
+                const ms = source === 'timed' ? frame.t : (INTRO_MS[position] ?? frame.t);
+                const file = join('intro', `${context.viewport.name}-${String(ms)}.png`);
+                await writeBytes(join(context.dir, file), frame.png);
+                index.push({ ms, actualMs: frame.t, file });
+                context.run.output('intro', file);
+            }
+            await writeJson(join(context.dir, 'intro', 'index.json'), {
+                viewport: context.viewport.name,
+                source,
+                frames: index,
+            });
+            context.run.output('intro', 'intro/index.json');
+            frames = [];
+        },
+    };
+}
+//# sourceMappingURL=intro.js.map

package/dist/capture/collectors/intro.js.map

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

package/dist/capture/collectors/listeners.js

@@ -0,0 +1,84 @@
+import { join } from 'node:path';
+import { writeJson } from '../../core/files.js';
+import { findCandidates } from '../hooks/candidates.js';
+const MAX_CANDIDATES = 120;
+async function listenersFor(context, expression) {
+    const { result } = await context.cdp.send('Runtime.evaluate', {
+        expression,
+        returnByValue: false,
+    });
+    if (!result.objectId)
+        return [];
+    try {
+        const { listeners } = await context.cdp.send('DOMDebugger.getEventListeners', { objectId: result.objectId, depth: -1, pierce: true });
+        return listeners;
+    }
+    finally {
+        await context.cdp
+            .send('Runtime.releaseObject', { objectId: result.objectId })
+            .catch(() => undefined);
+    }
+}
+/**
+ * Event listeners on window, document, fixed elements and interactive candidates, with the
+ * handler's script location. Also publishes the candidate list for coverage and interactions.
+ * Writes listeners/<viewport>.json.
+ */
+export function listenersCollector() {
+    return {
+        id: 'listeners',
+        async top(context) {
+            const candidates = await context.page.runWith(findCandidates, { max: 400 });
+            context.run.candidates.set(context.viewport.name, candidates);
+            if (!context.deep)
+                return;
+            await context.cdp.send('DOM.enable').catch(() => undefined);
+            const scriptFor = new Map(context.run.scripts.map((script) => [script.scriptId, script]));
+            const records = [];
+            const targets = [
+                { label: 'window', expression: 'window' },
+                { label: 'document', expression: 'document' },
+                ...candidates.slice(0, MAX_CANDIDATES).map((candidate) => ({
+                    label: candidate.path,
+                    expression: `(() => { try { return document.querySelector(${JSON.stringify(candidate.path.split(' >>> ')[0] ?? '')}); } catch { return null; } })()`,
+                })),
+            ];
+            const seen = new Set();
+            for (const target of targets) {
+                let listeners;
+                try {
+                    listeners = await listenersFor(context, target.expression);
+                }
+                catch {
+                    continue;
+                }
+                for (const listener of listeners) {
+                    // depth:-1 repeats descendants' listeners under each ancestor; keep the first owner.
+                    const id = `${listener.scriptId}:${String(listener.lineNumber)}:${String(listener.columnNumber)}:${listener.type}:${String(listener.backendNodeId ?? target.label)}`;
+                    if (seen.has(id))
+                        continue;
+                    seen.add(id);
+                    const script = scriptFor.get(listener.scriptId);
+                    records.push({
+                        target: target.label,
+                        type: listener.type,
+                        capture: listener.useCapture,
+                        passive: listener.passive,
+                        once: listener.once,
+                        script: script?.file ?? script?.url ?? `script:${listener.scriptId}`,
+                        line: listener.lineNumber,
+                        column: listener.columnNumber,
+                    });
+                }
+            }
+            records.sort((a, b) => a.target.localeCompare(b.target) ||
+                a.type.localeCompare(b.type) ||
+                a.script.localeCompare(b.script) ||
+                a.line - b.line);
+            const file = join('listeners', `${context.viewport.name}.json`);
+            await writeJson(join(context.dir, file), { candidates, listeners: records });
+            context.run.output('listeners', file);
+        },
+    };
+}
+//# sourceMappingURL=listeners.js.map

package/dist/capture/collectors/listeners.js.map

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

package/dist/capture/collectors/motion.js

@@ -0,0 +1,86 @@
+import { join } from 'node:path';
+import { sleep, writeJson } from '../../core/files.js';
+import { log } from '../../core/log.js';
+import { buildMotionTracks, buildVariableTracks, MOTION_PROPS, refinementTargets, } from '../../domain/motion.js';
+import { motionProbe } from '../probes.js';
+const IDLE_SAMPLES = 4;
+const IDLE_GAP_MS = 700;
+/**
+ * Motion map v2 on the primary viewport: a coarse pass across the page, refinement between
+ * offsets that differ, and an idle pass (no scrolling) that separates time-based loops from
+ * scroll-linked motion. Writes motion.json and motion-vars.json.
+ */
+export function motionCollector() {
+    let variables = {};
+    return {
+        id: 'motion',
+        timeLimitMs: 360_000,
+        async explore(context) {
+            if (!context.primary || !context.settings.motion)
+                return;
+            log('    sampling scroll-linked motion');
+            const result = await sampleMotion(context);
+            context.run.motion = result.tracks;
+            variables = result.variables;
+            await context.page.scrollTo(0, context.viewport);
+            await sleep(1000);
+        },
+        async finish(context) {
+            await writeJson(join(context.dir, 'motion.json'), context.run.motion);
+            await writeJson(join(context.dir, 'motion-vars.json'), variables);
+            context.run.output('motion', 'motion.json');
+            context.run.output('motion', 'motion-vars.json');
+        },
+    };
+}
+async function sampleMotion(context) {
+    const { page, viewport } = context;
+    await page.evaluate('delete window.__mcMotion; delete window.__mcVars; true');
+    await page.scrollTo(0, viewport);
+    await sleep(600);
+    let meta = [];
+    const sample = async (target) => {
+        const y = await page.scrollTo(target, viewport);
+        await sleep(300);
+        const result = await page.runWith(motionProbe, [...MOTION_PROPS]);
+        if (result.meta)
+            meta = result.meta;
+        return { y, samples: result.samples, vars: result.vars };
+    };
+    // Idle pass at the top: anything that changes here moves on its own clock.
+    const idle = [];
+    for (let index = 0; index < IDLE_SAMPLES; index++) {
+        idle.push(await sample(0));
+        await sleep(IDLE_GAP_MS);
+    }
+    const idleChanging = new Set();
+    for (const round of idle.slice(1)) {
+        for (const s of round.samples) {
+            const first = idle[0]?.samples.find((other) => other.index === s.index);
+            if (first?.values.some((value, k) => value !== s.values[k]))
+                idleChanging.add(s.index);
+        }
+    }
+    const max = await page.maxScroll();
+    const coarse = Math.max(Math.round(viewport.height * 0.5), Math.ceil(max / 60));
+    const rounds = [idle[0] ?? (await sample(0))];
+    for (let target = coarse; target <= max; target += coarse)
+        rounds.push(await sample(target));
+    if (max % coarse)
+        rounds.push(await sample(max));
+    // Adaptive refinement: halve the gaps where something changed, down to ~1/8 viewport.
+    const minGap = Math.max(40, Math.round(viewport.height / 8));
+    for (let pass = 0; pass < 3; pass++) {
+        const targets = refinementTargets(rounds, minGap, 40);
+        if (!targets.length)
+            break;
+        for (const target of targets)
+            rounds.push(await sample(target));
+    }
+    log(`    ${String(rounds.length)} motion samples`);
+    return {
+        tracks: buildMotionTracks(meta, rounds, { idleChanging }),
+        variables: buildVariableTracks(rounds),
+    };
+}
+//# sourceMappingURL=motion.js.map

package/dist/capture/collectors/motion.js.map

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