poe-svelte-ui-lib 1.45.0 → 1.47.0

package/README.md

@@ -110,6 +110,8 @@ npm install poe-svelte-ui-lib
 
 **README компонента** (`src/lib/<Компонент>/README.md`, вкладка «Инфо» витрины) — развёрнутая документация для разработчика. Первые разделы повторяют описание (i) и не должны ему противоречить, дальше идут разработческие: `## Назначение` (плюс заметка о размерах) → `## Пакет данных` (плюс `### Протокол устройства` / пример кода прошивки) → `## Ключи` (таблица «Ключ / Описание», те же формулировки, что в (i)) → `## Особенности` (поведение, ограничения) → `## Пропсы` (таблица «Название / Тип / По умолчанию / Описание», колбэки — `### Колбэки`) → `## Примеры` (Svelte) → `## Конструктор свойств (<Компонент>Props.svelte)` → `## Внутреннее устройство`.
 
+**Языки — единственный источник в библиотеке.** Список языков — `LANGUAGES` в `locales/languages.ts`: код, название и флаг (SVG-строка), без Svelte — годится и для серверного кода. **Новый язык — одна запись в `LANGUAGES`**: переключатели языка во всех приложениях (`LOCALES`), колонки окна «Тексты и переводы», многоязычные тексты GUI и словари подхватывают его сами; пока перевода нет — показывается текст языка по умолчанию (`DEFAULT_LANGUAGE`, `ru`). Словари (`Translations`) — строки-объекты по кодам `{ ru: "…", en: "…", zh: "…" }`: обязателен только язык по умолчанию, порядок не важен; недостающие переводы показывает `findMissingTranslations(словарь)`. `locales/i18n.ts` — текущий язык `Language`/`setLanguage` (неизвестный код не применяется, выбор сохраняется в `localStorage` `AppLanguage`), `restoreLanguage()` (сохранённый или язык браузера; стартовое значение всегда язык по умолчанию — серверный рендер совпадает с гидратацией, поэтому SSR-приложения вызывают его в `onMount` корневого layout, SPA — при старте), `LOCALES` (с флагом `flag`) и механизм перевода `createTranslator(словарь)`. Приложения (DevCloud, WebApp, терминал) свой список языков, хранилище и функцию перевода не держат: берут их из библиотеки и строят свой `$T` из своего словаря — `export const T = createTranslator(translations)`. Одно `setLanguage` переключает и компоненты библиотеки, и приложение. Многоязычные тексты GUI распознаются по виду ключей (коды языков), поэтому данные с языком, убранным из списка, не ломаются.
+
 **Языки (ru/en/zh) — два слоя:**
 
 - **Встроенные тексты компонентов** (подписи полей виджетов, кнопки, подсказки, `aria-label`) — только через словарь `src/lib/locales/translations.ts` и `$T("ключ")`; строка с числами — параметрами: `$T("widget.fs.files", { n: files.length })` на ключ `"Файлов: {n}"`. Русских литералов в разметке и скриптах компонентов быть не должно. Списки вариантов с подписями — `$derived`, иначе не переключатся при смене языка. Исключение — шкалы прибора `WidgetPFD`: там общепринятые авиационные сокращения (`SPD`, `ALT`, `AS`, `VS`, `NO DATA`) на всех языках, переводятся только подсказки и строки состояния.

package/dist/Button/ButtonProps.svelte

@@ -2,6 +2,7 @@
 <script lang="ts">
   import TextsEditor from "../TextsEditor.svelte"
   import { localizeText } from "../locales/localize"
+  import { DEFAULT_LANGUAGE } from "../locales/languages"
   import { T } from "../locales/i18n"
   import { type UIComponent, type IButtonProps, type IOption, updateProperty, type IUIComponentHandler } from "../types"
   import * as UI from ".."
