@scalar/workspace-store 0.68.2 → 0.68.4

package/dist/helpers/use-external-examples.js

@@ -10,8 +10,9 @@ export const useExampleVisibility = (target) => {
         observer?.disconnect();
         visible.value = false;
         const node = element && ('$el' in element ? element.$el : element);
-        if (typeof Element === 'undefined' || !(node instanceof Element))
+        if (typeof Element === 'undefined' || !(node instanceof Element)) {
             return;
+        }
         if (typeof IntersectionObserver === 'undefined') {
             visible.value = true;
             return;
@@ -32,22 +33,26 @@ export const useExternalExamples = (examples, enabled = () => true, resolver) =>
         .filter((example) => example !== undefined && example.value === undefined && !!example.externalValue)
         .map((example) => getResolver()(example)));
     watchEffect(() => {
-        if (!enabled())
+        if (!enabled()) {
             return;
+        }
         for (const state of states.value) {
-            if (state.status === 'idle')
+            if (state.status === 'idle') {
                 void state.load();
+            }
         }
     });
     return {
         pending: computed(() => states.value.some((state) => state.status !== 'loaded')),
         failed: computed(() => states.value.some((state) => state.status === 'error')),
         resolve: (example) => {
-            if (!example || example.value !== undefined || !example.externalValue)
+            if (!example || example.value !== undefined || !example.externalValue) {
                 return example;
+            }
             const state = getResolver()(example);
-            if (state.status !== 'loaded')
+            if (state.status !== 'loaded') {
                 return example;
+            }
             // A 3.2 example can pair structured data with external wire text. Keep both in the
             // resolved view so raw consumers display the download and form editors retain the data.
             if (example.dataValue !== undefined && state.serializedValue !== undefined) {

package/dist/mutators/auth.d.ts

@@ -1,3 +1,4 @@
+import type { AuthenticationConfiguration } from '@scalar/types/api-reference';
 import type { WorkspaceStore } from '../client.js';
 import type { AuthEvents } from '../events/definitions/auth.js';
 import type { WorkspaceDocument } from '../schemas.js';
@@ -155,7 +156,7 @@ export declare const authMutatorsFactory: ({ document, store, }: {
 }) => {
     updateSelectedSecuritySchemes: (payload: AuthEvents["auth:update:selected-security-schemes"]) => Promise<void>;
     clearSelectedSecuritySchemes: (payload: AuthEvents["auth:clear:selected-security-schemes"]) => void;
-    updateSecurityScheme: (payload: AuthEvents["auth:update:security-scheme"]) => SecuritySchemeObject | undefined;
+    updateSecurityScheme: (data: AuthEvents["auth:update:security-scheme"], configuredSchemes?: AuthenticationConfiguration["securitySchemes"]) => SecuritySchemeObject | undefined;
     updateSecuritySchemeSecrets: (payload: AuthEvents["auth:update:security-scheme-secrets"]) => void;
     resetSecuritySchemeSecret: (payload: AuthEvents["auth:reset:security-scheme-secret"]) => void;
     clearSecuritySchemeSecrets: (payload: AuthEvents["auth:clear:security-scheme-secrets"]) => void;

package/dist/mutators/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/mutators/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAU3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAuC/F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,UAAU,CAAC,uCAAuC,CAAC,kBAgFhG,CAAA;AAwBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,UAAU,CAAC,6BAA6B,CAAC,qCAwB7D,CAAA;AAqED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,iBAAiB,UAAU,CAAC,0BAA0B,CAAC,SAgDxD,CAAA;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,6CAA6C,UAAU,CAAC,6BAA6B,CAAC,SA0EvF,CAAA;AAqED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,0DAA0D,UAAU,CAAC,oBAAoB,CAAC,SA2D3F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,2BAA2B,UAAU,CAAC,oBAAoB,CAAC,SAwB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,UAAU,CAAC,6BAA6B,CAAC,SAoFrD,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,sBAGjC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;6CAE4C,UAAU,CAAC,uCAAuC,CAAC;4CAEpD,UAAU,CAAC,sCAAsC,CAAC;oCAE1D,UAAU,CAAC,6BAA6B,CAAC;2CAElC,UAAU,CAAC,qCAAqC,CAAC;yCAEnD,UAAU,CAAC,mCAAmC,CAAC;0CAE9C,UAAU,CAAC,oCAAoC,CAAC;qCAErD,UAAU,CAAC,0BAA0B,CAAC;oCAEvC,UAAU,CAAC,6BAA6B,CAAC;2BAElD,UAAU,CAAC,oBAAoB,CAAC;2BAChC,UAAU,CAAC,oBAAoB,CAAC;oCACvB,UAAU,CAAC,6BAA6B,CAAC;CAG5E,CAAA"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/mutators/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAW3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD,OAAO,KAAK,EAAgB,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAuC/F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,UAAU,CAAC,uCAAuC,CAAC,kBAgFhG,CAAA;AAwBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,UAAU,CAAC,6BAA6B,CAAC,qCAwB7D,CAAA;AAqED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,iBAAiB,UAAU,CAAC,0BAA0B,CAAC,SAgDxD,CAAA;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,6CAA6C,UAAU,CAAC,6BAA6B,CAAC,SA0EvF,CAAA;AAqED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,0DAA0D,UAAU,CAAC,oBAAoB,CAAC,SA2D3F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,2BAA2B,UAAU,CAAC,oBAAoB,CAAC,SAwB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,UAAU,CAAC,6BAA6B,CAAC,SAsFrD,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,sBAGjC;IACD,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;6CAE4C,UAAU,CAAC,uCAAuC,CAAC;4CAEpD,UAAU,CAAC,sCAAsC,CAAC;iCAGlF,UAAU,CAAC,6BAA6B,CAAC,sBAC5B,2BAA2B,CAAC,iBAAiB,CAAC,KAChE,oBAAoB,GAAG,SAAS;2CAgCI,UAAU,CAAC,qCAAqC,CAAC;yCAEnD,UAAU,CAAC,mCAAmC,CAAC;0CAE9C,UAAU,CAAC,oCAAoC,CAAC;qCAErD,UAAU,CAAC,0BAA0B,CAAC;oCAEvC,UAAU,CAAC,6BAA6B,CAAC;2BAElD,UAAU,CAAC,oBAAoB,CAAC;2BAChC,UAAU,CAAC,oBAAoB,CAAC;oCACvB,UAAU,CAAC,6BAA6B,CAAC;CAG5E,CAAA"}

package/dist/mutators/auth.js

@@ -7,6 +7,7 @@ import { isNonOptionalSecurityRequirement } from '../helpers/is-non-optional-sec
 import { mergeObjects } from '../helpers/merge-object.js';
 import { unpackProxyObject } from '../helpers/unpack-proxy.js';
 import { getSelectedSecurity } from '../request-example/context/security/get-selected-security.js';
+import { usesApiKeyNameOverride } from '../request-example/context/security/uses-api-key-name-override.js';
 import { isAsyncApiDocument, isOpenApiDocument } from '../schemas/type-guards.js';
 /**
  * The auth-store key for a document's selection and secret state.
@@ -590,8 +591,9 @@ export const deleteSecurityScheme = (store, document, { names }) => {
         forEachPathItemOperation(pathItemRef, (method, operationRef) => {
             // Get mutable reference for the operation (could resolve $ref proxies)
             const resolvedOperation = getResolvedRef(operationRef);
-            if (!resolvedOperation)
+            if (!resolvedOperation) {
                 return;
+            }
             // Remove from operation-level security array
             if ('security' in resolvedOperation && resolvedOperation['security']) {
                 resolvedOperation['security'] = filterSecuritySchemes(resolvedOperation['security']);
@@ -616,7 +618,35 @@ export const authMutatorsFactory = ({ document, store, }) => {
     return {
         updateSelectedSecuritySchemes: (payload) => updateSelectedSecuritySchemes(store, document, payload),
         clearSelectedSecuritySchemes: (payload) => clearSelectedSecuritySchemes(store, document, payload),
-        updateSecurityScheme: (payload) => updateSecurityScheme(document, payload),
+        updateSecurityScheme: (data, configuredSchemes = {}) => {
+            const { payload, name } = data;
+            if (payload.type !== 'apiKey' || payload.name === undefined) {
+                return updateSecurityScheme(document, data);
+            }
+            const configured = Object.hasOwn(configuredSchemes, name) ? configuredSchemes[name] : undefined;
+            const documentScheme = getResolvedRef(getDocumentSecuritySchemes(document)[name]);
+            if (!configured || !usesApiKeyNameOverride(configured, documentScheme)) {
+                // Document-backed names must remain available to export and synchronization.
+                const updated = updateSecurityScheme(document, data);
+                const documentName = getAuthDocumentName(document);
+                const secrets = documentName ? store?.auth.getAuthSecrets(documentName, name) : undefined;
+                // Only release an existing override, so typing a name does not write secrets on every keystroke.
+                if (updated && secrets?.type === 'apiKey' && secrets.name !== undefined) {
+                    updateSecuritySchemeSecrets(store, document, { name, payload: { type: 'apiKey', name: undefined } });
+                }
+                return updated;
+            }
+            const defaultName = ('name' in configured ? configured.name : undefined) ??
+                (documentScheme && typeof documentScheme === 'object' && 'name' in documentScheme
+                    ? documentScheme.name
+                    : undefined);
+            // Restoring the default releases the override without clearing the API key token.
+            updateSecuritySchemeSecrets(store, document, {
+                name,
+                payload: { type: 'apiKey', name: payload.name === defaultName ? undefined : payload.name },
+            });
+            return undefined;
+        },
         updateSecuritySchemeSecrets: (payload) => updateSecuritySchemeSecrets(store, document, payload),
         resetSecuritySchemeSecret: (payload) => resetSecuritySchemeSecret(store, document, payload),
         clearSecuritySchemeSecrets: (payload) => clearSecuritySchemeSecrets(store, document, payload),

package/dist/mutators/index.d.ts

@@ -66,7 +66,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
         auth: {
             updateSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:selected-security-schemes"]) => Promise<void>;
             clearSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:selected-security-schemes"]) => void;
-            updateSecurityScheme: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"]) => import("../schemas/v3.2/strict/security-scheme.js").SecuritySchemeObject | undefined;
+            updateSecurityScheme: (data: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"], configuredSchemes?: import("@scalar/types/api-reference").AuthenticationConfiguration["securitySchemes"]) => import("../schemas/v3.2/strict/security-scheme.js").SecuritySchemeObject | undefined;
             updateSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme-secrets"]) => void;
             resetSecuritySchemeSecret: (payload: import("../events/definitions/auth.js").AuthEvents["auth:reset:security-scheme-secret"]) => void;
             clearSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:security-scheme-secrets"]) => void;
@@ -158,7 +158,7 @@ export declare function generateClientMutators(store: WorkspaceStore | null): {
         auth: {
             updateSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:selected-security-schemes"]) => Promise<void>;
             clearSelectedSecuritySchemes: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:selected-security-schemes"]) => void;
-            updateSecurityScheme: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"]) => import("../schemas/v3.2/strict/security-scheme.js").SecuritySchemeObject | undefined;
+            updateSecurityScheme: (data: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme"], configuredSchemes?: import("@scalar/types/api-reference").AuthenticationConfiguration["securitySchemes"]) => import("../schemas/v3.2/strict/security-scheme.js").SecuritySchemeObject | undefined;
             updateSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:update:security-scheme-secrets"]) => void;
             resetSecuritySchemeSecret: (payload: import("../events/definitions/auth.js").AuthEvents["auth:reset:security-scheme-secret"]) => void;
             clearSecuritySchemeSecrets: (payload: import("../events/definitions/auth.js").AuthEvents["auth:clear:security-scheme-secrets"]) => void;

package/dist/mutators/operation/helpers/har-to-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"har-to-operation.d.ts","sourceRoot":"","sources":["../../../../src/mutators/operation/helpers/har-to-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AAKpH,KAAK,mBAAmB,GAAG;IACzB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,2DAK5B,mBAAmB,KAAG,eA0HxB,CAAA"}
+{"version":3,"file":"har-to-operation.d.ts","sourceRoot":"","sources":["../../../../src/mutators/operation/helpers/har-to-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,8DAA8D,CAAA;AAKpH,KAAK,mBAAmB,GAAG;IACzB,6BAA6B;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAyBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,2DAK5B,mBAAmB,KAAG,eA4HxB,CAAA"}

package/dist/mutators/operation/helpers/har-to-operation.js

@@ -98,8 +98,9 @@ export const harToOperation = ({ harRequest, exampleKey, baseOperation = {}, pat
         }
         // Resolve the request body in case it is a reference
         const requestBody = getResolvedRef(baseOperation.requestBody);
-        if (!requestBody)
+        if (!requestBody) {
             return baseOperation;
+        }
         // Ensure the content type exists in the requestBody
         if (!requestBody.content[mimeType]) {
             requestBody.content[mimeType] = {
@@ -150,8 +151,9 @@ const setParameterDisabled = (param, exampleKey, disabled) => {
         return;
     }
     const example = getResolvedRef(param.examples[exampleKey]);
-    if (example)
+    if (example) {
         example['x-disabled'] = disabled;
+    }
 };
 /**
  * Finds an existing parameter in the parameters array or creates a new one.

package/dist/mutators/operation/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAarE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SA0DX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,uBAAuB,CAAC,SAsB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,mEAAmE,eAAe,CAAC,6BAA6B,CAAC,KAChH,IAkGF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAkDlG,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,+DAA+D,eAAe,CAAC,0BAA0B,CAAC,SAwE3G,CAAA"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/operation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAarE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAGlD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,cAAc,GAAG,IAAI,EACrC,SAAS,eAAe,CAAC,4BAA4B,CAAC,KACrD,MAAM,GAAG,SA0DX,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,GAAG,IAAI,EAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,mBAAmB,eAAe,CAAC,uBAAuB,CAAC,SAsB5D,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,iBAAiB,GAAG,IAAI,EAClC,OAAO,cAAc,GAAG,IAAI,EAC5B,mEAAmE,eAAe,CAAC,6BAA6B,CAAC,KAChH,IAkGF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,cAAc,GAAG,IAAI,EAChC,wBAAwB,eAAe,CAAC,4BAA4B,CAAC,SAgBtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,WAAW,cAAc,GAAG,IAAI,EAChC,uDAAuD,eAAe,CAAC,gCAAgC,CAAC,SAuBzG,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,sDAAsD,eAAe,CAAC,0BAA0B,CAAC,SAoDlG,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,cAAc,GAAG,IAAI,EAChC,+DAA+D,eAAe,CAAC,0BAA0B,CAAC,SA0E3G,CAAA"}

package/dist/mutators/operation/operation.js

@@ -274,8 +274,9 @@ export const deleteOperationExample = (workspace, { meta: { path, method, exampl
     // Remove the example from all operation parameters
     operation.parameters?.forEach((parameter) => {
         const resolvedParameter = getResolvedRef(parameter);
-        if (!resolvedParameter)
+        if (!resolvedParameter) {
             return;
+        }
         // Remove from content-level examples (if parameter uses content)
         if ('content' in resolvedParameter && resolvedParameter.content) {
             Object.values(resolvedParameter.content).forEach((mediaType) => {
@@ -325,8 +326,9 @@ export const renameOperationExample = (workspace, { meta: { path, method, exampl
     const records = [];
     operation.parameters?.forEach((parameter) => {
         const resolvedParameter = getResolvedRef(parameter);
-        if (!resolvedParameter)
+        if (!resolvedParameter) {
             return;
+        }
         if ('examples' in resolvedParameter && resolvedParameter.examples) {
             records.push(resolvedParameter.examples);
         }

package/dist/mutators/operation/parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAMrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAmClD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,eAAe,CAAC,4BAA4B,CAAC,SAyG1F,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,GACzC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uCAAuC,eAAe,CAAC,mCAAmC,CAAC,SA8C5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,eAAe,CAAC,4BAA4B,CAAC,SAkC3E,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gBAAgB,eAAe,CAAC,iCAAiC,CAAC,SAgBnE,CAAA"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/mutators/operation/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAOrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAmClD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,4CAA4C,eAAe,CAAC,4BAA4B,CAAC,SA4H1F,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,8BAA8B,GACzC,UAAU,iBAAiB,GAAG,IAAI,EAClC,uCAAuC,eAAe,CAAC,mCAAmC,CAAC,SA8C5F,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,iBAAiB,GAAG,IAAI,EAClC,6BAA6B,eAAe,CAAC,4BAA4B,CAAC,SAkC3E,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,UAAU,iBAAiB,GAAG,IAAI,EAClC,gBAAgB,eAAe,CAAC,iCAAiC,CAAC,SAgBnE,CAAA"}

package/dist/mutators/operation/parameters.js

@@ -3,6 +3,7 @@ import { getParameterExample } from '../../helpers/get-parameter-example.js';
 import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
 import { getQuerystringParameter, serializeQuerystringParameter } from '../../helpers/querystring-parameter.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
+import { isParamDisabled } from '../../request-example/builder/header/is-param-disabled.js';
 import { isOpenApiDocument } from '../../schemas/type-guards.js';
 import { isContentTypeParameterObject } from '../../schemas/v3.2/strict/type-guards.js';
 const getPathItemsForParameterMutation = (pathItemRef) => {
@@ -47,6 +48,7 @@ export const upsertOperationParameter = (document, { meta, type, payload, origin
         const preserveQuerystringValue = querystring && payload.value === serializeQuerystringParameter(querystring);
         const param = originalParameter;
         const selected = getParameterExample(param, meta.exampleKey);
+        const inheritedDisabled = isParamDisabled(param, selected.example);
         const target = param.in !== 'querystring' && !selected.serialized && isContentTypeParameterObject(param)
             ? Object.values(param.content ?? {})[0]
             : param;
@@ -117,7 +119,27 @@ export const upsertOperationParameter = (document, { meta, type, payload, origin
                 example.value = payload.value;
             }
         }
-        example['x-disabled'] = payload.isDisabled;
+        if (payload.propertyState) {
+            // Freeze the inherited state before changing values: adding the first populated field
+            // must not implicitly enable every untouched sibling.
+            const states = { '[]': inheritedDisabled, ...example['x-scalar-disabled-properties'] };
+            const { path, previousPath, isDisabled } = payload.propertyState;
+            if (previousPath) {
+                delete states[JSON.stringify(previousPath)];
+            }
+            const key = JSON.stringify(path);
+            if (isDisabled === undefined) {
+                delete states[key];
+            }
+            else {
+                states[key] = isDisabled;
+            }
+            example['x-scalar-disabled-properties'] = states;
+        }
+        else {
+            example['x-disabled'] = payload.isDisabled;
+            delete example['x-scalar-disabled-properties'];
+        }
         return;
     }
     // We are adding a new parameter

package/dist/mutators/tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/mutators/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AASzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAe3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,cAAc,CAAC,SAqEvF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAiC/F,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE;yBAErD,SAAS,CAAC,gBAAgB,CAAC;uBAC7B,SAAS,CAAC,cAAc,CAAC;yBACvB,SAAS,CAAC,gBAAgB,CAAC;CAEnD,CAAA"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/mutators/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AASzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAe3F,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,cAAc,CAAC,SAqEvF,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,GAAG,IAAI,EAAE,SAAS,SAAS,CAAC,gBAAgB,CAAC,SAqC/F,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,WAAW;IAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE;yBAErD,SAAS,CAAC,gBAAgB,CAAC;uBAC7B,SAAS,CAAC,cAAc,CAAC;yBACvB,SAAS,CAAC,gBAAgB,CAAC;CAEnD,CAAA"}

package/dist/mutators/tag.js

@@ -112,8 +112,9 @@ export const deleteTag = (workspace, payload) => {
     Object.values(document.paths ?? {}).forEach((pathItemRef) => {
         forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
             const resolvedOperation = getResolvedRef(operationRef);
-            if (!resolvedOperation)
+            if (!resolvedOperation) {
                 return;
+            }
             if ('tags' in resolvedOperation) {
                 const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
                 resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
@@ -124,8 +125,9 @@ export const deleteTag = (workspace, payload) => {
     Object.values(document.webhooks ?? {}).forEach((pathItemRef) => {
         forEachPathItemOperation(pathItemRef, (_method, operationRef) => {
             const resolvedOperation = getResolvedRef(operationRef);
-            if (!resolvedOperation)
+            if (!resolvedOperation) {
                 return;
+            }
             const plainTags = unpackProxyObject(resolvedOperation.tags, { depth: 1 });
             resolvedOperation.tags = plainTags?.filter((tag) => tag !== payload.name);
         });

package/dist/navigation/get-navigation-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,4BAA4B,EAAgC,MAAM,6BAA6B,CAAA;AAE7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAe7D,MAAM,MAAM,iBAAiB,GACzB,OAAO,CACL,IAAI,CACF,4BAA4B,EAC1B,qBAAqB,GACrB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GACD,SAAS,CAAA;AAEb;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,UAAU,iBAAiB,KAAG,mBAyJxF,CAAA"}
+{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,4BAA4B,EAAgC,MAAM,6BAA6B,CAAA;AAE7G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAe7D,MAAM,MAAM,iBAAiB,GACzB,OAAO,CACL,IAAI,CACF,4BAA4B,EAC1B,qBAAqB,GACrB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,YAAY,GACZ,YAAY,GACZ,oBAAoB,GACpB,sBAAsB,CACzB,CACF,GACD,SAAS,CAAA;AAEb;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,UAAU,iBAAiB,KAAG,mBA6JxF,CAAA"}

package/dist/navigation/get-navigation-options.js

@@ -6,11 +6,12 @@ import { DEFAULT_MODELS_SECTION_LABEL } from '@scalar/types/api-reference';
  * Extension methods retain exact case because HTTP method tokens are case-sensitive.
  * Normalizing COPY and copy would collapse distinct operations onto the same anchor.
  */
-const getMethodId = (method) => isHttpMethod(method)
-    ? method === method.toLowerCase()
-        ? method.toUpperCase()
-        : `additionalOperations/${method}`
-    : method;
+const getMethodId = (method) => {
+    if (!isHttpMethod(method)) {
+        return method;
+    }
+    return method === method.toLowerCase() ? method.toUpperCase() : `additionalOperations/${method}`;
+};
 /**
  * Returns options for traversing an OpenAPI document, allowing customization of
  * how IDs and slugs are generated for tags, headings, models, operations, and webhooks.
@@ -86,6 +87,9 @@ export const getNavigationOptions = (documentName, options) => {
         }
         // -------- Default webhook id generation logic --------
         if (props.type === 'webhook') {
+            if (!props.name && props.method === undefined) {
+                return `${documentId}/webhooks`;
+            }
             const prefixTag = props.parentTag
                 ? `${generateId({
                     type: 'tag',

package/dist/navigation/helpers/get-tag-external-docs.d.ts

@@ -0,0 +1,4 @@
+import type { ExternalDocumentationObject, TagObject } from '../../schemas/v3.2/strict/openapi-document.js';
+/** Navigation is cloned and persisted, so keep documentation as plain display metadata. */
+export declare const getTagExternalDocs: (tag: TagObject) => ExternalDocumentationObject | undefined;
+//# sourceMappingURL=get-tag-external-docs.d.ts.map

package/dist/navigation/helpers/get-tag-external-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tag-external-docs.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/get-tag-external-docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAA;AAEpG,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,GAAI,KAAK,SAAS,KAAG,2BAA2B,GAAG,SAGjF,CAAA"}

package/dist/navigation/helpers/get-tag-external-docs.js

@@ -0,0 +1,6 @@
+import { getResolvedRef } from '../../helpers/get-resolved-ref.js';
+/** Navigation is cloned and persisted, so keep documentation as plain display metadata. */
+export const getTagExternalDocs = (tag) => {
+    const documentation = getResolvedRef(tag.externalDocs);
+    return documentation ? { url: documentation.url, description: documentation.description } : undefined;
+};

package/dist/navigation/helpers/traverse-asyncapi-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-asyncapi-document.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-asyncapi-document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,gBAAgB,EAA2B,MAAM,4BAA4B,CAAA;AAKlH,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,qCAAqC,CAAA;AAOlG,OAAO,KAAK,EAKV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAM7B,oFAAoF;AACpF,KAAK,wCAAwC,GAAG,gBAAgB,GAAG;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAiiBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,EACpB,UAAU,wCAAwC,EAClD,UAAU,iBAAiB,KAC1B,iBA+HF,CAAA"}
+{"version":3,"file":"traverse-asyncapi-document.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-asyncapi-document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,gBAAgB,EAA2B,MAAM,4BAA4B,CAAA;AAOlH,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,qCAAqC,CAAA;AAQlG,OAAO,KAAK,EAKV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAM7B,oFAAoF;AACpF,KAAK,wCAAwC,GAAG,gBAAgB,GAAG;IACjE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAqjBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,EACpB,UAAU,wCAAwC,EAClD,UAAU,iBAAiB,KAC1B,iBAsJF,CAAA"}

package/dist/navigation/helpers/traverse-asyncapi-document.js

@@ -1,10 +1,13 @@
 import { sortByOrder } from '@scalar/helpers/array/sort-by-order';
 import { objectKeys } from '@scalar/helpers/object/object-keys';
-import { getResolvedRef, mergeSiblingReferences } from '../../helpers/get-resolved-ref.js';
+import { resolveOperationWithTraits } from '../../channel-example/resolve-operation-with-traits.js';
+import { getNameFromRef } from '../../helpers/get-name-from-ref.js';
+import { getResolvedAsyncApiRef } from '../../helpers/get-resolved-async-api-ref.js';
 import { isHidden } from '../../helpers/is-hidden.js';
 import { unpackProxyObject } from '../../helpers/unpack-proxy.js';
 import { getNavigationOptions } from '../../navigation/get-navigation-options.js';
 import { getTag } from '../../navigation/helpers/get-tag.js';
+import { getTagExternalDocs } from '../../navigation/helpers/get-tag-external-docs.js';
 import { traverseDescription } from '../../navigation/helpers/traverse-description.js';
 import { traverseSchemas } from '../../navigation/helpers/traverse-schemas.js';
 /**
@@ -40,7 +43,7 @@ const getMessageTitle = (message, messageName) => pickNonEmpty(message.title, me
 /**
  * Parses a channel JSON pointer (`#/channels/<name>`) into the key used in `document.channels`.
  */
-const getChannelNameFromRef = (ref) => ref.match(/^#\/channels\/([^/]+)$/)?.[1];
+const getChannelNameFromRef = (ref) => getNameFromRef(ref, ['channels']);
 /**
  * Resolves the channel referenced by an operation.
  *
@@ -61,10 +64,8 @@ const resolveOperationChannel = (document, operation) => {
     if (!channelEntry) {
         return undefined;
     }
-    return {
-        channelName,
-        channel: getResolvedRef(channelEntry, mergeSiblingReferences),
-    };
+    const channel = getResolvedAsyncApiRef(channelEntry);
+    return channel ? { channelName, channel } : undefined;
 };
 /**
  * Resolves which channel message names an operation references.
@@ -81,19 +82,16 @@ const resolveOperationMessageNames = (operation, channel, channelName) => {
     if (operation.messages.length === 0) {
         return [];
     }
-    const channelScopePrefix = `#/channels/${channelName}/messages/`;
     const names = new Set();
     for (const messageRef of operation.messages) {
         if (!('$ref' in messageRef)) {
             continue;
         }
         // Common case: a channel-scoped reference like `#/channels/<name>/messages/<id>`.
-        if (messageRef.$ref.startsWith(channelScopePrefix)) {
-            const candidate = messageRef.$ref.slice(channelScopePrefix.length);
-            if (channelMessages[candidate]) {
-                names.add(candidate);
-                continue;
-            }
+        const candidate = getNameFromRef(messageRef.$ref, ['channels', channelName, 'messages']);
+        if (candidate && channelMessages[candidate]) {
+            names.add(candidate);
+            continue;
         }
         // Fallback: a channel-level message that points to the same target.
         for (const [name, entry] of Object.entries(channelMessages)) {
@@ -109,11 +107,18 @@ const resolveOperationMessageNames = (operation, channel, channelName) => {
  * used by the shared tag navigation helpers.
  */
 const toTagObject = (tag) => {
-    const resolved = getResolvedRef(tag, mergeSiblingReferences);
-    return {
-        name: resolved.name,
-        description: resolved.description,
-    };
+    const resolved = getResolvedAsyncApiRef(tag);
+    if (!resolved) {
+        return [];
+    }
+    const externalDocs = getResolvedAsyncApiRef(resolved.externalDocs);
+    return [
+        {
+            name: resolved.name,
+            ...(resolved.description !== undefined ? { description: resolved.description } : {}),
+            ...(externalDocs ? { externalDocs } : {}),
+        },
+    ];
 };
 /**
  * Sorts operation navigation entries in place using the workspace `operationsSorter` option.
@@ -137,17 +142,17 @@ const sortMessages = (entries) => {
     entries.sort((a, b) => a.title.localeCompare(b.title));
 };
 /**
- * Builds nested message entries for one operation.
+ * Builds message entries beneath a channel or operation.
  * Resolves each message ref, skips hidden messages, and sorts the result by title.
  */
-const createMessageEntries = ({ channelName, channel, operationId, messageNames, generateId, }) => {
+const createMessageEntries = ({ channelName, channel, parentId, messageNames, generateId, }) => {
     const messages = messageNames.flatMap((messageName) => {
         const messageNode = channel.messages?.[messageName];
         if (!messageNode) {
             return [];
         }
-        const message = getResolvedRef(messageNode, mergeSiblingReferences);
-        if (isHidden(message)) {
+        const message = getResolvedAsyncApiRef(messageNode);
+        if (!message || isHidden(message)) {
             return [];
         }
         return [
@@ -157,7 +162,7 @@ const createMessageEntries = ({ channelName, channel, operationId, messageNames,
                     type: 'asyncapi-message',
                     messageName,
                     channelName,
-                    parentId: operationId,
+                    parentId,
                 }),
                 title: getMessageTitle(message, messageName),
                 messageName,
@@ -185,7 +190,7 @@ const createOperationEntry = ({ operationName, operation, channel, channelName,
     const messageEntries = createMessageEntries({
         channelName,
         channel,
-        operationId,
+        parentId: operationId,
         messageNames: resolveOperationMessageNames(operation, channel, channelName),
         generateId,
     });
@@ -204,7 +209,7 @@ const createOperationEntry = ({ operationName, operation, channel, channelName,
  * Builds a channel navigation entry from a bucket and the operations to render under it.
  * The same channel may appear at the document root and under each of its channel-level tags.
  * Writes `x-scalar-order` on the source channel (when it is not a bare `$ref`) so other code can reuse the order.
- * Returns `undefined` when the channel is hidden or every requested operation was filtered out.
+ * Returns `undefined` when the channel is hidden or all its declared operations are hidden.
  */
 const createChannelEntry = ({ bucket, operationEntries, generateId, parentId, parentTag, operationsSorter, document, }) => {
     if (isHidden(bucket.channel)) {
@@ -229,15 +234,26 @@ const createChannelEntry = ({ bucket, operationEntries, generateId, parentId, pa
         return entry ? [entry] : [];
     });
     sortOperations(operations, operationsSorter);
-    if (operations.length === 0) {
+    // A channel with hidden operations must not expose their messages through the fallback.
+    if (operations.length === 0 && bucket.operations.length > 0) {
         return undefined;
     }
+    // Keep channel-only messages reachable without duplicating messages already owned by an operation.
+    const operationMessageNames = new Set(bucket.operations.flatMap(({ operation }) => resolveOperationMessageNames(operation, bucket.channel, bucket.channelName)));
+    const messages = createMessageEntries({
+        channelName: bucket.channelName,
+        channel: bucket.channel,
+        parentId: channelId,
+        messageNames: objectKeys(bucket.channel.messages ?? {}).filter((name) => !operationMessageNames.has(name)),
+        generateId,
+    });
+    const children = [...operations, ...messages];
     // Persist the rendered order back onto the source channel for downstream consumers.
     // We skip channels that are stored as references, since the order should live on the target.
     const channelNode = document.channels?.[bucket.channelName];
     if (channelNode && !('$ref' in channelNode)) {
         const orderedChannel = channelNode;
-        orderedChannel['x-scalar-order'] = operations.map((child) => child.id);
+        orderedChannel['x-scalar-order'] = children.map((child) => child.id);
     }
     return {
         type: 'asyncapi-channel',
@@ -245,7 +261,7 @@ const createChannelEntry = ({ bucket, operationEntries, generateId, parentId, pa
         title: getChannelTitle(bucket.channel, bucket.channelName),
         channelName: bucket.channelName,
         channelAddress: bucket.channelAddress,
-        children: operations,
+        children,
     };
 };
 /**
@@ -259,6 +275,7 @@ const createTagEntry = ({ tag, generateId, children, parentId, }) => {
         parentId,
         isGroup: false,
     });
+    const externalDocs = getTagExternalDocs(tag);
     const title = tag['x-displayName'] ?? tag.name ?? 'Untitled Tag';
     tag['x-scalar-order'] = children.map((child) => child.id);
     return {
@@ -267,6 +284,7 @@ const createTagEntry = ({ tag, generateId, children, parentId, }) => {
         title,
         name: tag.name || title,
         description: tag.description,
+        ...(externalDocs ? { externalDocs } : {}),
         children,
         isGroup: false,
         isWebhooks: false,
@@ -315,7 +333,7 @@ const getOrCreateChannelBucket = (channelBuckets, channelName, channel) => {
         channelName,
         channel,
         channelAddress: getChannelAddress(channelName, channel),
-        channelTags: channel.tags?.map(toTagObject) ?? [],
+        channelTags: channel.tags?.flatMap(toTagObject) ?? [],
         operations: [],
     };
     channelBuckets.set(channelName, bucket);
@@ -334,8 +352,8 @@ const collectChannelBuckets = (document) => {
         if (!channelNode) {
             continue;
         }
-        const channel = getResolvedRef(channelNode, mergeSiblingReferences);
-        if (isHidden(channel)) {
+        const channel = getResolvedAsyncApiRef(channelNode);
+        if (!channel || isHidden(channel)) {
             continue;
         }
         getOrCreateChannelBucket(channelBuckets, channelName, channel);
@@ -344,10 +362,11 @@ const collectChannelBuckets = (document) => {
         if (!operationNode) {
             continue;
         }
-        const operation = getResolvedRef(operationNode, mergeSiblingReferences);
-        if (isHidden(operation)) {
+        const resolvedOperation = getResolvedAsyncApiRef(operationNode);
+        if (!resolvedOperation) {
             continue;
         }
+        const operation = resolveOperationWithTraits(resolvedOperation);
         const resolved = resolveOperationChannel(document, operation);
         if (!resolved) {
             continue;
@@ -384,6 +403,14 @@ export const traverseAsyncApiDocument = (documentName, document, options) => {
     const channelBuckets = collectChannelBuckets(document);
     const tagsMap = new Map();
     const untaggedChannels = [];
+    // Info-level tags own their metadata and links, rather than contributing introduction links.
+    for (const tag of (document.info.tags ?? []).flatMap(toTagObject)) {
+        if (!tag.name) {
+            continue;
+        }
+        const entry = getTag({ tagsMap, name: tag.name, documentId, generateId });
+        entry.tag = tag;
+    }
     for (const bucket of channelBuckets.values()) {
         // Operation-level tags are intentionally skipped for now: every operation is rendered
         // under its channel, and only the channel's own tags drive tag grouping below.
@@ -403,7 +430,9 @@ export const traverseAsyncApiDocument = (documentName, document, options) => {
         // Channels can declare their own tags independently of any operation tags.
         for (const tag of bucket.channelTags) {
             const tagName = tag.name ?? 'Untitled Tag';
-            const { id: tagId, entries } = getTag({ tagsMap, name: tagName, documentId, generateId });
+            const tagEntry = getTag({ tagsMap, name: tagName, documentId, generateId });
+            tagEntry.tag = { ...tagEntry.tag, ...tag };
+            const { id: tagId, entries } = tagEntry;
             const alreadyRegistered = entries.some((entry) => entry.type === 'asyncapi-channel' && entry.channelName === bucket.channelName);
             if (alreadyRegistered) {
                 continue;
@@ -431,9 +460,19 @@ export const traverseAsyncApiDocument = (documentName, document, options) => {
     // typed against the OpenAPI document. We hand it the resolved `components` (so a `$ref`-only
     // wrapper still exposes its schemas) wrapped in a minimal document; the cast bridges the single
     // overlapping field, since AsyncAPI and OpenAPI documents are otherwise distinct types.
-    const components = document.components ? getResolvedRef(document.components, mergeSiblingReferences) : undefined;
+    const components = document.components ? getResolvedAsyncApiRef(document.components) : undefined;
     const untaggedModels = !hideModels && components?.schemas
-        ? traverseSchemas({ documentId, document: { components }, generateId, tagsMap })
+        ? traverseSchemas({
+            documentId,
+            document: {
+                components: {
+                    ...components,
+                    schemas: Object.fromEntries(Object.entries(components.schemas).map(([name, schema]) => [name, getResolvedAsyncApiRef(schema)])),
+                },
+            },
+            generateId,
+            tagsMap,
+        })
         : [];
     // Surface the Introduction entry plus any headings extracted from `info.description`
     // before the channel/tag entries, mirroring how OpenAPI documents are traversed.

package/dist/navigation/helpers/traverse-paths.js

@@ -30,7 +30,7 @@ const createOperationEntry = ({ ref, operation, method, path, generateId, parent
         path: path,
         parentId: parentId,
     });
-    const title = operationTitleSource === 'path' ? path : operation.summary?.trim() ? operation.summary : path;
+    const title = operationTitleSource !== 'path' && operation.summary?.trim() ? operation.summary : path;
     const isDeprecated = isDeprecatedOperation(operation);
     const examples = traverseOperationExamples(operation).map((example) => ({
         type: 'example',

package/dist/navigation/helpers/traverse-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traverse-schemas.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-schemas.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,wCAAwC,CAAA;AA2C3F;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,gDAK7B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,eAAe,EAmDlB,CAAA"}
+{"version":3,"file":"traverse-schemas.d.ts","sourceRoot":"","sources":["../../../src/navigation/helpers/traverse-schemas.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,wCAAwC,CAAA;AA2C3F;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,gDAK7B;IACD,QAAQ,EAAE,eAAe,CAAA;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC7C,UAAU,EAAE,MAAM,CAAA;CACnB,KAAG,eAAe,EAmDlB,CAAA"}