@uptimizr/sdk-core 0.1.0

package/dist/coordinates.js

@@ -0,0 +1,127 @@
+/**
+ * Canonical world coordinate frame for everything on the wire (ADR 0018):
+ * **left-handed, y-up, unit scale 1** (Babylon-native). Connectors normalize their
+ * engine's world-space data to this frame at the emission boundary and record their
+ * native frame as provenance on `session_start`.
+ */
+export const CANONICAL_FRAME = {
+    handedness: "left",
+    upAxis: "y",
+    unitScale: 1,
+};
+/** Normalize `-0` to `0` so converted payloads serialize cleanly. */
+function nz(n) {
+    return n === 0 ? 0 : n;
+}
+/**
+ * Convert a **world-space position** from a source engine's frame to the canonical
+ * frame (left-handed, y-up).
+ *
+ * Assumes a **y-up** source (true for three.js, glTF, PlayCanvas, Babylon). For a
+ * right-handed source the handedness flip is the reflection `diag(1, 1, -1)` —
+ * i.e. negate Z. A left-handed source is already canonical and is returned
+ * unchanged (a fresh copy). Non-y-up sources are out of scope; the connector must
+ * rebase to y-up before calling.
+ */
+export function toCanonicalPosition(p, sourceHandedness) {
+    if (sourceHandedness === "left")
+        return [p[0], p[1], p[2]];
+    return [nz(p[0]), nz(p[1]), nz(-p[2])];
+}
+/**
+ * Convert a **world-space direction vector** (e.g. a camera's forward ray) from a
+ * source engine's frame to the canonical frame. Same reflection as
+ * {@link toCanonicalPosition} — directions ignore translation, so a right-handed
+ * source negates Z.
+ *
+ * ⚠️ Orientation is convention-dependent, and this is the common trap. A camera's
+ * *look direction* differs per engine: three.js cameras look along local **−Z**,
+ * the canonical (Babylon-style) camera looks along local **+Z**. This helper is
+ * correct **only when you pass a true world-space direction** (the actual look
+ * vector in world coordinates). If you instead reconstruct orientation from a
+ * **local quaternion / Euler**, reflecting components is **not** enough — you must
+ * also apply a rotation (a forward-axis flip / ~180° about the up axis) to account
+ * for the −Z vs +Z forward convention. Capture orientation as a world-space
+ * forward (and up) direction *before* converting.
+ */
+export function toCanonicalDirection(d, sourceHandedness) {
+    if (sourceHandedness === "left")
+        return [d[0], d[1], d[2]];
+    return [nz(d[0]), nz(d[1]), nz(-d[2])];
+}
+/**
+ * Convert a world-space axis-aligned bounding box `[minX, minY, minZ, maxX, maxY,
+ * maxZ]` to the canonical frame. Negating the Z axis swaps the Z min/max, so the
+ * result stays a well-formed AABB (min ≤ max per axis).
+ */
+export function toCanonicalAabb(aabb, sourceHandedness) {
+    if (sourceHandedness === "left") {
+        return [aabb[0], aabb[1], aabb[2], aabb[3], aabb[4], aabb[5]];
+    }
+    // X/Y unchanged; Z reflects, so the old maxZ becomes the new minZ and vice versa.
+    return [nz(aabb[0]), nz(aabb[1]), nz(-aabb[5]), nz(aabb[3]), nz(aabb[4]), nz(-aabb[2])];
+}
+/**
+ * Convert a **world-space position** from the canonical frame back into a target
+ * engine's native frame — the inverse of {@link toCanonicalPosition}. Used by
+ * replay drivers, which read canonical events off the wire and write them into a
+ * host scene (e.g. re-driving a three.js camera).
+ *
+ * The handedness flip is the reflection `diag(1, 1, -1)`, which is its own
+ * inverse, so this delegates to the same basis change — but the named inverse
+ * keeps replay/host code self-documenting (canonical → engine).
+ */
+export function fromCanonicalPosition(p, targetHandedness) {
+    return toCanonicalPosition(p, targetHandedness);
+}
+/**
+ * Convert a **world-space direction vector** from the canonical frame back into a
+ * target engine's native frame — the inverse of {@link toCanonicalDirection}.
+ *
+ * The same orientation caveat applies in reverse: this yields a correct
+ * world-space direction, but a host that needs a *camera orientation* should
+ * point the camera at a converted world-space target (e.g. `camera.lookAt`)
+ * rather than feeding this into a local-rotation reconstruction.
+ */
+export function fromCanonicalDirection(d, targetHandedness) {
+    return toCanonicalDirection(d, targetHandedness);
+}
+/**
+ * Convert a world-space AABB from the canonical frame back into a target engine's
+ * native frame — the inverse of {@link toCanonicalAabb} (Z min/max swap is its
+ * own inverse, so the box stays well-formed).
+ */
+export function fromCanonicalAabb(aabb, targetHandedness) {
+    return toCanonicalAabb(aabb, targetHandedness);
+}
+/**
+ * Convert a **world-space orientation quaternion** `[x, y, z, w]` from a source
+ * engine's frame to the canonical frame (left-handed, y-up). Used for
+ * `node_transform` (ADR 0027): a scene actor's world rotation.
+ *
+ * The handedness flip is the same reflection as {@link toCanonicalPosition}
+ * (`diag(1, 1, -1)`, i.e. negate Z). Conjugating a rotation by that reflection
+ * maps the quaternion `(x, y, z, w) → (-x, -y, z, w)`: the reflected rotation
+ * axis is `(ax, ay, -az)` while the handedness flip negates the angle, and the
+ * two sign changes combine to leave only `x` and `y` negated. A left-handed
+ * source is already canonical and returned as a copy.
+ *
+ * Unlike a camera's *look direction* (whose forward-axis convention differs per
+ * engine — see {@link toCanonicalDirection}), an object's world rotation has no
+ * such convention, so this conversion is exact for scene-actor orientation.
+ */
+export function toCanonicalQuat(q, sourceHandedness) {
+    if (sourceHandedness === "left")
+        return [q[0], q[1], q[2], q[3]];
+    return [nz(-q[0]), nz(-q[1]), nz(q[2]), nz(q[3])];
+}
+/**
+ * Convert a **world-space orientation quaternion** from the canonical frame back
+ * into a target engine's native frame — the inverse of {@link toCanonicalQuat}.
+ * The reflection is its own inverse, so this delegates to the same basis change;
+ * the named inverse keeps replay/host code self-documenting (canonical → engine).
+ */
+export function fromCanonicalQuat(q, targetHandedness) {
+    return toCanonicalQuat(q, targetHandedness);
+}
+//# sourceMappingURL=coordinates.js.map

