1 files changed, 131 insertions, 0 deletions

diff --git a/src/bem/_multi.scss b/src/bem/_multi.scss
new file mode 100644
index 0000000..9e47ce4
--- /dev/null
+++ b/src/bem/_multi.scss
@@ -0,0 +1,131 @@
+////
+/// @group BEM
+///
+/// @access public
+////
+
+/// 
+/// Generate multiple entities (BEM or not) at once.
+///
+/// NOTE: This mixin does not generate perfectly optimized selectors in order to keep track of contexts.
+///
+/// @param {string | list} $first  - First selector. Either a string for a manual selector, or a list with the first items standing for a BEM selector function (optionally suffixed by a colon) and other items being passed as arguments to said function.
+/// @param {string | list} $others - Other selectors. Either a string for a manual selector, or a list with the first items standing for a BEM selector function (optionally suffixed by a colon) and other items being passed as arguments to said function.
+///
+/// @content
+///
+/// @example scss - Creating multiple elements, a modifier and an anchor
+///   @include iro-bem-object('buttonstrip') {
+///     display: none;
+///     
+///     @include iro-bem-multi('modifier' 'mod', 'element' 'button' 'separator', '> a') {
+///       display: block;
+///     }
+///   }
+///   
+///   // Generates:
+///   
+///   .o-buttonstrip {
+///     display: none;
+///   }
+///   
+///   .o-buttonstrip--mod {
+///     display: block;
+///   }
+///   
+///   .o-buttonstrip__button, {
+///   .o-buttonstrip__separator {
+///     display: block;
+///   }
+///   
+///   .o-buttonstrip > a {
+///     display: block;
+///   }
+///
+/// @example scss - Creating multiple elements, a modifier and an anchor - optional colons included
+///   @include iro-bem-object('buttonstrip') {
+///     display: none;
+///     
+///     @include iro-bem-multi('modifier:' 'mod', 'element:' 'button' 'separator', '> a') {
+///       display: block;
+///     }
+///   }
+///   
+///   // Generates:
+///   
+///   .o-buttonstrip {
+///     display: none;
+///   }
+///   
+///   .o-buttonstrip--mod {
+///     display: block;
+///   }
+///   
+///   .o-buttonstrip__button, {
+///   .o-buttonstrip__separator {
+///     display: block;
+///   }
+///   
+///   .o-buttonstrip > a {
+///     display: block;
+///   }
+///
+@mixin iro-bem-multi($first, $others...) {
+    @include iro-context-assert-stack-count($iro-bem-context-id, $iro-bem-max-depth);
+
+    @each $entity in iro-list-prepend($others, $first) {
+        $is-manual-selector: false;
+
+        @if type-of($entity) == string and not function-exists('iro-bem-' + $entity) {
+            $is-manual-selector: true;
+        }
+
+        @if $is-manual-selector {
+            $sel: if(&, selector-nest(&, $entity), selector-parse($entity));
+
+            @at-root #{$sel} {
+                @content;
+            }
+        } @else {
+            $entity-func-id: null;
+
+            @if type-of($entity) == list {
+                $entity-func-id: nth($entity, 1);
+                $entity:         iro-list-slice($entity, 2);
+            } @else {
+                $entity-func-id: $entity;
+                $entity:         ();
+            }
+
+            @if str-slice($entity-func-id, str-length($entity-func-id)) == ':' {
+                $entity-func-id: str-slice($entity-func-id, 1, str-length($entity-func-id) - 1);
+            }
+
+            $sel-func: null;
+
+            @if function-exists('iro-bem-' + $entity-func-id) {
+                $sel-func: get-function('iro-bem-' + $entity-func-id);
+            } @else if function-exists($entity-func-id) {
+                $sel-func: get-function($entity-func-id);
+            }
+
+            @if $sel-func == null {
+                @error 'Function "#{inspect($entity-func-id)}" was not found.';
+            }
+
+            $entity-result:          call($sel-func, $entity...);
+            $entity-result-selector: nth($entity-result, 1);
+            $entity-result-context:  nth($entity-result, 2);
+
+            @if $entity-result-context != null {
+                @include iro-context-push($iro-bem-context-id, $entity-result-context...);
+            }
+            @at-root #{$entity-result-selector} {
+                @content;
+            }
+            @if $entity-result-context != null {
+                @include iro-context-pop($iro-bem-context-id);
+            }
+        }
+    }
+}