wee 0.3.1 → 0.4.0

data/doc/rdoc/classes/Wee/Component.html

@@ -83,7 +83,7 @@
     <div id="description">
       <p>
 The base class of all components. You should at least overwrite method <a
-href="Component.html#M000164">render</a> in your own subclasses.
+href="Component.html#M000173">render</a> in your own subclasses.
 </p>
 
     </div>
@@ -92,13 +92,13 @@ href="Component.html#M000164">render</a> in your own subclasses.
     <div id="contents-list">
       <h3 class="section-bar">Contents</h3>
       <ul>
-      <li><a href="#SEC00063">Render</a></li>
-      <li><a href="#SEC00064">Callback</a></li>
-      <li><a href="#SEC00065">Init</a></li>
-      <li><a href="#SEC00066">Children</a></li>
-      <li><a href="#SEC00067">Decoration</a></li>
-      <li><a href="#SEC00068">Backtrack</a></li>
-      <li><a href="#SEC00069">Call/Answer</a></li>
+      <li><a href="#SEC00067">Render</a></li>
+      <li><a href="#SEC00068">Callback</a></li>
+      <li><a href="#SEC00069">Init</a></li>
+      <li><a href="#SEC00070">Children</a></li>
+      <li><a href="#SEC00071">Decoration</a></li>
+      <li><a href="#SEC00072">Backtrack</a></li>
+      <li><a href="#SEC00073">Call/Answer</a></li>
      </ul>
    </div>
 
@@ -106,23 +106,23 @@ href="Component.html#M000164">render</a> in your own subclasses.
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000169">add_child</a>&nbsp;&nbsp;
-      <a href="#M000173">add_decoration</a>&nbsp;&nbsp;
-      <a href="#M000179">answer</a>&nbsp;&nbsp;
-      <a href="#M000177">backtrack_state</a>&nbsp;&nbsp;
-      <a href="#M000176">backtrack_state_chain</a>&nbsp;&nbsp;
-      <a href="#M000178">call</a>&nbsp;&nbsp;
-      <a href="#M000168">children</a>&nbsp;&nbsp;
-      <a href="#M000170">decoration</a>&nbsp;&nbsp;
-      <a href="#M000171">decoration=</a>&nbsp;&nbsp;
-      <a href="#M000163">do_render_chain</a>&nbsp;&nbsp;
-      <a href="#M000172">each_decoration</a>&nbsp;&nbsp;
-      <a href="#M000167">initialize</a>&nbsp;&nbsp;
-      <a href="#M000166">process_callbacks</a>&nbsp;&nbsp;
-      <a href="#M000165">process_callbacks_chain</a>&nbsp;&nbsp;
-      <a href="#M000174">remove_decoration</a>&nbsp;&nbsp;
-      <a href="#M000175">remove_decoration_if</a>&nbsp;&nbsp;
-      <a href="#M000164">render</a>&nbsp;&nbsp;
+      <a href="#M000178">add_child</a>&nbsp;&nbsp;
+      <a href="#M000182">add_decoration</a>&nbsp;&nbsp;
+      <a href="#M000188">answer</a>&nbsp;&nbsp;
+      <a href="#M000186">backtrack_state</a>&nbsp;&nbsp;
+      <a href="#M000185">backtrack_state_chain</a>&nbsp;&nbsp;
+      <a href="#M000187">call</a>&nbsp;&nbsp;
+      <a href="#M000177">children</a>&nbsp;&nbsp;
+      <a href="#M000179">decoration</a>&nbsp;&nbsp;
+      <a href="#M000180">decoration=</a>&nbsp;&nbsp;
+      <a href="#M000172">do_render_chain</a>&nbsp;&nbsp;
+      <a href="#M000181">each_decoration</a>&nbsp;&nbsp;
+      <a href="#M000176">initialize</a>&nbsp;&nbsp;
+      <a href="#M000175">process_callbacks</a>&nbsp;&nbsp;
+      <a href="#M000174">process_callbacks_chain</a>&nbsp;&nbsp;
+      <a href="#M000183">remove_decoration</a>&nbsp;&nbsp;
+      <a href="#M000184">remove_decoration_if</a>&nbsp;&nbsp;
+      <a href="#M000173">render</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -142,7 +142,7 @@ href="Component.html#M000164">render</a> in your own subclasses.
 
     <!-- if method_list -->
     <div id="section">
