@scalar/api-reference 1.28.14 → 1.28.16

package/dist/hooks/useSidebar.js

@@ -1,84 +1,84 @@
 import { isOperationDeprecated as F } from "../libs/operation.js";
 import { ssrState as Y } from "@scalar/oas-utils/helpers";
-import { ref as S, reactive as q, computed as J, watch as z } from "vue";
+import { ref as w, reactive as z, computed as P, watch as U } from "vue";
 import { lazyBus as Z } from "../components/Content/Lazy/lazyBus.js";
 import { useNavState as $ } from "./useNavState.js";
-import { getLowestHeadingLevel as K } from "../helpers/getLowestHeadingLevel.js";
+import { getLowestHeadingLevel as q } from "../helpers/getLowestHeadingLevel.js";
 import { hasModels as ee } from "../helpers/hasModels.js";
-import { getModels as P } from "../helpers/getModels.js";
+import { getModels as _ } from "../helpers/getModels.js";
 import { hasWebhooks as te } from "../helpers/hasWebhooks.js";
 import { getHeadingsFromMarkdown as se } from "../helpers/getHeadingsFromMarkdown.js";
-import { scrollToId as R } from "../helpers/scrollToId.js";
-const y = S(null), u = S(void 0), v = q({});
-function _(t) {
-  var p, r, i;
-  v.tagsSorter === "alpha" ? t.tags = (p = t.tags) == null ? void 0 : p.sort((s, d) => s.name.localeCompare(d.name)) : typeof v.tagsSorter == "function" && (t.tags = (r = t.tags) == null ? void 0 : r.sort(v.tagsSorter));
-  const a = (s, d) => {
-    const x = s.name ?? s.path, g = d.name ?? d.path;
-    return x.localeCompare(g);
-  }, l = (s, d) => s.httpVerb.localeCompare(d.httpVerb);
-  let c;
-  return v.operationsSorter === "alpha" ? c = a : v.operationsSorter === "method" ? c = l : typeof v.operationsSorter == "function" && (c = v.operationsSorter), c && ((i = t.tags) == null || i.forEach((s) => {
-    var d;
-    s.operations = (d = s.operations) == null ? void 0 : d.sort(c);
-  })), u.value = t;
+import { scrollToId as N } from "../helpers/scrollToId.js";
+const re = "introduction", O = w(null), c = w(void 0), g = z({});
+function R(t) {
+  var p, s, l;
+  g.tagsSorter === "alpha" ? t.tags = (p = t.tags) == null ? void 0 : p.sort((r, n) => r.name.localeCompare(n.name)) : typeof g.tagsSorter == "function" && (t.tags = (s = t.tags) == null ? void 0 : s.sort(g.tagsSorter));
+  const a = (r, n) => {
+    const T = r.name ?? r.path, m = n.name ?? n.path;
+    return T.localeCompare(m);
+  }, i = (r, n) => r.httpVerb.localeCompare(n.httpVerb);
+  let d;
+  return g.operationsSorter === "alpha" ? d = a : g.operationsSorter === "method" ? d = i : typeof g.operationsSorter == "function" && (d = g.operationsSorter), d && ((l = t.tags) == null || l.forEach((r) => {
+    var n;
+    r.operations = (n = r.operations) == null ? void 0 : n.sort(d);
+  })), c.value = t;
 }
-const N = S(!1), Q = S(!1), T = q(Y["useSidebarContent-collapsedSidebarItems"] ?? {});
-function re(t) {
-  T[t] = !T[t];
+const J = w(!1), K = w(!1), y = z(Y["useSidebarContent-collapsedSidebarItems"] ?? {});
+function oe(t) {
+  y[t] = !y[t];
 }
-function w(t, a) {
-  T[t] = a;
+function I(t, a) {
+  y[t] = a;
 }
-const k = S([]);
-function oe(t) {
-  const a = se(t), l = K(a);
-  return a.filter((c) => (
+const x = w([]);
+function ae(t) {
+  const a = se(t), i = q(a);
+  return a.filter((d) => (
     // highest level, eg. # Introduction
-    c.depth === l || // second highest level, eg. ## Authentication
-    c.depth === l + 1
+    d.depth === i || // second highest level, eg. ## Authentication
+    d.depth === i + 1
   ));
 }
-const U = J(() => {
-  var C, H, B, E, j, V, D, G, L, W;
-  if (!y.value)
+const Q = P(() => {
+  var M, C, E, B, D, L, j, G, V, W;
+  if (!O.value)
     return { entries: [], titles: {} };
-  const { getHeadingId: t, getModelId: a, getOperationId: l, getTagId: c, getWebhookId: p } = y.value, r = {}, i = [];
-  let s = null;
-  k.value.forEach((e) => {
+  const { getHeadingId: t, getModelId: a, getOperationId: i, getTagId: d, getWebhookId: p } = O.value, s = {}, l = [];
+  let r = null;
+  x.value.forEach((e) => {
     var o;
-    e.depth === K(k.value) ? (s = {
+    e.depth === q(x.value) ? (r = {
       id: t(e),
       title: e.value,
       show: !0,
       children: []
-    }, i.push(s)) : s && ((o = s.children) == null || o.push({
+    }, l.push(r)) : r && ((o = r.children) == null || o.push({
       id: t(e),
       title: e.value,
       show: !0
     }));
   });
-  const d = (H = (C = u.value) == null ? void 0 : C.tags) == null ? void 0 : H[0], g = d && ((e) => (e == null ? void 0 : e.length) !== 1 || e[0].name !== "default" || e[0].description !== "")((B = u.value) == null ? void 0 : B.tags) ? (j = (E = u.value) == null ? void 0 : E.tags) == null ? void 0 : j.filter((e) => {
+  const n = (C = (M = c.value) == null ? void 0 : M.tags) == null ? void 0 : C[0], m = n && ((e) => (e == null ? void 0 : e.length) !== 1 || e[0].name !== "default" || e[0].description !== "")((E = c.value) == null ? void 0 : E.tags) ? (D = (B = c.value) == null ? void 0 : B.tags) == null ? void 0 : D.filter((e) => {
     var o;
     return ((o = e.operations) == null ? void 0 : o.length) > 0;
   }).map((e) => {
     var o;
     return {
-      id: c(e),
+      id: d(e),
       title: e.name,
       displayTitle: e["x-displayName"] ?? e.name,
       show: !0,
-      children: (o = e.operations) == null ? void 0 : o.map((n) => {
-        var m, b;
-        const h = l(n, e), f = n.name ?? n.path;
-        return r[h] = f, {
+      children: (o = e.operations) == null ? void 0 : o.map((u) => {
+        var v, b;
+        const h = i(u, e), f = u.name ?? u.path;
+        return s[h] = f, {
           id: h,
           title: f,
-          httpVerb: n.httpVerb,
+          httpVerb: u.httpVerb,
           // TODO: Workaround until we’re using the store directly
-          deprecated: n.information ? F({
-            deprecated: (m = n.information) == null ? void 0 : m.deprecated,
-            "x-scalar-stability": (b = n.information) == null ? void 0 : b["x-scalar-stability"]
+          deprecated: u.information ? F({
+            deprecated: (v = u.information) == null ? void 0 : v.deprecated,
+            "x-scalar-stability": (b = u.information) == null ? void 0 : b["x-scalar-stability"]
           }) : !1,
           show: !0,
           select: () => {
@@ -86,12 +86,12 @@ const U = J(() => {
         };
       })
     };
-  }) : (V = d == null ? void 0 : d.operations) == null ? void 0 : V.map((e) => {
+  }) : (L = n == null ? void 0 : n.operations) == null ? void 0 : L.map((e) => {
     var h, f;
-    const o = l(e, d), n = e.name ?? e.path;
-    return r[o] = n, {
+    const o = i(e, n), u = e.name ?? e.path;
+    return s[o] = u, {
       id: o,
-      title: n,
+      title: u,
       httpVerb: e.httpVerb,
       // TODO: Workaround until we’re using the store directly
       deprecated: e.information ? F({
@@ -103,35 +103,35 @@ const U = J(() => {
       }
     };
   });
-  let I = ee(u.value) && !N.value ? [
+  let S = ee(c.value) && !J.value ? [
     {
       id: a(),
       title: "Models",
       show: !0,
-      children: Object.keys(P(u.value) ?? {}).map((e) => {
-        var n;
+      children: Object.keys(_(c.value) ?? {}).map((e) => {
+        var u;
         const o = a({ name: e });
-        return r[o] = e, {
+        return s[o] = e, {
           id: o,
-          title: ((n = P(u.value)) == null ? void 0 : n[e]).title ?? e,
+          title: ((u = _(c.value)) == null ? void 0 : u[e]).title ?? e,
           show: !0
         };
       })
     }
-  ] : [], O = te(u.value) ? [
+  ] : [], k = te(c.value) ? [
     {
       id: p(),
       title: "Webhooks",
       show: !0,
-      children: Object.keys(((D = u.value) == null ? void 0 : D.webhooks) ?? {}).flatMap((e) => {
-        var n, h;
+      children: Object.keys(((j = c.value) == null ? void 0 : j.webhooks) ?? {}).flatMap((e) => {
+        var u, h;
         const o = p({ name: e });
-        return r[o] = e, Object.keys(((h = (n = u.value) == null ? void 0 : n.webhooks) == null ? void 0 : h[e]) ?? {}).map(
+        return s[o] = e, Object.keys(((h = (u = c.value) == null ? void 0 : u.webhooks) == null ? void 0 : h[e]) ?? {}).map(
           (f) => {
-            var m, b, A;
+            var v, b, A;
             return {
               id: p({ name: e, method: f }),
-              title: (A = (b = (m = u.value) == null ? void 0 : m.webhooks) == null ? void 0 : b[e][f]) == null ? void 0 : A.name,
+              title: (A = (b = (v = c.value) == null ? void 0 : v.webhooks) == null ? void 0 : b[e][f]) == null ? void 0 : A.name,
               httpVerb: f,
               show: !0
             };
@@ -140,17 +140,17 @@ const U = J(() => {
       })
     }
   ] : [];
-  const X = (G = u.value) != null && G["x-tagGroups"] ? (W = (L = u.value) == null ? void 0 : L["x-tagGroups"]) == null ? void 0 : W.map((e) => {
+  const X = (G = c.value) != null && G["x-tagGroups"] ? (W = (V = c.value) == null ? void 0 : V["x-tagGroups"]) == null ? void 0 : W.map((e) => {
     var h;
     const o = [];
     return (h = e.tags) == null || h.map((f) => {
-      if (f === "models" && I.length > 0)
-        o.push(I[0]), I = [];
-      else if (f === "webhooks" && O.length > 0)
-        o.push(O[0]), O = [];
+      if (f === "models" && S.length > 0)
+        o.push(S[0]), S = [];
+      else if (f === "webhooks" && k.length > 0)
+        o.push(k[0]), k = [];
       else {
-        const m = g == null ? void 0 : g.find((b) => b.title === f);
-        m && o.push(m);
+        const v = m == null ? void 0 : m.find((b) => b.title === f);
+        v && o.push(v);
       }
     }), {
       id: e.name,
@@ -159,81 +159,93 @@ const U = J(() => {
       show: !0,
       isGroup: !0
     };
-  }) : void 0, M = [
-    ...i,
-    ...X ?? g ?? [],
-    ...O,
-    ...I
+  }) : void 0, H = [
+    ...l,
+    ...X ?? m ?? [],
+    ...k,
+    ...S
   ];
-  return Q.value && M.forEach((e) => {
-    w(e.id, !0), e.show = !0;
+  return K.value && H.forEach((e) => {
+    I(e.id, !0), e.show = !0;
   }), {
-    entries: M,
-    titles: r
+    entries: H,
+    titles: s
   };
-}), ae = S(!1), le = J(() => {
-  var t, a, l;
-  return ((l = (t = U.value) == null ? void 0 : t.titles) == null ? void 0 : l[((a = y.value) == null ? void 0 : a.hash) ?? ""]) ?? "";
-}), ie = (t, a) => {
-  var c;
-  const l = (c = y.value) == null ? void 0 : c.getSectionId(t);
-  if (l && l !== t)
-    if (T[l])
-      R(t, a);
+}), ie = w(!1), le = P(() => {
+  var t, a, i;
+  return ((i = (t = Q.value) == null ? void 0 : t.titles) == null ? void 0 : i[((a = O.value) == null ? void 0 : a.hash) ?? ""]) ?? "";
+}), ne = (t, a) => {
+  var d;
+  const i = (d = O.value) == null ? void 0 : d.getSectionId(t);
+  if (i && i !== t)
+    if (y[i])
+      N(t, a);
     else {
-      const p = Z.on((r) => {
-        r.id === t && (R(t, a), p());
+      const p = Z.on((s) => {
+        s.id === t && (N(t, a), p());
       });
-      w(l, !0);
+      I(i, !0);
     }
 };
-function Se(t) {
-  Object.assign(v, t);
+function we(t) {
+  Object.assign(g, t);
   const a = $();
-  y.value = a;
-  const { hash: l, getSectionId: c, getTagId: p } = a;
-  return t != null && t.parsedSpec && (_(t.parsedSpec), z(
+  O.value = a;
+  const { hash: i, getSectionId: d, getTagId: p } = a;
+  return t != null && t.parsedSpec && (R(t.parsedSpec), U(
     () => {
-      var r, i;
-      return (i = (r = u.value) == null ? void 0 : r.tags) == null ? void 0 : i.length;
+      var s, l;
+      return (l = (s = c.value) == null ? void 0 : s.tags) == null ? void 0 : l.length;
     },
     () => {
-      var r, i;
-      if (l.value) {
-        const s = c(l.value);
-        s && w(s, !0);
+      var s, l;
+      if (i.value) {
+        const r = d(i.value);
+        r && I(r, !0);
       } else {
-        const s = (i = (r = u.value) == null ? void 0 : r.tags) == null ? void 0 : i[0];
-        s && w(p(s), !0);
+        const r = (l = (s = c.value) == null ? void 0 : s.tags) == null ? void 0 : l[0];
+        r && I(p(r), !0);
       }
     }
-  ), z(
+  ), U(
     () => {
-      var r, i;
-      return (i = (r = u.value) == null ? void 0 : r.info) == null ? void 0 : i.description;
+      var s, l;
+      return (l = (s = c.value) == null ? void 0 : s.info) == null ? void 0 : l.description;
     },
     () => {
-      var i, s;
-      const r = (s = (i = u.value) == null ? void 0 : i.info) == null ? void 0 : s.description;
-      return r ? k.value = oe(r) : k.value = [];
+      var r, n, T, m;
+      const s = (T = (n = (r = c.value) == null ? void 0 : r.info) == null ? void 0 : n.description) == null ? void 0 : T.trim();
+      if (!s)
+        return x.value = [];
+      const l = ae(s);
+      if (s && !s.startsWith("#")) {
+        const S = {
+          depth: ((m = l[0]) == null ? void 0 : m.depth) ?? 1,
+          value: "Introduction",
+          slug: re
+        };
+        l.unshift(S);
+      }
+      return x.value = l;
     },
     {
       immediate: !0
     }
   )), {
     breadcrumb: le,
-    items: U,
-    isSidebarOpen: ae,
-    collapsedSidebarItems: T,
-    toggleCollapsedSidebarItem: re,
-    setCollapsedSidebarItem: w,
-    hideModels: N,
-    setParsedSpec: _,
-    defaultOpenAllTags: Q,
-    scrollToOperation: ie
+    items: Q,
+    isSidebarOpen: ie,
+    collapsedSidebarItems: y,
+    toggleCollapsedSidebarItem: oe,
+    setCollapsedSidebarItem: I,
+    hideModels: J,
+    setParsedSpec: R,
+    defaultOpenAllTags: K,
+    scrollToOperation: ne
   };
 }
 export {
-  ie as scrollToOperation,
-  Se as useSidebar
+  re as DEFAULT_INTRODUCTION_SLUG,
+  ne as scrollToOperation,
+  we as useSidebar
 };