@scalar/workspace-store 0.17.1 → 0.18.1

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

@@ -0,0 +1,37 @@
+import type { CollectionType } from '../../events/definitions/common.js';
+import type { XScalarEnvVar, XScalarEnvironment } from '../../schemas/extensions/document/x-scalar-environments.js';
+/** Event definitions for all things environment related */
+export type EnvironmentEvents = {
+    /**
+     * Add OR update an environment
+     */
+    'environment:upsert:environment': {
+        environmentName: string;
+        payload: Partial<XScalarEnvironment>;
+        /** Only needed when renaming the environment */
+        oldEnvironmentName?: string;
+    } & CollectionType;
+    /**
+     * Add or update an environment variable
+     */
+    'environment:upsert:environment-variable': {
+        environmentName: string;
+        variable: XScalarEnvVar;
+        /** Only needed for update, omit it for add */
+        index?: number;
+    } & CollectionType;
+    /**
+     * Delete an environment
+     */
+    'environment:delete:environment': {
+        environmentName: string;
+    } & CollectionType;
+    /**
+     * Delete an environment variable by index
+     */
+    'environment:delete:environment-variable': {
+        environmentName: string;
+        index: number;
+    } & CollectionType;
+};
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAE5G,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,gCAAgC,EAAE;QAChC,eAAe,EAAE,MAAM,CAAA;QACvB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;QACpC,gDAAgD;QAChD,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC5B,GAAG,cAAc,CAAA;IAClB;;OAEG;IACH,yCAAyC,EAAE;QACzC,eAAe,EAAE,MAAM,CAAA;QACvB,QAAQ,EAAE,aAAa,CAAA;QACvB,8CAA8C;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,GAAG,cAAc,CAAA;IAClB;;OAEG;IACH,gCAAgC,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAA;IAC9E;;OAEG;IACH,yCAAyC,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAA;CACvG,CAAA"}

package/dist/events/definitions/environment.js

@@ -0,0 +1 @@
+//# sourceMappingURL=environment.js.map

package/dist/events/definitions/environment.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,12 @@
+import type { EnvironmentEvents } from '../../events/definitions/environment.js';
+import type { ServerObject } from '../../schemas/v3.1/strict/openapi-document.js';
+import type { AnalyticsEvents } from './analytics.js';
+import type { AuthEvents } from './auth.js';
+import type { DocumentEvents } from './document.js';
+import type { MetaEvents } from './meta.js';
+import type { OperationEvents } from './operation.js';
+import type { ServerEvents } from './server.js';
+import type { UIEvents } from './ui.js';
+export type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject> = AuthEvents & AnalyticsEvents & DocumentEvents & EnvironmentEvents & MetaEvents & OperationEvents & ServerEvents<T> & UIEvents;
+export type { CollectionType } from './common.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAEpC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,YAAY,IAAI,UAAU,GAC5F,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,UAAU,GACV,eAAe,GACf,YAAY,CAAC,CAAC,CAAC,GACf,QAAQ,CAAA;AAEV,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA"}

package/dist/events/definitions/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/events/definitions/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,17 @@
+import type { AvailableClients } from '@scalar/types/snippetz';
+/** Event definitions for the workspace/document meta */
+export type MetaEvents = {
+    /**
+     * Update the dark mode theme setting
+     */
+    'update:dark-mode': boolean;
+    /**
+     * Update the active document on the workspace
+     */
+    'update:active-document': string;
+    /**
+     * Update the selected client on the workspace
+     */
+    'update:selected-client': AvailableClients[number];
+};
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAA;IAChC;;OAEG;IACH,wBAAwB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;CACnD,CAAA"}

package/dist/events/definitions/meta.js

@@ -0,0 +1 @@
+//# sourceMappingURL=meta.js.map

package/dist/events/definitions/meta.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,11 @@
+/** Event definitions for the operation */
+export type OperationEvents = {
+    /**
+     * Update the selected example for the operation
+     */
+    'update:selected-example': {
+        /** The name of the example to select */
+        name: string;
+    };
+};
+//# sourceMappingURL=operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/operation.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,yBAAyB,EAAE;QACzB,wCAAwC;QACxC,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF,CAAA"}

