@andesine/pages 0.0.0-stage → 0.6.0

package/dist/chunks/markdown-DKJSQxR2.js

@@ -0,0 +1,42 @@
+//#region src/output/markdown.ts
+const toLine = (value) => value.replace(/\s+/g, " ").trim();
+/** Text for Markdown link labels, with brackets and backslashes escaped. */
+const toLabel = (value) => toLine(value).replace(/[[\]\\]/g, "\\$&");
+const toQuote = (text) => {
+	return text.split("\n").map((line) => line.trim() ? `> ${line}` : ">").join("\n");
+};
+const getLLMsURL = (config) => {
+	return new URL(`${config.base}llms.txt`, config.site).href;
+};
+/** Tells agents on a single page where the index is, with the site's agent instructions. */
+const createAgentNote = (config) => {
+	const index = [
+		"## Documentation index",
+		"",
+		`Fetch the complete documentation index at: ${getLLMsURL(config)}`,
+		"Use it to find all pages before you explore further."
+	];
+	const instructions = config.agents.instructions ? [
+		"",
+		"## Agent instructions",
+		"",
+		config.agents.instructions
+	] : [];
+	return toQuote([...index, ...instructions].join("\n"));
+};
+/** A page's Markdown, with its title, description, and optional source URL. */
+const createPageBody = (page, source) => {
+	return [
+		`# ${toLine(page.title)}`,
+		source && `Source: ${source}`,
+		page.description && `> ${toLine(page.description)}`,
+		page.markdown
+	].filter(Boolean).join("\n\n");
+};
+const createMarkdownPage = (config, page) => {
+	return `${createAgentNote(config)}\n\n${createPageBody(page)}\n`;
+};
+//#endregion
+export { toLine as i, createPageBody as n, toLabel as r, createMarkdownPage as t };
+
+//# sourceMappingURL=markdown-DKJSQxR2.js.map

package/dist/chunks/markdown-DKJSQxR2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-DKJSQxR2.js","names":[],"sources":["../../src/output/markdown.ts"],"sourcesContent":["import type { PagesConfig } from \"../config\";\nimport type { SourcePage } from \"../sources\";\n\nconst toLine = (value: string): string => value.replace(/\\s+/g, \" \").trim();\n/** Text for Markdown link labels, with brackets and backslashes escaped. */\nconst toLabel = (value: string): string => toLine(value).replace(/[[\\]\\\\]/g, \"\\\\$&\");\nconst toQuote = (text: string): string => {\n  return text\n    .split(\"\\n\")\n    .map((line) => (line.trim() ? `> ${line}` : \">\"))\n    .join(\"\\n\");\n};\nconst getLLMsURL = (config: PagesConfig): string => {\n  return new URL(`${config.base}llms.txt`, config.site).href;\n};\n/** Tells agents on a single page where the index is, with the site's agent instructions. */\nconst createAgentNote = (config: PagesConfig): string => {\n  const index = [\n    \"## Documentation index\",\n    \"\",\n    `Fetch the complete documentation index at: ${getLLMsURL(config)}`,\n    \"Use it to find all pages before you explore further.\"\n  ];\n  const instructions = config.agents.instructions\n    ? [\"\", \"## Agent instructions\", \"\", config.agents.instructions]\n    : [];\n\n  return toQuote([...index, ...instructions].join(\"\\n\"));\n};\n/** A page's Markdown, with its title, description, and optional source URL. */\nconst createPageBody = (page: SourcePage, source?: string): string => {\n  const title = `# ${toLine(page.title)}`;\n  const url = source && `Source: ${source}`;\n  const description = page.description && `> ${toLine(page.description)}`;\n\n  return [title, url, description, page.markdown].filter(Boolean).join(\"\\n\\n\");\n};\nconst createMarkdownPage = (config: PagesConfig, page: SourcePage): string => {\n  return `${createAgentNote(config)}\\n\\n${createPageBody(page)}\\n`;\n};\n\nexport { toLine, toLabel, getLLMsURL, createAgentNote, createPageBody, createMarkdownPage };\n"],"mappings":";AAGA,MAAM,UAAU,UAA0B,MAAM,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK;;AAE1E,MAAM,WAAW,UAA0B,OAAO,KAAK,CAAC,CAAC,QAAQ,YAAY,MAAM;AACnF,MAAM,WAAW,SAAyB;CACxC,OAAO,KACJ,MAAM,IAAI,CAAC,CACX,KAAK,SAAU,KAAK,KAAK,IAAI,KAAK,SAAS,GAAI,CAAC,CAChD,KAAK,IAAI;AACd;AACA,MAAM,cAAc,WAAgC;CAClD,OAAO,IAAI,IAAI,GAAG,OAAO,KAAK,WAAW,OAAO,IAAI,CAAC,CAAC;AACxD;;AAEA,MAAM,mBAAmB,WAAgC;CACvD,MAAM,QAAQ;EACZ;EACA;EACA,8CAA8C,WAAW,MAAM;EAC/D;CACF;CACA,MAAM,eAAe,OAAO,OAAO,eAC/B;EAAC;EAAI;EAAyB;EAAI,OAAO,OAAO;CAAY,IAC5D,CAAC;CAEL,OAAO,QAAQ,CAAC,GAAG,OAAO,GAAG,YAAY,CAAC,CAAC,KAAK,IAAI,CAAC;AACvD;;AAEA,MAAM,kBAAkB,MAAkB,WAA4B;CAKpE,OAAO;EAAC,KAJW,OAAO,KAAK,KAAK;EACxB,UAAU,WAAW;EACb,KAAK,eAAe,KAAK,OAAO,KAAK,WAAW;EAEnC,KAAK;CAAQ,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,MAAM;AAC7E;AACA,MAAM,sBAAsB,QAAqB,SAA6B;CAC5E,OAAO,GAAG,gBAAgB,MAAM,EAAE,MAAM,eAAe,IAAI,EAAE;AAC/D"}

