@ifc-lite/collab 0.2.0

package/dist/awareness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/awareness/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/awareness/overlay.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Renderer-agnostic presence overlay (spec §7).
+ *
+ * Drop this into any DOM-based viewer (`packages/viewer`, custom apps,
+ * embedded iframes) and it draws other peers' 2D cursors and
+ * selection-color labels onto a transparent overlay <canvas>. Pure
+ * 2D — apps that need 3D cursors layer them via Three.js / WebGPU on
+ * top of the same `peerVisuals` data.
+ *
+ * Wiring (browser):
+ *
+ *     const overlay = createPresenceOverlay({
+ *       container: document.getElementById('viewport'),
+ *       viewport: 'plan',
+ *     });
+ *     session.presence.onUpdate((peers) => overlay.update(peers));
+ *
+ *     // Then on dispose:
+ *     overlay.destroy();
+ */
+import type { PresenceMap, Vec3 } from './presence.js';
+import { type PeerVisualOptions } from './render.js';
+export interface PresenceOverlayOptions extends PeerVisualOptions {
+    /** Element to mount the overlay <canvas> over. Must be position:relative. */
+    container: HTMLElement;
+    /** Viewport name to filter cursor2d to. */
+    viewport: string;
+    /** Optional override for the cursor arrow size in CSS pixels. Default 14. */
+    cursorSize?: number;
+    /** Optional override for label font in CSS. Default '12px sans-serif'. */
+    font?: string;
+    /**
+     * Host-supplied world→screen projector. When provided, peers' `cursor3d`
+     * values (published by `mountPresenceInViewer` with `raycastToWorld`)
+     * are projected through THIS viewer's camera, so every peer sees
+     * cursors anchored to the same world point regardless of their own
+     * perspective.
+     *
+     * Returning `null` (point is behind the camera, off-screen, etc.)
+     * hides the peer's cursor that frame. `cursor2d` continues to be used
+     * as a fallback when a peer hasn't published a 3D cursor.
+     */
+    worldToScreen?: (worldPos: Vec3) => {
+        x: number;
+        y: number;
+    } | null;
+}
+export interface PresenceOverlay {
+    update(peers: PresenceMap): void;
+    /** Resize the canvas to match the container (call on container resize). */
+    resize(): void;
+    destroy(): void;
+}
+/**
+ * Mount a 2D presence overlay. Returns a controller that the app can
+ * call `update(peers)` on whenever presence changes.
+ */
+export declare function createPresenceOverlay(opts: PresenceOverlayOptions): PresenceOverlay;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/awareness/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/awareness/overlay.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAsD,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEzG,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,6EAA6E;IAC7E,SAAS,EAAE,WAAW,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,2EAA2E;IAC3E,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CAgEnF"}

package/dist/awareness/overlay.js

