AHjxUdZddlmZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZmZmZmZddlZddlmZddlmZdd lmZmZmZmZdd l m!Z!dd l"m#Z#dd l$m%Z%m&Z&dd l'm(Z(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7m8Z8m9Z9ddl:m;Z;ddlm?Z?m@Z@ddlAmBZBddlCmDZDddlEmFZFmGZGmHZHmIZIddlJmKZKddlLmMZMddlNmOZOmPZPddlQmRZRddlSmTZTddlUmVZVmWZWdd lXmYZYdd!lZm[Z[dd"l\m]Z]dd#l^m_Z_dd$l`maZae rdd%lbmcZcdd&ldmeZedd'lfmgZgd(ejz Zid)ejd*<ed+Zk ee eekgdfe eekge dffZl Gd,d-eZmejjGd.d/eekZpejjGd0d1eeke]ZqejjGd2d3eqekZrGd4d5erekd67Zsy)8z This module contains the `Screen` class and related objects. The `Screen` class is a special widget which represents the content in the terminal. See [Screens](/guide/screens/) for details. ) annotationsN)partial) attrgetter) TYPE_CHECKINGAny AwaitableCallableClassVarGenericIterableIterator NamedTupleOptionalTypeVarUnion)RenderableType)Style) constantserrorseventsmessages)arrange)invoke) Compositor MapGeometry)active_message_pumpvisible_screen_stack) CSSPathType_css_path_type_as_list_make_path_object_relative) SpatialMap) CallbackType) SkipAction) AwaitComplete) ActiveBindingBinding BindingsMapmatch)parse_selectors) NoMatches QueryType)DOMNode)NoWidget) NULL_OFFSETOffsetRegionSize)key_to_character)DockArrangeResult)Reactivevar)BackgroundScreen)Blank) SELECT_ALL Selection)Signal)Timer)Widget)Tooltip) ToastRack)Final)Provider) MessagePumpz Final[float] UPDATE_PERIODScreenResultTypec<eZdZUdZded< ded< eddZy) HoverWidgetszJResult of [get_hover_widget_at][textual.screen.Screen.get_hover_widget_at]tuple[Widget, Region] mouse_overztuple[Widget, Region] | None hover_overc\|jd|jdfS|jdfS)zJust the widgets.rN)rIrJselfs F/root/tools/cai/cai_env/lib/python3.12/site-packages/textual/screen.pywidgetszHoverWidgets.widgets_s< OOA OO+D  151C  N)returnztuple[Widget, Widget | None])__name__ __module__ __qualname____doc____annotations__propertyrOrPrNrGrGWs)T%%5,,Y   rPrGc2eZdZdZ d ddZddZy)ResultCallbackz Holds the details of a callback.Nc2||_ ||_ ||_y)zInitialise the result callback object. Args: requester: The object making a request for the callback. callback: The callback function. future: A Future to hold the result. N) requestercallbackfuturerMr\r]r^s rN__init__zResultCallback.__init__ls"#@9A $ %rPc|j|jj||j2|j&|jj |j|d|_y)zCall the callback, passing the given result. Args: result: The result to pass to the callback. Note: If the requested or the callback are `None` this will be a no-op. N)r^ set_resultr\r] call_nextrMresults rN__call__zResultCallback.__call__sR ;; " KK " "6 * >> %$--*C NN $ $T]]F ; rPN)r\rBr]1ScreenResultCallbackType[ScreenResultType] | Noner^z'asyncio.Future[ScreenResultType] | NonerQNone)rerErQri)rRrSrTrUr`rfrXrPrNrZrZhs;* ;? &&D&8 &  &( rPrZceZdZUdZdZded< dZded< dZded < d hZd Z dZ ded < dZ ded < dZ ded< dZ ded< edZded< eddZded< eddZded< eddZded< eZded< dZded< dZded < edd!"Zded#< eeZd$ed%< edZ edZ edZd&ed'< edZd&ed(< edZd)ed*< e d+d,d-d.e d/d0d1d.e d2d3d4d.gZ! d dfd5 Z"e#dd6Z$e#dd7Z%e#dd8Z&e#dfd9 Z'e#dd:Z(d;Z)d<Z* dd=Z+dd>Z, dd?Z-e#dd@Z.e#ddAZ/e#ddBZ0ddCZ1e#ddDZ2e#ddEZ3ddFZ4ddGZ5ddHZ6ddIZ7ddJZ8ddKZ9ddLZ: ddMZ;ddNZe#ddQZ? d ddRZ@dddSZAdddTZBdddUZCddVZDddWZEddXZFddYZGddZZHdd[ZIdd\ZJ d dd]ZK d dd^ZL d dd_ZMdd`ZNddaZOddbZPddcZQdddZRddeZSddfZT d ddgZUdfdh ZVddiZWdddjZXddkZYddlZZddmZ[ddnZ\ddoZ]ddpZ^dfdq Z_ddrZ`ddsZaddtZb dduZcddvZdddwZeddxZfddyZgddzZhei dd{Zjdd|Zkdd}Zl dd~ZmdddZnddZodddZpdfd Zqdfd ZrddZsddZtxZuS)ScreenzThe base class for screens.NzClassVar[str | None] AUTO_FOCUSz ClassVar[str]CSSzClassVar[CSSPathType | None]CSS_PATHzscreen--selectiona Screen { layout: vertical; overflow-y: auto; background: $background; &:inline { height: auto; min-height: 1; border-top: tall $background; border-bottom: tall $background; } &:ansi { background: ansi_default; color: ansi_default; &.-screen-suspended { text-style: dim; ScrollBar { text-style: not dim; } } } .screen--selection { background: $primary 50%; } } TITLE SUB_TITLEz&ClassVar[list[tuple[int, str]]] | NoneHORIZONTAL_BREAKPOINTSVERTICAL_BREAKPOINTSzReactive[Widget | None]focusedrF)repaintz Reactive[int] stack_updates)computezReactive[str | None] sub_titletitlez * B!##7 sC=c|jS)zIs the screen modal?)rrLs rNis_modalzScreen.is_modalDs{{rPcddlm} |jj|uxs||jjvS#|$rYywxYw)z-Is the screen current (i.e. visible to user)?r)ScreenStackErrorF) textual.apprappscreen_background_screens)rMrs rN is_currentzScreen.is_currentIsE 1 88??d*Rddhh6R6R.R R  s1:AAc|j(|jt|jdd|_|jS)zTimer used to perform updates. screen_updateT)rpause)r set_intervalrD_on_timer_updaterLs rN _update_timerzScreen._update_timerSsF    &"&"3"3t44?RV#4#D """rPcdg}|jjs|jd|jjs|jdgt||S)zPLayers from parent. Returns: Tuple of layer names. _loading _toastrack _tooltips)r_disable_notificationsappend_disable_tooltipsrlayers)rMextrasrs rNrz Screen.layers\sRxx.. MM, 'xx)) MM+ &))&))rPcp|jj|jjjz S)zThe size of the screen.)rsizestylesguttertotalsrLs rNrz Screen.sizejs'xx}}t{{118888rPc$|jyrgrefresh_bindingsrLs rN_watch_focusedzScreen._watch_focusedo rPc$|jyrgrrLs rN_watch_stack_updateszScreen._watch_stack_updatesrrrPcK|j|jzD]#}|j|j|d%ywrg)keysselection_updatedget)rMold_selectionsrwidgets rN_watch_selectionszScreen._watch_selectionsusG %))+joo.?? CF  $ $Z^^FD%A B CsA A c:|jj|y)z&Call to request a refresh of bindings.N)rpublishrLs rNrzScreen.refresh_bindings}s $$,,T2rPcz|j|dud||jd||jdyy)Nz-maximized-viewz -maximized) set_class remove_class add_class)rMpreviously_maximizedrs rN_watch_maximizedzScreen._watch_maximizedsE y,.?@  + - -l ;     - !rPc |j}||jrd}|M||jjf|j|jjjfg}n3|j Dcgc]}||jjf }}g}|D]c\}}|D]H}|j }t|jD]"} || t| s|j| =$J|j|e|jj} |D]L\}}| s |j| } | js'|jj| j|N|Scc}w)zBinding chain from this screen.N)rtloading _bindingscopyrancestors_with_selfcheck_consume_keylistkey_to_bindingsr3r_keymap apply_keymapclashed_bindingshandle_bindings_clash) rMrtnamespace_bindingsnodefilter_namespaces namespace bindings_mapfilter_namespacerkeykeymapres rN_binding_chainzScreen._binding_chains,,  7??G ?t~~**,-488--2245"  ;B:U:U"26t~~**,-" " ,.'9 0 #I|$5 > $4$F$F! < <=>C(.>s.CD)88= > >  $ $Y / 0!!'9 W #I|%226:**HH2263J3JIV  W "!1"s:#E2cr|j}t|dD]\}\}}|js|d|cS|S)z=The binding chain, ignoring everything before the last modal.rCN)r enumerater)rM binding_chainindexrrs rN_modal_binding_chainzScreen._modal_binding_chainsK++ (1-(C - $E$D)}}$Ve,, -rPci}|j}|jD]\}}|D]\}}|j|j|}|dur't |}|j |x} r@|j sR| jj rit||||j||<t||||j||<|S)aGet currently active bindings for this screen. If no widget is focused, then app-level bindings are returned. If a widget is focused, then any bindings present in the screen and app are merged and returned. This property may be used to inspect current bindings. Returns: A map of keys to a tuple containing (NAMESPACE, BINDING, ENABLED). F) rr_check_action_stateactionboolrprioritybindingr%tooltip) rMrrrbindingsrr action_stateenabledexisting_key_and_bindings rNactive_bindingszScreen.active_bindingss24 hh#'#<#<  Ix (  W"66w~~yQ 5(|,/;/?/?/DD+D (( 8 @ @ I I,9%w- S) )6!7GW__)L%-  6rPc|jjjf}jj |}||Sj j j n j dfd }tj|jn j|jdx}j|<|S)z~Arrange children. Args: size: Size of container. Returns: Widget locations. c|hjjd}jDcgc] }||vs| }}||vr|jd||Scc}w)zpGet widgets to display in maximized view. Returns: A list of widgets. z.-textual-systemr)query_childrenchildreninsert)rrOrmaximize_widgetsallow_in_maximized_viewrMs rNget_maximize_widgetsz,Screen.arrange..get_maximize_widgetss$$%<=$$%78G 6:]]X6fPWFWX X 00 ''95# # Ys AAF)rr=rQ list[Widget]) _nodes_updatesr_arrangement_cacherr{rrr)rMr cache_key cached_resultr arrangementrs` @rNrzScreen.arranges4;;//@ //33I>  $ ++3 HH , ,--  $(>-%T^^4[[  II  < d--i8rPcR |jj|uS#t$rYywxYw)z9Is the screen active (i.e. visible and top of the stack)?F)rr ExceptionrLs rN is_activezScreen.is_active s, 88??d* *  s  &&c|jS)z,Check if this widget permits text selection.) ALLOW_SELECTrLs rN allow_selectzScreen.allow_select(s   rPc2|jj} tjj }||j dkr t||S|jr|jjSt|S#t $rd}Y[wxYw)zRender method inherited from widget, used to render the screen's background. Returns: Background renderable. NrC) r backgroundrrpop LookupErrorar7is_transparentrrenderr8)rMr base_screens rNrz Screen.render-s [[++  .22488:K  "z||a'7#K< <  $ $88??$ $Z   K s"B BBc8|jj|S)zGet the absolute offset of a given Widget. Args: widget: A widget Returns: The widget's offset relative to the top left of the terminal. )r get_offsetrMrs rNrzScreen.get_offsetCs**622rPc:|jj||S)a Get the widget at a given coordinate. Args: x: X Coordinate. y: Y Coordinate. Returns: Widget and screen region. Raises: NoWidget: If there is no widget under the screen coordinate. )r get_widget_atrMxys rNrzScreen.get_widget_atNs--a33rPc`t|jj||} t|\}}|js6|D]#\}}|jst||f||fcSt||fdSt||f||fS#t$rt j d|d|dwxYw)aGet the widget, and its region directly under the mouse, and the first widget, region pair with a hover style. Args: x: X Coordinate. y: Y Coordinate. Returns: A pair of (WIDGET, REGION) tuples for the top most and first hover style respectively. Raises: NoWidget: If there is no widget under the screen coordinate. z)No hover widget under screen coordinate (z, )N) iterrget_widgets_atnext StopIterationrr._has_hover_stylerG)rMrrwidgets_under_coordinate top_widget top_regionrregions rNget_hover_widgets_atzScreen.get_hover_widgets_at]s$((8(8(G(G1(M#N  Y%)*B%C "J **": T**'Z(@66BRSS T Z 8$? ?Z4z:6NOO Y//$MaSPRSTRUUV"WX X Ys B&B-c:|jj||S)zGet all widgets under a given coordinate. Args: x: X coordinate. y: Y coordinate. Returns: Sequence of (WIDGET, REGION) tuples. )rr rs rNr zScreen.get_widgets_atxs..q!44rPc |j||\}}|jds |jry|jD]#}t |t s|js!|cSy#t$rYywxYw)aGet the focusable widget under a given coordinate. If the widget directly under the given coordinate is not focusable, then this method will check if any of the ancestors are focusable. If no ancestors are focusable, then `None` will be returned. Args: x: X coordinate. y: Y coordinate. Returns: A `Widget`, or `None` if there is no focusable widget underneath the coordinate. Nz-textual-system)rr. has_classrr isinstancer= focusable)rMrrr_regionrs rNget_focusable_widget_atzScreen.get_focusable_widget_atsz "00A6OFG   - .&.... D$'DNN    sA(( A43A4c:|jj||S)zGet the style under a given coordinate. Args: x: X Coordinate. y: Y Coordinate. Returns: Rich Style object. )r get_style_atrs rNr1zScreen.get_style_ats,,Q22rPc:|jj||S)zGet the widget under a given coordinate, and an offset within the original content. Args: x: X Coordinate. y: Y Coordinate. Returns: Tuple of Widget and Offset, both of which may be None. )rget_widget_and_offset_atrs rNr3zScreen.get_widget_and_offset_ats88A>>rPc8|jj|S)aGet the screen region of a Widget. Args: widget: A Widget within the composition. Returns: Region relative to screen. Raises: NoWidget: If the widget could not be found in this screen. )r find_widgetrs rNr5zScreen.find_widgets++F33rPc.i|_d|_d|_y)zClear any selected text.N)rrrrLs rNclear_selectionzScreen.clear_selections!rPclt}||i|jdDcic]}||c}|_ycc}w)zdSelect a widget and all it's children. Args: widget: Widget to select. *N)r9queryr)rMr select_allchilds rN_select_all_in_widgetzScreen._select_all_in_widgets;  J .4ll3.?@Uuj @ @s 1c2g}|j}td}tt|j||j fg}|j }|j}|r|d\}}t|d} | |n| jr1| jjd} | r| dk7n|} | jr:| jr*t| j|} |t| | f| r| jr|| |r|S)z9A list of widgets that may receive focus, in focus order._focus_sort_keyrrN visibilityhidden)rrrsorteddisplayed_childrenvisiblerr!_check_disabledrget_rule is_containerallow_focus_children allow_focus) rMrO add_widget focus_sorter node_stackrpushchildren_iteratorparent_visibilityrnode_styles_visibilitynode_is_visiblesorted_displayed_childrens rN focus_chainzScreen.focus_chains' !#^^ !"34 VD33FG  ; nn  3=b> 0 0)40D|''))-)=)=l)K&.+h6* $$)B)B)D06//\1-$89?KL#t'7'7'9t$-0rPc> t|ts |j}t| |j}|j 9t |j jd}|Dcgc] }||vs| }} fd|D}|s |jS|j)t|d}|j||jS|st |jsd} |j|j}|rYd}t|} tdt|dzD] } |||| zz| z} t | s| }n|j||jScc}w#t$r)|jt|dY|jSwxYw)aMove the focus in the given direction. If no widget is currently focused, this will focus the first focusable widget. If no focusable widget matches the given CSS selector, focus is set to `None`. Args: direction: 1 to move forward, -1 to move backward, or 0 to keep the current focus. selector: CSS selector to filter what nodes can be focused. Returns: Newly focused widget, or None for no focus. If the return is not `None`, then it is guaranteed that the widget returned matches the CSS selectors given in the argument. NT with_selfc3<K|]}t|s|ywrgr().0r selector_sets rN z%Screen._move_focus..'s E,,ED srC)r,strrRr*rTrr walk_childrenrtr! set_focusr)rlenrange ValueError) rM directionselectorrTr-rfiltered_focus_chainto_focus current_index chain_lengthsteprrZs @rN _move_focuszScreen._move_focus s((C(((H&x0 &&  >> %DNN8848HII0;Sfv?R6SKS ( <<  << 0$7H NN8 $<< |T\\!BI )'--dll;M ";/ !!S%5%9:D&&T)99\ID\40#' x(||OT, = NN4 4d; <||# =s* E%4E%#E**$FFc&|jd|S)aCFocus the next widget, optionally filtered by a CSS selector. If no widget is currently focused, this will focus the first focusable widget. If no focusable widget matches the given CSS selector, focus is set to `None`. Args: selector: CSS selector to filter what nodes can be focused. Returns: Newly focused widget, or None for no focus. If the return is not `None`, then it is guaranteed that the widget returned matches the CSS selectors given in the argument. rCrirMrcs rN focus_nextzScreen.focus_nextNs8,,rPc&|jd|S)aGFocus the previous widget, optionally filtered by a CSS selector. If no widget is currently focused, this will focus the first focusable widget. If no focusable widget matches the given CSS selector, focus is set to `None`. Args: selector: CSS selector to filter what nodes can be focused. Returns: Newly focused widget, or None for no focus. If the return is not `None`, then it is guaranteed that the widget returned matches the CSS selectors given in the argument. rrkrls rNfocus_previouszScreen.focus_previous_sH--rPc|jrI|r?|jD]0}t|ts ||_y|js)||_y||_yy)a'Maximize a widget, so it fills the screen. Args: widget: Widget to maximize. container: If one of the widgets ancestors is a maximizeable widget, maximize that instead. Returns: `True` if the widget was maximized, otherwise `False`. TF)allow_maximize ancestorsr,r=r)rMr containermaximize_widgets rNmaximizezScreen.maximizepsb  '-'7'7$O%ov> $DN '55)8# $$DNrPc~d|_|j*|j|j|jddyy)z-Restore any maximized widget to normal state.NFT)animatecenter)rrtcall_after_refreshscroll_to_widgetrLs rNminimizezScreen.minimizes> << #  # #%%t||U4 $  $rPc|jsyg}|jjD]*\}}|j|}||j|,dj |j d}|S)zrGet text under selection. Returns: Selected text, or `None` if no text was selected. Nrm )ritems get_selectionextendjoinrstrip)rM widget_textr selectionselected_text_in_widget selected_texts rNget_selected_textzScreen.get_selected_texts{ !# !%!6!6!8 < FI&,&:&:9&E #&2""#:; <  ,33D9 rPcr|j}| t|jj|y)z Copy selected text to clipboard.N)rr#rcopy_to_clipboard)rMrs rNaction_copy_textzScreen.action_copy_texts0**,  ,  ""9-rPcT|j|j|jyy)z0Action to maximize the currently focused widget.N)rtrurLs rNaction_maximizezScreen.action_maximizes! << # MM$,, ' $rPc$|jy)z2Action to minimize the currently maximized widget.N)r{rLs rNaction_minimizezScreen.action_minimizes  rPc&|jdy)z Action to remove focus (if set).N)r^rLs rN action_blurzScreen.action_blurs trPcK |j|j}t|tr|j |yy#t $rYywxYww)zAn [action](/guide/actions) to focus the given widget. Args: selector: Selector of widget to focus (first match). N)r:firstr,r=r^r+)rMrcrs rN action_focuszScreen.action_focussR  %::h'--/D$'t$(   s'AA#A AAAAc|xsg}|j|ury|j}|s|jdy |j|}d}t||dzd|d|zD] }||vs|}n|j|y#t$rJ|j D]'}||vs|j s|j|Yy|jdYywxYw)zReset the focus when a widget is removed Args: widget: A widget that is removed. avoiding: Optional list of nodes to avoid. NrC)rtrTr^rravisible_siblingsr-reversed)rMravoidingfocusable_widgets widget_indexsiblingchosen candidates rN _reset_focuszScreen._reset_focuss >r <CCct}|It|jD]1}|js|j |j dn|It|jD]1}|js|j |j dn|r(|j jj|dyy)zUpdate CSS for focus changes. Args: focused: The widget that was focused. blurred: The widget that was blurred. NTrV)rw) rrr_has_focus_withinupdater]r stylesheet update_nodes)rMrtblurredrOrs rN_update_focus_styleszScreen._update_focus_styless!$  "7#>#>? ++NN6#7#7$#7#GH   "7#>#>? ++NN6#7#7$#7#GH   HH   , ,Wd , C rPc|juryd}d}|hj@jjtjj}d_jj dn|j rj|k7rj9jjtjj}|_|jtj||}|rdfd }j||jj |dj||jjy)aFocus (or un-focus) a widget. A focused widget will receive key events first. Args: widget: Widget to focus, or None to un-focus. scroll_visible: Scroll widget into view. from_app_focus: True if this focus is due to the app itself having regained focus. False if the focus is being set because a widget within the app regained focus. Nzfocus was removed)from_app_focuscnj|ur&j|sj|dyyy)z#Scroll to center (after a refresh).T)origin_visibleN)rtcan_view_entirescroll_to_center)rrMs rNrz*Screen.set_focus..scroll_to_center=s8<<61$:N:Nv:V 11&1N;W1rPz was focusedrr=rQri) rt post_messagerBlurlogdebugr-Focus call_laterrryr)rMrscroll_visiblerrtrrs` rNr^zScreen.set_focuss T\\ ! !%!% >||' ))&++-8,,# HHNN. /   ||v%<<+LL--fkkm<"llG% ##FLL$OP !O OO$4f=v}5 !!'73  5 56rPc|jjs|jdtd|jjs|jdt dyy)zInsert Textual's own internal widgets. Args: widgets: The list of widgets to be composed. This method adds the tooltip, if required, and also adds the container for `Toast`s. rztextual-tooltip)rztextual-toastrackN)rrrr>rr?)rMrOs rN_extend_composezScreen._extend_composeIsKxx)) NN1g):; <xx.. NN1i+>? @/rPcT|jj||jdy)z1Set up the tooltip-clearing signal when we mount.T) immediateN)r subscribe_maybe_clear_tooltiprMevents rN _on_mountzScreen._on_mountWs( ))33 $++t 4 rPcRK|j|jjsc|jrW|js0|j s$|j s|js |jr|jjy|jd{y7wrg) prevent_defaultr _batch_countr_layout_required_scroll_required_repaint_required_recompose_requiredrrresume_invoke_and_clear_callbacksrs rN_on_idlezScreen._on_idle]sy xx$$%%(())++&&""))+..000sBB'B% B'c|j}|jrr||jur|j}|jduxr||jk}|j ||j j|jj||j|||_|jj|j jjn||jjvr|j jr|jj|j j|j jj|jjn$||jurS|j j|j}|j |||jjn||jjvr|j jr|j |j j|jj|j jd|_|j jj|jj|j%|y)zPerform a compositor refresh.N) screen_stackclear)rT)r is_inliner_get_inline_height_previous_inline_height_displayr render_inliner with_heightrrr_dirty_regionsrefresh render_update _set_dirtyr_update_mouse_over)rMr inline_heightrrs rN_compositor_refreshzScreen._compositor_refreshms)hh ==szz! # 6 6 8 //t;D%(C(CC $$22,,];%(%<%<#3/<+##))+  //5574449I9I9X9X" ""D$4$4$C$CD  //557##))+szz!))77!$!8!88 T6*##))+4449I9I9X9X!1!1!@!@A" ""D$4$4$C$CD)-&  //557##))+ t$rPc|jj|jr=|jjs&|j r>|j |jd|_|jjn|jr|j dd|_|jr<|jj|jj|d|_ |jr5|jj|j|j|jr"d|_|j!|j"|j$r|j!|j&yy)zCalled by the _update_timer.)scrollFTN)rrrrrr_refresh_layoutrrrraddrupdate_widgetsrrrc recomposerrrLs rNrzScreen._on_timer_updates(   " ??488#8#8$$$$D,A,A$B(-%##))+&&$$D$1$)D !%%##))+##''-).&""  //0C0CD((*''+0(t~~. ?? NN4;; < rPcK|jr`|jdd}|jj|D]1\}}|j5t|d{ddd3yy7#1swYAxYww)zXIf there are scheduled callbacks to run, call them and clear the callback queue.N)rr_contextr)rM callbacksr] message_pumps rNrz"Screen._invoke_and_clear_callbackss ??*I OO ! ! #*3 +&,!**,+ ***++ +  +++s0AA>A2A0 A2$ A>0A22A; 7A>c^|jj||f|jy)zEnqueue a callback to be invoked after the screen is repainted. Args: callback: A callback. sender: The sender (active message pump) of the callback. N)rr check_idle)rMr]senders rN _invoke_laterzScreen._invoke_laters% &12 rPcl|jjttt|||y)zAdd a result callback to the screen. Args: requester: The object requesting the callback. callback: The callback. future: A Future to hold the result. N)rrrZrrEr_s rN_push_result_callbackzScreen._push_result_callbacks/ %% 8$45 6y(F S rPcKt|d{|jj|jj|j j|j j|jj||jjd|_ y7wrg) r_message_loop_exitrrrrrr unsubscriber_clear_taskrMrs rNrzScreen._message_loop_exitsg(***   !!# !!# %%' ))55d;   +sCB?B*Cc8|jjy)z1Remove the latest result callback from the stack.N)rrrLs rN_pop_result_callbackzScreen._pop_result_callbacks ""$rPc| |jn|}|jjr)|j|jj }|sy|j j |j|jjtj} |r|j j||}|r]|j j}|D]U\}\}}} } } } } ||vs|j|j| | ds3|j!||j| | Wn|j j#||\} }}tj$}tj&}| D]}|j!|||z}|j j}|D]R\}\}}} } } } } |j|j| | ||vs0|j!||j| | T|D]}|j!||j,r|j/|jj0r&|j2j5|j6y|jj!tj8d|j_y#t($r%}|jj+|Yd}~yd}~wwxYw)z>Refresh the layout (can change size and positions of widgets).NFr}T) outer_sizerrrrrrrrrrResizereflow_visibler _size_updatedrrreflowHideShowr_handle_exceptionrr _dom_readyrrrReady)rMrr ResizeEventexposed_widgetsrrr'_order_clip virtual_sizecontainer_size_rBshownresizedrr send_resizeerrors rNrzScreen._refresh_layouts"&,tD 88  ##DHH$?$?$ABD  ''(;(;<   "mm 8 "&"2"2"A"A$"M"!--44F "!$&!_4%33 & \>RW 4 !' 3 3$/(. \>%&!""(*.)9)9)@)@t)L&w{{{{$0F''/0$go ))00 F "((lNS,++' \>R $0F''/0 ??  $ $ & 88    - - 5 5dkk B HH ! !&,,. 1"&DHH   HH & &u -  s-#A J8/J8CJ8AJ88 K&K!!K&cK|j|j|j}t|tsJ||j vr,|j j||jyywrg) stoprrr,r=rrrr)rMmessagers rN _on_updatezScreen._on_update:se !&&))) 4## #    # #F + OO  $sA:A<czK|j|jd|_|jywNT)rrrrrMrs rN _on_layoutzScreen._on_layoutD- ! $ 9;czK|j|jd|_|jywr )rrrrr s rN_on_update_scrollzScreen._on_update_scrollJr r c N|jj}| |jr|j|||j}nt |j ||}||jjjz }|jj}|jj}|%t|t |j ||}|%t|t |j ||}t|jjj|}|S)zGet the inline height (number of lines to display when running inline mode). Args: size: Size of the terminal Returns: Height for inline mode. )rheightis_autoget_content_heightwidthintresolver min_height max_heightmaxminrr)rMr height_scalarrrrs rNrzScreen._get_inline_heightPs **  M$9$9 33D$ KM 5 5dD ABM++222 [[++ [[++  ! s:3E3EdD3Q/RSM  ! s:3E3EdD3Q/RSMDHHMM00-@ rPcZ|jr|jr|j|yyy)z)Called by App when the screen is resized.N)rv is_attachedrrMrs rN_screen_resizedzScreen._screen_resizedhs)   $"2"2   &#3 rPc|jjr%|j|jj|xjdz c_|jj |jj }|j |jrW|j|jjj||j||jyy)zScreen has resumed.rCN) rSUSPENDED_SCREEN_CLASSrrv_refresh_notificationsr_update_auto_focusrrrrrrrs rN_on_screen_resumezScreen._on_screen_resumems 88 * *   dhh== > a '')xx}} !     $ $ & HH   & &t ,   & LLN rPc^Kt|d{|jy7wrg)r_composer#rs rNr&zScreen._composes)g    ! !s -+-c&|jjr{|j|jjn |j}|rJ|j=|j |D](}|j sd|_|j|yyyyy)zUpdate auto focus.NT)r app_focusrlrtr:r- has_focusr^)rM auto_focusrs rNr#zScreen._update_auto_focuss 88  '+'>##DOO dll2"jj4F''+/(v. 3z rPc|jjr%|j|jj|jjdd|j |xj dz c_y)zScreen has suspended.NrC)rr!r_set_mouse_over_clear_tooltiprvrLs rN_on_screen_suspendzScreen._on_screen_suspendsV 88 * * NN488:: ;   t,  arPcK|j|j|j|jjD]}|j|j|j |jj n |j xsg}|j |jj n |j xsg}|j\}}|r|j|||r|j||yywrg)rrrrrrrrs_set_breakpoints)rMrrhorizontal_breakpointsvertical_breakpointsrrs rN _on_resizezScreen._on_resizes  UZZ(hh22 /F  " "5:: . / **2 HH + +,," ((0 HH ) )**    v !  ! !%)? @   ! !&*> ? sC?Dc|Dcgc]\}}| }}}|j|t|dD]\}}||k\s |j|yycc}}w)zSet horizontal or vertical breakpoints. Args: dimension: Either the width or the height. breakpoints: A list of breakpoints. T)reverseN)rrCr)rM dimension breakpoints _breakpoint class_name class_names breakpoints rNr0zScreen._set_breakpointssfBMM&=k:zM M;'&,[$&G  "J J&z* Ns Ac |jt}|jr!|j|ur|j |yyy#t $rYywxYw)z"Update the content of the tooltip.N)get_child_by_typer>displayr_handle_tooltip_timerr+)rMrrs rN_update_tooltipzScreen._update_tooltipsW 3,,W5G4#7#76#A**62$B   sA AAc |jt}|jr.|j|jj d|_yy#t$rYywxYw)z+Unconditionally clear any existing tooltip.NF)r=r>r+r>rr)rMrs rNr-zScreen._clear_tooltips^ ,,W5G ??"".##((*#GO    sA AAc|jG |j|jj\}}||jur|j yyy#t $rYywxYw)zCheck if the widget under the mouse cursor still pertains to the tooltip. If they differ, the tooltip will be removed. N)rrrmouse_positionr-r.)rMr under_mouses rNrzScreen._maybe_clear_tooltipso    + *!3!3!3TXX5L5L!M Q d&:&::''); ,  s&A A! A!cF |jt}d}|jD].}t|tsn|j "|j }n|d|_yd|_|jj|_ |j|y#t$rYywxYw)zCalled by a timer from _handle_mouse_move to update the tooltip. Args: widget: The widget under the mouse. NFT) r=r>rr,r=rr>rrCabsolute_offsetrr+)rMrrtooltip_contentrs rNr?zScreen._handle_tooltip_timers 0,,W5G6:O22 !$/<<+&*llO  &"'"&*.((*A*A'/!   sB B B cd} |jjr2|jj}|j|j}n3|j |j |j \\}}}||d}|jj|||j|_ ||ur|j|n4|j|||}|j|j||jjs |jt }|j"|k7s |j$so||_|j&|j&j)|j+|jj,t/|j0|d|_yd|_yy#t2$rYywxYw#t4j6$r|jjdd|j&|j&j)|jjs- d|jt _Yy#t2$rYYywxYwYywxYw)Nrz tooltip-timer)rF)rmouse_capturedr5r'r(rrr,style hover_styler_translate_mouse_move_event_set_forwarded_forward_eventrr=r>rr>rr set_timer TOOLTIP_DELAYrr?r+rr.)rMr hover_widgetrr'hover mouse_eventrs rN_handle_mouse_movezScreen._handle_mouse_moves&* , 0xx&&00))&188*.*C*CEGGUWW*U' %$#(8L HH $ $V\ :!&F ~!!%(">>uffU **,%%k288--0"44W=G++v5W__/5,..: //446.2nn HH22#D$>$>G!0/=/+ +0#.!-  HH $ $T4 0"".##((*88-->CD**73; .  sCA;G F55 GGA+I0I  IIIIIcTtj||j|jz |j|j z |j |j|j|j|j|j|j|j|j S)z Returns a mouse move event whose relative coordinates are translated to the origin of the specified region. )screen_xscreen_yrJ)r MouseMove_xr_yr_delta_x_delta_ybuttonshiftmetactrl _screen_x _screen_yrJ)rrr's rNrLz"Screen._translate_mouse_move_event3sy  HHvxx  HHvxx  NN NN LL KK JJ JJ____++  rPc. |jry|jt|tjtj fr|j |yt|tjr|j|j|j|_ |j||jr|j|_|j!|j"|j$\}}|j&b|`|j$|j&dj$kDr:|j&d}|j(j*}||j,|f|_y|%|j.r|||j,|f|_yyyyyt|tj0rt|tj2rD|j4)|j4|j6k(r|j9d|_d|_ nt|tj:r|j<j>s|j|_|j6|_|j!|j|j\}}|s|j.rg|j@j.rQ|j<jBr;d|_ |9|7|jDjG|||j6|f|_$nd|_ |j<j>r2|j<j>}|jK|jL}n)|jO|j"|j$\}}t|tj:r;|jQ|j"|j$}|r|jS|d|j|j|j|_ |jTry||ur"|j|j |y|jW|jY|j" |j$ y|j |y#tZj\$r|jSdYywxYw)NrCrFT)r)/ is_forwardedrMr,rEnterLeaverrXr1rVrWrJrT _selectingr^ _box_selectr3rrrcontent_regionbottom_right_inclusiveoffsetr  MouseEventMouseUpr screen_offsetr7 MouseDownrrIrr rrrr5r'rr/r^rrN _apply_offsetrr.)rMr select_widget select_offset end_widgetrr'focusable_widgets rNrNzScreen._forward_eventJs      efllFLL9 :   e $ v// 0++ENNENNKEK  # #E *#(;; /3/L/LGGUWW0, }$$0%-$"2"21"5"7"77!%!1!1!!4J$.$=$=$T$TM(2ELL-'PD$"-%22%1(5u||]'SD$23.*v00 1%0++7//53F3FF((**.'"'E6#3#34TXX=T=T#(;; */*=*='/3/L/LNNENN0, }"-%22 00--&*DO$0]5N::BB4H)!//).* ',DO U88**!XX44F!--f5<>T>((*%%e,))%*=*=vxxi&((*ST   e $#?? %t$ %s?A1Q--$RRc$|jyrg)r7rLs rN _key_escapezScreen._key_escapes rPc | |jy|j}|\}}}|\}}}||ur|tj||i|_yt ||gd\}}|\}} }|\}} }g} |j } |j } | j | jks |jr'| jtj| | nT tj|jj |jj g}tj| j | j |j"| j} tj|j | j | j"| j} | j| | j| | j | jz }|dkDrTtj|j | j|j"| j|z}| j|t%}|j'|j(j*j-Dcgc]}|j.t0dd|fc}t3}| D]N}|j5|}|Dcgc]}|j7|j r|!}}|j9|P||||hz}t:}|t|dit |dDcic]}||c}|td|i|_y#t$rYywxYwcc}wcc}wcc}w)zWhen select_end changes, we need to compute which widgets and regions are selected. Args: select_end: The end selection. NcH|djjjS)Nr)r'rk transpose)rs rNz+Screen._watch__select_end..s9Q<#6#6#=#=#G#GrPr@rFcB|jjjSrg)rirkry)rs rNrzz+Screen._watch__select_end.. sv'<'<'C'C'M'MrP)rr: from_offsetsrrCrirbottomrhrr1union from_unionselect_containerr+ from_cornersrrightr!rrvisible_widgetsrr'r/rget_values_in_regionoverlapsrr9)rM select_end select_start start_widget screen_start start_offsetrs screen_end end_offset _screen_start _screen_endselect_regions start_region end_regioncontainer_region mid_height mid_region spatial_maprhighlighted_widgetsr'covered_widgetsr;s rN_watch__select_endzScreen._watch__select_endsU  !3!3!; )) 3?0 lL-7* J : %i44\:NDO #) : &H$  j 5A1 m\.8+ K')#22 .. <<<.. .$2B2B  ! !&,,|Z"H I #)#4#4$55DD"33BB$ ".. &&## L  ,, ""   !! J  ! !, /  ! !* -# (;(;;JA~#00$&& ''$** ''*4  %%j1*4, #..>>CCE  UE6B  ,/5$ 8F)>>vFO.??6#8#89O & & 7 8 lJ?? )L$7  %'M "    $ 3  _  : s$?L+L:%$L? M+ L76L7cd}js%jjdtSjrjd}||j j }dfd }|j||S)aDismiss the screen, optionally with a result. Any callback provided in [push_screen][textual.app.App.push_screen] will be invoked with the supplied result. Only the active screen may be dismissed. This method will produce a warning in the logs if called on an inactive screen (but otherwise have no effect). !!! warning Textual will raise a [`ScreenError`][textual.app.ScreenError] if you await the return value from a message handler on the Screen being dismissed. If you want to dismiss the current screen, you can call `self.dismiss()` _without_ awaiting. Args: result: The optional result to be passed to the result callback. TzCan't dismiss inactive screenrcRd}tjurddlm}|dy)z#Called by the AwaitComplete object.Tr ScreenErrorz_Can't await screen.dismiss() from the screen's message handler; try removing the await keyword.N)rrrr)_rich_traceback_omitrrMs rN pre_awaitz!Screen.dismiss..pre_await*s2#' "&&(D03!u1rPrQri)r rwarningr$rr pop_screenset_pre_await_callback)rMrerr] await_poprs` rNdismisszScreen.dismisss{$ $~~ HH  < = ? "  ! !--b1H V HH'')   ((3rPctddlm} |jj|y#|$r|d|ddwxYw)zPop any screens on top of this one, until this screen is active. Raises: ScreenError: If this screen is not in the current mode. rrz Can't make z* active as it is not in the current stack.N)rrr_pop_to_screen)rMrs rNpop_until_activezScreen.pop_until_active8sJ ,  HH # #D ) dV#MN  s$7cbK|jd{|j|y7w)zA wrapper around [`dismiss`][textual.screen.Screen.dismiss] that can be called as an action. Args: result: The optional result to be passed to the result callback. N)_flush_next_callbacksrrds rNaction_dismisszScreen.action_dismissIs+ ((*** V +s /-/c||jjvry|jjdk(r|j|jvSt ||S)auCheck if a given widget is fully within the current screen. 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. Returns: `True` if the entire widget is in view, `False` if it is partially visible or not in view. Fr)rrroverlayr'rrrMrrs rNrzScreen.can_view_entireRsQ ))99 9 == H ,==DKK/ /w&v..rPc||jjvry|jjdk(r|j|jvSt ||S)zCheck if a given widget is at least partially within the current view. Args: widget: A widget. Returns: `True` if the any part of the widget is in view, `False` if it is completely outside of the screen. Fr)rrrrr'rcan_view_partialrs rNrzScreen.can_view_partialgsQ ))99 9 == H ,==DKK/ /w'//rPc |dSt|S)z'Ensure the title is a string or `None`.Nr\)rMrys rNvalidate_titlezScreen.validate_titleys}t4#e*4rPc |dSt|S)z+Ensure the sub-title is a string or `None`.Nr)rMrxs rNvalidate_sub_titlezScreen.validate_sub_title}s (tK .  .&"&"P((T5n!!!, 3 4P6 56 3 ? ? ? , ? 4  --`EHCC,AC CJ-"."0$.(  %?C33(;3 3lGKD$D6CD D6 $$ 575757 57  57n A 1 .%`=8+ BF   D ?    "%K'Z  0' $"  @0+@ "3 $*$06.0`  )/ 9?   ,Y%ve >e e N'R"/*0$5=rPrkc>eZdZdZdZ d dfd ZxZS) ModalScreenzA screen with bindings that take precedence over the App's key bindings. The default styling of a modal screen will dim the screen underneath. z ModalScreen { layout: vertical; overflow-y: auto; background: $background 60%; &:ansi { background: transparent; } } c8t||||d|_y)NrT)rr`r)rMrrrrs rNr`zModalScreen.__init__s dr7; rPrr)rRrSrTrUrr`rrs@rNrrsJ K "     rPrceZdZdZy)SystemModalScreenaA variant of `ModalScreen` for internal use. This version of `ModalScreen` allows us to build system-level screens; the type being used to indicate that the screen should be isolated from the main application. Note: This screen is set to *not* inherit CSS. N)rRrSrTrUrXrPrNrrsrPrF) inherit_css)trU __future__rasyncio functoolsroperatorrtypingrrrr r r r r rrrr rich.reprrich rich.consoler rich.stylertextualrrrrtextual._arrangertextual._callbackrtextual._compositorrrtextual._contextrr textual._pathrrr textual._spatial_mapr!textual._typesr"textual.actionsr#textual.await_completer$textual.bindingr%r&r'textual.css.matchr)textual.css.parser*textual.css.queryr+r, textual.domr-textual.errorsr.textual.geometryr/r0r1r2 textual.keysr3textual.layoutr4textual.reactiver5r6%textual.renderables.background_screenr7textual.renderables.blankr8textual.selectionr9r:textual.signalr; textual.timerr<textual.widgetr=textual.widgetsr>textual.widgets._toastr?typing_extensionsr@textual.commandrAtextual.message_pumprBMAX_FPSrDrVrEScreenResultCallbackTyperGreprautorZrkrrrXrPrNrs#    '77$$7F ,'&0??#-2#>>),*B+3!!#,'(1 )"3"33 |3-."  h'( )4 /0 h'( )9T? :;=1 : "$W-.$$Nn=W% &n=n=b7&)*6  $455 rP