@andesine/pages 0.0.0-stage → 0.6.0

package/dist/chunks/site-DY-uZ0PP.js

@@ -0,0 +1,419 @@
+import { n as toSegments, t as toHref } from "./paths-75QgA3Qs.js";
+import { a as findTrail, i as createNavigationItems, o as flattenTree, r as createSections, t as loadStaticSources } from "./sources-Cm6NdIen.js";
+import { r as prepareMarkdown } from "./prepare-lnuw_ycM.js";
+import { a as toOpenAPIMarkdown } from "./stored-CcEfvCQH.js";
+import { t as createMarkdownPage } from "./markdown-DKJSQxR2.js";
+import { t as createOperationView } from "./view-C-9ZM1zK.js";
+import { render } from "astro:content";
+//#region src/routing/routes.ts
+/**
+* Creates one route for each page, and a redirect to the first page for each source mount
+* and the site root without a page. Fails when two pages use the same URL.
+*/
+const createRoutes = (base, sections) => {
+	const routes = /* @__PURE__ */ new Map();
+	const addRedirect = (href, target) => {
+		if (target && target !== href && !routes.has(href)) routes.set(href, {
+			type: "redirect",
+			href,
+			target
+		});
+	};
+	for (const section of sections) for (const page of section.sources.flatMap((source) => source.pages)) {
+		const existing = routes.get(page.href);
+		if (existing?.type === "page") throw new Error(`Pages "${existing.page.sourceID}/${existing.page.id}" and "${page.sourceID}/${page.id}" both use the URL ${page.href}. Change the file location or slug of one page.`);
+		routes.set(page.href, {
+			type: "page",
+			href: page.href,
+			page,
+			section
+		});
+	}
+	for (const source of sections.flatMap((section) => section.sources)) addRedirect(source.href, flattenTree(source.navigation)[0]?.page?.href);
+	addRedirect(toHref(toSegments(base, "Site base")), sections[0]?.href);
+	return [...routes.values()];
+};
+//#endregion
+//#region src/context/site.ts
+const defaultAPIURL = "https://api.andesine.app";
+/** Direct API access for a source with a publishable key. */
+const toAPIContext = (config, source) => {
+	if (source.type !== "andesine" || !source.publicKey) return void 0;
+	return {
+		url: (source.apiURL ?? defaultAPIURL).replace(/\/$/, ""),
+		key: source.publicKey,
+		collection: source.collection,
+		pages: `${config.base}_andesine/pages/${source.id}.json`
+	};
+};
+const createSearchSources = (config) => {
+	return config.sources.map((source) => {
+		return {
+			id: source.id,
+			label: config.sections.find((section) => section.sources.includes(source.id))?.label ?? config.name,
+			type: source.type === "andesine" ? "andesine" : "pagefind",
+			api: toAPIContext(config, source)
+		};
+	});
+};
+const createSiteContext = (config) => {
+	const sources = createSearchSources(config);
+	const answers = config.sources.find((source) => source.type === "andesine" && source.answers);
+	return {
+		name: config.name,
+		description: config.description,
+		language: config.language,
+		href: config.base,
+		url: new URL(config.base, config.site).href,
+		storageKey: `andesine:${config.base}`,
+		logo: config.logo,
+		favicon: config.favicon,
+		sectionsDisplay: config.sectionsDisplay,
+		links: config.links,
+		cta: config.cta,
+		socialLinks: config.socialLinks,
+		search: sources.length ? {
+			sources,
+			endpoint: `${config.base}_andesine/search/`,
+			pagefind: `${config.base}pagefind/`,
+			answers: answers && {
+				endpoint: `${config.base}_andesine/answers/`,
+				source: answers.id,
+				api: toAPIContext(config, answers)
+			}
+		} : void 0
+	};
+};
+//#endregion
+//#region src/context/actions.ts
+const services = {
+	chatgpt: {
+		label: "ChatGPT",
+		url: "https://chatgpt.com/?q="
+	},
+	claude: {
+		label: "Claude",
+		url: "https://claude.ai/new?q="
+	},
+	perplexity: {
+		label: "Perplexity",
+		url: "https://www.perplexity.ai/search?q="
+	}
+};
+const createPageActions = (config, markdownURL) => {
+	if (!config) return;
+	const prompt = encodeURIComponent(`Read ${markdownURL} so I can ask questions about it.`);
+	return { openIn: config.openIn.map((id) => {
+		return {
+			id,
+			label: services[id].label,
+			href: `${services[id].url}${prompt}`
+		};
+	}) };
+};
+//#endregion
+//#region src/context/meta.ts
+/** The document title, description, and type of a page. */
+const createPageMeta = (site, page) => {
+	return {
+		title: page.title === site.name ? site.name : `${page.title} | ${site.name}`,
+		description: page.description ?? site.description,
+		type: page.href === site.href ? "website" : "article"
+	};
+};
+//#endregion
+//#region src/context/structured-data.ts
+/** Makes JSON safe inside a `<script>` element, where `<\/script>` would end it. */
+const serialize = (value) => JSON.stringify(value).replace(/</g, "\\u003c");
+/**
+* Creates schema.org JSON-LD for a page: the site with its search action, the page as a
+* technical article, and its breadcrumbs.
+*/
+const createStructuredData = (options) => {
+	const { site } = options;
+	const websiteID = `${site.url}#website`;
+	const breadcrumbs = options.trail.filter((item) => item.href);
+	return serialize({
+		"@context": "https://schema.org",
+		"@graph": [
+			{
+				"@type": "WebSite",
+				"@id": websiteID,
+				"name": site.name,
+				"description": site.description,
+				"url": site.url,
+				"inLanguage": site.language,
+				"potentialAction": site.search && {
+					"@type": "SearchAction",
+					"target": {
+						"@type": "EntryPoint",
+						"urlTemplate": `${site.url}?q={search_term_string}`
+					},
+					"query-input": "required name=search_term_string"
+				}
+			},
+			{
+				"@type": "TechArticle",
+				"headline": options.title,
+				"description": options.description,
+				"url": options.url,
+				"dateModified": options.updatedAt,
+				"image": options.image,
+				"inLanguage": site.language,
+				"isPartOf": { "@id": websiteID }
+			},
+			...breadcrumbs.length > 1 ? [{
+				"@type": "BreadcrumbList",
+				"itemListElement": breadcrumbs.map((item, index) => {
+					return {
+						"@type": "ListItem",
+						"position": index + 1,
+						"name": item.label,
+						"item": new URL(item.href, site.url).href
+					};
+				})
+			}] : []
+		]
+	});
+};
+//#endregion
+//#region src/context/page.ts
+const toPageLink = (node) => {
+	return node?.page && {
+		label: node.label,
+		href: node.page.href
+	};
+};
+const toSectionContexts = (sections, current) => {
+	return sections.map((item) => {
+		return {
+			id: item.id,
+			label: item.label,
+			icon: item.icon,
+			href: item.href,
+			current: item === current
+		};
+	});
+};
+/** Creates the page context without headings, which exist only after rendering. */
+const createPageContext = (options) => {
+	const { page, section } = options.route;
+	const trail = findTrail(section.navigation, page);
+	const order = flattenTree(section.navigation);
+	const position = order.findIndex((node) => node.page === page);
+	const markdown = `${page.href}index.md`;
+	const canonical = new URL(page.href, options.site.url).href;
+	const breadcrumbs = trail.slice(0, -1).map((node) => {
+		return {
+			label: node.label,
+			href: node.page?.href
+		};
+	});
+	const sectionItem = options.sections.length ? [{
+		label: section.label,
+		href: section.href
+	}] : [];
+	return {
+		site: options.site,
+		title: page.title,
+		description: page.description,
+		meta: createPageMeta(options.site, page),
+		fragments: {
+			summary: page.content.type === "andesine" && Boolean(page.content.summary),
+			aside: page.content.type === "andesine" && Boolean(page.content.aside)
+		},
+		layout: page.layout,
+		sections: toSectionContexts(options.sections, section),
+		links: [...options.site.links, ...section.links],
+		navigation: createNavigationItems(section.navigation, trail),
+		breadcrumbs,
+		previous: position > 0 ? toPageLink(order[position - 1]) : void 0,
+		next: position >= 0 ? toPageLink(order[position + 1]) : void 0,
+		canonical,
+		markdown,
+		updatedAt: page.updatedAt,
+		noindex: page.searchHidden,
+		image: options.image,
+		structuredData: createStructuredData({
+			site: options.site,
+			title: page.title,
+			description: page.description,
+			url: canonical,
+			updatedAt: page.updatedAt,
+			image: options.image?.url,
+			trail: [
+				...sectionItem,
+				...breadcrumbs,
+				{
+					label: page.title,
+					href: page.href
+				}
+			]
+		}),
+		actions: createPageActions(options.pageActions, new URL(markdown, options.site.url).href)
+	};
+};
+//#endregion
+//#region src/social/size.ts
+/** The size of generated social images, as Open Graph recommends. */
+const socialImageSize = {
+	width: 1200,
+	height: 630
+};
+//#endregion
+//#region src/context/image.ts
+/** The link preview image of a page: its generated card, or the configured default image. */
+const getSocialImage = (config, href) => {
+	const site = new URL(config.base, config.site);
+	if (href && config.social.generate) return {
+		url: new URL(`${href}social.png`, site).href,
+		...socialImageSize
+	};
+	return config.social.image ? { url: new URL(config.social.image, site).href } : void 0;
+};
+//#endregion
+//#region src/site/index.ts
+/** Decodes a base-prefixed URL path into the `[...path]` parameter. */
+const toParam = (href, base) => {
+	return decodeURIComponent(href.slice(base.length)).replace(/\/$/, "") || void 0;
+};
+/** Creates the routes of loaded sources, with the page context of each page. */
+const createSiteRoutes = (config, sources) => {
+	const sections = createSections(config, sources);
+	const site = createSiteContext(config);
+	const shownSections = config.sections.length ? sections : [];
+	return createRoutes(config.base, sections).map((route) => {
+		return {
+			href: route.href,
+			route: route.type === "redirect" ? route : {
+				type: "page",
+				content: route.page.content,
+				toc: route.page.toc,
+				sourceID: route.page.sourceID,
+				indexed: route.page.content.type !== "andesine" && !route.page.searchHidden,
+				markdown: createMarkdownPage(config, route.page),
+				context: createPageContext({
+					site,
+					sections: shownSections,
+					route,
+					pageActions: config.pageActions,
+					image: getSocialImage(config, route.href)
+				})
+			}
+		};
+	});
+};
+const getStaticPaths = async (config) => {
+	return createSiteRoutes(config, await loadStaticSources(config)).map(({ href, route }) => {
+		return {
+			params: { path: toParam(href, config.base) },
+			props: { route }
+		};
+	});
+};
+const getMarkdownPaths = async (config) => {
+	return createSiteRoutes(config, await loadStaticSources(config)).flatMap(({ href, route }) => {
+		return route.type === "page" ? [{
+			params: { path: toParam(href, config.base) },
+			props: { markdown: route.markdown }
+		}] : [];
+	});
+};
+const toSocialData = (context) => {
+	return {
+		siteName: context.site.name,
+		title: context.title,
+		description: context.description,
+		group: context.breadcrumbs.at(-1)?.label
+	};
+};
+const getSocialPaths = async (config) => {
+	return createSiteRoutes(config, await loadStaticSources(config)).flatMap(({ href, route }) => {
+		return route.type === "page" ? [{
+			params: { path: toParam(href, config.base) },
+			props: { data: toSocialData(route.context) }
+		}] : [];
+	});
+};
+/** The context of the not-found page, with the navigation of the first section. */
+const getNotFoundContext = async (config) => {
+	const sections = createSections(config, await loadStaticSources(config));
+	const site = createSiteContext(config);
+	const title = "Page not found";
+	return {
+		site,
+		title,
+		meta: createPageMeta(site, { title }),
+		fragments: {
+			summary: false,
+			aside: false
+		},
+		layout: "docs",
+		sections: config.sections.length ? toSectionContexts(sections) : [],
+		links: [...site.links, ...sections[0]?.links ?? []],
+		navigation: createNavigationItems(sections[0]?.navigation ?? [], []),
+		breadcrumbs: [],
+		headings: [],
+		noindex: true,
+		image: getSocialImage(config)
+	};
+};
+const toOutline = (headings, toc) => {
+	return toc ? headings.filter((heading) => heading.depth >= 2 && heading.depth <= 3) : [];
+};
+const renderRoute = async (route, highlight) => {
+	if (route.content.type === "openapi" && route.content.operation) {
+		const { operation, model, links } = route.content;
+		return {
+			operation: await createOperationView(operation, model, {
+				highlight,
+				title: route.context.title,
+				href: links.operations[operation.id]
+			}),
+			page: {
+				...route.context,
+				headings: []
+			}
+		};
+	}
+	if (route.content.type === "openapi") {
+		const prepared = await prepareMarkdown(toOpenAPIMarkdown(route.content, (href) => href), highlight);
+		return {
+			nodes: prepared.nodes,
+			iconCSS: prepared.iconCSS,
+			page: {
+				...route.context,
+				headings: toOutline(prepared.headings, route.toc)
+			}
+		};
+	}
+	if (route.content.type === "andesine") return {
+		nodes: route.content.nodes,
+		summary: route.content.summary,
+		aside: route.content.aside,
+		iconCSS: route.content.iconCSS,
+		page: {
+			...route.context,
+			headings: toOutline(route.content.headings, route.toc)
+		}
+	};
+	const { Content, headings } = await render(route.content.entry);
+	const outline = headings.map((heading) => {
+		return {
+			id: heading.slug,
+			text: heading.text,
+			depth: heading.depth
+		};
+	});
+	return {
+		Content,
+		page: {
+			...route.context,
+			headings: toOutline(outline, route.toc)
+		}
+	};
+};
+//#endregion
+export { renderRoute as a, getStaticPaths as i, getNotFoundContext as n, socialImageSize as o, getSocialPaths as r, getMarkdownPaths as t };
+
+//# sourceMappingURL=site-DY-uZ0PP.js.map

