@cmssy/react 10.2.0 → 10.4.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,14 +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, {
-      page: internal.blockPageOf(page)
+      page,
+      app: appContext
     }),
-    [locale, defaultLocale, enabledLocales, forms, page]
+    [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

@@ -1,7 +1,7 @@
 "use client";
 import { useState, useRef, useEffect, useMemo, createElement } from 'react';
 import { postToEditor, PROTOCOL_VERSION, parseEditorMessage } from '@cmssy/core';
-import { resolveInitialTarget, buildBlockContext, blockPageOf, getBlockContentForLanguage, normalizeRelationContent, asBucket } from '@cmssy/core/internal';
+import { resolveInitialTarget, buildBlockContext, getBlockContentForLanguage, normalizeRelationContent, asBucket } from '@cmssy/core/internal';
 import { BlockErrorBoundary } from '@cmssy/react/block-error-boundary';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
@@ -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,14 +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, {
-      page: blockPageOf(page)
+      page,
+      app: appContext
     }),
-    [locale, defaultLocale, enabledLocales, forms, page]
+    [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, page: internal.blockPageOf(page) }
+    { 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

@@ -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

@@ -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

@@ -1,5 +1,5 @@
 export { CmssyRequestError, PROTOCOL_VERSION, createCmssyClient, fields, graphqlRequest, isProtocolCompatible, normalizeOrigin, parseEditorMessage, postToEditor } from '@cmssy/core';
-import { buildBlockContext, blockPageOf, getBlockContentForLanguage, normalizeRelationContent, asBucket, resolveSiteLocales, resolveRelationContent } from '@cmssy/core/internal';
+import { buildBlockContext, getBlockContentForLanguage, normalizeRelationContent, asBucket, resolveSiteLocales, resolveRelationContent } from '@cmssy/core/internal';
 export { buildBlockContext } from '@cmssy/core/internal';
 import { createElement } from 'react';
 import { BlockErrorBoundary } from '@cmssy/react/block-error-boundary';
@@ -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, page: blockPageOf(page) }
+    { 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);
@@ -108,7 +109,7 @@ async function resolveEditorBlockData({
     enabledLocales,
     isPreview,
     forms,
-    { page: internal.blockPageOf(page) }
+    { 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

@@ -1,4 +1,4 @@
-import { buildBlockContext, blockPageOf, getBlockContentForLanguage, resolveRelationContent } from '@cmssy/core/internal';
+import { buildBlockContext, getBlockContentForLanguage, resolveRelationContent } from '@cmssy/core/internal';
 
 // src/components/resolve-block-data.ts
 
@@ -96,7 +96,8 @@ async function resolveEditorBlockData({
   enabledLocales,
   forms,
   isPreview = false,
-  config
+  config,
+  appContext
 }) {
   if (!page) return { data: {}, content: {} };
   const loaderMap = buildLoaderMap(blocks);
@@ -106,7 +107,7 @@ async function resolveEditorBlockData({
     enabledLocales,
     isPreview,
     forms,
-    { page: blockPageOf(page) }
+    { page, app: appContext }
   );
   const resolved = await resolveBlocks(
     page.blocks,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/react",
-  "version": "10.2.0",
+  "version": "10.4.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.30.0",
-    "@cmssy/core": "10.2.0"
+    "@cmssy/types": "0.31.0",
+    "@cmssy/core": "10.4.0"
   },
   "scripts": {
     "build": "tsup",