flat-ui-sass 2.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 30b75c5684d98ac62d61fee26600df3fbeacd023
+  data.tar.gz: d4d52c67b5674279bc21b197842ad64b96150a76
+SHA512:
+  metadata.gz: d6cda5974818e6ca28d19f71f16947e5aeae3430422212cf33c2957a73e1028faa7921d98660a0ab51e5f61e05e3df78014b39c9854f91d204d22c14898fac1e
+  data.tar.gz: 44cc69598d798d9a43f3fd65f3a17b7471a177ebba21f369a895b90ba0c866218178bc8457d072889a4f3986502148d6d68f90d91a47afb2481634657eb93173

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.DS_Store

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "flat-ui"]
+	path = flat-ui
+	url = https://github.com/designmodo/Flat-UI.git

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in flatui-sass.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Stafford Brunk
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,256 @@
+# Flat UI for Sass
+
+`flat-ui-sass` is a SASS port of Designmodo's [Flat-UI Free](http://designmodo.github.io/Flat-UI/). `flat-ui-sass`
+also provides a rake task to convert and locally vendor [Flat-UI Pro](http://designmodo.com/flat/) for use with
+Rails, Compass, and vanilla SASS.
+
+##### This gem is currently under development! Things may be broken!
+
+## Dependencies
+
+`flat-ui-sass` requires [`bootstrap-sass`](https://github.com/twbs/bootstrap-sass)
+
+`flat-ui-sass` depends on `term-ansicolor` right now for the logging
+functionality of the converter. This is on the roadmap for removal.
+
+Flat-UI uses the [Lato](https://www.google.com/fonts/specimen/Lato)
+font as its base font. This gem does not vendor Lato. It is up to you to make
+sure Lato is available on your page.
+
+#### Notice:
+
+The preferred version of sass is v3.3.0+. Unfortunately, this version is not
+supported by sass-rails >= v4.0.2. If you run on sass v3.2.x, the only thing
+that will not work properly is the color swatch module in Flat-UI Free. The only
+other difference is in how the Flat-UI asset helper is discovered (see
+`_variables.scss`).
+
+## Installation
+
+### Rails
+
+Add the following to your Gemfile:
+
+    gem 'flat-ui-sass', github: 'wingrunr21/flat-ui-sass'
+
+### Compass (no Rails, Flat-UI free only right now)
+
+Install the gem:
+
+    gem install flat-ui-sass
+
+or add it to your Gemfile:
+
+    gem 'flat-ui-sass', github: 'wingrunr21/flat-ui-sass'
+
+For existing projects:
+
+    # config.rb:
+    require 'flat-ui-sass'
+
+    bundle exec compass install flat-ui
+
+For new projects:
+
+    bundle exec compass create new_project -r flat-ui-sass --using flat-ui
+
+The resulting Compass project will have all Flat-UI JS/fonts/images as well as
+the bootstrap JS/fonts.
+
+The following SCSS files will also be created:
+
+* [_variables.scss](/templates/project/_variables.scss.erb) - all of the Flat UI variables (override them here).
+* [styles.scss](/templates/project/styles.scss) - primary SCSS file, import `variables`, `flat-ui/variables`, `bootstrap`, and `flat-ui`.
+
+### vanilla SASS (no Compass or Rails)
+
+Install the gem:
+
+    gem install flat-ui-sass
+
+or add it to your Gemfile:
+
+    gem 'flat-ui-sass', github: 'wingrunr21/flat-ui-sass'
+
+Follow the JS and Fonts setup instructions for [bootstrap-sass](https://github.com/twbs/bootstrap-sass#js-and-fonts)
+
+In addition, you will need to copy font, image, and javascript assets out of
+flat-ui-sass if you are using Flat-UI Free:
+
+    mkdir public/images
+    cp -r $(bundle show flat-ui-sass)/vendor/assets/images/ public/images
+    cp -r $(bundle show flat-ui-sass)/vendor/assets/fonts/ public/fonts/
+    cp -r $(bundle show flat-ui-sass)/vendor/assets/javascripts/ public/javascripts/
+
+If you are using Flat-UI Pro, you can copy or symlink the various assets out of
+the local vendor/assets directory in the root of your project.
+
+Similar to bootstrap-sass, we provide Ruby methods to report the appropriate
+paths:
+
+    FlatUI.stylesheets_path
+    FlatUI.fonts_path
+    FlatUI.javascripts_path
+    FlatUI.images_path
+
+## Usage
+
+### Converting Flat-UI Pro
+
+You can use the `fui_convert` command packaged along with `flat-ui-sass` to
+automatically convert and vendor Flat-UI Pro to your local application:
+
+1. Place the Flat-UI Pro directory (e.g. the one with the less, js, font, image,
+   etc files in it) in a directory at the root of your app titled `flat-ui-pro`
+2. Run `bundle exec fui_convert`. You should see a lot of output
+   regarding the conversion process. When it is finished, Flat-UI Pro should be
+   converted and available in the `vendor/assets/` directory.
+
+See `fui_convert --help` for more advanced usage
+
+#### SCSS
+
+Import the Flat-UI variables, bootstrap, and then Flat-UI:
+
+    @import 'flat-ui/variables';
+    @import 'bootstrap';
+    @import 'flat-ui';
+
+For Flat-UI Pro, simply import `flat-ui-pro` instead:
+
+    @import 'flat-ui-pro/variables';
+    @import 'bootstrap';
+    @import 'flat-ui-pro';
+
+You must import the Flat-UI variables before bootstrap, otherwise bootstrap's
+variables will take priority!
+
+##### Missing Modules
+
+Flat-UI Pro does not include a few modules that exist in Flat-UI Free.
+Designmodo has stated this is because [they are not yet mobile-ready](https://github.com/designmodo/Flat-UI-Pro-Support/issues/419#issuecomment-39879885). If you
+still wish to use these modules, you can import them from this gem's version of
+Flat-UI Free:
+
+    @import 'flat-ui/modules/footer';
+    @import 'flat-ui/modules/login';
+    @import 'flat-ui/modules/palette';
+    @import 'flat-ui/modules/share';
+    @import 'flat-ui/modules/tile';
+    @import 'flat-ui/modules/todo';
+
+#### Javascript
+Flat-UI has a lot of javascript dependencies. It is up to you to make sure the
+appropriate javascript files are available in your application. For a reference,
+check out the bottom of the `index.html` example page for your version of
+Flat-UI or the list below.
+
+If you are using Rails or Sprockets, you may require the manifest for all
+javascript assets:
+
+Free:
+
+    //= require flat-ui
+
+Pro:
+
+    //= require flat-ui-pro
+
+Alternatively, you may require individual modules as well
+
+Free:
+
+    //= require flat-ui/flatui-checkbox
+    //= require flat-ui/flatui-radio
+
+Pro:
+
+    //= require flat-ui-pro/flatui-checkbox
+    //= require flat-ui-pro/flatui-radio
+    //= require flat-ui-pro/flatui-fileinput
+
+Here's a list of javascript dependencies in Flat-UI Free:
+
+* jquery
+* jquery.ui.core
+* jquery.ui.widget
+* jquery.ui.mouse
+* jquery.ui.position
+* jquery.ui.slider
+* jquery.ui.tooltip
+* jquery.ui.effect
+* jquery.ui.touch-punch.min
+* bootstrap
+* bootstrap-select
+* bootstrap-switch
+* jquery.tagsinput
+* jquery.placeholder
+* jquery.stacktable
+* video.js
+
+In addition, Flat-UI Pro also requires:
+
+* jquery.ui.button
+* jquery.ui.datepicker
+* jquery.ui.spinner
+* typeahead.js
+* holder.js
+
+#### Icon Helper
+A Rails helper is also included to aid with using the Flat-UI glyph icons:
+
+    fui_icon "heart"
+    # => <i class="fui-heart"></i>
+
+    fui_icon "heart", tag: :span
+    # => <span class="fui-heart"></span>
+
+    fui_icon "heart", text: "Flat-UI!"
+    # => <i class="fui-heart"></i> Flat-UI!
+    fui_icon "arrow-right", text: "Get started", right: true
+    # => Get started <i class="fui-arrow-right"></i>
+
+    fui_icon "photo", class: "pull-left"
+    # => <i class="fui-photo pull-left"></i>
+
+    fui_icon "user", data: { id: 123 }
+    # => <i class="fui-user" data-id="123"></i>
+
+    content_tag(:li, fui_icon("check", text: "Bulleted list item"))
+    # => <li><i class="fui-check"></i> Bulleted list item</li>
+
+## Roadmap
+
+1. bower support
+2. Tests
+
+## Development and Contributing
+
+This gem uses a modified version of the converter utilized in [bootstrap-sass](https://github.com/twbs/bootstrap-sass). The converter runs over the checked-out Flat-UI git submodule and vendors the resulting files in `vendor/assets`. The converter does the following:
+
+* Converts the LESS to SASS, fixing `@import` orders to load correct under SASS.
+* Generates a `flat-ui.scss` or `flat-ui-pro.scss` manifest
+* Copies Flat-UI javascript files and generates a `flat-ui.js` or
+  `flat-ui-pro.js` manifest
+* Copies the Flat-UI Icons font
+* Copies supporting Flat-UI images
+
+The converter is located in `lib/tasks/`
+
+Version numbers for the current versions of Flat-UI and Flat-UI Pro that the
+converter works against are in `version.rb`
+
+### Developing
+
+1. Clone this repository to a working directory
+2. Initialize the Flat-UI submodule (`git submodule update --init`)
+3. Create a new topic branch for your changes (`git checkout -b my_new_feature`)
+4. Make some changes
+5. Run `rake flat_ui:convert` to convert Flat-UI and vendor it
+
+## Credits
+
+The conversion scripts and general gem structure rely upon and are heavily
+influenced by the work done on [bootstrap-sass](https://github.com/twbs/bootstrap-sass). This gem would not be possible without all of the hard work put into that project.
+
+Thanks also go to [Designmodo](http://designmodo.com/) for creating and publishing Flat-UI.

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+
+namespace :flat_ui do
+  desc "Converts Flat UI from LESS to SASS and vendors it"
+  task :convert do |t, args|
+    require 'tasks/converter'
+    Converter.new.process_flat_ui!
+  end
+
+  desc "Updates the Flat UI Free submodule"
+  task :update do
+    `git submodule foreach git pull origin master`
+  end
+end

data/app/helpers/flat_ui/rails/icon_helper.rb

@@ -0,0 +1,60 @@
+# Rails view helpers for Flat-UI glyphs
+# Based on https://github.com/bokmann/font-awesome-rails/blob/master/app/helpers/font_awesome/rails/icon_helper.rb
+module FlatUI
+  module Rails
+    module IconHelper
+      # Creates an icon tag given an icon name and possible icon
+      # modifiers.
+      #
+      # Examples
+      #
+      #   fui_icon "heart"
+      #   # => <i class="fui-heart"></i>
+      #
+      #   fui_icon "heart", tag: :span
+      #   # => <span class="fui-heart"></span>
+      #
+      #   fui_icon "heart", text: "Flat-UI!"
+      #   # => <i class="fui-heart"></i> Flat-UI!
+      #   fui_icon "arrow-right", text: "Get started", right: true
+      #   # => Get started <i class="fui-arrow-right"></i>
+      #
+      #   fui_icon "photo", class: "pull-left"
+      #   # => <i class="fui-photo pull-left"></i>
+      #
+      #   fui_icon "user", data: { id: 123 }
+      #   # => <i class="fui-user" data-id="123"></i>
+      #
+      #   content_tag(:li, fui_icon("check", text: "Bulleted list item"))
+      #   # => <li><i class="fui-check"></i> Bulleted list item</li>
+      def fui_icon(names = "flag", options = {})
+        classes = Private.icon_names(names)
+        classes.concat Array.wrap(options.delete(:class))
+        text = options.delete(:text)
+        right_icon = options.delete(:right)
+        tag = options.delete(:tag) { :i }
+        icon = content_tag(tag, nil, options.merge(:class => classes))
+        Private.icon_join(icon, text, right_icon)
+      end
+
+      module Private
+        extend ActionView::Helpers::OutputSafetyHelper
+
+        def self.icon_join(icon, text, reverse_order = false)
+          return icon if text.blank?
+          elements = [icon, ERB::Util.html_escape(text)]
+          elements.reverse! if reverse_order
+          safe_join(elements, " ")
+        end
+
+        def self.icon_names(names = [])
+          array_value(names).map { |n| "fui-#{n}" }
+        end
+
+        def self.array_value(value = [])
+          value.is_a?(Array) ? value : value.to_s.split(/\s+/)
+        end
+      end
+    end
+  end
+end

data/bin/fui_convert

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+require "pathname"
+bin_file = Pathname.new(__FILE__).realpath
+$:.unshift File.expand_path("../../lib", bin_file)
+
+require 'flat-ui-sass/cli'
+FlatUI::CLI.start(*ARGV)

data/flat-ui-sass.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'flat-ui-sass/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "flat-ui-sass"
+  spec.version       = FlatUI::VERSION
+  spec.authors       = ["Stafford Brunk"]
+  spec.email         = ["stafford.brunk@gmail.com"]
+  spec.description   = %q{SASS conversion of Designmodo's Flat UI Free along with tools to convert Flat UI Pro}
+  spec.summary       = %q{An automatic SASS conversion of Designmodo's Flat UI Free along with tools to automatically convert Flat UI Pro to SASS}
+  spec.homepage      = "https://github.com/wingrunr21/flat-ui-sass"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "bootstrap-sass", ">= 3.1"
+  spec.add_dependency "sass", ">= 3.2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "compass"
+  spec.add_development_dependency "sass-rails", ">= 3.2"
+end

data/lib/flat-ui-sass.rb

@@ -0,0 +1,98 @@
+# Based on bootstrap-sass.rb
+# https://github.com/twbs/bootstrap-sass/blob/master/lib/bootstrap-sass.rb
+
+require "bootstrap-sass"
+require "flat-ui-sass/version"
+
+module FlatUI
+  class << self
+    def load!
+      require 'flat-ui-sass/sass_functions'
+
+      register_compass_extension if compass?
+
+      if rails?
+        require 'sass-rails'
+        register_rails_engine
+      end
+
+      configure_sass
+    end
+
+    # Paths
+    def gem_path
+      @gem_path ||= File.expand_path '..', File.dirname(__FILE__)
+    end
+
+    # This definitely needs a better solution
+    def project_path
+      @project_path ||= Dir.pwd
+    end
+
+    def base_path
+      @base_path ||= pro? ? project_path : gem_path
+    end
+
+    def stylesheets_path
+      File.join assets_path, 'stylesheets'
+    end
+
+    def fonts_path
+      File.join assets_path, 'fonts'
+    end
+
+    def javascripts_path
+      File.join assets_path, 'javascripts'
+    end
+
+    def images_path
+      File.join assets_path, 'images'
+    end
+
+    def assets_path
+      @assets_path ||= File.join base_path, 'vendor', 'assets'
+    end
+
+    # Environment detection helpers
+    def asset_pipeline?
+      defined?(::Sprockets)
+    end
+
+    def compass?
+      defined?(::Compass)
+    end
+
+    def rails?
+      defined?(::Rails)
+    end
+
+    def pro?
+      Dir.exists? File.join(project_path, 'vendor/assets/stylesheets/flat-ui-pro')
+    end
+
+    private
+
+    def configure_sass
+      ::Sass.load_paths << stylesheets_path
+
+      # bootstrap requires minimum precision of 10, see https://github.com/twbs/bootstrap-sass/issues/409
+      ::Sass::Script::Number.precision = [10, ::Sass::Script::Number.precision].max
+    end
+
+    def register_compass_extension
+      ::Compass::Frameworks.register(
+          pro? ? 'flat-ui-pro' :  'flat-ui',
+          :path                  => gem_path,
+          :stylesheets_directory => stylesheets_path,
+          :templates_directory   => File.join(gem_path, 'templates')
+      )
+    end
+
+    def register_rails_engine
+      require 'flat-ui-sass/engine'
+    end
+  end
+end
+FlatUi = FlatUI
+
+FlatUI.load!