poe-svelte-ui-lib 1.67.0 → 1.69.0

package/README.md

@@ -59,7 +59,7 @@ npm install poe-svelte-ui-lib
 
 **Названия смарт-виджетов** — в словаре библиотеки на всех языках (WiFi, «Об устройстве», «Файловая система», «Стек и задачи», «RGB лента», «Пилотажный дисплей», «Карта»); пустой `label.name` показывает название на языке пользователя, `widgetTitle(type)` отдаёт его сразу на всех языках `{ ru, en, zh }` — так конструктор заполняет заголовок нового виджета.
 
-**Ядро протоколов** — `poe-svelte-ui-lib/protocols` (без Svelte, работает и под Node без Vite): общий для DevCloud, WebApp и SYP-DevTerminal CBOR-кодек (RFC 8949) — `encodeCbor`/`decodeCbor`, `CborEncoder`/`CborDecoder`; `valueToCbor`/`cborToValue` — обычные значения, двоичные данные как `Uint8Array` (WebSocket, хранилище, телеметрия); `jsonToCbor`/`cborToJson` — JSON-совместимые значения, двоичные данные в base64, строки под ключами с `BIN` — байты (поля ввода терминала и отладки). Пакет `poe_cbor_pkt` `{ TrgBusID : [RetBusID, HA_Code, Payload, CRC16] }` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты с одинаковым `TrgBusID` не склеиваются, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `0xFFFF`), `makeHaCode`/`splitHaCode`, `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc` — строго побайтные, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка POESerial (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodePoeSerialFrame` — команда устройству, `createPoeSerialParser().push(байты)` — потоковый разбор кадров, строк Teleplot (`plot`) и прочего текста (`raw`), с проверкой CRC `crc8Rohc` строго побайтно, как `crc8_rohc` в `common.c` прошивок. CAN/CAN FD через slcan-адаптер (`can_service` прошивки): `canFragments`/`encodeCanPacket` — нарезка пакета на кадры как `CAN_Send` (бит 10 ID — «последний», биты 0..9 — `packetId`, по 8 / 64 байта), `encodeSlcanFrame`, `createCanParser().push(байты)` — разбор кадров slcan со сборкой фрагментов и обрезкой паддинга CAN FD. RS485 — сырой поток пакетов: `createPacketStreamParser().push(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Открытие slcan-адаптера — `slcanOpenCommands(скорость, скоростьДанных?)`. Поле Value команды POESerial из ввода — `poeSerialValueFromText` (hex как есть, JSON → CBOR). Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (из `.framework/Dictionary.yaml` прошивок), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
+**Ядро протоколов** — `poe-svelte-ui-lib/protocols` (без Svelte, работает и под Node без Vite): общий для DevCloud, WebApp и SYP-DevTerminal CBOR-кодек (RFC 8949) — `encodeCbor`/`decodeCbor`, `CborEncoder`/`CborDecoder`; `valueToCbor`/`cborToValue` — обычные значения, двоичные данные как `Uint8Array` (WebSocket, хранилище, телеметрия); `jsonToCbor`/`cborToJson` — JSON-совместимые значения, двоичные данные в base64, строки под ключами с `BIN` — байты (поля ввода терминала и отладки). Пакет `poe_cbor_pkt` `{ TrgBusID : [RetBusID, HA_Code, Payload, CRC16] }` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты с одинаковым `TrgBusID` не склеиваются, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `0xFFFF`), `makeHaCode`/`splitHaCode`, `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc` — строго побайтные, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка POESerial (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodePoeSerialFrame` — команда устройству, `createPoeSerialParser().push(байты)` — потоковый разбор кадров, строк Teleplot (`plot`) и прочего текста (`raw`), с проверкой CRC `crc8Rohc` строго побайтно, как `crc8_rohc` в `common.c` прошивок. CAN/CAN FD через slcan-адаптер (`can_service` прошивки): `canFragments`/`encodeCanPacket` — нарезка пакета на кадры как `CAN_Send` (бит 10 ID — «последний», биты 0..9 — `packetId`, по 8 / 64 байта), `encodeSlcanFrame`, `createCanParser().push(байты)` — разбор кадров slcan со сборкой фрагментов и обрезкой паддинга CAN FD. RS485 — сырой поток пакетов: `createPacketStreamParser().push(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Открытие slcan-адаптера — `slcanOpenCommands(скорость, скоростьДанных?)`. Поле Value команды POESerial из ввода — `poeSerialValueFromText` (hex как есть, JSON → CBOR). Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (генерируется из мастер-словаря `src/lib/protocols/dictionary.yaml` — `npm run Dictionary`, перед упаковкой автоматически; сам файл поставляется как `poe-svelte-ui-lib/protocols/dictionary.yaml`, `.framework/Dictionary.yaml` прошивок — его справочные копии, сборка прошивок сверяет с ними `api_ha.h`), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/Graph/Graph.svelte

@@ -389,11 +389,12 @@
     <h5 class={`w-full px-4 text-center ${label.class}`}>{label.name}</h5>
   {/if}
 
-  <div class="flex w-full flex-row gap-4">
-    <!-- График -->
+  <div class="flex w-full min-w-0 flex-row gap-4">
+    <!-- График: холст абсолютно поверх контейнера — его пиксельная ширина не распирает контейнер, иначе в сетке/flex с 1fr ширина растёт по кругу (ResizeObserver) -->
     <!-- design-handoff, раздел 9: рамка --hairline-color без тени, тултип в оформлении общего Tooltip.svelte -->
-    <div bind:this={container} class="relative h-64 grow overflow-hidden rounded-[14px] border border-(--hairline-color)">
-      <canvas class="h-full w-full bg-(--back-color)" bind:this={canvas} onmousemove={handleMouseMove} onmouseleave={handleMouseLeave}></canvas>
+    <div bind:this={container} class="relative h-64 min-w-0 grow overflow-hidden rounded-[14px] border border-(--hairline-color)">
+      <canvas class="absolute inset-0 h-full w-full bg-(--back-color)" bind:this={canvas} onmousemove={handleMouseMove} onmouseleave={handleMouseLeave}
+      ></canvas>
 
       {#if tooltip.visible}
         <div

package/dist/Graph/README.md

@@ -23,6 +23,8 @@
 
 ### Адаптивность
 
+- Холст лежит поверх контейнера (`absolute`), контейнер может сжиматься (`min-w-0`) — в сетке или flex с колонкой `1fr` график не распирает колонку своей пиксельной шириной и не растёт по кругу при каждом пересчёте размера
+
 - График автоматически масштабируется под размер контейнера
 
 ### Ограничения

package/dist/Table/README.md

@@ -28,6 +28,8 @@
 
 - Таблица автоматически адаптируется под размеры контейнера
 - Размер текста строк задаётся CSS-переменной `--table-font-size` на любом родителе (по умолчанию `13px`), например `style="--table-font-size: 11.5px"` — так потребитель меняет масштаб данных без правки компонента
+- Ширина колонки в символах моноширинного текста — `tableMonoWidth(знаков, знаковПодписи?)`: растёт вместе с `--table-font-size` и не бывает уже подписи шапки, например `width: tableMonoWidth(6, 2)` для `0x0000`
+- Окно полного значения (`modal`) переносит длинные строки (hex пакета, base64) и сохраняет отступы форматирования — содержимое видно целиком, без горизонтальной прокрутки
 
 ### Ограничения
 
@@ -110,13 +112,14 @@
 
 #### ITableButton\<T\>
 
-| Название       | Тип                                            | По умолчанию | Описание                                                |
-| -------------- | ---------------------------------------------- | ------------ | ------------------------------------------------------- |
-| `name`         | `string \| ((row: T) => string)`               | `undefined`  | Текст кнопки (статичный или вычисляемый по строке)      |
-| `icon`         | `ConstructorOfATypedSvelteComponent \| string` | `undefined`  | Иконка кнопки (Svelte-компонент или строка SVG)         |
-| `class`        | `string \| ((row: T) => string)`               | `undefined`  | CSS-классы кнопки (статичные или вычисляемые по строке) |
-| `eventHandler` | `IUIComponentHandler`                          | `undefined`  | Обработчик события конструктора                         |
-| `onClick`      | `(row: T) => void`                             | `undefined`  | Обработчик клика по кнопке                              |
+| Название       | Тип                                            | По умолчанию | Описание                                                                          |
+| -------------- | ---------------------------------------------- | ------------ | --------------------------------------------------------------------------------- |
+| `name`         | `string \| ((row: T) => string)`               | `undefined`  | Текст кнопки (статичный или вычисляемый по строке)                                |
+| `icon`         | `ConstructorOfATypedSvelteComponent \| string` | `undefined`  | Иконка кнопки (Svelte-компонент или строка SVG)                                   |
+| `title`        | `string \| ((row: T) => string)`               | `undefined`  | Подсказка при наведении и `aria-label` — обязательна для кнопки-значка без `name` |
+| `class`        | `string \| ((row: T) => string)`               | `undefined`  | CSS-классы кнопки (статичные или вычисляемые по строке)                           |
+| `eventHandler` | `IUIComponentHandler`                          | `undefined`  | Обработчик события конструктора                                                   |
+| `onClick`      | `(row: T) => void`                             | `undefined`  | Обработчик клика по кнопке                                                        |
 
 #### ITableProgressBar\<T\>
 

package/dist/Table/Table.svelte

@@ -340,6 +340,8 @@
                            }
                           ${typeof button.class === 'function' ? button.class(row) : button.class}`)} bg-(--bg-color)"
                           onclick={() => buttonClick(row, button)}
+                          title={typeof button.title === "function" ? button.title(row) : button.title}
+                          aria-label={typeof button.title === "function" ? button.title(row) : button.title}
                         >
                           {#if button?.icon}
                             <span class={`flex size-4 shrink-0 items-center justify-center overflow-visible [&_svg]:h-full [&_svg]:w-full`}>
@@ -526,7 +528,8 @@
 
 <Modal isOpen={modalData.isOpen} title={$T("constructor.props.table.fulldata")} wrapperClass="max-h-[80%]" width="{0.8 * (container?.offsetWidth ?? 0)}px">
   {#snippet main()}
-    <div class="text-left whitespace-pre">
+    <!-- Длинные строки (hex пакета, base64, длинные значения) переносятся, отступы форматирования сохраняются — содержимое видно целиком -->
+    <div class="text-left whitespace-pre-wrap [overflow-wrap:anywhere]">
       {@html modalData.formattedData}
     </div>
   {/snippet}

package/dist/Table/columnWidth.d.ts

@@ -0,0 +1 @@
+export declare const tableMonoWidth: (chars: number, labelChars?: number) => string;

package/dist/Table/columnWidth.js

@@ -0,0 +1,4 @@
+/* $lib/Table/columnWidth.ts */
+/* Ширина колонки моноширинного текста таблицы в символах: растёт вместе с --table-font-size (знак моноширинного шрифта — 0.6–0.62em, берётся 0.64 с запасом),
+   не уже подписи шапки (11px, заглавные, ~0.5rem на знак); 1.5rem — внутренние отступы ячейки, 1px — разделитель колонок */
+export const tableMonoWidth = (chars, labelChars = 0) => `max(calc(var(--table-font-size, 13px) * ${+(chars * 0.64).toFixed(2)} + 1.5rem + 1px), calc(${labelChars * 0.5}rem + 1.5rem + 1px))`;

package/dist/WidgetFileSystem/README.md

@@ -49,30 +49,31 @@
 
 ## Особенности
 
-Смарт-виджет файловой системы устройства: занятость памяти, список файлов с удалением и закачка нового файла с прогрессом. Работает с одним объектом `CFG.FS` ровно в том виде, в каком его отдаёт прошивка (`FS_WriteState`, ProdFactory-ESP), и с одной командой `FS`. Компонент ничего не знает про DeviceStore/WebSocket — только `value` и колбэки `onRefresh`/`onDelete`/`onUpload`, вся отправка (в том числе протокол закачки) на стороне вызывающего кода.
+Смарт-виджет файловой системы устройства: занятость памяти, список файлов со скачиванием и удалением и закачка нового файла с прогрессом. Работает с одним объектом `CFG.FS` ровно в том виде, в каком его отдаёт прошивка (`FS_WriteState`, ProdFactory-ESP), и с одной командой `FS`. Компонент ничего не знает про DeviceStore/WebSocket — только `value` и колбэки `onRefresh`/`onDelete`/`onUpload`/`onDownload`, вся отправка (в том числе протоколы закачки и скачивания) на стороне вызывающего кода.
 
 - **Занятость** — «занято X из Y», процент и полоса мастер-цвета; процент оранжевый от 75%, красный от 90%. Размеры в Б/КБ/МБ.
-- **Файлы** — таблица «Путь / Размер / Удалить»; длинный путь обрезается «…», удаление подтверждается внутри карточки. Пустая ФС — «Файлов нет». Колонка удаления есть, только если передан `onDelete`.
+- **Файлы** — таблица «Путь / Размер / действия»; длинный путь обрезается «…». Действия — значки без текста с подсказкой при наведении: «Скачать» (есть, только если передан `onDownload`) и «Удалить» (только с `onDelete`, подтверждается внутри карточки). Одновременно идёт одно скачивание — его имя и ошибка из `onDownload` выводятся под таблицей. Пустая ФС — «Файлов нет».
 - **Закачка** — блок есть, только если передан `onUpload`. Имя файла проверяется до отправки (`maxNameLength`, по умолчанию 31 — ограничение прошивки). Прогресс берётся из `value.Upload` и виден, пока закачку ведёт этот клиент или пока устройство сообщает `Upload` (закачка с другого клиента). Ошибка из `onUpload` выводится под полем.
 
 ## Пропсы
 
-| Название         | Тип                                     | По умолчанию | Описание                                                                                   |
-| ---------------- | --------------------------------------- | ------------ | ------------------------------------------------------------------------------------------ |
-| `id`             | `string`                                | `undefined`  | Префикс прошивочной группы (обычно `"CFG"`), используется вызывающим кодом для чтения `FS` |
-| `wrapperClass`   | `string`                                | `""`         | CSS-классы обёртки                                                                         |
-| `componentClass` | `string`                                | `""`         | «Мастер-цвет» виджета — роль вида `"bg-red"`, перекрашивает весь виджет                    |
-| `label`          | `{ name?: string }`                     | `{}`         | Заголовок карточки; пустой — «Файловая система» на текущем языке                           |
-| `value`          | `IWidgetFileSystemInfo`                 | `undefined`  | Состояние файловой системы (`CFG.FS`)                                                      |
-| `keys`           | `{ FS?: string }`                       | `undefined`  | Переопределение имени поля устройства, по умолчанию `FS`                                   |
-| `argument`       | `string`                                | `undefined`  | Аргумент команд, по умолчанию `"FS"` (используется вызывающим кодом)                       |
-| `accept`         | `string`                                | `"*/*"`      | Какие файлы можно выбрать (атрибут `accept`), например `".bin, .txt, .pem"`                |
-| `maxNameLength`  | `number`                                | `31`         | Максимальная длина имени файла                                                             |
-| `collapsed`      | `boolean`                               | `false`      | Свёрнуто ли тело виджета (`$bindable`)                                                     |
-| `persistKey`     | `string`                                | `undefined`  | Ключ для сохранения `collapsed` в `localStorage`                                           |
-| `onRefresh`      | `() => void`                            | `undefined`  | Кнопка «Обновить» в шапке (`GET FS`); без обработчика кнопка неактивна                     |
-| `onDelete`       | `(name: string) => void`                | `undefined`  | Удаление файла после подтверждения; `name` — полный путь из `List`                         |
-| `onUpload`       | `(file: File) => void \| Promise<void>` | `undefined`  | Закачка выбранного файла; исключение показывается как ошибка под полем                     |
+| Название         | Тип                                       | По умолчанию | Описание                                                                                                                                                             |
+| ---------------- | ----------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `id`             | `string`                                  | `undefined`  | Префикс прошивочной группы (обычно `"CFG"`), используется вызывающим кодом для чтения `FS`                                                                           |
+| `wrapperClass`   | `string`                                  | `""`         | CSS-классы обёртки                                                                                                                                                   |
+| `componentClass` | `string`                                  | `""`         | «Мастер-цвет» виджета — роль вида `"bg-red"`, перекрашивает весь виджет                                                                                              |
+| `label`          | `{ name?: string }`                       | `{}`         | Заголовок карточки; пустой — «Файловая система» на текущем языке                                                                                                     |
+| `value`          | `IWidgetFileSystemInfo`                   | `undefined`  | Состояние файловой системы (`CFG.FS`)                                                                                                                                |
+| `keys`           | `{ FS?: string }`                         | `undefined`  | Переопределение имени поля устройства, по умолчанию `FS`                                                                                                             |
+| `argument`       | `string`                                  | `undefined`  | Аргумент команд, по умолчанию `"FS"` (используется вызывающим кодом)                                                                                                 |
+| `accept`         | `string`                                  | `"*/*"`      | Какие файлы можно выбрать (атрибут `accept`), например `".bin, .txt, .pem"`                                                                                          |
+| `maxNameLength`  | `number`                                  | `31`         | Максимальная длина имени файла                                                                                                                                       |
+| `collapsed`      | `boolean`                                 | `false`      | Свёрнуто ли тело виджета (`$bindable`)                                                                                                                               |
+| `persistKey`     | `string`                                  | `undefined`  | Ключ для сохранения `collapsed` в `localStorage`                                                                                                                     |
+| `onRefresh`      | `() => void`                              | `undefined`  | Кнопка «Обновить» в шапке (`GET FS`); без обработчика кнопка неактивна                                                                                               |
+| `onDelete`       | `(name: string) => void`                  | `undefined`  | Удаление файла после подтверждения; `name` — полный путь из `List`                                                                                                   |
+| `onUpload`       | `(file: File) => void \| Promise<void>`   | `undefined`  | Закачка выбранного файла; исключение показывается как ошибка под полем                                                                                               |
+| `onDownload`     | `(name: string) => void \| Promise<void>` | `undefined`  | Скачивание файла (`SET FS` с `Op` `DownloadStart`/`DownloadChunk`/`DownloadDone`) и сохранение; `name` — полный путь из `List`, исключение показывается под таблицей |
 
 ### IWidgetFileSystemInfo
 
@@ -99,6 +100,7 @@
   onRefresh={() => console.log("GET FS")}
   onDelete={(name) => console.log("SET FS", { Op: "Delete", Name: name })}
   onUpload={async (file) => console.log("SET FS UploadStart/UploadChunk/UploadDone", file.name)}
+  onDownload={async (name) => console.log("SET FS DownloadStart/DownloadChunk/DownloadDone", name)}
 />
 ```
 

package/dist/WidgetFileSystem/WidgetFileSystem.svelte

@@ -1,16 +1,19 @@
 <!-- $lib/WidgetFileSystem/WidgetFileSystem.svelte — смарт-виджет файловой системы устройства.
      Данные — один объект CFG.FS в том виде, в каком его отдаёт прошивка (FS_WriteState, ProdFactory-ESP):
      Total/Used/Free/List[{Name, Size}] и Upload{Name, Size, Progress} — только пока идёт закачка.
-     Ничего не знает про DeviceStore/WebSocket — value/onRefresh/onDelete/onUpload, протокол
-     закачки (SET FS с Op UploadStart/UploadChunk/UploadDone) и отправка команд на стороне вызывающего. -->
+     Ничего не знает про DeviceStore/WebSocket — value/onRefresh/onDelete/onUpload/onDownload, протоколы
+     закачки и скачивания (SET FS с Op UploadStart/UploadChunk/UploadDone и DownloadStart/DownloadChunk/DownloadDone)
+     и отправка команд на стороне вызывающего. -->
 <script lang="ts">
   import { T } from "../locales/i18n"
   import { slide, fade, scale } from "svelte/transition"
   import { twMerge } from "tailwind-merge"
   import * as UI from ".."
-  import type { IWidgetFileSystemFile, IWidgetFileSystemProps, ITableHeader } from "../types"
+  import type { IWidgetFileSystemFile, IWidgetFileSystemProps, ITableHeader, ITableContent } from "../types"
   import StorageIcon from "./StorageIcon.svelte"
   import RefreshIcon from "./RefreshIcon.svelte"
+  import ButtonDownload from "../libIcons/ButtonDownload.svelte"
+  import ButtonDelete from "../libIcons/ButtonDelete.svelte"
   import WidgetHeader from "../WidgetHeader.svelte"
   import { hint, hintsSetting } from "../hints"
   import { widgetAccentStyle } from "../widgetAccent"
@@ -28,6 +31,7 @@
     onRefresh,
     onDelete,
     onUpload,
+    onDownload,
   }: IWidgetFileSystemProps = $props()
 
   /* Подсказки — кнопка «?» в шапке, выбор общий для всех WidgetFileSystem */
@@ -61,24 +65,30 @@
   /* Полоса — мастер-цвет виджета; почти заполненную ФС (закачка скоро начнёт падать) выдаёт только процент */
   let percentColor = $derived(usedPercent >= 90 ? "var(--red-color)" : usedPercent >= 75 ? "var(--orange-color)" : "var(--muted-color)")
 
-  /* Таблица файлов: путь обрезается «…», размер — уже отформатирован, удаление — с подтверждением */
+  /* Таблица файлов: путь обрезается «…», размер — уже отформатирован; действия — значки без текста: скачать и удалить (с подтверждением) */
   type FileRow = IWidgetFileSystemFile & { SizeText: string }
   let rows: FileRow[] = $derived(files.map((f) => ({ ...f, SizeText: formatBytes(f.Size) })))
+  let actions = $derived(
+    [
+      onDownload && {
+        type: "button",
+        data: { icon: ButtonDownload, title: $T("widget.fs.download"), class: "bg-transparent px-0", onClick: (row: FileRow) => handleDownload(row.Name) },
+      },
+      onDelete && {
+        type: "button",
+        data: {
+          icon: ButtonDelete,
+          title: $T("widget.common.delete"),
+          class: "bg-transparent px-0 text-(--red-color) hover:bg-(--red-color)/10",
+          onClick: (row: FileRow) => (pendingDelete = row.Name),
+        },
+      },
+    ].filter(Boolean) as ITableContent<FileRow>[],
+  )
   let header: ITableHeader<FileRow>[] = $derived([
     { label: { name: $T("widget.fs.path") }, content: [{ type: "text", data: { key: "Name", truncated: true, sortable: true } }], width: "1fr", align: "left" },
     { label: { name: $T("widget.fs.size") }, content: [{ type: "text", data: { key: "SizeText" } }], width: "6rem", align: "right" },
-    ...(onDelete
-      ? [
-          {
-            label: { name: "" },
-            content: [
-              { type: "button", data: { name: $T("widget.common.delete"), class: "bg-accent", onClick: (row: FileRow) => (pendingDelete = row.Name) } },
-            ],
-            width: "6.5rem",
-            align: "center",
-          } as ITableHeader<FileRow>,
-        ]
-      : []),
+    ...(actions.length ? [{ label: { name: "" }, content: actions, width: `${actions.length * 2.5 + 1}rem`, align: "center" } as ITableHeader<FileRow>] : []),
   ])
 
   /* Закачка видна, пока её ведёт этот клиент или пока устройство сообщает Upload (закачка с другого клиента);
@@ -92,6 +102,22 @@
     pendingDelete = null
   }
 
+  /* Скачивание: одно за раз, ошибка вызывающего показывается под таблицей */
+  let downloading: string | null = $state(null)
+  let downloadError = $state("")
+  const handleDownload = async (name: string) => {
+    if (!onDownload || downloading) return
+    downloadError = ""
+    downloading = name
+    try {
+      await onDownload(name)
+    } catch (error) {
+      downloadError = $T("widget.fs.download_failed", { error: error instanceof Error ? error.message : String(error) })
+    } finally {
+      downloading = null
+    }
+  }
+
   /* Закачка: имя проверяется до отправки (прошивка отвергнет длинное имя уже после UploadStart) */
   let uploading = $state(false)
   let uploadError = $state("")
@@ -159,6 +185,14 @@
             {$T("widget.fs.empty")}
           </div>
         {/if}
+        {#if downloading}
+          <span class="mt-2 truncate text-[12px] text-(--muted-color)" transition:slide={{ duration: 100 }}
+            >{$T("widget.fs.downloading", { name: downloading })}</span
+          >
+        {/if}
+        {#if downloadError}
+          <span class="mt-2 text-[12px] text-(--red-color)" transition:slide={{ duration: 100 }}>{downloadError}</span>
+        {/if}
       </div>
 
       <!-- Закачка -->

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export { default as Switch } from "./Switch/Switch.svelte";
 export { default as SwitchProps } from "./Switch/SwitchProps.svelte";
 export { default as Table } from "./Table/Table.svelte";
 export { default as TableProps } from "./Table/TableProps.svelte";
+export { tableMonoWidth } from "./Table/columnWidth";
 export { default as Tabs } from "./Tabs/Tabs.svelte";
 export { default as TabsProps } from "./Tabs/TabsProps.svelte";
 export { default as TextField } from "./TextField/TextField.svelte";

package/dist/index.js

@@ -29,6 +29,7 @@ export { default as Switch } from "./Switch/Switch.svelte";
 export { default as SwitchProps } from "./Switch/SwitchProps.svelte";
 export { default as Table } from "./Table/Table.svelte";
 export { default as TableProps } from "./Table/TableProps.svelte";
+export { tableMonoWidth } from "./Table/columnWidth";
 export { default as Tabs } from "./Tabs/Tabs.svelte";
 export { default as TabsProps } from "./Tabs/TabsProps.svelte";
 export { default as TextField } from "./TextField/TextField.svelte";

package/dist/libIcons/ButtonDownload.svelte

@@ -0,0 +1,12 @@
+<script lang="ts"></script>
+
+<svg xmlns="http://www.w3.org/2000/svg" width="1.5em" height="1.5em" viewBox="0 0 24 24"
+  ><path
+    fill="none"
+    stroke="currentColor"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    stroke-width="1.5"
+    d="M12 3.5v12m0 0l-4.5-4.5m4.5 4.5l4.5-4.5M4.5 15.5v1.25c0 1.875 0 2.813.477 3.47a2.5 2.5 0 0 0 .553.553c.657.477 1.595.477 3.47.477h6c1.875 0 2.813 0 3.47-.477a2.5 2.5 0 0 0 .553-.553c.477-.657.477-1.595.477-3.47V15.5"
+  /></svg
+>

package/dist/libIcons/ButtonDownload.svelte.d.ts

@@ -0,0 +1,18 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const ButtonDownload: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type ButtonDownload = InstanceType<typeof ButtonDownload>;
+export default ButtonDownload;

package/dist/locales/translations.js

@@ -644,9 +644,9 @@ const translations = {
         zh: "设备文件系统占用；存满后无法写入新文件、日志和更新",
     },
     "widget.fs.hint.files": {
-        ru: "Файлы на устройстве: сортировка — по заголовку колонки, удаление — кнопкой в строке",
-        en: "Files on the device: sort by the column header, delete with the button in the row",
-        zh: "设备上的文件：点击列标题排序，点击行内按钮删除",
+        ru: "Файлы на устройстве: сортировка — по заголовку колонки, скачивание и удаление — значками в строке",
+        en: "Files on the device: sort by the column header, download and delete with the icons in the row",
+        zh: "设备上的文件：点击列标题排序，点击行内图标下载或删除",
     },
     "widget.fs.hint.upload": {
         ru: "Загрузить файл на устройство; файл с тем же именем будет заменён",
@@ -712,6 +712,9 @@ const translations = {
     "widget.fs.files": { ru: "Файлов: {n}", en: "Files: {n}", zh: "文件：{n}" },
     "widget.fs.empty": { ru: "Файлов нет", en: "No files", zh: "没有文件" },
     "widget.fs.upload": { ru: "Закачать файл", en: "Upload file", zh: "上传文件" },
+    "widget.fs.download": { ru: "Скачать", en: "Download", zh: "下载" },
+    "widget.fs.downloading": { ru: "Скачивание: {name}", en: "Downloading: {name}", zh: "正在下载：{name}" },
+    "widget.fs.download_failed": { ru: "Скачивание прервано: {error}", en: "Download aborted: {error}", zh: "下载中断：{error}" },
     "widget.fs.delete_confirm": { ru: "Удалить файл?", en: "Delete file?", zh: "删除文件？" },
     "widget.fs.upload_group": { ru: "Закачка файлов", en: "File upload", zh: "文件上传" },
     "widget.fs.accept": { ru: "Допустимые файлы (accept)", en: "Allowed files (accept)", zh: "允许的文件 (accept)" },

package/dist/protocols/dictionary.d.ts

@@ -1,4 +1,4 @@
 export declare const HEADER_CODES: Record<string, number>;
-export declare const DEFAULT_ARGUMENT_CODES: Record<string, number>;
+export { DEFAULT_ARGUMENT_CODES } from "./dictionaryCodes.js";
 export declare const parseArgumentDictionary: (text: string) => Record<string, number>;
 export declare const nameByCode: (codes: Record<string, number>, code: number) => string;

package/dist/protocols/dictionary.js

@@ -1,67 +1,15 @@
 /* $lib/protocols/dictionary.ts */
 /* Словарь заголовков и аргументов протокола HA_Code — заголовок в 2 старших битах, аргумент в 14 младших (makeHaCode). Аргументы по умолчанию —
-   из .framework/Dictionary.yaml прошивок (ProdFactory-ESP и ProdFactory-STM, одинаковые); у устройства словарь может быть свой — его загружают
-   из файла (parseArgumentDictionary), своих копий словаря в приложениях не держим */
+   из мастер-словаря dictionary.yaml рядом (единственный источник; .framework/Dictionary.yaml прошивок — его справочные копии), DEFAULT_ARGUMENT_CODES
+   генерируется из него (dictionaryCodes.ts, npm run Dictionary); у устройства словарь может быть свой — его загружают из файла
+   (parseArgumentDictionary), своих копий словаря в приложениях не держим */
 export const HEADER_CODES = {
     GET: 0,
     SET: 1,
     "OK!": 2,
     "ER!": 3,
 };
-export const DEFAULT_ARGUMENT_CODES = {
-    Unknown: 0,
-    Restart: 1,
-    DefCfg: 2,
-    DlFW: 3,
-    RstNVS: 5,
-    LocTime: 6,
-    Update: 7,
-    StackInfo: 8,
-    BackUp: 9,
-    BindMKey: 10,
-    DataStream: 15,
-    APsList: 21,
-    FS: 22,
-    JoinDev: 23,
-    JoinUser: 24,
-    LeaveUser: 25,
-    ModFind: 31,
-    ModList: 32,
-    ModCap: 33,
-    ModInfo: 34,
-    ModMode: 35,
-    ModCfg: 36,
-    ModT1: 37,
-    ModT2: 38,
-    ModT3: 39,
-    ModT4: 40,
-    ModT5: 41,
-    ModS1: 42,
-    ModS2: 43,
-    ModS3: 44,
-    ModS4: 45,
-    ModS5: 46,
-    FwUpgS: 51,
-    FwUpgP: 52,
-    FwUpgD: 53,
-    FwUpgE: 54,
-    FDwS: 65,
-    FDwP: 66,
-    FDwD: 67,
-    FDwE: 68,
-    TestReq: 91,
-    MotInit: 111,
-    MotMode: 112,
-    MotPos: 113,
-    MotPID: 114,
-    MotInfo: 115,
-    MotCfg: 116,
-    MotCal: 117,
-    OrData: 141,
-    OrOfs: 142,
-    OrAccCal: 143,
-    OrMagCal: 144,
-};
+export { DEFAULT_ARGUMENT_CODES } from "./dictionaryCodes.js";
 /* Аргументы из текста Dictionary.yaml (или его фрагмента): строки «- [Строка, Enum, Число]», комментарии и прочее пропускаются */
 export const parseArgumentDictionary = (text) => Object.fromEntries([...text.matchAll(/^\s*-\s*\[\s*([^,\]]+?)\s*,\s*[^,\]]+?\s*,\s*(\d+)\s*\]/gm)].map(([, name, code]) => [name, Number(code)]));
 /* Имя по коду (обратный поиск) — для показа принятых пакетов; неизвестный код — числом */

package/dist/protocols/dictionary.yaml

@@ -0,0 +1,66 @@
+# Словарь аргументов протокола HA_Code — единый для всех устройств, обоих фреймворков и приложений
+# Строковое представление аргумента | Название в перечислении | Числовой код
+# Источник — poe-svelte-ui-lib (src/lib/protocols/dictionary.yaml); .framework/Dictionary.yaml фреймворков — копии, не править
+
+# 0 — отсутствие аргумента
+- [Unknown, A_UNKNOWN, 0]                   # Аргумент отсутствует
+
+# Служебные команды
+- [Restart, A_RESTART, 1]                   # SET: перезагрузка устройства
+- [DefCfg, A_DEF_CONFIG, 2]                 # SET: сброс конфигурации к заводской
+- [DlFW, A_DOWNLOAD_FIRMWARE, 3]            # SET: скачивание прошивки с сервера (http_client)
+- [RstNVS, A_RESET_NVS, 5]                  # SET: очистка NVS и перезагрузка
+- [LocTime, A_LOCAL_TIME, 6]                # GET: локальное время устройства
+- [Update, A_UPDATE, 7]                     # OK!/ER!: обновление данных в интерфейсе (DevCloud ретранслирует DataStream)
+- [StackInfo, A_STACK_INFO, 8]              # GET: снимок куч и стеков задач
+- [BackUp, A_BACKUP, 9]                     # Резервная копия конфигурации
+- [BindMKey, A_BIND_MOD_KEY, 10]            # SET: привязка ключа модуля (ModBindKey)
+- [DataStream, A_DATA_STREAM, 15]           # OK!: поток данных групп конфигурации (CS_PushGroupStream)
+
+# Локальная сеть
+- [APsList, A_APS_LIST, 21]                 # GET: список точек доступа Wi-Fi
+- [FS, A_FS, 22]                            # Файловая система: GET FS — снимок, SET FS {Op: Delete|UploadStart|UploadChunk|UploadDone|DownloadStart|DownloadChunk|DownloadDone}
+- [JoinDev, A_JOIN_DEV, 23]                 # SET: подтверждение подключения устройства к облаку
+- [JoinUser, A_JOIN_USER, 24]               # SET: пользователь подключился к устройству
+- [LeaveUser, A_LEAVE_USER, 25]             # SET: пользователь отключился от устройства
+
+# Модули в рамках изделия
+- [ModFind, A_MODULE_FIND, 31]              # GET/OK!: поиск модулей на шинах изделия
+- [ModList, A_MODULE_LIST, 32]              # Список модулей изделия (CFG.ModList)
+- [ModCap, A_MODULE_CAPTURE, 33]            # GET/OK!: захват модуля для привязки
+- [ModInfo, A_MODULE_INFO, 34]              # GET/OK!: информация о модуле
+- [ModMode, A_MODULE_MODE, 35]              # SET: режим работы модуля
+- [ModCfg, A_MODULE_CFG, 36]                # GET/SET: конфигурация модуля (группы config_service)
+- [ModT1, A_MODULE_TELEMETRY_1, 37]         # Телеметрия модуля, канал 1
+- [ModT2, A_MODULE_TELEMETRY_2, 38]         # Телеметрия модуля, канал 2
+- [ModT3, A_MODULE_TELEMETRY_3, 39]         # Телеметрия модуля, канал 3
+- [ModT4, A_MODULE_TELEMETRY_4, 40]         # Телеметрия модуля, канал 4
+- [ModT5, A_MODULE_TELEMETRY_5, 41]         # Телеметрия модуля, канал 5
+- [ModS1, A_MODULE_STREAM_1, 42]            # Поток данных модуля, канал 1
+- [ModS2, A_MODULE_STREAM_2, 43]            # Поток данных модуля, канал 2
+- [ModS3, A_MODULE_STREAM_3, 44]            # Поток данных модуля, канал 3
+- [ModS4, A_MODULE_STREAM_4, 45]            # Поток данных модуля, канал 4
+- [ModS5, A_MODULE_STREAM_5, 46]            # Поток данных модуля, канал 5
+
+# Обновление прошивки
+- [FwUpgS, A_UPGRADE_START, 51]             # Старт обновления прошивки модуля по шине
+- [FwUpgP, A_UPGRADE_PROC, 52]              # Блок прошивки при обновлении по шине
+- [FwUpgD, A_UPGRADE_DONE, 53]              # Завершение обновления прошивки по шине
+- [FwUpgE, A_UPGRADE_ERR, 54]               # Ошибка обновления прошивки по шине
+
+- [TestReq, TEST_REQUEST, 91]               # GET: тестовый запрос
+
+# Работа с модулями перемещения (оси подвесов, линейные перемещения, серво приводы и подобные)
+- [MotInit, A_MOTION_INIT, 111]             # SET: включение/калибровка (1 байт: команда)
+- [MotMode, A_MOTION_MODE, 112]             # SET: режим управления (2 байта: ctrl_mode + torque_mode)
+- [MotPos, A_MOTION_POS, 113]               # GET/SET: целевое значение (4 байта: float)
+- [MotPID, A_MOTION_PID, 114]               # SET: коэффициенты PID (13 байт: selector + Kp + Ki + Kd)
+- [MotInfo, A_MOTION_INFO, 115]             # GET: телеметрия (32 байта: angle+vel+Iq+Id+target+flags)
+- [MotCfg, A_MOTION_CFG, 116]               # GET/SET: конфигурация мотора (28 байт: лимиты+параметры)
+- [MotCal, A_MOTION_CAL, 117]               # SET: запуск калибровки нулевого угла (0 байт)
+
+# Работа с модулями ориентации (IMU, магнетометры, GNSS и подобные)
+- [OrData, A_ORIENTATION_DATA, 141]         # SET: углы ориентации от модуля
+- [OrOfs, A_ORIENTATION_OFFSET, 142]        # Смещения ориентации
+- [OrAccCal, A_ORIENTATION_ACC_CALIB, 143]  # Калибровка акселерометра
+- [OrMagCal, A_ORIENTATION_MAG_CALIB, 144]  # Калибровка магнетометра

package/dist/protocols/dictionaryCodes.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_ARGUMENT_CODES: Record<string, number>;

package/dist/protocols/dictionaryCodes.js

@@ -0,0 +1,51 @@
+/* $lib/protocols/dictionaryCodes.ts — СГЕНЕРИРОВАНО из dictionary.yaml (npm run Dictionary), руками не править */
+export const DEFAULT_ARGUMENT_CODES = {
+    Unknown: 0,
+    Restart: 1,
+    DefCfg: 2,
+    DlFW: 3,
+    RstNVS: 5,
+    LocTime: 6,
+    Update: 7,
+    StackInfo: 8,
+    BackUp: 9,
+    BindMKey: 10,
+    DataStream: 15,
+    APsList: 21,
+    FS: 22,
+    JoinDev: 23,
+    JoinUser: 24,
+    LeaveUser: 25,
+    ModFind: 31,
+    ModList: 32,
+    ModCap: 33,
+    ModInfo: 34,
+    ModMode: 35,
+    ModCfg: 36,
+    ModT1: 37,
+    ModT2: 38,
+    ModT3: 39,
+    ModT4: 40,
+    ModT5: 41,
+    ModS1: 42,
+    ModS2: 43,
+    ModS3: 44,
+    ModS4: 45,
+    ModS5: 46,
+    FwUpgS: 51,
+    FwUpgP: 52,
+    FwUpgD: 53,
+    FwUpgE: 54,
+    TestReq: 91,
+    MotInit: 111,
+    MotMode: 112,
+    MotPos: 113,
+    MotPID: 114,
+    MotInfo: 115,
+    MotCfg: 116,
+    MotCal: 117,
+    OrData: 141,
+    OrOfs: 142,
+    OrAccCal: 143,
+    OrMagCal: 144,
+};

package/dist/protocols/index.js

@@ -16,5 +16,5 @@ export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacke
 export { encodePoeSerialFrame, createPoeSerialParser, poeSerialValueFromText } from "./poeSerial.js";
 /* CAN/CAN FD через slcan-адаптер: нарезка пакета на кадры как в can_service прошивки, кадры slcan, потоковый разбор со сборкой фрагментов */
 export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, slcanOpenCommands, } from "./can.js";
-/* Словарь заголовков и аргументов HA_Code — по умолчанию из Dictionary.yaml прошивок, разбор файла словаря */
+/* Словарь заголовков и аргументов HA_Code — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */
 export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/types.d.ts

@@ -319,6 +319,7 @@ export interface ITableSelect<T extends object> {
 export interface ITableButton<T extends object> {
     name?: string | ((row: T) => string);
     icon?: ConstructorOfATypedSvelteComponent | string;
+    title?: string | ((row: T) => string);
     class?: string | ((row: T) => string);
     eventHandler?: IUIComponentHandler;
     onClick?: (row: T) => void;
@@ -571,6 +572,7 @@ export interface IWidgetFileSystemProps {
     persistKey?: string;
     onRefresh?: () => void;
     onDelete?: (name: string) => void;
+    onDownload?: (name: string) => void | Promise<void>;
     onUpload?: (file: File) => void | Promise<void>;
 }
 export interface IWidgetStackInfoHeap {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-svelte-ui-lib",
-  "version": "1.67.0",
+  "version": "1.69.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Oleg-Perevyshin/ElementsUI.git"
@@ -11,12 +11,13 @@
     "dev": "vite dev",
     "build": "vite build",
     "preview": "vite preview",
-    "prepack": "svelte-kit sync && svelte-package && publint",
+    "prepack": "node scripts/GenerateDictionary.mjs && svelte-kit sync && svelte-package && publint",
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "CheckUpdate": "npx npm-check-updates -u && npm install",
     "UpdateIconsLib": "tsx src/lib/IconsCatalog/iconsLib.ts",
     "Formatting": "prettier --write .",
-    "TestProtocols": "svelte-package && node --test tests/*.test.mjs"
+    "Dictionary": "node scripts/GenerateDictionary.mjs",
+    "TestProtocols": "node scripts/GenerateDictionary.mjs && svelte-package && node --test tests/*.test.mjs"
   },
   "svelte": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -29,6 +30,7 @@
       "types": "./dist/protocols/index.d.ts",
       "default": "./dist/protocols/index.js"
     },
+    "./protocols/dictionary.yaml": "./dist/protocols/dictionary.yaml",
     "./locales": {
       "types": "./dist/locales/index.d.ts",
       "default": "./dist/locales/index.js"