- preventing to send form onClick left/right arrows in SchemaTabs component
High level enhancements
- bugfix
Other enhancements and bug fixes
- ensure correct eval of required properties with allOf (#771)
High level enhancements
- Various bug fixes
Other enhancements and bug fixes
- Fix allOf schema qualifier and type (#766)
- Ensure qualifiers are rendered for polymorphic/primitive properties (#765)
- uncomment line preventing grouping by operation tags (#764)
- ensure resize observer is calculated once per frame to avoid loops (#763)
High level enhancements
- Improved support for OpenAPI 3.1
Other enhancements and bug fixes
- [bugfix] Ensure 0 and false are guarded correctly and add deprecated support to params (#754)
- upgrade openapi parsers (#748)
High level enhancements
- Adds support for generating sidebar using x-tagGroup
- Adds support for generating schemas
- Improved x-codeSamples support
Other enhancements and bug fixes
- Upgrade dependencies (#741)
- update compatibility matrix (#739)
- feat: implement x-tagGroup feature (#737)
- feat: Implement schema pages behind a config option
showSchemas
(#736) - fix: Guard only undefined and empty strings (#725)
- Conditional display of header Request (#719)
- Fix x-codeSamples load when switching language tabs (#707)
High level enhancements
- Add x-codeSamples support
- Add callbacks support
Other enhancements and bug fixes
- Add support to x-codeSamples (#697)
- Remove deprecated node packages (#699)
- Add Callbacks support (#691)
High level enhancements
- Add callbacks support
- Add markdown support to example/examples summary
Other enhancements and bug fixes
High level enhancements
- Adds security schemes to API Explorer panel
Other enhancements and bug fixes
- Add missing security schemes component (#673)
High level enhancements
- Improve support for handling multi-part form data
Other enhancements and bug fixes
- Improve support for handling multipart form data (#666)
- use SCHEMA_TYPE to distinguish request/response to support readOnly/writeOnly properties (#665)
- add negative look behind to exclude colon delimited path segments (#663)
- Update deploy-preview.yml
- update v2.0.0 refs to v3.0.0
- Update pr-title-check.yaml
- Update canary-beta-release.yml
- Update README.md
High level enhancements
- First v2.0.0 stable release!
Currently only compatible with Docusaurus v2.4.1 -> v2.4.3
Other enhancements and bug fixes
- upgrade to react 18 and demo docusaurus to 2.4.3 (#656)
- allow upgrade to react 18 (#651)
- stop docusaurus support at v2.4.0 (#650)
High level enhancements
- Extend charset support for application/json
- Improve webhook API page layout
Other enhancements and bug fixes
- Improve webhook layout (#646)
- update deprecation message (#644)
- allow charset support for application/json (#643)
- Reuse
createAnyOneOf
while creating a property (#628) - Use
sass-loader
module as dependency (#639) - Remove react nextui dependency in v2.0.0 (#641)
High level enhancements
- Expand capacity for building large sites by compressing frontmatter api property.
Other enhancements and bug fixes
- Fix
makeRequest()
forformdata
request type (#625) - [UI] Cleanup schema item and explorer panel caret alignment (#624)
- revert v2.0.0 schema styles
- Add support for anyOf properties and apply DRY to createSchema (#582)
- Adds compression support to frontmatter api prop (#606)
- Unify tabs naming (#612)
- [Enhancement] Introduce new theme component names: ApiExplorer, CodeSnippets (#577)
- Use SchemaItem to render leaf discriminator properties/nodes (#573)
High level enhancements
- [UI Enhancement] Updated left doc panel styling (#557)
- Improve support for additional properties, cleanup nested
- , support SchemaItem children (#563)
- Upgrade demo to 2.4.0 and update supported range in plugin and theme (#554)
- [UI Enhancement] Enable Expand button for Response (#553)
- [UI Enhancement] Request form validation and updated styling (#530)
- [UI Enhancement] Response Examples: Updated styling and support for multiple language variants (#542)
- [UI Enhancement] Add expand button to CodeBlock (#537)
- [Enhancement] Add support for rendering vendor extensions (#527)
Other enhancements and bug fixes
- [UI Enhancement] ApiDemoPanel: Expand modal cleanup (#566)
- Add more debug info to resolveJsonRefs (#560)
- [UI Enhancement] Restyle schema property labels (#534)
- Restyle details markers (#540)
- Remove PWA (#548)
- Upgrade redocly-core and json-schema-ref-parser (#551)
- [UI Enhancement] Move CodeTabs above Request (#533)
- [UI Enhancement] Move authorization card to ApiItem (#531)
- Update bash/curl logo and refactor how logo width/height are defined (#525)
- [Cleanup] Optimize theme typescript build (#524)
- Point test and include to lib dir (#521)
- [Bug] Narrow SASS loader rules to avoid conflicts with docusaurus-plugin-sass (#519)
High level enhancements
- Added support for powershell
- Added
categorySourceLink
"auto" option - Restyled tree lines to match toc-border-color
Other enhancements and bug fixes
- Add powershell styles
- Remove old styles.css
- [Enhancement] Add support for powershell (#507)
- Resolve conflicts
- Bump webpack from 5.75.0 to 5.76.0 (#498)
- Breaking: Default categoryLinkSource to none, add
auto
option (#495) - Hide details marker (#497)
- Set ignoreAdditionalProperties back to true (#493)
- [UI Enhancement] Restyle tree lines (#489)
- Update banner and badges
High level enhancements
- Added sass loader to theme webpack config
Other enhancements and bug fixes
- Checkout v2.0.0 instead of main (#486)
- Add sass loader to theme webpack config (#484)
- Add canary support to v2 (#485)
High level enhancements
- Add support for Docusaurus 2.3.0 (#471)
- [UI Enhancement] Move MethodEndpoint from ApiDemoPanel to left doc panel (#429)
- [UI Enhancement] Migration to SCSS and BEM-style convention for theme components (#450)
- [UI Enhancement] Include status code tabs in Response card (#476)
Other enhancements and bug fixes
- Split beta release into separate script/workflow (#480)
- Add bold, svg and ensure parity between opening/closing regex (#479)
- Relax if statement (#477)
- Add v2.0.0 branch to release workflows (#475)
High level enhancements
- Add support for rendering additionalProperties schemas (#465)
- Add response status class name to response tab item (#461)
- Update usage docs (#463)
- Allow "none" option for categoryLinkSource (#462)
- Add code, thead and tbody to greaterThan regex (#459)
Other enhancements and bug fixes
High level enhancements
- Add support for security vendor extensions (#457)
- [Enhancement] Add option to hide send button (#456)
- Lock supported docusaurus versions (#449)
- Handle missing params/header schema (#446)
- Apply docusaurus.io styles to demo (#443)
- [FR] Added support for summary and description for param schema examples (#406)
Other enhancements and bug fixes
- Avoid falling back to MOD label when rendering oneOf/anyOf and title not defined (#455)
- Expand support for nullable objects and default to any for empty/unknown schemas (#452)
- Fix security schemes (#444)
- [bug] Use toString() utility to always convert example to string (#442)
- Improve handling of non-string default values (#436)
- Remove trailing slash in outputDir option if present (#435)
- Fix: date-time examples should include time (#427)
- Fix logo/darkLogo and colorMode synching (#426)
- fix: fix logic that determines if an object property is required in response (#424)
- Implement NodePolyfillPlugin in theme webpack config (#422)
- revert
max-width
andmax-height
on code blocks in code tabs (#417) - Update sidebars.md (#413)
- Clarify support for OpenAPI 3.0 (#420)
- Add support for java and expand language variants (#404)
High level enhancements
- Improved support for rendering items/arrays
- Fixed issue that prevented some schemas from fully-rendering (#397)
- Added support for
nullable
Other enhancements and bug fixes
- Cleanup API doc demos (#400)
- [Bug] Support multiple same-level node types and improve items/array support (#397)
- Bump ua-parser-js from 0.7.32 to 0.7.33 (#395)
- Add support for nullable (#393)
- Bump cookiejar from 2.1.3 to 2.1.4 (#390)
- Update intro/README (#384)
- Update a link in the credits (#382)
High level enhancements
- Added support for x-webhooks extension
- Improvements to how Swagger 2.0 is upconverted to OpenAPI 3.0
Other enhancements and bug fixes
- [Bug] Refactor selective sanitization of > and < symbols in generated markdown descriptions (#377)
- fix jsonSchemaMergeAllOf options in createRequestSchema (#374)
- Add resolveInternal to swagger2openapi options (#375)
- [Enhancement] Introduce support for webhooks extension (#370)
High level enhancements
- Introduced proxy support
- Added support for rendering deprecated schema items/properties
Other enhancements and bug fixes
- Only create list of 2xx content types for request samples (#365)
- [Enhancement] Add deprecated support to schema items (#367)
- [Enhancement] Add proxy support (#366)
- kebab case fix for info pages (#363)
- Hide edit URL by default (#364)
- Update index.ts (#361)
High level enhancements
- Emergency patch to address regression bug introdudced by #351
Other enhancements and bug fixes
- Import markdown utils from lib (#358)
High level enhancements
- Added support for swizzling
ApiItem
andApiDemoPanel
components!
Other enhancements and bug fixes
- Remove createProperties from items anyOneOf condition and add new condition for handling items.properties (#356)
- [Enhancement] Allow whitespace in key/token/password input (#354)
- [Bug] Respect readOnly/writeOnly when creating example from schema (#353)
- [Bug] Import Body from @theme in makeRequest (#352)
- [Experimental] Improve support for swizzling theme components (#351)
- Bump loader-utils from 2.0.3 to 2.0.4 (#346)
High level enhancements
- Bug fixes and polish
- Re-introduce missing
--openapi-input-background
variable tostyles.css
Other enhancements and bug fixes
- [Bug] Add condition for handling arrays of discriminators (#344)
High level enhancements
- Introduce Docusaurus v2.2.0 support
Other enhancements and bug fixes
- Include global tags and tag docs only if referenced by operation (#340)
- [Bug] Handle double quotes in sidebar_label frontmatter (#338)
- Fix error when allOf two refs (#335)
- [Bug] Introduce Docusaurus v2.2.0 support (#336)
High level enhancements
- Added support for Algolia DocSearch
Other enhancements and bug fixes
- Update posixPath to wrap path.join to fix backslash issue when buildi… (#332)
- Add pointer events styling to Execute button for invalid requests (#331)
- Add algolia config (#328)
High level enhancements
- Bug fixes and polish
Other enhancements and bug fixes
- [Bug] Improve support for multiline descriptions in frontmatter (#325)
- Use ResizeObserver to conditionally render SchemaTabs arrows (#322)
- Check if plugin is array before accessing first index (#321)
- Use find instead of include to match tags (#320)
- [Cleanup]: Remove "lorem ipsum" instances and boilerplate docs (#318)
High level enhancements
- SEO Improvements
Other enhancements and bug fixes
- [Bug] Support SSR for ApiItem (#314)
High level enhancements
- Support for downloading OpenAPI specification file
Other enhancements and bug fixes
- [Bug] Wrap API docs in BrowserOnly (#310)
- Extend regex to ignore <= and >= (#309)
- [Enhancement] Introduce support for downloading OpenAPI spec (#307)
- Update package.json
High level enhancements
- Bug fixes
Other enhancements and bug fixes
- [Bug] Use endsWith to match docsPluginId to preset (#305)
- Wait for component to mount before calling setStringRawBody (#304)
High level enhancements
- Various bug fixes and polish.
Other enhancements and bug fixes
- Disable warning when loading specs from directory (#302)
- [Bug] Implement selective escape for sanitizing titles and descriptions (#301)
- Return example if present when generating from schema (#300)
High level enhancements
- [FR] Sync Content-Type/Accept with Request/Response (#218)
- Generate API docs on build (#290)
- [Enhancement] Add support for request examples (#293)
- Add support for common params (#292)
Other enhancements and bug fixes
High level enhancements
- [Experimental] Move server input to request card (#286)
- Manually bump to v1.2.1
- [Enhancement] Add support for rendering example
summary
as description (#285)
High level enhancements
- Decrease opacity and for non-active schema/response tabs (#281)
High level enhancements
- Re-introduced ability to send API request from browser.
Other enhancements and bug fixes
- Ensure docPath corresponds to docsPluginId when pluginId is passed (#277)
- Upgrade lerna
- Allow grouping by operation tag if global tag not defined (#276)
- Throw exception when operationId and summary not defined (#274)
- [Enhancement] Set title in mustache templates (#273)
- Check for mapping object before attempting to resolve discriminators (#269)
- Handle both items and non-items schemas in renderDefaultValue (#268)
- [Enhancement] Re-introduce ability to send API requests from browser (#264)
- [Enhancement] Use operation description as frontmatter description (#262)
- Upgrade postman-code-generators (#261)
High level enhancements
- Relax docusaurus dependencies.
Other enhancements and bug fixes
- [Enhancement] Relax docusaurus dependencies and upgrade demo to v2.1.0 (#258)
- Add documentation for languageTabs and request method labels. (#256)
- Add Docusaurus version to demo footer. (#255)
- Update docs
High level enhancements
- Added tooltip support to request option input fields.
- Added multi plugin instance support to CLI.
Other enhancements and bug fixes
- [Enhancement] Split placeholder by newline and add title for tooltip (#252)
- [Bug] Delete writeOnly props instead of readOnly and ignore example if present (#251)
- Upgrade lerna to 5.5.0 (#250)
- Apply flex properties to schema tabs container (#248)
- Add gtag
- Fix logic that determines if an object property is required (#247)
- Bump terser from 5.14.1 to 5.15.0 (#240)
- Bump terser from 5.12.1 to 5.15.0 in /demo (#241)
- [Experimental] Adds multi-instance support to plugin CLI (#244)
- Add combine dependabot workflow (#242)
- Fix missing array opening bracket. (#238)
- [Bug] Fix support for markdown template (#239)
High level enhancements
- Improve CodeTabs and languageTabs support.
Other enhancements and bug fixes
- [Enhancement] Expand supported CodeTab languages (#235)
High level enhancements
- Introduced PWA support to demo/doc site.
- Improvements to how request/response schemas used to create examples.
Other enhancements and bug fixes
- [Bug] Ignore additional props in mergeAllOf (#228)
- [Bug] Various fixes to how request and response schemas are handled (#224)
- [Experimental] Introduce PWA support (#216)
High level enhancements
- Bug fixes.
Other enhancements and bug fixes
- Fix typo TabTtem -> TabItem (#212)
High level enhancements
- Improved consistency of code block styling.
Other enhancements and bug fixes
- Use CodeBlock to render code fences (#210)
High level enhancements
- Polish and bug fixes.
Other enhancements and bug fixes
- [Bug] Improve handling of response schemas and examples (#208)
High level enhancements
- Expanded support for response examples.
- Added support for
readOnly
andwriteOnly
. - Now retains natural tag order in OAS when grouping by tag.
- Expanded support for MIME types.
Other enhancements and bug fixes
- [Enhancement] Add support for single response example (#206)
- [Enhancement] Respect readOnly/writeOnly and improve body sample (#203)
- [Bug] Ensure operation tags match global tags before building sidebar (#202)
- [Enhancement] Apply sorting to tags/sidebar categories (#200)
- [Bug] Ensure required label is consistently applied (#198)
- [Enhancement] Expand support for MIME types (#195)
Other enhancements and bug fixes
- [Enhancement] Add support for rendering default value (#189)
High level enhancements
- Upgraded to Docusaurus v2.0.1
- Refactored qualifiers to improve readability
- Added support for response headers
- Added support for x-logo and x-dark-logo extensions
- Added support for discriminators
- Added support for response status code examples
Other enhancements and bug fixes
- [Bug] Improve handling of schema.items qualifiers (#186)
- Upgrade to Docusaurus v2.0.1 (#185)
- [FR] Support for response status code examples (#176)
- [Enhancement] Add support for x-logo and x-dark-logo extensions (#184)
- [Bug] Fix createPostmanCollection method where a copy of openapiData is generated (#183)
- [Enhancement] Refactor qualifiers to improve readability (#181)
- [Bug] Use basePath in place of slug to avoid duplicate routes (#173)
- [Enhancement] Add support for discriminators (#174)
- Add support for response headers (#171)
High level enhancements
- Rename Endpoint to Base URL.
- Display Base URL form field even if only one URL option is available to select.
- Default
baseId
tooperationId
instead ofsummary
to avoid duplicate routes.
Other enhancements and bug fixes
- [Bug] Use copy of openapiData to generate postman collection (#167)
High level enhancements
- Upgrade to docusaurus 2.0.0-rc.1
Other enhancements and bug fixes
- Upgrade to docusaurus 2.0.0-rc.1 (#164)
High level enhancements
- Refactor
createSchemaDetails.ts
to improve support foranyOf
,oneOf
, andallOf
schemas (#160) - [Enhancement] Improve support for circular $ref pointers (#154)
- [Upgrade] Docusaurus Beta 22 support (#155)
Other enhancements and bug fixes
- Check for basePath before defining intro and category link doc ids (#159)
- [Enhancement] Integrate ReDoc OpenAPIParser (#148)
- [FR] ApiDemoPanel (a11y): Improve keyboard tab support (#149)
- Add await to resolveJsonRefs (#147)
- [Enhancement] Add oneOf and anyOf support (#139)
- Add sidebar and versioning docs (#137)
High level enhancements
- Rename
docPluginId
option todocsPluginId
. - Ensure unique category link for versioned docs when
groupTagsBy
is set to "tag". - Introduce lower-level
json-schema-ref-parser
for handling non-OpenAPI-compliant$ref
pointers.
Other enhancements and bug fixes
High level enhancements
- Extended Docusaurus syntax handling to code samples.
- Implemented CodeTab choice synching for code samples.
- Cleanup XML body editing.
Other enhancements and bug fixes
- [Experimental] Code block/editor optimizations (#132)
High level enhancements
- Converted demo site to official documentation site.
- Added support for generating versioned OpenAPI docs.
Other enhancements and bug fixes
- [Enhancement] Use
docPluginId
to deriverouteBasePath
andpath
(#127) - [Enhancement] Add route base path support (#126)
- Re-gen versioned petstore docs
- [Enhancement] Add versioning support to OpenAPI docs plugin (#125)
- [FR] OpenApi Docs: Expand details by 1L for Desktop (#122)
- [Enhancement] Use plugin-content-docs path when generating sidebar doc items (#124)
- Update README.md and documentation
High level enhancements
- Upgrade to Docusaurus 2.0.0-beta.21 (#116)
- Add support for URL specPath (#120)
- [Enhancement] Implement new OpenAPI parser (#118)
- [Experimental] Info Docs: Added Authentication section with support for Security Schemes (#110)
- [Enhancement] Use docs with embedded links as category link (#114)
Other enhancements and bug fixes
- Update README.md
- Add try/catch to createExample (#115)
- [Bug] Reinstate support for untagged paths (#107)
- [Polish] Add support for head method and badge (#105)
- [Polish] Update demo (#104)
High level enhancements
- Added support for defining
categoryLinkSource
when grouping paths by tag - Extend support for additional
SecuritySchemes
Other enhancements and bug fixes
- Add categoryLinkSource to usage (#101)
- [Bug] Refactor categoryLinkSource option and usage (#100)
- Add extra conditions to check for undefined info properties (#98)
- [Enhancement] Improve category link support when grouping by tags (#97)
- [FR] Additional supported fields for index.api.mdx (#96)
- [FR] Added security schemes support for SecuritySchemes component (#93)
- [Bug] Add missing openapi code colors (#87)
- Add conditions for empty body or body content (#86)
- Add support for canary releases (#85)
- [Theme]: Fix @theme/Tabs namespace collision (#84)
- [Polish] Cleanup @ts-ignore usage throughout project (#80)
High level enhancements
- Pin Docusaurus to v2.0.0-beta.18
- Adopt strategy of pinning Docusaurus version until viable upgrade path exists
Other enhancements and bug fixes
- [Fix Breaking Change] Pin to docusaurus 2.0.0-beta.18 (#76)
- Add keywords and update git URL (#74)
- Switch from panw-main to main
High level enhancements
- Update README, LICENSE, and other supporting documentation
- Remove @paloaltonetworks scope from package name
- Rename main repository and packages to:
- Repository:
docusaurus-openapi-docs
- Plugin:
docusaurus-plugin-openapi-docs
- Theme:
docusaurus-theme-openapi-docs
- Repository:
High level enhancements
- Upgrade to Docusaurus 2.0.0-beta.18
- Remove docusaurus-template-openapi and create-docusaurus-openapi
Note that template moved to it's own GitHub repository
💥 Breaking Changes
- [New Feature]: Extend CLI to support generating API docs (#55)
High level enhancements
Other enhancements and bug fixes
- Merge pull request #60 from PaloAltoNetworks/update-ApiItem
- fix page width
- Update package.json
- Merge pull request #52 from PaloAltoNetworks/api-demo-panel-styling
- Add important flag to openapi-card-background-color
- Update openapi variables
- Merge branch 'panw-main' of https://github.com/PaloAltoNetworks/docusaurus-openapi into api-demo-panel-styling
- [Workaround]: Ensure info/index doc is first item in sidebar (#51)
- Add background styling to demo panel
- Merge pull request #50 from PaloAltoNetworks/editor-cleanup
- Revert light bright styling
- Define openapi-required css variable
- Remove useMonaco hook and import Monaco type
- Remove console log
- Fix mustache template (#49)
- [Bug Fix]: CORS Issue - Monaco editor (#48)
- [Experimental] Enable prev/next for beforeApiDocs items (#45)
High level enhancements
- Move over necessary TS modules and types for
SchemaItem
andParamsItem
components
Bug fixes
- Fix Babel-loader import warnings (#42)
High level enhancements
- Refactor
createSchemaDetails
as theme component - Refactor
createParamsDetails
as theme component - Reduce overall MDX file sizes in final bundle
- Add/improve support for handling
allOf
schema type
Other enhancements and bug fixes
- Improvements/fixes to
allOf
schema support (#40) - Merge pull request #39 from PaloAltoNetworks/schema-component
- Cleanup unnecessary divs and indentation
- Add margin-bottom after each params type
- Remove param item margin-top
- Use react-markdown for descriptions
- Remove react-markdown from plugin package.json
- Use children props for details in SchemaItem
- Fix imports
- Add react-markdown to theme-openapi dependencies
- Add react-markdown
- Fix linting issues
- Readd createDetails for collapsible content
- Import util functions from @paloaltonetworks
- Merge branch 'panw-main' of https://github.com/PaloAltoNetworks/docusaurus-openapi into schema-component
- Remove margin-left from schemaDescription and schemaQualifierMessage
- Remove empty line
- Remove unused listStyle object
- Add SchemaItem styling
- Create SchemaItem component
- Update ParamsItem styling
- Remove unused import
- Import SchemaItem component into createApiPageMD
- Use SchemaItem component in createSchemaDetails
- Remove escape func for examples
- Organize imports
- Remove unused imports
- Add styling to ParamsItem component
- Import ParamsItem component into createApiPageMD
- Create ParamsItem component
- Remove statically created elements from createParamsDetails
High level enhancements
- Switch to forked versions of postman dependencies to reduce bundle size.
Other enhancements and bug fixes
High level enhancements
- Switch to @paloaltonetworks/postman-code-generators
Other enhancements and bug fixes
- Switch to @paloaltonetworks/postman-code-generators (#33)
High level enhancements
- Convert patch-package to full dependency.
High level enhancements
- Nohoist
postman-collection
andpostman-code-generators
to support package-level patching. - Add schema guidelines to improve readability.
- Improve responsiveness.
Other enhancements and bug fixes
- Add patch-package to standalone packages (#29)
- Add guidelines to collapsible schemas (#27)
- Merge pull request #26 from PaloAltoNetworks/response-tweaks-v2
- Update tabs css
- Revert to original ApiPage media query
- Responsiveness tweaks (#25)
- Manually bump to 17.0.3 (#24)
- Merge pull request #23 from PaloAltoNetworks/ui-cleanup
- Increase cypress viewport size
- Hide ApiItem doc pagination on mobile
- Pass down previous and next props to ApiDemoPanel from ApiItem
- Import DocPaginator into ApiDemoPanel
- Adjust responseTabsContainer width
- Adjust apiSidebarContainer media query
High level enhancements
Other enhancements and bug fixes
- Added workflow for Firebase deployment
- Minor fixes to Tabs component
- Minor fixes to schema indentation
Bug fixes
- Merge pull request #13 from PaloAltoNetworks/refactor-tabs
- Update schema indentation
- Refactor response tab dot styling
High level enhancements
- Allow GitHub Actions to publish to npm
- Minor fix to status code Tabs component
Other enhancements and bug fixes
High level enhancements
- Support for Docusuaurs 2.0.0-beta.17!
- New collapsible schema component (replaces tables)
- New Tabs component for status code responses
Bug fixes and such
- Set max-width for schema component
- Disable exhaustive-deps eslint
- Fix infinite render in ParamOptions
- Upgrade
openapi-to-postmanv2
to latest release (3.0.0) - Disable
schemaFaker
- Remove
operationId
from ApiItem - Change ApiItem title to h2
- Use colored badge for method
- Update cypress tests
- Update sidebars tests
Bug fixes
- Fixed type definitions for
showManualAuthentication
andshowExecuteButton
in ApiDemoPanel component
First release of @paloaltonetworks/docusaurus-openapi
High level enhancements
- Support for Docusaurus 2.0.0-beta.15
- Use details component for status code response tables
- Adds options to hide Execute button and auth input field
High level enhancements
- All theme components are now TypeScript 🎉
Other enhancements and bug fixes
- Fix small theme regression (#151)
- Clear request body when empty (#147)
- Fix code editor background color bug (#146)
- Update theme components to TypeScript (#130)
Enhancements and bug fixes
Enhancements and bug fixes
High level enhancements
-
Docusaurus beta.14 support
// Be sure to update @docusaurus/core: "dependencies": { "@docusaurus/core": "2.0.0-beta.14", // ... }
-
With the release of Docusaurus beta.14 (Thanks @slorber!), we can now support configuration of
webpack-dev-server
's proxy via ourdocusaurus-plugin-proxy
plugin.This can be useful when you have a separate API backend development server and you want to send API requests on the same domain.
With the following, a request to
/api/users
will now proxy the request tohttp://localhost:3001/api/users
:// docusaurus.config.js const config = { plugins: [["docusaurus-plugin-proxy", { "/api": "http://localhost:3001" }]], // ... };
To proxy
/api/users
tohttp://localhost:3001/users
, the path can be rewritten:// docusaurus.config.js const config = { plugins: [ [ "docusaurus-plugin-proxy", { "/api": { target: "http://localhost:3001", pathRewrite: { "^/api": "" }, }, }, ], ], // ... };
For more config options, see devServer.proxy.
-
Better yarn 3 support
Other enhancements and bug fixes
High level enhancements
-
Added support for more schema qualifiers:
- maxLength - minLength - maximum - minumum - exclusiveMaximum - exclusiveMinimum - pattern
Example:
slug: type: string description: The human-readable, unique identifier, used to identify the document. minLength: 1 maxLength: 40 pattern: "^[a-zA-Z0-9_-]*$"
Displays:
slug
stringPossible values: 1 ≤ length ≤ 40, Value must match regular expression
^[a-zA-Z0-9_-]*$
The human-readable, unique identifier, used to identify the document.
Other enhancements and bug fixes
- Add additional schema qualifiers (#112)
- Sidebar generation refactor (#111)
- Add recursive folder structure reading & labeling support (#107)
- Add experimental support for loading a multiple OpenAPI definitions (#103)
- Add sidebar item classname for method (#104)
- Fix schema name bug with allOf (#102)
High level enhancements
-
Docusaurus beta.13 support (Thanks @Josh-Cena!)
// Be sure to update @docusaurus/core: "dependencies": { "@docusaurus/core": "2.0.0-beta.13", // ... }
-
The OpenAPI
info
stanza will now generate an "Introduction" pageopenapi: 3.0.3 info: title: Swagger Petstore version: 1.0.0 description: | This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.
-
Request bodies will now render JSON Schema with the use of
allOf
keywordsrequestBody: content: description: Example request application/json: schema: allOf: - $ref: "#/components/schema/Example1" - $ref: "#/components/schema/Example2"
-
Enum options will now be displayed in schema tables
status
stringEnum:
"available"
,"pending"
,"sold"
Pet status in the store
Other enhancements and bug fixes
- Initial proxy code (#97)
- Add support for an introduction page (#94)
- Add
allOf
JSON schema support (#96) - Display enum values in tables (#93)
- Initial plugin refactor (#86)
- Upgrade to Docusaurus beta.13 (#88)
Enhancements and bug fixes
Fix broken package
High level enhancements
- The demo panel now allows you to choose the security scheme from a dropdown that is populated by the OpenAPI definition (only showing the dropdown if more than one is listed)
- Adds support for using multiple auth modes simultaneously (Eg:
(BearerAuth) OR (ApiKeyAuth AND BasicAuth)
) - Adds an
authPersistence
option tothemeConfig.api
. Defaults to"localStorage"
, can be set tofalse
to disable orsessionStorage
to only persist while the window is open.
Other enhancements and bug fixes
- Add better auth support (#74)
The plugin option openapiPath
has been renamed to path
and no longer needs to be wrapped in require.resolve
.
As recomended my the Docusaurus documentation, the plugin docusaurus-plugin-api
has been properly split into 3 packages:
docusaurus-preset-api
docusaurus-plugin-api
docusaurus-theme-api
The package docusaurus-plugin-api
will no longer work on it's own without docusaurus-theme-api
. Instead, the preset docusaurus-preset-api
can be used on it's own and act as a drop-in replacement for @docusaurus/preset-classic
.
Example usage:
// docusaurus.config.js
const config = {
- plugins: [
- [
- "docusaurus-plugin-openapi",
- {
- openapiPath: require.resolve("./examples/openapi.json"),
- },
- ],
- ],
presets: [
[
- "@docusaurus/preset-classic",
+ "docusaurus-preset-openapi",
{
+ api: {
+ path: "examples/openapi.json",
+ }
docs: {
// doc options ...
},
blog: {
// blog options ...
},
theme: {
customCss: require.resolve("./src/css/custom.css"),
},
},
],
],
}
Other enhancements and bug fixes
- Fix multi plugin bug (#69)
- Add yaml support (#68)
- Generate markdown for full page (#65)
- Refactor plugin into separate packages (#64)
- Update documentation (#63)
Enhancements and bug fixes
Enhancements and bug fixes