Releases: graphql-markdown/graphql-markdown
1.24.1
1.24.0
What's Changed
🤖 A new feature printTypeOptions.exampleSection
adds supports for examples using schema directives.
The feature allows inheritance of examples, so once a scalar is set with an example all types using this scalar will share the example. And, of course, you can override those examples. You can also use a custom directive and custom parser.
More details in the documentation.
Object | Operation |
---|---|
The screenshots come from the Group by demo with the feature enabled.
Full Changelog: 1.23.0...1.24.0
1.23.0
What's changed
❇️ Executable types (operations and related directives) and system types (entity types) have now separate sections.
The behaviour can be disabled by setting the option printTypeOptions.useApiGroup
to false
or using the cli flag --noApiGroup
(see documentation).
The online examples have been updated with one using the new sections and one with the option disabled. Note that the examples have some custom CSS that is not part of the default package.
Full Changelog: 1.22.0...1.23.0
1.22.0
🧑🔧 A new setting docOptions.frontMatter
makes it easier to generate pages with Docusaurus settings. Using this setting you can pass any front matter setting to the generator.
Example for the Docusaurus draft
setting:
plugins: [
[
"@graphql-markdown/docusaurus",
{
schema: "./schema/swapi.graphql",
docOptions: {
frontMatter: {
draft: true, // set draft for generated pages
},
},
},
],
],
This option deprecates the options docOptions.pagination
and docOptions.toc
(more details in the documentation).
What's Changed
Full Changelog: 1.21.3...1.22.0
1.21.3
🐛 Fix the incorrect build for 1.21.2 that was missing the changes for #1101.
What's Changed
@graphql-markdown/docusaurus@1.21.3
- 📦 bump dependency @graphql-markdown/core to 1.7.3
- 📦 bump dependency @graphql-markdown/printer-legacy to 1.5.3
@graphql-markdown/core@1.7.3
- 📦 bump peer dependency @graphql-markdown/printer-legacy to 1.5.3
@graphql-markdown/printer-legacy@1.5.3
- ✨ rebuild package
Full Changelog: 1.21.2...1.21.3
1.21.2
🪄 Improve compatibility with Docusaurus 3 by using the new admonition format for the deprecated
admonition (see #1096).
Docusaurus 2 | Docusaurus 3 |
---|---|
:::caution DEPRECATED |
:::warning[DEPRECATED] |
What's Changed
@graphql-markdown/docusaurus@1.21.2
- 📦 bump dependency @graphql-markdown/core to 1.7.2 #1103
- 📦 bump dependency @graphql-markdown/printer-legacy to 1.5.2 #1103
@graphql-markdown/core@1.7.2
- 📦 bump peer dependency @graphql-markdown/printer-legacy to 1.5.2 #1103
@graphql-markdown/printer-legacy@1.5.2
Full Changelog: 1.21.1...1.21.2
1.21.1
🚀 Fix compatibility with Docusaurus 3, since it comes with MDX v3 that is stricter than the version used by Docusaurus 2. 🚀
The compatibility with Docusaurus 2 is maintained, and there is no plan to drop it.
What's Changed
@graphql-markdown/docusaurus@1.21.1
- 📦 bump dependency @graphql-markdown/core to 1.7.1 #1075
- 📦 bump dependency @graphql-markdown/printer-legacy to 1.5.1 #1075
@graphql-markdown/core@1.7.1
- 📦 bump dependency @graphql-markdown/graphql to 1.0.1 #1075
- 📦 bump dependency @graphql-markdown/utils to 1.6.1 #1075
- 📦 bump peer dependency @graphql-markdown/diff to 1.1.1 #1075
- 📦 bump peer dependency @graphql-markdown/helpers to 1.0.1 #1075
- 📦 bump peer dependency @graphql-markdown/printer-legacy to 1.5.1 #1075
- 📦 bump peer dependency graphql-config to 5.0.3 #1075
@graphql-markdown/helpers@1.0.1
- 📦 bump dependency @graphql-markdown/graphql to 1.0.1 #1075
@graphql-markdown/graphql@1.0.1
- 📦 bump dependency @graphql-markdown/utils to 1.6.1 #1075
@graphql-markdown/printer-legacy@1.5.1
- 🐛 fix docusaurus v3 support by @edno in #1073
- 📦 bump dependency @graphql-markdown/graphql to 1.0.1 #1075
- 📦 bump dependency @graphql-markdown/utils to 1.6.1 #1075
@graphql-markdown/diff@1.1.1
- 📦 bump dependency @graphql-markdown/graphql to 1.0.1 #1075
- 📦 bump dependency @graphql-markdown/utils to 1.6.1 #1075
@graphql-markdown/utils@1.6.1
- 📝 udpate typedoc to fix compatibility with docusaurus v3 #1072
Full Changelog: 1.21.0...1.21.1
1.21.0
🚀 BIG release 🚀
This is an exceptionally big release packed with a lot of changes, so read carefully the release notes before upgrading.
The main changes are under the hood as we migrated the codebase from Javascript to Typescript to simplify the coding experience but also to increase the code safety.
⚠️ Breaking changes
- Custom directive helpers have been moved to dedicated packages, see docs.
✨ New features
onlyDocDirective
filters the schema entities to be rendered in the documentation. This is the counterpart ofskipDocDirective
, based on a request from @brampurnot in #994. See documentation.metatags
adds HTML metadata to pages using Docusaurus head metadata, based on a request from @akillkumar in #1015. See documentation.- Helper
directiveDescriptor
now supports thedescription
placeholder, wheredescription
is the default directive's description.
🛠️ Other changes
- Typing is available in a dedicated package
@graphql-markdown/types
. - Modules helpers, graphql and logger have been extracted from
@graphql-markdown/utils
into dedicated packages. - Logger has now a single method called log().
- TS API is getting documented, see API in the docs.
- More and better tests.
- Upgrade dependencies version.
Full Changelog: 1.20.4...1.21.0
1.21.0-next.0
This is a pre-release following the code base migration from JS to TS.
Breaking change
- Custom directive helpers have been moved to dedicated packages, see docs.
Patch change
- Helper
directiveDescriptor
now supportsdescription
placeholder, wheredescription
is the default directive description.
Technical change
- Typing is available in a dedicated package
@graphql-markdown/types
. - Modules
helpers
,graphql
andlogger
have been extracted from@graphql-markdown/utils
into their own package. Logger
has now a single method calledLogger()
.- TS API is getting documented, see
API
in our docs. - More and better tests.
1.20.4
🧑💻 Technical release to freeze the last JS changes before the migration of the code to TS.
What's Changed
@graphql-markdown/docusaurus@1.20.4
- 📦 bump dependency @graphql-markdown/core to 1.6.4
@graphql-markdown/core@1.6.4
Full Changelog: 1.20.3...1.20.4