govuk_publishing_components 17.21.0 → 18.0.0

data/node_modules/govuk-frontend/components/tag/_tag.scss

@@ -1,33 +0,0 @@
-@import "../../settings/all";
-@import "../../tools/all";
-@import "../../helpers/all";
-
-@include govuk-exports("govuk/component/tag") {
-  .govuk-tag {
-    @include govuk-font($size: 16, $weight: bold, $line-height: 1.25);
-
-    display: inline-block;
-    padding: 4px 8px;
-    // Since New Transport sits slightly higher than other common fonts.
-    // We use intentionally uneven padding to make it balanced, this can be
-    // removed using the version of the font that has a more common vertical spacing.
-    padding-bottom: 1px;
-
-    // When a user customises their colours often the background is removed,
-    // by adding a outline we ensure that the tag component still keeps it's meaning.
-    // https://accessibility.blog.gov.uk/2017/03/27/how-users-change-colours-on-websites/
-    outline: 2px solid transparent;
-    outline-offset: -2px;
-
-    color: govuk-colour("white");
-    background-color: govuk-colour("blue");
-    letter-spacing: 1px;
-
-    text-decoration: none;
-    text-transform: uppercase;
-  }
-
-  .govuk-tag--inactive {
-    background-color: govuk-colour("grey-1");
-  }
-}

data/node_modules/govuk-frontend/components/textarea/_textarea.scss

@@ -1,32 +0,0 @@
-@import "../../settings/all";
-@import "../../tools/all";
-@import "../../helpers/all";
-
-@import "../error-message/error-message";
-@import "../hint/hint";
-@import "../label/label";
-
-@include govuk-exports("govuk/component/textarea") {
-  .govuk-textarea {
-    @include govuk-font($size: 19, $line-height: 1.25);
-    @include govuk-focusable;
-
-    box-sizing: border-box; // should this be global?
-    display: block;
-    width: 100%;
-    min-height: 40px;
-    @include govuk-responsive-margin(6, "bottom");
-    padding: govuk-spacing(1);
-
-    resize: vertical;
-
-    border: $govuk-border-width-form-element solid $govuk-input-border-colour;
-    border-radius: 0;
-
-    -webkit-appearance: none;
-  }
-
-  .govuk-textarea--error {
-    border: $govuk-border-width-form-element-error solid $govuk-error-colour;
-  }
-}

data/node_modules/govuk-frontend/helpers/_focusable.scss

@@ -1,34 +0,0 @@
-////
-/// @group helpers
-////
-
-/// Focusable helper
-///
-/// Provides an additional outline to clearly indicate when the target element is
-/// focussed. Used for interactive elements which themselves have some background
-/// or border, such as most form elements.
-///
-/// @access public
-
-@mixin govuk-focusable {
-  &:focus {
-    outline: $govuk-focus-width solid $govuk-focus-colour;
-    outline-offset: 0;
-  }
-}
-
-/// Focusable with fill helper
-///
-/// Provides an additional outline and background colour to clearly indicate when
-/// the target element is focussed. Used for interactive text-based elements such
-/// as links.
-///
-/// @access public
-
-@mixin govuk-focusable-fill {
-  &:focus {
-    outline: $govuk-focus-width solid $govuk-focus-colour;
-    outline-offset: 0;
-    background-color: $govuk-focus-colour;
-  }
-}

data/node_modules/govuk-frontend/helpers/_font-faces.scss

@@ -1,67 +0,0 @@
-////
-/// @group helpers
-////
-
-// Disables linting for this file only
-// sass-lint:disable no-css-comments, no-duplicate-properties, property-sort-order, indentation
-
-@import "../tools/exports";
-
-/// Font Face - NTA
-///
-/// Outputs the font-face declaration for NTA at the root of the CSS document
-/// the first time it is called.
-///
-/// @access private
-
-@mixin _govuk-font-face-nta {
-  @include govuk-exports("govuk/helpers/font-face") {
-    @at-root {
-      /*! Copyright (c) 2011 by Margaret Calvert & Henrik Kubel. All rights reserved. The font has been customised for exclusive use on gov.uk. This cut is not commercially available. */
-
-      @font-face {
-        font-family: "nta";
-        src: govuk-font-url("light-2c037cf7e1-v1.eot");
-        src: govuk-font-url("light-2c037cf7e1-v1.eot?#iefix") format("embedded-opentype"),
-             govuk-font-url("light-f38ad40456-v1.woff2") format("woff2"),
-             govuk-font-url("light-458f8ea81c-v1.woff") format("woff");
-        font-weight: normal;
-        font-style: normal;
-        font-display: fallback;
-      }
-
-      @font-face {
-        font-family: "nta";
-        src: govuk-font-url("bold-fb2676462a-v1.eot");
-        src: govuk-font-url("bold-fb2676462a-v1.eot?#iefix") format("embedded-opentype"),
-             govuk-font-url("bold-a2452cb66f-v1.woff2") format("woff2"),
-             govuk-font-url("bold-f38c792ac2-v1.woff") format("woff");
-        font-weight: bold;
-        font-style: normal;
-        font-display: fallback;
-      }
-
-      @font-face {
-        font-family: "ntatabularnumbers";
-        src: govuk-font-url("light-tabular-498ea8ffe2-v1.eot");
-        src: govuk-font-url("light-tabular-498ea8ffe2-v1.eot?#iefix") format("embedded-opentype"),
-             govuk-font-url("light-tabular-851b10ccdd-v1.woff2") format("woff2"),
-             govuk-font-url("light-tabular-62cc6f0a28-v1.woff") format("woff");
-        font-weight: normal;
-        font-style: normal;
-        font-display: fallback;
-      }
-
-      @font-face {
-        font-family: "ntatabularnumbers";
-        src: govuk-font-url("bold-tabular-357fdfbcc3-v1.eot");
-        src: govuk-font-url("bold-tabular-357fdfbcc3-v1.eot?#iefix") format("embedded-opentype"),
-             govuk-font-url("bold-tabular-b89238d840-v1.woff2") format("woff2"),
-             govuk-font-url("bold-tabular-784c21afb8-v1.woff") format("woff");
-        font-weight: bold;
-        font-style: normal;
-        font-display: fallback;
-      }
-    }
-  }
-}

