@gurezo/web-serial-rxjs 2.3.5 → 2.4.0

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

@@ -1,3 +1,5 @@
+import type { TerminalBufferOptions } from '../terminal/create-terminal-buffer';
+import { type LineBufferOptions } from './internal/line-buffer';
 /**
  * Options for creating a {@link SerialSession} via {@link createSerialSession}.
  *
@@ -76,11 +78,29 @@ export interface SerialSessionOptions {
      * @default `{ enabled: false, bufferSize: 512 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})
      */
     receiveReplay?: SerialSessionReceiveReplayOptions;
+    /**
+     * Limits for {@link SerialSession.terminalText$} display memory. Oldest
+     * completed lines and leading characters are dropped when exceeded.
+     *
+     * @default `{ maxLines: 10000, maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/370 | Issue #370}
+     */
+    terminalBuffer?: TerminalBufferOptions;
+    /**
+     * Limits for the incomplete line tail held by {@link SerialSession.lines$}
+     * framing. When exceeded, leading characters are discarded and a non-fatal
+     * {@link SerialErrorCode.LINE_BUFFER_OVERFLOW} is emitted on {@link SerialSession.errors$}.
+     *
+     * @default `{ maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}
+     */
+    lineBuffer?: LineBufferOptions;
 }
 /**
  * Options for {@link SerialSessionOptions.receiveReplay}.
  *
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/265 | Issue #265}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/372 | Issue #372}
  */
 export interface SerialSessionReceiveReplayOptions {
     /**
@@ -97,14 +117,35 @@ export interface SerialSessionReceiveReplayOptions {
      * @default 512
      */
     bufferSize?: number;
+    /**
+     * Maximum total characters retained across buffered replay chunks for the
+     * active connection. When exceeded, oldest chunks are discarded. `0` means
+     * unlimited (only `bufferSize` applies).
+     *
+     * @default 0
+     */
+    maxChars?: number;
 }
+/** Maximum allowed {@link SerialSessionReceiveReplayOptions.bufferSize}. */
+export declare const MAX_RECEIVE_REPLAY_BUFFER_SIZE = 65536;
+/** Maximum allowed {@link SerialSessionReceiveReplayOptions.maxChars}. */
+export declare const MAX_RECEIVE_REPLAY_MAX_CHARS = 1048576;
+/**
+ * Merge and validate {@link SerialSessionReceiveReplayOptions}.
+ *
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS}
+ *         when `bufferSize` or `maxChars` are out of range.
+ */
+export declare function resolveReceiveReplayOptions(options?: SerialSessionReceiveReplayOptions): Required<SerialSessionReceiveReplayOptions>;
 /**
  * Default values applied to omitted {@link SerialSessionOptions} fields.
  *
  * @internal
  */
-export declare const DEFAULT_SERIAL_SESSION_OPTIONS: Required<Omit<SerialSessionOptions, 'filters' | 'receiveReplay'>> & {
+export declare const DEFAULT_SERIAL_SESSION_OPTIONS: Required<Omit<SerialSessionOptions, 'filters' | 'receiveReplay' | 'terminalBuffer' | 'lineBuffer'>> & {
     filters?: SerialPortFilter[];
     receiveReplay: Required<SerialSessionReceiveReplayOptions>;
+    terminalBuffer: Required<TerminalBufferOptions>;
+    lineBuffer: Required<LineBufferOptions>;
 };
 //# sourceMappingURL=serial-session-options.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"serial-session-options.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,iCAAiC,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CACnD,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,eAAe,CAAC,CACxD,GAAG;IAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAAC,aAAa,EAAE,QAAQ,CAAC,iCAAiC,CAAC,CAAA;CAS7F,CAAC"}
+{"version":3,"file":"serial-session-options.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAIhF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAElC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAElD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4EAA4E;AAC5E,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,4BAA4B,UAAY,CAAC;AAQtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,iCAAiC,GAC1C,QAAQ,CAAC,iCAAiC,CAAC,CA+B7C;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CACnD,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,eAAe,GAAG,gBAAgB,GAAG,YAAY,CAAC,CAC1F,GAAG;IACF,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,EAAE,QAAQ,CAAC,iCAAiC,CAAC,CAAC;IAC3D,cAAc,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAChD,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CAYzC,CAAC"}

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

@@ -26,6 +26,7 @@ export declare const SerialSessionState: {
     readonly Disconnecting: "disconnecting";
     readonly Unsupported: "unsupported";
     readonly Error: "error";
+    readonly Disposed: "disposed";
 };
 /**
  * String union of allowed {@link SerialSessionState} runtime values

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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;CAQrB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC5B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

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

@@ -51,11 +51,37 @@ 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>;
+    /**
+     * Permanently tear down the session and complete all observables.
+     *
+     * 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.
      *
@@ -142,6 +168,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 +198,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>;
     /**

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,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;;;;;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;;;;;;;;;;;;;;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,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;CACpD"}

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

@@ -33,6 +33,7 @@ export declare class SessionStateMachine {
     toIdle(): boolean;
     toError(): boolean;
     toUnsupported(): boolean;
+    toDisposed(): boolean;
     complete(): void;
     private transition;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"session-state-machine.d.ts","sourceRoot":"","sources":["../../src/session/session-state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAoC5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,OAAO,GAAE,kBAA4C;IAIjE,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED,IAAI,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAE3C;IAED,YAAY,IAAI,OAAO;IAIvB,WAAW,IAAI,OAAO;IAItB,eAAe,IAAI,OAAO;IAI1B,MAAM,IAAI,OAAO;IAIjB,OAAO,IAAI,OAAO;IAIlB,aAAa,IAAI,OAAO;IAIxB,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,UAAU;CAoBnB"}
+{"version":3,"file":"session-state-machine.d.ts","sourceRoot":"","sources":["../../src/session/session-state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAE,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAsC5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,OAAO,GAAE,kBAA4C;IAIjE,IAAI,OAAO,IAAI,kBAAkB,CAEhC;IAED,IAAI,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAE3C;IAED,YAAY,IAAI,OAAO;IAIvB,WAAW,IAAI,OAAO;IAItB,eAAe,IAAI,OAAO;IAI1B,MAAM,IAAI,OAAO;IAIjB,OAAO,IAAI,OAAO;IAIlB,aAAa,IAAI,OAAO;IAIxB,UAAU,IAAI,OAAO;IAIrB,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,UAAU;CAoBnB"}

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

@@ -14,6 +14,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: number;
+    maxChars: number;
+}
+/** @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 +42,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;AAG/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,CAgBrB;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAEtE;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;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;AAgBJ;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAahB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurezo/web-serial-rxjs",
-  "version": "2.3.5",
+  "version": "2.4.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"
   },