@emberkit/core 0.3.2 → 0.3.6

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export type { Signal, WritableSignal, ReadonlySignal } from './signals/index.js'
 export { createMarkdownParser, parseMarkdown, renderMarkdown, extractFrontmatter, } from './markdown/index.js';
 export { compileMDX, compileSync, useMDX } from './mdx/index.js';
 export { DataCache, createCache, getCached, setCache, prefetch } from './cache/index.js';
+export { renderToHTMLString } from './ssr/helpers/render-html.js';
+export { drainHeadContent } from './meta/head-registry.js';
 export { Head } from './meta/index.js';
 export type { HeadProps } from './meta/index.js';
 export { generateMeta, generateBreadcrumbs, generateArticleSchema, generateProductSchema, } from './meta/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,KAAK,EACL,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,GACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhF,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5E,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,KAAK,EACL,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,GACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhF,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5E,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAElG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErF"}

package/dist/index.js

@@ -9,6 +9,8 @@ export { createErrorBoundary, createLoadingBoundary } from './boundaries/index.j
 export { createMarkdownParser, parseMarkdown, renderMarkdown, extractFrontmatter, } from './markdown/index.js';
 export { compileMDX, compileSync, useMDX } from './mdx/index.js';
 export { DataCache, createCache, getCached, setCache, prefetch } from './cache/index.js';
+export { renderToHTMLString } from './ssr/helpers/render-html.js';
+export { drainHeadContent } from './meta/head-registry.js';
 export { Head } from './meta/index.js';
 export { generateMeta, generateBreadcrumbs, generateArticleSchema, generateProductSchema, } from './meta/index.js';
 export function defineConfig(config) {

package/dist/signals/helpers/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/signals/helpers/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKzD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAErE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,aAAa,CAAC,CAAC,CAAM,GAC7B,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAmEjE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAqB1F;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAqB5E;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvC;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAE3D;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAEtE"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/signals/helpers/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKzD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAErE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,aAAa,CAAC,CAAC,CAAM,GAC7B,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAoEjE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAqB1F;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAqB5E;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvC;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzC;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAE3D;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,MAAM,IAAI,CAEtE"}

package/dist/signals/helpers/core.js

