@pbroom/color-kit/compute

@pbroom/color-kit/compute runs batches of plane queries and returns the results packed into typed arrays, ready to post from a worker without copying. Use it when queries are heavy or frequent enough to leave the main thread, or when you want timing telemetry about them.

Domains

• Running. runPlaneCompute takes a plane, a list of queries and an optional trace request, and returns packed results with compute and marshal times. runPackedPlaneQueries returns only the packed results. Both run synchronously on the calling thread.
• Packing. packPlaneQueryResults and unpackPlaneQueryResults convert between query results and the packed layout; getPackedPlaneQueryTransferables lists the buffers to transfer.
• Scheduling and telemetry. createPlaneComputeScheduler routes requests to a backend and records timings; runScheduledPlaneCompute uses a shared scheduler whose snapshot getDefaultPlaneComputeTelemetrySnapshot reads. The built-in backend is JavaScript (createJsPlaneComputeBackend).

import { parse } from '@pbroom/color-kit';
import {
  getPackedPlaneQueryTransferables,
  runPlaneCompute,
} from '@pbroom/color-kit/compute';

const { result } = runPlaneCompute({
  plane: { model: 'oklch', fixed: { h: 250 } },
  queries: [
    { kind: 'gamutRegion', gamut: 'srgb' },
    { kind: 'contrastRegion', reference: parse('#fff'), level: 'AA' },
  ],
});
result.queryDescriptors.map((query) => query.kind);
// → ['gamutRegion', 'contrastRegion']
self.postMessage(result, {
  transfer: getPackedPlaneQueryTransferables(result),
});

On the main thread, unpackPlaneQueryResults(result) restores the query results.