meno-core 1.0.53 → 1.0.54

package/build-next.ts

@@ -11,37 +11,46 @@
  * browser parses the statically exported `.html` file.
  */
 
-import { existsSync, readdirSync, mkdirSync, rmSync, statSync, copyFileSync, writeFileSync } from "fs";
-import { writeFile, readFile } from "fs/promises";
-import { join } from "path";
-import { createHash } from "crypto";
+import { existsSync, readdirSync, mkdirSync, rmSync, statSync, copyFileSync, writeFileSync } from 'fs';
+import { writeFile, readFile } from 'fs/promises';
+import { join } from 'path';
+import { createHash } from 'crypto';
 import {
   loadJSONFile,
   loadComponentDirectory,
   mapPageNameToPath,
   parseJSON,
   loadI18nConfig,
-} from "./lib/server/jsonLoader";
-import { projectPaths } from "./lib/server/projectContext";
-import { loadProjectConfig, generateFontCSS, generateFontPreloadTags } from "./lib/shared/fontLoader";
-import { FileSystemCMSProvider } from "./lib/server/providers/fileSystemCMSProvider";
-import { CMSService } from "./lib/server/services/cmsService";
-import { isI18nValue, resolveI18nValue } from "./lib/shared/i18n";
-import type { ComponentDefinition, JSONPage, CMSSchema, CMSItem, I18nConfig } from "./lib/shared/types";
-import { isItemDraftForLocale } from "./lib/shared/types";
-import type { SlugMap } from "./lib/shared/slugTranslator";
-import { renderPageSSR } from "./lib/server/ssr/ssrRenderer";
-import { generateThemeColorVariablesCSS, generateVariablesCSS } from "./lib/server/cssGenerator";
-import { colorService } from "./lib/server/services/ColorService";
-import { variableService } from "./lib/server/services/VariableService";
-import { configService } from "./lib/server/services/configService";
-import { loadBreakpointConfig, loadIconsConfig } from "./lib/server/jsonLoader";
-import type { InteractiveStyles } from "./lib/shared/types/styles";
-import { collectComponentLibraries, filterLibrariesByContext, mergeLibraries, generateLibraryTags } from "./lib/shared/libraryLoader";
-import { migrateTemplatesDirectory } from "./lib/server/migrateTemplates";
-import { collectAllMappingClasses } from "./lib/server/astro/cssCollector";
-import { generateAllInteractiveCSS, generateUtilityCSS, extractUtilityClassesFromHTML } from "./lib/shared/cssGeneration";
-import { needsFormHandler, formHandlerScript } from "./lib/client/scripts/formHandler";
+} from './lib/server/jsonLoader';
+import { projectPaths } from './lib/server/projectContext';
+import { loadProjectConfig, generateFontCSS, generateFontPreloadTags } from './lib/shared/fontLoader';
+import { FileSystemCMSProvider } from './lib/server/providers/fileSystemCMSProvider';
+import { CMSService } from './lib/server/services/cmsService';
+import { isI18nValue, resolveI18nValue } from './lib/shared/i18n';
+import type { ComponentDefinition, JSONPage, CMSSchema, CMSItem, I18nConfig } from './lib/shared/types';
+import { isItemDraftForLocale } from './lib/shared/types';
+import type { SlugMap } from './lib/shared/slugTranslator';
+import { renderPageSSR } from './lib/server/ssr/ssrRenderer';
+import { generateThemeColorVariablesCSS, generateVariablesCSS } from './lib/server/cssGenerator';
+import { colorService } from './lib/server/services/ColorService';
+import { variableService } from './lib/server/services/VariableService';
+import { configService } from './lib/server/services/configService';
+import { loadBreakpointConfig, loadIconsConfig } from './lib/server/jsonLoader';
+import type { InteractiveStyles } from './lib/shared/types/styles';
+import {
+  collectComponentLibraries,
+  filterLibrariesByContext,
+  mergeLibraries,
+  generateLibraryTags,
+} from './lib/shared/libraryLoader';
+import { migrateTemplatesDirectory } from './lib/server/migrateTemplates';
+import { collectAllMappingClasses } from './lib/server/astro/cssCollector';
+import {
+  generateAllInteractiveCSS,
+  generateUtilityCSS,
+  extractUtilityClassesFromHTML,
+} from './lib/shared/cssGeneration';
+import { needsFormHandler, formHandlerScript } from './lib/client/scripts/formHandler';
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -65,11 +74,7 @@ function writePageScript(javascript: string | undefined, scriptsDir: string): st
   return [`/_scripts/${scriptFile}`];
 }
 
