@sticklightapp/tanstack-vite-config 0.0.0-stage → 0.0.5

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @sticklightapp/tanstack-vite-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vite configuration for Sticklight TanStack Start apps.
+
+## Usage
+
+```ts
+import { defineConfig } from '@sticklightapp/tanstack-vite-config';
+
+export default defineConfig({
+	tanstackStart: {
+		prerender: {
+			enabled: true,
+		},
+	},
+});
+```
+
+## Options
+
+| Option          | Description                               |
+| --------------- | ----------------------------------------- |
+| `vite`          | Allowed `root`, `resolve`, `optimizeDeps`, `css`, `define`, and `ssr` options. |
+| `plugins`       | Extra Vite plugins.                       |
+| `tanstackStart` | Options for `tanstackStart()`.            |
+| `react`         | Options for `@vitejs/plugin-react`.       |
+| `nitro`         | `compatibilityDate` and `wrangler`.       |
+| `tailwindCdn`   | `themeCssPath` (default `src/theme.css`). |
+
+Unsupported Vite keys are ignored with a structured warning. Host, port, strict-port, HMR overlay, and watch-ignore settings stay platform-owned.
+
+## Peer dependencies
+
+`vite`, `@tanstack/react-start`.

package/define-config.d.ts

@@ -0,0 +1,25 @@
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import { type ConfigEnv, type PluginOption, type UserConfig } from 'vite';
+import { type NitroOptions } from './nitro.js';
+import { type TailwindCdnOptions } from './plugins/tailwind-cdn.js';
+import { type AllowedViteConfig } from './resolve-vite-config.js';
+type TanstackStartOptions = NonNullable<Parameters<typeof tanstackStart>[0]>;
+type ReactOptions = NonNullable<Parameters<typeof viteReact>[0]>;
+export interface TanstackViteConfigOptions {
+    /** Allowed Vite options merged over platform defaults. Unsupported runtime keys are ignored with a warning. */
+    vite?: AllowedViteConfig;
+    /** Appended after the platform plugins. */
+    plugins?: PluginOption[];
+    /** Forwarded to `tanstackStart()`. Route scaffolding stays platform-owned. */
+    tanstackStart?: TanstackStartOptions;
+    /** Forwarded to `viteReact()`. */
+    react?: ReactOptions;
+    /** Applied to the build-only Nitro Cloudflare plugin. The preset and deploy config stay platform-owned. */
+    nitro?: NitroOptions;
+    /** Applied to the dev-only Tailwind browser build. */
+    tailwindCdn?: TailwindCdnOptions;
+}
+export declare function defineConfig(options?: TanstackViteConfigOptions): (env: ConfigEnv) => Promise<UserConfig>;
+export {};
+//# sourceMappingURL=define-config.d.ts.map

package/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../src/define-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAG7C,OAAO,EAAgB,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AACxF,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAGtE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAA4C,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG5G,KAAK,oBAAoB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7E,KAAK,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,yBAAyB;IACzC,+GAA+G;IAC/G,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,kCAAkC;IAClC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2GAA2G;IAC3G,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,yBAA8B,IACrD,KAAK,SAAS,KAAG,OAAO,CAAC,UAAU,CAAC,CAmBlD"}

package/define-config.js

