@scalar/api-client 3.20.0 → 3.21.0

package/dist/v2/blocks/request-block/components/RequestParams.vue.script.js

@@ -1,11 +1,15 @@
 import { useLocalization } from "../../../features/localization/index.js";
 import RequestTable_default from "./RequestTable.vue.js";
 import CollapsibleSection_default from "../../../components/layout/CollapsibleSection.vue.js";
-import { computed, createBlock, createCommentVNode, createElementVNode, createTextVNode, createVNode, defineComponent, openBlock, toDisplayString, unref, withCtx, withModifiers } from "vue";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, openBlock, toDisplayString, unref, withCtx, withModifiers } from "vue";
 import { ScalarButton } from "@scalar/components/button";
 import { ScalarTooltip } from "@scalar/components/tooltip";
 //#region src/v2/blocks/request-block/components/RequestParams.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { class: "text-c-2 request-meta-buttons flex whitespace-nowrap opacity-0 group-hover/params:opacity-100 has-[:focus-visible]:opacity-100" };
+var _hoisted_2 = {
+	key: 0,
+	class: "text-c-2 px-3 py-2 text-sm"
+};
 var RequestParams_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	__name: "RequestParams",
 	props: {
@@ -13,6 +17,7 @@ var RequestParams_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		exampleKey: {},
 		title: {},
 		label: {},
+		description: {},
 		invalidParams: {},
 		globalRoute: {},
 		showAddRowPlaceholder: {
@@ -64,7 +69,7 @@ var RequestParams_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					}, 8, ["aria-label"])]),
 					_: 1
 				}, 8, ["content"])) : createCommentVNode("", true)])]),
-				default: withCtx(() => [createVNode(RequestTable_default, {
+				default: withCtx(() => [__props.description ? (openBlock(), createElementBlock("p", _hoisted_2, toDisplayString(__props.description), 1)) : createCommentVNode("", true), createVNode(RequestTable_default, {
 					class: "flex-1",
 					columns: [
 						"32px",

package/dist/v2/blocks/request-block/components/RequestParams.vue.script.js.map

@@ -1 +1 @@
-{"version":3,"file":"RequestParams.vue.script.js","names":[],"sources":["../../../../../src/v2/blocks/request-block/components/RequestParams.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { ScalarButton } from '@scalar/components/button'\nimport { ScalarTooltip } from '@scalar/components/tooltip'\nimport type {\n  ApiReferenceEvents,\n  WorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport { computed } from 'vue'\n\nimport { CollapsibleSection } from '@/v2/components/layout'\nimport { useLocalization } from '@/v2/features/localization'\n\nimport RequestTable from './RequestTable.vue'\nimport type { TableRow, TableRowUpsertPayload } from './RequestTableRow.vue'\n\nconst {\n  rows,\n  exampleKey,\n  environment,\n  title,\n  globalRoute,\n  showAddRowPlaceholder = true,\n  eventBus,\n} = defineProps<{\n  rows: TableRow[]\n  exampleKey: string\n  title: string\n  label?: string\n  invalidParams?: Set<string>\n  globalRoute?: string\n  showAddRowPlaceholder?: boolean\n  environment: XScalarEnvironment\n  eventBus: WorkspaceEventBus\n}>()\n\nconst emit = defineEmits<{\n  (\n    e: 'upsert',\n    index: number,\n    payload: ApiReferenceEvents['operation:upsert:parameter']['payload'] & {\n      shouldRenameExpandedRow?: boolean\n    },\n  ): void\n  (e: 'delete', payload: { index: number }): void\n  (e: 'deleteAll'): void\n  /** Select a value for a grouped global cookie preset at the given row index. */\n  (e: 'selectPreset', index: number, value: string): void\n}>()\n\nconst { translate } = useLocalization()\n\nconst showTooltip = computed(() => rows.length > 1)\n\n/** Needed for type guard */\nconst handleUpserRow = (index: number, payload: TableRowUpsertPayload) => {\n  const { value, ...rest } = payload\n\n  // Type guard here as we cannot add files to params\n  if (value instanceof File) {\n    return\n  }\n\n  emit('upsert', index, { ...rest, value: value ?? '' })\n}\n</script>\n<template>\n  <CollapsibleSection\n    class=\"group/params\"\n    :itemCount=\"rows.length\">\n    <template #title>{{ title }}</template>\n    <template #actions>\n      <div\n        class=\"text-c-2 request-meta-buttons flex whitespace-nowrap opacity-0 group-hover/params:opacity-100 has-[:focus-visible]:opacity-100\">\n        <ScalarTooltip\n          v-if=\"showTooltip\"\n          :content=\"\n            translate('apiClient.requestParams.clearOptionalParameters')\n          \"\n          placement=\"left\">\n          <ScalarButton\n            :aria-label=\"\n              translate('apiClient.requestParams.clearAll', { title })\n            \"\n            class=\"pr-0.75 pl-1 transition-none\"\n            size=\"sm\"\n            variant=\"ghost\"\n            @click.stop=\"emit('deleteAll')\">\n            {{ translate('apiClient.requestParams.clear') }}\n          </ScalarButton>\n        </ScalarTooltip>\n      </div>\n    </template>\n    <RequestTable\n      class=\"flex-1\"\n      :columns=\"['32px', '', '']\"\n      :data=\"rows\"\n      :environment=\"environment\"\n      :exampleKey=\"exampleKey\"\n      :globalRoute=\"globalRoute\"\n      :invalidParams=\"invalidParams\"\n      :label=\"label\"\n      :showAddRowPlaceholder=\"showAddRowPlaceholder\"\n      @deleteRow=\"(index) => emit('delete', { index })\"\n      @navigate=\"(route) => eventBus.emit('ui:navigate', route)\"\n      @selectPreset=\"(index, value) => emit('selectPreset', index, value)\"\n      @upsertRow=\"handleUpserRow\" />\n  </CollapsibleSection>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCA,MAAM,OAAO;EAcb,MAAM,EAAE,cAAc,gBAAgB;EAEtC,MAAM,cAAc,eAAe,QAAA,KAAK,SAAS,CAAC;;EAGlD,MAAM,kBAAkB,OAAe,YAAmC;GACxE,MAAM,EAAE,OAAO,GAAG,SAAS;GAG3B,IAAI,iBAAiB,MACnB;GAGF,KAAK,UAAU,OAAO;IAAE,GAAG;IAAM,OAAO,SAAS;GAAG,CAAC;EACvD;;uBAGE,YAwCqB,MAAA,0BAAA,GAAA;IAvCnB,OAAM;IACL,WAAW,QAAA,KAAK;;IACN,OAAK,cAAY,CAAA,gBAAA,gBAAR,QAAA,KAAK,GAAA,CAAA,CAAA,CAAA;IACd,SAAO,cAoBV,CAnBN,mBAmBM,OAnBN,YAmBM,CAhBI,YAAA,SAAA,UAAA,GADR,YAgBgB,MAAA,aAAA,GAAA;;KAdb,SAAsB,MAAA,SAAA,CAAS,CAAA,iDAAA;KAGhC,WAAU;;4BAUK,CATf,YASe,MAAA,YAAA,GAAA;MARZ,cAA2B,MAAA,SAAA,CAAS,CAAA,oCAAA,EAAA,OAAuC,QAAA,MAAK,CAAA;MAGjF,OAAM;MACN,MAAK;MACL,SAAQ;MACP,SAAK,OAAA,OAAA,OAAA,KAAA,eAAA,WAAO,KAAI,WAAA,GAAA,CAAA,MAAA,CAAA;;6BAC+B,CAAA,gBAAA,gBAA7C,MAAA,SAAA,CAAS,CAAA,+BAAA,CAAA,GAAA,CAAA,CAAA,CAAA;;;;;2BAkBY,CAbhC,YAagC,sBAAA;KAZ9B,OAAM;KACL,SAAS;MAAA;MAAA;MAAA;KAAA;KACT,MAAM,QAAA;KACN,aAAa,QAAA;KACb,YAAY,QAAA;KACZ,aAAa,QAAA;KACb,eAAe,QAAA;KACf,OAAO,QAAA;KACP,uBAAuB,QAAA;KACvB,aAAS,OAAA,OAAA,OAAA,MAAG,UAAU,KAAI,UAAA,EAAa,MAAK,CAAA;KAC5C,YAAQ,OAAA,OAAA,OAAA,MAAG,UAAU,QAAA,SAAS,KAAI,eAAgB,KAAK;KACvD,gBAAY,OAAA,OAAA,OAAA,MAAG,OAAO,UAAU,KAAI,gBAAiB,OAAO,KAAK;KACjE,aAAW"}
+{"version":3,"file":"RequestParams.vue.script.js","names":[],"sources":["../../../../../src/v2/blocks/request-block/components/RequestParams.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { ScalarButton } from '@scalar/components/button'\nimport { ScalarTooltip } from '@scalar/components/tooltip'\nimport type {\n  ApiReferenceEvents,\n  WorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport { computed } from 'vue'\n\nimport { CollapsibleSection } from '@/v2/components/layout'\nimport { useLocalization } from '@/v2/features/localization'\n\nimport RequestTable from './RequestTable.vue'\nimport type { TableRow, TableRowUpsertPayload } from './RequestTableRow.vue'\n\nconst {\n  rows,\n  exampleKey,\n  environment,\n  title,\n  globalRoute,\n  showAddRowPlaceholder = true,\n  eventBus,\n} = defineProps<{\n  rows: TableRow[]\n  exampleKey: string\n  title: string\n  label?: string\n  /** Explain restrictions on parameter editing when needed. */\n  description?: string\n  invalidParams?: Set<string>\n  globalRoute?: string\n  showAddRowPlaceholder?: boolean\n  environment: XScalarEnvironment\n  eventBus: WorkspaceEventBus\n}>()\n\nconst emit = defineEmits<{\n  (\n    e: 'upsert',\n    index: number,\n    payload: ApiReferenceEvents['operation:upsert:parameter']['payload'] & {\n      shouldRenameExpandedRow?: boolean\n    },\n  ): void\n  (e: 'delete', payload: { index: number }): void\n  (e: 'deleteAll'): void\n  /** Select a value for a grouped global cookie preset at the given row index. */\n  (e: 'selectPreset', index: number, value: string): void\n}>()\n\nconst { translate } = useLocalization()\n\nconst showTooltip = computed(() => rows.length > 1)\n\n/** Needed for type guard */\nconst handleUpserRow = (index: number, payload: TableRowUpsertPayload) => {\n  const { value, ...rest } = payload\n\n  // Type guard here as we cannot add files to params\n  if (value instanceof File) {\n    return\n  }\n\n  emit('upsert', index, { ...rest, value: value ?? '' })\n}\n</script>\n<template>\n  <CollapsibleSection\n    class=\"group/params\"\n    :itemCount=\"rows.length\">\n    <template #title>{{ title }}</template>\n    <template #actions>\n      <div\n        class=\"text-c-2 request-meta-buttons flex whitespace-nowrap opacity-0 group-hover/params:opacity-100 has-[:focus-visible]:opacity-100\">\n        <ScalarTooltip\n          v-if=\"showTooltip\"\n          :content=\"\n            translate('apiClient.requestParams.clearOptionalParameters')\n          \"\n          placement=\"left\">\n          <ScalarButton\n            :aria-label=\"\n              translate('apiClient.requestParams.clearAll', { title })\n            \"\n            class=\"pr-0.75 pl-1 transition-none\"\n            size=\"sm\"\n            variant=\"ghost\"\n            @click.stop=\"emit('deleteAll')\">\n            {{ translate('apiClient.requestParams.clear') }}\n          </ScalarButton>\n        </ScalarTooltip>\n      </div>\n    </template>\n    <p\n      v-if=\"description\"\n      class=\"text-c-2 px-3 py-2 text-sm\">\n      {{ description }}\n    </p>\n    <RequestTable\n      class=\"flex-1\"\n      :columns=\"['32px', '', '']\"\n      :data=\"rows\"\n      :environment=\"environment\"\n      :exampleKey=\"exampleKey\"\n      :globalRoute=\"globalRoute\"\n      :invalidParams=\"invalidParams\"\n      :label=\"label\"\n      :showAddRowPlaceholder=\"showAddRowPlaceholder\"\n      @deleteRow=\"(index) => emit('delete', { index })\"\n      @navigate=\"(route) => eventBus.emit('ui:navigate', route)\"\n      @selectPreset=\"(index, value) => emit('selectPreset', index, value)\"\n      @upsertRow=\"handleUpserRow\" />\n  </CollapsibleSection>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCA,MAAM,OAAO;EAcb,MAAM,EAAE,cAAc,gBAAgB;EAEtC,MAAM,cAAc,eAAe,QAAA,KAAK,SAAS,CAAC;;EAGlD,MAAM,kBAAkB,OAAe,YAAmC;GACxE,MAAM,EAAE,OAAO,GAAG,SAAS;GAG3B,IAAI,iBAAiB,MACnB;GAGF,KAAK,UAAU,OAAO;IAAE,GAAG;IAAM,OAAO,SAAS;GAAG,CAAC;EACvD;;uBAGE,YA6CqB,MAAA,0BAAA,GAAA;IA5CnB,OAAM;IACL,WAAW,QAAA,KAAK;;IACN,OAAK,cAAY,CAAA,gBAAA,gBAAR,QAAA,KAAK,GAAA,CAAA,CAAA,CAAA;IACd,SAAO,cAoBV,CAnBN,mBAmBM,OAnBN,YAmBM,CAhBI,YAAA,SAAA,UAAA,GADR,YAgBgB,MAAA,aAAA,GAAA;;KAdb,SAAsB,MAAA,SAAA,CAAS,CAAA,iDAAA;KAGhC,WAAU;;4BAUK,CATf,YASe,MAAA,YAAA,GAAA;MARZ,cAA2B,MAAA,SAAA,CAAS,CAAA,oCAAA,EAAA,OAAuC,QAAA,MAAK,CAAA;MAGjF,OAAM;MACN,MAAK;MACL,SAAQ;MACP,SAAK,OAAA,OAAA,OAAA,KAAA,eAAA,WAAO,KAAI,WAAA,GAAA,CAAA,MAAA,CAAA;;6BAC+B,CAAA,gBAAA,gBAA7C,MAAA,SAAA,CAAS,CAAA,+BAAA,CAAA,GAAA,CAAA,CAAA,CAAA;;;;;2BAShB,CAHI,QAAA,eAAA,UAAA,GADR,mBAII,KAJJ,YAII,gBADC,QAAA,WAAW,GAAA,CAAA,KAAA,mBAAA,IAAA,IAAA,GAEhB,YAagC,sBAAA;KAZ9B,OAAM;KACL,SAAS;MAAA;MAAA;MAAA;KAAA;KACT,MAAM,QAAA;KACN,aAAa,QAAA;KACb,YAAY,QAAA;KACZ,aAAa,QAAA;KACb,eAAe,QAAA;KACf,OAAO,QAAA;KACP,uBAAuB,QAAA;KACvB,aAAS,OAAA,OAAA,OAAA,MAAG,UAAU,KAAI,UAAA,EAAa,MAAK,CAAA;KAC5C,YAAQ,OAAA,OAAA,OAAA,MAAG,UAAU,QAAA,SAAS,KAAI,eAAgB,KAAK;KACvD,gBAAY,OAAA,OAAA,OAAA,MAAG,OAAO,UAAU,KAAI,gBAAiB,OAAO,KAAK;KACjE,aAAW"}

package/dist/v2/blocks/request-block/components/RequestTable.vue.d.ts

@@ -30,13 +30,13 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         page: "example";
         documentSlug?: string;
         path: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         exampleName: string;
     } | {
         page: "operation";
         path: "overview" | "servers" | "authentication" | "editor";
         operationPath: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         documentSlug?: string;
     })) | undefined>) => any;
     upsertRow: (index: number, payload: TableRowUpsertPayload) => any;
@@ -61,13 +61,13 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         page: "example";
         documentSlug?: string;
         path: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         exampleName: string;
     } | {
         page: "operation";
         path: "overview" | "servers" | "authentication" | "editor";
         operationPath: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         documentSlug?: string;
     })) | undefined>) => any) | undefined;
     onUpsertRow?: ((index: number, payload: TableRowUpsertPayload) => any) | undefined;

package/dist/v2/blocks/request-block/components/RequestTableRow.vue.d.ts

@@ -72,13 +72,13 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         page: "example";
         documentSlug?: string;
         path: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         exampleName: string;
     } | {
         page: "operation";
         path: "overview" | "servers" | "authentication" | "editor";
         operationPath: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         documentSlug?: string;
     })) | undefined>) => any;
     upsertRow: (payload: TableRowUpsertPayload) => any;