package/dist/chunks/mdx-components-CUUDTapN.d.ts

@@ -0,0 +1,9 @@
+//#region src/content/mdx-components.d.ts
+interface FileTreeItem {
+  name: string;
+  type: "file" | "folder";
+  children: FileTreeItem[];
+}
+//#endregion
+export { FileTreeItem as t };
+//# sourceMappingURL=mdx-components-CUUDTapN.d.ts.map

package/dist/chunks/normalize-DG5nxOLm.js

@@ -0,0 +1,361 @@
+//#region src/sources/openapi/normalize.ts
+const reservedHeaders = [
+	"accept",
+	"content-type",
+	"authorization"
+];
+const methods = [
+	"get",
+	"put",
+	"post",
+	"delete",
+	"options",
+	"head",
+	"patch",
+	"trace"
+];
+const constraintKeys = [
+	"minimum",
+	"maximum",
+	"exclusiveMinimum",
+	"exclusiveMaximum",
+	"multipleOf",
+	"minLength",
+	"maxLength",
+	"pattern",
+	"minItems",
+	"maxItems",
+	"uniqueItems",
+	"minProperties",
+	"maxProperties"
+];
+const exclusiveKeys = [["exclusiveMinimum", "minimum"], ["exclusiveMaximum", "maximum"]];
+const schemaPrefix = "#/components/schemas/";
+const isObject = (value) => {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+const toObject = (value) => isObject(value) ? value : {};
+/** Makes a label from an identifier-like tag name, e.g. `schemaMigrations` or `type-metadata`. */
+const toTagLabel = (name) => {
+	if (!/^[a-z][a-zA-Z\d]*(?:[-_][a-zA-Z\d]+)*$/.test(name)) return name;
+	const words = name.replace(/([a-z\d])([A-Z])/g, "$1 $2").split(/[-_\s]+/).join(" ").toLowerCase();
+	return `${words[0].toUpperCase()}${words.slice(1)}`;
+};
+const toText = (value) => {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+};
+/** Removes `undefined` fields, so the stored model stays small. */
+const compact = (value) => {
+	return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== void 0));
+};
+/** Decodes URI escapes; keys can contain a bare `%`, which is not an escape. */
+const decodeSegment = (segment) => {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+};
+const unescapeSegment = (segment) => {
+	return decodeSegment(segment).replaceAll("~1", "/").replaceAll("~0", "~");
+};
+/** Reads a local JSON pointer, such as `#/components/schemas/Pet`. */
+const readPointer = (document, ref) => {
+	return ref.slice(2).split("/").map(unescapeSegment).reduce((value, key) => {
+		if (Array.isArray(value)) return /^(0|[1-9]\d*)$/.test(key) ? value[Number(key)] : void 0;
+		return isObject(value) ? value[key] : void 0;
+	}, document);
+};
+/** Schema examples: 3.1 `examples`, or the 3.0 `example`. */
+const toSchemaExamples = (raw) => {
+	if (Array.isArray(raw.examples)) return raw.examples;
+	return raw.example === void 0 ? void 0 : [raw.example];
+};
+/** Normalizes a spec; `label` names its source in errors. */
+const normalizeSpec = (document, label, baseURL = "https://api.example.com") => {
+	const info = toObject(document.info);
+	const components = toObject(document.components);
+	const schemas = {};
+	const schemaNames = /* @__PURE__ */ new Map();
+	const usedNames = /* @__PURE__ */ new Set();
+	const ignored = /* @__PURE__ */ new Set();
+	const supportsSchemaSiblings = String(document.openapi).startsWith("3.1.");
+	/** Follows references of parameters, responses, and other objects, which cannot recurse. */
+	const resolve = (value, depth = 0) => {
+		const ref = isObject(value) ? value.$ref : void 0;
+		if (typeof ref !== "string" || depth > 20) return toObject(value);
+		return resolve(readPointer(document, ref), depth + 1);
+	};
+	const toSchemaName = (ref) => {
+		const base = ref.startsWith(schemaPrefix) ? unescapeSegment(ref.slice(21)) : unescapeSegment(ref.split("/").at(-1) ?? "Schema");
+		let name = base;
+		for (let index = 2; usedNames.has(name); index++) name = `${base}${index}`;
+		usedNames.add(name);
+		return name;
+	};
+	const toSchemaList = (value) => {
+		return Array.isArray(value) ? value.map(toSchema) : void 0;
+	};
+	/** Named schemas become references, so recursive schemas stay finite. */
+	const toSchema = (value) => {
+		if (value === true) return {};
+		if (value === false) return { not: {} };
+		const raw = toObject(value);
+		if (typeof raw.$ref === "string") {
+			let name = schemaNames.get(raw.$ref);
+			if (!name) {
+				name = toSchemaName(raw.$ref);
+				schemaNames.set(raw.$ref, name);
+				schemas[name] = {};
+				schemas[name] = toSchema(readPointer(document, raw.$ref));
+			}
+			const reference = compact({
+				ref: name,
+				description: toText(raw.description),
+				default: raw.default,
+				examples: toSchemaExamples(raw),
+				deprecated: raw.deprecated === true || void 0,
+				readOnly: raw.readOnly === true || void 0,
+				writeOnly: raw.writeOnly === true || void 0
+			});
+			const { $ref: _ref, ...siblings } = raw;
+			const schema = supportsSchemaSiblings ? toSchema(siblings) : {};
+			if (Object.keys(schema).some((key) => !(key in reference))) return {
+				...schema,
+				allOf: [{ ref: name }, ...schema.allOf ?? []]
+			};
+			return reference;
+		}
+		const types = raw.type === void 0 ? [] : [raw.type].flat().map(String);
+		const required = Array.isArray(raw.required) ? raw.required.map(String) : [];
+		const properties = isObject(raw.properties) ? Object.entries(raw.properties) : void 0;
+		const constraints = Object.fromEntries(constraintKeys.filter((key) => raw[key] !== void 0).map((key) => [key, raw[key]]));
+		const examples = toSchemaExamples(raw);
+		if (raw.nullable === true && types.length && !types.includes("null")) types.push("null");
+		for (const [exclusive, limit] of exclusiveKeys) {
+			if (typeof constraints[exclusive] !== "boolean") continue;
+			if (constraints[exclusive] && constraints[limit] !== void 0) {
+				constraints[exclusive] = constraints[limit];
+				delete constraints[limit];
+			} else delete constraints[exclusive];
+		}
+		return compact({
+			type: types.length ? types : void 0,
+			format: toText(raw.format),
+			contentMediaType: toText(raw.contentMediaType),
+			contentEncoding: toText(raw.contentEncoding),
+			title: toText(raw.title),
+			description: toText(raw.description),
+			enum: Array.isArray(raw.enum) ? raw.enum : void 0,
+			const: raw.const,
+			default: raw.default,
+			examples,
+			deprecated: raw.deprecated === true || void 0,
+			readOnly: raw.readOnly === true || void 0,
+			writeOnly: raw.writeOnly === true || void 0,
+			required: required.length ? required : void 0,
+			properties: properties?.map(([name, schema]) => {
+				return {
+					name,
+					required: required.includes(name),
+					schema: toSchema(schema)
+				};
+			}),
+			additionalProperties: typeof raw.additionalProperties === "boolean" ? raw.additionalProperties : raw.additionalProperties === void 0 ? void 0 : toSchema(raw.additionalProperties),
+			items: raw.items === void 0 ? void 0 : toSchema(raw.items),
+			allOf: toSchemaList(raw.allOf),
+			oneOf: toSchemaList(raw.oneOf),
+			anyOf: toSchemaList(raw.anyOf),
+			not: raw.not === void 0 ? void 0 : toSchema(raw.not),
+			discriminator: isObject(raw.discriminator) ? raw.discriminator : void 0,
+			constraints: Object.keys(constraints).length ? constraints : void 0
+		});
+	};
+	const toExamples = (raw) => {
+		if (isObject(raw.examples)) return Object.entries(raw.examples).map(([name, example]) => {
+			const resolved = resolve(example);
+			return compact({
+				name,
+				summary: toText(resolved.summary),
+				value: resolved.value
+			});
+		});
+		return raw.example === void 0 ? [] : [{ value: raw.example }];
+	};
+	const toMediaTypes = (content) => {
+		return Object.entries(toObject(content)).map(([type, media]) => {
+			const raw = resolve(media);
+			return compact({
+				type,
+				schema: raw.schema === void 0 ? void 0 : toSchema(raw.schema),
+				examples: toExamples(raw),
+				encoding: isObject(raw.encoding) ? Object.fromEntries(Object.entries(raw.encoding).map(([name, value]) => {
+					const encoding = toObject(value);
+					return [name, compact({
+						contentType: toText(encoding.contentType),
+						style: toText(encoding.style),
+						explode: typeof encoding.explode === "boolean" ? encoding.explode : void 0
+					})];
+				})) : void 0
+			});
+		});
+	};
+	const toParameter = (value) => {
+		const raw = resolve(value);
+		const [media] = toMediaTypes(raw.content);
+		const examples = toExamples(raw);
+		return compact({
+			name: String(raw.name),
+			in: raw.in,
+			required: raw.in === "path" || raw.required === true,
+			deprecated: raw.deprecated === true,
+			description: toText(raw.description),
+			schema: raw.schema === void 0 ? media?.schema : toSchema(raw.schema),
+			examples: examples.length ? examples : media?.examples ?? [],
+			mediaType: raw.schema === void 0 ? media?.type : void 0,
+			style: toText(raw.style),
+			explode: typeof raw.explode === "boolean" ? raw.explode : void 0
+		});
+	};
+	/** Response headers; OpenAPI ignores a `Content-Type` header, which the content sets. */
+	const toHeaders = (headers) => {
+		return Object.entries(toObject(headers)).filter(([name]) => {
+			return name.toLowerCase() !== "content-type";
+		}).map(([name, header]) => {
+			const raw = resolve(header);
+			return compact({
+				name,
+				required: raw.required === true,
+				description: toText(raw.description),
+				schema: raw.schema === void 0 ? void 0 : toSchema(raw.schema)
+			});
+		});
+	};
+	const toRequestBody = (value) => {
+		const raw = resolve(value);
+		return compact({
+			required: raw.required === true,
+			description: toText(raw.description),
+			contents: toMediaTypes(raw.content)
+		});
+	};
+	const toResponses = (responses) => {
+		return Object.entries(toObject(responses)).filter(([status]) => !status.startsWith("x-")).map(([status, response]) => {
+			const raw = resolve(response);
+			return compact({
+				status,
+				description: toText(raw.description),
+				headers: toHeaders(raw.headers),
+				contents: toMediaTypes(raw.content)
+			});
+		});
+	};
+	const toServers = (value) => {
+		return Array.isArray(value) ? value.map((server) => {
+			const raw = toObject(server);
+			const variables = toObject(raw.variables);
+			const url = String(raw.url).replace(/\{([^}]+)\}/g, (match, name) => {
+				const value = toObject(variables[name]).default;
+				return value === void 0 ? match : String(value);
+			});
+			return compact({
+				url: new URL(url, baseURL).href,
+				description: toText(raw.description)
+			});
+		}) : void 0;
+	};
+	const toCodeSamples = (raw) => {
+		const samples = raw["x-codeSamples"] ?? raw["x-code-samples"];
+		return (Array.isArray(samples) ? samples : []).filter(isObject).map((sample) => {
+			const lang = String(sample.lang);
+			return {
+				lang,
+				label: toText(sample.label) ?? lang,
+				source: String(sample.source)
+			};
+		});
+	};
+	const servers = toServers(document.servers) ?? [];
+	const operations = Object.entries(toObject(document.paths)).flatMap(([path, item]) => {
+		const pathItem = resolve(item);
+		const pathParameters = Array.isArray(pathItem.parameters) ? pathItem.parameters : [];
+		return methods.flatMap((method) => {
+			const raw = pathItem[method];
+			if (!isObject(raw)) return [];
+			if (raw.callbacks) ignored.add("callbacks");
+			const parameters = /* @__PURE__ */ new Map();
+			const operationParameters = Array.isArray(raw.parameters) ? raw.parameters : [];
+			[...pathParameters, ...operationParameters].map(toParameter).forEach((parameter) => {
+				const isHeader = parameter.in === "header";
+				const name = isHeader ? parameter.name.toLowerCase() : parameter.name;
+				if (isHeader && reservedHeaders.includes(name)) return;
+				parameters.set(`${parameter.in}:${name}`, parameter);
+			});
+			return [compact({
+				id: toText(raw.operationId) ?? `${method.toUpperCase()} ${path}`,
+				method,
+				path,
+				summary: toText(raw.summary),
+				description: toText(raw.description),
+				deprecated: raw.deprecated === true,
+				tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],
+				parameters: [...parameters.values()],
+				requestBody: raw.requestBody === void 0 ? void 0 : toRequestBody(raw.requestBody),
+				responses: toResponses(raw.responses),
+				security: Array.isArray(raw.security) ? raw.security : document.security ?? [],
+				servers: toServers(raw.servers) ?? toServers(pathItem.servers) ?? servers,
+				codeSamples: toCodeSamples(raw),
+				extensions: Object.fromEntries(Object.entries(raw).filter(([key]) => {
+					return key.startsWith("x-") && key !== "x-codeSamples" && key !== "x-code-samples";
+				}))
+			})];
+		});
+	});
+	const declaredTags = (Array.isArray(document.tags) ? document.tags : []).filter(isObject).map((tag) => {
+		const name = String(tag.name);
+		return compact({
+			name,
+			label: toText(tag["x-displayName"]) ?? toTagLabel(name),
+			description: toText(tag.description)
+		});
+	});
+	const operationIDs = /* @__PURE__ */ new Set();
+	const usedTags = new Set(operations.flatMap((operation) => operation.tags.slice(0, 1)));
+	const tags = [...declaredTags.filter((tag) => usedTags.has(tag.name)), ...[...usedTags].filter((name) => !declaredTags.some((tag) => tag.name === name)).map((name) => ({
+		name,
+		label: toTagLabel(name)
+	}))];
+	operations.forEach((operation) => {
+		if (operationIDs.has(operation.id)) throw new Error(`${label}: more than one operation uses the operation ID "${operation.id}".`);
+		operationIDs.add(operation.id);
+	});
+	if (document.webhooks) ignored.add("webhooks");
+	return {
+		model: compact({
+			title: toText(info.title) ?? "API",
+			version: String(info.version ?? ""),
+			description: toText(info.description),
+			servers,
+			securitySchemes: Object.entries(toObject(components.securitySchemes)).map(([id, scheme]) => {
+				const raw = resolve(scheme);
+				return compact({
+					id,
+					type: String(raw.type),
+					description: toText(raw.description),
+					scheme: toText(raw.scheme),
+					bearerFormat: toText(raw.bearerFormat),
+					name: toText(raw.name),
+					in: toText(raw.in)
+				});
+			}),
+			tags,
+			operations,
+			schemas
+		}),
+		ignored: [...ignored]
+	};
+};
+//#endregion
+export { normalizeSpec as n, isObject as t };
+
+//# sourceMappingURL=normalize-DG5nxOLm.js.map

