@uptimizr/sdk-core 0.1.0

package/dist/client.js

@@ -0,0 +1,451 @@
+import { SCHEMA_VERSION, DEFAULT_SCENE_ID, sceneIdSchema } from "@uptimizr/schema";
+import { EventQueue } from "./queue.js";
+import { randomId } from "./idgen.js";
+import { createBeaconTransport } from "./transport.js";
+import { createMainProcessor, createWorkerProcessor, } from "./processor.js";
+import { SDK_VERSION } from "./version.js";
+const DEFAULTS = {
+    batchSize: 20,
+    flushIntervalMs: 5000,
+    maxQueueSize: 1000,
+    resizeDebounceMs: 250,
+};
+function resolveConfig(config) {
+    return {
+        projectId: config.projectId,
+        endpoint: config.endpoint,
+        sdkVersion: config.sdkVersion ?? SDK_VERSION,
+        batchSize: config.batchSize ?? DEFAULTS.batchSize,
+        flushIntervalMs: config.flushIntervalMs ?? DEFAULTS.flushIntervalMs,
+        maxQueueSize: config.maxQueueSize ?? DEFAULTS.maxQueueSize,
+        offload: config.offload ?? "main",
+        disabled: config.disabled ?? false,
+        captureLifecycle: config.captureLifecycle ?? true,
+        resizeDebounceMs: config.resizeDebounceMs ?? DEFAULTS.resizeDebounceMs,
+        captureErrors: config.captureErrors ?? false,
+        debug: config.debug ?? false,
+    };
+}
+/**
+ * The core Uptimizr client. Framework-agnostic: it owns the session, the event
+ * queue, batching/flush scheduling, and transport. Engine-specific capture is added
+ * via `use(collector)` (e.g. the Babylon adapter), keeping this package free of any
+ * 3D-engine dependency.
+ *
+ * Privacy: no cookies, no persistent client ID. The `sessionId` is in-memory only
+ * and the server assigns the cookieless `visitorId` during ingestion (ADR 0003).
+ */
+export class UptimizrClient {
+    config;
+    sessionId;
+    queue;
+    transport;
+    processor;
+    beforeSend;
+    collectors = [];
+    handles = [];
+    started = false;
+    startedAt = 0;
+    url;
+    currentScene = DEFAULT_SCENE_ID;
+    pageMeta;
+    flushTimer;
+    resizeTimer;
+    errorCount = 0;
+    lastErrorKey;
+    boundVisibility = () => this.onVisibilityChange();
+    boundPageHide = () => {
+        void this.stop("hidden");
+    };
+    boundFocus = () => this.onFocusChange(true);
+    boundBlur = () => this.onFocusChange(false);
+    boundResize = () => this.onResize();
+    boundError = (event) => this.onErrorEvent(event);
+    boundRejection = (event) => this.onUnhandledRejection(event);
+    constructor(config) {
+        this.config = resolveConfig(config);
+        this.sessionId = randomId();
+        this.queue = new EventQueue(this.config.maxQueueSize);
+        this.transport = config.transport ?? createBeaconTransport(this.config.endpoint);
+        this.processor = this.createProcessor(config);
+        this.beforeSend = config.beforeSend;
+    }
+    /** Register a capture plugin. Call before `start` (or after; it starts immediately). */
+    use(collector) {
+        this.collectors.push(collector);
+        if (this.started) {
+            this.startCollector(collector);
+        }
+        return this;
+    }
+    /** Begin the session: emit `session_start`, schedule flushing, and start collectors. */
+    start(meta = {}) {
+        if (this.started || this.config.disabled) {
+            return;
+        }
+        this.started = true;
+        this.startedAt = this.now();
+        this.url = meta.url ?? this.defaultUrl();
+        this.pageMeta = meta.pageMeta;
+        // Apply the initial scene (if any) before session_start so it is stamped.
+        if (meta.sceneId != null) {
+            const parsed = sceneIdSchema.safeParse(meta.sceneId);
+            if (parsed.success) {
+                this.currentScene = parsed.data;
+            }
+            else {
+                this.log(`ignoring invalid initial sceneId: ${String(meta.sceneId)}`);
+            }
+        }
+        this.emit({
+            type: "session_start",
+            ...(meta.device ? { device: meta.device } : {}),
+            ...(meta.graphics ? { graphics: meta.graphics } : {}),
+            ...(meta.scene ? { scene: meta.scene } : {}),
+            ...(meta.connector ? { connector: meta.connector } : {}),
+            ...(meta.user ? { user: meta.user } : {}),
+        });
+        if (this.config.flushIntervalMs > 0) {
+            this.flushTimer = setInterval(() => void this.flush(), this.config.flushIntervalMs);
+        }
+        this.bindLifecycle();
+        for (const collector of this.collectors) {
+            this.startCollector(collector);
+        }
+    }
+    /**
+     * Switch the active scene/area (ADR 0010). Stamps the new `sceneId` on every
+     * subsequent event and emits an ordered `scene_change` marker so the replay
+     * timeline records the transition. Invalid ids are ignored (logged in debug).
+     * No-ops if the scene is unchanged. May be called before `start`, in which case
+     * the scene is applied to `session_start`.
+     */
+    setScene(sceneId) {
+        if (this.config.disabled) {
+            return;
+        }
+        const parsed = sceneIdSchema.safeParse(sceneId);
+        if (!parsed.success) {
+            this.log(`ignoring invalid sceneId: ${String(sceneId)}`);
+            return;
+        }
+        if (parsed.data === this.currentScene) {
+            return;
+        }
+        this.currentScene = parsed.data;
+        if (this.started) {
+            this.emit({ type: "scene_change" });
+        }
+    }
+    /** Build the envelope and queue an event. */
+    emit(input) {
+        if (!this.started || this.config.disabled) {
+            return;
+        }
+        const event = {
+            ...input,
+            projectId: this.config.projectId,
+            sessionId: this.sessionId,
+            ts: this.now(),
+            sdkVersion: this.config.sdkVersion,
+            ...(this.url ? { url: this.url } : {}),
+            ...(this.currentScene !== DEFAULT_SCENE_ID ? { sceneId: this.currentScene } : {}),
+            ...(this.pageMeta ? { pageMeta: this.pageMeta } : {}),
+        };
+        const finalEvent = this.beforeSend ? this.beforeSend(event) : event;
+        if (!finalEvent) {
+            return;
+        }
+        this.queue.enqueue(finalEvent);
+        if (this.queue.size >= this.config.batchSize) {
+            void this.flush();
+        }
+    }
+    /** Emit a developer-defined `custom` event. */
+    track(name, props) {
+        this.emit({ type: "custom", name, ...(props ? { props } : {}) });
+    }
+    /**
+     * Emit an `input_action` for a discrete, non-pointer input — a keyboard
+     * key/chord or a gamepad button bound to an app action (ADR 0023). This is the
+     * engine-neutral path: the host app reports the *semantic* action it mapped the
+     * input to. Pointer/ray inputs flow through the connector's `pointer_*` /
+     * `mesh_interaction` capture instead; continuous navigation stays in
+     * `camera_sample`.
+     *
+     * Privacy (ADR 0003): pass app-defined action labels only — never raw typed
+     * text. `source` defaults to `"keyboard"` since that is the most common caller.
+     */
+    trackInput(action, opts = {}) {
+        if (!action) {
+            return;
+        }
+        this.emit({
+            type: "input_action",
+            action,
+            source: opts.source ?? "keyboard",
+            ...(opts.code ? { code: opts.code } : {}),
+            ...(typeof opts.button === "number" ? { button: opts.button } : {}),
+            ...(typeof opts.pressed === "boolean" ? { pressed: opts.pressed } : {}),
+            ...(opts.handedness ? { handedness: opts.handedness } : {}),
+            ...(opts.sourceId ? { sourceId: opts.sourceId } : {}),
+        });
+    }
+    /**
+     * Report a capability / fidelity transition — a fallback or recovery (#49,
+     * design §E). Engines decide their backend at init and rarely expose a runtime
+     * "I downgraded" hook, so this is the engine-neutral, **app-reported** path: the
+     * host app describes the transition it performed (e.g. a WebGPU→WebGL2
+     * downgrade, a quality/LOD auto-downgrade, or a re-init after a lost device).
+     * This pairs with the raw `context_lost` / `context_restored` lifecycle events.
+     *
+     * Privacy (ADR 0003): pass low-cardinality, app-defined tokens only — never raw
+     * device strings or PII.
+     */
+    reportCapabilityChange(change) {
+        if (!change.kind) {
+            return;
+        }
+        this.emit({
+            type: "capability_change",
+            kind: change.kind,
+            ...(change.from ? { from: change.from } : {}),
+            ...(change.to ? { to: change.to } : {}),
+            ...(change.reason ? { reason: change.reason } : {}),
+        });
+    }
+    /** Send all queued events. On failure, events are re-queued for the next attempt. */
+    async flush(opts) {
+        const events = this.queue.drain();
+        if (events.length === 0) {
+            return;
+        }
+        const batch = { schemaVersion: SCHEMA_VERSION, events };
+        // Steady-state batches may be offloaded to a worker; the terminal unload
+        // flush always runs on the main thread for delivery reliability (ADR 0031).
+        const ok = await (opts?.unload
+            ? this.processor.processUnload(batch)
+            : this.processor.process(batch));
+        if (!ok) {
+            this.queue.prepend(events);
+            this.log("flush failed; re-queued", events.length);
+        }
+    }
+    /** End the session: emit `session_end`, flush, and tear down collectors/timers. */
+    async stop(reason = "manual") {
+        if (!this.started) {
+            return;
+        }
+        this.emit({
+            type: "session_end",
+            durationMs: this.now() - this.startedAt,
+            reason,
+        });
+        this.started = false;
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+        this.unbindLifecycle();
+        for (const handle of this.handles.splice(0)) {
+            handle.stop();
+        }
+        // Terminal flush on the main thread (beacon-reliable), then release the
+        // worker if one was running (ADR 0031).
+        await this.flush({ unload: true });
+        this.processor.dispose();
+    }
+    /** Current time in epoch ms. Isolated for test overrides. */
+    now() {
+        return Date.now();
+    }
+    /**
+     * Choose the processor (ADR 0031). Defaults to the main-thread processor.
+     * `offload: "worker"` opts into a worker for steady-state serialization +
+     * dispatch, but only when no custom transport is set (a custom transport is a
+     * main-thread closure the worker cannot run) and a worker can actually be
+     * constructed; otherwise it transparently falls back to the main thread.
+     */
+    createProcessor(config) {
+        if (this.config.offload === "worker") {
+            if (config.transport) {
+                this.log("custom transport set; worker offload disabled (transport runs on main thread)");
+            }
+            else {
+                const worker = createWorkerProcessor({
+                    endpoint: this.config.endpoint,
+                    unloadTransport: this.transport,
+                    ...(config.createWorker
+                        ? { workerFactory: config.createWorker }
+                        : {}),
+                });
+                if (worker) {
+                    return worker;
+                }
+                this.log("worker offload unavailable; falling back to main-thread processor");
+            }
+        }
+        return createMainProcessor(this.transport);
+    }
+    startCollector(collector) {
+        const ctx = {
+            config: this.config,
+            sessionId: this.sessionId,
+            emit: (event) => this.emit(event),
+            track: (name, props) => this.track(name, props),
+            trackInput: (action, opts) => this.trackInput(action, opts),
+            reportCapabilityChange: (change) => this.reportCapabilityChange(change),
+            setScene: (sceneId) => this.setScene(sceneId),
+            now: () => this.now(),
+        };
+        try {
+            const handle = collector.start(ctx);
+            if (handle) {
+                this.handles.push(handle);
+            }
+        }
+        catch (err) {
+            this.log(`collector "${collector.name}" failed to start`, err);
+        }
+    }
+    onVisibilityChange() {
+        const doc = globalThis.document;
+        const hidden = doc?.visibilityState === "hidden";
+        if (this.config.captureLifecycle && doc) {
+            this.emit({ type: "visibility_change", state: hidden ? "hidden" : "visible" });
+        }
+        if (hidden) {
+            void this.flush({ unload: true });
+        }
+    }
+    onFocusChange(focused) {
+        if (this.config.captureLifecycle) {
+            this.emit({ type: "focus_change", focused });
+        }
+    }
+    onResize() {
+        if (!this.config.captureLifecycle) {
+            return;
+        }
+        if (this.resizeTimer) {
+            clearTimeout(this.resizeTimer);
+        }
+        this.resizeTimer = setTimeout(() => {
+            this.resizeTimer = undefined;
+            this.emitViewportResize();
+        }, this.config.resizeDebounceMs);
+    }
+    /** Emit a `viewport_resize` from the current window dimensions, if available. */
+    emitViewportResize() {
+        const g = globalThis;
+        if (typeof g.innerWidth !== "number" || typeof g.innerHeight !== "number") {
+            return;
+        }
+        if (g.innerWidth <= 0 || g.innerHeight <= 0) {
+            return;
+        }
+        this.emit({
+            type: "viewport_resize",
+            width: g.innerWidth,
+            height: g.innerHeight,
+            ...(typeof g.devicePixelRatio === "number" ? { dpr: g.devicePixelRatio } : {}),
+        });
+    }
+    /** Max `runtime_error` events emitted per session (ADR 0013 storm control). */
+    static MAX_ERRORS_PER_SESSION = 50;
+    onErrorEvent(event) {
+        this.emitError({
+            kind: "error",
+            message: event.message || "Unknown error",
+            ...(event.filename ? { source: event.filename } : {}),
+            ...(typeof event.lineno === "number" ? { lineno: event.lineno } : {}),
+            ...(typeof event.colno === "number" ? { colno: event.colno } : {}),
+            ...(event.error instanceof Error && event.error.stack ? { stack: event.error.stack } : {}),
+        });
+    }
+    onUnhandledRejection(event) {
+        const reason = event.reason;
+        const message = reason instanceof Error
+            ? reason.message
+            : typeof reason === "string"
+                ? reason
+                : "Unhandled promise rejection";
+        this.emitError({
+            kind: "unhandledrejection",
+            message: message || "Unhandled promise rejection",
+            ...(reason instanceof Error && reason.stack ? { stack: reason.stack } : {}),
+        });
+    }
+    /**
+     * Emit a `runtime_error`, applying ADR 0013 storm control: drop a consecutive
+     * duplicate (same message+stack) and cap the total per session. Free-text
+     * fields are length-bounded to match the schema; deeper redaction is the
+     * deployer's job via `beforeSend`.
+     */
+    emitError(input) {
+        if (this.errorCount >= UptimizrClient.MAX_ERRORS_PER_SESSION)
+            return;
+        const key = `${input.message}\u0000${input.stack ?? ""}`;
+        if (key === this.lastErrorKey)
+            return;
+        this.lastErrorKey = key;
+        this.errorCount += 1;
+        this.emit({
+            type: "runtime_error",
+            kind: input.kind,
+            message: input.message.slice(0, 1024),
+            ...(input.source ? { source: input.source.slice(0, 1024) } : {}),
+            ...(typeof input.lineno === "number" ? { lineno: input.lineno } : {}),
+            ...(typeof input.colno === "number" ? { colno: input.colno } : {}),
+            ...(input.stack ? { stack: input.stack.slice(0, 4096) } : {}),
+        });
+    }
+    bindLifecycle() {
+        const doc = globalThis.document;
+        const win = globalThis.addEventListener
+            ? globalThis
+            : undefined;
+        doc?.addEventListener("visibilitychange", this.boundVisibility);
+        win?.addEventListener("pagehide", this.boundPageHide);
+        if (this.config.captureLifecycle && win) {
+            win.addEventListener("focus", this.boundFocus);
+            win.addEventListener("blur", this.boundBlur);
+            win.addEventListener("resize", this.boundResize);
+            // Emit an initial viewport sample so every session has a known starting
+            // viewport for heatmap normalization.
+            this.emitViewportResize();
+        }
+        if (this.config.captureErrors && win) {
+            win.addEventListener("error", this.boundError);
+            win.addEventListener("unhandledrejection", this.boundRejection);
+        }
+    }
+    unbindLifecycle() {
+        const doc = globalThis.document;
+        const win = globalThis
+            .removeEventListener
+            ? globalThis
+            : undefined;
+        doc?.removeEventListener("visibilitychange", this.boundVisibility);
+        win?.removeEventListener("pagehide", this.boundPageHide);
+        win?.removeEventListener("focus", this.boundFocus);
+        win?.removeEventListener("blur", this.boundBlur);
+        win?.removeEventListener("resize", this.boundResize);
+        win?.removeEventListener("error", this.boundError);
+        win?.removeEventListener("unhandledrejection", this.boundRejection);
+        if (this.resizeTimer) {
+            clearTimeout(this.resizeTimer);
+            this.resizeTimer = undefined;
+        }
+    }
+    defaultUrl() {
+        const loc = globalThis.location;
+        return loc?.href;
+    }
+    log(...args) {
+        if (this.config.debug) {
+            console.debug("[uptimizr]", ...args);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/coordinates.d.ts

@@ -0,0 +1,98 @@
+import type { Aabb, CoordinateHandedness, Quat, Vec3 } from "@uptimizr/schema";
+/**
+ * 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 declare const CANONICAL_FRAME: {
+    readonly handedness: "left";
+    readonly upAxis: "y";
+    readonly unitScale: 1;
+};
+/**
+ * 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 declare function toCanonicalPosition(p: Vec3, sourceHandedness: CoordinateHandedness): Vec3;
+/**
+ * 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 declare function toCanonicalDirection(d: Vec3, sourceHandedness: CoordinateHandedness): Vec3;
+/**
+ * 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 declare function toCanonicalAabb(aabb: Aabb, sourceHandedness: CoordinateHandedness): Aabb;
+/**
+ * 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 declare function fromCanonicalPosition(p: Vec3, targetHandedness: CoordinateHandedness): Vec3;
+/**
+ * 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 declare function fromCanonicalDirection(d: Vec3, targetHandedness: CoordinateHandedness): Vec3;
+/**
+ * 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 declare function fromCanonicalAabb(aabb: Aabb, targetHandedness: CoordinateHandedness): Aabb;
+/**
+ * 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 declare function toCanonicalQuat(q: Quat, sourceHandedness: CoordinateHandedness): Quat;
+/**
+ * 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 declare function fromCanonicalQuat(q: Quat, targetHandedness: CoordinateHandedness): Quat;
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../src/coordinates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAOX;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAGzF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAG1F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAMxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAE3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAE1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAEvF"}