@cmssy/react 0.2.5 → 0.3.0

package/dist/client.cjs

@@ -750,6 +750,16 @@ function CmssyLazyLayout({ load, ...props }) {
   if (!blocks) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(CmssyEditableLayout, { ...props, blocks });
 }
+var LocaleContext = react.createContext(null);
+function CmssyLocaleProvider({
+  value,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(LocaleContext.Provider, { value, children });
+}
+function useCmssyLocale() {
+  return react.useContext(LocaleContext);
+}
 var CmssyAuthContext = react.createContext(null);
 function CmssyAuthProvider({
   children,
@@ -1462,6 +1472,7 @@ exports.CmssyEditableLayout = CmssyEditableLayout;
 exports.CmssyEditablePage = CmssyEditablePage;
 exports.CmssyLazyEditor = CmssyLazyEditor;
 exports.CmssyLazyLayout = CmssyLazyLayout;
+exports.CmssyLocaleProvider = CmssyLocaleProvider;
 exports.cartBlock = cartBlock;
 exports.checkoutBlock = checkoutBlock;
 exports.formatPrice = formatPrice;
@@ -1470,6 +1481,7 @@ exports.fromMinorUnits = fromMinorUnits;
 exports.productBlock = productBlock;
 exports.toMinorUnits = toMinorUnits;
 exports.useCart = useCart;
+exports.useCmssyLocale = useCmssyLocale;
 exports.useCmssyOrders = useCmssyOrders;
 exports.useCmssyUser = useCmssyUser;
 exports.useEditBridge = useEditBridge;

package/dist/client.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, e as CmssyCart, f as CmssyOrder, g as CmssyProduct } from './commerce-queries-BYx7uUnE.cjs';
-export { h as CmssyCartDiscount, i as CmssyCartItem, j as CmssyCartItemSnapshot, k as CmssyOrderItem, l as CmssyProductVariant } from './commerce-queries-BYx7uUnE.cjs';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, e as CmssyLocaleContext, f as CmssyCart, g as CmssyOrder, h as CmssyProduct } from './commerce-queries-CqCdTD31.cjs';
+export { i as CmssyCartDiscount, j as CmssyCartItem, k as CmssyCartItemSnapshot, l as CmssyOrderItem, m as CmssyProductVariant } from './commerce-queries-CqCdTD31.cjs';
 import { ReactNode } from 'react';
 
 interface EditBridgeConfig {
@@ -81,6 +81,19 @@ interface CmssyLazyLayoutProps {
 }
 declare function CmssyLazyLayout({ load, ...props }: CmssyLazyLayoutProps): react_jsx_runtime.JSX.Element | null;
 
+interface CmssyLocaleProviderProps {
+    value: CmssyLocaleContext;
+    children: ReactNode;
+}
+/**
+ * Exposes the active locale ({@link CmssyLocaleContext}) to client components
+ * below it (e.g. `CmssyLink`) so they can build locale-aware hrefs without
+ * prop-drilling. Wrap your root layout body with it.
+ */
+declare function CmssyLocaleProvider({ value, children, }: CmssyLocaleProviderProps): react_jsx_runtime.JSX.Element;
+/** Reads the active locale; returns null when no provider is mounted. */
+declare function useCmssyLocale(): CmssyLocaleContext | null;
+
 interface CmssyAuthUser {
     recordId: string;
     email: string;
@@ -156,4 +169,4 @@ declare function fromMinorUnits(minor: number, currency: string): number;
 declare function toMinorUnits(amount: number, currency: string): number;
 declare function formatPrice(minor: number, currency: string | null | undefined): string;
 
-export { type CmssyAddToCartOptions, type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyCart, CmssyCommerceProvider, type CmssyCommerceProviderProps, type CmssyCommerceState, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, CmssyOrder, type CmssyOrdersState, CmssyProduct, type EditBridgeConfig, type EditBridgeState, type PatchMap, type UseCmssyOrdersOptions, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyOrders, useCmssyUser, useEditBridge };
+export { type CmssyAddToCartOptions, type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyCart, CmssyCommerceProvider, type CmssyCommerceProviderProps, type CmssyCommerceState, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, CmssyLocaleProvider, type CmssyLocaleProviderProps, CmssyOrder, type CmssyOrdersState, CmssyProduct, type EditBridgeConfig, type EditBridgeState, type PatchMap, type UseCmssyOrdersOptions, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyLocale, useCmssyOrders, useCmssyUser, useEditBridge };

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, e as CmssyCart, f as CmssyOrder, g as CmssyProduct } from './commerce-queries-BYx7uUnE.js';
-export { h as CmssyCartDiscount, i as CmssyCartItem, j as CmssyCartItemSnapshot, k as CmssyOrderItem, l as CmssyProductVariant } from './commerce-queries-BYx7uUnE.js';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, e as CmssyLocaleContext, f as CmssyCart, g as CmssyOrder, h as CmssyProduct } from './commerce-queries-CqCdTD31.js';
+export { i as CmssyCartDiscount, j as CmssyCartItem, k as CmssyCartItemSnapshot, l as CmssyOrderItem, m as CmssyProductVariant } from './commerce-queries-CqCdTD31.js';
 import { ReactNode } from 'react';
 
 interface EditBridgeConfig {
@@ -81,6 +81,19 @@ interface CmssyLazyLayoutProps {
 }
 declare function CmssyLazyLayout({ load, ...props }: CmssyLazyLayoutProps): react_jsx_runtime.JSX.Element | null;
 
+interface CmssyLocaleProviderProps {
+    value: CmssyLocaleContext;
+    children: ReactNode;
+}
+/**
+ * Exposes the active locale ({@link CmssyLocaleContext}) to client components
+ * below it (e.g. `CmssyLink`) so they can build locale-aware hrefs without
+ * prop-drilling. Wrap your root layout body with it.
+ */
+declare function CmssyLocaleProvider({ value, children, }: CmssyLocaleProviderProps): react_jsx_runtime.JSX.Element;
+/** Reads the active locale; returns null when no provider is mounted. */
+declare function useCmssyLocale(): CmssyLocaleContext | null;
+
 interface CmssyAuthUser {
     recordId: string;
     email: string;
@@ -156,4 +169,4 @@ declare function fromMinorUnits(minor: number, currency: string): number;
 declare function toMinorUnits(amount: number, currency: string): number;
 declare function formatPrice(minor: number, currency: string | null | undefined): string;
 
-export { type CmssyAddToCartOptions, type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyCart, CmssyCommerceProvider, type CmssyCommerceProviderProps, type CmssyCommerceState, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, CmssyOrder, type CmssyOrdersState, CmssyProduct, type EditBridgeConfig, type EditBridgeState, type PatchMap, type UseCmssyOrdersOptions, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyOrders, useCmssyUser, useEditBridge };
+export { type CmssyAddToCartOptions, type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyCart, CmssyCommerceProvider, type CmssyCommerceProviderProps, type CmssyCommerceState, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, CmssyLocaleProvider, type CmssyLocaleProviderProps, CmssyOrder, type CmssyOrdersState, CmssyProduct, type EditBridgeConfig, type EditBridgeState, type PatchMap, type UseCmssyOrdersOptions, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyLocale, useCmssyOrders, useCmssyUser, useEditBridge };

package/dist/client.js

@@ -1,5 +1,5 @@
 "use client";
-import { createContext, useState, useRef, useEffect, useMemo, useCallback, useContext, createElement } from 'react';
+import { createContext, useState, useRef, useEffect, useMemo, useContext, useCallback, createElement } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/registry.ts
@@ -748,6 +748,16 @@ function CmssyLazyLayout({ load, ...props }) {
   if (!blocks) return null;
   return /* @__PURE__ */ jsx(CmssyEditableLayout, { ...props, blocks });
 }
+var LocaleContext = createContext(null);
+function CmssyLocaleProvider({
+  value,
+  children
+}) {
+  return /* @__PURE__ */ jsx(LocaleContext.Provider, { value, children });
+}
+function useCmssyLocale() {
+  return useContext(LocaleContext);
+}
 var CmssyAuthContext = createContext(null);
 function CmssyAuthProvider({
   children,
@@ -1454,4 +1464,4 @@ function useCmssyOrders(options = {}) {
   return { orders, total, hasMore, loading, error, refresh: load };
 }
 
-export { CmssyAuthProvider, CmssyCommerceProvider, CmssyEditableLayout, CmssyEditablePage, CmssyLazyEditor, CmssyLazyLayout, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyOrders, useCmssyUser, useEditBridge };
+export { CmssyAuthProvider, CmssyCommerceProvider, CmssyEditableLayout, CmssyEditablePage, CmssyLazyEditor, CmssyLazyLayout, CmssyLocaleProvider, cartBlock, checkoutBlock, formatPrice, fractionDigits, fromMinorUnits, productBlock, toMinorUnits, useCart, useCmssyLocale, useCmssyOrders, useCmssyUser, useEditBridge };

package/dist/{commerce-queries-BYx7uUnE.d.cts → commerce-queries-CqCdTD31.d.cts}

@@ -372,6 +372,13 @@ interface CmssyOrderPayment {
     provider: string | null;
     at: string;
 }
+interface CmssyOrderTaxSummaryLine {
+    rateId: string | null;
+    name: string | null;
+    rate: number;
+    base: number;
+    amount: number;
+}
 interface CmssyOrder {
     id: string;
     status: string;
@@ -380,6 +387,8 @@ interface CmssyOrder {
     currency: string;
     customerEmail: string;
     tax?: number;
+    pricesIncludeTax?: boolean;
+    taxSummary?: CmssyOrderTaxSummaryLine[];
     refundedAmount?: number;
     items?: CmssyOrderItem[];
     paymentProvider?: string | null;
@@ -399,4 +408,4 @@ interface CmssyOrder {
     createdAt?: string;
 }
 
-export { defineBlock as $, type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type CmssyRecordList as D, type EditorToAppMessage as E, type FieldDefinition as F, type CmssySiteConfig as G, FORM_QUERY as H, type FetchLikeResponse as I, type FetchPageOptions as J, type FieldType as K, MODEL_RECORDS_QUERY as L, MODEL_DEFINITIONS_QUERY as M, type ParentReadyMessage as N, type PatchMessage as O, PROTOCOL_VERSION as P, type RawLayoutBlock as Q, type RawBlock as R, type ReadyMessage as S, SITE_CONFIG_QUERY as T, SUBMIT_FORM_MUTATION as U, type SelectMessage as V, type SubmitFormInput as W, blocksToMeta as X, blocksToSchemas as Y, buildBlockContext as Z, buildBlockMap as _, type BlockMeta as a, fetchLayouts as a0, fetchPage as a1, isProtocolCompatible as a2, normalizeSlug as a3, type BlockDefinition as b, type CmssyFormDefinition as c, type CmssyLayoutGroup as d, type CmssyCart as e, type CmssyOrder as f, type CmssyProduct as g, type CmssyCartDiscount as h, type CmssyCartItem as i, type CmssyCartItemSnapshot as j, type CmssyOrderItem as k, type CmssyProductVariant as l, type FetchLike as m, type CmssyClientConfig as n, type BlockMap as o, type CmssyBlockContext as p, type BlockRect as q, type BoundsMessage as r, type ClickMessage as s, type CmssyBranding as t, type CmssyFormField as u, type CmssyFormSettings as v, type CmssyFormSubmitResponse as w, type CmssyLocaleContext as x, type CmssyModelDefinition as y, type CmssyModelRecord as z };
+export { defineBlock as $, type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type CmssyRecordList as D, type EditorToAppMessage as E, type FieldDefinition as F, type CmssySiteConfig as G, FORM_QUERY as H, type FetchLikeResponse as I, type FetchPageOptions as J, type FieldType as K, MODEL_RECORDS_QUERY as L, MODEL_DEFINITIONS_QUERY as M, type ParentReadyMessage as N, type PatchMessage as O, PROTOCOL_VERSION as P, type RawLayoutBlock as Q, type RawBlock as R, type ReadyMessage as S, SITE_CONFIG_QUERY as T, SUBMIT_FORM_MUTATION as U, type SelectMessage as V, type SubmitFormInput as W, blocksToMeta as X, blocksToSchemas as Y, buildBlockContext as Z, buildBlockMap as _, type BlockMeta as a, fetchLayouts as a0, fetchPage as a1, isProtocolCompatible as a2, normalizeSlug as a3, type BlockDefinition as b, type CmssyFormDefinition as c, type CmssyLayoutGroup as d, type CmssyLocaleContext as e, type CmssyCart as f, type CmssyOrder as g, type CmssyProduct as h, type CmssyCartDiscount as i, type CmssyCartItem as j, type CmssyCartItemSnapshot as k, type CmssyOrderItem as l, type CmssyProductVariant as m, type FetchLike as n, type CmssyClientConfig as o, type BlockMap as p, type CmssyBlockContext as q, type BlockRect as r, type BoundsMessage as s, type ClickMessage as t, type CmssyBranding as u, type CmssyFormField as v, type CmssyFormSettings as w, type CmssyFormSubmitResponse as x, type CmssyModelDefinition as y, type CmssyModelRecord as z };

package/dist/{commerce-queries-BYx7uUnE.d.ts → commerce-queries-CqCdTD31.d.ts}

@@ -372,6 +372,13 @@ interface CmssyOrderPayment {
     provider: string | null;
     at: string;
 }
+interface CmssyOrderTaxSummaryLine {
+    rateId: string | null;
+    name: string | null;
+    rate: number;
+    base: number;
+    amount: number;
+}
 interface CmssyOrder {
     id: string;
     status: string;
@@ -380,6 +387,8 @@ interface CmssyOrder {
     currency: string;
     customerEmail: string;
     tax?: number;
+    pricesIncludeTax?: boolean;
+    taxSummary?: CmssyOrderTaxSummaryLine[];
     refundedAmount?: number;
     items?: CmssyOrderItem[];
     paymentProvider?: string | null;
@@ -399,4 +408,4 @@ interface CmssyOrder {
     createdAt?: string;
 }
 
-export { defineBlock as $, type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type CmssyRecordList as D, type EditorToAppMessage as E, type FieldDefinition as F, type CmssySiteConfig as G, FORM_QUERY as H, type FetchLikeResponse as I, type FetchPageOptions as J, type FieldType as K, MODEL_RECORDS_QUERY as L, MODEL_DEFINITIONS_QUERY as M, type ParentReadyMessage as N, type PatchMessage as O, PROTOCOL_VERSION as P, type RawLayoutBlock as Q, type RawBlock as R, type ReadyMessage as S, SITE_CONFIG_QUERY as T, SUBMIT_FORM_MUTATION as U, type SelectMessage as V, type SubmitFormInput as W, blocksToMeta as X, blocksToSchemas as Y, buildBlockContext as Z, buildBlockMap as _, type BlockMeta as a, fetchLayouts as a0, fetchPage as a1, isProtocolCompatible as a2, normalizeSlug as a3, type BlockDefinition as b, type CmssyFormDefinition as c, type CmssyLayoutGroup as d, type CmssyCart as e, type CmssyOrder as f, type CmssyProduct as g, type CmssyCartDiscount as h, type CmssyCartItem as i, type CmssyCartItemSnapshot as j, type CmssyOrderItem as k, type CmssyProductVariant as l, type FetchLike as m, type CmssyClientConfig as n, type BlockMap as o, type CmssyBlockContext as p, type BlockRect as q, type BoundsMessage as r, type ClickMessage as s, type CmssyBranding as t, type CmssyFormField as u, type CmssyFormSettings as v, type CmssyFormSubmitResponse as w, type CmssyLocaleContext as x, type CmssyModelDefinition as y, type CmssyModelRecord as z };
+export { defineBlock as $, type AppToEditorMessage as A, type BlockSchema as B, type CmssyPageData as C, type CmssyRecordList as D, type EditorToAppMessage as E, type FieldDefinition as F, type CmssySiteConfig as G, FORM_QUERY as H, type FetchLikeResponse as I, type FetchPageOptions as J, type FieldType as K, MODEL_RECORDS_QUERY as L, MODEL_DEFINITIONS_QUERY as M, type ParentReadyMessage as N, type PatchMessage as O, PROTOCOL_VERSION as P, type RawLayoutBlock as Q, type RawBlock as R, type ReadyMessage as S, SITE_CONFIG_QUERY as T, SUBMIT_FORM_MUTATION as U, type SelectMessage as V, type SubmitFormInput as W, blocksToMeta as X, blocksToSchemas as Y, buildBlockContext as Z, buildBlockMap as _, type BlockMeta as a, fetchLayouts as a0, fetchPage as a1, isProtocolCompatible as a2, normalizeSlug as a3, type BlockDefinition as b, type CmssyFormDefinition as c, type CmssyLayoutGroup as d, type CmssyLocaleContext as e, type CmssyCart as f, type CmssyOrder as g, type CmssyProduct as h, type CmssyCartDiscount as i, type CmssyCartItem as j, type CmssyCartItemSnapshot as k, type CmssyOrderItem as l, type CmssyProductVariant as m, type FetchLike as n, type CmssyClientConfig as o, type BlockMap as p, type CmssyBlockContext as q, type BlockRect as r, type BoundsMessage as s, type ClickMessage as t, type CmssyBranding as u, type CmssyFormField as v, type CmssyFormSettings as w, type CmssyFormSubmitResponse as x, type CmssyModelDefinition as y, type CmssyModelRecord as z };

package/dist/index.cjs

@@ -630,6 +630,52 @@ function splitLocaleFromPath(path, siteLocales) {
   }
   return { locale: siteLocales.defaultLocale, path };
 }
+
+// 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}`;
+}
+function buildLocaleSwitchHref(target, pathname, locale) {
+  const path = pathname && pathname.startsWith("/") ? pathname : "/";
+  const bare = stripLeadingLocale(path, locale);
+  return addLocalePrefix(bare, target, locale);
+}
+var ANCHOR_HREF = /(<a\b(?:"[^"]*"|'[^']*'|[^>])*?\shref=)(["'])(.*?)\2/gi;
+function localizeHtmlLinks(html, locale) {
+  return html.replace(
+    ANCHOR_HREF,
+    (_match, prefix, quote, url) => `${prefix}${quote}${localizeHref(url, locale)}${quote}`
+  );
+}
 function CmssyBlock({
   block,
   locale,
@@ -670,6 +716,7 @@ exports.blocksToMeta = blocksToMeta;
 exports.blocksToSchemas = blocksToSchemas;
 exports.buildBlockContext = buildBlockContext;
 exports.buildBlockMap = buildBlockMap;
+exports.buildLocaleSwitchHref = buildLocaleSwitchHref;
 exports.collectFormIds = collectFormIds;
 exports.createCmssyClient = createCmssyClient;
 exports.defineBlock = defineBlock;
@@ -679,6 +726,8 @@ exports.fields = fields;
 exports.getBlockContentForLanguage = getBlockContentForLanguage;
 exports.graphqlRequest = graphqlRequest;
 exports.isProtocolCompatible = isProtocolCompatible;
+exports.localizeHref = localizeHref;
+exports.localizeHtmlLinks = localizeHtmlLinks;
 exports.normalizeOrigin = normalizeOrigin;
 exports.normalizeSlug = normalizeSlug;
 exports.parseEditorMessage = parseEditorMessage;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, m as FetchLike, n as CmssyClientConfig, R as RawBlock, o as BlockMap, p as CmssyBlockContext } from './commerce-queries-BYx7uUnE.cjs';
-export { a as BlockMeta, q as BlockRect, B as BlockSchema, r as BoundsMessage, s as ClickMessage, t as CmssyBranding, e as CmssyCart, h as CmssyCartDiscount, i as CmssyCartItem, j as CmssyCartItemSnapshot, u as CmssyFormField, v as CmssyFormSettings, w as CmssyFormSubmitResponse, x as CmssyLocaleContext, y as CmssyModelDefinition, z as CmssyModelRecord, f as CmssyOrder, g as CmssyProduct, l as CmssyProductVariant, D as CmssyRecordList, G as CmssySiteConfig, H as FORM_QUERY, I as FetchLikeResponse, J as FetchPageOptions, K as FieldType, M as MODEL_DEFINITIONS_QUERY, L as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, N as ParentReadyMessage, O as PatchMessage, Q as RawLayoutBlock, S as ReadyMessage, T as SITE_CONFIG_QUERY, U as SUBMIT_FORM_MUTATION, V as SelectMessage, W as SubmitFormInput, X as blocksToMeta, Y as blocksToSchemas, Z as buildBlockContext, _ as buildBlockMap, $ as defineBlock, a0 as fetchLayouts, a1 as fetchPage, a2 as isProtocolCompatible, a3 as normalizeSlug } from './commerce-queries-BYx7uUnE.cjs';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, n as FetchLike, o as CmssyClientConfig, R as RawBlock, e as CmssyLocaleContext, p as BlockMap, q as CmssyBlockContext } from './commerce-queries-CqCdTD31.cjs';
+export { a as BlockMeta, r as BlockRect, B as BlockSchema, s as BoundsMessage, t as ClickMessage, u as CmssyBranding, f as CmssyCart, i as CmssyCartDiscount, j as CmssyCartItem, k as CmssyCartItemSnapshot, v as CmssyFormField, w as CmssyFormSettings, x as CmssyFormSubmitResponse, y as CmssyModelDefinition, z as CmssyModelRecord, g as CmssyOrder, h as CmssyProduct, m as CmssyProductVariant, D as CmssyRecordList, G as CmssySiteConfig, H as FORM_QUERY, I as FetchLikeResponse, J as FetchPageOptions, K as FieldType, M as MODEL_DEFINITIONS_QUERY, L as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, N as ParentReadyMessage, O as PatchMessage, Q as RawLayoutBlock, S as ReadyMessage, T as SITE_CONFIG_QUERY, U as SUBMIT_FORM_MUTATION, V as SelectMessage, W as SubmitFormInput, X as blocksToMeta, Y as blocksToSchemas, Z as buildBlockContext, _ as buildBlockMap, $ as defineBlock, a0 as fetchLayouts, a1 as fetchPage, a2 as isProtocolCompatible, a3 as normalizeSlug } from './commerce-queries-CqCdTD31.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -91,6 +91,23 @@ 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;
+
 interface CmssyBlockProps {
     block: RawBlock;
     locale: string;
@@ -108,4 +125,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyLocaleContext, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, buildLocaleSwitchHref, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, localizeHref, localizeHtmlLinks, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, m as FetchLike, n as CmssyClientConfig, R as RawBlock, o as BlockMap, p as CmssyBlockContext } from './commerce-queries-BYx7uUnE.js';
-export { a as BlockMeta, q as BlockRect, B as BlockSchema, r as BoundsMessage, s as ClickMessage, t as CmssyBranding, e as CmssyCart, h as CmssyCartDiscount, i as CmssyCartItem, j as CmssyCartItemSnapshot, u as CmssyFormField, v as CmssyFormSettings, w as CmssyFormSubmitResponse, x as CmssyLocaleContext, y as CmssyModelDefinition, z as CmssyModelRecord, f as CmssyOrder, g as CmssyProduct, l as CmssyProductVariant, D as CmssyRecordList, G as CmssySiteConfig, H as FORM_QUERY, I as FetchLikeResponse, J as FetchPageOptions, K as FieldType, M as MODEL_DEFINITIONS_QUERY, L as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, N as ParentReadyMessage, O as PatchMessage, Q as RawLayoutBlock, S as ReadyMessage, T as SITE_CONFIG_QUERY, U as SUBMIT_FORM_MUTATION, V as SelectMessage, W as SubmitFormInput, X as blocksToMeta, Y as blocksToSchemas, Z as buildBlockContext, _ as buildBlockMap, $ as defineBlock, a0 as fetchLayouts, a1 as fetchPage, a2 as isProtocolCompatible, a3 as normalizeSlug } from './commerce-queries-BYx7uUnE.js';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, n as FetchLike, o as CmssyClientConfig, R as RawBlock, e as CmssyLocaleContext, p as BlockMap, q as CmssyBlockContext } from './commerce-queries-CqCdTD31.js';
+export { a as BlockMeta, r as BlockRect, B as BlockSchema, s as BoundsMessage, t as ClickMessage, u as CmssyBranding, f as CmssyCart, i as CmssyCartDiscount, j as CmssyCartItem, k as CmssyCartItemSnapshot, v as CmssyFormField, w as CmssyFormSettings, x as CmssyFormSubmitResponse, y as CmssyModelDefinition, z as CmssyModelRecord, g as CmssyOrder, h as CmssyProduct, m as CmssyProductVariant, D as CmssyRecordList, G as CmssySiteConfig, H as FORM_QUERY, I as FetchLikeResponse, J as FetchPageOptions, K as FieldType, M as MODEL_DEFINITIONS_QUERY, L as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, N as ParentReadyMessage, O as PatchMessage, Q as RawLayoutBlock, S as ReadyMessage, T as SITE_CONFIG_QUERY, U as SUBMIT_FORM_MUTATION, V as SelectMessage, W as SubmitFormInput, X as blocksToMeta, Y as blocksToSchemas, Z as buildBlockContext, _ as buildBlockMap, $ as defineBlock, a0 as fetchLayouts, a1 as fetchPage, a2 as isProtocolCompatible, a3 as normalizeSlug } from './commerce-queries-CqCdTD31.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -91,6 +91,23 @@ 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;
+
 interface CmssyBlockProps {
     block: RawBlock;
     locale: string;
@@ -108,4 +125,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyLocaleContext, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, buildLocaleSwitchHref, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, localizeHref, localizeHtmlLinks, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/dist/index.js

@@ -628,6 +628,52 @@ function splitLocaleFromPath(path, siteLocales) {
   }
   return { locale: siteLocales.defaultLocale, path };
 }
+
+// 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}`;
+}
+function buildLocaleSwitchHref(target, pathname, locale) {
+  const path = pathname && pathname.startsWith("/") ? pathname : "/";
+  const bare = stripLeadingLocale(path, locale);
+  return addLocalePrefix(bare, target, locale);
+}
+var ANCHOR_HREF = /(<a\b(?:"[^"]*"|'[^']*'|[^>])*?\shref=)(["'])(.*?)\2/gi;
+function localizeHtmlLinks(html, locale) {
+  return html.replace(
+    ANCHOR_HREF,
+    (_match, prefix, quote, url) => `${prefix}${quote}${localizeHref(url, locale)}${quote}`
+  );
+}
 function CmssyBlock({
   block,
   locale,
@@ -654,4 +700,4 @@ function CmssyBlock({
   );
 }
 
-export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };
+export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, buildLocaleSwitchHref, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, localizeHref, localizeHtmlLinks, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/react",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "React blocks, renderers, data client and editor bridge for cmssy headless sites",
   "keywords": [
     "cmssy",