kentucky 1.5.1 → 2.0.0

data/app/assets/stylesheets/kentucky/base/_project-settings.scss

@@ -0,0 +1,112 @@
+// ------------------------------------------------------------------- //
+//  Project Settings
+//  
+//  This file houses variables related to brand and overall stylistic
+//  elements (fonts, sizes, colors, etc.) that should be used across
+//  the site.
+//  
+//  This is a basic set for initial functionality but any project-
+//  related variables that need to be global should exist in this file.
+//  
+//  Local variables should still exist in the file in which they are
+//  required.
+// ------------------------------------------------------------------- //
+
+
+// ------------------------------------------------------------------- //
+//  Typography
+
+$base-font-family:   "Helvetica Neue", Helvetica, Arial, sans-serif;
+$header-font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+
+
+
+// ------------------------------------------------------------------- //
+//  Font Sizes
+
+$base-font-size: 16px;
+
+$h1-font-size: 42px;
+$h2-font-size: 36px;
+$h3-font-size: 24px;
+$h4-font-size: 20px;
+$h5-font-size: 18px;
+$h6-font-size: 16px;
+
+
+
+// ------------------------------------------------------------------- //
+//  Line Height
+
+$base-line-height:   1.5;
+$header-line-height: 1.2;
+
+
+
+// ------------------------------------------------------------------- //
+//  Other Sizes
+
+$base-border-radius: 3px;
+
+$base-spacing: 20px;
+
+
+
+// ------------------------------------------------------------------- //
+//  Colors
+
+//  Background Color
+$base-background-color: white;
+
+//  Font Colors
+$base-font-color:   #333;
+$base-accent-color: #b4d455;
+
+//  Link Colors
+$base-link-color:  $base-accent-color;
+$hover-link-color: shade($base-link-color, 15%);
+
+//  Button Colors
+$base-button-color:  $base-link-color;
+$hover-button-color: $hover-link-color;
+
+//  Border Colors
+$base-border-color: #ddd;
+$base-border: 1px solid $base-border-color;
+
+
+
+// ------------------------------------------------------------------- //
+//  Forms
+
+$form-border-color:       $base-border-color;
+$form-border-color-hover: shade($base-border-color, 10%);
+$form-border-color-focus: $base-accent-color;
+$form-border-radius:      $base-border-radius;
+
+$form-box-shadow: inset 0 1px 3px rgba(black, .1);
+$form-box-shadow-focus: $form-box-shadow,
+                        0 0 5px rgba($form-border-color-focus, .5);
+
+$form-font-family: $base-font-family;
+$form-font-size:   $base-font-size;
+
+
+
+// ------------------------------------------------------------------- //
+//  Media Queries
+
+$mobile:  480px;
+$tablet:  990px;
+$laptop:  1440px;
+$desktop: 1920px;
+
+
+
+// ------------------------------------------------------------------- //
+//  Z-Index Map
+
+$z-map: ("base":    0,
+         "nav":     10,
+         "overlay": 20,
+         "modal":   30);

data/app/assets/stylesheets/kentucky/base/_tables.scss

@@ -0,0 +1,28 @@
+// ------------------------------------------------------------------- //
+//  Table Normalization
+// ------------------------------------------------------------------- //
+
+table {
+  width: 100%;
+  margin: ($base-spacing / 2) 0;
+  border-collapse: collapse;
+  table-layout: fixed;
+}
+
+th {
+  padding: ($base-spacing / 2) 0;
+  border-bottom: 1px solid shade($base-border-color, 15%);
+  font-weight: bold;
+  text-align: left;
+}
+
+td {
+  padding: ($base-spacing / 2) 0;
+  border-bottom: $base-border;
+}
+
+tr,
+td,
+th {
+  vertical-align: middle;
+}

data/app/assets/stylesheets/kentucky/base/_typography.scss

