piecss 0.1.6.5.1 → 0.1.7

data/sass/piecss/utilities/_typography.scss

@@ -23,34 +23,34 @@
 // 1. FUNCTIONS
 
 
-/**
- * Extract the style property from a type array
- *
- * @since 0.1
- *
- * @todo parameter should either be a space separated list, or property map
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- *
- * @return {String} - font-type property
- */
+///
+/// Extract the style property from a type array
+///
+/// @since 0.1
+///
+/// @todo parameter should either be a space separated list, or property map
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
+/// @return {String} - font-type property
+///
 
 @function extract-type-style($type) {
     @return nth($type, 1);
 }
 
 
-/**
- * Extract the variant property from a type array
- *
- * @since 0.1
- *
- * @todo parameter should either be a space separated list, or property map
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- *
- * @return {String} - font-variant property
- */
+///
+/// Extract the variant property from a type array
+///
+/// @since 0.1
+///
+/// @todo parameter should either be a space separated list, or property map
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
+/// @return {String} - font-variant property
+///
 
 @function extract-type-variant($type)
 {
@@ -58,17 +58,17 @@
 }
 
 
-/**
- * Extract the weight property from a type array
- *
- * @since 0.1
- *
- * @todo parameter should either be a space separated list, or property map
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- *
- * @return {String} - font-weight property
- */
+///
+/// Extract the weight property from a type array
+///
+/// @since 0.1
+///
+/// @todo parameter should either be a space separated list, or property map
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
+/// @return {String} - font-weight property
+///
 
 @function extract-type-weight($type)
 {
@@ -76,17 +76,17 @@
 }
 
 
-/**
- * Extract the family property from a type array
- *
- * @since 0.1
- *
- * @todo parameter should either be a space separated list, or property map
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- *
- * @return {String} - font-family property
- */
+///
+/// Extract the family property from a type array
+///
+/// @since 0.1
+///
+/// @todo parameter should either be a space separated list, or property map
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
+/// @return {String} - font-family property
+///
 
 @function extract-type-family($type)
 {
@@ -94,10 +94,10 @@
 }
 
 
-/**
- * @alias to-unit
- * @deprecated
- */
+///
+/// @alias to-unit
+/// @deprecated
+///
 
 @function font-size($target-px, $unit: $unit, $context: $default-font-size)
 {
@@ -105,17 +105,17 @@
 }
 
 
-/**
- * Convert a px value to a new unit, within the context of it's containing element
- *
- * @since 0.1
- *
- * @param {Number} $target-px - the line-height in px
- * @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
- * @param {Number} $unit ($line-height-unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1% or 1 for unitless
- *
- * @return {Number} - line-height in px
- */
+///
+/// Convert a px value to a new unit, within the context of it's containing element
+///
+/// @since 0.1
+///
+/// @param {Number} $target-px - the line-height in px
+/// @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
+/// @param {Number} $unit ($line-height-unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1% or 1 for unitless
+///
+/// @return {Number} - line-height in px
+///
 
 @function line-height($target-px, $context: $default-font-size, $unit: $line-height-unit)
 {
@@ -128,17 +128,17 @@
 }
 
 
