A set of helpers for using script.js as async dependency loader with dust.js

What does it do?

Basically it helps you build your script.js code, and if any depended bundle is not requested, it will not be built. It builds a very simple graph internally and is used to build the code

$3

The following code is very much similar to the above code, except, the final set of script only depends on bundle("two") and as you can see the final result is much shorter(since bundle three is not loaded, bundle one is not needed)

``html






{@bundleScript bundle="one" src="one.js"/}
{@bundleScript bundle="two" src="two.js"/}
{@bundleScript bundle="three" src="three.js"/}
{@bundleDepends bundle="three"}
{@dependsOn bundle="one"/}
{@dependsOn bundle="two"/}
{/bundleDepends}
{@scriptjs}
{@dependsOn bundle="two"/}
{/scriptjs}

{@renderScript /}


`

#### output
`html







`

$3

Here, two scripts depends on "one" and "three", and "three" depends on "one" and "two", although "one" is included by two different sets, but $script() is only called for bundle "one" once.

`html






{@bundleScript bundle="one" src="one.js"/}
{@bundleScript bundle="two" src="two.js"/}
{@bundleScript bundle="three" src="three.js"/}
{@bundleDepends bundle="three"}
{@dependsOn bundle="one"/}
{@dependsOn bundle="two"/}
{/bundleDepends}
{@scriptjs}
{@dependsOn bundle="three"/}
{/scriptjs}
{@scriptjs dependsOn="one"/}
{/scriptjs}

{@renderScript /}


`

#### output
`html







`

Usage

$3


`sh
npm install --save dust-scriptjs-helper
`

$3

`javascript
import {* as dust} from "dust-scriptjs-helper" // this is the decorated dust object with dustjs-helpers
`

$3

#### dustjs code
`html






{@bundleScript bundle="one" src="one.js"/}
{@bundleScript bundle="two" src="two.js"/}
{@bundleScript bundle="three" src="three.js"/}
{@bundleDepends bundle="three"}
{@dependsOn bundle="one"/}
{@dependsOn bundle="two"/}
{/bundleDepends}
{@scriptjs}
{@dependsOn bundle="two"/}
{@dependsOn bundle="three"/}
{/scriptjs}

{@renderScript /}


`

#### output(or something similar, it is not prettified right now)
`html







`

$3

Helper name | Use
------------ | ----------
bundleScript | defining script in a bundle
bundleDepends | defining bundle dependencies
dependsOn | To be used with \@scriptjs and \@bundleDepends for defining script or bundle dependency
scriptjs | for a block of code encapculated within a $script.ready
loadBundle | if you want to explicitly load a bundle, for example some global.js kinda things that you wanna load even if it is not depended
renderScript | place this at where you want to render the scripts, unfortunately this has to be placed after all the above definitions, so, best right before

#### \@bundleScript
`
{@bundleScript src="src.js" bundle="bundlename"/}

{@bundleScript bundle="bundlename"}
["src1.js","src2.js"]
{/bundleScript}
`

#### \@dependsOn
`
{@dependsOn bundle="bundlename"/}
`

#### \@bundleDepends
`
{@bundleDepends bundle="bundlename" on="bundlename2"/}

{@bundleDepends bundle="bundlename"}
{@dependsOn bundle="bundlename2"/}
{@dependsOn bundle="bundlename3"/}
{/bundleDepends}
`

#### \@scriptjs
`
{@scriptjs dependsOn="bundlename2"}
console.log('abc');
somecodeyouwannado();
//basically all your javascript code that depends on bundlename2
{/scriptjs}

{@scriptjs}
{@dependsOn bundle="bundlename2"/}
{@dependsOn bundle="bundlename3"/}
console.log('abc');
somecodeyouwannado();
//basically all your javascript code that depends on bundlename2 and bundlename3
{/scriptjs}
`

#### \@loadBundle
`
{@loadBundle bundle="bundle"/}
`
#### \@renderScript
`
{@renderScript/}
``