@uniweb/runtime 0.2.13 → 0.2.15

package/dist/ssr.js

@@ -0,0 +1,274 @@
+import React from "react";
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+function guaranteeItemStructure(item) {
+  return {
+    title: item.title || "",
+    pretitle: item.pretitle || "",
+    subtitle: item.subtitle || "",
+    paragraphs: item.paragraphs || [],
+    links: item.links || [],
+    imgs: item.imgs || [],
+    lists: item.lists || [],
+    icons: item.icons || [],
+    videos: item.videos || [],
+    buttons: item.buttons || [],
+    data: item.data || {},
+    cards: item.cards || [],
+    documents: item.documents || [],
+    forms: item.forms || [],
+    quotes: item.quotes || [],
+    headings: item.headings || []
+  };
+}
+function guaranteeContentStructure(parsedContent) {
+  const content = parsedContent || {};
+  return {
+    // Flat header fields
+    title: content.title || "",
+    pretitle: content.pretitle || "",
+    subtitle: content.subtitle || "",
+    subtitle2: content.subtitle2 || "",
+    alignment: content.alignment || null,
+    // Flat body fields
+    paragraphs: content.paragraphs || [],
+    links: content.links || [],
+    imgs: content.imgs || [],
+    lists: content.lists || [],
+    icons: content.icons || [],
+    videos: content.videos || [],
+    buttons: content.buttons || [],
+    data: content.data || {},
+    cards: content.cards || [],
+    documents: content.documents || [],
+    forms: content.forms || [],
+    quotes: content.quotes || [],
+    headings: content.headings || [],
+    // Items with guaranteed structure
+    items: (content.items || []).map(guaranteeItemStructure),
+    // Sequence for ordered rendering
+    sequence: content.sequence || [],
+    // Preserve raw content if present
+    raw: content.raw
+  };
+}
+function applySchemaToObject(obj, schema) {
+  if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+    return obj;
+  }
+  const result = { ...obj };
+  for (const [field, fieldDef] of Object.entries(schema)) {
+    const defaultValue = typeof fieldDef === "object" ? fieldDef.default : void 0;
+    if (result[field] === void 0 && defaultValue !== void 0) {
+      result[field] = defaultValue;
+    }
+    if (typeof fieldDef === "object" && fieldDef.options && Array.isArray(fieldDef.options)) {
+      if (result[field] !== void 0 && !fieldDef.options.includes(result[field])) {
+        if (defaultValue !== void 0) {
+          result[field] = defaultValue;
+        }
+      }
+    }
+    if (typeof fieldDef === "object" && fieldDef.type === "object" && fieldDef.schema && result[field]) {
+      result[field] = applySchemaToObject(result[field], fieldDef.schema);
+    }
+    if (typeof fieldDef === "object" && fieldDef.type === "array" && fieldDef.of && result[field]) {
+      if (typeof fieldDef.of === "object") {
+        result[field] = result[field].map((item) => applySchemaToObject(item, fieldDef.of));
+      }
+    }
+  }
+  return result;
+}
+function applySchemaToValue(value, schema) {
+  if (Array.isArray(value)) {
+    return value.map((item) => applySchemaToObject(item, schema));
+  }
+  return applySchemaToObject(value, schema);
+}
+function applySchemas(data, schemas) {
+  if (!schemas || !data || typeof data !== "object") {
+    return data || {};
+  }
+  const result = { ...data };
+  for (const [tag, rawValue] of Object.entries(data)) {
+    const schema = schemas[tag];
+    if (!schema) continue;
+    result[tag] = applySchemaToValue(rawValue, schema);
+  }
+  return result;
+}
+function applyDefaults(params, defaults) {
+  if (!defaults || Object.keys(defaults).length === 0) {
+    return params || {};
+  }
+  return {
+    ...defaults,
+    ...params || {}
+  };
+}
+function prepareProps(block, meta) {
+  const defaults = meta?.defaults || {};
+  const params = applyDefaults(block.properties, defaults);
+  const content = guaranteeContentStructure(block.parsedContent);
+  const schemas = meta?.schemas || null;
+  if (schemas && content.data) {
+    content.data = applySchemas(content.data, schemas);
+  }
+  return { content, params };
+}
+function getComponentMeta(componentName) {
+  return globalThis.uniweb?.getComponentMeta?.(componentName) || null;
+}
+function getComponentDefaults(componentName) {
+  return globalThis.uniweb?.getComponentDefaults?.(componentName) || {};
+}
+const hexToRgba = (hex, opacity) => {
+  const r = parseInt(hex.slice(1, 3), 16);
+  const g = parseInt(hex.slice(3, 5), 16);
+  const b = parseInt(hex.slice(5, 7), 16);
+  return `rgba(${r},${g},${b},${opacity})`;
+};
+const getWrapperProps = (block) => {
+  const theme = block.themeName;
+  const blockClassName = block.state?.className || "";
+  let className = theme || "";
+  if (blockClassName) {
+    className = className ? `${className} ${blockClassName}` : blockClassName;
+  }
+  const { background = {}, colors = {} } = block.standardOptions;
+  const style = {};
+  if (background.mode === "gradient") {
+    const {
+      enabled = false,
+      start = "transparent",
+      end = "transparent",
+      angle = 0,
+      startPosition = 0,
+      endPosition = 100,
+      startOpacity = 0.7,
+      endOpacity = 0.3
+    } = background.gradient || {};
+    if (enabled) {
+      style["--bg-color"] = `linear-gradient(${angle}deg,
+        ${hexToRgba(start, startOpacity)} ${startPosition}%,
+        ${hexToRgba(end, endOpacity)} ${endPosition}%)`;
+    }
+  } else if (background.mode === "image" || background.mode === "video") {
+    const settings = background[background.mode] || {};
+    const { url = "", file = "" } = settings;
+    if (url || file) {
+      style["--bg-color"] = "transparent";
+      style.position = "relative";
+      style.maxWidth = "100%";
+    }
+  }
+  return {
+    id: `Section${block.id}`,
+    style,
+    className
+  };
+};
+function BlockRenderer({ block, pure = false, extra = {} }) {
+  const Component = block.initComponent();
+  if (!Component) {
+    return /* @__PURE__ */ jsxs("div", { className: "block-error", style: { padding: "1rem", background: "#fef2f2", color: "#dc2626" }, children: [
+      "Component not found: ",
+      block.type
+    ] });
+  }
+  let content, params;
+  if (block.parsedContent?._isPoc) {
+    content = block.parsedContent._pocContent;
+    params = block.properties;
+  } else {
+    const meta = getComponentMeta(block.type);
+    const prepared = prepareProps(block, meta);
+    params = prepared.params;
+    content = {
+      ...prepared.content,
+      ...block.properties,
+      // Frontmatter params overlay (legacy support)
+      _prosemirror: block.parsedContent
+      // Keep original for components that need raw access
+    };
+  }
+  const componentProps = {
+    content,
+    params,
+    block,
+    input: block.input
+  };
+  if (pure) {
+    return /* @__PURE__ */ jsx(Component, { ...componentProps, extra });
+  }
+  const wrapperProps = getWrapperProps(block);
+  return /* @__PURE__ */ jsx("div", { ...wrapperProps, children: /* @__PURE__ */ jsx(Component, { ...componentProps }) });
+}
+function Blocks({ blocks, extra = {} }) {
+  if (!blocks || blocks.length === 0) return null;
+  return blocks.map((block, index) => /* @__PURE__ */ jsx(React.Fragment, { children: /* @__PURE__ */ jsx(BlockRenderer, { block, extra }) }, block.id || index));
+}
+function DefaultLayout({ header, body, footer }) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    header,
+    body,
+    footer
+  ] });
+}
+function Layout({ page, website }) {
+  const RemoteLayout = website.getRemoteLayout();
+  const headerBlocks = page.getHeaderBlocks();
+  const bodyBlocks = page.getBodyBlocks();
+  const footerBlocks = page.getFooterBlocks();
+  const leftBlocks = page.getLeftBlocks();
+  const rightBlocks = page.getRightBlocks();
+  const headerElement = headerBlocks ? /* @__PURE__ */ jsx(Blocks, { blocks: headerBlocks }) : null;
+  const bodyElement = bodyBlocks ? /* @__PURE__ */ jsx(Blocks, { blocks: bodyBlocks }) : null;
+  const footerElement = footerBlocks ? /* @__PURE__ */ jsx(Blocks, { blocks: footerBlocks }) : null;
+  const leftElement = leftBlocks ? /* @__PURE__ */ jsx(Blocks, { blocks: leftBlocks }) : null;
+  const rightElement = rightBlocks ? /* @__PURE__ */ jsx(Blocks, { blocks: rightBlocks }) : null;
+  if (RemoteLayout) {
+    return /* @__PURE__ */ jsx(
+      RemoteLayout,
+      {
+        page,
+        website,
+        header: headerElement,
+        body: bodyElement,
+        footer: footerElement,
+        left: leftElement,
+        right: rightElement,
+        leftPanel: leftElement,
+        rightPanel: rightElement
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    DefaultLayout,
+    {
+      header: headerElement,
+      body: bodyElement,
+      footer: footerElement
+    }
+  );
+}
+function PageElement({ page, website }) {
+  return React.createElement(
+    "main",
+    null,
+    React.createElement(Layout, { page, website })
+  );
+}
+export {
+  BlockRenderer,
+  Blocks,
+  Layout,
+  PageElement,
+  applyDefaults,
+  applySchemas,
+  getComponentDefaults,
+  getComponentMeta,
+  guaranteeContentStructure,
+  prepareProps
+};
+//# sourceMappingURL=ssr.js.map

package/dist/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","sources":["../src/prepare-props.js","../src/components/BlockRenderer.jsx","../src/components/Blocks.jsx","../src/components/Layout.jsx","../src/ssr.js"],"sourcesContent":["/**\n * Props Preparation for Runtime Guarantees\n *\n * Prepares props for foundation components with:\n * - Param defaults from runtime schema\n * - Guaranteed content structure (no null checks needed)\n *\n * This enables simpler component code by ensuring predictable prop shapes.\n */\n\n/**\n * Guarantee item has flat content structure\n *\n * @param {Object} item - Raw item from parser\n * @returns {Object} Item with guaranteed flat structure\n */\nfunction guaranteeItemStructure(item) {\n  return {\n    title: item.title || '',\n    pretitle: item.pretitle || '',\n    subtitle: item.subtitle || '',\n    paragraphs: item.paragraphs || [],\n    links: item.links || [],\n    imgs: item.imgs || [],\n    lists: item.lists || [],\n    icons: item.icons || [],\n    videos: item.videos || [],\n    buttons: item.buttons || [],\n    data: item.data || {},\n    cards: item.cards || [],\n    documents: item.documents || [],\n    forms: item.forms || [],\n    quotes: item.quotes || [],\n    headings: item.headings || [],\n  }\n}\n\n/**\n * Guarantee content structure exists\n * Returns a flat content object with all standard fields guaranteed to exist\n *\n * @param {Object} parsedContent - Raw parsed content from semantic parser (flat structure)\n * @returns {Object} Content with guaranteed flat structure\n */\nexport function guaranteeContentStructure(parsedContent) {\n  const content = parsedContent || {}\n\n  return {\n    // Flat header fields\n    title: content.title || '',\n    pretitle: content.pretitle || '',\n    subtitle: content.subtitle || '',\n    subtitle2: content.subtitle2 || '',\n    alignment: content.alignment || null,\n\n    // Flat body fields\n    paragraphs: content.paragraphs || [],\n    links: content.links || [],\n    imgs: content.imgs || [],\n    lists: content.lists || [],\n    icons: content.icons || [],\n    videos: content.videos || [],\n    buttons: content.buttons || [],\n    data: content.data || {},\n    cards: content.cards || [],\n    documents: content.documents || [],\n    forms: content.forms || [],\n    quotes: content.quotes || [],\n    headings: content.headings || [],\n\n    // Items with guaranteed structure\n    items: (content.items || []).map(guaranteeItemStructure),\n\n    // Sequence for ordered rendering\n    sequence: content.sequence || [],\n\n    // Preserve raw content if present\n    raw: content.raw,\n  }\n}\n\n/**\n * Apply a schema to a single object\n * Only processes fields defined in the schema, preserves unknown fields\n *\n * @param {Object} obj - The object to process\n * @param {Object} schema - Schema definition (fieldName -> fieldDef)\n * @returns {Object} Object with schema defaults applied\n */\nfunction applySchemaToObject(obj, schema) {\n  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {\n    return obj\n  }\n\n  const result = { ...obj }\n\n  for (const [field, fieldDef] of Object.entries(schema)) {\n    // Get the default value - handle both shorthand and full form\n    const defaultValue = typeof fieldDef === 'object' ? fieldDef.default : undefined\n\n    // Apply default if field is missing and default exists\n    if (result[field] === undefined && defaultValue !== undefined) {\n      result[field] = defaultValue\n    }\n\n    // For select fields with options, apply default if value is not among valid options\n    if (typeof fieldDef === 'object' && fieldDef.options && Array.isArray(fieldDef.options)) {\n      if (result[field] !== undefined && !fieldDef.options.includes(result[field])) {\n        // Value exists but is not valid - apply default if available\n        if (defaultValue !== undefined) {\n          result[field] = defaultValue\n        }\n      }\n    }\n\n    // Handle nested object schema\n    if (typeof fieldDef === 'object' && fieldDef.type === 'object' && fieldDef.schema && result[field]) {\n      result[field] = applySchemaToObject(result[field], fieldDef.schema)\n    }\n\n    // Handle array with inline schema\n    if (typeof fieldDef === 'object' && fieldDef.type === 'array' && fieldDef.of && result[field]) {\n      if (typeof fieldDef.of === 'object') {\n        result[field] = result[field].map(item => applySchemaToObject(item, fieldDef.of))\n      }\n    }\n  }\n\n  return result\n}\n\n/**\n * Apply a schema to a value (object or array of objects)\n *\n * @param {Object|Array} value - The value to process\n * @param {Object} schema - Schema definition\n * @returns {Object|Array} Value with schema defaults applied\n */\nfunction applySchemaToValue(value, schema) {\n  if (Array.isArray(value)) {\n    return value.map(item => applySchemaToObject(item, schema))\n  }\n  return applySchemaToObject(value, schema)\n}\n\n/**\n * Apply schemas to content.data\n * Only processes tags that have a matching schema, leaves others untouched\n *\n * @param {Object} data - The data object from content\n * @param {Object} schemas - Schema definitions from runtime meta\n * @returns {Object} Data with schemas applied\n */\nexport function applySchemas(data, schemas) {\n  if (!schemas || !data || typeof data !== 'object') {\n    return data || {}\n  }\n\n  const result = { ...data }\n\n  for (const [tag, rawValue] of Object.entries(data)) {\n    const schema = schemas[tag]\n    if (!schema) continue  // No schema for this tag - leave as-is\n\n    result[tag] = applySchemaToValue(rawValue, schema)\n  }\n\n  return result\n}\n\n/**\n * Apply param defaults from runtime schema\n *\n * @param {Object} params - Params from frontmatter\n * @param {Object} defaults - Default values from runtime schema\n * @returns {Object} Merged params with defaults applied\n */\nexport function applyDefaults(params, defaults) {\n  if (!defaults || Object.keys(defaults).length === 0) {\n    return params || {}\n  }\n\n  return {\n    ...defaults,\n    ...(params || {}),\n  }\n}\n\n/**\n * Prepare props for a component with runtime guarantees\n *\n * @param {Object} block - The block instance\n * @param {Object} meta - Runtime metadata for the component (from meta[componentName])\n * @returns {Object} Prepared props: { content, params }\n */\nexport function prepareProps(block, meta) {\n  // Apply param defaults\n  const defaults = meta?.defaults || {}\n  const params = applyDefaults(block.properties, defaults)\n\n  // Guarantee content structure\n  const content = guaranteeContentStructure(block.parsedContent)\n\n  // Apply schemas to content.data\n  const schemas = meta?.schemas || null\n  if (schemas && content.data) {\n    content.data = applySchemas(content.data, schemas)\n  }\n\n  return { content, params }\n}\n\n/**\n * Get runtime metadata for a component from the global uniweb instance\n *\n * @param {string} componentName\n * @returns {Object|null}\n */\nexport function getComponentMeta(componentName) {\n  return globalThis.uniweb?.getComponentMeta?.(componentName) || null\n}\n\n/**\n * Get default param values for a component\n *\n * @param {string} componentName\n * @returns {Object}\n */\nexport function getComponentDefaults(componentName) {\n  return globalThis.uniweb?.getComponentDefaults?.(componentName) || {}\n}\n","/**\n * BlockRenderer\n *\n * Bridges Block data to foundation components.\n * Handles theming, wrapper props, and runtime guarantees.\n */\n\nimport React from 'react'\nimport { prepareProps, getComponentMeta } from '../prepare-props.js'\n\n/**\n * Convert hex color to rgba\n */\nconst hexToRgba = (hex, opacity) => {\n  const r = parseInt(hex.slice(1, 3), 16)\n  const g = parseInt(hex.slice(3, 5), 16)\n  const b = parseInt(hex.slice(5, 7), 16)\n  return `rgba(${r},${g},${b},${opacity})`\n}\n\n/**\n * Build wrapper props from block configuration\n */\nconst getWrapperProps = (block) => {\n  const theme = block.themeName\n  const blockClassName = block.state?.className || ''\n\n  let className = theme || ''\n  if (blockClassName) {\n    className = className ? `${className} ${blockClassName}` : blockClassName\n  }\n\n  const { background = {}, colors = {} } = block.standardOptions\n  const style = {}\n\n  // Handle background modes\n  if (background.mode === 'gradient') {\n    const {\n      enabled = false,\n      start = 'transparent',\n      end = 'transparent',\n      angle = 0,\n      startPosition = 0,\n      endPosition = 100,\n      startOpacity = 0.7,\n      endOpacity = 0.3\n    } = background.gradient || {}\n\n    if (enabled) {\n      style['--bg-color'] = `linear-gradient(${angle}deg,\n        ${hexToRgba(start, startOpacity)} ${startPosition}%,\n        ${hexToRgba(end, endOpacity)} ${endPosition}%)`\n    }\n  } else if (background.mode === 'image' || background.mode === 'video') {\n    const settings = background[background.mode] || {}\n    const { url = '', file = '' } = settings\n\n    if (url || file) {\n      style['--bg-color'] = 'transparent'\n      style.position = 'relative'\n      style.maxWidth = '100%'\n    }\n  }\n\n  return {\n    id: `Section${block.id}`,\n    style,\n    className\n  }\n}\n\n/**\n * BlockRenderer component\n */\nexport default function BlockRenderer({ block, pure = false, extra = {} }) {\n  const Component = block.initComponent()\n\n  if (!Component) {\n    return (\n      <div className=\"block-error\" style={{ padding: '1rem', background: '#fef2f2', color: '#dc2626' }}>\n        Component not found: {block.type}\n      </div>\n    )\n  }\n\n  // Build content and params with runtime guarantees\n  // Sources:\n  // 1. parsedContent._isPoc - simple PoC format (hardcoded content)\n  // 2. parsedContent - semantic parser output (flat: title, paragraphs, links, etc.)\n  // 3. block.properties - params from frontmatter (theme, alignment, etc.)\n  // 4. meta - defaults from component meta.js\n  let content, params\n\n  if (block.parsedContent?._isPoc) {\n    // Simple PoC format - content was passed directly\n    content = block.parsedContent._pocContent\n    params = block.properties\n  } else {\n    // Get runtime metadata for this component (has defaults, data binding, etc.)\n    const meta = getComponentMeta(block.type)\n\n    // Prepare props with runtime guarantees:\n    // - Apply param defaults from meta.js\n    // - Guarantee content structure exists\n    const prepared = prepareProps(block, meta)\n    params = prepared.params\n\n    // Merge prepared content with raw access for components that need it\n    content = {\n      ...prepared.content,\n      ...block.properties,     // Frontmatter params overlay (legacy support)\n      _prosemirror: block.parsedContent  // Keep original for components that need raw access\n    }\n  }\n\n  const componentProps = {\n    content,\n    params,\n    block,\n    input: block.input\n  }\n\n  if (pure) {\n    return <Component {...componentProps} extra={extra} />\n  }\n\n  const wrapperProps = getWrapperProps(block)\n\n  return (\n    <div {...wrapperProps}>\n      <Component {...componentProps} />\n    </div>\n  )\n}\n","/**\n * Blocks\n *\n * Renders an array of blocks for a layout area (header, body, footer, panels).\n * Used by the Layout component to pre-render each area.\n */\n\nimport React from 'react'\nimport BlockRenderer from './BlockRenderer.jsx'\n\n/**\n * Render a list of blocks\n *\n * @param {Object} props\n * @param {Block[]} props.blocks - Array of Block instances to render\n * @param {Object} [props.extra] - Extra props to pass to each block\n */\nexport default function Blocks({ blocks, extra = {} }) {\n  if (!blocks || blocks.length === 0) return null\n\n  return blocks.map((block, index) => (\n    <React.Fragment key={block.id || index}>\n      <BlockRenderer block={block} extra={extra} />\n    </React.Fragment>\n  ))\n}\n","/**\n * Layout\n *\n * Orchestrates page rendering by assembling layout areas (header, body, footer, panels).\n * Supports foundation-provided custom Layout components via website.getRemoteLayout().\n *\n * Layout Areas:\n * - header: Top navigation, branding (from @header page)\n * - body: Main page content (from page sections)\n * - footer: Bottom navigation, copyright (from @footer page)\n * - left: Left sidebar/panel (from @left page)\n * - right: Right sidebar/panel (from @right page)\n *\n * Custom Layouts:\n * Foundations can provide a custom Layout via src/exports.js:\n *\n * ```jsx\n * // src/exports.js\n * import Layout from './components/Layout'\n *\n * export default {\n *   Layout,\n *   props: {\n *     themeToggleEnabled: true,\n *   }\n * }\n * ```\n *\n * The Layout component receives pre-rendered areas as props:\n * - page, website: Runtime context\n * - header, body, footer: Pre-rendered React elements\n * - left, right (or leftPanel, rightPanel): Sidebar panels\n */\n\nimport Blocks from './Blocks.jsx'\n\n/**\n * Default layout - renders header, body, footer in sequence\n * (no panels in default layout)\n */\nfunction DefaultLayout({ header, body, footer }) {\n  return (\n    <>\n      {header}\n      {body}\n      {footer}\n    </>\n  )\n}\n\n/**\n * Layout component\n *\n * @param {Object} props\n * @param {Page} props.page - Current page instance\n * @param {Website} props.website - Website instance\n */\nexport default function Layout({ page, website }) {\n  // Check if foundation provides a custom Layout\n  const RemoteLayout = website.getRemoteLayout()\n\n  // Get block groups from page (respects layout preferences)\n  const headerBlocks = page.getHeaderBlocks()\n  const bodyBlocks = page.getBodyBlocks()\n  const footerBlocks = page.getFooterBlocks()\n  const leftBlocks = page.getLeftBlocks()\n  const rightBlocks = page.getRightBlocks()\n\n  // Pre-render each area as React elements\n  const headerElement = headerBlocks ? <Blocks blocks={headerBlocks} /> : null\n  const bodyElement = bodyBlocks ? <Blocks blocks={bodyBlocks} /> : null\n  const footerElement = footerBlocks ? <Blocks blocks={footerBlocks} /> : null\n  const leftElement = leftBlocks ? <Blocks blocks={leftBlocks} /> : null\n  const rightElement = rightBlocks ? <Blocks blocks={rightBlocks} /> : null\n\n  // Use foundation's custom Layout if provided\n  if (RemoteLayout) {\n    return (\n      <RemoteLayout\n        page={page}\n        website={website}\n        header={headerElement}\n        body={bodyElement}\n        footer={footerElement}\n        left={leftElement}\n        right={rightElement}\n        // Aliases for backwards compatibility\n        leftPanel={leftElement}\n        rightPanel={rightElement}\n      />\n    )\n  }\n\n  // Default layout\n  return (\n    <DefaultLayout\n      header={headerElement}\n      body={bodyElement}\n      footer={footerElement}\n    />\n  )\n}\n","/**\n * @uniweb/runtime/ssr - Server-Side Rendering Entry Point\n *\n * Node.js-compatible exports for SSG/prerendering.\n * This module is built to a standalone bundle that can be imported\n * directly by Node.js without Vite transpilation.\n *\n * Usage in prerender.js:\n *   import { renderPage, Blocks, BlockRenderer } from '@uniweb/runtime/ssr'\n */\n\nimport React from 'react'\n\n// Props preparation (no browser APIs)\nexport {\n  prepareProps,\n  applySchemas,\n  applyDefaults,\n  guaranteeContentStructure,\n  getComponentMeta,\n  getComponentDefaults\n} from './prepare-props.js'\n\n// Components for rendering\nexport { default as BlockRenderer } from './components/BlockRenderer.jsx'\nexport { default as Blocks } from './components/Blocks.jsx'\nexport { default as Layout } from './components/Layout.jsx'\n\n// Re-export Layout's DefaultLayout for direct use\nimport LayoutComponent from './components/Layout.jsx'\n\n/**\n * Render a page to React elements\n *\n * This is the main entry point for SSG. It returns a React element\n * that can be passed to renderToString().\n *\n * @param {Object} props\n * @param {Page} props.page - The page instance to render\n * @param {Website} props.website - The website instance\n * @returns {React.ReactElement}\n */\nexport function PageElement({ page, website }) {\n  return React.createElement(\n    'main',\n    null,\n    React.createElement(LayoutComponent, { page, website })\n  )\n}\n"],"names":["LayoutComponent"],"mappings":"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"}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@uniweb/runtime",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Minimal runtime for loading Uniweb foundations",
   "type": "module",
   "exports": {
-    ".": "./src/index.jsx"
+    ".": "./src/index.jsx",
+    "./ssr": "./dist/ssr.js"
   },
   "files": [
-    "src"
+    "src",
+    "dist"
   ],
   "keywords": [
     "uniweb",
@@ -31,9 +33,16 @@
   "dependencies": {
     "@uniweb/core": "0.1.12"
   },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.5.2",
+    "vite": "^7.3.1"
+  },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "react-router-dom": "^6.0.0 || ^7.0.0"
+  },
+  "scripts": {
+    "build:ssr": "vite build --config vite.config.ssr.js"
   }
 }

package/src/prepare-props.js

@@ -26,7 +26,7 @@ function guaranteeItemStructure(item) {
     icons: item.icons || [],
     videos: item.videos || [],
     buttons: item.buttons || [],
-    properties: item.properties || {},
+    data: item.data || {},
     cards: item.cards || [],
     documents: item.documents || [],
     forms: item.forms || [],
@@ -61,8 +61,7 @@ export function guaranteeContentStructure(parsedContent) {
     icons: content.icons || [],
     videos: content.videos || [],
     buttons: content.buttons || [],
-    properties: content.properties || {},
-    propertyBlocks: content.propertyBlocks || [],
+    data: content.data || {},
     cards: content.cards || [],
     documents: content.documents || [],
     forms: content.forms || [],
@@ -80,6 +79,95 @@ export function guaranteeContentStructure(parsedContent) {
   }
 }
 
+/**
+ * Apply a schema to a single object
+ * Only processes fields defined in the schema, preserves unknown fields
+ *
+ * @param {Object} obj - The object to process
+ * @param {Object} schema - Schema definition (fieldName -> fieldDef)
+ * @returns {Object} Object with schema defaults applied
+ */
+function applySchemaToObject(obj, schema) {
+  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+    return obj
+  }
+
+  const result = { ...obj }
+
+  for (const [field, fieldDef] of Object.entries(schema)) {
+    // Get the default value - handle both shorthand and full form
+    const defaultValue = typeof fieldDef === 'object' ? fieldDef.default : undefined
+
+    // Apply default if field is missing and default exists
+    if (result[field] === undefined && defaultValue !== undefined) {
+      result[field] = defaultValue
+    }
+
+    // For select fields with options, apply default if value is not among valid options
+    if (typeof fieldDef === 'object' && fieldDef.options && Array.isArray(fieldDef.options)) {
+      if (result[field] !== undefined && !fieldDef.options.includes(result[field])) {
+        // Value exists but is not valid - apply default if available
+        if (defaultValue !== undefined) {
+          result[field] = defaultValue
+        }
+      }
+    }
+
+    // Handle nested object schema
+    if (typeof fieldDef === 'object' && fieldDef.type === 'object' && fieldDef.schema && result[field]) {
+      result[field] = applySchemaToObject(result[field], fieldDef.schema)
+    }
+
+    // Handle array with inline schema
+    if (typeof fieldDef === 'object' && fieldDef.type === 'array' && fieldDef.of && result[field]) {
+      if (typeof fieldDef.of === 'object') {
+        result[field] = result[field].map(item => applySchemaToObject(item, fieldDef.of))
+      }
+    }
+  }
+
+  return result
+}
+
+/**
+ * Apply a schema to a value (object or array of objects)
+ *
+ * @param {Object|Array} value - The value to process
+ * @param {Object} schema - Schema definition
+ * @returns {Object|Array} Value with schema defaults applied
+ */
+function applySchemaToValue(value, schema) {
+  if (Array.isArray(value)) {
+    return value.map(item => applySchemaToObject(item, schema))
+  }
+  return applySchemaToObject(value, schema)
+}
+
+/**
+ * Apply schemas to content.data
+ * Only processes tags that have a matching schema, leaves others untouched
+ *
+ * @param {Object} data - The data object from content
+ * @param {Object} schemas - Schema definitions from runtime meta
+ * @returns {Object} Data with schemas applied
+ */
+export function applySchemas(data, schemas) {
+  if (!schemas || !data || typeof data !== 'object') {
+    return data || {}
+  }
+
+  const result = { ...data }
+
+  for (const [tag, rawValue] of Object.entries(data)) {
+    const schema = schemas[tag]
+    if (!schema) continue  // No schema for this tag - leave as-is
+
+    result[tag] = applySchemaToValue(rawValue, schema)
+  }
+
+  return result
+}
+
 /**
  * Apply param defaults from runtime schema
  *
@@ -113,6 +201,12 @@ export function prepareProps(block, meta) {
   // Guarantee content structure
   const content = guaranteeContentStructure(block.parsedContent)
 
+  // Apply schemas to content.data
+  const schemas = meta?.schemas || null
+  if (schemas && content.data) {
+    content.data = applySchemas(content.data, schemas)
+  }
+
   return { content, params }
 }
 

package/src/ssr.js

@@ -0,0 +1,49 @@
+/**
+ * @uniweb/runtime/ssr - Server-Side Rendering Entry Point
+ *
+ * Node.js-compatible exports for SSG/prerendering.
+ * This module is built to a standalone bundle that can be imported
+ * directly by Node.js without Vite transpilation.
+ *
+ * Usage in prerender.js:
+ *   import { renderPage, Blocks, BlockRenderer } from '@uniweb/runtime/ssr'
+ */
+
+import React from 'react'
+
+// Props preparation (no browser APIs)
+export {
+  prepareProps,
+  applySchemas,
+  applyDefaults,
+  guaranteeContentStructure,
+  getComponentMeta,
+  getComponentDefaults
+} from './prepare-props.js'
+
+// Components for rendering
+export { default as BlockRenderer } from './components/BlockRenderer.jsx'
+export { default as Blocks } from './components/Blocks.jsx'
+export { default as Layout } from './components/Layout.jsx'
+
+// Re-export Layout's DefaultLayout for direct use
+import LayoutComponent from './components/Layout.jsx'
+
+/**
+ * Render a page to React elements
+ *
+ * This is the main entry point for SSG. It returns a React element
+ * that can be passed to renderToString().
+ *
+ * @param {Object} props
+ * @param {Page} props.page - The page instance to render
+ * @param {Website} props.website - The website instance
+ * @returns {React.ReactElement}
+ */
+export function PageElement({ page, website }) {
+  return React.createElement(
+    'main',
+    null,
+    React.createElement(LayoutComponent, { page, website })
+  )
+}