Move collections to own packages

[KyleAMathews]

Summary

• Move local-only and local-storage collections to main @tanstack/db package
• Create new @tanstack/electric-db-collection package for Electric SQL integration
• Create new @tanstack/query-db-collection package for TanStack Query integration
• Delete @tanstack/db-collections package (removed from repo)
• Update example app and documentation to use new package structure

Benefits

• Better separation of concerns
• Independent versioning for each collection type
• Cleaner dependencies (electric collections don't need query deps, etc.)
• Easier to add additional collection types
• Follows the plan outlined in move electric/query collection options to their own packages so they can be versioned independently #235

Package Names Review

@reviewers: Please weigh in on the new package names:

• @tanstack/electric-db-collection
• @tanstack/query-db-collection

Are these names clear and intuitive? Any suggestions for improvements?

NPM Deprecation

After merge & release, run this command to deprecate the old package:

npm deprecate @tanstack/db-collections "This package has been split into @tanstack/db (for local collections), @tanstack/electric-db-collection, and @tanstack/query-db-collection"

Test plan

• All existing tests pass for moved collections in main @tanstack/db package
• Example app updated and working with new imports
• Documentation updated in main README
• New packages have proper exports and structure

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: cf110f0

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

@tanstack/db-example-react-todo

@tanstack/db

npm i https://pkg.pr.new/@tanstack/db@252

@tanstack/electric-db-collection

npm i https://pkg.pr.new/@tanstack/electric-db-collection@252

@tanstack/query-db-collection

npm i https://pkg.pr.new/@tanstack/query-db-collection@252

@tanstack/react-db

npm i https://pkg.pr.new/@tanstack/react-db@252

@tanstack/vue-db

npm i https://pkg.pr.new/@tanstack/vue-db@252

commit: f0a4ff0

[github-actions]

Size Change: +2.93 kB (+9.3%) 🔍

Total Size: 34.4 kB

Filename	Size	Change
./packages/db/dist/esm/index.js	568 B	+40 B (+7.58%)	🔍
./packages/db/dist/esm/local-only.js	815 B	+815 B (new file)	🆕
./packages/db/dist/esm/local-storage.js	2.07 kB	+2.07 kB (new file)	🆕

ℹ️ View Unchanged

Filename	Size
./packages/db/dist/esm/collection.js	8.27 kB
./packages/db/dist/esm/deferred.js	230 B
./packages/db/dist/esm/errors.js	150 B
./packages/db/dist/esm/optimistic-action.js	294 B
./packages/db/dist/esm/proxy.js	3.75 kB
./packages/db/dist/esm/query/builder/functions.js	531 B
./packages/db/dist/esm/query/builder/index.js	3.4 kB
./packages/db/dist/esm/query/builder/ref-proxy.js	842 B
./packages/db/dist/esm/query/compiler/evaluators.js	1.34 kB
./packages/db/dist/esm/query/compiler/group-by.js	2.09 kB
./packages/db/dist/esm/query/compiler/index.js	1.42 kB
./packages/db/dist/esm/query/compiler/joins.js	1.15 kB
./packages/db/dist/esm/query/compiler/order-by.js	933 B
./packages/db/dist/esm/query/compiler/select.js	657 B
./packages/db/dist/esm/query/ir.js	318 B
./packages/db/dist/esm/query/live-query-collection.js	2.06 kB
./packages/db/dist/esm/SortedMap.js	1.24 kB
./packages/db/dist/esm/transactions.js	2.29 kB

_{compressed-size-action::db-package-size}

[github-actions]

Size Change: 0 B

Total Size: 1.05 kB

ℹ️ View Unchanged

Filename	Size
./packages/react-db/dist/esm/index.js	152 B
./packages/react-db/dist/esm/useLiveQuery.js	902 B

_{compressed-size-action::react-db-package-size}

[samwillis]

LGTM

My only hesitation is on package names. It would be nice is the collection packages had a common prefix so that they sorted/grouped together:

@tanstack/db-collection-electric
@tanstack/db-collection-query

but that doesn't quite read as well.

[KyleAMathews]

We chatted offline and decided to change the names to follow the general tanstack pattern of specific-integration dash type-of-thing e.g. react-db or react-query — electric dash db-collection follows that same pattern.