@catmint/vite 0.0.0-prealpha.1

package/dist/utils.js

@@ -0,0 +1,198 @@
+// @catmint/vite/utils — Shared utilities for the Vite plugin
+import { createHash } from "node:crypto";
+import { posix } from "node:path";
+/**
+ * Produce a short deterministic hash from a string input.
+ * Used to generate stable, opaque endpoint identifiers for server functions.
+ */
+export function deterministicHash(input) {
+    return createHash("sha256").update(input).digest("hex").slice(0, 8);
+}
+/**
+ * Check if a file is a server-only module based on its extension pattern.
+ * Matches `*.server.ts` and `*.server.tsx`.
+ *
+ * NOTE: `*.fn.ts` files are NOT server-only — they are importable from client
+ * code. The `catmint:server-fn-transform` plugin rewrites them into fetch stubs
+ * in client bundles, so the boundary plugin must allow them through.
+ */
+export function isServerOnlyFile(id) {
+    return /\.server\.(ts|tsx)$/.test(id);
+}
+/**
+ * Check if a file is a client component based on its extension pattern.
+ * Matches `*.client.tsx`.
+ */
+export function isClientComponentFile(id) {
+    return /\.client\.tsx$/.test(id);
+}
+/**
+ * Check if a file is an error boundary file (`error.tsx`).
+ */
+export function isErrorFile(id) {
+    return /\/error\.tsx$/.test(id) || id === "error.tsx";
+}
+/**
+ * Check if a file is a page file (`page.tsx` or `page.mdx`).
+ */
+export function isPageFile(id) {
+    return (/\/page\.(tsx|mdx)$/.test(id) || id === "page.tsx" || id === "page.mdx");
+}
+/**
+ * Check if a file is a layout file (`layout.tsx`).
+ */
+export function isLayoutFile(id) {
+    return /\/layout\.tsx$/.test(id) || id === "layout.tsx";
+}
+/**
+ * Check if a file is a server function module (`*.fn.ts`).
+ */
+export function isServerFnFile(id) {
+    return /\.fn\.(ts|tsx?)$/.test(id);
+}
+/**
+ * Normalize a file path to a forward-slash posix path.
+ */
+export function toPosixPath(filePath) {
+    return filePath.split(/[\\/]/).join(posix.sep);
+}
+/**
+ * Derive the RPC endpoint path for a server function.
+ * Uses the relative file path (from project root) and the function name
+ * to produce a stable `/__catmint/fn/<basename>/<hash>` path.
+ */
+export function serverFnEndpoint(relativeFilePath, fnName) {
+    const posixPath = toPosixPath(relativeFilePath);
+    // Strip the extension for the URL base
+    const base = posixPath.replace(/\.(fn\.ts|fn\.tsx?)$/, "");
+    const hash = deterministicHash(`${posixPath}:${fnName}`);
+    return `/__catmint/fn/${base}/${hash}`;
+}
+// --------------------------------------------------------------------------
+// Client-side navigation runtime (inlined into client entry modules)
+// --------------------------------------------------------------------------
+/**
+ * JavaScript code inlined into client entry modules to enable client-side
+ * (soft) navigation. When a user clicks a relative link, this code intercepts
+ * the click, fetches the RSC flight stream for the target URL, deserializes
+ * it, and tells React to render the new tree — no full page reload needed.
+ *
+ * This runtime is shared between the dev server (virtual:catmint/client-hydrate)
+ * and the production build (virtual:catmint/client-rsc-entry).
+ */
+export const CLIENT_NAVIGATION_RUNTIME = `
+function setupClientNavigation(reactRoot) {
+  if (!reactRoot) return;
+
+  function isRelativeUrl(href) {
+    if (href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//")) return false;
+    if (/^[a-zA-Z][a-zA-Z0-9+\\-.]*:/.test(href)) return false;
+    if (href.startsWith("#")) return false;
+    return true;
+  }
+
+  function shouldIntercept(event, anchor) {
+    if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return false;
+    if (event.button !== 0) return false;
+    if (event.defaultPrevented) return false;
+    var target = anchor.getAttribute("target");
+    if (target && target !== "_self") return false;
+    if (anchor.hasAttribute("download")) return false;
+    if (anchor.hasAttribute("data-catmint-reload")) return false;
+    var href = anchor.getAttribute("href");
+    if (!href) return false;
+    return isRelativeUrl(href);
+  }
+
+  function findAnchor(target) {
+    if (!target || !(target instanceof Element)) return null;
+    return target.closest("a");
+  }
+
+  var navigating = false;
+
+  async function performNavigation(url, opts) {
+    if (navigating) return;
+    navigating = true;
+
+    try {
+      var rscUrl = "/__catmint/rsc?path=" + encodeURIComponent(url.split("#")[0]);
+      var response = await fetch(rscUrl);
+
+      if (!response.ok) {
+        // RSC fetch failed — fall back to full page reload
+        window.location.href = url;
+        return;
+      }
+
+      // Dynamically import createFromReadableStream for RSC deserialization
+      var rscBrowser = await import("@vitejs/plugin-rsc/browser");
+      var newRoot = await rscBrowser.createFromReadableStream(response.body);
+
+      // Update the URL
+      if (opts && opts.replace) {
+        window.history.replaceState(null, "", url);
+      } else {
+        window.history.pushState(null, "", url);
+      }
+
+      // Tell React to render the new tree
+      reactRoot.render(newRoot);
+
+      // Scroll to top unless explicitly disabled
+      if (!opts || opts.scroll !== false) {
+        // Handle hash navigation
+        var hashIdx = url.indexOf("#");
+        if (hashIdx !== -1) {
+          var hash = url.slice(hashIdx + 1);
+          var el = document.getElementById(hash);
+          if (el) {
+            el.scrollIntoView();
+          } else {
+            window.scrollTo(0, 0);
+          }
+        } else {
+          window.scrollTo(0, 0);
+        }
+      }
+    } catch (err) {
+      console.error("[catmint] Client navigation error:", err);
+      // Fall back to full page reload on error
+      window.location.href = url;
+    } finally {
+      navigating = false;
+    }
+  }
+
+  // Intercept clicks on <a> tags with relative hrefs
+  document.addEventListener("click", function(event) {
+    var anchor = findAnchor(event.target);
+    if (!anchor) return;
+    if (!shouldIntercept(event, anchor)) return;
+
+    var href = anchor.getAttribute("href");
+    var resolved = new URL(href, window.location.href);
+
+    // Only intercept same-origin
+    if (resolved.origin !== window.location.origin) return;
+
+    var targetPath = resolved.pathname + resolved.search;
+    var currentPath = window.location.pathname + window.location.search;
+    if (targetPath === currentPath && resolved.hash) return;
+
+    event.preventDefault();
+    var replace = anchor.hasAttribute("data-catmint-replace");
+    performNavigation(
+      resolved.pathname + resolved.search + resolved.hash,
+      { replace: replace, scroll: true }
+    );
+  });
+
+  // Handle browser back/forward
+  window.addEventListener("popstate", function() {
+    var url = window.location.pathname + window.location.search + window.location.hash;
+    performNavigation(url, { replace: true, scroll: false });
+  });
+}
+`;
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAU;IAC9C,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,CACL,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,KAAK,UAAU,CACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,YAAY,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,gBAAwB,EACxB,MAAc;IAEd,MAAM,SAAS,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAChD,uCAAuC;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;IACzD,OAAO,iBAAiB,IAAI,IAAI,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,6EAA6E;AAC7E,qEAAqE;AACrE,6EAA6E;AAE7E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHxC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@catmint/vite",
+  "version": "0.0.0-prealpha.1",
+  "type": "module",
+  "private": false,
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@mdx-js/mdx": "^3.1.1",
+    "@swc/core": "^1.15.11",
+    "@vitejs/plugin-rsc": "^0.5.20",
+    "estree-walker": "^3.0.3",
+    "magic-string": "^0.30.21",
+    "rsc-html-stream": "^0.0.7"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/estree": "^1.0.8",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}