package/dist/events/definitions/operation.js

@@ -0,0 +1 @@
+//# sourceMappingURL=operation.js.map

package/dist/events/definitions/operation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,50 @@
+import type { ServerObject } from '../../schemas/v3.1/strict/openapi-document.js';
+export type ServerEvents<T extends keyof ServerObject = keyof ServerObject> = {
+    /**
+     * Add a new server to the document
+     */
+    'add:server': {
+        /** The new server payload to add */
+        server: ServerObject;
+    };
+    /**
+     * Delete a server from the document
+     */
+    'delete:server': {
+        /** The URL of the server to delete */
+        url: string;
+    };
+    /**
+     * Update the selected server via URL
+     */
+    'update:selected-server': {
+        /** The new selected server URL */
+        url: string;
+    };
+    /**
+     * Update the selected server variable for the document
+     */
+    'update:selected-server-variables': {
+        /** The key of the variable to update */
+        key: string;
+        /** The new value of the variable */
+        value: string;
+    };
+    /**
+     * Update the selected server properties for the document
+     */
+    'update:selected-server-properties': {
+        /** The key of the property to update */
+        key: T;
+        /** The new value of the property */
+        value: ServerObject[T];
+    };
+    /**
+     * Replace all servers in the document
+     */
+    'update:all-servers': {
+        /** The new servers to replace the current servers with */
+        servers: ServerObject[];
+    };
+};
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAE1E,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,YAAY,IAAI;IAC5E;;OAEG;IACH,YAAY,EAAE;QACZ,oCAAoC;QACpC,MAAM,EAAE,YAAY,CAAA;KACrB,CAAA;IACD;;OAEG;IACH,eAAe,EAAE;QACf,sCAAsC;QACtC,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD;;OAEG;IACH,wBAAwB,EAAE;QACxB,kCAAkC;QAClC,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;IACD;;OAEG;IACH,kCAAkC,EAAE;QAClC,wCAAwC;QACxC,GAAG,EAAE,MAAM,CAAA;QACX,oCAAoC;QACpC,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;OAEG;IACH,mCAAmC,EAAE;QACnC,wCAAwC;QACxC,GAAG,EAAE,CAAC,CAAA;QACN,oCAAoC;QACpC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;KACvB,CAAA;IACD;;OAEG;IACH,oBAAoB,EAAE;QACpB,0DAA0D;QAC1D,OAAO,EAAE,YAAY,EAAE,CAAA;KACxB,CAAA;CACF,CAAA"}

package/dist/events/definitions/server.js

@@ -0,0 +1 @@
+//# sourceMappingURL=server.js.map

