meno-core 1.0.38 → 1.0.39

package/lib/server/astro/pageEmitter.ts

@@ -0,0 +1,190 @@
+/**
+ * Page File Generator
+ * Generates .astro page files that import and compose components
+ */
+
+import type { JSONPage, ComponentDefinition } from '../../shared/types';
+import type { BreakpointConfig } from '../../shared/breakpoints';
+import { DEFAULT_BREAKPOINTS } from '../../shared/breakpoints';
+import { nodeToAstro, type AstroEmitContext } from './nodeToAstro';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface PageEmitOptions {
+  /** Page data */
+  pageData: JSONPage;
+  /** All global components */
+  globalComponents: Record<string, ComponentDefinition>;
+  /** Page title */
+  title: string;
+  /** Page meta HTML */
+  meta: string;
+  /** Locale */
+  locale: string;
+  /** Default theme */
+  theme: string;
+  /** Font preloads HTML */
+  fontPreloads: string;
+  /** Library tags */
+  libraryTags: { headCSS?: string; headJS?: string; bodyEndJS?: string };
+  /** Script paths */
+  scriptPaths: string[];
+  /** Import path to BaseLayout */
+  layoutImportPath: string;
+  /** File depth relative to src/pages */
+  fileDepth: number;
+  /** SSR HTML fallbacks: node path → rendered HTML (for ListNode, LocaleListNode) */
+  ssrFallbacks: Map<string, string>;
+  /** Page name (without extension) */
+  pageName: string;
+  /** Breakpoint config for responsive Tailwind classes */
+  breakpoints?: BreakpointConfig;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function escapeTemplateLiteral(s: string): string {
+  return s.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$\{/g, '\\${');
+}
+
+function escapeJSX(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/"/g, '&quot;');
+}
+
+/**
+ * Compute relative import path from page to components directory
+ */
+function componentImportPath(fileDepth: number, componentName: string): string {
+  // fileDepth 0 = src/pages/index.astro → ../components/X.astro
+  // fileDepth 1 = src/pages/en/index.astro → ../../components/X.astro
+  const ups = '../'.repeat(fileDepth + 1);
+  return `${ups}components/${componentName}.astro`;
+}
+
+// ---------------------------------------------------------------------------
+// Main emitter
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate a page .astro file from page data with component imports
+ */
+export function emitAstroPage(options: PageEmitOptions): string {
+  const {
+    pageData,
+    globalComponents,
+    title,
+    meta,
+    locale,
+    theme,
+    fontPreloads,
+    libraryTags,
+    scriptPaths,
+    layoutImportPath,
+    fileDepth,
+    ssrFallbacks,
+    pageName,
+    breakpoints: breakpointsOpt,
+  } = options;
+
+  const breakpoints = breakpointsOpt ?? DEFAULT_BREAKPOINTS;
+
+  const root = pageData.root;
+  if (!root) {
+    // Empty page - just layout wrapper
+    return buildEmptyPage(layoutImportPath, title, meta, locale, theme, fontPreloads, libraryTags, scriptPaths);
+  }
+
+  // Build the Astro emit context
+  const ctx: AstroEmitContext = {
+    imports: new Set<string>(),
+    isComponentDef: false,
+    componentProps: {},
+    globalComponents,
+    indent: 1, // inside BaseLayout
+    ssrFallbacks,
+    elementPath: [0],
+    fileType: 'page',
+    fileName: pageName,
+    breakpoints,
+  };
+
+  // Emit the template body
+  const templateBody = nodeToAstro(root, ctx);
+
+  // Build frontmatter with imports
+  const importLines: string[] = [];
+  importLines.push(`import BaseLayout from '${layoutImportPath}';`);
+
+  // Sort component imports alphabetically
+  const componentImports = Array.from(ctx.imports).sort();
+  for (const comp of componentImports) {
+    const path = componentImportPath(fileDepth, comp);
+    importLines.push(`import ${comp} from '${path}';`);
+  }
+
+  // Build script paths array
+  const scriptsArrayLiteral = scriptPaths.length > 0
+    ? `[${scriptPaths.map((s) => `"${s}"`).join(', ')}]`
+    : '[]';
+
+  // Build library tags literal
+  const libraryTagsLiteral = `{ headCSS: \`${escapeTemplateLiteral(libraryTags.headCSS || '')}\`, headJS: \`${escapeTemplateLiteral(libraryTags.headJS || '')}\`, bodyEndJS: \`${escapeTemplateLiteral(libraryTags.bodyEndJS || '')}\` }`;
+
+  const escapedMeta = escapeTemplateLiteral(meta);
+  const escapedFontPreloads = escapeTemplateLiteral(fontPreloads);
+
+  return `---
+${importLines.join('\n')}
+---
+<BaseLayout
+  title="${escapeJSX(title)}"
+  meta={\`${escapedMeta}\`}
+  scripts={${scriptsArrayLiteral}}
+  locale="${locale}"
+  theme="${theme}"
+  fontPreloads={\`${escapedFontPreloads}\`}
+  libraryTags={${libraryTagsLiteral}}
+>
+${templateBody}</BaseLayout>
+`;
+}
+
+/**
+ * Build an empty page with just the layout wrapper
+ */
+function buildEmptyPage(
+  layoutImport: string,
+  title: string,
+  meta: string,
+  locale: string,
+  theme: string,
+  fontPreloads: string,
+  libraryTags: { headCSS?: string; headJS?: string; bodyEndJS?: string },
+  scriptPaths: string[]
+): string {
+  const escapedMeta = escapeTemplateLiteral(meta);
+  const escapedFontPreloads = escapeTemplateLiteral(fontPreloads);
+  const scriptsArrayLiteral = scriptPaths.length > 0
+    ? `[${scriptPaths.map((s) => `"${s}"`).join(', ')}]`
+    : '[]';
+  const libraryTagsLiteral = `{ headCSS: \`${escapeTemplateLiteral(libraryTags.headCSS || '')}\`, headJS: \`${escapeTemplateLiteral(libraryTags.headJS || '')}\`, bodyEndJS: \`${escapeTemplateLiteral(libraryTags.bodyEndJS || '')}\` }`;
+
+  return `---
+import BaseLayout from '${layoutImport}';
+---
+<BaseLayout
+  title="${escapeJSX(title)}"
+  meta={\`${escapedMeta}\`}
+  scripts={${scriptsArrayLiteral}}
+  locale="${locale}"
+  theme="${theme}"
+  fontPreloads={\`${escapedFontPreloads}\`}
+  libraryTags={${libraryTagsLiteral}}
+>
+</BaseLayout>
+`;
+}