@apiboost/omnispec 1.1.0-next.5 → 1.1.0-next.6

package/dist/esm/chunks/{AsyncApiSpec-C0tdvyEP.js → AsyncApiSpec-DkQzir1h.js}

@@ -1,9 +1,9 @@
 import { jsxs, jsx, Fragment as Fragment$1 } from 'react/jsx-runtime';
-import { useCallback, Fragment, useState, useMemo } from 'react';
+import { useCallback, Fragment, useState, useMemo, useRef, useEffect } from 'react';
 import { cx, css } from '@emotion/css';
-import { a as useSpecFetcher, I as Icon, m as mq, r as resolveSchemaStyle, S as SpecType, T as ThemeProvider, L as LoadingScreen, b as SpecStatusScreen, E as ErrorMessage, N as NavTree, h as buildSidebar, C as ConfigProvider, e as DocLayout } from './useSpecFetcher-BvVfMuzf.js';
-import { M as MarkdownRenderer, T as Tabs, C as CodeBlock, t as SchemaTree, A as schemaToNodes, x as generateExample, J as ExampleSelector, d as ExpandableCard, f as MethodBar, K as buildConstraints, S as SchemaBadge, R as ReferenceLayout, a as Collapsible, D as useHashScroll, y as requestExpand, w as flattenNavItemIds, G as useScrollSpy, u as SearchBar, L as ExpandProvider, v as SpecToolbar, z as resolveDownloadLink } from './Collapsible-CPxS90KX.js';
-import { E as ErrorBoundary } from './ErrorBoundary-9pDlZFfM.js';
+import { a as useSpecFetcher, I as Icon, m as mq, r as resolveSchemaStyle, S as SpecType, T as ThemeProvider, L as LoadingScreen, b as SpecStatusScreen, E as ErrorMessage, N as NavTree, h as buildSidebar, C as ConfigProvider, e as DocLayout } from './useSpecFetcher-D1G2eiXA.js';
+import { M as MarkdownRenderer, T as Tabs, C as CodeBlock, t as SchemaTree, A as schemaToNodes, x as generateExample, J as ExampleSelector, d as ExpandableCard, f as MethodBar, K as buildConstraints, S as SchemaBadge, R as ReferenceLayout, a as Collapsible, D as useHashScroll, y as requestExpand, w as flattenNavItemIds, G as useScrollSpy, u as SearchBar, L as ExpandProvider, v as SpecToolbar, z as resolveDownloadLink } from './Collapsible-CAN3BvNV.js';
+import { E as ErrorBoundary } from './ErrorBoundary-Djn7CSf3.js';
 import { r as resolveRefs, p as parse, d as decodeJsonPointerSegment } from './ref-resolver-B0C36NuQ.js';
 import '@emotion/styled';
 import './ssrf-guard-CsZoYdEq.js';
@@ -49,6 +49,27 @@ function deriveAppliedTraitNames(traits, rawTraits) {
     return trait.name ?? trait.title ?? `trait ${i + 1}`;
   });
 }
