Cjֲ \%SrSSKJr SSKrSSKJr SSKJrJr SSK J r J r J r J r JrJrJrJrJrJr SSKJr \ (aSSKJr SSKr\\\\\\\4\\\\\44rS \S '\"S \\5rSS jr"S S\5r"SS\5r "SS\5r!"SS\5r""SS5r#\ (d-\RHRKSS5S:Xa SSK&JrJ!r!J r J"r" \"SS5r(S\S'\!"SSSS5r)S\S'\ "SS5r*S\S'\""SSSS5r+S\S'g!\'a NHf=f) zd Functions and classes to manage terminal geometry (anything involving coordinates or dimensions). ) annotationsN) lru_cache) attrgetter itemgetter) TYPE_CHECKINGAny CollectionIterableLiteral NamedTupleTupleTypeVarUnioncast)Final) TypeAliasrSpacingDimensionsTcLX:aX:aU$X:aU$U$X:aU$X:aU$U$)aRestrict a value to a given range. If `value` is less than the minimum, return the minimum. If `value` is greater than the maximum, return the maximum. Otherwise, return `value`. The `minimum` and `maximum` arguments values may be given in reverse order. Args: value: A value. minimum: Minimum value. maximum: Maximum value. Returns: New value that is not less than the minimum or greater than the maximum. )valueminimummaximums b/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/textual/geometry.pyclampr's>" ?N ?N ?N ?N c\rSrSr%SrSrS\S'SrS\S'\SSj5r \SSj5r \SS j5r SS jr SS jr SS jrSS jrSSjrSSjrSSjrSSjrSrg)OffsetHa2A cell offset defined by x and y coordinates. Offsets are typically relative to the top left of the terminal or other container. Textual prefers the names `x` and `y`, but you could consider `x` to be the _column_ and `y` to be the _row_. Offsets support addition, subtraction, multiplication, and negation. Example: ```python >>> from textual.geometry import Offset >>> offset = Offset(3, 2) >>> offset Offset(x=3, y=2) >>> offset += Offset(10, 0) >>> offset Offset(x=13, y=2) >>> -offset Offset(x=-13, y=-2) ``` rintxyc US:H$)zIs the offset at (0, 0)?rrrselfs r is_originOffset.is_origindsv~rcJUup[US:aSOUUS:aS5$U5$)z=This offset with `x` and `y` restricted to values above zero.rrr&r!r"s rclampedOffset.clampedis.1q5aaa!e;;;;rcUupX!4$)z2A tuple of x and y, in reverse order, i.e. (y, x).rr+s r transposeOffset.transposeost rc US:g$)Nr$rr%s r__bool__Offset.__bool__us v~rch[U[5(aUup#UupE[X$-X5-5$[$N isinstancetuplerNotImplementedr&other_x_yr!r"s r__add__Offset.__add__x4 eU # #FBDA"&"&) )rch[U[5(aUup#UupE[X$- X5- 5$[$r5r6r:s r__sub__Offset.__sub__r@rc[U[[45(a&Uup#[[X!-5[X1-55$[U[5(a,Uup#[[X!S-5[X1S-55$[ $)Nr)r7floatr rr8r9)r&r;r!r"s r__mul__Offset.__mul__sp eeS\ * *DA#ai.#ai.9 9 eU # #DA#a(l+S1X->? ?rc&Uup[U*U*5$r5r*r+s r__neg__Offset.__neg__sqb1"~rcnUup4UupV[[X5U- U--5[XFU- U--55$)zCalculate a new offset on a line between this offset and a destination offset. Args: destination: Point where factor would be 1.0. factor: A value between 0 and 1.0. Returns: A new point on a line between self and destination. )rr )r& destinationfactorx1y1x2y2s rblend Offset.blendsG 2g'' ( 2g'' (  rcBUup#UupEXB- XB- -XS- XS- --S-nU$)ziGet the distance to another offset. Args: other: An offset. Returns: Distance to other offset. g?r)r&r;rOrPrQrRdistances rget_distance_toOffset.get_distance_tos8G0BG3HHSPrc ZUup4[[USUS- 5[USUS- 55$)zClamp the offset to fit within a rectangle of width x height. Args: width: Width to clamp. height: Height to clamp. Returns: A new offset. rrE)rr)r&widthheightr!r"s rr Offset.clamps2eAq%!),eAq&1*.EFFrrNreturnboolr^rr^tuple[int, int])r;objectr^r)rMrrNrFr^r)r;rr^rF)rZr r[r r^r)__name__ __module__ __qualname____firstlineno____doc__r!__annotations__r"propertyr'r,r/r2r>rBrGrJrSrWr__static_attributes__rrrrrHs,AsJ+ AsJ) <<   "  Grrc\rSrSr%SrSrS\S'SrS\S'SSjr\ SSj5r \ SS j5r \ SS j5r SS jr SS jrSS jrSSjrSSjrSSjrSSjrSSjrSrg) SizeaThe dimensions (width and height) of a rectangular region. Example: ```python >>> from textual.geometry import Size >>> size = Size(2, 3) >>> size Size(width=2, height=3) >>> size.area 6 >>> size + Size(10, 20) Size(width=12, height=23) ``` rr rZr[c:URUR-S:g$)z!A Size is Falsy if it has area 0.rrZr[r%s rr2 Size.__bool__szzDKK'1,,rc4URUR-$)z+The area occupied by a region of this size.rpr%s rarea Size.areazzDKK''rc$Uup[SSX5$)z)A region of the same size, at the origin.rRegion)r&rZr[s rregion Size.regions aE**rc,[UR5$)z9A range object that covers values between 0 and `height`.)ranger[r%s r line_rangeSize.line_rangesT[[!!rc,[XR5$)zjGet a new Size with just the width changed. Args: width: New width. Returns: New Size instance. )rmr[)r&rZs r with_widthSize.with_widthsE;;''rc.[URU5$)zmGet a new Size with just the height changed. Args: height: New height. Returns: New Size instance. )rmrZ)r&r[s r with_heightSize.with_heightsDJJ''rc[U[5(a,Uup#UupE[[SX$-5[SX5-55$[$Nrr7r8rmmaxr9r&r;rZr[width2height2s rr> Size.__add__C eU # # ME#OFAu~.Av7G0HI Irc[U[5(a,Uup#UupE[[SX$- 5[SX5- 55$[$rrrs rrB Size.__sub__rrchUup4X1s=:=(a S:Os =(a XBs=:=(a S:$s $)zCheck if a point is in area defined by the size. Args: x: X coordinate. y: Y coordinate. Returns: True if the point is within the region. rrr&r!r"rZr[s rcontains Size.containss+ ~~A~1&///1/1rcpUup#UupEXBs=:=(a S:Os =(a XSs=:=(a S:$s $)zCheck if a point is in the area defined by the size. Args: point: A tuple of x and y coordinates. Returns: True if the point is within the region. rr)r&pointr!r"rZr[s rcontains_pointSize.contains_points2 ~~A~1&///1/1rcUup#UupEXBs=:=(a S:Os =(a XSs=:=(a S:$s $![a [S5ef=f)NzrBrrrrrkrrrrmrms E3NFCO-((++ "" ( ( 2 2 2 5rrmc\rSrSr%SrSrS\S'SrS\S'SrS\S'Sr S\S'\ SS j5r \ S S .S?Sjj5rS@Sjr\SASj5r\SASj5r\SBSj5r\SBSj5r\SBSj5r\SCSj5r\SDSj5r\SCSj5r\SCSj5r\SCSj5r\SCSj5r\SESj5r\SFSj5r\SGSj5r\SGSj5r\SHSj5r SIS jr!SIS!jr"SJS"jr#SKS#jr$SLS$jr%SLS%jr&\'"S&S'9SMS(j5r(SNS)jr)SOS*jr*\'"S&S'9SMS+j5r+\'"S&S'9SKS,j5r,\'"S-S'9SPS.j5r-SQS/jr.\'"S-S'9SRS0j5r/\'"S-S'9SRS1j5r0\'"S-S'9SSS2j5r1\'"S-S'9SSS3j5r2\'"S&S'9STS4j5r3\'"S&S'9SUS5j5r4\'"S&S'9SUS6j5r5SVSWS7jjr6SXSYS9jjr7SZS:jr8S;r9g8)[rxi@uuDefines a rectangular region. A Region consists of a coordinate (x and y) and dimensions (width and height). ``` (x, y) ┌────────────────────┐ ▲ │ │ │ │ │ │ │ │ height │ │ │ │ │ │ └────────────────────┘ ▼ ◀─────── width ──────▶ ``` Example: ```python >>> from textual.geometry import Region >>> region = Region(4, 5, 20, 10) >>> region Region(x=4, y=5, width=20, height=10) >>> region.area 200 >>> region.size Size(width=20, height=10) >>> region.offset Offset(x=4, y=5) >>> region.contains(1, 2) False >>> region.contains(10, 8) True ``` rr r!r"rZr[c*U(d [S5e[U[S5S9Rn[ U[ S5S9R n[U[S5S9Rn[ U[ S5S9RnU"X$X2- XT- 5$)zCreate a Region from the union of other regions. Args: regions: One or more regions. Returns: A Region that encloses all other regions. zAt least one region expectedrkeyrightrEbottom) ValueErrorminrr!rrrr"r)clsregionsmin_xmax_xmin_ymax_ys r from_unionRegion.from_unionms;< <GA/11GG!45;;GA/11GH!56==5 >>rcU"XX1- XB- 5$)zConstruct a Region form the top left and bottom right corners. Args: x1: Top left x. y1: Top left y. x2: Bottom right x. y2: Bottom right y. Returns: A new region. r)rrOrPrQrRs r from_cornersRegion.from_cornerss227BG,,rc$Uup4UupVU"X4XV5$)zCreate a region from offset and size. Args: offset: Offset (top left point). size: Dimensions of region. Returns: A region instance. r)rrsizer!r"rZr[s r from_offsetRegion.from_offsets 1''rF)topcX!;a U(d[$URupEpgURUR5nURuppS=pXhs=:aU:aO OXjs=:aU:d"O [ X- XUR - - [ S9n U(aX- n O=Xys=:aU:aO OX{s=:aU:d"O [ X- XUR- - [ S9n [X5$)aCalculate the smallest offset required to translate a window so that it contains another region. This method is used to calculate the required offset to scroll something into view. Args: window_region: The window region. region: The region to move inside the window. top: Get offset to top of window. Returns: An offset required to add to region to move it inside window_region. rr) NULL_OFFSETcorners crop_sizerrrZabsr[r)r window_regionryr window_left window_top window_right window_bottomlefttop_rrdelta_xdelta_ys rget_scroll_to_visibleRegion.get_scroll_to_visibles$  "3 ?L?T?T< !!-"4"45$*NN!E /K /44"v||34G 'G /Z /5:5! 56G g''rcUu pnX#-S:$)z1A Region is considered False when it has no area.rrr&_rZr[s rr2Region.__bool__s"1V~!!rcLURURUR-4$)zpA pair of integers for the start and end columns (x coordinates) in this region. The end value is *exclusive*. r!rZr%s r column_spanRegion.column_spans +,,rcLURURUR-4$)znA pair of integers for the start and end lines (y coordinates) in this region. The end value is *exclusive*. r"r[r%s r line_spanRegion.line_spans ,--rc4URUR-$)z Maximum X value (non inclusive).rr%s rr Region.rightsvv ""rc4URUR-$)z Maximum Y value (non inclusive).rr%s rr Region.bottomsvv ##rc4URUR-$)zThe area under the region.rpr%s rrs Region.arearurc[USS6$)zRegion.__add__O9 eU # #FB"& A%!&!&%8 8rcl[U[5(aUup#UupEpg[XB- XS- Xg5$[$r5rrs rrBRegion.__sub__Vrrc[URUR- URUR- URUR- URUR- 5$)zGet spacing between two regions. Args: region: Another region. Returns: Spacing that if subtracted from `self` produces `region`. )Spacingr"rrr!r&rys rget_spacing_betweenRegion.get_spacing_between]sQ HHtvv  JJ % KK&-- ' HHtvv    rc,Uup#UupEpg[X#Xg5$)zGet a new Region with the same size at a given offset. Args: offset: An offset. Returns: New Region with adjusted offset. rw)r&rr!r"r<r=rZr[s r at_offsetRegion.at_offsetms" $aE**rc RUup#pEUupg[X#[XF5[XW55$)zGet a region with the same offset, with a size no larger than `size`. Args: size: Maximum width and height (WIDTH, HEIGHT). Returns: New region that could fit within `size`. )rxr)r&rr!r"width1height1rrs rrRegion.crop_sizezs.!%faC/W1FGGrcLUup#UupEpg[XB- XS- XbS--XsS--5$)z~Increase the size of the region by adding a border. Args: size: Additional width and height. Returns: A new region. rrw)r&r expand_width expand_heightr!r"rZr[s rexpand Region.expandsE'+# "e   1$ $ Q& &   ri)maxsizec`URup#pEURupgpXFs=:=(a U:Os =(d* XHs=:=(a U:Os =(d Xb:=(a X:=(aE XWs=:=(a U:Os =(d* XYs=:=(a U:Os =(d Xs:=(a X:$)zCheck if another region overlaps this region. Args: other: A Region. Returns: True if other region shares any cells with this region. r) r&r;r!r"rQrRrrox2oy2s roverlapsRegion.overlapssu|| b ==AJ2<, , , )`. Returns: New region. rr!r"rZr[anyrxr r&marginrrrrr!r"rZr[s rgrow Region.grow s_6{{K#) F"ehga-.q&,/0   rc [U5(dU$Uup#pEUupgp[Xe-Xr-[SXU-- 5[SXU-- 5S9$)zShrink a region by subtracting spacing. Args: margin: Shrink space by `(, , , )`. Returns: The new, smaller region. rr9r:r<s rshrink Region.shrinks_6{{K#) F"ehga,/0q&&L12   rcUup#pEUupgpX$-n X5-n Xh-n Xy-n X,:aU OX&:aUOUnX=:aU OX7:aUOUnX:aU OX:aUOU nX:aU OX:aUOU n[XUU- UU- 5$)zGet the overlapping portion of the two regions. Args: region: A region that overlaps this region. Returns: A new region that covers when the two regions overlap. rw)r&ryrOrPw1h1cx1cy1w2h2rQrRcx2cy2rx1ry1rx2ry2s r intersectionRegion.intersection3s!" W WhhXc28CXc28CXc28CXc28Ccc 3955rc URup#pEURupgpUR[X&5[X75[XH5[XY55n U $)zGet the smallest region that contains both regions. Args: region: Another region. Returns: An optimally sized region to cover both regions. )rrrr) r&ryrOrPrQrRox1oy1rr  union_regions runion Region.unionLsP#^^#(( L#b,B c"l rc Uup4pVUS:aXQ-nUS:aXb-n[nU"X4X5U"X1-XEU- U5U"X4U-XU- 5U"X1-XB-XQ- Xb- 54$)uSplit a region into 4 from given x and y offsets (cuts). ``` cut_x ↓ ┌────────┐ ┌───┐ │ │ │ │ │ 0 │ │ 1 │ │ │ │ │ cut_y → └────────┘ └───┘ ┌────────┐ ┌───┐ │ 2 │ │ 3 │ └────────┘ └───┘ ``` Args: cut_x: Offset from self.x where the cut should be made. If negative, the cut is taken from the right edge. cut_y: Offset from self.y where the cut should be made. If negative, the cut is taken from the lower edge. Returns: Four new regions which add up to the original (self). rrw)r&cut_xcut_yr!r"rZr[_Regions rsplit Region.split^s}4#e 19ME 19NE A% ' AIq%- 7 A5y%% 8 AIqy%- H   rc\Uup#pEUS:aXA-n[X#X5[X!-X4U- U54$)uSplit a region into two, from a given x offset. ``` cut ↓ ┌────────┐┌───┐ │ 0 ││ 1 │ │ ││ │ └────────┘└───┘ ``` Args: cut: An offset from self.x where the cut should be made. If cut is negative, it is taken from the right edge. Returns: Two regions, which add up to the original (self). rrwr&cutr!r"rZr[s rsplit_verticalRegion.split_verticalsD(#e 7+C 1 % 17As{F 3  rc\Uup#pEUS:aXQ-n[X#XA5[X#U-XEU- 54$)uSplit a region into two, from a given y offset. ``` ┌─────────┐ │ 0 │ │ │ cut → └─────────┘ ┌─────────┐ │ 1 │ └─────────┘ ``` Args: cut: An offset from self.y where the cut should be made. May be negative, for the offset to start from the lower edge. Returns: Two regions, which add up to the original (self). rrwr_s rsplit_horizontalRegion.split_horizontalsD*#e 7,C 1 $ 1#gusl 3  rc UupEpgUupp[U(a[[XU-U - 5U5OUU(a![[XU-U - 5U5U U 5$U U U 5$)uDTranslate this region, so it fits within a container. This will ensure that there is as little overlap as possible. The top left of the returned region is guaranteed to be within the container. ``` ┌──────────────────┐ ┌──────────────────┐ │ container │ │ container │ │ │ │ ┌─────────────┤ │ │ ──▶ │ │ return │ │ ┌──────────┴──┐ │ │ │ │ │ self │ │ │ │ └───────┤ │ └────┴─────────────┘ │ │ └─────────────┘ ``` Args: container: A container region. x_axis: Allow translation of X axis. y_axis: Allow translation of Y axis. Returns: A new region with same dimensions that fits with inside container. )rxrr) r& containerx_axisy_axisrOrPrrrQrRrrs rtranslate_insideRegion.translate_insidest:#,"&6CBW w./ 4     DF     rNcUc[OUnUupVpxU(aXWUR-U-- nU(aXhUR-U-- n[XVXx5$)uFInflect a region around one or both axis. The `x_axis` and `y_axis` parameters define which direction to move the region. A positive value will move the region right or down, a negative value will move the region left or up. A value of `0` will leave that axis unmodified. If a margin is provided, it will add space between the resulting region. Note that if margin is specified it *overlaps*, so the space will be the maximum of two edges, and not the total. ``` ╔══════════╗ │ ║ ║ ║ Self ║ │ ║ ║ ╚══════════╝ │ ─ ─ ─ ─ ─ ─ ─ ─ ┌──────────┐ │ │ │ Result │ │ │ └──────────┘ ``` Args: x_axis: +1 to inflect in the positive direction, -1 to inflect in the negative direction. y_axis: +1 to inflect in the positive direction, -1 to inflect in the negative direction. margin: Additional margin. Returns: A new region. ) NULL_SPACING max_width max_heightrx) r&rhrir=inflect_marginr!r"rZr[s rinflectRegion.inflects]H*0V"e  .222f< 444> >AaE**rc URU5nUnSSjnUS:XdUS:XaURUS:Xa4U"URURURUR5*OSUS:Xa4U"URUR URUR 5*OSU5nUR URU5US:gUS:g5nU$)a[Constrain a region to fit within a container, using different methods per axis. Args: constrain_x: Constrain method for the X-axis. constrain_y: Constrain method for the Y-axis. margin: Margin to maintain around region. container: Container to constrain to. Returns: New widget, that fits inside the container (if possible). c&X:aX::agX:agg)aCompare a span with a container Args: span_start: Start of the span. span_end: end of the span. container_start: Start of the container. container_end: End of the container. Returns: 0 if the span fits, -1 if it is less that the container, otherwise +1 rrEr) span_startspan_endcontainer_start container_ends r compare_span&Region.constrain..compare_span(s,1J+rrqrnone) rvr rwr rxr ryr r^r )r>rqr!rr"rrjrA)r& constrain_x constrain_yr=rg margin_regionryrzs r constrainRegion.constrains$ &)   '* =@ QT   * ) #{i'?^^#i/ "%%++! ! #i/ "%%,,! !(( +F6((   V $ 6 ! 6 !   rr)rzCollection[Region]r^rx) rOr rPr rQr rRr r^rx)rrbrrbr^rx)rrxryrxrr_r^rr]rarr`)r^ztuple[float, float])r^rm)r^tuple[int, int, int, int]rr)r;rcr^rx)ryrxr^r )rrbr^rx)rrbr^rx)r;rxr^r_rrr)rZr r[r r^rx)r=rr^rx)ryrxr^rx)rYr rZr r^z%tuple[Region, Region, Region, Region])r`r r^ztuple[Region, Region])TT)rgrxrhr_rir_r^rx)rErEN)rhr rir r=zSpacing | Noner^rx) r}$Literal['none', 'inside', 'inflect']r~rr=r rgrxr^rx):rdrerfrgrhr!rir"rZr[ classmethodrrrrr2rjrrrrrsrrrrrrrrrr}rr>rBrrrrrr!rrr*r/rr6r>rArPrVr\rardrjrqrrkrrrrxrx@s!FAsJ, AsJ*E3N"FCO#??" - - ( (CH3("3(,23(<@3( 3(3(j" --..##$$((!! 3 3%%$$--55 ++ 2233++ + H $t  R3 t  $t K Kt*t  (t  (t660t"t% % Nt  8t  <FJ$ $ )-$ >B$ $ NLP*+*+(+*+:H*+ *+XL9L:L L  L  Lrrxcr\rSrSr%SrSrS\S'SrS\S'SrS\S'Sr S\S'SS jr \ SS j5r \ SS j5r \ SS j5r\ SS j5r\ SSj5r\ SSj5r\ SSj5r\ SSj5r\SSj5r\S Sj5r\S Sj5r\S Sj5rS!SjrS!SjrS"SjrSrg)#r ibuStores spacing around a widget, such as padding and border. Spacing is defined by four integers for the space at the top, right, bottom, and left of a region. ``` ┌ ─ ─ ─ ─ ─ ─ ─▲─ ─ ─ ─ ─ ─ ─ ─ ┐ │ top │ ┏━━━━━▼━━━━━━┓ │ ◀──────▶┃ ┃◀───────▶ │ left ┃ ┃ right │ ┃ ┃ │ ┗━━━━━▲━━━━━━┛ │ │ bottom └ ─ ─ ─ ─ ─ ─ ─▼─ ─ ─ ─ ─ ─ ─ ─ ┘ ``` Example: ```python >>> from textual.geometry import Region, Spacing >>> region = Region(2, 3, 20, 10) >>> spacing = Spacing(1, 2, 3, 4) >>> region.grow(spacing) Region(x=-2, y=2, width=26, height=14) >>> region.shrink(spacing) Region(x=6, y=4, width=14, height=6) >>> spacing.css '1 2 3 4' ``` rr rrrrc US:g$)N)rrrrrr%s rr2Spacing.__bool__s |##rc4URUR-$)zTotal space in the x axis.)rrr%s rrZ Spacing.widthsyy4::%%rc4URUR-$)zTotal space in the y axis.)rrr%s rr[Spacing.heightsxx$++%%rcUupp4XB:aU$U$)zcThe space between regions in the X direction if margins overlap, i.e. `max(self.left, self.right)`.r)r&_topr_bottomrs rrnSpacing.max_widths&*"W|t..rcUupp4X:aU$U$)zcThe space between regions in the Y direction if margins overlap, i.e. `max(self.top, self.bottom)`.r)r&r_rightr_lefts rroSpacing.max_heights&*"Vls..rc2URUR4$)z/A pair of integers for the left, and top space.)rrr%s rtop_leftSpacing.top_lefts 488$$rc2URUR4$)z3A pair of integers for the right, and bottom space.)rrr%s rrSpacing.bottom_rights DKK((rcUupp4XB-X-4$)z?A pair of integers for the total horizontal and vertical space.rr&rrrrs rtotalsSpacing.totalss$( F cl++rctUupp4Xs=:XaUs=:Xa U:XaU$ X4X44:XaUSU3$USUSUSU3$)zXA string containing the spacing in CSS format. For example: "1" or "2 4" or "4 2 8 2".  rrs rcss Spacing.csssd $( F  )6 )T )UO *  )U!E7# #U!E7!F81TF3 3rch[U[5(a U"XX5$[U5nUS:XaUSnU"X3X35$US:Xa([[[[4U5upEU"XEXE5$US:Xa3[[[[[[4U5upgpU"XgX5$[ SUS35e)zUnpack padding specified in CSS style. Args: pad: An integer, or tuple of 1, 2, or 4 integers. Raises: ValueError: If `pad` is an invalid value. Returns: New Spacing object. rErrz41, 2 or 4 integers required for spacing properties; z given)r7r lenrr r) rpadpad_len_padpad_top pad_rightrrrrs runpackSpacing.unpacks c3  s* *c( a<q6Dt4. . a > a<'+E#sC2D,Es'K $Cs60 0B7)6 R  rc[USUS5$)zConstruct a Spacing with a given amount of spacing on vertical edges, and no horizontal spacing. Args: amount: The magnitude of spacing to apply to vertical edges. Returns: `Spacing(amount, 0, amount, 0)` rr ramounts rverticalSpacing.verticalsvq&!,,rc[SUSU5$)zConstruct a Spacing with a given amount of spacing on horizontal edges, and no vertical spacing. Args: amount: The magnitude of spacing to apply to horizontal edges. Returns: `Spacing(0, amount, 0, amount)` rrrs r horizontalSpacing.horizontalsq&!V,,rc[XX5$)zConstruct a Spacing with a given amount of spacing on all edges. Args: amount: The magnitude of spacing to apply to all edges. Returns: `Spacing(amount, amount, amount, amount)` rrs rall Spacing.allsvv66rcx[U[5(a Uup#pEUupgp[X&-X7-XH-XY-5$[$r5r7r8r r9 r&r;top1right1bottom1left1top2right2bottom2left2s rr>Spacing.__add__J eU # #+/ (D'+0 (D' V_g.? rcx[U[5(a Uup#pEUupgp[X&- X7- XH- XY- 5$[$r5rrs rrBSpacing.__sub__ rrc zUup#pEUupgp[[X&5[X75[XH5[XY55$)zGrow spacing with a maximum. Args: other: Spacing object. Returns: New spacing where the values are maximum of the two values. )r r) r&r;rrrr other_top other_right other_bottom other_lefts r grow_maximumSpacing.grow_maximumsE$( F;@8     #  %  !   rrNr]rra)r^str)rrr^r )rr r^r )r;rcr^r )r;r r^r )rdrerfrgrhrrirrrr2rjrZr[rnrorrrrrrrrrr>rBrrkrrrr r bs=<CL)E3N+FCO,D#M*$&&&&// // %%)),,  4 4  8 - - - - 7 7 rr c\rSrSrSrSS/rSSjrSSjrSSjrSSjr SS jr \ SS j5r \ SS j5r \ SS j5r\SS j5rSSjrSSjrSrg)Shapei)zAn arbitrary shape defined by a sequence of regions. This class currently exists to filter widgets within a shape defined when the user is slecting text. _regions_boundsc[U5UlUR(a&[R"UR5Ulg[Ulg)z: Args: regions: Regions which will define the shape. N)r8rrxr NULL_REGIONr)r&rs r__init__Shape.__init__5s8 g 04 F  dmm , CN rc,[UR5$r5)r_rr%s rr2Shape.__bool__@sDLL!!rc,[UR5$r5)hashrr%s r__hash__Shape.__hash__CsDMM""rc#(# URv g7fr5rr%s r __rich_repr__Shape.__rich_repr__Fsmmsc Uup#/n[U5HInUR[U5Vs/sH nSUR[Xe55PM" sn5 MK SR SU55$s snf)zsBuild a string with a 2D grid of results from contains_point. This is a debugging aid (do not use in production). z.X c3D# UHnSRU5v M g7f)N)join).0lines r Shape.draw..Rs7343s )r|appendrrr)r&rrZr[mapr"r!s rdraw Shape.drawIsl  !vA JJuVAT00>?V Wyy73777Ws'A7 cUR$)zThe regions in the shape.rr%s rr Shape.regionsTs}}rcUR$)z!A region that encloses the shape.)rr%s rbounds Shape.boundsYs||rc:[SUR55$)zCells covered by the shape.c38# UHoRv M g7fr5)rs)rrys rrShape.area..bs;]6;;]s)sumrr%s rrs Shape.area^s;T]];;;rc^^^^^^^TRTR:aTTsmmTummTummSUUUUUUU4Sjjn[U"55$)aGet a shape that would be constructed by a user selecting text between two points. The shape would look something like this: ``` XXXXXXXXXX <- top XXXXXXXXXXXXXX XXXXXXXXXXXXXX <- middle XXXXXXXXXXXXXX XXXXXXXXX <- bottom ``` Args: container: The container region for the selection. start: The start offset. end: The end offset. Returns: A new shape covering the selection bounds. c3># TTR:Xa;TTR:Xa+[TRTTRTT- S-5v gTRTR:Xa[TTTT- S5v g[TTTRT- S5v TRTR- S:a-[TRTS-TRTT- S- 5v [TRTTTR- S5v g7f)zMGet regions to cover selection bounds. Yields: Regions to cover bounds. rEN)r!rrxrZr")rgendend_xend_ystartstart_xstart_ysr get_regions+Shape.selection_bounds..get_regionss)++%%9??*BKKOOGOa' CEE!GO OOg- 55577?Q& ! ! !!+ KKIKK' sD D )r^Iterable[Region])r/r) rrgrrrrrrrs ``` @@@@rselection_boundsShape.selection_boundsdsM, ??S]] *JC  u1 1 f[]##rcB^[U4SjUR55$)zDoes a region overlap this shape? Args: region: A Region to check. Returns: `True` if any part of the shape overlaps the region, `False` if there is no overlap. c3D># UHoRT5v M g7fr5)r!)r shape_regionrys rr!Shape.overlaps..sS]\((00] r;rr s `rr!Shape.overlapssST]]SSSrcB^[U4SjUR55$)zCheck if the given offset is within the shape. Args: offset: An offset. Returns: `True` if the given offset is anywhere within the shape, otherwise `False`. c3D># UHoRT5v M g7fr5)r)rryrs rr'Shape.contains_point..sM}V((00}rr rs `rrShape.contains_pointsMt}}MMMr)rrN)rrr]r)r^zrich.repr.Result)rrmr^r)r^ztuple[Region, ...]r)rgrxrrrrr^r)ryrxr^r_)rrr^r_)rdrerfrgrh __slots__rr2rrrrjrrrsrrr!rrkrrrrr)s I  "# 8<< M$M$^ T NrrTEXTUAL_SPEEDUPS1)rrxrmr rrr NULL_SIZErm)rrrrrrr^r),rh __future__ros functoolsroperatorrrtypingrrr r r r r rrrtyping_extensionsrr rich.reprrichr rrirFrrrrmrxr renvirongettextual_speedups ImportErrorrrrrmrrrrsf # +   $+$sU38_eCc3,>&?? 97 CeBuGZuGp}5:}5@_ Z_ DD jD N_N_ND(:C@CG BB Aq\ U!?Aq!Q' U'}1: 5PaAq) e)B    s D""D+*D+