_j  %SrSSKJr SSKrSSKrSSKJr "SS\R5r\"SSS SS 9\"S SS SS 9\"S SS SS 9\"SSS SS 9\"SSSSS 9\"SSSSS 9S.r S\ S'"SS\R5r "SS\R5r g)aV `kitty text sizing protocol`_ (OSC 66) parsing and measurement. The kitty text sizing protocol allows terminal apps to explicitly tell terminals how many cells text occupies, using the escape sequence:: ESC ] 66 ; metadata ; text BEL/ST Metadata is colon-separated ``key=value`` pairs: - ``s``: scale - ``w``: width in cells - ``n``: fractional numerator - ``d``: fractional denominator - ``v``: vertical alignment - ``h``: horizontal alignment Parsing is pretty straight-forward: - When ``w > 0``, return ``s * w``. - Otherwise ``w == 0``, ``s * wcswidth(inner_text_width)`` cells. Numerator, denominator, and alignment codes and values are parsed but otherwise ignored and have no effect on measurements made in this library. .. _`kitty text sizing protocol`: https://sw.kovidgoyal.net/kitty/text-sizing-protocol/ .. versionadded:: 0.7.0 ) annotationsN)wcswidthc>\rSrSr%S\S'S\S'S\S'S\S'Srg ) _FieldMeta*strnameintlowhighdefaultN)__name__ __module__ __qualname____firstlineno____annotations____static_attributes__rH/home/rurouni/.local/lib/python3.13/site-packages/wcwidth/text_sizing.pyrr*s I H I Lrrscale)r r r rwidth numerator denominatorvertical_alignhorizontal_align)swndvhzdict[str, _FieldMeta]TEXT_FIELD_MAPPINGc\rSrSr%SrSrS\S'SrS\S'SrS\S'Sr S\S 'Sr S\S 'Sr S\S 'SS jr SS jr \SSSjj5rSrg)TextSizingParams:a  Parsed parameters from a text sizing escape sequence (OSC 66). :param scale: Scale factor (1-7). Text occupies ``scale`` rows tall and ``scale * width`` columns wide. :param width: Width in cells (0-7). When 0, width is auto-calculated from the inner text. :param numerator: Fractional scaling numerator (0-15). :param denominator: Fractional scaling denominator (0-15). :param vertical_align: Vertical alignment (0=top, 1=bottom, 2=center). :param horizontal_align: Horizontal alignment (0=left, 1=right, 2=center). rr rrrrrrr c^SRU4Sj[R555nTRRSUS3$)z Return a compact representation including only non-default fields. This avoids verbose output when most fields are defaults. z, c3># UHPn[TUR5UR:wdM)URS[TUR53v MR g7f)=N)getattrr r).0fieldselfs r ,TextSizingParams.__repr__..UsNL*E 'ejj 9U]] JI |1WT5::-F,GH*Es (A,A())joinr'values __class__r)r1repr_fmts` r__repr__TextSizingParams.__repr__NsL99L*<*C*C*ELL..))*!H:Q77rc/n[R5HAup#[XR5=oCR:wdM+UR USU35 MC SR U5$)z0Build and return sub-part of an OSC 66 sequence.r-:)r'itemsr.r rappendr6)r1parts field_keyr0vals r make_sequenceTextSizingParams.make_sequenceZs\ 2 8 8 : ItZZ00]]B {!C512!;xxrc0nU(dU"5$URS5GH nSU;aUS:Xa[SU<SU<35eM%URS5upVn[R U5nUcUS:Xa[SUSU<35eMk[ U5n US:XaZXR :dXR:a<[S USU<S US URSURSUR 3 5e[UR[UR U 55X8R'GM U"S0UD6$![a(n US:Xa[S USU<S U 35U eSn A GMGSn A ff=f)a0 Parse colon-separated ``key=value`` metadata string. :param raw: Metadata string, e.g. ``'s=2:w=3'``. :param control_codes: 'parse' or 'strict'. :raises ValueError: If ``control_codes='strict'`` unrecognized text sizing parameters raise ValueError. :returns: Parsed parameters with values clamped to valid ranges. Unknown keys are ignored. Non-integer values use defaults. Example:: >>> TextSizingParams.from_params('s=2:w=3') TextSizingParams(scale=2, width=3, numerator=0, denominator=0, vertical_align=0, horizontal_align=0) r=r-strictz5Expected '=' in text sizing parameter (key=val), got z in OSC 66 sequence, NzUnknown text sizing field 'z' in OSC 66 sequence, zIllegal text sizing value 'z: z!Out of bounds text sizing value 'z: allowed range for 'z' (z) is z to r) split ValueError partitionr'getr r r r maxmin) clsraw control_codeskwargspartkey_eqrBr0valueexcs r from_paramsTextSizingParams.from_paramscs$)+5LIIcND$ H,$(,,083H&QRR NN3/MCc&**3/E} H,$'B3%H<>> TextSizing.from_match(TEXT_SIZING_PATTERN.match('\x1b]66;w=2;XY\x07')) TextSizing(params=TextSizingParams(scale=1, width=2, numerator=0, denominator=0, \ vertical_align=0, horizontal_align=0), text='XY', terminator='\x07') r)rOr)rarbrc)r)rVgroup)rMmatchrOs r from_matchTextSizing.from_matchsC&*66u{{1~Ub6c A#kk!n. .rcURRS:a-URRURR-$[URUS9nURR[ SU5-$)a Calculate the display width of a text sizing sequence. :param ambiguous_width: Width for East Asian Ambiguous characters. :returns: Display width in terminal cells. When ``width > 0``, returns ``params.scale * params.width``. When ``width == 0``, returns ``params.scale * measured_inner_width``. .. note: Fractional scaling (numerator/denominator) does not affect the cell count, it adjusts only the font size within the cells allocated by 'w'. r)ambiguous_width)rarrrrbrK)r1rkr"s r display_widthTextSizing.display_widths` ;;  q ;;$$t{{'8'88 8 TYY @{{  3q!9,,rcnSURR5SURUR3$)z3Build and return complete OSC 66 Terminal Sequence.z]66;;)rarCrbrc)r1s rrCTextSizing.make_sequences0$++3356a {4??BSTTrrNrZ)rgz re.Match[str]rOr rYr_)r)rkr rYr rX) rrrrr\rr]rhrlrCrrrrr_r_s2L  IO..,-"Urr_) r\ __future__rretyping _wcswidthr NamedTuplerr'rr)r_rrrrvs<#  "" aa ; aa ; !"a @ AB B )qq! D +A F -H)HZv((Zz1U""1Ur