data/node_modules/govuk-frontend/helpers/_grid.scss

@@ -1,107 +0,0 @@
-////
-/// @group helpers
-////
-
-/// Grid width percentage
-///
-/// @param {String} $key - Name of grid width (e.g. two-thirds)
-/// @return {Number} Percentage width
-/// @throw if `$key` is not a valid grid width
-/// @access public
-
-@function govuk-grid-width($key) {
-  @if map-has-key($govuk-grid-widths, $key) {
-    @return map-get($govuk-grid-widths, $key);
-  }
-
-  @error "Unknown grid width `#{$key}`";
-}
-
-/// Grid width percentage (alias)
-///
-/// @alias govuk-grid-width
-/// @deprecated To be removed in v3.0, replaced by govuk-grid-width
-@function grid-width($key) {
-  @return govuk-grid-width($key);
-}
-
-/// Generate grid row styles
-///
-/// Creates a grid row class with a standardised margin.
-///
-/// @param {String} $class [govuk-grid-row] CSS class name
-///
-/// @example scss - Default
-///   @include govuk-grid-row;
-///
-/// @example scss - Customising the class name
-///   @include govuk-grid-row("app-grid");
-///
-/// @access public
-/// @deprecated To be removed in v3.0, replaced by the govuk-grid-row class
-
-@mixin govuk-grid-row($class: "govuk-grid-row") {
-  .#{$class} {
-    @include govuk-clearfix;
-    margin-right: - ($govuk-gutter-half);
-    margin-left: - ($govuk-gutter-half);
-  }
-}
-
-/// Generate grid column styles
-///
-/// Creates a grid column with standard gutter between the columns.
-///
-/// If a `$class` is provided (which is the default, but deprecated behaviour),
-/// the generated rules will be wrapped in a predefined selector in the format
-/// `$class-$width` (e.g. `govuk-grid-column-full`). This behaviour is
-/// deprecated and will be removed in v3.0
-///
-/// Grid widths are defined in the `$govuk-grid-widths` map.
-///
-/// By default the column width changes from 100% to specified width at the
-/// 'tablet' breakpoint, but other breakpoints can be specified using the `$at`
-/// parameter.
-///
-/// @param {String} $width [full] name of a grid width from $govuk-grid-widths
-/// @param {String} $float [left] left | right
-/// @param {String} $at [tablet] - mobile | tablet | desktop | any custom breakpoint
-/// @param {String} $class [govuk-grid-column] CSS class name (deprecated)
-///
-/// @example scss - Default
-///   .govuk-grid-column-two-thirds {
-///     @include govuk-grid-column(two-thirds, $class: false)
-///   }
-///
-/// @example scss - Customising the breakpoint where width percentage is applied
-///   .govuk-grid-column-one-half-at-desktop {
-///     @include govuk-grid-column(one-half, $at: desktop);
-///   }
-///
-/// @example scss - Customising the float direction
-///   .govuk-grid-column-one-half-right {
-///     @include govuk-grid-column(two-thirds, $float: right, $class: false);
-///   }
-///
-/// @example scss - Customising the class name (deprecated)
-///   @include govuk-grid-column(one-half, $class: "test-column");
-///
-/// @access public
-
-@mixin govuk-grid-column($width: full, $float: left, $at: tablet, $class: "govuk-grid-column") {
-  @if ($class) {
-    .#{$class}-#{$width} {
-      @include govuk-grid-column($width, $float, $at, $class: false);
-    }
-  } @else {
-    box-sizing: border-box;
-    @if $at != desktop {
-      width: 100%;
-    }
-    padding: 0 $govuk-gutter-half;
-    @include govuk-media-query($from: $at) {
-      width: govuk-grid-width($width);
-      float: $float;
-    }
-  }
-}

data/node_modules/govuk-frontend/settings/_colours-palette.scss

