Merge pull request #5 from oddbird/do

Do

CHANGELOG.md

@@ -3,11 +3,38 @@
 
 ## 1.0.0 - UNRELEASED
 - [Core][core]:
+  - NEW: `get-token()` and `ratio()` funtions accept `$do` argument,
+    for on-the-fly adjustments
   - NEW: `trim($string)` utility now available in map-syntax,
-    to trim white-space from the start and end of a string.
+    to trim white-space from the start and end of a string
+  - NEW: `str-replace()` utility now forces arguments
+    to `string`-type when appropriate,
+    allowing e.g. `calc(16px + 1vw) ('str-replace': 1vw 2vw)`
+- [Plugin: Animate][animate]
+  - NEW: `change()`, `time()`, and `ease()` functions
+    all accept `$do` arg for on-the-fly adjustments
+- [Plugin: Color][color]
+  - BREAKING: `color()` functions accept `$do` arg
+    for on-the-fly adjustments – 
+    *before* existing `$palette` argument
+- [Plugin: Layout][layout]
+  - NEW: `break()` function accept `$do` arg
+    for on-the-fly adjustments
+- [Plugin: Scale][scale]
+  - BREAKING: `size()` function `$units…` vararg
+    has been replaced with `$do` map argument,
+    for flexible on-the-fly adjustments.
+    Non-map `$do` values are converted to
+    `('convert-units': $do)` before processing,
+    to provide a shortcut for unit-conversions.
+    `size('root', 'cm')` will continue to work,
+    but `size('root', 'em', 10px)` should be changed to
+    `size('root', 'em' 10px)` (with all unit args in a single list)
 - [Plugin: Type][type]
   - BREAKING: `import-webfonts()` mixin no longer accepts any arguments
   - NEW: `font()` function provides access to parsed font-data
+  - NEW: `'trim'` string helper strips whitespace
+    from the start and end of a string
   - NEW: Improved font-normalization handles more font-map edge-cases
   - NEW: Font-stacks can be written as comma-delimited strings,
     e.g. `'Helvetica Neue, Helvetica, Arial'` or

docs/CHANGELOG.html

@@ -361,14 +361,53 @@ <h2 id="1-0-0-unreleased">1.0.0 - UNRELEASED</h2>
 <ul>
 <li><a href="http://oddbird.net/accoutrement/docs/core.html">Core</a>:
 <ul>
+<li>NEW: <code>get-token()</code> and <code>ratio()</code> funtions accept <code>$do</code> argument,
+for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
 <li>NEW: <code>trim($string)</code> utility now available in map-syntax,
-to trim white-space from the start and end of a<span class="widont">&nbsp;</span>string.</li>
+to trim white-space from the start and end of a<span class="widont">&nbsp;</span>string</li>
+<li>NEW: <code>str-replace()</code> utility now forces arguments
+to <code>string</code>-type when appropriate,
+allowing e.g. <code>calc(16px + 1vw) ('str-replace': 1vw 2vw)</code></li>
+</ul>
+</li>
+<li><a href="http://oddbird.net/accoutrement/docs/animate.html">Plugin: Animate</a>
+<ul>
+<li>NEW: <code>change()</code>, <code>time()</code>, and <code>ease()</code> functions
+all accept <code>$do</code> arg for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
+</li>
+<li><a href="http://oddbird.net/accoutrement/docs/color.html">Plugin: Color</a>
+<ul>
+<li>BREAKING: <code>color()</code> functions accept <code>$do</code> arg
+for on-the-fly adjustments – 
+<em>before</em> existing <code>$palette</code> argument</li>
+</ul>
+</li>
+<li><a href="http://oddbird.net/accoutrement/docs/layout.html">Plugin: Layout</a>
+<ul>
+<li>NEW: <code>break()</code> function accept <code>$do</code> arg
+for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
+</li>
+<li><a href="http://oddbird.net/accoutrement/docs/scale.html">Plugin: Scale</a>
+<ul>
+<li>BREAKING: <code>size()</code> function <code>$units…</code> vararg
+has been replaced with <code>$do</code> map argument,
+for flexible on-the-fly adjustments.
+Non-map <code>$do</code> values are converted to
+<code>('convert-units': $do)</code> before processing,
+to provide a shortcut for unit-conversions.
+<code>size('root', 'cm')</code> will continue to work,
+but <code>size('root', 'em', 10px)</code> should be changed to
+<code>size('root', 'em' 10px)</code> (with all unit args in a single<span class="widont">&nbsp;</span>list)</li>
 </ul>
 </li>
 <li><a href="http://oddbird.net/accoutrement/docs/type.html">Plugin: Type</a>
 <ul>
 <li>BREAKING: <code>import-webfonts()</code> mixin no longer accepts any<span class="widont">&nbsp;</span>arguments</li>
 <li>NEW: <code>font()</code> function provides access to parsed<span class="widont">&nbsp;</span>font-data</li>
+<li>NEW: <code>'trim'</code> string helper strips whitespace
+from the start and end of a<span class="widont">&nbsp;</span>string</li>
 <li>NEW: Improved font-normalization handles more font-map<span class="widont">&nbsp;</span>edge-cases</li>
 <li>NEW: Font-stacks can be written as comma-delimited strings,
 e.g. <code>'Helvetica Neue, Helvetica, Arial'</code> or

