@gurezo/web-serial-rxjs 2.3.6 → 3.0.0

package/dist/session/serial-session-state.d.ts

@@ -1,11 +1,9 @@
+import type { SerialError } from '../errors/serial-error';
 /**
- * Reactive lifecycle state for a {@link SerialSession}.
+ * Canonical status literals for a {@link SerialSession} lifecycle.
  *
- * This is the v2 API counterpart of the legacy `SerialState` used by
- * `SerialClient`. The runtime values are the same flat strings v1
- * consumers used for UI switches; the {@link SerialSessionState} const
- * object is the canonical source of those literals so call sites can
- * avoid string typos and get IDE completion.
+ * Use these constants when comparing {@link SerialSessionState.status}
+ * so call sites avoid string typos and get IDE completion.
  *
  * Lifecycle transitions:
  *
@@ -14,22 +12,62 @@
  *                                \-> error
  * (any)  -> unsupported   (when Web Serial API is unavailable)
  * (any)  -> error         (when an unrecoverable failure occurs)
+ * (any)  -> disposed      (when dispose$ completes)
  * ```
  *
- * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}
- * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/406 | Issue #406}
  */
-export declare const SerialSessionState: {
+export declare const SerialSessionStatus: {
     readonly Idle: "idle";
     readonly Connecting: "connecting";
     readonly Connected: "connected";
     readonly Disconnecting: "disconnecting";
     readonly Unsupported: "unsupported";
     readonly Error: "error";
+    readonly Disposed: "disposed";
 };
 /**
- * String union of allowed {@link SerialSessionState} runtime values
- * (same set as the values on the {@link SerialSessionState} object).
+ * String union of allowed {@link SerialSessionStatus} runtime values
+ * (same set as the values on the {@link SerialSessionStatus} object).
  */
-export type SerialSessionState = (typeof SerialSessionState)[keyof typeof SerialSessionState];
+export type SerialSessionStatus = (typeof SerialSessionStatus)[keyof typeof SerialSessionStatus];
+/** @see {@link SerialSessionState} */
+export interface IdleSessionState {
+    readonly status: typeof SerialSessionStatus.Idle;
+}
+/** @see {@link SerialSessionState} */
+export interface ConnectingSessionState {
+    readonly status: typeof SerialSessionStatus.Connecting;
+}
+/** @see {@link SerialSessionState} */
+export interface ConnectedSessionState {
+    readonly status: typeof SerialSessionStatus.Connected;
+    readonly portInfo: SerialPortInfo;
+}
+/** @see {@link SerialSessionState} */
+export interface DisconnectingSessionState {
+    readonly status: typeof SerialSessionStatus.Disconnecting;
+}
+/** @see {@link SerialSessionState} */
+export interface UnsupportedSessionState {
+    readonly status: typeof SerialSessionStatus.Unsupported;
+}
+/** @see {@link SerialSessionState} */
+export interface ErrorSessionState {
+    readonly status: typeof SerialSessionStatus.Error;
+    readonly error: SerialError;
+}
+/** @see {@link SerialSessionState} */
+export interface DisposedSessionState {
+    readonly status: typeof SerialSessionStatus.Disposed;
+}
+/**
+ * Discriminated union emitted by {@link SerialSession.state$}.
+ *
+ * Each variant carries the lifecycle `status` plus optional detail fields
+ * (`portInfo` when connected, `error` when in a fatal error state).
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/406 | Issue #406}
+ */
+export type SerialSessionState = IdleSessionState | ConnectingSessionState | ConnectedSessionState | DisconnectingSessionState | UnsupportedSessionState | ErrorSessionState | DisposedSessionState;
 //# sourceMappingURL=serial-session-state.d.ts.map

package/dist/session/serial-session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-session-state.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"serial-session-state.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAEjE,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,IAAI,CAAC;CAClD;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,UAAU,CAAC;CACxD;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,sCAAsC;AACtC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,aAAa,CAAC;CAC3D;AAED,sCAAsC;AACtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,WAAW,CAAC;CACzD;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,KAAK,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,mBAAmB,CAAC,QAAQ,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,GACvB,iBAAiB,GACjB,oBAAoB,CAAC"}

