@vibesdotdev/media 0.0.0-stage → 1.0.0-rc.3

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @vibesdotdev/media
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Universal media contracts for the vibes platform: stable artifact-revision identity plus three runtime kinds — `media/capture` (pixels in), `media/image-transform` (bytes in, bytes out), and `media/motion` (what the pixels are doing across time) — with runtime-resolved uploads and Svelte adapters on top.
+
+## Install
+
+The package is workspace-only:
+
+```jsonc
+// package.json
+"dependencies": {
+  "@vibesdotdev/media": "workspace:*"
+}
+```
+
+## Use
+
+Capture a screenshot through a provider, transform image bytes, or upload a file — always through the runtime, never through direct imports of a provider:
+
+```ts
+import type { CaptureProvider } from '@vibesdotdev/media';
+
+const provider = (await runtime
+  .query('media/capture')
+  .withId('bridge.screen')
+  .resolve()) as CaptureProvider;
+
+const shot = await provider.capture({ format: 'png' });
+// shot.data is Uint8Array
+```
+
+```ts
+import { getVibesUploadsClient } from '@vibesdotdev/media/uploads/client';
+
+const uploads = await getVibesUploadsClient(runtime);
+const file = await uploads.upload({
+  file: buffer,
+  kind: 'chat',
+  sourceApp: 'chat',
+  sourceId: roomId
+});
+```
+
+## Contracts
+
+- [SPEC.md](./SPEC.md) — package contract: artifact references, the three runtime kinds, hard rules, full entrypoint list.
+- [src/svelte/SPEC.md](./src/svelte/SPEC.md) — tree-bound capture composition and compatibility handoff.
+- [src/uploads/SPEC.md](./src/uploads/SPEC.md) — uploads surface: `uploads/store` kind, client, schemas, local adapter.
+- [src/svelte/sharing/SPEC.md](./src/svelte/sharing/SPEC.md) — revocable share-link Svelte surface.
+- [src/uploads/README.md](./src/uploads/README.md) — uploads quick tour.
+
+## Upload storage and validation
+
+Hosts set `config['media.uploads'].localPath` and compose
+`@vibesdotdev/media/uploads/adapters/local/node`. The runtime-resolved local
+adapter uses that root for save, read, and delete. Relative roots resolve
+against the bound workspace; an omitted root uses `uploads`. Absolute roots
+are supported, and paths cannot escape the selected root.
+
+`validateUpload` and `uploadLimitsSchema` are exported from `./uploads/schemas`.
+The default cap is 50 MiB with the exported MIME allowlist. A caller may replace
+either limit. Caps must be positive safe integers; a malformed cap or allowlist
+is refused instead of compared against. `validateUpload` returns
+`INVALID_INPUT/upload-limits-invalid` with legacy code `INVALID_LIMITS` and
+consumes the parsed snapshot; the HTTP client reports the same schema's
+malformed caps as `upload-limits-invalid`, while an unreadable or throwing
+request is `upload-options-invalid`. Valid caps still reject oversized files
+as `upload-file-too-large`.
+
+The root entrypoint contains the universal media contract and semantic capture
+client. Implementations resolve through runtime kinds; Svelte components and
+state are available only through explicit `./svelte` subpaths. Universal plugins
+contain no consumer, CLI, or process implementation loaders.
+
+## Verification
+
+```bash
+bun run lint
+bun run rules
+bun run check
+bun run test
+bun run build
+```
+
+Capture UI hosts compose mediaPlugin and runtimeClientPlugin. Retain one
+createMediaCaptureState() result for a sibling loader/panel, or wrap the panel
+in CaptureLoader for context. mediaCaptureState is a factory alias, so former
+singleton callers must migrate. The runtime owns byte sessions; each tree owns
+its browser URLs. The uploads plugin separately registers uploads and
+uploads-storage clients.
+
+Check includes source, tests, fixtures and Svelte TypeScript. Tests combine
+Bun contracts with real in-process Svelte mounting under Vitest/Happy DOM.
+Sharing and uploader helpers have helper proof; they are not component proof.
+Build emits core declarations/JavaScript and separately packages Svelte
+components/styles, excluding tests and fixtures.

package/dist/analyzers/frame-guard.d.ts

