@cmssy/react 10.1.0 → 10.3.0

package/dist/client.cjs

@@ -619,7 +619,8 @@ function CmssyEditablePage({
   category,
   forms,
   data,
-  resolvedContent
+  resolvedContent,
+  appContext
 }) {
   if (!Array.isArray(blocks)) {
     throw new Error(
@@ -639,7 +640,8 @@ function CmssyEditablePage({
       category,
       forms,
       data,
-      resolvedContent
+      resolvedContent,
+      appContext
     }
   );
 }
@@ -653,12 +655,16 @@ function EditableBlocks({
   category,
   forms,
   data,
-  resolvedContent
+  resolvedContent,
+  appContext
 }) {
   const blockMap = react.useMemo(() => buildBlockMap(blocks), [blocks]);
   const context = react.useMemo(
-    () => internal.buildBlockContext(locale, defaultLocale, enabledLocales, true, forms),
-    [locale, defaultLocale, enabledLocales, forms]
+    () => internal.buildBlockContext(locale, defaultLocale, enabledLocales, true, forms, {
+      page,
+      app: appContext
+    }),
+    [locale, defaultLocale, enabledLocales, forms, page, appContext]
   );
   const bridgeConfig = react.useMemo(
     () => ({

package/dist/client.d.cts

@@ -46,8 +46,10 @@ interface CmssyEditablePageProps {
     forms?: Record<string, CmssyFormDefinition>;
     data?: Record<string, unknown>;
     resolvedContent?: Record<string, Record<string, unknown>>;
+    /** Same channel the deployed page gets, so the canvas shows the same thing. */
+    appContext?: Record<string, unknown>;
 }
-declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, forms, data, resolvedContent, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, forms, data, resolvedContent, appContext, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyEditorProps {
     page: CmssyPageData | null;

package/dist/client.d.ts

@@ -46,8 +46,10 @@ interface CmssyEditablePageProps {
     forms?: Record<string, CmssyFormDefinition>;
     data?: Record<string, unknown>;
     resolvedContent?: Record<string, Record<string, unknown>>;
+    /** Same channel the deployed page gets, so the canvas shows the same thing. */
+    appContext?: Record<string, unknown>;
 }
-declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, forms, data, resolvedContent, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, forms, data, resolvedContent, appContext, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyEditorProps {
     page: CmssyPageData | null;

package/dist/client.js

@@ -617,7 +617,8 @@ function CmssyEditablePage({
   category,
   forms,
   data,
-  resolvedContent
+  resolvedContent,
+  appContext
 }) {
   if (!Array.isArray(blocks)) {
     throw new Error(
@@ -637,7 +638,8 @@ function CmssyEditablePage({
       category,
       forms,
       data,
-      resolvedContent
+      resolvedContent,
+      appContext
     }
   );
 }
@@ -651,12 +653,16 @@ function EditableBlocks({
   category,
   forms,
   data,
-  resolvedContent
+  resolvedContent,
+  appContext
 }) {
   const blockMap = useMemo(() => buildBlockMap(blocks), [blocks]);
   const context = useMemo(
-    () => buildBlockContext(locale, defaultLocale, enabledLocales, true, forms),
-    [locale, defaultLocale, enabledLocales, forms]
+    () => buildBlockContext(locale, defaultLocale, enabledLocales, true, forms, {
+      page,
+      app: appContext
+    }),
+    [locale, defaultLocale, enabledLocales, forms, page, appContext]
   );
   const bridgeConfig = useMemo(
     () => ({

package/dist/index.cjs

@@ -261,6 +261,7 @@ async function CmssyServerPage({
   forms,
   auth,
   workspace,
+  appContext,
   editMode
 }) {
   if (!page) return null;
@@ -278,7 +279,7 @@ async function CmssyServerPage({
     enabledLocales,
     false,
     forms,
-    { auth, workspace }
+    { auth, workspace, page, app: appContext }
   );
   const resolved = await resolveBlocks(
     page.blocks,
@@ -308,6 +309,7 @@ async function CmssyServerLayout({
   defaultLocale: defaultLocaleProp,
   enabledLocales: enabledLocalesProp,
   config,
+  appContext,
   editMode
 }) {
   const { locale, defaultLocale, enabledLocales } = await resolveRenderLocale({
@@ -321,7 +323,14 @@ async function CmssyServerLayout({
   if (layoutBlocks.length === 0) return null;
   const map = buildBlockMap(blocks);
   const loaderMap = buildLoaderMap(blocks);
-  const context = internal.buildBlockContext(locale, defaultLocale, enabledLocales);
+  const context = internal.buildBlockContext(
+    locale,
+    defaultLocale,
+    enabledLocales,
+    false,
+    void 0,
+    { app: appContext }
+  );
   const resolved = await resolveBlocks(
     layoutBlocks,
     loaderMap,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { CmssyPageData, CmssyClientConfig, CmssyFormDefinition, CmssyBlockAuthContext, CmssyBlockWorkspace, CmssyLayoutGroup, RawBlock, CmssyBlockContext } from '@cmssy/core';
-export { AppToEditorMessage, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BoundsMessage, BuildBlockContextExtra, ClickMessage, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockWorkspace, CmssyBranding, CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssyRequestError, CmssySiteConfig, EditorToAppMessage, FetchLike, FetchLikeResponse, FetchPageOptions, FieldControl, FieldDefinition, FieldType, GraphqlRequestOptions, InferBlockContent, PROTOCOL_VERSION, ParentReadyMessage, PatchMessage, PostTarget, QueryScopedOptions, RawBlock, RawLayoutBlock, ReadyMessage, RetryPolicy, SelectMessage, SubmitFormInput, TypedField, createCmssyClient, fields, graphqlRequest, isProtocolCompatible, normalizeOrigin, parseEditorMessage, postToEditor } from '@cmssy/core';
+export { AppToEditorMessage, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BoundsMessage, BuildBlockContextExtra, ClickMessage, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssyRequestError, CmssySiteConfig, EditorToAppMessage, FetchLike, FetchLikeResponse, FetchPageOptions, FieldControl, FieldDefinition, FieldType, GraphqlRequestOptions, InferBlockContent, PROTOCOL_VERSION, ParentReadyMessage, PatchMessage, PostTarget, QueryScopedOptions, RawBlock, RawLayoutBlock, ReadyMessage, RetryPolicy, SelectMessage, SubmitFormInput, TypedField, createCmssyClient, fields, graphqlRequest, isProtocolCompatible, normalizeOrigin, parseEditorMessage, postToEditor } from '@cmssy/core';
 import { B as BlockDefinition, a as BlockMap } from './registry-zeNh3t6y.cjs';
 export { b as BlockProps, c as buildBlockMap, d as defineBlock } from './registry-zeNh3t6y.cjs';
 import { FieldDefinition } from '@cmssy/types';
@@ -27,6 +27,12 @@ interface CmssyServerPageProps {
     auth?: CmssyBlockAuthContext;
     /** Workspace identity, exposed via context.workspace. Resolved by createCmssyPage. */
     workspace?: CmssyBlockWorkspace;
+    /**
+     * Anything the app wants its blocks to see, exposed as context.app and passed
+     * through untouched. The escape hatch: a block needing something cmssy does
+     * not model is answered here instead of by a new field in the SDK.
+     */
+    appContext?: Record<string, unknown>;
     editMode?: boolean;
 }
 /**
@@ -34,7 +40,7 @@ interface CmssyServerPageProps {
  * 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: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, forms, auth, workspace, editMode, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
+declare function CmssyServerPage({ page, blocks, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, forms, auth, workspace, appContext, editMode, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -50,6 +56,12 @@ interface CmssyServerLayoutProps {
      * Without it the SDK has to guess, and its guess is "en".
      */
     config?: CmssyClientConfig;
+    /**
+     * Anything the app wants its layout blocks to see, exposed as context.app.
+     * A header that highlights the active link reads it from here - the SDK does
+     * not know the app's routing.
+     */
+    appContext?: Record<string, unknown>;
     editMode?: boolean;
 }
 /**
@@ -57,7 +69,7 @@ interface CmssyServerLayoutProps {
  * loader server-side before rendering, so a header block can list categories
  * the same way a page block can. Must be rendered in a server component tree.
  */
-declare function CmssyServerLayout({ groups, blocks, position, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, editMode, }: CmssyServerLayoutProps): Promise<react_jsx_runtime.JSX.Element | null>;
+declare function CmssyServerLayout({ groups, blocks, position, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, appContext, editMode, }: CmssyServerLayoutProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyBlockProps {
     block: RawBlock;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { CmssyPageData, CmssyClientConfig, CmssyFormDefinition, CmssyBlockAuthContext, CmssyBlockWorkspace, CmssyLayoutGroup, RawBlock, CmssyBlockContext } from '@cmssy/core';
-export { AppToEditorMessage, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BoundsMessage, BuildBlockContextExtra, ClickMessage, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockWorkspace, CmssyBranding, CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssyRequestError, CmssySiteConfig, EditorToAppMessage, FetchLike, FetchLikeResponse, FetchPageOptions, FieldControl, FieldDefinition, FieldType, GraphqlRequestOptions, InferBlockContent, PROTOCOL_VERSION, ParentReadyMessage, PatchMessage, PostTarget, QueryScopedOptions, RawBlock, RawLayoutBlock, ReadyMessage, RetryPolicy, SelectMessage, SubmitFormInput, TypedField, createCmssyClient, fields, graphqlRequest, isProtocolCompatible, normalizeOrigin, parseEditorMessage, postToEditor } from '@cmssy/core';
+export { AppToEditorMessage, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BoundsMessage, BuildBlockContextExtra, ClickMessage, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssyRequestError, CmssySiteConfig, EditorToAppMessage, FetchLike, FetchLikeResponse, FetchPageOptions, FieldControl, FieldDefinition, FieldType, GraphqlRequestOptions, InferBlockContent, PROTOCOL_VERSION, ParentReadyMessage, PatchMessage, PostTarget, QueryScopedOptions, RawBlock, RawLayoutBlock, ReadyMessage, RetryPolicy, SelectMessage, SubmitFormInput, TypedField, createCmssyClient, fields, graphqlRequest, isProtocolCompatible, normalizeOrigin, parseEditorMessage, postToEditor } from '@cmssy/core';
 import { B as BlockDefinition, a as BlockMap } from './registry-zeNh3t6y.js';
 export { b as BlockProps, c as buildBlockMap, d as defineBlock } from './registry-zeNh3t6y.js';
 import { FieldDefinition } from '@cmssy/types';
@@ -27,6 +27,12 @@ interface CmssyServerPageProps {
     auth?: CmssyBlockAuthContext;
     /** Workspace identity, exposed via context.workspace. Resolved by createCmssyPage. */
     workspace?: CmssyBlockWorkspace;
+    /**
+     * Anything the app wants its blocks to see, exposed as context.app and passed
+     * through untouched. The escape hatch: a block needing something cmssy does
+     * not model is answered here instead of by a new field in the SDK.
+     */
+    appContext?: Record<string, unknown>;
     editMode?: boolean;
 }
 /**
@@ -34,7 +40,7 @@ interface CmssyServerPageProps {
  * 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: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, forms, auth, workspace, editMode, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
+declare function CmssyServerPage({ page, blocks, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, forms, auth, workspace, appContext, editMode, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -50,6 +56,12 @@ interface CmssyServerLayoutProps {
      * Without it the SDK has to guess, and its guess is "en".
      */
     config?: CmssyClientConfig;
+    /**
+     * Anything the app wants its layout blocks to see, exposed as context.app.
+     * A header that highlights the active link reads it from here - the SDK does
+     * not know the app's routing.
+     */
+    appContext?: Record<string, unknown>;
     editMode?: boolean;
 }
 /**
@@ -57,7 +69,7 @@ interface CmssyServerLayoutProps {
  * loader server-side before rendering, so a header block can list categories
  * the same way a page block can. Must be rendered in a server component tree.
  */
-declare function CmssyServerLayout({ groups, blocks, position, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, editMode, }: CmssyServerLayoutProps): Promise<react_jsx_runtime.JSX.Element | null>;
+declare function CmssyServerLayout({ groups, blocks, position, locale: localeProp, defaultLocale: defaultLocaleProp, enabledLocales: enabledLocalesProp, config, appContext, editMode, }: CmssyServerLayoutProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyBlockProps {
     block: RawBlock;

package/dist/index.js

@@ -260,6 +260,7 @@ async function CmssyServerPage({
   forms,
   auth,
   workspace,
+  appContext,
   editMode
 }) {
   if (!page) return null;
@@ -277,7 +278,7 @@ async function CmssyServerPage({
     enabledLocales,
     false,
     forms,
-    { auth, workspace }
+    { auth, workspace, page, app: appContext }
   );
   const resolved = await resolveBlocks(
     page.blocks,
@@ -307,6 +308,7 @@ async function CmssyServerLayout({
   defaultLocale: defaultLocaleProp,
   enabledLocales: enabledLocalesProp,
   config,
+  appContext,
   editMode
 }) {
   const { locale, defaultLocale, enabledLocales } = await resolveRenderLocale({
@@ -320,7 +322,14 @@ async function CmssyServerLayout({
   if (layoutBlocks.length === 0) return null;
   const map = buildBlockMap(blocks);
   const loaderMap = buildLoaderMap(blocks);
-  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
+  const context = buildBlockContext(
+    locale,
+    defaultLocale,
+    enabledLocales,
+    false,
+    void 0,
+    { app: appContext }
+  );
   const resolved = await resolveBlocks(
     layoutBlocks,
     loaderMap,

package/dist/internal-server.cjs

@@ -98,7 +98,8 @@ async function resolveEditorBlockData({
   enabledLocales,
   forms,
   isPreview = false,
-  config
+  config,
+  appContext
 }) {
   if (!page) return { data: {}, content: {} };
   const loaderMap = buildLoaderMap(blocks);
@@ -107,7 +108,8 @@ async function resolveEditorBlockData({
     defaultLocale,
     enabledLocales,
     isPreview,
-    forms
+    forms,
+    { page, app: appContext }
   );
   const resolved = await resolveBlocks(
     page.blocks,

package/dist/internal-server.d.cts

@@ -16,8 +16,10 @@ interface ResolveBlockDataOptions {
     isPreview?: boolean;
     /** Workspace the relation records are read from. No config, no resolution. */
     config?: CmssyClientConfig;
+    /** Passed to loaders as context.app, exactly as on the deployed page. */
+    appContext?: Record<string, unknown>;
 }
-declare function resolveEditorBlockData({ page, blocks, locale, defaultLocale, enabledLocales, forms, isPreview, config, }: ResolveBlockDataOptions): Promise<EditorBlockData>;
+declare function resolveEditorBlockData({ page, blocks, locale, defaultLocale, enabledLocales, forms, isPreview, config, appContext, }: ResolveBlockDataOptions): Promise<EditorBlockData>;
 declare function resolveBlockData(options: ResolveBlockDataOptions): Promise<Record<string, unknown>>;
 interface ResolveLayoutBlockDataOptions {
     groups: CmssyLayoutGroup[];

package/dist/internal-server.d.ts

@@ -16,8 +16,10 @@ interface ResolveBlockDataOptions {
     isPreview?: boolean;
     /** Workspace the relation records are read from. No config, no resolution. */
     config?: CmssyClientConfig;
+    /** Passed to loaders as context.app, exactly as on the deployed page. */
+    appContext?: Record<string, unknown>;
 }
-declare function resolveEditorBlockData({ page, blocks, locale, defaultLocale, enabledLocales, forms, isPreview, config, }: ResolveBlockDataOptions): Promise<EditorBlockData>;
+declare function resolveEditorBlockData({ page, blocks, locale, defaultLocale, enabledLocales, forms, isPreview, config, appContext, }: ResolveBlockDataOptions): Promise<EditorBlockData>;
 declare function resolveBlockData(options: ResolveBlockDataOptions): Promise<Record<string, unknown>>;
 interface ResolveLayoutBlockDataOptions {
     groups: CmssyLayoutGroup[];

package/dist/internal-server.js

@@ -96,7 +96,8 @@ async function resolveEditorBlockData({
   enabledLocales,
   forms,
   isPreview = false,
-  config
+  config,
+  appContext
 }) {
   if (!page) return { data: {}, content: {} };
   const loaderMap = buildLoaderMap(blocks);
@@ -105,7 +106,8 @@ async function resolveEditorBlockData({
     defaultLocale,
     enabledLocales,
     isPreview,
-    forms
+    forms,
+    { page, app: appContext }
   );
   const resolved = await resolveBlocks(
     page.blocks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/react",
-  "version": "10.1.0",
+  "version": "10.3.0",
   "description": "React blocks, renderers, data client and editor bridge for cmssy headless sites",
   "keywords": [
     "cmssy",
@@ -71,8 +71,8 @@
     "vitest": "^2.1.0"
   },
   "dependencies": {
-    "@cmssy/types": "0.29.0",
-    "@cmssy/core": "10.1.0"
+    "@cmssy/types": "0.31.0",
+    "@cmssy/core": "10.3.0"
   },
   "scripts": {
     "build": "tsup",