@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/pixoo/pixoo-bridge.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Pixoo64 Bridge — event listener + HTTP realtime 2FPS streamer.
+ *
+ * Real-time continuous streaming approach:
+ *   - The device cannot handle real-time HTTP single-frame pushes faster than ~4 FPS.
+ *   - Multi-frame loops trigger an unavoidable hardware loading screen.
+ *   - Solution: Constantly push `PicNum: 1` with a **static PicId** every 333ms (3 FPS).
+ *   - The device will smoothly overwrite its buffer without stalling.
+ */
+import type { BridgeEvent } from '../types.js';
+export interface PixooDevice {
+    ip: string;
+    name?: string;
+    brightness?: number;
+}
+/** Set broadcast function for pushing Pixoo status events to WS clients. */
+export declare function setPixooBroadcast(fn: (event: BridgeEvent) => void): void;
+export declare function startPixooBridge(pixooDevices?: PixooDevice[]): void;
+export declare function broadcastPixoo(event: BridgeEvent): void;
+export declare function stopPixooBridge(): Promise<void>;
+/** Register a listener called whenever a new frame is rendered. */
+export declare function onFrameRendered(listener: (frame: Uint8Array) => void): void;
+/** Remove a frame listener. */
+export declare function offFrameRendered(listener: (frame: Uint8Array) => void): void;
+/**
+ * Set the live preview frame rate (1–10 FPS).
+ * Takes effect immediately by restarting the preview timer.
+ */
+export declare function setPreviewFps(fps: number): void;
+/** Get current preview FPS setting. */
+export declare function getPreviewFps(): number;
+export declare function pixooDeviceCount(): number;
+export declare function getPixooDeviceDetails(): Array<{
+    ip: string;
+    name: string;
+    backedOff: boolean;
+    failures: number;
+    nextProbeMs: number;
+    lastPushAgo: number;
+}>;
+/**
+ * Render a fresh frame using current cached state.
+ * Used by the live preview endpoint when no Pixoo device is connected.
+ */
+export declare function renderPreviewFrame(): Uint8Array;
+/**
+ * Get the last calculated frame.
+ */
+export declare function getLastFrame(): Uint8Array | null;
+//# sourceMappingURL=pixoo-bridge.d.ts.map

package/dist/pixoo/pixoo-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-bridge.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AAW7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiCD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAExE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAwCnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAwDvD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BrD;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG3E;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAG5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO/C;AAED,uCAAuC;AACvC,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAAC;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAYD;AAsCD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,GAAG,IAAI,CAEhD"}

package/dist/pixoo/pixoo-bridge.js

