Improve typescript return types

.github/ISSUE_TEMPLATE/---bug--npm-packages--.md

@@ -0,0 +1,33 @@
+---
+name: "\U0001F41B Bug [npm packages] "
+about: Report a problem with the @leonardo-contrast-colors module
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+## Description
+<!-- Describe the problem you're having -->
+
+
+## Steps to reproduce
+<!-- Include code examples or error messages if you have them -->
+
+
+## Expected behavior
+<!-- Describe what you expected to happen -->
+
+
+## Screenshots
+<!-- If applicable, add screenshots to help explain the problem -->
+
+## Leonardo package and version
+<!--ie:  **@leonardo-contrast-colors version:**  2.13.0 -->
+
+
+## Environment
+ - **Browser(s) and OS(s):** <!-- Chrome 75.0.3770.142 on Win 10 -->
+
+## Additional context
+<!-- Provide any additional information that might help us debug the issue -->

.github/ISSUE_TEMPLATE/--bug-web-tool.md

@@ -0,0 +1,33 @@
+---
+name: "\U0001F41B Bug [Web Tool] "
+about: Report a problem with the Leonardo web interface
+title: ''
+labels: UI, bug
+assignees: ''
+
+---
+
+## Description
+<!-- Describe the problem you're having -->
+
+
+## Steps to reproduce
+
+1. Go to http://leonardocolor.io/
+2. Click on ...
+3. Observe ...
+
+
+## Expected behavior
+<!-- Describe what you expected to happen -->
+
+
+## Screenshots
+<!-- If applicable, add screenshots to help explain the problem -->
+
+
+## Environment
+ - **Browser(s) and OS(s):** <!-- Chrome 75.0.3770.142 on Win 10 -->
+
+## Additional context
+<!-- Provide any additional information that might help us debug the issue -->

.github/ISSUE_TEMPLATE/--feature-request--npm-packages-.md

@@ -0,0 +1,23 @@
+---
+name: "✨ Feature request [npm packages]"
+about: Suggest a new feature for the Leonardo npm modules
+title: ''
+labels: enhancement, npm packages
+assignees: ''
+
+---
+
+## Description
+<!-- Describe your suggested feature in detail -->
+
+
+## Why do you need this feature?
+<!-- Tell us what this solves or why this is important to your use case -->
+
+
+## Leonardo package and version
+<!--ie:  **@leonardo-contrast-colors version:**  2.13.0 -->
+
+
+## Additional context
+<!-- Add any other context, workarounds, or screenshots about your request -->

.github/ISSUE_TEMPLATE/--feature-web-tool.md

@@ -0,0 +1,19 @@
+---
+name: "✨ Feature request [Web Tool]"
+about: Suggest a new feature for the Leonardo web interface
+title: ''
+labels: UI, enhancement
+assignees: ''
+
+---
+
+## Description
+<!-- Describe your suggested feature in detail -->
+
+
+## Why do you need this feature?
+<!-- Tell us what this solves or why this is important to your use case -->
+
+
+## Additional context
+<!-- Add any other context, workarounds, or screenshots about your request -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -3,8 +3,8 @@
 ## Description
 <!--
   Note: Before sending a pull request, make sure there's an issue for what you're changing
-   - Search for issues: https://github.com/adobe/contrast/issues
-   - If there's no issue, file it: https://github.com/adobe/contrast/issues/new/choose
+   - Search for issues: https://github.com/adobe/leonardo/issues
+   - If there's no issue, file it: https://github.com/adobe/leonardo/issues/new/choose
 -->
 <!-- Describe what you changed and link to the relevant issue(s) -->
 

README.md

@@ -1,5 +1,9 @@
 ![Leonardo logo](.github/Leonardo_Logo.png)
 
