@cmssy/react 0.1.6 → 0.1.8

package/dist/client.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-BaFQ2k7r.cjs';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-e3O4s_bN.cjs';
 import 'react';
 
 interface EditBridgeConfig {

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-BaFQ2k7r.js';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-e3O4s_bN.js';
 import 'react';
 
 interface EditBridgeConfig {

package/dist/index.cjs

@@ -35,6 +35,13 @@ function buildBlockMap(blocks) {
   for (const block of blocks) map[block.type] = block.component;
   return map;
 }
+function buildLoaderMap(blocks) {
+  const map = /* @__PURE__ */ Object.create(null);
+  for (const block of blocks) {
+    if (block.loader) map[block.type] = block.loader;
+  }
+  return map;
+}
 function blocksToSchemas(blocks) {
   const out = /* @__PURE__ */ Object.create(null);
   for (const block of blocks) {
@@ -60,19 +67,6 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
-// src/components/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms
-  };
-}
-
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -96,6 +90,19 @@ function getBlockContentForLanguage(content, locale, defaultLocale = "en", avail
   const chosen = localeMap[locale] ?? localeMap[defaultLocale] ?? localeMap[fallbackKey];
   return { ...nonTranslatable, ...chosen };
 }
+
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms
+  };
+}
 var WARN_CAP = 256;
 var warned = /* @__PURE__ */ new Set();
 function UnknownBlock({ type }) {
@@ -106,12 +113,14 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+function renderResolvedBlock(block, map, locale, defaultLocale, options = {}) {
+  const { context, data, resolvedContent, enabledLocales } = options;
   const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
-  const content = getBlockContentForLanguage(
+  const content = resolvedContent ?? getBlockContentForLanguage(
     block.content,
     locale,
-    defaultLocale
+    defaultLocale,
+    enabledLocales?.length ? enabledLocales : void 0
   );
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
@@ -119,12 +128,12 @@ function renderResolvedBlock(block, map, locale, defaultLocale, context) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? react.createElement(Component, { content, context }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
+      children: Component ? react.createElement(Component, { content, context, data }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
 }
-function CmssyServerPage({
+async function CmssyServerPage({
   page,
   blocks,
   locale = "en",
@@ -134,6 +143,7 @@ function CmssyServerPage({
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const loaderMap = buildLoaderMap(blocks);
   const context = buildBlockContext(
     locale,
     defaultLocale,
@@ -141,8 +151,38 @@ function CmssyServerPage({
     false,
     forms
   );
+  const resolved = await Promise.all(
+    page.blocks.map(async (block) => {
+      const content = getBlockContentForLanguage(
+        block.content,
+        locale,
+        defaultLocale,
+        enabledLocales?.length ? enabledLocales : void 0
+      );
+      const loader = loaderMap[block.type];
+      let data;
+      if (loader) {
+        try {
+          data = await loader({ content, context });
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              `[cmssy] loader for block "${block.type}" (${block.id}) failed`,
+              err
+            );
+          }
+        }
+      }
+      return { content, data };
+    })
+  );
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block, i) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      data: resolved[i]?.data,
+      resolvedContent: resolved[i]?.content,
+      enabledLocales
+    })
   ) });
 }
 function CmssyServerLayout({
@@ -159,7 +199,10 @@ function CmssyServerLayout({
   const map = buildBlockMap(blocks);
   const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: layoutBlocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      enabledLocales
+    })
   ) });
 }
 
@@ -547,6 +590,46 @@ async function resolveForms(config, blocks, locale, defaultLocale, options) {
   }
   return forms;
 }
