// sass.hpp must go before all system headers to get the // __EXTENSIONS__ fix on Solaris. #include "sass.hpp" #include #include #include #include #include #include #include "ast.hpp" #include "inspect.hpp" #include "context.hpp" #include "listize.hpp" #include "color_maps.hpp" #include "utf8/checked.h" namespace Sass { Inspect::Inspect(const Emitter& emi) : Emitter(emi) { } Inspect::~Inspect() { } // statements void Inspect::operator()(Block* block) { if (!block->is_root()) { add_open_mapping(block); append_scope_opener(); } if (output_style() == NESTED) indentation += block->tabs(); for (size_t i = 0, L = block->length(); i < L; ++i) { (*block)[i]->perform(this); } if (output_style() == NESTED) indentation -= block->tabs(); if (!block->is_root()) { append_scope_closer(); add_close_mapping(block); } } void Inspect::operator()(Ruleset* ruleset) { if (ruleset->selector()) { ruleset->selector()->perform(this); } if (ruleset->block()) { ruleset->block()->perform(this); } } void Inspect::operator()(Keyframe_Rule* rule) { if (rule->name()) rule->name()->perform(this); if (rule->block()) rule->block()->perform(this); } void Inspect::operator()(Bubble* bubble) { append_indentation(); append_token("::BUBBLE", bubble); append_scope_opener(); bubble->node()->perform(this); append_scope_closer(); } void Inspect::operator()(MediaRule* rule) { append_indentation(); append_token("@media", rule); append_mandatory_space(); if (rule->block()) { rule->block()->perform(this); } } void Inspect::operator()(CssMediaRule* rule) { if (output_style() == NESTED) indentation += rule->tabs(); append_indentation(); append_token("@media", rule); append_mandatory_space(); in_media_block = true; bool joinIt = false; for (auto query : rule->elements()) { if (joinIt) { append_comma_separator(); append_optional_space(); } operator()(query); joinIt = true; } if (rule->block()) { rule->block()->perform(this); } in_media_block = false; if (output_style() == NESTED) indentation -= rule->tabs(); } void Inspect::operator()(CssMediaQuery* query) { bool joinIt = false; if (!query->modifier().empty()) { append_string(query->modifier()); append_mandatory_space(); } if (!query->type().empty()) { append_string(query->type()); joinIt = true; } for (auto feature : query->features()) { if (joinIt) { append_mandatory_space(); append_string("and"); append_mandatory_space(); } append_string(feature); joinIt = true; } } void Inspect::operator()(Supports_Block* feature_block) { append_indentation(); append_token("@supports", feature_block); append_mandatory_space(); feature_block->condition()->perform(this); feature_block->block()->perform(this); } void Inspect::operator()(At_Root_Block* at_root_block) { append_indentation(); append_token("@at-root ", at_root_block); append_mandatory_space(); if(at_root_block->expression()) at_root_block->expression()->perform(this); if(at_root_block->block()) at_root_block->block()->perform(this); } void Inspect::operator()(Directive* at_rule) { append_indentation(); append_token(at_rule->keyword(), at_rule); if (at_rule->selector()) { append_mandatory_space(); bool was_wrapped = in_wrapped; in_wrapped = true; at_rule->selector()->perform(this); in_wrapped = was_wrapped; } if (at_rule->value()) { append_mandatory_space(); at_rule->value()->perform(this); } if (at_rule->block()) { at_rule->block()->perform(this); } else { append_delimiter(); } } void Inspect::operator()(Declaration* dec) { if (dec->value()->concrete_type() == Expression::NULL_VAL) return; bool was_decl = in_declaration; in_declaration = true; LOCAL_FLAG(in_custom_property, dec->is_custom_property()); if (output_style() == NESTED) indentation += dec->tabs(); append_indentation(); if (dec->property()) dec->property()->perform(this); append_colon_separator(); if (dec->value()->concrete_type() == Expression::SELECTOR) { Expression_Obj ls = Listize::perform(dec->value()); ls->perform(this); } else { dec->value()->perform(this); } if (dec->is_important()) { append_optional_space(); append_string("!important"); } append_delimiter(); if (output_style() == NESTED) indentation -= dec->tabs(); in_declaration = was_decl; } void Inspect::operator()(Assignment* assn) { append_token(assn->variable(), assn); append_colon_separator(); assn->value()->perform(this); if (assn->is_default()) { append_optional_space(); append_string("!default"); } append_delimiter(); } void Inspect::operator()(Import* import) { if (!import->urls().empty()) { append_token("@import", import); append_mandatory_space(); import->urls().front()->perform(this); if (import->urls().size() == 1) { if (import->import_queries()) { append_mandatory_space(); import->import_queries()->perform(this); } } append_delimiter(); for (size_t i = 1, S = import->urls().size(); i < S; ++i) { append_mandatory_linefeed(); append_token("@import", import); append_mandatory_space(); import->urls()[i]->perform(this); if (import->urls().size() - 1 == i) { if (import->import_queries()) { append_mandatory_space(); import->import_queries()->perform(this); } } append_delimiter(); } } } void Inspect::operator()(Import_Stub* import) { append_indentation(); append_token("@import", import); append_mandatory_space(); append_string(import->imp_path()); append_delimiter(); } void Inspect::operator()(Warning* warning) { append_indentation(); append_token("@warn", warning); append_mandatory_space(); warning->message()->perform(this); append_delimiter(); } void Inspect::operator()(Error* error) { append_indentation(); append_token("@error", error); append_mandatory_space(); error->message()->perform(this); append_delimiter(); } void Inspect::operator()(Debug* debug) { append_indentation(); append_token("@debug", debug); append_mandatory_space(); debug->value()->perform(this); append_delimiter(); } void Inspect::operator()(Comment* comment) { in_comment = true; comment->text()->perform(this); in_comment = false; } void Inspect::operator()(If* cond) { append_indentation(); append_token("@if", cond); append_mandatory_space(); cond->predicate()->perform(this); cond->block()->perform(this); if (cond->alternative()) { append_optional_linefeed(); append_indentation(); append_string("else"); cond->alternative()->perform(this); } } void Inspect::operator()(For* loop) { append_indentation(); append_token("@for", loop); append_mandatory_space(); append_string(loop->variable()); append_string(" from "); loop->lower_bound()->perform(this); append_string(loop->is_inclusive() ? " through " : " to "); loop->upper_bound()->perform(this); loop->block()->perform(this); } void Inspect::operator()(Each* loop) { append_indentation(); append_token("@each", loop); append_mandatory_space(); append_string(loop->variables()[0]); for (size_t i = 1, L = loop->variables().size(); i < L; ++i) { append_comma_separator(); append_string(loop->variables()[i]); } append_string(" in "); loop->list()->perform(this); loop->block()->perform(this); } void Inspect::operator()(While* loop) { append_indentation(); append_token("@while", loop); append_mandatory_space(); loop->predicate()->perform(this); loop->block()->perform(this); } void Inspect::operator()(Return* ret) { append_indentation(); append_token("@return", ret); append_mandatory_space(); ret->value()->perform(this); append_delimiter(); } void Inspect::operator()(ExtendRule* extend) { append_indentation(); append_token("@extend", extend); append_mandatory_space(); extend->selector()->perform(this); append_delimiter(); } void Inspect::operator()(Definition* def) { append_indentation(); if (def->type() == Definition::MIXIN) { append_token("@mixin", def); append_mandatory_space(); } else { append_token("@function", def); append_mandatory_space(); } append_string(def->name()); def->parameters()->perform(this); def->block()->perform(this); } void Inspect::operator()(Mixin_Call* call) { append_indentation(); append_token("@include", call); append_mandatory_space(); append_string(call->name()); if (call->arguments()) { call->arguments()->perform(this); } if (call->block()) { append_optional_space(); call->block()->perform(this); } if (!call->block()) append_delimiter(); } void Inspect::operator()(Content* content) { append_indentation(); append_token("@content", content); append_delimiter(); } void Inspect::operator()(Map* map) { if (output_style() == TO_SASS && map->empty()) { append_string("()"); return; } if (map->empty()) return; if (map->is_invisible()) return; bool items_output = false; append_string("("); for (auto key : map->keys()) { if (items_output) append_comma_separator(); key->perform(this); append_colon_separator(); LOCAL_FLAG(in_space_array, true); LOCAL_FLAG(in_comma_array, true); map->at(key)->perform(this); items_output = true; } append_string(")"); } std::string Inspect::lbracket(List* list) { return list->is_bracketed() ? "[" : "("; } std::string Inspect::rbracket(List* list) { return list->is_bracketed() ? "]" : ")"; } void Inspect::operator()(List* list) { if (list->empty() && (output_style() == TO_SASS || list->is_bracketed())) { append_string(lbracket(list)); append_string(rbracket(list)); return; } std::string sep(list->separator() == SASS_SPACE ? " " : ","); if ((output_style() != COMPRESSED) && sep == ",") sep += " "; else if (in_media_block && sep != " ") sep += " "; // verified if (list->empty()) return; bool items_output = false; bool was_space_array = in_space_array; bool was_comma_array = in_comma_array; // if the list is bracketed, always include the left bracket if (list->is_bracketed()) { append_string(lbracket(list)); } // probably ruby sass eqivalent of element_needs_parens else if (output_style() == TO_SASS && list->length() == 1 && !list->from_selector() && !Cast(list->at(0)) && !Cast(list->at(0)) ) { append_string(lbracket(list)); } else if (!in_declaration && (list->separator() == SASS_HASH || (list->separator() == SASS_SPACE && in_space_array) || (list->separator() == SASS_COMMA && in_comma_array) )) { append_string(lbracket(list)); } if (list->separator() == SASS_SPACE) in_space_array = true; else if (list->separator() == SASS_COMMA) in_comma_array = true; for (size_t i = 0, L = list->size(); i < L; ++i) { if (list->separator() == SASS_HASH) { sep[0] = i % 2 ? ':' : ','; } Expression_Obj list_item = list->at(i); if (output_style() != TO_SASS) { if (list_item->is_invisible()) { // this fixes an issue with "" in a list if (!Cast(list_item)) { continue; } } } if (items_output) { append_string(sep); } if (items_output && sep != " ") append_optional_space(); list_item->perform(this); items_output = true; } in_comma_array = was_comma_array; in_space_array = was_space_array; // if the list is bracketed, always include the right bracket if (list->is_bracketed()) { if (list->separator() == SASS_COMMA && list->size() == 1) { append_string(","); } append_string(rbracket(list)); } // probably ruby sass eqivalent of element_needs_parens else if (output_style() == TO_SASS && list->length() == 1 && !list->from_selector() && !Cast(list->at(0)) && !Cast(list->at(0)) ) { append_string(","); append_string(rbracket(list)); } else if (!in_declaration && (list->separator() == SASS_HASH || (list->separator() == SASS_SPACE && in_space_array) || (list->separator() == SASS_COMMA && in_comma_array) )) { append_string(rbracket(list)); } } void Inspect::operator()(Binary_Expression* expr) { expr->left()->perform(this); if ( in_media_block || (output_style() == INSPECT) || ( expr->op().ws_before && (!expr->is_interpolant()) && (expr->is_left_interpolant() || expr->is_right_interpolant()) )) append_string(" "); switch (expr->optype()) { case Sass_OP::AND: append_string("&&"); break; case Sass_OP::OR: append_string("||"); break; case Sass_OP::EQ: append_string("=="); break; case Sass_OP::NEQ: append_string("!="); break; case Sass_OP::GT: append_string(">"); break; case Sass_OP::GTE: append_string(">="); break; case Sass_OP::LT: append_string("<"); break; case Sass_OP::LTE: append_string("<="); break; case Sass_OP::ADD: append_string("+"); break; case Sass_OP::SUB: append_string("-"); break; case Sass_OP::MUL: append_string("*"); break; case Sass_OP::DIV: append_string("/"); break; case Sass_OP::MOD: append_string("%"); break; default: break; // shouldn't get here } if ( in_media_block || (output_style() == INSPECT) || ( expr->op().ws_after && (!expr->is_interpolant()) && (expr->is_left_interpolant() || expr->is_right_interpolant()) )) append_string(" "); expr->right()->perform(this); } void Inspect::operator()(Unary_Expression* expr) { if (expr->optype() == Unary_Expression::PLUS) append_string("+"); else if (expr->optype() == Unary_Expression::SLASH) append_string("/"); else append_string("-"); expr->operand()->perform(this); } void Inspect::operator()(Function_Call* call) { append_token(call->name(), call); call->arguments()->perform(this); } void Inspect::operator()(Variable* var) { append_token(var->name(), var); } void Inspect::operator()(Number* n) { // reduce units n->reduce(); std::stringstream ss; ss.precision(opt.precision); ss << std::fixed << n->value(); std::string res = ss.str(); size_t s = res.length(); // delete trailing zeros for(s = s - 1; s > 0; --s) { if(res[s] == '0') { res.erase(s, 1); } else break; } // delete trailing decimal separator if(res[s] == '.') res.erase(s, 1); // some final cosmetics if (res == "0.0") res = "0"; else if (res == "") res = "0"; else if (res == "-0") res = "0"; else if (res == "-0.0") res = "0"; else if (opt.output_style == COMPRESSED) { if (n->zero()) { // check if handling negative nr size_t off = res[0] == '-' ? 1 : 0; // remove leading zero from floating point in compressed mode if (res[off] == '0' && res[off+1] == '.') res.erase(off, 1); } } // add unit now res += n->unit(); if (opt.output_style == TO_CSS && !n->is_valid_css_unit()) { // traces.push_back(Backtrace(nr->pstate())); throw Exception::InvalidValue({}, *n); } // output the final token append_token(res, n); } // helper function for serializing colors template static double cap_channel(double c) { if (c > range) return range; else if (c < 0) return 0; else return c; } void Inspect::operator()(Color_RGBA* c) { // output the final token std::stringstream ss; // original color name // maybe an unknown token std::string name = c->disp(); // resolved color std::string res_name = name; double r = Sass::round(cap_channel<0xff>(c->r()), opt.precision); double g = Sass::round(cap_channel<0xff>(c->g()), opt.precision); double b = Sass::round(cap_channel<0xff>(c->b()), opt.precision); double a = cap_channel<1> (c->a()); // get color from given name (if one was given at all) if (name != "" && name_to_color(name)) { const Color_RGBA* n = name_to_color(name); r = Sass::round(cap_channel<0xff>(n->r()), opt.precision); g = Sass::round(cap_channel<0xff>(n->g()), opt.precision); b = Sass::round(cap_channel<0xff>(n->b()), opt.precision); a = cap_channel<1> (n->a()); } // otherwise get the possible resolved color name else { double numval = r * 0x10000 + g * 0x100 + b; if (color_to_name(numval)) res_name = color_to_name(numval); } std::stringstream hexlet; // dart sass compressed all colors in regular css always // ruby sass and libsass does it only when not delayed // since color math is going to be removed, this can go too bool compressed = opt.output_style == COMPRESSED; hexlet << '#' << std::setw(1) << std::setfill('0'); // create a short color hexlet if there is any need for it if (compressed && is_color_doublet(r, g, b) && a == 1) { hexlet << std::hex << std::setw(1) << (static_cast(r) >> 4); hexlet << std::hex << std::setw(1) << (static_cast(g) >> 4); hexlet << std::hex << std::setw(1) << (static_cast(b) >> 4); } else { hexlet << std::hex << std::setw(2) << static_cast(r); hexlet << std::hex << std::setw(2) << static_cast(g); hexlet << std::hex << std::setw(2) << static_cast(b); } if (compressed && !c->is_delayed()) name = ""; if (opt.output_style == INSPECT && a >= 1) { append_token(hexlet.str(), c); return; } // retain the originally specified color definition if unchanged if (name != "") { ss << name; } else if (a >= 1) { if (res_name != "") { if (compressed && hexlet.str().size() < res_name.size()) { ss << hexlet.str(); } else { ss << res_name; } } else { ss << hexlet.str(); } } else { ss << "rgba("; ss << static_cast(r) << ","; if (!compressed) ss << " "; ss << static_cast(g) << ","; if (!compressed) ss << " "; ss << static_cast(b) << ","; if (!compressed) ss << " "; ss << a << ')'; } append_token(ss.str(), c); } void Inspect::operator()(Color_HSLA* c) { Color_RGBA_Obj rgba = c->toRGBA(); operator()(rgba); } void Inspect::operator()(Boolean* b) { // output the final token append_token(b->value() ? "true" : "false", b); } void Inspect::operator()(String_Schema* ss) { // Evaluation should turn these into String_Constants, // so this method is only for inspection purposes. for (size_t i = 0, L = ss->length(); i < L; ++i) { if ((*ss)[i]->is_interpolant()) append_string("#{"); (*ss)[i]->perform(this); if ((*ss)[i]->is_interpolant()) append_string("}"); } } void Inspect::operator()(String_Constant* s) { append_token(s->value(), s); } void Inspect::operator()(String_Quoted* s) { if (const char q = s->quote_mark()) { append_token(quote(s->value(), q), s); } else { append_token(s->value(), s); } } void Inspect::operator()(Custom_Error* e) { append_token(e->message(), e); } void Inspect::operator()(Custom_Warning* w) { append_token(w->message(), w); } void Inspect::operator()(Supports_Operator* so) { if (so->needs_parens(so->left())) append_string("("); so->left()->perform(this); if (so->needs_parens(so->left())) append_string(")"); if (so->operand() == Supports_Operator::AND) { append_mandatory_space(); append_token("and", so); append_mandatory_space(); } else if (so->operand() == Supports_Operator::OR) { append_mandatory_space(); append_token("or", so); append_mandatory_space(); } if (so->needs_parens(so->right())) append_string("("); so->right()->perform(this); if (so->needs_parens(so->right())) append_string(")"); } void Inspect::operator()(Supports_Negation* sn) { append_token("not", sn); append_mandatory_space(); if (sn->needs_parens(sn->condition())) append_string("("); sn->condition()->perform(this); if (sn->needs_parens(sn->condition())) append_string(")"); } void Inspect::operator()(Supports_Declaration* sd) { append_string("("); sd->feature()->perform(this); append_string(": "); sd->value()->perform(this); append_string(")"); } void Inspect::operator()(Supports_Interpolation* sd) { sd->value()->perform(this); } void Inspect::operator()(Media_Query* mq) { size_t i = 0; if (mq->media_type()) { if (mq->is_negated()) append_string("not "); else if (mq->is_restricted()) append_string("only "); mq->media_type()->perform(this); } else { (*mq)[i++]->perform(this); } for (size_t L = mq->length(); i < L; ++i) { append_string(" and "); (*mq)[i]->perform(this); } } void Inspect::operator()(Media_Query_Expression* mqe) { if (mqe->is_interpolated()) { mqe->feature()->perform(this); } else { append_string("("); mqe->feature()->perform(this); if (mqe->value()) { append_string(": "); // verified mqe->value()->perform(this); } append_string(")"); } } void Inspect::operator()(At_Root_Query* ae) { if (ae->feature()) { append_string("("); ae->feature()->perform(this); if (ae->value()) { append_colon_separator(); ae->value()->perform(this); } append_string(")"); } } void Inspect::operator()(Function* f) { append_token("get-function", f); append_string("("); append_string(quote(f->name())); append_string(")"); } void Inspect::operator()(Null* n) { // output the final token append_token("null", n); } // parameters and arguments void Inspect::operator()(Parameter* p) { append_token(p->name(), p); if (p->default_value()) { append_colon_separator(); p->default_value()->perform(this); } else if (p->is_rest_parameter()) { append_string("..."); } } void Inspect::operator()(Parameters* p) { append_string("("); if (!p->empty()) { (*p)[0]->perform(this); for (size_t i = 1, L = p->length(); i < L; ++i) { append_comma_separator(); (*p)[i]->perform(this); } } append_string(")"); } void Inspect::operator()(Argument* a) { if (!a->name().empty()) { append_token(a->name(), a); append_colon_separator(); } if (!a->value()) return; // Special case: argument nulls can be ignored if (a->value()->concrete_type() == Expression::NULL_VAL) { return; } if (a->value()->concrete_type() == Expression::STRING) { String_Constant* s = Cast(a->value()); if (s) s->perform(this); } else { a->value()->perform(this); } if (a->is_rest_argument()) { append_string("..."); } } void Inspect::operator()(Arguments* a) { append_string("("); if (!a->empty()) { (*a)[0]->perform(this); for (size_t i = 1, L = a->length(); i < L; ++i) { append_string(", "); // verified // Sass Bug? append_comma_separator(); (*a)[i]->perform(this); } } append_string(")"); } void Inspect::operator()(Selector_Schema* s) { s->contents()->perform(this); } void Inspect::operator()(Parent_Reference* p) { append_string("&"); } void Inspect::operator()(Placeholder_Selector* s) { append_token(s->name(), s); } void Inspect::operator()(Type_Selector* s) { append_token(s->ns_name(), s); } void Inspect::operator()(Class_Selector* s) { append_token(s->ns_name(), s); } void Inspect::operator()(Id_Selector* s) { append_token(s->ns_name(), s); } void Inspect::operator()(Attribute_Selector* s) { append_string("["); add_open_mapping(s); append_token(s->ns_name(), s); if (!s->matcher().empty()) { append_string(s->matcher()); if (s->value() && *s->value()) { s->value()->perform(this); } } add_close_mapping(s); if (s->modifier() != 0) { append_mandatory_space(); append_char(s->modifier()); } append_string("]"); } void Inspect::operator()(Pseudo_Selector* s) { if (s->name() != "") { append_string(":"); if (s->isSyntacticElement()) { append_string(":"); } append_token(s->ns_name(), s); if (s->selector() || s->argument()) { bool was = in_wrapped; in_wrapped = true; append_string("("); if (s->argument()) { s->argument()->perform(this); } if (s->selector() && s->argument()) { append_mandatory_space(); } bool was_comma_array = in_comma_array; in_comma_array = false; if (s->selector()) { s->selector()->perform(this); } in_comma_array = was_comma_array; append_string(")"); in_wrapped = was; } } } void Inspect::operator()(SelectorList* g) { if (g->empty()) { if (output_style() == TO_SASS) { append_token("()", g); } return; } bool was_comma_array = in_comma_array; // probably ruby sass eqivalent of element_needs_parens if (output_style() == TO_SASS && g->length() == 1 && (!Cast((*g)[0]) && !Cast((*g)[0]))) { append_string("("); } else if (!in_declaration && in_comma_array) { append_string("("); } if (in_declaration) in_comma_array = true; for (size_t i = 0, L = g->length(); i < L; ++i) { if (!in_wrapped && i == 0) append_indentation(); if ((*g)[i] == nullptr) continue; schedule_mapping(g->at(i)->last()); // add_open_mapping((*g)[i]->last()); (*g)[i]->perform(this); // add_close_mapping((*g)[i]->last()); if (i < L - 1) { scheduled_space = 0; append_comma_separator(); } } in_comma_array = was_comma_array; // probably ruby sass eqivalent of element_needs_parens if (output_style() == TO_SASS && g->length() == 1 && (!Cast((*g)[0]) && !Cast((*g)[0]))) { append_string(",)"); } else if (!in_declaration && in_comma_array) { append_string(")"); } } void Inspect::operator()(ComplexSelector* sel) { if (sel->hasPreLineFeed()) { append_optional_linefeed(); if (!in_wrapped && output_style() == NESTED) { append_indentation(); } } const SelectorComponent* prev = nullptr; for (auto& item : sel->elements()) { if (prev != nullptr) { if (typeid(*item) == typeid(SelectorCombinator) || typeid(*prev) == typeid(SelectorCombinator)) { append_optional_space(); } else { append_mandatory_space(); } } item->perform(this); prev = item.ptr(); } } void Inspect::operator()(SelectorComponent* sel) { // You should probably never call this method directly // But in case anyone does, we will do the upcasting if (auto comp = Cast(sel)) operator()(comp); if (auto comb = Cast(sel)) operator()(comb); } void Inspect::operator()(CompoundSelector* sel) { if (sel->hasRealParent()) { append_string("&"); } for (auto& item : sel->elements()) { item->perform(this); } // Add the post line break (from ruby sass) // Dart sass uses another logic for newlines if (sel->hasPostLineBreak()) { if (output_style() != COMPACT) { append_optional_linefeed(); } } } void Inspect::operator()(SelectorCombinator* sel) { append_optional_space(); switch (sel->combinator()) { case SelectorCombinator::Combinator::CHILD: append_string(">"); break; case SelectorCombinator::Combinator::GENERAL: append_string("~"); break; case SelectorCombinator::Combinator::ADJACENT: append_string("+"); break; } append_optional_space(); // Add the post line break (from ruby sass) // Dart sass uses another logic for newlines if (sel->hasPostLineBreak()) { if (output_style() != COMPACT) { // append_optional_linefeed(); } } } }