@wix/multilingual-manager 1.0.0

package/README.md

@@ -0,0 +1,154 @@
+# @wix/multilingual
+
+A type-safe Wix Multilingual SDK for accessing available languages on a site. This package provides a browser-only interface that proxies to the global `window.multilingual` methods with full TypeScript support.
+
+## Installation
+
+```bash
+npm install @wix/multilingual
+```
+
+## Quick Start
+
+```typescript
+import { listSupportedLanguages } from "@wix/multilingual";
+
+// Get all available languages
+const languages = listSupportedLanguages();
+console.log("Available languages:", languages);
+
+// Find the primary language
+const primaryLanguage = languages.find(lang => lang.primary);
+if (primaryLanguage) {
+  console.log("Primary language:", primaryLanguage.displayName);
+  console.log("Primary language URL:", primaryLanguage.url);
+}
+
+// Iterate through all languages
+languages.forEach(lang => {
+  console.log(`${lang.displayName} (${lang.id}): ${lang.url}`);
+});
+```
+
+## Features
+
+- ✅ **Type-safe** - Full TypeScript support for all language operations
+- ✅ **Browser-only** - Works in Wix applications where `window.multilingual` is available
+- ✅ **Zero dependencies** - Lightweight proxy implementation
+- ✅ **Silent failure** - Graceful handling of missing dependencies with console warnings
+- ✅ **External site support** - Supports URLs for sites hosted outside Wix
+- ✅ **Comprehensive API** - Full access to language information including URLs and regional formats
+
+## API Reference
+
+### `listSupportedLanguages()`
+
+Gets an array of all available languages as defined in ML. Provides an array of all the available languages as defined in ML. Array of Language object.
+
+**Returns:** `Language[]` - Array of Language objects, or empty array if not available
+
+```typescript
+const languages = listSupportedLanguages();
+// [
+//   {
+//     id: "en",
+//     displayName: "English",
+//     regionalFormat: "en-US",
+//     url: "https://mysite.com/en",
+//     primary: true
+//   },
+//   {
+//     id: "fr",
+//     displayName: "Français",
+//     regionalFormat: "fr-FR",
+//     url: "https://mysite.com/fr",
+//     primary: false
+//   }
+// ]
+```
+
+## Language Type
+
+### Language
+
+Represents a language available on the site:
+
+```typescript
+interface Language {
+  /**
+   * The language identifier (e.g., "en", "fr", "es").
+   */
+  id: string;
+  /**
+   * The display name of the language (e.g., "English", "Français", "Español").
+   */
+  displayName: string;
+  /**
+   * The regional format identifier (e.g., "en-US", "fr-FR", "es-ES").
+   */
+  regionalFormat: string;
+  /**
+   * The URL for the language version of the site. Supports URLs for sites hosted outside Wix.
+   * (e.g., "https://mysite.com/en", "https://mysite.com/fr").
+   */
+  url: string;
+  /**
+   * Whether this is the primary language for the site.
+   */
+  primary: boolean;
+}
+```
+
+## Examples
+
+### Get Primary Language
+
+```typescript
+import { listSupportedLanguages } from "@wix/multilingual";
+
+const languages = listSupportedLanguages();
+const primaryLanguage = languages.find(lang => lang.primary);
+
+if (primaryLanguage) {
+  console.log(`Primary language: ${primaryLanguage.displayName}`);
+  console.log(`URL: ${primaryLanguage.url}`);
+}
+```
+
+### Build Language Switcher
+
+```typescript
+import { listSupportedLanguages } from "@wix/multilingual";
+
+const languages = listSupportedLanguages();
+
+// Create language switcher dropdown
+const languageSwitcher = languages.map(lang => ({
+  label: lang.displayName,
+  value: lang.id,
+  url: lang.url,
+  isPrimary: lang.primary,
+}));
+
+// Use in your UI component
+languageSwitcher.forEach(lang => {
+  console.log(`${lang.label} - ${lang.url}`);
+});
+```
+
+### Support External Sites
+
+```typescript
+import { listSupportedLanguages } from "@wix/multilingual";
+
+const languages = listSupportedLanguages();
+
+// Works with both Wix-hosted and externally-hosted sites
+languages.forEach(lang => {
+  // lang.url can be:
+  // - "https://mysite.com/en" (external site)
+  // - "https://www.wixsite.com/mysite/en" (Wix-hosted)
+  console.log(`Switch to ${lang.displayName}: ${lang.url}`);
+});
+```
+