package/dist/chunks/normalize-DG5nxOLm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-DG5nxOLm.js","names":[],"sources":["../../src/sources/openapi/normalize.ts"],"sourcesContent":["import type {\n  ApiCodeSample,\n  ApiExample,\n  ApiHeader,\n  ApiMediaType,\n  ApiModel,\n  ApiOperation,\n  ApiParameter,\n  ApiRequestBody,\n  ApiResponse,\n  ApiSchema,\n  ApiServer,\n  ApiTag\n} from \"./model\";\n\ninterface NormalizedSpec {\n  model: ApiModel;\n  /** Spec features that the reference leaves out, for build warnings. */\n  ignored: string[];\n}\n\ntype RawObject = Record<string, unknown>;\n\n// OpenAPI ignores header parameters with these names; the spec sets them in other ways.\nconst reservedHeaders = [\"accept\", \"content-type\", \"authorization\"];\nconst methods = [\"get\", \"put\", \"post\", \"delete\", \"options\", \"head\", \"patch\", \"trace\"];\nconst constraintKeys = [\n  \"minimum\",\n  \"maximum\",\n  \"exclusiveMinimum\",\n  \"exclusiveMaximum\",\n  \"multipleOf\",\n  \"minLength\",\n  \"maxLength\",\n  \"pattern\",\n  \"minItems\",\n  \"maxItems\",\n  \"uniqueItems\",\n  \"minProperties\",\n  \"maxProperties\"\n];\nconst exclusiveKeys = [\n  [\"exclusiveMinimum\", \"minimum\"],\n  [\"exclusiveMaximum\", \"maximum\"]\n] as const;\nconst schemaPrefix = \"#/components/schemas/\";\n\nconst isObject = (value: unknown): value is RawObject => {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n};\nconst toObject = (value: unknown): RawObject => (isObject(value) ? value : {});\n/** Makes a label from an identifier-like tag name, e.g. `schemaMigrations` or `type-metadata`. */\nconst toTagLabel = (name: string): string => {\n  if (!/^[a-z][a-zA-Z\\d]*(?:[-_][a-zA-Z\\d]+)*$/.test(name)) return name;\n\n  const words = name\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .split(/[-_\\s]+/)\n    .join(\" \")\n    .toLowerCase();\n\n  return `${words[0]!.toUpperCase()}${words.slice(1)}`;\n};\nconst toText = (value: unknown): string | undefined => {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n};\n/** Removes `undefined` fields, so the stored model stays small. */\nconst compact = <T extends object>(value: T): T => {\n  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined)) as T;\n};\n/** Decodes URI escapes; keys can contain a bare `%`, which is not an escape. */\nconst decodeSegment = (segment: string): string => {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n};\nconst unescapeSegment = (segment: string): string => {\n  return decodeSegment(segment).replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\");\n};\n/** Reads a local JSON pointer, such as `#/components/schemas/Pet`. */\nconst readPointer = (document: RawObject, ref: string): unknown => {\n  return ref\n    .slice(2)\n    .split(\"/\")\n    .map(unescapeSegment)\n    .reduce<unknown>((value, key) => {\n      if (Array.isArray(value)) {\n        return /^(0|[1-9]\\d*)$/.test(key) ? value[Number(key)] : undefined;\n      }\n\n      return isObject(value) ? value[key] : undefined;\n    }, document);\n};\n/** Schema examples: 3.1 `examples`, or the 3.0 `example`. */\nconst toSchemaExamples = (raw: RawObject): unknown[] | undefined => {\n  if (Array.isArray(raw.examples)) return raw.examples;\n\n  return raw.example === undefined ? undefined : [raw.example];\n};\n/** Normalizes a spec; `label` names its source in errors. */\nconst normalizeSpec = (\n  document: RawObject,\n  label: string,\n  baseURL = \"https://api.example.com\"\n): NormalizedSpec => {\n  const info = toObject(document.info);\n  const components = toObject(document.components);\n  const schemas: Record<string, ApiSchema> = {};\n  const schemaNames = new Map<string, string>();\n  const usedNames = new Set<string>();\n  const ignored = new Set<string>();\n  const supportsSchemaSiblings = String(document.openapi).startsWith(\"3.1.\");\n  /** Follows references of parameters, responses, and other objects, which cannot recurse. */\n  const resolve = (value: unknown, depth = 0): RawObject => {\n    const ref = isObject(value) ? value.$ref : undefined;\n\n    if (typeof ref !== \"string\" || depth > 20) return toObject(value);\n\n    return resolve(readPointer(document, ref), depth + 1);\n  };\n  const toSchemaName = (ref: string): string => {\n    const base = ref.startsWith(schemaPrefix)\n      ? unescapeSegment(ref.slice(schemaPrefix.length))\n      : unescapeSegment(ref.split(\"/\").at(-1) ?? \"Schema\");\n\n    let name = base;\n\n    for (let index = 2; usedNames.has(name); index++) name = `${base}${index}`;\n\n    usedNames.add(name);\n\n    return name;\n  };\n  const toSchemaList = (value: unknown): ApiSchema[] | undefined => {\n    return Array.isArray(value) ? value.map(toSchema) : undefined;\n  };\n  /** Named schemas become references, so recursive schemas stay finite. */\n  const toSchema = (value: unknown): ApiSchema => {\n    if (value === true) return {};\n    if (value === false) return { not: {} };\n\n    const raw = toObject(value);\n\n    if (typeof raw.$ref === \"string\") {\n      let name = schemaNames.get(raw.$ref);\n\n      if (!name) {\n        name = toSchemaName(raw.$ref);\n        schemaNames.set(raw.$ref, name);\n        schemas[name] = {};\n        schemas[name] = toSchema(readPointer(document, raw.$ref));\n      }\n\n      const reference = compact({\n        ref: name,\n        description: toText(raw.description),\n        default: raw.default,\n        examples: toSchemaExamples(raw),\n        deprecated: raw.deprecated === true || undefined,\n        readOnly: raw.readOnly === true || undefined,\n        writeOnly: raw.writeOnly === true || undefined\n      });\n      const { $ref: _ref, ...siblings } = raw;\n      const schema = supportsSchemaSiblings ? toSchema(siblings) : {};\n      const hasConstraints = Object.keys(schema).some((key) => !(key in reference));\n\n      if (hasConstraints) {\n        return { ...schema, allOf: [{ ref: name }, ...(schema.allOf ?? [])] };\n      }\n\n      return reference;\n    }\n\n    const types = raw.type === undefined ? [] : [raw.type].flat().map(String);\n    const required = Array.isArray(raw.required) ? raw.required.map(String) : [];\n    const properties = isObject(raw.properties) ? Object.entries(raw.properties) : undefined;\n    const constraints = Object.fromEntries(\n      constraintKeys.filter((key) => raw[key] !== undefined).map((key) => [key, raw[key]])\n    );\n    const examples = toSchemaExamples(raw);\n\n    // OpenAPI 3.0 `nullable` has no effect without a `type`.\n    if (raw.nullable === true && types.length && !types.includes(\"null\")) types.push(\"null\");\n\n    // OpenAPI 3.0 makes `minimum` and `maximum` exclusive with booleans; 3.1 uses the limits.\n    for (const [exclusive, limit] of exclusiveKeys) {\n      if (typeof constraints[exclusive] !== \"boolean\") continue;\n\n      if (constraints[exclusive] && constraints[limit] !== undefined) {\n        constraints[exclusive] = constraints[limit];\n        delete constraints[limit];\n      } else {\n        delete constraints[exclusive];\n      }\n    }\n\n    return compact({\n      type: types.length ? types : undefined,\n      format: toText(raw.format),\n      contentMediaType: toText(raw.contentMediaType),\n      contentEncoding: toText(raw.contentEncoding),\n      title: toText(raw.title),\n      description: toText(raw.description),\n      enum: Array.isArray(raw.enum) ? raw.enum : undefined,\n      const: raw.const,\n      default: raw.default,\n      examples,\n      deprecated: raw.deprecated === true || undefined,\n      readOnly: raw.readOnly === true || undefined,\n      writeOnly: raw.writeOnly === true || undefined,\n      required: required.length ? required : undefined,\n      properties: properties?.map(([name, schema]) => {\n        return { name, required: required.includes(name), schema: toSchema(schema) };\n      }),\n      additionalProperties:\n        typeof raw.additionalProperties === \"boolean\"\n          ? raw.additionalProperties\n          : raw.additionalProperties === undefined\n            ? undefined\n            : toSchema(raw.additionalProperties),\n      items: raw.items === undefined ? undefined : toSchema(raw.items),\n      allOf: toSchemaList(raw.allOf),\n      oneOf: toSchemaList(raw.oneOf),\n      anyOf: toSchemaList(raw.anyOf),\n      not: raw.not === undefined ? undefined : toSchema(raw.not),\n      discriminator: isObject(raw.discriminator)\n        ? (raw.discriminator as ApiSchema[\"discriminator\"])\n        : undefined,\n      constraints: Object.keys(constraints).length ? constraints : undefined\n    });\n  };\n  const toExamples = (raw: RawObject): ApiExample[] => {\n    if (isObject(raw.examples)) {\n      return Object.entries(raw.examples).map(([name, example]) => {\n        const resolved = resolve(example);\n\n        return compact({ name, summary: toText(resolved.summary), value: resolved.value });\n      });\n    }\n\n    return raw.example === undefined ? [] : [{ value: raw.example }];\n  };\n  const toMediaTypes = (content: unknown): ApiMediaType[] => {\n    return Object.entries(toObject(content)).map(([type, media]) => {\n      const raw = resolve(media);\n\n      return compact({\n        type,\n        schema: raw.schema === undefined ? undefined : toSchema(raw.schema),\n        examples: toExamples(raw),\n        encoding: isObject(raw.encoding)\n          ? Object.fromEntries(\n              Object.entries(raw.encoding).map(([name, value]) => {\n                const encoding = toObject(value);\n\n                return [\n                  name,\n                  compact({\n                    contentType: toText(encoding.contentType),\n                    style: toText(encoding.style),\n                    explode: typeof encoding.explode === \"boolean\" ? encoding.explode : undefined\n                  })\n                ];\n              })\n            )\n          : undefined\n      });\n    });\n  };\n  const toParameter = (value: unknown): ApiParameter => {\n    const raw = resolve(value);\n    const [media] = toMediaTypes(raw.content);\n    const examples = toExamples(raw);\n\n    return compact({\n      name: String(raw.name),\n      in: raw.in as ApiParameter[\"in\"],\n      required: raw.in === \"path\" || raw.required === true,\n      deprecated: raw.deprecated === true,\n      description: toText(raw.description),\n      schema: raw.schema === undefined ? media?.schema : toSchema(raw.schema),\n      // A parameter with `content` can have its examples there.\n      examples: examples.length ? examples : (media?.examples ?? []),\n      mediaType: raw.schema === undefined ? media?.type : undefined,\n      style: toText(raw.style),\n      explode: typeof raw.explode === \"boolean\" ? raw.explode : undefined\n    });\n  };\n  /** Response headers; OpenAPI ignores a `Content-Type` header, which the content sets. */\n  const toHeaders = (headers: unknown): ApiHeader[] => {\n    const entries = Object.entries(toObject(headers)).filter(([name]) => {\n      return name.toLowerCase() !== \"content-type\";\n    });\n\n    return entries.map(([name, header]) => {\n      const raw = resolve(header);\n\n      return compact({\n        name,\n        required: raw.required === true,\n        description: toText(raw.description),\n        schema: raw.schema === undefined ? undefined : toSchema(raw.schema)\n      });\n    });\n  };\n  const toRequestBody = (value: unknown): ApiRequestBody => {\n    const raw = resolve(value);\n\n    return compact({\n      required: raw.required === true,\n      description: toText(raw.description),\n      contents: toMediaTypes(raw.content)\n    });\n  };\n  const toResponses = (responses: unknown): ApiResponse[] => {\n    const entries = Object.entries(toObject(responses)).filter(\n      ([status]) => !status.startsWith(\"x-\")\n    );\n\n    return entries.map(([status, response]) => {\n      const raw = resolve(response);\n\n      return compact({\n        status,\n        description: toText(raw.description),\n        headers: toHeaders(raw.headers),\n        contents: toMediaTypes(raw.content)\n      });\n    });\n  };\n  const toServers = (value: unknown): ApiServer[] | undefined => {\n    return Array.isArray(value)\n      ? value.map((server) => {\n          const raw = toObject(server);\n          const variables = toObject(raw.variables);\n          // Variables, e.g. `{region}`, take their default values.\n          const url = String(raw.url).replace(/\\{([^}]+)\\}/g, (match, name: string) => {\n            const value = toObject(variables[name]).default;\n\n            return value === undefined ? match : String(value);\n          });\n\n          return compact({ url: new URL(url, baseURL).href, description: toText(raw.description) });\n        })\n      : undefined;\n  };\n  const toCodeSamples = (raw: RawObject): ApiCodeSample[] => {\n    const samples = raw[\"x-codeSamples\"] ?? raw[\"x-code-samples\"];\n\n    return (Array.isArray(samples) ? samples : []).filter(isObject).map((sample) => {\n      const lang = String(sample.lang);\n\n      return { lang, label: toText(sample.label) ?? lang, source: String(sample.source) };\n    });\n  };\n  const servers = toServers(document.servers) ?? [];\n  const operations = Object.entries(toObject(document.paths)).flatMap(([path, item]) => {\n    const pathItem = resolve(item);\n    const pathParameters = Array.isArray(pathItem.parameters) ? pathItem.parameters : [];\n\n    return methods.flatMap((method): ApiOperation[] => {\n      const raw = pathItem[method];\n\n      if (!isObject(raw)) return [];\n\n      if (raw.callbacks) ignored.add(\"callbacks\");\n\n      const parameters = new Map<string, ApiParameter>();\n      const operationParameters = Array.isArray(raw.parameters) ? raw.parameters : [];\n\n      // Operation parameters replace path parameters with the same name and place.\n      [...pathParameters, ...operationParameters].map(toParameter).forEach((parameter) => {\n        const isHeader = parameter.in === \"header\";\n        const name = isHeader ? parameter.name.toLowerCase() : parameter.name;\n\n        if (isHeader && reservedHeaders.includes(name)) return;\n\n        parameters.set(`${parameter.in}:${name}`, parameter);\n      });\n\n      return [\n        compact({\n          id: toText(raw.operationId) ?? `${method.toUpperCase()} ${path}`,\n          method,\n          path,\n          summary: toText(raw.summary),\n          description: toText(raw.description),\n          deprecated: raw.deprecated === true,\n          tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],\n          parameters: [...parameters.values()],\n          requestBody: raw.requestBody === undefined ? undefined : toRequestBody(raw.requestBody),\n          responses: toResponses(raw.responses),\n          security: (Array.isArray(raw.security)\n            ? raw.security\n            : (document.security ?? [])) as Array<Record<string, string[]>>,\n          servers: toServers(raw.servers) ?? toServers(pathItem.servers) ?? servers,\n          codeSamples: toCodeSamples(raw),\n          extensions: Object.fromEntries(\n            Object.entries(raw).filter(([key]) => {\n              return key.startsWith(\"x-\") && key !== \"x-codeSamples\" && key !== \"x-code-samples\";\n            })\n          )\n        })\n      ];\n    });\n  });\n  const declaredTags = (Array.isArray(document.tags) ? document.tags : [])\n    .filter(isObject)\n    .map((tag): ApiTag => {\n      const name = String(tag.name);\n\n      return compact({\n        name,\n        label: toText(tag[\"x-displayName\"]) ?? toTagLabel(name),\n        description: toText(tag.description)\n      });\n    });\n  const operationIDs = new Set<string>();\n  // Operations show in their first tag only, so other tags make no groups.\n  const usedTags = new Set(operations.flatMap((operation) => operation.tags.slice(0, 1)));\n  const tags = [\n    ...declaredTags.filter((tag) => usedTags.has(tag.name)),\n    ...[...usedTags]\n      .filter((name) => !declaredTags.some((tag) => tag.name === name))\n      .map((name) => ({ name, label: toTagLabel(name) }))\n  ];\n\n  operations.forEach((operation) => {\n    if (operationIDs.has(operation.id)) {\n      throw new Error(`${label}: more than one operation uses the operation ID \"${operation.id}\".`);\n    }\n\n    operationIDs.add(operation.id);\n  });\n\n  if (document.webhooks) ignored.add(\"webhooks\");\n\n  return {\n    model: compact({\n      title: toText(info.title) ?? \"API\",\n      version: String(info.version ?? \"\"),\n      description: toText(info.description),\n      servers,\n      securitySchemes: Object.entries(toObject(components.securitySchemes)).map(([id, scheme]) => {\n        const raw = resolve(scheme);\n\n        return compact({\n          id,\n          type: String(raw.type),\n          description: toText(raw.description),\n          scheme: toText(raw.scheme),\n          bearerFormat: toText(raw.bearerFormat),\n          name: toText(raw.name),\n          in: toText(raw.in)\n        });\n      }),\n      tags,\n      operations,\n      schemas\n    }),\n    ignored: [...ignored]\n  };\n};\n\nexport { normalizeSpec, isObject };\nexport type { NormalizedSpec };\n"],"mappings":"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"}

