* Harden shared tree utilities and add test coverage
- Fix ancestors() throwing a TypeError when a node's parent is undefined
rather than null, which is the case for nodes that haven't been
annotated by useCollectionTrees (e.g. shared trees from the server).
- Guard against malformed parent cycles in ancestors() so a bad tree can
no longer hang the client.
- Compute descendants() depth limits relative to the given node during
traversal instead of relying on optional absolute depth annotations,
which silently returned an empty list when they were missing.
- Tolerate nodes without a children array in traversal.
- Remove type assertions, add JSDoc, and add collocated unit tests.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vt5wWLYomgKZjfgPNk8wN4
* Address review: exclude node from own ancestors on parent cycles
- Seed the cycle guard with the starting node so a malformed parent
cycle can never include the node in its own ancestor list.
- Widen flattenTree's parameter to accept nullish roots so the runtime
guard and the type contract agree.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vt5wWLYomgKZjfgPNk8wN4
---------
Co-authored-by: Claude <noreply@anthropic.com>