@@ -0,0 +1,110 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { peerVisuals, cursorScreenPosition } from './render.js';
+const DPR = () => (typeof globalThis !== 'undefined' && typeof window !== 'undefined'
+    ? window.devicePixelRatio || 1
+    : 1);
+/**
+ * Mount a 2D presence overlay. Returns a controller that the app can
+ * call `update(peers)` on whenever presence changes.
+ */
+export function createPresenceOverlay(opts) {
+    if (typeof document === 'undefined') {
+        throw new Error('@ifc-lite/collab: createPresenceOverlay requires a browser DOM');
+    }
+    const canvas = document.createElement('canvas');
+    canvas.style.position = 'absolute';
+    canvas.style.inset = '0';
+    canvas.style.pointerEvents = 'none';
+    canvas.style.zIndex = '10';
+    opts.container.appendChild(canvas);
+    const ctx = canvas.getContext('2d');
+    if (!ctx)
+        throw new Error('@ifc-lite/collab: 2D canvas unavailable');
+    const cursorSize = opts.cursorSize ?? 14;
+    const font = opts.font ?? '12px sans-serif';
+    // Cache the last drawn peers so resize can redraw without waiting for
+    // the next presence update — otherwise the overlay goes blank between
+    // resize and the next `update(peers)` call.
+    let lastPeers = null;
+    const draw = (peers) => {
+        ctx.clearRect(0, 0, canvas.width, canvas.height);
+        if (!peers)
+            return;
+        const visuals = peerVisuals(peers, opts);
+        for (const v of visuals) {
+            drawPeer(ctx, v, opts.viewport, cursorSize, font, opts.worldToScreen);
+        }
+    };
+    const resize = () => {
+        const r = opts.container.getBoundingClientRect();
+        const dpr = DPR();
+        canvas.width = Math.max(1, Math.floor(r.width * dpr));
+        canvas.height = Math.max(1, Math.floor(r.height * dpr));
+        canvas.style.width = `${r.width}px`;
+        canvas.style.height = `${r.height}px`;
+        ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+        draw(lastPeers);
+    };
+    resize();
+    const update = (peers) => {
+        lastPeers = peers;
+        draw(peers);
+    };
+    // Auto-resize via ResizeObserver if available.
+    let ro = null;
+    if (typeof ResizeObserver !== 'undefined') {
+        ro = new ResizeObserver(() => resize());
+        ro.observe(opts.container);
+    }
+    return {
+        update,
+        resize,
+        destroy() {
+            ro?.disconnect();
+            canvas.remove();
+        },
+    };
+}
+function drawPeer(ctx, v, viewport, cursorSize, font, worldToScreen) {
+    // Prefer the 3D cursor when both the peer published one AND this
+    // overlay was given a projector — that path is camera-aware and stays
+    // correct across different viewer perspectives. Fall back to cursor2d
+    // (same-viewport pixel coordinates) otherwise.
+    let pos = null;
+    if (v.cursor3d && worldToScreen) {
+        pos = worldToScreen(v.cursor3d);
+    }
+    if (!pos) {
+        pos = cursorScreenPosition(v, viewport);
+    }
+    if (!pos)
+        return;
+    ctx.globalAlpha = v.opacity;
+    ctx.fillStyle = v.color;
+    ctx.strokeStyle = '#ffffff';
+    ctx.lineWidth = 1;
+    // Cursor arrow.
+    ctx.beginPath();
+    ctx.moveTo(pos.x, pos.y);
+    ctx.lineTo(pos.x, pos.y + cursorSize);
+    ctx.lineTo(pos.x + cursorSize * 0.3, pos.y + cursorSize * 0.7);
+    ctx.lineTo(pos.x + cursorSize * 0.7, pos.y + cursorSize * 0.7);
+    ctx.closePath();
+    ctx.fill();
+    ctx.stroke();
+    // Label.
+    ctx.font = font;
+    const padX = 6;
+    const padY = 4;
+    const textW = ctx.measureText(v.label).width;
+    const labelX = pos.x + cursorSize + 4;
+    const labelY = pos.y + cursorSize - 6;
+    ctx.fillStyle = v.color;
+    ctx.fillRect(labelX, labelY, textW + padX * 2, 16 + padY);
+    ctx.fillStyle = '#ffffff';
+    ctx.fillText(v.label, labelX + padX, labelY + 14);
+    ctx.globalAlpha = 1;
+}
+//# sourceMappingURL=overlay.js.map

package/dist/awareness/overlay.js.map

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

