Added initial webdriver tests (#1337)

Adds webdriver tests for testing from a users perspective via browser
actions. We currently support local test runners for a bunch of actions
on desktop `chrome`/`firefox`/`edge`/`safari` on macos.

We also have a browserstack runner which we'll enable in another PR.

### Release Note

- Adds initial webdriver tests

.eslintignore

@@ -18,3 +18,6 @@
 **/next.config.js
 **/setupTests.js
 **/setupJest.js
+apps/webdriver/www
+apps/vscode/extension/editor
+apps/examples/www

.eslintrc.js

@@ -5,6 +5,7 @@ module.exports = {
 		'plugin:@typescript-eslint/recommended',
 		'plugin:@next/next/core-web-vitals',
 	],
+	ignorePatterns: ['e2e/wdio.*.js'],
 	plugins: ['@typescript-eslint', 'no-only-tests', 'import', 'local', '@next/next', 'react-hooks'],
 	settings: {
 		next: {

.gitignore

@@ -57,6 +57,7 @@ packages/assets/embed-icons
 packages/assets/fonts
 packages/assets/icons
 packages/assets/translations
+apps/webdriver/www/
 apps/examples/www/embed-icons
 apps/examples/www/fonts
 apps/examples/www/icons
@@ -77,3 +78,8 @@ apps/examples/www/index.js
 .tsbuild
 
 apps/examples/build.esbuild.json
+
+e2e/screenshots
+e2e/downloads
+e2e/driver-logs
+e2e/.wdio-vscode-service/

apps/webdriver/CHANGELOG.md

@@ -0,0 +1,2 @@
+# @tldraw/webdriver
+

apps/webdriver/README.md

@@ -0,0 +1 @@
+# @tldraw/webdriver

apps/webdriver/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "webdriver",
+	"description": "A tiny little drawing app (for webdriver).",
+	"version": "2.0.0-alpha.11",
+	"private": true,
+	"author": {
+		"name": "tldraw GB Ltd.",
+		"email": "hello@tldraw.com"
+	},
+	"homepage": "https://tldraw.dev",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/tldraw/tldraw"
+	},
+	"bugs": {
+		"url": "https://github.com/tldraw/tldraw/issues"
+	},
+	"keywords": [
+		"tldraw",
+		"drawing",
+		"app",
+		"development",
+		"whiteboard",
+		"canvas",
+		"infinite"
+	],
+	"scripts": {
+		"dev-webdriver": "concurrently --names \"tsc,esbuild\" \"yarn run -T tsx ../../scripts/typecheck.ts --build --watch --preserveWatchOutput\" \"node ./scripts/dev.mjs\"",
+		"lint": "yarn run -T tsx ../../scripts/lint.ts"
+	},
+	"devDependencies": {
+		"@types/ip": "^1.1.0",
+		"@types/node-forge": "^1.3.1",
+		"browserslist-to-esbuild": "^1.2.0",
+		"concurrently": "^7.4.0",
+		"esbuild": "^0.16.7",
+		"ip": "^1.1.8",
+		"kleur": "^4.1.5",
+		"lazyrepo": "0.0.0-alpha.26",
+		"node-forge": "^1.3.1",
+		"react": "^18.2.0",
+		"react-dom": "^18.2.0"
+	},
+	"dependencies": {
+		"@tldraw/assets": "workspace:*",
+		"@tldraw/tldraw": "workspace:*",
+		"react-router-dom": "^6.9.0",
+		"signia": "0.1.4",
+		"signia-react": "0.1.4"
+	}
+}

apps/webdriver/scripts/dev.mjs

@@ -0,0 +1,199 @@
+// @ts-nocheck
+/* eslint-disable */
+
+import browserslist from 'browserslist-to-esbuild'
+import crypto from 'crypto'
+import esbuild from 'esbuild'
+import { createServer as createNonSslServer, request } from 'http'
+import { createServer as createSslServer } from 'https'
+import ip from 'ip'
+import chalk from 'kleur'
+import forge from 'node-forge'
+import * as url from 'url'
+
+const LOG_REQUEST_PATHS = false
+
+export const generateCert = ({ altNameIPs, altNameURIs, validityDays }) => {
+	const keys = forge.pki.rsa.generateKeyPair(2048)
+	const cert = forge.pki.createCertificate()
+	cert.publicKey = keys.publicKey
+
+	// NOTE: serialNumber is the hex encoded value of an ASN.1 INTEGER.
+	// Conforming CAs should ensure serialNumber is:
+	// - no more than 20 octets
+	// - non-negative (prefix a '00' if your value starts with a '1' bit)
+	cert.serialNumber = '01' + crypto.randomBytes(19).toString('hex') // 1 octet = 8 bits = 1 byte = 2 hex chars
+	cert.validity.notBefore = new Date()
+	cert.validity.notAfter = new Date(
+		new Date().getTime() + 1000 * 60 * 60 * 24 * (validityDays ?? 1)
+	)
+	const attrs = [
+		{
+			name: 'countryName',
+			value: 'AU',
+		},
+		{
+			shortName: 'ST',
+			value: 'Some-State',
+		},
+		{
+			name: 'organizationName',
+			value: 'Temporary Testing Department Ltd',
+		},
+	]
+	cert.setSubject(attrs)
+	cert.setIssuer(attrs)
+
+	// add alt names so that the browser won't complain
+	cert.setExtensions([
+		{
+			name: 'subjectAltName',
+			altNames: [
+				...(altNameURIs !== undefined ? altNameURIs.map((uri) => ({ type: 6, value: uri })) : []),
+				...(altNameIPs !== undefined ? altNameIPs.map((uri) => ({ type: 7, ip: uri })) : []),
+			],
+		},
+	])
+	// self-sign certificate
+	cert.sign(keys.privateKey)
+
+	// convert a Forge certificate and private key to PEM
+	const pem = forge.pki.certificateToPem(cert)
+	const privateKey = forge.pki.privateKeyToPem(keys.privateKey)
+
+	return {
+		cert: pem,
+		privateKey,
+	}
+}
+
+const { log } = console
+
+const dirname = url.fileURLToPath(new URL('.', import.meta.url))
+
+const PORT = 5420
+const SSL_PORT = 5421
+const ENABLE_SSL = process.env.ENABLE_SSL === '1'
+const ENABLE_NETWORK_CACHING = process.env.ENABLE_NETWORK_CACHING === '1'
+const OUT_DIR = dirname + '/../www/'
+
+const clients = []
+
+async function main() {
+	await esbuild.build({
+		entryPoints: ['src/index.tsx'],
+		outdir: OUT_DIR,
+		bundle: true,
+		minify: false,
+		sourcemap: true,
+		incremental: true,
+		format: 'cjs',
+		external: ['*.woff'],
+		target: browserslist(['defaults']),
+		define: {
+			process: '{ "env": { "NODE_ENV": "development"} }',
+		},
+		loader: {
+			'.woff2': 'file',
+			'.svg': 'file',
+			'.json': 'file',
+			'.png': 'file',
+		},
+		watch: {
+			onRebuild(error) {
+				log('rebuilt')
+				if (error) {
+					log(error)
+				}
+				clients.forEach((res) => res.write('data: update\n\n'))
+				clients.length = 0
+			},
+		},
+	})
+
+	esbuild.serve({ servedir: OUT_DIR, port: 8009 }, {}).then(({ host, port: esbuildPort }) => {
+		const handler = async (req, res) => {
+			const { url, method, headers } = req
+			if (req.url === '/esbuild')
+				return clients.push(
+					res.writeHead(200, {
+						'Content-Type': 'text/event-stream',
+						'Cache-Control': 'no-cache',
+						Connection: 'keep-alive',
+					})
+				)
+
+			function forwardRequest(url) {
+				const path = (url?.split('/').pop()?.indexOf('.') ?? -1) > -1 ? url : `/index.html` //for PWA with router
+
+				if (LOG_REQUEST_PATHS) {
+					console.log('[%s]=', method, path)
+				}
+
+				const req2 = request(
+					{ hostname: host, port: esbuildPort, path, method, headers },
+					(prxRes) => {
+						const newHeaders = {
+							...prxRes.headers,
+						}
+
+						if (ENABLE_NETWORK_CACHING) {
+							const hrInSeconds = 60*60*60
+							newHeaders['cache-control'] = `max-age=${hrInSeconds}`;
+						}
+
+						if (url === '/index.js') {
+							const jsReloadCode =
+								' (() => new EventSource("/esbuild").onmessage = () => location.reload())();'
+
+							newHeaders['content-length'] = parseInt(prxRes.headers['content-length'] ?? '0', 10) + jsReloadCode.length,
+
+							res.writeHead(prxRes.statusCode ?? 0, newHeaders)
+							res.write(jsReloadCode)
+						} else {
+							res.writeHead(prxRes.statusCode ?? 0, newHeaders)
+						}
+						prxRes.pipe(res, { end: true })
+					}
+				)
+
+				req.pipe(req2, { end: true })
+			}
+
+			forwardRequest(url ?? '/')
+		}
+
+		const nonSslServer = createNonSslServer(handler)
+		nonSslServer.on('error', function (e) {
+			// Handle your error here
+			console.log(e)
+		})
+		nonSslServer.listen(PORT, () => {
+			log(`Running on:\n`)
+			log(chalk.bold().cyan(`  http://localhost:${PORT}`))
+			log(`\nNetwork:\n`)
+			log(chalk.bold().cyan(`  http://${ip.address()}:${PORT}`))
+		})
+
+		if (ENABLE_SSL) {
+			const cert = generateCert({
+				altNameIPs: ['127.0.0.1'],
+				altNameURIs: ['localhost'],
+				validityDays: 2,
+			})
+			const sslServer = createSslServer({ key: cert.privateKey, cert: cert.cert }, handler)
+			sslServer.on('error', function (e) {
+				// Handle your error here
+				console.log(e)
+			})
+			sslServer.listen(SSL_PORT, () => {
+				log(`Running on:\n`)
+				log(chalk.bold().cyan(`  https://localhost:${SSL_PORT}`))
+				log(`\nNetwork:\n`)
+				log(chalk.bold().cyan(`  https://${ip.address()}:${SSL_PORT}`))
+			})
+		}
+	})
+}
+
+main()

apps/webdriver/src/1-basic/BasicExampleWebdriver.tsx

@@ -0,0 +1,36 @@
+import { hardReset, Tldraw } from '@tldraw/tldraw'
+/* eslint-disable import/no-internal-modules */
+import { getAssetUrlsByImport } from '@tldraw/assets/imports'
+import '@tldraw/tldraw/editor.css'
+import '@tldraw/tldraw/ui.css'
+/* eslint-enable import/no-internal-modules */
+
+import { useEffect, useState } from 'react'
+
+declare global {
+	interface Window {
+		webdriverReset: () => void
+	}
+}
+
+const assetUrls = getAssetUrlsByImport()
+
+// NOTE: This is currently very similar to `apps/examples/src/1-basic/BasicExample.tsx`
+// and should probably stay that way to make writing new tests easier as it's
+// what we're most familiar with
+export default function Example() {
+	const [instanceKey, setInstanceKey] = useState(0)
+
+	useEffect(() => {
+		window.webdriverReset = () => {
+			hardReset({ shouldReload: false })
+			setInstanceKey(instanceKey + 1)
+		}
+	}, [instanceKey])
+
+	return (
+		<div className="tldraw__editor">
+			<Tldraw key={instanceKey} autoFocus assetUrls={assetUrls} />
+		</div>
+	)
+}

apps/webdriver/src/index.css

@@ -0,0 +1,25 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500&display=swap');
+
+html,
+body {
+	padding: 0;
+	margin: 0;
+	font-family: 'Inter', sans-serif;
+	overscroll-behavior: none;
+	touch-action: none;
+	min-height: 100vh;
+	/* mobile viewport bug fix */
+	min-height: -webkit-fill-available;
+	height: 100%;
+}
+
+html,
+* {
+	box-sizing: border-box;
+}
+
+.tldraw__editor {
+	position: fixed;
+	inset: 0px;
+	overflow: hidden;
+}

apps/webdriver/src/index.tsx

@@ -0,0 +1,27 @@
+import { DefaultErrorFallback, ErrorBoundary } from '@tldraw/tldraw'
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { RouterProvider, createBrowserRouter } from 'react-router-dom'
+import ExampleBasic from './1-basic/BasicExampleWebdriver'
+import './index.css'
+
+const router = createBrowserRouter([
+	{
+		path: '/',
+		element: <ExampleBasic />,
+	},
+])
+
+const rootElement = document.getElementById('root')
+const root = createRoot(rootElement!)
+
+root.render(
+	<StrictMode>
+		<ErrorBoundary
+			fallback={(error) => <DefaultErrorFallback error={error} />}
+			onError={(error) => console.error(error)}
+		>
+			<RouterProvider router={router} />
+		</ErrorBoundary>
+	</StrictMode>
+)

apps/webdriver/tsconfig.json

@@ -0,0 +1,29 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"useDefineForClassFields": true,
+		"lib": ["DOM", "DOM.Iterable", "ESNext"],
+		"allowJs": true,
+		"checkJs": true,
+		"skipLibCheck": true,
+		"esModuleInterop": true,
+		"removeComments": true,
+		"allowSyntheticDefaultImports": true,
+		"strict": true,
+		"forceConsistentCasingInFileNames": true,
+		"module": "ESNext",
+		"moduleResolution": "Node",
+		"resolveJsonModule": true,
+		"noEmit": true,
+		"jsx": "react-jsx",
+		"incremental": true,
+		"baseUrl": ".",
+		"composite": true,
+		"sourceMap": false,
+		"importHelpers": false,
+		"skipDefaultLibCheck": true,
+		"experimentalDecorators": true
+	},
+	"include": ["src", "scripts"],
+	"references": [{ "path": "../../packages/tldraw" }]
+}

apps/webdriver/www/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+	<head>
+		<meta charset="UTF-8" />
+		<link rel="icon" type="image/svg+xml" href="/tldraw.svg" />
+		<link id="manifest" rel="manifest" href="/manifest.json" />
+		<link rel="apple-touch-icon" sizes="180x180" href="/icons/apple-touch-icon.png" />
+		<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+		<title>tldraw</title>
+		<script type="module" crossorigin src="/index.js"></script>
+		<link rel="stylesheet" href="/index.css" />
+	</head>
+	<body>
+		<div id="root"></div>
+	</body>
+</html>

e2e/CHANGELOG.md

@@ -0,0 +1,175 @@
+# @tldraw/e2e
+
+## 2.0.0-alpha.8
+
+### Patch Changes
+
+- Release day!
+
+## 2.0.0-alpha.7
+
+### Patch Changes
+
+- Bug fixes.
+
+## 2.0.0-alpha.6
+
+### Patch Changes
+
+- Add licenses.
+
+## 2.0.0-alpha.5
+
+### Patch Changes
+
+- Add CSS files to tldraw/tldraw.
+
+## 2.0.0-alpha.4
+
+### Patch Changes
+
+- Add children to tldraw/tldraw
+
+## 2.0.0-alpha.3
+
+### Patch Changes
+
+- Change permissions.
+
+## 2.0.0-alpha.2
+
+### Patch Changes
+
+- Add tldraw, editor
+
+## 0.1.0-alpha.11
+
+### Patch Changes
+
+- Fix stale reactors.
+
+## 0.1.0-alpha.10
+
+### Patch Changes
+
+- Fix type export bug.
+
+## 0.1.0-alpha.9
+
+### Patch Changes
+
+- Fix import bugs.
+
+## 0.1.0-alpha.8
+
+### Patch Changes
+
+- Changes validation requirements, exports validation helpers.
+
+## 0.1.0-alpha.7
+
+### Patch Changes
+
+- - Pre-pre-release update
+
+## 0.0.2-alpha.1
+
+### Patch Changes
+
+- Fix error with HMR
+
+## 0.0.2-alpha.0
+
+### Patch Changes
+
+- Initial release
+
+## 0.0.1-alpha.0
+
+### Patch Changes
+
+- Initial release
+
+## 0.0.1-alpha.13
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.12
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.11
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.10
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.9
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.8
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.7
+
+### Patch Changes
+
+- -
+
+## 0.0.1-alpha.6
+
+### Patch Changes
+
+- 16495ef7: -
+
+## 0.0.1-alpha.5
+
+### Patch Changes
+
+- Changed a few things.
+
+## 0.0.1-alpha.4
+
+### Patch Changes
+
+- Remove bundling
+
+## 0.0.1-alpha.3
+
+### Patch Changes
+
+- Fix UI package.
+
+## 0.0.1-alpha.2
+
+### Patch Changes
+
+- Add modules to missing packages
+
+## 0.0.1-alpha.1
+
+### Patch Changes
+
+- Add module
+
+## 0.0.1-alpha.0
+
+### Patch Changes
+
+- Add css to dist

e2e/README.md

