@nuraly/lumenjs 0.1.0

package/dist/shared/dom-shims.js

@@ -0,0 +1,63 @@
+/**
+ * Install DOM shims needed for SSR rendering of Lit/NuralyUI components.
+ * Consolidates the various partial shim implementations across the codebase.
+ */
+export function installDomShims() {
+    const g = globalThis;
+    const noop = () => null;
+    if (!g.HTMLElement) {
+        g.HTMLElement = class HTMLElement {
+        };
+    }
+    if (!g.customElements) {
+        const registry = new Map();
+        g.customElements = {
+            get: (name) => registry.get(name),
+            define: (name, ctor) => registry.set(name, ctor),
+        };
+    }
+    if (!g.document) {
+        g.document = {
+            createTreeWalker: () => ({ nextNode: () => null }),
+            body: {},
+            querySelectorAll: () => [],
+            querySelector: () => null,
+            addEventListener: noop,
+            documentElement: { getAttribute: noop, setAttribute: noop, removeAttribute: noop, closest: noop },
+            createComment: (text) => ({ textContent: text }),
+            createTextNode: (text) => ({ textContent: text }),
+        };
+    }
+    // Patch missing document properties (SSR DOM shim may not include all of them)
+    if (g.document && !g.document.documentElement) {
+        g.document.documentElement = { getAttribute: noop, setAttribute: noop, removeAttribute: noop, closest: noop };
+    }
+    if (g.document?.documentElement && !g.document.documentElement.getAttribute) {
+        g.document.documentElement.getAttribute = noop;
+    }
+    if (!g.window) {
+        g.window = g;
+    }
+    if (!g.window.matchMedia) {
+        g.window.matchMedia = () => ({ matches: false, addEventListener: noop, removeEventListener: noop });
+    }
+    if (!g.CSSStyleSheet) {
+        g.CSSStyleSheet = class CSSStyleSheet {
+        };
+    }
+    if (!g.MutationObserver) {
+        g.MutationObserver = class MutationObserver {
+            observe() { }
+            disconnect() { }
+        };
+    }
+    if (g.HTMLElement && !g.HTMLElement.prototype.closest) {
+        g.HTMLElement.prototype.closest = noop;
+    }
+    if (g.HTMLElement && !g.HTMLElement.prototype.querySelector) {
+        g.HTMLElement.prototype.querySelector = noop;
+    }
+    if (g.HTMLElement && !g.HTMLElement.prototype.querySelectorAll) {
+        g.HTMLElement.prototype.querySelectorAll = () => [];
+    }
+}

package/dist/shared/route-matching.d.ts

@@ -0,0 +1,6 @@
+import type { ManifestRoute } from './types.js';
+export interface MatchResult {
+    route: ManifestRoute;
+    params: Record<string, string>;
+}
+export declare function matchRoute(routes: ManifestRoute[], pathname: string): MatchResult | null;

package/dist/shared/route-matching.js

