lKjtdZddlmZddlZddlZddlmZmZmZm Z m Z ddl m Z m Z ddlmZmZmZmZmZddlmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z*m+Z,m-Z.m/Z0m1Z2m3Z4m5Z6m7Z8m9Z:ejve<Z=Gd d Z>Gd d e>Z?Gd de>Z@Gdde>ZAGdde>ZBGdde>ZCGdde>ZDGddeDZEGdde>ZFGdde>ZGGdde>ZHGdd e>ZIGd!d"e>ZJGd#d$e>ZKGd%d&e>ZLGd'd(e>ZMGd)d*e>ZNGd+d,e>ZOGd-d.e>ZPGd/d0e>ZQGd1d2e>ZRGd3d4e>ZSGd5d6e>ZTGd7d8e>ZUGd9d:e>ZVGd;dZWGd=d>e>ZXGd?d@e>ZYieje?eje@ejeAejeBejeCejeDejeEejeFejeGejeHejeIejeJejeKejeLejeMejeNejeOejePejeQejeRejeSejeTejeUejeVejeWejeXejeYejeYi ZudCdAZv dDdBZwy)Ez Control classes wrapping macOS AXUIElementRef. Provides a Pythonic, object-oriented interface to accessibility elements with typed subclasses for specific control types. Equivalent to the Windows UIA controls.py module, adapted for macOS. ) annotationsN)AnyCallableListOptionalUnion)AXUIElementCreateApplicationAXUIElementCreateSystemWide)RoleSubrole AttributeActionActivationPolicyNames)RectPointSize GetAttribute SetAttributeGetParameterizedAttributeGetAttributeNamesGetActionNames PerformAction GetChildren GetPositionGetSizeGetRect GetChildCountIsAttributeSettable GetElementPid GetScreenSizeGetForegroundWindowPIDActivateApplicationClick RightClick DoubleClick MiddleClickTypeText WheelDownWheelUpDragToMoveToceZdZdZ d ddZedZ d ddZ d ddZdZ ddZ e dd Z edd Z edd Zedd Zedd ZeddZeddZeddZeddZedZej,ddZeddZeddZeddZeddZej,ddZeddZeddZeddZeddZeddZeddZ eddZ!edd Z"edd!Z#edd"Z$edd#Z%edd$Z&edd%Z'edd&Z(dd'Z)dd(Z*dd)Z+edd*Z,edd+Z-edd,Z.edd-Z/edd.Z0edd/Z1edd0Z2edd1Z3edd2Z4edd3Z5edd4Z6edd5Z7edd6Z8edd7Z9edd8Z:edd9Z;ed:Zed=Z?ed>Z@edd?ZAedd@ZB d ddAZCeddBZDeddCZEeddDZFeddEZGddFZHddGZIddHZJddIZKddJZLddKZMddLZNddMZOddNZPddOZQddPZRddQZSddRZT d ddSZU d ddTZVddUZW d ddVZX d ddWZY d ddXZZ d ddYZ[dddZZ\ddd[Z] d dd\Z^dd]Z_ d dd^Z`ddd_Za d dd`Zb d ddaZc d ddbZd d ddcZe d dddZf d ddeZg d ddfZh d ddgZi d ddhZj d ddiZk d ddjZl d ddkZm d ddlZn d ddmZo d ddnZp d ddoZq d ddpZr d ddqZs d ddrZt d ddsZu d ddtZv d dduZw d ddvZx d ddwZy d ddxZz d ddyZ{ d ddzZ|dd{Z}dd|Z~dd}Zd~Zy)Controla Base Control class wrapping a macOS AXUIElementRef. Equivalent to Windows UIA Control class. Provides property-based access to accessibility attributes, child navigation, element search, action execution, mouse/keyboard interaction, and fluent chaining for child discovery. Supports lazy element resolution: construct with search parameters and the actual AX element is found on first property access. Usage: # Direct wrapping ctrl = Control(element=some_ax_ref) # From PID app = Control(pid=12345) # Deferred search (lazy) btn = Control(searchFromControl=window, role=Role.Button, title="Save") btn.Click() # element is found here Nc .|||_d|_nE|t||_d|_n+|||t|_d|_nd|_d|_||_||_||_||_||_||_ | |_ | |_ | |_ y)a& Create a Control from an AXUIElement, application PID, or search parameters. Args: element: An AXUIElementRef to wrap directly. pid: Process ID to create an application element from. searchFromControl: Parent Control to search from (enables lazy resolution). role: AXRole to match when searching. title: AXTitle substring to match when searching. subrole: AXSubrole to match when searching. identifier: AXIdentifier to match when searching. predicate: Custom filter function for searching. searchDepth: Maximum tree depth for search. searchInterval: Seconds between search retries. foundIndex: 1-based index for multiple matches (1 = first match). NTF) _element_element_direct_assignr r _searchFromControl _searchRole _searchTitle_searchSubrole_searchIdentifier_searchPredicate _searchDepth_searchInterval _foundIndex) selfelementpidsearchFromControlroletitlesubrole identifier predicate searchDepthsearchInterval foundIndexs f/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/macos_mcp/ax/controls.py__init__zControl.__init__Vs<  #DM*.D ' _8=DM*.D '  &4  !             " "  ! !    ((A- " W 3< rIcg}|jr|jd|j|jr|jd|j|jr|jd|j|jr|jd|j|j r|jd|rddj |zdzSd S) z:Get a human-readable description of the search parameters.zRole=zTitle=zSubrole=z Identifier=zPredicate={z, }z{})r3appendr4r5r6r7join)r;partss rGr[zControl._get_search_descriptions    LL5!1!1 45 6    LL6$"3"3!67 8    LL8D$7$7#:; <  ! ! LL;t'='=&@A B  LL- ./4sTYYu%%+>$>rIct|S)zDWrap a raw AXUIElementRef in the appropriate typed Control subclass.) CreateControlr<s rG_wrapz Control._wrapsW%%rIcRt|jtjxsdS)z?Get the role of this element (e.g., 'AXButton', 'AXTextField').)rrMrr rLs rGr z Control.Role DLL)..9?R?rIcRt|jtjxsdS)z8Get the subrole of this element (e.g., 'AXCloseButton').rs)rrMrr rLs rGr zControl.Subroles DLL)*;*;<BBrIcRt|jtjxsdS)zBGet the localized role description (e.g., 'button', 'text field').rs)rrMrRoleDescriptionrLs rGrwzControl.RoleDescription DLL)*C*CDJJrIcRt|jtjxsdS)z$Get the title/label of this element.rs)rrMrTitlerLs rGrzz Control.TitlesDLL)//:@b@rIc>|jxs|jxsdS)zj Get the display name of this element. Tries Title, then Description, then Value. rs)rz DescriptionrLs rGNamez Control.Names zz3T--33rIcv|jxs,|jxs|jxs|jxsdS)z@Get the human-readable label for this element (RoleDescription).rs)rz Identifierr|ValuerLs rGLabelz Control.Label's1zzTT__T0@0@TDJJTRTTrIcRt|jtjxsdS)z2Get the accessibility description of this element.rs)rrMrr|rLs rGr|zControl.Description,s DLL)*?*?@FBFrIcRt|jtjxsdS)z"Get the help text of this element.rs)rrMrHelprLs rGrz Control.Help1rtrIcJt|jtjS)z7Get the value of this element (type varies by element).)rrMrrrLs rGrz Control.Value6sDLL)//::rIcNt|jtj|y)zSet the value of this element.NrrMrrr;values rGrz Control.Value; T\\9??E:rIc8|j}| t|SdS)zGet the value as a string.rs)rstrr;vals rG ValueStringzControl.ValueString@s jj?s3x22rIcRt|jtjxsdS)z*>?E2ErIcRt|jtj}|duS)z!Check if this element is enabled.F)rrMrEnabledrs rG IsEnabledzControl.IsEnabledKs%4<<):):;%rIcRt|jtj}|duS)z)Check if this element has keyboard focus.T)rrMrFocusedrs rG IsFocusedzControl.IsFocusedQs$4<<):):;d{rIcNt|jtj|y)zSet focus on this element.NrrMrrrs rGrzControl.IsFocusedWs T\\9#4#4e $;||w7777rIcRt|jtj}|duS)zCheck if this window is modal.T)rrMrModalrs rGIsModalzControl.IsModals"4<<9d{rIcft|jtj}|r t |Sy)zGet the parent element.N)rrMrParentro)r;rds rGrzControl.Parent+dllI,<,<=  ( (rIcft|jtj}|r t |Sy)z"Get the containing window element.N)rrMrWindowror;windows rGrzControl.WindowrrIcft|jtj}|r t |Sy)zOGet the top-level UI element (typically a WindowControl or ApplicationControl).N)rrMrTopLevelUIElementro)r;tops rGrzControl.TopLevelUIElements+4<<)D)DE  % %rIc,t|jS)z!Get the number of child elements.)rrMrLs rG ChildCountzControl.ChildCountT\\**rIcht|j}|Dcgc] }t|c}Scc}w)zZ Get all child controls. Equivalent to Windows UIA GetChildren().  _GetChildrenrMro)r;childrenchilds rGrzControl.GetChildrens/   -2:;( e$(;;;s/cNt|j}|rt|dSy)zGet the first child control.rNrr;rs rGGetFirstChildControlzControl.GetFirstChildControls% -  !- -rIcNt|j}|rt|dSy)zGet the last child control.Nrrs rGGetLastChildControlzControl.GetLastChildControls% -  ". .rIcft|jtj}|r t |Syz3Get the focused window of this application element.NrrMr FocusedWindowrors rGrzControl.FocusedWindow+dllI,C,CD  ( (rIcft|jtj}|r t |Syz0Get the main window of this application element.NrrMr MainWindowrors rGrzControl.MainWindow+dllI,@,@A  ( (rIct|jtj}|r|Dcgc] }t |c}SgScc}wz,Get all windows of this application element.rrMrWindowsror;windowsws rGrzControl.WindowsAt||Y->->? .56gM!$g6 6 7Acft|jtj}|r t |Sy)z-Get the menu bar of this application element.N)rrMrMenuBarro)r;menu_bars rGrzControl.MenuBars+  i.?.?@  * *rIcft|jtj}|r t |Sy)zGGet the extras menu bar (status bar items) of this application element.N)rrMr ExtrasMenuBarro)r;extrass rGrzControl.ExtrasMenuBar rrIcft|jtj}|r t |Sy)zGet the horizontal scroll bar.N)rrMrHorizontalScrollBarror;sbs rGrzControl.HorizontalScrollBars+$,, (E(E F  $ $rIcft|jtj}|r t |Sy)zGet the vertical scroll bar.N)rrMrVerticalScrollBarrors rGrzControl.VerticalScrollBars+$,, (C(C D  $ $rIc|jduS)z-Check if the element can scroll horizontally.N)rrLs rGIsHorizontallyScrollablez Control.IsHorizontallyScrollable's''t33rIc|jduS)z+Check if the element can scroll vertically.N)rrLs rGIsVerticallyScrollablezControl.IsVerticallyScrollable,s%%T11rIct|jtj}|r|Dcgc] }t |c}SgScc}w)z#Get all rows (for tables/outlines).)rrMrRowsror;rowsrs rGrz Control.Rows5s?DLL)..9 .23dM!$d3 3 4rct|jtj}|r|Dcgc] }t |c}SgScc}w)zGet visible rows.)rrMr VisibleRowsrors rGrzControl.VisibleRows=sADLL)*?*?@ .23dM!$d3 3 4rct|jtj}|r|Dcgc] }t |c}SgScc}w)zGet all columns.)rrMrColumnsro)r;colscs rGrzControl.ColumnsEsADLL)*;*;< .23dM!$d3 3 4rct|jtj}|r|Dcgc] }t |c}SgScc}w)zGet selected rows.)rrMr SelectedRowsrors rGrzControl.SelectedRowsMsADLL)*@*@A .23dM!$d3 3 4rcRt|jtj}|duS)z"Check if this element is expanded.TrrMrExpandedrs rG IsExpandedzControl.IsExpandedYrrIcVt|jtj}||SdS)z/Get the number of characters in a text element.r)rrMrNumberOfCharactersrs rGr zControl.NumberOfCharacterscs)4<<)E)EFos,1,rIcRt|jtjxsdS)zGet the selected text.rs)rrMr SelectedTextrLs rGrzControl.SelectedTextis DLL)*@*@AGRGrIcJt|jtjS)zGet the selected text range.)rrMrSelectedTextRangerLs rGrzControl.SelectedTextRangensDLL)*E*EFFrIcJt|jtjS)z Get the visible character range.)rrMrVisibleCharacterRangerLs rGrzControl.VisibleCharacterRangessDLL)*I*IJJrIcJt|jtjS)zGet the start text marker.)rrMrStartTextMarkerrLs rGrzControl.StartTextMarkerxsDLL)*C*CDDrIcJt|jtjS)zGet the end text marker.)rrMr EndTextMarkerrLs rGrzControl.EndTextMarker}sDLL)*A*ABBrIcJt|jtjS)z#Get the selected text marker range.)rrMrSelectedTextMarkerRangerLs rGrzControl.SelectedTextMarkerRangesDLL)*K*KLLrIcRt|jtjxsdS)z Get the language of the element.rs)rrMrLanguagerLs rGrzControl.Languages DLL)*<*<=CCrIcRt|jtjxsdS)z'Get placeholder text (for text fields).rs)rrMrPlaceholderValuerLs rGrzControl.PlaceholderValues DLL)*D*DEKKrIc|xs |j}|xs |j}|r|syt|jtj ||g}|syt|jtj |}| t|SdS)z Get the text between two text markers. If markers are not provided, uses the element's Start and End markers. rs)rrrrMr&TextMarkerRangeForUnorderedTextMarkersStringForTextMarkerRanger)r; start_marker end_markerstartend marker_rangetexts rGGetTextFromMarkerszControl.GetTextFromMarkerss4 4 4.D..C1 LL)JJUTWL ) LL)<) __class____name__r rrLs rG__repr__zControl.__repr__s14>>**+6$))fTZZNRSTTrIc`t|tr|j|jk(StSN)rtr.r0NotImplemented)r;others rG__eq__zControl.__eq__s% eW %==ENN2 2rIc>tt|jSr)hashidr0rLs rG__hash__zControl.__hash__sBt}}%&&rI) NNNNNNNN?r )r= Optional[int]r>Optional[Control]r? Optional[str]r@rrArrBrrC#Optional[Callable[[Control], bool]]rDintrEfloatrFr)@r)rUrrVrreturnbool)rT)rUrr]rrrrrrr.)rNonerrrrrr)rzOptional[Point])rzOptional[Size])rzOptional[Rect]rrrzOptional[WindowControl]rrr List[Control]rzList[WindowControl])NN)r!rr"rrr)rz list[str])r6r)r6rrr)r=rrr)NNNNNr)r?Optional[Role | str]rArr@rrBrrCrrTrrr)r?rrArr@rrBrrCrrTrrr)rrg?)r`rrarrbrrr))rorrr)r)rxzUnion[Control, Point, tuple]ryrrzrrr)rr)r`rrarrzOptional[tuple[float, float]])g{Gz?)r&rrrrr)NNNr)rz'ApplicationControl')rz'WindowControl')rz'ButtonControl')rz'CheckBoxControl')rz'RadioButtonControl')rz'TextFieldControl')rz'TextAreaControl')rz'ComboBoxControl')rz'PopUpButtonControl')rz'SliderControl')rz'MenuItemControl')rz'MenuBarItemControl')rz 'TabControl')rz 'ListControl')rz'TableControl')rz'OutlineControl')rz'ScrollAreaControl')rz'GroupControl')rz'ImageControl')rz 'LinkControl')rz'StaticTextControl')rz'WebAreaControl')rz'DisclosureTriangleControl')rz 'RowControl')rz 'CellControl')rz'DockItemControl')rz'ProgressIndicatorControl')r __module__ __qualname____doc__rHpropertyrMrOrKrRr[ staticmethodrqr r rwrzr}rr|rrsetterrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r rrrrrrrrr'r*r.r1r3r7r9rrr?rBrDrFrIrKrMrOrQrWrYr[r$r%r&r'r)r*r+rlr]rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrIrGr.r.>s% 2!/3"#!%$(9= #4&4&- 4&  4&  4&4&"4&74&4&4&4&lMP% %%DI% %PEI %=A *: ?&&@@CCKKAA44UUGG@@;; \\;;33 FF   == %%  88++<4422-- HHGGKKEECCMMDDLL ;?55475 5<'' ''55225<<3021443/0C&*!%#$(9=%="%=%= %= " %= 7 %=%= %=R&*!%#$(9=F"FF F " F 7 FF F8*KO 1 1+0 1BG 1  1 KO66+06BG6 6KO77+07BG7 7KO77+07BG7 7  A,AA A  A@(47  +0  &  " FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH    FH  $  FH    FH    FH    FH  #  C U 'rIr.c4eZdZdZfdZdZd$dZd$dZed$dZ ed%dZ ed%dZ ed$d Z ed&d Z ed'd Zed'd Zed(d Zed%dZed%dZej&d)dZed*dZed+dZed+dZed+dZed+dZedZedZed%dZed%dZed%dZed%dZed+dZed*dZ ed%dZ!d,d-dZ"d%d Z#d%d!Z$d%d"Z%d%d#Z&xZ'S).ra8 Control for AXApplication elements. Wraps both the AXUIElementRef (for accessibility tree access) and the NSRunningApplication (for process-level metadata like bundle ID, icon, launch date, hidden state, etc.). The NSRunningApplication is lazily resolved from the PID on first access. c 2t|di|d|_y)Nr)superrH_ns_running_app)r;kwargsrs rGrHzApplicationControl.__init__2s "6"#rIc|jgt|j}|Pddlm}|j j D])}|j|k(s||_|jS|jS)zCLazily resolve the NSRunningApplication for this application's PID.r) NSWorkspace)rr rMCocoarsharedWorkspacerunningApplicationsprocessIdentifier)r;r=rapps rG_get_ns_running_appz&ApplicationControl._get_ns_running_app6sw    ' -C-&668LLNC,,.#5/2,### O###rIcVd|jd|jd|jdS)Nz App(Name=z , Status=z , Policy=r)r}StatusActivationPolicyrLs rGrzApplicationControl.__str__Cs4 }Idkk_=++.a 1 rIc"|jSr)rrLs rGrzApplicationControl.__repr__Is||~rIc:|j}|r|S|jS)zR Get the display name of this application. Tries AX Title )rz LocalizedName)r;rs rGr}zApplicationControl.NamePs zzt3!3!33rIcD|j}|sytd|DS)a Check if this application's windows are all minimized. Returns True only when the application has at least one window and every window is minimized. Returns False if there are no windows or any window is not minimized. Fc34K|]}|jywrr.0rs rG z1ApplicationControl.IsMinimized..ds2'Q1==')rallr;rs rGrzApplicationControl.IsMinimizedYs$,,2'222rIcD|j}|sytd|DS)z Check if any of this application's windows are in fullscreen mode. Returns True if at least one window is fullscreen. Returns False if there are no windows or none are fullscreen. Fc34K|]}|jywrrr's rGr)z2ApplicationControl.IsFullScreen..p37a1>>7r*)ranyr,s rGrzApplicationControl.IsFullScreenfs$,,37333rIc|jry|j}|sytd|Dry|jrt d|Dryyy) u> Get a human-readable status summarizing the application's current state. Returns one of: 'Active' — Frontmost application with visible windows. 'Fullscreen' — Frontmost application in fullscreen mode. 'Visible' — Has windows on screen but is not the frontmost app. 'Hidden' — Hidden via Cmd+H; windows are preserved but invisible. 'Minimized' — All windows are minimized to the Dock. 'Windowless' — Running but has no windows (closed or never opened). r Windowlessc34K|]}|jywrr&r's rGr)z,ApplicationControl.Status..s.gq}}gr*rc34K|]}|jywrr/r's rGr)z,ApplicationControl.Status..r0r* FullscreenActiveVisible)rrr+IsActiver1r,s rGrzApplicationControl.StatusrsL ==,, .g. . ==3733#rIcft|jtj}|r t |Sy)z9Get the currently focused UI element in this application.N)rrMrFocusedUIElementro)r;rVs rGr;z#ApplicationControl.FocusedUIElements+DLL)*D*DE  & &rIcft|jtj}|r t |Syrrrs rGrz ApplicationControl.FocusedWindowrrIcft|jtj}|r t |Syrrrs rGrzApplicationControl.MainWindowrrIct|jtj}|r|Dcgc] }t |c}SgScc}wrrrs rGrzApplicationControl.WindowsrrcRt|jtj}|duS)z3Check if the application is running (AX attribute).T)rrMrIsApplicationRunningrs rGr@z'ApplicationControl.IsApplicationRunnings$4<<)G)GHd{rIcRt|jtj}|duS)z%Get the enhanced user interface flag.T)rrMrEnhancedrs rGEnhancedUserInterfacez(ApplicationControl.EnhancedUserInterfacerrIcNt|jtj|y)zOSet the enhanced user interface flag (enables deeper tree access in some apps).N)rrMrrBrs rGrCz(ApplicationControl.EnhancedUserInterfaces T\\9#5#5u=rIc,t|jS)z5Get the process identifier (PID) of this application.)r rMrLs rGPIDzApplicationControl.PIDrrIcf|j}|r|j}|r t|SdSy)z{ Get the CFBundleIdentifier of this application. Example: 'com.apple.Safari', 'com.google.Chrome'. N)rbundleIdentifierrr;rrs rGBundleIdentifierz#ApplicationControl.BundleIdentifiers7 &&( &&(C"3s8 , ,rIcf|j}|r|j}|r t|SdSy)zy Get the file URL to the application's .app bundle. Example: 'file:///Applications/Safari.app/'. N)r bundleURLrr;rurls rG BundleURLzApplicationControl.BundleURLs4 &&( --/C"3s8 , ,rIcf|j}|r|j}|r t|SdSy)z Get the file URL to the application's executable binary. Example: 'file:///Applications/Safari.app/Contents/MacOS/Safari'. N)r executableURLrrMs rG ExecutableURLz ApplicationControl.ExecutableURLs7 &&( ##%C"3s8 , ,rIcf|j}|r|j}|r t|SdSy)z Get the localized display name of the application. Example: 'Safari', 'Google Chrome'. This is the user-facing name shown in the Dock and App Switcher. N)r localizedNamerrIs rGr#z ApplicationControl.LocalizedNames7&&( ##%C"3s8 , ,rIcH|j}|r|jSy)z Get the application icon as an NSImage. Can be converted to other formats using Cocoa APIs. Returns: NSImage or None. N)riconr;rs rGIconzApplicationControl.Icons$&&( 88: rIcH|j}|r|jSy)zx Get the date and time when the application was launched. Returns: NSDate or None. N)r launchDaterWs rG LaunchDatezApplicationControl.LaunchDate s%&&( >># #rIc>|j}|yt}||k(S)a Check if this application is the currently active (frontmost) application. Uses CGWindowListCopyWindowInfo (via GetForegroundWindowPID) instead of NSRunningApplication.isActive() because the latter relies on AppKit notifications delivered via NSRunLoop. Without an active event loop (e.g. Python scripts, notebooks), isActive() returns stale cached data. F)rFr")r;r= frontmost_pids rGr9zApplicationControl.IsActives(hh ;.0 m##rIcZ|j}|rt|jSy)z.Check if this application is currently hidden.F)rrisHiddenrWs rGrzApplicationControl.IsHidden&s)&&(  ' 'rIcZ|j}|rt|jSy)z0Check if the application has finished launching.F)rrisFinishedLaunchingrWs rGIsFinishedLaunchingz&ApplicationControl.IsFinishedLaunching.s,&&( //12 2rIcZ|j}|rt|jSy)z-Check if the application has been terminated.F)rr isTerminatedrWs rG IsTerminatedzApplicationControl.IsTerminated6s,&&( ((*+ +rIc|j}|r3t|j}tj|d|dSy)u Get the activation policy of the application as a human-readable string. Returns: 'Regular' — appears in Dock and App Switcher (normal apps), 'Accessory' — does not appear in Dock, may show in App Switcher, 'Prohibited' — does not appear in Dock or App Switcher (background agents), None if unavailable. zUnknown(rN)rractivationPolicyrget)r;rpolicys rGr z#ApplicationControl.ActivationPolicy>sG&&( --/0F(,,Vxxq5IJ JrIcZ|j}|rt|jSy)z Get the executing processor architecture of the application. Common values: - 16777223 (0x01000007) = x86_64 - 16777228 (0x0100000C) = arm64 N)rrexecutableArchitecturerWs rGExecutableArchitecturez)ApplicationControl.ExecutableArchitectureOs,&&( s1134 4rIcZ|j}|rt|jSy)z6Check if this application currently owns the menu bar.F)rr ownsMenuBarrWs rG OwnsMenuBarzApplicationControl.OwnsMenuBar]s*&&( )* *rIct|j}|r&ddlm}|r|nd}t|j |Sy)z Activate (bring to front) this application. Args: ignoring_other_apps: If True, activates even if another app is active. Returns: True if activation was successful. r)&NSApplicationActivateIgnoringOtherAppsF)rrrqractivateWithOptions_)r;ignoring_other_appsrrqoptionss rGActivatezApplicationControl.ActivateisD&&(  D;N6ST 009: :rIcZ|j}|rt|jSy)z Hide this application (equivalent to Cmd+H). Returns: True if the application was successfully hidden. F)rrhiderWs rGHidezApplicationControl.Hide}s)&&(  # #rIcZ|j}|rt|jSy)z Unhide (show) this application if it was hidden. Returns: True if the application was successfully unhidden. F)rrunhiderWs rGUnhidezApplicationControl.Unhides)&&(  % %rIcZ|j}|rt|jSy)z Request this application to quit gracefully. The application may prompt to save unsaved documents. Returns: True if the termination request was sent successfully. F)rr terminaterWs rG TerminatezApplicationControl.Terminates)&&(  ( (rIcZ|j}|rt|jSy)z Force-quit this application immediately. Does not give the application a chance to save or clean up. Use with caution. Returns: True if the force termination was successful. F)rrforceTerminaterWs rGForceTerminatez!ApplicationControl.ForceTerminates,&&( **,- -rIrrrrrr)rr)rr)T)rsrrr)(rr r r rHrrrr r}rrrr;rrrr@rCrrFrJrOrRr#rXr[r9rrbrer rlrorurxr{r~r __classcell__)rs@rGrr's/$ $ 44 3 3 4 4:  !!>">++             $ $   (    rIrceZdZdZddZddZddZddZddZddZ ddZ ddd Z dd Z dd Z dd Zedd ZeddZy)rzv Control for AXWindow elements. Provides window management methods similar to Windows UIA TopLevel mixin. ct|jtj}|rt |t j Sy)z'Close this window via the close button.F)rrMr CloseButtonrrr?)r; close_btns rGClosezWindowControl.Closes/ y/D/DE  FLL9 9rIcLt|jtjdS)zMinimize this window.TrrMrrrLs rGMinimizezWindowControl.MinimizesDLL)*=*=tDDrIcLt|jtjdS)zRestore this minimized window.FrrLs rG UnminimizezWindowControl.UnminimizesDLL)*=*=uEErIc"|jS)z4Restore from minimized state (alias for Unminimize).)rrLs rGRestorezWindowControl.Restores  rIct|jtj}|rt |t j Sy)z0Zoom (maximize) this window via the zoom button.F)rrMr ZoomButtonrrr?)r;zoom_btns rGZoomzWindowControl.Zooms/ i.B.BC  6<<8 8rIc"|jS)z.Maximize (zoom) this window. Alias for Zoom().)rrLs rGMaximizezWindowControl.Maximizesyy{rIcf|j}t|jtj| S)z2Toggle fullscreen mode via AXFullScreen attribute.)rrrMrr)r;currents rGrzWindowControl.FullScreens(##DLL)*>*>G LLrIct|j}|r t||jt j |y)z Bring this window's application to front and raise the window. Args: waitTime: Delay after activation. T)r rMr#rOrPrS)r;rbr=s rG SetActivezWindowControl.SetActives5DLL)   $  8rIc|j}|syt\}}||jz dz }||jz dz }t |j t j||fS)z-Move this window to the center of the screen.Frs)rr!rrrrMrr)r;rscreen_wscreen_hnew_xnew_ys rG MoveToCenterzWindowControl.MoveToCentersb%%*_(DJJ&!+DKK'1,DLL)*<*rIrcleZdZdZeddZej ddZeddZeddZy) rzControl for AXSlider elements.cd|j} | t|SdS#ttf$rYywxYw)z Get the slider value as a float.rr TypeError ValueErrorrs rG SliderValuezSliderControl.SliderValuel<jj !$5: 9c 9:&   //cNt|jtj|y)zSet the slider value.Nrrs rGrzSliderControl.SliderValueurrIcht|jtj}| t |SdS)zGet the minimum value.r)rrMrMinValuerrs rGrzSliderControl.MinValuezs-4<<););< _uSz5#5rIcht|jtj}| t |SdS)zGet the maximum value.gY@)rrMrMaxValuerrs rGrzSliderControl.MaxValues-4<<););< _uSz7%7rINrr)rrrr) rr r r r rrrrrrIrGrrisY( ;;66 88rIrc*eZdZdZeddZddZy)rz Control for AXMenuItem elements.cRt|jtjxsdS)z#Get the command character shortcut.rs)rrMrMenuItemCmdCharrLs rGrzMenuItemControl.MenuItemCmdCharrxrIc"|jS)zSelect this menu item.rrLs rGrzMenuItemControl.SelectrrINrr)rr r r r rrrrIrGrrs* KKrIrceZdZdZddZy)rz#Control for AXMenuBarItem elements.c"|jS)zOpen this menu bar item.rrLs rGrzMenuBarItemControl.OpenrrINrrrrIrGrrs -rIrceZdZdZddZy)rzControl for AXTab elements.c"|jS)zSelect this tab.rrLs rGrzTabControl.SelectrrINr)rr r r rrrIrGrrs %rIrc"eZdZdZeddZy)rzControl for AXList elements.ct|jtj}|r|Dcgc] }t |c}SgScc}w)zGet selected children.)rrMrSelectedChildrenro)r;rrs rGrzListControl.SelectedChildrensA  i.H.HI .67hM!$h7 7 8rNr)rr r r r rrrIrGrrs& rIrcFeZdZdZeddZeddZeddZy)rzControl for AXTable elements.cVt|jtj}||SdS)zGet the number of rows.r)rrMrRowCountrs rGrzTableControl.RowCounts)4<<););<os,1,rIcVt|jtj}||SdS)zGet the number of columns.r)rrMr ColumnCountrs rGrzTableControl.ColumnCounts)4<<)>)>?os,1,rIcft|jtj}|r t |Sy)zGet the table header.N)rrMrHeaderro)r;headers rGrzTableControl.HeaderrrINrr)rr r r r rrrrrIrGrrs?' -- -- rIrc"eZdZdZeddZy)rz,Control for AXOutline elements (tree views).ct|jtj}|r|Dcgc] }t |c}SgScc}w)zGet disclosed (visible) rows.)rrMr DisclosedRowsrors rGrzOutlineControl.DisclosedRowssADLL)*A*AB .23dM!$d3 3 4rNr)rr r r r rrrIrGrrs6 rIrc*eZdZdZeddZddZy)rz"Control for AXScrollArea elements.ct|jtj}|r|Dcgc] }t |c}SgScc}w)z$Get the contents of the scroll area.)rrMrContentsro)r;contentsrs rGrzScrollAreaControl.ContentssA  i.@.@A .67hM!$h7 7 8rcd}d}t|jtj}|r(t|tj}| t |}t|jtj}|r,t|tj}| t |}||fS||fS#t tf$rYgwxYw#t tf$rY||fSwxYw)zs Get the scroll position as (horizontal_percent, vertical_percent). Values are 0.0 to 1.0. r) rrMrrrrrrr)r;h_pctv_pcth_barrv_bars rGGetScrollPositionz#ScrollAreaControl.GetScrollPositions T\\9+H+HI uioo6C!#JET\\9+F+FG uioo6C!#JEu~u~":.":.u~s$ B) B>)B;:B;>CCNr)rztuple[float, float])rr r r r rrrrIrGrrs, rIrceZdZdZy)rzControl for AXGroup elements.NrrrIrGrrs'rIrc"eZdZdZeddZy)rzControl for AXImage elements.cht|jtj}|r t |SdS)zGet the image URL if available.rsr)rs rGr*zImageControl.URLr+rINrrr r r r r*rrIrGrrs' ''rIrc"eZdZdZeddZy)rzControl for AXLink elements.cht|jtj}|r t |SdS)zGet the link URL.rsr)rs rGr*zLinkControl.URL r+rINrrrrIrGrr s& ''rIrc"eZdZdZeddZy)rz)Control for AXProgressIndicator elements.cd|j} | t|SdS#ttf$rYywxYw)zGet the progress value.rrrs rG ProgressValuez&ProgressIndicatorControl.ProgressValuerrNr)rr r r r rrrIrGrrs3 rIrc"eZdZdZeddZy)rz"Control for AXStaticText elements.c6|jxs |jS)zGet the text content.)rrzrLs rGTextzStaticTextControl.Text#s-4::-rINr)rr r r r rrrIrGrr s, ..rIrc4eZdZdZeddZeddZy)rzControl for AXWebArea elements.cht|jtj}|r t |SdS)zGet the web page URL.rsr)rs rGr*zWebAreaControl.URL,r+rIcht|jtj}|r t |SdS)zGet the document URL.rsr-rs rGr.zWebAreaControl.Document2r/rINr)rr r r r r*r.rrIrGrr)s+) '' ''rIrc*eZdZdZeddZddZy)rz*Control for AXDisclosureTriangle elements.c0|j}|dk(xs|duS)z$Check if the disclosure is expanded.r Trrs rGr z$DisclosureTriangleControl.IsExpanded<rrIc"|jS)zToggle the disclosure state.rrLs rGrz DisclosureTriangleControl.ToggleBrrINr)rr r r r r rrrIrGrr9s4 '' rIrceZdZdZy)rz Control for AXDockItem elements.NrrrIrGrrGs*rIrc"eZdZdZeddZy)rzControl for AXCell elements.cVt|jtj}||SdS)zGet the row index of this cell.rrrMrIndexrs rGRowIndexzCellControl.RowIndexP'4<<9os-2-rINr)rr r r r rrrIrGrrMs& ..rIrcFeZdZdZeddZeddZeddZy)rz(Control for AXRow/AXOutlineRow elements.cVt|jtj}||SdS)zGet the row index.rrrs rGrzRowControl.IndexZrrIcVt|jtj}||SdS)z!Get the outline disclosure level.r)rrMrDisclosureLevelrs rGrzRowControl.DisclosureLevel`s)4<<)B)BCos,1,rIcRt|jtj}|duS)z2Check if this outline row is disclosed (expanded).Tr rs rG IsDisclosedzRowControl.IsDisclosedfrrINrr)rr r r r rrrrrIrGrrWs?2 .. -- rIrc|t|tj}tj |t }||S)a Create the appropriate typed Control subclass for an AXUIElement. Equivalent to Windows UIA Control.CreateControlFromElement(). Args: element: An AXUIElementRef. Returns: A typed Control subclass (e.g., ButtonControl, TextFieldControl). rp)rrr _ROLE_TO_CONTROL_CLASSrhr.)r<r? control_classs rGroros1  0D*..tW=M  ))rIc N||kDry| r|ryt|} | D] } | r|ryt| tjxsd} |rt| tjxsdnd} |rt| tj xsdnd}|rt| tj xsdnd}d}|r| |k7rd}|r |r| |k7rd}|r|r||vrd}|r |r||k7rd}|r|rt| }||sd}|r|s|s|s|s|r|j| | ryt| ||||||||dz|  y)z Recursive element search helper that collects raw AXUIElementRefs. Used by Control.FindAll/FindFirst and the lazy search system. The predicate receives a CreateControl-wrapped element for filtering. NrsTFr ) rrrr r rzrrorkrb)r<rfr?rAr@rBrCrT current_depthrarr child_role child_subrole child_titlechild_identifiermatchcontrols rGrbrbsV"y gG$H ' "%8>B r0s# 77 >   8 $a'a'R'GGT cGcL G g    w , & g 8G8< g  ' 70 W ""J 7 '7'''' w .. 'W '   g .'.6(KK KK MM?   (   NN$  MM? MM? ( KK MM? ( HHj II{ JJ   LL.!" OO&#$ JJ JJ II{4OO&LL.6MM?II{HHjOOZ9@ **E E E  E  E  E  E 3E E E E  E rI