@aaqiljamal/visual-editor-next 0.2.0

package/bin/visual-editor-init.cjs

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+"use strict";
+const fs = require("node:fs");
+const path = require("node:path");
+
+const cwd = process.cwd();
+const args = process.argv.slice(2);
+const dryRun = args.includes("--dry-run") || args.includes("-n");
+const force = args.includes("--force") || args.includes("-f");
+
+const ok = (s) => process.stdout.write(`  ✓ ${s}\n`);
+const note = (s) => process.stdout.write(`  · ${s}\n`);
+const warn = (s) => process.stdout.write(`  ⚠ ${s}\n`);
+const fail = (s) => {
+  process.stderr.write(`\n  ✗ ${s}\n\n`);
+  process.exit(1);
+};
+
+const wouldWrite = (label) =>
+  process.stdout.write(`  ${dryRun ? "·" : "✓"} ${dryRun ? "would write " : ""}${label}\n`);
+
+process.stdout.write(
+  `\nInitializing visual-editor in ${cwd}${dryRun ? " (dry run)" : ""}\n\n`,
+);
+
+// ---------------------------------------------------------------------------
+// Pre-flight
+// ---------------------------------------------------------------------------
+
+const pkgPath = path.join(cwd, "package.json");
+if (!fs.existsSync(pkgPath)) {
+  fail(
+    "No package.json in current directory. Run this in your Next.js project root.",
+  );
+}
+
+let pkg;
+try {
+  pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+} catch (err) {
+  fail(`package.json is not valid JSON: ${err.message}`);
+}
+
+const allDeps = Object.assign(
+  {},
+  pkg.dependencies || {},
+  pkg.devDependencies || {},
+);
+if (!allDeps.next) {
+  fail(
+    "This project doesn't declare a Next.js dependency. visual-editor only " +
+      "supports Next.js App Router projects (see docs for Vite/Remix flow).",
+  );
+}
+
+const appDir = path.join(cwd, "app");
+const srcAppDir = path.join(cwd, "src", "app");
+const pagesDir = path.join(cwd, "pages");
+const srcPagesDir = path.join(cwd, "src", "pages");
+
+const hasAppRouter = fs.existsSync(appDir) || fs.existsSync(srcAppDir);
+const hasPagesRouter = fs.existsSync(pagesDir) || fs.existsSync(srcPagesDir);
+
+if (!hasAppRouter && !force) {
+  fail(
+    "No `app/` (or `src/app/`) directory found. visual-editor requires the " +
+      "App Router. If this is a Pages Router project, visual-editor doesn't " +
+      "support it yet. Use --force to proceed anyway.",
+  );
+}
+
+if (hasPagesRouter && !force) {
+  warn(
+    "Detected a `pages/` directory alongside `app/`. visual-editor's Route " +
+      "Handler will only fire for App Router routes. Pages Router-rendered " +
+      "elements will be visible to the overlay but Apply may behave oddly. " +
+      "Use --force to suppress this warning.",
+  );
+}
+
+// Detect whether `app/` lives at root or under src/
+const appRoot = fs.existsSync(srcAppDir) ? srcAppDir : appDir;
+
+process.stdout.write("\nProject looks like a Next.js App Router app. Proceeding.\n\n");
+
+// ---------------------------------------------------------------------------
+// 1. app/api/visual-editor/[...path]/route.ts
+// ---------------------------------------------------------------------------
+
+{
+  const routeDir = path.join(appRoot, "api", "visual-editor", "[...path]");
+  const routeFile = path.join(routeDir, "route.ts");
+  if (fs.existsSync(routeFile)) {
+    note(`route.ts exists at ${path.relative(cwd, routeFile)} — leaving it alone`);
+  } else {
+    if (!dryRun) {
+      fs.mkdirSync(routeDir, { recursive: true });
+      fs.writeFileSync(
+        routeFile,
+        'export { GET, POST, DELETE } from "@aaqiljamal/visual-editor-next/route";\n',
+      );
+    }
+    wouldWrite(path.relative(cwd, routeFile));
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 2. babel.config.js — guard SWC users
+// ---------------------------------------------------------------------------
+
+{
+  const babelFile = path.join(cwd, "babel.config.js");
+  if (fs.existsSync(babelFile)) {
+    const current = fs.readFileSync(babelFile, "utf8");
+    if (current.includes("@aaqiljamal/visual-editor-babel-plugin")) {
+      note("babel.config.js already references the plugin");
+    } else {
+      warn(
+        "babel.config.js exists with other config. Add this to its `plugins` array manually:",
+      );
+      process.stdout.write('       "@aaqiljamal/visual-editor-babel-plugin"\n');
+    }
+  } else {
+    warn(
+      "Writing babel.config.js — this opts your project out of SWC for builds. " +
+        "Dev builds will be slightly slower. Visual-edit needs this to stamp " +
+        "data-oid attributes on JSX. (You can revert by deleting this file.)",
+    );
+    if (!dryRun) {
+      fs.writeFileSync(
+        babelFile,
+        'module.exports = {\n' +
+          '  presets: ["next/babel"],\n' +
+          '  plugins: ["@aaqiljamal/visual-editor-babel-plugin"],\n' +
+          '};\n',
+      );
+    }
+    wouldWrite("babel.config.js");
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 3. .gitignore
+// ---------------------------------------------------------------------------
+
+{
+  const giFile = path.join(cwd, ".gitignore");
+  const entry = "/.visual-editor/";
+  if (fs.existsSync(giFile)) {
+    const current = fs.readFileSync(giFile, "utf8");
+    if (current.split("\n").some((l) => l.trim() === entry)) {
+      note(".gitignore already has /.visual-editor/");
+    } else {
+      if (!dryRun) {
+        fs.appendFileSync(
+          giFile,
+          (current.endsWith("\n") ? "" : "\n") +
+            "\n# visual-editor local state\n" +
+            entry +
+            "\n",
+        );
+      }
+      wouldWrite("added /.visual-editor/ to .gitignore");
+    }
+  } else {
+    if (!dryRun) {
+      fs.writeFileSync(giFile, "# visual-editor local state\n" + entry + "\n");
+    }
+    wouldWrite(".gitignore");
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 4. Manual step
+// ---------------------------------------------------------------------------
+
+const layoutPath = path.join(appRoot, "layout.tsx");
+const layoutRel = fs.existsSync(layoutPath)
+  ? path.relative(cwd, layoutPath)
+  : "app/layout.tsx";
+
+process.stdout.write(
+  `\nManual step — mount the overlay in ${layoutRel}:\n\n` +
+    '  import { VisualEditOverlay } from "@aaqiljamal/visual-editor-next";\n\n' +
+    "  export default function RootLayout({ children }) {\n" +
+    "    return (\n" +
+    '      <html>\n' +
+    "        <body>\n" +
+    "          {children}\n" +
+    '          {process.env.NODE_ENV === "development" && <VisualEditOverlay />}\n' +
+    "        </body>\n" +
+    "      </html>\n" +
+    "    );\n" +
+    "  }\n\n" +
+    "Then:  npm run dev  →  open your browser  →  click any element.\n\n",
+);
+
+if (dryRun) {
+  process.stdout.write("(dry run — no files were written)\n\n");
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { VisualEditOverlay } from '@aaqiljamal/visual-editor-runtime';

package/dist/index.js

@@ -0,0 +1,8 @@
+"use client";
+
+// src/index.tsx
+import { VisualEditOverlay } from "@aaqiljamal/visual-editor-runtime";
+export {
+  VisualEditOverlay
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.tsx"],"sourcesContent":["// Public surface of @aaqiljamal/visual-editor-next.\n//\n// For users:\n//   import { VisualEditOverlay } from \"@aaqiljamal/visual-editor-next\";\n//   export { GET, POST, DELETE } from \"@aaqiljamal/visual-editor-next/route\";\n//\n// One package = overlay + route handler + Babel plugin (transitive).\n// The separate `visual-editor-server` CLI is still available via\n// @aaqiljamal/visual-editor-server but isn't needed in this setup.\n\nexport { VisualEditOverlay } from \"@aaqiljamal/visual-editor-runtime\";\n"],"mappings":";;;AAUA,SAAS,yBAAyB;","names":[]}

package/dist/route.d.ts

@@ -0,0 +1,17 @@
+declare function GET(req: Request, context: {
+    params: Promise<{
+        path?: string[];
+    }>;
+}): Promise<Response>;
+declare function POST(req: Request, context: {
+    params: Promise<{
+        path?: string[];
+    }>;
+}): Promise<Response>;
+declare function DELETE(req: Request, context: {
+    params: Promise<{
+        path?: string[];
+    }>;
+}): Promise<Response>;
+
+export { DELETE, GET, POST };

package/dist/route.js

@@ -0,0 +1,251 @@
+// src/route.ts
+import * as path from "path";
+import {
+  applyToFile,
+  revertToFile,
+  applyCssProperty,
+  applyStyledProperty,
+  RecentApplies,
+  CurrentSelection
+} from "@aaqiljamal/visual-editor-server";
+var recentApplies = new RecentApplies();
+var currentSelection = new CurrentSelection();
+var stateLoaded = false;
+async function ensureStateLoaded() {
+  const workspaceRoot = process.cwd();
+  if (!stateLoaded) {
+    await recentApplies.load(
+      path.join(workspaceRoot, ".visual-editor", "history.json")
+    );
+    stateLoaded = true;
+  }
+  return workspaceRoot;
+}
+function isDev() {
+  return process.env.NODE_ENV !== "production";
+}
+function devOnlyOrJson() {
+  if (!isDev()) {
+    return new Response("Not available in production", { status: 404 });
+  }
+  return null;
+}
+function json(status, body) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function endpointFromPath(pathSegments) {
+  return "/" + (pathSegments ?? []).join("/");
+}
+async function GET(req, context) {
+  const dev = devOnlyOrJson();
+  if (dev) return dev;
+  const workspaceRoot = await ensureStateLoaded();
+  const { path: parts } = await context.params;
+  const endpoint = endpointFromPath(parts);
+  if (endpoint === "/health") {
+    return json(200, { ok: true, mode: "next-route-handler" });
+  }
+  if (endpoint === "/token") {
+    return json(200, { token: null });
+  }
+  if (endpoint === "/selection") {
+    return json(200, { ok: true, selection: currentSelection.get() });
+  }
+  if (endpoint === "/recent") {
+    return json(200, { ok: true, applies: recentApplies.list() });
+  }
+  if (endpoint === "/assets") {
+    return await handleAssets(workspaceRoot);
+  }
+  return json(404, {
+    ok: false,
+    reason: "not-found",
+    details: `GET ${endpoint}`
+  });
+}
+async function POST(req, context) {
+  const dev = devOnlyOrJson();
+  if (dev) return dev;
+  const workspaceRoot = await ensureStateLoaded();
+  const { path: parts } = await context.params;
+  const endpoint = endpointFromPath(parts);
+  let body;
+  try {
+    body = await req.json();
+  } catch (err) {
+    return json(400, {
+      ok: false,
+      reason: "invalid-json",
+      details: err.message
+    });
+  }
+  if (endpoint === "/apply") {
+    return await handleMutation(body, workspaceRoot, false);
+  }
+  if (endpoint === "/propose") {
+    return await handleMutation(body, workspaceRoot, true);
+  }
+  if (endpoint === "/revert") {
+    const outcome = await revertToFile(
+      body,
+      { workspaceRoot, dryRun: false },
+      recentApplies
+    );
+    if (outcome.ok) return json(200, { ok: true, diff: outcome.diff });
+    return json(outcome.status, {
+      ok: false,
+      reason: outcome.reason,
+      details: outcome.details
+    });
+  }
+  if (endpoint === "/apply-css-prop") {
+    const outcome = await applyCssProperty(body, {
+      workspaceRoot,
+      dryRun: false
+    });
+    if (outcome.ok) {
+      return json(200, {
+        ok: true,
+        diff: outcome.diff,
+        selector: outcome.selector,
+        previousValue: outcome.previousValue
+      });
+    }
+    return json(outcome.status, {
+      ok: false,
+      reason: outcome.reason,
+      details: outcome.details
+    });
+  }
+  if (endpoint === "/apply-styled-prop") {
+    const outcome = await applyStyledProperty(
+      body,
+      { workspaceRoot, dryRun: false }
+    );
+    if (outcome.ok) {
+      return json(200, {
+        ok: true,
+        diff: outcome.diff,
+        componentName: outcome.componentName,
+        previousValue: outcome.previousValue
+      });
+    }
+    return json(outcome.status, {
+      ok: false,
+      reason: outcome.reason,
+      details: outcome.details
+    });
+  }
+  if (endpoint === "/selection") {
+    if (!isValidSelection(body)) {
+      return json(400, {
+        ok: false,
+        reason: "invalid-input",
+        details: "Body must be { file, line, col, oid, className, tagName, componentName, instanceCount }"
+      });
+    }
+    currentSelection.set(body);
+    return json(200, { ok: true });
+  }
+  return json(404, {
+    ok: false,
+    reason: "not-found",
+    details: `POST ${endpoint}`
+  });
+}
+async function DELETE(req, context) {
+  const dev = devOnlyOrJson();
+  if (dev) return dev;
+  await ensureStateLoaded();
+  const { path: parts } = await context.params;
+  const endpoint = endpointFromPath(parts);
+  if (endpoint === "/selection") {
+    currentSelection.clear();
+    return json(200, { ok: true });
+  }
+  return json(404, {
+    ok: false,
+    reason: "not-found",
+    details: `DELETE ${endpoint}`
+  });
+}
+async function handleMutation(input, workspaceRoot, dryRun) {
+  const outcome = await applyToFile(input, { workspaceRoot, dryRun });
+  if (outcome.ok) {
+    if (!dryRun) {
+      const beforeForBuffer = outcome.previousValue ?? input.before ?? "";
+      recentApplies.push({
+        file: input.file,
+        line: input.line,
+        col: input.col,
+        before: beforeForBuffer,
+        after: input.after,
+        appliedAt: Date.now()
+      });
+    }
+    return json(200, { ok: true, diff: outcome.diff });
+  }
+  return json(outcome.status, {
+    ok: false,
+    reason: outcome.reason,
+    details: outcome.details
+  });
+}
+async function handleAssets(workspaceRoot) {
+  const fs = await import("fs/promises");
+  const IMAGE_EXTS = /* @__PURE__ */ new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".webp",
+    ".avif"
+  ]);
+  const publicDir = path.join(workspaceRoot, "public");
+  async function walk(dir, rel) {
+    let entries = [];
+    try {
+      entries = await fs.readdir(dir, { withFileTypes: true });
+    } catch {
+      return [];
+    }
+    const out = [];
+    for (const e of entries) {
+      const child = path.join(dir, e.name);
+      const childRel = rel ? `${rel}/${e.name}` : e.name;
+      if (e.isDirectory()) {
+        const sub = await walk(child, childRel);
+        out.push(...sub);
+      } else if (e.isFile() && IMAGE_EXTS.has(path.extname(e.name).toLowerCase())) {
+        out.push(`/${childRel}`);
+      }
+    }
+    return out;
+  }
+  try {
+    const assets = await walk(publicDir, "");
+    assets.sort();
+    return json(200, { ok: true, assets });
+  } catch (err) {
+    return json(500, {
+      ok: false,
+      reason: "assets-list-failed",
+      details: err.message
+    });
+  }
+}
+function isValidSelection(x) {
+  if (!x || typeof x !== "object") return false;
+  const o = x;
+  return typeof o.file === "string" && typeof o.line === "number" && typeof o.col === "number" && typeof o.oid === "string" && typeof o.className === "string" && typeof o.tagName === "string" && (o.componentName === null || typeof o.componentName === "string") && typeof o.instanceCount === "number";
+}
+export {
+  DELETE,
+  GET,
+  POST
+};
+//# sourceMappingURL=route.js.map

package/dist/route.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/route.ts"],"sourcesContent":["/**\n * Web Request handler for visual-editor, mounted as a Next.js catchall\n * Route Handler. Users add ONE file:\n *\n *   app/api/visual-editor/[...path]/route.ts\n *   ──────────────────────────────────────\n *   export { GET, POST, DELETE } from \"@aaqiljamal/visual-editor-next/route\";\n *\n * The AST mutation logic runs in-process with the user's Next dev server.\n * No separate port, no separate process, no CORS dance, no bearer token.\n *\n * In production we 404 every request: visual-editor is dev-only by design.\n */\nimport * as path from \"node:path\";\nimport {\n  applyToFile,\n  type ApplyInput,\n  revertToFile,\n  type RevertInput,\n  applyCssProperty,\n  type ApplyCssPropertyInput,\n  applyStyledProperty,\n  type ApplyStyledPropertyInput,\n  RecentApplies,\n  CurrentSelection,\n  type Selection,\n} from \"@aaqiljamal/visual-editor-server\";\n\n// Module-level state. Survives across Route Handler invocations within\n// the same Next dev server process. RecentApplies persists to disk, so\n// HMR/full restarts don't lose history.\nconst recentApplies = new RecentApplies();\nconst currentSelection = new CurrentSelection();\nlet stateLoaded = false;\n\nasync function ensureStateLoaded(): Promise<string> {\n  const workspaceRoot = process.cwd();\n  if (!stateLoaded) {\n    await recentApplies.load(\n      path.join(workspaceRoot, \".visual-editor\", \"history.json\"),\n    );\n    stateLoaded = true;\n  }\n  return workspaceRoot;\n}\n\nfunction isDev(): boolean {\n  return process.env.NODE_ENV !== \"production\";\n}\n\nfunction devOnlyOrJson(): Response | null {\n  if (!isDev()) {\n    return new Response(\"Not available in production\", { status: 404 });\n  }\n  return null;\n}\n\nfunction json(status: number, body: unknown): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n\nfunction endpointFromPath(pathSegments: string[] | undefined): string {\n  return \"/\" + (pathSegments ?? []).join(\"/\");\n}\n\n// ---------------------------------------------------------------------------\n// GET\n// ---------------------------------------------------------------------------\n\nexport async function GET(\n  req: Request,\n  context: { params: Promise<{ path?: string[] }> },\n): Promise<Response> {\n  const dev = devOnlyOrJson();\n  if (dev) return dev;\n  const workspaceRoot = await ensureStateLoaded();\n  const { path: parts } = await context.params;\n  const endpoint = endpointFromPath(parts);\n\n  if (endpoint === \"/health\") {\n    return json(200, { ok: true, mode: \"next-route-handler\" });\n  }\n  if (endpoint === \"/token\") {\n    // Route Handler is same-origin — no bearer token needed. We respond\n    // 200 with null so the overlay's bootstrap doesn't log a 404.\n    return json(200, { token: null });\n  }\n  if (endpoint === \"/selection\") {\n    return json(200, { ok: true, selection: currentSelection.get() });\n  }\n  if (endpoint === \"/recent\") {\n    return json(200, { ok: true, applies: recentApplies.list() });\n  }\n  if (endpoint === \"/assets\") {\n    return await handleAssets(workspaceRoot);\n  }\n  return json(404, {\n    ok: false,\n    reason: \"not-found\",\n    details: `GET ${endpoint}`,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// POST\n// ---------------------------------------------------------------------------\n\nexport async function POST(\n  req: Request,\n  context: { params: Promise<{ path?: string[] }> },\n): Promise<Response> {\n  const dev = devOnlyOrJson();\n  if (dev) return dev;\n  const workspaceRoot = await ensureStateLoaded();\n  const { path: parts } = await context.params;\n  const endpoint = endpointFromPath(parts);\n\n  let body: unknown;\n  try {\n    body = await req.json();\n  } catch (err) {\n    return json(400, {\n      ok: false,\n      reason: \"invalid-json\",\n      details: (err as Error).message,\n    });\n  }\n\n  if (endpoint === \"/apply\") {\n    return await handleMutation(body as ApplyInput, workspaceRoot, false);\n  }\n  if (endpoint === \"/propose\") {\n    return await handleMutation(body as ApplyInput, workspaceRoot, true);\n  }\n  if (endpoint === \"/revert\") {\n    const outcome = await revertToFile(\n      body as RevertInput,\n      { workspaceRoot, dryRun: false },\n      recentApplies,\n    );\n    if (outcome.ok) return json(200, { ok: true, diff: outcome.diff });\n    return json(outcome.status, {\n      ok: false,\n      reason: outcome.reason,\n      details: outcome.details,\n    });\n  }\n  if (endpoint === \"/apply-css-prop\") {\n    const outcome = await applyCssProperty(body as ApplyCssPropertyInput, {\n      workspaceRoot,\n      dryRun: false,\n    });\n    if (outcome.ok) {\n      return json(200, {\n        ok: true,\n        diff: outcome.diff,\n        selector: outcome.selector,\n        previousValue: outcome.previousValue,\n      });\n    }\n    return json(outcome.status, {\n      ok: false,\n      reason: outcome.reason,\n      details: outcome.details,\n    });\n  }\n  if (endpoint === \"/apply-styled-prop\") {\n    const outcome = await applyStyledProperty(\n      body as ApplyStyledPropertyInput,\n      { workspaceRoot, dryRun: false },\n    );\n    if (outcome.ok) {\n      return json(200, {\n        ok: true,\n        diff: outcome.diff,\n        componentName: outcome.componentName,\n        previousValue: outcome.previousValue,\n      });\n    }\n    return json(outcome.status, {\n      ok: false,\n      reason: outcome.reason,\n      details: outcome.details,\n    });\n  }\n  if (endpoint === \"/selection\") {\n    if (!isValidSelection(body)) {\n      return json(400, {\n        ok: false,\n        reason: \"invalid-input\",\n        details:\n          \"Body must be { file, line, col, oid, className, tagName, componentName, instanceCount }\",\n      });\n    }\n    currentSelection.set(body);\n    return json(200, { ok: true });\n  }\n\n  return json(404, {\n    ok: false,\n    reason: \"not-found\",\n    details: `POST ${endpoint}`,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// DELETE\n// ---------------------------------------------------------------------------\n\nexport async function DELETE(\n  req: Request,\n  context: { params: Promise<{ path?: string[] }> },\n): Promise<Response> {\n  const dev = devOnlyOrJson();\n  if (dev) return dev;\n  await ensureStateLoaded();\n  const { path: parts } = await context.params;\n  const endpoint = endpointFromPath(parts);\n\n  if (endpoint === \"/selection\") {\n    currentSelection.clear();\n    return json(200, { ok: true });\n  }\n  return json(404, {\n    ok: false,\n    reason: \"not-found\",\n    details: `DELETE ${endpoint}`,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nasync function handleMutation(\n  input: ApplyInput,\n  workspaceRoot: string,\n  dryRun: boolean,\n): Promise<Response> {\n  const outcome = await applyToFile(input, { workspaceRoot, dryRun });\n  if (outcome.ok) {\n    if (!dryRun) {\n      const beforeForBuffer =\n        outcome.previousValue ?? input.before ?? \"\";\n      recentApplies.push({\n        file: input.file,\n        line: input.line,\n        col: input.col,\n        before: beforeForBuffer,\n        after: input.after,\n        appliedAt: Date.now(),\n      });\n    }\n    return json(200, { ok: true, diff: outcome.diff });\n  }\n  return json(outcome.status, {\n    ok: false,\n    reason: outcome.reason,\n    details: outcome.details,\n  });\n}\n\nasync function handleAssets(workspaceRoot: string): Promise<Response> {\n  const fs = await import(\"node:fs/promises\");\n  const IMAGE_EXTS = new Set([\n    \".png\",\n    \".jpg\",\n    \".jpeg\",\n    \".gif\",\n    \".svg\",\n    \".webp\",\n    \".avif\",\n  ]);\n  const publicDir = path.join(workspaceRoot, \"public\");\n\n  async function walk(dir: string, rel: string): Promise<string[]> {\n    let entries: import(\"node:fs\").Dirent[] = [];\n    try {\n      entries = await fs.readdir(dir, { withFileTypes: true });\n    } catch {\n      return [];\n    }\n    const out: string[] = [];\n    for (const e of entries) {\n      const child = path.join(dir, e.name);\n      const childRel = rel ? `${rel}/${e.name}` : e.name;\n      if (e.isDirectory()) {\n        const sub = await walk(child, childRel);\n        out.push(...sub);\n      } else if (\n        e.isFile() &&\n        IMAGE_EXTS.has(path.extname(e.name).toLowerCase())\n      ) {\n        out.push(`/${childRel}`);\n      }\n    }\n    return out;\n  }\n\n  try {\n    const assets = await walk(publicDir, \"\");\n    assets.sort();\n    return json(200, { ok: true, assets });\n  } catch (err) {\n    return json(500, {\n      ok: false,\n      reason: \"assets-list-failed\",\n      details: (err as Error).message,\n    });\n  }\n}\n\nfunction isValidSelection(x: unknown): x is Selection {\n  if (!x || typeof x !== \"object\") return false;\n  const o = x as Record<string, unknown>;\n  return (\n    typeof o.file === \"string\" &&\n    typeof o.line === \"number\" &&\n    typeof o.col === \"number\" &&\n    typeof o.oid === \"string\" &&\n    typeof o.className === \"string\" &&\n    typeof o.tagName === \"string\" &&\n    (o.componentName === null || typeof o.componentName === \"string\") &&\n    typeof o.instanceCount === \"number\"\n  );\n}\n"],"mappings":";AAaA,YAAY,UAAU;AACtB;AAAA,EACE;AAAA,EAEA;AAAA,EAEA;AAAA,EAEA;AAAA,EAEA;AAAA,EACA;AAAA,OAEK;AAKP,IAAM,gBAAgB,IAAI,cAAc;AACxC,IAAM,mBAAmB,IAAI,iBAAiB;AAC9C,IAAI,cAAc;AAElB,eAAe,oBAAqC;AAClD,QAAM,gBAAgB,QAAQ,IAAI;AAClC,MAAI,CAAC,aAAa;AAChB,UAAM,cAAc;AAAA,MACb,UAAK,eAAe,kBAAkB,cAAc;AAAA,IAC3D;AACA,kBAAc;AAAA,EAChB;AACA,SAAO;AACT;AAEA,SAAS,QAAiB;AACxB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAEA,SAAS,gBAAiC;AACxC,MAAI,CAAC,MAAM,GAAG;AACZ,WAAO,IAAI,SAAS,+BAA+B,EAAE,QAAQ,IAAI,CAAC;AAAA,EACpE;AACA,SAAO;AACT;AAEA,SAAS,KAAK,QAAgB,MAAyB;AACrD,SAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,IACxC;AAAA,IACA,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,EAChD,CAAC;AACH;AAEA,SAAS,iBAAiB,cAA4C;AACpE,SAAO,OAAO,gBAAgB,CAAC,GAAG,KAAK,GAAG;AAC5C;AAMA,eAAsB,IACpB,KACA,SACmB;AACnB,QAAM,MAAM,cAAc;AAC1B,MAAI,IAAK,QAAO;AAChB,QAAM,gBAAgB,MAAM,kBAAkB;AAC9C,QAAM,EAAE,MAAM,MAAM,IAAI,MAAM,QAAQ;AACtC,QAAM,WAAW,iBAAiB,KAAK;AAEvC,MAAI,aAAa,WAAW;AAC1B,WAAO,KAAK,KAAK,EAAE,IAAI,MAAM,MAAM,qBAAqB,CAAC;AAAA,EAC3D;AACA,MAAI,aAAa,UAAU;AAGzB,WAAO,KAAK,KAAK,EAAE,OAAO,KAAK,CAAC;AAAA,EAClC;AACA,MAAI,aAAa,cAAc;AAC7B,WAAO,KAAK,KAAK,EAAE,IAAI,MAAM,WAAW,iBAAiB,IAAI,EAAE,CAAC;AAAA,EAClE;AACA,MAAI,aAAa,WAAW;AAC1B,WAAO,KAAK,KAAK,EAAE,IAAI,MAAM,SAAS,cAAc,KAAK,EAAE,CAAC;AAAA,EAC9D;AACA,MAAI,aAAa,WAAW;AAC1B,WAAO,MAAM,aAAa,aAAa;AAAA,EACzC;AACA,SAAO,KAAK,KAAK;AAAA,IACf,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,SAAS,OAAO,QAAQ;AAAA,EAC1B,CAAC;AACH;AAMA,eAAsB,KACpB,KACA,SACmB;AACnB,QAAM,MAAM,cAAc;AAC1B,MAAI,IAAK,QAAO;AAChB,QAAM,gBAAgB,MAAM,kBAAkB;AAC9C,QAAM,EAAE,MAAM,MAAM,IAAI,MAAM,QAAQ;AACtC,QAAM,WAAW,iBAAiB,KAAK;AAEvC,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,IAAI,KAAK;AAAA,EACxB,SAAS,KAAK;AACZ,WAAO,KAAK,KAAK;AAAA,MACf,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,SAAU,IAAc;AAAA,IAC1B,CAAC;AAAA,EACH;AAEA,MAAI,aAAa,UAAU;AACzB,WAAO,MAAM,eAAe,MAAoB,eAAe,KAAK;AAAA,EACtE;AACA,MAAI,aAAa,YAAY;AAC3B,WAAO,MAAM,eAAe,MAAoB,eAAe,IAAI;AAAA,EACrE;AACA,MAAI,aAAa,WAAW;AAC1B,UAAM,UAAU,MAAM;AAAA,MACpB;AAAA,MACA,EAAE,eAAe,QAAQ,MAAM;AAAA,MAC/B;AAAA,IACF;AACA,QAAI,QAAQ,GAAI,QAAO,KAAK,KAAK,EAAE,IAAI,MAAM,MAAM,QAAQ,KAAK,CAAC;AACjE,WAAO,KAAK,QAAQ,QAAQ;AAAA,MAC1B,IAAI;AAAA,MACJ,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH;AACA,MAAI,aAAa,mBAAmB;AAClC,UAAM,UAAU,MAAM,iBAAiB,MAA+B;AAAA,MACpE;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AACD,QAAI,QAAQ,IAAI;AACd,aAAO,KAAK,KAAK;AAAA,QACf,IAAI;AAAA,QACJ,MAAM,QAAQ;AAAA,QACd,UAAU,QAAQ;AAAA,QAClB,eAAe,QAAQ;AAAA,MACzB,CAAC;AAAA,IACH;AACA,WAAO,KAAK,QAAQ,QAAQ;AAAA,MAC1B,IAAI;AAAA,MACJ,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH;AACA,MAAI,aAAa,sBAAsB;AACrC,UAAM,UAAU,MAAM;AAAA,MACpB;AAAA,MACA,EAAE,eAAe,QAAQ,MAAM;AAAA,IACjC;AACA,QAAI,QAAQ,IAAI;AACd,aAAO,KAAK,KAAK;AAAA,QACf,IAAI;AAAA,QACJ,MAAM,QAAQ;AAAA,QACd,eAAe,QAAQ;AAAA,QACvB,eAAe,QAAQ;AAAA,MACzB,CAAC;AAAA,IACH;AACA,WAAO,KAAK,QAAQ,QAAQ;AAAA,MAC1B,IAAI;AAAA,MACJ,QAAQ,QAAQ;AAAA,MAChB,SAAS,QAAQ;AAAA,IACnB,CAAC;AAAA,EACH;AACA,MAAI,aAAa,cAAc;AAC7B,QAAI,CAAC,iBAAiB,IAAI,GAAG;AAC3B,aAAO,KAAK,KAAK;AAAA,QACf,IAAI;AAAA,QACJ,QAAQ;AAAA,QACR,SACE;AAAA,MACJ,CAAC;AAAA,IACH;AACA,qBAAiB,IAAI,IAAI;AACzB,WAAO,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC;AAAA,EAC/B;AAEA,SAAO,KAAK,KAAK;AAAA,IACf,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,SAAS,QAAQ,QAAQ;AAAA,EAC3B,CAAC;AACH;AAMA,eAAsB,OACpB,KACA,SACmB;AACnB,QAAM,MAAM,cAAc;AAC1B,MAAI,IAAK,QAAO;AAChB,QAAM,kBAAkB;AACxB,QAAM,EAAE,MAAM,MAAM,IAAI,MAAM,QAAQ;AACtC,QAAM,WAAW,iBAAiB,KAAK;AAEvC,MAAI,aAAa,cAAc;AAC7B,qBAAiB,MAAM;AACvB,WAAO,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC;AAAA,EAC/B;AACA,SAAO,KAAK,KAAK;AAAA,IACf,IAAI;AAAA,IACJ,QAAQ;AAAA,IACR,SAAS,UAAU,QAAQ;AAAA,EAC7B,CAAC;AACH;AAMA,eAAe,eACb,OACA,eACA,QACmB;AACnB,QAAM,UAAU,MAAM,YAAY,OAAO,EAAE,eAAe,OAAO,CAAC;AAClE,MAAI,QAAQ,IAAI;AACd,QAAI,CAAC,QAAQ;AACX,YAAM,kBACJ,QAAQ,iBAAiB,MAAM,UAAU;AAC3C,oBAAc,KAAK;AAAA,QACjB,MAAM,MAAM;AAAA,QACZ,MAAM,MAAM;AAAA,QACZ,KAAK,MAAM;AAAA,QACX,QAAQ;AAAA,QACR,OAAO,MAAM;AAAA,QACb,WAAW,KAAK,IAAI;AAAA,MACtB,CAAC;AAAA,IACH;AACA,WAAO,KAAK,KAAK,EAAE,IAAI,MAAM,MAAM,QAAQ,KAAK,CAAC;AAAA,EACnD;AACA,SAAO,KAAK,QAAQ,QAAQ;AAAA,IAC1B,IAAI;AAAA,IACJ,QAAQ,QAAQ;AAAA,IAChB,SAAS,QAAQ;AAAA,EACnB,CAAC;AACH;AAEA,eAAe,aAAa,eAA0C;AACpE,QAAM,KAAK,MAAM,OAAO,aAAkB;AAC1C,QAAM,aAAa,oBAAI,IAAI;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,YAAiB,UAAK,eAAe,QAAQ;AAEnD,iBAAe,KAAK,KAAa,KAAgC;AAC/D,QAAI,UAAsC,CAAC;AAC3C,QAAI;AACF,gBAAU,MAAM,GAAG,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;AAAA,IACzD,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AACA,UAAM,MAAgB,CAAC;AACvB,eAAW,KAAK,SAAS;AACvB,YAAM,QAAa,UAAK,KAAK,EAAE,IAAI;AACnC,YAAM,WAAW,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,KAAK,EAAE;AAC9C,UAAI,EAAE,YAAY,GAAG;AACnB,cAAM,MAAM,MAAM,KAAK,OAAO,QAAQ;AACtC,YAAI,KAAK,GAAG,GAAG;AAAA,MACjB,WACE,EAAE,OAAO,KACT,WAAW,IAAS,aAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,GACjD;AACA,YAAI,KAAK,IAAI,QAAQ,EAAE;AAAA,MACzB;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,SAAS,MAAM,KAAK,WAAW,EAAE;AACvC,WAAO,KAAK;AACZ,WAAO,KAAK,KAAK,EAAE,IAAI,MAAM,OAAO,CAAC;AAAA,EACvC,SAAS,KAAK;AACZ,WAAO,KAAK,KAAK;AAAA,MACf,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,SAAU,IAAc;AAAA,IAC1B,CAAC;AAAA,EACH;AACF;AAEA,SAAS,iBAAiB,GAA4B;AACpD,MAAI,CAAC,KAAK,OAAO,MAAM,SAAU,QAAO;AACxC,QAAM,IAAI;AACV,SACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,QAAQ,YACjB,OAAO,EAAE,QAAQ,YACjB,OAAO,EAAE,cAAc,YACvB,OAAO,EAAE,YAAY,aACpB,EAAE,kBAAkB,QAAQ,OAAO,EAAE,kBAAkB,aACxD,OAAO,EAAE,kBAAkB;AAE/B;","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@aaqiljamal/visual-editor-next",
+  "version": "0.2.0",
+  "description": "Visual-edit for Next.js — one install. Includes the overlay, the Babel plugin, and a Route Handler that does AST writes inside your dev process (no separate server).",
+  "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"
+    },
+    "./route": {
+      "types": "./dist/route.d.ts",
+      "import": "./dist/route.js"
+    }
+  },
+  "bin": {
+    "visual-editor-init": "bin/visual-editor-init.cjs"
+  },
+  "files": ["dist", "bin", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["visual-editor", "next", "tailwind", "css-modules", "styled-components"],
+  "license": "MIT",
+  "author": "Aaqil Jamal",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/The-Design-Alchemist/visual-editor.git",
+    "directory": "packages/next"
+  },
+  "homepage": "https://github.com/The-Design-Alchemist/visual-editor#readme",
+  "bugs": "https://github.com/The-Design-Alchemist/visual-editor/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "next": ">=15.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@aaqiljamal/visual-editor-babel-plugin": "0.2.0",
+    "@aaqiljamal/visual-editor-runtime": "0.2.0",
+    "@aaqiljamal/visual-editor-server": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  }
+}