@tenphi/docs 0.17.1 → 0.18.0

package/dist/config-CW0iIYp8.js

@@ -1,942 +0,0 @@
-import { glaze } from "@tenphi/glaze";
-import { mergeStyles } from "@tenphi/tasty/core";
-//#region src/types.ts
-/** Cookbook UI surfaces whose default Tasty styles can be customized. */
-const COOKBOOK_COMPONENT_NAMES = [
-	"Card",
-	"Callout",
-	"CodeGroup",
-	"Tab",
-	"Footer",
-	"Hero",
-	"PageFrame",
-	"HeaderFrame",
-	"HeaderLinks",
-	"Heading",
-	"Layout",
-	"SearchButton",
-	"TableOfContentsLayout",
-	"LanguageSelect",
-	"Logo",
-	"MarkdownCodeBlock",
-	"MarkdownHeading",
-	"MarkdownInlineCode",
-	"MarkdownTable",
-	"Mermaid",
-	"MobileMenuFooter",
-	"MobileMenuToggle",
-	"MobileNavigationTabs",
-	"MobileTableOfContents",
-	"PackageVersion",
-	"VersionSwitcher",
-	"Preview",
-	"Sidebar",
-	"SocialIcons",
-	"Steps",
-	"Tabs",
-	"TableOfContents",
-	"ThemeSelect",
-	"TopNavigation",
-	"StarlightHeader"
-];
-/** Named Tasty sub-elements available on each configurable Cookbook surface. */
-const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
-	PageFrame: [
-		"MainFrame",
-		"SidebarFrame",
-		"Columns"
-	],
-	HeaderFrame: [],
-	Heading: [
-		"Level1",
-		"Level2",
-		"Level3",
-		"Level4",
-		"Level5",
-		"Level6",
-		"PageTitle"
-	],
-	HeaderLinks: [
-		"Desktop",
-		"Link",
-		"HoverLink",
-		"PrimaryLink",
-		"HoverPrimaryLink",
-		"Trigger",
-		"HoverTrigger",
-		"Panel",
-		"PanelNavigation",
-		"PanelLink",
-		"FirstPanelLink",
-		"Close",
-		"HoverClose"
-	],
-	Layout: ["LockedPage"],
-	SearchButton: [
-		"Label",
-		"Shortcut",
-		"Hover",
-		"Active",
-		"NativeIcon",
-		"Icon"
-	],
-	TableOfContentsLayout: ["Content"],
-	Card: [
-		"Heading2",
-		"Heading3",
-		"Paragraph"
-	],
-	Callout: [
-		"Title",
-		"Body",
-		"Tip",
-		"Caution",
-		"Danger"
-	],
-	CodeGroup: [
-		"Caption",
-		"Pre",
-		"Code"
-	],
-	Tab: [
-		"Heading",
-		"Hidden",
-		"HiddenHeading"
-	],
-	Footer: [
-		"Meta",
-		"LoneMetaItem",
-		"MetaLink",
-		"HoverMetaLink",
-		"Credit",
-		"CreditLink",
-		"HoverCreditLink"
-	],
-	Hero: [
-		"Visual",
-		"Stack",
-		"Copy",
-		"Title",
-		"Tagline",
-		"Actions",
-		"Action",
-		"HoverAction",
-		"PrimaryAction",
-		"SecondaryAction",
-		"MinimalAction",
-		"ActionIcon"
-	],
-	LanguageSelect: [
-		"Label",
-		"HoverLabel",
-		"LabelIcon",
-		"Select",
-		"Caret",
-		"Option"
-	],
-	Logo: ["Svg", "Mark"],
-	MarkdownCodeBlock: [
-		"Pre",
-		"CopyButton",
-		"HoverCopyButton",
-		"CopiedButton",
-		"CopyIcon",
-		"CopiedIcon"
-	],
-	MarkdownHeading: [
-		"Heading",
-		"Heading1",
-		"Heading2",
-		"Heading3",
-		"Heading4",
-		"Heading5",
-		"Heading6",
-		"Link",
-		"RevealedLink",
-		"HoverLink",
-		"LinkIcon",
-		"CopiedLink",
-		"CopiedLinkIcon",
-		"CopiedIcon"
-	],
-	MarkdownTable: [
-		"Table",
-		"Cell",
-		"LastBodyRowCell",
-		"HeaderCell"
-	],
-	MarkdownInlineCode: [],
-	Mermaid: [
-		"Diagram",
-		"Text",
-		"MonoText"
-	],
-	MobileMenuFooter: ["Social"],
-	MobileMenuToggle: [
-		"Control",
-		"Icon",
-		"Section",
-		"Page",
-		"HoverControl",
-		"ActiveControl"
-	],
-	MobileNavigationTabs: [
-		"Trigger",
-		"Marker",
-		"Caret",
-		"ExpandedCaret",
-		"Label",
-		"List",
-		"Item",
-		"Link",
-		"HoverLink",
-		"CurrentLink"
-	],
-	MobileTableOfContents: [
-		"Item",
-		"Link",
-		"LinkLabel",
-		"HoverLink",
-		"CurrentLink",
-		"CurrentIndicator"
-	],
-	PackageVersion: [],
-	VersionSwitcher: [
-		"Trigger",
-		"Panel",
-		"OpenPanel",
-		"Link",
-		"CurrentLink"
-	],
-	Preview: [
-		"Caption",
-		"Stage",
-		"Frame",
-		"Code",
-		"Summary",
-		"Pre"
-	],
-	Sidebar: [
-		"Backdrop",
-		"OpenBackdrop",
-		"MobileHeading",
-		"HomeLink",
-		"HomeLogo",
-		"HomeLabel",
-		"Close",
-		"HoverClose",
-		"CloseIcon",
-		"CurrentLink",
-		"OpenPane",
-		"Content",
-		"Tree",
-		"List",
-		"Item",
-		"TopLevelSpacing",
-		"GroupSpacing",
-		"NestedItem",
-		"SectionHeading",
-		"Control",
-		"Summary",
-		"GroupLabel",
-		"GroupLabelText",
-		"Link",
-		"LinkLabel",
-		"InteractiveControl",
-		"SummaryMarker",
-		"Caret",
-		"ExpandedCaret",
-		"LinkedSummary",
-		"GroupLink",
-		"LinkedSectionHeading",
-		"SectionLink",
-		"Badge",
-		"TopLevelLink"
-	],
-	Steps: ["Item", "Marker"],
-	SocialIcons: [
-		"Link",
-		"HoverLink",
-		"Icon"
-	],
-	Tabs: [
-		"List",
-		"Button",
-		"SelectedButton",
-		"FocusedButton"
-	],
-	TableOfContents: [
-		"Heading",
-		"List",
-		"Item",
-		"Link",
-		"LinkLabel",
-		"HoverLink",
-		"CurrentLink"
-	],
-	ThemeSelect: [
-		"Trigger",
-		"HoverTrigger",
-		"ActiveTrigger",
-		"Icon",
-		"Panel",
-		"OpenPanel",
-		"Section",
-		"SectionSpacing",
-		"SectionLabel",
-		"Option",
-		"HoverOption",
-		"CheckedOption",
-		"FocusedOption",
-		"Input",
-		"OptionIcon",
-		"Checkmark",
-		"SelectedCheckmark"
-	],
-	TopNavigation: [
-		"Scrollbar",
-		"Link",
-		"HoverLink",
-		"CurrentLink",
-		"ActiveIndicator"
-	],
-	StarlightHeader: [
-		"Primary",
-		"TitleAndSearch",
-		"Title",
-		"LogoLink",
-		"Logo",
-		"SiteTitle",
-		"Search",
-		"SearchElement",
-		"Tools",
-		"ToolItem",
-		"Social",
-		"MobileTheme"
-	]
-};
-//#endregion
-//#region src/config/index.ts
-const DEFAULT_BRAND = "okhsl(266 68% 48%)";
-const HEAD_KEYS = /* @__PURE__ */ new Set([
-	"tag",
-	"attrs",
-	"content"
-]);
-const SITE_ICON_KEYS = /* @__PURE__ */ new Set(["source", "background"]);
-const COLOR_DECLARATION_KEYS = /* @__PURE__ */ new Set([
-	"from",
-	"tone",
-	"saturation",
-	"hue",
-	"darkHue",
-	"darkSaturation",
-	"base",
-	"contrast",
-	"mode",
-	"autoFlip",
-	"opacity",
-	"pastel",
-	"role",
-	"inherit"
-]);
-const ROOT_KEYS = /* @__PURE__ */ new Set([
-	"root",
-	"redirects",
-	"site",
-	"head",
-	"editLink",
-	"lastUpdated",
-	"locales",
-	"defaultLocale",
-	"content",
-	"navigation",
-	"theme",
-	"markdown",
-	"search",
-	"components",
-	"build"
-]);
-const OBJECT_KEYS = {
-	site: /* @__PURE__ */ new Set([
-		"title",
-		"version",
-		"versions",
-		"description",
-		"url",
-		"repository",
-		"favicon",
-		"headerLinks"
-	]),
-	content: /* @__PURE__ */ new Set([
-		"sources",
-		"allowOutsideRoot",
-		"localizeRepositoryLinks",
-		"frontmatter"
-	]),
-	markdown: /* @__PURE__ */ new Set(["stripLeadingBadges", "rawHtml"]),
-	search: /* @__PURE__ */ new Set(["enabled"]),
-	components: /* @__PURE__ */ new Set(["overrides"]),
-	theme: /* @__PURE__ */ new Set([
-		"brand",
-		"palette",
-		"fonts",
-		"states",
-		"tokens",
-		"presets",
-		"styles",
-		"customStyles",
-		"contrastLevel"
-	]),
-	build: /* @__PURE__ */ new Set([
-		"strict",
-		"ci",
-		"cacheDir",
-		"maxArtifactBytes",
-		"maxUnpackedBytes",
-		"maxFiles",
-		"maxPathDepth",
-		"maxAssetBytes"
-	])
-};
-var DocsConfigError = class extends Error {
-	diagnostics;
-	constructor(diagnostics) {
-		super(diagnostics.map((diagnostic) => diagnostic.message).join("\n"));
-		this.name = "DocsConfigError";
-		this.diagnostics = diagnostics;
-	}
-};
-function validateConfig(config) {
-	const diagnostics = [];
-	if (config === null || typeof config !== "object" || Array.isArray(config)) {
-		invalid(diagnostics, "Documentation configuration must be an object.");
-		return diagnostics;
-	}
-	if (config.root !== void 0 && typeof config.root !== "string") invalid(diagnostics, "root must be a directory path.");
-	for (const key of Object.keys(config)) if (!ROOT_KEYS.has(key)) unknown(diagnostics, key);
-	for (const [section, keys] of Object.entries(OBJECT_KEYS)) {
-		const value = config[section];
-		if (value === void 0) continue;
-		if (!isRecord(value)) {
-			invalid(diagnostics, `${section} must be an object.`);
-			continue;
-		}
-		for (const key of Object.keys(value)) if (!keys.has(key)) unknown(diagnostics, `${section}.${key}`);
-	}
-	if (isRecord(config.site) && config.site.versions !== void 0) {
-		if (!Array.isArray(config.site.versions) || config.site.versions.length < 2) invalid(diagnostics, "site.versions must contain at least two versions.");
-		else {
-			const bases = /* @__PURE__ */ new Set();
-			for (const [index, version] of config.site.versions.entries()) {
-				const path = `site.versions[${index}]`;
-				if (!isRecord(version)) {
-					invalid(diagnostics, `${path} must be an object.`);
-					continue;
-				}
-				for (const key of Object.keys(version)) if (key !== "label" && key !== "routeBase") unknown(diagnostics, `${path}.${key}`);
-				if (typeof version.label !== "string" || !version.label.trim()) invalid(diagnostics, `${path}.label must be a non-empty string.`);
-				const base = version.routeBase;
-				if (typeof base !== "string" || !base.startsWith("/") || base !== "/" && base.endsWith("/") || base.includes("//") || /[?#\\\s]/.test(base) || base.split("/").some((segment) => segment === "." || segment === "..")) invalid(diagnostics, `${path}.routeBase must be a root-relative route without a trailing slash.`);
-				else if (bases.has(base)) invalid(diagnostics, `${path}.routeBase duplicates ${base}.`);
-				else bases.add(base);
-			}
-		}
-	}
-	if (isRecord(config.site) && config.site.headerLinks !== void 0) {
-		if (!Array.isArray(config.site.headerLinks)) invalid(diagnostics, "site.headerLinks must be an array.");
-		else config.site.headerLinks.forEach((item, index) => {
-			const path = `site.headerLinks[${index}]`;
-			if (!isRecord(item)) {
-				invalid(diagnostics, `${path} must be an object.`);
-				return;
-			}
-			for (const key of Object.keys(item)) if (![
-				"label",
-				"link",
-				"variant",
-				"newTab"
-			].includes(key)) unknown(diagnostics, `${path}.${key}`);
-			if (typeof item.label !== "string" || !item.label.trim()) invalid(diagnostics, `${path}.label must be a non-empty string.`);
-			if (typeof item.link !== "string" || /[\\\s]/.test(item.link) || !(/^(?:\/(?!\/)|#)/.test(item.link) || isHttpUrl(item.link))) invalid(diagnostics, `${path}.link must be an HTTP(S) URL, root-relative route, or fragment.`);
-			if (item.variant !== void 0 && !["default", "primary"].includes(item.variant)) invalid(diagnostics, `${path}.variant must be "default" or "primary".`);
-			if (item.newTab !== void 0 && typeof item.newTab !== "boolean") invalid(diagnostics, `${path}.newTab must be a boolean.`);
-		});
-	}
-	if (config.navigation !== void 0 && !Array.isArray(config.navigation)) {
-		if (!isRecord(config.navigation)) invalid(diagnostics, "navigation must be an array or object.");
-		else {
-			for (const key of Object.keys(config.navigation)) if (!(/* @__PURE__ */ new Set(["items", "tabs"])).has(key)) unknown(diagnostics, `navigation.${key}`);
-			if (config.navigation.items !== void 0 && !Array.isArray(config.navigation.items)) invalid(diagnostics, "navigation.items must be an array.");
-			if (config.navigation.tabs !== void 0 && !Array.isArray(config.navigation.tabs)) invalid(diagnostics, "navigation.tabs must be an array.");
-		}
-	}
-	if (Array.isArray(config.navigation)) validateNavigationItems(config.navigation, "navigation", diagnostics);
-	else if (isRecord(config.navigation)) {
-		if (Array.isArray(config.navigation.items)) validateNavigationItems(config.navigation.items, "navigation.items", diagnostics);
-		if (Array.isArray(config.navigation.tabs)) for (const [index, tab] of config.navigation.tabs.entries()) {
-			const path = `navigation.tabs[${index}]`;
-			if (!isRecord(tab) || typeof tab.label !== "string" || typeof tab.link !== "string") invalid(diagnostics, `${path} must have a label and link.`);
-			else if (tab.items !== void 0) validateNavigationItems(tab.items, `${path}.items`, diagnostics);
-		}
-	}
-	if (config.redirects !== void 0 && (!isRecord(config.redirects) || Object.values(config.redirects).some((value) => typeof value !== "string"))) invalid(diagnostics, "redirects must map old routes to document routes.");
-	const head = config.head;
-	if (head !== void 0 && !Array.isArray(head)) invalid(diagnostics, "head must be an array.");
-	else for (const [index, entry] of (head ?? []).entries()) {
-		if (!isRecord(entry)) {
-			invalid(diagnostics, `head[${index}] must be an object.`);
-			continue;
-		}
-		for (const key of Object.keys(entry)) if (!HEAD_KEYS.has(key)) unknown(diagnostics, `head[${index}].${key}`);
-		if (typeof entry.tag !== "string") invalid(diagnostics, `head[${index}].tag must be a string.`);
-		if (entry.attrs !== void 0 && !isRecord(entry.attrs)) invalid(diagnostics, `head[${index}].attrs must be an object.`);
-		else for (const [name, value] of Object.entries(entry.attrs ?? {})) if (value !== void 0 && typeof value !== "string" && typeof value !== "boolean") invalid(diagnostics, `head[${index}].attrs.${name} must be a string or boolean.`);
-		if (entry.content !== void 0 && typeof entry.content !== "string") invalid(diagnostics, `head[${index}].content must be a string.`);
-	}
-	const favicon = config.site?.favicon;
-	if (favicon !== void 0) {
-		if (typeof favicon === "string") {
-			if (favicon.trim() === "") invalid(diagnostics, "site.favicon must be a non-empty local path.");
-		} else if (!isRecord(favicon)) invalid(diagnostics, "site.favicon must be a local path or an object with a source path.");
-		else {
-			for (const key of Object.keys(favicon)) if (!SITE_ICON_KEYS.has(key)) unknown(diagnostics, `site.favicon.${key}`);
-			if (typeof favicon.source !== "string" || favicon.source.trim() === "") invalid(diagnostics, "site.favicon.source must be a non-empty string.");
-			if (favicon.background !== void 0 && (typeof favicon.background !== "string" || favicon.background.trim() === "")) invalid(diagnostics, "site.favicon.background must be a non-empty color string.");
-		}
-	}
-	for (const field of ["url", "repository"]) {
-		const value = config.site?.[field];
-		if (value === void 0) continue;
-		if (typeof value !== "string" || !isHttpUrl(value)) invalid(diagnostics, `site.${field} must be an absolute HTTP(S) URL.`);
-	}
-	if (config.editLink !== void 0 && (!isRecord(config.editLink) || typeof config.editLink.baseUrl !== "string")) invalid(diagnostics, "editLink must contain a string baseUrl.");
-	else if (config.editLink !== void 0) {
-		for (const key of Object.keys(config.editLink)) if (key !== "baseUrl") unknown(diagnostics, `editLink.${key}`);
-		try {
-			new URL(config.editLink.baseUrl);
-		} catch {
-			invalid(diagnostics, "editLink.baseUrl must be an absolute URL.");
-		}
-	}
-	if (config.lastUpdated !== void 0 && typeof config.lastUpdated !== "boolean") invalid(diagnostics, "lastUpdated must be a boolean.");
-	if (config.locales !== void 0 && !isRecord(config.locales)) invalid(diagnostics, "locales must be an object.");
-	else for (const [key, locale] of Object.entries(config.locales ?? {})) {
-		if (!isRecord(locale) || typeof locale.label !== "string") {
-			invalid(diagnostics, `locales.${key} must contain a string label.`);
-			continue;
-		}
-		for (const property of Object.keys(locale)) if (![
-			"label",
-			"lang",
-			"dir"
-		].includes(property)) unknown(diagnostics, `locales.${key}.${property}`);
-		if (locale.lang !== void 0 && typeof locale.lang !== "string") invalid(diagnostics, `locales.${key}.lang must be a string.`);
-		if (locale.dir !== void 0 && locale.dir !== "ltr" && locale.dir !== "rtl") invalid(diagnostics, `locales.${key}.dir must be "ltr" or "rtl".`);
-	}
-	if (config.defaultLocale !== void 0 && typeof config.defaultLocale !== "string") invalid(diagnostics, "defaultLocale must be a string.");
-	else if (config.defaultLocale !== void 0 && (config.locales === void 0 || !(config.defaultLocale in config.locales))) invalid(diagnostics, `defaultLocale must match a key in locales; received "${config.defaultLocale}".`);
-	if (config.content?.allowOutsideRoot !== void 0 && typeof config.content.allowOutsideRoot !== "boolean") invalid(diagnostics, "content.allowOutsideRoot must be a boolean.");
-	if (config.content?.localizeRepositoryLinks !== void 0 && typeof config.content.localizeRepositoryLinks !== "boolean") invalid(diagnostics, "content.localizeRepositoryLinks must be a boolean.");
-	const configuredSources = config.content?.sources;
-	if (configuredSources !== void 0 && !Array.isArray(configuredSources)) invalid(diagnostics, "content.sources must be an array.");
-	const sources = Array.isArray(configuredSources) ? configuredSources : [];
-	for (const [index, source] of sources.entries()) {
-		if (!isRecord(source)) {
-			invalid(diagnostics, `content.sources[${index}] must be an object.`);
-			continue;
-		}
-		const sourceRecord = source;
-		const variants = [
-			"file",
-			"glob",
-			"package",
-			"openapi"
-		].filter((key) => key in source);
-		if (variants.length !== 1) {
-			diagnostics.push({
-				code: "DOCS_CONFIG_INVALID",
-				severity: "error",
-				message: `content.sources[${index}] must select exactly one of file, glob, package, or openapi.`
-			});
-			continue;
-		}
-		const variant = variants[0];
-		const allowed = {
-			file: /* @__PURE__ */ new Set([
-				"id",
-				"root",
-				"routeBase",
-				"file",
-				"route",
-				"title",
-				"description",
-				"navigation"
-			]),
-			glob: /* @__PURE__ */ new Set([
-				"id",
-				"root",
-				"glob",
-				"base",
-				"routeBase",
-				"exclude",
-				"navigation"
-			]),
-			package: /* @__PURE__ */ new Set([
-				"id",
-				"package",
-				"registry",
-				"include",
-				"exclude",
-				"index",
-				"routeBase",
-				"trust"
-			]),
-			openapi: /* @__PURE__ */ new Set([
-				"id",
-				"root",
-				"routeBase",
-				"openapi"
-			])
-		}[variant];
-		for (const key of Object.keys(source)) if (!allowed.has(key)) unknown(diagnostics, `content.sources[${index}].${key}`);
-		for (const field of [
-			"id",
-			"root",
-			"route",
-			"routeBase",
-			"base",
-			"index",
-			"title",
-			"description",
-			"registry"
-		]) if (sourceRecord[field] !== void 0 && typeof sourceRecord[field] !== "string") invalid(diagnostics, `content.sources[${index}].${field} must be a string.`);
-		if (typeof sourceRecord.id === "string" && !/^[a-zA-Z0-9_-]+$/.test(sourceRecord.id)) invalid(diagnostics, `content.sources[${index}].id must contain only letters, numbers, underscores, and hyphens.`);
-		if (sourceRecord.trust !== void 0 && !["markdown", "mdx"].includes(String(sourceRecord.trust))) invalid(diagnostics, `content.sources[${index}].trust must be "markdown" or "mdx".`);
-		if (typeof sourceRecord.registry === "string" && !isHttpUrl(sourceRecord.registry)) invalid(diagnostics, `content.sources[${index}].registry must be an absolute HTTP(S) URL.`);
-		const selector = sourceRecord[variant];
-		if (variant === "glob" ? typeof selector !== "string" && (!Array.isArray(selector) || selector.some((value) => typeof value !== "string")) : typeof selector !== "string" || selector.trim() === "") invalid(diagnostics, `content.sources[${index}].${variant} must be ${variant === "glob" ? "a string or string array" : "a non-empty string"}.`);
-		for (const list of ["include", "exclude"]) {
-			const value = sourceRecord[list];
-			if (value !== void 0 && (!Array.isArray(value) || value.some((entry) => typeof entry !== "string"))) invalid(diagnostics, `content.sources[${index}].${list} must be a string array.`);
-		}
-	}
-	if (config.markdown?.stripLeadingBadges !== void 0 && typeof config.markdown.stripLeadingBadges !== "boolean") invalid(diagnostics, "markdown.stripLeadingBadges must be a boolean.");
-	if (config.markdown?.rawHtml !== void 0 && ![
-		"allow",
-		"sanitize",
-		"strip",
-		"reject"
-	].includes(config.markdown.rawHtml)) invalid(diagnostics, "markdown.rawHtml must be \"allow\", \"sanitize\", \"strip\", or \"reject\".");
-	if (config.search?.enabled !== void 0 && typeof config.search.enabled !== "boolean") invalid(diagnostics, "search.enabled must be a boolean.");
-	for (const key of ["strict", "ci"]) {
-		const value = config.build?.[key];
-		if (value !== void 0 && typeof value !== "boolean") invalid(diagnostics, `build.${key} must be a boolean.`);
-	}
-	for (const key of [
-		"maxArtifactBytes",
-		"maxUnpackedBytes",
-		"maxFiles",
-		"maxPathDepth",
-		"maxAssetBytes"
-	]) {
-		const value = config.build?.[key];
-		if (value !== void 0 && (!Number.isSafeInteger(value) || value <= 0)) invalid(diagnostics, `build.${key} must be a positive integer.`);
-	}
-	const brand = config.theme?.brand;
-	if (typeof brand === "object" && brand !== null && "contrast" in brand && !brand.unsafeContrast) {
-		const target = brand.contrast?.apca;
-		const normal = Array.isArray(target) ? target[0] : target;
-		if (typeof normal === "number" && normal < 45) diagnostics.push({
-			code: "DOCS_CONFIG_INVALID",
-			severity: "error",
-			message: "theme.brand.contrast.apca cannot be below 45 without unsafeContrast.",
-			hint: "Remove the override, use 45 or higher, or explicitly set unsafeContrast: true."
-		});
-	}
-	if (config.content?.frontmatter !== void 0 && !["preserve", "reject"].includes(config.content.frontmatter)) invalid(diagnostics, "content.frontmatter must be \"preserve\" or \"reject\".");
-	for (const field of [
-		"styles",
-		"customStyles",
-		"palette",
-		"fonts",
-		"tokens",
-		"states",
-		"presets"
-	]) if (config.theme?.[field] !== void 0 && !isRecord(config.theme[field])) invalid(diagnostics, `theme.${field} must be an object.`);
-	if (isRecord(config.theme?.fonts)) for (const [role, font] of Object.entries(config.theme.fonts)) {
-		const path = `theme.fonts.${role}`;
-		if (![
-			"body",
-			"heading",
-			"code"
-		].includes(role)) {
-			unknown(diagnostics, path);
-			continue;
-		}
-		if (font === void 0) continue;
-		if (typeof font === "string") {
-			if (!validFontFamily(font)) invalid(diagnostics, `${path} must name a Google Fonts family.`);
-			continue;
-		}
-		if (!isRecord(font)) {
-			invalid(diagnostics, `${path} must be a Google Fonts name or font definition.`);
-			continue;
-		}
-		if ("google" in font) {
-			for (const key of Object.keys(font)) if (!["google", "weights"].includes(key)) unknown(diagnostics, `${path}.${key}`);
-			if (!validFontFamily(font.google)) invalid(diagnostics, `${path}.google must name a Google Fonts family.`);
-			if (font.weights !== void 0 && (!Array.isArray(font.weights) || font.weights.length === 0 || font.weights.some((weight) => !Number.isInteger(weight) || weight < 1 || weight > 1e3))) invalid(diagnostics, `${path}.weights must be a non-empty array of font weights from 1 to 1000.`);
-		} else {
-			for (const key of Object.keys(font)) if (!["family", "files"].includes(key)) unknown(diagnostics, `${path}.${key}`);
-			if (!validFontFamily(font.family)) invalid(diagnostics, `${path}.family must be a font family name.`);
-			if (!Array.isArray(font.files) || font.files.length === 0) {
-				invalid(diagnostics, `${path}.files must contain at least one font file.`);
-				continue;
-			}
-			font.files.forEach((file, index) => {
-				const filePath = `${path}.files[${index}]`;
-				if (!isRecord(file)) {
-					invalid(diagnostics, `${filePath} must be an object.`);
-					return;
-				}
-				for (const key of Object.keys(file)) if (![
-					"src",
-					"weight",
-					"style"
-				].includes(key)) unknown(diagnostics, `${filePath}.${key}`);
-				if (typeof file.src !== "string" || !/^\/(?!\/)[^\s"'()\\?#]+\.(?:woff2?|ttf|otf)$/.test(file.src) || file.src.split("/").some((segment) => segment === "." || segment === "..")) invalid(diagnostics, `${filePath}.src must be a root-relative .woff2, .woff, .ttf, or .otf public path.`);
-				if (file.weight !== void 0 && !(typeof file.weight === "number" && Number.isInteger(file.weight) && file.weight >= 1 && file.weight <= 1e3) && !(typeof file.weight === "string" && /^(?:[1-9]\d{0,2}|1000) (?:[1-9]\d{0,2}|1000)$/.test(file.weight) && Number(file.weight.split(" ")[0]) < Number(file.weight.split(" ")[1]))) invalid(diagnostics, `${filePath}.weight must be a weight from 1 to 1000 or an ascending range.`);
-				if (file.style !== void 0 && !["normal", "italic"].includes(file.style)) invalid(diagnostics, `${filePath}.style must be normal or italic.`);
-			});
-		}
-	}
-	for (const [name, entry] of Object.entries(config.theme?.styles ?? {})) {
-		if (!COOKBOOK_COMPONENT_NAMES.includes(name)) {
-			unknown(diagnostics, `theme.styles.${name}; register custom components under theme.customStyles`);
-			continue;
-		}
-		if (!isRecord(entry)) invalid(diagnostics, `theme.styles.${name} must be a Tasty style object.`);
-		else {
-			if ("mode" in entry) invalid(diagnostics, `theme.styles.${name} must contain only Tasty properties, without a mode wrapper.`);
-			const elements = COOKBOOK_COMPONENT_SUB_ELEMENTS[name];
-			for (const key of Object.keys(entry)) if (/^[A-Z]/.test(key) && !elements.includes(key)) unknown(diagnostics, `theme.styles.${name}.${key}`);
-		}
-	}
-	for (const [name, entry] of Object.entries(config.theme?.customStyles ?? {})) {
-		if (COOKBOOK_COMPONENT_NAMES.includes(name)) invalid(diagnostics, `Use theme.styles.${name} for a built-in component.`);
-		if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(name) || !isRecord(entry) || "mode" in entry) invalid(diagnostics, `theme.customStyles.${name} must be a named partial Tasty style object.`);
-	}
-	for (const [name, value] of Object.entries(config.theme?.palette ?? {})) {
-		if (![
-			"surface",
-			"header",
-			"overlay",
-			"text",
-			"heading",
-			"textSoft",
-			"info",
-			"success",
-			"warning",
-			"danger"
-		].includes(name)) unknown(diagnostics, `theme.palette.${name}`);
-		validatePaletteColor(name, value, diagnostics);
-	}
-	if (brand !== void 0) try {
-		if (isBrandDeclaration(brand)) glaze.color({
-			hue: brand.hue,
-			saturation: brand.saturation,
-			tone: brand.tone
-		}).resolve();
-		else glaze.color({ from: typeof brand === "object" && brand !== null && "from" in brand ? brand.from : brand }).resolve();
-	} catch (error) {
-		invalid(diagnostics, `theme.brand: ${error instanceof Error ? error.message : String(error)}`);
-	}
-	const contrast = config.theme?.contrastLevel;
-	if (contrast !== void 0 && contrast !== "auto" && (typeof contrast !== "number" || !Number.isFinite(contrast) || contrast < 0 || contrast > 100)) invalid(diagnostics, "theme.contrastLevel must be \"auto\" or a number from 0 to 100.");
-	const componentOverrides = config.components?.overrides;
-	if (componentOverrides !== void 0 && !isRecord(componentOverrides)) invalid(diagnostics, "components.overrides must be an object.");
-	else for (const [name, override] of Object.entries(componentOverrides ?? {})) {
-		if (typeof override === "string") continue;
-		if (name === "Footer" && override === false) continue;
-		invalid(diagnostics, `components.overrides.${name} must be an Astro component path${name === "Footer" ? " or false" : ""}.`);
-	}
-	return diagnostics;
-}
-function validatePaletteColor(name, value, diagnostics) {
-	try {
-		if (!isPaletteDeclaration(value)) {
-			glaze.color({ from: value }).resolve();
-			return;
-		}
-		for (const key of Object.keys(value)) if (!COLOR_DECLARATION_KEYS.has(key)) unknown(diagnostics, `theme.palette.${name}.${key}`);
-		const colorName = name === "textSoft" ? "text-soft" : name;
-		const theme = glaze(266, 68);
-		theme.colors({
-			surface: { tone: 98 },
-			"surface-2": {
-				base: "surface",
-				tone: "-2"
-			},
-			"accent-surface": { tone: 48 },
-			text: {
-				base: "surface",
-				contrast: { apca: 75 }
-			},
-			heading: {
-				base: "surface",
-				tone: 4
-			},
-			"text-soft": {
-				base: "surface",
-				contrast: { apca: 60 }
-			},
-			[colorName]: {
-				tone: colorName === "surface" ? 98 : 50,
-				...value
-			}
-		});
-		theme.resolve();
-	} catch (error) {
-		invalid(diagnostics, `theme.palette.${name}: ${error instanceof Error ? error.message : String(error)}`);
-	}
-}
-function isPaletteDeclaration(value) {
-	return typeof value === "object" && value !== null && !("h" in value || "r" in value || "c" in value);
-}
-function isBrandDeclaration(value) {
-	return isRecord(value) && "hue" in value && "saturation" in value && "tone" in value;
-}
-function unknown(diagnostics, path) {
-	diagnostics.push({
-		code: "DOCS_CONFIG_UNKNOWN_KEY",
-		severity: "error",
-		message: `Unknown configuration key "${path}".`
-	});
-}
-function invalid(diagnostics, message) {
-	diagnostics.push({
-		code: "DOCS_CONFIG_INVALID",
-		severity: "error",
-		message
-	});
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function validFontFamily(value) {
-	return typeof value === "string" && value.length <= 100 && /^[\p{L}\p{N} ._-]+$/u.test(value) && value.trim() === value && value.length > 0;
-}
-function isHttpUrl(value) {
-	try {
-		return ["http:", "https:"].includes(new URL(value).protocol);
-	} catch {
-		return false;
-	}
-}
-function validateNavigationItems(items, path, diagnostics) {
-	if (!Array.isArray(items)) {
-		invalid(diagnostics, `${path} must be an array.`);
-		return;
-	}
-	for (const [index, item] of items.entries()) {
-		const itemPath = `${path}[${index}]`;
-		if (typeof item === "string") continue;
-		if (!isRecord(item) || typeof item.label !== "string") {
-			invalid(diagnostics, `${itemPath} must be a route or a labeled navigation item.`);
-			continue;
-		}
-		if (("items" in item || "autogenerate" in item) && item.link !== void 0 && (typeof item.link !== "string" || !/^\/(?!\/)[^?#\\\s]*$/.test(item.link) || item.link.includes("//") || item.link.split("/").some((segment) => segment === "." || segment === ".."))) invalid(diagnostics, `${itemPath}.link must be a root-relative page route without a query or fragment.`);
-		if ("items" in item) validateNavigationItems(item.items, `${itemPath}.items`, diagnostics);
-		else if ("autogenerate" in item) {
-			if (!isRecord(item.autogenerate) || typeof item.autogenerate.directory !== "string") invalid(diagnostics, `${itemPath}.autogenerate.directory must be a directory path.`);
-		} else if (typeof item.link !== "string") invalid(diagnostics, `${itemPath}.link must be a URL or route.`);
-	}
-}
-function normalizeDocsConfig(config = {}) {
-	const diagnostics = validateConfig(config);
-	if (diagnostics.length > 0) throw new DocsConfigError(diagnostics);
-	const navigation = Array.isArray(config.navigation) ? { items: config.navigation } : config.navigation ?? {};
-	return {
-		redirects: { ...config.redirects },
-		site: { ...config.site },
-		head: [...config.head ?? []],
-		...config.editLink ? { editLink: { ...config.editLink } } : {},
-		lastUpdated: config.lastUpdated ?? false,
-		...config.locales ? { locales: { ...config.locales } } : {},
-		...config.defaultLocale ? { defaultLocale: config.defaultLocale } : {},
-		content: {
-			allowOutsideRoot: false,
-			localizeRepositoryLinks: false,
-			...config.content
-		},
-		navigation,
-		theme: {
-			...config.theme,
-			brand: config.theme?.brand ?? DEFAULT_BRAND
-		},
-		markdown: {
-			stripLeadingBadges: true,
-			rawHtml: "sanitize",
-			...config.markdown
-		},
-		search: {
-			enabled: true,
-			...config.search
-		},
-		components: { ...config.components },
-		build: {
-			strict: true,
-			ci: process.env.CI === "true",
-			base: "/",
-			cacheDir: "",
-			maxArtifactBytes: 26214400,
-			maxUnpackedBytes: 104857600,
-			maxFiles: 1e4,
-			maxPathDepth: 24,
-			maxAssetBytes: 20971520,
-			...config.build
-		}
-	};
-}
-function defineDocsConfig(config) {
-	const diagnostics = validateConfig(config);
-	if (diagnostics.length > 0) throw new DocsConfigError(diagnostics);
-	return config;
-}
-/** Compose presets. Color roles and fonts replace, other objects merge, and styles use Tasty semantics. */
-function mergeDocsConfig(...configs) {
-	const merge = (base, next) => {
-		const result = { ...base };
-		for (const [key, value] of Object.entries(next)) {
-			if (value === void 0) continue;
-			result[key] = isRecord(value) ? merge(isRecord(result[key]) ? result[key] : {}, value) : Array.isArray(value) ? [...value] : value;
-		}
-		return result;
-	};
-	return defineDocsConfig(configs.reduce((base, next) => {
-		const diagnostics = validateConfig(next);
-		if (diagnostics.length) throw new DocsConfigError(diagnostics);
-		const result = merge(base, next);
-		if (next.theme?.brand !== void 0) result.theme.brand = next.theme.brand;
-		if (next.theme?.palette) result.theme.palette = {
-			...base.theme?.palette,
-			...Object.fromEntries(Object.entries(next.theme.palette).filter(([, color]) => color !== void 0))
-		};
-		if (next.theme?.fonts) result.theme.fonts = {
-			...base.theme?.fonts,
-			...Object.fromEntries(Object.entries(next.theme.fonts).filter(([, font]) => font !== void 0))
-		};
-		for (const field of ["styles", "customStyles"]) {
-			if (!next.theme?.[field]) continue;
-			const styles = { ...base.theme?.[field] };
-			for (const [name, configured] of Object.entries(next.theme[field])) styles[name] = mergeStyles(styles[name] ?? {}, configured);
-			result.theme[field] = styles;
-		}
-		return result;
-	}, {}));
-}
-//#endregion
-export { validateConfig as a, normalizeDocsConfig as i, defineDocsConfig as n, COOKBOOK_COMPONENT_NAMES as o, mergeDocsConfig as r, COOKBOOK_COMPONENT_SUB_ELEMENTS as s, DocsConfigError as t };
-
-//# sourceMappingURL=config-CW0iIYp8.js.map