docs/animate-change.html

@@ -731,6 +731,17 @@ <h2 class="item-title">
 
 
 
+
+      <section class="summary-subsection">
+        <h3 class="summary-subtitle">Since <code>1.0.0</code>:</h3>
+        <div class="subsection-details"><ul>
+<li>NEW: Accepts <code>$do</code> map argument,
+for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
+</div>
+      </section>
+
+
 
 
 
@@ -783,7 +794,34 @@ <h4 class="param-title">
 
 
       <div class="param-details text-block">
-        <p>The name of a change in your configuration (e.g. <code>fade-in</code>).</p>
+        <p>The name of a change in your configuration (e.g. <code>fade-in</code>)</p>
+
+      </div>
+
+  </div>
+
+
+
+
+
+
+
+
+  <div class="param-list">
+    <h4 class="param-title">
+
+
+        <span class="item-name">$do:</span>
+
+      <span class="item-value">null</span>
+      <span class="value-type">(map |<span class="widont">&nbsp;</span>null)</span>
+
+    </h4>
+
+
+
+      <div class="param-details text-block">
+        <p>A map of function/ratio adjustments to run on the returned<span class="widont">&nbsp;</span>value</p>
 
       </div>
 

docs/animate-ease.html

@@ -925,6 +925,17 @@ <h2 class="item-title">
 
 
 
+
+      <section class="summary-subsection">
+        <h3 class="summary-subtitle">Since <code>1.0.0</code>:</h3>
+        <div class="subsection-details"><ul>
+<li>NEW: Accepts <code>$do</code> map argument,
+for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
+</div>
+      </section>
+
+
 
 
 
@@ -985,6 +996,33 @@ <h4 class="param-title">
 
 
 
+
+
+
+
+
+  <div class="param-list">
+    <h4 class="param-title">
+
+
+        <span class="item-name">$do:</span>
+
+      <span class="item-value">null</span>
+      <span class="value-type">(map |<span class="widont">&nbsp;</span>null)</span>
+
+    </h4>
+
+
+
+      <div class="param-details text-block">
+        <p>A map of function/ratio adjustments to run on the returned<span class="widont">&nbsp;</span>value</p>
+
+      </div>
+
+  </div>
+
+
+
 
 
 

docs/animate-times.html

@@ -716,6 +716,17 @@ <h2 class="item-title">
 
 
 
+
+      <section class="summary-subsection">
+        <h3 class="summary-subtitle">Since <code>1.0.0</code>:</h3>
+        <div class="subsection-details"><ul>
+<li>NEW: Accepts <code>$do</code> map argument,
+for on-the-fly<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
+</div>
+      </section>
+
+
 
 
 
@@ -776,6 +787,33 @@ <h4 class="param-title">
 
 
 
+
+
+
+
+
+  <div class="param-list">
+    <h4 class="param-title">
+
+
+        <span class="item-name">$do:</span>
+
+      <span class="item-value">null</span>
+      <span class="value-type">(map |<span class="widont">&nbsp;</span>null)</span>
+
+    </h4>
+
+
+
+      <div class="param-details text-block">
+        <p>A map of function/ratio adjustments to run on the returned<span class="widont">&nbsp;</span>value</p>
+
+      </div>
+
+  </div>
+
+
+
 
 
 

docs/color-api.html

@@ -493,6 +493,17 @@ <h2 class="item-title">
 
 
 
+
+      <section class="summary-subsection">
+        <h3 class="summary-subtitle">Since <code>1.0.0</code>:</h3>
+        <div class="subsection-details"><ul>
+<li>BREAKING: Accepts <code>$do</code> argument
+between <code>$color</code> and <code>$palette</code></li>
+</ul>
+</div>
+      </section>
+
+
 
 
 
@@ -560,6 +571,33 @@ <h4 class="param-title">
 
 
 
+  <div class="param-list">
+    <h4 class="param-title">
+
+
+        <span class="item-name">$do:</span>
+
+      <span class="item-value">null</span>
+      <span class="value-type">(map |<span class="widont">&nbsp;</span>null)</span>
+
+    </h4>
+
+
+
+      <div class="param-details text-block">
+        <p>A map of function/ratio adjustments to run on the returned<span class="widont">&nbsp;</span>value</p>
+
+      </div>
+
+  </div>
+
+
+
+
+
+
+
+
   <div class="param-list">
     <h4 class="param-title">
 
@@ -1144,8 +1182,10 @@ <h2 class="item-title">
 
       <section class="summary-subsection">
         <h3 class="summary-subtitle">Since <code>0.1.0</code>:</h3>
-        <div class="subsection-details"><p>Uses the new <a href="core.html">shared</a> map syntax,
-for internal references and<span class="widont">&nbsp;</span>adjustments</p>
+        <div class="subsection-details"><ul>
+<li>BREAKING: Uses the new <a href="core.html">shared</a> map syntax,
+for internal references and<span class="widont">&nbsp;</span>adjustments</li>
+</ul>
 </div>
       </section>