Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

overhaul READMEs and add migratio guide for graphiql@2 #2687

Merged
merged 42 commits into from
Aug 24, 2022

Conversation

thomasheyenbrock
Copy link
Collaborator

That's it, last PR for v2! (Unless someone finds a bug 😄 )

This refines the repo README, the README for the graphiql package and adds a migration guide that highlights all the breaking changes and how to upgrade a [email protected] implementation to graphiql@2.

I removed the section with the architecture diagram from the repo README as it's no longer accurately reflecting the current state. Might still be valuable to have this, open for adding it back in an upgraded version later on!

thomasheyenbrock and others added 17 commits August 19, 2022 11:30
* add postcss config to allow nesting

* avoid processing css from `@graphiql/react` with postcss

* add css files for default fonts

* add long description with markdown to dev schema

* rewrite completion tooltip

* move editor css to @graphiql/react

* git mv editor components to `@graphiql/react`

* adjust editor components after moving to `@graphiql/react`

* move styles for auto-inserted leads

* make dynamic padding more resilient and add explanatory comment

* add extra color to avoid conflicts

* colocate markdown and deprecation styles

* add changesets

* fix spell checking

* add changeset for graphiql@2

* don't enter pre-release mode in changeset

* more elaborate changeset message
* add icons to `@graphiql/react`

* add `UnstyledButton` ui component

* implement new design for editors layout

* rename `Unstyled` to `UnStyled` for spell checking

* remove unused class and whitespace in `className`

* make tiny change for deploy preview 🤞

* this will do it, i think?

Co-authored-by: Rikki Schulte <[email protected]>
* implement new toolbar design

* add `caller` argument for better errors
* implement sidebar in new design

* simplify callback
* add icons

* don't invoce callback when programmatically change resizable element

* implement history in new design

* visually separate favourite history items

* add save button when editing history label

* add changeset

* add missing changesets in retrospect

* fix typos

* fix e2e tests

* remove input outline
* move explorer context into folder

* move `TypeLink` component to `@graphiql/react`

* move `FieldLink` component to `@graphiql/react`

* move `DefaultValue` component to `@graphiql/react`

* move `Directive` component to `@graphiql/react`

* extract `MarkdownContent` component in `@gaphiql/react`

* move `Argument` component to `@graphiql/react`

* combine and extend changesets
@changeset-bot
Copy link

changeset-bot bot commented Aug 23, 2022

⚠️ No Changeset found

Latest commit: 98c9a0e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

Base automatically changed from chore/remove-deprecations to graphiql-v2 August 23, 2022 16:25
@thomasheyenbrock thomasheyenbrock force-pushed the feat/migration-guide branch 2 times, most recently from cc7646e to b8d342c Compare August 23, 2022 16:29
thomasheyenbrock and others added 8 commits August 24, 2022 11:53
* add icons

* add `Button` component to `@graphiql/react`

* add explorer section component

* redesign `SchemaDocumentation` component

* redesign `TypeDocumentation` component

* redesign `FieldDocumentation` component

* redesign `DocExplorer` component

* extend changeset message
* implement new design for tabs

* add back `tab` role
* add `Dialog` component to `@graphiql/react`

* add a `clear` method to the `Storage` type

* add success and failure states to `Button` component

* add settings dialog

* make sure to show dialog above editor scrollbars
* add `ButtonGroup` component to `@graphiql/react`

* dark mode
* add a dialog that shows all available shortkeys

* use table in short key dialog

* add shortkey for introspection

* add link to codemirror keymaps
thomasheyenbrock and others added 16 commits August 24, 2022 11:53
* fix selector specificity for link styling

* leverage nesting

* fix hiding the headline on focus

* ensure correct focus outlines and remove visited styles
)

* adds styles to contain the result window above any footer content

* simplifies flex value
* implement toolbar menu in new design

* implement `ToolbarListbox` in new design

* better tooltips
* remove deprecated class methods

* remove utilities

* remove ref forwarding

* refactor inner class component to a function component

* merge main component with context consumer component

* remove component statics

* refactor outer component to be a class component

* remove comments

* add changeset

* remove legacy exports
)

* add `GraphiQLProvider` to `@graphiql/react` and include `StorageContextProvider`

* add `HistoryContextProvider` to `GraphiQLProvider`

* add `EditorContextProvider` to `GraphiQLProvider`

* add `SchemaContextProvider` to `GraphiQLProvider`

* add `ExecutionContextProvider` to `GraphiQLProvider`

* move `ExplorerContextProvider` to `GraphiQLProvider`

* declare props for `GraphiQLInterface`

* reuse prop definitions from editor components

* merge props for default state of editor tools

* rename prop for toggling headers editor

* re-export GraphiQL provider
* add JSDocs for component props and hooks

* add JSDocs for context types

* add README for `@graphiql/react`
* add plugin api for docs and history

* throw error when plugin has no title
README.md Show resolved Hide resolved
@acao
Copy link
Member

acao commented Aug 24, 2022

@thomasheyenbrock looks great! just make sure to restore the absolute URLs in README.md files so the urls work on npmjs.org and other npm like sites!

@thomasheyenbrock
Copy link
Collaborator Author

@acao good shout! NPM supports relative repo links (see for example GitHub and NPM of one of my old side projects), are there other sites you know of that don't?

@acao
Copy link
Member

acao commented Aug 24, 2022

@thomasheyenbrock ok maybe that was just an issue when we first merged all these repos then. i remember there were dozens of issues related to the relative urls years ago. glad they figured that out!

Copy link
Member

@acao acao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@thomasheyenbrock let's do this! for the last commit before we squash, go ahead and remove the pre.json file, and manually remove all the pre release tag suffixes, and for the repo's sake, we will make sure to get the yarn.lock diff for that as well. ideally we can automate that some day. so excited! thanks for all your help on this and @jonathanawesome and everyone else!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants