unit.gl 0.0.35 → 0.0.39

package/scss/variables/_paper.scss

@@ -1,29 +1,257 @@
-// Copyright 2024 Scape Agency BV
-
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-
-// http://www.apache.org/licenses/LICENSE-2.0
+// ============================================================================
+// Poster
+// ============================================================================
 
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+////
+/// 
+/// Paper Variables Module
+/// ===========================================================================
+/// 
+/// This module defines standard paper sizes, organized into various series and
+/// categories. These sizes are stored in the `$paper_sizes` map, making them
+/// easily accessible throughout the project for consistent layout and design.
+///
+/// @group Paper
+/// @author Scape Agency
+/// @link https://unit.gl
+/// @since 0.1.0 initial release
+/// @todo None
+/// @access public
+/// 
+/// @example
+///   .element {
+///     width: map-get($paper_sizes, 'a4')['width'];
+///     height: map-get($paper_sizes, 'a4')['height'];
+///   }
+/// 
+////
 
 
 // ============================================================================
-// Paper Module
+// Use
 // ============================================================================
 
 
-// Paper Size Map
 // ============================================================================
+// Variables
+// ============================================================================
+
 
+///
+/// Paper Size Map
+/// ============================================================================
+///
+/// A map of standard paper sizes, categorized by various series.
+/// 
+/// @name $paper_sizes
+/// @type Map
+/// 
+/// @prop {Map} q0 [width: 720.00mm, height: 1080.00mm] - Q0 paper size.
+/// @prop {Map} q1 [width: 540.00mm, height: 720.00mm] - Q1 paper size.
+/// @prop {Map} q2 [width: 360.00mm, height: 540.00mm] - Q2 paper size.
+/// @prop {Map} q3 [width: 270.00mm, height: 360.00mm] - Q3 paper size.
+/// @prop {Map} q4 [width: 180.00mm, height: 270.00mm] - Q4 paper size.
+/// @prop {Map} q5 [width: 135.00mm, height: 180.00mm] - Q5 paper size.
+/// @prop {Map} q6 [width: 90.00mm, height: 135.00mm] - Q6 paper size.
+/// @prop {Map} q7 [width: 62.50mm, height: 90.00mm] - Q7 paper size.
+/// @prop {Map} q8 [width: 45.00mm, height: 62.50mm] - Q8 paper size.
+/// @prop {Map} q9 [width: 31.25mm, height: 45.00mm] - Q9 paper size.
+/// @prop {Map} q10 [width: 22.50mm, height: 31.25mm] - Q10 paper size.
+/// @prop {Map} ansi_a [width: 8.50in, height: 11.00in] - ANSI A (Letter) paper size.
+/// @prop {Map} ansi_b [width: 11.00in, height: 17.00in] - ANSI B (Ledger) paper size.
+/// @prop {Map} ansi_c [width: 17.00in, height: 22.00in] - ANSI C paper size.
+/// @prop {Map} ansi_d [width: 22.00in, height: 34.00in] - ANSI D paper size.
+/// @prop {Map} ansi_e [width: 34.00in, height: 44.00in] - ANSI E paper size.
+/// @prop {Map} arch_a [width: 9.00in, height: 12.00in] - Arch A paper size.
+/// @prop {Map} arch_b [width: 12.00in, height: 18.00in] - Arch B paper size.
+/// @prop {Map} arch_c [width: 18.00in, height: 24.00in] - Arch C paper size.
+/// @prop {Map} arch_d [width: 24.00in, height: 36.00in] - Arch D paper size.
+/// @prop {Map} arch_e [width: 36.00in, height: 48.00in] - Arch E paper size.
+/// @prop {Map} din_a0 [width: 841.00mm, height: 1189.00mm] - DIN A0 paper size.
+/// @prop {Map} din_a1 [width: 594.00mm, height: 841.00mm] - DIN A1 paper size.
+/// @prop {Map} din_a2 [width: 420.00mm, height: 594.00mm] - DIN A2 paper size.
+/// @prop {Map} din_a3 [width: 297.00mm, height: 420.00mm] - DIN A3 paper size.
+/// @prop {Map} din_a4 [width: 210.00mm, height: 297.00mm] - DIN A4 paper size.
+/// @prop {Map} din_a5 [width: 148.00mm, height: 210.00mm] - DIN A5 paper size.
+/// @prop {Map} din_a6 [width: 105.00mm, height: 148.00mm] - DIN A6 paper size.
+/// @prop {Map} din_a7 [width: 74.00mm, height: 105.00mm] - DIN A7 paper size.
+/// @prop {Map} din_a8 [width: 52.00mm, height: 74.00mm] - DIN A8 paper size.
+/// @prop {Map} din_a9 [width: 37.00mm, height: 52.00mm] - DIN A9 paper size.
+/// @prop {Map} din_a10 [width: 26.00mm, height: 37.00mm] - DIN A10 paper size.
+/// @prop {Map} iso_a0 [width: 841.00mm, height: 1189.00mm] - ISO A0 paper size.
+/// @prop {Map} iso_a1 [width: 594.00mm, height: 841.00mm] - ISO A1 paper size.
+/// @prop {Map} iso_a2 [width: 420.00mm, height: 594.00mm] - ISO A2 paper size.
+/// @prop {Map} iso_a3 [width: 297.00mm, height: 420.00mm] - ISO A3 paper size.
+/// @prop {Map} iso_a4 [width: 210.00mm, height: 297.00mm] - ISO A4 paper size.
+/// @prop {Map} iso_a5 [width: 148.00mm, height: 210.00mm] - ISO A5 paper size.
+/// @prop {Map} iso_a6 [width: 105.00mm, height: 148.00mm] - ISO A6 paper size.
+/// @prop {Map} iso_a7 [width: 74.00mm, height: 105.00mm] - ISO A7 paper size.
+/// @prop {Map} iso_a8 [width: 52.00mm, height: 74.00mm] - ISO A8 paper size.
+/// @prop {Map} iso_a9 [width: 37.00mm, height: 52.00mm] - ISO A9 paper size.
+/// @prop {Map} iso_a10 [width: 26.00mm, height: 37.00mm] - ISO A10 paper size.
+/// @prop {Map} iso_b0 [width: 1000.00mm, height: 1414.00mm] - ISO B0 paper size.
+/// @prop {Map} iso_b1 [width: 707.00mm, height: 1000.00mm] - ISO B1 paper size.
+/// @prop {Map} iso_b2 [width: 500.00mm, height: 707.00mm] - ISO B2 paper size.
+/// @prop {Map} iso_b3 [width: 353.00mm, height: 500.00mm] - ISO B3 paper size.
+/// @prop {Map} iso_b4 [width: 250.00mm, height: 353.00mm] - ISO B4 paper size.
+/// @prop {Map} iso_b5 [width: 176.00mm, height: 250.00mm] - ISO B5 paper size.
+/// @prop {Map} iso_b6 [width: 125.00mm, height: 176.00mm] - ISO B6 paper size.
+/// @prop {Map} iso_b7 [width: 88.00mm, height: 125.00mm] - ISO B7 paper size.
+/// @prop {Map} iso_b8 [width: 62.00mm, height: 88.00mm] - ISO B8 paper size.
+/// @prop {Map} iso_b9 [width: 44.00mm, height: 62.00mm] - ISO B9 paper size.
+/// @prop {Map} iso_b10 [width: 31.00mm, height: 44.00mm] - ISO B10 paper size.
+/// @prop {Map} iso_c0 [width: 917.00mm, height: 1297.00mm] - ISO C0 paper size.
+/// @prop {Map} iso_c1 [width:648.00mm, height: 917.00mm] - ISO C1 paper size.
+/// @prop {Map} iso_c2 [width: 458.00mm, height: 648.00mm] - ISO C2 paper size.
+/// @prop {Map} iso_c3 [width: 324.00mm, height: 458.00mm] - ISO C3 paper size.
+/// @prop {Map} iso_c4 [width: 229.00mm, height: 324.00mm] - ISO C4 paper size.
+/// @prop {Map} iso_c5 [width: 162.00mm, height: 229.00mm] - ISO C5 paper size.
+/// @prop {Map} iso_c6 [width: 114.00mm, height: 162.00mm] - ISO C6 paper size.
+/// @prop {Map} iso_c7 [width: 81.00mm, height: 114.00mm] - ISO C7 paper size.
+/// @prop {Map} iso_c8 [width: 57.00mm, height: 81.00mm] - ISO C8 paper size.
+/// @prop {Map} iso_c9 [width: 40.00mm, height: 57.00mm] - ISO C9 paper size.
+/// @prop {Map} iso_c10 [width: 28.00mm, height: 40.00mm] - ISO C10 paper size.
+/// @prop {Map} iso_ra0 [width: 860.00mm, height: 1220.00mm] - ISO RA0 paper size.
+/// @prop {Map} iso_ra1 [width: 610.00mm, height: 860.00mm] - ISO RA1 paper size.
+/// @prop {Map} iso_ra2 [width: 430.00mm, height: 610.00mm] - ISO RA2 paper size.
+/// @prop {Map} iso_ra3 [width: 305.00mm, height: 430.00mm] - ISO RA3 paper size.
+/// @prop {Map} iso_ra4 [width: 215.00mm, height: 305.00mm] - ISO RA4 paper size.
+/// @prop {Map} iso_sra0 [width: 900.00mm, height: 1280.00mm] - ISO SRA0 paper size.
+/// @prop {Map} iso_sra1 [width: 640.00mm, height: 900.00mm] - ISO SRA1 paper size.
+/// @prop {Map} iso_sra2 [width: 450.00mm, height: 640.00mm] - ISO SRA2 paper size.
+/// @prop {Map} iso_sra3 [width: 320.00mm, height: 450.00mm] - ISO SRA3 paper size.
+/// @prop {Map} iso_sra4 [width: 225.00mm, height: 320.00mm] - ISO SRA4 paper size.
+/// @prop {Map} jis_a0 [width: 841.00mm, height: 1189.00mm] - JIS A0 paper size.
+/// @prop {Map} jis_a1 [width: 594.00mm, height: 841.00mm] - JIS A1 paper size.
+/// @prop {Map} jis_a2 [width: 420.00mm, height: 594.00mm] - JIS A2 paper size.
+/// @prop {Map} jis_a3 [width: 297.00mm, height: 420.00mm] - JIS A3 paper size.
+/// @prop {Map} jis_a4 [width: 210.00mm, height: 297.00mm] - JIS A4 paper size.
+/// @prop {Map} jis_a5 [width: 148.00mm, height: 210.00mm] - JIS A5 paper size.
+/// @prop {Map} jis_a6 [width: 105.00mm, height: 148.00mm] - JIS A6 paper size.
+/// @prop {Map} jis_a7 [width: 74.00mm, height: 105.00mm] - JIS A7 paper size.
+/// @prop {Map} jis_a8 [width: 52.00mm, height: 74.00mm] - JIS A8 paper size.
+/// @prop {Map} jis_a9 [width: 37.00mm, height: 52.00mm] - JIS A9 paper size.
+/// @prop {Map} jis_a10 [width: 26.00mm, height: 37.00mm] - JIS A10 paper size.
+/// @prop {Map} jis_b0 [width: 1030.00mm, height: 1456.00mm] - JIS B0 paper size.
+/// @prop {Map} jis_b1 [width: 728.00mm, height: 1030.00mm] - JIS B1 paper size.
+/// @prop {Map} jis_b2 [width: 515.00mm, height: 728.00mm] - JIS B2 paper size.
+/// @prop {Map} jis_b3 [width: 364.00mm, height: 515.00mm] - JIS B3 paper size.
+/// @prop {Map} jis_b4 [width: 257.00mm, height: 364.00mm] - JIS B4 paper size.
+/// @prop {Map} jis_b5 [width: 182.00mm, height: 257.00mm] - JIS B5 paper size.
+/// @prop {Map} jis_b6 [width: 128.00mm, height: 182.00mm] - JIS B6 paper size.
+/// @prop {Map} jis_b7 [width: 91.00mm, height: 128.00mm] - JIS B7 paper size.
+/// @prop {Map} jis_b8 [width: 64.00mm, height: 91.00mm] - JIS B8 paper size.
+/// @prop {Map} jis_b9 [width: 45.00mm, height: 64.00mm] - JIS B9 paper size.
+/// @prop {Map} jis_b10 [width: 32.00mm, height: 45.00mm] - JIS B10 paper size.
+/// @prop {Map} jis_c0 [width: 917.00mm, height: 1297.00mm] - JIS C0 paper size.
+/// @prop {Map} jis_c1 [width: 648.00mm, height: 917.00mm] - JIS C1 paper size.
+/// @prop {Map} jis_c2 [width: 458.00mm, height: 648.00mm] - JIS C2 paper size.
+/// @prop {Map} jis_c3 [width: 324.00mm, height: 458.00mm] - JIS C3 paper size.
+/// @prop {Map} jis_c4 [width: 229.00mm, height: 324.00mm] - JIS C4 paper size.
+/// @prop {Map} jis_c5 [width: 162.00mm, height: 229.00mm] - JIS C5 paper size.
+/// @prop {Map} jis_c6 [width: 114.00mm, height: 162.00mm] - JIS C6 paper size.
+/// @prop {Map} jis_c7 [width: 81.00mm, height: 114.00mm] - JIS C7 paper size.
+/// @prop {Map} jis_c8 [width: 57.00mm, height: 81.00mm] - JIS C8 paper size.
+/// @prop {Map} jis_c9 [width: 40.00mm, height: 57.00mm] - JIS C9 paper size.
+/// @prop {Map} jis_c10 [width: 28.00mm, height: 40.00mm] - JIS C10 paper size.
+/// @prop {Map} pa0 [width: 840.00mm, height: 1120.00mm] - PA0 paper size.
+/// @prop {Map} pa1 [width: 560.00mm, height: 840.00mm] - PA1 paper size.
+/// @prop {Map} pa2 [width: 420.00mm, height: 560.00mm] - PA2 paper size.
+/// @prop {Map} pa3 [width: 280.00mm, height: 420.00mm] - PA3 paper size.
+/// @prop {Map} pa4 [width: 210.00mm, height: 280.00mm] - PA4 paper size.
+/// @prop {Map} pa5 [width: 140.00mm, height: 210.00mm] - PA5 paper size.
+/// @prop {Map} pa6 [width: 105.00mm, height: 140.00mm] - PA6 paper size.
+/// @prop {Map} pa7 [width: 70.00mm, height: 105.00mm] - PA7 paper size.
+/// @prop {Map} pa8 [width: 52.00mm, height: 70.00mm] - PA8 paper size.
+/// @prop {Map} pa9 [width: 35.00mm, height: 52.00mm] - PA9 paper size.
+/// @prop {Map} pa10 [width: 26.00mm, height: 35.00mm] - PA10 paper size.
+/// @prop {Map} photo_3x3 [width: 3.00in, height: 3.00in] - 3”x3” photographic paper size.
+/// @prop {Map} photo_4x5 [width: 4.00in, height: 5.00in] - 4”x5” photographic paper size.
+/// @prop {Map} photo_5x7 [width: 5.00in, height: 7.00in] - 5”x7” photographic paper size.
+/// @prop {Map} photo_8x10 [width: 8.00in, height: 10.00in] - 8”x10” photographic paper size.
+/// @prop {Map} photo_10x12 [width: 10.00in, height: 12.00in] - 10”x12” photographic paper size.
+/// @prop {Map} photo_16x20 [width: 16.00in, height: 20.00in] - 16”x20” photographic paper size.
+/// @prop {Map} photo_2r [width: 2.50in, height: 3.50in] - 2R (Wallet) photographic paper size.
+/// @prop {Map} photo_3r [width: 3.50in, height: 5.00in] - 3R photographic paper size.
+/// @prop {Map} photo_4r [width: 4.00in, height: 6.00in] - 4R photographic paper size.
+/// @prop {Map} photo_5r [width: 5.00in, height: 7.00in] - 5R photographic paper size.
+/// @prop {Map} photo_6r [width: 6.00in, height: 8.00in] - 6R photographic paper size.
+/// @prop {Map} photo_8r [width: 8.00in, height: 10.00in] - 8R photographic paper size.
+/// @prop {Map} photo_8r_plus [width: 8.00in, height: 12.00in] - 8R+ photographic paper size.
+/// @prop {Map} photo_10r [width: 10.00in, height: 12.00in] - 10R photographic paper size.
+/// @prop {Map} photo_10r_plus [width: 10.00in, height: 15.00in] - 10R+ photographic paper size.
+/// @prop {Map} photo_11r [width: 11.00in, height: 14.00in] - 11R photographic paper size.
+/// @prop {Map} photo_11r_plus [width: 11.00in, height: 17.00in] - 11R+ photographic paper size.
+/// @prop {Map} photo_12r [width: 12.00in, height: 15.00in] - 12R photographic paper size.
+/// @prop {Map} photo_12r_plus [width: 12.00in, height: 18.00in] - 12R+ photographic paper size.
+/// @prop {Map} photo_14r [width: 14.00in, height: 17.00in] - 14R photographic paper size.
+/// @prop {Map} photo_16r [width: 16.00in, height: 20.00in] - 16R photographic paper size.
+/// @prop {Map} photo_16r_plus [width: 16.00in, height: 24.00in] - 16R+ photographic paper size.
+/// @prop {Map} photo_20r [width: 20.00in, height: 24.00in] - 20R photographic paper size.
+/// @prop {Map} photo_20r_plus [width: 20.00in, height: 28.00in] - 20R+ photographic paper size.
+/// @prop {Map} photo_22r [width: 20.00in, height: 29.50in] - 22R photographic paper size.
+/// @prop {Map} photo_24r [width: 24.00in, height: 31.50in] - 24R photographic paper size.
+/// @prop {Map} photo_24r_plus [width: 24.00in, height: 35.50in] - 24R+ photographic paper size.
+/// @prop {Map} photo_30r [width: 30.00in, height: 40.00in] - 30R photographic paper size.
+/// @prop {Map} us_letter [width: 8.50in, height: 11.00in] - US Letter paper size.
+/// @prop {Map} us_legal [width: 8.50in, height: 14.00in] - US Legal paper size.
+/// @prop {Map} us_ledger [width: 11.00in, height: 17.00in] - US Ledger/Tabloid paper size.
+/// @prop {Map} us_junior [width: 5.00in, height: 8.00in] - US Junior Legal paper size.
+/// @prop {Map} us_half_letter [width: 5.50in, height: 8.50in] - US Half Letter paper size.
+/// @prop {Map} us_government_letter [width: 8.00in, height: 10.50in] - US Government Letter paper size.
+/// @prop {Map} us_executive [width: 7.25in, height: 10.50in] - US Executive paper size.
+/// @prop {Map} us_statement [width: 5.50in, height: 8.50in] - US Statement paper size.
+/// @prop {Map} us_folio [width: 8.50in, height: 13.00in] - US Folio paper size.
+/// @prop {Map} us_quarto [width: 8.00in, height: 10.00in] - US Quarto paper size.
+/// @prop {Map} us_tabloid_extra [width: 12.00in, height: 18.00in] - US Tabloid Extra paper size.
+/// @prop {Map} poster_small [width: 11.00in, height: 17.00in] - Small Poster size.
+/// @prop {Map} poster_medium [width: 18.00in, height: 24.00in] - Medium Poster size.
+/// @prop {Map} poster_large [width: 24.00in, height: 36.00in] - Large Poster size.
+/// @prop {Map} poster_movie [width: 27.00in, height: 40.00in] - Movie Poster size.
+/// @prop {Map} poster_xlarge [width: 36.00in, height: 48.00in] - Extra Large Poster size.
+/// @prop {Map} canvas_8x10 [width: 8.00in, height: 10.00in] - 8”x10” art canvas size.
+/// @prop {Map} canvas_10x14 [width: 10.00in, height: 14.00in] - 10”x14” art canvas size.
+/// @prop {Map} canvas_10x24 [width: 10.00in, height: 24.00in] - 10”x24” art canvas size.
+/// @prop {Map} canvas_12x12 [width: 12.00in, height: 12.00in] - 12”x12” art canvas size.
+/// @prop {Map} canvas_12x36 [width: 12.00in, height: 36.00in] - 12”x36” art canvas size.
+/// @prop {Map} canvas_16x16 [width: 16.00in, height: 16.00in] - 16”x16” art canvas size.
+/// @prop {Map} canvas_16x20 [width: 16.00in, height: 20.00in] - 16”x20” art canvas size.
+/// @prop {Map} canvas_18x24 [width: 18.00in, height: 24.00in] - 18”x24” art canvas size.
+/// @prop {Map} canvas_20x30 [width: 20.00in, height: 30.00in] - 20”x30” art canvas size.
+/// @prop {Map} canvas_20x60 [width: 20.00in, height: 60.00in] - 20”x60” art canvas size.
+/// @prop {Map} canvas_24x36 [width: 24.00in, height: 36.00in] - 24”x36” art canvas size.
+/// @prop {Map} canvas_30x40 [width: 30.00in, height: 40.00in] - 30”x40” art canvas size.
+/// @prop {Map} canvas_30x90 [width: 30.00in, height: 90.00in] - 30”x90” art canvas size.
+/// @prop {Map} canvas_36x48 [width: 36.00in, height: 48.00in] - 36”x48” art canvas size.
+/// @prop {Map} canvas_40x40 [width: 40.00in, height: 40.00in] - 40”x40” art canvas size.
+/// @prop {Map} canvas_40x60 [width: 40.00in, height: 60.00in] - 40”x60” art canvas size.
+/// @prop {Map} canvas_48x72 [width: 48.00in, height: 72.00in] - 48”x72” art canvas size.
+/// @prop {Map} book_small [width: 5in, height: 8in] - Small book size.
+/// @prop {Map} book_medium [width: 6in, height: 9in] - Medium book size.
+/// @prop {Map} book_large [width: 7in, height: 10in] - Large book size.
+/// @prop {Map} book_collectors [width: 9in, height: 12in] - Collector’s edition book size.
+/// @prop {Map} book_coffee_table [width: 12in, height: 15in] - Coffee table book size.
+/// @prop {Map} business_card_us [width: 3.5in, height: 2in] - US standard business card size.
+/// @prop {Map} business_card_eu [width: 85mm, height: 55mm] - EU standard business card size.
+/// @prop {Map} business_card_iso [width: 90mm, height: 55mm] - ISO standard business card size.
+/// @prop {Map} index_card_3x5 [width: 3in, height: 5in] - 3”x5” index card size.
+/// @prop {Map} index_card_4x6 [width: 4in, height: 6in] - 4”x6” index card size.
+/// @prop {Map} index_card_5x8 [width: 5in, height: 8in] - 5”x8” index card size.
+/// @prop {Map} brochure_8x10 [width: 8in, height: 10in] - 8”x10” brochure size.
+/// @prop {Map} brochure_11x17 [width: 11in, height: 17in] - 11”x17” brochure size.
+/// @prop {Map} flyer_small [width: 4.25in, height: 5.5in] - Small flyer size.
+/// @prop {Map} flyer_medium [width: 5.5in, height: 8.5in] - Medium flyer size.
+/// @prop {Map} flyer_large [width: 8.5in, height: 11in] - Large flyer size.
+/// @prop {Map} journal_standard [width: 6in, height: 9in] - Standard academic journal size.
+/// @prop {Map} journal_large [width: 7in, height: 10in] - Large academic journal size.
+/// @prop {Map} thesis_standard [width: 8.5in, height: 11in] - Standard thesis paper size.
+/// @prop {Map} thesis_large [width: 11in, height: 17in] - Large thesis paper size.
+/// @prop {Map} comic_book [width: 6.625in, height: 10.25in] - Standard comic book size.
+/// @prop {Map} music_sheet [width: 9in, height: 12in] - Standard music sheet size.
+/// @prop {Map} playing_card [width: 2.5in, height: 3.5in] - Standard playing card size.
 $paper_sizes: (
 
-    // Q Series
+    // Q Series (Custom)
     // ------------------------------------------------------------------------
     "q0":                   (width:  720.00mm, height: 1080.00mm),  // Q0
     "q1":                   (width:  540.00mm, height:  720.00mm),  // Q1
@@ -304,5 +532,3 @@ $paper_sizes: (
     'playing_card': (width: 2.5in, height: 3.5in),         // Standard Playing Card
 
 ) !default;
-
-

package/scss/variables/_ratio.scss

@@ -0,0 +1,224 @@
+// ============================================================================
+// Poster
+// ============================================================================
+
+////
+/// 
+/// Ratio Variables Module
+/// ===========================================================================
+/// 
+/// @group Ratio
+/// @author Scape Agency
+/// @link https://unit.gl
+/// @since 0.1.0 initial release
+/// @todo None
+/// @access public
+/// 
+////
+
+
+// ============================================================================
+// Use
+// ============================================================================
+
+
+// ============================================================================
+// Variables
+// ============================================================================
+
+
+/// 
+/// A map of common ratios used for modular scale calculations, organized by
+/// categories such as musical intervals, mathematical constants, and special
+/// ratios used in design and architecture.
+/// This map defines a variety of ratios used in modular scale calculations for 
+/// responsive typography, layout design, and other scaling needs. These ratios 
+/// are drawn from musical intervals, mathematical constants, and design
+/// principles.
+/// 
+/// @name $ratio_map
+/// @type Map
+/// 
+/// @prop {Number} minor_second [1.067] - Minor second interval.
+/// @prop {Number} minor_third [1.2] - Minor third interval.
+/// @prop {Number} minor_fourth [1.334] - Minor fourth interval (also known as diminished fifth).
+/// @prop {Number} minor_fifth [1.5] - Minor fifth interval.
+/// @prop {Number} minor_sixth [1.6] - Minor sixth interval.
+/// @prop {Number} minor_seventh [1.778] - Minor seventh interval.
+/// @prop {Number} minor_octave [2] - Minor octave interval.
+/// @prop {Number} major_second [1.125] - Major second interval.
+/// @prop {Number} major_third [1.25] - Major third interval.
+/// @prop {Number} major_fourth [1.333] - Major fourth interval (perfect fourth).
+/// @prop {Number} major_fifth [1.5] - Major fifth interval (perfect fifth).
+/// @prop {Number} major_sixth [1.667] - Major sixth interval.
+/// @prop {Number} major_seventh [1.875] - Major seventh interval.
+/// @prop {Number} major_octave [2] - Major octave interval (perfect octave).
+/// @prop {Number} perfect_unison [1] - Perfect unison, the same note.
+/// @prop {Number} perfect_second [1.125] - Perfect second interval.
+/// @prop {Number} perfect_third [1.25] - Perfect third interval.
+/// @prop {Number} perfect_fourth [1.333] - Perfect fourth interval.
+/// @prop {Number} perfect_fifth [1.5] - Perfect fifth interval.
+/// @prop {Number} perfect_sixth [1.667] - Perfect sixth interval.
+/// @prop {Number} perfect_seventh [1.875] - Perfect seventh interval.
+/// @prop {Number} perfect_octave [2] - Perfect octave, double the frequency.
+/// @prop {Number} perfect_ninth [2.25] - Perfect ninth interval.
+/// @prop {Number} perfect_tenth [2.5] - Perfect tenth interval.
+/// @prop {Number} perfect_eleventh [2.667] - Perfect eleventh interval.
+/// @prop {Number} perfect_twelfth [3] - Perfect twelfth interval.
+/// @prop {Number} perfect_thirteenth [3.333] - Perfect thirteenth interval.
+/// @prop {Number} perfect_fourteenth [3.667] - Perfect fourteenth interval.
+/// @prop {Number} perfect_fifteenth [4] - Perfect fifteenth interval, double octave.
+/// @prop {Number} double_octave [4] - Twice the frequency of the perfect octave.
+/// @prop {Number} triple_octave [8] - Three times the frequency of the perfect octave.
+/// @prop {Number} augmented_unison [1.059] - Slightly higher than perfect unison.
+/// @prop {Number} augmented_second [1.122] - Slightly higher than major second.
+/// @prop {Number} augmented_third [1.189] - Slightly higher than major third.
+/// @prop {Number} augmented_fourth [1.414] - Augmented fourth, also known as tritone.
+/// @prop {Number} augmented_fifth [1.587] - Slightly higher than perfect fifth.
+/// @prop {Number} augmented_sixth [1.682] - Slightly higher than major sixth.
+/// @prop {Number} augmented_seventh [1.782] - Slightly higher than major seventh.
+/// @prop {Number} augmented_octave [2.059] - Slightly higher than perfect octave.
+/// @prop {Number} diminished_unison [0.943] - Diminished unison, slightly less than perfect unison.
+/// @prop {Number} diminished_second [1.053] - Diminished second interval, slightly less than minor second.
+/// @prop {Number} diminished_third [1.122] - Diminished third interval, slightly less than minor third.
+/// @prop {Number} diminished_fourth [1.260] - Diminished fourth, slightly less than perfect fourth.
+/// @prop {Number} diminished_fifth [1.414] - Tritone, halfway between perfect fourth and fifth.
+/// @prop {Number} diminished_sixth [1.587] - Diminished sixth interval, slightly less than major sixth.
+/// @prop {Number} diminished_seventh [1.782] - Diminished seventh interval, slightly less than major seventh.
+/// @prop {Number} diminished_octave [1.961] - Diminished octave, slightly less than perfect octave.
+/// @prop {Number} root_two [1.414] - Square root of 2.
+/// @prop {Number} root_three [1.732] - Square root of 3.
+/// @prop {Number} root_four [2] - Square root of 4.
+/// @prop {Number} root_five [2.236] - Square root of 5.
+/// @prop {Number} golden_ratio [1.618] - The golden ratio.
+/// @prop {Number} silver_ratio [2.414] - Analogous to the golden ratio.
+/// @prop {Number} bronze_ratio [1.927] - Analogous to silver and golden ratios.
+/// @prop {Number} phi [1.618] - Another name for the golden ratio.
+/// @prop {Number} pi [3.142] - Mathematical Pi value.
+/// @prop {Number} euler [2.718] - Euler's number.
+/// @prop {Number} pythagorean [1.732] - Pythagorean constant, square root of 3.
+/// @prop {Number} square [1.414] - Square root of 2.
+/// @prop {Number} fibonacci [1.618] - Fibonacci sequence ratio.
+/// @prop {Number} plastic_number [1.324] - Plastic constant, another unique irrational number.
+/// @prop {Number} feigenbaum [4.669] - Feigenbaum constant in chaos theory.
+/// @prop {Number} apollonian [1.306] - Apollonian gasket, related to circle packing.
+/// @prop {Number} cosmic_ratio [1.273] - Based on cosmic geometry.
+/// @prop {Number} egyptian_fraction [1.571] - Ancient Egyptian architecture ratio.
+/// @prop {Number} harmonic_mean [1.455] - Harmonic mean, a type of average.
+/// @prop {Number} gauss_constant [0.834] - Gauss's constant related to the arithmetic-geometric mean.
+/// @prop {Number} super_golden [2.058] - Super golden ratio, a higher order of the golden ratio.
+/// @prop {Number} parthenon_ratio [1.618] - Ratio used in the architecture of the Parthenon.
+/// @prop {Number} le_corbusier [1.618] - Le Corbusier’s modulor ratio, used in modernist architecture.
+/// @prop {Number} vesica_piscis [1.732] - Ratio derived from the vesica piscis shape, often used in sacred geometry.
+$ratio_map: (
+
+    // Musical Intervals
+    // ========================================================================
+    // Commonly used in creating harmonious designs based on musical theory.
+
+    // Musical Minor Interval
+    // ------------------------------------------------------------------------
+    "minor_second":         1.067,  // Minor second interval
+    "minor_third":          1.2,    // Minor third interval
+    "minor_fourth":         1.334,  // Minor fourth interval (also known as diminished fifth)
+    "minor_fifth":          1.5,    // Minor fifth interval
+    "minor_sixth":          1.6,    // Minor sixth interval
+    "minor_seventh":        1.778,  // Minor seventh interval
+    "minor_octave":         2,      // Minor octave interval
+
+    // Musical Major Interval
+    // ------------------------------------------------------------------------
+    "major_second":         1.125,  // Major second interval
+    "major_third":          1.25,   // Major third interval
+    "major_fourth":         1.333,  // Major fourth interval (perfect fourth)
+    "major_fifth":          1.5,    // Major fifth interval (perfect fifth)
+    "major_sixth":          1.667,  // Major sixth interval
+    "major_seventh":        1.875,  // Major seventh interval
+    "major_octave":         2,      // Major octave interval (perfect octave)
+
+    // Musical Perfect Interval
+    // ------------------------------------------------------------------------
+    "perfect_unison":       1,      // Perfect unison, the same note
+    "perfect_second":       1.125,  // Perfect second interval
+    "perfect_third":        1.25,   // Perfect third interval
+    "perfect_fourth":       1.333,  // Perfect fourth interval
+    "perfect_fifth":        1.5,    // Perfect fifth interval
+    "perfect_sixth":        1.667,  // Perfect sixth interval
+    "perfect_seventh":      1.875,  // Perfect seventh interval
+    "perfect_octave":       2,      // Perfect octave, double the frequency
+    "perfect_ninth":        2.25,   // Perfect ninth interval
+    "perfect_tenth":        2.5,    // Perfect tenth interval
+    "perfect_eleventh":     2.667,  // Perfect eleventh interval
+    "perfect_twelfth":      3,      // Perfect twelfth interval
+    "perfect_thirteenth":   3.333,  // Perfect thirteenth interval
+    "perfect_fourteenth":   3.667,  // Perfect fourteenth interval
+    "perfect_fifteenth":    4,      // Perfect fifteenth interval, double octave
+    "double_octave":        4,      // Twice the frequency of the perfect octave
+    "triple_octave":        8,      // Three times the frequency of the perfect octave
+
+    // Musical Augmented Interval
+    // ------------------------------------------------------------------------
+    "augmented_unison":     1.059,  // Slightly higher than perfect unison
+    "augmented_second":     1.122,  // Slightly higher than major second
+    "augmented_third":      1.189,  // Slightly higher than major third
+    "augmented_fourth":     1.414,  // Augmented fourth, also known as tritone
+    "augmented_fifth":      1.587,  // Slightly higher than perfect fifth
+    "augmented_sixth":      1.682,  // Slightly higher than major sixth
+    "augmented_seventh":    1.782,  // Slightly higher than major seventh
+    "augmented_octave":     2.059,  // Slightly higher than perfect octave
+
+    // Musical Diminished Interval
+    // ------------------------------------------------------------------------
+    "diminished_unison":    0.943,  // A diminished unison, slightly less than a perfect unison
+    "diminished_second":    1.053,  // Diminished second interval, slightly less than a minor second
+    "diminished_third":     1.122,  // Diminished third interval, slightly less than a minor third
+    "diminished_fourth":    1.260,  // Diminished fourth, slightly less than a perfect fourth
+    "diminished_fifth":     1.414,  // Tritone, halfway between a perfect fourth and perfect fifth
+    "diminished_sixth":     1.587,  // Diminished sixth interval, slightly less than a major sixth
+    "diminished_seventh":   1.782,  // Diminished seventh interval, slightly less than a major seventh
+    "diminished_octave":    1.961,  // A diminished octave, slightly less than a perfect octave
+
+
+    // Mathematical Constants
+    // ========================================================================
+    // These ratios are derived from important mathematical constants.
+
+    // Root
+    // ------------------------------------------------------------------------
+    "root_two":             1.414,  // Square root of 2
+    "root_three":           1.732,  // Square root of 3
+    "root_four":            2,      // Square root of 4
+    "root_five":            2.236,  // Square root of 5
+    "golden_ratio":         1.618,
+    "silver_ratio":         2.414,  // Analogous to the golden ratio
+    "bronze_ratio":         1.927,  // Analogous to silver and golden ratios
+    "phi":                  1.618,  // Another name for the golden ratio
+    "pi":                   3.142,  // Mathematical Pi value
+    "euler":                2.718,  // Euler's number
+
+    // Special Ratios
+    // ========================================================================
+    // Unique ratios derived from specific design, architectural, or theoretical contexts.
+
+    // Special
+    // ------------------------------------------------------------------------
+    "pythagorean":          1.732,  // Pythagorean constant, square root of 3
+    "square":               1.414,  // Square root of 2
+    "fibonacci":            1.618,  // Fibonacci sequence ratio
+    "plastic_number":       1.324,  // Plastic constant, another unique irrational number
+    "feigenbaum":           4.669,  // Feigenbaum constant in chaos theory
+    "apollonian":           1.306,  // Apollonian gasket, related to circle packing
+    "cosmic_ratio":         1.273,  // Based on cosmic geometry
+    "egyptian_fraction":    1.571,  // Ancient Egyptian architecture ratio
+    "harmonic_mean":        1.455,  // Harmonic mean, a type of average
+    "gauss_constant":       0.834,  // Gauss's constant related to the arithmetic-geometric mean
+    "super_golden":         2.058,  // Super golden ratio, a higher order of the golden ratio
+
+    // Design & Architecture Ratios
+    // ------------------------------------------------------------------------
+
+    "parthenon_ratio":      1.618,
+    "le_corbusier":         1.618,
+    "vesica_piscis":        1.732
+
+) !default;