-/**
- * Returns the correct typographic weight corresponding to the weight number
- *
- * @since 0.1
- *
- * @throws Not a valid weight
- *
- * @param {Number} $weight (400) - a valid weight number: 100 | ... | 900
- *
- * @return {String} - weight, defaults to 'regular'
- */
+///
+/// Returns the correct typographic weight corresponding to the weight number
+///
+/// @since 0.1
+///
+/// @throws Not a valid weight
+///
+/// @param {Number} $weight (400) - a valid weight number: 100 | ... | 900
+///
+/// @return {String} - weight, defaults to 'regular'
+///
 
 @function weight-number-to-string($weight: regular)
 {
@@ -161,21 +161,18 @@
 // 2. MIXINS
 
 
-/**
- * Mixes in the shorthand font tag. This is the only mixin that takes the font-size and line-height in their final unit of output.
- * More info: [$default-font-size](./#variable-default-font-size), [$default-line-height](./#variable-default-line-height)
- *
- * @since 0.1
- *
- * @todo Accept properties in the same way as the default CSS font implementation
- * 
- * @param {List | Bool} $type - a valid type array ($style, $variant, $weight, $family) or false to only output font-size and line-height
- * @param {Number} $font-size ($default-font-size) - font-size in the final unit of output
- * @param {Number} $line-height ($default-line-height) - line-height in the final unit of output
- */
-
-
-   // font: font-style font-variant font-weight font-size/line-height font-family;
+///
+/// Mixes in the shorthand font tag. This is the only mixin that takes the font-size and line-height in their final unit of output.
+/// More info: [$default-font-size](./#variable-default-font-size), [$default-line-height](./#variable-default-line-height)
+///
+/// @since 0.1
+///
+/// @todo Accept properties in the same way as the default CSS font implementation
+/// 
+/// @param {List | Bool} $type - a valid type array ($style, $variant, $weight, $family) or false to only output font-size and line-height
+/// @param {Number} $font-size ($default-font-size) - font-size in the final unit of output
+/// @param {Number} $line-height ($default-line-height) - line-height in the final unit of output
+///
 
 @mixin font($arguments...)
 {
@@ -221,13 +218,13 @@
 }
 
 
-/**
- * Extracts the style from a type array and mixes in font-style
- *
- * @since 0.1
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- */
+///
+/// Extracts the style from a type array and mixes in font-style
+///
+/// @since 0.1
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
 
 @mixin font-style($type)
 {
@@ -235,13 +232,13 @@
 }
 
 
-/**
- * Extracts the variant from a type array and mixes in font-variant
- *
- * @since 0.1
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- */
+///
+/// Extracts the variant from a type array and mixes in font-variant
+///
+/// @since 0.1
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
 
 @mixin font-variant($type)
 {
@@ -249,13 +246,13 @@
 }
 
 
-/**
- * Extracts the weight from a type array and mixes in font-weight
- *
- * @since 0.1
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- */
+///
+/// Extracts the weight from a type array and mixes in font-weight
+///
+/// @since 0.1
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
 
 @mixin font-weight($type)
 {
@@ -263,13 +260,13 @@
 }
 
 
-/**
- * Extracts the family from a type array and mixes in font-family
- *
- * @since 0.1
- *
- * @param {List} $type: a valid type list ($style, $variant, $weight, $family)
- */
+///
+/// Extracts the family from a type array and mixes in font-family
+///
+/// @since 0.1
+///
+/// @param {List} $type: a valid type list ($style, $variant, $weight, $family)
+///
 
 @mixin font-family($type)
 {
@@ -277,15 +274,15 @@
 }
 
 
-/**
- * Takes a size in px and calculates it back to the final font-unit. Provides fallback if the final output is in rem.
- *
- * @since 0.1
- *
- * @param {Number} $target-px - The font-size in px
- * @param {Number} $unit ($unit) - The final unit to which $target-px is converted, e.g.px | rem | em | %
- * @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em or %
- */
+///
+/// Takes a size in px and calculates it back to the final font-unit. Provides fallback if the final output is in rem.
+///
+/// @since 0.1
+///
+/// @param {Number} $target-px - The font-size in px
+/// @param {Number} $unit ($unit) - The final unit to which $target-px is converted, e.g.px | rem | em | %
+/// @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em or %
+///
 
 @mixin font-size($target-px, $unit: $unit, $context: $default-font-size)
 {
@@ -295,15 +292,15 @@
     font-size: to-unit($target-px, $unit, $context);
 }
 
-/**
- * Mixin for line-height, automatically converts the value to a new unit, within the context of it's containing element
- *
- * @since 0.1
- *
- * @param {Number} $target-px - the line-height in px
- * @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
- * @param {Number} $unit ($line-height-unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1% or 1 for unitless
- */
+///
+/// Mixin for line-height, automatically converts the value to a new unit, within the context of it's containing element
+///
+/// @since 0.1
+///
+/// @param {Number} $target-px - the line-height in px
+/// @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
+/// @param {Number} $unit ($line-height-unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1% or 1 for unitless
+///
 
 @mixin line-height($target-px, $context: $default-font-size, $unit: $line-height-unit)
 {
@@ -311,4 +308,4 @@
         line-height: line-height($target-px, $context, $unit: $rem-fallback-unit);
     }    
     line-height: line-height($target-px, $context, $unit);
-}
+}

