@1agh/maude 1.0.11 → 1.3.0

package/apps/studio/test/camera-reveal.test.tsx

@@ -1,173 +0,0 @@
-// camera-reveal — Task A3 (feature-element-editing-robustness), Stage A.
-//
-// Regression guard for Bugs A + B: a `select-by-id` reveal must pan the camera
-// (the `.dc-world` transform, via the viewport controller) and MUST NOT scroll
-// the overflow:hidden `.dc-canvas` / `.dc-artboard-body` clip layers — host
-// scroll is what desynced the camera model (phantom right strip + pan reset
-// after an absolute-element move).
-//
-// canvas-shell.tsx pulls in a React/DOM dependency graph, so we register
-// happy-dom for this file (like canvas-hmr-runtime.test.tsx) before importing.
-
-import { afterAll, beforeAll, describe, expect, test } from 'bun:test';
-import { GlobalRegistrator } from '@happy-dom/global-registrator';
-
-beforeAll(() => {
-  GlobalRegistrator.register();
-});
-afterAll(() => {
-  GlobalRegistrator.unregister();
-});
-
-import type { ViewportControllerHandle } from '../canvas-lib.tsx';
-import { REVEAL_MARGIN_PX, revealAxisDelta, revealElementViaCamera } from '../canvas-shell.tsx';
-
-const M = REVEAL_MARGIN_PX;
-
-describe('revealAxisDelta — minimal 1-axis camera pan', () => {
-  // Viewport spans [0, 1000]; usable band is [M, 1000 - M].
-  const V0 = 0;
-  const V1 = 1000;
-
-  test('fully visible → no pan', () => {
-    expect(revealAxisDelta(200, 400, V0, V1, M)).toBe(0);
-  });
-
-  test('flush at the inset band edges → no pan', () => {
-    expect(revealAxisDelta(M, V1 - M, V0, V1, M)).toBe(0);
-  });
-
-  test('off the start (left/top) edge → positive delta brings the start in', () => {
-    // element [-50, 100]; start (-50) is left of the inset band start (M=40).
-    const d = revealAxisDelta(-50, 100, V0, V1, M);
-    expect(d).toBe(M - -50); // vs - elStart = 40 - (-50) = 90
-    expect(d).toBeGreaterThan(0);
-  });
-
-  test('off the end (right/bottom) edge → negative delta brings the end in', () => {
-    // element [900, 1100]; end (1100) is past the inset band end (960).
-    const d = revealAxisDelta(900, 1100, V0, V1, M);
-    expect(d).toBe(V1 - M - 1100); // ve - elEnd = 960 - 1100 = -140
-    expect(d).toBeLessThan(0);
-  });
-
-  test('element wider than the viewport → no pan (matches scrollIntoView nearest)', () => {
-    expect(revealAxisDelta(-200, 1200, V0, V1, M)).toBe(0);
-  });
-});
-
-// Minimal fake controller — only `panBy` is exercised; the rest satisfy the type.
-function fakeController(): {
-  handle: ViewportControllerHandle;
-  calls: Array<[number, number]>;
-} {
-  const calls: Array<[number, number]> = [];
-  const noop = () => {};
-  const handle: ViewportControllerHandle = {
-    viewport: { x: 0, y: 0, zoom: 1 },
-    setViewport: noop,
-    panBy: (dx, dy) => calls.push([dx, dy]),
-    zoomAt: noop,
-    fit: noop,
-    reset: noop,
-    zoomIn: noop,
-    zoomOut: noop,
-    jumpTo: noop,
-    animateTo: noop,
-    isInteracting: false,
-  };
-  return { handle, calls };
-}
-
-function elWithRect(rect: Partial<DOMRect>): HTMLElement {
-  const el = document.createElement('div');
-  const r = {
-    left: 0,
-    top: 0,
-    right: 0,
-    bottom: 0,
-    width: 0,
-    height: 0,
-    x: 0,
-    y: 0,
-    ...rect,
-  } as DOMRect;
-  el.getBoundingClientRect = () => r;
-  return el;
-}
-
-describe('revealElementViaCamera — pans the controller, never host scroll', () => {
-  test('off-screen element pans via panBy and leaves host scroll at 0', () => {
-    const host = elWithRect({
-      left: 0,
-      top: 0,
-      right: 1000,
-      bottom: 800,
-      width: 1000,
-      height: 800,
-    });
-    // Target sits past the right edge — the exact Bug B repro (overflowing element).
-    const target = elWithRect({
-      left: 1100,
-      top: 100,
-      right: 1300,
-      bottom: 200,
-      width: 200,
-      height: 100,
-    });
-    const { handle, calls } = fakeController();
-
-    revealElementViaCamera(host, target, handle);
-
-    expect(calls.length).toBe(1);
-    const [dx, dy] = calls[0];
-    expect(dx).toBeLessThan(0); // pan world left to reveal the right-side element
-    expect(dy).toBe(0); // vertically already in view
-    // The invariant: no host scroll was touched.
-    expect(host.scrollLeft).toBe(0);
-    expect(host.scrollTop).toBe(0);
-  });
-
-  test('already-visible element → no pan at all', () => {
-    const host = elWithRect({
-      left: 0,
-      top: 0,
-      right: 1000,
-      bottom: 800,
-      width: 1000,
-      height: 800,
-    });
-    const target = elWithRect({
-      left: 300,
-      top: 300,
-      right: 500,
-      bottom: 400,
-      width: 200,
-      height: 100,
-    });
-    const { handle, calls } = fakeController();
-
-    revealElementViaCamera(host, target, handle);
-
-    expect(calls.length).toBe(0);
-    expect(host.scrollLeft).toBe(0);
-    expect(host.scrollTop).toBe(0);
-  });
-
-  test('detached element (zero box) → no pan', () => {
-    const host = elWithRect({
-      left: 0,
-      top: 0,
-      right: 1000,
-      bottom: 800,
-      width: 1000,
-      height: 800,
-    });
-    const target = elWithRect({});
-    const { handle, calls } = fakeController();
-
-    revealElementViaCamera(host, target, handle);
-
-    expect(calls.length).toBe(0);
-  });
-});

