@uptimizr/sdk-core 0.1.1 → 0.2.0

package/dist/aggregation/aggregator.d.ts

@@ -0,0 +1,62 @@
+import type { EventInput } from "../types.js";
+import type { Snapshot } from "./snapshot.js";
+/**
+ * Serializable per-channel configuration for the {@link Aggregator}, mirroring the
+ * connector's resolved capture config. It holds only plain data (no callbacks or
+ * handles) so it can be `postMessage`d to the offload worker unchanged. Passed
+ * once at construction so per-frame snapshots stay lean.
+ */
+export interface AggregatorConfig {
+    /** Frame-perf channel knobs (#41). */
+    perf?: {
+        /** Suppress a perf sample whose FPS is within `fpsThreshold` of the last. */
+        suppressIdle: boolean;
+        /** FPS dead-zone for idle suppression. */
+        fpsThreshold: number;
+    };
+    /** Node/bone transform channel knobs (ADR 0027). */
+    node?: {
+        /** Suppress a transform sample unchanged from the last within its epsilon. */
+        suppressIdle: boolean;
+    };
+    /** Mesh-visibility channel knobs (#37, ADR 0012). */
+    visibility?: {
+        /** Cosine of the centred half-angle (`centeredMs` gate). */
+        centeredCos: number;
+        /** Whether to ride along world AABBs (#53). */
+        boundingBox: boolean;
+        /** AABB change dead-zone before a bounds re-send. */
+        boundsEps: number;
+    };
+}
+/**
+ * {@link Aggregator} construction options: the serializable {@link AggregatorConfig}
+ * plus the (non-serializable) sink for finalized events. In main mode the sink is
+ * the client `emit`; in the worker it buffers events to post back to the page.
+ */
+export interface AggregatorOptions extends AggregatorConfig {
+    /** Sink for finalized events. In main mode this is the client `emit`. */
+    emit: (event: EventInput) => void;
+}
+/**
+ * The engine-agnostic **Aggregator** (ADR 0031 follow-up, #10): the single home
+ * for the offload-eligible *processing* phase of per-frame capture. It consumes
+ * the connectors' plain-number {@link Snapshot} DTOs and produces finalized
+ * `@uptimizr/schema` events — running the frame-time percentiles, matrix
+ * decomposition, mesh-visibility bucketing, idle-diffing and gesture
+ * classification that used to live, duplicated, inside each connector.
+ *
+ * It holds no engine or DOM handle, so the *same instance logic* runs unchanged
+ * on the main thread (default) or inside the offload worker (opt-in). All math is
+ * the shared, isomorphic functions from {@link ./math.js}, {@link ../matrix.js}
+ * and {@link ../gesture.js} — there is no worker-only fork (ADR 0031 §2).
+ */
+export interface Aggregator {
+    /** Ingest one snapshot, emitting any resulting finalized events synchronously. */
+    ingest(snapshot: Snapshot): void;
+    /** Reset all per-channel windowed state (e.g. between sessions). Idempotent. */
+    reset(): void;
+}
+/** Create an {@link Aggregator}. */
+export declare function createAggregator(options: AggregatorOptions): Aggregator;
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/aggregation/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../src/aggregation/aggregator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAU9C,OAAO,KAAK,EAA8B,QAAQ,EAA0B,MAAM,eAAe,CAAC;AAElG;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,CAAC,EAAE;QACL,6EAA6E;QAC7E,YAAY,EAAE,OAAO,CAAC;QACtB,0CAA0C;QAC1C,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,oDAAoD;IACpD,IAAI,CAAC,EAAE;QACL,8EAA8E;QAC9E,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,qDAAqD;IACrD,UAAU,CAAC,EAAE;QACX,4DAA4D;QAC5D,WAAW,EAAE,MAAM,CAAC;QACpB,+CAA+C;QAC/C,WAAW,EAAE,OAAO,CAAC;QACrB,qDAAqD;QACrD,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,yEAAyE;IACzE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,gFAAgF;IAChF,KAAK,IAAI,IAAI,CAAC;CACf;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA6LvE"}

package/dist/aggregation/aggregator.js