package/dist/cjs/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @wix/multilingual - Wix Multilingual SDK
+ *
+ * This package provides a type-safe interface for accessing available languages
+ * by proxying to the browser's window.multilingual methods.
+ */
+import type { Language } from "./types.js";
+/**
+ * Gets an array of all available languages as defined in ML.
+ *
+ * Provides an array of all the available languages as defined in ML. Array of Language object.
+ * Supports URLs for sites hosted outside Wix.
+ *
+ * @returns Array of Language objects
+ *
+ * @example
+ * ```typescript
+ * import { listSupportedLanguages } from '@wix/site';
+ *
+ * const languages = listSupportedLanguages();
+ * languages.forEach(lang => {
+ *   console.log(`${lang.displayName} (${lang.id}): ${lang.URL}`);
+ * });
+ *
+ * // Find primary language
+ * const primaryLanguage = languages.find(lang => lang.primary);
+ * if (primaryLanguage) {
+ *   console.log('Primary language:', primaryLanguage.displayName);
+ * }
+ * ```
+ */
+export { listSupportedLanguages } from "./multilingual.js";
+export type { Language };
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAO,mBAAmB,CAAC;AAG5D,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * @wix/multilingual - Wix Multilingual SDK
+ *
+ * This package provides a type-safe interface for accessing available languages
+ * by proxying to the browser's window.multilingual methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSupportedLanguages = void 0;
+/**
+ * Gets an array of all available languages as defined in ML.
+ *
+ * Provides an array of all the available languages as defined in ML. Array of Language object.
+ * Supports URLs for sites hosted outside Wix.
+ *
+ * @returns Array of Language objects
+ *
+ * @example
+ * ```typescript
+ * import { listSupportedLanguages } from '@wix/site';
+ *
+ * const languages = listSupportedLanguages();
+ * languages.forEach(lang => {
+ *   console.log(`${lang.displayName} (${lang.id}): ${lang.URL}`);
+ * });
+ *
+ * // Find primary language
+ * const primaryLanguage = languages.find(lang => lang.primary);
+ * if (primaryLanguage) {
+ *   console.log('Primary language:', primaryLanguage.displayName);
+ * }
+ * ```
+ */
+var multilingual_js_1 = require("./multilingual.js");
+Object.defineProperty(exports, "listSupportedLanguages", { enumerable: true, get: function () { return multilingual_js_1.listSupportedLanguages; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qDAA4D;AAAnD,yHAAA,sBAAsB,OAAA"}

package/dist/cjs/languages-display-names.d.ts

@@ -0,0 +1,2 @@
+export declare const languagesDisplayNames: Record<string, string>;
+//# sourceMappingURL=languages-display-names.d.ts.map

package/dist/cjs/languages-display-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages-display-names.d.ts","sourceRoot":"","sources":["../../src/languages-display-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqLxD,CAAC"}

package/dist/cjs/languages-display-names.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languagesDisplayNames = void 0;
+exports.languagesDisplayNames = {
+    "cs": "Čeština",
+    "da": "Dansk",
+    "de": "Deutsch",
+    "en": "English",
+    "es": "Español",
+    "fr": "Français",
+    "hi": "हिन्दी",
+    "id": "Bahasa Indonesia",
+    "it": "Italiano",
+    "ja": "日本語",
+    "ko": "한국어",
+    "nl": "Nederlands",
+    "no": "Norsk",
+    "pl": "Polski",
+    "pt": "Português",
+    "ru": "Русский",
+    "sv": "Svenska",
+    "th": "ไทย",
+    "tr": "Türkçe",
+    "uk": "Українська",
+    "vi": "Tiếng Việt",
+    "zh": "繁體中文",
+    "sq": "Shqip",
+    "am": "አማርኛ",
+    "ar": "العربية",
+    "hy": "Հայերեն",
+    "az": "Azərbaycan dili",
+    "eu": "Euskara",
+    "be": "Беларуская",
+    "bn": "বাংলা",
+    "bs": "Bosanski",
+    "bg": "Български",
+    "ca": "Català",
+    "ny": "ChiCheŵa",
+    "co": "Corsu",
+    "hr": "Hrvatski",
+    "et": "Eesti",
+    "fj": "Vosa Vakaviti",
+    "fi": "Suomi",
+    "ga": "Gaeilge",
+    "gl": "Galego",
+    "ka": "ქართული",
+    "el": "Ελληνικά",
+    "gu": "ગુજરાતી",
+    "ht": "Kreyòl Ayisyen",
+    "ha": "Hausa",
+    "he": "עברית",
+    "hu": "Magyar",
+    "is": "Íslenska",
+    "ig": "Igbo",
+    "kn": "ಕನ್ನಡ",
+    "kk": "Қазақ тілі",
+    "km": "ភាសាខ្មែរ",
+    "ku": "Kurdî",
+    "ky": "Кыргызча",
+    "lb": "Lëtzebuergesch",
+    "lo": "ລາວ",
+    "la": "Latina",
+    "lv": "Latviešu",
+    "lt": "Lietuvių",
+    "mk": "Македонски",
+    "mg": "Malagasy",
+    "ms": "Bahasa Melayu",
+    "ml": "മലയാളം",
+    "mt": "Malti",
+    "mn": "Монгол",
+    "ne": "नेपाली",
+    "ps": "پښتو",
+    "fa": "فارسی",
+    "ro": "Română",
+    "sm": "Gagana Samoa",
+    "sr": "Српски",
+    "sn": "Shona",
+    "sd": "سنڌي",
+    "si": "සිංහල",
+    "sk": "Slovenčina",
+    "sl": "Slovenščina",
+    "so": "Soomaaliga",
+    "su": "Basa Sunda",
+    "sw": "Kiswahili",
+    "tl": "Filipino",
+    "tg": "Тоҷикӣ",
+    "ta": "தமிழ்",
+    "te": "తెలుగు",
+    "tk": "Türkmen",
+    "ur": "اردو",
+    "uz": "O'zbek",
+    "cy": "Cymraeg",
+    "xh": "isiXhosa",
+    "yi": "ייִדיש",
+    "yo": "Yorùbá",
+    "zu": "isiZulu",
+    "kl": "Kalaallisut",
+    "fo": "Føroyskt",
+    "ln": "Lingála",
+    "mi": "Māori",
+    "mr": "मराठी",
+    "my": "မြန်မာ",
+    "se": "Sámegiella",
+    "ug": "ئۇيغۇرچە",
+    "qu": "Runa Simi",
+    "aa": "Afar",
+    "ab": "Аҧсуа",
+    "ae": "Avestan",
+    "ak": "Akan",
+    "an": "Aragonés",
+    "as": "অসমীয়া",
+    "av": "Авар",
+    "ay": "Aymar aru",
+    "ba": "Башҡортса",
+    "bh": "भोजपुरी",
+    "bi": "Bislama",
+    "bm": "Bamanankan",
+    "bo": "བོད་སྐད་",
+    "br": "Brezhoneg",
+    "ce": "Нохчийн",
+    "ch": "Chamoru",
+    "cr": "ᓀᐦᐃᔭᐍᐏᐣ",
+    "cu": "Црькъвьнословѣньскъ",
+    "cv": "Чӑвашла",
+    "dv": "ދިވެހިބަސް",
+    "dz": "རྫོང་ཁ",
+    "ee": "Eʋegbe",
+    "eo": "Esperanto",
+    "ff": "Fulah",
+    "fy": "Frysk",
+    "gd": "Gàidhlig",
+    "gn": "Avañe'ẽ",
+    "gv": "Gaelg",
+    "ho": "Hiri Motu",
+    "hz": "Otjiherero",
+    "ia": "Interlingua",
+    "ie": "Interlingue",
+    "ii": "ꆈꌠꉙ",
+    "ik": "Iñupiaq",
+    "io": "Ido",
+    "iu": "ᐃᓄᒃᑎᑐᑦ",
+    "jv": "Basa Jawa",
+    "ki": "Gikuyu",
+    "kr": "Kanuri",
+    "ks": "کٲشُر",
+    "kw": "Kernewek",
+    "lg": "Luganda",
+    "li": "Limburgs",
+    "lu": "Tshiluba",
+    "mh": "Kajin M̧ajeļ",
+    "na": "Dorerin Naoero",
+    "nb": "Norsk Bokmål",
+    "nd": "isiNdebele",
+    "ng": "Oshiwambo",
+    "nn": "Norsk Nynorsk",
+    "nr": "isiNdebele (South)",
+    "nv": "Diné Bizaad",
+    "oc": "Occitan",
+    "oj": "Anishinaabemowin",
+    "om": "Afaan Oromoo",
+    "or": "ଓଡ଼ିଆ",
+    "os": "Ирон",
+    "pa": "ਪੰਜਾਬੀ",
+    "pi": "𑀅𑀯𑀢",
+    "rm": "Rumantsch",
+    "rn": "Ikirundi",
+    "rw": "Kinyarwanda",
+    "sa": "संस्कृतम्",
+    "sc": "Sardu",
+    "sg": "Sängö",
+    "ss": "SiSwati",
+    "st": "Sesotho",
+    "ti": "ትግርኛ",
+    "tn": "Setswana",
+    "to": "Faka Tonga",
+    "ts": "Xitsonga",
+    "tt": "Татарча",
+    "tw": "Twi",
+    "ty": "Reo Tahiti",
+    "ve": "Tshivenḓa",
+    "vo": "Volapük",
+    "wa": "Walon",
+    "wo": "Wolof",
+    "za": "Saɯ cueŋƅ"
+};
+//# sourceMappingURL=languages-display-names.js.map

package/dist/cjs/languages-display-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages-display-names.js","sourceRoot":"","sources":["../../src/languages-display-names.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAA2B;IAC3D,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,WAAW;CAClB,CAAC"}

package/dist/cjs/multilingual.d.ts

@@ -0,0 +1,37 @@
+import type { GlobalThisSupportedLanguage, VeloGlobalsSiteLanguage, Language } from "./types.js";
+/**
+ * Gets an array of all available languages as defined in ML.
+ *
+ * Provides an array of all the available languages as defined in ML. Array of Language object.
+ * Supports URLs for sites hosted outside Wix.
+ *
+ * @returns Array of Language objects, or empty array if not available
+ *
+ * @example Get available languages
+ * ```typescript
+ * import { listSupportedLanguages } from '@wix/site';
+ *
+ * const languages = listSupportedLanguages();
+ * console.log('Available languages:', languages);
+ * // [
+ * //   {
+ * //     id: "en",
+ * //     displayName: "English",
+ * //     regionalFormat: "en-US",
+ * //     URL: "https://mysite.com/en",
+ * //     primary: true
+ * //   },
+ * //   {
+ * //     id: "fr",
+ * //     displayName: "Français",
+ * //     regionalFormat: "fr-FR",
+ * //     URL: "https://mysite.com/fr",
+ * //     primary: false
+ * //   }
+ * // ]
+ * ```
+ */
+export declare function listSupportedLanguages(): Language[];
+export declare function buildDisplayName(language: VeloGlobalsSiteLanguage | GlobalThisSupportedLanguage): string | undefined;
+export declare function buildUrlForLanguage(language: VeloGlobalsSiteLanguage | GlobalThisSupportedLanguage, cleanUrl: string): string | undefined;
+//# sourceMappingURL=multilingual.d.ts.map

package/dist/cjs/multilingual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multilingual.d.ts","sourceRoot":"","sources":["../../src/multilingual.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,QAAQ,EAET,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,IAAI,QAAQ,EAAE,CASnD;AAoED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,2BAA2B,GAAG,MAAM,GAAG,SAAS,CAapH;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,2BAA2B,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0BzI"}

package/dist/cjs/multilingual.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSupportedLanguages = listSupportedLanguages;
+exports.buildDisplayName = buildDisplayName;
+exports.buildUrlForLanguage = buildUrlForLanguage;
+const types_js_1 = require("./types.js");
+const languages_display_names_js_1 = require("./languages-display-names.js");
+const headless_localization_utils_1 = require("@wix/headless-localization-utils");
+/**
+ * Gets an array of all available languages as defined in ML.
+ *
+ * Provides an array of all the available languages as defined in ML. Array of Language object.
+ * Supports URLs for sites hosted outside Wix.
+ *
+ * @returns Array of Language objects, or empty array if not available
+ *
+ * @example Get available languages
+ * ```typescript
+ * import { listSupportedLanguages } from '@wix/site';
+ *
+ * const languages = listSupportedLanguages();
+ * console.log('Available languages:', languages);
+ * // [
+ * //   {
+ * //     id: "en",
+ * //     displayName: "English",
+ * //     regionalFormat: "en-US",
+ * //     URL: "https://mysite.com/en",
+ * //     primary: true
+ * //   },
+ * //   {
+ * //     id: "fr",
+ * //     displayName: "Français",
+ * //     regionalFormat: "fr-FR",
+ * //     URL: "https://mysite.com/fr",
+ * //     primary: false
+ * //   }
+ * // ]
+ * ```
+ */
+function listSupportedLanguages() {
+    const multilingualObject = getMultilingualObject();
+    if (!multilingualObject) {
+        return [];
+    }
+    const languages = getLanguages(multilingualObject);
+    return languages;
+}
+function getMultilingualObject() {
+    const maybeMultilingualVeloObject = 
+    // @ts-expect-error - ignoring globals type error
+    typeof globals !== "undefined"
+        ? // @ts-expect-error - ignoring globals type error
+            globals?.$ns?.["wix-window"]?.multilingual
+        : undefined;
+    const maybeMultilingualWindowObject = typeof window !== "undefined" ? window?.essentials?.multilingual : undefined;
+    return (maybeMultilingualVeloObject ?? maybeMultilingualWindowObject ?? globalThis?.__wix_site_metadata__?.multilingual);
+}
+function getLanguages(multilingualObject) {
+    try {
+        // GlobalThisSupportedLanguage
+        if (multilingualObject?.supportedLanguages?.length) {
+            const supportedLanguages = multilingualObject.supportedLanguages;
+            const availableLanguageCodes = supportedLanguages.map(lang => lang.languageCode).filter(Boolean);
+            const cleanUrl = cleanCurrentUrl(availableLanguageCodes);
+            return supportedLanguages.map((language) => {
+                return {
+                    id: language.languageCode,
+                    displayName: buildDisplayName(language),
+                    regionalFormat: [
+                        language.locale?.languageCode,
+                        language.locale?.country,
+                    ]
+                        .filter(Boolean)
+                        .join("-"),
+                    url: buildUrlForLanguage(language, cleanUrl),
+                    primary: language.isPrimary,
+                };
+            });
+        }
+        // VeloGlobalsSiteLanguage
+        else if (multilingualObject?.siteLanguages?.length) {
+            const siteLanguages = multilingualObject.siteLanguages;
+            const availableLanguageCodes = siteLanguages.map(lang => lang.languageCode).filter(Boolean);
+            const cleanUrl = cleanCurrentUrl(availableLanguageCodes);
+            return siteLanguages.map((language) => {
+                return {
+                    id: language.languageCode,
+                    displayName: buildDisplayName(language),
+                    regionalFormat: language.locale,
+                    url: buildUrlForLanguage(language, cleanUrl),
+                    primary: language.isPrimaryLanguage,
+                };
+            });
+        }
+    }
+    catch (error) {
+        console.warn("[Multilingual Manager] listSupportedLanguages failed", error);
+        return [];
+    }
+    console.warn("[Multilingual Manager] listSupportedLanguages is not available");
+    return [];
+}
+function buildDisplayName(language) {
+    const staticDisplayName = languages_display_names_js_1.languagesDisplayNames[language.languageCode];
+    if (staticDisplayName) {
+        return staticDisplayName;
+    }
+    const dynamicDisplayName = language.name ?? language.countryCode;
+    if (dynamicDisplayName) {
+        return dynamicDisplayName;
+    }
+    return undefined;
+}
+function buildUrlForLanguage(language, cleanUrl) {
+    // If language already has a URL, or we don't have the necessary data, return as is
+    if (language.url || typeof window === "undefined" || !window.location.href || !language.resolutionMethod) {
+        return language.url;
+    }
+    const targetLangCode = language.languageCode;
+    if (!targetLangCode) {
+        return undefined;
+    }
+    try {
+        return (0, headless_localization_utils_1.applyLanguageToUrl)(cleanUrl, {
+            languageCode: language.languageCode,
+            countryCode: language.countryCode,
+            resolutionMethod: toResolutionMethodEnum(language.resolutionMethod),
+            locale: {
+                languageCode: language.languageCode,
+                country: language.countryCode,
+            }
+        });
+    }
+    catch (error) {
+        console.warn("[Multilingual Manager] buildUrlForLanguage failed", error);
+        return undefined;
+    }
+}
+function toResolutionMethodEnum(resolutionMethod) {
+    switch (resolutionMethod) {
+        case "QUERY_PARAM":
+        case "QueryParam":
+            return types_js_1.ResolutionMethod.QUERY_PARAM;
+        case "SUBDOMAIN":
+        case "Subdomain":
+            return types_js_1.ResolutionMethod.SUBDOMAIN;
+        case "SUBDIRECTORY":
+        case "Subdirectory":
+            return types_js_1.ResolutionMethod.SUBDIRECTORY;
+        default:
+            return undefined;
+    }
+}
+function cleanCurrentUrl(supportedLanguageCodes) {
+    const currentUrl = typeof window !== "undefined" && window.location?.href ? window.location.href : "";
+    try {
+        return (0, headless_localization_utils_1.clearLanguageFromUrl)(currentUrl, supportedLanguageCodes);
+    }
+    catch (error) {
+        // If clearLanguageFromUrl fails (e.g., invalid URL), just return the current URL
+        console.warn("[Multilingual Manager] cleanCurrentUrl failed", error);
+        return currentUrl;
+    }
+}
+//# sourceMappingURL=multilingual.js.map

package/dist/cjs/multilingual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multilingual.js","sourceRoot":"","sources":["../../src/multilingual.ts"],"names":[],"mappings":"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"}