@@ -0,0 +1,298 @@
+# Webdriver
+
+This docs describes Webdriver testing within the app.
+
+Webdriver testing can be tricky because you're sending commands to an actual browser running on either you machine or browserstack. This can be slow but it's currently the only way to test things within a wide range of browsers without emulation. This give us the best chance of having a stable app across a range of browsers without excessive manual testing
+
+> **A note on stability**: Webdriver tests are a lot more flakey than other types of testing, the major benefit is that you can run them on real devices, so we can hopefully get a good smoke test of various real devices. You can also screenshot those devices during test runs, to check look. You however probably don't want to write too many webdriver tests, they are best placed for smoke testing and testing stuff that's very browser specific.
+
+To run the tests you first must start the server with
+
+```sh
+./scripts/e2e-start-server
+```
+
+You can then either test locally with
+
+```sh
+./scripts/e2e-run-tests local
+```
+
+By default it'll just run the chrome tests. You can also specify other browsers to run like this
+
+```sh
+# Note edge, safari are a work in progress and will just be skipped for now.
+./scripts/e2e-run-tests local firefox,chrome,edge,safari
+```
+
+Or to test remotely via browserstack
+
+```sh
+./scripts/e2e-run-tests remote
+```
+
+There are three parts to the testing API
+
+- `runtime` — the tldraw `App` instance in the browser window. This calls methods in the JS runtime of the app
+- `ui` — methods to interacting with the apps UI elements
+- `util` — some general helper methods
+
+The `ui` is further broken up into
+
+![test overview ui](test-overview-ui.png)
+
+tldraw room for above is at <https://www.tldraw.com/v/CZw_c_7vMVkHpMcMWcMm1z8ZpN>
+
+## Nightly tests
+We run all the tests on all browsers via browserstack each night at 02:00am. You can search https://github.com/tldraw/tldraw-lite/actions/workflows/webdriver-nightly.yml for the results of the previous evenings tests
+
+## On demand tests
+To run tests on demand via github actions you can head to https://github.com/tldraw/tldraw-lite/actions/workflows/webdriver-on-demand.yml and select **run workflow** with you desired options and press the **run workflow** button
+
+https://user-images.githubusercontent.com/235915/233660925-866d2db3-66f9-4e6c-b19a-8da597c8b512.mov
+
+## Ongoing issues
+
+You can see the on-going test issues in the project at <https://linear.app/tldraw/project/webdriver-tests-409b44580c4a/TLD>
+
+Performance is a little slow remotely mostly to do with
+
+- startup time of the browser, see <https://linear.app/tldraw/issue/TLD-1301/find-way-to-prevent-runner-from-running-if-all-tests-are-skipped-for>
+- app reset/refresh time, see <https://linear.app/tldraw/issue/TLD-1293/webdriver-setup-performance>
+
+## Writing new tests
+
+There are target tests with the `.todo(...)` suffix, an example might be
+
+https://github.com/tldraw/tldraw-lite/blob/7ff0dd111bb9bf9b931d53f61722842780d9793e/e2e/test/specs/shortcuts.ts#L114
+
+The missing tests (`.todo`) follow a lot of the same patterns that already exist in the codebase. Firefox is skipped quite a lot in the test runners, this is due to issues with the app and tests, so those also need to be resolved. You can search for `FIXME` in the `./e2e` directory to find those.
+
+## Test writing guide
+
+Below explains the process of writing a new test. Most actions don't have anything specific for a particular browser, however most actions do have specifics per-layout and viewport size. Lets walk through and explain a very simple test, the draw shortcut.
+
+When pressing `d` in the browser on a desktop environment we should be changing the current state to `draw.idle`. Below is the test comments in line.
+
+```js
+// These are helpers that we use in our tests to interact with our app via the browser.
+import { runtime, ui } from '../helpers'
+
+// The runner uses mocha, `env` is an addition added by mocha-ext and `it` is
+// extended to support skipping of tests in certain environments.
+import { describe, env, it } from '../mocha-ext'
+
+// Always group tests, this make them easy to run in isolation by changing
+// `describe(...)` to `describe.only(...)`
+describe('shortcuts', () => {
+    // The `env` command is used to mark groups of tests as skippable under
+    // certain conditions, here we're only running these tests under desktop
+    // environments. Note that is **REALLY** important we don't just wrap this
+    // in a `if(FOO) {...}` block. Otherwise `.only` would break under certain
+    // circumstances
+    env({ device: 'desktop' }, () => {
+        // We haven't written this test yet, we can mark those with a `.todo`
+        // This appears as `[TODO] {test name}` in the test output.
+        it.todo('select — V', async () => {
+            await ui.app.setup()
+            await browser.keys(['v'])
+        })
+
+        // Here is our draw shortcut test, all tests are going to be async as
+        // commands are sent to the browser over HTTP
+        it('draw — D', async () => {
+            // We must always `setup` our app. This starts the browser (if it
+            // isn't already) and does a hard reset. Note **NEVER** do this in
+            // a mocha `before(...)` hook. Else you'll end up starting the browser
+            // (doing heavy work) whether or not you actually run the test suite.
+            // I believe this is a mocha/webdriver integration bug.
+            await ui.app.setup()
+
+            // `browser` is a global from <https://webdriver.io/docs/api/browser>
+            // This is the default way to interact with the browser. There are
+            // also lots of helpers in `import { ui } from '../helpers'` module.
+            // Here we're instructing the browser to enter `d` to the currently
+            // selected element
+            await browser.keys(['d'])
+
+            // Although we've pressed `d` we don't know how long that's going to
+            // take to process in the browser. A slow environment might take
+            // sometime to update the runtime. So we use `waitUntil` to wait
+            // for the change. **DON'T** use `util.sleep(...)` here as this will
+            // only work if the browser/env is fast and will generally slow down
+            // the test runner and make things flakey.
+            await browser.waitUntil(async () => {
+                // `runtime` executes JS in the JS-runtime on the device. This
+                // is to test for conditions to be met.
+                return await runtime.isIn('draw.idle')
+            })
+        })
+```
+
+To run the above tests, we'd probably want to first isolate the test and `only` run a single test, or test group. Change
+
+```diff
+-        it('draw — D', async () => {
++        it.only('draw — D', async () => {
+```
+
+Now lets start the dev server and run the tests locally. In one terminal session run
+
+```sh
+./scripts/e2e-start-server
+```
+
+In another terminal session run
+
+```sh
+./scripts/e2e-run-tests local
+```
+
+The test should run twice in chrome. Once in desktop chrome and once chrome mobile emulation mode. The results should look something like
+
+```
+------------------------------------------------------------------
+[chrome 109.0.5414.119 mac os x #0-0] Running: chrome (v109.0.5414.119) on mac os x
+[chrome 109.0.5414.119 mac os x #0-0] Session ID: 599e14341d743b938056560f3a467361
+[chrome 109.0.5414.119 mac os x #0-0]
+[chrome 109.0.5414.119 mac os x #0-0] » /test/specs/index.ts
+[chrome 109.0.5414.119 mac os x #0-0] shortcuts
+[chrome 109.0.5414.119 mac os x #0-0]    ✓ draw — D (ignored only: desktop)
+[chrome 109.0.5414.119 mac os x #0-0]
+[chrome 109.0.5414.119 mac os x #0-0] 1 passing (59ms)
+------------------------------------------------------------------
+[chrome 109.0.5414.119 mac os x #1-0] Running: chrome (v109.0.5414.119) on mac os x
+[chrome 109.0.5414.119 mac os x #1-0] Session ID: 2b813d4f8793f910c1a02f771438e3f7
+[chrome 109.0.5414.119 mac os x #1-0]
+[chrome 109.0.5414.119 mac os x #1-0] » /test/specs/index.ts
+[chrome 109.0.5414.119 mac os x #1-0] shortcuts
+[chrome 109.0.5414.119 mac os x #1-0]    ✓ draw — D
+[chrome 109.0.5414.119 mac os x #1-0]
+[chrome 109.0.5414.119 mac os x #1-0] 1 passing (2s)
+
+
+Spec Files:     2 passed, 2 total (100% completed) in 00:00:05
+```
+
+Yay, passing tests 🎉
+
+However we're not done quite yet. Next up, we need to test them across the rest of our supported browsers. With the `e2e-start-server` still running
+
+```sh
+./scripts/e2e-run-tests remote
+```
+
+This will start a tunnel from browserstack to your local machine, running the tests against the local server. You can head to browserstack to see the completed test suite <https://automate.browserstack.com/dashboard/v2/builds/2d87ffb21f5466b93e6ef8b4007df995d23da7b3>
+
+In you terminal you should see the results
+
+```
+------------------------------------------------------------------
+[chrome 110.0.5481.78 windows #0-0] Running: chrome (v110.0.5481.78) on windows
+[chrome 110.0.5481.78 windows #0-0] Session ID: 5123d74060f5dac19a960c50476b32007d71b758
+[chrome 110.0.5481.78 windows #0-0]
+[chrome 110.0.5481.78 windows #0-0] » /test/specs/index.ts
+[chrome 110.0.5481.78 windows #0-0] shortcuts
+[chrome 110.0.5481.78 windows #0-0]    ✓ draw — D
+[chrome 110.0.5481.78 windows #0-0]
+[chrome 110.0.5481.78 windows #0-0] 1 passing (36.1s)
+------------------------------------------------------------------
+[msedge 109.0.1518.49 WINDOWS #1-0] Running: msedge (v109.0.1518.49) on WINDOWS
+[msedge 109.0.1518.49 WINDOWS #1-0] Session ID: fd44f7771955021532c16a151b2ccb7657d53cda
+[msedge 109.0.1518.49 WINDOWS #1-0]
+[msedge 109.0.1518.49 WINDOWS #1-0] » /test/specs/index.ts
+[msedge 109.0.1518.49 WINDOWS #1-0] shortcuts
+[msedge 109.0.1518.49 WINDOWS #1-0]    ✓ draw — D
+[msedge 109.0.1518.49 WINDOWS #1-0]
+[msedge 109.0.1518.49 WINDOWS #1-0] 1 passing (9.2s)
+------------------------------------------------------------------
+[firefox 109.0 WINDOWS #2-0] Running: firefox (v109.0) on WINDOWS
+[firefox 109.0 WINDOWS #2-0] Session ID: b590ddccd02ee3a9f3f0ebb92c19d2c5f81421b9
+[firefox 109.0 WINDOWS #2-0]
+[firefox 109.0 WINDOWS #2-0] » /test/specs/index.ts
+[firefox 109.0 WINDOWS #2-0] shortcuts
+[firefox 109.0 WINDOWS #2-0]    ✓ draw — D
+[firefox 109.0 WINDOWS #2-0]
+[firefox 109.0 WINDOWS #2-0] 1 passing (14.4s)
+------------------------------------------------------------------
+[chrome 110.0.5481.77 MAC #3-0] Running: chrome (v110.0.5481.77) on MAC
+[chrome 110.0.5481.77 MAC #3-0] Session ID: 12d8c60cfb3a20b516b300191e12c4d71952d607
+[chrome 110.0.5481.77 MAC #3-0]
+[chrome 110.0.5481.77 MAC #3-0] » /test/specs/index.ts
+[chrome 110.0.5481.77 MAC #3-0] shortcuts
+[chrome 110.0.5481.77 MAC #3-0]    ✓ draw — D
+[chrome 110.0.5481.77 MAC #3-0]
+[chrome 110.0.5481.77 MAC #3-0] 1 passing (10.9s)
+------------------------------------------------------------------
+[firefox 109.0 MAC #4-0] Running: firefox (v109.0) on MAC
+[firefox 109.0 MAC #4-0] Session ID: be2fae1429977f192be311c7a1f6a177c0ff6170
+[firefox 109.0 MAC #4-0]
+[firefox 109.0 MAC #4-0] » /test/specs/index.ts
+[firefox 109.0 MAC #4-0] shortcuts
+[firefox 109.0 MAC #4-0]    ✓ draw — D
+[firefox 109.0 MAC #4-0]
+[firefox 109.0 MAC #4-0] 1 passing (9.5s)
+------------------------------------------------------------------
+[msedge 109.0.1518.49 MAC #5-0] Running: msedge (v109.0.1518.49) on MAC
+[msedge 109.0.1518.49 MAC #5-0] Session ID: 0e59617ae8ac7e5403270c204e1108aa0b2a6c62
+[msedge 109.0.1518.49 MAC #5-0]
+[msedge 109.0.1518.49 MAC #5-0] » /test/specs/index.ts
+[msedge 109.0.1518.49 MAC #5-0] shortcuts
+[msedge 109.0.1518.49 MAC #5-0]    ✓ draw — D
+[msedge 109.0.1518.49 MAC #5-0]
+[msedge 109.0.1518.49 MAC #5-0] 1 passing (8s)
+------------------------------------------------------------------
+[2B111FDH2007PR Android 13 #6-0] Running: 2B111FDH2007PR on Android 13 executing chrome
+[2B111FDH2007PR Android 13 #6-0] Session ID: 4317967dd4e85cff839a7965a34707a2c839e748
+[2B111FDH2007PR Android 13 #6-0]
+[2B111FDH2007PR Android 13 #6-0] » /test/specs/index.ts
+[2B111FDH2007PR Android 13 #6-0] shortcuts
+[2B111FDH2007PR Android 13 #6-0]    ✓ draw — D (ignored only: desktop)
+[2B111FDH2007PR Android 13 #6-0]
+[2B111FDH2007PR Android 13 #6-0] 1 passing (1.6s)
+------------------------------------------------------------------
+[R5CR10PDY5Y Android 11 #7-0] Running: R5CR10PDY5Y on Android 11
+[R5CR10PDY5Y Android 11 #7-0] Session ID: 696e16707b7d9bfdcfc04d3dca08e4579a91af18
+[R5CR10PDY5Y Android 11 #7-0]
+[R5CR10PDY5Y Android 11 #7-0] » /test/specs/index.ts
+[R5CR10PDY5Y Android 11 #7-0] shortcuts
+[R5CR10PDY5Y Android 11 #7-0]    ✓ draw — D (ignored only: desktop)
+[R5CR10PDY5Y Android 11 #7-0]
+[R5CR10PDY5Y Android 11 #7-0] 1 passing (1.8s)
+------------------------------------------------------------------
+[R3CR909M44J Android 11 #8-0] Running: R3CR909M44J on Android 11 executing chrome
+[R3CR909M44J Android 11 #8-0] Session ID: 797cf525cd07f287281a2051075e0b5e5edc9fd2
+[R3CR909M44J Android 11 #8-0]
+[R3CR909M44J Android 11 #8-0] » /test/specs/index.ts
+[R3CR909M44J Android 11 #8-0] shortcuts
+[R3CR909M44J Android 11 #8-0]    ✓ draw — D (ignored only: desktop)
+[R3CR909M44J Android 11 #8-0]
+[R3CR909M44J Android 11 #8-0] 1 passing (2.1s)
+
+
+Spec Files:	 9 passed, 9 total (100% completed) in 00:03:51
+```
+
+Now you can remove the `.only` and open a PR and rejoice in your new found skills.
+
+```diff
+-        it.only('draw — D', async () => {
++        it('draw — D', async () => {
+```
+
+Existing tests are a good guide for writing more advance tests, hopefully this should give you a start 🤞
+
+
+## Notes
+
+### `msedgedriver`
+You might notice that `msedgedriver` on version 91, and hasn't been updated in a while. 
+
+```
+"msedgedriver": "^91.0.0",
+```
+
+This module isn't actually used but is required for `wdio-edgedriver-service` to start where we pass a custom path via the `edgedriverCustomPath` option.
+
+### `safaridriver`
+Locally safari webdriver tests are currently somewhat buggy, there appear to be some tests that don't complete. Please take on this task if you have time 🙂 

e2e/downloads/README.md

@@ -0,0 +1,3 @@
+# downloads
+
+Location for temporary downloads.

e2e/package.json

@@ -0,0 +1,61 @@
+{
+	"name": "@tldraw/e2e",
+	"version": "2.0.0-alpha.8",
+	"private": true,
+	"packageManager": "yarn@3.5.0",
+	"author": {
+		"name": "tldraw GB Ltd.",
+		"email": "hello@tldraw.com"
+	},
+	"homepage": "https://tldraw.dev",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/tldraw/tldraw"
+	},
+	"bugs": {
+		"url": "https://github.com/tldraw/tldraw/issues"
+	},
+	"keywords": [
+		"tldraw",
+		"drawing",
+		"app",
+		"development",
+		"whiteboard",
+		"canvas",
+		"infinite"
+	],
+	"scripts": {
+		"test:local": "TS_NODE_PROJECT=./tsconfig.json wdio run wdio.local.conf.js",
+		"test:remote": "TS_NODE_PROJECT=./tsconfig.json wdio run wdio.remote.conf.js",
+		"test:nightly": "TS_NODE_PROJECT=./tsconfig.json wdio run wdio.nightly.conf.js",
+		"lint": "yarn run -T tsx ../scripts/lint.ts"
+	},
+	"devDependencies": {
+		"@sitespeed.io/edgedriver": "^112.0.1722-34",
+		"@tldraw/editor": "workspace:*",
+		"@tldraw/primitives": "workspace:*",
+		"@types/mocha": "^10.0.1",
+		"@types/sharp": "^0.31.1",
+		"@wdio/browserstack-service": "^8.1.3",
+		"@wdio/cli": "^8.1.3",
+		"@wdio/globals": "^8.1.3",
+		"@wdio/local-runner": "^8.1.2",
+		"@wdio/mocha-framework": "^8.1.2",
+		"@wdio/spec-reporter": "^8.1.2",
+		"chromedriver": "^112.0.0",
+		"geckodriver": "^3.2.0",
+		"lazyrepo": "0.0.0-alpha.26",
+		"msedgedriver": "^91.0.0",
+		"pixelmatch": "^5.3.0",
+		"pngjs": "^6.0.0",
+		"sharp": "^0.31.2",
+		"ts-node-dev": "^2.0.0",
+		"ua-parser-js": "^1.0.33",
+		"wdio-chromedriver-service": "^8.0.1",
+		"wdio-edgedriver-service": "^2.1.2",
+		"wdio-geckodriver-service": "^4.1.1",
+		"wdio-safaridriver-service": "^2.1.0",
+		"wdio-vscode-service": "^5.0.0"
+	}
+}