package/dist/events/definitions/server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,52 @@
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+/** Event definitions to control the ui */
+export type UIEvents = {
+    /**
+     * Download the document from the store
+     */
+    'download:document': {
+        /** Format to download the document in */
+        format: 'json' | 'yaml' | 'direct';
+    };
+    /**
+     * Open the Api Client modal to a specific operation
+     */
+    'open:client': {
+        /** The HTTP method of the operation to load */
+        method: HttpMethod;
+        /** The path of the operation to load */
+        path: string;
+    };
+    /**
+     * Open our command palette
+     */
+    'open:command-palette': 'import' | 'addServer' | 'addCollection' | 'addTag' | 'addExample' | 'addOperation' | undefined;
+    /** Set a navigation item's (such as a tag or operation) expanded state */
+    'toggle:nav-item': {
+        /** The name of the nav item to toggle */
+        id: string;
+        /** Optional defined state for the nav item. */
+        open?: boolean;
+    };
+    /** Select a navigation item. Run on sidebar clicks where a scroll handler would typically be expected */
+    'select:nav-item': {
+        /** The id of the nav item to select */
+        id: string;
+    };
+    /** Fired when a navigation item intersects with the viewport */
+    'intersecting:nav-item': {
+        /** The id of the nav item that is intersecting */
+        id: string;
+    };
+    /** Explicity scroll to a navigation item */
+    'scroll-to:nav-item': {
+        /** The id of the nav item to scroll to */
+        id: string;
+    };
+    /** Copy the url including anchor details for a navigation item */
+    'copy-url:nav-item': {
+        /** The id of the nav item to copy the anchor url for */
+        id: string;
+    };
+};
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/events/definitions/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,0CAA0C;AAC1C,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,mBAAmB,EAAE;QACnB,yCAAyC;QACzC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;KACnC,CAAA;IACD;;OAEG;IACH,aAAa,EAAE;QACb,+CAA+C;QAC/C,MAAM,EAAE,UAAU,CAAA;QAClB,wCAAwC;QACxC,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD;;OAEG;IACH,sBAAsB,EAClB,QAAQ,GACR,WAAW,GACX,eAAe,GACf,QAAQ,GACR,YAAY,GACZ,cAAc,GACd,SAAS,CAAA;IAEb,0EAA0E;IAC1E,iBAAiB,EAAE;QACjB,yCAAyC;QACzC,EAAE,EAAE,MAAM,CAAA;QACV,+CAA+C;QAC/C,IAAI,CAAC,EAAE,OAAO,CAAA;KACf,CAAA;IAED,yGAAyG;IACzG,iBAAiB,EAAE;QACjB,uCAAuC;QACvC,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;IAED,gEAAgE;IAChE,uBAAuB,EAAE;QACvB,kDAAkD;QAClD,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;IAED,4CAA4C;IAC5C,oBAAoB,EAAE;QACpB,0CAA0C;QAC1C,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;IAED,kEAAkE;IAClE,mBAAmB,EAAE;QACnB,wDAAwD;QACxD,EAAE,EAAE,MAAM,CAAA;KACX,CAAA;CACF,CAAA"}

package/dist/events/definitions/ui.js

@@ -0,0 +1 @@
+//# sourceMappingURL=ui.js.map

package/dist/events/definitions/ui.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/events/index.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAA;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/events/index.js

@@ -1,6 +1,8 @@
-import { emitCustomEvent } from "./definitions.js";
+import { createWorkspaceEventBus } from "./bus.js";
 import { onCustomEvent } from "./listeners.js";
+import { emitCustomEvent } from "./old-definitions.js";
 export {
+  createWorkspaceEventBus,
   emitCustomEvent,
   onCustomEvent
 };

package/dist/events/index.js.map

@@ -1,7 +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;",
+  "sourcesContent": ["// biome-ignore lint/performance/noBarrelFile: Entry point for /events\nexport { type WorkspaceEventBus, createWorkspaceEventBus } from './bus'\nexport type { CollectionType } from './definitions'\nexport { onCustomEvent } from './listeners'\nexport { type ApiReferenceEvent, type ApiReferenceEvents, emitCustomEvent } from './old-definitions'\n"],
+  "mappings": "AACA,SAAiC,+BAA+B;AAEhE,SAAS,qBAAqB;AAC9B,SAA0D,uBAAuB;",
   "names": []
 }

package/dist/events/listeners.d.ts

@@ -1,8 +1,9 @@
 import { type Ref } from 'vue';
-import type { ApiReferenceEvent, ApiReferenceEvents } from './definitions.js';
+import type { ApiReferenceEvent, ApiReferenceEvents } from './old-definitions.js';
 /**
  * Vue wrapper for attaching and removing event listeners
  *
+ * @deprecated Use the the event bus instead
  */
 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

