ci: Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Add utils.setWindow() method to live query collections to dynamically change limit and offset on ordered queries. (#663)

  You can now change the pagination window of an ordered live query without recreating the collection:

  const users = createLiveQueryCollection((q) =>
    q
      .from({ user: usersCollection })
      .orderBy(({ user }) => user.name, "asc")
      .limit(10)
      .offset(0)
  )
  
  users.utils.setWindow({ offset: 10, limit: 10 })

• Added comprehensive loading state tracking and configurable sync modes to collections and live queries: (#669)

  • Added isLoadingSubset property and loadingSubset:change events to all collections for tracking when data is being loaded
  • Added syncMode configuration option to collections:
    • 'eager' (default): Loads all data immediately during initial sync
    • 'on-demand': Only loads data as requested via loadSubset calls
  • Added comprehensive status tracking to collection subscriptions with status property ('ready' | 'loadingSubset') and events (status:change, status:ready, status:loadingSubset, unsubscribed)
  • Live queries automatically reflect loading state from their source collection subscriptions, with each query maintaining isolated loading state to prevent status "bleed" between independent queries
  • Enhanced setWindow utility to return Promise<void> when loading is triggered, allowing callers to await data loading completion
  • Added subscription parameter to loadSubset handler for advanced sync implementations that need to track subscription lifecycle

• Updated dependencies [63aa8ef]:

  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Add utils.setWindow() method to live query collections to dynamically change limit and offset on ordered queries. (#663)

  You can now change the pagination window of an ordered live query without recreating the collection:

  const users = createLiveQueryCollection((q) =>
    q
      .from({ user: usersCollection })
      .orderBy(({ user }) => user.name, "asc")
      .limit(10)
      .offset(0)
  )
  
  users.utils.setWindow({ offset: 10, limit: 10 })

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Add useLiveInfiniteQuery hook for infinite scrolling with live updates. (#669)

  The new useLiveInfiniteQuery hook provides an infinite query pattern similar to TanStack Query's useInfiniteQuery, but with live updates from your local collection. It uses liveQueryCollection.utils.setWindow() internally to efficiently paginate through ordered data without recreating the query on each page fetch.

  Key features:

  • Automatic live updates as data changes in the collection
  • Efficient pagination using dynamic window adjustment
  • Peek-ahead mechanism to detect when more pages are available
  • Compatible with TanStack Query's infinite query API patterns

  Example usage:

  import { useLiveInfiniteQuery } from "@tanstack/react-db"
  
  function PostList() {
    const { data, pages, fetchNextPage, hasNextPage, isLoading } =
      useLiveInfiniteQuery(
        (q) =>
          q
            .from({ posts: postsCollection })
            .orderBy(({ posts }) => posts.createdAt, "desc"),
        {
          pageSize: 20,
          getNextPageParam: (lastPage, allPages) =>
            lastPage.length === 20 ? allPages.length : undefined,
        }
      )
  
    if (isLoading) return <div>Loading...</div>
  
    return (
      <div>
        {pages.map((page, i) => (
          <div key={i}>
            {page.map((post) => (
              <PostCard key={post.id} post={post} />
            ))}
          </div>
        ))}
        {hasNextPage && (
          <button onClick={() => fetchNextPage()}>Load More</button>
        )}
      </div>
    )
  }

  Requirements:

  • Query must include .orderBy() for the window mechanism to work
  • Returns flattened data array and pages array for flexible rendering
  • Automatically detects new pages when data is synced to the collection

• Updated dependencies [63aa8ef, b0687ab]:

  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]

[email protected]

Patch Changes

• Updated dependencies [63aa8ef, b0687ab]:
  • @tanstack/[email protected]
  • @tanstack/[email protected]

@tanstack/[email protected]

Patch Changes

• Updated dependencies [b0687ab]:
  • @tanstack/[email protected]
  • @tanstack/[email protected]
  • @tanstack/[email protected]
  • @tanstack/[email protected]