@foldkit/vite-plugin 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @foldkit/vite-plugin
+
+Vite plugin for Foldkit that enables hot module reloading with model preservation.
+
+## Installation
+
+```bash
+npm install -D @foldkit/vite-plugin
+# or
+pnpm add -D @foldkit/vite-plugin
+# or
+yarn add -D @foldkit/vite-plugin
+```
+
+## Usage
+
+Add the plugin to your `vite.config.ts`:
+
+```typescript
+import { foldkit } from '@foldkit/vite-plugin'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [foldkit()],
+})
+```
+
+## What it does
+
+When you save a file during development, the plugin:
+
+1. Preserves your application's current state (model)
+2. Triggers a full page reload
+3. Restores the preserved model after reload
+
+This means you can make code changes without losing your application's state - forms stay filled, counters keep their values, game positions are maintained, etc.
+
+## How it works
+
+The plugin uses Vite's WebSocket connection to communicate between the dev server and browser:
+
+- **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
+
+Model is preserved across hot reloads but cleared on manual browser refreshes, giving you control over when to reset your app.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+export declare const foldkit: () => Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAKjD,eAAO,MAAM,OAAO,QAAO,MAO1B,CAAA"}

package/dist/index.js

@@ -0,0 +1,27 @@
+let preservedModel = undefined;
+let isHmrReload = false;
+export const foldkit = () => {
+    return {
+        name: 'foldkit-hmr',
+        apply: 'serve',
+        configureServer,
+        handleHotUpdate,
+    };
+};
+const configureServer = (server) => {
+    server.ws.on('foldkit:preserve-model', (model) => {
+        preservedModel = model;
+    });
+    server.ws.on('foldkit:request-model', () => {
+        server.ws.send('foldkit:restore-model', isHmrReload ? preservedModel : undefined);
+        if (!isHmrReload) {
+            preservedModel = undefined;
+        }
+        isHmrReload = false;
+    });
+};
+const handleHotUpdate = ({ server }) => {
+    isHmrReload = true;
+    server.ws.send({ type: 'full-reload' });
+    return [];
+};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@foldkit/vite-plugin",
+  "version": "0.1.0",
+  "description": "Vite plugin for Foldkit hot module reloading with state preservation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist *.tsbuildinfo",
+    "build": "pnpm run clean && tsc -b",
+    "watch": "tsc -b --watch",
+    "typecheck": "tsc -b --noEmit"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vite": "^6.0.3"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "foldkit",
+    "hmr",
+    "hot-reload"
+  ],
+  "author": "Devin Jameson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devinjameson/foldkit.git",
+    "directory": "packages/vite-plugin-foldkit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}