/** =====================================================================================
 *  Toolbox functions
 ===================================================================================== */


/**
 *  Maths helpers.
 *  Halve and double numbers, returning rounded integers.

    USAGE:

    .foo {
        padding: halve(30px);
    }

 */

@function quarter($number) {
	@return round($number / 4);
}

@function halve($number) {
	@return round($number / 2);
}

@function double($number) {
	@return round($number * 2);
}

@function triple($number) {
	@return round($number * 3);
}

@function quadruple($number) {
	@return round($number * 4);
}


/**
 *  Remove the unit of a length
 *  @param {Number} $number - Number to remove unit from
 *  @return {Number} - Unitless number
 */

@function strip-unit($number) {
	@if type-of($number) == 'number' and not unitless($number) {
		@return $number / ($number * 0 + 1);
	}

	@return $number;
}


/* Check if value is number */

@function is-number($value) {
	@return type-of($value) == 'number';
}


/* Value to Em */

@function valueToRem($value) {
	$noUnits: strip-unit($value);
	@return #{$noUnits / 16 * 1rem};
}

/* Value to Rem */

@function valueToEm($value) {
	$noUnits: strip-unit($value);
	@return #{$noUnits / 16 * 1em};
}


/**
 *	A simple function for accessing the colors from our mapping
 *	To access colors in our palette, we use a very simple custom Sass function

	USAGE:

	a {
		color: palette(primary);

		&:hover {
			color: palette(primary, 400);
		}
	}

 */

@function palette($palette, $level: base) {
	@if map-has-key($palettes, $palette) {
		@if map-has-key(map-get($palettes, $palette), $level) {
			@return map-get(map-get($palettes, $palette), $level);
		} @else {
			// If level doesn't exist in map, give the first value of the palette
			@return nth(nth(map-get($palettes, $palette), 1), 2);
		}
	}

	@warn "Unknown color: `#{$palette}` in $palette. ";
	@return hotpink;
}

// Set a fixed space based on the 8pt grid
// Just pass the function a number equal to the number of (8)points you need
@function space($size: '1') {
	@if($size == 0) {
		@return $size;
	} @else {
		@return 8px * $size;
	}
}

/*
 * Set vertical spacing only for mobile viewport

 USAGE:

 .example {
	 @include vspacing-s(
				'margin-top' 1
		);
  }

 */



@mixin vspacing-s($values...) {
	@include mq($max: m) {
		@each $i in $values {
			// By setting gutter size as a halve column width we can make 'squares' on mobile
			#{nth($i, 1)}: #{($site-gutter-width * 2) * nth($i, 2)};
		}
	}
}

/*
 * Set vertical spacing for viewport larger than mobile
 * In flexible units (vw) and on max viewport in a fixed amount (px)

 USAGE:

 .example {
	 @include vspacing-m-up(
				'padding-top' 0.33,
				'margin-bottom' 0.5
		);
  }

 */

@mixin vspacing-m-up($values...) {
	@include mq(m, l) {
		@each $i in $values {
			#{nth($i, 1)}: #{(1 / ($site-columns-m + 2) * 100) * nth($i, 2)}vw;
		}
	}
	@include mq(l, $bp-max) {
		@each $i in $values {
			#{nth($i, 1)}: #{(1 / ($site-columns-l + 2) * 100) * nth($i, 2)}vw;
		}
	}
	@include mq($bp-max) {
		@each $i in $values {
			#{nth($i, 1)}: #{($site-max-width / $site-columns-l) * nth($i, 2)}px;
		}
	}
}

/*
 * From values given return the correct v-spacing for each breakpoint
 */
@mixin vspacing($values...) {
	@include vspacing-s($values...);
	@include vspacing-m-up($values...);
}


/**
 *	A simple function for setting a consistent box-shadow

	USAGE:

	.card {
		@include box-shadow;
	}

	.card--alt {
		@include box-shadow(low);
	}

 */
