refactor(cache): improve cache and integrate reagent

[becomingbabyman]

PR Description

The current homebase cache is not very composable and it's kind of hard to reason about.

The goal of this PR is to rewrite the cache to make it more readily support different view frameworks like (React or Reagent) and different DBs like (Datascript or Datahike).

• [ ] Cache
  • [ ] homebase.cache
    • [x] Entity + Attribute cache
    • [x] Query cache
    • [ ] Ensure that view updates are also transactional and consistent
      • [x] Pass the same DB snapshot to all the change-handlers of a given transaction
      • [ ] Batch all UI updates to occur simultaneously
• [ ] Views
  • [ ] homebase.react
    • [ ] useEntity
    • [ ] useQuery
    • [ ] remove old cache code
  • [x] homebase.reagent
    • [x] (homebase.reagent/connect! db-conn)
    • [x] (homebase.reagent/entity db-conn lookup)
    • [x] reactive homebase.reagent/Entity type
    • [x] (homebase.reagent/q query db-conn & args)
    • [ ] Release on Clojars
• [ ] DBs
  • [x] Datascript
  • [ ] Datahike (probably save this for another PR)
• [ ] Tests
  • [x] Reagent UI tests for all the different reactivity patterns (entity, ref, reverse ref, q, q + pull)
  • [ ] Reagent UI tests to make sure the minimal re-render is happening and the dom is not being thrashed
  • [ ] Datahike + (Reagent / React) tests

PR Checklist

Testing

• [x] added relevant test coverage
• [ ] no tests needed

Docs

• [x] added relevant docs
  • preview them at https://homebase.io/docs/homebase-react/{BRANCH_NAME}/overview
• [x] updated relevant sections in the README.md
• [ ] updated relevant docstrings in index.d.ts
• [ ] no docs needed

Typescript

• [ ] added or edited relevant Typescript type declarations
• [x] no type declaration updates needed

Merging

For maintainers.

To merge, select "Squash and Merge". Then:

1. Make sure the top commit message follows Angular Git Commit Guidelines,
2. Delete all other commit messages in the description, but keep any lines designating co-authors so contributors will retain credit for their contributions.

[vercel[bot]]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployments, click below or on the icon next to each commit.

homebase-example-counter – ./examples/counter

🔍 Inspect: https://vercel.com/homebaseio/homebase-example-counter/An1bN9p8nRoiYdCKmkZHyLZo2iNV
✅ Preview: https://homebase-example-counter-git-cache-refactor-homebaseio.vercel.app

homebase-example-todo – ./examples/todo

🔍 Inspect: https://vercel.com/homebaseio/homebase-example-todo/28tD14xC9A8CxYgE8vvv2MgysLV9
✅ Preview: https://homebase-example-todo-git-cache-refactor-homebaseio.vercel.app

homebase-example-ts-firebase-todo – ./examples/typescript-firebase-todo

🔍 Inspect: https://vercel.com/homebaseio/homebase-example-ts-firebase-todo/HysWZZWiU5TJdNMbUjniNmi8XLdT
✅ Preview: https://homebase-example-ts-firebase-todo-git-cache-refactor-homebaseio.vercel.app

homebase-example-roam – ./examples/roam

🔍 Inspect: https://vercel.com/homebaseio/homebase-example-roam/24NJAuWip8ACFeho6s7UmutoV32i
✅ Preview: https://homebase-example-roam-git-cache-refactor-homebaseio.vercel.app