Added docs for class hook methods

Author: lukaskubanek

Sources/InterposeKit/Interpose.swift

@@ -11,6 +11,46 @@ public enum Interpose {
     // MARK: Class Hooks
     // ============================================================================ //
 
+    /// Prepares a hook for the specified method on a class.
+    ///
+    /// Builds a block-based hook for an instance or class method available to the Objective-C
+    /// runtime, with access to the original implementation.
+    ///
+    /// The hook is returned in a pending state and must be applied using `apply()` to take effect.
+    /// It can later be reverted using `revert()`.
+    ///
+    /// - Parameters:
+    ///   - class: The class on which the method is defined.
+    ///   - selector: The selector of the method to hook.
+    ///   - methodKind: Whether the method is an instance or class method. Defaults to `.instance`.
+    ///   - methodSignature: The expected C function type of the original method implementation.
+    ///   - hookSignature: The type of the hook block.
+    ///   - build: A closure that receives a proxy to the hook and returns the hook block.
+    ///
+    /// - Returns: The prepared hook instance in the pending state.
+    ///
+    /// - Throws: An ``InterposeError`` if the hook could not be prepared.
+    ///
+    /// ### Example
+    ///
+    /// ```swift
+    /// let hook = try Interpose.prepareHook(
+    ///     on: MyClass.self,
+    ///     for: #selector(MyClass.getValue),
+    ///     methodSignature: (@convention(c) (MyClass, Selector) -> Int).self,
+    ///     hookSignature: (@convention(block) (MyClass) -> Int).self
+    /// ) { hook in
+    ///     return { `self` in
+    ///         print("Before")
+    ///         let value = hook.original(self, hook.selector)
+    ///         print("After")
+    ///         return value + 1
+    ///     }
+    /// }
+    ///
+    /// try hook.apply()
+    /// try hook.revert()
+    /// ```
     public static func prepareHook<MethodSignature, HookSignature>(
         on `class`: AnyClass,
         for selector: Selector,
@@ -26,6 +66,44 @@ public enum Interpose {
         )
     }
 
+    /// Applies a hook for the specified method on a class.
+    ///
+    /// Builds a block-based hook for an instance or class method available to the Objective-C
+    /// runtime, with access to the original implementation.
+    ///
+    /// The hook takes effect immediately and can later be reverted using `revert()`.
+    ///
+    /// - Parameters:
+    ///   - class: The class on which the method is defined.
+    ///   - selector: The selector of the method to hook.
+    ///   - methodKind: Whether the method is an instance or class method. Defaults to `.instance`.
+    ///   - methodSignature: The expected C function type of the original method implementation.
+    ///   - hookSignature: The type of the hook block.
+    ///   - build: A closure that receives a proxy to the hook and returns the hook block.
+    ///
+    /// - Returns: The applied hook instance in the active state.
+    ///
+    /// - Throws: An ``InterposeError`` if the hook could not be applied.
+    ///
+    /// ### Example
+    /// 
+    /// ```swift
+    /// let hook = try Interpose.applyHook(
+    ///     on: MyClass.self,
+    ///     for: #selector(MyClass.getValue),
+    ///     methodSignature: (@convention(c) (MyClass, Selector) -> Int).self,
+    ///     hookSignature: (@convention(block) (MyClass) -> Int).self
+    /// ) { hook in
+    ///     return { `self` in
+    ///         print("Before")
+    ///         let value = hook.original(self, hook.selector)
+    ///         print("After")
+    ///         return value + 1
+    ///     }
+    /// }
+    ///
+    /// try hook.revert()
+    /// ```
     @discardableResult
     public static func applyHook<MethodSignature, HookSignature>(
         on `class`: AnyClass,