@tenphi/docs 0.31.4 → 0.33.0

package/dist/config/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as SocialImage, B as NavigationPlacement, C as DocsConfig, F as HeaderLink, H as NormalizedDocsConfig, I as LocaleConfig, J as SiteConfig, K as PageSeoConfig, L as MarkdownConfig, M as EditLinkConfig, N as FontLoadingConfig, P as HeadConfig, R as NavigationConfig, V as NavigationTab, X as SiteLogoConfig, Y as SiteIconConfig, Z as SiteSeoConfig, a as COOKBOOK_COMPONENT_NAMES, at as ThemePaletteColor, ct as ThemeTokens, d as ComponentStylesConfig, dt as TypographyPresets, et as TableOfContentsConfig, f as ComponentsConfig, i as BuildConfig, it as ThemeFonts, j as DocsSource, l as ComponentStyleConfig, m as CookbookComponentName, n as BrandDeclaration, nt as ThemeFont, ot as ThemePaletteConfig, p as ContentConfig, q as SearchConfig, r as BreadcrumbItem, rt as ThemeFontFile, s as COOKBOOK_COMPONENT_SUB_ELEMENTS, st as ThemeTokenValue, t as BrandConfig, tt as ThemeConfig, u as ComponentStyles, ut as TypographyPreset, w as DocsDiagnostic, z as NavigationItem } from "../types-Hl9VekAv.js";
+import { $ as SocialImage, B as NavigationPlacement, C as DocsConfig, F as HeaderLink, H as NormalizedDocsConfig, I as LocaleConfig, J as SiteConfig, K as PageSeoConfig, L as MarkdownConfig, M as EditLinkConfig, N as FontLoadingConfig, P as HeadConfig, R as NavigationConfig, V as NavigationTab, X as SiteLogoConfig, Y as SiteIconConfig, Z as SiteSeoConfig, a as COOKBOOK_COMPONENT_NAMES, at as ThemePaletteColor, ct as ThemeTokens, d as ComponentStylesConfig, dt as TypographyPresets, et as TableOfContentsConfig, f as ComponentsConfig, i as BuildConfig, it as ThemeFonts, j as DocsSource, l as ComponentStyleConfig, m as CookbookComponentName, n as BrandDeclaration, nt as ThemeFont, ot as ThemePaletteConfig, p as ContentConfig, q as SearchConfig, r as BreadcrumbItem, rt as ThemeFontFile, s as COOKBOOK_COMPONENT_SUB_ELEMENTS, st as ThemeTokenValue, t as BrandConfig, tt as ThemeConfig, u as ComponentStyles, ut as TypographyPreset, w as DocsDiagnostic, z as NavigationItem } from "../types-B9dD3gLN.js";
 //#region src/config/index.d.ts
 declare class DocsConfigError extends Error {
   readonly diagnostics: DocsDiagnostic[];

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/config/index.ts"],"mappings":";;cA8Ga,wBAAwB;WAC1B,aAAa;EAEtB,YAAY,aAAa;;iBAOX,eAAe,QAAQ,aAAa;iBAwpCpC,oBACd,SAAQ,aACP;iBAiDa,iBAAiB,QAAQ,aAAa;;iBAOtC,mBAAmB,SAAS,eAAe"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/config/index.ts"],"mappings":";;cA8Ga,wBAAwB;WAC1B,aAAa;EAEtB,YAAY,aAAa;;iBAOX,eAAe,QAAQ,aAAa;iBAkqCpC,oBACd,SAAQ,aACP;iBAiDa,iBAAiB,QAAQ,aAAa;;iBAOtC,mBAAmB,SAAS,eAAe"}

package/dist/config/index.js

@@ -1,2 +1,2 @@
-import { a as validateConfig, i as normalizeDocsConfig, n as defineDocsConfig, o as COOKBOOK_COMPONENT_NAMES, r as mergeDocsConfig, s as COOKBOOK_COMPONENT_SUB_ELEMENTS, t as DocsConfigError } from "../config-Rk58xKVe.js";
+import { a as validateConfig, i as normalizeDocsConfig, n as defineDocsConfig, o as COOKBOOK_COMPONENT_NAMES, r as mergeDocsConfig, s as COOKBOOK_COMPONENT_SUB_ELEMENTS, t as DocsConfigError } from "../config-CD6uBrzU.js";
 export { COOKBOOK_COMPONENT_NAMES, COOKBOOK_COMPONENT_SUB_ELEMENTS, DocsConfigError, defineDocsConfig, mergeDocsConfig, normalizeDocsConfig, validateConfig };

package/dist/config/schema.json

