_jwSrSSKJr SSKrSSKJr SSKJrJrJ r J r SSK J r SSK Jr SS KJrJr SS KJrJrJrJrJr SS KJrJr SS KJrJrJr "S S\R>5r "SS\ 5r!SSjr"SSjr#SSjr$S Sjr%S!Sjr&S Sjr'SSSSSSS.S"Sjjr(g)#z*This is a python implementation of clip().) annotationsN)islice)LiteralCallableOptional NamedTuple)width)iter_graphemes) HyperlinkHyperlinkParams)_SGR_STATE_DEFAULT _SGRState_sgr_state_update_sgr_state_is_active_sgr_state_to_sequence) TextSizingTextSizingParams)_SEQUENCE_CLASSIFY_HORIZONTAL_CURSOR_MOVEMENTINDETERMINATE_EFFECT_SEQUENCEc\rSrSrSr\R "5r\R "5r\R "5r \R "5r Sr g)_HyperlinkActionz.Outcome of processing an OSC 8 hyperlink unit.N) __name__ __module__ __qualname____firstlineno____doc__enumautoNO_CLOSEEMPTYOUTSIDEVISIBLE__static_attributes__rB/home/rurouni/.local/lib/python3.13/site-packages/wcwidth/_clip.pyrrs18yy{H IIKEiikGiikGr(rc\rSrSr%SrS\S'SrS\S'SrS\S'S rS \S 'S r S \S 'S r S \S 'Sr S\S'Sr S\S'Sr g)_HyperlinkResult"zb Result of processing an OSC 8 hyperlink. Only the fields relevant to each action are populated. ractionrint close_end inner_widthstropen_seq clipped_inner close_seq clipped_width hl_col_endrN)rrrrr __annotations__r/r0r3r4r5r6r7r'rr(r)r+r+"sU IsKHcM3IsM3Jr(r+cbUb+[U5=n(aX -n[U5(aUS- nU$)z Apply SGR prefix/suffix around *result*. If an SGR state was captured at the first visible character, prefix the result with the corresponding SGR sequence and suffix with a reset if any styles are active. z)rr)resultcaptured_styleprefixs r)_apply_sgr_wrapr=3s;!+N; ;6 ;_F  / / i F Mr(c [R"X5upX4S:Xa[[R5$XU n [ XXES9n U S:Xa[[R U S9$X-nX::dX:a[[RU U S9$[SX- 5nX)- n[XUX4USUS9n[ UUXES9n[[RU U UR5UUR5UUS9$) z Process an OSC 8 hyperlink unit. Finds the matching close sequence, measures the inner text width, and determines whether the hyperlink is empty, outside the clip window, or visible (requiring inner-text clipping). )r?) control_codestabsizeambiguous_widthr)r/)r/r0F)fillcharrArB propagate_sgrr@)r/r0r3r4r5r6r7) r find_closer+rr#r r$r%maxclipr& make_open make_close)textstartendrCrArBr@params match_endcol close_startr/ inner_textr0r7inner_clip_startinner_clip_endr4r6s r)_process_hyperlinkrTBs('11$BK8+ 0 9 9:: ,JK a 0 6 6)LL"Jcj 0 8 8I,79 91ek*YNn'# M]M   !!####%#  r(c80nUH(upgnURU/5RXx45 M* UR5Hn U R5 M U(a[ UR 55OSn U(a[ UR 55OSn [ X5n /n Sn[ X5nX::aURUS5HunnU RU5 M X:aUS- nM>X;aXunnU RU5 UU- nO%X.s=::aU ::aO OU RU5 US- nX::aM[UR 55H+nUU:dM UUHunnU RU5 M M- SRU 5$)z Reconstruct the output string from painter's algorithm state. Walks columns left-to-right, interleaving escape sequences and cell content, filling gaps with *fillchar*. r?rrr r1) setdefaultappendvaluessortrFkeysmingetsortedjoin)cells sequencesrKrLrC seqs_by_colcol_posorderseq_textentries max_cell_col max_seq_colmax_colpartswalk_col col_limit_ cell_textcell_wcs r)_reconstruct_painterrpsz57K$- w+22E3DE%.%%' ().3uzz|$2L-8#k&&()bK,,GEHG!I  &??8R8KAx LL "9 ? MH    % Iv LL #  H0L0 X& MH!  &K$$& ' y=*1~ 8 X& .( 775>r(c H ^/n Sn Sn Sn U(a[OSn U [U5:GaX nX:a,US;a&U bGOURSU S-5nUS:XaGOUn MEUS:XGad[R"X 5nU(dU R U5 U S- n MUR S5b6U(a/U b,[U UR 55n UR5n M[R"UR 55=n(GaH[XX%XdUUUR5U S9 nUR[RLa0U R UR 55 UR5n OUR[RLa UR n OUR[R"LaU UR$- n UR n OxU R UR&5 U R UR(5 U R UR*5 U(aU cU n U UR$- n UR n GM=UR S 5=nbUR S 5nUR S 5nUbUce[-[.R0"UUS 9UU5nUR3U5nX:a:U U-U::a1U R UR555 U(aU cU n U U- n OJX:a@U U-U:a7/mSU4S jjn[7UXX%UU5n U R9T5 U(aU cU n OU U- n UR5n GMHUR 5nU(a-[:R"U5(a[=SU SU<35eU R U5 UR5n GMUS:XahUS:aIXX-- -nU U:a9Xs=::aU:a O OU R S5 U(aU cU n U S- n U U:aM9OU R S5 U S- n GM[?[AX S95nUUS9nUS:Xa!Xs=::aU:aO OU R U5 OrX:a'U U-U::aU R U5 U(aU cU n OFX:aAU U-U:a8U R U[EX*U-5[GX5- -5 U(aU cU n U U- n U [U5- n U [U5:aGMSRIU 5U 4$)z Clip text without cursor movement (simple append-to-output path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNz  r r? sgr_paramsrMrNrOts_metats_textts_termr@c(>TRU5 g)N)rW)s_w_colts_partss r) _ts_write_clip_simple.._ts_write's *r(*Indeterminate cursor sequence at position ,   rKrBr1)rzr2r{r.r|r.returnNone)%rlenfindrmatchrWgrouprrLr parserTr-rr#r$r/r%r0r3r4r5rr from_params display_width make_sequence_text_sizing_clipextendr ValueErrornextr r r[rFr^)rJrKrLrDrBrCrAstrictr@outputrOidxr; current_stylecharnext_escmhl_staterrurvrwtsts_widthr~seqnext_tabgrapheme grapheme_wr}s @r) _clip_simplers*F C C+/N*7&TM D /y :$n4) yyq1H2~C  6>"((3A d#qww|$0]}G` 1- K eeg+00;;x;&!#quuwC 88/888MM!''),%%'CXX!1!7!77++CXX!1!9!991==(C++CMM!**-MM!//2MM!++.$)?)61==(C++C779--:''),''),*w/BBB$00 VW&++O<E#9*,H++C!#CMM(+$)?)68OCeeg'')C7==cBB @Rg MM# %%'C  4<{S]";<Hn)c) c*(^-C-:N1HC Hn d# 1HC t788_E  ?!c! h' \cJ.#5 MM( #!7!. Y3+e3 MM(c#Z/?&@3u?&RS T!7!. z s8}G D /J 776?N **r(c b^^^^TRU5nX:a#X-U::aT"TR5Xq5 X-$X:dX-U::aX-$[SX!- 5n[X1U-5U- n TRR m/n TRR S:a[[TR5TRR 5Hn U RU T45 M [TRR [U 5- 5Hn U RST45 M O9[TR5H n U RU [ XS9T-45 M" /mSUUUU4Sjjn X-nSnU HunnUU-nUU::aUnMX:a O[UU 5[X5- nUU:Xa/US:a)T(dU[X5-nTRUU45 O5U "U5 U[X5-n[U5HnT"USUU-5 M UnM U "U5 X-$)z Emit tokens for a text-sizing (OSC 66) sequence, clipped to (start, end). Calls *write_cells(text, width, col)* for each emitted cell or sequence. Returns new column position. rr1rc>T(dgTVs/sHoSPM nn[ST55n[TTRRS:a [ U5OSTRR TRR TRRTRR5nT"[USRU5TR5R5UU5 TR5 gs snf)Nrc3*# UH oSv M g7f)r Nr).0us r) 3_text_sizing_clip..flush..s2MqdMsr1)sumrrMr r numerator denominatorvertical_alignhorizontal_alignrr^ terminatorrclear) flush_colrtextstotal_wrM pending_unitsscaler write_cellss r)flush _text_sizing_clip..flushs ,-}!1}-2M22! ))//A-CJ1 II  !6!6 II $ $bii&@&@ B  vrwwu~r}} = K K M    .sDr )rr.rr) rrrFr[rMrr rr rJrWranger)rrOrKrLrCrBrr rel_startrel_endunitsgrlr flush_col_posunit_pos unit_textunit_wunit_endoverlap abs_startirrs` ` @@r)rrfs 0H |#-B$$&6~ zS^u,~Au{#I#X~&,G IIOOE#%E yyrww/AA LL!U $BryyU34A LL"e %5 (A LL!U1FNO P),.M OMH" 6f$ y H    h(3x+CC f ! #c(&> >  )V!4 5 - c(66I7^HaQ7$%#( - >r(c  ^^^#^$^%^&0m$[5m&/n Sn Sn Sn Sm#T(a[OSm%SSU#U$U%UU&U4Sjjjn U [U5:GaX nX:a T#bUS:waGOUS:XGaq[R"X 5nU(d+U R XU45 U S- n T(aT#cT%m#U S- n MsUR S5b6T(a/T%b,[T%UR 55m%UR5n M[R"UR 55=n(Gax[XUTXdUUUR5U S9 nUR[RLaCU R XUR 545 U S- n T(aT#cT%m#UR5n OUR[RLa UR n OUR[R"LaU UR$- n UR n OU R XUR&45 U S- n T(aT#cT%m#U "UR(UR*U SS 9 U UR*- n U R XUR,45 U S- n UR.n UR n GM_UR S 5=nbyUR S 5nUR S 5nUbUce[1[2R4"UUS 9UU5n[7UXUTUU 5n T(aT#cT%m#UR5n GMUR 5nU(a-[8R"U5(a[;SU SU<35eUR S5=nb*U(a[=U5S- OSn UR5n GMnUR S5=nbiU(a [=U5OSnU U-nX:a6UU:a0[?[AX5[CUU55H nU "TSU5 M Un UR5n GMUR S5=nbXU(a [=U5OSnU(aUU :a[;SU SUSU S35e[ASU U- 5n UR5n GMWU R XUR 545 U S- n T(aT#cT%m#UR5n GMUS:Xa Sn U S- n GMUS:XaU S:aU S-n U S- n GMUS:XahUS:a6XX-- -nU U:a&Xs=::aU:a O O U "TSU 5 U S- n U U:aM&O$U R XS45 U S- n T(aT#cT%m#U S- n GM3[E[GX S95n[IUUS9n U S:Xa4Xs=::aU:a'O OU R XU45 U S- n T(aT#cT%m#O`X:aU U -U::a U "UU U 5 OGX:aBU U -U:a9[AX5n![?[CX+U -5U!- 5Hn"U "TSU!U"-5 M U U - n U [U5- n U [U5:aGM[KT$XUT5T#4$)z Clip text with cursor movement (painter's algorithm path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNc>[U5HnX$-nUS:a:TRUS- S5SS:XaT S4TUS- 'T RUS- 5 TRUS5SS:XaT S4TUS-'T RUS-5 TRUS5 T RU5 M X4TU'U(a%[U5HnT R X$-5 M T (aTcTmggg)zIWrite *w* cells of text *s* at *write_col*, handling wide-char splitting.rr )r1rN)rr\discardpopadd) rzw write_col is_hyperlinkoffsetsrc_colr;r_rrChyperlink_cellsrDs r) _write_cells#_clip_painter.._write_cellssAhF(G{uyy1g>qAQF&.]gk"''! 4yy'*1-2&.]gk"''! 4 IIgt $  # #G ,6i (##I$67# ^3*N4=r(rrr rsrtT)rrurvrwrxrrhpa_n cforward_n cbackward_nz!Cursor left movement at position z would move z cells left from column z, exceeding string start rrr)F) rzr2rr.rr.rboolrr)&setrrrrrWrrrLr rrTr-rr#r$r/r%r0r3r4r6r5r7rrrrrrr.rrFr[rr r rp)'rJrKrLrDrBrCrArr@r` seq_orderrOrrrrrrrurvrwrrrr n_forwardmove_endrr n_backwardrrr clip_startrr;r_rrs' ` ` @@@@r) _clip_painterrsk*)+E #O,.II C C+/N*7&TM+0+#'+48++* D /y :.4  6>"((3A  #$!78Q  ^%;%2Nqww|$0]}G` 1- K eeg+00;;x;&h!#quuwC 88/888$$caggi%@ANI$)?)6%%'CXX!1!7!77++CXX!1!9!991==(C++C$$cajj%ABNI$)?)6 !//3.241??*C$$cakk%BCNI,,C++C779--:''),''),*w/BBB$00 VW&(C? "!^%;%2Neeg'')C7==cBB @Rg ))6(-c%j1n1eeg ggl33 @/9C Oq ?9E!1"3s?C#4FG$Xq!4Heeg !ww}55 B1seD12 !S:-.eeg   caggi8 9 NI!7!.%%'C  4<C 1HC  6>Qwq 1HC  4<{S]";<Hn)c)$Xq#61HCHn   #$!78Q  ^%;%2N 1HC t788_E  ?!c!  #(!;<Q  ^%;%2N \cJ.#5 :s 3 Y3+e3UJCz)9 :Z GHXq*v*=>I z s8}M D /P yh G WWr(rTr)rCrArBrDr@ overtypingc[US5nX!::agUR5(aUR5(aXU$SU;n U(a U (dSnUcMUS:g=(a@ SU;=(d4 SU;=(d( U =(a [[R "U55nOU(aUS:XaSnU(a[ O[n [U "UUUUUUUUS:HUS 9 6$) u Clip text to display columns (start, end) while preserving all terminal sequences. This function extracts a substring based on visible column positions rather than character indices. Terminal escape sequences are preserved in the output since they have zero display width. If a wide character (width 2) is split at either boundary, it is replaced with ``fillchar``. TAB characters (``\t``) are expanded to spaces up to the next tab stop, controlled by the ``tabsize`` parameter. When cursor movement is detected, a "painter's algorithm" is used, cursor movements actively change the write position, allowing cursor-left and carriage return to overwrite previously written cells. It is assumed that ``text`` begins at column 0. **OSC 8 hyperlinks** are handled specially: the visible text inside a hyperlink is clipped to the requested column range, and the hyperlink is rebuilt around the clipped text. Empty hyperlinks (those with no remaining visible text after clipping) are removed:: >>> clip('\x1b]8;;http://example.com\x07Click This link\x1b]8;;\x07', 6, 10) '\x1b]8;;http://example.com\x07This\x1b]8;;\x07' :param text: String to clip, may contain terminal escape sequences. :param start: Absolute starting column (inclusive, 0-indexed). :param end: Absolute ending column (exclusive). :param fillchar: Character to use when a wide character must be split at a boundary (default space). Must have display width of 1. :param tabsize: Tab stop width (default 8). Set to 0 to pass tabs through as zero-width (preserved in output but don't advance column position). :param ambiguous_width: Width to use for East Asian Ambiguous (A) characters. Default is ``1`` (narrow). Set to ``2`` for CJK contexts. :param propagate_sgr: If True (default), SGR (terminal styling) sequences are propagated. The result begins with any active style at the start position and ends with a reset sequence if styles are active. :param control_codes: How to handle control characters and sequences: - ``'parse'`` (default): Track horizontal cursor movement and clip hyperlink text. Cursor overwrite is always allowed, with best effort results; indeterminate sequences (home, clear, reset, etc.) are preserved as zero-width. - ``'strict'``: Like ``parse``, but raises :exc:`ValueError` on sequences with indeterminate effects (cursor home, clear screen, reset, vertical movement, etc.) matching :func:`width` behavior. Also raises on out-of-bounds horizontal cursor movement. - ``'ignore'``: All control characters are treated as zero-width. Cursor movement is not tracked (fastest path). :param overtyping: Whether to use the painter's algorithm for cursor movement (``\b`` backspace, ``\r`` carriage return, and CSI cursor left/right/position sequences). When ``None`` (default), auto-detects by scanning for these characters in *text*. Set to ``False`` for improved performance when the caller knows *text* contains no cursor movement characters. Set to ``True`` to force the painter's algorithm (useful for testing). Has no effect when ``control_codes='ignore'``. :returns: Substring of ``text`` spanning display columns (start, end), with all terminal sequences preserved and wide characters at boundaries replaced with ``fillchar``. :raises ValueError: If ``control_codes='strict'`` and an indeterminate-effect sequence or out-of-bounds cursor movement is encountered. SGR (terminal styling) sequences are propagated by default. The result begins with any active style and ends with a reset:: >>> clip('\x1b[1;34mHello world\x1b[0m', 6, 11) '\x1b[1;34mworld\x1b[0m' Set ``propagate_sgr=False`` to disable this behavior. .. versionadded:: 0.3.0 .. versionchanged:: 0.5.0 Added ``propagate_sgr`` parameter (default True). .. versionchanged:: 0.7.0 Added ``control_codes`` parameter (default 'parse'). OSC 8 hyperlink-aware clipping. OSC 66 text sizing protocol support. Added ``overtyping`` parameter (default None, auto-detect). Example:: >>> clip('hello world', 0, 5) 'hello' >>> clip('中文字', 0, 3) # Wide char split at column 3 '中 ' >>> clip('a\tb', 0, 10) # Tab expanded to spaces 'a b' rr1rrFignorerrr) rJrKrLrDrBrCrArr@) rFisascii isprintablerrsearchrrr=) rJrKrLrCrArBrDr@rhas_escfn_clips r)rGrGsJ qME | ||~~$**,,#nGW  X % K t^Jtt|JH$:AA$GH   1 )m|G G  #')#   r()r:r2r;zOptional[_SGRState]rr2)rJr2rKr.rLr.rCr2rAr.rBr.r@$Literal['parse', 'strict', 'ignore']rMr rNr.rOr.rr+) r_zdict[int, tuple[str, int]]r`zlist[tuple[int, int, str]]rKr.rLr.rCr2rr2)rJr2rKr.rLr.rDrrBr.rCr2rAr.rrr@rrztuple[str, Optional[_SGRState]])rrrOr.rKr.rLr.rCr2rBr.rzCallable[[str, int, int], None]rr.)rJr2rKr.rLr.rCr2rAr.rBr.rDrr@rrzOptional[bool]rr2))r __future__rr! itertoolsrtypingrrrr_widthr rr hyperlinkr r sgr_staterrrrr text_sizingrrescape_sequencesrrrEnumrr+r=rTrprrrrGrr(r)rs0" ::$100 6>> tyyz" ? ? ? ? ?  ?  ?8? ?? ??D4 %4)4 4 4  4  4nh+ h+ h+ h+  h+  h+h+h+ h+8h+%h+VRR R R R  R  R1R RjcX cX cX cX  cX  cXcXcX cX8cX%cXV:A!%H H H H  H  HHH8HH Hr(