@gurezo/web-serial-rxjs 3.1.0 → 4.0.0

package/dist/internal/branded-numbers.d.ts

@@ -4,15 +4,10 @@ export type BaudRate = number & {
     readonly [baudRateBrand]: true;
 };
 declare const serialPortBufferSizeBrand: unique symbol;
-/** Validated W3C {@link SerialOptions} `bufferSize`. */
+/** Validated W3C {@link SerialOptions} `bufferSize` (safe integer > 0). */
 export type SerialPortBufferSize = number & {
     readonly [serialPortBufferSizeBrand]: true;
 };
-declare const receiveReplayBufferSizeBrand: unique symbol;
-/** Validated receive replay chunk count limit. */
-export type ReceiveReplayBufferSize = number & {
-    readonly [receiveReplayBufferSizeBrand]: true;
-};
 declare const maxCharsBrand: unique symbol;
 /** Validated character limit for buffers (`0` means unlimited). */
 export type MaxChars = number & {
@@ -27,8 +22,6 @@ export type MaxLines = number & {
 export declare function brandBaudRate(value: number): BaudRate;
 /** @internal Brand a validated serial port buffer size. */
 export declare function brandSerialPortBufferSize(value: number): SerialPortBufferSize;
-/** @internal Brand a validated receive replay buffer size. */
-export declare function brandReceiveReplayBufferSize(value: number): ReceiveReplayBufferSize;
 /** @internal Brand a validated max character limit. */
 export declare function brandMaxChars(value: number): MaxChars;
 /** @internal Brand a validated max line limit. */

package/dist/internal/branded-numbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branded-numbers.d.ts","sourceRoot":"","sources":["../../src/internal/branded-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,yBAAyB,EAAE,OAAO,MAAM,CAAC;AACvD,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAC1C,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC;CAC5C,CAAC;AAEF,OAAO,CAAC,MAAM,4BAA4B,EAAE,OAAO,MAAM,CAAC;AAC1D,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG;IAC7C,QAAQ,CAAC,CAAC,4BAA4B,CAAC,EAAE,IAAI,CAAC;CAC/C,CAAC;AAEF,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAE7E;AAED,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GACZ,uBAAuB,CAEzB;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD"}
+{"version":3,"file":"branded-numbers.d.ts","sourceRoot":"","sources":["../../src/internal/branded-numbers.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,0DAA0D;AAC1D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,yBAAyB,EAAE,OAAO,MAAM,CAAC;AACvD,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAC1C,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC;CAC5C,CAAC;AAEF,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,OAAO,CAAC,MAAM,aAAa,EAAE,OAAO,MAAM,CAAC;AAC3C,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEnE,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAE7E;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAErD"}

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

@@ -12,7 +12,6 @@ import { type SerialSessionOptions } from './serial-session-options';
  *
  * Key behaviors:
  *
- * - `isBrowserSupported()` returns whether `navigator.serial` is available.
  * - `state$` replays the current lifecycle state driven by the internal
  *   {@link SessionRuntime} controller.
  * - `connect$()` opens a user-selected port, starts the internal read pump,
@@ -36,9 +35,12 @@ import { type SerialSessionOptions } from './serial-session-options';
  *   do not mutate `state$` because a real connection loss will be
  *   observed by the read pump on the next tick anyway.
  *
- * @param options - Session options. Only `filters` is consulted by
- *   `connect$` today (forwarded to `navigator.serial.requestPort`); the
- *   remaining fields are passed to `port.open` using defaults when omitted.
+ * @param options - Session options. W3C connection fields (`baudRate`,
+ *   `dataBits`, …) are passed to `port.open`. `filters` is forwarded to
+ *   `navigator.serial.requestPort`. `lineBuffer` / `terminalBuffer` configure
+ *   {@link SerialSession.lines$} and {@link SerialSession.terminalText$}.
+ *   Omitted fields use {@link resolveSerialSessionOptions} defaults; minimal
+ *   callers typically only set `baudRate`.
  * @returns A {@link SerialSession} instance.
  *
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/199 | Issue #199}

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

@@ -1 +1 @@
-{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAOlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAyGf"}
+{"version":3,"file":"create-serial-session.d.ts","sourceRoot":"","sources":["../../src/session/create-serial-session.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAOlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAoFf"}

package/dist/session/index.d.ts

@@ -1,8 +1,8 @@
 export { createSerialSession } from './create-serial-session';
+export { isWebSerialSupported } from './internal/has-web-serial-support';
 export type { SerialSession } from './serial-session';
-export type { SerialSessionOptions, SerialSessionFeatureOptions, SerialSessionReceiveReplayOptions, ResolvedSerialSessionOptions, } from './serial-session-options';
+export type { SerialSessionOptions, SerialSessionFeatureOptions, ResolvedSerialSessionOptions, } from './serial-session-options';
 export { resolveSerialSessionOptions } from './serial-session-options';
-export { MAX_RECEIVE_REPLAY_BUFFER_SIZE, MAX_RECEIVE_REPLAY_MAX_CHARS, } from './serial-session-options';
 export type { SerialPayload, SerialConnectionOptions } from '../types';
 export { SerialSessionStatus } from './serial-session-state';
 export { isConnectedSessionState } from './is-connected-session-state';

package/dist/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/session/internal/error-severity.d.ts

@@ -23,7 +23,6 @@ export declare const ERROR_SEVERITY: {
     readonly OPERATION_CANCELLED: "fatal";
     readonly UNKNOWN: "fatal";
     readonly LINE_BUFFER_OVERFLOW: "non-fatal";
-    readonly RECEIVE_REPLAY_BUFFER_OVERFLOW: "non-fatal";
     readonly BROWSER_NOT_SUPPORTED: "non-fatal";
     readonly PORT_ALREADY_OPEN: "non-fatal";
     readonly PORT_NOT_OPEN: "non-fatal";

package/dist/session/internal/error-severity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-severity.d.ts","sourceRoot":"","sources":["../../../src/session/internal/error-severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,WAAW,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY+C,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,GACpB,mBAAmB,CAKrB"}
+{"version":3,"file":"error-severity.d.ts","sourceRoot":"","sources":["../../../src/session/internal/error-severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,WAAW,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAW+C,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,GACpB,mBAAmB,CAKrB"}

package/dist/session/internal/has-web-serial-support.d.ts

@@ -1,12 +1,13 @@
 /**
- * Internal feature detection for the Web Serial API.
+ * Synchronous feature detection for the Web Serial API.
  *
- * This helper is intentionally kept package-private: the v2 public API
- * exposes browser support only through {@link SerialSession.isBrowserSupported}.
+ * Prefer this helper **before** creating a session. After a session exists,
+ * drive unsupported UI from `state$` with `SerialSessionStatus.Unsupported`.
+ * This helper is SSR-safe: it returns `false` when `navigator` is not available.
  *
  * @returns `true` when `navigator.serial` is available.
  *
- * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/490 | Issue #490}
  */
-export declare function hasWebSerialSupport(): boolean;
+export declare function isWebSerialSupported(): boolean;
 //# sourceMappingURL=has-web-serial-support.d.ts.map

package/dist/session/internal/has-web-serial-support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"has-web-serial-support.d.ts","sourceRoot":"","sources":["../../../src/session/internal/has-web-serial-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C"}
+{"version":3,"file":"has-web-serial-support.d.ts","sourceRoot":"","sources":["../../../src/session/internal/has-web-serial-support.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C"}

package/dist/session/internal/line-buffer.d.ts

@@ -2,12 +2,15 @@ import type { MaxChars } from '../../internal/branded-numbers';
 /**
  * Options for {@link createLineBuffer}.
  *
+ * Character counts use UTF-16 string length (JavaScript `.length`).
+ *
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}
  */
 export interface LineBufferOptions {
     /**
      * Maximum characters retained in the incomplete line tail (no line terminator yet).
      * When exceeded, leading characters are discarded. `0` means unlimited.
+     * Must be a safe integer `>= 0` when validated.
      *
      * @default 1048576
      */
@@ -15,6 +18,20 @@ export interface LineBufferOptions {
 }
 /** Default limits applied when {@link LineBufferOptions} fields are omitted. */
 export declare const DEFAULT_LINE_BUFFER_OPTIONS: Required<LineBufferOptions>;
+/** Resolved line buffer options with validated branded numeric fields. */
+export type ResolvedLineBufferOptions = {
+    maxChars: MaxChars;
+};
+/**
+ * Merge and validate {@link LineBufferOptions}.
+ *
+ * This is the single normalization path for line buffer defaults and boundary
+ * checks used by {@link resolveSerialSessionOptions}.
+ *
+ * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS}
+ *         when `maxChars` is out of range.
+ */
+export declare function resolveLineBufferOptions(options?: LineBufferOptions): ResolvedLineBufferOptions;
 /** Result of {@link createLineBuffer.feed}. */
 export interface LineBufferFeedResult {
     lines: string[];

package/dist/session/internal/line-buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/line-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAEnE,CAAC;AAEF,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAC7C,UAAU,CA6BZ"}
+{"version":3,"file":"line-buffer.d.ts","sourceRoot":"","sources":["../../../src/session/internal/line-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK/D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAEnE,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,yBAAyB,CAwB3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAC7C,UAAU,CAyBZ"}

package/dist/session/internal/port-teardown.d.ts

@@ -0,0 +1,30 @@
+import type { ReadPump } from '../read-pump';
+import type { ReceivePipeline } from './receive-pipeline';
+/**
+ * Dependencies for {@link createPortTeardown}.
+ *
+ * @internal
+ */
+export interface PortTeardownDeps {
+    receivePipeline: ReceivePipeline;
+}
+/**
+ * Port and pump teardown primitives for {@link createSerialSession}.
+ *
+ * These are extracted from the session lifecycle so that both the lifecycle
+ * and the error reporter can depend on them without forming a construction
+ * cycle: the error reporter needs `teardownPump` / `closePortSafely` for fatal
+ * cleanup, while the lifecycle needs the error reporter for `reportError`.
+ *
+ * @internal
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/476 | Issue #476}
+ */
+export interface PortTeardown {
+    teardownPump: (pump: ReadPump | null) => Promise<void>;
+    closePortSafely: (port: SerialPort | null) => Promise<void>;
+}
+/**
+ * @internal
+ */
+export declare function createPortTeardown(deps: PortTeardownDeps): PortTeardown;
+//# sourceMappingURL=port-teardown.d.ts.map

package/dist/session/internal/port-teardown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-teardown.d.ts","sourceRoot":"","sources":["../../../src/session/internal/port-teardown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAwBvE"}

package/dist/session/internal/receive-pipeline.d.ts

@@ -1,6 +1,5 @@
 import { type Observable } from 'rxjs';
 import { SerialError } from '../../errors/serial-error';
-import type { NormalizeSerialErrorOptions } from '../normalize-serial-error';
 import type { ResolvedSerialSessionOptions } from '../serial-session-options';
 /**
  * Dependencies for {@link createReceivePipeline}.
@@ -9,7 +8,6 @@ import type { ResolvedSerialSessionOptions } from '../serial-session-options';
  */
 export interface ReceivePipelineDeps {
     resolvedOptions: ResolvedSerialSessionOptions;
-    reportError: (error: unknown, options: NormalizeSerialErrorOptions) => SerialError;
 }
 /**
  * Receive-side stream wiring for {@link createSerialSession}.
@@ -20,9 +18,14 @@ export interface ReceivePipelineDeps {
 export interface ReceivePipeline {
     receive$: Observable<string>;
     lines$: Observable<string>;
-    receiveReplay$: Observable<string>;
-    clearReplay: () => void;
-    startLiveReceiveReplay: () => void;
+    /**
+     * Buffer-overflow errors produced while decoding chunks. The factory pipes
+     * these into the session's single error-reporting entry point so the receive
+     * pipeline stays decoupled from error reporting and initialization order.
+     *
+     * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/476 | Issue #476}
+     */
+    bufferErrors$: Observable<SerialError>;
     clearLineBuffer: () => void;
     handleChunk: (text: string) => void;
     complete: () => void;

package/dist/session/internal/receive-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"receive-pipeline.d.ts","sourceRoot":"","sources":["../../../src/session/internal/receive-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAIhB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAOxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,eAAe,CAuGjB"}
+{"version":3,"file":"receive-pipeline.d.ts","sourceRoot":"","sources":["../../../src/session/internal/receive-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAW,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,4BAA4B,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;;;OAMG;IACH,aAAa,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,GACxB,eAAe,CAgDjB"}

package/dist/session/internal/session-error-reporter.d.ts

@@ -14,7 +14,6 @@ export interface SessionErrorReporterDeps {
     errorsSubject: Subject<SerialError>;
     sendQueue: SendQueue;
     isDisposed: () => boolean;
-    updatePortInfo: (port: SerialPort | null) => void;
     teardownPump: (pump: ReadPump | null) => Promise<void>;
     closePortSafely: (port: SerialPort | null) => Promise<void>;
 }

package/dist/session/internal/session-error-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-error-reporter.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-error-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,wBAAwB,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG;IAC1E,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC,CAyDA"}
+{"version":3,"file":"session-error-reporter.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-error-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,wBAAwB,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG;IAC1E,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC,CAuDA"}

package/dist/session/internal/session-lifecycle.d.ts

@@ -1,4 +1,4 @@
-import { type BehaviorSubject, Observable, type Subject } from 'rxjs';
+import { Observable, type Subject } from 'rxjs';
 import { SerialError } from '../../errors/serial-error';
 import type { ReceivePipeline } from './receive-pipeline';
 import { type NormalizeSerialErrorOptions } from '../normalize-serial-error';
@@ -16,9 +16,10 @@ export interface SessionLifecycleDeps {
     resolvedOptions: ResolvedSerialSessionOptions;
     sendQueue: SendQueue;
     receivePipeline: ReceivePipeline;
-    portInfoSubject: BehaviorSubject<SerialPortInfo | null>;
     errorsSubject: Subject<SerialError>;
     isDisposed: () => boolean;
+    teardownPump: (pump: ReadPump | null) => Promise<void>;
+    closePortSafely: (port: SerialPort | null) => Promise<void>;
     reportError: (error: unknown, options: NormalizeSerialErrorOptions) => SerialError;
     createDisposedError: () => SerialError;
 }
@@ -33,9 +34,6 @@ export interface SessionLifecycle {
     disconnect$: () => Observable<void>;
     dispose$: () => Observable<void>;
     writeToPort: (payload: Uint8Array) => Promise<void>;
-    teardownPump: (pump: ReadPump | null) => Promise<void>;
-    closePortSafely: (port: SerialPort | null) => Promise<void>;
-    updatePortInfo: (port: SerialPort | null) => void;
 }
 /**
  * @internal

package/dist/session/internal/session-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EASL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,wBAAwB,CAAC;IACrC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,CAgVlB"}
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/session/internal/session-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAE9E,OAAO,EASL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,wBAAwB,CAAC;IACrC,eAAe,EAAE,4BAA4B,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,2BAA2B,KACjC,WAAW,CAAC;IACjB,mBAAmB,EAAE,MAAM,WAAW,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,CA6SlB"}

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

@@ -1,13 +1,29 @@
-import { type BaudRate, type MaxChars, type MaxLines, type ReceiveReplayBufferSize, type SerialPortBufferSize } from '../internal/branded-numbers';
+import { type BaudRate, type SerialPortBufferSize } from '../internal/branded-numbers';
 import type { SerialConnectionOptions } from '../types';
-import type { TerminalBufferOptions } from '../terminal/create-terminal-buffer';
-import { type LineBufferOptions } from './internal/line-buffer';
+import { type ResolvedTerminalBufferOptions, type TerminalBufferOptions } from '../terminal/create-terminal-buffer';
+import { type LineBufferOptions, type ResolvedLineBufferOptions } from './internal/line-buffer';
+export type { ResolvedLineBufferOptions, ResolvedTerminalBufferOptions, };
 /**
  * Library-specific options for {@link createSerialSession} that are not passed
  * to W3C `port.open`.
  *
+ * Responsibility split (Issue #488):
+ *
+ * - {@link SerialSessionFeatureOptions.filters} — port selection only
+ *   (`navigator.serial.requestPort`)
+ * - {@link SerialSessionFeatureOptions.lineBuffer} — incomplete-line tail for
+ *   {@link SerialSession.lines$}
+ * - {@link SerialSessionFeatureOptions.terminalBuffer} — display memory for
+ *   {@link SerialSession.terminalText$}
+ *
+ * Connection parameters (`baudRate`, `dataBits`, …) live on
+ * {@link SerialConnectionOptions} and are composed into
+ * {@link SerialSessionOptions}. Minimal callers typically only set
+ * `baudRate`; other fields keep safe defaults.
+ *
  * @see {@link SerialConnectionOptions} for W3C connection parameters
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/441 | Issue #441}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/488 | Issue #488}
  */
 export interface SerialSessionFeatureOptions {
     /**
@@ -15,29 +31,31 @@ export interface SerialSessionFeatureOptions {
      *
      * When specified, the port selection dialog will only show devices
      * matching these filters. Each filter can specify `usbVendorId` and/or
-     * `usbProductId`.
+     * `usbProductId`. Not passed to `port.open`.
      */
     filters?: SerialPortFilter[];
-    /**
-     * Optional receive replay: retain recent decoded text **chunks** so late
-     * subscribers to {@link SerialSession.receiveReplay$} can read buffered
-     * data while a connection is active. Does not change {@link SerialSession.receive$}.
-     *
-     * @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.
+     * Character counts use UTF-16 string length (JavaScript `.length`).
      *
-     * @default `{ maxLines: 10000, maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})
+     * Pass `0` for `maxLines` or `maxChars` to disable that limit (unlimited).
+     * Negative values, non-integers, `NaN`, and `Infinity` are rejected at
+     * factory time.
+     *
+     * @default `{ maxLines: 10000, maxChars: 1048576, stripAnsi: true }`
+     *   (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$}.
+     * {@link SerialErrorCode.LINE_BUFFER_OVERFLOW} is emitted on
+     * {@link SerialSession.errors$}. Character counts use UTF-16 string length.
+     *
+     * Pass `0` for `maxChars` to disable the limit (unlimited). Negative values,
+     * non-integers, `NaN`, and `Infinity` are rejected at factory time.
      *
      * @default `{ maxChars: 1048576 }` (see {@link DEFAULT_SERIAL_SESSION_OPTIONS})
      * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/371 | Issue #371}
@@ -49,10 +67,17 @@ export interface SerialSessionFeatureOptions {
  *
  * Composes {@link Partial}<{@link SerialConnectionOptions}> (W3C connection
  * parameters passed to `port.open`) with {@link SerialSessionFeatureOptions}
- * (library-specific session features). All connection fields are optional;
- * omitted values fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}
- * (`baudRate` 9600, `dataBits` 8, `stopBits` 1, `parity` `'none'`,
- * `bufferSize` 255, `flowControl` `'none'`).
+ * (library-specific session features). All fields are optional; omitted values
+ * fall back to {@link DEFAULT_SERIAL_SESSION_OPTIONS}.
+ *
+ * Minimal usage typically only needs `baudRate`:
+ *
+ * @example
+ * ```typescript
+ * const session = createSerialSession({ baudRate: 115200 });
+ * ```
+ *
+ * Full example:
  *
  * @example
  * ```typescript
@@ -66,6 +91,12 @@ export interface SerialSessionFeatureOptions {
  * });
  * ```
  *
+ * Boundary semantics for numeric limits:
+ *
+ * - `undefined` — apply the default from {@link DEFAULT_SERIAL_SESSION_OPTIONS}
+ * - `baudRate` / `bufferSize` — must be safe integers `> 0` (rejected otherwise)
+ * - `terminalBuffer` / `lineBuffer` limits — safe integers `>= 0`; `0` means unlimited
+ *
  * @see {@link SerialConnectionOptions}
  * @see {@link SerialSessionFeatureOptions}
  * @see {@link SerialOptions}
@@ -73,96 +104,29 @@ export interface SerialSessionFeatureOptions {
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/200 | Issue #200}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/402 | Issue #402}
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/441 | Issue #441}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/488 | Issue #488}
  */
 export interface SerialSessionOptions extends Partial<SerialConnectionOptions>, SerialSessionFeatureOptions {
 }
-/**
- * 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 {
-    /**
-     * When `true`, the session uses a replay buffer for {@link SerialSession.receiveReplay$}
-     * for each open connection. When `false` (default), `receiveReplay$` is
-     * the same hot stream as {@link SerialSession.receive$} (no chunk replay).
-     */
-    enabled?: boolean;
-    /**
-     * Retains the last **N** decoded text chunks (one emission per `onChunk`
-     * from the read pump) in the replay buffer. Not the character count. Higher
-     * `bufferSize` uses more memory.
-     *
-     * @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.
- */
-/** Resolved receive replay options with validated branded numeric fields. */
-export type ResolvedSerialSessionReceiveReplayOptions = {
-    enabled: boolean;
-    bufferSize: ReceiveReplayBufferSize;
-    maxChars: MaxChars;
-};
-export declare function resolveReceiveReplayOptions(options?: SerialSessionReceiveReplayOptions): ResolvedSerialSessionReceiveReplayOptions;
-/**
- * Merge and validate {@link TerminalBufferOptions}.
- *
- * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS}
- *         when `maxLines` or `maxChars` are out of range.
- */
-/** Resolved terminal buffer options with validated branded numeric fields. */
-export type ResolvedTerminalBufferOptions = {
-    maxLines: MaxLines;
-    maxChars: MaxChars;
-    stripAnsi: boolean;
-};
-export declare function resolveTerminalBufferOptions(options?: TerminalBufferOptions): ResolvedTerminalBufferOptions;
-/**
- * Merge and validate {@link LineBufferOptions}.
- *
- * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS}
- *         when `maxChars` is out of range.
- */
-/** Resolved line buffer options with validated branded numeric fields. */
-export type ResolvedLineBufferOptions = {
-    maxChars: MaxChars;
-};
-export declare function resolveLineBufferOptions(options?: LineBufferOptions): ResolvedLineBufferOptions;
 /**
  * Fully resolved session options after merging {@link SerialSessionOptions}
  * with {@link DEFAULT_SERIAL_SESSION_OPTIONS}. All invariant fields are
  * required; `filters` remains optional.
  */
-export type ResolvedSerialSessionOptions = Required<Omit<SerialSessionOptions, 'filters' | 'receiveReplay' | 'terminalBuffer' | 'lineBuffer' | 'baudRate' | 'bufferSize'>> & {
+export type ResolvedSerialSessionOptions = Required<Omit<SerialSessionOptions, 'filters' | 'terminalBuffer' | 'lineBuffer' | 'baudRate' | 'bufferSize'>> & {
     baudRate: BaudRate;
     bufferSize: SerialPortBufferSize;
     filters?: SerialPortFilter[];
-    receiveReplay: ResolvedSerialSessionReceiveReplayOptions;
     terminalBuffer: ResolvedTerminalBufferOptions;
     lineBuffer: ResolvedLineBufferOptions;
 };
 /**
  * Default values applied to omitted {@link SerialSessionOptions} fields.
  *
+ * Nested buffer defaults are owned by {@link resolveTerminalBufferOptions} and
+ * {@link resolveLineBufferOptions}; this object is the single session-level
+ * snapshot used by {@link resolveSerialSessionOptions}.
+ *
  * @internal
  */
 export declare const DEFAULT_SERIAL_SESSION_OPTIONS: {
@@ -172,7 +136,6 @@ export declare const DEFAULT_SERIAL_SESSION_OPTIONS: {
     parity: "none";
     bufferSize: SerialPortBufferSize;
     flowControl: "none";
-    receiveReplay: ResolvedSerialSessionReceiveReplayOptions;
     terminalBuffer: ResolvedTerminalBufferOptions;
     lineBuffer: ResolvedLineBufferOptions;
 };
@@ -185,20 +148,25 @@ export type ResolvedSerialSessionConnectionOptions = Required<Omit<SerialConnect
  * Merge and validate W3C connection fields from {@link SerialSessionOptions}.
  *
  * @throws {@link SerialError} with {@link SerialErrorCode.INVALID_CONNECTION_OPTIONS}
- *         when `baudRate` is out of range.
+ *         when `baudRate` or `bufferSize` are out of range.
  */
 export declare function resolveConnectionOptions(options?: Partial<SerialConnectionOptions>): ResolvedSerialSessionConnectionOptions;
 /**
  * Merge and validate {@link SerialSessionOptions} into a fully resolved
  * options object for internal session use.
  *
+ * Defaults and validation for nested buffers live next to their option types
+ * ({@link resolveTerminalBufferOptions}, {@link resolveLineBufferOptions}).
+ * This function is the single entry point that assembles connection + feature
+ * options for a session.
+ *
  * @throws {@link SerialError} when option values are out of range:
  *         {@link SerialErrorCode.INVALID_CONNECTION_OPTIONS},
  *         {@link SerialErrorCode.INVALID_FILTER_OPTIONS},
- *         {@link SerialErrorCode.INVALID_RECEIVE_REPLAY_OPTIONS},
  *         {@link SerialErrorCode.INVALID_TERMINAL_BUFFER_OPTIONS}, or
  *         {@link SerialErrorCode.INVALID_LINE_BUFFER_OPTIONS}.
  * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/403 | Issue #403}
+ * @see {@link https://github.com/gurezo/web-serial-rxjs/issues/488 | Issue #488}
  */
 export declare function resolveSerialSessionOptions(options?: SerialSessionOptions): ResolvedSerialSessionOptions;
 //# 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":"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"}
+{"version":3,"file":"serial-session-options.d.ts","sourceRoot":"","sources":["../../src/session/serial-session-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,yBAAyB,EACzB,6BAA6B,GAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE7B;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,WAAW,oBACf,SAAQ,OAAO,CAAC,uBAAuB,CAAC,EAAE,2BAA2B;CAAG;AAE1E;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CACjD,IAAI,CACF,oBAAoB,EAClB,SAAS,GACT,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,YAAY,CACf,CACF,GAAG;IACF,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,cAAc,EAAE,6BAA6B,CAAC;IAC9C,UAAU,EAAE,yBAAyB,CAAC;CACvC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;CASH,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,MAAM,sCAAsC,GAAG,QAAQ,CAC3D,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,YAAY,CAAC,CACzD,GAAG;IACF,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,oBAAoB,CAAC;CAClC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACzC,sCAAsC,CAmDxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,4BAA4B,CAU9B"}