@@ -0,0 +1,91 @@
+import { createViteLogger } from '@sticklightapp/sandbox-logger';
+import tailwindcss from '@tailwindcss/vite';
+import { tanstackStart } from '@tanstack/react-start/plugin/vite';
+import viteReact from '@vitejs/plugin-react';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createLogger } from 'vite';
+import { buildOnlyNitroPlugins } from './nitro.js';
+import { DEV_SCRIPTS_INJECTOR, injectDevToolsPlugin } from './plugins/dev-tools.js';
+import { structuredLoggerPlugin } from './plugins/structured-logger.js';
+import { tailwindCdnPlugin } from './plugins/tailwind-cdn.js';
+import { resolveViteConfig, SANDBOX_WATCH_IGNORES } from './resolve-vite-config.js';
+import { captureConsoleErrors, emit } from './sandbox-log.js';
+export function defineConfig(options = {}) {
+    return async (env) => {
+        captureConsoleErrors();
+        const root = path.resolve(options.vite?.root ?? process.cwd());
+        const platformConfig = {
+            ...createPlatformConfig(root),
+            plugins: await createPlugins(env, options),
+        };
+        const config = resolveViteConfig(platformConfig, options.vite);
+        return {
+            ...config,
+            // createViteLogger overrides error() too, so RollupError fields (plugin, loc, frame)
+            // reach the log as real fields instead of being formatted into one string.
+            customLogger: createViteLogger(createLogger(), emit),
+        };
+    };
+}
+function createPlatformConfig(root) {
+    return {
+        server: {
+            host: '0.0.0.0', // Required for Daytona sandbox proxy access
+            port: 5173,
+            strictPort: true,
+            hmr: {
+                overlay: false,
+            },
+            warmup: {
+                // Pre-transform the platform-owned entries on startup so the first request is instant.
+                // Agent-owned route files are deliberately absent: they get moved into layouts and
+                // nested directories, and a stale path here makes Vite log a standing pre-transform error.
+                clientFiles: ['./src/routes/__root.tsx', './src/router.tsx'],
+            },
+            watch: {
+                ignored: SANDBOX_WATCH_IGNORES,
+            },
+        },
+        optimizeDeps: {
+            // Pre-bundle these on startup so the first page load doesn't trigger re-optimization
+            include: ['react', 'react-dom', '@supabase/supabase-js', 'lucide-react', '@tanstack/react-router', DEV_SCRIPTS_INJECTOR],
+        },
+        resolve: {
+            alias: {
+                '@': path.resolve(root, 'src'),
+                [DEV_SCRIPTS_INJECTOR]: fileURLToPath(import.meta.resolve(DEV_SCRIPTS_INJECTOR)),
+            },
+            dedupe: ['react', 'react-dom'],
+        },
+    };
+}
+async function createPlugins(env, options) {
+    const nitroPlugins = env.command === 'build' ? await buildOnlyNitroPlugins(options.nitro) : [];
+    return [
+        tailwindcss(),
+        tailwindCdnPlugin(options.tailwindCdn),
+        tanstackStart(resolveTanstackStartOptions(options.tanstackStart)),
+        ...nitroPlugins,
+        // viteReact must come AFTER tanstackStart
+        viteReact(options.react),
+        injectDevToolsPlugin(),
+        structuredLoggerPlugin(),
+        ...(options.plugins ?? []),
+    ];
+}
+function resolveTanstackStartOptions(overrides = {}) {
+    return {
+        ...overrides,
+        server: {
+            entry: 'server',
+            ...overrides.server,
+        },
+        router: {
+            ...overrides.router,
+            // Uploads are not atomic, so the generator can see a route file while it is still empty.
+            // Its default scaffold would replace the file mid-write; empty templates make it skip the file.
+            customScaffolding: { routeTemplate: '', lazyRouteTemplate: '' },
+        },
+    };
+}

package/index.d.ts

@@ -0,0 +1,5 @@
+export { defineConfig, type TanstackViteConfigOptions } from './define-config.js';
+export type { NitroOptions } from './nitro.js';
+export type { TailwindCdnOptions } from './plugins/tailwind-cdn.js';
+export type { AllowedViteConfig } from './resolve-vite-config.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/index.js

@@ -0,0 +1 @@
+export { defineConfig } from './define-config.js';

package/nitro.d.ts

@@ -0,0 +1,13 @@
+import type { nitro } from 'nitro/vite';
+import type { PluginOption } from 'vite';
+type NitroPluginOptions = NonNullable<Parameters<typeof nitro>[0]>;
+type CloudflareOptions = NonNullable<NitroPluginOptions['cloudflare']>;
+/** Kept narrow on purpose: Nitro v3 is pre-RC, and the deploy pipeline reads `.output/server/wrangler.json`. */
+export interface NitroOptions {
+    compatibilityDate?: NitroPluginOptions['compatibilityDate'];
+    /** Shallow-merged into the generated `wrangler.json`. */
+    wrangler?: CloudflareOptions['wrangler'];
+}
+export declare function buildOnlyNitroPlugins(options?: NitroOptions): Promise<PluginOption[]>;
+export {};
+//# sourceMappingURL=nitro.d.ts.map

