meno-core 1.0.49 → 1.0.51

package/lib/server/ssrRenderer.test.ts

@@ -137,15 +137,100 @@ describe("SSR Renderer - generateMetaTags", () => {
       ogImage: "https://example.com/image.jpg",
       ogType: "article"
     };
-    
+
     const tags = generateMetaTags(meta);
-    
+
     expect(tags).toContain(`<meta property="og:title" content="OG Title" />`);
     expect(tags).toContain(`<meta property="og:description" content="OG Description" />`);
     expect(tags).toContain(`<meta property="og:image" content="https://example.com/image.jpg" />`);
     expect(tags).toContain(`<meta property="og:type" content="article" />`);
   });
 
+  test("should emit twitter:card=summary_large_image when ogImage present", () => {
+    const meta = {
+      ogTitle: "OG Title",
+      ogDescription: "OG Description",
+      ogImage: "https://example.com/image.jpg",
+    };
+
+    const tags = generateMetaTags(meta);
+
+    expect(tags).toContain(`<meta name="twitter:card" content="summary_large_image" />`);
+    expect(tags).toContain(`<meta name="twitter:title" content="OG Title" />`);
+    expect(tags).toContain(`<meta name="twitter:description" content="OG Description" />`);
+  });
+
+  test("should emit twitter:card=summary when no ogImage", () => {
+    const meta = {
+      title: "Plain Title",
+      description: "Plain Description",
+    };
+
+    const tags = generateMetaTags(meta);
+
+    expect(tags).toContain(`<meta name="twitter:card" content="summary" />`);
+  });
+
+  test("twitter:title falls back to title when ogTitle is absent", () => {
+    const meta = {
+      title: "Plain Title",
+      ogImage: "https://example.com/image.jpg",
+    };
+
+    const tags = generateMetaTags(meta);
+
+    expect(tags).toContain(`<meta name="twitter:title" content="Plain Title" />`);
+  });
+
+  test("twitter:description falls back to description when ogDescription is absent", () => {
+    const meta = {
+      description: "Plain Description",
+      ogImage: "https://example.com/image.jpg",
+    };
+
+    const tags = generateMetaTags(meta);
+
+    expect(tags).toContain(`<meta name="twitter:description" content="Plain Description" />`);
+  });
+
+  test("should emit twitter:site and twitter:creator with @-normalized handle", () => {
+    const meta = { title: "Page" };
+
+    const tags = generateMetaTags(meta, '', 'en', undefined, {
+      social: { twitterHandle: 'meno' },
+    });
+
+    expect(tags).toContain(`<meta name="twitter:site" content="@meno" />`);
+    expect(tags).toContain(`<meta name="twitter:creator" content="@meno" />`);
+  });
+
+  test("should not double-prefix handle that already starts with @", () => {
+    const meta = { title: "Page" };
+
+    const tags = generateMetaTags(meta, '', 'en', undefined, {
+      social: { twitterHandle: '@meno' },
+    });
+
+    expect(tags).toContain(`<meta name="twitter:site" content="@meno" />`);
+    expect(tags).not.toContain(`@@meno`);
+  });
+
+  test("should emit no twitter tags when meta is empty", () => {
+    const tags = generateMetaTags({});
+
+    expect(tags).not.toContain('twitter:');
+  });
+
+  test("should escape HTML in twitter content", () => {
+    const meta = {
+      ogTitle: "Title & <stuff>",
+    };
+
+    const tags = generateMetaTags(meta);
+
+    expect(tags).toContain(`<meta name="twitter:title" content="Title &amp; &lt;stuff&gt;" />`);
+  });
+
   test("should generate canonical URL", () => {
     const meta = {};
     const url = "https://example.com/page";

package/lib/server/webflow/buildWebflow.ts

@@ -456,7 +456,7 @@ export async function buildWebflowPayload(
           // the slug, so a template like `templates/blog.json` lands at
           // `/blog/<first-slug>` and doesn't collide with a sibling listing
           // page like `pages/blog.json`.
-          let itemSlug = item[cmsSchema.slugField] ?? item._slug ?? item._id;
+          let itemSlug = item[cmsSchema.slugField] ?? item._slug ?? item._filename ?? item._id;
           if (isI18nValue(itemSlug)) {
             itemSlug = resolveI18nValue(itemSlug, locale, i18nConfig) as string;
           }

package/lib/server/websocketManager.test.ts

@@ -1,9 +1,64 @@
-import { describe, test, expect } from 'bun:test';
+import { describe, test, expect, beforeEach } from 'bun:test';
+import { WebSocketManager } from './websocketManager';
+import { WEBSOCKET_STATES } from '../shared/constants';
+import type { RuntimeWSClient } from './runtime';
 
-describe('websocketManager', () => {
-  test('placeholder test for coverage', () => {
-    // WebSocket tests are complex and require server setup
-    // This placeholder ensures the file appears in coverage reports
-    expect(true).toBe(true);
+function makeMockClient(readyState: number = WEBSOCKET_STATES.OPEN): RuntimeWSClient & { sent: string[] } {
+  const sent: string[] = [];
+  return {
+    readyState,
+    send(data) {
+      sent.push(typeof data === 'string' ? data : '<binary>');
+    },
+    close() {},
+    sent,
+  } as RuntimeWSClient & { sent: string[] };
+}
+
+describe('WebSocketManager', () => {
+  let manager: WebSocketManager;
+  let client: ReturnType<typeof makeMockClient>;
+
+  beforeEach(() => {
+    manager = new WebSocketManager();
+    client = makeMockClient();
+    manager.addClient(client);
+  });
+
+  describe('broadcastCollectionsUpdate', () => {
+    test('sends hmr:cms-collections-update to OPEN clients', () => {
+      manager.broadcastCollectionsUpdate();
+      expect(client.sent).toEqual([JSON.stringify({ type: 'hmr:cms-collections-update' })]);
+    });
+
+    test('skips clients that are not OPEN', () => {
+      const closing = makeMockClient(WEBSOCKET_STATES.CLOSING);
+      manager.addClient(closing);
+      manager.broadcastCollectionsUpdate();
+      expect(client.sent.length).toBe(1);
+      expect(closing.sent.length).toBe(0);
+    });
+  });
+
+  describe('broadcastCMSUpdate', () => {
+    test('includes collection in payload', () => {
+      manager.broadcastCMSUpdate('blog');
+      expect(client.sent).toEqual([JSON.stringify({ type: 'hmr:cms-update', collection: 'blog' })]);
+    });
+  });
+
+  describe('broadcastConfigUpdate', () => {
+    test('sends hmr:config-update to OPEN clients', () => {
+      manager.broadcastConfigUpdate();
+      expect(client.sent).toEqual([JSON.stringify({ type: 'hmr:config-update' })]);
+    });
+  });
+
+  describe('client lifecycle', () => {
+    test('removed clients no longer receive broadcasts', () => {
+      manager.removeClient(client);
+      manager.broadcastCollectionsUpdate();
+      expect(client.sent.length).toBe(0);
+    });
   });
 });

package/lib/server/websocketManager.ts

@@ -103,7 +103,31 @@ export class WebSocketManager {
       collection
     });
   }
-  
+
+  /**
+   * Broadcast CMS collections-list update notification.
+   * Emitted when a template file is added, removed, or its schema changes —
+   * tells connected clients to re-fetch the collections list.
+   */
+  broadcastCollectionsUpdate(): void {
+    this.broadcast({
+      type: 'hmr:cms-collections-update'
+    });
+  }
+
+  /**
+   * Broadcast project.config.json update notification.
+   * Emitted when project.config.json changes (e.g. an AI tool adds a new
+   * locale) — tells connected clients to re-fetch config-derived state
+   * such as the i18n locale list.
+   */
+  broadcastConfigUpdate(): void {
+    this.broadcast({
+      type: 'hmr:config-update'
+    });
+  }
+
+
   /**
    * Get number of connected clients
    */

package/lib/shared/cssProperties.test.ts

@@ -128,6 +128,34 @@ describe('cssProperties', () => {
       const result = filterCSSProperties('fd');
       expect(result).toContain('flexDirection');
     });
+
+    test('promotes paddingLeft to top for "pl"', () => {
+      const result = filterCSSProperties('pl');
+      expect(result[0]).toBe('paddingLeft');
+    });
+
+    test('promotes paddingRight to top for "pr"', () => {
+      const result = filterCSSProperties('pr');
+      expect(result[0]).toBe('paddingRight');
+    });
+
+    test('promotes paddingTop to top for "pt" and "pu"', () => {
+      expect(filterCSSProperties('pt')[0]).toBe('paddingTop');
+      expect(filterCSSProperties('pu')[0]).toBe('paddingTop');
+    });
+
+    test('promotes paddingBottom to top for "pb"', () => {
+      const result = filterCSSProperties('pb');
+      expect(result[0]).toBe('paddingBottom');
+    });
+
+    test('promotes marginLeft/Right/Top/Bottom for "ml"/"mr"/"mt"/"mu"/"mb"', () => {
+      expect(filterCSSProperties('ml')[0]).toBe('marginLeft');
+      expect(filterCSSProperties('mr')[0]).toBe('marginRight');
+      expect(filterCSSProperties('mt')[0]).toBe('marginTop');
+      expect(filterCSSProperties('mu')[0]).toBe('marginTop');
+      expect(filterCSSProperties('mb')[0]).toBe('marginBottom');
+    });
   });
 
   describe('getPropertyValues', () => {

package/lib/shared/cssProperties.ts

@@ -650,6 +650,25 @@ function matchesAbbreviation(property: string, input: string): boolean {
   return true;
 }
 
+/**
+ * Direction-abbreviation shortcuts. When the user types one of these exact
+ * inputs, the mapped property is forced to the top of the suggestions list
+ * (ahead of startsWith matches like `placeContent` for "pl"). "u" stands for
+ * "up" — a natural mnemonic for `Top`.
+ */
+const PROPERTY_SHORTCUTS: Record<string, string> = {
+  pl: 'paddingLeft',
+  pr: 'paddingRight',
+  pt: 'paddingTop',
+  pu: 'paddingTop',
+  pb: 'paddingBottom',
+  ml: 'marginLeft',
+  mr: 'marginRight',
+  mt: 'marginTop',
+  mu: 'marginTop',
+  mb: 'marginBottom',
+};
+
 /**
  * Filter CSS properties based on input value
  * Supports both startsWith matching and camelCase abbreviation matching
@@ -675,10 +694,17 @@ export function filterCSSProperties(input: string): string[] {
   const byPriority = (a: string, b: string) =>
     getPropertyPriority(a) - getPropertyPriority(b);
 
-  return [
+  const combined = [
     ...startsWithMatches.sort(byPriority),
     ...abbreviationMatches.sort(byPriority),
   ];
+
+  const shortcut = PROPERTY_SHORTCUTS[normalizedInput.toLowerCase()];
+  if (shortcut) {
+    return [shortcut, ...combined.filter(prop => prop !== shortcut)];
+  }
+
+  return combined;
 }
 
 /**

package/lib/shared/types/api.ts

@@ -7,7 +7,16 @@ import type { CMSFieldDefinition } from './cms';
 import type { PageLibrariesConfig } from './libraries';
 
 export interface HMRMessage {
-  type: 'hmr:update' | 'hmr:colors-update' | 'hmr:variables-update' | 'hmr:enums-update' | 'hmr:fonts-update' | 'hmr:libraries-update' | 'hmr:cms-update';
+  type:
+    | 'hmr:update'
+    | 'hmr:colors-update'
+    | 'hmr:variables-update'
+    | 'hmr:enums-update'
+    | 'hmr:fonts-update'
+    | 'hmr:libraries-update'
+    | 'hmr:cms-update'
+    | 'hmr:cms-collections-update'
+    | 'hmr:config-update';
   path?: string;
   collection?: string;  // For CMS updates
 }

package/lib/shared/types/cms.ts

@@ -73,24 +73,33 @@ export interface CMSSchema {
 }
 
 /**
- * CMS Item - actual content entry (stored as individual JSON file)
+ * CMS Item - actual content entry (stored as individual JSON file).
  *
- * Note on _filename vs _slug:
- * - _filename: Stable identifier used for file storage and API operations. Never changes after creation.
- * - _slug: Derived from filename for backward compatibility. Use _filename instead in new code.
+ * Identity model:
+ * - `_id` is the canonical identifier. For new items written by the editor, it
+ *   equals the on-disk filename's stem (slug-shaped, human-readable). For
+ *   legacy items it may be a custom value (e.g. `"post-001"`) that differs
+ *   from the filename — those continue to work; reference resolution accepts
+ *   either `_id` or the on-disk filename as a key.
+ * - `_filename` is a legacy alias kept for back-compat. The provider's
+ *   `normalizeItem` always sets it on read to the on-disk filename's stem, so
+ *   internal file-routing code can rely on it. New items do not need to
+ *   persist `_filename` to disk — write only `_id`.
+ * - `_slug` is the oldest identifier alias, fully deprecated. Use `_id`.
  */
 export interface CMSItem {
-  /** Unique identifier for the item */
+  /** Canonical identifier. For new items, equals the on-disk filename's stem. */
   _id: string;
   /**
-   * @deprecated Use _filename instead. Kept for backward compatibility.
+   * @deprecated Use _id. Kept for backward compatibility.
    * Derived from the filename on disk.
    */
   _slug?: string;
   /**
-   * Stable filename identifier (without .json extension).
-   * Used for file storage and API operations. Never changes after creation,
-   * even if the slug field value changes.
+   * @deprecated Legacy alias for _id. Always equals the on-disk filename's
+   * stem; populated automatically by the file-system provider on read.
+   * Internal file-routing code reads this for legacy items where the on-disk
+   * filename differs from `_id`. New items do not need to write this to disk.
    */
   _filename?: string;
   /** ISO timestamp when item was created */

package/lib/shared/validation/schemas.test.ts

@@ -28,6 +28,99 @@ describe('Schema Validation', () => {
       }
     });
 
+    test('prop default accepts an _i18n value object', () => {
+      // Regression: the SSR pipeline resolves `_i18n` objects in prop defaults
+      // (see resolveI18nInProps) and CLAUDE.md tells AI to write them. The
+      // schema must accept this shape — otherwise the editor's component-load
+      // route rejects the file with a misleading JSONPage error.
+      const propDef = {
+        type: 'string',
+        default: { _i18n: true, en: 'Hello', pl: 'Cześć' },
+      };
+
+      const result = PropDefinitionSchema.safeParse(propDef);
+      expect(result.success).toBe(true);
+    });
+
+    test('list prop default accepts _i18n value objects on item fields', () => {
+      const propDef = {
+        type: 'list',
+        itemSchema: { title: { type: 'string' } },
+        default: [
+          { title: { _i18n: true, en: 'Hello', pl: 'Cześć' } },
+        ],
+      };
+
+      const result = PropDefinitionSchema.safeParse(propDef);
+      expect(result.success).toBe(true);
+    });
+
+    test('HTML node accepts an _i18n object as direct children', () => {
+      // Regression: previously the validator rejected `{type: "node", tag:
+      // "h1", children: {_i18n: true, en: "Blog", pl: "Blog"}}` with a
+      // misleading JSONPage error. After widening ComponentNodeSchema this
+      // shape validates and the runtime resolves it to a locale-string.
+      const page = {
+        root: {
+          type: 'node',
+          tag: 'h1',
+          children: { _i18n: true, en: 'Blog', pl: 'Blog' },
+        },
+      };
+      const result = PageDataSchema.safeParse(page);
+      expect(result.success).toBe(true);
+    });
+
+    test('HTML node accepts an _i18n object inside attribute values', () => {
+      const page = {
+        root: {
+          type: 'node',
+          tag: 'img',
+          attributes: {
+            src: '/x.png',
+            alt: { _i18n: true, en: 'Photo', pl: 'Zdjęcie' },
+          },
+        },
+      };
+      const result = PageDataSchema.safeParse(page);
+      expect(result.success).toBe(true);
+    });
+
+    test('HTML node accepts an _i18n object inside a children array', () => {
+      const page = {
+        root: {
+          type: 'node',
+          tag: 'p',
+          children: [
+            { _i18n: true, en: 'Hello', pl: 'Cześć' },
+            ' literal ',
+            { type: 'node', tag: 'span', children: 'static' },
+          ],
+        },
+      };
+      const result = PageDataSchema.safeParse(page);
+      expect(result.success).toBe(true);
+    });
+
+    test('component file with localized prop defaults validates as PageData', () => {
+      // End-to-end regression: a real component shape written by AI with
+      // localized defaults must pass PageDataSchema so the editor can open it.
+      const componentFile = {
+        component: {
+          interface: {
+            title: {
+              type: 'string',
+              default: { _i18n: true, en: 'From the blog', pl: 'Z bloga' },
+            },
+          },
+          structure: { type: 'node', tag: 'section', children: [] },
+        },
+      };
+
+      const result = PageDataSchema.safeParse(componentFile);
+      expect(result.success).toBe(true);
+    });
+
     test('valid select prop definition', () => {
       const propDef = {
         type: 'select',

package/lib/shared/validation/schemas.ts

@@ -23,11 +23,39 @@ export const BasePropTypeSchema = z.enum(['string', 'select', 'boolean', 'number
 export const PropTypeSchema = z.enum(['string', 'select', 'boolean', 'number', 'link', 'file', 'rich-text', 'embed', 'list']);
 
 /**
- * Base prop definition schema (for non-list props)
+ * `_i18n` value object schema. Used wherever a localizable string can appear:
+ *   - Prop defaults (`BasePropDefinitionSchema.default`)
+ *   - Node `children` (text content on `type: "node"`, `"link"`, `"component"`,
+ *     and basic list nodes)
+ *   - Attribute values (`attributes` records on every node type)
+ *
+ * The runtime resolves these objects to the active locale's string at the
+ * earliest dispatch point in both the SSR renderer (`renderNode`) and the
+ * client builder (`ComponentBuilder.buildComponent`). The schema accepts the
+ * shape so the editor's load path doesn't reject files that contain it.
+ */
+export const I18nValueObjectSchema = z.object({
+  _i18n: z.literal(true),
+}).passthrough();
+
+/**
+ * Base prop definition schema (for non-list props).
+ * `default` accepts a literal value (string/number/boolean/link) OR an
+ * `_i18n` value object — the SSR pipeline resolves the latter to the active
+ * locale's string via `resolveI18nInProps` at render time, so localized prop
+ * defaults are first-class. The `I18nOrStringSchema` proper is defined later
+ * in this file; we inline the matching shape here to keep the validator
+ * tolerant of localized defaults.
  */
 export const BasePropDefinitionSchema = z.object({
   type: BasePropTypeSchema,
-  default: z.union([z.string(), z.number(), z.boolean(), z.object({ href: z.string(), target: z.string().optional() })]).optional(),
+  default: z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.object({ href: z.string(), target: z.string().optional() }),
+    I18nValueObjectSchema,
+  ]).optional(),
   options: z.array(z.string()).readonly().optional(),
   enumName: z.string().optional(), // For 'select' type: reference to project-level enum
   accept: z.string().optional(), // For 'file' type: MIME pattern like "image/*", "video/*"
@@ -51,7 +79,16 @@ export const ListItemSchemaSchema = z.record(z.string(), BasePropDefinitionSchem
 export const ListPropDefinitionSchema = z.object({
   type: z.literal('list'),
   itemSchema: ListItemSchemaSchema,
-  default: z.array(z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.object({ href: z.string(), target: z.string().optional() }), z.null()]))).optional(),
+  // List-item field values can be any primitive, a link object, an `_i18n`
+  // object (resolved by the SSR pipeline), or null.
+  default: z.array(z.record(z.string(), z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.object({ href: z.string(), target: z.string().optional() }),
+    I18nValueObjectSchema,
+    z.null(),
+  ]))).optional(),
 }).passthrough();
 
 /**
@@ -175,8 +212,9 @@ export const InteractiveStylesSchema = z.array(InteractiveStyleRuleSchema);
 export const SlotMarkerSchema: z.ZodType<any> = z.lazy(() => z.object({
   type: z.literal(NODE_TYPE.SLOT),
   default: z.union([
-    z.array(z.union([ComponentNodeSchema, z.string()])),
+    z.array(z.union([ComponentNodeSchema, z.string(), I18nValueObjectSchema])),
     z.string(),
+    I18nValueObjectSchema,
   ]).optional(),
 }).passthrough());
 
@@ -197,11 +235,12 @@ export const HtmlNodeSchema: z.ZodType<any> = z.lazy(() => z.object({
   style: StyleValueSchema.optional(),
   interactiveStyles: InteractiveStylesSchema.optional(),
   generateElementClass: z.boolean().optional(),
-  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), I18nValueObjectSchema])).optional(),
   props: z.record(z.string(), z.any()).optional(), // Allow props for backward compatibility
   children: z.union([
-    z.array(z.union([ComponentNodeSchema, z.string()])),
+    z.array(z.union([ComponentNodeSchema, z.string(), I18nValueObjectSchema])),
     z.string(),
+    I18nValueObjectSchema,
   ]).optional(),
 }).passthrough());
 
@@ -217,10 +256,11 @@ export const ComponentInstanceNodeSchema: z.ZodType<any> = z.lazy(() => z.object
   style: StyleValueSchema.optional(),
   interactiveStyles: InteractiveStylesSchema.optional(),
   generateElementClass: z.boolean().optional(),
-  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), I18nValueObjectSchema])).optional(),
   children: z.union([
-    z.array(z.union([ComponentNodeSchema, z.string()])),
+    z.array(z.union([ComponentNodeSchema, z.string(), I18nValueObjectSchema])),
     z.string(),
+    I18nValueObjectSchema,
   ]).optional(),
 }).passthrough());
 
@@ -229,13 +269,13 @@ export const ComponentInstanceNodeSchema: z.ZodType<any> = z.lazy(() => z.object
  */
 export const EmbedNodeSchema: z.ZodType<any> = z.lazy(() => z.object({
   type: z.literal(NODE_TYPE.EMBED),
-  html: z.union([z.string(), HtmlMappingSchema]),
+  html: z.union([z.string(), HtmlMappingSchema, I18nValueObjectSchema]),
   label: z.string().optional(),
   if: IfConditionSchema.optional(),
   style: StyleValueSchema.optional(),
   interactiveStyles: InteractiveStylesSchema.optional(),
   generateElementClass: z.boolean().optional(),
-  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), I18nValueObjectSchema])).optional(),
 }).passthrough());
 
 /**
@@ -243,16 +283,17 @@ export const EmbedNodeSchema: z.ZodType<any> = z.lazy(() => z.object({
  */
 export const LinkNodeSchema: z.ZodType<any> = z.lazy(() => z.object({
   type: z.literal(NODE_TYPE.LINK),
-  href: z.union([z.string(), LinkMappingSchema]),
+  href: z.union([z.string(), LinkMappingSchema, I18nValueObjectSchema]),
   label: z.string().optional(),
   if: IfConditionSchema.optional(),
   style: StyleValueSchema.optional(),
   interactiveStyles: InteractiveStylesSchema.optional(),
   generateElementClass: z.boolean().optional(),
-  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), I18nValueObjectSchema])).optional(),
   children: z.union([
-    z.array(z.union([ComponentNodeSchema, z.string()])),
+    z.array(z.union([ComponentNodeSchema, z.string(), I18nValueObjectSchema])),
     z.string(),
+    I18nValueObjectSchema,
   ]).optional(),
 }).passthrough());
 
