meno-core 1.0.40 → 1.0.41

package/lib/server/astro/nodeToAstro.ts

@@ -102,6 +102,8 @@ export interface AstroEmitContext {
   slugMappings?: SlugMap[];
   /** I18n default locale (for slug translation) */
   i18nDefaultLocale?: string;
+  /** Image format: 'webp' uses plain <img>, 'avif' uses <picture> with AVIF+WebP sources */
+  imageFormat?: 'webp' | 'avif';
 }
 
 // ---------------------------------------------------------------------------
@@ -773,8 +775,8 @@ function emitImageNode(node: HtmlNode, ctx: AstroEmitContext): string {
   const ifExpr = emitIfOpen(node, ctx);
   const ifClose = emitIfClose(node, ctx);
 
-  // If we have AVIF srcset, render as <picture> with split classes
-  if (metadata?.avifSrcset) {
+  // If we have AVIF srcset and format allows, render as <picture> with split classes
+  if (metadata?.avifSrcset && ctx.imageFormat !== 'webp') {
     // Extract static classes from classExpr for splitting
     const classMatch = classExpr.match(/class="([^"]*)"/);
     const classListMatch = classExpr.match(/class:list={\[(.+)\]}/);
@@ -998,6 +1000,31 @@ function emitEmbedNode(node: EmbedNode, ctx: AstroEmitContext): string {
     }
   }
 
+  // Handle template expressions in HTML string (e.g., "{{icon}}")
+  if (typeof node.html === 'string' && hasTemplates(node.html) && ctx.isComponentDef) {
+    const fullMatch = node.html.match(/^\{\{(.+)\}\}$/);
+    if (fullMatch) {
+      let propRef = fullMatch[1].trim();
+      if (ctx.listItemBinding) propRef = rewriteItemVar(propRef, ctx.listItemBinding);
+      if (ctx.listIndexVar) propRef = replaceItemMetaVars(propRef, ctx.listIndexVar, ctx.listSourceVar);
+
+      let tplClassExpr = classExpr;
+      if (!classExpr.includes('oem')) {
+        if (classExpr) {
+          tplClassExpr = classExpr.replace(/class="/, 'class="oem ').replace(/class:list={\['/, "class:list={['oem ");
+        } else {
+          tplClassExpr = ' class="oem"';
+        }
+      }
+
+      return (
+        `${ifExpr}${ind(ctx)}<div${tplClassExpr}${attrs}>\n` +
+        `${ind(ctx)}  <Fragment set:html={${propRef}} />\n` +
+        `${ind(ctx)}</div>\n${emitIfClose(node, ctx)}`
+      );
+    }
+  }
+
   const htmlStr = typeof node.html === 'string' ? node.html : '';
   const escapedHtml = escapeTemplateLiteral(htmlStr);
 
@@ -1156,7 +1183,7 @@ function emitImageTypeNode(node: any, ctx: AstroEmitContext): string {
 
     const sizesValue = DEFAULT_SIZES;
 
-    if (metadata.avifSrcset) {
+    if (metadata.avifSrcset && ctx.imageFormat !== 'webp') {
       const classMatch = classExpr.match(/class="([^"]*)"/);
       const allClasses = classMatch ? classMatch[1].split(/\s+/).filter(Boolean) : [];
       const { pictureClasses, imgClasses } = splitImageClasses(allClasses);
@@ -1496,6 +1523,10 @@ function emitIfOpen(node: ComponentNode, ctx: AstroEmitContext): string {
     // Component prop context
     if (ctx.isComponentDef) {
       const fullMatch = ifValue.match(/^\{\{(.+)\}\}$/);
+      if (!fullMatch && !/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(ifValue)) {
+        // Plain string without template syntax and not a valid identifier — always truthy, skip conditional
+        return '';
+      }
       let expr = fullMatch ? fullMatch[1].trim() : ifValue.replace(/\{\{(.+?)\}\}/g, '$1');
       if (ctx.listItemBinding) expr = rewriteItemVar(expr, ctx.listItemBinding);
       if (ctx.listIndexVar) expr = replaceItemMetaVars(expr, ctx.listIndexVar, ctx.listSourceVar);
@@ -1519,7 +1550,15 @@ function emitIfClose(node: ComponentNode, ctx: AstroEmitContext): string {
   if (typeof ifValue === 'string') {
     const hasCmsCondition = ctx.cmsMode && ifValue.includes('{{cms.');
     const hasItemCondition = ctx.listItemBinding && /\{\{/.test(ifValue);
-    if (hasCmsCondition || hasItemCondition || ctx.isComponentDef) {
+    if (hasCmsCondition || hasItemCondition) {
+      return `${ind(ctx)})}\n`;
+    }
+    if (ctx.isComponentDef) {
+      const fullMatch = ifValue.match(/^\{\{(.+)\}\}$/);
+      if (!fullMatch && !/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(ifValue)) {
+        // Matches the skip in emitIfOpen — no open brace was emitted
+        return '';
+      }
       return `${ind(ctx)})}\n`;
     }
   }

package/lib/server/astro/pageEmitter.ts

@@ -51,6 +51,8 @@ export interface PageEmitOptions {
   currentPageSlugMap?: Record<string, string>;
   /** Slug mappings for translating internal link hrefs */
   slugMappings?: SlugMap[];
+  /** Image format: 'webp' uses plain <img>, 'avif' uses <picture> */
+  imageFormat?: 'webp' | 'avif';
 }
 
 // ---------------------------------------------------------------------------
@@ -102,6 +104,7 @@ export function emitAstroPage(options: PageEmitOptions): string {
     i18nConfig,
     currentPageSlugMap,
     slugMappings,
+    imageFormat,
   } = options;
 
   const breakpoints = breakpointsOpt ?? DEFAULT_BREAKPOINTS;
@@ -132,6 +135,7 @@ export function emitAstroPage(options: PageEmitOptions): string {
     astroImports: new Set<string>(),
     slugMappings,
     i18nDefaultLocale: i18nConfig?.defaultLocale,
+    imageFormat,
   };
 
   // Emit the template body

package/lib/server/index.ts

@@ -17,7 +17,7 @@ export { generateBuildErrorPage, type BuildError, type BuildErrorsData } from '.
 export { PageService } from './services/pageService';
 export { ComponentService, type ComponentInfo } from './services/componentService';
 export { CMSService, type ReferenceLocation } from './services/cmsService';
-export { configService, ConfigService } from './services/configService';
+export { configService, ConfigService, type ImageFormat } from './services/configService';
 export { ColorService, colorService } from './services/ColorService';
 export { VariableService, variableService } from './services/VariableService';
 export { EnumService, enumService } from './services/EnumService';
@@ -62,9 +62,6 @@ export { migrateTemplatesDirectory } from './migrateTemplates';
 // Static build
 export { buildStaticPages } from '../../build-static';
 
-// Astro export
-export { buildAstroProject } from '../../build-astro';
-
 // Webflow export
 export { buildWebflowPayload } from './webflow';
 export type {
@@ -74,6 +71,23 @@ export type {
   WebflowStyleClass,
 } from './webflow';
 
+// JSON loaders
+export {
+  loadJSONFile,
+  loadComponentDirectory,
+  mapPageNameToPath,
+  parseJSON,
+  loadI18nConfig,
+  loadBreakpointConfig,
+  loadResponsiveScalesConfig,
+} from './jsonLoader';
+
+// CSS generation
+export { generateThemeColorVariablesCSS, generateVariablesCSS } from './cssGenerator';
+
+// Font utilities
+export { generateFontCSS, generateFontPreloadTags } from '../shared/fontLoader';
+
 // Utilities
 export * from './utils';
 

package/lib/server/services/configService.ts

@@ -28,6 +28,8 @@ export interface IconsConfig {
 /**
  * Raw project config structure from project.config.json
  */
+export type ImageFormat = 'webp' | 'avif';
+
 interface RawProjectConfig {
   breakpoints?: BreakpointConfigInput;
   responsiveScales?: Partial<ResponsiveScales>;
@@ -36,6 +38,7 @@ interface RawProjectConfig {
   libraries?: LibrariesConfig;
   csp?: CSPConfig;
   baseComponent?: string;
+  imageFormat?: ImageFormat;
 }
 
 /**
@@ -253,6 +256,15 @@ export class ConfigService {
     return this.config.baseComponent;
   }
 
+  /**
+   * Get image format setting
+   * Returns 'webp' (default) or 'avif'
+   */
+  getImageFormat(): ImageFormat {
+    if (this.config?.imageFormat === 'avif') return 'avif';
+    return 'webp';
+  }
+
   /**
    * Get raw config value by key (for extension)
    */

package/lib/server/ssr/htmlGenerator.ts

@@ -396,11 +396,6 @@ button {
   cursor: pointer;
   outline: inherit;
 }
-img {
-  display: block;
-  width: 100%;
-  height: 100%;
-}
 picture {
   display: block;
 }

package/lib/server/ssr/imageMetadata.ts

@@ -135,7 +135,7 @@ export function extractImgSrc(imgTag: string): string | null {
  * Only rewrites images that exist in the metadata map (project images with generated variants).
  * External/unrecognized images are left unchanged.
  */
-export function rewriteRichTextImages(html: string, metadataMap: ImageMetadataMap): string {
+export function rewriteRichTextImages(html: string, metadataMap: ImageMetadataMap, imageFormat?: 'webp' | 'avif'): string {
   return html.replace(/<img\b([^>]*)\/?>/gi, (fullMatch, innerAttrs: string) => {
     const src = extractImgSrc(fullMatch);
     if (!src) return fullMatch;
@@ -158,8 +158,8 @@ export function rewriteRichTextImages(html: string, metadataMap: ImageMetadataMa
 
     const sizes = DEFAULT_SIZES;
 
-    // Render as <picture> with AVIF + WebP sources when AVIF is available
-    if (metadata.avifSrcset) {
+    // Render as <picture> with AVIF + WebP sources when AVIF is available and format allows
+    if (metadata.avifSrcset && imageFormat !== 'webp') {
       return `<picture>` +
         `<source type="image/avif" srcset="${escapeHtml(metadata.avifSrcset)}" sizes="${escapeHtml(sizes)}" />` +
         `<source type="image/webp" srcset="${escapeHtml(metadata.srcset)}" sizes="${escapeHtml(sizes)}" />` +

package/lib/server/ssr/ssrRenderer.ts

@@ -12,6 +12,7 @@ import type { BreakpointConfig } from '../../shared/breakpoints';
 import { evaluateTemplate, processStructure, isResponsiveStyle, isHtmlMapping, resolveHtmlMapping } from '../../client/templateEngine';
 import { resolvePropsFromDefinition, isRichTextMarker, richTextMarkerToHtml } from '../../shared/propResolver';
 import { loadBreakpointConfig, loadI18nConfig } from '../jsonLoader';
+import { configService } from '../services/configService';
 import type { I18nConfig } from '../../shared/types/components';
 import { extractLocaleFromPath, DEFAULT_I18N_CONFIG, resolveI18nValue, buildLocalizedPath, isI18nValue } from '../../shared/i18n';
 import { NODE_TYPE } from '../../shared/constants';
@@ -118,6 +119,8 @@ interface SSRContext {
   isProductionBuild?: boolean;
   /** Collector for SSR fallback HTML of complex nodes (list, locale-list) keyed by element path */
   ssrFallbackCollector?: Map<string, string>;
+  /** Image format: 'webp' uses plain <img>, 'avif' uses <picture> with AVIF+WebP sources */
+  imageFormat?: 'webp' | 'avif';
 }
 
 /**
@@ -408,6 +411,7 @@ export async function buildComponentHTML(
     neededCollections, // Track collections that need client-side data
     isProductionBuild,
     ssrFallbackCollector, // Collect SSR fallback HTML for complex nodes
+    imageFormat: configService.getImageFormat(),
   };
 
   const html = await renderNode(node, ctx);
@@ -800,7 +804,7 @@ async function renderNode(
       // Check for raw HTML marker (from rich-text fields) - don't escape
       if (text.startsWith(RAW_HTML_PREFIX)) {
         let rawHtml = text.slice(RAW_HTML_PREFIX.length);
-        if (ctx.imageMetadataMap) rawHtml = rewriteRichTextImages(rawHtml, ctx.imageMetadataMap);
+        if (ctx.imageMetadataMap) rawHtml = rewriteRichTextImages(rawHtml, ctx.imageMetadataMap, ctx.imageFormat);
         rawHtml = await expandRichTextComponents(rawHtml, ctx);
         rawHtml = localizeRichTextLinks(rawHtml, ctx);
         return rawHtml;
@@ -820,7 +824,7 @@ async function renderNode(
     // Check for raw HTML marker (from rich-text fields) - don't escape
     if (text.startsWith(RAW_HTML_PREFIX)) {
       let rawHtml = text.slice(RAW_HTML_PREFIX.length);
-      if (ctx.imageMetadataMap) rawHtml = rewriteRichTextImages(rawHtml, ctx.imageMetadataMap);
+      if (ctx.imageMetadataMap) rawHtml = rewriteRichTextImages(rawHtml, ctx.imageMetadataMap, ctx.imageFormat);
       rawHtml = await expandRichTextComponents(rawHtml, ctx);
       rawHtml = localizeRichTextLinks(rawHtml, ctx);
       return rawHtml;
@@ -892,7 +896,7 @@ async function renderNode(
       KEEP_CONTENT: true
     }) : htmlContent;
     const optimizedHtml = ctx.imageMetadataMap
-      ? rewriteRichTextImages(sanitizedHtml, ctx.imageMetadataMap)
+      ? rewriteRichTextImages(sanitizedHtml, ctx.imageMetadataMap, ctx.imageFormat)
       : sanitizedHtml;
 
     // Extract attributes from node
@@ -1227,27 +1231,52 @@ async function renderComponent(
     // Merge instance style overrides, className, and attributes
     // processedStructure is typically an HTML node (the component's root element)
     // Handle both component nodes and HTML nodes
-    const rootNode = processedStructure as ComponentNode & { props?: Record<string, unknown> };
+    const rootNode = processedStructure as ComponentNode & { props?: Record<string, unknown>; style?: any; attributes?: Record<string, string | number | boolean> };
     if (isComponentNode(rootNode) || isHtmlNode(rootNode)) {
       if (!rootNode.props) {
         rootNode.props = {};
       }
 
-      if (rootNode.props.style && typeof rootNode.props.style === 'object') {
-        rootNode.props.style = {
-          ...(rootNode.props.style as Record<string, unknown>),
-          ...(propsWithStyleAndAttrs.style as Record<string, unknown> || {})
-        };
-      } else if (propsWithStyleAndAttrs.style) {
-        rootNode.props.style = propsWithStyleAndAttrs.style;
+      // For HTML root nodes, merge styles into node.style (where the renderer reads them)
+      if (isHtmlNode(rootNode)) {
+        if (propsWithStyleAndAttrs.style) {
+          const existingStyle = rootNode.style;
+          if (existingStyle && typeof existingStyle === 'object') {
+            rootNode.style = {
+              ...(existingStyle as Record<string, any>),
+              ...(propsWithStyleAndAttrs.style as Record<string, any>)
+            };
+          } else {
+            rootNode.style = propsWithStyleAndAttrs.style as any;
+          }
+        }
+      } else {
+        // For component root nodes, merge into props.style
+        if (rootNode.props.style && typeof rootNode.props.style === 'object') {
+          rootNode.props.style = {
+            ...(rootNode.props.style as Record<string, unknown>),
+            ...(propsWithStyleAndAttrs.style as Record<string, unknown> || {})
+          };
+        } else if (propsWithStyleAndAttrs.style) {
+          rootNode.props.style = propsWithStyleAndAttrs.style;
+        }
       }
 
       // Merge className from component instance (includes responsive utility classes)
       if (propsWithStyleAndAttrs.className) {
-        const existingClassName = rootNode.props.className || '';
-        rootNode.props.className = existingClassName
-          ? `${existingClassName} ${propsWithStyleAndAttrs.className}`
-          : propsWithStyleAndAttrs.className;
+        if (isHtmlNode(rootNode)) {
+          // For HTML root nodes, merge into attributes where the renderer reads them
+          if (!rootNode.attributes) rootNode.attributes = {};
+          const existingClass = (rootNode.attributes.class || '') as string;
+          rootNode.attributes.class = existingClass
+            ? `${existingClass} ${propsWithStyleAndAttrs.className}`
+            : propsWithStyleAndAttrs.className as string;
+        } else {
+          const existingClassName = rootNode.props.className || '';
+          rootNode.props.className = existingClassName
+            ? `${existingClassName} ${propsWithStyleAndAttrs.className}`
+            : propsWithStyleAndAttrs.className;
+        }
       }
 
       // Merge attributes into props
@@ -1440,8 +1469,8 @@ function renderImageElement(
 
   // Collect high-priority images for preloading in head
   if (fetchpriority === 'high' && metadata && ctx.preloadImages) {
-    // Prefer AVIF, fallback to WebP
-    if (metadata.avifSrcset) {
+    // Prefer AVIF when format allows, fallback to WebP
+    if (metadata.avifSrcset && ctx.imageFormat !== 'webp') {
       ctx.preloadImages.push({
         srcset: metadata.avifSrcset,
         type: 'image/avif',
@@ -1472,9 +1501,9 @@ function renderImageElement(
     blurStyle = ` style="background-image: url(${escapeHtml(metadata.blurHash)}); background-size: cover;" onload="this.style.backgroundImage=''"`;
   }
 
-  // Render as <picture> element if AVIF is available
+  // Render as <picture> element if AVIF is available and imageFormat is 'avif'
   // Layout classes go on <picture> (block container), image-specific classes on <img>
-  if (metadata?.avifSrcset) {
+  if (metadata?.avifSrcset && ctx.imageFormat !== 'webp') {
     // Image-specific class prefixes that should stay on <img>
     const imgClassPrefixes = [
       'objf-', 'objp-', 'flt-', 'tm-', 'bs-',

package/lib/shared/constants.ts

@@ -131,6 +131,7 @@ export const IFRAME_MESSAGE_TYPES = {
   PAGE_DATA_PREVIEW_REVERT: 'PAGE_DATA_PREVIEW_REVERT', // Editor → Iframe to revert preview
   PAGE_DATA_COMMITTED: 'PAGE_DATA_COMMITTED', // Editor → Iframe for committed mutations
   COMPONENT_DEFINITION_COMMITTED: 'COMPONENT_DEFINITION_COMMITTED', // Editor → Iframe for component definition updates
+  CSS_VARIABLE_UPDATE: 'CSS_VARIABLE_UPDATE', // Editor → Iframe for instant CSS variable preview
 } as const;
 
 // Component node type constants
@@ -152,6 +153,7 @@ export const SPECIAL_PATHS = {
   COMPONENT_JAVASCRIPT: 'component_javascript',
   COMPONENT_CSS: 'component_css',
   COMPONENT_LIBRARIES: 'component_libraries',
+  COMPONENT_ACCEPTS_STYLES: 'component_acceptsStyles',
   STRUCTURE_STYLE: 'structure_style',
 } as const;
 

package/lib/shared/types/components.ts

@@ -132,6 +132,8 @@ export interface StructuredComponentDefinition {
   defineVars?: true | string[];
   /** External JS/CSS libraries required by this component */
   libraries?: LibrariesConfig;
+  /** Whether instances of this component can have styles applied to the wrapper */
+  acceptsStyles?: boolean;
 }
 
 /**
@@ -166,13 +168,14 @@ export interface JSONPage {
 /**
  * Page data type that can be either a JSONPage or a component definition structure
  */
-export type PageData = JSONPage | { 
-  component: { 
-    structure?: ComponentNode; 
+export type PageData = JSONPage | {
+  component: {
+    structure?: ComponentNode;
     interface?: Record<string, PropDefinition>;
     javascript?: string;
     css?: string;
-  } 
+    acceptsStyles?: boolean;
+  }
 };
 
 /**
@@ -185,5 +188,6 @@ export interface PageDataWithComponent {
     javascript?: string;
     css?: string;
     libraries?: LibrariesConfig;
+    acceptsStyles?: boolean;
   };
 }

package/lib/shared/validation/propValidator.ts

@@ -6,6 +6,7 @@
 
 import type { PropDefinition } from '../types/components';
 import { isI18nValue } from '../i18n';
+import { isTiptapDocument } from '../richtext/types';
 
 /**
  * Validation error with context for prop validation
@@ -158,7 +159,7 @@ function validateSingleProp(
       // Rich-text accepts both strings and i18n values (i18n values will be resolved later)
       // Coerce numbers/booleans to strings (e.g. from CMS template resolution like {{item.value}})
       coercedValue = (typeof value === 'number' || typeof value === 'boolean') ? String(value) : value;
-      typeValid = typeof coercedValue === 'string' || isI18nValue(coercedValue);
+      typeValid = typeof coercedValue === 'string' || isI18nValue(coercedValue) || isTiptapDocument(coercedValue);
       break;
 
     case 'file':

package/lib/shared/validation/schemas.ts

@@ -379,6 +379,7 @@ export const StructuredComponentDefinitionSchema = z.object({
   css: z.string().optional(),
   category: z.string().optional(),
   libraries: LibrariesConfigSchema.optional(),
+  acceptsStyles: z.boolean().optional(),
 }).passthrough();
 
 /**
@@ -477,7 +478,8 @@ export const PageDataWithComponentSchema = z.object({
     interface: z.record(z.string(), PropDefinitionSchema).optional(),
     javascript: z.string().optional(),
     css: z.string().optional(),
-  }),
+    acceptsStyles: z.boolean().optional(),
+  }).passthrough(),
 }).passthrough();
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meno-core",
-  "version": "1.0.40",
+  "version": "1.0.41",
   "type": "module",
   "bin": {
     "meno": "./dist/bin/cli.js"

package/templates/index-router.html

@@ -18,11 +18,6 @@
       background: none;
       border: none;
     }
-
-    img {
-      width: 100%;
-      height: 100%;
-    }
   </style>
 </head>
 <body>

package/dist/chunks/chunk-A6KWUEA6.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../lib/server/services/configService.ts"],
-  "sourcesContent": ["/**\n * Config Service\n * Centralized configuration loading and access\n *\n * Consolidates multiple config loaders into a single service that loads\n * the project.config.json file once and exposes typed sections.\n */\n\nimport type { BreakpointConfig, BreakpointConfigInput, BreakpointEntry } from '../../shared/breakpoints';\nimport { DEFAULT_BREAKPOINTS, normalizeBreakpointConfig } from '../../shared/breakpoints';\nimport type { ResponsiveScales, BreakpointScales } from '../../shared/responsiveScaling';\nimport { DEFAULT_RESPONSIVE_SCALES } from '../../shared/responsiveScaling';\nimport type { I18nConfig } from '../../shared/types/components';\nimport type { LibrariesConfig, JSLibraryConfig, CSSLibraryConfig } from '../../shared/types/libraries';\nimport type { CSPConfig } from '../../shared/types/config';\nimport { DEFAULT_I18N_CONFIG, migrateI18nConfig } from '../../shared/i18n';\nimport { projectPaths } from '../projectContext';\nimport { readTextFile, fileExists } from '../runtime';\n\n/**\n * Icons configuration\n */\nexport interface IconsConfig {\n  favicon?: string;\n  appleTouchIcon?: string;\n}\n\n/**\n * Raw project config structure from project.config.json\n */\ninterface RawProjectConfig {\n  breakpoints?: BreakpointConfigInput;\n  responsiveScales?: Partial<ResponsiveScales>;\n  i18n?: unknown;\n  icons?: IconsConfig;\n  libraries?: LibrariesConfig;\n  csp?: CSPConfig;\n  baseComponent?: string;\n}\n\n/**\n * ConfigService\n * Loads project configuration once and provides typed access to sections\n */\nexport class ConfigService {\n  private config: RawProjectConfig | null = null;\n  private loaded = false;\n\n  /**\n   * Load configuration from project.config.json\n   * Safe to call multiple times - only loads once\n   */\n  async load(): Promise<void> {\n    if (this.loaded) {\n      return;\n    }\n\n    try {\n      if (await fileExists(projectPaths.config())) {\n        const content = await readTextFile(projectPaths.config());\n        this.config = JSON.parse(content);\n      }\n    } catch {\n      // Fall through to defaults\n      this.config = null;\n    }\n\n    this.loaded = true;\n  }\n\n  /**\n   * Check if configuration has been loaded\n   */\n  isLoaded(): boolean {\n    return this.loaded;\n  }\n\n  /**\n   * Reset the service (for testing)\n   */\n  reset(): void {\n    this.config = null;\n    this.loaded = false;\n  }\n\n  /**\n   * Get breakpoint configuration\n   * Returns validated and normalized breakpoints (always object format)\n   * Supports both legacy format { tablet: 1024 } and new format { tablet: { breakpoint: 1024, previewPoint: 768 } }\n   */\n  getBreakpoints(): BreakpointConfig {\n    if (!this.config?.breakpoints || typeof this.config.breakpoints !== 'object') {\n      return { ...DEFAULT_BREAKPOINTS };\n    }\n\n    // Validate breakpoint values before normalization\n    const validInput: BreakpointConfigInput = {};\n    for (const [key, value] of Object.entries(this.config.breakpoints)) {\n      if (typeof value === 'number' && value > 0) {\n        // Legacy format: number\n        validInput[key] = value;\n      } else if (typeof value === 'object' && value !== null) {\n        // New format: object with breakpoint and optional previewPoint\n        const entry = value as BreakpointEntry;\n        if (typeof entry.breakpoint === 'number' && entry.breakpoint > 0) {\n          validInput[key] = {\n            breakpoint: entry.breakpoint,\n            previewPoint: typeof entry.previewPoint === 'number' && entry.previewPoint > 0\n              ? entry.previewPoint\n              : entry.breakpoint,\n          };\n        }\n      }\n    }\n\n    // Return normalized breakpoints or defaults if none valid\n    if (Object.keys(validInput).length === 0) {\n      return { ...DEFAULT_BREAKPOINTS };\n    }\n\n    return normalizeBreakpointConfig(validInput);\n  }\n\n  /**\n   * Get i18n configuration\n   * Automatically migrates old string[] format to LocaleConfig[] format\n   */\n  getI18n(): I18nConfig {\n    if (!this.config?.i18n) {\n      return { ...DEFAULT_I18N_CONFIG };\n    }\n\n    return migrateI18nConfig(this.config.i18n);\n  }\n\n  /**\n   * Deep merge scale categories, preserving user-defined breakpoints\n   * while filling in missing values from defaults\n   */\n  private mergeScaleCategory(\n    userScales: BreakpointScales | undefined,\n    defaultScales: BreakpointScales | undefined\n  ): BreakpointScales | undefined {\n    if (!userScales && !defaultScales) return undefined;\n    if (!userScales) return defaultScales ? { ...defaultScales } : undefined;\n    if (!defaultScales) return { ...userScales };\n\n    // User scales take precedence, but include defaults for breakpoints not specified\n    return {\n      ...defaultScales,\n      ...userScales,\n    };\n  }\n\n  /**\n   * Get responsive scales configuration\n   * Supports dynamic breakpoints - scales are keyed by breakpoint name\n   * Deep merges scale categories to preserve user breakpoint definitions\n   */\n  getResponsiveScales(): ResponsiveScales {\n    if (!this.config?.responsiveScales || typeof this.config.responsiveScales !== 'object') {\n      return { ...DEFAULT_RESPONSIVE_SCALES };\n    }\n\n    const userScales = this.config.responsiveScales;\n\n    return {\n      enabled: userScales.enabled ?? DEFAULT_RESPONSIVE_SCALES.enabled,\n      baseReference: userScales.baseReference ?? DEFAULT_RESPONSIVE_SCALES.baseReference,\n      fontSize: this.mergeScaleCategory(\n        userScales.fontSize as BreakpointScales | undefined,\n        DEFAULT_RESPONSIVE_SCALES.fontSize\n      ),\n      padding: this.mergeScaleCategory(\n        userScales.padding as BreakpointScales | undefined,\n        DEFAULT_RESPONSIVE_SCALES.padding\n      ),\n      margin: this.mergeScaleCategory(\n        userScales.margin as BreakpointScales | undefined,\n        DEFAULT_RESPONSIVE_SCALES.margin\n      ),\n      gap: this.mergeScaleCategory(\n        userScales.gap as BreakpointScales | undefined,\n        DEFAULT_RESPONSIVE_SCALES.gap\n      ),\n    };\n  }\n\n  /**\n   * Get icons configuration\n   * Returns empty object if not configured\n   */\n  getIcons(): IconsConfig {\n    if (!this.config?.icons || typeof this.config.icons !== 'object') {\n      return {};\n    }\n\n    return this.config.icons;\n  }\n\n  /**\n   * Get libraries configuration\n   * Returns empty arrays if not configured\n   * Normalizes string URLs to object format for backwards compatibility\n   */\n  getLibraries(): LibrariesConfig {\n    if (!this.config?.libraries || typeof this.config.libraries !== 'object') {\n      return { js: [], css: [] };\n    }\n\n    const libs = this.config.libraries;\n\n    // Normalize JS libraries: support both string URLs and object format\n    const normalizedJs = Array.isArray(libs.js)\n      ? libs.js.map((lib) =>\n          typeof lib === 'string' ? { url: lib } : lib\n        ) as JSLibraryConfig[]\n      : [];\n\n    // Normalize CSS libraries: support both string URLs and object format\n    const normalizedCss = Array.isArray(libs.css)\n      ? libs.css.map((lib) =>\n          typeof lib === 'string' ? { url: lib } : lib\n        ) as CSSLibraryConfig[]\n      : [];\n\n    return {\n      js: normalizedJs,\n      css: normalizedCss,\n    };\n  }\n\n  /**\n   * Get CSP configuration\n   * Returns empty object if not configured\n   */\n  getCSP(): CSPConfig {\n    if (!this.config?.csp || typeof this.config.csp !== 'object') {\n      return {};\n    }\n\n    return this.config.csp;\n  }\n\n  /**\n   * Get base component name for new pages\n   * Returns undefined if not configured\n   */\n  getBaseComponent(): string | undefined {\n    if (!this.config?.baseComponent || typeof this.config.baseComponent !== 'string') {\n      return undefined;\n    }\n    return this.config.baseComponent;\n  }\n\n  /**\n   * Get raw config value by key (for extension)\n   */\n  getRaw<T>(key: string): T | undefined {\n    if (!this.config) {\n      return undefined;\n    }\n    return (this.config as Record<string, unknown>)[key] as T | undefined;\n  }\n}\n\n/**\n * Singleton instance for global access\n * Use this for convenience, or create your own instance for testing\n */\nexport const configService = new ConfigService();\n"],
-  "mappings": "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",
-  "names": []
-}