NAME
    JavaScript::Dependency::Manager - Manage your JavaScript dependencies

VERSION
    version 0.001002

SYNOPSIS
    First, annotate your javascript files with "provides" and/or "requires":

     // provides: Ack
     // requires: underscore
     var Ack = _.throttle(function(foo) {
       alert('ACK! ' + foo)
     }, 100)

     // etc, etc

    Now you can use "JavaScript::Dependency::Manager" to automatically
    create a list of files needed for a given "provision".

     use JavaScript::Dependency::Manager;

     my $mgr = JavaScript::Dependency::Manager->new(
       lib_dir => ['root/js/lib'],
       provisions => {
         underscore => ['root/js/lib/underscore/underscore.js'],
       },
     );

     my @files = $mgr->file_list_for_provisions(['Lynx.ui.form.MWHY']);

    Note that I manually set a provision above. That's because "underscore"
    is an external library, so I shouldn't edit it's source to set it's
    provisions.

DESCRIPTION
    This module simply helps you automatically create a list of necessary
    files based on a list of "modules", which are merely your way of
    identifying functions, objects, classes, or whatever else that you would
    like to load. It will correctly order the list of files to load based on
    your defined requirements.

TERMS
  requirement
    A "requirement" is simply a module that a given file needs to run.

  provision
    A "provision" is simply a module that a given file has within it.

METHODS
  file_list_for_provisions
     my @files = $mgr->file_list_for_provisions(['Foo', 'Bar'])

    This method returns a list of files needed to load a list of provisions.

ATTRIBUTES
  lib_dir
    required. An "ArrayRef" of directories to scan to create the list of
    "requirement"s and "provision"s.

  recurse
    False by default. Set to true if you want the tool to recurse into
    subdirectories of the "lib_dir".

  scan_files
    True by default. Set to false if you want the tool not to scan files at
    all, but instead use a provided list of "requirement"s and "provision"s.

DEDICATION
    "JavaScript::Dependency::Manager" module is dedicated to my namesake,
    Arthur Dale Schmidt. He was my grandfather as well as the inventor of a
    chemical called Sand Control 60 (SC60,) which was used in oil fields to
    reduce the need to redrill entire wells due to sand clogging.

AUTHOR
    Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2012 by Arthur Axel "fREW" Schmidt.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.