poe-svelte-ui-lib 1.75.0 → 1.77.0

package/README.md

@@ -61,7 +61,7 @@ npm install poe-svelte-ui-lib
 
 **Битовые поля конфигурации** — `bitFieldGet(word, start, end)`/`bitFieldSet(word, start, end, value)`: поле `start..end` 32-битного слова `{GROUP}.Cfg` (Select/Input с `bitMode`) обычной арифметикой, без знаковых 32-битных операций JS — бит 31 разбирается и собирается корректно, результат всегда 0..2³²−1; тест против эталона на BigInt — `tests/bitField.test.mjs`.
 
-**Ядро протоколов** — `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` — indefinite-массив объектов `[[TrgBusID, SrcBusID, HAR, Payload, CRC16], …]` (CAN, RS485, UART-консоль), `Payload` — одно CBOR item (сырые данные — `encodePacketBytesPayload`, пустой массив — `null`): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты одному адресату не склеиваются, порядок сохраняется, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `BROADCAST_BUS_ID = 0xFFFF`), `EXTERNAL_BUS_ID = 0x0000` — `SrcBusID` терминала и отладки, `BUS_ID_REGEXP`/`parseBusId`/`formatBusId` — поля BusID в HEX и вывод `0x0000`, `makeHar(header, argument, reply = true)`/`splitHar` — `HAR`: заголовок в битах 14-15, аргумент в битах 1-13 (0..8191), флаг ответа в бите 0 (как `HAR`/`HAR_NR` прошивки), `packetObjectCrc`; контрольная сумма `crc16Kermit` — строго побайтная, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Протокол xPOE-Debug (UART-консоль `system_console`) — тот же пакет `poe_cbor_pkt` вперемешку с текстом загрузчика: `encodeXPoeDebugFrame(header, argument, payload, srcId, trgId, reply)` кодирует запрос, `xPoeDebugHar` — HAR по именам словаря, `createXPoeDebugParser().push(байты)` разбирает поток пакетов (каждая запись — отдельный элемент) и внешний текст (`raw`), логи `OK! DebugLog` — `[уровень, тег, текст, FHS]` (`DEBUG_LOG_ARGUMENT`, FHS — в `freeHeap`). Строка таблицы — `xPoeDebugRow`, колонки — `xPoeDebugTableColumns` (основной вход библиотеки): общие для отладки облака и терминала. 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 команды xPOE-Debug из ввода — `xPoeDebugValueFromText` (hex как есть, JSON → CBOR, пусто — пустой Payload). Графики отладки — пакет `OK! DebugPlot` (`SC_PLOT` прошивки, `DEBUG_PLOT_ARGUMENT`): `debugPlotValues(value)` — пары `[имя, число]` из HEX CBOR-карты `Payload`, `createPlotGroups().update(пары)` раскладывает по группам (префикс до точки) в порядке карты и возвращает обновлённые группы, `data(группа)` — последние значения. Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (генерируется из мастер-словаря `src/lib/protocols/dictionary.yaml` — `npm run Dictionary`, перед упаковкой автоматически; сам файл поставляется как `poe-svelte-ui-lib/protocols/dictionary.yaml`, `.framework/Dictionary.yaml` прошивок — его справочные копии, сборка прошивок сверяет с ними `api_har.h`), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
+**Ядро протоколов** — `poe-svelte-ui-lib/protocols`, описание протокола — [`src/lib/protocols/PROTOCOL.md`](src/lib/protocols/PROTOCOL.md) (без Svelte, работает и под Node без Vite): общий для DevCloud, WebApp и SYP-DevTerminal CBOR-кодек (RFC 8949); `valueToCbor`/`cborToValue` — обычные значения, двоичные данные как `Uint8Array` (WebSocket, хранилище, телеметрия); `jsonToCbor` — JSON-совместимое значение в CBOR, строки base64 под ключами с `BIN` — байты (поля ввода терминала и отладки). Пакет `poe_cbor_pkt` — indefinite-массив объектов `[[TrgBusID, SrcBusID, HAR, Payload, CRC16], …]` (CAN, RS485, UART-консоль), `Payload` — одно CBOR item (сырые данные — `encodePacketBytesPayload`, пустой массив — `null`): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты одному адресату не склеиваются, порядок сохраняется, неверный CRC — флаг `crcOk`), `BUS_ID_REGEXP`/`parseBusId`/`formatBusId` — поля BusID в HEX и вывод `0x0000`, `makeHar(header, argument, reply = true)`/`splitHar` — `HAR`: заголовок в битах 14-15, аргумент в битах 1-13 (0..8191), флаг ответа в бите 0 (как `HAR`/`HAR_NR` прошивки), `packetObjectCrc`; контрольная сумма `crc16Kermit` — строго побайтная, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Протокол xPOE-Debug (UART-консоль `system_console`) — тот же пакет `poe_cbor_pkt` вперемешку с текстом загрузчика: `encodeXPoeDebugFrame(header, argument, payload, srcId, trgId, reply)` кодирует запрос, `xPoeDebugHar` — HAR по именам словаря, `createXPoeDebugParser().push(байты)` разбирает поток пакетов (каждая запись — отдельный элемент) и внешний текст (`raw`), логи `OK! DebugLog` — `[уровень, тег, текст, FHS]` (`DEBUG_LOG_ARGUMENT`, FHS — в `freeHeap`). Строка таблицы — `xPoeDebugRow`, колонки — `xPoeDebugTableColumns` (основной вход библиотеки): общие для отладки облака и терминала. 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 команды xPOE-Debug из ввода — `xPoeDebugValueFromText` (hex как есть, JSON → CBOR, пусто — пустой Payload). Графики отладки — пакет `OK! DebugPlot` (`LOG_PLOT` прошивки, `DEBUG_PLOT_ARGUMENT`): `debugPlotValues(value)` — пары `[имя, число]` из HEX CBOR-карты `Payload`, `createPlotGroups().update(пары)` раскладывает по группам (префикс до точки) в порядке карты и возвращает обновлённые группы, `data(группа)` — последние значения. Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (генерируется из мастер-словаря `src/lib/protocols/dictionary.yaml` — `npm run Dictionary`, перед упаковкой автоматически; сам файл поставляется как `poe-svelte-ui-lib/protocols/dictionary.yaml`, `.framework/Dictionary.yaml` прошивок — его справочные копии, сборка прошивок сверяет с ними `api_har.h`), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/FileAttach/FileAttach.svelte

