lincd-cli 0.1.2 → 0.1.4

package/lib/config-grunt.js

@@ -0,0 +1,254 @@
+"use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from) {
+    for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
+        to[j] = from[i];
+    return to;
+};
+exports.__esModule = true;
+var config_webpack_1 = require("./config-webpack");
+var fs = require('fs');
+var chalk = require('chalk');
+var path = require('path');
+var utils_1 = require("./utils");
+function generateGruntConfig(moduleName, config) {
+    if (config === void 0) { config = {}; }
+    return function (grunt) {
+        setupGrunt(grunt, moduleName, config);
+    };
+}
+exports["default"] = generateGruntConfig;
+function setupGrunt(grunt, moduleName, config) {
+    var buildServer = !config.environment || config.environment == 'server';
+    var buildFrontend = !config.environment || config.environment == 'frontend';
+    //when not specified and we ARe building frontend OR we are compiling the server for es5.. or if simply specified, then es5 is targeted
+    var targetES5 = (!config.target && (buildFrontend || config.es5Server)) ||
+        config.target == 'es5';
+    var targetES6 = !config.target || config.target == 'es6';
+    var targets = [];
+    if (targetES5)
+        targets.push('es5');
+    if (targetES6)
+        targets.push('es6');
+    var targetLog = 'building ' + targets.join(', ');
+    if (buildServer && !buildFrontend) {
+        utils_1.log(targetLog + ' lib only');
+    }
+    else if (!buildServer && buildFrontend) {
+        utils_1.log(targetLog + ' dist bundles only');
+    }
+    else if (buildServer && buildFrontend) {
+        if (config.es5Server) {
+            utils_1.log(targetLog + ' lib files & dist bundles');
+        }
+        else {
+            utils_1.log(targetLog + ' dist bundles and es6 lib files');
+        }
+    }
+    else {
+        utils_1.log('invalid configuration combination');
+    }
+    require('load-grunt-tasks')(grunt);
+    //defaults
+    grunt.registerTask('default', ['prepare-build', 'concurrent:dev']);
+    grunt.registerTask('dev', targetES6 ? ['prepare-build', 'dev-es6'] : ['prepare-build', 'dev-es5']);
+    grunt.registerTask('build', targets.map(function (target) { return 'build-' + target; }));
+    if (buildFrontend) {
+        grunt.registerTask('build-frontend', __spreadArray([
+            'prepare-build'
+        ], targets.map(function (target) { return 'webpack:build-' + target; })));
+    }
+    grunt.registerTask('build-production', utils_1.flatten([
+        'clean:lib',
+        'prepare-build',
+        buildFrontend ? targets.map(function (target) { return 'webpack:prod-' + target; }) : null,
+        buildServer ? ['exec:build-lib', 'copy:lib'] : null,
+    ]));
+    var prepareBuild = ['postcss:cssjson'];
+    if (config.beforeBuildCommand) {
+        prepareBuild.push('exec:beforeBuildCommand');
+    }
+    //specific tasks
+    grunt.registerTask('prepare-build', prepareBuild);
+    grunt.registerTask('dev-es6-production', [
+        'prepare-build',
+        'concurrent:dev-prod',
+    ]);
+    grunt.registerTask('dev-es6', ['prepare-build', 'concurrent:dev']);
+    grunt.registerTask('dev-es5', ['prepare-build', 'concurrent:dev-es5']);
+    //build-es5 is by default just the frontend because the server is es6
+    //however some specific modules (like @dacore/module) require the typescript compiler ('build-lib') to run for es5
+    //so that core-es5 or browser-core-es5 can internalise its files
+    //this can by triggered with es5Server
+    grunt.registerTask('build-es5', utils_1.flatten([
+        'postcss',
+        buildFrontend ? 'webpack:build-es5' : null,
+        config.es5Server ? ['exec:build-lib-es5', 'copy:lib'] : null,
+    ]));
+    grunt.registerTask('build-es6', utils_1.flatten([
+        'prepare-build',
+        buildFrontend ? 'webpack:build-es6' : null,
+        buildServer ? ['clean:lib', 'exec:build-lib', 'copy:lib'] : null,
+        // 'exec:shapes',
+    ]));
+    grunt.registerTask('build-lib', [
+        'prepare-build',
+        'exec:build-lib',
+        'copy:lib',
+    ]);
+    grunt.registerTask('build-production-es5', [
+        'prepare-build',
+        'webpack:prod-es5',
+        // 'exec:shapes',
+    ]);
+    grunt.registerTask('build-production-es6', [
+        'prepare-build',
+        'webpack:prod-es6',
+        // 'exec:shapes',
+    ]);
+    // log('setting grunt config');
+    grunt.initConfig({
+        exec: {
+            'build-lib': 'tsc --pretty',
+            'build-lib-es5': 'tsc --pretty -p tsconfig-es5.json',
+            beforeBuildCommand: config.beforeBuildCommand,
+            'server-dev': 'tsc -w',
+            test: 'tsc -w',
+            // shapes: 'lincd shapes',
+            'css-declarations': 'tcm -p **/*.scss',
+            'postcss-modules': 'yarn postcss --use postcss-import postcss-cssnext postcss-nested postcss-modules -o build/draft.css -i scss/*'
+        },
+        copy: {
+            lib: {
+                files: [
+                    // copy json files in src over to lib
+                    {
+                        expand: true,
+                        src: ['**/*.json', '**/*.json.d.ts'],
+                        dest: 'lib/',
+                        cwd: 'src/',
+                        filter: 'isFile'
+                    },
+                ]
+            }
+        },
+        postcss: {
+            options: {
+                map: true,
+                processors: [require('postcss-modules')({ generateScopedName: utils_1.generateScopedName })],
+                syntax: require('postcss-scss'),
+                writeDest: false
+            },
+            cssjson: {
+                src: 'src/**/*.scss'
+            }
+        },
+        clean: {
+            lib: ['lib/']
+        },
+        concurrent: {
+            dev: utils_1.flatten([
+                buildFrontend ? 'webpack:dev' : null,
+                buildServer ? 'exec:server-dev' : null,
+                // buildServer ? 'watch:css-module-transforms' : null,
+                // 'exec:css-declarations-watch'
+            ]),
+            'dev-prod': utils_1.flatten([
+                buildFrontend ? 'webpack:dev-prod' : null,
+                buildServer ? 'exec:server-dev' : null,
+                // buildServer ? 'watch:css-module-transforms' : null,
+                // 'exec:css-declarations-watch'
+            ]),
+            'dev-es5': utils_1.flatten([
+                buildFrontend ? 'webpack:dev-es5' : null,
+                buildServer ? 'exec:server-dev' : null,
+                // buildServer ? 'watch:css-module-transforms' : null,
+                // 'exec:css-declarations-watch'
+            ]),
+            options: {
+                logConcurrentOutput: true,
+                logTaskName: 3,
+                logBlacklist: []
+            }
+        },
+        webpack: {
+            options: {
+                stats: {
+                    chunks: false,
+                    version: false,
+                    warningsFilter: function (warning) {
+                        return warning.indexOf('There are multiple modules') !== -1;
+                    }
+                }
+            },
+            dev: config_webpack_1.generateWebpackConfig('dev', moduleName, Object.assign({
+                target: 'es6',
+                watch: true
+            }, config, config.es6, config.dev)),
+            'dev-prod': config_webpack_1.generateWebpackConfig('dev', moduleName, Object.assign({
+                target: 'es6',
+                watch: true,
+                productionMode: true
+            }, config, config.es6, config.prod)),
+            'dev-es5': config_webpack_1.generateWebpackConfig('dev-es5', moduleName, Object.assign({
+                target: 'es5',
+                watch: true
+            }, config, config.es5, config.dev)),
+            'build-es6': config_webpack_1.generateWebpackConfig('build-es6', moduleName, Object.assign({
+                target: 'es6',
+                watch: false
+            }, config, config.es6, config.dev)),
+            'build-es5': config_webpack_1.generateWebpackConfig('build-es5', moduleName, Object.assign({
+                target: 'es5',
+                watch: false
+            }, config, config.es5, config.dev)),
+            'prod-es5': config_webpack_1.generateWebpackConfig('prod-es5', moduleName, Object.assign({
+                target: 'es5',
+                watch: false,
+                productionMode: true
+            }, config, config.es5, config.prod)),
+            'prod-es6': config_webpack_1.generateWebpackConfig('prod-es6', moduleName, Object.assign({
+                target: 'es6',
+                watch: false,
+                productionMode: true
+            }, config, config.es6, config.prod))
+        }
+    });
+    //load the npm grunt task modules
+    [
+        'grunt-webpack',
+        'grunt-exec',
+        'grunt-concurrent',
+        'grunt-contrib-clean',
+        'grunt-contrib-copy',
+        '@lodder/grunt-postcss',
+    ].forEach(function (taskName) {
+        utils_1.debug(config, 'loading grunt task ' + taskName);
+        var localPath = path.resolve(__dirname, '..', 'node_modules', taskName, 'tasks');
+        var localPath2 = path.resolve(__dirname, '..', '..', 'node_modules', taskName, 'tasks');
+        var workspacePath = path.resolve(__dirname, '..', '..', '..', 'node_modules', taskName, 'tasks');
+        var nestedWorkspacePath = path.resolve(__dirname, '..', '..', '..', '..', 'node_modules', taskName, 'tasks');
+        if (fs.existsSync(localPath)) {
+            // grunt.loadNpmTasks(taskName);
+            utils_1.debug('Loading from ' + localPath);
+            grunt.task.loadTasks(localPath);
+        }
+        else if (fs.existsSync(localPath2)) {
+            // grunt.loadNpmTasks(taskName);
+            utils_1.debug('Loading from ' + localPath2);
+            grunt.task.loadTasks(localPath2);
+        }
+        else if (fs.existsSync(workspacePath)) {
+            //windows, so it seems
+            utils_1.debug('Loading from ' + workspacePath);
+            grunt.task.loadTasks(workspacePath);
+        }
+        else if (fs.existsSync(nestedWorkspacePath)) {
+            //mac / linux
+            utils_1.debug('Loading from ' + nestedWorkspacePath);
+            grunt.task.loadTasks(nestedWorkspacePath);
+        }
+        else {
+            utils_1.warn("Could not load grunt task module " + taskName + "\nCould not find task at any of these paths:\n" + localPath + "\n" + localPath2 + "\n" + workspacePath + "\n" + nestedWorkspacePath);
+        }
+    });
+}

