@dfosco/storyboard 0.12.0 → 0.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dfosco/storyboard",
-    "version": "0.12.0",
+    "version": "0.12.2",
     "type": "module",
     "license": "MIT",
     "description": "Storyboard prototyping framework — core engine, React integration, and canvas",

package/scaffold/eslint.config.js

@@ -0,0 +1,45 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import react from 'eslint-plugin-react'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+
+export default [
+  { ignores: ['dist', '.worktrees'] },
+  {
+    files: ['vite.config.js', 'eslint.config.js'],
+    languageOptions: {
+      globals: globals.node,
+    },
+  },
+  {
+    files: ['**/*.{js,jsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        ecmaFeatures: { jsx: true },
+        sourceType: 'module',
+      },
+    },
+    settings: { react: { version: 'detect' } },
+    plugins: {
+      react,
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...react.configs.recommended.rules,
+      ...react.configs['jsx-runtime'].rules,
+      ...reactHooks.configs.recommended.rules,
+      'react/prop-types': 'off',
+      'react/jsx-no-target-blank': 'off',
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+]

package/scaffold/scaffold.config.json

@@ -15,6 +15,26 @@
       "target": "storyboard.config.json",
       "mode": "scaffold"
     },
+    {
+      "source": "scaffold/vite.config.js",
+      "target": "vite.config.js",
+      "mode": "updateable"
+    },
+    {
+      "source": "scaffold/vitest.config.js",
+      "target": "vitest.config.js",
+      "mode": "updateable"
+    },
+    {
+      "source": "scaffold/eslint.config.js",
+      "target": "eslint.config.js",
+      "mode": "updateable"
+    },
+    {
+      "source": "scaffold/tsconfig.json",
+      "target": "tsconfig.json",
+      "mode": "updateable"
+    },
     {
       "source": "scaffold/scripts/link.sh",
       "target": "scripts/link.sh",
@@ -139,6 +159,11 @@
       "target": "src/library/index.jsx",
       "mode": "updateable"
     },
