^j| dZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z ddl mZdd lmZmZdd lmZmZmZmZmZdd lmZmZdd lmZmZmZGd dej>Z Gdde Z!ddZ" ddZ# d dZ$ d!dZ% d"dZ& d!dZ'dddddddd d#dZ(y)$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_SEQUENCEceZdZdZej Zej Zej Zej Z y)_HyperlinkActionz.Outcome of processing an OSC 8 hyperlink unit.N) __name__ __module__ __qualname____doc__enumautoNO_CLOSEEMPTYOUTSIDEVISIBLEF/opt/ringagent/.cad-venv/lib/python3.12/site-packages/wcwidth/_clip.pyrrs98tyy{H DIIKEdiikGdiikGr%rc~eZdZUdZded<dZded<dZded<dZd ed <dZd ed <dZ d ed <dZ ded <dZ ded<y)_HyperlinkResultzn 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_endN) rrrr__annotations__r+r,r/r0r1r2r3r$r%r&r(r("sU IsKHcM3IsM3Jr%r(cN|"t|x}r||z}t|r|dz }|S)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_wrapr93s:!+N; ;6 ;f_F  / i F Mr%c tj|| \} } | | fdk(rttjS|| | } t | ||||}|dk(rttj | S| |z}||ks| |k\rttj| |Std|| z }|| z }t| ||||||d| }t |||||}ttj| ||j||j||S) 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+r,F)fillcharr=r>r? propagate_sgrr<)r+r,r/r0r1r2r3) r find_closer(rr r r!r"maxclipr# make_open make_close)textstartendr@r=r>r?r<params match_endcol close_startr+ inner_textr,r3inner_clip_startinner_clip_endr0r2s r&_process_hyperlinkrQBsE*'11$ BKY8+ 0 9 9::i ,J-!K a 0 6 6)LL{"JUcSj 0 8 8I,79 91eck*3YN$n7'!# M]!M   !!####%#  r%ci}|D])\}}}|j|gj||f+|jD]} | j|rt |j nd} |rt |j nd} t | | } g} d}t | |}||kr|j|dD]\}}| j|||k\r|dz };||vr||\}}| j|||z }n$||cxkr| krnn| j||dz }||krt|j D]&}||kDs ||D]\}}| j|(dj| S)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;rr$r r-) setdefaultappendvaluessortrCkeysmingetsortedjoin)cells sequencesrHrIr@ seqs_by_colcol_posorderseq_textentries max_cell_col max_seq_colmax_colpartswalk_col col_limit_ cell_textcell_wcs r&_reconstruct_painterrms57K$-F w+22E83DEF%%' ).3uzz|$2L-8#k&&()bK, ,GEHGS!I i &??8R8 #KAx LL " # s? MH  u  %h Iv LL #  H0L0 X& MH! i &K$$& '' y=*1~ ' 8 X& '' 775>r%c  g} d} d} d} |rtnd}| t|kr|| }| |k\r'|dvr#| n|jd| dz}|dk(rno|} @|dk(r1tj|| }|s| j || dz } u|j d/|r-|+t||j }|j} tj|j x}rEt|||||||| ||j|  }|jtjur0| j |j |j} n|jtjur |j } n|jtj"ur| |j$z } |j } nr| j |j&| j |j(| j |j*|r| |} | |j$z } |j }  |j d x}|j d }|j d }||Jt-t/j0|| ||}|j3|}| |k\r3| |z|kr+| j |j5|r| |} | |z } nD| |kr:| |z|kDr2gdfd }t7|| ||||||} | j9|r | |} n| |z } |j} |j }|r&t;j|rt=d| d|| j ||j} w|dk(r^|dkDrA| || |zz z}| |krB|| cxkr|krnn| j d|r| |} | dz } | |kr0n| j d| dz } t?tA|| }tC|||}|dk(r || cxkr|kr{nnx| j |nf| |k\r | |z|kr| j ||rF| D|} nA| |kr<| |z|kDr4| j |tE|| |ztG|| z z|r| |} | |z } | t|z } | t|krdjI| | fS)z Clip text without cursor movement (simple append-to-output path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNz  r r; sgr_paramsrJrKrLts_metats_textts_termr<c(j|y)N)rT)s_w_colts_partss r& _ts_writez_clip_simple.._ts_write-s *r%*Indeterminate cursor sequence at position ,   rHr>r?r-)rwr.rxr*ryr*returnNone)%rlenfindrmatchrTgrouprrIr parserQr)rr r!r+r"r,r/r0r1rr from_params display_width make_sequence_text_sizing_clipextendr ValueErrornextr r rXrCr[)rGrHrIrAr>r?r@r=strictr<outputrLidxr7 current_stylecharnext_escmhl_staterrrrsrttsts_widthr{seqnext_tabgrapheme grapheme_wrzs @r& _clip_simplers,F C C+/N*7&TM D /Cy #:$n4) yyq1H2~C  6>"((s3A d#qww|$0]}G` 1- K eeg+00;;x;&%h !#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++CX$!#CMM(+$)?)68OCeeg'')C7==cB @Rg MM# %%'C  4<{'S7]";<Hn)c) c*(^-C-:N1HC Hn d# 1HC t3788_(46  ?!c! h' E\cJ.#5 MM( #!7!. 3Y3+e3 MM(c#sZ/?&@3uc?&RS T!7!. z s8}M D /P 776?N **r%c Tj|}||k\r%||z|krj||||zS||k\s||z|kr||zStd||z } t|||z|z } jj g} jj dkDrttjjj D]} | j| ftjj t| z D]} | jdfnz3_text_sizing_clip..flush..s2qad2sr-)sumrrJr r numerator denominatorvertical_alignhorizontal_alignrr[ terminatorrclear) flush_colrtextstotal_wrJ pending_unitsscaler write_cellss r&flushz _text_sizing_clip..flushs ,-!1--2M22! ))//A-CJ1 II  !6!6 II $ $bii&@&@ B  vrwwu~r}} = K K M    .s C:r )rr*rr) rrrCrXrJrr rr rGrTranger)rrLrHrIr@r>r?rr rel_startrel_endunitsgrir flush_col_posunit_pos unit_textunit_wunit_endoverlap abs_startirrs` ` @@r&rrnsY"0H e|h#-B$$&#6X~ czS8^u,X~Aus{#I#sX~&,G IIOOE#%E yyrww/A %A LL!U $ %ryyU34 &A LL"e % & ( ?A LLE!_'357<=> ? ? ,.M )OMH" 6f$ y H  w  h(3x+CC f ! #c(I&> >  )V!4 5 - c(I66I7^ 8HaQ7 8%( - >r%c  $%&'i%t'g} d} d} d} d$rtnd& d d$%&'fd }| t|kr|| }| |k\r $|dk7rn|dk(rtj|| }|s%| j | | |f| dz } r$&$| dz } e|j d/r-&+t&|j &|j} tj|j x}rtt||||||| ||j|  }|jtjur>| j | | |j f| dz } r$&$|j} n|jtjur |j } n|jtj"ur| |j$z } |j } n| j | | |j&f| dz } r$&$||j(|j*| d | |j*z } | j | | |j,f| dz } |j.} |j } ?|j d x}t|j d }|j d }||Jt1t3j4|| ||}t7|| |||||} r$&$|j} |j }|r&t9j|rt;d| d||j dx}$|rt=|dz nd} |j} 5|j dx}a|r t=|nd}| |z}| |kr4||kDr/t?tA| |tC||D] }|d||} |j} |j dx}I|r t=|nd}|r|| kDrt;d| d|d| d| |z} | dkrd} |j} | j | | |j f| dz } r$&$|j} D|dk(r d} | dz } R|dk(r| dkDr| dz} | dz } h|dk(r_|dkDr4| || |zz z}| |krC|| cxkr|kr nn |d| | dz } | |kr#n| j | | df| dz } r$&$| dz } tEtG|| } tI| ||}!|!dk(r.|| cxkr|krnn~| j | | | f| dz } rc$a&$n^| |k\r| |!z|kr || |!| nF| |krA| |!z|kDr9tA|| }"t?tC|| |!z|"z D]}#|d|"|#z| |!z } | t| z } | t|krtK%| ||$fS)z Clip text with cursor movement (painter's algorithm path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNct|D]}||z}|dkDr9j|dz dddk(r df|dz < j|dz j|dddk(r df|dz< j|dzj|d j|||f|<|r$t|D]} j ||z ryyy)zIWrite *w* cells of text *s* at *write_col*, handling wide-char splitting.rr )r-rN)rrYdiscardpopadd) rww write_col is_hyperlinkoffsetsrc_colr7r\rr@hyperlink_cellsrAs r& _write_cellsz#_clip_painter.._write_cellss Ah -F&(G{uyy1g>qAQF&.]gk"''! 4yy'*1-2&.]gk"''! 4 IIgt $  # #G , -q6i ( 8##I$67 8 ^3*N4=r%ror rprqT)rrrrsrtrur|r}hpa_n cforward_n cbackward_nz!Cursor left movement at position z would move z cells left from column z, exceeding string start r~rr)F) rwr.rr*rr*rboolrr)&setrrrrrTrrrIr rrQr)rr r!r+r"r,r/r0r2r1r3rrrrrrr*rrCrXrr r rm)(rGrHrIrAr>r?r@r=rr<r] seq_orderrLrrrrrrrrrsrtrrrr n_forwardmove_endrr n_backwardrrr clip_startrr7r\rrs( ` ` @@@@r& _clip_painterrs,)+E #O,.II C C+/N*7&TM+0+#'+48++* D /Cy #:.4  6>"((s3A  #y$!78Q  ^%;%2Nqww|$0]}G` 1- K eeg+00;;x;&%h !#quuwC  88/888$$c9aggi%@ANI$)?)6%%'CXX!1!7!77++CXX!1!9!991==(C++C$$c9ajj%ABNI$)?)6 !//3.241??*C$$c9akk%BCNI,,C++C779--:''),''),*w/BBB$00 VW&(UC?  "!^%;%2Neeg'')C7==cB @Rg ))6(-c%j1n1eeg ggl33 @/9C Oq ?9E!1"3sE?C#4FG5$Xq!45eeg !ww}55 B1seD12 z!7Ceeg   c9aggi8 9 NI!7!.%%'C  4<C 1HC  6>Qwq 1HC  4<{'S7]";<Hn)c)$Xq#61HCHn   #y$!78Q  ^%;%2N 1HC t3788_(46  ?!c!  #y(!;<Q  ^%;%2N E\cJ.#5 :s 3 3Y3+e3UCJCz)9 :Z GH ?Xq*v*=> ? z s8}W D /Z y%h G WWr%rTrF)r@r=r>rAr< overtypingr?cXt|d}||kry|jr|jr|||Sd|v} |r| sd}|6|dk7xr.d|vxs(d|vxs"| xrtt j |}n |r|dk(rd}|rt nt} t| |||||| |||dk(| S) ua 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' rr-roFignorerrr) rGrHrIrAr>r?r@r=rr<) rCisascii isprintablerrsearchrrr9) rGrHrIr@r=r>rAr<rr?has_escfn_clips r&rDrDsZ qME e| ||~$**,E#nGW  X % K t^Jtt|JH$:AA$GH   1 )m|G G  #'!)#   r%)r6r.r7zOptional[_SGRState]rr.)rGr.rHr*rIr*r@r.r=r*r>r*r? bool | strr<$Literal['parse', 'strict', 'ignore']rJr rKr*rLr*rr() r\zdict[int, tuple[str, int]]r]zlist[tuple[int, int, str]]rHr*rIr*r@r.rr.)rGr.rHr*rIr*rArr>r*r?rr@r.r=r*rrr<rrztuple[str, Optional[_SGRState]])rrrLr*rHr*rIr*r@r.r>r*r?rrzCallable[[str, int, int], None]rr*)rGr.rHr*rIr*r@r.r=r*r>r*rArr<rrzOptional[bool]r?rrr.))r __future__rr itertoolsrtypingrrrr_widthr rr hyperlinkr r sgr_staterrrrr text_sizingrrescape_sequencesrrrEnumrr(r9rQrmrrrrDr$r%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%