@@ -0,0 +1,6 @@
+import { type Frame } from '../schemas/motion-frame.ts';
+export { MAX_FRAME_PIXELS } from '../schemas/motion-frame.ts';
+/** Compatibility guards delegate geometry and buffer validation to the schema owner. */
+export declare function assertFrame(frame: Frame): void;
+export declare function assertFrameSequence(frames: readonly Frame[]): void;
+//# sourceMappingURL=frame-guard.d.ts.map

package/dist/analyzers/frame-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-guard.d.ts","sourceRoot":"","sources":["../../src/analyzers/frame-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE9C;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,CAElE"}

package/dist/analyzers/frame-guard.js

@@ -0,0 +1,10 @@
+import { FrameSchema, FrameSequenceSchema, parseMotionInput } from "../schemas/motion-frame.js";
+export { MAX_FRAME_PIXELS } from "../schemas/motion-frame.js";
+/** Compatibility guards delegate geometry and buffer validation to the schema owner. */
+export function assertFrame(frame) {
+    parseMotionInput(FrameSchema, frame);
+}
+export function assertFrameSequence(frames) {
+    parseMotionInput(FrameSequenceSchema, [...frames]);
+}
+//# sourceMappingURL=frame-guard.js.map

package/dist/analyzers/frame-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-guard.js","sourceRoot":"","sources":["../../src/analyzers/frame-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAc,MAAM,4BAA4B,CAAC;AAE5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,KAAY;IACvC,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAwB;IAC3D,gBAAgB,CAAC,mBAAmB,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/analyzers/motion-math.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Motion Math — pure kernels
+ *
+ * The numeric core of the `media/motion` reference analyzer, kept free of any
+ * runtime/schema wiring so it can be unit-tested directly and reused by other
+ * providers. Everything here operates on `Frame` structs and typed arrays; no
+ * FS, no native, no async.
+ *
+ * Luma convention: values are kept in 0..255 float space through reduction,
+ * then scalar summaries are normalized to 0..1 at the boundary. Motion energy
+ * works on per-frame zero-mean, unit-variance luma so cross-correlation lands
+ * in ~[-1, 1] and the opponent subtraction cleanly cancels non-directional
+ * structure.
+ */
+import type { Frame } from '../schemas/motion-frame.ts';
+import type { FrameDiffResult, TemporalStatsResult, OpticalFlowResult, MotionEnergyResult, MotionDirection } from '../schemas/motion-analysis.ts';
+/** A luma plane reduced from a frame. */
+export interface LumaPlane {
+    data: Float32Array;
+    width: number;
+    height: number;
+}
+/**
+ * Reduce a frame to a single-channel luma plane, optionally box-downsampled by
+ * an integer factor. Multi-channel frames are collapsed via Rec.601 luma.
+ */
+export declare function toLuma(frame: Frame, downscale?: number): LumaPlane;
+/** Absolute luma difference between two frames. */
+export declare function frameDiff(a: Frame, b: Frame, opts?: {
+    downscale?: number;
+    threshold?: number;
+    includeMap?: boolean;
+}): FrameDiffResult;
+/** Per-pixel temporal mean + std (Welford) over a sequence. */
+export declare function temporalStats(frames: Frame[], opts?: {
+    downscale?: number;
+    includeMaps?: boolean;
+}): TemporalStatsResult;
+/** Block-matching optical flow between two frames. */
+export declare function opticalFlow(a: Frame, b: Frame, opts?: {
+    downscale?: number;
+    blockSize?: number;
+    searchRadius?: number;
+    step?: number;
+    minConfidence?: number;
+}): OpticalFlowResult;
+/** Pick an integer downscale so the longer edge is ≤ maxDim. */
+export declare function autoDownscale(frame: Frame, maxDim: number): number;
+/**
+ * Reichardt / lag-1 opponent motion energy over a sequence.
+ *
+ * For every consecutive pair (t, t+1) and every candidate shift s, accumulate
+ * the normalized cross-correlation corr(s). The opponent response for a
+ * direction is R(s) = mean_t[corr(s)] − mean_t[corr(−s)]: coherent drift by
+ * velocity v drives corr(v)→high, corr(−v)→low, so R(v) is large; temporally
+ * independent twinkle gives corr(any)≈0 so R≈0. That subtraction is what
+ * separates a motion carrier from a static or twinkling background.
+ */
+export declare function motionEnergy(frames: Frame[], opts?: {
+    downscale?: number;
+    maxDim?: number;
+    directions?: MotionDirection[];
+    shiftRadius?: number;
+    includeMap?: boolean;
+}): MotionEnergyResult;
+//# sourceMappingURL=motion-math.d.ts.map