package/dist/chunks/paths-75QgA3Qs.js

@@ -0,0 +1,16 @@
+//#region src/routing/paths.ts
+/** Splits a decoded path, such as `/guides/intro/` or `guides/intro`, into segments. */
+const toSegments = (path, label) => {
+	const segments = path.split("/").filter(Boolean);
+	if (segments.some((segment) => /^\.\.?$|[\\?#%]/.test(segment))) throw new Error(`${label}: "${path}" is not a valid path. Do not use ., .., \\, ?, #, or %.`);
+	return segments;
+};
+/** Joins decoded segments into an encoded URL path with a trailing slash. */
+const toHref = (...segments) => {
+	const parts = segments.flat().map(encodeURIComponent);
+	return parts.length ? `/${parts.join("/")}/` : "/";
+};
+//#endregion
+export { toSegments as n, toHref as t };
+
+//# sourceMappingURL=paths-75QgA3Qs.js.map

package/dist/chunks/paths-75QgA3Qs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-75QgA3Qs.js","names":[],"sources":["../../src/routing/paths.ts"],"sourcesContent":["/** Splits a decoded path, such as `/guides/intro/` or `guides/intro`, into segments. */\nconst toSegments = (path: string, label: string): string[] => {\n  const segments = path.split(\"/\").filter(Boolean);\n  const invalid = segments.some((segment) => /^\\.\\.?$|[\\\\?#%]/.test(segment));\n\n  if (invalid) {\n    throw new Error(`${label}: \"${path}\" is not a valid path. Do not use ., .., \\\\, ?, #, or %.`);\n  }\n\n  return segments;\n};\n/** Joins decoded segments into an encoded URL path with a trailing slash. */\nconst toHref = (...segments: string[][]): string => {\n  const parts = segments.flat().map(encodeURIComponent);\n\n  return parts.length ? `/${parts.join(\"/\")}/` : \"/\";\n};\n\nexport { toSegments, toHref };\n"],"mappings":";;AACA,MAAM,cAAc,MAAc,UAA4B;CAC5D,MAAM,WAAW,KAAK,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;CAG/C,IAFgB,SAAS,MAAM,YAAY,kBAAkB,KAAK,OAAO,CAE/D,GACR,MAAM,IAAI,MAAM,GAAG,MAAM,KAAK,KAAK,yDAAyD;CAG9F,OAAO;AACT;;AAEA,MAAM,UAAU,GAAG,aAAiC;CAClD,MAAM,QAAQ,SAAS,KAAK,CAAC,CAAC,IAAI,kBAAkB;CAEpD,OAAO,MAAM,SAAS,IAAI,MAAM,KAAK,GAAG,EAAE,KAAK;AACjD"}