@andesine/pages 0.0.0-stage → 0.6.0

package/dist/client.js

@@ -0,0 +1,295 @@
+import { i as toSearchItems, n as readErrorData, r as toAnswerSources, t as isRateLimited } from "./chunks/limits-Ppc7BQPG.js";
+import { readAnswerStream } from "@andesine/sdk/streaming";
+import { Renderer, marked } from "marked";
+//#region src/search/entry-pages.ts
+const loaded = /* @__PURE__ */ new Map();
+/** Loads the map from entry IDs to page URLs that the build writes for a source. */
+const loadEntryPages = (url) => {
+	if (!loaded.has(url)) {
+		const resolver = fetch(url).then(async (response) => {
+			if (!response.ok) throw new Error("Search is not available now.");
+			const hrefs = await response.json();
+			return (result) => hrefs[result.entryID];
+		});
+		loaded.set(url, resolver);
+		resolver.catch(() => loaded.delete(url));
+	}
+	return loaded.get(url);
+};
+//#endregion
+//#region src/search/answer-client.ts
+/** The API accepts 10 history messages of up to 4,000 characters. */
+const toMessages = (turns) => {
+	return turns.flatMap((turn) => {
+		return [{
+			role: "user",
+			content: turn.question.slice(0, 4e3)
+		}, {
+			role: "assistant",
+			content: turn.answer?.text.slice(0, 4e3) ?? ""
+		}];
+	}).filter((message) => message.content.trim()).slice(-10);
+};
+/** Groups answer sources by page, in order. */
+const groupAnswerSources = (sources) => {
+	const groups = /* @__PURE__ */ new Map();
+	for (const source of sources) {
+		const page = source.href.split("#")[0];
+		const group = groups.get(page);
+		if (group) group.sources.push(source);
+		else groups.set(page, {
+			href: source.href,
+			sources: [source]
+		});
+	}
+	return [...groups.values()];
+};
+const readLines = async function* (body) {
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			const lines = buffer.split("\n");
+			buffer = lines.pop() ?? "";
+			yield* lines.filter(Boolean);
+		}
+	} finally {
+		await reader.cancel().catch(() => {});
+	}
+};
+/** Streams the events of the site's answers route. */
+const readServerEvents = async function* (context, question, history, signal) {
+	const response = await fetch(context.endpoint, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			source: context.source,
+			question,
+			history: toMessages(history)
+		}),
+		signal
+	});
+	if (!response.ok || !response.body) {
+		const body = await response.json().catch(() => ({}));
+		throw new Error(body.error ?? "AI answers are not available now.");
+	}
+	for await (const line of readLines(response.body)) yield JSON.parse(line);
+};
+/** Streams the events of the Andesine API with a publishable key, and links the cited pages. */
+const readAPIEvents = async function* (api, question, history, signal) {
+	const [resolve, response] = await Promise.all([loadEntryPages(api.pages), fetch(`${api.url}/search/published/ask/stream`, {
+		method: "POST",
+		headers: {
+			"Authorization": `Bearer ${api.key}`,
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify({
+			question,
+			history: toMessages(history),
+			collectionID: api.collection,
+			channel: "published"
+		}),
+		signal
+	})]);
+	if (!response.ok) throw new Error(isRateLimited(response.status, await readErrorData(response)) ? "Too many questions. Try again soon." : "AI answers are not available now.");
+	try {
+		for await (const event of await readAnswerStream(response, { signal })) if (event.type === "textDelta") yield {
+			type: "textDelta",
+			text: event.text
+		};
+		else if (event.type === "sources") yield {
+			type: "sources",
+			sources: toAnswerSources(event.sources, resolve)
+		};
+		else yield {
+			type: "completed",
+			answer: event.answer,
+			sources: toAnswerSources(event.sources, resolve)
+		};
+	} catch (error) {
+		signal.throwIfAborted();
+		console.error(error);
+		throw new Error("The answer could not be completed.");
+	}
+};
+const createAnswerClient = (context) => {
+	return { ask: async (question, history, signal, onUpdate) => {
+		const events = context.api ? readAPIEvents(context.api, question, history, signal) : readServerEvents(context, question, history, signal);
+		let answer = {
+			text: "",
+			sources: [],
+			sourcesReceived: false
+		};
+		for await (const event of events) {
+			if (event.type === "error") throw new Error(event.error);
+			if (event.type === "sources") answer = {
+				...answer,
+				sources: event.sources,
+				sourcesReceived: true
+			};
+			else if (event.type === "textDelta") answer = {
+				...answer,
+				text: answer.text + event.text
+			};
+			else answer = {
+				text: event.answer,
+				sources: event.sources,
+				sourcesReceived: true
+			};
+			onUpdate(answer);
+			if (event.type === "completed") return answer;
+		}
+		signal.throwIfAborted();
+		throw new Error("The answer ended before completion. Try again.");
+	} };
+};
+//#endregion
+//#region src/search/markdown.ts
+const escapeHTML = (value) => {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+};
+const isRelative = (href) => href.startsWith("#") || /^\/(?!\/)/.test(href);
+const isSafeLink = (href) => {
+	if (isRelative(href)) return true;
+	try {
+		return [
+			"http:",
+			"https:",
+			"mailto:"
+		].includes(new URL(href).protocol);
+	} catch {
+		return false;
+	}
+};
+const renderer = new Renderer();
+/** Links `[n]` references to the cited pages; references without a page stay text. */
+const linkReferences = (answer) => {
+	const hrefs = new Map(answer.sources.map((source) => [String(source.id), source.href]));
+	return answer.text.replace(/\[(\d+)\](?!\()/g, (reference, id) => {
+		const href = hrefs.get(id);
+		return href ? `[${reference}](${href})` : reference;
+	});
+};
+/**
+* Renders answer Markdown to HTML. Raw HTML and images become text, and only relative, web
+* and mail links stay links, so the result is safe for `innerHTML`.
+*/
+const renderAnswer = (answer) => {
+	return marked.parse(linkReferences(answer), {
+		async: false,
+		breaks: true,
+		gfm: true,
+		renderer
+	});
+};
+renderer.html = ({ text }) => escapeHTML(text);
+renderer.image = ({ text }) => escapeHTML(text);
+renderer.link = function({ href, title, tokens }) {
+	const label = this.parser.parseInline(tokens);
+	if (!isSafeLink(href)) return label;
+	const titleAttribute = title ? ` title="${escapeHTML(title)}"` : "";
+	const externalAttributes = isRelative(href) ? "" : " target=\"_blank\" rel=\"noopener noreferrer\"";
+	return `<a href="${escapeHTML(href)}"${titleAttribute}${externalAttributes}>${label}</a>`;
+};
+//#endregion
+//#region src/client.ts
+const limit = 8;
+/** Removes the `<mark>` and other tags from Pagefind excerpts. */
+const toText = (html) => {
+	return new DOMParser().parseFromString(html, "text/html").body.textContent ?? "";
+};
+const createSearchClient = (context) => {
+	let pagefind;
+	const loadPagefind = () => {
+		pagefind ??= import(
+			/* @vite-ignore */
+			`${context.pagefind}pagefind.js`
+).then(async (module) => {
+			await module.options({ baseUrl: context.pagefind.replace(/pagefind\/$/, "") });
+			return module;
+		}, (error) => {
+			pagefind = void 0;
+			throw error;
+		});
+		return pagefind;
+	};
+	const searchPagefind = async (source, query) => {
+		const found = await (await loadPagefind()).search(query, { filters: { source: source.id } });
+		return Promise.all((found?.results ?? []).slice(0, limit).map(async (result) => {
+			const data = await result.data();
+			const section = data.sub_results?.find((item) => item.url !== data.url);
+			return {
+				id: result.id,
+				href: section?.url ?? data.url,
+				title: data.meta.title ?? "Untitled",
+				excerpt: toText(section?.excerpt ?? data.excerpt),
+				headingPath: section ? [section.title] : []
+			};
+		}));
+	};
+	const searchAPI = async (api, query, signal) => {
+		const [resolve, response] = await Promise.all([loadEntryPages(api.pages), fetch(`${api.url}/search/published`, {
+			method: "POST",
+			headers: {
+				"Authorization": `Bearer ${api.key}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				query,
+				collectionID: api.collection,
+				channel: "published",
+				limit
+			}),
+			signal
+		})]);
+		if (!response.ok) throw new Error(isRateLimited(response.status, await readErrorData(response)) ? "Too many searches. Try again soon." : "Search is not available now.");
+		const { results } = await response.json();
+		return toSearchItems(results, resolve);
+	};
+	const searchAndesine = async (source, query, signal) => {
+		if (source.api) return searchAPI(source.api, query, signal);
+		const response = await fetch(context.endpoint, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				source: source.id,
+				query,
+				limit
+			}),
+			signal
+		});
+		const body = await response.json().catch(() => ({}));
+		if (!response.ok) throw new Error(body.error ?? "Search is not available now.");
+		return body.items ?? [];
+	};
+	return { search: (query, signal) => {
+		return Promise.all(context.sources.map(async (source) => {
+			const group = {
+				sourceID: source.id,
+				label: source.label
+			};
+			try {
+				const items = source.type === "pagefind" ? await searchPagefind(source, query) : await searchAndesine(source, query, signal);
+				return {
+					...group,
+					items
+				};
+			} catch (error) {
+				signal.throwIfAborted();
+				return {
+					...group,
+					items: [],
+					error: error.message
+				};
+			}
+		}));
+	} };
+};
+//#endregion
+export { createAnswerClient, createSearchClient, groupAnswerSources, renderAnswer };
+
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/search/entry-pages.ts","../src/search/answer-client.ts","../src/search/markdown.ts","../src/client.ts"],"sourcesContent":["import type { PageResolver } from \"./items\";\n\n// Each map loads once for each page view; a failed load is tried again on the next search.\nconst loaded = new Map<string, Promise<PageResolver>>();\n\n/** Loads the map from entry IDs to page URLs that the build writes for a source. */\nconst loadEntryPages = (url: string): Promise<PageResolver> => {\n  if (!loaded.has(url)) {\n    const resolver = fetch(url).then(async (response): Promise<PageResolver> => {\n      if (!response.ok) throw new Error(\"Search is not available now.\");\n\n      const hrefs = (await response.json()) as Record<string, string>;\n\n      return (result) => hrefs[result.entryID];\n    });\n\n    loaded.set(url, resolver);\n    resolver.catch(() => loaded.delete(url));\n  }\n\n  return loaded.get(url)!;\n};\n\nexport { loadEntryPages };\n","import { readAnswerStream } from \"@andesine/sdk/streaming\";\nimport type { AndesineAPIContext, AnswersContext } from \"../context\";\nimport { loadEntryPages } from \"./entry-pages\";\nimport { toAnswerSources } from \"./items\";\nimport { isRateLimited, readErrorData } from \"./limits\";\nimport type { Answer, AnswerEvent, AnswerMessage, AnswerSource } from \"./types\";\n\ninterface AnswerHistoryTurn {\n  question: string;\n  answer?: Pick<Answer, \"text\">;\n}\n\ninterface AnswerSourceGroup {\n  /** The page of the first source. */\n  href: string;\n  sources: AnswerSource[];\n}\n\ninterface AnswerClient {\n  /**\n   * Streams an answer and calls `onUpdate` for each change. `history` holds the earlier turns,\n   * for follow-up questions. Resolves with the completed answer; aborting the signal cancels it.\n   */\n  ask(\n    question: string,\n    history: AnswerHistoryTurn[],\n    signal: AbortSignal,\n    onUpdate: (answer: Answer) => void\n  ): Promise<Answer>;\n}\n\n/** The API accepts 10 history messages of up to 4,000 characters. */\nconst toMessages = (turns: AnswerHistoryTurn[]): AnswerMessage[] => {\n  return turns\n    .flatMap((turn): AnswerMessage[] => {\n      return [\n        { role: \"user\", content: turn.question.slice(0, 4000) },\n        { role: \"assistant\", content: turn.answer?.text.slice(0, 4000) ?? \"\" }\n      ];\n    })\n    .filter((message) => message.content.trim())\n    .slice(-10);\n};\n/** Groups answer sources by page, in order. */\nconst groupAnswerSources = (sources: AnswerSource[]): AnswerSourceGroup[] => {\n  const groups = new Map<string, AnswerSourceGroup>();\n\n  for (const source of sources) {\n    const page = source.href.split(\"#\")[0]!;\n    const group = groups.get(page);\n\n    if (group) {\n      group.sources.push(source);\n    } else {\n      groups.set(page, { href: source.href, sources: [source] });\n    }\n  }\n\n  return [...groups.values()];\n};\nconst readLines = async function* (body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  let buffer = \"\";\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split(\"\\n\");\n\n      buffer = lines.pop() ?? \"\";\n      yield* lines.filter(Boolean);\n    }\n  } finally {\n    await reader.cancel().catch(() => {});\n  }\n};\n/** Streams the events of the site's answers route. */\nconst readServerEvents = async function* (\n  context: AnswersContext,\n  question: string,\n  history: AnswerHistoryTurn[],\n  signal: AbortSignal\n): AsyncGenerator<AnswerEvent> {\n  const response = await fetch(context.endpoint, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ source: context.source, question, history: toMessages(history) }),\n    signal\n  });\n\n  if (!response.ok || !response.body) {\n    const body = (await response.json().catch(() => ({}))) as { error?: string };\n\n    throw new Error(body.error ?? \"AI answers are not available now.\");\n  }\n\n  for await (const line of readLines(response.body)) yield JSON.parse(line) as AnswerEvent;\n};\n/** Streams the events of the Andesine API with a publishable key, and links the cited pages. */\nconst readAPIEvents = async function* (\n  api: AndesineAPIContext,\n  question: string,\n  history: AnswerHistoryTurn[],\n  signal: AbortSignal\n): AsyncGenerator<AnswerEvent> {\n  const [resolve, response] = await Promise.all([\n    loadEntryPages(api.pages),\n    fetch(`${api.url}/search/published/ask/stream`, {\n      method: \"POST\",\n      headers: { \"Authorization\": `Bearer ${api.key}`, \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        question,\n        history: toMessages(history),\n        collectionID: api.collection,\n        channel: \"published\"\n      }),\n      signal\n    })\n  ]);\n\n  if (!response.ok) {\n    throw new Error(\n      isRateLimited(response.status, await readErrorData(response))\n        ? \"Too many questions. Try again soon.\"\n        : \"AI answers are not available now.\"\n    );\n  }\n\n  try {\n    for await (const event of await readAnswerStream(response, { signal })) {\n      if (event.type === \"textDelta\") {\n        yield { type: \"textDelta\", text: event.text };\n      } else if (event.type === \"sources\") {\n        yield { type: \"sources\", sources: toAnswerSources(event.sources, resolve) };\n      } else {\n        yield {\n          type: \"completed\",\n          answer: event.answer,\n          sources: toAnswerSources(event.sources, resolve)\n        };\n      }\n    }\n  } catch (error) {\n    signal.throwIfAborted();\n    console.error(error);\n    throw new Error(\"The answer could not be completed.\");\n  }\n};\nconst createAnswerClient = (context: AnswersContext): AnswerClient => {\n  return {\n    ask: async (question, history, signal, onUpdate) => {\n      const events = context.api\n        ? readAPIEvents(context.api, question, history, signal)\n        : readServerEvents(context, question, history, signal);\n\n      let answer: Answer = { text: \"\", sources: [], sourcesReceived: false };\n\n      for await (const event of events) {\n        if (event.type === \"error\") throw new Error(event.error);\n\n        if (event.type === \"sources\") {\n          answer = { ...answer, sources: event.sources, sourcesReceived: true };\n        } else if (event.type === \"textDelta\") {\n          answer = { ...answer, text: answer.text + event.text };\n        } else {\n          answer = { text: event.answer, sources: event.sources, sourcesReceived: true };\n        }\n\n        onUpdate(answer);\n\n        if (event.type === \"completed\") return answer;\n      }\n\n      signal.throwIfAborted();\n      throw new Error(\"The answer ended before completion. Try again.\");\n    }\n  };\n};\n\nexport { createAnswerClient, groupAnswerSources };\nexport type { AnswerClient, AnswerHistoryTurn, AnswerSourceGroup };\n","import { marked, Renderer, type Tokens } from \"marked\";\nimport type { Answer } from \"./types\";\n\nconst escapeHTML = (value: string): string => {\n  return value\n    .replaceAll(\"&\", \"&amp;\")\n    .replaceAll(\"<\", \"&lt;\")\n    .replaceAll(\">\", \"&gt;\")\n    .replaceAll('\"', \"&quot;\")\n    .replaceAll(\"'\", \"&#39;\");\n};\nconst isRelative = (href: string): boolean => href.startsWith(\"#\") || /^\\/(?!\\/)/.test(href);\nconst isSafeLink = (href: string): boolean => {\n  if (isRelative(href)) return true;\n\n  try {\n    return [\"http:\", \"https:\", \"mailto:\"].includes(new URL(href).protocol);\n  } catch {\n    return false;\n  }\n};\nconst renderer = new Renderer();\n/** Links `[n]` references to the cited pages; references without a page stay text. */\nconst linkReferences = (answer: Answer): string => {\n  const hrefs = new Map(answer.sources.map((source) => [String(source.id), source.href]));\n\n  return answer.text.replace(/\\[(\\d+)\\](?!\\()/g, (reference, id: string) => {\n    const href = hrefs.get(id);\n\n    return href ? `[${reference}](${href})` : reference;\n  });\n};\n/**\n * Renders answer Markdown to HTML. Raw HTML and images become text, and only relative, web\n * and mail links stay links, so the result is safe for `innerHTML`.\n */\nconst renderAnswer = (answer: Answer): string => {\n  return marked.parse(linkReferences(answer), { async: false, breaks: true, gfm: true, renderer });\n};\n\nrenderer.html = ({ text }: Tokens.HTML | Tokens.Tag): string => escapeHTML(text);\nrenderer.image = ({ text }: Tokens.Image): string => escapeHTML(text);\nrenderer.link = function ({ href, title, tokens }: Tokens.Link): string {\n  const label = this.parser.parseInline(tokens);\n\n  if (!isSafeLink(href)) return label;\n\n  const titleAttribute = title ? ` title=\"${escapeHTML(title)}\"` : \"\";\n  const externalAttributes = isRelative(href) ? \"\" : ' target=\"_blank\" rel=\"noopener noreferrer\"';\n\n  return `<a href=\"${escapeHTML(href)}\"${titleAttribute}${externalAttributes}>${label}</a>`;\n};\n\nexport { renderAnswer };\n","import type { AndesineAPIContext, SearchContext, SearchSourceContext } from \"./context\";\nimport { loadEntryPages } from \"./search/entry-pages\";\nimport { toSearchItems } from \"./search/items\";\nimport { isRateLimited, readErrorData } from \"./search/limits\";\nimport type { SearchGroup, SearchItem } from \"./search/types\";\n\ninterface SearchClient {\n  /** Searches all sources. Aborting the signal cancels the pending requests. */\n  search(query: string, signal: AbortSignal): Promise<SearchGroup[]>;\n}\n\ninterface Pagefind {\n  options(options: { baseUrl: string }): Promise<void>;\n  search(\n    query: string,\n    options: { filters: Record<string, string> }\n  ): Promise<{ results: Array<{ id: string; data(): Promise<PagefindResultData> }> } | null>;\n}\n\ninterface PagefindResultData {\n  url: string;\n  excerpt: string;\n  meta: { title?: string };\n  sub_results?: Array<{ url: string; title: string; excerpt: string }>;\n}\n\nconst limit = 8;\n\n/** Removes the `<mark>` and other tags from Pagefind excerpts. */\nconst toText = (html: string): string => {\n  return new DOMParser().parseFromString(html, \"text/html\").body.textContent ?? \"\";\n};\nconst createSearchClient = (context: SearchContext): SearchClient => {\n  let pagefind: Promise<Pagefind> | undefined;\n\n  const loadPagefind = (): Promise<Pagefind> => {\n    pagefind ??= import(/* @vite-ignore */ `${context.pagefind}pagefind.js`).then(\n      async (module: Pagefind) => {\n        await module.options({ baseUrl: context.pagefind.replace(/pagefind\\/$/, \"\") });\n\n        return module;\n      },\n      (error) => {\n        pagefind = undefined;\n        throw error;\n      }\n    );\n\n    return pagefind;\n  };\n  const searchPagefind = async (\n    source: SearchSourceContext,\n    query: string\n  ): Promise<SearchItem[]> => {\n    const found = await (await loadPagefind()).search(query, { filters: { source: source.id } });\n\n    return Promise.all(\n      (found?.results ?? []).slice(0, limit).map(async (result) => {\n        const data = await result.data();\n        // The first sub-result is the best matching section of the page.\n        const section = data.sub_results?.find((item) => item.url !== data.url);\n\n        return {\n          id: result.id,\n          href: section?.url ?? data.url,\n          title: data.meta.title ?? \"Untitled\",\n          excerpt: toText(section?.excerpt ?? data.excerpt),\n          headingPath: section ? [section.title] : []\n        };\n      })\n    );\n  };\n  // With a publishable key, the browser searches through the API, and links results itself.\n  const searchAPI = async (\n    api: AndesineAPIContext,\n    query: string,\n    signal: AbortSignal\n  ): Promise<SearchItem[]> => {\n    const [resolve, response] = await Promise.all([\n      loadEntryPages(api.pages),\n      fetch(`${api.url}/search/published`, {\n        method: \"POST\",\n        headers: { \"Authorization\": `Bearer ${api.key}`, \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ query, collectionID: api.collection, channel: \"published\", limit }),\n        signal\n      })\n    ]);\n\n    if (!response.ok) {\n      throw new Error(\n        isRateLimited(response.status, await readErrorData(response))\n          ? \"Too many searches. Try again soon.\"\n          : \"Search is not available now.\"\n      );\n    }\n\n    const { results } = (await response.json()) as { results: Parameters<typeof toSearchItems>[0] };\n\n    return toSearchItems(results, resolve);\n  };\n  const searchAndesine = async (\n    source: SearchSourceContext,\n    query: string,\n    signal: AbortSignal\n  ): Promise<SearchItem[]> => {\n    if (source.api) return searchAPI(source.api, query, signal);\n\n    const response = await fetch(context.endpoint, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ source: source.id, query, limit }),\n      signal\n    });\n    const body = (await response.json().catch(() => ({}))) as {\n      items?: SearchItem[];\n      error?: string;\n    };\n\n    if (!response.ok) throw new Error(body.error ?? \"Search is not available now.\");\n\n    return body.items ?? [];\n  };\n\n  return {\n    search: (query, signal) => {\n      return Promise.all(\n        context.sources.map(async (source): Promise<SearchGroup> => {\n          const group = { sourceID: source.id, label: source.label };\n\n          try {\n            const items =\n              source.type === \"pagefind\"\n                ? await searchPagefind(source, query)\n                : await searchAndesine(source, query, signal);\n\n            return { ...group, items };\n          } catch (error) {\n            signal.throwIfAborted();\n\n            return { ...group, items: [], error: (error as Error).message };\n          }\n        })\n      );\n    }\n  };\n};\n\nexport { createSearchClient };\nexport { createAnswerClient, groupAnswerSources } from \"./search/answer-client\";\nexport { renderAnswer } from \"./search/markdown\";\nexport type { SearchClient };\nexport type { AnswerClient, AnswerHistoryTurn, AnswerSourceGroup } from \"./search/answer-client\";\nexport type { SearchGroup, SearchItem, Answer, AnswerSource, AnswerMessage } from \"./search/types\";\n"],"mappings":"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"}

package/dist/collections.d.ts

@@ -0,0 +1,7 @@
+//#region src/collections.d.ts
+declare const collections: {
+  [k: string]: any;
+};
+//#endregion
+export { collections };
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.js

@@ -0,0 +1,215 @@
+import { a as mimeTypes, i as getDeliveryURL, r as getAssetPrefix } from "./chunks/assets-D6WJmZ05.js";
+import { t as toSHA256 } from "./chunks/hash-D4piIIQ6.js";
+import { n as recordID, r as createAndesinePages } from "./chunks/stored-CabomV-C.js";
+import { n as readPublication } from "./chunks/read-DCv1lmcM.js";
+import { n as normalizeSpec } from "./chunks/normalize-DG5nxOLm.js";
+import { r as recordID$1 } from "./chunks/stored-CcEfvCQH.js";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { mkdir, writeFile } from "node:fs/promises";
+import config, { highlight } from "virtual:andesine/config";
+import { defineCollection } from "astro/content/config";
+import { glob } from "astro/loaders";
+import { z } from "astro/zod";
+import { bundle } from "@scalar/json-magic/bundle";
+import { fetchUrls, parseJson, parseYaml, readFiles } from "@scalar/json-magic/bundle/plugins/node";
+import { validate } from "@scalar/openapi-parser";
+//#region src/sources/andesine/asset-cache.ts
+/**
+* Downloads images into a cache directory with content-hash names. The build copies them to
+* the output, so pages do not depend on expiring delivery URLs.
+*/
+const createAssetCache = (directory, base) => {
+	const prefix = getAssetPrefix(base);
+	const files = /* @__PURE__ */ new Set();
+	const downloads = /* @__PURE__ */ new Map();
+	const download = async (asset, entryID) => {
+		const label = `Entry ${entryID}, asset ${asset.assetID}`;
+		const response = await fetch(getDeliveryURL(asset, entryID), {
+			credentials: "omit",
+			signal: AbortSignal.timeout(3e4)
+		});
+		const type = response.headers.get("content-type")?.split(";")[0];
+		if (!response.ok) throw new Error(`${label}: download failed (${response.status}).`);
+		if (type !== mimeTypes[asset.format]) throw new Error(`${label}: unexpected type ${type}.`);
+		const bytes = new Uint8Array(await response.arrayBuffer());
+		const file = `${await toSHA256(bytes)}.${asset.format}`;
+		await mkdir(directory, { recursive: true });
+		await writeFile(new URL(file, directory), bytes);
+		files.add(file);
+		return `${prefix}${file}`;
+	};
+	return {
+		resolve: (asset, entryID) => {
+			const key = `${asset.assetID}:${asset.variant}`;
+			if (!downloads.has(key)) downloads.set(key, download(asset, entryID));
+			return downloads.get(key);
+		},
+		finish: async () => {
+			await mkdir(directory, { recursive: true });
+			await writeFile(new URL("files.json", directory), JSON.stringify([...files]));
+		}
+	};
+};
+//#endregion
+//#region src/sources/andesine/collection.ts
+/** Reads the latest publication at build time, and copies its images into the build. */
+const createAndesineCollection = (source, base, site, highlight) => {
+	return defineCollection({ loader: {
+		name: `andesine-${source.id}`,
+		load: async ({ store, config, logger }) => {
+			const assets = createAssetCache(new URL(`andesine/${source.id}/`, config.cacheDir), base);
+			const { tree, entries } = await readPublication(source);
+			const pages = await createAndesinePages(source, tree.collection, entries, {
+				base,
+				site,
+				assets,
+				highlight
+			});
+			const stored = {
+				tree: tree.collection,
+				pages
+			};
+			await assets.finish();
+			store.clear();
+			store.set({
+				id: recordID,
+				data: stored
+			});
+			logger.info(`Source "${source.id}": loaded ${pages.length} published pages.`);
+		}
+	} });
+};
+//#endregion
+//#region src/sources/files/schema.ts
+const fileSchema = z.object({
+	title: z.string().trim().min(1),
+	description: z.string().trim().min(1).optional(),
+	/** Replaces the path from the file location, relative to the source mount. */
+	slug: z.string().trim().optional(),
+	navigationLabel: z.string().trim().min(1).optional(),
+	navigationHidden: z.boolean().default(false),
+	searchHidden: z.boolean().default(false),
+	/** Lower numbers come first. Items with the same order sort by path. */
+	order: z.number().default(0),
+	toc: z.boolean().default(true),
+	layout: z.enum(["docs", "wide"]).default("docs"),
+	/** The date of the last change, e.g. `2026-09-27`, for the page footer and the sitemap. */
+	updatedAt: z.coerce.date().optional()
+}).strict();
+//#endregion
+//#region src/sources/files/collection.ts
+const createFilesCollection = (source) => {
+	return defineCollection({
+		loader: glob({
+			base: source.directory,
+			pattern: "**/*.{md,mdx}",
+			generateId: ({ entry }) => entry
+		}),
+		schema: fileSchema
+	});
+};
+//#endregion
+//#region src/sources/openapi/read.ts
+const toErrorLine = (error) => {
+	const path = Array.isArray(error.path) ? error.path.join("/") : error.path;
+	return `- ${path ? `${path}: ` : ""}${error.message}`;
+};
+/** Reads local files, like `readFiles`, and adds their paths to `files`. */
+const readTrackedFiles = (files) => {
+	const plugin = readFiles();
+	return {
+		...plugin,
+		exec: (value) => {
+			files.add(resolve(value));
+			return plugin.exec(value);
+		}
+	};
+};
+/**
+* Reads a spec with its external references into one document, and validates it. The spec is a
+* file relative to `root`, or an HTTPS URL.
+*/
+const readSpec = async (source, root) => {
+	const label = `Source "${source.id}"`;
+	const isRemote = source.spec.startsWith("https://");
+	const input = isRemote ? source.spec : fileURLToPath(new URL(source.spec, root));
+	const files = new Set(isRemote ? [] : [input]);
+	if (!isRemote && !existsSync(input)) throw new Error(`${label}: cannot find ${source.spec}. Use a path from the project root or an HTTPS URL.`);
+	const document = await bundle(input, {
+		plugins: [
+			readTrackedFiles(files),
+			fetchUrls(),
+			parseJson(),
+			parseYaml()
+		],
+		treeShake: false
+	}).catch((error) => {
+		throw new Error(`${label}: cannot read ${source.spec}. ${error.message}`);
+	});
+	const version = String(document.openapi ?? document.swagger ?? "");
+	if (!/^3\.[01]\./.test(version)) throw new Error(`${label}: OpenAPI ${version || "without a version"} is not supported. Use 3.0 or 3.1.`);
+	const result = await validate(document);
+	if (!result.valid) {
+		const errors = (result.errors ?? []).slice(0, 10).map(toErrorLine);
+		throw new Error(`${label}: ${source.spec} is not a valid OpenAPI document.\n${errors.join("\n")}`);
+	}
+	return {
+		document,
+		files: [...files]
+	};
+};
+//#endregion
+//#region src/sources/openapi/collection.ts
+/**
+* Reads and normalizes a spec at build time. A local spec loads again when it, or a local file
+* that it references, changes.
+*/
+const createOpenAPICollection = (source) => {
+	const watchers = /* @__PURE__ */ new WeakSet();
+	let reload;
+	let files = [];
+	let reloads = Promise.resolve();
+	return defineCollection({ loader: {
+		name: `openapi-${source.id}`,
+		load: async ({ store, config, logger, watcher }) => {
+			const load = async () => {
+				const spec = await readSpec(source, config.root);
+				const specURL = source.spec.startsWith("https://") ? source.spec : void 0;
+				const { model, ignored } = normalizeSpec(spec.document, `Source "${source.id}"`, specURL);
+				const stored = { model };
+				files = spec.files;
+				watcher?.add(files);
+				store.clear();
+				store.set({
+					id: recordID$1,
+					data: stored
+				});
+				logger.info(`Source "${source.id}": loaded ${model.operations.length} operations.`);
+				if (ignored.length) logger.warn(`Source "${source.id}": ${ignored.join(" and ")} are not shown.`);
+			};
+			reload = load;
+			await load();
+			if (!watcher || watchers.has(watcher)) return;
+			const onChange = (changed) => {
+				if (!files.includes(changed)) return;
+				reloads = reloads.then(() => reload?.()).catch((error) => logger.error(error.message));
+			};
+			watchers.add(watcher);
+			watcher.on("add", onChange);
+			watcher.on("change", onChange);
+		}
+	} });
+};
+//#endregion
+//#region src/collections.ts
+const collections = Object.fromEntries(config.sources.flatMap((source) => {
+	if (source.type === "files") return [[source.id, createFilesCollection(source)]];
+	if (source.type === "openapi") return [[source.id, createOpenAPICollection(source)]];
+	return [[source.id, createAndesineCollection(source, config.base, config.site, highlight)]];
+}));
+//#endregion
+export { collections };
+
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","names":["recordID"],"sources":["../src/sources/andesine/asset-cache.ts","../src/sources/andesine/collection.ts","../src/sources/files/schema.ts","../src/sources/files/collection.ts","../src/sources/openapi/read.ts","../src/sources/openapi/collection.ts","../src/collections.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport type { PublishedAsset } from \"@andesine/sdk\";\nimport { toSHA256 } from \"../../hash\";\nimport { type AssetStore, getAssetPrefix, getDeliveryURL, mimeTypes } from \"./assets\";\n\ninterface AssetCache extends AssetStore {\n  /** Lists the stored files, for the build output. */\n  finish(): Promise<void>;\n}\n\n/**\n * Downloads images into a cache directory with content-hash names. The build copies them to\n * the output, so pages do not depend on expiring delivery URLs.\n */\nconst createAssetCache = (directory: URL, base: string): AssetCache => {\n  const prefix = getAssetPrefix(base);\n  const files = new Set<string>();\n  const downloads = new Map<string, Promise<string>>();\n  const download = async (asset: PublishedAsset, entryID: string): Promise<string> => {\n    const label = `Entry ${entryID}, asset ${asset.assetID}`;\n    const response = await fetch(getDeliveryURL(asset, entryID), {\n      credentials: \"omit\",\n      signal: AbortSignal.timeout(30_000)\n    });\n    const type = response.headers.get(\"content-type\")?.split(\";\")[0];\n\n    if (!response.ok) throw new Error(`${label}: download failed (${response.status}).`);\n    if (type !== mimeTypes[asset.format]) throw new Error(`${label}: unexpected type ${type}.`);\n\n    const bytes = new Uint8Array(await response.arrayBuffer());\n    const file = `${await toSHA256(bytes)}.${asset.format}`;\n\n    await mkdir(directory, { recursive: true });\n    await writeFile(new URL(file, directory), bytes);\n    files.add(file);\n\n    return `${prefix}${file}`;\n  };\n\n  return {\n    resolve: (asset, entryID) => {\n      const key = `${asset.assetID}:${asset.variant}`;\n\n      if (!downloads.has(key)) downloads.set(key, download(asset, entryID));\n\n      return downloads.get(key)!;\n    },\n    finish: async () => {\n      await mkdir(directory, { recursive: true });\n      await writeFile(new URL(\"files.json\", directory), JSON.stringify([...files]));\n    }\n  };\n};\n\nexport { createAssetCache };\nexport type { AssetCache };\n","import { defineCollection } from \"astro/content/config\";\nimport type { AndesineSourceConfig } from \"../../config\";\nimport type { HighlightOptions } from \"../../content/prepare\";\nimport { createAssetCache } from \"./asset-cache\";\nimport { createAndesinePages } from \"./load\";\nimport { readPublication } from \"./read\";\nimport { recordID, type StoredSource } from \"./stored\";\n\n/** Reads the latest publication at build time, and copies its images into the build. */\nconst createAndesineCollection = (\n  source: AndesineSourceConfig,\n  base: string,\n  site: string,\n  highlight: HighlightOptions\n) => {\n  return defineCollection({\n    loader: {\n      name: `andesine-${source.id}`,\n      load: async ({ store, config, logger }) => {\n        const assets = createAssetCache(new URL(`andesine/${source.id}/`, config.cacheDir), base);\n        const { tree, entries } = await readPublication(source);\n        const pages = await createAndesinePages(source, tree.collection, entries, {\n          base,\n          site,\n          assets,\n          highlight\n        });\n        const stored: StoredSource = { tree: tree.collection, pages };\n\n        await assets.finish();\n        store.clear();\n        store.set({ id: recordID, data: stored as never });\n        logger.info(`Source \"${source.id}\": loaded ${pages.length} published pages.`);\n      }\n    }\n  });\n};\n\nexport { createAndesineCollection };\n","import { z } from \"astro/zod\";\n\nconst fileSchema = z\n  .object({\n    title: z.string().trim().min(1),\n    description: z.string().trim().min(1).optional(),\n    /** Replaces the path from the file location, relative to the source mount. */\n    slug: z.string().trim().optional(),\n    navigationLabel: z.string().trim().min(1).optional(),\n    navigationHidden: z.boolean().default(false),\n    searchHidden: z.boolean().default(false),\n    /** Lower numbers come first. Items with the same order sort by path. */\n    order: z.number().default(0),\n    toc: z.boolean().default(true),\n    layout: z.enum([\"docs\", \"wide\"]).default(\"docs\"),\n    /** The date of the last change, e.g. `2026-09-27`, for the page footer and the sitemap. */\n    updatedAt: z.coerce.date().optional()\n  })\n  .strict();\n\ntype FileMetadata = z.output<typeof fileSchema>;\n\nexport { fileSchema };\nexport type { FileMetadata };\n","import { defineCollection } from \"astro/content/config\";\nimport { glob } from \"astro/loaders\";\nimport type { FilesSourceConfig } from \"../../config\";\nimport { fileSchema } from \"./schema\";\n\nconst createFilesCollection = (source: FilesSourceConfig) => {\n  return defineCollection({\n    // Keep extensions in IDs, so `a.md` and `a.mdx` cannot replace each other.\n    loader: glob({\n      base: source.directory,\n      pattern: \"**/*.{md,mdx}\",\n      generateId: ({ entry }) => entry\n    }),\n    schema: fileSchema\n  });\n};\n\nexport { createFilesCollection };\n","import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { bundle } from \"@scalar/json-magic/bundle\";\nimport { fetchUrls, parseJson, parseYaml, readFiles } from \"@scalar/json-magic/bundle/plugins/node\";\nimport { validate, type ErrorObject } from \"@scalar/openapi-parser\";\nimport type { OpenAPISourceConfig } from \"../../config\";\n\ninterface ReadSpec {\n  document: Record<string, unknown>;\n  /** The local files of the spec and its references, for watching. */\n  files: string[];\n}\n\nconst toErrorLine = (error: ErrorObject): string => {\n  const path = Array.isArray(error.path) ? error.path.join(\"/\") : error.path;\n\n  return `- ${path ? `${path}: ` : \"\"}${error.message}`;\n};\n/** Reads local files, like `readFiles`, and adds their paths to `files`. */\nconst readTrackedFiles = (files: Set<string>): ReturnType<typeof readFiles> => {\n  const plugin = readFiles();\n\n  return {\n    ...plugin,\n    exec: (value) => {\n      files.add(resolve(value));\n\n      return plugin.exec(value);\n    }\n  };\n};\n/**\n * Reads a spec with its external references into one document, and validates it. The spec is a\n * file relative to `root`, or an HTTPS URL.\n */\nconst readSpec = async (source: OpenAPISourceConfig, root: URL): Promise<ReadSpec> => {\n  const label = `Source \"${source.id}\"`;\n  const isRemote = source.spec.startsWith(\"https://\");\n  const input = isRemote ? source.spec : fileURLToPath(new URL(source.spec, root));\n  const files = new Set(isRemote ? [] : [input]);\n\n  if (!isRemote && !existsSync(input)) {\n    throw new Error(\n      `${label}: cannot find ${source.spec}. Use a path from the project root or an HTTPS URL.`\n    );\n  }\n\n  const document = (await bundle(input, {\n    plugins: [readTrackedFiles(files), fetchUrls(), parseJson(), parseYaml()],\n    treeShake: false\n  }).catch((error: Error) => {\n    throw new Error(`${label}: cannot read ${source.spec}. ${error.message}`);\n  })) as Record<string, unknown>;\n  const version = String(document.openapi ?? document.swagger ?? \"\");\n\n  if (!/^3\\.[01]\\./.test(version)) {\n    throw new Error(\n      `${label}: OpenAPI ${version || \"without a version\"} is not supported. Use 3.0 or 3.1.`\n    );\n  }\n\n  const result = await validate(document);\n\n  if (!result.valid) {\n    const errors = (result.errors ?? []).slice(0, 10).map(toErrorLine);\n\n    throw new Error(\n      `${label}: ${source.spec} is not a valid OpenAPI document.\\n${errors.join(\"\\n\")}`\n    );\n  }\n\n  return { document, files: [...files] };\n};\n\nexport { readSpec };\nexport type { ReadSpec };\n","import { defineCollection } from \"astro/content/config\";\nimport type { OpenAPISourceConfig } from \"../../config\";\nimport { normalizeSpec } from \"./normalize\";\nimport { readSpec } from \"./read\";\nimport { recordID, type StoredSpec } from \"./stored\";\n\n/**\n * Reads and normalizes a spec at build time. A local spec loads again when it, or a local file\n * that it references, changes.\n */\nconst createOpenAPICollection = (source: OpenAPISourceConfig) => {\n  // Syncs call the loader again; the watcher calls the latest load, and gets one listener.\n  const watchers = new WeakSet<object>();\n\n  let reload: (() => Promise<void>) | undefined;\n  let files: string[] = [];\n  // Reloads run in order, so a slower, older reload cannot replace a newer model.\n  let reloads = Promise.resolve();\n\n  return defineCollection({\n    loader: {\n      name: `openapi-${source.id}`,\n      load: async ({ store, config, logger, watcher }) => {\n        const load = async (): Promise<void> => {\n          const spec = await readSpec(source, config.root);\n          const specURL = source.spec.startsWith(\"https://\") ? source.spec : undefined;\n          const { model, ignored } = normalizeSpec(spec.document, `Source \"${source.id}\"`, specURL);\n          const stored: StoredSpec = { model };\n\n          // References can change, so the new files are watched too.\n          files = spec.files;\n          watcher?.add(files);\n\n          store.clear();\n          store.set({ id: recordID, data: stored as never });\n          logger.info(`Source \"${source.id}\": loaded ${model.operations.length} operations.`);\n\n          if (ignored.length) {\n            logger.warn(`Source \"${source.id}\": ${ignored.join(\" and \")} are not shown.`);\n          }\n        };\n\n        reload = load;\n        await load();\n\n        if (!watcher || watchers.has(watcher)) return;\n\n        const onChange = (changed: string): void => {\n          if (!files.includes(changed)) return;\n\n          reloads = reloads\n            .then(() => reload?.())\n            .catch((error: Error) => logger.error(error.message));\n        };\n\n        watchers.add(watcher);\n        // A referenced file that did not exist yet is added, not changed.\n        watcher.on(\"add\", onChange);\n        watcher.on(\"change\", onChange);\n      }\n    }\n  });\n};\n\nexport { createOpenAPICollection };\n","import config, { highlight } from \"virtual:andesine/config\";\nimport { createAndesineCollection } from \"./sources/andesine/collection\";\nimport { createFilesCollection } from \"./sources/files/collection\";\nimport { createOpenAPICollection } from \"./sources/openapi/collection\";\n\nconst collections = Object.fromEntries(\n  config.sources.flatMap((source) => {\n    if (source.type === \"files\") return [[source.id, createFilesCollection(source)]];\n    if (source.type === \"openapi\") return [[source.id, createOpenAPICollection(source)]];\n\n    return [[source.id, createAndesineCollection(source, config.base, config.site, highlight)]];\n  })\n);\n\nexport { collections };\n"],"mappings":"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"}

package/dist/entry-pages.d.ts

@@ -0,0 +1,10 @@
+import { APIRoute } from "astro";
+//#region src/astro/routes/entry-pages.d.ts
+export declare const getStaticPaths: () => any;
+/**
+ * Maps the entry IDs of a source with a publishable key to page URLs, so the browser can link
+ * API search results and answer sources. Pages hidden from search are left out.
+ */
+export declare const GET: APIRoute;
+//#endregion
+//# sourceMappingURL=entry-pages.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { t as FileTreeItem } from "./chunks/mdx-components-CUUDTapN.js";
+import { A as FilesSourceConfig, C as SiteContext, D as parseConfig, E as defineConfig, F as PagesConfigInput, I as SectionConfig, L as SourceConfig, M as LinkConfig, N as OpenAPISourceConfig, O as AIService, P as PagesConfig, R as configSchema, S as SectionContext, T as SocialImage, _ as PageFragments, b as SearchContext, c as createSiteContext, d as BreadcrumbItem, f as HeadingContext, g as PageContext, h as PageActionsContext, j as IconLinkConfig, k as AndesineSourceConfig, l as AndesineAPIContext, m as OpenInLink, n as createPageContext, p as NavigationItem, r as toSectionContexts, t as createPageMeta, u as AnswersContext, v as PageLink, w as SiteLogo, x as SearchSourceContext, y as PageMeta } from "./chunks/index-D8wL2B5s.js";
+import { a as RequestBodyView, c as ServerView, d as FieldView, f as MediaView, h as Fact, i as ParameterGroupView, l as ViewOptions, m as toID, n as OperationParts, o as ResponseView, p as VariantView, r as OperationView, s as SecuritySchemeView, t as CodeView, u as createOperationView } from "./chunks/view-Dlf_VRI7.js";
+import { a as MarkupValue, i as Markup, n as SocialCardData, o as html, r as SocialCardFont, t as SocialCard } from "./chunks/types-DBzuXfSe.js";
+export { type AIService, type AndesineAPIContext, type AndesineSourceConfig, type AnswersContext, type BreadcrumbItem, type CodeView, type Fact, type FieldView, type FileTreeItem, type FilesSourceConfig, type HeadingContext, type IconLinkConfig, type LinkConfig, type Markup, type MarkupValue, type MediaView, type NavigationItem, type OpenAPISourceConfig, type OpenInLink, type OperationParts, type OperationView, type PageActionsContext, type PageContext, type PageFragments, type PageLink, type PageMeta, type PagesConfig, type PagesConfigInput, type ParameterGroupView, type RequestBodyView, type ResponseView, type SearchContext, type SearchSourceContext, type SectionConfig, type SectionContext, type SecuritySchemeView, type ServerView, type SiteContext, type SiteLogo, type SocialCard, type SocialCardData, type SocialCardFont, type SocialImage, type SourceConfig, type VariantView, type ViewOptions, type configSchema, type createOperationView, type createPageContext, type createPageMeta, type createSiteContext, defineConfig, html, type parseConfig, type toID, type toSectionContexts };

package/dist/index.js

@@ -0,0 +1,38 @@
+import { t as defineConfig } from "./chunks/config-CuH5JSI4.js";
+//#region src/social/html.ts
+const entities = {
+	"&": "&",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;"
+};
+/** Card markup from the `html` template tag, whose values are already escaped. */
+var Markup = class {
+	value;
+	constructor(value) {
+		this.value = value;
+	}
+	toString() {
+		return this.value;
+	}
+};
+const toMarkup = (value) => {
+	const isEmpty = value === null || value === void 0 || typeof value === "boolean";
+	if (value instanceof Markup) return value.value;
+	if (Array.isArray(value)) return value.map(toMarkup).join("");
+	if (isEmpty) return "";
+	return String(value).replace(/[&<>"]/g, (character) => entities[character]);
+};
+/**
+* A template tag for social card markup. It escapes values, joins arrays, and leaves out
+* `false`, `null`, and `undefined`, so `${condition && html`…`}` adds optional parts.
+*/
+const html = (strings, ...values) => {
+	return new Markup(strings.reduce((result, part, index) => {
+		return result + part + (index < values.length ? toMarkup(values[index]) : "");
+	}, ""));
+};
+//#endregion
+export { defineConfig, html };
+
+//# sourceMappingURL=index.js.map