package/dist/analyzers/motion-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-math.d.ts","sourceRoot":"","sources":["../../src/analyzers/motion-math.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EACX,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAEjB,kBAAkB,EAClB,eAAe,EAGf,MAAM,+BAA+B,CAAC;AAEvC,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,SAAI,GAAG,SAAS,CAgC7D;AAGD,mDAAmD;AACnD,wBAAgB,SAAS,CACxB,CAAC,EAAE,KAAK,EACR,CAAC,EAAE,KAAK,EACR,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACzE,eAAe,CA2CjB;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC5B,MAAM,EAAE,KAAK,EAAE,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtD,mBAAmB,CAgDrB;AAwBD,sDAAsD;AACtD,wBAAgB,WAAW,CAC1B,CAAC,EAAE,KAAK,EACR,CAAC,EAAE,KAAK,EACR,IAAI,GAAE;IACL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CAClB,GACJ,iBAAiB,CA6DnB;AAmDD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlE;AAeD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,MAAM,EAAE,KAAK,EAAE,EACf,IAAI,GAAE;IACL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CAChB,GACJ,kBAAkB,CAwEpB"}

package/dist/analyzers/motion-math.js

@@ -0,0 +1,356 @@
+/**
+ * Motion Math — pure kernels
+ *
+ * The numeric core of the `media/motion` reference analyzer, kept free of any
+ * runtime/schema wiring so it can be unit-tested directly and reused by other
+ * providers. Everything here operates on `Frame` structs and typed arrays; no
+ * FS, no native, no async.
+ *
+ * Luma convention: values are kept in 0..255 float space through reduction,
+ * then scalar summaries are normalized to 0..1 at the boundary. Motion energy
+ * works on per-frame zero-mean, unit-variance luma so cross-correlation lands
+ * in ~[-1, 1] and the opponent subtraction cleanly cancels non-directional
+ * structure.
+ */
+const REC_601 = { r: 0.299, g: 0.587, b: 0.114 };
+/**
+ * Reduce a frame to a single-channel luma plane, optionally box-downsampled by
+ * an integer factor. Multi-channel frames are collapsed via Rec.601 luma.
+ */
+export function toLuma(frame, downscale = 1) {
+    const { data, width, height } = frame;
+    const channels = frame.channels ?? 1;
+    const ds = Math.max(1, Math.floor(downscale));
+    const outW = Math.max(1, Math.floor(width / ds));
+    const outH = Math.max(1, Math.floor(height / ds));
+    const out = new Float32Array(outW * outH);
+    for (let oy = 0; oy < outH; oy++) {
+        for (let ox = 0; ox < outW; ox++) {
+            let sum = 0;
+            let count = 0;
+            for (let by = 0; by < ds; by++) {
+                const y = oy * ds + by;
+                if (y >= height)
+                    break;
+                const row = y * width;
+                for (let bx = 0; bx < ds; bx++) {
+                    const x = ox * ds + bx;
+                    if (x >= width)
+                        break;
+                    const idx = (row + x) * channels;
+                    const luma = channels === 1
+                        ? data[idx]
+                        : REC_601.r * data[idx] + REC_601.g * data[idx + 1] + REC_601.b * data[idx + 2];
+                    sum += luma;
+                    count++;
+                }
+            }
+            out[oy * outW + ox] = count > 0 ? sum / count : 0;
+        }
+    }
+    return { data: out, width: outW, height: outH };
+}
+/** Absolute luma difference between two frames. */
+export function frameDiff(a, b, opts = {}) {
+    const ds = opts.downscale ?? 1;
+    const la = toLuma(a, ds);
+    const lb = toLuma(b, ds);
+    const n = la.data.length;
+    const thr = (opts.threshold ?? 0.08) * 255;
+    const map = opts.includeMap ? new Float32Array(n) : undefined;
+    let sumDiff = 0;
+    let changed = 0;
+    let minX = la.width;
+    let minY = la.height;
+    let maxX = -1;
+    let maxY = -1;
+    for (let i = 0; i < n; i++) {
+        const d = Math.abs(la.data[i] - lb.data[i]);
+        sumDiff += d;
+        if (map)
+            map[i] = d / 255;
+        if (d > thr) {
+            changed++;
+            const x = i % la.width;
+            const y = (i / la.width) | 0;
+            if (x < minX)
+                minX = x;
+            if (y < minY)
+                minY = y;
+            if (x > maxX)
+                maxX = x;
+            if (y > maxY)
+                maxY = y;
+        }
+    }
+    const bbox = maxX >= 0 ? { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 } : null;
+    const result = {
+        magnitude: sumDiff / n / 255,
+        changedFraction: changed / n,
+        width: la.width,
+        height: la.height,
+        bbox
+    };
+    if (map)
+        result.map = map;
+    return result;
+}
+/** Per-pixel temporal mean + std (Welford) over a sequence. */
+export function temporalStats(frames, opts = {}) {
+    const ds = opts.downscale ?? 1;
+    const planes = frames.map((f) => toLuma(f, ds));
+    const { width, height } = planes[0];
+    const n = width * height;
+    const mean = new Float32Array(n);
+    const m2 = new Float32Array(n);
+    for (let t = 0; t < planes.length; t++) {
+        const plane = planes[t].data;
+        const count = t + 1;
+        for (let i = 0; i < n; i++) {
+            const x = plane[i];
+            const delta = x - mean[i];
+            mean[i] += delta / count;
+            m2[i] += delta * (x - mean[i]);
+        }
+    }
+    const std = new Float32Array(n);
+    let sumStd = 0;
+    let peak = 0;
+    const t = planes.length;
+    for (let i = 0; i < n; i++) {
+        const s = Math.sqrt(m2[i] / t);
+        std[i] = s;
+        sumStd += s;
+        if (s > peak)
+            peak = s;
+    }
+    const result = {
+        meanStd: sumStd / n / 255,
+        peakStd: peak / 255,
+        width,
+        height
+    };
+    if (opts.includeMaps) {
+        const stdNorm = new Float32Array(n);
+        const meanNorm = new Float32Array(n);
+        for (let i = 0; i < n; i++) {
+            stdNorm[i] = std[i] / 255;
+            meanNorm[i] = mean[i] / 255;
+        }
+        result.std = stdNorm;
+        result.mean = meanNorm;
+    }
+    return result;
+}
+/** Sum of absolute differences for a block of `a` against `b` shifted by (dx,dy). */
+function blockSad(a, b, width, bx, by, block, dx, dy) {
+    let sad = 0;
+    for (let yy = 0; yy < block; yy++) {
+        const ay = (by + yy) * width;
+        const bBy = (by + dy + yy) * width;
+        for (let xx = 0; xx < block; xx++) {
+            sad += Math.abs(a[ay + bx + xx] - b[bBy + bx + dx + xx]);
+        }
+    }
+    return sad;
+}
+/** Block-matching optical flow between two frames. */
+export function opticalFlow(a, b, opts = {}) {
+    const ds = opts.downscale ?? 1;
+    const la = toLuma(a, ds);
+    const lb = toLuma(b, ds);
+    const { width, height } = la;
+    const block = Math.max(2, opts.blockSize ?? 16);
+    const search = Math.max(1, opts.searchRadius ?? 8);
+    const step = Math.max(1, opts.step ?? block);
+    const minConf = opts.minConfidence ?? 0.05;
+    const vectors = [];
+    let sumDx = 0;
+    let sumDy = 0;
+    let sumConf = 0;
+    let used = 0;
+    for (let by = 0; by + block <= height; by += step) {
+        for (let bx = 0; bx + block <= width; bx += step) {
+            let best = Infinity;
+            let second = Infinity;
+            let bestDx = 0;
+            let bestDy = 0;
+            for (let dy = -search; dy <= search; dy++) {
+                if (by + dy < 0 || by + dy + block > height)
+                    continue;
+                for (let dx = -search; dx <= search; dx++) {
+                    if (bx + dx < 0 || bx + dx + block > width)
+                        continue;
+                    const sad = blockSad(la.data, lb.data, width, bx, by, block, dx, dy);
+                    if (sad < best) {
+                        second = best;
+                        best = sad;
+                        bestDx = dx;
+                        bestDy = dy;
+                    }
+                    else if (sad < second) {
+                        second = sad;
+                    }
+                }
+            }
+            const confidence = Number.isFinite(second) && second > 0 ? Math.min(1, (second - best) / second) : 0;
+            vectors.push({ x: bx, y: by, dx: bestDx, dy: bestDy, confidence });
+            if (confidence >= minConf) {
+                sumDx += bestDx * confidence;
+                sumDy += bestDy * confidence;
+                sumConf += confidence;
+                used++;
+            }
+        }
+    }
+    return {
+        vectors,
+        meanDx: sumConf > 0 ? sumDx / sumConf : 0,
+        meanDy: sumConf > 0 ? sumDy / sumConf : 0,
+        meanConfidence: used > 0 ? sumConf / used : 0,
+        width,
+        height,
+        blockSize: block
+    };
+}
+/** Reduce a frame to a zero-mean, unit-variance luma plane. */
+function normalizedPlane(frame, downscale) {
+    const plane = toLuma(frame, downscale);
+    const n = plane.data.length;
+    let sum = 0;
+    for (let i = 0; i < n; i++)
+        sum += plane.data[i];
+    const mean = sum / n;
+    let varSum = 0;
+    for (let i = 0; i < n; i++) {
+        const d = plane.data[i] - mean;
+        varSum += d * d;
+    }
+    const std = Math.sqrt(varSum / n) || 1;
+    const out = new Float32Array(n);
+    for (let i = 0; i < n; i++)
+        out[i] = (plane.data[i] - mean) / std;
+    return { data: out, width: plane.width, height: plane.height };
+}
+/**
+ * Normalized cross-correlation between planes `a` and `b` where `b` is sampled
+ * at a spatial shift (dx,dy). Averaged over the in-bounds overlap only, so the
+ * normalization stays fair near the borders. Inputs are unit-variance, so the
+ * result is ~[-1, 1].
+ */
+function shiftedCorrelation(a, b, width, height, dx, dy) {
+    let sum = 0;
+    let count = 0;
+    for (let y = 0; y < height; y++) {
+        const yb = y + dy;
+        if (yb < 0 || yb >= height)
+            continue;
+        const rowA = y * width;
+        const rowB = yb * width;
+        for (let x = 0; x < width; x++) {
+            const xb = x + dx;
+            if (xb < 0 || xb >= width)
+                continue;
+            sum += a[rowA + x] * b[rowB + xb];
+            count++;
+        }
+    }
+    return count > 0 ? sum / count : 0;
+}
+/** Pick an integer downscale so the longer edge is ≤ maxDim. */
+export function autoDownscale(frame, maxDim) {
+    const longer = Math.max(frame.width, frame.height);
+    if (longer <= maxDim)
+        return 1;
+    return Math.max(1, Math.ceil(longer / maxDim));
+}
+function generateDirections(radius) {
+    const dirs = [];
+    const r2 = radius * radius;
+    for (let dy = -radius; dy <= radius; dy++) {
+        for (let dx = -radius; dx <= radius; dx++) {
+            if (dx === 0 && dy === 0)
+                continue;
+            if (dx * dx + dy * dy > r2)
+                continue;
+            dirs.push({ dx, dy });
+        }
+    }
+    return dirs;
+}
+/**
+ * Reichardt / lag-1 opponent motion energy over a sequence.
+ *
+ * For every consecutive pair (t, t+1) and every candidate shift s, accumulate
+ * the normalized cross-correlation corr(s). The opponent response for a
+ * direction is R(s) = mean_t[corr(s)] − mean_t[corr(−s)]: coherent drift by
+ * velocity v drives corr(v)→high, corr(−v)→low, so R(v) is large; temporally
+ * independent twinkle gives corr(any)≈0 so R≈0. That subtraction is what
+ * separates a motion carrier from a static or twinkling background.
+ */
+export function motionEnergy(frames, opts = {}) {
+    const ds = opts.downscale ?? autoDownscale(frames[0], opts.maxDim ?? 96);
+    const planes = frames.map((f) => normalizedPlane(f, ds));
+    const { width, height } = planes[0];
+    const directions = opts.directions ?? generateDirections(opts.shiftRadius ?? 4);
+    // Correlation is symmetric under (frame-swap + shift-negate), so a single
+    // key per axis-signed shift lets us look up corr(−s) for the opponent term.
+    const key = (dx, dy) => `${dx},${dy}`;
+    const corrAccum = new Map();
+    // Every shift we will need a correlation for: the candidates and their
+    // negations.
+    const needed = new Map();
+    for (const d of directions) {
+        needed.set(key(d.dx, d.dy), d);
+        needed.set(key(-d.dx, -d.dy), { dx: -d.dx, dy: -d.dy });
+    }
+    const pairs = planes.length - 1;
+    for (let t = 0; t < pairs; t++) {
+        const a = planes[t].data;
+        const b = planes[t + 1].data;
+        for (const [k, d] of needed) {
+            const c = shiftedCorrelation(a, b, width, height, d.dx, d.dy);
+            corrAccum.set(k, (corrAccum.get(k) ?? 0) + c);
+        }
+    }
+    const meanCorr = (dx, dy) => (corrAccum.get(key(dx, dy)) ?? 0) / pairs;
+    const perDirection = directions.map((d) => ({
+        dx: d.dx,
+        dy: d.dy,
+        strength: meanCorr(d.dx, d.dy) - meanCorr(-d.dx, -d.dy)
+    }));
+    perDirection.sort((p, q) => q.strength - p.strength);
+    const dominant = perDirection[0] ?? { dx: 0, dy: 0, strength: 0 };
+    const coherence = Math.max(0, Math.min(1, dominant.strength));
+    const result = {
+        coherence,
+        dominant,
+        perDirection: perDirection.slice(0, 8),
+        width,
+        height
+    };
+    if (opts.includeMap) {
+        // Per-pixel motion energy for the dominant direction, averaged over pairs.
+        const map = new Float32Array(width * height);
+        for (let t = 0; t < pairs; t++) {
+            const a = planes[t].data;
+            const b = planes[t + 1].data;
+            for (let y = 0; y < height; y++) {
+                const yb = y + dominant.dy;
+                if (yb < 0 || yb >= height)
+                    continue;
+                const rowA = y * width;
+                const rowB = yb * width;
+                for (let x = 0; x < width; x++) {
+                    const xb = x + dominant.dx;
+                    if (xb < 0 || xb >= width)
+                        continue;
+                    map[rowA + x] += (a[rowA + x] * b[rowB + xb]) / pairs;
+                }
+            }
+        }
+        result.map = map;
+    }
+    return result;
+}
+//# sourceMappingURL=motion-math.js.map

