@cmssy/react 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,99 @@
+# @cmssy/react
+
+React building blocks for a [cmssy](https://cmssy.com) headless site: define
+blocks, render published content, fetch data from the public delivery API, and
+drive the live editor bridge. Framework-agnostic React; for Next.js App Router
+wiring use [`@cmssy/next`](https://www.npmjs.com/package/@cmssy/next).
+
+```bash
+pnpm add @cmssy/react
+```
+
+## Define a block
+
+A block is a plain React component plus a field schema the editor reads.
+
+```tsx
+import { defineBlock, fields } from "@cmssy/react";
+import Hero from "./Hero";
+
+export const heroBlock = defineBlock({
+  type: "hero",
+  label: "Hero",
+  component: Hero,
+  props: {
+    heading: fields.singleLine({ label: "Heading", required: true }),
+    subheading: fields.multiLine({ label: "Subheading" }),
+    cta: fields.link({ label: "CTA" }),
+    image: fields.media({ label: "Image" }),
+  },
+});
+```
+
+`fields` covers `singleLine`, `multiLine`, `link`, `media`, `boolean`,
+`repeater`, and more. The block component receives `{ content }` resolved from
+the CMS at runtime.
+
+## Render published content
+
+```tsx
+import { fetchPage, CmssyServerPage } from "@cmssy/react";
+
+const page = await fetchPage(
+  { apiUrl: "https://api.cmssy.io/graphql", workspaceSlug: "acme" },
+  pathSegments,
+);
+
+return <CmssyServerPage page={page} blocks={blocks} locale="en" />;
+```
+
+`CmssyServerLayout` renders header/footer layout groups the same way. Both are
+Server Components — no block JavaScript ships to the client unless a block needs
+it.
+
+## Fetch data
+
+One generic GraphQL client over the public API — write your own queries (or use
+the exported documents):
+
+```ts
+import { createCmssyClient, MODEL_RECORDS_QUERY } from "@cmssy/react";
+
+const cmssy = createCmssyClient({
+  apiUrl: "https://api.cmssy.io/graphql",
+  workspaceSlug: "acme",
+});
+
+// raw query (you own scoping)
+await cmssy.query(MY_QUERY, vars);
+
+// workspace-scoped (auto x-workspace-id header + $workspaceId var)
+const { publicModelRecords } = await cmssy.queryScoped(MODEL_RECORDS_QUERY, {
+  modelSlug: "posts",
+});
+```
+
+Ready-made documents + result types: `SITE_CONFIG_QUERY`,
+`MODEL_DEFINITIONS_QUERY`, `MODEL_RECORDS_QUERY`, `FORM_QUERY`,
+`SUBMIT_FORM_MUTATION`.
+
+## Live editor (client)
+
+`@cmssy/react/client` exposes the lazy editor + layout wrappers that keep block
+chunks isolated:
+
+```tsx
+"use client";
+import { CmssyLazyEditor } from "@cmssy/react/client";
+
+export const CmssyEditor = (props) => (
+  <CmssyLazyEditor {...props} load={() => import("./blocks")} />
+);
+```
+
+The editor talks to the cmssy admin over the `cmssy:*` bridge protocol for live
+preview.
+
+## License
+
+MIT

package/dist/client.cjs

@@ -415,6 +415,18 @@ function useDragAgent(config) {
   return { dropY };
 }
 
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false
+  };
+}
+
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -455,7 +467,8 @@ function CmssyBlock({
   blockMap,
   patchedContent,
   editable,
-  layoutPosition
+  layoutPosition,
+  context
 }) {
   const Component = Object.hasOwn(blockMap, block.type) ? blockMap[block.type] : void 0;
   const base = getBlockContentForLanguage(block.content, locale, defaultLocale);
@@ -468,7 +481,7 @@ function CmssyBlock({
       "data-layout-position": layoutPosition,
       draggable: editable || void 0,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? react.createElement(Component, { content }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
+      children: Component ? react.createElement(Component, { content, context }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
     }
   );
 }
@@ -477,6 +490,7 @@ function CmssyEditablePage({
   blocks,
   locale = "en",
   defaultLocale = "en",
+  enabledLocales,
   edit,
   category
 }) {
@@ -493,6 +507,7 @@ function CmssyEditablePage({
       blocks,
       locale,
       defaultLocale,
+      enabledLocales,
       edit,
       category
     }
@@ -503,10 +518,15 @@ function EditableBlocks({
   blocks,
   locale,
   defaultLocale,
+  enabledLocales,
   edit,
   category
 }) {
   const blockMap = react.useMemo(() => buildBlockMap(blocks), [blocks]);
+  const context = react.useMemo(
+    () => buildBlockContext(locale, defaultLocale, enabledLocales, true),
+    [locale, defaultLocale, enabledLocales]
+  );
   const bridgeConfig = react.useMemo(
     () => ({
       ...edit,
@@ -550,7 +570,8 @@ function EditableBlocks({
         defaultLocale,
         patchedContent: patches[block.id],
         blockMap,
-        editable: true
+        editable: true,
+        context
       },
       block.id
     )),
@@ -638,6 +659,7 @@ function CmssyEditableLayout({
   position,
   locale = "en",
   defaultLocale = "en",
+  enabledLocales,
   edit
 }) {
   const blockMap = react.useMemo(() => buildBlockMap(blocks), [blocks]);
@@ -646,6 +668,10 @@ function CmssyEditableLayout({
     return group ? group.blocks.filter((b) => b.isActive).slice().sort((a, b) => a.order - b.order) : [];
   }, [groups, position]);
   const patches = useLayoutPatchBridge(position, edit);
+  const context = react.useMemo(
+    () => buildBlockContext(locale, defaultLocale, enabledLocales, true),
+    [locale, defaultLocale, enabledLocales]
+  );
   if (layoutBlocks.length === 0) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: layoutBlocks.map((block) => /* @__PURE__ */ jsxRuntime.jsx(
     CmssyBlock,
@@ -655,7 +681,8 @@ function CmssyEditableLayout({
       defaultLocale,
       blockMap,
       patchedContent: patches[block.id],
-      layoutPosition: position
+      layoutPosition: position,
+      context
     },
     block.id
   )) });

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 CmssyLayoutGroup } from './registry-BoxAyw4_.cjs';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup } from './registry-suRGkEQs.cjs';
 import 'react';
 
 interface EditBridgeConfig {
@@ -35,15 +35,17 @@ interface CmssyEditablePageProps {
     blocks: BlockDefinition[];
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     category?: string;
 }
-declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, edit, category, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyEditorProps {
     page: CmssyPageData | null;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     load: () => Promise<{
         blocks: BlockDefinition[];
@@ -58,15 +60,17 @@ interface CmssyEditableLayoutProps {
     position: string;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
 }
-declare function CmssyEditableLayout({ groups, blocks, position, locale, defaultLocale, edit, }: CmssyEditableLayoutProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditableLayout({ groups, blocks, position, locale, defaultLocale, enabledLocales, edit, }: CmssyEditableLayoutProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyLayoutProps {
     groups: CmssyLayoutGroup[];
     position: string;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     load: () => Promise<{
         blocks: BlockDefinition[];

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 CmssyLayoutGroup } from './registry-BoxAyw4_.js';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup } from './registry-suRGkEQs.js';
 import 'react';
 
 interface EditBridgeConfig {
@@ -35,15 +35,17 @@ interface CmssyEditablePageProps {
     blocks: BlockDefinition[];
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     category?: string;
 }
-declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, edit, category, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditablePage({ page, blocks, locale, defaultLocale, enabledLocales, edit, category, }: CmssyEditablePageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyEditorProps {
     page: CmssyPageData | null;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     load: () => Promise<{
         blocks: BlockDefinition[];
@@ -58,15 +60,17 @@ interface CmssyEditableLayoutProps {
     position: string;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
 }
-declare function CmssyEditableLayout({ groups, blocks, position, locale, defaultLocale, edit, }: CmssyEditableLayoutProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyEditableLayout({ groups, blocks, position, locale, defaultLocale, enabledLocales, edit, }: CmssyEditableLayoutProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyLazyLayoutProps {
     groups: CmssyLayoutGroup[];
     position: string;
     locale?: string;
     defaultLocale?: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
     load: () => Promise<{
         blocks: BlockDefinition[];

package/dist/client.js

@@ -413,6 +413,18 @@ function useDragAgent(config) {
   return { dropY };
 }
 
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false
+  };
+}
+
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -453,7 +465,8 @@ function CmssyBlock({
   blockMap,
   patchedContent,
   editable,
-  layoutPosition
+  layoutPosition,
+  context
 }) {
   const Component = Object.hasOwn(blockMap, block.type) ? blockMap[block.type] : void 0;
   const base = getBlockContentForLanguage(block.content, locale, defaultLocale);
@@ -466,7 +479,7 @@ function CmssyBlock({
       "data-layout-position": layoutPosition,
       draggable: editable || void 0,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? createElement(Component, { content }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
+      children: Component ? createElement(Component, { content, context }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
     }
   );
 }
@@ -475,6 +488,7 @@ function CmssyEditablePage({
   blocks,
   locale = "en",
   defaultLocale = "en",
+  enabledLocales,
   edit,
   category
 }) {
@@ -491,6 +505,7 @@ function CmssyEditablePage({
       blocks,
       locale,
       defaultLocale,
+      enabledLocales,
       edit,
       category
     }
@@ -501,10 +516,15 @@ function EditableBlocks({
   blocks,
   locale,
   defaultLocale,
+  enabledLocales,
   edit,
   category
 }) {
   const blockMap = useMemo(() => buildBlockMap(blocks), [blocks]);
+  const context = useMemo(
+    () => buildBlockContext(locale, defaultLocale, enabledLocales, true),
+    [locale, defaultLocale, enabledLocales]
+  );
   const bridgeConfig = useMemo(
     () => ({
       ...edit,
@@ -548,7 +568,8 @@ function EditableBlocks({
         defaultLocale,
         patchedContent: patches[block.id],
         blockMap,
-        editable: true
+        editable: true,
+        context
       },
       block.id
     )),
@@ -636,6 +657,7 @@ function CmssyEditableLayout({
   position,
   locale = "en",
   defaultLocale = "en",
+  enabledLocales,
   edit
 }) {
   const blockMap = useMemo(() => buildBlockMap(blocks), [blocks]);
@@ -644,6 +666,10 @@ function CmssyEditableLayout({
     return group ? group.blocks.filter((b) => b.isActive).slice().sort((a, b) => a.order - b.order) : [];
   }, [groups, position]);
   const patches = useLayoutPatchBridge(position, edit);
+  const context = useMemo(
+    () => buildBlockContext(locale, defaultLocale, enabledLocales, true),
+    [locale, defaultLocale, enabledLocales]
+  );
   if (layoutBlocks.length === 0) return null;
   return /* @__PURE__ */ jsx(Fragment, { children: layoutBlocks.map((block) => /* @__PURE__ */ jsx(
     CmssyBlock,
@@ -653,7 +679,8 @@ function CmssyEditableLayout({
       defaultLocale,
       blockMap,
       patchedContent: patches[block.id],
-      layoutPosition: position
+      layoutPosition: position,
+      context
     },
     block.id
   )) });

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
 
 // src/fields.ts
 function control(type) {
@@ -60,6 +60,18 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false
+  };
+}
+
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -93,8 +105,8 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale) {
-  const Component = map[block.type];
+function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+  const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
   const content = getBlockContentForLanguage(
     block.content,
     locale,
@@ -106,7 +118,7 @@ function renderResolvedBlock(block, map, locale, defaultLocale) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? /* @__PURE__ */ jsxRuntime.jsx(Component, { content }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
+      children: Component ? react.createElement(Component, { content, context }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
@@ -115,12 +127,14 @@ function CmssyServerPage({
   page,
   blocks,
   locale = "en",
-  defaultLocale = "en"
+  defaultLocale = "en",
+  enabledLocales
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
   ) });
 }
 function CmssyServerLayout({
@@ -128,14 +142,16 @@ function CmssyServerLayout({
   blocks,
   position,
   locale = "en",
-  defaultLocale = "en"
+  defaultLocale = "en",
+  enabledLocales
 }) {
   const group = groups.find((g) => g.position === position);
   const layoutBlocks = group ? group.blocks.filter((b) => b.isActive).slice().sort((a, b) => a.order - b.order) : [];
   if (layoutBlocks.length === 0) return null;
   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)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
   ) });
 }
 
@@ -484,7 +500,8 @@ function CmssyBlock({
   blockMap,
   patchedContent,
   editable,
-  layoutPosition
+  layoutPosition,
+  context
 }) {
   const Component = Object.hasOwn(blockMap, block.type) ? blockMap[block.type] : void 0;
   const base = getBlockContentForLanguage(block.content, locale, defaultLocale);
@@ -497,7 +514,7 @@ function CmssyBlock({
       "data-layout-position": layoutPosition,
       draggable: editable || void 0,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? react.createElement(Component, { content }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
+      children: Component ? react.createElement(Component, { content, context }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
     }
   );
 }
@@ -514,6 +531,7 @@ exports.SUBMIT_FORM_MUTATION = SUBMIT_FORM_MUTATION;
 exports.UnknownBlock = UnknownBlock;
 exports.blocksToMeta = blocksToMeta;
 exports.blocksToSchemas = blocksToSchemas;
+exports.buildBlockContext = buildBlockContext;
 exports.buildBlockMap = buildBlockMap;
 exports.createCmssyClient = createCmssyClient;
 exports.defineBlock = defineBlock;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, d as FetchLike, e as CmssyClientConfig, R as RawBlock, f as BlockMap } from './registry-BoxAyw4_.cjs';
-export { a as BlockMeta, g as BlockRect, B as BlockSchema, h as BoundsMessage, i as ClickMessage, j as FetchLikeResponse, k as FetchPageOptions, l as FieldType, P as PROTOCOL_VERSION, m as ParentReadyMessage, n as PatchMessage, o as RawLayoutBlock, p as ReadyMessage, S as SelectMessage, q as blocksToMeta, r as blocksToSchemas, s as buildBlockMap, t as defineBlock, u as fetchLayouts, v as fetchPage, w as isProtocolCompatible, x as normalizeSlug } from './registry-BoxAyw4_.cjs';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, d as FetchLike, e as CmssyClientConfig, R as RawBlock, f as BlockMap, g as CmssyBlockContext } from './registry-suRGkEQs.cjs';
+export { a as BlockMeta, h as BlockRect, B as BlockSchema, i as BoundsMessage, j as ClickMessage, k as CmssyLocaleContext, l as FetchLikeResponse, m as FetchPageOptions, n as FieldType, P as PROTOCOL_VERSION, o as ParentReadyMessage, p as PatchMessage, q as RawLayoutBlock, r as ReadyMessage, S as SelectMessage, s as blocksToMeta, t as blocksToSchemas, u as buildBlockContext, v as buildBlockMap, w as defineBlock, x as fetchLayouts, y as fetchPage, z as isProtocolCompatible, D as normalizeSlug } from './registry-suRGkEQs.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -26,8 +26,10 @@ interface CmssyServerPageProps {
     blocks: BlockDefinition[];
     locale?: string;
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -35,8 +37,10 @@ interface CmssyServerLayoutProps {
     position: string;
     locale?: string;
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
 }
-declare function CmssyServerLayout({ groups, blocks, position, locale, defaultLocale, }: CmssyServerLayoutProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyServerLayout({ groups, blocks, position, locale, defaultLocale, enabledLocales, }: CmssyServerLayoutProps): react_jsx_runtime.JSX.Element | null;
 
 interface PostTarget {
     postMessage: (message: unknown, targetOrigin: string) => void;
@@ -155,12 +159,13 @@ interface CmssyBlockProps {
     patchedContent?: Record<string, unknown>;
     editable?: boolean;
     layoutPosition?: string;
+    context?: CmssyBlockContext;
 }
-declare function CmssyBlock({ block, locale, defaultLocale, blockMap, patchedContent, editable, layoutPosition, }: CmssyBlockProps): react_jsx_runtime.JSX.Element;
+declare function CmssyBlock({ block, locale, defaultLocale, blockMap, patchedContent, editable, layoutPosition, context, }: CmssyBlockProps): react_jsx_runtime.JSX.Element;
 
 interface UnknownBlockProps {
     type: string;
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, type CmssyFormDefinition, type CmssyFormField, type CmssyFormSettings, type CmssyFormSubmitResponse, CmssyLayoutGroup, type CmssyModelDefinition, type CmssyModelRecord, CmssyPageData, type CmssyRecordList, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteConfig, EditorToAppMessage, FORM_QUERY, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, type PostTarget, type QueryScopedOptions, RawBlock, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, type SubmitFormInput, UnknownBlock, type UnknownBlockProps, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, type CmssyFormDefinition, type CmssyFormField, type CmssyFormSettings, type CmssyFormSubmitResponse, CmssyLayoutGroup, type CmssyModelDefinition, type CmssyModelRecord, CmssyPageData, type CmssyRecordList, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteConfig, EditorToAppMessage, FORM_QUERY, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, type PostTarget, type QueryScopedOptions, RawBlock, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, type SubmitFormInput, UnknownBlock, type UnknownBlockProps, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, d as FetchLike, e as CmssyClientConfig, R as RawBlock, f as BlockMap } from './registry-BoxAyw4_.js';
-export { a as BlockMeta, g as BlockRect, B as BlockSchema, h as BoundsMessage, i as ClickMessage, j as FetchLikeResponse, k as FetchPageOptions, l as FieldType, P as PROTOCOL_VERSION, m as ParentReadyMessage, n as PatchMessage, o as RawLayoutBlock, p as ReadyMessage, S as SelectMessage, q as blocksToMeta, r as blocksToSchemas, s as buildBlockMap, t as defineBlock, u as fetchLayouts, v as fetchPage, w as isProtocolCompatible, x as normalizeSlug } from './registry-BoxAyw4_.js';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, d as FetchLike, e as CmssyClientConfig, R as RawBlock, f as BlockMap, g as CmssyBlockContext } from './registry-suRGkEQs.js';
+export { a as BlockMeta, h as BlockRect, B as BlockSchema, i as BoundsMessage, j as ClickMessage, k as CmssyLocaleContext, l as FetchLikeResponse, m as FetchPageOptions, n as FieldType, P as PROTOCOL_VERSION, o as ParentReadyMessage, p as PatchMessage, q as RawLayoutBlock, r as ReadyMessage, S as SelectMessage, s as blocksToMeta, t as blocksToSchemas, u as buildBlockContext, v as buildBlockMap, w as defineBlock, x as fetchLayouts, y as fetchPage, z as isProtocolCompatible, D as normalizeSlug } from './registry-suRGkEQs.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -26,8 +26,10 @@ interface CmssyServerPageProps {
     blocks: BlockDefinition[];
     locale?: string;
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -35,8 +37,10 @@ interface CmssyServerLayoutProps {
     position: string;
     locale?: string;
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
 }
-declare function CmssyServerLayout({ groups, blocks, position, locale, defaultLocale, }: CmssyServerLayoutProps): react_jsx_runtime.JSX.Element | null;
+declare function CmssyServerLayout({ groups, blocks, position, locale, defaultLocale, enabledLocales, }: CmssyServerLayoutProps): react_jsx_runtime.JSX.Element | null;
 
 interface PostTarget {
     postMessage: (message: unknown, targetOrigin: string) => void;
@@ -155,12 +159,13 @@ interface CmssyBlockProps {
     patchedContent?: Record<string, unknown>;
     editable?: boolean;
     layoutPosition?: string;
+    context?: CmssyBlockContext;
 }
-declare function CmssyBlock({ block, locale, defaultLocale, blockMap, patchedContent, editable, layoutPosition, }: CmssyBlockProps): react_jsx_runtime.JSX.Element;
+declare function CmssyBlock({ block, locale, defaultLocale, blockMap, patchedContent, editable, layoutPosition, context, }: CmssyBlockProps): react_jsx_runtime.JSX.Element;
 
 interface UnknownBlockProps {
     type: string;
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, type CmssyFormDefinition, type CmssyFormField, type CmssyFormSettings, type CmssyFormSubmitResponse, CmssyLayoutGroup, type CmssyModelDefinition, type CmssyModelRecord, CmssyPageData, type CmssyRecordList, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteConfig, EditorToAppMessage, FORM_QUERY, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, type PostTarget, type QueryScopedOptions, RawBlock, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, type SubmitFormInput, UnknownBlock, type UnknownBlockProps, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, type CmssyFormDefinition, type CmssyFormField, type CmssyFormSettings, type CmssyFormSubmitResponse, CmssyLayoutGroup, type CmssyModelDefinition, type CmssyModelRecord, CmssyPageData, type CmssyRecordList, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteConfig, EditorToAppMessage, FORM_QUERY, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, type PostTarget, type QueryScopedOptions, RawBlock, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, type SubmitFormInput, UnknownBlock, type UnknownBlockProps, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { jsx, Fragment } from 'react/jsx-runtime';
 import { createElement } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
 
 // src/fields.ts
 function control(type) {
@@ -58,6 +58,18 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false
+  };
+}
+
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -91,8 +103,8 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale) {
-  const Component = map[block.type];
+function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+  const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
   const content = getBlockContentForLanguage(
     block.content,
     locale,
@@ -104,7 +116,7 @@ function renderResolvedBlock(block, map, locale, defaultLocale) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? /* @__PURE__ */ jsx(Component, { content }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
+      children: Component ? createElement(Component, { content, context }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
@@ -113,12 +125,14 @@ function CmssyServerPage({
   page,
   blocks,
   locale = "en",
-  defaultLocale = "en"
+  defaultLocale = "en",
+  enabledLocales
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsx(Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
   ) });
 }
 function CmssyServerLayout({
@@ -126,14 +140,16 @@ function CmssyServerLayout({
   blocks,
   position,
   locale = "en",
-  defaultLocale = "en"
+  defaultLocale = "en",
+  enabledLocales
 }) {
   const group = groups.find((g) => g.position === position);
   const layoutBlocks = group ? group.blocks.filter((b) => b.isActive).slice().sort((a, b) => a.order - b.order) : [];
   if (layoutBlocks.length === 0) return null;
   const map = buildBlockMap(blocks);
+  const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsx(Fragment, { children: layoutBlocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
   ) });
 }
 
@@ -482,7 +498,8 @@ function CmssyBlock({
   blockMap,
   patchedContent,
   editable,
-  layoutPosition
+  layoutPosition,
+  context
 }) {
   const Component = Object.hasOwn(blockMap, block.type) ? blockMap[block.type] : void 0;
   const base = getBlockContentForLanguage(block.content, locale, defaultLocale);
@@ -495,9 +512,9 @@ function CmssyBlock({
       "data-layout-position": layoutPosition,
       draggable: editable || void 0,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? createElement(Component, { content }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
+      children: Component ? createElement(Component, { content, context }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
     }
   );
 }
 
-export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockMap, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor };
+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, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor };

package/dist/{registry-BoxAyw4_.d.cts → registry-suRGkEQs.d.cts}

@@ -44,6 +44,17 @@ declare function normalizeSlug(path: string | string[] | undefined): string;
 declare function fetchPage(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyPageData | null>;
 declare function fetchLayouts(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyLayoutGroup[]>;
 
+interface CmssyLocaleContext {
+    current: string;
+    default: string;
+    enabled: string[];
+}
+interface CmssyBlockContext {
+    locale: CmssyLocaleContext;
+    isPreview: boolean;
+}
+declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean): CmssyBlockContext;
+
 declare const PROTOCOL_VERSION = 1;
 type FieldType = "singleLine" | "multiLine" | "richText" | "numeric" | "date" | "media" | "link" | "select" | "multiselect" | "boolean" | "color" | "repeater";
 interface FieldDefinition {
@@ -164,6 +175,7 @@ interface BlockDefinition {
     props: Record<string, FieldDefinition>;
     component: ComponentType<{
         content: Record<string, unknown>;
+        context?: CmssyBlockContext;
     }>;
 }
 declare function defineBlock<C extends Record<string, unknown>>(def: {
@@ -175,10 +187,12 @@ declare function defineBlock<C extends Record<string, unknown>>(def: {
     props: Record<string, FieldDefinition>;
     component: ComponentType<{
         content: C;
+        context?: CmssyBlockContext;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
+    context?: CmssyBlockContext;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;
@@ -186,4 +200,4 @@ declare function blocksToMeta(blocks: BlockDefinition[], defaults?: {
     category?: string;
 }): Record<string, BlockMeta>;
 
-export { type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type EditorToAppMessage as E, type FieldDefinition as F, PROTOCOL_VERSION as P, type RawBlock as R, type SelectMessage as S, type BlockMeta as a, type BlockDefinition as b, type CmssyLayoutGroup as c, type FetchLike as d, type CmssyClientConfig as e, type BlockMap as f, type BlockRect as g, type BoundsMessage as h, type ClickMessage as i, type FetchLikeResponse as j, type FetchPageOptions as k, type FieldType as l, type ParentReadyMessage as m, type PatchMessage as n, type RawLayoutBlock as o, type ReadyMessage as p, blocksToMeta as q, blocksToSchemas as r, buildBlockMap as s, defineBlock as t, fetchLayouts as u, fetchPage as v, isProtocolCompatible as w, normalizeSlug as x };
+export { type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, normalizeSlug as D, type EditorToAppMessage as E, type FieldDefinition as F, PROTOCOL_VERSION as P, type RawBlock as R, type SelectMessage as S, type BlockMeta as a, type BlockDefinition as b, type CmssyLayoutGroup as c, type FetchLike as d, type CmssyClientConfig as e, type BlockMap as f, type CmssyBlockContext as g, type BlockRect as h, type BoundsMessage as i, type ClickMessage as j, type CmssyLocaleContext as k, type FetchLikeResponse as l, type FetchPageOptions as m, type FieldType as n, type ParentReadyMessage as o, type PatchMessage as p, type RawLayoutBlock as q, type ReadyMessage as r, blocksToMeta as s, blocksToSchemas as t, buildBlockContext as u, buildBlockMap as v, defineBlock as w, fetchLayouts as x, fetchPage as y, isProtocolCompatible as z };

package/dist/{registry-BoxAyw4_.d.ts → registry-suRGkEQs.d.ts}

@@ -44,6 +44,17 @@ declare function normalizeSlug(path: string | string[] | undefined): string;
 declare function fetchPage(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyPageData | null>;
 declare function fetchLayouts(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyLayoutGroup[]>;
 
+interface CmssyLocaleContext {
+    current: string;
+    default: string;
+    enabled: string[];
+}
+interface CmssyBlockContext {
+    locale: CmssyLocaleContext;
+    isPreview: boolean;
+}
+declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean): CmssyBlockContext;
+
 declare const PROTOCOL_VERSION = 1;
 type FieldType = "singleLine" | "multiLine" | "richText" | "numeric" | "date" | "media" | "link" | "select" | "multiselect" | "boolean" | "color" | "repeater";
 interface FieldDefinition {
@@ -164,6 +175,7 @@ interface BlockDefinition {
     props: Record<string, FieldDefinition>;
     component: ComponentType<{
         content: Record<string, unknown>;
+        context?: CmssyBlockContext;
     }>;
 }
 declare function defineBlock<C extends Record<string, unknown>>(def: {
@@ -175,10 +187,12 @@ declare function defineBlock<C extends Record<string, unknown>>(def: {
     props: Record<string, FieldDefinition>;
     component: ComponentType<{
         content: C;
+        context?: CmssyBlockContext;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
+    context?: CmssyBlockContext;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;
@@ -186,4 +200,4 @@ declare function blocksToMeta(blocks: BlockDefinition[], defaults?: {
     category?: string;
 }): Record<string, BlockMeta>;
 
-export { type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type EditorToAppMessage as E, type FieldDefinition as F, PROTOCOL_VERSION as P, type RawBlock as R, type SelectMessage as S, type BlockMeta as a, type BlockDefinition as b, type CmssyLayoutGroup as c, type FetchLike as d, type CmssyClientConfig as e, type BlockMap as f, type BlockRect as g, type BoundsMessage as h, type ClickMessage as i, type FetchLikeResponse as j, type FetchPageOptions as k, type FieldType as l, type ParentReadyMessage as m, type PatchMessage as n, type RawLayoutBlock as o, type ReadyMessage as p, blocksToMeta as q, blocksToSchemas as r, buildBlockMap as s, defineBlock as t, fetchLayouts as u, fetchPage as v, isProtocolCompatible as w, normalizeSlug as x };
+export { type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, normalizeSlug as D, type EditorToAppMessage as E, type FieldDefinition as F, PROTOCOL_VERSION as P, type RawBlock as R, type SelectMessage as S, type BlockMeta as a, type BlockDefinition as b, type CmssyLayoutGroup as c, type FetchLike as d, type CmssyClientConfig as e, type BlockMap as f, type CmssyBlockContext as g, type BlockRect as h, type BoundsMessage as i, type ClickMessage as j, type CmssyLocaleContext as k, type FetchLikeResponse as l, type FetchPageOptions as m, type FieldType as n, type ParentReadyMessage as o, type PatchMessage as p, type RawLayoutBlock as q, type ReadyMessage as r, blocksToMeta as s, blocksToSchemas as t, buildBlockContext as u, buildBlockMap as v, defineBlock as w, fetchLayouts as x, fetchPage as y, isProtocolCompatible as z };

package/package.json

@@ -1,6 +1,21 @@
 {
   "name": "@cmssy/react",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "description": "React blocks, renderers, data client and editor bridge for cmssy headless sites",
+  "keywords": [
+    "cmssy",
+    "cms",
+    "headless",
+    "react",
+    "blocks",
+    "graphql"
+  ],
+  "homepage": "https://cmssy.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmssy-io/cmssy-sdk.git",
+    "directory": "packages/react"
+  },
   "type": "module",
   "license": "MIT",
   "publishConfig": {