Skip to content

feat: add support for x-tagGroups extension [TDX-8530]#924

Draft
vaibhavrajsingh2001 wants to merge 1 commit into
mainfrom
feat/xtag-groups-TDX-8530
Draft

feat: add support for x-tagGroups extension [TDX-8530]#924
vaibhavrajsingh2001 wants to merge 1 commit into
mainfrom
feat/xtag-groups-TDX-8530

Conversation

@vaibhavrajsingh2001

Copy link
Copy Markdown
Contributor

Summary

Add support for the OpenAPI x-tagGroups extension to group multiple endpoint tags under named sections in the sidebar.

Changes

  • parse and preserve top-level x-tagGroups from OpenAPI specs
  • update endpoint TOC generation to render nested groups: group → tag → operation
  • when x-tagGroups is present:
    • only tags listed in a group are shown
    • untagged operations are hidden from endpoint navigation
    • unknown tags are skipped with a warning
  • preserve existing behavior when x-tagGroups is not present
  • keep existing multi-tag operation URL handling
  • ensure nested sidebar groups expand correctly when the active path changes during scrolling
  • add sandbox spec coverage using x-tagGroups
  • add focused tests for grouped TOC generation and nested sidebar active-state behavior

Steps to verify

  • open the sandbox with the multi-tags.yaml spec
  • verify the sidebar shows endpoint tags grouped under the configured x-tagGroups sections
  • scroll through endpoint content and verify the active sidebar item updates and expands correctly

Resolves: https://konghq.atlassian.net/browse/TDX-8530

Previews

image

@vaibhavrajsingh2001 vaibhavrajsingh2001 self-assigned this Jul 23, 2026
@kongponents-bot

Copy link
Copy Markdown
Collaborator

Install the preview package from this PR

@kong/spec-renderer@pr-924

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.

2 participants