@pure-ds/core 0.7.37 → 0.7.39

package/public/assets/pds/vscode-custom-data.json

@@ -765,6 +765,16 @@
       "name": "COMPONENT_TAG",
       "description": "PdsLiveTemplateCanvas component"
     },
+    {
+      "name": "pds-locale",
+      "description": "Locale switcher component.\r\n\r\nThe component only persists canonical 5-letter locale tags (`xx-YY`),\r\nfor example `en-US` and `nl-NL`.",
+      "attributes": [
+        {
+          "name": "data-label",
+          "description": "Accessible label for the locale radio group."
+        }
+      ]
+    },
     {
       "name": "pds-omnibox",
       "description": "PdsOmnibox component",

package/src/js/common/localization-resource-provider.js

@@ -71,6 +71,59 @@ function normalizeAliasMap(aliases = {}) {
   return normalized;
 }
 
+function resolveAliasTarget(aliasKey, aliases, localeSet) {
+  const values = Array.isArray(aliases?.[aliasKey]) ? aliases[aliasKey] : [];
+  for (const value of values) {
+    const normalizedValue = normalizeLocaleTag(value);
+    if (localeSet.has(normalizedValue)) {
+      return normalizedValue;
+    }
+  }
+  return "";
+}
+
+function createAliasLookup({ aliases, localeSet }) {
+  const lookup = new Map();
+
+  for (const locale of localeSet) {
+    lookup.set(locale, locale);
+  }
+
+  for (const key of Object.keys(aliases || {})) {
+    const target = resolveAliasTarget(key, aliases, localeSet);
+    if (!target) {
+      throw new Error(
+        `[i18n] Locale alias "${key}" does not map to any configured locale.`
+      );
+    }
+    lookup.set(key, target);
+  }
+
+  return lookup;
+}
+
+function resolveConfiguredLocale(locale, { defaultLocale, aliasLookup }) {
+  const normalized = normalizeLocaleTag(locale);
+  if (!normalized) {
+    return defaultLocale;
+  }
+
+  const direct = aliasLookup.get(normalized);
+  if (direct) {
+    return direct;
+  }
+
+  const base = toBaseLocale(normalized);
+  const baseMapped = base ? aliasLookup.get(base) : "";
+  if (baseMapped) {
+    return baseMapped;
+  }
+
+  throw new Error(
+    `[i18n] Locale alias "${locale}" is not configured. Add an alias entry for "${base || normalized}".`
+  );
+}
+
 function normalizeBundleShape(bundle) {
   if (!bundle || typeof bundle !== "object" || Array.isArray(bundle)) {
     return {};
@@ -177,6 +230,7 @@ function buildCandidateLocales({ locale, effectiveLocale, defaultLocale, aliases
  *   locales: string[],
  *   provider: {
  *     locales: string[],
+ *     resolveLocale: (locale: string) => string,
  *     loadLocale: (context: { locale: string }) => Promise<Record<string, string | { content?: string }>>,
  *   },
  * }}
@@ -186,6 +240,7 @@ export function createJSONLocalization(options = {}) {
   const locales = toLocaleList(options?.locales, defaultLocale);
   const localeSet = new Set(locales);
   const aliases = normalizeAliasMap(options?.aliases || {});
+  const aliasLookup = createAliasLookup({ aliases, localeSet });
   const cache = options?.cache instanceof Map ? options.cache : new Map();
   const basePath = normalizeBasePath(options?.basePath);
   const requestInit =
@@ -194,21 +249,10 @@ export function createJSONLocalization(options = {}) {
       : {};
 
   const resolveEffectiveLocale = (locale) => {
-    const normalized = normalizeLocaleTag(locale);
-    if (!normalized) {
-      return defaultLocale;
-    }
-
-    if (localeSet.has(normalized)) {
-      return normalized;
-    }
-
-    const base = toBaseLocale(normalized);
-    if (localeSet.has(base)) {
-      return base;
-    }
-
-    return defaultLocale;
+    return resolveConfiguredLocale(locale, {
+      defaultLocale,
+      aliasLookup,
+    });
   };
 
   const loadLocale = async ({ locale }) => {
@@ -268,6 +312,7 @@ export function createJSONLocalization(options = {}) {
     locales: [...locales],
     provider: {
       locales: [...locales],
+      resolveLocale: resolveEffectiveLocale,
       loadLocale,
     },
   };

package/src/js/common/localization.js

@@ -45,6 +45,15 @@ function __resolveLocaleCandidate(locale) {
   if (!normalized) {
     return __localizationState.defaultLocale;
   }
+
+  const resolveLocale = __localizationState.provider?.resolveLocale;
+  if (typeof resolveLocale === "function") {
+    const resolved = __normalizeLocale(resolveLocale(locale));
+    if (resolved) {
+      return resolved;
+    }
+  }
+
   return normalized;
 }
 
@@ -110,7 +119,14 @@ function __resolveProvider(config) {
         ? provider.setLocale
         : null;
 
-  if (!translate && !loadLocale && !setLocale) {
+  const resolveLocale =
+    typeof config?.resolveLocale === "function"
+      ? config.resolveLocale
+      : typeof provider?.resolveLocale === "function"
+        ? provider.resolveLocale
+        : null;
+
+  if (!translate && !loadLocale && !setLocale && !resolveLocale) {
     return null;
   }
 
@@ -118,6 +134,7 @@ function __resolveProvider(config) {
     translate,
     loadLocale,
     setLocale,
+    resolveLocale,
   };
 }
 
@@ -905,11 +922,18 @@ export function configureLocalization(config = null) {
     Object.prototype.hasOwnProperty.call(config, "provider") ||
     Object.prototype.hasOwnProperty.call(config, "translate") ||
     Object.prototype.hasOwnProperty.call(config, "loadLocale") ||
-    Object.prototype.hasOwnProperty.call(config, "setLocale")
+    Object.prototype.hasOwnProperty.call(config, "setLocale") ||
+    Object.prototype.hasOwnProperty.call(config, "resolveLocale")
   ) {
     __localizationState.provider = __resolveProvider(config);
   }
 
+  if (__localizationState.provider?.resolveLocale) {
+    __localizationState.defaultLocale = __resolveLocaleCandidate(
+      __localizationState.defaultLocale
+    );
+  }
+
   __attachLangObserver();
   __scheduleReconcile();
 

package/src/js/pds-core/pds-live.js

@@ -3,6 +3,7 @@
  * Separated to keep the base runtime bundle lean for production/static usage.
  */
 import { Generator } from "./pds-generator.js";
+import { msg } from "../common/localization.js";
 import { applyStyles, adoptLayers, adoptPrimitives } from "./pds-runtime.js";
 import {
   presets,
@@ -309,10 +310,10 @@ async function ensureLiveEditToggleButton() {
       return li;
     };
 
-    menu.appendChild(createItem("toggle", "Toggle live editing", "pencil"));
-    menu.appendChild(createItem("open-settings", "Open Settings", "gear"));
+    menu.appendChild(createItem("toggle", msg("Toggle live editing"), "pencil"));
+    menu.appendChild(createItem("open-settings", msg("Open Settings"), "gear"));
     menu.appendChild(createSeparator());
-    menu.appendChild(createItem("reset-config", "Reset Config", "arrow-counter-clockwise"));
+    menu.appendChild(createItem("reset-config", msg("Reset Config"), "arrow-counter-clockwise"));
 
     await ensureSharedQuickModeToggleMenuItem(menu);
 

package/src/js/pds.d.ts

@@ -124,6 +124,7 @@ export interface PDSLocalizationTranslateContext {
 
 export interface PDSLocalizationProvider {
   translate?: (context: PDSLocalizationTranslateContext) => string | undefined | null;
+  resolveLocale?: (locale: string) => string;
   loadLocale?: (context: {
     locale: string;
     defaultLocale: string;
@@ -154,6 +155,7 @@ export interface PDSLocalizationConfig {
   messages?: PDSLocalizationMessages;
   provider?: PDSLocalizationProvider;
   translate?: PDSLocalizationProvider["translate"];
+  resolveLocale?: PDSLocalizationProvider["resolveLocale"];
   loadLocale?: PDSLocalizationProvider["loadLocale"];
   setLocale?: PDSLocalizationProvider["setLocale"];
 }