data/sass/piecss/utilities/_unit.scss

@@ -10,35 +10,37 @@
 
 // 1. FUNCTIONS
 
-/**
- * Accepts a value and returns it without a value.
- * @link http://hugogiraudel.com/2013/08/12/sass-functions/ Courtesy Hugo Giraudel
- *
- * @since 0.1
- *
- * @param {Number} $value - A value in any unit (px, rem, em, %, pt)
- *
- * @return {Number} - The value stripped of its unit
- */
+
+
+///
+/// Accepts a value and returns it without a value.
+/// @link http://hugogiraudel.com/2013/08/12/sass-functions/ Courtesy Hugo Giraudel
+///
+/// @since 0.1
+///
+/// @param {Number} $value - A value in any unit (px, rem, em, %, pt)
+///
+/// @return {Number} - The value stripped of its unit
+///
 
 @function strip-unit($value) {
     @return $value / ($value * 0 + 1);
 }
 
 
-/**
- * Convert a px value to a new unit, within the context of it's containing element
- *
- * @since 0.1
- *
- * @throws Argument $number needs to be a number.
- *
- * @param {Number} $target-px - The final size in px
- * @param {Number} $unit ($unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1%
- * @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
- *
- * @return {Number} - The value in the requested unit
- */
+///
+/// Convert a px value to a new unit, within the context of it's containing element
+///
+/// @since 0.1
+///
+/// @throws Argument $number needs to be a number.
+///
+/// @param {Number} $target-px - The final size in px
+/// @param {Number} $unit ($unit) - The final unit to which $target-px is converted, e.g. 1px, 1rem, 1em, 1%
+/// @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
+///
+/// @return {Number} - The value in the requested unit
+///
 
 @function to-unit($number, $unit: $unit, $context: $default-font-size) {
     @if not(type-of($number)==number) {
@@ -72,16 +74,16 @@
     @return $number;
 }
 
-/**
- * Convert any unit to a px value, within the context of it's containing element
- *
- * @since 0.1
- *
- * @param {Number} $value - The value to convert, in any unit
- * @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
- * 
- * @return {Number} - The value in px
- */
+///
+/// Convert any unit to a px value, within the context of it's containing element
+///
+/// @since 0.1
+///
+/// @param {Number} $value - The value to convert, in any unit
+/// @param {Number} $context ($default-font-size) - The context of the targeted element, for calculations to em
+/// 
+/// @return {Number} - The value in px
+///
 
 @function to-px($value, $context: $default-font-size) {
     @if unit($value)=='px' {
@@ -97,47 +99,47 @@
 
 }
 
-/**
- * Convert a value in rem to a px value
- *
- * @since 0.1
- *
- * @param {Number} $value - The value to convert
- * 
- * @return {Number} - The value in px
- */
+///
+/// Convert a value in rem to a px value
+///
+/// @since 0.1
+///
+/// @param {Number} $value - The value to convert
+/// 
+/// @return {Number} - The value in px
+///
 
 @function rem-to-px($value) {
     @return $default-font-size * strip-unit($value);
 }
 
-/**
- * Convert a value in em to a px value
- *
- * @since 0.1
- *
- * @param {Number} $value - The value to convert
- * @param {Number} $context ($default-font-size) - The context of the targeted element
- * 
- * @return {Number} - The value in px
- */
+///
+/// Convert a value in em to a px value
+///
+/// @since 0.1
+///
+/// @param {Number} $value - The value to convert
+/// @param {Number} $context ($default-font-size) - The context of the targeted element
+/// 
+/// @return {Number} - The value in px
+///
 
 @function em-to-px($value, $context: $default-font-size) {
     @return $context * strip-unit($value);
 }
 
-/**
- * Convert a value in em to a px value
- *
- * @since 0.1
- *
- * @todo Needs to take into account the context
- *
- * @param {Number} $value - The value to convert
- * @param {Number} $context ($default-font-size) - The context of the targeted element
- * 
- * @return {Number} - The value in px
- */
+///
+/// Convert a value in em to a px value
+///
+/// @since 0.1
+///
+/// @todo Needs to take into account the context
+///
+/// @param {Number} $value - The value to convert
+/// @param {Number} $context ($default-font-size) - The context of the targeted element
+/// 
+/// @return {Number} - The value in px
+///
 
 @function percentage-to-px($value, $context: $default-font-size) {
     @return $value/100% * $context;

data/templates/project/_sets/_button.scss

@@ -1,7 +1,7 @@
 /*
- * Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
- * Licensed under MIT; see LICENSE.txt
- */
+/// Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
+/// Licensed under MIT; see LICENSE.txt
+///
 
 $button-elements: add-properties(
     (
@@ -26,4 +26,4 @@ $button-elements: add-properties(
     ),
     #{$button-selector}--active,
     $button-elements
-);
+);

data/templates/project/_sets/_form.scss

@@ -1,7 +1,7 @@
 /*
- * Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
- * Licensed under MIT; see LICENSE.txt
- */
+/// Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
+/// Licensed under MIT; see LICENSE.txt
+///
 
 // $form-form-selector: "%form" !default;
 // $form-fieldset-selector: "%fieldset" !default;
@@ -112,4 +112,4 @@ $form-elements: add-properties(
     ),
     #{$form-textarea-selector}--large,
     $form-elements
-);
+);

data/templates/project/_sets.scss

@@ -1,7 +1,7 @@
 /*
- * Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
- * Licensed under MIT; see LICENSE.txt
- */
+/// Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
+/// Licensed under MIT; see LICENSE.txt
+///
 
 @import "elements/form";
-@import "elements/button";
+@import "elements/button";

data/templates/project/_settings.scss

@@ -1,7 +1,7 @@
 /*
- * Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
- * Licensed under MIT; see LICENSE.txt
- */
+/// Copyright (C) 2014 Crossing Hippos - Babs Gösgens. All rights reserved.
+/// Licensed under MIT; see LICENSE.txt
+///
 
 // Example configuration for columns
 $column-widths: (
@@ -26,4 +26,4 @@ $layouts: (
         color: $becca,
         pages: (),
     )
-);
+);

data/templates/project/screen.scss

@@ -105,4 +105,4 @@ $debug-rhythm: false;
 @import "piecss/behavior/grid";
 @import "piecss/behavior/form";
 @import "piecss/behavior/list";
-*/
+*/

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: piecss
 version: !ruby/object:Gem::Version
-  version: 0.1.6.5.1
+  version: 0.1.7
 platform: ruby
 authors:
 - Babs Gosgens
@@ -14,28 +14,28 @@ dependencies:
   name: sass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '3.3'
 - !ruby/object:Gem::Dependency
   name: compass
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
 description: Piecss produces little to none output. The only default output that Piecss
@@ -104,9 +104,9 @@ files:
 - sass/piecss/utilities/_side.scss
 - sass/piecss/utilities/_typography.scss
 - sass/piecss/utilities/_unit.scss
-- templates/project/_sets.scss
 - templates/project/_sets/_button.scss
 - templates/project/_sets/_form.scss
+- templates/project/_sets.scss
 - templates/project/_settings.scss
 - templates/project/examples.html
 - templates/project/manifest.rb
@@ -121,17 +121,17 @@ 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.4.1
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: A collection of tools for building responsive websites.