@scalar/workspace-store 0.17.0 → 0.18.0

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,4 @@
-export { type ApiReferenceEvent, type ApiReferenceEvents, emitCustomEvent } from './definitions.js';
+export { type WorkspaceEventBus, createWorkspaceEventBus } from './bus.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,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 { onCustomEvent } from './listeners'\nexport { type ApiReferenceEvent, type ApiReferenceEvents, emitCustomEvent } from './old-definitions'\n"],
+  "mappings": "AACA,SAAiC,+BAA+B;AAChE,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"}

package/dist/helpers/detect-changes-proxy.js

@@ -0,0 +1,59 @@
+import { isObject } from "../helpers/general.js";
+const isDetectChangesProxy = Symbol("isDetectChangesProxy");
+const detectChangesProxyTarget = Symbol("detectChangesProxyTarget");
+const isPropsVue = (prop) => {
+  return typeof prop === "symbol" || prop === "__v_isReactive" || prop === "__v_isReadonly" || prop === "__v_raw" || prop === "__v_skip";
+};
+const createDetectChangesProxy = (target, options, args = {
+  proxyCache: /* @__PURE__ */ new WeakMap(),
+  path: []
+}) => {
+  if (!isObject(target) && !Array.isArray(target)) {
+    return target;
+  }
+  if (args.proxyCache.has(target)) {
+    return args.proxyCache.get(target);
+  }
+  const proxy = new Proxy(target, {
+    get(target2, prop, receiver) {
+      if (prop === isDetectChangesProxy) {
+        return true;
+      }
+      if (prop === detectChangesProxyTarget) {
+        return target2;
+      }
+      const value = Reflect.get(target2, prop, receiver);
+      if (isDetectChangesProxyObject(value) || isPropsVue(prop)) {
+        return value;
+      }
+      return createDetectChangesProxy(value, options, { ...args, path: [...args.path, String(prop)] });
+    },
+    set(target2, prop, value, receiver) {
+      const path = [...args.path, String(prop)];
+      options?.hooks?.onBeforeChange?.(path, value);
+      const result = Reflect.set(target2, prop, value, receiver);
+      options?.hooks?.onAfterChange?.(path, value);
+      return result;
+    }
+  });
+  args.proxyCache.set(target, proxy);
+  return proxy;
+};
+const isDetectChangesProxyObject = (obj) => {
+  return typeof obj === "object" && obj !== null && obj[isDetectChangesProxy] === true;
+};
+const unpackDetectChangesProxy = (obj) => {
+  if (typeof obj !== "object" || obj === null) {
+    return obj;
+  }
+  if (obj[isDetectChangesProxy]) {
+    return obj[detectChangesProxyTarget];
+  }
+  return obj;
+};
+export {
+  createDetectChangesProxy,
+  isDetectChangesProxyObject,
+  unpackDetectChangesProxy
+};
+//# sourceMappingURL=detect-changes-proxy.js.map

