@vizhub/runtime 4.1.0 → 4.3.0

package/README.md

@@ -28,7 +28,7 @@ The library automatically detects which runtime version to use based on the file
 | **React JSX**           | ⬜️     | ✅     | ⬜️     | ✅     |
 | **Svelte**              | ⬜️     | ⬜️     | ✅     | ⬜️     |
 | **Cross-Viz Imports**   | ⬜️     | ⬜️     | ✅     | ⬜️     |
-| **Hot Reloading**       | ⬜️     | ⬜️     | ✅     | ⬜️     |
+| **Hot Reloading**       | ⬜️     | ⬜️     | ✅     | ✅     |
 | **State Management**    | ⬜️     | ⬜️     | ✅     | ⬜️     |
 | **Import from CSV**     | ⬜️     | ⬜️     | ✅     | ⬜️     |
 | **TypeScript**          | ⬜️     | ⬜️     | ⬜️     | ✅     |
@@ -304,18 +304,35 @@ V4 is ideal for modern browsers with native ES module support, TypeScript develo
 - Import maps for direct CDN dependencies
 - Native ES modules without bundling
 - Local module imports with relative paths
+- Hot reloading for fast development iteration
+
+### V4 Hot Reloading
+
+V4 runtime supports hot reloading similar to V3, allowing for rapid development cycles without full page refreshes. When `enableHotReloading` is set to `true`, the V4 runtime:
+
+- Monitors code changes and re-bundles ES modules
+- Sends updated JavaScript to the iframe via `runJS` messages
+- Replaces existing module script tags with updated bundled code
+- Preserves the current browser state where possible
+
+The hot reloading system works by:
+
+1. Bundling ES modules using Rollup (similar to V3)
+2. Injecting a hot reload script that listens for update messages
+3. Replacing module scripts dynamically when code changes
+4. Re-executing the updated modules in the current context
+
+Unlike V3's built-in state management, V4 hot reloading relies on the application's own state management (e.g., React state, DOM state) to preserve state between updates.
 
 ## Key Features
 
 - **Multi-Version Runtime Support**
-
   - **v1**: Simple HTML execution with fetch proxying
   - **v2**: JavaScript bundling with Rollup, JSX support, and CDN-based dependency resolution
   - **v3**: Advanced module bundling with Svelte support and cross-viz imports
   - **v4**: Modern ES Modules with import maps for direct browser execution
 
 - **Comprehensive Tooling**
-
   - **Bundling**: Seamless integration with Rollup for module bundling
   - **Transpilation**: Support for JSX (v2) and Svelte components (v3)
   - **Dependency Management**: Automatic resolution via CDNs (jsDelivr/unpkg)

package/dist/build/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/build/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAGL,SAAS,EACT,cAAc,EAEd,QAAQ,EACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAUtC,eAAO,MAAM,KAAK,GAAU,oFAQzB;IAGD,KAAK,CAAC,EAAE,cAAc,CAAC;IAGvB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAQ1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAI1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAGpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACnD,KAAG,OAAO,CAAC,WAAW,CAuItB,CAAC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/build/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAGL,SAAS,EACT,cAAc,EAEd,QAAQ,EACT,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAuCtC,eAAO,MAAM,KAAK,GAAU,oFAQzB;IAGD,KAAK,CAAC,EAAE,cAAc,CAAC;IAGvB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAQ1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAI1B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAGpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACnD,KAAG,OAAO,CAAC,WAAW,CAiJtB,CAAC"}