-      <h2 class="section-title"><a name="SEC00063">Render</a></h2>
+      <h2 class="section-title"><a name="SEC00067">Render</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -158,11 +158,11 @@ href="Component.html#M000164">render</a> in your own subclasses.
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000163" class="method-detail">
-        <a name="M000163"></a>
+      <div id="method-M000172" class="method-detail">
+        <a name="M000172"></a>
 
         <div class="method-heading">
-          <a href="#M000163" class="method-signature">
+          <a href="#M000172" class="method-signature">
           <span class="method-name">do_render_chain</span><span class="method-args">(rendering_context)</span>
           </a>
         </div>
@@ -170,7 +170,7 @@ href="Component.html#M000164">render</a> in your own subclasses.
         <div class="method-description">
           <p>
 Starts rendering the decoration chain by calling method <a
-href="Presenter.html#M000182">Presenter#do_render</a> for the first
+href="Presenter.html#M000191">Presenter#do_render</a> for the first
 decoration of the component, or calling <em>do_render</em> for the
 component itself if no decorations were specified.
 </p>
@@ -180,8 +180,8 @@ component itself if no decorations were specified.
 </dd>
 </dl>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000163-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000163-source">
+            onclick="toggleCode('M000172-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000172-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 19</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">do_render_chain</span>(<span class="ruby-identifier">rendering_context</span>)
@@ -192,11 +192,11 @@ component itself if no decorations were specified.
         </div>
       </div>
 
-      <div id="method-M000164" class="method-detail">
-        <a name="M000164"></a>
+      <div id="method-M000173" class="method-detail">
+        <a name="M000173"></a>
 
         <div class="method-heading">
-          <a href="#M000164" class="method-signature">
+          <a href="#M000173" class="method-signature">
           <span class="method-name">render</span><span class="method-args">()</span>
           </a>
         </div>
@@ -213,8 +213,8 @@ view. By default this method does nothing!
 Use the current renderer as returned by renderer or it&#8217;s short-cut r.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000164-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000164-source">
+            onclick="toggleCode('M000173-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000173-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 30</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">render</span>
@@ -227,7 +227,7 @@ Use the current renderer as returned by renderer or it&#8217;s short-cut r.
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00064">Callback</a></h2>
+      <h2 class="section-title"><a name="SEC00068">Callback</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -243,11 +243,11 @@ Use the current renderer as returned by renderer or it&#8217;s short-cut r.
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000166" class="method-detail">
-        <a name="M000166"></a>
+      <div id="method-M000175" class="method-detail">
+        <a name="M000175"></a>
 
         <div class="method-heading">
-          <a href="#M000166" class="method-signature">
+          <a href="#M000175" class="method-signature">
           <span class="method-name">process_callbacks</span><span class="method-args">(callback_stream)</span>
           </a>
         </div>
@@ -267,8 +267,8 @@ processed/invoked before any of the action callbacks are processed/invoked.
 </dd>
 </dl>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000166-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000166-source">
+            onclick="toggleCode('M000175-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000175-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 59</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_callbacks</span>(<span class="ruby-identifier">callback_stream</span>)
@@ -284,11 +284,11 @@ processed/invoked before any of the action callbacks are processed/invoked.
         </div>
       </div>
 
-      <div id="method-M000165" class="method-detail">
-        <a name="M000165"></a>
+      <div id="method-M000174" class="method-detail">
+        <a name="M000174"></a>
 
         <div class="method-heading">
-          <a href="#M000165" class="method-signature">
+          <a href="#M000174" class="method-signature">
           <span class="method-name">process_callbacks_chain</span><span class="method-args">(callback_stream)</span>
           </a>
         </div>
@@ -296,7 +296,7 @@ processed/invoked before any of the action callbacks are processed/invoked.
         <div class="method-description">
           <p>
 Starts processing the callbacks for the decoration chain by invoking method
-<a href="Component.html#M000166">process_callbacks</a> of the first
+<a href="Component.html#M000175">process_callbacks</a> of the first
 decoration or the component itself if no decorations were specified.
 </p>
 <dl>
@@ -305,8 +305,8 @@ decoration or the component itself if no decorations were specified.
 </dd>
 </dl>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000165-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000165-source">
+            onclick="toggleCode('M000174-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000174-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process_callbacks_chain</span>(<span class="ruby-identifier">callback_stream</span>)
@@ -320,7 +320,7 @@ decoration or the component itself if no decorations were specified.
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00065">Init</a></h2>
+      <h2 class="section-title"><a name="SEC00069">Init</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -336,11 +336,11 @@ decoration or the component itself if no decorations were specified.
     <div id="methods">
       <h3 class="section-bar">Protected Instance methods</h3>
 