package/nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../src/nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,KAAK,kBAAkB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,KAAK,iBAAiB,GAAG,WAAW,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;AAEvE,gHAAgH;AAChH,MAAM,WAAW,YAAY;IAC5B,iBAAiB,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IAC5D,yDAAyD;IACzD,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CACzC;AAUD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAe/F"}

package/nitro.js

@@ -0,0 +1,21 @@
+const DEFAULT_COMPATIBILITY_DATE = '2026-08-04';
+const DEFAULT_WRANGLER = {
+    name: 'tanstack-ssr-app',
+};
+// Deploy reads `.output/server/wrangler.json`, which Nitro writes. Loaded only for builds: the dev
+// server runs on plain Node.
+export async function buildOnlyNitroPlugins(options = {}) {
+    const { nitro } = await import('nitro/vite');
+    return nitro({
+        preset: 'cloudflare-module',
+        compatibilityDate: options.compatibilityDate ?? DEFAULT_COMPATIBILITY_DATE,
+        cloudflare: {
+            deployConfig: true,
+            nodeCompat: true,
+            wrangler: {
+                ...DEFAULT_WRANGLER,
+                ...options.wrangler,
+            },
+        },
+    });
+}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@sticklightapp/tanstack-vite-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.5",
+  "description": "Vite configuration for Sticklight TanStack Start apps",
+  "keywords": [
+    "vite",
+    "vite-config",
+    "tanstack",
+    "tanstack-start"
+  ],
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "**/*.js",
+    "**/*.d.ts",
+    "**/*.d.ts.map",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elementor/elementor-vibe.git",
+    "directory": "packages/tanstack-vite-config"
+  },
+  "dependencies": {
+    "@elementor/sandbox-dev-scripts-injector": "0.0.24",
+    "@sticklightapp/sandbox-logger": "0.0.28",
+    "@tailwindcss/vite": "4.3.3",
+    "@vitejs/plugin-react": "6.1.2",
+    "nitro": "3.0.260903-beta",
+    "tslib": "^2.8.1"
+  },
+  "peerDependencies": {
+    "@tanstack/react-start": "^1.169.3",
+    "vite": "^8.3.0"
+  }
 }

package/plugins/dev-tools.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from 'vite';
+export declare const DEV_SCRIPTS_INJECTOR = "@elementor/sandbox-dev-scripts-injector";
+export declare function injectDevToolsPlugin(): Plugin;
+//# sourceMappingURL=dev-tools.d.ts.map

package/plugins/dev-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-tools.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,eAAO,MAAM,oBAAoB,4CAA4C,CAAC;AAE9E,wBAAgB,oBAAoB,IAAI,MAAM,CAe7C"}

package/plugins/dev-tools.js

@@ -0,0 +1,17 @@
+import { appendDynamicImport, isViteClient, warnIfViteClientMissing } from '../vite-client.js';
+export const DEV_SCRIPTS_INJECTOR = '@elementor/sandbox-dev-scripts-injector';
+export function injectDevToolsPlugin() {
+    return {
+        name: 'inject-dev-tools',
+        apply: 'serve',
+        configureServer(server) {
+            warnIfViteClientMissing(server.config.root);
+        },
+        transform(code, id) {
+            if (!isViteClient(this.environment, id)) {
+                return;
+            }
+            return appendDynamicImport(code, DEV_SCRIPTS_INJECTOR);
+        },
+    };
+}

package/plugins/structured-logger.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+export declare function structuredLoggerPlugin(): Plugin;
+//# sourceMappingURL=structured-logger.d.ts.map

package/plugins/structured-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-logger.d.ts","sourceRoot":"","sources":["../../src/plugins/structured-logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAE,MAAM,MAAM,CAAC;AAK/C,wBAAgB,sBAAsB,IAAI,MAAM,CAsB/C"}

package/plugins/structured-logger.js

