
    ziK                    &   d Z ddlmZ ddlZddlmZmZmZ ddlm	Z	 ddl
mZ ddlmZ ddlmZ dd	lmZmZ dd
lmZ ddlmZmZ ddlmZ ddlmZ ddlmZmZmZ ddl m!Z! ddl"m#Z#m$Z$m%Z% er.ddl&m'Z' ddl(m)Z)m*Z* ddl+m,Z,m-Z- ddl.m/Z/ ddl0m1Z1 ddl2m3Z3 ddl4m5Z5  ej6        e7          Z8 G d dee9e:e:f                            Z; G d de;          Z< G d de<          Z= G d de!          Z> G d  d!e          Z? G d" d#e          Z@d)d(ZAdS )*zThe JavaScript domain.    )annotationsN)TYPE_CHECKINGAnycast)nodes)
directives)addnodes)ObjectDescription)DomainObjType)_pseudo_parse_arglist)___)XRefRole)logging)FieldGroupedField
TypedField)SphinxDirective)make_idmake_refnodenested_parse_with_titles)Iterator)ElementNode)desc_signaturepending_xref)Sphinx)Builder)BuildEnvironment)
OptionSpecc            	          e Zd ZU dZdZdZej        ej        ej        ej        ej        ej        ej        ej        dZde	d<   ddZ
ddZddZddZddZd dZd dZd!dZdS )"JSObjectz-
    Description of a JavaScript object.
    F)no-indexno-index-entryno-contents-entryno-typesettingnoindexnoindexentrynocontentsentrysingle-line-parameter-listr!   option_specreturn
list[Node]c                    g S N selfs    d/var/www/tmov.alphamb/tmov_inventario/venv/lib/python3.11/site-packages/sphinx/domains/javascript.pyget_display_prefixzJSObject.get_display_prefix;   s    	    sigstrsignoder   tuple[str, str]c           	     F   |                                 }d|v rX|dd         dk    rJ|                    dd          \  }}|                                 }|dd                                          }n|}d}| j        j                            dd          }| j        j                            d          }|}	 |                    dd          \  }}	n# t          $ r |}	d	}Y nw xY w|	}|r|rd                    ||g          }n0||r|}n)# |	}|r|rd                    ||g          }n||r|}w xY w|}
|rd                    ||g          }
||d
<   ||d<   |
|d<   | j        j        j	        p| j        j        j
        pd}d| j        vot          |          |cxk    odk    nc }|                                 }|r|t          j        d	d	g|R  z  }d}|r|}n|r|}|rbt          j        d	d	          }|                    d          D ]2}|t          j        ||          z  }|t          j        dd          z  }3||z  }|t          j        d	d	t          j        ||                    z  }| j        r*|s|t          j                    z  }nt-          |||           |
|fS )zBreaks down construct signatures

        Parses out prefix and argument list from construct definition. The
        namespace and class will be determined by the nesting of domain
        directives.
        (N)   	js:object	js:module. moduleobjectfullnamer   r+   )stripsplitenvref_contextgetrsplit
ValueErrorjoinconfig(javascript_maximum_signature_line_lengthmaximum_signature_line_lengthoptionslenr5   r	   desc_annotationdesc_addnamedesc_sig_namedesc_sig_punctuation	desc_namehas_argumentsdesc_parameterlistr   )r3   r7   r9   memberarglistprefixmod_namenamemember_prefixmember_namerF   max_lenmulti_line_parameter_listdisplay_prefixactual_prefixaddNameps                    r4   handle_signaturezJSObject.handle_signature?   sV    iikk#::#bcc(c//!iiQ//OFG\\^^Fcrcl((**GGFG%))+t<<8'++K88
	')/sA)>)>&M;; 	 	 	KMMM	 D '- '6="9::M&	 D '- '6="9::M&&&&& 	0xx//H$"&
8?K hoC 	 )< )SG''''a'''' 	"
 0022 	Ix/BHHHHHG 	%"MM 	%$M 	+B33G"((-- C C81!Q77788cBBBwG8%b"h.DT4.P.PQQQ 	S S86888%gw8QRRRs*   7C D
 C"D
 !C""D
 
&D0sig_nodetuple[str, ...]c                    d|vrdS |                     d          }|d         }|r|g|                    d          R S t          |                    d                    S )NrF   r1   rD   rB   )rK   rH   tuple)r3   ri   modnamerF   s       r4   _object_hierarchy_partsz JSObject._object_hierarchy_parts   sl    X%%2,,x((J' 	.2hnnS11222,,---r6   name_objNonec                H   | j         j                            d          }|r|dz   nd|d         z   }t          | j         | j        j        d|          }|d                             |           | j        j                            |           t          t          | j         
                    d                    }|                    || j        ||           d| j        vr?|                     ||          }|r)| j        d	                             d
