hint 1.2.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d82923b5721402ed17e28f28e84b3e720f554053
+  data.tar.gz: e40988050bdab3ccf7c2b1336da603a03f49e528
+SHA512:
+  metadata.gz: a2ebf224553785cee605ce2b3dde2329274a57e6942305dd06811ea04140d3246ff890e3dd56082343b4ddf29b4ccbfb30505feeac390897bea09cf66695fe39
+  data.tar.gz: 1c430cfe3a67235d3e91dfc4edc277c857ddee7316ce0a0c1f25764b25ddf65109400e562296c6371e6f08accaedc21ac1c82773f5fccfc049f99662dc5fe623

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.sass-cache
+.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,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Miroslav Kyurchev
+
+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,82 @@
+# Hint
+
+This is gem-bundled version of [Hint.css](http://github.com/chinchang/hint.css), ready to use with Rails or Compass.
+
+Hint.css is a tooltip library written in SASS which uses only HTML/CSS to create simple tooltips. It does not rely on JavaScript and rather uses `data-*` attribute, pseudo elements, `content` property and CSS3 transitions to create the tooltips. Also it uses BEM naming convention particularly for the modifiers.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'hint'
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install hint
+```
+
+### Rails
+
+Import hint in an SCSS file:
+
+```scss
+@import "hint";
+```
+
+or require it via Sprockets:
+
+```css
+/*
+ *= require hint
+ */
+```
+
+### Compass
+
+Create new project:
+
+```sh
+$ compass create <project name> -r hint -u hint
+```
+
+or update an existing:
+
+```ruby
+# In config.rb
+require "hint"
+```
+
+## Usage
+
+Any element on your page which needs to have a tooltip has to be given at least one of the position classes: `hint--top`, `hint--bottom`, `hint--left`, `hint--right` to position the tooltip.
+
+```html
+Hello Sir, <span class="hint--bottom">hover me.</span>
+```
+
+The tooltip text needs to be given using the `data-hint` attribute on that element.
+
+```html
+Hello Sir, <span class="hint--bottom" data-hint="Thank you!">hover me.</span>
+```
+
+Use it with other available modifiers in various combinations. Available modifiers:
+- `hint--error`
+- `hint--info`
+- `hint--warning`
+- `hint--success`
+- `hint--always`
+- `hint--rounded`
+
+Check out some examples at http://kushagragour.in/lab/hint/
+
+## 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/hint.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hint/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hint"
+  spec.version       = Hint::VERSION
+  spec.authors       = ["Miroslav Kyurchev"]
+  spec.email         = ["mkyurchev@gmail.com"]
+  spec.description   = "Hint.css is a tooltip library written in SASS which uses only HTML/CSS to create simple tooltips."
+  spec.summary       = "A tooltip library in CSS ready to use with Rails or Compass."
+  spec.homepage      = "http://github.com/mkyurchev/hint"
+  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"
+  spec.add_development_dependency "compass", ">= 0.12.2"
+  spec.add_development_dependency "sass-rails", ">= 3.2"
+
+  spec.add_runtime_dependency "sass", ">= 3.2.0"
+end

data/lib/hint.rb

@@ -0,0 +1,50 @@
+require "hint/version"
+
+module Hint
+  class FrameworkNotFound < StandardError; end
+
+  # Inspired by Kaminari and bootstrap-sass
+  def self.load!
+    if compass?
+      register_compass_extension
+    end
+
+    if rails?
+      require 'sass-rails'
+      register_rails_engine
+    end
+
+    if !(rails? || compass?)
+      raise Hint::FrameworkNotFound, "hint requires either Rails > 3.1 or Compass, neither of which are loaded"
+    end
+
+    stylesheets = File.expand_path(File.join("..", 'vendor', 'assets', 'stylesheets'))
+    ::Sass.load_paths << stylesheets
+  end
+
+private
+  def self.asset_pipeline?
+    defined?(::Sprockets)
+  end
+
+  def self.compass?
+    defined?(::Compass)
+  end
+
+  def self.rails?
+    defined?(::Rails)
+  end
+
+  def self.register_compass_extension
+    base = File.join(File.dirname(__FILE__), '..')
+    styles = File.join(base, 'vendor', 'assets', 'stylesheets')
+    templates = File.join(base, 'templates')
+    ::Compass::Frameworks.register('hint', :path => base, :stylesheets_directory => styles, :templates_directory => templates)
+  end
+
+  def self.register_rails_engine
+    require 'hint/engine'
+  end
+end
+
+Hint.load!

data/lib/hint/engine.rb

@@ -0,0 +1,7 @@
+module Hint
+  module Rails
+    class Engine < ::Rails::Engine
+      # Rails, will you please look in our vendor? kthx
+    end
+  end
+end

data/lib/hint/version.rb

@@ -0,0 +1,3 @@
+module Hint
+  VERSION = "1.2.2"
+end

data/templates/project/manifest.rb

@@ -0,0 +1,5 @@
+description "Tooltip library for Compass."
+
+stylesheet 'screen.scss', :media => 'screen, projection'
+
+basedir = '../../vendor/assets'

data/templates/project/screen.scss

@@ -0,0 +1 @@
+@import "hint";

data/vendor/assets/stylesheets/hint.scss

@@ -0,0 +1,27 @@
+// hint.scss
+//
+// Aggregates all other sass files.
+
+/*-------------------------------------*\
+	HINT.css - A CSS tooltip library
+\*-------------------------------------*/
+
+
+/**
+ * HINT.css is a tooltip library made in pure CSS.
+ *
+ * Source: https://github.com/chinchang/hint.css
+ * Demo: http://kushagragour.in/labs/hint/
+ *
+ * Release under The MIT License
+ *
+ */
+
+
+@import "hint/variables";
+@import "hint/mixins";
+@import "hint/core";
+@import "hint/position";
+@import "hint/color_types";
+@import "hint/always";
+@import "hint/rounded";

data/vendor/assets/stylesheets/hint/_always.scss

@@ -0,0 +1,42 @@
+/**
+ * source: hint/_always.scss
+ *
+ * Defines a persisted tooltip which shows always.
+ *
+ * Classes added:
+ * 	1) hint--always
+ *
+ */
+
+// mixin to set margin on tooltip using translate transform
+@mixin set-margin($property, $transitionDirection) {
+	&:after, &:before {
+		-webkit-transform: #{$property}($transitionDirection * $transitionDistance);
+		-moz-transform: #{$property}($transitionDirection * $transitionDistance);
+		transform: #{$property}($transitionDirection * $transitionDistance);
+	}
+}
+
+.hint--always {
+	&:after, &:before {
+		opacity: 1;
+		visibility: visible;
+	}
+
+	&.hint--top {
+		@include set-margin('translateY', -1);
+	}
+
+	&.hint--bottom {
+		@include set-margin('translateY', 1);
+	}
+
+	&.hint--left {
+		@include set-margin('translateX', -1);
+	}
+
+	&.hint--right {
+		@include set-margin('translateX', 1);
+	}
+}
+

data/vendor/assets/stylesheets/hint/_color_types.scss

@@ -0,0 +1,52 @@
+/**
+ * source: hint/_color_types.scss
+ *
+ * Contains tooltips of various types based on color differences.
+ *
+ * Classes added:
+ * 	1) hint--error
+ * 	2) hint--warning
+ * 	3) hint--info
+ * 	4) hint--success
+ *
+ */
+
+
+// mixin to generate different color style tooltips
+@mixin hint-type($color) {
+	&:after {
+		background-color: $color;
+		text-shadow: 0 -1px 0px darken($color, $textShadowDarkenAmount);
+	}
+
+	// generate arrow color style
+	@include arrow-border-color($color);
+}
+
+/**
+ * Error
+ */
+.hint--error {
+	@include hint-type($errorColor);
+}
+
+/**
+ * Warning
+ */
+.hint--warning {
+	@include hint-type($warningColor)
+}
+
+/**
+ * Info
+ */
+.hint--info {
+	@include hint-type($infoColor)
+}
+
+/**
+ * Success
+ */
+.hint--success {
+	@include hint-type($successColor)
+}

data/vendor/assets/stylesheets/hint/_core.scss

@@ -0,0 +1,72 @@
+/**
+ * source: hint/_core.scss
+ *
+ * Defines the basic styling for the tooltip.
+ * Each tooltip is made of 2 parts:
+ * 	1) body (:after)
+ * 	2) arrow (:before)
+ *
+ * Classes added:
+ * 	1) hint
+ */
+
+.hint, [data-hint] {
+	position: relative;
+	display: inline-block;
+
+	&:before, &:after {
+		position: absolute;
+
+		// HACK: Trigger hardware accelerated rendering, otherwise transform was not
+		// working on a hidden element
+		-webkit-transform: translate3d(0, 0, 0);
+		-moz-transform: translate3d(0, 0, 0);
+		transform: translate3d(0, 0, 0);
+
+		// HACK: visibility is set to hidden because IE & Opera don't support
+		// pointer-events on HTML content yet because of which hovering a hidden tooltip
+		// shows the tooltip.
+		visibility: hidden;
+		opacity: 0;
+		z-index: 1000000;
+		// shouldn't receive pointer events, otherwise even hovering tooltip will make it appear
+		pointer-events: none;
+
+		// pseudo element transition is gonna come soon: https://bugs.webkit.org/show_bug.cgi?id=92591
+		-webkit-transition: 0.3s ease;
+		-moz-transition: 0.3s ease;
+		transition: 0.3s ease;
+	}
+
+	&:hover:before, &:hover:after {
+		visibility: visible;
+		opacity: 1;
+	}
+
+	/**
+	 * tooltip arrow
+	 */
+	&:before {
+		content: '';
+		position: absolute;
+		background: transparent;
+		border: $arrowBorderWidth solid transparent;
+		// move z-index 1 up than :after so that it shows over box-shadow
+		z-index: 1000001;
+	}
+
+	/**
+	 * tooltip body
+	 */
+	&:after {
+		content: attr(data-hint);
+		background: $defaultColor;
+		color: white;
+		text-shadow: 0 -1px 0px darken($defaultColor, $textShadowDarkenAmount);
+		padding: 8px 10px;
+		font-size: 12px;
+		line-height: 12px;
+		white-space: nowrap;
+		box-shadow: 4px 4px 8px rgba(0, 0, 0, 0.3);
+	}
+}

data/vendor/assets/stylesheets/hint/_mixins.scss

@@ -0,0 +1,21 @@
+// hint/_mixins.scss
+//
+// Place to store common mixins.
+
+
+// Generates border-color rules for all 4 positions
+@mixin arrow-border-color($color, $isInsideSelector: "true") {
+	@each $position in top, bottom, left, right {
+		// if the current mixin is called from within a selector, use a '&'. Otherwise not.
+		@if $isInsideSelector == "true" {
+			&.hint--#{$position}:before {
+				border-#{$position}-color: $color;
+			}
+		}
+		@else {
+			.hint--#{$position}:before {
+				border-#{$position}-color: $color;
+			}
+		}
+	}
+}

data/vendor/assets/stylesheets/hint/_position.scss

@@ -0,0 +1,93 @@
+/**
+ * source: hint/_position.scss
+ *
+ * Defines the positoning logic for the tooltips.
+ *
+ * Classes added:
+ * 	1) hint--top
+ * 	2) hint--bottom
+ * 	3) hint--left
+ * 	4) hint--right
+ */
+
+@mixin vertical-positioned-tooltip($propertyY, $transitionDirection) {
+	&:before {
+		// get the arrow out
+		margin-#{$propertyY}: -2 * $arrowBorderWidth;
+	}
+
+	&:after {
+		// bring back the tooltip by some offset so that arrow doesn't stick at end
+		margin-left: -1 * $arrowOffsetX;
+	}
+
+	&:before, &:after {
+		#{$propertyY}: 100%;
+		left: 50%;
+	}
+
+	&:hover:before, &:hover:after {
+		-webkit-transform: translateY($transitionDirection * $transitionDistance);
+		-moz-transform: translateY($transitionDirection * $transitionDistance);
+		transform: translateY($transitionDirection * $transitionDistance);
+	}
+}
+
+@mixin horizontal-positioned-tooltip($propertyX, $transitionDirection) {
+	&:before {
+		// get the arrow out
+		margin-#{$propertyX}: -2 * $arrowBorderWidth;
+		// bring back to center
+		margin-bottom: -1 * $arrowBorderWidth;
+	}
+
+	&:after {
+		// bring back to center
+		margin-bottom: -1 * floor($tooltipHeight / 2);
+	}
+
+	&:before, &:after {
+		#{$propertyX}: 100%;
+		bottom: 50%;
+	}
+
+	&:hover:before, &:hover:after {
+		-webkit-transform: translateX($transitionDirection * $transitionDistance);
+		-moz-transform: translateX($transitionDirection * $transitionDistance);
+		transform: translateX($transitionDirection * $transitionDistance);
+	}
+}
+
+
+/**
+ * set default color for tooltip arrows
+ */
+@include arrow-border-color($defaultColor, 'false');
+
+/**
+ * top tooltip
+ */
+.hint--top {
+	@include vertical-positioned-tooltip('bottom', -1);
+}
+
+/**
+ * bottom tooltip
+ */
+.hint--bottom {
+	@include vertical-positioned-tooltip('top', 1);
+}
+
+/**
+ * right tooltip
+ */
+.hint--right {
+	@include horizontal-positioned-tooltip('left', 1);
+}
+
+/**
+ * left tooltip
+ */
+.hint--left {
+	@include horizontal-positioned-tooltip('right', -1);
+}

data/vendor/assets/stylesheets/hint/_rounded.scss

@@ -0,0 +1,15 @@
+/**
+ * source: hint/_rounded.scss
+ *
+ * Defines rounded corner tooltips.
+ *
+ * Classes added:
+ * 	1) hint--rounded
+ *
+ */
+
+.hint--rounded {
+	&:after {
+		border-radius: 4px;
+	}
+}

data/vendor/assets/stylesheets/hint/_variables.scss

@@ -0,0 +1,36 @@
+// hint/_variables.scss
+//
+// Declares some variables used within the library.
+
+
+// default tooltip height
+$tooltipHeight: 28px !default;
+
+// border-width for tooltip arrow
+$arrowBorderWidth: 6px !default;
+
+// horizontal arrow offset
+$arrowOffsetX: 3 * $arrowBorderWidth !default;
+
+// text-shadow darken percentage
+$textShadowDarkenAmount: 25% !default;
+
+// transition distance
+$transitionDistance: 8px !default;
+
+
+// Various colors
+// Default color is blackish
+$defaultColor: hsl(0, 0%, 22%) !default;
+
+// Error color
+$errorColor: hsl(1, 40%, 50%) !default;
+
+// Warning color
+$warningColor: hsl(38, 46%, 54%) !default;
+
+// Info Color
+$infoColor: hsl(200, 50%, 45%) !default;
+
+// Success Color
+$successColor: hsl(121, 32%, 40%) !default;

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: hint
+version: !ruby/object:Gem::Version
+  version: 1.2.2
+platform: ruby
+authors:
+- Miroslav Kyurchev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-20 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'
+- !ruby/object:Gem::Dependency
+  name: compass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+- !ruby/object:Gem::Dependency
+  name: sass-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !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
+description: Hint.css is a tooltip library written in SASS which uses only HTML/CSS
+  to create simple tooltips.
+email:
+- mkyurchev@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- hint.gemspec
+- lib/hint.rb
+- lib/hint/engine.rb
+- lib/hint/version.rb
+- templates/project/manifest.rb
+- templates/project/screen.scss
+- vendor/assets/stylesheets/hint.scss
+- vendor/assets/stylesheets/hint/_always.scss
+- vendor/assets/stylesheets/hint/_color_types.scss
+- vendor/assets/stylesheets/hint/_core.scss
+- vendor/assets/stylesheets/hint/_mixins.scss
+- vendor/assets/stylesheets/hint/_position.scss
+- vendor/assets/stylesheets/hint/_rounded.scss
+- vendor/assets/stylesheets/hint/_variables.scss
+homepage: http://github.com/mkyurchev/hint
+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: A tooltip library in CSS ready to use with Rails or Compass.
+test_files: []