+
+// src/data/site-locales.ts
+var TTL_MS = 6e4;
+var MAX_ENTRIES = 64;
+var cache = /* @__PURE__ */ new Map();
+async function resolveSiteLocales(config, options) {
+  const key = `${config.apiUrl}::${config.workspaceSlug}`;
+  const cached = cache.get(key);
+  if (cached && cached.expires > Date.now()) return cached.value;
+  cache.delete(key);
+  let value;
+  try {
+    const data = await graphqlRequest(
+      config,
+      SITE_CONFIG_QUERY,
+      { workspaceSlug: config.workspaceSlug },
+      options,
+      "site config"
+    );
+    const siteConfig = data.publicSiteConfig;
+    const defaultLocale = siteConfig?.defaultLanguage || "en";
+    const enabled = siteConfig?.enabledLanguages ?? [];
+    value = {
+      defaultLocale,
+      locales: enabled.length > 0 ? enabled : [defaultLocale]
+    };
+  } catch {
+    value = { defaultLocale: "en", locales: ["en"] };
+  }
+  if (cache.size >= MAX_ENTRIES) cache.clear();
+  cache.set(key, { value, expires: Date.now() + TTL_MS });
+  return value;
+}
+function splitLocaleFromPath(path, siteLocales) {
+  const first = path?.[0];
+  if (first && first !== siteLocales.defaultLocale && siteLocales.locales.includes(first)) {
+    return { locale: first, path: path.slice(1) };
+  }
+  return { locale: siteLocales.defaultLocale, path };
+}
 function CmssyBlock({
   block,
   locale,
@@ -601,3 +684,5 @@ exports.normalizeSlug = normalizeSlug;
 exports.parseEditorMessage = parseEditorMessage;
 exports.postToEditor = postToEditor;
 exports.resolveForms = resolveForms;
+exports.resolveSiteLocales = resolveSiteLocales;
+exports.splitLocaleFromPath = splitLocaleFromPath;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-BaFQ2k7r.cjs';
-export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-BaFQ2k7r.cjs';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-e3O4s_bN.cjs';
+export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-e3O4s_bN.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -31,7 +31,12 @@ interface CmssyServerPageProps {
     /** Form definitions referenced by page blocks, exposed via context.forms. */
     forms?: Record<string, CmssyFormDefinition>;
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Async React Server Component (Next.js App Router / RSC). It runs each block's
+ * loader server-side before rendering, so it must be rendered in a server
+ * component tree (as `createCmssyPage` does) - not in a client component.
+ */
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -74,6 +79,16 @@ declare function createCmssyClient(config: CmssyClientConfig): CmssyClient;
 declare function collectFormIds(blocks: RawBlock[], locale: string, defaultLocale: string): string[];
 declare function resolveForms(config: CmssyClientConfig, blocks: RawBlock[], locale: string, defaultLocale: string, options?: QueryScopedOptions): Promise<Record<string, CmssyFormDefinition>>;
 
+interface CmssySiteLocales {
+    defaultLocale: string;
+    locales: string[];
+}
+declare function resolveSiteLocales(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<CmssySiteLocales>;
+declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: CmssySiteLocales): {
+    locale: string;
+    path: string[] | undefined;
+};
+
 interface CmssyBlockProps {
     block: RawBlock;
     locale: string;
@@ -91,4 +106,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-BaFQ2k7r.js';
-export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-BaFQ2k7r.js';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-e3O4s_bN.js';
+export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-e3O4s_bN.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -31,7 +31,12 @@ interface CmssyServerPageProps {
     /** Form definitions referenced by page blocks, exposed via context.forms. */
     forms?: Record<string, CmssyFormDefinition>;
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Async React Server Component (Next.js App Router / RSC). It runs each block's
+ * loader server-side before rendering, so it must be rendered in a server
+ * component tree (as `createCmssyPage` does) - not in a client component.
+ */
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -74,6 +79,16 @@ declare function createCmssyClient(config: CmssyClientConfig): CmssyClient;
 declare function collectFormIds(blocks: RawBlock[], locale: string, defaultLocale: string): string[];
 declare function resolveForms(config: CmssyClientConfig, blocks: RawBlock[], locale: string, defaultLocale: string, options?: QueryScopedOptions): Promise<Record<string, CmssyFormDefinition>>;
 
+interface CmssySiteLocales {
+    defaultLocale: string;
+    locales: string[];
+}
+declare function resolveSiteLocales(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<CmssySiteLocales>;
+declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: CmssySiteLocales): {
+    locale: string;
+    path: string[] | undefined;
+};
+
 interface CmssyBlockProps {
     block: RawBlock;
     locale: string;
@@ -91,4 +106,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };

package/dist/index.js

@@ -33,6 +33,13 @@ function buildBlockMap(blocks) {
   for (const block of blocks) map[block.type] = block.component;
   return map;
 }
+function buildLoaderMap(blocks) {
+  const map = /* @__PURE__ */ Object.create(null);
+  for (const block of blocks) {
+    if (block.loader) map[block.type] = block.loader;
+  }
+  return map;
+}
 function blocksToSchemas(blocks) {
   const out = /* @__PURE__ */ Object.create(null);
   for (const block of blocks) {
@@ -58,19 +65,6 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
-// src/components/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms
-  };
-}
-
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -94,6 +88,19 @@ function getBlockContentForLanguage(content, locale, defaultLocale = "en", avail
   const chosen = localeMap[locale] ?? localeMap[defaultLocale] ?? localeMap[fallbackKey];
   return { ...nonTranslatable, ...chosen };
 }
+
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms
+  };
+}
 var WARN_CAP = 256;
 var warned = /* @__PURE__ */ new Set();
 function UnknownBlock({ type }) {
@@ -104,12 +111,14 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+function renderResolvedBlock(block, map, locale, defaultLocale, options = {}) {
+  const { context, data, resolvedContent, enabledLocales } = options;
   const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
-  const content = getBlockContentForLanguage(
+  const content = resolvedContent ?? getBlockContentForLanguage(
     block.content,
     locale,
-    defaultLocale
+    defaultLocale,
+    enabledLocales?.length ? enabledLocales : void 0
   );
   return /* @__PURE__ */ jsx(
     "div",
@@ -117,12 +126,12 @@ function renderResolvedBlock(block, map, locale, defaultLocale, context) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? createElement(Component, { content, context }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
+      children: Component ? createElement(Component, { content, context, data }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
 }
-function CmssyServerPage({
+async function CmssyServerPage({
   page,
   blocks,
   locale = "en",
@@ -132,6 +141,7 @@ function CmssyServerPage({
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const loaderMap = buildLoaderMap(blocks);
   const context = buildBlockContext(
     locale,
     defaultLocale,
@@ -139,8 +149,38 @@ function CmssyServerPage({
     false,
     forms
   );
+  const resolved = await Promise.all(
+    page.blocks.map(async (block) => {
+      const content = getBlockContentForLanguage(
+        block.content,
+        locale,
+        defaultLocale,
+        enabledLocales?.length ? enabledLocales : void 0
+      );
+      const loader = loaderMap[block.type];
+      let data;
+      if (loader) {
+        try {
+          data = await loader({ content, context });
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              `[cmssy] loader for block "${block.type}" (${block.id}) failed`,
+              err
+            );
+          }
+        }
+      }
+      return { content, data };
+    })
+  );
   return /* @__PURE__ */ jsx(Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block, i) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      data: resolved[i]?.data,
+      resolvedContent: resolved[i]?.content,
+      enabledLocales
+    })
   ) });
 }
 function CmssyServerLayout({
@@ -157,7 +197,10 @@ function CmssyServerLayout({
   const map = buildBlockMap(blocks);
   const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsx(Fragment, { children: layoutBlocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      enabledLocales
+    })
   ) });
 }
 
@@ -545,6 +588,46 @@ async function resolveForms(config, blocks, locale, defaultLocale, options) {
   }
   return forms;
 }
+
+// src/data/site-locales.ts
+var TTL_MS = 6e4;
+var MAX_ENTRIES = 64;
+var cache = /* @__PURE__ */ new Map();
+async function resolveSiteLocales(config, options) {
+  const key = `${config.apiUrl}::${config.workspaceSlug}`;
+  const cached = cache.get(key);
+  if (cached && cached.expires > Date.now()) return cached.value;
+  cache.delete(key);
+  let value;
+  try {
+    const data = await graphqlRequest(
+      config,
+      SITE_CONFIG_QUERY,
+      { workspaceSlug: config.workspaceSlug },
+      options,
+      "site config"
+    );
+    const siteConfig = data.publicSiteConfig;
+    const defaultLocale = siteConfig?.defaultLanguage || "en";
+    const enabled = siteConfig?.enabledLanguages ?? [];
+    value = {
+      defaultLocale,
+      locales: enabled.length > 0 ? enabled : [defaultLocale]
+    };
+  } catch {
+    value = { defaultLocale: "en", locales: ["en"] };
+  }
+  if (cache.size >= MAX_ENTRIES) cache.clear();
+  cache.set(key, { value, expires: Date.now() + TTL_MS });
+  return value;
+}
+function splitLocaleFromPath(path, siteLocales) {
+  const first = path?.[0];
+  if (first && first !== siteLocales.defaultLocale && siteLocales.locales.includes(first)) {
+    return { locale: first, path: path.slice(1) };
+  }
+  return { locale: siteLocales.defaultLocale, path };
+}
 function CmssyBlock({
   block,
   locale,
@@ -571,4 +654,4 @@ function CmssyBlock({
   );
 }
 
-export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms };
+export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };

package/dist/{registry-BaFQ2k7r.d.cts → registry-e3O4s_bN.d.cts}

@@ -256,6 +256,11 @@ interface DragEndMessage {
 type EditorToAppMessage = SelectMessage | PatchMessage | ParentReadyMessage | InsertMessage | ReorderMessage | RemoveMessage | DragOverMessage | DragEndMessage;
 declare function isProtocolCompatible(version: number): boolean;
 
+interface BlockLoaderArgs {
+    content: Record<string, unknown>;
+    context?: CmssyBlockContext;
+}
+type BlockLoader = (args: BlockLoaderArgs) => Promise<unknown> | unknown;
 interface BlockDefinition {
     type: string;
     label?: string;
@@ -263,26 +268,43 @@ interface BlockDefinition {
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    /**
+     * Optional server-side data loader. Run by CmssyServerPage during SSR; its
+     * result is passed to the component as the `data` prop. Not run in the
+     * editor (the component receives `data: undefined` there).
+     *
+     * The result crosses the server→client boundary when the block component is a
+     * Client Component, so it must be RSC-serializable (plain objects, arrays and
+     * primitives - no functions, class instances, etc.).
+     */
+    loader?: BlockLoader;
     component: ComponentType<{
         content: Record<string, unknown>;
         context?: CmssyBlockContext;
+        data?: unknown;
     }>;
 }
-declare function defineBlock<C extends Record<string, unknown>>(def: {
+declare function defineBlock<C extends Record<string, unknown>, D = unknown>(def: {
     type: string;
     label?: string;
     category?: string;
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    loader?: (args: {
+        content: C;
+        context?: CmssyBlockContext;
+    }) => Promise<D> | D;
     component: ComponentType<{
         content: C;
         context?: CmssyBlockContext;
+        data?: D;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
     context?: CmssyBlockContext;
+    data?: unknown;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;

package/dist/{registry-BaFQ2k7r.d.ts → registry-e3O4s_bN.d.ts}

@@ -256,6 +256,11 @@ interface DragEndMessage {
 type EditorToAppMessage = SelectMessage | PatchMessage | ParentReadyMessage | InsertMessage | ReorderMessage | RemoveMessage | DragOverMessage | DragEndMessage;
 declare function isProtocolCompatible(version: number): boolean;
 
+interface BlockLoaderArgs {
+    content: Record<string, unknown>;
+    context?: CmssyBlockContext;
+}
+type BlockLoader = (args: BlockLoaderArgs) => Promise<unknown> | unknown;
 interface BlockDefinition {
     type: string;
     label?: string;
@@ -263,26 +268,43 @@ interface BlockDefinition {
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    /**
+     * Optional server-side data loader. Run by CmssyServerPage during SSR; its
+     * result is passed to the component as the `data` prop. Not run in the
+     * editor (the component receives `data: undefined` there).
+     *
+     * The result crosses the server→client boundary when the block component is a
+     * Client Component, so it must be RSC-serializable (plain objects, arrays and
+     * primitives - no functions, class instances, etc.).
+     */
+    loader?: BlockLoader;
     component: ComponentType<{
         content: Record<string, unknown>;
         context?: CmssyBlockContext;
+        data?: unknown;
     }>;
 }
-declare function defineBlock<C extends Record<string, unknown>>(def: {
+declare function defineBlock<C extends Record<string, unknown>, D = unknown>(def: {
     type: string;
     label?: string;
     category?: string;
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    loader?: (args: {
+        content: C;
+        context?: CmssyBlockContext;
+    }) => Promise<D> | D;
     component: ComponentType<{
         content: C;
         context?: CmssyBlockContext;
+        data?: D;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
     context?: CmssyBlockContext;
+    data?: unknown;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/react",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "React blocks, renderers, data client and editor bridge for cmssy headless sites",
   "keywords": [
     "cmssy",