Ratio and Font variables, alpha release

.sassdocrc

@@ -7,15 +7,18 @@ display:
     - public
 
 groups:
-  'Core (Parser)':
+  'Core (API)':
     core: 'QuickStart: Core'
-    core-get: 'Accessing Maps'
-    core-vars: 'CSS Variables'
-    core-math: 'Math Helpers'
-    core-scale: 'Modular Scales'
-    core-lists: 'Sass List Utils'
-    core-strings: 'Sass String Utils'
+    core-get: 'Token Maps'
+    core-vars: 'Tokens » CSS Variables'
+    core-ratio: 'Ratios & Modular Scales'
+    core-ratio-vars: 'Ratios » CSS Variables'
+  'Core (Utilities)':
     core-register: 'Function Registration'
+    core-math: 'Math Functions'
+    core-lists: 'List Functions'
+    core-strings: 'String Functions'
+    core-inspect: 'Inspecting Tokens'
   'Init (Normalization)':
     init: 'QuickStart: Init'
     init-root: 'General'
@@ -25,35 +28,37 @@ groups:
     init-type: 'Type'
   'Plugin/Animate':
     animate: 'QuickStart: Animate'
-    animate-times: 'Durations & Delays'
-    animate-time-vars: 'CSS Time Variables'
-    animate-ease: 'Easing & Steps'
-    animate-ease-vars: 'CSS Easing Variables'
-    animate-change: 'Animations & Transitions'
-    animate-change-vars: 'CSS Change Variables'
+    animate-times: 'Timing Maps'
+    animate-time-vars: 'Times » CSS Variables'
+    animate-ease: 'Easing Maps'
+    animate-ease-vars: 'Easing » CSS Variables'
+    animate-change: 'Combined "Change" Maps'
+    animate-change-vars: 'Changes » CSS Variables'
   'Plugin/Color':
     color: 'QuickStart: Color'
-    color-api: 'Colors'
-    color-vars: 'CSS Color Variables'
+    color-api: 'Color Maps'
+    color-vars: 'Colors » CSS Variables'
     color-contrast: 'Contrast'
-    color-utils: 'Color Utils'
+    color-utils: 'Color Functions'
   'Plugin/Layout':
     layout: 'QuickStart: Layout'
+    layout-queries: 'Media Breakpoint Maps'
+    layout-query-vars: 'Breakpoints » CSS Variables'
     layout-box: 'Box-Sizing'
     layout-clearfix: 'Clearfix'
     layout-position: 'Positioning'
-    layout-queries: 'Media Queries'
     layout-ratios: 'Fluid Ratios'
     layout-z-index: 'Z-Index'
   'Plugin/Scale':
     scale: 'QuickStart: Scale'
-    scale-sizes: 'Sizes'
-    scale-vars: 'CSS Size Variables'
+    scale-sizes: 'Size Maps'
+    scale-vars: 'Sizes » CSS Variables'
     scale-units: 'Unit Conversion'
   'Plugin/Type':
     type: 'QuickStart: Type'
+    type-fonts: 'Font Maps'
+    type-font-vars: 'Fonts » CSS Variables'
     type-a11y: 'Accessibility'
-    type-fonts: 'Webfonts'
     type-pseudo: 'Pseudo Elements'
 
 

CHANGELOG.md

@@ -1,10 +1,83 @@
 # Accoutrement Changelog
 
