/// A mixin to apply styles to `light` mode.
/// It's useful for defining styles that should only appear in light mode.
///
/// @group Theming
///
/// @param {String} $mode — The mode created with the `daff-get-theme-mode` function.
///
/// @example scss
/// 	@use '@daffodil/design/scss/theme' as daff-theme;
///
/// 	@mixin custom-content-theme($theme) {
/// 		$mode: daff-theme.daff-get-theme-mode($theme);
///
/// 		@include daff-theme.daff-light-mode($mode) {
/// 			color: blue;
///
/// 			.class {
/// 				background: white;
/// 			}
/// 		}
/// 	}
///
@mixin daff-light-mode($mode) {
	@if $mode == 'light' {
		@content;
	}
}

/// This mixin applies its content only when the theme mode is `dark`.
/// It's useful for defining styles that should only appear in dark mode.
///
/// @group Theming
///
/// @param {String} $mode — The mode created with the `daff-get-theme-mode` function.
///
/// @example scss
/// 	@use '@daffodil/design/scss/theme' as daff-theme;
///
/// 	@mixin custom-content-theme($theme) {
/// 		$mode: daff-theme.daff-get-theme-mode($theme);
///
/// 		@include daff-theme.daff-dark-mode($mode) {
/// 			color: white;
///
/// 			.class {
/// 				background: blue;
/// 			}
/// 		}
/// 	}
///
@mixin daff-dark-mode($mode) {
	@if $mode == 'dark' {
		@content;
	}
}

/// @deprecated Use `daff-light-mode` instead.
///
/// @group Theming
///
/// @alias daff-light-mode
///
@mixin light($mode) {
	@include daff-light-mode($mode) {
		@content;
	}
}

/// @deprecated Use `daff-dark-mode` instead.
///
/// @group Theming
///
/// @alias daff-dark-mode
///
@mixin dark($mode) {
	@include daff-dark-mode($mode) {
		@content;
	}
}