@triforge/context-pool-core 0.1.0

package/dist/adapters/ThreeContextAdapter.d.ts

@@ -0,0 +1,47 @@
+import type * as THREE from 'three';
+import type { Rect } from '../core/types.js';
+export interface ThreeSceneRegistration {
+    scene: THREE.Scene;
+    camera: THREE.Camera;
+    /** DOM element whose on-screen position/size determines this scene's viewport. */
+    anchor: Element;
+    /** Lower number = higher priority when the context budget is tight. */
+    priority?: number;
+}
+export interface ThreeContextAdapterConfig {
+    renderer: THREE.WebGLRenderer;
+    maxConcurrent: number;
+    /** Injectable for tests — defaults to the real window viewport. */
+    getVisibleRegion?: () => Rect;
+    /** Called when the shared context is lost — rendering is skipped until restored. */
+    onContextLost?: () => void;
+    onContextRestored?: () => void;
+}
+/**
+ * The one engine-specific piece of this package: wraps a single THREE.WebGLRenderer so
+ * any number of registered scenes can share it, instead of each needing its own
+ * WebGLRenderer (and its own real WebGL context). This is what actually fixes a
+ * "one WebGLRenderer per canvas" context-exhaustion bug — the ContextPool it wraps
+ * doesn't know or care that Three.js is involved at all.
+ */
+export declare class ThreeContextAdapter {
+    private pool;
+    private renderer;
+    private registrations;
+    private contextLost;
+    private currentCanvasHeight;
+    private onLost;
+    private onRestored;
+    private handleContextLost;
+    private handleContextRestored;
+    constructor(config: ThreeContextAdapterConfig);
+    /** Register (or replace, if `id` already exists) a scene/camera pair positioned by `anchor`. */
+    registerScene(id: string, registration: ThreeSceneRegistration): void;
+    unregisterScene(id: string): void;
+    setMaxConcurrent(n: number): void;
+    /** Call once per animation frame. No-ops while the shared context is lost. */
+    renderFrame(): void;
+    private renderScissored;
+    dispose(): void;
+}
+//# sourceMappingURL=ThreeContextAdapter.d.ts.map

package/dist/adapters/ThreeContextAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeContextAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ThreeContextAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAE5C,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAA;IACpB,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAA;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAA;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC/B;AAMD;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,iBAAiB,CAIxB;IACD,OAAO,CAAC,qBAAqB,CAG5B;gBAEW,MAAM,EAAE,yBAAyB;IAS7C,gGAAgG;IAChG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,sBAAsB,GAAG,IAAI;IAmBrE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKjC,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjC,8EAA8E;IAC9E,WAAW,IAAI,IAAI;IAWnB,OAAO,CAAC,eAAe;IAUvB,OAAO,IAAI,IAAI;CAIhB"}

package/dist/adapters/ThreeContextAdapter.js