+function resolveLocalPointer(root, ref) {
+  if (!ref.startsWith("#/")) return void 0;
+  let cur = root;
+  for (const seg of ref.slice(2).split("/")) {
+    if (cur === null || typeof cur !== "object") return void 0;
+    cur = cur[decodeJsonPointerSegment(seg)];
+  }
+  return cur;
+}
+function rawMessageTraits(rawMsg, rawApi) {
+  let msg = rawMsg;
+  const seen = /* @__PURE__ */ new Set();
+  while (msg && typeof msg === "object" && typeof msg.$ref === "string") {
+    const ref = msg.$ref;
+    if (seen.has(ref)) return void 0;
+    seen.add(ref);
+    msg = resolveLocalPointer(rawApi, ref);
+  }
+  if (!msg || typeof msg !== "object") return void 0;
+  return msg.traits;
+}
 function applyMessageTraits(msg, isV3) {
   if (!msg.traits || msg.traits.length === 0) return msg;
   if (isV3) {
@@ -91,10 +112,12 @@ async function parseAsyncApiSpec(specInput) {
   const servers = extractServers(api, raw);
   const rawApi = raw;
   const defaultContentType = api.defaultContentType;
-  const channels = isV3 ? extractChannelsV3(api, rawApi, defaultContentType) : extractChannelsV2(api, defaultContentType);
+  const channels = isV3 ? extractChannelsV3(api, rawApi, defaultContentType) : extractChannelsV2(api, rawApi, defaultContentType);
   const components = extractComponents(api, rawApi, isV3, defaultContentType);
   const root = api;
-  const tags = api.tags?.map((tag) => {
+  const rootTags = isV3 ? api.info.tags ?? api.tags : api.tags;
+  const rootExternalDocs = isV3 ? api.info.externalDocs ?? api.externalDocs : api.externalDocs;
+  const tags = rootTags?.map((tag) => {
     const raw2 = tag;
     return {
       name: tag.name,
@@ -113,7 +136,7 @@ async function parseAsyncApiSpec(specInput) {
     components,
     tags,
     tagGroups: root["x-tagGroups"],
-    externalDocs: api.externalDocs,
+    externalDocs: rootExternalDocs,
     contact: api.info.contact,
     license: api.info.license,
     termsOfService: api.info.termsOfService,
@@ -143,15 +166,17 @@ function extractServers(api, rawApi) {
   const rawServers = !Array.isArray(rawApi.servers) && rawApi.servers || {};
   return Object.entries(api.servers).map(([name, s]) => toServer(s, name, rawServers[name]?.security));
 }
-function extractChannelsV2(api, defaultContentType) {
+function extractChannelsV2(api, rawApi, defaultContentType) {
   if (!api.channels) return [];
+  const rawChannels = rawApi.channels ?? {};
   return Object.entries(api.channels).map(([channelName, ch]) => {
     const operations = [];
+    const rawCh = rawChannels[channelName];
     if (ch.publish) {
-      operations.push(convertOperationV2("publish", ch.publish, defaultContentType));
+      operations.push(convertOperationV2("publish", ch.publish, rawCh?.publish, rawApi, defaultContentType));
     }
     if (ch.subscribe) {
-      operations.push(convertOperationV2("subscribe", ch.subscribe, defaultContentType));
+      operations.push(convertOperationV2("subscribe", ch.subscribe, rawCh?.subscribe, rawApi, defaultContentType));
     }
     const raw = ch;
     return {
@@ -166,16 +191,20 @@ function extractChannelsV2(api, defaultContentType) {
     };
   });
 }
-function convertOperationV2(action, rawOp, defaultContentType) {
+function convertOperationV2(action, rawOp, rawOperation, rawApi, defaultContentType) {
   const op = applyOperationTraits(rawOp, false);
   const messages = [];
   if (op.message) {
+    const rawMessage = rawOperation?.message;
     if ("oneOf" in op.message) {
-      for (const m of op.message.oneOf) {
-        messages.push(convertMessage(m, false, defaultContentType));
-      }
+      op.message.oneOf.forEach((m, i) => {
+        const rawOneOf = rawMessage?.oneOf;
+        messages.push(convertMessage(m, false, defaultContentType, rawMessageTraits(rawOneOf?.[i], rawApi)));
+      });
     } else {
-      messages.push(convertMessage(op.message, false, defaultContentType));
+      messages.push(
+        convertMessage(op.message, false, defaultContentType, rawMessageTraits(rawMessage, rawApi))
+      );
     }
   }
   const raw = op;
@@ -242,21 +271,26 @@ function extractChannelsV3(api, rawApi, defaultContentType) {
       const op = applyOperationTraits(resolvedOp, true);
       const rawOp = rawApi.operations?.[opKey];
       const channelName = resolveChannelName(rawOp?.channel, op.channel, addressToName);
-      const collectMessages = (list) => {
+      const collectMessages = (list, rawList) => {
         const out = [];
-        for (const msg of list ?? []) {
-          if (msg && typeof msg === "object" && "$ref" in msg) continue;
-          out.push(convertMessage(msg, true, defaultContentType));
-        }
+        (list ?? []).forEach((msg, i) => {
+          if (msg && typeof msg === "object" && "$ref" in msg) return;
+          out.push(convertMessage(msg, true, defaultContentType, rawMessageTraits(rawList?.[i], rawApi)));
+        });
         return out;
       };
-      let messages = collectMessages(op.messages);
+      let messages = collectMessages(op.messages, rawOp?.messages);
       if (messages.length === 0 && channelName && api.channels?.[channelName]?.messages) {
+        const rawChannelMessages = rawApi.channels?.[channelName]?.messages ?? {};
         messages = collectMessages(
-          Object.values(api.channels[channelName].messages)
+          Object.values(api.channels[channelName].messages),
+          Object.values(rawChannelMessages)
         );
       }
-      const replyMessages = collectMessages(op.reply?.messages);
+      const replyMessages = collectMessages(
+        op.reply?.messages,
+        rawOp?.reply?.messages
+      );
       const rawReplyChannel = rawOp?.reply?.channel;
       const replyChannelName = resolveChannelName(
         rawReplyChannel,
@@ -425,7 +459,7 @@ function ExternalLink({ href, children, label, className }) {
       target: "_blank",
       rel: "noopener noreferrer",
       "aria-label": `${label}, opens in new tab`,
-      className: cx(linkStyle$1, className),
+      className: cx(linkStyle$2, className),
       children: [
         children,
         /* @__PURE__ */ jsx(Icon, { name: "external-link", size: "0.875em" })
@@ -433,7 +467,7 @@ function ExternalLink({ href, children, label, className }) {
     }
   );
 }
-const linkStyle$1 = css({
+const linkStyle$2 = css({
   display: "inline-flex",
   alignItems: "center",
   gap: "0.25rem",
@@ -487,7 +521,7 @@ const metaStyle = css({
   color: "var(--omnispec-fg-secondary)",
   marginTop: "0.25rem"
 });
-const linkStyle = css({
+const linkStyle$1 = css({
   color: "var(--omnispec-fg-link)",
   textDecoration: "none",
   "&:hover": {
@@ -513,7 +547,7 @@ function AsyncOverview({ spec }) {
       ] }),
       spec.contact.email && /* @__PURE__ */ jsxs("span", { children: [
         " <",
-        /* @__PURE__ */ jsx("a", { href: `mailto:${spec.contact.email}`, className: linkStyle, children: spec.contact.email }),
+        /* @__PURE__ */ jsx("a", { href: `mailto:${spec.contact.email}`, className: linkStyle$1, children: spec.contact.email }),
         ">"
       ] }),
       spec.contact.url && /* @__PURE__ */ jsxs("span", { children: [
@@ -673,9 +707,9 @@ function FieldRows({
   verbatim = false
 }) {
   if (fields.length === 0) return null;
-  return /* @__PURE__ */ jsx("dl", { className: listStyle$1, children: fields.map(([field, value]) => /* @__PURE__ */ jsxs("div", { className: rowStyle$1, children: [
+  return /* @__PURE__ */ jsx("dl", { className: listStyle$1, children: fields.map(([field, value]) => /* @__PURE__ */ jsxs("div", { className: rowStyle$2, children: [
     /* @__PURE__ */ jsx("dt", { className: nameStyle$1, children: verbatim ? field : humanizeField(field) }),
-    /* @__PURE__ */ jsx("dd", { className: valueStyle, children: renderValue(value, verbatim) })
+    /* @__PURE__ */ jsx("dd", { className: valueStyle$1, children: renderValue(value, verbatim) })
   ] }, field)) });
 }
 const listStyle$1 = css({
@@ -685,13 +719,13 @@ const listStyle$1 = css({
   margin: "0.25rem 0 0",
   minWidth: 0
 });
-const rowStyle$1 = css({ display: "contents" });
+const rowStyle$2 = css({ display: "contents" });
 const nameStyle$1 = css({
   fontSize: "var(--omnispec-font-size-xs)",
   fontWeight: 600,
   color: "var(--omnispec-fg-secondary)"
 });
-const valueStyle = css({
+const valueStyle$1 = css({
   fontSize: "var(--omnispec-font-size-xs)",
   color: "var(--omnispec-fg-primary)",
   margin: 0,
@@ -836,8 +870,8 @@ const emptyStyle = css({
 
 function SecurityRequirementBadges({ requirements, label = "Security" }) {
   if (!requirements || requirements.length === 0) return null;
-  return /* @__PURE__ */ jsxs("div", { className: rowStyle, children: [
-    /* @__PURE__ */ jsx("span", { className: labelStyle, children: label }),
+  return /* @__PURE__ */ jsxs("div", { className: rowStyle$1, children: [
+    /* @__PURE__ */ jsx("span", { className: labelStyle$1, children: label }),
     requirements.map((alternative, altIndex) => {
       const chips = alternative.map((scheme) => /* @__PURE__ */ jsxs("a", { href: `#security-${scheme.name}`, className: badgeStyle, children: [
         /* @__PURE__ */ jsx(Icon, { name: "lock", size: "0.625rem", strokeWidth: 2.5 }),
@@ -854,7 +888,7 @@ function SecurityRequirementBadges({ requirements, label = "Security" }) {
     })
   ] });
 }
-const rowStyle = css({
+const rowStyle$1 = css({
   display: "flex",
   alignItems: "center",
   gap: "0.375rem",
@@ -870,7 +904,7 @@ const orGroupStyle = css({
   gap: "0.375rem",
   whiteSpace: "nowrap"
 });
-const labelStyle = css({
+const labelStyle$1 = css({
   fontSize: "var(--omnispec-font-size-xxs)",
   lineHeight: 1.5,
   fontWeight: 600,
@@ -1066,7 +1100,7 @@ function ServerList({ servers }) {
   ] });
 }
 
-function TagChips({ tags, onTagClick }) {
+function TagChips({ tags, onTagClick, activeTag }) {
   if (!tags || tags.length === 0) return null;
   return /* @__PURE__ */ jsx("div", { className: tagChipsStyle$1, children: tags.map((tag) => /* @__PURE__ */ jsxs("span", { className: tagItemStyle, children: [
     onTagClick ? /* @__PURE__ */ jsx(
@@ -1075,6 +1109,7 @@ function TagChips({ tags, onTagClick }) {
         type: "button",
         className: tagChipButtonStyle$1,
         title: tag.description,
+        "aria-pressed": tag.name === activeTag,
         onClick: () => onTagClick(tag.name),
         children: tag.name
       }
@@ -1333,22 +1368,94 @@ const unresolvedRefCodeStyle = css({
   fontSize: "var(--omnispec-font-size-xs)"
 });
 
-const actionLabels$1 = {
+const actionLabels = {
   publish: "PUB",
   subscribe: "SUB",
   send: "SEND",
   receive: "RECV"
 };
-const actionColors$1 = {
+const actionColors = {
   publish: "var(--omnispec-color-publish)",
   subscribe: "var(--omnispec-color-subscribe)",
   send: "var(--omnispec-color-publish)",
   receive: "var(--omnispec-color-subscribe)"
 };
-function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick }) {
-  const primaryAction = channel.operations[0]?.action;
-  const primaryLabel = actionLabels$1[primaryAction] ?? primaryAction?.toUpperCase() ?? "";
-  const primaryColor = actionColors$1[primaryAction] ?? "var(--omnispec-fg-muted)";
+function channelActionBadge(channel) {
+  const distinct = [...new Set(channel.operations.map((op) => op.action))];
+  const label = distinct.map((a) => actionLabels[a] ?? a.toUpperCase()).join(" / ");
+  const color = distinct.length === 1 ? actionColors[distinct[0]] ?? "var(--omnispec-fg-muted)" : "var(--omnispec-color-primary)";
+  return { label, color };
+}
+
+function ReplyMeta({
+  reply,
+  channelHref,
+  onChannelNavigate
+}) {
+  const hasAddress = reply.address && (reply.address.value || reply.address.location || reply.address.description);
+  const replyHref = reply.channelName ? channelHref?.(reply.channelName) : void 0;
+  return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+    reply.channelName && /* @__PURE__ */ jsxs("div", { className: rowStyle, children: [
+      /* @__PURE__ */ jsx("span", { className: labelStyle, children: "channel" }),
+      replyHref ? /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: replyHref,
+          className: linkStyle,
+          onClick: onChannelNavigate ? (e) => {
+            e.preventDefault();
+            onChannelNavigate(reply.channelName);
+          } : void 0,
+          children: reply.channelName
+        }
+      ) : /* @__PURE__ */ jsx("code", { className: valueStyle, children: reply.channelName })
+    ] }),
+    hasAddress && /* @__PURE__ */ jsxs("div", { className: rowStyle, children: [
+      /* @__PURE__ */ jsx("span", { className: labelStyle, children: "address" }),
+      reply.address?.value && /* @__PURE__ */ jsx("code", { className: valueStyle, children: reply.address.value }),
+      reply.address?.location && /* @__PURE__ */ jsx("code", { className: valueStyle, children: reply.address.location }),
+      reply.address?.description && /* @__PURE__ */ jsx("span", { className: descStyle$2, children: reply.address.description })
+    ] })
+  ] });
+}
+const rowStyle = css({
+  display: "flex",
+  alignItems: "center",
+  gap: "0.5rem",
+  flexWrap: "wrap",
+  marginBottom: "0.5rem"
+});
+const labelStyle = css({
+  fontSize: "var(--omnispec-font-size-xs)",
+  fontWeight: 700,
+  color: "var(--omnispec-fg-primary)",
+  fontFamily: "var(--omnispec-font-mono)"
+});
+const valueStyle = css({
+  fontFamily: "var(--omnispec-font-mono)",
+  fontSize: "var(--omnispec-font-size-xs)",
+  color: "var(--omnispec-fg-code)",
+  backgroundColor: "var(--omnispec-bg-tertiary)",
+  padding: "0.0625rem 0.375rem",
+  borderRadius: "0.1875rem"
+});
+const linkStyle = css({
+  fontFamily: "var(--omnispec-font-mono)",
+  fontSize: "var(--omnispec-font-size-xs)",
+  color: "var(--omnispec-color-primary)",
+  backgroundColor: "var(--omnispec-bg-tertiary)",
+  padding: "0.0625rem 0.375rem",
+  borderRadius: "0.1875rem",
+  textDecoration: "none",
+  "&:hover": { textDecoration: "underline" }
+});
+const descStyle$2 = css({
+  fontSize: "var(--omnispec-font-size-xs)",
+  color: "var(--omnispec-fg-secondary)"
+});
+
+function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick, activeTag, channelHref, onChannelNavigate }) {
+  const headerBadge = channelActionBadge(channel);
   return /* @__PURE__ */ jsxs(
     ExpandableCard,
     {
@@ -1358,10 +1465,10 @@ function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick })
       expandAll,
       expandGeneration,
       children: [
-        /* @__PURE__ */ jsx(MethodBar, { label: primaryLabel, path: channel.address, color: primaryColor }),
+        /* @__PURE__ */ jsx(MethodBar, { label: headerBadge.label, path: channel.address, color: headerBadge.color }),
         /* @__PURE__ */ jsxs("div", { className: bodyStyle, children: [
           channel.description && /* @__PURE__ */ jsx("div", { className: sectionStyle$1, children: /* @__PURE__ */ jsx(MarkdownRenderer, { content: channel.description }) }),
-          channel.tags && channel.tags.length > 0 && /* @__PURE__ */ jsx(TagChips, { tags: channel.tags, onTagClick }),
+          channel.tags && channel.tags.length > 0 && /* @__PURE__ */ jsx(TagChips, { tags: channel.tags, onTagClick, activeTag }),
           channel.externalDocs && /* @__PURE__ */ jsx("div", { className: sectionStyle$1, children: /* @__PURE__ */ jsx(ExternalDocsLink, { externalDocs: channel.externalDocs, context: channel.address }) }),
           channel.parameters && Object.keys(channel.parameters).length > 0 && /* @__PURE__ */ jsxs("div", { className: sectionStyle$1, children: [
             /* @__PURE__ */ jsx("h4", { className: sectionTitleStyle$1, children: "Parameters" }),
@@ -1396,9 +1503,9 @@ function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick })
                   "span",
                   {
                     className: cx(actionBadgeBase$1, css({
-                      backgroundColor: actionColors$1[op.action] ?? "var(--omnispec-fg-muted)"
+                      backgroundColor: actionColors[op.action] ?? "var(--omnispec-fg-muted)"
                     })),
-                    children: actionLabels$1[op.action] ?? op.action.toUpperCase()
+                    children: actionLabels[op.action] ?? op.action.toUpperCase()
                   }
                 ),
                 op.operationId && /* @__PURE__ */ jsx("span", { className: opIdStyle$1, children: op.operationId }),
@@ -1406,7 +1513,7 @@ function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick })
               ] }),
               op.summary && /* @__PURE__ */ jsx("span", { className: opSummaryStyle$1, children: op.summary })
             ] }),
-            op.tags && op.tags.length > 0 && /* @__PURE__ */ jsx(TagChips, { tags: op.tags, onTagClick }),
+            op.tags && op.tags.length > 0 && /* @__PURE__ */ jsx(TagChips, { tags: op.tags, onTagClick, activeTag }),
             op.description && /* @__PURE__ */ jsx("div", { className: sectionStyle$1, children: /* @__PURE__ */ jsx(MarkdownRenderer, { content: op.description }) }),
             op.externalDocs && /* @__PURE__ */ jsx("div", { className: opExternalDocsStyle, children: /* @__PURE__ */ jsx(
               ExternalDocsLink,
@@ -1419,16 +1526,7 @@ function ChannelDetail({ channel, id, expandAll, expandGeneration, onTagClick })
             /* @__PURE__ */ jsx(OperationMessages, { operation: op, idx }),
             op.reply && (op.reply.messages.length > 0 || op.reply.address || op.reply.channelName) && /* @__PURE__ */ jsxs("div", { className: replyStyle$1, children: [
               /* @__PURE__ */ jsx("h4", { className: replyTitleStyle, children: "Reply" }),
-              op.reply.channelName && /* @__PURE__ */ jsxs("div", { className: replyMetaRowStyle, children: [
-                /* @__PURE__ */ jsx("span", { className: replyMetaLabelStyle, children: "channel" }),
-                /* @__PURE__ */ jsx("code", { className: replyMetaValueStyle, children: op.reply.channelName })
-              ] }),
-              op.reply.address && (op.reply.address.value || op.reply.address.location || op.reply.address.description) && /* @__PURE__ */ jsxs("div", { className: replyMetaRowStyle, children: [
-                /* @__PURE__ */ jsx("span", { className: replyMetaLabelStyle, children: "address" }),
-                op.reply.address.value && /* @__PURE__ */ jsx("code", { className: replyMetaValueStyle, children: op.reply.address.value }),
-                op.reply.address.location && /* @__PURE__ */ jsx("code", { className: replyMetaValueStyle, children: op.reply.address.location }),
-                op.reply.address.description && /* @__PURE__ */ jsx("span", { className: replyMetaDescStyle, children: op.reply.address.description })
-              ] }),
+              /* @__PURE__ */ jsx(ReplyMeta, { reply: op.reply, channelHref, onChannelNavigate }),
               op.reply.messages.map((replyMsg, i) => /* @__PURE__ */ jsx(MessageView, { message: replyMsg, idx: `${idx}-reply-${i}` }, i))
             ] }),
             /* @__PURE__ */ jsx(BindingsSection, { bindings: op.bindings, title: "Operation Bindings" })
@@ -1674,48 +1772,9 @@ const replyTitleStyle = css({
   color: "var(--omnispec-fg-primary)",
   letterSpacing: "0.02em"
 });
-const replyMetaRowStyle = css({
-  display: "flex",
-  alignItems: "center",
-  gap: "0.5rem",
-  flexWrap: "wrap",
-  marginBottom: "0.5rem"
-});
-const replyMetaLabelStyle = css({
-  fontSize: "var(--omnispec-font-size-xs)",
-  fontWeight: 700,
-  color: "var(--omnispec-fg-primary)",
-  fontFamily: "var(--omnispec-font-mono)"
-});
-const replyMetaValueStyle = css({
-  fontFamily: "var(--omnispec-font-mono)",
-  fontSize: "var(--omnispec-font-size-xs)",
-  color: "var(--omnispec-fg-code)",
-  backgroundColor: "var(--omnispec-bg-tertiary)",
-  padding: "1px 0.375rem",
-  borderRadius: "0.1875rem"
-});
-const replyMetaDescStyle = css({
-  fontSize: "var(--omnispec-font-size-xs)",
-  color: "var(--omnispec-fg-secondary)"
-});
 
-const actionLabels = {
-  publish: "PUB",
-  subscribe: "SUB",
-  send: "SEND",
-  receive: "RECV"
-};
-const actionColors = {
-  publish: "var(--omnispec-color-publish)",
-  subscribe: "var(--omnispec-color-subscribe)",
-  send: "var(--omnispec-color-publish)",
-  receive: "var(--omnispec-color-subscribe)"
-};
-function ChannelReferenceDetail({ channel, id, expandAll, expandGeneration, onTagClick }) {
-  const primaryAction = channel.operations[0]?.action;
-  const primaryLabel = actionLabels[primaryAction] ?? primaryAction?.toUpperCase() ?? "";
-  const primaryColor = actionColors[primaryAction] ?? "var(--omnispec-fg-muted)";
+function ChannelReferenceDetail({ channel, id, expandAll, expandGeneration, onTagClick, activeTag, channelHref, onChannelNavigate }) {
+  const headerBadge = channelActionBadge(channel);
   return /* @__PURE__ */ jsxs(
     ExpandableCard,
     {
@@ -1725,23 +1784,32 @@ function ChannelReferenceDetail({ channel, id, expandAll, expandGeneration, onTa
       expandAll,
       expandGeneration,
       children: [
-        /* @__PURE__ */ jsx(MethodBar, { label: primaryLabel, path: channel.address, color: primaryColor }),
+        /* @__PURE__ */ jsx(MethodBar, { label: headerBadge.label, path: channel.address, color: headerBadge.color }),
         channel.description && /* @__PURE__ */ jsx("div", { className: channelMetaStyle, children: /* @__PURE__ */ jsx(MarkdownRenderer, { content: channel.description }) }),
         channel.externalDocs && /* @__PURE__ */ jsx("div", { className: channelMetaStyle, children: /* @__PURE__ */ jsx(ExternalDocsLink, { externalDocs: channel.externalDocs, context: channel.address }) }),
         channel.operations.map((op, idx) => /* @__PURE__ */ jsx("div", { id: id ? `${id}-op-${idx}` : void 0, className: operationWrapStyle, children: /* @__PURE__ */ jsx(
           ReferenceLayout,
           {
             operationId: op.operationId ?? `${channel.name}-op-${idx}`,
-            schema: /* @__PURE__ */ jsx(
+            schema: /* @__PURE__ */ jsx("div", { className: refMobilePadStyle, children: /* @__PURE__ */ jsx(
               OperationSchemaColumn,
               {
                 channel,
                 operation: op,
-                onTagClick
+                onTagClick,
+                activeTag
+              }
+            ) }),
+            samples: /* @__PURE__ */ jsx("div", { className: refMobilePadStyle, children: /* @__PURE__ */ jsx(
+              OperationSamplesColumn,
+              {
+                operation: op,
+                idx,
+                channelHref,
+                onChannelNavigate
               }
-            ),
-            samples: /* @__PURE__ */ jsx(OperationSamplesColumn, { operation: op, idx }),
-            tryIt: /* @__PURE__ */ jsx("div", { className: tryItNaStyle, children: "Interactive testing is not available for AsyncAPI protocols." })
+            ) }),
+            tryIt: /* @__PURE__ */ jsx("div", { className: cx(refMobilePadStyle, tryItNaStyle), children: "Interactive testing is not available for AsyncAPI protocols." })
           }
         ) }, idx))
       ]
@@ -1751,7 +1819,8 @@ function ChannelReferenceDetail({ channel, id, expandAll, expandGeneration, onTa
 function OperationSchemaColumn({
   channel,
   operation,
-  onTagClick
+  onTagClick,
+  activeTag
 }) {
   return /* @__PURE__ */ jsxs("div", { children: [
     /* @__PURE__ */ jsxs("div", { className: opHeaderStyle, children: [
@@ -1775,6 +1844,7 @@ function OperationSchemaColumn({
           type: "button",
           className: tagChipButtonStyle,
           title: tag.description,
+          "aria-pressed": tag.name === activeTag,
           onClick: () => onTagClick(tag.name),
           children: tag.name
         },
@@ -1819,10 +1889,11 @@ function OperationSchemaColumn({
     /* @__PURE__ */ jsx(BindingsSection, { bindings: channel.bindings, title: "Channel Bindings" })
   ] });
 }
-function OperationSamplesColumn({ operation, idx }) {
+function OperationSamplesColumn({ operation, idx, channelHref, onChannelNavigate }) {
   const messages = operation.messages ?? [];
-  const replyMessages = operation.reply?.messages ?? [];
-  if (messages.length === 0 && replyMessages.length === 0) {
+  const reply = operation.reply;
+  const hasReply = !!(reply && (reply.messages.length > 0 || reply.address || reply.channelName));
+  if (messages.length === 0 && !hasReply) {
     return /* @__PURE__ */ jsx("div", { className: emptySamplesStyle, children: "No message payload is defined for this operation." });
   }
   return /* @__PURE__ */ jsxs("div", { className: samplesColumnStyle, children: [
@@ -1837,9 +1908,10 @@ function OperationSamplesColumn({ operation, idx }) {
       message.contentType && /* @__PURE__ */ jsx("code", { className: contentTypeStyle$1, children: message.contentType }),
       /* @__PURE__ */ jsx(MessagePayload, { message, idx: `${idx}-msg-${i}` })
     ] }, i)),
-    replyMessages.length > 0 && /* @__PURE__ */ jsxs("div", { className: replyStyle, children: [
+    hasReply && reply && /* @__PURE__ */ jsxs("div", { className: replyStyle, children: [
       /* @__PURE__ */ jsx("h4", { className: sectionTitleStyle, children: "Reply" }),
-      replyMessages.map((message, i) => /* @__PURE__ */ jsx(MessagePayload, { message, idx: `${idx}-reply-${i}` }, i))
+      /* @__PURE__ */ jsx(ReplyMeta, { reply, channelHref, onChannelNavigate }),
+      reply.messages.map((message, i) => /* @__PURE__ */ jsx(MessagePayload, { message, idx: `${idx}-reply-${i}` }, i))
     ] })
   ] });
 }
@@ -1849,6 +1921,9 @@ const channelMetaStyle = css({
     padding: "1rem 1.25rem 0"
   }
 });
+const refMobilePadStyle = css({
+  [mq.mobile]: { paddingInline: "1rem" }
+});
 const operationWrapStyle = css({
   borderTop: "1px solid var(--omnispec-border-color)"
 });
@@ -1916,7 +1991,9 @@ const paramConstraintsStyle = css({
 const opHeaderStyle = css({
   display: "flex",
   alignItems: "center",
-  gap: "0.5rem",
+  flexWrap: "wrap",
+  gap: "0.25rem 0.5rem",
+  minWidth: 0,
   marginBottom: "0.5rem"
 });
 const actionBadgeBase = css({
@@ -1933,16 +2010,21 @@ const opIdStyle = css({
   fontSize: "var(--omnispec-font-size-sm)",
   fontWeight: 700,
   backgroundColor: "transparent",
-  padding: 0
+  padding: 0,
+  overflowWrap: "anywhere"
 });
 const opTitleStyle = css({
   fontSize: "var(--omnispec-font-size-sm)",
   fontWeight: 600,
-  color: "var(--omnispec-fg-primary)"
+  color: "var(--omnispec-fg-primary)",
+  overflowWrap: "anywhere"
 });
 const opSummaryStyle = css({
+  flexBasis: "100%",
+  minWidth: 0,
   fontSize: "var(--omnispec-font-size-sm)",
-  color: "var(--omnispec-fg-secondary)"
+  color: "var(--omnispec-fg-secondary)",
+  overflowWrap: "anywhere"
 });
 const messageTitleStyle = css({
   fontWeight: 400,
@@ -2392,17 +2474,39 @@ function AsyncApiSpec({
     setActiveTagFilter((prev) => {
       const next = prev === tagName ? null : tagName;
       setSearchQuery(next ?? "");
+      writeTagParam(next);
       return next;
     });
   }, []);
   const handleSearch = useCallback((query) => {
     setSearchQuery(query);
     setActiveTagFilter(null);
+    writeTagParam(null);
   }, []);
   const clearTagFilter = useCallback(() => {
     setActiveTagFilter(null);
     setSearchQuery("");
+    writeTagParam(null);
   }, []);
+  const availableTags = useMemo(() => {
+    const names = /* @__PURE__ */ new Set();
+    for (const tag of parsedSpec?.tags ?? []) names.add(tag.name);
+    for (const ch of parsedSpec?.channels ?? []) {
+      for (const tag of ch.tags ?? []) names.add(tag.name);
+      for (const op of ch.operations) for (const t of op.tags ?? []) names.add(t.name);
+    }
+    return names;
+  }, [parsedSpec]);
+  const didInitFromUrl = useRef(false);
+  useEffect(() => {
+    if (didInitFromUrl.current || !parsedSpec) return;
+    didInitFromUrl.current = true;
+    const urlTag = readTagParam();
+    if (urlTag && availableTags.has(urlTag)) {
+      setActiveTagFilter(urlTag);
+      setSearchQuery(urlTag);
+    }
+  }, [parsedSpec, availableTags]);
   useMemo(() => {
     if (parsedSpec && onSpecLoaded) {
       const major = parseInt(parsedSpec.specVersion.split(".")[0], 10);
@@ -2452,6 +2556,13 @@ function AsyncApiSpec({
     }
     return map;
   }, [filteredChannels, channelDomId]);
+  const channelHref = useCallback(
+    (channelName) => {
+      const domId = channelDomId.get(channelName);
+      return domId ? `#${domId}` : void 0;
+    },
+    [channelDomId]
+  );
   const hasOperations = useMemo(
     () => filteredChannels.some((ch) => ch.operations.length > 0),
     [filteredChannels]
@@ -2536,6 +2647,10 @@ function AsyncApiSpec({
     }
     navigateTo(id);
   }, [navigateTo, opToCard]);
+  const onChannelNavigate = useCallback((channelName) => {
+    const domId = channelDomId.get(channelName);
+    if (domId) navigateTo(domId);
+  }, [channelDomId, navigateTo]);
   const navSectionIds = useMemo(() => flattenNavItemIds(navItems), [navItems]);
   const activeSection = useScrollSpy(navSectionIds);
   if (state.status === "loading") {
@@ -2561,7 +2676,7 @@ function AsyncApiSpec({
     /* @__PURE__ */ jsx(
       SearchBar,
       {
-        placeholder: "Filter channels...",
+        placeholder: navGrouping === "operation" ? "Filter operations..." : "Filter channels...",
         onSearch: handleSearch,
         value: searchQuery
       }
@@ -2656,7 +2771,10 @@ function AsyncApiSpec({
                 displayMode: resolvedDisplayMode,
                 expandAll: allExpanded,
                 expandGeneration,
-                onTagClick: handleTagFilter
+                onTagClick: handleTagFilter,
+                activeTag: activeTagFilter,
+                channelHref,
+                onChannelNavigate
               },
               `${group.id}-${channel.name}`
             ))
@@ -2668,7 +2786,10 @@ function AsyncApiSpec({
               displayMode: resolvedDisplayMode,
               expandAll: allExpanded,
               expandGeneration,
-              onTagClick: handleTagFilter
+              onTagClick: handleTagFilter,
+              activeTag: activeTagFilter,
+              channelHref,
+              onChannelNavigate
             },
             channel.name
           ))
@@ -2685,7 +2806,10 @@ function ChannelCard({
   displayMode,
   expandAll,
   expandGeneration,
-  onTagClick
+  onTagClick,
+  activeTag,
+  channelHref,
+  onChannelNavigate
 }) {
   const Renderer = displayMode === "reference" ? ChannelReferenceDetail : ChannelDetail;
   return /* @__PURE__ */ jsx(
@@ -2695,10 +2819,31 @@ function ChannelCard({
       channel,
       expandAll,
       expandGeneration,
-      onTagClick
+      onTagClick,
+      activeTag,
+      channelHref,
+      onChannelNavigate
     }
   );
 }
+const TAG_PARAM = "omnispec-tag";
+function readTagParam() {
+  if (typeof window === "undefined") return null;
+  return new URLSearchParams(window.location.search).get(TAG_PARAM);
+}
+function writeTagParam(tag) {
+  if (typeof window === "undefined") return;
+  const params = new URLSearchParams(window.location.search);
+  if (params.get(TAG_PARAM) === (tag ?? null)) return;
+  if (tag) params.set(TAG_PARAM, tag);
+  else params.delete(TAG_PARAM);
+  const query = params.toString();
+  window.history.replaceState(
+    window.history.state,
+    "",
+    `${window.location.pathname}${query ? `?${query}` : ""}${window.location.hash}`
+  );
+}
 function nestByTagGroups(groups, xTagGroups, toNav) {
   if (!xTagGroups?.length) return groups.map(toNav);
   const byTagName = /* @__PURE__ */ new Map();
@@ -2819,4 +2964,4 @@ const activeFilterClearStyle = css({
 });
 
 export { AsyncApiSpec };
-//# sourceMappingURL=AsyncApiSpec-C0tdvyEP.js.map
+//# sourceMappingURL=AsyncApiSpec-DkQzir1h.js.map