@@ -0,0 +1,194 @@
+import { classifyCameraGesture } from "../gesture.js";
+import { decomposeWorldMatrix } from "../matrix.js";
+import { aabbClose, nodeSampleUnchanged, percentileAsc, roundAabb, visibilityContribution, length3, } from "./math.js";
+/** Create an {@link Aggregator}. */
+export function createAggregator(options) {
+    const emit = options.emit;
+    // --- frame_perf state ---
+    let lastFps;
+    // --- node_transform state (keyed by nodeId\0(childPath|boneId)) ---
+    const lastNodeSample = new Map();
+    // --- mesh_visibility window state ---
+    let accums = new Map();
+    const sentBounds = new Map();
+    function handlePerf(s) {
+        const window = s.frameTimes;
+        let percentiles;
+        if (window.length > 0) {
+            let longFrames = 0;
+            for (let i = 0; i < window.length; i++) {
+                if (window[i] > s.jankFrameMs)
+                    longFrames++;
+            }
+            const sorted = Array.from(window).sort((a, b) => a - b);
+            percentiles = {
+                frameTimeP95Ms: percentileAsc(sorted, 95),
+                frameTimeP99Ms: percentileAsc(sorted, 99),
+                longFrames,
+            };
+        }
+        const suppress = options.perf?.suppressIdle ?? false;
+        const threshold = options.perf?.fpsThreshold ?? 0;
+        if (suppress && lastFps !== undefined && Math.abs(s.fps - lastFps) <= threshold) {
+            return;
+        }
+        lastFps = s.fps;
+        emit({
+            type: "frame_perf",
+            fps: s.fps,
+            ...(percentiles ?? {}),
+            ...(typeof s.dpr === "number" && s.dpr > 0 ? { dpr: s.dpr } : {}),
+            ...(s.renderScale !== undefined ? { renderScale: s.renderScale } : {}),
+        });
+    }
+    function handleNode(s) {
+        const sample = s.decomposed ?? decomposeNode(s.matrix, s.scaleEps);
+        const key = s.boneId
+            ? `${s.nodeId}\u0000bone\u0000${s.boneId}`
+            : s.childPath !== undefined
+                ? `${s.nodeId}\u0000${s.childPath}`
+                : s.nodeId;
+        const suppress = options.node?.suppressIdle ?? false;
+        const prev = lastNodeSample.get(key);
+        if (suppress && prev && nodeSampleUnchanged(prev, sample, s.scaleEps)) {
+            return;
+        }
+        lastNodeSample.set(key, sample);
+        emit({
+            type: "node_transform",
+            nodeId: s.nodeId,
+            ...(s.childPath !== undefined ? { childPath: s.childPath } : {}),
+            ...(s.boneId !== undefined ? { boneId: s.boneId } : {}),
+            position: sample.position,
+            rotation: sample.rotation,
+            ...(sample.scale ? { scale: sample.scale } : {}),
+        });
+    }
+    function handleVisibilityTick(s) {
+        if (s.stepMs <= 0)
+            return;
+        const centeredCos = options.visibility?.centeredCos ?? 1;
+        const boundingBox = options.visibility?.boundingBox ?? false;
+        const fwdLen = length3(s.forward) || 1;
+        const halfFov = (s.fov || 0.8) / 2;
+        for (const obs of s.meshes) {
+            const { centered, frac } = visibilityContribution(s.camPos, s.forward, fwdLen, halfFov, obs.center, obs.radius, centeredCos);
+            let acc = accums.get(obs.mesh);
+            if (!acc) {
+                acc = { visibleMs: 0, centeredMs: 0, maxScreenFraction: 0 };
+                accums.set(obs.mesh, acc);
+            }
+            acc.visibleMs += s.stepMs;
+            if (centered)
+                acc.centeredMs += s.stepMs;
+            if (frac > acc.maxScreenFraction)
+                acc.maxScreenFraction = frac;
+            if (boundingBox && obs.aabb)
+                acc.bounds = obs.aabb;
+        }
+    }
+    function handleVisibilityFlush() {
+        if (accums.size === 0)
+            return;
+        const boundsEps = options.visibility?.boundsEps ?? 1e-3;
+        const pending = accums;
+        accums = new Map();
+        for (const [mesh, acc] of pending) {
+            if (acc.visibleMs <= 0)
+                continue;
+            let bounds;
+            if (acc.bounds) {
+                const prev = sentBounds.get(mesh);
+                if (!prev || !aabbClose(prev, acc.bounds, boundsEps)) {
+                    bounds = roundAabb(acc.bounds);
+                    sentBounds.set(mesh, acc.bounds);
+                }
+            }
+            emit({
+                type: "mesh_visibility",
+                mesh,
+                visibleMs: Math.round(acc.visibleMs),
+                ...(acc.centeredMs > 0 ? { centeredMs: Math.round(acc.centeredMs) } : {}),
+                ...(acc.maxScreenFraction > 0
+                    ? { maxScreenFraction: Math.round(acc.maxScreenFraction * 1e4) / 1e4 }
+                    : {}),
+                ...(bounds ? { bounds } : {}),
+            });
+        }
+    }
+    return {
+        ingest(snapshot) {
+            switch (snapshot.channel) {
+                case "camera":
+                    emit({
+                        type: "camera_sample",
+                        position: snapshot.position,
+                        direction: snapshot.direction,
+                        ...(snapshot.target ? { target: snapshot.target } : {}),
+                        ...(snapshot.fov !== undefined ? { fov: snapshot.fov } : {}),
+                        ...(snapshot.aspect !== undefined ? { aspect: snapshot.aspect } : {}),
+                        ...(snapshot.near !== undefined ? { near: snapshot.near } : {}),
+                        ...(snapshot.hitPoint ? { hitPoint: snapshot.hitPoint } : {}),
+                        ...(snapshot.hitMesh ? { hitMesh: snapshot.hitMesh } : {}),
+                    });
+                    return;
+                case "perf":
+                    handlePerf(snapshot);
+                    return;
+                case "node":
+                    handleNode(snapshot);
+                    return;
+                case "visibilityTick":
+                    handleVisibilityTick(snapshot);
+                    return;
+                case "visibilityFlush":
+                    handleVisibilityFlush();
+                    return;
+                case "gesture": {
+                    const classified = classifyCameraGesture(snapshot.start, snapshot.end, snapshot.options ?? {});
+                    if (!classified)
+                        return;
+                    emit({
+                        type: "camera_gesture",
+                        kind: classified.kind,
+                        durationMs: snapshot.durationMs,
+                        ...(classified.orbitDeg !== undefined ? { orbitDeg: classified.orbitDeg } : {}),
+                        ...(classified.rollDeg !== undefined ? { rollDeg: classified.rollDeg } : {}),
+                        ...(classified.zoomRatio !== undefined ? { zoomRatio: classified.zoomRatio } : {}),
+                        ...(classified.panDist !== undefined ? { panDist: classified.panDist } : {}),
+                        ...(snapshot.source ? { source: snapshot.source } : {}),
+                    });
+                    return;
+                }
+                case "hover":
+                    emit({
+                        type: "hover_dwell",
+                        mesh: snapshot.mesh,
+                        dwellMs: snapshot.dwellMs,
+                        ...(snapshot.source ? { source: snapshot.source } : {}),
+                    });
+                    return;
+            }
+        },
+        reset() {
+            lastFps = undefined;
+            lastNodeSample.clear();
+            accums = new Map();
+            sentBounds.clear();
+        },
+    };
+}
+/** Decompose a 16-float column-major matrix into a node sample (scale omitted if identity). */
+function decomposeNode(matrix, scaleEps) {
+    if (!matrix || matrix.length < 16) {
+        return { position: [0, 0, 0], rotation: [0, 0, 0, 1] };
+    }
+    const d = decomposeWorldMatrix(matrix);
+    const sample = { position: d.position, rotation: d.rotation };
+    const [sx, sy, sz] = d.scale;
+    if (Math.abs(sx - 1) > scaleEps || Math.abs(sy - 1) > scaleEps || Math.abs(sz - 1) > scaleEps) {
+        sample.scale = d.scale;
+    }
+    return sample;
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/aggregation/aggregator.js.map

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

package/dist/aggregation/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Connector-side offload aggregation (ADR 0031 follow-up, #10).
+ *
+ * The {@link Aggregator} owns the offload-eligible *processing* phase of
+ * per-frame capture; connectors feed it plain-number {@link Snapshot} DTOs. The
+ * pure math is exported too so it has a single, shared home (no per-engine fork).
+ */
+export { createAggregator } from "./aggregator.js";
+export type { Aggregator, AggregatorConfig, AggregatorOptions } from "./aggregator.js";
+export { collectSnapshotTransferables } from "./snapshot.js";
+export type { Snapshot, SnapshotChannel, CameraSnapshot, PerfSnapshot, NodeSnapshot, VisibilityMeshObservation, VisibilityTickSnapshot, VisibilityFlushSnapshot, GestureSnapshot, HoverSnapshot, } from "./snapshot.js";
+export { percentileAsc, visibilityContribution, aabbClose, roundAabb, vec3Close, poseUnchanged, nodeSampleUnchanged, clamp01, sub3, dot3, length3, } from "./math.js";
+export type { VisibilityContribution, CameraPose, NodeSample } from "./math.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/aggregation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,OAAO,GACR,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/aggregation/index.js

@@ -0,0 +1,11 @@
+/**
+ * Connector-side offload aggregation (ADR 0031 follow-up, #10).
+ *
+ * The {@link Aggregator} owns the offload-eligible *processing* phase of
+ * per-frame capture; connectors feed it plain-number {@link Snapshot} DTOs. The
+ * pure math is exported too so it has a single, shared home (no per-engine fork).
+ */
+export { createAggregator } from "./aggregator.js";
+export { collectSnapshotTransferables } from "./snapshot.js";
+export { percentileAsc, visibilityContribution, aabbClose, roundAabb, vec3Close, poseUnchanged, nodeSampleUnchanged, clamp01, sub3, dot3, length3, } from "./math.js";
+//# sourceMappingURL=index.js.map

package/dist/aggregation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aggregation/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAa7D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,OAAO,GACR,MAAM,WAAW,CAAC"}

package/dist/aggregation/math.d.ts

@@ -0,0 +1,63 @@
+import type { Aabb, Quat, Vec3 } from "@uptimizr/schema";
+/**
+ * Shared, engine-agnostic aggregation math (ADR 0031 follow-up, #10).
+ *
+ * These are the pure number-crunching helpers that used to live, duplicated,
+ * inside each connector's `collector.ts` (percentile, mesh-visibility, and
+ * idle-diff math). They are extracted here so the offload {@link Aggregator}
+ * and any remaining main-thread caller share **one** implementation — the same
+ * function runs unchanged on the main thread or inside a worker (ADR 0031 §2,
+ * "no worker-only forks of logic").
+ */
+/**
+ * Nearest-rank percentile over an **ascending-sorted** array. `p` is in `[0,100]`.
+ * Returns `0` for an empty window. Matches the connectors' historical
+ * `percentileAsc` exactly so percentile output is byte-for-byte unchanged.
+ */
+export declare function percentileAsc(sortedAsc: number[], p: number): number;
+export declare function sub3(a: Vec3, b: Vec3): Vec3;
+export declare function dot3(a: Vec3, b: Vec3): number;
+export declare function length3(a: Vec3): number;
+/** Clamp a value into the `[0, 1]` range (for normalized fractions). */
+export declare function clamp01(n: number): number;
+/** One mesh's per-tick contribution to its visibility accumulator. */
+export interface VisibilityContribution {
+    /** Whether the object's centre is within the centred half-angle (gaze proxy). */
+    centered: boolean;
+    /** Bounding-sphere angular size as a fraction of the vertical FOV (`0`–`1`). */
+    frac: number;
+}
+/**
+ * Per-tick screen-fraction + centred test for one mesh, given the camera pose and
+ * the mesh's world bounding sphere. Mirrors the connectors' historical math: a
+ * coarse prominence proxy from the bounding-sphere angular size as a fraction of
+ * the vertical FOV (ADR 0014 — proxy AABBs, not assets), and a "near the view
+ * centre" test from the angle between the view forward and the camera→centre ray.
+ */
+export declare function visibilityContribution(camPos: Vec3, forward: Vec3, forwardLen: number, halfFov: number, center: Vec3, radius: number, centeredCos: number): VisibilityContribution;
+/** True when two AABBs match on every component within `eps` (#53 dedupe). */
+export declare function aabbClose(a: Aabb, b: Aabb, eps: number): boolean;
+/** Round an AABB to millimetre precision for the wire (and to coarsen layout). */
+export declare function roundAabb(a: Aabb): Aabb;
+/** True when two vectors are equal within `eps` on every component. */
+export declare function vec3Close(a: Vec3, b: Vec3, eps: number): boolean;
+/** A camera pose compared between samples for idle suppression. */
+export interface CameraPose {
+    position: Vec3;
+    direction: Vec3;
+    target?: Vec3;
+    fov?: number;
+    aspect?: number;
+    near?: number;
+}
+/** True when two poses are equal within `eps` (target/fov presence must also match). */
+export declare function poseUnchanged(a: CameraPose, b: CameraPose, eps: number): boolean;
+/** A captured world/local transform for a scene actor (`node_transform`, ADR 0027). */
+export interface NodeSample {
+    position: Vec3;
+    rotation: Quat;
+    scale?: Vec3;
+}
+/** True when two node samples are equal within `eps` (scale presence must also match). */
+export declare function nodeSampleUnchanged(a: NodeSample, b: NodeSample, eps: number): boolean;
+//# sourceMappingURL=math.d.ts.map

package/dist/aggregation/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/aggregation/math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpE;AAID,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAEvC;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAID,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE,IAAI,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,sBAAsB,CAQxB;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAKhE;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CASvC;AAID,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAahF;AAED,uFAAuF;AACvF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAED,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAatF"}

package/dist/aggregation/math.js

@@ -0,0 +1,118 @@
+/**
+ * Shared, engine-agnostic aggregation math (ADR 0031 follow-up, #10).
+ *
+ * These are the pure number-crunching helpers that used to live, duplicated,
+ * inside each connector's `collector.ts` (percentile, mesh-visibility, and
+ * idle-diff math). They are extracted here so the offload {@link Aggregator}
+ * and any remaining main-thread caller share **one** implementation — the same
+ * function runs unchanged on the main thread or inside a worker (ADR 0031 §2,
+ * "no worker-only forks of logic").
+ */
+// --- Frame-time percentiles (#41) ------------------------------------------
+/**
+ * Nearest-rank percentile over an **ascending-sorted** array. `p` is in `[0,100]`.
+ * Returns `0` for an empty window. Matches the connectors' historical
+ * `percentileAsc` exactly so percentile output is byte-for-byte unchanged.
+ */
+export function percentileAsc(sortedAsc, p) {
+    if (sortedAsc.length === 0)
+        return 0;
+    const rank = Math.ceil((p / 100) * sortedAsc.length);
+    const idx = Math.min(sortedAsc.length, Math.max(1, rank)) - 1;
+    return sortedAsc[idx] ?? 0;
+}
+// --- Vector helpers --------------------------------------------------------
+export function sub3(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+export function dot3(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+export function length3(a) {
+    return Math.hypot(a[0], a[1], a[2]);
+}
+/** Clamp a value into the `[0, 1]` range (for normalized fractions). */
+export function clamp01(n) {
+    return n < 0 ? 0 : n > 1 ? 1 : n;
+}
+/**
+ * Per-tick screen-fraction + centred test for one mesh, given the camera pose and
+ * the mesh's world bounding sphere. Mirrors the connectors' historical math: a
+ * coarse prominence proxy from the bounding-sphere angular size as a fraction of
+ * the vertical FOV (ADR 0014 — proxy AABBs, not assets), and a "near the view
+ * centre" test from the angle between the view forward and the camera→centre ray.
+ */
+export function visibilityContribution(camPos, forward, forwardLen, halfFov, center, radius, centeredCos) {
+    const toCenter = sub3(center, camPos);
+    const dist = length3(toCenter) || 1e-6;
+    const cosAngle = dot3(toCenter, forward) / (dist * forwardLen);
+    const centered = cosAngle >= centeredCos;
+    const angularRadius = Math.atan2(radius, dist);
+    const frac = clamp01(angularRadius / (halfFov || 1e-6));
+    return { centered, frac };
+}
+/** True when two AABBs match on every component within `eps` (#53 dedupe). */
+export function aabbClose(a, b, eps) {
+    for (let i = 0; i < 6; i++) {
+        if (Math.abs((a[i] ?? 0) - (b[i] ?? 0)) > eps)
+            return false;
+    }
+    return true;
+}
+/** Round an AABB to millimetre precision for the wire (and to coarsen layout). */
+export function roundAabb(a) {
+    return [
+        Math.round(a[0] * 1e3) / 1e3,
+        Math.round(a[1] * 1e3) / 1e3,
+        Math.round(a[2] * 1e3) / 1e3,
+        Math.round(a[3] * 1e3) / 1e3,
+        Math.round(a[4] * 1e3) / 1e3,
+        Math.round(a[5] * 1e3) / 1e3,
+    ];
+}
+// --- Idle-diffing (ADR 0012 conservative defaults) -------------------------
+/** True when two vectors are equal within `eps` on every component. */
+export function vec3Close(a, b, eps) {
+    return (Math.abs(a[0] - b[0]) <= eps && Math.abs(a[1] - b[1]) <= eps && Math.abs(a[2] - b[2]) <= eps);
+}
+/** True when two poses are equal within `eps` (target/fov presence must also match). */
+export function poseUnchanged(a, b, eps) {
+    if (!vec3Close(a.position, b.position, eps))
+        return false;
+    if (!vec3Close(a.direction, b.direction, eps))
+        return false;
+    if ((a.target === undefined) !== (b.target === undefined))
+        return false;
+    if (a.target && b.target && !vec3Close(a.target, b.target, eps))
+        return false;
+    if ((a.fov === undefined) !== (b.fov === undefined))
+        return false;
+    if (a.fov !== undefined && b.fov !== undefined && Math.abs(a.fov - b.fov) > eps)
+        return false;
+    if ((a.aspect === undefined) !== (b.aspect === undefined))
+        return false;
+    if (a.aspect !== undefined && b.aspect !== undefined && Math.abs(a.aspect - b.aspect) > eps)
+        return false;
+    if ((a.near === undefined) !== (b.near === undefined))
+        return false;
+    if (a.near !== undefined && b.near !== undefined && Math.abs(a.near - b.near) > eps)
+        return false;
+    return true;
+}
+/** True when two node samples are equal within `eps` (scale presence must also match). */
+export function nodeSampleUnchanged(a, b, eps) {
+    if (!vec3Close(a.position, b.position, eps))
+        return false;
+    if (Math.abs(a.rotation[0] - b.rotation[0]) > eps ||
+        Math.abs(a.rotation[1] - b.rotation[1]) > eps ||
+        Math.abs(a.rotation[2] - b.rotation[2]) > eps ||
+        Math.abs(a.rotation[3] - b.rotation[3]) > eps) {
+        return false;
+    }
+    if ((a.scale === undefined) !== (b.scale === undefined))
+        return false;
+    if (a.scale && b.scale && !vec3Close(a.scale, b.scale, eps))
+        return false;
+    return true;
+}
+//# sourceMappingURL=math.js.map

package/dist/aggregation/math.js.map

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

package/dist/aggregation/snapshot.d.ts

@@ -0,0 +1,123 @@
+import type { Vec3 } from "@uptimizr/schema";
+import type { CameraGestureSample, GestureClassifyOptions } from "../gesture.js";
+import type { CameraPose, NodeSample } from "./math.js";
+/**
+ * Internal **snapshot DTOs** for the connector-side offload seam (ADR 0031
+ * follow-up, #10).
+ *
+ * These are the plain-data records a connector produces on the main thread after
+ * reading live engine state (the cheap "snapshot" phase) and hands to the
+ * {@link Aggregator} (the offload-eligible "processing" phase). They are an
+ * **internal SDK transport contract** — they never reach the wire, so they are
+ * deliberately *not* part of `@uptimizr/schema` (the wire contract stays
+ * unchanged; ADR 0031 §7, ADR 0003). The aggregator consumes them and produces
+ * the Zod-shaped `@uptimizr/schema` events.
+ *
+ * The boundary is kept clean: no engine or DOM handle crosses it, only numbers,
+ * ids and timestamps. High-volume channels (the frame-time window, node/bone
+ * matrices) are typed-array-backed so they can move to a worker zero-copy via
+ * the transferable mechanism (#98).
+ */
+/** A camera pose + optional gaze hit. The connector has already idle-gated this. */
+export interface CameraSnapshot {
+    channel: "camera";
+    position: Vec3;
+    direction: Vec3;
+    target?: Vec3;
+    fov?: number;
+    /** Viewport aspect ratio (width / height), when the connector captures it (#22). */
+    aspect?: number;
+    /** Camera near-plane distance in world units, when the connector captures it (#22). */
+    near?: number;
+    /** Surface hit of the forward gaze ray, when gaze capture is on (ADR 0030). */
+    hitPoint?: Vec3;
+    hitMesh?: string;
+}
+/**
+ * A frame-time window plus the engine perf reads taken at finalize time. The
+ * percentile sort, `longFrames` count and FPS idle-diff move to the aggregator.
+ * `frameTimes` is a fresh, owned `Float32Array` so it can be transferred.
+ */
+export interface PerfSnapshot {
+    channel: "perf";
+    /** Per-frame deltas (ms) collected since the previous perf sample. */
+    frameTimes: Float32Array;
+    fps: number;
+    /** Frames slower than this (ms) count as `longFrames`. */
+    jankFrameMs: number;
+    dpr?: number;
+    renderScale?: number;
+}
+/**
+ * A node/bone transform snapshot. Either already-decomposed (engines that expose
+ * an absolute position/quaternion/scale, e.g. Babylon world nodes) or a raw
+ * column-major matrix (bones, three.js world matrices) the aggregator decomposes.
+ * Idle-diffing is keyed by `(nodeId, childPath ?? boneId)` and runs aggregator-side.
+ */
+export interface NodeSnapshot {
+    channel: "node";
+    nodeId: string;
+    childPath?: string;
+    boneId?: string;
+    /** Pre-decomposed transform (mutually exclusive with {@link matrix}). */
+    decomposed?: NodeSample;
+    /** Column-major 16-float world/local matrix to decompose (transferable-backed). */
+    matrix?: Float32Array;
+    /** Scale dead-zone: scale within `scaleEps` of identity is omitted. */
+    scaleEps: number;
+}
+/** One mesh's per-tick visibility observation (engine reads already taken). */
+export interface VisibilityMeshObservation {
+    mesh: string;
+    center: Vec3;
+    radius: number;
+    /** World AABB `[minX,minY,minZ,maxX,maxY,maxZ]`, when bounds capture is on (#53). */
+    aabb?: [number, number, number, number, number, number];
+}
+/** A single render-tick of mesh-visibility observations (#37). */
+export interface VisibilityTickSnapshot {
+    channel: "visibilityTick";
+    /** Elapsed time of this tick in ms (the dwell increment). */
+    stepMs: number;
+    camPos: Vec3;
+    forward: Vec3;
+    /** Camera vertical FOV in radians (used for the screen-fraction proxy). */
+    fov: number;
+    meshes: VisibilityMeshObservation[];
+}
+/** Finalize the current mesh-visibility window: emit one summary per object. */
+export interface VisibilityFlushSnapshot {
+    channel: "visibilityFlush";
+}
+/** A camera-gesture bracket (start→end) to classify (ADR 0025). */
+export interface GestureSnapshot {
+    channel: "gesture";
+    start: CameraGestureSample;
+    end: CameraGestureSample;
+    /** Length of the input bracket (`down → up`) in ms, measured on the main thread. */
+    durationMs: number;
+    options?: GestureClassifyOptions;
+    /** Discrete input source that bracketed the gesture (ADR 0023), when known. */
+    source?: string;
+}
+/** A completed hover episode past its dwell threshold (#48). */
+export interface HoverSnapshot {
+    channel: "hover";
+    mesh: string;
+    dwellMs: number;
+    source?: string;
+}
+/** The union the aggregator ingests. */
+export type Snapshot = CameraSnapshot | PerfSnapshot | NodeSnapshot | VisibilityTickSnapshot | VisibilityFlushSnapshot | GestureSnapshot | HoverSnapshot;
+/** Channel discriminator for a {@link Snapshot}. */
+export type SnapshotChannel = Snapshot["channel"];
+/** Re-export so callers can type the camera idle-diff pre-gate against it. */
+export type { CameraPose };
+/**
+ * Collect the transferable buffers a snapshot carries so they move to the worker
+ * zero-copy (ADR 0031 §6, #98). Transferring neuters the buffer on the main
+ * thread, so a snapshot that opts in must own a fresh buffer; the aggregator's
+ * default (main) path never transfers, so the buffer stays usable there.
+ */
+export declare function collectSnapshotTransferables(snapshot: Snapshot): Transferable[];
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/aggregation/snapshot.d.ts.map

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