e2e/screenshots/README.md

@@ -0,0 +1,3 @@
+# screenshots
+
+Location for temporary screenshots.

e2e/test/helpers/constants.ts

@@ -0,0 +1,3 @@
+export const MOVE_DEFAULTS = {
+	duration: 20,
+}

e2e/test/helpers/index.ts

@@ -0,0 +1,4 @@
+export { MOVE_DEFAULTS } from './constants'
+export * as runtime from './runtime'
+export * as ui from './ui'
+export * as util from './util'

e2e/test/helpers/runtime.ts

@@ -0,0 +1,46 @@
+import { App, TLShape } from '@tldraw/editor'
+import { Box2d } from '@tldraw/primitives'
+
+declare global {
+	interface Window {
+		app: App
+		webdriverReset: () => void
+	}
+}
+
+export async function isIn(path: string) {
+	return await browser.execute((path) => window.app.isIn(path), path)
+}
+
+export async function propsForNextShape() {
+	return await browser.execute(() => window.app.instanceState.propsForNextShape)
+}
+
+export function getAllShapes() {
+	return browser.execute(() => window.app.shapesArray)
+}
+export async function getShapesOfType(...types: TLShape['type'][]) {
+	return await browser.execute((types) => {
+		return window.app.store
+			.allRecords()
+			.filter((s) => s.typeName === 'shape' && types.includes(s.type))
+	}, types)
+}
+
+export async function selectionBounds(): Promise<Box2d> {
+	return await browser.execute(() => {
+		return window.app.selectionBounds
+	})
+}
+
+export async function getCamera() {
+	return await browser.execute(() => {
+		const { x, y, z } = window.app.camera
+		return { x, y, z }
+	})
+}
+export async function hardReset() {
+	await browser.execute(() => {
+		window.webdriverReset()
+	})
+}

e2e/test/helpers/ui/app.ts

@@ -0,0 +1,112 @@
+import { ui, util } from '..'
+import * as runtime from '../runtime'
+
+export function wd(key: string) {
+	return `*[data-wd="${key}"]`
+}
+
+export async function pointWithinActiveArea(x: number, y: number) {
+	const offsetX = 0
+	const offsetY = 52
+	return { x: x + offsetX, y: y + offsetY }
+}
+
+export async function waitForReady() {
+	await browser.waitUntil(() => {
+		return browser.execute(() => {
+			return window.tldrawReady
+		})
+	})
+
+	// Make sure the window is focused... maybe
+	await ui.canvas.click(100, 100)
+
+	// Note: We need to not trigger the double click handler here so we need to wait a little bit.
+	await util.sleep(300)
+}
+
+export async function hardReset() {
+	await runtime.hardReset()
+	await waitForReady()
+}
+
+export async function open() {
+	await browser.url(global.webdriverTestUrl ?? `https://localhost:5420/`)
+	/**
+	 * HACK: vscode doesn't support `browser.setWindowSize` so we use the
+	 * default size.
+	 *
+	 * This will break things currently if run on a small screen.
+	 */
+	if (global.tldrawOptions.windowSize !== 'default') {
+		const windowSize = global.tldrawOptions.windowSize ?? [1200, 1200]
+		await browser.setWindowSize(windowSize[0], windowSize[1])
+	}
+
+	await waitForReady()
+	global.isWindowOpen = true
+}
+
+export async function shapesAsImgData() {
+	return await browser.execute(async () => {
+		return await window.app
+			.getSvg([...window.app.shapeIds], { padding: 0, background: true })
+			.then(async (svg) => {
+				const svgStr = new XMLSerializer().serializeToString(svg)
+				const svgImage = document.createElement('img')
+				document.body.appendChild(svgImage)
+				svgImage.src = URL.createObjectURL(
+					new Blob([svgStr], {
+						type: 'image/svg+xml',
+					})
+				)
+
+				const dpr = window.devicePixelRatio
+
+				return await new Promise<{
+					width: number
+					height: number
+					dpr: number
+					data: string
+				}>((resolve) => {
+					svgImage.onload = () => {
+						const width = parseInt(svg.getAttribute('width'))
+						const height = parseInt(svg.getAttribute('height'))
+
+						const canvas = document.createElement('canvas')
+						canvas.width = width * dpr
+						canvas.height = height * dpr
+						const canvasCtx = canvas.getContext('2d')
+						canvasCtx.drawImage(svgImage, 0, 0, width * dpr, height * dpr)
+						const imgData = canvas.toDataURL('image/png')
+						resolve({
+							dpr: dpr,
+							width: width * dpr,
+							height: height * dpr,
+							data: imgData,
+						})
+					}
+				})
+			})
+	})
+}
+
+global.isWindowOpen = false
+
+export async function setup() {
+	if (!global.isWindowOpen) {
+		await open()
+	} else {
+		await hardReset()
+	}
+}
+
+export async function getElementByWd(...selectors: string[]) {
+	for (const possibleSelector of selectors) {
+		const element = wd(possibleSelector)
+		const isDisplayed = await $(element).isDisplayed()
+		if (isDisplayed) {
+			return $(element)
+		}
+	}
+}

e2e/test/helpers/ui/canvas.ts

@@ -0,0 +1,98 @@
+import { MOVE_DEFAULTS } from '../constants'
+import { getElementByWd, pointWithinActiveArea, wd } from './app'
+
+export async function brush(x1: number, y1: number, x2: number, y2: number) {
+	const start = await pointWithinActiveArea(x1, y1)
+	const end = await pointWithinActiveArea(x2, y2)
+
+	await browser
+		.action('pointer')
+		.move({ ...start, ...MOVE_DEFAULTS })
+		.down()
+		.move(end)
+		.up()
+		.perform()
+}
+
+export async function draw(points: { x: number; y: number }[]) {
+	const mappedPoints = []
+	for (const point of points) {
+		mappedPoints.push(await pointWithinActiveArea(point.x, point.y))
+	}
+
+	let chain = browser.action('pointer')
+	for (const [index, mappedPoint] of mappedPoints.entries()) {
+		if (index === 0) {
+			chain = chain.move({ ...mappedPoint, ...MOVE_DEFAULTS }).down()
+		} else {
+			chain = chain.move({ ...mappedPoint, ...MOVE_DEFAULTS })
+		}
+	}
+	await chain.perform()
+}
+
+export async function click(x1: number, y1: number) {
+	const start = await pointWithinActiveArea(x1, y1)
+	await browser
+		.action('pointer')
+		.move({ ...start, ...MOVE_DEFAULTS })
+		.down()
+		.up()
+		.perform()
+}
+
+export async function doubleClick(x1: number, y1: number) {
+	const start = await pointWithinActiveArea(x1, y1)
+	await browser
+		.action('pointer')
+		.move({ ...start, ...MOVE_DEFAULTS })
+		.down()
+		.up()
+		.down()
+		.up()
+		.perform()
+}
+
+export async function dragBy(target: WebdriverIO.Element, dx: number, dy: number) {
+	const loc = await target.getLocation()
+	const size = await target.getSize()
+	const locX = Math.floor(loc.x) + Math.floor(size.width / 2)
+	const locY = Math.floor(loc.y) + Math.floor(size.height / 2)
+
+	const startX = locX
+	const startY = locY
+	const endX = locX + dx
+	const endY = locY + dy
+
+	await browser.actions([
+		browser
+			.action('pointer')
+			.move({ x: startX, y: startY, ...MOVE_DEFAULTS })
+			.down('left')
+			.move({ x: endX, y: endY, ...MOVE_DEFAULTS })
+			.up(),
+	])
+}
+
+export async function contextMenu(x: number, y: number, path: string[] = []) {
+	await browser
+		.action('pointer')
+		.move({ x, y, ...MOVE_DEFAULTS })
+		.down('right')
+		.up()
+		.perform()
+	// await $(wd('active-area')).click({button: 2, x, y})
+
+	for await (const item of path) {
+		await $(wd(`menu-item.${item}`)).waitForExist()
+		await $(wd(`menu-item.${item}`)).click()
+	}
+}
+
+export async function clickTextInput() {
+	await (await $(wd(`canvas`) + ' textarea')).click()
+}
+
+export async function selectionHandle(...possibleSelectors: string[]) {
+	return getElementByWd(...possibleSelectors.map((s) => `selection.${s}`))
+}

e2e/test/helpers/ui/help.ts

@@ -0,0 +1,3 @@
+export async function menu(_path: string[] = []) {
+	// TODO...
+}

e2e/test/helpers/ui/index.ts

@@ -0,0 +1,8 @@
+export * as app from './app'
+export * as canvas from './canvas'
+export * as help from './help'
+export * as main from './main'
+export * as minimap from './minimap'
+export * as props from './props'
+export * as share from './share'
+export * as tools from './tools'

e2e/test/helpers/ui/main.ts

@@ -0,0 +1,21 @@
+import { wd } from './app'
+
+export async function menu(path = []) {
+	await $(wd('main.menu')).click()
+
+	for await (const item of path) {
+		await $(wd(`menu-item.${item}`)).click()
+	}
+}
+
+export async function actionMenu(path = []) {
+	await $(wd('main.action-menu')).click()
+
+	for await (const item of path) {
+		await $(wd(`menu-item.${item}`)).click()
+	}
+}
+
+export async function click(key: string) {
+	await $(wd(`main.${key}`)).click()
+}

e2e/test/helpers/ui/minimap.ts

@@ -0,0 +1,45 @@
+import { wd } from './app'
+
+export function $element() {
+	return $(wd('minimap'))
+}
+
+export async function zoomIn() {
+	const button = wd(`minimap.zoom-in`)
+	const toggle = wd(`minimap.toggle`)
+
+	if (await $(button).isExisting()) {
+		await $(button).click()
+	} else if (await $(wd(`minimap.toggle`)).isExisting()) {
+		await $(toggle).click()
+		await $(button).click()
+	}
+
+	return this
+}
+
+export async function zoomOut() {
+	const button = wd(`minimap.zoom-out`)
+	const toggle = wd(`minimap.toggle`)
+
+	if (await $(button).isExisting()) {
+		await $(button).click()
+	} else if (await $(wd(`minimap.toggle`)).isExisting()) {
+		await $(toggle).click()
+		await $(button).click()
+	}
+
+	return this
+}
+
+export async function menuButton() {
+	return await $(wd('minimap.zoom-menu'))
+}
+
+export async function menu(path: string[] = []) {
+	await $(wd('minimap.zoom-menu')).click()
+
+	for await (const item of path) {
+		await $(wd(`minimap.zoom-menu.${item}`)).click()
+	}
+}

e2e/test/helpers/ui/props.ts

@@ -0,0 +1,54 @@
+import { wd } from './app'
+
+export async function ifMobileOpenStylesMenu() {
+	if (globalThis.tldrawOpts.ui === 'mobile') {
+		await $(wd(`mobile.styles`)).click()
+	}
+}
+
+export async function selectColor(color: string) {
+	await $(wd(`style.color.${color}`)).click()
+}
+
+export async function selectFill(fill: string) {
+	await $(wd(`style.fill.${fill}`)).click()
+}
+
+export async function selectStroke(stroke: string) {
+	await $(wd(`style.dash.${stroke}`)).click()
+}
+
+export async function selectSize(size: string) {
+	await $(wd(`style.size.${size}`)).click()
+}
+
+export async function selectSpline(type: string) {
+	await $(wd(`style.spline`)).click()
+	await $(wd(`style.spline.${type}`)).click()
+}
+
+export async function selectOpacity(_opacity: number) {
+	// TODO...
+}
+
+export async function selectShape() {
+	// TODO...
+}
+
+export async function selectFont(font: string) {
+	await $(wd(`font.${font}`)).click()
+}
+
+export async function selectAlign(alignment: string) {
+	await $(wd(`align.${alignment}`)).click()
+}
+
+export async function selectArrowheadStart(type: string) {
+	await $(wd(`style.arrowheads.start`)).click()
+	await $(wd(`style.arrowheads.start.${type}`)).click()
+}
+
+export async function selectArrowheadEnd(type: string) {
+	await $(wd(`style.arrowheads.end`)).click()
+	await $(wd(`style.arrowheads.end.${type}`)).click()
+}

e2e/test/helpers/ui/share.ts

@@ -0,0 +1 @@
+export async function menu(_path: string[] = []) {}

e2e/test/helpers/ui/tools.ts

@@ -0,0 +1,21 @@
+import { wd } from './app'
+
+export function $element() {
+	return $(wd('tools'))
+}
+
+export async function click(toolName: string) {
+	// Check if `tools.mobile-more` exists
+	// Check ifisExisting()
+	const toolSelector = wd(`tools.${toolName}`)
+	const moreSelector = wd(`tools.more`)
+
+	if (await $(toolSelector).isExisting()) {
+		await $(toolSelector).click()
+	} else if (await $(moreSelector).isExisting()) {
+		await $(moreSelector).click()
+		await $(toolSelector).click()
+	}
+
+	return this
+}

e2e/test/helpers/util.ts

@@ -0,0 +1,139 @@
+import fs from 'fs'
+import { ui } from '.'
+
+export async function textToClipboard(text: string) {
+	const html = `<p id="copy_target">${text}</p>`
+	const url = `data:text/html;base64,${btoa(html)}`
+
+	await browser.newWindow('', {
+		windowName: 'copy_target',
+		// windowFeatures: 'width=420,height=230,resizable,scrollbars=yes,status=1',
+	})
+	await browser.url(url)
+	await $('#copy_target').waitForExist()
+
+	await $('#copy_target').click()
+
+	// For some reason the import isn't working...
+	// From <https://github.com/webdriverio/webdriverio/blob/3620e90e47b6d3e62832f5de24f43cee6b31e972/packages/webdriverio/src/constants.ts#L360>
+	const cmd = 'WDIO_CONTROL'
+
+	// Select all
+	await browser.action('key').down(cmd).down('a').up(cmd).up('a').perform()
+
+	await browser.execute(() => new Promise((resolve) => setTimeout(resolve, 3000)))
+
+	// Copy
+	await browser.action('key').down(cmd).down('c').up(cmd).up('c').perform()
+
+	await browser.closeWindow()
+
+	const handles = await browser.getWindowHandles()
+	await browser.switchToWindow(handles[0])
+}
+
+const LOCAL_DOWNLOAD_DIR = process.env.DOWNLOADS_DIR
+	? process.env.DOWNLOADS_DIR + '/'
+	: __dirname + '/../../downloads/'
+export async function getDownloadFile(fileName: string) {
+	if (global.webdriverService === 'browserstack') {
+		// In browserstack we must grab it from the service
+		// <https://www.browserstack.com/docs/automate/selenium/test-file-download#nodejs>
+		// Note this only works on desktop devices.
+		const base64String = await browser.executeScript(
+			`browserstack_executor: {"action": "getFileContent", "arguments": {"fileName": "${fileName}"}}`,
+			[]
+		)
+		const buffer = Buffer.from(base64String, 'base64')
+		return buffer
+	} else {
+		// Locally we can grab the file from the `LOCAL_DOWNLOAD_DIR`
+		return await fs.promises.readFile(LOCAL_DOWNLOAD_DIR + fileName)
+	}
+}
+
+export async function imageToClipboard(_buffer: Buffer) {
+	// TODO...
+}
+
+export async function htmlToClipboard(_html: string) {
+	// TODO...
+}
+
+export async function nativeCopy() {
+	// CMD+C
+	await browser.action('key').down('WDIO_CONTROL').down('c').up('WDIO_CONTROL').up('c').perform()
+}
+
+export async function nativePaste() {
+	// CMD+V
+	await browser.action('key').down('WDIO_CONTROL').down('v').up('WDIO_CONTROL').up('v').perform()
+}
+
+export async function deleteAllShapesOnPage() {
+	await ui.main.menu(['edit', 'select-all'])
+	await ui.main.menu(['edit', 'delete'])
+}
+
+export async function sleep(ms: number) {
+	await browser.execute((ms) => new Promise((resolve) => setTimeout(resolve, ms)), ms)
+}
+
+export async function clearClipboard() {
+	return await browser.execute(async () => {
+		if (navigator.clipboard.write) {
+			await navigator.clipboard.write([
+				new ClipboardItem({
+					'text/plain': new Blob(['CLEAR'], { type: 'text/plain' }),
+				}),
+			])
+		} else {
+			await navigator.clipboard.writeText('')
+		}
+	})
+}
+
+export async function grantPermissions(permissions: 'clipboard-read'[]) {
+	for (const permission of permissions) {
+		await browser.setPermissions(
+			{
+				name: permission,
+			},
+			'granted'
+		)
+	}
+}
+
+// Checks that the clipboard is no-longer "clear" see 'clearClipboard' above
+export async function waitForClipboardContents() {
+	return await browser.waitUntil(async () => {
+		return await browser.execute(async () => {
+			const results = await navigator.clipboard.read()
+			if (results.length < 0) {
+				return true
+			}
+			return (
+				!results[0].types.includes('text/plain') ||
+				(await (await results[0].getType('text/plain')).text()) !== 'CLEAR'
+			)
+		})
+	})
+}
+
+export async function clipboardContents() {
+	return await browser.execute(async () => {
+		const results = await navigator.clipboard.read()
+		const contents = []
+
+		for (const result of results) {
+			const item = {}
+			for (const type of result.types) {
+				item[type] = type.match(/^text/)
+					? await (await result.getType(type)).text()
+					: await (await result.getType(type)).arrayBuffer()
+			}
+			contents.push(item)
+		}
+		return contents
+	})
+}