||dd f           d S d S d S )NrA   rB   rC   r   idsjslocationr%   entriessingle)rI   rJ   rK   r   statedocumentappendnote_explicit_targetr   JavaScriptDomain
get_domainnote_objectobjtyperR   get_index_text	indexnode)	r3   ro   r7   r9   r^   rF   node_iddomain	indextexts	            r4   add_target_and_indexzJSObject.add_target_and_index   s,   8'++K88&.6HsNNB(1+E$(DJ$7XFFg&&&
00999&(;(;D(A(ABB8T\7WMMM4<//++Hh??I [y)00(IwPRTX1YZZZZZ 0/[ [r6   
objectnamec                (   |\  }}| j         dk    r(|st          d          |z  S t          d          ||fz  S | j         dk    rt          d          |z  S | j         dk    rt          d          |z  S | j         dk    rt          d	          ||fz  S d
S )Nfunctionz%s() (built-in function)z%s() (%s method)classz%s() (class)dataz %s (global variable or constant)	attributez%s (%s attribute)rC   )r   r   )r3   r   ro   r_   objs        r4   r   zJSObject.get_index_text   s    	c<:%% <344t;;'((D#;66\W$$^$$t++\V##7884??\[((())T3K77rr6   c                6   d}| j         r>| j                                         \  }}|r|                    d          nd}| j        r|}|rM|| j        j        d<   | j        r9| j        j                            dg           }|                    |           dS dS dS )a  Handle object nesting before content

        :py:class:`JSObject` represents JavaScript language constructs. For
        constructs that are nestable, this method will build up a stack of the
        nesting hierarchy so that it can be later de-nested correctly, in
        :py:meth:`after_content`.

        For constructs that aren't nestable, the stack is bypassed, and instead
        only the most recent object is tracked. This object prefix name will be
        removed with :py:meth:`after_content`.

        The following keys are used in ``self.env.ref_context``:

            js:objects
                Stores the object prefix history. With each nested element, we
                add the object prefix to this list. When we exit that object's
                nesting level, :py:meth:`after_content` is triggered and the
                prefix is removed from the end of the list.

            js:object
                Current object prefix. This should generally reflect the last
                element in the prefix history
        NrB   r@   
js:objects)namespoprG   allow_nestingrI   rJ   
setdefaultrz   )r3   r]   obj_nameobj_name_prefixobjectss        r4   before_contentzJSObject.before_content   s    0 : 	"*.*..*:*:'X3BL_**3///F! "! 	'06DH -! '(.99,KKv&&&&&		' 	'' 'r6   c                2   | j         j                            dg           }| j        rEt	          j        t                    5  |                                 ddd           n# 1 swxY w Y   t          |          dk    r|d         nd| j         j        d<   dS )a^  Handle object de-nesting after content

        If this class is a nestable object, removing the last nested class prefix
        ends further nesting in the object.

        If this class is not a nestable object, the list of classes should not
        be altered as we didn't affect the nesting levels in
        :py:meth:`before_content`.
        r   Nr   r=   r@   )	rI   rJ   r   r   
contextlibsuppress
IndexErrorr   rS   )r3   r   s     r4   after_contentzJSObject.after_content   s     (&11,CC 	$Z00                 =@LL1<L<LWR[[26 	[)))s   A""A&)A&c                v   |                     d          sdS | j        j        j        }|j                             d          }|j        r|dv rd}nd}|d         ^ }}|j        dk    r|                     d|          |z   S |j        dk    r||z   S |j        d	k    rd
                    |||z   gz             S dS )N
