@gurezo/web-serial-rxjs 3.0.0 → 3.1.0

package/README.ja.md

@@ -4,7 +4,7 @@
   <img src="https://raw.githubusercontent.com/gurezo/web-serial-rxjs/main/packages/web-serial-rxjs/web-serial-rxjs-icon.png" alt="web-serial-rxjs プロジェクトアイコン" width="512" />
 </p>
 
-Web Serial API を最小限の Session 指向 RxJS 表面でラップする TypeScript ライブラリです。v2 では単一の `SerialSession` を公開し、`state$` / `isConnected$` / `receive$` / `lines$` / `errors$` を購読するだけで UI を駆動できます。read loop や送信キューの自前実装は不要です。
+Web Serial API を最小限の Session 指向 RxJS 表面でラップする TypeScript ライブラリです。公開 API は単一の `SerialSession` を提供し、`state$`（canonical lifecycle state）/ `errors$`（error event channel）/ `receive$` / `lines$` を購読するだけで UI を駆動できます。read loop や送信キューの自前実装は不要です。
 
 ## ブラウザサポート
 
@@ -21,9 +21,13 @@ Web Serial API は**デスクトップ**ブラウザでのみサポートされ
 
 `connect$` の前の feature detection には `SerialSession.isBrowserSupported()`（同期的に `boolean`）を使います。
 
