poe-svelte-ui-lib 1.74.2 → 1.75.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`): 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`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
+**Ядро протоколов** — `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`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/Table/xPoeDebugColumns.d.ts

@@ -0,0 +1,3 @@
+import type { ITableHeader } from "../types";
+import { type XPoeDebugRow } from "../protocols/index.js";
+export declare const xPoeDebugTableColumns: ITableHeader<XPoeDebugRow>[];

package/dist/Table/xPoeDebugColumns.js

@@ -0,0 +1,17 @@
+import { formatXPoeDebugModal } from "../protocols/index.js";
+import { tableMonoWidth } from "./columnWidth";
+export const xPoeDebugTableColumns = [
+    { label: { name: "TRG" }, content: [{ type: "text", data: { key: "trgId" } }], width: tableMonoWidth(6, 3), align: "center" },
+    { label: { name: "SRC" }, content: [{ type: "text", data: { key: "srcId" } }], width: tableMonoWidth(6, 3), align: "center" },
+    { label: { name: "HAR" }, content: [{ type: "text", data: { key: "har" } }], width: tableMonoWidth(4, 3), align: "center" },
+    { label: { name: "HDR" }, content: [{ type: "text", data: { key: "header" } }], width: tableMonoWidth(4, 3), align: "center" },
+    { label: { name: "ARG" }, content: [{ type: "text", data: { key: "argument" } }], width: tableMonoWidth(16, 3), align: "left" },
+    {
+        label: { name: "VALUE" },
+        content: [{ type: "text", data: { key: "value", truncated: true, formatting: formatXPoeDebugModal, copy: true, modal: true } }],
+        width: "1fr",
+        align: "left",
+    },
+    /* Свободная куча устройства из DebugLog */
+    { label: { name: "FHS" }, content: [{ type: "text", data: { key: "freeHeap" } }], width: tableMonoWidth(7, 3), align: "center" },
+];

package/dist/index.d.ts

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

package/dist/index.js

@@ -30,6 +30,7 @@ export { default as SwitchProps } from "./Switch/SwitchProps.svelte";
 export { default as Table } from "./Table/Table.svelte";
 export { default as TableProps } from "./Table/TableProps.svelte";
 export { tableMonoWidth } from "./Table/columnWidth";
+export { xPoeDebugTableColumns } from "./Table/xPoeDebugColumns";
 export { bitFieldGet, bitFieldSet } from "./bitField";
 export { default as Tabs } from "./Tabs/Tabs.svelte";
 export { default as TabsProps } from "./Tabs/TabsProps.svelte";

package/dist/protocols/crc.d.ts

@@ -1,2 +1 @@
 export declare const crc16Kermit: (crc: number, bytes: Uint8Array | number[]) => number;
-export declare const crc8Rohc: (crc: number, bytes: Uint8Array | number[]) => number;

package/dist/protocols/crc.js

@@ -1,5 +1,5 @@
 /* $lib/protocols/crc.ts */