@@ -0,0 +1,36 @@
+import { buildRecord } from '@sticklightapp/sandbox-logger';
+import { emit } from '../sandbox-log.js';
+// Intercepts Vite's WebSocket to log HMR events into /tmp/dev.log.
+// sandbox.service.ts reads these events to detect build success and errors.
+export function structuredLoggerPlugin() {
+    return {
+        name: 'structured-logger',
+        configureServer(server) {
+            const originalSend = server.ws.send;
+            server.ws.send = ((...args) => {
+                emitHotPayload(args[0]);
+                return Reflect.apply(originalSend, server.ws, args);
+            });
+        },
+        buildEnd(error) {
+            if (error) {
+                emit({ ...buildRecord('error', error.message, { error }), event: 'build-error' });
+                return;
+            }
+            emit({ ts: Date.now(), level: 'info', source: 'devserver', event: 'build-success', message: 'build succeeded' });
+        },
+    };
+}
+function emitHotPayload(payload) {
+    if (typeof payload !== 'object' || payload === null || !('type' in payload)) {
+        return;
+    }
+    const hotPayload = payload;
+    if (hotPayload.type === 'update') {
+        hotPayload.updates.forEach((update) => emit({ ts: Date.now(), level: 'info', source: 'devserver', event: 'hmr-update', message: update.path, file: update.path }));
+        return;
+    }
+    if (hotPayload.type === 'full-reload') {
+        emit({ ts: Date.now(), level: 'info', source: 'devserver', event: 'page-reload', message: hotPayload.path ?? '*' });
+    }
+}

package/plugins/tailwind-cdn.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'vite';
+export interface TailwindCdnOptions {
+    /** Theme file passed to the Tailwind browser build, resolved from the app root. Defaults to `src/theme.css`. */
+    themeCssPath?: string;
+}
+export declare function tailwindCdnPlugin(options?: TailwindCdnOptions): Plugin;
+//# sourceMappingURL=tailwind-cdn.d.ts.map

package/plugins/tailwind-cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-cdn.d.ts","sourceRoot":"","sources":["../../src/plugins/tailwind-cdn.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAQlD,MAAM,WAAW,kBAAkB;IAClC,gHAAgH;IAChH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAyC1E"}

package/plugins/tailwind-cdn.js

