////
///
/// Deafult Paragraph Typography Mixins Module
/// ===========================================================================
/// Provides reusable mixins for text alignment and centering.
///
/// @group TextAlignment
/// @author Scape Press
/// @link https://scape.style
/// @since 0.1.0 initial release
/// @todo None
/// @access public
///
////

// ============================================================================
// Use
// ============================================================================

///
/// Mixin for applying a standard first-line text indent.
/// @param {Length} $amount [1.5em] - The amount of indentation.
///
@use "../../../01-core/external" as *;

@mixin text_indent($amount: baseline(4)) {
    text-indent: $amount !important;
    // text-justify: inter-word; // Optional for better justification
}

///
/// Mixin for removing text indentation.
///
@mixin text_indent--none {
    text-indent: 0 !important;
}

///
/// Mixin for extra small text indentation.
///
@mixin text_indent--xs {
    @include text_indent(baseline(2));
}

///
/// Mixin for small text indentation.
///
@mixin text_indent--sm {
    @include text_indent(baseline(3));
}

///
/// Mixin for medium text indentation.
///
@mixin text_indent--md {
    @include text_indent();
}

///
/// Mixin for large text indentation.
///
@mixin text_indent--lg {
    @include text_indent(baseline(6));
}

///
/// Mixin for extra large text indentation.
///
@mixin text_indent--xl {
    @include text_indent(baseline(8));
}