@@ -1,37 +0,0 @@
-////
-/// @group settings/colours
-////
-
-/// Colour palette
-///
-/// @type Map
-///
-/// @prop $colour - Representation for the given $colour, where $colour is the
-///   friendly name for the colour (e.g. "red": #ff0000);
-///
-/// @access public
-
-$govuk-colours: (
-  "purple": #2e358b,
-  "light-purple": #6f72af,
-  "bright-purple": #912b88,
-  "pink": #d53880,
-  "light-pink": #f499be,
-  "red": #b10e1e,
-  "bright-red": #df3034,
-  "orange": #f47738,
-  "brown": #b58840,
-  "yellow": #ffbf47,
-  "light-green": #85994b,
-  "green": #006435,
-  "turquoise": #28a197,
-  "light-blue": #2b8cc4,
-  "blue": #005ea5,
-
-  "black": #0b0c0c,
-  "grey-1": #6f777b,
-  "grey-2": #bfc1c3,
-  "grey-3": #dee0e2,
-  "grey-4": #f8f8f8,
-  "white": #ffffff
-) !default;

data/node_modules/govuk-frontend/settings/_compatibility.scss

@@ -1,51 +0,0 @@
-////
-/// Compatibility with legacy repos (govuk_elements, govuk_frontend_tookkit and
-/// govuk_template) settings
-///
-/// We default these settings to `true` so that if they are missed we opt for a
-/// mild performance hit over a potential broken experience for the end-user.
-///
-/// @group settings/compatibility
-////
-
-
-/// Compatibility Mode: alphagov/govuk_frontend_toolkit
-///
-/// True if used in a project that also includes alphagov/govuk_frontend_toolkit.
-///
-/// @type Boolean
-/// @access public
-
-$govuk-compatibility-govukfrontendtoolkit: false !default;
-
-/// Compatibility Mode: alphagov/govuk_template
-///
-/// True if used in a project that also includes alphagov/govuk_template.
-///
-/// @type Boolean
-/// @access public
-
-$govuk-compatibility-govuktemplate: false !default;
-
-/// Compatibility Mode: alphagov/govuk_elements
-///
-/// True if used in a project that also includes alphagov/govuk_elements.
-///
-/// @type Boolean
-/// @access public
-
-$govuk-compatibility-govukelements: false !default;
-
-/// Compatibility Product Map
-///
-/// Maps product names to their settings that we can use to lookup states from
-/// within the `@govuk-compatibility` mixin.
-///
-/// @type Map
-/// @access private
-
-$_govuk-compatibility: (
-  govuk_frontend_toolkit: $govuk-compatibility-govukfrontendtoolkit,
-  govuk_template: $govuk-compatibility-govuktemplate,
-  govuk_elements: $govuk-compatibility-govukelements,
-);

data/node_modules/preact/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2015-present Jason Miller
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

data/node_modules/preact/README.md