package/dist/helpers/detect-changes-proxy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/detect-changes-proxy.ts"],
+  "sourcesContent": ["import { isObject } from '@/helpers/general'\n\nconst isDetectChangesProxy = Symbol('isDetectChangesProxy')\nconst detectChangesProxyTarget = Symbol('detectChangesProxyTarget')\n\nconst isPropsVue = (prop: string | Symbol) => {\n  return (\n    typeof prop === 'symbol' ||\n    prop === '__v_isReactive' ||\n    prop === '__v_isReadonly' ||\n    prop === '__v_raw' ||\n    prop === '__v_skip'\n  )\n}\n\n/**\n * createDetectChangesProxy - Creates a proxy for an object or array that detects and triggers hooks on changes.\n *\n * This proxy enables detection of set operations, triggering optional hooks (onBeforeChange, onAfterChange) with the path and value changed.\n * The proxy can be applied recursively to all nested objects/arrays, and caches proxies to prevent creating multiple proxies for the same object.\n *\n * Example usage:\n *\n * const obj = { foo: 1, bar: { baz: 2 } };\n * const proxy = createDetectChangesProxy(obj, {\n *   hooks: {\n *     onBeforeChange: (path, value) => console.log('Before', path, value),\n *     onAfterChange: (path, value) => console.log('After', path, value),\n *   }\n * });\n * proxy.foo = 42; // Console: Before ['foo'] '42', After ['foo'] '42'\n * proxy.bar.baz = 99; // Console: Before ['bar', 'baz'] '99', After ['bar', 'baz'] '99'\n *\n * @param target The target object or array to wrap in a proxy\n * @param options Optional: hooks for change detection\n * @param args Internal: proxy cache and current property path (used for recursion)\n * @returns The proxied object/array with change detection capabilities\n */\nexport const createDetectChangesProxy = <T>(\n  target: T,\n  options?: {\n    hooks: Partial<{\n      onBeforeChange: (path: string[], value: unknown) => void\n      onAfterChange: (path: string[], value: unknown) => void\n    }>\n  },\n  args: {\n    /** Cache for storing proxies */\n    proxyCache: WeakMap<object, unknown>\n    /** Path for the target */\n    path: string[]\n  } = {\n    proxyCache: new WeakMap<object, unknown>(),\n    path: [],\n  },\n): T => {\n  // Only wrap objects or arrays\n  if (!isObject(target) && !Array.isArray(target)) {\n    return target\n  }\n\n  // Return cached proxy if already created for this target\n  if (args.proxyCache.has(target)) {\n    return args.proxyCache.get(target)! as T\n  }\n\n  const proxy = new Proxy(target, {\n    get(target, prop, receiver) {\n      // Allow identifying if an object is a detect changes proxy\n      if (prop === isDetectChangesProxy) {\n        return true\n      }\n      // Allow access to the original target\n      if (prop === detectChangesProxyTarget) {\n        return target\n      }\n\n      // Recursively wrap property values in the detect changes proxy\n      const value = Reflect.get(target, prop, receiver)\n\n      if (isDetectChangesProxyObject(value) || isPropsVue(prop)) {\n        return value\n      }\n\n      return createDetectChangesProxy(value, options, { ...args, path: [...args.path, String(prop)] })\n    },\n    set(target, prop, value, receiver) {\n      const path = [...args.path, String(prop)]\n      // Call before-change hook if provided\n      options?.hooks?.onBeforeChange?.(path, value)\n      const result = Reflect.set(target, prop, value, receiver)\n      // Call after-change hook if provided\n      options?.hooks?.onAfterChange?.(path, value)\n      return result\n    },\n  })\n\n  // Cache the proxy for this target\n  args.proxyCache.set(target, proxy)\n  return proxy\n}\n\nexport const isDetectChangesProxyObject = (obj: unknown): boolean => {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    (obj as { [isDetectChangesProxy]: boolean })[isDetectChangesProxy] === true\n  )\n}\n\n/**\n * Returns the raw/original (non-proxy) object if the passed object is a detect-changes proxy.\n * If the object is not a proxy, it returns the same object.\n *\n * @example\n * const proxy = createDetectChangesProxy({ a: 1 });\n * const raw = unpackDetectChangesProxy(proxy); // Gets the original object { a: 1 }\n * const notProxy = { b: 2 };\n * const stillRaw = unpackDetectChangesProxy(notProxy); // Returns { b: 2 }, unchanged\n */\nexport const unpackDetectChangesProxy = <T>(obj: T): T => {\n  if (typeof obj !== 'object' || obj === null) {\n    return obj\n  }\n\n  // If object is a detect-changes proxy, return its underlying target\n  if ((obj as T & { [isDetectChangesProxy]: boolean | undefined })[isDetectChangesProxy]) {\n    return (obj as T & { [detectChangesProxyTarget]: T })[detectChangesProxyTarget]\n  }\n\n  return obj\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AAEzB,MAAM,uBAAuB,OAAO,sBAAsB;AAC1D,MAAM,2BAA2B,OAAO,0BAA0B;AAElE,MAAM,aAAa,CAAC,SAA0B;AAC5C,SACE,OAAO,SAAS,YAChB,SAAS,oBACT,SAAS,oBACT,SAAS,aACT,SAAS;AAEb;AAyBO,MAAM,2BAA2B,CACtC,QACA,SAMA,OAKI;AAAA,EACF,YAAY,oBAAI,QAAyB;AAAA,EACzC,MAAM,CAAC;AACT,MACM;AAEN,MAAI,CAAC,SAAS,MAAM,KAAK,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC/C,WAAO;AAAA,EACT;AAGA,MAAI,KAAK,WAAW,IAAI,MAAM,GAAG;AAC/B,WAAO,KAAK,WAAW,IAAI,MAAM;AAAA,EACnC;AAEA,QAAM,QAAQ,IAAI,MAAM,QAAQ;AAAA,IAC9B,IAAIA,SAAQ,MAAM,UAAU;AAE1B,UAAI,SAAS,sBAAsB;AACjC,eAAO;AAAA,MACT;AAEA,UAAI,SAAS,0BAA0B;AACrC,eAAOA;AAAA,MACT;AAGA,YAAM,QAAQ,QAAQ,IAAIA,SAAQ,MAAM,QAAQ;AAEhD,UAAI,2BAA2B,KAAK,KAAK,WAAW,IAAI,GAAG;AACzD,eAAO;AAAA,MACT;AAEA,aAAO,yBAAyB,OAAO,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,KAAK,MAAM,OAAO,IAAI,CAAC,EAAE,CAAC;AAAA,IACjG;AAAA,IACA,IAAIA,SAAQ,MAAM,OAAO,UAAU;AACjC,YAAM,OAAO,CAAC,GAAG,KAAK,MAAM,OAAO,IAAI,CAAC;AAExC,eAAS,OAAO,iBAAiB,MAAM,KAAK;AAC5C,YAAM,SAAS,QAAQ,IAAIA,SAAQ,MAAM,OAAO,QAAQ;AAExD,eAAS,OAAO,gBAAgB,MAAM,KAAK;AAC3C,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AAGD,OAAK,WAAW,IAAI,QAAQ,KAAK;AACjC,SAAO;AACT;AAEO,MAAM,6BAA6B,CAAC,QAA0B;AACnE,SACE,OAAO,QAAQ,YACf,QAAQ,QACP,IAA4C,oBAAoB,MAAM;AAE3E;AAYO,MAAM,2BAA2B,CAAI,QAAc;AACxD,MAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAC3C,WAAO;AAAA,EACT;AAGA,MAAK,IAA4D,oBAAoB,GAAG;AACtF,WAAQ,IAA8C,wBAAwB;AAAA,EAChF;AAEA,SAAO;AACT;",
+  "names": ["target"]
+}

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