package/apps/studio/test/canvas-artifacts.test.ts

@@ -1,125 +0,0 @@
-// canvas-artifacts.ts — the canonical artifact inventory. Pure, no server boot
-// needed: cover inventory completeness, the divergent `_locator.json` slug
-// shape, and relocatedName()'s path math for both a pure directory move and a
-// combined move+rename.
-
-import { describe, expect, test } from 'bun:test';
-import path from 'node:path';
-
-import { canvasArtifacts, locatorKeyFor, relocatedName } from '../canvas-artifacts.ts';
-import type { Paths } from '../context.ts';
-
-function fakePaths(repoRoot: string): Paths {
-  const designRoot = path.join(repoRoot, '.design');
-  return {
-    repoRoot,
-    designRel: '.design',
-    designRoot,
-    serverInfoFile: path.join(designRoot, '_server.json'),
-    activeFile: path.join(designRoot, '_active.json'),
-    commentsDir: path.join(designRoot, '_comments'),
-    canvasStateDir: path.join(designRoot, '_canvas-state'),
-    historyDir: path.join(designRoot, '_history'),
-    tokensUrlRel: '.design/system/colors_and_type.css',
-    systemDirRel: 'system',
-  };
-}
-
-describe('canvasArtifacts', () => {
-  const paths = fakePaths('/repo');
-
-  test('lists the primary + siblings + every slug-keyed sidecar', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/Foo.tsx', paths });
-    const abs = artifacts.map((a) => a.abs);
-    expect(abs).toContain(path.join(paths.designRoot, 'ui', 'Foo.tsx'));
-    expect(abs).toContain(path.join(paths.designRoot, 'ui', 'Foo.meta.json'));
-    expect(abs).toContain(path.join(paths.designRoot, 'ui', 'Foo.css'));
-    expect(abs).toContain(path.join(paths.designRoot, 'ui', 'Foo.registry.json'));
-    const slug = 'ui-foo';
-    expect(abs).toContain(path.join(paths.historyDir, slug));
-    expect(abs).toContain(path.join(paths.canvasStateDir, `${slug}.json`));
-    expect(abs).toContain(path.join(paths.canvasStateDir, `${slug}.view.json`));
-    expect(abs).toContain(path.join(paths.commentsDir, `${slug}.json`));
-    expect(abs).toContain(path.join(paths.designRoot, '_state', `${slug}.ydoc.bin`));
-    expect(abs).toContain(path.join(paths.designRoot, `${slug}.annotations.svg`));
-    expect(abs).toContain(path.join(paths.designRoot, `${slug}.edl.json`));
-  });
-
-  test('does NOT include _photo/ or _draw/ (asset-keyed / mark-slug-keyed, not canvas-slug-keyed)', () => {
-    const abs = canvasArtifacts({ rel: 'ui/Foo.tsx', paths }).map((a) => a.abs);
-    expect(abs.some((p) => p.includes('_photo'))).toBe(false);
-    expect(abs.some((p) => p.includes('_draw'))).toBe(false);
-  });
-
-  test('marks exactly one primary and the rest sibling/slug-keyed', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/Foo.tsx', paths });
-    const primaries = artifacts.filter((a) => a.kind === 'primary');
-    expect(primaries.length).toBe(1);
-    expect(primaries[0]?.abs).toBe(path.join(paths.designRoot, 'ui', 'Foo.tsx'));
-  });
-
-  test('handles a nested rel (subfolder)', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/sub/Bar.tsx', paths });
-    const primary = artifacts.find((a) => a.kind === 'primary');
-    expect(primary?.abs).toBe(path.join(paths.designRoot, 'ui', 'sub', 'Bar.tsx'));
-    const slug = 'ui-sub-bar';
-    expect(artifacts.some((a) => a.abs === path.join(paths.historyDir, slug))).toBe(true);
-  });
-});
-
-describe('locatorKeyFor — the DIVERGENT slug shape', () => {
-  test('posix, extension-less, NOT lowercased or dash-flattened', () => {
-    expect(locatorKeyFor('ui/Onboarding Brief.tsx')).toBe('ui/Onboarding Brief');
-  });
-
-  test('differs from canvasSlugFromRel for a mixed-case / spaced name', () => {
-    // canvasSlugFromRel('ui/Onboarding Brief.tsx', ...) => 'ui-onboarding_brief'
-    expect(locatorKeyFor('ui/Onboarding Brief.tsx')).not.toBe('ui-onboarding_brief');
-  });
-});
-
-describe('relocatedName', () => {
-  const paths = fakePaths('/repo');
-
-  test('pure directory move (basename unchanged) — siblings track the new dir', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/Foo.tsx', paths });
-    const primary = artifacts.find((a) => a.kind === 'primary');
-    if (!primary) throw new Error('no primary');
-    expect(relocatedName(primary, 'ui/Foo.tsx', 'ui/sub/Foo.tsx', paths)).toBe(
-      path.join(paths.designRoot, 'ui', 'sub', 'Foo.tsx')
-    );
-    const meta = artifacts.find((a) => a.abs.endsWith('Foo.meta.json'));
-    if (!meta) throw new Error('no meta sibling');
-    expect(relocatedName(meta, 'ui/Foo.tsx', 'ui/sub/Foo.tsx', paths)).toBe(
-      path.join(paths.designRoot, 'ui', 'sub', 'Foo.meta.json')
-    );
-  });
-
-  test('slug-keyed sidecars stay in their fixed dir but re-key the filename', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/Foo.tsx', paths });
-    const history = artifacts.find((a) => a.abs === path.join(paths.historyDir, 'ui-foo'));
-    if (!history) throw new Error('no history artifact');
-    expect(relocatedName(history, 'ui/Foo.tsx', 'ui/sub/Foo.tsx', paths)).toBe(
-      path.join(paths.historyDir, 'ui-sub-foo')
-    );
-    const view = artifacts.find((a) => a.abs.endsWith('ui-foo.view.json'));
-    if (!view) throw new Error('no view artifact');
-    expect(relocatedName(view, 'ui/Foo.tsx', 'ui/sub/Foo.tsx', paths)).toBe(
-      path.join(paths.canvasStateDir, 'ui-sub-foo.view.json')
-    );
-  });
-
-  test('a rename (same dir, new basename) re-keys both the sibling and the slug-keyed sidecar', () => {
-    const artifacts = canvasArtifacts({ rel: 'ui/Foo.tsx', paths });
-    const primary = artifacts.find((a) => a.kind === 'primary');
-    if (!primary) throw new Error('no primary');
-    expect(relocatedName(primary, 'ui/Foo.tsx', 'ui/Bar.tsx', paths)).toBe(
-      path.join(paths.designRoot, 'ui', 'Bar.tsx')
-    );
-    const comments = artifacts.find((a) => a.abs === path.join(paths.commentsDir, 'ui-foo.json'));
-    if (!comments) throw new Error('no comments artifact');
-    expect(relocatedName(comments, 'ui/Foo.tsx', 'ui/Bar.tsx', paths)).toBe(
-      path.join(paths.commentsDir, 'ui-bar.json')
-    );
-  });
-});