-      <div id="method-M000167" class="method-detail">
-        <a name="M000167"></a>
+      <div id="method-M000176" class="method-detail">
+        <a name="M000176"></a>
 
         <div class="method-heading">
-          <a href="#M000167" class="method-signature">
+          <a href="#M000176" class="method-signature">
           <span class="method-name">initialize</span><span class="method-args">()</span>
           </a>
         </div>
@@ -354,8 +354,8 @@ Call this method from your own components&#8217; <em>initialize</em> method
 using <tt>super</tt>, before setting up anything else!
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000167-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000167-source">
+            onclick="toggleCode('M000176-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000176-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 79</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>() <span class="ruby-comment cmt"># :notnew:</span>
@@ -370,7 +370,7 @@ using <tt>super</tt>, before setting up anything else!
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00066">Children</a></h2>
+      <h2 class="section-title"><a name="SEC00070">Children</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -386,11 +386,11 @@ using <tt>super</tt>, before setting up anything else!
     <div id="methods">
       <h3 class="section-bar">Protected Instance methods</h3>
 
-      <div id="method-M000169" class="method-detail">
-        <a name="M000169"></a>
+      <div id="method-M000178" class="method-detail">
+        <a name="M000178"></a>
 
         <div class="method-heading">
-          <a href="#M000169" class="method-signature">
+          <a href="#M000178" class="method-signature">
           <span class="method-name">add_child</span><span class="method-args">(child)</span>
           </a>
         </div>
@@ -419,8 +419,8 @@ course only if you want backtracking at all):
   end
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000169-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000169-source">
+            onclick="toggleCode('M000178-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000178-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 115</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_child</span>(<span class="ruby-identifier">child</span>)
@@ -431,11 +431,11 @@ course only if you want backtracking at all):
         </div>
       </div>
 
-      <div id="method-M000168" class="method-detail">
-        <a name="M000168"></a>
+      <div id="method-M000177" class="method-detail">
+        <a name="M000177"></a>
 
         <div class="method-heading">
-          <a href="#M000168" class="method-signature">
+          <a href="#M000177" class="method-signature">
           <span class="method-name">children</span><span class="method-args">()</span>
           </a>
         </div>
@@ -445,8 +445,8 @@ course only if you want backtracking at all):
 Returns all direct child components collected in an array.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000168-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000168-source">
+            onclick="toggleCode('M000177-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000177-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 92</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">children</span>
@@ -460,7 +460,7 @@ Returns all direct child components collected in an array.
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00067">Decoration</a></h2>
+      <h2 class="section-title"><a name="SEC00071">Decoration</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -476,38 +476,63 @@ Returns all direct child components collected in an array.
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000173" class="method-detail">
-        <a name="M000173"></a>
+      <div id="method-M000182" class="method-detail">
+        <a name="M000182"></a>
 
         <div class="method-heading">
-          <a href="#M000173" class="method-signature">
+          <a href="#M000182" class="method-signature">
           <span class="method-name">add_decoration</span><span class="method-args">(d)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Adds decoration <tt>d</tt> in front of the decoration chain.
+Adds decoration <tt>d</tt> to the decoration chain.
+</p>
+<p>
+A global decoration is added in front of the decoration chain, a local
+decoration is added in front of all other local decorations but after all
+global decorations.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000173-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000173-source">
+            onclick="toggleCode('M000182-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000182-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 151</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 155</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_decoration</span>(<span class="ruby-identifier">d</span>)
-    <span class="ruby-identifier">d</span>.<span class="ruby-identifier">owner</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span> = <span class="ruby-identifier">d</span>
+    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">global?</span>
+      <span class="ruby-identifier">d</span>.<span class="ruby-identifier">owner</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span>
+      <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span> = <span class="ruby-identifier">d</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">last_global</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">each_decoration</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> 
+        <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span>.<span class="ruby-identifier">global?</span>
+          <span class="ruby-identifier">last_global</span> = <span class="ruby-identifier">i</span>
+        <span class="ruby-keyword kw">else</span>
+          <span class="ruby-keyword kw">break</span>
+        <span class="ruby-keyword kw">end</span>
+      }
+      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">last_global</span>.<span class="ruby-identifier">nil?</span>
+        <span class="ruby-comment cmt"># no global decorations specified -&gt; add in front</span>
+        <span class="ruby-identifier">d</span>.<span class="ruby-identifier">owner</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span>
+        <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span> = <span class="ruby-identifier">d</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-comment cmt"># add after last_global</span>
+        <span class="ruby-identifier">d</span>.<span class="ruby-identifier">owner</span> = <span class="ruby-identifier">last_global</span>.<span class="ruby-identifier">owner</span>
+        <span class="ruby-identifier">last_global</span>.<span class="ruby-identifier">owner</span> = <span class="ruby-identifier">d</span> 
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span>
   <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000170" class="method-detail">
