lKj86dZddlZddlmZmZddlmZmZmZm Z ddl m Z m Z erddl mZejeZGdd ZGd d ZGd d ZGddZGddZGddZGddZGddZGddZdZy)aw macOS Accessibility action-based patterns. Wraps AXUIElement actions and attributes into pattern-like interfaces similar to Windows UIA patterns (InvokePattern, ValuePattern, etc.). On macOS, there are no formal COM pattern interfaces like Windows UIA. Instead, patterns are logical groupings of related AX actions and attributes that provide a consistent interaction API. N) TYPE_CHECKINGAny) GetAttribute SetAttribute PerformActionIsAttributeSettable)Action AttributeControlcFeZdZdZdeddfdZdefdZededefdZ y) InvokePatternz Pattern for invoking (pressing/clicking) elements. Equivalent to Windows UIA InvokePattern. Applies to: Buttons, links, menu items, and other clickable elements. elementreturnNc||_yN_elementselfrs f/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/macos_mcp/ax/patterns.py__init__zInvokePattern.__init__'  cJt|jtjS)zW Invoke the element (press/click). Returns True if successful. rrr Pressrs rInvokezInvokePattern.Invoke*s T]]FLL99rcBddlm}||}tj|vS)z1Check if the element supports the Invoke pattern.rGetActionNames)corer#r rrr#actionss r IsSupportedzInvokePattern.IsSupported1s  ) )||w&&r) __name__ __module__ __qualname____doc__rrboolr staticmethodr'rrrrsH   ::'S'T''rrceZdZdZdeddfdZedZejd dZede fdZ de fd Z e dede fd Z y) ValuePatternz Pattern for getting and setting element values. Equivalent to Windows UIA ValuePattern. Applies to: Text fields, text areas, sliders, combo boxes. rrNc||_yrrrs rrzValuePattern.__init__BrrcJt|jtjS)Get the current value.rrr Valuers rr5zValuePattern.ValueEsDMM9??;;rcNt|jtj|yzSet the value.Nrrr r5rvalues rr5zValuePattern.ValueJ T]]IOOU;rcLt|jtj S)z Check if the value is read-only.)r rr r5rs r IsReadOnlyzValuePattern.IsReadOnlyOs't}}iooFFFrcLt|jtj|S)z(Set the value and return success status.r8r9s rSetValuezValuePattern.SetValueTsDMM9??EBBrc>ddlm}tj||vS)z0Check if the element supports the Value pattern.rGetAttributeNames)r$rBr r5rrBs rr'zValuePattern.IsSupportedXs ,"3G"<<.>'.IIr)r(r)r*r+rrrDrKr5rErTrXr,rZr]r-r'r.rrrGrG`s   u \\<54>>4>JSJTJJrrGcheZdZdZdZedefdZedefdZ defdZ e de defdZ y ) TogglePatternz Pattern for toggling elements (checkboxes, switches). Equivalent to Windows UIA TogglePattern. Applies to: Checkboxes, toggle switches. c||_yrrrs rrzTogglePattern.__init__rrrcrt|jtj}|y|dus|dk(ry|dk(ryy)zd Get the current toggle state. Returns: 0 = off, 1 = on, 2 = indeterminate. rTrr4rNs r ToggleStatezTogglePattern.ToggleStates= 4==)//: ; $;#( !8rc |jdk(S)zCheck if the toggle is on.r)rdrs rIsOnzTogglePattern.IsOns1$$rcJt|jtjS)zToggle the state.rrs rTogglezTogglePattern.ToggleT]]FLL99rrcDddlm}||tj}|dvS)z1Check if the element supports the Toggle pattern.rr) AXCheckBoxAXToggleAXSwitchr$rr Roler_GetAttrroles rr'zTogglePattern.IsSupporteds# 30===rN)r(r)r*r+rrDintrdr,rfrhr-rr'r.rrr`r`sp  S  %d%%::>S>T>>rr`cheZdZdZdeddfdZedefdZdefdZ defdZ e dedefd Z y) ExpandCollapsePatternz Pattern for expanding/collapsing elements. Equivalent to Windows UIA ExpandCollapsePattern. Applies to: Disclosure triangles, outline rows, combo boxes. rrNc||_yrrrs rrzExpandCollapsePattern.__init__rrct|jtj}||duSt|jtj}|dk(xs|duS)z!Check if the element is expanded.Tr)rrr Expandedr5rNs r IsExpandedz ExpandCollapsePattern.IsExpandedsP4==)*<*<= ?$; 4==)//:ax&3$;&rcd|js$t|jtjSy)zExpand the element.Trzrrr rrs rExpandzExpandCollapsePattern.Expands!  = =rcd|jr$t|jtjSy)zCollapse the element.Tr|rs rCollapsezExpandCollapsePattern.Collapses! ??  = =rcBddlm}||}tj|vS)z9Check if the element supports the ExpandCollapse pattern.rrA)r$rBr ryrrBattrss rr'z!ExpandCollapsePattern.IsSupporteds" ,!'*!!U**r) r(r)r*r+rrrDr,rzr}rr-r'r.rrrvrvso   'D'' $ +S+T++rrvceZdZdZdeddfdZedefdZedefdZ ede fdZ ede fd Z d e de fd Zedede fd Zy) ScrollPatternz Pattern for scrolling elements. Equivalent to Windows UIA ScrollPattern. Applies to: Scroll areas, lists, tables. rrNc||_yrrrs rrzScrollPattern.__init__rrct|jtj}|r+t|tj}| t |dzSy#t tf$rYywxYw)z.Get horizontal scroll position (0.0 to 100.0).rVrJ)rrr HorizontalScrollBarr5rKrLrM)rh_barrOs rHorizontalScrollPercentz%ScrollPattern.HorizontalScrollPercentsgT]]I,I,IJ uioo6C :--":. AA%$A%ct|jtj}|r+t|tj}| t |dzSy#t tf$rYywxYw)z,Get vertical scroll position (0.0 to 100.0).rVrJ)rrr VerticalScrollBarr5rKrLrM)rv_barrOs rVerticalScrollPercentz#ScrollPattern.VerticalScrollPercent sgT]]I,G,GH uioo6C :--":.rcNt|jtjduS)z*Check if horizontal scrolling is possible.N)rrr rrs rHorizontallyScrollablez$ScrollPattern.HorizontallyScrollables!DMM9+H+HIQUUUrcNt|jtjduS)z(Check if vertical scrolling is possible.N)rrr rrs rVerticallyScrollablez"ScrollPattern.VerticallyScrollables DMM9+F+FGtSSr directionctjtjtjtjd}|j |j }|rt|j|Sy)z Scroll by one page in the given direction. Args: direction: 'up', 'down', 'left', or 'right'. )updownleftrightF) r ScrollUpByPageScrollDownByPageScrollLeftByPageScrollRightByPagegetlowerrr)rr action_mapactions r ScrollByPagezScrollPattern.ScrollByPage!s]''++++--    12  7 7rc~t|tj}t|tj}|duxs|duS)z1Check if the element supports the Scroll pattern.N)rr rr)rrrs rr'zScrollPattern.IsSupported3s=Wi&C&CDWi&A&ABD 5E$55r)r(r)r*r+rrrDrKrrr,rrstrrr-r'r.rrrrs       u  VVVTdTTcd$6S6T66rrcreZdZdZdeddfdZedeefdZededfdZ e dede fd Z y) SelectionPatternz Pattern for elements with selectable children. Equivalent to Windows UIA SelectionPattern. Applies to: Lists, tables, tab groups. rrNc||_yrrrs rrzSelectionPattern.__init__Crrcht|jtj}|r t |SgS)z4Get the currently selected children as raw elements.)rrr SelectedChildrenlist)rchildrens rrz!SelectionPattern.SelectedChildrenFs+  y/I/IJ!)tH~1r1rr cddlm}t|jtj }|r|Dcgc] }|| c}SgScc}w)z7Get the currently selected children as Control objects.rr )r)controlsr rrr r)rr rcs rSelectedChildControlsz&SelectionPattern.SelectedChildControlsLsD & y/I/IJ 0891GA&9 9 :sAc>ddlm}tj||vS)z4Check if the element supports the Selection pattern.rrA)r$rBr rrCs rr'zSelectionPattern.IsSupportedVs ,))->w-GGGr) r(r)r*r+rrrDrrrr-r,r'r.rrrr;s~   2$s)22 tIHSHTHHrrceZdZdZdeddfdZedefdZedefdZ edefdZ defd Z defd Z defd Z defd Zededefd Zy) WindowPatternzo Pattern for window management. Equivalent to Windows UIA WindowPattern. Applies to: Windows. rrNc||_yrrrs rrzWindowPattern.__init__frrcRt|jtj}|duS)z!Check if the window is minimized.T)rrr MinimizedrNs r IsMinimizedzWindowPattern.IsMinimizedis$4==)*=*=>d{rcRt|jtj}|duS)z"Check if the window is fullscreen.T)rrr FullScreenrNs r IsFullScreenzWindowPattern.IsFullScreenos$4==)*>*>?d{rcRt|jtj}|duS)zCheck if the window is modal.T)rrr ModalrNs rIsModalzWindowPattern.IsModalus"4==)//:d{rct|jtj}|rt |t j Sy)zClose the window.F)rrr CloseButtonrr r)r close_btns rClosezWindowPattern.Close{s/  0E0EF  FLL9 9rcLt|jtjdS)zMinimize the window.Trrr rrs rMinimizezWindowPattern.MinimizesDMM9+>+>EErcLt|jtjdS)zRestore a minimized window.Frrs rRestorezWindowPattern.RestoresDMM9+>+>FFrcJt|jtjS)zBring the window to front.)rrr Raisers rrzWindowPattern.RaiserircFddlm}||tj}|dk(S)z1Check if the element supports the Window pattern.rrkAXWindowrorqs rr'zWindowPattern.IsSupporteds" 30z!!r)r(r)r*r+rrrDr,rrrrrrrr-r'r.rrrr^s   T d  tF$FGG:t:"S"T""rrceZdZdZdeddfdZedefdZedefdZ edZ ede fd Z ed Z ede fd Zededefd Zy) TextPatternz Pattern for text content access. Equivalent to Windows UIA TextPattern. Applies to: Text fields, text areas, static text. rrNc||_yrrrs rrzTextPattern.__init__rrcht|jtj}| t |SdS)zGet the full text content.)rrr r5rrNs rTextzTextPattern.Texts+4==)//:?s3x22rcRt|jtjxsdS)z Get the currently selected text.r)rrr SelectedTextrs rrzTextPattern.SelectedTexts DMM9+A+ABHbHrcJt|jtjS)zGet the selected text range.)rrr SelectedTextRangers rrzTextPattern.SelectedTextRangesDMM9+F+FGGrcVt|jtj}||SdS)z#Get the total number of characters.r)rrr NumberOfCharactersrNs rrzTextPattern.NumberOfCharacterss)4==)*F*FGos,1,rcJt|jtjS)z Get the visible character range.)rrr VisibleCharacterRangers rrz!TextPattern.VisibleCharacterRangesDMM9+J+JKKrcVt|jtj}||SdS)z+Get the line number of the insertion point.r)rrr InsertionPointLineNumberrNs rrz$TextPattern.InsertionPointLineNumbers)4==)*L*LMos,1,rcjddlm}||}tj|vxstj|vS)z/Check if the element supports the Text pattern.rrA)r$rBr rrrs rr'zTextPattern.IsSupporteds3 ,!'*++u4W 8N8NRW8WWr)r(r)r*r+rrrDrrrrrtrrrr-r,r'r.rrrrs   3c33 IcIIHH-C-- LL-#-- XSXTXXrrc6|j|r||Sy)z Get a pattern for an element if supported. Args: element: AXUIElementRef. pattern_class: Pattern class (e.g., InvokePattern, ValuePattern). Returns: Pattern instance if supported, None otherwise. N)r')r pattern_classs r GetPatternrs   )W%% r)r+loggingtypingrrr$rrrr enumsr r rr getLoggerr(loggerrr0rGr`rvrrrrrr.rrrs%  !   8 $''6#=#=L9J9Jx)>)>X'+'+TF6F6R H HF6"6"r2X2Xt r