Skip to content

3D engine that AI agents drive

14.0 KB
Raw Blame
import assert from 'node:assert/strict';
import { mkdir, writeFile } from 'node:fs/promises';
import { chromium } from 'playwright';

const origin = process.argv[2] ?? 'http://127.0.0.1:5173';
await import('./smoke-navigation.mjs');
await mkdir('artifacts', { recursive: true });
const browser = await chromium.launch({ executablePath:'C:/Program Files/Google/Chrome/Application/chrome.exe', headless:true, args:['--enable-webgl','--ignore-gpu-blocklist'] });
const errors = [];
const report = { layouts: [], interactions: [] };
try {
  const page = await browser.newPage({ viewport:{ width:1440,height:1000 }, colorScheme:'dark', reducedMotion:'reduce' });
  await page.addInitScript(() => {
    window.__copiedText = '';
    Object.defineProperty(navigator, 'clipboard', {
      value: { writeText: async text => { window.__copiedText = text; } },
    });
  });
  page.on('pageerror', error => errors.push(error.message));
  for (const route of ['/', '/downloads.html', '/docs.html', '/getting-started.html', '/object.html', '/motion.html', '/nature.html', '/assets.html', '/view2d.html', '/film.html']) {
    await page.goto(origin + route);
    if (route === '/downloads.html') await page.waitForURL(origin + '/#downloads');
    if (route === '/getting-started.html') await page.waitForURL(origin + '/docs.html#install');
    if (['/', '/downloads.html', '/docs.html', '/getting-started.html'].includes(route)) {
      await page.locator('.navigation nav a .nav-label').first().waitFor();
    }
    if (route.includes('object')) await page.waitForFunction(() => window.__studio?.renderer);
    if (route.includes('motion')) await page.waitForFunction(() => window.__motion?.renderer);
    if (route.includes('nature')) await page.waitForFunction(() => window.__nature?.renderer);
    if (route.includes('assets')) await page.waitForFunction(() => window.__assetViewer?.renderer);
    if (route.includes('film')) await page.waitForFunction(() => window.__filmReady);
    for (const width of [1440,390,320]) {
      await page.setViewportSize({ width,height:1000 });
      await page.waitForTimeout(150);
      if (route === '/') {
        await page.locator('img').evaluateAll(images => images.forEach(image => { image.loading = 'eager'; }));
        await page.waitForFunction(() => [...document.images].every(image => image.complete));
        if (width < 760) {
          const commandHeight = await page.locator('.home-install .command-row').evaluate(element => element.getBoundingClientRect().height);
          assert.ok(commandHeight < 180, `Homepage command consumes excessive mobile height: ${commandHeight}`);
        }
      }
      const overflow = await page.evaluate(() => document.documentElement.scrollWidth > innerWidth + 1);
      assert.equal(overflow,false,`${route} overflow at ${width}`);
      const clippedLinks = await page.locator('nav a').evaluateAll(links => links.filter(link => {
        const rectangle = link.getBoundingClientRect();
        return rectangle.width && (rectangle.left < -1 || rectangle.right > innerWidth + 1);
      }).map(link => link.textContent));
      assert.deepEqual(clippedLinks,[],`${route} clipped navigation at ${width}`);
      if (['/object.html','/nature.html'].includes(route) && width < 700) {
        const geometry = await page.evaluate(() => ({ canvas:document.querySelector('#viewport').getBoundingClientRect().toJSON(), controls:document.querySelector('.controls, .landscape-controls').getBoundingClientRect().toJSON(), title:document.querySelector('.object-info, .landscape-title').getBoundingClientRect().toJSON() }));
        assert.ok(geometry.canvas.bottom <= geometry.controls.top, 'Mobile controls overlap the model');
        assert.ok(geometry.title.bottom <= geometry.canvas.top, 'Mobile title overlaps the model');
      }
      await page.screenshot({ path:`artifacts/site-${route.replace(/[^a-z]/g,'') || 'home'}-${width}.png`, fullPage:true });
      report.layouts.push({ route,width,overflow });
    }
    await page.setViewportSize({ width:1440,height:1000 });
    if (['/', '/downloads.html', '/docs.html', '/getting-started.html'].includes(route)) {
      assert.equal(await page.locator('aside.navigation').count(), 0);
      assert.deepEqual(await page.locator('.navigation nav .nav-label').allTextContents(), ['Docs', 'Changelog']);
      assert.equal(await page.locator('.navigation nav a[aria-current="page"]').count(), ['/', '/downloads.html'].includes(route) ? 0 : 1);
      assert.equal(await page.locator('a[href$="llms.txt"]').count(), 0, 'Machine guide appears in public UI');
      assert.equal(await page.locator('.navigation a[href*="getting-started.html"]').count(), 0, 'Getting started still has separate navigation');
    }
    if (route === '/') {
      assert.equal(await page.locator('video').count(), 0, 'Homepage still embeds video');
      assert.equal(await page.locator('#downloads').count(), 1, 'Homepage install controls are missing');
      const scenePaths = await page.locator('.gallery .example').evaluateAll(links => links.map(link => { const url = new URL(link.href); return url.pathname + url.search; }));
      assert.equal(new Set(scenePaths).size, scenePaths.length, 'Showcase repeats the same scene');
      assert.equal(await page.locator('.hero-loop #scene-tabs button').count(), 5, 'Hero scene tabs are missing');
      assert.equal(await page.locator('.hero-loop #credits-toggle').count(), 1, 'Hero credits control is missing');
      const showcase = await browser.newPage({ viewport:{ width:1440,height:900 }, reducedMotion:'reduce' });
      showcase.on('pageerror', error => errors.push(error.message));
      await showcase.goto(origin + '/showcase.html?scene=datacenter');
      await showcase.waitForFunction(() => window.__showcase?.renderer, null, { timeout:60000 });
      assert.equal(await showcase.evaluate(() => window.__showcase.renderer.context.getError()), 0);
      assert.equal(await showcase.locator('#showcase-tabs button').count(), 3);
      await showcase.locator('#showcase-reset').waitFor();
      await showcase.evaluate(() => { window.__firstRenderer = window.__showcase.renderer; });
      await showcase.locator('#showcase-tabs button[data-scene="airport"]').click();
      const chip = showcase.locator('#showcase-status');
      assert.equal(await chip.isVisible(), true, 'Loading chip is missing after a tab switch');
      assert.match(await chip.textContent(), /Loading Airport ramp/);
      assert.equal(await showcase.locator('#showcase-tabs button[data-scene="airport"]').isDisabled(), true, 'Tab can be clicked again while loading');
      await showcase.waitForFunction(() => window.__showcase.renderer !== window.__firstRenderer, null, { timeout:60000 });
      await chip.waitFor({ state:'hidden', timeout:10000 });
      assert.equal(await showcase.locator('#showcase-tabs button[data-scene="airport"]').getAttribute('aria-pressed'), 'true');
      await showcase.close();
      report.interactions.push('Hero shows five scene tabs and credits, and the showcase opens the data center scene');
    }
    if (['/', '/downloads.html'].includes(route)) {
      if (route === '/downloads.html') assert.match(page.url(), /\/#downloads$/);
      await page.waitForFunction(() => window.__home.state.status === 'ready');
      assert.equal(await page.locator('.package-managers .package-logo').count(), 4);
      assert.equal(await page.locator('[data-package-manager]').count(), 4);
      assert.equal(await page.locator('[data-release-tarball], [data-release-module]').count(), 0);
      for (const [manager, prefix] of [['npm', 'npm install'], ['pnpm', 'pnpm add'], ['yarn', 'yarn add'], ['bun', 'bun add']]) {
        await page.locator(`[data-package-manager="${manager}"]`).click();
        const expectedCommand = await page.evaluate(prefix => window.__home.state.release.installCommand.replace(/^npm install/, prefix), prefix);
        assert.equal(await page.locator('[data-install-command]').textContent(), expectedCommand);
        assert.equal(await page.locator(`[data-package-manager="${manager}"]`).getAttribute('aria-pressed'), 'true');
        await page.locator('[data-copy-install]').click();
        assert.equal(await page.evaluate(() => window.__copiedText), expectedCommand);
      }
      report.interactions.push('Homepage installation with four branded package managers, copying and legacy URL redirect');
    }
    if (route === '/getting-started.html') {
      assert.match(page.url(), /\/docs(?:\.html)?#install$/);
    }
    if (route === '/docs.html') {
      assert.ok(await page.locator('#doc-toc a[href^="#"]').count() >= 15);
      assert.equal(await page.locator('#doc-article section:visible').count(), 1);
      await page.locator('#doc-search').fill('memory');
      assert.ok(await page.locator('#doc-toc a:visible').count() > 0);
      await page.locator('#doc-toc a[href="#performance-and-memory"]').click();
      assert.match(await page.locator('#doc-article').textContent(), /Performance and memory/);
      await page.locator('#doc-search').fill('no-such-topic-1234');
      assert.equal(await page.locator('#doc-toc a:visible').count(), 0);
      assert.match(await page.locator('#doc-results').textContent(), /No .*match/i);
      await page.locator('#doc-search').fill('');
      await page.locator('#doc-toc a[href="#models-and-ai-agents"]').click();
      assert.match(page.url(),/models-and-ai-agents/);
      await page.locator('#doc-toc a[href="#first-scene"]').click();
      assert.ok(await page.locator('#first-scene .doc-step').count() >= 5);
      assert.ok(await page.locator('#first-scene .live-example').count() >= 3);
      const firstExample = page.locator('.live-example').first();
      await firstExample.locator('.live-run').click();
      await page.waitForFunction(() => document.querySelector('.live-example')?.dataset.ready === 'true');
      assert.equal(await firstExample.locator('.live-status[data-kind=error]').count(), 0);
      await page.evaluate(() => { location.hash = '#getting-started'; });
      await page.waitForURL(/#first-scene$/);
      const headerBounds = await page.locator('.navigation').boundingBox();
      const copyBounds = await page.locator('#copy-doc-page').boundingBox();
      assert.ok(copyBounds.y >= headerBounds.y + headerBounds.height, 'Sticky header covers Copy page');
      assert.ok(await page.locator('.hljs-keyword').count() > 0);
      assert.ok(await page.locator('.code-block').count() >= 2);
      assert.equal(await page.locator('#copy-doc-page').count(), 1);
      await page.locator('#copy-doc-page').click();
      assert.match(await page.evaluate(() => window.__copiedText), /^# Your first scene/);
      assert.ok(!(await page.evaluate(() => window.__copiedText)).includes('## Parts and geometry'));
      const firstCode = page.locator('.code-block').first();
      await firstCode.locator('.copy-code').click();
      assert.equal(await page.evaluate(() => window.__copiedText), await firstCode.locator('code').textContent());
      report.interactions.push('Grouped docs, start pages, a running live example, old-link aliases, search, deep links and labeled syntax highlighting');
    }
    if (route === '/object.html') {
      await page.locator('[data-view="face"]').click();
      assert.equal(await page.evaluate(() => window.__studio.state.targetHeight),2.55);
      await page.locator('#look').selectOption('warm');
      await page.locator('[data-view="machine"]').click();
      assert.equal(await page.evaluate(() => window.__studio.state.assembly),0.65);
      const download = page.waitForEvent('download');
      await page.locator('#save-model').click();
      assert.equal((await download).suggestedFilename(),'crucible-wall-e.png');
      await page.locator('#assembly-tour').click();
      assert.equal(await page.evaluate(() => window.__studio.state.touring),false);
      const graphics = await page.evaluate(() => window.__studio.renderer.context.getError());
      assert.equal(graphics,0);
      report.interactions.push('Object viewpoints, lighting, PNG and reduced-motion assembly toggle');
    }
    if (route === '/motion.html') {
      await page.locator('#motion-look').selectOption('neutral');
      await page.locator('#motion-aspect').selectOption('portrait');
      await page.evaluate(() => window.__scene.renderAt(3));
      const download = page.waitForEvent('download');
      await page.locator('#motion-save').click();
      assert.equal((await download).suggestedFilename(),'crucible-clockwork.png');
      assert.equal(await page.evaluate(() => window.__scene.renderer.context.getError()),0);
      report.interactions.push('Motion looks, portrait framing, deterministic seek and PNG');
    }
    if (route === '/nature.html') {
      await page.locator('[data-daylight="0.5"]').click();
      assert.equal(await page.evaluate(() => window.__nature.state.daylight),0.5);
      assert.equal(await page.evaluate(() => window.__nature.renderer.context.getError()),0);
      report.interactions.push('Nature golden-hour preset');
    }
  }
  await page.emulateMedia({colorScheme:'light'});
  await page.goto(origin);
  assert.equal(await page.evaluate(() => getComputedStyle(document.body).getPropertyValue('--window').trim()),'#09070f', 'Site is dark in light mode too');
  await page.screenshot({path:'artifacts/site-home-light.png',fullPage:true});
  await page.goto(`${origin}/object.html`);
  await page.waitForFunction(() => window.__studio?.renderer);
  await page.emulateMedia({reducedMotion:'no-preference'});
  await page.locator('#assembly-tour').click();
  await page.waitForFunction(() => window.__studio.state.assembly > 0.01);
  await page.locator('#assembly-tour').click();
  assert.equal(await page.evaluate(() => window.__studio.state.touring),false);
  report.interactions.push('Assembly playback and pause');
  for (const resource of ['/guide.md','/llms.txt','/gltf.md','/favicon.svg','/logo.svg']) {
    const response = await page.request.get(origin + resource);
    assert.equal(response.status(),200,resource);
  }
  assert.deepEqual(errors,[]);
  await writeFile('artifacts/site-checks.json',JSON.stringify(report,null,2));
  console.log(`Site passed: ${report.layouts.length} layouts, ${report.interactions.length} interaction groups, light/dark theme and agent resources.`);
} finally { await browser.close(); }