@@ -586,7 +586,7 @@
               "type": "boolean"
             },
             "shadowTuning": {
-              "type": "object"
+              "$ref": "#/$defs/lightingTuning"
             }
           }
         },
@@ -749,6 +749,14 @@
                 }
               }
             },
+            "CardGrid": {
+              "type": "object",
+              "propertyNames": {
+                "not": {
+                  "const": "mode"
+                }
+              }
+            },
             "Callout": {
               "type": "object",
               "propertyNames": {
@@ -1374,6 +1382,9 @@
         },
         {
           "$ref": "#/$defs/glazeShadow"
+        },
+        {
+          "$ref": "#/$defs/glazeGlow"
         }
       ]
     },
@@ -1464,7 +1475,7 @@
           ]
         },
         "tuning": {
-          "type": "object"
+          "$ref": "#/$defs/lightingTuning"
         },
         "pastel": {
           "type": "boolean"
@@ -1474,6 +1485,76 @@
         }
       }
     },
+    "glazeGlow": {
+      "type": "object",
+      "required": ["type", "bg", "intensity"],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "const": "glow"
+        },
+        "bg": {
+          "type": "string"
+        },
+        "fg": {
+          "type": "string"
+        },
+        "intensity": {
+          "oneOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 100
+              },
+              "minItems": 2,
+              "maxItems": 2
+            }
+          ]
+        },
+        "tuning": {
+          "$ref": "#/$defs/lightingTuning"
+        },
+        "pastel": {
+          "type": "boolean"
+        },
+        "inherit": {
+          "type": "boolean"
+        }
+      }
+    },
+    "lightingTuning": {
+      "description": "Glaze shadow and glow tuning: how much the object (fg) scales the step, and the pigment's tint, reach, and hue bleed.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "objectInfluence": {
+          "type": "number",
+          "minimum": 0
+        },
+        "tint": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "reach": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "hueBleed": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    },
     "glazeColorValue": {
       "oneOf": [
         {

package/dist/{config-Rk58xKVe.js → config-CD6uBrzU.js}

@@ -267,7 +267,7 @@ function resolveColorTheme(theme = {}) {
 		saturation: lightThemeSeed.s * 100,
 		darkHue: darkThemeSeed.h,
 		darkSaturation: darkThemeSaturation
-	}, void 0, glazeOptions);
+	}, glazeOptions);
 	const surfaceSaturation = declaredSurface ? surfaceInput.saturation ?? .05 : 1;
 	const darkSurfaceSaturation = declaredSurface ? surfaceInput.darkSaturation ?? surfaceSaturation * .7 : .35;
 	const darkSurfaceRampSaturation = (factor) => declaredSurface ? darkSurfaceSaturation * factor : saturationFactor(resolvedSurfaceSeed.dark.s * factor / .35, darkThemeSaturation / 100);
