mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-04 07:19:52 +00:00
## Summary PR 3 of 5 in the hf#732 decomposition stack. Adds a `worker_threads`-based pool that runs the shader-transition blend (one of 15 transition shaders) on a fixed-size worker pool. **No production wiring yet** — the pool stands alone; PR 4 wires it. The shader blend is a hot inner loop over every pixel of every transition frame at 16bpc. Moving it off the main event loop removes the JS-event-loop ceiling that capped throughput in earlier hf#732 iterations. ### New files - `packages/producer/src/services/shaderTransitionWorker.ts` — worker entry. Imports from `@hyperframes/engine/shader-transitions` (zero-import TS source). - `packages/producer/src/services/shaderTransitionWorkerPool.ts` — fixed-size pool. Uses `transferList` so the 16bpc HDR `from`/`to`/`out` buffers move by ownership. - `packages/producer/src/services/shaderTransitionWorkerPool.test.ts` — 6 vitest tests pinning byte-equivalence across all 15 shaders, transferList correctness, pool lifecycle. All pass. ### Build wiring - `packages/cli/tsup.config.ts`: third tsup entry emits `dist/shaderTransitionWorker.js`. - `packages/producer/build.mjs`: fourth esbuild entry for direct producer consumers. - `packages/engine/package.json`: adds `./shader-transitions` subpath export. ## Stack Stacked on top of #757 (PR 2: pngDecodeBlit pool). No behavior change in any render. ## Test plan - [x] 6 pool tests pass - [x] Producer + engine typecheck clean - [x] oxlint clean — Vai
121 lines
4.0 KiB
JavaScript
121 lines
4.0 KiB
JavaScript
#!/usr/bin/env node
|
|
/**
|
|
* Build script for @hyperframes/producer (public OSS package)
|
|
*
|
|
* Bundles src/server.ts → dist/public-server.js (standalone server).
|
|
*/
|
|
|
|
import { build } from "esbuild";
|
|
import { mkdirSync, rmSync } from "fs";
|
|
import { resolve, dirname } from "path";
|
|
import { fileURLToPath } from "url";
|
|
|
|
rmSync("dist", { recursive: true, force: true });
|
|
mkdirSync("dist", { recursive: true });
|
|
|
|
const scriptDir = dirname(fileURLToPath(import.meta.url));
|
|
|
|
const workspaceAliasPlugin = {
|
|
name: "workspace-alias",
|
|
setup(build) {
|
|
build.onResolve({ filter: /^@hyperframes\/engine$/ }, () => ({
|
|
path: resolve(scriptDir, "../engine/src/index.ts"),
|
|
}));
|
|
build.onResolve({ filter: /^@hyperframes\/engine\/alpha-blit$/ }, () => ({
|
|
path: resolve(scriptDir, "../engine/src/utils/alphaBlit.ts"),
|
|
}));
|
|
build.onResolve({ filter: /^@hyperframes\/engine\/shader-transitions$/ }, () => ({
|
|
path: resolve(scriptDir, "../engine/src/utils/shaderTransitions.ts"),
|
|
}));
|
|
build.onResolve({ filter: /^@hyperframes\/core$/ }, () => ({
|
|
path: resolve(scriptDir, "../core/src/index.ts"),
|
|
}));
|
|
build.onResolve({ filter: /^@hyperframes\/core\/lint$/ }, () => ({
|
|
path: resolve(scriptDir, "../core/src/lint/index.ts"),
|
|
}));
|
|
},
|
|
};
|
|
|
|
await Promise.all([
|
|
build({
|
|
bundle: true,
|
|
platform: "node",
|
|
target: "node22",
|
|
format: "esm",
|
|
external: ["puppeteer", "esbuild", "postcss"],
|
|
plugins: [workspaceAliasPlugin],
|
|
minify: false,
|
|
sourcemap: true,
|
|
entryPoints: ["src/index.ts"],
|
|
outfile: "dist/index.js",
|
|
}),
|
|
build({
|
|
bundle: true,
|
|
platform: "node",
|
|
target: "node22",
|
|
format: "esm",
|
|
external: ["puppeteer", "esbuild", "postcss"],
|
|
plugins: [workspaceAliasPlugin],
|
|
minify: false,
|
|
sourcemap: true,
|
|
entryPoints: ["src/server.ts"],
|
|
outfile: "dist/public-server.js",
|
|
}),
|
|
// PNG decode + alpha-blit worker (hf#732 lever-4). Loaded by
|
|
// `pngDecodeBlitWorkerPool.createPngDecodeBlitWorkerPool` via
|
|
// `new Worker(<path>)`. Must be a separate entry point so the worker
|
|
// module is standalone and shares no parent module-graph state.
|
|
build({
|
|
bundle: true,
|
|
platform: "node",
|
|
target: "node22",
|
|
format: "esm",
|
|
external: ["puppeteer", "esbuild", "postcss"],
|
|
plugins: [workspaceAliasPlugin],
|
|
minify: false,
|
|
sourcemap: true,
|
|
entryPoints: ["src/services/pngDecodeBlitWorker.ts"],
|
|
outfile: "dist/services/pngDecodeBlitWorker.js",
|
|
}),
|
|
// Shader-blend worker (hf#677 follow-up). Loaded by
|
|
// `shaderTransitionWorkerPool.createShaderTransitionWorkerPool` via
|
|
// `new Worker(<path>)`. Same bundling rationale as the
|
|
// `pngDecodeBlitWorker` entry above.
|
|
build({
|
|
bundle: true,
|
|
platform: "node",
|
|
target: "node22",
|
|
format: "esm",
|
|
external: ["puppeteer", "esbuild", "postcss"],
|
|
plugins: [workspaceAliasPlugin],
|
|
minify: false,
|
|
sourcemap: true,
|
|
entryPoints: ["src/services/shaderTransitionWorker.ts"],
|
|
outfile: "dist/services/shaderTransitionWorker.js",
|
|
}),
|
|
]);
|
|
|
|
// Copy core runtime artifacts so the producer can find them at dist/
|
|
import { copyFileSync, existsSync, readFileSync } from "fs";
|
|
const coreDistDir = resolve(scriptDir, "../core/dist");
|
|
try {
|
|
const manifestSrc = resolve(coreDistDir, "hyperframe.manifest.json");
|
|
if (existsSync(manifestSrc)) {
|
|
copyFileSync(manifestSrc, "dist/hyperframe.manifest.json");
|
|
const manifest = JSON.parse(readFileSync(manifestSrc, "utf8"));
|
|
const runtimeIife = manifest?.artifacts?.iife || "hyperframe.runtime.iife.js";
|
|
copyFileSync(resolve(coreDistDir, runtimeIife), `dist/${runtimeIife}`);
|
|
console.log(`[Build] Copied runtime: hyperframe.manifest.json, ${runtimeIife}`);
|
|
}
|
|
} catch (e) {
|
|
console.warn("[Build] Warning: Could not copy runtime artifacts:", e.message);
|
|
}
|
|
|
|
// Generate .d.ts declarations (esbuild doesn't emit them)
|
|
import { execSync } from "child_process";
|
|
execSync("tsc --emitDeclarationOnly --declaration --declarationMap", {
|
|
stdio: "inherit",
|
|
});
|
|
|
|
console.log("[Build] Complete: dist/index.js, dist/public-server.js, *.d.ts");
|