CjK%SrSSKJr SSKJrJrJr SSKJr SSK J r SSK J r SSK Jr SSKJr SS KJrJrJrJrJrJrJrJrJrJrJrJrJr SS Kr SS K!J"r"J#r#J$r$J%r%J&r& SS K!J'r( SS K)J*r* SSK+J,r, SSK-J.r. SSK/J0r0 SSK1J2r2 SSK3J4r4 \(aSS K5J'r' SSK6J7r7J8r8J9r9J:r: SSK;Jr>J?r? SSK@JArAJBrB SSKCJDrD SSKEJFrF SSKGJHrH SSKIJJrJ SSKKJLrL SSKMJNrN SSKOJPrP SSKQJRrR SSKSJTrT SSKUJVrV SS KWJXrXJYrY SS!KZJ[r[ SS"K\J]r] SS#K^J_r_J`r` SS$KaJbrb SS%KcJdrd SS&KeJfrfJgrg SS'KhJiriJjrj SS(KkJlrlJmrm SS)KnJoroJprpJqrqJrrrJsrsJtrtJuruJvrv SS*KwJxrxJyry SS+KzJ{r{ SS,K|J}r} SS-K~JrJr SS.KJr SS/KJr SS0KJr SS1KJr SS2KJr SS3KJr SS4KJr SSKJ.r SS5KJrJrJr \(a,SS6K5JrJr SS7KeJr SS8KJr SS9KJr SS:KJrJrJrJrJrJrJr S;S.rS?\S@'\9GRJ\9GRL\9GRN4r\9GRR\9GRT\9GRV\9GRX4r\ GR\GR^"SASB55r"SCSD5r"SESF\5r"SGSH\5r"SISJ\5r"SKSL\5r"SMSN5r"SOSP\5r\ GR\GR^"SQSR\l55rg )SzK This module contains the `Widget` class, the base class for all widgets. ) annotations) create_taskgatherwait)Counter)asynccontextmanager)Fraction) monotonic) TracebackType) TYPE_CHECKINGAsyncGeneratorCallableClassVar Collection GeneratorIterableMapping NamedTupleSequenceTypeVarcastoverloadN)ConsoleConsoleOptionsConsoleRenderable JustifyMethodRenderableType) RenderResult) Measurement)Segment)Style)Text)Self) StylesBase) constantserrorseventsmessages)DEFAULT_EASING Animatable BoundAnimatorEasingFunction)DockArrangeResultarrange)NoActiveAppError)get_caller_file_and_line dispatch_key)DEFAULT_SCROLL_EASING)Extrema) StylesCache)AnimationLevel) SkipAction) AwaitRemove)BoxModel) FIFOCacheLRUCache)Color)compose)Content ContentType)match)parse_selectors) NoMatches WrongType)Scalar ScalarOffset)DOMNodeNoScreen) NULL_REGION NULL_SIZE NULL_SPACINGOffsetRegionSizeSpacingclamp)LayoutWidgetPlacement)VerticalLayout)Message) CallbackTypePrune) SeverityLevel)Reactive)Blank)RLock) Selection)Strip) NULL_STYLE)Visual VisualType visualize)App ComposeResult) QueryType) LineFilter) MessagePump) ScrollBarScrollBarCorner ScrollDown ScrollLeft ScrollRightScrollToScrollUpleftrightfull)startendjustifyzdict[str, JustifyMethod] _JUSTIFY_MAPc@\rSrSrSrS SjrS SjrS SjrS SjrSr g) AwaitMountzAn *optional* awaitable returned by [mount][textual.widget.Widget.mount] and [mount_all][textual.widget.Widget.mount_all]. Example: ```python await self.mount(Static("foo")) ``` c:XlX l[5UlgN)_parent_widgetsr0_caller)selfparentwidgetss `/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/widget.py__init__AwaitMount.__init__s  /1 c#n# SUR4v SUR4v SURS4v g7f)Nr|r}caller)rxryrzr{s r~ __rich_repr__AwaitMount.__rich_repr__s4 $$&& d**s35c$# UIShvN gN7f)z%Allows awaiting via a call operation.Nrs r~__call__AwaitMount.__call__s  c>^SU4SjjnU"5R5$)Nc># TR(aTRVs/sH%n[URR5SS9PM' nnU(ag[U5IShvN TRR SS9 TRR RTRR5 gggs snfN_![a gf=f7f)Nz await mount)nameTlayout) ryr_mounted_eventrrxrefreshapp_update_mouse_overscreenrG)widgetawsr{s r~ await_mount)AwaitMount.__await__..await_mounts}}#'--"/  5 5 : : <=Q"/s)OOLL(((5 ((;;DLL C CCCCreturnNone) __await__)r{rs` r~rAwaitMount.__await__s }&&((r)rzrxryN)r|Widgetr}zSequence[Widget]rrrzrich.repr.Resultr)rzGenerator[None, None, None]) __name__ __module__ __qualname____firstlineno____doc__rrrr__static_attributes__rrr~rtrts2 + )rrtc^\rSrSrSrSSjrS SjrS SjrSrg) _StyledzApply a style to a renderable. Args: renderable: Any renderable. style: A style to apply across the entire renderable. c(XlX lX0lgrw) renderablestyle link_style)r{rrrs r~r_Styled.__init__s% $rc^^^URUR5nURURU5n[mU(aUR mUU4SjU5nUR mT(a UU4SjU5nU$)Nc3J># UHupnT"UT"U5S5v M g7frwr).0text_stylecontrol_Segmentapplys r~ +_Styled.__rich_console__..s--<)D'uV}d33-# UH;upnUcM T"UURcUOSUR;aUT-OUU5v M= g7f)Nz@click)_metameta)rrrrrrs r~rrs] -<(D!;;.4< 4Jej0PU-from_rich_textsetattrr render_str expand_tabssplitr)r{objtitle new_titles r~__set___BorderTitle.__set__sy eT " "**51E = C,,d 3u-99!_S?S@_SASB_SCSD_SESF_SGSH_SISJ_SKSL_SMSN_SOSPSQ.Er(SR\SS'S S S SS ST.GShU4SUjjjr)\*GSiSVj5r+\*GSjSWj5r,\*GSjSXj5r-\*GSiSYj5r.\*GSiSZj5r/\*GSiS[j5r0\*GSiS\j5r1\*GSkS]j5r2\2RfGSlS^j5r2\*GSmS_j5r4\*GSiS`j5r5\*GSiSaj5r6\*GSiSbj5r7\*GSiScj5r8\*GSnSdj5r9\*GSoSej5r:\;S Sf.GSpSgjj5rGSrSjjr?GSrSkjr@GSsSljrAGStSmjrBGSrSnjrCGSuGSvSojjrDGSrSpjrEGSrSqjrFGSiSrjrG\*GSwSsj5rH\HRfGSxStj5rHGSySujrIGSiSvjrJGSiSwjrKGSsSxjrL\*GSiSyj5rM\*GSiSzj5rN\*GSiS{j5rO\*GSiS|j5rP\*GSiS}j5rQ\*GSiS~j5rR\*GSiSj5rS\*GSiSj5rTGSzSjrUGS{SjrVGSrSjrWGSnSjrXGS|SjrYGS|SjrZ\["SSS9r\\](a\^GS}Sj5r_\^GS~Sj5r_GSGSSjjr_\](a\^GS}Sj5r`\^GS~Sj5r`GSGSSjjr`GSSjraSS S.GSSjjrbSS.GSSjjrcGSSjrd\^GSSj5re\^GSSj5reGSSjreGSGSSjjrfGSrSjrgGSSjrhGSSjriS S S.GSSjjrjGSrSjrkS S S.GSSjjrlS S S.GSSjjrm\](a,\^S S.GSSjj5rn\^S S.GSSjj5rnS S S.GSSjjrnGSSjroGSrSjrpGSrSjrqGSSjrrGSGSSjjrsGSSjrtGSSjruGSSjrvGSSjrwGSSjrxGSSjryGSSjrzGSSjr{GSSjr|\*GSSj5r}\*GSSj5r~\*GSiSj5r\*GSiSj5r\*GSiSj5r\*GSiSj5r\*GSSj5r\*GSSj5r\*GSSj5rGSrSjr\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSkSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSiSj5r\*GSiSj5r\*GSSj5r\*GSkSj5r\*GSkSj5r\*GSSj5r\*GSiSj5r\*GSiSj5r\*GSiSj5rGSSjrSS S S%\S SS.GSSjjrGSuGSSjjr\*GSSj5r\*GSiSj5r\*GSiSj5r\*GSiSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSSj5r\*GSnSj5rGSSjrGSSjrGSS S S S SS SS S.GSSjjjr\*GSiSj5rGSSjrGSSjrGSS S S S SS SSS S. GSSjjjrGSS S S S SS SSS.GSSjjjrS S S S SS SSS S S. GSSjjrS S S S SS SSS S S. GSSjjrS S S S SS SSS.GSSjjrS S S S SS SS.GSSjjrS S S S SS SSS.GSSjjrS S S S SS SS.GSSjjrS S S S SS SSS.GSSjjrS S S S SS SS.GSGSjjrS S S S SS SSS.GSGSjjrS S S S SS SS.GSGSjjrS S S S SS SS.GSGSjjrS S S S SS SS.GSGSjjrS S S S SS SS.GSGSjjrS S S S SS SS.GSGSjjrS S S S SSS SS SSGS. GSGSjjrS S S S S SSS SS SS S SGS .GSGS jjrGSuS S SS SS SSGS .GSGS jjjrGSuS S S SS S SSGS .GSGSjjjrGSGSjrGSGSjrGSGSU4GSjjjrGSGSjrGSGSjrGSGSjrGSGSjr\*GSGSj5rGSGSjrGSGSjrGSGSjrGSGSjrGSuGSGSjjrGSGSjr\*GSGSj5rGSGSjrGSGSjrGSrGS jrGSGS!jrGSGS"jrGSGS#jrGSrGS$jrGSGS%jrGSrGS&jrS SSGS'.GSGS(jjrGSGS)jrGSGSGS*jjr\GSGS+j5rGSGS,jrGSGS-jrGSGSGS.jjrGSU4GS/jjrGSGS0jrGSrGS1jrGSGS2jrGSrGS3jrGSuGSGS4jjrGSzGS5jrGSuGSGS6jjrGSrGS7jrGSrGS8jrGSGSGS9jjrGSrGS:jrGSU4GS;jjrGSGS<jrGSrU4GS=jjrGSGS>jrGSGS?jrGSGS@jrGSGSAjrGSGSBjrGSGSCjGrGSrGSDjGrGSGSEjGrGSGSFjGrGSGSGjGrGSGSHjGrGSGSIjGrGSGSJjGrGSGSKjGrGSGSLjGr GSGSMjGr GSGSNjGr GSGSOjGr GSGSPjGr GSGSQjGrGSGSRjGrGSGSSjGrGSGSTjGrGSGSUjGrGSGSVjGrGSGSWjGrGSrGSXjGrGSrGSYjGrGSrGSZjGrGSrGS[jGrGSrGS\jGrGSrGS]jGrGSrGS^jGrGSrGS_jGrGSrGS`jGrGSrGSajGrGSrGSbjGrSGScS S GSd.GSGSejjGr GSGSGSfjjGr!GSgGr"U=Gr#$(riz A Widget is the base class for Textual widgets. See also [static][textual.widgets._static.Static] for starting point for your own widgets. a Widget{ scrollbar-background: $scrollbar-background; scrollbar-background-hover: $scrollbar-background-hover; scrollbar-background-active: $scrollbar-background-active; scrollbar-color: $scrollbar; scrollbar-color-active: $scrollbar-active; scrollbar-color-hover: $scrollbar-hover; scrollbar-corner-color: $scrollbar-corner-color; scrollbar-size-vertical: 2; scrollbar-size-horizontal: 1; link-background: $link-background; link-color: $link-color; link-style: $link-style; link-background-hover: $link-background-hover; link-color-hover: $link-color-hover; link-style-hover: $link-style-hover; background: transparent; } zClassVar[set[str]]COMPONENT_CLASSESz ClassVar[str] BORDER_TITLEBORDER_SUBTITLENzClassVar[bool | None]ALLOW_MAXIMIZETzClassVar[bool] ALLOW_SELECTFOCUS_ON_CLICKFBLANKr can_focuscan_focus_childrenzReactive[bool]expandshrink auto_linksdisabled)repaintzReactive[Style] hover_stylez Reactive[str]highlight_link_idloadingrr has_focus mouse_hoverg)rrzReactive[float]scroll_xscroll_yshow_vertical_scrollbarshow_horizontal_scrollbarz ClassVar[int] _sort_orderrcUR$rw)rrs r~Widget.s  2 2rrcUR$rwrrs r~rrs  0 0rblurc$UR(+$rwr!rs r~rrs 6#3#33rz can-focusc"UR5$rw) allow_focusrs r~rrs F$6$6$8rcUR$rw is_disabledrs r~rrs 6#5#5rrc$UR(+$rwr'rs r~rrs f&8&8"8rdarkcBURRR$rwr current_themer*rs r~rrsvzz77<'>rinlinec.URR$rw)r is_inliners r~rrs!5!5ransic.URR$rw)rnative_ansi_colorrs r~rrsvzz;;rnocolorc.URR$rw)rno_colorrs r~rrs&**"5"5rz first-of-typecUR$rw) first_of_typers r~rrs (<(XPl[nXplXplSUlSUlSUlSUlSUlSUl [5Ul SUl [=RS- sl[RUlSUlSUlSUlSUlSUlSUl0UlSUlSUl[3U/5Ul[75Ul[75Ul[=S5UlSUl SUl![ES5Ul#[I5Ul%0Ul&0Ul'SUl(SUl)[75Ul*[VT U]UUUc URZOUS 9 X;a []S 5eUH'n[_U[5(aM[aS U<35e [cU5Ul2URg[RhU5 URj(aURjUl6URn(aURnUl8[s5Ul:SUl;SUl<SUl=S Ul>S Ul?S Ul@S UlAS UlB[5UlD[5UlFg) a Initialize a Widget. Args: *children: Child widgets. name: The name of the widget. id: The ID of the widget in the DOM. classes: The CSS classes for the widget. disabled: Whether the widget is disabled or not. markup: Enable content markup? FrNNrr)rrNrOz A widget can't be its own parentz;Widget positional arguments must be Widget subclasses; not )rRF)G_render_markuprI_size_container_size_layout_required_layout_updates_repaint_required_scroll_required_recompose_required_refresh_styles_requiredrR_default_layout_animaterr sort_orderhighlight_style_vertical_scrollbar_horizontal_scrollbar_scrollbar_corner _border_title_border_subtitle _layout_cache _visual_style_visual_style_cache_keyr _render_cacheset_dirty_regions_repaint_regionsr;_box_model_cache_content_width_cache_content_height_cacher:_arrangement_cacher5 _styles_cache_rich_style_cache_visual_style_cache_tooltipabsolute_offset_scrollbar_changessuperrDEFAULT_CLASSESrr TypeErrorlist_pending_children set_reactiverr border_titlerborder_subtitlerYlock _anchored_anchor_released _cover_widget_first_of_type _last_of_type _first_child _last_child_oddr _last_scroll_timer4_extrema) r{rrNrOrrchildren _null_sizechild __class__s r~rWidget.__init__s&%  ) % !& %#( (-%-/.2 a ,,-159 7;"9=-10402N15%,.$$)*b9+.5-0U ComposeResult: yield Label("Hello").with_tooltip("A greeting") ``` Args: tooltip: New tooltip, or `None` to clear the tooltip. Returns: Self. )rrs r~ with_tooltipWidget.with_tooltipVs  rcUR$)a Check if the widget is permitted to focus. The base class returns [`can_focus`][textual.widget.Widget.can_focus]. This method may be overridden if additional logic is required. Returns: `True` if the widget may be focused, or `False` if it may not be focused. )r rs r~r%Widget.allow_focushs~~rcUR$)a<Check if a widget's children may be focused. The base class returns [`can_focus_children`][textual.widget.Widget.can_focus_children]. This method may be overridden if additional logic is required. Returns: `True` if the widget's children may be focused, or `False` if the widget's children may not be focused. )r rs r~allow_focus_childrenWidget.allow_focus_childrenss&&&rc>SnURRU5 g)aAdd a node to children. This is used by the compose process when it adds children. There is no need to use it directly, but you may want to override it in a subclass if you want children to be attached to a different node. Args: widget: A Widget to add. TN)r|append)r{r_rich_traceback_omits r~compose_add_childWidget.compose_add_child~s $ %%f-rcUn[U[5(a5UR(agURn[U[5(aM5g)zYIs the widget disabled either because `disabled=True` or an ancestor has `disabled=True`.TF)rrrrxr{rs r~r(Widget.is_disableds=$(v&&}}< == ! !T%8%8%; ;&&q) )4j MM++D$,,'-}}'='=t|&L#**1--,rc^URnUcgURRURS:XaURS$[ U5nURR HBn[ X25(dMURRX0L4UlURSs $ g)z4Is this the last widget of its type in its siblings?TrrQF)r|rr'rr(displayed_reverserr*s r~r>Widget.last_of_types > == ! !T%7%7%: :%%a( (4j MM33D$,,&,mm&<& == ! !T%6%6q%9 9$$Q' 'MM++D!'!7!7 FD $$Q' ',rc$URnUcgURRURS:XaURS$URRH0nURRX L4UlURSs $ g)z(Is this the last widget in its siblings?TrrQF)r|rr'rr.r1s r~rBWidget.last_childs > == ! !T%5%5a%8 8##A& &MM33D & 6 6 ED ##A& &4rcDURnUcgURRURS:XaURS$URRR U5S-S:HnURRU4UlU$![ a gf=f)zAIs this widget at an oddly numbered position within its siblings?TrrQF)r|rr'rdisplayed_and_visibleindexr)r{r|rFs r~rF Widget.is_odds > == ! !TYYq\ 199Q<  ]]88>>tDqHAMF//8DIM  sA B BBc$UR(+$)zBIs this widget at an evenly numbered position within its siblings?rErs r~rHWidget.is_evens;;rcVURRSRU5 U$)z&Use as context manager when composing.rR)r_compose_stacksrrs r~ __enter__Widget.__enter__s$   $++D1 rcURRSnUR5nU(aUSRU5 gURRSR U5 g)zExit compose context manager.rRN)rr=popr _composedr)r{exc_typeexc_valexc_tb compose_stackcomposeds r~__exit__Widget.__exit__sY004  $$&  "  / / 9 HH  r " ) )( 3rc SUlSUlg)zClear cached results of `get_content_width` and `get_content_height`. Call if the widget's renderable changes size after the widget has been created. !!! note This is not required if you are extending [`Static`][textual.widgets.Static]. rTN)rorprs r~clear_cached_dimensionsWidget.clear_cached_dimensionss%.!%."rc:URR5nU$)zGet a widget to display a loading indicator. The default implementation will defer to App.get_loading_widget. Returns: A widget in place of this widget to indicate a loading. )rget_loading_widget)r{loading_widgets r~rNWidget.get_loading_widgets779rcU(a3UR5nURS5 URU5 OUR5 URR 5 g)a#Set or reset the loading state of this widget. A widget in a loading state will display a `LoadingIndicator` or a custom widget set through overriding the `get_loading_widget` method. Args: loading: `True` to put the widget into a loading state, or `False` to reset the loading state. z-textual-loading-indicatorN)rN add_classrrrupdate_pointer_shape)r{rloading_indicators r~ set_loadingWidget.set_loadingsK  $ 7 7 9   ' '(D E KK) * MMO ((*rcUR(dURURU5 gURU5 g)z.Called when the 'loading' reactive is changed.N)r call_laterrU)r{rs r~_watch_loadingWidget._watch_loading0s+ OOD,,g 6   W %r ExpectType)boundcgrwrr{rNs r~get_child_by_idWidget.get_child_by_id;s69rcgrwrr{rN expect_types r~r_r`>rcUR5RRU5nUc[SU<35eUcU$[ X25(d [ SU<SUR <SU35eU$)akReturn the first child (immediate descendent) of this node with the given ID. Args: id: The ID of the child. expect_type: Require the object be of the supplied type, or None for any type. Returns: The first child of this node with the ID. Raises: NoMatches: if no children could be found for this ID WrongType: if the wrong type was found. zNo child found with id=zChild with id=" is the wrong type; expected type , found ) _get_dom_baser _get_by_idrBrrCr)r{rNrcrs r~r_r`Cs ""$++66r: =5bV<= =  L%-- &HI]I]H``hinhop  rcgrwrr^s r~get_widget_by_idWidget.get_widget_by_id`s7:rcgrwrrbs r~rkrlcrdrcURSU35nUb0[X25(d [SU<SUR<SU35eU$)aReturn the first descendant widget with the given ID. Performs a depth-first search rooted at this widget. Args: id: The ID to search for in the subtree. expect_type: Require the object be of the supplied type, or None for any type. Returns: The first descendant encountered with this ID. Raises: NoMatches: if no children could be found for this ID. WrongType: if the wrong type was found. #zDescendant with id=rfrg) query_onerrCr)r{rNrcrs r~rkrlhs]&!B4)  ":f+J+J%bV+MkNbNbMeemntmuv  rcURH'n[U5ULdM[X!5(deUs $ [SUSUR35e)a;Get the first immediate child of a given type. Only returns exact matches, and so will not match subclasses of the given type. Args: expect_type: The type of the child to search for. Raises: NoMatches: If no matching child is found. Returns: The first immediate child widget with the expected type. zNo immediate child of type z; )rr(rrB)r{rcrs r~get_child_by_typeWidget.get_child_by_typesS[[EE{k)!%5555 ! 5k]"T[[MRSSr)partialrc X0R;aUcUR"U6nOUR"U6nURnURnUS:ajUR b]U[ R"[R"UR 5URRU5-R5- nURnXW4URU'URUupWU(aU$U$![a Us$f=f)aLGet a *Rich* style for a component. Args: names: Names of components. partial: Return a partial style (not combined with parent). default: A Style to return if any component style doesn't exist. Raises: KeyError: If a component style doesn't exist, and no `default` is provided. Returns: A Rich style object. rQ)rsget_component_stylesKeyError rich_style text_opacitybgcolorr! from_colorr<from_rich_colorcolormultiply_alpha rich_colorpartial_rich_style)r{rtrnamescomponent_stylesrry partial_styles r~get_component_rich_styleWidget.get_component_rich_styles" .. .#'#<## T(aTnO*[TR5HnURv M THnWRU5v M g7f)zFIterate over the styles from the DOM and additional components styles.N)rrrrv)rrcomponent_classesrtr{s r~ iter_styles,Widget.get_visual_style..iter_stylessID ()A)A B"kk)!C-D33D99.sAA backgroundrQr} auto_color)bolddimitalic underlinestrike)rzIterable[StylesBase])_pseudo_classes_cache_keyrtrr<r!has_rulerrtintbackground_tintblendar~r}ry text_stylerget_contrast_text VisualStylerrrrr)r{rtr cache_key visual_stylerr}rrrrrtext_backgroundrs``` r~get_visual_styleWidget.get_visual_styles335FP  4488DI IL Rq!Q*J#sC+EGEG : :&-!??>>)L))&03D3D3I3I..4'O*0*;*;*@*@AWAW*X%/%5%5+Q1B1B-B&(.1##"--2263I3IJ(.12 '1OG$$"LL778K8KLE***L))f.?.?.?+==eggFE-(0'ZZII||//||L3?D $ $Y /rc[U[5(aU$URS5(aTUSSnURH0n[U[5(d [$UR USS9s $ [ SUS35e[R"U5$![ a Mgf=f![a [s$f=f)zA get_style method for use in Content. Args: style: A style prefixed with a dot. Returns: A visual style if one is fund, otherwise `None`. .rQNTrz'No matching component class found for 'r) rr startswithrrrrwr\parse Exception)r{r style_namers r~ _get_styleWidget._get_styles e[ ) )L   C qrJ00!$//  00T0JJ 1!HqQRR $$U+ +     s$BB* B'&B'*B=<B=cgrwrr{ text_contents r~rWidget.render_str"s8;rcgrwrrs r~rr%s from_markuprs r~rr(s( lG , , ""<00rcXRRU4nURRU5nUbU$[ XRXR R US9=oPRU'U$)aArrange child widgets. This method is best left alone, unless you have a deep understanding of what it does. Args: size: Size of container. optimal: Whether fr units should expand the widget (`False`) or avoid expanding the widget (`True`). Returns: Widget locations. )optimal)rr'rqrr.rr)r{rrr cached_result arrangements r~r.Widget.arrange7sq;;//9 //33I>  $ ;B ++t[[%5%5w<  --i8rc8URR5 g)z9Clear arrangement cache, forcing a new arrange operation.N)rqclearrs r~_clear_arrangement_cacheWidget._clear_arrangement_cacheNs %%'rc## URbURv URbURv URbURv gg7f)zGGet widgets not part of the DOM. Returns: An iterable of Widgets. N)rcrbrdrs r~_get_virtual_domWidget._get_virtual_domRsT  % % 1,, ,  # # /** *  ! ! -(( ( .sAAc|[U[5(aX4$[U[5(aURU[5nUR c[ SU<S35e[SUR 5UR RRU54$![a [ U<SU<35Sef=f)aAttempt to locate the point where the caller wants to mount something. Args: spot: The spot to find. Returns: The parent and the location in its child list. Raises: MountError: If there was an error finding where to mount a widget. The rules of this method are: - Given an ``int``, parent is ``self`` and location is the integer value. - Given a ``Widget``, parent is the widget's parent and location is where the widget is found in the parent's ``children``. If it can't be found a ``MountError`` will be raised. - Given a string, it is used to perform a ``query_one`` and then the result is used as if a ``Widget`` had been given. Nz$Unable to find relative location of z because it has no parentr is not a child of ) rintrquery_exactly_onerr|rrrr8r)r{spots r~_find_mount_pointWidget._find_mount_point_s. dC :  dC ))$7D ;; 6th>WX  O$++. 0B0B0H0H0NN N Ox':4(CD$ N Os ":BB;beforeafterc^^UR(dUR(a [U/5$UR(d[ SU<S35eUVs/sHoDR =ncMUPM nn[ [U55[ U5:wa>[U5nUR5HupXUS:dM [ SU<SU<S35e TbTb [ S5eSn Sn TbURT5upOTbURT5upOUn URR"U /UQ7XS .6n S UU4S jjn URXR5 [X 5nURU5 U$s snf) aMount widgets below this widget (making this widget a container). Args: *widgets: The widget(s) to mount. before: Optional location to mount before. An `int` is the index of the child to mount before, a `str` is a `query_one` query to find the widget to mount before. after: Optional location to mount after. An `int` is the index of the child to mount after, a `str` is a `query_one` query to find the widget to mount after. Returns: An awaitable object that waits for widgets to be mounted. Raises: MountError: If there is a problem with the mount request. Note: Only one of ``before`` or ``after`` can be provided. If both are provided a ``MountError`` will be raised. zCan't mount widget(s) before z is mountedNrQzTried to insert z widgets with the same ID z. Widget IDs must be unique.z:Only one of `before` or `after` can be handled -- not bothrc>TcTb>UH7nUR(dUR(dM'UR5 M9 gUH&nUR(dMUR5 M( g)zUpdate order related CSSN)_has_order_style_has_odd_or_evenupdate_node_styles)rrrrs r~ update_styles#Widget.mount..update_styless^!U%6&E--1G1G1G002&&E---002&r)rz list[DOMNode]rr)_closing_pruningrt is_attachedrrNlenrkritemsrr _registerrXdisplayed_children call_next)r{rrr}r widget_id ids_to_mountcountercount insert_before insert_afterr|mountedrrs `` r~mount Widget.mounts6 ==DMMdB' ''>? /  {#e s E:,E:c2SUlUR5 g)z"Request refresh of styles on idle.TN)r] check_idlers r~_refresh_stylesWidget._refresh_styless(,% rcxURR(a [U/5$UR"XUS.6nU$)aMount widgets from an iterable. Args: widgets: An iterable of widgets. before: Optional location to mount before. An `int` is the index of the child to mount before, a `str` is a `query_one` query to find the widget to mount before. after: Optional location to mount after. An `int` is the index of the child to mount after, a `str` is a `query_one` query to find the widget to mount after. Returns: An awaitable object that waits for widgets to be mounted. Raises: MountError: If there is a problem with the mount request. Note: Only one of `before` or `after` can be provided. If both are provided a `MountError` will be raised. r)r_exitrtr)r{r}rrrs r~ mount_allWidget.mount_alls28 88>>dB' 'jj'F rc4UR[X5X#S9$)a0Mount widgets from the result of a compose method. Example: ```python def on_key(self, event:events.Key) -> None: def add_key(key:str) -> ComposeResult: '''Compose key information widgets''' with containers.HorizontalGroup(): yield Label("You pressed:") yield Label(key) self.mount_compose(add_key(event.key)) ``` Args: compose_result: The result of a compose method. before: Optional location to mount before. An `int` is the index of the child to mount before, a `str` is a `query_one` query to find the widget to mount before. after: Optional location to mount after. An `int` is the index of the child to mount after, a `str` is a `query_one` query to find the widget to mount after. Returns: An awaitable object that waits for widgets to be mounted. Raises: MountError: If there is a problem with the mount request. Note: Only one of `before` or `after` can be provided. If both are provided a `MountError` will be raised. r)rr=)r{compose_resultrrs r~ mount_composeWidget.mount_compose sT~~gd;F~XXr)rcgrwr)r{rrrs r~ move_childWidget.move_child8r)rcgrwr)r{rrrs r~rrArrc^UcUc [S5eUbUb [S5eS U4SjjnU"US5nU"[SUcUOU5S5nXLagTRRU5 Ub6TRR TRR U5U5 O8TRR TRR U5S-U5 TR S S 9 g) aMove a child widget within its parent's list of children. Args: child: The child widget to move. before: Child widget or location index to move before. after: Child widget or location index to move after. Raises: WidgetError: If there is a problem with the child or target. Note: Only one of `before` or `after` can be provided. If neither or both are provided a `WidgetError` will be raised. Nz'One of `before` or `after` is required.z/Only one of `before` or `after` can be handled. int | Widgetc>[U[5(aTRUnU$TRR U5nU$![a [ SUSUS35Sef=f![ a [ U<ST<35Sef=f)z+Ensure a given child reference is a Widget.z An index of z for the child to z is out of boundsNr)rrr IndexErrorrr8r)rcalledrr{s r~ _to_widget%Widget.move_child.._to_widgetgs%%%  KK.EL Y ))%0AL" %&ug-?xGXY  "Y% 1DTH&MNTXXYsAA(A%(Bmovez move towardsrQTr)rrrrrr)rrr_remove_insertr8r)r{rrrrtargets` r~rrJs0 >emGH H  E$5OP P &5&) 5=e Dn  ?  E"   KK   1 1& 95 A KK   1 1& 9A =u E D !rc#$# SShvN gN7f)aCalled by Textual to create child widgets. This method is called when a widget is mounted or by setting `recompose=True` when calling [`refresh()`][textual.widget.Widget.refresh]. Note that you don't typically need to explicitly call this method. Example: ```python def compose(self) -> ComposeResult: yield Header() yield Label("Press the button below:") yield Button() yield Footer() ``` rNrrs r~r=Widget.composes" rcr# UR(a SUlUR5IShvN ggN7f)z!Check if a recompose is required.FN)r\ recomposers r~_check_recomposeWidget._check_recomposes.  # #',D $.." " " $ "s ,757c# UR(aUR(agUR5IShvN URS5R S5R 5IShvN UR(a$[ U5nURU5IShvN SSS5IShvN gNNLNN !,IShvN (df  g=f7f)zbRecompose the widget. Recomposing will remove children and call `self.compose` again to remount. N*z.-textual-system)rrbatchquery_childrenexcluderr=r)r{ compose_nodess r~rWidget.recomposes 4== ::<<%%c*223EFMMO O O ' nn]333  << O4  <<&>&NON %''% 5 &N!!V+0G0G80S//&"B"BB!2!9!9966!)*;*B*B!C"MMM*22MM)8N&--/  ! Xa[IN  !    !%%.. ( ##22 >d33     uY/ /  " 0rc0[USUR5$rT)rO max_scroll_xr{values r~validate_scroll_xWidget.validate_scroll_xUAt0011rcB[[USUR55$rT)rUrOrarbs r~validate_scroll_target_xWidget.validate_scroll_target_xU5!T%6%6788rc0[USUR5$rT)rOrrbs r~validate_scroll_yWidget.validate_scroll_yrfrcB[[USUR55$rT)rUrOrrbs r~validate_scroll_target_yWidget.validate_scroll_target_yrjrc[SURRURRUR- - 5$)z The maximum value of `scroll_x`.r)r% virtual_sizercontainer_sizer#rs r~raWidget.max_scroll_xsC    # #""((4+G+GG I  rc[SURRURRUR- - 5$)z The maximum value of `scroll_y`.r)r%rrrrsr,rs r~rWidget.max_scroll_ysC    $ $""))D,J,JJ L  rcxURRUR:H=(d UR(+$)z/Is the vertical scroll position at the maximum?) scroll_offsetyrrrs r~is_vertical_scroll_endWidget.is_vertical_scroll_end,!!##t'8'88I MIrcxURRUR:H=(d UR(+$)z1Is the horizontal scroll position at the maximum?)rxxrarrs r~is_horizontal_scroll_endWidget.is_horizontal_scroll_endr|rcf[UR=(a URR5$z,Is the user dragging the vertical scrollbar?)rrbgrabbedrs r~is_vertical_scrollbar_grabbed$Widget.is_vertical_scrollbar_grabbeds&D,,Q1I1I1Q1QRRrcf[UR=(a URR5$r)rrcrrs r~is_horizontal_scrollbar_grabbed&Widget.is_horizontal_scrollbar_grabbeds&D..U43M3M3U3UVVrcSSKJn URb UR$U"5UlURR XR5 UR$)zThe scrollbar corner. Note: This will *create* a scrollbar corner if one doesn't exist. Returns: ScrollBarCorner Widget. r)rf)textual.scrollbarrfrdr _start_widget)r{rfs r~scrollbar_cornerWidget.scrollbar_cornersN 6  ! ! -)) )!0!2 t%;%;<%%%rcSSKJn URb UR$U"SSURS9=UlnSURlUR R X5 U$)zThe vertical scrollbar (create if necessary). Note: This will *create* a scrollbar if one doesn't exist. Returns: ScrollBar Widget. rreTverticalrr thicknessF)rrerbr#rrrr{re scroll_bars r~r]Widget.vertical_scrollbarsh 0  # # /++ +09 d6R6R1   :,1  ( t0rcSSKJn URb UR$U"SSURS9=UlnSURlUR R X5 U$)zzThe horizontal scrollbar. Note: This will *create* a scrollbar if one doesn't exist. Returns: ScrollBar Widget. rrF horizontalr)rrercr,rrrrs r~rSWidget.horizontal_scrollbarsh 0  % % 1-- -2;9W9W3  "Z.3""* t0rcUR(aUR(dgURnURnURnUR upESnUS:XaSnO(US:XaSnOUS:XaUR RU:nSnUS:XaSnO(US:XaSnOUS:XaUR RU:nUnUn US:XaUS:XaXg4UR;drUS:Xa3U(a,U(d%UR RXAR- :nUS:Xa3U(a,U(d%UR RXQR- :nURU:wdURU:waURRX45 OURR5 X`l Xpl UR cU(aX`R"lUR&cU(aXpR(lgg)zRefresh scrollbar visibility.NFhiddenscrollTr)rrsrr!r+rWrrrrrwr#r,rraddrrcrSrrbr]) r{rr!r+rrshow_horizontal show_vertical_show_horizontal_show_verticals r~_refresh_scrollbarsWidget._refresh_scrollbarss!!)<)< && && ,,   !#O 8 #"O 6 !"//55=O  !!M 8 # M 6 ! --44v=M*& & f$ 0D4K4KKV# o"&"3"3"9"9:::#V# $ 1 1 8 8===!  * *o =++}<  # # ' ')9(J K  # # ) ) +)8&'4$  % % 1_0? % % -  # # /=.; # # +4ArcVUR(dgURUR4$)zA tuple of booleans that indicate if scrollbars are enabled. Returns: A tuple of (, ) )FF)rrrrs r~scrollbars_enabledWidget.scrollbars_enabled[s'!!,,d.L.LMMrc2URUR4$)z?The number of cells occupied by scrollbars for width and height)r#r,rs r~scrollbars_spaceWidget.scrollbars_spacegs,,d.L.LMMrcURnURS:XaURS:Xa UR$UR(a UR$S$)zkGet the width used by the *vertical* scrollbar. Returns: Number of columns in the vertical scrollbar. rrr)rr"r+r#rr{rs r~r#Widget.scrollbar_size_verticallsN  " "h .63D3D3N11 1151M1Mv--TSTTrcXURnUR(a UR$S$)zmGet the height used by the *horizontal* scrollbar. Returns: Number of rows in the horizontal scrollbar. r)rrr,rs r~r, Widget.scrollbar_size_horizontalxs'373Q3Qv//XWXXrcF[SURURS5$)zNSpacing required to fit scrollbar(s). Returns: Scrollbar gutter spacing. r)rNr#r,rs r~r"Widget.scrollbar_gutters& t++T-K-KQ  rcHURRUR-$)zaSpacing for padding / border / scrollbars. Returns: Additional spacing around content area. )rrr"rs r~r Widget.gutters{{!!D$9$999rc.URR$z?The size of the content area. Returns: Content area size. )content_regionrrs r~r Widget.sizes""'''rc.URR$)zKThe size of the scrollable content. Returns: Scrollable content size. )scrollable_content_regionrrs r~scrollable_sizeWidget.scrollable_sizes--222rcUR$)zQThe size of the widget (including padding and border). Returns: Outer size. )rVrs r~ outer_sizeWidget.outer_sizeszzrcUR$)zIThe size of the container (parent widget). Returns: Container size. )rWrs r~rsWidget.container_sizes###rcdURRURR5nU$)zGets an absolute region containing the content (minus padding and border). Returns: Screen region that contains a widget's content. )regionrrrr{rs r~rWidget.content_regions(++DKK,>,>?rcURRURR5RUR5nU$)zGets an absolute region containing the scrollable content (minus padding, border, and scrollbars). Returns: Screen region that contains a widget's content. )rrrrr"rs r~r Widget.scrollable_content_regions>++DKK,>,>?FF  ! ! rcHURRup[X5$)zfAn offset from the Widget origin where the content begins. Returns: Offset from widget's origin. )rtop_leftrKr{r~rys r~content_offsetWidget.content_offsets{{##a|rctURRURR5R$r)rrrrrrs r~ content_sizeWidget.content_sizes){{!!$++"4"45:::rcURRU5Rupp4X!4$![[R 4a gf=f)z,>,>)))#xrc.URR$)z>Get the current console. Returns: A Rich console object. )rrrs r~_consoleWidget._consolea sxxrcRUR(dgURHnURRS:XaMURnURS:XaM=UR nUcMNUR (d&UR(dMrUR(dM g g)z3Do any children (or progeny) have a relative width?FrnoneT) rDrrr rris_relative_widthrr$)r{rrrs r~r$#Widget._has_relative_children_widthj s  ]]E||""i/\\F~~'LLE}'' %"D"D"D#rcUR(dgURHinURnURS:XaM!URnUcM2UR (d&UR (dMVUR(dMi g g)z4Do any children (or progeny) have a relative height?FrT)rDrrrris_relative_heightrr-)r{rrrs r~r-$Widget._has_relative_children_height~ sl  ]]E\\F~~']]F~((5#F#F#F#rc|URRU5 g![[R4a gf=f)z:Check if the node was displayed in the last screen update.FT)rrrGr&rrs r~ is_on_screenWidget.is_on_screen s;  KK # #D )&//*  s ;;c.SnSnSnSnURn XRR-nU RS:XaU RRupOS=pU R bU R R XU5U - nU RbU RR XU5U - nU RbU RR XU5U - nU RbU RR XU5U - n[XVXx5n U $)zResolve minimum and maximum values for width and height. Args: container: Size of outer widget. viewport: Viewport size. width_fraction: Size of 1fr width. height_fraction: Size of 1fr height. Returns: Extrema object. Nrr) rrrrrr;rr&r<r.r4) r{r0r1r2r3r;r&r<r.r gutter_width gutter_heightr:s r~rWidget._resolve_extrema s2&&* %) &* &* ]])))    ,*0--*>*> 'L-+, ,L    '  ((nM     '  ((nM     (!!)))O      (!!)))O   ) Gr.rn final_valuedurationspeeddelayeasing on_completelevelc URc*URRRU5UlURceURUUUUUUUUU S9 g)aAnimate an attribute. Args: attribute: Name of the attribute to animate. value: The value to animate to. final_value: The final value of the animation. Defaults to `value` if not set. duration: The duration (in seconds) of the animation. speed: The speed of the animation. delay: A delay (in seconds) before the animation starts. easing: An easing method. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Nr )r_ranimatorbind) r{ attributercr r r r rrrs r~rWidget.animate sf4 ==  HH--2248DM}}(((  ##  rcl# URRRXU5IShvN gN7f)zStop an animation on an attribute. Args: attribute: Name of the attribute whose animation should be stopped. complete: Should the animation be set to its final value? Note: If there is no animation scheduled or running, this is a no-op. N)rrstop_animation)r{rcompletes r~rWidget.stop_animation s'hh..tIIIs *424cTURR=(d UR$)z\Get the layout object if set in styles, or a default layout. Returns: A layout object. )rrr^rs r~r Widget.layout s{{!!9T%9%99rcjURRSL=(d [UR5$)z4Is this widget a container (contains other widgets)?Nrrrrrs r~rDWidget.is_container '{{!!-Bdkk1BBrcjURRSL=(d [UR5$)zCan this widget be scrolled?Nrrs r~rWidget.is_scrollable rrc[5nURHdn[U[5(d gURUR :wdUR UR:wa gXR- S:dMd g g)z#Is this widget currently scrolling?T皙?F) r rrrrscroll_target_xrrr)r{ current_timers r~ is_scrollingWidget.is_scrolling sp!{ NNDdF++ !5!55==D$8$88444s:#rc@URR=(d S$)zAGet the name of this widgets layer. Returns: Name of layer. r)rlayerrs r~r) Widget.layer, s{{  -I-rcSnURHSn[U[5(d U$URR S5(dM=URR nMU U$)z;Layers of from parent. Returns: Tuple of layer names. rlayers)rrrrrr,)r{r,rs r~r, Widget.layers5 s]#/,,DdF++ {{##H--++ -  rcURnURup#X1R-nUUR(a%UR UR R 5O UR -nUR[R"URURR (a UROS5-nU$)z*Style of links. Returns: Rich style. N) rbackground_colorslink_backgroundauto_link_colorr link_colorrrr!r{r)r{rrrr0r2rs r~rWidget.link_styleD s.. $'='==$%%  - -f.?.?.A.A B"" !!E$4$4  ! !*0*@*@*B*BO & &%   rcPURnURup#X1R-nUUR(a%UR UR R 5O UR -nUR[R"URUR5-nU$)zFStyle of links underneath the mouse cursor. Returns: Rich Style. ) rr/link_background_hoverauto_link_color_hoverrlink_color_hoverrlink_style_hoverr!r{r)r{rrrhover_background hover_colorrs r~r8Widget.link_style_hoverY s.. %(D(DD&++  . .v/F/F/H/H I(( ''%*:*:  " "  ' '+   rcUnURH/n[U[5(dMUR(dM-Us $ U$)zeThe widget's container used when selecting text.. Returns: A widget which contains this widget. )rrrr)r{r0rs r~select_containerWidget.select_containern s<! nnF&&))f.B.B.B %rcU(a|URnUVs/sHo3RU5PM nnURRU5 URRU5 UR R "U6 gURR5 URR5 UR R5 UR R URR5 URnURRUR5 U(a&URRUR5 ggs snf)zSet the Widget as 'dirty' (requiring re-paint). Regions should be specified as positional args. If no regions are added, then the entire widget will be considered dirty. Args: *regions: Regions which require a repaint. N) r translaterlupdatermrr set_dirtyrrrrr)r{regionsrrwidget_regionsrs r~ _set_dirtyWidget._set_dirty{ s  !00NMTUW6..~>WNU    & &~ 6  ! ! ( ( 8    ( (. 9    % % '  ! ! ' ' )    $ $ &    ( ()9)9 :J    # #J$5$5 6%%))**;*;<VsE cnURR5nURR5 U$)zlGet a copy of the regions which need a repaint, and clear internal cache. Returns: Regions to repaint. )rmcopyr)r{rCs r~_exchange_repaint_regions Widget._exchange_repaint_regions s/ '',,. ##%rbasicrr r rforcerrrc ^^U (aTR5 USL=(a TR=(d Un USL=(a TR=(d Un S=pTRRnUR TS5 UR TS5 S UU4SjjnU(aUcUcSnUc[ nU (aWUceUTlUTR:wa;TRR5 TRSTRUUUUU S9 Sn U (aWUceUTl UTR:wa;TRR5 TRSTRUUUUU S9 SnOU (a.UceTRnU=TlTlUTR:gn U (a.UceTRnU=Tl Tl UTR:gn[5TlTbTRT5 U =(d U$) a(Scroll to a given (absolute) coordinate, optionally animating. Args: x: X coordinate (column) to scroll to, or `None` for no change. y: Y coordinate (row) to scroll to, or `None` for no change. animate: Animate to new scroll position. speed: Speed of scroll if `animate` is `True`. Or `None` to use duration. duration: Duration of animation, if `animate` is `True` and speed is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). release_anchor: If `True` call `release_anchor`. Returns: `True` if the scroll position changed, otherwise `False`. NFrrc>TRR5 [5TlTbTR T5 gg)z*set last scroll time, and invoke callback.N)r_realtime_animation_completer rrrr{sr~_animate_on_complete/Widget._scroll_to.._animate_on_complete s4 HH 1 1 3%.[D "&{+'r2)r r rrrTr)rrrrrforce_stop_animationr3r$r_realtime_animation_beginrrrr rcall_after_refresh)r{r~ryrr r rrMrrrmaybe_scroll_xmaybe_scroll_y scrolled_x scrolled_yrrRrrs` ` r~ _scroll_toWidget._scroll_to s@     !$RD,H,H,QE$PD,F,F,O%"'' 88$$%%dJ7%%dJ7 , , EM~.}$}'($ %HH668LL",,#!)%$8#!"&J}$}'($ %HH668LL",,#!)%$8#!"&J}$}==788$t}%6 }$}==788$t}%6 %.[D "&'' 4'Z'rcUR$)z|Check if this widget permits text selection. Returns: `True` if the widget supports text selection, otherwise `False`. )rrs r~ allow_selectWidget.allow_select s   rcg)zThis method id called prior to a layout operation. Implement this method if you want to make updates that should impact the layout. Args: layout: The [Layout][textual.layout.Layout] instance that will be used to arrange this widget's children. Nr)r{rs r~ pre_layoutWidget.pre_layout rcUb)UR[R[U55 Ub*UR[R[U55 gg)a'Set the scroll position without any validation. This is a low-level method for when you want to see the scroll position in the next frame. For a more fully featured method, see [`scroll_to`][textual.widget.Widget.scroll_to]. Args: x: Desired `X` coordinate. y: Desired `Y` coordinate. N)r}rrrUrrs r~ set_scrollWidget.set_scroll sC =   foouQx 8 =   foouQx 8 r) rr r rrMrrrrc 4U (aUR5 URRn UbU RUS5 UbU RUS5 U (aUR UUUUUUUUU S9 gUR URUUUUUUUUU S9 g)aScroll to a given (absolute) coordinate, optionally animating. Args: x: X coordinate (column) to scroll to, or `None` for no change. y: Y coordinate (row) to scroll to, or `None` for no change. animate: Animate to new scroll position. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. release_anchor: If `True` call `release_anchor`. Note: The call to scroll is made after the next refresh. Nrrrr r rrMrr)rrrrUr\rW) r{r~ryrr r rrMrrrrrs r~ scroll_toWidget.scroll_to+ sD     !88$$ =  ) )$ ; =  ) )$ ;  OO!'    # #!' $ rrr r rrMrrrc |URUcSOURU-UcSOURU-UUUUUUU U S9 g)aScroll relative to current position. Args: x: X distance (columns) to scroll, or ``None`` for no change. y: Y distance (rows) to scroll, or ``None`` for no change. animate: Animate to new scroll position. speed: Speed of scroll if `animate` is `True`. Or `None` to use `duration`. duration: Duration of animation, if animate is `True` and speed is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. Nrl)rjrr) r{r~ryrr r rrMrrrs r~scroll_relativeWidget.scroll_relativen sQ: IDDMMA$5IDDMMA$5#  r) rr r rrMrrrx_axisy_axisc hUcUcSnURU (aSOSU (aSOSUUUUUUUUS9 g)aScroll to home position. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use duration. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. x_axis: Allow scrolling on X axis? y_axis: Allow scrolling on Y axis? Nrrrl)rj) r{rr r rrMrrrrprqs r~ scroll_homeWidget.scroll_home sJ: =X-H ATAT#  rc ^^^^^^^^^ ^ ^ TcTcSmSUU4Sjjm SUUUUUU UUU U 4 Sjjn TR(aTR(aSTlU(aU "5 gTRU 5 g)aScroll to the end of the container. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. x_axis: Allow scrolling on X axis? y_axis: Allow scrolling on Y axis? Nrc8># TbTRT5 gg7f)z>It's possible new content was added before we reached the end.N)rrQsr~scroll_end_on_complete1Widget.scroll_end..scroll_end_on_complete s&{+'sc n> TRT(aSOST (a TROSTTTTTTTSS9 g)z Scroll to the end of the widget.rNFrL)r\r) rr rrMrrwr{r rprqs r~_lazily_scroll_end-Widget.scroll_end.._lazily_scroll_end s@ OO%+!!!2$  rFr)rrrW) r{rr r rrMrrrrprqrzrws ```````` `` @r~rWidget.scroll_end s_> =X-H , ,    >>d33$)D !    # #$6 7rc LURURS- UUUUUUUUS9 g)arScroll one cell left. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. rQ r~rr r rrMrrrNrjr$ r{rr r rrMrrrs r~ scroll_leftWidget.scroll_left ;2 ""Q&#  rric pURURURR- UUUUUUUS9$)aScroll left one position, taking scroll sensitivity into account. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Returns: `True` if any scrolling was done. Note: How much is scrolled is controlled by [App.scroll_sensitivity_x][textual.app.App.scroll_sensitivity_x]. r~rr r rrMrrr\r$rscroll_sensitivity_xr{rr r rrMrrs r~_scroll_left_for_pointerWidget._scroll_left_for_pointer- G:""TXX%B%BB#  rc LURURS-UUUUUUUUS9 g)aqScroll one cell right. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. rQr~Nrrs r~ scroll_rightWidget.scroll_rightU rrc pURURURR-UUUUUUUS9$)aScroll right one position, taking scroll sensitivity into account. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Returns: `True` if any scrolling was done. Note: How much is scrolled is controlled by [App.scroll_sensitivity_x][textual.app.App.scroll_sensitivity_x]. rrrs r~_scroll_right_for_pointer Widget._scroll_right_for_pointerz rrc LURURS-UUUUUUUUS9 g)arScroll one line down. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. rQ ryrr r rrMrrrNrjrrs r~ scroll_downWidget.scroll_down rrc rURURURR-UUUUUUUSS9 $)aScroll down one position, taking scroll sensitivity into account. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Returns: `True` if any scrolling was done. Note: How much is scrolled is controlled by [App.scroll_sensitivity_y][textual.app.App.scroll_sensitivity_y]. F) ryrr r rrMrrrr\rrscroll_sensitivity_yrs r~_scroll_down_for_pointerWidget._scroll_down_for_pointer sJ:""TXX%B%BB#   rc LURURS- UUUUUUUUS9 g)anScroll one line up. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and speed is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. rQrNrrs r~ scroll_upWidget.scroll_up rrc pURURURR- UUUUUUUS9$)aScroll up one position, taking scroll sensitivity into account. Args: animate: Animate scroll. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and speed is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Returns: `True` if any scrolling was done. Note: How much is scrolled is controlled by [App.scroll_sensitivity_y][textual.app.App.scroll_sensitivity_y]. ryrr r rrMrrrrs r~_scroll_up_for_pointerWidget._scroll_up_for_pointer rrc rURURURR- UUUUUUUS9 g)aScroll one page up. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). rNrjrrrrs r~scroll_page_upWidget.scroll_page_up= B, mmd<<CCC#  rc rURURURR-UUUUUUUS9 g)aScroll one page down. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). rNrrs r~scroll_page_downWidget.scroll_page_down^ rrc UcUcSnURURURR- UUUUUUUS9 g)aScroll one page left. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). N333333?rrjrrrrs r~scroll_page_leftWidget.scroll_page_left Q, =X-H mmd<<BBB#  rc UcUcSnURURURR-UUUUUUUS9 g)aScroll one page right. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). Nrrrrs r~scroll_page_rightWidget.scroll_page_right rr) rr r rcenterrorigin_visiblerMrrrc URn SnU R(dU bURU 5 g[UR[ 5(GamXLGahU (dU$URnUR RS:wa [SS5nO.URU URUUUUUUUU U U U S9 nU(aSnU RU*5RUR RR5RUR RRR5RURR 5R#UR R5R%UR5n Un[UR[ 5(aXLaGMhU$)aScroll scrolling to bring a widget into view. Args: widget: A descendant widget. animate: `True` to animate, or `False` to jump. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. top: Scroll widget to top of container. origin_visible: Ensure that the top left of the widget is within the window. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. Returns: `True` if any scrolling has occurred in any descendant, otherwise `False`. Frr) spacingrr r rrrrrMrrrT)rrrWrr|rrdockrKscroll_to_regionrr@rrborderrrr intersection)r{rrr r rrrrrMrrrrscrolledr0rxs r~scroll_to_widgetWidget.scroll_to_widget sH22{{&'' 4//F4FNK I}}!!V+ &q! ) : :"..#%!!#1 +'!;! !#H $$m^4Yy//66??@Yy//66>>GGHYyCCJJKi&&--.iBBC FQ//F4FRr)rrr r rrrrrMrrrprqrc ^TRRTR5nUbURU5nUU;a,U(d%U(dU bTR U 5 [ 5$S U4SjjnU(aUR unnUR unnU"[ [UU- S-5[UU- S-555nU (a;URURU5;aU"[R"UUSS95nOU"[R"UXS95nTR(dU (d[ SUR5nTR(dU (d[ URS5nU(a^U (a UROSnU(a UROSnUcUcSnTR!U=(d SU=(d SUUUUU U U US9 U$U bTR U 5 U$) acScrolls a given region into view, if required. This method will scroll the least distance required to move `region` fully within the scrollable area. Args: region: A region that should be visible. spacing: Optional spacing around the region. animate: `True` to animate, or `False` to jump. speed: Speed of scroll if `animate` is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. top: Scroll `region` to top of container. origin_visible: Ensure that the top left of the widget is within the window. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). x_axis: Allow scrolling on X axis? y_axis: Allow scrolling on Y axis? immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. Returns: The distance that was scrolled. Nc>TRup[[XR-STR5U- [X R -STR 5U- 5nU$)z0Clamp the delta to avoid scrolling out of range.r)rxrKrOr~raryr)deltarrr{s r~ clamp_delta,Widget.scroll_to_region..clamp_deltaQs^!%!3!3 Hh(!T->->?(Jh(!T->->?(JELrg?T)rrg?rl)rrKrrK)rrrxrrWrKrrrr@rLget_scroll_to_visiblerryrr~rn)r{rrrr r rrrrrMrrrprqrwindowrregion_center_xregion_center_ywindow_center_xwindow_center_yrdelta_xdelta_ys` r~rWidget.scroll_to_regionsX//99$:L:LM  ]]7+F V SF&'' 48O  /5}} ,O_/5}} ,O_/9C?@/9C?@E 6==8H8H8O#O#00TJ ,,VVEE++E1egg&E))%577A&E !'eggQG!'eggQG}!1  44!'# !  &'' 4 r)r r rrrMrrrc URn [U [5(abUR(a#URR UUUUUUUUUU S9 gU R URR UUUUUUUUUU S9 gg)aScroll the container to make this widget visible. Args: animate: Animate scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. top: Scroll to top of container. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. ) rr r rrrMrrrN)r|rrrVrrrW) r{rr r rrrMrrrr|s r~scroll_visibleWidget.scroll_visibles6 ff % %zz ,,#%! +'- ))KK00#%! +'* # &r)r r rrMrrrrc6URUUUUUUSUUU U S9 g)azScroll this widget to the center of self. The center of the widget will be scrolled to the center of the container. Args: widget: The widget to scroll to the center of self. animate: Whether to animate the scroll. speed: Speed of scroll if animate is `True`; or `None` to use `duration`. duration: Duration of animation, if `animate` is `True` and `speed` is `None`. easing: An easing method for the scrolling animation. force: Force scrolling even when prohibited by overflow styling. origin_visible: Ensure that the top left corner of the widget remains visible after the scroll. on_complete: A callable to invoke when the animation is finished. level: Minimum level required for the animation to take place (inclusive). immediate: If `False` the scroll will be deferred until after a screen refresh, set to `True` to scroll immediately. T) rrr r rrMrrrrrN)r) r{rrr r rrMrrrrs r~scroll_to_centerWidget.scroll_to_centers9@ )#  rcNXLagXRRR;agURnUn[ UR [ 5(aOX0LaKX#R R;agUR n[ UR [ 5(aX0LaMKg)alCheck if a given widget is *fully* within the current view (scrollable area). Note: This doesn't necessarily equate to a widget being visible. There are other reasons why a widget may not be visible. Args: widget: A widget that is a descendant of self. Returns: `True` if the entire widget is in view, `False` if it is partially visible or not in view. TF)r _compositorvisible_widgetsrrr|rrr{rrrs r~can_view_entireWidget.can_view_entires > 00@@ @f--$2B[[BBB;;Df--$2BrcXLagXRRR;dUR(dgURnUn[ UR [5(a`X0La\URUR R5(dgUR n[ UR [5(aX0LaM\g)aCheck if a given widget at least partially visible within the current view (scrollable area). Args: widget: A widget that is a descendant of self. Returns: `True` if any part of the widget is visible, `False` if it is outside of the viewable area. TF) rrrrrrr|roverlapsrrs r~can_view_partialWidget.can_view_partial s > 00@@ @f--$2B??4;;#H#HII;;Df--$2BrcX>URnUSR5(d&URS5(d[SU<S35e[TU]UUS9 UR Sn[U[5(a-Uc UROUUl Uc UROUUl gg)NrrzWidget subclass z) should be capitalized or start with '_'.) inherit_cssinherit_bindings) risupperrrrx__init_subclass____mro__ issubclassrr r )rr r rrrbasers r~rWidget.__init_subclass__%s||Aw  )=)="4(*ST  !#- " {{1~ dF # #.7.?DNNYCM&-'''  " $rc## SURS4v UR(aSUR4v UR(a SSRUR54v gg![a gf=f7f)NrNrrO )rNrrOjoinAttributeErrorrs r~rWidget.__rich_repr__?sf % %yydii''||$,,!777   s)A8A"A(&A8( A52A84A55A8cURup#URnURnURn[ U=(a U5n[ U=(a U5nUR S:XaSnURnU(a"U(aUR U*U*5un nU$U(aURU*5upU$U(aURU*5upU$)zAdjusts the Widget region to accommodate scrollbars. Args: region: A region for the widget. Returns: The widget region minus scrollbars. rT) rrr,r#rr"rsplit_verticalsplit_horizontal)r{rrrrr,r#rs r~_get_scrollable_regionWidget._get_scrollable_regionIs>B=T=T:$*$D$D!"("@"@"& # ?(?# %) % C*C% !  " "h .&* #&,&D&D # $)@$ll((**OFAq! %--/F.FGIF '//1J0JKIF rc## URup#URnURn[U=(a U5n[U=(a U5nU(aU(aUR UR U- UR U- 5unnnn U (aURU 4v U(a=URn URR U l UR U l X4v U(a>URn URR U l UR U l X4v ggU(afURUR U- 5upkU (a>URn URR U l UR U l X4v ggU(afURUR U- 5upkU (a>URn URR U l UR U l X4v ggg7f)zArrange the 'chrome' widgets (typically scrollbars) for a layout element. Args: region: The containing region. Returns: Tuples of scrollbar Widget and region. N)rr,r#rrrrrr]rrwindow_virtual_size window_sizerSrr) r{rrrr,r#rvertical_scrollbar_regionhorizontal_scrollbar_regionscrollbar_corner_gap scrollbarscrollbar_regions r~_arrange_scrollbarsWidget._arrange_scrollbarsos>B=T=T:$($B$B!"&">">"& # ?(?# %) % C*C% ! %)@   66 99  )+$ $++-AAA( 33 040A0A0H0H -(5(<(< %::* 55 040A0A0G0G -(5(;(; %<< + %.4.C.C 66/ +M  33 040A0A0H0H -(5(<(< %11  '.4.E.E 99/ +M  55 040A0A0G0G -(5(;(; %11  'sH H cUnSn[U[5(a7UR(aSnO#URn[U[5(aM7[ U(+UR UR S9nU$)zGet an object describing whether each pseudo class is present on this object or not. Returns: A PseudoClasses object describing the pseudo classes that are present. FT)rrr)rrrrxrrr)r{rrpseudo_classess r~get_pseudo_class_stateWidget.get_pseudo_class_statesk $(v&&}}<>>##% !!"2H=   s:ACC21C2cURR5 URU:wd URU:wdURU:wa}URU:waUR 5 XlU(aX lO UR [RU5 X0lUR(aURU5 gg)aCalled when the widget's size is updated. Args: size: Screen size. virtual_size: Virtual (scrollable) size. container_size: Container size (size of parent). layout: Perform layout if required. Returns: True if a resize event should be sent, otherwise False. TF) rgrrVrrrWrEr}rr_scroll_update)r{rrrrsrs r~ _size_updatedWidget._size_updateds   " JJ$   L0##~5zzT!!J$0!!!&"5"5|D#1 !!##L1rcUR5 URup#UR(amURR(aRUR UR lX0R- UR l UR R5 UR(amURR(aRURURlX R- URl URR5 URUR5UlUR!UR"5Ulg)zTUpdate scrollbars visibility and dimensions. Args: virtual_size: Virtual size. N)rrsrrr#rr]rr,rrrrrSrdrrlr)r{rrrrs r~rWidget._scroll_update1s   "++   ' 'DKK,O,O:F:M:MD # # 7777  # # /  # # + + -  ) )dkk.S.S>)L))&03D3D3I3I..4'O))..v/E/EF$nW-.J'1OG$$"LLE***L))f.?.?.?+==eggFE#;&"-ZZII|| //|| "D !!!rcUR5n[U[[45(a [ U5nOgUR U5S4$)aGet the text under the selection. !!! note Implement this method if are building custom widget. If you just want to get the currently selected text, then see [`Screen.get_selected_text`](textual.screen.Screen.get_selected_text) Args: selection: Selection information. Returns: Tuple of extracted text and ending (typically " " or " "), or `None` if no text could be extracted. N )rErr"r>rextract)r{ selectionrGrs r~ get_selectionWidget.get_selectionusB ftWo . .v;D  &,,rc$UR5 g)zmCalled when the selection is updated. Args: selection: Selection information or `None` if no selection. N)r)r{r"s r~selection_updatedWidget.selection_updateds rcURupUR5n[R"XXUR5n[ URU5UlURR5 g)zRender all lines.N) rrEr] to_stripsrrrjrlr)r{rrrGstripss r~_render_contentWidget._render_contentsW !!$t?P?PQ)$))V< !!#rcUR(a?[R"URRUR R 5$UR(aUR5 URRUnU$![aC [R"URRUR R 5nU$f=f)z]Render a line of content. Args: y: Y Coordinate of line. Returns: A rendered line. ) r r[blankrrrrxrlr+rjrr)r{rylines r~ render_lineWidget.render_lines ::;;tyy0A0A0L0LM M     " N%%++A.D  N;;tyy0A0A0L0LMD  Ns3BA CCcUR(aE[R"URURR 5/UR -nU$URRX5nU$)zRender the widget into lines. Args: crop: Region within visible area to render. Returns: A list of list of segments. ) r r[r.rrrxrrr render_widget)r{cropr*s r~ render_linesWidget.render_liness` :: DJJ(9(9(D(DE F  ''55dAF rc[X5nX0RR-nURR"U6upVXPLa [ 5$URR "U6$)zGet the Rich style in a widget at a given relative offset. Args: x: X coordinate relative to the widget. y: Y coordinate relative to the widget. Returns: A rich Style object. )rKrrr get_widget_atr! get_style_at)r{r~ryr screen_offsetrrs r~r9Widget.get_style_atsW!3!33 KK--}=   7N{{''77rc&SURlg)zSuppress a click event. This will prevent a [Click][textual.events.Click] event being sent, if called after a mouse down event and before the click itself. N)r_mouse_down_widgetrs r~suppress_clickWidget.suppress_clicks'+#rcFUR5 URU5 grw)_set_forwarded post_messager{events r~_forward_eventWidget._forward_events  % rc2SUlUR5 g)zRefreshes the scroll position.TN)r[rrs r~rVWidget._refresh_scrolls $ r)rrrcU(a-UR(dSUlU=RS- slU(a$SUlURUR5 U$UR (dSUlUR5 U$URR5 U(a@UR"U6 UR5 URR5 SUlUR5 U$)aInitiate a refresh of the widget. This method sets an internal flag to perform a refresh, which will be done on the next idle event. Only one refresh will be done even if this method is called multiple times. By default this method will cause the content of the widget to refresh, but not change its size. You can also set `layout=True` to perform a layout. !!! warning It is rarely necessary to call this method explicitly. Updating styles or reactive attributes will do this automatically. Args: *regions: Additional screen regions to mark as dirty. repaint: Repaint the widget (will call render() again). layout: Also layout widgets in the view. recompose: Re-compose the widget (will remove and re-mount children). Returns: The `Widget` instance. TrQ) rXrYr\rrrrZrrgrrErKrs)r{rrrrCs r~rWidget.refreshs< $//$(D !  A % '+D $ NN400 1K%)D " OO K   "  OOW %  ( ( *  " " ( ( *%)D "  rcLURRXRS9nU$)zRemove the Widget from the DOM (effectively deleting it). Returns: An awaitable object that waits for the widget to be removed. )r|)r_prunerx)r{ await_removes r~r Widget.removes" xxtLLA rcL[U5(a![U[5(a URn[ U[ 5(a:[ U5nURVs/sHn[X#5(dMUPM nnOUnURR"USU06nU$s snf)zRemove the immediate children of this Widget from the DOM. Args: selector: A CSS selector or iterable of widgets to remove. Returns: An awaitable object that waits for the direct children to be removed. r|) callablerrrrrrArr@rrL)r{selectorparsed_selectorsrchildren_to_removerMs r~remove_childrenWidget.remove_children#s H  *Xv">">((H h $ $.x8 #'=="#0%E:J4R= " "* xx(:H4H  "s B!8B!c# URIShvN URR5 S7v SSS5 SSS5IShvN gN=!,(df  N!=fN!,IShvN (df  g=f7f)aiAsync context manager that combines widget locking and update batching. Use this async context manager whenever you want to acquire the widget lock and batch app updates at the same time. Example: ```py async with container.batch(): await container.remove_children(Button) await container.mount(Label("All buttons are gone.")) ``` N)rr batch_updaters r~r Widget.batch>sC999&&()99((999sZBABA&AA& B A$ B A! A&$B&A=,A/ - A=9BcUR(akURR(a8URRSS:waURR U5$[ UR S5$UR$)a@Get [content](/guide/content) for the widget. Implement this method in a subclass for custom widgets. This method should return [markup](/guide/content#markup), a [Content][textual.content.Content] object, or a [Rich](https://github.com/Textualize/rich) renderable. Example: ```python from textual.app import RenderResult from textual.widget import Widget class CustomWidget(Widget): def render(self) -> RenderResult: return "Welcome to [bold red]Textual[/]!" ``` Returns: A string or object to render as the widget's content. rrrQ)rDrrkeylinerender_keylinerXr/css_identifier_styledrs r~r Widget.renderPsg*   {{!!dkk&9&9!&<&F{{11$77T33A677)))rcSnURRUS5nUb[U[5(deU$[ XR 5UR S9nX0RU'U$)zKGet renderable, promoting str to text as required. Returns: A Visual. z_render.visualN)r)rgrrr]r_rrU)r{r cached_visualrGs r~rEWidget._renderlsk % **..y$?  $mV44 44 4t7J7JK(.9% rcX# URRXU5IShvN gN7f)zPerform a given action, with this widget as the default namespace. Args: action: Action encoded as a string. namespaces: Mapping of namespaces. N)r run_action)r{action namespacess r~rbWidget.run_action{s!hh!!& ;;;s *(*cJ>Sn[US5(d[[U5<S35e[R(aDUR (d3UR (d"URRUSU<S35 [TU]-U5$![a Nf=f)zPost a message to this widget. Args: message: Message to post. Returns: True if the message was posted, False if this widget was closed / closing. T_preventz^ is missing expected attributes; did you forget to call super().__init__() in the constructor?zIS NOT RUNNING, z not sent) r RuntimeErrorr(r%DEBUG is_running no_dispatchrrr/rxrB)r{messagerrs r~rBWidget.post_messages $w ++=#$BC  ??4??7;N;N   )9'I'NOw#G,,$  s%!B B"!B"c># URSS9IShvN gN7f)z'Close message loop when asked to prune.F)rN)_close_messagesrCs r~on_pruneWidget.on_prunes"""...s cJ# URn/URQUR5QnUHnUR[ 55 M [ UVs/sHo3R cMUR PM sn6IShvN UR[R"55IShvN [U[5(deURRU5 URRR!U5 UR#5 UR$R'5 URR)5 [+[,/5UlUR0R'5 UR2R'5 gs snfGNN7f)zClean up DOM tree.N)rxrrrBrUr_task_dispatch_messager'UnmountrrFrrr _registrydiscard_detachrqr_clearrrIrj_component_styles_query_one_cache)r{r|rrs r~_message_loop_exitWidget._message_loop_exits/=T]]=T%:%:%<=D   eg &hQhd**ztzzhQRRR$$V^^%5666&'**** d# ""4(  %%' ))R8 $$& ##%RR6s7AF#F,F<F#F+F#/F!0C/F#!F#c,# UR5 g7f)zQCalled when there are no more events on the queue. Args: event: Idle event. N)_check_refreshrCs r~_on_idleWidget._on_idles scURGbUR(GdURnUR(a"SUlUR UR 5 UR (aiSUlUR(dQURRSS:waUR5 UR[R"55 UR(a=SUlUR(a%UR[R "U55 UR(aSUlUR"H\n[%U[&5(d OFUR)5 U=R*S- slURR,(aM\ O UR[R."U55 gggg![0a gf=f)z!Check if a refresh was requested.NFrrrQ)rxrrr]rXrr[rXrrZrErBr( UpdateScrollrZrUpdaterrrrrYauto_dimensionsrPrG)r{rancestors r~rWidget._check_refreshsc << #DMMM ?0049D1OOD$;$;<((,1D)00;;..q1V;!OO-++H,A,A,CD))-2D*||++HOOD,AB((,1D)$(NN)(F;;! 99; 00A50'>>>! %3''(=>)+-: #  s G G#"G#ct^^SUU4SjjnTR5 TRRUT5 T$)zGive focus to this widget. Args: scroll_visible: Scroll parent to make this widget visible. Returns: The `Widget` instance. c\>URRTTS9 g![a gf=f)zCallback to set the focus.)rN)r set_focusrG)rrr{s r~rWidget.focus..set_focuss1  ''^'L  s  ++rrrr)rrrX)r{rrs`` r~r Widget.focuss1    It, rc`URRU5 U$![a U$f=f)zBlur (un-focus) the widget. Focus will be moved to the next available widget in the focus chain. Returns: The `Widget` instance. )r _reset_focusrGrs r~r" Widget.blurs9  KK $ $T *     s  --cVURRU(aU5 gS5 g)zCapture (or release) the mouse. When captured, mouse events will go to this widget even when the pointer is not directly over the widget. Args: capture: True to capture or False to release. N)r capture_mouse)r{captures r~rWidget.capture_mouses wt9D9rcnURRULaURRS5 gg)zVRelease the mouse. Mouse events will only be sent when the mouse is over the widget. N)rrMrrs r~ release_mouseWidget.release_mouses- 88 " "d * HH " "4 ( +rc:URRU5 g)zSelect the entire widget.N)r_select_all_in_widgetrs r~text_select_allWidget.text_select_alls ))$/rc8URRXUS9 g)a\Capture text from print statements (or writes to stdout / stderr). If printing is captured, the widget will be sent an [`events.Print`][textual.events.Print] message. Call [`end_capture_print`][textual.widget.Widget.end_capture_print] to disable print capture. Args: stdout: Whether to capture stdout. stderr: Whether to capture stderr. )stdoutstderrN)rbegin_capture_print)r{rrs r~rWidget.begin_capture_prints $$T$Hrc:URRU5 g)z`End print capture (set with [`begin_capture_print`][textual.widget.Widget.begin_capture_print]).N)rend_capture_printrs r~rWidget.end_capture_print)s ""4(rc>[TU]U5(aUR[U55(ag[ U[ 5(ag[ U[ 5(aUR(+$S$)zCheck if a given message is enabled (allowed to be sent). Args: message: A message object Returns: `True` if the message will be sent, or `False` if it is disabled. FT)rxcheck_message_enabled _is_preventedr(r_MOUSE_EVENTS_ALLOW_IF_DISABLED"_MOUSE_EVENTS_DISALLOW_IF_DISABLEDr)r{rlrs r~rWidget.check_message_enabled-ssw,W559K9K M: :  g> ? ? '#EFF00 0  rcR# URRXUS9IShvN $N7f)N)default_namespace)r _broker_event)r{ event_namerDs r~ broker_eventWidget.broker_eventHs&XX++JQU+VVVVs '%'c>URR5 URR5 SUl[TU]5 grw)rsrrtrhrxnotify_style_update)r{rs r~rWidget.notify_style_updateKs: $$&   &&(! #%rcD# URSU5IShvN gN7f)Nz mouse.downrrCs r~_on_mouse_downWidget._on_mouse_downQs e444   cD# URSU5IShvN gN7f)Nzmouse.uprrCs r~ _on_mouse_upWidget._on_mouse_upTs E222rc# URULaUR(aURR(asURR(aXUR S:XaUR 5 O7UR S:Xa'URbURR 5 URSU5IShvN gN7f)Nr6click) rr_rrrchainrr|r=rrCs r~ _on_clickWidget._on_clickWs <<4   T[[%=%=$((BWBW;;!#((*[[A%$++*A))99;///sCCC CcB# URU5IShvN gN7frw) handle_keyrCs r~_on_keyWidget._on_keyasooe$$$s c4# [X5IShvN $N7frwr1rCs r~rWidget.handle_keyds!$....s cd# SnUR5 UR5IShvN gN7fNT)prevent_default_compose)r{rDrs r~ _on_composeWidget._on_composegs&# mmos &0.0cn# /URQ[U5QnURR5 URU5 UR U5IShvN gN![ an[ U<SU35UeSnAf[ a%nURRU5 SnAgSnAff=f7f)Nz. compose() method returned an invalid result; ) r|r=r_extend_composemount_composed_widgetsrzrr_handle_exception)r{r}errors r~rWidget._composels 7?..??G  " " ( ( *   )--g6 6 6 (HP  . HH & &u - - .sEB53A$%B5A"B5$ B2.B B2 B-(B5-B22B5cR# U(aURU5IShvN ggN7f)aCalled by Textual to mount widgets after compose. There is generally no need to implement this method in your application. See [Lazy][textual.lazy.Lazy] for a class which uses this method to implement *lazy* mounting. Args: widgets: A list of child widgets. N)rr{r}s r~rWidget.mount_composed_widgetszs$ ..) ) )  )s '%'cg)zLHook to extend composed widgets. Args: widgets: Widgets to be mounted. Nrrs r~rWidget._extend_composerdrcURRS:XaSUlURRS:XaSUlgg)NrT)rr+rr!rrCs r~ _on_mountWidget._on_mounts; ;; ! !X -+/D ( ;; ! !X --1D * .rcPURULaSUl[5UlggNF)rrr!rrCs r~ _on_leaveWidget._on_leaves% :: $D $wD  rc2URULaSUlggr)rrrCs r~ _on_enterWidget._on_enters :: #D  rcSUlUR5 URb0URR[R "U55 ggr)rrr|rBr'DescendantFocusrCs r~ _on_focusWidget._on_focuss>  ;; " KK $ $V%;%;D%A B #rcSUlUR5 URb0URR[R "U55 ggr)rrr|rBr'DescendantBlurrCs r~_on_blurWidget._on_blurs>  ;; " KK $ $V%:%:4%@ A #rc&UR(dUR(a8UR(a&URSS9(aUR 5 gggUR (a&UR SS9(aUR 5 gggNFr)ctrlshiftrrstoprrrCs r~_on_mouse_scroll_downWidget._on_mouse_scroll_downsm ::++11%1@JJLA,))000?JJL@*rc&UR(dUR(a8UR(a&URSS9(aUR 5 gggUR (a&UR SS9(aUR 5 gggr)rrrrrrrrCs r~_on_mouse_scroll_upWidget._on_mouse_scroll_upsl ::++000?JJL@,))..u.=JJL>*rctUR(a'UR5(aUR5 gggrw)rrrrCs r~_on_mouse_scroll_rightWidget._on_mouse_scroll_rights-  ' '--// 0 (rctUR(a'UR5(aUR5 gggrw)rrrrCs r~_on_mouse_scroll_leftWidget._on_mouse_scroll_lefts-  ' ',,.. / (rcUR(aAURURURURSS9 UR 5 gg)Nr#)rr )rrjr~ryrrr{rls r~ _on_scroll_toWidget._on_scroll_tos:    NN799giiSVN W LLN rchUR(a!UR5 UR5 ggrw)rrrrCs r~ _on_scroll_upWidget._on_scroll_ups%  % %    ! JJL &rchUR(a!UR5 UR5 ggrw)rrrrCs r~_on_scroll_downWidget._on_scroll_downs%  % %  ! ! # JJL &rchUR(a!UR5 UR5 ggrw)rrrrCs r~_on_scroll_leftWidget._on_scroll_lefts%  ' '  ! ! # JJL (rchUR(a!UR5 UR5 ggrw)rrrrCs r~_on_scroll_rightWidget._on_scroll_rights%  ' '  " " $ JJL (rcUR(aURRU5 UR(aURRU5 ggrw)rrSrBrr]rCs r~_on_showWidget._on_showsA  ) )  % % 2 25 9  ' '  # # 0 0 7 (rcUR(aURRU5 UR(aURRU5 UR (aUR 5 ggrw)rrSrBrr]rr"rCs r~_on_hideWidget._on_hidesQ  ) )  % % 2 25 9  ' '  # # 0 0 7 >> IIK rc8URURSS9 g)NTr)rrrs r~_on_scroll_to_regionWidget._on_scroll_to_regions gnnd;rcZUR5 URRU5 grw)rworkers cancel_noders r~ _on_unmountWidget._on_unmounts    &rcrUR(d [5eURURS:HS9 g)Nrrp)rr7rsrrs r~action_scroll_homeWidget.action_scroll_homes-!!,    23rcUR(d [5eURURUR:HS9 g)Nr)rr7rrrzrs r~action_scroll_endWidget.action_scroll_ends0!!,  t}}0K0KKLrcZUR(d [5eUR5 grw)rr7rrs r~action_scroll_leftWidget.action_scroll_lefts++,  rcZUR(d [5eUR5 grw)rr7rrs r~action_scroll_rightWidget.action_scroll_rights++,  rcZUR(d [5eUR5 grw)rr7rrs r~action_scroll_upWidget.action_scroll_up s)),  rcZUR(d [5eUR5 grw)rr7rrs r~action_scroll_downWidget.action_scroll_downs)),  rcZUR(d [5eUR5 grw)rr7rrs r~action_page_downWidget.action_page_downs)),  rcZUR(d [5eUR5 grw)rr7rrs r~action_page_upWidget.action_page_ups)),  rcZUR(d [5eUR5 grw)rr7rrs r~action_page_leftWidget.action_page_lefts++,  rcZUR(d [5eUR5 grw)rr7rrs r~action_page_rightWidget.action_page_right"s++,   r informationrseveritytimeoutrczUcURRUUUUS9$URRUUUUUS9$)aCreate a notification. !!! tip This method is thread-safe. Args: message: The message for the notification. title: The title for the notification. severity: The severity of the notification. timeout: The timeout (in seconds) for the notification, or `None` for default. markup: Render the message as content markup? See [`App.notify`][textual.app.App.notify] for the full documentation for this method. rr:rr9)rnotify)r{rlrr:r;rs r~r> Widget.notify'sZ2 ?88??! # 88??! # rc(URUUUUS9 g)Nr=)r>)r{rlrr:rs r~ action_notifyWidget.action_notifyPs!   r))rr>rr>)rz str | Contentrr>)F)rrMrrrr-)rIterable[Widget])rzint | str | 'Widget'rztuple['Widget', int])r}rrint | str | Widget | NonerrKrrt)r}rJrrKrrKrrt)rrarrKrrKrrt)rrrrrrrr)rrrrrrrr)rrrint | Widget | NonerrLrr)rra)rr`rr)FT)r0rMr1rMr2r r3r r4rr5rrr9)r0rMr1rMrr)r0rMr1rMrrrr)rOr!rr!rr)rXrErYrErr)rcrErrE)rr)rrf)rre)rztuple[bool, bool])rrD)rrN)rrM)rrL)rr) r0rMr1rMr2r r3r rr4)rrrczfloat | Animatabler objectr  float | Noner rNr rErzEasingFunction | strrCallbackType | Nonerr6rr)rrrrrr)rrP)rr)rztuple[str, ...])rr!)rCrLrr)rzCollection[Region])NN)r~rNryrNrrr rNr rNrEasingFunction | str | NonerMrrrOrr6rrrr)rrPrr)r~rNryrNrr)r~rNryrNrrr rNr rNrrPrMrrrOrr6rrrrrr)r~rNryrNrrr rNr rNrrPrMrrrOrr6rrrr)rrr rNr rNrrPrMrrrOrr6rrrprrqrrr)rrr rNr rNrrPrMrrrOrr6rrrr)rrr rNr rNrrPrMrrrOrr6rr)rrr rNr rNrrPrMrrrOrr6rr)rrrrr rNr rNrrPrrrrrrrMrrrOrr6rrrr) rrLrzSpacing | Nonerrr rNr rNrrPrrrrrrrMrrrOrr6rprrqrrrrrK)rrr rNr rNrrrrPrMrrrOrr6rrrr)rrrrr rNr rNrrPrMrrrrrOrr6rrrr)rrrr)NNTT) r  bool | Noner rQrrrrrrr)rrLrrL)rrLrzIterable[tuple[Widget, Region]])rr)rztuple[int, ...])rzJustifyMethod | None)rrrr!rr)r rrr)rrrr) rrMrrrMrsrMrrrr)rrrMrr)rr)r"rZrztuple[str, str] | None)r"rFrr)ryrrr[)r4rLrr)r~rryrrr!)rD events.Eventrr) rCrLrrrrrrrr#)rr8)r)rQz(str | type[QueryType] | Iterable[Widget]rr8)rzAsyncGenerator[None, None])rr)rr])rcrrdzMapping[str, DOMNode] | Nonerr)rlrSrr)rDzmessages.Prunerr)rDz events.Idlerr)rrrr#)rrrr)TT)rrrrrr)rrrDrRrr)rDzevents.MouseDownrr)rDzevents.MouseUprr)rDz events.Clickrr)rD events.Keyrr)rDrSrr)rDzevents.Composerr)r}rCrr)rDz events.Mountrr)rDz events.Leaverr)rDz events.Enterrr)rDz events.Focusrr)rDz events.Blurrr)rDzevents.MouseScrollDownrr)rDzevents.MouseScrollUprr)rDzevents.MouseScrollRightrr)rDzevents.MouseScrollLeftrr)rlrjrr)rDrkrr)rDrgrr)rDrhrr)rDrirr)rDz events.Showrr)rDz events.Hiderr)rlzmessages.ScrollToRegionrr) rlrrrr:rVr;rNrrrr)rr8T) rlrrrr:rrrrr($rrrrr DEFAULT_CSSrkrrrrrrr r r r rWr rrrr!rrrrMrrrrrrr$rrrrr~rrrMrpropertyrrrrrrrrsetterrrrrrrr classmethodrrrrrrrrrrr rrrr%rrr(r1r<r>r@rBrFrHr>rHrKrNrUrYrr[r rr_rkrrrrrrr.rrrrrrrrr=rrrrAr r*rPrZr^rdrhrlrorarrzrrrrr]rSrrrr#r,r"rrrrrsrrrrrrrrrrrrrrrxrrr$r-rrr)rrrrDrr&r)r,rr8r=rErIr\r_rbrfrjrnrsrrrrrrrrrrrrrrrrrrrrrrrrrrrr rrrrr#r&r+r0r5r9r>rErVrrrTrrrrErbrBrpr|rrrr"rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r rrrrrr!r$r'r*r-r0r3r6r>rAr __classcell__)rs@r~rrsb K(-0E)1%"$L-$3%'O]'6,0N)0$(L.'T%)NN)]!E>!cIt###.%e_FN,9%d^FN+8!)$J/4'Hn.w#+E5#AKAL'/|}37&uoG^-]DAJt4LO ( >I~>1"*5%"@K@3 (eE JHoJ, (eE JHoJ,sE2O-sE2O-.6uT.J^J$08t0L~L&>L>"nOA"#K"F2F0F 3F 8 F 5 F 8 F <F AF >F 5F ;F 5F <F :F 8F 6!F" +#F$./'FOB2 "HHH  H  H  HH HHB      CCEE  VVGG ]]>>  NN 66KO55'-5;H5 554 #+ " "/  & ; ;%*- ^^$  ' .             4, 4& 4% 4  4 / +"&X6J 9 9   (8      ?C$; 6 : :   (8      ?C$; 4T,,1$(3(3$((3;G(3 (3V8=B"%B04B BH:;; ?? 1.( )/Oh-1+/ RR*R) R  Rh-1+/ !*  )   J-1+/ *Y%*Y* *Y ) *Y  *YX     !                         '+%) C"C"$ C" # C"  C"J&# 410!&OOO! O " O  OO Ob>B9$)98=9 9# #2929    JJJJSSWW&&"(*;B!LP! !F>.*"*"X-*$*"8$+! 444 4  4  4lDG@ 6"*8  GK < <'C <  <--0/&. ?D* ::)0 I I)  6W&& 530%/ 7 * 2 ' $C B !!       8 <'4 M        !"/ $'' '  '  '' ''X%              rr)r __future__rasynciorrr collectionsr contextlibr fractionsr timer typesr typingr r rrrrrrrrrrr rich.reprrich rich.consolerrrrrrRichRenderResult rich.measurer rich.segmentr rich.styler! rich.textr"typing_extensionsr#textual.css.stylesr$rtextualr%r&r'r(textual._animatorr)r*r+r,textual._arranger-r.textual._contextr/textual._debugr0textual._dispatch_keyr2textual._easingr3textual._extremar4textual._styles_cacher5textual._typesr6textual.actionsr7textual.await_remover8textual.box_modelr9 textual.cacher:r; textual.colorr<textual.composer=textual.contentr>r?textual.css.matchr@textual.css.parserAtextual.css.queryrBrCtextual.css.scalarrDrE textual.domrFrGtextual.geometryrHrIrJrKrLrMrNrOtextual.layoutrPrQtextual.layouts.verticalrRtextual.messagerStextual.messagesrTrUtextual.notificationsrVtextual.reactiverWtextual.renderables.blankrX textual.rlockrYtextual.selectionrZ textual.stripr[ textual.styler\rtextual.visualr]r^r_r`rarbtextual.filterrctextual.message_pumprdrrerfrgrhrirjrkrrr MouseEventEnterrrMouseScrollDown MouseScrollUpMouseScrollRightMouseScrollLeftrreprrrtrrrrrrrrrrrr~rs  #--* :$ ")(77WW7-3.1$-)&,&-#0#-23)   33#0/%+'$.88.+)0 * &'-&7&7v||%T"     #&)&)&)R0B0Bf":")HH J :SISAI WAI AI r