@scalar/api-client 2.12.0 → 2.14.0

package/dist/v2/features/command-palette/types.d.ts

@@ -0,0 +1,82 @@
+import type { WorkspaceStore } from '@scalar/workspace-store/client';
+import type { WorkspaceEventBus } from '@scalar/workspace-store/events';
+import type { AllowedComponentProps, Component, VNodeProps } from 'vue';
+import type { CommandPropsMap, OpenCommandEvent, UiCommandIds } from '../../../v2/features/command-palette/hooks/use-command-palette-state.js';
+/**
+ * Default props that all command components receive.
+ * These are injected automatically by the command palette.
+ */
+export type DefaultCommandProps = {
+    /** The workspace store for accessing documents and operations */
+    workspaceStore: WorkspaceStore;
+    /** Event bus for emitting workspace events */
+    eventBus: WorkspaceEventBus;
+    /** Function to open a command */
+    'onOpen-command': OpenCommandEvent;
+};
+/** Helper type to make all properties writable */
+export type Writable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/**
+ * Extracts the props type from a Vue component.
+ * Strips out VNode and Vue-specific props to get only user-defined props.
+ */
+export type ComponentProps<C extends Component> = C extends new (...args: any) => {
+    $props: infer P;
+} ? Omit<P, keyof VNodeProps | keyof AllowedComponentProps> : never;
+/**
+ * Maps command IDs to their actual component props.
+ * Used for validating that components accept the correct props.
+ */
+export type CommandComponentPropsMap<T extends Record<string, Component>> = {
+    [K in keyof T]: ComponentProps<T[K]>;
+};
+/**
+ * Maps command IDs to their expected props (default props + command-specific props).
+ * This is what each command component should accept.
+ */
+export type ExpectedCommandComponentPropsMap = {
+    [K in UiCommandIds]: DefaultCommandProps & (CommandPropsMap[K] extends undefined ? unknown : CommandPropsMap[K]);
+};
+/** Helper type to flatten and display complex types in IDE tooltips */
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Type-level assertion that compares actual component props with expected props.
+ * Returns 'valid' if they match, otherwise returns a detailed debug object.
+ *
+ * Using literals prevents union collapse (true | never = true, but 'valid' | object stays distinct).
+ */
+export type AssertPropsMatch<Actual, Expected> = [Actual] extends [Expected] ? 'valid' : {
+    status: 'invalid';
+    actual: Prettify<Actual>;
+    expected: Prettify<Expected>;
+    missingProps: Prettify<Exclude<keyof Expected, keyof Actual>>;
+};
+/**
+ * Validates that all command components have the correct props.
+ * This type is used at the type-checking level to ensure type safety.
+ */
+export type CommandComponentPropsCheck<T extends Record<string, Component>> = {
+    [K in UiCommandIds]: AssertPropsMatch<Writable<CommandComponentPropsMap<T>[K]>, Partial<ExpectedCommandComponentPropsMap[K]>>;
+};
+/** All validation results for command components */
+export type PropsCheckResults<T extends Record<string, Component>> = CommandComponentPropsCheck<T>[keyof CommandComponentPropsCheck<T>];
+/**
+ * Filter to show only invalid components.
+ * Makes error messages clearer by excluding valid components.
+ */
+export type InvalidComponents<T extends Record<string, Component>> = {
+    [K in keyof CommandComponentPropsCheck<T> as CommandComponentPropsCheck<T>[K] extends 'valid' ? never : K]: CommandComponentPropsCheck<T>[K];
+};
+/**
+ * Final assertion type that shows only errors.
+ * If all components are valid, evaluates to 'valid'.
+ * If any component is invalid, shows only the invalid ones.
+ */
+export type AssertAllValid<T extends Record<string, Component>> = PropsCheckResults<T> extends 'valid' ? PropsCheckResults<T> extends {
+    status: 'invalid';
+} ? Prettify<InvalidComponents<T>> : PropsCheckResults<T> : Prettify<InvalidComponents<T>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/v2/features/command-palette/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/command-palette/types.ts"],"names":[],"mappings":"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"}

