Merge branch 'feature/update_build_process'

Author: fuchsvomwalde

.eslintcache

@@ -0,0 +1 @@
+{"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/Chart.js":{"size":99631,"mtime":1519567138149,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/Chart.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartArea.js":{"size":7044,"mtime":1519566862252,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartArea.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartAxis.js":{"size":14513,"mtime":1519566886373,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartAxis.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartAxisLabel.js":{"size":5761,"mtime":1519566914862,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartAxisLabel.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartDataPoint.js":{"size":8194,"mtime":1519566944144,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartDataPoint.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartLine.js":{"size":8129,"mtime":1519566965232,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartLine.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartSeries.js":{"size":16381,"mtime":1519566996708,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/ChartSeries.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/Color.js":{"size":3910,"mtime":1519567012968,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/Color.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}},"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/library.js":{"size":6537,"mtime":1519567043428,"hashOfConfig":"1083ajv","results":{"filePath":"/Users/Jascha/GitHub/ui5-lib-visualization/src/ui5/viz/library.js","messages":[],"errorCount":0,"warningCount":0,"fixableErrorCount":0,"fixableWarningCount":0}}}

.eslintignore

@@ -0,0 +1,4 @@
+# /node_modules/* and /bower_components/* ignored by default
+
+# Ignore ui5 dependencies
+src/ui5/viz/libs/*

.eslintrc.js

@@ -36,6 +36,7 @@ module.exports = {
     less: false,
     c3: false,
     d3: false,
-    _: false
+    lodashDebounce: false,
+    lodashIsequal: false
   }
 }

.gitignore

@@ -8,13 +8,14 @@
 /.vscode/
 
 ### Build Process ###
-/dist/
 /ui5/
 /.tmp/
 /.maps/
 /.download/
-/src/vendor-beta/*
 
+### Dist Files ###
+/dist/demo/
+/dist/ui5/viz/themes/**/*.less
 
 ### Node ###
 node_modules/

.settings/.jsdtscope

@@ -25,4 +25,5 @@ before_script:
 # no test task exist, yet, theirfore we test some other tasks (e.g. build)
 script:
   - yarn docs
+  - yarn test
   - yarn build:verbose

.settings/org.eclipse.wst.jsdt.ui.superType.container

@@ -5,13 +5,35 @@
 
 This library provides an OpenUI5 API that acts as a wrapper for D3-based charting library [C3.js](http://c3js.org/). It offers a more detailed and attractive API design than `sap.viz` chart controls, which interacts harmoniously especially in XML Views in combination with data binding.
 
+> Furthermore, this project is also a Boilerplate for all UI5 control libraries that rely completely on Open Source and uses 100% internally the same Gulp based build script as our [OpenUI5 Starter Kit](https://github.com/pulseshift/openui5-gulp-starter-kit). One build script to **rule them all**, I mean, how cool is that? Probably pretty cool, at least as long as we haven't found an alternative with Webpack yet. So take a look at our Starter Kit to learn more about the features and functionality of the build process.
+
 ## Usage
 
-tbd: how to use this lib in your project...
+This npm module already provides all content to use the library immediately: the folder `/src` contains all source files (written in LESS and ES6/ES7), in the folder `/dist` you will find the library, completely ready for use. Now there are two ways to use the library in your npm project:
+
+1. You can go the way recommended by [UI5Lab](https://github.com/UI5Lab/UI5Lab-library-simple) which ends up with copying the resources and files from the cloned npm project to your project either manually or via a custom script. We do not recommend that you go this way, because changes to the library must always be copied manually and this variant is more susceptible to errors.
+
+1. The way we recommend you is to use our OpenUI5 Starter-Kit for embedding. The prerequisite is that your project uses the build process of the starter kit (see instructions [here](https://github.com/pulseshift/openui5-gulp-starter-kit)). All you have to do then is:
+   * Download our library as dev-dependency with `yarn add ui5-lib-visualization --dev`.
+   * Add the library to your UI5 build settings in the `package. json`_\*_.
+   * Finished, you can now integrate the library into your XML Views via `xmlns: viz="ui5. viz"` or use it in your controllers etc..
+
+_\*snipped to include the library via ui5 config in `package. json`:_
+
+```json
+"library":[
+    {
+      "name": "ui5. viz",
+      "path": "node_modules/ui5-lib-visualization/dist/ui5/viz",
+      "prebuild": true
+    }
+]
+```
 
 ### Documentation
 
-Real live samples are beeing published, soon. Till then, please enjoy our first `beta` version of our automatcally created markdown API documentation:
+How to test real live samples please see section `Example`. Till then, please enjoy our first `beta` version of our automatcally created markdown API documentation:
+
 * [ui5.viz.Chart](./docs/Chart.md)
 * [ui5.viz.ChartSeries](./docs/ChartSeries.md)
 * [ui5.viz.ChartDataPoint](./docs/ChartDataPoint.md)
@@ -23,41 +45,120 @@ Real live samples are beeing published, soon. Till then, please enjoy our first
 
 ### Features
 
-tbd: brief overview about the main features...
+_Hint: This overview is not yet complete. In the course of time we will point out all important new functions and add these points to the new demo app, too._
+
+A brief overview of features, additional to C3.js line and area charts:
 
 ### Example
 
+To execute the demo, please follow the instructions described in section `Development`. At the time the demo is being refactored with the goal to provide you an SAP explored like experience.
+
+Here a basic sample of how to use the charts in an XML view:
+
+```xml
+<!-- ensure that the series data points and the x-axis labels have the exact same amount of entries -->
+<Chart
+  width="{store>/width}"
+  height="{store>/height}"
+  showTooltip="{store>/showTooltip}"
+  groupedTooltip="{store>/groupedTooltip}"
+  showLegend="{store>/showLegend}"
+  xAxisType="Indexed"
+  series="{store>/series}">
+  <series>
+    <ChartSeries
+      type="{store>type}"
+      name=" {store>name}"
+      data="{
+        path: 'store>dataPoints',
+        templateShareable: false
+      }">
+      <data>
+        <ChartDataPoint value="{store>}" />
+      </data>
+    </ChartSeries>
+  </series>
+  <xAxis>
+    <ChartAxis labels="{ path: 'store>/xAxis/0/labels'}">
+      <labels>
+        <ChartAxisLabel value="{store>}" />
+      </labels>
+    </ChartAxis>
+  </xAxis>
+  <yAxis>
+    <ChartAxis title="{store>/yAxis/0/title}" />
+  </yAxis>
+</Chart>
+```
+
+Respective controller code:
+
 ```js
-// samples are coming soon
+// define series color palette with a preset based on material design colors
+ui5.viz.setDefaultColorPalette(ui5.viz.ColorPalette.Material500)
+
+// define model
+const oModel = new JSONModel({
+  title: 'Area line chart',
+  width: '100%',
+  height: '300px',
+  showTooltip: true,
+  groupedTooltip: true,
+  showLegend: true,
+  xAxis: [
+    {
+      labels: ['April', 'May', 'June', 'July', 'August', 'September']
+    }
+  ],
+  yAxis: [
+    {
+      title: 'Sightings in the woods 🍃'
+    }
+  ],
+  series: [
+    {
+      name: 'Foxes 🦊',
+      dataPoints: [2, 5, 3, 5, 8, 9],
+      type: 'area'
+    }
+  ]
+})
+
+this.getView().setModel(oModel, 'store')
 ```
 
 ## Development
 
 [Download](https://github.com/pulseshift/ui5-lib-visualization/archive/master.zip) or clone this repository:
+
 ```
 git clone git@github.com:pulseshift/ui5-lib-visualization.git
 ```
 
 Please ensure that you have installed [node](https://nodejs.org/en/) and [yarn](https://yarnpkg.com/en/docs/install) before you continue.
 
 Install dependencies:
+
 ```
 yarn
 ```
+
 Start developing:
 _Will build all resources start watcher task and start a HTTP server_
+
 ```
 yarn start
 ```
 
-The app should open in your browser automatically, otherwise open: `http://localhost:3000`
+The app should open in your browser automatically, otherwise open: `http://localhost:3000/demo/index.html`
 
 Info: To get a more detailed logging, use `yarn start:verbose` instead.
 
 ## Distribution
 
 Start build:
 _Will create a `dist` directory in your project root._
+
 ```
 yarn build
 ```
@@ -72,17 +173,15 @@ Contributions, questions and comments are all welcome and encouraged.
 
 Check our [current issues](https://github.com/pulseshift/ui5-lib-visualization/issues) or, if you have something in mind how to make it better, [create your own issue](https://github.com/pulseshift/ui5-lib-visualization/issues/new). We would be happy to discuss how they can be solved.
 
-### Outlook
+### Contributors
+
+Thanks goes to these wonderful people ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
 
-Here is a brief overview on what we are working on right know and what will follow, soon. We are interested to hear your opinion on what should follow next.
+| [<img src="https://avatars1.githubusercontent.com/u/28702172?s=460&v=4" width="100px;"/><br /><sub><b>Lena Serdarusic</b></sub>](https://github.com/lenasrd)<br />[💻](https://github.com/pulseshift/ui5-lib-visualization/commits?author=lenasrd 'Code')💡🤔 | [<img src="https://avatars2.githubusercontent.com/u/8706643?s=460&v=4" width="100px;"/><br /><sub><b>Jascha A. Quintern</b></sub>](http://jascha-quintern.de)<br />[💻](https://github.com/pulseshift/ui5-lib-visualization/commits?author=fuchsvomwalde 'Code')💬 |
+| :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
 
-Current todos/issues/idea backlog (unordered):
-- Add check to setKey of ChartSeries and disallow "x" as key (because it is preserved)
-- Optional: update data types in library.js and align values with keys
-- ChartArea attribute "style" is not working with data binding, yet
-- Add (real) full-screen mode to Chart control
-- Y-axis label is corupting Y-axis display, if value is 0
-- Missing build step: create library.css for all themes
 
 ### License