@cmssy/core 12.14.1 → 13.0.0

package/dist/{csp-BnOiGUhR.d.ts → csp-9BjyqMRU.d.ts}

@@ -1,10 +1,17 @@
-import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
+import { LayoutRegion, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-D9KI4bND.js';
 
+interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
+    readonly regions: R;
+}
+type CmssyRegion<L extends CmssyLayout> = L["regions"][number]["id"];
+declare function defineCmssyLayout<const R extends readonly LayoutRegion[]>(layout: CmssyLayout<R>): CmssyLayout<R>;
+declare function layoutRegionIds(layout: CmssyLayout | undefined): string[];
+
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;
 declare function resolveEditorOrigin(editorOrigin: string | string[] | undefined): string | string[];
-interface CmssyConfig {
+interface CmssyConfig<L extends CmssyLayout = CmssyLayout> {
     apiUrl?: string;
     org: string;
     workspaceSlug: string;
@@ -13,13 +20,15 @@ interface CmssyConfig {
     editorOrigin?: string | string[];
     siteUrl?: string;
     resolveLocale?: () => string | Promise<string>;
+    layout?: L;
 }
-type CmssyEnvConfig = Omit<CmssyConfig, "org" | "workspaceSlug" | "draftSecret"> & {
+type CmssyRegionOf<C extends CmssyConfig> = NonNullable<C["layout"]>["regions"][number]["id"];
+type CmssyEnvConfig<L extends CmssyLayout = CmssyLayout> = Omit<CmssyConfig<L>, "org" | "workspaceSlug" | "draftSecret"> & {
     org?: string;
     workspaceSlug?: string;
     draftSecret?: string;
 };
-declare function defineCmssyConfig(config: CmssyEnvConfig): CmssyConfig;
+declare function defineCmssyConfig<L extends CmssyLayout = CmssyLayout>(config: CmssyEnvConfig<L>): CmssyConfig<L>;
 
 interface CmssyTypedDocument<Result, Variables> {
     __apiType?: (variables: Variables) => Result;
@@ -54,6 +63,7 @@ interface ReadyMessage {
     schemas: Record<string, BlockSchema>;
     blockMeta?: Record<string, BlockMeta>;
     capabilities?: string[];
+    layoutRegions?: LayoutRegion[];
 }
 interface BoundsMessage {
     type: "cmssy:bounds";
@@ -173,4 +183,4 @@ declare function toCspOrigin(origin: string): string;
 declare function cmssyCspHeaders(options: CmssyCspOptions): Record<string, string>;
 declare function applyCmssyCsp<T extends MutableHeaders>(response: T, options: CmssyCspOptions): T;
 
-export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, type InvisibleBlock as I, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, SHORTCUT_ACTIONS as S, type ViewportMessage as V, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyTypedDocument as e, type InvisibleBlocksMessage as f, type ParentReadyMessage as g, type PatchMessage as h, type PostTarget as i, type SelectMessage as j, type ShortcutAction as k, type ShortcutMessage as l, applyCmssyCsp as m, createCmssyClient as n, defineCmssyConfig as o, isProtocolCompatible as p, normalizeOrigin as q, parseEditorMessage as r, postToEditor as s, resolveEditorOrigin as t, cmssyCspHeaders as u, isDevelopment as v, resolveInitialTarget as w, toCspOrigin as x };
+export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, layoutRegionIds as F, resolveInitialTarget as G, toCspOrigin as H, type InvisibleBlock as I, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, SHORTCUT_ACTIONS as S, type ViewportMessage as V, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyLayout as e, type CmssyRegion as f, type CmssyRegionOf as g, type CmssyTypedDocument as h, type InvisibleBlocksMessage as i, type ParentReadyMessage as j, type PatchMessage as k, type PostTarget as l, type SelectMessage as m, type ShortcutAction as n, type ShortcutMessage as o, applyCmssyCsp as p, createCmssyClient as q, defineCmssyConfig as r, defineCmssyLayout as s, isProtocolCompatible as t, normalizeOrigin as u, parseEditorMessage as v, postToEditor as w, resolveEditorOrigin as x, cmssyCspHeaders as y, isDevelopment as z };

package/dist/{csp-RaStdD2i.d.cts → csp-hHuxKdMJ.d.cts}

@@ -1,10 +1,17 @@
-import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
+import { LayoutRegion, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-JyBHqpAQ.cjs';
 
+interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
+    readonly regions: R;
+}
+type CmssyRegion<L extends CmssyLayout> = L["regions"][number]["id"];
+declare function defineCmssyLayout<const R extends readonly LayoutRegion[]>(layout: CmssyLayout<R>): CmssyLayout<R>;
+declare function layoutRegionIds(layout: CmssyLayout | undefined): string[];
+
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;
 declare function resolveEditorOrigin(editorOrigin: string | string[] | undefined): string | string[];
-interface CmssyConfig {
+interface CmssyConfig<L extends CmssyLayout = CmssyLayout> {
     apiUrl?: string;
     org: string;
     workspaceSlug: string;
@@ -13,13 +20,15 @@ interface CmssyConfig {
     editorOrigin?: string | string[];
     siteUrl?: string;
     resolveLocale?: () => string | Promise<string>;
+    layout?: L;
 }
-type CmssyEnvConfig = Omit<CmssyConfig, "org" | "workspaceSlug" | "draftSecret"> & {
+type CmssyRegionOf<C extends CmssyConfig> = NonNullable<C["layout"]>["regions"][number]["id"];
+type CmssyEnvConfig<L extends CmssyLayout = CmssyLayout> = Omit<CmssyConfig<L>, "org" | "workspaceSlug" | "draftSecret"> & {
     org?: string;
     workspaceSlug?: string;
     draftSecret?: string;
 };
-declare function defineCmssyConfig(config: CmssyEnvConfig): CmssyConfig;
+declare function defineCmssyConfig<L extends CmssyLayout = CmssyLayout>(config: CmssyEnvConfig<L>): CmssyConfig<L>;
 
 interface CmssyTypedDocument<Result, Variables> {
     __apiType?: (variables: Variables) => Result;
@@ -54,6 +63,7 @@ interface ReadyMessage {
     schemas: Record<string, BlockSchema>;
     blockMeta?: Record<string, BlockMeta>;
     capabilities?: string[];
+    layoutRegions?: LayoutRegion[];
 }
 interface BoundsMessage {
     type: "cmssy:bounds";
@@ -173,4 +183,4 @@ declare function toCspOrigin(origin: string): string;
 declare function cmssyCspHeaders(options: CmssyCspOptions): Record<string, string>;
 declare function applyCmssyCsp<T extends MutableHeaders>(response: T, options: CmssyCspOptions): T;
 
-export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, type InvisibleBlock as I, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, SHORTCUT_ACTIONS as S, type ViewportMessage as V, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyTypedDocument as e, type InvisibleBlocksMessage as f, type ParentReadyMessage as g, type PatchMessage as h, type PostTarget as i, type SelectMessage as j, type ShortcutAction as k, type ShortcutMessage as l, applyCmssyCsp as m, createCmssyClient as n, defineCmssyConfig as o, isProtocolCompatible as p, normalizeOrigin as q, parseEditorMessage as r, postToEditor as s, resolveEditorOrigin as t, cmssyCspHeaders as u, isDevelopment as v, resolveInitialTarget as w, toCspOrigin as x };
+export { type AppToEditorMessage as A, type BoundsMessage as B, type ClickMessage as C, DEFAULT_CMSSY_EDITOR_ORIGINS as D, type EditorToAppMessage as E, layoutRegionIds as F, resolveInitialTarget as G, toCspOrigin as H, type InvisibleBlock as I, PROTOCOL_VERSION as P, type QueryScopedOptions as Q, type ReadyMessage as R, SHORTCUT_ACTIONS as S, type ViewportMessage as V, type CmssyClient as a, type CmssyConfig as b, type CmssyCspOptions as c, type CmssyEnvConfig as d, type CmssyLayout as e, type CmssyRegion as f, type CmssyRegionOf as g, type CmssyTypedDocument as h, type InvisibleBlocksMessage as i, type ParentReadyMessage as j, type PatchMessage as k, type PostTarget as l, type SelectMessage as m, type ShortcutAction as n, type ShortcutMessage as o, applyCmssyCsp as p, createCmssyClient as q, defineCmssyConfig as r, defineCmssyLayout as s, isProtocolCompatible as t, normalizeOrigin as u, parseEditorMessage as v, postToEditor as w, resolveEditorOrigin as x, cmssyCspHeaders as y, isDevelopment as z };

package/dist/index.cjs

@@ -580,6 +580,37 @@ function mediaUrls(value) {
 function mediaAlt(value) {
   return typeof value === "string" ? void 0 : value?.alt;
 }
+function defineCmssyLayout(layout) {
+  const regions = layout.regions;
+  if (!Array.isArray(regions) || regions.length === 0) {
+    throw new Error("cmssy: defineCmssyLayout needs at least one region");
+  }
+  if (regions.length > types.LAYOUT_REGIONS_MAX) {
+    throw new Error(
+      `cmssy: a layout declares at most ${types.LAYOUT_REGIONS_MAX} regions, got ${regions.length}`
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const region of regions) {
+    if (typeof region.id !== "string" || !types.LAYOUT_REGION_ID_PATTERN.test(region.id)) {
+      throw new Error(
+        `cmssy: layout region id ${JSON.stringify(region.id)} must match ${types.LAYOUT_REGION_ID_PATTERN}`
+      );
+    }
+    if (seen.has(region.id)) {
+      throw new Error(`cmssy: layout region "${region.id}" is declared twice`);
+    }
+    seen.add(region.id);
+    if (region.label !== void 0) {
+      if (typeof region.label !== "string" || region.label.trim().length === 0 || region.label.length > types.LAYOUT_REGION_LABEL_MAX) {
+        throw new Error(
+          `cmssy: layout region "${region.id}" label must be 1-${types.LAYOUT_REGION_LABEL_MAX} characters`
+        );
+      }
+    }
+  }
+  return { regions };
+}
 
 // src/data/localize-href.ts
 var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
@@ -958,10 +989,6 @@ Object.defineProperty(exports, "evaluateFieldConditionGroup", {
   enumerable: true,
   get: function () { return types.evaluateFieldConditionGroup; }
 });
-Object.defineProperty(exports, "layoutPositionValues", {
-  enumerable: true,
-  get: function () { return types.layoutPositionValues; }
-});
 exports.CMSSY_EDIT_HEADER = CMSSY_EDIT_HEADER;
 exports.CMSSY_EDIT_QUERY_PARAM = CMSSY_EDIT_QUERY_PARAM;
 exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
@@ -977,6 +1004,7 @@ exports.SHORTCUT_ACTIONS = SHORTCUT_ACTIONS;
 exports.applyCmssyCsp = applyCmssyCsp;
 exports.createCmssyClient = createCmssyClient;
 exports.defineCmssyConfig = defineCmssyConfig;
+exports.defineCmssyLayout = defineCmssyLayout;
 exports.fields = fields;
 exports.graphqlRequest = graphqlRequest;
 exports.isProtocolCompatible = isProtocolCompatible;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, f as InvisibleBlocksMessage, P as PROTOCOL_VERSION, g as ParentReadyMessage, h as PatchMessage, i as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, j as SelectMessage, k as ShortcutAction, l as ShortcutMessage, V as ViewportMessage, m as applyCmssyCsp, n as createCmssyClient, o as defineCmssyConfig, p as isProtocolCompatible, q as normalizeOrigin, r as parseEditorMessage, s as postToEditor, t as resolveEditorOrigin } from './csp-RaStdD2i.cjs';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, i as InvisibleBlocksMessage, P as PROTOCOL_VERSION, j as ParentReadyMessage, k as PatchMessage, l as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, m as SelectMessage, n as ShortcutAction, o as ShortcutMessage, V as ViewportMessage, p as applyCmssyCsp, q as createCmssyClient, r as defineCmssyConfig, s as defineCmssyLayout, t as isProtocolCompatible, u as normalizeOrigin, v as parseEditorMessage, w as postToEditor, x as resolveEditorOrigin } from './csp-hHuxKdMJ.cjs';
 export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale } from './locale-JyBHqpAQ.cjs';
 export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyRequestError, c as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, d as FetchLikeResponse, e as FetchPageOptions, R as RetryOption, f as RetryPolicy } from './content-client-65N8ZRq9.cjs';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, LayoutPosition, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, layoutPositionValues } from '@cmssy/types';
+export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, LayoutPosition, LayoutRegion, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
 
 /**
  * Whether the content is guaranteed to carry the field. Only `required` says

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, f as InvisibleBlocksMessage, P as PROTOCOL_VERSION, g as ParentReadyMessage, h as PatchMessage, i as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, j as SelectMessage, k as ShortcutAction, l as ShortcutMessage, V as ViewportMessage, m as applyCmssyCsp, n as createCmssyClient, o as defineCmssyConfig, p as isProtocolCompatible, q as normalizeOrigin, r as parseEditorMessage, s as postToEditor, t as resolveEditorOrigin } from './csp-BnOiGUhR.js';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyTypedDocument, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, i as InvisibleBlocksMessage, P as PROTOCOL_VERSION, j as ParentReadyMessage, k as PatchMessage, l as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, m as SelectMessage, n as ShortcutAction, o as ShortcutMessage, V as ViewportMessage, p as applyCmssyCsp, q as createCmssyClient, r as defineCmssyConfig, s as defineCmssyLayout, t as isProtocolCompatible, u as normalizeOrigin, v as parseEditorMessage, w as postToEditor, x as resolveEditorOrigin } from './csp-9BjyqMRU.js';
 export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale } from './locale-D9KI4bND.js';
 export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyRequestError, c as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, d as FetchLikeResponse, e as FetchPageOptions, R as RetryOption, f as RetryPolicy } from './content-client-65N8ZRq9.js';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, LayoutPosition, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, layoutPositionValues } from '@cmssy/types';
+export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, LayoutPosition, LayoutRegion, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
 
 /**
  * Whether the content is guaranteed to carry the field. Only `required` says

package/dist/index.js

@@ -1,4 +1,5 @@
-export { evaluateFieldConditionGroup, layoutPositionValues } from '@cmssy/types';
+import { LAYOUT_REGIONS_MAX, LAYOUT_REGION_ID_PATTERN, LAYOUT_REGION_LABEL_MAX } from '@cmssy/types';
+export { evaluateFieldConditionGroup } from '@cmssy/types';
 
 // src/config.ts
 var DEFAULT_CMSSY_EDITOR_ORIGINS = [
@@ -578,6 +579,37 @@ function mediaUrls(value) {
 function mediaAlt(value) {
   return typeof value === "string" ? void 0 : value?.alt;
 }
+function defineCmssyLayout(layout) {
+  const regions = layout.regions;
+  if (!Array.isArray(regions) || regions.length === 0) {
+    throw new Error("cmssy: defineCmssyLayout needs at least one region");
+  }
+  if (regions.length > LAYOUT_REGIONS_MAX) {
+    throw new Error(
+      `cmssy: a layout declares at most ${LAYOUT_REGIONS_MAX} regions, got ${regions.length}`
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const region of regions) {
+    if (typeof region.id !== "string" || !LAYOUT_REGION_ID_PATTERN.test(region.id)) {
+      throw new Error(
+        `cmssy: layout region id ${JSON.stringify(region.id)} must match ${LAYOUT_REGION_ID_PATTERN}`
+      );
+    }
+    if (seen.has(region.id)) {
+      throw new Error(`cmssy: layout region "${region.id}" is declared twice`);
+    }
+    seen.add(region.id);
+    if (region.label !== void 0) {
+      if (typeof region.label !== "string" || region.label.trim().length === 0 || region.label.length > LAYOUT_REGION_LABEL_MAX) {
+        throw new Error(
+          `cmssy: layout region "${region.id}" label must be 1-${LAYOUT_REGION_LABEL_MAX} characters`
+        );
+      }
+    }
+  }
+  return { regions };
+}
 
 // src/data/localize-href.ts
 var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
@@ -952,4 +984,4 @@ async function verifyCmssyWebhook(options) {
   return parsed;
 }
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_RATE_LIMIT_WINDOW_MS, CMSSY_RETRY_MODES, CMSSY_SECRET_QUERY_PARAM, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, SHORTCUT_ACTIONS, applyCmssyCsp, createCmssyClient, defineCmssyConfig, fields, graphqlRequest, isProtocolCompatible, isVerifiedEditUrl, localizeHref, mediaAlt, mediaUrl, mediaUrls, normalizeOrigin, parseEditorMessage, postToEditor, resolveCmssyLocale, resolveEditorOrigin, verifyCmssyWebhook };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_RATE_LIMIT_WINDOW_MS, CMSSY_RETRY_MODES, CMSSY_SECRET_QUERY_PARAM, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, SHORTCUT_ACTIONS, applyCmssyCsp, createCmssyClient, defineCmssyConfig, defineCmssyLayout, fields, graphqlRequest, isProtocolCompatible, isVerifiedEditUrl, localizeHref, mediaAlt, mediaUrl, mediaUrls, normalizeOrigin, parseEditorMessage, postToEditor, resolveCmssyLocale, resolveEditorOrigin, verifyCmssyWebhook };

package/dist/internal.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var types = require('@cmssy/types');
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -1299,6 +1301,9 @@ var CMSSY_DELIVERY_OPERATIONS = [
     document: SUBMIT_FORM_MUTATION
   }
 ];
+function layoutRegionIds(layout) {
+  return (layout?.regions ?? types.DEFAULT_LAYOUT_REGIONS).map((region) => region.id);
+}
 
 exports.CMSSY_DELIVERY_OPERATIONS = CMSSY_DELIVERY_OPERATIONS;
 exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
@@ -1321,6 +1326,7 @@ exports.fetchPages = fetchPages;
 exports.fetchSiteConfig = fetchSiteConfig;
 exports.getBlockContentForLanguage = getBlockContentForLanguage;
 exports.isDevelopment = isDevelopment;
+exports.layoutRegionIds = layoutRegionIds;
 exports.localeForPath = localeForPath;
 exports.localeForPathname = localeForPathname;
 exports.localizeHref = localizeHref;

package/dist/internal.d.cts

@@ -3,8 +3,8 @@ import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyCl
 export { CmssySiteLocales } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-JyBHqpAQ.cjs';
 export { C as CMSSY_LOCALE_HEADER, a as localeForPath, b as localeForPathname, l as localizeHref, c as resolveSiteLocales, s as splitCmssyLocale, d as splitLocaleFromPath } from './locale-JyBHqpAQ.cjs';
-import { Q as QueryScopedOptions } from './csp-RaStdD2i.cjs';
-export { u as cmssyCspHeaders, v as isDevelopment, w as resolveInitialTarget, x as toCspOrigin } from './csp-RaStdD2i.cjs';
+import { Q as QueryScopedOptions } from './csp-hHuxKdMJ.cjs';
+export { y as cmssyCspHeaders, z as isDevelopment, F as layoutRegionIds, G as resolveInitialTarget, H as toCspOrigin } from './csp-hHuxKdMJ.cjs';
 export { localizedPath } from './internal/locale.cjs';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        logoDarkUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.d.ts

@@ -3,8 +3,8 @@ import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyCl
 export { CmssySiteLocales } from '@cmssy/types';
 import { G as GraphqlRequestOptions } from './locale-D9KI4bND.js';
 export { C as CMSSY_LOCALE_HEADER, a as localeForPath, b as localeForPathname, l as localizeHref, c as resolveSiteLocales, s as splitCmssyLocale, d as splitLocaleFromPath } from './locale-D9KI4bND.js';
-import { Q as QueryScopedOptions } from './csp-BnOiGUhR.js';
-export { u as cmssyCspHeaders, v as isDevelopment, w as resolveInitialTarget, x as toCspOrigin } from './csp-BnOiGUhR.js';
+import { Q as QueryScopedOptions } from './csp-9BjyqMRU.js';
+export { y as cmssyCspHeaders, z as isDevelopment, F as layoutRegionIds, G as resolveInitialTarget, H as toCspOrigin } from './csp-9BjyqMRU.js';
 export { localizedPath } from './internal/locale.js';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        logoDarkUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.js

@@ -1,3 +1,5 @@
+import { DEFAULT_LAYOUT_REGIONS } from '@cmssy/types';
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -1297,5 +1299,8 @@ var CMSSY_DELIVERY_OPERATIONS = [
     document: SUBMIT_FORM_MUTATION
   }
 ];
+function layoutRegionIds(layout) {
+  return (layout?.regions ?? DEFAULT_LAYOUT_REGIONS).map((region) => region.id);
+}
 
-export { CMSSY_DELIVERY_OPERATIONS, CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, localeForPath, localeForPathname, localizeHref, localizedPath, normalizeBlockContent, resolveApiUrl, resolveForms, resolveInitialTarget, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };
+export { CMSSY_DELIVERY_OPERATIONS, CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, layoutRegionIds, localeForPath, localeForPathname, localizeHref, localizedPath, normalizeBlockContent, resolveApiUrl, resolveForms, resolveInitialTarget, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/core",
-  "version": "12.14.1",
+  "version": "13.0.0",
   "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",
@@ -87,7 +87,7 @@
     "vitest": "^2.1.0"
   },
   "dependencies": {
-    "@cmssy/types": "0.35.0",
+    "@cmssy/types": "0.37.0",
     "jose": "^6.2.3"
   },
   "scripts": {