
    ^h                        S r SSKJr  SSKJrJrJrJrJrJ	r	J
r
JrJrJrJrJrJrJrJrJrJrJr  SSKJrJrJrJrJrJr  SSKJrJrJ r J!r!J"r"J#r#J$r$  SSK%J&r&J'r'J(r(  SSK)J*r*J+r+J,r,J-r-J.r.  SS	K/J0r0J1r1  SS
K2J3r3  / SQr4g)a  
Command line layout definitions
-------------------------------

The layout of a command line interface is defined by a Container instance.
There are two main groups of classes here. Containers and controls:

- A container can contain other containers or controls, it can have multiple
  children and it decides about the dimensions.
- A control is responsible for rendering the actual content to a screen.
  A control can propose some dimensions, but it's the container who decides
  about the dimensions -- or when the control consumes more space -- which part
  of the control will be visible.


Container classes::

    - Container (Abstract base class)
       |- HSplit (Horizontal split)
       |- VSplit (Vertical split)
       |- FloatContainer (Container which can also contain menus and other floats)
       `- Window (Container which contains one actual control

Control classes::

    - UIControl (Abstract base class)
       |- FormattedTextControl (Renders formatted text, or a simple list of text fragments)
       `- BufferControl (Renders an input buffer.)


Usually, you end up wrapping every control inside a `Window` object, because
that's the only way to render it in a layout.

There are some prepared toolbars which are ready to use::

- SystemToolbar (Shows the 'system' input buffer, for entering system commands.)
- ArgToolbar (Shows the input 'arg', for repetition of input commands.)
- SearchToolbar (Shows the 'search' input buffer, for incremental search.)
- CompletionsToolbar (Shows the completions of the current buffer.)
- ValidationToolbar (Shows validation errors of the current buffer.)

And one prepared menu:

- CompletionsMenu

    )annotations   )AnyContainerColorColumnConditionalContainer	ContainerDynamicContainerFloatFloatContainerHorizontalAlignHSplitScrollOffsetsVerticalAlignVSplitWindowWindowAlignWindowRenderInfois_containerto_container	to_window)BufferControlDummyControlFormattedTextControlSearchBufferControl	UIContent	UIControl)AnyDimensionD	Dimensionis_dimensionmax_layout_dimensionssum_layout_dimensionsto_dimension)InvalidLayoutErrorLayoutwalk)ConditionalMarginMarginNumberedMarginPromptMarginScrollbarMargin)CompletionsMenuMultiColumnCompletionsMenu)ScrollablePane)*r%   r$   r&   r   r   r   r"   r!   r#   r    r   r   r   r   r   r   r   r
   r   r   r   r   r   r   r   r   r   r	   r.   r   r   r   r   r   r   r(   r)   r+   r'   r*   r,   r-   N)5__doc__
__future__r   
containersr   r   r   r   r	   r
   r   r   r   r   r   r   r   r   r   r   r   r   controlsr   r   r   r   r   r   	dimensionr   r   r   r    r!   r"   r#   layoutr$   r%   r&   marginsr'   r(   r)   r*   r+   menusr,   r-   scrollable_paner.   __all__     X/home/james-whalen/.local/lib/python3.13/site-packages/prompt_toolkit/layout/__init__.py<module>r<      sc   -^ #    (    5 4  ? +1r:   