@nuvio/vite-plugin 0.1.0 → 0.5.0

package/dist/index.d.ts

@@ -1,10 +1,14 @@
 import { Plugin } from 'vite';
 
 interface NuvioPluginOptions {
+    /** Master switch; false disables index + WS server. */
+    enabled?: boolean;
     /** Glob patterns relative to Vite config root (see DEFAULT_GLOBS). */
     scanGlobs?: string[];
     /** Log client ops (no source file contents). */
     verbose?: boolean;
+    /** className parsing mode: strict literals (default) or simple cn/clsx strings. */
+    classNameMode?: "literal-only" | "cn-basic";
 }
 /**
  * Nuvio Vite plugin — Phase 1: WebSocket protocol + dev-time source index + selection ack.

package/dist/index.js

@@ -1,6 +1,14 @@
+import {
+  buildSourceIndex,
+  extractIdsFromSource,
+  pathnameFromUpgradeUrl,
+  pickBestSourceIndex,
+  readRuntimeVersions
+} from "./chunk-KTNIIC2D.js";
+
 // src/index.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs from "fs";
+import path from "path";
 import { WebSocket } from "ws";
 import { WebSocketServer } from "ws";
 import { applyPatchToSource } from "@nuvio/ast-engine";
@@ -11,190 +19,6 @@ import {
   serializeServerMessage
 } from "@nuvio/shared";
 import { assertPathWithinRoot } from "@nuvio/shared/secure-path";
-
-// src/upgrade-url.ts
-function pathnameFromUpgradeUrl(url) {
-  if (!url) {
-    return "";
-  }
-  try {
-    return new URL(url, "http://localhost").pathname;
-  } catch {
-    return "";
-  }
-}
-
-// src/source-index.ts
-import * as fs from "fs";
-import * as path from "path";
-import { parse } from "@babel/parser";
-import traverseImport from "@babel/traverse";
-import fg from "fast-glob";
-function getTraverseFn() {
-  if (typeof traverseImport === "function") {
-    return traverseImport;
-  }
-  const d = traverseImport.default;
-  if (typeof d === "function") {
-    return d;
-  }
-  throw new Error("[Nuvio] @babel/traverse did not resolve to a callable export");
-}
-var WRAPPER_TAGS = /* @__PURE__ */ new Set(["EditableText", "EditableContainer"]);
-function extractIdsFromSource(fileAbs, code) {
-  const acc = [];
-  let ast;
-  try {
-    ast = parse(code, {
-      sourceType: "module",
-      plugins: ["typescript", "jsx"],
-      sourceFilename: fileAbs
-    });
-  } catch {
-    return acc;
-  }
-  const traverseFn = getTraverseFn();
-  traverseFn(ast, {
-    JSXOpeningElement(p) {
-      const opening = p.node;
-      let tagName = "";
-      if (opening.name.type === "JSXIdentifier") {
-        tagName = opening.name.name;
-      } else {
-        return;
-      }
-      for (const attr of opening.attributes) {
-        if (attr.type !== "JSXAttribute") {
-          continue;
-        }
-        if (attr.name.type !== "JSXIdentifier") {
-          continue;
-        }
-        const prop = attr.name.name;
-        const loc = attr.loc?.start ?? opening.loc?.start;
-        const line = loc?.line ?? 1;
-        const column = loc?.column ?? 0;
-        if (prop === "data-nuvio-id" && attr.value?.type === "StringLiteral") {
-          const id = attr.value.value.trim();
-          if (id) {
-            acc.push({ id, file: path.resolve(fileAbs), line, column });
-          }
-          continue;
-        }
-        if (WRAPPER_TAGS.has(tagName) && prop === "id" && attr.value?.type === "StringLiteral") {
-          const id = attr.value.value.trim();
-          if (id) {
-            acc.push({ id, file: path.resolve(fileAbs), line, column });
-          }
-        }
-      }
-    }
-  });
-  return acc;
-}
-function buildSourceIndex(rootAbs, globPatterns) {
-  const root = path.resolve(rootAbs);
-  const parseErrors = [];
-  const normalizedPatterns = globPatterns.map((g) => {
-    const resolved = path.isAbsolute(g) ? path.resolve(g) : path.resolve(root, g);
-    return resolved.replace(/\\/g, "/");
-  });
-  const matched = fg.sync(normalizedPatterns, {
-    absolute: true,
-    ignore: ["**/node_modules/**", "**/dist/**"],
-    onlyFiles: true
-  });
-  const files = [...new Set(matched)];
-  const byId = /* @__PURE__ */ new Map();
-  for (const file of files) {
-    let code;
-    try {
-      code = fs.readFileSync(file, "utf8");
-    } catch (e) {
-      parseErrors.push({ file, message: String(e) });
-      continue;
-    }
-    let occurrences;
-    try {
-      occurrences = extractIdsFromSource(file, code);
-    } catch (e) {
-      parseErrors.push({ file, message: String(e) });
-      continue;
-    }
-    for (const occ of occurrences) {
-      const list = byId.get(occ.id) ?? [];
-      list.push(occ);
-      byId.set(occ.id, list);
-    }
-  }
-  const duplicateErrors = [];
-  const entries = [];
-  for (const [id, list] of byId) {
-    if (list.length > 1) {
-      duplicateErrors.push({
-        id,
-        occurrences: list.map((o) => ({
-          file: o.file,
-          line: o.line,
-          column: o.column
-        }))
-      });
-    } else if (list.length === 1) {
-      entries.push(list[0]);
-    }
-  }
-  entries.sort((a, b) => {
-    const fa = a.file.localeCompare(b.file);
-    if (fa !== 0) {
-      return fa;
-    }
-    if (a.line !== b.line) {
-      return a.line - b.line;
-    }
-    return a.column - b.column;
-  });
-  duplicateErrors.sort((a, b) => a.id.localeCompare(b.id));
-  return {
-    entries,
-    duplicateErrors,
-    parseErrors,
-    scannedFileCount: files.length
-  };
-}
-function indexQuality(b) {
-  return [b.entries.length, -b.duplicateErrors.length, b.scannedFileCount];
-}
-function isBetterIndex(candidate, current) {
-  const c = indexQuality(candidate);
-  const b = indexQuality(current);
-  for (let i = 0; i < 3; i++) {
-    if (c[i] !== b[i]) {
-      return c[i] > b[i];
-    }
-  }
-  return false;
-}
-function pickBestSourceIndex(rootCandidates, globPatterns) {
-  const roots = [...new Set(rootCandidates.map((r) => path.resolve(r)).filter((r) => r.length > 0))];
-  if (roots.length === 0) {
-    return {
-      entries: [],
-      duplicateErrors: [],
-      parseErrors: [],
-      scannedFileCount: 0
-    };
-  }
-  let best = buildSourceIndex(roots[0], globPatterns);
-  for (let i = 1; i < roots.length; i++) {
-    const built = buildSourceIndex(roots[i], globPatterns);
-    if (isBetterIndex(built, best)) {
-      best = built;
-    }
-  }
-  return best;
-}
-
-// src/index.ts
 var APP_ENTRY_CANDIDATES = ["src/App.tsx", "src/app.tsx", "App.tsx"];
 function nuvioWsMessageToText(data) {
   if (typeof data === "string") {
@@ -212,18 +36,18 @@ function nuvioWsMessageToText(data) {
   }
   return String(data);
 }
-function supplementIndexFromAppTsx(serverRoot, built, emitWarn = console.warn) {
+function supplementIndexFromAppTsx(serverRoot, built, classNameMode, emitWarn = console.warn) {
   if (built.entries.length > 0) {
     return built;
   }
   for (const rel of APP_ENTRY_CANDIDATES) {
-    const appTsx = path2.resolve(serverRoot, rel);
-    if (!fs2.existsSync(appTsx)) {
+    const appTsx = path.resolve(serverRoot, rel);
+    if (!fs.existsSync(appTsx)) {
       continue;
     }
     try {
-      const code = fs2.readFileSync(appTsx, "utf8");
-      const hits = extractIdsFromSource(appTsx, code);
+      const code = fs.readFileSync(appTsx, "utf8");
+      const hits = extractIdsFromSource(appTsx, code, { classNameMode });
       if (hits.length === 0) {
         continue;
       }
@@ -257,20 +81,30 @@ function isAllowedOrigin(origin) {
   }
 }
 function nuvio(options) {
+  const envEnabled = process.env.NUVIO !== "0";
+  const enabled = options?.enabled ?? envEnabled;
   const scanGlobs = options?.scanGlobs ?? DEFAULT_GLOBS;
   const verbose = options?.verbose ?? false;
+  const classNameMode = options?.classNameMode ?? "literal-only";
   let indexVersion = 0;
   let cachedIndexPayload = null;
+  let runtimeDiagnostics = { overlayCssMode: "self-contained" };
   const idToEntry = /* @__PURE__ */ new Map();
   return {
     name: "nuvio",
     apply: "serve",
     configureServer(server) {
+      if (!enabled) {
+        server.config.logger.info(
+          "[Nuvio] disabled (set `NUVIO=1` or `nuvio({ enabled: true })` to enable)."
+        );
+        return;
+      }
       const log = server.config.logger;
-      const fromConfigFile = typeof server.config.configFile === "string" ? path2.dirname(server.config.configFile) : "";
-      const serverRoot = path2.resolve(server.config.root);
+      const fromConfigFile = typeof server.config.configFile === "string" ? path.dirname(server.config.configFile) : "";
+      const serverRoot = path.resolve(server.config.root);
       const rootCandidates = [
-        path2.resolve(fromConfigFile || serverRoot),
+        path.resolve(fromConfigFile || serverRoot),
         serverRoot,
         process.cwd()
       ];
@@ -285,10 +119,12 @@ function nuvio(options) {
         }
       };
       const rebuildIndex = () => {
-        let built = pickBestSourceIndex(rootCandidates, scanGlobs);
-        built = supplementIndexFromAppTsx(serverRoot, built, log.warn);
+        let built = pickBestSourceIndex(rootCandidates, scanGlobs, { classNameMode });
+        built = supplementIndexFromAppTsx(serverRoot, built, classNameMode, log.warn);
         if (built.entries.length === 0) {
-          const fallback = buildSourceIndex(serverRoot, ["src/**/*.{tsx,jsx}"]);
+          const fallback = buildSourceIndex(serverRoot, ["src/**/*.{tsx,jsx}"], {
+            classNameMode
+          });
           if (fallback.entries.length > 0) {
             log.warn(
               `[Nuvio] Multi-root scan yielded 0 ids; using serverRoot-only index (${fallback.entries.length} id(s)) from ${serverRoot}.`
@@ -301,12 +137,18 @@ function nuvio(options) {
         for (const e of built.entries) {
           idToEntry.set(e.id, e);
         }
+        const versions = readRuntimeVersions(serverRoot);
+        runtimeDiagnostics = {
+          ...versions,
+          overlayCssMode: "self-contained"
+        };
         cachedIndexPayload = serializeServerMessage({
           type: "indexReady",
           protocolVersion: PROTOCOL_VERSION,
           indexVersion,
           entries: built.entries,
-          duplicateErrors: built.duplicateErrors
+          duplicateErrors: built.duplicateErrors,
+          diagnostics: runtimeDiagnostics
         });
         if (verbose) {
           if (built.parseErrors.length > 0) {
@@ -322,7 +164,7 @@ function nuvio(options) {
           );
         } else {
           log.info(
-            `[Nuvio] index v${indexVersion} \u2014 ${built.entries.length} id(s), ${built.scannedFileCount} file(s)`
+            `[Nuvio] index v2 \u2014 ${built.entries.length} id(s), ${built.scannedFileCount} file(s)`
           );
         }
         if (built.scannedFileCount === 0) {
@@ -405,7 +247,8 @@ function nuvio(options) {
               serializeServerMessage({
                 type: "pong",
                 protocolVersion: PROTOCOL_VERSION,
-                requestId: msg.requestId
+                requestId: msg.requestId,
+                diagnostics: runtimeDiagnostics
               })
             );
             if (cachedIndexPayload) {
@@ -442,13 +285,23 @@ function nuvio(options) {
                 ok: true,
                 file: entry.file,
                 line: entry.line,
-                column: entry.column
+                column: entry.column,
+                patchHostId: entry.patchHostId,
+                primaryTextTargetKey: entry.primaryTextTargetKey,
+                textTargets: entry.textTargets,
+                styleTargets: entry.styleTargets,
+                hierarchyRole: entry.hierarchyRole,
+                parentHostId: entry.parentHostId,
+                childTargetIds: entry.childTargetIds,
+                rowTargets: entry.rowTargets,
+                tableMeta: entry.tableMeta,
+                tableDataField: entry.tableDataField
               })
             );
             return;
           }
           if (msg.type === "patchUndo") {
-            const writeGuardRoot = path2.resolve(fromConfigFile || serverRoot);
+            const writeGuardRoot = path.resolve(fromConfigFile || serverRoot);
             const last = undoStack.pop();
             if (!last) {
               ws.send(
@@ -465,7 +318,7 @@ function nuvio(options) {
             }
             try {
               assertPathWithinRoot(writeGuardRoot, last.file);
-              fs2.writeFileSync(last.file, last.contents, "utf8");
+              fs.writeFileSync(last.file, last.contents, "utf8");
             } catch (e) {
               undoStack.push(last);
               ws.send(
@@ -495,7 +348,7 @@ function nuvio(options) {
           }
           if (msg.type === "patchApply") {
             const entry = idToEntry.get(msg.id);
-            const writeGuardRoot = path2.resolve(fromConfigFile || serverRoot);
+            const writeGuardRoot = path.resolve(fromConfigFile || serverRoot);
             const dryRun = msg.dryRun === true;
             const patchAckExtras = dryRun ? { dryRun: true } : {};
             if (!entry) {
@@ -533,7 +386,7 @@ function nuvio(options) {
             }
             let source;
             try {
-              source = fs2.readFileSync(entry.file, "utf8");
+              source = fs.readFileSync(entry.file, "utf8");
             } catch (e) {
               ws.send(
                 serializeServerMessage({
@@ -549,7 +402,10 @@ function nuvio(options) {
               );
               return;
             }
-            const result = await applyPatchToSource(source, entry.file, msg.id, msg.ops);
+            const result = await applyPatchToSource(source, entry.file, msg.id, msg.ops, {
+              classNameMode,
+              activeBreakpoint: msg.activeBreakpoint
+            });
             if (!result.ok) {
               ws.send(
                 serializeServerMessage({
@@ -583,7 +439,7 @@ function nuvio(options) {
               return;
             }
             try {
-              fs2.writeFileSync(entry.file, result.source, "utf8");
+              fs.writeFileSync(entry.file, result.source, "utf8");
             } catch (e) {
               ws.send(
                 serializeServerMessage({

package/dist/nuvio-dev-session.d.ts

@@ -0,0 +1,20 @@
+import { Server } from 'node:http';
+
+declare const DEFAULT_GLOBS: string[];
+type NuvioDevSessionOptions = {
+    enabled?: boolean;
+    root: string;
+    configDir?: string;
+    scanGlobs?: string[];
+    verbose?: boolean;
+    classNameMode?: "literal-only" | "cn-basic";
+    log?: Pick<Console, "info" | "warn">;
+};
+type NuvioDevSessionHandle = {
+    rebuildIndex: () => void;
+    close: () => void;
+};
+/** Attach Nuvio dev WebSocket + source index to any Node HTTP server (Vite or Next custom server). */
+declare function attachNuvioDevSession(httpServer: Server, options: NuvioDevSessionOptions): NuvioDevSessionHandle;
+
+export { DEFAULT_GLOBS as NUVIO_DEFAULT_SCAN_GLOBS, type NuvioDevSessionHandle, type NuvioDevSessionOptions, attachNuvioDevSession };