@@ -0,0 +1,280 @@
+/**
+ * Pixoo64 Bridge — event listener + HTTP realtime 2FPS streamer.
+ *
+ * Real-time continuous streaming approach:
+ *   - The device cannot handle real-time HTTP single-frame pushes faster than ~4 FPS.
+ *   - Multi-frame loops trigger an unavoidable hardware loading screen.
+ *   - Solution: Constantly push `PicNum: 1` with a **static PicId** every 333ms (3 FPS).
+ *   - The device will smoothly overwrite its buffer without stalling.
+ */
+import { DISPLAY_FORWARDED_EVENTS } from '@agentdeck/shared/protocol';
+import { pushFrame, setBrightness, clearText, getDeviceBackoffStatus, switchToCustomChannel, onDeviceStatusChange, stopProbeTimer } from './pixoo-client.js';
+import { renderFrame, renderDisconnectedFrame } from './pixoo-renderer.js';
+import { debug } from '../logger.js';
+const TAG = 'Pixoo';
+// ===== Internal State =====
+let devices = [];
+let streamTimer = null;
+let lastPushTime = 0;
+let pushing = false; // guard against overlapping pushes
+// Cached latest events
+let lastStateEvent = null;
+let lastUsageEvent = null;
+let lastSessions = null;
+// Display sleep state — when Mac display is off, dim Pixoo and pause stream
+let displayDimmed = false;
+// Frame listeners for SSE streaming
+let frameListeners = [];
+let previewTimer = null;
+let previewFps = 10; // Adjustable 1–10 FPS for /pixoo live preview
+const HTTP_STREAM_INTERVAL_MS = 250; // 4 FPS hardware push (near hardware limit of Pixoo64)
+const CHANNEL_REASSERT_MS = 30_000; // Re-assert custom channel every 30s (fast recovery after reboots)
+const DEFAULT_BRIGHTNESS = 100;
+const FORWARDED_EVENTS = DISPLAY_FORWARDED_EVENTS;
+// Broadcast function injected by module for sending status notifications
+let broadcastFn = null;
+// ===== Public API =====
+/** Set broadcast function for pushing Pixoo status events to WS clients. */
+export function setPixooBroadcast(fn) {
+    broadcastFn = fn;
+}
+export function startPixooBridge(pixooDevices) {
+    if (!pixooDevices || pixooDevices.length === 0) {
+        debug(TAG, 'No Pixoo devices configured, skipping');
+        return;
+    }
+    devices = pixooDevices;
+    debug(TAG, `Starting with ${devices.length} device(s): ${devices.map(d => d.name || d.ip).join(', ')}`);
+    // Switch to custom channel + set brightness (fire-and-forget, one-time only)
+    // Do NOT repeat this call — it resets the HTTP GIF buffer, clearing the display.
+    for (const dev of devices) {
+        switchToCustomChannel(dev.ip).catch(() => { });
+        setBrightness(dev.ip, dev.brightness ?? DEFAULT_BRIGHTNESS).catch(() => { });
+    }
+    // Wire device status change → WS notification
+    onDeviceStatusChange((ip, online) => {
+        const dev = devices.find(d => d.ip === ip);
+        const name = dev?.name || 'Pixoo64';
+        if (broadcastFn) {
+            broadcastFn({
+                type: 'device_status',
+                device: 'pixoo',
+                name,
+                ip,
+                online,
+                message: online
+                    ? `${name} reconnected`
+                    : `${name} offline — power cycle may be needed`,
+            });
+        }
+        debug(TAG, online ? `${name} (${ip}) back online` : `${name} (${ip}) went offline`);
+    });
+    // Start continuous 3 FPS stream — no repeated channel switches
+    if (streamTimer)
+        clearInterval(streamTimer);
+    streamTimer = setInterval(doStreamPush, HTTP_STREAM_INTERVAL_MS);
+    debug(TAG, 'Bridge started (Continuous 3 FPS stream)');
+}
+export function broadcastPixoo(event) {
+    if (!FORWARDED_EVENTS.has(event.type))
+        return;
+    // Always cache state for live preview (even without Pixoo devices)
+    switch (event.type) {
+        case 'state_update':
+            lastStateEvent = event;
+            break;
+        case 'usage_update':
+            lastUsageEvent = event;
+            break;
+        case 'sessions_list':
+            lastSessions = event.sessions;
+            break;
+        case 'connection':
+            if (event.status === 'disconnected') {
+                lastStateEvent = null;
+                lastUsageEvent = null;
+            }
+            break;
+        case 'display_state': {
+            const displayOn = event.displayOn;
+            if (!displayOn && !displayDimmed) {
+                // Mac display off → dim Pixoo and pause stream
+                displayDimmed = true;
+                for (const dev of devices) {
+                    setBrightness(dev.ip, 0).catch(() => { });
+                }
+                if (streamTimer) {
+                    clearInterval(streamTimer);
+                    streamTimer = null;
+                }
+                debug(TAG, 'Display sleep — brightness 0, stream paused');
+            }
+            else if (displayOn && displayDimmed) {
+                // Mac display on → restore brightness and resume stream
+                displayDimmed = false;
+                for (const dev of devices) {
+                    setBrightness(dev.ip, dev.brightness ?? DEFAULT_BRIGHTNESS).catch(() => { });
+                }
+                // Resume stream after brief delay (let brightness restore first)
+                setTimeout(() => {
+                    if (!displayDimmed && !streamTimer && devices.length > 0) {
+                        streamTimer = setInterval(doStreamPush, HTTP_STREAM_INTERVAL_MS);
+                        doStreamPush(); // Immediate first frame
+                    }
+                }, 100);
+                debug(TAG, 'Display wake — brightness restored, stream resumed');
+            }
+            break;
+        }
+    }
+    // Immediate push on major disconnections to feel snappy
+    if (event.type === 'connection' && devices.length > 0) {
+        if (!pushing)
+            doStreamPush();
+    }
+}
+export async function stopPixooBridge() {
+    if (streamTimer) {
+        clearInterval(streamTimer);
+        streamTimer = null;
+    }
+    stopProbeTimer();
+    // Push disconnected frame to all devices (best-effort, 2s cap)
+    if (devices.length > 0) {
+        const frame = renderDisconnectedFrame();
+        await Promise.race([
+            Promise.all(devices.map(dev => pushFrame(dev.ip, frame).catch(() => { }))),
+            new Promise(resolve => setTimeout(resolve, 2000)),
+        ]);
+    }
+    for (const dev of devices) {
+        clearText(dev.ip).catch(() => { });
+    }
+    stopPreviewTimer();
+    devices = [];
+    lastStateEvent = null;
+    lastUsageEvent = null;
+    lastSessions = null;
+    displayDimmed = false;
+    broadcastFn = null;
+    frameListeners = [];
+    debug(TAG, 'Bridge stopped');
+}
+/** Register a listener called whenever a new frame is rendered. */
+export function onFrameRendered(listener) {
+    frameListeners.push(listener);
+    startPreviewTimer();
+}
+/** Remove a frame listener. */
+export function offFrameRendered(listener) {
+    frameListeners = frameListeners.filter(l => l !== listener);
+    if (frameListeners.length === 0)
+        stopPreviewTimer();
+}
+/**
+ * Set the live preview frame rate (1–10 FPS).
+ * Takes effect immediately by restarting the preview timer.
+ */
+export function setPreviewFps(fps) {
+    previewFps = Math.max(1, Math.min(10, Math.round(fps)));
+    if (frameListeners.length > 0) {
+        stopPreviewTimer();
+        startPreviewTimer();
+    }
+    debug(TAG, `Preview FPS set to ${previewFps}`);
+}
+/** Get current preview FPS setting. */
+export function getPreviewFps() {
+    return previewFps;
+}
+export function pixooDeviceCount() {
+    return devices.length;
+}
+export function getPixooDeviceDetails() {
+    return devices.map(dev => {
+        const backoff = getDeviceBackoffStatus(dev.ip);
+        return {
+            ip: dev.ip,
+            name: dev.name || 'Pixoo64',
+            backedOff: backoff.backedOff,
+            failures: backoff.failures,
+            nextProbeMs: backoff.nextProbeMs,
+            lastPushAgo: lastPushTime > 0 ? Date.now() - lastPushTime : -1,
+        };
+    });
+}
+// ===== Internal =====
+/**
+ * Main Continuous Stream tick: 3 FPS push to all hardware devices (333ms interval).
+ */
+function doStreamPush() {
+    if (devices.length === 0)
+        return;
+    if (pushing)
+        return;
+    if (displayDimmed)
+        return;
+    const elapsed = Date.now() - lastPushTime;
+    if (elapsed < HTTP_STREAM_INTERVAL_MS * 0.8)
+        return;
+    pushing = true;
+    lastPushTime = Date.now();
+    try {
+        const frame = renderFrame(lastStateEvent, lastUsageEvent, lastSessions);
+        const ts = new Date().toISOString().slice(11, 19);
+        debug('Pixoo', `${ts} pushing to ${devices.length} dev(s)`);
+        const promises = devices.map(dev => pushFrame(dev.ip, frame).then(ok => {
+            debug('Pixoo', `${ts}   → ${dev.ip}: ${ok ? 'OK' : 'FAIL'}`);
+        }).catch((err) => {
+            debug('Pixoo', `${ts}   → ${dev.ip}: ERROR ${err?.message}`);
+        }));
+        Promise.all(promises).finally(() => { pushing = false; });
+    }
+    catch (err) {
+        pushing = false;
+        debug('Pixoo', `renderFrame error: ${err?.message}`);
+    }
+}
+/**
+ * Render a fresh frame using current cached state.
+ * Used by the live preview endpoint when no Pixoo device is connected.
+ */
+export function renderPreviewFrame() {
+    return renderFrame(lastStateEvent, lastUsageEvent, lastSessions);
+}
+/**
+ * Get the last calculated frame.
+ */
+export function getLastFrame() {
+    return renderFrame(lastStateEvent, lastUsageEvent, lastSessions);
+}
+/** Notify all SSE frame listeners. */
+function notifyFrameListeners(frame) {
+    for (const listener of frameListeners) {
+        try {
+            listener(frame);
+        }
+        catch { /* best-effort */ }
+    }
+}
+/** Preview timer: Generates frames at previewFps for the Web UI stream. */
+function startPreviewTimer() {
+    if (previewTimer)
+        return;
+    const intervalMs = Math.round(1000 / previewFps);
+    previewTimer = setInterval(() => {
+        if (frameListeners.length === 0) {
+            stopPreviewTimer();
+            return;
+        }
+        const frame = renderFrame(lastStateEvent, lastUsageEvent, lastSessions);
+        notifyFrameListeners(frame);
+    }, intervalMs);
+}
+function stopPreviewTimer() {
+    if (previewTimer) {
+        clearInterval(previewTimer);
+        previewTimer = null;
+    }
+}
+//# sourceMappingURL=pixoo-bridge.js.map

