@constela/start 1.2.18 → 1.2.20

package/dist/{chunk-XOQABZYW.js → chunk-AXCIL6BP.js}

@@ -2,7 +2,7 @@ import {
   generateHydrationScript,
   renderPage,
   wrapHtml
-} from "./chunk-PUTC5BCP.js";
+} from "./chunk-LIHJUGSX.js";
 
 // src/router/file-router.ts
 import fg from "fast-glob";
@@ -2782,7 +2782,7 @@ async function processLayouts(pageInfo, layoutsDir, routeParams = {}) {
   };
   return updatedPageInfo;
 }
-async function renderPageToHtml(program, params, runtimePath, cssPath) {
+async function renderPageToHtml(program, params, runtimePath, cssPath, externalImports) {
   const normalizedProgram = {
     ...program,
     view: normalizeViewNode(structuredClone(program.view))
@@ -2800,7 +2800,24 @@ async function renderPageToHtml(program, params, runtimePath, cssPath) {
   };
   const cssLinkTag = cssPath ? `<link rel="stylesheet" href="${cssPath}">` : void 0;
   const hydrationScript = generateHydrationScript(normalizedProgram, void 0, routeContext);
-  return wrapHtml(content, hydrationScript, cssLinkTag, runtimePath ? { runtimePath } : void 0);
+  const wrapOptions = {};
+  if (runtimePath) {
+    wrapOptions.runtimePath = runtimePath;
+  }
+  if (externalImports && Object.keys(externalImports).length > 0) {
+    wrapOptions.importMap = externalImports;
+  }
+  const themeState = program.state?.["theme"];
+  if (themeState?.initial) {
+    wrapOptions.defaultTheme = themeState.initial;
+    wrapOptions.themeStorageKey = "theme";
+  }
+  return wrapHtml(
+    content,
+    hydrationScript,
+    cssLinkTag,
+    Object.keys(wrapOptions).length > 0 ? wrapOptions : void 0
+  );
 }
 async function copyPublicDir(publicDir, outDir, generatedFiles) {
   if (!existsSync8(publicDir)) {
@@ -2911,13 +2928,12 @@ async function build2(options) {
         let boundPageInfo = pageInfo;
         if (pathEntry.data && pageInfo.page.getStaticPaths?.source) {
           const source = pageInfo.page.getStaticPaths.source;
-          const sourceName = typeof source === "string" ? source : source.name;
-          if (sourceName) {
+          if (typeof source === "string") {
             boundPageInfo = {
               ...pageInfo,
               loadedData: {
                 ...pageInfo.loadedData,
-                [sourceName]: pathEntry.data
+                [source]: pathEntry.data
                 // Replace array with current item
               }
             };
@@ -2928,10 +2944,19 @@ async function build2(options) {
           processedPageInfo = await processLayouts(boundPageInfo, layoutsDir, params);
         }
         const program = await convertToCompiledProgram(processedPageInfo);
-        const html = await renderPageToHtml(program, params, runtimePath, cssPath);
+        const html = await renderPageToHtml(program, params, runtimePath, cssPath, processedPageInfo.page.externalImports);
         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 = join9(dirname5(dirname5(outputPath)), "index.html");
+          if (!generatedFiles.includes(parentOutputPath)) {
+            await mkdir2(dirname5(parentOutputPath), { recursive: true });
+            await writeFile(parentOutputPath, html, "utf-8");
+            generatedFiles.push(parentOutputPath);
+          }
+        }
         let routePath = route.pattern;
         for (const [key, value] of Object.entries(params)) {
           routePath = routePath.replace(`:${key}`, value);
@@ -2958,7 +2983,7 @@ async function build2(options) {
         pageInfo = await processLayouts(pageInfo, layoutsDir, {});
       }
       const program = await convertToCompiledProgram(pageInfo);
-      const html = await renderPageToHtml(program, {}, runtimePath, cssPath);
+      const html = await renderPageToHtml(program, {}, runtimePath, cssPath, pageInfo.page.externalImports);
       await mkdir2(dirname5(outputPath), { recursive: true });
       await writeFile(outputPath, html, "utf-8");
       generatedFiles.push(outputPath);

package/dist/{chunk-PUTC5BCP.js → chunk-LIHJUGSX.js}

@@ -71,7 +71,7 @@ ${routeDeclaration ? "\n" + routeDeclaration : ""}${widgetDeclarations ? "\n" +
 hydrateApp(${hydrateOptions});${widgetMounting}`;
 }
 function wrapHtml(content, hydrationScript, head, options) {
-  const htmlClass = options?.theme === "dark" ? ' class="dark"' : "";
+  const htmlClass = options?.defaultTheme === "dark" || options?.theme === "dark" ? ' class="dark"' : "";
   let processedScript = hydrationScript;
   let importMapScript = "";
   if (options?.runtimePath) {
@@ -82,11 +82,37 @@ function wrapHtml(content, hydrationScript, head, options) {
       /from\s+['"]@constela\/runtime['"]/g,
       `from '${options.runtimePath}'`
     );
+    if (options?.importMap && Object.keys(options.importMap).length > 0) {
+      const importMapJson = JSON.stringify({ imports: options.importMap }, null, 2);
+      importMapScript = `<script type="importmap">
+${importMapJson}
+</script>
+`;
+    }
   } else if (options?.importMap && Object.keys(options.importMap).length > 0) {
     const importMapJson = JSON.stringify({ imports: options.importMap }, null, 2);
     importMapScript = `<script type="importmap">
 ${importMapJson}
 </script>
+`;
+  }
+  let themeScript = "";
+  if (options?.themeStorageKey) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(options.themeStorageKey)) {
+      throw new Error(`Invalid themeStorageKey: ${options.themeStorageKey}. Only alphanumeric characters, underscores, and hyphens are allowed.`);
+    }
+    themeScript = `<script>
+(function() {
+  try {
+    var theme = localStorage.getItem('${options.themeStorageKey}');
+    if (theme === 'dark') {
+      document.documentElement.classList.add('dark');
+    } else if (theme === 'light') {
+      document.documentElement.classList.remove('dark');
+    }
+  } catch (e) {}
+})();
+</script>
 `;
   }
   return `<!DOCTYPE html>
@@ -94,7 +120,7 @@ ${importMapJson}
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-${importMapScript}${head ?? ""}
+${themeScript}${importMapScript}${head ?? ""}
 </head>
 <body>
 <div id="app">${content}</div>

package/dist/cli/index.js

@@ -3,8 +3,8 @@ import {
   createDevServer,
   loadConfig,
   resolveConfig
-} from "../chunk-XOQABZYW.js";
-import "../chunk-PUTC5BCP.js";
+} from "../chunk-AXCIL6BP.js";
+import "../chunk-LIHJUGSX.js";
 
 // src/cli/index.ts
 import { Command } from "commander";

package/dist/index.js

@@ -23,12 +23,12 @@ import {
   transformCsv,
   transformMdx,
   transformYaml
-} from "./chunk-XOQABZYW.js";
+} from "./chunk-AXCIL6BP.js";
 import {
   generateHydrationScript,
   renderPage,
   wrapHtml
-} from "./chunk-PUTC5BCP.js";
+} from "./chunk-LIHJUGSX.js";
 
 // src/build/ssg.ts
 import { mkdir, writeFile } from "fs/promises";
@@ -112,7 +112,18 @@ async function generateSinglePage(pattern, outDir, program, params = {}) {
     path: pattern
   };
   const hydrationScript = generateHydrationScript(program, void 0, routeContext);
-  const html = wrapHtml(content, hydrationScript);
+  const wrapOptions = {};
+  const themeState = program.state?.["theme"];
+  if (themeState?.initial) {
+    wrapOptions.defaultTheme = themeState.initial;
+    wrapOptions.themeStorageKey = "theme";
+  }
+  const html = wrapHtml(
+    content,
+    hydrationScript,
+    void 0,
+    Object.keys(wrapOptions).length > 0 ? wrapOptions : void 0
+  );
   await writeFile(outputPath, html, "utf-8");
   return outputPath;
 }

package/dist/runtime/entry-server.d.ts

@@ -16,6 +16,10 @@ interface WrapHtmlOptions {
     importMap?: Record<string, string>;
     /** Path to bundled runtime for production builds. When provided, replaces @constela/runtime imports and excludes importmap. */
     runtimePath?: string;
+    /** localStorage key for theme persistence. When provided, generates anti-flash script. */
+    themeStorageKey?: string;
+    /** Default theme to use when no stored preference exists */
+    defaultTheme?: 'dark' | 'light';
 }
 interface WidgetConfig {
     /** The DOM element ID where the widget should be mounted */

package/dist/runtime/entry-server.js

@@ -2,7 +2,7 @@ import {
   generateHydrationScript,
   renderPage,
   wrapHtml
-} from "../chunk-PUTC5BCP.js";
+} from "../chunk-LIHJUGSX.js";
 export {
   generateHydrationScript,
   renderPage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/start",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "description": "Meta-framework for Constela applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,11 +43,11 @@
     "postcss": "^8.5.0",
     "@tailwindcss/postcss": "^4.0.0",
     "tailwindcss": "^4.0.0",
-    "@constela/router": "8.0.0",
+    "@constela/compiler": "0.7.1",
     "@constela/core": "0.7.0",
     "@constela/runtime": "0.10.2",
-    "@constela/compiler": "0.7.1",
-    "@constela/server": "3.0.1"
+    "@constela/server": "3.0.1",
+    "@constela/router": "8.0.0"
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",