@constela/start 1.7.0 → 1.8.0

package/dist/{chunk-IGSM7NWL.js → chunk-3GFRJEKD.js}

@@ -90,8 +90,8 @@ hydrateApp(${hydrateOptions});${widgetMounting}`;
 function wrapHtml(content, hydrationScript, head, options) {
   let langAttr = "";
   if (options?.lang) {
-    if (!/^[a-zA-Z]{2,3}(-[a-zA-Z]{4})?(-[a-zA-Z]{2}|-[0-9]{3})?$/.test(options.lang)) {
-      throw new Error(`Invalid lang: ${options.lang}. Expected BCP 47 language tag (e.g., 'en', 'ja', 'en-US', 'zh-Hans-CN').`);
+    if (!/^([a-zA-Z]{2,3}|i)(-[a-zA-Z0-9]{1,8})*$/.test(options.lang)) {
+      throw new Error(`Invalid lang: ${options.lang}. Expected BCP 47 language tag (e.g., 'en', 'ja', 'en-US', 'zh-Hans-CN', 'zh-cmn-Hans', 'de-DE-u-co-phonebk').`);
     }
     langAttr = ` lang="${options.lang}"`;
   }
@@ -217,6 +217,18 @@ function evaluateJsonLdExpression(expr, ctx) {
       return "";
     case "concat":
       return expr.items.map((item) => String(evaluateJsonLdExpression(item, ctx))).join("");
+    case "object": {
+      const obj = {};
+      if (expr.type) {
+        obj["@type"] = expr.type;
+      }
+      for (const [key, propExpr] of Object.entries(expr.properties)) {
+        obj[key] = evaluateJsonLdExpression(propExpr, ctx);
+      }
+      return obj;
+    }
+    case "array":
+      return expr.items.map((item) => evaluateJsonLdExpression(item, ctx));
     default:
       return "";
   }

package/dist/{chunk-7OAUINHU.js → chunk-TXTTXC4B.js}

@@ -3,7 +3,7 @@ import {
   generateMetaTags,
   renderPage,
   wrapHtml
-} from "./chunk-IGSM7NWL.js";
+} from "./chunk-3GFRJEKD.js";
 
 // src/router/file-router.ts
 import fg from "fast-glob";
@@ -2104,9 +2104,19 @@ async function convertToCompiledProgram(pageInfo) {
     if (page.route.meta) {
       program.route.meta = {};
       for (const [key, value] of Object.entries(page.route.meta)) {
-        program.route.meta[key] = { expr: "lit", value };
+        const isExpression = value && typeof value === "object" && "expr" in value;
+        program.route.meta[key] = isExpression ? value : { expr: "lit", value };
       }
     }
+    if (page.route.title) {
+      program.route.title = page.route.title;
+    }
+    if (page.route.canonical) {
+      program.route.canonical = page.route.canonical;
+    }
+    if (page.route.jsonLd) {
+      program.route.jsonLd = page.route.jsonLd;
+    }
   }
   const hasImports = Object.keys(resolvedImports).length > 0;
   const hasData = Object.keys(loadedData).length > 0;
@@ -2652,7 +2662,8 @@ async function createDevServer(options = {}) {
                   defaultTheme: initialTheme,
                   themeStorageKey: "theme"
                 } : {},
-                importMap
+                importMap,
+                ...options.seo?.lang ? { lang: options.seo.lang } : {}
               });
               res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
               res.end(html);
@@ -2793,25 +2804,69 @@ h1 { color: #666; }
   return devServer;
 }
 
+// src/config/config-loader.ts
+import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
+import { join as join9 } from "path";
+var CONFIG_FILENAME = "constela.config.json";
+async function loadConfig(projectRoot) {
+  const configPath = join9(projectRoot, CONFIG_FILENAME);
+  if (!existsSync7(configPath)) {
+    return {};
+  }
+  let content;
+  try {
+    content = readFileSync5(configPath, "utf-8");
+  } catch (error) {
+    throw new Error(`Failed to read config file: ${configPath}`);
+  }
+  try {
+    return JSON.parse(content);
+  } catch {
+    throw new Error(`Invalid JSON in config file: ${configPath}`);
+  }
+}
+async function resolveConfig(fileConfig, cliOptions) {
+  if (!cliOptions) {
+    return { ...fileConfig };
+  }
+  const result = { ...fileConfig };
+  if (cliOptions.css !== void 0) result.css = cliOptions.css;
+  if (cliOptions.cssContent !== void 0) {
+    result.cssContent = cliOptions.cssContent.split(",").map((s) => s.trim()).filter(Boolean);
+  }
+  if (cliOptions.layoutsDir !== void 0) result.layoutsDir = cliOptions.layoutsDir;
+  if (cliOptions.routesDir !== void 0) result.routesDir = cliOptions.routesDir;
+  if (cliOptions.publicDir !== void 0) result.publicDir = cliOptions.publicDir;
+  if (cliOptions.outDir !== void 0) {
+    result.build = { ...result.build, outDir: cliOptions.outDir };
+  }
+  if (cliOptions.port !== void 0 || cliOptions.host !== void 0) {
+    result.dev = { ...result.dev };
+    if (cliOptions.port !== void 0) result.dev.port = cliOptions.port;
+    if (cliOptions.host !== void 0) result.dev.host = cliOptions.host;
+  }
+  return result;
+}
+
 // src/build/index.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync6 } from "fs";
 import { mkdir as mkdir2, writeFile, cp, readdir } from "fs/promises";
-import { join as join10, dirname as dirname5, relative as relative5, basename as basename4, isAbsolute as isAbsolute3, resolve as resolve4 } from "path";
+import { join as join11, dirname as dirname5, relative as relative5, basename as basename4, isAbsolute as isAbsolute3, resolve as resolve4 } from "path";
 import { isCookieInitialExpr as isCookieInitialExpr3 } from "@constela/core";
 
 // src/build/bundler.ts
 import * as esbuild from "esbuild";
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { mkdir, readFile } from "fs/promises";
 import { createRequire } from "module";
-import { join as join9, dirname as dirname4, isAbsolute as isAbsolute2, relative as relative4 } from "path";
+import { join as join10, dirname as dirname4, isAbsolute as isAbsolute2, relative as relative4 } from "path";
 import { fileURLToPath } from "url";
 var __dirname = dirname4(fileURLToPath(import.meta.url));
 async function bundleRuntime(options) {
   const entryContent = `
     export { hydrateApp, createApp } from '@constela/runtime';
   `;
-  const outFile = join9(options.outDir, "_constela", "runtime.js");
+  const outFile = join10(options.outDir, "_constela", "runtime.js");
   await mkdir(dirname4(outFile), { recursive: true });
   try {
     await esbuild.build({
@@ -2836,12 +2891,12 @@ async function bundleRuntime(options) {
 }
 async function bundleCSS(options) {
   const cssFiles = Array.isArray(options.css) ? options.css : [options.css];
-  const outFile = join9(options.outDir, "_constela", "styles.css");
+  const outFile = join10(options.outDir, "_constela", "styles.css");
   const shouldMinify = options.minify ?? true;
   await mkdir(dirname4(outFile), { recursive: true });
-  const resolvedCssFiles = cssFiles.map((f) => isAbsolute2(f) ? f : join9(process.cwd(), f));
+  const resolvedCssFiles = cssFiles.map((f) => isAbsolute2(f) ? f : join10(process.cwd(), f));
   for (const fullPath of resolvedCssFiles) {
-    if (!existsSync7(fullPath)) {
+    if (!existsSync8(fullPath)) {
       throw new Error(`CSS file not found: ${fullPath}`);
     }
   }
@@ -2868,7 +2923,7 @@ async function bundleCSS(options) {
     if (options.content.length > 0) {
       const fg4 = (await import("fast-glob")).default;
       const resolvedContentPaths = options.content.map(
-        (p) => isAbsolute2(p) ? p : join9(process.cwd(), p)
+        (p) => isAbsolute2(p) ? p : join10(process.cwd(), p)
       );
       const matchedFiles = await fg4(resolvedContentPaths, { onlyFiles: true });
       if (matchedFiles.length === 0) {
@@ -2879,7 +2934,7 @@ async function bundleCSS(options) {
     }
     const sourceDir = dirname4(firstCssFile);
     const sourceDirectives = options.content.map((contentPath) => {
-      const absolutePath = isAbsolute2(contentPath) ? contentPath : join9(process.cwd(), contentPath);
+      const absolutePath = isAbsolute2(contentPath) ? contentPath : join10(process.cwd(), contentPath);
       const srcPath = absolutePath.includes("*") ? dirname4(absolutePath.split("*")[0] ?? absolutePath) : absolutePath;
       const relativePath = relative4(sourceDir, srcPath);
       return `@source "${relativePath}";`;
@@ -2961,9 +3016,9 @@ function isDynamicRoute(pattern) {
 function getOutputPath(filePath, outDir) {
   const withoutExt = filePath.replace(/\.(json|ts|tsx|js|jsx)$/, "");
   if (withoutExt === "index" || withoutExt.endsWith("/index")) {
-    return join10(outDir, withoutExt + ".html");
+    return join11(outDir, withoutExt + ".html");
   }
-  return join10(outDir, withoutExt, "index.html");
+  return join11(outDir, withoutExt, "index.html");
 }
 function paramsToOutputPath(basePattern, params, outDir) {
   let path = basePattern;
@@ -2973,19 +3028,19 @@ function paramsToOutputPath(basePattern, params, outDir) {
   }
   const relativePath = path.startsWith("/") ? path.slice(1) : path;
   if (relativePath === "") {
-    return join10(outDir, "index.html");
+    return join11(outDir, "index.html");
   }
-  return join10(outDir, relativePath, "index.html");
+  return join11(outDir, relativePath, "index.html");
 }
 async function loadGetStaticPaths(pageFile) {
   const dir = dirname5(pageFile);
   const baseName = basename4(pageFile, ".json");
-  const pathsFile = join10(dir, `${baseName}.paths.ts`);
-  if (!existsSync8(pathsFile)) {
+  const pathsFile = join11(dir, `${baseName}.paths.ts`);
+  if (!existsSync9(pathsFile)) {
     return null;
   }
   try {
-    const content = readFileSync5(pathsFile, "utf-8");
+    const content = readFileSync6(pathsFile, "utf-8");
     const pathsMatch = content.match(/paths:\s*\[([\s\S]*?)\]/);
     if (!pathsMatch) {
       throw new Error(`Invalid getStaticPaths format in ${pathsFile}`);
@@ -3021,12 +3076,12 @@ async function loadGetStaticPaths(pageFile) {
   }
 }
 async function loadLayout2(layoutName, layoutsDir) {
-  const layoutPath = join10(layoutsDir, `${layoutName}.json`);
-  if (!existsSync8(layoutPath)) {
+  const layoutPath = join11(layoutsDir, `${layoutName}.json`);
+  if (!existsSync9(layoutPath)) {
     throw new Error(`Layout "${layoutName}" not found at ${layoutPath}`);
   }
   try {
-    const content = readFileSync5(layoutPath, "utf-8");
+    const content = readFileSync6(layoutPath, "utf-8");
     const parsed = JSON.parse(content);
     if (parsed.imports && Object.keys(parsed.imports).length > 0) {
       const layoutDir = dirname5(layoutPath);
@@ -3361,7 +3416,7 @@ async function processLayouts(pageInfo, layoutsDir, routeParams = {}) {
   };
   return updatedPageInfo;
 }
-async function renderPageToHtml(program, params, runtimePath, cssPath, externalImports, widgets) {
+async function renderPageToHtml(program, params, runtimePath, cssPath, externalImports, widgets, lang) {
   const normalizedProgram = {
     ...program,
     view: normalizeViewNode(structuredClone(program.view))
@@ -3393,6 +3448,9 @@ async function renderPageToHtml(program, params, runtimePath, cssPath, externalI
   if (externalImports && Object.keys(externalImports).length > 0) {
     wrapOptions.importMap = externalImports;
   }
+  if (lang) {
+    wrapOptions.lang = lang;
+  }
   const themeState = program.state?.["theme"];
   if (themeState) {
     let defaultTheme;
@@ -3414,7 +3472,7 @@ async function renderPageToHtml(program, params, runtimePath, cssPath, externalI
   );
 }
 async function copyPublicDir(publicDir, outDir, generatedFiles) {
-  if (!existsSync8(publicDir)) {
+  if (!existsSync9(publicDir)) {
     return;
   }
   await copyDirRecursive(publicDir, outDir, generatedFiles);
@@ -3422,8 +3480,8 @@ async function copyPublicDir(publicDir, outDir, generatedFiles) {
 async function copyDirRecursive(srcDir, destDir, skipFiles) {
   const entries = await readdir(srcDir, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = join10(srcDir, entry.name);
-    const destPath = join10(destDir, entry.name);
+    const srcPath = join11(srcDir, entry.name);
+    const destPath = join11(destDir, entry.name);
     if (entry.isDirectory()) {
       await mkdir2(destPath, { recursive: true });
       await copyDirRecursive(srcPath, destPath, skipFiles);
@@ -3492,10 +3550,12 @@ async function build2(options) {
   }
   const absoluteRoutesDir = isAbsolute3(routesDir) ? routesDir : resolve4(routesDir);
   const projectRoot = dirname5(dirname5(absoluteRoutesDir));
+  const config = await loadConfig(projectRoot);
+  const seoLang = options?.seo?.lang ?? config.seo?.lang;
   for (const route of jsonPages) {
     const relPathFromRoutesDir = relative5(absoluteRoutesDir, route.file);
     const relPathFromProjectRoot = relative5(projectRoot, route.file);
-    const content = readFileSync5(route.file, "utf-8");
+    const content = readFileSync6(route.file, "utf-8");
     const page = validateJsonPage(content, route.file);
     if (isDynamicRoute(route.pattern)) {
       const loader = new JsonPageLoader(projectRoot, { routesDir: absoluteRoutesDir });
@@ -3538,13 +3598,13 @@ async function build2(options) {
           processedPageInfo = await processLayouts(boundPageInfo, layoutsDir, params);
         }
         const program = await convertToCompiledProgram(processedPageInfo);
-        const html = await renderPageToHtml(program, params, runtimePath, cssPath, processedPageInfo.page.externalImports, processedPageInfo.widgets);
+        const html = await renderPageToHtml(program, params, runtimePath, cssPath, processedPageInfo.page.externalImports, processedPageInfo.widgets, seoLang);
         await mkdir2(dirname5(outputPath), { recursive: true });
         await writeFile(outputPath, html, "utf-8");
         generatedFiles.push(outputPath);
         const slugValue = params["slug"];
         if (slugValue && (slugValue === "index" || slugValue.endsWith("/index"))) {
-          const parentOutputPath = join10(dirname5(dirname5(outputPath)), "index.html");
+          const parentOutputPath = join11(dirname5(dirname5(outputPath)), "index.html");
           if (!generatedFiles.includes(parentOutputPath)) {
             await mkdir2(dirname5(parentOutputPath), { recursive: true });
             await writeFile(parentOutputPath, html, "utf-8");
@@ -3566,9 +3626,9 @@ async function build2(options) {
         const routePath = pageInfo.page.route.path;
         const relativePath = routePath.startsWith("/") ? routePath.slice(1) : routePath;
         if (relativePath === "" || relativePath === "/") {
-          outputPath = join10(outDir, "index.html");
+          outputPath = join11(outDir, "index.html");
         } else {
-          outputPath = join10(outDir, relativePath, "index.html");
+          outputPath = join11(outDir, relativePath, "index.html");
         }
       } else {
         outputPath = getOutputPath(relPathFromRoutesDir, outDir);
@@ -3577,7 +3637,7 @@ async function build2(options) {
         pageInfo = await processLayouts(pageInfo, layoutsDir, {});
       }
       const program = await convertToCompiledProgram(pageInfo);
-      const html = await renderPageToHtml(program, {}, runtimePath, cssPath, pageInfo.page.externalImports, pageInfo.widgets);
+      const html = await renderPageToHtml(program, {}, runtimePath, cssPath, pageInfo.page.externalImports, pageInfo.widgets, seoLang);
       await mkdir2(dirname5(outputPath), { recursive: true });
       await writeFile(outputPath, html, "utf-8");
       generatedFiles.push(outputPath);
@@ -3594,50 +3654,6 @@ async function build2(options) {
   };
 }
 
-// src/config/config-loader.ts
-import { existsSync as existsSync9, readFileSync as readFileSync6 } from "fs";
-import { join as join11 } from "path";
-var CONFIG_FILENAME = "constela.config.json";
-async function loadConfig(projectRoot) {
-  const configPath = join11(projectRoot, CONFIG_FILENAME);
-  if (!existsSync9(configPath)) {
-    return {};
-  }
-  let content;
-  try {
-    content = readFileSync6(configPath, "utf-8");
-  } catch (error) {
-    throw new Error(`Failed to read config file: ${configPath}`);
-  }
-  try {
-    return JSON.parse(content);
-  } catch {
-    throw new Error(`Invalid JSON in config file: ${configPath}`);
-  }
-}
-async function resolveConfig(fileConfig, cliOptions) {
-  if (!cliOptions) {
-    return { ...fileConfig };
-  }
-  const result = { ...fileConfig };
-  if (cliOptions.css !== void 0) result.css = cliOptions.css;
-  if (cliOptions.cssContent !== void 0) {
-    result.cssContent = cliOptions.cssContent.split(",").map((s) => s.trim()).filter(Boolean);
-  }
-  if (cliOptions.layoutsDir !== void 0) result.layoutsDir = cliOptions.layoutsDir;
-  if (cliOptions.routesDir !== void 0) result.routesDir = cliOptions.routesDir;
-  if (cliOptions.publicDir !== void 0) result.publicDir = cliOptions.publicDir;
-  if (cliOptions.outDir !== void 0) {
-    result.build = { ...result.build, outDir: cliOptions.outDir };
-  }
-  if (cliOptions.port !== void 0 || cliOptions.host !== void 0) {
-    result.dev = { ...result.dev };
-    if (cliOptions.port !== void 0) result.dev.port = cliOptions.port;
-    if (cliOptions.host !== void 0) result.dev.host = cliOptions.host;
-  }
-  return result;
-}
-
 // src/utils/terminal.ts
 function hyperlink(url, text) {
   const displayText = text ?? url;
@@ -3673,8 +3689,8 @@ export {
   loadLayout,
   LayoutResolver,
   createDevServer,
-  build2 as build,
   loadConfig,
   resolveConfig,
+  build2 as build,
   hyperlink
 };

package/dist/cli/index.js

@@ -4,8 +4,8 @@ import {
   hyperlink,
   loadConfig,
   resolveConfig
-} from "../chunk-7OAUINHU.js";
-import "../chunk-IGSM7NWL.js";
+} from "../chunk-TXTTXC4B.js";
+import "../chunk-3GFRJEKD.js";
 
 // src/cli/index.ts
 import { Command } from "commander";

package/dist/index.d.ts

@@ -93,6 +93,10 @@ interface DevServerOptions {
     layoutsDir?: string;
     /** CSS entry point(s) for Vite middleware processing */
     css?: string | string[];
+    /** SEO configuration */
+    seo?: {
+        lang?: string;
+    };
 }
 /**
  * Build options
@@ -107,6 +111,10 @@ interface BuildOptions {
     /** Content paths for Tailwind CSS class scanning (enables PostCSS processing) */
     cssContent?: string[] | undefined;
     target?: 'node' | 'edge' | undefined;
+    /** SEO configuration */
+    seo?: {
+        lang?: string;
+    };
 }
 
 /**
@@ -232,6 +240,10 @@ interface GenerateStaticPagesOptions {
      * Primarily used for testing purposes.
      */
     staticPathsProvider?: StaticPathsProvider;
+    /**
+     * Optional language code for HTML lang attribute.
+     */
+    lang?: string;
 }
 /**
  * Generate static pages for SSG routes

package/dist/index.js

@@ -28,14 +28,14 @@ import {
   transformCsv,
   transformMdx,
   transformYaml
-} from "./chunk-7OAUINHU.js";
+} from "./chunk-TXTTXC4B.js";
 import {
   evaluateMetaExpression,
   generateHydrationScript,
   generateMetaTags,
   renderPage,
   wrapHtml
-} from "./chunk-IGSM7NWL.js";
+} from "./chunk-3GFRJEKD.js";
 
 // src/build/ssg.ts
 import { mkdir, writeFile } from "fs/promises";
@@ -84,7 +84,7 @@ async function getStaticPathsForRoute(route, module, staticPathsProvider) {
   }
   return null;
 }
-async function generateSinglePage(pattern, outDir, program, params = {}) {
+async function generateSinglePage(pattern, outDir, program, params = {}, lang) {
   const outputPath = getOutputPath(pattern, outDir);
   const outputDir = dirname(outputPath);
   await mkdir(outputDir, { recursive: true });
@@ -119,6 +119,9 @@ async function generateSinglePage(pattern, outDir, program, params = {}) {
       wrapOptions.themeStorageKey = "theme";
     }
   }
+  if (lang) {
+    wrapOptions.lang = lang;
+  }
   const html = wrapHtml(
     content,
     hydrationScript,
@@ -129,7 +132,7 @@ async function generateSinglePage(pattern, outDir, program, params = {}) {
   return outputPath;
 }
 async function generateStaticPages(routes, outDir, options = {}) {
-  const { staticPathsProvider } = options;
+  const { staticPathsProvider, lang } = options;
   const generatedPaths = [];
   const pageRoutes = routes.filter((r) => r.type === "page");
   for (const route of pageRoutes) {
@@ -154,13 +157,14 @@ async function generateStaticPages(routes, outDir, options = {}) {
           resolvedPattern,
           outDir,
           program,
-          pathData.params
+          pathData.params,
+          lang
         );
         generatedPaths.push(filePath);
       }
     } else {
       const program = await resolvePageExport(pageExport, {});
-      const filePath = await generateSinglePage(route.pattern, outDir, program);
+      const filePath = await generateSinglePage(route.pattern, outDir, program, {}, lang);
       generatedPaths.push(filePath);
     }
   }

package/dist/runtime/entry-server.js

@@ -4,7 +4,7 @@ import {
   generateMetaTags,
   renderPage,
   wrapHtml
-} from "../chunk-IGSM7NWL.js";
+} from "../chunk-3GFRJEKD.js";
 export {
   evaluateMetaExpression,
   generateHydrationScript,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/start",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Meta-framework for Constela applications",
   "type": "module",
   "main": "./dist/index.js",