poe-svelte-ui-lib 1.71.0 → 1.73.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(байты)` — потоковый разбор кадров, строк Teleplot (`plot`) и прочего текста (`raw`), с проверкой CRC `crc8Rohc` строго побайтно, как `crc8_rohc` в `common.c` прошивок. CAN/CAN FD через slcan-адаптер (`can_service` прошивки): `canFragments`/`encodeCanPacket` — нарезка пакета на кадры как `CAN_Send` (бит 10 ID — «последний», биты 0..9 — `packetId`, по 8 / 64 байта), `encodeSlcanFrame`, `createCanParser().push(байты)` — разбор кадров slcan со сборкой фрагментов и обрезкой паддинга CAN FD. RS485 — сырой поток пакетов: `createPacketStreamParser().push(байты)` (пауза обрывает недособранное, мусор пропускается по байту). Открытие slcan-адаптера — `slcanOpenCommands(скорость, скоростьДанных?)`. Поле Value команды xPOE-Debug из ввода — `xPoeDebugValueFromText` (hex как есть, JSON → CBOR). Графики Teleplot (строки PLOT `>Группа.Имя:Значение`) — `createPlotGroups({ gapMs })`: `push(серия, значение, время)` раскладывает по группам (префикс до точки) и держит серии в порядке устройства — пачка значений идёт подряд, новая начинается после паузы дольше `gapMs` (50 мс) или с повтора имени, порядок берётся из последней пачки; `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

@@ -15,6 +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)
 - [DataStream, A_DATA_STREAM, 15]           # OK!: поток данных групп конфигурации (CS_PushGroupStream)
 
 # Локальная сеть

package/dist/protocols/dictionaryCodes.js

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

package/dist/protocols/index.d.ts

@@ -6,7 +6,7 @@ export { CborToValue, ValueToCbor, cborToValue, valueToCbor } from "./cbor/value
 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, type PlotPoint } from "./plotGroups.js";
-export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugValueFromText, type XPoeDebugItem } from "./xPoeDebug.js";
+export { createPlotGroups, debPlotValues, DEB_PLOT_ARGUMENT, type PlotPoint } from "./plotGroups.js";
+export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugCmd, xPoeDebugValueFromText, type XPoeDebugItem } from "./xPoeDebug.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

@@ -12,10 +12,10 @@ 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";
-/* Группы графиков Teleplot (строки PLOT): серии в порядке устройства, график на группу */
-export { createPlotGroups } from "./plotGroups.js";
-/* Рамка xPOE-Debug (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
-export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugValueFromText } from "./xPoeDebug.js";
+/* Графики отладки: кадр OK! DebPlot (SC_PLOT прошивки) — значения из CBOR-карты, график на группу, серии в порядке устройства */
+export { createPlotGroups, debPlotValues, DEB_PLOT_ARGUMENT } from "./plotGroups.js";
+/* System Console over UART: CBOR [SrcID, HdrArg, Value, FHS, CRC16], plus stream parsing */
+export { encodeXPoeDebugFrame, createXPoeDebugParser, xPoeDebugCmd, xPoeDebugValueFromText } from "./xPoeDebug.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/plotGroups.d.ts

@@ -1,11 +1,11 @@
+export declare const DEB_PLOT_ARGUMENT = "DebPlot";
 export interface PlotPoint {
     name: string;
     value: number;
 }
-export declare const createPlotGroups: ({ gapMs }?: {
-    gapMs?: number | undefined;
-}) => {
-    push(series: string, value: number, now?: number): string | null;
+export declare const debPlotValues: (value: string) => [string, number][];
+export declare const createPlotGroups: () => {
+    update(values: [string, number][]): string[];
     data(group: string): PlotPoint[];
     clear(): void;
 };

package/dist/protocols/plotGroups.js

@@ -1,34 +1,44 @@
-export const createPlotGroups = ({ gapMs = 50 } = {}) => {
+/* $lib/protocols/plotGroups.ts */
+/* Графики отладки: кадр xPOE-Debug OK! DebPlot (SC_PLOT прошивки), VALUE — hex 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) => {
+    try {
+        const decoded = cborToValue(xPoeDebugValueFromText(value));
+        const entries = decoded instanceof Map ? [...decoded] : decoded && typeof decoded === "object" ? Object.entries(decoded) : [];
+        return entries.filter((e) => typeof e[0] === "string" && typeof e[1] === "number" && Number.isFinite(e[1]));
+    }
+    catch {
+        return [];
+    }
+};
+export const createPlotGroups = () => {
     const groups = new Map();
     return {
-        /* Значение серии (now — время прихода, мс); возвращает группу или null, если значение не число */
-        push(series, value, now = Date.now()) {
-            if (!series || !Number.isFinite(value))
-                return null;
-            const dot = series.indexOf(".");
-            const group = dot > 0 ? series.slice(0, dot) : "";
-            const name = dot > 0 ? series.slice(dot + 1) : series;
-            let g = groups.get(group);
-            if (!g)
-                groups.set(group, (g = { values: new Map(), burst: [], last: now }));
-            if (now - g.last > gapMs || g.burst.includes(name)) {
-                const ordered = new Map();
-                for (const n of g.burst)
-                    ordered.set(n, g.values.get(n));
-                for (const [n, v] of g.values)
-                    if (!ordered.has(n))
-                        ordered.set(n, v);
-                g.values = ordered;
-                g.burst = [];
+        /* Значения одного кадра; возвращает группы, которые обновились */
+        update(values) {
+            const fresh = new Map();
+            for (const [series, value] of values) {
+                const dot = series.indexOf(".");
+                const group = dot > 0 ? series.slice(0, dot) : "";
+                if (!fresh.has(group))
+                    fresh.set(group, new Map());
+                fresh.get(group).set(dot > 0 ? series.slice(dot + 1) : series, value);
+            }
+            for (const [group, ordered] of fresh) {
+                for (const [name, value] of groups.get(group) ?? [])
+                    if (!ordered.has(name))
+                        ordered.set(name, value);
+                groups.set(group, ordered);
             }
-            g.last = now;
-            g.burst.push(name);
-            g.values.set(name, value);
-            return group;
+            return [...fresh.keys()];
         },
-        /* Последние значения серий группы в порядке устройства */
+        /* Последние значения серий группы */
         data(group) {
-            return Array.from(groups.get(group)?.values ?? [], ([name, value]) => ({ name, value }));
+            return Array.from(groups.get(group) ?? [], ([name, value]) => ({ name, value }));
         },
         clear() {
             groups.clear();

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;
@@ -12,15 +9,12 @@ export type XPoeDebugItem = {
     crc: string;
     crcOk: boolean;
     freeHeap: string;
-} | {
-    type: "plot";
-    name: string;
-    value: string;
 } | {
     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,62 +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. Между кадрами — текст: строки Teleplot «>Имя:Значение» (PLOT) и прочий вывод (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");
 };
-/* Строки текста вне кадров: Teleplot «>Имя:Значение» → plot, остальное → 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) => {
-    const colon = line.indexOf(":");
-    return line.startsWith(">") && colon > 1 ? { type: "plot", name: line.slice(1, colon), value: line.slice(colon + 1) } : { 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);
@@ -64,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/package.json

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