fix(solid-query): allow both create/use syntax by birkskyum · Pull Request #10260 · TanStack/query

birkskyum · 2026-03-12T11:43:10Z

Query transitioned from create* to use* here:

fix(solid-query): deprecate create in favor of use, and add full docs #8950

It helped a lot with solid maintenance by aligning docs / api surface to vue/svelte/react, and ease of migration between frameworks. Unfortunately this is in some cases less solid-idiomatic (useIsFetching, useMutationState, useIsMutating, useIsRestoring - these return accessors), and even worse it ended up being breaking, because the type forwarding wasn't correctly configured, so some libraries had to pin query versions. Type forwarding since fixed here (thanks!), but deprecation warnings remained:

fix(solid-query): forward generic parameters in deprecated type aliases #10093

To make things just work, this PR allow both the use* syntax for ease of maintenance and migration from react, and the idiomatic create* syntax for existing users and for the idiomatic preference The PR drops the deprecation warnings so that both will work just fine, and add a few extra exports of create*.

cc @2wheeh

Summary by CodeRabbit

New Features
- Solid Query now exposes both "create*" and "use*" naming for hooks and types, making APIs available under either convention for consistency and flexibility.
Documentation
- Added a changeset entry noting a small fix to allow both create/use usage.

changeset-bot · 2026-03-12T11:43:17Z

🦋 Changeset detected

Latest commit: e8ecdba

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

This PR includes changesets to release 3 packages

Name	Type
@tanstack/solid-query	Patch
@tanstack/solid-query-devtools	Patch
@tanstack/solid-query-persist-client	Patch

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

coderabbitai · 2026-03-12T11:43:35Z

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 924b510c-adc6-41b1-ba8f-e6adedb88e22

📥 Commits

Reviewing files that changed from the base of the PR and between d046865 and e8ecdba.

📒 Files selected for processing (1)

packages/solid-query/src/index.ts

📝 Walkthrough

Walkthrough

Adds a changeset and extends packages/solid-query/src/index.ts with numerous Create* type aliases for existing Use* types and runtime create* function aliases (including createQueryClient and createIsRestoring), plus export of IsRestoringProvider; removes deprecation-style comments.

Changes

Cohort / File(s)	Summary
Changeset `.changeset/shiny-mails-help.md`	New patch changeset entry noting support for both `create` and `use` naming conventions.
Solid Query index exports `packages/solid-query/src/index.ts`	Added multiple `Create` type aliases mapping to existing `Use` types (e.g., `CreateQueryOptions`, `CreateMutationResult`, `DefinedCreateQueryResult`); added runtime aliases `createIsFetching`, `createIsMutating`, `createMutationState`, `createQueryClient`, `createIsRestoring`; exported `IsRestoringProvider`; removed deprecated-style comments.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐇 I dug a little tunnel in code so neat,

Now create and use both share the seat.
Aliases hopping, tidy and bright,
I nibble on bugs and nap in the light. 😊

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description provides comprehensive context about the change, including historical background and motivation, but lacks required checklist items from the template.	Complete the required checklist items (Contributing guide confirmation and test verification) and explicitly confirm changeset generation status.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: allowing both create and use syntax in solid-query, which directly corresponds to the PR's objective.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings (stacked PR)
📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch allow-either-create/use-syntax

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

nx-cloud · 2026-03-12T11:43:40Z

View your CI Pipeline Execution ↗ for commit e8ecdba

Command	Status	Duration	Result
`nx affected --targets=test:sherif,test:knip,tes...`	✅ Succeeded	1m 59s	View ↗
`nx run-many --target=build --exclude=examples/*...`	✅ Succeeded	<1s	View ↗

☁️ Nx Cloud last updated this comment at 2026-03-12 11:56:18 UTC

pkg-pr-new · 2026-03-12T11:45:30Z

More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@10260

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@10260

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@10260

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@10260

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@10260

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@10260

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@10260

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@10260

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@10260

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@10260

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@10260

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@10260

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@10260

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@10260

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@10260

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@10260

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@10260

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@10260

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@10260

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@10260

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@10260

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@10260

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@10260

commit: d39953e

github-actions · 2026-03-12T11:45:40Z

size-limit report 📦

Path	Size
react full	11.92 KB (0%)
react minimal	8.95 KB (0%)

github-actions · 2026-03-12T12:03:09Z

🎉 This PR has been released!

@tanstack/solid-query@5.90.25

Thank you for your contribution!

birkskyum added 2 commits March 12, 2026 12:30

allow either create/use syntax for solid

0b35c61

changeset

d046865

github-actions bot added the package: solid-query label Mar 12, 2026

add. missing alias

e8ecdba

birkskyum merged commit 5303191 into main Mar 12, 2026
5 of 6 checks passed

birkskyum deleted the allow-either-create/use-syntax branch March 12, 2026 11:57

github-actions bot mentioned this pull request Mar 12, 2026

ci: Version Packages #10261

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(solid-query): allow both create/use syntax#10260

fix(solid-query): allow both create/use syntax#10260
birkskyum merged 3 commits intomainfrom
allow-either-create/use-syntax

birkskyum commented Mar 12, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

coderabbitai bot commented Mar 12, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 inconclusive)

Uh oh!

nx-cloud bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

birkskyum commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

changeset-bot bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

coderabbitai bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 inconclusive)

Uh oh!

nx-cloud bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-new bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

Uh oh!

github-actions bot commented Mar 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

birkskyum commented Mar 12, 2026 •

edited

Loading

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

coderabbitai bot commented Mar 12, 2026 •

edited

Loading

nx-cloud bot commented Mar 12, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading