mediasfu-shared 1.0.3 → 1.0.5

package/package.json

@@ -1,96 +1,99 @@
-{
-  "name": "mediasfu-shared",
-  "version": "1.0.3",
-  "description": "Framework-agnostic MediaSFU WebRTC runtime for room creation, joining, mediasoup signaling, sockets, media state, translation, and reusable SDK types",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./consumers": {
-      "types": "./dist/consumers/index.d.ts",
-      "import": "./dist/consumers/index.js",
-      "require": "./dist/consumers/index.cjs"
-    },
-    "./methods": {
-      "types": "./dist/methods/index.d.ts",
-      "import": "./dist/methods/index.js",
-      "require": "./dist/methods/index.cjs"
-    },
-    "./types": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/types/index.js",
-      "require": "./dist/types/index.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc && vite build",
-    "build-docs": "typedoc",
-    "dev": "vite build --watch",
-    "test:staging:smoke": "npm run build && node ./scripts/staging-room-smoke-test.cjs",
-    "type-check": "tsc --noEmit"
-  },
-  "keywords": [
-    "mediasfu",
-    "webrtc",
-    "webRTC",
-    "mediasoup",
-    "sfu",
-    "video-conferencing",
-    "video-call",
-    "audio-call",
-    "socket.io",
-    "real-time-communication",
-    "real-time-media",
-    "room-management",
-    "screen-sharing",
-    "recording",
-    "live-streaming",
-    "webinar",
-    "broadcasting",
-    "whiteboard",
-    "live-subtitles",
-    "translation",
-    "framework-agnostic",
-    "typescript",
-    "mediasfu-shared"
-  ],
-  "author": "MediaSFU",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/MediaSFU/MediaSFU-Shared"
-  },
-  "homepage": "https://github.com/MediaSFU/MediaSFU-Shared",
-  "bugs": {
-    "url": "https://github.com/MediaSFU/MediaSFU-Shared/issues",
-    "email": "info@mediasfu.com"
-  },
-  "peerDependencies": {
-    "mediasoup-client": "^3.16.0",
-    "socket.io-client": "^4.8.0"
-  },
-  "dependencies": {
-    "universal-cookie": "^7.2.2"
-  },
-  "devDependencies": {
-    "mediasoup-client": "^3.16.0",
-    "socket.io-client": "^4.8.0",
-    "typedoc": "^0.28.14",
-    "typedoc-plugin-extras": "^4.0.1",
-    "typescript": "^5.9.3",
-    "vite": "^7.1.9",
-    "vite-plugin-dts": "^4.3.0"
-  }
-}
+{
+  "name": "mediasfu-shared",
+  "version": "1.0.5",
+  "description": "mediasfu-shared – framework-agnostic WebRTC runtime for MediaSFU. Room helpers, mediasoup signaling, socket management, media state, and TypeScript types for React, Vue, Angular, Svelte, and plain TS.",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./consumers": {
+      "types": "./dist/consumers/index.d.ts",
+      "import": "./dist/consumers/index.js",
+      "require": "./dist/consumers/index.cjs"
+    },
+    "./methods": {
+      "types": "./dist/methods/index.d.ts",
+      "import": "./dist/methods/index.js",
+      "require": "./dist/methods/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && vite build",
+    "build-docs": "typedoc",
+    "dev": "vite build --watch",
+    "test:staging:smoke": "npm run build && node ./scripts/staging-room-smoke-test.cjs",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "mediasfu",
+    "mediasfu-shared",
+    "webrtc",
+    "mediasoup",
+    "socket.io",
+    "sfu",
+    "video conferencing",
+    "video call",
+    "webinar",
+    "live streaming",
+    "recording",
+    "whiteboard",
+    "translation",
+    "live subtitles",
+    "room management",
+    "screen sharing",
+    "real-time communication",
+    "framework-agnostic",
+    "typescript",
+    "react",
+    "vue",
+    "angular",
+    "svelte",
+    "mediasfu sdk",
+    "mediasfu runtime",
+    "mediasfu shared"
+  ],
+  "author": "MediaSFU",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MediaSFU/MediaSFU-Shared"
+  },
+  "homepage": "https://www.npmjs.com/package/mediasfu-shared",
+  "bugs": {
+    "url": "https://github.com/MediaSFU/MediaSFU-Shared/issues",
+    "email": "info@mediasfu.com"
+  },
+  "peerDependencies": {
+    "mediasoup-client": "^3.20.0",
+    "socket.io-client": "^4.8.0"
+  },
+  "dependencies": {
+    "universal-cookie": "^7.2.2"
+  },
+  "devDependencies": {
+    "mediasoup-client": "^3.20.0",
+    "socket.io-client": "^4.8.0",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-extras": "^4.0.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.9",
+    "vite-plugin-dts": "^4.3.0"
+  }
+}