+## 2.0.0 - UNRELEASED
+The 2.0 release is primarily focused on
+support for **CSS Custom Properties** (aka CSS Variables),
+and access to nested-map tokens with `#outside->inside` syntax.
+We've also added private tokens (`_token`),
+and various tools for token-inspection.
+All factory-default tokens (contrast-colors, named ratios, etc)
+are now marked as private,
+and will need to be called with a `_` prefix.
+See the full details below:
+
+### 2.0.0-alpha.1 - 10/29/18
+
+- [Core][core]:
+  - NEW: `$adjust-query-overlap` (`max` | `min` | `false`)
+    allows you to control if and how media-queries are adjusted
+    to avoid overlap between min/max queries
+    (thanks to @biw-joelschou)
+  - NEW: Support for integrating accoutrement tokens & CSS variables
+    with `tokens--()`, `token--()`, `var-token()`,
+    and plugin-specific shortcuts
+  - BREAKING: Token names starting with `_` or `-`
+    are considered "private" to Sass,
+    and will not be output when auto-generating CSS
+    (variables, font-names, etc.)
+  - BREAKING: Default ratio tokens are now prefixed with `_`
+    (search/replace e.g. `minor-third` -> `_minor-third`)
+    to avoid CSS-variable output
+  - NEW: `is-private-token()` and `is-alias-for()` are now public functions,
+    to help with token-inspection
+  - BREAKING: Support for nested-map tokens with `->` syntax,
+    both in `#hash->references` and `get-token($source, 'function->calls')`
+    (thanks to @biw-joelschou)
+- [Plugin: Animate][animate]
+  - BREAKING: Default easing tokens are now prefixed with `_`
+    (search/replace e.g. `in-out-quad` -> `_in-out-quad`)
+    to avoid CSS-variable output
+  - NEW: Support for easing CSS variables with
+    `easing--()`, `ease--()`, and `var-ease()`
+  - NEW: Support for time CSS variables with
+    `times--()`, `time--()`, and `var-time()`
+  - NEW: Support for change CSS variables with
+    `changes--()`, `change--()`, and `var-change()`
+- [Plugin: Color][color]
+  - BREAKING: `_contrast-light` and `_contrast-dark` colors are used
+    for mixing `tint()` and `shade()`,
+    with optional `$light`/`$dark` override parameters
+    (thanks to @biw-joelschou)
+  - NEW: Default `_contrast-light` and `_contrast-dark` provided,
+    set `_contrast-light`/`dark` in `$colors` to override
+  - NEW: Support for CSS Variables with
+    `colors--()`, `color--()`, and `var-color()`
+- [Plugin: Layout][layout]
+  - BREAKING: Default ratio tokens are now prefixed with `_`,
+    see core for details
+- [Plugin: Scale][scale]
+  - BREAKING: Default ratio tokens are now prefixed with `_`,
+    see core for details
+  - NEW: Support for size CSS Variables with
+    `sizes--()`, `size--()`, and `var-size()`
+  - NEW: Support for ratio variables with
+    `ratios--()`, `ratio--()`, and `var-ratio()`
+- [Plugin: Type][type]
+  - BREAKING: Non-map fonts are interpreted as font-stacks
+  - BREAKING: Normalized font-data uses proper name-quotation,
+    and ignores missing or private names/stacks
+  - BREAKING: `import-webfonts()` no longer imports private fonts,
+    but will import a direct alias of the private font
+  - NEW: `import-webfonts()` accepts `$source` parameter
+  - NEW: Support for CSS Variables with
+    `fonts--()`, `font--()`, and `var-font()`
+
 ## 1.0.1 - 09/08/18
-- BUGFIX: Typos, including the `cinema` ratio spelling
-  (thanks to @biw-joelschou)
-- BUGFIX: Improved consistency of nested-map parser
-  (thanks to @biw-joelschou)
+- [Core][core]:
+  - BUGFIX: Typos, including the `cinema` ratio spelling
+    (thanks to @biw-joelschou)
+  - BUGFIX: Improved consistency of nested-map parser
+    (thanks to @biw-joelschou)
 
 ## 1.0.0 - 08/08/18
 - The stable 1.0 release is identical to `-beta.3`,

README.md

@@ -90,7 +90,7 @@ $map: (
   'root': 16px,
 
   // internal reference & adjustments
-  'gutter': '#root' ('major-third': 1, 'convert-units': 'rem'),
+  'gutter': '#root' ('_major-third': 1, 'convert-units': 'rem'),
 );
 ```