e2e/test/helpers/webdriver.ts

@@ -0,0 +1,95 @@
+import { Box2d } from '@tldraw/primitives'
+import fs from 'fs'
+import pixelmatch from 'pixelmatch'
+import pngjs from 'pngjs'
+import sharp from 'sharp'
+import { app } from './ui'
+
+const PNG = pngjs.PNG
+
+type takeRegionScreenshotOpts = {
+	writeTo: {
+		path: string
+		prefix: string
+	}
+}
+type takeRegionScreenshotResult = {
+	browserBuffer: Buffer
+	exportBuffer: Buffer
+	fullWidth: any
+	fullHeight: any
+}
+export async function takeRegionScreenshot(
+	bbox: Box2d,
+	opts?: takeRegionScreenshotOpts
+): Promise<takeRegionScreenshotResult> {
+	const { data, dpr } = await app.shapesAsImgData()
+
+	const base64 = await browser.takeScreenshot()
+	const bufferInput = Buffer.from(data.replace('data:image/png;base64,', ''), 'base64')
+
+	const { data: exportBuffer, info: origInfo } = await sharp(bufferInput)
+		.png()
+		.toBuffer({ resolveWithObject: true })
+
+	const fullWidth = Math.floor(origInfo.width)
+	const fullHeight = Math.floor(origInfo.height)
+
+	const binary = Buffer.from(base64, 'base64')
+
+	const browserBuffer = await sharp(binary)
+		.extract({
+			left: Math.floor(bbox.x * dpr),
+			top: Math.floor(bbox.y * dpr),
+			width: Math.floor(bbox.w * dpr),
+			height: Math.floor(bbox.h * dpr),
+		})
+		.resize({ width: fullWidth, height: fullHeight })
+		.png()
+		.toBuffer()
+
+	if (opts.writeTo) {
+		const { path: writeToPath, prefix: writeToPrefix } = opts.writeTo
+		await fs.promises.writeFile(
+			`${__dirname}/../../screenshots/${writeToPrefix}-app.png`,
+			exportBuffer
+		)
+		await fs.promises.writeFile(`${writeToPath}/${writeToPrefix}-svg.png`, exportBuffer)
+	}
+
+	return {
+		browserBuffer,
+		exportBuffer,
+		fullWidth,
+		fullHeight,
+	}
+}
+
+type diffScreenshotOpts = {
+	writeTo: {
+		path: string
+		prefix: string
+	}
+}
+export async function diffScreenshot(
+	screenshotRegion: takeRegionScreenshotResult,
+	opts?: diffScreenshotOpts
+) {
+	const { exportBuffer, browserBuffer, fullWidth, fullHeight } = screenshotRegion
+	const diff = new PNG({ width: fullWidth, height: fullHeight })
+	const img1 = PNG.sync.read(browserBuffer)
+	const img2 = PNG.sync.read(exportBuffer)
+	const pxielDiff = pixelmatch(img1.data, img2.data, diff.data, fullWidth, fullHeight, {
+		threshold: 0.6,
+	})
+
+	if (opts.writeTo) {
+		const { path: writeToPath, prefix: writeToPrefix } = opts.writeTo
+
+		await fs.promises.writeFile(`${writeToPath}/${writeToPrefix}-diff.png`, PNG.sync.write(diff))
+	}
+
+	return {
+		pxielDiff,
+	}
+}

e2e/test/mocha-ext.ts

@@ -0,0 +1,118 @@
+const mochaIt = global.it
+const describe = global.describe
+
+const DEFAULT_ENV_HANDLER = () => ({
+	shouldIgnore: false,
+	skipMessage: '',
+})
+
+type EnvOpts = {
+	device?: 'mobile' | 'desktop'
+	skipBrowsers?: ('firefox' | 'safari' | 'edge' | 'samsung' | 'chrome' | 'vscode')[]
+	input?: ('mouse' | 'touch')[]
+	os?: 'windows' | 'macos' | 'linux' | 'android' | 'ios' | 'ipados'
+	ui?: 'mobile' | 'desktop'
+	ignoreWhen?: () => boolean
+}
+
+// Gets set by env(...) and read in it(...)
+let envMethod = DEFAULT_ENV_HANDLER
+
+/** This is a mocha extension to allow us to run tests only for specific environments */
+const env = (opts: EnvOpts, handler: () => void) => {
+	envMethod = () => {
+		// @ts-ignore
+		const { tldrawOptions } = global
+		let skipMessage = '(ignored)'
+		let shouldIgnore = false
+
+		if (opts.device && tldrawOptions.device !== opts.device) {
+			shouldIgnore = true
+			skipMessage = `(ignored only: ${opts.device})`
+		}
+		if (opts.skipBrowsers && opts.skipBrowsers.includes(tldrawOptions.browser)) {
+			shouldIgnore = true
+			skipMessage = `(ignored browser)`
+		}
+		if (opts.input && !tldrawOptions.input?.find((item) => opts.input.includes(item))) {
+			shouldIgnore = true
+			skipMessage = `(ignored only: ${opts.input.join(', ')})`
+		}
+		if (opts.ui && tldrawOptions.ui !== opts.ui) {
+			shouldIgnore = true
+			skipMessage = `(ignored only: ${opts.ui})`
+		}
+		if (opts.os && tldrawOptions.os !== opts.os) {
+			shouldIgnore = true
+			skipMessage = `(ignored only: ${opts.os})`
+		}
+		if (opts.ignoreWhen && opts.ignoreWhen()) {
+			shouldIgnore = true
+		}
+
+		return { skipMessage, shouldIgnore }
+	}
+
+	handler()
+	envMethod = DEFAULT_ENV_HANDLER
+}
+
+/** Same usage as the mocha it(...) method */
+const it = (msg: string, handler: () => void) => {
+	const { shouldIgnore, skipMessage } = envMethod()
+	if (shouldIgnore) {
+		mochaIt(msg + ' ' + skipMessage, () => {})
+	} else {
+		mochaIt(msg, handler)
+	}
+}
+
+/** Same usage as the mocha it.only(...) method */
+// eslint-disable-next-line no-only-tests/no-only-tests
+it.only = (msg: string, handler: () => void) => {
+	const { shouldIgnore, skipMessage } = envMethod()
+	if (shouldIgnore) {
+		mochaIt.only(msg + ' ' + skipMessage, () => {})
+	} else {
+		mochaIt.only(msg, handler)
+	}
+}
+
+/** Same usage as the mocha it.skip(...) method */
+it.skip = (msg: string, handler: () => void) => {
+	const { shouldIgnore, skipMessage } = envMethod()
+	if (shouldIgnore) {
+		mochaIt.skip(msg + ' ' + skipMessage, () => {})
+	} else {
+		mochaIt.skip(msg, handler)
+	}
+}
+
+/** Same usage as the mocha it.skip(...) method */
+it.todo = (msg: string, _handler?: () => void) => {
+	mochaIt.skip('[TODO] ' + msg, () => {})
+}
+
+it.ok = it
+
+it.fails = (msg: string, handler: () => void | Promise<void>) => {
+	const { shouldIgnore, skipMessage } = envMethod()
+	if (shouldIgnore) {
+		mochaIt('[FAILS] ' + msg + ' ' + skipMessage, () => {})
+	} else {
+		mochaIt('[FAILS] ' + msg, async () => {
+			let failed = false
+			try {
+				await handler()
+			} catch (err: any) {
+				failed = true
+			}
+
+			if (!failed) {
+				throw new Error('This expected to fail, did you fix it?')
+			}
+		})
+	}
+}
+
+export { env, describe, it }

e2e/test/specs/arrange.ts

@@ -0,0 +1,391 @@
+import { runtime, ui } from '../helpers'
+import { describe, it } from '../mocha-ext'
+
+const createShapes = async (pos0 = [20, 20], pos1 = [70, 70], pos2 = [120, 120]) => {
+	const size = 30
+
+	await ui.tools.click('rectangle')
+	await ui.canvas.brush(pos0[0], pos0[1], pos0[0] + size, pos0[1] + size)
+
+	await ui.tools.click('rectangle')
+	await ui.canvas.brush(pos1[0], pos1[1], pos1[0] + size, pos1[1] + size)
+
+	await ui.tools.click('rectangle')
+	await ui.canvas.brush(pos2[0], pos2[1], pos2[0] + size, pos2[1] + size)
+
+	return await runtime.getAllShapes()
+}
+
+const MODES = [/*'context', */ 'action']
+
+describe('arrange', () => {
+	describe('align-left', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(11, 11)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-left'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-left'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[0].x).toBe(shapes[0].x)
+				expect(origShapes[0].x).toBe(shapes[1].x)
+				expect(origShapes[0].x).toBe(shapes[2].x)
+			})
+		}
+	})
+
+	describe('align-center-horizontal', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-center-horizontal'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-center-horizontal'])
+				}
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[1].x).toBe(shapes[0].x)
+				expect(origShapes[1].x).toBe(shapes[1].x)
+				expect(origShapes[1].x).toBe(shapes[2].x)
+			})
+		}
+	})
+
+	describe('align-right', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-right'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-right'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[2].x).toBe(shapes[0].x)
+				expect(origShapes[2].x).toBe(shapes[1].x)
+				expect(origShapes[2].x).toBe(shapes[2].x)
+			})
+		}
+	})
+
+	describe('align-top', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-top'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-top'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[0].y).toBe(shapes[0].y)
+				expect(origShapes[0].y).toBe(shapes[1].y)
+				expect(origShapes[0].y).toBe(shapes[2].y)
+			})
+		}
+	})
+
+	describe('align-center-vertical', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-center-vertical'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-center-vertical'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[1].y).toBe(shapes[0].y)
+				expect(origShapes[1].y).toBe(shapes[1].y)
+				expect(origShapes[1].y).toBe(shapes[2].y)
+			})
+		}
+	})
+
+	describe('align-bottom', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				await ui.app.pointWithinActiveArea(11, 11)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(11, 11)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'align-bottom'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['align-bottom'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[2].y).toBe(shapes[0].y)
+				expect(origShapes[2].y).toBe(shapes[1].y)
+				expect(origShapes[2].y).toBe(shapes[2].y)
+			})
+		}
+	})
+
+	describe('distribute-horizontal', () => {
+		for (const mode of MODES) {
+			const createHorzShapes = async () => {
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(20, 20, 50, 50)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(90, 70, 120, 100)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(120, 120, 150, 150)
+
+				return await runtime.getAllShapes()
+			}
+
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createHorzShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'distribute-horizontal'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['distribute-horizontal'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[0].x).toBe(shapes[0].x)
+				expect(origShapes[0].x + 50).toBe(shapes[1].x)
+				expect(origShapes[0].x + 100).toBe(shapes[2].x)
+			})
+		}
+	})
+
+	describe('distribute-vertical', () => {
+		for (const mode of MODES) {
+			const createVertShapes = async () => {
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(20, 20, 50, 50)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(70, 90, 100, 120)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(120, 120, 150, 150)
+
+				return await runtime.getAllShapes()
+			}
+
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const origShapes = await createVertShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'distribute-vertical'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['distribute-vertical'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(origShapes[0].x).toBe(shapes[0].x)
+				expect(origShapes[0].x + 50).toBe(shapes[1].x)
+				expect(origShapes[0].x + 100).toBe(shapes[2].x)
+			})
+		}
+	})
+
+	describe('stretch-horizontal', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'stretch-horizontal'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['stretch-horizontal'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(shapes[0].props).toHaveProperty('w', 130)
+				expect(shapes[1].props).toHaveProperty('w', 130)
+				expect(shapes[2].props).toHaveProperty('w', 130)
+			})
+		}
+	})
+
+	describe('stretch-vertical', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				await createShapes()
+
+				await ui.canvas.brush(10, 10, 170, 170)
+				if (mode === 'context') {
+					const point = await ui.app.pointWithinActiveArea(21, 21)
+					await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'stretch-vertical'])
+				} else if (mode === 'action') {
+					await ui.main.actionMenu(['stretch-vertical'])
+				}
+
+				const shapes = await runtime.getAllShapes()
+				expect(shapes[0].props).toHaveProperty('h', 130)
+				expect(shapes[1].props).toHaveProperty('h', 130)
+				expect(shapes[2].props).toHaveProperty('h', 130)
+			})
+		}
+	})
+
+	// describe('flip-horizontal', () => {
+	// 	for (const mode of ['context']) {
+	// 		it(`${mode} menu`, async () => {
+	// 			await ui.app.setup()
+	// 			const origShapes = await createShapes()
+
+	// 			// TODO: Move back to front
+	// 			await ui.canvas.brush(0, 0, 150, 150)
+	// 			const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 			if (mode === 'context') {
+	// 				const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 				await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'flip-horizontal'])
+	// 			} else if (mode === 'action') {
+	// 				await ui.main.actionMenu(['flip-horizontal'])
+	// 			}
+
+	// 			const shapes = await runtime.getAllShapes()
+	// 			expect(shapes[0].x).toBe(origShapes[2].x)
+	// 			expect(shapes[1].x).toBe(origShapes[1].x)
+	// 			expect(shapes[2].x).toBe(origShapes[0].x)
+	// 		})
+	// 	}
+	// })
+
+	// describe('flip-vertical', () => {
+	// 	for (const mode of ['context']) {
+	// 		it(`${mode} menu`, async () => {
+	// 			await ui.app.setup()
+	// 			const origShapes = await createShapes()
+
+	// 			// TODO: Move back to front
+	// 			await ui.canvas.brush(0, 0, 150, 150)
+	// 			const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 			if (mode === 'context') {
+	// 				const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 				await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'flip-vertical'])
+	// 			} else if (mode === 'action') {
+	// 				await ui.main.actionMenu(['flip-vertical'])
+	// 			}
+
+	// 			const shapes = await runtime.getAllShapes()
+	// 			expect(shapes[0].y).toBe(origShapes[2].y)
+	// 			expect(shapes[1].y).toBe(origShapes[1].y)
+	// 			expect(shapes[2].y).toBe(origShapes[0].y)
+	// 		})
+	// 	}
+	// })
+
+	// describe('pack', () => {
+	// 	for (const mode of ['context']) {
+	// 		it(`${mode} menu`, async () => {
+	// 			await ui.app.setup()
+	// 			const origShapes = await createShapes()
+
+	// 			// TODO: Move back to front
+	// 			await ui.canvas.brush(0, 0, 150, 150)
+	// 			const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 			if (mode === 'context') {
+	// 				const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 				await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'pack'])
+	// 			} else if (mode === 'action') {
+	// 				await ui.main.actionMenu(['pack'])
+	// 			}
+
+	// 			const shapes = await runtime.getAllShapes()
+	// 			expect(shapes.length).toBe(3)
+	// 			expect(shapes[0].x).toBe(339)
+	// 			expect(shapes[0].y).toBe(122)
+	// 			expect(shapes[1].x).toBe(385)
+	// 			expect(shapes[1].y).toBe(122)
+	// 			expect(shapes[2].x).toBe(431)
+	// 			expect(shapes[2].y).toBe(122)
+	// 		})
+	// 	}
+	// })
+
+	// describe('stack-vertical', () => {
+	// 	for (const mode of MODES) {
+	// 		it(`${mode} menu`, async () => {
+	// 			await ui.app.setup()
+	// 			const origShapes = await createShapes([10, 10], [60, 16], [110, 24])
+
+	// 			await ui.canvas.brush(0, 0, 150, 150)
+	// 			if (mode === 'context') {
+	// 				const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 				await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'stack-vertical'])
+	// 			} else if (mode === 'action') {
+	// 				await ui.main.actionMenu(['stack-vertical'])
+	// 			}
+
+	// 			const shapes = await runtime.getAllShapes()
+	// 			console.log(shapes)
+	// 			expect(shapes[0].y).toBe(72)
+	// 			expect(shapes[1].y).toBe(102)
+	// 			expect(shapes[2].y).toBe(132)
+	// 		})
+	// 	}
+	// })
+
+	// describe('stack-horizontal', () => {
+	// 	for (const mode of MODES) {
+	// 		it(`${mode} menu`, async () => {
+	// 			await ui.app.setup()
+	// 			const origShapes = await createShapes([10, 10], [16, 60], [24, 110])
+
+	// 			await ui.canvas.brush(0, 0, 150, 150)
+	// 			if (mode === 'context') {
+	// 				const point = await ui.app.pointWithinActiveArea(11, 11)
+	// 				await ui.canvas.contextMenu(point.x, point.y, ['arrange', 'stack-horizontal'])
+	// 			} else if (mode === 'action') {
+	// 				await ui.main.actionMenu(['stack-horizontal'])
+	// 			}
+
+	// 			const shapes = await runtime.getAllShapes()
+	// 			console.log(shapes)
+	// 			expect(shapes[0].x).toBe(335)
+	// 			expect(shapes[1].x).toBe(365)
+	// 			expect(shapes[2].x).toBe(395)
+	// 		})
+	// 	}
+	// })
+})

