@cmssy/core 9.9.0 → 10.0.0

package/dist/internal/locale.cjs

@@ -0,0 +1,279 @@
+'use strict';
+
+// src/data/http.ts
+var CmssyRequestError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "CmssyRequestError";
+    this.status = status;
+  }
+};
+var DEFAULT_RETRY_STATUSES = [429, 503];
+function retryAfterMs(response) {
+  const raw = response.headers?.get("retry-after");
+  if (!raw) return null;
+  const seconds = Number(raw);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(raw);
+  if (Number.isFinite(date)) return Math.max(0, date - Date.now());
+  return null;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new Error("cmssy: request aborted"));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(new Error("cmssy: request aborted"));
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function fetchWithRetry(doFetch, url, init, retry) {
+  if (retry === false || retry === void 0) {
+    return doFetch(url, init);
+  }
+  const maxRetries = retry.maxRetries ?? 3;
+  const baseDelayMs = retry.baseDelayMs ?? 300;
+  const maxDelayMs = retry.maxDelayMs ?? 3e3;
+  const retryStatuses = retry.retryStatuses ?? DEFAULT_RETRY_STATUSES;
+  let response = await doFetch(url, init);
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    if (response.ok || !retryStatuses.includes(response.status)) {
+      return response;
+    }
+    const backoff = baseDelayMs * 2 ** attempt;
+    const wait = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    await sleep(wait, init.signal);
+    response = await doFetch(url, init);
+  }
+  return response;
+}
+async function postGraphql(url, query, variables, options) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  if (typeof doFetch !== "function") {
+    throw new Error(
+      "cmssy: no fetch implementation available - pass options.fetch"
+    );
+  }
+  const response = await fetchWithRetry(
+    doFetch,
+    url,
+    {
+      method: "POST",
+      headers: { "content-type": "application/json", ...options.headers },
+      body: JSON.stringify({ query, variables }),
+      signal: options.signal
+    },
+    options.retry
+  );
+  if (!response.ok) {
+    let detail = "";
+    try {
+      const body = await response.json();
+      if (body.errors && body.errors.length > 0) {
+        detail = ` - ${body.errors.map((error) => error.message ?? "GraphQL error").join("; ")}`;
+      }
+    } catch {
+      detail = "";
+    }
+    throw new CmssyRequestError(
+      `cmssy: ${options.label} failed (${response.status})${detail}`,
+      response.status
+    );
+  }
+  let json;
+  try {
+    json = await response.json();
+  } catch {
+    throw new Error(`cmssy: invalid JSON response from the ${options.label}`);
+  }
+  if (json.errors && json.errors.length > 0) {
+    const message = json.errors.map((error) => error.message ?? "GraphQL error").join("; ");
+    throw new Error(`cmssy: ${options.label} error - ${message}`);
+  }
+  return json.data;
+}
+
+// src/content/content-client.ts
+var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
+function resolveApiUrl(apiUrl) {
+  const explicit = apiUrl?.trim();
+  if (explicit) return explicit;
+  const env = globalThis.process?.env;
+  const fromEnv = env?.CMSSY_API_URL?.trim() ?? "";
+  return fromEnv.length > 0 ? fromEnv : DEFAULT_CMSSY_API_URL;
+}
+function resolvePublicUrl(config) {
+  const base = resolveApiUrl(config.apiUrl).replace(/\/graphql\/?$/, "");
+  return `${base}/public/${config.org}/${config.workspaceSlug}/graphql`;
+}
+
+// src/data/graphql-request.ts
+async function graphqlRequest(config, query, variables, options = {}, label = "request") {
+  const url = options.public ? resolvePublicUrl(config) : resolveApiUrl(config.apiUrl);
+  return postGraphql(url, query, variables, {
+    fetch: options.fetch,
+    signal: options.signal,
+    headers: options.headers,
+    retry: options.retry,
+    label
+  });
+}
+
+// src/data/queries.ts
+var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
+  public {
+    siteConfig(workspaceSlug: $workspaceSlug) {
+      id
+      workspaceId
+      siteName
+      defaultLanguage
+      enabledLanguages
+      enabledFeatures
+      notFoundPageId
+      previewUrl
+      branding {
+        brandName
+        logoUrl
+        faviconUrl
+        ogImageUrl
+      }
+    }
+  }
+}`;
+
+// src/data/site-locales.ts
+var TTL_MS = 6e4;
+var MAX_ENTRIES = 64;
+var cache = /* @__PURE__ */ new Map();
+function localesFromSiteConfig(siteConfig) {
+  const defaultLocale = siteConfig?.defaultLanguage || "en";
+  const enabled = siteConfig?.enabledLanguages ?? [];
+  return {
+    defaultLocale,
+    locales: enabled.length > 0 ? enabled : [defaultLocale]
+  };
+}
+async function resolveSiteLocales(config, options) {
+  const key = `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+  const cached = cache.get(key);
+  if (cached && cached.expires > Date.now()) return cached.value;
+  cache.delete(key);
+  let value;
+  try {
+    const data = await graphqlRequest(
+      config,
+      SITE_CONFIG_QUERY,
+      { workspaceSlug: config.workspaceSlug },
+      { ...options, public: true, retry: options?.retry ?? {} },
+      "site config"
+    );
+    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+  } catch {
+    value = { defaultLocale: "en", locales: ["en"] };
+  }
+  if (cache.size >= MAX_ENTRIES) cache.clear();
+  cache.set(key, { value, expires: Date.now() + TTL_MS });
+  return value;
+}
+function splitLocaleFromPath(path, siteLocales) {
+  const first = path?.[0];
+  if (first && first !== siteLocales.defaultLocale && siteLocales.locales.includes(first)) {
+    return { locale: first, path: path.slice(1) };
+  }
+  return { locale: siteLocales.defaultLocale, path };
+}
+
+// src/locale.ts
+var CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+async function localeForPathname(config, pathname) {
+  const siteLocales = await resolveSiteLocales(config);
+  const segments = pathname.split("/").filter(Boolean);
+  return splitLocaleFromPath(segments, siteLocales).locale;
+}
+async function splitCmssyLocale(config, path) {
+  const siteLocales = await resolveSiteLocales(config);
+  return splitLocaleFromPath(path, siteLocales);
+}
+async function localeForPath(config, path) {
+  const siteLocales = await resolveSiteLocales(config);
+  const segments = Array.isArray(path) ? path.filter(Boolean) : path.split("/").filter(Boolean);
+  return splitLocaleFromPath(segments, siteLocales).locale;
+}
+
+// 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}`
+  );
+}
+
+// src/seo-paths.ts
+function normalizeSlug(slug) {
+  if (slug === "/" || slug === "") return "/";
+  return slug.startsWith("/") ? slug : `/${slug}`;
+}
+function localizedPath(slug, locale, defaultLocale) {
+  const normalized = normalizeSlug(slug);
+  const base = normalized === "/" ? "" : normalized;
+  return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
+}
+
+exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
+exports.buildLocaleSwitchHref = buildLocaleSwitchHref;
+exports.localeForPath = localeForPath;
+exports.localeForPathname = localeForPathname;
+exports.localesFromSiteConfig = localesFromSiteConfig;
+exports.localizeHref = localizeHref;
+exports.localizeHtmlLinks = localizeHtmlLinks;
+exports.localizedPath = localizedPath;
+exports.resolveSiteLocales = resolveSiteLocales;
+exports.splitCmssyLocale = splitCmssyLocale;
+exports.splitLocaleFromPath = splitLocaleFromPath;

