feature(dist): implements a workaround for webpack/webpack#5316

fixes #45

Makefile

@@ -4,6 +4,7 @@ GIT=git
 NPM=npm
 MAKEDEPEND=node_modules/.bin/js-makedepend --output-to jsdependencies.mk --exclude "node_modules|doc"
 LODASH=node_modules/.bin/lodash
+RJS=node_modules/requirejs/bin/r.js
 
 PARSERS=parse/mscgenparser.js \
 	parse/msgennyparser.js \
@@ -14,7 +15,7 @@ GENERATED_SOURCES=$(PARSERS) \
 				  render/graphics/csstemplates.js
 LIBDIRS=lib/lodash
 
-.PHONY: help dev-build install deploy-gh-pages check fullcheck mostlyclean clean lint cover prerequisites report test update-dependencies run-update-dependencies depend bower-package
+.PHONY: help dist dev-build install deploy-gh-pages check fullcheck mostlyclean clean lint cover prerequisites report test update-dependencies run-update-dependencies depend bower-package
 
 help:
 	@echo " --------------------------------------------------------"
@@ -94,6 +95,16 @@ prerequisites:
 
 dev-build: $(GENERATED_SOURCES) .npmignore
 
+dist: dev-build node_modules/almond/almond.js
+	mkdir -p dist
+	$(RJS) -o baseUrl=. \
+			name=node_modules/almond/almond \
+			include=index \
+			out=dist/mscgen.js \
+			wrap.startFile=almond.start.frag \
+			wrap.endFile=almond.end.frag \
+			preserveLicenseComments=true
+
 lint:
 	$(NPM) run lint
 

almond.end.frag

@@ -0,0 +1,6 @@
+    //The modules for your project will be inlined above
+    //this snippet. Ask almond to synchronously require the
+    //module value for 'main' here and return it as the
+    //value to use for the public API for the built file.
+    return require('index');
+}));

almond.start.frag

@@ -0,0 +1,14 @@
+(function (root, factory) {
+    if (typeof define === 'function' && define.amd) {
+        //Allow using this built library as an AMD module
+        //in another project. That other project will only
+        //see this AMD call, not the internal modules in
+        //the closure below.
+        define([], factory);
+    } else {
+        //Browser globals case. Just assign the
+        //result to a property on the global.
+        root.mscgen = factory();
+    }
+}(this, function () {
+    //almond, and your modules will be inlined here

doc/samples/README.md

@@ -9,10 +9,14 @@ with mscgenjs.
 
 - [`sample-webpack.html`](sample-webpack.html)    
   a page with a textarea, a few buttons and a div for
-  putting the output in.
+  putting the output in. 
 - [`sample-webpack.js`](sample-webpack.js)    
   Sets up some listeners that (a.o.) call mscgenjs' render function with
-  the textarea as input
+  the textarea as input. 
+  > Note that this does not `require` the root module
+  but `dist/mscgen.js` in stead. This is a workaround for 
+  [webpack issue #5316](https://github.com/webpack/webpack/issues/5316),
+  which makes that webpack 3 can't work with amdefine.
 - `sample-webpack.bundle.js`    
   The webpack bundle actually included in _sample-webpack.html_. It's not
   included in the repo but it's easy to generate it from app.js:
@@ -21,8 +25,11 @@ with mscgenjs.
 # when you don't have webpack installed yet do that first:
 npm install --global webpack
 
-# generate the bundle
-webpack --optimize-minimize sample-webpack.js sample-webpack.bundle.js
+# change to this directory
+cd doc/samples
+
+# generate the bundle; it'll now use the webpack.config.js in doc/samples
+webpack
 ```
 
 ## An AMD example (using requirejs)

doc/samples/sample-webpack.js

@@ -1,4 +1,5 @@
-var mscgenjs = require('../../');
+// var mscgenjs = require('../../dist/mscgen').mscgen;
+var mscgenjs = require('../../dist/mscgen');
 
 function render(){
     // clear the target area before rendering on it

doc/samples/webpack.config.js

@@ -0,0 +1,11 @@
+
+module.exports = (pEnv = 'prod') => {
+    const lRetval = {
+        entry: './sample-webpack.js'
+    };
+
+    lRetval.output = {filename : './sample-webpack.bundle.js'}
+    lRetval.devtool = "source-map";
+
+    return lRetval;
+};

package.json

@@ -8,6 +8,7 @@
     "requirejs": "2.3.5"
   },
   "devDependencies": {
+    "almond": "0.3.3",
     "chai": "4.1.2",
     "chai-xml": "0.3.1",
     "dependency-cruiser": "2.9.0",