_toc_partsrC   r   >   methodr   ()r   rF   hideallrB   )rK   rI   apprO   parentadd_function_parenthesestoc_object_entries_show_parentsrN   )r3   ri   rO   r   parensparentsr_   s          r4   _toc_entry_namezJSObject._toc_entry_name   s    ||L)) 	2$/%%i00* 	w:P/P/PFFF!,/$1X==<<
D11F::1V;;&= 1U::88Gtf}o5666rr6   Nr-   r.   )r7   r8   r9   r   r-   r:   )ri   r   r-   rj   )ro   r:   r7   r8   r9   r   r-   rp   )r   r8   ro   r:   r-   r8   )r-   rp   )ri   r   r-   r8   )__name__
__module____qualname____doc__rY   r   r   flagr,   __annotations__r5   rh   rn   r   r   r   r   r   r1   r6   r4   r#   r#   $   s"         
 M M O$/'_$/?"%?&0o	 	K 	 	 	 	   D  D  D  D L	. 	. 	. 	.[ [ [ [    "' "' "' "'H8 8 8 8$     r6   r#   c            	          e Zd ZdZdZ ed ed          ddd           ed	 ed
          ddd           ed ed          dd           ed ed          dd          gZ	dS )
JSCallablez<Description of a JavaScript function, method or constructor.T	arguments	Arguments)argumentarg	parameterparamfunc)	paramtypetype)labelr   typerolename	typenameserrorsThrows)throws)r   rolenamer   can_collapsereturnvalueReturnsF)returnsr-   )r   has_argr   
returntypezReturn type)rtypeN)
r   r   r   r   rY   r   r   r   r   doc_field_typesr1   r6   r4   r   r      s        FFM 	
;aannB &2G	I 	I 	I 	XQQx[[6'"&	( 	( 	( 	m11Y<<)	+ 	+ 	+l!!M"2"2E	  	  	 OOOr6   r   c                      e Zd ZdZdZddZdS )JSConstructorz,Like a callable but with a different prefix.Tr-   r.   c                R    t          j        dd          t          j                    gS )Nr   )r	   desc_sig_keyworddesc_sig_spacer2   s    r4   r5   z JSConstructor.get_display_prefix  s(    )'7;;'))+ 	+r6   Nr   )r   r   r   r   r   r5   r1   r6   r4   r   r   
  s3        66M+ + + + + +r6   r   c                  x    e Zd ZU dZdZdZdZdZej	        ej	        ej	        ej	        ej	        dZ
ded<   ddZdS )JSModulea  
    Directive to mark description of a new JavaScript module.

    This directive specifies the module name that will be used by objects that
    follow this directive.

    Options
    -------

    no-index
        If the ``:no-index:`` option is specified, no linkable elements will be
        created, and the module won't be added to the global module index. This
        is useful for splitting up the module definition across multiple
        sections or files.

    :param mod_name: Module name
    Tr?   r   F)r$   r&   r'   r(   r*   r!   r,   r-   r.   c                   | j         d                                         }|| j        j        d<   d| j        v pd| j        v }t          j                    }| j        j        |_        t          | j        | j
        || j                   g }|st          t          | j                            d                    }t          | j        | j        j        d|          }|                    ||           |                    |d|| j        j        | j        f           t)          d          |z  }t+          j        d	||d
d fg          }|                    |           t          j        d
d
|gd          }	| j        j                            |	           |                    |	           |                    |j                   |S )Nr   rA   r$   r(   rs   rD   rt   z%s (module)rw   rC   )rv   T)rr   ismod)r   rG   rI   rJ   rR   r   sectionrx   ry   r   contentcontent_offsetr   r|   r}   r   note_moduler~   docnamelinenor   r	   indexrz   targetr{   extendchildren)
r3   r^   no_indexcontent_noderetr   r   r   inoder   s
             r4   runzJSModule.run3  s   >!$**,,,4[)-Jdl1J % $
 3 T\<I\]]] 	*DH,?,?,E,EFFFdh
(;XxPPGx111 x7)-)94;(G  I I I -((83INXy'2t,T+UVVVEJJu\"bwitDDDFJ44V<<<JJv

<()))
r6   Nr   )r   r   r   r   has_contentrequired_argumentsoptional_argumentsfinal_argument_whitespacer   r   r,   r   r   r1   r6   r4   r   r     s          $ K %O'_$/?%? K         r6   r   c                      e Zd ZddZdS )
JSXRefRolerI   r    refnoder   has_explicit_titlebooltitler8   r   r-   r:   c                   |j                             d          |d<   |j                             d          |d<   |sj|                    d          }|                    d          }|dd         dk    r2|dd          }|                    d          }|dk    r||dz   d          }|dd         dk    r|dd          }d|d	<   ||fS )
Nr@   rA   rB   ~r   r?   r=   Trefspecific)rJ   rK   lstriprfind)r3   rI   r   r   r   r   dots          r4   process_linkzJSXRefRole.process_linkT  s      #22;??"22;??! 	,LL%%E]]3''FQqSzS  abb	kk#&&"99!#'((OE!A#;#ABBZF%)GM"f}r6   N)rI   r    r   r   r   r   r   r8   r   r8   r-   r:   )r   r   r   r   r1   r6   r4   r   r   S  s(             r6   r   c            
      6   e Zd ZU dZdZdZ e ed          d           e ed          d           e ed          d           e ed	          d	           e ed
          d           e ed          d          dZe	e	e
