,jw dZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z ddl mZdd lmZmZdd lmZmZmZmZmZdd lmZmZdd lmZmZmZGd dej>Z Gdde Z!ddZ" ddZ# ddZ$ d dZ% d!dZ& d dZ'ddddddd 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_CLOSEEMPTYOUTSIDEVISIBLEO/home/ubuntu/waydroid_script/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_widthr)r+)r+r,F)fillcharr=r> propagate_sgrr<)r+r,r/r0r1r2r3) r find_closer(rr r r!r"maxclipr# make_open make_close)textstartendr?r=r>r<params match_endcol close_startr+ inner_textr,r3inner_clip_startinner_clip_endr0r2s r&_process_hyperlinkrPBs<('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-) setdefaultappendvaluessortrBkeysmingetsortedjoin)cells sequencesrGrHr? seqs_by_colcol_posorderseq_textentries max_cell_col max_seq_colmax_colpartswalk_col col_limit_ cell_textcell_wcs r&_reconstruct_painterrls57K$-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(rnl|} @|dk(r/tj|| }|s| j || dz } u|j d/|r-| +t| |j } |j} tj|j x}rDt|||||||||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 } nC| |kr9| |z|kDr1gdfd }t7|| |||||} | j9|r | | } n| |z } |j} |j }|r&t;j|rt=d| d|| j ||j} u|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_paramsrIrJrKts_metats_textts_termr<c(j|y)N)rS)s_w_colts_partss r& _ts_writez_clip_simple.._ts_write's *r%*Indeterminate cursor sequence at position ,   rGr>r-)rvr.rwr*rxr*returnNone)%rlenfindrmatchrSgrouprrHr parserPr)rr r!r+r"r,r/r0r1rr from_params display_width make_sequence_text_sizing_clipextendr ValueErrornextr r rWrBrZ)rFrGrHr@r>r?r=strictr<outputrKidxr7 current_stylecharnext_escmhl_staterrqrrrststs_widthrzseqnext_tabgrapheme grapheme_wrys @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_E  ?!c! h' E\cJ.#5 MM( #!7!. 3Y3+e3 MM(c#sZ/?&@3uc?&RS T!7!. z s8}G D /J 776?N **r%cRj|}||k\r%||z|krj||||zS||k\s||z|kr||zStd||z }t|||z|z } jj g} jj dkDrttjjj D]} | j| ftjj t| z D]} | jdfn;tjD]#} | j| t | |zf%gdfd } ||z}d}| D]\}}||z}||kr|}|| k\rnt|| t||z }||k(r*|dkDr%s|t||z}j||fn4| ||t||z}t|D]}|d||z|}| |||zS)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. rr-rcsyDcgc]}|d }}tdD}tjjdkDr t |ndjj jj jjjj}t|dj|jj||jycc}w)Nrc3&K|] }|d yw)r Nr$).0us r& z3_text_sizing_clip..flush..s2qad2sr-)sumrrIr r numerator denominatorvertical_alignhorizontal_alignrrZ terminatorrclear) flush_colrtextstotal_wrI 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) rrrBrWrIrr rr rFrSranger)rrKrGrHr?r>rr rel_startrel_endunitsgrhr flush_col_posunit_pos unit_textunit_wunit_endoverlap abs_startirrs` ` @@r&rrfsN 0H e|h#-B$$&#6X~ czS8^u,X~Aus{#I#sX~&,G IIOOE#%E yyrww/A %A LL!U $ %ryyU34 &A LL"e % & ( QA LL!U1oFNO P Q,.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}rst||||||||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}s|j d }|j d }||Jt1t3j4|| ||}t7|| |||| } r#%#|j} |j }|r&t9j|rt;d| d||j dx}$|rt=|dz nd} |j} 3|j dx}a|r t=|nd}| |z}| |kr4||kDr/t?tA| |tC||D] }| d||} |j} |j dx}L|r t=|nd}|r|| kDrt;d| d|d| dtAd| |z } |j} | j | | |j f| dz } r#%#|j} E|dk(r d} | dz } S|dk(r| dkDr| dz} | dz } i|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)rrXdiscardpopadd) rvw write_col is_hyperlinkoffsetsrc_colr7r[rr?hyperlink_cellsr@s 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%rnr rorpT)rrqrrrsrtr{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) rvr.rr*rr*rboolrr)&setrrrrrSrrrHr rrPr)rr r!r+r"r,r/r0r2r1r3rrrrrrr*rrBrWrr r rl)'rFrGrHr@r>r?r=rr<r\ seq_orderrKrrrrrrrqrrrsrrrr 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 !S:-.eeg   c9aggi8 9 NI!7!.%%'C  4<C 1HC  6>Qwq 1HC  4<{'S7]";<Hn)c)$Xq#61HCHn   #y$!78Q  ^%;%2N 1HC t3788_E  ?!c!  #y(!;<Q  ^%;%2N E\cJ.#5 :s 3 3Y3+e3UCJCz)9 :Z GH ?Xq*v*=> ? z s8}M D /P y%h G WWr%r~Tr)r?r=r>r@r< overtypingc Vt|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) 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' rr-rnFignorerrr) rFrGrHr@r>r?r=rr<) rBisascii isprintablerrsearchrrr9) rFrGrHr?r=r>r@r<rhas_escfn_clips r&rCrCsJ qME e| ||~$**,E#nGW  X % K t^Jtt|JH$:AA$GH   1 )m|G G  #')#   r%)r6r.r7zOptional[_SGRState]rr.)rFr.rGr*rHr*r?r.r=r*r>r*r<$Literal['parse', 'strict', 'ignore']rIr rJr*rKr*rr() r[zdict[int, tuple[str, int]]r\zlist[tuple[int, int, str]]rGr*rHr*r?r.rr.)rFr.rGr*rHr*r@rr>r*r?r.r=r*rrr<rrztuple[str, Optional[_SGRState]])rrrKr*rGr*rHr*r?r.r>r*rzCallable[[str, int, int], None]rr*)rFr.rGr*rHr*r?r.r=r*r>r*r@rr<rrzOptional[bool]rr.))r __future__rr itertoolsrtypingrrrr_widthr rr hyperlinkr r sgr_staterrrrr text_sizingrrescape_sequencesrrrEnumrr(r9rPrlrrrrCr$r%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%