@1agh/maude 0.40.0 → 0.42.0

package/apps/studio/exporters/html.ts

@@ -11,10 +11,11 @@ import { tmpdir } from 'node:os';
 import path from 'node:path';
 
 import JSZip from 'jszip';
-import { exportShimPath, resolveExportRuntime } from './_runtime.ts';
+import { exportShimPath, runShim } from './_runtime.ts';
 import {
   canvasShellUrl,
   type ExportContext,
+  type ExportHooks,
   type ExportOptions,
   type ExportResult,
 } from './index.ts';
@@ -27,7 +28,8 @@ async function captureHtml(
   target: Extract<Target, { kind: 'element' }>,
   ctx: ExportContext,
   outDir: string,
-  timeoutSec: number
+  timeoutSec: number,
+  hooks?: ExportHooks
 ): Promise<string[]> {
   const args = [
     HTML_PLAYWRIGHT,
@@ -46,29 +48,18 @@ async function captureHtml(
     if (target.widen) args.push('--widen-to-artboard', '1');
     args.push('--out', path.join(outDir, `${target.canvasSlug}.html`));
   }
-  const proc = Bun.spawn([resolveExportRuntime(), ...args], {
+  return runShim(args, {
     cwd: path.dirname(HTML_PLAYWRIGHT),
-    stdout: 'pipe',
-    stderr: 'pipe',
+    signal: hooks?.signal,
+    onProgress: hooks?.onProgress,
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-  ]);
-  const code = await proc.exited;
-  if (code !== 0) {
-    throw new Error(`_html-playwright exited ${code}: ${stderr.trim() || stdout.trim()}`);
-  }
-  return stdout
-    .split('\n')
-    .map((s) => s.trim())
-    .filter(Boolean);
 }
 
 export async function run(
   targets: Target[],
   options: ExportOptions,
-  ctx: ExportContext
+  ctx: ExportContext,
+  hooks?: ExportHooks
 ): Promise<ExportResult> {
   if (!targets.length) {
     return { filename: 'export.zip', contentType: 'application/zip', body: new Uint8Array(0) };
@@ -83,9 +74,10 @@ export async function run(
   const tmp = mkdtempSync(path.join(tmpdir(), 'maude-html-'));
   try {
     const written: string[] = [];
-    for (const t of elementTargets) {
-      const paths = await captureHtml(t, ctx, tmp, timeoutSec);
+    for (let i = 0; i < elementTargets.length; i += 1) {
+      const paths = await captureHtml(elementTargets[i], ctx, tmp, timeoutSec, hooks);
       written.push(...paths);
+      hooks?.onProgress?.({ current: i + 1, total: elementTargets.length });
     }
     if (!written.length) {
       return { filename: 'export.zip', contentType: 'application/zip', body: new Uint8Array(0) };

package/apps/studio/exporters/index.ts

@@ -74,8 +74,19 @@ export interface ExportResult {
   body: Uint8Array;
 }
 
+/** Progress + cancellation hooks threaded through to the shim-spawning layer. */
+export interface ExportHooks {
+  onProgress?: (update: { current: number; total: number }) => void;
+  signal?: AbortSignal;
+}
+
 export interface Adapter {
-  run(targets: Target[], options: ExportOptions, ctx: ExportContext): Promise<ExportResult>;
+  run(
+    targets: Target[],
+    options: ExportOptions,
+    ctx: ExportContext,
+    hooks?: ExportHooks
+  ): Promise<ExportResult>;
 }
 
 const REGISTRY: Record<Format, Adapter> = {
@@ -114,6 +125,7 @@ export async function runExport(args: {
   options: ExportOptions;
   resolve: Omit<ResolveScopeArgs, 'scope'>;
   ctx: ExportContext;
+  hooks?: ExportHooks;
 }): Promise<ExportResult> {
   // Thread the options bag into the resolver so submit-time selection /
   // active-artboard hints (DDR — selection-passthrough) win over the persisted
@@ -123,7 +135,7 @@ export async function runExport(args: {
   if (!adapter) {
     throw new Error(`unknown format: ${args.format}`);
   }
-  return adapter.run(targets, args.options, args.ctx);
+  return adapter.run(targets, args.options, args.ctx, args.hooks);
 }
 
 export type { Scope, Target };

package/apps/studio/exporters/jobs.ts

@@ -0,0 +1,334 @@
+// Background export job queue (feature-background-export-notification-center).
+//
+// Turns the previously-synchronous `POST /_api/export` into a backgroundable
+// operation: `enqueue()` returns immediately with a job id + a Promise that
+// resolves with the same `ExportResult` the old synchronous call produced, so
+// `/_api/export` stays byte-for-byte contract-unchanged (it just awaits the
+// Promise). `POST /_api/export-jobs` returns the id WITHOUT awaiting, and the
+// job progresses queued → running → done|failed in the background, emitting
+// `bus.emit('export:job', job)` on every transition so ws.ts can broadcast a
+// live snapshot to the notification center.
+//
+// Concurrency is capped by a small hand-rolled counting semaphore (same
+// "no new dependency" convention as `writeLocator()` in http.ts) so N
+// Playwright/Chromium-heavy renders don't all launch at once — MAUDE_EXPORT_
+// MAX_CONCURRENT (default 2) lets a quick PNG start while a slow PDF/video is
+// still running, without letting an unbounded number of Chromiums spawn.
+//
+// History persistence: the in-memory `jobs` Map IS the source of truth. The
+// on-disk `_export-history.json` ledger is re-derived from it (done/failed
+// jobs, newest-first, capped) and overwritten in one shot on every
+// completion — no read-modify-write, so concurrent completions can't drop
+// entries (the race the old api.ts loadExportHistory/appendExportHistory
+// pair had). The ledger is seeded from disk once at construction so history
+// survives a server restart even though job state itself doesn't.
+
+import { readFileSync } from 'node:fs';
+import { mkdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+
+import type { Bus } from '../context.ts';
+import {
+  type ExportContext,
+  type ExportOptions,
+  type ExportResult,
+  type Format,
+  runExport,
+  type Scope,
+} from './index.ts';
+import type { ResolveScopeArgs } from './scope.ts';
+
+/** Extended shape of the old Phase 6.5 T10 history entry — additive fields only. */
+export interface ExportHistoryEntry {
+  format: string;
+  scope: string;
+  options?: Record<string, unknown>;
+  filename: string;
+  at: string;
+  id?: string;
+  status?: 'done' | 'failed';
+  startedAt?: string;
+  finishedAt?: string;
+  error?: string;
+}
+
+export type ExportJobStatus = 'queued' | 'running' | 'done' | 'failed';
+
+export interface ExportJob {
+  id: string;
+  format: Format;
+  scope: Scope;
+  options: ExportOptions;
+  status: ExportJobStatus;
+  progress?: { current: number; total: number };
+  createdAt: string;
+  startedAt?: string;
+  finishedAt?: string;
+  filename?: string;
+  contentType?: string;
+  error?: string;
+}
+
+export interface EnqueueArgs {
+  format: Format;
+  scope: Scope;
+  options: ExportOptions;
+  resolve: Omit<ResolveScopeArgs, 'scope'>;
+  ctx: ExportContext;
+}
+
+export type DownloadResult =
+  | { ok: true; bytes: Uint8Array; filename: string; contentType: string }
+  | { ok: false; reason: 'missing' | 'not-done' };
+
+export interface ExportJobQueue {
+  enqueue(args: EnqueueArgs): { id: string; result: Promise<ExportResult> };
+  get(id: string): ExportJob | undefined;
+  list(): ExportJob[];
+  loadHistory(): ExportHistoryEntry[];
+  getBytes(id: string): Promise<DownloadResult>;
+}
+
+const HISTORY_DEPTH = 20;
+const MAX_JOB_AGE_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_JOB_TIMEOUT_MS = 5 * 60 * 1000;
+
+/**
+ * Security fan-out finding (defender, /flow:done) — MEDIUM: `enqueue()` had
+ * no cap on queued/running jobs, so a flood of `POST /_api/export-jobs`
+ * (unauthenticated same-origin-omitted-Origin callers pass `sameOriginWrite`)
+ * could grow the in-memory Map and fill `_export-jobs/` on disk unbounded —
+ * the old synchronous `/_api/export` had natural backpressure (one render at
+ * a time from the client's own perspective) that the background queue
+ * removed. `MAX_PENDING` bounds queued+running jobs; `enqueue()` throws
+ * `ExportQueueFullError` past it and http.ts maps that to 429.
+ */
+const MAX_PENDING = Math.max(1, Number(process.env.MAUDE_EXPORT_MAX_QUEUED) || 20);
+
+/** Thrown by `enqueue()` when `MAX_PENDING` queued/running jobs are already in flight. */
+export class ExportQueueFullError extends Error {
+  constructor() {
+    super('export queue is full — too many pending exports, try again shortly');
+    this.name = 'ExportQueueFullError';
+  }
+}
+
+/** Small counting semaphore — no new dependency, mirrors writeLocator()'s style. */
+class Semaphore {
+  private active = 0;
+  private readonly waiters: Array<() => void> = [];
+
+  constructor(private readonly max: number) {}
+
+  async acquire(): Promise<() => void> {
+    if (this.active >= this.max) {
+      await new Promise<void>((resolve) => this.waiters.push(resolve));
+    }
+    this.active += 1;
+    let released = false;
+    return () => {
+      if (released) return;
+      released = true;
+      this.active -= 1;
+      const next = this.waiters.shift();
+      if (next) next();
+    };
+  }
+}
+
+function isFinished(job: ExportJob): boolean {
+  return job.status === 'done' || job.status === 'failed';
+}
+
+export function createExportJobQueue(bus: Bus, designRoot: string): ExportJobQueue {
+  const jobsDir = path.join(designRoot, '_export-jobs');
+  const historyPath = path.join(designRoot, '_export-history.json');
+  const maxConcurrent = Math.max(1, Number(process.env.MAUDE_EXPORT_MAX_CONCURRENT) || 2);
+  const semaphore = new Semaphore(maxConcurrent);
+  const jobs = new Map<string, ExportJob>();
+
+  // Seed the ledger from disk ONCE — the only read of the history file. Every
+  // later persist derives fresh from `jobs` and overwrites; there is no
+  // subsequent read-then-write step, which is what eliminates the race.
+  try {
+    const raw = readFileSync(historyPath, 'utf8');
+    const parsed = JSON.parse(raw) as unknown;
+    if (Array.isArray(parsed)) {
+      for (const entry of parsed) {
+        if (!entry || typeof entry !== 'object') continue;
+        const e = entry as Record<string, unknown>;
+        const id = typeof e.id === 'string' && e.id ? e.id : crypto.randomUUID();
+        const finishedAt =
+          typeof e.finishedAt === 'string'
+            ? e.finishedAt
+            : typeof e.at === 'string'
+              ? e.at
+              : undefined;
+        jobs.set(id, {
+          id,
+          format: e.format as Format,
+          scope: e.scope as Scope,
+          options: (e.options as ExportOptions) ?? {},
+          status: e.status === 'failed' ? 'failed' : 'done',
+          createdAt: (e.startedAt as string) ?? finishedAt ?? new Date().toISOString(),
+          startedAt: e.startedAt as string | undefined,
+          finishedAt,
+          filename: e.filename as string | undefined,
+          error: e.error as string | undefined,
+        });
+      }
+    }
+  } catch {
+    /* no ledger yet, or unreadable — start empty */
+  }
+
+  // Orphaned `_export-jobs/*` dirs from a process that died mid-export — job
+  // state is in-memory only and doesn't survive a restart, so anything on
+  // disk from a prior run is stale. Best-effort, never blocks boot.
+  void rm(jobsDir, { recursive: true, force: true })
+    .catch(() => {})
+    .then(() => mkdir(jobsDir, { recursive: true }).catch(() => {}));
+
+  function emit(job: ExportJob): void {
+    bus.emit('export:job', { ...job });
+  }
+
+  function deriveHistory(): ExportHistoryEntry[] {
+    return Array.from(jobs.values())
+      .filter(isFinished)
+      .sort((a, b) => (b.finishedAt ?? '').localeCompare(a.finishedAt ?? ''))
+      .slice(0, HISTORY_DEPTH)
+      .map((j) => ({
+        id: j.id,
+        format: j.format,
+        scope: j.scope,
+        options: j.options,
+        filename: j.filename ?? '',
+        at: j.finishedAt ?? j.createdAt,
+        status: j.status as 'done' | 'failed',
+        startedAt: j.startedAt,
+        finishedAt: j.finishedAt,
+        error: j.error,
+      }));
+  }
+
+  async function persistAndEvict(): Promise<void> {
+    const history = deriveHistory();
+    await Bun.write(historyPath, JSON.stringify(history, null, 2));
+
+    // Evict bytes (+ the in-memory record) for anything that rolled past the
+    // cap, or aged out, whichever comes first.
+    const finished = Array.from(jobs.values())
+      .filter(isFinished)
+      .sort((a, b) => (b.finishedAt ?? '').localeCompare(a.finishedAt ?? ''));
+    const now = Date.now();
+    const stale = finished.filter((j, i) => {
+      if (i >= HISTORY_DEPTH) return true;
+      const finishedAt = j.finishedAt ? Date.parse(j.finishedAt) : Number.NaN;
+      return Number.isFinite(finishedAt) && now - finishedAt > MAX_JOB_AGE_MS;
+    });
+    for (const job of stale) {
+      jobs.delete(job.id);
+      await rm(path.join(jobsDir, job.id), { recursive: true, force: true }).catch(() => {});
+    }
+  }
+
+  function enqueue(args: EnqueueArgs): { id: string; result: Promise<ExportResult> } {
+    let pending = 0;
+    for (const job of jobs.values()) {
+      if (job.status === 'queued' || job.status === 'running') pending += 1;
+    }
+    if (pending >= MAX_PENDING) throw new ExportQueueFullError();
+
+    const id = crypto.randomUUID();
+    const job: ExportJob = {
+      id,
+      format: args.format,
+      scope: args.scope,
+      options: args.options,
+      status: 'queued',
+      createdAt: new Date().toISOString(),
+    };
+    jobs.set(id, job);
+    emit(job);
+
+    const controller = new AbortController();
+
+    const result = (async (): Promise<ExportResult> => {
+      const release = await semaphore.acquire();
+      // Started here, not at enqueue — the timeout bounds RENDER time (the
+      // intent), not queue-wait time. A job can legitimately sit `queued`
+      // behind MAUDE_EXPORT_MAX_CONCURRENT other jobs for longer than
+      // DEFAULT_JOB_TIMEOUT_MS; arming the timer before the semaphore
+      // resolves would abort it before it ever ran (code-review finding,
+      // /flow:done).
+      const timer = setTimeout(() => controller.abort(), DEFAULT_JOB_TIMEOUT_MS);
+      try {
+        job.status = 'running';
+        job.startedAt = new Date().toISOString();
+        emit(job);
+
+        const res = await runExport({
+          format: args.format,
+          scope: args.scope,
+          options: args.options,
+          resolve: args.resolve,
+          ctx: args.ctx,
+          hooks: {
+            signal: controller.signal,
+            onProgress: (update) => {
+              job.progress = update;
+              emit(job);
+            },
+          },
+        });
+
+        job.status = 'done';
+        job.finishedAt = new Date().toISOString();
+        job.filename = res.filename;
+        job.contentType = res.contentType;
+        if (res.body.byteLength) {
+          const dir = path.join(jobsDir, id);
+          await mkdir(dir, { recursive: true });
+          await Bun.write(path.join(dir, res.filename), res.body);
+        }
+        emit(job);
+        await persistAndEvict();
+        return res;
+      } catch (err) {
+        job.status = 'failed';
+        job.finishedAt = new Date().toISOString();
+        job.error = err instanceof Error ? err.message : String(err);
+        emit(job);
+        await persistAndEvict();
+        throw err;
+      } finally {
+        clearTimeout(timer);
+        release();
+      }
+    })();
+
+    return { id, result };
+  }
+
+  return {
+    enqueue,
+    get: (id) => jobs.get(id),
+    list: () => Array.from(jobs.values()).sort((a, b) => b.createdAt.localeCompare(a.createdAt)),
+    loadHistory: deriveHistory,
+    async getBytes(id) {
+      const job = jobs.get(id);
+      if (!job) return { ok: false, reason: 'missing' };
+      if (job.status !== 'done') return { ok: false, reason: 'not-done' };
+      if (!job.filename) return { ok: false, reason: 'missing' };
+      const file = Bun.file(path.join(jobsDir, id, job.filename));
+      if (!(await file.exists())) return { ok: false, reason: 'missing' };
+      return {
+        ok: true,
+        bytes: new Uint8Array(await file.arrayBuffer()),
+        filename: job.filename,
+        contentType: job.contentType ?? 'application/octet-stream',
+      };
+    },
+  };
+}

package/apps/studio/exporters/pdf.ts

@@ -13,10 +13,11 @@ import { tmpdir } from 'node:os';
 import path from 'node:path';
 
 import { PDFDocument } from 'pdf-lib';
-import { exportShimPath, resolveExportRuntime } from './_runtime.ts';
+import { exportShimPath, runShim } from './_runtime.ts';
 import {
   canvasShellUrl,
   type ExportContext,
+  type ExportHooks,
   type ExportOptions,
   type ExportResult,
 } from './index.ts';
@@ -29,7 +30,8 @@ async function capturePdf(
   target: Extract<Target, { kind: 'element' }>,
   ctx: ExportContext,
   outDir: string,
-  timeoutSec: number
+  timeoutSec: number,
+  hooks?: ExportHooks
 ): Promise<string[]> {
   const args = [
     PDF_PLAYWRIGHT,
@@ -49,29 +51,18 @@ async function capturePdf(
     args.push('--out', path.join(outDir, `${target.canvasSlug}.pdf`));
   }
 
-  const proc = Bun.spawn([resolveExportRuntime(), ...args], {
+  return runShim(args, {
     cwd: path.dirname(PDF_PLAYWRIGHT),
-    stdout: 'pipe',
-    stderr: 'pipe',
+    signal: hooks?.signal,
+    onProgress: hooks?.onProgress,
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-  ]);
-  const code = await proc.exited;
-  if (code !== 0) {
-    throw new Error(`_pdf-playwright exited ${code}: ${stderr.trim() || stdout.trim()}`);
-  }
-  return stdout
-    .split('\n')
-    .map((s) => s.trim())
-    .filter(Boolean);
 }
 
 export async function run(
   targets: Target[],
   options: ExportOptions,
-  ctx: ExportContext
+  ctx: ExportContext,
+  hooks?: ExportHooks
 ): Promise<ExportResult> {
   if (!targets.length) {
     return { filename: 'export.pdf', contentType: 'application/pdf', body: new Uint8Array(0) };
@@ -86,9 +77,14 @@ export async function run(
   const tmp = mkdtempSync(path.join(tmpdir(), 'maude-pdf-'));
   try {
     const written: string[] = [];
-    for (const t of elementTargets) {
-      const paths = await capturePdf(t, ctx, tmp, timeoutSec);
+    for (let i = 0; i < elementTargets.length; i += 1) {
+      const paths = await capturePdf(elementTargets[i], ctx, tmp, timeoutSec, hooks);
       written.push(...paths);
+      // Outer-loop tick (N separate top-level Targets — rare). The granular
+      // "K of M artboards" signal for canvas-as-separate comes from the
+      // shim's own MAUDE_PROGRESS lines via spawnShim's onProgress inside
+      // capturePdf, above — both funnel into the same hooks.onProgress.
+      hooks?.onProgress?.({ current: i + 1, total: elementTargets.length });
     }
     if (!written.length) {
       return { filename: 'export.pdf', contentType: 'application/pdf', body: new Uint8Array(0) };

package/apps/studio/exporters/png.ts

@@ -12,10 +12,11 @@ import { tmpdir } from 'node:os';
 import path from 'node:path';
 
 import JSZip from 'jszip';
-import { exportShimPath, resolveExportRuntime } from './_runtime.ts';
+import { exportShimPath, runShim } from './_runtime.ts';
 import {
   canvasShellUrl,
   type ExportContext,
+  type ExportHooks,
   type ExportOptions,
   type ExportResult,
 } from './index.ts';
@@ -45,7 +46,8 @@ async function captureElement(
   target: Extract<Target, { kind: 'element' }>,
   ctx: ExportContext,
   outDir: string,
-  options: CaptureOptions
+  options: CaptureOptions,
+  hooks?: ExportHooks
 ): Promise<string[]> {
   const args = [
     PNG_PLAYWRIGHT,
@@ -68,23 +70,11 @@ async function captureElement(
     if (target.widen) args.push('--widen-to-artboard', '1');
     args.push('--out', path.join(outDir, `${target.canvasSlug}.png`));
   }
-  const proc = Bun.spawn([resolveExportRuntime(), ...args], {
+  return runShim(args, {
     cwd: path.dirname(PNG_PLAYWRIGHT),
-    stdout: 'pipe',
-    stderr: 'pipe',
+    signal: hooks?.signal,
+    onProgress: hooks?.onProgress,
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-  ]);
-  const code = await proc.exited;
-  if (code !== 0) {
-    throw new Error(`_png-playwright exited ${code}: ${stderr.trim() || stdout.trim()}`);
-  }
-  return stdout
-    .split('\n')
-    .map((s) => s.trim())
-    .filter(Boolean);
 }
 
 function readBytes(paths: string[]): Array<{ name: string; bytes: Uint8Array }> {
@@ -105,7 +95,8 @@ async function bundleZip(entries: Array<{ name: string; bytes: Uint8Array }>): P
 export async function run(
   targets: Target[],
   options: ExportOptions,
-  ctx: ExportContext
+  ctx: ExportContext,
+  hooks?: ExportHooks
 ): Promise<ExportResult> {
   if (!targets.length) {
     return { filename: 'export.png', contentType: 'image/png', body: new Uint8Array(0) };
@@ -128,9 +119,10 @@ export async function run(
 
   try {
     const written: string[] = [];
-    for (const t of elementTargets) {
-      const paths = await captureElement(t, ctx, tmp, captureOpts);
+    for (let i = 0; i < elementTargets.length; i += 1) {
+      const paths = await captureElement(elementTargets[i], ctx, tmp, captureOpts, hooks);
       written.push(...paths);
+      hooks?.onProgress?.({ current: i + 1, total: elementTargets.length });
     }
     const entries = readBytes(written);
 

package/apps/studio/exporters/pptx.ts

@@ -27,10 +27,11 @@ import path from 'node:path';
 import PptxGenJS from 'pptxgenjs';
 
 import { getBrowserBundle } from './_browser-bundles.ts';
-import { exportShimPath, resolveExportRuntime } from './_runtime.ts';
+import { exportShimPath, runShim } from './_runtime.ts';
 import {
   canvasShellUrl,
   type ExportContext,
+  type ExportHooks,
   type ExportOptions,
   type ExportResult,
 } from './index.ts';
@@ -51,25 +52,13 @@ function isElementTarget(t: Target): t is ElementTarget {
   return t.kind === 'element';
 }
 
-/** Spawn a playwright shim via a resolved runtime, returning the written file paths (stdout). */
-async function spawnShim(args: string[]): Promise<string[]> {
-  const proc = Bun.spawn([resolveExportRuntime(), ...args], {
+/** Spawn a playwright shim via the shared runtime, returning the written file paths (stdout). */
+function spawnPlaywrightShim(args: string[], hooks?: ExportHooks): Promise<string[]> {
+  return runShim(args, {
     cwd: path.dirname(args[0]),
-    stdout: 'pipe',
-    stderr: 'pipe',
+    signal: hooks?.signal,
+    onProgress: hooks?.onProgress,
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text(),
-  ]);
-  const code = await proc.exited;
-  if (code !== 0) {
-    throw new Error(`${path.basename(args[0])} exited ${code}: ${stderr.trim() || stdout.trim()}`);
-  }
-  return stdout
-    .split('\n')
-    .map((s) => s.trim())
-    .filter(Boolean);
 }
 
 // ─── SVG pre-processing (the fix that makes svg2pptx faithful) ────────────────
@@ -324,7 +313,8 @@ async function buildPngDeck(pngPaths: string[]): Promise<Uint8Array> {
 export async function run(
   targets: Target[],
   options: ExportOptions,
-  ctx: ExportContext
+  ctx: ExportContext,
+  hooks?: ExportHooks
 ): Promise<ExportResult> {
   const empty: ExportResult = {
     filename: 'export.pptx',
@@ -352,10 +342,15 @@ export async function run(
       try {
         const bundle = await getBrowserBundle('dom-to-svg', 'domToSvg');
         const svgFiles: string[] = [];
-        for (const t of elementTargets) {
+        for (let i = 0; i < elementTargets.length; i += 1) {
+          const t = elementTargets[i];
           svgFiles.push(
-            ...(await spawnShim(svgArgsFor(t, canvasShellUrl(ctx, t.file), svgDir, bundle)))
+            ...(await spawnPlaywrightShim(
+              svgArgsFor(t, canvasShellUrl(ctx, t.file), svgDir, bundle),
+              hooks
+            ))
           );
+          hooks?.onProgress?.({ current: i + 1, total: elementTargets.length });
         }
         if (!svgFiles.length) return empty;
         const deckBuffers: Uint8Array[] = [];
@@ -382,8 +377,12 @@ export async function run(
 
     // PNG fallback (faithful, universal, Canva-safe, not editable).
     const pngFiles: string[] = [];
-    for (const t of elementTargets) {
-      pngFiles.push(...(await spawnShim(pngArgsFor(t, canvasShellUrl(ctx, t.file), pngDir))));
+    for (let i = 0; i < elementTargets.length; i += 1) {
+      const t = elementTargets[i];
+      pngFiles.push(
+        ...(await spawnPlaywrightShim(pngArgsFor(t, canvasShellUrl(ctx, t.file), pngDir), hooks))
+      );
+      hooks?.onProgress?.({ current: i + 1, total: elementTargets.length });
     }
     if (!pngFiles.length) return empty;
     const body = await buildPngDeck(pngFiles);

package/apps/studio/exporters/scope.ts

@@ -115,6 +115,7 @@ const RAW_EXCLUDES = new Set([
   '_server.json',
   '_active.json',
   '_export-history.json',
+  '_export-jobs',
   '_history',
   '_comments',
   '_canvas-state',