@@ -0,0 +1,44 @@
+export function matchRoute(routes, pathname) {
+    const urlSegments = pathname.replace(/^\//, '').split('/').filter(Boolean);
+    for (const route of routes) {
+        const routeSegments = route.path.replace(/^\//, '').split('/').filter(Boolean);
+        // Handle root route
+        if (route.path === '/' && (pathname === '/' || pathname === '')) {
+            return { route, params: {} };
+        }
+        const params = {};
+        let match = true;
+        for (let i = 0; i < routeSegments.length; i++) {
+            const seg = routeSegments[i];
+            if (seg.startsWith(':...')) {
+                // Catch-all: capture remaining URL segments
+                if (i < urlSegments.length) {
+                    params[seg.slice(4)] = urlSegments.slice(i).join('/');
+                }
+                else {
+                    match = false;
+                }
+                break;
+            }
+            else if (seg.startsWith(':')) {
+                if (i >= urlSegments.length) {
+                    match = false;
+                    break;
+                }
+                params[seg.slice(1)] = urlSegments[i];
+            }
+            else if (i >= urlSegments.length || seg !== urlSegments[i]) {
+                match = false;
+                break;
+            }
+            // For non-catch-all routes, lengths must match
+            if (i === routeSegments.length - 1 && routeSegments.length !== urlSegments.length) {
+                match = false;
+            }
+        }
+        if (match) {
+            return { route, params };
+        }
+    }
+    return null;
+}

package/dist/shared/types.d.ts

@@ -0,0 +1,16 @@
+export interface ManifestLayout {
+    dir: string;
+    module: string;
+    hasLoader: boolean;
+}
+export interface ManifestRoute {
+    path: string;
+    module: string;
+    hasLoader: boolean;
+    layouts?: string[];
+}
+export interface BuildManifest {
+    routes: ManifestRoute[];
+    apiRoutes: ManifestRoute[];
+    layouts: ManifestLayout[];
+}

package/dist/shared/types.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/utils.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Strip the outer Lit SSR template markers from rendered HTML.
+ * Lit SSR wraps every template render in <!--lit-part HASH-->...<!--/lit-part-->.
+ * When inserting SSR HTML as light DOM (slot content), these markers must be
+ * removed so the parent element's hydration doesn't see a TemplateResult part.
+ */
+export declare function stripOuterLitMarkers(html: string): string;
+/**
+ * Convert a relative directory path within pages/ to a layout tag name.
+ *   ''          → 'layout-root'
+ *   'dashboard' → 'layout-dashboard'
+ *   'app/[id]'  → 'layout-app-id'
+ */
+export declare function dirToLayoutTagName(dir: string): string;
+/**
+ * Find the custom element tag name from a page module.
+ * Pages use @customElement('page-xxx') which registers the element.
+ */
+export declare function findTagName(mod: Record<string, any>): string | null;
+/**
+ * Check if a redirect response was returned from a loader.
+ */
+export declare function isRedirectResponse(value: any): value is {
+    location: string;
+    status?: number;
+};
+/**
+ * Read and parse the body of an HTTP request.
+ */
+export declare function readBody(req: any): Promise<any>;
+/**
+ * Escape HTML special characters for safe embedding.
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Check if a page/layout file exports a loader() function.
+ */
+export declare function fileHasLoader(filePath: string): boolean;
+/**
+ * Convert a file path (relative to pages/) to a route path.
+ */
+export declare function filePathToRoute(filePath: string): string;

package/dist/shared/utils.js

@@ -0,0 +1,109 @@
+import fs from 'fs';
+/**
+ * Strip the outer Lit SSR template markers from rendered HTML.
+ * Lit SSR wraps every template render in <!--lit-part HASH-->...<!--/lit-part-->.
+ * When inserting SSR HTML as light DOM (slot content), these markers must be
+ * removed so the parent element's hydration doesn't see a TemplateResult part.
+ */
+export function stripOuterLitMarkers(html) {
+    let result = html.replace(/^(<!--lit-part [^>]*-->)(\s*<!--lit-node \d+-->)?/, '');
+    result = result.replace(/<!--\/lit-part-->\s*$/, '');
+    return result;
+}
+/**
+ * Convert a relative directory path within pages/ to a layout tag name.
+ *   ''          → 'layout-root'
+ *   'dashboard' → 'layout-dashboard'
+ *   'app/[id]'  → 'layout-app-id'
+ */
+export function dirToLayoutTagName(dir) {
+    if (!dir)
+        return 'layout-root';
+    const name = dir
+        .replace(/\\/g, '-')
+        .replace(/\//g, '-')
+        .replace(/\[\.\.\.([^\]]+)\]/g, '$1')
+        .replace(/\[([^\]]+)\]/g, '$1')
+        .toLowerCase();
+    return `layout-${name}`;
+}
+/**
+ * Find the custom element tag name from a page module.
+ * Pages use @customElement('page-xxx') which registers the element.
+ */
+export function findTagName(mod) {
+    for (const key of Object.keys(mod)) {
+        const val = mod[key];
+        if (typeof val === 'function' && val.prototype) {
+            if (val.is)
+                return val.is;
+            if (val.elementProperties || val.properties) {
+                const className = val.name || key;
+                const tag = className
+                    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+                    .toLowerCase();
+                if (tag.includes('-'))
+                    return tag;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check if a redirect response was returned from a loader.
+ */
+export function isRedirectResponse(value) {
+    return value && typeof value === 'object' && typeof value.location === 'string' && value.__nk_redirect === true;
+}
+/**
+ * Read and parse the body of an HTTP request.
+ */
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        req.on('data', (chunk) => { data += chunk.toString(); });
+        req.on('end', () => {
+            if (!data)
+                return resolve(undefined);
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(data);
+            }
+        });
+        req.on('error', reject);
+    });
+}
+/**
+ * Escape HTML special characters for safe embedding.
+ */
+export function escapeHtml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+/**
+ * Check if a page/layout file exports a loader() function.
+ */
+export function fileHasLoader(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return /export\s+(async\s+)?function\s+loader\s*\(/.test(content);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Convert a file path (relative to pages/) to a route path.
+ */
+export function filePathToRoute(filePath) {
+    let route = filePath
+        .replace(/\.(ts|js)$/, '')
+        .replace(/\\/g, '/')
+        .replace(/\[\.\.\.([^\]]+)\]/g, ':...$1')
+        .replace(/\[([^\]]+)\]/g, ':$1');
+    if (route === 'index' || route.endsWith('/index')) {
+        route = route.slice(0, -5).replace(/\/$/, '') || '/';
+    }
+    return route.startsWith('/') ? route : '/' + route;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@nuraly/lumenjs",
+  "version": "0.1.0",
+  "description": "Full-stack Lit web component framework with file-based routing, server loaders, SSR, and API routes",
+  "type": "module",
+  "main": "dist/cli.js",
+  "bin": {
+    "lumenjs": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "lit",
+    "web-components",
+    "ssr",
+    "vite",
+    "framework",
+    "file-based-routing",
+    "loaders",
+    "api-routes",
+    "hydration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nuralyio/lumenjs.git"
+  },
+  "homepage": "https://github.com/Nuralyio/lumenjs",
+  "bugs": {
+    "url": "https://github.com/Nuralyio/lumenjs/issues"
+  },
+  "author": "labidiaymen <labidi@aymen.co>",
+  "license": "MIT",
+  "dependencies": {
+    "vite": "^5.4.0",
+    "lit": "^3.1.0",
+    "@lit-labs/ssr": "^3.2.0",
+    "glob": "^10.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.5",
+    "@types/node": "^20.14.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}