@@ -42,11 +43,11 @@
   )
   const updateIconProperty = (propertyName: string, value: string) => {
     updateProperty(propertyName, value, component, onPropertyChange)
-    if (component.properties.content.icon && !localizeText(component.properties.content.name, "ru").trim())
+    if (component.properties.content.icon && !localizeText(component.properties.content.name, DEFAULT_LANGUAGE).trim())
       updateProperty("componentClass", twMerge((component.properties as UI.IButtonProps).componentClass, "w-fit p-2"), component, onPropertyChange)
     else if (
-      (component.properties.content.icon && localizeText(component.properties.content.name, "ru").trim()) ||
-      (!component.properties.content.icon && !localizeText(component.properties.content.name, "ru").trim())
+      (component.properties.content.icon && localizeText(component.properties.content.name, DEFAULT_LANGUAGE).trim()) ||
+      (!component.properties.content.icon && !localizeText(component.properties.content.name, DEFAULT_LANGUAGE).trim())
     )
       updateProperty("componentClass", twMerge((component.properties as UI.IButtonProps).componentClass, "w-full px-1 py-1"), component, onPropertyChange)
   }
@@ -106,7 +107,7 @@
 {/snippet}
 
 {#snippet ButtonHeight()}
-  {#if !(!localizeText(component.properties.content.name, "ru").trim() && component.properties.content.icon)}
+  {#if !(!localizeText(component.properties.content.name, DEFAULT_LANGUAGE).trim() && component.properties.content.icon)}
     <UI.Select
       label={{ name: $T("constructor.props.height") }}
       type="buttons"

package/dist/Input/InputProps.svelte

@@ -3,7 +3,7 @@
   import { getContext } from "svelte"
   import { T } from "../locales/i18n"
   import translations from "../locales/translations"
-  import { LANGUAGE_CODES } from "../locales/localize"
+  import { DEFAULT_LANGUAGE, LANGUAGE_CODES } from "../locales/languages"
   import type { IInputProps, UIComponent, IOption, IUIComponentHandler } from "../types"
   import * as UI from ".."
   import { optionsStore, findColorOption } from "../options"
@@ -39,7 +39,8 @@
   /* Подсказка битового режима «Максимальное число: N» сразу на всех языках — иначе записалась бы на языке интерфейса конструктора */
   const maxNumInfo = (range: { start: number; end: number }) => {
     const max = Math.pow(2, range.end - range.start + 1) - 1
-    return Object.fromEntries(LANGUAGE_CODES.map((lang, i) => [lang, `${translations["constructor.props.maxnum"][i]}: ${max}`]))
+    const row = translations["constructor.props.maxnum"]
+    return Object.fromEntries(LANGUAGE_CODES.map((lang) => [lang, `${row[lang] || row[DEFAULT_LANGUAGE]}: ${max}`]))
   }
 
   const updateProperty = (path: string, value: string | object | boolean | number | RegExp) => {

package/dist/TextsEditor.svelte

@@ -3,8 +3,8 @@
      поэтому окно одно на все компоненты; окна свойств сами тексты не показывают и не правят. -->
 <script lang="ts">
   import { T } from "./locales/i18n"
-  import { LANGUAGE_CODES, collectTexts, packLocalized, setAtPath, type TextPath } from "./locales/localize"
-  import type { LanguageCode } from "./locales/translations"
+  import { collectTexts, packLocalized, setAtPath, type TextPath } from "./locales/localize"
+  import { DEFAULT_LANGUAGE, LANGUAGE_CODES, type LanguageCode } from "./locales/languages"
   import Button from "./Button/Button.svelte"
   import Input from "./Input/Input.svelte"
   import Modal from "./Modal.svelte"
@@ -43,7 +43,7 @@
     const skip = NOT_TEXTS[component.type] ?? []
     rows = collectTexts(component.properties)
       .filter(({ path }) => !skip.includes(String(path[0])))
-      .map(({ path, text }) => ({ path, values: typeof text === "string" ? { ru: text } : { ...text } }))
+      .map(({ path, text }) => ({ path, values: typeof text === "string" ? { [DEFAULT_LANGUAGE]: text } : { ...text } }))
     isOpen = true
   }
 
@@ -69,7 +69,7 @@
           {#each LANGUAGE_CODES as lang (lang)}
             <Input
               value={row.values[lang] ?? ""}
-              placeholder={lang === "ru" ? "" : row.values.ru}
+              placeholder={lang === DEFAULT_LANGUAGE ? "" : row.values[DEFAULT_LANGUAGE]}
               onUpdate={(value) => (rows[index].values[lang] = String(value))}
             />
           {/each}

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export { default as WidgetPFDProps } from "./WidgetPFD/WidgetPFDProps.svelte";
 export { default as WidgetMap } from "./WidgetMap/WidgetMap.svelte";
 export { default as WidgetMapProps } from "./WidgetMap/WidgetMapProps.svelte";
 export * from "./locales/i18n";
-export * from "./locales/translations";
+export * from "./locales/languages";
 export * from "./locales/localize";
 export { widgetAccentStyle } from "./widgetAccent";
 export * from "./ModalStackStore";

package/dist/index.js

@@ -52,7 +52,7 @@ export { default as WidgetPFDProps } from "./WidgetPFD/WidgetPFDProps.svelte";
 export { default as WidgetMap } from "./WidgetMap/WidgetMap.svelte";
 export { default as WidgetMapProps } from "./WidgetMap/WidgetMapProps.svelte";
 export * from "./locales/i18n";
-export * from "./locales/translations";
+export * from "./locales/languages";
 export * from "./locales/localize";
 export { widgetAccentStyle } from "./widgetAccent";
 export * from "./ModalStackStore";

package/dist/locales/i18n.d.ts

@@ -1,11 +1,15 @@
 import { type Readable } from "svelte/store";
+import { type LanguageCode, type Translations } from "./languages";
 export declare const Language: import("svelte/store").Writable<string>;
+export declare function restoreLanguage(): void;
 export declare function setLanguage(newLang: string): void;
 export declare const LOCALES: {
     id: string;
     name: string;
-    value: string;
-    component: ConstructorOfATypedSvelteComponent;
+    value: LanguageCode;
+    flag: string;
 }[];
 export type TranslateParams = Record<string, string | number>;
-export declare const T: Readable<(key: string, params?: TranslateParams) => string>;
+export type Translator = (key: string, params?: TranslateParams) => string;
+export declare const createTranslator: (dictionary: Translations) => Readable<Translator>;
+export declare const T: Readable<Translator>;

package/dist/locales/i18n.js

@@ -1,39 +1,56 @@
-import { derived } from "svelte/store";
-import { writable } from "svelte/store";
+import { derived, writable } from "svelte/store";
 import translations from "./translations";
-import FlagZh from "./FlagZh.svelte";
-import FlagRu from "./FlagRu.svelte";
-import FlagEn from "./FlagEn.svelte";
-/* Язык по умолчанию */
-let initialLanguage = "ru";
-/* Проверяем, доступен ли localStorage */
-if (typeof window !== "undefined") {
-    initialLanguage = localStorage.getItem("AppLanguage") || navigator.language?.split("-")[0]?.toLowerCase() || "ru";
-    const supported = ["ru", "en", "zh"];
-    if (!supported.includes(initialLanguage)) {
-        initialLanguage = "ru";
+import { DEFAULT_LANGUAGE, LANGUAGES, isLanguageCode } from "./languages";
+/* Язык и механизм перевода — общие для библиотеки и приложений: приложение берёт отсюда Language/setLanguage/LOCALES и строит свой $T
+   из своего словаря через createTranslator (см. README «Языки»); переключение языка одним setLanguage меняет и компоненты, и приложение */
+/*
+  Текущий язык. Стартует всегда с языка по умолчанию — серверный рендер и гидратация совпадают (Svelte 5 не перерисовывает текст при
+  гидратации); сохранённый выбор применяет restoreLanguage(): в SSR-приложениях — в onMount корневого layout, в SPA — при старте
+*/
+export const Language = writable(DEFAULT_LANGUAGE);
+/* Сохранённый язык → язык браузера; неизвестный код не применяется */
+export function restoreLanguage() {
+    if (typeof window === "undefined")
+        return;
+    let saved = null;
+    try {
+        saved = localStorage.getItem("AppLanguage");
     }
+    catch {
+        /* хранилище недоступно */
+    }
+    const candidate = saved || navigator.language?.split("-")[0]?.toLowerCase();
+    if (isLanguageCode(candidate))
+        setLanguage(candidate);
 }
-/* Создаем хранилище с начальным значением языка */
-export const Language = writable(initialLanguage);
-/* Функция для изменения языка */
+/* Смена языка с сохранением выбора */
 export function setLanguage(newLang) {
+    if (!isLanguageCode(newLang))
+        return;
     if (typeof window !== "undefined") {
-        localStorage.setItem("AppLanguage", newLang);
+        try {
+            localStorage.setItem("AppLanguage", newLang);
+        }
+        catch {
+            /* хранилище недоступно — выбор действует до перезагрузки */
+        }
     }
     Language.set(newLang);
 }
-/* Поддерживаемые языки (код, название языка, флаг) */
-export const LOCALES = [
-    { id: "app-language-ru", name: "Русский", value: "ru", component: FlagRu },
-    { id: "app-language-en", name: "English", value: "en", component: FlagEn },
-    { id: "app-language-zh", name: "中国人", value: "zh", component: FlagZh },
-];
-/* Индекс языка в кортеже перевода [ru, en, zh] — жёстко привязан к порядку LOCALES */
-const LANGUAGE_INDEX = Object.fromEntries(LOCALES.map((locale, index) => [locale.value, index]));
-/* Функция для перевода для текущего языка */
-function translate(locale, key, params) {
-    const text = translations[key]?.[LANGUAGE_INDEX[locale] ?? 0] || key;
+/* Языки для переключателей: список из languages.ts; flag — SVG-разметка (иконка кнопки или {@html}) */
+export const LOCALES = LANGUAGES.map((language) => ({
+    id: `app-language-${language.value}`,
+    name: language.name,
+    value: language.value,
+    flag: language.flag,
+}));
+/* Перевод по словарю: текущий язык → язык по умолчанию → сам ключ */
+const translate = (dictionary, locale, key, params) => {
+    const row = dictionary[key];
+    const text = (row && (row[locale] || row[DEFAULT_LANGUAGE])) || key;
     return params ? text.replace(/\{(\w+)\}/g, (match, name) => (name in params ? String(params[name]) : match)) : text;
-}
-export const T = derived(Language, ($lang) => (key, params) => translate($lang, key, params));
+};
+/* $T приложения из его собственного словаря — поверх общего языка */
+export const createTranslator = (dictionary) => derived(Language, ($lang) => (key, params) => translate(dictionary, $lang, key, params));
+/* $T самой библиотеки */
+export const T = createTranslator(translations);

package/dist/locales/languages.d.ts

@@ -0,0 +1,23 @@
+export declare const LANGUAGES: readonly [{
+    readonly value: "ru";
+    readonly name: "Русский";
+    readonly flag: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1em\" height=\"1em\" viewBox=\"0 0 512 512\" ><mask id=\"circleFlagsRu0\"><circle cx=\"256\" cy=\"256\" r=\"256\" fill=\"#fff\" /></mask><g mask=\"url(#circleFlagsRu0)\" ><path fill=\"#0052b4\" d=\"M512 170v172l-256 32L0 342V170l256-32z\" /><path fill=\"#eee\" d=\"M512 0v170H0V0Z\" /><path fill=\"#d80027\" d=\"M512 342v170H0V342Z\" /></g ></svg >";
+}, {
+    readonly value: "en";
+    readonly name: "English";
+    readonly flag: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1em\" height=\"1em\" viewBox=\"0 0 512 512\" ><clipPath id=\"svgIDa\"><circle cx=\"256\" cy=\"256\" r=\"256\" /></clipPath><g clip-path=\"url(#svgIDa)\" ><path fill=\"#eee\" d=\"m0 0l8 16l-8 15v16l32 65l-32 64v32l32 48l-32 48v32l32 64l-32 65v47l16-8l15 8h16l65-32l64 32h32l48-32l48 32h32l64-32l65 32h47l-8-15l8-16v-16l-32-65l32-64v-32l-32-48l32-48v-32l-32-64l32-65V0l-15 8l-16-8h-16l-65 32l-64-32h-32l-48 32l-48-32h-32l-64 32L47 0H0z\" /><path fill=\"#0052b4\" d=\"m47 0l129 129V0Zm289 0v129L465 0ZM0 47v129h129Zm512 0L383 176h129ZM0 336v129l129-129Zm383 0l129 129V336Zm-47 47v129h129zm-160 0L47 512h129Z\" /><path fill=\"#d80027\" d=\"M208 0v208H0v96h208v208h96V304h208v-96H304V0h-96z\" /><path fill=\"#d80027\" d=\"m336 336l176 176v-31L367 336Zm0-160L512 0h-31L336 145Zm-160 0L0 0v31l145 145zm0 160L0 512h31l145-145Z\" /></g ></svg >";
+}, {
+    readonly value: "zh";
+    readonly name: "中文";
+    readonly flag: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1em\" height=\"1em\" viewBox=\"0 0 512 512\" ><mask id=\"circleFlagsCn0\"><circle cx=\"256\" cy=\"256\" r=\"256\" fill=\"#fff\" /></mask><g mask=\"url(#circleFlagsCn0)\" ><path fill=\"#d80027\" d=\"M0 0h512v512H0z\" /><path fill=\"#ffda44\" d=\"m140.1 155.8l22.1 68h71.5l-57.8 42.1l22.1 68l-57.9-42l-57.9 42l22.2-68l-57.9-42.1H118zm163.4 240.7l-16.9-20.8l-25 9.7l14.5-22.5l-16.9-20.9l25.9 6.9l14.6-22.5l1.4 26.8l26 6.9l-25.1 9.6zm33.6-61l8-25.6l-21.9-15.5l26.8-.4l7.9-25.6l8.7 25.4l26.8-.3l-21.5 16l8.6 25.4l-21.9-15.5zm45.3-147.6L370.6 212l19.2 18.7l-26.5-3.8l-11.8 24l-4.6-26.4l-26.6-3.8l23.8-12.5l-4.6-26.5l19.2 18.7zm-78.2-73l-2 26.7l24.9 10.1l-26.1 6.4l-1.9 26.8l-14.1-22.8l-26.1 6.4l17.3-20.5l-14.2-22.7l24.9 10.1z\" /></g ></svg >";
+}];
+export type LanguageCode = (typeof LANGUAGES)[number]["value"];
+export declare const DEFAULT_LANGUAGE = "ru";
+export declare const LANGUAGE_CODES: LanguageCode[];
+export type Translation = Record<typeof DEFAULT_LANGUAGE, string> & Partial<Record<LanguageCode, string>>;
+export type Translations = Record<string, Translation>;
+export declare const isLanguageCode: (value: unknown) => value is LanguageCode;
+export declare const findMissingTranslations: (dictionary: Translations) => {
+    key: string;
+    languages: LanguageCode[];
+}[];

package/dist/locales/languages.js

@@ -0,0 +1,32 @@
+/* $lib/locales/languages.ts */
+/*
+  Единственный источник списка языков для библиотеки и всех приложений на ней (DevCloud, WebApp, терминал); без Svelte — годится и для
+  серверного кода. Новый язык — одна запись здесь (код, название, флаг SVG): переключатели языка, окно «Тексты и переводы» и многоязычные
+  тексты GUI подхватят его сами, а пока в словарях нет перевода — показывается текст языка по умолчанию.
+*/
+export const LANGUAGES = [
+    {
+        value: "ru",
+        name: "Русский",
+        flag: `<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 512 512" ><mask id="circleFlagsRu0"><circle cx="256" cy="256" r="256" fill="#fff" /></mask><g mask="url(#circleFlagsRu0)" ><path fill="#0052b4" d="M512 170v172l-256 32L0 342V170l256-32z" /><path fill="#eee" d="M512 0v170H0V0Z" /><path fill="#d80027" d="M512 342v170H0V342Z" /></g ></svg >`,
+    },
+    {
+        value: "en",
+        name: "English",
+        flag: `<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 512 512" ><clipPath id="svgIDa"><circle cx="256" cy="256" r="256" /></clipPath><g clip-path="url(#svgIDa)" ><path fill="#eee" d="m0 0l8 16l-8 15v16l32 65l-32 64v32l32 48l-32 48v32l32 64l-32 65v47l16-8l15 8h16l65-32l64 32h32l48-32l48 32h32l64-32l65 32h47l-8-15l8-16v-16l-32-65l32-64v-32l-32-48l32-48v-32l-32-64l32-65V0l-15 8l-16-8h-16l-65 32l-64-32h-32l-48 32l-48-32h-32l-64 32L47 0H0z" /><path fill="#0052b4" d="m47 0l129 129V0Zm289 0v129L465 0ZM0 47v129h129Zm512 0L383 176h129ZM0 336v129l129-129Zm383 0l129 129V336Zm-47 47v129h129zm-160 0L47 512h129Z" /><path fill="#d80027" d="M208 0v208H0v96h208v208h96V304h208v-96H304V0h-96z" /><path fill="#d80027" d="m336 336l176 176v-31L367 336Zm0-160L512 0h-31L336 145Zm-160 0L0 0v31l145 145zm0 160L0 512h31l145-145Z" /></g ></svg >`,
+    },
+    {
+        value: "zh",
+        name: "中文",
+        flag: `<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 512 512" ><mask id="circleFlagsCn0"><circle cx="256" cy="256" r="256" fill="#fff" /></mask><g mask="url(#circleFlagsCn0)" ><path fill="#d80027" d="M0 0h512v512H0z" /><path fill="#ffda44" d="m140.1 155.8l22.1 68h71.5l-57.8 42.1l22.1 68l-57.9-42l-57.9 42l22.2-68l-57.9-42.1H118zm163.4 240.7l-16.9-20.8l-25 9.7l14.5-22.5l-16.9-20.9l25.9 6.9l14.6-22.5l1.4 26.8l26 6.9l-25.1 9.6zm33.6-61l8-25.6l-21.9-15.5l26.8-.4l7.9-25.6l8.7 25.4l26.8-.3l-21.5 16l8.6 25.4l-21.9-15.5zm45.3-147.6L370.6 212l19.2 18.7l-26.5-3.8l-11.8 24l-4.6-26.4l-26.6-3.8l23.8-12.5l-4.6-26.5l19.2 18.7zm-78.2-73l-2 26.7l24.9 10.1l-26.1 6.4l-1.9 26.8l-14.1-22.8l-26.1 6.4l17.3-20.5l-14.2-22.7l24.9 10.1z" /></g ></svg >`,
+    },
+];
+/* Язык по умолчанию: обязателен в каждой строке словаря и в многоязычных текстах, им заменяется отсутствующий перевод */
+export const DEFAULT_LANGUAGE = "ru";
+/* Коды в порядке LANGUAGES — порядок показа в переключателях и колонках переводов */
+export const LANGUAGE_CODES = LANGUAGES.map((language) => language.value);
+export const isLanguageCode = (value) => LANGUAGE_CODES.includes(value);
+/* Ключи словаря без перевода на какой-либо язык — для проверки полноты словаря при добавлении языка */
+export const findMissingTranslations = (dictionary) => Object.entries(dictionary)
+    .map(([key, row]) => ({ key, languages: LANGUAGE_CODES.filter((code) => !row[code]) }))
+    .filter((entry) => entry.languages.length > 0);

package/dist/locales/localize.d.ts

@@ -1,6 +1,5 @@
-import type { LanguageCode } from "./translations";
+import { type LanguageCode } from "./languages";
 export type LocalizedText = string | Partial<Record<LanguageCode, string>>;
-export declare const LANGUAGE_CODES: LanguageCode[];
 export declare const isLocalizedText: (value: unknown) => value is Partial<Record<LanguageCode, string>>;
 export declare const localizeText: (value: LocalizedText | undefined, lang: string) => string;
 export declare function localizeDeep<T>(value: T, lang: string): T;

package/dist/locales/localize.js

@@ -1,4 +1,9 @@
-export const LANGUAGE_CODES = ["ru", "en", "zh"];
+/* $lib/locales/localize.ts */
+/* Многоязычные тексты, введённые в конструкторе: строка (язык по умолчанию) или объект по кодам языков { ru, en, zh, ... };
+   язык по умолчанию (DEFAULT_LANGUAGE) — основной и запасной; набор и порядок языков — LANGUAGES (languages.ts) */
+import { DEFAULT_LANGUAGE, LANGUAGE_CODES } from "./languages";
+/* Ключ многоязычного текста: код языка из LANGUAGES или похожий на код (ru, en, pt-BR) — данные с языком, убранным из списка, не ломаются */
+const LANGUAGE_KEY = /^[a-z]{2,3}(-[A-Z]{2})?$/;
 /* Поля свойств, которые считаются текстом для пользователя — их показывает и правит окно «Тексты и переводы» (TextsEditor) */
 const TEXT_KEYS = new Set([
     "name",
@@ -21,13 +26,13 @@ export const isLocalizedText = (value) => {
     if (!isPlainObject(value))
         return false;
     const keys = Object.keys(value);
-    return keys.length > 0 && keys.every((key) => LANGUAGE_CODES.includes(key) && typeof value[key] === "string");
+    return keys.length > 0 && keys.every((key) => LANGUAGE_KEY.test(key) && typeof value[key] === "string");
 };
-/* Текст на нужном языке: сам язык → ru → первый непустой */
+/* Текст на нужном языке: сам язык → язык по умолчанию → первый непустой */
 export const localizeText = (value, lang) => {
     if (value === undefined || typeof value === "string")
         return value ?? "";
-    return value[lang] || value.ru || Object.values(value).find(Boolean) || "";
+    return value[lang] || value[DEFAULT_LANGUAGE] || Object.values(value).find(Boolean) || "";
 };
 /* Копия структуры, где каждый многоязычный текст заменён строкой на языке lang; функции, компоненты и бинарные данные — как есть */
 export function localizeDeep(value, lang) {
@@ -60,11 +65,11 @@ export function setAtPath(target, path, value) {
     copy[head] = setAtPath(copy[head], rest, value);
     return copy;
 }
-/* Текст из трёх полей окна переводов: пусто — "", только ru — строка, иначе объект из непустых языков */
+/* Текст из полей окна переводов (по полю на язык): пусто — "", только язык по умолчанию — строка, иначе объект из непустых языков */
 export const packLocalized = (values) => {
     const filled = Object.fromEntries(LANGUAGE_CODES.filter((lang) => values[lang]?.trim()).map((lang) => [lang, values[lang].trim()]));
     const langs = Object.keys(filled);
     if (!langs.length)
         return "";
-    return langs.length === 1 && langs[0] === "ru" ? filled.ru : filled;
+    return langs.length === 1 && langs[0] === DEFAULT_LANGUAGE ? filled[DEFAULT_LANGUAGE] : filled;
 };

package/dist/locales/translations.d.ts

@@ -1,3 +1,3 @@
-export type LanguageCode = "ru" | "en" | "zh";
-declare const translations: Record<string, [string, string, string]>;
+import type { Translations } from "./languages";
+declare const translations: Translations;
 export default translations;