@aelionsdk/renderer-worker 0.1.0-beta.1

package/dist/protocol.d.ts

@@ -0,0 +1,117 @@
+import type { JsonValue } from '@aelionsdk/core';
+import type { WebGl2MaterialProgram } from '@aelionsdk/material-compiler';
+export interface ComposeRequest {
+    readonly type: 'compose';
+    readonly id: number;
+    readonly inputs: Readonly<Record<string, VideoFrame>>;
+    readonly program: WebGl2MaterialProgram;
+    readonly parameters: Readonly<Record<string, JsonValue>>;
+    readonly systems: Readonly<Record<string, number>>;
+    readonly width: number;
+    readonly height: number;
+    readonly preferredBackend: 'webgpu' | 'webgl2';
+    readonly allowFallback: boolean;
+    /** @internal Conformance-only loss injection; production callers must omit it. */
+    readonly debugSimulateLoss?: 'webgpu-device' | 'webgl2-context';
+}
+export type FrameGraphInput = {
+    readonly kind: 'external';
+    readonly id: string;
+} | {
+    readonly kind: 'node';
+    readonly id: string;
+};
+export interface FrameGraphNode {
+    readonly id: string;
+    readonly inputs: Readonly<Record<string, FrameGraphInput>>;
+    readonly program: WebGl2MaterialProgram;
+    readonly parameters: Readonly<Record<string, JsonValue>>;
+    readonly systems: Readonly<Record<string, number>>;
+}
+/**
+ * One complete output-frame graph. Intermediate node outputs remain Worker/GPU
+ * owned; only the final node is transferred back to the caller.
+ */
+export interface ComposeFrameGraphRequest {
+    readonly type: 'compose-frame-graph';
+    readonly id: number;
+    readonly inputs: Readonly<Record<string, VideoFrame>>;
+    readonly nodes: readonly FrameGraphNode[];
+    readonly outputNodeId: string;
+    readonly width: number;
+    readonly height: number;
+    readonly preferredBackend: 'webgpu' | 'webgl2';
+    readonly allowFallback: boolean;
+}
+export interface RendererWorkerResourceSnapshot {
+    /** Worker requests still executing after this request completed. */
+    readonly activeRequests: number;
+    /** Active requests with cancellation pending after this request completed. */
+    readonly cancelledRequests: number;
+    readonly webgpuDevices: number;
+    readonly webgpuPipelines: number;
+    readonly webgpuBuffers: number;
+    readonly webgpuTextures: number;
+    readonly webgl2Contexts: number;
+    readonly webgl2Programs: number;
+    readonly webgl2Buffers: number;
+    readonly webgl2Textures: number;
+    readonly inputFrames: number;
+}
+export interface RendererWorkerDiagnostic {
+    readonly code: string;
+    readonly message: string;
+}
+export interface RendererWorkerTiming {
+    /** Worker request wall time including setup, compilation, draw and bitmap transfer. */
+    readonly totalWorkerUs: number;
+    /**
+     * Backend completion proxy. WebGL uses finish/readback; WebGPU covers queue
+     * submission, validation and presentation handoff without a blocking
+     * texture-to-CPU readback or queue-wide completion wait.
+     */
+    readonly gpuCompletionUs: number;
+}
+export interface DisposeRequest {
+    readonly type: 'dispose';
+}
+export interface CancelRequest {
+    readonly type: 'cancel';
+    readonly id: number;
+}
+/** @internal Conformance-only Worker resource inspection. */
+export interface InspectResourcesRequest {
+    readonly type: 'inspect-resources';
+    readonly responsePort: MessagePort;
+}
+/** @internal Conformance-only Worker request-set snapshot. */
+export interface RendererWorkerRequestSetSnapshot {
+    readonly activeRequests: number;
+    readonly cancelledRequests: number;
+}
+export type RendererWorkerRequest = ComposeRequest | ComposeFrameGraphRequest | CancelRequest | DisposeRequest | InspectResourcesRequest;
+export interface ComposeSuccess {
+    readonly type: 'composed';
+    readonly id: number;
+    readonly bitmap: ImageBitmap;
+    readonly backend: 'webgpu' | 'webgl2';
+    readonly graphHash: string;
+    readonly diagnostics: readonly RendererWorkerDiagnostic[];
+    /** Transient Worker resources after the request; the returned bitmap is caller-owned. */
+    readonly resources: RendererWorkerResourceSnapshot;
+    readonly outputBitmapOwner: 'caller';
+    readonly timing: RendererWorkerTiming;
+}
+export interface ComposeFailure {
+    readonly type: 'failed';
+    readonly id: number;
+    readonly code: string;
+    readonly message: string;
+}
+/** Worker acknowledgement emitted only after a cancelled request has released its resources. */
+export interface ComposeCancelled {
+    readonly type: 'cancelled';
+    readonly id: number;
+}
+export type RendererWorkerResponse = ComposeSuccess | ComposeFailure | ComposeCancelled;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1 @@
+export {};

package/dist/webgl2-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webgl2-worker.d.ts.map

package/dist/webgl2-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl2-worker.d.ts","sourceRoot":"","sources":["../src/webgl2-worker.ts"],"names":[],"mappings":""}