+    {
+      "source": "scaffold/src/library/home.jsx",
+      "target": "src/library/home.jsx",
+      "mode": "updateable"
+    },
     {
       "source": "scaffold/src/library/README.md",
       "target": "src/library/README.md",

package/scaffold/scripts/aggregate-artifacts.mjs

@@ -19,6 +19,28 @@ function withTrailingSlash(folder) {
   return folder.endsWith('/') ? folder : `${folder}/`
 }
 
+/**
+ * Folder-independent identity for a canvas, mirroring prototype `dirName`
+ * matching. Keeps cross-branch dedup stable when a canvas moves between
+ * folders (or root ↔ folder). Proto-scoped canvases retain their prototype
+ * segment so same-named canvases in different prototypes never collide.
+ */
+function canvasMatchKey(id) {
+  let raw = String(id || '')
+  let isProto = false
+  if (raw.startsWith('proto:')) {
+    isProto = true
+    raw = raw.slice('proto:'.length)
+  }
+  const segments = raw.split('/').filter(Boolean)
+  const name = segments[segments.length - 1] || raw
+  if (isProto) {
+    const scope = segments.length >= 2 ? segments[segments.length - 2] : ''
+    return scope ? `proto:${scope}/${name}` : `proto:${name}`
+  }
+  return name
+}
+
 function generatedAtMs(manifest) {
   const value = Date.parse(manifest?.generatedAt || '')
   return Number.isNaN(value) ? 0 : value
@@ -157,7 +179,7 @@ function addCanvas(index, manifestInfo, item) {
 
   const { manifest, folder } = manifestInfo
   const branch = deriveBranch(manifest, folder)
-  const key = String(id)
+  const key = canvasMatchKey(id)
 
   if (!index.canvases[key]) {
     index.canvases[key] = { id: key, branches: [] }

package/scaffold/src/library/README.md

@@ -13,10 +13,11 @@ The contents:
 | `prototypes-entry.jsx` | Vite iframe entry — `prototypes.html` loads this |
 | `routes.jsx` | Generouted glue: scans `src/library/*.jsx` (workspace pages) and `src/prototypes/**` (your prototypes) |
 | `_app.jsx`, `_app.module.css` | Workspace SPA shell — `StoryboardProvider`, suspense, error boundary, feature-flag banner |
-| `workspace.jsx` | `/workspace` route — calls `<Workspace>` |
+| `workspace.jsx` | `/workspace` route — calls `<Workspace>`; props come from `pages.workspace` in `storyboard.config.json` |
 | `viewfinder.jsx` | `/viewfinder` redirect (kept for back-compat) |
 | `create.jsx` | `/create` standalone artifact creator |
-| `index.jsx` | `/` landing — `<SimpleWorkspace>` |
+| `home.jsx` | `/home` route — the landing surface (`<SimpleWorkspace>`); props come from `pages.home` in `storyboard.config.json` |
+| `index.jsx` | `/` index — renders whichever surface `routes["/"]` selects (env-aware) |
 
 ## How to customize storyboard
 
@@ -25,9 +26,53 @@ Almost every customization knob lives elsewhere:
 | What you want to change | Edit |
 |---|---|
 | App title, theming, feature flags, surfaces | `storyboard.config.json` |
+| Which page renders at `/` (and per environment) | `storyboard.config.json` → `routes` |
+| Landing / workspace titles, subtitles, logo, tabs | `storyboard.config.json` → `pages` |
 | Provider chain for every **prototype** (design system, fonts, Tailwind) | `src/_prototype.jsx` (optional — create it if you want it) |
 | Provider chain for every **story** | `src/_story.jsx` (optional) |
-| Add new routes the user can navigate to inside the SPA | Add files under `src/prototypes/` |
+| Add new routes the user can navigate to inside the SPA | Add files under `src/prototypes/`, or a flat `src/<Name>.jsx` → `/<Name>` |
+
+### `routes` — what renders at `/`
+
+`routes` maps a path to a target page name. The index `/` defaults to `home`:
+
+```jsonc
+{
+  "routes": {
+    "/": "home"                                  // same page in every env
+    // "/": { "dev": "workspace", "prod": "home" } // per-environment target
+  }
+}
+```
+
+A target is a page name with no leading slash — a library surface (`"home"`,
+`"workspace"`) or a flat component (`"Dashboard"` for `src/Dashboard.jsx`). The
+object form picks `dev` under `storyboard dev`, `prod` in production builds, and
+`default` as a fallback. If `/` resolves to a flat component, the index
+redirects there.
+
+### `pages` — surface presentation props
+
+`pages` holds the title/subtitle/logo/tab props the library pages used to
+hardcode, so you configure surfaces without touching the JSX:
+
+```jsonc
+{
+  "pages": {
+    "home":      { "title": "My App", "subtitle": "Welcome" },
+    "workspace": { "title": "My App", "showComponents": false }
+  }
+}
+```
+
+Both are leaf-merged over behavior-preserving defaults — set only the keys you
+want to change.
+
+### Flat-file routes
+
+Any top-level `src/<Name>.jsx` automatically becomes a `/<Name>` route, rendered
+**bare** (only the `_app` SPA shell — no prototype wrapper). Files prefixed with
+`_` (e.g. `src/_prototype.jsx`) are excluded.
 
 If you have a real reason to edit a file in this directory, just edit it —
 storyboard will warn (but not block) on the next sync. You opt out of sync

package/scaffold/src/library/home.jsx

@@ -0,0 +1,24 @@
+/**
+ * DO NOT EDIT — storyboard-owned library file.
+ *
+ * Synced from @dfosco/storyboard. The `home` surface (landing workspace).
+ * All presentation props (title, subtitle) come from `pages.home` in
+ * storyboard.config.json — configure there, never edit this file.
+ * See src/library/README.md for the full customization surface.
+ */
+import { SimpleWorkspace } from '@dfosco/storyboard'
+import { getConfig } from '@dfosco/storyboard/config'
+import storyboardConfig from '../../storyboard.config.json'
+
+const pageModules = import.meta.glob('/src/prototypes/*/*.jsx')
+const { pages } = getConfig(storyboardConfig)
+
+export default function HomePage() {
+  return (
+    <SimpleWorkspace
+      {...pages.home}
+      pageModules={pageModules}
+      basePath={import.meta.env.BASE_URL}
+    />
+  )
+}

package/scaffold/src/library/index.jsx

@@ -1,14 +1,41 @@
-import { SimpleWorkspace } from '@dfosco/storyboard'
+/**
+ * DO NOT EDIT — storyboard-owned library file.
+ *
+ * Synced from @dfosco/storyboard. The site index (`/`).
+ *
+ * Which surface renders here is configured via `routes["/"]` in
+ * storyboard.config.json — a page name (e.g. "home", "workspace") or a
+ * per-environment object `{ dev, prod, default }`. Defaults to "home".
+ * Configure the route in storyboard.config.json, never edit this file.
+ * See src/library/README.md for the full customization surface.
+ */
+import { useEffect } from 'react'
+import { getConfig, resolveRouteTarget } from '@dfosco/storyboard/config'
+import storyboardConfig from '../../storyboard.config.json'
+import HomePage from './home'
+import WorkspacePage from './workspace'
 
-const pageModules = import.meta.glob('/src/prototypes/*/*.jsx')
+const { routes } = getConfig(storyboardConfig)
+const target = resolveRouteTarget(routes, '/', { dev: import.meta.env.DEV }) || 'home'
+
+// Built-in surfaces that render inline at the index without a redirect.
+const SURFACES = {
+  home: HomePage,
+  workspace: WorkspacePage,
+}
+
+function RedirectTo({ to }) {
+  useEffect(() => {
+    const base = (import.meta.env.BASE_URL || '/').replace(/\/+$/, '')
+    window.location.replace(`${base}/${to}${window.location.hash}`)
+  }, [to])
+  return null
+}
 
 export default function IndexPage() {
-  return (
-    <SimpleWorkspace
-      title="Storyboard"
-      subtitle="Collaborative workspace for design & code"
-      pageModules={pageModules}
-      basePath={import.meta.env.BASE_URL}
-    />
-  )
+  const Surface = SURFACES[target]
+  if (Surface) return <Surface />
+  // Target is a flat component (src/<Name>.jsx) or another library page —
+  // redirect `/` to that route so any configured target works.
+  return <RedirectTo to={target} />
 }

package/scaffold/src/library/routes.jsx

@@ -39,7 +39,12 @@ import {
 // and `drafts/` segments. A `drafts/` dir is a gitignored scratch root —
 // prototypes inside route at the same URL as a non-prefixed sibling (so
 // `prototypes/drafts/Foo/` and `prototypes/Foo/` both resolve at `/Foo`).
-patterns.route = [/^.*\/src\/(library|prototypes)\/|^\/(library|prototypes)\/|[^/]*\.folder\/|(?<=^|\/)drafts\/|\.(jsx|tsx|mdx)$/g, '']
+//
+// The second alternation strips a leading `/src/` for BARE top-level files
+// (`/src/Dashboard.jsx` → `Dashboard`). The lookahead `(?=[^/]+\.(jsx|tsx|mdx)$)`
+// ensures it only fires for files directly under /src (no further slash), so
+// it never touches library/ or prototypes/ paths.
+patterns.route = [/^.*\/src\/(library|prototypes)\/|^.*\/src\/(?=[^/]+\.(jsx|tsx|mdx)$)|^\/(library|prototypes)\/|[^/]*\.folder\/|(?<=^|\/)drafts\/|\.(jsx|tsx|mdx)$/g, '']
 
 // `_app.jsx` lives in src/library/ — it's storyboard's SPA shell
 // (StoryboardProvider + suspense + error boundary). Consumers can copy
@@ -63,6 +68,13 @@ const PROTOTYPE_ROUTES = import.meta.glob(
   ['/src/prototypes/**/[\\w[-]*.{jsx,tsx,mdx}', '!/src/prototypes/**/(_!(layout)*(/*)?|_app|404)*'],
 )
 
+// Flat-file routes — any top-level `src/<Name>.jsx` becomes a `/<Name>` route,
+// rendered BARE (only the _app SPA shell, NOT wrapped in _prototype). Files
+// prefixed with `_` (e.g. _prototype.jsx, _story.jsx) are excluded.
+const ROOT_ROUTES = import.meta.glob(
+  ['/src/*.{jsx,tsx}', '!/src/_*.{jsx,tsx}'],
+)
+
 const preservedRoutes = generatePreservedRoutes(PRESERVED)
 const modalRoutes = generateModalRoutes(MODALS)
 
@@ -102,6 +114,7 @@ function makeLazyRoute(importFn, key) {
 
 const libraryRoutes = generateRegularRoutes(LIBRARY_ROUTES, makeLazyRoute)
 const prototypeRoutes = generateRegularRoutes(PROTOTYPE_ROUTES, makeLazyRoute)
+const rootRoutes = generateRegularRoutes(ROOT_ROUTES, makeLazyRoute)
 
 const _app = preservedRoutes?.['_app']
 const _404 = preservedRoutes?.['404']
@@ -162,7 +175,7 @@ const prototypeLayoutRoute = {
 
 export const routes = [{
   ...app,
-  children: [...libraryRoutes, prototypeLayoutRoute, fallback],
+  children: [...libraryRoutes, ...rootRoutes, prototypeLayoutRoute, fallback],
 }]
 
 // Return a routes tree filtered to a single prototype subtree. Used by the
@@ -185,13 +198,15 @@ export function getRoutesForProto(proto) {
         .map((r) => {
             if (r.path === '*') return r
             if (!r.path) {
-                if (r.children) return { ...r, children: filter(r.children) }
-                return r
-            }
-            if (matchesProto(r)) {
                 return r.children ? { ...r, children: filter(r.children) } : r
             }
-            return null
+            // A route WITH a path is kept iff its first segment matches the
+            // requested proto. When it matches, keep its ENTIRE subtree — do
+            // NOT re-filter children, since generouted nests sub-routes under
+            // the prototype (e.g. `canvas-threats/threats` becomes a `threats`
+            // child of `canvas-threats`); re-filtering would drop them because
+            // their own segment isn't the proto name.
+            return matchesProto(r) ? r : null
         })
         .filter(Boolean)
     return [{

package/scaffold/src/library/workspace.jsx

@@ -1,13 +1,23 @@
+/**
+ * DO NOT EDIT — storyboard-owned library file.
+ *
+ * Synced from @dfosco/storyboard. The `workspace` surface (Viewfinder).
+ * All presentation props (title, subtitle, logo, tab toggles) come from
+ * `pages.workspace` in storyboard.config.json — configure there, never edit
+ * this file. See src/library/README.md for the full customization surface.
+ */
 import { flows } from 'virtual:storyboard-data-index'
 import { Workspace } from '@dfosco/storyboard'
+import { getConfig } from '@dfosco/storyboard/config'
+import storyboardConfig from '../../storyboard.config.json'
 
 const pageModules = import.meta.glob('/src/prototypes/*.jsx')
+const { pages } = getConfig(storyboardConfig)
 
 export default function WorkspacePage() {
   return (
     <Workspace
-      title="Storyboard"
-      subtitle="Where design work goes"
+      {...pages.workspace}
       flows={flows}
       hideDefaultFlow={true}
       pageModules={pageModules}

package/scaffold/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "allowJs": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}

package/scaffold/vite.config.js

@@ -0,0 +1,153 @@
+import { defineConfig } from 'vite'
+import path from 'path'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+import generouted from '@generouted/react-router/plugin'
+import storyboardData from '@dfosco/storyboard/vite'
+import storyboardServer from '@dfosco/storyboard/vite/server'
+import postcssGlobalData from '@csstools/postcss-global-data'
+import postcssPresetEnv from 'postcss-preset-env'
+import browsers from '@github/browserslist-config'
+import { globSync } from 'glob'
+
+const __dirname = path.dirname(new URL(import.meta.url).pathname)
+
+export default defineConfig(() => {
+    const base = process.env.VITE_BASE_PATH || '/'
+
+    return {
+    base,
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, './src'),
+        },
+        dedupe: ['react', 'react-dom'],
+    },
+    plugins: [
+        tailwindcss(),
+        storyboardData(),
+        storyboardServer(),
+        react(),
+        generouted({
+            source: {
+                routes: './src/prototypes/**/[\\w[-]*.{jsx,tsx,mdx}',
+                modals: './src/prototypes/**/[+]*.{jsx,tsx,mdx}',
+            },
+        }),
+        // generouted's built-in watcher only listens for /src/pages/ changes.
+        // This plugin triggers a full reload when prototypes are added/removed.
+        {
+            name: 'prototypes-watcher',
+            configureServer(server) {
+                const listener = (file = '') => {
+                    if (file.includes(path.normalize('/src/prototypes/'))) {
+                        server.ws.send({ type: 'full-reload' })
+                    }
+                }
+                server.watcher.on('add', listener)
+                server.watcher.on('unlink', listener)
+            },
+        },
+        {
+            name: 'base-redirect',
+            configureServer(server) {
+                const baseNoTrail = base.replace(/\/$/, '')
+                server.middlewares.use((req, res, next) => {
+                    if (req.url === baseNoTrail) {
+                        res.writeHead(302, { Location: base })
+                        res.end()
+                        return
+                    }
+                    if (req.url && req.url !== baseNoTrail && !req.url.startsWith(base) && !req.url.startsWith('/@') && !req.url.startsWith('/node_modules/')) {
+                        const newUrl = baseNoTrail + req.url
+                        res.writeHead(302, { Location: newUrl })
+                        res.end()
+                        return
+                    }
+                    next()
+                })
+            },
+        },
+    ],
+    server: {
+        port: 1234,
+        fs: { allow: ['..'] },
+        warmup: {
+            clientFiles: [
+                'src/library/mount.jsx',
+                'src/library/prototypes-entry.jsx',
+                'src/prototypes/**/*.jsx',
+                'src/components/**/*.jsx',
+                'src/templates/**/*.jsx',
+            ],
+        },
+    },
+    optimizeDeps: {
+        include: [
+            'reshaped',
+            '@primer/react',
+            '@primer/octicons-react',
+            'prop-types',
+            '@base-ui/react/accordion',
+            '@base-ui/react/checkbox',
+            '@base-ui/react/dialog',
+            '@base-ui/react/number-field',
+            '@base-ui/react/progress',
+            '@base-ui/react/radio',
+            '@base-ui/react/radio-group',
+            '@base-ui/react/select',
+            '@base-ui/react/slider',
+            '@base-ui/react/switch',
+            '@base-ui/react/tabs',
+            '@base-ui/react/tooltip',
+            // CommonJS leaf pulled in transitively via @dfosco/storyboard ->
+            // unified (markdown). unified does `import extend from 'extend'`,
+            // but `extend` is CJS; without pre-bundling Vite serves it raw and
+            // the default-import interop fails ("does not provide an export
+            // named 'default'"). Forcing it into optimizeDeps gives it a
+            // synthesized default export.
+            'extend',
+        ],
+    },
+    esbuild: {
+        // Preserve function names so the storyboard inspector shows
+        // real component names instead of minified identifiers
+        keepNames: true,
+    },
+    build: {
+        chunkSizeWarningLimit: 700,
+        rollupOptions: {
+            output: {
+                manualChunks: {
+                    'vendor-react': ['react', 'react-dom', 'react-router-dom'],
+                    'vendor-primer': ['@primer/react'],
+                    'vendor-octicons': ['@primer/octicons-react'],
+                    'vendor-reshaped': ['reshaped'],
+                },
+            },
+        },
+    },
+    css: {
+        postcss: {
+            plugins: [
+                postcssGlobalData({
+                    files: globSync(
+                        'node_modules/@primer/primitives/dist/css/**/*.css',
+                        { ignore: ['**/themes/**'] }
+                    ),
+                }),
+                postcssPresetEnv({
+                    stage: 2,
+                    browsers,
+                    features: {
+                        'nesting-rules': {
+                            noIsPseudoSelector: true,
+                        },
+                        'focus-visible-pseudo-class': false,
+                        'logical-properties-and-values': false,
+                    },
+                }),
+            ],
+        },
+    },
+}})

package/scaffold/vitest.config.js

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: 'jsdom',
+    globals: true,
+    css: true,
+    setupFiles: ['./src/test-setup.ts'],
+    server: {
+      deps: {
+        inline: ['@primer/react'],
+      },
+    },
+  },
+})

package/scripts/aggregate-artifacts.mjs

@@ -19,6 +19,28 @@ function withTrailingSlash(folder) {
   return folder.endsWith('/') ? folder : `${folder}/`
 }
 
+/**
+ * Folder-independent identity for a canvas, mirroring prototype `dirName`
+ * matching. Keeps cross-branch dedup stable when a canvas moves between
+ * folders (or root ↔ folder). Proto-scoped canvases retain their prototype
+ * segment so same-named canvases in different prototypes never collide.
+ */
+function canvasMatchKey(id) {
+  let raw = String(id || '')
+  let isProto = false
+  if (raw.startsWith('proto:')) {
+    isProto = true
+    raw = raw.slice('proto:'.length)
+  }
+  const segments = raw.split('/').filter(Boolean)
+  const name = segments[segments.length - 1] || raw
+  if (isProto) {
+    const scope = segments.length >= 2 ? segments[segments.length - 2] : ''
+    return scope ? `proto:${scope}/${name}` : `proto:${name}`
+  }
+  return name
+}
+
 function generatedAtMs(manifest) {
   const value = Date.parse(manifest?.generatedAt || '')
   return Number.isNaN(value) ? 0 : value
@@ -157,7 +179,7 @@ function addCanvas(index, manifestInfo, item) {
 
   const { manifest, folder } = manifestInfo
   const branch = deriveBranch(manifest, folder)
-  const key = String(id)
+  const key = canvasMatchKey(id)
 
   if (!index.canvases[key]) {
     index.canvases[key] = { id: key, branches: [] }

package/src/core/cli/updateVersion.js

@@ -144,7 +144,12 @@ try {
   installedVersion = installedVersion || suffix.slice(1)
   const commitMsg = `[storyboard-update] Update storyboard to ${installedVersion}`
 
-  // Only stage update-related files (package.json, lock files, scaffold outputs)
+  // Stage update-related files (package.json, lock files, scaffold outputs).
+  // The Tier-1 package-owned infra configs + library are force-synced by the
+  // scaffold pass and must be committed so `storyboard update` is fully
+  // hands-off — customers never hand-patch these. User-facing *.config.json
+  // (storyboard.config.json, terminal.config.json, …) are intentionally NOT
+  // staged — those are customer-owned.
   const filesToStage = [
     'package.json',
     'package-lock.json',
@@ -153,11 +158,23 @@ try {
     '.github/skills',
     '.github/workflows/scripts/aggregate-artifacts.mjs',
     'scripts',
+    // Tier-1 package-owned infrastructure (force-synced):
+    'vite.config.js',
+    'vitest.config.js',
+    'eslint.config.js',
+    'tsconfig.json',
+    'src/library',
   ]
   for (const f of filesToStage) {
     try { execSync(`git add ${f}`, { cwd: process.cwd(), stdio: 'pipe' }) } catch { /* empty */ }
   }
 
+  // Svelte was removed from the storyboard base — drop the stale empty stub
+  // from existing customer repos so the update sheds it automatically.
+  try {
+    execSync('git rm --quiet --ignore-unmatch svelte.config.js', { cwd: process.cwd(), stdio: 'pipe' })
+  } catch { /* empty */ }
+
   // Only commit if there are staged changes
   try {
     execSync('git diff --cached --quiet', { cwd: process.cwd(), stdio: 'pipe' })