npm - @nuraly/lumenjs - Versions diffs - 0.1.0 → 0.1.2 - Mend

@nuraly/lumenjs 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

package/README.md +76 -0
package/dist/build/build.js +19 -1
package/dist/build/serve-i18n.d.ts +6 -0
package/dist/build/serve-i18n.js +26 -0
package/dist/build/serve-loaders.js +7 -2
package/dist/build/serve-ssr.js +3 -3
package/dist/build/serve.js +20 -4
package/dist/dev-server/config.d.ts +6 -0
package/dist/dev-server/config.js +27 -1
package/dist/dev-server/index-html.d.ts +7 -0
package/dist/dev-server/index-html.js +15 -2
package/dist/dev-server/middleware/locale.d.ts +20 -0
package/dist/dev-server/middleware/locale.js +55 -0
package/dist/dev-server/plugins/vite-plugin-i18n.d.ts +15 -0
package/dist/dev-server/plugins/vite-plugin-i18n.js +71 -0
package/dist/dev-server/plugins/vite-plugin-loaders.js +16 -2
package/dist/dev-server/plugins/vite-plugin-routes.js +1 -11
package/dist/dev-server/plugins/vite-plugin-source-annotator.js +8 -1
package/dist/dev-server/plugins/vite-plugin-virtual-modules.d.ts +5 -0
package/dist/dev-server/plugins/vite-plugin-virtual-modules.js +52 -22
package/dist/dev-server/server.d.ts +1 -1
package/dist/dev-server/server.js +48 -10
package/dist/dev-server/ssr-render.d.ts +1 -1
package/dist/dev-server/ssr-render.js +23 -8
package/dist/editor/editor-bridge.d.ts +1 -1
package/dist/editor/inline-text-edit.js +15 -4
package/dist/runtime/i18n.d.ts +56 -0
package/dist/runtime/i18n.js +100 -0
package/dist/runtime/router-data.js +9 -0
package/dist/runtime/router-hydration.js +15 -1
package/dist/runtime/router.d.ts +4 -0
package/dist/runtime/router.js +20 -4
package/dist/shared/types.d.ts +7 -0
package/dist/shared/utils.d.ts +7 -0
package/dist/shared/utils.js +16 -0
package/package.json +11 -6

package/README.md CHANGED Viewed