package/src/index.native.ts

@@ -0,0 +1,220 @@
+export * from './consumers/autoAdjust';
+export * from './consumers/calculateRowsAndColumns';
+export * from './consumers/changeVids';
+export * from './consumers/checkGrid';
+export * from './consumers/checkPermission';
+export * from './consumers/checkScreenShare';
+export * from './consumers/closeAndResize';
+export * from './consumers/compareActiveNames';
+export * from './consumers/compareScreenStates';
+export * from './consumers/gridLayout/addVideosGrid.engine';
+export * from './consumers/gridLayout/prepopulateUserMedia.engine';
+export * from './consumers/connectIps';
+export * from './consumers/connectLocalIps';
+export * from './consumers/connectRecvTransport';
+export * from './consumers/connectSendTransport';
+export * from './consumers/connectSendTransportAudio';
+export * from './consumers/consumerResume';
+export * from './consumers/connectSendTransportScreen';
+export * from './consumers/connectSendTransportVideo';
+export * from './consumers/controlMedia';
+export * from './consumers/createSendTransport';
+export * from './consumers/disconnectSendTransportAudio';
+export * from './consumers/disconnectSendTransportScreen';
+export * from './consumers/disconnectSendTransportVideo';
+export * from './consumers/dispStreams';
+export * from './consumers/generatePageContent';
+export * from './consumers/getEstimate';
+export * from './consumers/getPipedProducersAlt';
+export * from './consumers/getProducersPiped';
+export * from './consumers/getVideos';
+export * from './consumers/mixStreams';
+export * from './consumers/onScreenChanges';
+export * from './consumers/processConsumerTransports';
+export * from './consumers/processConsumerTransportsAudio';
+export * from './consumers/readjust';
+export * from './consumers/receiveAllPipedTransports';
+export * from './consumers/receiveRoomMessages';
+export * from './consumers/reorderStreams';
+export * from './consumers/rePort';
+export * from './consumers/requestScreenShare';
+export * from './consumers/resumePauseAudioStreams';
+export * from './consumers/resumePauseStreams';
+export * from './consumers/resumeSendTransportAudio';
+export * from './consumers/reUpdateInter';
+export * from './consumers/signalNewConsumerTransport';
+export * from './consumers/socketReceiveMethods/joinConsumeRoom';
+export * from './consumers/socketReceiveMethods/newPipeProducer';
+export * from './consumers/socketReceiveMethods/producerClosed';
+export * from './consumers/startShareScreen';
+export * from './consumers/stopShareScreen';
+export * from './consumers/streamSuccessAudio';
+export * from './consumers/streamSuccessAudioSwitch';
+export * from './consumers/streamSuccessScreen';
+export * from './consumers/streamSuccessVideo';
+export * from './consumers/switchUserAudio';
+export * from './consumers/switchUserVideo';
+export * from './consumers/switchUserVideoAlt';
+export * from './consumers/translationConsumerSwitch';
+export * from './consumers/trigger';
+export * from './consumers/updateMiniCardsGrid';
+export * from './consumers/updateParticipantAudioDecibels';
+
+export * from './methods/background/launchBackground';
+export * from './methods/breakoutRooms/breakoutRoomUpdated';
+export * from './methods/breakoutRooms/handleStartBreakout';
+export * from './methods/breakoutRooms/handleStopBreakout';
+export * from './methods/breakoutRooms/launchBreakoutRooms';
+export * from './methods/coHost/launchCoHost';
+export * from './methods/coHostMethods/modifyCoHostSettings';
+export * from './methods/displaySettings/launchDisplaySettings';
+export * from './methods/displaySettings/modifyDisplaySettings';
+export * from './methods/exit/confirmExit';
+export * from './methods/exit/launchConfirmExit';
+export * from './methods/mediaSettings/launchMediaSettings';
+export * from './methods/menu/launchMenuModal';
+export * from './methods/message/launchMessages';
+export * from './methods/message/sendMessage';
+export * from './methods/participants/launchParticipants';
+export * from './methods/participants/messageParticipants';
+export * from './methods/participants/muteParticipants';
+export * from './methods/participants/removeParticipants';
+export * from './methods/panelists/launchPanelists';
+export * from './methods/panelists/updatePanelists';
+export * from './methods/panelists/focusPanelists';
+export * from './methods/permissions/launchPermissions';
+export * from './methods/permissions/updateParticipantPermission';
+export * from './methods/permissions/updatePermissionConfig';
+export * from './methods/polls/handleCreatePoll';
+export * from './methods/polls/handleEndPoll';
+export * from './methods/polls/handleVotePoll';
+export * from './methods/polls/launchPoll';
+export * from './methods/polls/pollUpdated';
+export * from './methods/prejoin/handleCreateRoom';
+export * from './methods/prejoin/handleJoinRoom';
+export * from './methods/recording/checkPauseState';
+export * from './methods/recording/checkResumeState';
+export * from './methods/recording/confirmRecording';
+export * from './methods/recording/launchRecording';
+export * from './methods/recording/recordPauseTimer';
+export * from './methods/recording/recordResumeTimer';
+export * from './methods/recording/recordStartTimer';
+export * from './methods/recording/recordUpdateTimer';
+export * from './methods/recording/startRecording';
+export * from './methods/recording/stopRecording';
+export * from './methods/recording/timeLeftRecording';
+export * from './methods/recording/updateRecording';
+export * from './methods/requests/launchRequests';
+export * from './methods/requests/hostRequestResponse';
+export * from './methods/requests/respondToRequests';
+export * from './methods/settings/launchSettings';
+export * from './methods/settings/modifySettings';
+export * from './methods/stream/switchAudio';
+export * from './methods/stream/switchVideo';
+export * from './methods/stream/switchVideoAlt';
+export * from './methods/stream/clickAudio';
+export * from './methods/stream/clickChat';
+export * from './methods/stream/clickScreenShare';
+export * from './methods/utils/liveSubtitle';
+export * from './methods/utils/translationLanguages';
+export * from './methods/utils/SoundPlayer';
+export * from './methods/utils/getOverlayPosition';
+export * from './methods/utils/getModalPosition';
+export * from './methods/utils/sleep';
+export * from './methods/utils/formatNumber';
+export * from './methods/utils/generateRandomMessages';
+export * from './methods/utils/generateRandomParticipants';
+export * from './methods/utils/generateRandomPolls';
+export * from './methods/utils/generateRandomRequestList';
+export * from './methods/utils/generateRandomWaitingRoomList';
+export * from './methods/utils/initialValuesState';
+export * from './methods/utils/webrtc';
+export * from './methods/utils/checkLimitsAndMakeRequest';
+export * from './methods/utils/createResponseJoinRoom';
+export * from './methods/utils/joinRoomOnMediaSFU';
+export * from './methods/utils/createRoomOnMediaSFU';
+export * from './methods/utils/meetingTimer/startMeetingProgressTimer';
+export * from './methods/utils/meetingTimeRemaining';
+export * from './methods/utils/producer/aParams';
+export * from './methods/utils/producer/hParams';
+export * from './methods/utils/producer/vParams';
+export * from './methods/utils/producer/screenParams';
+export * from './methods/utils/producer/videoCaptureConstraints';
+export * from './methods/utils/validateAlphanumeric';
+export * from './methods/socketReceive/allWaitingRoomMembers';
+export * from './methods/socketReceive/allMembers';
+export * from './methods/socketReceive/allMembersRest';
+export * from './methods/socketReceive/banParticipant';
+export * from './methods/socketReceive/controlMediaHost';
+export * from './methods/socketReceive/disconnect';
+export * from './methods/socketReceive/disconnectUserSelf';
+export * from './methods/socketReceive/getDomains';
+export * from './methods/socketReceive/meetingEnded';
+export * from './methods/socketReceive/meetingStillThere';
+export {
+	type PanelistData,
+	type PanelistsUpdatedData,
+	type PanelistFocusChangedData,
+	type ControlMediaData,
+	type AddedAsPanelistData,
+	type RemovedFromPanelistsData,
+	type PanelistsUpdatedOptions,
+	type PanelistFocusChangedOptions,
+	type ControlMediaOptions as PanelistControlMediaOptions,
+	type AddedAsPanelistOptions,
+	type RemovedFromPanelistsOptions,
+	type PanelistsUpdatedType,
+	type PanelistFocusChangedType,
+	type ControlMediaType as PanelistControlMediaType,
+	type AddedAsPanelistType,
+	type RemovedFromPanelistsType,
+	panelistsUpdated,
+	panelistFocusChanged,
+	panelistControlMedia,
+	addedAsPanelist,
+	removedFromPanelists,
+} from './methods/socketReceive/panelistReceiveMethods';
+export * from './methods/socketReceive/participantRequested';
+export * from './methods/socketReceive/permissionReceiveMethods';
+export * from './methods/socketReceive/personJoined';
+export * from './methods/socketReceive/producerMediaClosed';
+export * from './methods/socketReceive/producerMediaPaused';
+export * from './methods/socketReceive/producerMediaResumed';
+export * from './methods/socketReceive/receiveMessage';
+export * from './methods/socketReceive/recordingNotice';
+export * from './methods/socketReceive/reInitiateRecording';
+export * from './methods/socketReceive/roomRecordParams';
+export * from './methods/socketReceive/screenProducerId';
+export * from './methods/socketReceive/startRecords';
+export * from './methods/socketReceive/stoppedRecording';
+export * from './methods/socketReceive/translationReceiveMethods';
+export * from './methods/socketReceive/updateMediaSettings';
+export * from './methods/socketReceive/updateConsumingDomains';
+export * from './methods/socketReceive/updatedCoHost';
+export * from './methods/socketReceive/userWaiting';
+export * from './methods/waiting/launchWaiting';
+export * from './methods/waiting/respondToWaiting';
+export {
+	handleWelcomeRequest,
+	validateAlphanumeric as validateWelcomeAlphanumeric,
+	validateWelcomeInputs,
+} from './methods/welcome/handleWelcomeRequest';
+export type {
+	HandleWelcomeRequestOptions,
+	ValidateWelcomeInputsOptions,
+} from './methods/welcome/handleWelcomeRequest';
+export * from './methods/whiteboard/handleStartWhiteboard';
+export * from './methods/whiteboard/handleStopWhiteboard';
+export * from './methods/whiteboard/launchConfigureWhiteboard';
+export * from './methods/whiteboard/captureCanvasStream';
+
+export * from './ProducerClient/producerClientEmits/joinRoomClient';
+export * from './ProducerClient/producerClientEmits/updateRoomParametersClient';
+
+export * from './producers/producerEmits/joinConRoom';
+export * from './producers/producerEmits/joinLocalRoom';
+export * from './producers/producerEmits/joinRoom';
+
+export * from './sockets/SocketManager';
+
+export * from './methods/stream/clickVideo';