e2e/test/specs/camera.ts

@@ -0,0 +1,295 @@
+import { MOVE_DEFAULTS, runtime, ui } from '../helpers'
+import { describe, env, it } from '../mocha-ext'
+
+describe('camera', () => {
+	env(
+		{
+			skipBrowsers: ['firefox'],
+		},
+		() => {
+			describe('panning', () => {
+				it('hand tool', async () => {
+					await ui.app.setup()
+
+					const c1 = await runtime.getCamera()
+					await ui.tools.click('hand')
+					await browser.actions([
+						browser
+							.action('pointer')
+							.move({ x: 200, y: 200, ...MOVE_DEFAULTS })
+							.down('left')
+							.move({ x: 300, y: 300, ...MOVE_DEFAULTS })
+							.up(),
+					])
+
+					const c2 = await runtime.getCamera()
+					expect(c1).not.toMatchObject(c2 as any)
+					expect(c1.z).toBe(c2.z)
+				})
+
+				env(
+					{
+						input: ['mouse'],
+					},
+					() => {
+						// Failed in <https://automate.browserstack.com/dashboard/v2/public-build/Nyt1KzhUQ1FXNVRrcWFsaE4vSUREQzN1ZFNMaW5YUGpaL0UyU2RvUFd1WFBsK3lBSXRRZHUwSHlyaWk1a0dqelJlbUsvL0xUM2xadnhFY28xODE4aUE9PS0tUDNQbHorbWFPeTVQNGJzWHVXNUp4Zz09--581e9085c67c6e1508b22e4757f4936e70bb68d1>
+						it('wheel', async () => {
+							await ui.app.setup()
+
+							const c1 = await runtime.getCamera()
+							await browser
+								.action('wheel')
+								.scroll({ x: 200, y: 200, deltaX: 100, deltaY: 100, duration: 100 })
+								.perform()
+
+							const c2 = await runtime.getCamera()
+							expect(c1).not.toMatchObject(c2 as any)
+							expect(c1.z).toBe(c2.z)
+						})
+
+						// REMOTE:OK
+						it('spacebar', async () => {
+							await ui.app.setup()
+
+							const c1 = await runtime.getCamera()
+							await browser.actions([
+								browser.action('key').down(' '),
+								browser
+									.action('pointer')
+									.move({ x: 200, y: 200, ...MOVE_DEFAULTS })
+									.down('left')
+									.move({ x: 300, y: 300, ...MOVE_DEFAULTS })
+									.up(),
+							])
+
+							const c2 = await runtime.getCamera()
+							expect(c1).not.toMatchObject(c2 as any)
+							expect(c1.z).toBe(c2.z)
+						})
+					}
+				)
+			})
+
+			describe('zooming', () => {
+				env(
+					{
+						ui: 'desktop',
+						input: ['mouse'],
+						skipBrowsers: ['firefox'],
+					},
+					() => {
+						it('wheel', async () => {
+							await ui.app.setup()
+							const c1 = await runtime.getCamera()
+							await browser.actions([
+								// For some reason the import isn't working...
+								// From <https://github.com/webdriverio/webdriverio/blob/3620e90e47b6d3e62832f5de24f43cee6b31e972/packages/webdriverio/src/constants.ts#L360>
+								browser.action('key').down('WDIO_CONTROL'),
+								browser
+									.action('wheel')
+									.scroll({ x: 200, y: 200, deltaX: 100, deltaY: 100, duration: 100 }),
+							])
+							const c2 = await runtime.getCamera()
+							expect(c1).not.toMatchObject(c2 as any)
+							expect(c1.z).not.toBe(c2.z)
+						})
+					}
+				)
+
+				env(
+					{
+						input: ['touch'],
+					},
+					() => {
+						it('pinch-in', async () => {
+							await ui.app.setup()
+
+							const c1 = await runtime.getCamera()
+							await browser.actions([
+								browser
+									.action('pointer', { parameters: { pointerType: 'touch' } })
+									.move({ x: 200, y: 200, ...MOVE_DEFAULTS })
+									.down('left')
+									.move({ x: 300, y: 300, ...MOVE_DEFAULTS })
+									.up(),
+								browser
+									.action('pointer', { parameters: { pointerType: 'touch' } })
+									.move({ x: 200, y: 200, ...MOVE_DEFAULTS })
+									.down('left')
+									.move({ x: 100, y: 100, ...MOVE_DEFAULTS })
+									.up(),
+							])
+
+							const c2 = await runtime.getCamera()
+							expect(c1).not.toMatchObject(c2 as any)
+							expect(c1.z).toBeLessThan(c2.z)
+						})
+
+						it('pinch-out', async () => {
+							await ui.app.setup()
+
+							const c1 = await runtime.getCamera()
+							await browser.actions([
+								browser
+									.action('pointer', { parameters: { pointerType: 'touch' } })
+									.move({ x: 300, y: 300, ...MOVE_DEFAULTS })
+									.down('left')
+									.move({ x: 220, y: 220, ...MOVE_DEFAULTS })
+									.up(),
+								browser
+									.action('pointer', { parameters: { pointerType: 'touch' } })
+									.move({ x: 100, y: 100, ...MOVE_DEFAULTS })
+									.down('left')
+									.move({ x: 180, y: 180, ...MOVE_DEFAULTS })
+									.up(),
+							])
+
+							const c2 = await runtime.getCamera()
+							expect(c1).not.toMatchObject(c2 as any)
+							expect(c1.z).toBeGreaterThan(c2.z)
+						})
+					}
+				)
+
+				env(
+					{
+						ui: 'desktop',
+					},
+					() => {
+						describe('minimap', () => {
+							describe('buttons', () => {
+								// REMOTE:OK
+								it('zoom in', async () => {
+									await ui.app.setup()
+									const c1 = await runtime.getCamera()
+									await ui.minimap.zoomIn()
+
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '200%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c1).not.toMatchObject(c2 as any)
+									expect(c2.z).toBe(2)
+								})
+
+								it('zoom out', async () => {
+									await ui.app.setup()
+									const c1 = await runtime.getCamera()
+									await ui.minimap.zoomOut()
+
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '50%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c1).not.toMatchObject(c2 as any)
+									expect(c2.z).toBeCloseTo(0.5)
+								})
+							})
+
+							describe('menu', () => {
+								// REMOTE:OK
+								it('zoom in', async () => {
+									await ui.app.setup()
+									const c1 = await runtime.getCamera()
+									await ui.minimap.menu(['zoom-in'])
+
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '200%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c1).not.toMatchObject(c2 as any)
+									expect(c2.z).toBeCloseTo(2)
+								})
+
+								// REMOTE:OK
+								it('zoom out', async () => {
+									await ui.app.setup()
+									const c1 = await runtime.getCamera()
+									await ui.minimap.menu(['zoom-out'])
+
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '50%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c1).not.toMatchObject(c2 as any)
+									expect(c2.z).toBeCloseTo(0.5)
+								})
+
+								// REMOTE:OK
+								it('zoom 100%', async () => {
+									await ui.app.setup()
+									await browser.execute(() => {
+										window.app.setCamera(0, 0, 0.5)
+									})
+									const c1 = await runtime.getCamera()
+									expect(c1.z).toBeCloseTo(0.5)
+
+									await ui.minimap.menu(['zoom-to-100'])
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '100%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c2.z).toBeCloseTo(1)
+								})
+
+								it('zoom to fit', async () => {
+									await ui.app.setup()
+
+									await ui.tools.click('rectangle')
+									await ui.canvas.brush(10, 10, 60, 60)
+
+									await browser.execute(() => {
+										window.app.setCamera(0, 0, 0.5)
+									})
+									const c1 = await runtime.getCamera()
+									expect(c1.z).toBeCloseTo(0.5)
+
+									await ui.minimap.menu(['zoom-to-fit'])
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '800%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c2.z).toBeCloseTo(8)
+								})
+
+								it('zoom to selection', async () => {
+									await ui.app.setup()
+
+									await ui.tools.click('rectangle')
+									await ui.canvas.brush(10, 10, 60, 60)
+
+									await browser.execute(() => {
+										window.app.setCamera(0, 0, 0.5)
+									})
+									const c1 = await runtime.getCamera()
+									expect(c1.z).toBeCloseTo(0.5)
+
+									await ui.minimap.menu(['zoom-to-selection'])
+									await browser.waitUntil(async () => {
+										const text = await (await ui.minimap.menuButton()).getText()
+										return text === '100%'
+									})
+
+									const c2 = await runtime.getCamera()
+									expect(c2.z).toBeCloseTo(1)
+								})
+							})
+						})
+					}
+				)
+			})
+		}
+	)
+})

e2e/test/specs/constants.ts

@@ -0,0 +1,17 @@
+export const SHAPES = [
+	{ type: 'geo', tool: 'rectangle' },
+	// { type: 'geo', tool: 'ellipse' },
+	// { type: 'geo', tool: 'triangle' },
+	// { type: 'geo', tool: 'diamond' },
+	// { type: 'geo', tool: 'pentagon' },
+	// { type: 'geo', tool: 'hexagon' },
+	// { type: 'geo', tool: 'octagon' },
+	// { type: 'geo', tool: 'star' },
+	// { type: 'geo', tool: 'rhombus' },
+	// { type: 'geo', tool: 'oval' },
+	// { type: 'geo', tool: 'trapezoid' },
+	// { type: 'geo', tool: 'arrow-right' },
+	// { type: 'geo', tool: 'arrow-left' },
+	// { type: 'geo', tool: 'arrow-up' },
+	// { type: 'geo', tool: 'arrow-down' },
+]

e2e/test/specs/export.ts

@@ -0,0 +1,172 @@
+import { runtime, ui, util } from '../helpers'
+import { describe, env, it } from '../mocha-ext'
+
+describe('export', () => {
+	before(async () => {
+		await ui.app.open()
+	})
+
+	const createShape = async () => {
+		await ui.tools.click('text')
+		await ui.canvas.brush(70, 200, 250, 200)
+		await browser.keys('testing')
+	}
+
+	describe.skip('export-as', () => {
+		for (const mode of ['main' /*, 'context'*/]) {
+			describe(`${mode} menu`, () => {
+				env(
+					// It turns out we can't grab the file on mobile devices... urgh!
+					{
+						device: 'desktop',
+						skipBrowsers: ['firefox'],
+					},
+					() => {
+						const fileNameFromShape = async (shape) => {
+							return await browser.execute((shapeId) => {
+								return window.app.getShapeById(shapeId)?.id.replace(/:/, '_')
+							}, shape.id)
+						}
+
+						it('svg', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await util.clearClipboard()
+							await ui.app.setup()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['export-as', 'export-as-svg'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'export-as', 'export-as-svg'])
+							}
+
+							// FIXME: This shouldn't be a timer... but what to do???
+							await browser.execute(() => new Promise((resolve) => setTimeout(resolve, 3000)))
+							const allShapes = await runtime.getAllShapes()
+							const fileName = await fileNameFromShape(allShapes[0])
+							const file = await util.getDownloadFile(fileName + '.svg')
+
+							// TODO: Also check the buffer is correct here...
+							expect(file).toExist()
+						})
+
+						it('png', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await util.clearClipboard()
+							await ui.app.setup()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['export-as', 'export-as-png'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'export-as', 'export-as-png'])
+							}
+
+							// FIXME: This shouldn't be a timer... but what to do???
+							await browser.execute(() => new Promise((resolve) => setTimeout(resolve, 3000)))
+							const allShapes = await runtime.getAllShapes()
+							const fileName = await fileNameFromShape(allShapes[0])
+							const file = await util.getDownloadFile(fileName + '.png')
+
+							// TODO: Also check the buffer is correct here...
+							expect(file).toExist()
+						})
+
+						it('json', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await util.clearClipboard()
+							await ui.app.setup()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['export-as', 'export-as-json'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'export-as', 'export-as-json'])
+							}
+
+							// FIXME: This shouldn't be a timer... but what to do???
+							await browser.execute(() => new Promise((resolve) => setTimeout(resolve, 3000)))
+							const allShapes = await runtime.getAllShapes()
+							const fileName = await fileNameFromShape(allShapes[0])
+							const file = await util.getDownloadFile(fileName + '.json')
+
+							// TODO: Also check the buffer is correct here...
+							expect(file).toExist()
+						})
+					}
+				)
+			})
+		}
+	})
+
+	describe('copy-as', () => {
+		for (const mode of ['main' /*, 'context'*/]) {
+			describe(`${mode} menu`, () => {
+				env(
+					{
+						// NOTE: Will be abled once mobile browsers support the '/permissions' API endpoint.
+						device: 'desktop',
+						// FIXME
+						skipBrowsers: ['firefox', 'vscode'],
+					},
+					() => {
+						it('svg', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await ui.app.setup()
+							await util.clearClipboard()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['copy-as', 'copy-as-svg'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'copy-as', 'copy-as-svg'])
+							}
+
+							await util.waitForClipboardContents()
+							const clipboardContents = await util.clipboardContents()
+							expect(clipboardContents.length).toEqual(1)
+							expect(clipboardContents[0]['text/plain']).toMatch(/<svg/)
+						})
+
+						it('png', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await ui.app.setup()
+							await util.clearClipboard()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['copy-as', 'copy-as-png'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'copy-as', 'copy-as-png'])
+							}
+
+							await util.waitForClipboardContents()
+							const clipboardContents = await util.clipboardContents()
+							expect(clipboardContents.length).toEqual(1)
+							expect(clipboardContents[0]['image/png']).toBeDefined()
+						})
+
+						it('json', async () => {
+							await util.grantPermissions(['clipboard-read'])
+							await ui.app.setup()
+							await util.clearClipboard()
+							await createShape()
+
+							if (mode === 'context') {
+								await ui.canvas.contextMenu(100, 120, ['copy-as', 'copy-as-json'])
+							} else if (mode === 'main') {
+								await ui.main.menu(['edit', 'copy-as', 'copy-as-json'])
+							}
+
+							await util.waitForClipboardContents()
+							const clipboardContents = await util.clipboardContents()
+							expect(clipboardContents.length).toEqual(1)
+							expect(clipboardContents[0]['text/plain']).toBeDefined()
+							expect(clipboardContents[0]['text/plain']).toMatch(/^{/)
+						})
+					}
+				)
+			})
+		}
+	})
+})

e2e/test/specs/grouping.ts

@@ -0,0 +1,6 @@
+import { describe } from '../mocha-ext'
+
+describe('grouping', () => {
+	describe('group', () => {})
+	describe('ungroup', () => {})
+})

e2e/test/specs/index.ts

@@ -0,0 +1,27 @@
+import { ui } from '../helpers/index'
+import './arrange'
+import './camera'
+import './export'
+import './grouping'
+import './pages'
+import './reorder'
+import './screenshots'
+import './shortcuts'
+import './smoke'
+import './styling'
+import './text'
+
+before(async () => {
+	await browser.waitUntil(
+		async () => {
+			try {
+				await ui.app.open()
+			} catch (err) {
+				console.error(err)
+				return false
+			}
+			return true
+		},
+		{ timeout: 30 * 1000 }
+	)
+})

e2e/test/specs/pages.ts

@@ -0,0 +1,15 @@
+import { describe } from '../mocha-ext'
+
+describe('pages', () => {
+	describe('switch-page', () => {})
+	describe('create', () => {})
+	describe('edit-pages', () => {
+		describe('go-to-page', () => {})
+		describe('duplicate', () => {})
+		describe('move', () => {})
+		describe('delete', () => {})
+		describe('close', () => {})
+		describe('rename-page', () => {})
+		describe('create-page', () => {})
+	})
+})

e2e/test/specs/reorder.ts