package/apps/studio/test/canvas-build-sandbox.test.ts

@@ -1,69 +0,0 @@
-// Cloud Phase 27 — the sandbox child's environment.
-//
-// Diagnosed against a real cell: the canvas module 422'd with "Cannot find
-// native binding" while running the identical worker command by hand with a
-// clean environment worked. The difference was one inherited variable.
-
-import { describe, expect, test } from 'bun:test';
-
-import { workerEnv } from '../canvas-build-sandbox.ts';
-
-describe('workerEnv', () => {
-  test('a compiled binary’s VIRTUAL binding path is not handed to a child', () => {
-    const env = workerEnv({
-      PATH: '/bin',
-      NAPI_RS_NATIVE_LIBRARY_PATH: '/$bunfs/root/parser.linux-arm64-gnu.node',
-    } as NodeJS.ProcessEnv);
-    expect(env.NAPI_RS_NATIVE_LIBRARY_PATH).toBeUndefined();
-  });
-
-  test('a REAL binding path still is', () => {
-    const env = workerEnv({
-      PATH: '/bin',
-      NAPI_RS_NATIVE_LIBRARY_PATH: '/maude/node_modules/@oxc-parser/binding-linux-arm64-gnu',
-    } as NodeJS.ProcessEnv);
-    expect(env.NAPI_RS_NATIVE_LIBRARY_PATH).toBe(
-      '/maude/node_modules/@oxc-parser/binding-linux-arm64-gnu'
-    );
-  });
-
-  test('the child environment carries no secret — it parses tenant source', () => {
-    const env = workerEnv({
-      PATH: '/bin',
-      HUB_SECRET: 'nope',
-      AWS_SECRET_ACCESS_KEY: 'also-nope',
-      MAUDE_PROJECT_TOKEN_KEY: 'definitely-nope',
-    } as NodeJS.ProcessEnv);
-    expect(env.HUB_SECRET).toBeUndefined();
-    expect(env.AWS_SECRET_ACCESS_KEY).toBeUndefined();
-    expect(env.MAUDE_PROJECT_TOKEN_KEY).toBeUndefined();
-  });
-});
-
-// Cloud Phase 27 B2 — content-addressed media is immutable; everything else
-// revalidates. `no-store` is right on a laptop and is a re-download of every
-// photograph on every pan over the internet.
-import { cacheControlFor } from '../http.ts';
-
-describe('cacheControlFor', () => {
-  test('a content-addressed name is immutable — the name IS the content', () => {
-    for (const p of ['/x/assets/deadbeef.png', '/a/b/0123456789abcdef.mp4']) {
-      expect(cacheControlFor(p).cacheControl).toBe('public, max-age=31536000, immutable');
-      expect(cacheControlFor(p).addEtag).toBe(false);
-    }
-  });
-
-  test('an AUTHORED name revalidates — a designer edits hero.png in place', () => {
-    for (const p of ['/x/assets/hero.png', '/x/system/ds/colors_and_type.css', '/x/logos.svg']) {
-      expect(cacheControlFor(p).cacheControl).toBe('no-cache');
-      expect(cacheControlFor(p).addEtag).toBe(true);
-    }
-  });
-
-  test('a name that merely LOOKS hex-ish is not treated as content-addressed', () => {
-    // `deadbee` is 7 chars; `deadbeefs` has a non-hex char. Getting either
-    // wrong caches a mutable file for a year.
-    expect(cacheControlFor('/x/deadbee.png').cacheControl).toBe('no-cache');
-    expect(cacheControlFor('/x/deadbeefs.png').cacheControl).toBe('no-cache');
-  });
-});