package/lib/config-webpack.js

@@ -0,0 +1,273 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+exports.generateWebpackConfig = void 0;
+var declaration_plugin_1 = __importDefault(require("./plugins/declaration-plugin"));
+var externalise_modules_1 = __importDefault(require("./plugins/externalise-modules"));
+var watch_run_1 = __importDefault(require("./plugins/watch-run"));
+var utils_1 = require("./utils");
+var colors = require("colors");
+var fs = require('fs');
+var MiniCssExtractPlugin = require('mini-css-extract-plugin');
+var chalk = require('chalk');
+var webpack = require('webpack');
+var path = require('path');
+var ExtractTextPlugin = require('extract-text-webpack-plugin');
+var WebpackLicencePlugin = require('webpack-license-plugin');
+var TsconfigPathsPlugin = require('tsconfig-paths-webpack-plugin');
+var BundleAnalyzerPlugin = require('webpack-bundle-analyzer')
+    .BundleAnalyzerPlugin;
+var TerserPlugin = require('terser-webpack-plugin');
+var exec = require('child_process').exec;
+var NODE_ENV = process.env.NODE_ENV;
+var nodeProduction = NODE_ENV == 'production';
+var libraryName = 'lincd';
+function generateWebpackConfig(buildName, moduleName, config) {
+    if (config === void 0) { config = {}; }
+    if (!config.externals)
+        config.externals = {};
+    if (!config.internals)
+        config.internals = [];
+    var watch = config.watch;
+    var productionMode = nodeProduction || config.productionMode;
+    var es5 = config.target == 'es5';
+    var es6 = config.target == 'es6';
+    var cleanModuleName = moduleName.replace(/@\w+\//, '');
+    var configFile;
+    if (es5 && fs.existsSync('tsconfig-es5.json')) {
+        configFile = 'tsconfig-es5.json';
+    }
+    else {
+        configFile = 'tsconfig.json';
+    }
+    if (!fs.existsSync(configFile)) {
+        utils_1.warn('Cannot find ' + configFile);
+        process.exit();
+    }
+    var plugins = [
+        new webpack.DefinePlugin({
+            'process.env.BROWSER': JSON.stringify(true),
+            'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV)
+        }),
+        new webpack.NoEmitOnErrorsPlugin(),
+        new ExtractTextPlugin(config.cssFileName
+            ? config.cssFileName
+            : libraryName + '.' + cleanModuleName + '.css'),
+        new MiniCssExtractPlugin({
+            // linkType: false,
+            filename: config.cssFileName
+                ? config.cssFileName
+                : libraryName + '.' + cleanModuleName + '.css'
+        }),
+        new WebpackLicencePlugin({
+            excludedPackageTest: function (packageName, version) {
+                return packageName.indexOf('lincd') !== -1;
+            }
+        }),
+    ];
+    if (config.debug) {
+        plugins.push(new watch_run_1["default"]());
+    }
+    if (config.afterBuildCommand) {
+        plugins.push({
+            apply: function (compiler) {
+                compiler.hooks.afterEmit.tap('AfterEmitPlugin', function (compilation) {
+                    exec(config.afterBuildCommand, function (err, stdout, stderr) {
+                        if (stdout)
+                            process.stdout.write(stdout);
+                        if (stderr)
+                            process.stderr.write(stderr);
+                    });
+                });
+            }
+        });
+    }
+    if (config.analyse) {
+        plugins.push(new BundleAnalyzerPlugin());
+    }
+    if (es6 || config.declarations === true) {
+        plugins.push(new declaration_plugin_1["default"]({
+            out: (config.filename
+                ? config.filename
+                : libraryName + '.' + cleanModuleName) + '.d.ts',
+            root: config.outputPath ? config.outputPath : './lib/',
+            debug: 'debug' in config ? config.debug : false
+        }));
+    }
+    var resolvePlugins = [
+        new TsconfigPathsPlugin({
+            configFile: configFile,
+            silent: true
+        }),
+    ];
+    var aliases = config.alias || {};
+    var rules = [
+        {
+            test: /\.(scss|css)$/,
+            use: [
+                MiniCssExtractPlugin.loader,
+                {
+                    loader: 'css-loader',
+                    options: {
+                        url: false
+                    }
+                },
+                {
+                    loader: 'postcss-loader',
+                    options: {
+                        postcssOptions: {
+                            plugins: {
+                                'postcss-import': {},
+                                'postcss-cssnext': {},
+                                'postcss-nested': {},
+                                // "postcss-scss": {}, //<-- only add this back if the build gets stuck on //comments in scss files, but I dont think that will be the case anymore
+                                'postcss-modules': {
+                                    //by default postcss-modules will put out a json file right next to the original css / scss file, this method defines what classnames to use
+                                    generateScopedName: utils_1.generateScopedName,
+                                    globalModulePaths: [/tailwind/]
+                                },
+                                tailwindcss: {
+                                    purge: {
+                                        enabled: productionMode,
+                                        content: [
+                                            './src/**/*.tsx',
+                                            './src/**/*.ts',
+                                            //also include @dacore modules which are internalized with the "internal" config option
+                                            //imports like ... from '@dacore/module/lib/views/SomeView' will
+                                            //these modules should live in the node_modules folder of the root of the site
+                                            //TODO: remake this with multiple lincd modules
+                                            // '../../node_modules/@dacore/*/lib/**/*.js',
+                                            // './node_modules/@dacore/*/lib/**/*.js',
+                                        ]
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
+                {
+                    loader: 'sass-loader',
+                    options: { sourceMap: true }
+                },
+            ]
+        },
+        {
+            test: /\.tsx?$/,
+            use: [
+                {
+                    loader: 'ts-loader?' +
+                        JSON.stringify(__assign({ configFile: configFile, compilerOptions: {
+                                declaration: !es5,
+                                /*
+                                    for webpack we overwrite the module settings of the modules' tsconfig file
+                                    because we NEED esnext for code splitting. But the VM we currently use for the registry does not support esnext modules
+                                 */
+                                module: 'esnext',
+                                moduleResolution: 'node'
+                            } }, config.tsConfigOverwrites))
+                },
+            ]
+        },
+        {
+            enforce: 'pre',
+            test: /\.js$/,
+            use: [
+                {
+                    loader: 'source-map-loader'
+                },
+            ]
+        },
+    ];
+    if (es5 && config.internalsources && config.internalsources.length > 0) {
+        //usually a module that transpiles to es5 will only have es5 code in the bundle.
+        //however a module that INTERNALISES other dacore modules will directly include es6 code from @dacore/other_modules/lib
+        //which eventually results in an import of @dacore/core being bundled as 'const =', which trips up old browsers
+        //so we fix that here by just referring directly to the typescript source instead of the transpiled js for internalised modules
+        //however this means that for internalised modules THE SOURCE CODE NEEDS TO BE AVAILABLE. This is currently NOT the case with how we publish modules to yarn
+        //so that means internalised modules need to be LOCALLY AVAILABLE with yarn workspaces
+        plugins.push(new webpack.NormalModuleReplacementPlugin(/\lincd\/lib\//, function (resource, match) {
+            var moduleName = resource.request.match(/lincd\/lib\//)[1];
+            if (config.internalsources.indexOf(moduleName) !== -1) {
+                console.log(colors.magenta('internal sources + ES5: Replacing /lib/ with /src/  for source-internalised module ' +
+                    moduleName));
+                resource.request = resource.request.replace('/lib/', '/src/');
+                console.log(colors.magenta('internal sources + ES5: ' + resource.request));
+                console.log(colors.red("WARNING: Make sure you have the TYPESCRIPT SOURCE FILES of the modules listed as 'internal' AVAILABLE ON YOUR LOCAL MACHINE. So if you check in node_modules/your-internalised-module - that should be a symbolic link and you will find a 'src' folder with typescript files there."));
+            }
+        }));
+    }
+    return {
+        entry: config.entry ? config.entry : './src/index.ts',
+        output: {
+            filename: (config.filename
+                ? config.filename
+                : libraryName + '.' + cleanModuleName) +
+                (es5 ? '.es5' : '') +
+                '.js',
+            path: path.resolve(process.cwd(), config.bundlePath || 'dist'),
+            devtoolModuleFilenameTemplate: moduleName + '/[resource-path]'
+        },
+        devtool: productionMode ? 'cheap-source-map' : 'cheap-source-map',
+        mode: productionMode ? 'production' : 'development',
+        //fixing a persistent but strange build error here that showed up once, this is a workaround. See: https://github.com/webpack-contrib/css-loader/issues/447
+        node: {
+            fs: 'empty',
+            child_process: 'empty'
+        },
+        resolve: {
+            extensions: ['.webpack.js', '.js', '.ts', '.tsx', '.json'],
+            alias: aliases,
+            plugins: resolvePlugins
+        },
+        resolveLoader: {
+            modules: [
+                path.join(__dirname, 'plugins'),
+                path.join(__dirname, 'node_modules'),
+                'node_modules',
+            ]
+        },
+        optimization: {
+            minimize: productionMode,
+            minimizer: [
+                new TerserPlugin({
+                    extractComments: {
+                        condition: /^\**!|@preserve|@license|@cc_on/i,
+                        banner: function (licenseFile) {
+                            return "License information can be found in " + licenseFile + " and oss-licences.json";
+                        }
+                    }
+                }),
+            ]
+        },
+        watch: watch,
+        module: {
+            rules: rules
+        },
+        //See plugins/externalise-modules.ts We're passing in a function here that determines what to exclude from the bundle and what not
+        //See also https://webpack.js.org/configuration/externals/
+        externals: externalise_modules_1["default"](config, es5),
+        plugins: plugins,
+        stats: {
+            errorDetails: config.debug,
+            chunks: false,
+            children: false,
+            version: true,
+            hash: false,
+            modules: false
+        }
+    };
+}
+exports.generateWebpackConfig = generateWebpackConfig;

package/{index.js → lib/index.js}

@@ -6,13 +6,17 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 exports.__esModule = true;
 exports.generateWebpackConfig = exports.generateGruntConfig = exports.externaliseModules = exports.DeclarationPlugin = void 0;
 var declaration_plugin_1 = require("./plugins/declaration-plugin");
 __createBinding(exports, declaration_plugin_1, "default", "DeclarationPlugin");
 var externalise_modules_1 = require("./plugins/externalise-modules");
 __createBinding(exports, externalise_modules_1, "default", "externaliseModules");
-var config_generator_1 = require("./config-generator");
-__createBinding(exports, config_generator_1, "default", "generateGruntConfig");
-var config_generator_2 = require("./config-generator");
-exports.generateWebpackConfig = config_generator_2.generateWebpackConfig;
+var config_grunt_1 = require("./config-grunt");
+__createBinding(exports, config_grunt_1, "default", "generateGruntConfig");
+var config_webpack_1 = require("./config-webpack");
+exports.generateWebpackConfig = config_webpack_1.generateWebpackConfig;
+__exportStar(require("./utils"), exports);

package/lib/interfaces.js

@@ -0,0 +1,2 @@
+"use strict";
+exports.__esModule = true;

package/{plugins → lib/plugins}/declaration-plugin.js

@@ -163,9 +163,9 @@ var DeclarationPlugin = /** @class */ (function () {
                 }
                 //exclude re-exports
                 //excludeLine = excludeLine || (/export ([a-z0-9A-Z_-\{\}\s,\*]+) from/).test(line);
-                //exclude local scss imports like: import "./some.scss"
+                //exclude unnamed local imports like: import "./some.scss" or import "./someFile"t
                 excludeLine =
-                    excludeLine || /import ["'][a-z0-9A-Z_\-.\/\\]+.scss["']/.test(line);
+                    excludeLine || /import ["'][a-z0-9A-Z_\-.\/\\]+["']/.test(line);
                 //if defined, check for excluded references
                 if (!excludeLine &&
                     this.excludedReferences &&
@@ -173,7 +173,7 @@ var DeclarationPlugin = /** @class */ (function () {
                     excludeLine = this.excludedReferences.some(function (reference) { return line.indexOf(reference) !== -1; });
                 }
                 if (excludeLine) {
-                    //this.debug("Excluding line "+i+': '+line);
+                    this.debug('Excluding line ' + i + ': ' + line);
                     lines.splice(i, 1);
                 }
                 else {