package/dist/coordinates.js.map

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

package/dist/gesture.d.ts

@@ -0,0 +1,96 @@
+import type { CameraGestureKind, Vec3 } from "@uptimizr/schema";
+/**
+ * Shared, engine-agnostic camera-gesture classifier (ADR 0025).
+ *
+ * A gesture is a **discrete, user-initiated viewpoint change** bracketed by an
+ * input gesture (pointer down→up, XR thumbstick/grab). Connectors snapshot the
+ * camera at the bracket's start and end and hand both samples here; this module
+ * decides whether the camera moved enough to count as navigation and, if so,
+ * which kind (orbit / pan / dolly / zoom / roll / fly) dominated and by how much.
+ *
+ * It is pure (no engine, no DOM): it consumes only canonical-frame pose +
+ * optional intrinsics, so every connector shares one classification contract.
+ * Connectors that expose a real pivot/distance (Babylon `ArcRotateCamera`) get
+ * the most precise typing; connectors that expose only position + forward
+ * (three.js, PlayCanvas, where orbit controls are an external library) still get
+ * a good result because an **implied pivot** is inferred from the two view rays.
+ */
+/**
+ * A camera snapshot at one instant of a gesture bracket, in the canonical world
+ * frame (ADR 0018). Only `position` and `forward` are required; the rest sharpen
+ * the classification when the camera exposes them.
+ */
+export interface CameraGestureSample {
+    /** World position. */
+    position: Vec3;
+    /** Normalized forward / look direction. */
+    forward: Vec3;
+    /** Normalized up direction. Enables roll detection when present. */
+    up?: Vec3;
+    /** Explicit pivot/target point (e.g. an arc-rotate camera's target). */
+    pivot?: Vec3;
+    /** Camera-to-pivot distance (e.g. an arc-rotate radius). */
+    distance?: number;
+    /** Vertical field of view in radians. Enables `zoom` (fov) detection. */
+    fov?: number;
+}
+/**
+ * Per-axis motion dead-zones: the minimum change on each axis that counts as
+ * navigation rather than a click/select (ADR 0025). Below every threshold the
+ * gesture is not a navigation gesture and {@link classifyCameraGesture} returns
+ * `null`. A single {@link GestureClassifyOptions.sensitivity} dial scales all of
+ * them together; per-axis overrides are a rarely-needed escape hatch.
+ */
+export interface GestureThresholds {
+    /** Min forward/orbit rotation, in degrees. Default 1. */
+    orbitDeg: number;
+    /** Min roll about the forward axis, in degrees. Default 1. */
+    rollDeg: number;
+    /** Min magnification change `|zoomRatio - 1|` (dolly or fov). Default 0.02. */
+    zoom: number;
+    /** Min normalized pan/fly distance. Default 0.005. */
+    pan: number;
+}
+/** Default per-axis dead-zones (ADR 0025 §3). */
+export declare const DEFAULT_GESTURE_THRESHOLDS: GestureThresholds;
+export interface GestureClassifyOptions {
+    /** Per-axis dead-zone overrides. Omitted axes use {@link DEFAULT_GESTURE_THRESHOLDS}. */
+    thresholds?: Partial<GestureThresholds>;
+    /**
+     * Single sensitivity multiplier scaling every dead-zone (ADR 0025 §3). `< 1`
+     * makes the classifier more sensitive (smaller dead-zones), `> 1` less. Default 1.
+     */
+    sensitivity?: number;
+    /**
+     * Scene bounding radius, used to normalize `panDist` for pivot-less cameras
+     * (the fallback when no camera-to-pivot distance is available). Omit when
+     * unknown; pan magnitude then falls back to raw world units.
+     */
+    sceneRadius?: number;
+}
+/** The classified gesture magnitudes + dominant {@link CameraGestureKind}. */
+export interface ClassifiedGesture {
+    /** The dominant motion. */
+    kind: CameraGestureKind;
+    /** Angular sweep of the forward direction, in degrees, when it rotated. */
+    orbitDeg?: number;
+    /** Roll about the forward axis, in degrees, when it rolled. */
+    rollDeg?: number;
+    /** Magnification ratio (`> 1` = moved/zoomed in) for dolly or fov zoom. */
+    zoomRatio?: number;
+    /** Normalized lateral/free translation distance, when it panned or flew. */
+    panDist?: number;
+}
+/**
+ * Classify a camera-navigation gesture (ADR 0025) from its start/end snapshots.
+ *
+ * Returns the dominant {@link ClassifiedGesture.kind} plus the magnitude of every
+ * axis that exceeded its dead-zone, or `null` when the camera did not move enough
+ * to be navigation (i.e. the bracket should remain a click/select).
+ *
+ * The dominant axis is the one most strongly exceeding its own dead-zone (its
+ * magnitude-over-threshold ratio), so kinds with different units (degrees vs.
+ * ratios vs. distances) are compared on a common "signal above noise" scale.
+ */
+export declare function classifyCameraGesture(start: CameraGestureSample, end: CameraGestureSample, options?: GestureClassifyOptions): ClassifiedGesture | null;
+//# sourceMappingURL=gesture.d.ts.map

