stylus-source 0.15.4 → 0.17.0

data/vendor/docs/selectors.md

@@ -0,0 +1,131 @@
+## Selectors
+
+### Indentation
+
+Stylus is "pythonic" aka indentation-based. Whitespace is significant, so we substitute { and } with an _indent_, and an _outdent_ as shown below:
+
+    body
+      color white
+
+which compiles to:
+
+    body {
+      color: #fff;
+    }
+
+Optionally if preferred we may utilize colons to separate properties and their values:
+
+    body
+      color: white
+
+### Rule Sets
+
+Stylus, just like css allows you to define properties for several selectors at once through comma separation.
+
+    textarea, input
+      border 1px solid #eee
+
+The same can be done with a newline:
+
+    textarea
+    input
+      border 1px solid #eee
+
+both compiling to:
+
+    textarea,
+    input {
+      border: 1px solid #eee;
+    }
+
+The one exception to this rule, are selectors that look like properties, for example `foo bar baz` in the following may be a property, or a selector:
+
+    foo bar baz
+    > input
+      border 1px solid
+
+so for this reason, or if simply preferred we may trail with a comma:
+
+    foo bar baz,
+    form input,
+    > a
+      border 1px solid
+
+### Parent Reference
+
+The `&` character references the parent selector(s). In the example below our two selectors `textarea`, and `input` both alter the `color` on the `:hover` pseudo selector. 
+
+    textarea
+    input
+      color #A7A7A7
+      &:hover
+        color #000
+
+compiles to:
+
+    textarea,
+    input {
+      color: #a7a7a7;
+    }
+    textarea:hover,
+    input:hover {
+      color: #000;
+    }
+
+below is an example providing a simple `2px` border for internet exploder utilizing the parent reference within a mixin:
+
+      box-shadow()
+        -webkit-box-shadow arguments
+        -moz-box-shadow arguments
+        box-shadow arguments
+        html.ie8 &,
+        html.ie7 &,
+        html.ie6 &
+          border 2px solid arguments[length(arguments) - 1]
+
+      body
+        #login
+          box-shadow 1px 1px 3px #eee
+
+yielding:
+
+      body #login {
+        -webkit-box-shadow: 1px 1px 3px #eee;
+        -moz-box-shadow: 1px 1px 3px #eee;
+        box-shadow: 1px 1px 3px #eee;
+      }
+      html.ie8 body #login,
+      html.ie7 body #login,
+      html.ie6 body #login {
+        border: 2px solid #eee;
+      }
+
+### Disambiguation
+
+Expressions such as `padding - n` could be interpreted both as a subtraction operation, as well as a property with an unary minus. To disambiguate we can wrap the expression with parens:
+
+    pad(n)
+      padding (- n)
+
+    body
+      pad(5px)
+
+compiles to:
+
+    body {
+      padding: -5px;
+    }
+
+however this is only true in functions, since functions act both as mixins, or calls with return values. For example this is fine, and will yield the same results as above:
+
+    body
+      padding -5px
+
+Have weird property values that Stylus cannot process? `unquote()` can help you out:
+
+    filter unquote('progid:DXImageTransform.Microsoft.BasicImage(rotation=1)')
+
+yields:
+
+    filter progid:DXImageTransform.Microsoft.BasicImage(rotation=1)
+    

data/vendor/docs/textmate.md

@@ -0,0 +1,4 @@
+
+## TextMate Bundle
+
+ Stylus ships with a TextMate bundle, located within `./editors`. To install simply execute `make install-bundle`, or place `./editors/Stylus.tmbundle` in the appropriate location.

data/vendor/docs/vargs.md