@@ -1 +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"}
+{"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,mBAAmB,CAAA;AAE9E;;;;GAIG;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.map

@@ -1,7 +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;",
+  "sourcesContent": ["import { type Ref, onBeforeUnmount, watch } from 'vue'\n\nimport type { ApiReferenceEvent, ApiReferenceEvents } from './old-definitions'\n\n/**\n * Vue wrapper for attaching and removing event listeners\n *\n * @deprecated Use the the event bus instead\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;AAS1C,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/events/{definitions.d.ts → old-definitions.d.ts}

@@ -1,3 +1,4 @@
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
 import type { AvailableClients } from '@scalar/snippetz';
 import type { Simplify } from 'type-fest';
 import type { ServerObject } from '../schemas/v3.1/strict/openapi-document.js';
@@ -5,18 +6,11 @@ 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.
+ *
+ * @deprecated use the new definitions instead
  */
 export type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject> = {
-    'scalar-update-sidebar': {
-        detail: {
-            value: boolean;
-        };
-    };
-    'scalar-update-dark-mode': {
-        detail: {
-            value: boolean;
-        };
-    };
+    /** Store mutation events */
     'scalar-update-active-document': {
         detail: {
             value: string;
@@ -144,12 +138,42 @@ export type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject
             uid: string;
         };
     };
+    /** UI Events. Allows users to tie into UI events as needed */
+    /** Download the document from the store */
+    'scalar-download-document': {
+        detail: {
+            format: 'json' | 'yaml' | 'direct';
+        };
+    };
+    /** Add a new document to the store */
+    'scalar-open-client': {
+        detail: {
+            method: HttpMethod;
+            path: string;
+        };
+    };
+    /** Fired when the user clicks the "Show more" button on the references */
+    'scalar-on-show-more': {
+        detail: {
+            id: string;
+        };
+    };
+    'scalar-on-loaded': {
+        detail: {};
+    };
+    'scalar-update-dark-mode': {
+        detail: {
+            value: boolean;
+        };
+    };
 };
 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.
+ *
+ * @deprecated Use the the event bus instead
  */
 export declare function emitCustomEvent<E extends ApiReferenceEvent>(target: HTMLElement | null | undefined, event: E, detail: ApiReferenceEvents[E]['detail']): void;
-//# sourceMappingURL=definitions.d.ts.map
+//# sourceMappingURL=old-definitions.d.ts.map

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

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

package/dist/events/{definitions.js → old-definitions.js}

@@ -10,4 +10,4 @@ function emitCustomEvent(target, event, detail) {
 export {
   emitCustomEvent
 };
-//# sourceMappingURL=definitions.js.map
+//# sourceMappingURL=old-definitions.js.map

package/dist/events/old-definitions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/events/old-definitions.ts"],
+  "sourcesContent": ["import type { HttpMethod } from '@scalar/helpers/http/http-methods'\nimport 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 *\n * @deprecated use the new definitions instead\n */\nexport type ApiReferenceEvents<T extends keyof ServerObject = keyof ServerObject> = {\n  // ---------------------------------------------------------------------------\n  /** Store mutation events */\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  // ---------------------------------------------------------------------------\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  /** UI Events. Allows users to tie into UI events as needed */\n\n  /** Download the document from the store */\n  'scalar-download-document': {\n    detail: {\n      format: 'json' | 'yaml' | 'direct'\n    }\n  }\n  /** Add a new document to the store */\n  'scalar-open-client': {\n    detail: {\n      method: HttpMethod\n      path: string\n    }\n  }\n  /** Fired when the user clicks the \"Show more\" button on the references */\n  'scalar-on-show-more': {\n    detail: {\n      id: string\n    }\n  }\n  'scalar-on-loaded': {\n    detail: {}\n  }\n  'scalar-update-dark-mode': {\n    detail: {\n      value: boolean\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 *\n * @deprecated Use the the event bus instead\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": "AA+LO,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/helpers/debounce.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Options for configuring the debounce behavior.
+ */
+export type DebounceOptions = {
+    /** The delay in milliseconds before executing the function. Defaults to 100ms. */
+    delay?: number;
+    /** Custom separator for joining key parts. Defaults to a null byte to prevent collisions. */
+    separator?: string;
+};
+/**
+ * Creates a debounced function executor that delays execution until after a specified time.
+ * Multiple calls with the same key will cancel previous pending executions.
+ *
+ * This is useful for batching rapid updates (like auto-save or API calls) to avoid
+ * unnecessary processing or network requests.
+ *
+ * @param options - Configuration options for delay and key separator
+ * @returns A function that accepts a key array and callback to execute
+ *
+ * @example
+ * const debouncedSave = debounce({ delay: 500 })
+ * debouncedSave(['user', '123'], () => saveUser(user))
+ */
+export declare const debounce: (options?: DebounceOptions) => {
+    execute: (key: readonly string[], fn: () => unknown | Promise<unknown>) => void;
+    cleanup: () => void;
+};
+//# sourceMappingURL=debounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/helpers/debounce.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAS,eAAoB;mBAsB9B,SAAS,MAAM,EAAE,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAG,IAAI;mBAdhE,IAAI;CAyCzB,CAAA"}

package/dist/helpers/debounce.js

@@ -0,0 +1,31 @@
+const debounce = (options = {}) => {
+  const { delay = 100, separator = "\0" } = options;
+  const timeouts = /* @__PURE__ */ new Map();
+  const cleanup = () => {
+    for (const timeout of timeouts.values()) {
+      clearTimeout(timeout);
+    }
+    timeouts.clear();
+  };
+  const execute = (key, fn) => {
+    const compositeKey = `${key.join(separator)}-${key.length}`;
+    const existingTimeout = timeouts.get(compositeKey);
+    if (existingTimeout !== void 0) {
+      clearTimeout(existingTimeout);
+    }
+    const timeout = setTimeout(() => {
+      try {
+        fn();
+      } catch {
+      } finally {
+        timeouts.delete(compositeKey);
+      }
+    }, delay);
+    timeouts.set(compositeKey, timeout);
+  };
+  return { execute, cleanup };
+};
+export {
+  debounce
+};
+//# sourceMappingURL=debounce.js.map

package/dist/helpers/debounce.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/debounce.ts"],
+  "sourcesContent": ["/**\n * Options for configuring the debounce behavior.\n */\nexport type DebounceOptions = {\n  /** The delay in milliseconds before executing the function. Defaults to 100ms. */\n  delay?: number\n  /** Custom separator for joining key parts. Defaults to a null byte to prevent collisions. */\n  separator?: string\n}\n\n/**\n * Creates a debounced function executor that delays execution until after a specified time.\n * Multiple calls with the same key will cancel previous pending executions.\n *\n * This is useful for batching rapid updates (like auto-save or API calls) to avoid\n * unnecessary processing or network requests.\n *\n * @param options - Configuration options for delay and key separator\n * @returns A function that accepts a key array and callback to execute\n *\n * @example\n * const debouncedSave = debounce({ delay: 500 })\n * debouncedSave(['user', '123'], () => saveUser(user))\n */\nexport const debounce = (options: DebounceOptions = {}) => {\n  const { delay = 100, separator = '\\0' } = options\n  const timeouts = new Map<string, ReturnType<typeof setTimeout>>()\n\n  /**\n   * Cleanup function to clear all pending timeouts.\n   * Call this when you need to cancel all pending operations (e.g., component unmount).\n   */\n  const cleanup = (): void => {\n    for (const timeout of timeouts.values()) {\n      clearTimeout(timeout)\n    }\n    timeouts.clear()\n  }\n\n  /**\n   * Schedules a function to run after the configured delay.\n   * If called again with the same key before the delay expires, the previous call is cancelled.\n   *\n   * @param key - Array of strings to uniquely identify this operation\n   * @param fn - The function to execute after the delay\n   */\n  const execute = (key: readonly string[], fn: () => unknown | Promise<unknown>): void => {\n    // Add the length of the key to the composite key to prevent collisions\n    const compositeKey = `${key.join(separator)}-${key.length}`\n\n    // Cancel any existing timeout for this key\n    const existingTimeout = timeouts.get(compositeKey)\n    if (existingTimeout !== undefined) {\n      clearTimeout(existingTimeout)\n    }\n\n    // Schedule the new timeout\n    const timeout = setTimeout(() => {\n      try {\n        // biome-ignore lint/nursery/noFloatingPromises: No need to await for the result, fire and forget\n        fn()\n      } catch {\n        // do not throw if the function throws\n      } finally {\n        // Always clean up the timeout reference, even if fn throws\n        timeouts.delete(compositeKey)\n      }\n    }, delay)\n\n    timeouts.set(compositeKey, timeout)\n  }\n\n  return { execute, cleanup }\n}\n"],
+  "mappings": "AAwBO,MAAM,WAAW,CAAC,UAA2B,CAAC,MAAM;AACzD,QAAM,EAAE,QAAQ,KAAK,YAAY,KAAK,IAAI;AAC1C,QAAM,WAAW,oBAAI,IAA2C;AAMhE,QAAM,UAAU,MAAY;AAC1B,eAAW,WAAW,SAAS,OAAO,GAAG;AACvC,mBAAa,OAAO;AAAA,IACtB;AACA,aAAS,MAAM;AAAA,EACjB;AASA,QAAM,UAAU,CAAC,KAAwB,OAA+C;AAEtF,UAAM,eAAe,GAAG,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,MAAM;AAGzD,UAAM,kBAAkB,SAAS,IAAI,YAAY;AACjD,QAAI,oBAAoB,QAAW;AACjC,mBAAa,eAAe;AAAA,IAC9B;AAGA,UAAM,UAAU,WAAW,MAAM;AAC/B,UAAI;AAEF,WAAG;AAAA,MACL,QAAQ;AAAA,MAER,UAAE;AAEA,iBAAS,OAAO,YAAY;AAAA,MAC9B;AAAA,IACF,GAAG,KAAK;AAER,aAAS,IAAI,cAAc,OAAO;AAAA,EACpC;AAEA,SAAO,EAAE,SAAS,QAAQ;AAC5B;",
+  "names": []
+}

package/dist/helpers/detect-changes-proxy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * createDetectChangesProxy - Creates a proxy for an object or array that detects and triggers hooks on changes.
+ *
+ * This proxy enables detection of set operations, triggering optional hooks (onBeforeChange, onAfterChange) with the path and value changed.
+ * The proxy can be applied recursively to all nested objects/arrays, and caches proxies to prevent creating multiple proxies for the same object.
+ *
+ * Example usage:
+ *
+ * const obj = { foo: 1, bar: { baz: 2 } };
+ * const proxy = createDetectChangesProxy(obj, {
+ *   hooks: {
+ *     onBeforeChange: (path, value) => console.log('Before', path, value),
+ *     onAfterChange: (path, value) => console.log('After', path, value),
+ *   }
+ * });
+ * proxy.foo = 42; // Console: Before ['foo'] '42', After ['foo'] '42'
+ * proxy.bar.baz = 99; // Console: Before ['bar', 'baz'] '99', After ['bar', 'baz'] '99'
+ *
+ * @param target The target object or array to wrap in a proxy
+ * @param options Optional: hooks for change detection
+ * @param args Internal: proxy cache and current property path (used for recursion)
+ * @returns The proxied object/array with change detection capabilities
+ */
+export declare const createDetectChangesProxy: <T>(target: T, options?: {
+    hooks: Partial<{
+        onBeforeChange: (path: string[], value: unknown) => void;
+        onAfterChange: (path: string[], value: unknown) => void;
+    }>;
+}, args?: {
+    /** Cache for storing proxies */
+    proxyCache: WeakMap<object, unknown>;
+    /** Path for the target */
+    path: string[];
+}) => T;
+export declare const isDetectChangesProxyObject: (obj: unknown) => boolean;
+/**
+ * Returns the raw/original (non-proxy) object if the passed object is a detect-changes proxy.
+ * If the object is not a proxy, it returns the same object.
+ *
+ * @example
+ * const proxy = createDetectChangesProxy({ a: 1 });
+ * const raw = unpackDetectChangesProxy(proxy); // Gets the original object { a: 1 }
+ * const notProxy = { b: 2 };
+ * const stillRaw = unpackDetectChangesProxy(notProxy); // Returns { b: 2 }, unchanged
+ */
+export declare const unpackDetectChangesProxy: <T>(obj: T) => T;
+//# sourceMappingURL=detect-changes-proxy.d.ts.map

package/dist/helpers/detect-changes-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-changes-proxy.d.ts","sourceRoot":"","sources":["../../src/helpers/detect-changes-proxy.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EACxC,QAAQ,CAAC,EACT,UAAU;IACR,KAAK,EAAE,OAAO,CAAC;QACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;QACxD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;KACxD,CAAC,CAAA;CACH,EACD,OAAM;IACJ,gCAAgC;IAChC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAA;CAIf,KACA,CA6CF,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,KAAK,OAAO,KAAG,OAMzD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,KAAK,CAAC,KAAG,CAWpD,CAAA"}