@@ -1,592 +0,0 @@
-<p align="center">
-<a href="https://preactjs.com" target="_blank">
-	
-![Preact](https://raw.githubusercontent.com/developit/preact/8b0bcc927995c188eca83cba30fbc83491cc0b2f/logo.svg?sanitize=true "Preact")
-
-</a>
-</p>
-<p align="center">Fast <b>3kB</b> alternative to React with the same modern API.</p>
-
-**All the power of Virtual DOM components, without the overhead:**
-
-- Familiar React API & patterns: [ES6 Class] and [Functional Components]
-- Extensive React compatibility via a simple [preact-compat] alias
-- Everything you need: JSX, <abbr title="Virtual DOM">VDOM</abbr>, React DevTools, <abbr title="Hot Module Replacement">HMR</abbr>, <abbr title="Server-Side Rendering">SSR</abbr>..
-- A highly optimized diff algorithm and seamless Server Side Rendering
-- Transparent asynchronous rendering with a pluggable scheduler
-- 🆕💥 **Instant no-config app bundling with [Preact CLI](https://github.com/developit/preact-cli)**
-
-### 💁 More information at the [Preact Website ➞](https://preactjs.com)
-
-
----
-
-<!-- TOC depthFrom:2 depthTo:6 withLinks:1 updateOnSave:1 orderedList:0 -->
-
-- [Demos](#demos)
-- [Libraries & Add-ons](#libraries--add-ons)
-- [Getting Started](#getting-started)
-	- [Import what you need](#import-what-you-need)
-	- [Rendering JSX](#rendering-jsx)
-	- [Components](#components)
-	- [Props & State](#props--state)
-- [Linked State](#linked-state)
-- [Examples](#examples)
-- [Extensions](#extensions)
-- [Debug Mode](#debug-mode)
-- [Backers](#backers)
-- [Sponsors](#sponsors)
-- [License](#license)
-
-<!-- /TOC -->
-
-
-# Preact
-
-[![npm](https://img.shields.io/npm/v/preact.svg)](http://npm.im/preact)
-[![CDNJS](https://img.shields.io/cdnjs/v/preact.svg)](https://cdnjs.com/libraries/preact)
-[![Preact Slack Community](https://preact-slack.now.sh/badge.svg)](https://preact-slack.now.sh)
-[![OpenCollective Backers](https://opencollective.com/preact/backers/badge.svg)](#backers)
-[![OpenCollective Sponsors](https://opencollective.com/preact/sponsors/badge.svg)](#sponsors)
-[![travis](https://travis-ci.org/developit/preact.svg?branch=master)](https://travis-ci.org/developit/preact)
-[![coveralls](https://img.shields.io/coveralls/developit/preact/master.svg)](https://coveralls.io/github/developit/preact)
-[![gzip size](http://img.badgesize.io/https://unpkg.com/preact/dist/preact.min.js?compression=gzip)](https://unpkg.com/preact/dist/preact.min.js)
-[![install size](https://packagephobia.now.sh/badge?p=preact)](https://packagephobia.now.sh/result?p=preact)
-
-Preact supports modern browsers and IE9+:
-
-[![Browsers](https://saucelabs.com/browser-matrix/preact.svg)](https://saucelabs.com/u/preact)
-
-
----
-
-
-## Demos
-
-#### Real-World Apps
-
-- [**Preact Hacker News**](https://hn.kristoferbaxter.com) _([GitHub Project](https://github.com/kristoferbaxter/preact-hn))_
-- [**Play.cash**](https://play.cash) :notes: _([GitHub Project](https://github.com/feross/play.cash))_
-- [**BitMidi**](https://bitmidi.com/) 🎹 Wayback machine for free MIDI files _([GitHub Project](https://github.com/feross/bitmidi.com))_
-- [**Ultimate Guitar**](https://www.ultimate-guitar.com) 🎸speed boosted by Preact.
-- [**ESBench**](http://esbench.com) is built using Preact.
-- [**BigWebQuiz**](https://bigwebquiz.com) _([GitHub Project](https://github.com/jakearchibald/big-web-quiz))_
-- [**Nectarine.rocks**](http://nectarine.rocks) _([GitHub Project](https://github.com/developit/nectarine))_ :peach:
-- [**TodoMVC**](https://preact-todomvc.surge.sh) _([GitHub Project](https://github.com/developit/preact-todomvc))_
-- [**OSS.Ninja**](https://oss.ninja) _([GitHub Project](https://github.com/developit/oss.ninja))_
-- [**GuriVR**](https://gurivr.com) _([GitHub Project](https://github.com/opennewslabs/guri-vr))_
-- [**Color Picker**](https://colors.now.sh) _([GitHub Project](https://github.com/lukeed/colors-app))_ :art:
-- [**Offline Gallery**](https://use-the-platform.com/offline-gallery/) _([GitHub Project](https://github.com/vaneenige/offline-gallery/))_ :balloon:
-- [**Periodic Weather**](https://use-the-platform.com/periodic-weather/) _([GitHub Project](https://github.com/vaneenige/periodic-weather/))_ :sunny:
-- [**Rugby News Board**](http://nbrugby.com) _[(GitHub Project)](https://github.com/rugby-board/rugby-board-node)_
-- [**Preact Gallery**](https://preact.gallery/) an 8KB photo gallery PWA built using Preact.
-- [**Rainbow Explorer**](https://use-the-platform.com/rainbow-explorer/) Preact app to translate real life color to digital color _([Github project](https://github.com/vaneenige/rainbow-explorer))_.
-- [**YASCC**](https://carlosqsilva.github.io/YASCC/#/) Yet Another SoundCloud Client _([Github project](https://github.com/carlosqsilva/YASCC))_.
-- [**Journalize**](https://preact-journal.herokuapp.com/) 14k offline-capable journaling PWA using preact. _([Github project](https://github.com/jpodwys/preact-journal))_.
-
-
-#### Runnable Examples
-
-- [**Flickr Browser**](http://codepen.io/developit/full/VvMZwK/) (@ CodePen)
-- [**Animating Text**](http://codepen.io/developit/full/LpNOdm/) (@ CodePen)
-- [**60FPS Rainbow Spiral**](http://codepen.io/developit/full/xGoagz/) (@ CodePen)
-- [**Simple Clock**](http://jsfiddle.net/developit/u9m5x0L7/embedded/result,js/) (@ JSFiddle)
-- [**3D + ThreeJS**](http://codepen.io/developit/pen/PPMNjd?editors=0010) (@ CodePen)
-- [**Stock Ticker**](http://codepen.io/developit/pen/wMYoBb?editors=0010) (@ CodePen)
-- [*Create your Own!*](https://jsfiddle.net/developit/rs6zrh5f/embedded/result/) (@ JSFiddle)
-
-### Starter Projects
-
-- [**Preact Boilerplate**](https://preact-boilerplate.surge.sh) _([GitHub Project](https://github.com/developit/preact-boilerplate))_ :zap:
-- [**Preact Offline Starter**](https://preact-starter.now.sh) _([GitHub Project](https://github.com/lukeed/preact-starter))_ :100:
-- [**Preact PWA**](https://preact-pwa-yfxiijbzit.now.sh/) _([GitHub Project](https://github.com/ezekielchentnik/preact-pwa))_ :hamburger:
-- [**Parcel + Preact + Unistore Starter**](https://github.com/hwclass/parcel-preact-unistore-starter)
-- [**Preact Mobx Starter**](https://awaw00.github.io/preact-mobx-starter/) _([GitHub Project](https://github.com/awaw00/preact-mobx-starter))_ :sunny:
-- [**Preact Redux Example**](https://github.com/developit/preact-redux-example) :star:
-- [**Preact Redux/RxJS/Reselect Example**](https://github.com/continuata/preact-seed)
-- [**V2EX Preact**](https://github.com/yanni4night/v2ex-preact)
-- [**Preact Coffeescript**](https://github.com/crisward/preact-coffee)
-- [**Preact + TypeScript + Webpack**](https://github.com/k1r0s/bleeding-preact-starter)
-- [**0 config => Preact + Poi**](https://github.com/k1r0s/preact-poi-starter)
-- [**Zero configuration => Preact + Typescript + Parcel**](https://github.com/aalises/preact-typescript-parcel-starter)
-
----
-
-## Libraries & Add-ons
-
-- :raised_hands: [**preact-compat**](https://git.io/preact-compat): use any React library with Preact *([full example](http://git.io/preact-compat-example))*
-- :twisted_rightwards_arrows: [**preact-context**](https://github.com/valotas/preact-context): React's `createContext` api for Preact
-- :page_facing_up: [**preact-render-to-string**](https://git.io/preact-render-to-string): Universal rendering.
-- :eyes: [**preact-render-spy**](https://github.com/mzgoddard/preact-render-spy): Enzyme-lite: Renderer with access to the produced virtual dom for testing.
-- :loop: [**preact-render-to-json**](https://git.io/preact-render-to-json): Render for Jest Snapshot testing.
-- :earth_americas: [**preact-router**](https://git.io/preact-router): URL routing for your components
-- :bookmark_tabs: [**preact-markup**](https://git.io/preact-markup): Render HTML & Custom Elements as JSX & Components
-- :satellite: [**preact-portal**](https://git.io/preact-portal): Render Preact components into (a) SPACE :milky_way:
-- :pencil: [**preact-richtextarea**](https://git.io/preact-richtextarea): Simple HTML editor component
-- :bookmark: [**preact-token-input**](https://github.com/developit/preact-token-input): Text field that tokenizes input, for things like tags
-- :card_index: [**preact-virtual-list**](https://github.com/developit/preact-virtual-list): Easily render lists with millions of rows ([demo](https://jsfiddle.net/developit/qqan9pdo/))
-- :repeat: [**preact-cycle**](https://git.io/preact-cycle): Functional-reactive paradigm for Preact
-- :triangular_ruler: [**preact-layout**](https://download.github.io/preact-layout/): Small and simple layout library
-- :thought_balloon: [**preact-socrates**](https://github.com/matthewmueller/preact-socrates): Preact plugin for [Socrates](http://github.com/matthewmueller/socrates)
-- :rowboat: [**preact-flyd**](https://github.com/xialvjun/preact-flyd): Use [flyd](https://github.com/paldepind/flyd) FRP streams in Preact + JSX
-- :speech_balloon: [**preact-i18nline**](https://github.com/download/preact-i18nline): Integrates the ecosystem around [i18n-js](https://github.com/everydayhero/i18n-js) with Preact via [i18nline](https://github.com/download/i18nline).
-- :microscope: [**preact-jsx-chai**](https://git.io/preact-jsx-chai): JSX assertion testing _(no DOM, right in Node)_
-- :tophat: [**preact-classless-component**](https://github.com/ld0rman/preact-classless-component): create preact components without the class keyword
-- :hammer: [**preact-hyperscript**](https://github.com/queckezz/preact-hyperscript): Hyperscript-like syntax for creating elements
-- :white_check_mark: [**shallow-compare**](https://github.com/tkh44/shallow-compare): simplified `shouldComponentUpdate` helper.
-- :shaved_ice: [**preact-codemod**](https://github.com/vutran/preact-codemod): Transform your React code to Preact.
-- :construction_worker: [**preact-helmet**](https://github.com/download/preact-helmet): A document head manager for Preact
-- :necktie: [**preact-delegate**](https://github.com/NekR/preact-delegate): Delegate DOM events
-- :art: [**preact-stylesheet-decorator**](https://github.com/k1r0s/preact-stylesheet-decorator): Add Scoped Stylesheets to your Preact Components
-- :electric_plug: [**preact-routlet**](https://github.com/k1r0s/preact-routlet): Simple `Component Driven` Routing for Preact using ES7 Decorators
-- :fax: [**preact-bind-group**](https://github.com/k1r0s/preact-bind-group): Preact Forms made easy, Group Events into a Single Callback
-- :hatching_chick: [**preact-habitat**](https://github.com/zouhir/preact-habitat): Declarative Preact widgets renderer in any CMS or DOM host ([demo](https://codepen.io/zouhir/pen/brrOPB)).
-- :tada: [**proppy-preact**](https://github.com/fahad19/proppy): Functional props composition for Preact components
-
-#### UI Component Libraries
-
-> Want to prototype something or speed up your development? Try one of these toolkits:
-
-- [**preact-material-components**](https://github.com/prateekbh/preact-material-components): Material Design Components for Preact ([website](https://material.preactjs.com/))
-- [**preact-mdc**](https://github.com/BerndWessels/preact-mdc): Material Design Components for Preact ([demo](https://github.com/BerndWessels/preact-mdc-demo))
-- [**preact-mui**](https://git.io/v1aVO): The MUI CSS Preact library.
-- [**preact-photon**](https://git.io/preact-photon): build beautiful desktop UI with [photon](http://photonkit.com)
-- [**preact-mdl**](https://git.io/preact-mdl): [Material Design Lite](https://getmdl.io) for Preact
-- [**preact-weui**](https://github.com/afeiship/preact-weui): [Weui](https://github.com/afeiship/preact-weui) for Preact
-
-
----
-
-## Getting Started
-
-> 💁 _**Note:** You [don't need ES2015 to use Preact](https://github.com/developit/preact-in-es3)... but give it a try!_
-
-The easiest way to get started with Preact is to install [Preact CLI](https://github.com/developit/preact-cli). This simple command-line tool wraps up the best possible Webpack and Babel setup for you, and even keeps you up-to-date as the underlying tools change. Best of all, it's easy to understand! It builds your app in a single command (`preact build`), doesn't need any configuration, and bakes in best-practises 🙌.
-
-The following guide assumes you have some sort of ES2015 build set up using babel and/or webpack/browserify/gulp/grunt/etc.
-
-You can also start with [preact-boilerplate] or a [CodePen Template](http://codepen.io/developit/pen/pgaROe?editors=0010).
-
-
-### Import what you need
-
-The `preact` module provides both named and default exports, so you can either import everything under a namespace of your choosing, or just what you need as locals:
-
-##### Named:
-
-```js
-import { h, render, Component } from 'preact';
-
-// Tell Babel to transform JSX into h() calls:
-/** @jsx h */
-```
-
-##### Default:
-
-```js
-import preact from 'preact';
-
-// Tell Babel to transform JSX into preact.h() calls:
-/** @jsx preact.h */
-```
-
-> Named imports work well for highly structured applications, whereas the default import is quick and never needs to be updated when using different parts of the library.
->
-> Instead of declaring the `@jsx` pragma in your code, it's best to configure it globally in a `.babelrc`:
->
-> **For Babel 5 and prior:**
->
-> ```json
-> { "jsxPragma": "h" }
-> ```
->
-> **For Babel 6:**
->
-> ```json
-> {
->   "plugins": [
->     ["transform-react-jsx", { "pragma":"h" }]
->   ]
-> }
-> ```
->
-> **For Babel 7:**
->
-> ```json
-> {
->   "plugins": [
->     ["@babel/plugin-transform-react-jsx", { "pragma":"h" }]
->   ]
-> }
-> ```
-> **For using Preact along with TypeScript add to `tsconfig.json`:**
->
-> ```json
-> {
->   "jsx": "react",
->   "jsxFactory": "h",
-> }
-> ```
-
-
-### Rendering JSX
-
-Out of the box, Preact provides an `h()` function that turns your JSX into Virtual DOM elements _([here's how](http://jasonformat.com/wtf-is-jsx))_. It also provides a `render()` function that creates a DOM tree from that Virtual DOM.
-
-To render some JSX, just import those two functions and use them like so:
-
-```js
-import { h, render } from 'preact';
-
-render((
-	<div id="foo">
-		<span>Hello, world!</span>
-		<button onClick={ e => alert("hi!") }>Click Me</button>
-	</div>
-), document.body);
-```
-
-This should seem pretty straightforward if you've used hyperscript or one of its many friends. If you're not, the short of it is that the `h()` function import gets used in the final, transpiled code as a drop in replacement for `React.createElement()`, and so needs to be imported even if you don't explicitly use it in the code you write. Also note that if you're the kind of person who likes writing your React code in "pure JavaScript" (you know who you are) you will need to use `h()` wherever you would otherwise use `React.createElement()`.
-
-Rendering hyperscript with a virtual DOM is pointless, though. We want to render components and have them updated when data changes - that's where the power of virtual DOM diffing shines. :star2:
-
-
-### Components
-
-Preact exports a generic `Component` class, which can be extended to build encapsulated, self-updating pieces of a User Interface.  Components support all of the standard React [lifecycle methods], like `shouldComponentUpdate()` and `componentWillReceiveProps()`.  Providing specific implementations of these methods is the preferred mechanism for controlling _when_ and _how_ components update.
-
-Components also have a `render()` method, but unlike React this method is passed `(props, state)` as arguments. This provides an ergonomic means to destructure `props` and `state` into local variables to be referenced from JSX.
-
-Let's take a look at a very simple `Clock` component, which shows the current time.
-
-```js
-import { h, render, Component } from 'preact';
-
-class Clock extends Component {
-	render() {
-		let time = new Date();
-		return <time datetime={time.toISOString()}>{ time.toLocaleTimeString() }</time>;
-	}
-}
-
-// render an instance of Clock into <body>:
-render(<Clock />, document.body);
-```
-
-
-That's great. Running this produces the following HTML DOM structure:
-
-```html
-<span>10:28:57 PM</span>
-```
-
-In order to have the clock's time update every second, we need to know when `<Clock>` gets mounted to the DOM. _If you've used HTML5 Custom Elements, this is similar to the `attachedCallback` and `detachedCallback` lifecycle methods._ Preact invokes the following lifecycle methods if they are defined for a Component:
-
-| Lifecycle method            | When it gets called                              |
-|-----------------------------|--------------------------------------------------|
-| `componentWillMount`        | before the component gets mounted to the DOM     |
-| `componentDidMount`         | after the component gets mounted to the DOM      |
-| `componentWillUnmount`      | prior to removal from the DOM                    |
-| `componentWillReceiveProps` | before new props get accepted                    |
-| `shouldComponentUpdate`     | before `render()`. Return `false` to skip render |
-| `componentWillUpdate`       | before `render()`                                |
-| `componentDidUpdate`        | after `render()`                                 |
-
-
-
-So, we want to have a 1-second timer start once the Component gets added to the DOM, and stop if it is removed. We'll create the timer and store a reference to it in `componentDidMount()`, and stop the timer in `componentWillUnmount()`. On each timer tick, we'll update the component's `state` object with a new time value. Doing this will automatically re-render the component.
-
-```js
-import { h, render, Component } from 'preact';
-
-class Clock extends Component {
-	constructor() {
-		super();
-		// set initial time:
-		this.state = {
-			time: Date.now()
-		};
-	}
-
-	componentDidMount() {
-		// update time every second
-		this.timer = setInterval(() => {
-			this.setState({ time: Date.now() });
-		}, 1000);
-	}
-
-	componentWillUnmount() {
-		// stop when not renderable
-		clearInterval(this.timer);
-	}
-
-	render(props, state) {
-		let time = new Date(state.time).toLocaleTimeString();
-		return <span>{ time }</span>;
-	}
-}
-
-// render an instance of Clock into <body>:
-render(<Clock />, document.body);
-```
-
-Now we have [a ticking clock](http://jsfiddle.net/developit/u9m5x0L7/embedded/result,js/)!
-
-
-### Props & State
-
-The concept (and nomenclature) for `props` and `state` is the same as in React. `props` are passed to a component by defining attributes in JSX, `state` is internal state. Changing either triggers a re-render, though by default Preact re-renders Components asynchronously for `state` changes and synchronously for `props` changes.  You can tell Preact to render `prop` changes asynchronously by setting `options.syncComponentUpdates` to `false`.
-
-
----
-
-
-## Linked State
-
-One area Preact takes a little further than React is in optimizing state changes. A common pattern in ES2015 React code is to use Arrow functions within a `render()` method in order to update state in response to events.  Creating functions enclosed in a scope on every render is inefficient and forces the garbage collector to do more work than is necessary.
-
-One solution to this is to bind component methods declaratively.
-Here is an example using [decko](http://git.io/decko):
-
-```js
-class Foo extends Component {
-	@bind
-	updateText(e) {
-		this.setState({ text: e.target.value });
-	}
-	render({ }, { text }) {
-		return <input value={text} onInput={this.updateText} />;
-	}
-}
-```
-
-While this achieves much better runtime performance, it's still a lot of unnecessary code to wire up state to UI.
-
-Fortunately there is a solution, in the form of a module called [linkstate](https://github.com/developit/linkstate). Calling `linkState(component, 'text')` returns a function that accepts an Event and uses its associated value to update the given property in your component's state. Calls to `linkState()` with the same arguments are cached, so there is no performance penalty.  Here is the previous example rewritten using _Linked State_:
-
-```js
-import linkState from 'linkstate';
-
-class Foo extends Component {
-	render({ }, { text }) {
-		return <input value={text} onInput={linkState(this, 'text')} />;
-	}
-}
-```
-
-Simple and effective. It handles linking state from any input type, or an optional second parameter can be used to explicitly provide a keypath to the new state value.
-
-> **Note:** In Preact 7 and prior, `linkState()` was built right into Component. In 8.0, it was moved to a separate module. You can restore the 7.x behavior by using linkstate as a polyfill - see [the linkstate docs](https://github.com/developit/linkstate#usage).
-
-
-
-## Examples
-
-Here is a somewhat verbose Preact `<Link>` component:
-
-```js
-class Link extends Component {
-	render(props, state) {
-		return <a href={props.href}>{props.children}</a>;
-	}
-}
-```
-
-Since this is ES6/ES2015, we can further simplify:
-
-```js
-class Link extends Component {
-    render({ href, children }) {
-        return <a {...{ href, children }} />;
-    }
-}
-
-// or, for wide-open props support:
-class Link extends Component {
-    render(props) {
-        return <a {...props} />;
-    }
-}
-
-// or, as a stateless functional component:
-const Link = ({ children, ...props }) => (
-    <a {...props}>{ children }</a>
-);
-```
-
-
-## Extensions
-
-It is likely that some projects based on Preact would wish to extend Component with great new functionality.
-
-Perhaps automatic connection to stores for a Flux-like architecture, or mixed-in context bindings to make it feel more like `React.createClass()`.  Just use ES2015 inheritance:
-
-```js
-class BoundComponent extends Component {
-	constructor(props) {
-		super(props);
-		this.bind();
-	}
-	bind() {
-		this.binds = {};
-		for (let i in this) {
-			this.binds[i] = this[i].bind(this);
-		}
-	}
-}
-
-// example usage
-class Link extends BoundComponent {
-	click() {
-		open(this.href);
-	}
-	render() {
-		let { click } = this.binds;
-		return <span onclick={ click }>{ children }</span>;
-	}
-}
-```
-
-
-The possibilities are pretty endless here. You could even add support for rudimentary mixins:
-
-```js
-class MixedComponent extends Component {
-	constructor() {
-		super();
-		(this.mixins || []).forEach( m => Object.assign(this, m) );
-	}
-}
-```
-
-## Debug Mode
-
-You can inspect and modify the state of your Preact UI components at runtime using the
-[React Developer Tools](https://github.com/facebook/react-devtools) browser extension.
-
-1. Install the [React Developer Tools](https://github.com/facebook/react-devtools) extension
-2. Import the "preact/debug" module in your app
-3. Set `process.env.NODE_ENV` to 'development'
-4. Reload and go to the 'React' tab in the browser's development tools
-
-
-```js
-import { h, Component, render } from 'preact';
-
-// Enable debug mode. You can reduce the size of your app by only including this
-// module in development builds. eg. In Webpack, wrap this with an `if (module.hot) {...}`
-// check.
-require('preact/debug');
-```
-
-### Runtime Error Checking
-
-To enable debug mode, you need to set `process.env.NODE_ENV=development`. You can do this
-with webpack via a builtin plugin.
-
-```js
-// webpack.config.js
-
-// Set NODE_ENV=development to enable error checking
-new webpack.DefinePlugin({
-  'process.env': {
-    'NODE_ENV': JSON.stringify('development')
-  }
-});
-```
-
-When enabled, warnings are logged to the console when undefined components or string refs
-are detected.
-
-### Developer Tools
-
-If you only want to include devtool integration, without runtime error checking, you can
-replace `preact/debug` in the above example with `preact/devtools`. This option doesn't
-require setting `NODE_ENV=development`.
-
-
-
-## Backers
-Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/preact#backer)]
-
-<a href="https://opencollective.com/preact/backer/0/website" target="_blank"><img src="https://opencollective.com/preact/backer/0/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/1/website" target="_blank"><img src="https://opencollective.com/preact/backer/1/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/2/website" target="_blank"><img src="https://opencollective.com/preact/backer/2/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/3/website" target="_blank"><img src="https://opencollective.com/preact/backer/3/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/4/website" target="_blank"><img src="https://opencollective.com/preact/backer/4/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/5/website" target="_blank"><img src="https://opencollective.com/preact/backer/5/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/6/website" target="_blank"><img src="https://opencollective.com/preact/backer/6/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/7/website" target="_blank"><img src="https://opencollective.com/preact/backer/7/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/8/website" target="_blank"><img src="https://opencollective.com/preact/backer/8/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/9/website" target="_blank"><img src="https://opencollective.com/preact/backer/9/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/10/website" target="_blank"><img src="https://opencollective.com/preact/backer/10/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/11/website" target="_blank"><img src="https://opencollective.com/preact/backer/11/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/12/website" target="_blank"><img src="https://opencollective.com/preact/backer/12/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/13/website" target="_blank"><img src="https://opencollective.com/preact/backer/13/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/14/website" target="_blank"><img src="https://opencollective.com/preact/backer/14/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/15/website" target="_blank"><img src="https://opencollective.com/preact/backer/15/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/16/website" target="_blank"><img src="https://opencollective.com/preact/backer/16/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/17/website" target="_blank"><img src="https://opencollective.com/preact/backer/17/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/18/website" target="_blank"><img src="https://opencollective.com/preact/backer/18/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/19/website" target="_blank"><img src="https://opencollective.com/preact/backer/19/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/20/website" target="_blank"><img src="https://opencollective.com/preact/backer/20/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/21/website" target="_blank"><img src="https://opencollective.com/preact/backer/21/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/22/website" target="_blank"><img src="https://opencollective.com/preact/backer/22/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/23/website" target="_blank"><img src="https://opencollective.com/preact/backer/23/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/24/website" target="_blank"><img src="https://opencollective.com/preact/backer/24/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/25/website" target="_blank"><img src="https://opencollective.com/preact/backer/25/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/26/website" target="_blank"><img src="https://opencollective.com/preact/backer/26/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/27/website" target="_blank"><img src="https://opencollective.com/preact/backer/27/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/28/website" target="_blank"><img src="https://opencollective.com/preact/backer/28/avatar.svg"></a>
-<a href="https://opencollective.com/preact/backer/29/website" target="_blank"><img src="https://opencollective.com/preact/backer/29/avatar.svg"></a>
-
-
-## Sponsors
-Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/preact#sponsor)]
-
-<a href="https://opencollective.com/preact/sponsor/0/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/0/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/1/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/1/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/2/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/2/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/3/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/3/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/4/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/4/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/5/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/5/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/6/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/6/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/7/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/7/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/8/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/8/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/9/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/9/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/10/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/10/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/11/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/11/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/12/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/12/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/13/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/13/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/14/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/14/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/15/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/15/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/16/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/16/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/17/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/17/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/18/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/18/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/19/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/19/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/20/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/20/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/21/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/21/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/22/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/22/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/23/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/23/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/24/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/24/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/25/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/25/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/26/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/26/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/27/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/27/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/28/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/28/avatar.svg"></a>
-<a href="https://opencollective.com/preact/sponsor/29/website" target="_blank"><img src="https://opencollective.com/preact/sponsor/29/avatar.svg"></a>
-
-## License
-
-MIT
-
-
-
-[![Preact](http://i.imgur.com/YqCHvEW.gif)](https://preactjs.com)
-
-
-[preact-compat]: https://github.com/developit/preact-compat
-[ES6 Class]: https://facebook.github.io/react/docs/reusable-components.html#es6-classes
-[Functional Components]: https://facebook.github.io/react/blog/2015/10/07/react-v0.14.html#stateless-functional-components
-[hyperscript]: https://github.com/dominictarr/hyperscript
-[preact-boilerplate]: https://github.com/developit/preact-boilerplate
-[lifecycle methods]: https://facebook.github.io/react/docs/component-specs.html