poe-svelte-ui-lib 1.44.1 → 1.46.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` (код и название, без Svelte — годится и для серверного кода); из него выводятся `LanguageCode`, `LANGUAGE_CODES`, `isLanguageCode` и тип строки словаря `Translation` (по переводу на каждый язык в порядке `LANGUAGES`, TypeScript не даст пропустить язык). `locales/i18n.ts` — текущий язык `Language`/`setLanguage` (сохраняется в `localStorage` `AppLanguage`), `LOCALES` для переключателей (с флагами) и механизм перевода `createTranslator(словарь)`. Приложения (DevCloud, WebApp, терминал) свой список языков, хранилище и функцию перевода не держат: берут `Language`, `setLanguage`, `LOCALES` из библиотеки, а свой `$T` строят из своего словаря — `export const T = createTranslator(translations)`, где `translations: Translations`. Одно `setLanguage` переключает и компоненты библиотеки, и приложение. Новый язык — строка в `LANGUAGES` и флаг в `i18n.ts`, затем TypeScript покажет все словари, где не хватает перевода.
+
 **Языки (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/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 { LANGUAGE_CODES } from "../locales/languages"
   import type { IInputProps, UIComponent, IOption, IUIComponentHandler } from "../types"
   import * as UI from ".."
   import { optionsStore, findColorOption } from "../options"

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 { LANGUAGE_CODES, type LanguageCode } from "./locales/languages"
   import Button from "./Button/Button.svelte"
   import Input from "./Input/Input.svelte"
   import Modal from "./Modal.svelte"

package/dist/WidgetDeviceInfo/README.md

@@ -11,6 +11,7 @@
 - Поля группы `CFG` (меняется префиксом в настройках), привязывать переменные не нужно
 - «Сохранить» отправляет изменённые поля одним пакетом `SET ModCfg`
 - 🔌 «Перезагрузить» — команда `SET Restart`
+- ♻️ «Сброс настроек» — после подтверждения команда `SET RstNVS`: прошивка очищает NVS и перезагружается, все настройки возвращаются к заводским
 
 ## Ключи
 
@@ -27,7 +28,7 @@
 
 ## Особенности
 
-Смарт-виджет информации об устройстве. Как и `WidgetWiFi`, не привязывается к одной произвольной переменной устройства — работает с фиксированным набором полей, соответствующих реальной прошивочной конвенции (`main_config.c`, группа `CFG`, ProdFactory-ESP): `DevSN`, `DevID`, `DevFW`, `RunCnt`, `StaIP`, `ApIP` — только чтение; `DevName`, `HostName`, `WebUser`, `WebPsw` — редактируются локально и сохраняются одним пакетом по кнопке "Сохранить". Отдельная кнопка "Перезагрузить" рядом с заголовком вызывает `onRestart` немедленно (не входит в пакет сохранения полей). Реальное имя поля устройства для каждого ключа можно переопределить через `keys` (по умолчанию совпадает с именем ключа). Компонент ничего не знает про DeviceStore/WebSocket — только `value`/`onSave`/`onRestart`.
+Смарт-виджет информации об устройстве. Как и `WidgetWiFi`, не привязывается к одной произвольной переменной устройства — работает с фиксированным набором полей, соответствующих реальной прошивочной конвенции (`main_config.c`, группа `CFG`, ProdFactory-ESP): `DevSN`, `DevID`, `DevFW`, `RunCnt`, `StaIP`, `ApIP` — только чтение; `DevName`, `HostName`, `WebUser`, `WebPsw` — редактируются локально и сохраняются одним пакетом по кнопке "Сохранить". Отдельная кнопка "Перезагрузить" рядом с заголовком вызывает `onRestart` немедленно (не входит в пакет сохранения полей). Реальное имя поля устройства для каждого ключа можно переопределить через `keys` (по умолчанию совпадает с именем ключа). Внизу — «Сброс настроек» (`onFactoryReset`): все настройки к заводским, только после подтверждения в окне поверх виджета; без колбэка кнопка не показывается. Компонент ничего не знает про DeviceStore/WebSocket — только `value`/`onSave`/`onRestart`/`onFactoryReset`.
 
 - Серийный номер устройства обычно длинный (например `00.00.000-00_0000AC670000B22B00007428:DBC5`) — в разметке занимает отдельную строку, чтобы не обрезаться в узкой сетке.
 - `WebPsw` в реальном устройстве исторически передаётся обычным текстом; в виджете сделан `type="password"` для консистентности с остальным обликом конструктора.
@@ -44,6 +45,8 @@
 | `persistKey`     | `string`                                  | `undefined`       | Ключ для сохранения состояния `collapsed` в `localStorage` — при заданном ключе состояние сворачивания переживает перезагрузку страницы |
 | `onSave`         | `(info: IWidgetDeviceInfoConfig) => void` | `undefined`       | Срабатывает при нажатии "Сохранить" — редактируемые поля одним пакетом                                                                  |
 | `onRestart`      | `() => void`                              | `undefined`       | Срабатывает при нажатии "Перезагрузить"                                                                                                 |
+| `onFactoryReset` | `() => void`                              | `undefined`       | Срабатывает после подтверждения «Сброс настроек»; без колбэка кнопки нет                                                                |
+| `resetCommand`   | `{ header?: string; argument?: string }`  | `SET` / `RstNVS`  | Команда сброса настроек — для приложения, сам компонент её не отправляет                                                                |
 
 ### IWidgetDeviceInfoConfig
 
@@ -98,7 +101,7 @@
 | `component`        | `UIComponent & { properties: Partial<IWidgetDeviceInfoProps> }`                                 | Объект компонента с его свойствами        |
 | `onPropertyChange` | `(updates: Partial<{ properties?: string \| object; name?: string; access?: string }>) => void` | Коллбэк для обновления свойств компонента |
 
-Панель содержит заголовок, мастер-цвет (через общий `WidgetAccentPicker.svelte`), префикс прошивочной группы (ID), переопределение имени поля устройства для каждого ключа `IWidgetDeviceInfoConfig` (по умолчанию совпадает с именем ключа) и команду перезагрузки (Header/Argument, по умолчанию `SET`/`Restart`).
+Панель содержит заголовок, мастер-цвет (через общий `WidgetAccentPicker.svelte`), префикс прошивочной группы (ID), переопределение имени поля устройства для каждого ключа `IWidgetDeviceInfoConfig` (по умолчанию совпадает с именем ключа) команду перезагрузки (Header/Argument, по умолчанию `SET`/`Restart`) и команду сброса настроек (по умолчанию `SET`/`RstNVS`).
 
 ### Что настраивается
 

package/dist/WidgetDeviceInfo/WidgetDeviceInfo.svelte

@@ -2,11 +2,12 @@
      Фиксированный набор полей (см. IWidgetDeviceInfoConfig в types.ts), соответствует реальной
      прошивочной конвенции (main_config.c, группа "CFG", ProdFactory-ESP):
      DevSN/DevID/DevFW/RunCnt — только чтение; DevName/HostName/WebUser/WebPsw — сохраняются
-     одним пакетом. Ничего не знает про DeviceStore/WebSocket — value/onSave/onRestart. -->
+     одним пакетом; «Сброс настроек» — с подтверждением, все настройки к заводским. Ничего не знает про DeviceStore/WebSocket —
+     value/onSave/onRestart/onFactoryReset. -->
 <script lang="ts">
   import { T } from "../locales/i18n"
   import { untrack } from "svelte"
-  import { slide } from "svelte/transition"
+  import { fade, scale, slide } from "svelte/transition"
   import { twMerge } from "tailwind-merge"
   import * as UI from ".."
   import type { IWidgetDeviceInfoConfig, IWidgetDeviceInfoProps } from "../types"
@@ -25,8 +26,15 @@
     persistKey,
     onSave = () => {},
     onRestart = () => {},
+    onFactoryReset,
   }: IWidgetDeviceInfoProps = $props()
 
+  let confirmReset = $state(false)
+  const factoryReset = () => {
+    confirmReset = false
+    onFactoryReset?.()
+  }
+
   let accentStyle = $derived(widgetAccentStyle(componentClass ?? ""))
 
   let info: IWidgetDeviceInfoConfig = $state(
@@ -80,7 +88,10 @@
   }
 </script>
 
-<div class={twMerge("flex w-full flex-col gap-4 rounded-2xl border border-(--hairline-color) bg-(--container-color) p-4", wrapperClass)} style={accentStyle}>
+<div
+  class={twMerge("relative flex w-full flex-col gap-4 rounded-2xl border border-(--hairline-color) bg-(--container-color) p-4", wrapperClass)}
+  style={accentStyle}
+>
   <!-- Заголовок -->
   <WidgetHeader icon={CpuIcon} label={label?.name || $T("widget.info.title")} bind:collapsed>
     {#snippet right()}
@@ -128,6 +139,41 @@
         {/if}
         <UI.Button wrapperClass="w-40" componentClass="bg-accent" content={{ name: $T("widget.common.save") }} disabled={!isDirty} onClick={save} />
       </div>
+
+      <!-- Сброс всех настроек к заводским — отдельно от сохранения, только с подтверждением -->
+      {#if onFactoryReset}
+        <div class="flex items-center justify-between gap-3 border-t border-(--hairline-color) pt-3">
+          <span class="text-[12px] text-(--muted-color)">{$T("widget.info.factory_reset_hint")}</span>
+          <UI.Button
+            wrapperClass="w-auto shrink-0"
+            componentClass="bg-red px-3"
+            content={{ name: $T("widget.info.factory_reset") }}
+            onClick={() => (confirmReset = true)}
+          />
+        </div>
+      {/if}
+    </div>
+  {/if}
+
+  {#if confirmReset}
+    <!-- Подтверждение локально к виджету, как удаление файла у WidgetFileSystem -->
+    <div class="absolute inset-0 z-10 flex items-center justify-center rounded-2xl bg-black/40 backdrop-blur-[2px]" transition:fade={{ duration: 150 }}>
+      <div
+        class="flex w-full max-w-96 flex-col gap-3 rounded-[16px] border border-(--hairline-color) bg-(--back-color) p-4 shadow-(--elevation-3)"
+        transition:scale={{ duration: 150, start: 0.96 }}
+      >
+        <h4 class="text-[15px] font-semibold">{$T("widget.info.factory_reset_title")}</h4>
+        <p class="text-[13px] text-(--muted-color)">{$T("widget.info.factory_reset_text")}</p>
+        <div class="flex gap-2">
+          <UI.Button
+            wrapperClass="flex-1"
+            componentClass="bg-transparent"
+            content={{ name: $T("widget.common.cancel") }}
+            onClick={() => (confirmReset = false)}
+          />
+          <UI.Button wrapperClass="flex-1" componentClass="bg-red" content={{ name: $T("widget.info.factory_reset") }} onClick={factoryReset} />
+        </div>
+      </div>
     </div>
   {/if}
 </div>

package/dist/WidgetDeviceInfo/WidgetDeviceInfoProps.svelte

@@ -29,18 +29,18 @@
   {/each}
 {/snippet}
 
-{#snippet WidgetRestartCommand()}
+{#snippet WidgetCommand(path: "restartCommand" | "resetCommand", defaultArgument: string)}
   <UI.Select
     label={{ name: $T("widget.common.packet_header") }}
     type="buttons"
     options={$optionsStore.HEADER_OPTIONS}
-    value={$optionsStore.HEADER_OPTIONS.find((o) => o.value === (component.properties.restartCommand?.header || "SET"))}
-    onUpdate={(option) => updateProperty("restartCommand.header", (option as IOption<string>).value as string, component, onPropertyChange)}
+    value={$optionsStore.HEADER_OPTIONS.find((o) => o.value === (component.properties[path]?.header || "SET"))}
+    onUpdate={(option) => updateProperty(`${path}.header`, (option as IOption<string>).value as string, component, onPropertyChange)}
   />
   <UI.Input
     label={{ name: $T("widget.common.argument") }}
-    value={component.properties.restartCommand?.argument ?? "Restart"}
-    onUpdate={(value) => updateProperty("restartCommand.argument", value as string, component, onPropertyChange)}
+    value={component.properties[path]?.argument ?? defaultArgument}
+    onUpdate={(value) => updateProperty(`${path}.argument`, value as string, component, onPropertyChange)}
   />
 {/snippet}
 
@@ -61,6 +61,9 @@
     {@render WidgetKeys()}
   </PropsGroup>
   <PropsGroup label={$T("widget.info.restart_command")}>
-    {@render WidgetRestartCommand()}
+    {@render WidgetCommand("restartCommand", "Restart")}
+  </PropsGroup>
+  <PropsGroup label={$T("widget.info.reset_command")}>
+    {@render WidgetCommand("resetCommand", "RstNVS")}
   </PropsGroup>
 </div>

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,14 @@
 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 setLanguage(newLang: string): void;
 export declare const LOCALES: {
     id: string;
     name: string;
-    value: string;
+    value: LanguageCode;
     component: ConstructorOfATypedSvelteComponent;
 }[];
 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,58 @@
-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 */
+import { DEFAULT_LANGUAGE, LANGUAGES, isLanguageCode } from "./languages";
+/* Язык и механизм перевода — общие для библиотеки и приложений: приложение берёт отсюда Language/setLanguage/LOCALES и строит свой $T
+   из своего словаря через createTranslator (см. README «Языки»); переключение языка одним setLanguage меняет и компоненты, и приложение */
+/* Стартовый язык: сохранённый → язык браузера → по умолчанию */
+let initialLanguage = DEFAULT_LANGUAGE;
 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";
+    let saved = null;
+    try {
+        saved = localStorage.getItem("AppLanguage");
     }
+    catch {
+        /* хранилище недоступно */
+    }
+    const candidate = saved || navigator.language?.split("-")[0]?.toLowerCase();
+    if (isLanguageCode(candidate))
+        initialLanguage = 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 + флаг */
+const FLAGS = { ru: FlagRu, en: FlagEn, zh: FlagZh };
+export const LOCALES = LANGUAGES.map((language) => ({
+    id: `app-language-${language.value}`,
+    name: language.name,
+    value: language.value,
+    component: FLAGS[language.value],
+}));
+/* Индекс языка в строке словаря — порядок LANGUAGES */
+const LANGUAGE_INDEX = Object.fromEntries(LANGUAGES.map((language, index) => [language.value, index]));
+/* Перевод по словарю: текущий язык → русский → сам ключ */
+const translate = (dictionary, locale, key, params) => {
+    const row = dictionary[key];
+    const text = row?.[LANGUAGE_INDEX[locale] ?? 0] || row?.[0] || 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,20 @@
+export declare const LANGUAGES: readonly [{
+    readonly value: "ru";
+    readonly name: "Русский";
+}, {
+    readonly value: "en";
+    readonly name: "English";
+}, {
+    readonly value: "zh";
+    readonly name: "中文";
+}];
+export type LanguageCode = (typeof LANGUAGES)[number]["value"];
+export declare const LANGUAGE_CODES: LanguageCode[];
+type StringPerItem<T extends readonly unknown[]> = {
+    -readonly [K in keyof T]: string;
+};
+export type Translation = StringPerItem<typeof LANGUAGES>;
+export type Translations = Record<string, Translation>;
+export declare const DEFAULT_LANGUAGE: LanguageCode;
+export declare const isLanguageCode: (value: unknown) => value is LanguageCode;
+export {};

package/dist/locales/languages.js

@@ -0,0 +1,11 @@
+/* $lib/locales/languages.ts */
+/* Единственный источник списка языков для библиотеки и всех приложений на ней (DevCloud, WebApp, терминал); без Svelte-зависимостей — годится и для серверного кода */
+export const LANGUAGES = [
+    { value: "ru", name: "Русский" },
+    { value: "en", name: "English" },
+    { value: "zh", name: "中文" },
+];
+/* Коды в порядке LANGUAGES — он же порядок переводов в строке словаря */
+export const LANGUAGE_CODES = LANGUAGES.map((language) => language.value);
+export const DEFAULT_LANGUAGE = "ru";
+export const isLanguageCode = (value) => LANGUAGE_CODES.includes(value);

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,6 @@
-export const LANGUAGE_CODES = ["ru", "en", "zh"];
+/* $lib/locales/localize.ts */
+/* Многоязычные тексты, введённые в конструкторе: строка (один язык) или объект { ru, en, zh }; ru — основной и запасной */
+import { LANGUAGE_CODES } from "./languages";
 /* Поля свойств, которые считаются текстом для пользователя — их показывает и правит окно «Тексты и переводы» (TextsEditor) */
 const TEXT_KEYS = new Set([
     "name",

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;

package/dist/locales/translations.js

@@ -103,9 +103,9 @@ const translations = {
         "🎯 **用途**\n设备网络的完整配置：模式、连接路由器、自身接入点。\n\n📦 **数据包**\n- `CFG` 分组的字段（可通过设置中的前缀更改），无需绑定变量\n- 字段在本地编辑，「保存」以一个 `SET ModCfg` 数据包发送已修改的字段\n- 🔍 扫描网络 —— `GET APsList`，找到的网络出现在 SSID 列表中\n\n🔑 **键**\n- `WiFiMode` —— 数字：`0` 关闭、`1` 客户端、`2` 接入点、`3` 两者\n- `StaSSID`、`StaPSK` —— 字符串：路由器网络和密码\n- `StaticIP` —— 数字：`0` DHCP、`1` 静态地址\n- `StaIP`、`StaMS`、`StaGW` —— 字符串：客户端地址、掩码、网关\n- `ApSSID`、`ApPSK` —— 字符串：自身接入点名称和密码\n- `ApIP`、`ApMS`、`ApGW` —— 字符串：接入点地址、掩码、网关\n\n✨ **特点**\n- 仅启用接入点时组件会提醒：设备可能从局域网中消失\n\n⚙️ **设置**\n- 分组前缀（ID）、字段名覆盖、主色",
     ],
     "component.info.WidgetDeviceInfo": [
-        "🎯 **Назначение**\nПаспорт устройства и его основные настройки.\n\n📦 **Пакет данных**\n- Поля группы `CFG` (меняется префиксом в настройках), привязывать переменные не нужно\n- «Сохранить» отправляет изменённые поля одним пакетом `SET ModCfg`\n- 🔌 «Перезагрузить» — команда `SET Restart`\n\n🔑 **Ключи**\n- `DevSN` — строка: серийный номер, только чтение\n- `DevID` — строка: код изделия, только чтение\n- `DevFW` — число: версия ПО, только чтение\n- `RunCnt` — число: счётчик запусков, только чтение\n- `StaIP`, `ApIP` — строки: текущие адреса клиента и точки доступа, только чтение\n- `DevName` — строка: имя устройства\n- `HostName` — строка: сетевое имя\n- `WebUser`, `WebPsw` — строки: логин и пароль веб-интерфейса\n\n⚙️ **Настройки**\n- Префикс группы (ID), мастер-цвет",
-        '🎯 **Purpose**\nDevice passport and its main settings.\n\n📦 **Data packet**\n- Fields of the `CFG` group (changed by the prefix in settings), no variable binding needed\n- "Save" sends the changed fields in one `SET ModCfg` packet\n- 🔌 "Restart" — the `SET Restart` command\n\n🔑 **Keys**\n- `DevSN` — string: serial number, read only\n- `DevID` — string: product code, read only\n- `DevFW` — number: firmware version, read only\n- `RunCnt` — number: boot counter, read only\n- `StaIP`, `ApIP` — strings: current client and access point addresses, read only\n- `DevName` — string: device name\n- `HostName` — string: network host name\n- `WebUser`, `WebPsw` — strings: web interface login and password\n\n⚙️ **Settings**\n- Group prefix (ID), master color',
-        "🎯 **用途**\n设备档案及其主要设置。\n\n📦 **数据包**\n- `CFG` 分组的字段（可通过设置中的前缀更改），无需绑定变量\n- 「保存」以一个 `SET ModCfg` 数据包发送已修改的字段\n- 🔌「重启」—— `SET Restart` 命令\n\n🔑 **键**\n- `DevSN` —— 字符串：序列号，只读\n- `DevID` —— 字符串：产品代码，只读\n- `DevFW` —— 数字：固件版本，只读\n- `RunCnt` —— 数字：启动计数，只读\n- `StaIP`、`ApIP` —— 字符串：客户端和接入点的当前地址，只读\n- `DevName` —— 字符串：设备名称\n- `HostName` —— 字符串：网络主机名\n- `WebUser`、`WebPsw` —— 字符串：Web 界面登录名和密码\n\n⚙️ **设置**\n- 分组前缀（ID）、主色",
+        "🎯 **Назначение**\nПаспорт устройства и его основные настройки.\n\n📦 **Пакет данных**\n- Поля группы `CFG` (меняется префиксом в настройках), привязывать переменные не нужно\n- «Сохранить» отправляет изменённые поля одним пакетом `SET ModCfg`\n- ♻️ «Сброс настроек» — после подтверждения команда `SET RstNVS`, все настройки к заводским, прибор перезагружается\n- 🔌 «Перезагрузить» — команда `SET Restart`\n\n🔑 **Ключи**\n- `DevSN` — строка: серийный номер, только чтение\n- `DevID` — строка: код изделия, только чтение\n- `DevFW` — число: версия ПО, только чтение\n- `RunCnt` — число: счётчик запусков, только чтение\n- `StaIP`, `ApIP` — строки: текущие адреса клиента и точки доступа, только чтение\n- `DevName` — строка: имя устройства\n- `HostName` — строка: сетевое имя\n- `WebUser`, `WebPsw` — строки: логин и пароль веб-интерфейса\n\n⚙️ **Настройки**\n- Префикс группы (ID), мастер-цвет",
+        '🎯 **Purpose**\nDevice passport and its main settings.\n\n📦 **Data packet**\n- Fields of the `CFG` group (changed by the prefix in settings), no variable binding needed\n- "Save" sends the changed fields in one `SET ModCfg` packet\n- ♻️ "Factory reset" — after confirmation the `SET RstNVS` command, all settings return to factory defaults and the device restarts\n- 🔌 "Restart" — the `SET Restart` command\n\n🔑 **Keys**\n- `DevSN` — string: serial number, read only\n- `DevID` — string: product code, read only\n- `DevFW` — number: firmware version, read only\n- `RunCnt` — number: boot counter, read only\n- `StaIP`, `ApIP` — strings: current client and access point addresses, read only\n- `DevName` — string: device name\n- `HostName` — string: network host name\n- `WebUser`, `WebPsw` — strings: web interface login and password\n\n⚙️ **Settings**\n- Group prefix (ID), master color',
+        "🎯 **用途**\n设备档案及其主要设置。\n\n📦 **数据包**\n- `CFG` 分组的字段（可通过设置中的前缀更改），无需绑定变量\n- 「保存」以一个 `SET ModCfg` 数据包发送已修改的字段\n- ♻️「恢复出厂设置」—— 确认后发送 `SET RstNVS` 命令，所有设置恢复为出厂默认值，设备重启\n- 🔌「重启」—— `SET Restart` 命令\n\n🔑 **键**\n- `DevSN` —— 字符串：序列号，只读\n- `DevID` —— 字符串：产品代码，只读\n- `DevFW` —— 数字：固件版本，只读\n- `RunCnt` —— 数字：启动计数，只读\n- `StaIP`、`ApIP` —— 字符串：客户端和接入点的当前地址，只读\n- `DevName` —— 字符串：设备名称\n- `HostName` —— 字符串：网络主机名\n- `WebUser`、`WebPsw` —— 字符串：Web 界面登录名和密码\n\n⚙️ **设置**\n- 分组前缀（ID）、主色",
     ],
     "component.info.WidgetFileSystem": [
         '🎯 **Назначение**\nПамять устройства, список файлов, удаление и закачка.\n\n📦 **Пакет данных**\n- Один объект `CFG.FS` (префикс и имя поля меняются в настройках), привязывать переменные не нужно\n- 🔄 «Обновить» — `GET FS`\n- «Удалить» — `SET FS` с `Op: Delete` после подтверждения\n- Закачка — `SET FS` с `Op` `UploadStart` → `UploadChunk` → `UploadDone`\n\n🔑 **Ключи**\n- `Total`, `Used`, `Free` — числа, байт: объём, занято, свободно\n- `List` — массив `[{ "Name", "Size" }]`: полный путь файла и размер в байтах\n- `Upload` — объект `{ "Name", "Size", "Progress" }`, есть только во время закачки; `Progress` — 0–100\n\n✨ **Особенности**\n- Полоса занятости оранжевая от 75%, красная от 90%\n- Закачка с другого клиента тоже видна\n- Имя файла — не длиннее 31 символа (ограничение прошивки, задаётся в настройках)\n\n⚙️ **Настройки**\n- Префикс группы (ID), поле состояния ФС, аргумент команд, мастер-цвет\n- Допустимые файлы (фильтр в окне выбора), максимальная длина имени',
@@ -754,5 +754,14 @@ const translations = {
     "constructor.texts.buttons": ["Кнопка", "Button", "按钮"],
     "ui.graph.values": ["Значения", "Values", "数值"],
     "ui.graph.refresh": ["Развёртка", "Refresh rate", "刷新率"],
+    "widget.info.factory_reset": ["Сброс настроек", "Factory reset", "恢复出厂设置"],
+    "widget.info.factory_reset_hint": ["Все настройки к заводским", "All settings to factory defaults", "所有设置恢复为出厂默认值"],
+    "widget.info.factory_reset_title": ["Сбросить все настройки?", "Reset all settings?", "重置所有设置？"],
+    "widget.info.factory_reset_text": [
+        "Все настройки прибора — Wi-Fi, имя, пароль Web, настройки модулей — вернутся к заводским, прибор перезагрузится. Связь по Wi-Fi может пропасть.",
+        "All device settings — Wi-Fi, name, Web password, module settings — return to factory defaults and the device restarts. The Wi-Fi connection may be lost.",
+        "设备的所有设置（Wi-Fi、名称、Web 密码、模块设置）将恢复为出厂默认值，设备将重启。Wi-Fi 连接可能会断开。",
+    ],
+    "widget.info.reset_command": ["Команда сброса настроек", "Factory reset command", "恢复出厂命令"],
 };
 export default translations;

package/dist/types.d.ts

@@ -525,10 +525,15 @@ export interface IWidgetDeviceInfoProps {
         header?: string;
         argument?: string;
     };
+    resetCommand?: {
+        header?: string;
+        argument?: string;
+    };
     collapsed?: boolean;
     persistKey?: string;
     onSave?: (info: IWidgetDeviceInfoConfig) => void;
     onRestart?: () => void;
+    onFactoryReset?: () => void;
 }
 export interface IWidgetFileSystemFile {
     Name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-svelte-ui-lib",
-  "version": "1.44.1",
+  "version": "1.46.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Oleg-Perevyshin/ElementsUI.git"