@userfrosting/browserify-dependencies

browserify-dependencies

Branch	Status
master
develop

Runs browserify against compatible dependencies in node_modules or whichever other folder you specify, outputting the results as UMD bundles in a specified location. Makes no attempt to patch node internals, Browserify options may however be provided for this purpose.

Install

npm i -D @userfrosting/browserify-dependencies

Usage

import BrowserifyDeps from "@userfrosting/browserify-dependencies";

const options = {
    dependencies: [
        "foo",
        "bar"
    ],
    inputDir: "./node_modules",
    outputDir: "./browser_modules"
};

BrowserifyDeps(options)
    .then(() => console.log("Done! ✨"))
    .catch(() => console.log("Things have not gone according to plan... 🔥"));

Process modules are wrapped with UMD to allow consumption by most environments, exports in the browser are available via window.[normalised-package-name].

API

API documentation is regenerated for every release using API Extractor and API Documenter. The results reside in docs/api.

Release process

Generally speaking, all releases should first traverse through alpha, beta, and rc (release candidate) to catch missed bugs and gather feedback as appropriate. Aside from this however, there are a few steps that MUST always be done.

1. Make sure CHANGELOG.md is up to date.
2. Update version via npm like npm version 3.0.0 or npm version patch.
3. npm publish.
4. Create release on GitHub from tag made by npm version.

License

MIT

Changelog

[3.0.0] - 2020-03-14

Fixed

• Existing defect where browserified code provided no exports. They are now available on window based on a camel cased version of the package name.

Changed

• ono to @jsdevtools/ono, and bumped version to 7.1
• Results will no longer be within their own folder, and have a file name in the form [dependency-name]_browserified.js.