Revise process of making bundles and simplify making partial bundles

README.md

@@ -75,34 +75,9 @@ Starting in `v1.15.0`, plotly.js ships with several _partial_ bundles (more info
 
 Starting in `v1.39.0`, plotly.js publishes _distributed_ npm packages with no dependencies. For example, run `npm install plotly.js-geo-dist` and add `import Plotly from 'plotly.js-geo-dist';` to your code to start using the plotly.js geo package.
 
-If none of the distributed npm packages meet your needs, and you would like to manually pick which plotly.js modules to include, you'll first need to run `npm install plotly.js` and then create a *custom* bundle by using `plotly.js/lib/core`, and loading only the trace types that you need (e.g. `pie` or `choropleth`). The recommended way to do this is by creating a *bundling file*. For example, in CommonJS:
+If none of the distributed npm packages meet your needs, you create custom bundle of desired trace modules e.g. `pie` and `sunburst` using
+`npm run partial-bundle pie sunburst name=custom`
 
-```javascript
-// in custom-plotly.js
-var Plotly = require('plotly.js/lib/core');
-
-// Load in the trace types for pie, and choropleth
-Plotly.register([
-    require('plotly.js/lib/pie'),
-    require('plotly.js/lib/choropleth')
-]);
-
-module.exports = Plotly;
-```
-
-Then elsewhere in your code:
-
-```javascript
-var Plotly = require('./path/to/custom-plotly');
-```
-
-#### Non-ascii characters
-
-Important: the plotly.js code base contains some non-ascii characters. Therefore, please make sure to set the `charset` attribute to `"utf-8"` in the script tag that imports your plotly.js bundle. For example:
-
-```html
-<script src="my-plotly-bundle.js" charset="utf-8"></script>
-```
 
 ## Building plotly.js
 

lib/aggregate.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/transforms/aggregate instead of lib/aggregate
 module.exports = require('../src/transforms/aggregate');

lib/bar.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/bar instead of lib/bar
 module.exports = require('../src/traces/bar');

lib/barpolar.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/barpolar instead of lib/barpolar
 module.exports = require('../src/traces/barpolar');

lib/box.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/box instead of lib/box
 module.exports = require('../src/traces/box');

lib/calendars.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/components/calendars instead of lib/calendars
 module.exports = require('../src/components/calendars');

lib/candlestick.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/candlestick instead of lib/candlestick
 module.exports = require('../src/traces/candlestick');

lib/carpet.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/carpet instead of lib/carpet
 module.exports = require('../src/traces/carpet');

lib/choropleth.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/choropleth instead of lib/choropleth
 module.exports = require('../src/traces/choropleth');

lib/choroplethmapbox.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/choroplethmapbox instead of lib/choroplethmapbox
 module.exports = require('../src/traces/choroplethmapbox');

lib/cone.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/cone instead of lib/cone
 module.exports = require('../src/traces/cone');

lib/contour.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/contour instead of lib/contour
 module.exports = require('../src/traces/contour');

lib/contourcarpet.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/contourcarpet instead of lib/contourcarpet
 module.exports = require('../src/traces/contourcarpet');

lib/densitymapbox.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/densitymapbox instead of lib/densitymapbox
 module.exports = require('../src/traces/densitymapbox');

lib/filter.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/transforms/filter instead of lib/filter
 module.exports = require('../src/transforms/filter');

lib/funnel.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/funnel instead of lib/funnel
 module.exports = require('../src/traces/funnel');

lib/funnelarea.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/funnelarea instead of lib/funnelarea
 module.exports = require('../src/traces/funnelarea');

lib/groupby.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/transforms/groupby instead of lib/groupby
 module.exports = require('../src/transforms/groupby');

lib/heatmap.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/heatmap instead of lib/heatmap
 module.exports = require('../src/traces/heatmap');

lib/heatmapgl.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/heatmapgl instead of lib/heatmapgl
 module.exports = require('../src/traces/heatmapgl');

lib/histogram.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/histogram instead of lib/histogram
 module.exports = require('../src/traces/histogram');

lib/histogram2d.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/histogram2d instead of lib/histogram2d
 module.exports = require('../src/traces/histogram2d');

lib/histogram2dcontour.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/histogram2dcontour instead of lib/histogram2dcontour
 module.exports = require('../src/traces/histogram2dcontour');

lib/image.js

@@ -1,3 +1,3 @@
 'use strict';
-
+// deprecated in plotly.js v2 - one may use src/traces/image instead of lib/image
 module.exports = require('../src/traces/image');

lib/index-basic.js

@@ -1,10 +1,16 @@
 'use strict';
 
-var Plotly = require('./core');
+var core = require('../src/core');
 
-Plotly.register([
-    require('./bar'),
-    require('./pie')
+core.register([
+    require('../src/traces/bar'),
+    require('../src/traces/pie'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-cartesian.js

@@ -1,19 +1,25 @@
 'use strict';
 
-var Plotly = require('./core');
+var core = require('../src/core');
 
-Plotly.register([
-    require('./bar'),
-    require('./box'),
-    require('./heatmap'),
-    require('./histogram'),
-    require('./histogram2d'),
-    require('./histogram2dcontour'),
-    require('./image'),
-    require('./pie'),
-    require('./contour'),
-    require('./scatterternary'),
-    require('./violin')
+core.register([
+    require('../src/traces/bar'),
+    require('../src/traces/box'),
+    require('../src/traces/heatmap'),
+    require('../src/traces/histogram'),
+    require('../src/traces/histogram2d'),
+    require('../src/traces/histogram2dcontour'),
+    require('../src/traces/contour'),
+    require('../src/traces/scatterternary'),
+    require('../src/traces/violin'),
+    require('../src/traces/image'),
+    require('../src/traces/pie'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-finance.js

@@ -1,17 +1,23 @@
 'use strict';
 
-var Plotly = require('./core');
+var core = require('../src/core');
 
-Plotly.register([
-    require('./bar'),
-    require('./histogram'),
-    require('./pie'),
-    require('./funnelarea'),
-    require('./ohlc'),
-    require('./candlestick'),
-    require('./funnel'),
-    require('./waterfall'),
-    require('./indicator')
+core.register([
+    require('../src/traces/bar'),
+    require('../src/traces/histogram'),
+    require('../src/traces/funnel'),
+    require('../src/traces/waterfall'),
+    require('../src/traces/pie'),
+    require('../src/traces/funnelarea'),
+    require('../src/traces/indicator'),
+    require('../src/traces/ohlc'),
+    require('../src/traces/candlestick'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-geo.js

@@ -1,10 +1,16 @@
 'use strict';
 
-var Plotly = require('./core');
+var core = require('../src/core');
 
-Plotly.register([
-    require('./scattergeo'),
-    require('./choropleth')
+core.register([
+    require('../src/traces/scattergeo'),
+    require('../src/traces/choropleth'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-gl2d.js

@@ -1,13 +1,19 @@
 'use strict';
 
-var Plotly = require('./core');
-
-Plotly.register([
-    require('./scattergl'),
-    require('./splom'),
-    require('./pointcloud'),
-    require('./heatmapgl'),
-    require('./parcoords')
+var core = require('../src/core');
+
+core.register([
+    require('../src/traces/scattergl'),
+    require('../src/traces/splom'),
+    require('../src/traces/pointcloud'),
+    require('../src/traces/heatmapgl'),
+    require('../src/traces/parcoords'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-gl3d.js

@@ -1,15 +1,21 @@
 'use strict';
 
-var Plotly = require('./core');
-
-Plotly.register([
-    require('./scatter3d'),
-    require('./surface'),
-    require('./mesh3d'),
-    require('./isosurface'),
-    require('./volume'),
-    require('./cone'),
-    require('./streamtube')
+var core = require('../src/core');
+
+core.register([
+    require('../src/traces/scatter3d'),
+    require('../src/traces/surface'),
+    require('../src/traces/isosurface'),
+    require('../src/traces/volume'),
+    require('../src/traces/mesh3d'),
+    require('../src/traces/cone'),
+    require('../src/traces/streamtube'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);

lib/index-mapbox.js

@@ -1,11 +1,17 @@
 'use strict';
 
-var Plotly = require('./core');
+var core = require('../src/core');
 
-Plotly.register([
-    require('./scattermapbox'),
-    require('./choroplethmapbox'),
-    require('./densitymapbox')
+core.register([
+    require('../src/traces/scattermapbox'),
+    require('../src/traces/choroplethmapbox'),
+    require('../src/traces/densitymapbox'),
+
+    require('../src/transforms/aggregate'),
+    require('../src/transforms/filter'),
+    require('../src/transforms/groupby'),
+    require('../src/transforms/sort'),
+    require('../src/components/calendars')
 ]);
 
-module.exports = require('./register_extra')(Plotly);
+module.exports = (function(Plotly) { return Plotly; })(core);