@@ -273,7 +314,7 @@ export const LocaleListNodeSchema: z.ZodType<any> = z.lazy(() => z.object({
   showSeparator: z.boolean().optional(),
   showFlag: z.boolean().optional(),
   flagStyle: StyleValueSchema.optional(),
-  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional(),
+  attributes: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), I18nValueObjectSchema])).optional(),
 }).passthrough());
 
 /**
@@ -298,7 +339,7 @@ export const ListNodeSchemaBasic: z.ZodType<any> = z.lazy(() => z.object({
   offset: z.number().optional(),
   excludeCurrentItem: z.boolean().optional(),
   emitTemplate: z.boolean().optional(),
-  children: z.array(z.union([ComponentNodeSchema, z.string()])).optional(),
+  children: z.array(z.union([ComponentNodeSchema, z.string(), I18nValueObjectSchema])).optional(),
 }).passthrough());
 
 /**

package/package.json

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

package/dist/chunks/chunk-4OFZP5NQ.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../lib/server/ssr/buildErrorOverlay.ts"],
-  "sourcesContent": ["/**\n * Build Error Overlay Generator\n * Generates an HTML page showing build errors when the static server detects _errors.json\n */\n\nexport interface BuildError {\n  file: string;      // e.g., \"pages/posts.json\"\n  message: string;   // Error message\n  type: string;      // 'minify' | 'render' | 'parse' | 'cms'\n}\n\nexport interface BuildErrorsData {\n  errors: BuildError[];\n  timestamp: number;\n}\n\n/**\n * Escape HTML to prevent XSS in error messages\n */\nfunction escapeHtml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#039;');\n}\n\n/**\n * Safely encode data for embedding in a script tag\n */\nfunction safeJsonForScript(data: unknown): string {\n  return JSON.stringify(data)\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026');\n}\n\n/**\n * Generate HTML page showing build errors\n */\nexport function generateBuildErrorPage(data: BuildErrorsData): string {\n  const { errors, timestamp } = data;\n  const timeStr = new Date(timestamp).toLocaleTimeString();\n\n  // Generate plain text for copying to AI\n  const plainTextErrors = errors.map(err =>\n    `[${err.type.toUpperCase()}] ${err.file}\\n${err.message}`\n  ).join('\\n\\n');\n  const copyText = `Build failed with ${errors.length} error(s):\\n\\n${plainTextErrors}`;\n\n  const errorListHtml = errors.map((err) => `\n    <div class=\"error-item\">\n      <div class=\"error-item-header\">\n        <div class=\"error-type\">${escapeHtml(err.type)}</div>\n        <div class=\"error-file\">${escapeHtml(err.file)}</div>\n      </div>\n      <div class=\"error-message\">${escapeHtml(err.message)}</div>\n    </div>\n  `).join('');\n\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Build Failed</title>\n  <style>\n    * { margin: 0; padding: 0; box-sizing: border-box; }\n\n    body {\n      font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n      background: linear-gradient(135deg, #0f0f1a 0%, #1a1a2e 100%);\n      color: #e2e8f0;\n      min-height: 100vh;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      padding: 24px;\n    }\n\n    .container {\n      max-width: 720px;\n      width: 100%;\n    }\n\n    .card {\n      background: rgba(30, 30, 50, 0.8);\n      backdrop-filter: blur(20px);\n      border: 1px solid rgba(255, 255, 255, 0.08);\n      border-radius: 16px;\n      overflow: hidden;\n      box-shadow:\n        0 4px 6px rgba(0, 0, 0, 0.1),\n        0 20px 50px rgba(0, 0, 0, 0.3),\n        inset 0 1px 0 rgba(255, 255, 255, 0.05);\n    }\n\n    .header {\n      background: linear-gradient(135deg, #dc2626 0%, #b91c1c 100%);\n      padding: 20px 24px;\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n    }\n\n    .header-left {\n      display: flex;\n      align-items: center;\n      gap: 12px;\n    }\n\n    .header-icon {\n      width: 32px;\n      height: 32px;\n      background: rgba(255, 255, 255, 0.2);\n      border-radius: 8px;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n    }\n\n    .header-icon svg {\n      width: 18px;\n      height: 18px;\n      stroke: white;\n    }\n\n    .header-title {\n      font-size: 16px;\n      font-weight: 600;\n      letter-spacing: -0.01em;\n    }\n\n    .error-count {\n      background: rgba(0, 0, 0, 0.25);\n      padding: 6px 14px;\n      border-radius: 100px;\n      font-size: 13px;\n      font-weight: 500;\n    }\n\n    .body {\n      padding: 20px;\n      max-height: 50vh;\n      overflow-y: auto;\n    }\n\n    .body::-webkit-scrollbar {\n      width: 6px;\n    }\n\n    .body::-webkit-scrollbar-track {\n      background: transparent;\n    }\n\n    .body::-webkit-scrollbar-thumb {\n      background: rgba(255, 255, 255, 0.1);\n      border-radius: 3px;\n    }\n\n    .error-item {\n      background: rgba(0, 0, 0, 0.3);\n      border: 1px solid rgba(255, 255, 255, 0.06);\n      border-radius: 10px;\n      padding: 14px 16px;\n      margin-bottom: 10px;\n      transition: border-color 0.15s;\n    }\n\n    .error-item:last-child { margin-bottom: 0; }\n\n    .error-item:hover {\n      border-color: rgba(255, 255, 255, 0.12);\n    }\n\n    .error-item-header {\n      display: flex;\n      align-items: center;\n      gap: 10px;\n      margin-bottom: 10px;\n    }\n\n    .error-type {\n      font-size: 10px;\n      font-weight: 600;\n      text-transform: uppercase;\n      letter-spacing: 0.5px;\n      padding: 4px 8px;\n      border-radius: 4px;\n      background: rgba(239, 68, 68, 0.2);\n      color: #fca5a5;\n    }\n\n    .error-file {\n      font-family: 'SF Mono', 'Fira Code', Menlo, Monaco, monospace;\n      font-size: 12px;\n      color: #94a3b8;\n    }\n\n    .error-message {\n      font-family: 'SF Mono', 'Fira Code', Menlo, Monaco, monospace;\n      font-size: 12px;\n      line-height: 1.7;\n      color: #f87171;\n      white-space: pre-wrap;\n      word-break: break-word;\n      background: rgba(0, 0, 0, 0.2);\n      padding: 10px 12px;\n      border-radius: 6px;\n      border-left: 2px solid #dc2626;\n    }\n\n    .footer {\n      padding: 16px 20px;\n      background: rgba(0, 0, 0, 0.2);\n      border-top: 1px solid rgba(255, 255, 255, 0.06);\n      display: flex;\n      justify-content: space-between;\n      align-items: center;\n      gap: 12px;\n      flex-wrap: wrap;\n    }\n\n    .footer-info {\n      font-size: 12px;\n      color: #64748b;\n    }\n\n    .footer-actions {\n      display: flex;\n      gap: 8px;\n    }\n\n    .btn {\n      border: none;\n      padding: 10px 16px;\n      border-radius: 8px;\n      font-size: 13px;\n      font-weight: 500;\n      cursor: pointer;\n      display: flex;\n      align-items: center;\n      gap: 6px;\n      transition: all 0.15s;\n    }\n\n    .btn svg {\n      width: 14px;\n      height: 14px;\n    }\n\n    .btn-secondary {\n      background: rgba(255, 255, 255, 0.08);\n      color: #e2e8f0;\n      border: 1px solid rgba(255, 255, 255, 0.1);\n    }\n\n    .btn-secondary:hover {\n      background: rgba(255, 255, 255, 0.12);\n      border-color: rgba(255, 255, 255, 0.15);\n    }\n\n    .btn-primary {\n      background: linear-gradient(135deg, #3b82f6 0%, #2563eb 100%);\n      color: white;\n    }\n\n    .btn-primary:hover {\n      background: linear-gradient(135deg, #60a5fa 0%, #3b82f6 100%);\n    }\n\n    .btn-success {\n      background: linear-gradient(135deg, #10b981 0%, #059669 100%) !important;\n    }\n  </style>\n</head>\n<body>\n  <div class=\"container\">\n    <div class=\"card\">\n      <div class=\"header\">\n        <div class=\"header-left\">\n          <div class=\"header-icon\">\n            <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\">\n              <circle cx=\"12\" cy=\"12\" r=\"10\"></circle>\n              <line x1=\"12\" y1=\"8\" x2=\"12\" y2=\"12\"></line>\n              <line x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"></line>\n            </svg>\n          </div>\n          <span class=\"header-title\">Build Failed</span>\n        </div>\n        <span class=\"error-count\">${errors.length} error${errors.length === 1 ? '' : 's'}</span>\n      </div>\n      <div class=\"body\">\n        ${errorListHtml}\n      </div>\n      <div class=\"footer\">\n        <div class=\"footer-info\">Failed at ${timeStr}</div>\n        <div class=\"footer-actions\">\n          <button class=\"btn btn-secondary\" id=\"copyBtn\">\n            <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\">\n              <rect x=\"9\" y=\"9\" width=\"13\" height=\"13\" rx=\"2\" ry=\"2\"></rect>\n              <path d=\"M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1\"></path>\n            </svg>\n            <span>Copy</span>\n          </button>\n          <button class=\"btn btn-primary\" onclick=\"location.reload()\">\n            <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\">\n              <polyline points=\"23 4 23 10 17 10\"></polyline>\n              <path d=\"M20.49 15a9 9 0 1 1-2.12-9.36L23 10\"></path>\n            </svg>\n            Refresh\n          </button>\n        </div>\n      </div>\n    </div>\n  </div>\n  <script>\n    (function() {\n      var copyBtn = document.getElementById('copyBtn');\n      var copyText = ${safeJsonForScript(copyText)};\n\n      copyBtn.addEventListener('click', function() {\n        navigator.clipboard.writeText(copyText).then(function() {\n          var span = copyBtn.querySelector('span');\n          var original = span.textContent;\n          span.textContent = 'Copied!';\n          copyBtn.classList.add('btn-success');\n          setTimeout(function() {\n            span.textContent = original;\n            copyBtn.classList.remove('btn-success');\n          }, 2000);\n        }).catch(function(err) {\n          console.error('Failed to copy:', err);\n        });\n      });\n    })();\n  </script>\n</body>\n</html>`;\n}\n"],
-  "mappings": "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",
-  "names": []
-}