Merge additionalDirectoriesToInclude support (PR #205) with mock
generation. Resolves conflicts in RootScanner (now in
SafeDIRootScannerCore), SharedRootScanner, plugin files, and test
helper. Both feature sets coexist: additional directory scanning for
roots and mock generation scoping via targetSwiftFiles.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

The merge of PR #205 broke mock module scoping. The CSV written by
the plugin includes ALL swift files (target + dependencies), but
runRootScanner was treating the entire CSV as targetSwiftFiles for
mock scanning. This caused mocks to be generated for types from
dependent modules.

Fix: add mockScopedSwiftFiles parameter so plugins pass only the
target's own files (+ additional directories) for mock scoping,
separate from the full CSV used for root scanning.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

## Summary

SafeDI now automatically generates `mock()` methods for `@Instantiable`
types, enabling lightweight test doubles with full dependency tree
support.

### Mock API

Each `@Instantiable` type gets a `public static func mock(...)` method.
Parameters use one of three styles depending on the dependency kind:

| Kind | Parameter style | Default |
|------|----------------|---------|
| Tree child with subtree | `child: Child? = nil` | Inline construction
|
| Leaf / uncovered dep | `@autoclosure @escaping () -> T = T()` |
Autoclosure |
| Default-valued init param | `@autoclosure @escaping () -> T =
originalDefault` | Original default |
| Forwarded | `name: String` (bare) | Required |
| onlyIfAvailable | `@autoclosure @escaping () -> T? = nil` | Nil |
| Closure-typed default | `@escaping T = default` | Original default (no
@autoclosure) |

### Parameter disambiguation

When multiple dependencies share a label (e.g., `service: LocalService`
and `service: ExternalService`), parameter names are disambiguated using
type-based suffixes:
- `MockParameterIdentifier` (Hashable struct with `propertyLabel` +
`sourceType`) replaces string-based keys throughout
- `TypeDescription.asIdentifier` walks the type tree to produce
identifier-safe suffixes (e.g., `service_ExternalService`)
- `TypeDescription.simplified` strips Optional/attribute/metatype
wrappers for cleaner suffixes, falling back to full suffix on collision
- Disambiguated names propagate consistently through parameter lists,
local bindings, init arguments, and nested scopes via
`MockContext.parameterLabelMap`

### Dependency resolution

- `resolvedParameters: Set<MockParameterIdentifier>` tracks which deps
are already bound — accumulated through siblings and parent-to-child
descent to prevent duplicate bindings
- `rootBindingIdentifiers` / `rootDefaultIdentifiers` control which
params get root-level `let x = x()` bindings vs scoped bindings inside
child functions
- Forwarded deps are excluded from label remapping (always use their
bare parameter name)
- `@Sendable` / `@MainActor` annotations preserved on closure-typed
parameters

### User-defined mock() methods

- When a type declares `static func mock(...)`, SafeDI skips generating
a mock for it
- Parent types call `Child.mock(...)` instead of `Child(...)`, threading
deps through the user method
- `@Instantiable` macro validates mock methods are `public`,
`static`/`class`, with parameters for all deps (with fix-its)
- Misconfigured mocks emit `/* @INSTANTIABLE type is incorrectly
configured */` comment

### Default-valued init parameters

- Non-dependency init params with defaults (e.g., `flag: Bool = false`)
bubble up to the root mock level as `@autoclosure @escaping` parameters
- Bubbling stops at
`Instantiator`/`SendableInstantiator`/`ErasedInstantiator`/`SendableErasedInstantiator`
boundaries and at types with no-arg user-defined `mock()` methods
- `@escaping` stripped from closure defaults (invalid in return
position); `@Sendable`/`@MainActor` preserved
- Root's own default-valued params bind at root scope; child defaults
bind inside scoped functions

### Cross-module support

- `@Instantiated` deps from parallel modules (type not in current
module's dependency chain) surface as required `@autoclosure @escaping`
parameters
- Cross-module deps with `.safedi` module info get optional parameters
with tree construction as default
- Uncovered transitive deps detected by `collectMockDeclarations` and
surfaced as required parameters

### Configuration

- `@SafeDIConfiguration` properties: `generateMocks: Bool` and
`mockConditionalCompilation: StaticString?`
- `@Instantiable` parameter: `mockAttributes: StaticString` for global
actor annotations (e.g., `@MainActor`)
- Per-module generation: each module generates mocks for its own types
only

### Documentation & examples

- Manual updated with mock generation section (autoclosure API,
user-defined mocks, default bubbling)
- Example projects updated: `#Preview` blocks use `.mock()`, NoteView
demonstrates default-valued parameter bubbling

### Testing

- 600+ tests total (150+ mock generation tests + existing + PR #205
additions)
- Mock tests use exact full-output `==` comparison (no `.contains`
assertions except for dynamic-path error stubs)
- Coverage includes: all Instantiator variants,
erasedToConcreteExistential, extension-based types, deep nesting,
protocol fulfillment, lazy cycles, default-valued params
(Bool/String/closures/nil/complex), user-defined mocks, disambiguation
(simplified/full suffix/3-way collision), Instantiator boundaries,
cross-module deps, promoted property ordering, sibling resolution, and
more

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>