package/dist/awareness/presence.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Presence: a typed wrapper over `y-protocols/awareness`.
+ *
+ * Spec §5.4 / §7. Awareness is last-write-wins-by-clock and never
+ * persisted. Updates are bursty — we cap them at 30 Hz with delta-only
+ * payloads.
+ */
+import { Awareness, applyAwarenessUpdate, encodeAwarenessUpdate } from 'y-protocols/awareness';
+import * as Y from 'yjs';
+export interface UserIdentity {
+    id: string;
+    name: string;
+    /** Optional. If omitted, a deterministic color is derived from `id`. */
+    color?: string;
+    avatar?: string;
+}
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface Vec2 {
+    x: number;
+    y: number;
+}
+export interface Vec4 {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+export interface CameraState {
+    position: Vec3;
+    target: Vec3;
+    fov: number;
+}
+export interface PresenceState {
+    user: UserIdentity;
+    cursor3d?: Vec3;
+    cursor2d?: {
+        viewport: string;
+        pos: Vec2;
+    };
+    selection: string[];
+    camera?: CameraState;
+    activeView?: string;
+    activeSection?: {
+        plane: Vec4;
+    };
+    isolated?: string[];
+    tool?: 'select' | 'measure' | 'comment' | 'edit' | 'create' | string;
+    status: 'active' | 'idle' | 'offline';
+    /** Wall-clock ms; used by stale-presence eviction. */
+    lastUpdate: number;
+    /** Optional model the cursor is currently in (for federated sessions). */
+    modelId?: string;
+}
+export interface PresenceMap {
+    /** clientID → state */
+    [clientId: number]: PresenceState;
+}
+export type PresenceUpdateListener = (peers: PresenceMap, self: PresenceState | null) => void;
+export interface PresenceOptions {
+    /** Awareness update rate cap in Hz (default 30). */
+    updateRateHz?: number;
+    /** Stale eviction window in ms (default 10_000). */
+    staleAfterMs?: number;
+}
+export interface Presence {
+    readonly awareness: Awareness;
+    readonly clientId: number;
+    setUser(user: UserIdentity): void;
+    setSelection(paths: string[]): void;
+    setCursor3d(pos: Vec3 | null): void;
+    setCursor2d(viewport: string, pos: Vec2 | null): void;
+    setCamera(camera: CameraState | null): void;
+    setActiveView(viewId: string | null): void;
+    setActiveSection(plane: Vec4 | null): void;
+    setIsolated(paths: string[] | null): void;
+    setTool(tool: PresenceState['tool'] | null): void;
+    setStatus(status: PresenceState['status']): void;
+    setModelId(modelId: string | null): void;
+    /** Patch arbitrary fields in one go. Use for camera+cursor on the same frame. */
+    patch(partial: Partial<PresenceState>): void;
+    getSelf(): PresenceState | null;
+    getPeers(): PresenceMap;
+    onUpdate(listener: PresenceUpdateListener): () => void;
+    /** Force a stale sweep; normally automatic. */
+    evictStale(): void;
+    dispose(): void;
+}
+/** Create a presence object bound to a Y.Doc. */
+export declare function createPresence(doc: Y.Doc, opts?: PresenceOptions): Presence;
+export { applyAwarenessUpdate, encodeAwarenessUpdate, Awareness };
+//# sourceMappingURL=presence.d.ts.map

package/dist/awareness/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/awareness/presence.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAqB,EAAyB,MAAM,uBAAuB,CAAC;AACtH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,CAAC;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrE,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACtD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IACjD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzC,iFAAiF;IACjF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7C,OAAO,IAAI,aAAa,GAAG,IAAI,CAAC;IAChC,QAAQ,IAAI,WAAW,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAAC;IACvD,+CAA+C;IAC/C,UAAU,IAAI,IAAI,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,GAAE,eAAoB,GAAG,QAAQ,CAqG/E;AAED,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,SAAS,EAAE,CAAC"}

package/dist/awareness/presence.js

@@ -0,0 +1,114 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Presence: a typed wrapper over `y-protocols/awareness`.
+ *
+ * Spec §5.4 / §7. Awareness is last-write-wins-by-clock and never
+ * persisted. Updates are bursty — we cap them at 30 Hz with delta-only
+ * payloads.
+ */
+import { Awareness, applyAwarenessUpdate, encodeAwarenessUpdate, removeAwarenessStates } from 'y-protocols/awareness';
+import { colorForUser } from './color.js';
+/** Create a presence object bound to a Y.Doc. */
+export function createPresence(doc, opts = {}) {
+    const awareness = new Awareness(doc);
+    const updateRateMs = 1000 / (opts.updateRateHz ?? 30);
+    const staleAfterMs = opts.staleAfterMs ?? 10_000;
+    let pendingPatch = null;
+    let flushHandle = null;
+    const listeners = new Set();
+    const flush = () => {
+        if (!pendingPatch)
+            return;
+        const current = awareness.getLocalState() ?? null;
+        const merged = {
+            ...(current ?? {
+                user: { id: 'anon', name: 'Anonymous', color: '#888888' },
+                selection: [],
+                status: 'active',
+                lastUpdate: Date.now(),
+            }),
+            ...pendingPatch,
+            lastUpdate: Date.now(),
+        };
+        awareness.setLocalState(merged);
+        pendingPatch = null;
+        flushHandle = null;
+    };
+    const enqueue = (patch) => {
+        pendingPatch = { ...(pendingPatch ?? {}), ...patch };
+        if (flushHandle == null) {
+            flushHandle = setTimeout(flush, updateRateMs);
+        }
+    };
+    const onAwareness = () => {
+        const peers = {};
+        awareness.getStates().forEach((value, clientId) => {
+            peers[clientId] = value;
+        });
+        const self = awareness.getLocalState() ?? null;
+        listeners.forEach((l) => l(peers, self));
+    };
+    awareness.on('change', onAwareness);
+    const evictTimer = setInterval(() => evictStale(), Math.max(staleAfterMs / 2, 2_000));
+    const evictStale = () => {
+        const now = Date.now();
+        const toRemove = [];
+        awareness.getStates().forEach((value, clientId) => {
+            const state = value;
+            if (clientId === awareness.clientID)
+                return;
+            if (state?.lastUpdate && now - state.lastUpdate > staleAfterMs) {
+                toRemove.push(clientId);
+            }
+        });
+        if (toRemove.length > 0) {
+            removeAwarenessStates(awareness, toRemove, 'stale-eviction');
+        }
+    };
+    return {
+        awareness,
+        clientId: doc.clientID,
+        setUser(user) {
+            const resolved = { ...user, color: user.color ?? colorForUser(user.id) };
+            enqueue({ user: resolved });
+        },
+        setSelection(paths) { enqueue({ selection: paths }); },
+        setCursor3d(pos) { enqueue({ cursor3d: pos ?? undefined }); },
+        setCursor2d(viewport, pos) {
+            enqueue({ cursor2d: pos ? { viewport, pos } : undefined });
+        },
+        setCamera(camera) { enqueue({ camera: camera ?? undefined }); },
+        setActiveView(viewId) { enqueue({ activeView: viewId ?? undefined }); },
+        setActiveSection(plane) { enqueue({ activeSection: plane ? { plane } : undefined }); },
+        setIsolated(paths) { enqueue({ isolated: paths ?? undefined }); },
+        setTool(tool) { enqueue({ tool: tool ?? undefined }); },
+        setStatus(status) { enqueue({ status }); },
+        setModelId(modelId) { enqueue({ modelId: modelId ?? undefined }); },
+        patch(partial) { enqueue(partial); },
+        getSelf() { return awareness.getLocalState() ?? null; },
+        getPeers() {
+            const peers = {};
+            awareness.getStates().forEach((value, clientId) => {
+                peers[clientId] = value;
+            });
+            return peers;
+        },
+        onUpdate(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        evictStale,
+        dispose() {
+            clearInterval(evictTimer);
+            if (flushHandle)
+                clearTimeout(flushHandle);
+            awareness.off('change', onAwareness);
+            awareness.destroy();
+            listeners.clear();
+        },
+    };
+}
+export { applyAwarenessUpdate, encodeAwarenessUpdate, Awareness };
+//# sourceMappingURL=presence.js.map

package/dist/awareness/presence.js.map

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

package/dist/awareness/render.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Presence-renderer math helpers (spec §7).
+ *
+ * The actual viewer rendering lives in `packages/viewer` (Three.js,
+ * WebGPU, …) — but the math that decides "where does this peer's
+ * cursor draw, what color, what label, is it stale" is the same
+ * regardless of the rendering engine. Pulling it out here keeps the
+ * viewer thin and gives every rendering target the same look.
+ *
+ * Apps consume:
+ *   - `peerVisuals(peers, opts)` → list of `{ clientId, color,
+ *     label, opacity, cursor3d, cursor2d, selection, isStale }`.
+ *   - `cursorScreenPosition(peer, viewport)` → `{ x, y } | null` for
+ *     2D cursor projection (3D peers project externally).
+ */
+import type { PresenceMap, PresenceState } from './presence.js';
+export interface PeerVisual {
+    clientId: number;
+    user: PresenceState['user'];
+    /** Resolved hex color — palette pick if user.color was absent. */
+    color: string;
+    /** "Anna (agent)", "Mark — measuring", "Louis"… */
+    label: string;
+    /** 0..1; 1 for fresh, fades to ~0.4 as the peer goes idle / stale. */
+    opacity: number;
+    /** True when no update has arrived for `staleAfterMs`. */
+    isStale: boolean;
+    cursor3d?: PresenceState['cursor3d'];
+    cursor2d?: PresenceState['cursor2d'];
+    selection: string[];
+    modelId?: string;
+}
+export interface PeerVisualOptions {
+    /** Drop the local peer from the result. Default true. */
+    excludeClientId?: number;
+    /** Wall-clock ms after which a peer is considered stale. Default 10_000. */
+    staleAfterMs?: number;
+    /** Override the random color palette. */
+    palette?: readonly string[];
+    /** Override the agent palette. */
+    agentPalette?: readonly string[];
+    /** Override `Date.now`. */
+    now?: () => number;
+}
+/**
+ * Convert a `PresenceMap` into render-ready visuals. Pure function —
+ * the renderer just iterates the result and draws.
+ */
+export declare function peerVisuals(peers: PresenceMap, opts?: PeerVisualOptions): PeerVisual[];
+/**
+ * Project a peer's `cursor2d` into a viewport. Returns null when the
+ * peer is in a different viewport or has no 2D cursor reported.
+ */
+export declare function cursorScreenPosition(peer: PeerVisual, viewportName: string): {
+    x: number;
+    y: number;
+} | null;
+//# sourceMappingURL=render.d.ts.map

package/dist/awareness/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/awareness/render.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAIhE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,kCAAkC;IAClC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,iBAAsB,GAAG,UAAU,EAAE,CAsC1F;AAQD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIjC"}

package/dist/awareness/render.js

@@ -0,0 +1,66 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { colorForUser, DEFAULT_USER_PALETTE } from './color.js';
+import { AGENT_PALETTE } from './agent.js';
+/**
+ * Convert a `PresenceMap` into render-ready visuals. Pure function —
+ * the renderer just iterates the result and draws.
+ */
+export function peerVisuals(peers, opts = {}) {
+    const exclude = opts.excludeClientId;
+    const staleAfterMs = opts.staleAfterMs ?? 10_000;
+    const now = opts.now ? opts.now() : Date.now();
+    const palette = opts.palette ?? DEFAULT_USER_PALETTE;
+    const agentPalette = opts.agentPalette ?? AGENT_PALETTE;
+    const out = [];
+    for (const [idStr, state] of Object.entries(peers)) {
+        const clientId = Number(idStr);
+        if (clientId === exclude)
+            continue;
+        if (!state || !state.user)
+            continue;
+        const isAgent = typeof state.user.name === 'string' && state.user.name.endsWith('(agent)');
+        const color = state.user.color ?? colorForUser(state.user.id, isAgent ? agentPalette : palette);
+        const idleMs = state.lastUpdate ? now - state.lastUpdate : 0;
+        const isStale = idleMs >= staleAfterMs;
+        const fadeStart = staleAfterMs / 2;
+        const opacity = isStale
+            ? 0.4
+            : idleMs <= fadeStart
+                ? 1
+                : 1 - (0.6 * (idleMs - fadeStart)) / fadeStart;
+        const label = renderLabel(state);
+        out.push({
+            clientId,
+            user: state.user,
+            color,
+            label,
+            opacity: Math.max(0.4, Math.min(1, opacity)),
+            isStale,
+            cursor3d: state.cursor3d,
+            cursor2d: state.cursor2d,
+            selection: state.selection ?? [],
+            modelId: state.modelId,
+        });
+    }
+    return out.sort((a, b) => a.clientId - b.clientId);
+}
+function renderLabel(state) {
+    const base = state.user.name;
+    if (state.tool && state.tool !== 'select')
+        return `${base} — ${state.tool}`;
+    return base;
+}
+/**
+ * Project a peer's `cursor2d` into a viewport. Returns null when the
+ * peer is in a different viewport or has no 2D cursor reported.
+ */
+export function cursorScreenPosition(peer, viewportName) {
+    if (!peer.cursor2d)
+        return null;
+    if (peer.cursor2d.viewport !== viewportName)
+        return null;
+    return { x: peer.cursor2d.pos.x, y: peer.cursor2d.pos.y };
+}
+//# sourceMappingURL=render.js.map

package/dist/awareness/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/awareness/render.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAmB/D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgC3C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,OAA0B,EAAE;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,oBAAoB,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC;IAExD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,OAAO;YAAE,SAAS;QACnC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,SAAS;QACpC,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,IAAI,YAAY,CAAC;QACvC,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,MAAM,IAAI,SAAS;gBACnB,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;QACnD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC;YACP,QAAQ;YACR,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK;YACL,KAAK;YACL,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7B,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,IAAI,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAgB,EAChB,YAAoB;IAEpB,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/dist/branch/branch-tree.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Branch-tree visualization data (spec §16.2 / §19 v0.7).
+ *
+ * Pure data helper that turns a `HistorySidecar` into a (nodes, edges)
+ * tree the UI layer can render. We deliberately produce nothing
+ * pixel-related — apps choose between a force-directed layout, a git
+ * log columnar layout, or a simple list. The tree is just the
+ * branching structure.
+ */
+import type { BranchInfo, HistorySidecar } from './history.js';
+export interface BranchTreeNode {
+    /** Entry id (or branch-anchor `'branch:<name>'` for the empty branch root). */
+    id: string;
+    kind: 'entry' | 'branch-anchor' | 'merge';
+    branch: string;
+    at: string;
+    label?: string;
+    /** Parent node id (predecessor on the same branch, or anchor). */
+    parentId?: string;
+    /** For merge nodes, the second parent (the branch being merged in). */
+    mergedFromBranch?: string;
+}
+export interface BranchTreeEdge {
+    from: string;
+    to: string;
+    kind: 'history' | 'fork' | 'merge';
+}
+export interface BranchTree {
+    nodes: BranchTreeNode[];
+    edges: BranchTreeEdge[];
+    branches: BranchInfo[];
+}
+/**
+ * Build a branch-tree view from a sidecar. Single pass: collect
+ * branches + entries, link entries to their predecessor on the same
+ * branch, and emit fork edges from the parent branch's
+ * `forkedFromEntryId` to the new branch's first entry (or anchor).
+ */
+export declare function buildBranchTree(sidecar: HistorySidecar): Promise<BranchTree>;
+//# sourceMappingURL=branch-tree.d.ts.map

package/dist/branch/branch-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-tree.d.ts","sourceRoot":"","sources":["../../src/branch/branch-tree.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,cAAc,EAAE,MAAM,cAAc,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,OAAO,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA4DlF"}

package/dist/branch/branch-tree.js

@@ -0,0 +1,66 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Build a branch-tree view from a sidecar. Single pass: collect
+ * branches + entries, link entries to their predecessor on the same
+ * branch, and emit fork edges from the parent branch's
+ * `forkedFromEntryId` to the new branch's first entry (or anchor).
+ */
+export async function buildBranchTree(sidecar) {
+    const branches = await sidecar.branches();
+    const all = await sidecar.entries();
+    const byBranch = new Map();
+    for (const e of all) {
+        const arr = byBranch.get(e.branch) ?? [];
+        arr.push(e);
+        byBranch.set(e.branch, arr);
+    }
+    for (const arr of byBranch.values())
+        arr.sort((a, b) => a.at.localeCompare(b.at));
+    const nodes = [];
+    const edges = [];
+    for (const branch of branches) {
+        const entries = byBranch.get(branch.name) ?? [];
+        const anchorId = `branch:${branch.name}`;
+        nodes.push({
+            id: anchorId,
+            kind: 'branch-anchor',
+            branch: branch.name,
+            at: branch.createdAt,
+        });
+        // Fork edge from the parent entry to the anchor.
+        if (branch.forkedFromEntryId) {
+            edges.push({ from: branch.forkedFromEntryId, to: anchorId, kind: 'fork' });
+        }
+        let prevId = anchorId;
+        for (const e of entries) {
+            // Trust the structural metadata set by `merge()`, not the label.
+            // A user can authorin a regular commit with `label: "merge bar"`
+            // and we don't want that to render as a merge node.
+            const isMerge = typeof e.mergedFromBranch === 'string';
+            const node = {
+                id: e.entryId,
+                kind: isMerge ? 'merge' : 'entry',
+                branch: e.branch,
+                at: e.at,
+                label: e.label,
+                parentId: prevId,
+            };
+            if (isMerge) {
+                node.mergedFromBranch = e.mergedFromBranch;
+            }
+            nodes.push(node);
+            edges.push({ from: prevId, to: e.entryId, kind: 'history' });
+            // Use the immutable `mergedFromEntryId` captured at merge time —
+            // pointing at the source branch's CURRENT tip would drift the
+            // merge edge whenever that branch advances later.
+            if (isMerge && e.mergedFromEntryId) {
+                edges.push({ from: e.mergedFromEntryId, to: e.entryId, kind: 'merge' });
+            }
+            prevId = e.entryId;
+        }
+    }
+    return { nodes, edges, branches };
+}
+//# sourceMappingURL=branch-tree.js.map