poe-svelte-ui-lib 1.76.0 → 1.78.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` (основной вход библиотеки): общие для отладки облака и терминала. Ячейка Value — `formatXPoeDebugValue` (CBOR одной строкой, `DebugLog` — уровень · тег · текст), окно по клику — `formatXPoeDebugModal`: Value в развёрнутом виде `formatXPoeDebugPretty` (карты и массивы с отступами, `DebugLog` — уровень и тег, ниже текст или дамп и FHS), HEX — байты `Payload` по 16 в строке; числа float32 выводятся кратчайшей записью (`0.12`). 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/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,13 +1,11 @@
 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";
+export { formatXPoeDebugValue, formatXPoeDebugValueForTable, formatXPoeDebugPretty, formatXPoeDebugModal, bindXPoeDebugCopyButtons } from "./xPoeDebugView.js";
 export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, slcanOpenCommands, type CanFrame, type CanMessage, } from "./can.js";
 export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/protocols/index.js

@@ -2,22 +2,20 @@
 /* Общее ядро протоколов обмена с устройствами для 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";
 /* Отображение Value xPOE-Debug в таблице/модалке и копирование Value/HEX */
-export { formatXPoeDebugValue, formatXPoeDebugValueForTable, formatXPoeDebugModal, bindXPoeDebugCopyButtons } from "./xPoeDebugView.js";
+export { formatXPoeDebugValue, formatXPoeDebugValueForTable, formatXPoeDebugPretty, formatXPoeDebugModal, bindXPoeDebugCopyButtons } from "./xPoeDebugView.js";
 /* CAN/CAN FD через slcan-адаптер: нарезка пакета на кадры как в can_service прошивки, кадры slcan, потоковый разбор со сборкой фрагментов */
 export { CAN_FINAL_BIT, CAN_PACKET_ID_MASK, canFragments, encodeSlcanFrame, encodeCanPacket, createCanParser, slcanOpenCommands, } from "./can.js";
 /* Словарь заголовков и аргументов HAR — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */

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/protocols/xPoeDebugView.d.ts

@@ -1,3 +1,4 @@
+export declare function formatXPoeDebugPretty(hex: string): string | null;
 export declare function formatXPoeDebugValue(rawValue: string): string;
 export declare function formatXPoeDebugValueForTable(rawValue: string, isCbor?: boolean): string;
 export declare function bindXPoeDebugCopyButtons(): () => void;

package/dist/protocols/xPoeDebugView.js

@@ -3,7 +3,20 @@ const LOG_LEVELS = { 1: "🔴", 2: "🟡", 3: "🟢", 4: "🔵" };
 const HTML_ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" };
 const escapeHtml = (value) => value.replace(/[&<>"']/g, (char) => HTML_ESCAPES[char]);
 const bytesToHex = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0").toUpperCase()).join(" ");
+/* float32 с провода — кратчайшая запись, дающая то же float32 (0.12, а не 0.12000000476837158); double и целые — как есть */
+const shortNumber = (value) => {
+    if (Number.isInteger(value) || !Number.isFinite(value) || Math.fround(value) !== value)
+        return value;
+    for (let digits = 1; digits <= 9; digits++) {
+        const short = Number(value.toPrecision(digits));
+        if (Math.fround(short) === value)
+            return short;
+    }
+    return value;
+};
 const normalizeCborValue = (value) => {
+    if (typeof value === "number")
+        return shortNumber(value);
     if (value instanceof Uint8Array)
         return `h'${bytesToHex(value)}'`;
     if (Array.isArray(value))
@@ -19,6 +32,40 @@ const compactCborValue = (value) => {
         return `bytes(${value.length}): ${escapeHtml(bytesToHex(value))}`;
     return escapeHtml(JSON.stringify(normalizeCborValue(value)) ?? String(value));
 };
+const hexToBytes = (hex) => {
+    const clean = hex.replace(/\s/g, "");
+    if (!clean || clean.length % 2 !== 0 || !/^[0-9A-Fa-f]+$/.test(clean))
+        return null;
+    return Uint8Array.from(clean.match(/.{2}/g), (byte) => parseInt(byte, 16));
+};
+const isDebugLog = (value) => Array.isArray(value) &&
+    value.length === 4 &&
+    typeof value[0] === "number" &&
+    !!LOG_LEVELS[value[0]] &&
+    typeof value[1] === "string" &&
+    (typeof value[2] === "string" || value[2] instanceof Uint8Array);
+/* Байты строками по 16 — для дампов DebugLog и раздела HEX */
+const hexRows = (bytes) => (bytesToHex(bytes).match(/.{1,48}/g) ?? []).map((row) => row.trim()).join("\n");
+/* Payload в модалку: развёрнутый вид — карты и массивы с отступами, DebugLog — уровень и тег, ниже текст или дамп и FHS; не CBOR — null */
+export function formatXPoeDebugPretty(hex) {
+    const bytes = hexToBytes(hex);
+    if (!bytes)
+        return null;
+    try {
+        const value = cborToValue(bytes);
+        if (isDebugLog(value)) {
+            const [level, tag, detail, fhs] = value;
+            const body = detail instanceof Uint8Array ? `bytes(${detail.length}):\n${hexRows(detail)}` : detail;
+            return [`${LOG_LEVELS[level]} ${tag}`, body, typeof fhs === "number" ? `FHS: ${fhs}` : ""].filter(Boolean).join("\n");
+        }
+        if (typeof value === "string")
+            return value;
+        return JSON.stringify(normalizeCborValue(value), null, 2) ?? String(value);
+    }
+    catch {
+        return null;
+    }
+}
 /* Payload в таблицу: CBOR как JSON, лог DebugLog [уровень, тег, текст|байты, FHS] — уровень · тег · текст */
 export function formatXPoeDebugValue(rawValue) {
     const hex = rawValue.trim().replace(/\s/g, "");
@@ -26,12 +73,7 @@ export function formatXPoeDebugValue(rawValue) {
         return escapeHtml(rawValue);
     try {
         const value = cborToValue(Uint8Array.from(hex.match(/.{2}/g), (byte) => parseInt(byte, 16)));
-        if (Array.isArray(value) &&
-            value.length === 4 &&
-            typeof value[0] === "number" &&
-            LOG_LEVELS[value[0]] &&
-            typeof value[1] === "string" &&
-            (typeof value[2] === "string" || value[2] instanceof Uint8Array)) {
+        if (isDebugLog(value)) {
             const level = LOG_LEVELS[value[0]];
             const detail = compactCborValue(value[2]);
             return `<span class="font-semibold">${level}</span> · ${escapeHtml(value[1])}${detail ? ` · ${detail}` : ""}`;
@@ -108,12 +150,15 @@ export function bindXPoeDebugCopyButtons() {
         }
     };
 }
-/* Две прокручиваемые секции модалки; HEX-раздел появляется, если форматтер таблицы добавил исходные байты. */
+/* Две прокручиваемые секции модалки: Value — развёрнутый вид Payload (formatXPoeDebugPretty), HEX — байты Payload по 16 в строке; HEX-раздел есть, если форматтер таблицы добавил исходные байты */
 export function formatXPoeDebugModal(text) {
     const separator = "\nHEX\n";
     const hexIndex = text.lastIndexOf(separator);
-    const decoded = hexIndex < 0 ? text : text.slice(0, hexIndex);
     const hex = hexIndex < 0 ? "" : text.slice(hexIndex + separator.length);
+    const pretty = hex ? formatXPoeDebugPretty(hex) : null;
+    const bytes = pretty === null ? null : hexToBytes(hex);
+    const decoded = pretty === null ? (hexIndex < 0 ? text : text.slice(0, hexIndex)) : escapeHtml(pretty);
+    const hexText = bytes ? hexRows(bytes) : hex;
     const modalStyle = "display:flex;flex-direction:column;gap:.75rem;max-height:80vh;min-width:0;overflow-y:auto;overflow-x:hidden";
     const sectionStyle = "min-width:0;padding:.25rem 0 .75rem";
     const headingStyle = "display:flex;align-items:center;justify-content:space-between;gap:.75rem;margin:0 0 .5rem;font-weight:600";
@@ -121,5 +166,5 @@ export function formatXPoeDebugModal(text) {
     const buttonClass = "flex size-7 cursor-pointer items-center justify-center rounded-lg border-none bg-transparent text-(--faint-color) transition-colors duration-150 hover:bg-(--container-color) hover:text-(--font-color)";
     const textStyle = "display:block;min-width:0;max-width:100%;margin:0;white-space:pre-wrap;overflow-wrap:anywhere;word-break:break-word;font:inherit";
     const pane = (title, target, value) => `<section style="${sectionStyle}"><div style="${headingStyle}"><span>${title}</span><button type="button" class="${buttonClass}" data-xpoe-copy="${target}" aria-label="Копировать ${title}" style="${buttonStyle}">${COPY_ICON}</button></div><pre style="${textStyle}">${value}</pre></section>`;
-    return `<div data-xpoe-debug-modal style="${modalStyle}">${pane("Value", "value", decoded)}${hexIndex < 0 ? "" : pane("HEX", "hex", hex)}</div>`;
+    return `<div data-xpoe-debug-modal style="${modalStyle}">${pane("Value", "value", decoded)}${hexIndex < 0 ? "" : pane("HEX", "hex", hexText)}</div>`;
 }

package/package.json

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