@@ -0,0 +1,122 @@
+import { runtime, ui } from '../helpers'
+import { app } from '../helpers/ui'
+import { describe, it } from '../mocha-ext'
+
+const sortByIndex = (a, b) => {
+	if (a.index < b.index) {
+		return -1
+	} else if (a.index > b.index) {
+		return 1
+	}
+	return 0
+}
+
+describe('reorder', () => {
+	const createShapes = async () => {
+		await ui.tools.click('rectangle')
+		await ui.canvas.brush(10, 10, 60, 60)
+
+		await ui.tools.click('rectangle')
+		await ui.canvas.brush(30, 30, 80, 80)
+
+		await ui.tools.click('rectangle')
+		await ui.canvas.brush(50, 50, 100, 100)
+
+		return (await runtime.getAllShapes()).sort(sortByIndex).map((s) => s.id)
+	}
+
+	const MODES = [/*'context', */ 'action']
+
+	describe('bring-to-front', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const ids = await createShapes()
+
+				// TODO: Move back to front
+				await ui.canvas.click(11, 11)
+				const point = await app.pointWithinActiveArea(11, 11)
+
+				if (mode === 'action') {
+					await ui.main.actionMenu(['bring-to-front'])
+				} else if (mode === 'context') {
+					await ui.canvas.contextMenu(point.x, point.y, ['reorder', 'bring-to-front'])
+				}
+
+				const shapes = (await runtime.getAllShapes()).sort(sortByIndex)
+				expect(shapes[0].id).toBe(ids[1])
+				expect(shapes[1].id).toBe(ids[2])
+				expect(shapes[2].id).toBe(ids[0])
+			})
+		}
+	})
+
+	describe('bring-forward', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const ids = await createShapes()
+
+				// TODO: Move back to front
+				await ui.canvas.click(11, 11)
+				const point = await app.pointWithinActiveArea(11, 11)
+				if (mode === 'action') {
+					await ui.main.actionMenu(['bring-forward'])
+				} else if (mode === 'context') {
+					await ui.canvas.contextMenu(point.x, point.y, ['reorder', 'bring-forward'])
+				}
+
+				const shapes = (await runtime.getAllShapes()).sort(sortByIndex)
+				expect(shapes[0].id).toBe(ids[1])
+				expect(shapes[1].id).toBe(ids[0])
+				expect(shapes[2].id).toBe(ids[2])
+			})
+		}
+	})
+
+	describe('send-backward', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const ids = await createShapes()
+
+				// TODO: Move back to front
+				await ui.canvas.click(51, 51)
+				const point = await app.pointWithinActiveArea(51, 51)
+				if (mode === 'action') {
+					await ui.main.actionMenu(['send-backward'])
+				} else if (mode === 'context') {
+					await ui.canvas.contextMenu(point.x, point.y, ['reorder', 'send-backward'])
+				}
+
+				const shapes = (await runtime.getAllShapes()).sort(sortByIndex)
+				expect(shapes[0].id).toBe(ids[0])
+				expect(shapes[1].id).toBe(ids[2])
+				expect(shapes[2].id).toBe(ids[1])
+			})
+		}
+	})
+
+	describe('send-to-back', () => {
+		for (const mode of MODES) {
+			it(`${mode} menu`, async () => {
+				await ui.app.setup()
+				const ids = await createShapes()
+
+				// TODO: Move back to front
+				await ui.canvas.click(51, 51)
+				const point = await app.pointWithinActiveArea(51, 51)
+				if (mode === 'action') {
+					await ui.main.actionMenu(['send-to-back'])
+				} else if (mode === 'context') {
+					await ui.canvas.contextMenu(point.x, point.y, ['reorder', 'send-to-back'])
+				}
+
+				const shapes = (await runtime.getAllShapes()).sort(sortByIndex)
+				expect(shapes[0].id).toBe(ids[2])
+				expect(shapes[1].id).toBe(ids[0])
+				expect(shapes[2].id).toBe(ids[1])
+			})
+		}
+	})
+})

e2e/test/specs/screenshots.ts

@@ -0,0 +1 @@
+export {}

e2e/test/specs/shortcuts.ts

@@ -0,0 +1,154 @@
+import { runtime, ui } from '../helpers'
+import { describe, env, it } from '../mocha-ext'
+
+describe('basic keyboard shortcuts', () => {
+	env({ device: 'desktop' }, () => {
+		// If this one works, the others will work as well.
+		it('draw — D', async () => {
+			await ui.app.setup()
+			await browser.keys(['d'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('draw.idle')
+			})
+		})
+
+		// Tools
+		it.todo('select — V', async () => {
+			await ui.app.setup()
+			await browser.keys(['v'])
+		})
+
+		it('draw — D', async () => {
+			await ui.app.setup()
+			await browser.keys(['d'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('draw.idle')
+			})
+		})
+
+		it('eraser — E', async () => {
+			await ui.app.setup()
+			await browser.keys(['e'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('eraser.idle')
+			})
+		})
+
+		it('hand — H', async () => {
+			await ui.app.setup()
+			await browser.keys(['h'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('hand.idle')
+			})
+		})
+
+		it('rectangle — R', async () => {
+			await ui.app.setup()
+			await browser.keys(['r'])
+			await browser.waitUntil(async () => {
+				return (
+					(await runtime.isIn('geo.idle')) &&
+					(await runtime.propsForNextShape()).geo === 'rectangle'
+				)
+			})
+		})
+
+		it('ellipse — O', async () => {
+			await ui.app.setup()
+			await browser.keys(['o'])
+			await browser.waitUntil(async () => {
+				return (
+					(await runtime.isIn('geo.idle')) && (await runtime.propsForNextShape()).geo === 'ellipse'
+				)
+			})
+		})
+
+		it.fails('diamond — P', async () => {
+			await ui.app.setup()
+			await browser.keys(['p'])
+			await browser.waitUntil(async () => {
+				return (
+					(await runtime.isIn('geo.idle')) && (await runtime.propsForNextShape()).geo === 'diamond'
+				)
+			})
+		})
+
+		it('arrow — A', async () => {
+			await ui.app.setup()
+			await browser.keys(['a'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('arrow.idle')
+			})
+		})
+
+		it('line — L', async () => {
+			await ui.app.setup()
+			await browser.keys(['l'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('line.idle')
+			})
+		})
+
+		it('text — T', async () => {
+			await ui.app.setup()
+			await browser.keys(['t'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('text.idle')
+			})
+		})
+
+		it('frame — F', async () => {
+			await ui.app.setup()
+			await browser.keys(['f'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('frame.idle')
+			})
+		})
+
+		it('sticky — N', async () => {
+			await ui.app.setup()
+			await browser.keys(['n'])
+			await browser.waitUntil(async () => {
+				return await runtime.isIn('note.idle')
+			})
+		})
+
+		// View
+		it.todo('zoom-in — ⌘+', () => {})
+		it.todo('zoom-in — ⌘-', () => {})
+		it.todo('zoom-in — ⌘0', () => {})
+		it.todo('zoom-in — ⌘1', () => {})
+		it.todo('zoom-in — ⌘2', () => {})
+		it.todo('zoom-in — ⌘/', () => {})
+		it.todo('zoom-in — ⌘.', () => {})
+		it.todo("zoom-in — ⌘'", () => {})
+
+		// Transform
+		it.todo('flip-h — ⇧H', () => {})
+		it.todo('flip-v — ⇧V', () => {})
+		it.todo('lock/unlock — ⌘L', () => {})
+		it.todo('move-to-front — ]', () => {})
+		it.todo('move-forward — ⌥]', () => {})
+		it.todo('move-backward — ⌥[', () => {})
+		it.todo('move-to-back — [', () => {})
+		it.todo('group — ⌘G', () => {})
+		it.todo('ungroup — ⌘⇧G', () => {})
+
+		// File
+		it.todo('new-project — ⌘N', () => {})
+		it.todo('open — ⌘O', () => {})
+		it.todo('save — ⌘S', () => {})
+		it.todo('save-as — ⌘⇧S', () => {})
+		it.todo('upload-media — ⌘I', () => {})
+
+		// Edit
+		it.todo('undo — ⌘Z', () => {})
+		it.todo('redo — ⌘⇧Z', () => {})
+		it.todo('cut — ⌘X', () => {})
+		it.todo('copy — ⌘C', () => {})
+		it.todo('paste — ⌘V', () => {})
+		it.todo('select-all — ⌘A', () => {})
+		it.todo('delete — ⌫', () => {})
+		it.todo('duplicate — ⌘D', () => {})
+	})
+})

e2e/test/specs/smoke.ts

@@ -0,0 +1,326 @@
+import { TLGeoShape } from '@tldraw/editor'
+import { runtime, ui, util } from '../helpers'
+import { describe, env, it } from '../mocha-ext'
+import { SHAPES } from './constants'
+
+describe('smoke', () => {
+	env(
+		{
+			// FIXME
+			skipBrowsers: ['firefox'],
+		},
+		() => {
+			it('startup in correct state', async () => {
+				await ui.app.setup()
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(110, 210, 160, 260)
+
+				await browser.waitUntil(async () => {
+					const isInGeoIdle = await browser.execute(() => window.app.isIn('select.idle'))
+					return isInGeoIdle === true
+				})
+				expect(await browser.execute(() => window.app.isIn('select.idle'))).toBe(true)
+				expect(await browser.execute(() => window.app.shapesArray.length)).toBe(1)
+			})
+
+			it('click/tap create/delete some shapes', async () => {
+				await ui.app.setup()
+
+				for (const shape of SHAPES) {
+					await ui.tools.click(shape.tool)
+					await ui.canvas.click(10, 10)
+					await ui.tools.click(shape.tool)
+					await ui.canvas.click(110, 210)
+					await ui.tools.click(shape.tool)
+					await ui.canvas.click(210, 310)
+
+					const allShapes = await runtime.getAllShapes()
+					expect(allShapes.length).toBe(3)
+					expect(allShapes.every((s) => s.type === shape.type))
+
+					await ui.main.menu(['edit', 'select-all'])
+					await ui.main.menu(['edit', 'delete'])
+				}
+			})
+
+			it('brush create/delete some shapes', async () => {
+				await ui.app.setup()
+
+				for (const shape of SHAPES) {
+					await ui.tools.click(shape.tool)
+					await ui.canvas.brush(10, 10, 60, 160)
+					await ui.tools.click(shape.tool)
+					await ui.canvas.brush(110, 210, 160, 260)
+					await ui.tools.click(shape.tool)
+					await ui.canvas.brush(210, 310, 260, 360)
+
+					const allShapes = await runtime.getAllShapes()
+					expect(allShapes.length).toBe(3)
+					expect(allShapes.every((s) => s.type === shape.type))
+
+					await ui.main.menu(['edit', 'select-all'])
+					await ui.main.menu(['edit', 'delete'])
+				}
+				// -----------------------------
+
+				// Text
+				// await ui.tools.click('text')
+				// // TODO: This fails if you don't hide the modal first
+				// await ui.canvas.brush(10, 200, 250, 200)
+				// await tldraw.app.activeInput()
+				// await browser.keys("testing");
+
+				// await ui.tools.click('text')
+				// await ui.canvas.brush(10, 200, 250, 200)
+				// await tldraw.app.activeInput()
+				// await browser.keys("testing");
+
+				// await ui.tools.click('text')
+				// await ui.canvas.brush(10, 300, 250, 300)
+				// await tldraw.app.activeInput()
+				// await browser.keys("testing");
+
+				// const allShapes = await runtime.getShapesOfType();
+				// expect(allShapes.length).toBe(3)
+				// expect(allShapes.every(s => s.type === 'text'));
+				// expect(allShapes.every(s => s.props.text === 'testing'));
+
+				// await cleanup();
+
+				// // Note
+				// await ui.tools.click('note')
+				// await ui.canvas.click(100, 100)
+				// await ui.tools.click('note')
+				// await ui.canvas.click(210, 210)
+				// await ui.tools.click('note')
+				// await ui.canvas.click(310, 310)
+
+				// for (const [index, [x, y]] of [
+				// 	[70, 70],
+				// 	[180, 180],
+				// 	[280, 280],
+				// ].entries()) {
+				// 	// TODO: This only works if there is a small delay
+				// 	await ui.canvas.doubleClick(x, y)
+				// 	await browser.keys([`test${index}`])
+				// 	await browser.action('key').down('\uE03D').down('\uE007').perform(true)
+				// 	await util.sleep(20)
+				// 	await browser.action('key').up('\uE007').up('\uE03D').perform(true)
+				// }
+
+				// const allNoteShapes = await runtime.getAllShapes()
+				// expect(allNoteShapes.length).toBe(3)
+				// expect(allNoteShapes.every((s) => s.type === 'note'))
+				// expect(allNoteShapes[0].props.text).toBe('test0')
+				// expect(allNoteShapes[1].props.text).toBe('test1')
+				// expect(allNoteShapes[2].props.text).toBe('test2')
+
+				// await ui.main.menu(['edit', 'select-all'])
+				// await ui.main.menu(['edit', 'delete'])
+
+				// Image
+				// TODO
+
+				// Frame
+				// FIXME: Fails on mobile
+				// await ui.tools.click('frame')
+				// await ui.canvas.brush(10, 10, 60, 160)
+				// await ui.tools.click('frame')
+				// await ui.canvas.brush(110, 210, 160, 260)
+				// await ui.tools.click('frame')
+				// await ui.canvas.brush(210, 310, 260, 360)
+
+				// await ui.canvas.doubleClick(10, 0)
+				// await browser.keys([
+				// 	'test1',
+				// 	'\uE007', // ENTER
+				// ])
+
+				// await ui.canvas.doubleClick(110, 200)
+				// await browser.keys([
+				// 	'test2',
+				// 	'\uE007', // ENTER
+				// ])
+
+				// await ui.canvas.doubleClick(210, 300)
+				// await browser.keys([
+				// 	'test3',
+				// 	'\uE007', // ENTER
+				// ])
+
+				// const allShapes = await runtime.getAllShapes()
+				// expect(allShapes.length).toBe(3)
+				// expect(allShapes.every((s) => s.type === 'frame'))
+				// expect(allShapes[0].props.name).toBe('test1')
+				// expect(allShapes[1].props.name).toBe('test2')
+				// expect(allShapes[2].props.name).toBe('test3')
+
+				// await ui.main.menu(['edit', 'select-all'])
+				// await ui.main.menu(['edit', 'delete'])
+			})
+
+			it.skip('[TODO] resize some shapes', async () => {
+				await ui.app.setup()
+
+				// await ui.canvas.brush(10, 10, 100, 100)
+
+				for (const size of [30, 50, 70]) {
+					await ui.tools.click('rectangle')
+					await ui.canvas.brush(10, 10, 10 + size, 10 + size)
+
+					await ui.main.menu(['edit', 'select-all'])
+
+					const handle = await ui.canvas.selectionHandle('resize.bottom-right')
+					await ui.canvas.dragBy(handle, 20, 20)
+
+					const allShapes = (await runtime.getAllShapes()) as TLGeoShape[]
+					expect(allShapes.length).toBe(1)
+					expect(allShapes[0].props.w).toBe(size + 20)
+					expect(allShapes[0].props.h).toBe(size + 20)
+
+					await util.deleteAllShapesOnPage()
+				}
+			})
+
+			// REMOTE:OK
+			it.skip('[TODO] rotate some shapes', async () => {
+				await ui.app.setup()
+
+				for (const size of [70, 90, 100]) {
+					await ui.tools.click('rectangle')
+					await ui.canvas.brush(100, 120, 100 + size, 120 + size)
+
+					await ui.main.menu(['edit', 'select-all'])
+
+					const handle = await ui.canvas.selectionHandle('rotate.mobile', 'rotate.top-right')
+					await ui.canvas.dragBy(handle, size / 2, size / 2)
+
+					const allShapes = await runtime.getAllShapes()
+					expect(allShapes.length).toBe(1)
+
+					const rotation = allShapes[0].rotation
+
+					// TODO: This isn't exact I assume because pixel issues with the DPR and webdriver
+					expect(rotation > 0).toBe(true)
+
+					await util.deleteAllShapesOnPage()
+				}
+			})
+
+			// FIXME: Ok once resolved <https://linear.app/tldraw/issue/TLD-1290/clicking-with-the-selection-tools-creates-a-history-entry>
+			it.skip('undo/redo', async () => {
+				await ui.app.setup()
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 10, 60, 60)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 110, 60, 160)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 210, 60, 260)
+
+				expect((await runtime.getAllShapes()).length).toBe(3)
+
+				await ui.main.click('undo')
+				expect((await runtime.getAllShapes()).length).toBe(2)
+
+				await ui.main.click('undo')
+				expect((await runtime.getAllShapes()).length).toBe(1)
+
+				await ui.main.click('undo')
+				expect((await runtime.getAllShapes()).length).toBe(0)
+
+				await ui.main.click('undo')
+				expect((await runtime.getAllShapes()).length).toBe(0)
+
+				await ui.main.click('redo')
+				expect((await runtime.getAllShapes()).length).toBe(1)
+
+				await ui.main.click('redo')
+				expect((await runtime.getAllShapes()).length).toBe(2)
+
+				await ui.main.click('redo')
+				expect((await runtime.getAllShapes()).length).toBe(3)
+
+				await ui.main.click('redo')
+				expect((await runtime.getAllShapes()).length).toBe(3)
+			})
+
+			it.skip('reorder', async () => {
+				await ui.app.setup()
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 10, 60, 60)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(30, 30, 80, 80)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(50, 50, 100, 100)
+
+				throw new Error('TODO: Not done yet')
+
+				// await tldraw.canvas.contextMenu([x,y], ["reorder", "move-to-front"]);
+				// // Assert order
+
+				// await tldraw.canvas.contextMenu([x,y], ["reorder", "move-to-front"]);
+				// // Assert order
+
+				// await tldraw.canvas.contextMenu([x,y], ["reorder", "move-to-front"]);
+				// // Assert order
+			})
+
+			it.skip('move page', async () => {
+				await ui.app.setup()
+
+				// await tldraw.main.pages.create()
+				// await tldraw.main.pages.create()
+
+				// const pages = await tldraw.app.getPages()
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 10, 60, 60)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 10, 60, 60)
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(10, 10, 60, 60)
+			})
+
+			// REMOTE:OK
+			it('group/ungroup', async () => {
+				await ui.app.setup()
+
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(100, 100, 150, 150)
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(200, 200, 250, 250)
+				await ui.tools.click('rectangle')
+				await ui.canvas.brush(300, 300, 350, 350)
+
+				await ui.main.menu(['edit', 'select-all'])
+				await ui.main.menu(['edit', 'group'])
+
+				const groupShapesBefore = await runtime.getShapesOfType('group')
+				const geoShapesBefore = await runtime.getShapesOfType('geo')
+				expect(groupShapesBefore.length).toBe(1)
+				expect(geoShapesBefore.length).toBe(3)
+
+				await ui.main.menu(['edit', 'select-all'])
+				await ui.main.menu(['edit', 'ungroup'])
+
+				const allShapes = await runtime.getAllShapes()
+				const groupShapesAfter = allShapes.filter(
+					(s) => s.typeName === 'shape' && s.type === 'group'
+				)
+				const geoShapesAfter = allShapes.filter((s) => s.typeName === 'shape' && s.type === 'geo')
+
+				expect(groupShapesAfter.length).toBe(0)
+				expect(geoShapesAfter.length).toBe(3)
+			})
+		}
+	)
+})