-        <a name="M000170"></a>
+      <div id="method-M000179" class="method-detail">
+        <a name="M000179"></a>
 
         <div class="method-heading">
-          <a href="#M000170" class="method-signature">
+          <a href="#M000179" class="method-signature">
           <span class="method-name">decoration</span><span class="method-args">()</span>
           </a>
         </div>
@@ -518,8 +543,8 @@ Returns the first decoration from the component&#8217;s decoration chain,
 or <tt>self</tt> if no decorations were specified for the component.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000170-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000170-source">
+            onclick="toggleCode('M000179-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000179-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 128</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decoration</span>
@@ -530,11 +555,11 @@ or <tt>self</tt> if no decorations were specified for the component.
         </div>
       </div>
 
-      <div id="method-M000171" class="method-detail">
-        <a name="M000171"></a>
+      <div id="method-M000180" class="method-detail">
+        <a name="M000180"></a>
 
         <div class="method-heading">
-          <a href="#M000171" class="method-signature">
+          <a href="#M000180" class="method-signature">
           <span class="method-name">decoration=</span><span class="method-args">(d)</span>
           </a>
         </div>
@@ -544,8 +569,8 @@ or <tt>self</tt> if no decorations were specified for the component.
 Set the pointer to the first decoration to <tt>d</tt>.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000171-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000171-source">
+            onclick="toggleCode('M000180-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000180-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 134</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decoration=</span>(<span class="ruby-identifier">d</span>) 
@@ -556,11 +581,11 @@ Set the pointer to the first decoration to <tt>d</tt>.
         </div>
       </div>
 
-      <div id="method-M000172" class="method-detail">
-        <a name="M000172"></a>
+      <div id="method-M000181" class="method-detail">
+        <a name="M000181"></a>
 
         <div class="method-heading">
-          <a href="#M000172" class="method-signature">
+          <a href="#M000181" class="method-signature">
           <span class="method-name">each_decoration</span><span class="method-args">( {|decoration| ...}</span>
           </a>
         </div>
@@ -570,8 +595,8 @@ Set the pointer to the first decoration to <tt>d</tt>.
 Iterates over all decorations (note that the component itself is excluded).
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000172-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000172-source">
+            onclick="toggleCode('M000181-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000181-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 140</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_decoration</span> <span class="ruby-comment cmt"># :yields: decoration</span>
@@ -587,11 +612,11 @@ Iterates over all decorations (note that the component itself is excluded).
         </div>
       </div>
 
-      <div id="method-M000174" class="method-detail">
-        <a name="M000174"></a>
+      <div id="method-M000183" class="method-detail">
+        <a name="M000183"></a>
 
         <div class="method-heading">
-          <a href="#M000174" class="method-signature">
+          <a href="#M000183" class="method-signature">
           <span class="method-name">remove_decoration</span><span class="method-args">(d)</span>
           </a>
         </div>
@@ -605,10 +630,10 @@ Returns the removed decoration or <tt>nil</tt> if it did not exist in the
 decoration chain.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000174-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000174-source">
+            onclick="toggleCode('M000183-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000183-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 161</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 185</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_decoration</span>(<span class="ruby-identifier">d</span>)
     <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">d</span> <span class="ruby-operator">==</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span>  <span class="ruby-comment cmt"># 'd' is in front</span>
       <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">decoration</span> = <span class="ruby-identifier">d</span>.<span class="ruby-identifier">owner</span>
@@ -631,11 +656,11 @@ decoration chain.
         </div>
       </div>
 
-      <div id="method-M000175" class="method-detail">
-        <a name="M000175"></a>
+      <div id="method-M000184" class="method-detail">
+        <a name="M000184"></a>
 
         <div class="method-heading">
-          <a href="#M000175" class="method-signature">
+          <a href="#M000184" class="method-signature">
           <span class="method-name">remove_decoration_if</span><span class="method-args">( {|decoration| ...}</span>
           </a>
         </div>
@@ -651,10 +676,10 @@ Example (removes all decorations of class <tt>HaloDecoration</tt>):
   remove_decoration_if {|d| d.class == HaloDecoration}
 </pre>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000175-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000175-source">
+            onclick="toggleCode('M000184-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000184-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 186</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 210</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">remove_decoration_if</span> <span class="ruby-comment cmt"># :yields: decoration</span>
     <span class="ruby-identifier">to_remove</span> = []
     <span class="ruby-identifier">each_decoration</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span> <span class="ruby-identifier">to_remove</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">d</span> <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">d</span>}
@@ -668,7 +693,7 @@ Example (removes all decorations of class <tt>HaloDecoration</tt>):
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00068">Backtrack</a></h2>
+      <h2 class="section-title"><a name="SEC00072">Backtrack</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -684,11 +709,11 @@ Example (removes all decorations of class <tt>HaloDecoration</tt>):
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000177" class="method-detail">
-        <a name="M000177"></a>
+      <div id="method-M000186" class="method-detail">
+        <a name="M000186"></a>
 
         <div class="method-heading">
-          <a href="#M000177" class="method-signature">
+          <a href="#M000186" class="method-signature">
           <span class="method-name">backtrack_state</span><span class="method-args">(snapshot)</span>
           </a>
         </div>
@@ -715,7 +740,7 @@ the decoration-object itself!).
 <p>
 For example if you dynamically add children to your component, you might
 want to backtrack the children array. Therefore you simply pass it to the