@mixin box-shadow($type: high) {
	@if ($type == 'high') {
		box-shadow: 0 20px 30px -10px palette(box-shadow);
	}
	@if ($type == 'low') {
		box-shadow: 0 1px 6px 0 palette(box-shadow);
	}
}

/**
 *	A simple function for setting a consistent border-radius

	USAGE:

	.card {
		@include border-radius;
	}

	.card--alt {
		@include border-radius(l);
	}

 */
@mixin border-radius($type: s) {
	@if ($type == 's') {
		border-radius: map-get($border-radius, s);
	}
	@if ($type == 'm') {
		border-radius: map-get($border-radius, m);
	}
	@if ($type == 'l') {
		border-radius: map-get($border-radius, l);
	}
}

/**
 * Lobotomized Owl Selector mixin:
 * - Set spacing for consecutive items with margin-top on all but the first item

	USAGE:

	.box {
		@include owl-children;
	}

	.card__item {
		@include owl;
	}

 */

// Gives the children of the element spacing
@mixin owl-children($margin: #{$line-height-ratio}rem) {
	& > * + * {
		margin-top: $margin;
	}
}

// Gives the element itself spacing
@mixin owl($margin: #{$line-height-ratio}rem) {
	& + & {
		margin-top: $margin;
	}
}

/**
 *  Show hyphens for every browser supporting it
 *  and will break lines in every other browser
 */

@mixin hyphenate {
	overflow-wrap: break-word;
	word-wrap: break-word;
	-webkit-hyphens: auto;
	-ms-hyphens: auto;
	hyphens: auto;
}

/*
 *  Restrict an element to a max-width for creating gutters on the side
 */
@mixin contain() {
	width: calc(100% - #{double($site-gutter-width)}); // Making sure it doesn’t get to small with little content
	margin-left: auto;
	margin-right: auto;

	@include mq(m) {
		width: calc((100% / #{$site-columns-m + 2}) * #{$site-columns-m});
	}

	@include mq(l) {
		width: calc((100% / #{$site-columns-l + 2}) * #{$site-columns-l});
		max-width: #{$site-max-width}px;
	}
}

/*
 * A mixin to set elements to its own named grid-area
 * --------------------------------------------------
 * USAGE:
 *
 * @include template(body, form, extra);
 */


@mixin template($elements...) {
	@each $element in $elements {
		&__#{$element} {
			grid-area: $element;
			display: block; // In IE grid items can't be inline
		}
	}
}


@mixin visuallyhidden() {
	position: absolute;
	width: 1px;
	height: 1px;
	margin: -1px;
	border: 0;
	padding: 0;
	white-space: nowrap;
	clip-path: inset(100%);
	overflow: hidden;
}


/* Retain aspect ratio || https://css-tricks.com/aspect-ratio-boxes/
 *
 * This method can NOT be used on a flex item (so if parent is display flex)
 * https://stackoverflow.com/questions/36783190/why-doesnt-percentage-padding-margin-work-on-flex-items-in-firefox-and-edge/36783414#36783414
 *
 */
@mixin aspectRatioSizer($w:1,$h:1) {
	display: flex;
	justify-content: center;

	&::before {
		content: '';
		display: block;
		height: 0; width: 0;
		padding-top: #{$h}+'%';
	}
}


@mixin paperBackground() {
	background: palette(neutral, 200) url(/img/paper-bg.gif);
}


@mixin testborders(){
	* {
		outline: 1px solid rgba(0,0,255, 0.2);
		& > * {
			outline: 1px solid rgba(0,255,0, 0.2);
			& > * {
				outline: 1px solid rgba(255,0,0, 0.2);
				& > * {
					outline: 1px solid rgba(0,255,255, 0.2);
					& > * {
						outline: 1px solid rgba(255,0,255, 0.2);
						& > * {
							outline: 1px solid rgba(255,255,0, 0.2);
						}
					}
				}
			}
		}
	}
}