package/dist/session/serial-session.d.ts

@@ -1,5 +1,6 @@
 import type { Observable } from 'rxjs';
 import type { SerialError } from '../errors/serial-error';
+import type { SerialPayload } from '../types';
 import type { SerialSessionState } from './serial-session-state';
 /**
  * v2 public API for interacting with the Web Serial API through a
@@ -51,20 +52,47 @@ export interface SerialSession {
     /**
      * Close the active serial port and stop the internal read pump.
      *
-     * Safe to call when already disconnected.
+     * Safe to call when already disconnected or while a disconnect is already
+     * in progress. When called during `'connecting'`, cancels the in-flight
+     * `connect$()` (closes any opened port) and returns the session to
+     * `'idle'` without reaching `'connected'`.
      *
      * @returns An Observable that completes when the port is fully closed.
      */
     disconnect$(): Observable<void>;
     /**
-     * Reactive session lifecycle state.
+     * Permanently tear down the session and complete all observables.
      *
-     * Replays the current state on subscribe. UIs should drive entirely from
-     * this stream instead of reconstructing their own BehaviorSubject.
+     * Unlike {@link disconnect$}, which returns the session to `'idle'` for
+     * reuse, `dispose$` closes any active connection, releases internal
+     * resources, emits `'disposed'` on {@link state$}, and completes every
+     * session stream. After disposal, {@link connect$} and {@link send$}
+     * fail with {@link SerialErrorCode.SESSION_DISPOSED}; create a new
+     * session instead of reusing this instance.
+     *
+     * Safe to call multiple times; subsequent calls complete immediately.
+     *
+     * @returns An Observable that completes when disposal has finished.
+     *
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/373 | Issue #373}
+     */
+    dispose$(): Observable<void>;
+    /**
+     * Alias for {@link dispose$}.
+     *
+     * @returns An Observable that completes when disposal has finished.
+     */
+    destroy$(): Observable<void>;
+    /**
+     * Reactive session lifecycle state as a discriminated union.
+     *
+     * Replays the current state on subscribe. Switch on `state.status` and
+     * use the per-variant fields (`portInfo`, `error`) instead of correlating
+     * separate streams.
      */
     readonly state$: Observable<SerialSessionState>;
     /**
-     * `true` when {@link state$} is `'connected'`, `false` for all other states.
+     * `true` when {@link state$} has `status: 'connected'`, `false` otherwise.
      *
      * Derived from `state$` with `distinctUntilChanged` so UIs can bind
      * connect/disabled flags without reimplementing the comparison.
@@ -72,8 +100,8 @@ export interface SerialSession {
     readonly isConnected$: Observable<boolean>;
     /**
      * The active port’s {@link SerialPort.getInfo} snapshot, or `null` when no
-     * port is open (including {@link SerialSessionState.Idle},
-     * {@link SerialSessionState.Error}, and {@link SerialSessionState.Unsupported}).
+     * port is open (including {@link SerialSessionStatus.Idle},
+     * {@link SerialSessionStatus.Error}, and {@link SerialSessionStatus.Unsupported}).
      *
      * Emits the current value on subscribe. Use with {@link state$} to know when
      * the value is valid for your UI.
@@ -142,6 +170,8 @@ export interface SerialSession {
      * This stream collapses carriage-return redraws (`\r`) and keeps normal
      * newline behavior (`\n`, `\r\n`) so apps can bind terminal-like output
      * directly without wrapping {@link createTerminalBuffer} in every consumer.
+     * By default, retains at most 10,000 completed lines and 1,048,576
+     * characters; configure via {@link SerialSessionOptions.terminalBuffer}.
      *
      * Equivalent behavior:
      *
@@ -170,11 +200,16 @@ export interface SerialSession {
      * rendering terminal text, prefer {@link terminalText$}.
      *
      * A trailing fragment without a line terminator is buffered until a later
-     * chunk completes a line, or discarded on disconnect. It is **not**
+     * chunk completes a line, or discarded on disconnect. The incomplete tail is
+     * bounded by {@link SerialSessionOptions.lineBuffer} `maxChars` (default
+     * 1,048,576); when exceeded, leading characters are discarded and a
+     * non-fatal {@link SerialErrorCode.LINE_BUFFER_OVERFLOW} is emitted on
+     * {@link errors$}. Pass `{ maxChars: 0 }` for unlimited growth. It is **not**
      * subscription-lazy: the same framing runs whenever the read pump is active,
      * independent of subscribers.
      *
      * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/273 | Issue #273}
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}
      */
     readonly lines$: Observable<string>;
     /**
@@ -200,6 +235,6 @@ export interface SerialSession {
      *
      * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/203 | Issue #203}
      */