-<a href="Snapshot.html#M000069">Snapshot#add</a> method:
+<a href="Snapshot.html#M000075">Snapshot#add</a> method:
 </p>
 <pre>
   def backtrack_state(snapshot)
@@ -737,10 +762,10 @@ as argument.
 </dd>
 </dl>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000177-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000177-source">
+            onclick="toggleCode('M000186-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000186-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 243</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 267</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">backtrack_state</span>(<span class="ruby-identifier">snapshot</span>)
     <span class="ruby-identifier">snapshot</span>.<span class="ruby-identifier">add</span>(<span class="ruby-ivar">@decoration</span>)
     <span class="ruby-identifier">children</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">child</span><span class="ruby-operator">|</span> <span class="ruby-identifier">child</span>.<span class="ruby-identifier">backtrack_state_chain</span>(<span class="ruby-identifier">snapshot</span>) <span class="ruby-keyword kw">end</span>
@@ -750,11 +775,11 @@ as argument.
         </div>
       </div>
 
-      <div id="method-M000176" class="method-detail">
-        <a name="M000176"></a>
+      <div id="method-M000185" class="method-detail">
+        <a name="M000185"></a>
 
         <div class="method-heading">
-          <a href="#M000176" class="method-signature">
+          <a href="#M000185" class="method-signature">
           <span class="method-name">backtrack_state_chain</span><span class="method-args">(snapshot)</span>
           </a>
         </div>
@@ -762,11 +787,11 @@ as argument.
         <div class="method-description">
           <p>
 Starts the backtrack-state phase for the decoration chain, by invoking
-method <a href="Component.html#M000177">backtrack_state</a> of the first
+method <a href="Component.html#M000186">backtrack_state</a> of the first
 decoration or the component itself if no decorations were specified.
 </p>
 <p>
-See <a href="Component.html#M000177">backtrack_state</a> for details.
+See <a href="Component.html#M000186">backtrack_state</a> for details.
 </p>
 <dl>
 <dt><tt>snapshot</tt></dt><dd>An object of class <a href="Snapshot.html">Snapshot</a>
@@ -774,10 +799,10 @@ See <a href="Component.html#M000177">backtrack_state</a> for details.
 </dd>
 </dl>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000176-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000176-source">
+            onclick="toggleCode('M000185-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000185-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 207</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 231</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">backtrack_state_chain</span>(<span class="ruby-identifier">snapshot</span>)
     <span class="ruby-identifier">decoration</span>.<span class="ruby-identifier">backtrack_state</span>(<span class="ruby-identifier">snapshot</span>)
   <span class="ruby-keyword kw">end</span>
@@ -789,7 +814,7 @@ See <a href="Component.html#M000177">backtrack_state</a> for details.
 
     </div>
     <div id="section">
-      <h2 class="section-title"><a name="SEC00069">Call/Answer</a></h2>
+      <h2 class="section-title"><a name="SEC00073">Call/Answer</a></h2>
       <div class="section-comment">
         
       </div>      