package/dist/gesture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture.d.ts","sourceRoot":"","sources":["../src/gesture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,QAAQ,EAAE,IAAI,CAAC;IACf,2CAA2C;IAC3C,OAAO,EAAE,IAAI,CAAC;IACd,oEAAoE;IACpE,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,wEAAwE;IACxE,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,EAAE,iBAKxC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoFD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,mBAAmB,EACxB,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,GAAG,IAAI,CAuF1B"}

package/dist/gesture.js

@@ -0,0 +1,178 @@
+/** Default per-axis dead-zones (ADR 0025 §3). */
+export const DEFAULT_GESTURE_THRESHOLDS = {
+    orbitDeg: 1,
+    rollDeg: 1,
+    zoom: 0.02,
+    pan: 0.005,
+};
+const RAD2DEG = 180 / Math.PI;
+function sub(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+function dot(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+function len(a) {
+    return Math.hypot(a[0], a[1], a[2]);
+}
+function normalize(a) {
+    const l = len(a);
+    return l > 1e-9 ? [a[0] / l, a[1] / l, a[2] / l] : [0, 0, 0];
+}
+/** Angle between two vectors in degrees, clamped against floating-point drift. */
+function angleDeg(a, b) {
+    const la = len(a);
+    const lb = len(b);
+    if (la < 1e-9 || lb < 1e-9)
+        return 0;
+    const c = Math.min(1, Math.max(-1, dot(a, b) / (la * lb)));
+    return Math.acos(c) * RAD2DEG;
+}
+/**
+ * Infer a pivot point from two view rays (origin + forward) when the camera does
+ * not expose one. If the forward direction rotated, the closest approach of the
+ * two rays approximates the point the user revolved around — letting pivot-less
+ * cameras (three.js / PlayCanvas orbit controls) be typed as `orbit`/`pan` and
+ * giving a distance to normalize `panDist`. Returns `null` when the rays are
+ * near-parallel (no rotation ⇒ no orbit) or converge behind the camera.
+ */
+function inferPivot(start, end) {
+    const p0 = start.position;
+    const d0 = normalize(start.forward);
+    const p1 = end.position;
+    const d1 = normalize(end.forward);
+    const r = sub(p0, p1);
+    const a = dot(d0, d0); // = 1
+    const b = dot(d0, d1);
+    const c = dot(d1, d1); // = 1
+    const d = dot(d0, r);
+    const e = dot(d1, r);
+    const denom = a * c - b * b;
+    // Near-parallel rays ⇒ no meaningful rotation/pivot.
+    if (denom < 1e-4)
+        return null;
+    const t0 = (b * e - c * d) / denom;
+    const t1 = (a * e - b * d) / denom;
+    // Pivot must be in front of both cameras to be a revolve target.
+    if (t0 <= 0 || t1 <= 0)
+        return null;
+    const c0 = [p0[0] + t0 * d0[0], p0[1] + t0 * d0[1], p0[2] + t0 * d0[2]];
+    const c1 = [p1[0] + t1 * d1[0], p1[1] + t1 * d1[1], p1[2] + t1 * d1[2]];
+    const pivot = [(c0[0] + c1[0]) / 2, (c0[1] + c1[1]) / 2, (c0[2] + c1[2]) / 2];
+    return { pivot, distance: (t0 + t1) / 2 };
+}
+/** Roll = rotation about the forward axis, read from the up vectors' twist. */
+function computeRollDeg(start, end) {
+    if (!start.up || !end.up)
+        return 0;
+    // Project both up vectors onto the plane perpendicular to the (shared) forward
+    // axis, then measure the angle between the projections — that is the twist.
+    const f = normalize([
+        start.forward[0] + end.forward[0],
+        start.forward[1] + end.forward[1],
+        start.forward[2] + end.forward[2],
+    ]);
+    if (len(f) < 1e-6)
+        return 0;
+    const u0 = normalize(sub(start.up, [f[0] * dot(start.up, f), f[1] * dot(start.up, f), f[2] * dot(start.up, f)]));
+    const u1 = normalize(sub(end.up, [f[0] * dot(end.up, f), f[1] * dot(end.up, f), f[2] * dot(end.up, f)]));
+    return angleDeg(u0, u1);
+}
+/**
+ * Classify a camera-navigation gesture (ADR 0025) from its start/end snapshots.
+ *
+ * Returns the dominant {@link ClassifiedGesture.kind} plus the magnitude of every
+ * axis that exceeded its dead-zone, or `null` when the camera did not move enough
+ * to be navigation (i.e. the bracket should remain a click/select).
+ *
+ * The dominant axis is the one most strongly exceeding its own dead-zone (its
+ * magnitude-over-threshold ratio), so kinds with different units (degrees vs.
+ * ratios vs. distances) are compared on a common "signal above noise" scale.
+ */
+export function classifyCameraGesture(start, end, options = {}) {
+    const sensitivity = options.sensitivity && options.sensitivity > 0 ? options.sensitivity : 1;
+    const t = {
+        orbitDeg: (options.thresholds?.orbitDeg ?? DEFAULT_GESTURE_THRESHOLDS.orbitDeg) * sensitivity,
+        rollDeg: (options.thresholds?.rollDeg ?? DEFAULT_GESTURE_THRESHOLDS.rollDeg) * sensitivity,
+        zoom: (options.thresholds?.zoom ?? DEFAULT_GESTURE_THRESHOLDS.zoom) * sensitivity,
+        pan: (options.thresholds?.pan ?? DEFAULT_GESTURE_THRESHOLDS.pan) * sensitivity,
+    };
+    // Resolve a pivot/distance: explicit (arc-rotate) first, else inferred from the
+    // two view rays. Pivot-less cameras with no rotation stay pivot-less (→ fly).
+    const explicitPivot = start.pivot && start.distance !== undefined
+        ? { pivot: start.pivot, distance: start.distance, explicit: true }
+        : null;
+    const inferred = explicitPivot ? null : inferPivot(start, end);
+    const pivot = explicitPivot ?? (inferred ? { ...inferred, explicit: false } : null);
+    // --- Axis magnitudes -------------------------------------------------------
+    const orbitDeg = angleDeg(start.forward, end.forward);
+    const rollDeg = computeRollDeg(start, end);
+    // Magnification: prefer fov change (zoom); else a pivot-distance change (dolly).
+    let zoomRatio;
+    let zoomIsDolly = false;
+    if (start.fov !== undefined && end.fov !== undefined && end.fov > 1e-6) {
+        zoomRatio = start.fov / end.fov;
+    }
+    else if (explicitPivot &&
+        start.distance !== undefined &&
+        end.distance !== undefined &&
+        end.distance > 1e-6) {
+        zoomRatio = start.distance / end.distance;
+        zoomIsDolly = true;
+    }
+    // Translation: with a pivot, pan = lateral motion of the pivot (the framing
+    // slides); without a pivot, the whole position translation is free flight.
+    const translation = sub(end.position, start.position);
+    let panRaw;
+    let isFly = false;
+    if (pivot) {
+        const pivotEnd = explicitPivot
+            ? (end.pivot ?? pivot.pivot)
+            : (inferPivot(end, start)?.pivot ?? pivot.pivot);
+        const pivotDelta = sub(pivotEnd, pivot.pivot);
+        // Lateral component (perpendicular to forward) of the pivot's movement.
+        const f = normalize(start.forward);
+        const along = dot(pivotDelta, f);
+        const lateral = sub(pivotDelta, [f[0] * along, f[1] * along, f[2] * along]);
+        panRaw = len(lateral);
+    }
+    else {
+        panRaw = len(translation);
+        isFly = panRaw > 0;
+    }
+    // Normalize pan by camera-to-pivot distance (perceptual), else scene radius.
+    const panNormalizer = pivot && pivot.distance > 1e-6
+        ? pivot.distance
+        : options.sceneRadius && options.sceneRadius > 1e-6
+            ? options.sceneRadius
+            : undefined;
+    const panDist = panNormalizer ? panRaw / panNormalizer : panRaw;
+    // --- Dead-zone gate + dominant axis ---------------------------------------
+    const zoomMag = zoomRatio !== undefined ? Math.abs(zoomRatio - 1) : 0;
+    const scores = [];
+    if (orbitDeg > t.orbitDeg)
+        scores.push({ kind: "orbit", ratio: orbitDeg / t.orbitDeg });
+    if (rollDeg > t.rollDeg)
+        scores.push({ kind: "roll", ratio: rollDeg / t.rollDeg });
+    if (zoomMag > t.zoom) {
+        scores.push({ kind: zoomIsDolly ? "dolly" : "zoom", ratio: zoomMag / t.zoom });
+    }
+    if (panDist > t.pan) {
+        scores.push({ kind: isFly ? "fly" : "pan", ratio: panDist / t.pan });
+    }
+    if (scores.length === 0)
+        return null;
+    scores.sort((x, y) => y.ratio - x.ratio);
+    const kind = scores[0].kind;
+    const result = { kind };
+    if (orbitDeg > t.orbitDeg)
+        result.orbitDeg = orbitDeg;
+    if (rollDeg > t.rollDeg)
+        result.rollDeg = rollDeg;
+    if (zoomMag > t.zoom && zoomRatio !== undefined)
+        result.zoomRatio = zoomRatio;
+    if (panDist > t.pan)
+        result.panDist = panDist;
+    return result;
+}
+//# sourceMappingURL=gesture.js.map

package/dist/gesture.js.map

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

package/dist/idgen.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generate a random, non-persistent identifier.
+ *
+ * Used for in-memory session IDs only. Per ADR 0003 the SDK never stores a durable
+ * identifier on the client, so these IDs live only for the lifetime of the page.
+ */
+export declare function randomId(): string;
+//# sourceMappingURL=idgen.d.ts.map

package/dist/idgen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idgen.d.ts","sourceRoot":"","sources":["../src/idgen.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CAOjC"}

package/dist/idgen.js

@@ -0,0 +1,15 @@
+/**
+ * Generate a random, non-persistent identifier.
+ *
+ * Used for in-memory session IDs only. Per ADR 0003 the SDK never stores a durable
+ * identifier on the client, so these IDs live only for the lifetime of the page.
+ */
+export function randomId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === "function") {
+        return c.randomUUID();
+    }
+    // Fallback for environments without crypto.randomUUID.
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+//# sourceMappingURL=idgen.js.map

package/dist/idgen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idgen.js","sourceRoot":"","sources":["../src/idgen.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,CAAC,GAAI,UAAkC,CAAC,MAAM,CAAC;IACrD,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5C,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC;IACD,uDAAuD;IACvD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@uptimizr/sdk-core` — the framework-agnostic Uptimizr capture runtime.
+ *
+ * Owns the session, an in-memory batching queue, flush scheduling, and a cookieless
+ * transport. Engine-specific capture (e.g. Babylon) plugs in via `client.use()`.
+ */
+export { UptimizrClient } from "./client.js";
+export { EventQueue } from "./queue.js";
+export { createBeaconTransport } from "./transport.js";
+export { createMainProcessor, createWorkerProcessor, collectTransferables } from "./processor.js";
+export { randomId } from "./idgen.js";
+export { SDK_VERSION } from "./version.js";
+export { resolveCadence } from "./sampling.js";
+export { classifyCameraGesture, DEFAULT_GESTURE_THRESHOLDS } from "./gesture.js";
+export { CANONICAL_FRAME, toCanonicalAabb, toCanonicalDirection, toCanonicalPosition, toCanonicalQuat, fromCanonicalAabb, fromCanonicalDirection, fromCanonicalPosition, fromCanonicalQuat, } from "./coordinates.js";
+export { decomposeWorldMatrix } from "./matrix.js";
+export type { DecomposedTransform } from "./matrix.js";
+export { xrSource, xrHandedness } from "./xrInput.js";
+export type { Collector, CollectorContext, CollectorHandle, BeforeSendHook, EventInput, ResolvedConfig, StartMeta, TrackInputOptions, CapabilityChangeReport, Transport, UptimizrConfig, } from "./types.js";
+export type { Processor, WorkerLike, WorkerFactory, WorkerProcessorOptions } from "./processor.js";
+export type { SampleRate, SamplingProfile, BoneSamplingConfig, NodeSamplingConfig, ResolvedCadence, } from "./sampling.js";
+export type { CameraGestureSample, ClassifiedGesture, GestureThresholds, GestureClassifyOptions, } from "./gesture.js";
+export type { XrInputSourceLike, XrCaptureOptions, XrRayHit, XrRayProbe } from "./xrInput.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEtD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,EACT,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAEnG,YAAY,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * `@uptimizr/sdk-core` — the framework-agnostic Uptimizr capture runtime.
+ *
+ * Owns the session, an in-memory batching queue, flush scheduling, and a cookieless
+ * transport. Engine-specific capture (e.g. Babylon) plugs in via `client.use()`.
+ */
+export { UptimizrClient } from "./client.js";
+export { EventQueue } from "./queue.js";
+export { createBeaconTransport } from "./transport.js";
+export { createMainProcessor, createWorkerProcessor, collectTransferables } from "./processor.js";
+export { randomId } from "./idgen.js";
+export { SDK_VERSION } from "./version.js";
+export { resolveCadence } from "./sampling.js";
+export { classifyCameraGesture, DEFAULT_GESTURE_THRESHOLDS } from "./gesture.js";
+export { CANONICAL_FRAME, toCanonicalAabb, toCanonicalDirection, toCanonicalPosition, toCanonicalQuat, fromCanonicalAabb, fromCanonicalDirection, fromCanonicalPosition, fromCanonicalQuat, } from "./coordinates.js";
+export { decomposeWorldMatrix } from "./matrix.js";
+export { xrSource, xrHandedness } from "./xrInput.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/matrix.d.ts

@@ -0,0 +1,22 @@
+import type { Quat, Vec3 } from "@uptimizr/schema";
+/**
+ * A decomposed world transform: position, rotation quaternion `[x,y,z,w]`, and
+ * scale — in the **source engine's native frame**. Apply the `toCanonical*`
+ * helpers to reflect into the canonical wire frame (ADR 0018).
+ */
+export interface DecomposedTransform {
+    position: Vec3;
+    rotation: Quat;
+    scale: Vec3;
+}
+/**
+ * Decompose a **column-major** world matrix (the layout three.js `Matrix4.elements`,
+ * Babylon `Matrix.m`, and PlayCanvas `Mat4.data` all share) into position /
+ * rotation quaternion / scale, using the same algorithm as `Matrix4.decompose`:
+ * scale is the length of each basis column (negate `sx` when the upper-left 3×3 has
+ * a negative determinant, to keep a proper rotation), then the scale-normalized
+ * basis is converted to a quaternion. The result is in the matrix's own frame; the
+ * caller converts to canonical with {@link toCanonicalPosition}/{@link toCanonicalQuat}.
+ */
+export declare function decomposeWorldMatrix(e: ArrayLike<number>): DecomposedTransform;
+//# sourceMappingURL=matrix.d.ts.map

package/dist/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../src/matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAoD9E"}

package/dist/matrix.js

@@ -0,0 +1,60 @@
+/**
+ * Decompose a **column-major** world matrix (the layout three.js `Matrix4.elements`,
+ * Babylon `Matrix.m`, and PlayCanvas `Mat4.data` all share) into position /
+ * rotation quaternion / scale, using the same algorithm as `Matrix4.decompose`:
+ * scale is the length of each basis column (negate `sx` when the upper-left 3×3 has
+ * a negative determinant, to keep a proper rotation), then the scale-normalized
+ * basis is converted to a quaternion. The result is in the matrix's own frame; the
+ * caller converts to canonical with {@link toCanonicalPosition}/{@link toCanonicalQuat}.
+ */
+export function decomposeWorldMatrix(e) {
+    const position = [e[12] ?? 0, e[13] ?? 0, e[14] ?? 0];
+    let sx = Math.hypot(e[0], e[1], e[2]);
+    const sy = Math.hypot(e[4], e[5], e[6]);
+    const sz = Math.hypot(e[8], e[9], e[10]);
+    const det = e[0] *
+        (e[5] * e[10] - e[6] * e[9]) -
+        e[4] *
+            (e[1] * e[10] - e[2] * e[9]) +
+        e[8] * (e[1] * e[6] - e[2] * e[5]);
+    if (det < 0)
+        sx = -sx;
+    const ix = sx !== 0 ? 1 / sx : 0;
+    const iy = sy !== 0 ? 1 / sy : 0;
+    const iz = sz !== 0 ? 1 / sz : 0;
+    const m11 = e[0] * ix, m21 = e[1] * ix, m31 = e[2] * ix;
+    const m12 = e[4] * iy, m22 = e[5] * iy, m32 = e[6] * iy;
+    const m13 = e[8] * iz, m23 = e[9] * iz, m33 = e[10] * iz;
+    const trace = m11 + m22 + m33;
+    let x, y, z, w;
+    if (trace > 0) {
+        const s = 0.5 / Math.sqrt(trace + 1);
+        w = 0.25 / s;
+        x = (m32 - m23) * s;
+        y = (m13 - m31) * s;
+        z = (m21 - m12) * s;
+    }
+    else if (m11 > m22 && m11 > m33) {
+        const s = 2 * Math.sqrt(1 + m11 - m22 - m33);
+        w = (m32 - m23) / s;
+        x = 0.25 * s;
+        y = (m12 + m21) / s;
+        z = (m13 + m31) / s;
+    }
+    else if (m22 > m33) {
+        const s = 2 * Math.sqrt(1 + m22 - m11 - m33);
+        w = (m13 - m31) / s;
+        x = (m12 + m21) / s;
+        y = 0.25 * s;
+        z = (m23 + m32) / s;
+    }
+    else {
+        const s = 2 * Math.sqrt(1 + m33 - m11 - m22);
+        w = (m21 - m12) / s;
+        x = (m13 + m31) / s;
+        y = (m23 + m32) / s;
+        z = 0.25 * s;
+    }
+    return { position, rotation: [x, y, z, w], scale: [sx, sy, sz] };
+}
+//# sourceMappingURL=matrix.js.map

package/dist/matrix.js.map

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