Caret/js/util

Module descriptions - util

aceLoad.js

Shims Ace's loadScript() async loader so that AMD modules can simply declare Ace dependencies the same way they declare AMD dependencies.

dom2.js

Instead of using an MVC framework like Backbone or a view binding library like Angular, Caret modifies the DOM prototypes to have a more jQuery-like UI with this module. Since Chrome apps cannot share a page with external scripts, and since we know that the Chrome DOM prototypes are stable, this is a safe and easy way to get sensible DOM manipulation. Exposes no methods or data, but does modify the Document, DocumentFragment, Element, and Window prototypes.

inflate.js

Chrome OS disallows using eval() or new Function(), which means many template libraries simply won't work without pre-compiling the templates. Instead of going that route, recognizing that template speed is almost never a bottleneck for Caret, inflate.js provides Mustache-compatible templating that can load from the filesystem or the DOM (loaded automatically by ID). Exposes the following methods:

• load- Pulls a template from the given filesystem path. Returns a promise that resolves when the template is ready.
• loadHTML - Directly insert HTML into the template cache for use.
• get - Fills a template with data and returns a DOM element.
• getHTML - Fills a template with data and returns the string representation
• getAsync - Used to simultaneously load and fill a template. Returns a promise that resolves with the filled template as a DOM element.

manos.js

A lightweight library for handling async code, this serves as the "hands of fate" for your callbacks. Provides serial() and map() for async array manipulation, and pton() and deferred for working with native ES6 Promises.

template.js

A plugin that loads a template from disk, then returns the inflate templating object. Useful for modules that need a template as part of their dependencies.

text.js

A RequireJS plugin that loads files from Caret's app directory using XHR. Used to get the default settings JSON through a standard interface.