ustyle 1.3.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 152ffa1f54bf8f37776785b899cfd99aa36c724b
+  data.tar.gz: 6e2bba45581cfd3963c652185c3a7f6f1bb86c02
+SHA512:
+  metadata.gz: b6a75c989e4b94041e25400082844ff4b23f859b576af31539b7e35834932446add93a538b7a7ce80cfebd967a2f657512d9f386aaf35b7cd0027aa1abda3700
+  data.tar.gz: 66468e0db992babdcc2f336be3ee10e816985e782140da30b26592c230f93842fe4410d877eb2a4f12cde93ff8b0621ab11b3d3a3e8c0453ded90115d4dd72da

data/.gitignore

@@ -0,0 +1,23 @@
+*.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
+*.sublime-*
+docs/
+.sass-cache/
+node_modules/
+build/

data/.rbenv-gemsets

@@ -0,0 +1 @@
+ustyle

data/.ruby-version

@@ -0,0 +1 @@
+2.2.3

data/CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing
+
+### Code style
+Please see [uStyle](http://ustyle.guide)
+
+## Modifying the code
+
+You have several options with regards to modifying, each of which come with their advantages and disadvantages.
+
+### Documentation
+
+Documentation must be written for any component you are actively working on. All documentation that isn't full page examples remains within the source code `.scss` files. We use [DSS](https://github.com/darcyclarke/DSS) for documenting components. This is done like this:
+
+```scss
+// @page Forms
+// @name Inputs
+// 
+// @description
+//   The standard form input, `.us-form-input`, styled with our brand colours. Explicitly
+//   classed to allow individual app styling for other inputs
+//
+// @state .large - Larger input style
+//
+// @markup
+//   <input class='us-form-input {$modifiers}' type='text'>
+```
+
+`{$modifiers}` is a placeholder where the different states get rendered. If the component you are documenting requires an additional, more complex, component that doesn't quite fit the basic `style_block.tpl` layout, you can declare a partial, like so:
+
+```scss
+@page Colours
+@name Base colours
+@partial colours
+```
+
+Then you can have a partial named `colours.tpl` in `partials/` and run with that.
+
+All output of our documentation goes to `ustyle.json` in `build/`. This contains the JSON which is then parsed by our `builder.js` module and compiled to handlebars. All context within DSS is available on the templates.
+
+### Method 1
+
+1. Clone the existing repo.
+1. Run `bundle install` to install all dependencies.
+1. Create a new feature branch - do not work off `master`
+1. Add in the features/fixes
+1. Test -- this means running the gem locally on several projects. **Not just your own**
+1. Commit with a *reasonable* commit message.
+1. Submit a pull request and wait for it to be merged into master
+
+
+### Method 2
+
+**Warning: If you are unsure about using the publisher function, please use method 1. If you think you're super awesome and won't screw up uStyle versions, please read on.**
+
+1. Clone existing repo
+1. Run a `bundle config --local ustyle /PATH-TO-USTYLE` -- this will allow you to test and work off master on your local copy.
+1. Work off `master` and add in your awesome features.
+1. Test some more, ensure you've run this in a few projects.
+2. Ensure you commit `/dist` into your changes
+1. Run `grunt publish:{patch,minor,major}`
+1. Voilà! You now have successfully updated and pushed the gem version, updated the stylesheets and built the styleguide. You're now a pro.
+
+Publishing
+===
+
+Versioning gets done automatically by the `grunt:publish` command. However without specifying a type of version, if will just publish `HEAD` without a new release. 
+
+    $ grunt:publish:{patch,minor,major}

data/Gemfile

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

data/Gruntfile.js

@@ -0,0 +1,189 @@
+var autoprefixer = require("autoprefixer-core");
+
+module.exports = function(grunt) {
+
+  require("load-grunt-tasks")(grunt);
+  grunt.loadTasks("grunt/tasks");
+
+  grunt.initConfig({
+    shell: {
+      publish: {
+        command: "bundle exec rake ustyle:publish"
+      }
+    },
+    version: {
+      project: {
+        src: ["package.json", "lib/ustyle/version.rb"]
+      }
+    },
+    postcss: {
+      options: {
+        processors: [
+          autoprefixer({ browsers: ["last 5 versions", "Firefox 22", "Explorer 8", "> 1%", "Opera 12.1"] }).postcss
+        ]
+      },
+      dist: { src: ["docs/**/*.css", "dist/**/*.css"] }
+    },
+    watch: {
+      options: {
+        spawn: false
+      },
+      build: {
+        files: ["vendor/assets/**/*", "styleguide/**/*", "dist/ustyle.json"],
+        tasks: ["copy", "sass", "sassdoc", "postcss", "browserSync-inject", "styleguide", "builder"]
+      },
+      scripts: {
+        files: ["styleguide/**/*.js", "vendor/**/*.js"],
+        tasks: ["concat"]
+      }
+    },
+    svg2png: {
+      dist: {
+        src: "vendor/assets/images/icons/",
+        sizes: ["16 144", "32 288", "64 576"]
+      }
+    },
+    svgmin: {
+      dist: {
+        files: [{
+          expand: true,
+          cwd: "vendor/assets/images/icons/",
+          src: "{,*/}*.svg",
+          dest: "vendor/assets/images/icons/"
+        }]
+      }
+    },
+    styleguide: {
+      dist: {
+        src: "vendor/assets/stylesheets/ustyle/**/*.scss",
+        dir: "styleguide",
+        output: "dist/ustyle.json",
+        statsFor: "https://assets0.uswitch.com/s3/uswitch-assets-eu/ustyle/{#tag}/ustyle-latest.css",
+        tagPlaceholder: "{#tag}",
+        tagStartVersion: "0.9.9"
+      }
+    },
+    builder: {
+      dist:{
+        files: {
+          "docs/": "dist/ustyle.json"
+        }
+      }
+    },
+    sass: {
+      dist: {
+        options: {
+          loadPath: ["vendor/assets/stylesheets/ustyle", "styleguide/assets/sass"],
+          require: "./lib/ustyle.rb",
+          style: "compressed",
+          sourcemap: "none",
+          bundleExec: true
+        },
+        files: {
+          "dist/ustyle-latest.css": "vendor/assets/stylesheets/ustyle.scss",
+          "dist/ustyle-content.css": "vendor/assets/stylesheets/ustyle-content.scss",
+          "dist/ustyle-icons.css": "vendor/assets/stylesheets/ustyle-icons.scss",
+          "docs/css/main.css": "styleguide/assets/sass/main.scss"
+        }
+      }
+    },
+    concat: {
+      ustyle: {
+        src: [
+        "vendor/assets/javascripts/ustyle/utils.js",
+        "vendor/assets/javascripts/ustyle/anchor.js",
+        "vendor/assets/javascripts/ustyle/backdrop.js",
+        "vendor/assets/javascripts/ustyle/overlay.js",
+        "vendor/assets/javascripts/ustyle/tabs.js",
+        "vendor/assets/javascripts/ustyle/classtoggler.js",
+        "vendor/assets/javascripts/ustyle/radioToggle.js"
+        ],
+        dest: "dist/ustyle.js"
+      },
+      app: {
+        src: ["styleguide/assets/javascripts/vendor/*.js", "dist/ustyle.js", "styleguide/assets/javascripts/modules/*.js", "styleguide/assets/javascripts/*.js"],
+        dest: "docs/js/app.js"
+      }
+    },
+    copy: {
+      main: {
+        files: [
+          {expand: true, flatten: true, src: ["dist/*.css"], dest: "docs/css/"},
+          {expand: true, flatten: true, src: ["styleguide/assets/images/**"], dest: "docs/images/"},
+          {expand: true, flatten: true, src: ["styleguide/CNAME"], dest: "docs/"},
+        ]
+      }
+    },
+    sassdoc: {
+      default: {
+        src: "vendor/assets/stylesheets/ustyle/**/*.scss",
+        options: {
+          dest: "./docs/sass"
+        }
+      }
+    },
+    scsslint: {
+      allFiles: [
+        "./vendor/assets/stylesheets/**/*.scss",
+        "./styleguide/assets/sass/**/*.scss"
+      ],
+      options: {
+        bundleExec: true,
+        config: "config/scss-lint.yml",
+        reporterOutput: null,
+        exclude: [
+          "./vendor/assets/stylesheets/ustyle/vendor/*",
+          "./styleguide/assets/sass/vendor/*"
+        ]
+      }
+    },
+    jscs: {
+      src: [
+        "Gruntfile.js",
+        "vendor/assets/javascripts/**/*.js"
+      ],
+      options: {
+        config: "config/.jscsrc"
+      }
+    },
+    env: {
+      dev: {
+        NODE_ENV: "development"
+      },
+      build: {
+        NODE_ENV: "production"
+      }
+    },
+    buildcontrol: {
+      options: {
+        dir: "docs/",
+        commit: true,
+        push: true,
+        message: "Built %sourceName% from commit %sourceCommit% on branch %sourceBranch%"
+      },
+      pages: {
+        options: {
+          remote: "git@github.com:uswitch/ustyle.git",
+          branch: "gh-pages"
+        }
+      }
+    }
+  });
+
+  grunt.registerTask("lint", ["scsslint", "jscs"]);
+  grunt.registerTask("icons", ["newer:svgmin", "svg2png"]);
+
+  grunt.registerTask("build", ["sass", "sassdoc", "copy", "concat:ustyle", "concat:app", "lint", "postcss", "styleguide", "builder"]);
+
+  grunt.registerTask("publish", ["env:build", "build", "buildcontrol:pages"]);
+
+  grunt.registerTask("publish:version", "Build and publish ustyle version", function(version) {
+    if (version === null) {
+      grunt.warn("Version must be specified when publishing ustyle");
+    }
+
+    grunt.task.run("env:build", "version::" + version, "build", "shell:publish", "buildcontrol:pages");
+  });
+
+  grunt.registerTask("default", ["env:dev", "build", "browserSync-init", "watch"]);
+};

data/JAVASCRIPT_STANDARDS.md

@@ -0,0 +1,88 @@
+# JAVASCRIPT STANDARDS
+
+### INTRODUCTION
+
+We are using [JSCS](http://jscs.info/) to lint our javascript code within uStyle.
+
+### RULES
+
+Our preset is set to use Airbnb as the base set of options.
+
+```javascript
+{
+  "esnext": true,
+  "verbose": true,
+  "requireSpaceAfterKeywords": [
+      "if",
+      "else",
+      "for",
+      "while",
+      "do",
+      "switch",
+      "case",
+      "return",
+      "try",
+      "catch",
+      "typeof"
+  ],
+  "disallowSpacesInNamedFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInAnonymousFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInFunctionDeclaration": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowEmptyBlocks": true,
+  "disallowSpacesInsideArrayBrackets": true,
+  "disallowSpacesInsideParentheses": true,
+  "disallowSpaceAfterObjectKeys": true,
+  "disallowSpaceAfterPrefixUnaryOperators": true,
+  "disallowSpaceBeforePostfixUnaryOperators": true,
+  "disallowSpaceBeforeBinaryOperators": [
+      ","
+  ],
+  "disallowMixedSpacesAndTabs": true,
+  "disallowTrailingWhitespace": true,
+  "requireTrailingComma": { "ignoreSingleLine": true },
+  "disallowYodaConditions": true,
+  "disallowKeywords": [ "with" ],
+  "disallowKeywordsOnNewLine": ["else"],
+  "disallowMultipleLineBreaks": true,
+  "disallowMultipleLineStrings": true,
+  "disallowMultipleVarDecl": true,
+  "disallowSpaceBeforeComma": true,
+  "disallowSpaceBeforeSemicolon": true,
+  "requireSpaceBeforeBlockStatements": true,
+  "requireParenthesesAroundIIFE": true,
+  "requireSpacesInConditionalExpression": true,
+  "requireBlocksOnNewline": 1,
+  "requireCommaBeforeLineBreak": true,
+  "requireSpaceBeforeBinaryOperators": true,
+  "requireSpaceAfterBinaryOperators": true,
+  "requireCamelCaseOrUpperCaseIdentifiers": true,
+  "requireLineFeedAtFileEnd": true,
+  "requireCapitalizedConstructors": true,
+  "requireDotNotation": true,
+  "requireSpacesInForStatement": true,
+  "requireSpaceBetweenArguments": true,
+  "requireCurlyBraces": [
+      "do"
+  ],
+  "requirePaddingNewLinesBeforeLineComments": {
+      "allExcept": "firstAfterCurly"
+  },
+  "requirePaddingNewLinesAfterBlocks": true,
+  "requireSemicolons": true,
+  "safeContextKeyword": "_this",
+  "validateLineBreaks": "LF",
+  "validateIndentation": 2,
+
+  "validateQuoteMarks": "\"",
+  "requireTrailingComma": null
+}
+```

data/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2015 uSwitch Limited
+
+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
+
+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.

data/README.md

@@ -0,0 +1,93 @@
+# [ustyle](http://ustyle.guide)
+![ustyle unicorn](https://assets0.uswitch.com/s3/uswitch-assets-eu/ustyle/ustyle-unicorn.png)
+
+uStyle, aptly named, is the styleguide gem for [uSwitch](http://www.uswitch.com). Include it in your Rails/Sinatra/Anything project as a gem and forget about those annoying additional cloudfront includes.
+
+This project is provided as is and is aimed at building uSwitch specific projects.
+
+## Gem Requirements
+
+- Sprockets
+- SASS
+- Autoprefixer
+
+## Sprockets
+
+uStyle automagically sets itself up in a sprockets context where found. That means both Sinatra and Rails apps get configured correctly. However there are a few gotchas, as we don't want to add gem dependencies that are only required for certain set ups.
+
+### Sinatra applications
+
+Add to your Gemfile:
+``` ruby
+gem 'sprockets'
+gem 'sprockets-sass', '~> 1.2.0'
+gem 'sprockets-helpers'
+```
+
+Then in your app file (usually named server.rb/app.rb etc), after declaring your `class App < Sinatra::Base`:
+
+```ruby
+register Sinatra::Ustyle
+```
+
+**You must use `sprockets-sass` version 1.1.0 or above, as there was a bug where the postprocessor was getting added to the preprocessor which caused autoprefixer to break**
+
+This is only for the gem, not the styleguide within this project.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ustyle', git: "git@github.com:uswitch/ustyle.git"
+```
+
+And then run in your terminal:
+
+    $ bundle
+
+Version locking - if you're unsure about when you're going to have the change to upgrade again.
+
+```ruby
+gem 'ustyle', git: "git@github.com:uswitch/ustyle.git", tag: "VERSION"
+```
+
+## Usage
+
+If using rails and SASS, just import the base uSwitch styles at the start of your file
+
+```scss
+@import "ustyle";
+```
+
+This will import the main components. If you want more granular control of what to import, please look at the source code or the styleguide.
+
+## Development
+
+Development is done using [Grunt](http://gruntjs.com/), but it's just a thin wrapper around the heavy lifting done by some Node.js modules.
+
+To install development
+
+    $ npm install -g grunt-cli
+    $ npm install
+    $ bundle
+
+To run in development, just run
+
+    grunt
+
+This will open a http://localhost:3000 tab with the styleguide
+
+## Documentation
+
+See [JAVASCRIPT_STANDARDS.md](https://github.com/uswitch/ustyle/blob/master/JAVASCRIPT_STANDARDS.md)
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/uswitch/ustyle/blob/master/CONTRIBUTING.md)
+
+## Licences
+
+- Source code is licenced under Apache v2.0 licence
+- All icons, except the uSwitch icon are licenced under [CC - Attribution - No Derivatives 4.0](http://creativecommons.org/licenses/by-nd/4.0/)
+- uSwitch icon is licenced under [CC - Attribution - NonCommercial - NoDerivates 4.0](http://creativecommons.org/licenses/by-nc-nd/4.0/)

data/Rakefile

@@ -0,0 +1,6 @@
+lib_path = File.join(File.dirname(__FILE__), 'lib')
+$:.unshift(lib_path) unless $:.include?(lib_path)
+
+require "bundler/gem_tasks"
+
+load './tasks/publish.rake'

data/bower.json

@@ -0,0 +1,54 @@
+{
+  "name": "ustyle",
+  "description": "A living styleguide and pattern library by uSwitch.",
+  "main": [
+    "dist/ustyle-latest.css",
+    "dist/ustyle-icons.css",
+    "dist/ustyle.js"
+  ],
+  "dependencies": {
+    "jquery": ">= 1.9.1"
+  },
+  "moduleType": "globals",
+  "keywords": [
+    "css",
+    "sass",
+    "scss",
+    "js",
+    "javascript",
+    "front-end",
+    "styleguide",
+    "uswitch",
+    "ustyle"
+  ],
+  "authors": [
+    "uSwitch Limited <developers@uswitch.com>",
+    "Joe Green <joe.green@uswitch.com>",
+    "David Annez <david.annez@uswitch.com>",
+    "Thomas Britton <thomas.britton@uswitch.com>",
+    "Ricardo Cerqueira <ricardo.cerqueira@uswitch.com>",
+    "Ivo Reis <ivo.reis@uswitch.com>"
+  ],
+  "homepage": "http://ustyle.guide",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/uswitch/ustyle.git"
+  },
+  "license": "Apache-2.0",
+  "ignore": [
+    "/*.",
+    "config",
+    "docs",
+    "grunt",
+    "styleguide",
+    "tasks",
+    "CONTRIBUTING.md",
+    "Gemfile*",
+    "Gruntfile.js",
+    "JAVASCRIPT_STANDARDS.md",
+    "package.json",
+    "Rakefile",
+    "README.md",
+    "ustyle.gemspec"
+  ]
+}

data/config/.jscsrc

@@ -0,0 +1,76 @@
+{
+  "esnext": true,
+  "verbose": true,
+  "requireSpaceAfterKeywords": [
+      "if",
+      "else",
+      "for",
+      "while",
+      "do",
+      "switch",
+      "case",
+      "return",
+      "try",
+      "catch",
+      "typeof"
+  ],
+  "disallowSpacesInNamedFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInAnonymousFunctionExpression": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowSpacesInFunctionDeclaration": {
+      "beforeOpeningRoundBrace": true
+  },
+  "disallowEmptyBlocks": true,
+  "disallowSpacesInsideArrayBrackets": true,
+  "disallowSpacesInsideParentheses": true,
+  "disallowSpaceAfterObjectKeys": true,
+  "disallowSpaceAfterPrefixUnaryOperators": true,
+  "disallowSpaceBeforePostfixUnaryOperators": true,
+  "disallowSpaceBeforeBinaryOperators": [
+      ","
+  ],
+  "disallowMixedSpacesAndTabs": true,
+  "disallowTrailingWhitespace": true,
+  "requireTrailingComma": { "ignoreSingleLine": true },
+  "disallowYodaConditions": true,
+  "disallowKeywords": [ "with" ],
+  "disallowKeywordsOnNewLine": ["else"],
+  "disallowMultipleLineBreaks": true,
+  "disallowMultipleLineStrings": true,
+  "disallowMultipleVarDecl": true,
+  "disallowSpaceBeforeComma": true,
+  "disallowSpaceBeforeSemicolon": true,
+  "requireSpaceBeforeBlockStatements": true,
+  "requireParenthesesAroundIIFE": true,
+  "requireSpacesInConditionalExpression": true,
+  "requireBlocksOnNewline": 1,
+  "requireCommaBeforeLineBreak": true,
+  "requireSpaceBeforeBinaryOperators": true,
+  "requireSpaceAfterBinaryOperators": true,
+  "requireCamelCaseOrUpperCaseIdentifiers": true,
+  "requireLineFeedAtFileEnd": true,
+  "requireCapitalizedConstructors": true,
+  "requireDotNotation": true,
+  "requireSpacesInForStatement": true,
+  "requireSpaceBetweenArguments": true,
+  "requireCurlyBraces": [
+      "do"
+  ],
+  "requirePaddingNewLinesBeforeLineComments": {
+      "allExcept": "firstAfterCurly"
+  },
+  "requirePaddingNewLinesAfterBlocks": true,
+  "requireSemicolons": true,
+  "safeContextKeyword": "_this",
+  "validateLineBreaks": "LF",
+  "validateIndentation": 2,
+
+  "validateQuoteMarks": "\"",
+  "requireTrailingComma": null
+}

data/config/autoprefixer.yml

@@ -0,0 +1,6 @@
+browsers:
+  - "last 5 versions"
+  - "Firefox 22"
+  - "Opera 12.1"
+  - "> 1%"
+  - "Explorer 8"