@@ -13091,6 +13091,7 @@ define("document/Document", function (require, exports, module) {
1309113091 /**
1309213092 * Number of clients who want this Document to stay alive. The Document is listed in
1309313093 * DocumentManager._openDocuments whenever refCount > 0.
13094+ * @private
1309413095 */
1309513096 Document.prototype._refCount = 0;
1309613097
@@ -13146,12 +13147,14 @@ define("document/Document", function (require, exports, module) {
1314613147
1314713148 /**
1314813149 * True while refreshText() is in progress and change notifications shouldn't trip the dirty flag.
13150+ * @private
1314913151 * @type {boolean}
1315013152 */
1315113153 Document.prototype._refreshInProgress = false;
1315213154
1315313155 /**
1315413156 * The text contents of the file, or null if our backing model is _masterEditor.
13157+ * @private
1315513158 * @type {?string}
1315613159 */
1315713160 Document.prototype._text = null;
@@ -13160,13 +13163,15 @@ define("document/Document", function (require, exports, module) {
1316013163 * Editor object representing the full-size editor UI for this document. May be null if Document
1316113164 * has not yet been modified or been the currentDocument; in that case, our backing model is the
1316213165 * string _text.
13166+ * @private
1316313167 * @type {?Editor}
1316413168 */
1316513169 Document.prototype._masterEditor = null;
1316613170
1316713171 /**
1316813172 * The content's line-endings style. If a Document is created on empty text, or text with
1316913173 * inconsistent line endings, defaults to the current platform's standard endings.
13174+ * @private
1317013175 * @type {FileUtils.LINE_ENDINGS_CRLF|FileUtils.LINE_ENDINGS_LF}
1317113176 */
1317213177 Document.prototype._lineEndings = null;
@@ -13204,6 +13209,7 @@ define("document/Document", function (require, exports, module) {
1320413209 * Attach a backing Editor to the Document, enabling setText() to be called. Assumes Editor has
1320513210 * already been initialized with the value of getText(). ONLY Editor should call this (and only
1320613211 * when EditorManager has told it to act as the master editor).
13212+ * @private
1320713213 * @param {!Editor} masterEditor
1320813214 */
1320913215 Document.prototype._makeEditable = function (masterEditor) {
@@ -13218,6 +13224,7 @@ define("document/Document", function (require, exports, module) {
1321813224 * Detach the backing Editor from the Document, disallowing setText(). The text content is
1321913225 * stored back onto _text so other Document clients continue to have read-only access. ONLY
1322013226 * Editor.destroy() should call this.
13227+ * @private
1322113228 */
1322213229 Document.prototype._makeNonEditable = function () {
1322313230 if (!this._masterEditor) {
@@ -13239,6 +13246,7 @@ define("document/Document", function (require, exports, module) {
1323913246 /**
1324013247 * Toggles the master editor which has gained focus from a pool of full editors
1324113248 * To be used internally by Editor only
13249+ * @private
1324213250 */
1324313251 Document.prototype._toggleMasterEditor = function (masterEditor) {
1324413252 // Do a check before processing the request to ensure inline editors are not being set as master editor
@@ -13250,6 +13258,7 @@ define("document/Document", function (require, exports, module) {
1325013258
1325113259 /**
1325213260 * Checks and returns if a full editor exists for the provided pane attached to this document
13261+ * @private
1325313262 * @param {String} paneId
1325413263 * @return {Editor} Attached editor bound to the provided pane id
1325513264 */
@@ -13268,6 +13277,7 @@ define("document/Document", function (require, exports, module) {
1326813277 /**
1326913278 * Disassociates an editor from this document if present in the associated editor list
1327013279 * To be used internally by Editor only when destroyed and not the current master editor for the document
13280+ * @private
1327113281 */
1327213282 Document.prototype._disassociateEditor = function (editor) {
1327313283 // Do a check before processing the request to ensure inline editors are not being handled
@@ -13279,6 +13289,7 @@ define("document/Document", function (require, exports, module) {
1327913289 /**
1328013290 * Aassociates a full editor to this document
1328113291 * To be used internally by Editor only when pane marking happens
13292+ * @private
1328213293 */
1328313294 Document.prototype._associateEditor = function (editor) {
1328413295 // Do a check before processing the request to ensure inline editors are not being handled
@@ -13291,6 +13302,7 @@ define("document/Document", function (require, exports, module) {
1329113302 * Guarantees that _masterEditor is non-null. If needed, asks EditorManager to create a new master
1329213303 * editor bound to this Document (which in turn causes Document._makeEditable() to be called).
1329313304 * Should ONLY be called by Editor and Document.
13305+ * @private
1329413306 */
1329513307 Document.prototype._ensureMasterEditor = function () {
1329613308 if (!this._masterEditor) {
@@ -13606,6 +13618,7 @@ define("document/Document", function (require, exports, module) {
1360613618 /**
1360713619 * Like _.each(), but if given a single item not in an array, acts as
1360813620 * if it were an array containing just that item.
13621+ * @private
1360913622 */
1361013623 function oneOrEach(itemOrArr, cb) {
1361113624 if (Array.isArray(itemOrArr)) {
@@ -13774,6 +13787,7 @@ define("document/Document", function (require, exports, module) {
1377413787
1377513788 /**
1377613789 * Updates the language to match the current mapping given by LanguageManager
13790+ * @private
1377713791 */
1377813792 Document.prototype._updateLanguage = function () {
1377913793 var oldLanguage = this.language;
@@ -13783,7 +13797,10 @@ define("document/Document", function (require, exports, module) {
1378313797 }
1378413798 };
1378513799
13786- /** Called when Document.file has been modified (due to a rename) */
13800+ /**
13801+ * Called when Document.file has been modified (due to a rename)
13802+ * @private
13803+ */
1378713804 Document.prototype._notifyFilePathChanged = function () {
1378813805 // File extension may have changed
1378913806 this._updateLanguage();
@@ -16253,13 +16270,50 @@ define("document/DocumentManager", function (require, exports, module) {
1625316270 ProjectManager = require("project/ProjectManager"),
1625416271 Strings = require("strings");
1625516272
16256- const EVENT_AFTER_DOCUMENT_CREATE = "afterDocumentCreate",
16257- EVENT_PATH_DELETED = "pathDeleted",
16258- EVENT_FILE_NAME_CHANGE = "fileNameChange",
16259- EVENT_BEFORE_DOCUMENT_DELETE = "beforeDocumentDelete",
16260- EVENT_DOCUMENT_REFRESHED = "documentRefreshed",
16261- EVENT_DOCUMENT_CHANGE = "documentChange",
16262- EVENT_DIRTY_FLAG_CHANGED = "dirtyFlagChange";
16273+ /**
16274+ * Event triggered after a document is created.
16275+ * @constant {string}
16276+ */
16277+ const EVENT_AFTER_DOCUMENT_CREATE = "afterDocumentCreate";
16278+
16279+ /**
16280+ * Event triggered when a file or folder path is deleted.
16281+ * @constant {string}
16282+ */
16283+ const EVENT_PATH_DELETED = "pathDeleted";
16284+
16285+ /**
16286+ * Event triggered when a file's name changes.
16287+ * @constant {string}
16288+ */
16289+ const EVENT_FILE_NAME_CHANGE = "fileNameChange";
16290+
16291+ /**
16292+ * Event triggered before a document is deleted.
16293+ * @constant {string}
16294+ */
16295+ const EVENT_BEFORE_DOCUMENT_DELETE = "beforeDocumentDelete";
16296+
16297+ /**
16298+ * Event triggered when a document is refreshed.
16299+ * @constant {string}
16300+ */
16301+ const EVENT_DOCUMENT_REFRESHED = "documentRefreshed";
16302+
16303+ /**
16304+ * Event triggered when a document's content changes.
16305+ * @constant {string}
16306+ */
16307+ const EVENT_DOCUMENT_CHANGE = "documentChange";
16308+
16309+ /**
16310+ * Event triggered when the document's dirty flag changes,
16311+ * indicating if the document has unsaved changes.
16312+ * @constant {string}
16313+ */
16314+ const EVENT_DIRTY_FLAG_CHANGED = "dirtyFlagChange";
16315+
16316+
1626316317
1626416318
1626516319 /**
@@ -16300,6 +16354,8 @@ define("document/DocumentManager", function (require, exports, module) {
1630016354
1630116355 /**
1630216356 * Returns the Document that is currently open in the editor UI. May be null.
16357+ * @private
16358+ * @deprecated
1630316359 * @return {?Document}
1630416360 */
1630516361 function getCurrentDocument() {
@@ -16315,6 +16371,7 @@ define("document/DocumentManager", function (require, exports, module) {
1631516371
1631616372 /**
1631716373 * Returns a list of items in the working set in UI list order. May be 0-length, but never null.
16374+ * @private
1631816375 * @deprecated Use MainViewManager.getWorkingSet() instead
1631916376 * @return {Array.<File>}
1632016377 */
@@ -16329,6 +16386,7 @@ define("document/DocumentManager", function (require, exports, module) {
1632916386
1633016387 /**
1633116388 * Returns the index of the file matching fullPath in the working set.
16389+ * @private
1633216390 * @deprecated Use MainViewManager.findInWorkingSet() instead
1633316391 * @param {!string} fullPath
1633416392 * @return {number} index, -1 if not found
@@ -16358,6 +16416,7 @@ define("document/DocumentManager", function (require, exports, module) {
1635816416
1635916417 /**
1636016418 * Adds the given file to the end of the working set list.
16419+ * @private
1636116420 * @deprecated Use MainViewManager.addToWorkingSet() instead
1636216421 * @param {!File} file
1636316422 * @param {number=} index Position to add to list (defaults to last); -1 is ignored
@@ -16370,6 +16429,7 @@ define("document/DocumentManager", function (require, exports, module) {
1637016429 }
1637116430
1637216431 /**
16432+ * @private
1637316433 * @deprecated Use MainViewManager.addListToWorkingSet() instead
1637416434 * Adds the given file list to the end of the working set list.
1637516435 * If a file in the list has its own custom viewer, then it
@@ -16387,6 +16447,7 @@ define("document/DocumentManager", function (require, exports, module) {
1638716447
1638816448 /**
1638916449 * closes a list of files
16450+ * @private
1639016451 * @deprecated Use CommandManager.execute(Commands.FILE_CLOSE_LIST) instead
1639116452 * @param {!Array.<File>} list - list of File objectgs to close
1639216453 */
@@ -16397,6 +16458,7 @@ define("document/DocumentManager", function (require, exports, module) {
1639716458
1639816459 /**
1639916460 * closes all open files
16461+ * @private
1640016462 * @deprecated CommandManager.execute(Commands.FILE_CLOSE_ALL) instead
1640116463 */
1640216464 function closeAll() {
@@ -16406,6 +16468,7 @@ define("document/DocumentManager", function (require, exports, module) {
1640616468
1640716469 /**
1640816470 * closes the specified file file
16471+ * @private
1640916472 * @deprecated use CommandManager.execute(Commands.FILE_CLOSE, {File: file}) instead
1641016473 * @param {!File} file - the file to close
1641116474 */
@@ -16416,6 +16479,7 @@ define("document/DocumentManager", function (require, exports, module) {
1641616479
1641716480 /**
1641816481 * opens the specified document for editing in the currently active pane
16482+ * @private
1641916483 * @deprecated use CommandManager.execute(Commands.CMD_OPEN, {fullPath: doc.file.fullPath}) instead
1642016484 * @param {!Document} document The Document to make current.
1642116485 */
@@ -16427,6 +16491,7 @@ define("document/DocumentManager", function (require, exports, module) {
1642716491
1642816492 /**
1642916493 * freezes the Working Set MRU list
16494+ * @private
1643016495 * @deprecated use MainViewManager.beginTraversal() instead
1643116496 */
1643216497 function beginDocumentNavigation() {
@@ -16436,6 +16501,7 @@ define("document/DocumentManager", function (require, exports, module) {
1643616501
1643716502 /**
1643816503 * ends document navigation and moves the current file to the front of the MRU list in the Working Set
16504+ * @private
1643916505 * @deprecated use MainViewManager.endTraversal() instead
1644016506 */
1644116507 function finalizeDocumentNavigation() {
@@ -16446,6 +16512,7 @@ define("document/DocumentManager", function (require, exports, module) {
1644616512 /**
1644716513 * Get the next or previous file in the working set, in MRU order (relative to currentDocument). May
1644816514 * return currentDocument itself if working set is length 1.
16515+ * @private
1644916516 * @deprecated use MainViewManager.traverseToNextViewByMRU() instead
1645016517 */
1645116518 function getNextPrevFile(inc) {
@@ -16462,6 +16529,7 @@ define("document/DocumentManager", function (require, exports, module) {
1646216529 * rooted in the UI anywhere. This can happen if the Editor is auto-created via Document APIs that
1646316530 * trigger _ensureMasterEditor() without making it dirty. E.g. a command invoked on the focused
1646416531 * inline editor makes no-op edits or does a read-only operation.
16532+ * @private
1646516533 */
1646616534 function _gcDocuments() {
1646716535 getAllOpenDocuments().forEach(function (doc) {
@@ -16636,6 +16704,7 @@ define("document/DocumentManager", function (require, exports, module) {
1663616704 * without warning in a future release.
1663716705 *
1663816706 * @param {!File} file
16707+ * @private
1663916708 */
1664016709 function notifyFileDeleted(file) {
1664116710 // Notify all editors to close as well
@@ -16658,6 +16727,7 @@ define("document/DocumentManager", function (require, exports, module) {
1665816727 * for updating underlying model data and notifying all views of the change.
1665916728 *
1666016729 * @param {string} fullPath The path of the file/folder that has been deleted
16730+ * @private
1666116731 */
1666216732 function notifyPathDeleted(fullPath) {
1666316733 // FileSyncManager.syncOpenDocuments() does all the work prompting
@@ -16684,6 +16754,7 @@ define("document/DocumentManager", function (require, exports, module) {
1668416754 *
1668516755 * @param {string} oldName The old name of the file/folder
1668616756 * @param {string} newName The new name of the file/folder
16757+ * @private
1668716758 */
1668816759 function notifyPathNameChanged(oldName, newName) {
1668916760 // Notify all open documents
@@ -17118,6 +17189,7 @@ define("document/TextRange", function (require, exports, module) {
1711817189 /**
1711917190 * Applies a single Document change object (out of the linked list of multiple such objects)
1712017191 * to this range.
17192+ * @private
1712117193 * @param {Object} change The CodeMirror change record.
1712217194 * @return {{hasChanged: boolean, hasContentChanged: boolean}} Whether the range boundary
1712317195 * and/or content has changed.
@@ -17187,6 +17259,7 @@ define("document/TextRange", function (require, exports, module) {
1718717259 * Updates the range based on the changeList from a Document "change" event. Dispatches a
1718817260 * "change" event if the range was adjusted at all. Dispatches a "lostSync" event instead if the
1718917261 * range can no longer be accurately maintained.
17262+ * @private
1719017263 */
1719117264 TextRange.prototype._applyChangesToRange = function (changeList) {
1719217265 var hasChanged = false, hasContentChanged = false;
0 commit comments