@scalar/workspace-store 0.22.2 → 0.24.1

package/dist/mutators/index.js

@@ -82,7 +82,7 @@ import {
   updateSelectedSecuritySchemes
 } from "./auth.js";
 import { deleteCookie, upsertCookie } from "./cookie.js";
-import { createEmptyDocument, toggleSecurity, updateDocumentIcon, updateWatchMode } from "./document.js";
+import { createEmptyDocument, deleteDocument, toggleSecurity, updateDocumentIcon, updateWatchMode } from "./document.js";
 import {
   upsertEnvironment,
   upsertEnvironmentVariable
@@ -92,11 +92,12 @@ import {
   addOperationRequestBodyFormRow,
   createOperation,
   deleteAllOperationParameters,
+  deleteOperation,
+  deleteOperationExample,
   deleteOperationParameter,
   deleteOperationRequestBodyFormRow,
-  updateOperationMethod,
   updateOperationParameter,
-  updateOperationPath,
+  updateOperationPathMethod,
   updateOperationRequestBodyContentType,
   updateOperationRequestBodyExample,
   updateOperationRequestBodyFormRow,
@@ -119,8 +120,8 @@ import {
   navigatePreviousTab,
   updateTabs
 } from "./tabs.js";
-import { createTag } from "./tag.js";
-import { updateActiveProxy, updateColorMode, updateTheme } from "./workspace.js";
+import { createTag, deleteTag } from "./tag.js";
+import { updateActiveProxy, updateColorMode, updateSelectedClient, updateTheme } from "./workspace.js";
 export {
   addOperationParameter,
   addOperationRequestBodyFormRow,
@@ -133,10 +134,14 @@ export {
   createTag,
   deleteAllOperationParameters,
   deleteCookie,
+  deleteDocument,
+  deleteOperation,
+  deleteOperationExample,
   deleteOperationParameter,
   deleteOperationRequestBodyFormRow,
   deleteSecurityScheme,
   deleteServer,
+  deleteTag,
   focusLastTab,
   focusTab,
   generateClientMutators,
@@ -146,15 +151,15 @@ export {
   updateActiveProxy,
   updateColorMode,
   updateDocumentIcon,
-  updateOperationMethod,
   updateOperationParameter,
-  updateOperationPath,
+  updateOperationPathMethod,
   updateOperationRequestBodyContentType,
   updateOperationRequestBodyExample,
   updateOperationRequestBodyFormRow,
   updateOperationSummary,
   updateSecurityScheme,
   updateSelectedAuthTab,
+  updateSelectedClient,
   updateSelectedScopes,
   updateSelectedSecuritySchemes,
   updateSelectedServer,

package/dist/mutators/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/index.ts"],
-  "sourcesContent": ["/** biome-ignore-all lint/performance/noBarrelFile: Mutators entry point */\nimport type { WorkspaceStore } from '@/client'\nimport { getDocument } from '@/mutators/helpers'\nimport { requestMutators } from '@/mutators/request'\nimport { securitySchemeMutators } from '@/mutators/security-schemes'\nimport type { ServerObject } from '@/schemas/v3.1/strict/openapi-document'\n\n/**\n * Generates a set of mutators for managing OpenAPI document and workspace state.\n *\n * @deprecated use the individual mutators instead, this will be removed after we move fully to the new store\n *\n * @param store - The workspace store containing all documents and workspace-level data\n * @returns An object with mutators for the workspace, the active document, and any named document\n */\nexport function generateClientMutators(store: WorkspaceStore) {\n  /**\n   * Provides mutator functions for managing an array of OpenAPI ServerObject entries.\n   *\n   * @param target - The array of ServerObject to mutate. If not provided, mutators will be no-ops.\n   * @returns An object with addServer and deleteServer methods.\n   */\n  const serverMutators = (target?: ServerObject[]) => {\n    /**\n     * Adds a new ServerObject to the target array.\n     * @param server - The ServerObject to add.\n     * @returns true if the server was added, false if target is undefined.\n     */\n    const addServer = (server: ServerObject): boolean => {\n      if (!target) {\n        return false\n      }\n      target.push(server)\n      return true\n    }\n\n    /**\n     * Deletes a ServerObject at the specified index from the target array.\n     * @param index - The index of the server to delete.\n     * @returns true if the server was deleted, false if target is undefined.\n     */\n    const deleteServer = (url: string): boolean => {\n      if (!target) {\n        return false\n      }\n      const newTarget = [...target.filter((it) => it.url !== url)]\n      target.splice(0, target.length)\n      target.push(...newTarget)\n      return true\n    }\n\n    return {\n      addServer,\n      deleteServer,\n    }\n  }\n\n  /**\n   * Returns mutators for a specific document by name.\n   *\n   * @param documentName - The name of the document to get mutators for\n   * @returns An object containing mutators for requests, request examples, security schemes, environments, and cookies\n   */\n  const documentMutators = (documentName: string) => {\n    const document = getDocument(store, documentName)\n\n    if (document) {\n      // Make sure the document has a servers array\n      if (!document.servers) {\n        document.servers = []\n      }\n\n      // Make sure the document has the securitySchema object\n      if (!document.components) {\n        document.components = {}\n      }\n\n      if (!document.components.securitySchemes) {\n        document.components.securitySchemes = {}\n      }\n    }\n\n    return {\n      requestMutators: requestMutators(document),\n      securitySchemeMutators: securitySchemeMutators(document?.components?.securitySchemes),\n      serverMutators: serverMutators(document?.servers),\n    }\n  }\n\n  /**\n   * Returns mutators for the workspace-level configuration.\n   *\n   * @returns An object containing mutators for environments and cookies at the workspace level\n   */\n  const workspaceMutators = () => {\n    const workspace = store.workspace\n\n    // Make sure the workspace has a servers array\n    if (!workspace['x-scalar-client-config-servers']) {\n      workspace['x-scalar-client-config-servers'] = []\n    }\n\n    // Make sure the workspace has the securitySchema object\n    if (!store.workspace['x-scalar-client-config-security-schemes']) {\n      store.workspace['x-scalar-client-config-security-schemes'] = {}\n    }\n\n    return {\n      serverMutators: serverMutators(store.workspace['x-scalar-client-config-servers']),\n      securitySchemeMutators: securitySchemeMutators(store.workspace['x-scalar-client-config-security-schemes']),\n    }\n  }\n\n  return {\n    /**\n     * Returns mutators for the workspace-level configuration.\n     */\n    workspace: () => workspaceMutators(),\n    /**\n     * Returns mutators for the currently active document.\n     * Falls back to the first document if no active document is set.\n     */\n    active: () =>\n      documentMutators(store.workspace['x-scalar-active-document'] ?? Object.keys(store.workspace.documents)[0] ?? ''),\n    /**\n     * Returns mutators for a specific document by name.\n     *\n     * @param name - The name of the document\n     */\n    doc: (name: string) => documentMutators(name),\n  }\n}\n\nexport {\n  type AuthMeta,\n  deleteSecurityScheme,\n  updateSecurityScheme,\n  updateSelectedAuthTab,\n  updateSelectedScopes,\n  updateSelectedSecuritySchemes,\n} from './auth'\nexport { deleteCookie, upsertCookie } from './cookie'\nexport { createEmptyDocument, toggleSecurity, updateDocumentIcon, updateWatchMode } from './document'\nexport {\n  upsertEnvironment,\n  upsertEnvironmentVariable,\n} from './environment'\nexport {\n  type OperationExampleMeta,\n  type OperationMeta,\n  addOperationParameter,\n  addOperationRequestBodyFormRow,\n  createOperation,\n  deleteAllOperationParameters,\n  deleteOperationParameter,\n  deleteOperationRequestBodyFormRow,\n  updateOperationMethod,\n  updateOperationParameter,\n  updateOperationPath,\n  updateOperationRequestBodyContentType,\n  updateOperationRequestBodyExample,\n  updateOperationRequestBodyFormRow,\n  updateOperationSummary,\n} from './operation'\nexport {\n  addServer,\n  deleteServer,\n  updateSelectedServer,\n  updateServer,\n  updateServerVariables,\n} from './server'\nexport {\n  addTab,\n  closeOtherTabs,\n  closeTab,\n  focusLastTab,\n  focusTab,\n  navigateNextTab,\n  navigatePreviousTab,\n  updateTabs,\n} from './tabs'\nexport { createTag } from './tag'\nexport { updateActiveProxy, updateColorMode, updateTheme } from './workspace'\n"],
-  "mappings": "AAEA,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AAWhC,SAAS,uBAAuB,OAAuB;AAO5D,QAAM,iBAAiB,CAAC,WAA4B;AAMlD,UAAMA,aAAY,CAAC,WAAkC;AACnD,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AACA,aAAO,KAAK,MAAM;AAClB,aAAO;AAAA,IACT;AAOA,UAAMC,gBAAe,CAAC,QAAyB;AAC7C,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AACA,YAAM,YAAY,CAAC,GAAG,OAAO,OAAO,CAAC,OAAO,GAAG,QAAQ,GAAG,CAAC;AAC3D,aAAO,OAAO,GAAG,OAAO,MAAM;AAC9B,aAAO,KAAK,GAAG,SAAS;AACxB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,WAAAD;AAAA,MACA,cAAAC;AAAA,IACF;AAAA,EACF;AAQA,QAAM,mBAAmB,CAAC,iBAAyB;AACjD,UAAM,WAAW,YAAY,OAAO,YAAY;AAEhD,QAAI,UAAU;AAEZ,UAAI,CAAC,SAAS,SAAS;AACrB,iBAAS,UAAU,CAAC;AAAA,MACtB;AAGA,UAAI,CAAC,SAAS,YAAY;AACxB,iBAAS,aAAa,CAAC;AAAA,MACzB;AAEA,UAAI,CAAC,SAAS,WAAW,iBAAiB;AACxC,iBAAS,WAAW,kBAAkB,CAAC;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,iBAAiB,gBAAgB,QAAQ;AAAA,MACzC,wBAAwB,uBAAuB,UAAU,YAAY,eAAe;AAAA,MACpF,gBAAgB,eAAe,UAAU,OAAO;AAAA,IAClD;AAAA,EACF;AAOA,QAAM,oBAAoB,MAAM;AAC9B,UAAM,YAAY,MAAM;AAGxB,QAAI,CAAC,UAAU,gCAAgC,GAAG;AAChD,gBAAU,gCAAgC,IAAI,CAAC;AAAA,IACjD;AAGA,QAAI,CAAC,MAAM,UAAU,yCAAyC,GAAG;AAC/D,YAAM,UAAU,yCAAyC,IAAI,CAAC;AAAA,IAChE;AAEA,WAAO;AAAA,MACL,gBAAgB,eAAe,MAAM,UAAU,gCAAgC,CAAC;AAAA,MAChF,wBAAwB,uBAAuB,MAAM,UAAU,yCAAyC,CAAC;AAAA,IAC3G;AAAA,EACF;AAEA,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL,WAAW,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA,IAKnC,QAAQ,MACN,iBAAiB,MAAM,UAAU,0BAA0B,KAAK,OAAO,KAAK,MAAM,UAAU,SAAS,EAAE,CAAC,KAAK,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMjH,KAAK,CAAC,SAAiB,iBAAiB,IAAI;AAAA,EAC9C;AACF;AAEA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc,oBAAoB;AAC3C,SAAS,qBAAqB,gBAAgB,oBAAoB,uBAAuB;AACzF;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB,iBAAiB,mBAAmB;",
+  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport { getDocument } from '@/mutators/helpers'\nimport { requestMutators } from '@/mutators/request'\nimport { securitySchemeMutators } from '@/mutators/security-schemes'\nimport type { ServerObject } from '@/schemas/v3.1/strict/openapi-document'\n\n/**\n * Generates a set of mutators for managing OpenAPI document and workspace state.\n *\n * @deprecated use the individual mutators instead, this will be removed after we move fully to the new store\n *\n * @param store - The workspace store containing all documents and workspace-level data\n * @returns An object with mutators for the workspace, the active document, and any named document\n */\nexport function generateClientMutators(store: WorkspaceStore) {\n  /**\n   * Provides mutator functions for managing an array of OpenAPI ServerObject entries.\n   *\n   * @param target - The array of ServerObject to mutate. If not provided, mutators will be no-ops.\n   * @returns An object with addServer and deleteServer methods.\n   */\n  const serverMutators = (target?: ServerObject[]) => {\n    /**\n     * Adds a new ServerObject to the target array.\n     * @param server - The ServerObject to add.\n     * @returns true if the server was added, false if target is undefined.\n     */\n    const addServer = (server: ServerObject): boolean => {\n      if (!target) {\n        return false\n      }\n      target.push(server)\n      return true\n    }\n\n    /**\n     * Deletes a ServerObject at the specified index from the target array.\n     * @param index - The index of the server to delete.\n     * @returns true if the server was deleted, false if target is undefined.\n     */\n    const deleteServer = (url: string): boolean => {\n      if (!target) {\n        return false\n      }\n      const newTarget = [...target.filter((it) => it.url !== url)]\n      target.splice(0, target.length)\n      target.push(...newTarget)\n      return true\n    }\n\n    return {\n      addServer,\n      deleteServer,\n    }\n  }\n\n  /**\n   * Returns mutators for a specific document by name.\n   *\n   * @param documentName - The name of the document to get mutators for\n   * @returns An object containing mutators for requests, request examples, security schemes, environments, and cookies\n   */\n  const documentMutators = (documentName: string) => {\n    const document = getDocument(store, documentName)\n\n    if (document) {\n      // Make sure the document has a servers array\n      if (!document.servers) {\n        document.servers = []\n      }\n\n      // Make sure the document has the securitySchema object\n      if (!document.components) {\n        document.components = {}\n      }\n\n      if (!document.components.securitySchemes) {\n        document.components.securitySchemes = {}\n      }\n    }\n\n    return {\n      requestMutators: requestMutators(document),\n      securitySchemeMutators: securitySchemeMutators(document?.components?.securitySchemes),\n      serverMutators: serverMutators(document?.servers),\n    }\n  }\n\n  /**\n   * Returns mutators for the workspace-level configuration.\n   *\n   * @returns An object containing mutators for environments and cookies at the workspace level\n   */\n  const workspaceMutators = () => {\n    const workspace = store.workspace\n\n    // Make sure the workspace has a servers array\n    if (!workspace['x-scalar-client-config-servers']) {\n      workspace['x-scalar-client-config-servers'] = []\n    }\n\n    // Make sure the workspace has the securitySchema object\n    if (!store.workspace['x-scalar-client-config-security-schemes']) {\n      store.workspace['x-scalar-client-config-security-schemes'] = {}\n    }\n\n    return {\n      serverMutators: serverMutators(store.workspace['x-scalar-client-config-servers']),\n      securitySchemeMutators: securitySchemeMutators(store.workspace['x-scalar-client-config-security-schemes']),\n    }\n  }\n\n  return {\n    /**\n     * Returns mutators for the workspace-level configuration.\n     */\n    workspace: () => workspaceMutators(),\n    /**\n     * Returns mutators for the currently active document.\n     * Falls back to the first document if no active document is set.\n     */\n    active: () =>\n      documentMutators(store.workspace['x-scalar-active-document'] ?? Object.keys(store.workspace.documents)[0] ?? ''),\n    /**\n     * Returns mutators for a specific document by name.\n     *\n     * @param name - The name of the document\n     */\n    doc: (name: string) => documentMutators(name),\n  }\n}\n\nexport {\n  type AuthMeta,\n  deleteSecurityScheme,\n  updateSecurityScheme,\n  updateSelectedAuthTab,\n  updateSelectedScopes,\n  updateSelectedSecuritySchemes,\n} from './auth'\nexport { deleteCookie, upsertCookie } from './cookie'\nexport { createEmptyDocument, deleteDocument, toggleSecurity, updateDocumentIcon, updateWatchMode } from './document'\nexport {\n  upsertEnvironment,\n  upsertEnvironmentVariable,\n} from './environment'\nexport {\n  type OperationExampleMeta,\n  type OperationMeta,\n  addOperationParameter,\n  addOperationRequestBodyFormRow,\n  createOperation,\n  deleteAllOperationParameters,\n  deleteOperation,\n  deleteOperationExample,\n  deleteOperationParameter,\n  deleteOperationRequestBodyFormRow,\n  updateOperationParameter,\n  updateOperationPathMethod,\n  updateOperationRequestBodyContentType,\n  updateOperationRequestBodyExample,\n  updateOperationRequestBodyFormRow,\n  updateOperationSummary,\n} from './operation'\nexport {\n  addServer,\n  deleteServer,\n  updateSelectedServer,\n  updateServer,\n  updateServerVariables,\n} from './server'\nexport {\n  addTab,\n  closeOtherTabs,\n  closeTab,\n  focusLastTab,\n  focusTab,\n  navigateNextTab,\n  navigatePreviousTab,\n  updateTabs,\n} from './tabs'\nexport { createTag, deleteTag } from './tag'\nexport { updateActiveProxy, updateColorMode, updateSelectedClient, updateTheme } from './workspace'\n"],
+  "mappings": "AACA,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AAWhC,SAAS,uBAAuB,OAAuB;AAO5D,QAAM,iBAAiB,CAAC,WAA4B;AAMlD,UAAMA,aAAY,CAAC,WAAkC;AACnD,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AACA,aAAO,KAAK,MAAM;AAClB,aAAO;AAAA,IACT;AAOA,UAAMC,gBAAe,CAAC,QAAyB;AAC7C,UAAI,CAAC,QAAQ;AACX,eAAO;AAAA,MACT;AACA,YAAM,YAAY,CAAC,GAAG,OAAO,OAAO,CAAC,OAAO,GAAG,QAAQ,GAAG,CAAC;AAC3D,aAAO,OAAO,GAAG,OAAO,MAAM;AAC9B,aAAO,KAAK,GAAG,SAAS;AACxB,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,MACL,WAAAD;AAAA,MACA,cAAAC;AAAA,IACF;AAAA,EACF;AAQA,QAAM,mBAAmB,CAAC,iBAAyB;AACjD,UAAM,WAAW,YAAY,OAAO,YAAY;AAEhD,QAAI,UAAU;AAEZ,UAAI,CAAC,SAAS,SAAS;AACrB,iBAAS,UAAU,CAAC;AAAA,MACtB;AAGA,UAAI,CAAC,SAAS,YAAY;AACxB,iBAAS,aAAa,CAAC;AAAA,MACzB;AAEA,UAAI,CAAC,SAAS,WAAW,iBAAiB;AACxC,iBAAS,WAAW,kBAAkB,CAAC;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,iBAAiB,gBAAgB,QAAQ;AAAA,MACzC,wBAAwB,uBAAuB,UAAU,YAAY,eAAe;AAAA,MACpF,gBAAgB,eAAe,UAAU,OAAO;AAAA,IAClD;AAAA,EACF;AAOA,QAAM,oBAAoB,MAAM;AAC9B,UAAM,YAAY,MAAM;AAGxB,QAAI,CAAC,UAAU,gCAAgC,GAAG;AAChD,gBAAU,gCAAgC,IAAI,CAAC;AAAA,IACjD;AAGA,QAAI,CAAC,MAAM,UAAU,yCAAyC,GAAG;AAC/D,YAAM,UAAU,yCAAyC,IAAI,CAAC;AAAA,IAChE;AAEA,WAAO;AAAA,MACL,gBAAgB,eAAe,MAAM,UAAU,gCAAgC,CAAC;AAAA,MAChF,wBAAwB,uBAAuB,MAAM,UAAU,yCAAyC,CAAC;AAAA,IAC3G;AAAA,EACF;AAEA,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL,WAAW,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA,IAKnC,QAAQ,MACN,iBAAiB,MAAM,UAAU,0BAA0B,KAAK,OAAO,KAAK,MAAM,UAAU,SAAS,EAAE,CAAC,KAAK,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMjH,KAAK,CAAC,SAAiB,iBAAiB,IAAI;AAAA,EAC9C;AACF;AAEA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc,oBAAoB;AAC3C,SAAS,qBAAqB,gBAAgB,gBAAgB,oBAAoB,uBAAuB;AACzG;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,WAAW,iBAAiB;AACrC,SAAS,mBAAmB,iBAAiB,sBAAsB,mBAAmB;",
   "names": ["addServer", "deleteServer"]
 }

package/dist/mutators/operation.d.ts

@@ -2,6 +2,7 @@ import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { WorkspaceStore } from '../client.js';
 import type { OperationEvents } from '../events/definitions/operation.js';
 import type { WorkspaceDocument } from '../schemas.js';
+import type { OperationObject, ParameterObject } from '../schemas/v3.1/strict/openapi-document.js';
 /**
  * Describes the minimal identity for an operation in the workspace document.
  * It is used by mutators to find the target operation under `paths`.
@@ -64,43 +65,45 @@ export declare const createOperation: (workspaceStore: WorkspaceStore | null, pa
  */
 export declare const updateOperationSummary: (document: WorkspaceDocument | null, { meta, payload: { summary } }: OperationEvents["operation:update:summary"]) => void;
 /**
- * Updates the HTTP method of an operation and moves it to the new method slot.
+ * Updates the HTTP method and/or path of an operation and moves it to the new location.
  * This function:
- * 1. Moves the operation from the old method to the new method under paths
+ * 1. Moves the operation from the old method/path to the new method/path under paths
  * 2. Updates x-scalar-order to maintain the operation's position in the sidebar
- * 3. Rebuilds the sidebar to reflect the changes
+ * 3. Syncs path parameters when the path changes
  *
- * Safely no-ops if the document or operation does not exist.
+ * Safely no-ops if nothing has changed, or if the document or operation does not exist.
  *
  * Example:
  * ```ts
- * updateOperationMethod({
+ * updateOperationPathMethod({
  *   document,
  *   store,
  *   meta: { method: 'get', path: '/users' },
- *   payload: { method: 'post' },
+ *   payload: { method: 'post', path: '/api/users' },
  * })
  * ```
  */
-export declare const updateOperationMethod: (document: WorkspaceDocument | null, store: WorkspaceStore | null, { meta, payload: { method } }: OperationEvents["operation:update:method"], callback?: (success: boolean) => void) => void;
+export declare const updateOperationPathMethod: (document: WorkspaceDocument | null, store: WorkspaceStore | null, { meta, payload: { method, path } }: OperationEvents["operation:update:pathMethod"], callback: OperationEvents["operation:update:pathMethod"]["callback"]) => void;
 /**
- * Moves the operation to a new path in the document and synchronizes path
- * parameters in `operation.parameters` with the placeholders present in the
- * provided `path` (e.g. `/users/{id}`). When path parameters change,
- * intelligently syncs them by preserving configurations for renamed parameters
- * (detected by position) and existing parameters. Existing non-path parameters
- * are preserved. The operation is removed from the old path location.
+ * Deletes an operation from the workspace
  *
  * Example:
  * ```ts
- * updateOperationPath({
+ * deleteOperation({
  *   document,
- *   meta: { method: 'get', path: '/users/{id}' },
- *   payload: { path: '/users/{userId}' },
+ *   meta: { method: 'get', path: '/users' },
  * })
  * ```
  */
-export declare const updateOperationPath: (document: WorkspaceDocument | null, { meta, payload: { path } }: OperationEvents["operation:update:path"]) => void;
+export declare const deleteOperation: (workspace: WorkspaceStore | null, { meta, documentName }: OperationEvents["operation:delete:operation"]) => void;
+/**
+ * Deletes an example with the given exampleKey from operation parameters and request body.
+ *
+ * - Finds the target operation within the specified document and path/method.
+ * - Removes example values matching exampleKey from both parameter-level and content-level examples.
+ * - Safely no-ops if the document, operation, or request body does not exist.
+ */
+export declare const deleteOperationExample: (workspace: WorkspaceStore | null, { meta: { path, method, exampleKey }, documentName }: OperationEvents["operation:delete:example"]) => void;
 /** ------------------------------------------------------------------------------------------------
  * Operation Parameters Mutators
  * ------------------------------------------------------------------------------------------------ */
@@ -115,7 +118,7 @@ export declare const updateOperationPath: (document: WorkspaceDocument | null, {
  *   document,
  *   type: 'query',
  *   meta: { method: 'get', path: '/search', exampleKey: 'default' },
- *   payload: { key: 'q', value: 'john', isEnabled: true },
+ *   payload: { key: 'q', value: 'john', isDisabled: false },
  * })
  * ```
  */
@@ -133,7 +136,7 @@ export declare const addOperationParameter: (document: WorkspaceDocument | null,
  *   type: 'query',
  *   index: 0,
  *   meta: { method: 'get', path: '/search', exampleKey: 'default' },
- *   payload: { value: 'alice', isEnabled: true },
+ *   payload: { value: 'alice', isDisabled: false },
  * })
  * ```
  */
@@ -171,6 +174,20 @@ export declare const deleteAllOperationParameters: (document: WorkspaceDocument
 /** ------------------------------------------------------------------------------------------------
  * Operation Request Body Mutators
  * ------------------------------------------------------------------------------------------------ */
+/**
+ * Sets a header parameter value for a specific example key.
+ * Creates the header parameter if it does not exist, otherwise updates the existing one.
+ *
+ * Note: This function does not handle parameters with content (ParameterWithContentObject).
+ * Those cases are currently unsupported and will no-op.
+ */
+export declare const setHeader: ({ operation, type, name, value, exampleKey, }: {
+    operation: OperationObject;
+    type: ParameterObject["in"];
+    name: string;
+    value: string;
+    exampleKey: string;
+}) => void;
 /**
  * Sets the selected request-body content type for the current `exampleKey`.
  * This stores the selection under `x-scalar-selected-content-type` on the

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

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/mutators/operation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/mutators/operation.ts"],"names":[],"mappings":"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"}

package/dist/mutators/operation.js

@@ -1,12 +1,12 @@
 import { isHttpMethod } from "@scalar/helpers/http/is-http-method";
+import { objectKeys } from "@scalar/helpers/object/object-keys";
 import { preventPollution } from "@scalar/helpers/object/prevent-pollution";
 import { findVariables } from "@scalar/helpers/regex/find-variables";
 import { getResolvedRef } from "../helpers/get-resolved-ref.js";
 import { unpackProxyObject } from "../helpers/unpack-proxy.js";
-import { getOpenapiObject } from "../navigation/index.js";
+import { getOpenapiObject, getOperationEntries } from "../navigation/index.js";
 import { getNavigationOptions } from "../navigation/get-navigation-options.js";
 import { canHaveOrder } from "../navigation/helpers/get-openapi-object.js";
-import { getOperationEntries } from "../navigation/helpers/get-operation-entries.js";
 import { isContentTypeParameterObject } from "../schemas/v3.1/strict/type-guards.js";
 const getParameterPositions = (path, parameters) => {
   const positions = {};
@@ -90,6 +90,19 @@ const createOperation = (workspaceStore, payload) => {
   preventPollution(normalizedPath);
   preventPollution(method);
   document.paths[normalizedPath][method] = operation;
+  const { servers } = operation;
+  const firstServer = unpackProxyObject(servers?.[0]);
+  for (const server of servers ?? []) {
+    if (!document.servers?.some((s) => s.url === server.url)) {
+      if (!document.servers) {
+        document.servers = [];
+      }
+      document.servers.push(unpackProxyObject(server));
+    }
+  }
+  if (firstServer) {
+    document["x-scalar-selected-server"] = firstServer.url;
+  }
   payload.callback?.(true);
   return normalizedPath;
 };
@@ -103,24 +116,14 @@ const updateOperationSummary = (document, { meta, payload: { summary } }) => {
   }
   operation.summary = summary;
 };
-const updateOperationMethod = (document, store, { meta, payload: { method } }, callback) => {
-  if (meta.method === method || !isHttpMethod(method)) {
-    return;
-  }
-  const documentName = document?.["x-scalar-navigation"]?.name;
-  if (!document?.["x-scalar-navigation"] || !documentName || !store) {
-    console.error("Document or workspace not found", { document });
-    return;
-  }
-  const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
-  if (!operation) {
-    console.error("Operation not found", { meta, document });
-    return;
-  }
-  const documentConfig = store?.getDocumentConfiguration(documentName);
-  const { generateId } = getNavigationOptions(documentName, documentConfig);
-  const operationsMap = getOperationEntries(document["x-scalar-navigation"]);
-  const entries = operationsMap.get(`${meta.path}|${meta.method}`);
+const updateOperationOrderId = ({
+  store,
+  operation,
+  generateId,
+  method,
+  path,
+  entries
+}) => {
   entries?.forEach((entry) => {
     if (!canHaveOrder(entry.parent)) {
       return;
@@ -137,62 +140,114 @@ const updateOperationMethod = (document, store, { meta, payload: { method } }, c
     const parentTag = entry.parent.type === "tag" && "name" in parentOpenAPIObject ? { tag: parentOpenAPIObject, id: entry.parent.id } : void 0;
     order[index] = generateId({
       type: "operation",
-      path: meta.path,
+      path,
       method,
       operation,
       parentId: entry.parent.id,
       parentTag
     });
   });
-  preventPollution(meta.path);
-  const pathItems = document.paths?.[meta.path];
-  if (!pathItems) {
+};
+const updateOperationPathMethod = (document, store, { meta, payload: { method, path } }, callback) => {
+  const methodChanged = meta.method !== method;
+  const pathChanged = meta.path !== path;
+  if (!methodChanged && !pathChanged) {
+    callback("no-change");
     return;
   }
-  pathItems[method] = unpackProxyObject(operation);
-  delete pathItems[meta.method];
-  if (store) {
-    const success = store.buildSidebar(documentName);
-    callback?.(success);
-  } else {
-    callback?.(true);
+  const finalMethod = methodChanged ? method : meta.method;
+  const finalPath = pathChanged ? path : meta.path;
+  if (document?.paths?.[finalPath]?.[finalMethod]) {
+    callback("conflict");
+    return;
   }
-};
-const updateOperationPath = (document, { meta, payload: { path } }) => {
-  if (!document) {
+  const documentNavigation = document?.["x-scalar-navigation"];
+  if (!documentNavigation || !store) {
+    console.error("Document or workspace not found", { document });
     return;
   }
   const operation = getResolvedRef(document.paths?.[meta.path]?.[meta.method]);
   if (!operation) {
+    console.error("Operation not found", { meta, document });
     return;
   }
-  if (meta.path === path) {
-    return;
+  if (pathChanged) {
+    const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(
+      (v) => v !== void 0
+    );
+    const newPathParams = findVariables(finalPath, { includePath: true, includeEnv: false }).filter(
+      (v) => v !== void 0
+    );
+    if (oldPathParams.length > 0 || newPathParams.length > 0) {
+      const existingParameters = operation.parameters ?? [];
+      operation.parameters = syncParametersForPathChange(finalPath, meta.path, existingParameters);
+    }
   }
-  const oldPathParams = findVariables(meta.path, { includePath: true, includeEnv: false }).filter(
-    (v) => v !== void 0
-  );
-  const newPathParams = findVariables(path, { includePath: true, includeEnv: false }).filter(
-    (v) => v !== void 0
-  );
-  if (oldPathParams.length > 0 || newPathParams.length > 0) {
-    const existingParameters = operation.parameters ?? [];
-    operation.parameters = syncParametersForPathChange(path, meta.path, existingParameters);
+  const documentConfig = store.getDocumentConfiguration(documentNavigation.name);
+  const { generateId } = getNavigationOptions(documentNavigation.name, documentConfig);
+  const operationEntriesMap = getOperationEntries(documentNavigation);
+  const entries = operationEntriesMap.get(`${meta.path}|${meta.method}`);
+  if (entries) {
+    updateOperationOrderId({ store, operation, generateId, method: finalMethod, path: finalPath, entries });
   }
   if (!document.paths) {
     document.paths = {};
   }
-  if (!document.paths[path]) {
-    document.paths[path] = {};
+  if (!document.paths[finalPath]) {
+    document.paths[finalPath] = {};
   }
-  document.paths[path][meta.method] = unpackProxyObject(operation);
-  const oldPath = document.paths[meta.path];
-  if (oldPath) {
-    delete oldPath[meta.method];
-    if (Object.keys(oldPath).length === 0) {
+  preventPollution(finalPath);
+  preventPollution(meta.path);
+  preventPollution(finalMethod);
+  document.paths[finalPath][finalMethod] = unpackProxyObject(operation);
+  const oldPathItems = document.paths[meta.path];
+  if (oldPathItems && isHttpMethod(meta.method)) {
+    delete oldPathItems[meta.method];
+    if (Object.keys(oldPathItems).length === 0) {
       delete document.paths[meta.path];
     }
   }
+  callback("success");
+};
+const deleteOperation = (workspace, { meta, documentName }) => {
+  const document = workspace?.workspace.documents[documentName];
+  if (!document) {
+    return;
+  }
+  preventPollution(meta.path);
+  preventPollution(meta.method);
+  delete document.paths?.[meta.path]?.[meta.method];
+  if (Object.keys(document.paths?.[meta.path] ?? {}).length === 0) {
+    delete document.paths?.[meta.path];
+  }
+};
+const deleteOperationExample = (workspace, { meta: { path, method, exampleKey }, documentName }) => {
+  const document = workspace?.workspace.documents[documentName];
+  if (!document) {
+    return;
+  }
+  const operation = getResolvedRef(document.paths?.[path]?.[method]);
+  if (!operation) {
+    return;
+  }
+  operation.parameters?.forEach((parameter) => {
+    const resolvedParameter = getResolvedRef(parameter);
+    if ("content" in resolvedParameter && resolvedParameter.content) {
+      Object.values(resolvedParameter.content).forEach((mediaType) => {
+        delete mediaType.examples?.[exampleKey];
+      });
+    }
+    if ("examples" in resolvedParameter && resolvedParameter.examples) {
+      delete resolvedParameter.examples?.[exampleKey];
+    }
+  });
+  const requestBody = getResolvedRef(operation.requestBody);
+  if (!requestBody) {
+    return;
+  }
+  Object.values(requestBody.content ?? {}).forEach((mediaType) => {
+    delete mediaType.examples?.[exampleKey];
+  });
 };
 const addOperationParameter = (document, { meta, payload, type }) => {
   if (!document) {
@@ -212,7 +267,7 @@ const addOperationParameter = (document, { meta, payload, type }) => {
     examples: {
       [meta.exampleKey]: {
         value: payload.value,
-        "x-disabled": !payload.isEnabled
+        "x-disabled": Boolean(payload.isDisabled)
       }
     }
   });
@@ -241,12 +296,12 @@ const updateOperationParameter = (document, { meta, type, payload, index }) => {
   if (!example) {
     parameter.examples[meta.exampleKey] = {
       value: payload.value ?? "",
-      "x-disabled": payload.isEnabled === void 0 ? false : !payload.isEnabled
+      "x-disabled": Boolean(payload.isDisabled)
     };
     return;
   }
   example.value = payload.value ?? example?.value ?? "";
-  example["x-disabled"] = payload.isEnabled === void 0 ? example["x-disabled"] : !payload.isEnabled;
+  example["x-disabled"] = Boolean(payload.isDisabled ?? example["x-disabled"]);
 };
 const deleteOperationParameter = (document, { meta, index, type }) => {
   if (!document) {
@@ -262,7 +317,10 @@ const deleteOperationParameter = (document, { meta, index, type }) => {
     return;
   }
   const actualIndex = operation.parameters?.findIndex((it) => getResolvedRef(it) === parameter);
-  operation.parameters?.splice(actualIndex, 1);
+  operation.parameters = unpackProxyObject(
+    operation.parameters?.filter((_, i) => i !== actualIndex),
+    { depth: 1 }
+  );
 };
 const deleteAllOperationParameters = (document, { meta, type }) => {
   if (!document) {
@@ -274,6 +332,46 @@ const deleteAllOperationParameters = (document, { meta, type }) => {
   }
   operation.parameters = operation.parameters?.filter((it) => getResolvedRef(it).in !== type) ?? [];
 };
+const setHeader = ({
+  operation,
+  type,
+  name,
+  value,
+  exampleKey
+}) => {
+  if (!operation.parameters) {
+    operation.parameters = [];
+  }
+  const existingParameter = operation.parameters.find((param) => {
+    const resolvedParam = getResolvedRef(param);
+    return resolvedParam.name.toLowerCase() === name.toLowerCase() && resolvedParam.in === type;
+  });
+  if (!existingParameter) {
+    operation.parameters.push({
+      in: type,
+      name,
+      examples: {
+        [exampleKey]: {
+          value
+        }
+      }
+    });
+    return;
+  }
+  const resolvedParameter = getResolvedRef(existingParameter);
+  if (isContentTypeParameterObject(resolvedParameter)) {
+    return;
+  }
+  if (!resolvedParameter.examples) {
+    resolvedParameter.examples = {};
+  }
+  if (!resolvedParameter.examples[exampleKey]) {
+    resolvedParameter.examples[exampleKey] = {};
+  }
+  getResolvedRef(resolvedParameter.examples[exampleKey]).value = value;
+  return;
+};
+const SKIP_CONTENT_TYPE_HEADERS = ["other", "none"];
 const updateOperationRequestBodyContentType = (document, { meta, payload }) => {
   if (!document) {
     return;
@@ -293,6 +391,15 @@ const updateOperationRequestBodyContentType = (document, { meta, payload }) => {
     requestBody["x-scalar-selected-content-type"] = {};
   }
   requestBody["x-scalar-selected-content-type"][meta.exampleKey] = payload.contentType;
+  if (!SKIP_CONTENT_TYPE_HEADERS.includes(payload.contentType)) {
+    setHeader({
+      operation,
+      name: "Content-Type",
+      type: "header",
+      exampleKey: meta.exampleKey,
+      value: payload.contentType
+    });
+  }
 };
 const updateOperationRequestBodyExample = (document, { meta, payload, contentType }) => {
   if (!document) {
@@ -356,7 +463,8 @@ const addOperationRequestBodyFormRow = (document, { meta, payload, contentType }
       value: [
         {
           name: payload.key,
-          value: payload.value
+          value: payload.value,
+          isDisabled: false
         }
       ]
     };
@@ -364,7 +472,8 @@ const addOperationRequestBodyFormRow = (document, { meta, payload, contentType }
   }
   example.value.push({
     name: payload.key ?? "",
-    value: payload.value ?? ""
+    value: payload.value ?? "",
+    isDisabled: false
   });
 };
 const updateOperationRequestBodyFormRow = (document, { meta, index, payload, contentType }) => {
@@ -393,10 +502,12 @@ const updateOperationRequestBodyFormRow = (document, { meta, index, payload, con
   if (!example || !Array.isArray(example.value)) {
     return;
   }
-  example.value[index] = {
-    name: payload.key ?? example.value[index]?.name ?? "",
-    value: payload.value === null ? void 0 : payload.value ?? example.value[index]?.value ?? ""
-  };
+  for (const key of objectKeys(payload)) {
+    if (example.value[index]) {
+      preventPollution(key, "updateOperationRequestBodyFormRow");
+      example.value[index][key === "key" ? "name" : key] = payload[key];
+    }
+  }
 };
 const deleteOperationRequestBodyFormRow = (document, { meta, index, contentType }) => {
   if (!document) {
@@ -421,7 +532,10 @@ const deleteOperationRequestBodyFormRow = (document, { meta, index, contentType
   if (!example || !Array.isArray(example.value)) {
     return;
   }
-  example.value.splice(index, 1);
+  example.value = unpackProxyObject(
+    example.value.filter((_, i) => i !== index),
+    { depth: 1 }
+  );
   if (example.value.length === 0) {
     delete requestBody.content[contentType].examples[meta.exampleKey];
   }
@@ -431,11 +545,13 @@ export {
   addOperationRequestBodyFormRow,
   createOperation,
   deleteAllOperationParameters,
+  deleteOperation,
+  deleteOperationExample,
   deleteOperationParameter,
   deleteOperationRequestBodyFormRow,
-  updateOperationMethod,
+  setHeader,
   updateOperationParameter,
-  updateOperationPath,
+  updateOperationPathMethod,
   updateOperationRequestBodyContentType,
   updateOperationRequestBodyExample,
   updateOperationRequestBodyFormRow,