@@ -394,9 +394,7 @@ function resolveColorTheme(theme = {}) {
 		shadow: {
 			type: "shadow",
 			bg: "surface",
-			fg: "text",
-			intensity: [12, 20],
-			tuning: { alphaMax: theme.glaze?.shadowTuning?.alphaMax ?? .28 }
+			intensity: [8, 0]
 		},
 		...statusColors("info", theme.palette?.info, "#2563eb"),
 		...statusColors("success", theme.palette?.success, "#16a34a"),
@@ -600,7 +598,7 @@ function statusColors(name, input, fallback) {
 			contrast: { apca: [75, 90] },
 			mode: "auto"
 		},
-		[`${name}-surface`]: "type" in declaration && declaration.type === "shadow" ? {
+		[`${name}-surface`]: "type" in declaration && (declaration.type === "shadow" || declaration.type === "glow") ? {
 			base: "surface",
 			tone: "-2",
 			saturation: 0,
@@ -747,6 +745,7 @@ const COOKBOOK_PALETTE_NAMES = [
 const COOKBOOK_COMPONENT_NAMES = [
 	"Button",
 	"Card",
+	"CardGrid",
 	"Callout",
 	"CodeGroup",
 	"Tab",
@@ -961,15 +960,22 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 	Card: [
 		"Heading2",
 		"Heading3",
-		"Paragraph"
+		"Paragraph",
+		"Body"
 	],
+	CardGrid: ["Card"],
 	Callout: ["Title", "Body"],
 	CodeGroup: [
 		"Caption",
+		"MarkdownCodeBlock",
 		"Pre",
 		"Code"
 	],
-	Tab: ["Heading", "HiddenHeading"],
+	Tab: [
+		"Heading",
+		"HiddenHeading",
+		"Body"
+	],
 	MobileTableOfContents: [
 		"Summary",
 		"List",
@@ -1179,6 +1185,7 @@ const COOKBOOK_COMPONENT_SUB_ELEMENTS = {
 	],
 	Tabs: [
 		"List",
+		"Tab",
 		"Button",
 		"SelectedButton",
 		"FocusedButton"
@@ -1682,22 +1689,7 @@ function validateConfig(config) {
 				"eps"
 			].includes(key)) || typeof window.eps !== "number" || !Number.isFinite(window.eps) || window.eps <= 0)) invalid(diagnostics, `theme.glaze.${key} must be false, [lo, hi], or {lo, hi, eps} with an ascending 0–100 range.`);
 		}
-		const tuning = settings.shadowTuning;
-		if (tuning !== void 0) {
-			if (!isRecord(tuning)) invalid(diagnostics, "theme.glaze.shadowTuning must be an object.");
-			else for (const [key, value] of Object.entries(tuning)) {
-				if (![
-					"saturationFactor",
-					"maxSaturation",
-					"lightnessFactor",
-					"lightnessBounds",
-					"minGapTarget",
-					"alphaMax",
-					"bgHueBlend"
-				].includes(key)) unknown(diagnostics, `theme.glaze.shadowTuning.${key}`);
-				if ((Array.isArray(value) ? value : [value]).some((item) => typeof item !== "number" || !Number.isFinite(item) || item < 0 || item > 1) || key === "lightnessBounds" && (!Array.isArray(value) || value.length !== 2 || value[0] > value[1])) invalid(diagnostics, `theme.glaze.shadowTuning.${key} must use values from 0 to 1.`);
-			}
-		}
+		if (settings.shadowTuning !== void 0) validateLightingTuning("theme.glaze.shadowTuning", settings.shadowTuning, diagnostics);
 	}
 	if (isRecord(config.theme?.fontLoading)) {
 		const choices = {
@@ -1839,7 +1831,7 @@ function validatePaletteColor(name, value, diagnostics) {
 			"pastel",
 			"role",
 			"inherit"
-		] : value.type === "shadow" ? [
+		] : value.type === "shadow" || value.type === "glow" ? [
 			"type",
 			"bg",
 			"fg",
@@ -1849,10 +1841,28 @@ function validatePaletteColor(name, value, diagnostics) {
 			"inherit"
 		] : []) : COLOR_DECLARATION_KEYS;
 		for (const key of Object.keys(value)) if (!keys.has(key)) unknown(diagnostics, `theme.palette.${name}.${key}`);
+		if ("type" in value && (value.type === "shadow" || value.type === "glow") && value.tuning !== void 0) validateLightingTuning(`theme.palette.${name}.tuning`, value.tuning, diagnostics);
 	} catch (error) {
 		invalid(diagnostics, `theme.palette.${name}: ${error instanceof Error ? error.message : String(error)}`);
 	}
 }
+/**
+* Glaze 3 shadow and glow tuning. Cookbook never emits Glaze's HDR tier, so a
+* glow's `headroom` is rejected with the removed 2.x fields.
+*/
+function validateLightingTuning(path, tuning, diagnostics) {
+	if (!isRecord(tuning)) {
+		invalid(diagnostics, `${path} must be an object.`);
+		return;
+	}
+	for (const [key, value] of Object.entries(tuning)) if (![
+		"objectInfluence",
+		"tint",
+		"reach",
+		"hueBleed"
+	].includes(key)) unknown(diagnostics, `${path}.${key}`);
+	else if (value !== void 0 && (typeof value !== "number" || !Number.isFinite(value) || value < 0 || key !== "objectInfluence" && value > 1)) invalid(diagnostics, key === "objectInfluence" ? `${path}.objectInfluence must be a number of 0 or more.` : `${path}.${key} must be a number from 0 to 1.`);
+}
 function isPaletteDeclaration(value) {
 	return typeof value === "object" && value !== null && !("h" in value || "r" in value || "c" in value);
 }
@@ -2010,4 +2020,4 @@ function validFontWeight(weight) {
 //#endregion
 export { validateConfig as a, COOKBOOK_PALETTE_NAMES as c, routePath as d, routeUrl as f, validateTableOfContents as h, normalizeDocsConfig as i, resolveColorTheme as l, validateSeo as m, defineDocsConfig as n, COOKBOOK_COMPONENT_NAMES as o, routeVersion as p, mergeDocsConfig as r, COOKBOOK_COMPONENT_SUB_ELEMENTS as s, DocsConfigError as t, pagePublishing as u };
 
-//# sourceMappingURL=config-Rk58xKVe.js.map
+//# sourceMappingURL=config-CD6uBrzU.js.map