The JavaScript Universal Module & Resource Converter

define(['Modular', 'Development', 'Deployment'], function(){ return 'that just works, painlessly!' });

require('more').than(this);

var dep1 = require('./rel/path/dep1'),
    dep2 = require('abs/path/dep2');
// do stuff with dep1, dep2
module.exports = {my: 'module'}

// or
define(['./rel/path/dep1','abs/path/dep2'],
  function(dep1, dep2) {
    // do stuff with dep1, dep2
    return {my:'module'}
  });

// or both, in a relaxed, non-weird way
define(['some/dirName','dep2'],
  function(dirNameIndex, dep2) {
    var dep3JSON = require('json!dep3AsJSON');
    // do stuff with dirNameIndex, dep2, dep3JSON
    return {my:'module'}
});

// mix well known features from both
define(['my/dep1'], function(dep1) {
    exports.prop = dep1 + require('./your/dep3');
});

dependencies: exports: bundle: { 'lodash': '_', 'backbone': 'Backbone'}

A Modules & Dependencies aware builder.

Exporting modules to window/global variables (like window._, window.$ etc), demystified and with no boilerplate.

Want noConflict(), baked in? Its a simple declaration away.

// file `uberscore.js` - export it to root (`window`) as `_B`
({ urequire: { rootExports: '_B', noConflict: true }});
module.exports = {...}

The same in a config is

dependencies: { exports: { root: { 'uberscore': '_B' }}}

How about exporting to your bundle only?

// export/inject `_` in (all) bundle's modules
dependencies: { exports: { bundle: { 'lodash': '_' }}}

Want to replace deps with mocks or alternative versions ?

Inject, replace or even delete dependencies with a simple declaration or a callback:

// underscore is dead, long live _
dependencies: { replace: { lodash: 'underscore'}}

// with code
function(modyle){ modyle.replaceDeps('models/PersonModel', 'mock/models/PersonModelMock'); }

[ '$coco', [ '**/*.co'], ((r)-> require('coco').compile r.converted), '.js']

A versatile in-memory Resource Conversion

Manipulate Module code while building:

• inject, replace or delete code fragments or AST nodes or dependencies with one liners.

  // delete matching code of code skeleton
  function(m){ m.replaceCode('if (debug){}') }
  
  // traverse matching nodes, replace or delete em
  function(m){ m.replaceCode('console.log()', function(nodeAST){return nodeOrStringOrUndefined}) }

Perform any code manipulation - eg remove debug code, inject initializations etc

• Inject code before (or after) each module's body eg. to initialize custom module code, for common module tasks:

  function(m) { m.beforeBody = "var l = new _B.Logger('" + m.dstFilename + "');"; }

• Inject common or merged repeating statements: keep DRY, save space & speed when combined in a single .js

  // each module will have before its main body, in all templates
  bundle: commonCode: 'var expect = chai.expect;'
  
  // added before beforeBody for all templates except 'combined', where its merged
  function(m) { m.mergedCode = '"var p1 = myModule.p1, p2 = myModule.p2, ..., pN = myModule.pN;"' }

  Who needs bloated plugins ? Here's a ResourceConverter for our coco files (included along with coffeescript, LiveScript, iced-coffee-script.

  [ '$coco', [ '**/*.co'], ((r)-> require('coco').compile r.converted), '.js']

['+inject:VERSION', ['uberscore.js'], (m)-> m.beforeBody = "var VERSION = '0.0.15';"]

// Config as a `Gruntfile.coffee` task
// Can be a .coffee, .js, .json, .yml & more
uberscore:
  path: 'source'
  dstPath: 'build'
  filez: ['**/*', (f)-> f isnt 'badfile']
  copy: [/./]
  runtimeInfo: ['!**/*', 'Logger']
  dependencies: exports:
    bundle: 'lodash':  '_'
    root: 'uberscore': '_B'
  resources: [
    ['+inject:VERSION', ['uberscore.js'],
     (m)-> m.beforeBody = "var VERSION = '0.0.15';" ]
  ]
  template: banner: "// uBerscore v0.0.15"
  optimize: 'uglify2'
  watch: true

{ derive: ['uberscore'], filez: [ /.*\.(coffee\.md|litcoffee|coffee)$/ ] }

distribute:
  derive: ['uberscore']
  filez: ['!', /useRegExpsAsFileSpecs/]
  template: 'combined'
  dstPath: 'build/uberscore-combined.js'
  optimize: uglify2: {more: uglify2: options}

`_.extend(window.libraryExported, exports)`

build:
  globalWindow: false

  runtimeInfo: ['Logger']

  useStrict: true

  injectExportsModule: ['uberscore', 'circular/Dependency']

  bare: true

  allNodeRequires: ['/data/preCached']

  noRootExports: true

  scanAllow: false