singularitygs 0.0.17 → 0.1.alpha

data/lib/singularitygs.rb

@@ -5,6 +5,6 @@ require 'breakpoint'
 Compass::Frameworks.register("singularitygs", :path => "#{File.dirname(__FILE__)}/..")
 
 module SingularityGS
-  VERSION = "0.0.17"
-  DATE = "2012-11-05"
+  VERSION = "0.1.alpha"
+  DATE = "2012-08-06"
 end

data/stylesheets/singularitygs.sass

@@ -0,0 +1,40 @@
+/*! SINGULARITY -- http://singularity.gs/ */
+@import compass
+@import modular-scale
+@import breakpoint
+
+// Can be a number or a list of non-uniform column widths
+$columns: 12 !default
+
+// Must be % or 0
+$gutter: 2% !default
+
+// Grid padding can be any type of unit
+$padding: 0 !default
+
+// Helpers return think like list sums and column counts
+@import singularitygs/helpers
+
+// Compound grid calculation function
+@import singularitygs/grid-plugins
+
+// Column math is isolated
+@import singularitygs/column
+
+// Gutter math is isolated
+@import singularitygs/gutter
+
+// Grid math combines column and gutter math
+@import singularitygs/grid
+
+// Mixins to write 
+@import singularitygs/mixins
+
+// Mixins to write 
+@import singularitygs/grid-test
+
+// Mixins to write 
+@import singularitygs/background-grid
+
+// Gridsets
+@import singularitygs/gridsets

data/stylesheets/singularitygs/_background-grid.sass

@@ -0,0 +1,19 @@
+// Write stops for single columns
+@function grid-gradient-stop($location, $columns, $gutter, $color)
+  @if $location == 1
+    @return ($color 0%, $color grid-span(1, 1, $columns, $gutter), transparentize($color, 1) grid-span(1, 1, $columns, $gutter))
+  @if $location == column-count($columns)
+    @return (transparentize($color, 1) grid-span($location - 1, 1, $columns, $gutter) + $gutter, $color grid-span($location - 1, 1, $columns, $gutter) + $gutter, $color 100%)
+  @if $location > 1
+    @return (transparentize($color, 1) grid-span($location - 1, 1, $columns, $gutter) + $gutter, $color grid-span($location - 1, 1, $columns, $gutter) + $gutter, $color grid-span($location, 1, $columns, $gutter), transparentize($color, 1) grid-span($location, 1, $columns, $gutter))
+
+// Compiling grid stops
+@function grid-gradient-stops($columns, $gutter, $color)
+  $list: ()
+  @for $i from 1 through column-count($columns)
+    $list: join($list, grid-gradient-stop($i, $columns, $gutter, $color), comma)
+  @return $list
+
+// Pull in grid stops to make a background gradient
+=background-grid($columns, $gutter, $color: rgba(#69AEDB, .5))
+  +background(linear-gradient(left, grid-gradient-stops($columns, $gutter, $color)))

data/stylesheets/singularitygs/_column.sass

@@ -0,0 +1,25 @@
+// calculate the width of individual columns
+@function list-column-width($location, $columns)
+  // send a warning if this is used when $columns is not a list
+  @if type-of($columns) != list
+    @warn "The column-list-sum function requires the variable $columns to be a list."
+  @else
+    // divide the column from its context
+    @return nth(nth($columns, $location), 1) / list-sum($columns)
+
+
+// Calculate the width spanning multiple columns
+@function column-span($span, $location: 1, $columns: $columns)
+  
+  // Equal width columns
+  @if type-of($columns) == number
+    @return $span * (100% / $columns)
+  
+  // Variable width columns
+  @if type-of($columns) == list
+    // zero out initial sum
+    $sum: 0
+    // from start point to end point
+    @for $i from $location to ($location + $span)
+      $sum: $sum + list-column-width($i, $columns)
+    @return percentage($sum)

data/stylesheets/singularitygs/_grid-plugins.sass

@@ -0,0 +1,2 @@
+@import grid-plugins/compound
+@import grid-plugins/ratio

data/stylesheets/singularitygs/{_grid-test.scss → _grid-test.sass}

@@ -1,25 +1,16 @@
-@mixin test-grid($columns: $columns, $gutter: $gutter, $padding: $padding, $prefix: a, $color: #66bbbb) {
-  .test-grid {
-    height: 200px;
-    width: 100%;
-  }
-  $grid-counter: 1;
-  @for $i from 1 through column-count($columns) {
-    .test.#{$prefix}#{$i} {
-      height: 100%;
-      @include grid-span(1, $i, $columns, $gutter, $padding);
-      // ie fallback
-      background-color: $color;
-      background-color: transparentize($color, 0.5);
-      .inner {
-        height: 100%;
-        // ie fallback
-        background-color: lighten($color, 10%);
-        background-color: transparentize($color, 0.5);
-      }
-    }
-  }
-}
+=test-grid($columns: $columns, $gutter: $gutter, $padding: $padding, $prefix: a, $color: #6bb)
+  .test-grid
+    height: 200px
+    width: 100%
+  $grid-counter: 1
+  @for $i from 1 through column-count($columns)
+    .test.#{$prefix}#{$i}
+      height: 100%
+      +grid-span(1, $i, $columns: $columns, $gutter: $gutter, $padding: $padding)
+      background-color: transparentize($color, .5)
+      .inner
+        height: 100%
+        background-color: transparentize($color, .5)
 
 // Need this markup to test
 //<div class="test-grid">

data/stylesheets/singularitygs/_grid.sass

@@ -0,0 +1,2 @@
+@function grid-span($span, $location: 1, $columns: $columns, $gutter: $gutter)
+  @return column-span($span, $location, $columns) - gutter-offset($gutter, $columns)

data/stylesheets/singularitygs/_gridsets.scss

@@ -0,0 +1,242 @@
+$gridset: () !default;
+$gutterset: () !default;
+$paddingset: () !default;
+
+$gridset-mobile-first: true;
+
+@mixin gridset-span($span, $location, $gutters: false, $paddings: false) {
+  $length: length($gridset);
+  
+  $query-min: breakpoint-get-context('min-width');
+  $query-max: breakpoint-get-context('max-width');
+  
+  @if $query-min {
+    $query-min: breakpoint-to-base-em($query-min);
+  }
+  @if $query-max {
+    $query-max: breakpoint-to-base-em($query-max);
+  }
+  
+  $written: false;
+  
+  $gutter-length: length($gutterset);
+  $padding-length: length($paddingset);
+  
+  $ghr: () !default;
+  $ghs: () !default;
+  $phs: () !default;
+  
+  @if $query-min or $query-max {
+    @for $j from 2 through $length {
+      $ghr: append($ghr, nth($gridset, $j), comma);
+    }
+    
+    @for $j from 2 through $length {
+      @if $j > $gutter-length {
+        $ghs: append($ghs, nth($gutterset, $gutter-length));
+      }
+      @else {
+        $ghs: append($ghs, nth($gutterset, $j));
+      }
+    }
+
+    @for $j from 2 through $length {
+      @if $j > $padding-length {
+        $phs: append($phs, nth($paddingset, $padding-length));
+      }
+      @else {
+        $phs: append($phs, nth($paddingset, $j));
+      }
+    }
+    
+    $ghr: reverse($ghr);
+    
+    $gthr: reverse($ghs);
+    $phr: reverse($phs);
+    
+    $holder-length: length($ghr);
+    
+    @for $i from 1 through $holder-length {
+      $gridholder: nth($ghr, $i);
+      
+      $grid-columns: nth($gridholder, 1);
+      $grid-query: nth($gridholder, 2);
+      
+      $grid-query: breakpoint-to-base-em($grid-query);
+      
+      @if length($gridholder) < 2 {
+        @warn 'Grid #{$gridholder} needs a breakpoint value!';
+      }
+      @else if not $written {
+        @if $gridset-mobile-first {
+          @if $query-min and not $query-max {
+            @if $query-min and $query-max {
+              @if $query-min >= $grid-query and $query-max < $grid-query {
+                @if $gutters == false {
+                  @if $gutter-length > 0 {
+                    $gutters: nth($gthr, $i);
+                  }
+                  @else {
+                    $gutters: $gutter;
+                  }
+                }
+                @if $paddings == false {
+                  @if $padding-length > 0 {
+                    $paddings: nth($phr, $i);
+                  }
+                  @else {
+                    $paddings: $padding;
+                  }
+                }
+                @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+                $written: true;
+                $gutters: false;
+                $paddings: false;
+              }
+            }
+            @else if $query-min >= $grid-query {
+              @if $gutters == false {
+                @if $gutter-length > 0 {
+                  $gutters: nth($gthr, $i);
+                }
+                @else {
+                  $gutters: $gutter;
+                }
+              }
+              @if $paddings == false {
+                @if $padding-length > 0 {
+                  $paddings: nth($phr, $i);
+                }
+                @else {
+                  $paddings: $padding;
+                }
+              }
+              @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+              $written: true;
+              $gutters: false;
+              $paddings: false;
+            }
+          }
+          @else {
+            @if $query-max < $grid-query {
+              @if $gutters == false {
+                @if $gutter-length > 0 {
+                  $gutters: nth($gthr, $i);
+                }
+                @else {
+                  $gutters: $gutter;
+                }
+              }
+              @if $paddings == false {
+                @if $padding-length > 0 {
+                  $paddings: nth($phr, $i);
+                }
+                @else {
+                  $paddings: $padding;
+                }
+              }
+              @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+              $written: true;
+              $gutters: false;
+              $paddings: false;
+            }
+          }
+        }
+        @else {
+          @if $query-min and $query-max {
+            @if $gutters == false {
+              @if $gutter-length > 0 {
+                $gutters: nth($gthr, $i);
+              }
+              @else {
+                $gutters: $gutter;
+              }
+            }
+            @if $paddings == false {
+              @if $padding-length > 0 {
+                $paddings: nth($phr, $i);
+              }
+              @else {
+                $paddings: $padding;
+              }
+            }
+            @if $query-min > $grid-query and $query-max <= $grid-query {
+              @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+              $written: true;
+              $gutters: false;
+              $paddings: false;
+            }
+          }
+          @else if $query-min and not $query-max {
+            @if $query-min > $grid-query {
+              @if $gutters == false {
+                @if $gutter-length > 0 {
+                  $gutters: nth($gthr, $i);
+                }
+                @else {
+                  $gutters: $gutter;
+                }
+              }
+              @if $paddings == false {
+                @if $padding-length > 0 {
+                  $paddings: nth($phr, $i);
+                }
+                @else {
+                  $paddings: $padding;
+                }
+              }
+              @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+              $written: true;
+              $gutters: false;
+              $paddings: false;
+            }
+          }
+          @else {
+            @if $query-max <= $grid-query {
+              @if $gutters == false {
+                @if $gutter-length > 0 {
+                  $gutters: nth($gthr, $i);
+                }
+                @else {
+                  $gutters: $gutter;
+                }
+              }
+              @if $paddings == false {
+                @if $padding-length > 0 {
+                  $paddings: nth($phr, $i);
+                }
+                @else {
+                  $paddings: $padding;
+                }
+              }
+              @include grid-span($span, $location, $grid-columns, $gutters, $paddings);
+              $written: true;
+              $gutters: false;
+              $paddings: false;
+            }
+          }
+        }
+      }
+    }
+  }
+  @else {
+    @if $gutters == false {
+      @if $gutter-length > 0 {
+        $gutters: nth($gutterset, 1);
+      }
+      @else {
+        $gutters: $gutter;
+      }
+    }
+    
+    @if $paddings == false {
+      @if $padding-length > 0 {
+        $paddings: nth($paddingset, 1);
+      }
+      @else {
+        $paddings: $padding;
+      }
+    }
+    @include grid-span($span, $location, nth($gridset, 1), $gutters, $paddings);
+  }
+}

data/stylesheets/singularitygs/_gutter.sass

@@ -0,0 +1,4 @@
+// Gutters to be removed from columns
+@function gutter-offset($gutter, $columns)
+  $gutter-sum: $gutter * (column-count($columns) - 1)
+  @return $gutter-sum / column-count($columns)

data/stylesheets/singularitygs/_helpers.sass

@@ -0,0 +1,37 @@
+// Calculate the total sum of a list (context)
+@function list-sum($list)
+  // zero out the initial sum
+  $sum: 0
+  // loop through each value in the list adding it to $list-sum
+  @for $i from 1 through length($list)
+    $sum: $sum + nth(nth($list, $i), 1)
+  @return nth($sum, 1)
+
+
+// Find column count
+@function column-count($columns)
+  @if type-of($columns) == number
+    @return $columns
+  @if type-of($columns) == list
+    @return length($columns)
+
+
+// Context of gutters
+@function gutter-context($gutter, $context)
+  @return $gutter * (100% / $context)
+
+@function repeat($count, $repeat)
+  $list: $repeat
+  @for $i from 2 through $count
+    $list: join($repeat, $list)
+  @return $list
+
+// Reverses direction of a list
+@function reverse($list)
+  $length: length($list)
+  $return: ()
+  
+  @for $i from 0 to $length
+    $return: append($return, nth($list, $length - $i), comma)
+  
+  @return $return

data/stylesheets/singularitygs/_mixins.sass

@@ -0,0 +1,75 @@
+// Grid location is automatically counted unless overridden
+$grid-counter: 1
+
+=grid-span($span, $location: $grid-counter, $columns: $columns, $gutter: $gutter, $padding: $padding)
+  @if $location < column-count($columns)
+    float: left
+  @else
+    float: right
+  width: grid-span($span, $location, $columns, $gutter)
+  $box-sizing: false
+
+  // add special left padding
+  @if type-of($columns) == list
+    @if type-of(nth($columns, $location)) == list
+      padding-left: nth(nth($columns, $location), 2)
+      $box-sizing: true
+    @else if $padding != 0
+      padding-left: $padding
+      $box-sizing: true
+    // add special right padding
+    @if type-of(nth($columns, ($location + $span - 1))) == list
+      padding-right: nth(nth($columns, ($location + $span - 1)), 2)
+      $box-sizing: true
+    @else if $padding != 0
+      padding-right: $padding
+      $box-sizing: true
+
+  @else if $padding != 0
+    padding: 0 $padding
+    $box-sizing: true
+
+  @if $box-sizing
+    +box-sizing(border-box)
+
+  // bump up the counter
+  $grid-counter: $location + $span
+  @if $grid-counter > column-count($columns)
+    $grid-counter: 1
+    margin-right: 0
+  @else
+    margin-right: $gutter
+
+
+// This writes classes, IDs, or silent objects for you to extend or use in your HTML. They can be written to different breakpoints to extend or call into your HTML as needed.
+=grid-objects($prefix: a, $columns: $columns, $gutter: $gutter, $padding: $padding, $selector: "%")
+  // counter keeps track of the starting position
+  $count: 0
+  %#{$prefix}column
+    float: left
+    +grid-padding($padding)
+    margin-right: $gutter
+
+  @for $i from 1 through column-count($columns)
+    @for $n from $count + 1 through column-count($columns)
+      #{$selector}#{$prefix}#{$count}-#{$n}
+        @extend %#{$prefix}column
+        width: grid-span($n - $count, $count + 1, $columns, $gutter)
+        @if $n == column-count($columns)
+          margin-right: 0
+        // add special padding
+        @if type-of($columns) == list
+          @if type-of(nth($columns, $count + 1)) == list
+            padding-left: nth(nth($columns, $count + 1), 2)
+          // add special right padding
+          @if type-of(nth($columns, ($n))) == list
+            padding-right: nth(nth($columns, ($n)), 2)
+    $count: $count + 1
+
+
+
+// Add padding to an object on the grid.
+=grid-padding($padding)
+  @if $padding != 0
+    padding: 0 $padding
+    +box-sizing(border-box)