@cmssy/core 10.0.0 → 10.2.0

package/dist/{csp-DpssAFJC.d.ts → csp-Blh6P15m.d.ts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './graphql-request-CDh6IRok.js';
+import { G as GraphqlRequestOptions } from './locale-XintNd0n.js';
 
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;

package/dist/{csp-DDVG6VAm.d.cts → csp-DlAEXYjA.d.cts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './graphql-request-NQxSMt6v.cjs';
+import { G as GraphqlRequestOptions } from './locale-rhYcXU5z.cjs';
 
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;

package/dist/index.cjs

@@ -323,21 +323,43 @@ var fields = {
   }
 };
 
-// src/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms, extra) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms,
-    ...extra?.auth ? { auth: extra.auth } : {},
-    ...extra?.workspace ? { workspace: extra.workspace } : {}
-  };
+// src/data/localize-href.ts
+var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
+function isExternalHref(href) {
+  const value = href.trim();
+  if (!value) return true;
+  if (value.startsWith("#")) return true;
+  return PROTOCOL_OR_RELATIVE.test(value);
+}
+function stripLeadingLocale(path, locale) {
+  const segments = path.split("/");
+  const first = segments[1];
+  if (first && first !== locale.default && locale.enabled.includes(first)) {
+    segments.splice(1, 1);
+    const rest = segments.join("/");
+    return rest === "" ? "/" : rest;
+  }
+  return path;
+}
+function addLocalePrefix(path, target, locale) {
+  if (target === locale.default) return path;
+  if (path === "/") return `/${target}`;
+  return `/${target}${path}`;
+}
+function localizeHref(href, locale) {
+  const value = href.trim();
+  if (isExternalHref(value)) return href;
+  const boundary = value.search(/[?#]/);
+  const path = boundary === -1 ? value : value.slice(0, boundary);
+  const suffix = boundary === -1 ? "" : value.slice(boundary);
+  if (!path.startsWith("/")) return href;
+  const bare = stripLeadingLocale(path, locale);
+  return `${addLocalePrefix(bare, locale.current, locale)}${suffix}`;
 }
 
+// src/locale.ts
+var CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+
 // src/bridge/protocol.ts
 var PROTOCOL_VERSION = 2;
 function isProtocolCompatible(version) {
@@ -596,6 +618,7 @@ Object.defineProperty(exports, "evaluateFieldConditionGroup", {
 });
 exports.CMSSY_EDIT_HEADER = CMSSY_EDIT_HEADER;
 exports.CMSSY_EDIT_QUERY_PARAM = CMSSY_EDIT_QUERY_PARAM;
+exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
 exports.CMSSY_SECRET_QUERY_PARAM = CMSSY_SECRET_QUERY_PARAM;
 exports.CmssyRequestError = CmssyRequestError;
 exports.CmssyWebhookError = CmssyWebhookError;
@@ -603,13 +626,13 @@ exports.DEFAULT_CMSSY_API_URL = DEFAULT_CMSSY_API_URL;
 exports.DEFAULT_CMSSY_EDITOR_ORIGINS = DEFAULT_CMSSY_EDITOR_ORIGINS;
 exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
 exports.applyCmssyCsp = applyCmssyCsp;
-exports.buildBlockContext = buildBlockContext;
 exports.createCmssyClient = createCmssyClient;
 exports.defineCmssyConfig = defineCmssyConfig;
 exports.fields = fields;
 exports.graphqlRequest = graphqlRequest;
 exports.isProtocolCompatible = isProtocolCompatible;
 exports.isVerifiedEditUrl = isVerifiedEditUrl;
+exports.localizeHref = localizeHref;
 exports.normalizeOrigin = normalizeOrigin;
 exports.parseEditorMessage = parseEditorMessage;
 exports.postToEditor = postToEditor;

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, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DDVG6VAm.cjs';
-export { G as GraphqlRequestOptions, g as graphqlRequest } from './graphql-request-NQxSMt6v.cjs';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DlAEXYjA.cjs';
+export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-rhYcXU5z.cjs';
 export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
 import * as _cmssy_types from '@cmssy/types';
-import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, 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, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
+import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, 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, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
 
 type Declared<O> = O extends {
     required: true;
@@ -66,8 +66,6 @@ declare const fields: {
     relation: <const O extends RelationFieldOptions>(opts: O) => TypedField<RelationValue<O>, Declared<O>>;
 };
 
-declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean, forms?: Record<string, CmssyFormDefinition>, extra?: BuildBlockContextExtra): CmssyBlockContext;
-
 declare const CMSSY_EDIT_HEADER = "x-cmssy-edit";
 declare const CMSSY_EDIT_QUERY_PARAM = "cmssyEdit";
 declare const CMSSY_SECRET_QUERY_PARAM = "cmssySecret";
@@ -103,4 +101,4 @@ declare class CmssyWebhookError extends Error {
  */
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): Promise<CmssyWebhookEvent>;
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, buildBlockContext, fields, isVerifiedEditUrl, verifyCmssyWebhook };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, fields, isVerifiedEditUrl, verifyCmssyWebhook };

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, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DpssAFJC.js';
-export { G as GraphqlRequestOptions, g as graphqlRequest } from './graphql-request-CDh6IRok.js';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-Blh6P15m.js';
+export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-XintNd0n.js';
 export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
 import * as _cmssy_types from '@cmssy/types';
-import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, 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, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
+import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, 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, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';
 
 type Declared<O> = O extends {
     required: true;
@@ -66,8 +66,6 @@ declare const fields: {
     relation: <const O extends RelationFieldOptions>(opts: O) => TypedField<RelationValue<O>, Declared<O>>;
 };
 
-declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean, forms?: Record<string, CmssyFormDefinition>, extra?: BuildBlockContextExtra): CmssyBlockContext;
-
 declare const CMSSY_EDIT_HEADER = "x-cmssy-edit";
 declare const CMSSY_EDIT_QUERY_PARAM = "cmssyEdit";
 declare const CMSSY_SECRET_QUERY_PARAM = "cmssySecret";
@@ -103,4 +101,4 @@ declare class CmssyWebhookError extends Error {
  */
 declare function verifyCmssyWebhook(options: VerifyCmssyWebhookOptions): Promise<CmssyWebhookEvent>;
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, buildBlockContext, fields, isVerifiedEditUrl, verifyCmssyWebhook };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, fields, isVerifiedEditUrl, verifyCmssyWebhook };