@@ -1,4 +1,4 @@
-import { type UnknownObject } from '../helpers/general.js';
+export declare const getOverridesTarget: unique symbol;
 /**
  * Recursively makes all properties of a type optional.
  *
@@ -23,14 +23,14 @@ export type DeepPartial<T> = T extends object ? {
  * - Special symbols are used to identify the proxy and to access the original target.
  *
  * @template T - The type of the target object.
- * @param targetObject - The original object to proxy.
+ * @param target - The original object to proxy.
  * @param overrides - An optional object containing override values (deeply partial).
  * @returns A proxy object that reflects overrides on top of the target.
  *
  * @example
  * const original = { a: 1, b: { c: 2 } }
  * const overrides = { b: { c: 42 } }
- * const proxy = createOverridesProxy(original, overrides)
+ * const proxy = createOverridesProxy(original, { overrides })
  *
  * console.log(proxy.a) // 1 (from original)
  * console.log(proxy.b.c) // 42 (from overrides)
@@ -41,7 +41,18 @@ export type DeepPartial<T> = T extends object ? {
  * proxy.b.c = 99
  * console.log(overrides.b.c) // 99
  */
-export declare const createOverridesProxy: <T extends Record<string, unknown>>(targetObject: T, overrides?: DeepPartial<T>) => T;
-export declare const TARGET_SYMBOL: unique symbol;
-export declare function unpackOverridesProxy<T extends UnknownObject>(obj: T): T;
+export declare const createOverridesProxy: <T extends Record<string, unknown>>(target: T, options?: {
+    overrides?: DeepPartial<T>;
+}, args?: {
+    cache: WeakMap<object, any>;
+}) => T;
+export declare const isOverridesProxyObject: (obj: unknown) => boolean;
+/**
+ * Unpacks an object from the overrides proxy, returning the original (unproxied) target object.
+ * If the input is not an overrides proxy, returns the object as-is.
+ *
+ * @param input - The potentially proxied object
+ * @returns The original unproxied target object or the input object
+ */
+export declare function unpackOverridesProxy<T>(input: T): T;
 //# sourceMappingURL=overrides-proxy.d.ts.map

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,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"}
+{"version":3,"file":"overrides-proxy.d.ts","sourceRoot":"","sources":["../../src/helpers/overrides-proxy.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,eAA+B,CAAA;AAE9D;;;;;;;;;;;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,QAAQ,CAAC,EACT,UAAU;IACR,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAC3B,EACD,OAAM;IACJ,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAG5B,KACA,CAgEF,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,KAAK,OAAO,KAAG,OAErD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMnD"}