@scalar/workspace-store 0.17.1 → 0.18.1

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"}

package/dist/helpers/overrides-proxy.js

@@ -1,25 +1,35 @@
 import { isObject } from "../helpers/general.js";
 const isOverridesProxy = Symbol("isOverridesProxy");
-const createOverridesProxy = (targetObject, overrides) => {
-  if (!targetObject || typeof targetObject !== "object") {
-    return targetObject;
+const getOverridesTarget = Symbol("getOverridesTarget");
+const createOverridesProxy = (target, options, args = {
+  cache: /* @__PURE__ */ new WeakMap()
+}) => {
+  if (!target || typeof target !== "object") {
+    return target;
   }
+  if (args.cache.has(target)) {
+    return args.cache.get(target);
+  }
+  const { overrides } = options ?? {};
   const handler = {
-    get(target, prop, receiver) {
+    get(target2, prop, receiver) {
       if (prop === isOverridesProxy) {
         return true;
       }
-      if (prop === TARGET_SYMBOL) {
-        return target;
+      if (prop === getOverridesTarget) {
+        return target2;
+      }
+      const value = Reflect.get(target2, prop, receiver);
+      if (isOverridesProxyObject(value)) {
+        return value;
       }
-      const value = Reflect.get(target, prop, receiver);
       if (!isObject(value)) {
         return Reflect.get(overrides ?? {}, prop) ?? value;
       }
-      return createOverridesProxy(value, Reflect.get(overrides ?? {}, prop));
+      return createOverridesProxy(value, { overrides: Reflect.get(overrides ?? {}, prop) }, args);
     },
-    set(target, prop, value, receiver) {
-      if (prop === isOverridesProxy || prop === TARGET_SYMBOL) {
+    set(target2, prop, value, receiver) {
+      if (prop === isOverridesProxy || prop === getOverridesTarget) {
         return false;
       }
       const hasOverride = overrides && Reflect.has(overrides, prop);
@@ -28,21 +38,26 @@ const createOverridesProxy = (targetObject, overrides) => {
         overrides[prop] = value;
         return true;
       }
-      return Reflect.set(target, prop, value, receiver);
+      return Reflect.set(target2, prop, value, receiver);
     }
   };
-  return new Proxy(targetObject, handler);
+  const proxy = new Proxy(target, handler);
+  args.cache.set(target, proxy);
+  return proxy;
+};
+const isOverridesProxyObject = (obj) => {
+  return typeof obj === "object" && obj !== null && obj[isOverridesProxy] === true;
 };
-const TARGET_SYMBOL = Symbol("overridesProxyTarget");
-function unpackOverridesProxy(obj) {
-  if (obj[isOverridesProxy]) {
-    return obj[TARGET_SYMBOL];
+function unpackOverridesProxy(input) {
+  if (input[isOverridesProxy]) {
+    return input[getOverridesTarget];
   }
-  return obj;
+  return input;
 }
 export {
-  TARGET_SYMBOL,
   createOverridesProxy,
+  getOverridesTarget,
+  isOverridesProxyObject,
   unpackOverridesProxy
 };
 //# sourceMappingURL=overrides-proxy.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Unpacks special vue reactivity & override & detect-changes & magic proxy from an input object or array,
+ * returning the "raw" plain object or array.
+ */
+export declare const unpackProxyObject: <T extends object | Array<unknown>>(input: T) => T;
+//# sourceMappingURL=unpack-proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unpack-proxy.d.ts","sourceRoot":"","sources":["../../src/helpers/unpack-proxy.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,KAAG,CACV,CAAA"}

package/dist/helpers/unpack-proxy.js

@@ -0,0 +1,9 @@
+import { getRaw } from "@scalar/json-magic/magic-proxy";
+import { toRaw } from "vue";
+import { unpackDetectChangesProxy } from "../helpers/detect-changes-proxy.js";
+import { unpackOverridesProxy } from "../helpers/overrides-proxy.js";
+const unpackProxyObject = (input) => unpackDetectChangesProxy(toRaw(getRaw(unpackOverridesProxy(input))));
+export {
+  unpackProxyObject
+};
+//# sourceMappingURL=unpack-proxy.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/helpers/unpack-proxy.ts"],
+  "sourcesContent": ["import { getRaw } from '@scalar/json-magic/magic-proxy'\nimport { toRaw } from 'vue'\n\nimport { unpackDetectChangesProxy } from '@/helpers/detect-changes-proxy'\nimport { unpackOverridesProxy } from '@/helpers/overrides-proxy'\n\n/**\n * Unpacks special vue reactivity & override & detect-changes & magic proxy from an input object or array,\n * returning the \"raw\" plain object or array.\n */\nexport const unpackProxyObject = <T extends object | Array<unknown>>(input: T): T =>\n  unpackDetectChangesProxy(toRaw(getRaw(unpackOverridesProxy(input))))\n"],
+  "mappings": "AAAA,SAAS,cAAc;AACvB,SAAS,aAAa;AAEtB,SAAS,gCAAgC;AACzC,SAAS,4BAA4B;AAM9B,MAAM,oBAAoB,CAAoC,UACnE,yBAAyB,MAAM,OAAO,qBAAqB,KAAK,CAAC,CAAC,CAAC;",
+  "names": []
+}

package/dist/mutators/environment.d.ts

@@ -1,17 +1,25 @@
-import type { UnknownObject } from '../helpers/general.js';
-import type { XScalarClientConfigEnvironments, xScalarClientConfigEnvironment } from '../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js';
+import type { EnvironmentEvents } from '../events/definitions/environment.js';
+import type { Workspace, WorkspaceDocument } from '../schemas.js';
+import { type XScalarEnvVar, type XScalarEnvironment } from '../schemas/extensions/document/x-scalar-environments.js';
 /**
- * Environment mutators for managing client configuration environments in OpenAPI documents.
- * Provides functions to add and delete environments from the document's x-scalar-client-config-environments extension.
+ * Adds OR updates an environment to the document or workspace.
  *
- * @param store - The workspace store containing the documents
- * @param documentName - The name of the document to operate on
- * @returns Object containing addEnvironment and deleteEnvironment functions
+ * @param document - current document if available
+ * @param workspace - current workspace if available
+ * @param environmentName - Name of the environment to add
+ * @param payload - The environment configuration to add
+ * @param oldEnvironmentName - Only needed when renaming the environment
+ * @returns the parsed environment that was added or updated or undefined if the collection is not found
  */
-export declare const environmentMutators: (document?: UnknownObject & {
-    "x-scalar-client-config-environments"?: XScalarClientConfigEnvironments;
-}) => {
-    addEnvironment: (name: string, environment: xScalarClientConfigEnvironment) => boolean;
-    deleteEnvironment: (environmentName: string) => boolean;
-};
+export declare const upsertEnvironment: (document: WorkspaceDocument | null, workspace: Workspace, { environmentName, payload, collectionType, oldEnvironmentName }: EnvironmentEvents["environment:upsert:environment"]) => XScalarEnvironment | undefined;
+/**
+ * Adds OR updates an environment variable to the document or workspace.
+ *
+ * @param collection - Workspace OR document
+ * @param environmentName - Name of the environment to add the variable to
+ * @param variableName - Name of the variable to add
+ * @param value - Value of the variable to add
+ * @returns the parsed variable that was added or updated or undefined if the collection is not found
+ */
+export declare const upsertEnvironmentVariable: (collection: WorkspaceDocument | Workspace | null, { environmentName, variable, index }: EnvironmentEvents["environment:upsert:environment-variable"]) => XScalarEnvVar | undefined;
 //# sourceMappingURL=environment.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/mutators/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EACV,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,oFAAoF,CAAA;AAE3F;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,aAAa,GAAG;IAAE,qCAAqC,CAAC,EAAE,+BAA+B,CAAA;CAAE;2BAsBxE,MAAM,eAAe,8BAA8B;yCA6BrC,MAAM;CAanD,CAAA"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/mutators/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAGxB,MAAM,qDAAqD,CAAA;AAG5D;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,iBAAiB,GAAG,IAAI,EAClC,WAAW,SAAS,EACpB,kEAAkE,iBAAiB,CAAC,gCAAgC,CAAC,KACpH,kBAAkB,GAAG,SAqCvB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,iBAAiB,GAAG,SAAS,GAAG,IAAI,EAChD,sCAAsC,iBAAiB,CAAC,yCAAyC,CAAC,KACjG,aAAa,GAAG,SA0BlB,CAAA"}

package/dist/mutators/environment.js

@@ -1,31 +1,52 @@
-const environmentMutators = (document) => {
-  const addEnvironment = (name, environment) => {
-    if (!document) {
-      return false;
+import {
+  xScalarEnvVarSchema,
+  xScalarEnvironmentSchema
+} from "../schemas/extensions/document/x-scalar-environments.js";
+import { coerceValue } from "../schemas/typebox-coerce.js";
+const upsertEnvironment = (document, workspace, { environmentName, payload, collectionType, oldEnvironmentName }) => {
+  const collection = collectionType === "document" ? document : workspace;
+  if (!collection) {
+    return;
+  }
+  if (!collection["x-scalar-environments"]) {
+    collection["x-scalar-environments"] = {};
+  }
+  const isNewEnvironment = !collection["x-scalar-environments"][oldEnvironmentName ?? environmentName];
+  const parsed = coerceValue(xScalarEnvironmentSchema, {
+    ...collection["x-scalar-environments"][oldEnvironmentName ?? environmentName],
+    ...payload
+  });
+  collection["x-scalar-environments"][environmentName] = parsed;
+  if (oldEnvironmentName && oldEnvironmentName !== environmentName) {
+    delete collection["x-scalar-environments"][oldEnvironmentName];
+    if (workspace["x-scalar-active-environment"] === oldEnvironmentName) {
+      workspace["x-scalar-active-environment"] = environmentName;
     }
-    if (!document["x-scalar-client-config-environments"]) {
-      document["x-scalar-client-config-environments"] = {};
-    }
-    if (document["x-scalar-client-config-environments"][name]) {
-      console.warn(`Environment with name "${name}" already exists in the document.`);
-      return false;
-    }
-    document["x-scalar-client-config-environments"][name] = environment;
-    return true;
-  };
-  const deleteEnvironment = (environmentName) => {
-    if (!document || !document["x-scalar-client-config-environments"]) {
-      return false;
+  }
+  if (isNewEnvironment) {
+    workspace["x-scalar-active-environment"] = environmentName;
+  }
+  return parsed;
+};
+const upsertEnvironmentVariable = (collection, { environmentName, variable, index }) => {
+  if (!collection?.["x-scalar-environments"]?.[environmentName]) {
+    console.error("Environment not found", environmentName);
+    return;
+  }
+  const parsed = coerceValue(xScalarEnvVarSchema, variable);
+  if (index !== void 0) {
+    if (parsed.name === "") {
+      collection["x-scalar-environments"][environmentName].variables.splice(index, 1);
+      return;
     }
-    delete document["x-scalar-client-config-environments"][environmentName];
-    return true;
-  };
-  return {
-    addEnvironment,
-    deleteEnvironment
-  };
+    collection["x-scalar-environments"][environmentName].variables[index] = parsed;
+  } else {
+    collection["x-scalar-environments"][environmentName].variables.push(parsed);
+  }
+  return parsed;
 };
 export {
-  environmentMutators
+  upsertEnvironment,
+  upsertEnvironmentVariable
 };
 //# sourceMappingURL=environment.js.map

package/dist/mutators/environment.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/environment.ts"],
-  "sourcesContent": ["import type { UnknownObject } from '@/helpers/general'\nimport type {\n  XScalarClientConfigEnvironments,\n  xScalarClientConfigEnvironment,\n} from '@/schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments'\n\n/**\n * Environment mutators for managing client configuration environments in OpenAPI documents.\n * Provides functions to add and delete environments from the document's x-scalar-client-config-environments extension.\n *\n * @param store - The workspace store containing the documents\n * @param documentName - The name of the document to operate on\n * @returns Object containing addEnvironment and deleteEnvironment functions\n */\nexport const environmentMutators = (\n  document?: UnknownObject & { 'x-scalar-client-config-environments'?: XScalarClientConfigEnvironments },\n) => {\n  /**\n   * Adds a new environment to the document's client configuration.\n   * If an environment with the same name already exists, it will log a warning and return false.\n   *\n   * @param name - The name of the environment to add\n   * @param environment - The environment configuration to add\n   * @returns true if the environment was added successfully, false if it already exists or document is missing\n   *\n   * @example\n   * // Add a new development environment\n   * const success = addEnvironment('development', {\n   *   variables: { apiUrl: 'https://dev.example.com/api' }\n   * })\n   *\n   * if (success) {\n   *   console.log('Environment added successfully')\n   * } else {\n   *   console.log('Environment already exists')\n   * }\n   */\n  const addEnvironment = (name: string, environment: xScalarClientConfigEnvironment) => {\n    if (!document) {\n      return false\n    }\n\n    if (!document['x-scalar-client-config-environments']) {\n      document['x-scalar-client-config-environments'] = {}\n    }\n\n    if (document['x-scalar-client-config-environments'][name]) {\n      console.warn(`Environment with name \"${name}\" already exists in the document.`)\n      return false\n    }\n\n    document['x-scalar-client-config-environments'][name] = environment\n    return true\n  }\n\n  /**\n   * Removes an environment from the document's x-scalar-client-config-environments extension by its name.\n   * Returns false if the document or environments object does not exist, otherwise deletes the environment and returns true.\n   *\n   * @param environmentName - The name of the environment to remove\n   * @returns true if the environment was deleted, false otherwise\n   *\n   * @example\n   * // Remove a development environment\n   * deleteEnvironment('development')\n   */\n  const deleteEnvironment = (environmentName: string) => {\n    if (!document || !document['x-scalar-client-config-environments']) {\n      return false\n    }\n\n    delete document['x-scalar-client-config-environments'][environmentName]\n    return true\n  }\n\n  return {\n    addEnvironment,\n    deleteEnvironment,\n  }\n}\n"],
-  "mappings": "AAcO,MAAM,sBAAsB,CACjC,aACG;AAqBH,QAAM,iBAAiB,CAAC,MAAc,gBAAgD;AACpF,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,SAAS,qCAAqC,GAAG;AACpD,eAAS,qCAAqC,IAAI,CAAC;AAAA,IACrD;AAEA,QAAI,SAAS,qCAAqC,EAAE,IAAI,GAAG;AACzD,cAAQ,KAAK,0BAA0B,IAAI,mCAAmC;AAC9E,aAAO;AAAA,IACT;AAEA,aAAS,qCAAqC,EAAE,IAAI,IAAI;AACxD,WAAO;AAAA,EACT;AAaA,QAAM,oBAAoB,CAAC,oBAA4B;AACrD,QAAI,CAAC,YAAY,CAAC,SAAS,qCAAqC,GAAG;AACjE,aAAO;AAAA,IACT;AAEA,WAAO,SAAS,qCAAqC,EAAE,eAAe;AACtE,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { EnvironmentEvents } from '@/events/definitions/environment'\nimport type { Workspace, WorkspaceDocument } from '@/schemas'\nimport {\n  type XScalarEnvVar,\n  type XScalarEnvironment,\n  xScalarEnvVarSchema,\n  xScalarEnvironmentSchema,\n} from '@/schemas/extensions/document/x-scalar-environments'\nimport { coerceValue } from '@/schemas/typebox-coerce'\n\n/**\n * Adds OR updates an environment to the document or workspace.\n *\n * @param document - current document if available\n * @param workspace - current workspace if available\n * @param environmentName - Name of the environment to add\n * @param payload - The environment configuration to add\n * @param oldEnvironmentName - Only needed when renaming the environment\n * @returns the parsed environment that was added or updated or undefined if the collection is not found\n */\nexport const upsertEnvironment = (\n  document: WorkspaceDocument | null,\n  workspace: Workspace,\n  { environmentName, payload, collectionType, oldEnvironmentName }: EnvironmentEvents['environment:upsert:environment'],\n): XScalarEnvironment | undefined => {\n  /** Discriminating between document and workspace */\n  const collection = collectionType === 'document' ? document : workspace\n  if (!collection) {\n    return\n  }\n\n  if (!collection['x-scalar-environments']) {\n    collection['x-scalar-environments'] = {}\n  }\n\n  // Check if this is a new environment before we create it\n  const isNewEnvironment = !collection['x-scalar-environments'][oldEnvironmentName ?? environmentName]\n\n  // Ensure we parse the payload but keep the old variables\n  const parsed = coerceValue(xScalarEnvironmentSchema, {\n    ...collection['x-scalar-environments'][oldEnvironmentName ?? environmentName],\n    ...payload,\n  })\n  collection['x-scalar-environments'][environmentName] = parsed\n\n  // If we are renaming the environment, we need to delete the old one\n  if (oldEnvironmentName && oldEnvironmentName !== environmentName) {\n    delete collection['x-scalar-environments'][oldEnvironmentName]\n\n    // If the old environment was active, we need to set the new environment as active\n    if (workspace['x-scalar-active-environment'] === oldEnvironmentName) {\n      workspace['x-scalar-active-environment'] = environmentName\n    }\n  }\n\n  // Set the newly created workspace environment as active\n  if (isNewEnvironment) {\n    workspace['x-scalar-active-environment'] = environmentName\n  }\n\n  return parsed\n}\n\n/**\n * Adds OR updates an environment variable to the document or workspace.\n *\n * @param collection - Workspace OR document\n * @param environmentName - Name of the environment to add the variable to\n * @param variableName - Name of the variable to add\n * @param value - Value of the variable to add\n * @returns the parsed variable that was added or updated or undefined if the collection is not found\n */\nexport const upsertEnvironmentVariable = (\n  collection: WorkspaceDocument | Workspace | null,\n  { environmentName, variable, index }: EnvironmentEvents['environment:upsert:environment-variable'],\n): XScalarEnvVar | undefined => {\n  // The environment should exist by now if we are upserting a variable\n  if (!collection?.['x-scalar-environments']?.[environmentName]) {\n    console.error('Environment not found', environmentName)\n    return\n  }\n\n  // Ensure we parse the variable for type safety\n  const parsed = coerceValue(xScalarEnvVarSchema, variable)\n\n  if (index !== undefined) {\n    // Delete the row if the name is empty\n    if (parsed.name === '') {\n      collection['x-scalar-environments'][environmentName].variables.splice(index, 1)\n      return\n    }\n\n    // Update\n    collection['x-scalar-environments'][environmentName].variables[index] = parsed\n  }\n  // Add\n  else {\n    collection['x-scalar-environments'][environmentName].variables.push(parsed)\n  }\n\n  return parsed\n}\n"],
+  "mappings": "AAEA;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AACP,SAAS,mBAAmB;AAYrB,MAAM,oBAAoB,CAC/B,UACA,WACA,EAAE,iBAAiB,SAAS,gBAAgB,mBAAmB,MAC5B;AAEnC,QAAM,aAAa,mBAAmB,aAAa,WAAW;AAC9D,MAAI,CAAC,YAAY;AACf;AAAA,EACF;AAEA,MAAI,CAAC,WAAW,uBAAuB,GAAG;AACxC,eAAW,uBAAuB,IAAI,CAAC;AAAA,EACzC;AAGA,QAAM,mBAAmB,CAAC,WAAW,uBAAuB,EAAE,sBAAsB,eAAe;AAGnG,QAAM,SAAS,YAAY,0BAA0B;AAAA,IACnD,GAAG,WAAW,uBAAuB,EAAE,sBAAsB,eAAe;AAAA,IAC5E,GAAG;AAAA,EACL,CAAC;AACD,aAAW,uBAAuB,EAAE,eAAe,IAAI;AAGvD,MAAI,sBAAsB,uBAAuB,iBAAiB;AAChE,WAAO,WAAW,uBAAuB,EAAE,kBAAkB;AAG7D,QAAI,UAAU,6BAA6B,MAAM,oBAAoB;AACnE,gBAAU,6BAA6B,IAAI;AAAA,IAC7C;AAAA,EACF;AAGA,MAAI,kBAAkB;AACpB,cAAU,6BAA6B,IAAI;AAAA,EAC7C;AAEA,SAAO;AACT;AAWO,MAAM,4BAA4B,CACvC,YACA,EAAE,iBAAiB,UAAU,MAAM,MACL;AAE9B,MAAI,CAAC,aAAa,uBAAuB,IAAI,eAAe,GAAG;AAC7D,YAAQ,MAAM,yBAAyB,eAAe;AACtD;AAAA,EACF;AAGA,QAAM,SAAS,YAAY,qBAAqB,QAAQ;AAExD,MAAI,UAAU,QAAW;AAEvB,QAAI,OAAO,SAAS,IAAI;AACtB,iBAAW,uBAAuB,EAAE,eAAe,EAAE,UAAU,OAAO,OAAO,CAAC;AAC9E;AAAA,IACF;AAGA,eAAW,uBAAuB,EAAE,eAAe,EAAE,UAAU,KAAK,IAAI;AAAA,EAC1E,OAEK;AACH,eAAW,uBAAuB,EAAE,eAAe,EAAE,UAAU,KAAK,MAAM;AAAA,EAC5E;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/mutators/index.d.ts

@@ -1,7 +1,10 @@
+/** biome-ignore-all lint/performance/noBarrelFile: this will probably get deleted later */
 import type { WorkspaceStore } from '../client.js';
 /**
  * Generates a set of mutators for managing OpenAPI document and workspace state.
  *
+ * @deprecated use the individual mutators instead, this will be removed after we move fully to the new store
+ *
  * @param store - The workspace store containing all documents and workspace-level data
  * @returns An object with mutators for the workspace, the active document, and any named document
  */
@@ -10,10 +13,6 @@ export declare function generateClientMutators(store: WorkspaceStore): {
      * Returns mutators for the workspace-level configuration.
      */
     workspace: () => {
-        environmentMutators: {
-            addEnvironment: (name: string, environment: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js").xScalarClientConfigEnvironment) => boolean;
-            deleteEnvironment: (environmentName: string) => boolean;
-        };
         cookieMutators: {
             addCookie: (cookie: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-cookies.js").XScalarClientConfigCookie) => boolean;
             deleteCookie: (cookieName: string) => boolean;
@@ -43,10 +42,6 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/security-scheme.js").SecuritySchemeObject) => boolean;
             deleteSecurityScheme: (name: string) => boolean;
         };
-        environmentMutators: {
-            addEnvironment: (name: string, environment: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js").xScalarClientConfigEnvironment) => boolean;
-            deleteEnvironment: (environmentName: string) => boolean;
-        };
         cookieMutators: {
             addCookie: (cookie: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-cookies.js").XScalarClientConfigCookie) => boolean;
             deleteCookie: (cookieName: string) => boolean;
@@ -73,10 +68,6 @@ export declare function generateClientMutators(store: WorkspaceStore): {
             addSecurityScheme: (name: string, securityScheme: import("../schemas/v3.1/strict/security-scheme.js").SecuritySchemeObject) => boolean;
             deleteSecurityScheme: (name: string) => boolean;
         };
-        environmentMutators: {
-            addEnvironment: (name: string, environment: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-environments.js").xScalarClientConfigEnvironment) => boolean;
-            deleteEnvironment: (environmentName: string) => boolean;
-        };
         cookieMutators: {
             addCookie: (cookie: import("../schemas/v3.1/strict/client-config-extensions/x-scalar-client-config-cookies.js").XScalarClientConfigCookie) => boolean;
             deleteCookie: (cookieName: string) => boolean;
@@ -87,4 +78,5 @@ export declare function generateClientMutators(store: WorkspaceStore): {
         };
     };
 };
+export { upsertEnvironment, upsertEnvironmentVariable, } from './environment.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAQ9C;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc;IA8DxD;;OAEG;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;;;OAIG;gBACS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;EAErB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mutators/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAO9C;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc;IA4DxD;;OAEG;;;;;;;;;;;;;;;IAEH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;IAGH;;;;OAIG;gBACS,MAAM;;;;;;;;;;;;;;;;;;;;;EAErB;AAED,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/mutators/index.js

@@ -1,5 +1,4 @@
 import { cookieMutators } from "../mutators/cookie.js";
-import { environmentMutators } from "../mutators/environment.js";
 import { getDocument } from "../mutators/helpers.js";
 import { requestMutators } from "../mutators/request.js";
 import { securitySchemeMutators } from "../mutators/security-schemes.js";
@@ -21,7 +20,6 @@ function generateClientMutators(store) {
     return {
       requestMutators: requestMutators(document),
       securitySchemeMutators: securitySchemeMutators(document?.components?.securitySchemes),
-      environmentMutators: environmentMutators(document),
       cookieMutators: cookieMutators(document),
       serverMutators: serverMutators(document?.servers)
     };
@@ -35,7 +33,6 @@ function generateClientMutators(store) {
       store.workspace["x-scalar-client-config-security-schemes"] = {};
     }
     return {
-      environmentMutators: environmentMutators(store.workspace),
       cookieMutators: cookieMutators(store.workspace),
       serverMutators: serverMutators(store.workspace["x-scalar-client-config-servers"]),
       securitySchemeMutators: securitySchemeMutators(store.workspace["x-scalar-client-config-security-schemes"])
@@ -59,7 +56,13 @@ function generateClientMutators(store) {
     doc: (name) => documentMutators(name)
   };
 }
+import {
+  upsertEnvironment,
+  upsertEnvironmentVariable
+} from "./environment.js";
 export {
-  generateClientMutators
+  generateClientMutators,
+  upsertEnvironment,
+  upsertEnvironmentVariable
 };
 //# sourceMappingURL=index.js.map

package/dist/mutators/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/mutators/index.ts"],
-  "sourcesContent": ["import type { WorkspaceStore } from '@/client'\nimport { cookieMutators } from '@/mutators/cookie'\nimport { environmentMutators } from '@/mutators/environment'\nimport { getDocument } from '@/mutators/helpers'\nimport { requestMutators } from '@/mutators/request'\nimport { securitySchemeMutators } from '@/mutators/security-schemes'\nimport { serverMutators } from '@/mutators/server'\n\n/**\n * Generates a set of mutators for managing OpenAPI document and workspace state.\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   * 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      environmentMutators: environmentMutators(document),\n      cookieMutators: cookieMutators(document),\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      environmentMutators: environmentMutators(store.workspace),\n      cookieMutators: cookieMutators(store.workspace),\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"],
-  "mappings": "AACA,SAAS,sBAAsB;AAC/B,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AACvC,SAAS,sBAAsB;AAQxB,SAAS,uBAAuB,OAAuB;AAO5D,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,qBAAqB,oBAAoB,QAAQ;AAAA,MACjD,gBAAgB,eAAe,QAAQ;AAAA,MACvC,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,qBAAqB,oBAAoB,MAAM,SAAS;AAAA,MACxD,gBAAgB,eAAe,MAAM,SAAS;AAAA,MAC9C,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;",
+  "sourcesContent": ["/** biome-ignore-all lint/performance/noBarrelFile: this will probably get deleted later */\nimport type { WorkspaceStore } from '@/client'\nimport { cookieMutators } from '@/mutators/cookie'\nimport { getDocument } from '@/mutators/helpers'\nimport { requestMutators } from '@/mutators/request'\nimport { securitySchemeMutators } from '@/mutators/security-schemes'\nimport { serverMutators } from '@/mutators/server'\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   * 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      cookieMutators: cookieMutators(document),\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      cookieMutators: cookieMutators(store.workspace),\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  upsertEnvironment,\n  upsertEnvironmentVariable,\n} from './environment'\n"],
+  "mappings": "AAEA,SAAS,sBAAsB;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,8BAA8B;AACvC,SAAS,sBAAsB;AAUxB,SAAS,uBAAuB,OAAuB;AAO5D,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,QAAQ;AAAA,MACvC,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,SAAS;AAAA,MAC9C,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,EACE;AAAA,EACA;AAAA,OACK;",
   "names": []
 }

package/dist/navigation/get-navigation-options.d.ts

@@ -5,5 +5,5 @@ import type { DocumentConfiguration } from '../schemas/workspace-specification/c
  * how IDs and slugs are generated for tags, headings, models, operations, and webhooks.
  * The returned options can be influenced by the provided DocumentConfiguration
  */
-export declare const getNavigationOptions: (config?: DocumentConfiguration) => TraverseSpecOptions;
+export declare const getNavigationOptions: (documentName: string, config?: DocumentConfiguration) => TraverseSpecOptions;
 //# sourceMappingURL=get-navigation-options.d.ts.map

package/dist/navigation/get-navigation-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,mBAsHrE,CAAA"}
+{"version":3,"file":"get-navigation-options.d.ts","sourceRoot":"","sources":["../../src/navigation/get-navigation-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAA;AAErF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,EAAE,SAAS,qBAAqB,KAAG,mBAkH3F,CAAA"}