@scalar/workspace-store 0.14.2 → 0.15.0

package/dist/events/definitions.d.ts

@@ -0,0 +1,155 @@
+import type { AvailableClients } from '@scalar/snippetz';
+import type { Simplify } from 'type-fest';
+import type { ServerObject } from '../schemas/v3.1/strict/openapi-document.js';
+/**
+ * Event definitions for scalar blocks
+ *
+ * Events can have a typed payload using the `data` property.
+ */
+export type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject> = {
+    'scalar-update-sidebar': {
+        detail: {
+            value: boolean;
+        };
+    };
+    'scalar-update-dark-mode': {
+        detail: {
+            value: boolean;
+        };
+    };
+    'scalar-update-active-document': {
+        detail: {
+            value: string;
+        };
+    };
+    /** Controls the selected client in our code example blocks */
+    'scalar-update-selected-client': {
+        detail: AvailableClients[number];
+    };
+    /** Controls the selected example key in our operation blocks + children */
+    'scalar-update-selected-example': {
+        detail: string;
+    };
+    /** Controls the selected server URL in our server selector blocks */
+    'scalar-update-selected-server': {
+        detail: {
+            value?: string;
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    /** Controls the selected server URL in our server selector blocks */
+    'scalar-update-selected-server-variables': {
+        detail: {
+            key: string;
+            value: string;
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    'store-update-selected-server-properties': {
+        detail: {
+            key: T;
+            value: ServerObject[T];
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    /** Replace all document servers */
+    'scalar-replace-servers': {
+        detail: {
+            servers: ServerObject[];
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    /** Add a new server to the active document */
+    'scalar-add-server': {
+        detail: {
+            server: ServerObject;
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    /** Add a new server to the active document */
+    'scalar-delete-server': {
+        detail: {
+            url: string;
+            options?: {
+                /**
+                 * Update only new store
+                 *
+                 * Do not update the old store since it will be handled manually
+                 */
+                disableOldStoreUpdate: boolean;
+            };
+        };
+    };
+    /** Auth events */
+    'scalar-select-security-schemes': {
+        detail: {
+            uids: string[];
+        };
+    };
+    'scalar-select-operation-security-schemes': {
+        detail: {
+            operationUid: string;
+            uids: string[];
+        };
+    };
+    'scalar-edit-security-scheme': {
+        detail: {
+            uid: string;
+            path: string;
+            value: any;
+        };
+    };
+    'scalar-add-auth-option': {
+        detail: {
+            payload: any;
+        };
+    };
+    'scalar-delete-security-scheme': {
+        detail: {
+            uid: string;
+        };
+    };
+};
+export type ApiReferenceEvent = Simplify<keyof ApiReferenceEvents>;
+/**
+ * Scalar blocks will use vanilla events to allow more flexibility in integrations
+ *
+ * Event can include typed payloads using the `data` property. A target for the dispatch must be provided.
+ */
+export declare function emitCustomEvent<E extends ApiReferenceEvent>(target: HTMLElement | null | undefined, event: E, detail: ApiReferenceEvents[E]['detail']): void;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/events/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/events/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,YAAY,IAAI;IAClF,uBAAuB,EAAE;QACvB,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,CAAA;SACf,CAAA;KACF,CAAA;IACD,yBAAyB,EAAE;QACzB,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,CAAA;SACf,CAAA;KACF,CAAA;IACD,+BAA+B,EAAE;QAC/B,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAA;SACd,CAAA;KACF,CAAA;IACD,8DAA8D;IAC9D,+BAA+B,EAAE;QAC/B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;KACjC,CAAA;IACD,2EAA2E;IAC3E,gCAAgC,EAAE;QAChC,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,qEAAqE;IACrE,+BAA+B,EAAE;QAC/B,MAAM,EAAE;YACN,KAAK,CAAC,EAAE,MAAM,CAAA;YACd,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IACD,qEAAqE;IACrE,yCAAyC,EAAE;QACzC,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,CAAA;YACX,KAAK,EAAE,MAAM,CAAA;YACb,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IACD,yCAAyC,EAAE;QACzC,MAAM,EAAE;YACN,GAAG,EAAE,CAAC,CAAA;YACN,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;YACtB,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IACD,mCAAmC;IACnC,wBAAwB,EAAE;QACxB,MAAM,EAAE;YACN,OAAO,EAAE,YAAY,EAAE,CAAA;YACvB,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IACD,8CAA8C;IAC9C,mBAAmB,EAAE;QACnB,MAAM,EAAE;YACN,MAAM,EAAE,YAAY,CAAA;YACpB,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IACD,8CAA8C;IAC9C,sBAAsB,EAAE;QACtB,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,CAAA;YACX,OAAO,CAAC,EAAE;gBACR;;;;mBAIG;gBACH,qBAAqB,EAAE,OAAO,CAAA;aAC/B,CAAA;SACF,CAAA;KACF,CAAA;IAED,kBAAkB;IAClB,gCAAgC,EAAE;QAChC,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,EAAE,CAAA;SACf,CAAA;KACF,CAAA;IAED,0CAA0C,EAAE;QAC1C,MAAM,EAAE;YACN,YAAY,EAAE,MAAM,CAAA;YACpB,IAAI,EAAE,MAAM,EAAE,CAAA;SACf,CAAA;KACF,CAAA;IAED,6BAA6B,EAAE;QAC7B,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,CAAA;YACX,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,GAAG,CAAA;SACX,CAAA;KACF,CAAA;IAED,wBAAwB,EAAE;QACxB,MAAM,EAAE;YACN,OAAO,EAAE,GAAG,CAAA;SACb,CAAA;KACF,CAAA;IAED,+BAA+B,EAAE;QAC/B,MAAM,EAAE;YACN,GAAG,EAAE,MAAM,CAAA;SACZ,CAAA;KACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAA;AAElE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,iBAAiB,EACzD,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACtC,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAUxC"}

package/dist/events/definitions.js

@@ -0,0 +1,13 @@
+function emitCustomEvent(target, event, detail) {
+  const instance = new CustomEvent(event, {
+    detail,
+    bubbles: true,
+    composed: true,
+    cancelable: true
+  });
+  target?.dispatchEvent(instance);
+}
+export {
+  emitCustomEvent
+};
+//# sourceMappingURL=definitions.js.map

package/dist/events/definitions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/events/definitions.ts"],
+  "sourcesContent": ["import type { AvailableClients } from '@scalar/snippetz'\nimport type { Simplify } from 'type-fest'\n\nimport type { ServerObject } from '@/schemas/v3.1/strict/openapi-document'\n\n/**\n * Event definitions for scalar blocks\n *\n * Events can have a typed payload using the `data` property.\n */\nexport type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject> = {\n  'scalar-update-sidebar': {\n    detail: {\n      value: boolean\n    }\n  }\n  'scalar-update-dark-mode': {\n    detail: {\n      value: boolean\n    }\n  }\n  'scalar-update-active-document': {\n    detail: {\n      value: string\n    }\n  }\n  /** Controls the selected client in our code example blocks */\n  'scalar-update-selected-client': {\n    detail: AvailableClients[number]\n  }\n  /** Controls the selected example key in our operation blocks + children */\n  'scalar-update-selected-example': {\n    detail: string\n  }\n  /** Controls the selected server URL in our server selector blocks */\n  'scalar-update-selected-server': {\n    detail: {\n      value?: string\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n  /** Controls the selected server URL in our server selector blocks */\n  'scalar-update-selected-server-variables': {\n    detail: {\n      key: string\n      value: string\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n  'store-update-selected-server-properties': {\n    detail: {\n      key: T\n      value: ServerObject[T]\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n  /** Replace all document servers */\n  'scalar-replace-servers': {\n    detail: {\n      servers: ServerObject[]\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n  /** Add a new server to the active document */\n  'scalar-add-server': {\n    detail: {\n      server: ServerObject\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n  /** Add a new server to the active document */\n  'scalar-delete-server': {\n    detail: {\n      url: string\n      options?: {\n        /**\n         * Update only new store\n         *\n         * Do not update the old store since it will be handled manually\n         */\n        disableOldStoreUpdate: boolean\n      }\n    }\n  }\n\n  /** Auth events */\n  'scalar-select-security-schemes': {\n    detail: {\n      uids: string[]\n    }\n  }\n\n  'scalar-select-operation-security-schemes': {\n    detail: {\n      operationUid: string\n      uids: string[]\n    }\n  }\n\n  'scalar-edit-security-scheme': {\n    detail: {\n      uid: string\n      path: string\n      value: any\n    }\n  }\n\n  'scalar-add-auth-option': {\n    detail: {\n      payload: any\n    }\n  }\n\n  'scalar-delete-security-scheme': {\n    detail: {\n      uid: string\n    }\n  }\n}\n\nexport type ApiReferenceEvent = Simplify<keyof ApiReferenceEvents>\n\n/**\n * Scalar blocks will use vanilla events to allow more flexibility in integrations\n *\n * Event can include typed payloads using the `data` property. A target for the dispatch must be provided.\n */\nexport function emitCustomEvent<E extends ApiReferenceEvent>(\n  target: HTMLElement | null | undefined,\n  event: E,\n  detail: ApiReferenceEvents[E]['detail'],\n) {\n  const instance = new CustomEvent(event, {\n    detail: detail,\n    bubbles: true,\n    composed: true,\n    cancelable: true,\n  })\n\n  target?.dispatchEvent(instance)\n}\n"],
+  "mappings": "AAkKO,SAAS,gBACd,QACA,OACA,QACA;AACA,QAAM,WAAW,IAAI,YAAY,OAAO;AAAA,IACtC;AAAA,IACA,SAAS;AAAA,IACT,UAAU;AAAA,IACV,YAAY;AAAA,EACd,CAAC;AAED,UAAQ,cAAc,QAAQ;AAChC;",
+  "names": []
+}

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export { type ApiReferenceEvent, type ApiReferenceEvents, emitCustomEvent } from './definitions.js';
+export { onCustomEvent } from './listeners.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/events/index.js

@@ -0,0 +1,7 @@
+import { emitCustomEvent } from "./definitions.js";
+import { onCustomEvent } from "./listeners.js";
+export {
+  emitCustomEvent,
+  onCustomEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/events/index.ts"],
+  "sourcesContent": ["// biome-ignore lint/performance/noBarrelFile: Entry point for /events\nexport { type ApiReferenceEvent, type ApiReferenceEvents, emitCustomEvent } from './definitions'\nexport { onCustomEvent } from './listeners'\n"],
+  "mappings": "AACA,SAA0D,uBAAuB;AACjF,SAAS,qBAAqB;",
+  "names": []
+}

package/dist/events/listeners.d.ts

@@ -0,0 +1,8 @@
+import { type Ref } from 'vue';
+import type { ApiReferenceEvent, ApiReferenceEvents } from './definitions.js';
+/**
+ * Vue wrapper for attaching and removing event listeners
+ *
+ */
+export declare function onCustomEvent<E extends ApiReferenceEvent>(el: Ref<HTMLElement | null>, event: E, handler: (event: CustomEvent<ApiReferenceEvents[E]['detail']>) => void): void;
+//# sourceMappingURL=listeners.d.ts.map

package/dist/events/listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../../src/events/listeners.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAA0B,MAAM,KAAK,CAAA;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAE1E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvD,EAAE,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,QAsBvE"}

package/dist/events/listeners.js

@@ -0,0 +1,23 @@
+import { onBeforeUnmount, watch } from "vue";
+function onCustomEvent(el, event, handler) {
+  watch(
+    () => el.value,
+    (element) => {
+      if (!element) {
+        return;
+      }
+      element.addEventListener(event, handler);
+    },
+    { immediate: true }
+  );
+  onBeforeUnmount(() => {
+    if (!el.value) {
+      return;
+    }
+    el.value.removeEventListener(event, handler);
+  });
+}
+export {
+  onCustomEvent
+};
+//# sourceMappingURL=listeners.js.map

package/dist/events/listeners.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/events/listeners.ts"],
+  "sourcesContent": ["import { type Ref, onBeforeUnmount, watch } from 'vue'\n\nimport type { ApiReferenceEvent, ApiReferenceEvents } from './definitions'\n\n/**\n * Vue wrapper for attaching and removing event listeners\n *\n */\nexport function onCustomEvent<E extends ApiReferenceEvent>(\n  el: Ref<HTMLElement | null>,\n  event: E,\n  handler: (event: CustomEvent<ApiReferenceEvents[E]['detail']>) => void,\n) {\n  // Any time the element reference changes, we need to add the event listener\n  watch(\n    () => el.value,\n    (element) => {\n      if (!element) {\n        return\n      }\n\n      element.addEventListener(event, handler as any)\n    },\n    { immediate: true },\n  )\n\n  onBeforeUnmount(() => {\n    if (!el.value) {\n      return\n    }\n\n    el.value.removeEventListener(event, handler as any)\n  })\n}\n"],
+  "mappings": "AAAA,SAAmB,iBAAiB,aAAa;AAQ1C,SAAS,cACd,IACA,OACA,SACA;AAEA;AAAA,IACE,MAAM,GAAG;AAAA,IACT,CAAC,YAAY;AACX,UAAI,CAAC,SAAS;AACZ;AAAA,MACF;AAEA,cAAQ,iBAAiB,OAAO,OAAc;AAAA,IAChD;AAAA,IACA,EAAE,WAAW,KAAK;AAAA,EACpB;AAEA,kBAAgB,MAAM;AACpB,QAAI,CAAC,GAAG,OAAO;AACb;AAAA,IACF;AAEA,OAAG,MAAM,oBAAoB,OAAO,OAAc;AAAA,EACpD,CAAC;AACH;",
+  "names": []
+}

package/dist/helpers/apply-selective-updates.d.ts

@@ -1,5 +1,5 @@
-import { type UnknownObject } from '../helpers/general.js';
 import { type Difference } from '@scalar/json-magic/diff';
+import { type UnknownObject } from '../helpers/general.js';
 /**
  * Applies updates from an updated document to an original document, while excluding changes to certain metadata keys.
  *

package/dist/helpers/apply-selective-updates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-selective-updates.d.ts","sourceRoot":"","sources":["../../src/helpers/apply-selective-updates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAMtE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,qBAAsB,aAAa,mBAAmB,aAAa,8CAQpG,CAAA"}
+{"version":3,"file":"apply-selective-updates.d.ts","sourceRoot":"","sources":["../../src/helpers/apply-selective-updates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,yBAAyB,CAAA;AAEtE,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,mBAAmB,CAAA;AAM7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAI,kBAAkB,aAAa,EAAE,iBAAiB,aAAa,8CAQpG,CAAA"}

package/dist/helpers/apply-selective-updates.js

@@ -1,5 +1,5 @@
-import { split } from "../helpers/general.js";
 import { apply, diff } from "@scalar/json-magic/diff";
+import { split } from "../helpers/general.js";
 const excludeKeys = /* @__PURE__ */ new Set(["x-scalar-navigation", "x-ext", "x-ext-urls", "$status"]);
 const applySelectiveUpdates = (originalDocument, updatedDocument) => {
   const diffs = diff(originalDocument, updatedDocument);

package/dist/helpers/apply-selective-updates.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/helpers/apply-selective-updates.ts"],
-  "sourcesContent": ["import { split, type UnknownObject } from '@/helpers/general'\nimport { apply, diff, type Difference } from '@scalar/json-magic/diff'\n\n// Keys to exclude from the diff - these are metadata fields that should not be persisted\n// when applying updates to the original document\nconst excludeKeys = new Set(['x-scalar-navigation', 'x-ext', 'x-ext-urls', '$status'])\n\n/**\n * Applies updates from an updated document to an original document, while excluding changes to certain metadata keys.\n *\n * This function computes the differences between the original and updated documents,\n * filters out any diffs that affect excluded keys (such as navigation, external references, or status fields),\n * and applies only the allowed changes to the original document in place.\n *\n * Note: The originalDocument is mutated directly.\n *\n * @param originalDocument - The document to be updated (mutated in place)\n * @param updatedDocument - The document containing the desired changes\n * @returns A tuple: [the updated original document, array of excluded diffs that were not applied]\n */\nexport const applySelectiveUpdates = (originalDocument: UnknownObject, updatedDocument: UnknownObject) => {\n  const diffs: Difference<unknown>[] = diff(originalDocument, updatedDocument)\n\n  const [writableDiffs, excludedDiffs] = split(diffs, (d) => !d.path.some((p) => excludeKeys.has(p)))\n\n  apply(originalDocument, writableDiffs)\n\n  return [originalDocument, excludedDiffs]\n}\n"],
-  "mappings": "AAAA,SAAS,aAAiC;AAC1C,SAAS,OAAO,YAA6B;AAI7C,MAAM,cAAc,oBAAI,IAAI,CAAC,uBAAuB,SAAS,cAAc,SAAS,CAAC;AAe9E,MAAM,wBAAwB,CAAC,kBAAiC,oBAAmC;AACxG,QAAM,QAA+B,KAAK,kBAAkB,eAAe;AAE3E,QAAM,CAAC,eAAe,aAAa,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC,CAAC;AAElG,QAAM,kBAAkB,aAAa;AAErC,SAAO,CAAC,kBAAkB,aAAa;AACzC;",
+  "sourcesContent": ["import { type Difference, apply, diff } from '@scalar/json-magic/diff'\n\nimport { type UnknownObject, split } from '@/helpers/general'\n\n// Keys to exclude from the diff - these are metadata fields that should not be persisted\n// when applying updates to the original document\nconst excludeKeys = new Set(['x-scalar-navigation', 'x-ext', 'x-ext-urls', '$status'])\n\n/**\n * Applies updates from an updated document to an original document, while excluding changes to certain metadata keys.\n *\n * This function computes the differences between the original and updated documents,\n * filters out any diffs that affect excluded keys (such as navigation, external references, or status fields),\n * and applies only the allowed changes to the original document in place.\n *\n * Note: The originalDocument is mutated directly.\n *\n * @param originalDocument - The document to be updated (mutated in place)\n * @param updatedDocument - The document containing the desired changes\n * @returns A tuple: [the updated original document, array of excluded diffs that were not applied]\n */\nexport const applySelectiveUpdates = (originalDocument: UnknownObject, updatedDocument: UnknownObject) => {\n  const diffs: Difference<unknown>[] = diff(originalDocument, updatedDocument)\n\n  const [writableDiffs, excludedDiffs] = split(diffs, (d) => !d.path.some((p) => excludeKeys.has(p)))\n\n  apply(originalDocument, writableDiffs)\n\n  return [originalDocument, excludedDiffs]\n}\n"],
+  "mappings": "AAAA,SAA0B,OAAO,YAAY;AAE7C,SAA6B,aAAa;AAI1C,MAAM,cAAc,oBAAI,IAAI,CAAC,uBAAuB,SAAS,cAAc,SAAS,CAAC;AAe9E,MAAM,wBAAwB,CAAC,kBAAiC,oBAAmC;AACxG,QAAM,QAA+B,KAAK,kBAAkB,eAAe;AAE3E,QAAM,CAAC,eAAe,aAAa,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC,CAAC;AAElG,QAAM,kBAAkB,aAAa;AAErC,SAAO,CAAC,kBAAkB,aAAa;AACzC;",
   "names": []
 }

package/dist/helpers/deep-clone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-clone.d.ts","sourceRoot":"","sources":["../../src/helpers/deep-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,kCAAyB,CAkB7D,CAAA"}
+{"version":3,"file":"deep-clone.d.ts","sourceRoot":"","sources":["../../src/helpers/deep-clone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,2BAAoB,KAAG,CAkB7D,CAAA"}

package/dist/helpers/general.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/helpers/general.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAClC,CAAC,MAAM,CAAC,CAAC,EAAE,CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,CAAC,KAAG,CAEvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,eAOtE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,SAE1F,CAAA"}
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/helpers/general.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAClC,CAAC,MAAM,CAAC,CAAC,EAAE,CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAEvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,eAOtE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,SAE1F,CAAA"}

package/dist/helpers/get-resolved-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-resolved-ref.d.ts","sourceRoot":"","sources":["../../src/helpers/get-resolved-ref.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,IAAI,CAAA;CAAE,CAAA;AAChF,MAAM,MAAM,SAAS,CAAC,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAMlD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,QAC3B,SAAS,CAAC,IAAI,CAAC,cACV,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,SAOzC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA"}
+{"version":3,"file":"get-resolved-ref.d.ts","sourceRoot":"","sources":["../../src/helpers/get-resolved-ref.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,IAAI,CAAA;CAAE,CAAA;AAChF,MAAM,MAAM,SAAS,CAAC,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAMlD;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EACjC,MAAM,SAAS,CAAC,IAAI,CAAC,EACrB,YAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAuB,SAO5D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA"}

package/dist/helpers/merge-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge-object.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-object.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,KACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACnB,GAAG,CAAC,OAAO,CAAC,KAClB,CA8BF,CAAA"}
+{"version":3,"file":"merge-object.d.ts","sourceRoot":"","sources":["../../src/helpers/merge-object.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAC5B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1B,QAAO,GAAG,CAAC,OAAO,CAAa,KAC9B,CA8BF,CAAA"}

package/dist/helpers/merge-object.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/helpers/merge-object.ts"],
-  "sourcesContent": ["import type { UnknownObject } from '@/helpers/general'\nimport { getRaw } from '@scalar/json-magic/magic-proxy'\n\n/**\n * Deep merges two objects, combining their properties recursively.\n * Handles circular references by tracking visited objects to prevent infinite recursion.\n *\n * \u26A0\uFE0F Note: This operation assumes there are no key collisions between the objects.\n * Use isKeyCollisions() to check for collisions before merging.\n *\n * @param a - Target object to merge into\n * @param b - Source object to merge from\n * @param cache - Set of visited objects to prevent circular reference issues\n * @returns The merged object (mutates and returns a)\n *\n * @example\n * // Simple merge\n * const a = { name: 'John' }\n * const b = { age: 30 }\n * mergeObjects(a, b) // { name: 'John', age: 30 }\n *\n * // Nested merge\n * const a = { user: { name: 'John' } }\n * const b = { user: { age: 30 } }\n * mergeObjects(a, b) // { user: { name: 'John', age: 30 } }\n *\n * // Circular reference safe\n * const obj = { name: 'John' }\n * obj.self = obj\n * const target = { age: 30 }\n * mergeObjects(target, obj) // Safely merges without infinite recursion\n */\nexport const mergeObjects = <R>(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n  cache: Set<unknown> = new Set(),\n): R => {\n  for (const key in b) {\n    if (!(key in a)) {\n      a[key] = b[key]\n    } else {\n      const aValue = a[key]\n      const bValue = b[key]\n\n      if (typeof aValue === 'object' && aValue !== null && typeof bValue === 'object' && bValue !== null) {\n        const rawA = getRaw(aValue as UnknownObject)\n        const rawB = getRaw(bValue as UnknownObject)\n\n        // Check for circular references before recursive merge\n        if (cache.has(rawA) || cache.has(rawB)) {\n          // Skip merging this branch to prevent infinite recursion\n          continue\n        }\n\n        // Add objects to cache before recursive call\n        cache.add(rawA)\n        cache.add(rawB)\n\n        mergeObjects(aValue as Record<string, unknown>, bValue as Record<string, unknown>, cache)\n      } else {\n        a[key] = bValue // Overwrite with b's value if not an object\n      }\n    }\n  }\n\n  return a as R\n}\n"],
-  "mappings": "AACA,SAAS,cAAc;AA+BhB,MAAM,eAAe,CAC1B,GACA,GACA,QAAsB,oBAAI,IAAI,MACxB;AACN,aAAW,OAAO,GAAG;AACnB,QAAI,EAAE,OAAO,IAAI;AACf,QAAE,GAAG,IAAI,EAAE,GAAG;AAAA,IAChB,OAAO;AACL,YAAM,SAAS,EAAE,GAAG;AACpB,YAAM,SAAS,EAAE,GAAG;AAEpB,UAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,OAAO,WAAW,YAAY,WAAW,MAAM;AAClG,cAAM,OAAO,OAAO,MAAuB;AAC3C,cAAM,OAAO,OAAO,MAAuB;AAG3C,YAAI,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,GAAG;AAEtC;AAAA,QACF;AAGA,cAAM,IAAI,IAAI;AACd,cAAM,IAAI,IAAI;AAEd,qBAAa,QAAmC,QAAmC,KAAK;AAAA,MAC1F,OAAO;AACL,UAAE,GAAG,IAAI;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { getRaw } from '@scalar/json-magic/magic-proxy'\n\nimport type { UnknownObject } from '@/helpers/general'\n\n/**\n * Deep merges two objects, combining their properties recursively.\n * Handles circular references by tracking visited objects to prevent infinite recursion.\n *\n * \u26A0\uFE0F Note: This operation assumes there are no key collisions between the objects.\n * Use isKeyCollisions() to check for collisions before merging.\n *\n * @param a - Target object to merge into\n * @param b - Source object to merge from\n * @param cache - Set of visited objects to prevent circular reference issues\n * @returns The merged object (mutates and returns a)\n *\n * @example\n * // Simple merge\n * const a = { name: 'John' }\n * const b = { age: 30 }\n * mergeObjects(a, b) // { name: 'John', age: 30 }\n *\n * // Nested merge\n * const a = { user: { name: 'John' } }\n * const b = { user: { age: 30 } }\n * mergeObjects(a, b) // { user: { name: 'John', age: 30 } }\n *\n * // Circular reference safe\n * const obj = { name: 'John' }\n * obj.self = obj\n * const target = { age: 30 }\n * mergeObjects(target, obj) // Safely merges without infinite recursion\n */\nexport const mergeObjects = <R>(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n  cache: Set<unknown> = new Set(),\n): R => {\n  for (const key in b) {\n    if (!(key in a)) {\n      a[key] = b[key]\n    } else {\n      const aValue = a[key]\n      const bValue = b[key]\n\n      if (typeof aValue === 'object' && aValue !== null && typeof bValue === 'object' && bValue !== null) {\n        const rawA = getRaw(aValue as UnknownObject)\n        const rawB = getRaw(bValue as UnknownObject)\n\n        // Check for circular references before recursive merge\n        if (cache.has(rawA) || cache.has(rawB)) {\n          // Skip merging this branch to prevent infinite recursion\n          continue\n        }\n\n        // Add objects to cache before recursive call\n        cache.add(rawA)\n        cache.add(rawB)\n\n        mergeObjects(aValue as Record<string, unknown>, bValue as Record<string, unknown>, cache)\n      } else {\n        a[key] = bValue // Overwrite with b's value if not an object\n      }\n    }\n  }\n\n  return a as R\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAiChB,MAAM,eAAe,CAC1B,GACA,GACA,QAAsB,oBAAI,IAAI,MACxB;AACN,aAAW,OAAO,GAAG;AACnB,QAAI,EAAE,OAAO,IAAI;AACf,QAAE,GAAG,IAAI,EAAE,GAAG;AAAA,IAChB,OAAO;AACL,YAAM,SAAS,EAAE,GAAG;AACpB,YAAM,SAAS,EAAE,GAAG;AAEpB,UAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,OAAO,WAAW,YAAY,WAAW,MAAM;AAClG,cAAM,OAAO,OAAO,MAAuB;AAC3C,cAAM,OAAO,OAAO,MAAuB;AAG3C,YAAI,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,GAAG;AAEtC;AAAA,QACF;AAGA,cAAM,IAAI,IAAI;AACd,cAAM,IAAI,IAAI;AAEd,qBAAa,QAAmC,QAAmC,KAAK;AAAA,MAC1F,OAAO;AACL,UAAE,GAAG,IAAI;AAAA,MACX;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/helpers/overrides-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overrides-proxy.d.ts","sourceRoot":"","sources":["../../src/helpers/overrides-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAIhE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,CAAA;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,gBACtD,CAAC,cACH,WAAW,CAAC,CAAC,CAAC,KACzB,CAkDF,CAAA;AAED,eAAO,MAAM,aAAa,eAAiC,CAAA;AAC3D,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAMvE"}
+{"version":3,"file":"overrides-proxy.d.ts","sourceRoot":"","sources":["../../src/helpers/overrides-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,mBAAmB,CAAA;AAIhE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,CAAA;AAE1F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,cAAc,CAAC,EACf,YAAY,WAAW,CAAC,CAAC,CAAC,KACzB,CAkDF,CAAA;AAED,eAAO,MAAM,aAAa,eAAiC,CAAA;AAC3D,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAMvE"}

package/dist/helpers/overrides-proxy.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/helpers/overrides-proxy.ts"],
-  "sourcesContent": ["import { isObject, type UnknownObject } from '@/helpers/general'\n\nconst isOverridesProxy = Symbol('isOverridesProxy')\n\n/**\n * Recursively makes all properties of a type optional.\n *\n * - If T is an object, recursively applies DeepPartial to each property, making them optional.\n * - Otherwise, T is returned as-is.\n *\n * @template T - The type to make deeply partial (optional).\n * @example\n * type Example = { a: { b: number } }\n * type PartialExample = DeepPartial<Example>\n * // Result: { a?: { b?: number } }\n */\nexport type DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T\n\n/**\n * Creates a proxy object that overlays \"overrides\" on top of a target object.\n *\n * - When reading a property, if an override exists, it is returned; otherwise, the original value is returned.\n * - When writing to a property, if an override exists, it is updated; otherwise, the original object is updated.\n * - This works recursively for nested objects, so overrides can be deeply partial.\n * - Special symbols are used to identify the proxy and to access the original target.\n *\n * @template T - The type of the target object.\n * @param targetObject - The original object to proxy.\n * @param overrides - An optional object containing override values (deeply partial).\n * @returns A proxy object that reflects overrides on top of the target.\n *\n * @example\n * const original = { a: 1, b: { c: 2 } }\n * const overrides = { b: { c: 42 } }\n * const proxy = createOverridesProxy(original, overrides)\n *\n * console.log(proxy.a) // 1 (from original)\n * console.log(proxy.b.c) // 42 (from overrides)\n *\n * proxy.a = 100\n * console.log(original.a) // 100\n *\n * proxy.b.c = 99\n * console.log(overrides.b.c) // 99\n */\nexport const createOverridesProxy = <T extends Record<string, unknown>>(\n  targetObject: T,\n  overrides?: DeepPartial<T>,\n): T => {\n  if (!targetObject || typeof targetObject !== 'object') {\n    return targetObject\n  }\n\n  // Proxy handler to intercept get/set operations\n  const handler: ProxyHandler<T> = {\n    get(target, prop, receiver) {\n      // Special symbol to identify this as an overrides proxy\n      if (prop === isOverridesProxy) {\n        return true\n      }\n\n      // Special symbol to access the original target object\n      if (prop === TARGET_SYMBOL) {\n        return target\n      }\n\n      const value = Reflect.get(target, prop, receiver)\n\n      // If the value is not an object, return the override if it exists, else the original value\n      if (!isObject(value)) {\n        return Reflect.get(overrides ?? {}, prop) ?? value\n      }\n\n      // For nested objects, recursively create a proxy with the corresponding overrides\n      return createOverridesProxy(value, Reflect.get(overrides ?? {}, prop))\n    },\n\n    set(target, prop, value, receiver) {\n      // Prevent setting special symbols\n      if (prop === isOverridesProxy || prop === TARGET_SYMBOL) {\n        return false\n      }\n\n      // If an override exists for this property, update it\n      const hasOverride = overrides && Reflect.has(overrides, prop)\n\n      if (hasOverride && overrides && typeof overrides === 'object') {\n        ;(overrides as any)[prop] = value\n        return true\n      }\n\n      // Otherwise, update the original target\n      return Reflect.set(target, prop, value, receiver)\n    },\n  }\n\n  // Return the proxy object\n  return new Proxy<T>(targetObject, handler)\n}\n\nexport const TARGET_SYMBOL = Symbol('overridesProxyTarget')\nexport function unpackOverridesProxy<T extends UnknownObject>(obj: T): T {\n  if ((obj as T & { [isOverridesProxy]: boolean | undefined })[isOverridesProxy]) {\n    return (obj as T & { [TARGET_SYMBOL]: T })[TARGET_SYMBOL]\n  }\n\n  return obj\n}\n"],
-  "mappings": "AAAA,SAAS,gBAAoC;AAE7C,MAAM,mBAAmB,OAAO,kBAAkB;AA2C3C,MAAM,uBAAuB,CAClC,cACA,cACM;AACN,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAAU;AACrD,WAAO;AAAA,EACT;AAGA,QAAM,UAA2B;AAAA,IAC/B,IAAI,QAAQ,MAAM,UAAU;AAE1B,UAAI,SAAS,kBAAkB;AAC7B,eAAO;AAAA,MACT;AAGA,UAAI,SAAS,eAAe;AAC1B,eAAO;AAAA,MACT;AAEA,YAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,QAAQ;AAGhD,UAAI,CAAC,SAAS,KAAK,GAAG;AACpB,eAAO,QAAQ,IAAI,aAAa,CAAC,GAAG,IAAI,KAAK;AAAA,MAC/C;AAGA,aAAO,qBAAqB,OAAO,QAAQ,IAAI,aAAa,CAAC,GAAG,IAAI,CAAC;AAAA,IACvE;AAAA,IAEA,IAAI,QAAQ,MAAM,OAAO,UAAU;AAEjC,UAAI,SAAS,oBAAoB,SAAS,eAAe;AACvD,eAAO;AAAA,MACT;AAGA,YAAM,cAAc,aAAa,QAAQ,IAAI,WAAW,IAAI;AAE5D,UAAI,eAAe,aAAa,OAAO,cAAc,UAAU;AAC7D;AAAC,QAAC,UAAkB,IAAI,IAAI;AAC5B,eAAO;AAAA,MACT;AAGA,aAAO,QAAQ,IAAI,QAAQ,MAAM,OAAO,QAAQ;AAAA,IAClD;AAAA,EACF;AAGA,SAAO,IAAI,MAAS,cAAc,OAAO;AAC3C;AAEO,MAAM,gBAAgB,OAAO,sBAAsB;AACnD,SAAS,qBAA8C,KAAW;AACvE,MAAK,IAAwD,gBAAgB,GAAG;AAC9E,WAAQ,IAAmC,aAAa;AAAA,EAC1D;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { type UnknownObject, isObject } from '@/helpers/general'\n\nconst isOverridesProxy = Symbol('isOverridesProxy')\n\n/**\n * Recursively makes all properties of a type optional.\n *\n * - If T is an object, recursively applies DeepPartial to each property, making them optional.\n * - Otherwise, T is returned as-is.\n *\n * @template T - The type to make deeply partial (optional).\n * @example\n * type Example = { a: { b: number } }\n * type PartialExample = DeepPartial<Example>\n * // Result: { a?: { b?: number } }\n */\nexport type DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T\n\n/**\n * Creates a proxy object that overlays \"overrides\" on top of a target object.\n *\n * - When reading a property, if an override exists, it is returned; otherwise, the original value is returned.\n * - When writing to a property, if an override exists, it is updated; otherwise, the original object is updated.\n * - This works recursively for nested objects, so overrides can be deeply partial.\n * - Special symbols are used to identify the proxy and to access the original target.\n *\n * @template T - The type of the target object.\n * @param targetObject - The original object to proxy.\n * @param overrides - An optional object containing override values (deeply partial).\n * @returns A proxy object that reflects overrides on top of the target.\n *\n * @example\n * const original = { a: 1, b: { c: 2 } }\n * const overrides = { b: { c: 42 } }\n * const proxy = createOverridesProxy(original, overrides)\n *\n * console.log(proxy.a) // 1 (from original)\n * console.log(proxy.b.c) // 42 (from overrides)\n *\n * proxy.a = 100\n * console.log(original.a) // 100\n *\n * proxy.b.c = 99\n * console.log(overrides.b.c) // 99\n */\nexport const createOverridesProxy = <T extends Record<string, unknown>>(\n  targetObject: T,\n  overrides?: DeepPartial<T>,\n): T => {\n  if (!targetObject || typeof targetObject !== 'object') {\n    return targetObject\n  }\n\n  // Proxy handler to intercept get/set operations\n  const handler: ProxyHandler<T> = {\n    get(target, prop, receiver) {\n      // Special symbol to identify this as an overrides proxy\n      if (prop === isOverridesProxy) {\n        return true\n      }\n\n      // Special symbol to access the original target object\n      if (prop === TARGET_SYMBOL) {\n        return target\n      }\n\n      const value = Reflect.get(target, prop, receiver)\n\n      // If the value is not an object, return the override if it exists, else the original value\n      if (!isObject(value)) {\n        return Reflect.get(overrides ?? {}, prop) ?? value\n      }\n\n      // For nested objects, recursively create a proxy with the corresponding overrides\n      return createOverridesProxy(value, Reflect.get(overrides ?? {}, prop))\n    },\n\n    set(target, prop, value, receiver) {\n      // Prevent setting special symbols\n      if (prop === isOverridesProxy || prop === TARGET_SYMBOL) {\n        return false\n      }\n\n      // If an override exists for this property, update it\n      const hasOverride = overrides && Reflect.has(overrides, prop)\n\n      if (hasOverride && overrides && typeof overrides === 'object') {\n        ;(overrides as any)[prop] = value\n        return true\n      }\n\n      // Otherwise, update the original target\n      return Reflect.set(target, prop, value, receiver)\n    },\n  }\n\n  // Return the proxy object\n  return new Proxy<T>(targetObject, handler)\n}\n\nexport const TARGET_SYMBOL = Symbol('overridesProxyTarget')\nexport function unpackOverridesProxy<T extends UnknownObject>(obj: T): T {\n  if ((obj as T & { [isOverridesProxy]: boolean | undefined })[isOverridesProxy]) {\n    return (obj as T & { [TARGET_SYMBOL]: T })[TARGET_SYMBOL]\n  }\n\n  return obj\n}\n"],
+  "mappings": "AAAA,SAA6B,gBAAgB;AAE7C,MAAM,mBAAmB,OAAO,kBAAkB;AA2C3C,MAAM,uBAAuB,CAClC,cACA,cACM;AACN,MAAI,CAAC,gBAAgB,OAAO,iBAAiB,UAAU;AACrD,WAAO;AAAA,EACT;AAGA,QAAM,UAA2B;AAAA,IAC/B,IAAI,QAAQ,MAAM,UAAU;AAE1B,UAAI,SAAS,kBAAkB;AAC7B,eAAO;AAAA,MACT;AAGA,UAAI,SAAS,eAAe;AAC1B,eAAO;AAAA,MACT;AAEA,YAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,QAAQ;AAGhD,UAAI,CAAC,SAAS,KAAK,GAAG;AACpB,eAAO,QAAQ,IAAI,aAAa,CAAC,GAAG,IAAI,KAAK;AAAA,MAC/C;AAGA,aAAO,qBAAqB,OAAO,QAAQ,IAAI,aAAa,CAAC,GAAG,IAAI,CAAC;AAAA,IACvE;AAAA,IAEA,IAAI,QAAQ,MAAM,OAAO,UAAU;AAEjC,UAAI,SAAS,oBAAoB,SAAS,eAAe;AACvD,eAAO;AAAA,MACT;AAGA,YAAM,cAAc,aAAa,QAAQ,IAAI,WAAW,IAAI;AAE5D,UAAI,eAAe,aAAa,OAAO,cAAc,UAAU;AAC7D;AAAC,QAAC,UAAkB,IAAI,IAAI;AAC5B,eAAO;AAAA,MACT;AAGA,aAAO,QAAQ,IAAI,QAAQ,MAAM,OAAO,QAAQ;AAAA,IAClD;AAAA,EACF;AAGA,SAAO,IAAI,MAAS,cAAc,OAAO;AAC3C;AAEO,MAAM,gBAAgB,OAAO,sBAAsB;AACnD,SAAS,qBAA8C,KAAW;AACvE,MAAK,IAAwD,gBAAgB,GAAG;AAC9E,WAAQ,IAAmC,aAAa;AAAA,EAC1D;AAEA,SAAO;AACT;",
   "names": []
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/mutators/cookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,+EAA+E,CAAA;AAEtF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,cACd,aAAa,GAAG;IAAE,gCAAgC,CAAC,EAAE,0BAA0B,CAAA;CAAE;wBAwBjE,yBAAyB;+BA+BlB,MAAM;CAazC,CAAA"}
+{"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/mutators/cookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,+EAA+E,CAAA;AAEtF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,WAAW,aAAa,GAAG;IAAE,gCAAgC,CAAC,EAAE,0BAA0B,CAAA;CAAE;wBAwBjE,yBAAyB;+BA+BlB,MAAM;CAazC,CAAA"}

package/dist/mutators/environment.d.ts

@@ -1,5 +1,5 @@
 import type { UnknownObject } from '../helpers/general.js';
-import type { xScalarClientConfigEnvironment, XScalarClientConfigEnvironments } from '../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js';
+import type { XScalarClientConfigEnvironments, xScalarClientConfigEnvironment } from '../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js';
 /**
  * Environment mutators for managing client configuration environments in OpenAPI documents.
  * Provides functions to add and delete environments from the document's x-scalar-client-config-environments extension.

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

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/mutators/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAChC,MAAM,oFAAoF,CAAA;AAE3F;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,cACnB,aAAa,GAAG;IAAE,qCAAqC,CAAC,EAAE,+BAA+B,CAAA;CAAE;2BAsBxE,MAAM,eAAe,8BAA8B;yCA6BrC,MAAM;CAanD,CAAA"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/mutators/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,oFAAoF,CAAA;AAE3F;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,aAAa,GAAG;IAAE,qCAAqC,CAAC,EAAE,+BAA+B,CAAA;CAAE;2BAsBxE,MAAM,eAAe,8BAA8B;yCA6BrC,MAAM;CAanD,CAAA"}

package/dist/mutators/environment.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/environment.ts"],
-  "sourcesContent": ["import type { UnknownObject } from '@/helpers/general'\nimport type {\n  xScalarClientConfigEnvironment,\n  XScalarClientConfigEnvironments,\n} from '@/schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments'\n\n/**\n * Environment mutators for managing client configuration environments in OpenAPI documents.\n * Provides functions to add and delete environments from the document's x-scalar-client-config-environments extension.\n *\n * @param store - The workspace store containing the documents\n * @param documentName - The name of the document to operate on\n * @returns Object containing addEnvironment and deleteEnvironment functions\n */\nexport const environmentMutators = (\n  document?: UnknownObject & { 'x-scalar-client-config-environments'?: XScalarClientConfigEnvironments },\n) => {\n  /**\n   * Adds a new environment to the document's client configuration.\n   * If an environment with the same name already exists, it will log a warning and return false.\n   *\n   * @param name - The name of the environment to add\n   * @param environment - The environment configuration to add\n   * @returns true if the environment was added successfully, false if it already exists or document is missing\n   *\n   * @example\n   * // Add a new development environment\n   * const success = addEnvironment('development', {\n   *   variables: { apiUrl: 'https://dev.example.com/api' }\n   * })\n   *\n   * if (success) {\n   *   console.log('Environment added successfully')\n   * } else {\n   *   console.log('Environment already exists')\n   * }\n   */\n  const addEnvironment = (name: string, environment: xScalarClientConfigEnvironment) => {\n    if (!document) {\n      return false\n    }\n\n    if (!document['x-scalar-client-config-environments']) {\n      document['x-scalar-client-config-environments'] = {}\n    }\n\n    if (document['x-scalar-client-config-environments'][name]) {\n      console.warn(`Environment with name \"${name}\" already exists in the document.`)\n      return false\n    }\n\n    document['x-scalar-client-config-environments'][name] = environment\n    return true\n  }\n\n  /**\n   * Removes an environment from the document's x-scalar-client-config-environments extension by its name.\n   * Returns false if the document or environments object does not exist, otherwise deletes the environment and returns true.\n   *\n   * @param environmentName - The name of the environment to remove\n   * @returns true if the environment was deleted, false otherwise\n   *\n   * @example\n   * // Remove a development environment\n   * deleteEnvironment('development')\n   */\n  const deleteEnvironment = (environmentName: string) => {\n    if (!document || !document['x-scalar-client-config-environments']) {\n      return false\n    }\n\n    delete document['x-scalar-client-config-environments'][environmentName]\n    return true\n  }\n\n  return {\n    addEnvironment,\n    deleteEnvironment,\n  }\n}\n"],
+  "sourcesContent": ["import type { UnknownObject } from '@/helpers/general'\nimport type {\n  XScalarClientConfigEnvironments,\n  xScalarClientConfigEnvironment,\n} from '@/schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments'\n\n/**\n * Environment mutators for managing client configuration environments in OpenAPI documents.\n * Provides functions to add and delete environments from the document's x-scalar-client-config-environments extension.\n *\n * @param store - The workspace store containing the documents\n * @param documentName - The name of the document to operate on\n * @returns Object containing addEnvironment and deleteEnvironment functions\n */\nexport const environmentMutators = (\n  document?: UnknownObject & { 'x-scalar-client-config-environments'?: XScalarClientConfigEnvironments },\n) => {\n  /**\n   * Adds a new environment to the document's client configuration.\n   * If an environment with the same name already exists, it will log a warning and return false.\n   *\n   * @param name - The name of the environment to add\n   * @param environment - The environment configuration to add\n   * @returns true if the environment was added successfully, false if it already exists or document is missing\n   *\n   * @example\n   * // Add a new development environment\n   * const success = addEnvironment('development', {\n   *   variables: { apiUrl: 'https://dev.example.com/api' }\n   * })\n   *\n   * if (success) {\n   *   console.log('Environment added successfully')\n   * } else {\n   *   console.log('Environment already exists')\n   * }\n   */\n  const addEnvironment = (name: string, environment: xScalarClientConfigEnvironment) => {\n    if (!document) {\n      return false\n    }\n\n    if (!document['x-scalar-client-config-environments']) {\n      document['x-scalar-client-config-environments'] = {}\n    }\n\n    if (document['x-scalar-client-config-environments'][name]) {\n      console.warn(`Environment with name \"${name}\" already exists in the document.`)\n      return false\n    }\n\n    document['x-scalar-client-config-environments'][name] = environment\n    return true\n  }\n\n  /**\n   * Removes an environment from the document's x-scalar-client-config-environments extension by its name.\n   * Returns false if the document or environments object does not exist, otherwise deletes the environment and returns true.\n   *\n   * @param environmentName - The name of the environment to remove\n   * @returns true if the environment was deleted, false otherwise\n   *\n   * @example\n   * // Remove a development environment\n   * deleteEnvironment('development')\n   */\n  const deleteEnvironment = (environmentName: string) => {\n    if (!document || !document['x-scalar-client-config-environments']) {\n      return false\n    }\n\n    delete document['x-scalar-client-config-environments'][environmentName]\n    return true\n  }\n\n  return {\n    addEnvironment,\n    deleteEnvironment,\n  }\n}\n"],
   "mappings": "AAcO,MAAM,sBAAsB,CACjC,aACG;AAqBH,QAAM,iBAAiB,CAAC,MAAc,gBAAgD;AACpF,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,SAAS,qCAAqC,GAAG;AACpD,eAAS,qCAAqC,IAAI,CAAC;AAAA,IACrD;AAEA,QAAI,SAAS,qCAAqC,EAAE,IAAI,GAAG;AACzD,cAAQ,KAAK,0BAA0B,IAAI,mCAAmC;AAC9E,aAAO;AAAA,IACT;AAEA,aAAS,qCAAqC,EAAE,IAAI,IAAI;AACxD,WAAO;AAAA,EACT;AAaA,QAAM,oBAAoB,CAAC,oBAA4B;AACrD,QAAI,CAAC,YAAY,CAAC,SAAS,qCAAqC,GAAG;AACjE,aAAO;AAAA,IACT;AAEA,WAAO,SAAS,qCAAqC,EAAE,eAAe;AACtE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
   "names": []
 }

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mutators/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E,eAAO,MAAM,WAAW,UAAW,cAAc,gBAAgB,MAAM,KAAG,eAAe,GAAG,SAQ3F,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mutators/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E,eAAO,MAAM,WAAW,GAAI,OAAO,cAAc,EAAE,cAAc,MAAM,KAAG,eAAe,GAAG,SAQ3F,CAAA"}

package/dist/mutators/index.d.ts

@@ -19,11 +19,11 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             deleteCookie: (cookieName: string) => boolean;
         };
         serverMutators: {
-            addServer: (server: import("../schemas/v3.1/strict/server.js").ServerObject) => boolean;
-            deleteServer: (index: number) => boolean;
+            addServer: (server: import("../schemas/v3.1/strict/openapi-document.js").ServerObject) => boolean;
+            deleteServer: (url: string) => boolean;
         };
         securitySchemeMutators: {
-            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/security-scheme.js").SecuritySchemeObject) => boolean;
+            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/openapi-document.js").SecuritySchemeObject) => boolean;
             deleteSecurityScheme: (name: string) => boolean;
         };
     };
@@ -49,7 +49,7 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             deleteRequest: ({ path, method }: import("../mutators/request.js").OperationIdentifier) => boolean;
         };
         securitySchemeMutators: {
-            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/security-scheme.js").SecuritySchemeObject) => boolean;
+            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/openapi-document.js").SecuritySchemeObject) => boolean;
             deleteSecurityScheme: (name: string) => boolean;
         };
         environmentMutators: {
@@ -61,8 +61,8 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             deleteCookie: (cookieName: string) => boolean;
         };
         serverMutators: {
-            addServer: (server: import("../schemas/v3.1/strict/server.js").ServerObject) => boolean;
-            deleteServer: (index: number) => boolean;
+            addServer: (server: import("../schemas/v3.1/strict/openapi-document.js").ServerObject) => boolean;
+            deleteServer: (url: string) => boolean;
         };
     };
     /**
@@ -88,7 +88,7 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             deleteRequest: ({ path, method }: import("../mutators/request.js").OperationIdentifier) => boolean;
         };
         securitySchemeMutators: {
-            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/security-scheme.js").SecuritySchemeObject) => boolean;
+            addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/openapi-document.js").SecuritySchemeObject) => boolean;
             deleteSecurityScheme: (name: string) => boolean;
         };
         environmentMutators: {
@@ -100,8 +100,8 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             deleteCookie: (cookieName: string) => boolean;
         };
         serverMutators: {
-            addServer: (server: import("../schemas/v3.1/strict/server.js").ServerObject) => boolean;
-            deleteServer: (index: number) => boolean;
+            addServer: (server: import("../schemas/v3.1/strict/openapi-document.js").ServerObject) => boolean;
+            deleteServer: (url: string) => boolean;
         };
     };
 };

package/dist/mutators/request-example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-example.d.ts","sourceRoot":"","sources":["../../src/mutators/request-example.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uFAAuF,CAAA;AAE9I;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,cAAe,iBAAiB;0DA4B9D,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iCAAiC,CAAA;KAAE;mDA6C/B,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CA8B7F,CAAA"}
+{"version":3,"file":"request-example.d.ts","sourceRoot":"","sources":["../../src/mutators/request-example.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uFAAuF,CAAA;AAE9I;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,iBAAiB;0DA4B9D,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iCAAiC,CAAA;KAAE;mDA6C/B,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CA8B7F,CAAA"}

package/dist/mutators/request.d.ts

@@ -1,5 +1,5 @@
-import type { OpenApiDocument } from '../schemas/v3.1/strict/openapi-document.js';
 import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import type { OpenApiDocument } from '../schemas/v3.1/strict/openapi-document.js';
 export type OperationIdentifier = {
     path: string;
     method: Exclude<HttpMethod, 'connect' | 'head' | 'options'>;

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

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/mutators/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CAC5D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,cAAe,eAAe;4CAoBrD;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,WAAW,EAAE,mBAAmB,CAAA;KAAE;sCAqD3B,mBAAmB;CA0B7D,CAAA"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/mutators/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAA;AAE7E,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CAC5D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,eAAe;4CAoBrD;QACD,MAAM,EAAE,mBAAmB,CAAA;QAC3B,WAAW,EAAE,mBAAmB,CAAA;KACjC;sCAqDwC,mBAAmB;CA0B7D,CAAA"}

package/dist/mutators/request.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/request.ts"],
-  "sourcesContent": ["import type { OpenApiDocument } from '@/schemas/v3.1/strict/openapi-document'\nimport type { HttpMethod } from '@scalar/helpers/http/http-methods'\n\nexport type OperationIdentifier = {\n  path: string\n  method: Exclude<HttpMethod, 'connect' | 'head' | 'options'>\n}\n\n/**\n * Provides mutator functions for managing OpenAPI operations (requests) within a workspace store.\n * This module contains utilities for moving and deleting API operations while maintaining\n * document integrity and preventing conflicts.\n *\n * @param document - The OpenAPI document to operate on\n * @returns Object containing mutator functions for request operations\n */\nexport const requestMutators = (document?: OpenApiDocument) => {\n  /**\n   * Moves an operation from one path/method to another within the OpenAPI document.\n   * This function handles the relocation of API operations while preserving their configuration\n   * and preventing accidental overwrites of existing operations.\n   *\n   * @param source - The current location of the operation to move\n   * @param destination - The target location for the operation (path and/or method)\n   * @returns true if the operation was successfully moved, false otherwise\n   *\n   * @example\n   * // Move an operation to a completely new path and method\n   * moveOperation({\n   *   source: { path: '/old-endpoint', method: 'get' },\n   *   destination: { path: '/new-endpoint', method: 'post' }\n   * })\n   */\n  const moveOperation = ({\n    source,\n    destination,\n  }: { source: OperationIdentifier; destination: OperationIdentifier }) => {\n    if (!document || !document.paths) {\n      return false\n    }\n\n    const pathObject = document.paths[source.path]\n\n    if (!pathObject) {\n      return false\n    }\n\n    const operation = pathObject[source.method]\n\n    if (!operation) {\n      return false\n    }\n\n    const newPath = destination.path || source.path\n    const newMethod = destination.method || source.method\n\n    if (document.paths[newPath]?.[newMethod]) {\n      // If the new path and method already exist, we should not overwrite it.\n      console.warn(`Request already exists at ${newPath} with method ${newMethod}.`)\n      return false\n    }\n\n    // delete the request from the old location\n    delete pathObject[source.method]\n\n    if (!document.paths[newPath]) {\n      // If the new path does not exist, create it\n      document.paths[newPath] = {}\n    }\n\n    document.paths[newPath][newMethod] = operation\n    return true\n  }\n\n  /**\n   * Deletes an operation from the OpenAPI document at the specified path and method.\n   *\n   * @param path - The path of the operation to delete\n   * @param method - The HTTP method of the operation to delete\n   * @returns void - Returns early if document, path, or operation doesn't exist\n   *\n   * @example\n   * // Delete a GET operation from /users endpoint\n   * deleteRequest({ path: '/users', method: 'get' })\n   *\n   * @example\n   * // Delete a POST operation from /auth/login endpoint\n   * deleteRequest({ path: '/auth/login', method: 'post' })\n   */\n  const deleteRequest = ({ path, method }: OperationIdentifier) => {\n    if (!document) {\n      return false\n    }\n\n    const pathObject = document?.paths?.[path]\n\n    if (!pathObject) {\n      return false\n    }\n\n    const operation = pathObject[method]\n\n    if (!operation) {\n      return false\n    }\n\n    // Delete the request by slug\n    delete pathObject[method]\n    return true\n  }\n\n  return {\n    moveRequest: moveOperation,\n    deleteRequest,\n  }\n}\n"],
-  "mappings": "AAgBO,MAAM,kBAAkB,CAAC,aAA+B;AAiB7D,QAAM,gBAAgB,CAAC;AAAA,IACrB;AAAA,IACA;AAAA,EACF,MAAyE;AACvE,QAAI,CAAC,YAAY,CAAC,SAAS,OAAO;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,SAAS,MAAM,OAAO,IAAI;AAE7C,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,WAAW,OAAO,MAAM;AAE1C,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,YAAY,QAAQ,OAAO;AAC3C,UAAM,YAAY,YAAY,UAAU,OAAO;AAE/C,QAAI,SAAS,MAAM,OAAO,IAAI,SAAS,GAAG;AAExC,cAAQ,KAAK,6BAA6B,OAAO,gBAAgB,SAAS,GAAG;AAC7E,aAAO;AAAA,IACT;AAGA,WAAO,WAAW,OAAO,MAAM;AAE/B,QAAI,CAAC,SAAS,MAAM,OAAO,GAAG;AAE5B,eAAS,MAAM,OAAO,IAAI,CAAC;AAAA,IAC7B;AAEA,aAAS,MAAM,OAAO,EAAE,SAAS,IAAI;AACrC,WAAO;AAAA,EACT;AAiBA,QAAM,gBAAgB,CAAC,EAAE,MAAM,OAAO,MAA2B;AAC/D,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,UAAU,QAAQ,IAAI;AAEzC,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,WAAW,MAAM;AAEnC,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAGA,WAAO,WAAW,MAAM;AACxB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\n\nimport type { OpenApiDocument } from '@/schemas/v3.1/strict/openapi-document'\n\nexport type OperationIdentifier = {\n  path: string\n  method: Exclude<HttpMethod, 'connect' | 'head' | 'options'>\n}\n\n/**\n * Provides mutator functions for managing OpenAPI operations (requests) within a workspace store.\n * This module contains utilities for moving and deleting API operations while maintaining\n * document integrity and preventing conflicts.\n *\n * @param document - The OpenAPI document to operate on\n * @returns Object containing mutator functions for request operations\n */\nexport const requestMutators = (document?: OpenApiDocument) => {\n  /**\n   * Moves an operation from one path/method to another within the OpenAPI document.\n   * This function handles the relocation of API operations while preserving their configuration\n   * and preventing accidental overwrites of existing operations.\n   *\n   * @param source - The current location of the operation to move\n   * @param destination - The target location for the operation (path and/or method)\n   * @returns true if the operation was successfully moved, false otherwise\n   *\n   * @example\n   * // Move an operation to a completely new path and method\n   * moveOperation({\n   *   source: { path: '/old-endpoint', method: 'get' },\n   *   destination: { path: '/new-endpoint', method: 'post' }\n   * })\n   */\n  const moveOperation = ({\n    source,\n    destination,\n  }: {\n    source: OperationIdentifier\n    destination: OperationIdentifier\n  }) => {\n    if (!document || !document.paths) {\n      return false\n    }\n\n    const pathObject = document.paths[source.path]\n\n    if (!pathObject) {\n      return false\n    }\n\n    const operation = pathObject[source.method]\n\n    if (!operation) {\n      return false\n    }\n\n    const newPath = destination.path || source.path\n    const newMethod = destination.method || source.method\n\n    if (document.paths[newPath]?.[newMethod]) {\n      // If the new path and method already exist, we should not overwrite it.\n      console.warn(`Request already exists at ${newPath} with method ${newMethod}.`)\n      return false\n    }\n\n    // delete the request from the old location\n    delete pathObject[source.method]\n\n    if (!document.paths[newPath]) {\n      // If the new path does not exist, create it\n      document.paths[newPath] = {}\n    }\n\n    document.paths[newPath][newMethod] = operation\n    return true\n  }\n\n  /**\n   * Deletes an operation from the OpenAPI document at the specified path and method.\n   *\n   * @param path - The path of the operation to delete\n   * @param method - The HTTP method of the operation to delete\n   * @returns void - Returns early if document, path, or operation doesn't exist\n   *\n   * @example\n   * // Delete a GET operation from /users endpoint\n   * deleteRequest({ path: '/users', method: 'get' })\n   *\n   * @example\n   * // Delete a POST operation from /auth/login endpoint\n   * deleteRequest({ path: '/auth/login', method: 'post' })\n   */\n  const deleteRequest = ({ path, method }: OperationIdentifier) => {\n    if (!document) {\n      return false\n    }\n\n    const pathObject = document?.paths?.[path]\n\n    if (!pathObject) {\n      return false\n    }\n\n    const operation = pathObject[method]\n\n    if (!operation) {\n      return false\n    }\n\n    // Delete the request by slug\n    delete pathObject[method]\n    return true\n  }\n\n  return {\n    moveRequest: moveOperation,\n    deleteRequest,\n  }\n}\n"],
+  "mappings": "AAiBO,MAAM,kBAAkB,CAAC,aAA+B;AAiB7D,QAAM,gBAAgB,CAAC;AAAA,IACrB;AAAA,IACA;AAAA,EACF,MAGM;AACJ,QAAI,CAAC,YAAY,CAAC,SAAS,OAAO;AAChC,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,SAAS,MAAM,OAAO,IAAI;AAE7C,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,WAAW,OAAO,MAAM;AAE1C,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,YAAY,QAAQ,OAAO;AAC3C,UAAM,YAAY,YAAY,UAAU,OAAO;AAE/C,QAAI,SAAS,MAAM,OAAO,IAAI,SAAS,GAAG;AAExC,cAAQ,KAAK,6BAA6B,OAAO,gBAAgB,SAAS,GAAG;AAC7E,aAAO;AAAA,IACT;AAGA,WAAO,WAAW,OAAO,MAAM;AAE/B,QAAI,CAAC,SAAS,MAAM,OAAO,GAAG;AAE5B,eAAS,MAAM,OAAO,IAAI,CAAC;AAAA,IAC7B;AAEA,aAAS,MAAM,OAAO,EAAE,SAAS,IAAI;AACrC,WAAO;AAAA,EACT;AAiBA,QAAM,gBAAgB,CAAC,EAAE,MAAM,OAAO,MAA2B;AAC/D,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AAEA,UAAM,aAAa,UAAU,QAAQ,IAAI;AAEzC,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,IACT;AAEA,UAAM,YAAY,WAAW,MAAM;AAEnC,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAGA,WAAO,WAAW,MAAM;AACxB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/mutators/security-schemes.d.ts

@@ -1,5 +1,4 @@
-import type { ComponentsObject } from '../schemas/v3.1/strict/components.js';
-import type { SecuritySchemeObject } from '../schemas/v3.1/strict/security-scheme.js';
+import type { ComponentsObject, SecuritySchemeObject } from '../schemas/v3.1/strict/openapi-document.js';
 /**
  * Mutator utilities for managing security schemes in an OpenAPI document.
  * This module contains utilities for adding and deleting security schemes.

package/dist/mutators/security-schemes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-schemes.d.ts","sourceRoot":"","sources":["../../src/mutators/security-schemes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,YAAa,gBAAgB,CAAC,iBAAiB,CAAC;8BAsBhD,MAAM,kBAAkB,oBAAoB;iCAyBzC,MAAM;CAa3C,CAAA"}
+{"version":3,"file":"security-schemes.d.ts","sourceRoot":"","sources":["../../src/mutators/security-schemes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAA;AAEpG;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,gBAAgB,CAAC,iBAAiB,CAAC;8BAsBhD,MAAM,kBAAkB,oBAAoB;iCAyBzC,MAAM;CAa3C,CAAA"}

package/dist/mutators/security-schemes.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/security-schemes.ts"],
-  "sourcesContent": ["import type { ComponentsObject } from '@/schemas/v3.1/strict/components'\nimport type { SecuritySchemeObject } from '@/schemas/v3.1/strict/security-scheme'\n\n/**\n * Mutator utilities for managing security schemes in an OpenAPI document.\n * This module contains utilities for adding and deleting security schemes.\n *\n * @param target - The securitySchemes object from the OpenAPI document's components section\n * @returns An object with mutator functions for security scheme operations\n */\nexport const securitySchemeMutators = (target?: ComponentsObject['securitySchemes']) => {\n  /**\n   * Adds a new security scheme to the document's components.securitySchemes.\n   * If a security scheme with the same type already exists, it will return false.\n   *\n   * @param securityScheme - The security scheme object to add\n   * @returns true if the security scheme was added successfully, false if it already exists or document is missing\n   *\n   * @example\n   * // Add a new API key security scheme\n   * const success = addSecurityScheme({\n   *   type: 'apiKey',\n   *   name: 'api_key',\n   *   in: 'header'\n   * })\n   *\n   * if (success) {\n   *   console.log('Security scheme added successfully')\n   * } else {\n   *   console.log('Security scheme already exists')\n   * }\n   */\n  const addSecurityScheme = (name: string, securityScheme: SecuritySchemeObject) => {\n    if (!target) {\n      return false\n    }\n\n    if (target[name]) {\n      // Security scheme with this name already exists\n      return false\n    }\n\n    target[name] = securityScheme\n    return true\n  }\n\n  /**\n   * Removes a security scheme from the document's components.securitySchemes by its name.\n   * Returns false if the document, components, or securitySchemes object does not exist, otherwise deletes the security scheme and returns true.\n   *\n   * @param name - The name of the security scheme to remove\n   * @returns true if the security scheme was deleted, false otherwise\n   *\n   * @example\n   * // Remove an API key security scheme\n   * deleteSecurityScheme('apiKey')\n   */\n  const deleteSecurityScheme = (name: string) => {\n    if (!target || !target[name]) {\n      return false\n    }\n\n    delete target[name]\n    return true\n  }\n\n  return {\n    addSecurityScheme,\n    deleteSecurityScheme,\n  }\n}\n"],
-  "mappings": "AAUO,MAAM,yBAAyB,CAAC,WAAiD;AAsBtF,QAAM,oBAAoB,CAAC,MAAc,mBAAyC;AAChF,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,IAAI,GAAG;AAEhB,aAAO;AAAA,IACT;AAEA,WAAO,IAAI,IAAI;AACf,WAAO;AAAA,EACT;AAaA,QAAM,uBAAuB,CAAC,SAAiB;AAC7C,QAAI,CAAC,UAAU,CAAC,OAAO,IAAI,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO,OAAO,IAAI;AAClB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { ComponentsObject, SecuritySchemeObject } from '@/schemas/v3.1/strict/openapi-document'\n\n/**\n * Mutator utilities for managing security schemes in an OpenAPI document.\n * This module contains utilities for adding and deleting security schemes.\n *\n * @param target - The securitySchemes object from the OpenAPI document's components section\n * @returns An object with mutator functions for security scheme operations\n */\nexport const securitySchemeMutators = (target?: ComponentsObject['securitySchemes']) => {\n  /**\n   * Adds a new security scheme to the document's components.securitySchemes.\n   * If a security scheme with the same type already exists, it will return false.\n   *\n   * @param securityScheme - The security scheme object to add\n   * @returns true if the security scheme was added successfully, false if it already exists or document is missing\n   *\n   * @example\n   * // Add a new API key security scheme\n   * const success = addSecurityScheme({\n   *   type: 'apiKey',\n   *   name: 'api_key',\n   *   in: 'header'\n   * })\n   *\n   * if (success) {\n   *   console.log('Security scheme added successfully')\n   * } else {\n   *   console.log('Security scheme already exists')\n   * }\n   */\n  const addSecurityScheme = (name: string, securityScheme: SecuritySchemeObject) => {\n    if (!target) {\n      return false\n    }\n\n    if (target[name]) {\n      // Security scheme with this name already exists\n      return false\n    }\n\n    target[name] = securityScheme\n    return true\n  }\n\n  /**\n   * Removes a security scheme from the document's components.securitySchemes by its name.\n   * Returns false if the document, components, or securitySchemes object does not exist, otherwise deletes the security scheme and returns true.\n   *\n   * @param name - The name of the security scheme to remove\n   * @returns true if the security scheme was deleted, false otherwise\n   *\n   * @example\n   * // Remove an API key security scheme\n   * deleteSecurityScheme('apiKey')\n   */\n  const deleteSecurityScheme = (name: string) => {\n    if (!target || !target[name]) {\n      return false\n    }\n\n    delete target[name]\n    return true\n  }\n\n  return {\n    addSecurityScheme,\n    deleteSecurityScheme,\n  }\n}\n"],
+  "mappings": "AASO,MAAM,yBAAyB,CAAC,WAAiD;AAsBtF,QAAM,oBAAoB,CAAC,MAAc,mBAAyC;AAChF,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,QAAI,OAAO,IAAI,GAAG;AAEhB,aAAO;AAAA,IACT;AAEA,WAAO,IAAI,IAAI;AACf,WAAO;AAAA,EACT;AAaA,QAAM,uBAAuB,CAAC,SAAiB;AAC7C,QAAI,CAAC,UAAU,CAAC,OAAO,IAAI,GAAG;AAC5B,aAAO;AAAA,IACT;AAEA,WAAO,OAAO,IAAI;AAClB,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
   "names": []
 }