package/src/index.ts

@@ -155,7 +155,29 @@ export * from './methods/socketReceive/disconnectUserSelf';
 export * from './methods/socketReceive/getDomains';
 export * from './methods/socketReceive/meetingEnded';
 export * from './methods/socketReceive/meetingStillThere';
-export * from './methods/socketReceive/panelistReceiveMethods';
+export {
+	type PanelistData,
+	type PanelistsUpdatedData,
+	type PanelistFocusChangedData,
+	type ControlMediaData,
+	type AddedAsPanelistData,
+	type RemovedFromPanelistsData,
+	type PanelistsUpdatedOptions,
+	type PanelistFocusChangedOptions,
+	type ControlMediaOptions as PanelistControlMediaOptions,
+	type AddedAsPanelistOptions,
+	type RemovedFromPanelistsOptions,
+	type PanelistsUpdatedType,
+	type PanelistFocusChangedType,
+	type ControlMediaType as PanelistControlMediaType,
+	type AddedAsPanelistType,
+	type RemovedFromPanelistsType,
+	panelistsUpdated,
+	panelistFocusChanged,
+	panelistControlMedia,
+	addedAsPanelist,
+	removedFromPanelists,
+} from './methods/socketReceive/panelistReceiveMethods';
 export * from './methods/socketReceive/participantRequested';
 export * from './methods/socketReceive/permissionReceiveMethods';
 export * from './methods/socketReceive/personJoined';