@@ -0,0 +1,91 @@
+// ------------------------------------------------------------------- //
+//  Typography Normalization
+// ------------------------------------------------------------------- //
+
+body {
+  -webkit-font-smoothing: antialiased;
+  background-color: $base-background-color;
+  color: $base-font-color;
+  font-family: $base-font-family;
+  font-size: $base-font-size;
+  line-height: $base-line-height;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  margin: 0;
+  font-family: $header-font-family;
+  line-height: $header-line-height;
+}
+
+h1 {
+  font-size: $h1-font-size;
+}
+
+h2 {
+  font-size: $h2-font-size;
+}
+
+h3 {
+  font-size: $h3-font-size;
+}
+
+h4 {
+  font-size: $h4-font-size;
+}
+
+h5 {
+  font-size: $h5-font-size;
+}
+
+h6 {
+  font-size: $h6-font-size;
+}
+
+p {
+  margin: 0 0 ($base-spacing / 2);
+}
+
+a {
+  color: $base-link-color;
+  text-decoration: none;
+  transition: color, .1s;
+
+  &:hover {
+    color: $hover-link-color;
+  }
+
+  &:active, &:focus {
+    color: $hover-link-color;
+    outline: none;
+  }
+}
+
+hr {
+  margin: $base-spacing 0;
+  border-bottom: $base-border;
+  border-left: none;
+  border-right: none;
+  border-top: none;
+}
+
+img,
+picture {
+  max-width: 100%;
+  margin: 0;
+}
+
+blockquote {
+  margin: $base-spacing 0;
+  padding-left: $base-spacing / 2;
+  border-left: 2px solid $base-border-color;
+  color: tint($base-font-color, 15%);
+}
+
+cite {
+  color: tint($base-font-color, 25%);
+  font-style: italic;
+
+  &:before {
+    content: "\2014 \00A0";
+  }
+}

data/app/assets/stylesheets/kentucky/functions/_assign.scss

@@ -0,0 +1,17 @@
+// ------------------------------------------------------------------- //
+//  Assign Function
+//  
+//  Used for input lists (in Addons).
+// ------------------------------------------------------------------- //
+
+@function assign-inputs($inputs, $pseudo: null) {
+  $list : ();
+
+  @each $input in $inputs {
+    $input: unquote($input);
+    $input: if($pseudo, $input + ":" + $pseudo, $input);
+    $list: append($list, $input, comma);
+  }
+
+  @return $list;
+}

data/app/assets/stylesheets/kentucky/functions/_tint-shade.scss

@@ -0,0 +1,11 @@
+// -------------------------------------------------------------------- //
+//  Tinting and Shading (Better color control)
+// -------------------------------------------------------------------- //
+
+@function tint($color, $percent) {
+  @return mix(white, $color, $percent);
+}
+
+@function shade($color, $percent) {
+  @return mix(black, $color, $percent);
+}

data/kentucky.gemspec

@@ -10,9 +10,9 @@ Gem::Specification.new do |s|
   s.authors     = ["Aaron Clemmer", "Greg Bruening", "Chris Brinson"]
   s.email       = ["greg@lookthink.com"]
   s.homepage    = "https://github.com/geebru/Kentucky"
-  s.summary     = "SCSS-based grid system and mixin library"
+  s.summary     = "SCSS project base and mixin library."
   s.description = <<-DESC
-Kentucky is LookThink's contribution to the CSS framework world with the unique difference of being entirely written in SCSS. This means no class restrictions muddling up your HTML. Kentucky is a collection of mixins, extends, and functions that you can use with your own HTML/CSS semantics to create responsive-ready websites.
+Kentucky is a class-independent front-end framework built as a standard project starting point.
   DESC
 
   #s.rubyforge_project = "bourbon"

data/lib/kentucky/version.rb

@@ -1,3 +1,3 @@
 module Kentucky
-  VERSION = "1.5.1"
+  VERSION = "2.0.0"
 end

data/readme.md

@@ -5,3 +5,132 @@
 
 ***
 
