revref 1.0.0-alpha2

Added

• Immutable LookupScope and LookupOptions value objects for the public lookup API
• explainLookup() as a dedicated debugging and introspection method
• Proper field settings forms and summaries so reverse reference fields can be configured through the UI
• Translation kernel test coverage for:
  • non-default translation save isolation
  • language option filter parity
• Targeted kernel test coverage for:
  • revision policy transitions
  • multi-field reference edge cases
  • ignored fields behaviour
  • count correctness
• Additional edge-case kernel coverage beyond the initial targeted test pass
• GitLab CI configuration

Changed

• Refactored the public service API to use typed value objects instead of array-based scope and options inputs
• Updated field item list callers to build and pass value objects consistently
• Reworked internal service signatures and related internals to align with the new API
• Replaced old explain-state handling with the dedicated explainLookup() method
• Renamed EntityReferenceChangeSubscriber to EntityReferenceChangeHandler
• Updated service wiring, constructor usage, hook calls, and related service definitions to support the handler rename and refactor
• Updated relevant kernel tests to use the value-object API
• Updated documentation to match the refactored API and current architecture

Fixed

• Kernel test failures
• Referencer counting so counts now use distinct source entities
• Leftover explain-related state and handling
• Obsolete EntityReferenceChangeSubscriber class after the handler rename
• References across the codebase to use EntityReferenceChangeHandler

Documentation

• Updated README and architecture documentation to reflect:
  • typed LookupScope and LookupOptions usage
  • explainLookup() replacing old explain behaviour
  • current handler naming
  • current field and UI configuration support
• Applied follow-up documentation tweaks and alignment fixes

Upgrade notes

• The lookup API has changed: callers should now use LookupScope and LookupOptions instead of array inputs
• The old explain option and _explain response pattern have been removed in favour of explainLookup()
• Reverse reference field types are now UI-configurable