# AyCode.Core.Serializers.SourceGenerator

Roslyn incremental source generator that produces optimized `IGeneratedBinaryWriter` and `IGeneratedBinaryReader` implementations for types marked with `[AcBinarySerializable]`. Eliminates runtime reflection on serialization hot paths.

Targets **netstandard2.0** (required for Roslyn analyzers/generators).

## Key Files

- **`AcBinarySourceGenerator.cs`** — Single-file `IIncrementalGenerator` (~2100 lines). Generates:
  - `{ClassName}_GeneratedWriter` — Per-type writer with `ScanObject()` + `WriteProperties()` methods. Handles primitives, strings (with interning), collections, dictionaries, complex nested types, and polymorphic objects.
  - `{ClassName}_GeneratedReader` — Per-type reader with `ReadProperties()` method.
  - `ModuleInitializer` — Auto-registers all generated writers/readers at startup.
  - Circular reference detection with `ACBIN001` diagnostic warning.

## Feature Flags

The `[AcBinarySerializable]` attribute supports per-type feature control:
- `enableMetadata` — Property hash metadata for cross-type deserialization
- `enableIdTracking` — IId-based reference tracking
- `enableRefHandling` — General reference tracking
- `enableInternString` — String interning/deduplication

Disabled features eliminate corresponding code blocks from generated output (zero dead code).

## Dependencies

| Dependency | Purpose |
|---|---|
| `Microsoft.CodeAnalysis.CSharp` | Roslyn syntax/semantic APIs |
| `Microsoft.CodeAnalysis.Analyzers` | Analyzer best practices |