+Kentucky was originally an additional library to use with Bourbon as our developers ventured into the realm of front-end frameworks. As time progressed and more frameworks emerged from all corners of the internet it became clear we needed to create our own.
+
+Kentucky is meant to serve as a leaping point for front-end projects. It has no grid system (flexbox is simple enough without complicated DOM cluttering of classes) and is based entirely on the SCSS side of projects. Our framework is invisible to the end user inspecting elements on your site. This leaves developers completely open to use any form of semantics for classes as they're comfortable with.
+
+Below is some base documentation into what is included in Kentucky.
+
+***
+
+### Base
+
+###### Project Settings
+This file serves as the starting point for all projects. Full of default values for typography, spacing, colors, etc. it's the perfect place to store global, project-specific variables to use throughout your project.
+
+###### Layouts
+A very barebones file meant to serve as a place to keep global layout-related styles.
+
+###### Typography
+Slightly deceiving in name, but houses general typography / main content styles and normalization. This is where a majority of the variables (related to typography) in *_project-settings.scss* are called. 
+
+###### Buttons
+Normalization of all button-style inputs and serves as a location where project-wide button styles can live.
+
+###### Forms
+Normalization of form elements.
+
+###### Lists
+Normalization of unordered / ordered lists as well as definition lists. Also includes placeholder extends `%default-ul` and `%default-ol` that can applied to `ul` and `ol` elements that re-add the default list-styles for both as well as some margin/padding.
+
+###### Tables
+Normalization of table elements.
+
+
+### Addons
+
+###### Border
+A simple mixin that allows users to define unequal border widths inline with border style and color.
+
+*Usage Example:*
+
+```
+@include border(1px 2px 5px, solid, #b4d455);
+```
+
+###### Clearfix
+Simple mixin to call the super-micro clearfix snippet based on Theirry Koblentz's minification of Nicolas Gallagher's micro clearfix.
+
+*Usage Example:*
+
+```
+@include clearfix;
+```
+
+###### Easings
+Variable-based timing functions to be used in transition / animation styles.
+
+*Usage Example:*
+
+```
+.selector {
+  transition: all .5s #{$ease-in-quad};
+}
+```
+
+###### Hide Text
+Simple mixin to "hide text" in a new method, akin to the old -9999px hack to move text off of image replaced objects.
+
+*Usage Example:*
+
+```
+@include hide-text;
+```
+
+###### Input Types
+Primarily created for usage in the button / form normalization files but these can be used to target all button / text inputs at once without having to list each individually.
+
+*Usage Example:*
+
+```
+#{$all-button-inputs} {
+  margin-bottom: 20px;
+}
+```
+
+###### Position
+Akin to the border mixin, this allows users to include the type of positioning and coordinates in a single line.
+
+```
+@include position(absolute, 10px 20px 0 0);
+```
+
+*Note that all four values are required.*
+
+
+###### Size
+A dead simple mixin allowing users to set the width / height on a single line.
+
+```
+@include size(15px 20px);
+```
+
+*A single value will print the same value for width and height.*
+
+```
+@include size(20px);
+```
+
+
+###### Truncate
+Mixin that allows single-line, CSS-based truncation with an ellipsis. Requires a width value.
+
+```
+@include truncate(300px);
+```
+
+
+### Functions
+
+###### Assign
+Used in the input types addon. Usage is fairly minimal outside of that.
+
+###### Tint / Shade
+An improvement to the typical `darken` / `lighten` abilities of SCSS. Tint and shade add white / black respectively to create richer colors.
+
+```
+.selector {
+  background-color: tint(#b4d455, 5%);
+  color: shade($brand-color, 10%);
+}
+```

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kentucky
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Aaron Clemmer
@@ -10,34 +10,34 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-10 00:00:00.000000000 Z
+date: 2015-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
@@ -58,18 +58,18 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: |
-  Kentucky is LookThink's contribution to the CSS framework world with the unique difference of being entirely written in SCSS. This means no class restrictions muddling up your HTML. Kentucky is a collection of mixins, extends, and functions that you can use with your own HTML/CSS semantics to create responsive-ready websites.
+  Kentucky is a class-independent front-end framework built as a standard project starting point.
 email:
 - greg@lookthink.com
 executables:
