poe-svelte-ui-lib 1.62.0 → 1.64.0

package/README.md

@@ -59,7 +59,7 @@ 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` с CRC и разбор потоков POESerial/CAN/RS485 — своих копий протоколов в приложениях не держим.
+**Ядро протоколов** — `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`. Байты совпадают с `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 `crc8RohcUtf8` по правилу прошивки (`crc8_rohc` в `common.c`). Дальше сюда переезжает разбор CAN/RS485 — своих копий протоколов в приложениях не держим.
 
 **Шапка смарт-виджета** (`WidgetHeader`): значок, заголовок и сворачивание слева, «?» в правом краю; правая часть (режимы, «Обновить» и т. п.) стоит в той же строке, а если не помещается — уходит второй строкой под заголовок и там переносится.
 

package/dist/protocols/cbor/decoder.d.ts

@@ -2,6 +2,7 @@ import { type CborValue } from "./types.js";
 export declare class CborDecoder {
     private state;
     constructor(buffer: ArrayBuffer | Uint8Array);
+    get offset(): number;
     decode(): CborValue;
     skipValue(): boolean;
     decodeBytes(): {

package/dist/protocols/cbor/decoder.js

@@ -12,6 +12,10 @@ export class CborDecoder {
             depth: 0,
         };
     }
+    /* Сколько байт уже прочитано — граница значения при разборе потока по одному значению */
+    get offset() {
+        return this.state.offset;
+    }
     /* Основной метод декодирования - декодирует одно значение CBOR */
     decode() {
         this.state.depth++;
@@ -180,14 +184,15 @@ export class CborDecoder {
                 return -1 - Number(header.value);
             case CborMajorType.ByteString: {
                 const bytesValue = header.value === BigInt(-1) ? this.readIndefiniteBytes() : this.decodeBytesWithLength(Number(header.value));
+                /* Не хватило байт — конец данных (в потоке это «ждать ещё»), а не испорченный CBOR */
                 if (!bytesValue)
-                    throw new CborError("Failed to decode byte string");
+                    throw new CborEndOfDataError();
                 return bytesValue.value;
             }
             case CborMajorType.Utf8String: {
                 const stringValue = header.value === BigInt(-1) ? this.readIndefiniteString() : this.decodeStringWithLength(Number(header.value));
                 if (!stringValue)
-                    throw new CborError("Failed to decode string");
+                    throw new CborEndOfDataError();
                 return stringValue.value;
             }
             case CborMajorType.Array:

package/dist/protocols/crc.d.ts

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

package/dist/protocols/crc.js

@@ -0,0 +1,44 @@
+/* $lib/protocols/crc.ts */
+/* Контрольные суммы протоколов устройств — побайтные, как в прошивках (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) {
+        crc ^= byte & 0xff;
+        for (let bit = 0; bit < 8; bit++)
+            crc = crc & 1 ? (crc >>> 1) ^ 0x8408 : crc >>> 1;
+    }
+    return crc & 0xffff;
+};
+/* CRC-8/ROHC: poly 0x07 reflected (0xE0), init 0xFF, xorout 0x00, check("123456789") = 0xD0 — рамка POESerial (system_console) */
+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;
+};
+/* Байт для CRC от позиции pos по правилу прошивки (common.c, utf8_seq_byte): целая UTF-8-последовательность даёт младший байт
+   своего code point, иначе байт как есть — так прошивка считает CRC и по тексту с эмодзи, и по сырому CBOR */
+const utf8SeqByte = (bytes, pos) => {
+    const first = bytes[pos];
+    const cont = (offset) => (bytes[pos + offset] & 0xc0) === 0x80;
+    if ((first & 0x80) === 0)
+        return { data: first, length: 1 };
+    if ((first & 0xe0) === 0xc0 && pos + 1 < bytes.length && cont(1))
+        return { data: (((first & 0x1f) << 6) | (bytes[pos + 1] & 0x3f)) & 0xff, length: 2 };
+    if ((first & 0xf0) === 0xe0 && pos + 2 < bytes.length && cont(1) && cont(2))
+        return { data: (((first & 0x0f) << 12) | ((bytes[pos + 1] & 0x3f) << 6) | (bytes[pos + 2] & 0x3f)) & 0xff, length: 3 };
+    if ((first & 0xf8) === 0xf0 && pos + 3 < bytes.length && cont(1) && cont(2) && cont(3))
+        return { data: (((bytes[pos + 1] & 0x3f) << 12) | ((bytes[pos + 2] & 0x3f) << 6) | (bytes[pos + 3] & 0x3f)) & 0xff, length: 4 };
+    return { data: first, length: 1 };
+};
+/* CRC-8/ROHC по правилу прошивки для UTF-8 (crc8_rohc в common.c) — рамка POESerial: HEADER, ARGUMENT, VALUE */
+export const crc8RohcUtf8 = (crc, bytes) => {
+    for (let pos = 0; pos < bytes.length;) {
+        const { data, length } = utf8SeqByte(bytes, pos);
+        crc = crc8Rohc(crc, [data]);
+        pos += length;
+    }
+    return crc;
+};

package/dist/protocols/index.d.ts

@@ -4,3 +4,6 @@ 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, crc8RohcUtf8 } from "./crc.js";
+export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, type PacketObject, type DecodedPacketObject, type PacketParse, } from "./packet.js";
+export { encodePoeSerialFrame, createPoeSerialParser, type PoeSerialItem } from "./poeSerial.js";

