$pj|0SrSSKJr 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#S Sjr$S!Sjr%S"Sjr&S!Sjr'SSSSSSSS.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__rI/var/www/html/pdf-tiff/venv/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"X 5upX4S:Xa[[R5$X U n [ XXEUS9nUS:Xa[[R U S9$X-nX::dX:a[[RU US9$[SX- 5nX*- n[U UUX4UUSUS9 n[ UUXEUS9n[[RU UUR5UUR5UUS9$) 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_width term_programr)r/)r/r0F)fillcharrArBrC propagate_sgrr@)r/r0r3r4r5r6r7) r find_closer+rr#r r$r%maxclipr& make_open make_close)textstartendrDrArBrCr@params match_endcol close_startr/ inner_textr0r7inner_clip_startinner_clip_endr4r6s r)_process_hyperlinkrUBs+*'11$BK8+ 0 9 9:: ,J!K a 0 6 6)LL"Jcj 0 8 8I,79 91ek*YN$n'!# 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) setdefaultappendvaluessortrGkeysmingetsortedjoin)cells sequencesrLrMrD seqs_by_colcol_posorderseq_textentries max_cell_col max_seq_colmax_colpartswalk_col col_limit_ cell_textcell_wcs r)_reconstruct_painterrqsz57K$- 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(cN ^/n Sn Sn Sn U(a[OSnU [U5:GaX nX:a,US;a&U bGOURSU S-5nUS:XaGOUn MEUS:XGaf[R"X 5nU(dU R U5 U S- n MUR S5b6U(a/Ub,[UUR 55nUR5n M[R"UR 55=n(GaI[XX&XtUU UUR5U 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 cUn U UR$- n UR n GM>UR S 5=nbUR S 5nUR S 5nUbUce[-[.R0"UU S 9UU5nUR3U5nX:a:U U-U::a1U R UR555 U(aU cUn U U- n OKX:aAU U-U:a8/mSU4S jjn[7UXX&UUU5n U R9T5 U(aU cUn OU U- n UR5n GMJUR 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 cUn U S- n U U:aM9OU R S5 U S- n GM [?[AX S95n[CUUUS9nUS:Xa!Xs=::aU:aO OU R U5 OrX:a'U U-U::aU R U5 U(aU cUn OFX:aAU U-U:a8U R U[EX+U-5[GX5- -5 U(aU cUn 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_paramsrNrOrPts_metats_textts_termr@c(>TRU5 g)N)rX)s_w_colts_partss r) _ts_write_clip_simple.._ts_write-s *r(*Indeterminate cursor sequence at position ,   rLrBrCr1)r{r2r|r.r}r.returnNone)%rlenfindrmatchrXgrouprrMr parserUr-rr#r$r/r%r0r3r4r5rr from_params display_width make_sequence_text_sizing_clipextendr ValueErrornextr r r\rGr_)rKrLrMrErBrCrDrAstrictr@outputrPidxr; current_stylecharnext_escmhl_staterrvrwrxtsts_widthrseqnext_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_(46  ?!c! h' \cJ.#5 MM( #!7!. Y3+e3 MM(c#Z/?&@3u?&RS T!7!. z s8}M D /P 776?N **r(c l^^^^TRU5nX:a#X-U::aT"TR5X5 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 O:[TR5H!n U RU [ XUS9T-45 M# /mSUUUU4SjjnX-nSnU HunnUU-nUU ::aUnMUU :a O[UU 5[UU 5- nUU:Xa0US:a*T(dU[UU 5-nTRUU45 O6U"U5 U[UU 5-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)sumrrNr r numerator denominatorvertical_alignhorizontal_alignrr_ terminatorrclear) flush_colrtextstotal_wrN 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) rrrGr\rNrr rr rKrXranger)rrPrLrMrDrBrCrr rel_startrel_endunitsgrmr flush_col_posunit_pos unit_textunit_wunit_endoverlap abs_startirrs` ` @@r)rrns)"0H |#-B$$&6~ zS^u,~Au{#I#X~&,G IIOOE#%E yyrww/AA LL!U $BryyU34A LL"e %5 (A LLE!'357<=> ?) ,.M OMH" 6f$ y H  w  h(3x+CC f ! #c(I&> >  )V!4 5 - c(I66I7^HaQ7$%#( - >r(c ^^^$^%^&^'0m%[5m'/n Sn Sn Sn Sm$T(a[OSm&SSU$U%U&UU'U4SjjjnU [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(Gay[XUTXtUU UUR5U 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=nbzUR S 5nUR S 5nUbUce[1[2R4"UU S 9UU5n[7UXUTUUU5n T(aT$cT&m$UR5n GMUR 5nU(a-[8R"U5(a[;SU SU<35eUR S5=nb*U(a[=U5S- OSn UR5n GMpUR S5=nbiU(a [=U5OSnU U-nX:a6UU:a0[?[AX5[CUU55H nU"TSU5 M Un UR5n GMUR S5=nbVU(a [=U5OSnU(aUU :a[;SU SUSU S35eU U-n U S:aSn 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 [IU UUS9n!U!S:Xa4Xs=::aU:a'O OU R XU 45 U S- n T(aT$cT&m$O`X:aU U!-U::a U"U U!U 5 OGX:aBU U!-U:a9[AX5n"[?[CX,U!-5U"- 5Hn#U"TSU"U#-5 M U U!- n U [U 5- 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) r{w write_col is_hyperlinkoffsetsrc_colr;r`rrDhyperlink_cellsrEs r) _write_cells#_clip_painter.._write_cellssAhF(G{uyy1g>qAQF&.]gk"''! 4yy'*1-2&.]gk"''! 4 IIgt $  # #G ,6i (##I$67# ^3*N4=r(rsr rtruT)rrvrwrxryrrhpa_n cforward_n cbackward_nz!Cursor left movement at position z would move z cells left from column z, exceeding string start rrr)F) r{r2rr.rr.rboolrr)&setrrrrrXrrrMr rrUr-rr#r$r/r%r0r3r4r6r5r7rrrrrrr.rrGr\rr r rq)(rKrLrMrErBrCrDrArr@ra seq_orderrPrrrrrrrvrwrxrrrr n_forwardmove_endrr n_backwardrrr clip_startrr;r`rrs( ` ` @@@@r) _clip_painterrs{,)+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 z!7Ceeg   caggi8 9 NI!7!.%%'C  4<C 1HC  6>Qwq 1HC  4<{S]";<Hn)c)$Xq#61HCHn   #$!78Q  ^%;%2N 1HC t788_(46  ?!c!  #(!;<Q  ^%;%2N \cJ.#5 :s 3 Y3+e3UJCz)9 :Z GHXq*v*=>I z s8}W D /Z yh G WWr(rTrF)rDrArBrEr@ overtypingrCc[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 "UUUUUU UUUS: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'``. :param term_program: Terminal software identifier for table correction. ``False`` (default) disables override lookup. ``True`` reads the ``TERM_PROGRAM`` or ``TERM`` environment variable for auto-detection. Accepts a canonical terminal name matching :func:`list_term_programs`, such as from XTVERSION_, ENQ_, or ``TERM_PROGRAM``. .. versionadded:: 0.8.0 :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' rr1rsFignorerrr) rKrLrMrErBrCrDrArr@) rGisascii isprintablerrsearchrrr=) rKrLrMrDrArBrEr@rrChas_escfn_clips r)rHrHsZ qME | ||~~$**,,#nGW  X % K t^Jtt|JH$:AA$GH   1 )m|G G  #'!)#   r()r:r2r;zOptional[_SGRState]rr2)rKr2rLr.rMr.rDr2rAr.rBr.rC bool | strr@$Literal['parse', 'strict', 'ignore']rNr rOr.rPr.rr+) r`zdict[int, tuple[str, int]]razlist[tuple[int, int, str]]rLr.rMr.rDr2rr2)rKr2rLr.rMr.rErrBr.rCrrDr2rAr.rrr@rrztuple[str, Optional[_SGRState]])rrrPr.rLr.rMr.rDr2rBr.rCrrzCallable[[str, int, int], None]rr.)rKr2rLr.rMr.rDr2rAr.rBr.rErr@rrzOptional[bool]rCrrr2))r __future__rr! itertoolsrtypingrrrr_widthr rr hyperlinkr r sgr_staterrrrr text_sizingrrescape_sequencesrrrEnumrr+r=rUrqrrrrHrr(r)rs0" ::$100 6>> tyyz" C C C C C  C  CC8C CC CCL4 %4)4 4 4  4  4nl+ l+ l+ l+  l+  l+l+l+l+ l+8l+%l+^UU U U U  U  UU1U UpiX iX iX iX  iX  iXiXiXiX iX8iX%iXb:A!%$Q Q Q Q  Q  QQQ8QQQ Qr(