package/dist/pixoo/pixoo-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-bridge.js","sourceRoot":"","sources":["../../src/pixoo/pixoo-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7J,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAErC,MAAM,GAAG,GAAG,OAAO,CAAC;AAUpB,6BAA6B;AAE7B,IAAI,OAAO,GAAkB,EAAE,CAAC;AAChC,IAAI,WAAW,GAA0C,IAAI,CAAC;AAC9D,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,mCAAmC;AAExD,uBAAuB;AACvB,IAAI,cAAc,GAA4B,IAAI,CAAC;AACnD,IAAI,cAAc,GAAsB,IAAI,CAAC;AAC7C,IAAI,YAAY,GAAyB,IAAI,CAAC;AAE9C,4EAA4E;AAC5E,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,oCAAoC;AACpC,IAAI,cAAc,GAAuC,EAAE,CAAC;AAC5D,IAAI,YAAY,GAA0C,IAAI,CAAC;AAC/D,IAAI,UAAU,GAAG,EAAE,CAAC,CAAC,8CAA8C;AAEnE,MAAM,uBAAuB,GAAG,GAAG,CAAC,CAAK,uDAAuD;AAChG,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAK,mEAAmE;AAC3G,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAElD,yEAAyE;AACzE,IAAI,WAAW,GAA0C,IAAI,CAAC;AAE9D,yBAAyB;AAEzB,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,EAAgC;IAChE,WAAW,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,YAA4B;IAC3D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,KAAK,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,OAAO,GAAG,YAAY,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,iBAAiB,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExG,6EAA6E;IAC7E,iFAAiF;IACjF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9C,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,8CAA8C;IAC9C,oBAAoB,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,SAAS,CAAC;QACpC,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,MAAM,EAAE,OAAO;gBACf,IAAI;gBACJ,EAAE;gBACF,MAAM;gBACN,OAAO,EAAE,MAAM;oBACb,CAAC,CAAC,GAAG,IAAI,cAAc;oBACvB,CAAC,CAAC,GAAG,IAAI,sCAAsC;aAC3C,CAAC,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,IAAI,WAAW;QAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC5C,WAAW,GAAG,WAAW,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;IAEjE,KAAK,CAAC,GAAG,EAAE,0CAA0C,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO;IAE9C,mEAAmE;IACnE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc;YACjB,cAAc,GAAG,KAAyB,CAAC;YAC3C,MAAM;QACR,KAAK,cAAc;YACjB,cAAc,GAAG,KAAmB,CAAC;YACrC,MAAM;QACR,KAAK,eAAe;YAClB,YAAY,GAAI,KAA2B,CAAC,QAAQ,CAAC;YACrD,MAAM;QACR,KAAK,YAAY;YACf,IAAK,KAAa,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC7C,cAAc,GAAG,IAAI,CAAC;gBACtB,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,MAAM;QACR,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,SAAS,GAAI,KAAa,CAAC,SAAoB,CAAC;YACtD,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;gBACjC,+CAA+C;gBAC/C,aAAa,GAAG,IAAI,CAAC;gBACrB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC3C,CAAC;gBACD,IAAI,WAAW,EAAE,CAAC;oBAChB,aAAa,CAAC,WAAW,CAAC,CAAC;oBAC3B,WAAW,GAAG,IAAI,CAAC;gBACrB,CAAC;gBACD,KAAK,CAAC,GAAG,EAAE,6CAA6C,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;gBACtC,wDAAwD;gBACxD,aAAa,GAAG,KAAK,CAAC;gBACtB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC9E,CAAC;gBACD,iEAAiE;gBACjE,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,aAAa,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzD,WAAW,GAAG,WAAW,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;wBACjE,YAAY,EAAE,CAAC,CAAC,wBAAwB;oBAC1C,CAAC;gBACH,CAAC,EAAE,GAAG,CAAC,CAAC;gBACR,KAAK,CAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;YACnE,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,YAAY,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3B,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,cAAc,EAAE,CAAC;IAEjB,+DAA+D;IAC/D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,uBAAuB,EAAE,CAAC;QACxC,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,gBAAgB,EAAE,CAAC;IACnB,OAAO,GAAG,EAAE,CAAC;IACb,cAAc,GAAG,IAAI,CAAC;IACtB,cAAc,GAAG,IAAI,CAAC;IACtB,YAAY,GAAG,IAAI,CAAC;IACpB,aAAa,GAAG,KAAK,CAAC;IACtB,WAAW,GAAG,IAAI,CAAC;IACnB,cAAc,GAAG,EAAE,CAAC;IACpB,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AAC/B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,QAAqC;IACnE,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,iBAAiB,EAAE,CAAC;AACtB,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,gBAAgB,CAAC,QAAqC;IACpE,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC5D,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,gBAAgB,EAAE,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,GAAG,EAAE,sBAAsB,UAAU,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,qBAAqB;IAQnC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACvB,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;YAC3B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;SAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uBAAuB;AAEvB;;GAEG;AACH,SAAS,YAAY;IACnB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,IAAI,OAAO;QAAE,OAAO;IACpB,IAAI,aAAa;QAAE,OAAO;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAC1C,IAAI,OAAO,GAAG,uBAAuB,GAAG,GAAG;QAAE,OAAO;IAEpD,OAAO,GAAG,IAAI,CAAC;IACf,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QACxE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,eAAe,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;QAE5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CACjC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YACjC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAQ,EAAE,EAAE;YACpB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,WAAW,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,GAAG,KAAK,CAAC;QAChB,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC;AAED,sCAAsC;AACtC,SAAS,oBAAoB,CAAC,KAAiB;IAC7C,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC;YAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAS,iBAAiB;IACxB,IAAI,YAAY;QAAE,OAAO;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IACjD,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,gBAAgB,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAChE,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QACxE,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,YAAY,EAAE,CAAC;QAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAAC,YAAY,GAAG,IAAI,CAAC;IAAC,CAAC;AACzE,CAAC"}

