poe-svelte-ui-lib 1.72.0 → 1.74.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, Cmd, Payload, CRC16], …]` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты одному адресату не склеиваются, порядок сохраняется, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `BROADCAST_BUS_ID = 0xFFFF`), `EXTERNAL_BUS_ID = 0x0000` — `SrcBusID` терминала и отладки, `makeCmd(header, argument, reply = true)`/`splitCmd` — `Cmd`: заголовок в битах 14-15, аргумент в битах 1-13 (0..8191), флаг ответа в бите 0 (как `CMD`/`CMD_NR` прошивки), `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc` — строго побайтные, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка xPOE-Debug (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodeXPoeDebugFrame` — команда устройству, `createXPoeDebugParser().push(байты)` — потоковый разбор кадров и текста вне кадров (`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 команды xPOE-Debug из ввода — `xPoeDebugValueFromText` (hex как есть, JSON → CBOR). Графики отладки — кадр `OK! DebPlot` (`SC_PLOT` прошивки, `DEB_PLOT_ARGUMENT`): `debPlotValues(value)` — пары `[имя, число]` из hex CBOR-карты `VALUE`, `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_cmd.h`), `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` — indefinite-массив объектов `[[TrgBusID, SrcBusID, Cmd, Payload, CRC16], …]` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты одному адресату не склеиваются, порядок сохраняется, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `BROADCAST_BUS_ID = 0xFFFF`), `EXTERNAL_BUS_ID = 0x0000` — `SrcBusID` терминала и отладки, `makeCmd(header, argument, reply = true)`/`splitCmd` — `Cmd`: заголовок в битах 14-15, аргумент в битах 1-13 (0..8191), флаг ответа в бите 0 (как `CMD`/`CMD_NR` прошивки), `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc` — строго побайтные, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Протокол xPOE-Debug (UART-консоль `system_console`): definite CBOR-массив `[SrcID, HdrArg, Value, FHS, CRC16]`; `HdrArg` — общее 16-битное `cmd_t.word`, `Value` — один CBOR item, FHS — свободная куча (или `null` в запросе), CRC-16/KERMIT покрывает сырые CBOR-байты первых четырёх элементов. `encodeXPoeDebugFrame` кодирует запрос, `createXPoeDebugParser().push(байты)` разбирает поток кадров и внешний текст (`raw`). 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). Графики отладки — кадр `OK! DebPlot` (`SC_PLOT` прошивки, `DEB_PLOT_ARGUMENT`): `debPlotValues(value)` — пары `[имя, число]` из hex CBOR-карты `VALUE`, `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_cmd.h`), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/protocols/crc.js

@@ -9,7 +9,7 @@ export const crc16Kermit = (crc, bytes) => {
     }
     return crc & 0xffff;
 };
-/* CRC-8/ROHC: poly 0x07 reflected (0xE0), init 0xFF, xorout 0x00, check("123456789") = 0xD0 — рамка xPOE-Debug (system_console): HEADER, ARGUMENT, VALUE */
+/* CRC-8/ROHC remains available for legacy consumers. System Console frames use CRC-16/KERMIT over CBOR bytes. */
 export const crc8Rohc = (crc, bytes) => {
     for (const byte of bytes) {
         crc ^= byte & 0xff;

package/dist/protocols/dictionary.yaml

@@ -9,13 +9,14 @@
 - [Restart, A_RESTART, 1]                   # SET: перезагрузка устройства
 - [DefCfg, A_DEF_CONFIG, 2]                 # SET: сброс конфигурации к заводской
 - [DlFW, A_DOWNLOAD_FIRMWARE, 3]            # SET: скачивание прошивки с сервера (http_client)
-- [DebPlot, A_DEB_PLOT, 4]                  # OK!: значения графиков отладки — CBOR-карта {"Имя": float32} (SC_PLOT)
 - [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)
+- [DebugLog, A_DEBUG_LOG, 11]               # OK!: системное сообщение отладки; VALUE — CBOR-массив [уровень, тег, текст]
+- [DebPlot, A_DEBUG_PLOT, 12]               # OK!: значения графиков отладки — CBOR-карта {"Имя": float32} (SC_PLOT)
 - [DataStream, A_DATA_STREAM, 15]           # OK!: поток данных групп конфигурации (CS_PushGroupStream)
 
 # Локальная сеть

package/dist/protocols/dictionaryCodes.js

@@ -4,13 +4,14 @@ export const DEFAULT_ARGUMENT_CODES = {
     Restart: 1,
     DefCfg: 2,
     DlFW: 3,
-    DebPlot: 4,
     RstNVS: 5,
     LocTime: 6,
     Update: 7,
     StackInfo: 8,
     BackUp: 9,
     BindMKey: 10,
+    DebugLog: 11,
+    DebPlot: 12,
     DataStream: 15,
     APsList: 21,
     FS: 22,

package/dist/protocols/index.d.ts

@@ -7,6 +7,7 @@ export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
 export { crc16Kermit, crc8Rohc } from "./crc.js";
 export { BROADCAST_BUS_ID, makeCmd, splitCmd, EXTERNAL_BUS_ID, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
 export { createPlotGroups, debPlotValues, DEB_PLOT_ARGUMENT, type PlotPoint } from "./plotGroups.js";
-export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugValueFromText, type XPoeDebugItem } from "./xPoeDebug.js";
+export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugCmd, xPoeDebugValueFromText, type XPoeDebugItem } from "./xPoeDebug.js";
+export { formatXPoeDebugValue, formatXPoeDebugValueForTable, 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

@@ -14,8 +14,10 @@ export { crc16Kermit, crc8Rohc } from "./crc.js";
 export { BROADCAST_BUS_ID, makeCmd, splitCmd, EXTERNAL_BUS_ID, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, } from "./packet.js";
 /* Графики отладки: кадр OK! DebPlot (SC_PLOT прошивки) — значения из CBOR-карты, график на группу, серии в порядке устройства */
 export { createPlotGroups, debPlotValues, DEB_PLOT_ARGUMENT } from "./plotGroups.js";
-/* Рамка xPOE-Debug (UART-консоль system_console): сборка команды и потоковый разбор кадров и текста */
-export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugValueFromText } from "./xPoeDebug.js";
+/* System Console over UART: CBOR [SrcID, HdrArg, Value, FHS, CRC16], plus stream parsing */
+export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugCmd, xPoeDebugValueFromText } from "./xPoeDebug.js";
+/* Отображение Value xPOE-Debug в таблице/модалке и копирование Value/HEX */
+export { formatXPoeDebugValue, formatXPoeDebugValueForTable, 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";
 /* Словарь заголовков и аргументов Cmd — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */

package/dist/protocols/xPoeDebug.d.ts

@@ -1,10 +1,7 @@
-export declare const SOH = 1;
-export declare const STX = 2;
-export declare const ETX = 3;
-export declare const EOT = 4;
-export declare const US = 31;
 export type XPoeDebugItem = {
     type: "frame";
+    srcId: number;
+    cmd: number;
     header: string;
     argument: string;
     value: string;
@@ -16,7 +13,8 @@ export type XPoeDebugItem = {
     type: "raw";
     text: string;
 };
-export declare const encodeXPoeDebugFrame: (header: string, argument: string, value: Uint8Array) => Uint8Array;
+export declare const xPoeDebugCmd: (header: string, argument: string) => number;
+export declare const encodeXPoeDebugFrame: (header: string, argument: string, value: Uint8Array, srcId?: number, freeHeap?: number | null) => Uint8Array;
 export declare const createXPoeDebugParser: () => {
     push(chunk: Uint8Array): XPoeDebugItem[];
     reset(): void;

package/dist/protocols/xPoeDebug.js

@@ -1,59 +1,83 @@
-/* $lib/protocols/xPoeDebug.ts */
-/* Рамка xPOE-Debug (system_console прошивки): [SOH] HEADER [US] ARGUMENT [STX] VALUE [ETX] CRC8 [US] FHS [EOT] \n — CRC8 двумя hex-символами
-   по HEADER+ARGUMENT+VALUE (crc8Rohc), FHS (свободная куча) только у кадров устройства. Устройство шлёт VALUE текстом (лог или hex-дамп CBOR),
-   устройству VALUE уходит сырыми байтами CBOR. Значения графиков — кадр OK! DebPlot (createPlotGroups). Текст между кадрами — RAW (вывод загрузчика и т.п.) */
-import { crc8Rohc } from "./crc.js";
+/* System Console: CBOR array [SrcID, HdrArg, Value, FHS, CRC16]. CRC-16/KERMIT covers the encoded
+   first four array items, including the array header. UART is a stream; the definite array is self-delimiting. */
+import { CborDecoder } from "./cbor/decoder.js";
+import { CborEndOfDataError } from "./cbor/types.js";
+import { crc16Kermit } from "./crc.js";
 import { jsonToCbor } from "./cbor/json.js";
-export const SOH = 0x01;
-export const STX = 0x02;
-export const ETX = 0x03;
-export const EOT = 0x04;
-export const US = 0x1f;
-const LF = 0x0a;
-/* Предел текста без конца строки и незавершённого кадра — дальше отдаётся/сбрасывается, чтобы буфер не рос бесконечно */
+import { DEFAULT_ARGUMENT_CODES, HEADER_CODES, nameByCode } from "./dictionary.js";
+import { makeCmd, splitCmd } from "./packet.js";
 const MAX_TEXT_TAIL = 4096;
 const MAX_FRAME = 8192;
-const encoder = new TextEncoder();
+const ARRAY5 = 0x85;
 const decoder = new TextDecoder();
-const hex2 = (value) => value.toString(16).toUpperCase().padStart(2, "0");
-/* Кадр команды устройству — те же байты, что разбирает system_console (VALUE — сырой CBOR, FHS не передаётся) */
-export const encodeXPoeDebugFrame = (header, argument, value) => {
-    const headerBytes = encoder.encode(header);
-    const argumentBytes = encoder.encode(argument);
-    const crc = crc8Rohc(crc8Rohc(crc8Rohc(0xff, headerBytes), argumentBytes), value);
-    return new Uint8Array([SOH, ...headerBytes, US, ...argumentBytes, STX, ...value, ETX, ...encoder.encode(hex2(crc)), EOT]);
+const encodeUInt = (input) => {
+    const value = BigInt(input);
+    if (value < 24n)
+        return [Number(value)];
+    if (value <= 0xffn)
+        return [0x18, Number(value)];
+    if (value <= 0xffffn)
+        return [0x19, Number(value >> 8n), Number(value & 0xffn)];
+    if (value <= 0xffffffffn)
+        return [0x1a, Number(value >> 24n), Number(value >> 16n & 0xffn), Number(value >> 8n & 0xffn), Number(value & 0xffn)];
+    throw new Error("xPOE-Debug integer is out of range");
 };
-/* Строки текста вне кадров → raw; пустые и с управляющими символами пропускаются */
-const textItems = (bytes) => decoder
-    .decode(bytes)
-    .split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line && ![...line].some((char) => char.charCodeAt(0) < 0x20 && char !== "\t"))
-    .map((line) => ({ type: "raw", text: line }));
-/* Кадр от SOH до EOT включительно; без разделителей — null (пропускается, как в прошивке и Rust-терминале) */
-const frameItem = (frame) => {
-    const us = frame.indexOf(US);
-    const stx = us < 0 ? -1 : frame.indexOf(STX, us + 1);
-    const etx = stx < 0 ? -1 : frame.indexOf(ETX, stx + 1);
-    if (etx < 0)
-        return null;
-    const header = frame.subarray(1, us);
-    const argument = frame.subarray(us + 1, stx);
-    const valueBytes = frame.subarray(stx + 1, etx);
-    const tailUs = frame.indexOf(US, etx + 1);
-    const crc = decoder.decode(frame.subarray(etx + 1, tailUs < 0 ? frame.length - 1 : tailUs)).trim();
-    const freeHeap = tailUs < 0 ? "" : decoder.decode(frame.subarray(tailUs + 1, frame.length - 1)).trim();
-    const crcCalc = crc8Rohc(crc8Rohc(crc8Rohc(0xff, header), argument), valueBytes);
-    return {
-        type: "frame",
-        header: decoder.decode(header),
-        argument: decoder.decode(argument),
-        value: decoder.decode(valueBytes),
-        valueBytes: valueBytes.slice(),
-        crc,
-        crcOk: /^[0-9A-Fa-f]{2}$/.test(crc) && parseInt(crc, 16) === crcCalc,
-        freeHeap,
-    };
+export const xPoeDebugCmd = (header, argument) => {
+    const hdr = HEADER_CODES[header];
+    const arg = DEFAULT_ARGUMENT_CODES[argument];
+    if (hdr === undefined || arg === undefined)
+        throw new Error(`Hdr/Arg отсутствует в общем словаре: ${header} ${argument}`);
+    return makeCmd(hdr, arg);
+};
+/* Команда терминала: CRC считается по тем CBOR-байтам, которые реально отправляются. */
+export const encodeXPoeDebugFrame = (header, argument, value, srcId = 0, freeHeap = null) => {
+    const cmd = xPoeDebugCmd(header, argument);
+    if (!Number.isInteger(srcId) || srcId < 0 || srcId > 0xffff || !Number.isInteger(cmd) || cmd < 0 || cmd > 0xffff)
+        throw new Error("SrcID и HdrArg должны быть uint16");
+    const valueParser = new CborDecoder(value);
+    if (!valueParser.skipValue() || valueParser.offset !== value.length)
+        throw new Error("Value должен содержать ровно один CBOR item");
+    const prefix = new Uint8Array([ARRAY5, ...encodeUInt(srcId), ...encodeUInt(cmd), ...value, ...(freeHeap === null ? [0xf6] : encodeUInt(freeHeap))]);
+    const crc = crc16Kermit(0, prefix);
+    return new Uint8Array([...prefix, ...encodeUInt(crc)]);
+};
+const textItems = (bytes) => decoder.decode(bytes).split("\n").map((line) => line.trim()).filter((line) => line && ![...line].some((char) => char.charCodeAt(0) < 0x20 && char !== "\t")).map((text) => ({ type: "raw", text }));
+const readUInt = (value) => typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 0xffff ? value : null;
+/* Декодирует одну definite array из начала буфера; null означает неполный или невалидный кадр. */
+const frameItem = (buffer) => {
+    if (buffer[0] !== ARRAY5)
+        return { status: "garbage" };
+    try {
+        const cbor = new CborDecoder(buffer);
+        cbor.decode(); /* Проверка структуры и границы всего массива */
+        const length = cbor.offset;
+        const fields = new CborDecoder(buffer.subarray(1, length));
+        const srcId = readUInt(fields.decode());
+        const cmd = readUInt(fields.decode());
+        if (srcId === null || cmd === null)
+            return { status: "garbage" };
+        const valueStart = 1 + fields.offset;
+        if (!fields.skipValue())
+            return { status: "garbage" };
+        const valueEnd = 1 + fields.offset;
+        const freeHeapValue = fields.decode();
+        const crcStart = 1 + fields.offset;
+        const crc = readUInt(fields.decode());
+        if (fields.offset !== length - 1 || crc === null || (freeHeapValue !== null && (typeof freeHeapValue !== "number" || !Number.isInteger(freeHeapValue) || freeHeapValue < 0)))
+            return { status: "garbage" };
+        const valueBytes = buffer.slice(valueStart, valueEnd);
+        const { header, argument } = splitCmd(cmd);
+        return {
+            status: "complete",
+            length,
+            item: { type: "frame", srcId, cmd, header: Object.entries(HEADER_CODES).find(([, code]) => code === header)?.[0] ?? String(header), argument: nameByCode(DEFAULT_ARGUMENT_CODES, argument), value: Array.from(valueBytes, (byte) => byte.toString(16).padStart(2, "0").toUpperCase()).join(""), valueBytes, crc: crc.toString(16).toUpperCase().padStart(4, "0"), crcOk: crc16Kermit(0, buffer.subarray(0, crcStart)) === crc, freeHeap: typeof freeHeapValue === "number" ? String(freeHeapValue) : "" },
+        };
+    }
+    catch (error) {
+        if (error instanceof CborEndOfDataError)
+            return { status: "incomplete" };
+        return { status: "garbage" };
+    }
 };
 const concat = (a, b) => {
     const out = new Uint8Array(a.length + b.length);
@@ -61,59 +85,53 @@ const concat = (a, b) => {
     out.set(b, a.length);
     return out;
 };
-/* Потоковый разбор: push(байты из порта) → готовые кадры и строки; незавершённое ждёт следующего чанка */
 export const createXPoeDebugParser = () => {
     let buffer = new Uint8Array();
     return {
         push(chunk) {
             buffer = concat(buffer, chunk);
             const items = [];
-            for (;;) {
-                const soh = buffer.indexOf(SOH);
-                if (soh < 0)
+            while (buffer.length) {
+                const start = buffer.indexOf(ARRAY5);
+                if (start < 0) {
+                    const cut = buffer.length > MAX_TEXT_TAIL ? buffer.length : buffer.lastIndexOf(0x0a);
+                    if (cut >= 0) {
+                        items.push(...textItems(buffer.subarray(0, cut)));
+                        buffer = buffer.slice(Math.min(cut + 1, buffer.length));
+                    }
+                    else if (buffer.length > MAX_TEXT_TAIL)
+                        buffer = new Uint8Array();
                     break;
-                /* Текст перед кадром не теряем; обрывок прошлого кадра (до последнего EOT) отбрасываем */
-                if (soh > 0) {
-                    const prefix = buffer.subarray(0, soh);
-                    items.push(...textItems(prefix.subarray(prefix.lastIndexOf(EOT) + 1)));
-                    buffer = buffer.slice(soh);
+                }
+                if (start > 0) {
+                    items.push(...textItems(buffer.subarray(0, start)));
+                    buffer = buffer.slice(start);
                     continue;
                 }
-                const eot = buffer.indexOf(EOT);
-                if (eot < 0) {
-                    /* Кадр без конца слишком длинный — потерян EOT: пропускаем его SOH и ищем следующий кадр, иначе ждём ещё байт */
+                const parsed = frameItem(buffer);
+                if (parsed.status === "incomplete") {
                     if (buffer.length <= MAX_FRAME)
                         break;
                     buffer = buffer.slice(1);
                     continue;
                 }
-                const item = frameItem(buffer.subarray(0, eot + 1));
-                if (item)
-                    items.push(item);
-                buffer = buffer.slice(eot + 1);
-            }
-            /* Хвост без начала кадра: целые строки — наружу, незавершённая строка ждёт следующего чанка */
-            if (buffer.indexOf(SOH) < 0) {
-                const cut = buffer.length > MAX_TEXT_TAIL ? buffer.length : buffer.lastIndexOf(LF);
-                if (cut >= 0) {
-                    items.push(...textItems(buffer.subarray(0, cut)));
-                    buffer = buffer.slice(Math.min(cut + 1, buffer.length));
+                if (parsed.status === "garbage") {
+                    buffer = buffer.slice(1);
+                    continue;
                 }
+                items.push(parsed.item);
+                buffer = buffer.slice(parsed.length);
             }
             return items;
         },
-        /* Сброс при переподключении порта */
-        reset() {
-            buffer = new Uint8Array();
-        },
+        reset() { buffer = new Uint8Array(); },
     };
 };
-/* Поле Value команды из ввода пользователя: пусто — без тела, hex-строка (с пробелами или без) — готовые байты как есть, иначе JSON → CBOR
-   (двоичные данные — base64, ключи с BIN — байты, см. jsonToCbor); не hex и не JSON — ошибка */
+/* Value form input: ready CBOR hex passes through; JSON is converted to CBOR. */
 export const xPoeDebugValueFromText = (text) => {
     const trimmed = (text ?? "").trim();
     if (!trimmed)
-        return new Uint8Array();
+        return new Uint8Array([0xf6]);
     if (/^([0-9A-Fa-f]{2}\s?)+$/.test(trimmed))
         return Uint8Array.from(trimmed.replace(/\s/g, "").match(/../g) ?? [], (pair) => parseInt(pair, 16));
     let parsed;

package/dist/protocols/xPoeDebugView.d.ts

@@ -0,0 +1,4 @@
+export declare function formatXPoeDebugValue(rawValue: string): string;
+export declare function formatXPoeDebugValueForTable(rawValue: string, isCbor?: boolean): string;
+export declare function bindXPoeDebugCopyButtons(): () => void;
+export declare function formatXPoeDebugModal(text: string): string;

package/dist/protocols/xPoeDebugView.js

@@ -0,0 +1,107 @@
+import { cborToValue } from "./cbor/value.js";
+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(" ");
+const normalizeCborValue = (value) => {
+    if (value instanceof Uint8Array)
+        return `h'${bytesToHex(value)}'`;
+    if (Array.isArray(value))
+        return value.map(normalizeCborValue);
+    if (value && typeof value === "object")
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, normalizeCborValue(item)]));
+    return value;
+};
+const compactCborValue = (value) => {
+    if (typeof value === "string")
+        return escapeHtml(value);
+    if (value instanceof Uint8Array)
+        return `bytes(${value.length}): ${escapeHtml(bytesToHex(value))}`;
+    return escapeHtml(JSON.stringify(normalizeCborValue(value)) ?? String(value));
+};
+/* Декодирует CBOR Value для таблицы; системный лог имеет вид [уровень, тег, текст]. */
+export function formatXPoeDebugValue(rawValue) {
+    const hex = rawValue.trim().replace(/\s/g, "");
+    if (!hex || hex.length % 2 !== 0 || !/^[0-9A-Fa-f]+$/.test(hex))
+        return escapeHtml(rawValue);
+    try {
+        const value = cborToValue(Uint8Array.from(hex.match(/.{2}/g), (byte) => parseInt(byte, 16)));
+        if (Array.isArray(value) &&
+            value.length === 3 &&
+            typeof value[0] === "number" &&
+            LOG_LEVELS[value[0]] &&
+            typeof value[1] === "string" &&
+            (typeof value[2] === "string" || value[2] instanceof Uint8Array)) {
+            const level = LOG_LEVELS[value[0]];
+            const detail = compactCborValue(value[2]);
+            return `<span class="font-semibold">${level}</span> · ${escapeHtml(value[1])}${detail ? ` · ${detail}` : ""}`;
+        }
+        return compactCborValue(value);
+    }
+    catch {
+        return escapeHtml(rawValue);
+    }
+}
+/* Сохраняет исходный HEX скрытым до раскрытия строки в общей таблице. */
+export function formatXPoeDebugValueForTable(rawValue, isCbor = true) {
+    if (!isCbor)
+        return escapeHtml(rawValue);
+    const formatted = formatXPoeDebugValue(rawValue);
+    return formatted === escapeHtml(rawValue) ? formatted : `${formatted}<span class="hidden">\nHEX\n${escapeHtml(rawValue)}</span>`;
+}
+const COPY_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" aria-hidden="true"><g fill="none" stroke="currentColor" stroke-width="1.5"><path d="M6 11c0-2.828 0-4.243.879-5.121C7.757 5 9.172 5 12 5h3c2.828 0 4.243 0 5.121.879C21 6.757 21 8.172 21 11v5c0 2.828 0 4.243-.879 5.121C19.243 22 17.828 22 15 22h-3c-2.828 0-4.243 0-5.121-.879C6 20.243 6 18.828 6 16z"/><path d="M6 19a3 3 0 0 1-3-3v-6c0-3.771 0-5.657 1.172-6.828S7.229 2 11 2h4a3 3 0 0 1 3 3"/></g></svg>`;
+const COPIED_ICON = `<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" aria-hidden="true"><path d="m5 12 4 4L19 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
+let copyBindings = 0;
+const handleCopyClick = (event) => {
+    if (!(event.target instanceof Element))
+        return;
+    const button = event.target.closest("button[data-xpoe-copy]");
+    if (!button)
+        return;
+    event.preventDefault();
+    event.stopPropagation();
+    const value = button.closest("section")?.querySelector("pre")?.textContent ?? "";
+    const label = button.getAttribute("aria-label") ?? "Копировать";
+    navigator.clipboard
+        .writeText(value)
+        .then(() => {
+        button.innerHTML = COPIED_ICON;
+        button.setAttribute("aria-label", "Скопировано");
+        window.setTimeout(() => {
+            button.innerHTML = COPY_ICON;
+            button.setAttribute("aria-label", label);
+        }, 1300);
+    })
+        .catch(() => {
+        button.setAttribute("aria-label", "Не удалось скопировать");
+        window.setTimeout(() => button.setAttribute("aria-label", label), 1300);
+    });
+};
+/* Делегированный обработчик кнопок модального окна; возвращённую функцию вызывают при уничтожении страницы. */
+export function bindXPoeDebugCopyButtons() {
+    if (copyBindings++ === 0)
+        document.addEventListener("click", handleCopyClick);
+    let isBound = true;
+    return () => {
+        if (!isBound)
+            return;
+        isBound = false;
+        if (--copyBindings === 0)
+            document.removeEventListener("click", handleCopyClick);
+    };
+}
+/* Две прокручиваемые секции модалки; 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 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";
+    const buttonStyle = "display:flex;flex:0 0 28px;align-items:center;justify-content:center;width:28px;height:28px;padding:0;border:0;border-radius:.5rem;background:transparent;color:var(--faint-color);cursor:pointer";
+    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 `<style>[data-modal]:has([data-xpoe-debug-modal])>div:last-child{display:none!important}</style><div data-xpoe-debug-modal style="${modalStyle}">${pane("Value", "value", decoded)}${hexIndex < 0 ? "" : pane("HEX", "hex", hex)}</div>`;
+}

package/package.json

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