@scalar/api-reference 1.50.0 → 1.51.0

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

@@ -0,0 +1,17 @@
+/**
+ * Deep-clones plain data for use where mutation must not affect the source.
+ *
+ * In the browser we use `structuredClone`, which preserves `Date`, `Map`, `Set`,
+ * typed arrays, and other structured types. During SSR there is no `window`, so
+ * we fall back to `JSON.parse(JSON.stringify(...))`, which only supports JSON
+ * values (functions, `undefined` in objects, symbols, etc. are dropped or altered).
+ *
+ * @example
+ * ```ts
+ * const copy = safeDeepClone(spec)
+ * copy.info.title = 'Draft'
+ * // original spec is unchanged
+ * ```
+ */
+export declare const safeDeepClone: <T>(value: T) => T;
+//# sourceMappingURL=safe-deep-clone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safe-deep-clone.d.ts","sourceRoot":"","sources":["../../src/helpers/safe-deep-clone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,CAAC,KAAG,CAK3C,CAAA"}

package/dist/helpers/safe-deep-clone.js

@@ -0,0 +1,25 @@
+import { deepClone } from "@scalar/workspace-store/helpers/deep-clone";
+//#region src/helpers/safe-deep-clone.ts
+/**
+* Deep-clones plain data for use where mutation must not affect the source.
+*
+* In the browser we use `structuredClone`, which preserves `Date`, `Map`, `Set`,
+* typed arrays, and other structured types. During SSR there is no `window`, so
+* we fall back to `JSON.parse(JSON.stringify(...))`, which only supports JSON
+* values (functions, `undefined` in objects, symbols, etc. are dropped or altered).
+*
+* @example
+* ```ts
+* const copy = safeDeepClone(spec)
+* copy.info.title = 'Draft'
+* // original spec is unchanged
+* ```
+*/
+var safeDeepClone = (value) => {
+	if (typeof window === "undefined") return deepClone(value);
+	return window.structuredClone(value);
+};
+//#endregion
+export { safeDeepClone };
+
+//# sourceMappingURL=safe-deep-clone.js.map