@@ -103,13 +103,13 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
         page: "example";
         documentSlug?: string;
         path: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         exampleName: string;
     } | {
         page: "operation";
         path: "overview" | "servers" | "authentication" | "editor";
         operationPath: string;
-        method: import("@scalar/helpers/http/http-methods").HttpMethod;
+        method: string;
         documentSlug?: string;
     })) | undefined>) => any) | undefined;
     onUpsertRow?: ((payload: TableRowUpsertPayload) => any) | undefined;

package/dist/v2/blocks/request-block/helpers/create-parameter-rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-parameter-rows.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/request-block/helpers/create-parameter-rows.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,8DAA8D,CAAA;AAGrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAkWjE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,eAAe,EAC1B,YAAY,MAAM,EAClB,UAAS;IACP,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAA;IACtC,iBAAiB,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CAC3D,KACL,QAAQ,EAuDV,CAAA"}
+{"version":3,"file":"create-parameter-rows.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/request-block/helpers/create-parameter-rows.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,8DAA8D,CAAA;AAGrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAkWjE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,eAAe,EAC1B,YAAY,MAAM,EAClB,UAAS;IACP,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAA;IACtC,iBAAiB,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CAC3D,KACL,QAAQ,EAsFV,CAAA"}

package/dist/v2/blocks/request-block/helpers/create-parameter-rows.js

@@ -1,9 +1,11 @@
 import { getParameterSchema } from "./get-parameter-schema.js";
 import { getValueAtPath } from "@scalar/helpers/object/get-value-at-path";
-import { deSerializeParameter, getExample, isParamDisabled } from "@scalar/workspace-store/request-example";
+import { deSerializeParameter, isParamDisabled } from "@scalar/workspace-store/request-example";
 import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
 import { isObject } from "@scalar/helpers/object/is-object";
 import { isArraySchema, isObjectSchema } from "@scalar/workspace-store/schemas/v3.2/strict/type-guards";