@@ -77,38 +77,30 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - Rakefile
-- app/assets/stylesheets/kentucky/_forms.scss
 - app/assets/stylesheets/kentucky/_kentucky.scss
-- app/assets/stylesheets/kentucky/_normalize.scss
-- app/assets/stylesheets/kentucky/_project-settings.scss
-- app/assets/stylesheets/kentucky/_typography.scss
-- app/assets/stylesheets/kentucky/functions/_gradient-functions.scss
-- app/assets/stylesheets/kentucky/functions/_remify.scss
-- app/assets/stylesheets/kentucky/functions/_strip-units.scss
-- app/assets/stylesheets/kentucky/grid/_grid.scss
-- app/assets/stylesheets/kentucky/helpers/_anti-aliased.scss
-- app/assets/stylesheets/kentucky/helpers/_border.scss
-- app/assets/stylesheets/kentucky/helpers/_breadcrumbs.scss
-- app/assets/stylesheets/kentucky/helpers/_clearfix.scss
-- app/assets/stylesheets/kentucky/helpers/_font-size.scss
-- app/assets/stylesheets/kentucky/helpers/_go.scss
-- app/assets/stylesheets/kentucky/helpers/_headings.scss
-- app/assets/stylesheets/kentucky/helpers/_hide-text.scss
-- app/assets/stylesheets/kentucky/helpers/_html5-input-types.scss
-- app/assets/stylesheets/kentucky/helpers/_linear-gradient.scss
-- app/assets/stylesheets/kentucky/helpers/_mute.scss
-- app/assets/stylesheets/kentucky/helpers/_position.scss
-- app/assets/stylesheets/kentucky/helpers/_radial-gradient.scss
-- app/assets/stylesheets/kentucky/helpers/_size.scss
-- app/assets/stylesheets/kentucky/helpers/_strip-unit.scss
-- app/assets/stylesheets/kentucky/helpers/_triangle.scss
-- app/assets/stylesheets/kentucky/helpers/_truncate.scss
+- app/assets/stylesheets/kentucky/addons/_border.scss
+- app/assets/stylesheets/kentucky/addons/_clearfix.scss
+- app/assets/stylesheets/kentucky/addons/_easings.scss
+- app/assets/stylesheets/kentucky/addons/_hide-text.scss
+- app/assets/stylesheets/kentucky/addons/_input-types.scss
+- app/assets/stylesheets/kentucky/addons/_position.scss
+- app/assets/stylesheets/kentucky/addons/_size.scss
+- app/assets/stylesheets/kentucky/addons/_truncate.scss
+- app/assets/stylesheets/kentucky/base/_buttons.scss
+- app/assets/stylesheets/kentucky/base/_forms.scss
+- app/assets/stylesheets/kentucky/base/_layouts.scss
+- app/assets/stylesheets/kentucky/base/_lists.scss
+- app/assets/stylesheets/kentucky/base/_project-settings.scss
+- app/assets/stylesheets/kentucky/base/_tables.scss
+- app/assets/stylesheets/kentucky/base/_typography.scss
+- app/assets/stylesheets/kentucky/functions/_assign.scss
+- app/assets/stylesheets/kentucky/functions/_tint-shade.scss
 - bin/kentucky
 - features/install.feature
 - features/step_definitions/kentucky_steps.rb
@@ -133,12 +125,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
@@ -146,7 +138,7 @@ rubyforge_project:
 rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
-summary: SCSS-based grid system and mixin library
+summary: SCSS project base and mixin library.
 test_files:
 - features/install.feature
 - features/step_definitions/kentucky_steps.rb