@@ -2,6 +2,10 @@
   import { T } from "../locales/i18n"
   import type { IFileAttachProps } from "../types"
   import { twMerge } from "tailwind-merge"
+  import Button from "../Button/Button.svelte"
+
+  /* Иконка «открыть файл» для type "button" — документ со стрелкой вверх, контур 1.75 как у остальных кнопок */
+  const OPEN_FILE_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M14 3H7a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V8z"/><path d="M14 3v5h5"/><path d="M12 18v-6"/><path d="m9 15 3-3 3 3"/></svg>`
 
   let {
     id = crypto.randomUUID(),
@@ -13,6 +17,8 @@
     imageSize = { height: "10rem", width: "10rem", fitMode: "cover", form: "square" },
     disabled = false,
     currentImage = $bindable(""),
+    info,
+    icon,
     onChange = () => {},
   }: IFileAttachProps = $props()
 
@@ -45,6 +51,8 @@
     }
 
     onChange(event, file)
+    /* Кнопка «Открыть файл» — повторный выбор того же файла тоже должен срабатывать */
+    if (type === "button") input.value = ""
   }
 
   const triggerFileInput = () => {
@@ -60,7 +68,11 @@
     <span class={twMerge(`w-full text-[12px] font-semibold text-(--muted-color)`, label.class)}>{label.name}</span>
   {/if}
 
-  {#if type === "image"}
+  {#if type === "button"}
+    <!-- Иконочная кнопка с подсказкой, как UI.Button; выбор файла — скрытый input за ней -->
+    <Button {componentClass} {disabled} content={{ icon: icon ?? OPEN_FILE_ICON, info }} onClick={triggerFileInput} />
+    <input id={ID} type="file" class="hidden" {accept} {disabled} onchange={handleFileChange} />
+  {:else if type === "image"}
     <div class="relative">
       <button
         class="flex items-center justify-center overflow-hidden {imageSize.form === 'circle' ? 'rounded-full' : 'rounded-[12px]'}

package/dist/FileAttach/README.md

@@ -17,6 +17,18 @@
 
 ## Особенности
 
+- `type="button"` — иконочная кнопка «Открыть файл» (скрытый `input` за `UI.Button`) с подсказкой `info`, для панелей инструментов: открыть файл для редактирования рядом с кнопками «Сохранить в файл», «Загрузить с сервера»; сохранение в файл — обычная `UI.Button`
+
+```svelte
+<UI.FileAttach
+  type="button"
+  accept=".yaml,.gz"
+  componentClass={TOOL_BUTTON}
+  info={{ text: "Открыть файл", side: "top" }}
+  onChange={(event, file) => open(file)}
+/>
+```
+
 - Для списка файлов, удаления и прогресса закачки используйте виджет «Файловая система»
 
 ### Адаптивность
@@ -35,24 +47,26 @@
 
 ## Пропсы
 
-| Название            | Тип                                          | По умолчанию          | Описание                                                         |
-| ------------------- | -------------------------------------------- | --------------------- | ---------------------------------------------------------------- |
-| `id`                | `string`                                     | `crypto.randomUUID()` | Уникальный идентификатор компонента                              |
-| `wrapperClass`      | `string`                                     | `""`                  | Дополнительные CSS-классы для обертки компонента                 |
-| `componentClass`    | `string`                                     | `""`                  | Дополнительные CSS-классы для элемента с именем выбранного файла |
-| `label`             | `object`                                     | `-`                   | Настройки заголовка компонента                                   |
-| `label.name`        | `string`                                     | `""`                  | Текст заголовка компонента                                       |
-| `label.class`       | `string`                                     | `""`                  | CSS-классы для стилизации текста заголовка                       |
-| `type`              | `"file" \| "image"`                          | `"file"`              | Тип компонента (файл или изображение)                            |
-| `accept`            | `string`                                     | `"*/*"`               | MIME-типы файлов, которые можно выбрать                          |
-| `imageSize`         | `object`                                     | `-`                   | Настройки отображения изображения                                |
-| `imageSize.height`  | `string`                                     | `"10rem"`             | Высота области отображения изображения                           |
-| `imageSize.width`   | `string`                                     | `"10rem"`             | Ширина области отображения изображения                           |
-| `imageSize.fitMode` | `"cover" \| "contain"`                       | `"cover"`             | Режим масштабирования изображения                                |
-| `imageSize.form`    | `"square" \| "circle"`                       | `"square"`            | Форма области отображения изображения                            |
-| `disabled`          | `boolean`                                    | `false`               | Состояние отключения компонента                                  |
-| `currentImage`      | `string \| null`                             | `""`                  | Текущее изображение (для связывания)                             |
-| `onChange`          | `(event: Event, file: File \| null) => void` | `() => {}`            | Обработчик изменения файла                                       |
+| Название            | Тип                                          | По умолчанию          | Описание                                                                           |
+| ------------------- | -------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------- |
+| `id`                | `string`                                     | `crypto.randomUUID()` | Уникальный идентификатор компонента                                                |
+| `wrapperClass`      | `string`                                     | `""`                  | Дополнительные CSS-классы для обертки компонента                                   |
+| `componentClass`    | `string`                                     | `""`                  | Дополнительные CSS-классы для элемента с именем выбранного файла                   |
+| `label`             | `object`                                     | `-`                   | Настройки заголовка компонента                                                     |
+| `label.name`        | `string`                                     | `""`                  | Текст заголовка компонента                                                         |
+| `label.class`       | `string`                                     | `""`                  | CSS-классы для стилизации текста заголовка                                         |
+| `type`              | `"file" \| "image" \| "button"`              | `"file"`              | Тип компонента: поле выбора файла, изображение или иконочная кнопка «Открыть файл» |
+| `info`              | `{ text, side }`                             | `-`                   | Только `button`: всплывающая подсказка, как у `UI.Button`                          |
+| `icon`              | `Component \| string`                        | документ со стрелкой  | Только `button`: своя иконка (компонент или SVG-строка)                            |
+| `accept`            | `string`                                     | `"*/*"`               | MIME-типы файлов, которые можно выбрать                                            |
+| `imageSize`         | `object`                                     | `-`                   | Настройки отображения изображения                                                  |
+| `imageSize.height`  | `string`                                     | `"10rem"`             | Высота области отображения изображения                                             |
+| `imageSize.width`   | `string`                                     | `"10rem"`             | Ширина области отображения изображения                                             |
+| `imageSize.fitMode` | `"cover" \| "contain"`                       | `"cover"`             | Режим масштабирования изображения                                                  |
+| `imageSize.form`    | `"square" \| "circle"`                       | `"square"`            | Форма области отображения изображения                                              |
+| `disabled`          | `boolean`                                    | `false`               | Состояние отключения компонента                                                    |
+| `currentImage`      | `string \| null`                             | `""`                  | Текущее изображение (для связывания)                                               |
+| `onChange`          | `(event: Event, file: File \| null) => void` | `() => {}`            | Обработчик изменения файла                                                         |
 
 ### Колбэки
 

package/dist/WidgetMap/WidgetMap.svelte

@@ -70,6 +70,15 @@
   let boards: Board[] = $state([])
   let now = $state(Date.now())
   let mapInstance: any = $state()
+  /* Вид карты (центр, масштаб, поворот) переживает сворачивание: тело виджета пересоздаёт карту, и она открывается там, где её оставили */
+  let view = $state.raw({ center: { lat: 30, lng: 0 }, zoom: 1.5, bearing: 0 })
+  $effect(() => {
+    const map = mapInstance
+    if (!map) return
+    const save = () => (view = { center: map.getCenter(), zoom: map.getZoom(), bearing: map.getBearing() })
+    map.on("moveend", save)
+    return () => map.off("moveend", save)
+  })
   let isCopied = $state(false)
   let isDarkMode = $state(false)
 
@@ -211,8 +220,9 @@
         bind:map={mapInstance}
         class="h-full w-full overflow-hidden rounded-[14px] border border-(--hairline-color)"
         style={isDarkMode ? "https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json" : "https://basemaps.cartocdn.com/gl/voyager-gl-style/style.json"}
-        zoom={1.5}
-        center={{ lat: 30, lng: 0 }}
+        zoom={view.zoom}
+        center={view.center}
+        bearing={view.bearing}
         maxPitch={0}
       >
         <NavigationControl />

package/dist/WidgetMap/mapWrapper/Line.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { onDestroy } from "svelte"
+  import { onDestroy, untrack } from "svelte"
   import { getMapContext } from "./contexts.svelte.js"
 
   interface Props {
@@ -23,31 +23,36 @@
     properties: {},
   })
 
+  /* Источник и слой — один раз; пока стиль карты грузится, добавление ждёт в очереди waitForStyleLoaded */
   $effect(() => {
     if (!mapCtx.map || added) return
-
-    mapCtx.addSource(id, { type: "geojson", data: toGeoJSON() })
-    mapCtx.addLayer({
-      id,
-      type: "line",
-      source: id,
-      layout: { "line-join": "round", "line-cap": "round" },
-      paint: { "line-color": color, "line-width": width, "line-opacity": opacity },
+    untrack(() => {
+      mapCtx.addSource(id, { type: "geojson", data: toGeoJSON() })
+      mapCtx.addLayer({
+        id,
+        type: "line",
+        source: id,
+        layout: { "line-join": "round", "line-cap": "round" },
+        paint: { "line-color": color, "line-width": width, "line-opacity": opacity },
+      })
     })
     added = true
   })
 
+  /* Координаты и оформление читаются до любых проверок — иначе эффект не подписывается на них и, запущенный до загрузки стиля, больше не срабатывает */
   $effect(() => {
-    if (!added || !mapCtx.map) return
-    const source = mapCtx.map.getSource(id) as any
-    source?.setData(toGeoJSON())
+    const data = toGeoJSON()
+    if (!added) return
+    mapCtx.waitForStyleLoaded((map) => (map.getSource(id) as any)?.setData(data))
   })
 
   $effect(() => {
-    if (!added || !mapCtx.map || !mapCtx.map.getLayer(id)) return
-    mapCtx.map.setPaintProperty(id, "line-color", color)
-    mapCtx.map.setPaintProperty(id, "line-width", width)
-    mapCtx.map.setPaintProperty(id, "line-opacity", opacity)
+    const paint = { "line-color": color, "line-width": width, "line-opacity": opacity }
+    if (!added) return
+    mapCtx.waitForStyleLoaded((map) => {
+      if (!map.getLayer(id)) return
+      for (const [name, value] of Object.entries(paint)) map.setPaintProperty(id, name, value)
+    })
   })
 
   onDestroy(() => {

package/dist/WidgetMap/mapWrapper/MapLibre.svelte

@@ -9,6 +9,7 @@
     style?: any | string
     zoom?: number
     center?: any
+    bearing?: number
     maxPitch?: number
     map?: any
     children?: Snippet<[any]>
@@ -19,6 +20,7 @@
     style = { version: 8, sources: {}, layers: [] },
     zoom = $bindable(undefined),
     center = $bindable(undefined),
+    bearing = 0,
     maxPitch = 60,
     map = $bindable(undefined),
     children,
@@ -45,13 +47,18 @@
     target.on("sourcedata", tryCollapse)
   }
 
+  /* Стиль, с которым создана или на который переключена карта — setStyle только при его реальной смене */
+  let appliedStyle: any = undefined
+
   const createMap = () => {
     if (!window.maplibregl || map || !container) return
+    appliedStyle = style
     map = new window.maplibregl.Map({
       container,
       style,
       zoom,
       center,
+      bearing,
       maxPitch,
       attributionControl: { compact: true },
     })
@@ -63,7 +70,8 @@
   $effect(createMap)
 
   $effect(() => {
-    if (map && style) {
+    if (map && style && style !== appliedStyle) {
+      appliedStyle = style
       mapCtx.setStyle(style)
     }
   })

package/dist/WidgetMap/mapWrapper/MapLibre.svelte.d.ts

@@ -4,6 +4,7 @@ interface Props {
     style?: any | string;
     zoom?: number;
     center?: any;
+    bearing?: number;
     maxPitch?: number;
     map?: any;
     children?: Snippet<[any]>;

package/dist/WidgetStackInfo/README.md

@@ -19,7 +19,7 @@
     { "Name": "Internal", "Total": 327680,  "Free": 118000,  "MinFree": 92000 },
     { "Name": "PSRAM",    "Total": 4194304, "Free": 3980000, "MinFree": 3920000 }
   ],
-  "Tasks": [{ "Name": "api_task", "FreeMin": 1240, "Prio": 5, "Core": 1, "State": 2 }]
+  "Tasks": [{ "Name": "api_rx_task", "FreeMin": 1240, "Prio": 5, "Core": 1, "State": 2 }]
 }
 ```
 

package/dist/protocols/PROTOCOL.md

@@ -0,0 +1,113 @@
+# 📡 Протокол POE на базе CBOR
+
+Один бинарный пакет `poe_cbor_pkt` на всех проводах: CAN, CAN FD, RS485, LoRa и UART-консоль (xPOE-Debug). Отдельный конверт — только у WebSocket облака.
+Реализации: прошивки ProdFactory-ESP / ProdFactory-STM (`components/core/poe_cbor`, `api_service`) и ядро `poe-svelte-ui-lib/protocols` (DevCloud, SYP-DevTerminal, WebApp).
+
+## 📦 Пакет
+
+```
+0x9F  [TrgBusID, SrcBusID, HAR, Payload, CRC16]  [ … ]  0xFF
+```
+
+- Пакет — CBOR-массив неопределённой длины (`0x9F` … `0xFF`), записей сколько угодно: разным адресатам или несколько одному, порядок сохраняется
+- Запись — массив ровно из 5 элементов (`0x85`); `0x9F 0x85` — маркер начала пакета в потоке
+- Числа — минимальной длиной CBOR: меньше 24 — 1 байт, до 255 — 2, до 65535 — 3
+
+| Поле       | Тип       | Смысл                                                                               |
+| ---------- | --------- | ----------------------------------------------------------------------------------- |
+| `TrgBusID` | uint16    | Адресат: BusID модуля, `0xFFFF` — всем                                              |
+| `SrcBusID` | uint16    | Отправитель, ответ уходит ему; `0x0000` — внешний клиент (терминал, отладка облака) |
+| `HAR`      | uint16    | Заголовок, аргумент и флаг ответа                                                   |
+| `Payload`  | CBOR item | Тело команды                                                                        |
+| `CRC16`    | uint16    | CRC-16/KERMIT записи                                                                |
+
+## 🔢 HAR
+
+```
+бит 15-14  hdr    0 GET · 1 SET · 2 OK! · 3 ER!
+бит 13-1   arg    код из словаря, 0..8191
+бит 0      reply  1 — получатель отвечает
+```
+
+- Прошивка: `har_t` (`api_har.h`), `HAR(h, a)` — с ответом, `HAR_NR(h, a)` — без; библиотека: `makeHar` / `splitHar`
+- Ответ — только на запрос с `reply = 1`, сам ответ всегда без флага; телеметрия и потоки — `HAR_NR`
+- Строки (`"GET"`, `"ModCfg"`) по проводу не передаются; словарь один — `dictionary.yaml` этой библиотеки, в прошивках копия `.framework/Dictionary.yaml`, сборка сверяет с ней `api_har.h`
+- Всё отладочное в словаре начинается с `Debug`: `DebugLog` = 11, `DebugPlot` = 12
+
+## 📄 Payload — всегда одно CBOR item
+
+| Данные                       | Кодирование                                                                                                                                |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| Карта, массив, число, строка | Как есть (ответы `Writer_*`, `{"CfgGroup":"CFG"}`)                                                                                         |
+| Сырые бинарные поля          | Байтовая строка `h'…'`: `CBOR_PACK` / `CBOR_EncodeFields`, разбор — `CBOR_UNPACK` (снимает байтовую строку и сверяет длину с суммой полей) |
+| Пустое тело                  | `null` (`0xF6`), в `pkt->data` — `data_len = 0`                                                                                            |
+
+Флагов формата нет — тип виден по самому CBOR.
+
+## ✅ CRC-16/KERMIT
+
+- Полином `0x8408` (отражённый `0x1021`), init 0, `check("123456789") = 0x2189`
+- Считается по CBOR-байтам записи от `0x85` до конца `Payload`, поле CRC не входит — покрывает адреса и флаг ответа
+- Запись с неверным CRC пропускается, остальные записи пакета принимаются
+
+## 🧭 Адресация
+
+- BusID модуля — CRC16 серийного номера (`get_dev_bus_id`), `0x0000` и `0xFFFF` модулю не выдаются
+- Шина: модуль принимает записи со своим `TrgBusID` и `0xFFFF`, собственное эхо (CAN loopback, RS485) отбрасывает по `SrcBusID`
+- Консоль: `0x0000`, свой BusID и `0xFFFF` — этот модуль, BusID модуля из `ModList` — головной модуль пересылает команду по `ModSN` и возвращает ответ
+- Без обработчика: `OK!`/`ER!` и широковещательные — молча, адресованные `GET`/`SET` — в лог
+
+## 🚌 Транспорты
+
+| Канал        | Передача                                                                                                                             |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
+| CAN / CAN FD | Кадры по 8 / 64 байта; 11-битный ID: бит 10 — последний фрагмент, биты 9-0 — номер пакета; паддинг CAN FD отрезается по длине пакета |
+| RS485        | Сырой поток: начало `0x9F 0x85`, пауза приёма (20 мс) сбрасывает недособранный хвост, мусор сдвигается по байту                      |
+| LoRa         | Пакет целиком в радиокадре                                                                                                           |
+| UART-консоль | Сырой поток вперемешку с текстом загрузчика: начало `0x9F 0x85`, остальное — текст (RAW), хвост сбрасывается после 100 мс тишины     |
+
+## 🐞 Консоль: отладочные пакеты
+
+Прошивка шлёт их с `TrgBusID = 0`, `SrcBusID` = свой BusID, без флага ответа.
+
+| HAR             | Payload                                                      |
+| --------------- | ------------------------------------------------------------ |
+| `OK! DebugLog`  | `[уровень, тег, текст или байты, FHS]`, FHS — свободная куча |
+| `OK! DebugPlot` | `{"Группа.Имя": float32, …}` — один вызов `LOG_PLOT`         |
+
+Ответ API в консоль — голый `Payload`; непустой `Message` приходит отдельным `DebugLog`.
+
+## 🌐 WebSocket (облако и локальный веб)
+
+```
+запрос  {HDR, ARG, VAL: {DevSN, ModSN?, TrgBusID?, SrcBusID?, Payload?}}
+ответ   {HDR, ARG, VAL: {DevSN, ModSN, Message, Payload}}
+```
+
+`DevSN` обязателен и должен совпасть с устройством, `ModSN` — адресат (без него — головной модуль). Приём — `API_Service_ReceiveWsPacket`, ответ — `API_Service_BeginResponse`; ответ модуля с шины головной модуль оборачивает в конверт сам.
+
+## 💡 Пример: `GET ModCfg {}` из терминала
+
+```
+9F  85  00  00  18 49  A0  19 66 06  FF
+│   │   │   │   │      │   │         └ конец пакета
+│   │   │   │   │      │   └ CRC16 = 0x6606
+│   │   │   │   │      └ Payload = {}
+│   │   │   │   └ HAR = 0x0049: GET, arg 36 (ModCfg), reply = 1
+│   │   │   └ SrcBusID = 0x0000 (терминал)
+│   │   └ TrgBusID = 0x0000 (модуль консоли)
+│   └ запись из 5 полей
+└ начало пакета
+```
+
+## 🧩 API
+
+|         | Прошивка (ESP и STM)                                                                                                                             | `poe-svelte-ui-lib/protocols`                                                          |
+| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
+| Пакет   | `CBOR_PktEncInit` / `CBOR_PktEncAddRaw` / `CBOR_PACK` / `CBOR_PktEncFinish`, `CBOR_PktDecInit` / `CBOR_PktDecNext`, поток — `CBOR_PktStreamPush` | `encodePacket`, `decodePacket`, `createPacketStreamParser`, `encodePacketBytesPayload` |
+| HAR     | `har_t`, `HAR`, `HAR_NR`, `API_Service_HarName`, `API_Service_HarByName`                                                                         | `makeHar`, `splitHar`, `xPoeDebugHar`, `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES`        |
+| Приём   | `API_Service_ReceiveBusPacket`, `API_Service_ReceiveWsPacket`, консоль — `system_console`                                                        | `createXPoeDebugParser`, `createCanParser`                                             |
+| Ответ   | `API_Service_BeginResponse`, `Writer_*`, `API_Service_FinishResponse`                                                                            | —                                                                                      |
+| Консоль | `LOG_*`, `LOG_HEX`, `LOG_PLOT`                                                                                                                   | `encodeXPoeDebugFrame`, `xPoeDebugRow`, `xPoeDebugTableColumns`, `debugPlotValues`     |
+| CAN     | `can_service`                                                                                                                                    | `encodeCanPacket`, `createCanParser`, `slcanOpenCommands`                              |
+| Тесты   | хостовые `tests/` прошивок                                                                                                                       | `npm run TestProtocols` по эталонным байтам прошивки                                   |

package/dist/protocols/cbor/json.d.ts

@@ -1,12 +1 @@
-import { type CborValue } from "./types.js";
-export declare class CborToJson {
-    static convert(value: CborValue): unknown;
-    static decode(buffer: ArrayBuffer | Uint8Array): unknown;
-    private static keyToString;
-}
-export declare class JsonToCbor {
-    static convert(value: unknown, parentKey?: string): CborValue;
-    static encode(value: unknown): Uint8Array;
-}
-export declare function cborToJson(buffer: ArrayBuffer | Uint8Array): unknown;
 export declare function jsonToCbor(value: unknown): Uint8Array;

package/dist/protocols/cbor/json.js

@@ -1,77 +1,9 @@
-/* Конвертация между CBOR и JSON-совместимыми значениями: двоичные данные — base64, строки под ключами с "BIN" — байты */
-import { CborTag } from "./types.js";
-import { decodeCbor } from "./decoder.js";
+/* JSON-совместимое значение → CBOR (поля ввода терминала и отладки): строки base64 под ключами с "BIN" — байты */
+import {} from "./types.js";
 import { encodeCbor } from "./encoder.js";
-import { base64ToBytes, bytesToBase64 } from "./base64.js";
-/* Класс для конвертации CBOR в JSON */
-export class CborToJson {
-    /* Преобразовать CBOR значение в JSON-совместимый объект */
-    static convert(value) {
-        /* null */
-        if (value === null)
-            return null;
-        /* undefined */
-        if (value === undefined)
-            return null;
-        /* boolean */
-        if (typeof value === "boolean")
-            return value;
-        /* number */
-        if (typeof value === "number")
-            return value;
-        /* string */
-        if (typeof value === "string")
-            return value;
-        /* Uint8Array -> Base64 строка */
-        if (value instanceof Uint8Array)
-            return bytesToBase64(value);
-        /* Array */
-        if (Array.isArray(value))
-            return value.map((item) => this.convert(item));
-        /* bigint */
-        if (typeof value === "bigint") {
-            /* Если в пределах safe integer - возвращаем как число */
-            if (value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER)) {
-                return Number(value);
-            }
-            /* Иначе возвращаем как строку */
-            return value.toString();
-        }
-        /* Map -> Object (check native Map) */
-        if (value instanceof globalThis.Map) {
-            const obj = {};
-            for (const [key, val] of value) {
-                /* Ключи приводим к строкам */
-                const keyStr = this.keyToString(key);
-                obj[keyStr] = this.convert(val);
-            }
-            return obj;
-        }
-        /* CborTag - распаковываем в объект с полем _tag */
-        if (value instanceof CborTag)
-            return { _tag: Number(value.tag), value: this.convert(value.value) };
-        return null;
-    }
-    /* CBOR -> JSON объект */
-    static decode(buffer) {
-        const value = decodeCbor(buffer);
-        return this.convert(value);
-    }
-    /* Преобразовать ключ в строку */
-    static keyToString(key) {
-        if (typeof key === "string")
-            return key;
-        if (typeof key === "number")
-            return key.toString();
-        if (typeof key === "bigint")
-            return key.toString();
-        if (typeof key === "boolean")
-            return key.toString();
-        return JSON.stringify(key);
-    }
-}
+import { base64ToBytes } from "./base64.js";
 /* Класс для конвертации JSON в CBOR */
-export class JsonToCbor {
+class JsonToCbor {
     /* Преобразовать JSON-совместимое значение в CBOR */
     static convert(value, parentKey) {
         /* null */
@@ -120,10 +52,6 @@ export class JsonToCbor {
     }
 }
 /* Упрощённые функции для быстрого использования */
-/* Декодировать CBOR в JSON объект */
-export function cborToJson(buffer) {
-    return CborToJson.decode(buffer);
-}
 /* Закодировать JSON в CBOR */
 export function jsonToCbor(value) {
     return JsonToCbor.encode(value);

package/dist/protocols/cbor/value.d.ts

@@ -1,12 +1,2 @@
-import { type CborValue } from "./types.js";
-export declare class CborToValue {
-    static convert(value: CborValue): unknown;
-    static decode(buffer: ArrayBuffer | Uint8Array): unknown;
-    private static keyToString;
-}
-export declare class ValueToCbor {
-    static convert(value: unknown): CborValue;
-    static encode(value: unknown): Uint8Array;
-}
 export declare function cborToValue(buffer: ArrayBuffer | Uint8Array): unknown;
 export declare function valueToCbor(value: unknown): Uint8Array;

package/dist/protocols/cbor/value.js

@@ -3,7 +3,7 @@ import { CborTag } from "./types.js";
 import { decodeCbor } from "./decoder.js";
 import { encodeCbor } from "./encoder.js";
 /* Класс для конвертации CBOR в обычное JS-значение */
-export class CborToValue {
+class CborToValue {
     /* Преобразовать CBOR значение в обычный JS-объект/значение */
     static convert(value) {
         /* null */
@@ -70,7 +70,7 @@ export class CborToValue {
     }
 }
 /* Класс для конвертации обычного JS-значения в CBOR */
-export class ValueToCbor {
+class ValueToCbor {
     /* Преобразовать обычное JS-значение в CBOR */
     static convert(value) {
         /* null */

package/dist/protocols/dictionary.yaml

@@ -16,7 +16,7 @@
 - [BackUp, A_BACKUP, 9]                     # Резервная копия конфигурации
 - [BindMKey, A_BIND_MOD_KEY, 10]            # SET: привязка ключа модуля (ModBindKey)
 - [DebugLog, A_DEBUG_LOG, 11]               # OK!: сообщение отладки — CBOR-массив [уровень, тег, текст|байты, FHS]
-- [DebugPlot, A_DEBUG_PLOT, 12]             # OK!: значения графиков отладки — CBOR-карта {"Имя": float32} (SC_PLOT)
+- [DebugPlot, A_DEBUG_PLOT, 12]             # OK!: значения графиков отладки — CBOR-карта {"Имя": float32} (LOG_PLOT)
 - [DataStream, A_DATA_STREAM, 15]           # OK!: поток данных групп конфигурации (CS_PushGroupStream)
 
 # Локальная сеть

package/dist/protocols/index.d.ts

@@ -1,11 +1,9 @@
 export * from "./cbor/types.js";
-export { CborDecoder, decodeCbor } from "./cbor/decoder.js";
-export { CborEncoder, encodeCbor } from "./cbor/encoder.js";
 export { bytesToBase64, base64ToBytes } from "./cbor/base64.js";
-export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value.js";
-export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
+export { cborToValue, valueToCbor } from "./cbor/value.js";
+export { jsonToCbor } from "./cbor/json.js";
 export { crc16Kermit } from "./crc.js";
-export { BROADCAST_BUS_ID, BUS_ID_REGEXP, parseBusId, formatBusId, makeHar, splitHar, EXTERNAL_BUS_ID, packetObjectCrc, encodePacketBytesPayload, encodePacket, decodePacket, objectsFor, createPacketStreamParser, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
+export { BUS_ID_REGEXP, parseBusId, formatBusId, makeHar, splitHar, packetObjectCrc, encodePacketBytesPayload, encodePacket, decodePacket, createPacketStreamParser, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
 export { createPlotGroups, debugPlotValues, DEBUG_PLOT_ARGUMENT, type PlotPoint } from "./plotGroups.js";
 export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugHar, xPoeDebugValueFromText, xPoeDebugRow, DEBUG_LOG_ARGUMENT, type XPoeDebugItem, type XPoeDebugRow, } from "./xPoeDebug.js";
 export { formatXPoeDebugValue, formatXPoeDebugValueForTable, formatXPoeDebugModal, bindXPoeDebugCopyButtons } from "./xPoeDebugView.js";

package/dist/protocols/index.js

@@ -2,17 +2,15 @@
 /* Общее ядро протоколов обмена с устройствами для DevCloud, WebApp и SYP-DevTerminal — без Svelte, точка входа "poe-svelte-ui-lib/protocols"
    (условие default: работает и в браузере, и под Node без Vite); импорты с расширением .js, чтобы их разрешал сам Node */
 export * from "./cbor/types.js";
-export { CborDecoder, decodeCbor } from "./cbor/decoder.js";
-export { CborEncoder, encodeCbor } from "./cbor/encoder.js";
 export { bytesToBase64, base64ToBytes } from "./cbor/base64.js";
 /* Значение ↔ CBOR: двоичные данные — Uint8Array как есть (WebSocket, хранилище, телеметрия) */
-export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value.js";
-/* JSON-текст ↔ CBOR: двоичные данные — base64, ключи с "BIN" кодируются байтами (поля ввода терминала и отладки) */
-export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
+export { cborToValue, valueToCbor } from "./cbor/value.js";
+/* JSON-значение → CBOR: строки base64 под ключами с "BIN" кодируются байтами (поля ввода терминала и отладки) */
+export { jsonToCbor } from "./cbor/json.js";
 /* Контрольная сумма и пакет poe_cbor_pkt [[TrgBusID, SrcBusID, HAR, Payload, CRC16], …] — все шины и консоль */
 export { crc16Kermit } from "./crc.js";
-export { BROADCAST_BUS_ID, BUS_ID_REGEXP, parseBusId, formatBusId, makeHar, splitHar, EXTERNAL_BUS_ID, packetObjectCrc, encodePacketBytesPayload, encodePacket, decodePacket, objectsFor, createPacketStreamParser, } from "./packet.js";
-/* Графики отладки: пакет OK! DebugPlot (SC_PLOT прошивки) — значения из CBOR-карты, график на группу, серии в порядке устройства */
+export { BUS_ID_REGEXP, parseBusId, formatBusId, makeHar, splitHar, packetObjectCrc, encodePacketBytesPayload, encodePacket, decodePacket, createPacketStreamParser, } from "./packet.js";
+/* Графики отладки: пакет OK! DebugPlot (LOG_PLOT прошивки) — значения из CBOR-карты, график на группу, серии в порядке устройства */
 export { createPlotGroups, debugPlotValues, DEBUG_PLOT_ARGUMENT } from "./plotGroups.js";
 /* xPOE-Debug — UART-консоль как шина: пакеты вперемешку с текстом загрузчика, логи OK! DebugLog */
 export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugHar, xPoeDebugValueFromText, xPoeDebugRow, DEBUG_LOG_ARGUMENT, } from "./xPoeDebug.js";

package/dist/protocols/packet.d.ts

@@ -1,5 +1,3 @@
-export declare const BROADCAST_BUS_ID = 65535;
-export declare const EXTERNAL_BUS_ID = 0;
 export declare const BUS_ID_REGEXP: RegExp;
 export declare const parseBusId: (text: string | undefined, fallback?: number) => number;
 export declare const formatBusId: (id: number) => string;
@@ -35,7 +33,6 @@ export type PacketParse = {
     status: "garbage";
 };
 export declare const decodePacket: (bytes: Uint8Array) => PacketParse;
-export declare const objectsFor: (objects: DecodedPacketObject[], busID: number) => DecodedPacketObject[];
 export declare const createPacketStreamParser: ({ gapMs, maxBytes }?: {
     gapMs?: number | undefined;
     maxBytes?: number | undefined;

package/dist/protocols/packet.js

@@ -5,10 +5,6 @@ import { CborDecoder } from "./cbor/decoder.js";
 import { CborEncoder } from "./cbor/encoder.js";
 import { CborEndOfDataError } from "./cbor/types.js";
 import { crc16Kermit } from "./crc.js";
-/* Адрес «всем устройствам шины» — только адресат */
-export const BROADCAST_BUS_ID = 0xffff;
-/* Адрес внешнего клиента (терминал, отладка облака) — у модулей такого адреса не бывает */
-export const EXTERNAL_BUS_ID = 0x0000;
 /* BusID в полях ввода — HEX без "0x", 1-4 знака (uint16) */
 export const BUS_ID_REGEXP = /^[0-9A-Fa-f]{1,4}$/;
 /* HEX-поле BusID → число; пусто или не HEX — fallback */
@@ -132,8 +128,6 @@ export const decodePacket = (bytes) => {
     }
     return { status: "complete", length: offset, objects };
 };
-/* Объекты пакета для своего адреса (и broadcast) с верным CRC, по порядку — как CBOR_PktDecNext прошивки */
-export const objectsFor = (objects, busID) => objects.filter((object) => object.crcOk && (object.trgBusID === busID || object.trgBusID === BROADCAST_BUS_ID));
 /* Потоковый разбор пакетов из сырого потока (RS485): пауза дольше gapMs обрывает недособранный пакет, мусор сдвигается по байту,
    без единого целого пакета буфер не растёт дальше maxBytes */
 export const createPacketStreamParser = ({ gapMs = 100, maxBytes = 4096 } = {}) => {

package/dist/protocols/plotGroups.js

@@ -1,5 +1,5 @@
 /* $lib/protocols/plotGroups.ts */
-/* Графики отладки: пакет xPOE-Debug OK! DebugPlot (SC_PLOT прошивки), Payload — CBOR-карта {"Группа.Имя": float32, …} в порядке вызова.
+/* Графики отладки: пакет xPOE-Debug OK! DebugPlot (LOG_PLOT прошивки), Payload — CBOR-карта {"Группа.Имя": float32, …} в порядке вызова.
    График на группу — префикс имени до первой точки, без префикса — общая группа ""; серии в порядке карты, у серий, которых в кадре нет, — после них */
 import { cborToValue } from "./cbor/value.js";
 import { xPoeDebugValueFromText } from "./xPoeDebug.js";

package/dist/types.d.ts

@@ -116,8 +116,13 @@ export interface IFileAttachProps {
         name?: string;
         class?: string;
     };
-    type?: "file" | "image";
+    type?: "file" | "image" | "button";
     accept?: string;
+    info?: {
+        text: string;
+        side: "top" | "bottom" | "left" | "right";
+    };
+    icon?: ConstructorOfATypedSvelteComponent | string | null;
     imageSize?: {
         height?: string;
         width?: string;

package/package.json

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