package/dist/chunks/site-DY-uZ0PP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-DY-uZ0PP.js","names":[],"sources":["../../src/routing/routes.ts","../../src/context/site.ts","../../src/context/actions.ts","../../src/context/meta.ts","../../src/context/structured-data.ts","../../src/context/page.ts","../../src/social/size.ts","../../src/context/image.ts","../../src/site/index.ts"],"sourcesContent":["import type { Section } from \"../navigation\";\nimport { flattenTree } from \"../navigation\";\nimport type { SourcePage } from \"../sources\";\nimport { toHref, toSegments } from \"./paths\";\n\ninterface PageRoute {\n  type: \"page\";\n  href: string;\n  page: SourcePage;\n  section: Section;\n}\n\ninterface RedirectRoute {\n  type: \"redirect\";\n  href: string;\n  target: string;\n}\n\ntype Route = PageRoute | RedirectRoute;\n\n/**\n * Creates one route for each page, and a redirect to the first page for each source mount\n * and the site root without a page. Fails when two pages use the same URL.\n */\nconst createRoutes = (base: string, sections: Section[]): Route[] => {\n  const routes = new Map<string, Route>();\n  const addRedirect = (href: string, target?: string): void => {\n    const isFree = target && target !== href && !routes.has(href);\n\n    if (isFree) routes.set(href, { type: \"redirect\", href, target });\n  };\n\n  for (const section of sections) {\n    for (const page of section.sources.flatMap((source) => source.pages)) {\n      const existing = routes.get(page.href);\n\n      if (existing?.type === \"page\") {\n        throw new Error(\n          `Pages \"${existing.page.sourceID}/${existing.page.id}\" and \"${page.sourceID}/${page.id}\" both use the URL ${page.href}. Change the file location or slug of one page.`\n        );\n      }\n\n      routes.set(page.href, { type: \"page\", href: page.href, page, section });\n    }\n  }\n\n  for (const source of sections.flatMap((section) => section.sources)) {\n    addRedirect(source.href, flattenTree(source.navigation)[0]?.page?.href);\n  }\n\n  addRedirect(toHref(toSegments(base, \"Site base\")), sections[0]?.href);\n\n  return [...routes.values()];\n};\n\nexport { createRoutes };\nexport type { PageRoute, RedirectRoute, Route };\n","import type { PagesConfig, SourceConfig } from \"../config\";\nimport type { AndesineAPIContext, SearchSourceContext, SiteContext } from \"./types\";\n\nconst defaultAPIURL = \"https://api.andesine.app\";\n\n/** Direct API access for a source with a publishable key. */\nconst toAPIContext = (\n  config: PagesConfig,\n  source: SourceConfig\n): AndesineAPIContext | undefined => {\n  if (source.type !== \"andesine\" || !source.publicKey) return undefined;\n\n  return {\n    url: (source.apiURL ?? defaultAPIURL).replace(/\\/$/, \"\"),\n    key: source.publicKey,\n    collection: source.collection,\n    pages: `${config.base}_andesine/pages/${source.id}.json`\n  };\n};\nconst createSearchSources = (config: PagesConfig): SearchSourceContext[] => {\n  return config.sources.map((source) => {\n    return {\n      id: source.id,\n      label:\n        config.sections.find((section) => section.sources.includes(source.id))?.label ??\n        config.name,\n      type: source.type === \"andesine\" ? \"andesine\" : \"pagefind\",\n      api: toAPIContext(config, source)\n    };\n  });\n};\nconst createSiteContext = (config: PagesConfig): SiteContext => {\n  const sources = createSearchSources(config);\n  // The API answers about one collection, so the first source with answers is used.\n  const answers = config.sources.find((source) => source.type === \"andesine\" && source.answers);\n\n  return {\n    name: config.name,\n    description: config.description,\n    language: config.language,\n    href: config.base,\n    url: new URL(config.base, config.site).href,\n    storageKey: `andesine:${config.base}`,\n    logo: config.logo,\n    favicon: config.favicon,\n    sectionsDisplay: config.sectionsDisplay,\n    links: config.links,\n    cta: config.cta,\n    socialLinks: config.socialLinks,\n    search: sources.length\n      ? {\n          sources,\n          endpoint: `${config.base}_andesine/search/`,\n          pagefind: `${config.base}pagefind/`,\n          answers: answers && {\n            endpoint: `${config.base}_andesine/answers/`,\n            source: answers.id,\n            api: toAPIContext(config, answers)\n          }\n        }\n      : undefined\n  };\n};\n\nexport { createSiteContext };\n","import type { AIService, PagesConfig } from \"../config\";\nimport type { PageActionsContext } from \"./types\";\n\nconst services: Record<AIService, { label: string; url: string }> = {\n  chatgpt: { label: \"ChatGPT\", url: \"https://chatgpt.com/?q=\" },\n  claude: { label: \"Claude\", url: \"https://claude.ai/new?q=\" },\n  perplexity: { label: \"Perplexity\", url: \"https://www.perplexity.ai/search?q=\" }\n};\n\nconst createPageActions = (\n  config: PagesConfig[\"pageActions\"],\n  markdownURL: string\n): PageActionsContext | undefined => {\n  if (!config) return;\n\n  const prompt = encodeURIComponent(`Read ${markdownURL} so I can ask questions about it.`);\n\n  return {\n    openIn: config.openIn.map((id) => {\n      return {\n        id,\n        label: services[id].label,\n        href: `${services[id].url}${prompt}`\n      };\n    })\n  };\n};\n\nexport { createPageActions };\n","import type { PageMeta, SiteContext } from \"./types\";\n\n/** The document title, description, and type of a page. */\nconst createPageMeta = (\n  site: SiteContext,\n  page: { title: string; description?: string; href?: string }\n): PageMeta => {\n  return {\n    title: page.title === site.name ? site.name : `${page.title} | ${site.name}`,\n    description: page.description ?? site.description,\n    type: page.href === site.href ? \"website\" : \"article\"\n  };\n};\n\nexport { createPageMeta };\n","import type { BreadcrumbItem, SiteContext } from \"./types\";\n\ninterface StructuredDataOptions {\n  site: SiteContext;\n  title: string;\n  description?: string;\n  /** Absolute URL of the page. */\n  url: string;\n  updatedAt?: string;\n  image?: string;\n  /** The section, groups, and page, from the top. Items without a URL are left out. */\n  trail: BreadcrumbItem[];\n}\n\n/** Makes JSON safe inside a `<script>` element, where `</script>` would end it. */\nconst serialize = (value: unknown): string => JSON.stringify(value).replace(/</g, \"\\\\u003c\");\n/**\n * Creates schema.org JSON-LD for a page: the site with its search action, the page as a\n * technical article, and its breadcrumbs.\n */\nconst createStructuredData = (options: StructuredDataOptions): string => {\n  const { site } = options;\n  const websiteID = `${site.url}#website`;\n  const breadcrumbs = options.trail.filter((item) => item.href);\n\n  return serialize({\n    \"@context\": \"https://schema.org\",\n    \"@graph\": [\n      {\n        \"@type\": \"WebSite\",\n        \"@id\": websiteID,\n        \"name\": site.name,\n        \"description\": site.description,\n        \"url\": site.url,\n        \"inLanguage\": site.language,\n        \"potentialAction\": site.search && {\n          \"@type\": \"SearchAction\",\n          \"target\": { \"@type\": \"EntryPoint\", \"urlTemplate\": `${site.url}?q={search_term_string}` },\n          \"query-input\": \"required name=search_term_string\"\n        }\n      },\n      {\n        \"@type\": \"TechArticle\",\n        \"headline\": options.title,\n        \"description\": options.description,\n        \"url\": options.url,\n        \"dateModified\": options.updatedAt,\n        \"image\": options.image,\n        \"inLanguage\": site.language,\n        \"isPartOf\": { \"@id\": websiteID }\n      },\n      ...(breadcrumbs.length > 1\n        ? [\n            {\n              \"@type\": \"BreadcrumbList\",\n              \"itemListElement\": breadcrumbs.map((item, index) => {\n                return {\n                  \"@type\": \"ListItem\",\n                  \"position\": index + 1,\n                  \"name\": item.label,\n                  \"item\": new URL(item.href!, site.url).href\n                };\n              })\n            }\n          ]\n        : [])\n    ]\n  });\n};\n\nexport { createStructuredData };\n","import type { PagesConfig } from \"../config\";\nimport { createNavigationItems, findTrail, flattenTree, type Section } from \"../navigation\";\nimport type { PageRoute } from \"../routing\";\nimport type { SourceNode } from \"../sources\";\nimport { createPageActions } from \"./actions\";\nimport { createPageMeta } from \"./meta\";\nimport { createStructuredData } from \"./structured-data\";\nimport type { PageContext, PageLink, SectionContext, SiteContext, SocialImage } from \"./types\";\n\ninterface PageContextOptions {\n  site: SiteContext;\n  /** Configured sections; empty when the site uses the implicit section. */\n  sections: Section[];\n  route: PageRoute;\n  pageActions: PagesConfig[\"pageActions\"];\n  image?: SocialImage;\n}\n\nconst toPageLink = (node?: SourceNode): PageLink | undefined => {\n  return node?.page && { label: node.label, href: node.page.href };\n};\nconst toSectionContexts = (sections: Section[], current?: Section): SectionContext[] => {\n  return sections.map((item) => {\n    return {\n      id: item.id,\n      label: item.label,\n      icon: item.icon,\n      href: item.href,\n      current: item === current\n    };\n  });\n};\n\n/** Creates the page context without headings, which exist only after rendering. */\nconst createPageContext = (options: PageContextOptions): Omit<PageContext, \"headings\"> => {\n  const { page, section } = options.route;\n  const trail = findTrail(section.navigation, page);\n  const order = flattenTree(section.navigation);\n  const position = order.findIndex((node) => node.page === page);\n  const markdown = `${page.href}index.md`;\n  const canonical = new URL(page.href, options.site.url).href;\n  const breadcrumbs = trail.slice(0, -1).map((node) => {\n    return {\n      label: node.label,\n      href: node.page?.href\n    };\n  });\n  const sectionItem = options.sections.length ? [{ label: section.label, href: section.href }] : [];\n\n  return {\n    site: options.site,\n    title: page.title,\n    description: page.description,\n    meta: createPageMeta(options.site, page),\n    fragments: {\n      summary: page.content.type === \"andesine\" && Boolean(page.content.summary),\n      aside: page.content.type === \"andesine\" && Boolean(page.content.aside)\n    },\n    layout: page.layout,\n    sections: toSectionContexts(options.sections, section),\n    links: [...options.site.links, ...section.links],\n    navigation: createNavigationItems(section.navigation, trail),\n    breadcrumbs,\n    previous: position > 0 ? toPageLink(order[position - 1]) : undefined,\n    next: position >= 0 ? toPageLink(order[position + 1]) : undefined,\n    canonical,\n    markdown,\n    updatedAt: page.updatedAt,\n    noindex: page.searchHidden,\n    image: options.image,\n    structuredData: createStructuredData({\n      site: options.site,\n      title: page.title,\n      description: page.description,\n      url: canonical,\n      updatedAt: page.updatedAt,\n      image: options.image?.url,\n      trail: [...sectionItem, ...breadcrumbs, { label: page.title, href: page.href }]\n    }),\n    actions: createPageActions(options.pageActions, new URL(markdown, options.site.url).href)\n  };\n};\n\nexport { createPageContext, toSectionContexts };\n","/** The size of generated social images, as Open Graph recommends. */\nconst socialImageSize = { width: 1200, height: 630 };\n\nexport { socialImageSize };\n","import type { PagesConfig } from \"../config\";\nimport { socialImageSize } from \"../social/size\";\nimport type { SocialImage } from \"./types\";\n\n/** The link preview image of a page: its generated card, or the configured default image. */\nconst getSocialImage = (config: PagesConfig, href?: string): SocialImage | undefined => {\n  const site = new URL(config.base, config.site);\n\n  if (href && config.social.generate) {\n    return { url: new URL(`${href}social.png`, site).href, ...socialImageSize };\n  }\n\n  return config.social.image ? { url: new URL(config.social.image, site).href } : undefined;\n};\n\nexport { getSocialImage };\n","import type { MarkdownHeading } from \"astro\";\nimport { render } from \"astro:content\";\nimport type { Root } from \"hast\";\nimport type { PagesConfig } from \"../config\";\nimport {\n  createPageContext,\n  createPageMeta,\n  createSiteContext,\n  toSectionContexts,\n  type HeadingContext,\n  type PageContext\n} from \"../context\";\nimport { createNavigationItems, createSections } from \"../navigation\";\nimport { getSocialImage } from \"../context/image\";\nimport type { SocialCardData } from \"../social/types\";\nimport { createMarkdownPage } from \"../output/markdown\";\nimport { createRoutes, type RedirectRoute, type Route } from \"../routing\";\nimport { prepareMarkdown, type HighlightOptions } from \"../content/prepare\";\nimport { loadStaticSources, type SourceData, type SourcePage } from \"../sources\";\nimport { toOpenAPIMarkdown } from \"../sources/openapi/markdown\";\nimport { createOperationView, type OperationView } from \"../sources/openapi/view\";\n\ninterface PageRouteData {\n  type: \"page\";\n  content: SourcePage[\"content\"];\n  toc: boolean;\n  sourceID: string;\n  /** The page is in the Pagefind index. */\n  indexed: boolean;\n  /** The Markdown alternative, with the title and description. */\n  markdown: string;\n  context: Omit<PageContext, \"headings\">;\n}\n\ninterface SiteRoute {\n  href: string;\n  route: PageRouteData | RedirectRoute;\n}\n\ninterface StaticPath {\n  params: { path?: string };\n  props: { route: PageRouteData | RedirectRoute };\n}\n\ninterface MarkdownPath {\n  params: { path?: string };\n  props: { markdown: string };\n}\n\ninterface SocialPath {\n  params: { path?: string };\n  props: { data: SocialData };\n}\n\ninterface RenderedRoute {\n  /** Astro content of a file page. */\n  Content?: unknown;\n  /** The operation of an OpenAPI operation page. */\n  operation?: OperationView;\n  /** HTML syntax tree of an Andesine page, or of an OpenAPI overview or tag page. */\n  nodes?: Root;\n  summary?: Root;\n  aside?: Root;\n  /** CSS for icons in the Andesine content. */\n  iconCSS?: string;\n  page: PageContext;\n}\n\n/** Card data without the configured images and brand, which the route adds. */\ntype SocialData = Omit<\n  SocialCardData,\n  \"logo\" | \"showSiteName\" | \"logoFormat\" | \"background\" | \"brand\"\n>;\n\n/** Decodes a base-prefixed URL path into the `[...path]` parameter. */\nconst toParam = (href: string, base: string): string | undefined => {\n  return decodeURIComponent(href.slice(base.length)).replace(/\\/$/, \"\") || undefined;\n};\n\n/** Creates the routes of loaded sources, with the page context of each page. */\nconst createSiteRoutes = (config: PagesConfig, sources: SourceData[]): SiteRoute[] => {\n  const sections = createSections(config, sources);\n  const site = createSiteContext(config);\n  const shownSections = config.sections.length ? sections : [];\n\n  return createRoutes(config.base, sections).map((route: Route) => {\n    return {\n      href: route.href,\n      route:\n        route.type === \"redirect\"\n          ? route\n          : {\n              type: \"page\",\n              content: route.page.content,\n              toc: route.page.toc,\n              sourceID: route.page.sourceID,\n              indexed: route.page.content.type !== \"andesine\" && !route.page.searchHidden,\n              markdown: createMarkdownPage(config, route.page),\n              context: createPageContext({\n                site,\n                sections: shownSections,\n                route,\n                pageActions: config.pageActions,\n                image: getSocialImage(config, route.href)\n              })\n            }\n    };\n  });\n};\nconst getStaticPaths = async (config: PagesConfig): Promise<StaticPath[]> => {\n  const routes = createSiteRoutes(config, await loadStaticSources(config));\n\n  return routes.map(({ href, route }) => {\n    return {\n      params: { path: toParam(href, config.base) },\n      props: { route }\n    };\n  });\n};\nconst getMarkdownPaths = async (config: PagesConfig): Promise<MarkdownPath[]> => {\n  const routes = createSiteRoutes(config, await loadStaticSources(config));\n\n  return routes.flatMap(({ href, route }) => {\n    return route.type === \"page\"\n      ? [{ params: { path: toParam(href, config.base) }, props: { markdown: route.markdown } }]\n      : [];\n  });\n};\nconst toSocialData = (context: PageRouteData[\"context\"]): SocialData => {\n  return {\n    siteName: context.site.name,\n    title: context.title,\n    description: context.description,\n    group: context.breadcrumbs.at(-1)?.label\n  };\n};\nconst getSocialPaths = async (config: PagesConfig): Promise<SocialPath[]> => {\n  const routes = createSiteRoutes(config, await loadStaticSources(config));\n\n  return routes.flatMap(({ href, route }) => {\n    return route.type === \"page\"\n      ? [\n          {\n            params: { path: toParam(href, config.base) },\n            props: { data: toSocialData(route.context) }\n          }\n        ]\n      : [];\n  });\n};\n/** The context of the not-found page, with the navigation of the first section. */\nconst getNotFoundContext = async (config: PagesConfig): Promise<PageContext> => {\n  const sections = createSections(config, await loadStaticSources(config));\n\n  const site = createSiteContext(config);\n  const title = \"Page not found\";\n\n  return {\n    site,\n    title,\n    meta: createPageMeta(site, { title }),\n    fragments: { summary: false, aside: false },\n    layout: \"docs\",\n    sections: config.sections.length ? toSectionContexts(sections) : [],\n    links: [...site.links, ...(sections[0]?.links ?? [])],\n    navigation: createNavigationItems(sections[0]?.navigation ?? [], []),\n    breadcrumbs: [],\n    headings: [],\n    noindex: true,\n    image: getSocialImage(config)\n  };\n};\nconst toOutline = (headings: HeadingContext[], toc: boolean): HeadingContext[] => {\n  return toc ? headings.filter((heading) => heading.depth >= 2 && heading.depth <= 3) : [];\n};\nconst renderRoute = async (\n  route: PageRouteData,\n  highlight: HighlightOptions\n): Promise<RenderedRoute> => {\n  if (route.content.type === \"openapi\" && route.content.operation) {\n    const { operation, model, links } = route.content;\n\n    return {\n      operation: await createOperationView(operation, model, {\n        highlight,\n        title: route.context.title,\n        href: links.operations[operation.id]!\n      }),\n      page: { ...route.context, headings: [] }\n    };\n  }\n\n  // Overview and tag pages show their Markdown.\n  if (route.content.type === \"openapi\") {\n    const prepared = await prepareMarkdown(\n      toOpenAPIMarkdown(route.content, (href) => href),\n      highlight\n    );\n\n    return {\n      nodes: prepared.nodes,\n      iconCSS: prepared.iconCSS,\n      page: { ...route.context, headings: toOutline(prepared.headings, route.toc) }\n    };\n  }\n\n  if (route.content.type === \"andesine\") {\n    return {\n      nodes: route.content.nodes,\n      summary: route.content.summary,\n      aside: route.content.aside,\n      iconCSS: route.content.iconCSS,\n      page: { ...route.context, headings: toOutline(route.content.headings, route.toc) }\n    };\n  }\n\n  const { Content, headings } = (await render(route.content.entry)) as {\n    Content: unknown;\n    headings: MarkdownHeading[];\n  };\n  const outline = headings.map((heading) => {\n    return {\n      id: heading.slug,\n      text: heading.text,\n      depth: heading.depth\n    };\n  });\n\n  return { Content, page: { ...route.context, headings: toOutline(outline, route.toc) } };\n};\n\nexport {\n  createSiteRoutes,\n  getStaticPaths,\n  getMarkdownPaths,\n  getSocialPaths,\n  getNotFoundContext,\n  renderRoute\n};\nexport type { SiteRoute, StaticPath, MarkdownPath, SocialPath, RenderedRoute };\n"],"mappings":"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"}

