Add advanced ui5 theme compilation method.

Author: fuchsvomwalde

CODEOWNERS

@@ -0,0 +1,8 @@
+# This is a comment.
+# Each line is a file pattern followed by one or more owners.
+# Order is important; the last matching pattern takes the most precedence.
+
+# These owners will be the default owners for everything in the repo.
+# Unless a later match takes precedence, @global-owner1 and @global-owner2
+# will be requested for review when someone opens a pull request.
+*       @fuchsvomwalde

README.md

@@ -22,7 +22,8 @@ ui5-lib-util is designed as an agnostic node module and can be used standalone i
 Example with gulp `4.0.0` (JavaScript ES6):
 ```js
 import gulp from 'gulp'
-import { ui5Download, ui5Build } from 'ui5-lib-util'
+import tap from 'gulp-tap'
+import { ui5Download, ui5Build, ui5CompileLessLib } from 'ui5-lib-util'
 
 // create gulp task
 const loadUI5 = gulp.series(downloadOpenUI5, buildOpenUI5)
@@ -77,6 +78,21 @@ function buildOpenUI5() {
     })
 }
 
+// compile a ui5 less theme library
+function compileUi5Theme() {
+  const sLibrarySourcePath = './dist/path/to/my/library/themes/sap_belize'
+
+  // create library.css in same directory as library.source.less
+  return new Promise((resolve, reject) =>
+    gulp
+      .src([`${sLibrarySourcePath}/library.source.less`])
+      // rename UI5 module (app component) paths and update UI5 resource roots in UI5 bootstrap of index.html
+      .pipe(tap(oFile => {
+        ui5CompileLessLib(oFile).then(resolve).catch(reject)
+      }))
+  )
+}
+
 ```
 
 Furtheremore, in the [OpenUI5 Starter Kit](https://github.com/pulseshift/openui5-gulp-starter-kit) you can find ui5-lib-util integrated in a complete build script.
@@ -104,6 +120,13 @@ ui5Build(sourcePath, destinationPath, ui5Version, [options])
 * `options` (object, optional) The configuration options object.
 * `options.onProgress` (function(number, number, object):void, optional) Callback function to track build progress taking as params: current step number, total step number and if available, step details (e.g. name of current step).
 
+### `ui5CompileLessLib`
+```js
+ui5CompileLessLib(file)
+```
+
+* `file` ([Vinyl](https://github.com/gulpjs/vinyl)) File must be the `library.source.less` file that imports all required less resources of the library.
+
 ### Outlook
 
 Here is a brief overview on what we are working right know and what will follow, soon. We are interested to hear your opinion on what should follow next.

index.js

@@ -26,7 +26,7 @@ const path = require('path')
 const builder = new lessOpenUI5.Builder()
 
 // export functions
-module.exports = { ui5Download, ui5Build }
+module.exports = { ui5Download, ui5Build, ui5CompileLessLib }
 
 /**
  * Download OpenUI5 repository from external URL and unzip.
@@ -583,7 +583,7 @@ function ui5Build(sUI5SrcPath, sUI5TargetPath, sUI5Version, oOptions = {}) {
               .pipe(
                 tap(oFile => {
                   // TODO: tap into library.source.less files to customize ui5 bundle
-                  compileUI5LessLib(oFile)
+                  ui5CompileLessLib(oFile)
                 })
               )
               // save at target location
@@ -655,10 +655,10 @@ function ui5Build(sUI5SrcPath, sUI5TargetPath, sUI5Version, oOptions = {}) {
 /**
  * Compile library.source.less and dependencies to library.css.
  *
- * @param {Vinyl} [oFile] Vinyl file object of library-preload.json.
- * @returns {Vinyl} Transformed library-preload.json.
+ * @param {Vinyl} [oFile] Vinyl file object of library.source.less.
+ * @returns {Promise} Promise.
  */
-function compileUI5LessLib(oFile) {
+function ui5CompileLessLib(oFile) {
   const sDestDir = path.dirname(oFile.path)
   const sFileName = oFile.path.split('/').pop()
   const sLessFileContent = oFile.contents.toString('utf8')
@@ -710,7 +710,7 @@ function compileUI5LessLib(oFile) {
       }
 
       // if missing file could be created, try theme build again
-      return isIssueFixed ? compileUI5LessLib(oFile) : Promise.reject()
+      return isIssueFixed ? ui5CompileLessLib(oFile) : Promise.reject()
     })
     .then(oResult => {
       // build css content was successfull >> save result

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui5-lib-util",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A set of UI5 utilities to download and build OpenUI5 automatically.",
   "scripts": {
     "precommit": "lint-staged"