@tenphi/docs 0.15.0 → 0.17.0

package/dist/{config-DoR8g9IM.js → config-Ci9Nv0wQ.js}

@@ -9,6 +9,12 @@ const COOKBOOK_COMPONENT_NAMES = [
 	"Tab",
 	"Footer",
 	"Hero",
+	"PageFrame",
+	"HeaderFrame",
+	"HeaderLinks",
+	"Layout",
+	"SearchButton",
+	"TableOfContentsLayout",
 	"LanguageSelect",
 	"Logo",
 	"MarkdownCodeBlock",
@@ -21,6 +27,7 @@ const COOKBOOK_COMPONENT_NAMES = [
 	"MobileNavigationTabs",
 	"MobileTableOfContents",
 	"PackageVersion",
+	"VersionSwitcher",
 	"Preview",
 	"Sidebar",
 	"SocialIcons",
@@ -33,6 +40,37 @@ const COOKBOOK_COMPONENT_NAMES = [
 ];
 /** Named Tasty sub-elements available on each configurable Cookbook surface. */
 const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
+	PageFrame: [
+		"MainFrame",
+		"SidebarFrame",
+		"Columns"
+	],
+	HeaderFrame: [],
+	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",
@@ -104,8 +142,12 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 		"Heading5",
 		"Heading6",
 		"Link",
+		"RevealedLink",
 		"HoverLink",
-		"LinkIcon"
+		"LinkIcon",
+		"CopiedLink",
+		"CopiedLinkIcon",
+		"CopiedIcon"
 	],
 	MarkdownTable: [
 		"Table",
@@ -123,10 +165,16 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 	MobileMenuToggle: [
 		"Control",
 		"Icon",
+		"Section",
+		"Page",
 		"HoverControl",
 		"ActiveControl"
 	],
 	MobileNavigationTabs: [
+		"Trigger",
+		"Marker",
+		"Caret",
+		"ExpandedCaret",
 		"Label",
 		"List",
 		"Item",
@@ -143,6 +191,13 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 		"CurrentIndicator"
 	],
 	PackageVersion: [],
+	VersionSwitcher: [
+		"Trigger",
+		"Panel",
+		"OpenPanel",
+		"Link",
+		"CurrentLink"
+	],
 	Preview: [
 		"Caption",
 		"Stage",
@@ -152,14 +207,25 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 		"Pre"
 	],
 	Sidebar: [
+		"Backdrop",
+		"OpenBackdrop",
+		"MobileHeading",
+		"HomeLink",
+		"HomeLogo",
+		"HomeLabel",
+		"Close",
+		"HoverClose",
+		"CloseIcon",
 		"CurrentLink",
 		"OpenPane",
 		"Content",
+		"Tree",
 		"List",
 		"Item",
 		"TopLevelSpacing",
 		"GroupSpacing",
 		"NestedItem",
+		"SectionHeading",
 		"Control",
 		"Summary",
 		"GroupLabel",
@@ -168,6 +234,13 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 		"LinkLabel",
 		"InteractiveControl",
 		"SummaryMarker",
+		"Caret",
+		"ExpandedCaret",
+		"LinkedSummary",
+		"GroupLink",
+		"LinkedSectionHeading",
+		"SectionLink",
+		"Badge",
 		"TopLevelLink"
 	],
 	Steps: ["Item", "Marker"],
@@ -194,8 +267,10 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 	ThemeSelect: [
 		"Trigger",
 		"HoverTrigger",
+		"ActiveTrigger",
 		"Icon",
 		"Panel",
+		"OpenPanel",
 		"Section",
 		"SectionSpacing",
 		"SectionLabel",
@@ -219,6 +294,7 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 		"Primary",
 		"TitleAndSearch",
 		"Title",
+		"LogoLink",
 		"Logo",
 		"SiteTitle",
 		"Search",
@@ -231,13 +307,29 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 };
 //#endregion
 //#region src/config/index.ts
-const DEFAULT_BRAND = "#315efb";
+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",
@@ -259,10 +351,12 @@ const OBJECT_KEYS = {
 	site: /* @__PURE__ */ new Set([
 		"title",
 		"version",
+		"versions",
 		"description",
 		"url",
 		"repository",
-		"favicon"
+		"favicon",
+		"headerLinks"
 	]),
 	content: /* @__PURE__ */ new Set([
 		"sources",
@@ -276,6 +370,7 @@ const OBJECT_KEYS = {
 	theme: /* @__PURE__ */ new Set([
 		"brand",
 		"palette",
+		"fonts",
 		"states",
 		"tokens",
 		"presets",
@@ -319,6 +414,45 @@ function validateConfig(config) {
 		}
 		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 {
@@ -327,6 +461,15 @@ function validateConfig(config) {
 			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.");
@@ -397,13 +540,14 @@ function validateConfig(config) {
 		const variants = [
 			"file",
 			"glob",
-			"package"
+			"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, or package.`
+				message: `content.sources[${index}] must select exactly one of file, glob, package, or openapi.`
 			});
 			continue;
 		}
@@ -437,6 +581,12 @@ function validateConfig(config) {
 				"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}`);
@@ -499,10 +649,58 @@ function validateConfig(config) {
 		"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`);
@@ -522,6 +720,8 @@ function validateConfig(config) {
 	for (const [name, value] of Object.entries(config.theme?.palette ?? {})) {
 		if (![
 			"surface",
+			"header",
+			"overlay",
 			"text",
 			"textSoft",
 			"info",
@@ -529,14 +729,15 @@ function validateConfig(config) {
 			"warning",
 			"danger"
 		].includes(name)) unknown(diagnostics, `theme.palette.${name}`);
-		try {
-			glaze.color({ from: value }).resolve();
-		} catch (error) {
-			invalid(diagnostics, `theme.palette.${name}: ${error instanceof Error ? error.message : String(error)}`);
-		}
+		validatePaletteColor(name, value, diagnostics);
 	}
 	if (brand !== void 0) try {
-		glaze.color({ from: typeof brand === "object" && brand !== null && "from" in brand ? brand.from : brand }).resolve();
+		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)}`);
 	}
@@ -551,6 +752,46 @@ function validateConfig(config) {
 	}
 	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 }
+			},
+			"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",
@@ -568,6 +809,9 @@ function invalid(diagnostics, 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);
@@ -575,6 +819,25 @@ function isHttpUrl(value) {
 		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);
@@ -626,7 +889,7 @@ function defineDocsConfig(config) {
 	if (diagnostics.length > 0) throw new DocsConfigError(diagnostics);
 	return config;
 }
-/** Compose presets. Objects merge, arrays replace, and styles use Tasty semantics. */
+/** 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 };
@@ -640,6 +903,15 @@ function mergeDocsConfig(...configs) {
 		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] };
@@ -652,4 +924,4 @@ function mergeDocsConfig(...configs) {
 //#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-DoR8g9IM.js.map
+//# sourceMappingURL=config-Ci9Nv0wQ.js.map