package/dist/protocols/index.js

@@ -9,3 +9,8 @@ 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) */
+export { crc16Kermit, crc8Rohc, crc8RohcUtf8 } from "./crc.js";
+export { BROADCAST_BUS_ID, makeHaCode, splitHaCode, packetObjectCrc, encodePacket, decodePacket, objectsFor, } from "./packet.js";
+/* Рамка POESerial (UART-консоль system_console): сборка команды и потоковый разбор кадров, строк Teleplot и текста */
+export { encodePoeSerialFrame, createPoeSerialParser } from "./poeSerial.js";

package/dist/protocols/packet.d.ts

@@ -0,0 +1,31 @@
+export declare const BROADCAST_BUS_ID = 65535;
+export interface PacketObject {
+    trgBusID: number;
+    retBusID: number;
+    haCode: number;
+    payload: Uint8Array;
+}
+export interface DecodedPacketObject extends PacketObject {
+    header: number;
+    argument: number;
+    crc: number;
+    crcOk: boolean;
+}
+export declare const makeHaCode: (header: number, argument: number) => number;
+export declare const splitHaCode: (haCode: number) => {
+    header: number;
+    argument: number;
+};
+export declare const packetObjectCrc: (trgBusID: number, retBusID: number, haCode: number, payload: Uint8Array) => number;
+export declare const encodePacket: (objects: PacketObject[]) => Uint8Array;
+export type PacketParse = {
+    status: "complete";
+    length: number;
+    objects: DecodedPacketObject[];
+} | {
+    status: "incomplete";
+} | {
+    status: "garbage";
+};
+export declare const decodePacket: (bytes: Uint8Array) => PacketParse;
+export declare const objectsFor: (objects: DecodedPacketObject[], busID: number) => DecodedPacketObject[];

package/dist/protocols/packet.js

@@ -0,0 +1,105 @@
+/* $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) и облака */
+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);
+    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.encodeUnsigned(trgBusID);
+        encoder.encodeArrayStart(4);
+        encoder.encodeUnsigned(retBusID);
+        encoder.encodeUnsigned(haCode);
+        encoder.encodeBytes(payload);
+        encoder.encodeUnsigned(packetObjectCrc(trgBusID, retBusID, haCode, payload));
+    }
+    encoder.encodeBreak();
+    return encoder.getResult();
+};
+/* Одно CBOR-значение с позиции offset: значение и сколько байт заняло; null — данных не хватает */
+const readValue = (bytes, offset) => {
+    const decoder = new CborDecoder(bytes.subarray(offset));
+    try {
+        const value = decoder.decode();
+        return { value, length: decoder.offset };
+    }
+    catch (error) {
+        if (error instanceof CborEndOfDataError)
+            return null;
+        throw error;
+    }
+};
+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)
+        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)
+        return null;
+    return { trgBusID, retBusID, haCode, payload, crc, crcOk: packetObjectCrc(trgBusID, retBusID, haCode, payload) === crc, ...splitHaCode(haCode) };
+};
+/* Разбор пакета с начала буфера — и для целого кадра (CAN), и для потока (RS485: «incomplete» — ждать ещё байт, «garbage» — сдвинуться на байт) */
+export const decodePacket = (bytes) => {
+    if (bytes.length === 0)
+        return { status: "incomplete" };
+    const first = bytes[0];
+    if (first >> 5 !== 5)
+        return { status: "garbage" };
+    /* Число записей: indefinite (0xBF, до BREAK) или definite — прямо в байте либо в следующих 1/2 байтах */
+    let offset = 1;
+    let count = null;
+    const info = first & 0x1f;
+    if (info < 24)
+        count = info;
+    else if (info === 24 || info === 25) {
+        const size = info === 24 ? 1 : 2;
+        if (bytes.length < 1 + size)
+            return { status: "incomplete" };
+        count = size === 1 ? bytes[1] : (bytes[1] << 8) | bytes[2];
+        offset += size;
+    }
+    else if (info !== 31)
+        return { status: "garbage" };
+    const objects = [];
+    try {
+        for (let index = 0; count === null || index < count; index++) {
+            if (offset >= bytes.length)
+                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);
+            if (!value)
+                return { status: "incomplete" };
+            offset += key.length + value.length;
+            const object = toObject(key.value, value.value);
+            if (object)
+                objects.push(object);
+        }
+    }
+    catch {
+        return { status: "garbage" };
+    }
+    return { status: "complete", length: offset, objects };
+};
+/* Объекты пакета для своего адреса (и broadcast) с верным CRC — как CBOR_PktDecGet прошивки, только все, а не первый */
+export const objectsFor = (objects, busID) => objects.filter((object) => object.crcOk && (object.trgBusID === busID || object.trgBusID === BROADCAST_BUS_ID));

