@foldkit/vite-plugin 0.20.2-canary.af3250ec30c5 → 0.20.2-canary.b950c054bbe3

package/README.md

@@ -1,6 +1,6 @@
 # @foldkit/vite-plugin
 
-Vite plugin for Foldkit: view identity branding for the differ, plus hot module reloading with Model preservation.
+Vite plugin for Foldkit: view identity branding for the differ, plus state-preserving live reload.
 
 ## Installation
 
@@ -34,7 +34,7 @@ This plugin supplies that identity. At build time, in dev and production alike,
 
 Foldkit core modules are never instrumented, and functions that never return vnodes are wrapped inertly. Builds without this plugin fall back to positional matching plus keys, where branch points need hand-written keys.
 
-## Hot module reloading
+## State-preserving live reload
 
 When you save a file during development, the plugin:
 
@@ -51,7 +51,7 @@ The plugin uses Vite's WebSocket connection to communicate between the dev serve
 - **On file change**: The browser sends the current Model to the Vite server for preservation.
 - **On reload**: The browser requests the preserved Model from the server and initializes the Foldkit Runtime with it.
 
-The Model survives hot reloads but clears on a manual browser refresh, so a refresh still resets the application.
+The Model survives development reloads but clears on a manual browser refresh, so a refresh still resets the application.
 
 ## Server rendering dev host
 

package/dist/index.js

@@ -1,6 +1,6 @@
 import { Array, Console, Data, Duration, Effect, Exit, Fiber, HashMap, HashSet, Match, Option, Predicate, Queue, Ref, Schedule, Schema, Stream, pipe, } from 'effect';
 import { Event as DevToolsEvent, EventFrame, RequestFrame, Response, ResponseFrame, } from 'foldkit/devtools-protocol';
-import { PreserveModelMessage, RequestModelMessage, RestoreModelMessage, } from 'foldkit/hmr-protocol';
+import { PreserveModelMessage, RequestModelMessage, RestoreModelMessage, } from 'foldkit/model-preservation';
 import { createRequire } from 'node:module';
 import { resolve } from 'node:path';
 import { WebSocketServer } from 'ws';
