@@ -47328,19 +47328,22 @@ define("filesystem/Directory", function (require, exports, module) {
4732847328
4732947329 /**
4733047330 * The contents of this directory. This "private" property is used by FileSystem.
47331+ * @private
4733147332 * @type {Array<FileSystemEntry>}
4733247333 */
4733347334 Directory.prototype._contents = null;
4733447335
4733547336 /**
4733647337 * The stats for the contents of this directory, such that this._contentsStats[i]
4733747338 * corresponds to this._contents[i].
47339+ * @private
4733847340 * @type {Array.<FileSystemStats>}
4733947341 */
4734047342 Directory.prototype._contentsStats = null;
4734147343
4734247344 /**
4734347345 * The stats errors for the contents of this directory.
47346+ * @private
4734447347 * @type {Object.<string, string>} Full paths are mapped to FileSystemError strings.
4734547348 */
4734647349 Directory.prototype._contentsStatsErrors = null;
@@ -47933,7 +47936,7 @@ define("filesystem/FileIndex", function (require, exports, module) {
4793347936
4793447937 /**
4793547938 * Master index
47936- *
47939+ * @private
4793747940 * @type {Object.<string, File|Directory>} Maps a fullPath to a File or Directory object
4793847941 */
4793947942 FileIndex.prototype._index = null;
@@ -48229,6 +48232,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4822948232 }
4823048233
4823148234 /**
48235+ * @private
4823248236 * @param {string} protocol ex: "https:"|"http:"|"ftp:"|"file:"
4823348237 * @param {string} filePath fullPath of the file
4823448238 * @return adapter adapter wrapper over file implementation
@@ -48251,6 +48255,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4825148255
4825248256 /**
4825348257 * The FileSystem is not usable until init() signals its callback.
48258+ * @private
4825448259 * @constructor
4825548260 */
4825648261 function FileSystem() {
@@ -48271,11 +48276,13 @@ define("filesystem/FileSystem", function (require, exports, module) {
4827148276 /**
4827248277 * The low-level file system implementation used by this object.
4827348278 * This is set in the init() function and cannot be changed.
48279+ * @private
4827448280 */
4827548281 FileSystem.prototype._impl = null;
4827648282
4827748283 /**
4827848284 * The FileIndex used by this object. This is initialized in the constructor.
48285+ * @private
4827948286 */
4828048287 FileSystem.prototype._index = null;
4828148288
@@ -48285,6 +48292,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4828548292 * until after index fixups, operation-specific callbacks, and internal change
4828648293 * events are complete. (This is important for distinguishing rename from
4828748294 * an unrelated delete-add pair).
48295+ * @private
4828848296 * @type {number}
4828948297 */
4829048298 FileSystem.prototype._activeChangeCount = 0;
@@ -48297,11 +48305,15 @@ define("filesystem/FileSystem", function (require, exports, module) {
4829748305 /**
4829848306 * Queue of arguments with which to invoke _handleExternalChanges(); triggered
4829948307 * once _activeChangeCount drops to zero.
48308+ * @private
4830048309 * @type {!{path:?string, stat:FileSystemStats}}
4830148310 */
4830248311 FileSystem.prototype._externalChanges = null;
4830348312
48304- /** Process all queued watcher results, by calling _handleExternalChange() on each */
48313+ /**
48314+ * Process all queued watcher results, by calling _handleExternalChange() on each
48315+ * @private
48316+ */
4830548317 FileSystem.prototype._triggerExternalChangesNow = function () {
4830648318 this._externalChanges.forEach(function (info) {
4830748319 this._handleExternalChange(info.path, info.stat);
@@ -48313,6 +48325,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4831348325 * Receives a result from the impl's watcher callback, and either processes it
4831448326 * immediately (if _activeChangeCount is 0) or otherwise stores it for later
4831548327 * processing.
48328+ * @private
4831648329 * @param {?string} path The fullPath of the changed entry
4831748330 * @param {FileSystemStats=} stat An optional stat object for the changed entry
4831848331 */
@@ -48326,12 +48339,14 @@ define("filesystem/FileSystem", function (require, exports, module) {
4832648339
4832748340 /**
4832848341 * The queue of pending watch/unwatch requests.
48342+ * @private
4832948343 * @type {{fn: function(), cb: function()}} Array
4833048344 */
4833148345 FileSystem.prototype._watchRequests = null;
4833248346
4833348347 /**
4833448348 * Dequeue and process all pending watch/unwatch requests
48349+ * @private
4833548350 */
4833648351 FileSystem.prototype._dequeueWatchRequest = function () {
4833748352 if (this._watchRequests.length > 0) {
@@ -48353,7 +48368,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4835348368
4835448369 /**
4835548370 * Enqueue a new watch/unwatch request.
48356- *
48371+ * @private
4835748372 * @param {function()} fn - The watch/unwatch request function.
4835848373 * @param {callback()} cb - The callback for the provided watch/unwatch
4835948374 * request function.
@@ -48372,15 +48387,15 @@ define("filesystem/FileSystem", function (require, exports, module) {
4837248387 * The set of watched roots, encoded as a mapping from full paths to WatchedRoot
4837348388 * objects which contain a file entry, filter function, and an indication of
4837448389 * whether the watched root is inactive, starting up or fully active.
48375- *
48390+ * @private
4837648391 * @type {Object.<string, WatchedRoot>}
4837748392 */
4837848393 FileSystem.prototype._watchedRoots = null;
4837948394
4838048395 /**
4838148396 * Finds a parent watched root for a given path, or returns null if a parent
4838248397 * watched root does not exist.
48383- *
48398+ * @private
4838448399 * @param {string} fullPath The child path for which a parent watched root is to be found.
4838548400 * @return {?{entry: FileSystemEntry, filter: function(string): boolean}} The parent
4838648401 * watched root, if it exists, or null.
@@ -48515,6 +48530,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4851548530 *
4851648531 * All operations that mutate the file system MUST begin with a call to
4851748532 * _beginChange and must end with a call to _endChange.
48533+ * @private
4851848534 */
4851948535 FileSystem.prototype._beginChange = function () {
4852048536 this._activeChangeCount++;
@@ -48524,6 +48540,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4852448540 /**
4852548541 * Indicates that a filesystem-mutating operation has completed. See
4852648542 * FileSystem._beginChange above.
48543+ * @private
4852748544 */
4852848545 FileSystem.prototype._endChange = function () {
4852948546 this._activeChangeCount--;
@@ -48557,6 +48574,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4855748574 /**
4855848575 * Returns a canonical version of the path: no duplicated "/"es, no ".."s,
4855948576 * and directories guaranteed to end in a trailing "/"
48577+ * @private
4856048578 * @param {!string} path Absolute path, using "/" as path separator
4856148579 * @param {boolean=} isDirectory
4856248580 * @return {!string}
@@ -48903,7 +48921,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4890348921
4890448922 /**
4890548923 * Fire a rename event. Clients listen for these events using FileSystem.on.
48906- *
48924+ * @private
4890748925 * @param {string} oldPath The entry's previous fullPath
4890848926 * @param {string} newPath The entry's current fullPath
4890948927 */
@@ -48913,7 +48931,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4891348931
4891448932 /**
4891548933 * Fire a change event. Clients listen for these events using FileSystem.on.
48916- *
48934+ * @private
4891748935 * @param {File|Directory} entry The entry that has changed
4891848936 * @param {Array<File|Directory>=} added If the entry is a directory, this
4891948937 * is a set of new entries in the directory.
@@ -48943,7 +48961,7 @@ define("filesystem/FileSystem", function (require, exports, module) {
4894348961 * removed entries. Mutating FileSystemEntry operations should call this method before
4894448962 * applying the operation's callback, and pass along the resulting change sets in the
4894548963 * internal change event.
48946- *
48964+ * @private
4894748965 * @param {Directory} directory The directory that has changed.
4894848966 * @param {function(Array<File|Directory>=, Array<File|Directory>=)} callback
4894948967 * The callback that will be applied to a set of added and a set of removed
@@ -49449,60 +49467,70 @@ define("filesystem/FileSystemEntry", function (require, exports, module) {
4944949467
4945049468 /**
4945149469 * Cached stat object for this file.
49470+ * @private
4945249471 * @type {?FileSystemStats}
4945349472 */
4945449473 FileSystemEntry.prototype._stat = null;
4945549474
4945649475 /**
4945749476 * Parent file system.
49477+ * @private
4945849478 * @type {!FileSystem}
4945949479 */
4946049480 FileSystemEntry.prototype._fileSystem = null;
4946149481
4946249482 /**
4946349483 * The path of this entry.
49484+ * @private
4946449485 * @type {string}
4946549486 */
4946649487 FileSystemEntry.prototype._path = null;
4946749488
4946849489 /**
4946949490 * The name of this entry.
49491+ * @private
4947049492 * @type {string}
4947149493 */
4947249494 FileSystemEntry.prototype._name = null;
4947349495
4947449496 /**
4947549497 * The parent of this entry.
49498+ * @private
4947649499 * @type {string}
4947749500 */
4947849501 FileSystemEntry.prototype._parentPath = null;
4947949502
4948049503 /**
4948149504 * Whether or not the entry is a file
49505+ * @private
4948249506 * @type {boolean}
4948349507 */
4948449508 FileSystemEntry.prototype._isFile = false;
4948549509
4948649510 /**
4948749511 * Whether or not the entry is a directory
49512+ * @private
4948849513 * @type {boolean}
4948949514 */
4949049515 FileSystemEntry.prototype._isDirectory = false;
4949149516
4949249517 /**
4949349518 * Cached copy of this entry's watched root.
49519+ * @private
4949449520 * @type {{entry: (File|Directory), filter: function(FileSystemEntry): boolean, active: boolean}}
4949549521 */
4949649522 FileSystemEntry.prototype._watchedRoot = undefined;
4949749523
4949849524 /**
4949949525 * Cached result of _watchedRoot.filter(this.name, this.parentPath).
49526+ * @private
4950049527 * @type {boolean}
4950149528 */
4950249529 FileSystemEntry.prototype._watchedRootFilterResult = undefined;
4950349530
4950449531 /**
4950549532 * Determines whether or not the entry is watched.
49533+ * @private
4950649534 * @param {boolean=} relaxed If falsey, the method will only return true if
4950749535 * the watched root is fully active. If true, the method will return
4950849536 * true if the watched root is either starting up or fully active.
0 commit comments