refactor: consolidate builder configuration patterns

[pranaygp]

Extracts common builder configuration pattern into a reusable helper function,
improving consistency across framework integrations.

Changes:

• Created createBaseBuilderConfig() helper in @workflow/builders
• Updated @workflow/nitro builders to use the new helper
• Removed CommonBuildOptions constant from nitro package
• Added clear documentation for when bundle paths are not used

This makes it easier for framework integrations to create properly configured
builder instances without manually specifying unused bundle path properties.

🤖 Generated with Claude Code

Co-Authored-By: Claude [email protected]

[changeset-bot]

🦋 Changeset detected

Latest commit: 2c010be

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages

Name	Type
@workflow/builders	Patch
@workflow/nitro	Patch
@workflow/cli	Patch
@workflow/next	Patch
@workflow/sveltekit	Patch
workflow	Patch
@workflow/world-testing	Patch
@workflow/ai	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
example-nextjs-workflow-turbopack	Ready	Preview	Comment	Nov 4, 2025 7:53am
example-nextjs-workflow-webpack	Ready	Preview	Comment	Nov 4, 2025 7:53am
example-workflow	Ready	Preview	Comment	Nov 4, 2025 7:53am
workbench-nitro-workflow	Ready	Preview	Comment	Nov 4, 2025 7:53am
workbench-nuxt-workflow	Ready	Preview	Comment	Nov 4, 2025 7:53am
workbench-sveltekit-workflow	Ready	Preview	Comment	Nov 4, 2025 7:53am
workbench-vite-workflow	Ready	Preview	Comment	Nov 4, 2025 7:53am
workflow-docs	Ready	Preview	Comment	Nov 4, 2025 7:53am

[pranaygp]

• docs: add documentation and improve code clarity #84
• refactor: consolidate builder configuration patterns #83 👈 (View in Graphite)
• refactor: improve error handling in bundle creation #82
• refactor: extract path resolution and directory creation helpers #81
• feat: add type safety for builder configurations with discriminated unions #80
• refactor: standardize method naming and clarify log messages #79
• refactor: deduplicate package.json and .vc-config.json generation #77
• refactor: extract queue trigger configuration constants #76
• feat: move NextBuilder to @workflow/next package #74
• feat: create @workflow/builders package with shared builder infrastructure #73
• Rename vercel static builder to standalone builder #71
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[vercel]

🔧 Build Fix:

The workbench/sveltekit directory referenced in the Vercel project configuration was missing from the repository, causing build failures when Vercel tries to access this non-existent root directory.

View Details

📝 Patch Details