@@ -0,0 +1,87 @@
+import { ContextPool } from '../core/ContextPool.js';
+function domRectToRect(r) {
+    return { x: r.left, y: r.top, width: r.width, height: r.height };
+}
+/**
+ * The one engine-specific piece of this package: wraps a single THREE.WebGLRenderer so
+ * any number of registered scenes can share it, instead of each needing its own
+ * WebGLRenderer (and its own real WebGL context). This is what actually fixes a
+ * "one WebGLRenderer per canvas" context-exhaustion bug — the ContextPool it wraps
+ * doesn't know or care that Three.js is involved at all.
+ */
+export class ThreeContextAdapter {
+    constructor(config) {
+        this.registrations = new Map();
+        this.contextLost = false;
+        this.currentCanvasHeight = 0;
+        this.handleContextLost = (event) => {
+            event.preventDefault(); // required by the WebGL spec to allow eventual restoration
+            this.contextLost = true;
+            this.onLost();
+        };
+        this.handleContextRestored = () => {
+            this.contextLost = false;
+            this.onRestored();
+        };
+        this.renderer = config.renderer;
+        this.pool = new ContextPool({ maxConcurrent: config.maxConcurrent, getVisibleRegion: config.getVisibleRegion });
+        this.onLost = config.onContextLost ?? (() => { });
+        this.onRestored = config.onContextRestored ?? (() => { });
+        this.renderer.domElement.addEventListener('webglcontextlost', this.handleContextLost);
+        this.renderer.domElement.addEventListener('webglcontextrestored', this.handleContextRestored);
+    }
+    /** Register (or replace, if `id` already exists) a scene/camera pair positioned by `anchor`. */
+    registerScene(id, registration) {
+        this.registrations.set(id, registration);
+        this.pool.register({
+            id,
+            priority: registration.priority,
+            getAnchorRect: () => {
+                const current = this.registrations.get(id);
+                if (!current)
+                    return null;
+                const r = current.anchor.getBoundingClientRect();
+                return r.width > 0 && r.height > 0 ? domRectToRect(r) : null;
+            },
+            render: (viewport) => {
+                const current = this.registrations.get(id);
+                if (!current)
+                    return;
+                this.renderScissored(current, viewport);
+            },
+        });
+    }
+    unregisterScene(id) {
+        this.registrations.delete(id);
+        this.pool.unregister(id);
+    }
+    setMaxConcurrent(n) {
+        this.pool.setMaxConcurrent(n);
+    }
+    /** Call once per animation frame. No-ops while the shared context is lost. */
+    renderFrame() {
+        if (this.contextLost)
+            return;
+        const canvasRect = domRectToRect(this.renderer.domElement.getBoundingClientRect());
+        if (canvasRect.width <= 0 || canvasRect.height <= 0)
+            return;
+        this.renderer.setScissorTest(false);
+        this.renderer.clear();
+        this.currentCanvasHeight = canvasRect.height;
+        this.pool.tick(canvasRect);
+    }
+    renderScissored(registration, viewport) {
+        // viewport is canvas-local, y-down (DOM convention). WebGL scissor/viewport are
+        // y-up from the bottom-left — flip using the canvas height captured this frame.
+        const glY = this.currentCanvasHeight - viewport.y - viewport.height;
+        this.renderer.setScissorTest(true);
+        this.renderer.setScissor(viewport.x, glY, viewport.width, viewport.height);
+        this.renderer.setViewport(viewport.x, glY, viewport.width, viewport.height);
+        this.renderer.render(registration.scene, registration.camera);
+    }
+    dispose() {
+        this.renderer.domElement.removeEventListener('webglcontextlost', this.handleContextLost);
+        this.renderer.domElement.removeEventListener('webglcontextrestored', this.handleContextRestored);
+    }
+}
+//# sourceMappingURL=ThreeContextAdapter.js.map

package/dist/adapters/ThreeContextAdapter.js.map

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

package/dist/core/ContextPool.d.ts

@@ -0,0 +1,30 @@
+import type { ContextPoolClient, ContextPoolConfig, Rect, TickResult } from './types.js';
+/**
+ * Engine-agnostic scissor/viewport multiplexer. Clients register a DOM anchor (for
+ * positioning/visibility) and a render callback; the pool decides which subset of
+ * registered clients fit inside the context budget this tick and calls only theirs.
+ *
+ * This package never creates a WebGLRenderer or any other engine object — it only
+ * decides who gets to render this frame and where. Actually rendering (sharing one
+ * real renderer across all active clients via setScissor/setViewport) is the adapter's
+ * job (see ThreeContextAdapter) — that's the one piece of this package that's engine-specific.
+ */
+export declare class ContextPool {
+    private clients;
+    private activeIds;
+    private nextOrder;
+    private maxConcurrent;
+    private getVisibleRegion;
+    constructor(config: ContextPoolConfig);
+    register(client: ContextPoolClient): void;
+    unregister(id: string): void;
+    setMaxConcurrent(n: number): void;
+    /**
+     * Advance one frame. `referenceRect` is typically the shared canvas's own
+     * getBoundingClientRect() — client viewports are returned relative to it, ready to
+     * hand straight to a GL-style setScissor/setViewport call (after any y-flip the
+     * engine adapter needs).
+     */
+    tick(referenceRect: Rect): TickResult;
+}
+//# sourceMappingURL=ContextPool.d.ts.map