package/dist/v2/features/operation/Operation.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Operation.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/operation/Operation.vue"],"names":[],"mappings":"AAgHA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAIlE;;;;;;;GAOG;;AACH,wBAkKC"}
+{"version":3,"file":"Operation.vue.d.ts","sourceRoot":"","sources":["../../../../src/v2/features/operation/Operation.vue"],"names":[],"mappings":"AA0HA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAIlE;;;;;;;GAOG;;AACH,wBA4KC"}

package/dist/v2/features/operation/Operation.vue.js

@@ -1,13 +1,13 @@
-import { defineComponent as v, computed as r, createBlock as h, createElementBlock as y, openBlock as s, unref as a, createElementVNode as p } from "vue";
-import { getResolvedRef as f } from "@scalar/workspace-store/helpers/get-resolved-ref";
-import { useRouter as S } from "vue-router";
+import { defineComponent as v, computed as r, onMounted as y, createBlock as h, createElementBlock as f, openBlock as s, unref as u, createElementVNode as p } from "vue";
+import { getResolvedRef as S } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { useRouter as B } from "vue-router";
 import { getSecurityRequirements as k } from "./helpers/get-security-requirements.js";
-import B from "../../blocks/operation-block/OperationBlock.vue.js";
-const R = {
+import R from "../../blocks/operation-block/OperationBlock.vue.js";
+const g = {
   key: 1,
   class: "flex h-full w-full items-center justify-center"
-}, g = {}, P = /* @__PURE__ */ v({
-  ...g,
+}, N = {}, q = /* @__PURE__ */ v({
+  ...N,
   __name: "Operation",
   props: {
     documentSlug: {},
@@ -22,24 +22,28 @@ const R = {
     activeWorkspace: {}
   },
   setup(e) {
-    const o = r(
-      () => e.path && e.method ? f(e.document?.paths?.[e.path]?.[e.method]) : void 0
-    ), u = r(
-      () => k(e.document, o.value)
+    const n = r(
+      () => e.path && e.method ? S(e.document?.paths?.[e.path]?.[e.method]) : void 0
+    ), a = r(
+      () => k(e.document, n.value)
     ), m = r(
       () => e.document?.servers?.find(
         ({ url: t }) => t === e.document?.["x-scalar-selected-server"]
       ) ?? null
-    ), c = r(() => e.document?.["x-scalar-set-operation-security"] ? o.value?.["x-scalar-selected-security"] : e.document?.["x-scalar-selected-security"]), l = r(() => e.document?.["x-scalar-set-operation-security"] ? {
+    );
+    y(() => {
+      typeof e.document?.["x-scalar-selected-server"] > "u" && e.document?.servers?.[0]?.url && e.eventBus.emit("server:update:selected", { url: e.document.servers[0].url });
+    });
+    const c = r(() => e.document?.["x-scalar-set-operation-security"] ? n.value?.["x-scalar-selected-security"] : e.document?.["x-scalar-selected-security"]), l = r(() => e.document?.["x-scalar-set-operation-security"] ? {
       type: "operation",
       path: e.path ?? "",
       method: e.method ?? "get"
     } : {
       type: "document"
-    }), i = "2.12.0", d = S();
-    return (t, n) => t.path && t.method && t.exampleName && o.value ? (s(), h(a(B), {
+    }), i = "2.14.0", d = B();
+    return (t, o) => t.path && t.method && t.exampleName && n.value ? (s(), h(u(R), {
       key: 0,
-      appVersion: a(i),
+      appVersion: u(i),
       authMeta: l.value,
       environment: t.environment,
       eventBus: t.eventBus,
@@ -47,21 +51,21 @@ const R = {
       history: [],
       layout: t.layout,
       method: t.method,
-      operation: o.value,
+      operation: n.value,
       path: t.path,
       plugins: [],
-      security: u.value,
+      security: a.value,
       securitySchemes: t.document?.components?.securitySchemes ?? {},
       selectedSecurity: c.value,
       server: m.value,
       servers: t.document?.servers ?? [],
       totalPerformedRequests: 0,
-      "onUpdate:servers": n[0] || (n[0] = (N) => a(d).push({ name: "document.servers" }))
-    }, null, 8, ["appVersion", "authMeta", "environment", "eventBus", "exampleKey", "layout", "method", "operation", "path", "security", "securitySchemes", "selectedSecurity", "server", "servers"])) : (s(), y("div", R, [...n[1] || (n[1] = [
+      "onUpdate:servers": o[0] || (o[0] = (x) => u(d).push({ name: "document.servers" }))
+    }, null, 8, ["appVersion", "authMeta", "environment", "eventBus", "exampleKey", "layout", "method", "operation", "path", "security", "securitySchemes", "selectedSecurity", "server", "servers"])) : (s(), f("div", g, [...o[1] || (o[1] = [
       p("span", { class: "text-c-3" }, "Select an operation to view details", -1)
     ])]));
   }
 });
 export {
-  P as default
+  q as default
 };

package/dist/v2/helpers/drag-handle-factory.d.ts

@@ -1,5 +1,4 @@
-import type { DraggingItem, HoveredItem } from '@scalar/draggable';
-import { type SidebarState } from '@scalar/sidebar';
+import type { DraggingItem, HoveredItem, SidebarState } from '@scalar/sidebar';
 import type { WorkspaceStore } from '@scalar/workspace-store/client';
 import type { TraversedEntry } from '@scalar/workspace-store/schemas/navigation';
 import { type MaybeRefOrGetter } from 'vue';

package/dist/v2/helpers/drag-handle-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drag-handle-factory.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/drag-handle-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAGlE,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,iBAAiB,CAAA;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,4CAA4C,CAAA;AAInD,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,KAAK,CAAA;AA6XpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,kCAG/B;IACD,KAAK,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC9C,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;CAC3C;mCAKuC,YAAY,gBAAgB,WAAW,KAAG,OAAO;iCA2DnD,YAAY,gBAAgB,WAAW,KAAG,OAAO;CAwEtF,CAAA"}
+{"version":3,"file":"drag-handle-factory.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/drag-handle-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAIpE,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,4CAA4C,CAAA;AAGnD,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,KAAK,CAAA;AAiTpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,kCAG/B;IACD,KAAK,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC9C,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;CAC3C;mCAKuC,YAAY,gBAAgB,WAAW,KAAG,OAAO;iCA2DnD,YAAY,gBAAgB,WAAW,KAAG,OAAO;CAwEtF,CAAA"}

package/dist/v2/helpers/drag-handle-factory.js

@@ -1,135 +1,120 @@
-import { dereference as F } from "@scalar/openapi-parser";
-import { getParentEntry as i } from "@scalar/sidebar";
-import { getResolvedRef as b } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { sortByOrder as B } from "@scalar/helpers/array/sort-by-order";
+import { dereference as k, escapeJsonPointer as j } from "@scalar/openapi-parser";
 import { unpackProxyObject as x } from "@scalar/workspace-store/helpers/unpack-proxy";
-import { toValue as w } from "vue";
-const l = {
-  /** Insert before the hovered item */
-  BEFORE: 0,
-  /** Insert after the hovered item */
-  AFTER: 1,
-  /** Drop into the hovered item */
-  INTO: 2
-}, B = (n, t, e, o) => {
-  if (t === -1 || e === -1 || t === e)
+import { getParentEntry as d, getOpenapiObject as h } from "@scalar/workspace-store/navigation";
+import { toValue as b } from "vue";
+import { removeCircular as A } from "./remove-circular.js";
+const P = (r, t, n, a) => {
+  if (t === -1 || n === -1 || t === n)
     return null;
-  const c = [...n], [s] = c.splice(t, 1);
-  if (s === void 0)
+  const o = [...r], [e] = o.splice(t, 1);
+  if (e === void 0)
     return null;
-  const u = A(t, e, o, c.length);
-  return c.splice(u, 0, s), x(c, { depth: 1 });
-}, A = (n, t, e, o) => {
-  const c = n < t;
-  return e === l.AFTER ? c ? t : t + 1 : e === l.BEFORE ? c ? t - 1 : t : e === l.INTO ? o : t;
-}, h = (n, t) => t.includes(n.type), p = (n) => n.offset < l.INTO, E = (n) => n.offset === l.INTO, y = (n, t) => !n.parent || !t.parent ? !1 : n.parent.id === t.parent.id, m = ({
-  store: n,
-  entry: t
-}) => {
-  const e = i("document", t);
-  if (!e)
-    return null;
-  const o = n.workspace.documents[e.name];
-  return o ? t.type === "document" ? o : t.type === "tag" ? o.tags?.find((c) => c.name === t.name) ?? null : t.type === "operation" ? b(o.paths?.[t.path]?.[t.method]) ?? null : null : null;
-}, O = ({ store: n, entry: t }) => {
-  const e = i("document", t);
-  e && n.buildSidebar(e.name);
-}, P = (n, t) => n["x-scalar-order"] ?? t.children?.map((o) => o.id) ?? [], T = (n, t, e, o) => {
-  const c = t.parent;
-  if (!c || !h(c, ["tag", "document"]))
+  const u = R(t, n, a, o.length);
+  return o.splice(u, 0, e), x(o, { depth: 1 });
+}, R = (r, t, n, a) => {
+  const o = r < t;
+  return n === "after" ? o ? t : t + 1 : n === "before" ? o ? t - 1 : t : n === "into" ? a : t;
+}, y = (r, t) => t.includes(r.type), p = (r) => r.offset === "before" || r.offset === "after", m = (r) => r.offset === "into", l = (r, t) => !r.parent || !t.parent ? !1 : r.parent.id === t.parent.id, O = ({ store: r, entry: t }) => {
+  const n = d("document", t);
+  n && r.buildSidebar(n.name);
+}, M = (r, t) => r["x-scalar-order"] ?? t.children?.map((a) => a.id) ?? [], w = (r, t, n, a) => {
+  const o = t.parent;
+  if (!o || !y(o, ["tag", "document"]))
     return !1;
-  const s = m({ store: n, entry: c });
-  if (!s)
+  const e = h({ store: r, entry: o });
+  if (!e)
     return !1;
-  const u = P(s, c), r = u.findIndex((d) => d === t.id), a = u.findIndex((d) => d === e.id), f = B(u, r, a, o);
-  return f ? (s["x-scalar-order"] = f, O({ store: n, entry: c }), !0) : !1;
-}, k = (n, t, e) => {
-  const o = new Set(n.tags ?? []);
-  e && o.add(e.name), t && o.delete(t.name), n.tags = Array.from(o);
-}, N = (n, t, e, o) => {
-  n.paths?.[e.path]?.[e.method] && delete n.paths[e.path][e.method], t.paths ? (t.paths[e.path] || (t.paths[e.path] = {}), t.paths[e.path][e.method] = o) : t.paths = {
-    [e.path]: {
-      [e.method]: o
+  const u = M(e, o), s = u.findIndex((f) => f === t.id), c = u.findIndex((f) => f === n.id), i = P(u, s, c, a);
+  return i ? (e["x-scalar-order"] = i, O({ store: r, entry: o }), !0) : !1;
+}, T = (r, t, n) => {
+  const a = new Set(r.tags ?? []);
+  n && a.add(n.name), t && a.delete(t.name), r.tags = Array.from(a);
+}, $ = (r, t, n, a) => {
+  r.paths?.[n.path]?.[n.method] && delete r.paths[n.path][n.method], t.paths ? (t.paths[n.path] || (t.paths[n.path] = {}), t.paths[n.path][n.method] = a) : t.paths = {
+    [n.path]: {
+      [n.method]: a
     }
   };
-}, j = (n, t, e) => {
-  const { schema: o } = F(n);
-  return o.paths?.[t]?.[e];
-}, M = (n, t, e) => {
-  const o = i("document", t), c = i("document", e);
-  if (!o || !c)
+}, C = (r, t, n) => {
+  const o = k(r).schema.paths?.[t]?.[n];
+  return A(o, { prefix: `#/paths/${j(t)}/${n}` });
+}, F = (r, t, n) => {
+  const a = d("document", t), o = d("document", n);
+  if (!a || !o)
     return !1;
-  const s = m({ store: n, entry: o }), u = m({ store: n, entry: c });
-  if (!s || !u)
+  const e = h({ store: r, entry: a }), u = h({ store: r, entry: o });
+  if (!e || !u)
     return !1;
-  const r = j(
-    x(s),
+  const s = C(
+    x(e),
     t.path,
     t.method
   );
-  if (!r)
+  if (!s)
     return !1;
-  const a = i("tag", t) ?? null, f = i("tag", e) ?? null;
-  return k(r, a, f), N(s, u, t, r), O({ store: n, entry: t }), O({ store: n, entry: e }), !0;
-}, S = (n, t, e, o) => {
-  const c = n.workspace["x-scalar-order"] ?? Object.keys(n.workspace.documents), s = c.findIndex((a) => a === t.id), u = c.findIndex((a) => a === e.id), r = B(c, s, u, o);
-  return r ? (n.update("x-scalar-order", r), !0) : !1;
-}, z = ({
-  store: n,
+  const c = d("tag", t) ?? null, i = d("tag", n) ?? null;
+  return T(s, c, i), $(e, u, t, s), O({ store: r, entry: t }), O({ store: r, entry: n }), !0;
+}, H = (r, t, n, a) => {
+  const o = r.workspace["x-scalar-order"] ?? [], e = Object.keys(r.workspace.documents), u = B(e, o, (f) => f), s = u.findIndex((f) => f === t.id), c = u.findIndex((f) => f === n.id), i = P(u, s, c, a);
+  return i ? (r.update("x-scalar-order", i), !0) : !1;
+}, G = ({
+  store: r,
   sidebarState: t
 }) => ({
-  handleDragEnd: (c, s) => {
-    const u = w(n);
+  handleDragEnd: (o, e) => {
+    const u = b(r);
     if (!u)
       return !1;
-    const r = t.getEntryById(c.id), a = t.getEntryById(s.id);
-    if (!r || !a)
+    const s = t.getEntryById(o.id), c = t.getEntryById(e.id);
+    if (!s || !c)
       return !1;
-    if (r.type === "document")
-      return a.type !== "document" || !p(s) ? !1 : S(u, r, a, s.offset);
-    if (r.type === "tag")
-      return a.type !== "tag" || !p(s) || !y(r, a) ? !1 : T(
+    if (s.type === "document")
+      return c.type !== "document" || !p(e) ? !1 : H(u, s, c, e.offset);
+    if (s.type === "tag")
+      return c.type !== "tag" || !p(e) || !l(s, c) ? !1 : w(
         u,
-        r,
-        a,
-        s.offset
+        s,
+        c,
+        e.offset
       );
-    if (r.type === "operation") {
-      if (p(s) && y(r, a))
-        return T(
+    if (s.type === "operation") {
+      if (p(e) && l(s, c))
+        return w(
           u,
-          r,
-          a,
-          s.offset
+          s,
+          c,
+          e.offset
         );
-      if (h(a, ["tag", "document"]) && E(s))
-        return M(u, r, a);
+      if (y(c, ["tag", "document"]) && m(e))
+        return F(u, s, c);
     }
     return !1;
   },
-  isDroppable: (c, s) => {
-    const u = w(n);
+  isDroppable: (o, e) => {
+    const u = b(r);
     if (!u)
       return !1;
-    const r = t.getEntryById(c.id), a = t.getEntryById(s.id);
-    if (!r || !a || r.type === "example")
+    const s = t.getEntryById(o.id), c = t.getEntryById(e.id);
+    if (!s || !c || s.type === "example")
       return !1;
-    if (r.type === "document")
-      return a.type === "document" && p(s);
-    if (r.type === "tag")
-      return p(s) && y(r, a);
-    if (r.type === "operation") {
-      const f = i("document", a), d = i("document", r);
-      if (!f || !d)
+    if (s.type === "document")
+      return c.type === "document" && p(e);
+    if (s.type === "tag")
+      return p(e) && l(s, c);
+    if (s.type === "operation") {
+      const i = d("document", c), f = d("document", s);
+      if (!i || !f)
         return !1;
-      const D = m({ store: u, entry: f });
-      if (!D)
+      const E = h({ store: u, entry: i });
+      if (!E)
         return !1;
-      const R = y(r, a);
-      return p(s) && !R ? !1 : R ? p(s) || E(s) && h(a, ["tag", "document"]) : E(s) && h(a, ["tag", "document"]) && (d.id === f.id || D.paths?.[r.path]?.[r.method] === void 0);
+      const D = l(s, c);
+      return p(e) && !D ? !1 : D ? p(e) || m(e) && y(c, ["tag", "document"]) : m(e) && y(c, ["tag", "document"]) && (f.id === i.id || E.paths?.[s.path]?.[s.method] === void 0);
     }
     return !1;
   }
 });
 export {
-  z as dragHandleFactory
+  G as dragHandleFactory
 };

package/dist/v2/helpers/get-tab-details.d.ts

@@ -0,0 +1,43 @@
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import type { Tab } from '@scalar/workspace-store/schemas/extensions/workspace';
+import type { UseSidebarStateReturn } from '../../v2/hooks/use-sidebar-state.js';
+/**
+ * Returns display details for a tab in the API client UI.
+ * Determines the title and icon to use based on workspace, document, path, and method.
+ *
+ * - If no workspace is provided, returns { title: 'Untitled Tab' }.
+ * - If document is present, attempts to fetch an entry using getEntryByLocation, and returns:
+ *    - { title: entry.title, icon: 'document' } for document entry types,
+ *    - { title: entry.title, icon: 'request' } for all other types,
+ *    - If no entry found, returns { title: 'Untitled Tab' }.
+ * - If neither document nor entry is available, returns { title: 'Workspace' }.
+ *
+ * Example:
+ * ```
+ * const result = getTabDetails({
+ *   workspace: "main",
+ *   document: "doc1",
+ *   path: "/users",
+ *   method: "get",
+ *   getEntryByLocation: ({ document, path, method }) => {
+ *     // Mock lookup:
+ *     if (document === "doc1" && path === "/users") {
+ *       return { type: "document", title: "Users" }
+ *     }
+ *     return null
+ *   }
+ * })
+ * // result: { title: "Users", icon: "document" }
+ * ```
+ */
+export declare const getTabDetails: ({ workspace, document, path, method, getEntryByLocation, }: {
+    workspace?: string;
+    document?: string;
+    path?: string;
+    method?: HttpMethod;
+    getEntryByLocation: UseSidebarStateReturn["getEntryByLocation"];
+}) => {
+    title: string;
+    icon?: Tab["icon"];
+};
+//# sourceMappingURL=get-tab-details.d.ts.map

package/dist/v2/helpers/get-tab-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tab-details.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/get-tab-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sDAAsD,CAAA;AAE/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,aAAa,GAAI,4DAM3B;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,kBAAkB,EAAE,qBAAqB,CAAC,oBAAoB,CAAC,CAAA;CAChE,KAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAoCtC,CAAA"}

package/dist/v2/helpers/get-tab-details.js

@@ -0,0 +1,34 @@
+const o = ({
+  workspace: i,
+  document: e,
+  path: r,
+  method: n,
+  getEntryByLocation: l
+}) => {
+  if (!i)
+    return {
+      title: "Untitled Tab"
+    };
+  if (e) {
+    const t = l({
+      document: e,
+      path: r,
+      method: n
+    });
+    return t ? t.type === "document" ? {
+      title: t.title,
+      icon: "document"
+    } : {
+      title: t.title,
+      icon: "request"
+    } : {
+      title: "Untitled Tab"
+    };
+  }
+  return {
+    title: "Workspace"
+  };
+};
+export {
+  o as getTabDetails
+};

package/dist/v2/helpers/handle-hotkeys.js

@@ -2,7 +2,7 @@ import { isMacOS as f } from "@scalar/helpers/general/is-mac-os";
 const r = {
   Enter: { event: "operation:send:request", modifiers: ["default"] },
   b: { event: "ui:toggle:sidebar", modifiers: ["default"] },
-  k: { event: "ui:open:command-palette", modifiers: ["default"] },
+  p: { event: "ui:open:command-palette", modifiers: ["shiftKey"] },
   l: { event: "ui:focus:address-bar", modifiers: ["default"] }
 }, n = {
   web: r,

package/dist/v2/helpers/is-url.d.ts

@@ -0,0 +1,2 @@
+export declare const isUrl: (input: string) => boolean;
+//# sourceMappingURL=is-url.d.ts.map

package/dist/v2/helpers/is-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-url.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/is-url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,YAElC,CAAA"}

package/dist/v2/helpers/is-url.js

@@ -0,0 +1,5 @@
+import { isValidUrl as r } from "@scalar/helpers/url/is-valid-url";
+const h = (t) => (t.startsWith("http://") || t.startsWith("https://")) && r(t);
+export {
+  h as isUrl
+};

package/dist/v2/helpers/remove-circular.d.ts

@@ -0,0 +1,15 @@
+type RemoveCircularOptions = {
+    /** Prefix to add before the path in $ref values */
+    prefix?: string;
+};
+/**
+ * Recursively processes an object and replaces circular references with JSON Reference objects.
+ * When a circular reference is detected, it returns `{ $ref: "#/path/to/original" }`.
+ *
+ * @param obj - The object to process
+ * @param options - Configuration options
+ * @returns A new object with circular references replaced by $ref pointers
+ */
+export declare const removeCircular: <T>(obj: T, options?: RemoveCircularOptions) => T;
+export {};
+//# sourceMappingURL=remove-circular.d.ts.map

package/dist/v2/helpers/remove-circular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-circular.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/remove-circular.ts"],"names":[],"mappings":"AAAA,KAAK,qBAAqB,GAAG;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,UAAS,qBAA0B,KAAG,CAiC/E,CAAA"}

package/dist/v2/helpers/remove-circular.js

@@ -0,0 +1,18 @@
+const n = (a, i = {}) => {
+  const { prefix: $ = "" } = i, e = /* @__PURE__ */ new WeakMap(), s = (r, c = "") => {
+    if (typeof r != "object" || r === null)
+      return r;
+    if (e.has(r))
+      return { $ref: `#${$}${e.get(r)}` };
+    if (e.set(r, c), Array.isArray(r))
+      return r.map((t, f) => s(t, `${c}/${f}`));
+    const u = {};
+    for (const [t, f] of Object.entries(r))
+      u[t] = s(f, `${c}/${t}`);
+    return u;
+  };
+  return s(a);
+};
+export {
+  n as removeCircular
+};

package/dist/v2/helpers/storage.d.ts

@@ -12,14 +12,12 @@
  */
 export declare const workspaceStorage: {
     /**
-     * Retrieves the active workspace ID from localStorage.
-     * @returns {string | undefined} The currently active workspace ID, or undefined if not set.
+     * We keep the currently active path so we can reload it if needed
      */
-    readonly getActiveWorkspaceId: () => string | undefined;
+    readonly setCurrentPath: (path: string) => void;
     /**
-     * Stores the given workspace ID as the active workspace in localStorage.
-     * @param {string} id - The workspace ID to set as active.
+     * Retrieve the last active path
      */
-    readonly setActiveWorkspaceId: (id: string) => void;
+    readonly getLastPath: () => string | null;
 };
 //# sourceMappingURL=storage.d.ts.map

package/dist/v2/helpers/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/storage.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;;OAGG;yCACqB,MAAM,GAAG,SAAS;IAI1C;;;OAGG;wCACsB,MAAM,KAAG,IAAI;CAG9B,CAAA"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/v2/helpers/storage.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;oCACoB,MAAM,KAAG,IAAI;IAIpC;;OAEG;gCACc,MAAM,GAAG,IAAI;CAGtB,CAAA"}

package/dist/v2/helpers/storage.js

@@ -1,20 +1,16 @@
-import { safeLocalStorage as e } from "@scalar/helpers/object/local-storage";
-const t = "scalar.activeWorkspaceId", a = {
+import { safeLocalStorage as t } from "@scalar/helpers/object/local-storage";
+const e = "scalar.currentPath", o = {
   /**
-   * Retrieves the active workspace ID from localStorage.
-   * @returns {string | undefined} The currently active workspace ID, or undefined if not set.
+   * We keep the currently active path so we can reload it if needed
    */
-  getActiveWorkspaceId() {
-    return e().getItem(t) ?? void 0;
+  setCurrentPath: (r) => {
+    t().setItem(e, r);
   },
   /**
-   * Stores the given workspace ID as the active workspace in localStorage.
-   * @param {string} id - The workspace ID to set as active.
+   * Retrieve the last active path
    */
-  setActiveWorkspaceId(o) {
-    e().setItem(t, o);
-  }
+  getLastPath: () => t().getItem(e)
 };
 export {
-  a as workspaceStorage
+  o as workspaceStorage
 };