16.0.0 Release plan

[IvanGoncharov]

Goals

1. Convert source code to idiomatic TypeScript
2. Remove Flow-specific workarounds and pre-ES6 JS artifacts
3. Support Deno
4. Support ESM
5. Switch master to main.

Planned breaking changes

1. Legacy SDL syntax (deprecated 2year ago) and other deprecated APIs and flags
2. Drop native IE support by removing built-in polyfills and switching the output to ES6. It would be still possible to support IE with core-js + babel.
3. Drop TS before 3.7 since we need to support recursive types.
4. Maybe we will have some unexpected breaking changes to TS types due to migration

Post 16.0.0 goals

1. Convert test suite to Jest
2. Experiment with TS types to provide better typings for resolvers

P.S. We need to target 04/31/2021 for 17.0.0 release at that point we need to do a breaking release anyway to drop Node v10.

Steps

• 1. Branch out 15.x.x release line and release 15.5.0 (Jan 8th)
• 2. Switch master to main and update scripts & CI
• 3. Move commits from https://github.com/graphql/graphql-js/tree/16.x.x to main
• 4. Remove last few polyfills
• 4. Release 16.0.0-alpha.1 with all expected breaking changes but still from Flow sources (Jan 12th)
• 5. Rebase Convert flow types to TS #2828 and merge it (no squash, keep separate commits) (Jan 15th)
• 6. Fix tests, CI, and release scripts but disable tsc and TS-specific ESLint checks (Jan 18th)
• 7. Mark tsc errors with @ts-ignore and fix them in separate PRs by volunteers
• 8. Enable TS-specific ESLint rules in separate PRs by volunteers
• 9. Release new 16.0.0-alpha.3 and gather feedback (finish until Feb WG)
• 10. Work on ESM and Deno support in parallel
• 11. Release 16.0.0-rc.1 and gather feedback
• 12. Generate basic docs with tsdoc
• 13. Release 16.0.0 🎉
• 14. Wait couple weeks and gather feedback.
• 15. Switch main to the 17.0.0-alpha.0 branch and have a setup that will automatically release package after every merge.
• 16. Start accepting breaking/experimental PRs for 17.0.0.

How I can help?

• Review Convert flow types to TS #2828 with basic TS conversion. It's split into multiple commits that are easy to review: https://github.com/graphql/graphql-js/pull/2828/commits
• Wait for Convert flow types to TS #2828 to be merged and help with latter steps.

[dotansimha]

• Convert source code to idiomatic TypeScript

Just adding my previous WIP PRs for this:

• Migrate all tests to TS: Migrate all tests code to TypeScript #2609
• Added missing d.ts files: Added .d.ts files for test utils #2616
• Initial WIP for ESLint and TS: Added specific eslint rules for typescript tests #2634

[Urigo]

Referencing the original Road To TS issue for visibility: #2104

[kamilkisiela]

@IvanGoncharov How the status of TS migration? On GraphQL-JS WG we talked about creating a branch for me and @saihaj so we could join forces.

[IvanGoncharov]

@kamilkisiela Sorry for the delay, was moving our company to a new office 🤯
Not I'm back to OSS, working on merging PRs and releasing 16.0.0-alpha.1

[saihaj]

Convert test suite to Jest

Thoughts on using ts-jest? Ideally src directory will be compiled with tsc and maybe we can remove babel completely. Something to try out after 16.0.0 is released.

[kamilkisiela]

@IvanGoncharov any updates? I would love to push TS forward. Maybe @saihaj could rebase on 16.x.x already and I could sync with him.

[saihaj]

@kamilkisiela me and @IvanGoncharov worked on rebasing my branch yesterday and as we discussed in WG my branch will be moved hopefully by tomorrow to this repo if all goes well today.

[glasser]

Is the asynciterable branch currently likely to land in v16?

[acao]

Is #2839 to be included in this effort?

[robrichard]

@acao I believe the plan is for defer-stream & asynciterable to be incorporated into main once it starts targeting 17.0.0-alpha.x

[IvanGoncharov]

Released https://github.com/graphql/graphql-js/releases/tag/v16.0.0

[khanakia]

I do not see any DENO package listed on https://deno.land/x/

[saihaj]

@khanakia we need to test Deno support. You can try deno branch in this repo and see if it works