////
///
/// Layout Mixins Module
/// ===========================================================================
///
/// @group Layout
/// @author Scape Agency
/// @link https://scape.style
/// @since 0.1.0 initial release
/// @todo None
/// @access public
///
////

// ============================================================================
// Layout | Positioning Utilities
// ============================================================================

@use "../../variables" as *;

///
/// Mixin: `position--fixed`
/// ---------------------------------------------------------------------------
/// Applies `position: fixed` with optional alignment.
/// Supports combinations of top/bottom and left/right.
///
/// @param {String | null} $y - Vertical anchor: `top`, `bottom`, or `null`
/// @param {String | null} $x - Horizontal anchor: `left`, `right`, `both`, or `null`
///
/// @example scss - Fixed to top-left
///   @include position--fixed(top, left);
///
@mixin position--fixed($y: null, $x: null) {
    position: fixed;

    @if $y == top {
        top: 0;
    } @else if $y == bottom {
        bottom: 0;
    } @else if $y == both {
        top: 0;
        bottom: 0;
    }

    @if $x == left {
        left: 0;
    } @else if $x == right {
        right: 0;
    } @else if $x == both {
        left: 0;
        right: 0;
    }
}

///
/// Mixin: `position--inherit`
/// Applies `position: inherit` with `!important` to override layout flows.
///
@mixin position--inherit {
    position: inherit !important;
}

// ============================================================================
// Utility Classes
// ============================================================================

.position--fixed--top {
    @include position--fixed(top, both);
}
.position--fixed--bottom {
    @include position--fixed(bottom, both);
}
.position--fixed--top--left {
    @include position--fixed(top, left);
}
.position--fixed--top--right {
    @include position--fixed(top, right);
}
.position--fixed--bottom--left {
    @include position--fixed(bottom, left);
}
.position--fixed--bottom--right {
    @include position--fixed(bottom, right);
}

.position--inherit {
    @include position--inherit;
}