eeedZ ed           ed           ed           e             e             e            dZi i dZded<   edGd            Z	 dHdId ZedJd"            ZdKd$ZdLd&ZdMd+Z	 dNdOd7ZdPdAZdQdCZdRdEZdSdFZdS )Tr|   zJavaScript language domain.rs   
JavaScriptr   r   r   methr   r   r   attrrD   mod)r   r   r   r   r   rD   T)
fix_parens)r   r   r   r   r   r   )r   modulesz%dict[str, dict[str, tuple[str, str]]]initial_datar-   dict[str, tuple[str, str, str]]c                8    | j                             di           S )Nr   r   r   r2   s    r4   r   zJavaScriptDomain.objects      y##Ir222r6   NrF   r8   r   r   ru   r   rp   c                    || j         v r@| j         |         d         }t                              t          d          |||||           | j        j        ||f| j         |<   d S )Nr   z.duplicate %s description of %s, other %s in %srt   )r   loggerwarningr   rI   r   )r3   rF   r   r   ru   r   s         r4   r~   zJavaScriptDomain.note_object  sr    t|##l8,Q/GNN2NOO"Hgw  S S S"&("2GW!EXr6   dict[str, tuple[str, str]]c                8    | j                             di           S )Nr   r   r2   s    r4   r   zJavaScriptDomain.modules  r   r6   rm   c                2    | j         j        |f| j        |<   d S r0   )rI   r   r   )r3   rm   r   s      r4   r   zJavaScriptDomain.note_module  s    !%!17 ;Wr6   r   c                    t          | j                                                  D ]\  }\  }}}||k    r| j        |= t          | j                                                  D ]\  }\  }}||k    r| j        |= d S r0   )listr   itemsr   )r3   r   rF   pkg_docname_node_id_lrm   s          r4   	clear_doczJavaScriptDomain.clear_doc  s    59$,:L:L:N:N5O5O 	+ 	+1H1{Hbg%%L*04T\5G5G5I5I0J0J 	* 	*,G,k8g%%L)	* 	*r6   docnames	list[str]	otherdatadict[str, Any]c                    |d                                          D ]\  }\  }}}||v r|||f| j        |<   |d                                          D ]\  }\  }}||v r||f| j        |<   d S )Nr   r   )r  r   r   )	r3   r  r  rF   fnr   r   r^   r  s	            r4   merge_domaindataz!JavaScriptDomain.merge_domaindata  s    09)0D0J0J0L0L 	@ 	@,H,r7GX~~*,gw)?X&09)0D0J0J0L0L 	@ 	@,H,{Gh&&*5w)?X&	@ 	@r6   r   rI   r    r^   r]   r_   typ
str | Nonesearchorderint.tuple[str | None, tuple[str, str, str] | None]c                   |dd          dk    r
|d d         }g }|r-|r+|                     d                    |||g                     |r*|                     d                    ||g                     |r*|                     d                    ||g                     |                     |           |dk    r|                                 d }d }	|D ]}
|
| j        v r|
}| j        |
         }	||	fS )Nr   rB   r   )rz   rN   reverser   )r3   rI   r^   r]   r_   r  r  searchesnewnameobject_search_names              r4   find_objzJavaScriptDomain.find_obj  s&    99D 	@ 	@OOCHHh%=>>??? 	8OOCHHh%566777 	6OOCHHfd^44555!# 	4 	4Kdl**%,{3r6   fromdocnamebuilderr   r   noder   contnoder   Element | Nonec                
   |                     d          }|                     d          }	|                    d          rdnd}
