@swifttui/build 0.17.0 → 0.18.0

package/README.md

@@ -6,8 +6,9 @@ compile a SwiftTUI app to `wasm32-wasi` and capture its scene manifest.**
 [![npm](https://img.shields.io/npm/v/@swifttui/build)](https://www.npmjs.com/package/@swifttui/build)
 ![License](https://img.shields.io/badge/license-MIT-3DA639)
 
-`@swifttui/build` produces an `app.wasm`, a `scene-manifest.json`, and the DOM
-host's bundled font assets and license notice. It drives the Swift toolchain, runs a
+`@swifttui/build` produces an `app.wasm` and a `scene-manifest.json`.
+Canvas is the default; `--renderer dom` additionally packages the experimental
+DOM host's font assets and license notice. It drives the Swift toolchain, runs a
 browser `WebAssembly.compile` validation pass, and packages the result. It
 is separate from [`@swifttui/web`](https://www.npmjs.com/package/@swifttui/web),
 the browser runtime. Thus, runtime imports do not include Swift processes, Node
@@ -53,14 +54,60 @@ await buildSwiftTUIWebApp({
 });
 ```
 
-The full build copies the runtime package's four verified WOFF2 faces, their
-manifest and OFL notice into `assets/swifttui-fonts/6ec060766aae/`. Deploy that
+For experimental DOM, pass `--renderer dom` to the command or `renderer: "dom"`
+to `buildSwiftTUIWebApp`. That build copies the runtime package's four verified WOFF2 faces, their
+manifest and OFL notice into `assets/swifttui-fonts/7d231a426067/`. Deploy that
 directory with the app. Build systems that package WASM separately can use
 `await copyDomFontAssets(outputDirectory)` from `@swifttui/build`; it validates
 the installed asset hashes before copying. Runtime `domFont.assetBase` can
 point at another same-origin asset directory. Font loading does not depend on
 an external font service.
 
+### Choose the browser renderer
+
+The WASM/manifest build above is independent of browser JavaScript bundling.
+For the standalone WebHost page, including a custom native app companion,
+install Bun and run:
+
+```sh
+npx swifttui-web build:web --renderer canvas --dist browser
+npx swifttui-web build:web --renderer dom --dist browser-dom
+```
+
+`build:web` needs no `--app`, Swift compiler, or WASM build. It produces
+`index.html` and JavaScript with only the selected painter; the DOM variant also
+includes its fonts and license. Omitting `--renderer` selects Canvas. Rebuilding
+the same output directory replaces the previous presenter and removes DOM fonts
+when selecting Canvas. Serve the entire directory. A native SwiftTUI app can
+set `RuntimeConfiguration.browserAssetsPath` to that directory to use it for
+both its accessibility companion and `--web` mode.
+
+The API equivalent is:
+
+```ts
+import { buildBrowserBundle } from "@swifttui/build";
+await buildBrowserBundle({ outputDirectory: "browser-dom", renderer: "dom" });
+```
+
+For a custom web page with its own bundler, set the bundler's compile-time
+`SWIFTTUI_WEB_RENDERER` define to `JSON.stringify("canvas")` or
+`JSON.stringify("dom")` and enable dead-code elimination. In Vite, for example:
+
+```ts
+export default {
+  define: { SWIFTTUI_WEB_RENDERER: JSON.stringify("dom") },
+};
+```
+
+Use `renderer: "dom"` in `createWebHostApp` (or omit it in a DOM-only build),
+and package fonts with `build --renderer dom` or `copyDomFontAssets`.
+Canvas-only builds need no DOM font copy. An unconfigured library bundle retains
+both renderers for runtime selection and defaults to Canvas; the explicit build
+define is what excludes the unused implementation. A single-renderer build
+rejects requests for the other renderer, including URL or page configuration
+overrides. DOM remains experimental; see the runtime's
+[renderer guide](../web/README.md#renderers).
+
 Toolchain defaults match the repo:
 
 - Swift command: `swiftly run swift` when `swiftly` is on `PATH`, otherwise

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { buildAppWasm } from "./src/build/buildAppWasm.js";
+import { buildBrowserBundle, parseWebRenderer } from "./src/build/buildBrowserBundle.js";
 import { generateSceneManifest } from "./src/build/generateSceneManifest.js";
 import { buildSwiftTUIWebApp } from "./src/build/buildSwiftTUIWebApp.js";
 import { resolve } from "node:path";
@@ -10,9 +11,16 @@ async function runCli(argv) {
 	const flags = parseFlags(argv.slice(1));
 	const packagePath = resolve(flags["package-path"] ?? "../../");
 	const distPath = resolve(flags["dist"] ?? "./dist");
+	const renderer = parseWebRenderer(flags.renderer);
 	const appExecutable = flags.app ?? flags.product ?? flags["app-product"] ?? "";
 	const configuration = parseWasmBuildConfiguration(flags.configuration ?? "release");
 	switch (command) {
+		case "build:web":
+			await buildBrowserBundle({
+				outputDirectory: distPath,
+				renderer
+			});
+			return;
 		case "build:manifest":
 			assertAppExecutable(appExecutable);
 			await generateSceneManifest({
@@ -33,6 +41,7 @@ async function runCli(argv) {
 		case "build":
 			assertAppExecutable(appExecutable);
 			await buildSwiftTUIWebApp({
+				renderer,
 				configuration,
 				packagePath,
 				outputDirectory: distPath,

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { resolve } from \"node:path\";\nimport {\n  buildAppWasm,\n  buildSwiftTUIWebApp,\n  generateSceneManifest,\n  type WasmBuildConfiguration,\n} from \"./index.ts\";\n\nvoid runCli(process.argv.slice(2));\n\nasync function runCli(argv: string[]): Promise<void> {\n  const command = argv[0] ?? \"build\";\n  const flags = parseFlags(argv.slice(1));\n  const packagePath = resolve(flags[\"package-path\"] ?? \"../../\");\n  const distPath = resolve(flags[\"dist\"] ?? \"./dist\");\n  const appExecutable =\n    flags.app ?? flags.product ?? flags[\"app-product\"] ?? \"\";\n  const configuration = parseWasmBuildConfiguration(\n    flags.configuration ?? \"release\",\n  );\n\n  switch (command) {\n    case \"build:manifest\":\n      assertAppExecutable(appExecutable);\n      await generateSceneManifest({\n        packagePath,\n        outputPath: resolve(distPath, \"scene-manifest.json\"),\n        appExecutable,\n      });\n      return;\n    case \"build:wasm\":\n      assertAppExecutable(appExecutable);\n      await buildAppWasm({\n        configuration,\n        packagePath,\n        outputDirectory: distPath,\n        product: appExecutable,\n      });\n      return;\n    case \"build\":\n      assertAppExecutable(appExecutable);\n      await buildSwiftTUIWebApp({\n        configuration,\n        packagePath,\n        outputDirectory: distPath,\n        product: appExecutable,\n      });\n      return;\n    default:\n      throw new Error(`unknown command: ${command}`);\n  }\n}\n\nfunction parseFlags(argv: string[]): Record<string, string> {\n  const flags: Record<string, string> = {};\n  for (let index = 0; index < argv.length; index += 1) {\n    const value = argv[index];\n    if (!value.startsWith(\"--\")) {\n      continue;\n    }\n    const equalsIndex = value.indexOf(\"=\");\n    if (equalsIndex !== -1) {\n      flags[value.slice(2, equalsIndex)] = value.slice(equalsIndex + 1);\n      continue;\n    }\n    const name = value.slice(2);\n    const next = argv[index + 1];\n    if (next && !next.startsWith(\"--\")) {\n      flags[name] = next;\n      index += 1;\n    } else {\n      flags[name] = \"true\";\n    }\n  }\n  return flags;\n}\n\nfunction parseWasmBuildConfiguration(value: string): WasmBuildConfiguration {\n  switch (value) {\n    case \"debug\":\n      return \"debug\";\n    case \"release\":\n      return \"release\";\n    default:\n      throw new Error(`unsupported wasm build configuration: ${value}`);\n  }\n}\n\nfunction assertAppExecutable(value: string): asserts value is string {\n  if (!value) {\n    throw new Error(\"missing --app or --product flag\");\n  }\n}\n"],"mappings":";;;;;;AAUK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAEjC,eAAe,OAAO,MAA+B;CACnD,MAAM,UAAU,KAAK,MAAM;CAC3B,MAAM,QAAQ,WAAW,KAAK,MAAM,CAAC,CAAC;CACtC,MAAM,cAAc,QAAQ,MAAM,mBAAmB,QAAQ;CAC7D,MAAM,WAAW,QAAQ,MAAM,WAAW,QAAQ;CAClD,MAAM,gBACJ,MAAM,OAAO,MAAM,WAAW,MAAM,kBAAkB;CACxD,MAAM,gBAAgB,4BACpB,MAAM,iBAAiB,SACzB;CAEA,QAAQ,SAAR;EACE,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,sBAAsB;IAC1B;IACA,YAAY,QAAQ,UAAU,qBAAqB;IACnD;GACF,CAAC;GACD;EACF,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,aAAa;IACjB;IACA;IACA,iBAAiB;IACjB,SAAS;GACX,CAAC;GACD;EACF,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,oBAAoB;IACxB;IACA;IACA,iBAAiB;IACjB,SAAS;GACX,CAAC;GACD;EACF,SACE,MAAM,IAAI,MAAM,oBAAoB,SAAS;CACjD;AACF;AAEA,SAAS,WAAW,MAAwC;CAC1D,MAAM,QAAgC,CAAC;CACvC,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACnD,MAAM,QAAQ,KAAK;EACnB,IAAI,CAAC,MAAM,WAAW,IAAI,GACxB;EAEF,MAAM,cAAc,MAAM,QAAQ,GAAG;EACrC,IAAI,gBAAgB,IAAI;GACtB,MAAM,MAAM,MAAM,GAAG,WAAW,KAAK,MAAM,MAAM,cAAc,CAAC;GAChE;EACF;EACA,MAAM,OAAO,MAAM,MAAM,CAAC;EAC1B,MAAM,OAAO,KAAK,QAAQ;EAC1B,IAAI,QAAQ,CAAC,KAAK,WAAW,IAAI,GAAG;GAClC,MAAM,QAAQ;GACd,SAAS;EACX,OACE,MAAM,QAAQ;CAElB;CACA,OAAO;AACT;AAEA,SAAS,4BAA4B,OAAuC;CAC1E,QAAQ,OAAR;EACE,KAAK,SACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,yCAAyC,OAAO;CACpE;AACF;AAEA,SAAS,oBAAoB,OAAwC;CACnE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,iCAAiC;AAErD"}
+{"version":3,"file":"cli.js","names":[],"sources":["../cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { resolve } from \"node:path\";\nimport {\n  buildAppWasm,\n  buildBrowserBundle,\n  buildSwiftTUIWebApp,\n  generateSceneManifest,\n  parseWebRenderer,\n  type WasmBuildConfiguration,\n} from \"./index.ts\";\n\nvoid runCli(process.argv.slice(2));\n\nasync function runCli(argv: string[]): Promise<void> {\n  const command = argv[0] ?? \"build\";\n  const flags = parseFlags(argv.slice(1));\n  const packagePath = resolve(flags[\"package-path\"] ?? \"../../\");\n  const distPath = resolve(flags[\"dist\"] ?? \"./dist\");\n  const renderer = parseWebRenderer(flags.renderer);\n  const appExecutable =\n    flags.app ?? flags.product ?? flags[\"app-product\"] ?? \"\";\n  const configuration = parseWasmBuildConfiguration(\n    flags.configuration ?? \"release\",\n  );\n\n  switch (command) {\n    case \"build:web\":\n      await buildBrowserBundle({ outputDirectory: distPath, renderer });\n      return;\n    case \"build:manifest\":\n      assertAppExecutable(appExecutable);\n      await generateSceneManifest({\n        packagePath,\n        outputPath: resolve(distPath, \"scene-manifest.json\"),\n        appExecutable,\n      });\n      return;\n    case \"build:wasm\":\n      assertAppExecutable(appExecutable);\n      await buildAppWasm({\n        configuration,\n        packagePath,\n        outputDirectory: distPath,\n        product: appExecutable,\n      });\n      return;\n    case \"build\":\n      assertAppExecutable(appExecutable);\n      await buildSwiftTUIWebApp({\n        renderer,\n        configuration,\n        packagePath,\n        outputDirectory: distPath,\n        product: appExecutable,\n      });\n      return;\n    default:\n      throw new Error(`unknown command: ${command}`);\n  }\n}\n\nfunction parseFlags(argv: string[]): Record<string, string> {\n  const flags: Record<string, string> = {};\n  for (let index = 0; index < argv.length; index += 1) {\n    const value = argv[index];\n    if (!value.startsWith(\"--\")) {\n      continue;\n    }\n    const equalsIndex = value.indexOf(\"=\");\n    if (equalsIndex !== -1) {\n      flags[value.slice(2, equalsIndex)] = value.slice(equalsIndex + 1);\n      continue;\n    }\n    const name = value.slice(2);\n    const next = argv[index + 1];\n    if (next && !next.startsWith(\"--\")) {\n      flags[name] = next;\n      index += 1;\n    } else {\n      flags[name] = \"true\";\n    }\n  }\n  return flags;\n}\n\nfunction parseWasmBuildConfiguration(value: string): WasmBuildConfiguration {\n  switch (value) {\n    case \"debug\":\n      return \"debug\";\n    case \"release\":\n      return \"release\";\n    default:\n      throw new Error(`unsupported wasm build configuration: ${value}`);\n  }\n}\n\nfunction assertAppExecutable(value: string): asserts value is string {\n  if (!value) {\n    throw new Error(\"missing --app or --product flag\");\n  }\n}\n"],"mappings":";;;;;;;AAYK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAEjC,eAAe,OAAO,MAA+B;CACnD,MAAM,UAAU,KAAK,MAAM;CAC3B,MAAM,QAAQ,WAAW,KAAK,MAAM,CAAC,CAAC;CACtC,MAAM,cAAc,QAAQ,MAAM,mBAAmB,QAAQ;CAC7D,MAAM,WAAW,QAAQ,MAAM,WAAW,QAAQ;CAClD,MAAM,WAAW,iBAAiB,MAAM,QAAQ;CAChD,MAAM,gBACJ,MAAM,OAAO,MAAM,WAAW,MAAM,kBAAkB;CACxD,MAAM,gBAAgB,4BACpB,MAAM,iBAAiB,SACzB;CAEA,QAAQ,SAAR;EACE,KAAK;GACH,MAAM,mBAAmB;IAAE,iBAAiB;IAAU;GAAS,CAAC;GAChE;EACF,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,sBAAsB;IAC1B;IACA,YAAY,QAAQ,UAAU,qBAAqB;IACnD;GACF,CAAC;GACD;EACF,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,aAAa;IACjB;IACA;IACA,iBAAiB;IACjB,SAAS;GACX,CAAC;GACD;EACF,KAAK;GACH,oBAAoB,aAAa;GACjC,MAAM,oBAAoB;IACxB;IACA;IACA;IACA,iBAAiB;IACjB,SAAS;GACX,CAAC;GACD;EACF,SACE,MAAM,IAAI,MAAM,oBAAoB,SAAS;CACjD;AACF;AAEA,SAAS,WAAW,MAAwC;CAC1D,MAAM,QAAgC,CAAC;CACvC,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACnD,MAAM,QAAQ,KAAK;EACnB,IAAI,CAAC,MAAM,WAAW,IAAI,GACxB;EAEF,MAAM,cAAc,MAAM,QAAQ,GAAG;EACrC,IAAI,gBAAgB,IAAI;GACtB,MAAM,MAAM,MAAM,GAAG,WAAW,KAAK,MAAM,MAAM,cAAc,CAAC;GAChE;EACF;EACA,MAAM,OAAO,MAAM,MAAM,CAAC;EAC1B,MAAM,OAAO,KAAK,QAAQ;EAC1B,IAAI,QAAQ,CAAC,KAAK,WAAW,IAAI,GAAG;GAClC,MAAM,QAAQ;GACd,SAAS;EACX,OACE,MAAM,QAAQ;CAElB;CACA,OAAO;AACT;AAEA,SAAS,4BAA4B,OAAuC;CAC1E,QAAQ,OAAR;EACE,KAAK,SACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,SACE,MAAM,IAAI,MAAM,yCAAyC,OAAO;CACpE;AACF;AAEA,SAAS,oBAAoB,OAAwC;CACnE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,iCAAiC;AAErD"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { ResolveSwiftArtifactsOptions, SwiftArtifactPaths, WasmBuildConfiguration, defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, hasRequiredWasmFlags, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines } from "./src/build/resolveSwiftArtifacts.js";
 import { BuildAppWasmOptions, buildAppWasm, packageBrowserValidatedWasm } from "./src/build/buildAppWasm.js";
+import { BuildBrowserBundleOptions, WebRenderer, buildBrowserBundle, parseWebRenderer } from "./src/build/buildBrowserBundle.js";
 import { BuildSwiftTUIWebAppOptions, buildSwiftTUIWebApp } from "./src/build/buildSwiftTUIWebApp.js";
 import { copyDomFontAssets } from "./src/build/copyDomFontAssets.js";
 import { GenerateSceneManifestOptions, generateSceneManifest } from "./src/build/generateSceneManifest.js";
-export { BuildAppWasmOptions, BuildSwiftTUIWebAppOptions, GenerateSceneManifestOptions, ResolveSwiftArtifactsOptions, SwiftArtifactPaths, WasmBuildConfiguration, buildAppWasm, buildSwiftTUIWebApp, copyDomFontAssets, defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, generateSceneManifest, hasRequiredWasmFlags, packageBrowserValidatedWasm, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines };
+export { BuildAppWasmOptions, BuildBrowserBundleOptions, BuildSwiftTUIWebAppOptions, GenerateSceneManifestOptions, ResolveSwiftArtifactsOptions, SwiftArtifactPaths, WasmBuildConfiguration, WebRenderer, buildAppWasm, buildBrowserBundle, buildSwiftTUIWebApp, copyDomFontAssets, defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, generateSceneManifest, hasRequiredWasmFlags, packageBrowserValidatedWasm, parseWebRenderer, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines };

package/dist/index.js

@@ -1,6 +1,7 @@
 import { defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, hasRequiredWasmFlags, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines } from "./src/build/resolveSwiftArtifacts.js";
 import { buildAppWasm, packageBrowserValidatedWasm } from "./src/build/buildAppWasm.js";
 import { copyDomFontAssets } from "./src/build/copyDomFontAssets.js";
+import { buildBrowserBundle, parseWebRenderer } from "./src/build/buildBrowserBundle.js";
 import { generateSceneManifest } from "./src/build/generateSceneManifest.js";
 import { buildSwiftTUIWebApp } from "./src/build/buildSwiftTUIWebApp.js";
-export { buildAppWasm, buildSwiftTUIWebApp, copyDomFontAssets, defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, generateSceneManifest, hasRequiredWasmFlags, packageBrowserValidatedWasm, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines };
+export { buildAppWasm, buildBrowserBundle, buildSwiftTUIWebApp, copyDomFontAssets, defaultInitialMemory, defaultMaxMemory, defaultStackSize, defaultWasmSwiftSDK, formatCommandForLogs, generateSceneManifest, hasRequiredWasmFlags, packageBrowserValidatedWasm, parseWebRenderer, requiredWasmSwiftFlags, resolveSwiftArtifacts, wasmBuildConfigurationLogLines };

package/dist/src/build/buildBrowserBundle.d.ts

@@ -0,0 +1,13 @@
+//#region src/build/buildBrowserBundle.d.ts
+type WebRenderer = "canvas" | "dom";
+declare function parseWebRenderer(value?: string): WebRenderer;
+interface BuildBrowserBundleOptions {
+  outputDirectory: string;
+  /** Canvas-only by default. DOM is experimental and explicitly packaged. */
+  renderer?: WebRenderer;
+}
+/** Bundles a browser page with only the chosen painter. Requires Bun on PATH. */
+declare function buildBrowserBundle(options: BuildBrowserBundleOptions): Promise<void>;
+//#endregion
+export { BuildBrowserBundleOptions, WebRenderer, buildBrowserBundle, parseWebRenderer };
+//# sourceMappingURL=buildBrowserBundle.d.ts.map

package/dist/src/build/buildBrowserBundle.js

@@ -0,0 +1,39 @@
+import { runCommand } from "./runCommand.js";
+import { copyDomFontAssets } from "./copyDomFontAssets.js";
+import { mkdir, readdir, rm } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/build/buildBrowserBundle.ts
+function parseWebRenderer(value = "canvas") {
+	if (value === "canvas" || value === "dom") return value;
+	throw new Error(`unsupported web renderer: ${value}; expected canvas or dom`);
+}
+/** Bundles a browser page with only the chosen painter. Requires Bun on PATH. */
+async function buildBrowserBundle(options) {
+	const renderer = parseWebRenderer(options.renderer);
+	const outputDirectory = resolve(options.outputDirectory);
+	const entrypoint = fileURLToPath(import.meta.resolve("@swifttui/web/browser.html"));
+	await mkdir(outputDirectory, { recursive: true });
+	for (const name of await readdir(outputDirectory)) if (/^(?:index|browser)(?:[-.].*)?\.(?:js|css|html)$/.test(name)) await rm(join(outputDirectory, name));
+	await rm(join(outputDirectory, "assets/swifttui-fonts"), {
+		recursive: true,
+		force: true
+	});
+	await runCommand([
+		"bun",
+		"build",
+		entrypoint,
+		"--outdir",
+		outputDirectory,
+		"--entry-naming",
+		"index.[ext]",
+		"--minify-syntax",
+		"--define",
+		`SWIFTTUI_WEB_RENDERER=${JSON.stringify(renderer)}`
+	]);
+	if (renderer === "dom") await copyDomFontAssets(outputDirectory);
+}
+//#endregion
+export { buildBrowserBundle, parseWebRenderer };
+
+//# sourceMappingURL=buildBrowserBundle.js.map

package/dist/src/build/buildBrowserBundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildBrowserBundle.js","names":[],"sources":["../../../src/build/buildBrowserBundle.ts"],"sourcesContent":["import { mkdir, readdir, rm } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { copyDomFontAssets } from \"./copyDomFontAssets.ts\";\nimport { runCommand } from \"./runCommand.ts\";\n\nexport type WebRenderer = \"canvas\" | \"dom\";\n\nexport function parseWebRenderer(value: string = \"canvas\"): WebRenderer {\n  if (value === \"canvas\" || value === \"dom\") return value;\n  throw new Error(`unsupported web renderer: ${value}; expected canvas or dom`);\n}\n\nexport interface BuildBrowserBundleOptions {\n  outputDirectory: string;\n  /** Canvas-only by default. DOM is experimental and explicitly packaged. */\n  renderer?: WebRenderer;\n}\n\n/** Bundles a browser page with only the chosen painter. Requires Bun on PATH. */\nexport async function buildBrowserBundle(\n  options: BuildBrowserBundleOptions,\n): Promise<void> {\n  const renderer = parseWebRenderer(options.renderer);\n  const outputDirectory = resolve(options.outputDirectory);\n  const entrypoint = fileURLToPath(\n    import.meta.resolve(\"@swifttui/web/browser.html\"),\n  );\n  await mkdir(outputDirectory, { recursive: true });\n  // Remove previous generated presenters/fonts when switching renderers. Keep\n  // the separately packaged scene manifest and WASM artifacts in this directory.\n  for (const name of await readdir(outputDirectory)) {\n    if (/^(?:index|browser)(?:[-.].*)?\\.(?:js|css|html)$/.test(name)) {\n      await rm(join(outputDirectory, name));\n    }\n  }\n  await rm(join(outputDirectory, \"assets/swifttui-fonts\"), {\n    recursive: true,\n    force: true,\n  });\n  await runCommand([\n    \"bun\",\n    \"build\",\n    entrypoint,\n    \"--outdir\",\n    outputDirectory,\n    \"--entry-naming\",\n    \"index.[ext]\",\n    \"--minify-syntax\",\n    \"--define\",\n    `SWIFTTUI_WEB_RENDERER=${JSON.stringify(renderer)}`,\n  ]);\n  if (renderer === \"dom\") await copyDomFontAssets(outputDirectory);\n}\n"],"mappings":";;;;;;AAQA,SAAgB,iBAAiB,QAAgB,UAAuB;CACtE,IAAI,UAAU,YAAY,UAAU,OAAO,OAAO;CAClD,MAAM,IAAI,MAAM,6BAA6B,MAAM,yBAAyB;AAC9E;;AASA,eAAsB,mBACpB,SACe;CACf,MAAM,WAAW,iBAAiB,QAAQ,QAAQ;CAClD,MAAM,kBAAkB,QAAQ,QAAQ,eAAe;CACvD,MAAM,aAAa,cACjB,OAAO,KAAK,QAAQ,4BAA4B,CAClD;CACA,MAAM,MAAM,iBAAiB,EAAE,WAAW,KAAK,CAAC;CAGhD,KAAK,MAAM,QAAQ,MAAM,QAAQ,eAAe,GAC9C,IAAI,kDAAkD,KAAK,IAAI,GAC7D,MAAM,GAAG,KAAK,iBAAiB,IAAI,CAAC;CAGxC,MAAM,GAAG,KAAK,iBAAiB,uBAAuB,GAAG;EACvD,WAAW;EACX,OAAO;CACT,CAAC;CACD,MAAM,WAAW;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,yBAAyB,KAAK,UAAU,QAAQ;CAClD,CAAC;CACD,IAAI,aAAa,OAAO,MAAM,kBAAkB,eAAe;AACjE"}

package/dist/src/build/buildSwiftTUIWebApp.d.ts

@@ -1,7 +1,10 @@
 import { BuildAppWasmOptions } from "./buildAppWasm.js";
+import { WebRenderer } from "./buildBrowserBundle.js";
 //#region src/build/buildSwiftTUIWebApp.d.ts
 interface BuildSwiftTUIWebAppOptions extends BuildAppWasmOptions {
   appExecutable?: string;
+  /** Include the experimental DOM font assets only when explicitly selected. */
+  renderer?: WebRenderer;
 }
 declare function buildSwiftTUIWebApp(options: BuildSwiftTUIWebAppOptions): Promise<void>;
 //#endregion

package/dist/src/build/buildSwiftTUIWebApp.js

@@ -1,10 +1,12 @@
 import { buildAppWasm } from "./buildAppWasm.js";
 import { copyDomFontAssets } from "./copyDomFontAssets.js";
+import { parseWebRenderer } from "./buildBrowserBundle.js";
 import { generateSceneManifest } from "./generateSceneManifest.js";
 import { mkdir, rm } from "node:fs/promises";
 import { join } from "node:path";
 //#region src/build/buildSwiftTUIWebApp.ts
 async function buildSwiftTUIWebApp(options) {
+	const renderer = parseWebRenderer(options.renderer);
 	await rm(options.outputDirectory, {
 		recursive: true,
 		force: true
@@ -17,7 +19,7 @@ async function buildSwiftTUIWebApp(options) {
 		swiftCommand: options.swiftCommand
 	});
 	await buildAppWasm(options);
-	await copyDomFontAssets(options.outputDirectory);
+	if (renderer === "dom") await copyDomFontAssets(options.outputDirectory);
 }
 //#endregion
 export { buildSwiftTUIWebApp };

package/dist/src/build/buildSwiftTUIWebApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildSwiftTUIWebApp.js","names":[],"sources":["../../../src/build/buildSwiftTUIWebApp.ts"],"sourcesContent":["import { mkdir, rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { type BuildAppWasmOptions, buildAppWasm } from \"./buildAppWasm.ts\";\nimport { copyDomFontAssets } from \"./copyDomFontAssets.ts\";\nimport { generateSceneManifest } from \"./generateSceneManifest.ts\";\n\nexport interface BuildSwiftTUIWebAppOptions extends BuildAppWasmOptions {\n  appExecutable?: string;\n}\n\nexport async function buildSwiftTUIWebApp(\n  options: BuildSwiftTUIWebAppOptions,\n): Promise<void> {\n  await rm(options.outputDirectory, { recursive: true, force: true });\n  await mkdir(options.outputDirectory, { recursive: true });\n  await generateSceneManifest({\n    packagePath: options.packagePath,\n    outputPath: join(options.outputDirectory, \"scene-manifest.json\"),\n    appExecutable: options.appExecutable ?? options.product,\n    swiftCommand: options.swiftCommand,\n  });\n  await buildAppWasm(options);\n  await copyDomFontAssets(options.outputDirectory);\n}\n"],"mappings":";;;;;;AAUA,eAAsB,oBACpB,SACe;CACf,MAAM,GAAG,QAAQ,iBAAiB;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CAClE,MAAM,MAAM,QAAQ,iBAAiB,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,sBAAsB;EAC1B,aAAa,QAAQ;EACrB,YAAY,KAAK,QAAQ,iBAAiB,qBAAqB;EAC/D,eAAe,QAAQ,iBAAiB,QAAQ;EAChD,cAAc,QAAQ;CACxB,CAAC;CACD,MAAM,aAAa,OAAO;CAC1B,MAAM,kBAAkB,QAAQ,eAAe;AACjD"}
+{"version":3,"file":"buildSwiftTUIWebApp.js","names":[],"sources":["../../../src/build/buildSwiftTUIWebApp.ts"],"sourcesContent":["import { mkdir, rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { type BuildAppWasmOptions, buildAppWasm } from \"./buildAppWasm.ts\";\nimport { parseWebRenderer, type WebRenderer } from \"./buildBrowserBundle.ts\";\nimport { copyDomFontAssets } from \"./copyDomFontAssets.ts\";\nimport { generateSceneManifest } from \"./generateSceneManifest.ts\";\n\nexport interface BuildSwiftTUIWebAppOptions extends BuildAppWasmOptions {\n  appExecutable?: string;\n  /** Include the experimental DOM font assets only when explicitly selected. */\n  renderer?: WebRenderer;\n}\n\nexport async function buildSwiftTUIWebApp(\n  options: BuildSwiftTUIWebAppOptions,\n): Promise<void> {\n  const renderer = parseWebRenderer(options.renderer);\n  await rm(options.outputDirectory, { recursive: true, force: true });\n  await mkdir(options.outputDirectory, { recursive: true });\n  await generateSceneManifest({\n    packagePath: options.packagePath,\n    outputPath: join(options.outputDirectory, \"scene-manifest.json\"),\n    appExecutable: options.appExecutable ?? options.product,\n    swiftCommand: options.swiftCommand,\n  });\n  await buildAppWasm(options);\n  if (renderer === \"dom\") await copyDomFontAssets(options.outputDirectory);\n}\n"],"mappings":";;;;;;;AAaA,eAAsB,oBACpB,SACe;CACf,MAAM,WAAW,iBAAiB,QAAQ,QAAQ;CAClD,MAAM,GAAG,QAAQ,iBAAiB;EAAE,WAAW;EAAM,OAAO;CAAK,CAAC;CAClE,MAAM,MAAM,QAAQ,iBAAiB,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,sBAAsB;EAC1B,aAAa,QAAQ;EACrB,YAAY,KAAK,QAAQ,iBAAiB,qBAAqB;EAC/D,eAAe,QAAQ,iBAAiB,QAAQ;EAChD,cAAc,QAAQ;CACxB,CAAC;CACD,MAAM,aAAa,OAAO;CAC1B,IAAI,aAAa,OAAO,MAAM,kBAAkB,QAAQ,eAAe;AACzE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swifttui/build",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@swifttui/web": "0.17.0"
+    "@swifttui/web": "0.18.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.14"