History

Thomas Wilburn 56f87c996e Add a debug command (may not work without packaged debugging enabled.		2014-03-24 19:22:52 -07:00
..
ace	Updated Ace, added LESS to file permissions.	2014-03-19 20:08:47 -07:00
lib	Add es6-promise shim, so we can convert over to browser promises as soon as they're available.	2013-12-22 10:56:13 -08:00
sessions	New tab button (cleanup) and doubleclick tab bar.	2014-03-24 17:18:25 +02:00
storage	Fix some bugs with the palette, syntax cleanup, add comments.	2014-02-26 18:56:05 -08:00
ui	Add a debug command (may not work without packaged debugging enabled.	2014-03-24 19:22:52 -07:00
util	Better tick scheduling, added {{.}} to inflate.	2014-03-07 23:30:47 -08:00
aceBindings.js	Only trim whitespace between non-whitespace and newline (Issue #158 )	2014-03-13 11:42:39 -04:00
api.js	Add async callbacks to a bunch of commands	2013-12-23 16:15:03 -08:00
command.js	Code cleanup and commenting.	2014-02-26 22:34:02 -08:00
editor.js	Code cleanup and commenting.	2014-02-26 22:34:02 -08:00
fileManager.js	Update modification time as part of session:revert-file.	2014-03-06 06:56:01 -08:00
main.js	Add a debug command (may not work without packaged debugging enabled.	2014-03-24 19:22:52 -07:00
readme.md	readme changes	2014-01-20 23:36:30 -08:00
sessions.js	New tab button (cleanup) and doubleclick tab bar.	2014-03-24 17:18:25 +02:00
settings.js	Code cleanup and commenting.	2014-02-26 22:34:02 -08:00
tab.js	Fixes #169	2014-03-22 06:05:47 -07:00

readme.md

Module descriptions - core

This document serves as basic documentation for Caret's AMD modules. It's not exhaustive, but it will serve as a starting place for anyone wanting to dive in a little deeper.

Caret's execution starts in main.js, which mostly serves as bootstrap for the other modules. It also registers command listeners for the UI themes, various window events, and app-level commands like app:check-for-updates. After that, we really get down to business.

In addition to the module folders, which contain their own readme files, there are also folders for the current Ace build (ace) and any external libraries used by Caret, such as the ES6 Promises shim (lib).

aceBindings.js

Takes care of any messiness between Caret and Ace APIs. Registers the ace:command listener, as well as a bunch of Sublime emulation commands. Exposes no external methods or data.

api.js

Registers for chrome.runtime.onMessageExternal events, patching them into the command module, and dispatches messages from api:execute commands. Exposes no external methods or data.

command.js

Serves as a messaging buffer between modules, and from declarative DOM attributes to modules. Exposes three properties: fire() for sending commands, on() for subscribing to them, and an array called list that can be used to add palette-only items at runtime.

editor.js

Sets up the Ace editor and registers for events in the editor:* namespace. Returns the Ace object.

fileManager.js

Handles opening files from launch data, retained handles, and user commands. Exposes no external methods or data.

sessions.js

Manages Caret's tabs, including all UI interaction with the tab bar and the process of adding or removing tabs. Exposes a number of methods and manipulating the tab structure.

settings.js

Runs as a RequireJS plugin, so that dependent modules can rely on having settings available on startup, but actually just returns the same singleton as storage/settingsProvider.

tab.js

Exposes a Tab constructor to dependents, which is an augmented Ace EditorSession. Tabs do additional setup work to support Caret, as well as adding methods for saving files and dropping retained file handles.