-/* Контрольные суммы протоколов устройств — строго побайтные, как crc8_rohc/crc16_kermit в common.c прошивок (ProdFactory-ESP/STM) */
+/* Контрольные суммы протоколов устройств — строго побайтные, как crc16_kermit в common.c прошивок (ProdFactory-ESP/STM) */
 /* CRC-16/KERMIT: poly 0x1021 reflected (0x8408), init 0x0000, xorout 0x0000, check("123456789") = 0x2189 — объекты пакета poe_cbor_pkt */
 export const crc16Kermit = (crc, bytes) => {
     for (const byte of bytes) {
@@ -9,12 +9,3 @@ export const crc16Kermit = (crc, bytes) => {
     }
     return crc & 0xffff;
 };
-/* 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;
-        for (let bit = 0; bit < 8; bit++)
-            crc = crc & 1 ? (crc >>> 1) ^ 0xe0 : crc >>> 1;
-    }
-    return crc & 0xff;
-};

package/dist/protocols/dictionary.js

@@ -1,5 +1,5 @@
 /* $lib/protocols/dictionary.ts */
-/* Словарь заголовков и аргументов протокола — заголовок и аргумент поля Cmd пакета (makeCmd/splitCmd). Аргументы по умолчанию —
+/* Словарь заголовков и аргументов протокола — заголовок и аргумент поля HAR пакета (makeHar/splitHar). Аргументы по умолчанию —
    из мастер-словаря dictionary.yaml рядом (единственный источник; .framework/Dictionary.yaml прошивок — его справочные копии), DEFAULT_ARGUMENT_CODES
    генерируется из него (dictionaryCodes.ts, npm run Dictionary); у устройства словарь может быть свой — его загружают из файла
    (parseArgumentDictionary), своих копий словаря в приложениях не держим */

package/dist/protocols/dictionary.yaml

@@ -1,4 +1,4 @@
-# Словарь аргументов протокола (поле arg в Cmd, 0..8191) — единый для всех устройств, обоих фреймворков и приложений
+# Словарь аргументов протокола (поле arg в HAR, 0..8191) — единый для всех устройств, обоих фреймворков и приложений
 # Строковое представление аргумента | Название в перечислении | Числовой код
 # Источник — poe-svelte-ui-lib (src/lib/protocols/dictionary.yaml); .framework/Dictionary.yaml фреймворков — копии, не править
 
@@ -15,8 +15,8 @@
 - [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)
+- [DebugLog, A_DEBUG_LOG, 11]               # OK!: сообщение отладки — CBOR-массив [уровень, тег, текст|байты, FHS]
+- [DebugPlot, A_DEBUG_PLOT, 12]             # OK!: значения графиков отладки — CBOR-карта {"Имя": float32} (SC_PLOT)
 - [DataStream, A_DATA_STREAM, 15]           # OK!: поток данных групп конфигурации (CS_PushGroupStream)
 
 # Локальная сеть

package/dist/protocols/dictionaryCodes.js

@@ -11,7 +11,7 @@ export const DEFAULT_ARGUMENT_CODES = {
     BackUp: 9,
     BindMKey: 10,
     DebugLog: 11,
-    DebPlot: 12,
+    DebugPlot: 12,
     DataStream: 15,
     APsList: 21,
     FS: 22,

package/dist/protocols/index.d.ts

@@ -4,10 +4,10 @@ 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 { 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, xPoeDebugCmd, xPoeDebugValueFromText, type XPoeDebugItem } from "./xPoeDebug.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 { 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 { 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

@@ -9,16 +9,16 @@ export { bytesToBase64, base64ToBytes } from "./cbor/base64.js";
 export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value.js";
 /* JSON-текст ↔ CBOR: двоичные данные — base64, ключи с "BIN" кодируются байтами (поля ввода терминала и отладки) */
 export { CborToJson, JsonToCbor, cborToJson, jsonToCbor } from "./cbor/json.js";
-/* Контрольные суммы и пакет poe_cbor_pkt [[TrgBusID, SrcBusID, Cmd, Payload, CRC16], …] (CAN, RS485) */
-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";
-/* System Console over UART: single-record poe_cbor_pkt with debug-only FHS */
-export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugCmd, xPoeDebugValueFromText } from "./xPoeDebug.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 { 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";
 /* 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 библиотеки, разбор файла словаря */
+/* Словарь заголовков и аргументов HAR — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */
 export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/protocols/packet.d.ts

@@ -1,9 +1,12 @@
 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;
 export interface PacketObject {
     trgBusID: number;
     srcBusID: number;
-    cmd: number;
+    har: number;
     payload: Uint8Array;
 }
 export interface DecodedPacketObject extends PacketObject {
@@ -13,8 +16,8 @@ export interface DecodedPacketObject extends PacketObject {
     crc: number;
     crcOk: boolean;
 }
-export declare const makeCmd: (header: number, argument: number, reply?: boolean) => number;
-export declare const splitCmd: (cmd: number) => {
+export declare const makeHar: (header: number, argument: number, reply?: boolean) => number;
+export declare const splitHar: (har: number) => {
     header: number;
     argument: number;
     reply: boolean;

package/dist/protocols/packet.js

@@ -1,6 +1,6 @@
 /* $lib/protocols/packet.ts */
-/* Общий пакет poe_cbor_pkt: indefinite ARRAY записей [TrgBusID, SrcBusID, Cmd, Payload, CRC16].
-   Payload — ровно один CBOR item. CRC-16/KERMIT считается по сырым CBOR-байтам записи от её заголовка до конца Payload. */
+/* Общий пакет poe_cbor_pkt всех шин и консоли: indefinite ARRAY записей [TrgBusID, SrcBusID, HAR, Payload, CRC16].
+   Payload — ровно одно CBOR item (сырые данные — байтовая строка), пустой — null. CRC-16/KERMIT — по CBOR-байтам записи от её заголовка до конца Payload */
 import { CborDecoder } from "./cbor/decoder.js";
 import { CborEncoder } from "./cbor/encoder.js";
 import { CborEndOfDataError } from "./cbor/types.js";
@@ -9,37 +9,43 @@ import { crc16Kermit } from "./crc.js";
 export const BROADCAST_BUS_ID = 0xffff;
 /* Адрес внешнего клиента (терминал, отладка облака) — у модулей такого адреса не бывает */
 export const EXTERNAL_BUS_ID = 0x0000;
-/* Cmd = заголовок (0..3) в битах 14-15, аргумент (0..8191) в битах 1-13, флаг ответа в бите 0 — как CMD/CMD_NR в api_cmd.h прошивки */
-export const makeCmd = (header, argument, reply = true) => ((header & 0x03) << 14) | ((argument & 0x1fff) << 1) | (reply ? 1 : 0);
-export const splitCmd = (cmd) => ({
-    header: (cmd >> 14) & 0x03,
-    argument: (cmd >> 1) & 0x1fff,
-    reply: (cmd & 1) === 1,
+/* BusID в полях ввода — HEX без "0x", 1-4 знака (uint16) */
+export const BUS_ID_REGEXP = /^[0-9A-Fa-f]{1,4}$/;
+/* HEX-поле BusID → число; пусто или не HEX — fallback */
+export const parseBusId = (text, fallback = 0) => (text && BUS_ID_REGEXP.test(text) ? parseInt(text, 16) : fallback);
+/* BusID для таблиц — 0x0000 */
+export const formatBusId = (id) => `0x${id.toString(16).toUpperCase().padStart(4, "0")}`;
+/* HAR = заголовок (0..3) в битах 14-15, аргумент (0..8191) в битах 1-13, флаг ответа в бите 0 — как HAR/HAR_NR в api_har.h прошивки */
+export const makeHar = (header, argument, reply = true) => ((header & 0x03) << 14) | ((argument & 0x1fff) << 1) | (reply ? 1 : 0);
+export const splitHar = (har) => ({
+    header: (har >> 14) & 0x03,
+    argument: (har >> 1) & 0x1fff,
+    reply: (har & 1) === 1,
 });
+const NULL_PAYLOAD = Uint8Array.of(0xf6);
 export const packetObjectCrc = (encodedRecordPrefix) => crc16Kermit(0, encodedRecordPrefix);
-/* Кодирует сырые байты как один CBOR byte string для Payload. */
+/* Сырые байты одним CBOR item Payload — байтовой строкой, как CBOR_PACK прошивки */
 export const encodePacketBytesPayload = (bytes) => {
     const encoder = new CborEncoder();
     encoder.encodeBytes(bytes);
     return encoder.getResult();
 };
-/* Пакет из одного или нескольких объектов — те же байты, что CBOR_PACK/CBOR_PktEncFinish прошивки */
+/* Пакет из одного или нескольких объектов — те же байты, что CBOR_PktEncAddRaw/CBOR_PktEncFinish прошивки */
 export const encodePacket = (objects) => {
     const encoder = new CborEncoder();
     encoder.encodeArrayStart(null);
-    for (const { trgBusID, srcBusID, cmd, payload } of objects) {
+    for (const { trgBusID, srcBusID, har, payload } of objects) {
+        const item = payload.length ? payload : NULL_PAYLOAD;
+        const payloadDecoder = new CborDecoder(item);
+        if (!payloadDecoder.skipValue() || payloadDecoder.offset !== item.length)
+            throw new Error("Payload должен содержать ровно одно CBOR item");
         const recordStart = encoder.getResult().length;
         encoder.encodeArrayStart(5);
         encoder.encodeUnsigned(trgBusID);
         encoder.encodeUnsigned(srcBusID);
-        encoder.encodeUnsigned(cmd);
-        const prefixStart = encoder.getResult().length;
-        /* Payload is already CBOR-encoded; reject malformed or concatenated values. */
-        const payloadDecoder = new CborDecoder(payload);
-        if (!payloadDecoder.skipValue() || payloadDecoder.offset !== payload.length)
-            throw new Error("Payload должен содержать ровно один CBOR item");
-        encoder.encodeRaw(payload);
-        const prefix = encoder.getResult().slice(recordStart, prefixStart + payload.length);
+        encoder.encodeUnsigned(har);
+        encoder.encodeRaw(item);
+        const prefix = encoder.getResult().slice(recordStart);
         encoder.encodeUnsigned(packetObjectCrc(prefix));
     }
     encoder.encodeBreak();
@@ -63,12 +69,12 @@ const toNumber = (value) => (typeof value === "number" && Number.isInteger(value
 const toObject = (value, rawRecord) => {
     if (!Array.isArray(value) || value.length !== 5)
         return null;
-    const [trgBusID, srcBusID, cmd, crc] = [toNumber(value[0]), toNumber(value[1]), toNumber(value[2]), toNumber(value[4])];
-    if (trgBusID === null || srcBusID === null || cmd === null || crc === null)
+    const [trgBusID, srcBusID, har, crc] = [toNumber(value[0]), toNumber(value[1]), toNumber(value[2]), toNumber(value[4])];
+    if (trgBusID === null || srcBusID === null || har === null || crc === null)
         return null;
     const info = rawRecord[0] & 0x1f;
     const headerLength = info < 24 ? 1 : info === 24 ? 2 : info === 25 ? 3 : info === 26 ? 5 : info === 27 ? 9 : 0;
-    if ((rawRecord[0] >> 5) !== 4 || headerLength === 0)
+    if (rawRecord[0] >> 5 !== 4 || headerLength === 0)
         return null;
     const fields = new CborDecoder(rawRecord.subarray(headerLength));
     for (let i = 0; i < 3; i++)
@@ -79,8 +85,9 @@ const toObject = (value, rawRecord) => {
         return null;
     const payloadEnd = headerLength + fields.offset;
     const prefix = rawRecord.subarray(0, payloadEnd);
-    const payloadBytes = rawRecord.subarray(payloadStart, payloadEnd);
-    return { trgBusID, srcBusID, cmd, payload: payloadBytes, crc, crcOk: packetObjectCrc(prefix) === crc, ...splitCmd(cmd) };
+    const item = rawRecord.subarray(payloadStart, payloadEnd);
+    const payload = item.length === 1 && item[0] === 0xf6 ? new Uint8Array() : item;
+    return { trgBusID, srcBusID, har, payload, crc, crcOk: packetObjectCrc(prefix) === crc, ...splitHar(har) };
 };
 /* Разбор пакета с начала буфера — и для целого кадра (CAN), и для потока (RS485: «incomplete» — ждать ещё байт, «garbage» — сдвинуться на байт) */
 export const decodePacket = (bytes) => {

package/dist/protocols/plotGroups.d.ts

@@ -1,9 +1,9 @@
-export declare const DEB_PLOT_ARGUMENT = "DebPlot";
+export declare const DEBUG_PLOT_ARGUMENT = "DebugPlot";
 export interface PlotPoint {
     name: string;
     value: number;
 }
-export declare const debPlotValues: (value: string) => [string, number][];
+export declare const debugPlotValues: (value: string) => [string, number][];
 export declare const createPlotGroups: () => {
     update(values: [string, number][]): string[];
     data(group: string): PlotPoint[];

package/dist/protocols/plotGroups.js

@@ -1,11 +1,11 @@
 /* $lib/protocols/plotGroups.ts */
-/* Графики отладки: кадр xPOE-Debug OK! DebPlot (SC_PLOT прошивки), VALUE — hex CBOR-карты {"Группа.Имя": float32, …} в порядке вызова.
+/* Графики отладки: пакет xPOE-Debug OK! DebugPlot (SC_PLOT прошивки), Payload — CBOR-карта {"Группа.Имя": float32, …} в порядке вызова.
    График на группу — префикс имени до первой точки, без префикса — общая группа ""; серии в порядке карты, у серий, которых в кадре нет, — после них */
 import { cborToValue } from "./cbor/value.js";
 import { xPoeDebugValueFromText } from "./xPoeDebug.js";
-export const DEB_PLOT_ARGUMENT = "DebPlot";
-/* Значения графиков из VALUE кадра DebPlot (hex CBOR-карты); не карта — пустой список */
-export const debPlotValues = (value) => {
+export const DEBUG_PLOT_ARGUMENT = "DebugPlot";
+/* Значения графиков из Payload пакета DebugPlot (HEX CBOR-карты); не карта — пустой список */
+export const debugPlotValues = (value) => {
     try {
         const decoded = cborToValue(xPoeDebugValueFromText(value));
         const entries = decoded instanceof Map ? [...decoded] : decoded && typeof decoded === "object" ? Object.entries(decoded) : [];
@@ -18,7 +18,7 @@ export const debPlotValues = (value) => {
 export const createPlotGroups = () => {
     const groups = new Map();
     return {
-        /* Значения одного кадра; возвращает группы, которые обновились */
+        /* Значения одного пакета; возвращает группы, которые обновились */
         update(values) {
             const fresh = new Map();
             for (const [series, value] of values) {

package/dist/protocols/xPoeDebug.d.ts

@@ -1,10 +1,12 @@
+export declare const DEBUG_LOG_ARGUMENT = "DebugLog";
 export type XPoeDebugItem = {
     type: "frame";
     trgId: number;
     srcId: number;
-    cmd: number;
+    har: number;
     header: string;
     argument: string;
+    reply: boolean;
     value: string;
     valueBytes: Uint8Array;
     crc: string;
@@ -14,8 +16,19 @@ export type XPoeDebugItem = {
     type: "raw";
     text: string;
 };
-export declare const xPoeDebugCmd: (header: string, argument: string) => number;
-export declare const encodeXPoeDebugFrame: (header: string, argument: string, value: Uint8Array, srcId?: number, freeHeap?: number | null, trgId?: number) => Uint8Array;
+export declare const xPoeDebugHar: (header: string, argument: string, reply?: boolean) => number;
+export declare const encodeXPoeDebugFrame: (header: string, argument: string, value: Uint8Array, srcId?: number, trgId?: number, reply?: boolean) => Uint8Array;
+export interface XPoeDebugRow {
+    trgId: string;
+    srcId: string;
+    har: string;
+    header: string;
+    argument: string;
+    value: string;
+    crc: string;
+    freeHeap: string;
+}
+export declare const xPoeDebugRow: (item: XPoeDebugItem) => XPoeDebugRow;
 export declare const createXPoeDebugParser: () => {
     push(chunk: Uint8Array): XPoeDebugItem[];
     reset(): void;

package/dist/protocols/xPoeDebug.js

@@ -1,45 +1,30 @@
-/* Debug is a one-record poe_cbor_pkt. Its record adds FHS to the common bus fields. */
-import { CborDecoder } from "./cbor/decoder.js";
-import { CborEndOfDataError } from "./cbor/types.js";
-import { crc16Kermit } from "./crc.js";
+/* $lib/protocols/xPoeDebug.ts */
+/* xPOE-Debug — UART-консоль как ещё одна шина: пакеты poe_cbor_pkt [[TrgBusID, SrcBusID, HAR, Payload, CRC16], …] вперемешку с текстом загрузчика.
+   Логи — OK! DebugLog, Payload [уровень, тег, текст|байты, FHS]; графики — OK! DebugPlot, Payload {"Группа.Имя": float32} */
+import { cborToValue } from "./cbor/value.js";
 import { jsonToCbor } from "./cbor/json.js";
 import { DEFAULT_ARGUMENT_CODES, HEADER_CODES, nameByCode } from "./dictionary.js";
-import { makeCmd, splitCmd } from "./packet.js";
+import { decodePacket, encodePacket, formatBusId, makeHar } from "./packet.js";
+export const DEBUG_LOG_ARGUMENT = "DebugLog";
 const MAX_TEXT_TAIL = 4096;
-const MAX_FRAME = 8192;
+const MAX_PACKET = 8192;
 const PACKET_START = 0x9f;
-const RECORD6 = 0x86;
+const RECORD = 0x85;
 const decoder = new TextDecoder();
-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");
-};
-export const xPoeDebugCmd = (header, argument) => {
+const toHex = (bytes) => Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0").toUpperCase()).join("");
+/* HAR по строкам словаря; неизвестные заголовок или аргумент — ошибка */
+export const xPoeDebugHar = (header, argument, reply = true) => {
     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);
+    return makeHar(hdr, arg, reply);
 };
-/* Команда терминала: CRC считается по тем CBOR-байтам, которые реально отправляются. */
-export const encodeXPoeDebugFrame = (header, argument, value, srcId = 0, freeHeap = null, trgId = 0) => {
-    const cmd = xPoeDebugCmd(header, argument);
-    if (![srcId, trgId, cmd].every((n) => Number.isInteger(n) && n >= 0 && n <= 0xffff))
-        throw new Error("TrgBusID, SrcBusID и Cmd должны быть uint16");
-    const valueParser = new CborDecoder(value);
-    if (!valueParser.skipValue() || valueParser.offset !== value.length)
-        throw new Error("Value должен содержать ровно один CBOR item");
-    const recordPrefix = new Uint8Array([RECORD6, ...encodeUInt(trgId), ...encodeUInt(srcId), ...encodeUInt(cmd), ...value, ...(freeHeap === null ? [0xf6] : encodeUInt(freeHeap))]);
-    const crc = crc16Kermit(0, recordPrefix);
-    return new Uint8Array([PACKET_START, ...recordPrefix, ...encodeUInt(crc), 0xff]);
+/* Команда терминала — пакет из одной записи; value — CBOR item Payload, пустой — null */
+export const encodeXPoeDebugFrame = (header, argument, value, srcId = 0, trgId = 0, reply = true) => {
+    if (![srcId, trgId].every((n) => Number.isInteger(n) && n >= 0 && n <= 0xffff))
+        throw new Error("TrgBusID и SrcBusID должны быть uint16");
+    return encodePacket([{ trgBusID: trgId, srcBusID: srcId, har: xPoeDebugHar(header, argument, reply), payload: value }]);
 };
 const textItems = (bytes) => decoder
     .decode(bytes)
@@ -47,64 +32,61 @@ const textItems = (bytes) => decoder
     .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);
-/* Декодирует пакет из одной записи с FHS; null означает неполный или невалидный кадр. */
-const frameItem = (buffer) => {
-    if (buffer[0] !== PACKET_START || buffer[1] !== RECORD6)
-        return { status: "garbage" };
+/* FHS — четвёртый элемент Payload DebugLog */
+const freeHeapOf = (argument, payload) => {
+    if (argument !== DEBUG_LOG_ARGUMENT || !payload.length)
+        return "";
     try {
-        const cbor = new CborDecoder(buffer);
-        const packet = cbor.decode(); /* Проверка структуры и границы всего пакета */
-        if (!Array.isArray(packet) || packet.length !== 1 || !Array.isArray(packet[0]) || packet[0].length !== 6)
-            return { status: "garbage" };
-        const length = cbor.offset;
-        const fields = new CborDecoder(buffer.subarray(2, length));
-        const trgId = readUInt(fields.decode());
-        const srcId = readUInt(fields.decode());
-        const cmd = readUInt(fields.decode());
-        if (trgId === null || srcId === null || cmd === null)
-            return { status: "garbage" };
-        const valueStart = 2 + fields.offset;
-        if (!fields.skipValue())
-            return { status: "garbage" };
-        const valueEnd = 2 + fields.offset;
-        const freeHeapValue = fields.decode();
-        const crcStart = 2 + fields.offset;
-        const crc = readUInt(fields.decode());
-        if (fields.offset !== length - 3 || 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",
-                trgId,
-                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(1, crcStart)) === crc,
-                freeHeap: typeof freeHeapValue === "number" ? String(freeHeapValue) : "",
-            },
-        };
+        const value = cborToValue(payload);
+        return Array.isArray(value) && typeof value[3] === "number" ? String(value[3]) : "";
     }
-    catch (error) {
-        if (error instanceof CborEndOfDataError)
-            return { status: "incomplete" };
-        return { status: "garbage" };
+    catch {
+        return "";
     }
 };
+const frameItem = (object) => {
+    const argument = nameByCode(DEFAULT_ARGUMENT_CODES, object.argument);
+    return {
+        type: "frame",
+        trgId: object.trgBusID,
+        srcId: object.srcBusID,
+        har: object.har,
+        header: nameByCode(HEADER_CODES, object.header),
+        argument,
+        reply: object.reply,
+        value: toHex(object.payload),
+        valueBytes: object.payload.slice(),
+        crc: object.crc.toString(16).toUpperCase().padStart(4, "0"),
+        crcOk: object.crcOk,
+        freeHeap: freeHeapOf(argument, object.payload),
+    };
+};
+export const xPoeDebugRow = (item) => item.type === "raw"
+    ? { trgId: "", srcId: "", har: "", header: "RAW", argument: "", value: item.text, crc: "", freeHeap: "" }
+    : {
+        trgId: formatBusId(item.trgId),
+        srcId: formatBusId(item.srcId),
+        har: item.har.toString(16).toUpperCase().padStart(4, "0"),
+        header: item.crcOk ? item.header : "⚠️",
+        argument: item.argument,
+        value: item.value,
+        crc: item.crc,
+        freeHeap: item.freeHeap,
+    };
+/* Начало пакета — 0x9F 0x85 (0x9F последним байтом буфера — возможное начало) */
+const packetStart = (buffer) => {
+    for (let i = buffer.indexOf(PACKET_START); i >= 0; i = buffer.indexOf(PACKET_START, i + 1))
+        if (i + 1 >= buffer.length || buffer[i + 1] === RECORD)
+            return i;
+    return -1;
+};
 const concat = (a, b) => {
     const out = new Uint8Array(a.length + b.length);
     out.set(a);
     out.set(b, a.length);
     return out;
 };
+/* Потоковый разбор: пакеты в любом месте разреза, текст — построчно, мусор сдвигается по байту */
 export const createXPoeDebugParser = () => {
     let buffer = new Uint8Array();
     return {
@@ -112,34 +94,30 @@ export const createXPoeDebugParser = () => {
             buffer = concat(buffer, chunk);
             const items = [];
             while (buffer.length) {
-                const start = buffer.indexOf(PACKET_START);
+                const start = packetStart(buffer);
                 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;
                 }
+                if (start + 1 >= buffer.length)
+                    break; /* 0x9F последним байтом — ждём следующий */
                 if (start > 0) {
                     items.push(...textItems(buffer.subarray(0, start)));
                     buffer = buffer.slice(start);
                     continue;
                 }
-                const parsed = frameItem(buffer);
-                if (parsed.status === "incomplete") {
-                    if (buffer.length <= MAX_FRAME)
-                        break;
-                    buffer = buffer.slice(1);
-                    continue;
-                }
-                if (parsed.status === "garbage") {
+                const parsed = decodePacket(buffer);
+                if (parsed.status === "incomplete" && buffer.length <= MAX_PACKET)
+                    break;
+                if (parsed.status !== "complete" || !parsed.objects.length) {
                     buffer = buffer.slice(1);
                     continue;
                 }
-                items.push(parsed.item);
+                items.push(...parsed.objects.map(frameItem));
                 buffer = buffer.slice(parsed.length);
             }
             return items;
@@ -149,11 +127,11 @@ export const createXPoeDebugParser = () => {
         },
     };
 };
-/* Value form input: ready CBOR hex passes through; JSON is converted to CBOR. */
+/* Поле Value: готовый HEX CBOR проходит как есть, JSON кодируется в CBOR, пусто — пустой Payload */
 export const xPoeDebugValueFromText = (text) => {
     const trimmed = (text ?? "").trim();
     if (!trimmed)
-        return new Uint8Array([0xf6]);
+        return new Uint8Array();
     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.js

@@ -19,7 +19,7 @@ const compactCborValue = (value) => {
         return `bytes(${value.length}): ${escapeHtml(bytesToHex(value))}`;
     return escapeHtml(JSON.stringify(normalizeCborValue(value)) ?? String(value));
 };
-/* Декодирует CBOR Value для таблицы; системный лог имеет вид [уровень, тег, текст]. */
+/* Payload в таблицу: CBOR как JSON, лог DebugLog [уровень, тег, текст|байты, FHS] — уровень · тег · текст */
 export function formatXPoeDebugValue(rawValue) {
     const hex = rawValue.trim().replace(/\s/g, "");
     if (!hex || hex.length % 2 !== 0 || !/^[0-9A-Fa-f]+$/.test(hex))
@@ -27,7 +27,7 @@ export function formatXPoeDebugValue(rawValue) {
     try {
         const value = cborToValue(Uint8Array.from(hex.match(/.{2}/g), (byte) => parseInt(byte, 16)));
         if (Array.isArray(value) &&
-            value.length === 3 &&
+            value.length === 4 &&
             typeof value[0] === "number" &&
             LOG_LEVELS[value[0]] &&
             typeof value[1] === "string" &&
@@ -42,7 +42,7 @@ export function formatXPoeDebugValue(rawValue) {
         return escapeHtml(rawValue);
     }
 }
-/* Сохраняет исходный HEX скрытым до раскрытия строки в общей таблице. */
+/* Исходный HEX скрыт до раскрытия строки в общей таблице */
 export function formatXPoeDebugValueForTable(rawValue, isCbor = true) {
     if (!isCbor)
         return escapeHtml(rawValue);

package/package.json

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