package/src/methods/message/sendMessage.ts

@@ -85,6 +85,9 @@ export const sendMessage = async ({
   chatSetting,
 }: SendMessageOptions): Promise<void> => {
   let chatValue = false;
+  const normalizedReceivers = (receivers ?? []).filter(
+    (receiver): receiver is string => typeof receiver === "string" && receiver.trim().length > 0,
+  );
 
   // Check message count limit based on room type prefix
   if (
@@ -110,8 +113,9 @@ export const sendMessage = async ({
     return;
   }
 
-  // Check if receivers is valid
-  if (receivers.length < 1 && group === false) {
+  // Hosts need an explicit recipient. Attendees can open a direct thread to the host
+  // without first replying to an existing message.
+  if (normalizedReceivers.length < 1 && group === false && islevel === "2") {
     showAlert?.({
       message: "Please select a message to reply to",
       type: "danger",
@@ -123,7 +127,7 @@ export const sendMessage = async ({
   // Create message object
   const messageObject: Message = {
     sender: sender ? sender : member,
-    receivers: receivers,
+    receivers: normalizedReceivers,
     message: message,
     timestamp: new Date().toLocaleTimeString(),
     group: group !== undefined && group !== null ? group : false,

package/src/methods/utils/resolveMediaSFURoomApi.ts

@@ -2,6 +2,9 @@ const DEFAULT_MEDIA_SFU_ROOM_API_URL = 'https://mediasfu.com/v1/rooms/';
 
 type MediaSFURoomApiAction = 'createRoom' | 'joinRoom';
 
+const getDefaultMediaSFURoomApiUrl = (): string =>
+  DEFAULT_MEDIA_SFU_ROOM_API_URL;
+
 const normalizeManagedRoomApi = (normalizedLink: string): string => {
   if (normalizedLink.includes('/v1/rooms')) {
     return `${normalizedLink.replace(/\/$/, '')}/`;
@@ -17,7 +20,7 @@ export const resolveMediaSFURoomApi = (
   const normalizedLink = localLink?.trim();
 
   if (!normalizedLink) {
-    return DEFAULT_MEDIA_SFU_ROOM_API_URL;
+    return getDefaultMediaSFURoomApiUrl();
   }
 
   if (normalizedLink.includes('mediasfu.com')) {

package/src/methods/utils/translationLanguages.ts

@@ -105,13 +105,45 @@ const TTS_SUPPORT_BY_LANGUAGE: Record<string, TTSSupport> = {
   auto: 'n/a',
 };
 
+/** Static English language names used as a fallback when Intl.DisplayNames is
+ *  unavailable or returns an empty string (e.g. older Hermes on Android). */
+const LANGUAGE_NAMES_EN: Record<string, string> = {
+  en: 'English', es: 'Spanish', fr: 'French', de: 'German', it: 'Italian',
+  pt: 'Portuguese', nl: 'Dutch', ru: 'Russian', zh: 'Chinese', ja: 'Japanese',
+  ko: 'Korean', ar: 'Arabic', hi: 'Hindi', bn: 'Bengali', pa: 'Punjabi',
+  te: 'Telugu', mr: 'Marathi', ta: 'Tamil', ur: 'Urdu', gu: 'Gujarati',
+  kn: 'Kannada', ml: 'Malayalam', ne: 'Nepali', si: 'Sinhala',
+  tr: 'Turkish', pl: 'Polish', vi: 'Vietnamese', th: 'Thai',
+  id: 'Indonesian', ms: 'Malay', tl: 'Filipino', km: 'Khmer',
+  lo: 'Lao', my: 'Burmese',
+  sw: 'Swahili', yo: 'Yoruba', ha: 'Hausa', ig: 'Igbo', zu: 'Zulu',
+  xh: 'Xhosa', af: 'Afrikaans', st: 'Sesotho', tn: 'Tswana', sn: 'Shona',
+  am: 'Amharic', so: 'Somali', rw: 'Kinyarwanda', mg: 'Malagasy',
+  ny: 'Chichewa', ee: 'Ewe', tw: 'Twi', gaa: 'Ga',
+  he: 'Hebrew', fa: 'Persian', ps: 'Pashto', ku: 'Kurdish',
+  uk: 'Ukrainian', el: 'Greek', cs: 'Czech', ro: 'Romanian',
+  hu: 'Hungarian', sv: 'Swedish', da: 'Danish', no: 'Norwegian',
+  fi: 'Finnish', sk: 'Slovak', bg: 'Bulgarian', hr: 'Croatian',
+  et: 'Estonian', lt: 'Lithuanian', lv: 'Latvian', sl: 'Slovenian',
+  sr: 'Serbian', bs: 'Bosnian', mk: 'Macedonian', is: 'Icelandic',
+  ga: 'Irish', cy: 'Welsh', mt: 'Maltese', lb: 'Luxembourgish',
+  sq: 'Albanian', be: 'Belarusian',
+  ka: 'Georgian', hy: 'Armenian', az: 'Azerbaijani',
+  eu: 'Basque', gl: 'Galician', ca: 'Catalan', la: 'Latin', eo: 'Esperanto',
+  kk: 'Kazakh', uz: 'Uzbek', tg: 'Tajik', ky: 'Kyrgyz', tk: 'Turkmen',
+  mn: 'Mongolian',
+};
+
 const getDisplayName = (code: string, locale: string, fallback: string) => {
   try {
     const displayNames = new Intl.DisplayNames([locale], { type: 'language' });
-    return displayNames.of(code) || fallback;
+    const result = displayNames.of(code);
+    if (result) return result;
   } catch {
-    return fallback;
+    // Intl.DisplayNames unavailable on this runtime (e.g. older Hermes)
   }
+  // Fall back to the static English map, then the uppercase-code fallback.
+  return LANGUAGE_NAMES_EN[code] ?? fallback;
 };
 
 export const normalizeLanguageCode = (code: string): string => {
@@ -169,6 +201,36 @@ export const getSupportedLanguages = (displayLocale = 'en'): LanguageOption[] =>
   }).sort((left, right) => left.name.localeCompare(right.name));
 };
 
+/**
+ * Curated list of the most widely-supported language codes for real-time translation.
+ * This set covers the languages supported by major STT/TTS/translation providers
+ * (Google, Azure, Deepgram, OpenAI, DeepL, etc.) and is the default shown in UI pickers.
+ * Use getSupportedLanguages() if you need the full extended list.
+ */
+export const COMMON_LANGUAGE_CODES: string[] = [
+  'en', 'es', 'fr', 'de', 'it', 'pt', 'nl', 'ru', 'zh', 'ja', 'ko', 'ar',
+  'hi', 'bn', 'tr', 'pl', 'vi', 'th', 'id', 'ms',
+  'sw', 'yo', 'ha', 'ig', 'zu', 'am', 'tw',
+  'he', 'fa', 'uk', 'el', 'cs', 'ro', 'hu', 'sv', 'da', 'no', 'fi',
+];
+
+/**
+ * Returns the curated list of commonly-supported languages for translation UI pickers.
+ * Sorted alphabetically by display name.
+ */
+export const getCommonLanguages = (displayLocale = 'en'): LanguageOption[] => {
+  return COMMON_LANGUAGE_CODES.map((code) => {
+    const metadata = getLanguageMetadata(code);
+    return {
+      code,
+      name: getLanguageName(code, displayLocale),
+      nativeName: metadata.nativeName,
+      region: metadata.region,
+      ttsSupport: metadata.ttsSupport,
+    };
+  }).sort((left, right) => left.name.localeCompare(right.name));
+};
+
 export type TTSProvider =
   | 'deepgram'
   | 'openai'