@cmssy/core 19.3.1 → 19.4.0

package/dist/{csp-BdigosQo.d.ts → csp-AofUvsVZ.d.ts}

@@ -1,5 +1,5 @@
 import { LayoutRegion, BlockPropsSchema, InferBlockContent, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { b as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-BGUsgy8p.js';
+import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-BHRDFyNF.js';
 
 interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
     readonly regions: R;

package/dist/{csp-GwcubV3k.d.cts → csp-eQsMxVsg.d.cts}

@@ -1,5 +1,5 @@
 import { LayoutRegion, BlockPropsSchema, InferBlockContent, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { b as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-DLGQgiu5.cjs';
+import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-DmMO2Cwk.cjs';
 
 interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
     readonly regions: R;

package/dist/index.cjs

@@ -225,7 +225,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -701,6 +701,17 @@ function buildBlockManifest(blocks, options = {}) {
     regions: options.regions ? layoutRegionsToBridge(options.regions) : null
   };
 }
+function isFormFieldVisible(field, values) {
+  return types.evaluateFieldConditionGroup(field.showWhen, values);
+}
+function visibleFormFields(fields2, values) {
+  return fields2.filter((field) => isFormFieldVisible(field, values));
+}
+function isFormFieldRequired(field, values) {
+  if (!isFormFieldVisible(field, values)) return false;
+  if (field.validation?.required === true) return true;
+  return field.requiredWhen != null && types.evaluateFieldConditionGroup(field.requiredWhen, values);
+}
 
 // src/data/localize-href.ts
 var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
@@ -1149,6 +1160,8 @@ exports.defineCmssyConfig = defineCmssyConfig;
 exports.defineCmssyLayout = defineCmssyLayout;
 exports.fields = fields;
 exports.graphqlRequest = graphqlRequest;
+exports.isFormFieldRequired = isFormFieldRequired;
+exports.isFormFieldVisible = isFormFieldVisible;
 exports.isProtocolCompatible = isProtocolCompatible;
 exports.isTransientRequestError = isTransientRequestError;
 exports.isVerifiedEditUrl = isVerifiedEditUrl;
@@ -1170,3 +1183,4 @@ exports.resolveEditorOrigin = resolveEditorOrigin;
 exports.typedOperation = typedOperation;
 exports.verifyCmssyEditToken = verifyCmssyEditToken;
 exports.verifyCmssyWebhook = verifyCmssyWebhook;
+exports.visibleFormFields = visibleFormFields;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-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 CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-GwcubV3k.cjs';
-export { C as CMSSY_LOCALE_HEADER, a as CmssyOperation, b as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-DLGQgiu5.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 CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-eQsMxVsg.cjs';
+export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-DmMO2Cwk.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, i as isTransientRequestError } from './content-client-DhcHP8ln.cjs';
 import * as _cmssy_types from '@cmssy/types';
-import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
+import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, CmssyFormField, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
 export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 /**
@@ -124,6 +124,11 @@ declare function buildBlockManifest(blocks: readonly BlockManifestSource[], opti
     regions?: readonly LayoutRegion[] | null;
 }): BlockManifest;
 
+type ConditionalFormField = Pick<CmssyFormField, "showWhen" | "requiredWhen" | "validation">;
+declare function isFormFieldVisible(field: Pick<ConditionalFormField, "showWhen">, values: Record<string, unknown>): boolean;
+declare function visibleFormFields<F extends Pick<ConditionalFormField, "showWhen">>(fields: readonly F[], values: Record<string, unknown>): F[];
+declare function isFormFieldRequired(field: ConditionalFormField, values: Record<string, unknown>): boolean;
+
 declare const CMSSY_EDIT_HEADER = "x-cmssy-edit";
 declare const CMSSY_EDIT_QUERY_PARAM = "cmssyEdit";
 declare const CMSSY_SECRET_QUERY_PARAM = "cmssySecret";
@@ -155,4 +160,4 @@ declare class CmssyWebhookError extends Error {
 }
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): Promise<CmssyWebhookEvent>;
 
-export { type BlockManifest, type BlockManifestBlock, type BlockManifestSource, CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, type MediaLike, type MintCmssyEditTokenOptions, type VerifyCmssyEditTokenOptions, blocksToMeta, blocksToSchemas, buildBlockManifest, fields, isVerifiedEditUrl, layoutRegionsToBridge, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, propsToSchema, registryToManifestBlocks, verifyCmssyEditToken, verifyCmssyWebhook };
+export { type BlockManifest, type BlockManifestBlock, type BlockManifestSource, CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, type ConditionalFormField, type MediaLike, type MintCmssyEditTokenOptions, type VerifyCmssyEditTokenOptions, blocksToMeta, blocksToSchemas, buildBlockManifest, fields, isFormFieldRequired, isFormFieldVisible, isVerifiedEditUrl, layoutRegionsToBridge, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, propsToSchema, registryToManifestBlocks, verifyCmssyEditToken, verifyCmssyWebhook, visibleFormFields };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-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 CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-BdigosQo.js';
-export { C as CMSSY_LOCALE_HEADER, a as CmssyOperation, b as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-BGUsgy8p.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 CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-AofUvsVZ.js';
+export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-BHRDFyNF.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, i as isTransientRequestError } from './content-client-DhcHP8ln.js';
 import * as _cmssy_types from '@cmssy/types';
-import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
+import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, CmssyFormField, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
 export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 /**
@@ -124,6 +124,11 @@ declare function buildBlockManifest(blocks: readonly BlockManifestSource[], opti
     regions?: readonly LayoutRegion[] | null;
 }): BlockManifest;
 
+type ConditionalFormField = Pick<CmssyFormField, "showWhen" | "requiredWhen" | "validation">;
+declare function isFormFieldVisible(field: Pick<ConditionalFormField, "showWhen">, values: Record<string, unknown>): boolean;
+declare function visibleFormFields<F extends Pick<ConditionalFormField, "showWhen">>(fields: readonly F[], values: Record<string, unknown>): F[];
+declare function isFormFieldRequired(field: ConditionalFormField, values: Record<string, unknown>): boolean;
+
 declare const CMSSY_EDIT_HEADER = "x-cmssy-edit";
 declare const CMSSY_EDIT_QUERY_PARAM = "cmssyEdit";
 declare const CMSSY_SECRET_QUERY_PARAM = "cmssySecret";
@@ -155,4 +160,4 @@ declare class CmssyWebhookError extends Error {
 }
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): Promise<CmssyWebhookEvent>;
 
-export { type BlockManifest, type BlockManifestBlock, type BlockManifestSource, CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, type MediaLike, type MintCmssyEditTokenOptions, type VerifyCmssyEditTokenOptions, blocksToMeta, blocksToSchemas, buildBlockManifest, fields, isVerifiedEditUrl, layoutRegionsToBridge, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, propsToSchema, registryToManifestBlocks, verifyCmssyEditToken, verifyCmssyWebhook };
+export { type BlockManifest, type BlockManifestBlock, type BlockManifestSource, CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, type ConditionalFormField, type MediaLike, type MintCmssyEditTokenOptions, type VerifyCmssyEditTokenOptions, blocksToMeta, blocksToSchemas, buildBlockManifest, fields, isFormFieldRequired, isFormFieldVisible, isVerifiedEditUrl, layoutRegionsToBridge, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, propsToSchema, registryToManifestBlocks, verifyCmssyEditToken, verifyCmssyWebhook, visibleFormFields };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { brandingFieldNames, mediaTypeValues, LAYOUT_REGIONS_MAX, LAYOUT_REGION_ID_PATTERN, LAYOUT_REGION_LABEL_MAX } from '@cmssy/types';
+import { brandingFieldNames, mediaTypeValues, LAYOUT_REGIONS_MAX, LAYOUT_REGION_ID_PATTERN, LAYOUT_REGION_LABEL_MAX, evaluateFieldConditionGroup } from '@cmssy/types';
 export { MediaType, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 // src/config.ts
@@ -224,7 +224,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -700,6 +700,17 @@ function buildBlockManifest(blocks, options = {}) {
     regions: options.regions ? layoutRegionsToBridge(options.regions) : null
   };
 }
+function isFormFieldVisible(field, values) {
+  return evaluateFieldConditionGroup(field.showWhen, values);
+}
+function visibleFormFields(fields2, values) {
+  return fields2.filter((field) => isFormFieldVisible(field, values));
+}
+function isFormFieldRequired(field, values) {
+  if (!isFormFieldVisible(field, values)) return false;
+  if (field.validation?.required === true) return true;
+  return field.requiredWhen != null && evaluateFieldConditionGroup(field.requiredWhen, values);
+}
 
 // src/data/localize-href.ts
 var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
@@ -1114,4 +1125,4 @@ async function verifyCmssyWebhook(options) {
   return parsed;
 }
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, 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, blocksToMeta, blocksToSchemas, buildBlockManifest, createCmssyClient, defineCmssyConfig, defineCmssyLayout, fields, graphqlRequest, isProtocolCompatible, isTransientRequestError, isVerifiedEditUrl, layoutRegionsToBridge, localizeHref, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, normalizeOrigin, parseEditorMessage, postToEditor, propsToSchema, registryToManifestBlocks, resolveCmssyLocale, resolveEditorOrigin, typedOperation, verifyCmssyEditToken, verifyCmssyWebhook };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, 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, blocksToMeta, blocksToSchemas, buildBlockManifest, createCmssyClient, defineCmssyConfig, defineCmssyLayout, fields, graphqlRequest, isFormFieldRequired, isFormFieldVisible, isProtocolCompatible, isTransientRequestError, isVerifiedEditUrl, layoutRegionsToBridge, localizeHref, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, normalizeOrigin, parseEditorMessage, postToEditor, propsToSchema, registryToManifestBlocks, resolveCmssyLocale, resolveEditorOrigin, typedOperation, verifyCmssyEditToken, verifyCmssyWebhook, visibleFormFields };

package/dist/internal/locale.cjs

@@ -154,7 +154,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts

package/dist/internal/locale.d.cts

@@ -1,4 +1,4 @@
-export { C as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-DLGQgiu5.cjs';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-DmMO2Cwk.cjs';
 export { CmssySiteLocales } from '@cmssy/types';
 import '../content-client-DhcHP8ln.cjs';
 

package/dist/internal/locale.d.ts

@@ -1,4 +1,4 @@
-export { C as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-BGUsgy8p.js';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-BHRDFyNF.js';
 export { CmssySiteLocales } from '@cmssy/types';
 import '../content-client-DhcHP8ln.js';
 

package/dist/internal/locale.js

@@ -152,7 +152,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts

package/dist/internal.cjs

@@ -154,7 +154,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts

package/dist/internal.d.cts

@@ -1,10 +1,10 @@
 export { g as fetchLayouts, h as fetchPage, j as fetchPageById, k as fetchPageMeta, l as fetchPages, r as resolveApiUrl } from './content-client-DhcHP8ln.cjs';
 import { CmssyFormDefinition, CmssyModelDefinition, CmssyRecordList, CmssySiteConfig, CmssyFormSubmitResponse, SubmitFormInput, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, FieldDefinition, RawBlock, CmssyLayoutGroup } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { a as CmssyOperation, G as GraphqlRequestOptions } from './locale-DLGQgiu5.cjs';
-export { C as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-DLGQgiu5.cjs';
-import { Q as QueryScopedOptions } from './csp-GwcubV3k.cjs';
-export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-GwcubV3k.cjs';
+import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-DmMO2Cwk.cjs';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-DmMO2Cwk.cjs';
+import { Q as QueryScopedOptions } from './csp-eQsMxVsg.cjs';
+export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-eQsMxVsg.cjs';
 export { localizedPath } from './internal/locale.cjs';
 
 interface SiteConfigVariables {

package/dist/internal.d.ts

@@ -1,10 +1,10 @@
 export { g as fetchLayouts, h as fetchPage, j as fetchPageById, k as fetchPageMeta, l as fetchPages, r as resolveApiUrl } from './content-client-DhcHP8ln.js';
 import { CmssyFormDefinition, CmssyModelDefinition, CmssyRecordList, CmssySiteConfig, CmssyFormSubmitResponse, SubmitFormInput, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, FieldDefinition, RawBlock, CmssyLayoutGroup } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { a as CmssyOperation, G as GraphqlRequestOptions } from './locale-BGUsgy8p.js';
-export { C as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-BGUsgy8p.js';
-import { Q as QueryScopedOptions } from './csp-BdigosQo.js';
-export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-BdigosQo.js';
+import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-BHRDFyNF.js';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-BHRDFyNF.js';
+import { Q as QueryScopedOptions } from './csp-AofUvsVZ.js';
+export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-AofUvsVZ.js';
 export { localizedPath } from './internal/locale.js';
 
 interface SiteConfigVariables {

package/dist/internal.js

@@ -152,7 +152,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.3.1" ;
+var CMSSY_CORE_VERSION = "19.4.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts

package/dist/{locale-BGUsgy8p.d.ts → locale-BHRDFyNF.d.ts}

@@ -36,4 +36,4 @@ declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | un
 }>;
 declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
 
-export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, type CmssyOperation as a, type CmssyOperationInput as b, type CmssyTypedDocument as c, localeForPath as d, localeForPathname as e, resolveSiteLocales as f, graphqlRequest as g, splitLocaleFromPath as h, localizeHref as l, resolveCmssyLocale as r, splitCmssyLocale as s, typedOperation as t };
+export { type CmssyOperationInput as C, type GraphqlRequestOptions as G, CMSSY_LOCALE_HEADER as a, type CmssyOperation as b, type CmssyTypedDocument as c, localeForPath as d, localeForPathname as e, resolveSiteLocales as f, graphqlRequest as g, splitLocaleFromPath as h, localizeHref as l, resolveCmssyLocale as r, splitCmssyLocale as s, typedOperation as t };

package/dist/{locale-DLGQgiu5.d.cts → locale-DmMO2Cwk.d.cts}

@@ -36,4 +36,4 @@ declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | un
 }>;
 declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
 
-export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, type CmssyOperation as a, type CmssyOperationInput as b, type CmssyTypedDocument as c, localeForPath as d, localeForPathname as e, resolveSiteLocales as f, graphqlRequest as g, splitLocaleFromPath as h, localizeHref as l, resolveCmssyLocale as r, splitCmssyLocale as s, typedOperation as t };
+export { type CmssyOperationInput as C, type GraphqlRequestOptions as G, CMSSY_LOCALE_HEADER as a, type CmssyOperation as b, type CmssyTypedDocument as c, localeForPath as d, localeForPathname as e, resolveSiteLocales as f, graphqlRequest as g, splitLocaleFromPath as h, localizeHref as l, resolveCmssyLocale as r, splitCmssyLocale as s, typedOperation as t };

package/dist/preflight.cjs

@@ -151,6 +151,10 @@ function documentText(document) {
   );
 }
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/content/content-client.ts
 var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
 function resolveApiUrl(apiUrl) {
@@ -348,7 +352,10 @@ async function postPreflightQuery(config, query, variables) {
   try {
     response = await doFetch(url, {
       method: "POST",
-      headers: { "content-type": "application/json" },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT
+      },
       body: JSON.stringify({ query: documentText(query), variables })
     });
   } catch (error) {
@@ -454,11 +461,10 @@ async function checkDraftSecret(config) {
       fix: `copy the draft secret from ${SETTINGS_PATH}`
     };
   }
-  const outcome = await postPreflightQuery(
-    config,
-    DRAFT_SECRET_VALID_QUERY,
-    { workspaceSlug: config.workspaceSlug, secret }
-  );
+  const outcome = await postPreflightQuery(config, DRAFT_SECRET_VALID_QUERY, {
+    workspaceSlug: config.workspaceSlug,
+    secret
+  });
   if (outcome.kind === "network") {
     return {
       status: "unknown",
@@ -500,15 +506,20 @@ function parseOrigin(value) {
     return null;
   }
 }
-var LOCAL_HOSTNAMES = ["localhost", "127.0.0.1"];
-function previewUrlFix(devOrigin) {
-  let hostname = null;
+function isLocalHostname(hostname) {
+  const host = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  return host === "localhost" || host.endsWith(".localhost") || host === "127.0.0.1" || host === "::1";
+}
+function isLocalOrigin(origin) {
+  if (!origin) return false;
   try {
-    hostname = new URL(devOrigin).hostname;
+    return isLocalHostname(new URL(origin).hostname);
   } catch {
-    hostname = null;
+    return false;
   }
-  if (hostname && LOCAL_HOSTNAMES.includes(hostname)) {
+}
+function previewUrlFix(devOrigin) {
+  if (isLocalOrigin(parseOrigin(devOrigin))) {
     return `toggle dev mode in the editor and enter ${devOrigin} there - ${SETTINGS_PATH} holds the shared preview URL of the DEPLOYED site, not your machine`;
   }
   return `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`;
@@ -537,6 +548,13 @@ function checkPreviewUrl(previewUrl, devOrigin) {
       message: `the workspace preview URL matches ${devOrigin}`
     };
   }
+  if (isLocalOrigin(localOrigin)) {
+    return {
+      status: "unknown",
+      message: `the workspace preview URL is ${previewOrigin}; whether the editor reaches ${devOrigin} depends on the dev-mode switch, which overrides the shared preview URL and cannot be read from here`,
+      fix: previewUrlFix(devOrigin)
+    };
+  }
   return {
     status: "fail",
     message: `the workspace preview URL is ${previewOrigin} but your dev server runs at ${devOrigin}`,

package/dist/preflight.js

@@ -149,6 +149,10 @@ function documentText(document) {
   );
 }
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/content/content-client.ts
 var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
 function resolveApiUrl(apiUrl) {
@@ -346,7 +350,10 @@ async function postPreflightQuery(config, query, variables) {
   try {
     response = await doFetch(url, {
       method: "POST",
-      headers: { "content-type": "application/json" },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT
+      },
       body: JSON.stringify({ query: documentText(query), variables })
     });
   } catch (error) {
@@ -452,11 +459,10 @@ async function checkDraftSecret(config) {
       fix: `copy the draft secret from ${SETTINGS_PATH}`
     };
   }
-  const outcome = await postPreflightQuery(
-    config,
-    DRAFT_SECRET_VALID_QUERY,
-    { workspaceSlug: config.workspaceSlug, secret }
-  );
+  const outcome = await postPreflightQuery(config, DRAFT_SECRET_VALID_QUERY, {
+    workspaceSlug: config.workspaceSlug,
+    secret
+  });
   if (outcome.kind === "network") {
     return {
       status: "unknown",
@@ -498,15 +504,20 @@ function parseOrigin(value) {
     return null;
   }
 }
-var LOCAL_HOSTNAMES = ["localhost", "127.0.0.1"];
-function previewUrlFix(devOrigin) {
-  let hostname = null;
+function isLocalHostname(hostname) {
+  const host = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  return host === "localhost" || host.endsWith(".localhost") || host === "127.0.0.1" || host === "::1";
+}
+function isLocalOrigin(origin) {
+  if (!origin) return false;
   try {
-    hostname = new URL(devOrigin).hostname;
+    return isLocalHostname(new URL(origin).hostname);
   } catch {
-    hostname = null;
+    return false;
   }
-  if (hostname && LOCAL_HOSTNAMES.includes(hostname)) {
+}
+function previewUrlFix(devOrigin) {
+  if (isLocalOrigin(parseOrigin(devOrigin))) {
     return `toggle dev mode in the editor and enter ${devOrigin} there - ${SETTINGS_PATH} holds the shared preview URL of the DEPLOYED site, not your machine`;
   }
   return `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`;
@@ -535,6 +546,13 @@ function checkPreviewUrl(previewUrl, devOrigin) {
       message: `the workspace preview URL matches ${devOrigin}`
     };
   }
+  if (isLocalOrigin(localOrigin)) {
+    return {
+      status: "unknown",
+      message: `the workspace preview URL is ${previewOrigin}; whether the editor reaches ${devOrigin} depends on the dev-mode switch, which overrides the shared preview URL and cannot be read from here`,
+      fix: previewUrlFix(devOrigin)
+    };
+  }
   return {
     status: "fail",
     message: `the workspace preview URL is ${previewOrigin} but your dev server runs at ${devOrigin}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/core",
-  "version": "19.3.1",
+  "version": "19.4.0",
   "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",