Class FitAddon

lib/addons/fit.ts:40–242

// ============================================================================

export class FitAddon implements ITerminalAddon {
  private _terminal?: ITerminalCore;
  private _resizeObserver?: ResizeObserver;
  private _resizeDebounceTimer?: ReturnType<typeof setTimeout>;
  private _lastCols?: number;
  private _lastRows?: number;
  private _isResizing: boolean = false;

  /**
   * Activate the addon (called by Terminal.loadAddon)
   */
  public activate(terminal: ITerminalCore): void {
    this._terminal = terminal;
  }

  /**
   * Dispose the addon and clean up resources
   */
  public dispose(): void {
    // Disconnect ResizeObserver
    if (this._resizeObserver) {
      this._resizeObserver.disconnect();
      this._resizeObserver = undefined;
    }

    // Clear pending debounce timer
    if (this._resizeDebounceTimer) {
      clearTimeout(this._resizeDebounceTimer);
      this._resizeDebounceTimer = undefined;
    }

    // Clear stored dimensions
    this._lastCols = undefined;
    this._lastRows = undefined;

    this._terminal = undefined;
  }

  /**
   * Fit the terminal to its container
   *
   * Calculates optimal dimensions and resizes the terminal.
   * Does nothing if dimensions cannot be calculated or haven't changed.
   */
  public fit(): void {
    // Prevent re-entrant calls during resize
    if (this._isResizing) {
      return;
    }

    const dims = this.proposeDimensions();
    if (!dims || !this._terminal) {
      return;
    }

    // Access terminal to check current dimensions
    const terminal = this._terminal as any;
    const currentCols = terminal.cols;