@base44-preview/vite-plugin 0.2.20-pr.27.45bb4b6 → 0.2.20-pr.27.bf4f26c

package/README.md

@@ -44,25 +44,28 @@ The plugin registers four sub-plugins when running in a sandbox (`MODAL_SANDBOX_
 1. **base44** — Core configuration: path aliases (`@/` → `/src/`), environment variables, dependency optimization, and legacy SDK import resolution.
 2. **iframe-hmr** — Sets CORS and `frame-ancestors` headers to allow iframe embedding.
 3. **error-overlay** — Replaces Vite's default error overlay with a custom one that reports errors to the parent window.
-4. **html-injections** — Injects the sandbox bridge script into the HTML.
+4. **html-injections** — Injects sandbox-side scripts into the HTML.
 
 Outside a sandbox, only the core plugin runs (with optional API proxy support via `VITE_BASE44_APP_BASE_URL`).
 
-### Sandbox Bridge
+### Sandbox Injections
 
-The bridge (`src/bridge.ts`) is a single ES module that consolidates all sandbox-side features. Instead of injecting multiple individual `<script>` tags, the HTML injections plugin injects one inline script that dynamically imports the bridge and calls `init()` with the configured options.
+In **dev mode**, individual `<script type="module" src="...">` tags are injected for each feature, loaded directly from `node_modules`:
 
-The bridge conditionally sets up:
+- **Error handlers** (`unhandled-errors-handlers.js`) — Global `error` and `unhandledrejection` listeners that report to the parent via `postMessage`.
+- **Mount observer** (`sandbox-mount-observer.js`) — `MutationObserver` that detects when instrumented elements (`data-source-location`) are rendered.
+- **HMR notifier** (`sandbox-hmr-notifier.js`) — Forwards Vite's `beforeUpdate`/`afterUpdate` events to the parent.
+- **Navigation notifier** (`navigation-notifier.js`) — Intercepts `pushState`, `replaceState`, and `popstate` to track URL changes.
 
-- **Error handlers** — Global `error` and `unhandledrejection` listeners that report to the parent via `postMessage`.
-- **Mount observer** — `MutationObserver` that detects when instrumented elements (`data-source-location`) are rendered.
-- **HMR notifier** — Forwards Vite's `beforeUpdate`/`afterUpdate` events to the parent.
-- **Navigation notifier** — Intercepts `pushState`, `replaceState`, and `popstate` to track URL changes.
-- **Visual edit agent** — Overlay system for selecting and editing elements with source location awareness.
+These are self-executing scripts — they run as soon as the browser loads them, with no setup call required.
 
-### Local Development
+The **visual edit agent** is the exception. It's a larger module (~560 lines) that is bundled separately via `tsup` into `dist/statics/index.mjs` and loaded via a dynamic `import()`. This allows local dev iteration: add `?sandbox-bridge=local` to load it from a local HTTPS dev server instead of `node_modules`.
 
-For developing the bridge itself, you can load it from a local dev server instead of the installed package:
+In **production**, an inline analytics tracker script is injected instead.
+
+### Local Development (Visual Edit Agent)
+
+To iterate on the visual edit agent locally without publishing:
 
 1. Generate local HTTPS certificates:
    ```bash
@@ -75,7 +78,7 @@ For developing the bridge itself, you can load it from a local dev server instea
    npm run dev -- -w # same, with auto-rebuild on changes
    ```
 
-3. Add `?sandbox-bridge=local` to your app's URL to load the bridge from `localhost:3201` instead of `node_modules`.
+3. Add `?sandbox-bridge=local` to your app's URL to load the agent from `localhost:3201` instead of `node_modules`.
 
 ### Legacy SDK Compatibility
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/vite-plugin",
-  "version": "0.2.20-pr.27.45bb4b6",
+  "version": "0.2.20-pr.27.bf4f26c",
   "description": "The Vite plugin for base44 based applications",
   "type": "module",
   "license": "MIT",