Support for @mixin, @include and @extend

pkg/csslib/lib/src/tree.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of csslib.visitor;
 
 /////////////////////////////////////////////////////////////////////////
 // CSS specific types:
 /////////////////////////////////////////////////////////////////////////
 
@@ skipping 248 matching lines @@
 // :NOT(negation_arg)
 class NegationSelector extends SimpleSelector {
   SimpleSelector negationArg;
 
   NegationSelector(this.negationArg, Span span)
       : super(new Negation(span), span);
 
   visit(VisitorBase visitor) => visitor.visitNegationSelector(this);
 }
 
+class NoOp extends TreeNode {
+  NoOp() : super(null);
+
+  visit(VisitorBase visitor) => visitor.visitNoOp(this);
+}
+
 class StyleSheet extends TreeNode {
   /**
    * Contains charset, ruleset, directives (media, page, etc.), and selectors.
    */
   final topLevels;
 
   StyleSheet(this.topLevels, Span span) : super(span) {
     for (final node in topLevels) {
       assert(node is TopLevelProduction || node is Directive);
     }
@@ skipping 208 matching lines @@
 
 /** To support Less syntax @name: expression */
 class VarDefinitionDirective extends Directive {
   final VarDefinition def;
 
   VarDefinitionDirective(this.def, Span span) : super(span);
 
   visit(VisitorBase visitor) => visitor.visitVarDefinitionDirective(this);
 }
 
+class MixinDefinition extends Directive {
+  final String name;
+  final List definedArgs;
+  final bool varArgs;

[nweiz, 2013/09/18 22:40:54]

As with @content, don't include infrastructure for features that aren't
supported. You can add these once you actually support arguments.

[terry, 2013/10/09 03:40:33]

args supported.
On 2013/09/18 22:40:54, nweiz wrote:

+
+  MixinDefinition(this.name, this.definedArgs, this.varArgs, Span span)
+      : super(span);
+
+  visit(VisitorBase visitor) => visitor.visitMixinDefinition(this);
+}
+
+/** To support defining a SASS @mixin. */

[nweiz, 2013/09/18 22:40:54]

Only the first letter of "Sass" is capitalized.

These documentation comments are way too short. If I'm reading this as someone
who doesn't know what a mixin is, I'm completely befuddled. Actually explain
what a mixin is. Use complete sentences. If you have multiple classes for
similar things -- IncludeDirective vs IncludeMixinAtDeclaration, for example --
explain the difference.

[terry, 2013/10/09 03:40:33]

Ok, referenced web site no need to explain the Sass world again.
On 2013/09/18 22:40:54, nweiz wrote:

+class MixinRulesetDirective extends MixinDefinition {
+  final List<RuleSet> rulesets;
+
+  MixinRulesetDirective(String name, List args, bool varArgs, this.rulesets,
+      Span span) : super(name, args, varArgs, span);
+
+  visit(VisitorBase visitor) => visitor.visitMixinRulesetDirective(this);
+}
+
+class MixinDeclarationDirective extends MixinDefinition {
+  final DeclarationGroup declarations;
+
+  MixinDeclarationDirective(String name, List args, bool varArgs,
+      this.declarations, Span span) : super(name, args, varArgs, span);
+
+  visit(VisitorBase visitor) => visitor.visitMixinDeclarationDirective(this);
+}
+
+/** To support consuming a SASS mixin @include. */
+class IncludeDirective extends Directive {
+  final String name;
+  final List args;
+
+  IncludeDirective(this.name, this.args, Span span) : super(span);
+
+  visit(VisitorBase visitor) => visitor.visitIncludeDirective(this);
+}
+
+/** To support SASS @content. */
+class ContentDirective extends Directive {
+  ContentDirective(Span span) : super(span);
+
+  visit(VisitorBase visitor) => visitor.visitContentDirective(this);
+}
+
 class Declaration extends TreeNode {
   final Identifier _property;
   final Expression _expression;
   /** Style exposed to Dart. */
   var _dart;
   final bool important;
 
   /**
    * IE CSS hacks that can only be read by a particular IE version.
    *   7 implies IE 7 or older property (e.g., *background: blue;)
@@ skipping 30 matching lines @@
   VarDefinition(Identifier definedName, Expression expr, Span span)
       : super(definedName, expr, null, span);
 
   String get definedName => _property.name;
 
   set dartStyle(dStyle) { }
 
   visit(VisitorBase visitor) => visitor.visitVarDefinition(this);
 }
 
+/**
+ * Node for usage of @include mixin[(args,...)] found in a declaration group
+ * instead of at a ruleset (toplevel) e.g.,
+ * div {
+ *   @include mixin1;
+ * }
+ */
+class IncludeMixinAtDeclaration extends Declaration {
+  final IncludeDirective include;
+
+  IncludeMixinAtDeclaration(this.include, Span span)
+      : super(null, null, null, span);
+
+  visit(VisitorBase visitor) => visitor.visitIncludeMixinAtDeclaration(this);
+}
+
 class DeclarationGroup extends TreeNode {
   /** Can be either Declaration or RuleSet (if nested selector). */
   final List _declarations;
 
   DeclarationGroup(this._declarations, Span span) : super(span);
 
   List get declarations => _declarations;
 
   visit(VisitorBase visitor) => visitor.visitDeclarationGroup(this);
 }
@@ skipping 488 matching lines @@
   factory PaddingExpression.merge(PaddingExpression x, PaddingExpression y) {
     return new PaddingExpression._merge(x, y, y.span);
   }
 
   PaddingExpression._merge(PaddingExpression x, PaddingExpression y, Span span)
       : super(DartStyleExpression.paddingStyle, span,
             new BoxEdge.merge(x.box, y.box));
 
   visit(VisitorBase visitor) => visitor.visitPaddingExpression(this);
 }