@@ -0,0 +1,77 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { emit } from '../sandbox-log.js';
+import { appendDynamicImport, isViteClient } from '../vite-client.js';
+const TAILWIND_CDN_MODULE_ID = 'virtual:tailwind-cdn';
+const RESOLVED_TAILWIND_CDN_MODULE_ID = `\0${TAILWIND_CDN_MODULE_ID}`;
+const DEFAULT_THEME_CSS_PATH = 'src/theme.css';
+// Keep this version aligned with the @tailwindcss/vite peer dependency.
+const TAILWIND_CDN_SRC = 'https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4.3.3/dist/index.global.js';
+const TAILWIND_CDN_INTEGRITY = 'sha384-2ql948lIdLcGEE0/qxNiudyTjgauA3RDJERu5xW75kFCvSl5a9odyQYCb6tEjnmB';
+// Injects the Tailwind browser build in dev mode, with the app's theme as its config.
+export function tailwindCdnPlugin(options = {}) {
+    const relativeThemeCssPath = options.themeCssPath ?? DEFAULT_THEME_CSS_PATH;
+    const resolveThemeCssPath = (root) => path.resolve(root, relativeThemeCssPath);
+    return {
+        name: 'tailwind-cdn',
+        apply: 'serve',
+        configureServer(server) {
+            watchThemeCss(server, resolveThemeCssPath(server.config.root));
+        },
+        resolveId(id) {
+            return id === TAILWIND_CDN_MODULE_ID ? RESOLVED_TAILWIND_CDN_MODULE_ID : undefined;
+        },
+        async load(id) {
+            if (id !== RESOLVED_TAILWIND_CDN_MODULE_ID) {
+                return;
+            }
+            const themeCssPath = resolveThemeCssPath(this.environment.config.root);
+            try {
+                const themeCss = await readFile(themeCssPath, 'utf-8');
+                emit({ ts: Date.now(), level: 'info', source: 'devserver', event: 'tailwind-theme-read', message: themeCssPath });
+                return renderTailwindCdnLoader(themeCss);
+            }
+            catch {
+                emit({ ts: Date.now(), level: 'warn', source: 'devserver', event: 'tailwind-theme-missing', message: themeCssPath });
+                return '';
+            }
+        },
+        transform(code, id) {
+            if (!isViteClient(this.environment, id)) {
+                return;
+            }
+            return appendDynamicImport(code, TAILWIND_CDN_MODULE_ID);
+        },
+    };
+}
+function watchThemeCss(server, themeCssPath) {
+    server.watcher.add(themeCssPath);
+    const invalidate = (filePath) => {
+        if (filePath !== themeCssPath) {
+            return;
+        }
+        const clientModuleGraph = server.environments.client.moduleGraph;
+        const tailwindCdnModule = clientModuleGraph.getModuleById(RESOLVED_TAILWIND_CDN_MODULE_ID);
+        if (tailwindCdnModule) {
+            clientModuleGraph.invalidateModule(tailwindCdnModule);
+        }
+        server.ws.send({ type: 'full-reload', path: '*' });
+        emit({ ts: Date.now(), level: 'info', source: 'devserver', event: 'tailwind-theme-invalidated', message: themeCssPath });
+    };
+    server.watcher.on('change', invalidate);
+    server.watcher.on('add', invalidate);
+    server.watcher.on('unlink', invalidate);
+}
+function renderTailwindCdnLoader(themeCss) {
+    return `const script = document.createElement('script');
+script.src = ${JSON.stringify(TAILWIND_CDN_SRC)};
+script.integrity = ${JSON.stringify(TAILWIND_CDN_INTEGRITY)};
+script.crossOrigin = 'anonymous';
+
+const theme = document.createElement('style');
+theme.type = 'text/tailwindcss';
+theme.textContent = ${JSON.stringify(themeCss)};
+
+document.head.prepend(script, theme);
+`;
+}

package/resolve-vite-config.d.ts

@@ -0,0 +1,7 @@
+import { type UserConfig } from 'vite';
+declare const ALLOWED_VITE_KEYS: readonly ["root", "resolve", "optimizeDeps", "css", "define", "ssr"];
+export type AllowedViteConfig = Pick<UserConfig, (typeof ALLOWED_VITE_KEYS)[number]>;
+export declare const SANDBOX_WATCH_IGNORES: string[];
+export declare function resolveViteConfig(platformConfig: UserConfig, overrides: AllowedViteConfig | undefined): UserConfig;
+export {};
+//# sourceMappingURL=resolve-vite-config.d.ts.map

package/resolve-vite-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-vite-config.d.ts","sourceRoot":"","sources":["../src/resolve-vite-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAGpD,QAAA,MAAM,iBAAiB,sEAAuE,CAAC;AAE/F,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAErF,eAAO,MAAM,qBAAqB,UAAsD,CAAC;AAEzF,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,GAAG,SAAS,GAAG,UAAU,CAElH"}

package/resolve-vite-config.js

@@ -0,0 +1,23 @@
+import { mergeConfig } from 'vite';
+import { emit } from './sandbox-log.js';
+const ALLOWED_VITE_KEYS = ['root', 'resolve', 'optimizeDeps', 'css', 'define', 'ssr'];
+export const SANDBOX_WATCH_IGNORES = ['**/.sc/**', '**/vite-ignore/**', '**/.output/**'];
+export function resolveViteConfig(platformConfig, overrides) {
+    return mergeConfig(platformConfig, pickAllowedViteConfig(overrides));
+}
+function pickAllowedViteConfig(overrides) {
+    const entries = Object.entries(overrides ?? {});
+    const allowedKeys = new Set(ALLOWED_VITE_KEYS);
+    for (const [key] of entries) {
+        if (!allowedKeys.has(key)) {
+            emit({
+                ts: Date.now(),
+                level: 'warn',
+                source: 'devserver',
+                event: 'vite-config-override-ignored',
+                message: `Ignored sandbox Vite override "vite.${key}"`,
+            });
+        }
+    }
+    return Object.fromEntries(entries.filter(([key]) => allowedKeys.has(key)));
+}