@@ -9,6 +9,7 @@ export function getSignalByIndex(idx) {
 export function createSignal(initialValue, options = {}) {
     let value = initialValue;
     const subs = new Set();
+    const equals = options.equals ?? ((a, b) => a === b);
     const idx = sigIndex++;
     function getter() {
         return value;
@@ -16,7 +17,7 @@ export function createSignal(initialValue, options = {}) {
     getter.__idx = idx;
     function setter(newValue) {
         const next = typeof newValue === 'function' ? newValue(value) : newValue;
-        if (value === next)
+        if (equals(value, next))
             return;
         value = next;
         if (subs.size > 0) {
@@ -36,7 +37,7 @@ export function createSignal(initialValue, options = {}) {
         },
         set value(newValue) {
             const next = typeof newValue === 'function' ? newValue(value) : newValue;
-            if (value === next)
+            if (equals(value, next))
                 return;
             value = next;
             if (subs.size > 0) {

package/dist/ssr/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
 export * from './helpers/render-html.js';
 export * from './helpers/ssr.js';
+export * from './server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ssr/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/ssr/index.js

@@ -1,3 +1,4 @@
 export * from './types.js';
 export * from './helpers/render-html.js';
 export * from './helpers/ssr.js';
+export * from './server.js';

package/dist/ssr/server.d.ts

@@ -0,0 +1,34 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { JSXNode } from '../runtime/types.js';
+export interface SSRManifest {
+    routes: SSRRouteEntry[];
+    clientEntry: string;
+    assets: string[];
+}
+export interface SSRRouteEntry {
+    path: string;
+    component: () => Promise<{
+        default: (props: Record<string, unknown>) => JSXNode;
+    }>;
+    isStatic?: boolean;
+    prerendered?: boolean;
+}
+export interface SSRServerOptions {
+    manifest: SSRManifest;
+    mode: 'ssr' | 'hybrid' | 'static';
+    distDir: string;
+    template: string;
+}
+export interface SSRRequestContext {
+    url: string;
+    pathname: string;
+    params: Record<string, string>;
+    query: Record<string, string>;
+}
+export declare function renderRoute(options: SSRServerOptions, context: SSRRequestContext): Promise<{
+    html: string;
+    status: number;
+}>;
+export declare function createSSRHandler(options: SSRServerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<boolean>;
+export declare function prerenderRoutes(options: SSRServerOptions, outputDir: string): Promise<Map<string, string>>;
+//# sourceMappingURL=server.d.ts.map

package/dist/ssr/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ssr/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;KAAE,CAAC,CAAC;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AA8CD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD3C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,IAC1C,KAAK,eAAe,EAAE,KAAK,cAAc,KAAG,OAAO,CAAC,OAAO,CAAC,CAuC3E;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmC9B"}

package/dist/ssr/server.js

@@ -0,0 +1,148 @@
+import { renderToHTMLString } from './helpers/render-html.js';
+import { drainHeadContent } from '../meta/head-registry.js';
+const routeToRegex = (routePath) => {
+    const paramNames = [];
+    const regexStr = routePath
+        .replace(/:([^/]+)\*/g, (_, name) => {
+        paramNames.push(name);
+        return '(.*)';
+    })
+        .replace(/:([^/]+)/g, (_, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp('^' + regexStr + '$'), paramNames };
+};
+const matchRoute = (routes, pathname) => {
+    const normalizedPath = pathname.replace(/\/+$/, '') || '/';
+    for (const route of routes) {
+        const pattern = routeToRegex(route.path);
+        const match = normalizedPath.match(pattern.regex);
+        if (match) {
+            const params = {};
+            pattern.paramNames.forEach((name, i) => {
+                params[name] = match[i + 1];
+            });
+            return { route, params };
+        }
+    }
+    return null;
+};
+const escapeHtml = (str) => {
+    if (typeof str !== 'string')
+        return str;
+    return str
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+};
+export async function renderRoute(options, context) {
+    const { manifest, template } = options;
+    const sortedRoutes = [...manifest.routes].sort((a, b) => {
+        const aScore = a.path.includes(':') ? 0 : 1;
+        const bScore = b.path.includes(':') ? 0 : 1;
+        return bScore - aScore;
+    });
+    const match = matchRoute(sortedRoutes, context.pathname);
+    let appHtml = '';
+    let headContent = '';
+    let status = 200;
+    if (match) {
+        try {
+            const mod = await match.route.component();
+            const Component = mod.default;
+            const element = Component({ params: match.params });
+            appHtml = renderToHTMLString(element);
+            const collectedHead = drainHeadContent();
+            if (collectedHead) {
+                headContent = collectedHead;
+            }
+        }
+        catch (e) {
+            console.error('[SSR] Failed to render route:', context.pathname, e);
+            appHtml = `<div style="color: red; padding: 20px;">SSR Error: ${escapeHtml(String(e))}</div>`;
+            status = 500;
+        }
+    }
+    else {
+        appHtml = '<div style="padding: 20px;">404 - Page not found</div>';
+        status = 404;
+    }
+    let html = template;
+    if (html.includes('<body id="app">')) {
+        html = html.replace('<body id="app">', '<body id="app">' + appHtml);
+    }
+    else if (html.includes('<div id="app">')) {
+        html = html.replace('<div id="app"></div>', '<div id="app">' + appHtml + '</div>');
+    }
+    else if (html.includes('<div id="app"/>')) {
+        html = html.replace('<div id="app"/>', '<div id="app">' + appHtml + '</div>');
+    }
+    if (headContent && html.includes('</head>')) {
+        html = html.replace('</head>', headContent + '</head>');
+    }
+    return { html, status };
+}
+export function createSSRHandler(options) {
+    return async (req, res) => {
+        const url = req.url ?? '/';
+        const urlObj = new URL(url, `http://${req.headers.host || 'localhost'}`);
+        const pathname = urlObj.pathname;
+        if (pathname.startsWith('/assets/') ||
+            pathname.includes('.') ||
+            req.headers.accept?.includes('application/json')) {
+            return false;
+        }
+        if (!req.headers.accept?.includes('text/html')) {
+            return false;
+        }
+        const context = {
+            url,
+            pathname,
+            params: {},
+            query: Object.fromEntries(urlObj.searchParams),
+        };
+        try {
+            const { html, status } = await renderRoute(options, context);
+            res.statusCode = status;
+            res.setHeader('Content-Type', 'text/html; charset=utf-8');
+            res.end(html);
+            return true;
+        }
+        catch (error) {
+            console.error('[SSR Server Error]', error);
+            res.statusCode = 500;
+            res.setHeader('Content-Type', 'text/html');
+            res.end('<h1>500 - Internal Server Error</h1>');
+            return true;
+        }
+    };
+}
+export async function prerenderRoutes(options, outputDir) {
+    const { writeFile, mkdir } = await import('node:fs/promises');
+    const { join, dirname } = await import('node:path');
+    const prerendered = new Map();
+    const staticRoutes = options.manifest.routes.filter((route) => route.isStatic || !route.path.includes(':'));
+    for (const route of staticRoutes) {
+        const context = {
+            url: route.path,
+            pathname: route.path,
+            params: {},
+            query: {},
+        };
+        try {
+            const { html } = await renderRoute(options, context);
+            const filePath = route.path === '/' ? join(outputDir, 'index.html') : join(outputDir, route.path, 'index.html');
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, html, 'utf-8');
+            prerendered.set(route.path, filePath);
+            console.log(`  ✓ Prerendered: ${route.path}`);
+        }
+        catch (error) {
+            console.error(`  ✗ Failed to prerender: ${route.path}`, error);
+        }
+    }
+    return prerendered;
+}

package/dist/vite-plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoBtE,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,qBAA0B,GAAG,MAAM,CA8FlF;AA8kCD,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8CtE,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,qBAA0B,GAAG,MAAM,CA8IlF;AA6hCD,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,CAAC"}

package/dist/vite-plugin/index.js

@@ -7,20 +7,47 @@ import remarkGfm from 'remark-gfm';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const VIRTUAL_EMBERKIT_CONFIG = 'virtual:emberkit-config';
 const VIRTUAL_EMBERKIT_ROUTES = 'virtual:emberkit-routes';
-function resolveConfig(userOptions = {}) {
+const VIRTUAL_SSR_ENTRY = 'virtual:emberkit-ssr-entry';
+async function loadEmberKitConfig(root) {
+    const { pathToFileURL } = await import('node:url');
+    const configPaths = [
+        join(root, 'emberkit.config.ts'),
+        join(root, 'emberkit.config.js'),
+        join(root, 'emberkit.config.mjs'),
+    ];
+    for (const configPath of configPaths) {
+        if (existsSync(configPath)) {
+            try {
+                const configUrl = pathToFileURL(configPath).href;
+                const mod = await import(configUrl);
+                return mod.default || mod;
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return {};
+}
+function resolveConfig(userOptions = {}, fileConfig = {}) {
     return {
         ...DEFAULT_CONFIG,
+        ...fileConfig,
         ...userOptions,
-        markdown: { ...DEFAULT_CONFIG.markdown, ...userOptions.markdown },
+        markdown: { ...DEFAULT_CONFIG.markdown, ...fileConfig.markdown, ...userOptions.markdown },
     };
 }
 export function emberkitVitePlugin(userOptions = {}) {
-    const options = resolveConfig(userOptions);
+    let options = resolveConfig(userOptions);
     let routesCode = `export const routes = [];`;
+    let projectRoot = process.cwd();
     return {
         name: 'emberkit:vite-plugin',
         enforce: 'pre',
-        async config() {
+        async config(config) {
+            projectRoot = config.root || process.cwd();
+            const fileConfig = await loadEmberKitConfig(projectRoot);
+            options = resolveConfig(userOptions, fileConfig);
             const pkgRoot = resolve(__dirname, '..', '..');
             const srcDir = join(pkgRoot, 'src');
             const plugins = [];
@@ -63,6 +90,9 @@ export function emberkitVitePlugin(userOptions = {}) {
             if (id === VIRTUAL_EMBERKIT_ROUTES) {
                 return VIRTUAL_EMBERKIT_ROUTES;
             }
+            if (id === VIRTUAL_SSR_ENTRY) {
+                return VIRTUAL_SSR_ENTRY;
+            }
             return null;
         },
         load(id) {
@@ -72,8 +102,42 @@ export function emberkitVitePlugin(userOptions = {}) {
             if (id === VIRTUAL_EMBERKIT_ROUTES) {
                 return routesCode;
             }
+            if (id === VIRTUAL_SSR_ENTRY) {
+                return generateSSREntry();
+            }
             return null;
         },
+        configureServer(server) {
+            if (options.mode === 'spa') {
+                return;
+            }
+            server.middlewares.use(async (req, res, next) => {
+                const url = req.url ?? '/';
+                if (url.startsWith('/@') ||
+                    url.startsWith('/__') ||
+                    url.startsWith('/node_modules') ||
+                    url.startsWith('/src/') ||
+                    url.includes('.') ||
+                    req.headers.accept?.includes('application/json')) {
+                    return next();
+                }
+                if (!req.headers.accept?.includes('text/html')) {
+                    return next();
+                }
+                try {
+                    const ssrModule = await server.ssrLoadModule(VIRTUAL_SSR_ENTRY);
+                    const html = await ssrModule.render(url, server);
+                    res.statusCode = 200;
+                    res.setHeader('Content-Type', 'text/html');
+                    res.end(html);
+                }
+                catch (error) {
+                    server.ssrFixStacktrace(error);
+                    console.error('[EmberKit SSR Error]', error);
+                    next(error);
+                }
+            });
+        },
         transform(code, id) {
             if (id.includes('\u0000'))
                 return null;
@@ -146,7 +210,50 @@ export default function MDComponent(props) {
 `;
     return { code: componentCode };
 }
-async function transformMDX(code, id) {
+/** Insert a block after leading `import` lines so output stays valid ESM (imports first). */
+function insertAfterLeadingImports(moduleSource, insertBlock) {
+    const lines = moduleSource.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const t = lines[i].trimStart();
+        if (t === '' || t.startsWith('import ')) {
+            i++;
+            continue;
+        }
+        break;
+    }
+    const head = lines.slice(0, i).join('\n');
+    const tail = lines.slice(i).join('\n');
+    const mid = insertBlock.trim();
+    if (!mid) {
+        return moduleSource;
+    }
+    return `${head}\n\n${mid}\n\n${tail}`;
+}
+/**
+ * Returns true when `code` is already compiled JS (e.g. from Vite's dep
+ * pre-bundling cache) and does not need to be run through @mdx-js/mdx again.
+ */
+function isAlreadyCompiledMDX(code) {
+    const trimmed = code.trimStart();
+    // Compiled MDX always starts with a JS import declaration generated by
+    // @mdx-js/mdx (jsx-runtime import) or is plain JS with no MDX markers.
+    // Raw MDX starts with frontmatter (---), a heading (#), a paragraph, or
+    // a top-level JSX element (<Component...) — none of which begin with
+    // `import {` followed by jsx-runtime exports.
+    return (trimmed.startsWith('import {Fragment') ||
+        trimmed.startsWith('import{Fragment') ||
+        trimmed.startsWith('import {jsx') ||
+        trimmed.startsWith('import{jsx') ||
+        trimmed.startsWith('"use strict"'));
+}
+async function transformMDX(code, _id) {
+    // Guard: Vite's dep pre-bundling may pass the already-compiled JS back
+    // through the transform pipeline. Return it unchanged so we don't try to
+    // compile valid JS as MDX source.
+    if (isAlreadyCompiledMDX(code)) {
+        return { code };
+    }
     const frontmatterMatch = code.match(/^---\n([\s\S]*?)\n---\n?/);
     let frontmatter = {};
     let content = code;
@@ -155,34 +262,12 @@ async function transformMDX(code, id) {
         frontmatter = parseFrontmatter(fmContent);
         content = code.slice(frontmatterMatch[0].length);
     }
-    // Extract code blocks before MDX compilation to preserve syntax
-    const codeBlocks = [];
-    const processedContent = content.replace(/```(\w*)\n([\s\S]*?)```/g, (_match, lang, blockCode) => {
-        const html = renderCodeBlock(lang, blockCode);
-        codeBlocks.push({ html, index: codeBlocks.length });
-        return `<CodeBlock_${codeBlocks.length - 1} />`;
-    });
-    const compiled = await compile(processedContent, {
-        outputFormat: 'program',
-        development: false,
+    const compiled = await compile(content, {
         jsx: false,
         jsxImportSource: '@emberkit/core',
         remarkPlugins: [remarkGfm],
+        development: false,
     });
-    let compiledCode = String(compiled);
-    // Build code block component definitions
-    const codeBlockComponents = codeBlocks
-        .map((block) => {
-        const escapedHtml = JSON.stringify(block.html);
-        return `function CodeBlock_${block.index}() {
-  return createElement('div', { 
-    dangerouslySetInnerHTML: { __html: ${escapedHtml} }
-  });
-}`;
-    })
-        .join('\n\n');
-    // Rename the MDX default export so we can wrap it
-    compiledCode = compiledCode.replace('export default function MDXContent', 'function _MDXContent');
     const exportLines = [];
     if (frontmatter.title) {
         exportLines.push(`export const title = ${JSON.stringify(frontmatter.title)};`);
@@ -197,70 +282,27 @@ async function transformMDX(code, id) {
         exportLines.push(`export const date = ${JSON.stringify(frontmatter.date)};`);
     }
     exportLines.push(`export const metadata = ${JSON.stringify(frontmatter)};`);
-    // Build components override object
-    const componentsOverride = codeBlocks.length > 0
-        ? `
-const _codeBlockComponents = {
-  ${codeBlocks.map((b) => `CodeBlock_${b.index}`).join(', ')}
-};
-`
-        : '';
-    const componentCode = `
-import { createElement } from '@emberkit/core';
-
-${exportLines.join('\n')}
-
-${codeBlockComponents}
-${componentsOverride}
-
-${compiledCode}
-
-function _GfmTable(props) {
-  return createElement('div', { className: 'table-wrapper' },
-    createElement('table', { className: 'gfm-table' }, props.children)
-  );
-}
-
-function _GfmUl(props) {
-  return createElement('ul', { className: 'task-list' }, props.children);
-}
-
-function _GfmLi(props) {
-  return createElement('li', { className: 'task-item' }, props.children);
-}
-
-function _GfmDel(props) {
-  return createElement('span', { className: 'strikethrough' }, props.children);
-}
-
-function _GfmSup(props) {
-  return createElement('span', { className: 'footnote-ref' }, props.children);
-}
-
+    let body = typeof compiled === 'object' && compiled !== null && 'value' in compiled
+        ? String(compiled.value)
+        : String(compiled);
+    // Rename the @mdx-js/mdx default export so we can wrap it with the
+    // md-doc / md-content styling containers that the docs CSS targets.
+    body = body.replace(/export default function MDXContent/, 'function _MDXContent');
+    // Wrapper re-exports the component with the styling containers.
+    // We reuse _jsx/_jsxs already imported by the compiled output.
+    const wrapper = `
 export default function MDXComponent(props) {
-  const components = {
-    ...(props.components || {}),
-    ${codeBlocks.map((b) => `CodeBlock_${b.index}`).join(', ')}
-  };
-  
-  return createElement('div', {
-    className: 'md-content md-doc',
-    'data-file': ${JSON.stringify(id)},
-    children: createElement(_MDXContent, { 
-      ...props, 
-      components: {
-        ...components,
-        table: _GfmTable,
-        ul: _GfmUl,
-        li: _GfmLi,
-        del: _GfmDel,
-        sup: _GfmSup,
-      }
+  var p = props ?? {};
+  return _jsx('article', {
+    className: 'md-doc',
+    children: _jsx('div', {
+      className: 'md-content',
+      children: _jsx(_MDXContent, p)
     })
   });
 }
 `;
-    return { code: componentCode };
+    return { code: insertAfterLeadingImports(body + wrapper, exportLines.join('\n')) };
 }
 function parseFrontmatter(content) {
     const result = {};
@@ -336,10 +378,8 @@ function renderCodeBlock(lang, code) {
     else if (lang === 'css' || lang === 'scss' || lang === 'sass' || lang === 'less') {
         highlighted = highlightCSS(highlighted);
     }
-    else if (lang === 'markdown' || lang === 'md') {
-        highlighted = highlightMarkdown(highlighted);
-    }
     else {
+        // Markdown (and unknown) fenced blocks: literal source only — do not tokenize as markdown/HTML.
         highlighted = escapeHtml(highlighted);
     }
     const langAttr = lang ? ` data-lang="${lang}"` : '';
@@ -895,35 +935,6 @@ function highlightCSS(code) {
     }
     return tokens.join('');
 }
-function highlightMarkdown(code) {
-    return code
-        .split('\n')
-        .map((line) => {
-        const escaped = escapeHtml(line);
-        // Frontmatter delimiter
-        if (/^---$/.test(line))
-            return `<span class="op">${escaped}</span>`;
-        // Headings
-        const headingM = line.match(/^(#{1,6})\s(.+)/);
-        if (headingM) {
-            return `<span class="kw">${escapeHtml(headingM[1])}</span> <span class="tag">${escapeHtml(headingM[2])}</span>`;
-        }
-        // Bold / italic markers (keep simple — just colour the line)
-        if (/^\s*[-*+]\s/.test(line)) {
-            return `<span class="op">${escapeHtml(line.match(/^(\s*[-*+])/)[1])}</span>${escapeHtml(line.slice(line.match(/^(\s*[-*+])/)[1].length))}`;
-        }
-        // Blockquote
-        if (/^>/.test(line))
-            return `<span class="cm">${escaped}</span>`;
-        // Frontmatter key: value
-        const fmM = line.match(/^([\w-]+):\s*(.*)/);
-        if (fmM) {
-            return `<span class="attr">${escapeHtml(fmM[1])}</span><span class="op">:</span> <span class="str">${escapeHtml(fmM[2])}</span>`;
-        }
-        return escaped;
-    })
-        .join('\n');
-}
 function processTables(html) {
     const lines = html.split('\n');
     const result = [];
@@ -1087,6 +1098,190 @@ function processParagraphs(html, breaks) {
     })
         .join('');
 }
+function generateSSREntry() {
+    return `
+import { routes } from 'virtual:emberkit-routes';
+import { createElement } from '@emberkit/core';
+
+const matchRoute = (routes, pathname) => {
+  const normalizedPath = pathname.replace(/\\/+$/, '') || '/';
+  
+  for (const route of routes) {
+    const pattern = routeToRegex(route.path);
+    const match = normalizedPath.match(pattern.regex);
+    if (match) {
+      const params = {};
+      pattern.paramNames.forEach((name, i) => {
+        params[name] = match[i + 1];
+      });
+      return { route, params };
+    }
+  }
+  return null;
+};
+
+const routeToRegex = (routePath) => {
+  const paramNames = [];
+  const regexStr = routePath
+    .replace(/:([^/]+)\\*/g, (_, name) => {
+      paramNames.push(name);
+      return '(.*)';
+    })
+    .replace(/:([^/]+)/g, (_, name) => {
+      paramNames.push(name);
+      return '([^/]+)';
+    });
+  return { regex: new RegExp('^' + regexStr + '$'), paramNames };
+};
+
+const renderToString = (element) => {
+  if (!element && element !== 0) return '';
+  if (typeof element === 'string') return escapeHtml(element);
+  if (typeof element === 'number') return String(element);
+  if (Array.isArray(element)) return element.map(renderToString).join('');
+  
+  if (typeof element !== 'object' || !element.type) return '';
+  
+  let { type, props } = element;
+  props = props || {};
+  
+  // Resolve function components
+  let depth = 0;
+  while (typeof type === 'function' && depth < 50) {
+    depth++;
+    try {
+      const result = type(props);
+      if (result && typeof result === 'object' && result.type) {
+        type = result.type;
+        props = result.props || {};
+      } else if (typeof result === 'string' || typeof result === 'number') {
+        return typeof result === 'string' ? escapeHtml(result) : String(result);
+      } else if (Array.isArray(result)) {
+        return result.map(renderToString).join('');
+      } else {
+        return '';
+      }
+    } catch (e) {
+      console.error('[SSR render error]', e);
+      return '';
+    }
+  }
+  
+  if (type === 'Fragment' || type === 'React.Fragment') {
+    const children = Array.isArray(props.children) ? props.children : [props.children];
+    return children.filter(Boolean).map(renderToString).join('');
+  }
+  
+  const SELF_CLOSING = new Set(['area','base','br','col','embed','hr','img','input','link','meta','source','track','wbr']);
+  
+  const children = Array.isArray(props.children) ? props.children : (props.children ? [props.children] : []);
+  let childHtml = children.filter(c => c != null).map(renderToString).join('');
+  
+  // Handle dangerouslySetInnerHTML
+  if (props.dangerouslySetInnerHTML && props.dangerouslySetInnerHTML.__html) {
+    childHtml = props.dangerouslySetInnerHTML.__html;
+  }
+  
+  const attrs = Object.entries(props)
+    .filter(([k, v]) => k !== 'children' && k !== 'key' && k !== 'dangerouslySetInnerHTML' && v != null && typeof v !== 'function')
+    .map(([k, v]) => {
+      if (k === 'className') k = 'class';
+      if (v === true) return ' ' + k;
+      if (v === false) return '';
+      if (k === 'style' && typeof v === 'object') {
+        const styleStr = Object.entries(v)
+          .filter(([, sv]) => sv != null)
+          .map(([sp, sv]) => sp.replace(/([A-Z])/g, '-$1').toLowerCase() + ': ' + sv)
+          .join('; ');
+        return ' ' + k + '="' + escapeHtml(styleStr) + '"';
+      }
+      return ' ' + k + '="' + escapeHtml(String(v)) + '"';
+    })
+    .join('');
+  
+  if (SELF_CLOSING.has(type)) {
+    return '<' + type + attrs + '/>';
+  }
+  
+  return '<' + type + attrs + '>' + childHtml + '</' + type + '>';
+};
+
+const escapeHtml = (str) => {
+  if (typeof str !== 'string') return str;
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;');
+};
+
+export async function render(url, server) {
+  const pathname = url.split('?')[0];
+  
+  // Sort routes: static first, then dynamic
+  const sortedRoutes = [...routes].sort((a, b) => {
+    const aScore = a.path.includes(':') ? 0 : 1;
+    const bScore = b.path.includes(':') ? 0 : 1;
+    return bScore - aScore;
+  });
+  
+  const match = matchRoute(sortedRoutes, pathname);
+  
+  let appHtml = '';
+  let headContent = '';
+  
+  if (match) {
+    try {
+      const mod = await match.route.component();
+      const Component = mod.default || mod;
+      
+      // Get metadata if available
+      if (mod.metadata) {
+        if (mod.metadata.title) {
+          headContent += '<title>' + escapeHtml(mod.metadata.title) + '</title>\\n';
+        }
+        if (mod.metadata.description) {
+          headContent += '<meta name="description" content="' + escapeHtml(mod.metadata.description) + '">\\n';
+        }
+      }
+      
+      const element = createElement(Component, { params: match.params });
+      appHtml = renderToString(element);
+    } catch (e) {
+      console.error('[SSR] Failed to render route:', pathname, e);
+      appHtml = '<div style="color: red; padding: 20px;">SSR Error: ' + escapeHtml(String(e)) + '</div>';
+    }
+  } else {
+    appHtml = '<div style="padding: 20px;">404 - Page not found</div>';
+  }
+  
+  // Load and transform index.html
+  const fs = await import('node:fs');
+  const path = await import('node:path');
+  const indexPath = path.join(server.config.root, 'index.html');
+  let template = fs.readFileSync(indexPath, 'utf-8');
+  template = await server.transformIndexHtml(url, template);
+  
+  // Inject SSR content
+  // Look for body with id="app" or div with id="app"
+  if (template.includes('<body id="app">')) {
+    template = template.replace('<body id="app">', '<body id="app">' + appHtml);
+  } else if (template.includes('<div id="app">')) {
+    template = template.replace('<div id="app"></div>', '<div id="app">' + appHtml + '</div>');
+  } else if (template.includes('<div id="app"/>')) {
+    template = template.replace('<div id="app"/>', '<div id="app">' + appHtml + '</div>');
+  }
+  
+  // Inject head content if any
+  if (headContent && template.includes('</head>')) {
+    template = template.replace('</head>', headContent + '</head>');
+  }
+  
+  return template;
+}
+`;
+}
 function scanRouteFiles(dir) {
     const files = [];
     const extensions = new Set(['tsx', 'ts', 'jsx', 'js', 'md', 'mdx']);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emberkit/core",
-  "version": "0.3.2",
+  "version": "0.3.6",
   "type": "module",
   "private": false,
   "description": "Lightweight TypeScript-first JSX framework core",