package/apps/studio/test/canvas-build.test.ts

@@ -1,141 +0,0 @@
-// canvas-build.ts — Phase 3.6 Task 6. Verify the per-canvas Bun.build wrap
-// produces browser-loadable ES modules that:
-//   1. preserve the data-cd-id attributes injected by canvas-pipeline pass 1,
-//   2. import "react" / "react/jsx-dev-runtime" as standard ESM specifiers
-//      (browser resolves via importmap to /_canvas-runtime/*.js),
-//   3. expose the default export so _shell.html can mount it.
-
-import { describe, expect, test } from 'bun:test';
-
-import { buildCanvasModule } from '../canvas-build.ts';
-
-// Bun.build resolves the entrypoint against the filesystem (its virtual-loader
-// plugin only kicks in for onLoad, after onResolve has confirmed the path
-// exists). Each test writes its source to a real temp file and points
-// buildCanvasModule at it; the canvas-virtual-source plugin then intercepts
-// the onLoad and feeds the post-pass-1 TSX.
-async function writeTmp(name: string, source: string): Promise<string> {
-  const abs = `/tmp/canvas-build-${name}-${Math.random().toString(36).slice(2, 8)}.tsx`;
-  await Bun.write(abs, source);
-  return abs;
-}
-
-describe('canvas-build / buildCanvasModule', () => {
-  test('preserves data-cd-id from pass 1', async () => {
-    const src =
-      `import { useState } from "react";\n` +
-      'export default function Demo() {\n' +
-      '  const [n] = useState(0);\n' +
-      `  return <button className="btn">{n}</button>;\n` +
-      '}\n';
-    const abs = await writeTmp('cd-id', src);
-    const r = await buildCanvasModule(abs, src);
-    expect(r.js).toContain('data-cd-id');
-    expect(r.js).toContain('className: "btn"');
-  });
-
-  test('emits standard react JSX runtime import (no Bun-internal symbols)', async () => {
-    const src = 'export default function X() { return <div />; }\n';
-    const abs = await writeTmp('std-jsx', src);
-    const r = await buildCanvasModule(abs, src);
-    // Production-mode build uses react/jsx-runtime (the dev variant trips a
-    // Bun.build rename collision with React's CJS `var React` hoist; see
-    // runtime-bundle.ts comment). Accept either runtime name.
-    expect(r.js).toMatch(/react\/jsx(-dev)?-runtime/);
-    // The pre-3.6 Bun.Transpiler-only path emitted `jsxDEV_<hash>` /
-    // `jsx_<hash>`; Bun.build uses the standard name.
-    expect(r.js).not.toMatch(/jsxDEV?_[0-9a-z]{6,}/);
-  });
-
-  test('locator + etag mirror the canvas-pipeline result', async () => {
-    const src =
-      'export default function Y() {\n' + '  return <section><h1>hi</h1></section>;\n' + '}\n';
-    const abs = await writeTmp('locator', src);
-    const r = await buildCanvasModule(abs, src);
-    // section + h1 = 2 JSX elements → 2 locator entries.
-    expect(Object.keys(r.locator).length).toBe(2);
-    expect(r.etag).toMatch(/^[0-9a-f]+$/);
-  });
-
-  test('externalises react + reactDOM (no inlined copies)', async () => {
-    const src = 'export default function Z() { return <span />; }\n';
-    const abs = await writeTmp('external', src);
-    const r = await buildCanvasModule(abs, src);
-    // ReactDOM's package signature; the canvas bundle must NOT contain it,
-    // or the runtime singleton invariant breaks (two React copies).
-    expect(r.js).not.toContain('ReactCurrentOwner');
-    // jsx-runtime stays external too — the canvas should import jsxDEV via
-    // a normal specifier, not redefine it.
-    expect(r.js).not.toContain('function jsxDEV(');
-  });
-
-  test('exposes a default export', async () => {
-    const src = 'export default function Q() { return <i />; }\n';
-    const abs = await writeTmp('default', src);
-    const r = await buildCanvasModule(abs, src);
-    expect(r.js).toMatch(/export\s*\{[\s\S]*default[\s\S]*\}/);
-  });
-});
-
-// Spike finding M9 (studyfi-design AWS run, 2026-08-20) — the sandbox's import
-// allowlist rejected `data:` URIs. Bundled CSS runs every `url()` through
-// onResolve, and `url("data:image/svg+xml,…")` is the standard idiom for
-// grain, textures and tiny inline icons — it is neither relative nor absolute,
-// so the bare-specifier branch denied it with the npm-packages message. A
-// design system's always-on film-grain took every canvas build down; the
-// sandbox exists to stop NETWORK reads, and a data: URI never makes one.
-describe('canvas-build / sandbox scheme handling (M9)', () => {
-  const GRAIN =
-    `.grain {\n` +
-    `  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='180' height='180'%3E%3Cfilter id='g'%3E%3CfeTurbulence type='fractalNoise'/%3E%3C/filter%3E%3C/svg%3E");\n` +
-    `}\n`;
-
-  // REALPATH, not `/tmp` — on macOS `/tmp` is a symlink to `/private/tmp`, and
-  // Bun reports importers by their real path. A root captured through the
-  // symlink never matches, the allowlist silently disarms (returns null → the
-  // native resolver), and every "denied" assertion here would be testing
-  // nothing. Discovered by this very suite going green for the wrong reason.
-  async function tmpProject(): Promise<{ dir: string; abs: string; src: string }> {
-    const dir = `/private/tmp/canvas-build-m9-${Math.random().toString(36).slice(2, 8)}`;
-    await Bun.write(`${dir}/style.css`, GRAIN);
-    const src = `import "./style.css";\nexport default function G() { return <div className="grain" />; }\n`;
-    const abs = `${dir}/canvas.tsx`;
-    await Bun.write(abs, src);
-    return { dir, abs, src };
-  }
-
-  test('a data: URI inside bundled CSS survives the ARMED sandbox', async () => {
-    const { dir, abs, src } = await tmpProject();
-    const r = await buildCanvasModule(abs, src, { restrictImportsTo: dir });
-    expect(r.js).toContain('data:image/svg+xml');
-  });
-
-  test('the sandbox still denies a bare npm specifier — the scheme pass-through is not a hole', async () => {
-    const dir = `/private/tmp/canvas-build-m9-deny-${Math.random().toString(36).slice(2, 8)}`;
-    const src = `import x from "left-pad";\nexport default function D() { return <i>{x}</i>; }\n`;
-    const abs = `${dir}/canvas.tsx`;
-    await Bun.write(abs, src);
-    await expect(buildCanvasModule(abs, src, { restrictImportsTo: dir })).rejects.toThrow(
-      /not available when it renders in a browser/
-    );
-  });
-
-  test('an http(s) @import is still refused by the armed sandbox — only non-network schemes pass', async () => {
-    // The spike's original fontshare failure was exactly this shape: an
-    // `@import url(https://…)` is a BUILD-TIME network fetch, so the sandbox
-    // must keep refusing it even now that data:/blob: pass. (A plain
-    // `url(https://…)` image reference never reaches onResolve — Bun's CSS
-    // loader leaves it external for the browser, where the cell CSP owns it.)
-    const dir = `/private/tmp/canvas-build-m9-http-${Math.random().toString(36).slice(2, 8)}`;
-    await Bun.write(
-      `${dir}/style.css`,
-      `@import url("https://api.fontshare.com/v2/css?f=x");\n.x { color: red; }\n`
-    );
-    const src = `import "./style.css";\nexport default function H() { return <div className="x" />; }\n`;
-    const abs = `${dir}/canvas.tsx`;
-    await Bun.write(abs, src);
-    await expect(buildCanvasModule(abs, src, { restrictImportsTo: dir })).rejects.toThrow(
-      /not available when it renders in a browser/
-    );
-  });
-});