+ Q(iRt^RIHt^RIHt^RIHt^RIHtH t H t H t H t H t HtHtHtHtHtHtHt]'d^RIHtRRRlltR R ltRR R lltRR RlltRRltRRltRRltRRltRRltRRRlltR#)z5Documentation generation functions for cyclopts apps.) TYPE_CHECKING) extract_text)DEFAULT_FORMAT) adjust_filters_for_subcommandbuild_command_chainextract_description extract_usageformat_usage_linegenerate_anchor get_app_infois_all_builtin_flagsiterate_commandsnormalize_command_filtersshould_include_commandshould_show_commands_listshould_show_usage)AppNc V^8dQhRRR\R\R\\,R,R\\,R,R\\,R,R \R \\\R3,,/#) apprinclude_hiddenprefixcommands_filterNexclude_commands parent_pathskip_filtered_commandreturn)boolstrlisttuple)formats"\/Users/agent/.openclaw/workspace/venv/lib/python3.14/site-packages/cyclopts/docs/markdown.py __annotate__r#s33 33 3#Y% 3 3i$& 3 cT! 3 3 %U 3c h.pVf.p\W44wr\W4Fwr\WWV 4'gKT;'d V Pp V 'g#V'dV V 2MT p VP W34WZ.,pV V R2p\ V VVVVVRR7pVP V4K V#)zgRecursively collect all commands for table of contents. Returns a list of (display_name, app) tuples.  F)rrrrrr)rr r _commandsappend_collect_commands_for_tocextend)rrrrrrrcommandsnormalized_commands_filternormalized_exclude_commandsnamesubappskip_this_command display_name nested_path nested_prefixnesteds&&&&&&& r"r)r)sH >W?;)= % 9X^   2FFf6F6F 06fXdV,DL OO\2 3"F* !(4&* * ) +-#"'  7>: Or$czV^8dQhR\\,R\\\R3,,RR/#)rlinesr+rrN)rrr )r!s"r"r#r#Qs4==c=d5e;L6M=RV=r$c 2/pVFwr4VPR4^, pRV,pVP4R,p\V4pW9d#W(;;,^, uu&V RW(, 2pM^W(&VPV RV RV R24K R#) zGenerate TOC entries with proper indentation. Parameters ---------- lines : list[str] List to append TOC entries to. commands : list[tuple[str, "App"]] List of (display_name, app) tuples. r&z _z- [``](#)N)countsplitr r() r6r+ anchor_countsr1_appdepthindentcmd_nameanchors && r"_generate_toc_entriesrDQs%'M& ""3'!+%%%'+ .  "  !Q & !xq!6 78F$%M ! xtH:T&;<'r$cNV^8dQhRRR\R\\R3,/#)rrrrr)rdictr)r!s"r"r#r#ms*E44U CSr$c^/pVP'd\W4F wr4WBV&K V#)aBuild mapping of command names to App objects. Parameters ---------- app : App The app to extract commands from. include_hidden : bool Whether to include hidden commands. Returns ------- dict[str, App] Mapping of command names to App instances. )r'r )rr command_mapr.r/s&& r"_build_command_maprIms2K }}},SALD & B r$cVV^8dQhR\\,R\R\RR/#)rr6content add_blankrN)rrr)r!s"r"r#r#s-d3i#$RVr$cnV'dVPV4V'dVPR4R#R#)zAppend content to lines if present, optionally adding blank line. Parameters ---------- lines : list[str] List to append to. content : str Content to append (only if non-empty). add_blank : bool Whether to add a blank line after content. N)r()r6rKrLs&&&r"_append_if_presentrOs' W Rr$cNV^8dQhRRR\R\\,RR/#)rrr help_formatr6rN)rr)r!s"r"r#r#s-UT#YSWr$c\W4pV'dPVR9p\VRVR7pV'd3VPVP44VPR4R#R#R#)zExtract and render app description. Parameters ---------- app : App The app to extract description from. help_format : str Help format (e.g., "markdown", "rich"). lines : list[str] List to append description to. Npreserve_markuprNmarkdownmd)rrr(strip)rrQr6 descriptionpreserve desc_texts&&& r"_render_description_sectionr\sV&c7K"44 dHM  LL* + LL   r$cdV^8dQhRRR\\,R\\,RR/#)rrr command_chainr6rNrr)r!s"r"r#r#s1uT#YtCyUYr$cB\V4'd\V4pV'dyVPR4\V\4'dTpM\ VRRR7p\ WA4pVPV4VPR4VPR4R#R#R#)zRender usage console block. Parameters ---------- app : App The app to extract usage from. command_chain : list[str] Command chain for usage line. lines : list[str] List to append usage to. z ```consoleNFrSz```rN)rrr( isinstancerrr )rr^r6usage usage_text usage_lines&&& r"_render_usage_sectionresc"  LL &%%%" )%uM *:EJ LL $ LL  LL  r$cV^8dQhRRR\R\R\\,R,R\\,R,R\R \\,R R/#) rrrapp_namerrNrrr6r)rrr)r!s"r"r#r#sn)) )))#Y% ) 3i$& )  ) 9) )r$c \TTV'dV R2MRVVVR7pV'dAVPR4VPR4\Wg4VPR4R#R#)aGenerate and render table of contents. Parameters ---------- app : App The app to generate TOC for. app_name : str Application name for TOC prefixes. include_hidden : bool Whether to include hidden commands. commands_filter : list[str] | None Commands to include. exclude_commands : list[str] | None Commands to exclude. skip_filtered_command : bool Whether to skip the single filtered command in TOC. lines : list[str] List to append TOC to. r&rN)rrrrrz## Table of ContentsN)r)r(rD)rrgrrrrr6 toc_commandss&&&&&&& r" _render_tocrjsa:- %!)(1~r')3 L +, Re2 R r$c>V^8dQhR\\,RR/#)rr6rNr_)r!s"r"r#r#sT#Y4r$cTVP4VPRR7pV!RRV4VP4P4pV'dVVP'd VP RVP R24VP V4VP R4R#R#)zRender a parameter panel as-is. Parameters ---------- panel : HelpPanel The parameter panel to render. formatter : MarkdownFormatter Formatter to use for rendering. lines : list[str] List to append rendered content to. rN)titleN****: )resetcopy get_outputrXrmr()panel formatterr6 panel_copyoutputs&&& r"_render_parameter_panelrwsOO"%J dD*%  ! ! # ) ) +F ;;; LL2ekk]%0 1 V R r$c V^8dQhR\R\\R3,R\\,R\\,R,R\\,R,R\/#) rentriesrHrrnormalized_filterNnormalized_excluder)rrFrset)r!s"r"r#r# sa(( (c5j!(c(3x$ ( C4 (  (r$c.pVFpVP'gKVP^,pVPV4pVf VfVfVPV4KZK\K^\WrW4V4'gKsVPV4K V#)aFilter command entries based on inclusion/exclusion rules. Parameters ---------- entries : list Command entries to filter. command_map : dict[str, App] Mapping of command names to App objects. parent_path : list[str] Parent command path. normalized_filter : set[str] | None Normalized filter set. normalized_exclude : set[str] | None Normalized exclude set. Returns ------- list Filtered command entries. )namesgetr(r) ryrHrrzr{filtered_entriesentryrBr/s &&&&& r"_filter_command_entriesr s6 ;;;{{1~H __X.F~$,1C1K$++E22L,*(ARhnoo$++E2 r$c$V^8dQhRRR\R\R\R\R\\,R,R \R \R \\,R,R \\,R,R \R\R\R\/#)rrr recursiver heading_levelmax_heading_levelr^N generate_tocflatten_commandsrr no_root_titlecode_block_title skip_preambler)rintrr)r!s"r"r#r#6sGG GGG G  G 9t# GGG#Y%G3i$&GGGG Gr$c ^RIHp .pVf.pRpMRpT;'dVRJ;'d\V4^8Hp\W4wpppV'dV 'dRV R2MTpMTpV'gJV 'd V'g:\ W44pVP RV, RV 24VP R4VP PR \R 7pV'gV 'g \WV4V'gV 'g\VVV4V'd+V'g#VP'd\VVW(V VV4V'Eg)VP V.4;_uu_4VP.V4pRRR4\W4wpp.p\VRR 7pV !V^,VR R 7pXEFwppV'gV'dVP 'gK+VP"R8XEd_VP$Uu.uF5pVP&'d\)VVP&4'dK3VNK7 p pV 'gK\+V VVVV4p!V!'dVP,'d VP RVP, R24V!Fp"V"P&'gKV"P&^,p#V RV# 2p$\/V$4p%V"P0'd\3V"P0RRR7MRp&V&'dVP RV# RV% RV& 24KVP RV# RV% R24K VP R4EKEKVP"R8XgEK\5VVV4EK M\W4wpp.pVP'Ede\7W4EFTwp'p(\9V'VVVV(4'gK\;VV'V4p)V'dTp*MV 'd V'gTp*M V^,p*VRJ;'d\V4^8Hp+T+;'dVRJ;'d V'V^,8Hp,T+;'d,VRJ;'d V^,P=V'R,4p-T;'dT,p.T ;'d T;'dT-p/T ;'dT,p0V.'gdV/'g\RP?V)4p1V 'dRV1 R2MT1p2\ V*V4p3VP RV3, RV2 24VP R4T0;'gT/p4V(P VV(.4;_uu_4V(P PR VR 7p5V5R9p6V4'g\V(V)V4\V(V5V4V'EdV(P.V54p7\AV'VV4wp8p9\V8V94wp:p;\V(RR 7p<.p=V'd V^,p>M V^,p>V !V>VR R 7p?T;'d V(Pp@V7EFZwppV'gV'dVP 'gK+VP"R8XEd\CV(4'EdVP$Uu.uF5pVP&'d\)V(VP&4'dK3VNK7 pApVA'gKX@'EdP.p XAFp"V"P&'gKV"P&^,p#V