|                     |||	|||
          \  }}|sd S t          |||d         |d         ||          S )NrA   r@   r   r?   r   )rK   hasattrr  r   )r3   rI   r   r!  r  r   r"  r#  r^   r]   r  r_   r   s                r4   resolve_xrefzJavaScriptDomain.resolve_xref  s     88K((+&&<<66=aaAMM#xkRR	c 	4G[#a&#a&(DQQQr6   list[tuple[str, Element]]c           	        |                     d          }|                     d          }|                     ||||d d          \  }	}
|
sg S d|                     |
d                   z   t          |||
d         |
d         ||	          fgS )NrA   r@   r?   zjs:   r   )rK   r  role_for_objtyper   )r3   rI   r   r!  r   r"  r#  r^   r]   r_   r   s              r4   resolve_any_xrefz!JavaScriptDomain.resolve_any_xref  s     88K((+&&MM#xqII	c 	I..s1v666g{CFCFHdSSU V 	Vr6   -Iterator[tuple[str, str, str, str, str, int]]c              #  ~   K   t          | j                                                  D ]\  }\  }}}|||||dfV  d S )Nr?   )r  r   r  )r3   refnamer   r   r  s        r4   get_objectszJavaScriptDomain.get_objects  s]      04T\5G5G5I5I0J0J 	= 	=,G,gw7C'1<<<<<	= 	=r6   c                    |                     d          }|                     d          }|                     d          }|d S d                    t          d |||g                    S )NrA   r@   	reftargetrB   )rK   rN   filter)r3   r"  rm   r]   r   s        r4   get_full_qualified_namez(JavaScriptDomain.get_full_qualified_name  sb    ((;''+&&+&&>488F4'66)BCCDDDr6   )r-   r   r0   )
rF   r8   r   r8   r   r8   ru   r   r-   rp   )r-   r  )rm   r8   r   r8   r-   rp   )r   r8   r-   rp   )r  r  r  r  r-   rp   )r   )rI   r    r^   r8   r]   r8   r_   r8   r  r  r  r  r-   r  )rI   r    r   r8   r!  r   r  r8   r   r8   r"  r   r#  r   r-   r$  )rI   r    r   r8   r!  r   r   r8   r"  r   r#  r   r-   r(  )r-   r-  )r"  r   r-   r  )r   r   r   r   r_   r   r   r   object_typesr   r   r#   r   r   r   rolesr   r   propertyr   r~   r   r   r  r  r  r'  r,  r0  r4  r1   r6   r4   r|   r|   g  s        %%DE WQQz]]V44WQQx[[V44WQQwZZW55WQQvYYV44WQQ{^^V44WQQx[[U33 L  " J t,,,t,,,t,,, E ; ;L    
 3 3 3 X3 %)F F F F F 3 3 3 X3< < < <* * * *@ @ @ @           B	R 	R 	R 	R	V 	V 	V 	V= = = =E E E E E Er6   r|   r   r   r-   r  c                    |                      t                     |                     dd dt          d h           dddddS )NrP   rI   )typesbuiltin   T)versionenv_versionparallel_read_safeparallel_write_safe)
add_domainr|   add_config_valuer  )r   s    r4   setuprB    s\    NN#$$$2D%T{     "#	  r6   )r   r   r-   r  )Br   
__future__r   r   typingr   r   r   docutilsr   docutils.parsers.rstr   sphinxr	   sphinx.directivesr
   sphinx.domainsr   r   sphinx.domains.pythonr   sphinx.localer   r   sphinx.rolesr   sphinx.utilr   sphinx.util.docfieldsr   r   r   sphinx.util.docutilsr   sphinx.util.nodesr   r   r   collections.abcr   docutils.nodesr   r   sphinx.addnodesr   r   sphinx.applicationr   sphinx.buildersr   sphinx.environmentr    sphinx.util.typingr!   	getLoggerr   r   rl   r8   r#   r   r   r   r   r|   rB  r1   r6   r4   <module>rY     s*     " " " " " "     + + + + + + + + + +       + + + + + +       / / / / / / * * * * * * * * 7 7 7 7 7 7         ! ! ! ! ! !       A A A A A A A A A A 0 0 0 0 0 0 M M M M M M M M M M 	.((((((,,,,,,,,<<<<<<<<))))))''''''333333------		8	$	$Q Q Q Q Q sCx1 Q Q Qh       $+ + + + +J + + +< < < < < < < <~       (HE HE HE HE HEv HE HE HEV
 
 
 
 
 
r6   