add the undocumented ctypes.macholib module (#13086)

stdlib/@tests/stubtest_allowlists/common.txt

@@ -58,10 +58,6 @@ weakref.WeakValueDictionary.update
 # ==========
 # TODO: Modules that exist at runtime, but are missing from stubs
 # ==========
-ctypes.macholib
-ctypes.macholib.dyld
-ctypes.macholib.dylib
-ctypes.macholib.framework
 encodings.aliases
 encodings.ascii
 encodings.base64_codec

stdlib/ctypes/macholib/__init__.pyi

@@ -0,0 +1 @@
+__version__: str

stdlib/ctypes/macholib/dyld.pyi

@@ -0,0 +1,8 @@
+from collections.abc import Mapping
+from ctypes.macholib.dylib import dylib_info as dylib_info
+from ctypes.macholib.framework import framework_info as framework_info
+
+__all__ = ["dyld_find", "framework_find", "framework_info", "dylib_info"]
+
+def dyld_find(name: str, executable_path: str | None = None, env: Mapping[str, str] | None = None) -> str: ...
+def framework_find(fn: str, executable_path: str | None = None, env: Mapping[str, str] | None = None) -> str: ...

stdlib/ctypes/macholib/dylib.pyi

@@ -0,0 +1,14 @@
+from typing import TypedDict, type_check_only
+
+__all__ = ["dylib_info"]
+
+# Actual result is produced by re.match.groupdict()
+@type_check_only
+class _DylibInfo(TypedDict):
+    location: str
+    name: str
+    shortname: str
+    version: str | None
+    suffix: str | None
+
+def dylib_info(filename: str) -> _DylibInfo | None: ...

stdlib/ctypes/macholib/framework.pyi

@@ -0,0 +1,14 @@
+from typing import TypedDict, type_check_only
+
+__all__ = ["framework_info"]
+
+# Actual result is produced by re.match.groupdict()
+@type_check_only
+class _FrameworkInfo(TypedDict):
+    location: str
+    name: str
+    shortname: str
+    version: str | None
+    suffix: str | None
+
+def framework_info(filename: str) -> _FrameworkInfo | None: ...