package/dist/protocols/poeSerial.d.ts

@@ -0,0 +1,27 @@
+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 PoeSerialItem = {
+    type: "frame";
+    header: string;
+    argument: string;
+    value: string;
+    valueBytes: Uint8Array;
+    crc: string;
+    crcOk: boolean;
+    freeHeap: string;
+} | {
+    type: "plot";
+    name: string;
+    value: string;
+} | {
+    type: "raw";
+    text: string;
+};
+export declare const encodePoeSerialFrame: (header: string, argument: string, value: Uint8Array) => Uint8Array;
+export declare const createPoeSerialParser: () => {
+    push(chunk: Uint8Array): PoeSerialItem[];
+    reset(): void;
+};

package/dist/protocols/poeSerial.js

@@ -0,0 +1,112 @@
+/* $lib/protocols/poeSerial.ts */
+/* Рамка POESerial (system_console прошивки): [SOH] HEADER [US] ARGUMENT [STX] VALUE [ETX] CRC8 [US] FHS [EOT] \n — CRC8 двумя hex-символами
+   по HEADER+ARGUMENT+VALUE (crc8RohcUtf8), FHS (свободная куча) только у кадров устройства. Устройство шлёт VALUE текстом (лог или hex-дамп CBOR),
+   устройству VALUE уходит сырыми байтами CBOR. Между кадрами — текст: строки Teleplot «>Имя:Значение» (PLOT) и прочий вывод (RAW) */
+import { crc8RohcUtf8 } from "./crc.js";
+export const SOH = 0x01;
+export const STX = 0x02;
+export const ETX = 0x03;
+export const EOT = 0x04;
+export const US = 0x1f;
+const LF = 0x0a;
+/* Предел текста без конца строки и незавершённого кадра — дальше отдаётся/сбрасывается, чтобы буфер не рос бесконечно */
+const MAX_TEXT_TAIL = 4096;
+const MAX_FRAME = 8192;
+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) => {
+    const headerBytes = encoder.encode(header);
+    const argumentBytes = encoder.encode(argument);
+    const crc = crc8RohcUtf8(crc8RohcUtf8(crc8RohcUtf8(0xff, headerBytes), argumentBytes), value);
+    return new Uint8Array([SOH, ...headerBytes, US, ...argumentBytes, STX, ...value, ETX, ...encoder.encode(hex2(crc)), EOT]);
+};
+/* Строки текста вне кадров: 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 = crc8RohcUtf8(crc8RohcUtf8(crc8RohcUtf8(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,
+    };
+};
+const concat = (a, b) => {
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a);
+    out.set(b, a.length);
+    return out;
+};
+/* Потоковый разбор: push(байты из порта) → готовые кадры и строки; незавершённое ждёт следующего чанка */
+export const createPoeSerialParser = () => {
+    let buffer = new Uint8Array();
+    return {
+        push(chunk) {
+            buffer = concat(buffer, chunk);
+            const items = [];
+            for (;;) {
+                const soh = buffer.indexOf(SOH);
+                if (soh < 0)
+                    break;
+                /* Текст перед кадром не теряем; обрывок прошлого кадра (до последнего EOT) отбрасываем */
+                if (soh > 0) {
+                    const prefix = buffer.subarray(0, soh);
+                    items.push(...textItems(prefix.subarray(prefix.lastIndexOf(EOT) + 1)));
+                    buffer = buffer.slice(soh);
+                    continue;
+                }
+                const eot = buffer.indexOf(EOT);
+                if (eot < 0) {
+                    /* Кадр без конца слишком длинный — потерян EOT: пропускаем его SOH и ищем следующий кадр, иначе ждём ещё байт */
+                    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));
+                }
+            }
+            return items;
+        },
+        /* Сброс при переподключении порта */
+        reset() {
+            buffer = new Uint8Array();
+        },
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-svelte-ui-lib",
-  "version": "1.62.0",
+  "version": "1.64.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Oleg-Perevyshin/ElementsUI.git"
@@ -15,7 +15,8 @@
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "CheckUpdate": "npx npm-check-updates -u && npm install",
     "UpdateIconsLib": "tsx src/lib/IconsCatalog/iconsLib.ts",
-    "Formatting": "prettier --write ."
+    "Formatting": "prettier --write .",
+    "TestProtocols": "svelte-package && node --test tests/*.test.mjs"
   },
   "svelte": "./dist/index.js",
   "types": "./dist/index.d.ts",