package/dist/core/ContextPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextPool.d.ts","sourceRoot":"","sources":["../../src/core/ContextPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA2BxF;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,gBAAgB,CAAY;gBAExB,MAAM,EAAE,iBAAiB;IAKrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAKzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU;CAwCtC"}

package/dist/core/ContextPool.js

@@ -0,0 +1,84 @@
+function defaultVisibleRegion() {
+    if (typeof window === 'undefined')
+        return { x: 0, y: 0, width: Infinity, height: Infinity };
+    return { x: 0, y: 0, width: window.innerWidth, height: window.innerHeight };
+}
+function intersects(a, b) {
+    return a.x < b.x + b.width && a.x + a.width > b.x && a.y < b.y + b.height && a.y + a.height > b.y;
+}
+function relativeRect(rect, reference) {
+    return { x: rect.x - reference.x, y: rect.y - reference.y, width: rect.width, height: rect.height };
+}
+/** A non-finite or negative budget must degrade to "render nothing", never throw or admit unbounded clients. */
+function sanitizeMaxConcurrent(n) {
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
+/**
+ * Engine-agnostic scissor/viewport multiplexer. Clients register a DOM anchor (for
+ * positioning/visibility) and a render callback; the pool decides which subset of
+ * registered clients fit inside the context budget this tick and calls only theirs.
+ *
+ * This package never creates a WebGLRenderer or any other engine object — it only
+ * decides who gets to render this frame and where. Actually rendering (sharing one
+ * real renderer across all active clients via setScissor/setViewport) is the adapter's
+ * job (see ThreeContextAdapter) — that's the one piece of this package that's engine-specific.
+ */
+export class ContextPool {
+    constructor(config) {
+        this.clients = new Map();
+        this.activeIds = new Set();
+        this.nextOrder = 0;
+        this.maxConcurrent = sanitizeMaxConcurrent(config.maxConcurrent);
+        this.getVisibleRegion = config.getVisibleRegion ?? defaultVisibleRegion;
+    }
+    register(client) {
+        const existing = this.clients.get(client.id);
+        this.clients.set(client.id, { client, order: existing?.order ?? this.nextOrder++ });
+    }
+    unregister(id) {
+        this.clients.delete(id);
+        this.activeIds.delete(id);
+    }
+    setMaxConcurrent(n) {
+        this.maxConcurrent = sanitizeMaxConcurrent(n);
+    }
+    /**
+     * Advance one frame. `referenceRect` is typically the shared canvas's own
+     * getBoundingClientRect() — client viewports are returned relative to it, ready to
+     * hand straight to a GL-style setScissor/setViewport call (after any y-flip the
+     * engine adapter needs).
+     */
+    tick(referenceRect) {
+        const visibleRegion = this.getVisibleRegion();
+        const hidden = [];
+        const visible = [];
+        for (const [id, entry] of this.clients) {
+            const rect = entry.client.getAnchorRect();
+            if (!rect || rect.width <= 0 || rect.height <= 0 || !intersects(rect, visibleRegion)) {
+                hidden.push(id);
+                continue;
+            }
+            visible.push({ id, order: entry.order, priority: entry.client.priority ?? entry.order, rect });
+        }
+        const byPriority = (a, b) => a.priority - b.priority || a.order - b.order;
+        // Sticky selection: clients already active last tick keep their slot (if still visible
+        // and still within budget) before any newly-visible client takes a remaining slot —
+        // this avoids visible flicker from re-ordering who renders every single frame.
+        const stillActive = visible.filter((v) => this.activeIds.has(v.id)).sort(byPriority);
+        const newlyVisible = visible.filter((v) => !this.activeIds.has(v.id)).sort(byPriority);
+        const kept = stillActive.slice(0, this.maxConcurrent);
+        const added = newlyVisible.slice(0, Math.max(0, this.maxConcurrent - kept.length));
+        const activeList = [...kept, ...added];
+        const activeIdSet = new Set(activeList.map((v) => v.id));
+        this.activeIds = activeIdSet;
+        const skipped = visible.filter((v) => !activeIdSet.has(v.id)).map((v) => v.id);
+        for (const v of activeList) {
+            const entry = this.clients.get(v.id);
+            if (!entry)
+                continue;
+            entry.client.render(relativeRect(v.rect, referenceRect));
+        }
+        return { active: activeList.map((v) => v.id), skipped, hidden };
+    }
+}
+//# sourceMappingURL=ContextPool.js.map

package/dist/core/ContextPool.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,37 @@
+/** Top-left-origin, y-down pixel rectangle — DOM convention. Engines that need a
+ * bottom-left/y-up convention (e.g. GL scissor/viewport) convert at their own adapter,
+ * not here — this package makes no GL assumptions. */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ContextPoolClient {
+    id: string;
+    /** Current on-screen position/size in page coordinates, or null if not currently measurable (detached, display:none). */
+    getAnchorRect(): Rect | null;
+    /** Lower number = higher priority when the budget is tight. Defaults to registration order if omitted. */
+    priority?: number;
+    /** Called once per tick, only for clients selected as active this frame. `viewport` is already
+     * converted to be relative to the reference rect passed into ContextPool.tick(). */
+    render(viewport: Rect): void;
+}
+export interface ContextPoolConfig {
+    /** Max simultaneous active clients — typically RenderBudgetPlan.maxConcurrentContexts from
+     * @triforge/render-budget-core, though this package never imports that one directly (each
+     * package does one job; the consumer wires the number across). */
+    maxConcurrent: number;
+    /** Region a client's anchor must intersect to count as "visible" at all. Defaults to the
+     * real window viewport; injectable for tests. */
+    getVisibleRegion?: () => Rect;
+}
+export interface TickResult {
+    /** Clients rendered this tick. */
+    active: string[];
+    /** Clients visible but over budget — not rendered this tick. */
+    skipped: string[];
+    /** Clients not visible at all (anchor null, zero-sized, or outside the visible region). */
+    hidden: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;sDAEsD;AACtD,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,yHAAyH;IACzH,aAAa,IAAI,IAAI,GAAG,IAAI,CAAA;IAC5B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;wFACoF;IACpF,MAAM,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC;;sEAEkE;IAClE,aAAa,EAAE,MAAM,CAAA;IACrB;qDACiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,2FAA2F;IAC3F,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { Rect, ContextPoolClient, ContextPoolConfig, TickResult } from './core/types.js';
+export { ContextPool } from './core/ContextPool.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,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ContextPool } from './core/ContextPool.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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@triforge/context-pool-core",
+  "version": "0.1.0",
+  "description": "Engine-agnostic scissor/viewport multiplexer — share one real rendering context across many logical canvases, enforcing a context-count budget instead of creating one context per canvas",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node test/run-tests.js",
+    "bench": "node bench/run-bench.js"
+  },
+  "keywords": [
+    "context-pool",
+    "webgl",
+    "scissor",
+    "viewport",
+    "three.js"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "three": ">=0.128.0"
+  },
+  "peerDependenciesMeta": {
+    "three": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/three": "^0.165.0",
+    "three": "^0.165.0",
+    "typescript": "^5.3.0"
+  },
+  "author": "Aftab Ibrahim Kazi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AftabIbrahimKazi/triforge.git",
+    "directory": "context-pool-core"
+  },
+  "homepage": "https://github.com/AftabIbrahimKazi/triforge#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./three": {
+      "import": "./dist/adapters/ThreeContextAdapter.js",
+      "types": "./dist/adapters/ThreeContextAdapter.d.ts"
+    }
+  }
+}