package/dist/internal/locale.d.cts

@@ -0,0 +1,56 @@
+import { CmssySiteLocales, CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+export { CmssySiteLocales } from '@cmssy/types';
+import { G as GraphqlRequestOptions } from '../graphql-request-NQxSMt6v.cjs';
+import '../content-client-D0EdiqbQ.cjs';
+
+/**
+ * Maps a workspace site config to its locale set. The single place that
+ * decides the default and enabled languages - the router and the SEO helpers
+ * must agree, so both go through here.
+ */
+declare function localesFromSiteConfig(siteConfig: {
+    defaultLanguage?: string | null;
+    enabledLanguages?: string[];
+} | null): CmssySiteLocales;
+declare function resolveSiteLocales(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<CmssySiteLocales>;
+declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: CmssySiteLocales): {
+    locale: string;
+    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 };

package/dist/internal/locale.d.ts

@@ -0,0 +1,56 @@
+import { CmssySiteLocales, CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
+export { CmssySiteLocales } from '@cmssy/types';
+import { G as GraphqlRequestOptions } from '../graphql-request-CDh6IRok.js';
+import '../content-client-D0EdiqbQ.js';
+
+/**
+ * Maps a workspace site config to its locale set. The single place that
+ * decides the default and enabled languages - the router and the SEO helpers
+ * must agree, so both go through here.
+ */
+declare function localesFromSiteConfig(siteConfig: {
+    defaultLanguage?: string | null;
+    enabledLanguages?: string[];
+} | null): CmssySiteLocales;
+declare function resolveSiteLocales(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<CmssySiteLocales>;
+declare function splitLocaleFromPath(path: string[] | undefined, siteLocales: CmssySiteLocales): {
+    locale: string;
+    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 };

package/dist/internal/locale.js

@@ -0,0 +1,267 @@
+// src/data/http.ts
+var CmssyRequestError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "CmssyRequestError";
+    this.status = status;
+  }
+};
+var DEFAULT_RETRY_STATUSES = [429, 503];
+function retryAfterMs(response) {
+  const raw = response.headers?.get("retry-after");
+  if (!raw) return null;
+  const seconds = Number(raw);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(raw);
+  if (Number.isFinite(date)) return Math.max(0, date - Date.now());
+  return null;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(new Error("cmssy: request aborted"));
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(new Error("cmssy: request aborted"));
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function fetchWithRetry(doFetch, url, init, retry) {
+  if (retry === false || retry === void 0) {
+    return doFetch(url, init);
+  }
+  const maxRetries = retry.maxRetries ?? 3;
+  const baseDelayMs = retry.baseDelayMs ?? 300;
+  const maxDelayMs = retry.maxDelayMs ?? 3e3;
+  const retryStatuses = retry.retryStatuses ?? DEFAULT_RETRY_STATUSES;
+  let response = await doFetch(url, init);
+  for (let attempt = 0; attempt < maxRetries; attempt++) {
+    if (response.ok || !retryStatuses.includes(response.status)) {
+      return response;
+    }
+    const backoff = baseDelayMs * 2 ** attempt;
+    const wait = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    await sleep(wait, init.signal);
+    response = await doFetch(url, init);
+  }
+  return response;
+}
+async function postGraphql(url, query, variables, options) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  if (typeof doFetch !== "function") {
+    throw new Error(
+      "cmssy: no fetch implementation available - pass options.fetch"
+    );
+  }
+  const response = await fetchWithRetry(
+    doFetch,
+    url,
+    {
+      method: "POST",
+      headers: { "content-type": "application/json", ...options.headers },
+      body: JSON.stringify({ query, variables }),
+      signal: options.signal
+    },
+    options.retry
+  );
+  if (!response.ok) {
+    let detail = "";
+    try {
+      const body = await response.json();
+      if (body.errors && body.errors.length > 0) {
+        detail = ` - ${body.errors.map((error) => error.message ?? "GraphQL error").join("; ")}`;
+      }
+    } catch {
+      detail = "";
+    }
+    throw new CmssyRequestError(
+      `cmssy: ${options.label} failed (${response.status})${detail}`,
+      response.status
+    );
+  }
+  let json;
+  try {
+    json = await response.json();
+  } catch {
+    throw new Error(`cmssy: invalid JSON response from the ${options.label}`);
+  }
+  if (json.errors && json.errors.length > 0) {
+    const message = json.errors.map((error) => error.message ?? "GraphQL error").join("; ");
+    throw new Error(`cmssy: ${options.label} error - ${message}`);
+  }
+  return json.data;
+}
+
+// src/content/content-client.ts
+var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
+function resolveApiUrl(apiUrl) {
+  const explicit = apiUrl?.trim();
+  if (explicit) return explicit;
+  const env = globalThis.process?.env;
+  const fromEnv = env?.CMSSY_API_URL?.trim() ?? "";
+  return fromEnv.length > 0 ? fromEnv : DEFAULT_CMSSY_API_URL;
+}
+function resolvePublicUrl(config) {
+  const base = resolveApiUrl(config.apiUrl).replace(/\/graphql\/?$/, "");
+  return `${base}/public/${config.org}/${config.workspaceSlug}/graphql`;
+}
+
+// src/data/graphql-request.ts
+async function graphqlRequest(config, query, variables, options = {}, label = "request") {
+  const url = options.public ? resolvePublicUrl(config) : resolveApiUrl(config.apiUrl);
+  return postGraphql(url, query, variables, {
+    fetch: options.fetch,
+    signal: options.signal,
+    headers: options.headers,
+    retry: options.retry,
+    label
+  });
+}
+
+// src/data/queries.ts
+var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
+  public {
+    siteConfig(workspaceSlug: $workspaceSlug) {
+      id
+      workspaceId
+      siteName
+      defaultLanguage
+      enabledLanguages
+      enabledFeatures
+      notFoundPageId
+      previewUrl
+      branding {
+        brandName
+        logoUrl
+        faviconUrl
+        ogImageUrl
+      }
+    }
+  }
+}`;
+
+// src/data/site-locales.ts
+var TTL_MS = 6e4;
+var MAX_ENTRIES = 64;
+var cache = /* @__PURE__ */ new Map();
+function localesFromSiteConfig(siteConfig) {
+  const defaultLocale = siteConfig?.defaultLanguage || "en";
+  const enabled = siteConfig?.enabledLanguages ?? [];
+  return {
+    defaultLocale,
+    locales: enabled.length > 0 ? enabled : [defaultLocale]
+  };
+}
+async function resolveSiteLocales(config, options) {
+  const key = `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+  const cached = cache.get(key);
+  if (cached && cached.expires > Date.now()) return cached.value;
+  cache.delete(key);
+  let value;
+  try {
+    const data = await graphqlRequest(
+      config,
+      SITE_CONFIG_QUERY,
+      { workspaceSlug: config.workspaceSlug },
+      { ...options, public: true, retry: options?.retry ?? {} },
+      "site config"
+    );
+    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+  } catch {
+    value = { defaultLocale: "en", locales: ["en"] };
+  }
+  if (cache.size >= MAX_ENTRIES) cache.clear();
+  cache.set(key, { value, expires: Date.now() + TTL_MS });
+  return value;
+}
+function splitLocaleFromPath(path, siteLocales) {
+  const first = path?.[0];
+  if (first && first !== siteLocales.defaultLocale && siteLocales.locales.includes(first)) {
+    return { locale: first, path: path.slice(1) };
+  }
+  return { locale: siteLocales.defaultLocale, path };
+}
+
+// src/locale.ts
+var CMSSY_LOCALE_HEADER = "x-cmssy-locale";
+async function localeForPathname(config, pathname) {
+  const siteLocales = await resolveSiteLocales(config);
+  const segments = pathname.split("/").filter(Boolean);
+  return splitLocaleFromPath(segments, siteLocales).locale;
+}
+async function splitCmssyLocale(config, path) {
+  const siteLocales = await resolveSiteLocales(config);
+  return splitLocaleFromPath(path, siteLocales);
+}
+async function localeForPath(config, path) {
+  const siteLocales = await resolveSiteLocales(config);
+  const segments = Array.isArray(path) ? path.filter(Boolean) : path.split("/").filter(Boolean);
+  return splitLocaleFromPath(segments, siteLocales).locale;
+}
+
+// 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}`
+  );
+}
+
+// src/seo-paths.ts
+function normalizeSlug(slug) {
+  if (slug === "/" || slug === "") return "/";
+  return slug.startsWith("/") ? slug : `/${slug}`;
+}
+function localizedPath(slug, locale, defaultLocale) {
+  const normalized = normalizeSlug(slug);
+  const base = normalized === "/" ? "" : normalized;
+  return locale === defaultLocale ? base || "/" : `/${locale}${base}`;
+}
+
+export { CMSSY_LOCALE_HEADER, buildLocaleSwitchHref, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, resolveSiteLocales, splitCmssyLocale, splitLocaleFromPath };