package/dist/index.js

@@ -321,21 +321,43 @@ var fields = {
   }
 };
 
-// src/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms, extra) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms,
-    ...extra?.auth ? { auth: extra.auth } : {},
-    ...extra?.workspace ? { workspace: extra.workspace } : {}
-  };
+// src/data/localize-href.ts
+var PROTOCOL_OR_RELATIVE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
+function isExternalHref(href) {
+  const value = href.trim();
+  if (!value) return true;
+  if (value.startsWith("#")) return true;
+  return PROTOCOL_OR_RELATIVE.test(value);
+}
+function stripLeadingLocale(path, locale) {
+  const segments = path.split("/");
+  const first = segments[1];
+  if (first && first !== locale.default && locale.enabled.includes(first)) {
+    segments.splice(1, 1);
+    const rest = segments.join("/");
+    return rest === "" ? "/" : rest;
+  }
+  return path;
+}
+function addLocalePrefix(path, target, locale) {
+  if (target === locale.default) return path;
+  if (path === "/") return `/${target}`;
+  return `/${target}${path}`;
+}
+function localizeHref(href, locale) {
+  const value = href.trim();
+  if (isExternalHref(value)) return href;
+  const boundary = value.search(/[?#]/);
+  const path = boundary === -1 ? value : value.slice(0, boundary);
+  const suffix = boundary === -1 ? "" : value.slice(boundary);
+  if (!path.startsWith("/")) return href;
+  const bare = stripLeadingLocale(path, locale);
+  return `${addLocalePrefix(bare, locale.current, locale)}${suffix}`;
 }
 
+// src/locale.ts
+var CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+
 // src/bridge/protocol.ts
 var PROTOCOL_VERSION = 2;
 function isProtocolCompatible(version) {
@@ -588,4 +610,4 @@ async function verifyCmssyWebhook(options) {
   return parsed;
 }
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_SECRET_QUERY_PARAM, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, applyCmssyCsp, buildBlockContext, createCmssyClient, defineCmssyConfig, fields, graphqlRequest, isProtocolCompatible, isVerifiedEditUrl, normalizeOrigin, parseEditorMessage, postToEditor, resolveEditorOrigin, verifyCmssyWebhook };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, applyCmssyCsp, createCmssyClient, defineCmssyConfig, fields, graphqlRequest, isProtocolCompatible, isVerifiedEditUrl, localizeHref, normalizeOrigin, parseEditorMessage, postToEditor, resolveEditorOrigin, verifyCmssyWebhook };

package/dist/internal/locale.d.cts

@@ -1,6 +1,7 @@
-import { CmssySiteLocales, CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+import { G as GraphqlRequestOptions } from '../locale-rhYcXU5z.cjs';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-rhYcXU5z.cjs';
+import { CmssySiteLocales, CmssyClientConfig } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from '../graphql-request-NQxSMt6v.cjs';
 import '../content-client-D0EdiqbQ.cjs';
 
 /**
@@ -18,39 +19,10 @@ declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: Cm
     path: string[] | undefined;
 };
 
-/**
- * Rewrites an internal href to carry the active locale as a path prefix.
- * External hrefs, fragments and relative paths are returned untouched. Already
- * prefixed hrefs are normalized so the prefix never doubles.
- */
-declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
-/**
- * Builds the href that switches the current `pathname` to `target` locale,
- * preserving the rest of the path. Used by a language switcher.
- */
-declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
-/**
- * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
- * For rich-text content stored in CMS blocks where links are raw markup.
- */
-declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
-
-declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
-declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
-declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
-    locale: string;
-    path: string[] | undefined;
-}>;
-/**
- * Resolve the locale a path asks for. The prefix IS the language, so a routed
- * path is all it takes - no request, no headers, static-safe.
- */
-declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
-
 /**
  * Maps a page slug to its path for a locale: the default locale gets no
  * prefix, others get `/${locale}`. The homepage ("/") stays "/" (or "/${locale}").
  */
 declare function localizedPath(slug: string, locale: string, defaultLocale: string): string;
 
-export { CMSSY_LOCALE_HEADER, buildLocaleSwitchHref, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, resolveSiteLocales, splitCmssyLocale, splitLocaleFromPath };
+export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath };

package/dist/internal/locale.d.ts

@@ -1,6 +1,7 @@
-import { CmssySiteLocales, CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+import { G as GraphqlRequestOptions } from '../locale-XintNd0n.js';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-XintNd0n.js';
+import { CmssySiteLocales, CmssyClientConfig } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from '../graphql-request-CDh6IRok.js';
 import '../content-client-D0EdiqbQ.js';
 
 /**
@@ -18,39 +19,10 @@ declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: Cm
     path: string[] | undefined;
 };
 
-/**
- * Rewrites an internal href to carry the active locale as a path prefix.
- * External hrefs, fragments and relative paths are returned untouched. Already
- * prefixed hrefs are normalized so the prefix never doubles.
- */
-declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
-/**
- * Builds the href that switches the current `pathname` to `target` locale,
- * preserving the rest of the path. Used by a language switcher.
- */
-declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
-/**
- * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
- * For rich-text content stored in CMS blocks where links are raw markup.
- */
-declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
-
-declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
-declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
-declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
-    locale: string;
-    path: string[] | undefined;
-}>;
-/**
- * Resolve the locale a path asks for. The prefix IS the language, so a routed
- * path is all it takes - no request, no headers, static-safe.
- */
-declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
-
 /**
  * Maps a page slug to its path for a locale: the default locale gets no
  * prefix, others get `/${locale}`. The homepage ("/") stays "/" (or "/${locale}").
  */
 declare function localizedPath(slug: string, locale: string, defaultLocale: string): string;
 