@@ -115,26 +115,26 @@ const makeState = Effect.gen(function* () {
 const encodeResponseFrameJson = Schema.encodeUnknownSync(Schema.fromJsonString(ResponseFrame));
 // HANDLERS
 const handlePreserveModelReceived = (state, payload) => Exit.match(Schema.decodeUnknownExit(PreserveModelMessage)(payload), {
-    onFailure: error => Console.warn('[foldkit:hmr] failed to decode preserve-model payload', error),
-    onSuccess: ({ id, model, isHmrReload }) => Ref.update(state.preservedModels, current => {
-        const existingFlag = Option.exists(HashMap.get(current, id), ({ isHmrReload }) => isHmrReload);
+    onFailure: error => Console.warn('[foldkit:preserve] failed to decode preserve-model payload', error),
+    onSuccess: ({ id, model, isReloadFlush }) => Ref.update(state.preservedModels, current => {
+        const existingFlag = Option.exists(HashMap.get(current, id), ({ isReloadFlush }) => isReloadFlush);
         const entry = {
             model,
-            isHmrReload: isHmrReload === true || existingFlag,
+            isReloadFlush: isReloadFlush === true || existingFlag,
         };
         return HashMap.set(current, id, entry);
     }),
 });
 const handleRequestModelReceived = (server, state, payload) => Exit.match(Schema.decodeUnknownExit(RequestModelMessage)(payload), {
-    onFailure: error => Console.warn('[foldkit:hmr] failed to decode request-model payload', error),
+    onFailure: error => Console.warn('[foldkit:preserve] failed to decode request-model payload', error),
     onSuccess: ({ id }) => Effect.gen(function* () {
         const current = yield* Ref.get(state.preservedModels);
         const sendRestore = (model) => Effect.sync(() => server.ws.send('foldkit:restore-model', Schema.encodeUnknownSync(RestoreModelMessage)(RestoreModelMessage.make({ id, model }))));
         yield* Option.match(HashMap.get(current, id), {
             onNone: () => sendRestore(undefined),
             onSome: entry => {
-                if (entry.isHmrReload) {
-                    const served = { ...entry, isHmrReload: false };
+                if (entry.isReloadFlush) {
+                    const served = { ...entry, isReloadFlush: false };
                     return Ref.update(state.preservedModels, HashMap.set(id, served)).pipe(Effect.flatMap(() => sendRestore(entry.model)));
                 }
                 return Ref.update(state.preservedModels, HashMap.remove(id)).pipe(Effect.flatMap(() => sendRestore(undefined)));
@@ -142,7 +142,7 @@ const handleRequestModelReceived = (server, state, payload) => Exit.match(Schema
         });
     }),
 });
-const handleHotUpdateFired = (state) => Ref.update(state.preservedModels, current => HashMap.map(current, entry => ({ ...entry, isHmrReload: true })));
+const handleHotUpdateFired = (state) => Ref.update(state.preservedModels, current => HashMap.map(current, entry => ({ ...entry, isReloadFlush: true })));
 const handleBrowserEventFrameReceived = (state, data, client) => Exit.match(Schema.decodeUnknownExit(EventFrame)(data), {
     onFailure: error => Console.warn('[foldkit:devTools] failed to decode browser event frame', error),
     onSuccess: frame => DevToolsEvent.match(frame.event, {
@@ -316,7 +316,7 @@ const main = (server, events, options) => Effect.gen(function* () {
     };
     yield* registerViteWsHandlers(server, state, enqueue);
     // NOTE: Forked rather than awaited because binding the relay can retry for
-    // seconds. The HMR bridge is independent of the relay, and the runtime
+    // seconds. Model preservation is independent of the relay, and the runtime
     // gives up on its boot-time model request in well under a second, so
     // sequencing the dispatch loop behind the bind would cost model
     // preservation whenever the port is contended.
@@ -328,8 +328,8 @@ const main = (server, events, options) => Effect.gen(function* () {
 // PLUGIN ENTRY
 /**
  * Foldkit's Vite plugin set: the view-identity branding transform and
- * DevTools overlay injection (dev and build), plus the HMR bridge with state
- * preservation and the optional DevTools MCP relay (dev only). Returned as
+ * DevTools overlay injection (dev and build), plus Model preservation across
+ * reloads and the optional DevTools MCP relay (dev only). Returned as
  * an array; Vite flattens nested plugin arrays, so `plugins: [foldkit()]`
  * keeps working.
  */
@@ -371,8 +371,8 @@ export const foldkit = (options = {}) => {
             return Fiber.interrupt(fiber);
         }
     });
-    const hmrPlugin = {
-        name: 'foldkit-hmr',
+    const reloadPlugin = {
+        name: 'foldkit',
         apply: 'serve',
         config: userConfig => ({
             optimizeDeps: {
@@ -406,7 +406,7 @@ export const foldkit = (options = {}) => {
         foldkitBuildToken(options.buildId),
         foldkitViewIdentity(),
         devToolsOverlayPlugin(),
-        hmrPlugin,
+        reloadPlugin,
     ];
     if (options.ssr === undefined) {
         return shared;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@foldkit/vite-plugin",
-  "version": "0.20.2-canary.af3250ec30c5",
-  "description": "Vite plugin for Foldkit hot module reloading with state preservation",
+  "version": "0.20.2-canary.b950c054bbe3",
+  "description": "Vite plugin for Foldkit with state-preserving live reload",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "peerDependencies": {
     "effect": "4.0.0-rc.112",
-    "foldkit": "0.158.2-canary.af3250ec30c5",
+    "foldkit": "0.158.2-canary.b950c054bbe3",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "dependencies": {
@@ -34,14 +34,14 @@
     "vite": "^8.2.2",
     "vite7": "npm:vite@^7.3.6",
     "vitest": "^4.1.11",
-    "foldkit": "0.158.2-canary.af3250ec30c5"
+    "foldkit": "0.158.2-canary.b950c054bbe3"
   },
   "keywords": [
     "vite",
     "vite-plugin",
     "foldkit",
-    "hmr",
-    "hot-reload"
+    "live-reload",
+    "state-preservation"
   ],
   "author": "Devin Jameson",
   "license": "MIT",