Skip to content

armgit / BUI

Public Imported from GitHub
0

Blender's GPU Accelerated UI, Decoupled from it's original codebase. Supports Rust, Python, JS, React, C & C++. Twice as good as GPUI

add svelte

Preetham Pemmasani2aa1cc65fccc
diff --git a/bindings/node/globals.d.ts b/bindings/node/globals.d.ts
new file mode 100644
index 0000000..30f6d66
--- /dev/null
+++ b/bindings/node/globals.d.ts
@@ -0,0 +1,6 @@
+// Types for @blender-ui/native/globals: importing it installs `document`,
+// `window`, the node classes and `requestAnimationFrame` as globals, for
+// DOM-based frameworks (Svelte).
+import type { Document } from './index'
+
+export const document: Document
diff --git a/bindings/node/globals.js b/bindings/node/globals.js
new file mode 100644
index 0000000..4866813
--- /dev/null
+++ b/bindings/node/globals.js
@@ -0,0 +1,63 @@
+// The browser globals DOM-based frameworks read (Svelte's compiled
+// components; Solid's or Lit's DOM output the same way): `document`,
+// `window`, the node classes for `instanceof`, `requestAnimationFrame`.
+// `require('@blender-ui/native/globals')` installs them once; `document`
+// makes detached nodes that join a window's tree when inserted into it, so a
+// component mounts into any BUI window's `body`.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+'use strict'
+
+const dom = require('./dom')
+
+const g = globalThis
+if (g.document !== dom.document) {
+ // never instantiated: `instanceof` checks against them are simply false
+ class HTMLMediaElement {}
+ class ShadowRoot {}
+ const win = {
+ document: dom.document,
+ addEventListener () {},
+ removeEventListener () {},
+ }
+ const define = (name, value) => { if (g[name] === undefined) g[name] = value }
+ g.document = dom.document
+ g.window = Object.assign(g.window ?? win, win)
+ define('navigator', { userAgent: 'BUI' })
+ // the classes `instanceof` checks name; prototypes for frameworks that patch them
+ for (const [name, value] of Object.entries({
+ Node: dom.Node,
+ Element: dom.Element,
+ HTMLElement: dom.HTMLElement,
+ Text: dom.TextNode,
+ Comment: dom.Comment,
+ DocumentFragment: dom.DocumentFragment,
+ Document: dom.Document,
+ })) g[name] = value
+ // Node.js and Bun have these; the QuickJS runtime (`bui build`) doesn't
+ define('Event', class Event {
+ constructor (type, init) {
+ this.type = type
+ this.bubbles = !!init?.bubbles
+ this.cancelBubble = this.defaultPrevented = false
+ }
+
+ preventDefault () { this.defaultPrevented = true }
+ stopPropagation () { this.cancelBubble = true }
+ })
+ define('CustomEvent', class CustomEvent extends g.Event {
+ constructor (type, init) {
+ super(type, init)
+ this.detail = init?.detail ?? null
+ }
+ })
+ define('HTMLMediaElement', HTMLMediaElement)
+ define('ShadowRoot', ShadowRoot)
+ // timing for animations (motion, tweens): a 60 Hz clock; a window's own
+ // `requestAnimationFrame` is paced by its display
+ define('requestAnimationFrame', (cb) => setTimeout(() => cb(performance.now()), 16))
+ define('cancelAnimationFrame', (id) => clearTimeout(id))
+ define('getComputedStyle', (el) => el.style)
+}
+
+module.exports = { document: dom.document }
diff --git a/bindings/node/package.json b/bindings/node/package.json
index 63def16..e7fbd66 100644
--- a/bindings/node/package.json
+++ b/bindings/node/package.json
@@ -17,16 +17,22 @@
"types": "./host.d.ts",
"default": "./host.js"
},
+ "./globals": {
+ "types": "./globals.d.ts",
+ "default": "./globals.js"
+ },
"./package.json": "./package.json"
},
"files": [
"index.js",
"dom.js",
"host.js",
+ "globals.js",
"bundle.js",
"signals.js",
"index.d.ts",
"host.d.ts",
+ "globals.d.ts",
"cli.js",
"blenderui.*.node",
"bui-runtime.*",
@@ -73,6 +79,7 @@
"css",
"signals",
"bun",
- "react"
+ "react",
+ "svelte"
]
}
diff --git a/bindings/package-lock.json b/bindings/package-lock.json
index 271260e..6f986e3 100644
--- a/bindings/package-lock.json
+++ b/bindings/package-lock.json
@@ -7,7 +7,8 @@
"name": "blenderui-js",
"workspaces": [
"node",
- "react"
+ "react",
+ "svelte"
]
},
"node": {
@@ -38,6 +39,179 @@
"resolved": "react",
"link": true
},
+ "node_modules/@blender-ui/svelte": {
+ "resolved": "svelte",
+ "link": true
+ },
+ "node_modules/@jridgewell/gen-mapping": {
+ "version": "0.3.13",
+ "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
+ "integrity": "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.5.0",
+ "@jridgewell/trace-mapping": "^0.3.24"
+ }
+ },
+ "node_modules/@jridgewell/remapping": {
+ "version": "2.3.5",
+ "resolved": "https://registry.npmjs.org/@jridgewell/remapping/-/remapping-2.3.5.tgz",
+ "integrity": "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/gen-mapping": "^0.3.5",
+ "@jridgewell/trace-mapping": "^0.3.24"
+ }
+ },
+ "node_modules/@jridgewell/resolve-uri": {
+ "version": "3.1.2",
+ "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+ "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.0.0"
+ }
+ },
+ "node_modules/@jridgewell/sourcemap-codec": {
+ "version": "1.6.0",
+ "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.6.0.tgz",
+ "integrity": "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@jridgewell/trace-mapping": {
+ "version": "0.3.31",
+ "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.31.tgz",
+ "integrity": "sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/resolve-uri": "^3.1.0",
+ "@jridgewell/sourcemap-codec": "^1.4.14"
+ }
+ },
+ "node_modules/@sveltejs/acorn-typescript": {
+ "version": "1.0.13",
+ "resolved": "https://registry.npmjs.org/@sveltejs/acorn-typescript/-/acorn-typescript-1.0.13.tgz",
+ "integrity": "sha512-wgKggnhZVL9Bfx1OaKKTrYY9BFRk6C8UAkQNUcIv1+llzYrIqy+RZm5HPKzn0NpEBvTVhTqB4kQyllZywsRBRQ==",
+ "dev": true,
+ "license": "MIT",
+ "peerDependencies": {
+ "acorn": "^8.9.0"
+ }
+ },
+ "node_modules/@types/estree": {
+ "version": "1.0.10",
+ "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.10.tgz",
+ "integrity": "sha512-lTyOMnOcmRBzdCv6/4zUZCrEhV0xrqQiUZBZtVcbmLHBXKLnN8q89v/wKRF/Q0HbwVsqbIG3o5HDoFl9sduM+g==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/acorn": {
+ "version": "8.19.0",
+ "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.19.0.tgz",
+ "integrity": "sha512-oJlA3XiRm7Cyk6qFD2Jn8ak9B7jSy0qy00ADO3+8dpT0LSjFihQYv4C02LFCSYJV3Q37xYwwRy5m+IpIiUzqWw==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "acorn": "bin/acorn"
+ },
+ "engines": {
+ "node": ">=0.4.0"
+ }
+ },
+ "node_modules/aria-query": {
+ "version": "5.3.1",
+ "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.1.tgz",
+ "integrity": "sha512-Z/ZeOgVl7bcSYZ/u/rh0fOpvEpq//LZmdbkXyc7syVzjPAhfOa9ebsdTSjEBDU4vs5nC98Kfduj1uFo0qyET3g==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/axobject-query": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz",
+ "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/clsx": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
+ "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/devalue": {
+ "version": "5.9.4",
+ "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.9.4.tgz",
+ "integrity": "sha512-sPAT4pztbu6586/hrhOnMKS17IJrvg12mXiSPSS3W5qDeN2RGgvZ0diZCm31dBbnevfVmujNO3IM2wrS4Y2Rhg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/esm-env": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/esm-env/-/esm-env-1.2.2.tgz",
+ "integrity": "sha512-Epxrv+Nr/CaL4ZcFGPJIYLWFom+YeV1DqMLHJoEd9SYRxNbaFruBwfEX/kkHUJf55j2+TUbmDcmuilbP1TmXHA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/esrap": {
+ "version": "2.4.0",
+ "resolved": "https://registry.npmjs.org/esrap/-/esrap-2.4.0.tgz",
+ "integrity": "sha512-CQPcneEHw/czj32uwQC52nYnax8H4SXt25FCM+LIwGZ49cMIxpOj3bP8wmzcI+Z0HIy5KkClaPhRLfCySzwHPA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.4.15"
+ },
+ "peerDependencies": {
+ "@typescript-eslint/types": "^8.2.0"
+ },
+ "peerDependenciesMeta": {
+ "@typescript-eslint/types": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/is-reference": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/is-reference/-/is-reference-3.0.3.tgz",
+ "integrity": "sha512-ixkJoqQvAP88E6wLydLGGqCJsrFUnqoH6HnaczB8XmDH1oaWU+xxdptvikTgaEhtZ53Ky6YXiBuUI2WXLMCwjw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.6"
+ }
+ },
+ "node_modules/locate-character": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/locate-character/-/locate-character-3.0.0.tgz",
+ "integrity": "sha512-SW13ws7BjaeJ6p7Q6CO2nchbYEc3X3J6WrmTTDto7yMPqVSZTUyY5Tjbid+Ab8gLnATtygYtiDIJGQRRn2ZOiA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/magic-string": {
+ "version": "0.30.21",
+ "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+ "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.5.5"
+ }
+ },
"node_modules/react": {
"version": "19.3.1",
"resolved": "https://registry.npmjs.org/react/-/react-19.3.1.tgz",
@@ -68,6 +242,40 @@
"integrity": "sha512-juorfCmIkIw8tT+p5BXSm6PJjQF/ycEYmKyzURCIt/RaZIhL+PulbQ9Yu2z1HdOJDdqDTlxA1+xKBmHXJsczAw==",
"license": "MIT"
},
+ "node_modules/svelte": {
+ "version": "5.57.3",
+ "resolved": "https://registry.npmjs.org/svelte/-/svelte-5.57.3.tgz",
+ "integrity": "sha512-5mAftM3SoDV9X0zdF386F9p2pv8iKOwi/KfBS1XnBAkVCKFzVOLHUoa8iGWAt4buoicLmyWVRpuuD5wplXOQsg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/remapping": "^2.3.5",
+ "@jridgewell/sourcemap-codec": "^1.6.0",
+ "@sveltejs/acorn-typescript": "^1.0.13",
+ "@types/estree": "^1.0.9",
+ "acorn": "^8.18.0",
+ "aria-query": "5.3.1",
+ "axobject-query": "^4.1.0",
+ "clsx": "^2.1.1",
+ "devalue": "^5.9.2",
+ "esm-env": "^1.2.1",
+ "esrap": "^2.3.6",
+ "is-reference": "^3.0.3",
+ "locate-character": "^3.0.0",
+ "magic-string": "^0.30.11",
+ "zimmerframe": "^1.1.2"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/zimmerframe": {
+ "version": "1.1.5",
+ "resolved": "https://registry.npmjs.org/zimmerframe/-/zimmerframe-1.1.5.tgz",
+ "integrity": "sha512-msJxIvYDYcoNL+PJsu+7qmpDWsYmAxTY+2TNYXXF0hzBzBk0BMecOqDOG/EckUoKCuKwObfbugIl8QpqHDXeFA==",
+ "dev": true,
+ "license": "MIT"
+ },
"react": {
"name": "@blender-ui/react",
"version": "0.2.1",
@@ -85,6 +293,23 @@
"peerDependencies": {
"react": "^19.3.0"
}
+ },
+ "svelte": {
+ "name": "@blender-ui/svelte",
+ "version": "0.1.0",
+ "license": "GPL-2.0-or-later",
+ "dependencies": {
+ "@blender-ui/native": "^0.2.1"
+ },
+ "devDependencies": {
+ "svelte": "5.57.3"
+ },
+ "engines": {
+ "node": ">=22.15"
+ },
+ "peerDependencies": {
+ "svelte": "^5.57.0"
+ }
}
}
}
diff --git a/bindings/package.json b/bindings/package.json
index 0d1f5ae..6ca12e8 100644
--- a/bindings/package.json
+++ b/bindings/package.json
@@ -1,8 +1,8 @@
{
"name": "blenderui-js",
"private": true,
- "description": "Workspace for the JavaScript packages: @blender-ui/native and @blender-ui/react",
- "workspaces": ["node", "react"],
+ "description": "Workspace for the JavaScript packages: @blender-ui/native, @blender-ui/react and @blender-ui/svelte",
+ "workspaces": ["node", "react", "svelte"],
"scripts": {
"build": "npm run build -w @blender-ui/native",
"test": "npm test --workspaces"
diff --git a/bindings/svelte/Widget.svelte b/bindings/svelte/Widget.svelte
new file mode 100644
index 0000000..3b278a6
--- /dev/null
+++ b/bindings/svelte/Widget.svelte
@@ -0,0 +1,11 @@
+<!--
+ A Blender widget: `tag` is one of @blender-ui/native's capitalized names
+ (`NumberSlider` ...), which `document.createElement` makes a Blender widget.
+ index.js gives each name its own component.
+ SPDX-License-Identifier: GPL-2.0-or-later
+-->
+<script>
+ let { tag, children, ...rest } = $props()
+</script>
+
+<svelte:element this={tag} {...rest}>{@render children?.()}</svelte:element>
diff --git a/bindings/svelte/compile.js b/bindings/svelte/compile.js
new file mode 100644
index 0000000..4491ae1
--- /dev/null
+++ b/bindings/svelte/compile.js
@@ -0,0 +1,80 @@
+// Svelte components for BUI: compiled for the client, with DOM-built
+// templates (`fragments: 'tree'`: createElement and setAttribute, no HTML
+// parser), and Svelte's browser build (the `browser` export condition). One
+// place for both, used by the Node.js hooks and the Bun plugin.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+import { compile, compileModule } from 'svelte/compiler'
+import fs from 'node:fs'
+import path from 'node:path'
+
+/** Components (`.svelte`) and rune modules (`.svelte.js`). */
+export const SVELTE_FILE = /\.svelte(\.js)?$/
+/** Packages whose browser build a BUI app needs (Svelte's runtime, and the
+ * `esm-env` flags it reads). */
+export const BROWSER_PACKAGE = /^(svelte|esm-env)(\/.*)?$/
+
+const CONDITIONS = ['browser', 'import', 'default']
+let warnedCss = false
+
+/** The client JavaScript of a `.svelte` / `.svelte.js` file. */
+export function compileSvelte (source, filename, dev = process.env.NODE_ENV === 'development') {
+ if (!filename.endsWith('.svelte')) return compileModule(source, { filename, generate: 'client', dev }).js.code
+ const r = compile(source, { filename, generate: 'client', fragments: 'tree', css: 'external', dev })
+ if (r.css && !warnedCss) {
+ warnedCss = true
+ console.warn(`@blender-ui/svelte: ${path.basename(filename)}: <style> blocks aren't applied; style with class (Tailwind) and style`)
+ }
+ return r.js.code
+}
+
+/** The file `specifier` (`svelte`, `svelte/store` ...) names in its package's
+ * browser build, resolved from `fromDir`. */
+export function resolveBrowser (specifier, fromDir) {
+ const slash = specifier.indexOf('/')
+ const name = slash < 0 ? specifier : specifier.slice(0, slash)
+ const sub = slash < 0 ? '.' : '.' + specifier.slice(slash)
+ for (let dir = fromDir; ; dir = path.dirname(dir)) {
+ const root = path.join(dir, 'node_modules', name)
+ if (fs.existsSync(path.join(root, 'package.json'))) {
+ const target = pick(JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).exports?.[sub])
+ if (target === null) throw new Error(`@blender-ui/svelte: ${specifier}: no browser export`)
+ return path.join(root, target)
+ }
+ if (path.dirname(dir) === dir) throw new Error(`@blender-ui/svelte: cannot find ${name} from ${fromDir}`)
+ }
+}
+
+/** Files of those packages: Bun's runtime resolves them without plugins. */
+export const BROWSER_PACKAGE_FILE = /[\\/]node_modules[\\/](svelte|esm-env)[\\/]/
+const redirects = new Map() // package root -> Map(default file -> browser file)
+
+/** Module source re-exporting the browser build of `file` when `file` is a
+ * package's non-browser entry (`svelte/src/index-server.js` ...), or null. */
+export function browserRedirect (file) {
+ const m = /^(.*[\\/]node_modules[\\/](?:svelte|esm-env))[\\/]/.exec(file)
+ if (m === null) return null
+ let map = redirects.get(m[1])
+ if (map === undefined) {
+ map = new Map()
+ const exports = JSON.parse(fs.readFileSync(path.join(m[1], 'package.json'), 'utf8')).exports ?? {}
+ for (const entry of Object.values(exports)) {
+ const browser = pick(entry)
+ const fallback = typeof entry === 'object' && entry !== null ? pickFrom(entry, ['default']) : null
+ if (browser && fallback && browser !== fallback) map.set(path.join(m[1], fallback), path.join(m[1], browser))
+ }
+ redirects.set(m[1], map)
+ }
+ const target = map.get(path.normalize(file))
+ if (target === undefined) return null
+ const to = JSON.stringify(target)
+ return `export * from ${to}\n${/\bexport default\b/.test(fs.readFileSync(target, 'utf8')) ? `export { default } from ${to}\n` : ''}`
+}
+
+function pick (entry) { return pickFrom(entry, CONDITIONS) }
+
+function pickFrom (entry, conditions) {
+ if (typeof entry === 'string' || entry == null) return entry ?? null
+ for (const c of conditions) if (c in entry) return pickFrom(entry[c], conditions)
+ return null
+}
diff --git a/bindings/svelte/events.js b/bindings/svelte/events.js
new file mode 100644
index 0000000..d356cc9
--- /dev/null
+++ b/bindings/svelte/events.js
@@ -0,0 +1,48 @@
+// Svelte's event delegation on BUI. Svelte keeps `onclick`-style handlers on
+// the element (`element[symbol].click = fn`) and listens once, on the mount
+// target. BUI sends an event to the deepest element *listening* for it, so an
+// element with a delegated handler must listen natively too: the handlers
+// object below does that when Svelte stores a handler, wherever it stores it
+// from (compiled templates, spreads, <svelte:element>).
+//
+// The one place this package touches Svelte's internals: `delegated` (which
+// compiled components call) tells us Svelte's symbol. test/svelte.test.js
+// fails if a Svelte release changes it.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+import native from '@blender-ui/native'
+import { delegated } from 'svelte/internal/client'
+
+const { Element, EVENT_BITS } = native
+
+const probe = {}
+delegated('click', probe, null)
+/** Svelte's key for an element's delegated handlers. */
+export const HANDLERS = Object.getOwnPropertySymbols(probe)[0]
+if (HANDLERS === undefined) throw new Error('@blender-ui/svelte: this Svelte version stores event handlers differently; update @blender-ui/svelte')
+
+const nativeTarget = () => {} // the listener that makes an element a native target
+
+/** An element's delegated handlers; setting one of BUI's event types listens natively. */
+class Handlers {
+ constructor (el) { Object.defineProperty(this, '_el', { value: el }) }
+}
+for (const type of Object.keys(EVENT_BITS)) {
+ const key = Symbol(type)
+ Object.defineProperty(Handlers.prototype, type, {
+ get () { return this[key] },
+ set (fn) {
+ const had = this[key] != null
+ this[key] = fn
+ if (fn != null && !had) this._el.addEventListener(type, nativeTarget)
+ else if (fn == null && had) this._el.removeEventListener(type, nativeTarget)
+ },
+ enumerable: true,
+ })
+}
+
+Object.defineProperty(Element.prototype, HANDLERS, {
+ get () { return (this._handlers ??= new Handlers(this)) },
+ set () {}, // Svelte's `??= {}`: the getter never returns nothing
+ configurable: true,
+})
diff --git a/bindings/svelte/examples/Counter.svelte b/bindings/svelte/examples/Counter.svelte
new file mode 100644
index 0000000..0f88aeb
--- /dev/null
+++ b/bindings/svelte/examples/Counter.svelte
@@ -0,0 +1,16 @@
+<!-- The counter of @blender-ui/react's examples, in Svelte 5. -->
+<script>
+ import { Button } from '@blender-ui/svelte'
+ let count = $state(0)
+ let name = $state('')
+</script>
+
+<main class="p-6 flex flex-col gap-3">
+ <h1 class="text-xl font-bold">BUI + Svelte</h1>
+ <div class="flex items-center gap-3">
+ <span>Clicks: {count}</span>
+ <Button onclick={() => count++}>Add one</Button>
+ </div>
+ <input placeholder="Your name" bind:value={name} />
+ {#if name}<p class="text-[#9ab8e8]">Hello, {name}!</p>{/if}
+</main>
diff --git a/bindings/svelte/examples/counter.js b/bindings/svelte/examples/counter.js
new file mode 100644
index 0000000..79c7787
--- /dev/null
+++ b/bindings/svelte/examples/counter.js
@@ -0,0 +1,11 @@
+// A Svelte counter in a native BUI window.
+// node --import @blender-ui/svelte/register examples/counter.js
+// bun --preload @blender-ui/svelte/register examples/counter.js
+// npx bui build examples/counter.js (one small executable)
+import { render } from '@blender-ui/svelte'
+import Counter from './Counter.svelte'
+
+const { app, window } = render(Counter, { title: 'BUI + Svelte', width: 420, height: 260 })
+window.body.setAttribute('styled', '')
+window.body.className = 'm-0 bg-[#2b2b2b] text-[#e6e6e6]'
+if (process.env.BUI_EXAMPLE_SECONDS) setTimeout(() => app.quit(), Number(process.env.BUI_EXAMPLE_SECONDS) * 1000)
diff --git a/bindings/svelte/index.d.ts b/bindings/svelte/index.d.ts
new file mode 100644
index 0000000..aa60589
--- /dev/null
+++ b/bindings/svelte/index.d.ts
@@ -0,0 +1,46 @@
+// Types for @blender-ui/svelte.
+import type { Component, Snippet } from 'svelte'
+import type { App, Window } from '@blender-ui/native'
+import type { RenderOptions } from '@blender-ui/native/host'
+
+export interface MountOptions<P> {
+ props?: P
+ /** Context for the component tree (Svelte's `mount` option). */
+ context?: Map<unknown, unknown>
+}
+
+export interface Root {
+ /** Mount `Component` (replacing what this root showed); returns its exports. */
+ render<P extends Record<string, any>> (Component: Component<P>, options?: MountOptions<P>): Record<string, any>
+ unmount (): void
+}
+
+/** A root rendering Svelte components into `window`'s body (unmounted when the window closes). */
+export function createRoot (window: Window): Root
+
+/** Open a window (and an App, unless `app` is given) and mount `Component` in it. */
+export function render<P extends Record<string, any>> (Component: Component<P>, options?: RenderOptions & MountOptions<P>):
+ { app: App, window: Window, root: Root, component: Record<string, any> }
+
+/** Run `fn` and apply Svelte's pending updates now (tests). */
+export function act<R> (fn?: () => R): R
+
+/** Blender's widgets as components: always drawn and handled like Blender.
+ * Their lowercase HTML counterparts look like a browser's form controls
+ * (and like Blender inside an element with the `styled` attribute). */
+type BlenderProps = Record<string, unknown> & { children?: Snippet }
+export const Button: Component<BlenderProps>
+export const Checkbox: Component<BlenderProps>
+export const Radio: Component<BlenderProps>
+export const NumberField: Component<BlenderProps>
+export const NumberSlider: Component<BlenderProps>
+export const TextField: Component<BlenderProps>
+export const TextArea: Component<BlenderProps>
+export const ColorSwatch: Component<BlenderProps>
+export const Dropdown: Component<BlenderProps>
+export const ProgressBar: Component<BlenderProps>
+
+// Signals: each is a Svelte store too (`$count` follows it in a component).
+export { signal, effect, batch, untrack, createSignal, ref, isSignal, startTransition, Signal, Memo } from '@blender-ui/native'
+/** A derived, cached signal (`memo` in @blender-ui/native). */
+export { memo as computed } from '@blender-ui/native'
diff --git a/bindings/svelte/index.js b/bindings/svelte/index.js
new file mode 100644
index 0000000..b0fcd2f
--- /dev/null
+++ b/bindings/svelte/index.js
@@ -0,0 +1,77 @@
+// @blender-ui/svelte: Svelte 5 components in BUI's native windows.
+//
+// import { render } from '@blender-ui/svelte'
+// import App from './App.svelte'
+// render(App, { props: { name: 'BUI' }, title: 'App', width: 400, height: 300 })
+//
+// Svelte has no custom-renderer API: its compiled components call the DOM.
+// @blender-ui/native provides that DOM (`@blender-ui/native/globals`): the
+// nodes Svelte creates join a window's retained tree when inserted, and only
+// the changes of each tick cross to the native UI thread. Runes update the
+// nodes that show them, as in a browser.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+import '@blender-ui/native/globals'
+import './events.js'
+import { mount, unmount, flushSync } from 'svelte'
+import native from '@blender-ui/native'
+import host from '@blender-ui/native/host'
+import Widget from './Widget.svelte'
+
+/** A root rendering Svelte components into `window`'s body (unmounted when
+ * the window closes). */
+export function createRoot (window) {
+ let component = null
+ const root = {
+ /** Mount `Component` (replacing what this root showed); returns its exports. */
+ render (Component, options = {}) {
+ root.unmount()
+ component = mount(Component, { target: window.body, props: options.props, context: options.context })
+ return component
+ },
+ unmount () {
+ if (component === null) return
+ unmount(component)
+ component = null
+ },
+ }
+ window.on('close', () => root.unmount())
+ return root
+}
+
+/** Open a window (and an App, unless `options.app` is given) and mount `Component` in it. */
+export function render (Component, options = {}) {
+ const { app, window } = host.open(options)
+ const root = createRoot(window)
+ const component = root.render(Component, options)
+ return { app, window, root, component }
+}
+
+/** Run `fn` and apply Svelte's pending updates now (tests). */
+export function act (fn) {
+ return flushSync(fn)
+}
+
+// Blender's widgets as components: `<NumberSlider min={0} max={10} />`,
+// `<Button onclick={...}>Apply</Button>`. Always Blender widgets; their
+// lowercase HTML counterparts look like a browser's (Blender's inside `styled`).
+export const { Button, Checkbox, Radio, NumberField, NumberSlider, TextField, TextArea, ColorSwatch, Dropdown,
+ ProgressBar } = host.blenderWidgets((tag) => (anchor, props) => Widget(anchor, withTag(props, tag)))
+
+/** `props` with `tag` added; reads stay live (Svelte's props are getters). */
+function withTag (props, tag) {
+ return new Proxy(props, {
+ get: (t, k) => k === 'tag' ? tag : Reflect.get(t, k),
+ has: (t, k) => k === 'tag' || Reflect.has(t, k),
+ ownKeys: (t) => [...Reflect.ownKeys(t), 'tag'],
+ getOwnPropertyDescriptor: (t, k) => k === 'tag'
+ ? { value: tag, enumerable: true, configurable: true }
+ : Reflect.getOwnPropertyDescriptor(t, k),
+ })
+}
+
+// Signals: BUI's own, for state shared outside components. Each is a Svelte
+// store too (`$count` in a component follows it).
+export const { signal, effect, batch, untrack, createSignal, ref, isSignal, startTransition, Signal, Memo } = native
+/** A derived, cached signal (`memo` in @blender-ui/native). */
+export const computed = native.memo
diff --git a/bindings/svelte/package.json b/bindings/svelte/package.json
new file mode 100644
index 0000000..746e1bc
--- /dev/null
+++ b/bindings/svelte/package.json
@@ -0,0 +1,72 @@
+{
+ "name": "@blender-ui/svelte",
+ "version": "0.1.0",
+ "description": "Svelte 5 for BUI: Blender's UI in native windows from Svelte components, runes and snippets. Node.js and Bun.",
+ "type": "module",
+ "main": "index.js",
+ "types": "index.d.ts",
+ "svelte": "index.js",
+ "exports": {
+ ".": {
+ "types": "./index.d.ts",
+ "default": "./index.js"
+ },
+ "./register": "./register.js",
+ "./plugin": "./plugin.js",
+ "./compile": "./compile.js",
+ "./package.json": "./package.json"
+ },
+ "bui": {
+ "bunPlugin": "./plugin.js"
+ },
+ "files": [
+ "index.js",
+ "index.d.ts",
+ "events.js",
+ "Widget.svelte",
+ "compile.js",
+ "plugin.js",
+ "register.js",
+ "README.md",
+ "LICENSE"
+ ],
+ "scripts": {
+ "test": "node --import ./register.js --test test/*.test.js",
+ "prepublishOnly": "node --import ./register.js --test test/*.test.js",
+ "prepack": "node -e \"require('fs').copyFileSync('../../LICENSE', 'LICENSE')\"",
+ "postpack": "node -e \"require('fs').rmSync('LICENSE', { force: true })\""
+ },
+ "engines": {
+ "node": ">=22.15"
+ },
+ "dependencies": {
+ "@blender-ui/native": "^0.2.1"
+ },
+ "peerDependencies": {
+ "svelte": "^5.57.0"
+ },
+ "devDependencies": {
+ "svelte": "5.57.3"
+ },
+ "license": "GPL-2.0-or-later",
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/ppmpreetham/BUI.git",
+ "directory": "bindings/svelte"
+ },
+ "homepage": "https://bui.preetham.top",
+ "bugs": {
+ "url": "https://github.com/ppmpreetham/BUI/issues"
+ },
+ "keywords": [
+ "svelte",
+ "svelte5",
+ "runes",
+ "blender",
+ "ui",
+ "desktop",
+ "native",
+ "tailwind",
+ "bun"
+ ]
+}
diff --git a/bindings/svelte/plugin.js b/bindings/svelte/plugin.js
new file mode 100644
index 0000000..c6071cd
--- /dev/null
+++ b/bindings/svelte/plugin.js
@@ -0,0 +1,23 @@
+// The Bun plugin: `.svelte` files and Svelte's browser build. Bun's runtime
+// loads it through `register.js`; `bui build` finds it through this
+// package's `"bui": { "bunPlugin" }` field and bundles with it.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+import fs from 'node:fs'
+import path from 'node:path'
+import { SVELTE_FILE, BROWSER_PACKAGE, BROWSER_PACKAGE_FILE, compileSvelte, resolveBrowser, browserRedirect } from './compile.js'
+
+export default {
+ name: '@blender-ui/svelte',
+ setup (build) {
+ build.onResolve({ filter: BROWSER_PACKAGE }, (args) =>
+ ({ path: resolveBrowser(args.path, args.importer ? path.dirname(args.importer) : process.cwd()) }))
+ // Bun's runtime resolves bare imports without plugins: its server build
+ // of Svelte loads the browser one instead
+ build.onLoad({ filter: BROWSER_PACKAGE_FILE }, (args) => {
+ return { contents: browserRedirect(args.path) ?? fs.readFileSync(args.path, 'utf8'), loader: 'js' }
+ })
+ build.onLoad({ filter: SVELTE_FILE }, (args) =>
+ ({ contents: compileSvelte(fs.readFileSync(args.path, 'utf8'), args.path), loader: 'js' }))
+ },
+}
diff --git a/bindings/svelte/register.js b/bindings/svelte/register.js
new file mode 100644
index 0000000..9916118
--- /dev/null
+++ b/bindings/svelte/register.js
@@ -0,0 +1,29 @@
+// `import '@blender-ui/svelte/register'` (or `node --import` / `bun --preload`
+// it): `.svelte` files import as components, and `svelte` resolves to its
+// browser build. Node.js through module hooks, Bun through its plugin.
+//
+// SPDX-License-Identifier: GPL-2.0-or-later
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { SVELTE_FILE, BROWSER_PACKAGE, compileSvelte, resolveBrowser } from './compile.js'
+import plugin from './plugin.js'
+
+if (typeof Bun !== 'undefined') {
+ Bun.plugin(plugin)
+} else {
+ const { registerHooks } = await import('node:module')
+ if (typeof registerHooks !== 'function') throw new Error('@blender-ui/svelte: needs Node.js 22.15 or newer (module.registerHooks), or Bun')
+ registerHooks({
+ resolve (specifier, context, next) {
+ if (!BROWSER_PACKAGE.test(specifier)) return next(specifier, context)
+ const from = context.parentURL?.startsWith('file:') ? path.dirname(fileURLToPath(context.parentURL)) : process.cwd()
+ return { url: pathToFileURL(resolveBrowser(specifier, from)).href, format: 'module', shortCircuit: true }
+ },
+ load (url, context, next) {
+ if (!url.startsWith('file:') || !SVELTE_FILE.test(url)) return next(url, context)
+ const file = fileURLToPath(url)
+ return { format: 'module', source: compileSvelte(fs.readFileSync(file, 'utf8'), file), shortCircuit: true }
+ },
+ })
+}
diff --git a/bindings/svelte/test/fixtures/Card.svelte b/bindings/svelte/test/fixtures/Card.svelte
new file mode 100644
index 0000000..ed09c16
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Card.svelte
@@ -0,0 +1,7 @@
+<script>
+ import { getContext } from 'svelte'
+ let { title, children } = $props()
+ const theme = getContext('theme')
+</script>
+
+<section id="card" data-theme={theme}>{@render title()}<div id="card-body">{@render children()}</div></section>
diff --git a/bindings/svelte/test/fixtures/Counter.svelte b/bindings/svelte/test/fixtures/Counter.svelte
new file mode 100644
index 0000000..d87bef3
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Counter.svelte
@@ -0,0 +1,11 @@
+<script>
+ let { onrender = () => {} } = $props()
+ let n = $state(0)
+ onrender()
+</script>
+
+<div class="flex flex-col gap-2" style="margin: 0">
+ <div id="btn" style:width="80px" style:height="30px" style:background-color={n ? '#00ff00' : '#0000ff'}
+ onclick={() => n++}>count {n}</div>
+ {#if n > 0}<div class="w-[50px] h-[10px] bg-[#ff0000]"></div>{/if}
+</div>
diff --git a/bindings/svelte/test/fixtures/Form.svelte b/bindings/svelte/test/fixtures/Form.svelte
new file mode 100644
index 0000000..eb65a01
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Form.svelte
@@ -0,0 +1,23 @@
+<!-- Bindings, Blender's widgets, snippets, context and lifecycle. -->
+<script>
+ import { setContext, onMount, onDestroy } from 'svelte'
+ import { Button, NumberSlider } from '../../index.js'
+ import Card from './Card.svelte'
+ let { log } = $props()
+ let name = $state('')
+ let agreed = $state(false)
+ let clicks = $state(0)
+ setContext('theme', 'blender')
+ onMount(() => log.push('mount'))
+ onDestroy(() => log.push('destroy'))
+</script>
+
+<input id="name" bind:value={name} />
+<input id="agree" type="checkbox" bind:checked={agreed} />
+<p id="hello">{name ? `Hello, ${name}!` : ''}{agreed ? ' (agreed)' : ''}</p>
+<Button id="apply" onclick={() => clicks++}>Apply {clicks}</Button>
+<NumberSlider id="size" min={0} max={10} value={2.5} />
+<Card>
+ {#snippet title()}<b>Title</b>{/snippet}
+ body text
+</Card>
diff --git a/bindings/svelte/test/fixtures/Modes.svelte b/bindings/svelte/test/fixtures/Modes.svelte
new file mode 100644
index 0000000..fa2ea9d
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Modes.svelte
@@ -0,0 +1,10 @@
+<!-- Text and elements taking turns, a keyed list, and an input whose type changes. -->
+<script>
+ let { expose } = $props()
+ let mode = $state('text')
+ let items = $state([1, 2, 3])
+ expose({ mode: (m) => { mode = m }, items: (list) => { items = list } })
+</script>
+
+<div id="box">{#if mode === 'text'}hello{:else if mode === 'el'}<span>inner</span>{/if}<input id="in" type={mode === 'el' ? 'checkbox' : 'text'} onchange={() => {}} /></div>
+<ul id="list">{#each items as item (item)}<li>{item}</li>{/each}</ul>
diff --git a/bindings/svelte/test/fixtures/Panel.svelte b/bindings/svelte/test/fixtures/Panel.svelte
new file mode 100644
index 0000000..41d803e
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Panel.svelte
@@ -0,0 +1,14 @@
+<!-- BUI signals in a component: each is a Svelte store (`$n`). -->
+<script>
+ import { signal, computed } from '../../index.js'
+ let { external, expose, onrender } = $props()
+ const n = signal(0)
+ const color = computed(() => (n.value % 2 ? '#00ff00' : '#0000ff'))
+ expose(n)
+ onrender()
+</script>
+
+<div style="margin: 0">
+ <div id="box" style="width: 80px; height: 30px; background-color: {$color}" onclick={() => n.update((v) => v + 1)}>count {$n}</div>
+ <span id="ext">ext {$external}</span>
+</div>
diff --git a/bindings/svelte/test/fixtures/RuntimeApp.svelte b/bindings/svelte/test/fixtures/RuntimeApp.svelte
new file mode 100644
index 0000000..b0c9d47
--- /dev/null
+++ b/bindings/svelte/test/fixtures/RuntimeApp.svelte
@@ -0,0 +1,12 @@
+<script>
+ let { onrender } = $props()
+ let count = $state(0)
+ let color = $state('#0000ff')
+ onrender()
+</script>
+
+<main style="margin: 0">
+ <div id="btn" style="width: 80px; height: 30px; background-color: {color}"
+ onclick={() => { count++; color = '#00ff00' }}>count {count}</div>
+ {#if count > 1}<p id="many">many</p>{/if}
+</main>
diff --git a/bindings/svelte/test/fixtures/Show.svelte b/bindings/svelte/test/fixtures/Show.svelte
new file mode 100644
index 0000000..b57e99d
--- /dev/null
+++ b/bindings/svelte/test/fixtures/Show.svelte
@@ -0,0 +1,12 @@
+<!-- A subtree hidden and kept, and a transition (it commits without animating). -->
+<script>
+ import { fade } from 'svelte/transition'
+ let { expose } = $props()
+ let show = $state(true)
+ expose((v) => { show = v })
+</script>
+
+<div>
+ <span id="kid" hidden={!show}>kept</span>
+ {#if show}<b id="vt" transition:fade>shown</b>{/if}
+</div>
diff --git a/bindings/svelte/test/fixtures/app.js b/bindings/svelte/test/fixtures/app.js
new file mode 100644
index 0000000..d849d95
--- /dev/null
+++ b/bindings/svelte/test/fixtures/app.js
@@ -0,0 +1,33 @@
+// A headless Svelte app that checks itself, as bindings/node/test/fixtures/
+// react-app.jsx does for React: rendering, a click, a conditional block and a
+// screenshot. Prints one JSON line.
+import { render } from '@blender-ui/svelte'
+import App from './RuntimeApp.svelte'
+
+let renders = 0
+const { app, window } = render(App, { props: { onrender: () => renders++ }, width: 200, height: 120, headless: true })
+window.body.style = 'margin: 0; background: #000'
+const tick = (ms = 40) => new Promise(r => setTimeout(r, ms))
+const find = (id) => [...window._nodes.values()].find(n => n.getAttribute?.('id') === id)
+// sampled inside the button but right of the "count N" label, so text never covers it
+const pixel = (s, x, y) => { const i = (y * s.width + x) * 4; return [s.data[i], s.data[i + 1], s.data[i + 2]] }
+
+;(async () => {
+ await tick()
+ const before = await window.screenshot()
+ window.click(10, 10)
+ await tick()
+ const once = find('btn').textContent
+ window.click(10, 10)
+ await tick()
+ const after = await window.screenshot()
+ console.log(JSON.stringify({
+ runtime: globalThis.__BUI_NATIVE__ ? 'quickjs' : (typeof Bun !== 'undefined' ? 'bun' : 'node'),
+ before: pixel(before, 70, 25),
+ after: pixel(after, 70, 25),
+ once,
+ many: Boolean(find('many')),
+ renders,
+ }))
+ app.quit()
+})()
diff --git a/bindings/svelte/test/runtime.test.js b/bindings/svelte/test/runtime.test.js
new file mode 100644
index 0000000..438e8b2
--- /dev/null
+++ b/bindings/svelte/test/runtime.test.js
@@ -0,0 +1,63 @@
+// The same Svelte app on every runtime: Node.js and Bun (through register.js),
+// and as `bui build` / `bui run` apps (QuickJS, and a Bun executable), with
+// the Svelte plugin found through this package's `bui.bunPlugin`.
+import test from 'node:test'
+import assert from 'node:assert'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const cli = path.join(here, '..', '..', 'node', 'cli.js')
+const register = path.join(here, '..', 'register.js')
+const app = path.join(here, 'fixtures', 'app.js')
+// Bun's executable (npm installs it behind a shell shim on Windows)
+const bun = spawnSync('bun', ['-e', 'process.stdout.write(process.execPath)'], { encoding: 'utf8', shell: true }).stdout?.trim()
+const hasBun = Boolean(bun)
+const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'bui-svelte-test-'))
+test.after(() => fs.rmSync(dir, { recursive: true, force: true }))
+const env = { ...process.env, BUI_HEADLESS: '1' }
+
+function check (r, runtime) {
+ assert.strictEqual(r.status, 0, r.stderr)
+ const out = JSON.parse(r.stdout.trim().split('\n').pop())
+ assert.strictEqual(out.runtime, runtime)
+ assert.deepStrictEqual(out.before, [0, 0, 255], 'rendered')
+ assert.deepStrictEqual(out.after, [0, 255, 0], 'state updated after the click')
+ assert.strictEqual(out.once, 'count 1', 'the text followed the state')
+ assert.strictEqual(out.many, true, 'a conditional block mounted')
+ assert.strictEqual(out.renders, 1, 'the component ran once')
+}
+
+const run = (file, args = []) => spawnSync(file, args, { encoding: 'utf8', env, timeout: 60000 })
+const exe = process.platform === 'win32' ? '.exe' : ''
+
+test('node --import @blender-ui/svelte/register runs the app', () => {
+ check(run(process.execPath, ['--import', pathToFileURL(register).href, app]), 'node')
+})
+
+test('bun --preload @blender-ui/svelte/register runs it', { skip: !hasBun }, () => {
+ check(run(bun, ['--preload', register, app]), 'bun')
+})
+
+test('bui build: a QuickJS executable of a few MB runs the Svelte app', { skip: !hasBun }, () => {
+ const out = path.join(dir, `svelte-app${exe}`)
+ const b = spawnSync(process.execPath, [cli, 'build', app, '-o', out, '--console'], { encoding: 'utf8' })
+ assert.strictEqual(b.status, 0, b.stderr)
+ const size = fs.statSync(out).size / 1048576
+ assert.ok(size < 8, `small: ${size.toFixed(1)} MB`)
+ check(run(out), 'quickjs')
+})
+
+test('bui run: the same app on the QuickJS runtime, no executable', { skip: !hasBun }, () => {
+ check(spawnSync(process.execPath, [cli, 'run', app], { encoding: 'utf8', env }), 'quickjs')
+})
+
+test('bui build --bun: a Bun executable runs it too', { skip: !hasBun }, () => {
+ const out = path.join(dir, `svelte-app-bun${exe}`)
+ const b = spawnSync(process.execPath, [cli, 'build', app, '-o', out, '--bun', '--console'], { encoding: 'utf8' })
+ assert.strictEqual(b.status, 0, b.stderr)
+ check(run(out), 'bun')
+})
diff --git a/bindings/svelte/test/svelte.test.js b/bindings/svelte/test/svelte.test.js
new file mode 100644
index 0000000..1d31b38
--- /dev/null
+++ b/bindings/svelte/test/svelte.test.js
@@ -0,0 +1,143 @@
+// The scenarios of @blender-ui/react's test/react.test.js, in Svelte 5, and
+// what Svelte adds: bindings, keyed lists, snippets, context, lifecycle.
+import test from 'node:test'
+import assert from 'node:assert'
+import { render, act, signal, Button } from '../index.js'
+import { HANDLERS } from '../events.js'
+import Counter from './fixtures/Counter.svelte'
+import Panel from './fixtures/Panel.svelte'
+import Modes from './fixtures/Modes.svelte'
+import Show from './fixtures/Show.svelte'
+import Form from './fixtures/Form.svelte'
+
+const tick = (ms = 30) => new Promise(r => setTimeout(r, ms))
+const at = (s, x, y) => { const i = (y * s.width + x) * 4; return [...s.data.subarray(i, i + 3)] }
+const finder = (window) => (id) => [...window._nodes.values()].find(n => n.getAttribute?.('id') === id)
+const elements = (el) => el.childNodes.filter(n => n.nodeType === 1)
+
+test('Svelte: render, state, events, conditional children (headless)', async (t) => {
+ let renders = 0
+ const { app, window } = render(Counter, { props: { onrender: () => renders++ }, headless: true, width: 200, height: 120 })
+ t.after(() => app.quit())
+ window.body.style = 'margin: 0; background: #000'
+ await tick()
+ let shot = await window.screenshot()
+ assert.deepStrictEqual(at(shot, 70, 20), [0, 0, 255])
+ const btn = finder(window)('btn')
+ assert.strictEqual(btn.textContent, 'count 0')
+ window.click(10, 10)
+ await tick()
+ assert.strictEqual(btn.textContent, 'count 1', 'state update changed the text')
+ shot = await window.screenshot()
+ assert.deepStrictEqual(at(shot, 70, 20), [0, 255, 0], 'style updated')
+ assert.deepStrictEqual(at(shot, 10, 42), [255, 0, 0], 'conditional child mounted (8px gap below the button)')
+ assert.strictEqual(renders, 1, 'the component ran once: runes updated the nodes')
+})
+
+test('Svelte: BUI signals are stores; writes update their nodes without re-running the component', async (t) => {
+ const external = signal(0)
+ let sig
+ let renders = 0
+ const { app, window } = render(Panel, {
+ props: { external, expose: (n) => { sig = n }, onrender: () => renders++ },
+ headless: true, width: 200, height: 120,
+ })
+ t.after(() => app.quit())
+ window.body.style = 'margin: 0; background: #000'
+ await tick()
+ const find = finder(window)
+ assert.strictEqual(find('box').textContent, 'count 0')
+ assert.deepStrictEqual(at(await window.screenshot(), 70, 20), [0, 0, 255])
+ window.click(10, 10)
+ await tick()
+ assert.strictEqual(find('box').textContent, 'count 1')
+ assert.deepStrictEqual(at(await window.screenshot(), 70, 20), [0, 255, 0])
+ sig.value = 2
+ await tick()
+ assert.strictEqual(find('box').textContent, 'count 2')
+ external.value = 5
+ await tick()
+ assert.strictEqual(find('ext').textContent, 'ext 5')
+ assert.strictEqual(renders, 1, 'Panel ran once: signal writes went straight to the nodes')
+})
+
+test('Svelte: text and elements take turns; keyed lists reorder; dropped nodes are freed', async (t) => {
+ let set
+ const { app, window } = render(Modes, { props: { expose: (s) => { set = s } }, headless: true, width: 100, height: 100 })
+ t.after(() => app.quit())
+ const find = finder(window)
+ await tick()
+ assert.strictEqual(find('box').textContent, 'hello')
+ assert.ok(find('in')._listeners.get('change')?.size, 'onchange listens natively')
+ act(() => set.mode('el'))
+ await tick()
+ assert.strictEqual(elements(find('box'))[0].localName, 'span')
+ assert.strictEqual(find('box').textContent, 'inner')
+ assert.strictEqual(find('in').getAttribute('type'), 'checkbox')
+ act(() => set.mode('none'))
+ await tick()
+ assert.deepStrictEqual(elements(find('box')).map(e => e.localName), ['input'], 'only the input left')
+ const li = () => elements(find('list')).map(e => e.textContent)
+ assert.deepStrictEqual(li(), ['1', '2', '3'])
+ const two = elements(find('list'))[1]
+ act(() => set.items([3, 2, 1]))
+ await tick()
+ assert.deepStrictEqual(li(), ['3', '2', '1'])
+ assert.strictEqual(elements(find('list'))[1], two, 'keyed: the node moved, not re-created')
+ const before = window._nodes.size
+ act(() => { set.mode('el'); set.items([3, 2, 1, 4, 5]) })
+ await tick()
+ assert.ok(window._nodes.size > before)
+ act(() => { set.mode('none'); set.items([3, 2, 1]) })
+ await tick()
+ assert.strictEqual(window._nodes.size, before, 'removed elements and their text are freed')
+})
+
+test('Svelte: hidden keeps a subtree; transitions commit without animating', async (t) => {
+ let setShow
+ const { app, window } = render(Show, { props: { expose: (s) => { setShow = s } }, headless: true, width: 100, height: 100 })
+ t.after(() => app.quit())
+ const find = finder(window)
+ await tick()
+ assert.strictEqual(find('kid').hasAttribute('hidden'), false)
+ assert.ok(find('vt'))
+ setShow(false)
+ await tick(100)
+ assert.strictEqual(find('kid').hasAttribute('hidden'), true, 'hidden, and kept')
+ assert.strictEqual(find('vt'), undefined, 'the outro finished and freed its node')
+ setShow(true)
+ await tick(100)
+ assert.strictEqual(find('kid').hasAttribute('hidden'), false)
+ assert.strictEqual(find('vt').textContent, 'shown')
+})
+
+test('Svelte: bindings, Blender widgets, snippets, context and lifecycle', async (t) => {
+ const log = []
+ const { app, window } = render(Form, { props: { log }, headless: true, width: 300, height: 300 })
+ t.after(() => app.quit())
+ const find = finder(window)
+ await tick()
+ assert.deepStrictEqual(log, ['mount'])
+ find('name')._dispatch({ kind: 'input', value: 'Ada' })
+ find('agree')._dispatch({ kind: 'change', checked: true })
+ await tick()
+ assert.strictEqual(find('hello').textContent, 'Hello, Ada! (agreed)', 'bind:value and bind:checked')
+ const apply = find('apply')
+ assert.strictEqual(apply.localName, 'button')
+ assert.ok(apply.hasAttribute('bui-blender'), 'a Blender widget')
+ assert.ok(apply._listeners.get('click')?.size, 'its onclick listens natively')
+ apply._dispatch({ kind: 'click' })
+ await tick()
+ assert.strictEqual(apply.textContent, 'Apply 1')
+ const size = find('size')
+ assert.deepStrictEqual([size.localName, size.getAttribute('type'), size.getAttribute('max')], ['input', 'range', '10'])
+ assert.strictEqual(find('card').getAttribute('data-theme'), 'blender', 'context')
+ assert.strictEqual(find('card').textContent.trim(), 'Titlebody text', 'snippets')
+ assert.strictEqual(typeof Button, 'function')
+ window.close()
+ assert.deepStrictEqual(log, ['mount', 'destroy'], 'closing the window unmounts')
+})
+
+test('Svelte: the event-delegation symbol is found (fails when a Svelte release changes it)', () => {
+ assert.strictEqual(typeof HANDLERS, 'symbol')
+})