@scalar/api-reference 1.51.0 → 1.52.0

package/dist/helpers/openapi.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.js","names":[],"sources":["../../src/helpers/openapi.ts"],"sourcesContent":["import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { MediaTypeObject } from '@scalar/workspace-store/schemas/v3.1/strict/media-type'\nimport type {\n  OpenApiDocument,\n  OperationObject,\n  ParameterObject,\n  SchemaObject,\n  SchemaReferenceType,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\n/** Object schema shape with properties, used when logging request body. */\ntype ObjectSchemaWithProperties = {\n  properties: Record<string, SchemaReferenceType<SchemaObject>>\n  required?: string[]\n}\n\nconst isSchemaObject = (value: unknown): value is SchemaObject => typeof value === 'object' && value !== null\n\nconst schemaTypeToString = (schema: SchemaObject): string => {\n  if (!('type' in schema)) {\n    return ''\n  }\n\n  if (typeof schema.type === 'string') {\n    return schema.type\n  }\n\n  return Array.isArray(schema.type) ? schema.type.join('|') : ''\n}\n\n/**\n * Resolves a schema reference from workspace-store to a SchemaObject.\n * Returns undefined when a reference exists but has not been resolved yet.\n */\nfunction resolveSchemaRef(ref: SchemaReferenceType<SchemaObject>): SchemaObject | undefined {\n  if (typeof ref === 'object' && ref !== null && '$ref' in ref) {\n    return isSchemaObject(ref['$ref-value']) ? ref['$ref-value'] : undefined\n  }\n\n  return ref\n}\n\n/**\n * Formats a property object into a string.\n */\nfunction formatProperty(key: string, obj: ObjectSchemaWithProperties): string {\n  let output = key\n  const isRequired = obj.required?.includes(key)\n  output += isRequired ? ' REQUIRED ' : ' optional '\n  const propRef = obj.properties[key]\n  if (!propRef) return output\n  const property = resolveSchemaRef(propRef)\n\n  if (property) {\n    output += schemaTypeToString(property)\n\n    if ('description' in property && typeof property.description === 'string') {\n      output += ` ${property.description}`\n    }\n  }\n\n  return output\n}\n\n/**\n * Recursively logs the properties of an object.\n */\nfunction recursiveLogger(obj: MediaTypeObject): string[] {\n  const results: string[] = ['Body']\n  const schema = getResolvedRef(obj?.schema)\n\n  if (!schema || !isObjectSchema(schema) || !schema.properties) {\n    return results\n  }\n\n  const properties = schema.properties\n  const schemaWithProps: ObjectSchemaWithProperties = {\n    properties,\n    required: schema.required,\n  }\n  Object.keys(properties).forEach((key) => {\n    if (!obj.schema) {\n      return\n    }\n\n    results.push(formatProperty(key, schemaWithProps))\n\n    const propRef = properties[key]\n    if (!propRef) return\n    const property = resolveSchemaRef(propRef)\n    if (property && isObjectSchema(property) && property.properties) {\n      const nestedProperties = property.properties\n      Object.keys(nestedProperties).forEach((subKey) => {\n        const ref = nestedProperties[subKey]\n        if (!ref) return\n        const nested = resolveSchemaRef(ref)\n        const typeStr = nested ? schemaTypeToString(nested) : ''\n        results.push(`${subKey} ${typeStr}`)\n      })\n    }\n  })\n\n  return results\n}\n\n/**\n * Extracts the request body from an operation.\n */\nexport function extractRequestBody(operation: OperationObject): string[] | boolean {\n  try {\n    // TODO: Wait… there's more than just 'application/json' (https://github.com/scalar/scalar/issues/6427)\n    const media = getResolvedRef(operation?.requestBody)?.content?.['application/json']\n    if (!media) {\n      throw new Error('Body not found')\n    }\n\n    return recursiveLogger(media)\n  } catch (_error) {\n    return false\n  }\n}\n\n/**\n * Deep merge for objects\n */\nexport function deepMerge(source: Record<any, any>, target: Record<any, any>) {\n  for (const [key, val] of Object.entries(source)) {\n    if (val !== null && typeof val === 'object') {\n      target[key] ??= new val.__proto__.constructor()\n      deepMerge(val, target[key])\n    } else if (typeof val !== 'undefined') {\n      target[key] = val\n    }\n  }\n\n  return target\n}\n\n/**\n * Creates an empty specification object.\n * The returning object has the same structure as a valid OpenAPI specification, but everything is empty.\n */\nexport function createEmptySpecification(partialSpecification?: Partial<OpenApiDocument>) {\n  const emptySpecification = {\n    openapi: '3.1.0',\n    info: {\n      title: '',\n      description: '',\n      termsOfService: '',\n      version: '',\n      license: {\n        name: '',\n        url: '',\n      },\n      contact: {\n        email: '',\n      },\n    },\n    servers: [],\n    tags: [],\n    'x-scalar-original-document-hash': '',\n  }\n\n  if (!partialSpecification) {\n    return emptySpecification as OpenApiDocument\n  }\n\n  deepMerge(partialSpecification, emptySpecification)\n\n  return emptySpecification as OpenApiDocument\n}\n\nexport type ParameterMap = {\n  path: ParameterObject[]\n  query: ParameterObject[]\n  header: ParameterObject[]\n  cookie: ParameterObject[]\n}\n\n/**\n * This function creates a parameter map from an Operation Object, that's easier to consume.\n *\n * TODO: Isn't it easier to just stick to the OpenAPI structure, without transforming it?\n */\nexport function createParameterMap(operation: OperationObject) {\n  const map: ParameterMap = {\n    path: [],\n    query: [],\n    header: [],\n    cookie: [],\n  }\n\n  const parameters = operation.parameters ?? []\n\n  parameters.forEach((parameterRef) => {\n    const parameter = getResolvedRef(parameterRef)\n    if (!parameter) {\n      return\n    }\n\n    if (parameter.in === 'path') {\n      map.path.push(parameter)\n    } else if (parameter.in === 'query') {\n      map.query.push(parameter)\n    } else if (parameter.in === 'header') {\n      map.header.push(parameter)\n    } else if (parameter.in === 'cookie') {\n      map.cookie.push(parameter)\n    }\n  })\n\n  return map\n}\n"],"mappings":"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"}
+{"version":3,"file":"openapi.js","names":[],"sources":["../../src/helpers/openapi.ts"],"sourcesContent":["import { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport type { MediaTypeObject } from '@scalar/workspace-store/schemas/v3.1/strict/media-type'\nimport type {\n  OpenApiDocument,\n  OperationObject,\n  ParameterObject,\n  ReferenceType,\n  SchemaObject,\n  SchemaReferenceType,\n} from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\nimport { isObjectSchema } from '@scalar/workspace-store/schemas/v3.1/strict/type-guards'\n\n/** Object schema shape with properties, used when logging request body. */\ntype ObjectSchemaWithProperties = {\n  properties: Record<string, SchemaReferenceType<SchemaObject>>\n  required?: string[]\n}\n\nconst isSchemaObject = (value: unknown): value is SchemaObject => typeof value === 'object' && value !== null\n\nconst schemaTypeToString = (schema: SchemaObject): string => {\n  if (!('type' in schema)) {\n    return ''\n  }\n\n  if (typeof schema.type === 'string') {\n    return schema.type\n  }\n\n  return Array.isArray(schema.type) ? schema.type.join('|') : ''\n}\n\n/**\n * Resolves a schema reference from workspace-store to a SchemaObject.\n * Returns undefined when a reference exists but has not been resolved yet.\n */\nfunction resolveSchemaRef(ref: SchemaReferenceType<SchemaObject>): SchemaObject | undefined {\n  if (typeof ref === 'object' && ref !== null && '$ref' in ref) {\n    return isSchemaObject(ref['$ref-value']) ? ref['$ref-value'] : undefined\n  }\n\n  return ref\n}\n\n/**\n * Formats a property object into a string.\n */\nfunction formatProperty(key: string, obj: ObjectSchemaWithProperties): string {\n  let output = key\n  const isRequired = obj.required?.includes(key)\n  output += isRequired ? ' REQUIRED ' : ' optional '\n  const propRef = obj.properties[key]\n  if (!propRef) {\n    return output\n  }\n  const property = resolveSchemaRef(propRef)\n\n  if (property) {\n    output += schemaTypeToString(property)\n\n    if ('description' in property && typeof property.description === 'string') {\n      output += ` ${property.description}`\n    }\n  }\n\n  return output\n}\n\n/**\n * Recursively logs the properties of an object.\n */\nfunction recursiveLogger(obj: MediaTypeObject): string[] {\n  const results: string[] = ['Body']\n  const schema = getResolvedRef(obj?.schema)\n\n  if (!schema || !isObjectSchema(schema) || !schema.properties) {\n    return results\n  }\n\n  const properties = schema.properties\n  const schemaWithProps: ObjectSchemaWithProperties = {\n    properties,\n    required: schema.required,\n  }\n  Object.keys(properties).forEach((key) => {\n    if (!obj.schema) {\n      return\n    }\n\n    results.push(formatProperty(key, schemaWithProps))\n\n    const propRef = properties[key]\n    if (!propRef) {\n      return\n    }\n    const property = resolveSchemaRef(propRef)\n    if (property && isObjectSchema(property) && property.properties) {\n      const nestedProperties = property.properties\n      Object.keys(nestedProperties).forEach((subKey) => {\n        const ref = nestedProperties[subKey]\n        if (!ref) {\n          return\n        }\n        const nested = resolveSchemaRef(ref)\n        const typeStr = nested ? schemaTypeToString(nested) : ''\n        results.push(`${subKey} ${typeStr}`)\n      })\n    }\n  })\n\n  return results\n}\n\n/**\n * Extracts the request body from an operation.\n */\nexport function extractRequestBody(operation: OperationObject): string[] | null {\n  const content = getResolvedRef(operation?.requestBody)?.content\n  const contentValue = Object.values(content ?? {})\n  if (contentValue.length === 0) {\n    // No content found\n    return null\n  }\n\n  return contentValue.flatMap((media) => recursiveLogger(media))\n}\n\n/**\n * Formats a parameter into a searchable string.\n */\nfunction formatParameter(param: ParameterObject): string {\n  const output = [param.name]\n  output.push(param.required ? 'REQUIRED' : 'optional')\n  output.push(param.in)\n\n  if ('schema' in param && param.schema) {\n    const schema = getResolvedRef(param.schema)\n    if (schema) {\n      output.push(schemaTypeToString(schema))\n    }\n  }\n\n  if (param.description) {\n    output.push(param.description)\n  }\n\n  return output.join(' ')\n}\n\n/**\n * Extracts parameters from an operation into searchable strings.\n */\nexport function extractParameters(parameters: ReferenceType<ParameterObject>[]): string[] | null {\n  return parameters.map((parameter) => formatParameter(getResolvedRef(parameter)))\n}\n\n/**\n * Deep merge for objects\n */\nexport function deepMerge(source: Record<any, any>, target: Record<any, any>) {\n  for (const [key, val] of Object.entries(source)) {\n    if (val !== null && typeof val === 'object') {\n      target[key] ??= new val.__proto__.constructor()\n      deepMerge(val, target[key])\n    } else if (typeof val !== 'undefined') {\n      target[key] = val\n    }\n  }\n\n  return target\n}\n\n/**\n * Creates an empty specification object.\n * The returning object has the same structure as a valid OpenAPI specification, but everything is empty.\n */\nexport function createEmptySpecification(partialSpecification?: Partial<OpenApiDocument>) {\n  const emptySpecification = {\n    openapi: '3.1.0',\n    info: {\n      title: '',\n      description: '',\n      termsOfService: '',\n      version: '',\n      license: {\n        name: '',\n        url: '',\n      },\n      contact: {\n        email: '',\n      },\n    },\n    servers: [],\n    tags: [],\n    'x-scalar-original-document-hash': '',\n  }\n\n  if (!partialSpecification) {\n    return emptySpecification as OpenApiDocument\n  }\n\n  deepMerge(partialSpecification, emptySpecification)\n\n  return emptySpecification as OpenApiDocument\n}\n"],"mappings":"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"}

package/dist/standalone/lib/html-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-api.d.ts","sourceRoot":"","sources":["../../../src/standalone/lib/html-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mCAAmC,EACnC,kBAAkB,EACnB,MAAM,6BAA6B,CAAA;AASpC;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,QAAQ,GAAG,mCAAmC,CA+GrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,mCAAmC,QAiBnG;AAID,eAAO,MAAM,eAAe,GAAI,KAAK,QAAQ,EAAE,UAAU,OAAO,GAAG,IAAI,mBAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAwHhC,CAAA"}
+{"version":3,"file":"html-api.d.ts","sourceRoot":"","sources":["../../../src/standalone/lib/html-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mCAAmC,EACnC,kBAAkB,EACnB,MAAM,6BAA6B,CAAA;AASpC;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,QAAQ,GAAG,mCAAmC,CA+GrG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,mCAAmC,QAiBnG;AAID,eAAO,MAAM,eAAe,GAAI,KAAK,QAAQ,EAAE,UAAU,OAAO,GAAG,IAAI,mBAatE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBA4HhC,CAAA"}

package/dist/standalone/lib/html-api.js

@@ -1,5 +1,5 @@
 import ApiReference_default from "../../components/ApiReference.vue.js";
-import { createApp, h, reactive } from "vue";
+import { createApp, createSSRApp, h, reactive } from "vue";
 import "@scalar/types/api-reference";
 import { createHead } from "@unhead/vue/client";
 //#region src/standalone/lib/html-api.ts
@@ -13,14 +13,16 @@ import { createHead } from "@unhead/vue/client";
 var createApiReference = (elementOrSelectorOrConfig, optionalConfiguration) => {
 	const idPrefix = "scalar-refs";
 	const props = reactive({ configuration: optionalConfiguration ?? elementOrSelectorOrConfig ?? {} });
-	let app = createApp(() => h(ApiReference_default, props));
-	app.use(createHead());
-	app.config.idPrefix = idPrefix;
-	if (optionalConfiguration) {
-		const element = typeof elementOrSelectorOrConfig === "string" ? document.querySelector(elementOrSelectorOrConfig) : elementOrSelectorOrConfig;
-		if (element) app.mount(element);
-		else console.error("Could not find a mount point for API References:", elementOrSelectorOrConfig);
-	}
+	const createReferenceApp = (isSsr = false) => {
+		const referenceApp = isSsr ? createSSRApp(() => h(ApiReference_default, props)) : createApp(() => h(ApiReference_default, props));
+		referenceApp.use(createHead());
+		referenceApp.config.idPrefix = idPrefix;
+		return referenceApp;
+	};
+	const mountElement = optionalConfiguration ? typeof elementOrSelectorOrConfig === "string" ? document.querySelector(elementOrSelectorOrConfig) : elementOrSelectorOrConfig : null;
+	let app = createReferenceApp(!!optionalConfiguration && !!mountElement && mountElement.children.length > 0);
+	if (optionalConfiguration) if (mountElement) app.mount(mountElement);
+	else console.error("Could not find a mount point for API References:", elementOrSelectorOrConfig);
 	/**
 	* Reload the API Reference
 	* @deprecated
@@ -32,9 +34,7 @@ var createApiReference = (elementOrSelectorOrConfig, optionalConfiguration) => {
 		if (!currentElement) return;
 		if (currentElement && !document.body.contains(currentElement)) document.body.appendChild(currentElement);
 		app.unmount();
-		app = createApp(() => h(ApiReference_default, props));
-		app.use(createHead());
-		app.config.idPrefix = idPrefix;
+		app = createReferenceApp();
 		app.mount(currentElement);
 	}, false);
 	/** Destroy the current API Reference instance */

package/dist/standalone/lib/html-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-api.js","names":[],"sources":["../../../src/standalone/lib/html-api.ts"],"sourcesContent":["import type {\n  AnyApiReferenceConfiguration,\n  ApiReferenceConfigurationWithSource,\n  CreateApiReference,\n} from '@scalar/types/api-reference'\nimport { apiReferenceConfigurationWithSourceSchema } from '@scalar/types/api-reference'\nimport { createHead } from '@unhead/vue/client'\nimport { createApp, h, reactive } from 'vue'\n\nimport { default as ApiReference } from '@/components/ApiReference.vue'\n\nconst getSpecScriptTag = (doc: Document) => doc.getElementById('api-reference')\n\n/**\n * Reading the configuration from the data-attributes.\n */\nexport function getConfigurationFromDataAttributes(doc: Document): ApiReferenceConfigurationWithSource {\n  const specElement = doc.querySelector('[data-spec]')\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n  const configurationScriptElement = doc.querySelector('#api-reference[data-configuration]')\n\n  const getConfiguration = () => {\n    // <script data-configuration=\"{ … }\" />\n    if (configurationScriptElement) {\n      const configurationFromElement = configurationScriptElement.getAttribute('data-configuration')\n\n      if (configurationFromElement) {\n        return {\n          _integration: 'html',\n          ...JSON.parse(configurationFromElement.split('&quot;').join('\"')),\n        }\n      }\n    }\n\n    return apiReferenceConfigurationWithSourceSchema.parse({ _integration: 'html' })\n  }\n\n  const getUrl = () => {\n    // Let's first check if the user passed a spec URL in the configuration.\n    if (getConfiguration().url) {\n      return getConfiguration().url\n    }\n\n    if (getConfiguration().spec?.url) {\n      return getConfiguration().spec?.url\n    }\n\n    // <script id=\"api-reference\" data-url=\"/scalar.json\" />\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const urlFromScriptTag = specScriptTag.getAttribute('data-url')?.trim()\n\n      if (urlFromScriptTag) {\n        return urlFromScriptTag\n      }\n    }\n\n    // <div data-spec-url=\"/scalar.json\" />\n    if (specUrlElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec-url] HTML API is deprecated. Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead.',\n      )\n      const urlFromSpecUrlElement = specUrlElement.getAttribute('data-spec-url')\n\n      if (urlFromSpecUrlElement) {\n        return urlFromSpecUrlElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getContent = (): string | undefined => {\n    // <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const specFromScriptTag = specScriptTag.innerHTML?.trim()\n\n      if (specFromScriptTag) {\n        return specFromScriptTag\n      }\n    }\n\n    // <div data-spec='{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}' />\n    if (specElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec] HTML API is deprecated. Use the new <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script> API instead.',\n      )\n      const specFromSpecElement = specElement.getAttribute('data-spec')?.trim()\n\n      if (specFromSpecElement) {\n        return specFromSpecElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getProxyUrl = () => {\n    // <script id=\"api-reference\" data-proxy-url=\"https://proxy.scalar.com\">…</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const proxyUrl = specScriptTag.getAttribute('data-proxy-url')\n\n      if (proxyUrl) {\n        return proxyUrl.trim()\n      }\n    }\n\n    return undefined\n  }\n\n  // Ensure Reference Props are reactive\n  if (!specUrlElement && !specElement && !getSpecScriptTag(doc)) {\n    // Stay quiet.\n  } else {\n    const urlOrContent = getContent() ? { content: getContent() } : { url: getUrl() }\n\n    return apiReferenceConfigurationWithSourceSchema.parse({\n      _integration: 'html',\n      proxyUrl: getProxyUrl(),\n      ...getConfiguration(),\n      ...urlOrContent,\n    })\n  }\n\n  return apiReferenceConfigurationWithSourceSchema.parse({ _integration: 'html' })\n}\n\n/**\n * Mount the Scalar API Reference on a given document.\n * Read the HTML data-attributes for configuration.\n */\nexport function findDataAttributes(doc: Document, configuration: ApiReferenceConfigurationWithSource) {\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specElement = doc.querySelector('[data-spec]')\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n\n  if (configuration?.darkMode) {\n    doc.body?.classList.add('dark-mode')\n  } else {\n    doc.body?.classList.add('light-mode')\n  }\n\n  const container = createContainer(doc, specElement || specUrlElement)\n\n  if (container) {\n    createApiReference(container, configuration)\n  }\n}\n\n// If it's a script tag, we can't mount the Vue.js app inside that tag.\n// We need to add a new container element before the script tag.\nexport const createContainer = (doc: Document, element?: Element | null) => {\n  let _container: Element | null = null\n\n  const specScriptTag = getSpecScriptTag(doc)\n\n  if (specScriptTag) {\n    _container = doc.createElement('div')\n    specScriptTag?.parentNode?.insertBefore(_container, specScriptTag)\n  } else if (element) {\n    _container = element\n  }\n\n  return _container\n}\n\n/**\n * Create (and mount) a new Scalar API Reference\n *\n * @example createApiReference({ url: '/scalar.json' }).mount('#app')\n * @example createApiReference('#app', { url: '/scalar.json' })\n * @example createApiReference(document.getElementById('app'), { url: '/scalar.json' })\n */\nexport const createApiReference: CreateApiReference = (\n  elementOrSelectorOrConfig,\n  optionalConfiguration?: AnyApiReferenceConfiguration,\n) => {\n  // Create an id prefix for useId so we don't have collisions with other Vue apps\n  const idPrefix = 'scalar-refs'\n\n  const props = reactive<{ configuration: AnyApiReferenceConfiguration }>({\n    // Either the configuration will be the second argument or it MUST be the first (configuration only)\n    configuration: optionalConfiguration ?? (elementOrSelectorOrConfig as AnyApiReferenceConfiguration) ?? {},\n  })\n\n  // Create a new Vue app instance\n  let app = createApp(() => h(ApiReference, props))\n\n  // Meta tags, etc.\n  app.use(createHead())\n\n  app.config.idPrefix = idPrefix\n\n  // If we have an optional config, then we must mount the element immediately (not sure why type is not narrowing)\n  if (optionalConfiguration) {\n    // If the element is a string, we need to find the actual DOM element\n    const element =\n      typeof elementOrSelectorOrConfig === 'string'\n        ? document.querySelector(elementOrSelectorOrConfig)\n        : (elementOrSelectorOrConfig as Element)\n\n    if (element) {\n      app.mount(element)\n    } else {\n      console.error('Could not find a mount point for API References:', elementOrSelectorOrConfig)\n    }\n  }\n\n  /**\n   * Reload the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:reload-references',\n    () => {\n      console.warn(\n        'scalar:reload-references event has been deprecated, please use the scalarInstance.app.mount method instead.',\n      )\n      if (!props.configuration) {\n        return\n      }\n\n      // Snag the current element\n      const currentElement =\n        typeof elementOrSelectorOrConfig === 'string'\n          ? document.querySelector(elementOrSelectorOrConfig)\n          : (elementOrSelectorOrConfig as Element)\n\n      if (!currentElement) {\n        return\n      }\n\n      // Ensure we re-attach the element if it was unmounted\n      if (currentElement && !document.body.contains(currentElement)) {\n        document.body.appendChild(currentElement)\n      }\n\n      // Create a new Vue app instance\n      app.unmount()\n      app = createApp(() => h(ApiReference, props))\n      app.use(createHead())\n      app.config.idPrefix = idPrefix\n      app.mount(currentElement)\n    },\n    false,\n  )\n\n  /** Destroy the current API Reference instance */\n  const destroy = () => {\n    props.configuration = {}\n    app.unmount()\n  }\n\n  /**\n   * Allow user to destroy the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:destroy-references',\n    () => {\n      console.warn('scalar:destroy-references event has been deprecated, please use scalarInstance.destroy instead.')\n      destroy()\n    },\n    false,\n  )\n\n  /**\n   * Allow user to update configuration\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:update-references-config',\n    (ev) => {\n      console.warn(\n        'scalar:update-references-config event has been deprecated, please use scalarInstance.updateConfiguration instead.',\n      )\n      if ('detail' in ev) {\n        Object.assign(props, ev.detail)\n      }\n    },\n    false,\n  )\n\n  const instance = {\n    app,\n    getConfiguration: () => props.configuration ?? {},\n    updateConfiguration: (newConfig: AnyApiReferenceConfiguration) => {\n      props.configuration = newConfig\n    },\n    destroy,\n  }\n\n  return instance\n}\n"],"mappings":";;;;;;;;;;;;AAgLA,IAAa,sBACX,2BACA,0BACG;CAEH,MAAM,WAAW;CAEjB,MAAM,QAAQ,SAA0D,EAEtE,eAAe,yBAA0B,6BAA8D,EAAE,EAC1G,CAAC;CAGF,IAAI,MAAM,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAGjD,KAAI,IAAI,YAAY,CAAC;AAErB,KAAI,OAAO,WAAW;AAGtB,KAAI,uBAAuB;EAEzB,MAAM,UACJ,OAAO,8BAA8B,WACjC,SAAS,cAAc,0BAA0B,GAChD;AAEP,MAAI,QACF,KAAI,MAAM,QAAQ;MAElB,SAAQ,MAAM,oDAAoD,0BAA0B;;;;;;AAQhG,UAAS,iBACP,kCACM;AACJ,UAAQ,KACN,8GACD;AACD,MAAI,CAAC,MAAM,cACT;EAIF,MAAM,iBACJ,OAAO,8BAA8B,WACjC,SAAS,cAAc,0BAA0B,GAChD;AAEP,MAAI,CAAC,eACH;AAIF,MAAI,kBAAkB,CAAC,SAAS,KAAK,SAAS,eAAe,CAC3D,UAAS,KAAK,YAAY,eAAe;AAI3C,MAAI,SAAS;AACb,QAAM,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAC7C,MAAI,IAAI,YAAY,CAAC;AACrB,MAAI,OAAO,WAAW;AACtB,MAAI,MAAM,eAAe;IAE3B,MACD;;CAGD,MAAM,gBAAgB;AACpB,QAAM,gBAAgB,EAAE;AACxB,MAAI,SAAS;;;;;;AAOf,UAAS,iBACP,mCACM;AACJ,UAAQ,KAAK,kGAAkG;AAC/G,WAAS;IAEX,MACD;;;;;AAMD,UAAS,iBACP,oCACC,OAAO;AACN,UAAQ,KACN,oHACD;AACD,MAAI,YAAY,GACd,QAAO,OAAO,OAAO,GAAG,OAAO;IAGnC,MACD;AAWD,QATiB;EACf;EACA,wBAAwB,MAAM,iBAAiB,EAAE;EACjD,sBAAsB,cAA4C;AAChE,SAAM,gBAAgB;;EAExB;EACD"}
+{"version":3,"file":"html-api.js","names":[],"sources":["../../../src/standalone/lib/html-api.ts"],"sourcesContent":["import type {\n  AnyApiReferenceConfiguration,\n  ApiReferenceConfigurationWithSource,\n  CreateApiReference,\n} from '@scalar/types/api-reference'\nimport { apiReferenceConfigurationWithSourceSchema } from '@scalar/types/api-reference'\nimport { createHead } from '@unhead/vue/client'\nimport { createApp, createSSRApp, h, reactive } from 'vue'\n\nimport { default as ApiReference } from '@/components/ApiReference.vue'\n\nconst getSpecScriptTag = (doc: Document) => doc.getElementById('api-reference')\n\n/**\n * Reading the configuration from the data-attributes.\n */\nexport function getConfigurationFromDataAttributes(doc: Document): ApiReferenceConfigurationWithSource {\n  const specElement = doc.querySelector('[data-spec]')\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n  const configurationScriptElement = doc.querySelector('#api-reference[data-configuration]')\n\n  const getConfiguration = () => {\n    // <script data-configuration=\"{ … }\" />\n    if (configurationScriptElement) {\n      const configurationFromElement = configurationScriptElement.getAttribute('data-configuration')\n\n      if (configurationFromElement) {\n        return {\n          _integration: 'html',\n          ...JSON.parse(configurationFromElement.split('&quot;').join('\"')),\n        }\n      }\n    }\n\n    return apiReferenceConfigurationWithSourceSchema.parse({ _integration: 'html' })\n  }\n\n  const getUrl = () => {\n    // Let's first check if the user passed a spec URL in the configuration.\n    if (getConfiguration().url) {\n      return getConfiguration().url\n    }\n\n    if (getConfiguration().spec?.url) {\n      return getConfiguration().spec?.url\n    }\n\n    // <script id=\"api-reference\" data-url=\"/scalar.json\" />\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const urlFromScriptTag = specScriptTag.getAttribute('data-url')?.trim()\n\n      if (urlFromScriptTag) {\n        return urlFromScriptTag\n      }\n    }\n\n    // <div data-spec-url=\"/scalar.json\" />\n    if (specUrlElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec-url] HTML API is deprecated. Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead.',\n      )\n      const urlFromSpecUrlElement = specUrlElement.getAttribute('data-spec-url')\n\n      if (urlFromSpecUrlElement) {\n        return urlFromSpecUrlElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getContent = (): string | undefined => {\n    // <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const specFromScriptTag = specScriptTag.innerHTML?.trim()\n\n      if (specFromScriptTag) {\n        return specFromScriptTag\n      }\n    }\n\n    // <div data-spec='{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}' />\n    if (specElement) {\n      console.warn(\n        '[@scalar/api-reference] The [data-spec] HTML API is deprecated. Use the new <script id=\"api-reference\" type=\"application/json\">{\"openapi\":\"3.1.0\",\"info\":{\"title\":\"Example\"},\"paths\":{}}</script> API instead.',\n      )\n      const specFromSpecElement = specElement.getAttribute('data-spec')?.trim()\n\n      if (specFromSpecElement) {\n        return specFromSpecElement\n      }\n    }\n\n    return undefined\n  }\n\n  const getProxyUrl = () => {\n    // <script id=\"api-reference\" data-proxy-url=\"https://proxy.scalar.com\">…</script>\n    const specScriptTag = getSpecScriptTag(doc)\n    if (specScriptTag) {\n      const proxyUrl = specScriptTag.getAttribute('data-proxy-url')\n\n      if (proxyUrl) {\n        return proxyUrl.trim()\n      }\n    }\n\n    return undefined\n  }\n\n  // Ensure Reference Props are reactive\n  if (!specUrlElement && !specElement && !getSpecScriptTag(doc)) {\n    // Stay quiet.\n  } else {\n    const urlOrContent = getContent() ? { content: getContent() } : { url: getUrl() }\n\n    return apiReferenceConfigurationWithSourceSchema.parse({\n      _integration: 'html',\n      proxyUrl: getProxyUrl(),\n      ...getConfiguration(),\n      ...urlOrContent,\n    })\n  }\n\n  return apiReferenceConfigurationWithSourceSchema.parse({ _integration: 'html' })\n}\n\n/**\n * Mount the Scalar API Reference on a given document.\n * Read the HTML data-attributes for configuration.\n */\nexport function findDataAttributes(doc: Document, configuration: ApiReferenceConfigurationWithSource) {\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specElement = doc.querySelector('[data-spec]')\n  /** @deprecated Use the new <script id=\"api-reference\" data-url=\"/scalar.json\" /> API instead. */\n  const specUrlElement = doc.querySelector('[data-spec-url]')\n\n  if (configuration?.darkMode) {\n    doc.body?.classList.add('dark-mode')\n  } else {\n    doc.body?.classList.add('light-mode')\n  }\n\n  const container = createContainer(doc, specElement || specUrlElement)\n\n  if (container) {\n    createApiReference(container, configuration)\n  }\n}\n\n// If it's a script tag, we can't mount the Vue.js app inside that tag.\n// We need to add a new container element before the script tag.\nexport const createContainer = (doc: Document, element?: Element | null) => {\n  let _container: Element | null = null\n\n  const specScriptTag = getSpecScriptTag(doc)\n\n  if (specScriptTag) {\n    _container = doc.createElement('div')\n    specScriptTag?.parentNode?.insertBefore(_container, specScriptTag)\n  } else if (element) {\n    _container = element\n  }\n\n  return _container\n}\n\n/**\n * Create (and mount) a new Scalar API Reference\n *\n * @example createApiReference({ url: '/scalar.json' }).mount('#app')\n * @example createApiReference('#app', { url: '/scalar.json' })\n * @example createApiReference(document.getElementById('app'), { url: '/scalar.json' })\n */\nexport const createApiReference: CreateApiReference = (\n  elementOrSelectorOrConfig,\n  optionalConfiguration?: AnyApiReferenceConfiguration,\n) => {\n  // Create an id prefix for useId so we don't have collisions with other Vue apps\n  const idPrefix = 'scalar-refs'\n\n  const props = reactive<{ configuration: AnyApiReferenceConfiguration }>({\n    // Either the configuration will be the second argument or it MUST be the first (configuration only)\n    configuration: optionalConfiguration ?? (elementOrSelectorOrConfig as AnyApiReferenceConfiguration) ?? {},\n  })\n\n  const createReferenceApp = (isSsr = false) => {\n    const referenceApp = isSsr ? createSSRApp(() => h(ApiReference, props)) : createApp(() => h(ApiReference, props))\n\n    // Meta tags, etc.\n    referenceApp.use(createHead())\n    referenceApp.config.idPrefix = idPrefix\n\n    return referenceApp\n  }\n\n  // If we have an optional config, then we must mount the element immediately (not sure why type is not narrowing)\n  const mountElement = optionalConfiguration\n    ? typeof elementOrSelectorOrConfig === 'string'\n      ? document.querySelector(elementOrSelectorOrConfig)\n      : (elementOrSelectorOrConfig as Element)\n    : null\n\n  // Detect server-rendered content and use createSSRApp for hydration\n  const shouldHydrate = !!optionalConfiguration && !!mountElement && mountElement.children.length > 0\n  let app = createReferenceApp(shouldHydrate)\n\n  if (optionalConfiguration) {\n    if (mountElement) {\n      app.mount(mountElement)\n    } else {\n      console.error('Could not find a mount point for API References:', elementOrSelectorOrConfig)\n    }\n  }\n\n  /**\n   * Reload the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:reload-references',\n    () => {\n      console.warn(\n        'scalar:reload-references event has been deprecated, please use the scalarInstance.app.mount method instead.',\n      )\n      if (!props.configuration) {\n        return\n      }\n\n      // Snag the current element\n      const currentElement =\n        typeof elementOrSelectorOrConfig === 'string'\n          ? document.querySelector(elementOrSelectorOrConfig)\n          : (elementOrSelectorOrConfig as Element)\n\n      if (!currentElement) {\n        return\n      }\n\n      // Ensure we re-attach the element if it was unmounted\n      if (currentElement && !document.body.contains(currentElement)) {\n        document.body.appendChild(currentElement)\n      }\n\n      // Create a new Vue app instance\n      app.unmount()\n      app = createReferenceApp()\n      app.mount(currentElement)\n    },\n    false,\n  )\n\n  /** Destroy the current API Reference instance */\n  const destroy = () => {\n    props.configuration = {}\n    app.unmount()\n  }\n\n  /**\n   * Allow user to destroy the API Reference\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:destroy-references',\n    () => {\n      console.warn('scalar:destroy-references event has been deprecated, please use scalarInstance.destroy instead.')\n      destroy()\n    },\n    false,\n  )\n\n  /**\n   * Allow user to update configuration\n   * @deprecated\n   */\n  document.addEventListener(\n    'scalar:update-references-config',\n    (ev) => {\n      console.warn(\n        'scalar:update-references-config event has been deprecated, please use scalarInstance.updateConfiguration instead.',\n      )\n      if ('detail' in ev) {\n        Object.assign(props, ev.detail)\n      }\n    },\n    false,\n  )\n\n  const instance = {\n    app,\n    getConfiguration: () => props.configuration ?? {},\n    updateConfiguration: (newConfig: AnyApiReferenceConfiguration) => {\n      props.configuration = newConfig\n    },\n    destroy,\n  }\n\n  return instance\n}\n"],"mappings":";;;;;;;;;;;;AAgLA,IAAa,sBACX,2BACA,0BACG;CAEH,MAAM,WAAW;CAEjB,MAAM,QAAQ,SAA0D,EAEtE,eAAe,yBAA0B,6BAA8D,EAAE,EAC1G,CAAC;CAEF,MAAM,sBAAsB,QAAQ,UAAU;EAC5C,MAAM,eAAe,QAAQ,mBAAmB,EAAE,sBAAc,MAAM,CAAC,GAAG,gBAAgB,EAAE,sBAAc,MAAM,CAAC;AAGjH,eAAa,IAAI,YAAY,CAAC;AAC9B,eAAa,OAAO,WAAW;AAE/B,SAAO;;CAIT,MAAM,eAAe,wBACjB,OAAO,8BAA8B,WACnC,SAAS,cAAc,0BAA0B,GAChD,4BACH;CAIJ,IAAI,MAAM,mBADY,CAAC,CAAC,yBAAyB,CAAC,CAAC,gBAAgB,aAAa,SAAS,SAAS,EACvD;AAE3C,KAAI,sBACF,KAAI,aACF,KAAI,MAAM,aAAa;KAEvB,SAAQ,MAAM,oDAAoD,0BAA0B;;;;;AAQhG,UAAS,iBACP,kCACM;AACJ,UAAQ,KACN,8GACD;AACD,MAAI,CAAC,MAAM,cACT;EAIF,MAAM,iBACJ,OAAO,8BAA8B,WACjC,SAAS,cAAc,0BAA0B,GAChD;AAEP,MAAI,CAAC,eACH;AAIF,MAAI,kBAAkB,CAAC,SAAS,KAAK,SAAS,eAAe,CAC3D,UAAS,KAAK,YAAY,eAAe;AAI3C,MAAI,SAAS;AACb,QAAM,oBAAoB;AAC1B,MAAI,MAAM,eAAe;IAE3B,MACD;;CAGD,MAAM,gBAAgB;AACpB,QAAM,gBAAgB,EAAE;AACxB,MAAI,SAAS;;;;;;AAOf,UAAS,iBACP,mCACM;AACJ,UAAQ,KAAK,kGAAkG;AAC/G,WAAS;IAEX,MACD;;;;;AAMD,UAAS,iBACP,oCACC,OAAO;AACN,UAAQ,KACN,oHACD;AACD,MAAI,YAAY,GACd,QAAO,OAAO,OAAO,GAAG,OAAO;IAGnC,MACD;AAWD,QATiB;EACf;EACA,wBAAwB,MAAM,iBAAiB,EAAE;EACjD,sBAAsB,cAA4C;AAChE,SAAM,gBAAgB;;EAExB;EACD"}

package/dist/style.css

@@ -1680,10 +1680,10 @@ button.headers-card-title[data-v-ab19704d]:hover {
   border-radius: var(--scalar-radius);
 }
 
-.request-body[data-v-48eb3d5d] {
+.request-body[data-v-f323f401] {
   margin-top: 24px;
 }
-.request-body-header[data-v-48eb3d5d] {
+.request-body-header[data-v-f323f401] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -1691,7 +1691,7 @@ button.headers-card-title[data-v-ab19704d]:hover {
   border-bottom: var(--scalar-border-width) solid var(--scalar-border-color);
   flex-flow: wrap;
 }
-.request-body-title[data-v-48eb3d5d] {
+.request-body-title[data-v-f323f401] {
   display: flex;
   align-items: center;
   gap: 8px;
@@ -1699,7 +1699,7 @@ button.headers-card-title[data-v-ab19704d]:hover {
   font-weight: var(--scalar-semibold);
   color: var(--scalar-color-1);
 }
-.request-body-required[data-v-48eb3d5d] {
+.request-body-required[data-v-f323f401] {
   font-size: var(--scalar-micro);
   color: var(--scalar-color-orange);
   font-weight: normal;
@@ -1708,21 +1708,21 @@ button.headers-card-title[data-v-ab19704d]:hover {
   padding: 2px 8px;
   height: 20px;
 }
-.request-body-description[data-v-48eb3d5d] {
+.request-body-description[data-v-f323f401] {
   margin-top: 6px;
   font-size: var(--scalar-small);
   width: 100%;
 }
 .request-body-header
-  + .request-body-schema[data-v-48eb3d5d]:has(> .schema-card > .schema-card-description),
+  + .request-body-schema[data-v-f323f401]:has(> .schema-card > .schema-card-description),
 .request-body-header
-  + .request-body-schema[data-v-48eb3d5d]:has(
+  + .request-body-schema[data-v-f323f401]:has(
     > .schema-card > .schema-properties > * > .property--level-0
   ) {
   /** Add a bit of space between the heading border and the schema description or properties */
   padding-top: 8px;
 }
-.request-body-description[data-v-48eb3d5d] .markdown * {
+.request-body-description[data-v-f323f401] .markdown * {
   color: var(--scalar-color-2) !important;
 }
 
@@ -3392,6 +3392,9 @@ body {
 .scalar-app .-mx-2 {
   margin-inline: -8px;
 }
+.scalar-app .mx-1\.5 {
+  margin-inline: 6px;
+}
 .scalar-app .my-2 {
   margin-block: 8px;
 }
@@ -7869,12 +7872,18 @@ input[data-v-c1a50a6e]::placeholder {
 .scalar-app .min-h-20 {
   min-height: 80px;
 }
+.scalar-app .min-h-\[4rem\] {
+  min-height: 4rem;
+}
 .scalar-app .min-h-\[64px\] {
   min-height: 64px;
 }
 .scalar-app .min-h-\[65px\] {
   min-height: 65px;
 }
+.scalar-app .min-h-\[300px\] {
+  min-height: 300px;
+}
 .scalar-app .min-h-\[calc\(1rem\*4\)\] {
   min-height: 4rem;
 }
@@ -7899,6 +7908,9 @@ input[data-v-c1a50a6e]::placeholder {
 .scalar-app .w-1\/2 {
   width: 50%;
 }
+.scalar-app .w-2 {
+  width: 8px;
+}
 .scalar-app .w-2\.5 {
   width: 10px;
 }
@@ -8484,7 +8496,7 @@ input[data-v-c1a50a6e]::placeholder {
 .scalar-app .border-\(--scalar-color-alert\) {
   border-color: var(--scalar-color-alert);
 }
-.scalar-app .border-border {
+.scalar-app .border-\[var\(--scalar-border-color\)\], .scalar-app .border-border {
   border-color: var(--scalar-border-color);
 }
 .scalar-app .border-c-1 {
@@ -8521,6 +8533,18 @@ input[data-v-c1a50a6e]::placeholder {
 .scalar-app .bg-\(--scalar-background-alert\) {
   background-color: var(--scalar-background-alert);
 }
+.scalar-app .bg-\[var\(--scalar-background-1\)\] {
+  background-color: var(--scalar-background-1);
+}
+.scalar-app .bg-\[var\(--scalar-background-2\)\] {
+  background-color: var(--scalar-background-2);
+}
+.scalar-app .bg-\[var\(--scalar-background-3\)\] {
+  background-color: var(--scalar-background-3);
+}
+.scalar-app .bg-\[var\(--scalar-color-green\)\] {
+  background-color: var(--scalar-color-green);
+}
 .scalar-app .bg-b-1 {
   background-color: var(--scalar-background-1);
 }
@@ -9179,6 +9203,10 @@ input[data-v-c1a50a6e]::placeholder {
   --tw-shadow: 0 -8px 0 8px var(--tw-shadow-color, var(--scalar-background-1)), 0 0 8px 8px var(--tw-shadow-color, var(--scalar-background-1));
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
 }
+.scalar-app .shadow-\[var\(--scalar-shadow-1\)\] {
+  --tw-shadow: var(--scalar-shadow-1);
+  box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+}
 .scalar-app .shadow-border {
   --tw-shadow: inset 0 0 0 var(--tw-shadow-color, var(--scalar-border-width)) var(--scalar-border-color);
   box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
@@ -9239,6 +9267,11 @@ input[data-v-c1a50a6e]::placeholder {
   transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
   transition-duration: var(--tw-duration, var(--default-transition-duration));
 }
+.scalar-app .transition-all {
+  transition-property: all;
+  transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
+  transition-duration: var(--tw-duration, var(--default-transition-duration));
+}
 .scalar-app .transition-colors {
   transition-property: color, background-color, border-color, outline-color, text-decoration-color, fill, stroke, --tw-gradient-from, --tw-gradient-via, --tw-gradient-to;
   transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
@@ -9601,6 +9634,9 @@ input[data-v-c1a50a6e]::placeholder {
 .scalar-app .hover\:border-inherit:hover {
     border-color: inherit;
 }
+.scalar-app .hover\:bg-\[var\(--scalar-background-3\)\]:hover {
+    background-color: var(--scalar-background-3);
+}
 .scalar-app .hover\:bg-b-2:hover, .scalar-app .hover\:bg-b-2\/40:hover {
     background-color: var(--scalar-background-2);
 }
@@ -11908,6 +11944,9 @@ to {
   gap: 1rem;
   display: flex;
 }
+.document-scripts-editors__container[data-v-8c8fa790] {
+  min-height: 300px;
+}
 .authenticationProvided[data-v-e3416cd5] {
   color: var(--scalar-color-1);
   font-weight: var(--scalar-semibold);
@@ -13469,7 +13508,7 @@ div + .userMessage[data-v-8e43ed7a] {
 
 /* Configurable Layout Variables */
 @layer scalar-config {
-.scalar-api-reference[data-v-0d40a3ce] {
+.scalar-api-reference[data-v-f2a1208a] {
     /* The header height */
     --refs-header-height: calc(
       var(--scalar-custom-header-height, 0px) + var(--scalar-header-height, 0px)
@@ -13491,20 +13530,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-0d40a3ce] {
+.scalar-api-reference.references-classic[data-v-f2a1208a] {
     /* 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-0d40a3ce] {
+.t-doc__sidebar[data-v-f2a1208a] {
   z-index: 10;
 }
 
 /* ----------------------------------------------------- */
 /* References Layout */
-.references-layout[data-v-0d40a3ce] {
+.references-layout[data-v-f2a1208a] {
   /* Try to fill the container */
   min-height: 100dvh;
   min-width: 100%;
@@ -13528,44 +13567,44 @@ div + .userMessage[data-v-8e43ed7a] {
 
   background: var(--scalar-background-1);
 }
-.references-editor[data-v-0d40a3ce] {
+.references-editor[data-v-f2a1208a] {
   grid-area: editor;
   display: flex;
   min-width: 0;
   background: var(--scalar-background-1);
 }
-.references-rendered[data-v-0d40a3ce] {
+.references-rendered[data-v-f2a1208a] {
   position: relative;
   grid-area: rendered;
   min-width: 0;
   background: var(--scalar-background-1);
 }
-.scalar-api-reference.references-classic[data-v-0d40a3ce],
-.references-classic .references-rendered[data-v-0d40a3ce] {
+.scalar-api-reference.references-classic[data-v-f2a1208a],
+.references-classic .references-rendered[data-v-f2a1208a] {
   height: initial !important;
   max-height: initial !important;
 }
 @layer scalar-config {
-.references-sidebar[data-v-0d40a3ce] {
+.references-sidebar[data-v-f2a1208a] {
     /* Set a default width if references are enabled */
     --refs-sidebar-width: var(--scalar-sidebar-width, 288px);
 }
 }
 
 /* Footer */
-.references-footer[data-v-0d40a3ce] {
+.references-footer[data-v-f2a1208a] {
   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-0d40a3ce] {
+.references-developer-tools[data-v-f2a1208a] {
     display: none;
 }
 
   /* Stack view on mobile */
-.references-layout[data-v-0d40a3ce] {
+.references-layout[data-v-f2a1208a] {
     /* 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 +13619,13 @@ div + .userMessage[data-v-8e43ed7a] {
       'rendered'
       'footer';
 }
-.references-editable[data-v-0d40a3ce] {
+.references-editable[data-v-f2a1208a] {
     grid-template-areas:
       'header'
       'navigation'
       'editor';
 }
-.references-rendered[data-v-0d40a3ce] {
+.references-rendered[data-v-f2a1208a] {
     position: static;
 }
 }
@@ -13597,12 +13636,12 @@ div + .userMessage[data-v-8e43ed7a] {
 * when the new elements are available
 */
 @media (max-width: 1000px) {
-.scalar-api-references-standalone-mobile[data-v-0d40a3ce]:not(.references-classic) {
+.scalar-api-references-standalone-mobile[data-v-f2a1208a]:not(.references-classic) {
     --scalar-header-height: 50px;
 }
 }
 
-.darklight-reference[data-v-0d40a3ce] {
+.darklight-reference[data-v-f2a1208a] {
   width: 100%;
   margin-top: auto;
 }

package/package.json

@@ -20,7 +20,7 @@
     "vue",
     "vue3"
   ],
-  "version": "1.51.0",
+  "version": "1.52.0",
   "engines": {
     "node": ">=22"
   },
@@ -64,11 +64,6 @@
       "types": "./dist/helpers/index.d.ts",
       "default": "./dist/helpers/index.js"
     },
-    "./ssr": {
-      "import": "./dist/ssr.js",
-      "types": "./dist/ssr.d.ts",
-      "default": "./dist/ssr.js"
-    },
     "./style.css": "./dist/style.css",
     "./browser/standalone.js": "./dist/browser/standalone.js"
   },
@@ -91,20 +86,20 @@
     "nanoid": "^5.1.6",
     "vue": "^3.5.30",
     "yaml": "^2.8.0",
-    "@scalar/agent-chat": "0.10.1",
-    "@scalar/api-client": "2.41.0",
-    "@scalar/code-highlight": "0.3.2",
+    "@scalar/agent-chat": "0.10.2",
+    "@scalar/components": "0.21.3",
     "@scalar/helpers": "0.4.3",
-    "@scalar/oas-utils": "0.10.16",
+    "@scalar/code-highlight": "0.3.2",
     "@scalar/icons": "0.7.2",
-    "@scalar/sidebar": "0.8.18",
-    "@scalar/components": "0.21.3",
-    "@scalar/snippetz": "0.7.8",
+    "@scalar/oas-utils": "0.11.0",
+    "@scalar/api-client": "2.42.0",
+    "@scalar/sidebar": "0.8.19",
+    "@scalar/snippetz": "0.8.0",
     "@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/types": "0.8.0",
+    "@scalar/workspace-store": "0.44.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.10",
@@ -121,8 +116,8 @@
     "vite-plugin-banner": "^0.8.1",
     "vite-plugin-css-injected-by-js": "^3.5.2",
     "vitest": "4.1.0",
-    "@scalar/galaxy": "0.6.2",
-    "@scalar/core": "0.4.6"
+    "@scalar/core": "0.5.0",
+    "@scalar/galaxy": "0.6.2"
   },
   "scripts": {
     "build": "pnpm build:default && pnpm build:standalone && vue-tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",

package/dist/ssr.d.ts

@@ -1,22 +0,0 @@
-/**
- * SSR entry point for @scalar/api-reference.
- *
- * Re-exports the same components as the main entry. The ApiReference component
- * is SSR-compatible and works with createSSRApp and renderToString from
- * @vue/server-renderer.
- *
- * @example
- * ```ts
- * import { createSSRApp } from 'vue'
- * import { renderToString } from '@vue/server-renderer'
- * import { ApiReference } from '@scalar/api-reference/ssr'
- *
- * const app = createSSRApp({
- *   render: () => h(ApiReference, { configuration: { url: '/openapi.json' } }),
- * })
- * const html = await renderToString(app)
- * ```
- */
-export type { ApiReferenceConfiguration, ReferenceProps } from './index.js';
-export { ApiReference, GettingStarted, SearchButton, SearchModal, createApiReference, createEmptySpecification, } from './index.js';
-//# sourceMappingURL=ssr.d.ts.map

package/dist/ssr.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../src/ssr.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,SAAS,CAAA"}

package/dist/ssr.js

@@ -1,7 +0,0 @@
-import { createEmptySpecification } from "./helpers/openapi.js";
-import SearchModal_default from "./features/Search/components/SearchModal.vue.js";
-import SearchButton_default from "./features/Search/components/SearchButton.vue.js";
-import ApiReference_default from "./components/ApiReference.vue.js";
-import GettingStarted_default from "./components/GettingStarted.vue.js";
-import { createApiReference } from "./standalone/lib/html-api.js";
-export { ApiReference_default as ApiReference, GettingStarted_default as GettingStarted, SearchButton_default as SearchButton, SearchModal_default as SearchModal, createApiReference, createEmptySpecification };