heliumts 0.2.2

package/dist/vite/scanner.js

@@ -0,0 +1,167 @@
+import fs from "fs";
+import path from "path";
+import { log } from "../utils/logger.js";
+import { SERVER_DIR } from "./paths.js";
+export function scanServerMethods(root) {
+    const exports = scanServerExports(root);
+    return exports.methods;
+}
+export function scanServerExports(root) {
+    const serverDir = path.resolve(root, SERVER_DIR);
+    if (!fs.existsSync(serverDir)) {
+        return { methods: [], httpHandlers: [] };
+    }
+    const methods = [];
+    const httpHandlers = [];
+    let middleware;
+    function walk(dir) {
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const fullPath = path.join(dir, file);
+            const stat = fs.statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (file.endsWith(".ts")) {
+                const content = fs.readFileSync(fullPath, "utf-8");
+                // Check for _middleware.ts file
+                if (file === "_middleware.ts") {
+                    // Support both 'middleware' and 'defineMiddleware' (backwards compatibility)
+                    const middlewareRegex = /export\s+(const|default)\s+(\w+)\s*=\s*(middleware|defineMiddleware)/;
+                    const match = middlewareRegex.exec(content);
+                    if (match) {
+                        middleware = {
+                            name: match[2],
+                            filePath: fullPath,
+                        };
+                    }
+                    // Also support default export
+                    const defaultRegex = /export\s+default\s+(middleware|defineMiddleware)/;
+                    if (defaultRegex.test(content)) {
+                        middleware = {
+                            name: "default",
+                            filePath: fullPath,
+                        };
+                    }
+                }
+                // Find: export const methodName = defineMethod(...)
+                const methodRegex = /export\s+const\s+(\w+)\s*=\s*defineMethod/g;
+                let match;
+                while ((match = methodRegex.exec(content)) !== null) {
+                    methods.push({
+                        name: match[1],
+                        filePath: fullPath,
+                    });
+                }
+                // Find: export const handlerName = defineHTTPRequest(...)
+                const httpRegex = /export\s+const\s+(\w+)\s*=\s*defineHTTPRequest/g;
+                while ((match = httpRegex.exec(content)) !== null) {
+                    httpHandlers.push({
+                        name: match[1],
+                        filePath: fullPath,
+                    });
+                }
+            }
+        }
+    }
+    walk(serverDir);
+    return { methods, httpHandlers, middleware };
+}
+/**
+ * Convert a file path to a route pattern (same logic as client-side router)
+ */
+function pathFromFile(file, root) {
+    // Remove root/src/pages prefix and file extension
+    const pagesDir = path.join(root, "src", "pages");
+    const withoutPrefix = file.replace(pagesDir, "").replace(/\.(tsx|jsx|ts|js)$/, "");
+    // Handle special files
+    if (withoutPrefix === "/404") {
+        return "__404__";
+    }
+    // Remove route groups (folders in parentheses)
+    let pattern = withoutPrefix.replace(/\/\([^)]+\)/g, "");
+    // Convert /index to /
+    pattern = pattern.replace(/\/index$/, "") || "/";
+    // Convert [...param] to *param (catch-all)
+    pattern = pattern.replace(/\[\.\.\.(.+?)\]/g, "*$1");
+    // Convert [param] to :param (single dynamic segment)
+    pattern = pattern.replace(/\[(.+?)\]/g, ":$1");
+    return pattern;
+}
+/**
+ * Scan pages directory and detect route collisions
+ */
+export function scanPageRoutes(root) {
+    const pagesDir = path.join(root, "src", "pages");
+    if (!fs.existsSync(pagesDir)) {
+        return { collisions: [], totalRoutes: 0 };
+    }
+    const routePatternMap = new Map();
+    const collisions = [];
+    function walkPages(dir) {
+        const items = fs.readdirSync(dir);
+        for (const item of items) {
+            const fullPath = path.join(dir, item);
+            const stat = fs.statSync(fullPath);
+            if (stat.isDirectory()) {
+                walkPages(fullPath);
+            }
+            else if (/\.(tsx|jsx|ts|js)$/.test(item)) {
+                // Skip layout files
+                if (item.includes("_layout.")) {
+                    continue;
+                }
+                const pathPattern = pathFromFile(fullPath, root);
+                // Skip special pages
+                if (pathPattern === "__404__") {
+                    continue;
+                }
+                // Check for collision
+                const existingFile = routePatternMap.get(pathPattern);
+                if (existingFile) {
+                    // Check if this collision was already recorded
+                    const existingCollision = collisions.find((c) => c.pattern === pathPattern);
+                    if (existingCollision) {
+                        existingCollision.files.push(fullPath);
+                    }
+                    else {
+                        collisions.push({
+                            pattern: pathPattern,
+                            files: [existingFile, fullPath],
+                        });
+                    }
+                }
+                else {
+                    routePatternMap.set(pathPattern, fullPath);
+                }
+            }
+        }
+    }
+    walkPages(pagesDir);
+    return { collisions, totalRoutes: routePatternMap.size };
+}
+/**
+ * Check for route collisions and log warnings
+ */
+export function checkRouteCollisions(root) {
+    const { collisions, totalRoutes } = scanPageRoutes(root);
+    if (collisions.length === 0) {
+        return false;
+    }
+    log("warn", "⚠️  Route collisions detected! Multiple files resolve to the same URL path:");
+    log("warn", "");
+    for (const collision of collisions) {
+        log("error", `  Route pattern: "${collision.pattern}"`);
+        for (const file of collision.files) {
+            const relative = path.relative(root, file);
+            log("error", `    - ${relative}`);
+        }
+        log("error", `  ⚠️  Only the first file will be accessible.`);
+        log("warn", "");
+    }
+    log("warn", `Found ${collisions.length} collision(s) across ${totalRoutes} unique routes.`);
+    log("warn", "Consider using different file names or organizing files in subdirectories.");
+    log("warn", "");
+    return true;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/vite/scanner.js.map

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

package/dist/vite/ssg.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SSG (Static Site Generation) implementation for Helium
+ *
+ * Scans pages directory for files with "use ssg"; directive and generates
+ * static HTML for them at build time.
+ */
+interface SSGPage {
+    filePath: string;
+    urlPath: string;
+    relativePath: string;
+    warnings: string[];
+}
+/**
+ * Scan pages directory and find all pages with "use ssg" directive
+ */
+export declare function scanSSGPages(root: string): SSGPage[];
+/**
+ * Generate static HTML files for all SSG pages
+ */
+export declare function generateStaticPages(context: any, root: string, htmlTemplate: string, distDir: string): Promise<void>;
+export {};
+//# sourceMappingURL=ssg.d.ts.map

package/dist/vite/ssg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssg.d.ts","sourceRoot":"","sources":["../../src/vite/ssg.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AAEH,UAAU,OAAO;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AA2ED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAwDpD;AAqLD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAsT1G"}