package/dist/analyzers/motion-math.js.map

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

package/dist/analyzers/reference-motion-analyzer.impl.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Reference Motion Analyzer — `media/motion` implementation
+ *
+ * Pure-TS `MotionAnalyzer` built on the `motion-math` kernels. Universal: no
+ * FS, no native, no async I/O — runs identically on consumer machines and in
+ * Cloudflare workers, which is why it ships inside `@vibesdotdev/media` rather
+ * than a provider package. A heavier provider (WASM SIMD, native, GPU) can
+ * register its own `media/motion` descriptor and win resolution in its scope.
+ *
+ * The runtime instantiates the default-exported class for each resolving runtime.
+ */
+import type { Frame } from '../schemas/motion-frame.ts';
+import type { MotionAnalyzer } from '../interfaces/motion-analyzer.ts';
+import type { FrameDiffOptions, FrameDiffResult, TemporalStatsOptions, TemporalStatsResult, OpticalFlowOptions, OpticalFlowResult, MotionEnergyOptions, MotionEnergyResult, MotionSummaryOptions, MotionSummary } from '../schemas/motion-analysis.ts';
+export declare class ReferenceMotionAnalyzer implements MotionAnalyzer {
+    frameDiff(a: Frame, b: Frame, options?: FrameDiffOptions): Promise<FrameDiffResult>;
+    temporalStats(frames: Frame[], options?: TemporalStatsOptions): Promise<TemporalStatsResult>;
+    opticalFlow(a: Frame, b: Frame, options?: OpticalFlowOptions): Promise<OpticalFlowResult>;
+    motionEnergy(frames: Frame[], options?: MotionEnergyOptions): Promise<MotionEnergyResult>;
+    summarize(frames: Frame[], options?: MotionSummaryOptions): Promise<MotionSummary>;
+}
+export default ReferenceMotionAnalyzer;
+//# sourceMappingURL=reference-motion-analyzer.impl.d.ts.map

package/dist/analyzers/reference-motion-analyzer.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-motion-analyzer.impl.d.ts","sourceRoot":"","sources":["../../src/analyzers/reference-motion-analyzer.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACX,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,MAAM,+BAA+B,CAAC;AAQvC,qBAAa,uBAAwB,YAAW,cAAc;IACvD,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF,aAAa,CAClB,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAIzB,WAAW,CAChB,CAAC,EAAE,KAAK,EACR,CAAC,EAAE,KAAK,EACR,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,iBAAiB,CAAC;IAKvB,YAAY,CACjB,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAIxB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;CAsC5F;AAED,eAAe,uBAAuB,CAAC"}