Graphql Markdown Versions Save

What's Changed

• 🐛 fix mdx special chars escaped in code section (https://github.com/graphql-markdown/graphql-markdown/pull/1382)
• 🐛 add missing support for non printable type in examples (https://github.com/graphql-markdown/graphql-markdown/pull/1419) reported by @Dodoboulistick in #1417

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.24.0...1.24.1

What's Changed

:robot: 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: https://github.com/graphql-markdown/graphql-markdown/compare/1.23.0...1.24.0

What's changed

:sparkle: 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: https://github.com/graphql-markdown/graphql-markdown/compare/1.22.0...1.23.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: https://github.com/graphql-markdown/graphql-markdown/compare/1.21.3...1.22.0

🐛 Fix the incorrect build for 1.21.2 that was missing the changes for #1101.

What's Changed

@graphql-markdown/[email protected]

• 📦 bump dependency @graphql-markdown/core to 1.7.3
• 📦 bump dependency @graphql-markdown/printer-legacy to 1.5.3

@graphql-markdown/[email protected]

• 📦 bump peer dependency @graphql-markdown/printer-legacy to 1.5.3

@graphql-markdown/[email protected]

• ✨ rebuild package

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.21.2...1.21.3

:magic_wand: 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/[email protected]

• :package: bump dependency @graphql-markdown/core to 1.7.2 #1103
• :package: bump dependency @graphql-markdown/printer-legacy to 1.5.2 #1103

@graphql-markdown/[email protected]

• :package: bump peer dependency @graphql-markdown/printer-legacy to 1.5.2 #1103

@graphql-markdown/[email protected]

• :sparkles: (feat) replace caution admonition by warning for docusaurus v3 by @edno in https://github.com/graphql-markdown/graphql-markdown/pull/1101

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.21.1...1.21.2

:rocket: Fix compatibility with Docusaurus 3, since it comes with MDX v3 that is stricter than the version used by Docusaurus 2. :rocket:

The compatibility with Docusaurus 2 is maintained, and there is no plan to drop it.

What's Changed

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/core to 1.7.1 #1075
• :package: bump dependency @graphql-markdown/printer-legacy to 1.5.1 #1075

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/graphql to 1.0.1 #1075
• :package: bump dependency @graphql-markdown/utils to 1.6.1 #1075
• :package: bump peer dependency @graphql-markdown/diff to 1.1.1 #1075
• :package: bump peer dependency @graphql-markdown/helpers to 1.0.1 #1075
• :package: bump peer dependency @graphql-markdown/printer-legacy to 1.5.1 #1075
• :package: bump peer dependency graphql-config to 5.0.3 #1075

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/graphql to 1.0.1 #1075

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/utils to 1.6.1 #1075

@graphql-markdown/[email protected]

• :bug: fix docusaurus v3 support by @edno in https://github.com/graphql-markdown/graphql-markdown/pull/1073
• :package: bump dependency @graphql-markdown/graphql to 1.0.1 #1075
• :package: bump dependency @graphql-markdown/utils to 1.6.1 #1075

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/graphql to 1.0.1 #1075
• :package: bump dependency @graphql-markdown/utils to 1.6.1 #1075

@graphql-markdown/[email protected]

• 📝 udpate typedoc to fix compatibility with docusaurus v3 #1072

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.21.0...1.21.1

🚀 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 of skipDocDirective, 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 the description placeholder, where description 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: https://github.com/graphql-markdown/graphql-markdown/compare/1.20.4...1.21.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 supports description placeholder, where description is the default directive description.

Technical change

• Typing is available in a dedicated package @graphql-markdown/types.
• Modules helpers, graphql and logger have been extracted from @graphql-markdown/utils into their own package.
• Logger has now a single method called Logger().
• TS API is getting documented, see API in our docs.
• More and better tests.

:technologist: Technical release to freeze the last JS changes before the migration of the code to TS.

What's Changed

@graphql-markdown/[email protected]

• :package: bump dependency @graphql-markdown/core to 1.6.4

@graphql-markdown/[email protected]

• :bug: fix typo in generateDocFromSchema (no impact) by @edno in https://github.com/graphql-markdown/graphql-markdown/pull/917

Full Changelog: https://github.com/graphql-markdown/graphql-markdown/compare/1.20.3...1.20.4