Universe Modules NPM

Extension for package universe:modules that adds possibility of bundling npm packages into universe modules.

And you can use it, just like that:

import cn from '{username:mypackage}/packages/classnames';

How It works

Into Package

1. Create file .npm.json, like packages.import-npm.json and add it to package.js by api.addFiles
2. In package.js add dependency universe:modules-npm
3. Add some packages under key dependencies (as a name:version pairs) to this file:

{
  "packages": {
      "classnames": "2.1.3",
      // You can even attach comments here
      "typographic-numbers": "0.2.1"
  }
}

4. You can import already added packages.

import classNames from '{username:mypackage}/packages/classnames';
import typographicNumbers from '{username:mypackage}/packages/typographic-numbers';

// All packages from file
import {typographicNumbers, classnames} from '{username:mypackage}/packages';
// names of packages are converted to camelcase variable name 

In app

You can use It outside of package too. To do that please create and add in application space file myfile.npm.json. And now, you can import something like this: import classNames from 'myfile/classnames'

Options

Replacing requirements of npm modules to system js modules

{
  "packages":{
    "classnames": "2.1.3",
    "react-tabs-component": "1.1.3"
  },
  "system": {
    // In bundle "react/addons" will be replaced by systemjs dependency.
    "dependencies": ["react/addons"]
  }
}

In example we can see how to change source of module for require('react/addons') from NPM dependencies on to System Js System.import('react/addons').

Tip: Package universe:utilities-react from version 0.5.0 provides react from meteor package under system module "react/addons" and "react". It means that if you want use some npm package (that need "react/addons" or just "react") Instead of manually register of modules for systemjs, you can use universe:utilities-react to provide system js modules.

browserify

This package uses browserify for bundling. You can pass options in the same file under key browserify to make changes on this process

{
  "packages": {
     "jedify": "1.0.0"
  },
  "browserify": {
      "transforms": {
        "jedify": { lang: 'nb_NO' }
      }
  }
}

Restrictions

Because in bundling process, this package uses a browserify. Only browserifyable npm packages will work correctly. If you want use none browserifyable packages please use meteor npm and next, export them as regular module.

Copyright and license

Code and documentation © 2015 Vazco.eu Released under the MIT license.

This package is part of Universe, a package ecosystem based on Meteor platform maintained by Vazco. It works as standalone Meteor package, but you can get much more features when using the whole system.