package/dist/pixoo/pixoo-camera.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Pixoo64 Camera System — zoom/pan coordinate transform + zone director.
+ *
+ * Virtual world is normalized 0~1 in both axes. Camera defines a viewport
+ * with center (cx, cy) and zoom level. At zoom=1.0 the full world is visible;
+ * at zoom=2.0 only the center quarter is visible but everything is 2× larger.
+ *
+ * Rendering pipeline:
+ *   1. Environment → 64×64 world buffer (pixel coords 0~63)
+ *   2. blitWithCamera() → 64×64 output buffer (crop + nearest-neighbor scale)
+ *   3. Scaled creatures → output buffer (high-detail grid, camera-aware sizing)
+ */
+export interface Camera {
+    cx: number;
+    cy: number;
+    zoom: number;
+}
+export declare const CAMERA_WIDE: Camera;
+export interface CameraZone {
+    name: string;
+    cx: number;
+    cy: number;
+    zoom: number;
+    duration: number;
+}
+export declare const ZONES: Record<string, CameraZone>;
+/** World (0~1) → screen pixel (0~63). */
+export declare function worldToScreen(wx: number, wy: number, cam: Camera): [number, number];
+/** Screen pixel → world (0~1). */
+export declare function screenToWorld(sx: number, sy: number, cam: Camera): [number, number];
+/** Check if a world-space point is within the camera viewport. */
+export declare function isVisible(wx: number, wy: number, cam: Camera, padding?: number): boolean;
+/** Clamp camera so the viewport stays within world bounds. */
+export declare function clampCamera(cam: Camera): Camera;
+/** Linearly interpolate between two cameras. */
+export declare function lerpCamera(a: Camera, b: Camera, t: number): Camera;
+/** Smoothstep ease-in-out. */
+export declare function easeInOut(t: number): number;
+/**
+ * Crop + nearest-neighbor scale from a 64×64 world buffer into a 64×64 output.
+ * At zoom 1.0: 1:1 copy.  At zoom 2.0: center 32×32 upscaled to fill output.
+ */
+export declare function blitWithCamera(world: Uint8Array, output: Uint8Array, cam: Camera): void;
+/** Active creature descriptor for camera targeting. */
+export interface ActiveCreature {
+    x: number;
+    y: number;
+    /** Lower = higher priority. AWAITING=0, PROCESSING=1, ROUTING=2. */
+    priority: number;
+}
+/**
+ * Advance the camera director by `dt` seconds and return the current camera.
+ *
+ * 3-mode state machine:
+ *   idle-cycle:     No active creatures → wide(12s) → school(10s) → full-tank(8s)
+ *   tracking:       Single active creature → zoom 2.0 tracking
+ *   cycling-active: 2+ active creatures → priority-sorted, 6s per creature
+ *
+ * @param dt               seconds since last call (~1.2s at Pixoo push rate)
+ * @param activeCreatures  creatures with state != idle (octopus PROCESSING/AWAITING, crayfish ROUTING)
+ * @param crayfishRouting  whether crayfish is actively routing (for legacy compat)
+ * @param crayfishPos      crayfish world position (if visible)
+ * @param schoolPos        dynamic tetra school center for idle tracking
+ */
+export declare function updateDirector(dt: number, activeCreatures: ActiveCreature[], crayfishRouting: boolean, crayfishPos: {
+    x: number;
+    y: number;
+} | null, schoolPos: {
+    x: number;
+    y: number;
+}): Camera;
+/** Jump to a specific zone immediately (for preview). */
+export declare function setZone(zoneName: string): void;
+/** Override camera directly (for preview --zoom). */
+export declare function setOverride(cam: Camera): void;
+/** Reset director state (e.g. on reconnect). */
+export declare function resetDirector(): void;
+/** Get the name of the current camera zone (for change detection). */
+export declare function getCurrentZoneName(): string;
+//# sourceMappingURL=pixoo-camera.d.ts.map

package/dist/pixoo/pixoo-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixoo-camera.d.ts","sourceRoot":"","sources":["../../src/pixoo/pixoo-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,WAAW,EAAE,MAAwC,CAAC;AAInE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAQ5C,CAAC;AAIF,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKnF;AAED,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKnF;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAGtF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,8BAA8B;AAC9B,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAqBvF;AAID,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAgCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,cAAc,EAAE,EACjC,eAAe,EAAE,OAAO,EACxB,WAAW,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAC5C,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,MAAM,CA6GR;AAYD,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgB9C;AAED,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAc7C;AAED,gDAAgD;AAChD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C"}