package/dist/chunks/skill-CBTGUHQH.js

@@ -0,0 +1,85 @@
+import { t as toSHA256 } from "./hash-D4piIIQ6.js";
+import { i as toLine } from "./markdown-DKJSQxR2.js";
+import { parse } from "yaml";
+//#region src/output/skill.ts
+/** A skill name: lowercase letters, digits, and single hyphens, up to 64 characters. */
+const toSkillName = (value) => {
+	return value.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z\d]+/g, "-").slice(0, 64).replace(/^-+|-+$/g, "") || "docs";
+};
+/** Reads the name and description of your own skill file, after the agentskills.io format. */
+const readSkill = (content) => {
+	const frontmatter = /^(?:\uFEFF)?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content)?.[1] ?? "";
+	const metadata = parse(frontmatter);
+	const { name, description } = typeof metadata === "object" && metadata !== null ? metadata : {};
+	if (!(typeof name === "string" && name === toSkillName(name) && typeof description === "string" && !!description.trim())) throw new Error("The skill file needs frontmatter with a `name` (lowercase letters, digits, and hyphens) and a `description`.");
+	return {
+		name,
+		description,
+		content
+	};
+};
+/**
+* Creates a skill after the agentskills.io format: what the site covers, when to use it, and
+* how to read the documentation.
+*/
+const createSkill = (config, catalog) => {
+	const url = (path) => new URL(`${config.base}${path}`, config.site).href;
+	const sections = catalog.sections.filter((section) => section.topics.length);
+	const topics = sections.flatMap((section) => section.topics.map((topic) => topic.label));
+	const description = `${config.description ? `${toLine(config.description)} ` : ""}Use when you work with ${toLine(config.name)} or need its documentation${topics.length ? `, for example: ${topics.join(", ")}` : ""}.`.slice(0, 1024);
+	const name = toSkillName(config.name);
+	const topicList = sections.map((section) => {
+		const links = section.topics.map((topic) => {
+			const summary = topic.page.description ? `: ${toLine(topic.page.description)}` : "";
+			return `- [${toLine(topic.label)}](${new URL(`${topic.page.href}index.md`, config.site).href})${summary}`;
+		});
+		return `### ${toLine(section.label)}\n\n${links.join("\n")}`;
+	});
+	return {
+		name,
+		description,
+		content: `${[
+			`---\nname: ${name}\ndescription: ${JSON.stringify(description)}\n---`,
+			`# ${toLine(config.name)}`,
+			...config.description ? [toLine(config.description)] : [],
+			[
+				"## Read the documentation",
+				"",
+				`- Find pages in the index: ${url("llms.txt")}`,
+				`- Read all pages in one file: ${url("llms-full.txt")}`,
+				"- Read one page as Markdown: add `index.md` to its URL, or replace the last `/` with `.md`."
+			].join("\n"),
+			...topicList.length ? [`## Topics\n\n${topicList.join("\n\n")}`] : [],
+			...config.agents.instructions ? [`## Instructions\n\n${config.agents.instructions}`] : []
+		].join("\n\n")}\n`
+	};
+};
+/** The skill of the site: your own file, or a generated one. */
+const loadSkill = async (config, custom, loadCatalog) => {
+	return custom ? readSkill(custom) : createSkill(config, await loadCatalog());
+};
+/** The discovery index after the agentskills.io discovery schema 0.2.0. */
+const createAgentSkillsIndex = async (config, skill) => {
+	return JSON.stringify({
+		$schema: "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+		skills: [{
+			name: skill.name,
+			type: "skill-md",
+			description: skill.description,
+			url: `${config.base}.well-known/agent-skills/${skill.name}/SKILL.md`,
+			digest: `sha256:${await toSHA256(skill.content)}`
+		}]
+	});
+};
+/** The index that the `skills` CLI reads. */
+const createSkillsIndex = (skill) => {
+	return JSON.stringify({ skills: [{
+		name: skill.name,
+		description: skill.description,
+		files: ["SKILL.md"]
+	}] });
+};
+//#endregion
+export { toSkillName as a, readSkill as i, createSkillsIndex as n, loadSkill as r, createAgentSkillsIndex as t };
+
+//# sourceMappingURL=skill-CBTGUHQH.js.map

package/dist/chunks/skill-CBTGUHQH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-CBTGUHQH.js","names":[],"sources":["../../src/output/skill.ts"],"sourcesContent":["import { parse } from \"yaml\";\nimport type { PagesConfig } from \"../config\";\nimport { toSHA256 } from \"../hash\";\nimport type { Catalog } from \"./catalog\";\nimport { toLine } from \"./markdown\";\n\ninterface Skill {\n  name: string;\n  description: string;\n  content: string;\n}\n\n/** A skill name: lowercase letters, digits, and single hyphens, up to 64 characters. */\nconst toSkillName = (value: string): string => {\n  return (\n    value\n      .normalize(\"NFKD\")\n      .replace(/[̀-ͯ]/g, \"\")\n      .toLowerCase()\n      .replace(/[^a-z\\d]+/g, \"-\")\n      .slice(0, 64)\n      .replace(/^-+|-+$/g, \"\") || \"docs\"\n  );\n};\n/** Reads the name and description of your own skill file, after the agentskills.io format. */\nconst readSkill = (content: string): Skill => {\n  const frontmatter = /^(?:\\uFEFF)?---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n|$)/.exec(content)?.[1] ?? \"\";\n  const metadata: unknown = parse(frontmatter);\n  const fields =\n    typeof metadata === \"object\" && metadata !== null ? (metadata as Record<string, unknown>) : {};\n  const { name, description } = fields;\n  const isValid =\n    typeof name === \"string\" &&\n    name === toSkillName(name) &&\n    typeof description === \"string\" &&\n    !!description.trim();\n\n  if (!isValid) {\n    throw new Error(\n      \"The skill file needs frontmatter with a `name` (lowercase letters, digits, and hyphens) and a `description`.\"\n    );\n  }\n\n  return { name, description, content };\n};\n/**\n * Creates a skill after the agentskills.io format: what the site covers, when to use it, and\n * how to read the documentation.\n */\nconst createSkill = (config: PagesConfig, catalog: Catalog): Skill => {\n  const url = (path: string): string => new URL(`${config.base}${path}`, config.site).href;\n  const sections = catalog.sections.filter((section) => section.topics.length);\n  const topics = sections.flatMap((section) => section.topics.map((topic) => topic.label));\n  const summary = config.description ? `${toLine(config.description)} ` : \"\";\n  const description =\n    `${summary}Use when you work with ${toLine(config.name)} or need its documentation${\n      topics.length ? `, for example: ${topics.join(\", \")}` : \"\"\n    }.`.slice(0, 1024);\n  const name = toSkillName(config.name);\n  const topicList = sections.map((section) => {\n    const links = section.topics.map((topic) => {\n      const summary = topic.page.description ? `: ${toLine(topic.page.description)}` : \"\";\n\n      return `- [${toLine(topic.label)}](${new URL(`${topic.page.href}index.md`, config.site).href})${summary}`;\n    });\n\n    return `### ${toLine(section.label)}\\n\\n${links.join(\"\\n\")}`;\n  });\n  const content = [\n    `---\\nname: ${name}\\ndescription: ${JSON.stringify(description)}\\n---`,\n    `# ${toLine(config.name)}`,\n    ...(config.description ? [toLine(config.description)] : []),\n    [\n      \"## Read the documentation\",\n      \"\",\n      `- Find pages in the index: ${url(\"llms.txt\")}`,\n      `- Read all pages in one file: ${url(\"llms-full.txt\")}`,\n      \"- Read one page as Markdown: add `index.md` to its URL, or replace the last `/` with `.md`.\"\n    ].join(\"\\n\"),\n    ...(topicList.length ? [`## Topics\\n\\n${topicList.join(\"\\n\\n\")}`] : []),\n    ...(config.agents.instructions ? [`## Instructions\\n\\n${config.agents.instructions}`] : [])\n  ].join(\"\\n\\n\");\n\n  return { name, description, content: `${content}\\n` };\n};\n/** The skill of the site: your own file, or a generated one. */\nconst loadSkill = async (\n  config: PagesConfig,\n  custom: string | undefined,\n  loadCatalog: () => Promise<Catalog>\n): Promise<Skill> => {\n  return custom ? readSkill(custom) : createSkill(config, await loadCatalog());\n};\n/** The discovery index after the agentskills.io discovery schema 0.2.0. */\nconst createAgentSkillsIndex = async (config: PagesConfig, skill: Skill): Promise<string> => {\n  return JSON.stringify({\n    $schema: \"https://schemas.agentskills.io/discovery/0.2.0/schema.json\",\n    skills: [\n      {\n        name: skill.name,\n        type: \"skill-md\",\n        description: skill.description,\n        url: `${config.base}.well-known/agent-skills/${skill.name}/SKILL.md`,\n        digest: `sha256:${await toSHA256(skill.content)}`\n      }\n    ]\n  });\n};\n/** The index that the `skills` CLI reads. */\nconst createSkillsIndex = (skill: Skill): string => {\n  return JSON.stringify({\n    skills: [{ name: skill.name, description: skill.description, files: [\"SKILL.md\"] }]\n  });\n};\n\nexport {\n  toSkillName,\n  readSkill,\n  createSkill,\n  loadSkill,\n  createAgentSkillsIndex,\n  createSkillsIndex\n};\nexport type { Skill };\n"],"mappings":"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"}