package/dist/helpers/safe-deep-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-deep-clone.js","names":[],"sources":["../../src/helpers/safe-deep-clone.ts"],"sourcesContent":["import { deepClone } from '@scalar/workspace-store/helpers/deep-clone'\n\n/**\n * Deep-clones plain data for use where mutation must not affect the source.\n *\n * In the browser we use `structuredClone`, which preserves `Date`, `Map`, `Set`,\n * typed arrays, and other structured types. During SSR there is no `window`, so\n * we fall back to `JSON.parse(JSON.stringify(...))`, which only supports JSON\n * values (functions, `undefined` in objects, symbols, etc. are dropped or altered).\n *\n * @example\n * ```ts\n * const copy = safeDeepClone(spec)\n * copy.info.title = 'Draft'\n * // original spec is unchanged\n * ```\n */\nexport const safeDeepClone = <T>(value: T): T => {\n  if (typeof window === 'undefined') {\n    return deepClone(value)\n  }\n  return window.structuredClone(value) as T\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,iBAAoB,UAAgB;AAC/C,KAAI,OAAO,WAAW,YACpB,QAAO,UAAU,MAAM;AAEzB,QAAO,OAAO,gBAAgB,MAAM"}

package/dist/helpers/storage.d.ts

@@ -88,10 +88,10 @@ export declare const authStorage: () => {
                 }) | undefined;
             }) | {
                 implicit?: ({
+                    refreshUrl: string;
                     scopes: {
                         [x: string]: string;
                     };
-                    refreshUrl: string;
                 } & {
                     'x-scalar-security-query'?: {
                         [x: string]: string;
@@ -118,10 +118,10 @@ export declare const authStorage: () => {
                     'x-scalar-secret-redirect-uri': string;
                 }) | undefined;
                 password?: ({
+                    refreshUrl: string;
                     scopes: {
                         [x: string]: string;
                     };
-                    refreshUrl: string;
                 } & {
                     'x-scalar-security-query'?: {
                         [x: string]: string;
@@ -155,10 +155,10 @@ export declare const authStorage: () => {
                     'x-scalar-credentials-location'?: "body" | "header" | undefined;
                 }) | undefined;
                 clientCredentials?: ({
+                    refreshUrl: string;
                     scopes: {
                         [x: string]: string;
                     };
-                    refreshUrl: string;
                 } & {
                     'x-scalar-security-query'?: {
                         [x: string]: string;
@@ -189,10 +189,10 @@ export declare const authStorage: () => {
                     'x-scalar-credentials-location'?: "body" | "header" | undefined;
                 }) | undefined;
                 authorizationCode?: ({
+                    refreshUrl: string;
                     scopes: {
                         [x: string]: string;
                     };
-                    refreshUrl: string;
                 } & {
                     'x-scalar-security-query'?: {
                         [x: string]: string;
@@ -208,8 +208,8 @@ export declare const authStorage: () => {
                 } & {
                     'x-scalar-secret-token-url'?: string | undefined;
                 } & {
-                    tokenUrl: string;
                     authorizationUrl: string;
+                    tokenUrl: string;
                 } & {
                     'x-usePkce': "SHA-256" | "plain" | "no";
                 } & {

package/dist/style.css

@@ -13469,7 +13469,7 @@ div + .userMessage[data-v-8e43ed7a] {
 
 /* Configurable Layout Variables */
 @layer scalar-config {
-.scalar-api-reference[data-v-b3b51776] {
+.scalar-api-reference[data-v-0d40a3ce] {
     /* The header height */
     --refs-header-height: calc(
       var(--scalar-custom-header-height, 0px) + var(--scalar-header-height, 0px)
@@ -13491,20 +13491,20 @@ div + .userMessage[data-v-8e43ed7a] {
     /* The maximum width of the content column */
     --refs-content-max-width: var(--scalar-content-max-width, 1540px);
 }
-.scalar-api-reference.references-classic[data-v-b3b51776] {
+.scalar-api-reference.references-classic[data-v-0d40a3ce] {
     /* Classic layout is wider */
     --refs-content-max-width: var(--scalar-content-max-width, 1420px);
     min-height: 100dvh;
     --refs-sidebar-width: 0;
 }
 }
-.t-doc__sidebar[data-v-b3b51776] {
+.t-doc__sidebar[data-v-0d40a3ce] {
   z-index: 10;
 }
 
 /* ----------------------------------------------------- */
 /* References Layout */
-.references-layout[data-v-b3b51776] {
+.references-layout[data-v-0d40a3ce] {
   /* Try to fill the container */
   min-height: 100dvh;
   min-width: 100%;
@@ -13528,44 +13528,44 @@ div + .userMessage[data-v-8e43ed7a] {
 
   background: var(--scalar-background-1);
 }
-.references-editor[data-v-b3b51776] {
+.references-editor[data-v-0d40a3ce] {
   grid-area: editor;
   display: flex;
   min-width: 0;
   background: var(--scalar-background-1);
 }
-.references-rendered[data-v-b3b51776] {
+.references-rendered[data-v-0d40a3ce] {
   position: relative;
   grid-area: rendered;
   min-width: 0;
   background: var(--scalar-background-1);
 }
-.scalar-api-reference.references-classic[data-v-b3b51776],
-.references-classic .references-rendered[data-v-b3b51776] {
+.scalar-api-reference.references-classic[data-v-0d40a3ce],
+.references-classic .references-rendered[data-v-0d40a3ce] {
   height: initial !important;
   max-height: initial !important;
 }
 @layer scalar-config {
-.references-sidebar[data-v-b3b51776] {
+.references-sidebar[data-v-0d40a3ce] {
     /* Set a default width if references are enabled */
     --refs-sidebar-width: var(--scalar-sidebar-width, 288px);
 }
 }
 
 /* Footer */
-.references-footer[data-v-b3b51776] {
+.references-footer[data-v-0d40a3ce] {
   grid-area: footer;
 }
 /* ----------------------------------------------------- */
 /* Responsive / Mobile Layout */
 @media (max-width: 1000px) {
   /* Keep toolbar hidden on mobile without forcing desktop display mode. */
-.references-developer-tools[data-v-b3b51776] {
+.references-developer-tools[data-v-0d40a3ce] {
     display: none;
 }
 
   /* Stack view on mobile */
-.references-layout[data-v-b3b51776] {
+.references-layout[data-v-0d40a3ce] {
     /* Adjust the sidebar height to the viewport height minus the header height */
     --refs-sidebar-height: calc(
       var(--full-height, 100dvh) - var(--scalar-custom-header-height, 0px)
@@ -13580,13 +13580,13 @@ div + .userMessage[data-v-8e43ed7a] {
       'rendered'
       'footer';
 }
-.references-editable[data-v-b3b51776] {
+.references-editable[data-v-0d40a3ce] {
     grid-template-areas:
       'header'
       'navigation'
       'editor';
 }
-.references-rendered[data-v-b3b51776] {
+.references-rendered[data-v-0d40a3ce] {
     position: static;
 }
 }
@@ -13597,12 +13597,12 @@ div + .userMessage[data-v-8e43ed7a] {
 * when the new elements are available
 */
 @media (max-width: 1000px) {
-.scalar-api-references-standalone-mobile[data-v-b3b51776]:not(.references-classic) {
+.scalar-api-references-standalone-mobile[data-v-0d40a3ce]:not(.references-classic) {
     --scalar-header-height: 50px;
 }
 }
 
-.darklight-reference[data-v-b3b51776] {
+.darklight-reference[data-v-0d40a3ce] {
   width: 100%;
   margin-top: auto;
 }

package/package.json

@@ -20,7 +20,7 @@
     "vue",
     "vue3"
   ],
-  "version": "1.50.0",
+  "version": "1.51.0",
   "engines": {
     "node": ">=22"
   },
@@ -91,20 +91,20 @@
     "nanoid": "^5.1.6",
     "vue": "^3.5.30",
     "yaml": "^2.8.0",
-    "@scalar/agent-chat": "0.10.0",
-    "@scalar/api-client": "2.40.0",
+    "@scalar/agent-chat": "0.10.1",
+    "@scalar/api-client": "2.41.0",
     "@scalar/code-highlight": "0.3.2",
-    "@scalar/components": "0.21.3",
-    "@scalar/icons": "0.7.2",
-    "@scalar/oas-utils": "0.10.15",
     "@scalar/helpers": "0.4.3",
-    "@scalar/sidebar": "0.8.17",
+    "@scalar/oas-utils": "0.10.16",
+    "@scalar/icons": "0.7.2",
+    "@scalar/sidebar": "0.8.18",
+    "@scalar/components": "0.21.3",
     "@scalar/snippetz": "0.7.8",
     "@scalar/themes": "0.15.2",
     "@scalar/use-hooks": "0.4.2",
+    "@scalar/workspace-store": "0.43.1",
     "@scalar/use-toasts": "0.10.1",
-    "@scalar/types": "0.7.6",
-    "@scalar/workspace-store": "0.43.0"
+    "@scalar/types": "0.7.6"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.10",
@@ -121,8 +121,8 @@
     "vite-plugin-banner": "^0.8.1",
     "vite-plugin-css-injected-by-js": "^3.5.2",
     "vitest": "4.1.0",
-    "@scalar/core": "0.4.6",
-    "@scalar/galaxy": "0.6.2"
+    "@scalar/galaxy": "0.6.2",
+    "@scalar/core": "0.4.6"
   },
   "scripts": {
     "build": "pnpm build:default && pnpm build:standalone && vue-tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",

package/dist/components/Content/Auth/helpers/get-default-security.d.ts

@@ -1,18 +0,0 @@
-import type { AuthenticationConfiguration } from '@scalar/types/api-reference';
-import type { MergedSecuritySchemes } from '@scalar/workspace-store/request-example';
-import type { SecurityRequirementObject, SecuritySchemeObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
-/**
- * Extracts the default scopes for a security scheme.
- * Only OAuth2 schemes can have default scopes via the x-default-scopes extension.
- */
-export declare const getDefaultScopes: (scheme: SecuritySchemeObject | undefined) => string[];
-/**
- * Determines the default security scheme to use for an operation.
- *
- * Priority order:
- * 1. User-configured preferred security scheme (if provided)
- * 2. First security requirement from the OpenAPI spec
- * 3. null (no security required)
- */
-export declare const getDefaultSecurity: (securityRequirements: SecurityRequirementObject[], preferredSecurityScheme: AuthenticationConfiguration["preferredSecurityScheme"], securitySchemes: MergedSecuritySchemes) => SecurityRequirementObject | null;
-//# sourceMappingURL=get-default-security.d.ts.map

package/dist/components/Content/Auth/helpers/get-default-security.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-default-security.d.ts","sourceRoot":"","sources":["../../../../../src/components/Content/Auth/helpers/get-default-security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAG9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,8DAA8D,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,oBAAoB,GAAG,SAAS,KAAG,MAAM,EAMjF,CAAA;AAkED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC7B,sBAAsB,yBAAyB,EAAE,EACjD,yBAAyB,2BAA2B,CAAC,yBAAyB,CAAC,EAC/E,iBAAiB,qBAAqB,KACrC,yBAAyB,GAAG,IAW9B,CAAA"}

package/dist/components/Content/Auth/helpers/get-default-security.js

@@ -1,64 +0,0 @@
-import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
-import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
-//#region src/components/Content/Auth/helpers/get-default-security.ts
-/**
-* Extracts the default scopes for a security scheme.
-* Only OAuth2 schemes can have default scopes via the x-default-scopes extension.
-*/
-var getDefaultScopes = (scheme) => {
-	if (!scheme || scheme.type !== "oauth2") return [];
-	return scheme["x-default-scopes"] ?? [];
-};
-/**
-* Hydrates an existing security requirement with configured default scopes.
-* Explicit scopes from the OpenAPI requirement take precedence over x-default-scopes.
-*/
-var hydrateSecurityRequirement = (requirement, securitySchemes) => {
-	const hydratedRequirement = {};
-	for (const [schemeName, scopes] of Object.entries(unpackProxyObject(requirement, { depth: 1 }) ?? requirement)) {
-		if (Array.isArray(scopes) && scopes.length > 0) {
-			hydratedRequirement[schemeName] = scopes;
-			continue;
-		}
-		hydratedRequirement[schemeName] = getDefaultScopes(getResolvedRef(securitySchemes[schemeName]));
-	}
-	return hydratedRequirement;
-};
-/**
-* Processes a single scheme name and adds it to the accumulator with its default scopes.
-*/
-var addSchemeToRequirement = (acc, schemeName, securitySchemes) => {
-	acc[schemeName] = getDefaultScopes(getResolvedRef(securitySchemes[schemeName]));
-};
-/**
-* Converts the preferred security scheme configuration into a SecurityRequirementObject.
-* Handles both flat arrays and nested arrays (for complex auth scenarios).
-*/
-var buildSecurityRequirementFromPreferred = (preferredSecurityScheme, securitySchemes) => {
-	if (!Array.isArray(preferredSecurityScheme)) {
-		const scheme = getResolvedRef(securitySchemes[preferredSecurityScheme]);
-		return { [preferredSecurityScheme]: getDefaultScopes(scheme) };
-	}
-	const requirement = {};
-	for (const item of preferredSecurityScheme) if (Array.isArray(item)) for (const schemeName of item) addSchemeToRequirement(requirement, schemeName, securitySchemes);
-	else addSchemeToRequirement(requirement, item, securitySchemes);
-	return requirement;
-};
-/**
-* Determines the default security scheme to use for an operation.
-*
-* Priority order:
-* 1. User-configured preferred security scheme (if provided)
-* 2. First security requirement from the OpenAPI spec
-* 3. null (no security required)
-*/
-var getDefaultSecurity = (securityRequirements, preferredSecurityScheme, securitySchemes) => {
-	if (preferredSecurityScheme) return buildSecurityRequirementFromPreferred(preferredSecurityScheme, securitySchemes);
-	const firstRequirement = securityRequirements[0];
-	if (firstRequirement) return hydrateSecurityRequirement(firstRequirement, securitySchemes);
-	return null;
-};
-//#endregion
-export { getDefaultSecurity };
-
-//# sourceMappingURL=get-default-security.js.map

package/dist/components/Content/Auth/helpers/get-default-security.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-default-security.js","names":[],"sources":["../../../../../src/components/Content/Auth/helpers/get-default-security.ts"],"sourcesContent":["import type { AuthenticationConfiguration } from '@scalar/types/api-reference'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport type { MergedSecuritySchemes } from '@scalar/workspace-store/request-example'\nimport type {\n  SecurityRequirementObject,\n  SecuritySchemeObject,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/**\n * Extracts the default scopes for a security scheme.\n * Only OAuth2 schemes can have default scopes via the x-default-scopes extension.\n */\nexport const getDefaultScopes = (scheme: SecuritySchemeObject | undefined): string[] => {\n  if (!scheme || scheme.type !== 'oauth2') {\n    return []\n  }\n\n  return scheme['x-default-scopes'] ?? []\n}\n\n/**\n * Hydrates an existing security requirement with configured default scopes.\n * Explicit scopes from the OpenAPI requirement take precedence over x-default-scopes.\n */\nconst hydrateSecurityRequirement = (\n  requirement: SecurityRequirementObject,\n  securitySchemes: MergedSecuritySchemes,\n): SecurityRequirementObject => {\n  const hydratedRequirement: SecurityRequirementObject = {}\n\n  for (const [schemeName, scopes] of Object.entries(unpackProxyObject(requirement, { depth: 1 }) ?? requirement)) {\n    if (Array.isArray(scopes) && scopes.length > 0) {\n      hydratedRequirement[schemeName] = scopes\n      continue\n    }\n\n    const scheme = getResolvedRef(securitySchemes[schemeName])\n    hydratedRequirement[schemeName] = getDefaultScopes(scheme)\n  }\n\n  return hydratedRequirement\n}\n\n/**\n * Processes a single scheme name and adds it to the accumulator with its default scopes.\n */\nconst addSchemeToRequirement = (\n  acc: SecurityRequirementObject,\n  schemeName: string,\n  securitySchemes: MergedSecuritySchemes,\n): void => {\n  const scheme = getResolvedRef(securitySchemes[schemeName])\n  acc[schemeName] = getDefaultScopes(scheme)\n}\n\n/**\n * Converts the preferred security scheme configuration into a SecurityRequirementObject.\n * Handles both flat arrays and nested arrays (for complex auth scenarios).\n */\nconst buildSecurityRequirementFromPreferred = (\n  preferredSecurityScheme: string | (string | string[])[],\n  securitySchemes: MergedSecuritySchemes,\n): SecurityRequirementObject => {\n  if (!Array.isArray(preferredSecurityScheme)) {\n    const scheme = getResolvedRef(securitySchemes[preferredSecurityScheme])\n    return { [preferredSecurityScheme]: getDefaultScopes(scheme) }\n  }\n\n  const requirement: SecurityRequirementObject = {}\n\n  for (const item of preferredSecurityScheme) {\n    if (Array.isArray(item)) {\n      // Handle nested arrays for complex auth (e.g., [['oauth2', 'apiKey'], 'basic'])\n      for (const schemeName of item) {\n        addSchemeToRequirement(requirement, schemeName, securitySchemes)\n      }\n    } else {\n      addSchemeToRequirement(requirement, item, securitySchemes)\n    }\n  }\n\n  return requirement\n}\n\n/**\n * Determines the default security scheme to use for an operation.\n *\n * Priority order:\n * 1. User-configured preferred security scheme (if provided)\n * 2. First security requirement from the OpenAPI spec\n * 3. null (no security required)\n */\nexport const getDefaultSecurity = (\n  securityRequirements: SecurityRequirementObject[],\n  preferredSecurityScheme: AuthenticationConfiguration['preferredSecurityScheme'],\n  securitySchemes: MergedSecuritySchemes,\n): SecurityRequirementObject | null => {\n  if (preferredSecurityScheme) {\n    return buildSecurityRequirementFromPreferred(preferredSecurityScheme, securitySchemes)\n  }\n\n  const firstRequirement = securityRequirements[0]\n  if (firstRequirement) {\n    return hydrateSecurityRequirement(firstRequirement, securitySchemes)\n  }\n\n  return null\n}\n"],"mappings":";;;;;;;AAaA,IAAa,oBAAoB,WAAuD;AACtF,KAAI,CAAC,UAAU,OAAO,SAAS,SAC7B,QAAO,EAAE;AAGX,QAAO,OAAO,uBAAuB,EAAE;;;;;;AAOzC,IAAM,8BACJ,aACA,oBAC8B;CAC9B,MAAM,sBAAiD,EAAE;AAEzD,MAAK,MAAM,CAAC,YAAY,WAAW,OAAO,QAAQ,kBAAkB,aAAa,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,EAAE;AAC9G,MAAI,MAAM,QAAQ,OAAO,IAAI,OAAO,SAAS,GAAG;AAC9C,uBAAoB,cAAc;AAClC;;AAIF,sBAAoB,cAAc,iBADnB,eAAe,gBAAgB,YAAY,CACA;;AAG5D,QAAO;;;;;AAMT,IAAM,0BACJ,KACA,YACA,oBACS;AAET,KAAI,cAAc,iBADH,eAAe,gBAAgB,YAAY,CAChB;;;;;;AAO5C,IAAM,yCACJ,yBACA,oBAC8B;AAC9B,KAAI,CAAC,MAAM,QAAQ,wBAAwB,EAAE;EAC3C,MAAM,SAAS,eAAe,gBAAgB,yBAAyB;AACvE,SAAO,GAAG,0BAA0B,iBAAiB,OAAO,EAAE;;CAGhE,MAAM,cAAyC,EAAE;AAEjD,MAAK,MAAM,QAAQ,wBACjB,KAAI,MAAM,QAAQ,KAAK,CAErB,MAAK,MAAM,cAAc,KACvB,wBAAuB,aAAa,YAAY,gBAAgB;KAGlE,wBAAuB,aAAa,MAAM,gBAAgB;AAI9D,QAAO;;;;;;;;;;AAWT,IAAa,sBACX,sBACA,yBACA,oBACqC;AACrC,KAAI,wBACF,QAAO,sCAAsC,yBAAyB,gBAAgB;CAGxF,MAAM,mBAAmB,qBAAqB;AAC9C,KAAI,iBACF,QAAO,2BAA2B,kBAAkB,gBAAgB;AAGtE,QAAO"}