1.6.0 * 2025-08-21

Added

the MAKE_VALUE_MEMBER macro now creates a static juce::Identifer that's used by all instances of the class to instantiate that member instead of re-converting from a string each time. Should be faster, and use the Identifier objects as they're intended to be used.
Added CACHED_VALUE(name, value) macro to simplify creating cached value members for cello::Value objects.
Added get() method to Value<T>::Cached for easier access to the cached value (e.g., you can use it to initialize an auto variable).
Added support for bidirectional synchronization between cello::Objects in different threads via the new cello::SyncController class, which manages a pair of Sync objects and prevents feedback loops during updates.
Added new methods to SyncController for performing updates: performNextUpdate and performAllUpdates for a given thread.
Added new tests for bidirectional sync and feedback prevention.

changed the signature of the Value<T>::onSet() callable. This now returns std::optional<T>; if this callable returns std::nullopt, the Value will not be modified, so you can ignore set calls that are invalid, or always return nullopt from your set validator to treat the Value as if it were const.

type of first argument to a PropertyChangeFn changed from juce::Identifier to const juce::Identifier&, which it always should have been.
cleaned up Value arithmetic operators by replacing noisy static_cast calls with the recently added Value::get() method that accomplishes the same thing.
Improved feedback prevention in synchronization logic to avoid infinite update loops when syncing between objects.
Updated IpcClient to implement startUpdate and endUpdate for better state management during IPC sync.
Minor documentation improvements and added missing comments for clarity.

add get() method to value, simplfying accessing the underlying data of a Value in its correct compile-time type.
fix behavior of listeners on an Object's type to return the ID of the property that has changed, not the ID of the tree itself, which isn't that useful.
add Object::wasWrapped() and Object::wasInitialized() methods.
add Object::getTypeName() for convenience.
add Object::toXmlString() for convenience.

Added new Object::findOne() method to search for and return a single child tree from an object.
Added new argument returnFirstFound to Query::search, used to implement the above.
Fixed some compiler warnings.

cello::Sync: Perform thread-safe Object updates using the juce::ValueTreeSynchroniser class. The basic approach is that we rely on a pair of cello::Objects, each of which is only accessed by a single thread. A separate cello::Sync object (or pair of them if bidirectional sync is needed) watches for changes and communicates those deltas across the thread boundary where they're applied in a thread-safe manner to the other object/tree.
cello::IpcClient (and related): Connect cello::Objects in separate processes using TCP or Named Pipe-based interprocess communications. This uses a similar approach, but communicates the deltas across process boundaries using the JUCE interprocess communication API.

new ctor that accepts another Object by reference.
"Path" functionality that permits finding/constructing trees/Object by using an absolute or relative path. An impact of this change is that the type parameter passed to cello::Object constructors has been changed from juce::Identifier& to juce::String&.
PropertyUpdateFn alias moved from the Object class into the top-level Cello namespace (defined in the cello_update_source.h header)
added Value::onPropertyChange() to simplify subscribing to value objects that are public; instead of doing e.g. myObject.onPropertyChange (myVal, callback) you can just call myVal.onPropertyChange(callback).
added cello::Value<T>::Cached class to store the last updated state of a Value object to make it usable without requiring a ValueTree lookup and validation each time it's needed.

Object::save now ensures that its file is created before attempting to save.
Object::save returns a juce::Result instead of bool, and will indicate the reason for a failure in that return value.

cello::Query class and updates to cello::Object to perform database-like queries and in-place updating of child objects. See the "Database / Query" section of the README document.

Original release.