Adapter SDK

Implement IKiwiAssetSwapAdapter and let KiwiAssetSwapAdapterRegistry discover it through deterministic TypeCache ordering.

An adapter provides:

• a stable namespaced Id
• a human-readable DisplayName
• deterministic Priority and scan mode
• CanInspect without mutation
• Collect that emits exact structured occurrences
• Apply that changes only the supplied selected occurrences
• Verify that proves the source is gone and exact target is present

Use KiwiAssetSwapStructuredOwnerSession for scenes, prefabs, and persistent assets. Use KiwiAssetSwapStructuredReferenceUtility for Unity object-reference properties or an explicitly recognized GUID schema.

Every occurrence needs a stable ID, mapping ID, adapter ID, project-relative asset path, stable owner ID, property path, exact source and target, state, diagnostic, and selection default.

Throwing or returning failure is safe: Asset Swap treats third-party adapter failure as blocking and rolls back any active transaction. Never swallow a schema mismatch or silently skip a previewed occurrence.

See the Adapter SDK Example sample for a known schema containing GUID plus 64-bit local file ID.