letterfx 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 568a9bcea8a15b468e8fc376f3cf21f82f9d1f24
+  data.tar.gz: d94d75b2031a7daeb2a900b86ff8b88f8b5db581
+SHA512:
+  metadata.gz: a7d0bd1cf1533bb465436735a824c964e115b62426e2e012ff998bf001ef181708d443500bbeb2dded5267eba5be0c6a026d32a91130f1d71957f4985cee49bc
+  data.tar.gz: 4959ac1b4f6dc830fd54ca325616fcd02b9fb8439497db2a6a3f94bf66973d7e6d079543c9b42a87b01248c8be566060d1e1cf6f4190faaa8b44f5876026ef8c

data/.gitignore

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

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 TODO: Write your name
+
+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,48 @@
+# Letterfx
+
+Gem to apply animated, visual effects to letters, words or other text patterns.
+
+[Demo](http://tuxsudo.com/code/project/letterfx)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'letterfx'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install letterfx
+
+## Usage
+
+In your application.js, include the following:
+
+```
+//= require letterfx
+```
+
+In your application.css, include the following:
+
+```
+*= require letterfx
+```
+
+The jQuery
+
+```
+$(element).letterfx({"fx":"fly-right fly-bottom spin"})
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/letterfx.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'letterfx/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "letterfx"
+  spec.version       = Letterfx::VERSION
+  spec.authors       = ["Pulkit Kathuria"]
+  spec.email         = ["kevincobain2000@gmail.com"]
+  spec.description   = %q{Wrapper for jquery-letterfx}
+  spec.summary       = %q{For more details see http://tuxsudo.com/code/project/letterfx}
+  spec.homepage      = "https://github.com/kevincobain2000/letterfx"
+  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_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/letterfx.rb

@@ -0,0 +1,8 @@
+require "letterfx/version"
+
+module Letterfx
+  module Rails
+    class Engine < ::Rails::Engine
+    end
+  end
+end

data/lib/letterfx/version.rb

@@ -0,0 +1,3 @@
+module Letterfx
+  VERSION = "0.0.1"
+end

data/vendor/assets/javascripts/letterfx.js

@@ -0,0 +1,332 @@
+(function ($) {
+
+    "use strict";
+
+    var LetterFx = function (element, options) {
+
+        this.options = $.extend({}, $.fn.letterfx.defaults, options);
+
+        this.num_completed_fx = 0;
+
+        this.is_done = false;
+
+        this.monitor_timer = null;
+
+        this.killswitch=null;
+
+        this.$element = $(element);
+
+        if(this.options.restore)
+            this.original_html = this.$element.html();
+
+        this.init();
+
+    }
+
+     LetterFx.prototype.init = function(){
+
+        this.new_html = this.$element.text().replace( this.options.pattern, this.options.replacement );
+
+        this.$element.addClass(this.options.css.element.base).addClass( this.options.css.element.before );
+
+        this.$element.html( this.new_html );
+
+        this.$letters = this.$element.find(this.options.selector);
+
+        this.$letters
+            .css('transition-duration', this.options.fx_duration)
+            .addClass(this.options.css.letters.base)
+            .addClass(this.options.css.letters.before);
+
+        this.bindLetterFxEnd();
+
+        this.num_letters = this.$letters.length;
+
+
+        this.fx();
+
+        return this;
+    }
+
+    LetterFx.prototype.bindLetterFxEnd = function(){
+        var options = this.options;
+        var lfx = this;
+        this.$letters.bind("transitionend", function(){
+            options.onLetterComplete( $(this), lfx.$element, lfx );
+            lfx.notifyFXEnd( );
+
+            switch(options.letter_end){
+              case "destroy":
+                $(this).remove();
+                break;
+
+              case "rewind":
+                lfx.applyLetterFx( $(this), options.timing, options.css.letters.after, options.css.letters.before );
+                break;
+
+              case "stay":
+                break;
+
+              // restore
+              default:
+                $(this).replaceWith( $(this).text() );
+            }
+
+        });
+        return lfx;
+    }
+
+    LetterFx.prototype.terminate=function(){
+        this.is_done = true;
+        this.options.onElementComplete(this.$element, this);
+
+        clearTimeout(this.killswitch);
+
+          switch(this.options.element_end){
+            case "destroy":
+              this.$element.remove();
+              break;
+
+            case "stay":
+              break;
+
+            // restore
+            default:
+              this.$element.html( this.original_html );
+              this.$element.removeClass( this.options.css.element.base ).removeClass(this.options.css.element.after);
+              break;
+          }
+
+    }
+
+    LetterFx.prototype.notifyFXEnd=function(){
+        clearTimeout(this.monitor_timer);
+        this.num_completed_fx++;
+
+        var lfx = this;
+        this.monitor_timer = setTimeout(
+            function(){
+                if(lfx.num_completed_fx % lfx.num_letters===0){
+                    lfx.terminate();
+                }
+            },
+            Math.max(this.options.timing+10, 50)
+        );
+
+        return this;
+    }
+
+    LetterFx.prototype.startKillWatch = function(){
+        var fx_duration = this.options.fx_duration.match(/\d+s/) ? parseInt(this.options.fx_duration) : 1;
+        var time = Math.ceil(1.5 * this.num_letters * this.options.timing * fx_duration );
+        var lfx = this;
+        this.killswitch = window.setTimeout(function(){
+            if(!lfx.isDone()){
+                lfx.terminate()
+            }
+        }, time)
+    }
+
+    LetterFx.prototype.fx = function(){
+        var lfx = this;
+        this.startKillWatch();
+        this.$element.removeClass(this.options.css.element.before).addClass(this.options.css.element.after);
+        var $letters = this.options.sort(this.$letters);
+        var options = this.options;
+
+
+
+        $letters.each(
+            function(i, letter){
+                lfx.applyLetterFx( $(letter), (i+1)*options.timing, options.css.letters.before, options.css.letters.after);
+            }
+        );
+        return this;
+    }
+
+    LetterFx.prototype.applyLetterFx = function($letter, timing, css_before, css_after){
+        var options = this.options;
+
+        window.setTimeout(
+            function(){
+                $letter.removeClass(css_before).addClass(css_after);
+            },
+            timing
+        );
+        return this
+    }
+
+    LetterFx.prototype.isDone = function(){
+        return this.is_done;
+    }
+
+
+
+
+    var LetterFxConfig = function(conf){
+       this.config = $.extend({}, $.fn.letterfx.defaults, conf);
+       this.buildCss(this.config.backwards);
+
+       // check & change to word pattern
+       if(this.config.words)
+            this.config.pattern=/(\S+)/g;
+
+
+    }
+
+
+    LetterFxConfig.prototype.buildCss = function(flip){
+        var options = this.config;
+        var before = flip ? 'after' : 'before';
+        var after = flip ? 'before' : 'after';
+
+
+        var css = { element:{}, letters:{} };
+
+        css.element.base=options.element_class+ "-container " + options.fx.replace(/(\S+)/g, options.element_class + "-$1-container");
+        css.element[before]=options.fx.replace(/(\S+)/g, options.element_class + "-$1-before-container");
+        css.element[after]=options.fx.replace(/(\S+)/g, options.element_class + "-$1-after-container");
+
+        css.letters.base = options.element_class;
+        css.letters[before] = options.fx.replace(/(\S+)/g, options.element_class + "-$1-before")
+        css.letters[after] = options.fx.replace(/(\S+)/g, options.element_class + "-$1-after")
+
+        this.config = $.extend( options, {'css':css} );
+    }
+
+    LetterFxConfig.prototype.getConfig = function(){
+        return this.config;
+    }
+
+    LetterFxConfig.parse=function(config){
+        return (new LetterFxConfig( config )).getConfig();
+    }
+
+
+
+
+$.fn.letterfx=function(config){
+
+    config = LetterFxConfig.parse( config );
+
+    return $(this).each(function(){
+        var $element = $(this);
+        if (! $element.data('letterfx-obj') || $element.data('letterfx-obj').isDone() ){
+            $element.data('letterfx-obj', new LetterFx( $element, config ) );
+        }
+    });
+
+};
+
+$.fn.letterfx.sort={
+    random:function(array){
+        var currentIndex = array.length, temporaryValue, randomIndex;
+
+        // While there remain elements to shuffle...
+        while (0 !== currentIndex) {
+
+      // Pick a remaining element...
+      randomIndex = Math.floor(Math.random() * currentIndex);
+      currentIndex -= 1;
+
+      // And swap it with the current element.
+      temporaryValue = array[currentIndex];
+      array[currentIndex] = array[randomIndex];
+      array[randomIndex] = temporaryValue;
+    }
+
+    return array;
+    },
+    reverse:function($array){
+        return $array.toArray().reverse();
+    }
+}
+
+$.fn.letterfx.patterns={
+    letters:/(\S)/gi
+}
+
+// Plugin Configurables
+$.fn.letterfx.defaults = {
+
+  // Default fx
+  fx:'spin fly-top',
+
+  // defaults to selecting all characters
+  pattern:/(\S)/gi,
+
+  // switch from letter FX to word FX.
+  word:false,
+
+    // fx, like fly or fade, can happen in (eg fade-in) or out (eg fade-out).
+    // The default is in; change backwards to true to reverse the order of the effects.
+  backwards:false,
+
+  // defaults to injecting spans, can be any inline element
+  replacement:"<span>$1</span>",
+
+  //selector -- should match replacement above
+  selector:'span',
+
+  // letter fx start sequentially: letters start their fx one after another.
+  // this sets time between the letters
+  timing:50,
+
+  //duration of each fx
+  // options the same as css property for transition-duration ("1ms", "1s", etc)
+  fx_duration:"1s",
+
+
+  // stabile dimensions
+  // stabilize:true,
+
+  // sort callback for custom sorting elements
+  sort:function($letters){ return $letters; },
+
+
+  // Callback when letter is done animating. Runs after each letter
+  onLetterComplete:function($letter, $element, LetterFXObj){},
+
+  // Runs after all are done.
+  onElementComplete:function($element, LetterFXObj){},
+
+
+  // what to do when a letter completes its animation.
+  // options include
+  //    restore: return letter to plain text (default)
+  //    destroy: get rid of the letter.
+  //    stay: leave it as is.
+  //    rewind: reverse the animation
+  letter_end:"restore",
+
+
+  // what to do when the entire element has completed all its letter effects
+  // options include:
+  //    restore: return element to its pre-fx state (default)
+  //    stay: do nothing
+  //    destroy: get rid of the element... FOREVER
+  element_end:"restore",
+
+  // Restore container element back to original state.
+  // options: true, false, "element" ("element" waits until all letters complete fx before restoring)
+  restore:true,
+
+  // destroy element/letters after fx, useful on {out:true} fx
+  // options: true, false, "letters" ("letters" destroys each letter after fx, but elements original content may be restored after all letters complete fx)
+  destroy:false,
+
+    // default class for injected elements
+    element_class:'letterfx',
+
+    // placeholder values that are calculated on launch
+    css:{
+        element:{ base:'', before:'', after:''},
+        letters:{ base:'', before:'', after:''}
+    }
+
+
+
+};
+
+}(jQuery));
+

data/vendor/assets/stylesheets/letterfx.css

@@ -0,0 +1,111 @@
+.letterfx-container{}
+
+.letterfx{
+    display:inline-block;
+    margin:0;
+    padding:0;
+    transition: all 1s; -ms-transition: all 1s; -webkit-transition: all 1s;
+}
+
+/* Spin FX */
+.letterfx-spin-before{
+    transform:rotate(3600deg); -ms-transform:rotate(3600deg); -webkit-transform:rotate(3600deg);
+}
+
+.letterfx-spin-after{
+    transform:none;
+}
+
+/* Fade FX */
+.letterfx-fade-before{
+  opacity: 0;
+}
+
+
+/* Grow FX */
+.letterfx-grow-before{
+    transform:scale(0,0); -ms-transform:scale(0,0); -webkit-transform:scale(0,0);
+}
+
+.letterfx-grow-after{
+    transform:none;
+}
+
+
+/* Smear FX */
+.letterfx-smear-before{
+    color: transparent;
+    text-shadow:-1px -1px 25px transparent;
+}
+
+.letterfx-smear-after{
+    color:inherit;
+    text-shadow:0 0 #333;
+
+}
+
+/* Fall FX */
+.letterfx-fall-before
+{
+    visibility: hidden;
+    transform:scale(3,3); -ms-transform:scale(3,3); -webkit-transform:scale(3,3);
+}
+
+.letterfx-fall-after{
+    transform:scale(1,1); -ms-transform:scale(1,1); -webkit-transform:scale(1,1);
+    text-shadow:0;
+}
+
+/* Swirl FX */
+.letterfx-swirl-before
+{
+    visibility: hidden;
+    transform:scale(3,3) rotate(3600deg); -ms-transform:scale(3,3) rotate(3600deg); -webkit-transform:scale(3,3) rotate(3600deg);
+}
+
+.letterfx-swirl-after{
+    transform:none
+    text-shadow:0;
+}
+
+
+/* Wave FX */
+.letterfx-wave-container .letterfx
+{
+    position:relative;
+}
+
+.letterfx-wave-before
+{
+    bottom:0;
+}
+
+.letterfx-wave-after{
+    bottom:15px;
+}
+
+
+
+/* FLY FX */
+.letterfx-fly-left-container .letterfx,
+.letterfx-fly-right-container .letterfx,
+.letterfx-fly-top-container .letterfx,
+.letterfx-fly-bottom-container .letterfx
+{
+    position:relative;
+}
+
+.letterfx-fly-left-before{ left:-50em; }
+.letterfx-fly-left-after{ left:0; }
+
+.letterfx-fly-right-before{ right:-50em; }
+.letterfx-fly-right-after{ right:0; }
+
+.letterfx-fly-top-before{ top:-20em; }
+.letterfx-fly-top-after{ top:0; }
+
+.letterfx-fly-bottom-before{ bottom:-20em; }
+.letterfx-fly-bottom-after{ bottom:0; }
+
+
+

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: letterfx
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Pulkit Kathuria
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  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: Wrapper for jquery-letterfx
+email:
+- kevincobain2000@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- letterfx.gemspec
+- lib/letterfx.rb
+- lib/letterfx/version.rb
+- vendor/.DS_Store
+- vendor/assets/javascripts/letterfx.js
+- vendor/assets/stylesheets/letterfx.css
+homepage: https://github.com/kevincobain2000/letterfx
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: For more details see http://tuxsudo.com/code/project/letterfx
+test_files: []