@@ -105,6 +105,7 @@ Loaders run server-side on initial load (SSR) and are fetched via `/__nk_loader/
 | `query` | `Record<string, string>` | Query string parameters |
 | `url` | `string` | Request pathname |
 | `headers` | `Record<string, any>` | Request headers |
+| `locale` | `string` | Current locale (when i18n is configured) |
 ### Redirects
@@ -223,6 +224,81 @@ Pages with loaders are automatically server-rendered using `@lit-labs/ssr`:
 Pages without loaders render client-side only (SPA mode). If SSR fails, LumenJS falls back gracefully to client-side rendering.
+## Internationalization (i18n)
+LumenJS has built-in i18n support with URL-prefix-based locale routing.
+### Setup
+1. Add i18n config to `lumenjs.config.ts`:
+```typescript
+export default {
+  title: 'My App',
+  i18n: {
+    locales: ['en', 'fr'],
+    defaultLocale: 'en',
+    prefixDefault: false, // / instead of /en/
+  },
+};
+```
+2. Create translation files in `locales/`:
+```
+my-app/
+├── locales/
+│   ├── en.json    # { "home.title": "Welcome", "nav.docs": "Docs" }
+│   └── fr.json    # { "home.title": "Bienvenue", "nav.docs": "Documentation" }
+├── pages/
+└── lumenjs.config.ts
+```
+### Usage
+```typescript
+import { t, getLocale, setLocale } from '@lumenjs/i18n';
+@customElement('page-index')
+export class PageIndex extends LitElement {
+  render() {
+    return html`<h1>${t('home.title')}</h1>`;
+  }
+}
+```
+### API
+| Function | Description |
+|---|---|
+| `t(key)` | Returns the translated string for the key, or the key itself if not found |
+| `getLocale()` | Returns the current locale string |
+| `setLocale(locale)` | Switches locale — sets cookie, navigates to the localized URL |
+### Locale Resolution
+Locale is resolved in this order:
+1. URL prefix: `/fr/about` → locale `fr`, pathname `/about`
+2. Cookie `nk-locale` (set on explicit locale switch)
+3. `Accept-Language` header (SSR)
+4. Config `defaultLocale`
+### URL Routing
+With `prefixDefault: false`, the default locale uses clean URLs:
+| URL | Locale | Page |
+|---|---|---|
+| `/about` | `en` (default) | `pages/about.ts` |
+| `/fr/about` | `fr` | `pages/about.ts` |
+Routes are locale-agnostic — you don't need separate pages per locale. The router strips the locale prefix before matching and prepends it during navigation.
+### SSR
+Translations are server-rendered. The `<html lang="...">` attribute is set dynamically, and translations are inlined in the response for hydration without flash of untranslated content.
 ## Integrations
 ### Tailwind CSS

package/dist/build/build.js CHANGED Viewed

@@ -4,6 +4,7 @@ import fs from 'fs';
 import { getSharedViteConfig } from '../dev-server/server.js';
 import { readProjectConfig } from '../dev-server/config.js';
 import { generateIndexHtml } from '../dev-server/index-html.js';
+import { filePathToTagName } from '../shared/utils.js';
 import { scanPages, scanLayouts, scanApiRoutes, getLayoutDirsForPage } from './scan.js';
 export async function buildProject(options) {
     const { projectDir } = options;
@@ -18,7 +19,7 @@ export async function buildProject(options) {
         fs.rmSync(outDir, { recursive: true });
     }
     fs.mkdirSync(outDir, { recursive: true });
-    const { title, integrations } = readProjectConfig(projectDir);
+    const { title, integrations, i18n: i18nConfig } = readProjectConfig(projectDir);
     const shared = getSharedViteConfig(projectDir, { mode: 'production', integrations });
     // Scan pages, layouts, and API routes for the manifest
     const pageEntries = scanPages(pagesDir);
@@ -141,14 +142,30 @@ export async function buildProject(options) {
             fs.unlinkSync(ssrEntryPath);
         }
     }
+    // --- Copy locales ---
+    if (i18nConfig) {
+        const localesDir = path.join(projectDir, 'locales');
+        const outLocalesDir = path.join(outDir, 'locales');
+        if (fs.existsSync(localesDir)) {
+            fs.mkdirSync(outLocalesDir, { recursive: true });
+            for (const file of fs.readdirSync(localesDir)) {
+                if (file.endsWith('.json')) {
+                    fs.copyFileSync(path.join(localesDir, file), path.join(outLocalesDir, file));
+                }
+            }
+            console.log(`[LumenJS] Copied ${i18nConfig.locales.length} locale(s) to output.`);
+        }
+    }
     // --- Write manifest ---
     const manifest = {
         routes: pageEntries.map(e => {
             const routeLayouts = getLayoutDirsForPage(e.filePath, pagesDir, layoutEntries);
+            const relPath = path.relative(pagesDir, e.filePath).replace(/\\/g, '/');
             return {
                 path: e.routePath,
                 module: e.hasLoader ? `pages/${e.name}.js` : '',
                 hasLoader: e.hasLoader,
+                tagName: filePathToTagName(relPath),
                 ...(routeLayouts.length > 0 ? { layouts: routeLayouts } : {}),
             };
         }),
@@ -162,6 +179,7 @@ export async function buildProject(options) {
             module: e.hasLoader ? (e.dir ? `layouts/${e.dir}/_layout.js` : 'layouts/_layout.js') : '',
             hasLoader: e.hasLoader,
         })),
+        ...(i18nConfig ? { i18n: i18nConfig } : {}),
     };
     fs.writeFileSync(path.join(outDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
     console.log('[LumenJS] Build complete.');

package/dist/build/serve-i18n.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import http from 'http';
+/**
+ * Handle `/__nk_i18n/<locale>.json` requests in production.
+ * Reads from the built `locales/` directory.
+ */
+export declare function handleI18nRequest(localesDir: string, locales: string[], pathname: string, req: http.IncomingMessage, res: http.ServerResponse): boolean;

package/dist/build/serve-i18n.js ADDED Viewed

@@ -0,0 +1,26 @@
+import fs from 'fs';
+import path from 'path';
+import { sendCompressed } from './serve-static.js';
+/**
+ * Handle `/__nk_i18n/<locale>.json` requests in production.
+ * Reads from the built `locales/` directory.
+ */
+export function handleI18nRequest(localesDir, locales, pathname, req, res) {
+    const match = pathname.match(/^\/__nk_i18n\/([a-z]{2}(?:-[a-zA-Z]+)?)\.json$/);
+    if (!match)
+        return false;
+    const locale = match[1];
+    if (!locales.includes(locale)) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Unknown locale' }));
+        return true;
+    }
+    const filePath = path.join(localesDir, `${locale}.json`);
+    if (!fs.existsSync(filePath)) {
+        sendCompressed(req, res, 200, 'application/json', '{}');
+        return true;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    sendCompressed(req, res, 200, 'application/json', content);
+    return true;
+}

package/dist/build/serve-loaders.js CHANGED Viewed

@@ -31,7 +31,10 @@ export async function handleLayoutLoaderRequest(manifest, serverDir, queryString
             res.end(JSON.stringify({ __nk_no_loader: true }));
             return;
         }
-        const result = await mod.loader({ params: {}, query: {}, url: `/__layout/${dir}`, headers });
+        // Parse locale from query for layout loader
+        const locale = query.__locale;
+        delete query.__locale;
+        const result = await mod.loader({ params: {}, query: {}, url: `/__layout/${dir}`, headers, locale });
         if (isRedirectResponse(result)) {
             res.writeHead(result.status || 302, { Location: result.location });
             res.end();
@@ -91,7 +94,9 @@ export async function handleLoaderRequest(manifest, serverDir, pagesDir, pathnam
             res.end(JSON.stringify({ __nk_no_loader: true }));
             return;
         }
-        const result = await mod.loader({ params: matched.params, query, url: pagePath, headers });
+        const locale = query.__locale;
+        delete query.__locale;
+        const result = await mod.loader({ params: matched.params, query, url: pagePath, headers, locale });
         if (isRedirectResponse(result)) {
             res.writeHead(result.status || 302, { Location: result.location });
             res.end();

package/dist/build/serve-ssr.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { stripOuterLitMarkers, dirToLayoutTagName, findTagName, isRedirectResponse } from '../shared/utils.js';
+import { stripOuterLitMarkers, dirToLayoutTagName, isRedirectResponse } from '../shared/utils.js';
 import { matchRoute } from '../shared/route-matching.js';
 import { sendCompressed } from './serve-static.js';
 export async function handlePageRoute(manifest, serverDir, pagesDir, pathname, queryString, indexHtmlShell, title, ssrRuntime, req, res) {
@@ -23,8 +23,8 @@ export async function handlePageRoute(manifest, serverDir, pagesDir, pathname, q
                         return;
                     }
                 }
-                // Find tag name from module
-                const tagName = findTagName(mod);
+                // Use tag name from route manifest (matches client router)
+                const tagName = matched.route.tagName;
                 // Run layout loaders
                 const layoutDirs = (allMatched || matched).route.layouts || [];
                 const layoutsData = [];

package/dist/build/serve.js CHANGED Viewed

@@ -8,6 +8,8 @@ import { handleApiRoute } from './serve-api.js';
 import { handleLoaderRequest, handleLayoutLoaderRequest } from './serve-loaders.js';
 import { handlePageRoute } from './serve-ssr.js';
 import { renderErrorPage } from './error-page.js';
+import { handleI18nRequest } from './serve-i18n.js';
+import { resolveLocale } from '../dev-server/middleware/locale.js';
 export async function serveProject(options) {
     const { projectDir } = options;
     const port = options.port || 3000;
@@ -21,6 +23,7 @@ export async function serveProject(options) {
     }
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
     const { title } = readProjectConfig(projectDir);
+    const localesDir = path.join(outDir, 'locales');
     // Read the built index.html shell
     const indexHtmlPath = path.join(clientDir, 'index.html');
     if (!fs.existsSync(indexHtmlPath)) {
@@ -54,18 +57,31 @@ export async function serveProject(options) {
                 if (served)
                     return;
             }
-            // 3. Layout loader endpoint
+            // 3. i18n translation endpoint
+            if (pathname.startsWith('/__nk_i18n/') && manifest.i18n) {
+                handleI18nRequest(localesDir, manifest.i18n.locales, pathname, req, res);
+                return;
+            }
+            // 4. Layout loader endpoint
             if (pathname === '/__nk_loader/__layout/' || pathname === '/__nk_loader/__layout') {
                 await handleLayoutLoaderRequest(manifest, serverDir, queryString, req.headers, res);
                 return;
             }
-            // 4. Loader endpoint for client-side navigation
+            // 5. Loader endpoint for client-side navigation
             if (pathname.startsWith('/__nk_loader/')) {
                 await handleLoaderRequest(manifest, serverDir, pagesDir, pathname, queryString, req.headers, res);
                 return;
             }
-            // 5. Page routes — SSR render
-            await handlePageRoute(manifest, serverDir, pagesDir, pathname, queryString, indexHtmlShell, title, ssrRuntime, req, res);
+            // 6. Resolve locale and strip prefix for page routing
+            let resolvedPathname = pathname;
+            let locale;
+            if (manifest.i18n) {
+                const result = resolveLocale(pathname, manifest.i18n, req.headers);
+                resolvedPathname = result.pathname;
+                locale = result.locale;
+            }
+            // 7. Page routes — SSR render
+            await handlePageRoute(manifest, serverDir, pagesDir, resolvedPathname, queryString, indexHtmlShell, title, ssrRuntime, req, res);
         }
         catch (err) {
             console.error('[LumenJS] Request error:', err);

package/dist/dev-server/config.d.ts CHANGED Viewed

@@ -1,6 +1,12 @@
+export interface I18nConfig {
+    locales: string[];
+    defaultLocale: string;
+    prefixDefault: boolean;
+}
 export interface ProjectConfig {
     title: string;
     integrations: string[];
+    i18n?: I18nConfig;
 }
 /**
  * Reads the project config from lumenjs.config.ts.

package/dist/dev-server/config.js CHANGED Viewed

@@ -26,7 +26,33 @@ export function readProjectConfig(projectDir) {
         }
         catch { /* use defaults */ }
     }
-    return { title, integrations };
+    // Parse i18n config (reuse the same file read)
+    let i18n;
+    if (fs.existsSync(configPath)) {
+        try {
+            const configContent = fs.readFileSync(configPath, 'utf-8');
+            const i18nMatch = configContent.match(/i18n\s*:\s*\{([\s\S]*?)\}/);
+            if (i18nMatch) {
+                const block = i18nMatch[1];
+                const localesMatch = block.match(/locales\s*:\s*\[([^\]]*)\]/);
+                const defaultMatch = block.match(/defaultLocale\s*:\s*['"]([^'"]+)['"]/);
+                const prefixMatch = block.match(/prefixDefault\s*:\s*(true|false)/);
+                if (localesMatch && defaultMatch) {
+                    const locales = localesMatch[1]
+                        .split(',')
+                        .map(s => s.trim().replace(/^['"]|['"]$/g, ''))
+                        .filter(Boolean);
+                    i18n = {
+                        locales,
+                        defaultLocale: defaultMatch[1],
+                        prefixDefault: prefixMatch ? prefixMatch[1] === 'true' : false,
+                    };
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    return { title, integrations, ...(i18n ? { i18n } : {}) };
 }
 /**
  * Reads the project title from lumenjs.config.ts (or returns default).

package/dist/dev-server/index-html.d.ts CHANGED Viewed

@@ -8,6 +8,13 @@ export interface IndexHtmlOptions {
         data: any;
     }>;
     integrations?: string[];
+    locale?: string;
+    i18nConfig?: {
+        locales: string[];
+        defaultLocale: string;
+        prefixDefault: boolean;
+    };
+    translations?: Record<string, string>;
 }
 /**
  * Generates the index.html shell that loads the LumenJS app.

package/dist/dev-server/index-html.js CHANGED Viewed

@@ -19,16 +19,28 @@ export function generateIndexHtml(options) {
             : options.loaderData;
         loaderDataScript = `<script type="application/json" id="__nk_ssr_data__">${JSON.stringify(ssrData).replace(/</g, '\\u003c')}</script>`;
     }
+    // i18n: inline translations and config for client hydration
+    let i18nScript = '';
+    if (options.i18nConfig && options.locale && options.translations) {
+        const i18nData = {
+            config: options.i18nConfig,
+            locale: options.locale,
+            translations: options.translations,
+        };
+        i18nScript = `<script type="application/json" id="__nk_i18n__">${JSON.stringify(i18nData).replace(/</g, '\\u003c')}</script>`;
+    }
+    // i18n module is loaded via imports from router-hydration, no separate script needed
     const hydrateScript = isSSR
         ? `<script type="module">import '@lit-labs/ssr-client/lit-element-hydrate-support.js';</script>`
         : '';
+    const htmlLang = options.locale || 'en';
     return `<!DOCTYPE html>
