@1agh/maude 1.0.11 → 1.3.0

package/apps/studio/test/exporters/png.test.ts

@@ -1,103 +0,0 @@
-// Phase 6.5 T2 — PNG adapter unit tests.
-//
-// Skips the real `screenshot.sh` invocation — that path lands as a scenario
-// under `.ai/scenarios/export-from-toolbar/` (T2 plan §Validate). Here we
-// cover the contract-shape branches:
-//   - empty target list → zero-byte placeholder
-//   - file-tree-only targets → throws (PNG adapter rejects)
-
-import { describe, expect, test } from 'bun:test';
-
-import { clampDpi, clampScale, resolveDeviceScale, run } from '../../exporters/png.ts';
-
-const CTX = {
-  designRoot: '/tmp/.design',
-  repoRoot: '/tmp',
-  serverOrigin: 'http://localhost:0',
-};
-
-describe('png adapter — contract', () => {
-  test('empty targets → zero-byte PNG placeholder', async () => {
-    const r = await run([], {}, CTX);
-    expect(r.contentType).toBe('image/png');
-    expect(r.body.byteLength).toBe(0);
-    expect(r.filename.endsWith('.png')).toBe(true);
-  });
-
-  test('file-tree targets → throws (PNG cannot render a project)', async () => {
-    await expect(run([{ kind: 'file-tree', paths: ['ui/Home.tsx'] }], {}, CTX)).rejects.toThrow(
-      /element targets/i
-    );
-  });
-});
-
-describe('png clampScale — size presets (item 1)', () => {
-  test('defaults to 2× when scale is absent / invalid', () => {
-    expect(clampScale(undefined)).toBe(2);
-    expect(clampScale(null)).toBe(2);
-    expect(clampScale('nonsense')).toBe(2);
-    expect(clampScale(0)).toBe(2);
-  });
-
-  test('honours the 1×/2×/3× presets (number or string)', () => {
-    expect(clampScale(1)).toBe(1);
-    expect(clampScale(2)).toBe(2);
-    expect(clampScale(3)).toBe(3);
-    expect(clampScale('1')).toBe(1);
-    expect(clampScale('3')).toBe(3);
-  });
-
-  test('clamps out-of-range / fractional values to the preset set', () => {
-    expect(clampScale(4)).toBe(2); // above max → safe default
-    expect(clampScale(2.6)).toBe(3); // rounds to nearest preset
-    expect(clampScale(1.2)).toBe(1);
-  });
-});
-
-describe('png clampDpi — feature-2-print-artboards T4', () => {
-  test('undefined/null → undefined (falls back to scale)', () => {
-    expect(clampDpi(undefined)).toBeUndefined();
-    expect(clampDpi(null)).toBeUndefined();
-  });
-
-  test('non-numeric → undefined', () => {
-    expect(clampDpi('nonsense')).toBeUndefined();
-  });
-
-  test('exact presets pass through', () => {
-    expect(clampDpi(96)).toBe(96);
-    expect(clampDpi(150)).toBe(150);
-    expect(clampDpi(300)).toBe(300);
-    expect(clampDpi(600)).toBe(600);
-  });
-
-  test('snaps to the nearest preset', () => {
-    expect(clampDpi(200)).toBe(150);
-    expect(clampDpi(250)).toBe(300);
-    expect(clampDpi(1000)).toBe(600);
-    expect(clampDpi(0)).toBe(96);
-  });
-});
-
-describe('png resolveDeviceScale — dpi wins over scale', () => {
-  test('dpi=300 → 3.125× (300/96)', () => {
-    expect(resolveDeviceScale({ dpi: 300 })).toBeCloseTo(300 / 96, 10);
-  });
-
-  test('dpi=600 → 6.25× (300dpi ceiling raise, item T4)', () => {
-    expect(resolveDeviceScale({ dpi: 600 })).toBeCloseTo(600 / 96, 10);
-  });
-
-  test('dpi=96 → 1× (no-op)', () => {
-    expect(resolveDeviceScale({ dpi: 96 })).toBeCloseTo(1, 10);
-  });
-
-  test('no dpi → falls back to the legacy scale preset', () => {
-    expect(resolveDeviceScale({ scale: 3 })).toBe(3);
-    expect(resolveDeviceScale({})).toBe(2); // clampScale default
-  });
-
-  test('dpi present but not a number → falls back to scale', () => {
-    expect(resolveDeviceScale({ dpi: 'nope', scale: 1 })).toBe(1);
-  });
-});