package/sandbox-log.d.ts

@@ -0,0 +1,4 @@
+import { type SandboxLogRecord } from '@sticklightapp/sandbox-logger';
+export declare function emit(record: SandboxLogRecord): void;
+export declare function captureConsoleErrors(): void;
+//# sourceMappingURL=sandbox-log.d.ts.map

package/sandbox-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-log.d.ts","sourceRoot":"","sources":["../src/sandbox-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,gBAAgB,EAAyB,MAAM,+BAA+B,CAAC;AAO5I,wBAAgB,IAAI,CAAC,MAAM,EAAE,gBAAgB,QAI5C;AAID,wBAAgB,oBAAoB,SAgBnC"}

package/sandbox-log.js

@@ -0,0 +1,36 @@
+import { buildRecord, createSandboxLogger, writeRecord } from '@sticklightapp/sandbox-logger';
+// Every record written here conforms to SandboxLogRecord (@sticklightapp/sandbox-logger). Consumers read
+// the schema, never this package — see the sandbox-logger README before changing what is emitted.
+let sink;
+let isCapturingConsoleErrors = false;
+export function emit(record) {
+    sink ??= createSandboxLogger();
+    writeRecord(sink, record);
+}
+// Fallback only: plugins and dependencies that bypass Vite's logger and write straight to the
+// console. Vite's own errors take the customLogger path, where the fields are still intact.
+export function captureConsoleErrors() {
+    if (isCapturingConsoleErrors) {
+        return;
+    }
+    isCapturingConsoleErrors = true;
+    console.error = (...args) => {
+        const error = args.find((arg) => arg instanceof Error);
+        const message = args
+            .filter((arg) => arg !== error)
+            .map(formatConsoleArg)
+            .join(' ');
+        emit(buildRecord('error', message || (error?.message ?? ''), error ? { error } : undefined));
+    };
+}
+function formatConsoleArg(arg) {
+    if (typeof arg !== 'object' || arg === null) {
+        return String(arg);
+    }
+    try {
+        return JSON.stringify(arg);
+    }
+    catch {
+        return String(arg);
+    }
+}

package/vite-client.d.ts

@@ -0,0 +1,6 @@
+export declare function isViteClient(environment: {
+    name: string;
+} | undefined, id: string): boolean;
+export declare function warnIfViteClientMissing(root: string): void;
+export declare function appendDynamicImport(code: string, specifier: string): string;
+//# sourceMappingURL=vite-client.d.ts.map

package/vite-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-client.d.ts","sourceRoot":"","sources":["../src/vite-client.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3F;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,QAYnD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI3E"}

package/vite-client.js

@@ -0,0 +1,29 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { emit } from './sandbox-log.js';
+// TanStack Start renders the document itself and never calls transformIndexHtml. Every dev page loads
+// Vite's HMR client, so dev-only browser modules are imported from it instead. The imports are dynamic
+// so a failing module cannot break HMR. Failures are logged with console.warn, because the dev-scripts
+// injector reports unhandled rejections to the agent as project errors.
+const VITE_CLIENT_SPECIFIER = 'vite/dist/client/client.mjs';
+export function isViteClient(environment, id) {
+    return environment?.name === 'client' && id.includes(`/${VITE_CLIENT_SPECIFIER}`);
+}
+export function warnIfViteClientMissing(root) {
+    try {
+        createRequire(path.join(root, 'package.json')).resolve(VITE_CLIENT_SPECIFIER);
+    }
+    catch {
+        emit({
+            ts: Date.now(),
+            level: 'warn',
+            source: 'devserver',
+            event: 'vite-client-missing',
+            message: `${VITE_CLIENT_SPECIFIER} not found, Tailwind CDN and dev tools will not be injected`,
+        });
+    }
+}
+export function appendDynamicImport(code, specifier) {
+    const failureMessage = `[sandbox] Failed to load ${specifier}`;
+    return `${code}\nimport(${JSON.stringify(specifier)}).catch((error) => console.warn(${JSON.stringify(failureMessage)}, error));\n`;
+}