-<html lang="en">
+<html lang="${htmlLang}">
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>${escapeHtml(options.title)}</title>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@nuralyui/themes@latest/dist/default.css">${options.integrations?.includes('tailwind') ? '\n  <link rel="stylesheet" href="/styles/tailwind.css">' : ''}
+  ${options.integrations?.includes('nuralyui') ? '<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@nuralyui/themes@latest/dist/default.css">' : ''}${options.integrations?.includes('tailwind') ? '\n  <script type="module">import "/styles/tailwind.css";</script>' : ''}
   <style>
     *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
     body { font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; }
@@ -36,6 +48,7 @@ export function generateIndexHtml(options) {
   </style>
 </head>
 <body>
+  ${i18nScript}
   ${loaderDataScript}
   ${appTag}
   ${hydrateScript}

package/dist/dev-server/middleware/locale.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+export interface I18nConfig {
+    locales: string[];
+    defaultLocale: string;
+    prefixDefault: boolean;
+}
+export interface LocaleResult {
+    locale: string;
+    pathname: string;
+}
+/**
+ * Extract the locale from the request URL, cookie, or Accept-Language header.
+ * Returns the resolved locale and the pathname with the locale prefix stripped.
+ *
+ * Resolution order:
+ *   1. URL prefix: /fr/about → locale "fr", pathname "/about"
+ *   2. Cookie "nk-locale"
+ *   3. Accept-Language header
+ *   4. Config defaultLocale
+ */
+export declare function resolveLocale(pathname: string, config: I18nConfig, headers?: Record<string, string | string[] | undefined>): LocaleResult;

package/dist/dev-server/middleware/locale.js ADDED Viewed

@@ -0,0 +1,55 @@
+/**
+ * Extract the locale from the request URL, cookie, or Accept-Language header.
+ * Returns the resolved locale and the pathname with the locale prefix stripped.
+ *
+ * Resolution order:
+ *   1. URL prefix: /fr/about → locale "fr", pathname "/about"
+ *   2. Cookie "nk-locale"
+ *   3. Accept-Language header
+ *   4. Config defaultLocale
+ */
+export function resolveLocale(pathname, config, headers) {
+    // 1. URL prefix
+    for (const loc of config.locales) {
+        if (pathname === `/${loc}` || pathname.startsWith(`/${loc}/`)) {
+            return { locale: loc, pathname: pathname.slice(loc.length + 1) || '/' };
+        }
+    }
+    // 2. Cookie
+    const cookieHeader = headers?.cookie;
+    if (typeof cookieHeader === 'string') {
+        const match = cookieHeader.match(/(?:^|;\s*)nk-locale=([^;]+)/);
+        if (match && config.locales.includes(match[1])) {
+            return { locale: match[1], pathname };
+        }
+    }
+    // 3. Accept-Language
+    const acceptLang = headers?.['accept-language'];
+    if (typeof acceptLang === 'string') {
+        const preferred = parseAcceptLanguage(acceptLang);
+        for (const lang of preferred) {
+            const short = lang.split('-')[0];
+            if (config.locales.includes(short)) {
+                return { locale: short, pathname };
+            }
+            if (config.locales.includes(lang)) {
+                return { locale: lang, pathname };
+            }
+        }
+    }
+    // 4. Default
+    return { locale: config.defaultLocale, pathname };
+}
+/**
+ * Parse the Accept-Language header into a sorted list of language codes.
+ */
+function parseAcceptLanguage(header) {
+    return header
+        .split(',')
+        .map(part => {
+        const [lang, q] = part.trim().split(';q=');
+        return { lang: lang.trim().toLowerCase(), q: q ? parseFloat(q) : 1 };
+    })
+        .sort((a, b) => b.q - a.q)
+        .map(e => e.lang);
+}

package/dist/dev-server/plugins/vite-plugin-i18n.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { Plugin } from 'vite';
+import type { I18nConfig } from '../middleware/locale.js';
+/**
+ * Vite plugin for LumenJS i18n support.
+ *
+ * - Serves `/__nk_i18n/<locale>.json` with translation files
+ * - Provides a virtual module `@lumenjs/i18n` that re-exports the runtime
+ * - Watches locale files for HMR
+ */
+export declare function i18nPlugin(projectDir: string, config: I18nConfig): Plugin;
+/**
+ * Load translations for a locale from the project's locales/ directory.
+ * Used during SSR to inline translations in the HTML.
+ */
+export declare function loadTranslationsFromDisk(projectDir: string, locale: string): Record<string, string>;

package/dist/dev-server/plugins/vite-plugin-i18n.js ADDED Viewed

@@ -0,0 +1,71 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Vite plugin for LumenJS i18n support.
+ *
+ * - Serves `/__nk_i18n/<locale>.json` with translation files
+ * - Provides a virtual module `@lumenjs/i18n` that re-exports the runtime
+ * - Watches locale files for HMR
+ */
+export function i18nPlugin(projectDir, config) {
+    const localesDir = path.join(projectDir, 'locales');
+    return {
+        name: 'lumenjs-i18n',
+        configureServer(server) {
+            // Serve translation JSON files
+            server.middlewares.use((req, res, next) => {
+                if (!req.url?.startsWith('/__nk_i18n/'))
+                    return next();
+                const match = req.url.match(/^\/__nk_i18n\/([a-z]{2}(?:-[a-zA-Z]+)?)\.json$/);
+                if (!match)
+                    return next();
+                const locale = match[1];
+                if (!config.locales.includes(locale)) {
+                    res.statusCode = 404;
+                    res.end(JSON.stringify({ error: 'Unknown locale' }));
+                    return;
+                }
+                const filePath = path.join(localesDir, `${locale}.json`);
+                if (!fs.existsSync(filePath)) {
+                    res.statusCode = 200;
+                    res.setHeader('Content-Type', 'application/json');
+                    res.end('{}');
+                    return;
+                }
+                try {
+                    const content = fs.readFileSync(filePath, 'utf-8');
+                    // Validate JSON
+                    JSON.parse(content);
+                    res.statusCode = 200;
+                    res.setHeader('Content-Type', 'application/json');
+                    res.setHeader('Cache-Control', 'no-store');
+                    res.end(content);
+                }
+                catch {
+                    res.statusCode = 500;
+                    res.setHeader('Content-Type', 'application/json');
+                    res.end(JSON.stringify({ error: 'Invalid locale file' }));
+                }
+            });
+            // Watch locale directory for changes and trigger HMR
+            if (fs.existsSync(localesDir)) {
+                server.watcher.add(localesDir);
+            }
+        },
+    };
+}
+/**
+ * Load translations for a locale from the project's locales/ directory.
+ * Used during SSR to inline translations in the HTML.
+ */
+export function loadTranslationsFromDisk(projectDir, locale) {
+    const filePath = path.join(projectDir, 'locales', `${locale}.json`);
+    if (!fs.existsSync(filePath))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}

package/dist/dev-server/plugins/vite-plugin-loaders.js CHANGED Viewed

@@ -83,7 +83,10 @@ export function lumenLoadersPlugin(pagesDir) {
                         res.end(JSON.stringify({ __nk_no_loader: true }));
                         return;
                     }
-                    const result = await mod.loader({ params, query, url: pagePath, headers: req.headers });
+                    // Extract locale from query if provided by the client router
+                    const locale = query.__locale;
+                    delete query.__locale;
+                    const result = await mod.loader({ params, query, url: pagePath, headers: req.headers, locale });
                     if (isRedirectResponse(result)) {
                         res.statusCode = result.status || 302;
                         res.setHeader('Location', result.location);
@@ -195,7 +198,18 @@ async function handleLayoutLoader(server, pagesDir, dir, req, res) {
             res.end(JSON.stringify({ __nk_no_loader: true }));
             return;
         }
-        const result = await mod.loader({ params: {}, query: {}, url: `/__layout/${dir}`, headers: req.headers });
+        // Parse locale from query for layout loader requests
+        const query = {};
+        const reqUrl = req.url || '';
+        const qs = reqUrl.split('?')[1];
+        if (qs) {
+            for (const pair of qs.split('&')) {
+                const [key, val] = pair.split('=');
+                query[decodeURIComponent(key)] = decodeURIComponent(val || '');
+            }
+        }
+        const locale = query.__locale;
+        const result = await mod.loader({ params: {}, query: {}, url: `/__layout/${dir}`, headers: req.headers, locale });
         if (isRedirectResponse(result)) {
             res.statusCode = result.status || 302;
             res.setHeader('Location', result.location);

package/dist/dev-server/plugins/vite-plugin-routes.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { dirToLayoutTagName, fileHasLoader, filePathToRoute } from '../../shared/utils.js';
+import { dirToLayoutTagName, fileHasLoader, filePathToRoute, filePathToTagName } from '../../shared/utils.js';
 const VIRTUAL_MODULE_ID = 'virtual:lumenjs-routes';
 const RESOLVED_VIRTUAL_MODULE_ID = '\0' + VIRTUAL_MODULE_ID;
 /**
@@ -68,16 +68,6 @@ export function lumenRoutesPlugin(pagesDir) {
             }
         }
     }
-    function filePathToTagName(filePath) {
-        const name = filePath
-            .replace(/\.(ts|js)$/, '')
-            .replace(/\\/g, '-')
-            .replace(/\//g, '-')
-            .replace(/\[\.\.\.([^\]]+)\]/g, '$1')
-            .replace(/\[([^\]]+)\]/g, '$1')
-            .toLowerCase();
-        return `page-${name}`;
-    }
     /** Build the layout chain for a route based on its file path within pages/ */
     function getLayoutChain(componentPath, layouts) {
         const relativeToPages = path.relative(pagesDir, componentPath).replace(/\\/g, '/');

package/dist/dev-server/plugins/vite-plugin-source-annotator.js CHANGED Viewed

@@ -29,7 +29,14 @@ export function sourceAnnotatorPlugin(projectDir) {
                     const escaped = content.trim().replace(/"/g, '&quot;').replace(/\$\{/g, '__NK_EXPR__');
                     return `<${tag}${attrStr} data-nk-dynamic="${escaped}">${content}</`;
                 });
-                return 'html`' + dynamicAnnotated + '`';
+                // Detect t('key') calls inside template expressions and add data-nk-i18n-key
+                const i18nAnnotated = dynamicAnnotated.replace(/<(h[1-6]|p|span|a|label|li|button|div)(\s[^>]*)?>([^<]*\$\{t\(['"]([^'"]+)['"]\)\}[^<]*)<\//gi, (m, tag, attrs, content, key) => {
+                    const attrStr = attrs || '';
+                    if (attrStr.includes('data-nk-i18n-key'))
+                        return m;
+                    return `<${tag}${attrStr} data-nk-i18n-key="${key}">${content}</`;
+                });
+                return 'html`' + i18nAnnotated + '`';
             });
             if (transformed !== code) {
                 return { code: transformed, map: null };

package/dist/dev-server/plugins/vite-plugin-virtual-modules.d.ts CHANGED Viewed

@@ -1,5 +1,10 @@
 import { Plugin } from 'vite';
 /**
  * Virtual module plugin — serves compiled LumenJS runtime and editor modules.
+ * Rewrites relative imports between split sub-modules to virtual module paths.
+ *
+ * i18n is resolved via resolve.alias (physical file) rather than as a virtual
+ * module, because Vite's import-analysis rejects bare @-prefixed specifiers
+ * that go through the virtual module path.
  */
 export declare function virtualModulesPlugin(runtimeDir: string, editorDir: string): Plugin;