feat(studio): two faces, and the shared frequency ruler

.fallowrc.jsonc

@@ -149,13 +149,6 @@
       "file": "packages/studio/src/utils/studioHelpers.ts",
       "exports": ["resolveDroppedAssetDimensions"],
     },
-    // Audio FX worklets sit near the bottom of the audio stack: the worklet
-    // source and its test reset are consumed by the runtime and engine PRs
-    // upstack, so a per-PR audit against the merge base sees them as unused.
-    {
-      "file": "packages/core/src/audio/audioFxWorklets.ts",
-      "exports": ["AUDIO_FX_WORKLET_SOURCE", "__resetAudioFxWorkletsForTests"],
-    },
     {
       "file": "packages/core/src/audio/audioFxGraph.ts",
       "exports": ["ensureAudioFxWorklets"],

packages/core/package-subpaths.json

@@ -98,6 +98,36 @@
       "types": "./dist/audioFx.d.ts",
       "environments": ["browser", "bun", "node"]
     },
+    "./audio-fx-copy": {
+      "source": "./src/audioFxCopy.ts",
+      "runtime": "./dist/audioFxCopy.js",
+      "types": "./dist/audioFxCopy.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
+    "./audio-fx-jobs": {
+      "source": "./src/audioFxJobs.ts",
+      "runtime": "./dist/audioFxJobs.js",
+      "types": "./dist/audioFxJobs.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
+    "./audio-fx-eq": {
+      "source": "./src/audioFxEq.ts",
+      "runtime": "./dist/audioFxEq.js",
+      "types": "./dist/audioFxEq.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
+    "./audio-leveller": {
+      "source": "./src/audioLeveller.ts",
+      "runtime": "./dist/audioLeveller.js",
+      "types": "./dist/audioLeveller.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
+    "./audio-fx-presets": {
+      "source": "./src/audioFxPresets.ts",
+      "runtime": "./dist/audioFxPresets.js",
+      "types": "./dist/audioFxPresets.d.ts",
+      "environments": ["browser", "bun", "node"]
+    },
     "./audio-fx-tail": {
       "source": "./src/audio/audioFxTail.ts",
       "runtime": "./dist/audio/audioFxTail.js",

packages/core/package.json

@@ -112,6 +112,36 @@
       "import": "./src/audioFx.ts",
       "types": "./src/audioFx.ts"
     },
+    "./audio-fx-copy": {
+      "bun": "./src/audioFxCopy.ts",
+      "node": "./dist/audioFxCopy.js",
+      "import": "./src/audioFxCopy.ts",
+      "types": "./src/audioFxCopy.ts"
+    },
+    "./audio-fx-jobs": {
+      "bun": "./src/audioFxJobs.ts",
+      "node": "./dist/audioFxJobs.js",
+      "import": "./src/audioFxJobs.ts",
+      "types": "./src/audioFxJobs.ts"
+    },
+    "./audio-fx-eq": {
+      "bun": "./src/audioFxEq.ts",
+      "node": "./dist/audioFxEq.js",
+      "import": "./src/audioFxEq.ts",
+      "types": "./src/audioFxEq.ts"
+    },
+    "./audio-leveller": {
+      "bun": "./src/audioLeveller.ts",
+      "node": "./dist/audioLeveller.js",
+      "import": "./src/audioLeveller.ts",
+      "types": "./src/audioLeveller.ts"
+    },
+    "./audio-fx-presets": {
+      "bun": "./src/audioFxPresets.ts",
+      "node": "./dist/audioFxPresets.js",
+      "import": "./src/audioFxPresets.ts",
+      "types": "./src/audioFxPresets.ts"
+    },
     "./audio-fx-tail": {
       "bun": "./src/audio/audioFxTail.ts",
       "node": "./dist/audio/audioFxTail.js",
@@ -402,6 +432,26 @@
         "import": "./dist/audioFx.js",
         "types": "./dist/audioFx.d.ts"
       },
+      "./audio-fx-copy": {
+        "import": "./dist/audioFxCopy.js",
+        "types": "./dist/audioFxCopy.d.ts"
+      },
+      "./audio-fx-jobs": {
+        "import": "./dist/audioFxJobs.js",
+        "types": "./dist/audioFxJobs.d.ts"
+      },
+      "./audio-fx-eq": {
+        "import": "./dist/audioFxEq.js",
+        "types": "./dist/audioFxEq.d.ts"
+      },
+      "./audio-leveller": {
+        "import": "./dist/audioLeveller.js",
+        "types": "./dist/audioLeveller.d.ts"
+      },
+      "./audio-fx-presets": {
+        "import": "./dist/audioFxPresets.js",
+        "types": "./dist/audioFxPresets.d.ts"
+      },
       "./audio-fx-tail": {
         "import": "./dist/audio/audioFxTail.js",
         "types": "./dist/audio/audioFxTail.d.ts"
@@ -559,16 +609,16 @@
   },
   "scripts": {
     "build": "bun run build:hyperframes-runtime && bun run build:position-edits-render && bun run build:audio-fx-runtime && tsc && tsx scripts/rewrite-esm-extensions.ts",
-    "test": "bun run check:position-edits-render && vitest run",
+    "test": "bun run check:position-edits-render && bun run build:audio-fx-runtime && vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:runtime-coverage": "vitest run --coverage src/runtime",
     "typecheck": "tsc --noEmit && bun run typecheck:runtime",
     "typecheck:runtime": "tsc --noEmit -p tsconfig.runtime.json",
     "lint:runtime-preview-guards": "bun scripts/lint-runtime-preview-guards.ts",
-    "build:audio-fx-runtime": "tsx scripts/build-inline-artifact.ts audio-fx",
+    "build:audio-fx-runtime": "tsx scripts/build-audio-fx-runtime.ts",
     "build:hyperframes-runtime": "tsx scripts/build-hyperframes-runtime-artifact.ts",
-    "build:position-edits-render": "tsx scripts/build-inline-artifact.ts position-edits",
+    "build:position-edits-render": "tsx scripts/build-position-edits-render.ts",
     "check:position-edits-render": "bun run build:position-edits-render && git diff --exit-code -- src/generated/position-edits-render-inline.ts",
     "build:hyperframes-runtime:modular": "SANDBOX_RUNTIME_VARIANT=modular tsx scripts/build-hyperframes-runtime-artifact.ts",
     "build:hyperframe-runtime": "tsx scripts/build-hyperframes-runtime-artifact.ts",

packages/core/scripts/build-audio-fx-runtime.ts

@@ -0,0 +1,13 @@
+/** Build the injectable audio-FX runtime artifact from the canonical runtime. */
+
+import { buildInjectedArtifact } from "./buildInjectedArtifact.js";
+
+buildInjectedArtifact({
+  scriptUrl: import.meta.url,
+  entry: "stubs/audio-fx-runtime-entry.ts",
+  out: "audio-fx-runtime-inline.ts",
+  constName: "AUDIO_FX_RUNTIME_IIFE",
+  fnName: "getAudioFxRuntimeScript",
+  what: "audio-FX runtime IIFE",
+  event: "audio_fx_runtime_generated",
+});

packages/core/scripts/build-position-edits-render.ts

@@ -0,0 +1,13 @@
+/** Build the injectable position-edits render artifact from the canonical runtime. */
+
+import { buildInjectedArtifact } from "./buildInjectedArtifact.js";
+
+buildInjectedArtifact({
+  scriptUrl: import.meta.url,
+  entry: "stubs/position-edits-render-entry.ts",
+  out: "position-edits-render-inline.ts",
+  constName: "POSITION_EDITS_RENDER_IIFE",
+  fnName: "getPositionEditsRenderScript",
+  what: "position-edits render IIFE",
+  event: "position_edits_render_generated",
+});

packages/core/scripts/buildInjectedArtifact.ts

@@ -0,0 +1,78 @@
+/**
+ * Bundle a stub entry into an injectable IIFE, wrapped as a TypeScript constant.
+ *
+ * Two artifacts are built this way — the audio-FX runtime and the position-edits
+ * render — and the engine injects both into the headless browser as a script tag.
+ * They were two copies of this file differing in five names, which is a poor
+ * place for a divergence to hide: whichever copy stopped being edited would go on
+ * producing a subtly different artifact with nothing to say so.
+ */
+
+import { execFileSync } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildSync } from "esbuild";
+
+export interface InjectedArtifact {
+  /** The build script's own `import.meta.url`, so paths resolve beside it. */
+  scriptUrl: string;
+  /** Entry stub, relative to the package root. */
+  entry: string;
+  /** Output file name inside `src/generated`. */
+  out: string;
+  /** SCREAMING_CASE name for the string constant holding the IIFE. */
+  constName: string;
+  /** The accessor the rest of the codebase imports. */
+  fnName: string;
+  /** What that accessor returns, for its doc comment: "the pre-built X". */
+  what: string;
+  /** Structured log event name. */
+  event: string;
+}
+
+export function buildInjectedArtifact(spec: InjectedArtifact): void {
+  const scriptDir = dirname(fileURLToPath(spec.scriptUrl));
+  const scriptName = spec.scriptUrl.split("/").pop() ?? "";
+  const repoRoot = resolve(scriptDir, "..");
+  const entry = resolve(repoRoot, spec.entry);
+  const generatedDir = resolve(repoRoot, "src/generated");
+  const outPath = resolve(generatedDir, spec.out);
+
+  const result = buildSync({
+    entryPoints: [entry],
+    bundle: true,
+    write: false,
+    platform: "browser",
+    format: "iife",
+    target: ["es2020"],
+    minify: true,
+    legalComments: "none",
+  });
+  const iife = result.outputFiles[0]?.text ?? "";
+  if (!iife) throw new Error(`esbuild produced no output for ${spec.entry.split("/").pop()}`);
+
+  mkdirSync(generatedDir, { recursive: true });
+  writeFileSync(
+    outPath,
+    [
+      `// AUTO-GENERATED by scripts/${scriptName} - do not edit`,
+      `const ${spec.constName}: string = ${JSON.stringify(iife)};`,
+      "",
+      `/** Returns the pre-built ${spec.what} as a string constant. */`,
+      `export function ${spec.fnName}(): string {`,
+      `  return ${spec.constName};`,
+      "}",
+      "",
+    ].join("\n"),
+    "utf8",
+  );
+
+  try {
+    execFileSync("bun", ["x", "oxfmt", outPath], { stdio: "ignore" });
+  } catch {
+    // Formatting is best effort when the generator runs in a minimal environment.
+  }
+
+  console.log(JSON.stringify({ event: spec.event, outPath, bytes: iife.length }));
+}