poe-svelte-ui-lib 1.68.0 → 1.70.0

package/README.md

@@ -59,7 +59,9 @@ npm install poe-svelte-ui-lib
 
 **Названия смарт-виджетов** — в словаре библиотеки на всех языках (WiFi, «Об устройстве», «Файловая система», «Стек и задачи», «RGB лента», «Пилотажный дисплей», «Карта»); пустой `label.name` показывает название на языке пользователя, `widgetTitle(type)` отдаёт его сразу на всех языках `{ ru, en, zh }` — так конструктор заполняет заголовок нового виджета.
 
-**Ядро протоколов** — `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` `{ TrgBusID : [RetBusID, HA_Code, Payload, CRC16] }` (CAN, RS485): `encodePacket`/`decodePacket` (разбор с начала буфера — `complete` с длиной, `incomplete` для потока или `garbage`; объекты с одинаковым `TrgBusID` не склеиваются, неверный CRC — флаг `crcOk`), `objectsFor` (свой адрес и broadcast `0xFFFF`), `makeHaCode`/`splitHaCode`, `packetObjectCrc`; контрольные суммы `crc16Kermit` и `crc8Rohc` — строго побайтные, как в `common.c` прошивок. Байты совпадают с `poe_cbor_pkt.c` прошивки — проверка `npm run TestProtocols` (`tests/protocols.test.mjs`, эталонные пакеты собраны прошивочным кодом). Рамка POESerial (UART-консоль `system_console`, `[SOH] HDR [US] ARG [STX] VAL [ETX] CRC8 [US] FHS [EOT]`): `encodePoeSerialFrame` — команда устройству, `createPoeSerialParser().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 команды POESerial из ввода — `poeSerialValueFromText` (hex как есть, JSON → CBOR). Словарь протокола — `HEADER_CODES`, `DEFAULT_ARGUMENT_CODES` (генерируется из мастер-словаря `src/lib/protocols/dictionary.yaml` — `npm run Dictionary`, перед упаковкой автоматически; сам файл поставляется как `poe-svelte-ui-lib/protocols/dictionary.yaml`, `.framework/Dictionary.yaml` прошивок — его справочные копии, сборка прошивок сверяет с ними `api_ha.h`), `parseArgumentDictionary` (строки `- [Строка, Enum, Число]`), `nameByCode`. Своих копий протоколов и словаря в приложениях не держим: терминал и отладка облака читают и пишут порт сырыми байтами, разбор и сборка — здесь.
+**Битовые поля конфигурации** — `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). Словарь протокола — `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/Graph/Graph.svelte

@@ -389,11 +389,12 @@
     <h5 class={`w-full px-4 text-center ${label.class}`}>{label.name}</h5>
   {/if}
 
-  <div class="flex w-full flex-row gap-4">
-    <!-- График -->
+  <div class="flex w-full min-w-0 flex-row gap-4">
+    <!-- График: холст абсолютно поверх контейнера — его пиксельная ширина не распирает контейнер, иначе в сетке/flex с 1fr ширина растёт по кругу (ResizeObserver) -->
     <!-- design-handoff, раздел 9: рамка --hairline-color без тени, тултип в оформлении общего Tooltip.svelte -->
-    <div bind:this={container} class="relative h-64 grow overflow-hidden rounded-[14px] border border-(--hairline-color)">
-      <canvas class="h-full w-full bg-(--back-color)" bind:this={canvas} onmousemove={handleMouseMove} onmouseleave={handleMouseLeave}></canvas>
+    <div bind:this={container} class="relative h-64 min-w-0 grow overflow-hidden rounded-[14px] border border-(--hairline-color)">
+      <canvas class="absolute inset-0 h-full w-full bg-(--back-color)" bind:this={canvas} onmousemove={handleMouseMove} onmouseleave={handleMouseLeave}
+      ></canvas>
 
       {#if tooltip.visible}
         <div

package/dist/Graph/README.md

@@ -23,6 +23,8 @@
 
 ### Адаптивность
 
+- Холст лежит поверх контейнера (`absolute`), контейнер может сжиматься (`min-w-0`) — в сетке или flex с колонкой `1fr` график не распирает колонку своей пиксельной шириной и не растёт по кругу при каждом пересчёте размера
+
 - График автоматически масштабируется под размер контейнера
 
 ### Ограничения

package/dist/Input/README.md

@@ -150,6 +150,7 @@
 - Поддерживает выбор типа поля: текст, пароль, число, многострочный текст, битовая маска
 - Включает библиотеку готовых регулярных выражений для валидации (модальное окно с выбором шаблона)
 - Для типа `bitMode` позволяет задать диапазон битов слайдером; `number.maxNum` рассчитывается автоматически
+- Значение поля в `bitMode` вызывающий код берёт и записывает через `bitFieldGet`/`bitFieldSet` (`poe-svelte-ui-lib`) — корректно для любых бит 0..31, включая старший.
 - Поддерживает валидацию вводимых данных через регулярные выражения
 
 ### Что настраивается

package/dist/Select/README.md

@@ -54,7 +54,7 @@
 | `options`        | `IOption<T>[]`                                | `[]`                  | Массив доступных опций                                                                                                                                                  |
 | `onUpdate`       | `(value: IOption<T> \| IOption<T>[]) => void` | `undefined`           | Обработчик изменения значения                                                                                                                                           |
 
-> **`bitMode`/`range`**: эти поля объявлены в типе `ISelectProps` и настраиваются в конструкторской панели (`SelectProps.svelte`), но сам `Select.svelte` их не читает и не использует — они не оказывают никакого эффекта на голый `<UI.Select>`. Если нужен битовый выбор в реальном рантайме, интерпретируйте маску на стороне вызывающего кода и передавайте уже готовый `value`/`options`.
+> **`bitMode`/`range`**: эти поля объявлены в типе `ISelectProps` и настраиваются в конструкторской панели (`SelectProps.svelte`), но сам `Select.svelte` их не читает и не использует — они не оказывают никакого эффекта на голый `<UI.Select>`. Если нужен битовый выбор в реальном рантайме, интерпретируйте маску на стороне вызывающего кода и передавайте уже готовый `value`/`options`. Разбор и сборка поля `range.start..range.end` 32-битного слова — `bitFieldGet(word, start, end)`/`bitFieldSet(word, start, end, value)` из `poe-svelte-ui-lib` (обычная арифметика вместо знаковых 32-битных операций JS: бит 31 и поля любой ширины без отрицательных чисел, слово на входе может быть и отрицательным — то же 32-битное представление); так делают `GUIPreview` DevCloud и WebApp.
 
 ### Вложенные типы
 

package/dist/Table/README.md

@@ -28,6 +28,8 @@
 
 - Таблица автоматически адаптируется под размеры контейнера
 - Размер текста строк задаётся CSS-переменной `--table-font-size` на любом родителе (по умолчанию `13px`), например `style="--table-font-size: 11.5px"` — так потребитель меняет масштаб данных без правки компонента
+- Ширина колонки в символах моноширинного текста — `tableMonoWidth(знаков, знаковПодписи?)`: растёт вместе с `--table-font-size` и не бывает уже подписи шапки, например `width: tableMonoWidth(6, 2)` для `0x0000`
+- Окно полного значения (`modal`) переносит длинные строки (hex пакета, base64) и сохраняет отступы форматирования — содержимое видно целиком, без горизонтальной прокрутки
 
 ### Ограничения
 

package/dist/Table/Table.svelte

@@ -528,7 +528,8 @@
 
 <Modal isOpen={modalData.isOpen} title={$T("constructor.props.table.fulldata")} wrapperClass="max-h-[80%]" width="{0.8 * (container?.offsetWidth ?? 0)}px">
   {#snippet main()}
-    <div class="text-left whitespace-pre">
+    <!-- Длинные строки (hex пакета, base64, длинные значения) переносятся, отступы форматирования сохраняются — содержимое видно целиком -->
+    <div class="text-left whitespace-pre-wrap [overflow-wrap:anywhere]">
       {@html modalData.formattedData}
     </div>
   {/snippet}

package/dist/Table/columnWidth.d.ts

@@ -0,0 +1 @@
+export declare const tableMonoWidth: (chars: number, labelChars?: number) => string;

package/dist/Table/columnWidth.js

@@ -0,0 +1,4 @@
+/* $lib/Table/columnWidth.ts */
+/* Ширина колонки моноширинного текста таблицы в символах: растёт вместе с --table-font-size (знак моноширинного шрифта — 0.6–0.62em, берётся 0.64 с запасом),
+   не уже подписи шапки (11px, заглавные, ~0.5rem на знак); 1.5rem — внутренние отступы ячейки, 1px — разделитель колонок */
+export const tableMonoWidth = (chars, labelChars = 0) => `max(calc(var(--table-font-size, 13px) * ${+(chars * 0.64).toFixed(2)} + 1.5rem + 1px), calc(${labelChars * 0.5}rem + 1.5rem + 1px))`;

package/dist/bitField.d.ts

@@ -0,0 +1,2 @@
+export declare const bitFieldGet: (word: number, start: number, end: number) => number;
+export declare const bitFieldSet: (word: number, start: number, end: number, value: number) => number;

package/dist/bitField.js

@@ -0,0 +1,11 @@
+/* $lib/bitField.ts */
+/* Битовое поле [start..end] 32-битного слова конфигурации (Select/Input с bitMode): обычная арифметика вместо знаковых 32-битных операций JS —
+   бит 31 и поля любой ширины разбираются и собираются без отрицательных значений; слово на входе может прийти и отрицательным (то же 32-битное представление) */
+const span = (start, end) => 2 ** (end - start + 1);
+export const bitFieldGet = (word, start, end) => Math.floor((word >>> 0) / 2 ** start) % span(start, end);
+export const bitFieldSet = (word, start, end, value) => {
+    const w = word >>> 0;
+    const size = span(start, end);
+    const field = ((Math.trunc(value) % size) + size) % size;
+    return w - bitFieldGet(w, start, end) * 2 ** start + field * 2 ** start;
+};

package/dist/index.d.ts

@@ -28,6 +28,8 @@ export { default as Switch } from "./Switch/Switch.svelte";
 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 { bitFieldGet, bitFieldSet } from "./bitField";
 export { default as Tabs } from "./Tabs/Tabs.svelte";
 export { default as TabsProps } from "./Tabs/TabsProps.svelte";
 export { default as TextField } from "./TextField/TextField.svelte";

package/dist/index.js

@@ -29,6 +29,8 @@ export { default as Switch } from "./Switch/Switch.svelte";
 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 { bitFieldGet, bitFieldSet } from "./bitField";
 export { default as Tabs } from "./Tabs/Tabs.svelte";
 export { default as TabsProps } from "./Tabs/TabsProps.svelte";
 export { default as TextField } from "./TextField/TextField.svelte";

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 — рамка POESerial (system_console): HEADER, ARGUMENT, VALUE */
+/* CRC-8/ROHC: poly 0x07 reflected (0xE0), init 0xFF, xorout 0x00, check("123456789") = 0xD0 — рамка xPOE-Debug (system_console): HEADER, ARGUMENT, VALUE */
 export const crc8Rohc = (crc, bytes) => {
     for (const byte of bytes) {
         crc ^= byte & 0xff;

package/dist/protocols/dictionary.js

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

package/dist/protocols/dictionary.yaml

@@ -1,4 +1,4 @@
-# Словарь аргументов протокола HA_Code — единый для всех устройств, обоих фреймворков и приложений
+# Словарь аргументов протокола (поле arg в Cmd, 0..8191) — единый для всех устройств, обоих фреймворков и приложений
 # Строковое представление аргумента | Название в перечислении | Числовой код
 # Источник — poe-svelte-ui-lib (src/lib/protocols/dictionary.yaml); .framework/Dictionary.yaml фреймворков — копии, не править
 

package/dist/protocols/index.d.ts

@@ -5,7 +5,7 @@ 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, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
-export { encodePoeSerialFrame, createPoeSerialParser, poeSerialValueFromText, type PoeSerialItem } from "./poeSerial.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 { encodeXPoeDebugFrame, createXPoeDebugParser, 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

@@ -9,12 +9,12 @@ 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 : [RetBusID, HA_Code, Payload, CRC16] } (CAN, RS485) */
+/* Контрольные суммы и пакет poe_cbor_pkt [[TrgBusID, SrcBusID, Cmd, Payload, CRC16], …] (CAN, RS485) */
 export { crc16Kermit, crc8Rohc } from "./crc.js";
-export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, } from "./packet.js";
-/* Рамка POESerial (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
-export { encodePoeSerialFrame, createPoeSerialParser, poeSerialValueFromText } from "./poeSerial.js";
+export { BROADCAST_BUS_ID, makeCmd, splitCmd, EXTERNAL_BUS_ID, packetObjectCrc, encodePacket, decodePacket, objectsFor, createPacketStreamParser, } from "./packet.js";
+/* Рамка xPOE-Debug (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
+export { encodeXPoeDebugFrame, createXPoeDebugParser, 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";
-/* Словарь заголовков и аргументов HA_Code — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */
+/* Словарь заголовков и аргументов Cmd — по умолчанию из мастер-словаря dictionary.yaml библиотеки, разбор файла словаря */
 export { HEADER_CODES, DEFAULT_ARGUMENT_CODES, parseArgumentDictionary, nameByCode } from "./dictionary.js";

package/dist/protocols/packet.d.ts

@@ -1,22 +1,25 @@
 export declare const BROADCAST_BUS_ID = 65535;
+export declare const EXTERNAL_BUS_ID = 0;
 export interface PacketObject {
     trgBusID: number;
-    retBusID: number;
-    haCode: number;
+    srcBusID: number;
+    cmd: number;
     payload: Uint8Array;
 }
 export interface DecodedPacketObject extends PacketObject {
     header: number;
     argument: number;
+    reply: boolean;
     crc: number;
     crcOk: boolean;
 }
-export declare const makeHaCode: (header: number, argument: number) => number;
-export declare const splitHaCode: (haCode: number) => {
+export declare const makeCmd: (header: number, argument: number, reply?: boolean) => number;
+export declare const splitCmd: (cmd: number) => {
     header: number;
     argument: number;
+    reply: boolean;
 };
-export declare const packetObjectCrc: (trgBusID: number, retBusID: number, haCode: number, payload: Uint8Array) => number;
+export declare const packetObjectCrc: (trgBusID: number, srcBusID: number, cmd: number, payload: Uint8Array) => number;
 export declare const encodePacket: (objects: PacketObject[]) => Uint8Array;
 export type PacketParse = {
     status: "complete";

package/dist/protocols/packet.js

@@ -1,32 +1,38 @@
 /* $lib/protocols/packet.ts */
-/* Пакет poe_cbor_pkt (README poe_cbor прошивки, ProdFactory-ESP/STM): indefinite MAP { TrgBusID : [RetBusID, HA_Code, Payload, CRC16] },
-   объектов в пакете сколько угодно (в том числе с одинаковым TrgBusID), у каждого свой CRC-16/KERMIT по TrgBusID|RetBusID|HA_Code (по 2 байта
-   big-endian) и Payload — не зависит от того, как числа записаны в CBOR. Общая точка сборки и разбора для терминала (CAN, RS485) и облака */
+/* Пакет poe_cbor_pkt (README poe_cbor прошивки, ProdFactory-ESP/STM): indefinite ARRAY объектов [[TrgBusID, SrcBusID, Cmd, Payload, CRC16], …],
+   объектов в пакете сколько угодно (в том числе одному адресату), порядок сохраняется; у каждого свой CRC-16/KERMIT по TrgBusID|SrcBusID|Cmd
+   (по 2 байта big-endian) и Payload — не зависит от того, как числа записаны в CBOR. Общая точка сборки и разбора для терминала (CAN, RS485) и облака */
 import { CborDecoder } from "./cbor/decoder.js";
 import { CborEncoder } from "./cbor/encoder.js";
 import { CborEndOfDataError } from "./cbor/types.js";
 import { crc16Kermit } from "./crc.js";
-/* Адрес «всем устройствам шины» */
+/* Адрес «всем устройствам шины» — только адресат */
 export const BROADCAST_BUS_ID = 0xffff;
-/* HA_Code = заголовок (0..3) в старших 2 битах и аргумент (0..0x3FFF) */
-export const makeHaCode = (header, argument) => ((header & 0x03) << 14) | (argument & 0x3fff);
-export const splitHaCode = (haCode) => ({ header: (haCode >> 14) & 0x03, argument: haCode & 0x3fff });
-/* CRC объекта: TrgBusID | RetBusID | HA_Code по 2 байта big-endian, затем Payload */
-export const packetObjectCrc = (trgBusID, retBusID, haCode, payload) => {
-    const head = [trgBusID >> 8, trgBusID, retBusID >> 8, retBusID, haCode >> 8, haCode].map((byte) => byte & 0xff);
+/* Адрес внешнего клиента (терминал, отладка облака) — у модулей такого адреса не бывает */
+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,
+});
+/* CRC объекта: TrgBusID | SrcBusID | Cmd по 2 байта big-endian, затем Payload */
+export const packetObjectCrc = (trgBusID, srcBusID, cmd, payload) => {
+    const head = [trgBusID >> 8, trgBusID, srcBusID >> 8, srcBusID, cmd >> 8, cmd].map((byte) => byte & 0xff);
     return crc16Kermit(crc16Kermit(0, head), payload);
 };
 /* Пакет из одного или нескольких объектов — те же байты, что CBOR_PACK/CBOR_PktEncFinish прошивки */
 export const encodePacket = (objects) => {
     const encoder = new CborEncoder();
-    encoder.encodeMapStart(null);
-    for (const { trgBusID, retBusID, haCode, payload } of objects) {
+    encoder.encodeArrayStart(null);
+    for (const { trgBusID, srcBusID, cmd, payload } of objects) {
+        encoder.encodeArrayStart(5);
         encoder.encodeUnsigned(trgBusID);
-        encoder.encodeArrayStart(4);
-        encoder.encodeUnsigned(retBusID);
-        encoder.encodeUnsigned(haCode);
+        encoder.encodeUnsigned(srcBusID);
+        encoder.encodeUnsigned(cmd);
         encoder.encodeBytes(payload);
-        encoder.encodeUnsigned(packetObjectCrc(trgBusID, retBusID, haCode, payload));
+        encoder.encodeUnsigned(packetObjectCrc(trgBusID, srcBusID, cmd, payload));
     }
     encoder.encodeBreak();
     return encoder.getResult();
@@ -45,24 +51,23 @@ const readValue = (bytes, offset) => {
     }
 };
 const toNumber = (value) => (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 0xffff ? value : null);
-/* Объект пакета из пары ключ/значение; не по формату (не 4 элемента, не те типы, старый формат без CRC) — null, как CBOR_PktDecGet его пропускает */
-const toObject = (key, value) => {
-    const trgBusID = toNumber(key);
-    if (trgBusID === null || !Array.isArray(value) || value.length !== 4)
+/* Объект пакета; не по формату (не 5 элементов, не те типы) — null, как CBOR_PktDecNext прошивки его пропускает */
+const toObject = (value) => {
+    if (!Array.isArray(value) || value.length !== 5)
         return null;
-    const [retBusID, haCode, payload, crc] = [toNumber(value[0]), toNumber(value[1]), value[2], toNumber(value[3])];
-    if (retBusID === null || haCode === null || !(payload instanceof Uint8Array) || crc === null)
+    const [trgBusID, srcBusID, cmd, payload, crc] = [toNumber(value[0]), toNumber(value[1]), toNumber(value[2]), value[3], toNumber(value[4])];
+    if (trgBusID === null || srcBusID === null || cmd === null || !(payload instanceof Uint8Array) || crc === null)
         return null;
-    return { trgBusID, retBusID, haCode, payload, crc, crcOk: packetObjectCrc(trgBusID, retBusID, haCode, payload) === crc, ...splitHaCode(haCode) };
+    return { trgBusID, srcBusID, cmd, payload, crc, crcOk: packetObjectCrc(trgBusID, srcBusID, cmd, payload) === crc, ...splitCmd(cmd) };
 };
 /* Разбор пакета с начала буфера — и для целого кадра (CAN), и для потока (RS485: «incomplete» — ждать ещё байт, «garbage» — сдвинуться на байт) */
 export const decodePacket = (bytes) => {
     if (bytes.length === 0)
         return { status: "incomplete" };
     const first = bytes[0];
-    if (first >> 5 !== 5)
+    if (first >> 5 !== 4)
         return { status: "garbage" };
-    /* Число записей: indefinite (0xBF, до BREAK) или definite — прямо в байте либо в следующих 1/2 байтах */
+    /* Число объектов: indefinite (0x9F, до BREAK) или definite — прямо в байте либо в следующих 1/2 байтах */
     let offset = 1;
     let count = null;
     const info = first & 0x1f;
@@ -84,14 +89,11 @@ export const decodePacket = (bytes) => {
                 return { status: "incomplete" };
             if (count === null && bytes[offset] === 0xff)
                 return { status: "complete", length: offset + 1, objects };
-            const key = readValue(bytes, offset);
-            if (!key)
-                return { status: "incomplete" };
-            const value = readValue(bytes, offset + key.length);
+            const value = readValue(bytes, offset);
             if (!value)
                 return { status: "incomplete" };
-            offset += key.length + value.length;
-            const object = toObject(key.value, value.value);
+            offset += value.length;
+            const object = toObject(value.value);
             if (object)
                 objects.push(object);
         }
@@ -101,7 +103,7 @@ export const decodePacket = (bytes) => {
     }
     return { status: "complete", length: offset, objects };
 };
-/* Объекты пакета для своего адреса (и broadcast) с верным CRC — как CBOR_PktDecGet прошивки, только все, а не первый */
+/* Объекты пакета для своего адреса (и broadcast) с верным CRC, по порядку — как CBOR_PktDecNext прошивки */
 export const objectsFor = (objects, busID) => objects.filter((object) => object.crcOk && (object.trgBusID === busID || object.trgBusID === BROADCAST_BUS_ID));
 /* Потоковый разбор пакетов из сырого потока (RS485): пауза дольше gapMs обрывает недособранный пакет, мусор сдвигается по байту,
    без единого целого пакета буфер не растёт дальше maxBytes */

package/dist/protocols/{poeSerial.d.ts → xPoeDebug.d.ts}

@@ -3,7 +3,7 @@ export declare const STX = 2;
 export declare const ETX = 3;
 export declare const EOT = 4;
 export declare const US = 31;
-export type PoeSerialItem = {
+export type XPoeDebugItem = {
     type: "frame";
     header: string;
     argument: string;
@@ -20,9 +20,9 @@ export type PoeSerialItem = {
     type: "raw";
     text: string;
 };
-export declare const encodePoeSerialFrame: (header: string, argument: string, value: Uint8Array) => Uint8Array;
-export declare const createPoeSerialParser: () => {
-    push(chunk: Uint8Array): PoeSerialItem[];
+export declare const encodeXPoeDebugFrame: (header: string, argument: string, value: Uint8Array) => Uint8Array;
+export declare const createXPoeDebugParser: () => {
+    push(chunk: Uint8Array): XPoeDebugItem[];
     reset(): void;
 };
-export declare const poeSerialValueFromText: (text: string | undefined) => Uint8Array;
+export declare const xPoeDebugValueFromText: (text: string | undefined) => Uint8Array;

package/dist/protocols/{poeSerial.js → xPoeDebug.js}

@@ -1,5 +1,5 @@
-/* $lib/protocols/poeSerial.ts */
-/* Рамка POESerial (system_console прошивки): [SOH] HEADER [US] ARGUMENT [STX] VALUE [ETX] CRC8 [US] FHS [EOT] \n — CRC8 двумя hex-символами
+/* $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";
@@ -17,7 +17,7 @@ const encoder = new TextEncoder();
 const decoder = new TextDecoder();
 const hex2 = (value) => value.toString(16).toUpperCase().padStart(2, "0");
 /* Кадр команды устройству — те же байты, что разбирает system_console (VALUE — сырой CBOR, FHS не передаётся) */
-export const encodePoeSerialFrame = (header, argument, value) => {
+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);
@@ -65,7 +65,7 @@ const concat = (a, b) => {
     return out;
 };
 /* Потоковый разбор: push(байты из порта) → готовые кадры и строки; незавершённое ждёт следующего чанка */
-export const createPoeSerialParser = () => {
+export const createXPoeDebugParser = () => {
     let buffer = new Uint8Array();
     return {
         push(chunk) {
@@ -113,7 +113,7 @@ export const createPoeSerialParser = () => {
 };
 /* Поле Value команды из ввода пользователя: пусто — без тела, hex-строка (с пробелами или без) — готовые байты как есть, иначе JSON → CBOR
    (двоичные данные — base64, ключи с BIN — байты, см. jsonToCbor); не hex и не JSON — ошибка */
-export const poeSerialValueFromText = (text) => {
+export const xPoeDebugValueFromText = (text) => {
     const trimmed = (text ?? "").trim();
     if (!trimmed)
         return new Uint8Array();

package/package.json

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