+[![npm version](https://badge.fury.io/js/%40adobe%2Fleonardo-contrast-colors.svg)](https://www.npmjs.com/package/@adobe/leonardo-contrast-colors)
+[![license](https://img.shields.io/github/license/adobe/leonardo)](https://github.com/adobe/leonardo/blob/master/LICENSE)
+[![Pull requests welcome](https://img.shields.io/badge/PRs-welcome-blueviolet)](https://github.com/adobe/leonardo/blob/master/.github/CONTRIBUTING.md) [![Web UI](https://img.shields.io/badge/web%20tool-leonardocolor.io-blue)](https://leonardocolor.io)
+
 # Leonardo
 Authoring [adaptive color palettes](#what-is-adaptive-color) for generating color based on a desired contrast ratio.
 
@@ -8,15 +12,14 @@ For a detailed walkthrough of Leonardo, [check out this article](https://medium.
 ## Project Goals
 To make it easier for designers and engineers to leverage color science to create custom interpolations for a value scale, and to make it easier for designers and engineers to conform to [WCAG minimum contrast standards](https://www.w3.org/TR/WCAG21/#contrast-minimum) by using contrast ratio as the starting point, rather than a post-color-selection auditing process.
 
-1. [Leonardo web application](leonardo-web-application)
+1. [Leonardo web application](#leonardo-web-application)
 2. [Show me a demo](#show-me-a-demo)
 3. [What is "adaptive color"?](#what-is-adaptive-color)
 4. [Using Leonardo](#using-leonardo)
-5. [API Reference](#api-reference)
-6. [Why are not all contrast ratios available?](#why-are-not-all-contrast-ratios-available)
-7. [D3 Color](#d3-color)
-8. [Contributing](#contributing)
-9. [Licensing](#licensing)
+5. [Why are not all contrast ratios available?](#why-are-not-all-contrast-ratios-available)
+6. [D3 Color](#d3-color)
+7. [Contributing](#contributing)
+8. [Licensing](#licensing)
 
 
 ## Leonardo web application
@@ -67,5 +70,36 @@ The Leonardo web app leverages d3 for additional features such as generating 2d
 ## Contributing
 Contributions are welcomed! Read the [Contributing Guide](./.github/CONTRIBUTING.md) for more information.
 
+## Development
+
+To get started [developing Leonardo UI](packages/ui#development):
+
+*Note: [Yarn](https://yarnpkg.com/) must be installed on your machine*
+
+```sh
+# Install dependencies
+yarn install
+
+# Change directory to Leonardo UI
+cd packages/ui
+
+# Run local server
+yarn dev
+```
+
+To get started [developing Leonardo `contrast-colors` package](packages/contrast-colors#development):
+
+```sh
+# From root, change directory to contrast-colors
+cd packages/contrast-colors
+
+# Run tests and watch for changes
+yarn dev
+```
+
+Then, visit the live reloading web UIs here:
+http://localhost:1234/index.html
+http://localhost:1234/demo.html
+
 ## Licensing
 This project is licensed under the Apache V2 License. See [LICENSE](LICENSE) for more information.

cssnano.config.js

@@ -0,0 +1,14 @@
+module.exports = {
+  preset: [
+    "default",
+    {
+      svgo: {
+        plugins: [
+          {
+            convertStyleToAttrs: false
+          }
+        ]
+      }
+    }
+  ]
+};

packages/contrast-colors/.npmignore

@@ -0,0 +1,2 @@
+node_modules/
+test/

packages/contrast-colors/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [1.0.0-alpha.8](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.7...@adobe/leonardo-contrast-colors@1.0.0-alpha.8) (2020-09-08)
+
+**Note:** Version bump only for package @adobe/leonardo-contrast-colors
+
+
+
+
+
+# [1.0.0-alpha.7](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.6...@adobe/leonardo-contrast-colors@1.0.0-alpha.7) (2020-08-18)
+
+**Note:** Version bump only for package @adobe/leonardo-contrast-colors
+
+
+
+
+
+# [1.0.0-alpha.6](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.5...@adobe/leonardo-contrast-colors@1.0.0-alpha.6) (2020-08-12)
+
+**Note:** Version bump only for package @adobe/leonardo-contrast-colors
+
+
+
+
+
+# [1.0.0-alpha.5](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.4...@adobe/leonardo-contrast-colors@1.0.0-alpha.5) (2020-05-04)
+
+
+### Bug Fixes
+
+* ensured smooth is false by default & verified tests passing and UI not impacted by addition ([9722d5b](https://github.com/adobe/leonardo/commit/9722d5b422e60c62243cfae58f21bafbb286854c))
+* remove Babel, use ESM wrapper approach for Node 13.x ESM support + CJS support ([#72](https://github.com/adobe/leonardo/issues/72)) ([7541dc1](https://github.com/adobe/leonardo/commit/7541dc1189403039b900ef08ca82023d31063b58))
+
+
+
+
+
+# [1.0.0-alpha.4](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.3...@adobe/leonardo-contrast-colors@1.0.0-alpha.4) (2020-02-28)
+
+**Note:** Version bump only for package @adobe/leonardo-contrast-colors
+
+
+
+
+
+# [1.0.0-alpha.3](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.2...@adobe/leonardo-contrast-colors@1.0.0-alpha.3) (2020-01-21)
+
+
+### Bug Fixes
+
+* corrected midtone color outputs ([#46](https://github.com/adobe/leonardo/issues/46)) ([5c780b7](https://github.com/adobe/leonardo/commit/5c780b7a1f0355f985591076a27f1764e1faee3c))
+
+
+
+
+
+# [1.0.0-alpha.2](https://github.com/adobe/leonardo/compare/@adobe/leonardo-contrast-colors@1.0.0-alpha.1...@adobe/leonardo-contrast-colors@1.0.0-alpha.2) (2019-12-12)
+
+
+### Bug Fixes
+
+* **contrast-colors:** Add d3 as dependency ([#25](https://github.com/adobe/leonardo/issues/25)) ([34940e0](https://github.com/adobe/leonardo/commit/34940e00f52fa69b413b7c882a79c4d158b19a3b))
+
+
+
+
+
+# 1.0.0-alpha.1 (2019-12-09)
+
+
+### Features
+
+* added throw error for testing missing parameters ([#90](https://github.com/adobe/leonardo/issues/90)) ([2f5dff7](https://github.com/adobe/leonardo/commit/2f5dff7ced7756ef860ba9e5e661cf5fc1e20a2e))