meno-core 1.0.53 → 1.1.0

package/build-astro.ts

@@ -4,49 +4,50 @@
  * with a shared layout, global CSS, and optional CMS content collections.
  */
 
-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 { inspect, minifyJS as runtimeMinifyJS } from './lib/server/runtime';
+import { existsSync, readdirSync, mkdirSync, rmSync, statSync, copyFileSync, writeFileSync } from 'node:fs';
+import { writeFile, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
 import {
   loadJSONFile,
   loadComponentDirectory,
   mapPageNameToPath,
   parseJSON,
-  loadI18nConfig
-} from "./lib/server/jsonLoader";
-import { generateSSRHTML } from "./lib/server/ssrRenderer";
-import type { SSRHTMLResult } from "./lib/server/ssr/htmlGenerator";
-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 { tiptapToHtml } from "./lib/shared/richtext/tiptapToHtml";
-import { isTiptapDocument } from "./lib/shared/richtext/types";
-import type { ComponentDefinition, JSONPage, CMSSchema, CMSItem, I18nConfig } from "./lib/shared/types";
-import type { CMSFieldDefinition } from "./lib/shared/types/cms";
-import { isItemDraftForLocale } from "./lib/shared/types";
-import { CMS_DRAFT_SUFFIX } from "./lib/shared/pathSecurity";
-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 { emitAstroComponent } from "./lib/server/astro/componentEmitter";
-import { emitAstroPage } from "./lib/server/astro/pageEmitter";
-import { normalizeOrphanTemplateProps } from "./lib/server/astro/normalizeOrphanTemplateProps";
+  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 { syncNetlifyLocale404Block } from './lib/shared/netlifyLocale404';
+import { tiptapToHtml } from './lib/shared/richtext/tiptapToHtml';
+import { isTiptapDocument } from './lib/shared/richtext/types';
+import type { ComponentDefinition, JSONPage, CMSSchema, CMSItem, I18nConfig } from './lib/shared/types';
+import type { CMSFieldDefinition } from './lib/shared/types/cms';
+import { CMS_DRAFT_SUFFIX } from './lib/shared/pathSecurity';
+import type { SlugMap } from './lib/shared/slugTranslator';
+import { type PreloadImage, 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 { emitAstroComponent } from './lib/server/astro/componentEmitter';
+import { emitAstroPage } from './lib/server/astro/pageEmitter';
+import { normalizeOrphanTemplateProps } from './lib/server/astro/normalizeOrphanTemplateProps';
 import { emitCMSPage, CMS_SLUG_PLACEHOLDER } from './lib/server/astro/cmsPageEmitter';
-import { collectAllMappingClasses } from "./lib/server/astro/cssCollector";
-import { buildImageMetadataMap, RESPONSIVE_WIDTHS } from "./lib/server/ssr/imageMetadata";
-import { needsFormHandler, formHandlerScript } from "./lib/client/scripts/formHandler";
-
+import { collectAllMappingClasses } from './lib/server/astro/cssCollector';
+import { buildImageMetadataMap, RESPONSIVE_WIDTHS } from './lib/server/ssr/imageMetadata';
+import { needsFormHandler, formHandlerScript } from './lib/client/scripts/formHandler';
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -70,11 +71,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);
@@ -91,9 +88,7 @@ function copyDirectory(
 // Astro's <Picture> re-derives responsive variants from originals at build
 // time, so the pre-baked -{width}.webp/.avif files and the SSR-only
 // manifest.json are dead weight in the exported project.
-const imageVariantSuffixRe = new RegExp(
-  `-(${RESPONSIVE_WIDTHS.join('|')})\\.(webp|avif)$`,
-);
+const imageVariantSuffixRe = new RegExp(`-(${RESPONSIVE_WIDTHS.join('|')})\\.(webp|avif)$`);
 function shouldCopyImageForAstro(filename: string): boolean {
   if (filename === 'manifest.json') return false;
   if (imageVariantSuffixRe.test(filename)) return false;
@@ -107,12 +102,12 @@ function isCMSPage(pageData: JSONPage): boolean {
 /**
  * Build URL path for a CMS item based on the URL pattern
  */
-function buildCMSItemPath(
+function _buildCMSItemPath(
   urlPattern: string,
   item: CMSItem,
   slugField: string,
   locale: string,
-  i18nConfig: I18nConfig
+  i18nConfig: I18nConfig,
 ): string {
   let slug = item[slugField] ?? item._slug ?? item._id;
   if (isI18nValue(slug)) {
@@ -160,10 +155,7 @@ function escapeTemplateLiteral(s: string): string {
  * Compute locale → URL path map for a page's slug translations.
  * Used by locale list rendering to generate correct links.
  */
-function computePageSlugMap(
-  slugs: Record<string, string>,
-  i18nConfig: I18nConfig
-): Record<string, string> {
+function computePageSlugMap(slugs: Record<string, string>, i18nConfig: I18nConfig): Record<string, string> {
   const map: Record<string, string> = {};
   for (const localeConfig of i18nConfig.locales) {
     const code = localeConfig.code;
@@ -198,7 +190,7 @@ function cmsFieldToZod(field: CMSFieldDefinition): string {
       return 'z.coerce.date()';
     case 'select':
       if (field.options && field.options.length > 0) {
-        const opts = field.options.map(o => `'${o.replace(/'/g, "\\'")}'`).join(', ');
+        const opts = field.options.map((o) => `'${o.replace(/'/g, "\\'")}'`).join(', ');
         return `z.enum([${opts}])`;
       }
       return 'z.string()';
@@ -263,9 +255,7 @@ function collectComponentRefs(node: unknown, acc: Set<string>): void {
  * structure (it must forward the `cms` prop down). Astro components have
  * isolated scopes, so each consumer needs the entry threaded in explicitly.
  */
-function computeCmsConsumerComponents(
-  components: Record<string, ComponentDefinition>
-): Set<string> {
+function computeCmsConsumerComponents(components: Record<string, ComponentDefinition>): Set<string> {
   const consumers = new Set<string>();
   const refsByComponent = new Map<string, Set<string>>();
 
@@ -286,7 +276,11 @@ function computeCmsConsumerComponents(
     for (const [name, refs] of refsByComponent) {
       if (consumers.has(name)) continue;
       for (const ref of refs) {
-        if (consumers.has(ref)) { consumers.add(name); changed = true; break; }
+        if (consumers.has(ref)) {
+          consumers.add(name);
+          changed = true;
+          break;
+        }
       }
     }
   }
@@ -301,8 +295,8 @@ function computeCmsConsumerComponents(
 function buildCollectionUrlExpr(schema: CMSSchema): string {
   const slugField = schema.slugField || 'slug';
   const pattern = schema.urlPattern || `/${schema.id}/{{slug}}`;
-  const body = pattern.replace(/\{\{[^}]+\}\}/, '${e.data.' + slugField + ' ?? e.id}');
-  return '`' + body + '`';
+  const body = pattern.replace(/\{\{[^}]+\}\}/, `\${e.data.${slugField} ?? e.id}`);
+  return `\`${body}\``;
 }
 
 // ---------------------------------------------------------------------------
@@ -359,15 +353,13 @@ function buildSSRFallbackPage(
   fontPreloads: string,
   libraryTags: { headCSS?: string; headJS?: string; bodyEndJS?: string },
   defaultTheme: string,
-  scriptPaths: string[]
+  scriptPaths: string[],
 ): string {
   const escapedMeta = escapeTemplateLiteral(result.meta);
   const escapedHTML = escapeTemplateLiteral(result.html);
   const escapedFontPreloads = escapeTemplateLiteral(fontPreloads);
 
-  const scriptsArrayLiteral = scriptPaths.length > 0
-    ? `[${scriptPaths.map(s => `"${s}"`).join(', ')}]`
-    : '[]';
+  const scriptsArrayLiteral = scriptPaths.length > 0 ? `[${scriptPaths.map((s) => `"${s}"`).join(', ')}]` : '[]';
 
   const libraryTagsLiteral = `{ headCSS: \`${escapeTemplateLiteral(libraryTags.headCSS || '')}\`, headJS: \`${escapeTemplateLiteral(libraryTags.headJS || '')}\`, bodyEndJS: \`${escapeTemplateLiteral(libraryTags.bodyEndJS || '')}\` }`;
 
@@ -392,10 +384,7 @@ import BaseLayout from '${importPath}';
 // Main export
 // ---------------------------------------------------------------------------
 
-export async function buildAstroProject(
-  projectRoot?: string,
-  outputDir?: string
-): Promise<AstroBuildStats> {
+export async function buildAstroProject(_projectRoot?: string, outputDir?: string): Promise<AstroBuildStats> {
   // ----------------------------------------------------------
   // 1. Setup: load project configuration
   // ----------------------------------------------------------
@@ -410,7 +399,9 @@ export async function buildAstroProject(
 
   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}`);
 
@@ -481,7 +472,9 @@ export async function buildAstroProject(
         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 */
+    }
   }
 
   // ----------------------------------------------------------
@@ -505,13 +498,25 @@ export async function buildAstroProject(
 
   // Helper to process a render result
   function processRenderResult(
-    result: { html: string; meta: string; title: string; javascript: string; componentCSS?: string; locale: string; interactiveStylesMap: Map<string, InteractiveStyles>; preloadImages: any[]; neededCollections: Set<string>; ssrFallbackCollector?: Map<string, string>; processedRawHtmlCollector?: Map<string, string> },
+    result: {
+      html: string;
+      meta: string;
+      title: string;
+      javascript: string;
+      componentCSS?: string;
+      locale: string;
+      interactiveStylesMap: Map<string, InteractiveStyles>;
+      preloadImages: PreloadImage[];
+      neededCollections: Set<string>;
+      ssrFallbackCollector?: Map<string, string>;
+      processedRawHtmlCollector?: Map<string, string>;
+    },
     urlPath: string,
     astroFilePath: string,
     fileDepth: number,
     pageData?: JSONPage,
     pageName?: string,
-    isCMSPage?: boolean
+    isCMSPage?: boolean,
   ): void {
     // Collect interactive styles
     mergeInteractiveStyles(result.interactiveStylesMap);
@@ -582,7 +587,7 @@ export async function buildAstroProject(
 
         // Compute URL path
         let slug: string;
-        if (slugs && slugs[locale]) {
+        if (slugs?.[locale]) {
           // Slugs may be authored with a leading slash (e.g. "/blog" from the
           // page-rename flow). Normalize to the bare form the rest of the
           // pipeline expects — matches buildPageUrlForLocale(). A leading slash
@@ -596,8 +601,12 @@ export async function buildAstroProject(
         }
 
         const urlPath = isDefault
-          ? (slug === '' ? '/' : `/${slug}`)
-          : (slug === '' ? `/${locale}` : `/${locale}/${slug}`);
+          ? slug === ''
+            ? '/'
+            : `/${slug}`
+          : slug === ''
+            ? `/${locale}`
+            : `/${locale}/${slug}`;
 
         // Determine .astro file path relative to src/pages/
         const astroFileName = slug === '' ? 'index.astro' : `${slug}.astro`;
@@ -614,13 +623,13 @@ export async function buildAstroProject(
           slugMappings,
           undefined, // cmsContext
           cmsService,
-          true // isProductionBuild
+          true, // isProductionBuild
         );
 
         processRenderResult(result, urlPath, astroFilePath, fileDepth, pageData, pageName, false);
       }
-    } catch (error: any) {
-      console.error(`  Error rendering ${basePath}:`, error?.message || error);
+    } catch (error) {
+      console.error(`  Error rendering ${basePath}:`, error instanceof Error ? error.message : error);
       errorCount++;
     }
   }
@@ -708,12 +717,14 @@ export async function buildAstroProject(
         for (const [fn, fd] of Object.entries(schema.fields || {})) {
           if (fd.type === 'rich-text') mergedRichTextFields.add(fn);
         }
-      } catch { /* ignore parse errors; handled in main loop */ }
+      } catch {
+        /* ignore parse errors; handled in main loop */
+      }
     }
   }
 
   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));
@@ -735,6 +746,10 @@ export async function buildAstroProject(
         const cmsSchema = pageData.meta!.cms as CMSSchema;
         templateSchemas.push(cmsSchema);
 
+        // A data-only collection (no urlPattern) has no per-item route — skip page/route
+        // generation. It is still a content collection usable in list bindings.
+        if (!cmsSchema.urlPattern) continue;
+
         // Count items for stats
         const items = await cmsService.queryItems({ collection: cmsSchema.id });
         const itemCount = items.length;
@@ -753,7 +768,7 @@ export async function buildAstroProject(
           slugMappings,
           undefined, // no CMS context - just collecting metadata
           cmsService,
-          true
+          true,
         );
 
         // Collect interactive styles and component CSS
@@ -791,13 +806,9 @@ export async function buildAstroProject(
           // Route file path: blog/[slug].astro for default, pl/blog/[slug].astro for non-default
           let astroFilePath: string;
           if (pathPrefix) {
-            astroFilePath = isDefault
-              ? `${pathPrefix}[slug].astro`
-              : `${localeCode}/${pathPrefix}[slug].astro`;
+            astroFilePath = isDefault ? `${pathPrefix}[slug].astro` : `${localeCode}/${pathPrefix}[slug].astro`;
           } else {
-            astroFilePath = isDefault
-              ? '[slug].astro'
-              : `${localeCode}/[slug].astro`;
+            astroFilePath = isDefault ? '[slug].astro' : `${localeCode}/[slug].astro`;
           }
 
           const fileDepth = astroFilePath.split('/').length - 1;
@@ -841,8 +852,8 @@ export async function buildAstroProject(
         }
 
         cmsPageCount += itemCount * i18nConfig.locales.length;
-      } catch (error: any) {
-        console.error(`  Error processing template ${file}:`, error?.message || error);
+      } catch (error) {
+        console.error(`  Error processing template ${file}:`, error instanceof Error ? error.message : error);
         errorCount++;
       }
     }
@@ -870,9 +881,7 @@ export async function buildAstroProject(
 }`;
 
   const safelistClasses = Array.from(mappingClasses);
-  const safelistDirectives = safelistClasses
-    .map(c => `@source inline("${c}");`)
-    .join('\n');
+  const safelistDirectives = safelistClasses.map((c) => `@source inline("${c}");`).join('\n');
   const tailwindDirectives = safelistDirectives
     ? `@import "tailwindcss";\n\n${safelistDirectives}`
     : `@import "tailwindcss";`;
@@ -888,19 +897,14 @@ export async function buildAstroProject(
   // ----------------------------------------------------------
   // Escape for embedding inside Astro <Fragment set:html={`...`}> template
   // literals in the generated BaseLayout file.
-  const escForTemplateLiteral = (s: string) => s
-    .replace(/\\/g, '\\\\')
-    .replace(/`/g, '\\`')
-    .replace(/\$\{/g, '\\${');
+  const escForTemplateLiteral = (s: string) => s.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
 
   const customHeadLiteral = escForTemplateLiteral(customCode.head || '');
   const customBodyStartLiteral = escForTemplateLiteral(customCode.bodyStart || '');
   const customBodyEndLiteral = escForTemplateLiteral(customCode.bodyEnd || '');
   const iconTagsLiteral = escForTemplateLiteral(iconTagsHtml);
 
-  const formHandlerBlock = projectNeedsFormHandler
-    ? `\n  <script is:inline>\n${formHandlerScript}\n  </script>`
-    : '';
+  const formHandlerBlock = projectNeedsFormHandler ? `\n  <script is:inline>\n${formHandlerScript}\n  </script>` : '';
 
   const baseLayoutContent = `---
 import '../styles/global.css';
@@ -951,18 +955,29 @@ const { title, meta = '', scripts = [], locale = 'en', theme = '${themeConfig.de
   // onto each component's interface and forward them from hosts that
   // declare the same prop. See `normalizeOrphanTemplateProps` for details.
   const emittableComponents = normalizeOrphanTemplateProps(globalComponents);
-  let componentFileCount = 0;
+  let _componentFileCount = 0;
   for (const [compName, compDef] of Object.entries(emittableComponents)) {
     try {
-      const astroContent = emitAstroComponent(compName, compDef, emittableComponents, breakpoints, i18nConfig.defaultLocale, responsiveScales, remConversionConfig, {
-        cmsConsumers: cmsConsumerComponents,
-        cmsRichTextFields: mergedRichTextFields,
-        collectionUrlExpr,
-      });
+      const astroContent = emitAstroComponent(
+        compName,
+        compDef,
+        emittableComponents,
+        breakpoints,
+        i18nConfig.defaultLocale,
+        responsiveScales,
+        remConversionConfig,
+        {
+          cmsConsumers: cmsConsumerComponents,
+          cmsRichTextFields: mergedRichTextFields,
+          collectionUrlExpr,
+        },
+      );
       await writeFile(join(componentsOutDir, `${compName}.astro`), astroContent, 'utf-8');
-      componentFileCount++;
-    } catch (error: any) {
-      console.warn(`  Warning: could not generate component ${compName}: ${error?.message}`);
+      _componentFileCount++;
+    } catch (error) {
+      console.warn(
+        `  Warning: could not generate component ${compName}: ${error instanceof Error ? error.message : String(error)}`,
+      );
     }
   }
   // ----------------------------------------------------------
@@ -983,10 +998,9 @@ const { title, meta = '', scripts = [], locale = 'en', theme = '${themeConfig.de
         const ssrFallbacks = result.ssrFallbackCollector ?? new Map<string, string>();
 
         // Compute slug map for locale list rendering
-        const pageSlugMap: Record<string, string> | undefined =
-          result.pageData.meta?.slugs
-            ? computePageSlugMap(result.pageData.meta.slugs, i18nConfig)
-            : undefined;
+        const pageSlugMap: Record<string, string> | undefined = result.pageData.meta?.slugs
+          ? computePageSlugMap(result.pageData.meta.slugs, i18nConfig)
+          : undefined;
 
         // Component-structured pages don't need page-level _scripts/*.js
         // because each .astro component already has its own inline <script>
@@ -1014,9 +1028,11 @@ const { title, meta = '', scripts = [], locale = 'en', theme = '${themeConfig.de
           processedRawHtml: result.processedRawHtmlCollector,
           remConfig: remConversionConfig,
         });
-      } catch (error: any) {
+      } catch (error) {
         // Fallback to SSR HTML if component emission fails — needs page-level script
-        console.warn(`  Warning: component emission failed for ${result.urlPath}, using SSR fallback: ${error?.message}`);
+        console.warn(
+          `  Warning: component emission failed for ${result.urlPath}, using SSR fallback: ${error instanceof Error ? error.message : String(error)}`,
+        );
         scriptPaths = writePageScript(result.javascript, scriptsDir);
         astroContent = buildSSRFallbackPage(result, importPath, fontPreloads, libraryTags, defaultTheme, scriptPaths);
       }
@@ -1084,8 +1100,8 @@ export const GET: APIRoute = () => {
         // Skip `*.draft.json` siblings in production builds — they mirror the
         // published item-list filter and may hold partial/invalid WIP data.
         const isDevBuild = process.env.MENO_DEV_BUILD === 'true';
-        const itemFiles = readdirSync(cmsItemsDir).filter(f =>
-          f.endsWith('.json') && (isDevBuild || !f.endsWith(`${CMS_DRAFT_SUFFIX}.json`))
+        const itemFiles = readdirSync(cmsItemsDir).filter(
+          (f) => f.endsWith('.json') && (isDevBuild || !f.endsWith(`${CMS_DRAFT_SUFFIX}.json`)),
         );
 
         for (const itemFile of itemFiles) {
@@ -1102,13 +1118,11 @@ export const GET: APIRoute = () => {
               resolved[fieldName] = serializeRichTextValue(resolved[fieldName]);
             }
 
-            await writeFile(
-              join(collectionDir, itemFile),
-              JSON.stringify(resolved, null, 2),
-              'utf-8'
+            await writeFile(join(collectionDir, itemFile), JSON.stringify(resolved, null, 2), 'utf-8');
+          } catch (err) {
+            console.warn(
+              `    Warning: could not process CMS item ${itemFile}: ${err instanceof Error ? err.message : String(err)}`,
             );
-          } catch (err: any) {
-            console.warn(`    Warning: could not process CMS item ${itemFile}: ${err?.message}`);
           }
         }
       }
@@ -1173,7 +1187,7 @@ export { collections };
     const srcAssetDir = join(projectPaths.project, dir);
     if (existsSync(srcAssetDir)) {
       copyDirectory(srcAssetDir, join(publicDir, dir));
-      }
+    }
   }
 
   // Copy libraries folder if it exists
@@ -1212,20 +1226,21 @@ export { collections };
     dependencies: {
       // Astro 5 (stable Vite), NOT 6 — Astro 6's rolldown-vite breaks
       // @tailwindcss/vite at build time ("Missing field `tsconfigPaths`").
-      'astro': '^5.0.0',
+      astro: '^5.0.0',
       '@astrojs/sitemap': '^3.0.0',
       '@tailwindcss/vite': '^4.0.0',
-      'tailwindcss': '^4.0.0',
+      tailwindcss: '^4.0.0',
     },
   };
 
   await writeFile(join(outDir, 'package.json'), JSON.stringify(packageJson, null, 2), 'utf-8');
 
   // astro.config.mjs
-  const localeCodes = i18nConfig.locales.map(l => l.code);
-  const i18nBlock = i18nConfig.locales.length > 1
-    ? `\n  i18n: {\n    defaultLocale: '${i18nConfig.defaultLocale}',\n    locales: [${localeCodes.map(c => `'${c}'`).join(', ')}],\n    routing: { prefixDefaultLocale: false },\n  },`
-    : '';
+  const localeCodes = i18nConfig.locales.map((l) => l.code);
+  const i18nBlock =
+    i18nConfig.locales.length > 1
+      ? `\n  i18n: {\n    defaultLocale: '${i18nConfig.defaultLocale}',\n    locales: [${localeCodes.map((c) => `'${c}'`).join(', ')}],\n    routing: { prefixDefaultLocale: false },\n  },`
+      : '';
 
   const astroConfig = `import { defineConfig } from 'astro/config';
 import tailwindcss from '@tailwindcss/vite';
@@ -1252,7 +1267,13 @@ export default defineConfig({${siteUrl ? `\n  site: '${siteUrl}',` : ''}${i18nBl
   // box. `astro` is a real dependency here (see package.json above), so once
   // Netlify runs `npm install`, `astro build` is on PATH and writes to dist/.
   // Harmless on other hosts (Cloudflare Pages / Vercel ignore this file).
-  const netlifyToml = `# Generated by Meno's Astro build.
+  //
+  // Multi-locale projects WITH a 404 page (pages/404.json) also get the managed
+  // locale-404 redirects block (lib/shared/netlifyLocale404.ts): the regular-pages
+  // loop above emits src/pages/<locale>/404.astro per non-default locale, which
+  // Astro builds to dist/<locale>/404/index.html — exactly the rules' rewrite
+  // target — while the root 404.astro becomes Netlify's default catch-all 404.html.
+  const baseNetlifyToml = `# Generated by Meno's Astro build.
 [build]
   command = "npm run build"
   publish = "dist"
@@ -1260,6 +1281,7 @@ export default defineConfig({${siteUrl ? `\n  site: '${siteUrl}',` : ''}${i18nBl
 [build.environment]
   NODE_VERSION = "22"
 `;
+  const netlifyToml = syncNetlifyLocale404Block(baseNetlifyToml, i18nConfig, pageFiles.includes('404.json'));
   await writeFile(join(outDir, 'netlify.toml'), netlifyToml, 'utf-8');
 
   // src/env.d.ts — resolves astro:assets and other virtual module types in IDE