@catmint/cli 0.0.0-prealpha.2 → 0.0.0-prealpha.20

package/dist/route-analysis.js

@@ -0,0 +1,177 @@
+// catmint/cli/route-analysis — Shared route rendering mode detection
+//
+// Detects whether a page uses cachedRoute(), staticRoute(), or neither
+// (dynamic) by parsing the source file with SWC AST analysis.
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+/**
+ * Detect the rendering mode of a page file using SWC AST analysis.
+ *
+ * Parses the file and inspects the default export:
+ * - `export default staticRoute(...)` → `"static"`
+ * - `export default cachedRoute(...)` → `"cached"`
+ * - anything else → `"dynamic"`
+ *
+ * Endpoints are always `"dynamic"`.
+ */
+export function detectRouteMode(filePath, routeType) {
+    // Endpoints are always dynamic
+    if (routeType === "endpoint")
+        return "dynamic";
+    if (!existsSync(filePath))
+        return "dynamic";
+    // Only analyze TypeScript/JavaScript files, not MDX
+    if (!/\.(tsx?|jsx?)$/.test(filePath))
+        return "dynamic";
+    const code = readFileSync(filePath, "utf-8");
+    // Quick bail-out: if neither wrapper is mentioned, it's dynamic
+    const hasCached = code.includes("cachedRoute");
+    const hasStatic = code.includes("staticRoute");
+    if (!hasCached && !hasStatic)
+        return "dynamic";
+    const calleeName = findDefaultExportCallee(code);
+    if (calleeName === "staticRoute")
+        return "static";
+    if (calleeName === "cachedRoute")
+        return "cached";
+    return "dynamic";
+}
+/**
+ * Extract `cachedRoute()` options from a page source file using SWC AST analysis.
+ *
+ * Parses the file with SWC and walks the AST to find the default export.
+ * If it's a `cachedRoute(handler, options)` call, extracts the options object
+ * (revalidate, tag, staleWhileRevalidate) from the second argument.
+ *
+ * This approach is robust against code examples in string literals, JSX content,
+ * and unusual formatting — unlike regex-based extraction.
+ *
+ * Returns null if the file doesn't use cachedRoute as its default export.
+ */
+export function extractCacheOptions(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    // Only analyze TypeScript/JavaScript page files, not MDX documentation
+    if (!/\.(tsx?|jsx?)$/.test(filePath))
+        return null;
+    const code = readFileSync(filePath, "utf-8");
+    // Quick bail-out: if the file doesn't mention cachedRoute at all, skip parsing
+    if (!code.includes("cachedRoute"))
+        return null;
+    const ast = parseWithSwc(code);
+    if (!ast)
+        return null;
+    // Find the default export statement
+    for (const node of ast.body) {
+        // Handle: export default cachedRoute(...)
+        if (node.type === "ExportDefaultExpression" &&
+            node.expression?.type === "CallExpression" &&
+            node.expression.callee?.type === "Identifier" &&
+            node.expression.callee.value === "cachedRoute") {
+            return extractOptionsFromCallArgs(node.expression.arguments);
+        }
+        // Handle: export default cachedRoute(...) where the expression is wrapped
+        if (node.type === "ExportDefaultDeclaration" &&
+            node.decl?.type === "CallExpression" &&
+            node.decl.callee?.type === "Identifier" &&
+            node.decl.callee.value === "cachedRoute") {
+            return extractOptionsFromCallArgs(node.decl.arguments);
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse a TypeScript/TSX source file with SWC.
+ * Returns null if parsing fails.
+ */
+function parseWithSwc(code) {
+    try {
+        const esmRequire = createRequire(import.meta.url);
+        const { parseSync } = esmRequire("@swc/core");
+        return parseSync(code, {
+            syntax: "typescript",
+            tsx: true,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the callee name of the default export if it's a call expression.
+ *
+ * e.g. `export default cachedRoute(...)` → `"cachedRoute"`
+ * e.g. `export default staticRoute(...)` → `"staticRoute"`
+ * e.g. `export default function Page()` → `null`
+ */
+function findDefaultExportCallee(code) {
+    const ast = parseWithSwc(code);
+    if (!ast)
+        return null;
+    for (const node of ast.body) {
+        // export default someCall(...)
+        if (node.type === "ExportDefaultExpression" &&
+            node.expression?.type === "CallExpression" &&
+            node.expression.callee?.type === "Identifier") {
+            return node.expression.callee.value;
+        }
+        // export default declaration form
+        if (node.type === "ExportDefaultDeclaration" &&
+            node.decl?.type === "CallExpression" &&
+            node.decl.callee?.type === "Identifier") {
+            return node.decl.callee.value;
+        }
+    }
+    return null;
+}
+/**
+ * Extract cache options from the arguments array of a cachedRoute() call AST node.
+ *
+ * cachedRoute(handler, { tag: [...], revalidate: N, staleWhileRevalidate: bool })
+ *                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ *                       This is args[1] — an ObjectExpression
+ */
+function extractOptionsFromCallArgs(args) {
+    if (!args || args.length < 2) {
+        // cachedRoute(handler) without options — mark as cached with empty options
+        return args?.length === 1 ? {} : null;
+    }
+    const optionsArg = args[1]?.expression;
+    if (!optionsArg || optionsArg.type !== "ObjectExpression") {
+        return {};
+    }
+    const result = {};
+    for (const prop of optionsArg.properties) {
+        if (prop.type !== "KeyValueProperty")
+            continue;
+        const key = prop.key?.type === "Identifier"
+            ? prop.key.value
+            : prop.key?.type === "StringLiteral"
+                ? prop.key.value
+                : null;
+        if (key === "revalidate" && prop.value?.type === "NumericLiteral") {
+            result.revalidate = prop.value.value;
+        }
+        if (key === "tag" && prop.value?.type === "ArrayExpression") {
+            const tags = [];
+            for (const elem of prop.value.elements) {
+                const expr = elem?.expression ?? elem;
+                if (expr?.type === "StringLiteral") {
+                    tags.push(expr.value);
+                }
+            }
+            if (tags.length > 0) {
+                result.tags = tags;
+            }
+        }
+        if (key === "staleWhileRevalidate" &&
+            prop.value?.type === "BooleanLiteral") {
+            result.staleWhileRevalidate = prop.value.value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=route-analysis.js.map

package/dist/route-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-analysis.js","sourceRoot":"","sources":["../src/route-analysis.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@catmint/cli",
-  "version": "0.0.0-prealpha.2",
+  "version": "0.0.0-prealpha.20",
   "type": "module",
   "private": false,
-  "license": "MIT",
+  "license": "GPL-2.0",
   "files": [
     "dist",
     "bin"
@@ -18,9 +18,10 @@
     }
   },
   "dependencies": {
+    "picocolors": "^1.1.1",
     "vite": "^6.0.0",
-    "catmint": "0.0.0-prealpha.2",
-    "@catmint/vite": "0.0.0-prealpha.2"
+    "catmint": "0.0.0-prealpha.20",
+    "@catmint/vite": "0.0.0-prealpha.20"
   },
   "devDependencies": {
     "@swc/core": "^1.15.11",