e2e/test/specs/styling.ts

@@ -0,0 +1,315 @@
+import { TLShape } from '@tldraw/editor'
+import { runtime, ui, util } from '../helpers'
+import { describe, it } from '../mocha-ext'
+import { SHAPES } from './constants'
+
+const LITE_MODE = true
+
+const assertColors = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const colors = LITE_MODE
+			? ['black']
+			: [
+					'black',
+					'grey',
+					'light-violet',
+					'violet',
+					'blue',
+					'light-blue',
+					'yellow',
+					'orange',
+					'green',
+					'light-green',
+					'light-red',
+					'red',
+			  ]
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const color of colors) {
+			await ui.props.selectColor(color)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect('color' in allShapes[0].props && allShapes[0].props.color).toBe(color)
+		}
+	}
+}
+
+const assertOpacity = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const opacities = LITE_MODE ? [0.5] : [0.1, 0.25, 0.5, 0.75, 1]
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const opacity of opacities) {
+			await ui.props.selectOpacity(opacity)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect('opacity' in allShapes[0].props && allShapes[0].props.opacity).toBe(opacity)
+		}
+	}
+}
+
+const assertFill = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const fills = LITE_MODE ? ['solid'] : ['none', 'semi', 'solid', 'pattern']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const fill of fills) {
+			await ui.props.selectFill(fill)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('fill', fill)
+		}
+	}
+}
+
+const assertFont = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const fonts = LITE_MODE ? ['sans'] : ['draw', 'sans', 'serif', 'mono']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const font of fonts) {
+			await ui.props.selectFont(font)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('font', font)
+		}
+	}
+}
+
+const assertAlign = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const alignments = LITE_MODE ? ['middle'] : ['start', 'middle', 'end']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const alignment of alignments) {
+			await ui.props.selectAlign(alignment)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('align', alignment)
+		}
+	}
+}
+
+const assertStroke = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const strokes = LITE_MODE ? ['dashed'] : ['draw', 'dashed', 'dotted', 'solid']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const stroke of strokes) {
+			await ui.props.selectStroke(stroke)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('dash', stroke)
+		}
+	}
+}
+
+const assertSize = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const sizes = LITE_MODE ? ['xl'] : ['s', 'm', 'l', 'xl']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const size of sizes) {
+			await ui.props.selectSize(size)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('size', size)
+		}
+	}
+}
+
+const assertSpline = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const types = LITE_MODE ? ['line'] : ['line', 'cubic']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const type of types) {
+			await ui.props.selectSpline(type)
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].props).toHaveProperty('spline', type)
+		}
+	}
+}
+
+const assertArrowheads = (createShape: () => Promise<TLShape>) => {
+	return async () => {
+		await ui.app.setup()
+		await createShape()
+		const types = LITE_MODE
+			? ['triangle']
+			: ['none', 'arrow', 'triangle', 'square', 'dot', 'diamond', 'inverted', 'bar']
+
+		await ui.props.ifMobileOpenStylesMenu()
+		for (const startType of types) {
+			for (const endType of types) {
+				await ui.props.selectArrowheadStart(startType)
+				await ui.props.selectArrowheadEnd(endType)
+				const allShapes = await runtime.getAllShapes()
+				expect(allShapes.length).toBe(1)
+				expect(allShapes[0].props).toHaveProperty('arrowheadStart', startType)
+				expect(allShapes[0].props).toHaveProperty('arrowheadEnd', endType)
+			}
+		}
+	}
+}
+
+describe.skip('styling', () => {
+	describe('draw', () => {
+		const createShape = async () => {
+			await ui.tools.click('draw')
+			await ui.canvas.draw([
+				{ x: 50, y: 50 },
+				{ x: 300, y: 50 },
+				{ x: 300, y: 300 },
+				{ x: 50, y: 300 },
+				{ x: 50, y: 50 },
+			])
+			await ui.tools.click('select')
+
+			return (await runtime.getAllShapes())[0]
+		}
+		it('color', assertColors(createShape))
+		it.todo('opacity', assertOpacity(createShape))
+		it('fill', assertFill(createShape))
+		it('stroke', assertStroke(createShape))
+		it('size', assertSize(createShape))
+	})
+
+	describe('arrow', () => {
+		const createShape = async () => {
+			await ui.tools.click('arrow')
+			await ui.canvas.brush(50, 50, 200, 200)
+
+			await ui.canvas.doubleClick((200 - 50) / 2, (200 - 50) / 2)
+			await browser.keys(['test'])
+			await browser.action('key').down('\uE03D').down('\uE007').perform(true)
+			await util.sleep(20)
+			await browser.action('key').up('\uE007').up('\uE03D').perform()
+
+			return (await runtime.getAllShapes())[0]
+		}
+		it('color', assertColors(createShape))
+		it.todo('opacity', assertOpacity(createShape))
+		it('fill', assertFill(createShape))
+		it('stroke', assertStroke(createShape))
+		it('size', assertSize(createShape))
+		it('arrowheads', assertArrowheads(createShape))
+		it('font', assertFont(createShape))
+	})
+
+	describe('line', () => {
+		const createShape = async () => {
+			await ui.tools.click('line')
+			await ui.canvas.brush(50, 50, 200, 200)
+
+			return (await runtime.getAllShapes())[0]
+		}
+		it('color', assertColors(createShape))
+		it.todo('opacity', assertOpacity(createShape))
+		it('stroke', assertStroke(createShape))
+		it('size', assertSize(createShape))
+		it('spline', assertSpline(createShape))
+	})
+
+	SHAPES.map((shapeDef) => {
+		describe(shapeDef.tool, () => {
+			const createShape = async () => {
+				await ui.tools.click(shapeDef.tool)
+				await ui.canvas.brush(60, 60, 210, 210)
+
+				await ui.canvas.doubleClick(60 + (210 - 60) / 2, 60 + (210 - 60) / 2)
+				await browser.keys(['test'])
+				await browser.action('key').down('\uE03D').down('\uE007').perform(true)
+				await util.sleep(20)
+				await browser.action('key').up('\uE007').up('\uE03D').perform(true)
+
+				return (await runtime.getAllShapes())[0]
+			}
+
+			it('color', assertColors(createShape))
+			it.todo('opacity', () => {})
+			it('fill', assertFill(createShape))
+			it('stroke', assertStroke(createShape))
+			it('size', assertSize(createShape))
+			it('font', assertFont(createShape))
+			it('align', assertAlign(createShape))
+		})
+	})
+
+	describe('text', () => {
+		const createShape = async () => {
+			await ui.tools.click('select')
+			await ui.tools.click('text')
+			await ui.canvas.click(100, 100)
+			await browser.keys('testing')
+
+			return (await runtime.getAllShapes())[0]
+		}
+		it('color', assertColors(createShape))
+		it.todo('opacity', assertOpacity(createShape))
+		it('size', assertSize(createShape))
+		it('font', assertFont(createShape))
+		it('align', assertAlign(createShape))
+	})
+
+	describe('frame', () => {
+		const createShape = async () => {
+			await ui.tools.click('frame')
+			await ui.canvas.brush(10, 10, 60, 160)
+
+			await ui.canvas.doubleClick(10, 0)
+			await browser.keys([
+				'test',
+				'\uE007', // ENTER
+			])
+
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].type).toBe('frame')
+			expect(allShapes[0].props).toHaveProperty('name', 'test')
+
+			return allShapes[0]
+		}
+		it.todo('opacity', assertOpacity(createShape))
+	})
+
+	describe.skip('note', () => {
+		const createShape = async () => {
+			await ui.tools.click('note')
+			await ui.canvas.click(100, 100)
+			await browser.keys(['test'])
+			await browser.action('key').down('\uE03D').down('\uE007').perform(true)
+			await util.sleep(20)
+			await browser.action('key').up('\uE007').up('\uE03D').perform(true)
+
+			const allShapes = await runtime.getAllShapes()
+			expect(allShapes.length).toBe(1)
+			expect(allShapes[0].type).toBe('note')
+			expect(allShapes[0].props).toHaveProperty('text', 'test')
+
+			return allShapes[0]
+		}
+		it('color', assertColors(createShape))
+		it.todo('opacity', assertOpacity(createShape))
+		it('size', assertSize(createShape))
+		it('font', assertFont(createShape))
+		it('align', assertAlign(createShape))
+	})
+})

e2e/test/specs/text.ts

@@ -0,0 +1,243 @@
+import { runtime, ui } from '../helpers'
+import { diffScreenshot, takeRegionScreenshot } from '../helpers/webdriver'
+import { describe, env, it } from '../mocha-ext'
+
+describe('text', () => {
+	env(
+		{
+			// This can be removed once bugs resolved on mobile.
+			// Tracked in <https://linear.app/tldraw/issue/TLD-1300/re-enable-text-rendering-tests-on-mobile>
+			device: 'desktop',
+		},
+		() => {
+			const tests = [
+				{
+					name: 'multiline (align center)',
+					fails: true,
+					handler: async () => {
+						await ui.tools.click('select')
+						await ui.tools.click('text')
+						await ui.canvas.brush(100, 0, 150, 150)
+						await browser.keys('testing\ntesting\n1, 2, 3')
+					},
+				},
+				// {
+				// 	name: 'diacritics (align center)',
+				// 	fails: false,
+				// 	handler: async () => {
+				// 		await ui.tools.click('text')
+				// 		await ui.canvas.brush(50, 100, 150, 150)
+				// 		await browser.keys('âéīôù')
+				// 	},
+				// },
+			]
+
+			for (const test of tests) {
+				const { name } = test
+				const slugName = name.replace(/ /g, '-').replace(/[)(]/g, '')
+				const prefix = [
+					global.webdriverService,
+					global.tldrawOptions.os,
+					global.tldrawOptions.browser,
+					global.tldrawOptions.ui,
+					slugName,
+				].join('-')
+
+				const cleanUp = async () => {
+					await ui.main.menu(['edit', 'select-all'])
+					await ui.main.menu(['edit', 'delete'])
+				}
+
+				const testHandler = async () => {
+					await ui.app.setup()
+					await test.handler()
+
+					await ui.main.menu(['edit', 'select-all'])
+					const selectionBounds = await runtime.selectionBounds()
+					await ui.main.menu(['edit', 'select-none'])
+
+					const screenshotResults = await takeRegionScreenshot(selectionBounds, {
+						writeTo: {
+							path: `${__dirname}/../../screenshots/`,
+							prefix,
+						},
+					})
+
+					const { pxielDiff } = await diffScreenshot(screenshotResults, {
+						writeTo: {
+							path: `${__dirname}/../../screenshots/`,
+							prefix,
+						},
+					})
+
+					await cleanUp()
+					expect(pxielDiff).toBeLessThan(70)
+				}
+
+				it[test.fails ? 'fails' : 'ok']('text: ' + test.name, testHandler)
+			}
+		}
+	)
+})
+
+describe('text measurement', () => {
+	const measureTextOptions = {
+		text: 'testing',
+		width: 'fit-content',
+		fontFamily: 'var(--tl-font-draw)',
+		fontSize: 24,
+		lineHeight: 1.35,
+		fontWeight: 'normal',
+		fontStyle: 'normal',
+		padding: '0px',
+		maxWidth: 'auto',
+	}
+
+	const getTextLinesOptions = {
+		text: 'testing',
+		width: 100,
+		height: 1000,
+		wrap: true,
+		padding: 0,
+		fontSize: 24,
+		fontWeight: 'normal',
+		fontFamily: 'var(--tl-font-draw)',
+		fontStyle: 'normal',
+		lineHeight: 1.35,
+		textAlign: 'start' as 'start' | 'middle' | 'end',
+	}
+
+	env({}, () => {
+		it('should measure text', async () => {
+			await ui.app.setup()
+			const { w, h } = await browser.execute((options) => {
+				return window.app.textMeasure.measureText({
+					...options,
+				})
+			}, measureTextOptions)
+
+			expect(w).toBeCloseTo(85.828125, 1)
+			expect(h).toBeCloseTo(32.3984375, 1)
+		})
+
+		it('should get a single text line', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing'])
+		})
+
+		it('should wrap a word when it has to', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					width: 50,
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['test', 'ing'])
+		})
+
+		it('should wrap between words when it has to', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: 'testing testing',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing', 'testing'])
+		})
+
+		it('should strip whitespace at line breaks', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: 'testing  testing',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing', 'testing'])
+		})
+
+		it('should strip whitespace at the end of wrapped lines', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: 'testing testing  ',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing', 'testing'])
+		})
+
+		it('should strip whitespace at the end of unwrapped lines', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					width: 200,
+					text: 'testing testing  ',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing testing'])
+		})
+
+		it('should strip whitespace from the start of an unwrapped line', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					width: 200,
+					text: '  testing testing',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing testing'])
+		})
+
+		it('should place starting whitespace on its own line if it has to', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: '  testing testing',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['', 'testing', 'testing'])
+		})
+
+		it('should place ending whitespace on its own line if it has to', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: 'testing testing  ',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual(['testing', 'testing'])
+		})
+		it('should return an empty array if the text is empty', async () => {
+			await ui.app.setup()
+			const lines = await browser.execute((options) => {
+				return window.app.textMeasure.getTextLines({
+					...options,
+					text: '',
+				})
+			}, getTextLinesOptions)
+
+			expect(lines).toEqual([])
+		})
+	})
+})

e2e/test/test-constants.ts

@@ -0,0 +1,12 @@
+export const IS_MAC_OS = process.platform === 'darwin'
+
+export const WINDOW_SIZES = {
+	MOBILE_PORTRAIT: {
+		width: 414,
+		height: 796,
+	},
+	DESKTOP: {
+		width: 1200,
+		height: 800,
+	},
+}

e2e/tsconfig.json

@@ -0,0 +1,36 @@
+{
+	"include": ["test"],
+	"exclude": ["node_modules", "dist", ".tsbuild*"],
+	"compilerOptions": {
+		"jsx": "react-jsx",
+		"skipLibCheck": true,
+		"resolveJsonModule": true,
+		"allowSyntheticDefaultImports": true,
+		"importHelpers": true,
+		"lib": ["dom", "esnext"],
+		"esModuleInterop": true,
+		"target": "ESNext",
+		"moduleResolution": "node16",
+		"types": [
+			"node",
+			"@wdio/globals/types",
+			"@wdio/mocha-framework",
+			"@types/mocha",
+			"wdio-vscode-service"
+		],
+		"noEmitOnError": false,
+		"noEmit": true
+	},
+	"ts-node": {
+		"compilerOptions": {
+			"moduleResolution": "node",
+			"module": "CommonJS"
+		}
+	},
+	"references": [
+		{ "path": "../packages/editor" },
+		{ "path": "../packages/tlschema" },
+		{ "path": "../packages/tlstore" },
+		{ "path": "../packages/primitives" }
+	]
+}

e2e/wdio.local.conf.js