+import { getParameterExample } from "@scalar/workspace-store/helpers/get-parameter-example";
+import { getQuerystringParameter, serializeQuerystringParameter } from "@scalar/workspace-store/helpers/querystring-parameter";
 //#region src/v2/blocks/request-block/helpers/create-parameter-rows.ts
 var isParameterWithSchema = (parameter) => "schema" in parameter && parameter.schema !== void 0;
 var resolveSchema = (schema) => {
@@ -188,14 +190,20 @@ var getUnmappedValueRows = ({ parameter, value, schemaRows, mode, isDisabled, is
 * through as a single row.
 */
 var createParameterRows = (parameter, exampleKey, options = {}) => {
-	const example = getExample(parameter, exampleKey, void 0);
+	const selected = getParameterExample(parameter, exampleKey);
+	const { example } = selected;
+	const displayValue = selected.value === null && example?.dataValue === null ? "null" : selected.value;
 	const isDisabled = isParamDisabled(parameter, example);
 	const isDisabledByDefault = !parameter.required && parameter.in !== "path" && example?.["x-disabled"] === void 0;
 	const schema = getParameterSchema(parameter);
-	const mode = getExpansionMode(parameter, schema);
-	if (mode === null || !schema || !isObjectSchema(schema)) return [toSingleParameterRow(parameter, schema, example?.value, isDisabled, isDisabledByDefault)];
-	const value = example?.value === void 0 ? void 0 : deSerializeParameter(example.value, parameter);
-	if (!schema.properties) return [toSingleParameterRow(parameter, schema, example?.value, isDisabled, isDisabledByDefault)];
+	if (parameter.in === "querystring") {
+		const querystring = getQuerystringParameter(parameter, exampleKey, { includeDisabled: true });
+		return [toSingleParameterRow(parameter, void 0, querystring ? serializeQuerystringParameter(querystring) : "", isDisabled, isDisabledByDefault)];
+	}
+	const mode = selected.serialized ? null : getExpansionMode(parameter, schema);
+	if (mode === null || !schema || !isObjectSchema(schema)) return [toSingleParameterRow(parameter, selected.serialized ? void 0 : schema, displayValue, isDisabled, isDisabledByDefault)];
+	const value = selected.value === void 0 ? void 0 : deSerializeParameter(selected.value, parameter);
+	if (!schema.properties) return [toSingleParameterRow(parameter, selected.serialized ? void 0 : schema, displayValue, isDisabled, isDisabledByDefault)];
 	const hiddenValuePaths = new Set(options.hiddenValuePaths?.map(toPathKey) ?? []);
 	const renamedValuePaths = new Map((options.renamedValuePaths ?? []).map(({ from, to }) => [toPathKey(from), to]));
 	const renameTargetPaths = new Set((options.renamedValuePaths ?? []).map(({ to }) => toPathKey(to)));

package/dist/v2/blocks/request-block/helpers/create-parameter-rows.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-parameter-rows.js","names":[],"sources":["../../../../../src/v2/blocks/request-block/helpers/create-parameter-rows.ts"],"sourcesContent":["import { getValueAtPath } from '@scalar/helpers/object/get-value-at-path'\nimport { isObject } from '@scalar/helpers/object/is-object'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { deSerializeParameter, getExample, isParamDisabled } from '@scalar/workspace-store/request-example'\nimport type {\n  ParameterObject,\n  ParameterWithSchemaObject,\n  ReferenceType,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport { isArraySchema, isObjectSchema } from '@scalar/workspace-store/schemas/v3.2/strict/type-guards'\n\nimport type { TableRow } from '../components/RequestTableRow.vue'\nimport { getParameterSchema } from './get-parameter-schema'\n\ntype ParameterWithRequiredSchema = ParameterWithSchemaObject & {\n  schema: ReferenceType<SchemaObject>\n}\n\n/** Serialization mode for object-typed query parameters that we expand into multiple rows. */\ntype ExpansionMode = 'form' | 'deepObject'\n\nconst isParameterWithSchema = (parameter: ParameterObject): parameter is ParameterWithRequiredSchema =>\n  'schema' in parameter && parameter.schema !== undefined\n\nconst resolveSchema = (schema: unknown): SchemaObject | undefined => {\n  const resolvedSchema = getResolvedRef(schema as SchemaObject | { '$ref': string; '$ref-value': SchemaObject })\n\n  return resolvedSchema\n}\n\n/**\n * Resolves the OpenAPI serialization style and explode flag for a parameter, falling back to the\n * spec defaults (style: 'form', explode: true when style is 'form').\n */\nconst getParameterStyleAndExplode = (parameter: ParameterObject): { style: string; explode: boolean } => {\n  const style = 'style' in parameter && parameter.style ? parameter.style : 'form'\n  const explode = 'explode' in parameter && parameter.explode !== undefined ? parameter.explode : style === 'form'\n\n  return { style, explode }\n}\n\n/**\n * Decides whether an object-typed query parameter should be expanded into one row per property,\n * and which expansion mode to use. Returns null when the parameter should stay as a single row\n * (non-query, non-object schema, or a serialization style we do not expand).\n */\nconst getExpansionMode = (parameter: ParameterObject, schema: SchemaObject | undefined): ExpansionMode | null => {\n  if (parameter.in !== 'query' || !isParameterWithSchema(parameter) || !schema || !isObjectSchema(schema)) {\n    return null\n  }\n\n  const { style, explode } = getParameterStyleAndExplode(parameter)\n  if (!explode) {\n    return null\n  }\n\n  if (style === 'form') {\n    return 'form'\n  }\n  if (style === 'deepObject') {\n    return 'deepObject'\n  }\n\n  return null\n}\n\nconst toTableValue = (value: unknown): string => {\n  if (value === undefined || value === null) {\n    return ''\n  }\n\n  if (Array.isArray(value)) {\n    return value.join(',')\n  }\n\n  if (typeof value === 'object') {\n    return JSON.stringify(value)\n  }\n\n  return String(value)\n}\n\nconst toPathKey = (path: readonly string[]): string => path.join('\\u0000')\n\nconst toTableRow = ({\n  parameter,\n  name,\n  value,\n  description,\n  schema,\n  isRequired,\n  isDisabled,\n  isDisabledByDefault,\n  sourceParameterValuePath,\n}: {\n  parameter: ParameterObject\n  name: string\n  value: unknown\n  description: string | undefined\n  schema: SchemaObject | undefined\n  isRequired: boolean | undefined\n  isDisabled: boolean\n  isDisabledByDefault?: boolean\n  sourceParameterValuePath?: string[]\n}): TableRow => ({\n  name,\n  value: toTableValue(value),\n  description,\n  schema,\n  isRequired,\n  isDisabled,\n  ...(isDisabledByDefault ? { isDisabledByDefault: true } : {}),\n  originalParameter: parameter,\n  sourceParameterValuePath,\n})\n\n/**\n * Builds the row name for an expanded property at a given value path. deepObject rows mirror the\n * wire format (`parent[a][b]`); form-style explode uses the bare top-level key.\n */\nconst getExpandedRowName = (parameter: ParameterObject, path: string[], mode: ExpansionMode): string =>\n  mode === 'deepObject' ? `${parameter.name}${path.map((segment) => `[${segment}]`).join('')}` : (path[0] ?? '')\n\n/**\n * Appends the display-only trailing `[]` to deepObject array leaves so the name matches the\n * serialized `parent[ids][]=1&parent[ids][]=2` form. The bracket is display-only — the row's\n * `sourceParameterValuePath` stays bracket-free. It also lets write-back recognize the leaf as an\n * array even on renamed and unmapped rows, which carry no schema.\n */\nconst withArrayBracket = (name: string, mode: ExpansionMode, isArray: boolean): string =>\n  mode === 'deepObject' && isArray ? `${name}[]` : name\n\n/** Build the single-row representation used when a parameter is not expanded. */\nconst toSingleParameterRow = (\n  parameter: ParameterObject,\n  schema: SchemaObject | undefined,\n  value: unknown,\n  isDisabled: boolean,\n  isDisabledByDefault: boolean,\n): TableRow =>\n  toTableRow({\n    parameter,\n    name: parameter.name,\n    value,\n    description: parameter.description,\n    schema,\n    isRequired: parameter.required,\n    isDisabled,\n    isDisabledByDefault,\n  })\n\n/**\n * Walks an object schema and produces one row per property.\n *\n * - In `form` mode (the OpenAPI default for query parameters) only the top-level properties are\n *   flattened, and each row is named after the property itself (`status`).\n * - In `deepObject` mode we recurse into nested objects and emit bracketed names that mirror the\n *   serialization on the wire (`filter[user][id]`).\n *\n * `pathPrefix` tracks the path inside the parent parameter value so the handler can later\n * reassemble all sibling rows back into a single object payload.\n */\nconst getExpandedPropertyRows = ({\n  parameter,\n  schema,\n  value,\n  pathPrefix,\n  namePrefix,\n  mode,\n  isDisabled,\n  isDisabledByDefault,\n  hiddenValuePaths,\n  renamedValuePaths,\n  renameTargetPaths,\n}: {\n  parameter: ParameterObject\n  schema: Extract<SchemaObject, { type: 'object' }>\n  value: unknown\n  pathPrefix: string[]\n  namePrefix: string\n  mode: ExpansionMode\n  isDisabled: boolean\n  isDisabledByDefault: boolean\n  hiddenValuePaths: ReadonlySet<string>\n  renamedValuePaths: ReadonlyMap<string, string[]>\n  renameTargetPaths: ReadonlySet<string>\n}): TableRow[] => {\n  if (!schema.properties) {\n    return []\n  }\n\n  const requiredProperties = new Set(schema.required ?? [])\n\n  return Object.entries(schema.properties).flatMap(([propertyName, propertySchema]) => {\n    const resolvedPropertySchema = resolveSchema(propertySchema)\n    if (!resolvedPropertySchema) {\n      return []\n    }\n\n    const path = [...pathPrefix, propertyName]\n    const name = namePrefix ? `${namePrefix}[${propertyName}]` : propertyName\n\n    // When this property was renamed, the value lives at the typed key instead of the schema path.\n    // Keep the row in its original slot so it does not jump to the end of the table.\n    const renamedTo = renamedValuePaths.get(toPathKey(path))\n    const effectivePath = renamedTo ?? path\n\n    if (hiddenValuePaths.has(toPathKey(effectivePath))) {\n      return []\n    }\n\n    if (renamedTo) {\n      // The value move is debounced, so until it lands the value still sits at the old schema path.\n      // Fall back to it so the renamed row shows its value immediately instead of flickering empty.\n      const renamedValue = getValueAtPath(value, renamedTo)\n      const effectiveValue = renamedValue === undefined ? getValueAtPath(value, path) : renamedValue\n\n      return [\n        toTableRow({\n          parameter,\n          // The renamed key carries no schema, so the value's array-ness drives the `[]` marker.\n          name: withArrayBracket(getExpandedRowName(parameter, renamedTo, mode), mode, Array.isArray(effectiveValue)),\n          value: effectiveValue,\n          description: parameter.description,\n          // The renamed key no longer maps to the schema property, so it carries no schema.\n          schema: undefined,\n          isRequired: false,\n          isDisabled,\n          isDisabledByDefault,\n          sourceParameterValuePath: renamedTo,\n        }),\n      ]\n    }\n\n    // Another property was renamed onto this path (for example \"a\" renamed to an existing \"b\").\n    // The renamed row already occupies this slot, so skip the schema-derived row to avoid rendering\n    // two rows for the same value path.\n    if (renameTargetPaths.has(toPathKey(path))) {\n      return []\n    }\n\n    // Only deepObject style recurses into nested objects. The OpenAPI 3.1 spec says form-style\n    // explode flattens only the top-level properties.\n    const shouldRecurse =\n      mode === 'deepObject' && isObjectSchema(resolvedPropertySchema) && Boolean(resolvedPropertySchema.properties)\n\n    if (shouldRecurse) {\n      return getExpandedPropertyRows({\n        parameter,\n        schema: resolvedPropertySchema,\n        value,\n        pathPrefix: path,\n        namePrefix: name,\n        mode,\n        isDisabled,\n        isDisabledByDefault,\n        hiddenValuePaths,\n        renamedValuePaths,\n        renameTargetPaths,\n      })\n    }\n\n    const leafValue = getValueAtPath(value, path)\n\n    // deepObject array values serialize with the trailing-bracket convention\n    // (filter[ids][]=1&filter[ids][]=2), so mirror that in the displayed name. We base this on the\n    // resolved value too, since the schema can be a composition (anyOf) that hides the array type.\n    const displayName = withArrayBracket(name, mode, isArraySchema(resolvedPropertySchema) || Array.isArray(leafValue))\n\n    return [\n      toTableRow({\n        parameter,\n        name: displayName,\n        value: leafValue,\n        description: resolvedPropertySchema.description ?? parameter.description,\n        schema: resolvedPropertySchema,\n        isRequired: requiredProperties.has(propertyName),\n        isDisabled,\n        isDisabledByDefault,\n        sourceParameterValuePath: path,\n      }),\n    ]\n  })\n}\n\n/**\n * Collects the leaf paths of an object value. In `form` mode only the top-level keys are leaves\n * (form-style explode does not flatten nested objects); in `deepObject` mode we recurse into nested\n * objects, mirroring how the rows and serialization are built.\n */\nconst collectValueLeafPaths = (value: unknown, mode: ExpansionMode): string[][] => {\n  if (!isObject(value)) {\n    return []\n  }\n\n  const paths: string[][] = []\n\n  const walk = (node: Record<string, unknown>, prefix: string[]): void => {\n    for (const [key, val] of Object.entries(node)) {\n      const path = [...prefix, key]\n\n      if (mode === 'deepObject' && isObject(val)) {\n        walk(val, path)\n      } else {\n        paths.push(path)\n      }\n    }\n  }\n\n  walk(value, [])\n\n  return paths\n}\n\n/**\n * Builds rows for value paths that the schema does not describe. This keeps user-edited keys (for\n * example a property that was renamed in the table) visible instead of snapping back to the\n * schema-derived rows on the next render.\n */\nconst getUnmappedValueRows = ({\n  parameter,\n  value,\n  schemaRows,\n  mode,\n  isDisabled,\n  isDisabledByDefault,\n  renamedValuePaths,\n}: {\n  parameter: ParameterObject\n  value: unknown\n  schemaRows: TableRow[]\n  mode: ExpansionMode\n  isDisabled: boolean\n  isDisabledByDefault: boolean\n  renamedValuePaths: ReadonlyMap<string, string[]>\n}): TableRow[] => {\n  // Skip the renamed-away source paths too: the value move is debounced, so the old key lingers in\n  // the value for a moment and would otherwise flash as a duplicate row next to the renamed one.\n  const seen = new Set([\n    ...schemaRows.map((row) => toPathKey(row.sourceParameterValuePath ?? [])),\n    ...renamedValuePaths.keys(),\n  ])\n\n  // These rows always render: a key that carries a value should stay visible. The hidden-path set\n  // only suppresses empty schema suggestions, so it is intentionally not applied here.\n  return collectValueLeafPaths(value, mode)\n    .filter((path) => !seen.has(toPathKey(path)))\n    .map((path) => {\n      const leafValue = getValueAtPath(value, path)\n\n      return toTableRow({\n        parameter,\n        // No schema describes these rows, so the value's array-ness drives the `[]` marker.\n        name: withArrayBracket(getExpandedRowName(parameter, path, mode), mode, Array.isArray(leafValue)),\n        value: leafValue,\n        description: parameter.description,\n        schema: undefined,\n        isRequired: false,\n        isDisabled,\n        isDisabledByDefault,\n        sourceParameterValuePath: path,\n      })\n    })\n}\n\n/**\n * Turns a single OpenAPI parameter into one or more table rows.\n *\n * For object-typed query parameters with `form`/`explode: true` (the default) or `deepObject`\n * serialization, each property becomes its own row so the user can edit them individually,\n * matching how tools like Postman present the same parameter. Every other parameter passes\n * through as a single row.\n */\nexport const createParameterRows = (\n  parameter: ParameterObject,\n  exampleKey: string,\n  options: {\n    hiddenValuePaths?: readonly string[][]\n    renamedValuePaths?: readonly { from: string[]; to: string[] }[]\n  } = {},\n): TableRow[] => {\n  const example = getExample(parameter, exampleKey, undefined)\n  const isDisabled = isParamDisabled(parameter, example)\n  // Preserve type-to-enable behavior until the user explicitly chooses a checkbox state.\n  const isDisabledByDefault = !parameter.required && parameter.in !== 'path' && example?.['x-disabled'] === undefined\n  const schema = getParameterSchema(parameter)\n  const mode = getExpansionMode(parameter, schema)\n\n  // Non-expandable parameters: render as a single row.\n  if (mode === null || !schema || !isObjectSchema(schema)) {\n    return [toSingleParameterRow(parameter, schema, example?.value, isDisabled, isDisabledByDefault)]\n  }\n\n  // Expand into per-property rows. The deserialized value is used so existing per-property values\n  // can be displayed in the table even when the example arrives as a serialized string.\n  const value = example?.value === undefined ? undefined : deSerializeParameter(example.value, parameter)\n\n  // Fall back to a single row only when the schema has no properties to expand.\n  if (!schema.properties) {\n    return [toSingleParameterRow(parameter, schema, example?.value, isDisabled, isDisabledByDefault)]\n  }\n\n  const hiddenValuePaths = new Set(options.hiddenValuePaths?.map(toPathKey) ?? [])\n  const renamedValuePaths = new Map((options.renamedValuePaths ?? []).map(({ from, to }) => [toPathKey(from), to]))\n  // Paths a property was renamed onto, used to suppress the colliding schema-derived row.\n  const renameTargetPaths = new Set((options.renamedValuePaths ?? []).map(({ to }) => toPathKey(to)))\n\n  const rows = getExpandedPropertyRows({\n    parameter,\n    schema,\n    value,\n    pathPrefix: [],\n    // deepObject names every row with a `parent[child]` prefix; form-style names use bare property names.\n    namePrefix: mode === 'deepObject' ? parameter.name : '',\n    mode,\n    isDisabled,\n    isDisabledByDefault,\n    hiddenValuePaths,\n    renamedValuePaths,\n    renameTargetPaths,\n  })\n\n  // Surface keys present in the value but not in the schema (for example a renamed property) so the\n  // edited key keeps showing up instead of snapping back to the schema-derived rows.\n  const unmappedRows = getUnmappedValueRows({\n    parameter,\n    value,\n    schemaRows: rows,\n    mode,\n    isDisabled,\n    isDisabledByDefault,\n    renamedValuePaths,\n  })\n\n  return [...rows, ...unmappedRows]\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-parameter-rows.js","names":[],"sources":["../../../../../src/v2/blocks/request-block/helpers/create-parameter-rows.ts"],"sourcesContent":["import { getValueAtPath } from '@scalar/helpers/object/get-value-at-path'\nimport { isObject } from '@scalar/helpers/object/is-object'\nimport { getParameterExample } from '@scalar/workspace-store/helpers/get-parameter-example'\nimport { getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport {\n  getQuerystringParameter,\n  serializeQuerystringParameter,\n} from '@scalar/workspace-store/helpers/querystring-parameter'\nimport { deSerializeParameter, isParamDisabled } from '@scalar/workspace-store/request-example'\nimport type {\n  ParameterObject,\n  ParameterWithSchemaObject,\n  ReferenceType,\n  SchemaObject,\n} from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport { isArraySchema, isObjectSchema } from '@scalar/workspace-store/schemas/v3.2/strict/type-guards'\n\nimport type { TableRow } from '../components/RequestTableRow.vue'\nimport { getParameterSchema } from './get-parameter-schema'\n\ntype ParameterWithRequiredSchema = ParameterWithSchemaObject & {\n  schema: ReferenceType<SchemaObject>\n}\n\n/** Serialization mode for object-typed query parameters that we expand into multiple rows. */\ntype ExpansionMode = 'form' | 'deepObject'\n\nconst isParameterWithSchema = (parameter: ParameterObject): parameter is ParameterWithRequiredSchema =>\n  'schema' in parameter && parameter.schema !== undefined\n\nconst resolveSchema = (schema: unknown): SchemaObject | undefined => {\n  const resolvedSchema = getResolvedRef(schema as SchemaObject | { '$ref': string; '$ref-value': SchemaObject })\n\n  return resolvedSchema\n}\n\n/**\n * Resolves the OpenAPI serialization style and explode flag for a parameter, falling back to the\n * spec defaults (style: 'form', explode: true when style is 'form').\n */\nconst getParameterStyleAndExplode = (parameter: ParameterObject): { style: string; explode: boolean } => {\n  const style = 'style' in parameter && parameter.style ? parameter.style : 'form'\n  const explode = 'explode' in parameter && parameter.explode !== undefined ? parameter.explode : style === 'form'\n\n  return { style, explode }\n}\n\n/**\n * Decides whether an object-typed query parameter should be expanded into one row per property,\n * and which expansion mode to use. Returns null when the parameter should stay as a single row\n * (non-query, non-object schema, or a serialization style we do not expand).\n */\nconst getExpansionMode = (parameter: ParameterObject, schema: SchemaObject | undefined): ExpansionMode | null => {\n  if (parameter.in !== 'query' || !isParameterWithSchema(parameter) || !schema || !isObjectSchema(schema)) {\n    return null\n  }\n\n  const { style, explode } = getParameterStyleAndExplode(parameter)\n  if (!explode) {\n    return null\n  }\n\n  if (style === 'form') {\n    return 'form'\n  }\n  if (style === 'deepObject') {\n    return 'deepObject'\n  }\n\n  return null\n}\n\nconst toTableValue = (value: unknown): string => {\n  if (value === undefined || value === null) {\n    return ''\n  }\n\n  if (Array.isArray(value)) {\n    return value.join(',')\n  }\n\n  if (typeof value === 'object') {\n    return JSON.stringify(value)\n  }\n\n  return String(value)\n}\n\nconst toPathKey = (path: readonly string[]): string => path.join('\\u0000')\n\nconst toTableRow = ({\n  parameter,\n  name,\n  value,\n  description,\n  schema,\n  isRequired,\n  isDisabled,\n  isDisabledByDefault,\n  sourceParameterValuePath,\n}: {\n  parameter: ParameterObject\n  name: string\n  value: unknown\n  description: string | undefined\n  schema: SchemaObject | undefined\n  isRequired: boolean | undefined\n  isDisabled: boolean\n  isDisabledByDefault?: boolean\n  sourceParameterValuePath?: string[]\n}): TableRow => ({\n  name,\n  value: toTableValue(value),\n  description,\n  schema,\n  isRequired,\n  isDisabled,\n  ...(isDisabledByDefault ? { isDisabledByDefault: true } : {}),\n  originalParameter: parameter,\n  sourceParameterValuePath,\n})\n\n/**\n * Builds the row name for an expanded property at a given value path. deepObject rows mirror the\n * wire format (`parent[a][b]`); form-style explode uses the bare top-level key.\n */\nconst getExpandedRowName = (parameter: ParameterObject, path: string[], mode: ExpansionMode): string =>\n  mode === 'deepObject' ? `${parameter.name}${path.map((segment) => `[${segment}]`).join('')}` : (path[0] ?? '')\n\n/**\n * Appends the display-only trailing `[]` to deepObject array leaves so the name matches the\n * serialized `parent[ids][]=1&parent[ids][]=2` form. The bracket is display-only — the row's\n * `sourceParameterValuePath` stays bracket-free. It also lets write-back recognize the leaf as an\n * array even on renamed and unmapped rows, which carry no schema.\n */\nconst withArrayBracket = (name: string, mode: ExpansionMode, isArray: boolean): string =>\n  mode === 'deepObject' && isArray ? `${name}[]` : name\n\n/** Build the single-row representation used when a parameter is not expanded. */\nconst toSingleParameterRow = (\n  parameter: ParameterObject,\n  schema: SchemaObject | undefined,\n  value: unknown,\n  isDisabled: boolean,\n  isDisabledByDefault: boolean,\n): TableRow =>\n  toTableRow({\n    parameter,\n    name: parameter.name,\n    value,\n    description: parameter.description,\n    schema,\n    isRequired: parameter.required,\n    isDisabled,\n    isDisabledByDefault,\n  })\n\n/**\n * Walks an object schema and produces one row per property.\n *\n * - In `form` mode (the OpenAPI default for query parameters) only the top-level properties are\n *   flattened, and each row is named after the property itself (`status`).\n * - In `deepObject` mode we recurse into nested objects and emit bracketed names that mirror the\n *   serialization on the wire (`filter[user][id]`).\n *\n * `pathPrefix` tracks the path inside the parent parameter value so the handler can later\n * reassemble all sibling rows back into a single object payload.\n */\nconst getExpandedPropertyRows = ({\n  parameter,\n  schema,\n  value,\n  pathPrefix,\n  namePrefix,\n  mode,\n  isDisabled,\n  isDisabledByDefault,\n  hiddenValuePaths,\n  renamedValuePaths,\n  renameTargetPaths,\n}: {\n  parameter: ParameterObject\n  schema: Extract<SchemaObject, { type: 'object' }>\n  value: unknown\n  pathPrefix: string[]\n  namePrefix: string\n  mode: ExpansionMode\n  isDisabled: boolean\n  isDisabledByDefault: boolean\n  hiddenValuePaths: ReadonlySet<string>\n  renamedValuePaths: ReadonlyMap<string, string[]>\n  renameTargetPaths: ReadonlySet<string>\n}): TableRow[] => {\n  if (!schema.properties) {\n    return []\n  }\n\n  const requiredProperties = new Set(schema.required ?? [])\n\n  return Object.entries(schema.properties).flatMap(([propertyName, propertySchema]) => {\n    const resolvedPropertySchema = resolveSchema(propertySchema)\n    if (!resolvedPropertySchema) {\n      return []\n    }\n\n    const path = [...pathPrefix, propertyName]\n    const name = namePrefix ? `${namePrefix}[${propertyName}]` : propertyName\n\n    // When this property was renamed, the value lives at the typed key instead of the schema path.\n    // Keep the row in its original slot so it does not jump to the end of the table.\n    const renamedTo = renamedValuePaths.get(toPathKey(path))\n    const effectivePath = renamedTo ?? path\n\n    if (hiddenValuePaths.has(toPathKey(effectivePath))) {\n      return []\n    }\n\n    if (renamedTo) {\n      // The value move is debounced, so until it lands the value still sits at the old schema path.\n      // Fall back to it so the renamed row shows its value immediately instead of flickering empty.\n      const renamedValue = getValueAtPath(value, renamedTo)\n      const effectiveValue = renamedValue === undefined ? getValueAtPath(value, path) : renamedValue\n\n      return [\n        toTableRow({\n          parameter,\n          // The renamed key carries no schema, so the value's array-ness drives the `[]` marker.\n          name: withArrayBracket(getExpandedRowName(parameter, renamedTo, mode), mode, Array.isArray(effectiveValue)),\n          value: effectiveValue,\n          description: parameter.description,\n          // The renamed key no longer maps to the schema property, so it carries no schema.\n          schema: undefined,\n          isRequired: false,\n          isDisabled,\n          isDisabledByDefault,\n          sourceParameterValuePath: renamedTo,\n        }),\n      ]\n    }\n\n    // Another property was renamed onto this path (for example \"a\" renamed to an existing \"b\").\n    // The renamed row already occupies this slot, so skip the schema-derived row to avoid rendering\n    // two rows for the same value path.\n    if (renameTargetPaths.has(toPathKey(path))) {\n      return []\n    }\n\n    // Only deepObject style recurses into nested objects. The OpenAPI 3.1 spec says form-style\n    // explode flattens only the top-level properties.\n    const shouldRecurse =\n      mode === 'deepObject' && isObjectSchema(resolvedPropertySchema) && Boolean(resolvedPropertySchema.properties)\n\n    if (shouldRecurse) {\n      return getExpandedPropertyRows({\n        parameter,\n        schema: resolvedPropertySchema,\n        value,\n        pathPrefix: path,\n        namePrefix: name,\n        mode,\n        isDisabled,\n        isDisabledByDefault,\n        hiddenValuePaths,\n        renamedValuePaths,\n        renameTargetPaths,\n      })\n    }\n\n    const leafValue = getValueAtPath(value, path)\n\n    // deepObject array values serialize with the trailing-bracket convention\n    // (filter[ids][]=1&filter[ids][]=2), so mirror that in the displayed name. We base this on the\n    // resolved value too, since the schema can be a composition (anyOf) that hides the array type.\n    const displayName = withArrayBracket(name, mode, isArraySchema(resolvedPropertySchema) || Array.isArray(leafValue))\n\n    return [\n      toTableRow({\n        parameter,\n        name: displayName,\n        value: leafValue,\n        description: resolvedPropertySchema.description ?? parameter.description,\n        schema: resolvedPropertySchema,\n        isRequired: requiredProperties.has(propertyName),\n        isDisabled,\n        isDisabledByDefault,\n        sourceParameterValuePath: path,\n      }),\n    ]\n  })\n}\n\n/**\n * Collects the leaf paths of an object value. In `form` mode only the top-level keys are leaves\n * (form-style explode does not flatten nested objects); in `deepObject` mode we recurse into nested\n * objects, mirroring how the rows and serialization are built.\n */\nconst collectValueLeafPaths = (value: unknown, mode: ExpansionMode): string[][] => {\n  if (!isObject(value)) {\n    return []\n  }\n\n  const paths: string[][] = []\n\n  const walk = (node: Record<string, unknown>, prefix: string[]): void => {\n    for (const [key, val] of Object.entries(node)) {\n      const path = [...prefix, key]\n\n      if (mode === 'deepObject' && isObject(val)) {\n        walk(val, path)\n      } else {\n        paths.push(path)\n      }\n    }\n  }\n\n  walk(value, [])\n\n  return paths\n}\n\n/**\n * Builds rows for value paths that the schema does not describe. This keeps user-edited keys (for\n * example a property that was renamed in the table) visible instead of snapping back to the\n * schema-derived rows on the next render.\n */\nconst getUnmappedValueRows = ({\n  parameter,\n  value,\n  schemaRows,\n  mode,\n  isDisabled,\n  isDisabledByDefault,\n  renamedValuePaths,\n}: {\n  parameter: ParameterObject\n  value: unknown\n  schemaRows: TableRow[]\n  mode: ExpansionMode\n  isDisabled: boolean\n  isDisabledByDefault: boolean\n  renamedValuePaths: ReadonlyMap<string, string[]>\n}): TableRow[] => {\n  // Skip the renamed-away source paths too: the value move is debounced, so the old key lingers in\n  // the value for a moment and would otherwise flash as a duplicate row next to the renamed one.\n  const seen = new Set([\n    ...schemaRows.map((row) => toPathKey(row.sourceParameterValuePath ?? [])),\n    ...renamedValuePaths.keys(),\n  ])\n\n  // These rows always render: a key that carries a value should stay visible. The hidden-path set\n  // only suppresses empty schema suggestions, so it is intentionally not applied here.\n  return collectValueLeafPaths(value, mode)\n    .filter((path) => !seen.has(toPathKey(path)))\n    .map((path) => {\n      const leafValue = getValueAtPath(value, path)\n\n      return toTableRow({\n        parameter,\n        // No schema describes these rows, so the value's array-ness drives the `[]` marker.\n        name: withArrayBracket(getExpandedRowName(parameter, path, mode), mode, Array.isArray(leafValue)),\n        value: leafValue,\n        description: parameter.description,\n        schema: undefined,\n        isRequired: false,\n        isDisabled,\n        isDisabledByDefault,\n        sourceParameterValuePath: path,\n      })\n    })\n}\n\n/**\n * Turns a single OpenAPI parameter into one or more table rows.\n *\n * For object-typed query parameters with `form`/`explode: true` (the default) or `deepObject`\n * serialization, each property becomes its own row so the user can edit them individually,\n * matching how tools like Postman present the same parameter. Every other parameter passes\n * through as a single row.\n */\nexport const createParameterRows = (\n  parameter: ParameterObject,\n  exampleKey: string,\n  options: {\n    hiddenValuePaths?: readonly string[][]\n    renamedValuePaths?: readonly { from: string[]; to: string[] }[]\n  } = {},\n): TableRow[] => {\n  const selected = getParameterExample(parameter, exampleKey)\n  const { example } = selected\n  const displayValue = selected.value === null && example?.dataValue === null ? 'null' : selected.value\n  const isDisabled = isParamDisabled(parameter, example)\n  // Preserve type-to-enable behavior until the user explicitly chooses a checkbox state.\n  const isDisabledByDefault = !parameter.required && parameter.in !== 'path' && example?.['x-disabled'] === undefined\n  const schema = getParameterSchema(parameter)\n  if (parameter.in === 'querystring') {\n    const querystring = getQuerystringParameter(parameter, exampleKey, { includeDisabled: true })\n    return [\n      toSingleParameterRow(\n        parameter,\n        // The editor accepts URI-ready text; decoded schema suggestions are not valid wire values.\n        undefined,\n        querystring ? serializeQuerystringParameter(querystring) : '',\n        isDisabled,\n        isDisabledByDefault,\n      ),\n    ]\n  }\n  const mode = selected.serialized ? null : getExpansionMode(parameter, schema)\n\n  // Non-expandable parameters: render as a single row.\n  if (mode === null || !schema || !isObjectSchema(schema)) {\n    return [\n      toSingleParameterRow(\n        parameter,\n        selected.serialized ? undefined : schema,\n        displayValue,\n        isDisabled,\n        isDisabledByDefault,\n      ),\n    ]\n  }\n\n  // Expand into per-property rows. The deserialized value is used so existing per-property values\n  // can be displayed in the table even when the example arrives as a serialized string.\n  const value = selected.value === undefined ? undefined : deSerializeParameter(selected.value, parameter)\n\n  // Fall back to a single row only when the schema has no properties to expand.\n  if (!schema.properties) {\n    return [\n      toSingleParameterRow(\n        parameter,\n        selected.serialized ? undefined : schema,\n        displayValue,\n        isDisabled,\n        isDisabledByDefault,\n      ),\n    ]\n  }\n\n  const hiddenValuePaths = new Set(options.hiddenValuePaths?.map(toPathKey) ?? [])\n  const renamedValuePaths = new Map((options.renamedValuePaths ?? []).map(({ from, to }) => [toPathKey(from), to]))\n  // Paths a property was renamed onto, used to suppress the colliding schema-derived row.\n  const renameTargetPaths = new Set((options.renamedValuePaths ?? []).map(({ to }) => toPathKey(to)))\n\n  const rows = getExpandedPropertyRows({\n    parameter,\n    schema,\n    value,\n    pathPrefix: [],\n    // deepObject names every row with a `parent[child]` prefix; form-style names use bare property names.\n    namePrefix: mode === 'deepObject' ? parameter.name : '',\n    mode,\n    isDisabled,\n    isDisabledByDefault,\n    hiddenValuePaths,\n    renamedValuePaths,\n    renameTargetPaths,\n  })\n\n  // Surface keys present in the value but not in the schema (for example a renamed property) so the\n  // edited key keeps showing up instead of snapping back to the schema-derived rows.\n  const unmappedRows = getUnmappedValueRows({\n    parameter,\n    value,\n    schemaRows: rows,\n    mode,\n    isDisabled,\n    isDisabledByDefault,\n    renamedValuePaths,\n  })\n\n  return [...rows, ...unmappedRows]\n}\n"],"mappings":";;;;;;;;;AA2BA,IAAM,yBAAyB,cAC7B,YAAY,aAAa,UAAU,WAAW,KAAA;AAEhD,IAAM,iBAAiB,WAA8C;CAGnE,OAFuB,eAAe,MAE/B;AACT;;;;;AAMA,IAAM,+BAA+B,cAAoE;CACvG,MAAM,QAAQ,WAAW,aAAa,UAAU,QAAQ,UAAU,QAAQ;CAG1E,OAAO;EAAE;EAAO,SAFA,aAAa,aAAa,UAAU,YAAY,KAAA,IAAY,UAAU,UAAU,UAAU;CAElF;AAC1B;;;;;;AAOA,IAAM,oBAAoB,WAA4B,WAA2D;CAC/G,IAAI,UAAU,OAAO,WAAW,CAAC,sBAAsB,SAAS,KAAK,CAAC,UAAU,CAAC,eAAe,MAAM,GACpG,OAAO;CAGT,MAAM,EAAE,OAAO,YAAY,4BAA4B,SAAS;CAChE,IAAI,CAAC,SACH,OAAO;CAGT,IAAI,UAAU,QACZ,OAAO;CAET,IAAI,UAAU,cACZ,OAAO;CAGT,OAAO;AACT;AAEA,IAAM,gBAAgB,UAA2B;CAC/C,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO;CAGT,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,KAAK,GAAG;CAGvB,IAAI,OAAO,UAAU,UACnB,OAAO,KAAK,UAAU,KAAK;CAG7B,OAAO,OAAO,KAAK;AACrB;AAEA,IAAM,aAAa,SAAoC,KAAK,KAAK,IAAQ;AAEzE,IAAM,cAAc,EAClB,WACA,MACA,OACA,aACA,QACA,YACA,YACA,qBACA,gCAWe;CACf;CACA,OAAO,aAAa,KAAK;CACzB;CACA;CACA;CACA;CACA,GAAI,sBAAsB,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC3D,mBAAmB;CACnB;AACF;;;;;AAMA,IAAM,sBAAsB,WAA4B,MAAgB,SACtE,SAAS,eAAe,GAAG,UAAU,OAAO,KAAK,KAAK,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,MAAO,KAAK,MAAM;;;;;;;AAQ7G,IAAM,oBAAoB,MAAc,MAAqB,YAC3D,SAAS,gBAAgB,UAAU,GAAG,KAAK,MAAM;;AAGnD,IAAM,wBACJ,WACA,QACA,OACA,YACA,wBAEA,WAAW;CACT;CACA,MAAM,UAAU;CAChB;CACA,aAAa,UAAU;CACvB;CACA,YAAY,UAAU;CACtB;CACA;AACF,CAAC;;;;;;;;;;;;AAaH,IAAM,2BAA2B,EAC/B,WACA,QACA,OACA,YACA,YACA,MACA,YACA,qBACA,kBACA,mBACA,wBAagB;CAChB,IAAI,CAAC,OAAO,YACV,OAAO,CAAC;CAGV,MAAM,qBAAqB,IAAI,IAAI,OAAO,YAAY,CAAC,CAAC;CAExD,OAAO,OAAO,QAAQ,OAAO,UAAU,CAAC,CAAC,SAAS,CAAC,cAAc,oBAAoB;EACnF,MAAM,yBAAyB,cAAc,cAAc;EAC3D,IAAI,CAAC,wBACH,OAAO,CAAC;EAGV,MAAM,OAAO,CAAC,GAAG,YAAY,YAAY;EACzC,MAAM,OAAO,aAAa,GAAG,WAAW,GAAG,aAAa,KAAK;EAI7D,MAAM,YAAY,kBAAkB,IAAI,UAAU,IAAI,CAAC;EACvD,MAAM,gBAAgB,aAAa;EAEnC,IAAI,iBAAiB,IAAI,UAAU,aAAa,CAAC,GAC/C,OAAO,CAAC;EAGV,IAAI,WAAW;GAGb,MAAM,eAAe,eAAe,OAAO,SAAS;GACpD,MAAM,iBAAiB,iBAAiB,KAAA,IAAY,eAAe,OAAO,IAAI,IAAI;GAElF,OAAO,CACL,WAAW;IACT;IAEA,MAAM,iBAAiB,mBAAmB,WAAW,WAAW,IAAI,GAAG,MAAM,MAAM,QAAQ,cAAc,CAAC;IAC1G,OAAO;IACP,aAAa,UAAU;IAEvB,QAAQ,KAAA;IACR,YAAY;IACZ;IACA;IACA,0BAA0B;GAC5B,CAAC,CACH;EACF;EAKA,IAAI,kBAAkB,IAAI,UAAU,IAAI,CAAC,GACvC,OAAO,CAAC;EAQV,IAFE,SAAS,gBAAgB,eAAe,sBAAsB,KAAK,QAAQ,uBAAuB,UAAU,GAG5G,OAAO,wBAAwB;GAC7B;GACA,QAAQ;GACR;GACA,YAAY;GACZ,YAAY;GACZ;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;EAGH,MAAM,YAAY,eAAe,OAAO,IAAI;EAO5C,OAAO,CACL,WAAW;GACT;GACA,MALgB,iBAAiB,MAAM,MAAM,cAAc,sBAAsB,KAAK,MAAM,QAAQ,SAAS,CAKvG;GACN,OAAO;GACP,aAAa,uBAAuB,eAAe,UAAU;GAC7D,QAAQ;GACR,YAAY,mBAAmB,IAAI,YAAY;GAC/C;GACA;GACA,0BAA0B;EAC5B,CAAC,CACH;CACF,CAAC;AACH;;;;;;AAOA,IAAM,yBAAyB,OAAgB,SAAoC;CACjF,IAAI,CAAC,SAAS,KAAK,GACjB,OAAO,CAAC;CAGV,MAAM,QAAoB,CAAC;CAE3B,MAAM,QAAQ,MAA+B,WAA2B;EACtE,KAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,IAAI,GAAG;GAC7C,MAAM,OAAO,CAAC,GAAG,QAAQ,GAAG;GAE5B,IAAI,SAAS,gBAAgB,SAAS,GAAG,GACvC,KAAK,KAAK,IAAI;QAEd,MAAM,KAAK,IAAI;EAEnB;CACF;CAEA,KAAK,OAAO,CAAC,CAAC;CAEd,OAAO;AACT;;;;;;AAOA,IAAM,wBAAwB,EAC5B,WACA,OACA,YACA,MACA,YACA,qBACA,wBASgB;CAGhB,MAAM,uBAAO,IAAI,IAAI,CACnB,GAAG,WAAW,KAAK,QAAQ,UAAU,IAAI,4BAA4B,CAAC,CAAC,CAAC,GACxE,GAAG,kBAAkB,KAAK,CAC5B,CAAC;CAID,OAAO,sBAAsB,OAAO,IAAI,CAAC,CACtC,QAAQ,SAAS,CAAC,KAAK,IAAI,UAAU,IAAI,CAAC,CAAC,CAAC,CAC5C,KAAK,SAAS;EACb,MAAM,YAAY,eAAe,OAAO,IAAI;EAE5C,OAAO,WAAW;GAChB;GAEA,MAAM,iBAAiB,mBAAmB,WAAW,MAAM,IAAI,GAAG,MAAM,MAAM,QAAQ,SAAS,CAAC;GAChG,OAAO;GACP,aAAa,UAAU;GACvB,QAAQ,KAAA;GACR,YAAY;GACZ;GACA;GACA,0BAA0B;EAC5B,CAAC;CACH,CAAC;AACL;;;;;;;;;AAUA,IAAa,uBACX,WACA,YACA,UAGI,CAAC,MACU;CACf,MAAM,WAAW,oBAAoB,WAAW,UAAU;CAC1D,MAAM,EAAE,YAAY;CACpB,MAAM,eAAe,SAAS,UAAU,QAAQ,SAAS,cAAc,OAAO,SAAS,SAAS;CAChG,MAAM,aAAa,gBAAgB,WAAW,OAAO;CAErD,MAAM,sBAAsB,CAAC,UAAU,YAAY,UAAU,OAAO,UAAU,UAAU,kBAAkB,KAAA;CAC1G,MAAM,SAAS,mBAAmB,SAAS;CAC3C,IAAI,UAAU,OAAO,eAAe;EAClC,MAAM,cAAc,wBAAwB,WAAW,YAAY,EAAE,iBAAiB,KAAK,CAAC;EAC5F,OAAO,CACL,qBACE,WAEA,KAAA,GACA,cAAc,8BAA8B,WAAW,IAAI,IAC3D,YACA,mBACF,CACF;CACF;CACA,MAAM,OAAO,SAAS,aAAa,OAAO,iBAAiB,WAAW,MAAM;CAG5E,IAAI,SAAS,QAAQ,CAAC,UAAU,CAAC,eAAe,MAAM,GACpD,OAAO,CACL,qBACE,WACA,SAAS,aAAa,KAAA,IAAY,QAClC,cACA,YACA,mBACF,CACF;CAKF,MAAM,QAAQ,SAAS,UAAU,KAAA,IAAY,KAAA,IAAY,qBAAqB,SAAS,OAAO,SAAS;CAGvG,IAAI,CAAC,OAAO,YACV,OAAO,CACL,qBACE,WACA,SAAS,aAAa,KAAA,IAAY,QAClC,cACA,YACA,mBACF,CACF;CAGF,MAAM,mBAAmB,IAAI,IAAI,QAAQ,kBAAkB,IAAI,SAAS,KAAK,CAAC,CAAC;CAC/E,MAAM,oBAAoB,IAAI,KAAK,QAAQ,qBAAqB,CAAC,EAAA,CAAG,KAAK,EAAE,MAAM,SAAS,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;CAEhH,MAAM,oBAAoB,IAAI,KAAK,QAAQ,qBAAqB,CAAC,EAAA,CAAG,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC;CAElG,MAAM,OAAO,wBAAwB;EACnC;EACA;EACA;EACA,YAAY,CAAC;EAEb,YAAY,SAAS,eAAe,UAAU,OAAO;EACrD;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CAID,MAAM,eAAe,qBAAqB;EACxC;EACA;EACA,YAAY;EACZ;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO,CAAC,GAAG,MAAM,GAAG,YAAY;AAClC"}

package/dist/v2/blocks/scalar-address-bar-block/components/AddressBar.vue.d.ts

@@ -1,4 +1,3 @@
-import type { HttpMethod as HttpMethodType } from '@scalar/helpers/http/http-methods';
 import type { ServerMeta, WorkspaceEventBus } from '@scalar/workspace-store/events';
 import type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments';
 import type { ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
@@ -17,7 +16,7 @@ export type AddressBarProps = {
     /** Current request path */
     path: string;
     /** Current request method */
-    method: HttpMethodType;
+    method: string;
     /** Whether the request target belongs to an OpenAPI webhook. */
     isWebhook?: boolean;
     /** Openapi document slug */
@@ -40,7 +39,7 @@ export type AddressBarProps = {
     serverMeta: ServerMeta;
 };
 declare const __VLS_export: import("vue").DefineComponent<AddressBarProps, {
-    methodConflict: import("vue").Ref<"head" | "delete" | "query" | "get" | "options" | "patch" | "post" | "put" | "trace" | null, "head" | "delete" | "query" | "get" | "options" | "patch" | "post" | "put" | "trace" | null>;
+    methodConflict: import("vue").Ref<string | null, string | null>;
     pathConflict: import("vue").Ref<string | null, string | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "select:history:item": (payload: {

package/dist/v2/blocks/scalar-address-bar-block/components/AddressBar.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddressBar.vue.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-address-bar-block/components/AddressBar.vue"],"names":[],"mappings":"AAqvBA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAIrF,OAAO,KAAK,EAEV,UAAU,EACV,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2EAA2E,CAAA;AACnH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAqBhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAA0B,EAAE,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAGzE;;;;GAIG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAKzC,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAA;IACtB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mDAAmD;IACnD,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,gBAAgB;IAChB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,kBAAkB;IAClB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,sCAAsC;IACtC,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AACD,QAAA,MAAM,YAAY;;;;;eAqB6B,MAAM;;;;;;eAAN,MAAM;;;;kFAuhCjD,CAAC"}
+{"version":3,"file":"AddressBar.vue.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/scalar-address-bar-block/components/AddressBar.vue"],"names":[],"mappings":"AAuvBA,OAAO,KAAK,EAEV,UAAU,EACV,iBAAiB,EAClB,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2EAA2E,CAAA;AACnH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AAqBhG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAA0B,EAAE,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAGzE;;;;GAIG;wBACkB,OAAO,YAAY;AAAxC,wBAAyC;AAKzC,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,mDAAmD;IACnD,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,gBAAgB;IAChB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,kBAAkB;IAClB,WAAW,EAAE,kBAAkB,CAAA;IAC/B,sCAAsC;IACtC,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AACD,QAAA,MAAM,YAAY;;;;;eAqB6B,MAAM;;;;;;eAAN,MAAM;;;;kFAuhCjD,CAAC"}

package/dist/v2/blocks/scalar-address-bar-block/components/AddressBar.vue.js

@@ -2,7 +2,7 @@ import _plugin_vue_export_helper_default from "../../../../_virtual/_plugin-vue_
 import AddressBar_vue_vue_type_script_setup_true_lang_default from "./AddressBar.vue.script.js";
 /* empty css                         */
 //#region src/v2/blocks/scalar-address-bar-block/components/AddressBar.vue
-var AddressBar_default = /*#__PURE__*/ _plugin_vue_export_helper_default(AddressBar_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-65ff0ebf"]]);
+var AddressBar_default = /*#__PURE__*/ _plugin_vue_export_helper_default(AddressBar_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-0e96b5b8"]]);
 //#endregion
 export { AddressBar_default as default };
 

package/dist/v2/blocks/scalar-address-bar-block/components/AddressBar.vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"AddressBar.vue.js","names":[],"sources":["../../../../../src/v2/blocks/scalar-address-bar-block/components/AddressBar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * AddressBar component\n * This component is used to display the address bar for the operation block\n * It is used to display the path, method, server, and history for the operation\n */\nexport default {\n  name: 'AddressBar',\n}\nexport type AddressBarProps = {\n  /** An external example must finish loading before sending. */\n  executionDisabled?: boolean\n  /** Current request path */\n  path: string\n  /** Current request method */\n  method: HttpMethodType\n  /** Whether the request target belongs to an OpenAPI webhook. */\n  isWebhook?: boolean\n  /** Openapi document slug */\n  documentSlug: string\n  /** Currently selected example key for the current operation */\n  exampleKey: string\n  /** Currently selected server */\n  server: ServerObject | null\n  /** Server list available for operation/document */\n  servers: ServerObject[]\n  /** List of request history */\n  history: History[]\n  /** Client layout */\n  layout: ClientLayout\n  /** Event bus */\n  eventBus: WorkspaceEventBus\n  /** Environment */\n  environment: XScalarEnvironment\n  /** Meta information for the server */\n  serverMeta: ServerMeta\n}\n</script>\n<script setup lang=\"ts\">\nimport { ScalarButton } from '@scalar/components/button'\nimport { ScalarIcon } from '@scalar/components/icon'\nimport { getSelector } from '@scalar/helpers/dom/get-selector'\nimport { REQUEST_METHODS } from '@scalar/helpers/http/http-info'\nimport type { HttpMethod as HttpMethodType } from '@scalar/helpers/http/http-methods'\nimport { extractServerFromPath } from '@scalar/helpers/url/extract-server-from-path'\nimport { ScalarIconCopy, ScalarIconWarningCircle } from '@scalar/icons'\nimport { EditorView } from '@scalar/use-codemirror'\nimport type {\n  ApiReferenceEvents,\n  ServerMeta,\n  WorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport type { ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport {\n  computed,\n  nextTick,\n  onBeforeUnmount,\n  onMounted,\n  ref,\n  useId,\n  useTemplateRef,\n  watch,\n} from 'vue'\n\nimport { HttpMethod } from '@/components/HttpMethod'\nimport { getOperationExampleKey } from '@/v2/blocks/operation-block/helpers/response-cache'\nimport { isPlaceholderPath } from '@/v2/blocks/scalar-address-bar-block/helpers/is-placeholder-path'\nimport { refocusBlurTarget } from '@/v2/blocks/scalar-address-bar-block/helpers/refocus-blur-target'\nimport { useLoadingAnimation } from '@/v2/blocks/scalar-address-bar-block/hooks/use-loading-animation'\nimport { usePathMasking } from '@/v2/blocks/scalar-address-bar-block/hooks/use-path-masking'\nimport { CodeInput } from '@/v2/components/code-input'\nimport { ServerDropdown } from '@/v2/components/server'\nimport { useLocalization } from '@/v2/features/localization'\nimport type { ClientLayout } from '@/v2/types/layout'\n\nimport AddressBarHistory, { type History } from './AddressBarHistory.vue'\n\nconst {\n  path,\n  method,\n  layout,\n  eventBus,\n  exampleKey,\n  documentSlug,\n  server,\n  servers,\n  environment,\n  serverMeta,\n  isWebhook = false,\n} = defineProps<AddressBarProps>()\n\nconst emit = defineEmits<{\n  /** Execute the current operation example */\n  (e: 'execute'): void\n  /** Select a request history item by index */\n  (e: 'select:history:item', payload: { index: number }): void\n  /** Update the full destination URL used to deliver a webhook. */\n  (e: 'update:webhook-url', url: string): void\n}>()\n\nconst { translate } = useLocalization()\n\n// ───────────────────────────────────────────────────────────────────\n// Template refs & reactive state\n// ───────────────────────────────────────────────────────────────────\n\nconst id = useId()\nconst sendButtonRef = useTemplateRef('sendButtonRef')\nconst mobileSendButtonRef = useTemplateRef('mobileSendButtonRef')\nconst addressBarRef = useTemplateRef('addressBarRef')\n\nconst { percentage, startLoading, stopLoading, isLoading } =\n  useLoadingAnimation()\n\nconst pathConflict = ref<string | null>(null)\nconst methodConflict = ref<HttpMethodType | null>(null)\nconst tabbedOut = ref(false)\nconst isServerDropdownOpen = ref(false)\nconst isHistoryDropdownOpen = ref(false)\n\n// ───────────────────────────────────────────────────────────────────\n// Derived state\n// ───────────────────────────────────────────────────────────────────\n\n/** Keeps the cursor visible past the fade-right overlay while typing */\nconst addressBarScrollMargins = EditorView.scrollMargins.of(() => ({\n  right: 24,\n}))\n\n/** Animated background transform for the loading indicator */\nconst style = computed(() => ({\n  backgroundColor: `color-mix(in srgb, transparent 90%, ${REQUEST_METHODS[method].colorVar})`,\n  transform: `translate3d(-${percentage.value}%,0,0)`,\n}))\n\n/** Whether there is a path or method conflict */\nconst hasConflict = computed(() => methodConflict.value || pathConflict.value)\n\n/**\n * Placeholder for the path field.\n *\n * Webhooks have no server to prefix the path, so the field doubles as the full\n * destination URL. Hint that a complete URL (including the host) is expected,\n * rather than a bare path.\n */\nconst pathPlaceholder = computed(() => {\n  if (server) {\n    return ''\n  }\n  return isWebhook\n    ? translate('apiClient.addressBar.webhookUrlPlaceholder')\n    : translate('apiClient.addressBar.urlPlaceholder')\n})\n\n/** Whether either dropdown (server or history) is open */\nconst isDropdownOpen = computed(\n  () => isServerDropdownOpen.value || isHistoryDropdownOpen.value,\n)\n\n/** Uniquely identifies the currently selected operation + example */\nconst uniqueKey = computed(() =>\n  getOperationExampleKey(method, path, exampleKey, documentSlug),\n)\n\n/** Clear conflict state when switching to a different operation */\nwatch(uniqueKey, () => {\n  pathConflict.value = null\n  methodConflict.value = null\n})\n\n// ───────────────────────────────────────────────────────────────────\n// Focus helpers\n// ───────────────────────────────────────────────────────────────────\n\nconst handleFocusSendButton = (): void => {\n  const desktop = sendButtonRef.value?.$el\n  const mobile = mobileSendButtonRef.value?.$el\n\n  // Focus whichever send button is currently visible\n  if (desktop && desktop.offsetParent !== null) {\n    desktop.focus()\n  } else {\n    mobile?.focus()\n  }\n}\n\nconst handleFocusAddressBar = (\n  payload: ApiReferenceEvents['ui:focus:address-bar'],\n): void => {\n  // On non-desktop layouts, if already focused we let the browser handle the\n  // native behavior (e.g. selecting the browser's own address bar).\n  if (addressBarRef.value?.isFocused && layout !== 'desktop') {\n    return\n  }\n\n  addressBarRef.value?.focus('end')\n\n  if (payload && 'clear' in payload && payload.clear) {\n    addressBarRef.value?.setCodeMirrorContent('')\n  }\n\n  if (payload && 'event' in payload) {\n    payload.event.preventDefault()\n  }\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Path masking\n//\n// Drafts on `/` and auto-generated `/_scalar_temp...` paths are internal\n// placeholders — the address bar focuses and clears on mount and on\n// navigation so the user sees a blank prompt instead of the internal\n// path. The deferred mask only clears when CodeMirror still contains that\n// placeholder path, so a user edit that lands before the frame is preserved.\n// ───────────────────────────────────────────────────────────────────\n\nusePathMasking({\n  isReady: () => addressBarRef.value?.codeMirror,\n  operationKey: () => uniqueKey.value,\n  shouldMask: () => isPlaceholderPath(path, documentSlug),\n  // Defer to the next frame so focus() runs after click-handler side\n  // effects that move focus (e.g. a dropdown refocusing its trigger),\n  // which would otherwise blur our input and emit a spurious path\n  // update against the now-empty value.\n  onMask: () =>\n    requestAnimationFrame(() => {\n      const editorContent =\n        addressBarRef.value?.codeMirror?.state.doc.toString()\n\n      if (editorContent && editorContent !== path) {\n        return\n      }\n\n      handleFocusAddressBar({ clear: true })\n    }),\n})\n\n// ───────────────────────────────────────────────────────────────────\n// Server extraction\n// ───────────────────────────────────────────────────────────────────\n\n/** If the path contains a server URL, extract it and select or add that server */\nconst extractAndSelectServer = (targetPath: string): string => {\n  const extracted = extractServerFromPath(targetPath)\n  if (!extracted) {\n    return targetPath\n  }\n\n  const [url, remainingPath] = extracted\n\n  // Server is already selected — nothing to do\n  if (url === server?.url) {\n    return remainingPath\n  }\n\n  const matchingServer = servers.find((s) => s.url === url)\n  if (matchingServer) {\n    eventBus.emit('server:update:selected', { url, meta: serverMeta })\n  } else {\n    eventBus.emit('server:add:server', {\n      url,\n      select: true,\n      meta: { type: 'operation', path, method },\n    })\n  }\n\n  return remainingPath\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Path / method updates\n// ───────────────────────────────────────────────────────────────────\n\nconst normalizePath = (value: string): string =>\n  value.startsWith('/') ? value : `/${value}`\n\n/** Emit a path/method update and reconcile conflicts + cursor state on the result */\nconst emitPathMethodUpdate = (\n  targetMethod: HttpMethodType,\n  targetPath: string,\n  blurTargetSelector: string | null = null,\n): void => {\n  if (isWebhook) {\n    // A webhook has no OpenAPI server, so the field holds the full destination\n    // URL. Keep exactly what the user entered — do not split it into an invisible\n    // server plus a leftover path, and do not force a leading slash. That split\n    // is what made a typed URL collapse to a stray \"/\" on blur.\n    const webhookUrl = targetPath.trim()\n    addressBarRef.value?.setCodeMirrorContent(webhookUrl)\n    emit('update:webhook-url', webhookUrl)\n    methodConflict.value = null\n    pathConflict.value = null\n    nextTick(() => refocusBlurTarget(blurTargetSelector))\n    return\n  }\n\n  const extractedPath = extractAndSelectServer(targetPath)\n  const normalizedPath = normalizePath(extractedPath)\n\n  // Keep CodeMirror in sync so a conflict does not leave a stale value on screen\n  addressBarRef.value?.setCodeMirrorContent(normalizedPath)\n\n  eventBus.emit('operation:update:pathMethod', {\n    meta: { method, path },\n    blurTargetSelector,\n    payload: { method: targetMethod, path: normalizedPath },\n    callback: (status, returnedSelector) => {\n      if (status === 'success' || status === 'no-change') {\n        methodConflict.value = null\n        pathConflict.value = null\n      } else if (status === 'conflict') {\n        if (targetMethod !== method) {\n          methodConflict.value = targetMethod\n        }\n        if (normalizedPath !== path) {\n          pathConflict.value = normalizedPath\n        }\n\n        return\n      }\n\n      // Edge case: pasting a full URL extracts the server but leaves the path\n      // unchanged. CodeMirror still shows the full URL, so force it back to\n      // just the path.\n      const mirrorContent = addressBarRef.value?.codeMirrorRef?.textContent\n      if (\n        status === 'no-change' &&\n        mirrorContent &&\n        mirrorContent !== extractedPath\n      ) {\n        addressBarRef.value?.setCodeMirrorContent(extractedPath)\n      }\n\n      nextTick(() => refocusBlurTarget(returnedSelector))\n    },\n  })\n}\n\n/** Change the operation's method, preferring the conflicting path if present */\nconst handleMethodChange = (newMethod: HttpMethodType): void =>\n  emitPathMethodUpdate(newMethod, pathConflict.value ?? path)\n\n/**\n * Save the path on blur and replay the click that caused the blur (so e.g. a\n * click on the Send button still fires after the async update resolves).\n *\n * Tab-outs do not replay — tabbing to a button should not trigger its click\n * (`tabbedOut` is set on `@keydown.tab`).\n *\n * Programmatic focus moves also do not replay. On first navigation into a\n * draft operation, `usePathMasking` focuses and clears the address bar while\n * `ScalarSidebarNestedItems` focuses the drilled-in Back button in\n * `nextTick`. That steals focus from CodeMirror, fires blur with a\n * `relatedTarget` (the Back button), and without a guard we would treat it\n * like a user click: capture the selector, then `refocusBlurTarget` would\n * synthesize `.click()` on Back and navigate away.\n *\n * `FocusEvent.sourceCapabilities` is null when no input device caused the\n * focus change (e.g. `element.focus()`). A real pointer click sets it on the\n * blur that precedes the click, so we still replay Send and other buttons.\n */\nconst handlePathBlur = (newPath: string, event: FocusEvent): void => {\n  const relatedTarget =\n    event.relatedTarget instanceof Element ? event.relatedTarget : null\n  const blurTargetSelector =\n    tabbedOut.value ||\n    ('sourceCapabilities' in event && event.sourceCapabilities === null)\n      ? null\n      : getSelector(relatedTarget)\n  tabbedOut.value = false\n\n  emitPathMethodUpdate(\n    methodConflict.value ?? method,\n    newPath,\n    blurTargetSelector,\n  )\n}\n\n/** Save the path on Enter and trigger the Send button after the update resolves */\nconst handlePathSubmit = (\n  newPath: string,\n  event: KeyboardEvent | FocusEvent,\n): void => {\n  // Prevent the global hotkey listener from also handling this Enter press\n  event.stopPropagation()\n\n  emitPathMethodUpdate(\n    methodConflict.value ?? method,\n    newPath,\n    '[data-addressbar-action=\"send\"]',\n  )\n}\n\n/** Unset the server when backspace is pressed on an empty path */\nconst handlePathBackspace = (event: KeyboardEvent): void => {\n  if (event.target instanceof HTMLElement && event.target.innerText === '\\n') {\n    // A webhook has no server to unset; its full URL lives in the field itself.\n    if (isWebhook) {\n      return\n    }\n    eventBus.emit('server:update:selected', { url: '', meta: serverMeta })\n  }\n}\n\nconst handleServerSelect = (\n  payload: ApiReferenceEvents['server:update:selected'],\n): void => {\n  eventBus.emit('server:update:selected', payload)\n}\n\nconst handleServerVariable = (\n  payload: ApiReferenceEvents['server:update:variables'],\n): void => {\n  eventBus.emit('server:update:variables', payload)\n}\n\n/** Address bar copy is handled in OperationBlock (same URL as Send). */\nconst requestCopyUrl = (): void => {\n  eventBus.emit('copy-url:address-bar')\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Navigation\n// ───────────────────────────────────────────────────────────────────\n\nconst navigateToServersPage = (): void => {\n  if (serverMeta.type === 'operation') {\n    eventBus.emit('ui:navigate', {\n      page: 'operation',\n      path: 'servers',\n      operationPath: serverMeta.path,\n      method: serverMeta.method,\n    })\n    return\n  }\n\n  eventBus.emit('ui:navigate', { page: 'document', path: 'servers' })\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Lifecycle\n// ───────────────────────────────────────────────────────────────────\n\nconst unsubscribes: Array<() => void> = []\n\nonMounted(() => {\n  unsubscribes.push(\n    eventBus.on('ui:focus:address-bar', handleFocusAddressBar),\n    eventBus.on('ui:focus:send-button', handleFocusSendButton),\n    eventBus.on('hooks:on:request:sent', startLoading),\n    eventBus.on('hooks:on:request:complete', stopLoading),\n  )\n})\n\nonBeforeUnmount(() => {\n  for (const unsubscribe of unsubscribes) {\n    unsubscribe()\n  }\n\n  // Prevents the loading animation from continuing after unmount\n  stopLoading()\n})\n\ndefineExpose({\n  methodConflict,\n  pathConflict,\n})\n</script>\n<template>\n  <!--\n    Address bar.\n\n    The wide-container layout matches the original single-row bar:\n    `[Method | URL | Copy | History | Send]`. When the surrounding\n    `@container` drops below `@3xl` the bar collapses to\n    `[URL | History]` and a second row appears beneath it with a\n    duplicate `Method`, `Copy`, and `Send` so the URL gets the full\n    container width while every action stays on the same line as the\n    send button.\n  -->\n  <div\n    class=\"order-last flex h-auto w-full max-w-3xl grow-3 flex-wrap items-stretch [--scalar-address-bar-height:32px] @3xl:order-0 @3xl:flex-nowrap\">\n    <!-- Address Bar -->\n    <div\n      :id=\"id\"\n      class=\"address-bar-bg-states text-xxs group relative flex h-(--scalar-address-bar-height) w-full flex-1 flex-row items-stretch rounded-lg p-0.75\"\n      :class=\"{\n        'outline-c-danger outline': hasConflict,\n        'rounded-b-none': isDropdownOpen,\n      }\">\n      <div\n        class=\"pointer-events-none absolute top-0 left-0 block h-full w-full overflow-hidden rounded-lg border\"\n        :class=\"{\n          'rounded-b-none': isDropdownOpen,\n        }\">\n        <div\n          class=\"absolute top-0 left-0 h-full w-full\"\n          :style />\n      </div>\n\n      <!--\n        Method, Copy, and Send are hidden in mobile mode (container\n        narrower than `@3xl`) and the duplicate buttons in the trailing\n        mobile actions row take over at that point.\n      -->\n      <div class=\"hidden @3xl:flex\">\n        <HttpMethod\n          :isEditable=\"layout !== 'modal' && !isWebhook\"\n          isSquare\n          :method=\"methodConflict ?? method\"\n          teleport\n          @change=\"handleMethodChange\" />\n      </div>\n\n      <div\n        class=\"scroll-timeline-x scroll-timeline-x-hidden relative flex w-full bg-blend-normal\"\n        dir=\"ltr\">\n        <!-- Servers -->\n        <ServerDropdown\n          v-if=\"servers.length\"\n          :layout=\"isWebhook ? 'modal' : layout\"\n          :meta=\"serverMeta\"\n          :server=\"server\"\n          :servers=\"servers\"\n          :target=\"id\"\n          @update:open=\"(value) => (isServerDropdownOpen = value)\"\n          @update:selectedServer=\"handleServerSelect\"\n          @update:servers=\"navigateToServersPage\"\n          @update:variable=\"handleServerVariable\" />\n\n        <!-- Path + URL + env vars -->\n        <CodeInput\n          ref=\"addressBarRef\"\n          alwaysEmitChange\n          :aria-label=\"translate('apiClient.addressBar.path')\"\n          class=\"ml-1 min-w-fit pl-px outline-none\"\n          disableCloseBrackets\n          :disabled=\"layout === 'modal' && !isWebhook\"\n          disableEnter\n          disableTabIndent\n          :emitOnBlur=\"false\"\n          :environment=\"environment\"\n          :extensions=\"[addressBarScrollMargins]\"\n          importCurl\n          :layout=\"layout\"\n          :modelValue=\"path\"\n          :placeholder=\"pathPlaceholder\"\n          server\n          @blur=\"handlePathBlur\"\n          @keydown.delete=\"handlePathBackspace\"\n          @keydown.tab=\"tabbedOut = true\"\n          @submit=\"handlePathSubmit\" />\n      </div>\n\n      <!-- Copy url button -->\n      <ScalarButton\n        class=\"hover:bg-b-3 mx-1 hidden @3xl:flex\"\n        size=\"xs\"\n        variant=\"ghost\"\n        @click=\"requestCopyUrl\">\n        <ScalarIconCopy />\n        <span class=\"sr-only\">{{\n          translate('apiClient.addressBar.copyUrl')\n        }}</span>\n      </ScalarButton>\n\n      <AddressBarHistory\n        :history=\"history\"\n        :target=\"id\"\n        @select:history:item=\"(payload) => emit('select:history:item', payload)\"\n        @update:open=\"(value) => (isHistoryDropdownOpen = value)\" />\n      <!-- Error message -->\n      <div\n        v-if=\"hasConflict\"\n        class=\"z-context absolute inset-x-0 top-[calc(100%+4px)] flex flex-col items-center rounded px-6\">\n        <div\n          class=\"text-c-danger bg-b-danger border-c-danger flex items-center gap-1 rounded border p-1\">\n          <ScalarIconWarningCircle size=\"sm\" />\n          <div class=\"min-w-0 flex-1\">\n            {{\n              translate('apiClient.addressBar.duplicateRequest', {\n                method: (methodConflict ?? method).toUpperCase(),\n                path: pathConflict ?? path,\n              })\n            }}\n          </div>\n        </div>\n      </div>\n\n      <ScalarButton\n        ref=\"sendButtonRef\"\n        class=\"relative hidden h-auto shrink-0 overflow-hidden py-1 pr-2.5 pl-2 font-bold @3xl:flex\"\n        data-addressbar-action=\"send\"\n        :disabled=\"isLoading || executionDisabled\"\n        @click=\"emit('execute')\">\n        <span\n          aria-hidden=\"true\"\n          class=\"inline-flex items-center gap-1\">\n          <ScalarIcon\n            class=\"relative shrink-0 fill-current\"\n            icon=\"Play\"\n            size=\"xs\" />\n          <span class=\"text-xxs flex\">{{\n            translate('apiClient.addressBar.send')\n          }}</span>\n        </span>\n        <span class=\"sr-only\"\n          >{{\n            translate('apiClient.addressBar.sendRequest', {\n              method,\n              url: `${server?.url ?? ''}${path}`,\n            })\n          }}\n        </span>\n      </ScalarButton>\n    </div>\n\n    <!--\n      Mobile actions row. Visible by default and hidden once the\n      container reaches `@3xl`, where the duplicate Method / Copy /\n      Send buttons move back into the bar itself.\n    -->\n    <div\n      class=\"mt-2 flex h-(--scalar-address-bar-height) w-full items-stretch gap-1 @3xl:hidden\">\n      <HttpMethod\n        :isEditable=\"layout !== 'modal' && !isWebhook\"\n        isSquare\n        :method=\"methodConflict ?? method\"\n        teleport\n        @change=\"handleMethodChange\" />\n      <ScalarButton\n        class=\"hover:bg-b-3 ml-auto\"\n        size=\"xs\"\n        variant=\"ghost\"\n        @click=\"requestCopyUrl\">\n        <ScalarIconCopy />\n        <span class=\"sr-only\">{{\n          translate('apiClient.addressBar.copyUrl')\n        }}</span>\n      </ScalarButton>\n      <ScalarButton\n        ref=\"mobileSendButtonRef\"\n        class=\"relative h-auto shrink-0 overflow-hidden py-1 pr-2.5 pl-2 font-bold\"\n        data-addressbar-action=\"send\"\n        :disabled=\"isLoading || executionDisabled\"\n        @click=\"emit('execute')\">\n        <span\n          aria-hidden=\"true\"\n          class=\"inline-flex items-center gap-1\">\n          <ScalarIcon\n            class=\"relative shrink-0 fill-current\"\n            icon=\"Play\"\n            size=\"xs\" />\n          <span class=\"text-xxs\">{{\n            translate('apiClient.addressBar.send')\n          }}</span>\n        </span>\n        <span class=\"sr-only\"\n          >{{\n            translate('apiClient.addressBar.sendRequest', {\n              method,\n              url: `${server?.url ?? ''}${path}`,\n            })\n          }}\n        </span>\n      </ScalarButton>\n    </div>\n  </div>\n</template>\n<style scoped>\n:deep(.cm-editor) {\n  height: 100%;\n  outline: none;\n  width: 100%;\n}\n:deep(.cm-line) {\n  padding: 0;\n}\n:deep(.cm-content) {\n  padding: 0;\n  display: flex;\n  align-items: center;\n  font-size: var(--scalar-small);\n}\n.scroll-timeline-x {\n  -ms-overflow-style: none;\n  /* Fade the URL at the viewport edges. Mask lives on the scrollport (this\n     element) rather than on `.cm-scroller`, whose width follows the URL's\n     full content and pushes the right edge off-screen when overflowing. */\n  mask-image: linear-gradient(\n    to right,\n    transparent 0,\n    black 6px,\n    black calc(100% - 24px),\n    transparent 100%\n  );\n}\n.scroll-timeline-x-hidden {\n  overflow-x: auto;\n}\n.scroll-timeline-x-hidden :deep(.cm-scroller) {\n  scrollbar-width: none;\n  -ms-overflow-style: none;\n  padding-right: 20px;\n  overflow: auto;\n}\n.scroll-timeline-x-hidden::-webkit-scrollbar {\n  width: 0;\n  height: 0;\n  display: none;\n}\n.scroll-timeline-x-hidden :deep(.cm-scroller::-webkit-scrollbar) {\n  width: 0;\n  height: 0;\n  display: none;\n}\n.scroll-timeline-x-address {\n  line-height: 27px;\n  scrollbar-width: none; /* Firefox */\n}\n/* make clickable are to left of send button */\n.scroll-timeline-x-address:after {\n  content: '';\n  position: absolute;\n  height: 100%;\n  width: 24px;\n  right: 0;\n  cursor: text;\n}\n\n.address-bar-bg-states {\n  --scalar-address-bar-bg: color-mix(\n    in srgb,\n    var(--scalar-background-1),\n    var(--scalar-background-2)\n  );\n  background: var(--scalar-address-bar-bg);\n}\n.address-bar-bg-states:has(.cm-focused) {\n  --scalar-address-bar-bg: var(--scalar-background-1);\n  border-color: var(--scalar-border-color);\n  outline-width: 1px;\n  outline-style: solid;\n}\n.address-bar-bg-states:has(.cm-focused) .fade-left,\n.address-bar-bg-states:has(.cm-focused) .fade-right {\n  --scalar-address-bar-bg: var(--scalar-background-1);\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"AddressBar.vue.js","names":[],"sources":["../../../../../src/v2/blocks/scalar-address-bar-block/components/AddressBar.vue"],"sourcesContent":["<script lang=\"ts\">\n/**\n * AddressBar component\n * This component is used to display the address bar for the operation block\n * It is used to display the path, method, server, and history for the operation\n */\nexport default {\n  name: 'AddressBar',\n}\nexport type AddressBarProps = {\n  /** An external example must finish loading before sending. */\n  executionDisabled?: boolean\n  /** Current request path */\n  path: string\n  /** Current request method */\n  method: string\n  /** Whether the request target belongs to an OpenAPI webhook. */\n  isWebhook?: boolean\n  /** Openapi document slug */\n  documentSlug: string\n  /** Currently selected example key for the current operation */\n  exampleKey: string\n  /** Currently selected server */\n  server: ServerObject | null\n  /** Server list available for operation/document */\n  servers: ServerObject[]\n  /** List of request history */\n  history: History[]\n  /** Client layout */\n  layout: ClientLayout\n  /** Event bus */\n  eventBus: WorkspaceEventBus\n  /** Environment */\n  environment: XScalarEnvironment\n  /** Meta information for the server */\n  serverMeta: ServerMeta\n}\n</script>\n<script setup lang=\"ts\">\nimport { ScalarButton } from '@scalar/components/button'\nimport { ScalarIcon } from '@scalar/components/icon'\nimport { getSelector } from '@scalar/helpers/dom/get-selector'\nimport { getHttpMethodInfo } from '@scalar/helpers/http/http-info'\nimport { extractServerFromPath } from '@scalar/helpers/url/extract-server-from-path'\nimport { ScalarIconCopy, ScalarIconWarningCircle } from '@scalar/icons'\nimport { EditorView } from '@scalar/use-codemirror'\nimport type {\n  ApiReferenceEvents,\n  ServerMeta,\n  WorkspaceEventBus,\n} from '@scalar/workspace-store/events'\nimport type { XScalarEnvironment } from '@scalar/workspace-store/schemas/extensions/document/x-scalar-environments'\nimport type { ServerObject } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document'\nimport {\n  computed,\n  nextTick,\n  onBeforeUnmount,\n  onMounted,\n  ref,\n  useId,\n  useTemplateRef,\n  watch,\n} from 'vue'\n\nimport { HttpMethod } from '@/components/HttpMethod'\nimport { getOperationExampleKey } from '@/v2/blocks/operation-block/helpers/response-cache'\nimport { isPlaceholderPath } from '@/v2/blocks/scalar-address-bar-block/helpers/is-placeholder-path'\nimport { refocusBlurTarget } from '@/v2/blocks/scalar-address-bar-block/helpers/refocus-blur-target'\nimport { useLoadingAnimation } from '@/v2/blocks/scalar-address-bar-block/hooks/use-loading-animation'\nimport { usePathMasking } from '@/v2/blocks/scalar-address-bar-block/hooks/use-path-masking'\nimport { CodeInput } from '@/v2/components/code-input'\nimport { ServerDropdown } from '@/v2/components/server'\nimport { useLocalization } from '@/v2/features/localization'\nimport type { ClientLayout } from '@/v2/types/layout'\n\nimport AddressBarHistory, { type History } from './AddressBarHistory.vue'\n\nconst {\n  path,\n  method,\n  layout,\n  eventBus,\n  exampleKey,\n  documentSlug,\n  server,\n  servers,\n  environment,\n  serverMeta,\n  isWebhook = false,\n} = defineProps<AddressBarProps>()\n\nconst emit = defineEmits<{\n  /** Execute the current operation example */\n  (e: 'execute'): void\n  /** Select a request history item by index */\n  (e: 'select:history:item', payload: { index: number }): void\n  /** Update the full destination URL used to deliver a webhook. */\n  (e: 'update:webhook-url', url: string): void\n}>()\n\nconst { translate } = useLocalization()\n\n// ───────────────────────────────────────────────────────────────────\n// Template refs & reactive state\n// ───────────────────────────────────────────────────────────────────\n\nconst id = useId()\nconst sendButtonRef = useTemplateRef('sendButtonRef')\nconst mobileSendButtonRef = useTemplateRef('mobileSendButtonRef')\nconst addressBarRef = useTemplateRef('addressBarRef')\n\nconst { percentage, startLoading, stopLoading, isLoading } =\n  useLoadingAnimation()\n\nconst pathConflict = ref<string | null>(null)\nconst methodConflict = ref<string | null>(null)\nconst tabbedOut = ref(false)\nconst isServerDropdownOpen = ref(false)\nconst isHistoryDropdownOpen = ref(false)\n\n// ───────────────────────────────────────────────────────────────────\n// Derived state\n// ───────────────────────────────────────────────────────────────────\n\n/** Keeps the cursor visible past the fade-right overlay while typing */\nconst addressBarScrollMargins = EditorView.scrollMargins.of(() => ({\n  right: 24,\n}))\n\n/** Animated background transform for the loading indicator */\nconst style = computed(() => ({\n  backgroundColor: `color-mix(in srgb, transparent 90%, ${getHttpMethodInfo(method).colorVar})`,\n  transform: `translate3d(-${percentage.value}%,0,0)`,\n}))\n\n/** Whether there is a path or method conflict */\nconst hasConflict = computed(() => methodConflict.value || pathConflict.value)\n\n/**\n * Placeholder for the path field.\n *\n * Webhooks have no server to prefix the path, so the field doubles as the full\n * destination URL. Hint that a complete URL (including the host) is expected,\n * rather than a bare path.\n */\nconst pathPlaceholder = computed(() => {\n  if (server) {\n    return ''\n  }\n  return isWebhook\n    ? translate('apiClient.addressBar.webhookUrlPlaceholder')\n    : translate('apiClient.addressBar.urlPlaceholder')\n})\n\n/** Whether either dropdown (server or history) is open */\nconst isDropdownOpen = computed(\n  () => isServerDropdownOpen.value || isHistoryDropdownOpen.value,\n)\n\n/** Uniquely identifies the currently selected operation + example */\nconst uniqueKey = computed(() =>\n  getOperationExampleKey(method, path, exampleKey, documentSlug),\n)\n\n/** Clear conflict state when switching to a different operation */\nwatch(uniqueKey, () => {\n  pathConflict.value = null\n  methodConflict.value = null\n})\n\n// ───────────────────────────────────────────────────────────────────\n// Focus helpers\n// ───────────────────────────────────────────────────────────────────\n\nconst handleFocusSendButton = (): void => {\n  const desktop = sendButtonRef.value?.$el\n  const mobile = mobileSendButtonRef.value?.$el\n\n  // Focus whichever send button is currently visible\n  if (desktop && desktop.offsetParent !== null) {\n    desktop.focus()\n  } else {\n    mobile?.focus()\n  }\n}\n\nconst handleFocusAddressBar = (\n  payload: ApiReferenceEvents['ui:focus:address-bar'],\n): void => {\n  // On non-desktop layouts, if already focused we let the browser handle the\n  // native behavior (e.g. selecting the browser's own address bar).\n  if (addressBarRef.value?.isFocused && layout !== 'desktop') {\n    return\n  }\n\n  addressBarRef.value?.focus('end')\n\n  if (payload && 'clear' in payload && payload.clear) {\n    addressBarRef.value?.setCodeMirrorContent('')\n  }\n\n  if (payload && 'event' in payload) {\n    payload.event.preventDefault()\n  }\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Path masking\n//\n// Drafts on `/` and auto-generated `/_scalar_temp...` paths are internal\n// placeholders — the address bar focuses and clears on mount and on\n// navigation so the user sees a blank prompt instead of the internal\n// path. The deferred mask only clears when CodeMirror still contains that\n// placeholder path, so a user edit that lands before the frame is preserved.\n// ───────────────────────────────────────────────────────────────────\n\nusePathMasking({\n  isReady: () => addressBarRef.value?.codeMirror,\n  operationKey: () => uniqueKey.value,\n  shouldMask: () => isPlaceholderPath(path, documentSlug),\n  // Defer to the next frame so focus() runs after click-handler side\n  // effects that move focus (e.g. a dropdown refocusing its trigger),\n  // which would otherwise blur our input and emit a spurious path\n  // update against the now-empty value.\n  onMask: () =>\n    requestAnimationFrame(() => {\n      const editorContent =\n        addressBarRef.value?.codeMirror?.state.doc.toString()\n\n      if (editorContent && editorContent !== path) {\n        return\n      }\n\n      handleFocusAddressBar({ clear: true })\n    }),\n})\n\n// ───────────────────────────────────────────────────────────────────\n// Server extraction\n// ───────────────────────────────────────────────────────────────────\n\n/** If the path contains a server URL, extract it and select or add that server */\nconst extractAndSelectServer = (targetPath: string): string => {\n  const extracted = extractServerFromPath(targetPath)\n  if (!extracted) {\n    return targetPath\n  }\n\n  const [url, remainingPath] = extracted\n\n  // Server is already selected — nothing to do\n  if (url === server?.url) {\n    return remainingPath\n  }\n\n  const matchingServer = servers.find((s) => s.url === url)\n  if (matchingServer) {\n    eventBus.emit('server:update:selected', { url, meta: serverMeta })\n  } else {\n    eventBus.emit('server:add:server', {\n      url,\n      select: true,\n      meta: { type: 'operation', path, method },\n    })\n  }\n\n  return remainingPath\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Path / method updates\n// ───────────────────────────────────────────────────────────────────\n\nconst normalizePath = (value: string): string =>\n  value.startsWith('/') ? value : `/${value}`\n\n/** Emit a path/method update and reconcile conflicts + cursor state on the result */\nconst emitPathMethodUpdate = (\n  targetMethod: string,\n  targetPath: string,\n  blurTargetSelector: string | null = null,\n): void => {\n  if (isWebhook) {\n    // A webhook has no OpenAPI server, so the field holds the full destination\n    // URL. Keep exactly what the user entered — do not split it into an invisible\n    // server plus a leftover path, and do not force a leading slash. That split\n    // is what made a typed URL collapse to a stray \"/\" on blur.\n    const webhookUrl = targetPath.trim()\n    addressBarRef.value?.setCodeMirrorContent(webhookUrl)\n    emit('update:webhook-url', webhookUrl)\n    methodConflict.value = null\n    pathConflict.value = null\n    nextTick(() => refocusBlurTarget(blurTargetSelector))\n    return\n  }\n\n  const extractedPath = extractAndSelectServer(targetPath)\n  const normalizedPath = normalizePath(extractedPath)\n\n  // Keep CodeMirror in sync so a conflict does not leave a stale value on screen\n  addressBarRef.value?.setCodeMirrorContent(normalizedPath)\n\n  eventBus.emit('operation:update:pathMethod', {\n    meta: { method, path },\n    blurTargetSelector,\n    payload: { method: targetMethod, path: normalizedPath },\n    callback: (status, returnedSelector) => {\n      if (status === 'success' || status === 'no-change') {\n        methodConflict.value = null\n        pathConflict.value = null\n      } else if (status === 'conflict') {\n        if (targetMethod !== method) {\n          methodConflict.value = targetMethod\n        }\n        if (normalizedPath !== path) {\n          pathConflict.value = normalizedPath\n        }\n\n        return\n      }\n\n      // Edge case: pasting a full URL extracts the server but leaves the path\n      // unchanged. CodeMirror still shows the full URL, so force it back to\n      // just the path.\n      const mirrorContent = addressBarRef.value?.codeMirrorRef?.textContent\n      if (\n        status === 'no-change' &&\n        mirrorContent &&\n        mirrorContent !== extractedPath\n      ) {\n        addressBarRef.value?.setCodeMirrorContent(extractedPath)\n      }\n\n      nextTick(() => refocusBlurTarget(returnedSelector))\n    },\n  })\n}\n\n/** Change the operation's method, preferring the conflicting path if present */\nconst handleMethodChange = (newMethod: string): void =>\n  emitPathMethodUpdate(newMethod, pathConflict.value ?? path)\n\n/**\n * Save the path on blur and replay the click that caused the blur (so e.g. a\n * click on the Send button still fires after the async update resolves).\n *\n * Tab-outs do not replay — tabbing to a button should not trigger its click\n * (`tabbedOut` is set on `@keydown.tab`).\n *\n * Programmatic focus moves also do not replay. On first navigation into a\n * draft operation, `usePathMasking` focuses and clears the address bar while\n * `ScalarSidebarNestedItems` focuses the drilled-in Back button in\n * `nextTick`. That steals focus from CodeMirror, fires blur with a\n * `relatedTarget` (the Back button), and without a guard we would treat it\n * like a user click: capture the selector, then `refocusBlurTarget` would\n * synthesize `.click()` on Back and navigate away.\n *\n * `FocusEvent.sourceCapabilities` is null when no input device caused the\n * focus change (e.g. `element.focus()`). A real pointer click sets it on the\n * blur that precedes the click, so we still replay Send and other buttons.\n */\nconst handlePathBlur = (newPath: string, event: FocusEvent): void => {\n  const relatedTarget =\n    event.relatedTarget instanceof Element ? event.relatedTarget : null\n  const blurTargetSelector =\n    tabbedOut.value ||\n    ('sourceCapabilities' in event && event.sourceCapabilities === null)\n      ? null\n      : getSelector(relatedTarget)\n  tabbedOut.value = false\n\n  emitPathMethodUpdate(\n    methodConflict.value ?? method,\n    newPath,\n    blurTargetSelector,\n  )\n}\n\n/** Save the path on Enter and trigger the Send button after the update resolves */\nconst handlePathSubmit = (\n  newPath: string,\n  event: KeyboardEvent | FocusEvent,\n): void => {\n  // Prevent the global hotkey listener from also handling this Enter press\n  event.stopPropagation()\n\n  emitPathMethodUpdate(\n    methodConflict.value ?? method,\n    newPath,\n    '[data-addressbar-action=\"send\"]',\n  )\n}\n\n/** Unset the server when backspace is pressed on an empty path */\nconst handlePathBackspace = (event: KeyboardEvent): void => {\n  if (event.target instanceof HTMLElement && event.target.innerText === '\\n') {\n    // A webhook has no server to unset; its full URL lives in the field itself.\n    if (isWebhook) {\n      return\n    }\n    eventBus.emit('server:update:selected', { url: '', meta: serverMeta })\n  }\n}\n\nconst handleServerSelect = (\n  payload: ApiReferenceEvents['server:update:selected'],\n): void => {\n  eventBus.emit('server:update:selected', payload)\n}\n\nconst handleServerVariable = (\n  payload: ApiReferenceEvents['server:update:variables'],\n): void => {\n  eventBus.emit('server:update:variables', payload)\n}\n\n/** Address bar copy is handled in OperationBlock (same URL as Send). */\nconst requestCopyUrl = (): void => {\n  eventBus.emit('copy-url:address-bar')\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Navigation\n// ───────────────────────────────────────────────────────────────────\n\nconst navigateToServersPage = (): void => {\n  if (serverMeta.type === 'operation') {\n    eventBus.emit('ui:navigate', {\n      page: 'operation',\n      path: 'servers',\n      operationPath: serverMeta.path,\n      method: serverMeta.method,\n    })\n    return\n  }\n\n  eventBus.emit('ui:navigate', { page: 'document', path: 'servers' })\n}\n\n// ───────────────────────────────────────────────────────────────────\n// Lifecycle\n// ───────────────────────────────────────────────────────────────────\n\nconst unsubscribes: Array<() => void> = []\n\nonMounted(() => {\n  unsubscribes.push(\n    eventBus.on('ui:focus:address-bar', handleFocusAddressBar),\n    eventBus.on('ui:focus:send-button', handleFocusSendButton),\n    eventBus.on('hooks:on:request:sent', startLoading),\n    eventBus.on('hooks:on:request:complete', stopLoading),\n  )\n})\n\nonBeforeUnmount(() => {\n  for (const unsubscribe of unsubscribes) {\n    unsubscribe()\n  }\n\n  // Prevents the loading animation from continuing after unmount\n  stopLoading()\n})\n\ndefineExpose({\n  methodConflict,\n  pathConflict,\n})\n</script>\n<template>\n  <!--\n    Address bar.\n\n    The wide-container layout matches the original single-row bar:\n    `[Method | URL | Copy | History | Send]`. When the surrounding\n    `@container` drops below `@3xl` the bar collapses to\n    `[URL | History]` and a second row appears beneath it with a\n    duplicate `Method`, `Copy`, and `Send` so the URL gets the full\n    container width while every action stays on the same line as the\n    send button.\n  -->\n  <div\n    class=\"order-last flex h-auto w-full max-w-3xl grow-3 flex-wrap items-stretch [--scalar-address-bar-height:32px] @3xl:order-0 @3xl:flex-nowrap\">\n    <!-- Address Bar -->\n    <div\n      :id=\"id\"\n      class=\"address-bar-bg-states text-xxs group relative flex h-(--scalar-address-bar-height) w-full flex-1 flex-row items-stretch rounded-lg p-0.75\"\n      :class=\"{\n        'outline-c-danger outline': hasConflict,\n        'rounded-b-none': isDropdownOpen,\n      }\">\n      <div\n        class=\"pointer-events-none absolute top-0 left-0 block h-full w-full overflow-hidden rounded-lg border\"\n        :class=\"{\n          'rounded-b-none': isDropdownOpen,\n        }\">\n        <div\n          class=\"absolute top-0 left-0 h-full w-full\"\n          :style />\n      </div>\n\n      <!--\n        Method, Copy, and Send are hidden in mobile mode (container\n        narrower than `@3xl`) and the duplicate buttons in the trailing\n        mobile actions row take over at that point.\n      -->\n      <div class=\"hidden @3xl:flex\">\n        <HttpMethod\n          :isEditable=\"layout !== 'modal' && !isWebhook\"\n          isSquare\n          :method=\"methodConflict ?? method\"\n          teleport\n          @change=\"handleMethodChange\" />\n      </div>\n\n      <div\n        class=\"scroll-timeline-x scroll-timeline-x-hidden relative flex w-full bg-blend-normal\"\n        dir=\"ltr\">\n        <!-- Servers -->\n        <ServerDropdown\n          v-if=\"servers.length\"\n          :layout=\"isWebhook ? 'modal' : layout\"\n          :meta=\"serverMeta\"\n          :server=\"server\"\n          :servers=\"servers\"\n          :target=\"id\"\n          @update:open=\"(value) => (isServerDropdownOpen = value)\"\n          @update:selectedServer=\"handleServerSelect\"\n          @update:servers=\"navigateToServersPage\"\n          @update:variable=\"handleServerVariable\" />\n\n        <!-- Path + URL + env vars -->\n        <CodeInput\n          ref=\"addressBarRef\"\n          alwaysEmitChange\n          :aria-label=\"translate('apiClient.addressBar.path')\"\n          class=\"ml-1 min-w-fit pl-px outline-none\"\n          disableCloseBrackets\n          :disabled=\"layout === 'modal' && !isWebhook\"\n          disableEnter\n          disableTabIndent\n          :emitOnBlur=\"false\"\n          :environment=\"environment\"\n          :extensions=\"[addressBarScrollMargins]\"\n          importCurl\n          :layout=\"layout\"\n          :modelValue=\"path\"\n          :placeholder=\"pathPlaceholder\"\n          server\n          @blur=\"handlePathBlur\"\n          @keydown.delete=\"handlePathBackspace\"\n          @keydown.tab=\"tabbedOut = true\"\n          @submit=\"handlePathSubmit\" />\n      </div>\n\n      <!-- Copy url button -->\n      <ScalarButton\n        class=\"hover:bg-b-3 mx-1 hidden @3xl:flex\"\n        size=\"xs\"\n        variant=\"ghost\"\n        @click=\"requestCopyUrl\">\n        <ScalarIconCopy />\n        <span class=\"sr-only\">{{\n          translate('apiClient.addressBar.copyUrl')\n        }}</span>\n      </ScalarButton>\n\n      <AddressBarHistory\n        :history=\"history\"\n        :target=\"id\"\n        @select:history:item=\"(payload) => emit('select:history:item', payload)\"\n        @update:open=\"(value) => (isHistoryDropdownOpen = value)\" />\n      <!-- Error message -->\n      <div\n        v-if=\"hasConflict\"\n        class=\"z-context absolute inset-x-0 top-[calc(100%+4px)] flex flex-col items-center rounded px-6\">\n        <div\n          class=\"text-c-danger bg-b-danger border-c-danger flex items-center gap-1 rounded border p-1\">\n          <ScalarIconWarningCircle size=\"sm\" />\n          <div class=\"min-w-0 flex-1\">\n            {{\n              translate('apiClient.addressBar.duplicateRequest', {\n                method: (methodConflict ?? method).toUpperCase(),\n                path: pathConflict ?? path,\n              })\n            }}\n          </div>\n        </div>\n      </div>\n\n      <ScalarButton\n        ref=\"sendButtonRef\"\n        class=\"relative hidden h-auto shrink-0 overflow-hidden py-1 pr-2.5 pl-2 font-bold @3xl:flex\"\n        data-addressbar-action=\"send\"\n        :disabled=\"isLoading || executionDisabled\"\n        @click=\"emit('execute')\">\n        <span\n          aria-hidden=\"true\"\n          class=\"inline-flex items-center gap-1\">\n          <ScalarIcon\n            class=\"relative shrink-0 fill-current\"\n            icon=\"Play\"\n            size=\"xs\" />\n          <span class=\"text-xxs flex\">{{\n            translate('apiClient.addressBar.send')\n          }}</span>\n        </span>\n        <span class=\"sr-only\"\n          >{{\n            translate('apiClient.addressBar.sendRequest', {\n              method,\n              url: `${server?.url ?? ''}${path}`,\n            })\n          }}\n        </span>\n      </ScalarButton>\n    </div>\n\n    <!--\n      Mobile actions row. Visible by default and hidden once the\n      container reaches `@3xl`, where the duplicate Method / Copy /\n      Send buttons move back into the bar itself.\n    -->\n    <div\n      class=\"mt-2 flex h-(--scalar-address-bar-height) w-full items-stretch gap-1 @3xl:hidden\">\n      <HttpMethod\n        :isEditable=\"layout !== 'modal' && !isWebhook\"\n        isSquare\n        :method=\"methodConflict ?? method\"\n        teleport\n        @change=\"handleMethodChange\" />\n      <ScalarButton\n        class=\"hover:bg-b-3 ml-auto\"\n        size=\"xs\"\n        variant=\"ghost\"\n        @click=\"requestCopyUrl\">\n        <ScalarIconCopy />\n        <span class=\"sr-only\">{{\n          translate('apiClient.addressBar.copyUrl')\n        }}</span>\n      </ScalarButton>\n      <ScalarButton\n        ref=\"mobileSendButtonRef\"\n        class=\"relative h-auto shrink-0 overflow-hidden py-1 pr-2.5 pl-2 font-bold\"\n        data-addressbar-action=\"send\"\n        :disabled=\"isLoading || executionDisabled\"\n        @click=\"emit('execute')\">\n        <span\n          aria-hidden=\"true\"\n          class=\"inline-flex items-center gap-1\">\n          <ScalarIcon\n            class=\"relative shrink-0 fill-current\"\n            icon=\"Play\"\n            size=\"xs\" />\n          <span class=\"text-xxs\">{{\n            translate('apiClient.addressBar.send')\n          }}</span>\n        </span>\n        <span class=\"sr-only\"\n          >{{\n            translate('apiClient.addressBar.sendRequest', {\n              method,\n              url: `${server?.url ?? ''}${path}`,\n            })\n          }}\n        </span>\n      </ScalarButton>\n    </div>\n  </div>\n</template>\n<style scoped>\n:deep(.cm-editor) {\n  height: 100%;\n  outline: none;\n  width: 100%;\n}\n:deep(.cm-line) {\n  padding: 0;\n}\n:deep(.cm-content) {\n  padding: 0;\n  display: flex;\n  align-items: center;\n  font-size: var(--scalar-small);\n}\n.scroll-timeline-x {\n  -ms-overflow-style: none;\n  /* Fade the URL at the viewport edges. Mask lives on the scrollport (this\n     element) rather than on `.cm-scroller`, whose width follows the URL's\n     full content and pushes the right edge off-screen when overflowing. */\n  mask-image: linear-gradient(\n    to right,\n    transparent 0,\n    black 6px,\n    black calc(100% - 24px),\n    transparent 100%\n  );\n}\n.scroll-timeline-x-hidden {\n  overflow-x: auto;\n}\n.scroll-timeline-x-hidden :deep(.cm-scroller) {\n  scrollbar-width: none;\n  -ms-overflow-style: none;\n  padding-right: 20px;\n  overflow: auto;\n}\n.scroll-timeline-x-hidden::-webkit-scrollbar {\n  width: 0;\n  height: 0;\n  display: none;\n}\n.scroll-timeline-x-hidden :deep(.cm-scroller::-webkit-scrollbar) {\n  width: 0;\n  height: 0;\n  display: none;\n}\n.scroll-timeline-x-address {\n  line-height: 27px;\n  scrollbar-width: none; /* Firefox */\n}\n/* make clickable are to left of send button */\n.scroll-timeline-x-address:after {\n  content: '';\n  position: absolute;\n  height: 100%;\n  width: 24px;\n  right: 0;\n  cursor: text;\n}\n\n.address-bar-bg-states {\n  --scalar-address-bar-bg: color-mix(\n    in srgb,\n    var(--scalar-background-1),\n    var(--scalar-background-2)\n  );\n  background: var(--scalar-address-bar-bg);\n}\n.address-bar-bg-states:has(.cm-focused) {\n  --scalar-address-bar-bg: var(--scalar-background-1);\n  border-color: var(--scalar-border-color);\n  outline-width: 1px;\n  outline-style: solid;\n}\n.address-bar-bg-states:has(.cm-focused) .fade-left,\n.address-bar-bg-states:has(.cm-focused) .fade-right {\n  --scalar-address-bar-bg: var(--scalar-background-1);\n}\n</style>\n"],"mappings":""}

package/dist/v2/blocks/scalar-address-bar-block/components/AddressBar.vue.script.js

@@ -11,7 +11,7 @@ import AddressBarHistory_default from "./AddressBarHistory.vue.js";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, normalizeClass, normalizeStyle, onBeforeUnmount, onMounted, openBlock, ref, toDisplayString, unref, useId, useTemplateRef, watch, withCtx, withKeys } from "vue";
 import { ScalarButton } from "@scalar/components/button";
 import { ScalarIconCopy, ScalarIconWarningCircle } from "@scalar/icons";
-import { REQUEST_METHODS } from "@scalar/helpers/http/http-info";
+import { getHttpMethodInfo } from "@scalar/helpers/http/http-info";
 import { ScalarIcon } from "@scalar/components/icon";
 import { EditorView } from "@scalar/use-codemirror";
 import { getSelector } from "@scalar/helpers/dom/get-selector";
@@ -87,7 +87,7 @@ var AddressBar_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		const addressBarScrollMargins = EditorView.scrollMargins.of(() => ({ right: 24 }));
 		/** Animated background transform for the loading indicator */
 		const style = computed(() => ({
-			backgroundColor: `color-mix(in srgb, transparent 90%, ${REQUEST_METHODS[__props.method].colorVar})`,
+			backgroundColor: `color-mix(in srgb, transparent 90%, ${getHttpMethodInfo(__props.method).colorVar})`,
 			transform: `translate3d(-${percentage.value}%,0,0)`
 		}));
 		/** Whether there is a path or method conflict */