@@ -0,0 +1,84 @@
+
+## Rest Parameters
+
+ Stylus supports rest parameters in the form of `name...`. These params consume the remaining arguments passed to a mixin or function. This is useful for example when utilizing the implicit function call support to apply vendor prefixes like `-webkit` or `-moz`.
+ 
+
+In the example below we consume all the arguments passed and simply apply them to multiple properties.
+
+     box-shadow(args...)
+       -webkit-box-shadow args
+       -moz-box-shadow args
+       box-shadow args
+
+     #login
+       box-shadow 1px 2px 5px #eee
+
+yielding:
+
+      #login {
+        -webkit-box-shadow: 1px 2px 5px #eee;
+        -moz-box-shadow: 1px 2px 5px #eee;
+        box-shadow: 1px 2px 5px #eee;
+      }
+
+If we wanted to peek at a specific argument, for example the x-offset we could simply use `args[0]`, or for example we may wish to re-define the mixin:
+
+        box-shadow(offset-x, args...)
+          got-offset-x offset-x
+          -webkit-box-shadow offset-x args
+          -moz-box-shadow offset-x args
+          box-shadow offset-x args
+
+        #login
+          box-shadow 1px 2px 5px #eee
+
+yielding:
+
+        #login {
+          got-offset-x: 1px;
+          -webkit-box-shadow: 1px 2px 5px #eee;
+          -moz-box-shadow: 1px 2px 5px #eee;
+          box-shadow: 1px 2px 5px #eee;
+        }
+
+### arguments
+
+  The `arguments` variable is injected into mixin and function bodies, containing the exact expression passed. This is useful for several reasons, primarily for vendor support, as you get the _exact_ expression, commas and all.
+
+  For example, if we use a rest param, the comma is simply consumed since it is an expression delimiter:
+  
+      box-shadow(args...)
+        -webkit-box-shadow args
+        -moz-box-shadow args
+        box-shadow args
+
+      #login
+        box-shadow #ddd 1px 1px, #eee 2px 2px 
+
+yielding slightly unexpected results:
+
+      #login {
+        -webkit-box-shadow: #ddd 1px 1px #eee 2px 2px;
+        -moz-box-shadow: #ddd 1px 1px #eee 2px 2px;
+        box-shadow: #ddd 1px 1px #eee 2px 2px;
+      }
+
+Let's redefine the mixin using `arguments`:
+
+      box-shadow()
+        -webkit-box-shadow arguments
+        -moz-box-shadow arguments
+        box-shadow arguments
+
+      body
+        box-shadow #ddd 1px 1px, #eee 2px 2px
+
+now yielding the desired result:
+
+      body {
+        -webkit-box-shadow: #ddd 1px 1px, #eee 2px 2px;
+        -moz-box-shadow: #ddd 1px 1px, #eee 2px 2px;
+        box-shadow: #ddd 1px 1px, #eee 2px 2px;
+      }
+

data/vendor/docs/variables.md

@@ -0,0 +1,78 @@
+
+## Variables
+
+We may assign expressions to variables and use them throughout our stylesheet:
+
+     font-size = 14px
+
+     body
+       font font-size Arial, sans-serif
+
+compiles to:
+
+     body {
+       font: 14px Arial, sans-serif;
+     }
+
+Variables can even consist of an expression list:
+
+    font-size = 14px
+    font = font-size "Lucida Grande", Arial
+
+    body
+      font font sans-serif
+
+compiles to:
+
+    body {
+      font: 14px "Lucida Grande", Arial sans-serif;
+    }
+
+identifiers (variable names, functions, etc) may also include the `$` character, for example:
+
+    $font-size = 14px
+    body {
+      font: $font sans-serif;
+    }
+
+## Property Access
+
+ Another cool feature unique to Stylus is the ability to reference
+ properties defined in the current block (or target mixin) _without_ assigning their
+ values to variables. A great example of this is the logic required
+ for vertically and horizontally center an element, which is typically
+ done by using percentages and negative margins as shown:
+
+     #logo
+       position: absolute
+       top: 50%
+       left: 50%
+       width: w = 150px
+       height: h = 80px
+       margin-left: -(w / 2)
+       margin-top: -(h / 2)
+
+  Instead of assigning the variables `w` and `h` we can simply prepend the `@`
+  character to the property name to access the value:
+
+     #logo
+       position: absolute
+       top: 50%
+       left: 50%
+       width: 150px
+       height: 80px
+       margin-left: -(@width / 2)
+       margin-top: -(@height / 2)
+
+  Another extremely useful use-case is conditionally defining properties based on the existence of others within mixins. In the following example we apply a default `z-index` of `1`, but _only_ if `z-index` was not previously specified.
+
+      position()
+        position: arguments
+        z-index: 1 unless @z-index
+
+      #logo
+        z-index: 20
+        position: absolute
+
+      #logo2
+        position: absolute

data/vendor/editors/Stylus.tmbundle/Commands/Compile and Display CSS.tmCommand

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>beforeRunningCommand</key>
+	<string>nop</string>
+	<key>command</key>
+	<string>#!/bin/bash
+
+function highlight {
+  test `which pygmentize`
+  if [[ $? -eq 0 ]]; then
+    pygmentize -Onoclasses,nobackground=True -l css -f html
+  else
+    pre
+  fi
+}
+
+${TM_STYLUS:=stylus} | highlight</string>
+	<key>input</key>
+	<string>selection</string>
+	<key>keyEquivalent</key>
+	<string>@b</string>
+	<key>name</key>
+	<string>Compile and Display CSS</string>
+	<key>output</key>
+	<string>showAsHTML</string>
+	<key>scope</key>
+	<string>source.stylus</string>
+	<key>uuid</key>
+	<string>DD8F8C2B-2B83-4734-82EE-8508EE344638</string>
+</dict>
+</plist>