-function copyDirectory(
-  src: string,
-  dest: string,
-  filter?: (filename: string) => boolean,
-): void {
+function copyDirectory(src: string, dest: string, filter?: (filename: string) => boolean): void {
   if (!existsSync(src)) return;
   if (!existsSync(dest)) mkdirSync(dest, { recursive: true });
   const files = readdirSync(src);
@@ -95,7 +100,7 @@ function buildCMSItemPath(
   item: CMSItem,
   slugField: string,
   locale: string,
-  i18nConfig: I18nConfig
+  i18nConfig: I18nConfig,
 ): string {
   let slug = item[slugField] ?? item._slug ?? item._id;
   if (isI18nValue(slug)) {
@@ -212,7 +217,10 @@ interface NextBuildStats {
  */
 function metaHtmlToJSX(metaHtml: string): string {
   if (!metaHtml || !metaHtml.trim()) return '';
-  const lines = metaHtml.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  const lines = metaHtml
+    .split(/\r?\n/)
+    .map((l) => l.trim())
+    .filter(Boolean);
 
   const elements: string[] = [];
   for (const line of lines) {
@@ -232,7 +240,6 @@ function metaHtmlToJSX(metaHtml: string): string {
         .map(([k, v]) => `${jsxAttrName(k)}=${JSON.stringify(v)}`)
         .join(' ');
       elements.push(`<${tagName} ${attrParts} />`);
-      continue;
     }
     // Unknown tag — skip rather than crash the build.
   }
@@ -246,15 +253,15 @@ function metaHtmlToJSX(metaHtml: string): string {
  */
 const JSX_ATTR_NAMES: Record<string, string> = {
   'http-equiv': 'httpEquiv',
-  'hreflang': 'hrefLang',
-  'crossorigin': 'crossOrigin',
-  'referrerpolicy': 'referrerPolicy',
-  'imagesrcset': 'imageSrcSet',
-  'imagesizes': 'imageSizes',
-  'fetchpriority': 'fetchPriority',
-  'class': 'className',
-  'for': 'htmlFor',
-  'charset': 'charSet',
+  hreflang: 'hrefLang',
+  crossorigin: 'crossOrigin',
+  referrerpolicy: 'referrerPolicy',
+  imagesrcset: 'imageSrcSet',
+  imagesizes: 'imageSizes',
+  fetchpriority: 'fetchPriority',
+  class: 'className',
+  for: 'htmlFor',
+  charset: 'charSet',
 };
 
 function jsxAttrName(name: string): string {
@@ -395,12 +402,15 @@ export default function Page() {
  */
 function emitNextCMSPage(options: {
   slugs: string[];
-  perSlugData: Record<string, {
-    html: string;
-    meta: string;
-    title: string;
-    scriptPaths: string[];
-  }>;
+  perSlugData: Record<
+    string,
+    {
+      html: string;
+      meta: string;
+      title: string;
+      scriptPaths: string[];
+    }
+  >;
   locale: string;
   theme: string;
   fontPreloads: string;
@@ -409,17 +419,8 @@ function emitNextCMSPage(options: {
   iconTagsHtml: string;
   formHandlerNeeded: boolean;
 }): string {
-  const {
-    slugs,
-    perSlugData,
-    locale,
-    theme,
-    fontPreloads,
-    libraryTags,
-    customCode,
-    iconTagsHtml,
-    formHandlerNeeded,
-  } = options;
+  const { slugs, perSlugData, locale, theme, fontPreloads, libraryTags, customCode, iconTagsHtml, formHandlerNeeded } =
+    options;
 
   const headHtmlBlocks: string[] = [];
   if (iconTagsHtml) headHtmlBlocks.push(iconTagsHtml);
@@ -451,7 +452,7 @@ function emitNextCMSPage(options: {
     metaHtml: \`${escapeTemplateLiteral(data.meta)}\`,
     html: \`${escapeTemplateLiteral(data.html)}\`,
     bodyEndHtml: \`${escapeTemplateLiteral(bodyEndHtml)}\`,
-  }`
+  }`,
     );
   }
 
@@ -502,7 +503,9 @@ export default async function Page({ params }: { params: Promise<{ slug: string
 `;
 }
 
-function cmsRawHeadImport(_options: { /* keep for future depth handling */ }): string {
+function cmsRawHeadImport(_options: {
+  /* keep for future depth handling */
+}): string {
   // CMS files live two levels under app/ (e.g. app/blog/[slug]/page.tsx), so
   // the relative path to app/components/RawHead.tsx is "../../components/RawHead".
   // When the URL pattern's path prefix is empty (e.g. "/[slug]"), they live at
@@ -512,7 +515,9 @@ function cmsRawHeadImport(_options: { /* keep for future depth handling */ }): s
   return '../../components/RawHead';
 }
 
-function cmsMetaTagsImport(_options: { /* placeholder */ }): string {
+function cmsMetaTagsImport(_options: {
+  /* placeholder */
+}): string {
   return '../../components/MetaTags';
 }
 
@@ -520,10 +525,7 @@ function cmsMetaTagsImport(_options: { /* placeholder */ }): string {
 // Main export
 // ---------------------------------------------------------------------------
 
-export async function buildNextProject(
-  projectRoot?: string,
-  outputDir?: string
-): Promise<NextBuildStats> {
+export async function buildNextProject(projectRoot?: string, outputDir?: string): Promise<NextBuildStats> {
   // ----------------------------------------------------------
   // 1. Setup: load project configuration
   // ----------------------------------------------------------
@@ -538,7 +540,9 @@ export async function buildNextProject(
 
   const { components, warnings, errors: compErrors } = await loadComponentDirectory(projectPaths.components());
   const globalComponents: Record<string, ComponentDefinition> = {};
-  components.forEach((value, key) => { globalComponents[key] = value; });
+  components.forEach((value, key) => {
+    globalComponents[key] = value;
+  });
   for (const w of warnings) console.warn(`  Warning: ${w}`);
   for (const e of compErrors) console.error(`  Error: ${e}`);
 
@@ -600,7 +604,9 @@ export async function buildNextProject(
         const pageId = basePath === '/' ? 'index' : basePath.substring(1);
         slugMappings.push({ pageId, slugs: pageData.meta.slugs });
       }
-    } catch { /* ignore parse errors in first pass */ }
+    } catch {
+      /* ignore parse errors in first pass */
+    }
   }
 
   // ----------------------------------------------------------
@@ -623,7 +629,15 @@ export async function buildNextProject(
   }
 
   function recordRender(
-    result: { html: string; meta: string; title: string; javascript: string; componentCSS?: string; locale: string; interactiveStylesMap: Map<string, InteractiveStyles> },
+    result: {
+      html: string;
+      meta: string;
+      title: string;
+      javascript: string;
+      componentCSS?: string;
+      locale: string;
+      interactiveStylesMap: Map<string, InteractiveStyles>;
+    },
     urlPath: string,
     pageData?: JSONPage,
     pageName?: string,
@@ -691,8 +705,12 @@ export async function buildNextProject(
         }
 
         const urlPath = isDefault
-          ? (slug === '' ? '/' : `/${slug}`)
-          : (slug === '' ? `/${locale}` : `/${locale}/${slug}`);
+          ? slug === ''
+            ? '/'
+            : `/${slug}`
+          : slug === ''
+            ? `/${locale}`
+            : `/${locale}/${slug}`;
 
         const result = await renderPageSSR(
           pageData,
@@ -704,7 +722,7 @@ export async function buildNextProject(
           slugMappings,
           undefined,
           cmsService,
-          true
+          true,
         );
 
         recordRender(result, urlPath, pageData, pageName);
@@ -785,7 +803,7 @@ export async function buildNextProject(
   const cmsEmissions: CMSEmission[] = [];
 
   if (existsSync(templatesDir)) {
-    const templateFiles = readdirSync(templatesDir).filter(f => f.endsWith('.json'));
+    const templateFiles = readdirSync(templatesDir).filter((f) => f.endsWith('.json'));
 
     for (const file of templateFiles) {
       const templateContent = await loadJSONFile(join(templatesDir, file));
@@ -811,9 +829,8 @@ export async function buildNextProject(
         const items = await cmsService.queryItems({ collection: cmsSchema.id });
         const urlPatternWithoutSlash = cmsSchema.urlPattern.replace(/^\//, '');
         const slugPlaceholderIdx = urlPatternWithoutSlash.indexOf('{{');
-        const pathPrefix = slugPlaceholderIdx > 0
-          ? urlPatternWithoutSlash.substring(0, slugPlaceholderIdx).replace(/\/$/, '')
-          : '';
+        const pathPrefix =
+          slugPlaceholderIdx > 0 ? urlPatternWithoutSlash.substring(0, slugPlaceholderIdx).replace(/\/$/, '') : '';
 
         for (const localeEntry of i18nConfig.locales) {
           const localeCode = localeEntry.code;
@@ -839,7 +856,7 @@ export async function buildNextProject(
               slugMappings,
               { cms: itemWithUrl },
               cmsService,
-              true
+              true,
             );
 
             mergeInteractiveStyles(result.interactiveStylesMap);
@@ -912,12 +929,14 @@ export async function buildNextProject(
   const themeColorCSS = generateThemeColorVariablesCSS(themeConfig);
   const variablesCSS = generateVariablesCSS(variablesConfig, breakpoints, responsiveScales);
   const componentCSSCombined = Array.from(allComponentCSS).join('\n');
-  const utilityCSS = allUtilityClasses.size > 0
-    ? generateUtilityCSS(allUtilityClasses, breakpoints, responsiveScales, remConversionConfig)
-    : '';
-  const interactiveStylesCSS = allInteractiveStyles.size > 0
-    ? generateAllInteractiveCSS(allInteractiveStyles, breakpoints, remConversionConfig, responsiveScales)
-    : '';
+  const utilityCSS =
+    allUtilityClasses.size > 0
+      ? generateUtilityCSS(allUtilityClasses, breakpoints, responsiveScales, remConversionConfig)
+      : '';
+  const interactiveStylesCSS =
+    allInteractiveStyles.size > 0
+      ? generateAllInteractiveCSS(allInteractiveStyles, breakpoints, remConversionConfig, responsiveScales)
+      : '';
 
   const baseCSS = `@layer base {
   * { margin: 0; padding: 0; box-sizing: border-box; }
@@ -948,7 +967,9 @@ export async function buildNextProject(
     utilityCSS,
     componentCSSCombined,
     interactiveStylesCSS,
-  ].filter(Boolean).join('\n\n');
+  ]
+    .filter(Boolean)
+    .join('\n\n');
 
   await writeFile(join(appDir, 'globals.css'), globalCSS, 'utf-8');
 
@@ -1091,9 +1112,7 @@ export default function MetaTags({ html }: { html: string }) {
   // 10. Emit regular page files (app/<path>/page.tsx)
   // ----------------------------------------------------------
   for (const result of allResults) {
-    const scriptPaths: string[] = result.javascript
-      ? [`/_scripts/${hashContent(result.javascript)}.js`]
-      : [];
+    const scriptPaths: string[] = result.javascript ? [`/_scripts/${hashContent(result.javascript)}.js`] : [];
 
     const route = urlPathToAppRoute(result.urlPath);
     const targetDir = route.isRoot ? appDir : join(appDir, route.dir);
@@ -1123,7 +1142,7 @@ export default function MetaTags({ html }: { html: string }) {
     });
     content = content.replace(
       "import RawHead from '../components/RawHead';",
-      `import RawHead from '${rawHeadImportPath}';`
+      `import RawHead from '${rawHeadImportPath}';`,
     );
 
     await writeFile(pageFilePath, content, 'utf-8');
@@ -1298,17 +1317,11 @@ export default nextConfig;
   await writeFile(
     join(outDir, 'next-env.d.ts'),
     `/// <reference types="next" />\n/// <reference types="next/image-types/global" />\n`,
-    'utf-8'
+    'utf-8',
   );
 
   // .gitignore — keep the exported project clean when committed.
-  const gitignore = [
-    'node_modules',
-    '.next',
-    'out',
-    '.DS_Store',
-    '*.log',
-  ].join('\n') + '\n';
+  const gitignore = ['node_modules', '.next', 'out', '.DS_Store', '*.log'].join('\n') + '\n';
   await writeFile(join(outDir, '.gitignore'), gitignore, 'utf-8');
 
   // README — quick start, mirrors what Astro export ships.

package/build-static.test.ts

@@ -71,7 +71,7 @@ describe('formatBunLog', () => {
   test('formats log with position info', () => {
     const log = {
       position: { file: 'src/app.ts', line: 42, column: 10, lineText: 'const x = y;' },
-      message: 'Variable not found'
+      message: 'Variable not found',
     };
     const result = formatBunLog(log);
     expect(result).toContain('File: src/app.ts');
@@ -110,7 +110,7 @@ describe('formatBunLog', () => {
   test('handles position without lineText', () => {
     const log = {
       position: { file: 'index.ts', line: 1 },
-      message: 'Error'
+      message: 'Error',
     };
     const result = formatBunLog(log);
     expect(result).toContain('File: index.ts');
@@ -160,6 +160,21 @@ describe('getLocalizedOutputPath', () => {
   test('deep nested path with default locale', () => {
     expect(getLocalizedOutputPath('/blog/post', 'en', 'en', dist)).toBe('/project/dist/blog/post.html');
   });
+
+  test('normalizes "/" slug to index.html (path-like slug from editor)', () => {
+    const slugs = { en: '/' };
+    expect(getLocalizedOutputPath('/', 'en', 'en', dist, slugs)).toBe('/project/dist/index.html');
+  });
+
+  test('normalizes leading-slash slug', () => {
+    const slugs = { en: '/privacy' };
+    expect(getLocalizedOutputPath('/privacy', 'en', 'en', dist, slugs)).toBe('/project/dist/privacy.html');
+  });
+
+  test('normalizes trailing-slash slug', () => {
+    const slugs = { en: 'privacy/' };
+    expect(getLocalizedOutputPath('/privacy', 'en', 'en', dist, slugs)).toBe('/project/dist/privacy.html');
+  });
 });
 
 // ============================================================================
@@ -197,6 +212,16 @@ describe('getDisplayPath', () => {
     const slugs = { en: 'about' };
     expect(getDisplayPath('/about', 'de', 'en', slugs)).toBe('/de/about');
   });
+
+  test('normalizes "/" slug to root path', () => {
+    const slugs = { en: '/' };
+    expect(getDisplayPath('/', 'en', 'en', slugs)).toBe('/');
+  });
+
+  test('normalizes leading-slash slug', () => {
+    const slugs = { en: '/privacy' };
+    expect(getDisplayPath('/privacy', 'en', 'en', slugs)).toBe('/privacy');
+  });
 });
 
 // ============================================================================
@@ -208,9 +233,9 @@ describe('isCMSPage', () => {
     const page = {
       meta: {
         source: 'cms',
-        cms: { id: 'blog', urlPattern: '/blog/{{slug}}', slugField: 'slug' }
+        cms: { id: 'blog', urlPattern: '/blog/{{slug}}', slugField: 'slug' },
       },
-      nodes: []
+      nodes: [],
     } as unknown as JSONPage;
     expect(isCMSPage(page)).toBe(true);
   });
@@ -218,7 +243,7 @@ describe('isCMSPage', () => {
   test('returns false when source is not cms', () => {
     const page = {
       meta: { title: 'About' },
-      nodes: []
+      nodes: [],
     } as unknown as JSONPage;
     expect(isCMSPage(page)).toBe(false);
   });
@@ -226,7 +251,7 @@ describe('isCMSPage', () => {
   test('returns false when source is cms but cms config is missing', () => {
     const page = {
       meta: { source: 'cms' },
-      nodes: []
+      nodes: [],
     } as unknown as JSONPage;
     expect(isCMSPage(page)).toBe(false);
   });
@@ -249,7 +274,10 @@ describe('isCMSPage', () => {
 describe('buildCMSItemPath', () => {
   const defaultI18nConfig: I18nConfig = {
     defaultLocale: 'en',
-    locales: [{ code: 'en', name: 'English' }, { code: 'fr', name: 'French' }]
+    locales: [
+      { code: 'en', name: 'English' },
+      { code: 'fr', name: 'French' },
+    ],
   };
 
   test('replaces {{slug}} with item slug field', () => {
@@ -280,7 +308,7 @@ describe('buildCMSItemPath', () => {
     const item: CMSItem = {
       _id: '1',
       _slug: { _i18n: true, en: 'hello', fr: 'bonjour' },
-      title: 'Test'
+      title: 'Test',
     };
     const result = buildCMSItemPath('/page/{{slug}}', item, '_slug', 'fr', defaultI18nConfig);
     expect(result).toBe('/page/bonjour');
@@ -290,7 +318,7 @@ describe('buildCMSItemPath', () => {
     const item: CMSItem = {
       _id: '1',
       _slug: { _i18n: true, en: 'hello', fr: 'bonjour' },
-      title: 'Test'
+      title: 'Test',
     };
     const result = buildCMSItemPath('/page/{{slug}}', item, '_slug', 'en', defaultI18nConfig);
     expect(result).toBe('/page/hello');
@@ -316,7 +344,8 @@ describe('injectTrackingScript', () => {
   });
 
   test('preserves existing head content', () => {
-    const html = '<html><head><meta charset="utf-8"><link rel="stylesheet" href="style.css"></head><body></body></html>';
+    const html =
+      '<html><head><meta charset="utf-8"><link rel="stylesheet" href="style.css"></head><body></body></html>';
     const script = 'track()';
     const result = injectTrackingScript(html, script);
     expect(result).toContain('<meta charset="utf-8">');