@uni-design-system/uni-core 5.0.0 → 5.1.0

package/dist/esm/index.js

@@ -761,6 +761,43 @@ var Z_INDEX = {
 	overlay: 1080
 };
 //#endregion
+//#region src/concepts/generation/shadow.generator.ts
+var rgba = (hex, alpha) => {
+	const { red, green, blue } = hexToRgb(hex);
+	return `rgba(${red}, ${green}, ${blue}, ${alpha})`;
+};
+/**
+* Brand-tinted, theme-scoped elevation shadows (PRD §3.5.C).
+*
+* Light mode replaces the dead-neutral black stacks with a shadow ink pulled
+* toward the brand hue — dark and low-chroma enough to read as shadow, tinted
+* enough to kill the grey "mud" where shadows meet brand surfaces. Dark mode
+* goes near-zero: elevation is carried by the surface lightness steps, with
+* only a faint veil kept on floating overlays (menus/dialogs genuinely need
+* separation) and the `warn` glow tinted by the theme's own error color.
+*/
+var generateShadows = (colors, mode = "light") => {
+	const error = colors["error"] ?? "#CC2827";
+	if (mode === "dark") return {
+		raised: "none",
+		menu: `0px 4px 12px ${rgba("#000000", .45)}`,
+		dialog: `0px 8px 28px ${rgba("#000000", .55)}`,
+		warn: `0 0 5px ${rgba(error, .55)}, inset 0 0 5px ${rgba(error, .35)}`
+	};
+	const { h } = hexToOklch(colors["primary"] ?? "#000000");
+	const ink = oklchToHex({
+		l: .22,
+		c: .035,
+		h
+	});
+	return {
+		raised: `${rgba(ink, .2)} 0px 2px 1px -1px, ${rgba(ink, .14)} 0px 1px 1px 0px, ${rgba(ink, .12)} 0px 1px 3px 0px`,
+		menu: `${rgba(ink, .2)} 0px 3px 3px -2px, ${rgba(ink, .14)} 0px 3px 4px 0px, ${rgba(ink, .12)} 0px 1px 8px 0px`,
+		dialog: `${rgba(ink, .2)} 0px 3px 5px -1px, ${rgba(ink, .14)} 0px 6px 10px 0px, ${rgba(ink, .12)} 0px 1px 18px 0px`,
+		warn: `0 0 5px ${rgba(error, .5)}, inset 0 0 5px ${rgba(error, .3)}`
+	};
+};
+//#endregion
 //#region src/concepts/theme/themes/base.theme.ts
 var BaseTypography = {
 	"display-large": {
@@ -1336,12 +1373,16 @@ var createTheme = ({ id, name, colors, icons = {}, radii = BaseRadii, shadows =
 * one-call path a theme builder uses to turn a brand color (or a seed +
 * scheme + category) into a complete, ready-to-apply theme.
 */
-var createThemeFromPalette = (config) => createTheme({
-	id: config.id ?? "CustomTheme",
-	name: config.name ?? "Custom Theme",
-	colors: generatePalette(config),
-	icons: config.icons
-});
+var createThemeFromPalette = (config) => {
+	const colors = generatePalette(config);
+	return createTheme({
+		id: config.id ?? "CustomTheme",
+		name: config.name ?? "Custom Theme",
+		colors,
+		shadows: generateShadows(colors, config.mode ?? "light"),
+		icons: config.icons
+	});
+};
 /**
 * Seed for the shipped Light/Dark themes. Swap these three values (or call
 * `generatePalette` with your own) to reskin the entire system — every color
@@ -1464,6 +1505,8 @@ var generateThemes = (input) => {
 		lightColors,
 		darkColors,
 		radii: input.shape ? ShapeRadii[input.shape] : void 0,
+		lightShadows: generateShadows(lightColors, "light"),
+		darkShadows: generateShadows(darkColors, "dark"),
 		report: {
 			checks,
 			worstRatio,
@@ -1476,7 +1519,7 @@ var generateThemes = (input) => {
 * returning a registration-ready light/dark {@link UniTheme} pair.
 */
 var generateUniThemes = (input) => {
-	const { lightColors, darkColors, radii } = generateThemes(input);
+	const { lightColors, darkColors, radii, lightShadows, darkShadows } = generateThemes(input);
 	const name = input.name ?? "Brand";
 	const id = name.replace(/\W+/g, "") || "Brand";
 	return {
@@ -1484,13 +1527,15 @@ var generateUniThemes = (input) => {
 			id: `${id}Light`,
 			name: `${name} Light`,
 			colors: lightColors,
-			radii
+			radii,
+			shadows: lightShadows
 		}),
 		dark: createTheme({
 			id: `${id}Dark`,
 			name: `${name} Dark`,
 			colors: darkColors,
-			radii
+			radii,
+			shadows: darkShadows
 		})
 	};
 };
@@ -1507,24 +1552,25 @@ var bordersLiteral = () => [
 	" * shared token picks up the change.",
 	" */",
 	"const borders = (colors: Colors): Borders => ({",
-	"  primary: `1px solid ${colors.primary}`,",
-	"  secondary: `1px solid ${colors.secondary}`,",
-	"  tertiary: `1px solid ${colors.tertiary}`,",
-	"  quaternary: `1px solid ${colors.quaternary}`,",
-	"  warn: `1px solid ${colors.warn}`,",
-	"  success: `1px solid ${colors.success}`,",
-	"  light: `1px solid ${colors.outline}`,",
+	"  primary: `1px solid ${colors['primary']}`,",
+	"  secondary: `1px solid ${colors['secondary']}`,",
+	"  tertiary: `1px solid ${colors['tertiary']}`,",
+	"  quaternary: `1px solid ${colors['quaternary']}`,",
+	"  warn: `1px solid ${colors['warn']}`,",
+	"  success: `1px solid ${colors['success']}`,",
+	"  light: `1px solid ${colors['outline']}`,",
 	"  dark: `1px solid ${colors['on-background']}`,",
 	"  dotted: `1px dotted ${colors['on-background']}`,",
 	"});"
 ].join("\n");
-var themeExport = (exportName, displayName, colorsConst, radii) => [
+var themeExport = (exportName, displayName, colorsConst, shadowsConst, radii) => [
 	`export const ${exportName}: UniTheme = createTheme({`,
 	`  id: '${exportName}',`,
 	`  name: '${displayName}',`,
 	`  colors: ${colorsConst},`,
 	`  borders: borders(${colorsConst}),`,
 	`  components: components(${colorsConst}),`,
+	`  shadows: ${shadowsConst},`,
 	...radii ? ["  radii,"] : [],
 	"});"
 ].join("\n");
@@ -1539,7 +1585,7 @@ var themeExport = (exportName, displayName, colorsConst, radii) => [
 */
 var emitThemeFile = (input) => {
 	const { darkMode = true, name = "Brand" } = input;
-	const { lightColors, darkColors, radii, report } = generateThemes(input);
+	const { lightColors, darkColors, radii, lightShadows, darkShadows, report } = generateThemes(input);
 	const id = name.replace(/\W+/g, "") || "Brand";
 	const regenerate = [
 		`--brand=${(Array.isArray(input.seed) ? input.seed : [input.seed]).join(",")}`,
@@ -1553,12 +1599,16 @@ var emitThemeFile = (input) => {
 		exportName: `${id}Light`,
 		displayName: `${name} Light`,
 		colorsConst: "lightColors",
-		colors: lightColors
+		colors: lightColors,
+		shadowsConst: "lightShadows",
+		shadows: lightShadows
 	}, ...darkMode ? [{
 		exportName: `${id}Dark`,
 		displayName: `${name} Dark`,
 		colorsConst: "darkColors",
-		colors: darkColors
+		colors: darkColors,
+		shadowsConst: "darkShadows",
+		shadows: darkShadows
 	}] : []];
 	return {
 		content: [
@@ -1575,16 +1625,19 @@ var emitThemeFile = (input) => {
 			"  type Borders,",
 			"  type Colors,",
 			"  type ComponentThemes,",
+			"  type Shadows,",
 			"  type UniTheme,",
 			"} from '@uni-design-system/uni-core';",
 			"",
 			...modes.map(({ colorsConst, colors }) => `const ${colorsConst}: Colors = {\n${recordLiteral(colors, "  ")}\n};\n`),
+			"/** Brand-tinted elevation shadows — theme-scoped, edit freely. */",
+			...modes.map(({ shadowsConst, shadows }) => `const ${shadowsConst}: Shadows = {\n${recordLiteral(shadows, "  ")}\n};\n`),
 			bordersLiteral(),
 			"",
 			"/**",
 			" * Sparse component overrides, deep-merged over Uni component defaults: only",
 			" * what you write here changes. Point components at your own primitives, e.g.:",
-			" *   button: { variants: { secondary: { border: `2px dashed ${colors.tertiary}` } } },",
+			" *   button: { variants: { secondary: { border: `2px dashed ${colors['tertiary']}` } } },",
 			" *   input: { options: { borderRadius: 'max' } },",
 			" */",
 			"const components = (colors: Colors): ComponentThemes => ({});",
@@ -1594,7 +1647,7 @@ var emitThemeFile = (input) => {
 				`const radii = {\n${recordLiteral(radii, "  ")}\n};`,
 				""
 			] : [],
-			...modes.map(({ exportName, displayName, colorsConst }) => `${themeExport(exportName, displayName, colorsConst, !!radii)}\n`),
+			...modes.map(({ exportName, displayName, colorsConst, shadowsConst }) => `${themeExport(exportName, displayName, colorsConst, shadowsConst, !!radii)}\n`),
 			"/** First key wins as the default theme when registered via UNI_THEMES. */",
 			`export const ${id}Themes = { ${modes.map((m) => m.exportName).join(", ")} };`,
 			""
@@ -1729,14 +1782,16 @@ var darkColors = generatePalette({
 var DarkTheme = createTheme({
 	id: "DarkTheme",
 	name: "Dark Theme",
-	colors: darkColors
+	colors: darkColors,
+	shadows: generateShadows(darkColors, "dark")
 });
 //#endregion
 //#region src/concepts/theme/themes/light.theme.ts
 var LightTheme = createTheme({
 	id: "LightTheme",
 	name: "Light Theme",
-	colors: lightColors
+	colors: lightColors,
+	shadows: generateShadows(lightColors, "light")
 });
 //#endregion
 //#region src/concepts/theme/theme.records.ts
@@ -1795,6 +1850,6 @@ var debounce = (callback, timeout) => {
 	};
 };
 //#endregion
-export { BASE_PALETTE_CONFIG, BaseTheme, CategoryChroma, CategoryLightness, CategorySaturation, DarkTheme, DefaultThemeId, FontWeightMap, HSLAToString, HSLToHex, HSLToRGB, LightTheme, RGBToHSL, RGBToString, RoleHues, ShadowCssMap, ShadowMap, ShapeRadii, UniThemes, Z_INDEX, classifyScheme, collapseFadeOut, contrastRatio, createTheme, createThemeFromPalette, cycle, darkColors, debounce, emitThemeFile, expandFadeIn, fadeIn, fadeOut, generateColors, generatePalette, generateThemes, generateUniThemes, getAnalogousHues, getComplimentaryHue, getDeviceOrientation, getDeviceSize, getSplitComplimentaryHues, getTriadicHues, getValue, gradient, hexToHSL, hexToOklch, hexToRgb, inferCategory, lightColors, oklchToHex, randomRangeValue, relativeLuminance, removeInputPlatformStyling, rgbToHex, schemeHues, toTypeface, toTypefaces, uniColor };
+export { BASE_PALETTE_CONFIG, BaseTheme, CategoryChroma, CategoryLightness, CategorySaturation, DarkTheme, DefaultThemeId, FontWeightMap, HSLAToString, HSLToHex, HSLToRGB, LightTheme, RGBToHSL, RGBToString, RoleHues, ShadowCssMap, ShadowMap, ShapeRadii, UniThemes, Z_INDEX, classifyScheme, collapseFadeOut, contrastRatio, createTheme, createThemeFromPalette, cycle, darkColors, debounce, emitThemeFile, expandFadeIn, fadeIn, fadeOut, generateColors, generatePalette, generateShadows, generateThemes, generateUniThemes, getAnalogousHues, getComplimentaryHue, getDeviceOrientation, getDeviceSize, getSplitComplimentaryHues, getTriadicHues, getValue, gradient, hexToHSL, hexToOklch, hexToRgb, inferCategory, lightColors, oklchToHex, randomRangeValue, relativeLuminance, removeInputPlatformStyling, rgbToHex, schemeHues, toTypeface, toTypefaces, uniColor };
 
 //# sourceMappingURL=index.js.map