@@ -0,0 +1,260 @@
+const edgeDriver = require('@sitespeed.io/edgedriver')
+
+const CURRENT_OS = {
+	win32: 'windows',
+	linux: 'linux',
+	darwin: 'macos',
+}[process.platform]
+
+global.webdriverService = 'local'
+global.webdriverTestUrl = process.env.TEST_URL ?? 'http://localhost:5420/'
+
+let capabilities
+if (process.env.CI === 'true') {
+	capabilities = [
+		// {
+		// 	maxInstances: 1,
+		// 	browserName: 'chrome',
+		// 	acceptInsecureCerts: true,
+		// 	'goog:chromeOptions': {
+		// 		mobileEmulation: {
+		// 			deviceName: 'iPhone XR',
+		// 		},
+		// 		prefs: {
+		// 			download: {
+		// 				default_directory: __dirname + '/downloads/',
+		// 				prompt_for_download: false,
+		// 			},
+		// 		},
+		// 	},
+		// 	'tldraw:options': {
+		// 		browser: 'chrome',
+		// 		os: CURRENT_OS,
+		// 		ui: 'mobile',
+		// 		device: 'mobile',
+		// 		input: ['touch'],
+		// 	},
+		// },
+		{
+			maxInstances: 1,
+			browserName: 'chrome',
+			acceptInsecureCerts: true,
+			'goog:chromeOptions': {
+				prefs: {
+					download: {
+						default_directory: __dirname + '/downloads/',
+						prompt_for_download: false,
+					},
+				},
+			},
+			'tldraw:options': {
+				browser: 'chrome',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+	]
+} else {
+	capabilities = [
+		{
+			maxInstances: 1,
+			browserName: 'chrome',
+			acceptInsecureCerts: true,
+			'goog:chromeOptions': {
+				// Network emulation requires device mode, which is only enabled when mobile emulation is on
+				mobileEmulation: {
+					deviceName: 'iPhone XR',
+				},
+				prefs: {
+					download: {
+						default_directory: __dirname + '/downloads/',
+						prompt_for_download: false,
+					},
+				},
+			},
+			'tldraw:options': {
+				browser: 'chrome',
+				os: CURRENT_OS,
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		{
+			maxInstances: 1,
+			browserName: 'vscode',
+			browserVersion: 'stable',
+			acceptInsecureCerts: true,
+			'wdio:vscodeOptions': {
+				extensionPath: __dirname + '../bublic/apps/vscode/extension/dist/web',
+				userSettings: {
+					'editor.fontSize': 14,
+				},
+			},
+			'tldraw:options': {
+				browser: 'vscode',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+				windowSize: 'default',
+			},
+		},
+		{
+			maxInstances: 1,
+			browserName: 'chrome',
+			acceptInsecureCerts: true,
+			'goog:chromeOptions': {
+				prefs: {
+					download: {
+						default_directory: __dirname + '/downloads/',
+						prompt_for_download: false,
+					},
+				},
+			},
+			'tldraw:options': {
+				browser: 'chrome',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			maxInstances: 1,
+			browserName: 'safari',
+			acceptInsecureCerts: true,
+			'tldraw:options': {
+				browser: 'safari',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			maxInstances: 1,
+			browserName: 'firefox',
+			acceptInsecureCerts: true,
+			'tldraw:options': {
+				browser: 'firefox',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			maxInstances: 1,
+			browserName: 'MicrosoftEdge',
+			acceptInsecureCerts: true,
+			'tldraw:options': {
+				browser: 'edge',
+				os: CURRENT_OS,
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+	]
+}
+
+let browsers = (process.env.BROWSERS || 'chrome').split(',').map((b) => b.trim())
+const validBrowsers = ['chrome', 'safari', 'firefox', 'edge', 'vscode']
+const skippedBrowsers = []
+
+if (browsers.includes('safari')) {
+	console.log(
+		'NOTE: In safari you need to run `safaridriver --enable`, see <https://developer.apple.com/documentation/webkit/testing_with_webdriver_in_safari> for details.'
+	)
+}
+
+for (const browser of browsers) {
+	if (!validBrowsers.includes(browser)) {
+		throw new Error(`'${browser}' not a valid browser name`)
+	}
+	if (skippedBrowsers.includes(browser)) {
+		console.error(`'${browser}' not currently supported`)
+	}
+}
+
+capabilities = capabilities.filter((capability) => {
+	return browsers.includes(capability['tldraw:options'].browser)
+})
+
+exports.config = {
+	specs: ['./test/specs/index.ts'],
+	hostname: process.env.DOCKER_HOST || 'localhost',
+	exclude: [],
+	services: process.env.DOCKER_HOST
+		? []
+		: [
+				['vscode', { verboseLogging: true }],
+				[
+					'geckodriver',
+					{
+						outputDir: './driver-logs',
+						logFileName: 'wdio-geckodriver.log',
+					},
+				],
+				[
+					'safaridriver',
+					{
+						outputDir: './driver-logs',
+						logFileName: 'wdio-safaridriver.log',
+					},
+				],
+				[
+					'chromedriver',
+					{
+						logFileName: 'wdio-chromedriver.log',
+						outputDir: './driver-logs',
+						args: ['--silent'],
+						// NOTE: Must be on a different port that 7676 otherwise it conflicts with 'vscode' service.
+						port: 7677,
+					},
+				],
+				// HACK: If we don't have edge as a capability but we do have
+				// this service then `wdio-edgedriver-service` throws an scary
+				// error (which doesn't actually effect anything)
+				...(!browsers.includes('edge')
+					? []
+					: [
+							[
+								'edgedriver',
+								{
+									port: 17556, // default for EdgeDriver
+									logFileName: 'wdio-edgedriver.log',
+									outputDir: './driver-logs',
+									edgedriverCustomPath: edgeDriver.binPath(),
+								},
+							],
+					  ]),
+		  ],
+	maxInstances: 1,
+	capabilities: capabilities,
+	logLevel: process.env.WD_LOG_LEVEL ?? 'error',
+	bail: 0,
+	baseUrl: 'http://localhost',
+	waitforTimeout: 10000,
+	connectionRetryTimeout: 120000,
+	connectionRetryCount: 3,
+	framework: 'mocha',
+	reporters: ['spec'],
+	mochaOpts: {
+		ui: 'bdd',
+		timeout: 60000,
+	},
+	beforeSession: (_config, capabilities) => {
+		global.tldrawOptions = capabilities['tldraw:options']
+	},
+	autoCompileOpts: {
+		autoCompile: true,
+		tsNodeOpts: {
+			transpileOnly: true,
+			project: './tsconfig.json',
+		},
+	},
+}

e2e/wdio.nightly.conf.js

@@ -0,0 +1,280 @@
+const BUILD_NAME = `test-suite-${new Date().toISOString()}`
+
+global.webdriverService = 'browserstack'
+global.webdriverTestUrl = 'http://localhost:5420/'
+
+exports.config = {
+	user: process.env.BROWSERSTACK_USER,
+	key: process.env.BROWSERSTACK_KEY,
+	hostname: 'hub.browserstack.com',
+	specs: ['./test/specs/index.ts'],
+	services: [
+		[
+			'browserstack',
+			{
+				browserstackLocal: true,
+				opts: {
+					verbose: 'true',
+				},
+			},
+		],
+	],
+	exclude: [],
+	maxInstances: 1,
+	waitforInterval: 200,
+	/**
+	 * Capabilities can be configured via <https://www.browserstack.com/automate/capabilities>
+	 *
+	 * The once commented out currently fail on because of insecure certs, details <https://www.browserstack.com/guide/how-to-test-https-websites-from-localhost>
+	 */
+	capabilities: [
+		/**
+		 * ====================================================================
+		 * Windows 11
+		 * ====================================================================
+		 */
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '3.14.0',
+			},
+			browserName: 'Chrome',
+			'tldraw:options': {
+				browser: 'chrome',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Edge',
+			'tldraw:options': {
+				browser: 'edge',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Firefox',
+			'tldraw:options': {
+				browser: 'firefox',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		/**
+		 * ====================================================================
+		 * MacOS
+		 * ====================================================================
+		 */
+		// {
+		//     'bstack:options' : {
+		//         "os" : "OS X",
+		//         "osVersion" : "Ventura",
+		//         "browserVersion" : "16.0",
+		//         "seleniumVersion" : "4.6.0",
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "Safari",
+		// },
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			browserName: 'Chrome',
+			'tldraw:options': {
+				browser: 'chrome',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Firefox',
+			'tldraw:options': {
+				browser: 'firefox',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Edge',
+			'tldraw:options': {
+				browser: 'edge',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		/**
+		//  * ====================================================================
+		//  * Android
+		//  * ====================================================================
+		//  */
+		{
+			'bstack:options': {
+				osVersion: '13.0',
+				deviceName: 'Google Pixel 7',
+				appiumVersion: '1.22.0',
+			},
+			browserName: 'chrome',
+			'tldraw:options': {
+				appium: true,
+				browser: 'chrome',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		{
+			'bstack:options': {
+				osVersion: '11.0',
+				deviceName: 'Samsung Galaxy S21',
+				appiumVersion: '1.22.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'samsung',
+			'tldraw:options': {
+				appium: true,
+				browser: 'samsung',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		{
+			'bstack:options': {
+				osVersion: '11.0',
+				deviceName: 'Samsung Galaxy S21',
+				appiumVersion: '1.22.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'chrome',
+			'tldraw:options': {
+				appium: true,
+				browser: 'chrome',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		/**
+		 * ====================================================================
+		 * iOS
+		 * ====================================================================
+		 */
+		// {
+		//     'bstack:options': {
+		//         "osVersion" : "16",
+		//         "deviceName" : "iPhone 14",
+		//         "appiumVersion": "1.22.0"
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "safari",
+		// },
+		// {
+		//     'bstack:options': {
+		//         "osVersion" : "16",
+		//         "deviceName" : "iPad Pro 12.9 2022",
+		//         "appiumVersion": "1.22.0"
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "safari",
+		// },
+	]
+		.map((capability) => {
+			return {
+				...capability,
+				acceptInsecureCerts: true,
+				'bstack:options': {
+					...capability['bstack:options'],
+					projectName: 'smoke-tests',
+					buildName: BUILD_NAME,
+					consoleLogs: 'verbose',
+				},
+				'tldraw:options': {
+					...capability['tldraw:options'],
+				},
+			}
+		})
+		.filter((capability) => {
+			const { os, browser } = capability['tldraw:options']
+			const envOsKey = `WD_OS_${os.toUpperCase()}`
+			const envBrowserKey = `WD_BROWSER_${browser.toUpperCase()}`
+			const envOsValue = process.env[envOsKey]
+			const envBrowserValue = process.env[envBrowserKey]
+			return !(envOsValue === 'false' || envBrowserValue === 'false')
+		}),
+	bail: 0,
+	waitforTimeout: 10000,
+	connectionRetryTimeout: 120000,
+	connectionRetryCount: 3,
+	framework: 'mocha',
+	reporters: ['spec'],
+	mochaOpts: {
+		ui: 'bdd',
+		timeout: 5 * 60 * 1000,
+	},
+	logLevel: process.env.WD_LOG_LEVEL ?? 'info',
+	coloredLogs: true,
+	screenshotPath: './errorShots/',
+	waitforTimeout: 30000,
+	connectionRetryTimeout: 90000,
+	connectionRetryCount: 3,
+	beforeSession: (_config, capabilities) => {
+		global.tldrawOptions = capabilities['tldraw:options']
+	},
+	autoCompileOpts: {
+		autoCompile: true,
+		tsNodeOpts: {
+			transpileOnly: true,
+			swc: true,
+			project: './tsconfig.json',
+		},
+	},
+}

e2e/wdio.remote.conf.js

@@ -0,0 +1,271 @@
+const BUILD_NAME = `test-suite-${new Date().toISOString()}`
+
+global.webdriverService = 'browserstack'
+global.webdriverTestUrl = 'http://localhost:5420/'
+
+exports.config = {
+	user: process.env.BROWSERSTACK_USER,
+	key: process.env.BROWSERSTACK_KEY,
+	hostname: 'hub.browserstack.com',
+	specs: ['./test/specs/index.ts'],
+	services: [
+		[
+			'browserstack',
+			{
+				browserstackLocal: true,
+				opts: {
+					verbose: 'true',
+				},
+			},
+		],
+	],
+	exclude: [],
+	maxInstances: 1,
+	waitforInterval: 200,
+	/**
+	 * Capabilities can be configured via <https://www.browserstack.com/automate/capabilities>
+	 *
+	 * The once commented out currently fail on because of insecure certs, details <https://www.browserstack.com/guide/how-to-test-https-websites-from-localhost>
+	 */
+	capabilities: [
+		/**
+		 * ====================================================================
+		 * Windows 11
+		 * ====================================================================
+		 */
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '3.14.0',
+			},
+			browserName: 'Chrome',
+			'tldraw:options': {
+				browser: 'chrome',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Edge',
+			'tldraw:options': {
+				browser: 'edge',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'Windows',
+				osVersion: '11',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Firefox',
+			'tldraw:options': {
+				browser: 'firefox',
+				os: 'windows',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		/**
+		 * ====================================================================
+		 * MacOS
+		 * ====================================================================
+		 */
+		// {
+		//     'bstack:options' : {
+		//         "os" : "OS X",
+		//         "osVersion" : "Ventura",
+		//         "browserVersion" : "16.0",
+		//         "seleniumVersion" : "4.6.0",
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "Safari",
+		// },
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			browserName: 'Chrome',
+			'tldraw:options': {
+				browser: 'chrome',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Firefox',
+			'tldraw:options': {
+				browser: 'firefox',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		{
+			'bstack:options': {
+				os: 'OS X',
+				osVersion: 'Ventura',
+				browserVersion: 'latest',
+				seleniumVersion: '4.6.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'Edge',
+			'tldraw:options': {
+				browser: 'edge',
+				os: 'macos',
+				ui: 'desktop',
+				device: 'desktop',
+				input: ['mouse'],
+			},
+		},
+		/**
+        //  * ====================================================================
+        //  * Android
+        //  * ====================================================================
+        //  */
+		{
+			'bstack:options': {
+				osVersion: '13.0',
+				deviceName: 'Google Pixel 7',
+				appiumVersion: '1.22.0',
+			},
+			browserName: 'chrome',
+			'tldraw:options': {
+				appium: true,
+				browser: 'chrome',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		{
+			'bstack:options': {
+				osVersion: '11.0',
+				deviceName: 'Samsung Galaxy S21',
+				appiumVersion: '1.22.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'samsung',
+			'tldraw:options': {
+				appium: true,
+				browser: 'samsung',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		{
+			'bstack:options': {
+				osVersion: '11.0',
+				deviceName: 'Samsung Galaxy S21',
+				appiumVersion: '1.22.0',
+			},
+			acceptInsecureCerts: 'true',
+			browserName: 'chrome',
+			'tldraw:options': {
+				appium: true,
+				browser: 'chrome',
+				os: 'android',
+				ui: 'mobile',
+				device: 'mobile',
+				input: ['touch'],
+			},
+		},
+		/**
+		 * ====================================================================
+		 * iOS
+		 * ====================================================================
+		 */
+		// {
+		//     'bstack:options': {
+		//         "osVersion" : "16",
+		//         "deviceName" : "iPhone 14",
+		//         "appiumVersion": "1.22.0"
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "safari",
+		// },
+		// {
+		//     'bstack:options': {
+		//         "osVersion" : "16",
+		//         "deviceName" : "iPad Pro 12.9 2022",
+		//         "appiumVersion": "1.22.0"
+		//     },
+		//     "acceptInsecureCerts" : "true",
+		//     "browserName" : "safari",
+		// },
+	].map((capability) => {
+		return {
+			...capability,
+			acceptInsecureCerts: true,
+			'bstack:options': {
+				...capability['bstack:options'],
+				projectName: 'smoke-tests',
+				buildName: BUILD_NAME,
+				consoleLogs: 'verbose',
+			},
+			'tldraw:options': {
+				...capability['tldraw:options'],
+			},
+		}
+	}),
+	bail: 0,
+	waitforTimeout: 10000,
+	connectionRetryTimeout: 120000,
+	connectionRetryCount: 3,
+	framework: 'mocha',
+	reporters: ['spec'],
+	mochaOpts: {
+		ui: 'bdd',
+		timeout: 5 * 60 * 1000,
+	},
+	logLevel: process.env.WD_LOG_LEVEL ?? 'info',
+	coloredLogs: true,
+	screenshotPath: './errorShots/',
+	waitforTimeout: 30000,
+	connectionRetryTimeout: 90000,
+	connectionRetryCount: 3,
+	beforeSession: (_config, capabilities) => {
+		global.tldrawOptions = capabilities['tldraw:options']
+	},
+	autoCompileOpts: {
+		autoCompile: true,
+		tsNodeOpts: {
+			transpileOnly: true,
+			swc: true,
+			project: './tsconfig.json',
+		},
+	},
+}

lazy.config.ts

@@ -16,6 +16,11 @@ export function generateSharedScripts(bublic: '<rootDir>' | '<rootDir>/bublic')
 		'dev-vscode': {
 			runsAfter: { 'build:vscode-editor': {} },
 		},
+		'dev-webdriver': {
+			execution: 'independent',
+			runsAfter: { 'refresh-assets': {}, prebuild: {}, 'build:vscode-editor': {} },
+			cache: 'none',
+		},
 		test: {
 			baseCommand: 'yarn run -T jest',
 			runsAfter: { 'refresh-assets': {} },

package.json

@@ -28,6 +28,7 @@
 		"apps/*",
 		"packages/*",
 		"apps/vscode/*",
+		"e2e",
 		"config",
 		"scripts"
 	],
@@ -40,6 +41,7 @@
 		"dev": "lazy run dev --filter='{,bublic/}apps/examples' --filter='{,bublic/}packages/tldraw'",
 		"dev-docs": "lazy run dev-docs",
 		"dev-vscode": "code ./apps/vscode/extension && lazy run dev --filter='{,bublic/}apps/vscode/{extension,editor}'",
+		"dev-webdriver": "lazy run dev-webdriver --filter='apps/webdriver'",
 		"build-types": "lazy inherit",
 		"build-api": "lazy build-api",
 		"build-package": "lazy build-package",

scripts/e2e-run-ci

@@ -0,0 +1,14 @@
+set -eux
+export ENABLE_SSL=1
+export ENABLE_NETWORK_CACHING=1
+yarn workspace @tldraw/tldraw prebuild
+SHELL=/bin/bash nohup yarn dev-webdriver &
+PROCCESS_PID="$!"
+
+mode="${1:-local}"
+sleep 5
+yarn workspace @tldraw/e2e "test:${mode}"
+exit_code=$?
+
+kill $PROCCESS_PID
+exit $exit_code

scripts/e2e-run-tests

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -eux
+
+mode="${1:-local}"
+export BROWSERS="${2:-chrome}"
+# if [[ "$mode" == "remote" ]]; then
+#     export ENABLE_SSL=1
+# fi
+yarn workspace @tldraw/e2e "test:${mode}"

scripts/e2e-start-server

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -eux
+yarn dev-webdriver