diff --git a/workbench/sveltekit/.gitignore b/workbench/sveltekit/.gitignore
new file mode 100644
index 0000000..11ed9e9
--- /dev/null
+++ b/workbench/sveltekit/.gitignore
@@ -0,0 +1,12 @@
+.DS_Store
+node_modules
+/build
+/.svelte-kit
+/package
+.env
+.env.*
+!.env.example
+.vercel
+.output
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
\ No newline at end of file
diff --git a/workbench/sveltekit/LICENSE.md b/workbench/sveltekit/LICENSE.md
new file mode 120000
index 0000000..f0608a6
--- /dev/null
+++ b/workbench/sveltekit/LICENSE.md
@@ -0,0 +1 @@
+../../LICENSE.md
\ No newline at end of file
diff --git a/workbench/sveltekit/README.md b/workbench/sveltekit/README.md
new file mode 100644
index 0000000..3376aec
--- /dev/null
+++ b/workbench/sveltekit/README.md
@@ -0,0 +1,21 @@
+# SvelteKit Workbench Example
+
+This is a SvelteKit workbench example for the Workflow project.
+
+## Developing
+
+Once you've created a project and installed dependencies with `pnpm install`, start a development server:
+
+```bash
+pnpm dev
+```
+
+## Building
+
+To create a production version of your app:
+
+```bash
+pnpm build
+```
+
+You can preview the production build with `pnpm preview`.
\ No newline at end of file
diff --git a/workbench/sveltekit/package.json b/workbench/sveltekit/package.json
new file mode 100644
index 0000000..3cf407c
--- /dev/null
+++ b/workbench/sveltekit/package.json
@@ -0,0 +1,20 @@
+{
+  "name": "@workflow/example-sveltekit",
+  "version": "0.0.1",
+  "private": true,
+  "license": "Apache-2.0",
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-vercel": "^5.4.9",
+    "@sveltejs/kit": "^3.1.3",
+    "@sveltejs/vite-plugin-svelte": "^4.0.2",
+    "svelte": "^5.15.0",
+    "typescript": "catalog:",
+    "vite": "^7.1.12",
+    "workflow": "workspace:*"
+  }
+}
\ No newline at end of file
diff --git a/workbench/sveltekit/src/app.html b/workbench/sveltekit/src/app.html
new file mode 100644
index 0000000..eb123e0
--- /dev/null
+++ b/workbench/sveltekit/src/app.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en" %sveltekit.theme%>
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" href="%sveltekit.assets%/favicon.png" />
+		<meta name="viewport" content="width=device-width" />
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover" %sveltekit.theme%>
+		<div style="display: contents" %sveltekit.theme%>%sveltekit.body%</div>
+	</body>
+</html>
\ No newline at end of file
diff --git a/workbench/sveltekit/src/routes/+page.svelte b/workbench/sveltekit/src/routes/+page.svelte
new file mode 100644
index 0000000..7f07dd9
--- /dev/null
+++ b/workbench/sveltekit/src/routes/+page.svelte
@@ -0,0 +1,38 @@
+<script>
+	import { onMount } from 'svelte';
+	
+	let ready = false;
+	
+	onMount(() => {
+		ready = true;
+	});
+</script>
+
+<svelte:head>
+	<title>Workflow SvelteKit Example</title>
+	<meta name="description" content="SvelteKit example for Workflow" />
+</svelte:head>
+
+<section>
+	<h1>
+		Welcome to Workflow SvelteKit
+	</h1>
+	
+	{#if ready}
+		<p>This is a SvelteKit workbench example for the Workflow project.</p>
+	{/if}
+</section>
+
+<style>
+	section {
+		display: flex;
+		flex-direction: column;
+		justify-content: center;
+		align-items: center;
+		flex: 0.6;
+	}
+	
+	h1 {
+		width: 100%;
+	}
+</style>
\ No newline at end of file
diff --git a/workbench/sveltekit/svelte.config.js b/workbench/sveltekit/svelte.config.js
new file mode 100644
index 0000000..530ce3b
--- /dev/null
+++ b/workbench/sveltekit/svelte.config.js
@@ -0,0 +1,12 @@
+import adapter from '@sveltejs/adapter-vercel';
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte/preprocess';
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+	preprocess: vitePreprocess(),
+	kit: {
+		adapter: adapter()
+	}
+};
+
+export default config;
\ No newline at end of file
diff --git a/workbench/sveltekit/tsconfig.json b/workbench/sveltekit/tsconfig.json
new file mode 100644
index 0000000..cf31bef
--- /dev/null
+++ b/workbench/sveltekit/tsconfig.json
@@ -0,0 +1,14 @@
+{
+	"extends": "./.svelte-kit/tsconfig.json",
+	"compilerOptions": {
+		"allowJs": true,
+		"checkJs": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"sourceMap": true,
+		"strict": true,
+		"moduleResolution": "bundler"
+	}
+}
\ No newline at end of file
diff --git a/workbench/sveltekit/vite.config.ts b/workbench/sveltekit/vite.config.ts
new file mode 100644
index 0000000..842631b
--- /dev/null
+++ b/workbench/sveltekit/vite.config.ts
@@ -0,0 +1,6 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+	plugins: [sveltekit()]
+});
\ No newline at end of file

Analysis

Missing workbench/sveltekit directory causes Vercel build failure

What fails: Vercel project configuration references workbench/sveltekit as the root directory, but this directory does not exist in the repository

How to reproduce:

cd workbench/sveltekit

Result:

bash: line 1: cd: workbench/sveltekit: No such file or directory

Expected behavior: The directory should exist with a valid SvelteKit project structure for the workbench examples