chore: add yalc for local package linking and development workflow

Author: ahnv

.gitignore

@@ -20,4 +20,6 @@ packages/imagekit-editor/*.tgz
 builds
 packages/imagekit-editor/README.md
 .cursor
-coverage
+coverage
+.yalc
+yalc.lock

DEVELOPMENT.md

@@ -0,0 +1,67 @@
+# Development
+
+## Prerequisites
+
+- Node.js v20 (use `nvm use`)
+- Yarn 4 (via Corepack)
+- [yalc](https://github.com/wclr/yalc) (included as a devDependency)
+
+## Getting Started
+
+```bash
+nvm use
+yarn install
+yarn dev
+```
+
+`yarn dev` runs vite in watch mode and **automatically publishes `@imagekit/editor` to the local yalc store** on every rebuild.
+
+## Linking to External Projects
+
+Use yalc to test `@imagekit/editor` in any project outside this monorepo:
+
+### 1. Start dev mode (this repo)
+
+```bash
+yarn dev
+```
+
+This watches for source changes, rebuilds, and runs `yalc publish --push` automatically after each build.
+
+### 2. Install yalc globally (required for consuming projects)
+
+```bash
+npm i -g yalc
+```
+
+### 3. Link in your consuming project
+
+```bash
+# In your external project directory
+yalc link @imagekit/editor
+```
+
+This creates a symlink to the yalc store. Every time the editor rebuilds, your project receives the update automatically via `--push`.
+
+### 4. Remove the link when done
+
+```bash
+# In your external project directory
+yalc remove @imagekit/editor
+```
+
+## Build
+
+```bash
+yarn build
+```
+
+Produces the production bundle in `packages/imagekit-editor/dist/`.
+
+## Package
+
+```bash
+yarn package
+```
+
+Creates a `.tgz` tarball in `builds/` for manual distribution or testing.

package.json

@@ -40,7 +40,8 @@
     "lint-staged": "^16.1.2",
     "shx": "^0.4.0",
     "turbo": "^2.0.1",
-    "vitest": "^2.1.9"
+    "vitest": "^2.1.9",
+    "yalc": "^1.0.0-pre.53"
   },
   "packageManager": "yarn@4.9.2",
   "lint-staged": {

packages/imagekit-editor-dev/vite.config.ts

@@ -1,8 +1,26 @@
+import { execSync } from "node:child_process"
 import * as path from "node:path"
 import react from "@vitejs/plugin-react"
-import { defineConfig } from "vite"
+import { defineConfig, type Plugin } from "vite"
 import dts from "vite-plugin-dts"
 
+function yalcPublish(): Plugin {
+  const editorPkgDir = path.resolve(__dirname, "../imagekit-editor")
+  return {
+    name: "vite-plugin-yalc-publish",
+    closeBundle() {
+      try {
+        execSync("yalc publish --push --changed", {
+          cwd: editorPkgDir,
+          stdio: "inherit",
+        })
+      } catch (e) {
+        console.error("[yalc] publish failed:", e)
+      }
+    },
+  }
+}
+
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
@@ -15,6 +33,7 @@ export default defineConfig({
       exclude: ["node_modules", "lib"],
       outDir: "../imagekit-editor/dist/types",
     }),
+    yalcPublish(),
   ],
   test: {
     globals: true,