-    send$(data: string | Uint8Array): Observable<void>;
+    send$(data: SerialPayload): Observable<void>;
 }
 //# sourceMappingURL=serial-session.d.ts.map

package/dist/session/serial-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CACpD"}
+{"version":3,"file":"serial-session.d.ts","sourceRoot":"","sources":["../../src/session/serial-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;;;;OASG;IACH,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhC;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,cAAc,IAAI,UAAU,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE5C;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/session/session-runtime.d.ts

@@ -0,0 +1,140 @@
+import { Observable } from 'rxjs';
+import type { SerialError } from '../errors/serial-error';
+import type { ReadPump } from './read-pump';
+import { SerialSessionStatus, type SerialSessionState, type SerialSessionStatus as SerialSessionStatusType } from './serial-session-state';
+/**
+ * Discriminated union representing the full internal runtime state of a
+ * {@link SerialSession}, including lifecycle status and any resources that
+ * are valid for that status.
+ *
+ * This is the single source of truth for session lifecycle + resources.
+ * Public consumers observe the mapped {@link SerialSessionState} via
+ * `state$`; this union is internal only.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/397 | Issue #397}
+ */
+export type SessionRuntime = IdleRuntime | ConnectingRuntime | ConnectedRuntime | DisconnectingRuntime | ErrorRuntime | UnsupportedRuntime | DisposedRuntime;
+/** @internal */
+export interface IdleRuntime {
+    readonly status: typeof SerialSessionStatus.Idle;
+}
+/** @internal */
+export interface ConnectingRuntime {
+    readonly status: typeof SerialSessionStatus.Connecting;
+    readonly cancel: () => void;
+}
+/** @internal */
+export interface ConnectedRuntime {
+    readonly status: typeof SerialSessionStatus.Connected;
+    readonly port: SerialPort;
+    readonly pump: ReadPump;
+}
+/** @internal */
+export interface DisconnectingRuntime {
+    readonly status: typeof SerialSessionStatus.Disconnecting;
+    readonly port: SerialPort | null;
+}
+/** @internal */
+export interface ErrorRuntime {
+    readonly status: typeof SerialSessionStatus.Error;
+    readonly error: SerialError;
+}
+/** @internal */
+export interface UnsupportedRuntime {
+    readonly status: typeof SerialSessionStatus.Unsupported;
+}
+/** @internal */
+export interface DisposedRuntime {
+    readonly status: typeof SerialSessionStatus.Disposed;
+}
+/**
+ * Allowed transitions for the internal SerialSession state machine.
+ *
+ * `as const satisfies` keeps literal transition targets while ensuring every
+ * {@link SerialSessionStatus} key is present. Drift from the status union
+ * becomes a compile error.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/398 | Issue #398}
+ */
+export declare const ALLOWED_TRANSITIONS: {
+    readonly idle: readonly ["connecting", "error", "disposed"];
+    readonly connecting: readonly ["connected", "error", "idle", "disposed"];
+    readonly connected: readonly ["disconnecting", "error", "disposed"];
+    readonly disconnecting: readonly ["idle", "error", "disposed"];
+    readonly error: readonly ["idle", "connecting", "disposed"];
+    readonly unsupported: readonly ["disposed"];
+    readonly disposed: readonly [];
+};
+/**
+ * Valid target states when transitioning from {@link T}.
+ *
+ * @internal
+ */
+export type AllowedTransition<T extends SerialSessionStatusType> = (typeof ALLOWED_TRANSITIONS)[T][number];
+/** @internal */
+export declare function runtimeToSessionStatus(runtime: SessionRuntime): SerialSessionStatusType;
+/**
+ * Map internal runtime to the public {@link SerialSessionState} payload.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/406 | Issue #406}
+ */
+export declare function runtimeToPublicState(runtime: SessionRuntime): SerialSessionState;
+/** @internal */
+export declare function isValidTransition(from: SerialSessionStatusType, to: SerialSessionStatusType): boolean;
+/** @internal */
+export declare function createIdleRuntime(): IdleRuntime;
+/** @internal */
+export declare function createConnectingRuntime(cancel: () => void): ConnectingRuntime;
+/** @internal */
+export declare function createConnectedRuntime(port: SerialPort, pump: ReadPump): ConnectedRuntime;
+/** @internal */
+export declare function createDisconnectingRuntime(port: SerialPort | null): DisconnectingRuntime;
+/** @internal */
+export declare function createErrorRuntime(error: SerialError): ErrorRuntime;
+/** @internal */
+export declare function createUnsupportedRuntime(): UnsupportedRuntime;
+/** @internal */
+export declare function createDisposedRuntime(): DisposedRuntime;
+/** @internal */
+export declare function createInitialRuntime(supported: boolean): SessionRuntime;
+/**
+ * Extract the active port from runtime when one is held.
+ *
+ * @internal
+ */
+export declare function getRuntimePort(runtime: SessionRuntime): SerialPort | null;
+/**
+ * Extract the active pump from runtime when one is held.
+ *
+ * @internal
+ */
+export declare function getRuntimePump(runtime: SessionRuntime): ReadPump | null;
+/**
+ * Controller that owns the {@link SessionRuntime} discriminated union and
+ * exposes the public `state$` stream derived from the runtime.
+ *
+ * @internal
+ */
+export interface SessionRuntimeController {
+    get runtime(): SessionRuntime;
+    get status(): SerialSessionStatusType;
+    get state$(): Observable<SerialSessionState>;
+    transition(next: SessionRuntime): boolean;
+    complete(): void;
+}
+/**
+ * Create a controller for the internal session runtime.
+ *
+ * @internal
+ */
+export declare function createSessionRuntimeController(initial: SessionRuntime): SessionRuntimeController;
+/**
+ * Exhaustiveness helper for switch statements over {@link SessionRuntime}.
+ *
+ * @internal
+ */
+export declare function assertNeverRuntime(value: never): never;
+//# sourceMappingURL=session-runtime.d.ts.map

package/dist/session/session-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../src/session/session-runtime.ts"],"names":[],"mappings":"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"}

package/dist/terminal/create-terminal-buffer.d.ts

@@ -1,4 +1,5 @@
 import { type Observable } from 'rxjs';
+import { type MaxChars, type MaxLines } from '../internal/branded-numbers';
 /** @internal Folded state between {@link createTerminalBuffer} emissions. */
 export interface TerminalBufferState {
     completed: string;
@@ -14,6 +15,27 @@ export interface TerminalBufferState {
 export declare function applyTerminalChunk(state: TerminalBufferState, chunk: string): TerminalBufferState;
 /** @internal */
 export declare function terminalDisplayText(state: TerminalBufferState): string;
+/** Resolved limits for {@link trimTerminalState}. `0` means unlimited. */
+export interface TerminalBufferLimits {
+    maxLines: MaxLines;
+    maxChars: MaxChars;
+}
+/** @internal Count newline-terminated rows in `completed`. */
+export declare function countCompletedLines(completed: string): number;
+/**
+ * Drops oldest completed lines when `maxLines` is exceeded.
+ *
+ * @internal Exported for unit tests.
+ */
+export declare function trimCompletedByMaxLines(completed: string, maxLines: number): string;
+/**
+ * Trims {@link TerminalBufferState} to respect memory limits. Oldest
+ * `completed` content is removed first; `currentLine` is trimmed only when
+ * the display text still exceeds `maxChars` after `completed` is empty.
+ *
+ * @internal Exported for unit tests.
+ */
+export declare function trimTerminalState(state: TerminalBufferState, limits: TerminalBufferLimits): TerminalBufferState;
 export interface TerminalBuffer {
     /**
      * Cumulative text suitable for terminal-style display: completed lines plus
@@ -21,10 +43,35 @@ export interface TerminalBuffer {
      */
     readonly text$: Observable<string>;
 }
+/** Options for {@link createTerminalBuffer} memory limits. `0` means unlimited. */
+export interface TerminalBufferOptions {
+    /**
+     * Maximum number of completed lines to retain in the display buffer.
+     *
+     * @default 10000
+     */
+    maxLines?: number;
+    /**
+     * Maximum total characters in the cumulative display text
+     * (`completed` + `currentLine`). Oldest content is dropped first.
+     *
+     * @default 1048576
+     */
+    maxChars?: number;
+}
+/** Default limits applied when options are omitted. */
+export declare const DEFAULT_TERMINAL_BUFFER_OPTIONS: Required<TerminalBufferOptions>;
 /**
  * Builds a terminal-oriented text stream from {@link SerialSession.receive$} (or any
  * `Observable<string>` of decoded chunks). Uses internal buffering so callers need not
  * implement carriage-return collapse themselves.
+ *
+ * By default, retains at most {@link DEFAULT_TERMINAL_BUFFER_OPTIONS.maxLines}
+ * completed lines and {@link DEFAULT_TERMINAL_BUFFER_OPTIONS.maxChars} characters
+ * so long-running sessions do not grow memory without bound. Pass `0` for either
+ * limit to disable that constraint.
+ *
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/370 | Issue #370}
  */
-export declare function createTerminalBuffer(receive$: Observable<string>): TerminalBuffer;
+export declare function createTerminalBuffer(receive$: Observable<string>, options?: TerminalBufferOptions): TerminalBuffer;
 //# sourceMappingURL=create-terminal-buffer.d.ts.map

package/dist/terminal/create-terminal-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-terminal-buffer.d.ts","sourceRoot":"","sources":["../../src/terminal/create-terminal-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAA0B,MAAM,MAAM,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAwBrB;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEtE;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CACpC;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,GAC3B,cAAc,CAWhB"}
+{"version":3,"file":"create-terminal-buffer.d.ts","sourceRoot":"","sources":["../../src/terminal/create-terminal-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAA0B,MAAM,MAAM,CAAC;AAC/D,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,6BAA6B,CAAC;AAGrC,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAgBrB;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEtE;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW7D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,CAuBrB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,qBAAqB,CAIzE,CAAC;AAkBJ;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAahB"}

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Payload accepted by {@link SerialSession.send$}.
+ *
+ * Strings are UTF-8 encoded via a shared `TextEncoder`; `Uint8Array` values
+ * are passed through unchanged.
+ */
+export type SerialPayload = string | Uint8Array;
+/**
+ * Connection parameters passed to `port.open` when opening a serial port.
+ *
+ * Derived from the W3C {@link SerialOptions} type. Excludes
+ * {@link SerialSessionOptions.filters}, which apply only to
+ * `navigator.serial.requestPort`.
+ *
+ * @see {@link SerialOptions}
+ */
+export type SerialConnectionOptions = Pick<SerialOptions, 'baudRate' | 'dataBits' | 'stopBits' | 'parity' | 'bufferSize' | 'flowControl'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,aAAa,EACb,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAC/E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurezo/web-serial-rxjs",
-  "version": "2.3.6",
+  "version": "3.0.0",
   "description": "RxJS-based utilities for the Web Serial API, usable from Angular, React, Svelte, and Vanilla JavaScript/TypeScript.",
   "author": "Akihiko Kigure <akihiko.kigure@gmail.com>",
   "license": "MIT",
@@ -26,6 +26,7 @@
     "build:bundle": "node esbuild.config.mjs",
     "build:copy-files": "cp ../../LICENSE . 2>/dev/null || true",
     "build:cleanup": "rm -rf dist/packages dist/package.json 2>/dev/null || true",
+    "verify:dist": "node scripts/verify-dist.mjs",
     "clean": "rm -rf dist",
     "prepublishOnly": "pnpm run build"
   },