o jw@s dZddlmZddlZddlmZddlmZmZm Z m Z ddl m Z ddl mZdd lmZmZdd lmZmZmZmZmZdd lmZmZdd lmZmZmZGd ddejZ Gddde Z!dDddZ"dEd%d&Z#dFd+d,Z$dGd1d2Z%dHd7d8Z&dGd9d:Z'd;ddd?dIdBdCZ(dS)Jz*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@s0eZdZdZeZeZeZeZ dS)_HyperlinkActionz.Outcome of processing an OSC 8 hyperlink unit.N) __name__ __module__ __qualname____doc__enumautoNO_CLOSEEMPTYOUTSIDEVISIBLEr"r"N/var/www/html/Deteccion_Ine/venv/lib/python3.10/site-packages/wcwidth/_clip.pyrs  rc@sneZdZUdZded<dZded<dZded<dZd ed <dZd ed <dZ d ed <dZ ded <dZ ded<dS)_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+r,r-r.r/r"r"r"r#r$"s       r$resultr*captured_styleOptional[_SGRState]returncCs0|durt|}r||}t|r|d7}|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. Nz)rr)r1r2prefixr"r"r#_apply_sgr_wrap3s  r6textstartr&endfillchartabsizeambiguous_width control_codes$Literal['parse', 'strict', 'ignore']paramsr match_endcolc Cst||\} } | | fdkrttjS||| } t| |||d} | dkr,ttj| dS| | }||ks8| |kr@ttj| | dStd|| }|| }t | |||||d|d}t||||d}ttj | | | || ||dS) 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). )rB)r=r;r<r)r')r'r(F)r:r;r< propagate_sgrr=)r'r(r+r,r-r.r/) r Z find_closer$rrr rr maxclipr!Z make_openZ make_close)r7r8r9r:r;r<r=r?r@rAZ close_startr'Z inner_textr(r/Zinner_clip_startZinner_clip_endr,r.r"r"r#_process_hyperlinkBsL   rFcellsdict[int, tuple[str, int]] sequenceslist[tuple[int, int, str]]cCsXi}|D]\}}}||g||fq|D]} | q|r(t|nd} |r2t|nd} t| | } g} d}t| |}||kr||dD] \}}| |qL||kr_|d7}qB||vrs||\}}| |||7}n||kr}| krnn| ||d7}||ksFt|D]}||kr||D] \}}| |qqd | 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*. rBrr"rr)) setdefaultappendvaluessortrDkeysmingetsortedjoin)rGrIr8r9r:Z seqs_by_colZcol_posorderZseq_textentriesZ max_cell_colZ max_seq_colZmax_colpartsZwalk_colZ col_limit_Z cell_textZcell_wcr"r"r#_reconstruct_painters>           rYrCboolstricttuple[str, Optional[_SGRState]]c sg} d} d} d} |r tnd} | t|kr:|| }| |kr8|dvr8| dur'n|d| d}|dkr5n|} q|dkrxt|| }|sO| || d7} q|ddurh|rh| durht| |} |} qt |}rt |||||||||| d }|j t jur| ||} n;|j t jur|j} n1|j t jur| |j7} |j} n"| |j| |j| |j|r| dur| } | |j7} |j} q|d }durW|d }|d }|dur|dusJttj||d ||}||}| |kr| ||kr| ||r| dur| } | |7} n3| |krN| ||krNgdfdd }t|| |||||} | |rM| durM| } n| |7} |} q|}|rnt|rntd| d|| ||} q|dkr|dkr| || |}| |kr|| kr|krnn| d|r| dur| } | d7} | |ksn| d| d7} qtt || d}t!||d}|dkr|| kr|krnnI| |nC| |kr| ||kr| ||r| dur| } n'| |kr*| ||kr*| |t"|| |t#|| |r*| dur*| } | |7} | t|7} | t|ksd$| | fS)z Clip text without cursor movement (simple append-to-output path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNz  rrB sgr_paramsr?r@rAts_metats_textts_termr=sr*_wr&_colr4Nonecs|dS)N)rL)rdrerfZts_partsr"r# _ts_write'sz_clip_simple.._ts_write*Indeterminate cursor sequence at position ,   r8r<r))rdr*rer&rfr&r4rg)%r lenfindrmatchrLgrouprr9r parserFr%rrrr'r r(r+r,r-rr from_params display_width make_sequence_text_sizing_clipextendr ValueErrornextr r rPrDrS)r7r8r9rCr<r:r;r[r=outputrAidxr2 current_stylecharZnext_escmhl_staterr`rarbtsts_widthriseqnext_tabgrapheme grapheme_wr"rhr# _clip_simples                                  "  rrr write_cellsCallable[[str, int, int], None]cs|}||kr|||kr||||S||ks%|||kr)||Std||}t||||} jjg} jjdkrnttj jjD] } | | fqOt jjt | D] } | dfqcntj D]} | | t| |dfqsgd fdd } ||}d}| D]T\}}||}||kr|}q|| krn@t|| t||}||kr|dkrψs|t||} ||fn| ||t||}t |D] }|d ||q|}q| |||S) 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)ro flush_colr&r4rgcssdSddD}tddD}tjjdkr t|ndjjjjjjjj}t |d |j  || dS)NcSsg|]}|dqS)rr".0ur"r"r# sz4_text_sizing_clip..flush..css|]}|dVqdS)rNr"rr"r"r# sz3_text_sizing_clip..flush..rr))sumrr?r rp numerator denominatorZvertical_alignZhorizontal_alignrrS terminatorrwclear)rZtextsZtotal_wr?Z pending_unitsscalerrr"r#flushs    z _text_sizing_clip..flushrN)rr&r4rg) rvrwrDrPr?rr rr r7rLrangerp)rrAr8r9r:r<rrZ rel_startZrel_endZunitsgrWrZ flush_col_posZunit_posZ unit_textZunit_wZunit_endZoverlapZ abs_startir"rr#rxfsR    rxc# sitg} d} d} d} drtnd d'd(fd d } | t|kr|| }| |kr<dur<|dkr<n|dkr t|| }|sb| | | |f| d7} r]dur]| d7} q#|ddur{r{dur{t||} q#t |}rt ||||||||| d }|j t jur| | | |f| d7} rdur|} nP|j t jur|j} nF|j t jur| |j7} |j} n7| | | |jf| d7} rdur| |j|j| dd| |j7} | | | |jf| d7} |j} |j} q#|d}durK|d}|d}|dur%|dus'Jttj||d||}t|| |||| } rFdurF|} q#|}|rbt|rbtd| d||d}dur||rut|dnd} |} q#|d}dur|rt|nd}| |}| |kr||krtt | |t!||D] }| d|q|} |} q#|d}dur|rt|nd}|r|| krtd| d|d | d!t d| |} |} q#| | | |f| d7} rdur|} q#|d"krd} | d7} q#|d#kr*| dkr%| d8} | d7} q#|d$krz|dkr_| || |}| |kr^|| krM|krUnn| d| | d7} | |ksAn| | | d$f| d7} ruduru| d7} q#t"t#|| d%}t$||d&} | dkr|| kr|krnnR| | | |f| d7} rdurn;| |kr| | |kr| || | n(| |kr| | |krt || }!tt!|| | |!D] }"| d|!|"q| | 7} | t|7} | t|ks*t%| ||fS))z Clip text with cursor movement (painter's algorithm path). Returns ``(result, captured_style)``. The caller applies SGR wrapping. rNFrdr*wr& write_col is_hyperlinkrZr4rgcst|D]I}||}|dkr)|ddddkr)df|d<|d|dddkrBdf|d<|d|d|q||f|<|rdt|D] }||qZrndurpdSdSdS)zIWrite *w* cells of text *s* at *write_col*, handling wide-char splitting.rr)r)rN)rrQdiscardpopadd)rdrrroffsetZsrc_colr2rGr~r:Zhyperlink_cellsrCr"r# _write_cellss"       z#_clip_painter.._write_cellsr]rr^r_T)rr`rarbrcrjrkhpa_n cforward_n cbackward_nz!Cursor left movement at position z would move z cells left from column z, exceeding string start rlrnro)F) rdr*rr&rr&rrZr4rg)&setr rprrrrLrsrr9r rtrFr%rrrr'r r(r+r,r.r-r/rrrurxrrzr&rrDrPr{r r rY)#r7r8r9rCr<r:r;r[r=rIZ seq_orderrAr}rrrrrr`rarbrrrrZ n_forwardZmove_endrrZ n_backwardrrrZ clip_startrr"rr# _clip_painters:                                )rrmTrt)r:r;r<rCr= overtypingrOptional[bool]c Cst|d}||kr dS|r|r|||Sd|v} |r#| s#d}|dur=|dko;d|vp;d|vp;| o;tt|}n|rE|dkrEd}|rItnt} t| ||||||||d k|d 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)r]FNignorerrr[) r7r8r9rCr<r:r;r[r=) rDisascii isprintablerZrsearchrrr6) r7r8r9r:r;r<rCr=rZhas_escZfn_clipr"r"r#rEs6 e   rE)r1r*r2r3r4r*)r7r*r8r&r9r&r:r*r;r&r<r&r=r>r?r r@r&rAr&r4r$) rGrHrIrJr8r&r9r&r:r*r4r*)r7r*r8r&r9r&rCrZr<r&r:r*r;r&r[rZr=r>r4r\)rrrAr&r8r&r9r&r:r*r<r&rrr4r&)r7r*r8r&r9r&r:r*r;r&r<r&rCrZr=r>rrr4r*))r __future__rr itertoolsrtypingrrrr_widthr rr Z hyperlinkr r Z sgr_stater rrrrZ text_sizingrrZescape_sequencesrrrEnumrr$r6rFrYrrxrrEr"r"r"r#s8       B 7 , Ul