vocs 2.3.2 → 2.3.3

package/dist/internal/openapi/openapi.d.ts

@@ -65,6 +65,15 @@ export type SidebarExtras = {
      * @default true
      */
     backLink?: boolean | undefined;
+    /**
+     * Names of `x-tagGroups` sections to flatten: their categories render as
+     * top-level sidebar items (as without tag groups) instead of nesting under
+     * the section header. Useful to keep a primary API prominent while secondary
+     * APIs stay grouped. Names not matching a section are ignored.
+     *
+     * @example ["Data API"]
+     */
+    flatten?: readonly string[] | undefined;
 };
 /**
  * A consumer-authored `.md`/`.mdx` page mounted into an OpenAPI section.
@@ -116,6 +125,17 @@ export type Config = {
      * @example "/api"
      */
     path?: string | undefined;
+    /**
+     * Tag or `x-tagGroups` section names to leave out of the generated reference
+     * entirely: no sidebar items, no category pages, no search entries, and the
+     * operations are stripped from the spec handed to the interactive client.
+     * Excluding a section name excludes every tag it claims. Names matching
+     * nothing are ignored. The source spec is not modified — a spec served
+     * separately (e.g. `/openapi.json`) still contains the operations.
+     *
+     * @example ["Platform API"]
+     */
+    exclude?: readonly string[] | undefined;
     /**
      * Extra sidebar items to add around the auto-generated section (e.g. links to
      * consumer-authored guide pages mounted under `path`).

package/dist/internal/openapi/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/openapi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IAC/B,qDAAqD;IACrD,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAA;IACf;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IAC1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAA;CAC1E,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,UAAU,CAYrD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,OAAO,GAAG,UAAU,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/openapi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAE3E;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,qEAAqE;IACrE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IAC/B,qDAAqD;IACrD,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IAClC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACxC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAA;IACf;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACvC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IAC1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAAA;CAC1E,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,UAAU,CAarD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,OAAO,GAAG,UAAU,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD"}

package/dist/internal/openapi/openapi.js

@@ -19,7 +19,7 @@
  * ```
  */
 export function from(config) {
-    const { spec, path, sidebar, pages } = config;
+    const { spec, path, exclude, sidebar, pages } = config;
     if (!spec)
         throw new Error('[vocs] `openapi` entry is missing a `spec`.');
     if (!path)
@@ -27,6 +27,7 @@ export function from(config) {
     return {
         spec,
         path: normalizePath(path),
+        ...(exclude ? { exclude } : {}),
         ...(sidebar ? { sidebar } : {}),
         ...(pages ? { pages } : {}),
     };

package/dist/internal/openapi/openapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../src/internal/openapi/openapi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6KH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI,CAAC,MAAoB;IACvC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAE7C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACzE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAEzE,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAA;AACH,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3F,OAAO,UAAU,CAAA;AACnB,CAAC"}
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../src/internal/openapi/openapi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiMH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI,CAAC,MAAoB;IACvC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAEtD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACzE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAEzE,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAA;AACH,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;IACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3F,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/internal/openapi/parser.d.ts

@@ -35,6 +35,13 @@ export type Ir = {
     servers: IrServer[];
     /** Operations grouped by category (tag or path segment). */
     groups: IrGroup[];
+    /**
+     * Named sections of categories from `x-tagGroups` (Redoc convention), used to
+     * nest sidebar groups under section headers (e.g. `Data API`, `Platform
+     * API`). Present only when the document declares at least one group that
+     * resolves to a rendered category; navigation-only — pages stay per-category.
+     */
+    tagGroups?: IrTagGroup[] | undefined;
     /**
      * Doc-only "trait" pages: tags marked `x-traitTag: true` (Redoc convention),
      * which carry Markdown `description` content but no operations. The standalone
@@ -75,6 +82,12 @@ export type IrGroup = {
     /** Operations belonging to this category. */
     operations: IrOperation[];
 };
+export type IrTagGroup = {
+    /** Display name of the section (e.g. `Data API`). */
+    name: string;
+    /** Ids of the categories in this section, in authored order. */
+    groupIds: string[];
+};
 export type IrOperation = {
     /** Stable slug used as the operation's anchor on the page. */
     id: string;

package/dist/internal/openapi/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/parser.ts"],"names":[],"mappings":"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"}

package/dist/internal/openapi/parser.js

@@ -49,7 +49,9 @@ export async function parse(config, options = {}) {
     }))
         .filter((server) => server.url);
     const securitySchemes = document.components?.securitySchemes ?? {};
-    const { groups, injections } = await buildGroups(document, { baseUrl: openrpcBaseUrl });
+    const built = await buildGroups(document, { baseUrl: openrpcBaseUrl });
+    const { groups, tagGroups, excluded } = applyExclusions(built.groups, buildTagGroups(document, built.groups), config.exclude);
+    const injections = built.injections;
     // Inject JSON-RPC examples onto the host operation in the spec the
     // interactive client loads, so each "Try" can preselect its method's
     // envelope. The examples must live in the document Scalar reads; when the
@@ -57,12 +59,19 @@ export async function parse(config, options = {}) {
     // back to handing it the augmented `content` instead.
     for (const injection of injections)
         injectRpcExamples(specification, injection);
-    const shouldInlineClientSpec = injections.length > 0 || (isUrl && shouldNormalizeClientServers(document, servers));
+    // Excluded operations are stripped from the client spec too (forcing inline
+    // for URL specs), so the interactive client's own navigation can't leak
+    // them. Strip a clone: the input `specification` may be a caller-owned
+    // object also served elsewhere (e.g. `/openapi.json`), which must keep the
+    // excluded operations.
+    const clientSpecification = (excluded.length > 0 ? structuredClone(specification) : specification);
+    stripOperations(clientSpecification, excluded);
+    const shouldInlineClientSpec = injections.length > 0 ||
+        excluded.length > 0 ||
+        (isUrl && shouldNormalizeClientServers(document, servers));
     if (shouldInlineClientSpec)
-        setClientServers(specification, servers);
-    const client = isUrl && !shouldInlineClientSpec
-        ? { url: spec }
-        : { content: specification };
+        setClientServers(clientSpecification, servers);
+    const client = isUrl && !shouldInlineClientSpec ? { url: spec } : { content: clientSpecification };
     return {
         path: config.path ?? '/',
         client,
@@ -73,10 +82,40 @@ export async function parse(config, options = {}) {
         },
         servers,
         groups,
+        ...(tagGroups ? { tagGroups } : {}),
         traits: buildTraits(document),
         securitySchemes,
     };
 }
+/**
+ * Resolves `x-tagGroups` entries against the built categories. Tags that don't
+ * resolve to a rendered category are dropped; a category claimed by multiple
+ * sections stays with the first (pages are per-category, so one sidebar home).
+ * Returns `undefined` when nothing resolves, so the sidebar stays flat.
+ */
+function buildTagGroups(document, groups) {
+    const entries = document['x-tagGroups'];
+    if (!entries || entries.length === 0)
+        return undefined;
+    const idByName = new Map(groups.map((group) => [group.name, group.id]));
+    const claimed = new Set();
+    const tagGroups = [];
+    for (const entry of entries) {
+        if (!entry?.name)
+            continue;
+        const groupIds = [];
+        for (const tag of entry.tags ?? []) {
+            const id = idByName.get(tag);
+            if (!id || claimed.has(id))
+                continue;
+            claimed.add(id);
+            groupIds.push(id);
+        }
+        if (groupIds.length > 0)
+            tagGroups.push({ name: entry.name, groupIds });
+    }
+    return tagGroups.length > 0 ? tagGroups : undefined;
+}
 /**
  * Adds named JSON-RPC request examples to a host operation's
  * `application/json` request body in the (upgraded) spec document. Scalar
@@ -103,6 +142,68 @@ function injectRpcExamples(specification, injection) {
     const media = content['application/json'];
     media['examples'] = { ...media['examples'], ...injection.examples };
 }
+/**
+ * Applies the config `exclude` list: a name matching an `x-tagGroups` section
+ * excludes every category it claims; a name matching a category (tag) excludes
+ * that category. Excluded categories are dropped from `groups`, pruned from
+ * `tagGroups` (emptied sections are removed), and their operations returned
+ * for stripping from the client spec. Unmatched names are ignored.
+ */
+function applyExclusions(groups, tagGroups, exclude) {
+    const names = new Set(exclude ?? []);
+    if (names.size === 0)
+        return { groups, tagGroups, excluded: [] };
+    const excludedIds = new Set();
+    for (const tagGroup of tagGroups ?? [])
+        if (names.has(tagGroup.name))
+            for (const id of tagGroup.groupIds)
+                excludedIds.add(id);
+    for (const group of groups)
+        if (names.has(group.name))
+            excludedIds.add(group.id);
+    if (excludedIds.size === 0)
+        return { groups, tagGroups, excluded: [] };
+    const excluded = groups
+        .filter((group) => excludedIds.has(group.id))
+        .flatMap((group) => group.operations.map((operation) => ({
+        method: operation.method,
+        path: operation.path,
+        isWebhook: operation.isWebhook ?? false,
+    })));
+    const prunedTagGroups = (tagGroups ?? [])
+        .filter((tagGroup) => !names.has(tagGroup.name))
+        .map((tagGroup) => ({
+        ...tagGroup,
+        groupIds: tagGroup.groupIds.filter((id) => !excludedIds.has(id)),
+    }))
+        .filter((tagGroup) => tagGroup.groupIds.length > 0);
+    return {
+        groups: groups.filter((group) => !excludedIds.has(group.id)),
+        tagGroups: prunedTagGroups.length > 0 ? prunedTagGroups : undefined,
+        excluded,
+    };
+}
+/**
+ * Deletes excluded operations from the (upgraded) spec handed to the
+ * interactive client. A path item left with no methods is removed entirely.
+ */
+function stripOperations(specification, excluded) {
+    // JSON-RPC operations expanded from one host operation share its path+method.
+    const seen = new Set();
+    for (const operation of excluded) {
+        const key = `${operation.isWebhook}:${operation.method}:${operation.path}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const target = specification[operation.isWebhook ? 'webhooks' : 'paths'];
+        const item = target?.[operation.path];
+        if (!item || typeof item !== 'object')
+            continue;
+        delete item[operation.method.toLowerCase()];
+        if (!methods.some((method) => method in item))
+            delete target[operation.path];
+    }
+}
 /** Builds doc-only "trait" pages from tags marked `x-traitTag: true`. */
 function buildTraits(document) {
     const slugger = new GithubSlugger();

package/dist/internal/openapi/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/internal/openapi/parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/internal/openapi/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,aAAa,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;IACT,OAAO;CACC,CAAA;AAiQV;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,MAAsB,EAAE,UAAyB,EAAE;IAC7E,MAAM,EAAE,OAAO,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;IAElF,gEAAgE;IAChE,wCAAwC;IACxC,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAA;IAC7E,MAAM,IAAI,GAAG,MAAM,KAAK,CAAA;IAExB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,GAAY,CAAC,CAAA;IAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,aAAsB,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,aAAa,CAAa,CAAA;IAEtD,MAAM,KAAK,GACT,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;IACzF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IAExC,2EAA2E;IAC3E,8EAA8E;IAC9E,yDAAyD;IACzD,MAAM,cAAc,GAAG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;IAEjD,MAAM,aAAa,GACjB,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,OAAO;YACP,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YAChB,CAAC,CAAC,EAAE,CAAA;IACV,MAAM,OAAO,GAAG,aAAa;SAC1B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,GAAG,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC;QAChD,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEjC,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,CAAA;IAElE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;IACtE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,eAAe,CACrD,KAAK,CAAC,MAAM,EACZ,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EACtC,MAAM,CAAC,OAAO,CACf,CAAA;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAA;IAEnC,mEAAmE;IACnE,qEAAqE;IACrE,0EAA0E;IAC1E,4EAA4E;IAC5E,sDAAsD;IACtD,KAAK,MAAM,SAAS,IAAI,UAAU;QAChC,iBAAiB,CAAC,aAAwC,EAAE,SAAS,CAAC,CAAA;IAExE,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,uBAAuB;IACvB,MAAM,mBAAmB,GAAG,CAC1B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAC1C,CAAA;IAC5B,eAAe,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAA;IAE9C,MAAM,sBAAsB,GAC1B,UAAU,CAAC,MAAM,GAAG,CAAC;QACrB,QAAQ,CAAC,MAAM,GAAG,CAAC;QACnB,CAAC,KAAK,IAAI,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5D,IAAI,sBAAsB;QAAE,gBAAgB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAA;IAE1E,MAAM,MAAM,GACV,KAAK,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAc,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAE/F,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG;QACxB,MAAM;QACN,IAAI,EAAE;YACJ,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,IAAI,eAAe;YAC9C,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO;YAC/B,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW;SACxC;QACD,OAAO;QACP,MAAM;QACN,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;QAC7B,eAAe;KAChB,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,QAAkB,EAAE,MAAiB;IAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAEtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,MAAM,SAAS,GAAiB,EAAE,CAAA;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,IAAI;YAAE,SAAQ;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC5B,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAQ;YACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACf,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACnB,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,aAAsC,EAAE,SAAuB;IACxF,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAwD,CAAA;IAC3F,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAE/C,CAAA;IACb,IAAI,CAAC,SAAS;QAAE,OAAM;IAEtB,IAAI,WAAW,GAAG,SAAS,CAAC,aAAa,CAAwC,CAAA;IACjF,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,MAAM,IAAI,WAAW,EAAE,CAAC;QAC7E,WAAW,GAAG,EAAE,CAAA;QAChB,SAAS,CAAC,aAAa,CAAC,GAAG,WAAW,CAAA;IACxC,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;QAAE,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAA4C,CAAA;IACjF,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAA;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACzC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,GAAI,KAAK,CAAC,UAAU,CAA6B,EAAE,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAA;AAClG,CAAC;AAKD;;;;;;GAMG;AACH,SAAS,eAAe,CACtB,MAAiB,EACjB,SAAmC,EACnC,OAAsC;IAEtC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IACpC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAEhE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,KAAK,MAAM,QAAQ,IAAI,SAAS,IAAI,EAAE;QACpC,IAAI,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,QAAQ;gBAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACvF,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChF,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IAEtE,MAAM,QAAQ,GAAG,MAAM;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SAC5C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,KAAK;KACxC,CAAC,CAAC,CACJ,CAAA;IACH,MAAM,eAAe,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;SACtC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KACjE,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACrD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5D,SAAS,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;QACnE,QAAQ;KACT,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CACtB,aAAsC,EACtC,QAA6B;IAE7B,8EAA8E;IAC9E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,CAAA;QAC1E,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEb,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAE1D,CAAA;QACb,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9E,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,WAAW,CAAC,QAAkB;IACrC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAA;IACnC,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,SAAQ;QAC7C,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC;YAC3B,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC;SACxB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAeD;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,GAAW,EAAE,OAA2B;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,CAAA;IACxB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,4BAA4B,CAAC,QAAkB,EAAE,OAAmB;IAC3E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnE,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAA;QAC5B,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,gBAAgB,CAAC,aAAsC,EAAE,OAAmB;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,aAAa,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CAAC,CAAA;AACL,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,IAAI,CACjB,IAAkB,EAClB,OAAe;IAEf,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAA+B,CAAA;IAEpE,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QACtF,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,kDAAkD;IAClD,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAE1C,+EAA+E;IAC/E,qEAAqE;IACrE,IAAI,CAAC;QACH,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChD,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,MAAM,CAAC,WAAW,CAAC;SACpB,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC3E,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;IAChC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACxC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/E,OAAO,KAAK,CAAA;AACd,CAAC;AAWD,4CAA4C;AAC5C,KAAK,UAAU,WAAW,CACxB,QAAkB,EAClB,UAA4C,EAAE;IAE9C,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAA;IACnC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAA;IAC1D,MAAM,UAAU,GAAmB,EAAE,CAAA;IAErC,+EAA+E;IAC/E,6EAA6E;IAC7E,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC;YAAE,SAAQ;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACpB,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAA;IAClC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAA;QAE5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;YAC9B,IAAI,CAAC,SAAS;gBAAE,SAAQ;YAExB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;YAElD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;gBACzB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvB,CAAC;YAED,MAAM,KAAK,GAAG,cAAc,CAAC;gBAC3B,MAAM;gBACN,QAAQ;gBACR,SAAS;gBACT,cAAc;gBACd,OAAO;aACR,CAAC,CAAA;YAEF,2EAA2E;YAC3E,qEAAqE;YACrE,kDAAkD;YAClD,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,EAAE;wBACnF,OAAO,EAAE,OAAO,CAAC,OAAO;qBACzB,CAAC,CAAA;oBACF,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;oBAC9E,mEAAmE;oBACnE,gEAAgE;oBAChE,yDAAyD;oBACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;wBAC3D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;gBACzD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,uEAAuE;oBACvE,gEAAgE;oBAChE,6DAA6D;oBAC7D,OAAO,CAAC,IAAI,CACV,yCAAyC,MAAM,CAAC,WAAW,EAAE,IAAI,QAAQ,KACvE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAA;oBACD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBACpC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,sDAAsD;IACtD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAA;QAE5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;YAC9B,IAAI,CAAC,SAAS;gBAAE,SAAQ;YAExB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAA;YACnD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;gBACzB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvB,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CACzB,cAAc,CAAC;gBACb,MAAM;gBACN,QAAQ,EAAE,IAAI;gBACd,SAAS;gBACT,cAAc;gBACd,OAAO;gBACP,SAAS,EAAE,IAAI;aAChB,CAAC,CACH,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI;QACJ,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;KACnC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAEjD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;AAC/B,CAAC;AAED,SAAS,cAAc,CAAC,OAOvB;IACC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAE3F,yEAAyE;IACzE,yDAAyD;IACzD,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAA;IAE/F,iFAAiF;IACjF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC9C,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE;YAAE,SAAQ;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,EAAE,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,QAAQ;QACd,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,UAAU,EAAE,SAAS,CAAC,UAAU;QAChC,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,SAAS,CAAC,IAAc;YAC9B,EAAE,EAAE,SAAS,CAAC,EAAuB;YACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,OAAO,EAAE,SAAS,CAAC,OAAO;SAC3B,CAAC,CAAC;QACH,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC;QAC7C,SAAS,EAAE,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC;QAC9C,QAAQ,EAAE,SAAS,CAAC,QAAQ;KAC7B,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAyB;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;KACpC,CAAA;AACH,CAAC;AAED,SAAS,cAAc,CAAC,SAAkD;IACxE,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IACzB,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM;QACN,WAAW,EAAE,QAAQ,EAAE,WAAW;QAClC,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;QACxC,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;KACzC,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,YAAY,CAAC,OAA8C;IAClE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI;QACJ,QAAQ,EAAE,MAAM,EAAE,QAAQ;QAC1B,UAAU,EAAE,MAAM,EAAE,UAAU;QAC9B,WAAW,EAAE,MAAM,EAAE,WAAW;QAChC,MAAM,EAAE,MAAM,EAAE,MAAM;QACtB,OAAO,EAAE,MAAM,EAAE,OAAO;KACzB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,YAAY,CACnB,OAA4F;IAE5F,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1D,SAAS;QACT,MAAM,EAAE,KAAK,EAAE,MAAM;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO;KACxB,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/internal/openapi/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,EAAS,MAAM,aAAa,CAAA;AAG5C,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAK/B;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAc1D;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,IAAI,KAAK,GAAG,IAAI,CAEnC;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;CAAE,CAAC,CAWnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBnD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,EAAS,MAAM,aAAa,CAAA;AAG5C,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAK/B;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAc1D;AAED,4DAA4D;AAC5D,wBAAgB,IAAI,IAAI,KAAK,GAAG,IAAI,CAEnC;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAA;CAAE,CAAC,CAYnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmBnD"}

package/dist/internal/openapi/registry.js

@@ -43,8 +43,9 @@ export function sidebars(config) {
         const entry = config?.openapi?.find((entry) => entry.path === path);
         const collapsed = entry?.sidebar?.collapsed;
         const intro = entry?.sidebar?.intro;
+        const flatten = entry?.sidebar?.flatten;
         const backLink = entry?.sidebar?.backLink ?? true;
-        result[path] = { backLink, items: Sidebar.toSidebar(ir, { collapsed, intro }) };
+        result[path] = { backLink, items: Sidebar.toSidebar(ir, { collapsed, intro, flatten }) };
     }
     return result;
 }

package/dist/internal/openapi/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/internal/openapi/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/internal/openapi/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAIvC,IAAI,KAAK,GAAiB,IAAI,CAAA;AAC9B,IAAI,QAAQ,GAA0B,IAAI,CAAA;AAE1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,MAAc;IACxC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;QACrB,MAAM,IAAI,GAAU,EAAE,CAAA;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE;YACtC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;QACpE,KAAK,GAAG,IAAI,CAAA;QACZ,QAAQ,GAAG,IAAI,CAAA;QACf,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,EAAE,CAAA;IAEJ,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,IAAI;IAClB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,IAAI,CAAA;IACZ,QAAQ,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAe;IAEf,MAAM,MAAM,GAAsE,EAAE,CAAA;IACpF,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAA;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QACnE,MAAM,SAAS,GAAG,KAAK,EAAE,OAAO,EAAE,SAAS,CAAA;QAC3C,MAAM,KAAK,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,CAAA;QACnC,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,OAAO,CAAA;QACvC,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAA;QACjD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;IAC1F,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAEtD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAA;IAElC,IAAI,MAA+B,CAAA;IACnC,IAAI,CAAC,WAAW;QAAE,MAAM,GAAG,EAAE,CAAA;SACxB,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,MAAM,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,CAAA;;QAC7D,MAAM,GAAG,EAAE,GAAG,WAAW,EAAE,CAAA;IAEhC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;QAC1E,MAAM,GAAG,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAA;QACrC,MAAM,MAAM,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,CAAA;QAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,EAAE,CAAA;IAC7E,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAA2B,EAAE,CAAA;AAC5D,CAAC"}

package/dist/internal/openapi/sidebar.d.ts

@@ -11,7 +11,9 @@ export declare function methodVariant(method: string): BadgeVariant;
  * OpenAPI IR.
  *
  * Each category is its own page; operation links are in-page anchors on that
- * page (`/api/{group}#{operation}`).
+ * page (`/api/{group}#{operation}`). When the IR carries `tagGroups`, claimed
+ * categories nest under static section headers; unclaimed ones follow at the
+ * top level so no category silently disappears.
  */
 export declare function toSidebar(ir: Ir, options?: toSidebar.Options): SidebarItem<true>[];
 export declare namespace toSidebar {
@@ -25,6 +27,11 @@ export declare namespace toSidebar {
          * auto-expands). `Introduction` is unaffected. @default false
          */
         collapsed?: boolean | undefined;
+        /**
+         * Names of `x-tagGroups` sections whose categories render as top-level
+         * items (in place) instead of nesting under the section header.
+         */
+        flatten?: readonly string[] | undefined;
     };
 }
 //# sourceMappingURL=sidebar.d.ts.map

package/dist/internal/openapi/sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/sidebar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,EAAE,EAAe,MAAM,aAAa,CAAA;AAKlD,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;AAEzE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAc1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,GAAE,SAAS,CAAC,OAAY,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAoDtF;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,OAAO,GAAG;QACb,6DAA6D;QAC7D,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;QACjC,sEAAsE;QACtE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,SAAS,CAAA;QACpD;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAChC,CAAA;CACF"}
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../src/internal/openapi/sidebar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,EAAE,EAAe,MAAM,aAAa,CAAA;AAKlD,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;AAEzE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAc1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,GAAE,SAAS,CAAC,OAAY,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAwEtF;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,OAAO,GAAG;QACb,6DAA6D;QAC7D,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;QACjC,sEAAsE;QACtE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,SAAS,CAAA;QACpD;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC/B;;;WAGG;QACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;KACxC,CAAA;CACF"}

package/dist/internal/openapi/sidebar.js

@@ -24,7 +24,9 @@ export function methodVariant(method) {
  * OpenAPI IR.
  *
  * Each category is its own page; operation links are in-page anchors on that
- * page (`/api/{group}#{operation}`).
+ * page (`/api/{group}#{operation}`). When the IR carries `tagGroups`, claimed
+ * categories nest under static section headers; unclaimed ones follow at the
+ * top level so no category silently disappears.
  */
 export function toSidebar(ir, options = {}) {
     // Strip a trailing slash so a root mount (`/`) doesn't yield `//group`.
@@ -48,27 +50,47 @@ export function toSidebar(ir, options = {}) {
     // Generated category groups start collapsed when `collapsed` is set (the
     // active group still auto-expands at render). `Introduction` is unaffected.
     const groupCollapsed = options.collapsed ?? false;
+    const groupItem = (group) => ({
+        text: group.name,
+        collapsed: groupCollapsed,
+        items: [
+            // An "Overview" entry links to the category itself; the top-level item
+            // is a non-link header so its label doesn't compete with the operations.
+            { text: 'Overview', link: groupLink(group.id) },
+            ...(groupExtras.get(group.id) ?? []),
+            ...group.operations.map((operation) => ({
+                text: operation.summary || `${operation.method} ${operation.path}`,
+                link: operationLink(operation, group.id),
+                // Webhooks are inbound deliveries, not callable endpoints — show a
+                // webhook glyph instead of the HTTP method (which is always POST).
+                badge: operation.isWebhook && webhookIcon
+                    ? { icon: webhookIcon, variant: methodVariant(operation.method) }
+                    : { text: operation.method, variant: methodVariant(operation.method) },
+            })),
+        ],
+    });
+    const tagGroups = ir.tagGroups ?? [];
+    if (tagGroups.length === 0)
+        return [introduction, ...ir.groups.map(groupItem)];
+    // `x-tagGroups` sections render as static headers (no `collapsed`, so not
+    // collapsible); the per-category `collapsed` behavior applies unchanged.
+    // Sections named in `flatten` spread their categories in place instead.
+    const flatten = new Set(options.flatten ?? []);
+    const groupById = new Map(ir.groups.map((group) => [group.id, group]));
+    const claimed = new Set(tagGroups.flatMap((tagGroup) => tagGroup.groupIds));
+    const sections = tagGroups.flatMap((tagGroup) => {
+        const items = tagGroup.groupIds.flatMap((id) => {
+            const group = groupById.get(id);
+            return group ? [groupItem(group)] : [];
+        });
+        if (flatten.has(tagGroup.name))
+            return items;
+        return [{ text: tagGroup.name, items }];
+    });
     return [
         introduction,
-        ...ir.groups.map((group) => ({
-            text: group.name,
-            collapsed: groupCollapsed,
-            items: [
-                // An "Overview" entry links to the category itself; the top-level item
-                // is a non-link header so its label doesn't compete with the operations.
-                { text: 'Overview', link: groupLink(group.id) },
-                ...(groupExtras.get(group.id) ?? []),
-                ...group.operations.map((operation) => ({
-                    text: operation.summary || `${operation.method} ${operation.path}`,
-                    link: operationLink(operation, group.id),
-                    // Webhooks are inbound deliveries, not callable endpoints — show a
-                    // webhook glyph instead of the HTTP method (which is always POST).
-                    badge: operation.isWebhook && webhookIcon
-                        ? { icon: webhookIcon, variant: methodVariant(operation.method) }
-                        : { text: operation.method, variant: methodVariant(operation.method) },
-                })),
-            ],
-        })),
+        ...sections,
+        ...ir.groups.filter((group) => !claimed.has(group.id)).map(groupItem),
     ];
 }
 //# sourceMappingURL=sidebar.js.map

package/dist/internal/openapi/sidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../../src/internal/openapi/sidebar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../../../src/internal/openapi/sidebar.ts"],"names":[],"mappings":"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"}

package/dist/server/openapi/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/server/openapi/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,KAAK,OAAO,MAAM,mCAAmC,CAAA;AAKjE;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,OAAO,GAAE,OAAO,CAAC,OAAY,GAC5B,OAAO,CAAC,OAAO,CAAC,CAuElB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,4DAA4D;QAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B;;;;WAIG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC1C,OAAO,GAAE,UAAU,CAAC,OAAY,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,OAAO,GAAG;QACb,0EAA0E;QAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/server/openapi/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,KAAK,KAAK,OAAO,MAAM,mCAAmC,CAAA;AAKjE;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,EACtB,OAAO,GAAE,OAAO,CAAC,OAAY,GAC5B,OAAO,CAAC,OAAO,CAAC,CAwElB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,OAAO,GAAG;QACb,4DAA4D;QAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B;;;;WAIG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC1C,OAAO,GAAE,UAAU,CAAC,OAAY,GAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAK,OAAO,GAAG;QACb,0EAA0E;QAC1E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF"}

package/dist/server/openapi/state.js

@@ -46,6 +46,7 @@ export async function prepare(config, options = {}) {
     const bottom = config.sidebar?.bottom ?? [];
     const intro = [...traitIntro, ...(config.sidebar?.intro ?? [])];
     const collapsed = config.sidebar?.collapsed ?? false;
+    const flatten = config.sidebar?.flatten;
     const newGroups = [...extraGroups].map(([name, items]) => ({
         text: name,
         collapsed,
@@ -53,7 +54,7 @@ export async function prepare(config, options = {}) {
     }));
     const sidebar = [
         ...top,
-        ...Sidebar.toSidebar(ir, { intro, groupExtras, collapsed }),
+        ...Sidebar.toSidebar(ir, { intro, groupExtras, collapsed, flatten }),
         ...newGroups,
         ...bottom,
     ];

package/dist/server/openapi/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/server/openapi/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/server/openapi/state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vocs",
   "type": "module",
-  "version": "2.3.2",
+  "version": "2.3.3",
   "main": "./dist/index.js",
   "license": "MIT",
   "repository": {

package/src/internal/openapi/openapi.ts

@@ -69,6 +69,15 @@ export type SidebarExtras = {
    * @default true
    */
   backLink?: boolean | undefined
+  /**
+   * Names of `x-tagGroups` sections to flatten: their categories render as
+   * top-level sidebar items (as without tag groups) instead of nesting under
+   * the section header. Useful to keep a primary API prominent while secondary
+   * APIs stay grouped. Names not matching a section are ignored.
+   *
+   * @example ["Data API"]
+   */
+  flatten?: readonly string[] | undefined
 }
 
 /**
@@ -122,6 +131,17 @@ export type Config = {
    * @example "/api"
    */
   path?: string | undefined
+  /**
+   * Tag or `x-tagGroups` section names to leave out of the generated reference
+   * entirely: no sidebar items, no category pages, no search entries, and the
+   * operations are stripped from the spec handed to the interactive client.
+   * Excluding a section name excludes every tag it claims. Names matching
+   * nothing are ignored. The source spec is not modified — a spec served
+   * separately (e.g. `/openapi.json`) still contains the operations.
+   *
+   * @example ["Platform API"]
+   */
+  exclude?: readonly string[] | undefined
   /**
    * Extra sidebar items to add around the auto-generated section (e.g. links to
    * consumer-authored guide pages mounted under `path`).
@@ -191,7 +211,7 @@ export type SiteConfig = Config & {
  * ```
  */
 export function from(config: from.Options): SiteConfig {
-  const { spec, path, sidebar, pages } = config
+  const { spec, path, exclude, sidebar, pages } = config
 
   if (!spec) throw new Error('[vocs] `openapi` entry is missing a `spec`.')
   if (!path) throw new Error('[vocs] `openapi` entry is missing a `path`.')
@@ -199,6 +219,7 @@ export function from(config: from.Options): SiteConfig {
   return {
     spec,
     path: normalizePath(path),
+    ...(exclude ? { exclude } : {}),
     ...(sidebar ? { sidebar } : {}),
     ...(pages ? { pages } : {}),
   }

package/src/internal/openapi/parser.test.ts

@@ -188,6 +188,113 @@ describe('parse', () => {
     expect(fallback?.operations.map((op) => op.id)).toEqual(['health'])
   })
 
+  test('omits `tagGroups` when the document has no `x-tagGroups`', async () => {
+    const ir = await parse(OpenApi.from({ spec, path: '/api' }))
+    expect(ir.tagGroups).toBeUndefined()
+  })
+
+  test('resolves `x-tagGroups` to rendered group ids', async () => {
+    const ir = await parse(
+      OpenApi.from({
+        spec: {
+          ...spec,
+          'x-tagGroups': [
+            { name: 'Data API', tags: ['pets'] },
+            { name: 'Platform API', tags: ['store'] },
+          ],
+        },
+        path: '/api',
+      }),
+    )
+    expect(ir.tagGroups).toEqual([
+      { name: 'Data API', groupIds: ['pets'] },
+      { name: 'Platform API', groupIds: ['store'] },
+    ])
+  })
+
+  test('drops unknown tags, empty sections, and repeat claims from `x-tagGroups`', async () => {
+    const ir = await parse(
+      OpenApi.from({
+        spec: {
+          ...spec,
+          'x-tagGroups': [
+            // `missing` names no rendered group; `pets` resolves.
+            { name: 'Data API', tags: ['missing', 'pets'] },
+            // Both tags already claimed or unknown → section drops entirely.
+            { name: 'Empty', tags: ['pets', 'nope'] },
+            // Unnamed entries are ignored.
+            { tags: ['store'] },
+          ],
+        },
+        path: '/api',
+      }),
+    )
+    expect(ir.tagGroups).toEqual([{ name: 'Data API', groupIds: ['pets'] }])
+  })
+
+  test('omits `tagGroups` when no `x-tagGroups` entry resolves', async () => {
+    const ir = await parse(
+      OpenApi.from({
+        spec: { ...spec, 'x-tagGroups': [{ name: 'Ghost', tags: ['missing'] }] },
+        path: '/api',
+      }),
+    )
+    expect(ir.tagGroups).toBeUndefined()
+  })
+
+  test('excludes a tag by name, stripping its operations from the client spec', async () => {
+    const ir = await parse(OpenApi.from({ spec, path: '/api', exclude: ['store'] }))
+    expect(ir.groups.map((group) => group.name)).toEqual(['pets', 'default'])
+    const content = (ir.client as { content: Record<string, unknown> }).content
+    const paths = content['paths'] as Record<string, unknown>
+    expect(paths['/inventory']).toBeUndefined()
+    expect(paths['/pets']).toBeDefined()
+  })
+
+  test('excludes every tag an excluded `x-tagGroups` section claims', async () => {
+    const ir = await parse(
+      OpenApi.from({
+        spec: {
+          ...spec,
+          'x-tagGroups': [
+            { name: 'Data API', tags: ['pets'] },
+            { name: 'Platform API', tags: ['store'] },
+          ],
+        },
+        path: '/api',
+        exclude: ['Platform API'],
+      }),
+    )
+    expect(ir.groups.map((group) => group.name)).toEqual(['pets', 'default'])
+    expect(ir.tagGroups).toEqual([{ name: 'Data API', groupIds: ['pets'] }])
+    const content = (ir.client as { content: Record<string, unknown> }).content
+    expect((content['paths'] as Record<string, unknown>)['/inventory']).toBeUndefined()
+  })
+
+  test('keeps other methods on a path shared with an excluded tag', async () => {
+    const sharedSpec = {
+      openapi: '3.1.0',
+      info: { title: 'Shared', version: '1.0.0' },
+      paths: {
+        '/shared': {
+          get: { operationId: 'readShared', tags: ['a'], responses: { '200': {} } },
+          post: { operationId: 'writeShared', tags: ['b'], responses: { '201': {} } },
+        },
+      },
+    }
+    const ir = await parse(OpenApi.from({ spec: sharedSpec, path: '/api', exclude: ['a'] }))
+    expect(ir.groups.map((group) => group.name)).toEqual(['b'])
+    const content = (ir.client as { content: Record<string, unknown> }).content
+    const shared = (content['paths'] as Record<string, Record<string, unknown>>)['/shared']
+    expect(shared?.['get']).toBeUndefined()
+    expect(shared?.['post']).toBeDefined()
+  })
+
+  test('ignores exclude names matching nothing', async () => {
+    const ir = await parse(OpenApi.from({ spec, path: '/api', exclude: ['Ghost'] }))
+    expect(ir.groups.map((group) => group.name)).toEqual(['pets', 'store', 'default'])
+  })
+
   test('inlines remote specs with relative servers for the API client', async () => {
     const fetch_ = globalThis.fetch
     const remoteSpec = {

package/src/internal/openapi/parser.ts

@@ -46,6 +46,13 @@ export type Ir = {
   servers: IrServer[]
   /** Operations grouped by category (tag or path segment). */
   groups: IrGroup[]
+  /**
+   * Named sections of categories from `x-tagGroups` (Redoc convention), used to
+   * nest sidebar groups under section headers (e.g. `Data API`, `Platform
+   * API`). Present only when the document declares at least one group that
+   * resolves to a rendered category; navigation-only — pages stay per-category.
+   */
+  tagGroups?: IrTagGroup[] | undefined
   /**
    * Doc-only "trait" pages: tags marked `x-traitTag: true` (Redoc convention),
    * which carry Markdown `description` content but no operations. The standalone
@@ -90,6 +97,13 @@ export type IrGroup = {
   operations: IrOperation[]
 }
 
+export type IrTagGroup = {
+  /** Display name of the section (e.g. `Data API`). */
+  name: string
+  /** Ids of the categories in this section, in authored order. */
+  groupIds: string[]
+}
+
 export type IrOperation = {
   /** Stable slug used as the operation's anchor on the page. */
   id: string
@@ -197,6 +211,11 @@ type Document = {
     'x-subtitle'?: string
     'x-parent'?: string
   }[]
+  /**
+   * Redoc convention: named sections of tags, rendered as sidebar section
+   * headers with the tags' groups nested inside.
+   */
+  'x-tagGroups'?: { name?: string; tags?: string[] }[]
   paths?: Record<string, PathItem>
   /**
    * OpenAPI 3.1 outbound webhook deliveries. Keyed by event name (an arbitrary
@@ -297,7 +316,13 @@ export async function parse(config: OpenApi.Config, options: parse.Options = {})
 
   const securitySchemes = document.components?.securitySchemes ?? {}
 
-  const { groups, injections } = await buildGroups(document, { baseUrl: openrpcBaseUrl })
+  const built = await buildGroups(document, { baseUrl: openrpcBaseUrl })
+  const { groups, tagGroups, excluded } = applyExclusions(
+    built.groups,
+    buildTagGroups(document, built.groups),
+    config.exclude,
+  )
+  const injections = built.injections
 
   // Inject JSON-RPC examples onto the host operation in the spec the
   // interactive client loads, so each "Try" can preselect its method's
@@ -307,14 +332,24 @@ export async function parse(config: OpenApi.Config, options: parse.Options = {})
   for (const injection of injections)
     injectRpcExamples(specification as Record<string, unknown>, injection)
 
+  // Excluded operations are stripped from the client spec too (forcing inline
+  // for URL specs), so the interactive client's own navigation can't leak
+  // them. Strip a clone: the input `specification` may be a caller-owned
+  // object also served elsewhere (e.g. `/openapi.json`), which must keep the
+  // excluded operations.
+  const clientSpecification = (
+    excluded.length > 0 ? structuredClone(specification) : specification
+  ) as Record<string, unknown>
+  stripOperations(clientSpecification, excluded)
+
   const shouldInlineClientSpec =
-    injections.length > 0 || (isUrl && shouldNormalizeClientServers(document, servers))
-  if (shouldInlineClientSpec) setClientServers(specification as Record<string, unknown>, servers)
+    injections.length > 0 ||
+    excluded.length > 0 ||
+    (isUrl && shouldNormalizeClientServers(document, servers))
+  if (shouldInlineClientSpec) setClientServers(clientSpecification, servers)
 
   const client =
-    isUrl && !shouldInlineClientSpec
-      ? { url: spec as string }
-      : { content: specification as Record<string, unknown> }
+    isUrl && !shouldInlineClientSpec ? { url: spec as string } : { content: clientSpecification }
 
   return {
     path: config.path ?? '/',
@@ -326,11 +361,39 @@ export async function parse(config: OpenApi.Config, options: parse.Options = {})
     },
     servers,
     groups,
+    ...(tagGroups ? { tagGroups } : {}),
     traits: buildTraits(document),
     securitySchemes,
   }
 }
 
+/**
+ * Resolves `x-tagGroups` entries against the built categories. Tags that don't
+ * resolve to a rendered category are dropped; a category claimed by multiple
+ * sections stays with the first (pages are per-category, so one sidebar home).
+ * Returns `undefined` when nothing resolves, so the sidebar stays flat.
+ */
+function buildTagGroups(document: Document, groups: IrGroup[]): IrTagGroup[] | undefined {
+  const entries = document['x-tagGroups']
+  if (!entries || entries.length === 0) return undefined
+
+  const idByName = new Map(groups.map((group) => [group.name, group.id]))
+  const claimed = new Set<string>()
+  const tagGroups: IrTagGroup[] = []
+  for (const entry of entries) {
+    if (!entry?.name) continue
+    const groupIds: string[] = []
+    for (const tag of entry.tags ?? []) {
+      const id = idByName.get(tag)
+      if (!id || claimed.has(id)) continue
+      claimed.add(id)
+      groupIds.push(id)
+    }
+    if (groupIds.length > 0) tagGroups.push({ name: entry.name, groupIds })
+  }
+  return tagGroups.length > 0 ? tagGroups : undefined
+}
+
 /**
  * Adds named JSON-RPC request examples to a host operation's
  * `application/json` request body in the (upgraded) spec document. Scalar
@@ -358,6 +421,78 @@ function injectRpcExamples(specification: Record<string, unknown>, injection: Rp
   media['examples'] = { ...(media['examples'] as Record<string, unknown>), ...injection.examples }
 }
 
+/** An operation removed by `exclude`, identified for stripping from the client spec. */
+type ExcludedOperation = { method: string; path: string; isWebhook: boolean }
+
+/**
+ * Applies the config `exclude` list: a name matching an `x-tagGroups` section
+ * excludes every category it claims; a name matching a category (tag) excludes
+ * that category. Excluded categories are dropped from `groups`, pruned from
+ * `tagGroups` (emptied sections are removed), and their operations returned
+ * for stripping from the client spec. Unmatched names are ignored.
+ */
+function applyExclusions(
+  groups: IrGroup[],
+  tagGroups: IrTagGroup[] | undefined,
+  exclude: readonly string[] | undefined,
+): { groups: IrGroup[]; tagGroups: IrTagGroup[] | undefined; excluded: ExcludedOperation[] } {
+  const names = new Set(exclude ?? [])
+  if (names.size === 0) return { groups, tagGroups, excluded: [] }
+
+  const excludedIds = new Set<string>()
+  for (const tagGroup of tagGroups ?? [])
+    if (names.has(tagGroup.name)) for (const id of tagGroup.groupIds) excludedIds.add(id)
+  for (const group of groups) if (names.has(group.name)) excludedIds.add(group.id)
+  if (excludedIds.size === 0) return { groups, tagGroups, excluded: [] }
+
+  const excluded = groups
+    .filter((group) => excludedIds.has(group.id))
+    .flatMap((group) =>
+      group.operations.map((operation) => ({
+        method: operation.method,
+        path: operation.path,
+        isWebhook: operation.isWebhook ?? false,
+      })),
+    )
+  const prunedTagGroups = (tagGroups ?? [])
+    .filter((tagGroup) => !names.has(tagGroup.name))
+    .map((tagGroup) => ({
+      ...tagGroup,
+      groupIds: tagGroup.groupIds.filter((id) => !excludedIds.has(id)),
+    }))
+    .filter((tagGroup) => tagGroup.groupIds.length > 0)
+  return {
+    groups: groups.filter((group) => !excludedIds.has(group.id)),
+    tagGroups: prunedTagGroups.length > 0 ? prunedTagGroups : undefined,
+    excluded,
+  }
+}
+
+/**
+ * Deletes excluded operations from the (upgraded) spec handed to the
+ * interactive client. A path item left with no methods is removed entirely.
+ */
+function stripOperations(
+  specification: Record<string, unknown>,
+  excluded: ExcludedOperation[],
+): void {
+  // JSON-RPC operations expanded from one host operation share its path+method.
+  const seen = new Set<string>()
+  for (const operation of excluded) {
+    const key = `${operation.isWebhook}:${operation.method}:${operation.path}`
+    if (seen.has(key)) continue
+    seen.add(key)
+
+    const target = specification[operation.isWebhook ? 'webhooks' : 'paths'] as
+      | Record<string, Record<string, unknown>>
+      | undefined
+    const item = target?.[operation.path]
+    if (!item || typeof item !== 'object') continue
+    delete item[operation.method.toLowerCase()]
+    if (!methods.some((method) => method in item)) delete target[operation.path]
+  }
+}
+
 /** Builds doc-only "trait" pages from tags marked `x-traitTag: true`. */
 function buildTraits(document: Document): IrTrait[] {
   const slugger = new GithubSlugger()

package/src/internal/openapi/registry.ts

@@ -53,8 +53,9 @@ export function sidebars(
     const entry = config?.openapi?.find((entry) => entry.path === path)
     const collapsed = entry?.sidebar?.collapsed
     const intro = entry?.sidebar?.intro
+    const flatten = entry?.sidebar?.flatten
     const backLink = entry?.sidebar?.backLink ?? true
-    result[path] = { backLink, items: Sidebar.toSidebar(ir, { collapsed, intro }) }
+    result[path] = { backLink, items: Sidebar.toSidebar(ir, { collapsed, intro, flatten }) }
   }
   return result
 }

package/src/internal/openapi/sidebar.test.ts

@@ -94,6 +94,100 @@ describe('toSidebar', () => {
     expect((sidebar[1] as { collapsed: boolean }).collapsed).toBe(true)
   })
 
+  test('nests claimed groups under static section headers from tagGroups', () => {
+    const sectioned: Ir = {
+      ...ir,
+      groups: [
+        ...ir.groups,
+        {
+          id: 'platform',
+          name: 'Platform',
+          operations: [
+            {
+              id: 'listkeys',
+              method: 'GET',
+              path: '/keys',
+              summary: 'List keys',
+              parameters: [],
+              responses: [],
+            },
+          ],
+        },
+      ],
+      tagGroups: [
+        { name: 'Data API', groupIds: ['pets'] },
+        { name: 'Platform API', groupIds: ['platform'] },
+      ],
+    }
+    const sidebar = toSidebar(sectioned, { collapsed: true })
+    expect(sidebar.map((item) => item.text)).toEqual(['Introduction', 'Data API', 'Platform API'])
+    // Sections are static headers (not collapsible); nested groups keep the
+    // `collapsed` behavior.
+    const section = sidebar[1] as {
+      collapsed?: boolean
+      items: { text?: string; collapsed?: boolean }[]
+    } // prettier-ignore
+    expect(section.collapsed).toBeUndefined()
+    expect(section.items.map((item) => item.text)).toEqual(['pets'])
+    expect(section.items[0]?.collapsed).toBe(true)
+  })
+
+  test('appends groups unclaimed by tagGroups at the top level', () => {
+    const sidebar = toSidebar({
+      ...ir,
+      groups: [
+        ...ir.groups,
+        { id: 'internal', name: 'Internal', operations: ir.groups[0]?.operations ?? [] },
+      ],
+      tagGroups: [{ name: 'Data API', groupIds: ['pets'] }],
+    })
+    expect(sidebar.map((item) => item.text)).toEqual(['Introduction', 'Data API', 'Internal'])
+  })
+
+  test('flattened tag groups render their categories in place at the top level', () => {
+    const sectioned: Ir = {
+      ...ir,
+      groups: [
+        ...ir.groups,
+        {
+          id: 'platform',
+          name: 'Platform',
+          operations: [
+            {
+              id: 'listkeys',
+              method: 'GET',
+              path: '/keys',
+              summary: 'List keys',
+              parameters: [],
+              responses: [],
+            },
+          ],
+        },
+      ],
+      tagGroups: [
+        { name: 'Data API', groupIds: ['pets'] },
+        { name: 'Platform API', groupIds: ['platform'] },
+      ],
+    }
+    const sidebar = toSidebar(sectioned, { flatten: ['Data API'] })
+    // `pets` renders top-level where its section would sit; `Platform API`
+    // keeps its section header.
+    expect(sidebar.map((item) => item.text)).toEqual(['Introduction', 'pets', 'Platform API'])
+    const pets = sidebar[1] as { collapsed?: boolean }
+    const section = sidebar[2] as { collapsed?: boolean; items: { text?: string }[] }
+    expect(pets.collapsed).toBe(false)
+    expect(section.collapsed).toBeUndefined()
+    expect(section.items.map((item) => item.text)).toEqual(['Platform'])
+  })
+
+  test('ignores flatten names that match no tag group', () => {
+    const sidebar = toSidebar(
+      { ...ir, tagGroups: [{ name: 'Data API', groupIds: ['pets'] }] },
+      { flatten: ['Nope'] },
+    )
+    expect(sidebar.map((item) => item.text)).toEqual(['Introduction', 'Data API'])
+  })
+
   test('injects groupExtras after a group Overview link', () => {
     const sidebar = toSidebar(ir, {
       groupExtras: new Map([['pets', [{ text: 'Rate limits', link: '/api/rate-limits' }]]]),

package/src/internal/openapi/sidebar.ts

@@ -32,7 +32,9 @@ export function methodVariant(method: string): BadgeVariant {
  * OpenAPI IR.
  *
  * Each category is its own page; operation links are in-page anchors on that
- * page (`/api/{group}#{operation}`).
+ * page (`/api/{group}#{operation}`). When the IR carries `tagGroups`, claimed
+ * categories nest under static section headers; unclaimed ones follow at the
+ * top level so no category silently disappears.
  */
 export function toSidebar(ir: Ir, options: toSidebar.Options = {}): SidebarItem<true>[] {
   // Strip a trailing slash so a root mount (`/`) doesn't yield `//group`.
@@ -63,28 +65,48 @@ export function toSidebar(ir: Ir, options: toSidebar.Options = {}): SidebarItem<
   // active group still auto-expands at render). `Introduction` is unaffected.
   const groupCollapsed = options.collapsed ?? false
 
+  const groupItem = (group: Ir['groups'][number]): SidebarItem<true> => ({
+    text: group.name,
+    collapsed: groupCollapsed,
+    items: [
+      // An "Overview" entry links to the category itself; the top-level item
+      // is a non-link header so its label doesn't compete with the operations.
+      { text: 'Overview', link: groupLink(group.id) },
+      ...((groupExtras.get(group.id) ?? []) as SidebarItem<true>[]),
+      ...group.operations.map((operation) => ({
+        text: operation.summary || `${operation.method} ${operation.path}`,
+        link: operationLink(operation, group.id),
+        // Webhooks are inbound deliveries, not callable endpoints — show a
+        // webhook glyph instead of the HTTP method (which is always POST).
+        badge:
+          operation.isWebhook && webhookIcon
+            ? { icon: webhookIcon, variant: methodVariant(operation.method) }
+            : { text: operation.method, variant: methodVariant(operation.method) },
+      })),
+    ],
+  })
+
+  const tagGroups = ir.tagGroups ?? []
+  if (tagGroups.length === 0) return [introduction, ...ir.groups.map(groupItem)]
+
+  // `x-tagGroups` sections render as static headers (no `collapsed`, so not
+  // collapsible); the per-category `collapsed` behavior applies unchanged.
+  // Sections named in `flatten` spread their categories in place instead.
+  const flatten = new Set(options.flatten ?? [])
+  const groupById = new Map(ir.groups.map((group) => [group.id, group]))
+  const claimed = new Set(tagGroups.flatMap((tagGroup) => tagGroup.groupIds))
+  const sections = tagGroups.flatMap((tagGroup) => {
+    const items = tagGroup.groupIds.flatMap((id) => {
+      const group = groupById.get(id)
+      return group ? [groupItem(group)] : []
+    })
+    if (flatten.has(tagGroup.name)) return items
+    return [{ text: tagGroup.name, items }]
+  })
   return [
     introduction,
-    ...ir.groups.map((group) => ({
-      text: group.name,
-      collapsed: groupCollapsed,
-      items: [
-        // An "Overview" entry links to the category itself; the top-level item
-        // is a non-link header so its label doesn't compete with the operations.
-        { text: 'Overview', link: groupLink(group.id) },
-        ...((groupExtras.get(group.id) ?? []) as SidebarItem<true>[]),
-        ...group.operations.map((operation) => ({
-          text: operation.summary || `${operation.method} ${operation.path}`,
-          link: operationLink(operation, group.id),
-          // Webhooks are inbound deliveries, not callable endpoints — show a
-          // webhook glyph instead of the HTTP method (which is always POST).
-          badge:
-            operation.isWebhook && webhookIcon
-              ? { icon: webhookIcon, variant: methodVariant(operation.method) }
-              : { text: operation.method, variant: methodVariant(operation.method) },
-        })),
-      ],
-    })),
+    ...sections,
+    ...ir.groups.filter((group) => !claimed.has(group.id)).map(groupItem),
   ]
 }
 
@@ -99,5 +121,10 @@ export declare namespace toSidebar {
      * auto-expands). `Introduction` is unaffected. @default false
      */
     collapsed?: boolean | undefined
+    /**
+     * Names of `x-tagGroups` sections whose categories render as top-level
+     * items (in place) instead of nesting under the section header.
+     */
+    flatten?: readonly string[] | undefined
   }
 }

package/src/server/openapi/state.ts

@@ -57,6 +57,7 @@ export async function prepare(
   const bottom = config.sidebar?.bottom ?? []
   const intro = [...traitIntro, ...(config.sidebar?.intro ?? [])]
   const collapsed = config.sidebar?.collapsed ?? false
+  const flatten = config.sidebar?.flatten
   const newGroups = [...extraGroups].map(([name, items]) => ({
     text: name,
     collapsed,
@@ -64,7 +65,7 @@ export async function prepare(
   }))
   const sidebar = [
     ...top,
-    ...Sidebar.toSidebar(ir, { intro, groupExtras, collapsed }),
+    ...Sidebar.toSidebar(ir, { intro, groupExtras, collapsed, flatten }),
     ...newGroups,
     ...bottom,
   ]