-export { CMSSY_LOCALE_HEADER, buildLocaleSwitchHref, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, resolveSiteLocales, splitCmssyLocale, splitLocaleFromPath };
+export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath };

package/dist/internal.cjs

@@ -120,6 +120,8 @@ var PUBLIC_PAGE_QUERY = `query PublicPage($workspaceSlug: String!, $slug: String
     page {
       get(workspaceSlug: $workspaceSlug, slug: $slug, previewSecret: $previewSecret) {
         id
+        slug
+        pageType
         blocks { id type content style advanced }
         publishedBlocks { id type content style advanced }
       }
@@ -131,6 +133,8 @@ var PUBLIC_PAGE_DEV_QUERY = `query PublicPage($workspaceSlug: String!, $slug: St
     page {
       get(workspaceSlug: $workspaceSlug, slug: $slug, previewSecret: $previewSecret, devPreview: $devPreview) {
         id
+        slug
+        pageType
         blocks { id type content style advanced }
         publishedBlocks { id type content style advanced }
       }
@@ -142,6 +146,8 @@ var PUBLIC_PAGE_BY_ID_QUERY = `query PublicPageById($workspaceSlug: String!, $pa
     page {
       getById(workspaceSlug: $workspaceSlug, pageId: $pageId) {
         id
+        slug
+        pageType
         publishedBlocks { id type content style advanced }
       }
     }
@@ -225,7 +231,12 @@ async function fetchPage(config, path, options = {}) {
   if (!page) return null;
   const draft = previewSecret !== null || devPreview;
   const blocks = (draft ? page.blocks : page.publishedBlocks) ?? [];
-  return { id: page.id, blocks };
+  return {
+    id: page.id,
+    blocks,
+    slug: page.slug ?? slug,
+    pageType: page.pageType ?? null
+  };
 }
 async function fetchPageById(config, pageId, options = {}) {
   const data = await postGraphql(
@@ -241,7 +252,12 @@ async function fetchPageById(config, pageId, options = {}) {
   );
   const page = data?.public?.page?.getById;
   if (!page) return null;
-  return { id: page.id, blocks: page.publishedBlocks ?? [] };
+  return {
+    id: page.id,
+    blocks: page.publishedBlocks ?? [],
+    ...page.slug ? { slug: page.slug } : {},
+    pageType: page.pageType ?? null
+  };
 }
 async function fetchPages(config, options = {}) {
   const data = await postGraphql(
@@ -802,6 +818,30 @@ function localizedPath(slug, locale, defaultLocale) {
   return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
 }
 
+// src/block-context.ts
+function blockPageOf(page) {
+  if (!page?.slug) return void 0;
+  return {
+    id: page.id,
+    slug: page.slug,
+    pageType: page.pageType ?? null
+  };
+}
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms, extra) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms,
+    ...extra?.auth ? { auth: extra.auth } : {},
+    ...extra?.workspace ? { workspace: extra.workspace } : {},
+    ...extra?.page ? { page: extra.page } : {}
+  };
+}
+
 // src/bridge/messages.ts
 function normalizeOrigin(origin) {
   const trimmed = origin.trim();
@@ -905,6 +945,8 @@ exports.RECORDS_BY_IDS_QUERY = RECORDS_BY_IDS_QUERY;
 exports.SITE_CONFIG_QUERY = SITE_CONFIG_QUERY;
 exports.SUBMIT_FORM_MUTATION = SUBMIT_FORM_MUTATION;
 exports.asBucket = asBucket;
+exports.blockPageOf = blockPageOf;
+exports.buildBlockContext = buildBlockContext;
 exports.buildLocaleSwitchHref = buildLocaleSwitchHref;
 exports.cachedWorkspaceId = cachedWorkspaceId;
 exports.clearWorkspaceIdCache = clearWorkspaceIdCache;

package/dist/internal.d.cts

@@ -1,10 +1,11 @@
 export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-D0EdiqbQ.cjs';
-import { CmssyClientConfig, CmssySiteConfig, RawBlock, CmssyFormDefinition, FieldDefinition } from '@cmssy/types';
+import { CmssyPageData, CmssyBlockPage, CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, CmssySiteConfig, RawBlock, FieldDefinition } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './graphql-request-NQxSMt6v.cjs';
-import { Q as QueryScopedOptions } from './csp-DDVG6VAm.cjs';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DDVG6VAm.cjs';
-export { CMSSY_LOCALE_HEADER, buildLocaleSwitchHref, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, resolveSiteLocales, splitCmssyLocale, splitLocaleFromPath } from './internal/locale.cjs';
+import { G as GraphqlRequestOptions } from './locale-rhYcXU5z.cjs';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-rhYcXU5z.cjs';
+import { Q as QueryScopedOptions } from './csp-DlAEXYjA.cjs';
+export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DlAEXYjA.cjs';
+export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } 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        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";
 declare const MODEL_DEFINITIONS_QUERY = "query PublicModelDefinitions($workspaceId: String!) {\n  public {\n    model {\n      definitions(workspaceId: $workspaceId) {\n        id name slug description icon color displayField recordCount\n      }\n    }\n  }\n}";
@@ -12,6 +13,16 @@ declare const MODEL_RECORDS_QUERY = "query PublicModelRecords($workspaceId: Stri
 declare const FORM_QUERY = "query PublicForm($formId: ID!) {\n  public {\n    form {\n      get(formId: $formId) {\n        id\n        name\n        slug\n        description\n        fields {\n          id name fieldType label placeholder helpText\n          defaultValue width order showWhen requiredWhen\n          options { value label disabled }\n          validation { required minLength maxLength minValue maxValue pattern customMessage }\n        }\n        settings {\n          actionType submitButtonLabel successMessage errorMessage\n          redirectUrl requireLogin enableCaptcha\n        }\n      }\n    }\n  }\n}";
 declare const SUBMIT_FORM_MUTATION = "mutation SubmitForm($formId: ID!, $input: SubmitFormInput!) {\n  public {\n    form {\n      submit(formId: $formId, input: $input) {\n        success message submissionId redirectUrl accessToken customer\n      }\n    }\n  }\n}";
 
+/**
+ * The identity half of a fetched page, for `context.page`.
+ *
+ * A page fetched by an older SDK - or by a consumer that builds `CmssyPageData`
+ * itself - has no slug, and then a block gets no `page` at all rather than one
+ * with a hole in it: `context.page ? … : …` is a question a block can answer.
+ */
+declare function blockPageOf(page: CmssyPageData | null | undefined): CmssyBlockPage | undefined;
+declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean, forms?: Record<string, CmssyFormDefinition>, extra?: BuildBlockContextExtra): CmssyBlockContext;
+
 declare function getBlockContentForLanguage(content: unknown, locale: string, defaultLocale?: string, availableLocales?: string[]): Record<string, unknown>;
 /**
  * Coerce a block bucket (`style` / `advanced`) to a plain object. These buckets
@@ -59,4 +70,4 @@ declare function resolveRelationContent(config: CmssyClientConfig, entries: Rela
 
 declare function cmssySecretsMatch(a: string, b: string): Promise<boolean>;
 
-export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };
+export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, blockPageOf, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };

package/dist/internal.d.ts

@@ -1,10 +1,11 @@
 export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-D0EdiqbQ.js';
-import { CmssyClientConfig, CmssySiteConfig, RawBlock, CmssyFormDefinition, FieldDefinition } from '@cmssy/types';
+import { CmssyPageData, CmssyBlockPage, CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, CmssySiteConfig, RawBlock, FieldDefinition } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './graphql-request-CDh6IRok.js';
-import { Q as QueryScopedOptions } from './csp-DpssAFJC.js';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DpssAFJC.js';
-export { CMSSY_LOCALE_HEADER, buildLocaleSwitchHref, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, resolveSiteLocales, splitCmssyLocale, splitLocaleFromPath } from './internal/locale.js';
+import { G as GraphqlRequestOptions } from './locale-XintNd0n.js';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-XintNd0n.js';
+import { Q as QueryScopedOptions } from './csp-Blh6P15m.js';
+export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-Blh6P15m.js';
+export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } 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        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";
 declare const MODEL_DEFINITIONS_QUERY = "query PublicModelDefinitions($workspaceId: String!) {\n  public {\n    model {\n      definitions(workspaceId: $workspaceId) {\n        id name slug description icon color displayField recordCount\n      }\n    }\n  }\n}";
@@ -12,6 +13,16 @@ declare const MODEL_RECORDS_QUERY = "query PublicModelRecords($workspaceId: Stri
 declare const FORM_QUERY = "query PublicForm($formId: ID!) {\n  public {\n    form {\n      get(formId: $formId) {\n        id\n        name\n        slug\n        description\n        fields {\n          id name fieldType label placeholder helpText\n          defaultValue width order showWhen requiredWhen\n          options { value label disabled }\n          validation { required minLength maxLength minValue maxValue pattern customMessage }\n        }\n        settings {\n          actionType submitButtonLabel successMessage errorMessage\n          redirectUrl requireLogin enableCaptcha\n        }\n      }\n    }\n  }\n}";
 declare const SUBMIT_FORM_MUTATION = "mutation SubmitForm($formId: ID!, $input: SubmitFormInput!) {\n  public {\n    form {\n      submit(formId: $formId, input: $input) {\n        success message submissionId redirectUrl accessToken customer\n      }\n    }\n  }\n}";
 
+/**
+ * The identity half of a fetched page, for `context.page`.
+ *
+ * A page fetched by an older SDK - or by a consumer that builds `CmssyPageData`
+ * itself - has no slug, and then a block gets no `page` at all rather than one
+ * with a hole in it: `context.page ? … : …` is a question a block can answer.
+ */
+declare function blockPageOf(page: CmssyPageData | null | undefined): CmssyBlockPage | undefined;
+declare function buildBlockContext(locale: string, defaultLocale: string, enabledLocales?: string[], isPreview?: boolean, forms?: Record<string, CmssyFormDefinition>, extra?: BuildBlockContextExtra): CmssyBlockContext;
+
 declare function getBlockContentForLanguage(content: unknown, locale: string, defaultLocale?: string, availableLocales?: string[]): Record<string, unknown>;
 /**
  * Coerce a block bucket (`style` / `advanced`) to a plain object. These buckets
@@ -59,4 +70,4 @@ declare function resolveRelationContent(config: CmssyClientConfig, entries: Rela
 
 declare function cmssySecretsMatch(a: string, b: string): Promise<boolean>;
 
-export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };
+export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, blockPageOf, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };

package/dist/internal.js

@@ -118,6 +118,8 @@ var PUBLIC_PAGE_QUERY = `query PublicPage($workspaceSlug: String!, $slug: String
     page {
       get(workspaceSlug: $workspaceSlug, slug: $slug, previewSecret: $previewSecret) {
         id
+        slug
+        pageType
         blocks { id type content style advanced }
         publishedBlocks { id type content style advanced }
       }
@@ -129,6 +131,8 @@ var PUBLIC_PAGE_DEV_QUERY = `query PublicPage($workspaceSlug: String!, $slug: St
     page {
       get(workspaceSlug: $workspaceSlug, slug: $slug, previewSecret: $previewSecret, devPreview: $devPreview) {
         id
+        slug
+        pageType
         blocks { id type content style advanced }
         publishedBlocks { id type content style advanced }
       }
@@ -140,6 +144,8 @@ var PUBLIC_PAGE_BY_ID_QUERY = `query PublicPageById($workspaceSlug: String!, $pa
     page {
       getById(workspaceSlug: $workspaceSlug, pageId: $pageId) {
         id
+        slug
+        pageType
         publishedBlocks { id type content style advanced }
       }
     }
@@ -223,7 +229,12 @@ async function fetchPage(config, path, options = {}) {
   if (!page) return null;
   const draft = previewSecret !== null || devPreview;
   const blocks = (draft ? page.blocks : page.publishedBlocks) ?? [];
-  return { id: page.id, blocks };
+  return {
+    id: page.id,
+    blocks,
+    slug: page.slug ?? slug,
+    pageType: page.pageType ?? null
+  };
 }
 async function fetchPageById(config, pageId, options = {}) {
   const data = await postGraphql(
@@ -239,7 +250,12 @@ async function fetchPageById(config, pageId, options = {}) {
   );
   const page = data?.public?.page?.getById;
   if (!page) return null;
-  return { id: page.id, blocks: page.publishedBlocks ?? [] };
+  return {
+    id: page.id,
+    blocks: page.publishedBlocks ?? [],
+    ...page.slug ? { slug: page.slug } : {},
+    pageType: page.pageType ?? null
+  };
 }
 async function fetchPages(config, options = {}) {
   const data = await postGraphql(
@@ -800,6 +816,30 @@ function localizedPath(slug, locale, defaultLocale) {
   return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
 }
 
+// src/block-context.ts
+function blockPageOf(page) {
+  if (!page?.slug) return void 0;
+  return {
+    id: page.id,
+    slug: page.slug,
+    pageType: page.pageType ?? null
+  };
+}
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms, extra) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms,
+    ...extra?.auth ? { auth: extra.auth } : {},
+    ...extra?.workspace ? { workspace: extra.workspace } : {},
+    ...extra?.page ? { page: extra.page } : {}
+  };
+}
+
 // src/bridge/messages.ts
 function normalizeOrigin(origin) {
   const trimmed = origin.trim();
@@ -895,4 +935,4 @@ function cmssyCspHeaders(options) {
   };
 }
 
-export { CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildLocaleSwitchHref, cachedWorkspaceId, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, normalizeRelationContent, normalizeSlug, resolveApiUrl, resolveForms, resolveInitialTarget, resolvePublicUrl, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };
+export { CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, blockPageOf, buildBlockContext, buildLocaleSwitchHref, cachedWorkspaceId, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, normalizeRelationContent, normalizeSlug, resolveApiUrl, resolveForms, resolveInitialTarget, resolvePublicUrl, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };

package/dist/locale-XintNd0n.d.ts

@@ -0,0 +1,52 @@
+import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
+import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+
+interface GraphqlRequestOptions {
+    fetch?: FetchLike;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * Route through the org-scoped public delivery path instead of the base
+     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
+     * resolves the workspace from the URL rather than a global slug lookup.
+     */
+    public?: boolean;
+    /**
+     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
+     * default: this function also carries mutations (auth, cart, checkout),
+     * which must never be blind-retried. Read-only callers opt in with `{}`.
+     */
+    retry?: RetryPolicy | false;
+}
+declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
+
+/**
+ * Rewrites an internal href to carry the active locale as a path prefix.
+ * External hrefs, fragments and relative paths are returned untouched. Already
+ * prefixed hrefs are normalized so the prefix never doubles.
+ */
+declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
+/**
+ * Builds the href that switches the current `pathname` to `target` locale,
+ * preserving the rest of the path. Used by a language switcher.
+ */
+declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
+/**
+ * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
+ * For rich-text content stored in CMS blocks where links are raw markup.
+ */
+declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
+
+declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
+declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
+    locale: string;
+    path: string[] | undefined;
+}>;
+/**
+ * Resolve the locale a path asks for. The prefix IS the language, so a routed
+ * path is all it takes - no request, no headers, static-safe.
+ */
+declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
+
+export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, localeForPath as a, buildLocaleSwitchHref as b, localeForPathname as c, localizeHtmlLinks as d, graphqlRequest as g, localizeHref as l, splitCmssyLocale as s };

package/dist/locale-rhYcXU5z.d.cts

@@ -0,0 +1,52 @@
+import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
+import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+
+interface GraphqlRequestOptions {
+    fetch?: FetchLike;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * Route through the org-scoped public delivery path instead of the base
+     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
+     * resolves the workspace from the URL rather than a global slug lookup.
+     */
+    public?: boolean;
+    /**
+     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
+     * default: this function also carries mutations (auth, cart, checkout),
+     * which must never be blind-retried. Read-only callers opt in with `{}`.
+     */
+    retry?: RetryPolicy | false;
+}
+declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
+
+/**
+ * Rewrites an internal href to carry the active locale as a path prefix.
+ * External hrefs, fragments and relative paths are returned untouched. Already
+ * prefixed hrefs are normalized so the prefix never doubles.
+ */
+declare function localizeHref(href: string, locale: CmssyLocaleContext): string;
+/**
+ * Builds the href that switches the current `pathname` to `target` locale,
+ * preserving the rest of the path. Used by a language switcher.
+ */
+declare function buildLocaleSwitchHref(target: string, pathname: string, locale: CmssyLocaleContext): string;
+/**
+ * Rewrites every `<a href>` inside an HTML string with {@link localizeHref}.
+ * For rich-text content stored in CMS blocks where links are raw markup.
+ */
+declare function localizeHtmlLinks(html: string, locale: CmssyLocaleContext): string;
+
+declare const CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+declare function localeForPathname(config: CmssyClientConfig, pathname: string): Promise<string>;
+declare function splitCmssyLocale(config: CmssyClientConfig, path: string[] | undefined): Promise<{
+    locale: string;
+    path: string[] | undefined;
+}>;
+/**
+ * Resolve the locale a path asks for. The prefix IS the language, so a routed
+ * path is all it takes - no request, no headers, static-safe.
+ */
+declare function localeForPath(config: CmssyClientConfig, path: string | string[]): Promise<string>;
+
+export { CMSSY_LOCALE_HEADER as C, type GraphqlRequestOptions as G, localeForPath as a, buildLocaleSwitchHref as b, localeForPathname as c, localizeHtmlLinks as d, graphqlRequest as g, localizeHref as l, splitCmssyLocale as s };

package/package.json

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

package/dist/graphql-request-CDh6IRok.d.ts

@@ -1,23 +0,0 @@
-import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
-import { CmssyClientConfig } from '@cmssy/types';
-
-interface GraphqlRequestOptions {
-    fetch?: FetchLike;
-    signal?: AbortSignal;
-    headers?: Record<string, string>;
-    /**
-     * Route through the org-scoped public delivery path instead of the base
-     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
-     * resolves the workspace from the URL rather than a global slug lookup.
-     */
-    public?: boolean;
-    /**
-     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
-     * default: this function also carries mutations (auth, cart, checkout),
-     * which must never be blind-retried. Read-only callers opt in with `{}`.
-     */
-    retry?: RetryPolicy | false;
-}
-declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
-
-export { type GraphqlRequestOptions as G, graphqlRequest as g };

package/dist/graphql-request-NQxSMt6v.d.cts

@@ -1,23 +0,0 @@
-import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
-import { CmssyClientConfig } from '@cmssy/types';
-
-interface GraphqlRequestOptions {
-    fetch?: FetchLike;
-    signal?: AbortSignal;
-    headers?: Record<string, string>;
-    /**
-     * Route through the org-scoped public delivery path instead of the base
-     * `/graphql` endpoint. Set for unauthenticated public queries so the backend
-     * resolves the workspace from the URL rather than a global slug lookup.
-     */
-    public?: boolean;
-    /**
-     * Retry transient HTTP failures (429/503, honoring Retry-After). Off by
-     * default: this function also carries mutations (auth, cart, checkout),
-     * which must never be blind-retried. Read-only callers opt in with `{}`.
-     */
-    retry?: RetryPolicy | false;
-}
-declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
-
-export { type GraphqlRequestOptions as G, graphqlRequest as g };