package/apps/studio/test/exporters/pptx-deck.test.ts

@@ -1,112 +0,0 @@
-// PPTX adapter — native (svg2pptx) pipeline units (export-pipeline-fixes item 6).
-//
-// Covers the two pure pieces that make svg2pptx faithful + the deck merge:
-//   - preprocessSvg: lift tspan x/y onto <text> + collapse the font stack.
-//   - mergeDecks: combine N single-slide svg2pptx decks into one valid package.
-// The svg2pptx conversion itself (Python) + live render are integration-shape.
-
-import { describe, expect, test } from 'bun:test';
-import JSZip from 'jszip';
-
-import { mergeDecks, preprocessSvg } from '../../exporters/pptx.ts';
-
-describe('preprocessSvg', () => {
-  test('lifts the first tspan x/y onto a <text> that lacks them', () => {
-    const svg = `<svg><text fill="rgb(0,0,0)"><tspan x="33" y="65.5">Hi</tspan></text></svg>`;
-    const out = preprocessSvg(svg);
-    // svg2pptx reads text@x/y — they must now be present (was the 0,0 pile-up).
-    expect(out).toMatch(/<text x="33" y="65\.5"/);
-  });
-
-  test('collapses a CSS font-family stack to its first concrete name', () => {
-    const svg = `<text font-family="&quot;Berkeley Mono&quot;, TX-02, &quot;JetBrains Mono&quot;, monospace"><tspan x="1" y="2">x</tspan></text>`;
-    const out = preprocessSvg(svg);
-    // A PPTX typeface is a single font name, not a fallback list.
-    expect(out).toContain('font-family="Berkeley Mono"');
-    expect(out).not.toContain('TX-02');
-  });
-
-  test('does not clobber a <text> that already has its own x/y', () => {
-    const svg = `<text x="10" y="20"><tspan x="99" y="88">x</tspan></text>`;
-    const out = preprocessSvg(svg);
-    expect(out).toContain('<text x="10" y="20"');
-    expect(out).not.toContain('<text x="99"');
-  });
-});
-
-const REL_NS = 'http://schemas.openxmlformats.org/package/2006/relationships';
-const OD_REL = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
-const CT_NS = 'http://schemas.openxmlformats.org/package/2006/content-types';
-const SLIDE_CT = 'application/vnd.openxmlformats-officedocument.presentationml.slide+xml';
-
-/** Minimal single-slide deck shaped like svg2pptx output (native, no media). */
-async function singleSlideDeck(): Promise<Uint8Array> {
-  const zip = new JSZip();
-  zip.file(
-    '[Content_Types].xml',
-    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="${CT_NS}"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/ppt/presentation.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml"/><Override PartName="/ppt/slideMasters/slideMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml"/><Override PartName="/ppt/slides/slide1.xml" ContentType="${SLIDE_CT}"/></Types>`
-  );
-  zip.file(
-    'ppt/presentation.xml',
-    '<?xml version="1.0"?><p:presentation xmlns:p="x" xmlns:r="y"><p:sldMasterIdLst><p:sldMasterId id="1" r:id="rId1"/></p:sldMasterIdLst><p:sldIdLst><p:sldId id="256" r:id="rId2"/></p:sldIdLst></p:presentation>'
-  );
-  zip.file(
-    'ppt/_rels/presentation.xml.rels',
-    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${REL_NS}"><Relationship Id="rId1" Type="${OD_REL}/slideMaster" Target="slideMasters/slideMaster1.xml"/><Relationship Id="rId2" Type="${OD_REL}/slide" Target="slides/slide1.xml"/></Relationships>`
-  );
-  zip.file('ppt/slides/slide1.xml', '<?xml version="1.0"?><p:sld xmlns:p="x"/>');
-  zip.file(
-    'ppt/slides/_rels/slide1.xml.rels',
-    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${REL_NS}"><Relationship Id="rId1" Type="${OD_REL}/slideLayout" Target="../slideLayouts/slideLayout1.xml"/></Relationships>`
-  );
-  zip.file('ppt/slideMasters/slideMaster1.xml', '<?xml version="1.0"?><p:sldMaster xmlns:p="x"/>');
-  zip.file('ppt/slideLayouts/slideLayout1.xml', '<?xml version="1.0"?><p:sldLayout xmlns:p="x"/>');
-  return zip.generateAsync({ type: 'uint8array' });
-}
-
-describe('mergeDecks — combine svg2pptx single-slide decks', () => {
-  test('single deck passes through', async () => {
-    const d = await singleSlideDeck();
-    const merged = await mergeDecks([d]);
-    expect(merged.byteLength).toBe(d.byteLength);
-  });
-
-  test('three decks → one valid package, all refs + Content-Types resolve', async () => {
-    const decks = await Promise.all([singleSlideDeck(), singleSlideDeck(), singleSlideDeck()]);
-    const merged = await mergeDecks(decks);
-    const zip = await JSZip.loadAsync(merged);
-    const parts = new Set(Object.keys(zip.files).filter((n) => !n.endsWith('/')));
-
-    // 3 contiguous slides; no 4th.
-    for (const n of [1, 2, 3]) expect(parts.has(`ppt/slides/slide${n}.xml`)).toBe(true);
-    expect(parts.has('ppt/slides/slide4.xml')).toBe(false);
-
-    // presentation.xml lists 3 slides; its rels keep the slideMaster (the
-    // "unopenable" regression) + carry 3 slide rels.
-    const pres = (await zip.file('ppt/presentation.xml')?.async('string')) ?? '';
-    expect((pres.match(/<p:sldId /g) ?? []).length).toBe(3);
-    const prels = (await zip.file('ppt/_rels/presentation.xml.rels')?.async('string')) ?? '';
-    expect(prels).toContain('Target="slideMasters/slideMaster1.xml"');
-    expect((prels.match(/Type="[^"]*\/relationships\/slide"/g) ?? []).length).toBe(3);
-
-    // Every rels Target resolves.
-    for (const rf of [...parts].filter((p) => p.endsWith('.rels'))) {
-      const xml = (await zip.file(rf)?.async('string')) ?? '';
-      const baseDir = rf.replace(/_rels\/[^/]+$/, '');
-      for (const rel of xml.matchAll(/<Relationship\b[^>]*\/>/g)) {
-        if (/TargetMode="External"/.test(rel[0])) continue;
-        const tgt = /Target="([^"]+)"/.exec(rel[0])?.[1];
-        if (!tgt) continue;
-        const resolved = new URL(tgt, `file:///${baseDir}`).pathname.replace(/^\//, '');
-        expect(parts.has(resolved)).toBe(true);
-      }
-    }
-
-    // Every Content-Types Override resolves; exactly 3 slide overrides.
-    const ct = (await zip.file('[Content_Types].xml')?.async('string')) ?? '';
-    for (const o of ct.matchAll(/<Override\s+PartName="([^"]+)"/g)) {
-      expect(parts.has(o[1].replace(/^\//, ''))).toBe(true);
-    }
-    expect((ct.match(/PartName="\/ppt\/slides\/slide\d+\.xml"/g) ?? []).length).toBe(3);
-  });
-});

package/apps/studio/test/exporters/pptx.test.ts

@@ -1,31 +0,0 @@
-// Phase 6.5 T6b — PPTX adapter contract.
-//
-// dom-to-pptx runs inside playwright + the headless browser; real conversion
-// is integration-shape (covered by the export scenario). Here we cover empty
-// targets + file-tree rejection so the API surface stays guarded.
-
-import { describe, expect, test } from 'bun:test';
-
-import { run } from '../../exporters/pptx.ts';
-
-const CTX = {
-  designRoot: '/tmp/.design',
-  repoRoot: '/tmp',
-  serverOrigin: 'http://localhost:0',
-};
-
-describe('pptx adapter — contract', () => {
-  test('empty targets → zero-byte PPTX placeholder', async () => {
-    const r = await run([], {}, CTX);
-    expect(r.contentType).toBe(
-      'application/vnd.openxmlformats-officedocument.presentationml.presentation'
-    );
-    expect(r.body.byteLength).toBe(0);
-  });
-
-  test('file-tree targets → throws', async () => {
-    await expect(run([{ kind: 'file-tree', paths: ['ui/Home.tsx'] }], {}, CTX)).rejects.toThrow(
-      /element targets/i
-    );
-  });
-});

package/apps/studio/test/exporters/pw-launch.test.ts

@@ -1,49 +0,0 @@
-// Unit cover for the shared Chromium launcher's error mapping. The launch path
-// itself is integration-shape (needs a real browser); here we pin the pure
-// classifier + the user-facing contract so a regression can't silently turn the
-// "browser not installed" 500 back into an opaque stack trace.
-//
-// Regression guard for `.ai/logs/rca/issue-nefunguji-exporty.md`.
-
-import { describe, expect, test } from 'bun:test';
-
-import { INSTALL_HINT, isMissingBrowserError, NO_BROWSER_EXIT } from '../../bin/_pw-launch.mjs';
-
-describe('_pw-launch — missing-browser classifier', () => {
-  test('matches the real Playwright "Executable doesn\'t exist" message', () => {
-    const real =
-      "browserType.launch: Executable doesn't exist at " +
-      '/Users/x/Library/Caches/ms-playwright/chromium_headless_shell-1223/' +
-      'chrome-headless-shell-mac-arm64/chrome-headless-shell\n' +
-      '╔════════════════════════════════════════════════════════════╗';
-    expect(isMissingBrowserError(real)).toBe(true);
-  });
-
-  test('matches the "please run … to download" + "playwright install" variants', () => {
-    expect(isMissingBrowserError('Please run the following command to download new browsers')).toBe(
-      true
-    );
-    expect(
-      isMissingBrowserError('Looks like Playwright was just installed... npx playwright install')
-    ).toBe(true);
-  });
-
-  test('does NOT match unrelated launch failures (preserve real diagnostics)', () => {
-    expect(isMissingBrowserError('Target page, context or browser has been closed')).toBe(false);
-    expect(isMissingBrowserError('connect ECONNREFUSED 127.0.0.1:9222')).toBe(false);
-    expect(isMissingBrowserError('Timeout 30000ms exceeded')).toBe(false);
-    expect(isMissingBrowserError('')).toBe(false);
-    expect(isMissingBrowserError(null)).toBe(false);
-    expect(isMissingBrowserError(undefined)).toBe(false);
-  });
-});
-
-describe('_pw-launch — user-facing contract', () => {
-  test('INSTALL_HINT is the copy-pasteable remediation', () => {
-    expect(INSTALL_HINT).toContain('npx playwright install chromium');
-  });
-
-  test('NO_BROWSER_EXIT is a distinct non-zero code', () => {
-    expect(NO_BROWSER_EXIT).toBeGreaterThan(0);
-  });
-});

package/apps/studio/test/exporters/runtime.test.ts

@@ -1,59 +0,0 @@
-// Regression tests for exporters/_runtime.ts — the shared shim-path + runtime
-// resolver behind the desktop-export fix (RCA issue-desktop-export-failures).
-//
-// Guards the two defects the render exporters shipped with:
-//   1. shim paths must derive from DEV_SERVER_ROOT (paths.ts), NEVER a virtual
-//      `/$bunfs/root` (DDR-045).
-//   2. the JS runtime must be resolved (not a hardcoded `'node'`), with an
-//      actionable throw when none is on PATH.
-
-import { afterEach, describe, expect, test } from 'bun:test';
-import { EXPORT_SHIM_DIR, exportShimPath, resolveExportRuntime } from '../../exporters/_runtime.ts';
-import { DEV_SERVER_ROOT } from '../../paths.ts';
-
-const ORIGINAL_PATH = process.env.PATH;
-const ORIGINAL_RUNTIME = process.env.MAUDE_EXPORT_RUNTIME;
-
-afterEach(() => {
-  // Restore any env mutated by a test (each bun:test file is its own process,
-  // but tests within it share env — keep them isolated).
-  if (ORIGINAL_PATH === undefined) delete process.env.PATH;
-  else process.env.PATH = ORIGINAL_PATH;
-  if (ORIGINAL_RUNTIME === undefined) delete process.env.MAUDE_EXPORT_RUNTIME;
-  else process.env.MAUDE_EXPORT_RUNTIME = ORIGINAL_RUNTIME;
-});
-
-describe('exporters/_runtime — shim paths (DDR-045)', () => {
-  test('EXPORT_SHIM_DIR is <DEV_SERVER_ROOT>/bin and never virtual /$bunfs', () => {
-    expect(EXPORT_SHIM_DIR).toBe(`${DEV_SERVER_ROOT}/bin`);
-    expect(EXPORT_SHIM_DIR).not.toContain('$bunfs');
-    expect(EXPORT_SHIM_DIR).not.toContain('~BUN');
-  });
-
-  test('exportShimPath resolves a real disk path under the shim dir', () => {
-    const p = exportShimPath('_png-playwright.mjs');
-    expect(p).toBe(`${DEV_SERVER_ROOT}/bin/_png-playwright.mjs`);
-    expect(p).not.toContain('$bunfs');
-  });
-});
-
-describe('exporters/_runtime — runtime ladder', () => {
-  test('honors the MAUDE_EXPORT_RUNTIME override', () => {
-    process.env.MAUDE_EXPORT_RUNTIME = '/opt/custom/bin/node';
-    expect(resolveExportRuntime()).toBe('/opt/custom/bin/node');
-  });
-
-  test('resolves an on-PATH runtime when no override is set', () => {
-    delete process.env.MAUDE_EXPORT_RUNTIME;
-    // The test host has bun (and usually node) on PATH → a truthy absolute path.
-    const runtime = resolveExportRuntime();
-    expect(runtime).toBeTruthy();
-    expect(runtime).not.toBe('node'); // resolved to an absolute path, not the bare name
-  });
-
-  test('throws an actionable error when no node/bun runtime is reachable', () => {
-    delete process.env.MAUDE_EXPORT_RUNTIME;
-    process.env.PATH = '/nonexistent-maude-export-runtime-probe';
-    expect(() => resolveExportRuntime()).toThrow(/render export needs a JS runtime/i);
-  });
-});

package/apps/studio/test/exporters/scope.test.ts

@@ -1,292 +0,0 @@
-// Phase 6.5 T1 — scope resolver unit tests.
-//
-// Pure-function coverage: each of the four scope branches against synthetic
-// `_active.json` shapes. `project-raw` exercises the fs walk inside a
-// throwaway temp dir; the other three branches don't touch disk.
-
-import { describe, expect, test } from 'bun:test';
-import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-
-import { type ActiveJsonShape, resolveScope } from '../../exporters/scope.ts';
-
-function emptyActive(): ActiveJsonShape {
-  return { active: null, selected: null };
-}
-
-function activeOn(file: string): ActiveJsonShape {
-  return { active: file, selected: null };
-}
-
-function activeWithSelection(file: string, selector: string): ActiveJsonShape {
-  return { active: file, selected: { file, selector } };
-}
-
-describe('resolveScope — selection', () => {
-  test('returns 1 element target when a selection is captured', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      activeJson: activeWithSelection('.design/ui/Home.tsx', '#hero > h1'),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    expect(t.kind).toBe('element');
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('#hero > h1');
-      expect(t.canvasSlug).toBe('ui-home');
-      expect(t.file).toBe('.design/ui/Home.tsx');
-    }
-  });
-
-  test('falls back to artboard scope when no selection is captured', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    expect(t.kind).toBe('element');
-    if (t.kind === 'element') {
-      // Artboard fallback default selector.
-      expect(t.cssPath).toBe('[data-dc-screen]:first-of-type');
-      expect(t.multi).toBeUndefined();
-    }
-  });
-
-  test('returns no targets when nothing is open', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      activeJson: emptyActive(),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toEqual([]);
-  });
-
-  // Items 3 — submit-time selection snapshot + no hard-widen.
-  test('prefers the options.selection hint over the persisted _active.json', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      // Persisted selection is stale/cleared; the live snapshot wins.
-      activeJson: activeWithSelection('.design/ui/Home.tsx', '#stale'),
-      designRoot: '/abs/.design',
-      options: { selection: { selector: '#hero .live', file: '.design/ui/Home.tsx' } },
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('#hero .live');
-      // selection scope must NOT widen to the artboard (item 3 root cause #2).
-      expect(t.widen).toBe(false);
-    }
-  });
-
-  test('recovers the live selection when _active.json.selected was cleared', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      activeJson: activeOn('.design/ui/Home.tsx'), // selected: null
-      designRoot: '/abs/.design',
-      options: { selection: { selector: '.card' } },
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('.card');
-      expect(t.widen).toBe(false);
-    }
-  });
-
-  test('a captured selection sets widen=false (exact element, no artboard)', async () => {
-    const targets = await resolveScope({
-      scope: 'selection',
-      activeJson: activeWithSelection('.design/ui/Home.tsx', '#hero > h1'),
-      designRoot: '/abs/.design',
-    });
-    if (targets[0].kind === 'element') expect(targets[0].widen).toBe(false);
-  });
-});
-
-describe('resolveScope — artboard', () => {
-  test('passes the selection selector through to the adapter for ancestor widening', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeWithSelection('.design/ui/Home.tsx', '.cta-button'),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    expect(t.kind).toBe('element');
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('.cta-button');
-      expect(t.canvasSlug).toBe('ui-home');
-    }
-  });
-
-  test('defaults to the first artboard when no selection', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toHaveLength(1);
-    if (targets[0].kind === 'element') {
-      expect(targets[0].cssPath).toBe('[data-dc-screen]:first-of-type');
-    }
-  });
-
-  // Item 5 — target the active/selected artboard by id, not `:first-of-type`.
-  test('targets the active artboard by id when options.artboardId is set', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-      options: { artboardId: 'screen-2' },
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('[data-dc-screen="screen-2"]');
-      // The element IS the artboard — no widening needed (PDF shim never widens).
-      expect(t.widen).toBe(false);
-    }
-  });
-
-  test('artboardId wins over a captured selection selector', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeWithSelection('.design/ui/Home.tsx', '.cta-button'),
-      designRoot: '/abs/.design',
-      options: { artboardId: 'screen-3', selection: { selector: '.cta-button' } },
-    });
-    if (targets[0].kind === 'element') {
-      expect(targets[0].cssPath).toBe('[data-dc-screen="screen-3"]');
-    }
-  });
-
-  test('falls back to widening a descendant selector when no artboardId', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-      options: { selection: { selector: '.cta-button' } },
-    });
-    const t = targets[0];
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('.cta-button');
-      // No id → the adapter must widen to the closest [data-dc-screen].
-      expect(t.widen).toBe(true);
-    }
-  });
-
-  test('escapes a quote in the artboard id so the selector stays valid', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-      options: { artboardId: 'a"b' },
-    });
-    if (targets[0].kind === 'element') {
-      expect(targets[0].cssPath).toBe('[data-dc-screen="a\\"b"]');
-    }
-  });
-});
-
-describe('resolveScope — canvas-as-separate', () => {
-  test('emits one multi-target spanning every artboard on the active canvas', async () => {
-    const targets = await resolveScope({
-      scope: 'canvas-as-separate',
-      activeJson: activeOn('.design/ui/Home.tsx'),
-      designRoot: '/abs/.design',
-    });
-    expect(targets).toHaveLength(1);
-    const t = targets[0];
-    expect(t.kind).toBe('element');
-    if (t.kind === 'element') {
-      expect(t.cssPath).toBe('[data-dc-screen]');
-      expect(t.multi).toBe(true);
-      expect(t.canvasSlug).toBe('ui-home');
-    }
-  });
-});
-
-describe('resolveScope — project-raw', () => {
-  test('walks designRoot and excludes runtime files', async () => {
-    const root = mkdtempSync(join(tmpdir(), 'scope-raw-'));
-    const designRoot = join(root, '.design');
-    mkdirSync(designRoot, { recursive: true });
-    mkdirSync(join(designRoot, 'ui'), { recursive: true });
-    mkdirSync(join(designRoot, '_history', 'old'), { recursive: true });
-    writeFileSync(join(designRoot, 'config.json'), '{}');
-    writeFileSync(join(designRoot, 'ui', 'Home.tsx'), 'export default ()=>null');
-    writeFileSync(join(designRoot, '_active.json'), '{"active":null}');
-    writeFileSync(join(designRoot, '_history', 'old', 'snap.tsx'), '// snapshot');
-    writeFileSync(join(designRoot, '.DS_Store'), '');
-
-    const targets = await resolveScope({
-      scope: 'project-raw',
-      activeJson: emptyActive(),
-      designRoot,
-      repoRoot: root,
-    });
-    expect(targets).toHaveLength(1);
-    if (targets[0].kind === 'file-tree') {
-      const paths = targets[0].paths.sort();
-      expect(paths).toContain('config.json');
-      expect(paths).toContain('ui/Home.tsx');
-      // Excludes apply.
-      expect(paths).not.toContain('_active.json');
-      expect(paths).not.toContain('.DS_Store');
-      expect(paths.some((p) => p.startsWith('_history/'))).toBe(false);
-    }
-  });
-
-  test('emits no targets when designRoot is empty after excludes', async () => {
-    const root = mkdtempSync(join(tmpdir(), 'scope-raw-empty-'));
-    const designRoot = join(root, '.design');
-    mkdirSync(designRoot, { recursive: true });
-    writeFileSync(join(designRoot, '_active.json'), '{}');
-
-    const targets = await resolveScope({
-      scope: 'project-raw',
-      activeJson: emptyActive(),
-      designRoot,
-      repoRoot: root,
-    });
-    expect(targets).toEqual([]);
-  });
-});
-
-// DDR-232 follow-up — the live dialog's canvas file beats the persisted
-// `_active.json`: a job submitted right after a tab switch used to resolve
-// against the PREVIOUS canvas (with the new canvas's artboardId — a selector
-// that never appears; a 60 s waitFor timeout on the worker).
-describe('canvasFile hint precedence', () => {
-  test('options.canvasFile wins over activeJson.active', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: { active: '.design/ui/stale-previous.tsx', selected: null },
-      designRoot: '/abs/.design',
-      options: { canvasFile: '.design/ui/the-open-one.tsx', artboardId: 'hero' },
-    });
-    expect(targets).toEqual([
-      {
-        kind: 'element',
-        cssPath: '[data-dc-screen="hero"]',
-        canvasSlug: 'ui-the-open-one',
-        file: '.design/ui/the-open-one.tsx',
-        widen: false,
-      },
-    ]);
-  });
-  test('canvasFile alone is enough — a null active no longer empties the job', async () => {
-    const targets = await resolveScope({
-      scope: 'artboard',
-      activeJson: { active: null, selected: null },
-      designRoot: '/abs/.design',
-      options: { canvasFile: '.design/ui/open.tsx', artboardId: 'a1' },
-    });
-    expect(targets.length).toBe(1);
-  });
-});