data/vendor/editors/Stylus.tmbundle/Preferences/Comments.tmPreferences

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>name</key>
+	<string>Comments</string>
+	<key>scope</key>
+	<string>source.stylus</string>
+	<key>settings</key>
+	<dict>
+		<key>shellVariables</key>
+		<array>
+			<dict>
+				<key>name</key>
+				<string>TM_COMMENT_START</string>
+				<key>value</key>
+				<string>// </string>
+			</dict>
+			<dict>
+				<key>name</key>
+				<string>TM_COMMENT_START_2</string>
+				<key>value</key>
+				<string>/*</string>
+			</dict>
+			<dict>
+				<key>name</key>
+				<string>TM_COMMENT_END_2</string>
+				<key>value</key>
+				<string>*/</string>
+			</dict>
+		</array>
+	</dict>
+	<key>uuid</key>
+	<string>7EC85265-178C-4ECC-AAE2-4EEF4AFF8872</string>
+</dict>
+</plist>

data/vendor/editors/Stylus.tmbundle/Syntaxes/Stylus.tmLanguage

@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>fileTypes</key>
+	<array>
+		<string>styl</string>
+		<string>stylus</string>
+	</array>
+	<key>name</key>
+	<string>Stylus</string>
+	<key>patterns</key>
+	<array>
+		<dict>
+			<key>match</key>
+			<string>^ *(&amp;|)</string>
+			<key>name</key>
+			<string>variable.language.stylus</string>
+		</dict>
+		<dict>
+			<key>match</key>
+			<string>(arguments)</string>
+			<key>name</key>
+			<string>variable.language.stylus</string>
+		</dict>
+		<dict>
+			<key>match</key>
+			<string>@([-\w]+)</string>
+			<key>name</key>
+			<string>keyword.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.entity.stylus</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>(\.)[a-zA-Z0-9_-]+</string>
+			<key>name</key>
+			<string>entity.other.attribute-name.class.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.entity.stylus</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>(:+)\b(after|before|first-child|first-letter|first-line|selection)\b</string>
+			<key>name</key>
+			<string>entity.other.attribute-name.pseudo-element.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.entity.stylus</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>(:)\b(active|hover|link|visited|focus)\b</string>
+			<key>name</key>
+			<string>entity.other.attribute-name.pseudo-class.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.entity.css</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>(#)[a-zA-Z][a-zA-Z0-9_-]*</string>
+			<key>name</key>
+			<string>entity.other.attribute-name.id.stylus</string>
+		</dict>
+		<dict>
+			<key>match</key>
+			<string>\b(!important|for|in|return|true|false|null|if|else|unless|return)\b</string>
+			<key>name</key>
+			<string>keyword.control.stylus</string>
+		</dict>
+		<dict>
+			<key>begin</key>
+			<string>"</string>
+			<key>end</key>
+			<string>"</string>
+			<key>name</key>
+			<string>string.quoted.double.stylus</string>
+		</dict>
+		<dict>
+			<key>begin</key>
+			<string>'</string>
+			<key>end</key>
+			<string>'</string>
+			<key>name</key>
+			<string>string.quoted.single.stylus</string>
+		</dict>
+		<dict>
+			<key>begin</key>
+			<string>/\*</string>
+			<key>captures</key>
+			<dict>
+				<key>0</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.comment.js</string>
+				</dict>
+			</dict>
+			<key>end</key>
+			<string>\*/</string>
+			<key>name</key>
+			<string>comment.block.js</string>
+		</dict>
+		<dict>
+			<key>match</key>
+			<string>(?:\b(\d+))|(#[a-fA-F0-9]+)</string>
+			<key>name</key>
+			<string>constant.numeric.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>punctuation.definition.comment.stylus</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>(?:^[ \t]+)?(\/\/).*$\n?</string>
+			<key>name</key>
+			<string>comment.line.stylus</string>
+		</dict>
+		<dict>
+			<key>captures</key>
+			<dict>
+				<key>1</key>
+				<dict>
+					<key>name</key>
+					<string>entity.name.function.stylus</string>
+				</dict>
+			</dict>
+			<key>match</key>
+			<string>([-a-zA-Z_][-\w]*)?(\()</string>
+			<key>name</key>
+			<string>meta.function.stylus</string>
+		</dict>
+	</array>
+	<key>scopeName</key>
+	<string>source.stylus</string>
+	<key>uuid</key>
+	<string>60519324-6A3A-4382-9E0B-546993A3869A</string>
+</dict>
+</plist>

data/vendor/editors/Stylus.tmbundle/info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>name</key>
+	<string>Stylus</string>
+	<key>uuid</key>
+	<string>DD7889E4-2ACA-4DF5-838F-FC9D7AEAF3F1</string>
+</dict>
+</plist>