+## 接続状態（ライフサイクル UI）
+
+ライフサイクル UI には **`state$`** の `state.status` narrowing を canonical API として使用してください。boolean だけ必要な場合は `state$` から derive してください。`isConnected$` は v3.x では引き続き利用可能ですが **非推奨** です。詳細は [v3 移行ガイド](./docs/guide/ja/migration-v3.md#6-isconnected-の非推奨化) を参照してください。
+
 ## 接続中のポート情報（デバイス識別）
 
-`connect$` 成功後は `getPortInfo()` または `portInfo$` で `SerialPort.getInfo()` と同じスナップショット（例: 利用可能な場合の USB ベンダ/プロダクト ID）を取得できます。未接続時は `null` です。`getCurrentPort()` は接続中のみ内部の `SerialPort` を返します。`close()` は直接呼ばず、ライフサイクルは `disconnect$` に任せてください。
+`connect$` 成功後、`state$` を `state.status === SerialSessionStatus.Connected` で handling する場合は **`state.portInfo`** を canonical API として使用してください。`getPortInfo()` と `portInfo$` は v3.x では引き続き利用可能ですが **非推奨** です。`state$` の narrowing へ移行してください。`getCurrentPort()` は削除されました。詳細は [v3 移行ガイド](./docs/guide/ja/migration-v3.md#7-getcurrentport-の削除) を参照してください。
 
 ## 受信の replay（`receive$` と `receiveReplay$`）
 
@@ -31,7 +35,7 @@ Web Serial API は**デスクトップ**ブラウザでのみサポートされ
 
 ## `receive$` と `lines$`
 
-購読するストリームはユースケースに合わせて選んでください。**`lines$`** をターミナル表示に使うと `\r` が失われ再描画できず、シェル出力（例: `ls -la` の整形）が崩れます。詳細は [概要](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.ja.md) を参照してください。
+購読するストリームはユースケースに合わせて選んでください。**`lines$`** をターミナル表示に使うと `\r` が失われ再描画できず、シェル出力（例: `ls -la` の整形）が崩れます。詳細は [概要](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/overview.md) を参照してください。
 
 ### `receive$`（raw ストリーム）
 
@@ -83,18 +87,21 @@ pnpm add rxjs
 
 ## 次に読むもの
 
-- **v2 の全体像**（機能一覧、`SerialSession` 早見表、`SerialSessionState`、最小サンプル）: [SerialSession（v2）の概要](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.ja.md)（[English](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.md)）
-- 最短でポートを開く手順: [クイックスタート](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/QUICK_START.ja.md)
+- **API の全体像**（機能一覧、`SerialSession` 早見表、`SerialSessionState`、最小サンプル）: [SerialSession の概要](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/overview.md)（[English](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/overview.md)）
+- 最短でポートを開く手順: [クイックスタート](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/quick-start.md)
 
 ## ドキュメント
 
 | ドキュメント | 用途 |
 | --- | --- |
-| [全体像](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.ja.md) | 機能と v2 `SerialSession` / `SerialSessionState` の対応表 |
-| [クイックスタート](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/QUICK_START.ja.md) | ポートを開いて購読までを最短で |
-| [高度な使用方法](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/ADVANCED_USAGE.ja.md) | 行フレーミング、擬似リクエスト/レス、リカバリ |
-| [API リファレンス](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/API_REFERENCE.ja.md) | オプション、`SerialError`、型の詳細 |
-| [v1 → v2 マイグレーション](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/MIGRATION_V2.ja.md) | 廃止された v1 API の置き換え |
+| [日本語 Guide 索引](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/README.md) | Getting Started の読み順と一覧 |
+| [English Guide 索引](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/README.md) | Getting Started reading order and full index |
+| [全体像](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/overview.md) | 機能と `SerialSession` / `SerialSessionState` の対応表 |
+| [クイックスタート](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/quick-start.md) | ポートを開いて購読までを最短で |
+| [高度な使用方法](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/advanced-usage.md) | 行フレーミング、擬似リクエスト/レス、リカバリ |
+| [API の概念と設計メモ](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/concepts.md) | オプション、`SerialError`、型の表形式補足 |
+| [v2 → v3 マイグレーション](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/migration-v3.md) | `state$` discriminated union、`SerialSessionStatus`、`context.cause` |
+| [v1 → v2 マイグレーション](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/migration-v2.md) | 廃止された v1 API の置き換え |
 | **リポジトリ [README](https://github.com/gurezo/web-serial-rxjs/blob/main/README.ja.md)** | モノレポ構成、**`apps/` のサンプル**、貢献、MCP、プロジェクトアイコン |
 
 ## ライセンス

package/README.md

@@ -4,7 +4,7 @@
   <img src="https://raw.githubusercontent.com/gurezo/web-serial-rxjs/main/packages/web-serial-rxjs/web-serial-rxjs-icon.png" alt="@gurezo/web-serial-rxjs project icon" width="512" />
 </p>
 
-A TypeScript library that wraps the Web Serial API with a minimal, session-oriented RxJS surface. The v2 API exposes a single `SerialSession` so applications can drive their UI from `state$` + `isConnected$` + `receive$` + `lines$` + `errors$`, without rebuilding read loops or send queues themselves.
+A TypeScript library that wraps the Web Serial API with a minimal, session-oriented RxJS surface. The public API exposes a single `SerialSession` so applications can drive their UI from `state$` (canonical lifecycle state) + `errors$` (error event channel) + `receive$` + `lines$`, without rebuilding read loops or send queues themselves.
 
 ## Browser support
 
@@ -21,9 +21,13 @@ Supported desktop browsers:
 
 `SerialSession.isBrowserSupported()` returns a synchronous `boolean` for feature detection before `connect$`.
 
+## Connection state (lifecycle UI)
+
+Prefer **`state$`** with `state.status` narrowing as the canonical API for lifecycle UI. Derive a boolean from `state$` when you only need a connected flag. `isConnected$` remains available in v3.x but is **deprecated** — see [Migrating to v3](./docs/guide/en/migration-v3.md#6-isconnected-deprecation).
+
 ## Port info (device identification)
 
-After a successful `connect$`, use `getPortInfo()` or subscribe to `portInfo$` for the `SerialPort.getInfo()` snapshot (e.g. USB vendor/product IDs when the device exposes them). Both yield `null` when disconnected. `getCurrentPort()` returns the underlying `SerialPort` while connected; do not call `close()` on it—use `disconnect$` for lifecycle.
+After a successful `connect$`, use `state.portInfo` when handling `state$` with `state.status === SerialSessionStatus.Connected` — this is the canonical API. `getPortInfo()` and `portInfo$` remain available in v3.x but are **deprecated**; migrate to `state$` narrowing. `getCurrentPort()` has been removed; see [Migrating to v3 – getCurrentPort() removal](./docs/guide/en/migration-v3.md#7-getcurrentport-removal).
 
 ## Receive replay (`receive$` vs `receiveReplay$`)
 
@@ -31,7 +35,7 @@ After a successful `connect$`, use `getPortInfo()` or subscribe to `portInfo$` f
 
 ## `receive$` vs `lines$`
 
-Pick the stream that matches your use case. Using **`lines$`** for a terminal mirror drops `\r` and redraw behaviour, which breaks shells and tools that rely on carriage-return updates ([overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.md)).
+Pick the stream that matches your use case. Using **`lines$`** for a terminal mirror drops `\r` and redraw behaviour, which breaks shells and tools that rely on carriage-return updates ([overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/overview.md)).
 
 ### `receive$` (raw stream)
 
@@ -83,20 +87,25 @@ pnpm add rxjs
 
 ## Where to go next
 
-- Full **v2 API map** (features, `SerialSession` table, `SerialSessionState`, minimal example): [SerialSession (v2) overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.md) ([日本語](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.ja.md))
-- Shortest path to an open port: [Quick Start](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/QUICK_START.md)
-- Browse as one integrated site (TypeDoc): [web-serial-rxjs API Documentation](https://gurezo.github.io/web-serial-rxjs/)
+- Full **API map** (features, `SerialSession` table, `SerialSessionState`, minimal example): [SerialSession overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/overview.md) ([日本語](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/ja/overview.md))
+- Shortest path to an open port: [Quick Start](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/quick-start.md)
+- Browse the published documentation site: [web-serial-rxjs Documentation](https://gurezo.github.io/web-serial-rxjs/)
+- Browse API Reference (TypeDoc): [web-serial-rxjs API Documentation](https://gurezo.github.io/web-serial-rxjs/api/)
 
 ## Documentation
 
 | Doc | Use it for |
 | --- | --- |
-| [TypeDoc top page](https://gurezo.github.io/web-serial-rxjs/) | Start from OVERVIEW and move to guides/API in one site |
-| [Overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/OVERVIEW.md) | Features and the v2 `SerialSession` / `SerialSessionState` map |
-| [Quick Start](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/QUICK_START.md) | Open a port and wire subscriptions end-to-end |
-| [Advanced Usage](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/ADVANCED_USAGE.md) | Line framing, request/response-style flows, recovery |
-| [API Reference](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/API_REFERENCE.md) | `SerialSessionOptions`, `SerialError`, and formal details |
-| [v1 → v2 migration](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/MIGRATION_V2.md) | Replacing the removed v1 `SerialClient` / `ShellClient` API |
+| [Documentation home](https://gurezo.github.io/web-serial-rxjs/) | Site landing with Guide (ja/en) and API Reference |
+| [English Guide (site)](https://gurezo.github.io/web-serial-rxjs/guide/en/README.html) | Getting Started reading order on the published site |
+| [API Reference (site)](https://gurezo.github.io/web-serial-rxjs/api/index.html) | English TypeDoc API Reference |
+| [English Guide index](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/README.md) | Getting Started reading order and full index |
+| [Overview](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/overview.md) | Features and the `SerialSession` / `SerialSessionState` map |
+| [Quick Start](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/quick-start.md) | Open a port and wire subscriptions end-to-end |
+| [Advanced Usage](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/advanced-usage.md) | Line framing, request/response-style flows, recovery |
+| [API concepts and design notes](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/concepts.md) | `SerialSessionOptions`, `SerialError`, and formal details |
+| [v2 → v3 migration](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/migration-v3.md) | `state$` discriminated union, `SerialSessionStatus`, `context.cause` |
+| [v1 → v2 migration](https://github.com/gurezo/web-serial-rxjs/blob/main/packages/web-serial-rxjs/docs/guide/en/migration-v2.md) | Replacing the removed v1 `SerialClient` / `ShellClient` API |
 | [Repository README](https://github.com/gurezo/web-serial-rxjs/blob/main/README.md) | Monorepo layout, **examples** under `apps/`, contributing, MCP, and project icon |
 
 ## License

package/dist/errors/serial-error-code.d.ts

@@ -28,28 +28,32 @@ export declare const SerialErrorCode: {
     /**
      * Browser does not support the Web Serial API.
      *
-     * This error occurs when attempting to use serial port functionality in a browser
-     * that doesn't support the Web Serial API. Supported desktop browsers are Chrome,
-     * Edge, Opera, and Firefox 151+. Safari and mobile browsers are not supported.
+     * Emitted on `connect$` when `navigator.serial` is unavailable.
      *
      * **Suggested action**: Inform the user to use a supported browser.
+     *
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/438 | Issue #438}
      */
     readonly BROWSER_NOT_SUPPORTED: "BROWSER_NOT_SUPPORTED";
     /**
      * Serial port is not available.
      *
-     * This error occurs when a requested port cannot be accessed, such as when
-     * getting previously granted ports fails or when the port is already in use
-     * by another application.
+     * **Reserved — not emitted in v3.x.** The current implementation uses only
+     * `navigator.serial.requestPort`; there is no `getPorts` API path. Scheduled
+     * for removal in the next major version.
+     *
+     * **Suggested action**: Handle port acquisition failures with
+     * {@link SerialErrorCode.PORT_OPEN_FAILED} or
+     * {@link SerialErrorCode.OPERATION_CANCELLED} instead.
      *
-     * **Suggested action**: Check if the port is available or being used by another application.
+     * @deprecated Not emitted at runtime in v3.x. Will be removed in the next major version.
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/438 | Issue #438}
      */
     readonly PORT_NOT_AVAILABLE: "PORT_NOT_AVAILABLE";
     /**
      * Failed to open the serial port.
      *
-     * This error occurs when the port cannot be opened, typically due to incorrect
-     * connection parameters, hardware issues, or permission problems.
+     * Emitted on `connect$` when `port.open()` rejects.
      *
      * **Suggested action**: Verify connection parameters and check hardware connections.
      */
@@ -57,8 +61,8 @@ export declare const SerialErrorCode: {
     /**
      * Serial port is already open.
      *
-     * This error occurs when attempting to open a port that is already connected.
-     * Only one connection can be active at a time per SerialClient instance.
+     * Emitted on `connect$` when the session is not in `'idle'` or `'error'`
+     * (non-fatal; session state is unchanged).
      *
      * **Suggested action**: Disconnect the current port before connecting a new one.
      */
@@ -66,10 +70,10 @@ export declare const SerialErrorCode: {
     /**
      * Serial port is not open.
      *
-     * This error occurs when attempting to read from or write to a port that hasn't
-     * been opened yet. The port must be connected before performing I/O operations.
+     * Emitted when `send$` or `disconnect$` is called in an invalid session
+     * state (for example before `connect$` completes).
      *
-     * **Suggested action**: Call {@link SerialClient.connect} before reading or writing.
+     * **Suggested action**: Call {@link SerialSession.connect$} before sending data.
      */
     readonly PORT_NOT_OPEN: "PORT_NOT_OPEN";
     /**
@@ -122,8 +126,12 @@ export declare const SerialErrorCode: {
     /**
      * Operation timed out before completion.
      *
-     * This error occurs when an operation waits for a condition (for example, prompt
-     * detection) and the timeout period elapses first.
+     * **Reserved — not emitted in v3.x.** No timeout / prompt detection /
+     * transaction API exists yet. Scheduled for removal in the next major version
+     * unless a future API adopts this code.
+     *
+     * @deprecated Not emitted at runtime in v3.x. Will be removed in the next major version.
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/438 | Issue #438}
      */
     readonly OPERATION_TIMEOUT: "OPERATION_TIMEOUT";
     /**
@@ -202,10 +210,11 @@ export declare const SerialErrorCode: {
     /**
      * Unknown error occurred.
      *
-     * This error code is used for errors that don't fit into any other category.
-     * The original error details may be available in the error's message or originalError property.
+     * Emitted as a fallback when dispose or disconnect encounters an error that
+     * cannot be classified more specifically. The underlying failure is on
+     * {@link SerialError.context | context.cause}.
      *
-     * **Suggested action**: Check the error message and originalError for more details.
+     * **Suggested action**: Check the error message and `context.cause` for more details.
      */
     readonly UNKNOWN: "UNKNOWN";
 };

package/dist/errors/serial-error-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-error-code.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe;IAC1B;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;OAKG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;OAOG;;CAEK,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"serial-error-code.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,eAAe;IAC1B;;;;;;;;OAQG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH;;;;;;OAMG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;OAOG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;OAQG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;OAQG;;CAEK,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/dist/errors/serial-error-context.d.ts

@@ -5,12 +5,26 @@ import { SerialErrorCode } from './serial-error-code';
 export type SerialErrorCauseContext = {
     readonly cause: unknown;
 };
+/**
+ * Machine-readable constraint identifiers for factory-time validation errors.
+ */
+export type ValidationErrorConstraint = 'at-least-one-usb-id' | 'usb-id-0-65535' | 'positive-safe-integer' | 'receive-replay-buffer-size-range' | 'receive-replay-max-chars-range' | 'non-negative-safe-integer';
+/**
+ * Structured metadata for `INVALID_*` validation errors thrown at session
+ * factory time. {@link SerialError.message} remains human-readable.
+ */
+export type ValidationErrorContext = {
+    readonly field: string;
+    readonly value: unknown;
+    readonly constraint: ValidationErrorConstraint;
+    readonly filterIndex?: number;
+};
 /**
  * Maps each {@link SerialErrorCode} to its structured context shape.
  *
  * Codes mapped to `undefined` have no machine-readable metadata beyond
- * {@link SerialError.message}. Overflow codes expose configured limits so
- * callers do not need to parse error messages.
+ * {@link SerialError.message}. Overflow and validation codes expose structured
+ * metadata so callers do not need to parse error messages.
  */
 export interface SerialErrorContextMap {
     [SerialErrorCode.BROWSER_NOT_SUPPORTED]: undefined;
@@ -21,16 +35,16 @@ export interface SerialErrorContextMap {
     [SerialErrorCode.READ_FAILED]: SerialErrorCauseContext;
     [SerialErrorCode.WRITE_FAILED]: SerialErrorCauseContext;
     [SerialErrorCode.CONNECTION_LOST]: SerialErrorCauseContext;
-    [SerialErrorCode.INVALID_FILTER_OPTIONS]: undefined;
+    [SerialErrorCode.INVALID_FILTER_OPTIONS]: ValidationErrorContext;
     [SerialErrorCode.OPERATION_CANCELLED]: SerialErrorCauseContext;
     [SerialErrorCode.OPERATION_TIMEOUT]: undefined;
     [SerialErrorCode.LINE_BUFFER_OVERFLOW]: {
         readonly maxChars: number;
     };
-    [SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS]: undefined;
-    [SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS]: undefined;
-    [SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS]: undefined;
-    [SerialErrorCode.INVALID_CONNECTION_OPTIONS]: undefined;
+    [SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS]: ValidationErrorContext;
+    [SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS]: ValidationErrorContext;
+    [SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS]: ValidationErrorContext;
+    [SerialErrorCode.INVALID_CONNECTION_OPTIONS]: ValidationErrorContext;
     [SerialErrorCode.RECEIVE_REPLAY_BUFFER_OVERFLOW]: {
         readonly maxChars: number;
         readonly bufferSize: number;

package/dist/errors/serial-error-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-error-context.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,eAAe,CAAC,qBAAqB,CAAC,EAAE,SAAS,CAAC;IACnD,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC9D,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC5D,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC/C,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAC3C,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACxD,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC3D,CAAC,eAAe,CAAC,sBAAsB,CAAC,EAAE,SAAS,CAAC;IACpD,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC/D,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC/C,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE;QACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE,SAAS,CAAC;IAC5D,CAAC,eAAe,CAAC,+BAA+B,CAAC,EAAE,SAAS,CAAC;IAC7D,CAAC,eAAe,CAAC,2BAA2B,CAAC,EAAE,SAAS,CAAC;IACzD,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAAE,SAAS,CAAC;IACxD,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE;QAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC9C,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACpD;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,GACpB,IAAI,IAAI,MAAM;KACd,CAAC,IAAI,MAAM,qBAAqB,IAAI,qBAAqB,CAAC,CAAC,CAAC,SAAS,uBAAuB,GACzF,CAAC,GACD,KAAK,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACrC,CAEA"}
+{"version":3,"file":"serial-error-context.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,qBAAqB,GACrB,gBAAgB,GAChB,uBAAuB,GACvB,kCAAkC,GAClC,gCAAgC,GAChC,2BAA2B,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,eAAe,CAAC,qBAAqB,CAAC,EAAE,SAAS,CAAC;IACnD,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC9D,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC5D,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC/C,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAC3C,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACxD,CAAC,eAAe,CAAC,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC3D,CAAC,eAAe,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IACjE,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC/D,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC/C,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE;QACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE,sBAAsB,CAAC;IACzE,CAAC,eAAe,CAAC,+BAA+B,CAAC,EAAE,sBAAsB,CAAC;IAC1E,CAAC,eAAe,CAAC,2BAA2B,CAAC,EAAE,sBAAsB,CAAC;IACtE,CAAC,eAAe,CAAC,0BAA0B,CAAC,EAAE,sBAAsB,CAAC;IACrE,CAAC,eAAe,CAAC,8BAA8B,CAAC,EAAE;QAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC9C,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACpD;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,GACpB,IAAI,IAAI,MAAM;KACd,CAAC,IAAI,MAAM,qBAAqB,IAAI,qBAAqB,CAAC,CAAC,CAAC,SAAS,uBAAuB,GACzF,CAAC,GACD,KAAK,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACrC,CAEA"}

package/dist/errors/serial-error.d.ts

@@ -1,7 +1,7 @@
 import { SerialErrorCode } from './serial-error-code';
-import { type SerialErrorCauseContext, type SerialErrorContextMap } from './serial-error-context';
+import { type SerialErrorCauseContext, type SerialErrorContextMap, type ValidationErrorConstraint, type ValidationErrorContext } from './serial-error-context';
 export { SerialErrorCode };
-export type { SerialErrorCauseContext, SerialErrorContextMap };
+export type { SerialErrorCauseContext, SerialErrorContextMap, ValidationErrorConstraint, ValidationErrorContext, };
 /**
  * Custom error class for serial port operations.
  *
@@ -11,26 +11,21 @@ export type { SerialErrorCauseContext, SerialErrorContextMap };
  *
  * @example
  * ```typescript
- * try {
- *   await client.connect().toPromise();
- * } catch (error) {
- *   if (error instanceof SerialError) {
+ * session.errors$.subscribe((error) => {
+ *   if (error.is(SerialErrorCode.READ_FAILED)) {
  *     console.error(`Error code: ${error.code}`);
  *     console.error(`Message: ${error.message}`);
- *     if (error.originalError) {
- *       console.error(`Original error:`, error.originalError);
- *     }
+ *     console.error(`Cause:`, error.context.cause);
+ *   }
  *
- *     if (error.is(SerialErrorCode.LINE_BUFFER_OVERFLOW)) {
- *       console.error(`maxChars: ${error.context.maxChars}`);
- *     }
+ *   if (error.is(SerialErrorCode.LINE_BUFFER_OVERFLOW)) {
+ *     console.error(`maxChars: ${error.context.maxChars}`);
+ *   }
  *
- *     // Check specific error code
- *     if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {
- *       // Handle browser not supported
- *     }
+ *   if (error.is(SerialErrorCode.BROWSER_NOT_SUPPORTED)) {
+ *     // Handle browser not supported
  *   }
- * }
+ * });
  * ```
  */
 export declare class SerialError<TCode extends SerialErrorCode = SerialErrorCode> extends Error {
@@ -65,9 +60,13 @@ export declare class SerialError<TCode extends SerialErrorCode = SerialErrorCode
      *
      * @param code - The error code identifying the type of error
      * @param message - A human-readable error message
-     * @param originalError - The original error that caused this SerialError, if any
-     * @param context - Structured metadata for the error code. When omitted, cause-bearing
-     *   codes derive `{ cause }` from `originalError`.
+     * @param originalError - The original error that caused this SerialError, if any.
+     *   @deprecated Prefer passing `{ cause }` via {@link context}. When omitted,
+     *   cause-bearing codes derive `{ cause }` from this argument for backward
+     *   compatibility.
+     * @param context - Structured metadata for the error code. For cause-bearing
+     *   codes, pass `{ cause }` here. When omitted, cause-bearing codes derive
+     *   `{ cause }` from the legacy {@link originalError} argument.
      */
     constructor(code: TCode, message: string, originalError?: Error, context?: SerialErrorContextMap[TCode]);
     /**

package/dist/errors/serial-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-error.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;AAY/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW,CACtB,KAAK,SAAS,eAAe,GAAG,eAAe,CAC/C,SAAQ,KAAK;IACb;;;;;;OAMG;IACH,SAAgB,IAAI,EAAE,KAAK,CAAC;IAE5B;;;;;OAKG;IACH,SAAgB,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAEtD;;;;;;;;;OASG;IACH,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IAEtC;;;;;;;;OAQG;gBAED,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC;IA0BxC;;;;;;;;;;;;;;;;;;OAkBG;IACI,EAAE,CAAC,CAAC,SAAS,eAAe,EACjC,IAAI,EAAE,CAAC,GACN,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;CAG1B"}
+{"version":3,"file":"serial-error.d.ts","sourceRoot":"","sources":["../../src/errors/serial-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW,CACtB,KAAK,SAAS,eAAe,GAAG,eAAe,CAC/C,SAAQ,KAAK;IACb;;;;;;OAMG;IACH,SAAgB,IAAI,EAAE,KAAK,CAAC;IAE5B;;;;;OAKG;IACH,SAAgB,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAEtD;;;;;;;;;OASG;IACH,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IAEtC;;;;;;;;;;;;OAYG;gBAED,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC;IAgCxC;;;;;;;;;;;;;;;;;;OAkBG;IACI,EAAE,CAAC,CAAC,SAAS,eAAe,EACjC,IAAI,EAAE,CAAC,GACN,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;CAG1B"}

package/dist/index.d.ts

@@ -6,25 +6,30 @@
  * A TypeScript library that wraps the Web Serial API with a minimal,
  * RxJS-based session surface.
  *
- * ## Public API (v2)
+ * ## Public API
  *
- * The v2 public API intentionally exposes a single, session-oriented surface
- * so that apps (Angular, Vue, React, Svelte, vanilla JS/TS) can drive their
- * UI entirely from `state$` + `isConnected$` + `receive$` + `terminalText$` + `lines$` + `errors$` without rebuilding any
- * state, read loops, or write queues themselves.
+ * The public API exposes a single, session-oriented surface so that apps
+ * (Angular, Vue, React, Svelte, vanilla JS/TS) can drive their UI from
+ * `state$` (canonical lifecycle discriminated union) + `errors$` (error event
+ * channel) + `receive$` + `terminalText$` + `lines$` without rebuilding state,
+ * read loops, or write queues. Derive convenience booleans from `state$`
+ * narrowing; `isConnected$` is deprecated in v3.x.
  *
  * - {@link createSerialSession} - factory for a {@link SerialSession}
  * - {@link createTerminalBuffer} - terminal-style display text from {@link SerialSession.receive$}
  * - {@link TerminalBufferOptions} - memory limits for terminal display text
  * - {@link LineBufferOptions} - memory limits for lines$ incomplete line tail
  * - {@link SerialSession} - the runtime interface
- * - {@link SerialSessionOptions} - connection options
+ * - {@link SerialSessionOptions} - factory options (connection + features)
  * - {@link SerialPayload} - payload accepted by {@link SerialSession.send$}
  * - {@link SerialConnectionOptions} - `port.open` connection parameters (excluding filters)
+ * - {@link SerialSessionFeatureOptions} - library-specific session feature options
  * - {@link SerialSessionStatus} - lifecycle status literals for `state$.status`
  * - {@link SerialSessionState} - discriminated union emitted by `state$`
+ * - {@link isConnectedSessionState} - type predicate for connected `state$` narrowing in RxJS pipelines
  * - {@link SerialError} / {@link SerialErrorCode} - unified error surface
  * - {@link SerialErrorContextMap} - structured metadata per error code
+ * - {@link ValidationErrorContext} - machine-readable validation error metadata
  *
  * ## Browser Support
  *
@@ -45,16 +50,35 @@
  *
  * @example
  * ```typescript
- * import { createSerialSession } from '@gurezo/web-serial-rxjs';
+ * import { filter } from 'rxjs';
+ * import {
+ *   createSerialSession,
+ *   isConnectedSessionState,
+ *   SerialSessionStatus,
+ *   SerialErrorCode,
+ * } from '@gurezo/web-serial-rxjs';
  *
  * const session = createSerialSession({ baudRate: 115200 });
  *
  * if (!session.isBrowserSupported()) {
  *   console.error('Web Serial API is not supported in this browser');
  * } else {
- *   session.state$.subscribe((state) => console.log('state:', state));
+ *   session.state$.subscribe((state) => {
+ *     if (state.status === SerialSessionStatus.Connected) {
+ *       console.log('port:', state.portInfo);
+ *     }
+ *   });
+ *   session.state$
+ *     .pipe(filter(isConnectedSessionState))
+ *     .subscribe((state) => {
+ *       console.log('port:', state.portInfo);
+ *     });
  *   session.receive$.subscribe((chunk) => console.log('rx:', chunk));
- *   session.errors$.subscribe((error) => console.error('err:', error));
+ *   session.errors$.subscribe((error) => {
+ *     if (error.is(SerialErrorCode.READ_FAILED)) {
+ *       console.error(error.context.cause);
+ *     }
+ *   });
  *
  *   session.connect$().subscribe();
  *   session.send$('hello\r\n').subscribe();
@@ -62,10 +86,10 @@
  * ```
  */
 export { assertNever } from './internal/assert-never';
-export { createSerialSession, SerialSessionStatus, DEFAULT_LINE_BUFFER_OPTIONS, resolveSerialSessionOptions, MAX_RECEIVE_REPLAY_BUFFER_SIZE, MAX_RECEIVE_REPLAY_MAX_CHARS } from './session';
-export type { SerialSession, SerialSessionState, IdleSessionState, ConnectingSessionState, ConnectedSessionState, DisconnectingSessionState, UnsupportedSessionState, ErrorSessionState, DisposedSessionState, SerialSessionOptions, SerialSessionReceiveReplayOptions, ResolvedSerialSessionOptions, SerialPayload, SerialConnectionOptions, LineBufferOptions, } from './session';
+export { createSerialSession, SerialSessionStatus, isConnectedSessionState, DEFAULT_LINE_BUFFER_OPTIONS, resolveSerialSessionOptions, MAX_RECEIVE_REPLAY_BUFFER_SIZE, MAX_RECEIVE_REPLAY_MAX_CHARS } from './session';
+export type { SerialSession, SerialSessionState, IdleSessionState, ConnectingSessionState, ConnectedSessionState, DisconnectingSessionState, UnsupportedSessionState, ErrorSessionState, DisposedSessionState, SerialSessionOptions, SerialSessionFeatureOptions, SerialSessionReceiveReplayOptions, ResolvedSerialSessionOptions, SerialPayload, SerialConnectionOptions, LineBufferOptions, } from './session';
 export { SerialError } from './errors/serial-error';
-export type { SerialErrorCauseContext, SerialErrorContextMap } from './errors/serial-error';
+export type { SerialErrorCauseContext, SerialErrorContextMap, ValidationErrorConstraint, ValidationErrorContext, } from './errors/serial-error';
 export { SerialErrorCode } from './errors/serial-error-code';
 export { createTerminalBuffer, DEFAULT_TERMINAL_BUFFER_OPTIONS } from './terminal/create-terminal-buffer';
 export type { TerminalBuffer, TerminalBufferOptions } from './terminal/create-terminal-buffer';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AAC7L,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,aAAa,EACb,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAC1G,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC;AACtN,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,aAAa,EACb,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAC1G,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}