Document Mock.Wrap feature

Docs/pages/01-create-mocks.md

@@ -72,3 +72,25 @@ var sut2 = factory.Create<ILemonadeDispenser>();
 
 Using a factory allows you to create multiple mocks with identical, centrally configured behavior. This is especially
 useful when you need consistent mock setups across multiple tests or for different types.
+
+## Wrapping Existing Instances
+
+You can wrap an existing instance with mock tracking using `Mock.Wrap<T>()`. This allows you to track interactions with a real object:
+
+```csharp
+var realDispenser = new ChocolateDispenser();
+var wrappedDispenser = Mock.Wrap<IChocolateDispenser>(realDispenser);
+
+// Calls are forwarded to the real instance
+wrappedDispenser.Dispense("Dark", 5);
+
+// But you can still verify interactions
+wrappedDispenser.VerifyMock.Invoked.Dispense(It.Is("Dark"), It.Is(5)).Once();
+```
+
+**Notes:**
+
+- Only interface types can be wrapped with `Mock.Wrap<T>()`.
+- All calls are forwarded to the wrapped instance.
+- You can still set up custom behavior that overrides the wrapped instance's behavior.
+- Verification works the same as with regular mocks.

README.md

@@ -150,6 +150,28 @@ var sut2 = factory.Create<ILemonadeDispenser>();
 Using a factory allows you to create multiple mocks with identical, centrally configured behavior. This is especially
 useful when you need consistent mock setups across multiple tests or for different types.
 
+### Wrapping Existing Instances
+
+You can wrap an existing instance with mock tracking using `Mock.Wrap<T>()`. This allows you to track interactions with a real object:
+
+```csharp
+var realDispenser = new ChocolateDispenser();
+var wrappedDispenser = Mock.Wrap<IChocolateDispenser>(realDispenser);
+
+// Calls are forwarded to the real instance
+wrappedDispenser.Dispense("Dark", 5);
+
+// But you can still verify interactions
+wrappedDispenser.VerifyMock.Invoked.Dispense(It.Is("Dark"), It.Is(5)).Once();
+```
+
+**Notes:**
+
+- Only interface types can be wrapped with `Mock.Wrap<T>()`.
+- All calls are forwarded to the wrapped instance.
+- You can still set up custom behavior that overrides the wrapped instance's behavior.
+- Verification works the same as with regular mocks.
+
 ## Setup
 
 Set up return values or behaviors for methods, properties, and indexers on your mock. Control how the mock responds to