Method proposeDimensions

lib/addons/fit.ts:140–196

* Propose dimensions to fit the terminal to its container * * Calculates cols and rows based on: * - Terminal container element dimensions (clientWidth/Height) * - Terminal element padding * - Font metrics (character cell size) * - Scrollbar width reservation * * @returns Pro

()

   * @returns Proposed dimensions or undefined if cannot calculate
   */
  public proposeDimensions(): ITerminalDimensions | undefined {
    // Need terminal and its DOM element
    if (!this._terminal?.element) {
      return undefined;
    }

    // Access terminal internals to get renderer
    const terminal = this._terminal as any;
    const renderer = terminal.renderer;

    if (!renderer || typeof renderer.getMetrics !== 'function') {
      return undefined;
    }

    // Get font metrics from renderer
    const metrics = renderer.getMetrics();
    if (!metrics || metrics.width === 0 || metrics.height === 0) {
      return undefined;
    }

    // Get terminal element (container) dimensions
    // Use clientWidth/clientHeight to get the INSIDE dimensions (excluding padding)
    const terminalElement = this._terminal.element;

    // Check if we have clientWidth/clientHeight (DOM element required)
    if (typeof terminalElement.clientWidth === 'undefined') {
      return undefined;
    }

    const elementStyle = window.getComputedStyle(terminalElement);

    // Get the actual content area (inside padding)
    const paddingTop = Number.parseInt(elementStyle.getPropertyValue('padding-top')) || 0;
    const paddingBottom = Number.parseInt(elementStyle.getPropertyValue('padding-bottom')) || 0;
    const paddingLeft = Number.parseInt(elementStyle.getPropertyValue('padding-left')) || 0;
    const paddingRight = Number.parseInt(elementStyle.getPropertyValue('padding-right')) || 0;

    // Use clientWidth/clientHeight which gives us the inside dimensions
    // This is stable and doesn't grow with content
    const containerWidth = terminalElement.clientWidth;
    const containerHeight = terminalElement.clientHeight;

    // Check for invalid dimensions
    if (containerWidth === 0 || containerHeight === 0) {
      return undefined;
    }

    // Calculate available space (subtract padding since clientWidth includes padding)
    const availableWidth = containerWidth - paddingLeft - paddingRight - DEFAULT_SCROLLBAR_WIDTH;
    const availableHeight = containerHeight - paddingTop - paddingBottom;

    // Calculate dimensions (enforce minimums)
    const cols = Math.max(MINIMUM_COLS, Math.floor(availableWidth / metrics.width));
    const rows = Math.max(MINIMUM_ROWS, Math.floor(availableHeight / metrics.height));

    return { cols, rows };
  }