@@ -805,11 +830,11 @@ See <a href="Component.html#M000177">backtrack_state</a> for details.
     <div id="methods">
       <h3 class="section-bar">Protected Instance methods</h3>
 
-      <div id="method-M000179" class="method-detail">
-        <a name="M000179"></a>
+      <div id="method-M000188" class="method-detail">
+        <a name="M000188"></a>
 
         <div class="method-heading">
-          <a href="#M000179" class="method-signature">
+          <a href="#M000188" class="method-signature">
           <span class="method-name">answer</span><span class="method-args">(*args)</span>
           </a>
         </div>
@@ -819,17 +844,17 @@ See <a href="Component.html#M000177">backtrack_state</a> for details.
 Return from a called component.
 </p>
 <p>
-NOTE that <a href="Component.html#M000179">answer</a> never returns.
+NOTE that <a href="Component.html#M000188">answer</a> never returns.
 </p>
 <p>
-See <a href="Component.html#M000178">call</a> for a detailed description of
+See <a href="Component.html#M000187">call</a> for a detailed description of
 the call/answer mechanism.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000179-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000179-source">
+            onclick="toggleCode('M000188-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000188-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 310</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 334</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">answer</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
     <span class="ruby-identifier">throw</span> <span class="ruby-identifier">:wee_answer</span>, <span class="ruby-identifier">args</span> 
   <span class="ruby-keyword kw">end</span>
@@ -838,11 +863,11 @@ the call/answer mechanism.
         </div>
       </div>
 
-      <div id="method-M000178" class="method-detail">
-        <a name="M000178"></a>
+      <div id="method-M000187" class="method-detail">
+        <a name="M000187"></a>
 
         <div class="method-heading">
-          <a href="#M000178" class="method-signature">
+          <a href="#M000187" class="method-signature">
           <span class="method-name">call</span><span class="method-args">(component, return_callback=:use_continuation)</span>
           </a>
         </div>
@@ -851,7 +876,7 @@ the call/answer mechanism.
           <p>
 Call another component. The calling component is neither rendered nor are
 it&#8217;s callbacks processed until the called component answers using
-method <a href="Component.html#M000179">answer</a>.
+method <a href="Component.html#M000188">answer</a>.
 </p>
 <dl>
 <dt><tt>component</tt></dt><dd>The component to be called.
@@ -871,15 +896,15 @@ calling component (self), which delegates to the component to be called
 href="Session.html">Session</a> by throwing <em>:wee_back_to_session</em>.
 This means, that there is only ever one action callback invoked per
 request. When at a later point in time the called component invokes <a
-href="Component.html#M000179">answer</a>, this will throw a
+href="Component.html#M000188">answer</a>, this will throw a
 <em>:wee_answer</em> exception which is catched in the <a
 href="AnswerDecoration.html">AnswerDecoration</a>. The <a
 href="AnswerDecoration.html">AnswerDecoration</a> then jumps back to the
 continuation we created at the beginning, and finally method <a
-href="Component.html#M000178">call</a> returns.
+href="Component.html#M000187">call</a> returns.
 </p>
 <p>
-Note that <a href="Component.html#M000178">call</a> returns to an
+Note that <a href="Component.html#M000187">call</a> returns to an
 &quot;old&quot; stack-frame from a previous request. That is why we throw
 <em>:wee_back_to_session</em> after invoking an action callback, and
 that&#8217;s why only ever one is invoked. We could remove this limitation
@@ -887,10 +912,10 @@ without problems, but then there would be a difference between those action
 callbacks that call other components and those that do not.
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000178-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000178-source">
+            onclick="toggleCode('M000187-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000187-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 281</span>
+<span class="ruby-comment cmt"># File lib/wee/core/component.rb, line 305</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">call</span>(<span class="ruby-identifier">component</span>, <span class="ruby-identifier">return_callback</span>=<span class="ruby-identifier">:use_continuation</span>)
     <span class="ruby-identifier">add_decoration</span>(<span class="ruby-identifier">delegate</span> = <span class="ruby-constant">Wee</span><span class="ruby-operator">::</span><span class="ruby-constant">Delegate</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">component</span>))
     <span class="ruby-identifier">component</span>.<span class="ruby-identifier">add_decoration</span>(<span class="ruby-identifier">answer</span> = <span class="ruby-constant">Wee</span><span class="ruby-operator">::</span><span class="ruby-constant">AnswerDecoration</span>.<span class="ruby-identifier">new</span>)