Document Mock.Wrap feature

[Copilot]

The Mock.Wrap<T>() API was undocumented despite being fully implemented and tested.

Changes

• Added "Wrapping Existing Instances" subsection to README.md and Docs/pages/01-create-mocks.md
• Documented that Mock.Wrap forwards calls to real instances while tracking interactions
• Clarified that only interface types can be wrapped
• Added example showing wrapping, invocation, and verification

Example

var realDispenser = new ChocolateDispenser();
var wrappedDispenser = Mock.Wrap<IChocolateDispenser>(realDispenser);

// Calls forwarded to real instance
wrappedDispenser.Dispense("Dark", 5);

// Interactions still tracked
wrappedDispenser.VerifyMock.Invoked.Dispense(It.Is("Dark"), It.Is(5)).Once();

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Document Mock.Wrap feature</issue_title>
<issue_description>## Description

The Mock.Wrap<T>(instance) feature is completely missing from the README.md documentation.

Missing Documentation

• Mock.Wrap<T>(instance) - Wrap existing instances with mock tracking
• Forward calls to real instance while tracking interactions
• Verify interactions on wrapped instances

Suggested Documentation

Add a new subsection under "Create mocks" titled "Wrapping Existing Instances":

### 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:

with the following example

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();
```</issue_description>

## Comments on the Issue (you are @copilot in this section)

<comments>
</comments>

• Fixes Document Mock.Wrap feature #411

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vbreuss]

Obsolete by #427