@scalar/openapi-to-markdown 0.5.44 → 1.0.0

package/dist/index.js

@@ -1,600 +1 @@
-import { isObject } from "@scalar/helpers/object/is-object";
-import { readFiles } from "@scalar/json-magic/bundle/plugins/node";
-import { normalize } from "@scalar/json-magic/helpers/normalize";
-import { createWorkspaceStore } from "@scalar/workspace-store/client";
-import { forEachPathItemOperation, getPathItemOperation, getResolvedPathItem } from "@scalar/workspace-store/helpers/for-each-path-item-operation";
-import { minify } from "html-minifier-terser";
-import rehypeParse from "rehype-parse";
-import rehypeRemark from "rehype-remark";
-import rehypeSanitize from "rehype-sanitize";
-import remarkGfm from "remark-gfm";
-import remarkStringify from "remark-stringify";
-import { unified } from "unified";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSSRApp, createTextVNode, createVNode, defineComponent, openBlock, renderList, resolveComponent, toDisplayString, unref } from "vue";
-import { renderToString } from "vue/server-renderer";
-import { ScalarMarkdown } from "@scalar/components/markdown";
-import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
-import { getExampleFromSchema } from "@scalar/workspace-store/request-example";
-import { resolve } from "@scalar/workspace-store/resolve";
-import { json2xml } from "@scalar/helpers/file/json2xml";
-//#region src/components/Schema.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$2 = { key: 0 };
-var _hoisted_2$2 = { key: 1 };
-var _hoisted_3$2 = { key: 0 };
-var _hoisted_4$2 = { key: 1 };
-var _hoisted_5$1 = { key: 2 };
-var _hoisted_6$1 = { key: 3 };
-var _hoisted_7$1 = { key: 4 };
-var _hoisted_8$1 = { key: 0 };
-var _hoisted_9$1 = { key: 0 };
-var _hoisted_10$1 = { key: 1 };
-var _hoisted_11$1 = { key: 2 };
-var _hoisted_12$1 = { key: 3 };
-var _hoisted_13$1 = { key: 1 };
-var _hoisted_14$1 = { key: 5 };
-var _hoisted_15$1 = { key: 0 };
-var _hoisted_16$1 = { key: 0 };
-var _hoisted_17$1 = { key: 1 };
-var _hoisted_18$1 = { key: 2 };
-var _hoisted_19$1 = { key: 6 };
-var _hoisted_20 = { key: 0 };
-var _hoisted_21 = { key: 1 };
-var _hoisted_22 = { key: 2 };
-var _hoisted_23 = { key: 3 };
-var MAX_DEPTH = 10;
-//#endregion
-//#region src/components/Schema.vue
-var Schema_default = /* @__PURE__ */ defineComponent({
-	__name: "Schema",
-	props: {
-		schema: {},
-		depth: { default: 0 }
-	},
-	setup(__props) {
-		const resolvedSchema = resolve.schema(__props.schema);
-		const resolveNestedSchema = (value) => resolve.schema(value);
-		const asObject = (value) => value !== null && typeof value === "object" ? value : void 0;
-		const getSchemaType = (value) => {
-			const schemaType = asObject(value)?.type;
-			if (typeof schemaType === "string") return schemaType;
-			if (Array.isArray(schemaType) && schemaType.every((entry) => typeof entry === "string")) return schemaType;
-		};
-		const getSchemaArray = (value, key) => {
-			const collection = asObject(value)?.[key];
-			if (!Array.isArray(collection)) return;
-			return collection.filter((entry) => entry !== null && typeof entry === "object");
-		};
-		const getSchemaNot = (value) => {
-			const notSchema = asObject(value)?.not;
-			return notSchema !== null && typeof notSchema === "object" ? notSchema : void 0;
-		};
-		const getSchemaProperties = (value) => {
-			const properties = asObject(value)?.properties;
-			if (!properties || typeof properties !== "object") return {};
-			return Object.entries(properties).reduce((acc, [name, prop]) => {
-				if (prop !== null && typeof prop === "object") acc[name] = prop;
-				return acc;
-			}, {});
-		};
-		const getSchemaRequired = (value) => {
-			const required = asObject(value)?.required;
-			if (!Array.isArray(required)) return [];
-			return required.filter((item) => typeof item === "string");
-		};
-		const getSchemaItems = (value) => {
-			const items = asObject(value)?.items;
-			return items !== null && typeof items === "object" ? items : void 0;
-		};
-		const getSchemaFormat = (value) => typeof asObject(value)?.format === "string" ? asObject(value)?.format : void 0;
-		const getSchemaEnum = (value) => {
-			const enumValues = asObject(value)?.enum;
-			return Array.isArray(enumValues) ? enumValues : void 0;
-		};
-		const getSchemaDefault = (value) => asObject(value)?.default;
-		const getSchemaDescription = (value) => typeof asObject(value)?.description === "string" ? asObject(value)?.description : void 0;
-		const getSchemaMinItems = (value) => typeof asObject(value)?.minItems === "number" ? asObject(value)?.minItems : void 0;
-		const getSchemaMaxItems = (value) => typeof asObject(value)?.maxItems === "number" ? asObject(value)?.maxItems : void 0;
-		const getSchemaUniqueItems = (value) => typeof asObject(value)?.uniqueItems === "boolean" ? asObject(value)?.uniqueItems : void 0;
-		const getResolvedSchemaType = (value) => getSchemaType(resolveNestedSchema(value));
-		const getResolvedSchemaFormat = (value) => getSchemaFormat(resolveNestedSchema(value));
-		const getResolvedSchemaEnum = (value) => getSchemaEnum(resolveNestedSchema(value));
-		const getResolvedSchemaDefault = (value) => getSchemaDefault(resolveNestedSchema(value));
-		const getResolvedSchemaDescription = (value) => getSchemaDescription(resolveNestedSchema(value));
-		const getResolvedSchemaProperties = (value) => getSchemaProperties(resolveNestedSchema(value));
-		const getResolvedSchemaItems = (value) => getSchemaItems(resolveNestedSchema(value));
-		const formatSchemaType = (value) => {
-			const schemaType = getResolvedSchemaType(value);
-			return Array.isArray(schemaType) ? schemaType.join(" | ") : schemaType || "object";
-		};
-		const formatEnumValues = (value) => value?.map((entry) => JSON.stringify(entry)).join(", ") || "";
-		const sortProperties = (properties, required) => {
-			const sorted = Object.entries(properties).sort(([a], [b]) => {
-				const aRequired = required?.includes(a);
-				const bRequired = required?.includes(b);
-				if (aRequired && !bRequired) return -1;
-				if (!aRequired && bRequired) return 1;
-				return a.localeCompare(b);
-			});
-			return Object.fromEntries(sorted);
-		};
-		return (_ctx, _cache) => {
-			const _component_Schema = resolveComponent("Schema", true);
-			return __props.depth >= MAX_DEPTH ? (openBlock(), createElementBlock("section", _hoisted_1$2, [..._cache[0] || (_cache[0] = [createElementVNode("p", null, [createElementVNode("em", null, "[Circular Reference]")], -1)])])) : unref(resolvedSchema) ? (openBlock(), createElementBlock("section", _hoisted_2$2, [getSchemaArray(unref(resolvedSchema), "allOf") ? (openBlock(), createElementBlock("section", _hoisted_3$2, [_cache[1] || (_cache[1] = createElementVNode("header", null, [createElementVNode("strong", null, "All of:")], -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(getSchemaArray(unref(resolvedSchema), "allOf"), (subSchema, index) => {
-				return openBlock(), createElementBlock("section", { key: index }, [createVNode(_component_Schema, {
-					schema: subSchema,
-					depth: __props.depth + 1
-				}, null, 8, ["schema", "depth"])]);
-			}), 128))])) : getSchemaArray(unref(resolvedSchema), "anyOf") ? (openBlock(), createElementBlock("section", _hoisted_4$2, [_cache[2] || (_cache[2] = createElementVNode("header", null, [createElementVNode("strong", null, "Any of:")], -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(getSchemaArray(unref(resolvedSchema), "anyOf"), (subSchema, index) => {
-				return openBlock(), createElementBlock("section", { key: index }, [createVNode(_component_Schema, {
-					schema: subSchema,
-					depth: __props.depth + 1
-				}, null, 8, ["schema", "depth"])]);
-			}), 128))])) : getSchemaArray(unref(resolvedSchema), "oneOf") ? (openBlock(), createElementBlock("section", _hoisted_5$1, [_cache[3] || (_cache[3] = createElementVNode("header", null, [createElementVNode("strong", null, "One of:")], -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(getSchemaArray(unref(resolvedSchema), "oneOf"), (subSchema, index) => {
-				return openBlock(), createElementBlock("section", { key: index }, [createVNode(_component_Schema, {
-					schema: subSchema,
-					depth: __props.depth + 1
-				}, null, 8, ["schema", "depth"])]);
-			}), 128))])) : getSchemaNot(unref(resolvedSchema)) ? (openBlock(), createElementBlock("section", _hoisted_6$1, [_cache[4] || (_cache[4] = createElementVNode("header", null, [createElementVNode("strong", null, "Not:")], -1)), createElementVNode("section", null, [createVNode(_component_Schema, {
-				schema: getSchemaNot(unref(resolvedSchema)),
-				depth: __props.depth + 1
-			}, null, 8, ["schema", "depth"])])])) : getSchemaType(unref(resolvedSchema)) === "object" || Object.keys(getSchemaProperties(unref(resolvedSchema))).length ? (openBlock(), createElementBlock("section", _hoisted_7$1, [createElementVNode("ul", null, [(openBlock(true), createElementBlock(Fragment, null, renderList(sortProperties(getSchemaProperties(unref(resolvedSchema)), getSchemaRequired(unref(resolvedSchema))), (propSchema, propName) => {
-				return openBlock(), createElementBlock("li", { key: propName }, [
-					createElementVNode("strong", null, [createElementVNode("code", null, toDisplayString(propName), 1), getSchemaRequired(unref(resolvedSchema)).includes(propName) ? (openBlock(), createElementBlock("span", _hoisted_8$1, " (required) ")) : createCommentVNode("", true)]),
-					createElementVNode("p", null, [
-						createElementVNode("code", null, toDisplayString(formatSchemaType(propSchema)), 1),
-						getResolvedSchemaFormat(propSchema) ? (openBlock(), createElementBlock("span", _hoisted_9$1, [_cache[5] || (_cache[5] = createTextVNode(", format: ", -1)), createElementVNode("code", null, toDisplayString(getResolvedSchemaFormat(propSchema)), 1)])) : createCommentVNode("", true),
-						getResolvedSchemaEnum(propSchema) ? (openBlock(), createElementBlock("span", _hoisted_10$1, [_cache[6] || (_cache[6] = createTextVNode(", possible values: ", -1)), createElementVNode("code", null, toDisplayString(formatEnumValues(getResolvedSchemaEnum(propSchema))), 1)])) : createCommentVNode("", true),
-						getResolvedSchemaDefault(propSchema) !== void 0 ? (openBlock(), createElementBlock("span", _hoisted_11$1, [_cache[7] || (_cache[7] = createTextVNode(", default: ", -1)), createElementVNode("code", null, toDisplayString(JSON.stringify(getResolvedSchemaDefault(propSchema))), 1)])) : createCommentVNode("", true),
-						getResolvedSchemaDescription(propSchema) ? (openBlock(), createElementBlock("span", _hoisted_12$1, " — " + toDisplayString(getResolvedSchemaDescription(propSchema)), 1)) : createCommentVNode("", true)
-					]),
-					getResolvedSchemaType(propSchema) === "object" || Object.keys(getResolvedSchemaProperties(propSchema)).length ? (openBlock(), createBlock(_component_Schema, {
-						key: 0,
-						schema: propSchema,
-						depth: __props.depth + 1
-					}, null, 8, ["schema", "depth"])) : createCommentVNode("", true),
-					getResolvedSchemaType(propSchema) === "array" && getResolvedSchemaItems(propSchema) ? (openBlock(), createElementBlock("section", _hoisted_13$1, [_cache[8] || (_cache[8] = createElementVNode("header", null, [createElementVNode("strong", null, "Items:")], -1)), createVNode(_component_Schema, {
-						schema: getResolvedSchemaItems(propSchema),
-						depth: __props.depth + 1
-					}, null, 8, ["schema", "depth"])])) : createCommentVNode("", true)
-				]);
-			}), 128))])])) : getSchemaType(unref(resolvedSchema)) === "array" && getSchemaItems(unref(resolvedSchema)) ? (openBlock(), createElementBlock("section", _hoisted_14$1, [
-				_cache[12] || (_cache[12] = createElementVNode("header", null, [createElementVNode("strong", null, "Array of:")], -1)),
-				createElementVNode("section", null, [createVNode(_component_Schema, {
-					schema: getSchemaItems(unref(resolvedSchema)),
-					depth: __props.depth + 1
-				}, null, 8, ["schema", "depth"])]),
-				getSchemaMinItems(unref(resolvedSchema)) !== void 0 || getSchemaMaxItems(unref(resolvedSchema)) !== void 0 || getSchemaUniqueItems(unref(resolvedSchema)) ? (openBlock(), createElementBlock("ul", _hoisted_15$1, [
-					getSchemaMinItems(unref(resolvedSchema)) !== void 0 ? (openBlock(), createElementBlock("li", _hoisted_16$1, [_cache[9] || (_cache[9] = createTextVNode(" Min items: ", -1)), createElementVNode("code", null, toDisplayString(getSchemaMinItems(unref(resolvedSchema))), 1)])) : createCommentVNode("", true),
-					getSchemaMaxItems(unref(resolvedSchema)) !== void 0 ? (openBlock(), createElementBlock("li", _hoisted_17$1, [_cache[10] || (_cache[10] = createTextVNode(" Max items: ", -1)), createElementVNode("code", null, toDisplayString(getSchemaMaxItems(unref(resolvedSchema))), 1)])) : createCommentVNode("", true),
-					getSchemaUniqueItems(unref(resolvedSchema)) ? (openBlock(), createElementBlock("li", _hoisted_18$1, [..._cache[11] || (_cache[11] = [createTextVNode(" Unique items: ", -1), createElementVNode("code", null, "true", -1)])])) : createCommentVNode("", true)
-				])) : createCommentVNode("", true)
-			])) : (openBlock(), createElementBlock("section", _hoisted_19$1, [createElementVNode("p", null, [
-				createElementVNode("code", null, toDisplayString(getSchemaType(unref(resolvedSchema))), 1),
-				getSchemaFormat(unref(resolvedSchema)) ? (openBlock(), createElementBlock("span", _hoisted_20, [_cache[13] || (_cache[13] = createTextVNode(", format: ", -1)), createElementVNode("code", null, toDisplayString(getSchemaFormat(unref(resolvedSchema))), 1)])) : createCommentVNode("", true),
-				getSchemaEnum(unref(resolvedSchema)) ? (openBlock(), createElementBlock("span", _hoisted_21, [_cache[14] || (_cache[14] = createTextVNode(", possible values: ", -1)), createElementVNode("code", null, toDisplayString(formatEnumValues(getSchemaEnum(unref(resolvedSchema)))), 1)])) : createCommentVNode("", true),
-				getSchemaDefault(unref(resolvedSchema)) !== void 0 ? (openBlock(), createElementBlock("span", _hoisted_22, [_cache[15] || (_cache[15] = createTextVNode(", default: ", -1)), createElementVNode("code", null, toDisplayString(JSON.stringify(getSchemaDefault(unref(resolvedSchema)))), 1)])) : createCommentVNode("", true),
-				getSchemaDescription(unref(resolvedSchema)) ? (openBlock(), createElementBlock("span", _hoisted_23, " — " + toDisplayString(getSchemaDescription(unref(resolvedSchema))), 1)) : createCommentVNode("", true)
-			])]))])) : createCommentVNode("", true);
-		};
-	}
-});
-//#endregion
-//#region src/components/XmlOrJson.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1$1 = { key: 0 };
-var _hoisted_2$1 = { class: "language-xml" };
-var _hoisted_3$1 = { key: 1 };
-var _hoisted_4$1 = { class: "language-json" };
-//#endregion
-//#region src/components/XmlOrJson.vue
-var XmlOrJson_default = /* @__PURE__ */ defineComponent({
-	__name: "XmlOrJson",
-	props: {
-		xml: {
-			type: Boolean,
-			default: false
-		},
-		modelValue: {}
-	},
-	setup(__props) {
-		const xmlContent = computed(() => json2xml(__props.modelValue));
-		return (_ctx, _cache) => {
-			return __props.xml ? (openBlock(), createElementBlock("pre", _hoisted_1$1, [createElementVNode("code", _hoisted_2$1, toDisplayString(xmlContent.value), 1)])) : (openBlock(), createElementBlock("pre", _hoisted_3$1, [createElementVNode("code", _hoisted_4$1, toDisplayString(JSON.stringify(__props.modelValue, null, 2)), 1)]));
-		};
-	}
-});
-//#endregion
-//#region src/components/MarkdownReference.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = { key: 1 };
-var _hoisted_2 = { key: 0 };
-var _hoisted_3 = { key: 1 };
-var _hoisted_4 = { key: 2 };
-var _hoisted_5 = { key: 0 };
-var _hoisted_6 = { key: 1 };
-var _hoisted_7 = { key: 0 };
-var _hoisted_8 = { key: 0 };
-var _hoisted_9 = { key: 1 };
-var _hoisted_10 = { key: 2 };
-var _hoisted_11 = { key: 3 };
-var _hoisted_12 = { key: 1 };
-var _hoisted_13 = { key: 2 };
-var _hoisted_14 = { key: 3 };
-var _hoisted_15 = { key: 2 };
-var _hoisted_16 = { key: 3 };
-var _hoisted_17 = { key: 0 };
-var _hoisted_18 = { key: 1 };
-var _hoisted_19 = { key: 4 };
-//#endregion
-//#region src/components/MarkdownReference.vue
-var MarkdownReference_default = /* @__PURE__ */ defineComponent({
-	__name: "MarkdownReference",
-	props: { content: {} },
-	setup(__props) {
-		const resolveRefAs = (reference) => {
-			const resolved = getResolvedRef(reference);
-			return resolved && typeof resolved === "object" ? resolved : null;
-		};
-		const resolveOperation = (operation) => resolveRefAs(operation);
-		const resolveSchema = (schema) => resolveRefAs(schema);
-		const resolveRequestBody = (body) => resolveRefAs(body);
-		const resolveParameter = (parameter) => resolveRefAs(parameter);
-		const resolveResponse = (response) => resolveRefAs(response);
-		const toRequestBodyView = (body) => resolveRequestBody(body);
-		const toParameterView = (parameter) => {
-			const resolvedParameter = resolveParameter(parameter);
-			if (!resolvedParameter) return null;
-			return resolvedParameter;
-		};
-		const toResponseView = (response) => resolveResponse(response);
-		const getParameterKey = (parameter) => `${parameter.in}:${parameter.name}`;
-		const getParameters = (pathParameters, operationParameters) => {
-			const parameters = /* @__PURE__ */ new Map();
-			for (const parameterList of [pathParameters, operationParameters]) {
-				if (!Array.isArray(parameterList)) continue;
-				for (const parameter of parameterList) {
-					const parameterView = toParameterView(parameter);
-					if (parameterView) parameters.set(getParameterKey(parameterView), parameterView);
-				}
-			}
-			return Array.from(parameters.values());
-		};
-		const operations = computed(() => {
-			const paths = __props.content?.paths ?? {};
-			const entries = [];
-			for (const [path, pathItemRef] of Object.entries(paths)) {
-				const resolvedPathItem = getResolvedPathItem(pathItemRef);
-				forEachPathItemOperation(pathItemRef, (method, operation) => {
-					const resolvedOperation = resolveOperation(operation);
-					if (!resolvedOperation) return;
-					const parameters = getParameters(resolvedPathItem?.parameters, resolvedOperation.parameters);
-					const requestBody = toRequestBodyView(resolvedOperation.requestBody);
-					const responses = Object.entries(resolvedOperation.responses ?? {}).flatMap(([statusCode, response]) => {
-						const resolvedResponse = toResponseView(response);
-						if (!resolvedResponse) return [];
-						return [{
-							statusCode,
-							response: resolvedResponse
-						}];
-					});
-					entries.push({
-						path,
-						method,
-						operation: resolvedOperation,
-						parameters,
-						requestBody,
-						responses
-					});
-				});
-			}
-			return entries;
-		});
-		const webhooks = computed(() => {
-			const webhookItems = __props.content?.webhooks ?? {};
-			const entries = [];
-			for (const [name, pathItemRef] of Object.entries(webhookItems)) forEachPathItemOperation(pathItemRef, (method, operation) => {
-				const resolvedOperation = resolveOperation(operation);
-				if (!resolvedOperation) return;
-				entries.push({
-					name,
-					method,
-					operation: resolvedOperation
-				});
-			});
-			return entries;
-		});
-		const componentSchemas = computed(() => {
-			const schemas = __props.content?.components?.schemas ?? {};
-			return Object.entries(schemas).flatMap(([name, schema]) => {
-				const resolvedSchema = resolveSchema(schema);
-				if (!resolvedSchema) return [];
-				return [{
-					name,
-					schema: resolvedSchema
-				}];
-			});
-		});
-		const getSchemaView = (schema) => schema;
-		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("section", null, [
-				createElementVNode("header", null, [createElementVNode("h1", null, toDisplayString(__props.content?.info?.title), 1), createElementVNode("ul", null, [createElementVNode("li", null, [
-					_cache[0] || (_cache[0] = createElementVNode("strong", null, "OpenAPI Version:", -1)),
-					_cache[1] || (_cache[1] = createTextVNode("\xA0", -1)),
-					createElementVNode("code", null, toDisplayString(__props.content?.openapi), 1)
-				]), createElementVNode("li", null, [
-					_cache[2] || (_cache[2] = createElementVNode("strong", null, "API Version:", -1)),
-					_cache[3] || (_cache[3] = createTextVNode("\xA0", -1)),
-					createElementVNode("code", null, toDisplayString(__props.content?.info?.version), 1)
-				])])]),
-				__props.content?.info?.description ? (openBlock(), createBlock(unref(ScalarMarkdown), {
-					key: 0,
-					value: __props.content?.info?.description
-				}, null, 8, ["value"])) : createCommentVNode("", true),
-				__props.content?.servers?.length ? (openBlock(), createElementBlock("section", _hoisted_1, [_cache[10] || (_cache[10] = createElementVNode("h2", null, "Servers", -1)), createElementVNode("ul", null, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.content.servers, (server) => {
-					return openBlock(), createElementBlock("li", { key: server.url }, [
-						_cache[8] || (_cache[8] = createElementVNode("strong", null, "URL:", -1)),
-						_cache[9] || (_cache[9] = createTextVNode("\xA0", -1)),
-						createElementVNode("code", null, toDisplayString(server.url), 1),
-						createElementVNode("ul", null, [server.description ? (openBlock(), createElementBlock("li", _hoisted_2, [_cache[4] || (_cache[4] = createElementVNode("strong", null, "Description:", -1)), createTextVNode("\xA0" + toDisplayString(server.description), 1)])) : createCommentVNode("", true), server.variables && Object.keys(server.variables).length ? (openBlock(), createElementBlock("li", _hoisted_3, [_cache[7] || (_cache[7] = createElementVNode("strong", null, "Variables:", -1)), createElementVNode("ul", null, [(openBlock(true), createElementBlock(Fragment, null, renderList(server.variables, (variable, name) => {
-							return openBlock(), createElementBlock("li", { key: name }, [
-								createElementVNode("code", null, toDisplayString(name), 1),
-								_cache[5] || (_cache[5] = createTextVNode(" (default: ", -1)),
-								createElementVNode("code", null, toDisplayString(variable.default), 1),
-								_cache[6] || (_cache[6] = createTextVNode(")", -1)),
-								variable.description ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(": " + toDisplayString(variable.description), 1)], 64)) : createCommentVNode("", true)
-							]);
-						}), 128))])])) : createCommentVNode("", true)])
-					]);
-				}), 128))])])) : createCommentVNode("", true),
-				operations.value.length ? (openBlock(), createElementBlock("section", _hoisted_4, [_cache[30] || (_cache[30] = createElementVNode("h2", null, "Operations", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(operations.value, (entry) => {
-					return openBlock(), createElementBlock("section", { key: `${entry.method}:${entry.path}` }, [
-						createElementVNode("header", null, [createElementVNode("h3", null, [entry.operation.summary ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(toDisplayString(entry.operation.summary), 1)], 64)) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [createTextVNode(toDisplayString(entry.method.toString().toUpperCase()) + " " + toDisplayString(entry.path), 1)], 64)), entry.operation["x-scalar-stability"] ? (openBlock(), createElementBlock(Fragment, { key: 2 }, [createTextVNode(" (" + toDisplayString(entry.operation["x-scalar-stability"]) + ") ", 1)], 64)) : entry.operation.deprecated ? (openBlock(), createElementBlock(Fragment, { key: 3 }, [createTextVNode(" ⚠️ Deprecated ")], 64)) : createCommentVNode("", true)])]),
-						createElementVNode("ul", null, [
-							createElementVNode("li", null, [
-								_cache[11] || (_cache[11] = createElementVNode("strong", null, "Method:", -1)),
-								_cache[12] || (_cache[12] = createTextVNode("\xA0", -1)),
-								createElementVNode("code", null, toDisplayString(entry.method.toString().toUpperCase()), 1)
-							]),
-							createElementVNode("li", null, [
-								_cache[13] || (_cache[13] = createElementVNode("strong", null, "Path:", -1)),
-								_cache[14] || (_cache[14] = createTextVNode("\xA0", -1)),
-								createElementVNode("code", null, toDisplayString(entry.path), 1)
-							]),
-							entry.operation.tags ? (openBlock(), createElementBlock("li", _hoisted_5, [_cache[15] || (_cache[15] = createElementVNode("strong", null, "Tags:", -1)), createTextVNode("\xA0" + toDisplayString(entry.operation.tags.join(", ")), 1)])) : createCommentVNode("", true),
-							entry.operation["x-scalar-stability"] ? (openBlock(), createElementBlock("li", _hoisted_6, [_cache[16] || (_cache[16] = createElementVNode("strong", null, "Stability:", -1)), createTextVNode("\xA0" + toDisplayString(entry.operation["x-scalar-stability"]), 1)])) : createCommentVNode("", true)
-						]),
-						createVNode(unref(ScalarMarkdown), { value: entry.operation.description }, null, 8, ["value"]),
-						entry.parameters.length ? (openBlock(), createElementBlock("section", _hoisted_7, [_cache[25] || (_cache[25] = createElementVNode("h4", null, "Parameters", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(entry.parameters, (parameter) => {
-							return openBlock(), createElementBlock("section", { key: `${parameter.in}:${parameter.name}` }, [
-								createElementVNode("h5", null, [
-									createElementVNode("code", null, toDisplayString(parameter.name), 1),
-									parameter.required ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(" required")], 64)) : createCommentVNode("", true),
-									parameter.deprecated ? (openBlock(), createElementBlock(Fragment, { key: 1 }, [createTextVNode(" deprecated")], 64)) : createCommentVNode("", true)
-								]),
-								createElementVNode("ul", null, [
-									createElementVNode("li", null, [
-										_cache[17] || (_cache[17] = createElementVNode("strong", null, "In:", -1)),
-										_cache[18] || (_cache[18] = createTextVNode("\xA0", -1)),
-										createElementVNode("code", null, toDisplayString(parameter.in), 1)
-									]),
-									parameter.style ? (openBlock(), createElementBlock("li", _hoisted_8, [
-										_cache[19] || (_cache[19] = createElementVNode("strong", null, "Style:", -1)),
-										_cache[20] || (_cache[20] = createTextVNode("\xA0", -1)),
-										createElementVNode("code", null, toDisplayString(parameter.style), 1)
-									])) : createCommentVNode("", true),
-									typeof parameter.explode === "boolean" ? (openBlock(), createElementBlock("li", _hoisted_9, [
-										_cache[21] || (_cache[21] = createElementVNode("strong", null, "Explode:", -1)),
-										_cache[22] || (_cache[22] = createTextVNode("\xA0", -1)),
-										createElementVNode("code", null, toDisplayString(parameter.explode), 1)
-									])) : createCommentVNode("", true),
-									parameter.allowEmptyValue ? (openBlock(), createElementBlock("li", _hoisted_10, [..._cache[23] || (_cache[23] = [createElementVNode("strong", null, "Allow Empty Value:", -1), createTextVNode("\xA0true", -1)])])) : createCommentVNode("", true),
-									parameter.allowReserved ? (openBlock(), createElementBlock("li", _hoisted_11, [..._cache[24] || (_cache[24] = [createElementVNode("strong", null, "Allow Reserved:", -1), createTextVNode("\xA0true", -1)])])) : createCommentVNode("", true)
-								]),
-								parameter.description ? (openBlock(), createBlock(unref(ScalarMarkdown), {
-									key: 0,
-									value: parameter.description
-								}, null, 8, ["value"])) : createCommentVNode("", true),
-								resolveSchema(parameter.schema) ? (openBlock(), createBlock(Schema_default, {
-									key: 1,
-									schema: resolveSchema(parameter.schema)
-								}, null, 8, ["schema"])) : createCommentVNode("", true),
-								parameter.content ? (openBlock(true), createElementBlock(Fragment, { key: 2 }, renderList(parameter.content, (parameterContent, mediaType) => {
-									return openBlock(), createElementBlock(Fragment, { key: mediaType }, [createElementVNode("h6", null, "Content-Type: " + toDisplayString(mediaType), 1), resolveSchema(parameterContent.schema) ? (openBlock(), createBlock(Schema_default, {
-										key: 0,
-										schema: resolveSchema(parameterContent.schema)
-									}, null, 8, ["schema"])) : createCommentVNode("", true)], 64);
-								}), 128)) : createCommentVNode("", true)
-							]);
-						}), 128))])) : createCommentVNode("", true),
-						entry.requestBody?.content ? (openBlock(), createElementBlock("section", _hoisted_12, [_cache[27] || (_cache[27] = createElementVNode("h4", null, "Request Body", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(entry.requestBody.content, (bodyContent, mediaType) => {
-							return openBlock(), createElementBlock(Fragment, { key: mediaType }, [createElementVNode("h5", null, "Content-Type: " + toDisplayString(mediaType), 1), resolveSchema(bodyContent.schema) ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
-								createVNode(Schema_default, { schema: resolveSchema(bodyContent.schema) }, null, 8, ["schema"]),
-								_cache[26] || (_cache[26] = createElementVNode("p", null, [createElementVNode("strong", null, "Example:")], -1)),
-								createVNode(XmlOrJson_default, {
-									modelValue: unref(getExampleFromSchema)(resolveSchema(bodyContent.schema), { xml: mediaType?.toString().includes("xml") }),
-									xml: mediaType?.toString().includes("xml")
-								}, null, 8, ["modelValue", "xml"])
-							], 64)) : createCommentVNode("", true)], 64);
-						}), 128))])) : createCommentVNode("", true),
-						entry.responses.length ? (openBlock(), createElementBlock("section", _hoisted_13, [_cache[29] || (_cache[29] = createElementVNode("h4", null, "Responses", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(entry.responses, (entryResponse) => {
-							return openBlock(), createElementBlock("section", { key: entryResponse.statusCode }, [createElementVNode("header", null, [createElementVNode("h5", null, [createTextVNode(" Status: " + toDisplayString(entryResponse.statusCode) + " ", 1), entryResponse.response.description ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(toDisplayString(entryResponse.response.description), 1)], 64)) : createCommentVNode("", true)])]), entryResponse.response.content ? (openBlock(true), createElementBlock(Fragment, { key: 0 }, renderList(entryResponse.response.content, (responseContent, mediaType) => {
-								return openBlock(), createElementBlock("section", { key: mediaType }, [createElementVNode("h6", null, "Content-Type: " + toDisplayString(mediaType), 1), resolveSchema(responseContent.schema) ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
-									createVNode(Schema_default, { schema: resolveSchema(responseContent.schema) }, null, 8, ["schema"]),
-									_cache[28] || (_cache[28] = createElementVNode("p", null, [createElementVNode("strong", null, "Example:")], -1)),
-									createVNode(XmlOrJson_default, {
-										modelValue: unref(getExampleFromSchema)(resolveSchema(responseContent.schema), { xml: mediaType?.toString().includes("xml") }),
-										xml: mediaType?.toString().includes("xml")
-									}, null, 8, ["modelValue", "xml"])
-								], 64)) : createCommentVNode("", true)]);
-							}), 128)) : createCommentVNode("", true)]);
-						}), 128))])) : createCommentVNode("", true)
-					]);
-				}), 128))])) : createCommentVNode("", true),
-				webhooks.value.length ? (openBlock(), createElementBlock("section", _hoisted_14, [_cache[35] || (_cache[35] = createElementVNode("h2", null, "Webhooks", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(webhooks.value, (webhook) => {
-					return openBlock(), createElementBlock("section", { key: `${webhook.name}:${webhook.method}` }, [
-						createElementVNode("header", null, [createElementVNode("h3", null, [webhook.operation.summary ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [createTextVNode(toDisplayString(webhook.operation.summary), 1)], 64)) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [createTextVNode(toDisplayString(webhook.name), 1)], 64)), webhook.operation["x-scalar-stability"] ? (openBlock(), createElementBlock("span", _hoisted_15, "(" + toDisplayString(webhook.operation["x-scalar-stability"]) + ")", 1)) : webhook.operation.deprecated ? (openBlock(), createElementBlock("span", _hoisted_16, "⚠️ Deprecated")) : createCommentVNode("", true)])]),
-						createElementVNode("ul", null, [
-							createElementVNode("li", null, [_cache[31] || (_cache[31] = createElementVNode("strong", null, "Method:", -1)), createElementVNode("code", null, toDisplayString(webhook.method.toString().toUpperCase()), 1)]),
-							createElementVNode("li", null, [_cache[32] || (_cache[32] = createElementVNode("strong", null, "Path:", -1)), createElementVNode("code", null, "/webhooks/" + toDisplayString(webhook.name), 1)]),
-							webhook.operation.tags ? (openBlock(), createElementBlock("li", _hoisted_17, [_cache[33] || (_cache[33] = createElementVNode("strong", null, "Tags:", -1)), createTextVNode(" " + toDisplayString(webhook.operation.tags.join(", ")), 1)])) : createCommentVNode("", true),
-							webhook.operation.deprecated ? (openBlock(), createElementBlock("li", _hoisted_18, [..._cache[34] || (_cache[34] = [createElementVNode("strong", null, "Deprecated", -1)])])) : createCommentVNode("", true)
-						]),
-						createVNode(unref(ScalarMarkdown), { value: webhook.operation.description }, null, 8, ["value"])
-					]);
-				}), 128))])) : createCommentVNode("", true),
-				componentSchemas.value.length ? (openBlock(), createElementBlock("section", _hoisted_19, [_cache[38] || (_cache[38] = createElementVNode("h2", null, "Schemas", -1)), (openBlock(true), createElementBlock(Fragment, null, renderList(componentSchemas.value, (entry) => {
-					return openBlock(), createElementBlock("section", { key: entry.name }, [
-						createElementVNode("header", null, [createElementVNode("h3", null, toDisplayString(getSchemaView(entry.schema).title ?? entry.name), 1)]),
-						createElementVNode("ul", null, [createElementVNode("li", null, [_cache[36] || (_cache[36] = createElementVNode("strong", null, "Type:", -1)), createElementVNode("code", null, toDisplayString(getSchemaView(entry.schema).type), 1)])]),
-						getSchemaView(entry.schema).description ? (openBlock(), createBlock(unref(ScalarMarkdown), {
-							key: 0,
-							value: getSchemaView(entry.schema).description
-						}, null, 8, ["value"])) : createCommentVNode("", true),
-						getSchemaView(entry.schema).type === "object" ? (openBlock(), createBlock(Schema_default, {
-							key: 1,
-							schema: entry.schema
-						}, null, 8, ["schema"])) : createCommentVNode("", true),
-						_cache[37] || (_cache[37] = createElementVNode("p", null, [createElementVNode("strong", null, "Example:")], -1)),
-						getSchemaView(entry.schema).type === "object" ? (openBlock(), createBlock(XmlOrJson_default, {
-							key: 2,
-							modelValue: unref(getExampleFromSchema)(entry.schema)
-						}, null, 8, ["modelValue"])) : createCommentVNode("", true)
-					]);
-				}), 128))])) : createCommentVNode("", true)
-			]);
-		};
-	}
-});
-//#endregion
-//#region src/create-markdown-from-openapi.ts
-var HTTP_METHODS = [
-	"get",
-	"put",
-	"post",
-	"delete",
-	"options",
-	"head",
-	"patch",
-	"trace"
-];
-var HTTP_METHOD_SET = new Set(HTTP_METHODS);
-var isHttpUrl = (value) => {
-	try {
-		const url = new URL(value);
-		return url.protocol === "http:" || url.protocol === "https:";
-	} catch {
-		return false;
-	}
-};
-var toWorkspaceInput = (input) => {
-	if (typeof input !== "string") return { document: input };
-	const normalized = normalize(input);
-	if (isObject(normalized)) return { document: normalized };
-	if (isHttpUrl(input)) return { url: input };
-	return { path: input };
-};
-var normalizeHttpMethod = (method) => {
-	const normalized = method.toLowerCase();
-	if (HTTP_METHOD_SET.has(normalized)) return normalized;
-	return null;
-};
-var normalizeJsonPointer = (pointer) => {
-	if (pointer.startsWith("#/")) return pointer.slice(1);
-	if (pointer.startsWith("/")) return pointer;
-	throw new Error(`Invalid JSON pointer "${pointer}". JSON pointers must start with "#/"`);
-};
-var parseJsonPointer = (pointer) => normalizeJsonPointer(pointer).slice(1).split("/").map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
-var getOperationSelectorFromPointer = (pointer) => {
-	const segments = parseJsonPointer(pointer);
-	if (segments.length !== 3 || segments[0] !== "paths") throw new Error(`JSON pointer "${pointer}" must target an operation object under "/paths/{path}/{method}"`);
-	const path = segments[1];
-	const method = segments[2];
-	if (!path || !method) throw new Error(`JSON pointer "${pointer}" must target an operation object under "/paths/{path}/{method}"`);
-	return {
-		path,
-		method
-	};
-};
-var getPathEntries = (document) => {
-	const paths = document.paths;
-	if (!isObject(paths)) return [];
-	return Object.entries(paths).flatMap(([path, pathItemRef]) => {
-		const pathItem = getResolvedPathItem(pathItemRef);
-		return pathItem ? [[path, pathItem]] : [];
-	});
-};
-var filterPathItemToSingleOperation = (pathItem, selectedMethod) => Object.fromEntries(Object.entries(pathItem).filter(([key]) => {
-	const method = normalizeHttpMethod(key);
-	return !method || method === selectedMethod;
-}));
-var findOperationByPathAndMethod = (document, selector) => {
-	const method = normalizeHttpMethod(selector.method);
-	if (!method) throw new Error(`Invalid HTTP method "${selector.method}". Supported methods: ${HTTP_METHODS.join(", ")}`);
-	const pathItemRef = document.paths?.[selector.path];
-	if (!getPathItemOperation(pathItemRef, method)) throw new Error(`Operation not found for path "${selector.path}" and method "${method.toUpperCase()}"`);
-	return {
-		path: selector.path,
-		method
-	};
-};
-var findOperationsByOperationId = (document, operationId) => getPathEntries(document).flatMap(([path, pathItem]) => Object.entries(pathItem).flatMap(([methodKey, operation]) => {
-	const method = normalizeHttpMethod(methodKey);
-	if (!method || !isObject(operation)) return [];
-	if (("operationId" in operation && typeof operation.operationId === "string" ? operation.operationId : void 0) !== operationId) return [];
-	return [{
-		path,
-		method
-	}];
-}));
-var resolveOperationMatch = (document, selector) => {
-	if ("pointer" in selector) return findOperationByPathAndMethod(document, getOperationSelectorFromPointer(selector.pointer));
-	if ("operationId" in selector) {
-		const matches = findOperationsByOperationId(document, selector.operationId);
-		if (!matches.length) throw new Error(`Operation with operationId "${selector.operationId}" was not found`);
-		if (matches.length > 1) {
-			const uniqueCandidates = matches.map(({ path, method }) => `"${method.toUpperCase()} ${path}"`);
-			throw new Error(`Multiple operations found for operationId "${selector.operationId}". Use { path, method } instead. Matches: ${uniqueCandidates.join(", ")}`);
-		}
-		return matches[0];
-	}
-	return findOperationByPathAndMethod(document, selector);
-};
-var filterDocumentByOperation = (document, selector) => {
-	const match = resolveOperationMatch(document, selector);
-	const pathItem = getPathEntries(document).find(([path]) => path === match.path)?.[1];
-	if (!pathItem) throw new Error(`Operation not found for path "${match.path}" and method "${match.method.toUpperCase()}"`);
-	return {
-		...document,
-		paths: { [match.path]: filterPathItemToSingleOperation(pathItem, match.method) }
-	};
-};
-async function createHtmlFromOpenApi(input, options) {
-	const workspaceStore = createWorkspaceStore({ fileLoader: readFiles() });
-	const name = "openapi-to-markdown";
-	if (!await workspaceStore.addDocument({
-		name,
-		...toWorkspaceInput(input)
-	})) throw new Error("Failed to load OpenAPI document");
-	const content = workspaceStore.workspace.documents[name];
-	if (!content) throw new Error("OpenAPI document could not be resolved");
-	return minify(await renderToString(createSSRApp(MarkdownReference_default, { content: options?.operation && isObject(content) ? filterDocumentByOperation(content, options.operation) : content })), {
-		removeComments: true,
-		removeEmptyElements: true,
-		collapseWhitespace: true,
-		continueOnParseError: true,
-		noNewlinesBeforeTagClose: true,
-		preserveLineBreaks: true,
-		removeEmptyAttributes: true,
-		decodeEntities: true,
-		useShortDoctype: true
-	});
-}
-async function createMarkdownFromOpenApi(content, options) {
-	return markdownFromHtml(await createHtmlFromOpenApi(content, options));
-}
-async function markdownFromHtml(html) {
-	const file = await unified().use(rehypeParse, { fragment: true }).use(remarkGfm).use(rehypeSanitize).use(rehypeRemark).use(remarkStringify, { bullet: "-" }).process(html);
-	return String(file);
-}
-//#endregion
-export { createHtmlFromOpenApi, createMarkdownFromOpenApi };
-
-//# sourceMappingURL=index.js.map
+export { createHtmlFromOpenApi, createMarkdownFromOpenApi, createOpenApiMarkdownRenderer, } from './create-markdown-from-openapi.js';

package/dist/load-document.d.ts

@@ -0,0 +1,4 @@
+import { type OpenApiDocument } from '@scalar/workspace-store/schemas/v3.2/strict/openapi-document';
+/** Coerce one plain document and keep references linked to shared targets. */
+export declare const loadDocument: (input: OpenApiDocument | Record<string, unknown> | string) => Promise<OpenApiDocument>;
+//# sourceMappingURL=load-document.d.ts.map

package/dist/load-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-document.d.ts","sourceRoot":"","sources":["../src/load-document.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8DAA8D,CAAA;AAyErE,8EAA8E;AAC9E,eAAO,MAAM,YAAY,GACvB,OAAO,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,KACxD,OAAO,CAAC,eAAe,CAoFzB,CAAA"}